@guava-ai/guava-sdk 0.5.0 → 0.7.0

package/examples/scheduling-outbound.ts

@@ -17,7 +17,7 @@ class SchedulingController extends guava.CallController {
       sourceList: mockAppointmentsForFuture(),
     });
 
-    // Use setPersona to set basic information about the agent, as well as it's high-level purpose.
+    // Use setPersona to set basic information about the agent, as well as its high-level purpose.
     this.setPersona({
       organizationName: "Bright Smile Dental",
       agentName: "Grace",
@@ -32,32 +32,32 @@ class SchedulingController extends guava.CallController {
   }
 
   private scheduleRecipient() {
-    // In the branch where we reached the intended participant,
-    // set a task to collect the desired appointment time.
+    // We have now confirmed that we are talking to the patient.
+    // Set the Agent's current task to collect the desired appointment time.
     this.setTask(
       {
         // The check list is an ordered list of items for the agent to go through.
+        // It can include short prompts as well as Fields to capture structured information.
         checklist: [
-          // guava.Say instructions are verbatim.
-          guava.Say("Let me look to see what appointment times we have available."),
+          "tell them that it's been a while since their regular cleaning with Dr. Teeth, and ask if they would like to schedule an appointment now.",
           // We have one field to collect, which is the appointment_time.
           guava.Field({
             key: "appointment_time",
             fieldType: "calendar_slot",
             description: "Find a time that works for the caller",
 
-            // This field has a choice generator attached. The agent will invoke this function
-            // with a natural language query, allowing the caller to select between the different options.
-            // The agent can potentially invoke the callback multiple times if the caller rejects the options
-            // or provides a new query.
+            // The choiceGenerator will be called when negotiating a calendar slot.
+            // We respond with a list of datetime options based on the user's
+            // criteria, which is summarized in the query string.
             choiceGenerator: async (query: string) => {
-              // Use the simple DatetimeFilter class we instantiated earlier.
+              // Query will have some natural language preferences like "early morning" or
+              // "next week". The dateTime filter queries our calendar for matching slots.
               const result = await this.datetimeFilter.filter(query, { maxResults: 3 });
-              this.logger.info("Choice generator results: %s", JSON.stringify(result));
+              this.logger.info("Appointment slot matches: %s", JSON.stringify(result));
               return result;
             },
           }),
-          guava.Say("Your appointment has been confirmed! Have a nice day."),
+          "tell them their appointment has been confirmed and answer any questions before ending the call.",
         ],
       },
       () => this.hangup("Thank them for their time and hang up the call."),
@@ -77,7 +77,7 @@ class SchedulingController extends guava.CallController {
   }
 }
 
-export function run(args: string[]) {
+export async function run(args: string[]) {
   const [toNumber, patientName = "Benjamin Buttons"] = args;
 
   if (!toNumber) {
@@ -91,7 +91,3 @@ export function run(args: string[]) {
     new SchedulingController(patientName),
   );
 }
-
-if (import.meta.main) {
-  run(process.argv.slice(2));
-}

package/examples/thai-palace.ts

@@ -59,13 +59,9 @@ class ThaiPalaceCallController extends guava.CallController {
   }
 }
 
-export function run(_args: string[]) {
+export async function run(_args: string[]) {
   new guava.Client().listenInbound(
     { agent_number: process.env.GUAVA_AGENT_NUMBER! },
     (logger) => new ThaiPalaceCallController(getConsoleLogger("debug")),
   );
 }
-
-if (import.meta.main) {
-  run([]);
-}

package/package.json

@@ -2,22 +2,22 @@
   "name": "@guava-ai/guava-sdk",
   "description": "The official TypeScript SDK for building Guava voice agents.",
   "homepage": "https://docs.goguava.ai/typescript-sdk/",
-  "version": "0.5.0",
-  "type": "module",
+  "version": "0.7.0",
+  "type": "commonjs",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
+      "default": "./dist/src/index.js"
     },
     "./helpers/openai": {
       "types": "./dist/src/helpers/openai.d.ts",
-      "import": "./dist/src/helpers/openai.js"
+      "default": "./dist/src/helpers/openai.js"
     },
     "./example-data": {
       "types": "./dist/src/example-data.d.ts",
-      "import": "./dist/src/example-data.js"
+      "default": "./dist/src/example-data.js"
     }
   },
   "devDependencies": {
@@ -28,7 +28,7 @@
     "typescript": "^5.9.3"
   },
   "bin": {
-    "guava-example": "./bin/example-runner.js"
+    "guava-example": "./dist/bin/example-runner.js"
   },
   "dependencies": {
     "openai": "^6.16.0",

package/src/index.ts

@@ -7,7 +7,7 @@ import {
 } from "./commands.ts";
 import * as z from "zod";
 import { ErrorEvent, SessionStartedEvent, decodeEvent, InboundTunnelEvent } from "./events.ts";
-import pkgdata from "../package.json" with { type: "json" };
+import pkgdata from "../package.json";
 import os from "node:os";
 import { getBaseUrl, fetchOrThrow } from "./utils.ts";
 import { telemetryClient } from "./telemetry.ts";

package/bin/example-runner.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-
-import { readdirSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-
-const examplesURL = new URL("../dist/examples/", import.meta.url);
-const examplesDir = fileURLToPath(examplesURL);
-const availableExamples = readdirSync(examplesDir).filter(f => f.endsWith(".js")).map(f => f.replace(/\.js$/, ""));
-
-const exampleName = process.argv[2];
-if (!exampleName) {
-  console.error("Usage: guava-example <example-name> <example-args>");
-  console.error("Available examples:", availableExamples.join(", "))
-  process.exit(1);
-}
-
-if (!availableExamples.includes(exampleName)) {
-  console.error(`Unknown example "${exampleName}". Available examples: ${availableExamples.join(", ")}`);
-  process.exit(1);
-}
-
-const run = async () => {
-  try {
-    // ESM dynamic import works in both ESM packages and CJS CLI files in modern Node
-    const exampleModule = await import(new URL(`${exampleName}.js`, examplesURL));
-    await exampleModule.run(process.argv.slice(3));
-  } catch (err) {
-    console.error(err);
-    process.exit(1);
-  }
-};
-
-run();