@komaa/standin-sdk 0.1.0

package/dist/plugins/elevenlabs/handler.js

@@ -0,0 +1,419 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+import { toolSchemas } from "../../callTools.js";
+import { fetchPublicImage } from "../../fetch.js";
+import { logger } from "../../log.js";
+import { StartupBuffer } from "../../startup.js";
+import { DISPLAY_IMAGE_MIME_TYPES, MAX_IMAGE_BYTES, } from "../../vision.js";
+import { KeyframeStore } from "../../visionTools.js";
+import { AgentSocket, buildConversationInit, } from "./agent.js";
+import { elevenLabsConfigFromEnv } from "./config.js";
+/**
+ * Bounds on what a model may put in an emotion or a caption. These reach the
+ * avatar tile, and an unbounded string from a model is an unbounded string from
+ * whoever is steering it.
+ */
+const MAX_EMOTION_CHARS = 40;
+const MAX_CAPTION_CHARS = 200;
+const MAX_MODE_CHARS = 20;
+const IMAGE_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Caller audio and context that arrive while the conversation is still opening.
+ * Bounded: on a socket that never opens these would grow for the whole call.
+ */
+const MAX_PENDING_AUDIO = 200;
+const MAX_PENDING_CONTEXT = 20;
+/**
+ * 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 function clientTools() {
+    return toolSchemas("flat").map((tool) => {
+        if (tool.name !== "show_image")
+            return tool;
+        const parameters = tool.parameters;
+        return {
+            ...tool,
+            description: `${tool.description} You can give the image inline instead, ` +
+                "as 'dataBase64' with its 'mime'.",
+            parameters: {
+                ...parameters,
+                properties: {
+                    ...parameters.properties,
+                    dataBase64: {
+                        type: "string",
+                        description: "The image itself, base64 encoded. An alternative to 'url'.",
+                    },
+                    mime: {
+                        type: "string",
+                        description: `Required with dataBase64: one of ${DISPLAY_IMAGE_MIME_TYPES.join(", ")}.`,
+                    },
+                    durationMs: {
+                        type: "integer",
+                        description: "How long to leave it up, in milliseconds.",
+                    },
+                },
+                // Either form will do, so neither argument can be required.
+                required: [],
+            },
+        };
+    });
+}
+/** One Microsoft Teams call answered by one ElevenLabs agent. */
+export class ElevenLabsHandler {
+    #config;
+    #connect;
+    #call;
+    // Frames kept so a question about a slide already gone can still be
+    // answered. The store keeps nothing unless the call is recorded.
+    #keyframes = new KeyframeStore();
+    #agent;
+    #closed = false;
+    // Holds BOTH the caller's first words and the first context, so neither
+    // is lost while the provider is still connecting.
+    #pending = new StartupBuffer();
+    #pendingAudio = [];
+    // Audio already in flight when an interruption lands is audio the caller must
+    // never hear: the model stopped, and playing the tail would talk over the
+    // person who just interrupted.
+    #lastAudioEvent = 0;
+    #lastInterruptEvent = 0;
+    constructor(config, connect = AgentSocket.connect.bind(AgentSocket)) {
+        this.#config = config ?? elevenLabsConfigFromEnv();
+        this.#connect = connect;
+    }
+    /**
+     * Whether the call is being recorded, straight off the session.
+     *
+     * The server keeps this current from `session.start` and every later
+     * `recording.status`, so there is nothing to re-derive here.
+     */
+    #recording() {
+        return this.#call?.recordingActive ?? false;
+    }
+    // ---- the SDK seam -------------------------------------------------------
+    async onStart(session) {
+        this.#call = session;
+        const caller = session.start.caller;
+        let agent;
+        try {
+            agent = await this.#connect(this.#config, (message) => this.#onAgentMessage(message), (code, reason) => this.#onAgentClose(code, reason));
+        }
+        catch (err) {
+            logger.error(`standin: could not open the ElevenLabs conversation: ${String(err)}`);
+            await session.end("agent-unavailable");
+            return;
+        }
+        // The call can end DURING the connect above. Keeping a socket opened after
+        // teardown would leave a live, billed conversation with nothing on the
+        // other end of it.
+        if (this.#closed) {
+            await agent.aclose();
+            return;
+        }
+        this.#agent = agent;
+        agent.sendConversationInit(buildConversationInit({
+            dynamicVariables: {
+                caller_name: caller.displayName ?? "caller",
+                tenant_id: caller.tenantId ?? "unknown-tenant",
+                call_direction: session.start.direction,
+            },
+            firstMessage: this.#config.firstMessage,
+            environment: this.#config.environment,
+            // Per-person memory, and only when the person is actually identified.
+            userId: caller.aadId,
+            branchId: this.#config.agentBranchId,
+        }));
+        // Whatever arrived while the socket was opening. The "there are N people
+        // here, stay quiet" signal usually lands exactly in this window.
+        await this.#pending.release((pcm) => agent.sendAudioChunk(pcm.toString("base64")), (text) => agent.sendContextualUpdate(text));
+        if (this.#pending.dropped.audio || this.#pending.dropped.context) {
+            logger.info("standin: the caller outran the agent starting up; some early input was dropped");
+        }
+    }
+    /** The caller's voice, straight through. Both sides are PCM16 at 16 kHz. */
+    async onCallerAudio(pcm) {
+        const chunk = pcm.toString("base64");
+        const agent = this.#agent;
+        if (agent === undefined || !agent.isOpen) {
+            this.#pending.audio(pcm);
+            return;
+        }
+        agent.sendAudioChunk(chunk);
+    }
+    /**
+     * 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.
+     */
+    async onVideoFrame(frame) {
+        this.#keyframes.offer(frame, this.#call?.recordingActive ?? false);
+    }
+    /**
+     * Participant counts, key presses, recording changes. Sent as a contextual
+     * update, which ElevenLabs delivers WITHOUT interrupting mid-sentence.
+     */
+    async onContext(text) {
+        const agent = this.#agent;
+        if (agent === undefined || !agent.isOpen) {
+            this.#pending.context(text);
+            return;
+        }
+        agent.sendContextualUpdate(text);
+    }
+    /**
+     * StandIn is ending the call and wants this line spoken first. Delivered as a
+     * user turn, which interrupts whatever the agent was saying.
+     */
+    async onGoodbye(text) {
+        const agent = this.#agent;
+        if (agent === undefined || !agent.isOpen)
+            return;
+        this.#lastInterruptEvent = Math.max(this.#lastInterruptEvent, this.#lastAudioEvent);
+        agent.sendUserMessage(`[system: the call is ending. Say a brief goodbye now: "${text}"]`);
+    }
+    /** Close the conversation. Always runs exactly once. */
+    async aclose() {
+        this.#closed = true;
+        const agent = this.#agent;
+        this.#agent = undefined;
+        if (agent !== undefined) {
+            try {
+                await agent.aclose();
+            }
+            catch {
+                // Teardown must not throw: the slot is freed either way.
+            }
+        }
+    }
+    // ---- what ElevenLabs sends us -------------------------------------------
+    async #onAgentMessage(message) {
+        switch (message.type) {
+            case "audio":
+                await this.#onAgentAudio(message);
+                break;
+            case "interruption":
+                await this.#onInterruption(message);
+                break;
+            case "ping": {
+                const event = message.ping_event;
+                if (typeof event?.event_id === "number")
+                    this.#agent?.sendPong(event.event_id);
+                break;
+            }
+            case "client_tool_call": {
+                const call = message.client_tool_call;
+                if (typeof call?.tool_name === "string" &&
+                    typeof call.tool_call_id === "string") {
+                    void this.#onToolCall(call);
+                }
+                break;
+            }
+            case "user_transcript":
+            case "agent_response":
+                // Gated twice. A transcript in your logs is a recording of the caller,
+                // so it takes both an explicit opt-in AND the call being recorded.
+                if (this.#config.logTranscripts && this.#recording()) {
+                    logger.info(`standin: elevenlabs ${message.type}`);
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    async #onAgentAudio(message) {
+        const event = message.audio_event;
+        if (typeof event?.event_id !== "number" ||
+            typeof event.audio_base_64 !== "string")
+            return;
+        this.#lastAudioEvent = Math.max(this.#lastAudioEvent, event.event_id);
+        if (event.event_id <= this.#lastInterruptEvent) {
+            // Audio the model generated before it was interrupted, arriving after.
+            // Playing it is exactly the thing barge-in exists to stop.
+            return;
+        }
+        const pcm = Buffer.from(event.audio_base_64, "base64");
+        if (pcm.length === 0)
+            return;
+        await this.#call?.sendAudio(pcm);
+    }
+    async #onInterruption(message) {
+        const event = message.interruption_event;
+        if (typeof event?.event_id !== "number")
+            return;
+        this.#lastInterruptEvent = Math.max(this.#lastInterruptEvent, event.event_id);
+        // The only lever that un-sends audio StandIn already has buffered.
+        await this.#call?.cancelPlayback();
+    }
+    async #onAgentClose(code, reason) {
+        logger.info(`standin: the ElevenLabs conversation closed (${code} ${reason})`);
+        if (!this.#closed)
+            await this.#call?.end("agent-disconnected");
+    }
+    // ---- the agent's client tools -------------------------------------------
+    async #onToolCall(call) {
+        const name = call.tool_name;
+        const toolCallId = call.tool_call_id;
+        const params = (typeof call.parameters === "object" && call.parameters !== null
+            ? call.parameters
+            : {});
+        switch (name) {
+            case "end_call":
+                this.#reply(toolCallId, "the call is ending");
+                await this.#call?.end("agent-ended-call");
+                break;
+            case "express":
+                await this.#onExpress(toolCallId, params);
+                break;
+            case "show_image":
+                await this.#onShowImage(toolCallId, params);
+                break;
+            case "look":
+                await this.#onLook(toolCallId, params);
+                break;
+            case "look_back":
+                await this.#onLookBack(toolCallId, params);
+                break;
+            default:
+                this.#reply(toolCallId, `"${name}" is not a tool this plugin answers`, true);
+        }
+    }
+    async #onExpress(toolCallId, params) {
+        const emotion = typeof params.emotion === "string" ? params.emotion.trim() : "";
+        if (!emotion) {
+            this.#reply(toolCallId, "express needs an 'emotion'", true);
+            return;
+        }
+        try {
+            await this.#call?.express(emotion);
+        }
+        catch (err) {
+            // The bound lives where the message is built, so every plugin gets it.
+            // Read it back rather than throwing at the model.
+            this.#reply(toolCallId, String(err), true);
+            return;
+        }
+        this.#reply(toolCallId, `expressing ${emotion}`);
+    }
+    /** Put a picture on the bot's tile, from inline bytes or a URL. */
+    async #onShowImage(toolCallId, params) {
+        const call = this.#call;
+        if (call === undefined)
+            return;
+        try {
+            let dataBase64 = typeof params.dataBase64 === "string" ? params.dataBase64 : undefined;
+            let mime = typeof params.mime === "string" ? params.mime : undefined;
+            const url = typeof params.url === "string" ? params.url : undefined;
+            if (dataBase64 === undefined && url) {
+                // The URL came from the model, which is steered by whoever is on the
+                // call. The guard is what stops a crafted prompt reaching cloud
+                // metadata or anything else on your network.
+                const fetched = await fetchPublicImage(url, MAX_IMAGE_BYTES, IMAGE_FETCH_TIMEOUT_MS);
+                dataBase64 = fetched.bytes.toString("base64");
+                mime = fetched.mime;
+            }
+            if (!dataBase64 ||
+                !mime ||
+                !DISPLAY_IMAGE_MIME_TYPES.includes(mime)) {
+                throw new Error("show_image needs {dataBase64, mime} or {url}, and the image must be one of " +
+                    DISPLAY_IMAGE_MIME_TYPES.join(", "));
+            }
+            const duration = params.durationMs;
+            await call.displayImage(dataBase64, {
+                mime,
+                durationMs: typeof duration === "number" ? duration : undefined,
+                mode: typeof params.mode === "string"
+                    ? params.mode.slice(0, MAX_MODE_CHARS)
+                    : undefined,
+                caption: typeof params.caption === "string"
+                    ? params.caption.slice(0, MAX_CAPTION_CHARS)
+                    : undefined,
+            });
+            this.#reply(toolCallId, "the caller can see the image");
+        }
+        catch (err) {
+            // Tell the agent the truth. Claiming success would leave it talking about
+            // a picture the caller never saw.
+            this.#reply(toolCallId, `show_image failed: ${String(err)}`, true);
+        }
+    }
+    /**
+     * Look at what the caller is showing.
+     *
+     * The frame is uploaded to the conversation, which PERSISTS the caller's
+     * screen or face with ElevenLabs. That is why it takes the call being
+     * recorded: the caller has been told the call is being kept, and this is part
+     * of what is kept.
+     */
+    async #onLook(toolCallId, params) {
+        const call = this.#call;
+        const agent = this.#agent;
+        if (call === undefined || agent === undefined)
+            return;
+        const source = params.source;
+        const frame = call.latestVideoFrame(source === "camera" || source === "screenshare"
+            ? source
+            : undefined);
+        if (frame === undefined) {
+            this.#reply(toolCallId, "there is nothing to look at: the caller is not sharing their camera or screen", true);
+            return;
+        }
+        if (!this.#recording()) {
+            this.#reply(toolCallId, "cannot look: the Microsoft Teams call is not being recorded, and looking would " +
+                "store the caller's screen with a third party", true);
+            return;
+        }
+        await this.#attach(toolCallId, frame, params, "look");
+    }
+    /**
+     * Look at something the caller has already moved past.
+     *
+     * Only possible on a recorded call, because that is the only time frames are
+     * kept at all.
+     */
+    async #onLookBack(toolCallId, params) {
+        if (this.#call === undefined || this.#agent === undefined)
+            return;
+        const frames = this.#keyframes.recent();
+        if (frames.length === 0) {
+            this.#reply(toolCallId, this.#recording()
+                ? "nothing has been shown on this call yet"
+                : "I can only look back at earlier screens while the call is being recorded, " +
+                    "and nothing has been kept", true);
+            return;
+        }
+        await this.#attach(toolCallId, frames[frames.length - 1], params, "look_back");
+    }
+    /** Upload one frame into the conversation and tell the agent to read it. */
+    async #attach(toolCallId, frame, params, tool) {
+        const agent = this.#agent;
+        if (agent === undefined)
+            return;
+        const who = frame.participantName ??
+            (frame.source === "screenshare" ? "a participant" : "the caller");
+        const seeing = frame.source === "screenshare"
+            ? `screen shared by ${who}`
+            : `camera of ${who}`;
+        const question = typeof params.question === "string" && params.question.trim()
+            ? params.question.trim()
+            : "Describe what is visible.";
+        try {
+            await agent.attachImage(frame.data, frame.mime, `[live call frame: ${seeing}] ${question}`);
+            this.#reply(toolCallId, "the frame is attached; answer from what you can see");
+        }
+        catch (err) {
+            this.#reply(toolCallId, `${tool} failed: ${String(err)}`, true);
+        }
+    }
+    #reply(toolCallId, result, isError = false) {
+        this.#agent?.sendToolResult(toolCallId, result, isError);
+    }
+}
+//# sourceMappingURL=handler.js.map

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

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

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

