wicked-crew 0.16.11 → 0.16.13

package/dist/voice/service.js

@@ -0,0 +1,400 @@
+/**
+ * VOICE MODE, PHASE 1 (program DES-VOICE §3): speech to text on THIS machine.
+ *
+ * Studio records the person's speech in the browser, encodes it as a 16 kHz mono WAV, and posts it to
+ * `POST /voice/transcribe`. Crew hands the bytes to whisper.cpp's CLI on stdin (`-f -`) and answers with the
+ * text. The audio is held in memory for that one call and dropped: it is never written to disk, never kept with
+ * a run, never sent off the machine.
+ *
+ * Two local pieces, each said plainly in `GET /voice/status`:
+ *  - the whisper.cpp CLI (`whisper-cli`): found on PATH, or named by `WICKED_CREW_WHISPER_BIN`. Crew does not
+ *    install it; the status names the install command for this platform.
+ *  - one model file (`ggml-base.en.bin`, 142 MiB): downloaded ONLY when the person consents
+ *    (`POST /voice/model {consent: true}`), checked against its published SHA-1, kept in the voice cache dir
+ *    (`WICKED_CREW_VOICE_DIR`, default the OS cache dir). Not under the state home: the worker fence classifies
+ *    every top-level entry there, and a model directory is not one of them.
+ *
+ * One transcription runs at a time and one may wait; a third is refused with 429 `voice_busy` (a streaming
+ * partial just skips that beat).
+ */
+import { spawn as nodeSpawn, spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { createWriteStream, existsSync, mkdirSync, renameSync, rmSync, statSync } from 'node:fs';
+import { Readable, Transform } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { childEnvWithBootEstateDb } from '../core/governance-store.js';
+import { homedir, platform as osPlatform } from 'node:os';
+import { delimiter, join } from 'node:path';
+/** The one model phase 1 ships with. Published by whisper.cpp (models/README.md: 142 MiB, this SHA-1). */
+export const VOICE_MODEL = Object.freeze({
+    name: 'base.en',
+    file: 'ggml-base.en.bin',
+    url: 'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin',
+    sha1: '137c40403d78fd54d454da0f9bd998f78703390c',
+    /** What the consent says before anything is fetched. */
+    approxBytes: 142 * 1024 * 1024,
+    source: 'huggingface.co/ggerganov/whisper.cpp',
+});
+/** A WAV over this is refused (about 4 minutes of 16 kHz mono 16-bit speech). */
+export const VOICE_MAX_AUDIO_BYTES = 8 * 1024 * 1024;
+/** One transcription that runs longer than this is killed and answered 504. */
+export const TRANSCRIBE_TIMEOUT_MS = 60_000;
+/** Threads whisper.cpp may use (the host runs seats and checks too). */
+export const TRANSCRIBE_THREADS = 4;
+export class VoiceError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+    body() {
+        return { error: this.message, code: this.code };
+    }
+}
+/** The OS cache dir for crew's voice files (`WICKED_CREW_VOICE_DIR` wins). */
+export function defaultVoiceDir(env = process.env, plat = osPlatform(), home = homedir()) {
+    const set = env['WICKED_CREW_VOICE_DIR'];
+    if (set !== undefined && set.trim() !== '')
+        return set;
+    if (plat === 'darwin')
+        return join(home, 'Library', 'Caches', 'wicked-crew', 'voice');
+    if (plat === 'win32')
+        return join(env['LOCALAPPDATA'] ?? join(home, 'AppData', 'Local'), 'wicked-crew', 'voice');
+    return join(env['XDG_CACHE_HOME'] ?? join(home, '.cache'), 'wicked-crew', 'voice');
+}
+/** How to install whisper.cpp here, in one line. */
+export function installHint(plat) {
+    if (plat === 'darwin')
+        return 'Install whisper.cpp with Homebrew: brew install whisper-cpp (it provides whisper-cli).';
+    if (plat === 'win32')
+        return 'Download whisper.cpp for Windows from github.com/ggml-org/whisper.cpp/releases, then set WICKED_CREW_WHISPER_BIN to whisper-cli.exe.';
+    return 'Install whisper.cpp from your package manager or build it from github.com/ggml-org/whisper.cpp, so whisper-cli is on PATH (or set WICKED_CREW_WHISPER_BIN).';
+}
+/** The oldest engine voice runs: it must report `--version` (whisper.cpp 1.8.0 does not), and be at least this. */
+export const MIN_WHISPER = [1, 8, 0];
+/** `whisper.cpp version: 1.9.5` → `1.9.5`; anything else → null. */
+export function parseWhisperVersion(out) {
+    const m = out === null ? null : /version:?\s*v?(\d+)\.(\d+)\.(\d+)/i.exec(out);
+    return m === null ? null : `${m[1]}.${m[2]}.${m[3]}`;
+}
+/**
+ * Is this engine safe to hand audio on stdin? From whisper.cpp 1.8.0 a stdin run (`-f -`) writes its `-otxt` output
+ * to stdout; 1.7.x writes it to a FILE named `-.txt` in the working directory, which would keep a transcript on disk.
+ * 1.8.0 itself cannot say its version, so voice asks for an engine that reports one (`--version`) at 1.8.0 or later,
+ * and refuses the rest before any audio is sent.
+ */
+export function whisperSupported(version) {
+    if (version === null)
+        return false;
+    const v = version.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((v[i] ?? 0) !== MIN_WHISPER[i])
+            return (v[i] ?? 0) > MIN_WHISPER[i];
+    }
+    return true;
+}
+function runVersion(bin) {
+    try {
+        const r = spawnSync(bin, ['--version'], { encoding: 'utf8', timeout: 5000, windowsHide: true, env: childEnvWithBootEstateDb(process.env) });
+        return r.status === 0 ? `${r.stdout ?? ''}${r.stderr ?? ''}` : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** How to upgrade whisper.cpp here, in one line. */
+export function upgradeHint(plat) {
+    if (plat === 'darwin')
+        return 'Upgrade it: brew upgrade whisper-cpp.';
+    return 'Install a current whisper.cpp from github.com/ggml-org/whisper.cpp (or set WICKED_CREW_WHISPER_BIN to one).';
+}
+/** Find the whisper.cpp CLI: `WICKED_CREW_WHISPER_BIN`, else `whisper-cli` (or the older `whisper-cpp`) on PATH. */
+export function findWhisper(env, plat, exists) {
+    const set = env['WICKED_CREW_WHISPER_BIN'];
+    if (set !== undefined && set.trim() !== '')
+        return exists(set) ? set : null;
+    const names = plat === 'win32' ? ['whisper-cli.exe', 'whisper-cpp.exe'] : ['whisper-cli', 'whisper-cpp'];
+    for (const dir of (env['PATH'] ?? '').split(delimiter)) {
+        if (dir === '')
+            continue;
+        for (const n of names) {
+            const p = join(dir, n);
+            if (exists(p))
+                return p;
+        }
+    }
+    return null;
+}
+/**
+ * Is it the WAV studio sends: RIFF/WAVE with a PCM `fmt ` chunk (16 kHz, mono, 16-bit) and a non-empty `data`
+ * chunk, every chunk inside the buffer? Anything else is refused before the engine is started.
+ */
+export function wavProblem(buf) {
+    if (buf.length < 12 || buf.toString('ascii', 0, 4) !== 'RIFF' || buf.toString('ascii', 8, 12) !== 'WAVE')
+        return 'not a RIFF/WAVE file';
+    let at = 12;
+    let fmt = null;
+    let data = 0;
+    while (at + 8 <= buf.length) {
+        const id = buf.toString('ascii', at, at + 4);
+        const size = buf.readUInt32LE(at + 4);
+        const body = at + 8;
+        if (body + size > buf.length)
+            return `the ${id.trim() || 'unnamed'} chunk runs past the end of the file`;
+        if (id === 'fmt ') {
+            if (size < 16)
+                return 'the fmt chunk is too short';
+            fmt = { format: buf.readUInt16LE(body), channels: buf.readUInt16LE(body + 2), rate: buf.readUInt32LE(body + 4), bits: buf.readUInt16LE(body + 14) };
+        }
+        else if (id === 'data') {
+            data += size;
+        }
+        at = body + size + (size % 2);
+    }
+    if (fmt === null)
+        return 'no fmt chunk';
+    if (fmt.format !== 1 || fmt.channels !== 1 || fmt.rate !== 16_000 || fmt.bits !== 16) {
+        return `expected 16 kHz mono 16-bit PCM, got format ${fmt.format}, ${fmt.channels} channel(s), ${fmt.rate} Hz, ${fmt.bits}-bit`;
+    }
+    if (data === 0)
+        return 'no audio in the data chunk';
+    return null;
+}
+/** Is it a WAV this route takes? */
+export function isWav(buf) {
+    return wavProblem(buf) === null;
+}
+/** whisper.cpp's plain-text output as one line: no timestamps, no non-speech tags ([BLANK_AUDIO], (music)). */
+export function cleanTranscript(raw) {
+    return raw
+        .replace(/\[[^\]]*\]/g, ' ')
+        .replace(/\((?:[a-z ]*(?:music|noise|silence|applause|laughter|inaudible|blank)[a-z ]*)\)/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export class VoiceService {
+    deps;
+    env;
+    plat;
+    exists;
+    fetchImpl;
+    spawnImpl;
+    timeoutMs;
+    model;
+    versionOf;
+    /** `--version` per engine path, read once. */
+    versions = new Map();
+    download = null;
+    /** The download in flight: removal aborts it and bumps the generation, so it can never land afterwards. */
+    inflight = null;
+    gen = 0;
+    /** One transcription holds the slot; one waits for it (the slot is handed over, never re-contested). */
+    busy = false;
+    waiting = [];
+    constructor(deps) {
+        this.deps = deps;
+        this.env = deps.env ?? process.env;
+        this.plat = deps.platform ?? osPlatform();
+        this.exists = deps.exists ?? existsSync;
+        this.fetchImpl = deps.fetch ?? fetch;
+        this.spawnImpl = deps.spawn ?? nodeSpawn;
+        this.timeoutMs = deps.timeoutMs ?? TRANSCRIBE_TIMEOUT_MS;
+        this.model = deps.model ?? VOICE_MODEL;
+        this.versionOf = deps.versionOf ?? runVersion;
+    }
+    modelPath() {
+        return join(this.deps.dir, this.model.file);
+    }
+    bin() {
+        if (this.deps.bin !== undefined && this.deps.bin !== null)
+            return this.exists(this.deps.bin) ? this.deps.bin : null;
+        return findWhisper(this.env, this.plat, this.exists);
+    }
+    engineVersion(bin) {
+        if (!this.versions.has(bin))
+            this.versions.set(bin, parseWhisperVersion(this.versionOf(bin)));
+        return this.versions.get(bin) ?? null;
+    }
+    tooOld(bin) {
+        return `whisper.cpp at ${bin} is too old for voice: it needs 1.8.0 or later (one that answers --version), so a transcription never writes a file. ${upgradeHint(this.plat)}`;
+    }
+    modelBytes() {
+        const p = this.modelPath();
+        if (!this.exists(p))
+            return null;
+        try {
+            return statSync(p).size;
+        }
+        catch {
+            return null;
+        }
+    }
+    status() {
+        const path = this.bin();
+        const bytes = this.modelBytes();
+        const version = path !== null ? this.engineVersion(path) : null;
+        const supported = path !== null && whisperSupported(version);
+        return {
+            local: true,
+            ready: supported && bytes !== null,
+            engine: {
+                name: 'whisper.cpp', found: path !== null, path, version, supported,
+                install: path === null ? installHint(this.plat) : supported ? null : this.tooOld(path),
+            },
+            model: {
+                name: this.model.name, present: bytes !== null, bytes, approxBytes: this.model.approxBytes,
+                source: this.model.source, download: this.download === null ? null : { ...this.download },
+            },
+        };
+    }
+    /**
+     * Fetch the model, once, with the person's consent. Returns at once; the download runs on and
+     * `status().model.download` reports it. The file lands under a `.part` name, is checked against the published
+     * SHA-1, and only then takes its real name; a failed or mismatched download leaves nothing behind.
+     */
+    startDownload() {
+        if (this.modelBytes() !== null)
+            return { started: false };
+        if (this.inflight !== null)
+            throw new VoiceError(409, 'voice_download_running', 'The speech model is already downloading.');
+        const gen = ++this.gen;
+        const abort = new AbortController();
+        this.inflight = { gen, abort };
+        this.download = { state: 'running', receivedBytes: 0, totalBytes: null, startedAt: new Date().toISOString(), error: null };
+        void this.fetchModel(gen, abort.signal).then(() => { if (this.gen === gen)
+            this.download = null; }, (e) => {
+            if (this.gen !== gen)
+                return; // removed meanwhile: nothing to report
+            this.download = {
+                ...(this.download ?? { receivedBytes: 0, totalBytes: null, startedAt: new Date().toISOString() }),
+                state: 'failed', error: e instanceof Error ? e.message : String(e),
+            };
+        }).finally(() => { if (this.inflight?.gen === gen)
+            this.inflight = null; });
+        return { started: true };
+    }
+    async fetchModel(gen, signal) {
+        mkdirSync(this.deps.dir, { recursive: true });
+        const part = `${this.modelPath()}.part`;
+        rmSync(part, { force: true });
+        try {
+            const res = await this.fetchImpl(this.model.url, { redirect: 'follow', signal });
+            if (!res.ok || res.body === null)
+                throw new Error(`the model download answered ${res.status}`);
+            const len = Number(res.headers.get('content-length'));
+            if (this.download !== null && Number.isFinite(len) && len > 0)
+                this.download.totalBytes = len;
+            const hash = createHash('sha1');
+            const count = new Transform({
+                transform: (chunk, _enc, cb) => {
+                    hash.update(chunk);
+                    if (this.gen === gen && this.download !== null)
+                        this.download.receivedBytes += chunk.length;
+                    cb(null, chunk);
+                },
+            });
+            // One pipeline: a read, write or disk error (EACCES, ENOSPC) rejects here, never an unhandled 'error'.
+            await pipeline(Readable.fromWeb(res.body), count, createWriteStream(part), { signal });
+            const got = hash.digest('hex');
+            if (got !== this.model.sha1)
+                throw new Error(`the downloaded model did not match its published checksum (got sha1 ${got}); nothing was kept`);
+            if (this.gen !== gen || signal.aborted)
+                throw new Error('the download was cancelled');
+            renameSync(part, this.modelPath());
+        }
+        catch (e) {
+            rmSync(part, { force: true });
+            throw e;
+        }
+    }
+    /** Remove the model (the person's "Remove the speech model"). A download in flight is cancelled first. */
+    removeModel() {
+        this.gen += 1;
+        this.inflight?.abort.abort();
+        this.inflight = null;
+        this.download = null;
+        const p = this.modelPath();
+        const had = this.exists(p);
+        rmSync(p, { force: true });
+        rmSync(`${p}.part`, { force: true });
+        return { removed: had };
+    }
+    /** Transcribe one WAV held in memory. The bytes go to whisper.cpp on stdin and are dropped after. */
+    async transcribe(audio) {
+        if (audio.length > VOICE_MAX_AUDIO_BYTES) {
+            throw new VoiceError(413, 'voice_audio_too_large', `The recording is over ${Math.round(VOICE_MAX_AUDIO_BYTES / 1048576)} MiB; speak in shorter turns.`);
+        }
+        const problem = wavProblem(audio);
+        if (problem !== null)
+            throw new VoiceError(400, 'voice_audio_invalid', `Send the recording as a 16 kHz mono 16-bit WAV (${problem}).`);
+        this.ready();
+        if (this.busy && this.waiting.length >= 1)
+            throw new VoiceError(429, 'voice_busy', 'Still transcribing the last thing you said.');
+        if (this.busy)
+            await new Promise((r) => this.waiting.push(r)); // the slot is handed to us
+        this.busy = true;
+        const started = Date.now();
+        try {
+            // Checked again with the slot held: the model may have been removed while this one waited.
+            const bin = this.ready();
+            const raw = await this.run(bin, audio);
+            return { text: cleanTranscript(raw), ms: Date.now() - started, model: this.model.name };
+        }
+        finally {
+            const next = this.waiting.shift();
+            if (next !== undefined)
+                next(); // hand the slot over: `busy` stays true, nobody can slip in between
+            else
+                this.busy = false;
+        }
+    }
+    /** The engine and the model, or the refusal that names the missing one. */
+    ready() {
+        const bin = this.bin();
+        if (bin === null)
+            throw new VoiceError(409, 'voice_engine_missing', `whisper.cpp is not installed on this machine. ${installHint(this.plat)}`);
+        if (!whisperSupported(this.engineVersion(bin)))
+            throw new VoiceError(409, 'voice_engine_outdated', this.tooOld(bin));
+        if (this.modelBytes() === null)
+            throw new VoiceError(409, 'voice_model_missing', 'The speech model is not on this machine yet; download it first (it needs your consent).');
+        return bin;
+    }
+    run(bin, audio) {
+        // `-f -` reads the WAV from stdin; with stdin as the input, whisper-cli (1.8.0 and later, checked in `ready()`)
+        // writes its output "file" to stdout, and `-otxt` is the format it writes there (without it a stdin run prints
+        // nothing: 1.9.5, seen live). No file is written. An older engine would write `-.txt`, so it never gets here.
+        const args = ['-m', this.modelPath(), '-f', '-', '-otxt', '-nt', '-np', '-l', 'en', '-t', String(TRANSCRIBE_THREADS)];
+        return new Promise((resolve, reject) => {
+            const child = this.spawnImpl(bin, args, { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true, env: childEnvWithBootEstateDb(this.env) });
+            let out = '';
+            let err = '';
+            let settled = false;
+            const done = (f) => { if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                f();
+            } };
+            const timer = setTimeout(() => {
+                child.kill('SIGKILL');
+                done(() => reject(new VoiceError(504, 'voice_timeout', `Transcription took longer than ${Math.round(this.timeoutMs / 1000)} s and was stopped.`)));
+            }, this.timeoutMs);
+            child.stdout?.setEncoding('utf8');
+            child.stderr?.setEncoding('utf8');
+            child.stdout?.on('data', (d) => { out += d; });
+            child.stderr?.on('data', (d) => { if (err.length < 4000)
+                err += d; });
+            child.on('error', (e) => done(() => reject(new VoiceError(500, 'voice_failed', `whisper.cpp could not start: ${e.message}`))));
+            child.on('close', (code) => done(() => {
+                if (code === 0)
+                    resolve(out);
+                else
+                    reject(new VoiceError(500, 'voice_failed', `whisper.cpp exited ${code}: ${err.trim().split('\n').slice(-2).join(' ') || 'no message'}`));
+            }));
+            child.stdin?.on('error', () => undefined);
+            child.stdin?.end(audio);
+        });
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/voice/service.js.map

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

package/dist/workflow-catalog/build.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `GET /workflows/catalog` (lane wf-catalog): join the catalog seeds with what the engine serves and
+ * with the requesting operator's runs. Pure: the route gathers the inputs, this shapes the answer.
+ *
+ * Usage is derived, never stored: a run counts for an entry when its resolved workflow
+ * (`run_identity.name`) is the entry's, its `run.launched` trail entry names THIS principal (the system
+ * of record for who launched a run), and it is not a retry. Runs the daemon or a schedule launched
+ * (actor kind `system`) are not the operator's use.
+ */
+import type { Preset, WorkflowCatalogResponse, WorkflowDef } from '../core/types.js';
+/** One run as the catalog reads it. Times are unix SECONDS (the served run's `created_at`/`ended_at`). */
+export interface CatalogRun {
+    id: string;
+    /** The resolved workflow/preset name (`run_identity.name`), null for a user plan or free text. */
+    workflow: string | null;
+    projectId: string | null;
+    status: string;
+    createdAt?: number | undefined;
+    endedAt?: number | undefined;
+    retryOf?: string | undefined;
+    /** The `run.launched` entry's principal (`Actor.id`), absent when the daemon holds no launch record. */
+    principal?: string | undefined;
+}
+export interface CatalogInputs {
+    /** `GET /workflows`'s served defs (built-ins carry their C2 descriptor). */
+    defs: readonly WorkflowDef[];
+    /** `GET /presets` for the scope (built-in rows and the operator's saved ones). */
+    presets: readonly Preset[];
+    runs: readonly CatalogRun[];
+    actorId: string;
+    projectId: string | null;
+}
+export declare const TOP_MAX = 6;
+export declare function buildWorkflowCatalog(input: CatalogInputs): WorkflowCatalogResponse;
+//# sourceMappingURL=build.d.ts.map

package/dist/workflow-catalog/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/workflow-catalog/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,MAAM,EAGN,uBAAuB,EAEvB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAK1B,0GAA0G;AAC1G,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,kGAAkG;IAClG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7B,kFAAkF;IAClF,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,eAAO,MAAM,OAAO,IAAI,CAAC;AA6CzB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB,CA0LlF"}