@aitne/daemon 0.1.0

package/dist/services/obsidian.js

@@ -0,0 +1,305 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { resolve as resolvePath } from "node:path";
+import { createLogger } from "../logging.js";
+const logger = createLogger("obsidian-service");
+const execFileAsync = promisify(execFile);
+/**
+ * Check whether a process with the given executable name is running.
+ *
+ * Cross-platform:
+ * - POSIX (macOS / Linux): `pgrep -x <name>` — fast, exact name match.
+ * - Windows: `tasklist /FI "IMAGENAME eq <name>.exe" /FO CSV /NH` — the
+ *   in-box equivalent. Image filter is case-insensitive on NTFS, which
+ *   matches the casing tolerance Windows users expect for `.exe` names.
+ *
+ * Any failure (binary missing, no match, timeout) returns false. Callers
+ * use this as a fail-closed gate before invoking the Obsidian CLI: on
+ * macOS the CLI doubles as a GUI launcher and would hang indefinitely if
+ * the app isn't already running, so a stale "yes" here is a worse outcome
+ * than a stale "no".
+ *
+ * Results are cached with a 1 s TTL so a tight burst of CLI calls
+ * doesn't pay the per-spawn cost (tasklist on Windows is ~50-200 ms per
+ * invocation). Stale window is bounded — a user who launches Obsidian
+ * mid-burst sees the "running" state on the next call after the cache
+ * expires.
+ */
+const PROCESS_RUNNING_CACHE_TTL_MS = 1_000;
+let cachedRunning = null;
+async function isProcessRunning(name) {
+    const now = Date.now();
+    if (cachedRunning && cachedRunning.name === name && now < cachedRunning.expiresAt) {
+        return cachedRunning.result;
+    }
+    const result = await detectProcessRunning(name);
+    cachedRunning = { name, result, expiresAt: now + PROCESS_RUNNING_CACHE_TTL_MS };
+    return result;
+}
+async function detectProcessRunning(name) {
+    try {
+        if (process.platform === "win32") {
+            const imageName = `${name}.exe`;
+            const { stdout } = await execFileAsync("tasklist", ["/FI", `IMAGENAME eq ${imageName}`, "/FO", "CSV", "/NH"], { timeout: 2_000, windowsHide: true });
+            // No-match output: `INFO: No tasks are running which match …` —
+            // the image name itself never appears. Real match: a CSV row whose
+            // first field is the image name (always present, case-insensitive).
+            return stdout.toLowerCase().includes(imageName.toLowerCase());
+        }
+        await execFileAsync("pgrep", ["-x", name], { timeout: 2_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function obsidianAppRunning() {
+    return isProcessRunning("Obsidian");
+}
+/**
+ * ObsidianService — wraps Obsidian CLI (1.12+).
+ *
+ * The CLI communicates with the running Obsidian process, so it works
+ * transparently with iCloud vaults. All writes go through the CLI;
+ * reads can use Claude Code's Read tool directly (vault path is injected
+ * by ContextBuilder).
+ *
+ * Prerequisites:
+ * - Obsidian 1.12+ installed
+ * - Settings > General > "Command line interface" enabled
+ * - Obsidian running (CLI communicates with the Obsidian process)
+ * - CLI in PATH (~/.zprofile auto-updated when CLI is enabled)
+ */
+export class ObsidianService {
+    vaultName;
+    vaultPath;
+    constructor(config) {
+        // Management Mode: this service always operates on the EXTERNAL Obsidian
+        // vault (a user-maintained note vault reached via the Obsidian CLI).
+        // The agent's primary vault — its own personal data — lives under
+        // `getContextDir(config)` and is reached via `/api/context/*` instead.
+        this.vaultName = config.externalObsidianVaultName;
+        this.vaultPath = config.externalObsidianVaultPath;
+    }
+    /** Whether Obsidian integration is configured */
+    get available() {
+        return this.vaultName !== null;
+    }
+    /** Get the vault name (for status endpoint) */
+    get vault() {
+        return this.vaultName;
+    }
+    /** Get the absolute vault path (for attribution tracking) */
+    get absoluteVaultPath() {
+        return this.vaultPath;
+    }
+    /**
+     * Append `.md` to a note path when the caller omitted an extension.
+     * Exposed so route handlers and this service agree on the same path
+     * normalization before passing values to the CLI or AgentWriteTracker.
+     */
+    static ensureMdExtension(notePath) {
+        return /\.[A-Za-z0-9]+$/.test(notePath) ? notePath : `${notePath}.md`;
+    }
+    /**
+     * Resolve a logical note name to an absolute file path inside the vault.
+     * Returns `null` if the vault path is not configured. The daemon uses
+     * this to pre-mark agent writes in AgentWriteTracker so the observer
+     * correctly attributes subsequent chokidar events to the agent rather
+     * than the user. Adds a `.md` suffix when the caller omits it.
+     */
+    resolveNotePath(noteName) {
+        if (!this.vaultPath)
+            return null;
+        return resolvePath(this.vaultPath, ObsidianService.ensureMdExtension(noteName));
+    }
+    /**
+     * Check if Obsidian CLI is accessible and the app is running.
+     *
+     * On macOS the CLI binary installed by Obsidian (at
+     * `/Applications/Obsidian.app/Contents/MacOS/obsidian`) doubles as the GUI
+     * launcher: invoking it with no running Obsidian process spawns Electron
+     * instead of answering `--version`, and that never exits. Check first that
+     * an Obsidian process is already running, and enforce a short timeout on
+     * the probe as a belt-and-braces guard.
+     */
+    async isRunning() {
+        if (!(await obsidianAppRunning())) {
+            logger.warn("Obsidian app is not running — CLI requires the app to be open. Skipping Obsidian integration.");
+            return false;
+        }
+        try {
+            await execFileAsync("obsidian", ["--version"], {
+                timeout: 3_000,
+                killSignal: "SIGKILL",
+            });
+            return true;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.warn({ err: message }, "Obsidian CLI probe failed");
+            return false;
+        }
+    }
+    /** Create a new note */
+    async createNote(name, content) {
+        await this.exec(["create", `name=${name}`, `content=${content}`, "silent"]);
+        logger.info({ name }, "Obsidian note created");
+    }
+    /**
+     * Overwrite an existing note (or create it if missing).
+     *
+     * Wraps `obsidian create path=… overwrite`, which is idempotent: the
+     * CLI replaces the file's contents if it exists and creates it
+     * otherwise. This is PUT semantics — use `createNote` when strict
+     * create-only behavior is required.
+     *
+     * **Must use `path=`, not `name=`.** The CLI's `name=` resolves like a
+     * wikilink (basename match across the vault), which combined with the
+     * `overwrite` flag could silently clobber an unrelated note that
+     * happens to share a basename. `path=` is exact (folder/note.md).
+     */
+    async updateNote(filePath, content) {
+        const normalized = ObsidianService.ensureMdExtension(filePath);
+        await this.exec([
+            "create",
+            `path=${normalized}`,
+            `content=${content}`,
+            "overwrite",
+            "silent",
+        ]);
+        logger.info({ path: normalized }, "Obsidian note updated (overwrite)");
+    }
+    /**
+     * Delete a note.
+     *
+     * Defaults to Obsidian's trash (recoverable via the vault UI). Pass
+     * `permanent=true` to skip the trash — irreversible, use sparingly.
+     *
+     * Uses `path=` (not `file=`) for the same reason as `updateNote`:
+     * wikilink resolution on a shared basename would let a destructive
+     * call silently target the wrong vault file.
+     */
+    async deleteNote(filePath, permanent = false) {
+        const normalized = ObsidianService.ensureMdExtension(filePath);
+        const args = ["delete", `path=${normalized}`];
+        if (permanent)
+            args.push("permanent");
+        await this.exec(args);
+        logger.info({ path: normalized, permanent }, "Obsidian note deleted");
+    }
+    /** Append content to an existing note */
+    async appendToNote(file, content) {
+        await this.exec(["append", `file=${file}`, `content=${content}`]);
+        logger.debug({ file }, "Appended to Obsidian note");
+    }
+    /** Search notes by query */
+    async search(query, limit = 10) {
+        const result = await this.exec([
+            "search",
+            `query=${query}`,
+            `limit=${limit}`,
+        ]);
+        return this.parseSearchResult(result);
+    }
+    /**
+     * Read a note's content.
+     *
+     * Uses `path=` (not `file=`) so the lookup is exact and doesn't
+     * depend on Obsidian's wikilink index — the wikilink index is
+     * populated asynchronously and can briefly miss a file that was
+     * just written via `create path=…`. `path=` hits the filesystem
+     * directly and avoids that race.
+     *
+     * Also detects the CLI's "Error: File … not found." stdout pattern:
+     * the `read` command reports missing files on stdout with exit 0,
+     * so we must promote it to an exception for the caller to get a
+     * meaningful "not found" signal.
+     */
+    async readNote(filePath) {
+        const normalized = ObsidianService.ensureMdExtension(filePath);
+        const out = await this.exec(["read", `path=${normalized}`]);
+        if (/^Error:\s/m.test(out)) {
+            throw new Error(out.trim());
+        }
+        return out;
+    }
+    /** Append to the daily note */
+    async appendToDaily(content) {
+        await this.exec(["daily:append", `content=${content}`]);
+        logger.debug("Appended to Obsidian daily note");
+    }
+    /** Set a property on a note */
+    async setProperty(file, name, value) {
+        await this.exec([
+            "property:set",
+            `name=${name}`,
+            `value=${value}`,
+            `file=${file}`,
+        ]);
+    }
+    /**
+     * Execute an Obsidian CLI command.
+     *
+     * Uses execFile with args array (not shell) to prevent injection.
+     * Prepends vault name if configured.
+     */
+    async exec(args) {
+        const fullArgs = this.vaultName
+            ? [`vault=${this.vaultName}`, ...args]
+            : args;
+        if (!(await obsidianAppRunning())) {
+            // Without this guard the `obsidian` binary would launch the GUI and
+            // hang, holding up every API caller until the 10s timeout — see
+            // `isRunning()` for the full explanation.
+            throw new Error("Obsidian app is not running. The CLI requires the app to be open.");
+        }
+        try {
+            const { stdout } = await execFileAsync("obsidian", fullArgs, {
+                timeout: 10_000,
+                killSignal: "SIGKILL",
+            });
+            return stdout.trim();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            if (message.includes("ENOENT")) {
+                throw new Error("Obsidian CLI not found. Ensure Obsidian 1.12+ is installed and CLI is enabled in Settings > General.");
+            }
+            throw new Error(`Obsidian CLI error: ${message}`);
+        }
+    }
+    /** Parse the CLI search output into structured results */
+    parseSearchResult(raw) {
+        if (!raw.trim())
+            return [];
+        const results = [];
+        // Obsidian CLI search returns one result per line: "path | title | excerpt"
+        // Exact format depends on CLI version; handle both JSON and plain text
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed)) {
+                return parsed.map((item) => ({
+                    path: item.path ?? item.file ?? "",
+                    title: item.title ?? item.name ?? "",
+                    excerpt: item.excerpt ?? item.content ?? "",
+                }));
+            }
+        }
+        catch {
+            // Plain text fallback
+            for (const line of raw.split("\n")) {
+                if (!line.trim())
+                    continue;
+                const parts = line.split("|").map((s) => s.trim());
+                results.push({
+                    path: parts[0] ?? "",
+                    title: parts[1] ?? parts[0] ?? "",
+                    excerpt: parts[2] ?? "",
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/services/obsidian.js.map

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

package/dist/services/service-registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Mutable service registry — allows services to be initialized or replaced
+ * at runtime (e.g., after OAuth completes) without daemon restart.
+ *
+ * All consumers (routes, context-builder, poller, status) hold a reference
+ * to this registry object. Mutating its properties is visible to all.
+ */
+import type { AppleCalendarService } from "./apple-calendar/index.js";
+import type { CalendarService } from "./calendar.js";
+import type { GmailService } from "./gmail.js";
+import type { ObsidianService } from "./obsidian.js";
+import type { NotionService } from "./notion.js";
+import type { GitHubService } from "./github.js";
+import type { GoogleMapsService } from "./google-maps.js";
+import type { MailAccountRegistry } from "./mail/account-registry.js";
+import type { JournalMirrorService } from "./journal/writer.js";
+export interface ServiceRegistry {
+    calendar: CalendarService | null;
+    appleCalendar: AppleCalendarService | null;
+    gmail: GmailService | null;
+    mail: MailAccountRegistry | null;
+    obsidian: ObsidianService | null;
+    notion: NotionService | null;
+    github: GitHubService | null;
+    googleMaps: GoogleMapsService | null;
+    journal: JournalMirrorService | null;
+    /** Error messages from service initialization attempts */
+    errors: Record<string, string>;
+}
+export declare function createServiceRegistry(): ServiceRegistry;
+//# sourceMappingURL=service-registry.d.ts.map

package/dist/services/service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../../src/services/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAavD"}

package/dist/services/service-registry.js

@@ -0,0 +1,15 @@
+export function createServiceRegistry() {
+    return {
+        calendar: null,
+        appleCalendar: null,
+        gmail: null,
+        mail: null,
+        obsidian: null,
+        notion: null,
+        github: null,
+        googleMaps: null,
+        journal: null,
+        errors: {},
+    };
+}
+//# sourceMappingURL=service-registry.js.map

package/dist/services/service-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.js","sourceRoot":"","sources":["../../src/services/service-registry.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

package/dist/services/voice/transcriber-impl.d.ts

@@ -0,0 +1,15 @@
+import type { AudioDecoder, PipelineLoader } from "./transcriber.js";
+/**
+ * Real Whisper pipeline loader. Imports `@huggingface/transformers`
+ * dynamically so the (heavy) ONNX runtime is only loaded the first
+ * time a voice message arrives. See `transcriber.ts` for the test seam.
+ */
+export declare const defaultLoadPipeline: PipelineLoader;
+/**
+ * Decode any audio file to 16 kHz mono Float32 PCM via the bundled
+ * `ffmpeg-static` binary. Spawns ffmpeg with stdin closed, reading the
+ * input from `path` and writing raw `f32le` to stdout. The Float32Array
+ * carries the samples directly.
+ */
+export declare const decodeAudioWithFfmpeg: AudioDecoder;
+//# sourceMappingURL=transcriber-impl.d.ts.map

package/dist/services/voice/transcriber-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber-impl.d.ts","sourceRoot":"","sources":["../../../src/services/voice/transcriber-impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EACf,MAAM,kBAAkB,CAAC;AAI1B;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAmEjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,YA+DnC,CAAC"}

package/dist/services/voice/transcriber-impl.js

@@ -0,0 +1,129 @@
+import { spawn } from "node:child_process";
+const TARGET_SAMPLE_RATE = 16000;
+/**
+ * Real Whisper pipeline loader. Imports `@huggingface/transformers`
+ * dynamically so the (heavy) ONNX runtime is only loaded the first
+ * time a voice message arrives. See `transcriber.ts` for the test seam.
+ */
+export const defaultLoadPipeline = async ({ model, modelDir, onProgress, }) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let mod;
+    try {
+        mod = await import("@huggingface/transformers");
+    }
+    catch (err) {
+        throw new Error(`@huggingface/transformers not installed: ${err.message}`);
+    }
+    if (typeof mod?.pipeline !== "function") {
+        throw new Error("@huggingface/transformers: `pipeline` export missing");
+    }
+    // The JS port of @huggingface/transformers does NOT honor HF_HOME or
+    // TRANSFORMERS_CACHE — those are Python-side env vars. Instead it reads
+    // `mod.env.cacheDir`, defaulting to a `.cache/` folder bundled inside the
+    // package's own node_modules path. Under pnpm that path lives in the
+    // content-addressable store, which is wiped on `pnpm install` and can
+    // surface as "Unable to get model file path or buffer." when the cache
+    // write lands somewhere unreadable. Force both knobs at the daemon-owned
+    // dir before loading the pipeline.
+    if (mod?.env && typeof modelDir === "string" && modelDir.length > 0) {
+        mod.env.cacheDir = modelDir;
+        mod.env.localModelPath = modelDir;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const pipelineOptions = {};
+    if (onProgress) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        pipelineOptions.progress_callback = (event) => {
+            try {
+                onProgress(event);
+            }
+            catch {
+                // Never let a UI-progress observer break the actual download.
+            }
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const transcriber = await mod.pipeline("automatic-speech-recognition", model, pipelineOptions);
+    return async (samples, options) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const result = await transcriber(samples, {
+            language: options.language ?? undefined,
+            task: options.task,
+            return_timestamps: false,
+            chunk_length_s: 30,
+            stride_length_s: 5,
+        });
+        const text = typeof result?.text === "string"
+            ? result.text
+            : Array.isArray(result?.chunks)
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                ? result.chunks.map((c) => c.text ?? "").join(" ")
+                : "";
+        const language = typeof result?.language === "string" ? result.language : null;
+        return { text, language };
+    };
+};
+/**
+ * Decode any audio file to 16 kHz mono Float32 PCM via the bundled
+ * `ffmpeg-static` binary. Spawns ffmpeg with stdin closed, reading the
+ * input from `path` and writing raw `f32le` to stdout. The Float32Array
+ * carries the samples directly.
+ */
+export const decodeAudioWithFfmpeg = async ({ path }) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let ffmpegPathMod;
+    try {
+        ffmpegPathMod = await import("ffmpeg-static");
+    }
+    catch (err) {
+        throw new Error(`ffmpeg-static not installed: ${err.message}`);
+    }
+    const ffmpegPath = typeof ffmpegPathMod?.default === "string"
+        ? ffmpegPathMod.default
+        : typeof ffmpegPathMod === "string"
+            ? ffmpegPathMod
+            : "";
+    if (!ffmpegPath) {
+        throw new Error("ffmpeg-static: binary path not resolved");
+    }
+    return await new Promise((resolve, reject) => {
+        const args = [
+            "-hide_banner",
+            "-loglevel",
+            "error",
+            "-i",
+            path,
+            "-vn",
+            "-ac",
+            "1",
+            "-ar",
+            String(TARGET_SAMPLE_RATE),
+            "-f",
+            "f32le",
+            "-",
+        ];
+        const proc = spawn(ffmpegPath, args, { stdio: ["ignore", "pipe", "pipe"] });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        proc.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+        proc.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+        proc.on("error", reject);
+        proc.on("close", (code) => {
+            if (code !== 0) {
+                const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+                reject(new Error(`ffmpeg exited with code ${code}: ${stderr}`));
+                return;
+            }
+            const buf = Buffer.concat(stdoutChunks);
+            const samples = new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / Float32Array.BYTES_PER_ELEMENT);
+            const owned = new Float32Array(samples.length);
+            owned.set(samples);
+            resolve({
+                samples: owned,
+                sampleRate: TARGET_SAMPLE_RATE,
+                durationSec: owned.length / TARGET_SAMPLE_RATE,
+            });
+        });
+    });
+};
+//# sourceMappingURL=transcriber-impl.js.map

package/dist/services/voice/transcriber-impl.js.map

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

package/dist/services/voice/transcriber.d.ts

@@ -0,0 +1,117 @@
+import type Database from "better-sqlite3";
+export declare const VOICE_TRANSCRIBER_DEFAULTS: {
+    readonly enabled: true;
+    readonly model: "Xenova/whisper-small";
+    readonly language: string | null;
+    readonly maxDurationSec: 600;
+};
+export interface VoiceTranscriberOptions {
+    db: Database.Database;
+    modelDir: string;
+    /**
+     * `boolean` to lock the value at construction (legacy / test use), or
+     * `() => boolean` to read live from a runtime source — used in production
+     * so flipping `voiceTranscriptionEnabled` via the dashboard's voice
+     * install flow takes effect on the next inbound audio attachment without
+     * waiting for a daemon restart.
+     */
+    enabled?: boolean | (() => boolean);
+    model?: string;
+    language?: string | null;
+    maxDurationSec?: number;
+    /**
+     * Test seam — inject a transcribe function so dispatcher tests can
+     * exercise the wiring without spinning up Whisper. Production code
+     * leaves this undefined and the lazy loader builds the real pipeline
+     * via `@huggingface/transformers`.
+     */
+    loadPipeline?: PipelineLoader;
+    /**
+     * Test seam — inject a custom audio decoder. Production code uses
+     * `decodeAudioWithFfmpeg`, which spawns the bundled ffmpeg-static
+     * binary and returns 16 kHz mono Float32 samples.
+     */
+    decodeAudio?: AudioDecoder;
+}
+export interface DecodedAudio {
+    samples: Float32Array;
+    sampleRate: number;
+    durationSec: number;
+}
+export type AudioDecoder = (input: {
+    path: string;
+    mimeType: string;
+}) => Promise<DecodedAudio>;
+export interface WhisperPipelineOutput {
+    text: string;
+    language?: string | null;
+}
+export type WhisperPipeline = (samples: Float32Array, options: {
+    language?: string | null;
+    task: "transcribe";
+}) => Promise<WhisperPipelineOutput>;
+export interface PipelineProgressEvent {
+    status: "initiate" | "download" | "progress" | "done" | "ready" | string;
+    file?: string;
+    name?: string;
+    loaded?: number;
+    total?: number;
+    progress?: number;
+}
+export type PipelineLoader = (input: {
+    model: string;
+    modelDir: string;
+    onProgress?: (event: PipelineProgressEvent) => void;
+}) => Promise<WhisperPipeline>;
+export interface VoiceTranscriptionInput {
+    attachmentId: string;
+    path: string;
+    mimeType: string;
+}
+export interface VoiceTranscriptionResult {
+    attachmentId: string;
+    transcript: string;
+    language: string | null;
+    durationSec: number | null;
+    model: string;
+    fromCache: boolean;
+}
+/**
+ * VoiceTranscriber — local Whisper transcription for inbound audio
+ * attachments. See `docs/design/appendices/voice-transcription.md`.
+ *
+ * Lifecycle:
+ *  1. Constructor takes options + DB; no model load happens here.
+ *  2. First `transcribe(...)` call lazy-loads the pipeline.
+ *  3. Subsequent calls reuse the loaded pipeline. Concurrent calls for
+ *     the same `attachmentId` share a single in-flight promise; calls
+ *     for different attachments are serialized (single-flight queue)
+ *     so the CPU does not thrash.
+ *
+ * Failure modes degrade gracefully — every error returns `null` so the
+ * dispatcher falls back to the pre-feature behaviour (path-only file
+ * reference) without breaking the turn.
+ */
+export declare class VoiceTranscriber {
+    private readonly db;
+    private readonly modelDir;
+    private readonly enabledFn;
+    private readonly model;
+    private readonly language;
+    private readonly maxDurationSec;
+    private readonly loadPipeline;
+    private readonly decodeAudio;
+    private pipelinePromise;
+    private inflight;
+    private queue;
+    private setupDone;
+    constructor(opts: VoiceTranscriberOptions);
+    private ensureSetup;
+    isEnabled(): boolean;
+    isAudio(mimeType: string): boolean;
+    transcribe(input: VoiceTranscriptionInput): Promise<VoiceTranscriptionResult | null>;
+    private runQueued;
+    private transcribeUncached;
+    private ensurePipeline;
+}
+//# sourceMappingURL=transcriber.d.ts.map

package/dist/services/voice/transcriber.d.ts.map

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