@agent-native/toolkit 0.0.0-beta-20260819143124

package/dist/composer/pasted-text.spec.js.map

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

package/dist/composer/prompt-attachments.d.ts

@@ -0,0 +1,18 @@
+export interface AgentPromptAttachment {
+    name: string;
+    type?: string;
+    size?: number;
+    text?: string;
+    dataUrl?: string;
+}
+export declare function escapePromptAttachmentAttribute(value: string): string;
+export declare function formatPromptWithAttachments(prompt: string, attachments: readonly AgentPromptAttachment[]): string;
+export declare const AGENT_PROMPT_MAX_INLINE_TEXT_CHARS = 60000;
+export declare const AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES: number;
+export interface ReadAgentPromptAttachmentOptions {
+    maxInlineTextChars?: number;
+    maxInlineImageBytes?: number;
+}
+export declare function readAgentPromptAttachment(file: File, options?: ReadAgentPromptAttachmentOptions): Promise<AgentPromptAttachment>;
+export declare function isInlineableAgentPromptFile(file: File): boolean;
+//# sourceMappingURL=prompt-attachments.d.ts.map

package/dist/composer/prompt-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-attachments.d.ts","sourceRoot":"","sources":["../../src/composer/prompt-attachments.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,SAAS,qBAAqB,EAAE,GAC5C,MAAM,CAkBR;AAED,eAAO,MAAM,kCAAkC,QAAS,CAAC;AACzD,eAAO,MAAM,mCAAmC,QAAkB,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAK/D"}

package/dist/composer/prompt-attachments.js

@@ -0,0 +1,65 @@
+export function escapePromptAttachmentAttribute(value) {
+    return value.replace(/&/g, "&").replace(/"/g, """);
+}
+export function formatPromptWithAttachments(prompt, attachments) {
+    if (attachments.length === 0)
+        return prompt;
+    const attachmentText = attachments
+        .map((attachment) => {
+        const size = attachment.size ? ` size="${attachment.size}"` : "";
+        const type = attachment.type
+            ? ` type="${escapePromptAttachmentAttribute(attachment.type)}"`
+            : "";
+        if (attachment.dataUrl) {
+            return `<attached-image name="${escapePromptAttachmentAttribute(attachment.name)}"${type}${size}>\n${attachment.dataUrl}\n</attached-image>`;
+        }
+        const body = attachment.text?.trim() ||
+            "Selected in the UI. If this file is needed, inspect it from the workspace or ask for a readable copy.";
+        return `<attached-file name="${escapePromptAttachmentAttribute(attachment.name)}"${type}${size}>\n${body}\n</attached-file>`;
+    })
+        .join("\n\n");
+    return `${prompt.trimEnd()}\n\nAttached context:\n${attachmentText}`;
+}
+export const AGENT_PROMPT_MAX_INLINE_TEXT_CHARS = 60_000;
+export const AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES = 2 * 1024 * 1024;
+export async function readAgentPromptAttachment(file, options = {}) {
+    const maxInlineTextChars = options.maxInlineTextChars ?? AGENT_PROMPT_MAX_INLINE_TEXT_CHARS;
+    const maxInlineImageBytes = options.maxInlineImageBytes ?? AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES;
+    const attachment = {
+        name: file.name,
+        type: file.type || undefined,
+        size: file.size,
+    };
+    if (isInlineableAgentPromptFile(file) && file.size <= maxInlineTextChars) {
+        try {
+            attachment.text = await file.text();
+        }
+        catch {
+            // Keep the filename-only attachment if the browser cannot read it.
+        }
+    }
+    else if (file.type.startsWith("image/") &&
+        file.size <= maxInlineImageBytes) {
+        try {
+            attachment.dataUrl = await readFileAsDataUrl(file);
+        }
+        catch {
+            // Keep the filename-only attachment if the browser cannot read it.
+        }
+    }
+    return attachment;
+}
+export function isInlineableAgentPromptFile(file) {
+    if (file.type.startsWith("text/"))
+        return true;
+    return /\.(cjs|css|csv|html|js|json|jsx|md|mdx|mjs|sql|tsx?|txt|xml|yaml|yml)$/i.test(file.name);
+}
+function readFileAsDataUrl(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result ?? ""));
+        reader.onerror = () => reject(reader.error ?? new Error("Could not read file"));
+        reader.readAsDataURL(file);
+    });
+}
+//# sourceMappingURL=prompt-attachments.js.map

