@fraziym/axoniz 0.1.0

package/dist/tools/shell_tools.js

@@ -0,0 +1,163 @@
+/**
+ * AXONIZ ShellTools — Windows-aware shell execution (TypeScript port).
+ *
+ * Ported from `axoniz/tools/shell_tools.py`. Keeps: unix→windows command
+ * translation, output truncation limits, env injection, timeout handling and
+ * background process launch.
+ *
+ * Python-stdlib mapping:
+ *   subprocess.run(shell=True, capture_output=True, timeout=…) -> runCaptured
+ *   subprocess.Popen(DEVNULL, CREATE_NO_WINDOW)                -> spawn + detached
+ *   shutil.which                                               -> core whichSync
+ *   exec(compile(code))                                        -> a real Python
+ *     interpreter via `python -c`. This is a Node process, so there is no
+ *     in-process Python VM; the capability degrades gracefully with a clear
+ *     string when no interpreter is installed.
+ */
+import { spawn } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import { whichSync } from "../core/which.js";
+import { errText, execFileCaptured, runCaptured } from "./_internal.js";
+const IS_WINDOWS = process.platform === "win32";
+const MAX_OUTPUT = 8000; // chars, to avoid context overflow
+const _UNIX_TO_WIN = {
+    ls: "dir /b",
+    cat: "type",
+    rm: "del",
+    cp: "copy",
+    mv: "move",
+    grep: "findstr",
+    touch: "echo.>",
+    clear: "cls",
+    pwd: "cd",
+    which: "where",
+    echo: "echo",
+};
+export class ShellTools {
+    workspace;
+    constructor(workspace = ".") {
+        this.workspace = path.resolve(workspace);
+    }
+    /** Run a shell command. Windows-aware, auto-translates unix basics. */
+    async run(command, timeout = 60, env) {
+        let cmd = command.trim();
+        if (!cmd)
+            return "[ERROR] Empty command";
+        if (IS_WINDOWS) {
+            const first = (cmd.split(/\s+/)[0] ?? "").toLowerCase();
+            let note = "";
+            if (Object.prototype.hasOwnProperty.call(_UNIX_TO_WIN, first)) {
+                const win = _UNIX_TO_WIN[first];
+                // Python's `str.replace(first, win, 1)`: replaces the first occurrence.
+                cmd = cmd.replace(first, win);
+                note = `[auto] '${first}' → '${win}'\n`;
+            }
+            const result = await this._runRaw(cmd, timeout, env);
+            return note ? note + result : result;
+        }
+        return this._runRaw(cmd, timeout, env);
+    }
+    async _runRaw(command, timeout = 60, env) {
+        const mergedEnv = { ...process.env };
+        if (env)
+            Object.assign(mergedEnv, env);
+        try {
+            const res = await runCaptured(command, {
+                cwd: this.workspace,
+                env: mergedEnv,
+                timeoutMs: Math.max(0, timeout) * 1000,
+            });
+            if (res.timedOut)
+                return `[TIMEOUT] Command killed after ${timeout}s: ${command}`;
+            let out = res.stdout.trim();
+            let err = res.stderr.trim();
+            const code = res.code ?? 0;
+            if (out.length > MAX_OUTPUT) {
+                // Python re-reads `len(out)` after the slice for the reported total.
+                out = out.slice(0, MAX_OUTPUT);
+                out = `${out}\n… [truncated, ${out.length} total chars]`;
+            }
+            if (err.length > 2000) {
+                err = `${err.slice(0, 2000)}… [truncated]`;
+            }
+            const parts = [`$ ${command}  [exit ${code}]`];
+            if (out)
+                parts.push(out);
+            if (err)
+                parts.push(`stderr: ${err}`);
+            if (!out && !err)
+                parts.push("(no output)");
+            return parts.join("\n");
+        }
+        catch (e) {
+            return `[ERROR] Shell: ${errText(e)}`;
+        }
+    }
+    /** Start a background process (non-blocking). Returns PID. */
+    runBg(command) {
+        try {
+            const child = spawn(command, {
+                shell: true,
+                cwd: this.workspace,
+                stdio: "ignore",
+                detached: true,
+                windowsHide: true,
+            });
+            child.unref();
+            return `[OK] Background process started  pid=${child.pid}  cmd=${command}`;
+        }
+        catch (e) {
+            return `[ERROR] Background process failed: ${errText(e)}`;
+        }
+    }
+    /**
+     * Execute Python inline, capture output.
+     *
+     * NOTE: the Python original used in-process `exec()`. A Node process has no
+     * Python VM, so the code is handed to an interpreter found on PATH
+     * (`python`, then `python3`); if none exists a clear `[PYTHON ERROR]` string
+     * is returned rather than throwing.
+     */
+    async runPython(code) {
+        const python = whichSync("python") ?? whichSync("python3");
+        if (!python) {
+            return ("[PYTHON ERROR]\n" +
+                "The 'python' interpreter was not found on PATH. Inline Python execution " +
+                "requires a Python installation (the Python original ran the code in-process).");
+        }
+        try {
+            const res = await execFileCaptured(python, ["-c", code], {
+                cwd: this.workspace,
+                timeoutMs: 60_000,
+            });
+            const out = res.stdout;
+            const err = res.stderr;
+            const parts = [`python (${code.length} chars)`];
+            if (out)
+                parts.push(out.slice(0, MAX_OUTPUT));
+            if (err)
+                parts.push(`stderr:\n${err.slice(0, 2000)}`);
+            if (!out && !err)
+                parts.push("(no output)");
+            return parts.join("\n");
+        }
+        catch (e) {
+            return `[PYTHON ERROR]\n${errText(e).slice(0, 3000)}`;
+        }
+    }
+    /** Check if a program is available in PATH. */
+    which(name) {
+        const p = whichSync(name);
+        return p ? `[OK] ${name} → ${p}` : `[NOT FOUND] ${name} not in PATH`;
+    }
+    /** Return useful environment info. */
+    envInfo() {
+        const pathEntries = (process.env.PATH ?? "").split(path.delimiter).length;
+        return (`Node ${process.version}\n` +
+            `OS: ${os.type()} ${os.release()}\n` +
+            `CWD: ${this.workspace}\n` +
+            `PATH entries: ${pathEntries}`);
+    }
+}
+//# sourceMappingURL=shell_tools.js.map

