@guava-ai/guava-sdk 0.37.0 → 0.38.0

package/dist/src/webrtc/index.js

@@ -0,0 +1,299 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Call = exports.CallError = exports.RingbackTone = exports.JingleTone = void 0;
+const tones_ts_1 = require("./tones.js");
+var tones_ts_2 = require("./tones.js");
+Object.defineProperty(exports, "JingleTone", { enumerable: true, get: function () { return tones_ts_2.JingleTone; } });
+Object.defineProperty(exports, "RingbackTone", { enumerable: true, get: function () { return tones_ts_2.RingbackTone; } });
+class CallError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "CallError";
+        this.code = code;
+    }
+}
+exports.CallError = CallError;
+// Used if the server doesn't send ICE servers with the auth reply.
+const DEFAULT_ICE_SERVERS = [
+    { urls: ["stun:stun.l.google.com:19302", "stun:stun.sipgate.net:10000"] },
+];
+const SOCKET_PROTOCOLS = {
+    "http:": "ws:",
+    "https:": "wss:",
+    "ws:": "ws:",
+    "wss:": "wss:",
+};
+class Call {
+    _state = "not-started";
+    _error;
+    _stateHandlers = new Set();
+    _remoteStreamHandlers = new Set();
+    _webrtcCode;
+    _sockUrl;
+    _remoteAudio;
+    _connectingTone;
+    _sock;
+    _localStream;
+    _peerConnection;
+    _remoteStream;
+    _iceServers;
+    // Settles the promise returned by start().
+    _pendingStart;
+    constructor({ webrtcCode, baseUrl = "https://app.goguava.ai/", connectingTone = new tones_ts_1.JingleTone(), }) {
+        this._webrtcCode = webrtcCode;
+        if (connectingTone !== "disabled") {
+            this._connectingTone = connectingTone;
+        }
+        this._sockUrl = new URL("/webrtc/", baseUrl);
+        const sockProtocol = SOCKET_PROTOCOLS[this._sockUrl.protocol];
+        if (sockProtocol === undefined) {
+            throw new Error(`Unsupported baseUrl protocol: ${this._sockUrl.protocol}`);
+        }
+        this._sockUrl.protocol = sockProtocol;
+        this._remoteAudio = document.createElement("audio");
+        this._remoteAudio.autoplay = true;
+    }
+    get state() {
+        return this._state;
+    }
+    // Set if the call ended due to a failure.
+    get error() {
+        return this._error;
+    }
+    // Set once the remote audio track arrives, which happens before the call reaches "connected".
+    get remoteStream() {
+        return this._remoteStream;
+    }
+    // Returns a function that unregisters the handler.
+    onStateChange(handler) {
+        this._stateHandlers.add(handler);
+        return () => {
+            this._stateHandlers.delete(handler);
+        };
+    }
+    // Fires whenever the remote stream is replaced, including the first time it arrives.
+    // Returns a function that unregisters the handler.
+    onRemoteStream(handler) {
+        this._remoteStreamHandlers.add(handler);
+        return () => {
+            this._remoteStreamHandlers.delete(handler);
+        };
+    }
+    _setState(state) {
+        if (state === this._state) {
+            return;
+        }
+        this._state = state;
+        if (state === "connecting") {
+            this._connectingTone?.start();
+        }
+        else {
+            this._connectingTone?.stop();
+        }
+        for (const handler of this._stateHandlers) {
+            handler(state);
+        }
+    }
+    async start() {
+        if (this._state !== "not-started") {
+            throw new Error(`start() was already called.`);
+        }
+        this._setState("starting");
+        // Add the audio element.
+        document.body.appendChild(this._remoteAudio);
+        // We start by requesting device permissions first. The idea is that, after permission has been granted,
+        // it makes sence to play a ringback, but it doesn't make sense to do so during the permission prompt.
+        const permissionTimer = setTimeout(() => {
+            this._setState("waiting-for-permission");
+        }, 500);
+        try {
+            this._localStream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
+        }
+        catch (error) {
+            const callError = new CallError("MICROPHONE_ACCESS_FAILED", "Failed to access microphone.", {
+                cause: error,
+            });
+            this._end(callError);
+            throw callError;
+        }
+        finally {
+            clearTimeout(permissionTimer);
+        }
+        // hangup() was called during the permission prompt.
+        if (this.state === "ended") {
+            this._teardown();
+            return;
+        }
+        // Now open and authenticate the signaling socket.
+        this._setState("connecting"); // UI can start playing rinback tones here.
+        const started = new Promise((resolve, reject) => {
+            this._pendingStart = { resolve, reject };
+        });
+        this._sock = new WebSocket(this._sockUrl);
+        this._sock.onopen = () => {
+            this._send({ type: "auth", body: this._webrtcCode });
+        };
+        this._sock.onmessage = (event) => {
+            this._onMessage(JSON.parse(event.data));
+        };
+        this._sock.onclose = () => {
+            this._end(new CallError("CONNECTION_FAILED", "Signaling connection closed."));
+        };
+        await started;
+    }
+    async hangup() {
+        if (this._state === "not-started") {
+            throw new Error(`hangup() called before start().`);
+        }
+        if (this._state === "ended") {
+            return;
+        }
+        this._send({ type: "hangup" });
+        this._end();
+    }
+    _send(message) {
+        if (this._sock !== undefined && this._sock.readyState === WebSocket.OPEN) {
+            this._sock.send(JSON.stringify(message));
+        }
+    }
+    _onMessage(message) {
+        switch (message.type) {
+            case "auth":
+                if (message.body !== "OK") {
+                    this._end(new CallError("AUTHENTICATION_FAILED", message.reason || "Authentication failed."));
+                    return;
+                }
+                this._iceServers = message.ice_servers;
+                this._send({ type: "connect", body: {} });
+                void this._connectPeer();
+                break;
+            case "desc":
+                if (!this._peerConnection) {
+                    this._end(new CallError("PROTOCOL_ERROR", "Received desc before the peer connection was created."));
+                    return;
+                }
+                this._peerConnection.setRemoteDescription(message.body).catch((error) => {
+                    this._end(new CallError("CONNECTION_FAILED", "Failed to set remote description.", {
+                        cause: error,
+                    }));
+                });
+                break;
+            case "candidate":
+                if (!this._peerConnection) {
+                    this._end(new CallError("PROTOCOL_ERROR", "Received candidate before the peer connection was created."));
+                    return;
+                }
+                this._peerConnection.addIceCandidate(message.body).catch((error) => {
+                    console.warn("Failed to add ICE candidate:", error);
+                });
+                break;
+            case "hangup":
+                if (this._state === "connected") {
+                    this._end();
+                }
+                else {
+                    this._end(new CallError("REMOTE_HANGUP", "The remote hung up before the call connected."));
+                }
+                break;
+            case "error":
+                this._end(new CallError("SERVER_ERROR", message.body || "Unknown server error."));
+                break;
+            case "transfer":
+                this._end(new CallError("PROTOCOL_ERROR", "Transfers are not supported."));
+                break;
+            default:
+                console.warn("Unknown signaling message:", message);
+        }
+    }
+    async _connectPeer() {
+        if (!this._localStream) {
+            return;
+        }
+        this._peerConnection = new RTCPeerConnection({
+            iceServers: this._iceServers ?? DEFAULT_ICE_SERVERS,
+        });
+        this._peerConnection.onicecandidate = (event) => {
+            if (event.candidate) {
+                this._send({ type: "candidate", body: event.candidate });
+            }
+        };
+        this._peerConnection.ontrack = (event) => {
+            this._remoteStream = new MediaStream([event.track]);
+            this._remoteAudio.srcObject = this._remoteStream;
+            for (const handler of this._remoteStreamHandlers) {
+                handler(this._remoteStream);
+            }
+        };
+        this._peerConnection.onconnectionstatechange = () => {
+            if (this._peerConnection === undefined) {
+                return;
+            }
+            // "disconnected" is often transient, so wait for "failed" before ending the call.
+            if (this._peerConnection.connectionState === "connected") {
+                this._setState("connected");
+                if (this._pendingStart !== undefined) {
+                    this._pendingStart.resolve();
+                    this._pendingStart = undefined;
+                }
+            }
+            else if (this._peerConnection.connectionState === "failed") {
+                this._end(new CallError("CONNECTION_FAILED", "Peer connection failed."));
+            }
+        };
+        for (const track of this._localStream.getAudioTracks()) {
+            this._peerConnection.addTrack(track);
+        }
+        try {
+            await this._peerConnection.setLocalDescription();
+        }
+        catch (error) {
+            this._end(new CallError("CONNECTION_FAILED", "Failed to create offer.", { cause: error }));
+            return;
+        }
+        // The call may have ended while creating the offer.
+        if (this.state === "ended") {
+            return;
+        }
+        this._send({ type: "desc", body: this._peerConnection.localDescription });
+    }
+    _end(error) {
+        if (this._state === "ended") {
+            return;
+        }
+        this._error = error;
+        this._teardown();
+        this._setState("ended");
+        // If start() is still pending, it rejects on failure and resolves on hangup().
+        if (this._pendingStart !== undefined) {
+            if (error) {
+                this._pendingStart.reject(error);
+            }
+            else {
+                this._pendingStart.resolve();
+            }
+            this._pendingStart = undefined;
+        }
+    }
+    _teardown() {
+        if (this._sock) {
+            // Don't fire close handlers for a socket we closed ourselves.
+            this._sock.onclose = null;
+            this._sock.close();
+            this._sock = undefined;
+        }
+        if (this._peerConnection !== undefined) {
+            this._peerConnection.close();
+            this._peerConnection = undefined;
+        }
+        for (const track of this._localStream?.getTracks() ?? []) {
+            track.stop();
+        }
+        this._localStream = undefined;
+        this._remoteStream = undefined;
+        this._remoteAudio.srcObject = null;
+        this._remoteAudio.remove();
+    }
+}
+exports.Call = Call;
+//# sourceMappingURL=index.js.map

