@sumicom/quicksave 0.8.14 → 0.8.15

package/dist/ai/voiceIntermediary/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Voice intermediary ("AI coworker") — a daemon-side tool-calling LLM that
+ * interprets the coding agent's output and lets the user steer it by voice.
+ * Brain + TTS ride the same OpenAI-compatible endpoint as STT (VoiceConfig).
+ *
+ * See docs/references/quicksave-architecture.en.md (section two).
+ */
+export { VoiceIntermediaryManager } from './manager.js';
+export type { VoiceManagerBridge } from './manager.js';
+export { VOICE_AGENT_TOOLS, formatCardForBrain } from './tools.js';
+export type { CodingSessionBridge } from './tools.js';
+export { loadMemory, appendMemory } from './memory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/voiceIntermediary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/voiceIntermediary/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/ai/voiceIntermediary/index.js

@@ -0,0 +1,13 @@
+// SPDX-FileCopyrightText: 2026 King Young Technology
+// SPDX-License-Identifier: MIT
+/**
+ * Voice intermediary ("AI coworker") — a daemon-side tool-calling LLM that
+ * interprets the coding agent's output and lets the user steer it by voice.
+ * Brain + TTS ride the same OpenAI-compatible endpoint as STT (VoiceConfig).
+ *
+ * See docs/references/quicksave-architecture.en.md (section two).
+ */
+export { VoiceIntermediaryManager } from './manager.js';
+export { VOICE_AGENT_TOOLS, formatCardForBrain } from './tools.js';
+export { loadMemory, appendMemory } from './memory.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/voiceIntermediary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/voiceIntermediary/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,+BAA+B;AAE/B;;;;;;GAMG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/ai/voiceIntermediary/llm.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Minimal OpenAI-compatible chat-completions client for the voice intermediary
+ * brain. Raw `fetch` (no SDK) to `{baseUrl}/chat/completions`, mirroring the
+ * transcription client in `voiceTranscription.ts` — so STT, the brain, and TTS
+ * all ride the SAME cloud provider configured once in `VoiceConfig`.
+ */
+import type { VoiceConfig } from '@sumicom/quicksave-shared';
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** OpenAI chat message shape (request + response). */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
+export interface ToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ChatResult {
+    /** Assistant text to speak (may be empty when the turn is pure tool calls). */
+    content: string;
+    toolCalls: ToolCall[];
+}
+export declare class VoiceLlmError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/** `fetch` is injectable for tests. */
+export type FetchLike = typeof fetch;
+/**
+ * One chat-completions round. Returns the assistant's spoken text plus any tool
+ * calls it wants run. The caller drives the tool loop.
+ */
+export declare function chatCompletion(config: VoiceConfig, opts: {
+    messages: ChatMessage[];
+    tools: ToolSchema[];
+    signal?: AbortSignal;
+    fetchImpl?: FetchLike;
+}): Promise<ChatResult>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/ai/voiceIntermediary/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../../src/ai/voiceIntermediary/llm.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBAAzC,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAItD;AAYD,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IACJ,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,GACA,OAAO,CAAC,UAAU,CAAC,CA0CrB"}

package/dist/ai/voiceIntermediary/llm.js

