@guava-ai/guava-sdk 0.9.0 → 0.11.0

package/README.md

@@ -1,5 +1,5 @@
 # Guava Typescript SDK
-![NPM Version](https://img.shields.io/npm/v/%40guava-ai%2Fguava-sdk)
+[![NPM Version](https://img.shields.io/npm/v/%40guava-ai%2Fguava-sdk)](https://www.npmjs.com/package/@guava-ai/guava-sdk)
 
 This library allows you to build Guava voice agents using TypeScript or Javascript. Currently only NodeJS is officially supported as a runtime.
 

package/bin/example-runner.ts

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import * as schedulingOutbound from "../examples/scheduling-outbound";
 import * as propertyInsurance from "../examples/property-insurance";
-import * as creditCardActivation from "../examples/credit-card-activation";
-import * as thaiPalace from "../examples/thai-palace";
+import * as restaurantWaitlist from "../examples/restaurant-waitlist";
+import * as helpDesk from "../examples/help-desk";
 
 const EXAMPLES = {
   "scheduling-outbound": schedulingOutbound,
   "property-insurance": propertyInsurance,
-  "credit-card-activation": creditCardActivation,
-  "thai-palace": thaiPalace,
+  "restaurant-waitlist": restaurantWaitlist,
+  "help-desk": helpDesk,
 };
 
 const exampleName = process.argv[2];

package/dist/bin/example-runner.js

@@ -36,13 +36,13 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const schedulingOutbound = __importStar(require("../examples/scheduling-outbound"));
 const propertyInsurance = __importStar(require("../examples/property-insurance"));
-const creditCardActivation = __importStar(require("../examples/credit-card-activation"));
-const thaiPalace = __importStar(require("../examples/thai-palace"));
+const restaurantWaitlist = __importStar(require("../examples/restaurant-waitlist"));
+const helpDesk = __importStar(require("../examples/help-desk"));
 const EXAMPLES = {
     "scheduling-outbound": schedulingOutbound,
     "property-insurance": propertyInsurance,
-    "credit-card-activation": creditCardActivation,
-    "thai-palace": thaiPalace,
+    "restaurant-waitlist": restaurantWaitlist,
+    "help-desk": helpDesk,
 };
 const exampleName = process.argv[2];
 if (!exampleName) {

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

@@ -1 +1 @@
-{"version":3,"file":"example-runner.js","sourceRoot":"","sources":["../../bin/example-runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oFAAsE;AACtE,kFAAoE;AACpE,yFAA2E;AAC3E,oEAAsD;AAEtD,MAAM,QAAQ,GAAG;IACf,qBAAqB,EAAE,kBAAkB;IACzC,oBAAoB,EAAE,iBAAiB;IACvC,wBAAwB,EAAE,oBAAoB;IAC9C,aAAa,EAAE,UAAU;CAC1B,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,CAAA;IACtE,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,QAAQ,CAAC,WAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"example-runner.js","sourceRoot":"","sources":["../../bin/example-runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oFAAsE;AACtE,kFAAoE;AACpE,oFAAsE;AACtE,gEAAkD;AAElD,MAAM,QAAQ,GAAG;IACf,qBAAqB,EAAE,kBAAkB;IACzC,oBAAoB,EAAE,iBAAiB;IACvC,qBAAqB,EAAE,kBAAkB;IACzC,WAAW,EAAE,QAAQ;CACtB,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,CAAA;IACtE,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,QAAQ,CAAC,WAAoC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,EAAE,CAAC"}

package/dist/examples/help-desk.js

@@ -0,0 +1,71 @@
+"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 openai_1 = require("@guava-ai/guava-sdk/helpers/openai");
+const example_data_1 = require("@guava-ai/guava-sdk/example-data");
+const guava_sdk_1 = require("@guava-ai/guava-sdk");
+const 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);
+agent.onQuestion(async (_call, question) => {
+    return await documentQA.ask(question);
+});
+agent.onActionRequest(async (_call, request) => {
+    const key = await intentRecognizer.classify(request);
+    return { key };
+});
+agent.onAction("sales", async (call) => {
+    call.transfer("+15555555555", "Notify the caller that you will be transferring them to the Sales department.");
+});
+agent.onAction("delivery-and-returns", async (call) => {
+    call.transfer("+15555555555", "Notify the caller that you will be transferring them to the Delivery and Returns department.");
+});
+agent.onAction("account-management", async (call) => {
+    call.transfer("+15555555555", "Notify the caller that you will be transferring them to the Account Management department.");
+});
+agent.onAction("other", async (call) => {
+    call.transfer("+15555555555", "Notify the caller that you will be connecting them with a service representative.");
+});
+async function run(_args) {
+    agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER);
+}
+//# sourceMappingURL=help-desk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help-desk.js","sourceRoot":"","sources":["../../examples/help-desk.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,kBAEC;AA3DD,2DAA6C;AAC7C,+DAAkF;AAClF,mEAAyE;AACzE,mDAAuD;AAEvD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,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,KAAK,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,KAAK,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,KAAK,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,KAAK,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,KAAK,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,KAAK,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,KAAe;IACvC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;AACtD,CAAC"}

package/dist/examples/property-insurance.js

@@ -37,28 +37,20 @@ exports.run = run;
 const guava = __importStar(require("@guava-ai/guava-sdk"));
 const openai_1 = require("@guava-ai/guava-sdk/helpers/openai");
 const example_data_1 = require("@guava-ai/guava-sdk/example-data");
-class InsuranceCallController extends guava.CallController {
-    documentQA;
-    constructor() {
-        super();
-        this.documentQA = new openai_1.DocumentQA("harper-valley-property-insurance", example_data_1.PROPERTY_INSURANCE_POLICY);
-        this.setPersona({
-            organizationName: "Harper Valley Property Insurance",
-        });
-        this.setTask({
-            objective: "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.",
-        });
-    }
-    async onQuestion(question) {
-        return await this.documentQA.ask(question);
-    }
-}
+const agent = new guava.Agent({
+    organization: "Harper Valley Property Insurance",
+    purpose: "Answer questions regarding property insurance policy until there are no more questions",
+});
+// 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);
+// 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.
+    // You can plug in any knowledge base system you want here.
+    return await documentQA.ask(question);
+});
 async 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, new InsuranceCallController());
+    agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER);
 }
 //# sourceMappingURL=property-insurance.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"property-insurance.js","sourceRoot":"","sources":["../../examples/property-insurance.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,kBAaC;AAtCD,2DAA6C;AAC7C,+DAAgE;AAChE,mEAA6E;AAE7E,MAAM,uBAAwB,SAAQ,KAAK,CAAC,cAAc;IAChD,UAAU,CAAa;IAC/B;QACE,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,UAAU,GAAG,IAAI,mBAAU,CAAC,kCAAkC,EAAE,wCAAyB,CAAC,CAAC;QAEhG,IAAI,CAAC,UAAU,CAAC;YACd,gBAAgB,EAAE,kCAAkC;SACrD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC;YACX,SAAS,EACP,kKAAkK;SACrK,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,UAAU,CAAC,QAAgB;QACxC,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF;AAEM,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,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,IAAI,uBAAuB,EAAE,CAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"property-insurance.js","sourceRoot":"","sources":["../../examples/property-insurance.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,kBAEC;AAtBD,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,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;AACtD,CAAC"}

