@loop-voice-agent/web 0.1.0

package/dist/client.js.map

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

package/dist/controlPlane.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Hop 1 of starting a call: ask the platform for a session.
+ *
+ * `POST {baseUrl}/v1/calls/web` with a publishable key returns the call id, a
+ * short-lived signed session token, and the URL of the voice worker that will
+ * carry the media. The browser never holds a secret: the publishable key is
+ * gated by the origin allow-list registered against it, and the session token
+ * it receives is bound to this one call and expires in minutes.
+ */
+/** Per-call context. Everything here is optional; the agent supplies defaults. */
+export interface CallContext {
+    /**
+     * Values for `{{placeholders}}` in the agent's prompt and greeting, for THIS
+     * call. Per-call values win over the agent's defaults.
+     */
+    readonly variables?: Record<string, string>;
+    /** Override the agent's configured language for this call, e.g. `"hi"`. */
+    readonly language?: string;
+    /** `video` renders a talking-head avatar; `audio` is voice only. */
+    readonly channel?: "audio" | "video";
+    /** Opaque data echoed back on the completion webhook. Never shown to the agent. */
+    readonly metadata?: Record<string, unknown>;
+    /**
+     * An already-captured display stream to share for the whole call.
+     *
+     * Passing it here puts the track in the INITIAL offer, which avoids a
+     * renegotiation round trip while the user waits to connect. It is also the
+     * shape most apps already have, since screen capture has to be requested from
+     * a user gesture before the call starts. Use `startScreenShare()` when the
+     * stream only becomes available mid-call.
+     *
+     * Not sent to the control plane — it never leaves the browser's peer
+     * connection.
+     */
+    readonly screenStream?: MediaStream;
+}
+/** What hop 1 hands back. */
+export interface WebCallSession {
+    readonly callId: string;
+    readonly sessionToken: string;
+    readonly voiceWorkerUrl: string;
+}
+/** Thrown when hop 1 fails. Carries the HTTP status when there was one. */
+export declare class ControlPlaneError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/** Minimal fetch shape, so tests can inject one without a DOM. */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Start a web call and return its session bundle.
+ *
+ * The key travels as a bearer token. A 403 here is almost always the origin
+ * allow-list rather than a bad key — the message says so, because the
+ * alternative is an integrator rotating a perfectly good key while the real
+ * fix is registering the origin they are calling from.
+ */
+export declare const startWebCall: (baseUrl: string, publicKey: string, agentId: string, context: CallContext, fetchImpl: FetchLike, signal?: AbortSignal) => Promise<WebCallSession>;

package/dist/controlPlane.js

@@ -0,0 +1,75 @@
+/**
+ * Hop 1 of starting a call: ask the platform for a session.
+ *
+ * `POST {baseUrl}/v1/calls/web` with a publishable key returns the call id, a
+ * short-lived signed session token, and the URL of the voice worker that will
+ * carry the media. The browser never holds a secret: the publishable key is
+ * gated by the origin allow-list registered against it, and the session token
+ * it receives is bound to this one call and expires in minutes.
+ */
+/** Thrown when hop 1 fails. Carries the HTTP status when there was one. */
+export class ControlPlaneError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "ControlPlaneError";
+        this.status = status;
+    }
+}
+const trimSlash = (url) => url.replace(/\/+$/, "");
+const isSession = (value) => {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (typeof v.callId === "string" &&
+        typeof v.sessionToken === "string" &&
+        typeof v.voiceWorkerUrl === "string");
+};
+/**
+ * Start a web call and return its session bundle.
+ *
+ * The key travels as a bearer token. A 403 here is almost always the origin
+ * allow-list rather than a bad key — the message says so, because the
+ * alternative is an integrator rotating a perfectly good key while the real
+ * fix is registering the origin they are calling from.
+ */
+export const startWebCall = async (baseUrl, publicKey, agentId, context, fetchImpl, signal) => {
+    const url = `${trimSlash(baseUrl)}/v1/calls/web`;
+    const body = { agentId };
+    if (context.variables && Object.keys(context.variables).length > 0) {
+        body.variables = context.variables;
+    }
+    if (context.language)
+        body.language = context.language;
+    if (context.channel)
+        body.channel = context.channel;
+    if (context.metadata && Object.keys(context.metadata).length > 0) {
+        body.metadata = context.metadata;
+    }
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Authorization: `Bearer ${publicKey}` },
+            body: JSON.stringify(body),
+            ...(signal ? { signal } : {}),
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : "network error";
+        throw new ControlPlaneError(`Could not reach ${url}: ${reason}`, 0);
+    }
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        const hint = response.status === 403
+            ? " — check that this page's origin is registered on the publishable key"
+            : "";
+        throw new ControlPlaneError(`${url} returned ${response.status}${hint}: ${detail.slice(0, 300)}`, response.status);
+    }
+    const json = await response.json().catch(() => null);
+    if (!isSession(json)) {
+        throw new ControlPlaneError("Unexpected response shape — expected { callId, sessionToken, voiceWorkerUrl }", response.status);
+    }
+    return json;
+};
+//# sourceMappingURL=controlPlane.js.map

