@guava-ai/guava-sdk 0.27.0 → 0.27.1

package/examples/scheduling-outbound.ts

@@ -1,3 +1,4 @@
+import { Command } from "commander";
 import * as guava from "@guava-ai/guava-sdk";
 import { DatetimeFilter } from "@guava-ai/guava-sdk/helpers";
 import { mockAppointmentsForFuture } from "@guava-ai/guava-sdk/example-data";
@@ -42,22 +43,32 @@ agent.onTaskComplete("schedule_appointment", async (call) => {
   await call.hangup("Thank them for their time and hang up the call.");
 });
 
-export async function run(args: string[]) {
-  if (args.includes("--chat")) {
-    const patientName = args[args.indexOf("--chat") + 1] ?? "Benjamin Buttons";
-    await agent.chat({ patientName });
-    return;
-  }
+export async function run(prog: string, args: string[]) {
+  const program = new Command().name(prog).showHelpAfterError();
 
-  const [toNumber, patientName = "Benjamin Buttons"] = args;
+  program
+    .command("phone <number>")
+    .description("Call a phone number.")
+    .option("-n, --name <name>", "Name of the patient.", "Benjamin Buttons")
+    .action(async (number: string, options: { name: string }) => {
+      await agent.callPhone(await getAgentNumber(), number, { patientName: options.name });
+    });
 
-  if (!toNumber) {
-    console.error("Usage: guava-example scheduling-outbound <phone> [name]");
-    console.error("       guava-example scheduling-outbound --chat [name]");
-    process.exit(1);
-  }
+  program
+    .command("local")
+    .description("Start a local call (for testing).")
+    .option("-n, --name <name>", "Name of the patient.", "Benjamin Buttons")
+    .action(async (options: { name: string }) => {
+      await agent.callLocal({ patientName: options.name });
+    });
+
+  program
+    .command("chat")
+    .description("Start a local chat session (for testing).")
+    .option("-n, --name <name>", "Name of the patient.", "Benjamin Buttons")
+    .action(async (options: { name: string }) => {
+      await agent.chat({ patientName: options.name });
+    });
 
-  agent.callPhone(await getAgentNumber(), toNumber, {
-    patientName: patientName,
-  });
+  await program.parseAsync(args, { from: "user" });
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@guava-ai/guava-sdk",
   "description": "The official TypeScript SDK for building Guava voice agents.",
   "homepage": "https://docs.goguava.ai/typescript-sdk/",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "type": "commonjs",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -46,6 +46,7 @@
     "guava-example": "dist/bin/example-runner.js"
   },
   "dependencies": {
+    "commander": "^15.0.0",
     "openai": "^6.16.0",
     "ws": "^8.19.0",
     "zod": "^4.3.5"

package/src/agent.ts

@@ -276,12 +276,14 @@ export class Agent {
     return this._listenInbound(healthCtx, { sip_code: sipCode });
   }
 
-  async callLocal(): Promise<void> {
+  async callLocal(variables: Record<string, any> = {}): Promise<void> {
     const webrtcCode = await this._client.createWebrtcAgent(300);
     // No health-server for call_local.
-    this._listenInbound(new HealthContext(), { webrtc_code: webrtcCode }).catch((err) => {
-      this._logger.error("Listen loop error: %s", err);
-    });
+    this._listenInbound(new HealthContext(), { webrtc_code: webrtcCode }, variables).catch(
+      (err) => {
+        this._logger.error("Listen loop error: %s", err);
+      },
+    );
     await runWebrtcHelper(webrtcCode, getBaseUrl());
   }
 
@@ -574,7 +576,11 @@ export class Agent {
     }
   }
 
-  async _listenInbound(healthCtx: HealthContext, conn: InboundConnection): Promise<void> {
+  async _listenInbound(
+    healthCtx: HealthContext,
+    conn: InboundConnection,
+    initialVariables: Record<string, any> = {},
+  ): Promise<void> {
     const url = new URL("v2/listen-inbound", this._client.getWebsocketBase());
     if ("agent_number" in conn) {
       url.searchParams.set("phone_number", conn.agent_number);
@@ -632,9 +638,11 @@ export class Agent {
             case "assign-call": {
               const { call_id, call_info } = msg;
               this._logger.info("Received call (session ID: %s)", call_id);
-              this._handleAssignedCall(call_id, call_info, socket).catch((err) => {
-                this._logger.error("Error handling assigned call %s: %s", call_id, err);
-              });
+              this._handleAssignedCall(call_id, call_info, socket, initialVariables).catch(
+                (err) => {
+                  this._logger.error("Error handling assigned call %s: %s", call_id, err);
+                },
+              );
               break;
             }
           }

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "0.27.0";
+export const SDK_VERSION = "0.27.1";