@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/terminal-status.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Terminal Status — lightweight terminal context display.
+ *
+ * Layer 1: Tab title (OSC 1)                — "{project} · {model}"
+ * Layer 2: iTerm2 badge (OSC 1337 SetBadgeFormat) — post-it style, 2 lines
+ * Layer 3: iTerm2 user variables (OSC 1337 SetUserVar) — agentdeck_project/_model
+ *
+ * Badge sizing is pinned via a Dynamic Profile that inherits from the user's
+ * current profile; color adapts to macOS dark/light mode.
+ */
+import type { StateSnapshot } from './types.js';
+export declare class TerminalStatus {
+    private stdout;
+    private debounceTimer;
+    private inTmux;
+    private originalProfile;
+    private profileInstalled;
+    constructor(stdout: NodeJS.WritableStream);
+    update(snapshot: StateSnapshot): void;
+    cleanup(): void;
+    private installDynamicProfile;
+    private uninstallDynamicProfile;
+    private render;
+    private buildBadge;
+    private writeOsc;
+    private writeIterm;
+}
+//# sourceMappingURL=terminal-status.d.ts.map

package/dist/terminal-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-status.d.ts","sourceRoot":"","sources":["../src/terminal-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiBhD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,MAAM,CAAC,cAAc;IAMzC,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKrC,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CAOnB"}

package/dist/terminal-status.js