package/dist/controlPlane.js.map

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

package/dist/emitter.d.ts

@@ -0,0 +1,34 @@
+import type { VoiceAgentEventMap, VoiceAgentEventName } from "./events.js";
+/**
+ * A small typed event emitter.
+ *
+ * Hand-rolled rather than pulled from a dependency: this package ships to
+ * browsers and its whole value is being small and self-contained, so a
+ * fifty-line emitter is worth more than a transitive dependency in a consumer's
+ * bundle.
+ *
+ * One behaviour is deliberate and load-bearing: a throwing handler must not
+ * stop the other handlers for that event, and must not propagate back into the
+ * WebRTC callback that emitted it. A consumer's render error would otherwise
+ * take down the media teardown path with it.
+ */
+export declare class Emitter {
+    private readonly handlers;
+    /** Subscribe. Returns an unsubscribe function for convenience. */
+    on<E extends VoiceAgentEventName>(event: E, handler: VoiceAgentEventMap[E]): () => void;
+    /** Subscribe for exactly one emission. */
+    once<E extends VoiceAgentEventName>(event: E, handler: VoiceAgentEventMap[E]): () => void;
+    /** Unsubscribe a specific handler. */
+    off<E extends VoiceAgentEventName>(event: E, handler: VoiceAgentEventMap[E]): void;
+    /** Drop every handler — used on teardown so a disposed client leaks nothing. */
+    removeAll(): void;
+    /** Number of handlers bound to an event. Exposed for tests. */
+    listenerCount(event: VoiceAgentEventName): number;
+    /**
+     * Emit to every handler bound at the time of the call.
+     *
+     * Iterates a COPY of the handler set so a handler that unsubscribes itself —
+     * or subscribes another — during dispatch cannot mutate the set being walked.
+     */
+    emit<E extends VoiceAgentEventName>(event: E, ...args: Parameters<VoiceAgentEventMap[E]>): void;
+}

package/dist/emitter.js