@@ -0,0 +1,11 @@
+export { AgentSocket, buildConversationInit, type AgentMessage, type AgentPort, } from "./agent.js";
+export { elevenLabsConfigFromEnv, type ElevenLabsConfig } from "./config.js";
+export { ElevenLabsHandler, clientTools, type Connect } from "./handler.js";
+/**
+ * Answer Microsoft Teams calls with ElevenLabs until the process is interrupted.
+ *
+ * The configuration is read ONCE here rather than per call: a missing API key
+ * should stop the worker at startup, not surprise the first caller.
+ */
+export declare function serve(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/index.ts"],"names":[],"mappings":"AAkDA,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;GAKG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB3C"}

package/dist/plugins/elevenlabs/index.js

@@ -0,0 +1,72 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * Answer Microsoft Teams calls with an ElevenLabs agent.
+ *
+ * StandIn answers the Microsoft Teams call and dials this worker. This
+ * plugin answers that dial, opens one ElevenLabs agent conversation per
+ * call, and relays the audio both ways.
+ *
+ * Nothing to install beyond the SDK: ElevenLabs is reached over an ordinary
+ * WebSocket, so this plugin adds no dependency.
+ *
+ * ```bash
+ * npm install @komaa/standin-sdk
+ *
+ * export STANDIN_SECRET=...          # your StandIn connection secret
+ * export ELEVENLABS_API_KEY=...
+ * export ELEVENLABS_AGENT_ID=...
+ * npx standin-elevenlabs
+ * ```
+ *
+ * Configure the agent for `pcm_16000` audio in BOTH directions. That is exactly
+ * what StandIn speaks, so nothing resamples anything and the latency you measure
+ * is the model's, not the transport's. An agent set to anything else is refused
+ * at the first frame rather than producing a whole call of garbled audio.
+ *
+ * Give the agent the SDK's client tools and it can use the rest of the call, not
+ * just the voice channel: hanging up, the avatar's expression, putting a
+ * picture on the bot's tile, and looking at what the caller is sharing.
+ * ElevenLabs declares tools on the agent rather than over the wire, so
+ * {@link clientTools} returns the exact declarations to paste in.
+ *
+ * Drive it yourself inside your own worker instead:
+ *
+ * ```ts
+ * import { CallServer } from "@komaa/standin-sdk";
+ * import { ElevenLabsHandler } from "@komaa/standin-sdk/elevenlabs";
+ *
+ * const server = new CallServer({ handlerFactory: () => new ElevenLabsHandler() });
+ * await server.start();
+ * ```
+ *
+ * The Python twin is `standin.plugins.elevenlabs`.
+ */
+import { CallServer } from "../../index.js";
+import { ElevenLabsHandler } from "./handler.js";
+import { elevenLabsConfigFromEnv } from "./config.js";
+export { AgentSocket, buildConversationInit, } from "./agent.js";
+export { elevenLabsConfigFromEnv } from "./config.js";
+export { ElevenLabsHandler, clientTools } from "./handler.js";
+/**
+ * Answer Microsoft Teams calls with ElevenLabs until the process is interrupted.
+ *
+ * The configuration is read ONCE here rather than per call: a missing API key
+ * should stop the worker at startup, not surprise the first caller.
+ */
+export async function serve() {
+    const config = elevenLabsConfigFromEnv();
+    const server = new CallServer({
+        handlerFactory: () => new ElevenLabsHandler(config),
+    });
+    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/elevenlabs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/elevenlabs/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACL,WAAW,EACX,qBAAqB,GAGtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAyB,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;QAC5B,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC;KACpD,CAAC,CAAC;IACH,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/livekit/cli.d.ts

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

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

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

package/dist/plugins/livekit/cli.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/plugins/livekit/cli.ts"],"names":[],"mappings":";AACA,oCAAoC;AACpC,+BAA+B;AAE/B,4BAA4B;AAE5B,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/livekit/config.d.ts

@@ -0,0 +1,47 @@
+/** Everything the LiveKit plugin needs, resolved once per worker. */
+export interface LiveKitConfig {
+    /** `LIVEKIT_URL`, the `wss://` project URL. */
+    url: string;
+    /** `LIVEKIT_API_KEY`. */
+    apiKey: string;
+    /** `LIVEKIT_API_SECRET`. Never logged, never sent to StandIn. */
+    apiSecret: string;
+    /**
+     * `LIVEKIT_AGENT_NAME`: the name your worker registered with.
+     *
+     * Set it and each call explicitly dispatches that agent into its room. Leave
+     * it and the room creation itself assigns the job, which is LiveKit's
+     * automatic dispatch.
+     */
+    agentName?: string;
+    /** `LIVEKIT_ROOM_PREFIX`, prepended to the call id to name the room. */
+    roomPrefix: string;
+    /**
+     * `LIVEKIT_TILE_VIDEO`: `auto` (the default) relays whichever participant's
+     * video the room offers, `off` leaves StandIn's avatar there, and any other
+     * value is a participant IDENTITY to pin the relay to.
+     *
+     * Naming an identity matters when a separate avatar worker publishes the
+     * video and publish-on-behalf is not set: `auto` would relay whichever
+     * participant happened to publish first, which on a busy room is the wrong
+     * one.
+     *
+     * On by default because an agent that publishes video almost always means it
+     * for the caller to see. It needs the optional `sharp` package to encode
+     * frames; without it the relay stays off with one log line and the audio is
+     * unaffected.
+     */
+    tileVideo: "auto" | "off" | (string & {});
+    /**
+     * Delete the room at teardown, so the dispatched agent job ends at once.
+     *
+     * On by default. A job whose room still exists sits there until LiveKit's own
+     * empty-room timeout, which is minutes of a worker slot doing nothing.
+     */
+    deleteRoomOnEnd: boolean;
+    /** `LIVEKIT_TILE_VIDEO_FPS`, clamped by the SDK to a sane ceiling. */
+    tileVideoFps: number;
+}
+/** Read the configuration, or throw naming the variable that is missing. */
+export declare function liveKitConfigFromEnv(): LiveKitConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/livekit/config.ts"],"names":[],"mappings":"AAYA,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;OAcG;IACH,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AA4BD,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,aAAa,CAWpD"}

package/dist/plugins/livekit/config.js

@@ -0,0 +1,46 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * What the LiveKit plugin reads from the environment.
+ *
+ * The `LIVEKIT_*` names are LiveKit's own, which a worker deployment already
+ * has set. Nothing new to learn, and nothing duplicated.
+ */
+import { StandInError } from "../../errors.js";
+function required(name) {
+    const value = (process.env[name] ?? "").trim();
+    if (!value)
+        throw new StandInError(`${name} is required to answer calls with LiveKit`);
+    return value;
+}
+/**
+ * A whole positive number, or an error naming the variable.
+ *
+ * Fails loud rather than substituting the default. An operator who typed
+ * `LIVEKIT_TILE_VIDEO_FPS=twelve` is looking at a setting that is not the one in
+ * force, and silence is what makes that take an afternoon to find.
+ */
+function positiveInt(name, fallback) {
+    const raw = (process.env[name] ?? "").trim();
+    if (raw === "")
+        return fallback;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new StandInError(`${name} must be a whole number above zero, not ${JSON.stringify(raw)}`);
+    }
+    return value;
+}
+/** Read the configuration, or throw naming the variable that is missing. */
+export function liveKitConfigFromEnv() {
+    return {
+        url: required("LIVEKIT_URL"),
+        apiKey: required("LIVEKIT_API_KEY"),
+        apiSecret: required("LIVEKIT_API_SECRET"),
+        agentName: (process.env.LIVEKIT_AGENT_NAME ?? "").trim() || undefined,
+        roomPrefix: (process.env.LIVEKIT_ROOM_PREFIX ?? "").trim() || "msteams-",
+        deleteRoomOnEnd: (process.env.LIVEKIT_DELETE_ROOM ?? "").trim() !== "off",
+        tileVideo: (process.env.LIVEKIT_TILE_VIDEO ?? "").trim() || "auto",
+        tileVideoFps: positiveInt("LIVEKIT_TILE_VIDEO_FPS", 12),
+    };
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/plugins/livekit/config.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,+BAA+B;AAE/B;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAkD/C,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,CAAC,GAAG,IAAI,2CAA2C,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,QAAgB;IACjD,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,YAAY,CACpB,GAAG,IAAI,2CAA2C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC;QAC5B,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC;QACnC,SAAS,EAAE,QAAQ,CAAC,oBAAoB,CAAC;QACzC,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS;QACrE,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,UAAU;QACxE,eAAe,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK;QACzE,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,MAAM;QAClE,YAAY,EAAE,WAAW,CAAC,wBAAwB,EAAE,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC"}