package/dist/tools/shell_tools.js.map

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

package/dist/tools/web_tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AXONIZ WebTools — web access (TypeScript port).
+ *
+ * Ported from `axoniz/tools/web_tools.py`. Keeps the DuckDuckGo HTML-scrape
+ * search (no external API keys) and the HTML→text sanitisation pipeline.
+ *
+ * Python-stdlib mapping:
+ *   urllib.request.urlopen(req, timeout=15) -> global fetch + AbortSignal.timeout
+ *   re.sub(re.DOTALL)                       -> RegExp with the `s` flag
+ */
+export declare class WebTools {
+    /**
+     * NOTE: the Python original also carried `self.workspace`. It was never read
+     * in `web_tools.py`, so it is accepted for constructor-signature parity but
+     * intentionally unused.
+     */
+    readonly workspace: string;
+    readonly HEADERS: Record<string, string>;
+    constructor(workspace?: string);
+    /**
+     * Retrieve the textual content of a URL, stripping HTML boilerplate and
+     * focusing on readable text.
+     */
+    get(url: string, maxChars?: number): Promise<string>;
+    /**
+     * Web search via DuckDuckGo's lightweight HTML interface.
+     * Returns a structured summary of titles, URLs and snippets.
+     */
+    search(query: string, maxResults?: number): Promise<string>;
+}
+//# sourceMappingURL=web_tools.d.ts.map

package/dist/tools/web_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_tools.d.ts","sourceRoot":"","sources":["../../src/tools/web_tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAa,QAAQ;IACnB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAG3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtC;IAEF,YAAY,SAAS,SAAM,EAE1B;IAED;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBvD;IAED;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC3D;CACF"}

package/dist/tools/web_tools.js

