@guava-ai/guava-sdk 0.1.0

package/bin/example-runner.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+const exampleName = process.argv[2];
+if (!exampleName) {
+  console.error("Usage: guava-example <example-name> <example-args>");
+  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(`../dist/examples/${exampleName}.js`, import.meta.url));
+    exampleModule.run(process.argv.slice(3))
+  } catch (err) {
+    if (err.code === "ERR_MODULE_NOT_FOUND") {
+      console.error(`Couldn't find example: ${exampleName}`)
+    } else {
+      console.error(err);
+    }
+    process.exit(1);
+  }
+};
+
+run();

package/dist/examples/property-insurance.d.ts

@@ -0,0 +1 @@
+export declare function run(args: string[]): void;

package/dist/examples/property-insurance.js

@@ -0,0 +1,41 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as guava from "../src/index.js";
+import { DocumentQA } from "../src/helpers/openai.js";
+import { PROPERTY_INSURANCE_POLICY } from "../src/example_data.js";
+class InsuranceCallController extends guava.CallController {
+    constructor(logger) {
+        super(logger);
+        this.documentQA = new DocumentQA("harper-valley-property-insurance", PROPERTY_INSURANCE_POLICY, logger);
+    }
+    onCallStart() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.setPersona("Harper Valley Property Insurance");
+            yield this.setTask("You are making an outbound call to a potential customer. Your task is to answer questions regarding property insurance policy until there are no more questions.");
+        });
+    }
+    onQuestion(question) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.documentQA.ask(question);
+        });
+    }
+}
+export function run(args) {
+    const [phone] = args;
+    if (!phone) {
+        console.error("Usage: guava-example property-insurance <phone>");
+        process.exit(1);
+    }
+    new guava.Client().createOutbound(process.env.GUAVA_AGENT_NUMBER, phone, (logger) => new InsuranceCallController(logger));
+}
+if (import.meta.main) {
+    run(process.argv.slice(2));
+}
+//# sourceMappingURL=property-insurance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"property-insurance.js","sourceRoot":"","sources":["../../examples/property-insurance.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAItD,OAAO,EAAC,yBAAyB,EAAC,MAAM,wBAAwB,CAAC;AAEjE,MAAM,uBAAwB,SAAQ,KAAK,CAAC,cAAc;IAExD,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAC9B,kCAAkC,EAClC,yBAAyB,EACzB,MAAM,CACP,CAAC;IACJ,CAAC;IACc,WAAW;;YACxB,MAAM,IAAI,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,OAAO,CAChB,kKAAkK,CACnK,CAAC;QACJ,CAAC;KAAA;IAEc,UAAU,CAAC,QAAgB;;YACxC,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;KAAA;CACF;AAED,MAAM,UAAU,GAAG,CAAC,IAAc;IAChC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAErB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,cAAc,CAC/B,OAAO,CAAC,GAAG,CAAC,kBAAmB,EAC/B,KAAK,EACL,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5B,CAAC"}

package/dist/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "@guava-ai/guava-sdk",
+    "version": "0.1.0",
+    "type": "module",
+    "main": "dist/src/index.js",
+    "types": "dist/src/index.d.ts",
+    "devDependencies": {
+        "@biomejs/biome": "2.3.11",
+        "@types/node": "^25.0.7",
+        "@types/ws": "^8.18.1",
+        "typescript": "^5.9.3"
+    },
+    "bin": {
+        "guava-example": "./bin/example-runner.js"
+    },
+    "dependencies": {
+        "openai": "^6.16.0",
+        "ws": "^8.19.0",
+        "zod": "^4.3.5"
+    },
+    "scripts": {
+        "typecheck": "tsc --noEmit",
+        "lint": "biome lint",
+        "format": "biome format --write ./src",
+        "format-ex": "biome format --write ./examples",
+        "check": "npm run typecheck && npm audit",
+        "clean": "rm -rf ./dist",
+        "build": "tsc",
+        "prepublishOnly": "npm run clean && npm run build"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "/src",
+        "/dist",
+        "/examples",
+        "/bin"
+    ]
+}

package/dist/src/action_item.d.ts

