@guava-ai/guava-sdk 0.12.0 → 0.13.0

package/dist/src/index.d.ts

@@ -1,49 +1,6 @@
-import WebSocket from "ws";
-import { type Logger } from "./logging.ts";
-import type { CallController } from "./call-controller.ts";
+export { Client, type InboundConnection } from "./client.ts";
 export { CallController, type TaskObjective } from "./call-controller.ts";
 export { Say, Field } from "./action-item.ts";
 export { Logger, getConsoleLogger, getDefaultLogger } from "./logging.ts";
 export { Agent, CallInfo } from "./agent.ts";
 export { Call } from "./call.ts";
-export type InboundConnection = {
-    agent_number: string;
-} | {
-    webrtc_code: string;
-};
-export declare class Client {
-    private _apiKey;
-    private _baseUrl;
-    private _logger;
-    private _ws?;
-    private _controller?;
-    private messageHandler?;
-    constructor(apiKey?: string, baseUrl?: string, logger?: Logger, captureWarnings?: boolean);
-    getWebsocketBase(): string;
-    getHttpBase(): string;
-    headers(): {
-        Authorization: string;
-        "x-guava-platform": NodeJS.Platform;
-        "x-guava-runtime": string;
-        "x-guava-runtime-version": string;
-        "x-guava-sdk": string;
-        "x-guava-sdk-version": string;
-    };
-    private _checkSdkDeprecation;
-    /**
-     * @description use the Guava API to call out to a number
-     */
-    createOutbound(fromNumber: string | undefined, toNumber: string, callController: CallController): void;
-    private replaceHandler;
-    private uninitializedOutbound;
-    private initializedOutbound;
-    /**
-     * @description use the Guava API to receive calls at a given number
-     */
-    listenInbound<U extends CallController>(conn: InboundConnection, controllerClassFactory: (logger: Logger) => U): InboundListener;
-}
-declare class InboundListener {
-    private ws;
-    constructor(ws: WebSocket);
-    close(): void;
-}

package/dist/src/index.js

@@ -1,359 +1,18 @@
 "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.Client = exports.Call = exports.Agent = exports.getDefaultLogger = exports.getConsoleLogger = exports.Field = exports.Say = exports.CallController = void 0;
-const ws_1 = __importDefault(require("ws"));
-const logging_ts_1 = require("./logging.js");
-const commands_ts_1 = require("./commands.js");
-const z = __importStar(require("zod"));
-const events_ts_1 = require("./events.js");
-const version_ts_1 = require("./version.js");
-const node_os_1 = __importDefault(require("node:os"));
-const utils_ts_1 = require("./utils.js");
-const telemetry_ts_1 = require("./telemetry.js");
+exports.Call = exports.Agent = exports.getDefaultLogger = exports.getConsoleLogger = exports.Field = exports.Say = exports.CallController = exports.Client = void 0;
+var client_ts_1 = require("./client.js");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_ts_1.Client; } });
 var call_controller_ts_1 = require("./call-controller.js");
 Object.defineProperty(exports, "CallController", { enumerable: true, get: function () { return call_controller_ts_1.CallController; } });
 var action_item_ts_1 = require("./action-item.js");
 Object.defineProperty(exports, "Say", { enumerable: true, get: function () { return action_item_ts_1.Say; } });
 Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return action_item_ts_1.Field; } });
-var logging_ts_2 = require("./logging.js");
-Object.defineProperty(exports, "getConsoleLogger", { enumerable: true, get: function () { return logging_ts_2.getConsoleLogger; } });
-Object.defineProperty(exports, "getDefaultLogger", { enumerable: true, get: function () { return logging_ts_2.getDefaultLogger; } });
+var logging_ts_1 = require("./logging.js");
+Object.defineProperty(exports, "getConsoleLogger", { enumerable: true, get: function () { return logging_ts_1.getConsoleLogger; } });
+Object.defineProperty(exports, "getDefaultLogger", { enumerable: true, get: function () { return logging_ts_1.getDefaultLogger; } });
 var agent_ts_1 = require("./agent.js");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_ts_1.Agent; } });
 var call_ts_1 = require("./call.js");
 Object.defineProperty(exports, "Call", { enumerable: true, get: function () { return call_ts_1.Call; } });