@@ -0,0 +1,63 @@
+// SPDX-FileCopyrightText: 2026 King Young Technology
+// SPDX-License-Identifier: MIT
+export class VoiceLlmError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'VoiceLlmError';
+    }
+}
+function apiUrl(baseUrl, path) {
+    return `${baseUrl.trim().replace(/\/+$/, '')}${path}`;
+}
+function authHeaders(config) {
+    const headers = { 'Content-Type': 'application/json' };
+    if (config.apiKey.trim())
+        headers.Authorization = `Bearer ${config.apiKey.trim()}`;
+    return headers;
+}
+/**
+ * One chat-completions round. Returns the assistant's spoken text plus any tool
+ * calls it wants run. The caller drives the tool loop.
+ */
+export async function chatCompletion(config, opts) {
+    const model = config.agentModel?.trim();
+    if (!model)
+        throw new VoiceLlmError('No agentModel configured for the voice intermediary.');
+    const doFetch = opts.fetchImpl ?? fetch;
+    let res;
+    try {
+        res = await doFetch(apiUrl(config.baseUrl, '/chat/completions'), {
+            method: 'POST',
+            headers: authHeaders(config),
+            body: JSON.stringify({
+                model,
+                messages: opts.messages,
+                tools: opts.tools,
+                tool_choice: 'auto',
+            }),
+            signal: opts.signal,
+        });
+    }
+    catch (err) {
+        throw new VoiceLlmError('Could not reach the chat-completions endpoint.', err);
+    }
+    if (!res.ok) {
+        const detail = await res.text().catch(() => '');
+        throw new VoiceLlmError(`Chat completion failed (${res.status})${detail ? `: ${detail.slice(0, 200)}` : ''}`);
+    }
+    let data;
+    try {
+        data = await res.json();
+    }
+    catch (err) {
+        throw new VoiceLlmError('Chat-completions response was not valid JSON.', err);
+    }
+    const message = data?.choices?.[0]?.message;
+    return {
+        content: (message?.content ?? '').trim(),
+        toolCalls: Array.isArray(message?.tool_calls) ? message.tool_calls : [],
+    };
+}
+//# sourceMappingURL=llm.js.map

package/dist/ai/voiceIntermediary/llm.js.map

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