@@ -0,0 +1,117 @@
+/**
+ * AXONIZ WebTools — web access (TypeScript port).
+ *
+ * Ported from `axoniz/tools/web_tools.py`. Keeps the DuckDuckGo HTML-scrape
+ * search (no external API keys) and the HTML→text sanitisation pipeline.
+ *
+ * Python-stdlib mapping:
+ *   urllib.request.urlopen(req, timeout=15) -> global fetch + AbortSignal.timeout
+ *   re.sub(re.DOTALL)                       -> RegExp with the `s` flag
+ */
+export class WebTools {
+    /**
+     * NOTE: the Python original also carried `self.workspace`. It was never read
+     * in `web_tools.py`, so it is accepted for constructor-signature parity but
+     * intentionally unused.
+     */
+    workspace;
+    // Standard identification header for reliable communication with servers.
+    HEADERS = {
+        "User-Agent": "Mozilla/5.0 (AXONIZ-ZERO Intelligence Agent/1.0)",
+    };
+    constructor(workspace = ".") {
+        this.workspace = workspace;
+    }
+    /**
+     * Retrieve the textual content of a URL, stripping HTML boilerplate and
+     * focusing on readable text.
+     */
+    async get(url, maxChars = 8000) {
+        try {
+            const resp = await fetch(url, {
+                headers: this.HEADERS,
+                signal: AbortSignal.timeout(15_000),
+                redirect: "follow",
+            });
+            if (!resp.ok)
+                throw new Error(`HTTP ${resp.status} ${resp.statusText}`);
+            const raw = await readBodyText(resp);
+            // High-efficiency sanitization: removal of non-content elements.
+            let text = raw.replace(/<style[^>]*>[\s\S]*?<\/style>/g, "");
+            text = text.replace(/<script[^>]*>[\s\S]*?<\/script>/g, "");
+            text = text.replace(/<[^>]+>/g, " ");
+            text = text.replace(/\s+/g, " ").trim();
+            // Enforcing a safe buffer limit to prevent context overflow.
+            if (text.length > maxChars) {
+                text = `${text.slice(0, maxChars)}\n... (Content truncated for brevity, ${text.length} total characters)`;
+            }
+            return `Retrieved Content from ${url}:\n${text}`;
+        }
+        catch (e) {
+            return `Error: Unable to access ${url}. ${errorText(e)}`;
+        }
+    }
+    /**
+     * Web search via DuckDuckGo's lightweight HTML interface.
+     * Returns a structured summary of titles, URLs and snippets.
+     */
+    async search(query, maxResults = 5) {
+        try {
+            // Preparing the search query for the URL (urllib.parse.quote_plus).
+            const encoded = encodeURIComponent(query).replace(/%20/g, "+");
+            const url = `https://html.duckduckgo.com/html/?q=${encoded}`;
+            const resp = await fetch(url, {
+                headers: { ...this.HEADERS, "Accept-Language": "en-US" },
+                signal: AbortSignal.timeout(15_000),
+                redirect: "follow",
+            });
+            if (!resp.ok)
+                throw new Error(`HTTP ${resp.status} ${resp.statusText}`);
+            const raw = await readBodyText(resp);
+            // Parsing the search result blocks from the raw response.
+            const results = [];
+            const blocks = raw.match(/class="result__body"[\s\S]*?(?=class="result__body"|$)/g) ?? [];
+            for (const block of blocks.slice(0, maxResults)) {
+                const titleM = /class="result__a[^"]*"[^>]*>([\s\S]*?)<\/a>/.exec(block);
+                const urlM = /href="(https?:\/\/[^"]+)"/.exec(block);
+                const snippetM = /class="result__snippet"[^>]*>([\s\S]*?)<\/span>/.exec(block);
+                const title = titleM ? stripTags(titleM[1]).trim() : "Untitled Result";
+                const resultUrl = urlM ? urlM[1] : "No link available";
+                const snippet = snippetM ? stripTags(snippetM[1]).trim() : "No summary available.";
+                results.push(`  [${results.length + 1}] ${title}\n      Source: ${resultUrl}\n      Summary: ${snippet}`);
+            }
+            if (results.length === 0) {
+                return `Intelligence Report: No relevant information found for '${query}'.`;
+            }
+            return `Web Search Results for '${query}':\n${results.join("\n\n")}`;
+        }
+        catch (e) {
+            return `Error: Search operation failed. ${errorText(e)}`;
+        }
+    }
+}
+/* ── helpers ─────────────────────────────────────────────────────────────── */
+function stripTags(html) {
+    return html.replace(/<[^>]+>/g, "");
+}
+/** Python's `str(e)` rendering for an unknown thrown value. */
+function errorText(e) {
+    if (e instanceof Error)
+        return e.message || e.name;
+    if (typeof e === "string")
+        return e;
+    try {
+        return JSON.stringify(e);
+    }
+    catch {
+        return String(e);
+    }
+}
+/** Read a response body as UTF-8 with undecodable bytes replaced, with a cap. */
+async function readBodyText(resp) {
+    const buf = Buffer.from(await resp.arrayBuffer());
+    const capped = buf.length > WebTools_MAX_BODY ? buf.subarray(0, WebTools_MAX_BODY) : buf;
+    return capped.toString("utf8");
+}
+const WebTools_MAX_BODY = 20 * 1024 * 1024;
+//# sourceMappingURL=web_tools.js.map