-const SDK_NAME = "typescript-sdk";
-let firstClient = false;
-/**
- * @description convenience function for stringifying data according to a schema
- */
-function stringifyZod(schema, data) {
-    return JSON.stringify(schema.parse(data));
-}
-const http_start = /^http:\/\//;
-const https_start = /^https:\/\//;
-let Client = (() => {
-    let _classDecorators = [telemetry_ts_1.telemetryClient.trackClass()];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    var Client = 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);
-            Client = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        _apiKey;
-        _baseUrl;
-        _logger;
-        _ws;
-        _controller;
-        messageHandler;
-        constructor(apiKey, baseUrl, logger, captureWarnings = true) {
-            // Set up the default logger.
-            if (logger) {
-                this._logger = logger;
-            }
-            else {
-                this._logger = (0, logging_ts_1.getDefaultLogger)();
-            }
-            // Resolve the API base URL.
-            if (baseUrl) {
-                this._baseUrl = baseUrl;
-            }
-            else {
-                this._baseUrl = (0, utils_ts_1.getBaseUrl)();
-            }
-            // Resolve the API key.
-            if (apiKey) {
-                this._apiKey = apiKey;
-            }
-            else if (process.env.GUAVA_API_KEY) {
-                this._apiKey = process.env.GUAVA_API_KEY;
-            }
-            else {
-                throw new Error("Guava API key must be provided either as argument to client constructor, or in environment variable GUAVA_API_KEY.");
-            }
-            if (!firstClient) {
-                firstClient = true;
-                if (captureWarnings) {
-                    process.on("warning", (warning) => {
-                        this._logger.warn(warning.toString());
-                    });
-                }
-                telemetry_ts_1.telemetryClient.setSdkHeaders(this.headers());
-                this._checkSdkDeprecation();
-            }
-        }
-        getWebsocketBase() {
-            if (http_start.test(this._baseUrl)) {
-                return `ws://${this._baseUrl.substring("ws://".length)}`;
-            }
-            else if (https_start.test(this._baseUrl)) {
-                return `wss://${this._baseUrl.substring("wss://".length)}`;
-            }
-            else {
-                throw new Error(`Invalid base URL: ${this._baseUrl}}`);
-            }
-        }
-        getHttpBase() {
-            return this._baseUrl;
-        }
-        headers() {
-            return {
-                Authorization: `Bearer ${this._apiKey}`,
-                "x-guava-platform": node_os_1.default.platform(),
-                "x-guava-runtime": process.release.name,
-                "x-guava-runtime-version": process.version,
-                "x-guava-sdk": SDK_NAME,
-                "x-guava-sdk-version": version_ts_1.SDK_VERSION,
-            };
-        }
-        async _checkSdkDeprecation() {
-            this._logger.debug(`Checking deprecation for SDK ${SDK_NAME}, ${version_ts_1.SDK_VERSION}.`);
-            try {
-                const url = new URL("v1/check-sdk-deprecation", this.getHttpBase());
-                url.searchParams.set("sdk_name", SDK_NAME);
-                url.searchParams.set("sdk_version", version_ts_1.SDK_VERSION);
-                const response = await (0, utils_ts_1.fetchOrThrow)(url, {
-                    method: "POST",
-                    headers: this.headers(),
-                });
-                const body = (await response.json());
-                if (body.deprecation_status === "supported") {
-                    this._logger.info("SDK version still supported.");
-                }
-                else if (body.deprecation_status === "deprecated") {
-                    process.emitWarning("This SDK version is deprecated. Please update to a newer version of the SDK.");
-                }
-                else {
-                    this._logger.warn("SDK deprecation status unknown.");
-                }
-            }
-            catch (e) {
-                this._logger.error("Encountered issue while checking for deprecation.");
-            }
-        }
-        /**
-         * @description use the Guava API to call out to a number
-         */
-        createOutbound(fromNumber, toNumber, callController) {
-            const url = new URL("v1/create-outbound", this.getWebsocketBase());
-            const ws = new ws_1.default(url, {
-                headers: this.headers(),
-            });
-            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
-                callController.setDrain(async (commands) => {
-                    for (const command of commands.splice(0)) {
-                        this._logger.debug(`Sending command ${JSON.stringify(command)}`);
-                        ws.send(JSON.stringify(command));
-                    }
-                });
-                await callController.onCallStart();
-            });
-            ws.addEventListener("close", (_ev) => {
-                // we are closing the socket, so don't trigger any other listeners
-                ws.removeAllListeners();
-                this._ws = undefined;
-                this._controller = undefined;
-            });
-            this._ws = ws;
-            this._controller = callController;
-            this.replaceHandler(this.uninitializedOutbound.bind(this));
-        }
-        replaceHandler(newHandler) {
-            if (this.messageHandler) {
-                this._ws?.removeEventListener("message", this.messageHandler);
-            }
-            if (newHandler) {
-                this._ws?.addEventListener("message", newHandler);
-            }
-            this.messageHandler = newHandler;
-        }
-        // eventlistener handlers for server events
-        // (a state machine in functions)
-        uninitializedOutbound(ev) {
-            // for correctness (and type correctness)
-            if (!this._ws) {
-                throw new Error("[internal] Uninitialized WebSocket");
-            }
-            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}`);
-                // move to next state
-                this.replaceHandler(this.initializedOutbound.bind(this));
-            }
-        }
-        async initializedOutbound(ev) {
-            // for correctness (and type correctness)
-            if (!this._ws) {
-                throw new Error("[internal] Uninitialized WebSocket");
-            }
-            // handle the received event
-            const event = (0, events_ts_1.decodeEvent)(ev.data);
-            if (event) {
-                if (this._controller) {
-                    await this._controller.onEvent(event);
-                }
-                if (event.event_type === "outbound-call-failed" || event.event_type === "bot-session-ended") {
-                    // shutdown the websocket
-                    this._ws.close();
-                }
-            }
-        }
-        /**
-         * @description use the Guava API to receive calls at a given number
-         */
-        listenInbound(conn, controllerClassFactory) {
-            const callControllers = {};
-            // return a way to *stop* listening
-            const url = new URL("v1/listen-inbound", this.getWebsocketBase());
-            const ws = new ws_1.default(url, {
-                headers: this.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.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", (ev) => {
-                const tunnel_event = events_ts_1.InboundTunnelEvent.parse(JSON.parse(ev.data.toString("utf8")));
-                if (!(tunnel_event.call_id in callControllers)) {
-                    this._logger.info(`Received tunnel event for new call ID: ${tunnel_event.call_id}. Creating call controller.`);
-                    const newController = controllerClassFactory(this._logger);
-                    newController.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,
-                            }));
-                        }
-                    });
-                    callControllers[tunnel_event.call_id] = newController;
-                    newController.onEvent(tunnel_event.event);
-                }
-                else {
-                    // no threading, so manually forward to onEvent!
-                    callControllers[tunnel_event.call_id].onEvent(tunnel_event.event);
-                }
-            });
-            return new InboundListener(ws);
-        }
-    };
-    return Client = _classThis;
-})();
-exports.Client = Client;
-class InboundListener {
-    ws;
-    constructor(ws) {
-        this.ws = ws;
-    }
-    close() {
-        this.ws.close();
-    }
-}
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA2B;AAC3B,6CAA6D;AAC7D,+CAIuB;AACvB,uCAAyB;AACzB,2CAA+F;AAC/F,6CAA2C;AAC3C,sDAAyB;AACzB,yCAAsD;AACtD,iDAAiD;AAEjD,2DAA0E;AAAjE,oHAAA,cAAc,OAAA;AACvB,mDAA8C;AAArC,qGAAA,GAAG,OAAA;AAAE,uGAAA,KAAK,OAAA;AACnB,2CAA0E;AAAzD,8GAAA,gBAAgB,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AACnD,uCAA6C;AAApC,iGAAA,KAAK,OAAA;AACd,qCAAiC;AAAxB,+FAAA,IAAI,OAAA;AAEb,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAElC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;GAEG;AACH,SAAS,YAAY,CAA2B,MAAc,EAAE,IAAqB;IACnF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC;AAID,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,WAAW,GAAG,aAAa,CAAC;IAGrB,MAAM;4BADlB,8BAAe,CAAC,UAAU,EAAE;;;;;;;;YAC7B,6KAuQC;;;YAvQY,uDAAM;;QACT,OAAO,CAAS;QAChB,QAAQ,CAAS;QACjB,OAAO,CAAS;QAChB,GAAG,CAAa;QAChB,WAAW,CAAkB;QAC7B,cAAc,CAAuC;QAE7D,YAAY,MAAe,EAAE,OAAgB,EAAE,MAAe,EAAE,kBAA2B,IAAI;YAC7F,6BAA6B;YAC7B,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG,IAAA,6BAAgB,GAAE,CAAC;YACpC,CAAC;YAED,4BAA4B;YAC5B,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,GAAG,IAAA,qBAAU,GAAE,CAAC;YAC/B,CAAC;YAED,uBAAuB;YACvB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;YACxB,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,oHAAoH,CACrH,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBAEnB,IAAI,eAAe,EAAE,CAAC;oBACpB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;wBAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACxC,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,8BAAe,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9C,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,gBAAgB;YACd,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,OAAO,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,CAAC;iBAAM,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3C,OAAO,SAAS,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,WAAW;YACT,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAED,OAAO;YACL,OAAO;gBACL,aAAa,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE;gBACvC,kBAAkB,EAAE,iBAAE,CAAC,QAAQ,EAAE;gBACjC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBACvC,yBAAyB,EAAE,OAAO,CAAC,OAAO;gBAC1C,aAAa,EAAE,QAAQ;gBACvB,qBAAqB,EAAE,wBAAW;aACnC,CAAC;QACJ,CAAC;QAEO,KAAK,CAAC,oBAAoB;YAChC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gCAAgC,QAAQ,KAAK,wBAAW,GAAG,CAAC,CAAC;YAChF,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACpE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,wBAAW,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,MAAM,IAAA,uBAAY,EAAC,GAAG,EAAE;oBACvC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;iBACxB,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;gBACvE,IAAI,IAAI,CAAC,kBAAkB,KAAK,WAAW,EAAE,CAAC;oBAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;gBACpD,CAAC;qBAAM,IAAI,IAAI,CAAC,kBAAkB,KAAK,YAAY,EAAE,CAAC;oBACpD,OAAO,CAAC,WAAW,CACjB,8EAA8E,CAC/E,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED;;WAEG;QACH,cAAc,CAAC,UAA8B,EAAE,QAAgB,EAAE,cAA8B;YAC7F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YACnE,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,GAAG,EAAE;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;aACxB,CAAC,CAAC;YAEH,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,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACzC,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;gBAEH,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACnC,kEAAkE;gBAClE,EAAE,CAAC,kBAAkB,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;gBACrB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;YAClC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;QAEO,cAAc,CAAC,UAAgD;YACrE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACpD,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QACnC,CAAC;QAED,2CAA2C;QAC3C,iCAAiC;QACzB,qBAAqB,CAAC,EAA0B;YACtD,yCAAyC;YACzC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,eAAe,GAAG,CAAC;iBACtB,KAAK,CAAC,CAAC,+BAAmB,EAAE,sBAAU,CAAC,CAAC;iBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/C,IAAI,eAAe,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,yBAAyB,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,eAAe,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC5E,qBAAqB;gBACrB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAEO,KAAK,CAAC,mBAAmB,CAAC,EAA0B;YAC1D,yCAAyC;YACzC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YAED,4BAA4B;YAC5B,MAAM,KAAK,GAAG,IAAA,uBAAW,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,KAAK,CAAC,UAAU,KAAK,sBAAsB,IAAI,KAAK,CAAC,UAAU,KAAK,mBAAmB,EAAE,CAAC;oBAC5F,yBAAyB;oBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAED;;WAEG;QACH,aAAa,CACX,IAAuB,EACvB,sBAA6C;YAE7C,MAAM,eAAe,GAAsB,EAAE,CAAC;YAE9C,mCAAmC;YACnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAClE,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,GAAG,EAAE;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;aACxB,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,CAAC,4BAA4B,WAAW,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACxF,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,CAAC,EAAE,EAAE,EAAE;gBACpC,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,eAAe,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,0CAA0C,YAAY,CAAC,OAAO,6BAA6B,CAC5F,CAAC;oBAEF,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC3D,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;wBACxC,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,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC;oBACtD,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;qBAAM,CAAC;oBACN,gDAAgD;oBAChD,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;;;;AAtQU,wBAAM;AAyQnB,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6D;AAApD,mGAAA,MAAM,OAAA;AACf,2DAA0E;AAAjE,oHAAA,cAAc,OAAA;AACvB,mDAA8C;AAArC,qGAAA,GAAG,OAAA;AAAE,uGAAA,KAAK,OAAA;AACnB,2CAA0E;AAAzD,8GAAA,gBAAgB,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AACnD,uCAA6C;AAApC,iGAAA,KAAK,OAAA;AACd,qCAAiC;AAAxB,+FAAA,IAAI,OAAA"}

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.12.0";
+export declare const SDK_VERSION = "0.13.0";

package/dist/src/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.12.0";
+exports.SDK_VERSION = "0.13.0";
 //# sourceMappingURL=version.js.map

package/examples/help-desk.ts

@@ -56,5 +56,5 @@ agent.onAction("other", async (call: guava.Call) => {
 });
 
 export async function run(_args: string[]) {
-  agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER!);
+  agent.listenPhone(process.env.GUAVA_AGENT_NUMBER!);
 }

package/examples/property-insurance.ts

@@ -19,5 +19,5 @@ agent.onQuestion(async (call: guava.Call, question: string) => {
 });
 
 export async function run(args: string[]) {
-  agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER!);
+  agent.listenPhone(process.env.GUAVA_AGENT_NUMBER!);
 }

package/examples/restaurant-waitlist.ts

@@ -43,5 +43,5 @@ agent.onTaskComplete("waitlist", async (call: guava.Call) => {
 });
 
 export async function run(_args: string[]) {
-  agent.inboundPhone(process.env.GUAVA_AGENT_NUMBER!);
+  agent.listenPhone(process.env.GUAVA_AGENT_NUMBER!);
 }

package/examples/scheduling-outbound.ts

@@ -51,7 +51,7 @@ export async function run(args: string[]) {
     process.exit(1);
   }
 
-  agent.outboundPhone(process.env.GUAVA_AGENT_NUMBER, toNumber, {
+  agent.callPhone(process.env.GUAVA_AGENT_NUMBER, toNumber, {
     patientName: patientName,
   });
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@guava-ai/guava-sdk",
   "description": "The official TypeScript SDK for building Guava voice agents.",
   "homepage": "https://docs.goguava.ai/typescript-sdk/",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "commonjs",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/src/agent.ts

@@ -158,7 +158,7 @@ export class Agent {
     });
   }
 
-  inboundPhone(phoneNumber: string): InboundListener {
+  listenPhone(phoneNumber: string): InboundListener {
     return this._listenInbound({
       agent_number: phoneNumber,
     });
@@ -367,7 +367,7 @@ export class Agent {
   /**
    * @description use the Guava API to call out to a number
    */
-  async outboundPhone(
+  async callPhone(
     fromNumber: string | undefined,
     toNumber: string,
     variables: Record<string, any> = {},
@@ -425,6 +425,21 @@ export class Agent {
       ws.removeAllListeners();
     });
   }
+
+  /* ===== Aliases to be removed at some point. ===== */
+  /** @deprecated Use {@link listenPhone} instead. */
+  inboundPhone(phoneNumber: string): InboundListener {
+    return this.listenPhone(phoneNumber);
+  }
+
+  /** @deprecated Use {@link callPhone} instead. */
+  async outboundPhone(
+    fromNumber: string | undefined,
+    toNumber: string,
+    variables: Record<string, any> = {},
+  ) {
+    return this.callPhone(fromNumber, toNumber, variables);
+  }
 }
 
 class InboundListener {