@@ -0,0 +1,41 @@
+import * as z from "zod";
+export declare const fieldItemType: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+export type FieldItemType = z.input<typeof fieldItemType>;
+export declare const fieldItem: z.ZodObject<{
+    item_type: z.ZodLiteral<"field">;
+    key: z.ZodString;
+    description: z.ZodString;
+    field_type: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    choices: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Field = z.input<typeof fieldItem>;
+export declare const sayItem: z.ZodObject<{
+    item_type: z.ZodLiteral<"say">;
+    statement: z.ZodString;
+    key: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type Say = z.input<typeof sayItem>;
+export declare const todoItem: z.ZodObject<{
+    item_type: z.ZodLiteral<"todo">;
+    description: z.ZodString;
+    key: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type Todo = z.input<typeof todoItem>;
+export declare const actionItem: z.ZodUnion<readonly [z.ZodObject<{
+    item_type: z.ZodLiteral<"field">;
+    key: z.ZodString;
+    description: z.ZodString;
+    field_type: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    choices: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    item_type: z.ZodLiteral<"say">;
+    statement: z.ZodString;
+    key: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    item_type: z.ZodLiteral<"todo">;
+    description: z.ZodString;
+    key: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>]>;
+export type ActionItem = z.input<typeof actionItem>;

package/dist/src/action_item.js

@@ -0,0 +1,29 @@
+import * as z from "zod";
+export const fieldItemType = z.union(["text", "date", "datetime", "integer", "multiple_choice"].map((val) => z.literal(val)));
+export const fieldItem = z
+    .object({
+    item_type: z.literal("field"),
+    key: z.string(),
+    description: z.string(),
+    field_type: fieldItemType,
+    required: z.boolean().default(true),
+    choices: z.array(z.string()),
+})
+    .refine((field) => {
+    if (field.field_type == "multiple_choice" && field.choices.length > 10) {
+        process.emitWarning("Performance degrades with large number of choices for multiple choice field.", "ACTION_ITEM");
+    }
+    return true;
+});
+export const sayItem = z.object({
+    item_type: z.literal("say"),
+    statement: z.string(),
+    key: z.string().default(() => Math.random().toString(16).substring(2, 6)),
+});
+export const todoItem = z.object({
+    item_type: z.literal("todo"),
+    description: z.string(),
+    key: z.string().default(() => Math.random().toString(16).substring(2, 6)),
+});
+export const actionItem = z.union([fieldItem, sayItem, todoItem]);
+//# sourceMappingURL=action_item.js.map

package/dist/src/action_item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action_item.js","sourceRoot":"","sources":["../../src/action_item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CACjC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAW,CAAC,GAAG,CACvE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CACxB,CACF,CAAC;AAGF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;IAChB,IAAI,KAAK,CAAC,UAAU,IAAI,iBAAiB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvE,OAAO,CAAC,WAAW,CAAC,8EAA8E,EAAE,aAAa,CAAC,CAAA;IACpH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAGL,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC1E,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC"}

package/dist/src/commands.d.ts

@@ -0,0 +1,181 @@
+import * as z from "zod";
+export declare const startOutboundCallCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"start-outbound">;
+    from_number: z.ZodOptional<z.ZodE164>;
+    to_number: z.ZodE164;
+}, z.core.$strict>;
+export type StartOutboundCallCommand = z.input<typeof startOutboundCallCommand>;
+export declare const listenInboundCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"listen-inbound">;
+    agent_number: z.ZodOptional<z.ZodE164>;
+    webrtc_code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ListenInboundCommand = z.input<typeof listenInboundCommand>;
+export declare const rejectInboundCallCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"reject-inbound">;
+}, z.core.$strict>;
+export type RejectInboundCallCommand = z.input<typeof rejectInboundCallCommand>;
+export declare const acceptInboundCallCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"accept-inbound">;
+}, z.core.$strict>;
+export type AcceptInboundCallCommand = z.input<typeof acceptInboundCallCommand>;
+export declare const setTaskCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"set-task">;
+    task_id: z.ZodString;
+    objective: z.ZodString;
+    action_items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        item_type: z.ZodLiteral<"field">;
+        key: z.ZodString;
+        description: z.ZodString;
+        field_type: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        choices: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        item_type: z.ZodLiteral<"say">;
+        statement: z.ZodString;
+        key: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        item_type: z.ZodLiteral<"todo">;
+        description: z.ZodString;
+        key: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>]>>;
+}, z.core.$strict>;
+export type SetTaskCommand = z.input<typeof setTaskCommand>;
+export declare const readScriptCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"read-script">;
+    script: z.ZodString;
+}, z.core.$strict>;
+export type ReadScriptCommand = z.input<typeof readScriptCommand>;
+export declare const answerQuestionCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"answer-question">;
+    question_id: z.ZodString;
+    answer: z.ZodString;
+}, z.core.$strict>;
+export type AnswerQuestionCommand = z.input<typeof answerQuestionCommand>;
+export declare const setPersona: z.ZodObject<{
+    command_type: z.ZodLiteral<"set-persona">;
+    agent_name: z.ZodOptional<z.ZodString>;
+    organization_name: z.ZodOptional<z.ZodString>;
+    agent_purpose: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SetPersona = z.input<typeof setPersona>;
+export declare const sendInstructionCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"send-instruction">;
+    instruction: z.ZodString;
+}, z.core.$strict>;
+export type SendInstructionCommand = z.input<typeof sendInstructionCommand>;
+export declare const transferCommand: z.ZodObject<{
+    command_type: z.ZodLiteral<"transfer-call">;
+    transfer_message: z.ZodString;
+    to_number: z.ZodString;
+}, z.core.$strict>;
+export type TransferCommand = z.input<typeof transferCommand>;
+export declare const anyCommand: z.ZodUnion<readonly [z.ZodObject<{
+    command_type: z.ZodLiteral<"start-outbound">;
+    from_number: z.ZodOptional<z.ZodE164>;
+    to_number: z.ZodE164;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"listen-inbound">;
+    agent_number: z.ZodOptional<z.ZodE164>;
+    webrtc_code: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"reject-inbound">;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"accept-inbound">;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"set-task">;
+    task_id: z.ZodString;
+    objective: z.ZodString;
+    action_items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        item_type: z.ZodLiteral<"field">;
+        key: z.ZodString;
+        description: z.ZodString;
+        field_type: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        choices: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        item_type: z.ZodLiteral<"say">;
+        statement: z.ZodString;
+        key: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        item_type: z.ZodLiteral<"todo">;
+        description: z.ZodString;
+        key: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>]>>;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"read-script">;
+    script: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"answer-question">;
+    question_id: z.ZodString;
+    answer: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"set-persona">;
+    agent_name: z.ZodOptional<z.ZodString>;
+    organization_name: z.ZodOptional<z.ZodString>;
+    agent_purpose: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"send-instruction">;
+    instruction: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    command_type: z.ZodLiteral<"transfer-call">;
+    transfer_message: z.ZodString;
+    to_number: z.ZodString;
+}, z.core.$strict>]>;
+export type Command = z.input<typeof anyCommand>;
+export declare const inboundTunnelCommand: z.ZodObject<{
+    call_id: z.ZodString;
+    command: z.ZodUnion<readonly [z.ZodObject<{
+        command_type: z.ZodLiteral<"start-outbound">;
+        from_number: z.ZodOptional<z.ZodE164>;
+        to_number: z.ZodE164;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"listen-inbound">;
+        agent_number: z.ZodOptional<z.ZodE164>;
+        webrtc_code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"reject-inbound">;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"accept-inbound">;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"set-task">;
+        task_id: z.ZodString;
+        objective: z.ZodString;
+        action_items: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            item_type: z.ZodLiteral<"field">;
+            key: z.ZodString;
+            description: z.ZodString;
+            field_type: z.ZodUnion<z.ZodLiteral<"text" | "integer" | "date" | "datetime" | "multiple_choice">[]>;
+            required: z.ZodDefault<z.ZodBoolean>;
+            choices: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            item_type: z.ZodLiteral<"say">;
+            statement: z.ZodString;
+            key: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            item_type: z.ZodLiteral<"todo">;
+            description: z.ZodString;
+            key: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"read-script">;
+        script: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"answer-question">;
+        question_id: z.ZodString;
+        answer: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"set-persona">;
+        agent_name: z.ZodOptional<z.ZodString>;
+        organization_name: z.ZodOptional<z.ZodString>;
+        agent_purpose: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"send-instruction">;
+        instruction: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        command_type: z.ZodLiteral<"transfer-call">;
+        transfer_message: z.ZodString;
+        to_number: z.ZodString;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export type InboundTunnelCommand = z.input<typeof inboundTunnelCommand>;

package/dist/src/commands.js

@@ -0,0 +1,69 @@
+import * as z from "zod";
+import { actionItem } from "./action_item.js";
+export const startOutboundCallCommand = z.strictObject({
+    command_type: z.literal("start-outbound"),
+    from_number: z.e164().optional(),
+    to_number: z.e164(),
+});
+export const listenInboundCommand = z
+    .strictObject({
+    command_type: z.literal("listen-inbound"),
+    agent_number: z.e164().optional(),
+    webrtc_code: z.string().optional(),
+})
+    .refine((obj) => {
+    !!obj.agent_number || !!obj.webrtc_code;
+});
+export const rejectInboundCallCommand = z.strictObject({
+    command_type: z.literal("reject-inbound"),
+});
+export const acceptInboundCallCommand = z.strictObject({
+    command_type: z.literal("accept-inbound"),
+});
+export const setTaskCommand = z.strictObject({
+    command_type: z.literal("set-task"),
+    task_id: z.string(),
+    objective: z.string(),
+    action_items: z.array(actionItem),
+});
+export const readScriptCommand = z.strictObject({
+    command_type: z.literal("read-script"),
+    script: z.string(),
+});
+export const answerQuestionCommand = z.strictObject({
+    command_type: z.literal("answer-question"),
+    question_id: z.string(),
+    answer: z.string(),
+});
+export const setPersona = z.strictObject({
+    command_type: z.literal("set-persona"),
+    agent_name: z.string().optional(),
+    organization_name: z.string().optional(),
+    agent_purpose: z.string().optional(),
+});
+export const sendInstructionCommand = z.strictObject({
+    command_type: z.literal("send-instruction"),
+    instruction: z.string(),
+});
+export const transferCommand = z.strictObject({
+    command_type: z.literal("transfer-call"),
+    transfer_message: z.string(),
+    to_number: z.string(),
+});
+export const anyCommand = z.union([
+    startOutboundCallCommand,
+    listenInboundCommand,
+    rejectInboundCallCommand,
+    acceptInboundCallCommand,
+    setTaskCommand,
+    readScriptCommand,
+    answerQuestionCommand,
+    setPersona,
+    sendInstructionCommand,
+    transferCommand,
+]);
+export const inboundTunnelCommand = z.strictObject({
+    call_id: z.string(),
+    command: anyCommand,
+});
+//# sourceMappingURL=commands.js.map

package/dist/src/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/src/events.d.ts

@@ -0,0 +1,170 @@
+import * as z from "zod";
+export declare const sessionStartedEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"session-started">;
+    session_id: z.ZodString;
+}, z.core.$strip>;
+export type SessionStartedEvent = z.input<typeof sessionStartedEvent>;
+export declare const inboundCallEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"inbound-call">;
+    caller_number: z.ZodOptional<z.ZodE164>;
+    agent_number: z.ZodOptional<z.ZodE164>;
+}, z.core.$strip>;
+export type InboundCallEvent = z.input<typeof inboundCallEvent>;
+/**
+ * @description The caller has said something.
+ */
+export declare const callerSpeechEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"caller-speech">;
+    utterance: z.ZodString;
+}, z.core.$strip>;
+export type CallerSpeechEvent = z.input<typeof callerSpeechEvent>;
+/**
+ * @description The agent has said something.
+ */
+export declare const agentSpeechEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"agent-speech">;
+    utterance: z.ZodString;
+    interrupted: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AgentSpeechEvent = z.input<typeof agentSpeechEvent>;
+export declare const errorEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"error">;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type ErrorEvent = z.input<typeof errorEvent>;
+export declare const warningEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"warning">;
+    content: z.ZodString;
+}, z.core.$strip>;
+export type WarningEvent = z.input<typeof warningEvent>;
+export declare const agentQuestionEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"agent-question">;
+    question_id: z.ZodString;
+    question: z.ZodString;
+}, z.core.$strip>;
+export type AgentQuestionEvent = z.input<typeof agentQuestionEvent>;
+export declare const intentEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"intent">;
+    intent_id: z.ZodString;
+    intent_summary: z.ZodString;
+}, z.core.$strip>;
+export type IntentEvent = z.input<typeof intentEvent>;
+export declare const actionItemCompletedEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"action-item-done">;
+    key: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strip>;
+export type ActionItemCompletedEvent = z.input<typeof actionItemCompletedEvent>;
+export declare const taskCompletedEvent: z.ZodObject<{
+    event_type: z.ZodLiteral<"task-done">;
+    task_id: z.ZodString;
+}, z.core.$strip>;
+export type TaskCompletedEvent = z.input<typeof taskCompletedEvent>;
+export declare const outboundCallConnected: z.ZodObject<{
+    event_type: z.ZodLiteral<"outbound-call-connected">;
+}, z.core.$strip>;
+export type OutboundCallConnected = z.input<typeof outboundCallConnected>;
+export declare const outboundCallFailed: z.ZodObject<{
+    event_type: z.ZodLiteral<"outbound-call-failed">;
+    error_code: z.ZodInt;
+    error_reason: z.ZodString;
+}, z.core.$strip>;
+export type OutboundCallFailed = z.input<typeof outboundCallFailed>;
+export declare const botSessionEnded: z.ZodObject<{
+    event_type: z.ZodLiteral<"bot-session-ended">;
+}, z.core.$strip>;
+export type BotSessionEnded = z.input<typeof botSessionEnded>;
+export declare const anyEvent: z.ZodUnion<readonly [z.ZodObject<{
+    event_type: z.ZodLiteral<"session-started">;
+    session_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"inbound-call">;
+    caller_number: z.ZodOptional<z.ZodE164>;
+    agent_number: z.ZodOptional<z.ZodE164>;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"caller-speech">;
+    utterance: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"agent-speech">;
+    utterance: z.ZodString;
+    interrupted: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"error">;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"warning">;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"agent-question">;
+    question_id: z.ZodString;
+    question: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"intent">;
+    intent_id: z.ZodString;
+    intent_summary: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"action-item-done">;
+    key: z.ZodString;
+    payload: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"task-done">;
+    task_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"outbound-call-connected">;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"outbound-call-failed">;
+    error_code: z.ZodInt;
+    error_reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    event_type: z.ZodLiteral<"bot-session-ended">;
+}, z.core.$strip>]>;
+export type GuavaEvent = z.input<typeof anyEvent>;
+export declare function decodeEvent(serialized_event: string | ArrayBuffer | Buffer | Buffer[]): GuavaEvent | null;
+export declare const inboundTunnelEvent: z.ZodObject<{
+    call_id: z.ZodString;
+    event: z.ZodUnion<readonly [z.ZodObject<{
+        event_type: z.ZodLiteral<"session-started">;
+        session_id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"inbound-call">;
+        caller_number: z.ZodOptional<z.ZodE164>;
+        agent_number: z.ZodOptional<z.ZodE164>;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"caller-speech">;
+        utterance: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"agent-speech">;
+        utterance: z.ZodString;
+        interrupted: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"error">;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"warning">;
+        content: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"agent-question">;
+        question_id: z.ZodString;
+        question: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"intent">;
+        intent_id: z.ZodString;
+        intent_summary: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"action-item-done">;
+        key: z.ZodString;
+        payload: z.ZodUnknown;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"task-done">;
+        task_id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"outbound-call-connected">;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"outbound-call-failed">;
+        error_code: z.ZodInt;
+        error_reason: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        event_type: z.ZodLiteral<"bot-session-ended">;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+export type inboundTunnelEvent = z.input<typeof inboundTunnelEvent>;