package/dist/src/webrtc/index.js.map

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

package/dist/src/webrtc/tones.d.ts

@@ -0,0 +1,31 @@
+export interface ConnectingTone {
+    start(): void;
+    stop(): void;
+}
+export declare class RingbackTone implements ConnectingTone {
+    private context;
+    private intervalId;
+    private readonly volume;
+    private readonly onSeconds;
+    private readonly periodSeconds;
+    private readonly startDelay;
+    start(): void;
+    stop(): void;
+}
+export declare class JingleTone implements ConnectingTone {
+    private context;
+    private masterGain;
+    private intervalId;
+    private running;
+    private pulseCount;
+    private nextBarStart;
+    private readonly volume;
+    private readonly bpm;
+    private readonly beatsPerBar;
+    private readonly startDelay;
+    start(): void;
+    private noteToFrequency;
+    stop(): void;
+    private playPulse;
+    private playNote;
+}

package/dist/src/webrtc/tones.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JingleTone = exports.RingbackTone = void 0;
+// Seconds from the start of bar 0 to the given 0-indexed beat.
+function beatTime(beat, bpm) {
+    return beat * (60 / bpm);
+}
+// North American ringback: 440 + 480 Hz, 2s on, 4s off.
+class RingbackTone {
+    context = null;
+    intervalId = null;
+    volume = 0.15;
+    onSeconds = 2;
+    periodSeconds = 6;
+    // Delay before the first ring, so near-instant connections stay silent.
+    startDelay = 0.3;
+    start() {
+        if (this.context)
+            return;
+        const context = new AudioContext();
+        const gain = context.createGain();
+        gain.gain.value = 0;
+        gain.connect(context.destination);
+        for (const frequency of [440, 480]) {
+            const oscillator = context.createOscillator();
+            oscillator.frequency.value = frequency;
+            oscillator.connect(gain);
+            oscillator.start();
+        }
+        let nextRing = context.currentTime + this.startDelay;
+        const ring = () => {
+            gain.gain.setValueAtTime(this.volume, nextRing);
+            gain.gain.setValueAtTime(0, nextRing + this.onSeconds);
+            nextRing += this.periodSeconds;
+        };
+        ring();
+        this.intervalId = setInterval(ring, this.periodSeconds * 1000);
+        this.context = context;
+    }
+    stop() {
+        if (!this.context)
+            return;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        // Closing the context stops the oscillators.
+        void this.context.close();
+        this.context = null;
+    }
+}
+exports.RingbackTone = RingbackTone;
+class JingleTone {
+    context = null;
+    masterGain = null;
+    intervalId = null;
+    running = false;
+    pulseCount = 0;
+    // Audio-clock time of the next bar to schedule.
+    nextBarStart = 0;
+    // Configuration
+    volume = 0.25;
+    bpm = 120;
+    beatsPerBar = 4;
+    // Delay before the first note, so near-instant connections stay silent.
+    startDelay = 0.3;
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.pulseCount = 0;
+        this.context = new AudioContext();
+        this.masterGain = this.context.createGain();
+        this.masterGain.gain.value = this.volume;
+        this.masterGain.connect(this.context.destination);
+        this.nextBarStart = this.context.currentTime + this.startDelay;
+        // Stay one bar ahead so timer jitter doesn't shift the beat.
+        this.playPulse();
+        this.playPulse();
+        const barLength = beatTime(this.beatsPerBar, this.bpm);
+        this.intervalId = setInterval(() => {
+            this.playPulse();
+        }, barLength * 1000);
+    }
+    noteToFrequency(note) {
+        const match = note.match(/^([A-G])(#|b)?(-?\d+)$/);
+        if (!match) {
+            throw new Error(`Invalid note: ${note}`);
+        }
+        const [, name, accidental, octave] = match;
+        const semitones = {
+            C: 0,
+            D: 2,
+            E: 4,
+            F: 5,
+            G: 7,
+            A: 9,
+            B: 11,
+        };
+        const offset = accidental === "#" ? 1 : accidental === "b" ? -1 : 0;
+        const midi = (Number(octave) + 1) * 12 + semitones[name] + offset;
+        return 440 * Math.pow(2, (midi - 69) / 12);
+    }
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        const context = this.context;
+        const gain = this.masterGain;
+        if (!context || !gain)
+            return;
+        // Smooth fade-out
+        const now = context.currentTime;
+        gain.gain.setValueAtTime(gain.gain.value, now);
+        gain.gain.linearRampToValueAtTime(0, now + 0.15);
+        setTimeout(() => {
+            void context.close();
+        }, 200);
+        this.context = null;
+        this.masterGain = null;
+    }
+    playPulse() {
+        if (!this.context || !this.masterGain)
+            return;
+        const bar = this.nextBarStart;
+        const beat = (n) => bar + beatTime(n, this.bpm);
+        const beatLength = beatTime(1, this.bpm);
+        // Notes on beats 1-3, silence on beat 4.
+        if (this.pulseCount % 4 === 0 || this.pulseCount % 4 === 2) {
+            this.playNote("C5", beat(0), beatLength);
+            this.playNote("E5", beat(0.5), beatLength);
+            this.playNote("G4", beat(1), beatLength);
+        }
+        else if (this.pulseCount % 4 === 3) {
+            this.playNote("E5", beat(0), beatLength);
+            this.playNote("G5", beat(0.5), beatLength);
+            this.playNote("C5", beat(1), beatLength);
+        }
+        else {
+            this.playNote("E5", beat(0), beatLength);
+            this.playNote("G4", beat(0.5), beatLength);
+            this.playNote("C5", beat(1), beatLength);
+        }
+        this.pulseCount++;
+        this.nextBarStart = beat(this.beatsPerBar);
+    }
+    playNote(note, startTime, duration) {
+        if (!this.context || !this.masterGain)
+            return;
+        const oscillator = this.context.createOscillator();
+        const envelope = this.context.createGain();
+        oscillator.type = "sine";
+        oscillator.frequency.value = this.noteToFrequency(note);
+        envelope.gain.setValueAtTime(0, startTime);
+        envelope.gain.linearRampToValueAtTime(0.7, startTime + 0.05);
+        envelope.gain.exponentialRampToValueAtTime(0.001, startTime + duration);
+        oscillator.connect(envelope);
+        envelope.connect(this.masterGain);
+        oscillator.start(startTime);
+        oscillator.stop(startTime + duration + 0.01);
+        oscillator.onended = () => {
+            oscillator.disconnect();
+            envelope.disconnect();
+        };
+    }
+}
+exports.JingleTone = JingleTone;
+//# sourceMappingURL=tones.js.map