package/dist/composer/prompt-attachments.js.map

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

package/dist/composer/prompt-attachments.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-attachments.spec.d.ts.map

package/dist/composer/prompt-attachments.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-attachments.spec.d.ts","sourceRoot":"","sources":["../../src/composer/prompt-attachments.spec.ts"],"names":[],"mappings":""}

package/dist/composer/prompt-attachments.spec.js

@@ -0,0 +1,63 @@
+// @vitest-environment happy-dom
+import { describe, expect, it } from "vitest";
+import { escapePromptAttachmentAttribute, formatPromptWithAttachments, isInlineableAgentPromptFile, readAgentPromptAttachment, } from "./prompt-attachments.js";
+describe("prompt attachment helpers", () => {
+    it("inlines readable text files up to the configured limit", async () => {
+        const file = new File(["hello"], "notes.md", {
+            type: "text/markdown",
+        });
+        const attachment = await readAgentPromptAttachment(file);
+        expect(isInlineableAgentPromptFile(file)).toBe(true);
+        expect(attachment).toEqual({
+            name: "notes.md",
+            type: "text/markdown",
+            size: 5,
+            text: "hello",
+        });
+    });
+    it("falls back to filename metadata for oversized text files", async () => {
+        const file = new File(["hello"], "notes.md", {
+            type: "text/markdown",
+        });
+        const attachment = await readAgentPromptAttachment(file, {
+            maxInlineTextChars: 2,
+        });
+        expect(attachment).toEqual({
+            name: "notes.md",
+            type: "text/markdown",
+            size: 5,
+        });
+    });
+    it("inlines small image files as data URLs", async () => {
+        const file = new File(["fake image"], "screenshot.png", {
+            type: "image/png",
+        });
+        const attachment = await readAgentPromptAttachment(file);
+        expect(attachment.name).toBe("screenshot.png");
+        expect(attachment.type).toBe("image/png");
+        expect(attachment.dataUrl).toContain("data:image/png;base64,");
+    });
+    it("formats attachments with escaped XML attributes", () => {
+        const formatted = formatPromptWithAttachments("Review this", [
+            {
+                name: 'bad"name&.ts',
+                type: "text/plain",
+                size: 12,
+                text: "const x = 1;",
+            },
+            {
+                name: "shot.png",
+                type: "image/png",
+                size: 3,
+                dataUrl: "data:image/png;base64,abc",
+            },
+        ]);
+        expect(escapePromptAttachmentAttribute('a&"b')).toBe("a&"b");
+        expect(formatted).toContain("Attached context:");
+        expect(formatted).toContain('name="bad"name&.ts"');
+        expect(formatted).toContain("<attached-file");
+        expect(formatted).toContain("<attached-image");
+        expect(formatted).toContain("data:image/png;base64,abc");
+    });
+});
+//# sourceMappingURL=prompt-attachments.spec.js.map

package/dist/composer/prompt-attachments.spec.js.map

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

package/dist/composer/realtime-voice-audio-level.d.ts

@@ -0,0 +1,14 @@
+export interface RealtimeVoiceAudioLevels {
+    input: number;
+    output: number;
+}
+export interface RealtimeVoiceAudioLevelStore {
+    getSnapshot: () => RealtimeVoiceAudioLevels;
+    subscribe: (listener: () => void) => () => void;
+    set: (levels: RealtimeVoiceAudioLevels) => void;
+    reset: () => void;
+}
+export declare function normalizeRealtimeVoiceRms(samples: Uint8Array): number;
+export declare function smoothRealtimeVoiceLevel(previous: number, next: number): number;
+export declare function createRealtimeVoiceAudioLevelStore(): RealtimeVoiceAudioLevelStore;
+//# sourceMappingURL=realtime-voice-audio-level.d.ts.map

package/dist/composer/realtime-voice-audio-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,wBAAwB,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AASD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAUrE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED,wBAAgB,kCAAkC,IAAI,4BAA4B,CAwBjF"}

package/dist/composer/realtime-voice-audio-level.js

@@ -0,0 +1,48 @@
+const SILENT_LEVELS = { input: 0, output: 0 };
+function clampLevel(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+export function normalizeRealtimeVoiceRms(samples) {
+    if (samples.length === 0)
+        return 0;
+    let sumSquares = 0;
+    for (const sample of samples) {
+        const normalized = (sample - 128) / 128;
+        sumSquares += normalized * normalized;
+    }
+    const rms = Math.sqrt(sumSquares / samples.length);
+    const activeLevel = clampLevel((rms - 0.012) / 0.18);
+    return Math.sqrt(activeLevel);
+}
+export function smoothRealtimeVoiceLevel(previous, next) {
+    const target = clampLevel(next);
+    const factor = target > previous ? 0.55 : 0.2;
+    return clampLevel(previous + (target - previous) * factor);
+}
+export function createRealtimeVoiceAudioLevelStore() {
+    let snapshot = SILENT_LEVELS;
+    const listeners = new Set();
+    const set = (levels) => {
+        const next = {
+            input: clampLevel(levels.input),
+            output: clampLevel(levels.output),
+        };
+        if (next.input === snapshot.input && next.output === snapshot.output)
+            return;
+        snapshot = next;
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        set,
+        reset: () => set(SILENT_LEVELS),
+    };
+}
+//# sourceMappingURL=realtime-voice-audio-level.js.map

package/dist/composer/realtime-voice-audio-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.js","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.ts"],"names":[],"mappings":"AAYA,MAAM,aAAa,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAExE,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAmB;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACxC,UAAU,IAAI,UAAU,GAAG,UAAU,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,IAAY;IAEZ,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9C,OAAO,UAAU,CAAC,QAAQ,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,IAAI,QAAQ,GAAG,aAAa,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAExC,MAAM,GAAG,GAAG,CAAC,MAAgC,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;SAClC,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAClE,OAAO;QACT,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ;QAC3B,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,GAAG;QACH,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/composer/realtime-voice-audio-level.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realtime-voice-audio-level.spec.d.ts.map

package/dist/composer/realtime-voice-audio-level.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.spec.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.spec.ts"],"names":[],"mappings":""}

package/dist/composer/realtime-voice-audio-level.spec.js

@@ -0,0 +1,32 @@
+import { describe, expect, it, vi } from "vitest";
+import { createRealtimeVoiceAudioLevelStore, normalizeRealtimeVoiceRms, smoothRealtimeVoiceLevel, } from "./realtime-voice-audio-level.js";
+describe("realtime voice audio levels", () => {
+    it("normalizes silence and clamps loud audio", () => {
+        expect(normalizeRealtimeVoiceRms(new Uint8Array(32).fill(128))).toBe(0);
+        expect(normalizeRealtimeVoiceRms(new Uint8Array(32).fill(255))).toBe(1);
+    });
+    it("makes ordinary speech visibly responsive above the noise floor", () => {
+        const quietSpeech = Uint8Array.from({ length: 32 }, (_, index) => index % 2 === 0 ? 124 : 132);
+        const typicalSpeech = Uint8Array.from({ length: 32 }, (_, index) => index % 2 === 0 ? 120 : 136);
+        expect(normalizeRealtimeVoiceRms(quietSpeech)).toBeGreaterThan(0.3);
+        expect(normalizeRealtimeVoiceRms(typicalSpeech)).toBeGreaterThan(0.5);
+        expect(normalizeRealtimeVoiceRms(typicalSpeech)).toBeGreaterThan(normalizeRealtimeVoiceRms(quietSpeech));
+    });
+    it("attacks faster than it decays", () => {
+        expect(smoothRealtimeVoiceLevel(0, 1)).toBe(0.55);
+        expect(smoothRealtimeVoiceLevel(1, 0)).toBe(0.8);
+    });
+    it("notifies only on changes and resets both channels", () => {
+        const store = createRealtimeVoiceAudioLevelStore();
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.set({ input: 0.5, output: 0.25 });
+        store.set({ input: 0.5, output: 0.25 });
+        expect(listener).toHaveBeenCalledOnce();
+        expect(store.getSnapshot()).toEqual({ input: 0.5, output: 0.25 });
+        store.reset();
+        expect(store.getSnapshot()).toEqual({ input: 0, output: 0 });
+        expect(listener).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=realtime-voice-audio-level.spec.js.map

package/dist/composer/realtime-voice-audio-level.spec.js.map

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

package/dist/composer/realtime-voice-transcript.d.ts

@@ -0,0 +1,26 @@
+export type RealtimeVoiceTranscriptRole = "user" | "assistant";
+export interface RealtimeVoiceTranscriptMessage {
+    id: string;
+    threadId: string;
+    role: RealtimeVoiceTranscriptRole;
+    text: string;
+    createdAt: string;
+}
+export interface RealtimeVoiceTranscriptSink {
+    threadId: string;
+    active: boolean;
+    append: (message: RealtimeVoiceTranscriptMessage) => boolean;
+}
+export interface RealtimeVoiceTranscriptRegistry {
+    activeThreadId: () => string | undefined;
+    publish: (message: RealtimeVoiceTranscriptMessage) => void;
+    register: (sink: RealtimeVoiceTranscriptSink) => () => void;
+    pendingCount: () => number;
+}
+export declare function appendRealtimeVoiceTranscriptToRepository(value: unknown, transcript: RealtimeVoiceTranscriptMessage): {
+    appended: boolean;
+    repository: Record<string, unknown>;
+};
+export declare function createRealtimeVoiceTranscriptRegistry(): RealtimeVoiceTranscriptRegistry;
+export declare const realtimeVoiceTranscriptRegistry: RealtimeVoiceTranscriptRegistry;
+//# sourceMappingURL=realtime-voice-transcript.d.ts.map

package/dist/composer/realtime-voice-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-transcript.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-transcript.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/D,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,2BAA2B,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,MAAM,IAAI,CAAC;IAC5D,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,8BAA8B,GACzC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA6C5D;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,CAyDvF;AAED,eAAO,MAAM,+BAA+B,iCACH,CAAC"}

package/dist/composer/realtime-voice-transcript.js

@@ -0,0 +1,103 @@
+export function appendRealtimeVoiceTranscriptToRepository(value, transcript) {
+    const repository = value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+    const messages = Array.isArray(repository.messages)
+        ? [...repository.messages]
+        : [];
+    const duplicate = messages.some((entry) => {
+        if (!entry || typeof entry !== "object")
+            return false;
+        const record = entry;
+        const message = record.message && typeof record.message === "object"
+            ? record.message
+            : record;
+        return message.id === transcript.id;
+    });
+    if (duplicate)
+        return { appended: false, repository };
+    const parentId = typeof repository.headId === "string" ? repository.headId : null;
+    const createdAt = new Date(transcript.createdAt);
+    const message = {
+        id: transcript.id,
+        role: transcript.role,
+        content: [{ type: "text", text: transcript.text }],
+        createdAt: Number.isNaN(createdAt.getTime()) ? new Date() : createdAt,
+        metadata: {
+            custom: {
+                source: "realtime-voice",
+            },
+        },
+        ...(transcript.role === "assistant"
+            ? { status: { type: "complete", reason: "stop" } }
+            : {}),
+    };
+    return {
+        appended: true,
+        repository: {
+            ...repository,
+            messages: [...messages, { message, parentId }],
+            headId: transcript.id,
+        },
+    };
+}
+export function createRealtimeVoiceTranscriptRegistry() {
+    const sinks = new Map();
+    const pending = new Map();
+    const delivered = new Set();
+    let order = 0;
+    const flush = () => {
+        for (const [id, message] of pending) {
+            let consumed = false;
+            for (const sink of sinks.values()) {
+                if (sink.threadId !== message.threadId)
+                    continue;
+                try {
+                    consumed = sink.append(message) || consumed;
+                }
+                catch {
+                    // Keep the completed transcript queued until the chat can import it.
+                }
+            }
+            if (!consumed)
+                continue;
+            pending.delete(id);
+            delivered.add(id);
+            if (delivered.size > 1_000) {
+                const oldest = delivered.values().next().value;
+                if (typeof oldest === "string")
+                    delivered.delete(oldest);
+            }
+        }
+    };
+    return {
+        activeThreadId() {
+            let active;
+            for (const sink of sinks.values()) {
+                if (!sink.active || (active && sink.order <= active.order))
+                    continue;
+                active = sink;
+            }
+            return active?.threadId;
+        },
+        publish(message) {
+            const id = message.id.trim();
+            const threadId = message.threadId.trim();
+            const text = message.text.trim();
+            if (!id || !threadId || !text || delivered.has(id) || pending.has(id)) {
+                return;
+            }
+            pending.set(id, { ...message, id, threadId, text });
+            flush();
+        },
+        register(sink) {
+            const token = Symbol("realtime-voice-transcript-sink");
+            sinks.set(token, { ...sink, order: ++order });
+            flush();
+            return () => sinks.delete(token);
+        },
+        pendingCount: () => pending.size,
+    };
+}
+export const realtimeVoiceTranscriptRegistry = createRealtimeVoiceTranscriptRegistry();
+//# sourceMappingURL=realtime-voice-transcript.js.map

package/dist/composer/realtime-voice-transcript.js.map

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

package/dist/composer/realtime-voice-transcript.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realtime-voice-transcript.spec.d.ts.map

package/dist/composer/realtime-voice-transcript.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-transcript.spec.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-transcript.spec.ts"],"names":[],"mappings":""}

package/dist/composer/realtime-voice-transcript.spec.js

@@ -0,0 +1,76 @@
+import { describe, expect, it, vi } from "vitest";
+import { appendRealtimeVoiceTranscriptToRepository, createRealtimeVoiceTranscriptRegistry, } from "./realtime-voice-transcript.js";
+function transcript(overrides = {}) {
+    return {
+        id: "voice-1",
+        threadId: "thread-1",
+        role: "user",
+        text: "Open sources",
+        createdAt: "2026-07-10T20:00:00.000Z",
+        ...overrides,
+    };
+}
+describe("realtime voice transcript registry", () => {
+    it("captures the latest active thread and buffers until its sink mounts", () => {
+        const registry = createRealtimeVoiceTranscriptRegistry();
+        registry.register({
+            threadId: "thread-old",
+            active: true,
+            append: vi.fn(() => true),
+        });
+        registry.register({
+            threadId: "thread-1",
+            active: true,
+            // Simulate the chat surface being selected but not yet ready to apply
+            // the completed transcript. The registry must retain it for the sink
+            // that mounts once the surface is ready.
+            append: vi.fn(() => false),
+        });
+        expect(registry.activeThreadId()).toBe("thread-1");
+        registry.publish(transcript());
+        expect(registry.pendingCount()).toBe(1);
+        const append = vi.fn(() => true);
+        registry.register({ threadId: "thread-1", active: false, append });
+        expect(append).toHaveBeenCalledOnce();
+        expect(registry.pendingCount()).toBe(0);
+    });
+    it("deduplicates completed provider transcript events", () => {
+        const registry = createRealtimeVoiceTranscriptRegistry();
+        const append = vi.fn(() => true);
+        registry.register({ threadId: "thread-1", active: true, append });
+        registry.publish(transcript());
+        registry.publish(transcript());
+        expect(append).toHaveBeenCalledOnce();
+    });
+});
+describe("appendRealtimeVoiceTranscriptToRepository", () => {
+    it("links completed user and assistant messages without starting a run", () => {
+        const first = appendRealtimeVoiceTranscriptToRepository({}, transcript());
+        const second = appendRealtimeVoiceTranscriptToRepository(first.repository, transcript({
+            id: "voice-2",
+            role: "assistant",
+            text: "Opening Sources.",
+        }));
+        expect(second.repository.headId).toBe("voice-2");
+        expect(second.repository.messages).toMatchObject([
+            {
+                parentId: null,
+                message: {
+                    id: "voice-1",
+                    role: "user",
+                    metadata: { custom: { source: "realtime-voice" } },
+                },
+            },
+            {
+                parentId: "voice-1",
+                message: {
+                    id: "voice-2",
+                    role: "assistant",
+                    status: { type: "complete", reason: "stop" },
+                },
+            },
+        ]);
+        expect(appendRealtimeVoiceTranscriptToRepository(second.repository, transcript({ id: "voice-2" })).appended).toBe(false);
+    });
+});
+//# sourceMappingURL=realtime-voice-transcript.spec.js.map

package/dist/composer/realtime-voice-transcript.spec.js.map

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