@@ -0,0 +1,69 @@
+/**
+ * A small typed event emitter.
+ *
+ * Hand-rolled rather than pulled from a dependency: this package ships to
+ * browsers and its whole value is being small and self-contained, so a
+ * fifty-line emitter is worth more than a transitive dependency in a consumer's
+ * bundle.
+ *
+ * One behaviour is deliberate and load-bearing: a throwing handler must not
+ * stop the other handlers for that event, and must not propagate back into the
+ * WebRTC callback that emitted it. A consumer's render error would otherwise
+ * take down the media teardown path with it.
+ */
+export class Emitter {
+    handlers = new Map();
+    /** Subscribe. Returns an unsubscribe function for convenience. */
+    on(event, handler) {
+        let set = this.handlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(event, set);
+        }
+        set.add(handler);
+        return () => this.off(event, handler);
+    }
+    /** Subscribe for exactly one emission. */
+    once(event, handler) {
+        const wrapped = ((...args) => {
+            off();
+            handler(...args);
+        });
+        const off = this.on(event, wrapped);
+        return off;
+    }
+    /** Unsubscribe a specific handler. */
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    /** Drop every handler — used on teardown so a disposed client leaks nothing. */
+    removeAll() {
+        this.handlers.clear();
+    }
+    /** Number of handlers bound to an event. Exposed for tests. */
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+    /**
+     * Emit to every handler bound at the time of the call.
+     *
+     * Iterates a COPY of the handler set so a handler that unsubscribes itself —
+     * or subscribes another — during dispatch cannot mutate the set being walked.
+     */
+    emit(event, ...args) {
+        const set = this.handlers.get(event);
+        if (!set || set.size === 0)
+            return;
+        for (const handler of [...set]) {
+            try {
+                handler(...args);
+            }
+            catch (err) {
+                // A consumer's handler throwing is their bug, not a reason to abandon
+                // the remaining handlers or to unwind into WebRTC's callback.
+                console.error("[loop-voice-agent] event handler threw", { event, err });
+            }
+        }
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,OAAO;IACD,QAAQ,GAAG,IAAI,GAAG,EAAwD,CAAC;IAE5F,kEAAkE;IAClE,EAAE,CAAgC,KAAQ,EAAE,OAA8B;QACxE,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAqC,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAgC,KAAQ,EAAE,OAA8B;QAC1E,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;YACtC,GAAG,EAAE,CAAC;YACL,OAAqC,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC,CAA0B,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,sCAAsC;IACtC,GAAG,CAAgC,KAAQ,EAAE,OAA8B;QACzE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAqC,CAAC,CAAC;IAC1E,CAAC;IAED,gFAAgF;IAChF,SAAS;QACP,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,+DAA+D;IAC/D,aAAa,CAAC,KAA0B;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAgC,KAAQ,EAAE,GAAG,IAAuC;QACtF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACF,OAAqC,CAAC,GAAG,IAAI,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sEAAsE;gBACtE,8DAA8D;gBAC9D,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/endedReason.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The vocabulary of `endedReason` values a `call-end` event can carry.
+ *
+ * These strings are a CONTRACT, not labels. A consuming app classifies a call
+ * as clean or failed by pattern-matching them, and routes the user to a retry
+ * screen or a completion screen on that basis. Renaming one silently changes
+ * which screen a candidate sees.
+ *
+ * The values are drawn from the vocabulary Vapi emits, because the first
+ * consumer of this SDK already has that classifier written against it:
+ *
+ *   /error|did-not-receive|customer-audio|pipeline|failed|
+ *    no-microphone|did-not-give-microphone|no-audio/i
+ *
+ * Every reason below is deliberately either inside or outside that pattern, and
+ * `endedReason.test.ts` asserts each one lands on the intended side. A new
+ * reason must be added there too — the test is what stops a well-meant addition
+ * from quietly being classified as a clean hangup.
+ */
+/** A call that ended the way it was supposed to. */
+export declare const CLEAN_ENDED_REASONS: {
+    /** The local side called `stop()` — the user hung up. */
+    readonly CUSTOMER_ENDED_CALL: "customer-ended-call";
+    /** The agent ended the call itself (its end-call tool, or a closing phrase). */
+    readonly ASSISTANT_ENDED_CALL: "assistant-ended-call";
+    /** The server's configured maximum call duration elapsed. */
+    readonly EXCEEDED_MAX_DURATION: "exceeded-max-duration";
+};
+/** A call that failed. Consumers route these to a retry / troubleshooting path. */
+export declare const FAILED_ENDED_REASONS: {
+    /** ICE never established, or the peer connection dropped to `failed`. */
+    readonly CONNECTION_FAILED: "pipeline-error-connection-failed";
+    /** Nothing acknowledged the call within the connect budget. */
+    readonly CONNECTION_TIMEOUT: "pipeline-error-connection-timeout";
+    /** `getUserMedia` was rejected — the browser mic prompt was declined. */
+    readonly NO_MICROPHONE_PERMISSION: "customer-did-not-give-microphone-permission";
+    /** A track was acquired but carried no audio the agent could hear. */
+    readonly NO_CUSTOMER_AUDIO: "error-assistant-did-not-receive-customer-audio";
+    /** The media path died mid-call for a reason we could not attribute. */
+    readonly PIPELINE_ERROR: "pipeline-error-media-disconnected";
+};
+export type CleanEndedReason = (typeof CLEAN_ENDED_REASONS)[keyof typeof CLEAN_ENDED_REASONS];
+export type FailedEndedReason = (typeof FAILED_ENDED_REASONS)[keyof typeof FAILED_ENDED_REASONS];
+export type EndedReason = CleanEndedReason | FailedEndedReason | (string & {});
+/** Whether a reason reads as a failure to the consumer-side classifier. */
+export declare const isAbnormalEndedReason: (reason: string | undefined) => boolean;

package/dist/endedReason.js

@@ -0,0 +1,50 @@
+/**
+ * The vocabulary of `endedReason` values a `call-end` event can carry.
+ *
+ * These strings are a CONTRACT, not labels. A consuming app classifies a call
+ * as clean or failed by pattern-matching them, and routes the user to a retry
+ * screen or a completion screen on that basis. Renaming one silently changes
+ * which screen a candidate sees.
+ *
+ * The values are drawn from the vocabulary Vapi emits, because the first
+ * consumer of this SDK already has that classifier written against it:
+ *
+ *   /error|did-not-receive|customer-audio|pipeline|failed|
+ *    no-microphone|did-not-give-microphone|no-audio/i
+ *
+ * Every reason below is deliberately either inside or outside that pattern, and
+ * `endedReason.test.ts` asserts each one lands on the intended side. A new
+ * reason must be added there too — the test is what stops a well-meant addition
+ * from quietly being classified as a clean hangup.
+ */
+/** A call that ended the way it was supposed to. */
+export const CLEAN_ENDED_REASONS = {
+    /** The local side called `stop()` — the user hung up. */
+    CUSTOMER_ENDED_CALL: "customer-ended-call",
+    /** The agent ended the call itself (its end-call tool, or a closing phrase). */
+    ASSISTANT_ENDED_CALL: "assistant-ended-call",
+    /** The server's configured maximum call duration elapsed. */
+    EXCEEDED_MAX_DURATION: "exceeded-max-duration",
+};
+/** A call that failed. Consumers route these to a retry / troubleshooting path. */
+export const FAILED_ENDED_REASONS = {
+    /** ICE never established, or the peer connection dropped to `failed`. */
+    CONNECTION_FAILED: "pipeline-error-connection-failed",
+    /** Nothing acknowledged the call within the connect budget. */
+    CONNECTION_TIMEOUT: "pipeline-error-connection-timeout",
+    /** `getUserMedia` was rejected — the browser mic prompt was declined. */
+    NO_MICROPHONE_PERMISSION: "customer-did-not-give-microphone-permission",
+    /** A track was acquired but carried no audio the agent could hear. */
+    NO_CUSTOMER_AUDIO: "error-assistant-did-not-receive-customer-audio",
+    /** The media path died mid-call for a reason we could not attribute. */
+    PIPELINE_ERROR: "pipeline-error-media-disconnected",
+};
+/**
+ * The classifier a consuming app is expected to apply, reproduced here so the
+ * SDK can be tested against the SAME rule its consumers use rather than against
+ * a paraphrase of it.
+ */
+const ABNORMAL_PATTERN = /error|did-not-receive|customer-audio|pipeline|failed|no-microphone|did-not-give-microphone|no-audio/i;
+/** Whether a reason reads as a failure to the consumer-side classifier. */
+export const isAbnormalEndedReason = (reason) => typeof reason === "string" && ABNORMAL_PATTERN.test(reason);
+//# sourceMappingURL=endedReason.js.map

package/dist/endedReason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endedReason.js","sourceRoot":"","sources":["../src/endedReason.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,yDAAyD;IACzD,mBAAmB,EAAE,qBAAqB;IAC1C,gFAAgF;IAChF,oBAAoB,EAAE,sBAAsB;IAC5C,6DAA6D;IAC7D,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAEX,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,yEAAyE;IACzE,iBAAiB,EAAE,kCAAkC;IACrD,+DAA+D;IAC/D,kBAAkB,EAAE,mCAAmC;IACvD,yEAAyE;IACzE,wBAAwB,EAAE,6CAA6C;IACvE,sEAAsE;IACtE,iBAAiB,EAAE,gDAAgD;IACnE,wEAAwE;IACxE,cAAc,EAAE,mCAAmC;CAC3C,CAAC;AAMX;;;;GAIG;AACH,MAAM,gBAAgB,GACpB,sGAAsG,CAAC;AAEzG,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0B,EAAW,EAAE,CAC3E,OAAO,MAAM,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,81 @@
+import type { EndedReason } from "./endedReason.js";
+/**
+ * The event surface. Six names, chosen to match what a Vapi-shaped consumer
+ * already binds, so migrating an existing integration is an import change
+ * rather than a rewrite of its event handlers.
+ */
+/** A single transcript turn as it reaches the browser. */
+export interface TranscriptMessage {
+    readonly type: "transcript";
+    /** Who spoke. Anything the server sends that is not `assistant` is a user turn. */
+    readonly role: "assistant" | "user";
+    /**
+     * `partial` is an in-progress guess that will be superseded; `final` is
+     * settled text. A consumer typically overwrites on partial and appends on
+     * final. Until the server emits interim results, every turn arrives `final`.
+     */
+    readonly transcriptType: "partial" | "final";
+    /** The spoken text. */
+    readonly transcript: string;
+    /** ISO-8601 timestamp the server attached to the turn, when it sent one. */
+    readonly timestamp?: string;
+}
+/**
+ * Any other message the server puts on the wire. Passed through verbatim rather
+ * than dropped, so a server that starts sending a new message type surfaces to
+ * consumers without an SDK release.
+ */
+export interface UnknownMessage {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+export type VoiceAgentMessage = TranscriptMessage | UnknownMessage;
+/** Payload of the `call-end` event. */
+export interface CallEndPayload {
+    /** Why the call ended. See endedReason.ts — these strings are a contract. */
+    readonly endedReason: EndedReason;
+    /** The platform call id, when one was assigned before the call ended. */
+    readonly callId?: string;
+}
+/** Payload of the `error` event. */
+export interface VoiceAgentErrorPayload {
+    /** A human-readable message safe to show a user. */
+    readonly message: string;
+    /**
+     * A stable code for programmatic handling. Prefer branching on this rather
+     * than on `message`, which is copy and may be reworded.
+     */
+    readonly code: VoiceAgentErrorCode;
+    /** The underlying cause, when there was one. */
+    readonly cause?: unknown;
+}
+export type VoiceAgentErrorCode = 
+/**
+ * The call was stopped before it connected. Reported ONLY as the rejection of
+ * the pending `start()`, never as an `error` event — a deliberate cancel is
+ * not a failure and must not surface to the user as one.
+ */
+"cancelled" | "missing-public-key" | "missing-agent-id" | "already-started" | "control-plane-failed" | "media-plane-failed" | "microphone-denied" | "connection-timeout" | "connection-failed" | "no-active-call" | "screen-share-failed";
+/**
+ * The event map. Handlers are typed by event name, so binding `call-end` and
+ * reading `payload.endedReason` type-checks without a cast.
+ */
+export interface VoiceAgentEventMap {
+    /** Media is flowing — the call is live. */
+    "call-start": () => void;
+    /** The call ended, cleanly or otherwise. Fires at most once per call. */
+    "call-end": (payload: CallEndPayload) => void;
+    /** The agent started speaking. */
+    "speech-start": () => void;
+    /** The agent stopped speaking. */
+    "speech-end": () => void;
+    /** A message from the server — most often a transcript turn. */
+    message: (message: VoiceAgentMessage) => void;
+    /**
+     * Something went wrong. Emitted INSTEAD of `call-end` when the failure
+     * happened before the call ever started, so a consumer never has to
+     * de-duplicate two notifications of the same failure.
+     */
+    error: (payload: VoiceAgentErrorPayload) => void;
+}
+export type VoiceAgentEventName = keyof VoiceAgentEventMap;

package/dist/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@loop-voice-agent/web` — browser SDK for the Loop Voice Agent platform.
+ *
+ * Start a voice call from a publishable key and an agent id:
+ *
+ * ```ts
+ * import { VoiceAgent } from "@loop-voice-agent/web";
+ *
+ * const client = new VoiceAgent(publishableKey, { baseUrl: "https://api.example.com" });
+ * client.on("message", (m) => { if (m.type === "transcript") append(m); });
+ * client.on("call-end", ({ endedReason }) => finish(endedReason));
+ * await client.start(agentId, { variables: { candidate_name: "Asha" } });
+ * ```
+ *
+ * The key is publishable by design — it is safe in a bundle because its
+ * authority is capped at starting a call and it only works from origins the
+ * tenant registered against it. The prompt, model and voice never reach the
+ * browser; the agent is an opaque id.
+ */
+export { VoiceAgent, VoiceAgentError } from "./client.js";
+export type { CallStatus, VoiceAgentOptions } from "./client.js";
+export type { CallContext, WebCallSession } from "./controlPlane.js";
+export { ControlPlaneError } from "./controlPlane.js";
+export { CLEAN_ENDED_REASONS, FAILED_ENDED_REASONS, isAbnormalEndedReason } from "./endedReason.js";
+export type { CleanEndedReason, EndedReason, FailedEndedReason } from "./endedReason.js";
+export { isTranscriptMessage } from "./messages.js";
+export type { CallEndPayload, TranscriptMessage, UnknownMessage, VoiceAgentErrorCode, VoiceAgentErrorPayload, VoiceAgentEventMap, VoiceAgentEventName, VoiceAgentMessage, } from "./events.js";

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * `@loop-voice-agent/web` — browser SDK for the Loop Voice Agent platform.
+ *
+ * Start a voice call from a publishable key and an agent id:
+ *
+ * ```ts
+ * import { VoiceAgent } from "@loop-voice-agent/web";
+ *
+ * const client = new VoiceAgent(publishableKey, { baseUrl: "https://api.example.com" });
+ * client.on("message", (m) => { if (m.type === "transcript") append(m); });
+ * client.on("call-end", ({ endedReason }) => finish(endedReason));
+ * await client.start(agentId, { variables: { candidate_name: "Asha" } });
+ * ```
+ *
+ * The key is publishable by design — it is safe in a bundle because its
+ * authority is capped at starting a call and it only works from origins the
+ * tenant registered against it. The prompt, model and voice never reach the
+ * browser; the agent is an opaque id.
+ */
+export { VoiceAgent, VoiceAgentError } from "./client.js";
+export { ControlPlaneError } from "./controlPlane.js";
+export { CLEAN_ENDED_REASONS, FAILED_ENDED_REASONS, isAbnormalEndedReason } from "./endedReason.js";
+export { isTranscriptMessage } from "./messages.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,11 @@
+import type { TranscriptMessage, VoiceAgentMessage } from "./events.js";
+/**
+ * Parse one data-channel frame into an event payload, or `null` to drop it.
+ *
+ * Dropped: non-JSON, non-objects, frames with no `type`, keep-alive frames, and
+ * transcript turns whose text is empty once trimmed — an empty turn would
+ * otherwise render as a blank bubble in a consumer's transcript view.
+ */
+export declare const decodeMessage: (raw: unknown) => VoiceAgentMessage | null;
+/** Whether a decoded message is a transcript turn. Exposed for consumers. */
+export declare const isTranscriptMessage: (m: VoiceAgentMessage) => m is TranscriptMessage;

package/dist/messages.js

@@ -0,0 +1,75 @@
+/**
+ * Decoding what arrives on the WebRTC data channel.
+ *
+ * The wire format is the server's, and it is NOT the shape consumers bind to:
+ * the server sends `{type, role, content, ts}` while the event surface exposes
+ * `{type, role, transcriptType, transcript, timestamp}`. That translation lives
+ * here rather than in the client, so the adaptation is one small pure function
+ * with its own tests instead of a branch buried in a socket callback.
+ *
+ * Everything is defensive. This data crosses a network boundary and is parsed
+ * from a string; a malformed frame must produce `null` and be dropped, never
+ * throw inside the data-channel handler and tear the call down.
+ */
+/** Frames that are transport bookkeeping, not content, and are never surfaced. */
+const CONTROL_FRAMES = new Set(["ping", "pong"]);
+const asRecord = (value) => typeof value === "object" && value !== null ? value : null;
+/**
+ * Parse one data-channel frame into an event payload, or `null` to drop it.
+ *
+ * Dropped: non-JSON, non-objects, frames with no `type`, keep-alive frames, and
+ * transcript turns whose text is empty once trimmed — an empty turn would
+ * otherwise render as a blank bubble in a consumer's transcript view.
+ */
+export const decodeMessage = (raw) => {
+    if (typeof raw !== "string")
+        return null;
+    const trimmed = raw.trim();
+    if (trimmed.length === 0 || CONTROL_FRAMES.has(trimmed))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    const frame = asRecord(parsed);
+    if (!frame || typeof frame.type !== "string")
+        return null;
+    if (frame.type === "transcript")
+        return decodeTranscript(frame);
+    // Anything else is forwarded verbatim, so a server that starts sending a new
+    // message type reaches consumers without an SDK release.
+    return frame;
+};
+const decodeTranscript = (frame) => {
+    // The server has used `content` since before this SDK existed; `transcript`
+    // is accepted too so the field can be renamed server-side without a flag day.
+    const text = typeof frame.content === "string" ? frame.content : frame.transcript;
+    if (typeof text !== "string")
+        return null;
+    const transcript = text.trim();
+    if (transcript.length === 0)
+        return null;
+    // Anything not explicitly `assistant` is a user turn. Consumers render the
+    // two differently, and mislabelling the agent as the user is far more
+    // confusing than the reverse, so the agent side requires an exact match.
+    const role = frame.role === "assistant" ? "assistant" : "user";
+    // Interim results are opt-in on the wire. A server that does not send
+    // `transcriptType` is sending settled text, so `final` is the safe default —
+    // treating unmarked turns as partial would make them vanish when the next
+    // turn arrived.
+    const transcriptType = frame.transcriptType === "partial" ? "partial" : "final";
+    const timestamp = typeof frame.ts === "string" ? frame.ts : undefined;
+    return {
+        type: "transcript",
+        role,
+        transcriptType,
+        transcript,
+        ...(timestamp ? { timestamp } : {}),
+    };
+};
+/** Whether a decoded message is a transcript turn. Exposed for consumers. */
+export const isTranscriptMessage = (m) => m.type === "transcript";
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,kFAAkF;AAClF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjD,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAkC,EAAE,CAClE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAY,EAA4B,EAAE;IACtE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAErE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE1D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAEhE,6EAA6E;IAC7E,yDAAyD;IACzD,OAAO,KAA0B,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,KAA8B,EAA4B,EAAE;IACpF,4EAA4E;IAC5E,8EAA8E;IAC9E,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAClF,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,2EAA2E;IAC3E,sEAAsE;IACtE,yEAAyE;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/D,sEAAsE;IACtE,6EAA6E;IAC7E,0EAA0E;IAC1E,gBAAgB;IAChB,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhF,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtE,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,cAAc;QACd,UAAU;QACV,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC;AACJ,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAoB,EAA0B,EAAE,CAClF,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC"}