@guava-ai/guava-sdk 0.23.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/help-desk.js

@@ -36,23 +36,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.agent = void 0;
 exports.run = run;
 const guava = __importStar(require("@guava-ai/guava-sdk"));
-const openai_1 = require("@guava-ai/guava-sdk/helpers/openai");
+const helpers_1 = require("@guava-ai/guava-sdk/helpers");
+const helpers_2 = require("@guava-ai/guava-sdk/helpers");
 const example_data_1 = require("@guava-ai/guava-sdk/example-data");
-const guava_sdk_1 = require("@guava-ai/guava-sdk");
 exports.agent = new guava.Agent({
     name: "Nova",
     organization: "Clearfield Home & Living",
     purpose: "Answer questions and route callers to the appropriate department.",
 });
-const logger = (0, guava_sdk_1.getDefaultLogger)();
-const documentQA = new openai_1.DocumentQA("clearfield-home-living-qa", example_data_1.FURNITURE_RETAILER_QA);
-const intentRecognizer = new openai_1.IntentRecognizer(["sales", "delivery-and-returns", "account-management", "other"], logger);
+const documentQA = new helpers_1.DocumentQA({
+    documents: example_data_1.FURNITURE_RETAILER_QA,
+    namespace: "clearfield-home-living-qa",
+});
+const intentRecognizer = new helpers_2.IntentRecognizer([
+    "sales",
+    "delivery-and-returns",
+    "account-management",
+    "other",
+]);
 exports.agent.onQuestion(async (_call, question) => {
     return await documentQA.ask(question);
 });
 exports.agent.onActionRequest(async (_call, request) => {
-    const key = await intentRecognizer.classify(request);
-    return { key };
+    return await intentRecognizer.classify(request);
 });
 exports.agent.onAction("sales", async (call) => {
     call.transfer("+15555555555", "Notify the caller that you will be transferring them to the Sales department.");
@@ -73,6 +79,14 @@ async function run(args) {
     else if (args.includes("--phone")) {
         exports.agent.listenPhone(process.env.GUAVA_AGENT_NUMBER);
     }
+    else if (args.includes("--sip")) {
+        const sipCode = args[args.indexOf("--sip") + 1];
+        if (!sipCode) {
+            console.error("Error: --sip requires a SIP code argument.");
+            process.exit(1);
+        }
+        await exports.agent.listenSip(sipCode);
+    }
     else if (args.includes("--local")) {
         await exports.agent.callLocal();
     }
@@ -80,7 +94,7 @@ async function run(args) {
         await exports.agent.chat();
     }
     else {
-        console.error("Usage: guava-example help-desk --phone | --webrtc | --local | --chat");
+        console.error("Usage: guava-example help-desk --phone | --webrtc | --sip | --local | --chat");
         process.exit(1);
     }
 }

package/dist/examples/help-desk.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-desk.js","sourceRoot":"","sources":["../../examples/help-desk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,kBAaC;AAtED,2DAA6C;AAC7C,+DAAkF;AAClF,mEAAyE;AACzE,mDAAuD;AAE1C,QAAA,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,MAAM;IACZ,YAAY,EAAE,0BAA0B;IACxC,OAAO,EAAE,mEAAmE;CAC7E,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAA,4BAAgB,GAAE,CAAC;AAElC,MAAM,UAAU,GAAG,IAAI,mBAAU,CAAC,2BAA2B,EAAE,oCAAqB,CAAC,CAAC;AAEtF,MAAM,gBAAgB,GAAG,IAAI,yBAAgB,CAC3C,CAAC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,OAAO,CAAU,EACzE,MAAM,CACP,CAAC;AAEF,aAAK,CAAC,UAAU,CAAC,KAAK,EAAE,KAAiB,EAAE,QAAgB,EAAE,EAAE;IAC7D,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,aAAK,CAAC,eAAe,CAAC,KAAK,EAAE,KAAiB,EAAE,OAAe,EAAE,EAAE;IACjE,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC,CAAC,CAAC;AAEH,aAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,IAAgB,EAAE,EAAE;IACjD,IAAI,CAAC,QAAQ,CACX,cAAc,EACd,+EAA+E,CAChF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,aAAK,CAAC,QAAQ,CAAC,sBAAsB,EAAE,KAAK,EAAE,IAAgB,EAAE,EAAE;IAChE,IAAI,CAAC,QAAQ,CACX,cAAc,EACd,8FAA8F,CAC/F,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,aAAK,CAAC,QAAQ,CAAC,oBAAoB,EAAE,KAAK,EAAE,IAAgB,EAAE,EAAE;IAC9D,IAAI,CAAC,QAAQ,CACX,cAAc,EACd,4FAA4F,CAC7F,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,aAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,IAAgB,EAAE,EAAE;IACjD,IAAI,CAAC,QAAQ,CACX,cAAc,EACd,mFAAmF,CACpF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,aAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,aAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,aAAK,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,aAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"help-desk.js","sourceRoot":"","sources":["../../examples/help-desk.ts"],"names":[],"mappings":"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"}

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/property-insurance.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = run;
 const guava = __importStar(require("@guava-ai/guava-sdk"));
-const openai_1 = require("@guava-ai/guava-sdk/helpers/openai");
+const helpers_1 = require("@guava-ai/guava-sdk/helpers");
 const example_data_1 = require("@guava-ai/guava-sdk/example-data");
 const agent = new guava.Agent({
     organization: "Harper Valley Property Insurance",
@@ -43,7 +43,10 @@ const agent = new guava.Agent({
 });
 // This is a built-in knowledge base helper that we will use for this example.
 // You can use any RAG system you prefer.
-const documentQA = new openai_1.DocumentQA("harper-valley-property-insurance", example_data_1.PROPERTY_INSURANCE_POLICY);
+const documentQA = new helpers_1.DocumentQA({
+    documents: example_data_1.PROPERTY_INSURANCE_POLICY,
+    namespace: "harper-valley-property-insurance",
+});
 // When the Agent is asked a question that it cannot answer, it will invoke the on_question callback.
 agent.onQuestion(async (call, question) => {
     // Forward the Agent's question to the knowledge base and return the answer.
@@ -57,6 +60,14 @@ async function run(args) {
     else if (args.includes("--phone")) {
         agent.listenPhone(process.env.GUAVA_AGENT_NUMBER);
     }
+    else if (args.includes("--sip")) {
+        const sipCode = args[args.indexOf("--sip") + 1];
+        if (!sipCode) {
+            console.error("Error: --sip requires a SIP code argument.");
+            process.exit(1);
+        }
+        await agent.listenSip(sipCode);
+    }
     else if (args.includes("--local")) {
         await agent.callLocal();
     }
@@ -64,7 +75,7 @@ async function run(args) {
         await agent.chat();
     }
     else {
-        console.error("Usage: guava-example property-insurance --phone | --webrtc | --local | --chat");
+        console.error("Usage: guava-example property-insurance --phone | --webrtc | --sip | --local | --chat");
         process.exit(1);
     }
 }

package/dist/examples/property-insurance.js.map

@@ -1 +1 @@
-{"version":3,"file":"property-insurance.js","sourceRoot":"","sources":["../../examples/property-insurance.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,kBAaC;AAjCD,2DAA6C;AAC7C,+DAAgE;AAChE,mEAA6E;AAE7E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,YAAY,EAAE,kCAAkC;IAChD,OAAO,EAAE,wFAAwF;CAClG,CAAC,CAAC;AAEH,8EAA8E;AAC9E,yCAAyC;AACzC,MAAM,UAAU,GAAG,IAAI,mBAAU,CAAC,kCAAkC,EAAE,wCAAyB,CAAC,CAAC;AAEjG,qGAAqG;AACrG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,IAAgB,EAAE,QAAgB,EAAE,EAAE;IAC5D,4EAA4E;IAC5E,2DAA2D;IAC3D,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"property-insurance.js","sourceRoot":"","sources":["../../examples/property-insurance.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,kBAsBC;AA7CD,2DAA6C;AAC7C,yDAAyD;AACzD,mEAA6E;AAE7E,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,YAAY,EAAE,kCAAkC;IAChD,OAAO,EAAE,wFAAwF;CAClG,CAAC,CAAC;AAEH,8EAA8E;AAC9E,yCAAyC;AACzC,MAAM,UAAU,GAAG,IAAI,oBAAU,CAAC;IAChC,SAAS,EAAE,wCAAyB;IACpC,SAAS,EAAE,kCAAkC;CAC9C,CAAC,CAAC;AAEH,qGAAqG;AACrG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,IAAgB,EAAE,QAAgB,EAAE,EAAE;IAC5D,4EAA4E;IAC5E,2DAA2D;IAC3D,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,uFAAuF,CACxF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/examples/restaurant-waitlist.js

@@ -75,6 +75,14 @@ async function run(args) {
     else if (args.includes("--phone")) {
         agent.listenPhone(process.env.GUAVA_AGENT_NUMBER);
     }
+    else if (args.includes("--sip")) {
+        const sipCode = args[args.indexOf("--sip") + 1];
+        if (!sipCode) {
+            console.error("Error: --sip requires a SIP code argument.");
+            process.exit(1);
+        }
+        await agent.listenSip(sipCode);
+    }
     else if (args.includes("--local")) {
         await agent.callLocal();
     }
@@ -82,7 +90,7 @@ async function run(args) {
         await agent.chat();
     }
     else {
-        console.error("Usage: guava-example restaurant-waitlist --phone | --webrtc | --local | --chat");
+        console.error("Usage: guava-example restaurant-waitlist --phone | --webrtc | --sip | --local | --chat");
         process.exit(1);
     }
 }

package/dist/examples/restaurant-waitlist.js.map

@@ -1 +1 @@
-{"version":3,"file":"restaurant-waitlist.js","sourceRoot":"","sources":["../../examples/restaurant-waitlist.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,kBAaC;AAzDD,2DAA6C;AAC7C,mDAAuD;AAEvD,MAAM,MAAM,GAAG,IAAA,4BAAgB,GAAE,CAAC;AAElC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,IAAI,EAAE,KAAK;IACX,YAAY,EAAE,aAAa;IAC3B,OAAO,EAAE,8CAA8C;CACxD,CAAC,CAAC;AAEH,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,SAAyB,EAAE,EAAE;IACvD,6FAA6F;IAC7F,8FAA8F;IAC9F,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAgB,EAAE,EAAE;IAC3C,MAAM,IAAI,CAAC,OAAO,CAAC;QACjB,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,2EAA2E;QACtF,SAAS,EAAE;YACT,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;YAC5F,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;YACzF,KAAK,CAAC,KAAK,CAAC;gBACV,GAAG,EAAE,cAAc;gBACnB,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,8CAA8C;aAC5D,CAAC;YACF,sDAAsD;SACvD;KACF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,EAAE,IAAgB,EAAE,EAAE;IAC1D,MAAM,CAAC,IAAI,CACT,qCAAqC,EACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAClC,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAClC,CAAC;IACF,MAAM,IAAI,CAAC,MAAM,CAAC,0EAA0E,CAAC,CAAC;AAChG,CAAC,CAAC,CAAC;AAEI,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,gFAAgF,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"restaurant-waitlist.js","sourceRoot":"","sources":["../../examples/restaurant-waitlist.ts"],"names":[],"mappings":"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"}