package/dist/tools/web_tools.js.map

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

package/dist/voice/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * src/voice/index.ts
+ * ====================
+ * BERU voice stack — offline-first.
+ *
+ * STT:   Moonshine → faster-whisper → whisper → SpeechRecognition
+ * TTS:   Kokoro-82M → Piper → edge-tts → pyttsx3
+ * Wake:  openwakeword → sr_polling
+ *
+ * Quick start:
+ *   import { start_light_daemon } from "./index.js";
+ *   const d = start_light_daemon();   // boots in the background
+ *   d.say("BERU is online.");
+ *
+ * ── Node capability note ─────────────────────────────────────────────────────
+ * The Python engines named above are Python-only and not installable here. The
+ * public surface below is identical; the working path is `msedge-tts`, and STT /
+ * wake word / audio I/O use runtime-registered backends
+ * (`registerSTTBackend`, `registerWakeDetector`, `setAudioInputDriver`).
+ * Degraded calls return or emit a descriptive `[ERROR] …` string.
+ */
+import { TTSEngine, get_tts } from "./tts.js";
+import { STTEngine, get_stt } from "./stt.js";
+import { WakeWordDetector, get_wake_detector } from "./wake_word.js";
+import { VoiceLoop, start_voice_loop, get_voice_loop } from "./voice_loop.js";
+import { LightDaemon, start_light_daemon, get_daemon } from "./light_daemon.js";
+export { TTSEngine, get_tts, STTEngine, get_stt, WakeWordDetector, get_wake_detector, VoiceLoop, start_voice_loop, get_voice_loop, LightDaemon, start_light_daemon, get_daemon, };
+export { getTts, registerTTSBackend, unregisterTTSBackend, speakWithFallback } from "./tts.js";
+export { getStt, registerSTTBackend, unregisterSTTBackend } from "./stt.js";
+export { getWakeDetector, registerWakeDetector, registerClipRecognizer } from "./wake_word.js";
+export { 
+/** Register a live microphone capture driver (was `sounddevice`/`pyaudio`). */
+setAudioInputDriver, getAudioInputDriver, 
+/** Register a live playback driver (was `soundplay`/`sounddevice`). */
+setAudioOutputDriver, getAudioOutputDriver, writeWav, readWav, encodeWavPcm16, SAMPLE_RATE as AUDIO_SAMPLE_RATE, type AudioInputDriver, type AudioOutputDriver, type AudioRecordOptions, } from "./wav.js";
+export { LightVoiceDaemon, LightDaemon as LightDaemonAlias, getDaemon, startLightDaemon } from "./light_daemon.js";
+export { getVoiceLoop, startVoiceLoop, VoiceState } from "./voice_loop.js";
+export { getTts as getTTSEngine } from "./tts.js";
+/** Python `__init__.py` `__all__` equivalent. */
+export declare const __all__: readonly ["TTSEngine", "get_tts", "STTEngine", "get_stt", "WakeWordDetector", "get_wake_detector", "VoiceLoop", "start_voice_loop", "get_voice_loop", "LightDaemon", "start_light_daemon", "get_daemon"];
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,GACX,CAAC;AAOF,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO;AACL,+EAA+E;AAC/E,mBAAmB,EACnB,mBAAmB;AACnB,uEAAuE;AACvE,oBAAoB,EACpB,oBAAoB,EACpB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,WAAW,IAAI,iBAAiB,EAChC,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,gBAAgB,EAAE,WAAW,IAAI,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;AAElD,iDAAiD;AACjD,eAAO,MAAM,OAAO,YAClB,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,YAAY,CACJ,CAAC"}

package/dist/voice/index.js