@@ -0,0 +1,152 @@
+/**
+ * Terminal Status — lightweight terminal context display.
+ *
+ * Layer 1: Tab title (OSC 1)                — "{project} · {model}"
+ * Layer 2: iTerm2 badge (OSC 1337 SetBadgeFormat) — post-it style, 2 lines
+ * Layer 3: iTerm2 user variables (OSC 1337 SetUserVar) — agentdeck_project/_model
+ *
+ * Badge sizing is pinned via a Dynamic Profile that inherits from the user's
+ * current profile; color adapts to macOS dark/light mode.
+ */
+import { debug } from './logger.js';
+import { writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+const DYNAMIC_PROFILE_NAME = 'AgentDeck Postit';
+const DYNAMIC_PROFILE_DIR = join(homedir(), 'Library', 'Application Support', 'iTerm2', 'DynamicProfiles');
+const DYNAMIC_PROFILE_PATH = join(DYNAMIC_PROFILE_DIR, 'agentdeck.json');
+const BADGE_MAX_WIDTH_FRACTION = 0.5;
+const BADGE_MAX_HEIGHT_FRACTION = 0.1;
+export class TerminalStatus {
+    stdout;
+    debounceTimer = null;
+    inTmux;
+    originalProfile = null;
+    profileInstalled = false;
+    constructor(stdout) {
+        this.stdout = stdout;
+        this.inTmux = !!process.env.TMUX;
+        this.installDynamicProfile();
+    }
+    update(snapshot) {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => this.render(snapshot), 200);
+    }
+    cleanup() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        this.writeOsc('\x1b]1;\x07');
+        this.writeIterm('\x1b]1337;SetBadgeFormat=\x07');
+        this.writeIterm(`\x1b]1337;SetUserVar=agentdeck_project=${b64('')}\x07`);
+        this.writeIterm(`\x1b]1337;SetUserVar=agentdeck_model=${b64('')}\x07`);
+        this.uninstallDynamicProfile();
+    }
+    // ===== Dynamic Profile =====
+    installDynamicProfile() {
+        this.originalProfile = process.env.ITERM_PROFILE || null;
+        const parentName = this.originalProfile || 'Default';
+        const isDark = detectDarkMode();
+        const badgeColor = isDark
+            ? {
+                'Red Component': 1.0,
+                'Green Component': 0.8,
+                'Blue Component': 0.3,
+                'Alpha Component': 0.7,
+            }
+            : {
+                'Red Component': 0.2,
+                'Green Component': 0.25,
+                'Blue Component': 0.35,
+                'Alpha Component': 0.7,
+            };
+        const profile = {
+            Name: DYNAMIC_PROFILE_NAME,
+            Guid: 'agentdeck-postit-dynamic-profile',
+            'Dynamic Profile Parent Name': parentName,
+            'Badge Max Width': BADGE_MAX_WIDTH_FRACTION,
+            'Badge Max Height': BADGE_MAX_HEIGHT_FRACTION,
+            'Badge Top Margin': 10,
+            'Badge Right Margin': 10,
+            'Badge Color': { ...badgeColor, 'Color Space': 'sRGB' },
+        };
+        try {
+            mkdirSync(DYNAMIC_PROFILE_DIR, { recursive: true });
+            writeFileSync(DYNAMIC_PROFILE_PATH, JSON.stringify({ Profiles: [profile] }, null, 2));
+            setTimeout(() => {
+                this.writeIterm(`\x1b]1337;SetProfile=${DYNAMIC_PROFILE_NAME}\x07`);
+            }, 300);
+            this.profileInstalled = true;
+            debug('postit', `Dynamic profile installed, parent="${parentName}", dark=${isDark}`);
+        }
+        catch (err) {
+            debug('postit', `Failed to install dynamic profile: ${err}`);
+        }
+    }
+    uninstallDynamicProfile() {
+        if (this.originalProfile) {
+            this.writeIterm(`\x1b]1337;SetProfile=${this.originalProfile}\x07`);
+        }
+        if (this.profileInstalled) {
+            try {
+                unlinkSync(DYNAMIC_PROFILE_PATH);
+                debug('postit', 'Dynamic profile removed');
+            }
+            catch {
+                // File may already be gone
+            }
+            this.profileInstalled = false;
+        }
+    }
+    // ===== Render =====
+    render(snapshot) {
+        const project = snapshot.projectName ?? 'AgentDeck';
+        const model = snapshot.modelName ?? '';
+        const title = model ? `${project} · ${model}` : project;
+        this.writeOsc(`\x1b]1;${title}\x07`);
+        this.writeIterm(`\x1b]1337;SetBadgeFormat=${b64(this.buildBadge(project, model))}\x07`);
+        this.writeIterm(`\x1b]1337;SetUserVar=agentdeck_project=${b64(project)}\x07`);
+        this.writeIterm(`\x1b]1337;SetUserVar=agentdeck_model=${b64(model)}\x07`);
+    }
+    buildBadge(project, model) {
+        const lines = [`📂 ${project}`];
+        if (model)
+            lines.push(model);
+        // Pad to 3 lines with braille blank — keeps badge height stable when model is absent.
+        while (lines.length < 3)
+            lines.push('\u2800');
+        return lines.join('\n');
+    }
+    writeOsc(seq) {
+        this.stdout.write(seq);
+    }
+    writeIterm(seq) {
+        if (this.inTmux) {
+            this.stdout.write(`\x1bPtmux;\x1b${seq}\x1b\\`);
+        }
+        else {
+            this.stdout.write(seq);
+        }
+    }
+}
+function b64(s) {
+    return Buffer.from(s, 'utf-8').toString('base64');
+}
+function detectDarkMode() {
+    try {
+        const result = execSync('defaults read -g AppleInterfaceStyle', {
+            encoding: 'utf-8',
+            timeout: 1000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return result === 'Dark';
+    }
+    catch {
+        // Command fails when in light mode (key doesn't exist) — default to dark
+        return true;
+    }
+}
+//# sourceMappingURL=terminal-status.js.map

package/dist/terminal-status.js.map

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

package/dist/timeline-store.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bridge-side timeline store — minimal server-side event buffer.
+ * Stores recent timeline entries for relay to Android/plugin clients.
+ * No scroll/grouping logic (that's client-side).
+ */
+import type { TimelineEntry } from './types.js';
+type EntryListener = (entry: TimelineEntry, upsert?: boolean) => void;
+export declare class BridgeTimelineStore {
+    private entries;
+    private listeners;
+    addEntry(entry: TimelineEntry): void;
+    getHistory(since?: number): TimelineEntry[];
+    updateEntryStatus(approvalId: string, status: 'approved' | 'denied'): void;
+    /** Update existing entry with same ts+type (1s tolerance), or add new */
+    upsertEntry(entry: TimelineEntry): void;
+    /** Get the most recent entry of a given type */
+    getLastEntry(type: string): TimelineEntry | null;
+    onEntry(cb: EntryListener): void;
+    removeListener(cb: EntryListener): void;
+}
+export {};
+//# sourceMappingURL=timeline-store.d.ts.map

package/dist/timeline-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-store.d.ts","sourceRoot":"","sources":["../src/timeline-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAItE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAuB;IAExC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAwBpC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAO3C,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI;IAS1E,yEAAyE;IACzE,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAavC,gDAAgD;IAChD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOhD,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAIhC,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;CAIxC"}

package/dist/timeline-store.js

@@ -0,0 +1,79 @@
+/**
+ * Bridge-side timeline store — minimal server-side event buffer.
+ * Stores recent timeline entries for relay to Android/plugin clients.
+ * No scroll/grouping logic (that's client-side).
+ */
+import { deduplicateEntry } from '@agentdeck/shared';
+const MAX_ENTRIES = 200;
+export class BridgeTimelineStore {
+    entries = [];
+    listeners = [];
+    addEntry(entry) {
+        const result = deduplicateEntry(entry, this.entries);
+        if (result.action === 'skip')
+            return;
+        if (result.action === 'merge') {
+            const existing = this.entries[result.index];
+            existing.repeatCount = (existing.repeatCount || 1) + 1;
+            existing.ts = entry.ts;
+            if (result.removeChatStartIndex != null) {
+                this.entries.splice(result.removeChatStartIndex, 1);
+            }
+            for (const cb of this.listeners)
+                cb(existing, true);
+            return;
+        }
+        // action === 'add'
+        this.entries.push(result.entry);
+        if (this.entries.length > MAX_ENTRIES) {
+            this.entries.shift();
+        }
+        for (const cb of this.listeners)
+            cb(result.entry);
+    }
+    getHistory(since) {
+        if (since) {
+            return this.entries.filter((e) => e.ts > since);
+        }
+        return [...this.entries];
+    }
+    updateEntryStatus(approvalId, status) {
+        for (let i = this.entries.length - 1; i >= 0; i--) {
+            if (this.entries[i].approvalId === approvalId) {
+                this.entries[i] = { ...this.entries[i], status };
+                return;
+            }
+        }
+    }
+    /** Update existing entry with same ts+type (1s tolerance), or add new */
+    upsertEntry(entry) {
+        const tolerance = 1000;
+        for (let i = this.entries.length - 1; i >= 0; i--) {
+            const e = this.entries[i];
+            if (e.type === entry.type && Math.abs(e.ts - entry.ts) < tolerance) {
+                this.entries[i] = { ...e, raw: entry.raw, ...(entry.detail ? { detail: entry.detail } : {}) };
+                for (const cb of this.listeners)
+                    cb(this.entries[i], true);
+                return;
+            }
+        }
+        this.addEntry(entry);
+    }
+    /** Get the most recent entry of a given type */
+    getLastEntry(type) {
+        for (let i = this.entries.length - 1; i >= 0; i--) {
+            if (this.entries[i].type === type)
+                return this.entries[i];
+        }
+        return null;
+    }
+    onEntry(cb) {
+        this.listeners.push(cb);
+    }
+    removeListener(cb) {
+        const idx = this.listeners.indexOf(cb);
+        if (idx !== -1)
+            this.listeners.splice(idx, 1);
+    }
+}
+//# sourceMappingURL=timeline-store.js.map

package/dist/timeline-store.js.map

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

package/dist/timeline-summarizer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Timeline summarizer — uses local LLM to create concise 1-line summaries
+ * of OpenClaw chat responses for timeline display.
+ *
+ * Tries: local mlx-serve qwen (port 8800) → Ollama → heuristic fallback.
+ * Non-blocking — caller should fire-and-forget, update entry when ready.
+ */
+export { extractTopicHint } from '@agentdeck/shared';
+/**
+ * Summarize a chat response into a concise 1-line Korean summary.
+ * Returns null if summarization fails (caller should use fallback).
+ */
+export declare function summarizeResponse(text: string): Promise<string | null>;
+//# sourceMappingURL=timeline-summarizer.d.ts.map

package/dist/timeline-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-summarizer.d.ts","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAiCrD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsC5E"}

package/dist/timeline-summarizer.js

@@ -0,0 +1,154 @@
+/**
+ * Timeline summarizer — uses local LLM to create concise 1-line summaries
+ * of OpenClaw chat responses for timeline display.
+ *
+ * Tries: local mlx-serve qwen (port 8800) → Ollama → heuristic fallback.
+ * Non-blocking — caller should fire-and-forget, update entry when ready.
+ */
+import { debug } from './logger.js';
+import { SUMMARY_SYSTEM_PROMPT, cleanLLMOutput, mlxChatUrl, resolveMlxModel } from '@agentdeck/shared';
+import { fetchMlxModels } from './mlx-probe.js';
+export { extractTopicHint } from '@agentdeck/shared';
+const MLX_URL = mlxChatUrl();
+// In-memory cache of the probe's first result, so summarizers don't hit
+// /v1/models on every call. Refreshed lazily when the model call fails.
+let probedFirstModel = null;
+let probedAt = 0;
+const PROBE_CACHE_TTL_MS = 60_000;
+async function resolveModelForCall() {
+    const now = Date.now();
+    if (!probedFirstModel || now - probedAt > PROBE_CACHE_TTL_MS) {
+        try {
+            const models = await fetchMlxModels();
+            probedFirstModel = models && models.length > 0 ? models[0] : null;
+            probedAt = now;
+        }
+        catch {
+            probedFirstModel = null;
+        }
+    }
+    return resolveMlxModel(probedFirstModel);
+}
+const OLLAMA_URL = 'http://localhost:11434/api/chat';
+const TIMEOUT_MS = 30_000; // 30s — first inference needs model load time
+const MAX_INPUT_CHARS = 2000;
+let mlxAvailable = null;
+let ollamaAvailable = null;
+let mlxFailedAt = 0;
+let ollamaFailedAt = 0;
+const RETRY_INTERVAL_MS = 60_000; // retry failed providers after 60s
+/**
+ * Summarize a chat response into a concise 1-line Korean summary.
+ * Returns null if summarization fails (caller should use fallback).
+ */
+export async function summarizeResponse(text) {
+    if (!text || text.length < 20)
+        return null;
+    const input = text.length > MAX_INPUT_CHARS
+        ? text.slice(0, MAX_INPUT_CHARS) + '...'
+        : text;
+    // Try MLX qwen first (retry after RETRY_INTERVAL_MS)
+    if (mlxAvailable !== false || (Date.now() - mlxFailedAt > RETRY_INTERVAL_MS)) {
+        try {
+            const result = await callMLX(input);
+            if (result) {
+                mlxAvailable = true;
+                return result;
+            }
+        }
+        catch {
+            mlxAvailable = false;
+            mlxFailedAt = Date.now();
+            debug('summarizer', 'MLX not available, trying Ollama');
+        }
+    }
+    // Try Ollama (retry after RETRY_INTERVAL_MS)
+    if (ollamaAvailable !== false || (Date.now() - ollamaFailedAt > RETRY_INTERVAL_MS)) {
+        try {
+            const result = await callOllama(input);
+            if (result) {
+                ollamaAvailable = true;
+                return result;
+            }
+        }
+        catch {
+            ollamaAvailable = false;
+            ollamaFailedAt = Date.now();
+            debug('summarizer', 'Ollama not available, using heuristic');
+        }
+    }
+    return null;
+}
+// extractTopicHint and cleanLLMOutput moved to @agentdeck/shared/timeline-summarizer
+async function callMLX(input) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    const model = await resolveModelForCall();
+    try {
+        const resp = await fetch(MLX_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model,
+                enable_thinking: false,
+                messages: [
+                    { role: 'system', content: SUMMARY_SYSTEM_PROMPT },
+                    { role: 'user', content: input },
+                ],
+                max_tokens: 100,
+                temperature: 0.3,
+            }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!resp.ok)
+            throw new Error(`MLX ${resp.status}`);
+        const data = await resp.json();
+        const content = data.choices?.[0]?.message?.content?.trim();
+        if (!content)
+            return null;
+        const result = cleanLLMOutput(content);
+        if (result)
+            debug('summarizer', `MLX summary: ${result}`);
+        return result;
+    }
+    catch (err) {
+        clearTimeout(timer);
+        throw err;
+    }
+}
+async function callOllama(input) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const resp = await fetch(OLLAMA_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: 'qwen2.5:7b',
+                messages: [
+                    { role: 'system', content: SUMMARY_SYSTEM_PROMPT },
+                    { role: 'user', content: input },
+                ],
+                stream: false,
+            }),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!resp.ok)
+            throw new Error(`Ollama ${resp.status}`);
+        const data = await resp.json();
+        const content = data.message?.content?.trim();
+        if (!content)
+            return null;
+        const result = cleanLLMOutput(content);
+        if (result)
+            debug('summarizer', `Ollama summary: ${result}`);
+        return result;
+    }
+    catch (err) {
+        clearTimeout(timer);
+        throw err;
+    }
+}
+//# sourceMappingURL=timeline-summarizer.js.map

