@guava-ai/guava-sdk 0.24.0 → 0.25.0

package/README.md

@@ -7,15 +7,25 @@ This library allows you to build Guava voice agents using TypeScript or Javascri
 
 Full documentation for the TypeScript SDK can be found at [https://goguava.ai/docs/](https://goguava.ai/docs/). SDK examples can be found under [./examples/](https://github.com/goguava-ai/typescript-sdk/tree/main/examples).
 
-## Try an Example
+## Authentication
 
-Export two environment variables. You should have received these in your beta invite email.
-```bash
+Log in using the [Guava CLI](https://goguava.ai/docs/quickstart):
+
+```shell
+guava login
+```
+
+Alternatively, provide an API key through an environment variable.
+
+```shell
 $ export GUAVA_API_KEY="..." # Your API key for authentication.
 $ export GUAVA_AGENT_NUMBER="..." # A phone number for your agent to use.
 ```
 
+## Try an Example
+
 Run an outbound phone call example using `npx`. Replace the phone number with your own and your agent will call you.
+
 ```bash
 $ npx @guava-ai/guava-sdk@latest scheduling-outbound +15556667777 # Your agent will call this number.
 ```

package/bin/example-runner.ts

@@ -1,26 +1,153 @@
 #!/usr/bin/env node
 
-const EXAMPLES = {
-  "scheduling-outbound": () => import("../examples/scheduling-outbound"),
-  "property-insurance": () => import("../examples/property-insurance"),
-  "restaurant-waitlist": () => import("../examples/restaurant-waitlist"),
-  "help-desk": () => import("../examples/help-desk"),
-  "polling-campaign": () => import("../examples/polling-campaign"),
+const USE_COLOR = process.stdout.isTTY === true && !process.env.NO_COLOR;
+const c = {
+  reset: USE_COLOR ? "\x1b[0m" : "",
+  dim: USE_COLOR ? "\x1b[2m" : "",
+  green: USE_COLOR ? "\x1b[32m" : "",
+  red: USE_COLOR ? "\x1b[38;5;196m" : "",
+  bold: USE_COLOR ? "\x1b[1m" : "",
+  cyan: USE_COLOR ? "\x1b[36m" : "",
 };
 
+type TestFn = () => Promise<void> | void;
+type Registered = { suite: string; name: string; fn: TestFn };
+
+// This is a minimal in-process implementation of a Jest-like test runnner to allow the agent testing example
+// to be run from example runner.
+async function runAgentTesting(_args: string[]): Promise<void> {
+  const registered: Registered[] = [];
+  let currentSuite = "";
+
+  (global as any).describe = (name: string, fn: () => void) => {
+    currentSuite = name;
+    fn();
+    currentSuite = "";
+  };
+
+  (global as any).test = (name: string, fn: TestFn) => {
+    registered.push({ suite: currentSuite, name, fn });
+  };
+
+  (global as any).expect = (received: unknown) => ({
+    toBe(expected: unknown) {
+      if (received !== expected)
+        throw new Error(`Expected ${JSON.stringify(received)} to be ${JSON.stringify(expected)}`);
+    },
+    toContain(expected: unknown) {
+      if (!Array.isArray(received) || !received.includes(expected))
+        throw new Error(`Expected array to contain ${JSON.stringify(expected)}`);
+    },
+    toContainEqual(expected: unknown) {
+      if (
+        !Array.isArray(received) ||
+        !received.some(
+          (item) => JSON.stringify(item) === JSON.stringify(expected),
+        )
+      )
+        throw new Error(`Expected array to contain equal to ${JSON.stringify(expected)}`);
+    },
+    toHaveProperty(key: string, expected?: unknown) {
+      const obj = received as Record<string, unknown>;
+      if (!(key in obj))
+        throw new Error(`Expected object to have property "${key}"`);
+      if (expected !== undefined && obj[key] !== expected)
+        throw new Error(
+          `Expected property "${key}" to be ${JSON.stringify(expected)}, got ${JSON.stringify(obj[key])}`,
+        );
+    },
+  });
+
+  const prevLogLevel = process.env.LOG_LEVEL;
+  process.env.LOG_LEVEL = "off";
+  await import("../examples/agent-testing.test");
+
+  let passed = 0,
+    failed = 0;
+  for (const { suite, name, fn } of registered) {
+    process.stdout.write(`${c.dim}${suite} › ${name}${c.reset} `);
+    try {
+      await fn();
+      process.stdout.write(`${c.green}✓ passed${c.reset}\n`);
+      passed++;
+    } catch (e: any) {
+      process.stdout.write(`${c.red}✗ FAILED${c.reset}\n`);
+      console.error(`  ${c.red}${e.message}${c.reset}`);
+      failed++;
+    }
+  }
+
+  process.env.LOG_LEVEL = prevLogLevel ?? "";
+
+  const summary =
+    failed > 0
+      ? `${c.bold}${c.green}${passed} passed${c.reset}, ${c.bold}${c.red}${failed} failed${c.reset}`
+      : `${c.bold}${c.green}${passed} passed${c.reset}`;
+  console.log(`\n${summary}`);
+  if (failed > 0) process.exit(1);
+}
+
+type ExampleEntry = {
+  description: string;
+  load: () => Promise<{ run: (args: string[]) => Promise<void> }>;
+};
+
+const EXAMPLES: Record<string, ExampleEntry> = {
+  "scheduling-outbound": {
+    description: "Outbound scheduling agent",
+    load: () => import("../examples/scheduling-outbound"),
+  },
+  "property-insurance": {
+    description: "Inbound property insurance Q&A agent",
+    load: () => import("../examples/property-insurance"),
+  },
+  "restaurant-waitlist": {
+    description: "Inbound restaurant waitlist agent",
+    load: () => import("../examples/restaurant-waitlist"),
+  },
+  "help-desk": {
+    description: "Inbound customer support routing and FAQ agent",
+    load: () => import("../examples/help-desk"),
+  },
+  "polling-campaign": {
+    description: "Attach a polling agent to a Guava campaign",
+    load: () => import("../examples/polling-campaign"),
+  },
+  "multiple-agents": {
+    description: "Run two agents simultaneously using Runner",
+    load: () => import("../examples/multiple-agents"),
+  },
+  "agent-testing": {
+    description: "Run agent unit tests and conversation simulations",
+    load: async () => ({ run: runAgentTesting }),
+  },
+};
+
+function printUsage(message?: string): void {
+  const colWidth = Math.max(...Object.keys(EXAMPLES).map((k) => k.length)) + 3;
+  if (message) {
+    console.error(`${c.red}${message}${c.reset}\n`);
+  }
+  console.error(`${c.bold}Usage:${c.reset} guava-example <example-name> [args...]\n`);
+  console.error(`${c.bold}Examples:${c.reset}`);
+  for (const [name, { description }] of Object.entries(EXAMPLES)) {
+    const padded = name.padEnd(colWidth);
+    console.error(`  ${c.cyan}${padded}${c.reset}${c.dim}${description}${c.reset}`);
+  }
+}
+
 const exampleName = process.argv[2];
 if (!exampleName) {
-  console.error("Usage: guava-example <example-name> <example-args>");
-  console.error("Available examples:", Object.keys(EXAMPLES).join(", "));
+  printUsage();
   process.exit(1);
 }
 
 if (!(exampleName in EXAMPLES)) {
-  console.error(`Unknown example "${exampleName}". Available examples: ${Object.keys(EXAMPLES).join(", ")}`);
+  printUsage(`Unknown example "${exampleName}".`);
   process.exit(1);
 }
 
 (async () => {
-  const mod = await EXAMPLES[exampleName as keyof typeof EXAMPLES]();
+  const mod = await EXAMPLES[exampleName].load();
   await mod.run(process.argv.slice(3));
-})();
+})();

package/dist/bin/example-runner.d.ts

@@ -1,9 +1,26 @@
 #!/usr/bin/env node
-declare const EXAMPLES: {
-    "scheduling-outbound": () => Promise<typeof import("../examples/scheduling-outbound")>;
-    "property-insurance": () => Promise<typeof import("../examples/property-insurance")>;
-    "restaurant-waitlist": () => Promise<typeof import("../examples/restaurant-waitlist")>;
-    "help-desk": () => Promise<typeof import("../examples/help-desk")>;
-    "polling-campaign": () => Promise<typeof import("../examples/polling-campaign")>;
+declare const USE_COLOR: boolean;
+declare const c: {
+    reset: string;
+    dim: string;
+    green: string;
+    red: string;
+    bold: string;
+    cyan: string;
 };
+type TestFn = () => Promise<void> | void;
+type Registered = {
+    suite: string;
+    name: string;
+    fn: TestFn;
+};
+declare function runAgentTesting(_args: string[]): Promise<void>;
+type ExampleEntry = {
+    description: string;
+    load: () => Promise<{
+        run: (args: string[]) => Promise<void>;
+    }>;
+};
+declare const EXAMPLES: Record<string, ExampleEntry>;
+declare function printUsage(message?: string): void;
 declare const exampleName: string;

package/dist/bin/example-runner.js

@@ -32,25 +32,128 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+const USE_COLOR = process.stdout.isTTY === true && !process.env.NO_COLOR;
+const c = {
+    reset: USE_COLOR ? "\x1b[0m" : "",
+    dim: USE_COLOR ? "\x1b[2m" : "",
+    green: USE_COLOR ? "\x1b[32m" : "",
+    red: USE_COLOR ? "\x1b[38;5;196m" : "",
+    bold: USE_COLOR ? "\x1b[1m" : "",
+    cyan: USE_COLOR ? "\x1b[36m" : "",
+};
+// This is a minimal in-process implementation of a Jest-like test runnner to allow the agent testing example
+// to be run from example runner.
+async function runAgentTesting(_args) {
+    const registered = [];
+    let currentSuite = "";
+    global.describe = (name, fn) => {
+        currentSuite = name;
+        fn();
+        currentSuite = "";
+    };
+    global.test = (name, fn) => {
+        registered.push({ suite: currentSuite, name, fn });
+    };
+    global.expect = (received) => ({
+        toBe(expected) {
+            if (received !== expected)
+                throw new Error(`Expected ${JSON.stringify(received)} to be ${JSON.stringify(expected)}`);
+        },
+        toContain(expected) {
+            if (!Array.isArray(received) || !received.includes(expected))
+                throw new Error(`Expected array to contain ${JSON.stringify(expected)}`);
+        },
+        toContainEqual(expected) {
+            if (!Array.isArray(received) ||
+                !received.some((item) => JSON.stringify(item) === JSON.stringify(expected)))
+                throw new Error(`Expected array to contain equal to ${JSON.stringify(expected)}`);
+        },
+        toHaveProperty(key, expected) {
+            const obj = received;
+            if (!(key in obj))
+                throw new Error(`Expected object to have property "${key}"`);
+            if (expected !== undefined && obj[key] !== expected)
+                throw new Error(`Expected property "${key}" to be ${JSON.stringify(expected)}, got ${JSON.stringify(obj[key])}`);
+        },
+    });
+    const prevLogLevel = process.env.LOG_LEVEL;
+    process.env.LOG_LEVEL = "off";
+    await Promise.resolve().then(() => __importStar(require("../examples/agent-testing.test")));
+    let passed = 0, failed = 0;
+    for (const { suite, name, fn } of registered) {
+        process.stdout.write(`${c.dim}${suite} › ${name}${c.reset} `);
+        try {
+            await fn();
+            process.stdout.write(`${c.green}✓ passed${c.reset}\n`);
+            passed++;
+        }
+        catch (e) {
+            process.stdout.write(`${c.red}✗ FAILED${c.reset}\n`);
+            console.error(`  ${c.red}${e.message}${c.reset}`);
+            failed++;
+        }
+    }
+    process.env.LOG_LEVEL = prevLogLevel ?? "";
+    const summary = failed > 0
+        ? `${c.bold}${c.green}${passed} passed${c.reset}, ${c.bold}${c.red}${failed} failed${c.reset}`
+        : `${c.bold}${c.green}${passed} passed${c.reset}`;
+    console.log(`\n${summary}`);
+    if (failed > 0)
+        process.exit(1);
+}
 const EXAMPLES = {
-    "scheduling-outbound": () => Promise.resolve().then(() => __importStar(require("../examples/scheduling-outbound"))),
-    "property-insurance": () => Promise.resolve().then(() => __importStar(require("../examples/property-insurance"))),
-    "restaurant-waitlist": () => Promise.resolve().then(() => __importStar(require("../examples/restaurant-waitlist"))),
-    "help-desk": () => Promise.resolve().then(() => __importStar(require("../examples/help-desk"))),
-    "polling-campaign": () => Promise.resolve().then(() => __importStar(require("../examples/polling-campaign"))),
+    "scheduling-outbound": {
+        description: "Outbound scheduling agent",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/scheduling-outbound"))),
+    },
+    "property-insurance": {
+        description: "Inbound property insurance Q&A agent",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/property-insurance"))),
+    },
+    "restaurant-waitlist": {
+        description: "Inbound restaurant waitlist agent",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/restaurant-waitlist"))),
+    },
+    "help-desk": {
+        description: "Inbound customer support routing and FAQ agent",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/help-desk"))),
+    },
+    "polling-campaign": {
+        description: "Attach a polling agent to a Guava campaign",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/polling-campaign"))),
+    },
+    "multiple-agents": {
+        description: "Run two agents simultaneously using Runner",
+        load: () => Promise.resolve().then(() => __importStar(require("../examples/multiple-agents"))),
+    },
+    "agent-testing": {
+        description: "Run agent unit tests and conversation simulations",
+        load: async () => ({ run: runAgentTesting }),
+    },
 };
+function printUsage(message) {
+    const colWidth = Math.max(...Object.keys(EXAMPLES).map((k) => k.length)) + 3;
+    if (message) {
+        console.error(`${c.red}${message}${c.reset}\n`);
+    }
+    console.error(`${c.bold}Usage:${c.reset} guava-example <example-name> [args...]\n`);
+    console.error(`${c.bold}Examples:${c.reset}`);
+    for (const [name, { description }] of Object.entries(EXAMPLES)) {
+        const padded = name.padEnd(colWidth);
+        console.error(`  ${c.cyan}${padded}${c.reset}${c.dim}${description}${c.reset}`);
+    }
+}
 const exampleName = process.argv[2];
 if (!exampleName) {
-    console.error("Usage: guava-example <example-name> <example-args>");
-    console.error("Available examples:", Object.keys(EXAMPLES).join(", "));
+    printUsage();
     process.exit(1);
 }
 if (!(exampleName in EXAMPLES)) {
-    console.error(`Unknown example "${exampleName}". Available examples: ${Object.keys(EXAMPLES).join(", ")}`);
+    printUsage(`Unknown example "${exampleName}".`);
     process.exit(1);
 }
 (async () => {
-    const mod = await EXAMPLES[exampleName]();
+    const mod = await EXAMPLES[exampleName].load();
     await mod.run(process.argv.slice(3));
 })();
 //# sourceMappingURL=example-runner.js.map

package/dist/bin/example-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"example-runner.js","sourceRoot":"","sources":["../../bin/example-runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,MAAM,QAAQ,GAAG;IACf,qBAAqB,EAAE,GAAG,EAAE,mDAAQ,iCAAiC,GAAC;IACtE,oBAAoB,EAAE,GAAG,EAAE,mDAAQ,gCAAgC,GAAC;IACpE,qBAAqB,EAAE,GAAG,EAAE,mDAAQ,iCAAiC,GAAC;IACtE,WAAW,EAAE,GAAG,EAAE,mDAAQ,uBAAuB,GAAC;IAClD,kBAAkB,EAAE,GAAG,EAAE,mDAAQ,8BAA8B,GAAC;CACjE,CAAC;AAEF,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjB,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACpE,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,EAAE,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,oBAAoB,WAAW,0BAA0B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,CAAC,KAAK,IAAI,EAAE;IACV,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAoC,CAAC,EAAE,CAAC;IACnE,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"example-runner.js","sourceRoot":"","sources":["../../bin/example-runner.ts"],"names":[],"mappings":"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"}

package/dist/examples/{example.test.js → agent-testing.test.js}

@@ -9,7 +9,7 @@ const help_desk_1 = require("@guava-ai/guava-sdk/examples/help-desk");
 describe("HelpDeskAgent", () => {
     test("handler unit test - new purchase routes to sales", async () => {
         const suggestion = await help_desk_1.agent.handlers.onActionRequest(new guava_sdk_1.MockCall(), "make a new purchase");
-        expect(suggestion).toHaveProperty("key", "sales");
+        expect(suggestion).toContainEqual({ key: "sales" });
     });
     test("new purchase routes to sales", async () => {
         const session = await help_desk_1.agent.test(async (session) => {
@@ -43,4 +43,4 @@ describe("HelpDeskAgent", () => {
         });
     });
 });
-//# sourceMappingURL=example.test.js.map
+//# sourceMappingURL=agent-testing.test.js.map

package/dist/examples/agent-testing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-testing.test.js","sourceRoot":"","sources":["../../examples/agent-testing.test.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAGH,mDAA+C;AAC/C,sEAA+D;AAE/D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,UAAU,GAAG,MAAM,iBAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,oBAAQ,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAC/F,MAAM,CAAC,UAAU,CAAC,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG,MAAM,iBAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACjD,iFAAiF;YACjF,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YAEvD,6CAA6C;YAC7C,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,mEAAmE;QAEnE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAChD,mFAAmF;QACnF,MAAM,OAAO,GAAG,MAAM,iBAAK,CAAC,YAAY,CAAC,6CAA6C,CAAC,CAAC;QAExF,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACzD,4EAA4E;QAC5E,MAAM,OAAO,GAAG,iBAAK,CAAC,KAAK,EAAE,CAAC;QAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,IAAU,EAAE,EAAE;YAC7C,IAAI,CAAC,MAAM,CACT,8GAA8G,CAC/G,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,6CAA6C,CAAC,CAAC;QAE1F,8FAA8F;QAC9F,MAAM,OAAO,CAAC,QAAQ,CAAC;YACrB,YAAY,EAAE,CAAC,sEAAsE,CAAC;YACtF,YAAY,EAAE,CAAC,2DAA2D,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/examples/multiple-agents.d.ts

@@ -0,0 +1 @@
+export declare function run(_args: string[]): Promise<void>;

package/dist/examples/multiple-agents.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const guava = __importStar(require("@guava-ai/guava-sdk"));
+const agentA = new guava.Agent({
+    name: "Grace",
+    purpose: "You are a helpful voice agent.",
+});
+const agentB = new guava.Agent({
+    name: "Jordan",
+    purpose: "You are a helpful voice agent.",
+});
+async function run(_args) {
+    const runner = new guava.Runner();
+    runner.listenPhone(agentA, process.env.GUAVA_AGENT_NUMBER);
+    runner.listenWebrtc(agentB);
+    await runner.run();
+}
+//# sourceMappingURL=multiple-agents.js.map

package/dist/examples/multiple-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiple-agents.js","sourceRoot":"","sources":["../../examples/multiple-agents.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,kBAKC;AAjBD,2DAA6C;AAE7C,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC7B,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,KAAe;IACvC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;IAC5D,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC"}

package/dist/examples/scheduling-outbound.js

@@ -37,6 +37,7 @@ exports.run = run;
 const guava = __importStar(require("@guava-ai/guava-sdk"));
 const helpers_1 = require("@guava-ai/guava-sdk/helpers");
 const example_data_1 = require("@guava-ai/guava-sdk/example-data");
+const example_utils_1 = require("@guava-ai/guava-sdk/example-utils");
 const agent = new guava.Agent({
     organization: "Bright Smile Dental",
     purpose: "You are calling patients to help them schedule a dental appointment",
@@ -65,7 +66,7 @@ agent.onReachPerson(async (call, outcome) => {
         });
     }
     else {
-        await call.hangup("Apologize for your mistake and hang up the call.");
+        await call.hangup("Appropriately end the call.");
     }
 });
 agent.onTaskComplete("schedule_appointment", async (call) => {
@@ -83,7 +84,7 @@ async function run(args) {
         console.error("       guava-example scheduling-outbound --chat [name]");
         process.exit(1);
     }
-    agent.callPhone(process.env.GUAVA_AGENT_NUMBER, toNumber, {
+    agent.callPhone(await (0, example_utils_1.getAgentNumber)(), toNumber, {
         patientName: patientName,
     });
 }

package/dist/examples/scheduling-outbound.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduling-outbound.js","sourceRoot":"","sources":["../../examples/scheduling-outbound.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,kBAkBC;AA7DD,2DAA6C;AAC7C,yDAA6D;AAC7D,mEAA6E;AAE7E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,YAAY,EAAE,qBAAqB;IACnC,OAAO,EAAE,qEAAqE;CAC/E,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,wBAAc,CAAC,IAAA,wCAAyB,GAAE,CAAC,CAAC;AAEvE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;IAC3C,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,aAAa,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAC7D,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAgB,EAAE,OAAe,EAAE,EAAE;IAC9D,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,sBAAsB;YAC9B,SAAS,EAAE;gBACT,+EAA+E;gBAC/E,KAAK,CAAC,KAAK,CAAC;oBACV,GAAG,EAAE,kBAAkB;oBACvB,SAAS,EAAE,eAAe;oBAC1B,WAAW,EAAE,uCAAuC;oBACpD,UAAU,EAAE,IAAI;iBACjB,CAAC;gBACF,iGAAiG;aAClG;SACF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,iDAAiD,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC;QAC3E,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAE1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,EAAE;QACxD,WAAW,EAAE,WAAW;KACzB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"scheduling-outbound.js","sourceRoot":"","sources":["../../examples/scheduling-outbound.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,kBAkBC;AA9DD,2DAA6C;AAC7C,yDAA6D;AAC7D,mEAA6E;AAC7E,qEAAmE;AAEnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,YAAY,EAAE,qBAAqB;IACnC,OAAO,EAAE,qEAAqE;CAC/E,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,wBAAc,CAAC,IAAA,wCAAyB,GAAE,CAAC,CAAC;AAEvE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;IAC3C,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,aAAa,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAC7D,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAgB,EAAE,OAAe,EAAE,EAAE;IAC9D,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,sBAAsB;YAC9B,SAAS,EAAE;gBACT,+EAA+E;gBAC/E,KAAK,CAAC,KAAK,CAAC;oBACV,GAAG,EAAE,kBAAkB;oBACvB,SAAS,EAAE,eAAe;oBAC1B,WAAW,EAAE,uCAAuC;oBACpD,UAAU,EAAE,IAAI;iBACjB,CAAC;gBACF,iGAAiG;aAClG;SACF,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;IACnD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAC1D,MAAM,IAAI,CAAC,MAAM,CAAC,iDAAiD,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC;QAC3E,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAE1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAM,IAAA,8BAAc,GAAE,EAAE,QAAQ,EAAE;QAChD,WAAW,EAAE,WAAW;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/agent.d.ts

@@ -1,8 +1,16 @@
 import { type AgentSpeechEvent, type BotSessionEnded, type CallerSpeechEvent, type DTMFPressedEvent, type EscalateEvent } from "./events.ts";
 import { HealthContext } from "./health.ts";
-import { Call } from "./index.ts";
+import { Call, Client } from "./index.ts";
 import type { CallInfo } from "./socket/call-info.ts";
 import { TestSession } from "./testing/session.ts";
+import * as z from "zod";
+export declare const _roleplayActionSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        hangup: "hangup";
+        speak: "speak";
+    }>;
+    utterance: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export type { CallInfo } from "./socket/call-info.ts";
 export type IncomingCallAction = {
     action: "accept";
@@ -27,7 +35,7 @@ export declare class Agent {
     private _voice?;
     private _acceptDtmfForNumbers;
     private _logger;
-    private _client;
+    _client: Client;
     private _onCallReceived;
     private _onCallStart?;
     private _onCallerSpeech?;
@@ -90,7 +98,7 @@ export declare class Agent {
     /**
      * @description use the Guava API to call out to a number
      */
-    callPhone(fromNumber: string | undefined, toNumber: string, variables?: Record<string, any>): Promise<void>;
+    callPhone(fromNumber: string, toNumber: string, variables?: Record<string, any>): Promise<void>;
     /**
      * Run the agent against a live test session.
      *
@@ -152,7 +160,7 @@ export declare class Agent {
      * affecting the original agent.
      */
     patch(): Agent;
-    private _serveCampaign;
+    _serveCampaign(healthCtx: HealthContext, campaignCode: string): Promise<void>;
     /**
      * Attach this agent to an active Guava campaign and handle outbound calls.
      *
@@ -168,5 +176,5 @@ export declare class Agent {
     /** @deprecated Use {@link listenPhone} instead. */
     inboundPhone(phoneNumber: string): Promise<void>;
     /** @deprecated Use {@link callPhone} instead. */
-    outboundPhone(fromNumber: string | undefined, toNumber: string, variables?: Record<string, any>): Promise<void>;
+    outboundPhone(fromNumber: string, toNumber: string, variables?: Record<string, any>): Promise<void>;
 }

package/dist/src/agent.js

@@ -122,7 +122,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Agent = void 0;
+exports.Agent = exports._roleplayActionSchema = void 0;
 const ws_1 = __importDefault(require("ws"));
 const commands_ts_1 = require("./commands.js");
 const events_ts_1 = require("./events.js");
@@ -137,8 +137,13 @@ const telemetry_ts_1 = require("./telemetry.js");
 const chat_ts_1 = require("./testing/chat.js");
 const protocol_ts_1 = require("./testing/protocol.js");
 const session_ts_1 = require("./testing/session.js");
+const z = __importStar(require("zod"));
 const utils_ts_1 = require("./utils.js");
 const webrtc_helper_ts_1 = require("./webrtc-helper.js");
+exports._roleplayActionSchema = z.object({
+    action: z.enum(["speak", "hangup"]),
+    utterance: z.string().optional(),
+});
 let Agent = (() => {
     let _classDecorators = [telemetry_ts_1.telemetryClient.trackClass()];
     let _classDescriptor;
@@ -659,8 +664,7 @@ let Agent = (() => {
          */
         async callPhone(fromNumber, toNumber, variables = {}) {
             const url = new URL("v2/create-outbound", this._client.getHttpBase());
-            if (fromNumber)
-                url.searchParams.set("from_number", fromNumber);
+            url.searchParams.set("from_number", fromNumber);
             url.searchParams.set("to_number", toNumber);
             const response = await (0, utils_ts_1.fetchOrThrow)(url, {
                 method: "POST",
@@ -744,15 +748,6 @@ let Agent = (() => {
          * assert(session.executedActions.includes("sales"));
          */
         async roleplay(roleplayPrompt, variables = {}) {
-            const roleplaySchema = {
-                type: "object",
-                properties: {
-                    action: { type: "string", enum: ["speak", "hangup"] },
-                    utterance: { type: "string" },
-                },
-                required: ["action"],
-                additionalProperties: false,
-            };
             return this.test(async (session) => {
                 let snapshotLen = 0;
                 try {
@@ -773,8 +768,8 @@ Conversation:
 ${transcript || "(The agent has not spoken yet)"}
 
 Choose "speak" and provide your next utterance, or choose "hangup" if the conversation has naturally concluded.`;
-                        const raw = await (0, llm_ts_1._generate)(this._client, prompt, roleplaySchema);
-                        const action = JSON.parse(raw);
+                        const raw = await (0, llm_ts_1._generate)(this._client, prompt, z.toJSONSchema(exports._roleplayActionSchema));
+                        const action = exports._roleplayActionSchema.parse(JSON.parse(raw));
                         if (action.action === "hangup") {
                             this._logger.info("(Roleplay Session) [caller hangs up]");
                             break;