@@ -0,0 +1,58 @@
+/**
+ * src/voice/index.ts
+ * ====================
+ * BERU voice stack — offline-first.
+ *
+ * STT:   Moonshine → faster-whisper → whisper → SpeechRecognition
+ * TTS:   Kokoro-82M → Piper → edge-tts → pyttsx3
+ * Wake:  openwakeword → sr_polling
+ *
+ * Quick start:
+ *   import { start_light_daemon } from "./index.js";
+ *   const d = start_light_daemon();   // boots in the background
+ *   d.say("BERU is online.");
+ *
+ * ── Node capability note ─────────────────────────────────────────────────────
+ * The Python engines named above are Python-only and not installable here. The
+ * public surface below is identical; the working path is `msedge-tts`, and STT /
+ * wake word / audio I/O use runtime-registered backends
+ * (`registerSTTBackend`, `registerWakeDetector`, `setAudioInputDriver`).
+ * Degraded calls return or emit a descriptive `[ERROR] …` string.
+ */
+import { TTSEngine, get_tts } from "./tts.js";
+import { STTEngine, get_stt } from "./stt.js";
+import { WakeWordDetector, get_wake_detector } from "./wake_word.js";
+import { VoiceLoop, start_voice_loop, get_voice_loop } from "./voice_loop.js";
+import { LightDaemon, start_light_daemon, get_daemon } from "./light_daemon.js";
+export { TTSEngine, get_tts, STTEngine, get_stt, WakeWordDetector, get_wake_detector, VoiceLoop, start_voice_loop, get_voice_loop, LightDaemon, start_light_daemon, get_daemon, };
+/* ── Extra surface (Node port) ─────────────────────────────────────────────────
+ * camelCase aliases plus the runtime-registration seams for the capabilities
+ * whose Python engines have no Node equivalent.
+ * --------------------------------------------------------------------------- */
+export { getTts, registerTTSBackend, unregisterTTSBackend, speakWithFallback } from "./tts.js";
+export { getStt, registerSTTBackend, unregisterSTTBackend } from "./stt.js";
+export { getWakeDetector, registerWakeDetector, registerClipRecognizer } from "./wake_word.js";
+export { 
+/** Register a live microphone capture driver (was `sounddevice`/`pyaudio`). */
+setAudioInputDriver, getAudioInputDriver, 
+/** Register a live playback driver (was `soundplay`/`sounddevice`). */
+setAudioOutputDriver, getAudioOutputDriver, writeWav, readWav, encodeWavPcm16, SAMPLE_RATE as AUDIO_SAMPLE_RATE, } from "./wav.js";
+export { LightVoiceDaemon, LightDaemon as LightDaemonAlias, getDaemon, startLightDaemon } from "./light_daemon.js";
+export { getVoiceLoop, startVoiceLoop, VoiceState } from "./voice_loop.js";
+export { getTts as getTTSEngine } from "./tts.js";
+/** Python `__init__.py` `__all__` equivalent. */
+export const __all__ = [
+    "TTSEngine",
+    "get_tts",
+    "STTEngine",
+    "get_stt",
+    "WakeWordDetector",
+    "get_wake_detector",
+    "VoiceLoop",
+    "start_voice_loop",
+    "get_voice_loop",
+    "LightDaemon",
+    "start_light_daemon",
+    "get_daemon",
+];
+//# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EACL,SAAS,EACT,OAAO,EACP,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,GACX,CAAC;AAEF;;;iFAGiF;AAEjF,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO;AACL,+EAA+E;AAC/E,mBAAmB,EACnB,mBAAmB;AACnB,uEAAuE;AACvE,oBAAoB,EACpB,oBAAoB,EACpB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,WAAW,IAAI,iBAAiB,GAIjC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,gBAAgB,EAAE,WAAW,IAAI,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;AAElD,iDAAiD;AACjD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,WAAW;IACX,SAAS;IACT,WAAW;IACX,SAAS;IACT,kBAAkB;IAClB,mBAAmB;IACnB,WAAW;IACX,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,YAAY;CACJ,CAAC"}

package/dist/voice/light_daemon.d.ts