package/dist/examples/restaurant-waitlist.js

@@ -0,0 +1,74 @@
+"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 guava_sdk_1 = require("@guava-ai/guava-sdk");
+const logger = (0, guava_sdk_1.getDefaultLogger)();
+const agent = new guava.Agent({
+    name: "Mia",
+    organization: "Thai Palace",
+    purpose: "Helping callers join the restaurant waitlist",
+});
+agent.onCallReceived(async (_callInfo) => {
+    // In this callback you have the option to accept or reject a call based off the caller info.
+    // For now we will accept all calls. If this callback is not provided, the default behavior is
+    // to accept all calls.
+    return { action: "accept" };
+});
+agent.onCallStart(async (call) => {
+    await call.setTask({
+        taskId: "waitlist",
+        objective: "You are a virtual assistant for Thai Palace. Add callers to the waitlist.",
+        checklist: [
+            guava.Field({ key: "caller_name", fieldType: "text", description: "Name for the waitlist" }),
+            guava.Field({ key: "party_size", fieldType: "integer", description: "Number of people" }),
+            guava.Field({
+                key: "phone_number",
+                fieldType: "text",
+                description: "Phone number to text when the table is ready",
+            }),
+            "Read the phone number back to the caller to confirm.",
+        ],
+    });
+});
+agent.onTaskComplete("waitlist", async (call) => {
+    logger.info("Added %s, party of %d, to waitlist.", await call.getField("caller_name"), await call.getField("party_size"));
+    await call.hangup("Thank the caller and let them know we'll text when their table is ready.");
+});
+async function run(_args) {
+    agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER);
+}
+//# sourceMappingURL=restaurant-waitlist.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restaurant-waitlist.js","sourceRoot":"","sources":["../../examples/restaurant-waitlist.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,kBAEC;AA9CD,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,KAAe;IACvC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAmB,CAAC,CAAC;AACtD,CAAC"}