package/dist/ai/voiceIntermediary/manager.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Owns the per-session voice intermediaries and bridges them to the rest of the
+ * daemon. Emits a single `'event'` (sessionId, VoiceAgentEvent) that `run.ts`
+ * republishes on `/sessions/:sessionId/voice-agent`. Holds synthesized audio in
+ * a small LRU so the PWA can fetch bytes by id (metadata-first delivery).
+ */
+import { EventEmitter } from 'events';
+import type { CardEvent, CardStreamEnd, ClaudeUserInputRequestPayload, VoiceAgentPlaybackEventRequestPayload, VoiceConfig } from '@sumicom/quicksave-shared';
+import type { FetchLike } from './llm.js';
+import type { CodingSessionBridge } from './tools.js';
+import { type VoiceTurnMeta } from './session.js';
+/** The SessionManager surface the manager needs, beyond the tool bridge. */
+export type VoiceManagerBridge = CodingSessionBridge & {
+    getSessionCwd(sessionId: string): string | undefined;
+    isOpen(sessionId: string): boolean;
+};
+interface StoredAudio {
+    audio: Buffer;
+    mimeType: string;
+}
+export declare class VoiceIntermediaryManager extends EventEmitter {
+    private readonly bridge;
+    /** Injected for tests. */
+    private readonly fetchImpl?;
+    private readonly sessions;
+    private readonly audio;
+    constructor(bridge: VoiceManagerBridge, 
+    /** Injected for tests. */
+    fetchImpl?: FetchLike | undefined);
+    /**
+     * Attach (or refresh) the voice agent for a coding session. `active` is true
+     * only when a brain model is configured and the session is live — i.e. the
+     * agent will actually respond. Attaching an idle/mis-configured session is a
+     * no-op that reports `active:false` rather than erroring.
+     */
+    attach(sessionId: string, config: VoiceConfig): {
+        ok: boolean;
+        active: boolean;
+    };
+    detach(sessionId: string): void;
+    isAttached(sessionId: string): boolean;
+    handleUtterance(sessionId: string, text: string, meta?: VoiceTurnMeta): Promise<void>;
+    recordPlaybackEvent(event: VoiceAgentPlaybackEventRequestPayload): void;
+    /**
+     * Proactively nudge the agent when the coding side raises a permission prompt,
+     * so it can narrate "it wants to run X — shall I allow it?" without the user
+     * having to ask. No-op when no agent is attached to that session.
+     */
+    notifyPendingPermission(request: ClaudeUserInputRequestPayload): void;
+    recordCardEvent(event: CardEvent): void;
+    recordStreamEnd(result: CardStreamEnd): void;
+    notifyStreamEnd(result: CardStreamEnd): void;
+    getAudio(audioId: string): StoredAudio | null;
+    private storeAudio;
+    private emitEvent;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/ai/voiceIntermediary/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/ai/voiceIntermediary/manager.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,6BAA6B,EAE7B,qCAAqC,EACrC,WAAW,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAA4B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5E,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,qBAAa,wBAAyB,SAAQ,YAAY;IAKtD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAN7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;gBAGrC,MAAM,EAAE,kBAAkB;IAC3C,0BAA0B;IACT,SAAS,CAAC,EAAE,SAAS,YAAA;IAKxC;;;;;OAKG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IA2BhF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIhC,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,IAAI,CAAC;IAehB,mBAAmB,CAAC,KAAK,EAAE,qCAAqC,GAAG,IAAI;IAIvE;;;;OAIG;IACH,uBAAuB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI;IAUrE,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIvC,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAI5C,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAM5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAI7C,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/ai/voiceIntermediary/manager.js

@@ -0,0 +1,134 @@
+// SPDX-FileCopyrightText: 2026 King Young Technology
+// SPDX-License-Identifier: MIT
+/**
+ * Owns the per-session voice intermediaries and bridges them to the rest of the
+ * daemon. Emits a single `'event'` (sessionId, VoiceAgentEvent) that `run.ts`
+ * republishes on `/sessions/:sessionId/voice-agent`. Holds synthesized audio in
+ * a small LRU so the PWA can fetch bytes by id (metadata-first delivery).
+ */
+import { EventEmitter } from 'events';
+import { randomUUID } from 'crypto';
+import { VoiceIntermediarySession } from './session.js';
+/** Keep at most this many recent utterances of audio addressable for fetch. */
+const AUDIO_CACHE_CAP = 32;
+export class VoiceIntermediaryManager extends EventEmitter {
+    bridge;
+    fetchImpl;
+    sessions = new Map();
+    audio = new Map();
+    constructor(bridge, 
+    /** Injected for tests. */
+    fetchImpl) {
+        super();
+        this.bridge = bridge;
+        this.fetchImpl = fetchImpl;
+    }
+    /**
+     * Attach (or refresh) the voice agent for a coding session. `active` is true
+     * only when a brain model is configured and the session is live — i.e. the
+     * agent will actually respond. Attaching an idle/mis-configured session is a
+     * no-op that reports `active:false` rather than erroring.
+     */
+    attach(sessionId, config) {
+        const cwd = this.bridge.getSessionCwd(sessionId);
+        const live = this.bridge.isOpen(sessionId);
+        const active = !!config.agentModel?.trim() && !!cwd && live;
+        if (!cwd || !live)
+            return { ok: true, active: false };
+        const existing = this.sessions.get(sessionId);
+        if (existing) {
+            existing.updateConfig(config, cwd);
+            return { ok: true, active };
+        }
+        const session = new VoiceIntermediarySession({
+            sessionId,
+            cwd,
+            config,
+            bridge: this.bridge,
+            fetchImpl: this.fetchImpl,
+            callbacks: {
+                emit: (event) => this.emitEvent(sessionId, event),
+                storeAudio: (a, mime) => this.storeAudio(a, mime),
+            },
+        });
+        this.sessions.set(sessionId, session);
+        return { ok: true, active };
+    }
+    detach(sessionId) {
+        this.sessions.get(sessionId)?.close();
+        this.sessions.delete(sessionId);
+    }
+    isAttached(sessionId) {
+        return this.sessions.has(sessionId);
+    }
+    async handleUtterance(sessionId, text, meta = {}) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            this.emitEvent(sessionId, { kind: 'error', message: '語音同事尚未啟動，請先 attach。' });
+            return;
+        }
+        if (!session.hasBrain()) {
+            this.emitEvent(sessionId, { kind: 'error', message: '尚未設定語音 agent 模型（agentModel）。' });
+            return;
+        }
+        await session.handleUtterance(trimmed, meta);
+    }
+    recordPlaybackEvent(event) {
+        this.sessions.get(event.sessionId)?.recordPlaybackEvent(event);
+    }
+    /**
+     * Proactively nudge the agent when the coding side raises a permission prompt,
+     * so it can narrate "it wants to run X — shall I allow it?" without the user
+     * having to ask. No-op when no agent is attached to that session.
+     */
+    notifyPendingPermission(request) {
+        const session = this.sessions.get(request.sessionId);
+        if (!session || !session.hasBrain())
+            return;
+        const tool = request.toolName ?? request.title;
+        const detail = request.toolInput ? ` 內容：${safeBrief(request.toolInput)}` : '';
+        void session.notify(`目前工作需要權限執行「${tool}」。${detail} 這可能不可逆，先別自己決定——用講的說明並詢問使用者，得到口頭同意再用 respond_to_permission 回覆（request_id：${request.requestId}）。`);
+    }
+    recordCardEvent(event) {
+        this.sessions.get(event.sessionId)?.recordCardEvent(event);
+    }
+    recordStreamEnd(result) {
+        this.sessions.get(result.sessionId)?.recordStreamEnd(result);
+    }
+    notifyStreamEnd(result) {
+        const session = this.sessions.get(result.sessionId);
+        if (!session || !session.hasBrain())
+            return;
+        void session.notifyCodingTurnEnded(result);
+    }
+    getAudio(audioId) {
+        return this.audio.get(audioId) ?? null;
+    }
+    storeAudio(audio, mimeType) {
+        const id = randomUUID();
+        this.audio.set(id, { audio, mimeType });
+        while (this.audio.size > AUDIO_CACHE_CAP) {
+            const oldest = this.audio.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.audio.delete(oldest);
+        }
+        return id;
+    }
+    emitEvent(sessionId, event) {
+        this.emit('event', sessionId, event);
+    }
+}
+function safeBrief(input) {
+    try {
+        const s = JSON.stringify(input);
+        return s.length > 120 ? `${s.slice(0, 120)}…` : s;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/ai/voiceIntermediary/manager.js.map

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

package/dist/ai/voiceIntermediary/memory.d.ts

@@ -0,0 +1,22 @@
+export type MemorySection = 'preference' | 'decision' | 'fact' | 'note';
+export declare function globalMemoryPath(): string;
+export declare function workspaceMemoryPath(cwd: string): string;
+/**
+ * Load the combined memory text for a workspace, ready to splice into the
+ * brain's system prompt. Returns '' when nothing has been remembered yet so the
+ * caller can cheaply skip the section.
+ */
+export declare function loadMemory(cwd: string): Promise<string>;
+/**
+ * Append a remembered fact to the WORKSPACE memory file under its section,
+ * creating the file/section as needed. Append-only and idempotent on exact
+ * duplicates so repeated "remember X" doesn't pile up identical bullets.
+ */
+export declare function appendMemory(cwd: string, note: string, section?: MemorySection): Promise<void>;
+/**
+ * Pure markdown transform: ensure `- <bullet>` exists under `## <header>`.
+ * Inserts the bullet at the end of an existing section, or appends a fresh
+ * section. Exported for unit testing.
+ */
+export declare function upsertBullet(content: string, header: string, bullet: string): string;
+//# sourceMappingURL=memory.d.ts.map

package/dist/ai/voiceIntermediary/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/ai/voiceIntermediary/memory.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAUxE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAWD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA4BpF"}

package/dist/ai/voiceIntermediary/memory.js

@@ -0,0 +1,109 @@
+// SPDX-FileCopyrightText: 2026 King Young Technology
+// SPDX-License-Identifier: MIT
+/**
+ * Workspace memory for the voice intermediary — a plain, human-editable
+ * markdown file, NOT a database. Mirrors the `AGENTS.md` / Claude-memory model:
+ * standing preferences, decisions (trust boundaries) and project facts the
+ * "AI coworker" should carry between voice sessions.
+ *
+ * Two tiers, both optional, loaded together (global first, workspace second so
+ * project rules win on conflict):
+ *   - global    `~/.quicksave/voice-memory.md`        (cross-project style)
+ *   - workspace `<cwd>/.quicksave/voice-memory.md`    (per-project boundaries)
+ *
+ * Deliberately separate from the coding agent's own `CLAUDE.md` / `AGENTS.md`:
+ * those steer the coding agent, so writing coworker notes there would pollute
+ * its context. We READ those elsewhere for grounding but only WRITE here.
+ */
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+/** Section slug → human-readable markdown header (the file is for human eyes). */
+const SECTION_HEADERS = {
+    preference: '偏好',
+    decision: '常駐決定（界線）',
+    fact: '專案常識',
+    note: '筆記',
+};
+export function globalMemoryPath() {
+    return join(homedir(), '.quicksave', 'voice-memory.md');
+}
+export function workspaceMemoryPath(cwd) {
+    return join(cwd, '.quicksave', 'voice-memory.md');
+}
+async function readIfPresent(path) {
+    try {
+        const text = await readFile(path, 'utf8');
+        return text.trim().length > 0 ? text.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load the combined memory text for a workspace, ready to splice into the
+ * brain's system prompt. Returns '' when nothing has been remembered yet so the
+ * caller can cheaply skip the section.
+ */
+export async function loadMemory(cwd) {
+    const [global, workspace] = await Promise.all([
+        readIfPresent(globalMemoryPath()),
+        readIfPresent(workspaceMemoryPath(cwd)),
+    ]);
+    const parts = [];
+    if (global)
+        parts.push(`# 跨專案記憶 (global)\n\n${global}`);
+    if (workspace)
+        parts.push(`# 此工作區記憶 (workspace)\n\n${workspace}`);
+    return parts.join('\n\n');
+}
+/**
+ * Append a remembered fact to the WORKSPACE memory file under its section,
+ * creating the file/section as needed. Append-only and idempotent on exact
+ * duplicates so repeated "remember X" doesn't pile up identical bullets.
+ */
+export async function appendMemory(cwd, note, section = 'note') {
+    const trimmed = note.trim();
+    if (!trimmed)
+        return;
+    const path = workspaceMemoryPath(cwd);
+    const existing = (await readIfPresent(path)) ?? '';
+    const next = upsertBullet(existing, SECTION_HEADERS[section], trimmed);
+    if (next === existing)
+        return;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, next.endsWith('\n') ? next : `${next}\n`, 'utf8');
+}
+/**
+ * Pure markdown transform: ensure `- <bullet>` exists under `## <header>`.
+ * Inserts the bullet at the end of an existing section, or appends a fresh
+ * section. Exported for unit testing.
+ */
+export function upsertBullet(content, header, bullet) {
+    const bulletLine = `- ${bullet}`;
+    const lines = content.length > 0 ? content.split('\n') : [];
+    // Already present anywhere → no-op (cheap dedupe).
+    if (lines.some((l) => l.trim() === bulletLine))
+        return content;
+    const headerLine = `## ${header}`;
+    const headerIdx = lines.findIndex((l) => l.trim() === headerLine);
+    if (headerIdx === -1) {
+        const block = `${headerLine}\n${bulletLine}`;
+        return lines.length > 0 ? `${content.replace(/\n+$/, '')}\n\n${block}` : block;
+    }
+    // Find the end of this section (next `## ` header or EOF) and insert before it.
+    let insertAt = lines.length;
+    for (let i = headerIdx + 1; i < lines.length; i++) {
+        if (lines[i].startsWith('## ')) {
+            insertAt = i;
+            break;
+        }
+    }
+    // Trim trailing blank lines inside the section before inserting.
+    let tail = insertAt;
+    while (tail > headerIdx + 1 && lines[tail - 1].trim() === '')
+        tail--;
+    lines.splice(tail, 0, bulletLine);
+    return lines.join('\n');
+}
+//# sourceMappingURL=memory.js.map

package/dist/ai/voiceIntermediary/memory.js.map

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

package/dist/ai/voiceIntermediary/session.d.ts

@@ -0,0 +1,81 @@
+/**
+ * One voice-intermediary conversation bound to a single coding session. Holds
+ * the brain's active message window in RAM and mirrors model-visible messages
+ * into append-only JSONL so a restarted voice agent can resume its own context.
+ * Coding-agent cards remain a separate implementation transcript read through
+ * tools. Each user utterance runs a tool-calling
+ * loop per user utterance: narrate → maybe call silent tools → speak the result.
+ */
+import type { CardEvent, CardStreamEnd, VoiceAgentPlaybackEventRequestPayload, VoiceAgentEvent, VoiceConfig } from '@sumicom/quicksave-shared';
+import { type ChatMessage, type FetchLike } from './llm.js';
+import { type CodingSessionBridge } from './tools.js';
+import { VoiceHistoryStore } from './historyStore.js';
+export interface VoiceSessionCallbacks {
+    emit: (event: VoiceAgentEvent) => void;
+    /** Persist audio bytes and return an id the PWA fetches on demand. */
+    storeAudio: (audio: Buffer, mimeType: string) => string;
+}
+export interface VoiceSessionOpts {
+    sessionId: string;
+    cwd: string;
+    config: VoiceConfig;
+    bridge: CodingSessionBridge;
+    callbacks: VoiceSessionCallbacks;
+    /** Injected for tests. */
+    fetchImpl?: FetchLike;
+    /** Injected for tests. */
+    historyStore?: VoiceHistoryStore;
+}
+export interface VoiceTurnMeta {
+    turnId?: string;
+    interactionId?: string;
+    utteranceId?: string;
+}
+export declare class VoiceIntermediarySession {
+    readonly sessionId: string;
+    private cwd;
+    private config;
+    private readonly bridge;
+    private readonly cb;
+    private readonly fetchImpl?;
+    private readonly history;
+    private messages;
+    private systemPrompt;
+    private ready;
+    /** Serializes turns so overlapping utterances don't interleave tool calls. */
+    private chain;
+    private closed;
+    /** Set after a provider clearly rejects the TTS endpoint; keep later turns text-only. */
+    private ttsUnavailableReason;
+    /** Passive mirror of the coding agent's newest live card stream. */
+    private readonly liveCards;
+    private readonly liveNotes;
+    private pendingPlaybackNote;
+    constructor(opts: VoiceSessionOpts);
+    /** Refresh config (e.g. user changed model/voice) without losing history. */
+    updateConfig(config: VoiceConfig, cwd?: string): void;
+    /** True when a brain model is configured, i.e. the agent can actually respond. */
+    hasBrain(): boolean;
+    private init;
+    /** Handle a final user utterance (STT transcript). Serialized per session. */
+    handleUtterance(text: string, meta?: VoiceTurnMeta): Promise<void>;
+    /** Proactively wake the agent on a coding-side event (e.g. permission pending). */
+    notify(systemNote: string): Promise<void>;
+    /** Wake the voice brain when the coding agent finishes a turn. The brain may no-op. */
+    notifyCodingTurnEnded(result: CardStreamEnd): Promise<void>;
+    close(): void;
+    /** Passively record coding-agent card updates. Does not wake or interrupt the voice LLM. */
+    recordCardEvent(event: CardEvent): void;
+    /** Record turn completion metadata without triggering a voice response. */
+    recordStreamEnd(result: CardStreamEnd): void;
+    recordPlaybackEvent(event: VoiceAgentPlaybackEventRequestPayload): void;
+    private runTurn;
+    private speak;
+    private messagesWithLiveContext;
+    private liveContextForBrain;
+    private trimLiveCards;
+    private maybeCompactHistory;
+}
+export declare function sanitizeMessagesForChatCompletion(messages: readonly ChatMessage[]): ChatMessage[];
+export declare function buildSystemPrompt(memory: string): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/ai/voiceIntermediary/session.d.ts.map

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