@fraziym/axoniz 0.1.0

package/dist/voice/wav.d.ts

@@ -0,0 +1,99 @@
+/**
+ * src/voice/wav.ts
+ * =================
+ * Shared low-level audio primitives for the BERU voice stack.
+ *
+ * The Python stack leaned on `soundfile` / `scipy.io.wavfile` / `wave` for file
+ * I/O and on `sounddevice` / `pyaudio` for live device I/O. Neither exists in
+ * Node.js here, so this module provides:
+ *
+ *   1. A hand-rolled 44-byte RIFF/PCM WAV writer + reader (`node:fs` only).
+ *   2. The pluggable audio-driver registry used for live capture/playback.
+ *
+ * TODO(port): live mic capture and speaker playback need a native driver.
+ *   Recommended replacements (verify install on this machine first):
+ *     - `naudiodon2` / `audify` / `speaker` / `node-record-lpcm16` (PortAudio)
+ *   Until one is registered via `setAudioInputDriver()` / `setAudioOutputDriver()`
+ *   every entry point returns a descriptive `[ERROR] ...` string and never throws.
+ *
+ * This file is an internal helper for `src/voice/*` — it is not part of the
+ * public `__init__.py` export surface.
+ */
+/** Kokoro/Moonshine/Whisper/edge-tts all agree on 16 kHz mono for BERU's mic path. */
+export declare const SAMPLE_RATE = 16000;
+/** RIFF header is exactly 44 bytes for a canonical PCM WAV. */
+export declare const WAV_HEADER_BYTES = 44;
+/**
+ * Build a complete 16-bit PCM mono WAV file image in memory.
+ * Mirrors what Python's `wave` module + `numpy.tobytes()` produced.
+ */
+export declare function encodeWavPcm16(pcm: Buffer, sampleRate?: number, channels?: number): Buffer;
+/** Convert a float32 sample array ([-1, 1]) into little-endian 16-bit PCM bytes. */
+export declare function floatToPcm16(samples: Float32Array): Buffer;
+/** Convert little-endian 16-bit PCM bytes into a float32 sample array. */
+export declare function pcm16ToFloat(pcm: Buffer): Float32Array;
+/**
+ * Write a 16-bit PCM WAV file.
+ * Handles both `Float32Array` (float samples in [-1,1]) and raw PCM `Buffer`.
+ */
+export declare function writeWav(filePath: string, samples: Float32Array | Int16Array | Buffer, sampleRate?: number, channels?: number): void;
+export interface DecodedWav {
+    samples: Float32Array;
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+}
+/**
+ * Decode a PCM WAV file. Walks the chunk list rather than assuming 44 bytes so
+ * files with LIST/fact chunks still load. Returns `null` when the file is not a
+ * readable PCM WAV (mirrors `soundfile.read` raising + the Python `try/except`).
+ */
+export declare function readWav(filePath: string): DecodedWav | null;
+/** Mean absolute amplitude of 16-bit PCM in [0, 32767] — Python `sum(abs(s))/n`. */
+export declare function pcm16MeanAbs(pcm: Buffer): number;
+/** Root-mean-square of float samples — Python `np.sqrt(np.mean(chunk ** 2))`. */
+export declare function rmsFloat(samples: Float32Array): number;
+export interface AudioRecordOptions {
+    /** Maximum number of seconds to capture. */
+    maxSeconds: number;
+    /** 16-bit mono PCM sample rate. */
+    sampleRate: number;
+    /** Stop after this many seconds of continuous near-silence. */
+    silenceSeconds?: number;
+    /** Mean-absolute-amplitude threshold (0..32767) counted as speech. */
+    energyThreshold?: number;
+    /** Cooperative cancellation. */
+    signal?: AbortSignal;
+}
+export interface AudioInputDriver {
+    readonly name: string;
+    /** Capture raw 16-bit 16 kHz mono PCM. Empty buffer == nothing heard. */
+    record(options: AudioRecordOptions): Promise<Buffer>;
+}
+export interface AudioOutputDriver {
+    readonly name: string;
+    /** Play a WAV (or any file the OS codec handles). Resolves when playback ends. */
+    playFile(filePath: string): Promise<void>;
+}
+export declare function setAudioInputDriver(driver: AudioInputDriver | null): void;
+export declare function getAudioInputDriver(): AudioInputDriver | null;
+export declare function setAudioOutputDriver(driver: AudioOutputDriver | null): void;
+/**
+ * Playback driver, if one is available.
+ *
+ * TODO(port): there is no in-process audio I/O dependency. The fallbacks below
+ * shell out to OS players, which is what the Python `_play_file()` did after
+ * `sounddevice` failed. Recommended real replacement: `speaker` or `audify`.
+ */
+export declare function getAudioOutputDriver(): AudioOutputDriver | null;
+export declare const AUDIO_INPUT_MISSING_ERROR: string;
+export declare const AUDIO_OUTPUT_MISSING_ERROR: string;
+/** Run an external command, resolving with `{ code, stdout, stderr }` (never rejects). */
+export declare function runCommand(cmd: string, args: string[], timeoutMs?: number, stdin?: Buffer): Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+/** Escape a value for a single-quoted PowerShell string literal. */
+export declare function psQuote(s: string): string;
+//# sourceMappingURL=wav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wav.d.ts","sourceRoot":"","sources":["../../src/voice/wav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,sFAAsF;AACtF,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAanC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAoB,EAAE,QAAQ,SAAI,GAAG,MAAM,CAoBlG;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAI1D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAKtD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,EAC3C,UAAU,GAAE,MAAoB,EAChC,QAAQ,SAAI,GACX,IAAI,CAYN;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA2C3D;AAMD,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAKtD;AAMD,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAKD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEzE;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAM/D;AAED,eAAO,MAAM,yBAAyB,QAGgC,CAAC;AAEvE,eAAO,MAAM,0BAA0B,QAGkB,CAAC;AAE1D,0FAA0F;AAC1F,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,SAAS,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8C3D;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/voice/wav.js