package/dist/src/webrtc/tones.js.map

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

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.37.0",
+  "version": "0.38.0",
   "type": "commonjs",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -19,6 +19,10 @@
       "types": "./dist/src/helpers/openai.d.ts",
       "default": "./dist/src/helpers/openai.js"
     },
+    "./webrtc": {
+      "types": "./dist/src/webrtc/index.d.ts",
+      "default": "./dist/src/webrtc/index.js"
+    },
     "./example-data": {
       "types": "./dist/src/example-data.d.ts",
       "default": "./dist/src/example-data.js"
@@ -37,7 +41,9 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.7",
     "@types/ws": "^8.18.1",
+    "esbuild": "^0.28.2",
     "jest": "^30.4.2",
+    "jest-environment-jsdom": "^30.5.2",
     "openai": "^6.16.0",
     "ts-jest": "^29.4.11",
     "tsx": "^4.21.0",
@@ -70,7 +76,10 @@
     "test:e2e": "jest --config jest.e2e.config.cjs",
     "check": "npm run typecheck && npm audit --omit=dev && npm run lint && npm run check-format",
     "clean": "rm -rf ./dist",
-    "build": "tsx scripts/update-version.ts && tsc && chmod +x ./dist/bin/example-runner.js",
+    "build": "tsx scripts/update-version.ts && tsc && chmod +x ./dist/bin/example-runner.js && npm run build-webrtc && tsx scripts/update-readme.ts",
+    "build-webrtc": "npm run build-webrtc:esm && npm run build-webrtc:iife",
+    "build-webrtc:esm": "esbuild src/webrtc/index.ts --bundle --minify --sourcemap --target=es2020 --format=esm --outfile=dist/guava-webrtc.esm.min.js",
+    "build-webrtc:iife": "esbuild src/webrtc/index.ts --bundle --minify --sourcemap --target=es2020 --format=iife --global-name=Guava --outfile=dist/guava-webrtc.min.js",
     "prepare": "npm run clean && npm run build",
     "release": "npm publish --ignore-scripts=false"
   },