package/dist/timeline-summarizer.js.map

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

package/dist/tts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TTS Engine — macOS `say` with Neural Korean voice.
+ *
+ * Uses macOS built-in Neural TTS (Yuna / Sandy / etc.) — pre-installed,
+ * fast (~1s for a sentence), high quality Korean, no GPU competition.
+ *
+ * Supports sentence-level streaming: splits text into sentences,
+ * speaks each sequentially for lower perceived latency.
+ */
+export declare class TtsEngine {
+    private voice;
+    private currentPlayback;
+    constructor();
+    isAvailable(): boolean;
+    /** Speak text directly (no temp file) */
+    speak(text: string): Promise<void>;
+    /**
+     * Streaming speak: split text into sentences, speak sequentially.
+     * Each sentence starts as soon as the previous one finishes.
+     */
+    speakStreaming(text: string): Promise<void>;
+    stopPlayback(): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=tts.d.ts.map

package/dist/tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../src/tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,eAAe,CAA6B;;IAWpD,WAAW,IAAI,OAAO;IAItB,yCAAyC;IACnC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxC;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,YAAY,IAAI,IAAI;IAOpB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/tts.js

@@ -0,0 +1,99 @@
+/**
+ * TTS Engine — macOS `say` with Neural Korean voice.
+ *
+ * Uses macOS built-in Neural TTS (Yuna / Sandy / etc.) — pre-installed,
+ * fast (~1s for a sentence), high quality Korean, no GPU competition.
+ *
+ * Supports sentence-level streaming: splits text into sentences,
+ * speaks each sequentially for lower perceived latency.
+ */
+import { spawn, execSync } from 'child_process';
+import { platform } from 'os';
+import { debug } from './logger.js';
+const TAG = 'TTS';
+/** Preferred Korean voices in quality order */
+const PREFERRED_KO_VOICES = ['Yuna', 'Sandy', 'Shelley', 'Reed', 'Flo', 'Eddy'];
+function findMacOsKoreanVoice() {
+    if (platform() !== 'darwin')
+        return null;
+    try {
+        const voices = execSync('say -v "?"', { encoding: 'utf-8' });
+        const koVoices = voices.split('\n').filter(l => l.includes('ko_KR'));
+        if (koVoices.length === 0)
+            return null;
+        for (const name of PREFERRED_KO_VOICES) {
+            if (koVoices.some(v => v.startsWith(name + ' ') || v.includes(`(${name})`))) {
+                return name;
+            }
+        }
+        const match = koVoices[0].match(/^(\S+)/);
+        return match?.[1] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export class TtsEngine {
+    voice;
+    currentPlayback = null;
+    constructor() {
+        this.voice = findMacOsKoreanVoice();
+        if (this.voice) {
+            debug(TAG, `macOS say voice: ${this.voice}`);
+        }
+        else {
+            debug(TAG, 'No Korean TTS voice available');
+        }
+    }
+    isAvailable() {
+        return this.voice !== null;
+    }
+    /** Speak text directly (no temp file) */
+    async speak(text) {
+        if (!this.voice)
+            throw new Error('No TTS voice available');
+        return new Promise((resolve, reject) => {
+            debug(TAG, `say -v ${this.voice}: "${text.slice(0, 60)}"`);
+            const proc = spawn('say', ['-v', this.voice, text], { stdio: 'ignore' });
+            this.currentPlayback = proc;
+            proc.on('error', (err) => {
+                this.currentPlayback = null;
+                reject(new Error(`say error: ${err.message}`));
+            });
+            proc.on('close', (code) => {
+                this.currentPlayback = null;
+                if (code !== 0)
+                    reject(new Error(`say exited with code ${code}`));
+                else
+                    resolve();
+            });
+        });
+    }
+    /**
+     * Streaming speak: split text into sentences, speak sequentially.
+     * Each sentence starts as soon as the previous one finishes.
+     */
+    async speakStreaming(text) {
+        const sentences = splitSentences(text);
+        if (sentences.length === 0)
+            return;
+        for (const sentence of sentences) {
+            await this.speak(sentence);
+        }
+    }
+    stopPlayback() {
+        if (this.currentPlayback) {
+            this.currentPlayback.kill('SIGTERM');
+            this.currentPlayback = null;
+        }
+    }
+    cleanup() {
+        this.stopPlayback();
+    }
+}
+/** Split text into sentences for streaming TTS */
+function splitSentences(text) {
+    const raw = text.split(/(?<=[.!?。？！])\s+/);
+    return raw.map(s => s.trim()).filter(s => s.length > 0);
+}
+//# sourceMappingURL=tts.js.map

package/dist/tts.js.map

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