@guava-ai/guava-sdk 0.10.0 → 0.11.0

package/dist/src/agent.js

@@ -0,0 +1,444 @@
+"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 __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const ws_1 = __importDefault(require("ws"));
+const index_ts_1 = require("./index.js");
+const logging_ts_1 = require("./logging.js");
+const z = __importStar(require("zod"));
+const commands_ts_1 = require("./commands.js");
+const events_ts_1 = require("./events.js");
+const telemetry_ts_1 = require("./telemetry.js");
+/**
+ * @description convenience function for stringifying data according to a schema
+ */
+function stringifyZod(schema, data) {
+    return JSON.stringify(schema.parse(data));
+}
+let Agent = (() => {
+    let _classDecorators = [telemetry_ts_1.telemetryClient.trackClass()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var Agent = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            Agent = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        _name;
+        _organization;
+        _purpose;
+        _logger;
+        _client = new index_ts_1.Client();
+        _onCallReceived = async () => ({
+            action: "accept",
+        });
+        _onCallStart;
+        _onCallerSpeech;
+        _onAgentSpeech;
+        _onQuestion;
+        _onTaskCompleteGeneric;
+        _onTaskCompleteHandlers = {};
+        _searchQueryHandlers = {};
+        _onActionRequested;
+        _onActionGeneric;
+        _onActionHandlers = {};
+        _onSessionEnd;
+        constructor(args) {
+            this._name = args?.name;
+            this._organization = args?.organization;
+            this._purpose = args?.purpose;
+            this._logger = (0, logging_ts_1.getDefaultLogger)();
+        }
+        onCallReceived(callback) {
+            this._onCallReceived = callback;
+        }
+        onCallStart(callback) {
+            this._onCallStart = callback;
+        }
+        onCallerSpeech(callback) {
+            this._onCallerSpeech = callback;
+        }
+        onAgentSpeech(callback) {
+            this._onAgentSpeech = callback;
+        }
+        onQuestion(callback) {
+            this._onQuestion = callback;
+        }
+        onTaskComplete(callbackOrTaskName, callback) {
+            const mixErr = "Cannot mix a generic onTaskComplete handler with per-task handlers.";
+            if (typeof callbackOrTaskName === "string") {
+                if (this._onTaskCompleteGeneric !== undefined)
+                    throw new Error(mixErr);
+                this._onTaskCompleteHandlers[callbackOrTaskName] = callback;
+            }
+            else {
+                if (Object.keys(this._onTaskCompleteHandlers).length > 0)
+                    throw new Error(mixErr);
+                this._onTaskCompleteGeneric = callbackOrTaskName;
+            }
+        }
+        onSearchQuery(fieldKey, callback) {
+            this._searchQueryHandlers[fieldKey] = callback;
+        }
+        onActionRequest(callback) {
+            this._onActionRequested = callback;
+        }
+        onAction(callbackOrActionKey, callback) {
+            const mixErr = "Cannot mix a generic onAction handler with per-action handlers.";
+            if (typeof callbackOrActionKey === "string") {
+                if (this._onActionGeneric !== undefined)
+                    throw new Error(mixErr);
+                this._onActionHandlers[callbackOrActionKey] = callback;
+            }
+            else {
+                if (Object.keys(this._onActionHandlers).length > 0)
+                    throw new Error(mixErr);
+                this._onActionGeneric = callbackOrActionKey;
+            }
+        }
+        onSessionEnd(callback) {
+            this._onSessionEnd = callback;
+        }
+        onReachPerson(callback) {
+            this.onTaskComplete("reach_person", async (call) => {
+                const availability = (await call.getField("contact_availability"));
+                await callback(call, availability);
+            });
+        }
+        inboundPhone(phoneNumber) {
+            return this._listenInbound({
+                agent_number: phoneNumber,
+            });
+        }
+        async _dispatchEvent(call, event) {
+            if (event.event_type === "caller-speech") {
+                if (this._onCallerSpeech !== undefined) {
+                    await this._onCallerSpeech(call, event);
+                }
+            }
+            else if (event.event_type === "agent-speech") {
+                if (this._onAgentSpeech !== undefined) {
+                    await this._onAgentSpeech(call, event);
+                }
+            }
+            else if (event.event_type === "inbound-call") {
+                this._logger.info(`Received inbound call from ${event.caller_number ?? "unknown"}`);
+                const action = await this._onCallReceived({
+                    caller_number: event.caller_number,
+                    agent_number: event.agent_number,
+                });
+                if (action.action === "accept") {
+                    call.sendCommand(commands_ts_1.AcceptInboundCallCommand, { command_type: "accept-inbound" });
+                }
+                else {
+                    call.sendCommand(commands_ts_1.RejectInboundCallCommand, { command_type: "reject-inbound" });
+                }
+            }
+            else if (event.event_type === "task-done") {
+                this._logger.info(`Task ${event.task_id} completed.`);
+                if (this._onTaskCompleteGeneric !== undefined) {
+                    await this._onTaskCompleteGeneric(call, event.task_id);
+                }
+                else if (event.task_id in this._onTaskCompleteHandlers) {
+                    await this._onTaskCompleteHandlers[event.task_id](call);
+                }
+                else {
+                    this._logger.warn(`No handler registered for completion of task '${event.task_id}'`);
+                }
+            }
+            else if (event.event_type === "agent-question") {
+                if (this._onQuestion !== undefined) {
+                    this._logger.info(`Received question from bot: ${event.question}`);
+                    let answer;
+                    try {
+                        answer = await this._onQuestion(call, event.question);
+                    }
+                    catch (err) {
+                        this._logger.error(`Error occurred while answering question: ${err}`);
+                        answer = "An error occurred and the question could not be answered.";
+                    }
+                    call.sendCommand(commands_ts_1.AnswerQuestionCommand, {
+                        command_type: "answer-question",
+                        question_id: event.question_id,
+                        answer,
+                    });
+                }
+                else {
+                    this._logger.warn(`Received question but no onQuestion handler is registered: ${event.question}`);
+                    call.sendCommand(commands_ts_1.AnswerQuestionCommand, {
+                        command_type: "answer-question",
+                        question_id: event.question_id,
+                        answer: "I don't have an answer to that question.",
+                    });
+                }
+            }
+            else if (event.event_type === "action-item-done") {
+                this._logger.info(`Action item '${event.key}' completed.`);
+                call._fieldValues[event.key] = event.payload;
+            }
+            else if (event.event_type === "choice-query") {
+                this._logger.info(`Received search query for field '${event.field_key}': ${event.query}`);
+                const handler = this._searchQueryHandlers[event.field_key];
+                if (handler === undefined) {
+                    this._logger.warn(`Search query arrived for field '${event.field_key}' with no handler attached.`);
+                }
+                else {
+                    const [matchedChoices, otherChoices] = await handler(call, event.query);
+                    call.sendCommand(commands_ts_1.ChoiceResultCommand, {
+                        command_type: "choice-query-result",
+                        field_key: event.field_key,
+                        query_id: event.query_id,
+                        matched_choices: matchedChoices,
+                        other_choices: otherChoices,
+                    });
+                }
+            }
+            else if (event.event_type === "action-request") {
+                this._logger.info(`Received action request ${event.intent_id}: ${event.intent_summary}`);
+                let suggestion;
+                if (this._onActionRequested !== undefined) {
+                    suggestion = await this._onActionRequested(call, event.intent_summary);
+                }
+                call.sendCommand(commands_ts_1.ActionSuggestionCommand, {
+                    command_type: "action-suggestion",
+                    intent_id: event.intent_id,
+                    action_key: suggestion?.key ?? null,
+                    action_description: suggestion?.description ?? "",
+                });
+            }
+            else if (event.event_type === "execute-action") {
+                this._logger.info(`Executing action '${event.action_key}'`);
+                let onActionFunc;
+                if (this._onActionGeneric !== undefined) {
+                    onActionFunc = () => this._onActionGeneric(call, event.action_key);
+                }
+                else if (event.action_key in this._onActionHandlers) {
+                    onActionFunc = () => this._onActionHandlers[event.action_key](call);
+                }
+                if (onActionFunc !== undefined) {
+                    await onActionFunc();
+                }
+                else {
+                    this._logger.warn(`No handler registered for action '${event.action_key}'`);
+                }
+            }
+            else if (event.event_type === "bot-session-ended") {
+                this._logger.info("Session ended.");
+                if (this._onSessionEnd !== undefined) {
+                    await this._onSessionEnd(call);
+                }
+            }
+            else if (event.event_type === "error") {
+                this._logger.error(`The Guava agent reported an error: ${event.content}`);
+            }
+            else if (event.event_type === "warning") {
+                this._logger.warn(`The Guava agent reported a warning: ${event.content}`);
+            }
+        }
+        async _startCall(variables = {}) {
+            const call = new index_ts_1.Call(variables);
+            call.setPersona({
+                agentName: this._name,
+                agentPurpose: this._purpose,
+                organizationName: this._organization,
+            });
+            call.sendCommand(commands_ts_1.RegisteredHooksCommand, {
+                command_type: "registered-hooks",
+                has_on_question: this._onQuestion !== undefined,
+                has_on_intent: false,
+                has_on_action_requested: this._onActionRequested !== undefined,
+            });
+            if (this._onCallStart !== undefined) {
+                await this._onCallStart(call);
+            }
+            return call;
+        }
+        _listenInbound(conn) {
+            const calls = {};
+            // return a way to *stop* listening
+            const url = new URL("v1/listen-inbound", this._client.getWebsocketBase());
+            const ws = new ws_1.default(url, {
+                headers: this._client.headers(),
+            });
+            let agent_number;
+            let webrtc_code;
+            if ("agent_number" in conn) {
+                agent_number = conn.agent_number;
+            }
+            else {
+                webrtc_code = conn.webrtc_code;
+            }
+            this._logger.info(`Listening for calls to ${agent_number ?? webrtc_code}`);
+            if (webrtc_code) {
+                const debugurl = new URL(`debug-webrtc?webrtc_code=${webrtc_code}`, this._client.getHttpBase());
+                this._logger.debug(`WebRTC DebugURL: ${debugurl}`);
+            }
+            ws.addEventListener("open", (_ev) => {
+                ws.send(stringifyZod(commands_ts_1.ListenInboundCommand, {
+                    command_type: "listen-inbound",
+                    agent_number: agent_number,
+                    webrtc_code: webrtc_code,
+                }));
+            });
+            ws.addEventListener("close", (_ev) => {
+                ws.removeAllListeners();
+            });
+            ws.addEventListener("message", async (ev) => {
+                const tunnel_event = events_ts_1.InboundTunnelEvent.parse(JSON.parse(ev.data.toString("utf8")));
+                if (!(tunnel_event.call_id in calls)) {
+                    this._logger.info(`Received tunnel event for new call ID: ${tunnel_event.call_id}. Creating call object.`);
+                    const call = await this._startCall();
+                    await call.setDrain(async (commands) => {
+                        for (const command of commands.splice(0)) {
+                            this._logger.debug(`Sending command: ${JSON.stringify(command)} for call ID: ${tunnel_event.call_id}`);
+                            ws.send(stringifyZod(commands_ts_1.InboundTunnelCommand, {
+                                call_id: tunnel_event.call_id,
+                                command,
+                            }));
+                        }
+                    });
+                    calls[tunnel_event.call_id] = call;
+                }
+                this._dispatchEvent(calls[tunnel_event.call_id], tunnel_event.event);
+            });
+            return new InboundListener(ws);
+        }
+        /**
+         * @description use the Guava API to call out to a number
+         */
+        async outboundPhone(fromNumber, toNumber, variables = {}) {
+            const url = new URL("v1/create-outbound", this._client.getWebsocketBase());
+            const ws = new ws_1.default(url, {
+                headers: this._client.headers(),
+            });
+            const call = await this._startCall(variables);
+            let socketInitialized = false;
+            ws.addEventListener("open", async (_ev) => {
+                ws.send(stringifyZod(commands_ts_1.StartOutboundCallCommand, {
+                    command_type: "start-outbound",
+                    to_number: toNumber,
+                    from_number: fromNumber,
+                }));
+                // set the callController drain function to send all commands
+                // through the now open websocket
+                call.setDrain(async (commands) => {
+                    for (const command of commands.splice(0)) {
+                        this._logger.debug(`Sending command ${JSON.stringify(command)}`);
+                        ws.send(JSON.stringify(command));
+                    }
+                });
+            });
+            ws.addEventListener("message", (ev) => {
+                if (socketInitialized) {
+                    const session_started = z
+                        .union([events_ts_1.SessionStartedEvent, events_ts_1.ErrorEvent])
+                        .parse(JSON.parse(ev.data.toString("utf8")));
+                    if (session_started.event_type === "error") {
+                        throw new Error(`Outbound call failed: ${session_started.content}`);
+                    }
+                    else {
+                        this._logger.info(`Started session with ID: ${session_started.session_id}`);
+                        socketInitialized = true;
+                    }
+                }
+                else {
+                    // handle the received event
+                    const event = (0, events_ts_1.decodeEvent)(ev.data);
+                    if (event) {
+                        this._dispatchEvent(call, event);
+                    }
+                }
+            });
+            ws.addEventListener("close", (_ev) => {
+                // we are closing the socket, so don't trigger any other listeners
+                ws.removeAllListeners();
+            });
+        }
+    };
+    return Agent = _classThis;
+})();
+exports.Agent = Agent;
+class InboundListener {
+    ws;
+    constructor(ws) {
+        this.ws = ws;
+    }
+    close() {
+        this.ws.close();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA2B;AAC3B,yCAA0C;AAC1C,6CAA6D;AAC7D,uCAAyB;AACzB,+CAUuB;AACvB,2CAQqB;AACrB,iDAAiD;AAcjD;;GAEG;AACH,SAAS,YAAY,CAA2B,MAAc,EAAE,IAAqB;IACnF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;IAKY,KAAK;4BADjB,8BAAe,CAAC,UAAU,EAAE;;;;;;;;YAC7B,6KA2XC;;;YA3XY,uDAAK;;QACR,KAAK,CAAU;QACf,aAAa,CAAU;QACvB,QAAQ,CAAU;QAClB,OAAO,CAAS;QAEhB,OAAO,GAAW,IAAI,iBAAM,EAAE,CAAC;QAE/B,eAAe,GAAwD,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1F,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACK,YAAY,CAAiC;QAC7C,eAAe,CAA2D;QAC1E,cAAc,CAA0D;QACxE,WAAW,CAAqD;QAChE,sBAAsB,CAAiD;QACvE,uBAAuB,GAAkD,EAAE,CAAC;QAC5E,oBAAoB,GAGxB,EAAE,CAAC;QACC,kBAAkB,CAGgB;QAClC,gBAAgB,CAAoD;QACpE,iBAAiB,GAAkD,EAAE,CAAC;QACtE,aAAa,CAAiC;QAEtD,YAAY,IAAiE;YAC3E,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,IAAI,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,YAAY,CAAC;YACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,OAAO,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,IAAA,6BAAgB,GAAE,CAAC;QACpC,CAAC;QAED,cAAc,CAAC,QAA6D;YAC1E,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAClC,CAAC;QAED,WAAW,CAAC,QAAuC;YACjD,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC/B,CAAC;QAED,cAAc,CAAC,QAAiE;YAC9E,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;QAClC,CAAC;QAED,aAAa,CAAC,QAAgE;YAC5E,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QACjC,CAAC;QAED,UAAU,CAAC,QAA2D;YACpE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;QAC9B,CAAC;QAID,cAAc,CACZ,kBAA4E,EAC5E,QAAwC;YAExC,MAAM,MAAM,GAAG,qEAAqE,CAAC;YACrF,IAAI,OAAO,kBAAkB,KAAK,QAAQ,EAAE,CAAC;gBAC3C,IAAI,IAAI,CAAC,sBAAsB,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBACvE,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,GAAG,QAAS,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClF,IAAI,CAAC,sBAAsB,GAAG,kBAAkB,CAAC;YACnD,CAAC;QACH,CAAC;QAED,aAAa,CACX,QAAgB,EAChB,QAAsE;YAEtE,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACjD,CAAC;QAED,eAAe,CACb,QAAqF;YAErF,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACrC,CAAC;QAID,QAAQ,CACN,mBAAgF,EAChF,QAAwC;YAExC,MAAM,MAAM,GAAG,iEAAiE,CAAC;YACjF,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjE,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,QAAS,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC5E,IAAI,CAAC,gBAAgB,GAAG,mBAAmB,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,YAAY,CAAC,QAAuC;YAClD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAChC,CAAC;QAED,aAAa,CAAC,QAA6D;YACzE,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACjD,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAW,CAAC;gBAC7E,MAAM,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,YAAY,CAAC,WAAmB;YAC9B,OAAO,IAAI,CAAC,cAAc,CAAC;gBACzB,YAAY,EAAE,WAAW;aAC1B,CAAC,CAAC;QACL,CAAC;QAEO,KAAK,CAAC,cAAc,CAAC,IAAU,EAAE,KAAiB;YACxD,IAAI,KAAK,CAAC,UAAU,KAAK,eAAe,EAAE,CAAC;gBACzC,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBACvC,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;gBAC/C,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;oBACtC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,KAAK,CAAC,aAAa,IAAI,SAAS,EAAE,CAAC,CAAC;gBACpF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC;oBACxC,aAAa,EAAE,KAAK,CAAC,aAAa;oBAClC,YAAY,EAAE,KAAK,CAAC,YAAY;iBACjC,CAAC,CAAC;gBACH,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,IAAI,CAAC,WAAW,CAAC,sCAAwB,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACjF,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,WAAW,CAAC,sCAAwB,EAAE,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;gBACtD,IAAI,IAAI,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;oBAC9C,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACzD,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;oBACzD,MAAM,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC1D,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iDAAiD,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;gBACjD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACnE,IAAI,MAAc,CAAC;oBACnB,IAAI,CAAC;wBACH,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACxD,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,4CAA4C,GAAG,EAAE,CAAC,CAAC;wBACtE,MAAM,GAAG,2DAA2D,CAAC;oBACvE,CAAC;oBACD,IAAI,CAAC,WAAW,CAAC,mCAAqB,EAAE;wBACtC,YAAY,EAAE,iBAAiB;wBAC/B,WAAW,EAAE,KAAK,CAAC,WAAW;wBAC9B,MAAM;qBACP,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,8DAA8D,KAAK,CAAC,QAAQ,EAAE,CAC/E,CAAC;oBACF,IAAI,CAAC,WAAW,CAAC,mCAAqB,EAAE;wBACtC,YAAY,EAAE,iBAAiB;wBAC/B,WAAW,EAAE,KAAK,CAAC,WAAW;wBAC9B,MAAM,EAAE,0CAA0C;qBACnD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,kBAAkB,EAAE,CAAC;gBACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC;gBAC3D,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YAC/C,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oCAAoC,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC3D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,mCAAmC,KAAK,CAAC,SAAS,6BAA6B,CAChF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBACxE,IAAI,CAAC,WAAW,CAAC,iCAAmB,EAAE;wBACpC,YAAY,EAAE,qBAAqB;wBACnC,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,eAAe,EAAE,cAAc;wBAC/B,aAAa,EAAE,YAAY;qBAC5B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;gBACzF,IAAI,UAAuC,CAAC;gBAC5C,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;oBAC1C,UAAU,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;gBACzE,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,qCAAuB,EAAE;oBACxC,YAAY,EAAE,mBAAmB;oBACjC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,IAAI;oBACnC,kBAAkB,EAAE,UAAU,EAAE,WAAW,IAAI,EAAE;iBAClD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC5D,IAAI,YAA+C,CAAC;gBACpD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;oBACxC,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBACtE,CAAC;qBAAM,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACtD,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;gBACtE,CAAC;gBACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,MAAM,YAAY,EAAE,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qCAAqC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;gBACpD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBACpC,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uCAAuC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,YAAiC,EAAE;YAClD,MAAM,IAAI,GAAG,IAAI,eAAI,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC;gBACd,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,YAAY,EAAE,IAAI,CAAC,QAAQ;gBAC3B,gBAAgB,EAAE,IAAI,CAAC,aAAa;aACrC,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,oCAAsB,EAAE;gBACvC,YAAY,EAAE,kBAAkB;gBAChC,eAAe,EAAE,IAAI,CAAC,WAAW,KAAK,SAAS;gBAC/C,aAAa,EAAE,KAAK;gBACpB,uBAAuB,EAAE,IAAI,CAAC,kBAAkB,KAAK,SAAS;aAC/D,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,cAAc,CAAC,IAAuB;YACpC,MAAM,KAAK,GAAyB,EAAE,CAAC;YAEvC,mCAAmC;YACnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC1E,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,GAAG,EAAE;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;aAChC,CAAC,CAAC;YACH,IAAI,YAAgC,CAAC;YACrC,IAAI,WAA+B,CAAC;YACpC,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;gBAC3B,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACjC,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,YAAY,IAAI,WAAW,EAAE,CAAC,CAAC;YAE3E,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,4BAA4B,WAAW,EAAE,EACzC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAC3B,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBAClC,EAAE,CAAC,IAAI,CACL,YAAY,CAAC,kCAAoB,EAAE;oBACjC,YAAY,EAAE,gBAAgB;oBAC9B,YAAY,EAAE,YAAY;oBAC1B,WAAW,EAAE,WAAW;iBACzB,CAAC,CACH,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,EAAE,CAAC,kBAAkB,EAAE,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;gBAC1C,MAAM,YAAY,GAAG,8BAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpF,IAAI,CAAC,CAAC,YAAY,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;oBACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,0CAA0C,YAAY,CAAC,OAAO,yBAAyB,CACxF,CAAC;oBAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;oBACrC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;wBACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;4BACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,oBAAoB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,YAAY,CAAC,OAAO,EAAE,CACnF,CAAC;4BACF,EAAE,CAAC,IAAI,CACL,YAAY,CAAC,kCAAoB,EAAE;gCACjC,OAAO,EAAE,YAAY,CAAC,OAAO;gCAC7B,OAAO;6BACR,CAAC,CACH,CAAC;wBACJ,CAAC;oBACH,CAAC,CAAC,CAAC;oBACH,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;gBACrC,CAAC;gBAED,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;YAEH,OAAO,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QAED;;WAEG;QACH,KAAK,CAAC,aAAa,CACjB,UAA8B,EAC9B,QAAgB,EAChB,YAAiC,EAAE;YAEnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC3E,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,GAAG,EAAE;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;aAChC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9C,IAAI,iBAAiB,GAAG,KAAK,CAAC;YAE9B,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACxC,EAAE,CAAC,IAAI,CACL,YAAY,CAAC,sCAAwB,EAAE;oBACrC,YAAY,EAAE,gBAAgB;oBAC9B,SAAS,EAAE,QAAQ;oBACnB,WAAW,EAAE,UAAU;iBACxB,CAAC,CACH,CAAC;gBAEF,6DAA6D;gBAC7D,iCAAiC;gBACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;oBAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACjE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE;gBACpC,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,eAAe,GAAG,CAAC;yBACtB,KAAK,CAAC,CAAC,+BAAmB,EAAE,sBAAU,CAAC,CAAC;yBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBAE/C,IAAI,eAAe,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;wBAC3C,MAAM,IAAI,KAAK,CAAC,yBAAyB,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;oBACtE,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC;wBAC5E,iBAAiB,GAAG,IAAI,CAAC;oBAC3B,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,4BAA4B;oBAC5B,MAAM,KAAK,GAAG,IAAA,uBAAW,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC;oBACnC,IAAI,KAAK,EAAE,CAAC;wBACV,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,kEAAkE;gBAClE,EAAE,CAAC,kBAAkB,EAAE,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC;;;;AA1XU,sBAAK;AA6XlB,MAAM,eAAe;IACX,EAAE,CAAY;IACtB,YAAY,EAAa;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/src/call-controller.d.ts

@@ -1,7 +1,7 @@
 import { type Logger } from "./logging.ts";
 import { type Command } from "./commands.ts";
 import type { GuavaEvent, CallerSpeechEvent, AgentSpeechEvent } from "./events.ts";
-import { type FieldItem, type SayItem } from "./action_item.ts";
+import { type FieldItem, type SayItem } from "./action-item.ts";
 export type TaskObjective = {
     objective: string;
 } | {

package/dist/src/call-controller.js

@@ -37,7 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CallController = void 0;
 const logging_ts_1 = require("./logging.js");
 const commands_ts_1 = require("./commands.js");
-const action_item_ts_1 = require("./action_item.js");
+const action_item_ts_1 = require("./action-item.js");
 const telemetry_ts_1 = require("./telemetry.js");
 /**
  * Interface between Guava services and user-supplied code

package/dist/src/call.d.ts

@@ -0,0 +1,73 @@
+import { type Logger } from "./logging.ts";
+import { type Command, type Language } from "./commands.ts";
+import type * as z from "zod";
+import type { FieldItem, SayItem } from "./action-item.ts";
+export type TaskObjective = {
+    objective: string;
+} | {
+    objective?: string;
+    checklist: (FieldItem | SayItem | string)[];
+};
+export type ReachPersonOutcome = {
+    key: string;
+    description?: string;
+    nextActionPreview?: string;
+};
+export declare class Call {
+    private _commandQueue;
+    private _variables;
+    protected logger: Logger;
+    private _drain?;
+    _fieldValues: Record<string, unknown>;
+    constructor(variables?: Record<string, any>, logger?: Logger);
+    /**
+     * @description Supply a function used to consume commands from the internal command queue.
+     *
+     * The function is expected to remove from the argument array commands that it has handled (iterating
+     * through the result of `Array.splice(0)` is sufficient)
+     */
+    setDrain(newDrain: (_: Command[]) => Promise<void>): Promise<void>;
+    private flush;
+    getField(key: string): Promise<unknown>;
+    sendCommand<C extends Command, Schema extends z.ZodType<C>>(schema: Schema, data: z.input<Schema>): Promise<void>;
+    setLanguageMode(args: {
+        primary?: Language;
+        secondary?: Language[];
+    }): Promise<void>;
+    /**
+     * @description provide identifiers the agent will use to identify the virtual agent
+     */
+    setPersona(args: {
+        organizationName?: string;
+        agentName?: string;
+        agentPurpose?: string;
+        voice?: string;
+    }): Promise<void>;
+    /**
+     * @description direct the agent to collect information
+     * @param taskArgs.task_id unique identifier for this task
+     * @param taskArgs.objective high-level goal for the agent
+     * @param taskArgs.checklist ordered list of fields, statements, or instructions to collect
+     */
+    setTask(taskArgs: {
+        taskId: string;
+        objective?: string;
+        checklist?: (FieldItem | SayItem | string)[];
+        completionCriteria?: string;
+    }): Promise<void>;
+    transfer(destination: string, instructions?: string): Promise<void>;
+    addInfo(label: string, info: unknown): Promise<void>;
+    retryTask(reason: string): Promise<void>;
+    readScript(script: string): Promise<void>;
+    sendInstruction(instruction: string): Promise<void>;
+    /**
+     * @description hang up an accepted call
+     */
+    hangup(final_instructions?: string): Promise<void>;
+    reachPerson(contactFullName: string, options?: {
+        outcomes?: ReachPersonOutcome[];
+        greeting?: string;
+    }): Promise<void>;
+    setVariable(variableName: string, variableValue: any): Promise<void>;
+    getVariable(variableName: string): Promise<any>;
+}