@@ -0,0 +1,197 @@
+/**
+ * src/voice/light_daemon.ts
+ * ============================
+ * BERU Light Voice Daemon — two-tier, minimal RAM.
+ *
+ * Architecture
+ * ------------
+ *   ALWAYS ON  (idle RAM ~80-160 MB total):
+ *     openwakeword ONNX   —  ~1 MB  —  wake word detection
+ *     faster-whisper tiny — ~75 MB  —  speech-to-text (int8 CPU)
+ *     edge-tts            —   0 MB  —  text-to-speech (MS cloud stream)
+ *
+ *   ON DEMAND  (no weights ever loaded locally):
+ *     Tier 1 — regex classifier answers simple queries instantly (time, date, …)
+ *     Tier 2 — one stateless HTTP call to Anthropic / Groq / OpenAI
+ *              only fires when the query is complex
+ *              zero model weights in RAM
+ *
+ *   NEVER LOADED:
+ *     The full axoniz Agent, LM Studio, Ollama, or any local LLM.
+ *
+ * Usage
+ * -----
+ *   const d = start_light_daemon();
+ *   // runs forever — say "Beru" to wake
+ *   // d.say("BERU is online.")
+ *
+ * ── Node reality ─────────────────────────────────────────────────────────────
+ * Scheduling, watching, intent classification, LLM calls, trimming and event
+ * emission are ported faithfully. Only the OS-level audio primitives degrade:
+ *   - wake word  → `WakeWordDetector` from src/voice/wake_word.ts (register a
+ *                  detector; `openwakeword`/`pvporcupine` are Python-only)
+ *   - mic        → registered audio input driver (was `pyaudio`)
+ *   - STT        → `_WhisperSTT` wraps the pluggable `STTEngine` (was
+ *                  `faster-whisper`; no Node engine is installed)
+ *   - TTS        → `msedge-tts` (installed) via `src/voice/tts.ts`
+ * Every degraded path returns/emits a clear `[ERROR] …` string and never throws.
+ */
+import { type TTSEngine } from "./tts.js";
+import { STTEngine } from "./stt.js";
+import { type WakeWordDetector } from "./wake_word.js";
+export declare const WHISPER_MODEL: string;
+export declare const WHISPER_DEVICE = "cpu";
+export declare const SAMPLE_RATE = 16000;
+export declare const LISTEN_SECS = 7;
+export declare const SILENCE_THRESH = 500;
+export declare const SILENCE_FRAMES = 20;
+/** Master debug flag — set to false to quiet down. */
+export declare let DBG: boolean;
+export declare function setDbg(on: boolean): void;
+export declare const _STOP_WORDS: Set<string>;
+export type IntentTier = "stop" | "local" | "llm";
+/** Returns 'stop', 'local', or 'llm'. */
+export declare function _classify(text: string): IntentTier;
+/** Answer without any network call. */
+export declare function _local_response(text: string): string;
+/**
+ * TODO(port): Python imported the `anthropic`, `groq` and `openai` SDKs. None is
+ * installed here, so each provider is called over plain `fetch` against the same
+ * REST endpoints — same models, same prompts, same shapes, zero new dependencies.
+ * Recommended replacement: keep the HTTP path; add `undici` ProxyAgent only if a
+ * corporate proxy is required.
+ */
+export declare class _LLMClient {
+    static readonly SYSTEM: string;
+    provider: string;
+    apiKey: string | null;
+    model: string | null;
+    baseUrl: string | null;
+    private _backend;
+    constructor(provider?: string, apiKey?: string | null, model?: string | null, baseUrl?: string | null);
+    private _detect;
+    get backend(): string;
+    get available(): boolean;
+    ask(prompt: string, maxTokens?: number): Promise<string>;
+    private _ask_anthropic;
+    private _ask_groq;
+    private _ask_openai;
+}
+/**
+ * TODO(port): Python held a `faster_whisper.WhisperModel` here. No Node STT
+ * engine is installed. `_WhisperSTT` now wraps the pluggable `STTEngine` from
+ * src/voice/stt.ts (register one with `registerSTTBackend`, or put a whisper.cpp
+ * `whisper-cli` on PATH). Until then `available` is false and `transcribe_pcm`
+ * returns "" while emitting a descriptive `[ERROR] …` via `lastError`.
+ */
+export declare class _WhisperSTT {
+    /** Exposed because the Python daemon printed it in `start()`/`info()`. */
+    readonly _model_size: string;
+    private _engine;
+    private _lastError;
+    constructor(modelSize?: string, engine?: STTEngine | null);
+    get lastError(): string;
+    get available(): boolean;
+    /** Transcribe raw 16-bit 16 kHz mono PCM. Returns text or empty string. */
+    transcribe_pcm(pcmBytes: Buffer): Promise<string>;
+    transcribePcm(pcmBytes: Buffer): Promise<string>;
+}
+export interface RecordMicOptions {
+    max_secs?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Record from mic until silence or timeout. Returns raw 16-bit PCM bytes.
+ *
+ * TODO(port): Python used `pyaudio` (PortAudio) with a 1024-frame read loop.
+ * There is no Node audio I/O dependency installed — a driver registered through
+ * `setAudioInputDriver()` supplies the frames; without one this logs a clear
+ * `[ERROR] …` and returns an empty buffer.
+ */
+export declare function _record_mic(arg?: number | RecordMicOptions, signal?: AbortSignal): Promise<Buffer>;
+/** Test/DI hook. */
+export declare function setSpeakEngine(engine: TTSEngine | null): void;
+/**
+ * Speak text aloud. Priority (ported from the Python module-level `_speak()`):
+ *   1. msedge-tts → audio output driver   (best quality, free)
+ *   2. msedge-tts → OS player fallback    (PowerShell MediaPlayer on Windows)
+ *   3. offline OS TTS slot                (was pyttsx3 — NOT implemented)
+ *   4. print                              (last resort)
+ *
+ * TODO(port): step 1/2 require a registered audio output driver; step 3 needs a
+ * Node offline TTS backend (see `OFFLINE_TTS_ERROR` in src/voice/tts.ts). All
+ * failures are logged as `[ERROR] …` and never throw.
+ */
+export declare function _speak(text: string): Promise<void>;
+export declare function _speak_sync_fallback(text: string): void;
+export declare function _trim(text: string, maxChars?: number): string;
+export interface LightDaemonOptions {
+    provider?: string;
+    api_key?: string;
+    model?: string;
+    base_url?: string;
+    whisper_model?: string;
+    on_state_change?: (state: string) => void;
+}
+export declare class LightVoiceDaemon {
+    /**
+     * BERU light voice daemon.
+     *
+     * Idle RAM: ~80 MB (whisper-tiny int8 CPU + openwakeword ONNX)
+     * NO local LLM is ever loaded. Complex queries go to the API only.
+     */
+    private _llm;
+    private _stt;
+    private _wwd;
+    private _on_state;
+    private _state;
+    private _stop_ev;
+    private _wake_ev;
+    private _abort;
+    private _thread;
+    constructor(options?: LightDaemonOptions);
+    start(): void;
+    stop(): void;
+    is_running(): boolean;
+    isRunning(): boolean;
+    get state(): string;
+    /** Speak text immediately (compat with the old LightDaemon API). */
+    say(text: string, async_?: boolean): void;
+    /** Capture one utterance and return its transcription. */
+    listen_once(): Promise<string | null>;
+    listenOnce(): Promise<string | null>;
+    info(): Record<string, unknown>;
+    private _set_state;
+    /**
+     * Wire the whisper-polling fallback so the wake detector can reuse this
+     * daemon's STT engine — this is the Node equivalent of the Python "faster-whisper
+     * is already a dep of light_daemon" coupling.
+     */
+    private _init_wake_word;
+    private _on_wake;
+    private _loop;
+    /** Expose the wake detector for tests/embedding. */
+    get wakeDetector(): WakeWordDetector | null;
+}
+/** Keep LightDaemon as an alias so older code doesn't break. */
+export declare const LightDaemon: typeof LightVoiceDaemon;
+export type LightDaemonType = LightVoiceDaemon;
+export interface StartLightDaemonOptions extends LightDaemonOptions {
+    /** Legacy kwargs silently ignored so old call sites don't crash. */
+    agent?: unknown;
+    verbose?: boolean;
+    auto_start?: boolean;
+}
+/**
+ * Start BERU's light voice daemon in the background.
+ * No local LLM is ever loaded. Returns immediately.
+ */
+export declare function start_light_daemon(options?: StartLightDaemonOptions): LightVoiceDaemon;
+/** camelCase alias of `start_light_daemon`. */
+export declare const startLightDaemon: typeof start_light_daemon;
+export declare function get_daemon(): LightVoiceDaemon | null;
+/** camelCase alias of `get_daemon`. */
+export declare const getDaemon: typeof get_daemon;
+/** Test/DI hook — replace the singleton. */
+export declare function setDaemon(d: LightVoiceDaemon | null): void;
+//# sourceMappingURL=light_daemon.d.ts.map

package/dist/voice/light_daemon.d.ts.map

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