bring back twilio integration

apps/rowboat/app/api/twilio/inbound_call/route.ts

@@ -0,0 +1,120 @@
+import { getResponse } from "@/app/lib/agents";
+import { agentWorkflowsCollection, twilioConfigsCollection, twilioInboundCallsCollection } from "@/app/lib/mongodb";
+import { collectProjectTools } from "@/app/lib/project_tools";
+import { PrefixLogger } from "@/app/lib/utils";
+import VoiceResponse from "twilio/lib/twiml/VoiceResponse";
+import { ObjectId } from "mongodb";
+import { z } from "zod";
+import { TwilioInboundCall } from "@/app/lib/types/voice_types";
+import { hangup, reject, XmlResponse, ZStandardRequestParams } from "../utils";
+
+export async function POST(request: Request) {
+    let logger = new PrefixLogger("twilioInboundCall");
+    logger.log("Received inbound call request");
+    const recvdAt = new Date();
+
+    /*
+    form data example
+    ...
+    {
+        Called: '+1571XXXXXXX',
+        ToState: 'VA',
+        CallerCountry: 'IN',
+        Direction: 'inbound',
+        CallerState: 'PXXXXXXX',
+        ToZip: '',
+        CallSid: 'CA...b0',
+        To: '+1571XXXXXXX',
+        CallerZip: '',
+        ToCountry: 'US',
+        StirVerstat: 'TN-Validation-Passed-C',
+        CallToken: '%7B...',
+        CalledZip: '',
+        ApiVersion: '2010-04-01',
+        CalledCity: '',
+        CallStatus: 'ringing',
+        From: '+919XXXXXXXXX',
+        AccountSid: 'A....1c',
+        CalledCountry: 'US',
+        CallerCity: '',
+        ToCity: '',
+        FromCountry: 'IN',
+        Caller: '+919XXXXXXXXX'
+        FromCity: '',
+        CalledState: 'VA',
+        FromZip: '',
+        FromState: 'PXXXXXXX'
+    }
+    */
+    // parse and validate form data
+    const formData = await request.formData();
+    logger.log('request body:', JSON.stringify(Object.fromEntries(formData)));
+    const data = ZStandardRequestParams.parse(Object.fromEntries(formData));
+    logger = logger.child(data.To);
+
+    // get a matching twilio config for this phone number.
+    // if not found, reject the call
+    const twilioConfig = await twilioConfigsCollection.findOne({
+        phone_number: data.To,
+        status: 'active',
+    });
+    if (!twilioConfig) {
+        logger.log('No active twilio config found for this phone number');
+        return reject('rejected');
+    }
+
+    // extract workflow and project id and fetch workflow from db
+    // if workflow not found, reject the call
+    const projectId = twilioConfig.project_id;
+    const workflowId = twilioConfig.workflow_id;
+    const workflow = await agentWorkflowsCollection.findOne({
+        projectId: projectId,
+        _id: new ObjectId(workflowId),
+    });
+    if (!workflow) {
+        logger.log(`Workflow ${workflowId} not found for project ${projectId}`);
+        return reject('rejected');
+    }
+
+    // fetch project tools
+    const projectTools = await collectProjectTools(projectId);
+
+    // this is the first turn, get the initial assistant response
+    // and validate it
+    const { messages } = await getResponse(workflow, projectTools, []);
+    if (messages.length === 0) {
+        logger.log('Agent response is empty');
+        return hangup();
+    }
+    const lastMessage = messages[messages.length - 1];
+    if (lastMessage.role !== 'assistant' || !lastMessage.content) {
+        logger.log('Invalid last message');
+        return hangup();
+    }
+
+    // save call state
+    const call: z.infer<typeof TwilioInboundCall> = {
+        callSid: data.CallSid,
+        to: data.To,
+        from: data.From,
+        projectId,
+        workflowId,
+        messages,
+        createdAt: recvdAt.toISOString(),
+        lastUpdatedAt: new Date().toISOString(),
+    };
+    await twilioInboundCallsCollection.insertOne(call);
+
+    // speak out response
+    const response = new VoiceResponse();
+    response.say(lastMessage.content);
+    response.gather({
+        input: ['speech'],
+        speechTimeout: 'auto',
+        language: 'en-US',
+        enhanced: true,
+        speechModel: 'phone_call',
+        action: `/api/twilio/turn/${data.CallSid}`,
+    });
+    return XmlResponse(response);
+}