@komaa/standin-sdk 0.1.0

package/dist/plugins/echo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/echo/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;;;GAMG;AACH,qBAAa,WAAW;;IAGhB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK7C;AAED,qEAAqE;AACrE,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAa3C"}

package/dist/plugins/echo/index.js

@@ -0,0 +1,61 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * The smallest StandIn plugin that answers a real Microsoft Teams call.
+ *
+ * Copy this directory to start a new plugin. It has no dependency beyond
+ * the SDK core and it works: call the number, talk, and hear yourself back. That
+ * makes it a useful thing to run before you suspect your own agent - if the echo
+ * answers, your secret, your tunnel and your StandIn identity are all correct.
+ *
+ * ```bash
+ * npm install @komaa/standin-sdk
+ * STANDIN_SECRET=... npx standin-echo
+ * ```
+ *
+ * To make it a real plugin, replace {@link EchoHandler.onCallerAudio} with
+ * your framework's agent loop. Everything else here is the shape every
+ * plugin keeps.
+ *
+ * The Python twin of this file is `standin.plugins.echo`; the two are the
+ * same handler with the same method names in each language's casing.
+ */
+import { CallServer } from "../../index.js";
+/**
+ * One instance per call. Sends the caller's own voice back to them.
+ *
+ * A handler implements only what it needs: the SDK treats every callback as
+ * optional, so this class defines three of the five and the other two are
+ * no-ops. Nothing extends anything.
+ */
+export class EchoHandler {
+    #call;
+    async onStart(session) {
+        this.#call = session;
+        console.info(`call ${session.callId} from ${session.start.caller.displayName ?? "unknown"}`);
+    }
+    async onCallerAudio(pcm) {
+        // Your agent goes here. PCM16, 16 kHz, mono, little-endian - the same format
+        // sendAudio expects back.
+        await this.#call?.sendAudio(pcm);
+    }
+    async onGoodbye(text) {
+        // StandIn is ending the call and wants this line spoken first. A real plugin
+        // would interrupt the agent and say it.
+        console.info(`goodbye: ${text}`);
+    }
+}
+/** Answer Microsoft Teams calls until the process is interrupted. */
+export async function serve() {
+    const server = new CallServer({ handlerFactory: () => new EchoHandler() });
+    await server.start();
+    await new Promise((resolve) => {
+        const stop = () => {
+            resolve();
+        };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    await server.aclose();
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/echo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/echo/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAoB,MAAM,gBAAgB,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,KAAK,CAA0B;IAE/B,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,OAAO,CAAC,IAAI,CACV,QAAQ,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,6EAA6E;QAC7E,0BAA0B;QAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,6EAA6E;QAC7E,wCAAwC;QACxC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;AACxB,CAAC"}

package/dist/plugins/elevenlabs/agent.d.ts

@@ -0,0 +1,72 @@
+import type { ElevenLabsConfig } from "./config.js";
+/** A frame from ElevenLabs. Only `type` is guaranteed. */
+export type AgentMessage = Record<string, unknown> & {
+    type: string;
+};
+/** The conversation_initiation_client_data that opens a call. */
+export interface ConversationInit {
+    dynamicVariables: Record<string, string>;
+    firstMessage?: string;
+    environment?: string;
+    /**
+     * A stable per-person id, which is what ElevenLabs keys analytics and memory
+     * on. Pass the caller's directory id when there is one and NOTHING when there
+     * is not: a shared default would make every anonymous caller the same person,
+     * and one caller would read another's conversation memory.
+     */
+    userId?: string;
+    branchId?: string;
+}
+/** Build the message that opens a conversation. */
+export declare function buildConversationInit(init: ConversationInit): Record<string, unknown>;
+/** Mint a short-lived signed URL. Expires in about fifteen minutes, so never cached. */
+export declare function getSignedUrl(config: ElevenLabsConfig): Promise<string>;
+/**
+ * Upload one frame to the live conversation and return its file id.
+ *
+ * This PERSISTS the caller's screen or face with ElevenLabs, which is why the
+ * handler gates it on the call being recorded.
+ */
+export declare function uploadConversationFile(config: ElevenLabsConfig, conversationId: string, data: Buffer, mime: string): Promise<string>;
+/** What the relay needs from an agent connection. Tests substitute their own. */
+export interface AgentPort {
+    readonly isOpen: boolean;
+    conversationId: string | undefined;
+    sendConversationInit(init: Record<string, unknown>): void;
+    sendAudioChunk(pcmBase64: string): void;
+    sendPong(eventId: number): void;
+    sendContextualUpdate(text: string): void;
+    sendUserMessage(text: string): void;
+    sendToolResult(toolCallId: string, result: string, isError?: boolean): void;
+    attachImage(data: Buffer, mime: string, question: string): Promise<void>;
+    aclose(): Promise<void>;
+}
+/** The socket to one ElevenLabs agent conversation. */
+export declare class AgentSocket implements AgentPort {
+    #private;
+    conversationId: string | undefined;
+    private constructor();
+    /**
+     * Open the socket, retrying once with a fresh signed URL.
+     *
+     * Signed URLs are short-lived and minting one can fail transiently. One retry
+     * costs a quarter of a second and saves a caller from a dropped call because a
+     * URL expired between minting and connecting.
+     */
+    static connect(config: ElevenLabsConfig, onMessage: (message: AgentMessage) => void | Promise<void>, onClose: (code: number, reason: string) => void | Promise<void>): Promise<AgentSocket>;
+    get isOpen(): boolean;
+    /** Caller audio, forwarded verbatim. This message carries no `type`. */
+    sendAudioChunk(pcmBase64: string): void;
+    sendConversationInit(init: Record<string, unknown>): void;
+    sendPong(eventId: number): void;
+    /** Background context that must NOT interrupt the agent mid-sentence. */
+    sendContextualUpdate(text: string): void;
+    /** An interrupting user turn, which is how a goodbye gets spoken. */
+    sendUserMessage(text: string): void;
+    sendToolResult(toolCallId: string, result: string, isError?: boolean): void;
+    /** Upload a frame and inject it as a multimodal user turn. */
+    attachImage(data: Buffer, mime: string, question: string): Promise<void>;
+    /** Close the conversation. Safe to call twice. */
+    aclose(): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/plugins/elevenlabs/agent.d.ts.map

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

package/dist/plugins/elevenlabs/agent.js

@@ -0,0 +1,305 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * One ElevenLabs agent conversation, as a socket.
+ *
+ * Deliberately thin: this file opens the socket, parses frames, and offers send
+ * helpers. What any of it MEANS to a Microsoft Teams call lives in `handler.ts`,
+ * so the wire and the relay can be read, and tested, one at a time.
+ *
+ * The contract that makes this plugin simple is the audio format. An agent
+ * configured for `pcm_16000` in both directions speaks exactly what StandIn
+ * speaks, so nothing here resamples anything. An agent configured for something
+ * else would produce a whole call of garbled audio, so it is caught at the
+ * metadata frame and refused.
+ *
+ * The Python twin is `standin.plugins.elevenlabs.agent`.
+ */
+import { WebSocket } from "ws";
+import { logger } from "../../log.js";
+/** Bound on the REST calls and the socket open, so a hung API cannot wedge onStart. */
+const REST_TIMEOUT_MS = 10_000;
+/**
+ * ElevenLabs pings roughly every ten seconds, so a minute of silence means the
+ * peer is gone without a close frame.
+ */
+const RECEIVE_TIMEOUT_MS = 60_000;
+/** A stalled socket must not accumulate an unbounded queue of caller audio. */
+const MAX_SEND_BUFFER_BYTES = 1024 * 1024;
+/** The only audio format this plugin speaks, and what StandIn speaks. */
+const REQUIRED_FORMAT = "pcm_16000";
+const EXT_FOR_MIME = {
+    "image/jpeg": "jpg",
+    "image/jpg": "jpg",
+    "image/png": "png",
+    "image/webp": "webp",
+    "image/gif": "gif",
+};
+/** Build the message that opens a conversation. */
+export function buildConversationInit(init) {
+    const message = {
+        type: "conversation_initiation_client_data",
+        dynamic_variables: init.dynamicVariables,
+    };
+    // Overrides are rejected unless the agent's own security settings allow them,
+    // so send one only when it was actually configured.
+    if (init.firstMessage) {
+        message.conversation_config_override = {
+            agent: { first_message: init.firstMessage },
+        };
+    }
+    if (init.environment)
+        message.environment = init.environment;
+    if (init.userId)
+        message.user_id = init.userId;
+    if (init.branchId)
+        message.branch_id = init.branchId;
+    return message;
+}
+async function withTimeout(promise, ms, what) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`${what} timed out after ${ms}ms`)), ms);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** Mint a short-lived signed URL. Expires in about fifteen minutes, so never cached. */
+export async function getSignedUrl(config) {
+    const params = new URLSearchParams({ agent_id: config.agentId });
+    if (config.environment)
+        params.set("environment", config.environment);
+    const url = `https://${config.host}/v1/convai/conversation/get-signed-url?${params}`;
+    const response = await withTimeout(fetch(url, { headers: { "xi-api-key": config.apiKey } }), REST_TIMEOUT_MS, "get-signed-url");
+    if (!response.ok)
+        throw new Error(`get-signed-url failed: HTTP ${response.status}`);
+    const body = (await response.json());
+    if (!body.signed_url)
+        throw new Error("get-signed-url returned no signed_url");
+    return body.signed_url;
+}
+/**
+ * Upload one frame to the live conversation and return its file id.
+ *
+ * This PERSISTS the caller's screen or face with ElevenLabs, which is why the
+ * handler gates it on the call being recorded.
+ */
+export async function uploadConversationFile(config, conversationId, data, mime) {
+    const ext = EXT_FOR_MIME[mime.toLowerCase()];
+    if (!ext)
+        throw new Error(`unsupported image type for upload: ${mime}`);
+    const form = new FormData();
+    form.append("file", new Blob([new Uint8Array(data)], { type: mime }), `frame.${ext}`);
+    const url = `https://${config.host}/v1/convai/conversations/${encodeURIComponent(conversationId)}/files`;
+    const response = await withTimeout(fetch(url, {
+        method: "POST",
+        body: form,
+        headers: { "xi-api-key": config.apiKey },
+    }), REST_TIMEOUT_MS, "file upload");
+    if (!response.ok)
+        throw new Error(`file upload failed: HTTP ${response.status}`);
+    const body = (await response.json());
+    if (!body.file_id)
+        throw new Error("file upload returned no file_id");
+    return body.file_id;
+}
+/** The socket to one ElevenLabs agent conversation. */
+export class AgentSocket {
+    #config;
+    #ws;
+    #idleTimer;
+    #pendingBytes = 0;
+    #dropped = 0;
+    #lastDropWarning = 0;
+    #closedByUs = false;
+    conversationId;
+    constructor(config) {
+        this.#config = config;
+    }
+    /**
+     * Open the socket, retrying once with a fresh signed URL.
+     *
+     * Signed URLs are short-lived and minting one can fail transiently. One retry
+     * costs a quarter of a second and saves a caller from a dropped call because a
+     * URL expired between minting and connecting.
+     */
+    static async connect(config, onMessage, onClose) {
+        const socket = new AgentSocket(config);
+        try {
+            await socket.#open();
+        }
+        catch (err) {
+            logger.warn(`standin: ElevenLabs connect failed (${String(err)}); retrying with a fresh URL`);
+            await new Promise((resolve) => setTimeout(resolve, 250));
+            await socket.#open();
+        }
+        socket.#listen(onMessage, onClose);
+        return socket;
+    }
+    async #open() {
+        const signedUrl = await getSignedUrl(this.#config);
+        const ws = new WebSocket(signedUrl, { maxPayload: 16 * 1024 * 1024 });
+        await withTimeout(new Promise((resolve, reject) => {
+            ws.once("open", resolve);
+            ws.once("error", reject);
+        }), REST_TIMEOUT_MS, "the ElevenLabs socket open");
+        this.#ws = ws;
+    }
+    #listen(onMessage, onClose) {
+        const ws = this.#ws;
+        if (ws === undefined)
+            return;
+        let closeReason = "";
+        const armIdle = () => {
+            if (this.#idleTimer)
+                clearTimeout(this.#idleTimer);
+            this.#idleTimer = setTimeout(() => {
+                closeReason = "receive-timeout";
+                ws.terminate();
+            }, RECEIVE_TIMEOUT_MS);
+            this.#idleTimer.unref?.();
+        };
+        armIdle();
+        ws.on("message", (raw) => {
+            armIdle();
+            let message;
+            try {
+                message = JSON.parse(raw.toString());
+            }
+            catch {
+                logger.warn("standin: ElevenLabs sent an unparseable frame; dropping");
+                return;
+            }
+            if (typeof message !== "object" || message === null)
+                return;
+            const typed = message;
+            if (typeof typed.type !== "string")
+                return;
+            if (typed.type === "conversation_initiation_metadata" &&
+                !this.#readMetadata(typed)) {
+                closeReason = "audio-format-mismatch";
+                void this.aclose();
+                return;
+            }
+            // A handler error must never escape and kill the relay for the call.
+            void (async () => {
+                try {
+                    await onMessage(typed);
+                }
+                catch (err) {
+                    logger.error(`standin: handling ElevenLabs ${typed.type} failed: ${String(err)}`);
+                }
+            })();
+        });
+        ws.on("close", (code, reason) => {
+            if (this.#idleTimer)
+                clearTimeout(this.#idleTimer);
+            void onClose(code, closeReason || reason.toString());
+        });
+        ws.on("error", (err) => {
+            logger.warn(`standin: the ElevenLabs socket failed: ${String(err)}`);
+        });
+    }
+    #readMetadata(message) {
+        const meta = (message.conversation_initiation_metadata_event ??
+            {});
+        if (typeof meta.conversation_id === "string")
+            this.conversationId = meta.conversation_id;
+        const formats = [
+            meta.agent_output_audio_format,
+            meta.user_input_audio_format,
+        ];
+        const wrong = formats.find((f) => typeof f === "string" && f !== REQUIRED_FORMAT);
+        if (wrong) {
+            // Refuse rather than log and carry on. The alternative is a call that
+            // stays up for its whole duration while the caller hears noise.
+            logger.error(`standin: the ElevenLabs agent audio is ${String(wrong)}, expected ${REQUIRED_FORMAT} ` +
+                "both ways; ending the call");
+            return false;
+        }
+        return true;
+    }
+    get isOpen() {
+        return this.#ws !== undefined && this.#ws.readyState === WebSocket.OPEN;
+    }
+    #send(message, droppable = false) {
+        const ws = this.#ws;
+        if (ws === undefined || ws.readyState !== WebSocket.OPEN)
+            return;
+        const payload = JSON.stringify(message);
+        if (droppable && this.#pendingBytes > MAX_SEND_BUFFER_BYTES) {
+            // Realtime audio is the only droppable thing here: control messages are
+            // tiny and load-bearing, so they always queue.
+            this.#dropped += 1;
+            const now = Date.now();
+            if (now - this.#lastDropWarning >= 1000) {
+                logger.warn(`standin: ElevenLabs send backpressure, dropped ${this.#dropped} chunk(s)`);
+                this.#lastDropWarning = now;
+                this.#dropped = 0;
+            }
+            return;
+        }
+        this.#pendingBytes += payload.length;
+        ws.send(payload, () => {
+            this.#pendingBytes -= payload.length;
+        });
+    }
+    /** Caller audio, forwarded verbatim. This message carries no `type`. */
+    sendAudioChunk(pcmBase64) {
+        this.#send({ user_audio_chunk: pcmBase64 }, true);
+    }
+    sendConversationInit(init) {
+        this.#send(init);
+    }
+    sendPong(eventId) {
+        this.#send({ type: "pong", event_id: eventId });
+    }
+    /** Background context that must NOT interrupt the agent mid-sentence. */
+    sendContextualUpdate(text) {
+        this.#send({ type: "contextual_update", text });
+    }
+    /** An interrupting user turn, which is how a goodbye gets spoken. */
+    sendUserMessage(text) {
+        this.#send({ type: "user_message", text });
+    }
+    sendToolResult(toolCallId, result, isError = false) {
+        this.#send({
+            type: "client_tool_result",
+            tool_call_id: toolCallId,
+            result,
+            is_error: isError,
+        });
+    }
+    /** Upload a frame and inject it as a multimodal user turn. */
+    async attachImage(data, mime, question) {
+        if (!this.conversationId)
+            throw new Error("the conversation has not started yet");
+        const fileId = await uploadConversationFile(this.#config, this.conversationId, data, mime);
+        this.#send({
+            type: "multimodal_message",
+            text: { type: "user_message", text: question },
+            file: { type: "file_input", file_id: fileId },
+        });
+    }
+    /** Close the conversation. Safe to call twice. */
+    async aclose() {
+        if (this.#closedByUs)
+            return;
+        this.#closedByUs = true;
+        if (this.#idleTimer)
+            clearTimeout(this.#idleTimer);
+        const ws = this.#ws;
+        if (ws !== undefined && ws.readyState === WebSocket.OPEN) {
+            ws.close(1000, "session-end");
+        }
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/plugins/elevenlabs/agent.js.map

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

package/dist/plugins/elevenlabs/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/plugins/elevenlabs/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/cli.ts"],"names":[],"mappings":""}

package/dist/plugins/elevenlabs/cli.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/** `npx standin-elevenlabs` */
+import { serve } from "./index.js";
+serve().catch((err) => {
+    console.error(String(err));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/plugins/elevenlabs/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/cli.ts"],"names":[],"mappings":";AACA,oCAAoC;AACpC,+BAA+B;AAE/B,+BAA+B;AAE/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/plugins/elevenlabs/config.d.ts

@@ -0,0 +1,27 @@
+/** Everything the ElevenLabs plugin needs, resolved once per worker. */
+export interface ElevenLabsConfig {
+    /** `ELEVENLABS_API_KEY`. Never logged, never sent to StandIn. */
+    apiKey: string;
+    /** `ELEVENLABS_AGENT_ID`: which agent answers the call. */
+    agentId: string;
+    /** `ELEVENLABS_HOST`. Must be an elevenlabs.io host. */
+    host: string;
+    /** `ELEVENLABS_ENVIRONMENT`, for agents deployed to a named environment. */
+    environment?: string;
+    /**
+     * `ELEVENLABS_FIRST_MESSAGE` overrides the agent's opening line, and only
+     * when the agent's own security settings allow the override.
+     */
+    firstMessage?: string;
+    /** `ELEVENLABS_AGENT_BRANCH_ID`, to answer with a specific branch. */
+    agentBranchId?: string;
+    /**
+     * `ELEVENLABS_LOG_TRANSCRIPTS`. Off by default, and gated a second time on
+     * the call being recorded: a transcript in your logs is a recording of the
+     * caller that they did not agree to.
+     */
+    logTranscripts: boolean;
+}
+/** Read the configuration, or throw naming the variable that is missing. */
+export declare function elevenLabsConfigFromEnv(): ElevenLabsConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/plugins/elevenlabs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/config.ts"],"names":[],"mappings":"AAoBA,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAeD,4EAA4E;AAC5E,wBAAgB,uBAAuB,IAAI,gBAAgB,CAiB1D"}

package/dist/plugins/elevenlabs/config.js

@@ -0,0 +1,42 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * What this plugin reads from the environment.
+ *
+ * Environment only, matching how the providers themselves expect their keys to
+ * arrive. Nothing is read at import: {@link elevenLabsConfigFromEnv} runs when
+ * you build a handler, so a worker that never uses ElevenLabs never needs an
+ * ElevenLabs key.
+ *
+ * One prefix, `ELEVENLABS_`. The standalone bridge this replaces had grown two,
+ * which is the sort of thing that survives only until somebody documents it.
+ */
+import { StandInError } from "../../errors.js";
+/** Refuse a host that is not ElevenLabs: the API key and agent id travel to it. */
+const ALLOWED_HOST_SUFFIX = ".elevenlabs.io";
+function required(name) {
+    const value = (process.env[name] ?? "").trim();
+    if (!value)
+        throw new StandInError(`${name} is required to answer calls with ElevenLabs`);
+    return value;
+}
+function optional(name) {
+    return (process.env[name] ?? "").trim() || undefined;
+}
+/** Read the configuration, or throw naming the variable that is missing. */
+export function elevenLabsConfigFromEnv() {
+    const host = (process.env.ELEVENLABS_HOST ?? "").trim() || "api.elevenlabs.io";
+    if (host !== "elevenlabs.io" && !host.endsWith(ALLOWED_HOST_SUFFIX)) {
+        throw new StandInError(`ELEVENLABS_HOST must be an elevenlabs.io host, got ${host}`);
+    }
+    return {
+        apiKey: required("ELEVENLABS_API_KEY"),
+        agentId: required("ELEVENLABS_AGENT_ID"),
+        host,
+        environment: optional("ELEVENLABS_ENVIRONMENT"),
+        firstMessage: optional("ELEVENLABS_FIRST_MESSAGE"),
+        agentBranchId: optional("ELEVENLABS_AGENT_BRANCH_ID"),
+        logTranscripts: process.env.ELEVENLABS_LOG_TRANSCRIPTS === "true",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/plugins/elevenlabs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/config.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+BAA+B;AAE/B;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,mFAAmF;AACnF,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AA2B7C,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,YAAY,CACpB,GAAG,IAAI,8CAA8C,CACtD,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AACvD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GACR,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,mBAAmB,CAAC;IACpE,IAAI,IAAI,KAAK,eAAe,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,YAAY,CACpB,sDAAsD,IAAI,EAAE,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC;QACtC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC;QACxC,IAAI;QACJ,WAAW,EAAE,QAAQ,CAAC,wBAAwB,CAAC;QAC/C,YAAY,EAAE,QAAQ,CAAC,0BAA0B,CAAC;QAClD,aAAa,EAAE,QAAQ,CAAC,4BAA4B,CAAC;QACrD,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,MAAM;KAClE,CAAC;AACJ,CAAC"}

package/dist/plugins/elevenlabs/handler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The relay: one Microsoft Teams call on one side, one ElevenLabs agent on the
+ * other.
+ *
+ * A plain `CallHandler`. Everything that is the same for every framework - the
+ * socket StandIn dials, the handshake, capacity, the frame loop, the watchdogs -
+ * belongs to `CallServer`, so what is left here is only what ElevenLabs needs.
+ *
+ * The client tools it answers are the SDK's call capabilities, so this agent can
+ * do what every other provider's can. ElevenLabs declares client tools on the
+ * agent rather than over the wire, so {@link clientTools} returns the exact
+ * declarations to paste in rather than leaving you to retype them.
+ *
+ * Two of them mean something slightly different here, and the difference is the
+ * reason they are not the SDK's implementations. `look` uploads the frame into
+ * the conversation for the model to read directly, which PERSISTS the caller's
+ * screen with ElevenLabs and is why it takes a recorded call. `show_image` also
+ * accepts inline bytes, which no other provider offers.
+ *
+ * The Python twin is `standin.plugins.elevenlabs.handler`, method for
+ * method.
+ */
+import type { CallHandler, CallSession } from "../../handler.js";
+import { type VideoFrame } from "../../vision.js";
+import { type AgentMessage, type AgentPort } from "./agent.js";
+import { type ElevenLabsConfig } from "./config.js";
+/**
+ * The client tools to declare on the ElevenLabs agent.
+ *
+ * ElevenLabs configures tools on the agent, not over the wire, so there is
+ * nothing this plugin can send. What it can do is hand you the declarations
+ * verbatim. The names and descriptions are the SDK's, so this agent is told
+ * about the same capabilities as every other provider's. `show_image` is
+ * widened here because ElevenLabs is the one provider that can take the bytes
+ * inline.
+ */
+export declare function clientTools(): Array<Record<string, unknown>>;
+/** How the handler reaches ElevenLabs. Replaceable so tests need no network. */
+export type Connect = (config: ElevenLabsConfig, onMessage: (message: AgentMessage) => void | Promise<void>, onClose: (code: number, reason: string) => void | Promise<void>) => Promise<AgentPort>;
+/** One Microsoft Teams call answered by one ElevenLabs agent. */
+export declare class ElevenLabsHandler implements CallHandler {
+    #private;
+    constructor(config?: ElevenLabsConfig, connect?: Connect);
+    onStart(session: CallSession): Promise<void>;
+    /** The caller's voice, straight through. Both sides are PCM16 at 16 kHz. */
+    onCallerAudio(pcm: Buffer): Promise<void>;
+    /**
+     * Keep a short history, so `look_back` has something to look at.
+     *
+     * The store itself refuses to keep anything unless the call is being
+     * recorded, which is the same promise `look` makes.
+     */
+    onVideoFrame(frame: VideoFrame): Promise<void>;
+    /**
+     * Participant counts, key presses, recording changes. Sent as a contextual
+     * update, which ElevenLabs delivers WITHOUT interrupting mid-sentence.
+     */
+    onContext(text: string): Promise<void>;
+    /**
+     * StandIn is ending the call and wants this line spoken first. Delivered as a
+     * user turn, which interrupts whatever the agent was saying.
+     */
+    onGoodbye(text: string): Promise<void>;
+    /** Close the conversation. Always runs exactly once. */
+    aclose(): Promise<void>;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/plugins/elevenlabs/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/handler.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoB7E;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAoC5D;AAED,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG,CACpB,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC1D,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC5D,OAAO,CAAC,SAAS,CAAC,CAAC;AAExB,iEAAiE;AACjE,qBAAa,iBAAkB,YAAW,WAAW;;gBAoBjD,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,GAAE,OAA+C;IAkBpD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDlD,4EAA4E;IACtE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5C,wDAAwD;IAClD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CA4T9B"}