package/dist/examples/scheduling-outbound.js

@@ -37,74 +37,50 @@ exports.run = run;
 const guava = __importStar(require("@guava-ai/guava-sdk"));
 const openai_1 = require("@guava-ai/guava-sdk/helpers/openai");
 const example_data_1 = require("@guava-ai/guava-sdk/example-data");
-class SchedulingController extends guava.CallController {
-    patientName;
-    datetimeFilter;
-    constructor(patientName) {
-        super();
-        this.patientName = patientName;
-        // This is a basic appointment time selector that pulls from a mock list of appointments.
-        // In production, you would likely replace this with your own agentic scheduling backend.
-        this.datetimeFilter = new openai_1.DatetimeFilter({
-            sourceList: (0, example_data_1.mockAppointmentsForFuture)(),
-        });
-        // Use setPersona to set basic information about the agent, as well as its high-level purpose.
-        this.setPersona({
-            organizationName: "Bright Smile Dental",
-            agentName: "Grace",
-            agentPurpose: `You are calling ${patientName} to help them schedule a dental appointment`,
-        });
-        // reachPerson is a convenience function to confirm that we are talking to the intended recipient.
-        this.reachPerson(this.patientName, {
-            onSuccess: () => this.scheduleRecipient(),
-            onFailure: () => this.recipientUnavailable(),
-        });
-    }
-    scheduleRecipient() {
-        // We have now confirmed that we are talking to the patient.
-        // Set the Agent's current task to collect the desired appointment time.
-        this.setTask({
-            // The check list is an ordered list of items for the agent to go through.
-            // It can include short prompts as well as Fields to capture structured information.
+const agent = new guava.Agent({
+    organization: "Bright Smile Dental",
+    purpose: "You are calling patients to help them schedule a dental appointment",
+});
+const datetimeFilter = new openai_1.DatetimeFilter({
+    sourceList: (0, example_data_1.mockAppointmentsForFuture)(),
+});
+agent.onCallStart(async (call) => {
+    await call.reachPerson(await call.getVariable("patientName"));
+});
+agent.onSearchQuery("appointment_time", async (_call, query) => {
+    return datetimeFilter.filter(query, { maxResults: 3 });
+});
+agent.onReachPerson(async (call, outcome) => {
+    if (outcome === "available") {
+        await call.setTask({
+            taskId: "schedule_appointment",
             checklist: [
-                "tell them that it's been a while since their regular cleaning with Dr. Teeth, and ask if they would like to schedule an appointment now.",
-                // We have one field to collect, which is the appointment_time.
+                "Tell them that it's been a while since their regular cleaning with Dr. Teeth.",
                 guava.Field({
                     key: "appointment_time",
                     fieldType: "calendar_slot",
                     description: "Find a time that works for the caller",
-                    // The choiceGenerator will be called when negotiating a calendar slot.
-                    // We respond with a list of datetime options based on the user's
-                    // criteria, which is summarized in the query string.
-                    choiceGenerator: async (query) => {
-                        // Query will have some natural language preferences like "early morning" or
-                        // "next week". The dateTime filter queries our calendar for matching slots.
-                        const result = await this.datetimeFilter.filter(query, { maxResults: 3 });
-                        this.logger.info("Appointment slot matches: %s", JSON.stringify(result));
-                        return result;
-                    },
+                    searchable: true,
                 }),
-                "tell them their appointment has been confirmed and answer any questions before ending the call.",
+                "Tell them their appointment has been confirmed and answer any questions before ending the call.",
             ],
-        }, () => this.hangup("Thank them for their time and hang up the call."));
-    }
-    recipientUnavailable() {
-        this.hangup("Apologize for your mistake and hang up the call.");
+        });
     }
-    onSessionDone() {
-        // This callback is invoked at the end of the bot session.
-        const selectedTime = this.getField("appointment_time");
-        if (selectedTime) {
-            this.logger.info(`Appointment confirmed for: ${selectedTime}`);
-        }
+    else {
+        await call.hangup("Apologize for your mistake and hang up the call.");
     }
-}
+});
+agent.onTaskComplete("schedule_appointment", async (call) => {
+    await call.hangup("Thank them for their time and hang up the call.");
+});
 async function run(args) {
     const [toNumber, patientName = "Benjamin Buttons"] = args;
     if (!toNumber) {
         console.error("Usage: guava-example scheduling-outbound <phone> [name]");
         process.exit(1);
     }
-    new guava.Client().createOutbound(process.env.GUAVA_AGENT_NUMBER, toNumber, new SchedulingController(patientName));
+    agent.outboundPhone(process.env.GUAVA_AGENT_NUMBER, toNumber, {
+        patientName: patientName,
+    });
 }
 //# sourceMappingURL=scheduling-outbound.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"scheduling-outbound.js","sourceRoot":"","sources":["../../examples/scheduling-outbound.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,kBAaC;AA5FD,2DAA6C;AAC7C,+DAAoE;AACpE,mEAA6E;AAE7E,MAAM,oBAAqB,SAAQ,KAAK,CAAC,cAAc;IACpC,WAAW,CAAS;IACpB,cAAc,CAAiB;IAEhD,YAAY,WAAmB;QAC7B,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,yFAAyF;QACzF,yFAAyF;QACzF,IAAI,CAAC,cAAc,GAAG,IAAI,uBAAc,CAAC;YACvC,UAAU,EAAE,IAAA,wCAAyB,GAAE;SACxC,CAAC,CAAC;QAEH,8FAA8F;QAC9F,IAAI,CAAC,UAAU,CAAC;YACd,gBAAgB,EAAE,qBAAqB;YACvC,SAAS,EAAE,OAAO;YAClB,YAAY,EAAE,mBAAmB,WAAW,6CAA6C;SAC1F,CAAC,CAAC;QAEH,kGAAkG;QAClG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE;YACjC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,EAAE;YACzC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE;SAC7C,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB;QACvB,4DAA4D;QAC5D,wEAAwE;QACxE,IAAI,CAAC,OAAO,CACV;YACE,0EAA0E;YAC1E,oFAAoF;YACpF,SAAS,EAAE;gBACT,0IAA0I;gBAC1I,+DAA+D;gBAC/D,KAAK,CAAC,KAAK,CAAC;oBACV,GAAG,EAAE,kBAAkB;oBACvB,SAAS,EAAE,eAAe;oBAC1B,WAAW,EAAE,uCAAuC;oBAEpD,uEAAuE;oBACvE,iEAAiE;oBACjE,qDAAqD;oBACrD,eAAe,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE;wBACvC,4EAA4E;wBAC5E,4EAA4E;wBAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;wBAC1E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;wBACzE,OAAO,MAAM,CAAC;oBAChB,CAAC;iBACF,CAAC;gBACF,iGAAiG;aAClG;SACF,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,iDAAiD,CAAC,CACrE,CAAC;IACJ,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IAEQ,aAAa;QACpB,0DAA0D;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF;AAEM,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,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,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,cAAc,CAC/B,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAC9B,QAAQ,EACR,IAAI,oBAAoB,CAAC,WAAW,CAAC,CACtC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"scheduling-outbound.js","sourceRoot":"","sources":["../../examples/scheduling-outbound.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,kBAWC;AAxDD,2DAA6C;AAC7C,+DAAoE;AACpE,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,uBAAc,CAAC;IACxC,UAAU,EAAE,IAAA,wCAAyB,GAAE;CACxC,CAAC,CAAC;AAEH,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,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,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,EAAE;QAC5D,WAAW,EAAE,WAAW;KACzB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/{action_item.d.ts → action-item.d.ts}

@@ -10,6 +10,7 @@ export declare const FieldItem: z.ZodObject<{
     required: z.ZodDefault<z.ZodBoolean>;
     choices: z.ZodDefault<z.ZodArray<z.ZodString>>;
     choiceGenerator: z.ZodOptional<z.ZodCustom<ChoiceGenerator, ChoiceGenerator>>;
+    searchable: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type FieldItem = z.input<typeof FieldItem>;
 export declare const SerializableFieldItem: z.ZodObject<{
@@ -59,5 +60,6 @@ export declare function Field(options: {
     required?: boolean;
     choices?: string[];
     choiceGenerator?: ChoiceGenerator;
+    searchable?: boolean;
 }): FieldItem;
 export declare function Say(statement: string): SayItem;

package/dist/src/{action_item.js → action-item.js}

@@ -47,6 +47,7 @@ exports.FieldItem = z
     required: z.boolean().default(true),
     choices: z.array(z.string()).default([]),
     choiceGenerator: z.custom((val) => typeof val === "function").optional(),
+    searchable: z.boolean().default(false),
 })
     .refine((field) => {
     if (field.field_type === "multiple_choice" && field.choices.length > 10) {
@@ -83,6 +84,7 @@ function Field(options) {
         required: options.required,
         choices: options.choices,
         choiceGenerator: options.choiceGenerator,
+        searchable: options.searchable,
     });
 }
 function Say(statement) {
@@ -91,4 +93,4 @@ function Say(statement) {
         statement: statement,
     });
 }
-//# sourceMappingURL=action_item.js.map
+//# 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":"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"}

package/dist/src/agent.d.ts

@@ -0,0 +1,72 @@
+import WebSocket from "ws";
+import { Call } from "./index.ts";
+import { type CallerSpeechEvent, type AgentSpeechEvent } from "./events.ts";
+export interface CallInfo {
+    caller_number?: string;
+    agent_number?: string;
+}
+export type IncomingCallAction = {
+    action: "accept";
+} | {
+    action: "decline";
+};
+export interface SuggestedAction {
+    key: string;
+    description?: string;
+}
+export type InboundConnection = {
+    agent_number: string;
+} | {
+    webrtc_code: string;
+};
+export declare class Agent {
+    private _name?;
+    private _organization?;
+    private _purpose?;
+    private _logger;
+    private _client;
+    private _onCallReceived;
+    private _onCallStart?;
+    private _onCallerSpeech?;
+    private _onAgentSpeech?;
+    private _onQuestion?;
+    private _onTaskCompleteGeneric?;
+    private _onTaskCompleteHandlers;
+    private _searchQueryHandlers;
+    private _onActionRequested?;
+    private _onActionGeneric?;
+    private _onActionHandlers;
+    private _onSessionEnd?;
+    constructor(args?: {
+        name?: string;
+        organization?: string;
+        purpose?: string;
+    });
+    onCallReceived(callback: (callInfo: CallInfo) => Promise<IncomingCallAction>): void;
+    onCallStart(callback: (call: Call) => Promise<void>): void;
+    onCallerSpeech(callback: (call: Call, event: CallerSpeechEvent) => Promise<void>): void;
+    onAgentSpeech(callback: (call: Call, event: AgentSpeechEvent) => Promise<void>): void;
+    onQuestion(callback: (call: Call, question: string) => Promise<string>): void;
+    onTaskComplete(callback: (call: Call, taskId: string) => Promise<void>): void;
+    onTaskComplete(taskName: string, callback: (call: Call) => Promise<void>): void;
+    onSearchQuery(fieldKey: string, callback: (call: Call, query: string) => Promise<[string[], string[]]>): void;
+    onActionRequest(callback: (call: Call, intentSummary: string) => Promise<SuggestedAction | undefined>): void;
+    onAction(callback: (call: Call, actionKey: string) => Promise<void>): void;
+    onAction(actionKey: string, callback: (call: Call) => Promise<void>): void;
+    onSessionEnd(callback: (call: Call) => Promise<void>): void;
+    onReachPerson(callback: (call: Call, availability: string) => Promise<void>): void;
+    inboundPhone(phoneNumber: string): InboundListener;
+    private _dispatchEvent;
+    _startCall(variables?: Record<string, any>): Promise<Call>;
+    _listenInbound(conn: InboundConnection): InboundListener;
+    /**
+     * @description use the Guava API to call out to a number
+     */
+    outboundPhone(fromNumber: string | undefined, toNumber: string, variables?: Record<string, any>): Promise<void>;
+}
+declare class InboundListener {
+    private ws;
+    constructor(ws: WebSocket);
+    close(): void;
+}
+export {};