@@ -0,0 +1,306 @@
+/**
+ * src/voice/wav.ts
+ * =================
+ * Shared low-level audio primitives for the BERU voice stack.
+ *
+ * The Python stack leaned on `soundfile` / `scipy.io.wavfile` / `wave` for file
+ * I/O and on `sounddevice` / `pyaudio` for live device I/O. Neither exists in
+ * Node.js here, so this module provides:
+ *
+ *   1. A hand-rolled 44-byte RIFF/PCM WAV writer + reader (`node:fs` only).
+ *   2. The pluggable audio-driver registry used for live capture/playback.
+ *
+ * TODO(port): live mic capture and speaker playback need a native driver.
+ *   Recommended replacements (verify install on this machine first):
+ *     - `naudiodon2` / `audify` / `speaker` / `node-record-lpcm16` (PortAudio)
+ *   Until one is registered via `setAudioInputDriver()` / `setAudioOutputDriver()`
+ *   every entry point returns a descriptive `[ERROR] ...` string and never throws.
+ *
+ * This file is an internal helper for `src/voice/*` — it is not part of the
+ * public `__init__.py` export surface.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { whichSync } from "../core/which.js";
+/** Kokoro/Moonshine/Whisper/edge-tts all agree on 16 kHz mono for BERU's mic path. */
+export const SAMPLE_RATE = 16_000;
+/** RIFF header is exactly 44 bytes for a canonical PCM WAV. */
+export const WAV_HEADER_BYTES = 44;
+/* ────────────────────────────────────────────────────────────────────────────
+ * WAV encode / decode (replaces `soundfile` + Python `wave`)
+ * ──────────────────────────────────────────────────────────────────────────── */
+/** Clamp a float sample in [-1, 1] to a signed 16-bit integer. */
+function toInt16(sample) {
+    const v = Math.max(-1, Math.min(1, sample));
+    // 32767 for positive, 32768 for negative — matches numpy's astype(int16) edge.
+    return v < 0 ? Math.round(v * 0x8000) : Math.round(v * 0x7fff);
+}
+/**
+ * Build a complete 16-bit PCM mono WAV file image in memory.
+ * Mirrors what Python's `wave` module + `numpy.tobytes()` produced.
+ */
+export function encodeWavPcm16(pcm, sampleRate = SAMPLE_RATE, channels = 1) {
+    const header = Buffer.alloc(WAV_HEADER_BYTES);
+    const byteRate = sampleRate * channels * 2;
+    const blockAlign = channels * 2;
+    header.write("RIFF", 0, "ascii");
+    header.writeUInt32LE(36 + pcm.length, 4); // RIFF chunk size
+    header.write("WAVE", 8, "ascii");
+    header.write("fmt ", 12, "ascii");
+    header.writeUInt32LE(16, 16); // fmt chunk size (PCM)
+    header.writeUInt16LE(1, 20); // audio format = PCM
+    header.writeUInt16LE(channels, 22);
+    header.writeUInt32LE(sampleRate, 24);
+    header.writeUInt32LE(byteRate, 28);
+    header.writeUInt16LE(blockAlign, 32);
+    header.writeUInt16LE(16, 34); // bits per sample
+    header.write("data", 36, "ascii");
+    header.writeUInt32LE(pcm.length, 40);
+    return Buffer.concat([header, pcm]);
+}
+/** Convert a float32 sample array ([-1, 1]) into little-endian 16-bit PCM bytes. */
+export function floatToPcm16(samples) {
+    const out = Buffer.alloc(samples.length * 2);
+    for (let i = 0; i < samples.length; i++)
+        out.writeInt16LE(toInt16(samples[i] ?? 0), i * 2);
+    return out;
+}
+/** Convert little-endian 16-bit PCM bytes into a float32 sample array. */
+export function pcm16ToFloat(pcm) {
+    const n = Math.floor(pcm.length / 2);
+    const out = new Float32Array(n);
+    for (let i = 0; i < n; i++)
+        out[i] = pcm.readInt16LE(i * 2) / 32768;
+    return out;
+}
+/**
+ * Write a 16-bit PCM WAV file.
+ * Handles both `Float32Array` (float samples in [-1,1]) and raw PCM `Buffer`.
+ */
+export function writeWav(filePath, samples, sampleRate = SAMPLE_RATE, channels = 1) {
+    let pcm;
+    if (Buffer.isBuffer(samples)) {
+        pcm = samples;
+    }
+    else if (samples instanceof Float32Array) {
+        pcm = floatToPcm16(samples);
+    }
+    else {
+        pcm = Buffer.alloc(samples.length * 2);
+        for (let i = 0; i < samples.length; i++)
+            pcm.writeInt16LE(samples[i] ?? 0, i * 2);
+    }
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, encodeWavPcm16(pcm, sampleRate, channels));
+}
+/**
+ * Decode a PCM WAV file. Walks the chunk list rather than assuming 44 bytes so
+ * files with LIST/fact chunks still load. Returns `null` when the file is not a
+ * readable PCM WAV (mirrors `soundfile.read` raising + the Python `try/except`).
+ */
+export function readWav(filePath) {
+    let buf;
+    try {
+        buf = fs.readFileSync(filePath);
+    }
+    catch {
+        return null;
+    }
+    if (buf.length < WAV_HEADER_BYTES)
+        return null;
+    if (buf.toString("ascii", 0, 4) !== "RIFF" || buf.toString("ascii", 8, 12) !== "WAVE")
+        return null;
+    let offset = 12;
+    let sampleRate = SAMPLE_RATE;
+    let channels = 1;
+    let bitsPerSample = 16;
+    let audioFormat = 1;
+    let dataStart = -1;
+    let dataLength = 0;
+    while (offset + 8 <= buf.length) {
+        const id = buf.toString("ascii", offset, offset + 4);
+        const size = buf.readUInt32LE(offset + 4);
+        const body = offset + 8;
+        if (id === "fmt " && size >= 16 && body + 16 <= buf.length) {
+            audioFormat = buf.readUInt16LE(body);
+            channels = Math.max(1, buf.readUInt16LE(body + 2));
+            sampleRate = buf.readUInt32LE(body + 4);
+            bitsPerSample = buf.readUInt16LE(body + 14);
+        }
+        else if (id === "data") {
+            dataStart = body;
+            dataLength = Math.min(size, buf.length - body);
+            break;
+        }
+        offset = body + size + (size % 2); // chunks are word aligned
+    }
+    if (dataStart < 0)
+        return null;
+    if (audioFormat !== 1 || bitsPerSample !== 16) {
+        // Only 16-bit PCM is produced by this stack; anything else is unsupported.
+        return null;
+    }
+    const pcm = buf.subarray(dataStart, dataStart + dataLength);
+    return { samples: pcm16ToFloat(pcm), sampleRate, channels, bitsPerSample };
+}
+/* ────────────────────────────────────────────────────────────────────────────
+ * Energy helpers (used by VAD in stt.ts / light_daemon.ts)
+ * ──────────────────────────────────────────────────────────────────────────── */
+/** Mean absolute amplitude of 16-bit PCM in [0, 32767] — Python `sum(abs(s))/n`. */
+export function pcm16MeanAbs(pcm) {
+    const n = Math.floor(pcm.length / 2);
+    if (n === 0)
+        return 0;
+    let acc = 0;
+    for (let i = 0; i < n; i++)
+        acc += Math.abs(pcm.readInt16LE(i * 2));
+    return acc / n;
+}
+/** Root-mean-square of float samples — Python `np.sqrt(np.mean(chunk ** 2))`. */
+export function rmsFloat(samples) {
+    if (samples.length === 0)
+        return 0;
+    let acc = 0;
+    for (let i = 0; i < samples.length; i++)
+        acc += samples[i] * samples[i];
+    return Math.sqrt(acc / samples.length);
+}
+let _inputDriver = null;
+let _outputDriver = null;
+export function setAudioInputDriver(driver) {
+    _inputDriver = driver;
+}
+export function getAudioInputDriver() {
+    return _inputDriver;
+}
+export function setAudioOutputDriver(driver) {
+    _outputDriver = driver;
+}
+/**
+ * Playback driver, if one is available.
+ *
+ * TODO(port): there is no in-process audio I/O dependency. The fallbacks below
+ * shell out to OS players, which is what the Python `_play_file()` did after
+ * `sounddevice` failed. Recommended real replacement: `speaker` or `audify`.
+ */
+export function getAudioOutputDriver() {
+    if (_outputDriver)
+        return _outputDriver;
+    const cli = detectCliPlayer();
+    if (cli)
+        return cli;
+    if (process.platform === "win32")
+        return powershellPlayer;
+    return null;
+}
+export const AUDIO_INPUT_MISSING_ERROR = "[ERROR] no audio input driver registered — microphone capture unavailable. " +
+    "Register one with setAudioInputDriver() from src/voice/wav.ts, or install a " +
+    "PortAudio binding (e.g. naudiodon2 / audify / node-record-lpcm16).";
+export const AUDIO_OUTPUT_MISSING_ERROR = "[ERROR] no audio output driver available — playback unavailable. " +
+    "Register one with setAudioOutputDriver() from src/voice/wav.ts, or install a " +
+    "speaker backend (e.g. speaker / audify / naudiodon2).";
+/** Run an external command, resolving with `{ code, stdout, stderr }` (never rejects). */
+export async function runCommand(cmd, args, timeoutMs = 60_000, stdin) {
+    const { spawn } = await import("node:child_process");
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(cmd, args, { windowsHide: true });
+        }
+        catch (e) {
+            resolve({ code: -1, stdout: "", stderr: String(e) });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        let done = false;
+        const finish = (code) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            resolve({ code, stdout, stderr });
+        };
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                /* best effort */
+            }
+            finish(-1);
+        }, timeoutMs);
+        child.stdout?.on("data", (d) => {
+            stdout += d.toString("utf8");
+        });
+        child.stderr?.on("data", (d) => {
+            stderr += d.toString("utf8");
+        });
+        child.on("error", (e) => {
+            stderr += String(e);
+            finish(-1);
+        });
+        child.on("close", (code) => finish(code ?? -1));
+        if (stdin) {
+            try {
+                child.stdin?.end(stdin);
+            }
+            catch {
+                /* best effort */
+            }
+        }
+    });
+}
+/** Escape a value for a single-quoted PowerShell string literal. */
+export function psQuote(s) {
+    return s.replace(/'/g, "''");
+}
+/**
+ * Windows playback via WPF MediaPlayer — handles mp3 and wav, no extra install.
+ * This is the Node analogue of the Python `PowerShell MediaPlayer` fallback.
+ */
+const powershellPlayer = {
+    name: "powershell-mediaplayer",
+    async playFile(filePath) {
+        const secs = Math.max(1, fileSize(filePath) / 32_768 + 1);
+        const ps = `$p=New-Object System.Windows.Media.MediaPlayer;` +
+            `$p.Open([Uri]::new('${psQuote(path.resolve(filePath))}'));` +
+            `$p.Play(); Start-Sleep -Milliseconds ${Math.round(secs * 1000)}; $p.Close()`;
+        await runCommand("powershell", ["-NoProfile", "-c", ps], 120_000);
+    },
+};
+function detectCliPlayer() {
+    const platform = process.platform;
+    const candidates = platform === "darwin"
+        ? [{ bin: "afplay", args: (p) => [p] }]
+        : platform === "win32"
+            ? []
+            : [
+                { bin: "mpg123", args: (p) => ["-q", p] },
+                { bin: "ffplay", args: (p) => ["-nodisp", "-autoexit", "-loglevel", "quiet", p] },
+                { bin: "aplay", args: (p) => [p] },
+                { bin: "paplay", args: (p) => [p] },
+            ];
+    for (const c of candidates) {
+        if (!whichSync(c.bin))
+            continue;
+        const bin = c.bin;
+        const argsFor = c.args;
+        return {
+            name: `${bin}-cli`,
+            async playFile(p) {
+                await runCommand(bin, argsFor(p), 60_000);
+            },
+        };
+    }
+    return null;
+}
+function fileSize(p) {
+    try {
+        return fs.statSync(p).size;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=wav.js.map

package/dist/voice/wav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.js","sourceRoot":"","sources":["../../src/voice/wav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,sFAAsF;AACtF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC;;kFAEkF;AAElF,kEAAkE;AAClE,SAAS,OAAO,CAAC,MAAc;IAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,+EAA+E;IAC/E,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,UAAU,GAAW,WAAW,EAAE,QAAQ,GAAG,CAAC;IACxF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC;IAEhC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;IAC5D,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,uBAAuB;IACrD,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB;IAClD,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;IAChD,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,OAAqB;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAgB,EAChB,OAA2C,EAC3C,UAAU,GAAW,WAAW,EAChC,QAAQ,GAAG,CAAC;IAEZ,IAAI,GAAW,CAAC;IAChB,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,GAAG,GAAG,OAAO,CAAC;IAChB,CAAC;SAAM,IAAI,OAAO,YAAY,YAAY,EAAE,CAAC;QAC3C,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEnG,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,GAAG,WAAW,CAAC;IAC7B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC3D,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACrC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACnD,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACxC,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YACzB,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YAC/C,MAAM;QACR,CAAC;QACD,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B;IAC/D,CAAC;IAED,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,WAAW,KAAK,CAAC,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;QAC9C,2EAA2E;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAC7E,CAAC;AAED;;kFAEkF;AAElF,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,OAAqB;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAE,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AA+BD,IAAI,YAAY,GAA4B,IAAI,CAAC;AACjD,IAAI,aAAa,GAA6B,IAAI,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,gBAAgB,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GACpC,6EAA6E;IAC7E,8EAA8E;IAC9E,oEAAoE,CAAC;AAEvE,MAAM,CAAC,MAAM,0BAA0B,GACrC,mEAAmE;IACnE,+EAA+E;IAC/E,uDAAuD,CAAC;AAE1D,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,IAAc,EACd,SAAS,GAAG,MAAM,EAClB,KAAc;IAEd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAQ,EAAE;YACpC,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;YACD,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE;YAC7B,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAgB,GAAsB;IAC1C,IAAI,EAAE,wBAAwB;IAC9B,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,EAAE,GACN,iDAAiD;YACjD,uBAAuB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM;YAC5D,wCAAwC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;QAChF,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,UAAU,GACd,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE;gBACzC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;gBACjF,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;gBAClC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;aACpC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,SAAS;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAClB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,GAAG,GAAG,MAAM;YAClB,KAAK,CAAC,QAAQ,CAAC,CAAS;gBACtB,MAAM,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/web/broker.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Server-Sent Events broker.
+ * Port of `SSEBroker` from axoniz/web/server.py.
+ *
+ * Each connected client gets an async queue; `broadcast` fans an event out to
+ * every subscriber. The broker is a singleton (`broker`) because the agent,
+ * swarm and daemon all publish to it.
+ */
+import { AsyncQueue } from "../core/backend/async_queue.js";
+export interface SseEvent {
+    type: string;
+    data: unknown;
+    ts: number;
+}
+export declare class SSEBroker {
+    private clients;
+    /** Ring buffer of recent events, useful for late subscribers and the UI. */
+    private recent;
+    private readonly maxRecent;
+    addClient(): AsyncQueue<SseEvent>;
+    removeClient(q: AsyncQueue<SseEvent>): void;
+    broadcast(eventType: string, data: unknown): number;
+    /** Alias compatible with the Python `_broker.broadcast(...)` call sites. */
+    get clientCount(): number;
+    getRecent(n?: number): SseEvent[];
+    closeAll(): void;
+}
+export declare const broker: SSEBroker;
+/** Named export matching the Python import site `from ... import _broker`. */
+export declare const _broker: SSEBroker;
+/** Format an event as an SSE wire frame. */
+export declare function formatSse(ev: SseEvent): string;
+//# sourceMappingURL=broker.d.ts.map

package/dist/web/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/web/broker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAmC;IAClD,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IAEjC,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,CAIhC;IAED,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAG1C;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAYlD;IAED,4EAA4E;IAC5E,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,SAAS,CAAC,CAAC,SAAK,GAAG,QAAQ,EAAE,CAE5B;IAED,QAAQ,IAAI,IAAI,CAGf;CACF;AAGD,eAAO,MAAM,MAAM,WAAkB,CAAC;AAEtC,8EAA8E;AAC9E,eAAO,MAAM,OAAO,WAAS,CAAC;AAE9B,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAE9C"}

package/dist/web/broker.js

@@ -0,0 +1,58 @@
+/**
+ * Server-Sent Events broker.
+ * Port of `SSEBroker` from axoniz/web/server.py.
+ *
+ * Each connected client gets an async queue; `broadcast` fans an event out to
+ * every subscriber. The broker is a singleton (`broker`) because the agent,
+ * swarm and daemon all publish to it.
+ */
+import { AsyncQueue } from "../core/backend/async_queue.js";
+export class SSEBroker {
+    clients = new Set();
+    /** Ring buffer of recent events, useful for late subscribers and the UI. */
+    recent = [];
+    maxRecent = 200;
+    addClient() {
+        const q = new AsyncQueue();
+        this.clients.add(q);
+        return q;
+    }
+    removeClient(q) {
+        this.clients.delete(q);
+        q.close();
+    }
+    broadcast(eventType, data) {
+        const ev = { type: eventType, data, ts: Date.now() / 1000 };
+        this.recent.push(ev);
+        if (this.recent.length > this.maxRecent) {
+            this.recent.splice(0, this.recent.length - this.maxRecent);
+        }
+        let delivered = 0;
+        for (const q of this.clients) {
+            q.push(ev);
+            delivered += 1;
+        }
+        return delivered;
+    }
+    /** Alias compatible with the Python `_broker.broadcast(...)` call sites. */
+    get clientCount() {
+        return this.clients.size;
+    }
+    getRecent(n = 50) {
+        return this.recent.slice(-n);
+    }
+    closeAll() {
+        for (const q of this.clients)
+            q.close();
+        this.clients.clear();
+    }
+}
+/* Module-level singleton (mirrors the Python `_broker`) */
+export const broker = new SSEBroker();
+/** Named export matching the Python import site `from ... import _broker`. */
+export const _broker = broker;
+/** Format an event as an SSE wire frame. */
+export function formatSse(ev) {
+    return `event: ${ev.type}\ndata: ${JSON.stringify(ev.data)}\n\n`;
+}
+//# sourceMappingURL=broker.js.map

package/dist/web/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../src/web/broker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAQ5D,MAAM,OAAO,SAAS;IACZ,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,4EAA4E;IACpE,MAAM,GAAe,EAAE,CAAC;IACf,SAAS,GAAG,GAAG,CAAC;IAEjC,SAAS;QACP,MAAM,CAAC,GAAG,IAAI,UAAU,EAAY,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,YAAY,CAAC,CAAuB;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,IAAa;QACxC,MAAM,EAAE,GAAa,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACX,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,CAAC,GAAG,EAAE;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ;QACN,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;YAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC;AAE9B,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,EAAY;IACpC,OAAO,UAAU,EAAE,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;AACnE,CAAC"}

package/dist/web/open_browser.d.ts

@@ -0,0 +1,2 @@
+export declare function openInBrowser(url: string): Promise<void>;
+//# sourceMappingURL=open_browser.d.ts.map

package/dist/web/open_browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open_browser.d.ts","sourceRoot":"","sources":["../../src/web/open_browser.ts"],"names":[],"mappings":"AASA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC9D"}

package/dist/web/open_browser.js

@@ -0,0 +1,42 @@
+/**
+ * Cross-platform "open this URL in the default browser" helper.
+ * Uses the `open` package when available, falling back to platform commands.
+ *
+ * On Windows the empty `""` argument after `start` is required, otherwise the
+ * URL is interpreted as the console window title.
+ */
+import { spawn } from "node:child_process";
+export async function openInBrowser(url) {
+    try {
+        const mod = (await import("open"));
+        await mod.default(url);
+        return;
+    }
+    catch {
+        /* fall through to the platform command */
+    }
+    const platform = process.platform;
+    let cmd;
+    let args;
+    if (platform === "win32") {
+        cmd = "cmd";
+        args = ["/c", "start", "", url];
+    }
+    else if (platform === "darwin") {
+        cmd = "open";
+        args = [url];
+    }
+    else {
+        cmd = "xdg-open";
+        args = [url];
+    }
+    await new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true, windowsHide: true });
+        child.on("error", reject);
+        child.on("spawn", () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=open_browser.js.map

package/dist/web/open_browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open_browser.js","sourceRoot":"","sources":["../../src/web/open_browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAA8D,CAAC;QAChG,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,GAAW,CAAC;IAChB,IAAI,IAAc,CAAC;IAEnB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,GAAG,GAAG,KAAK,CAAC;QACZ,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;SAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,GAAG,GAAG,MAAM,CAAC;QACb,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,UAAU,CAAC;QACjB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/web/server.d.ts

@@ -0,0 +1,54 @@
+import { type Express } from "express";
+import { error as logError } from "../core/debug.js";
+import { broker, _broker } from "./broker.js";
+import type { Agent } from "../core/agent.js";
+declare class Stats {
+    requests: number;
+    chat_turns: number;
+    agent_runs: number;
+    goal_runs: number;
+    tool_calls: number;
+    model_switches: number;
+    readonly start_time: number;
+    inc(field: keyof Omit<Stats, "start_time" | "inc" | "snapshot">, n?: number): void;
+    snapshot(): Record<string, number>;
+}
+export declare const stats: Stats;
+export declare function getModelSearchDirs(): string[];
+export declare function resolveStatic(urlPath: string): {
+    full: string;
+    mime: string;
+} | null;
+export interface WebServerOptions {
+    agent: Agent | null;
+    host?: string;
+    port?: number;
+}
+export declare class WebServer {
+    agent: Agent | null;
+    readonly host: string;
+    readonly port: number;
+    private app;
+    private server;
+    /** Abort flags keyed by request id, so the UI can cancel a running turn. */
+    private aborts;
+    constructor(opts: WebServerOptions);
+    private usersFileExists;
+    private authenticate;
+    private build;
+    private openSse;
+    private writeSse;
+    private chatSse;
+    private agentSse;
+    private runAgentTaskBg;
+    private recordRequest;
+    /** Start listening. Resolves once the socket is bound. */
+    listen(): Promise<string>;
+    /** Start the server and optionally open a browser. Blocks forever. */
+    start(openBrowser?: boolean): Promise<void>;
+    close(): Promise<void>;
+    get expressApp(): Express;
+}
+export { broker, _broker };
+export { logError };
+//# sourceMappingURL=server.d.ts.map

package/dist/web/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAgBA,OAAgB,EAAE,KAAK,OAAO,EAA+B,MAAM,SAAS,CAAC;AAS7E,OAAO,EAAc,KAAK,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAa,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAa,MAAM,kBAAkB,CAAC;AAWzD,cAAM,KAAK;IACT,QAAQ,SAAK;IACb,UAAU,SAAK;IACf,UAAU,SAAK;IACf,SAAS,SAAK;IACd,UAAU,SAAK;IACf,cAAc,SAAK;IACnB,QAAQ,CAAC,UAAU,SAAqB;IAExC,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,SAAI,GAAG,IAAI,CAE5E;IAED,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjC;CACF;AAED,eAAO,MAAM,KAAK,OAAc,CAAC;AAIjC,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAiB7C;AAoED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAapF;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,SAAS;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,MAAM,CAA8C;IAC5D,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAgC;IAE9C,YAAY,IAAI,EAAE,gBAAgB,EAKjC;IAID,OAAO,CAAC,eAAe;YAQT,YAAY;IAW1B,OAAO,CAAC,KAAK;IAobb,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,QAAQ;YASF,OAAO;YAYP,QAAQ;YA0BR,cAAc;IAkH5B,OAAO,CAAC,aAAa;IAOrB,0DAA0D;IACpD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAW9B;IAED,sEAAsE;IAChE,KAAK,CAAC,WAAW,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB7C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;CACF;AAgBD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,CAAC"}