@@ -85,5 +94,9 @@
     "/dist",
     "/examples",
     "/bin"
-  ]
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goguava-ai/typescript-sdk.git"
+  }
 }

package/src/call.ts

@@ -25,6 +25,7 @@ import type {
 import { Say } from "./action-item.ts";
 import { telemetryClient } from "./telemetry.ts";
 import type { CallInfo } from "./socket/call-info.ts";
+import type { SipUri } from "./sip.ts";
 
 export type TaskObjective =
   | { objective: string }
@@ -248,13 +249,13 @@ export class Call {
    * This method does not interfere with turn-taking — use this when
    * you want the agent to naturally transfer the call.
    *
-   * @param destination - The phone number or SIP address to transfer the call to.
+   * @param destination - The phone number, SIP address, or SipUri to transfer the call to.
    * @param instructions - Optional guidance for how the agent should handle the transfer.
    */
-  async transfer(destination: string, instructions?: string) {
+  async transfer(destination: string | SipUri, instructions?: string) {
     await this.sendCommand(TransferCommand, {
       command_type: "transfer-call",
-      to_number: destination,
+      to_number: destination.toString(),
       transfer_message:
         instructions ?? "Notify the caller that you will be transferring them, and then transfer.",
       soft_transfer: true,
@@ -267,14 +268,14 @@ export class Call {
    * Unlike transfer(), this does not respect turn-taking. The agent immediately
    * initiates the transfer, saying the script (if provided).
    *
-   * @param destination - The phone number or SIP address to transfer the call to.
+   * @param destination - The phone number, SIP address, or SipUri to transfer the call to.
    * @param finalScript - Optional message for the agent to deliver immediately
    *   before transferring. Defaults to no message.
    */
-  async immediateTransfer(destination: string, finalScript?: string) {
+  async immediateTransfer(destination: string | SipUri, finalScript?: string) {
     await this.sendCommand(TransferCommand, {
       command_type: "transfer-call",
-      to_number: destination,
+      to_number: destination.toString(),
       transfer_message: finalScript ?? "",
       soft_transfer: false,
     });

package/src/index.ts

@@ -13,6 +13,7 @@ export { Say, Field } from "./action-item.ts";
 export { Logger, getConsoleLogger, getDefaultLogger } from "./logging.ts";
 export { Agent, CallInfo } from "./agent.ts";
 export { SIPCallInfo } from "./socket/call-info.ts";
+export { SipUri } from "./sip.ts";
 export { Call, DEFAULT_REACH_PERSON_OUTCOMES } from "./call.ts";
 export type { ReachPersonOutcome } from "./call.ts";
 export type { SpeedPreset, Language } from "./commands.ts";