@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/speech/hearing.d.ts

@@ -0,0 +1,64 @@
+import type { Messenger } from "../cli/messenger/context.js";
+import type { MessengerAdapter } from "../cli/messenger/port.js";
+import type { Settings } from "../cli/settings.js";
+import type { Message } from "../domain/models.js";
+import { type Choice } from "./transcribe.js";
+/** `--model` chooses who hears what `--transcribe` asks for; alone it would quietly do nothing. */
+export declare const modelWith: (transcribe: boolean | undefined, model: string | undefined) => string | undefined;
+/** Telegram polls each voice message for up to a minute; a whole list gets this long, then says what is left. */
+export declare const HEARING_BUDGET_MS = 120000;
+export interface Voice {
+    chatId: string;
+    messageId: string;
+}
+export interface Hearing {
+    /** By `keyOf`: the text of every voice message heard now or kept from before. */
+    transcripts: Map<string, string>;
+    /** Voice messages still without text after `--transcribe`: out of time, pending, or refused. */
+    unheard: Voice[];
+    /** Why some were not heard — the first reason; the messages are still worth showing. */
+    problem?: string;
+}
+export declare const keyOf: ({ chatId, messageId }: Voice) => string;
+/** Telegram says `voice`; MAX says `audio` with Ogg in it. */
+export declare const isVoice: (message: Message) => boolean;
+export interface Kept {
+    get(voice: Voice): Promise<{
+        text: string;
+        source: string;
+    } | undefined>;
+    keep(voice: Voice, text: string, source: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Transcripts already heard, in the shared store, for the account this profile last logged in as
+ * (owner, NEED-418 B). A profile that has never been online has no account yet: nothing is kept for
+ * it, and a voice message is heard again next time.
+ */
+export declare const openKept: (messenger: Messenger, profile: string, env: NodeJS.ProcessEnv) => Promise<Kept>;
+/**
+ * Kept transcripts always — they cost nothing; new ones only when `connect` is given (`--transcribe`).
+ * The messenger is asked inside one connection; a local model runs after it closes, on the bytes
+ * fetched in it. What could not be heard is in `unheard`, never a failure.
+ */
+export declare const hearVoices: (messenger: Messenger, messages: readonly Message[], kept: Kept, transcribe?: {
+    choice: Choice;
+    connect: <T>(work: (adapter: MessengerAdapter) => Promise<T>) => Promise<T>;
+    budgetMs?: number;
+}) => Promise<Hearing>;
+/** A message with its transcript, when there is one; others pass through unchanged. */
+export declare const withTranscript: <T extends Message>(message: T, hearing: Hearing) => T & {
+    transcript?: string;
+};
+/** How a person sees one: the text the messenger has, then what was heard. */
+export declare const spoken: <T extends Message & {
+    transcript?: string;
+}>({ transcript, ...message }: T) => Message;
+/** For an MCP tool: the same hearing, over the session's own connection. */
+export declare const hearForTool: (messenger: Messenger, connect: <T>(work: (adapter: MessengerAdapter) => Promise<T>) => Promise<T>, messages: readonly Message[], transcribe: boolean, { settings, env }: {
+    settings: Pick<Settings, "configured" | "shared" | "profile">;
+    env: NodeJS.ProcessEnv;
+}, model?: string) => Promise<Hearing | undefined>;
+/** Messages with their transcripts; `unheard` as well when `--transcribe` was asked for. */
+export declare const heard: <T extends Message>(messages: readonly T[], hearing: Hearing | undefined) => T[];
+//# sourceMappingURL=hearing.d.ts.map

package/dist/speech/hearing.d.ts.map

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

package/dist/speech/hearing.js

@@ -0,0 +1,111 @@
+import { CliError } from "@wirecat/cli-base";
+import { recalledAccount } from "../cli/messenger/accounts.js";
+import { openStore } from "../store/store.js";
+import { choose, hearLocally, hearOnline } from "./transcribe.js";
+/** `--model` chooses who hears what `--transcribe` asks for; alone it would quietly do nothing. */
+export const modelWith = (transcribe, model) => {
+    if (model !== undefined && transcribe !== true) {
+        throw new CliError("validation_error", "--model picks who hears voice messages with --transcribe; add --transcribe");
+    }
+    return model;
+};
+/** Telegram polls each voice message for up to a minute; a whole list gets this long, then says what is left. */
+export const HEARING_BUDGET_MS = 120_000;
+export const keyOf = ({ chatId, messageId }) => `${chatId}/${messageId}`;
+/** Telegram says `voice`; MAX says `audio` with Ogg in it. */
+export const isVoice = (message) => message.attachments.some(({ kind, mime }) => kind === "voice" || mime === "audio/ogg");
+/**
+ * Transcripts already heard, in the shared store, for the account this profile last logged in as
+ * (owner, NEED-418 B). A profile that has never been online has no account yet: nothing is kept for
+ * it, and a voice message is heard again next time.
+ */
+export const openKept = async (messenger, profile, env) => {
+    const account = recalledAccount(messenger.app, messenger.provider, profile, env);
+    if (!account)
+        return { get: async () => undefined, keep: async () => { }, close: async () => { } };
+    const store = await openStore({ env });
+    return {
+        get: ({ chatId, messageId }) => store.transcript(account, chatId, messageId),
+        keep: ({ chatId, messageId }, text, source) => store.keepTranscript(account, chatId, messageId, text, source),
+        close: () => store.close(),
+    };
+};
+/**
+ * Kept transcripts always — they cost nothing; new ones only when `connect` is given (`--transcribe`).
+ * The messenger is asked inside one connection; a local model runs after it closes, on the bytes
+ * fetched in it. What could not be heard is in `unheard`, never a failure.
+ */
+export const hearVoices = async (messenger, messages, kept, transcribe) => {
+    const transcripts = new Map();
+    const missing = [];
+    for (const message of messages.filter(isVoice)) {
+        const voice = { chatId: message.chatId, messageId: message.id };
+        const text = (await kept.get(voice))?.text;
+        if (text === undefined)
+            missing.push(voice);
+        else
+            transcripts.set(keyOf(voice), text);
+    }
+    if (!transcribe || missing.length === 0)
+        return { transcripts, unheard: missing };
+    const { choice, connect, budgetMs = HEARING_BUDGET_MS } = transcribe;
+    const deadline = Date.now() + budgetMs;
+    let problem;
+    const fetched = await connect(async (adapter) => {
+        const answers = [];
+        for (const voice of missing) {
+            if (Date.now() >= deadline)
+                break;
+            try {
+                answers.push([voice, await hearOnline(messenger, adapter, voice.chatId, voice.messageId, choice)]);
+            }
+            catch (error) {
+                problem ??= error instanceof Error ? error.message : String(error);
+            }
+        }
+        return answers;
+    });
+    for (const [voice, answer] of fetched) {
+        try {
+            const heard = answer instanceof Uint8Array ? await hearLocally(answer, voice.messageId, choice) : answer;
+            if (heard.pending || heard.text.trim() === "")
+                continue;
+            transcripts.set(keyOf(voice), heard.text);
+            await kept.keep(voice, heard.text, heard.model ?? heard.via);
+        }
+        catch (error) {
+            problem ??= error instanceof Error ? error.message : String(error);
+        }
+    }
+    const unheard = missing.filter((voice) => !transcripts.has(keyOf(voice)));
+    return { transcripts, unheard, ...(problem === undefined ? {} : { problem }) };
+};
+/** A message with its transcript, when there is one; others pass through unchanged. */
+export const withTranscript = (message, hearing) => {
+    const transcript = hearing.transcripts.get(keyOf({ chatId: message.chatId, messageId: message.id }));
+    return transcript === undefined ? message : { ...message, transcript };
+};
+/** How a person sees one: the text the messenger has, then what was heard. */
+export const spoken = ({ transcript, ...message }) => transcript === undefined
+    ? message
+    : { ...message, text: [message.text, `🎤 ${transcript}`].filter(Boolean).join("\n") };
+/** For an MCP tool: the same hearing, over the session's own connection. */
+export const hearForTool = async (messenger, connect, messages, transcribe, { settings, env }, model) => {
+    if (!messages.some(isVoice))
+        return undefined;
+    const kept = await openKept(messenger, settings.profile, env);
+    try {
+        return await hearVoices(messenger, messages, kept, transcribe
+            ? {
+                choice: choose(messenger, settings, model === undefined ? {} : { model }, env),
+                connect,
+            }
+            : undefined);
+    }
+    finally {
+        await kept.close();
+    }
+};
+/** Messages with their transcripts; `unheard` as well when `--transcribe` was asked for. */
+export const heard = (messages, hearing) => hearing ? messages.map((message) => withTranscript(message, hearing)) : [...messages];
+//# sourceMappingURL=hearing.js.map

package/dist/speech/hearing.js.map

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

package/dist/speech/index.d.ts

@@ -0,0 +1,4 @@
+export { type Fetch, install, installedBytes, isInstalled, megabytes, modelPath, modelsDirectory, sharedModelsDirectory, vadPath, } from "./install.js";
+export { type LocalSpeechBackend, type LocalSpeechRecognitionModel, type LocalSpeechRecognizer, type LocalSpeechRecognizerOptions, localSpeechRecognitionModel, openLocalSpeechRecognizer, } from "./local.js";
+export { DEFAULT_ORDER, findModel, MODELS, type ModelFile, orderedModels, type SpeechModel, speechModel, VAD, } from "./models.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/speech/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,OAAO,GACR,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,aAAa,EACb,SAAS,EACT,MAAM,EACN,KAAK,SAAS,EACd,aAAa,EACb,KAAK,WAAW,EAChB,WAAW,EACX,GAAG,GACJ,MAAM,aAAa,CAAA"}

package/dist/speech/index.js

@@ -0,0 +1,4 @@
+export { install, installedBytes, isInstalled, megabytes, modelPath, modelsDirectory, sharedModelsDirectory, vadPath, } from "./install.js";
+export { localSpeechRecognitionModel, openLocalSpeechRecognizer, } from "./local.js";
+export { DEFAULT_ORDER, findModel, MODELS, orderedModels, speechModel, VAD, } from "./models.js";
+//# sourceMappingURL=index.js.map

package/dist/speech/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/speech/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,OAAO,GACR,MAAM,cAAc,CAAA;AACrB,OAAO,EAKL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,aAAa,EACb,SAAS,EACT,MAAM,EAEN,aAAa,EAEb,WAAW,EACX,GAAG,GACJ,MAAM,aAAa,CAAA"}

package/dist/speech/install.d.ts

@@ -0,0 +1,27 @@
+import { type ModelFile, type SpeechModel } from "./models.js";
+/** Shared by every CLI of the family, whatever it talks to: a model is hundreds of MB and is downloaded once. */
+export declare const sharedModelsDirectory: (kind: "audio" | "text", env?: NodeJS.ProcessEnv) => string;
+export declare const modelsDirectory: (env?: NodeJS.ProcessEnv) => string;
+export declare const modelPath: (directory: string, model: SpeechModel) => (name: string) => string;
+export declare const vadPath: (directory: string) => string;
+/**
+ * Size, not hash: hashing 650 MB on every call would cost more than the transcription. The hash is
+ * checked once, as the file arrives, and a file only reaches its name after passing it.
+ */
+export declare const isInstalled: (model: SpeechModel, directory: string) => boolean;
+export declare const filesPresent: (files: [ModelFile, string][]) => boolean;
+export declare const installedBytes: (model: SpeechModel) => number;
+export type Fetch = (url: string, init?: {
+    signal?: AbortSignal;
+}) => Promise<Response>;
+export declare const install: (model: SpeechModel, directory: string, { fetch: get, progress }?: {
+    fetch?: Fetch;
+    progress?: (line: string) => void;
+}) => Promise<void>;
+/** Each file not already in place, downloaded and checked against its sha256 before it takes its name. */
+export declare const installFiles: (files: [ModelFile, string][], { fetch: get, progress }?: {
+    fetch?: Fetch;
+    progress?: (line: string) => void;
+}) => Promise<void>;
+export declare const megabytes: (bytes: number) => string;
+//# sourceMappingURL=install.d.ts.map

package/dist/speech/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/speech/install.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAO,MAAM,aAAa,CAAA;AAEnE,iHAAiH;AACjH,eAAO,MAAM,qBAAqB,SAAU,OAAO,GAAG,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MACxD,CAAA;AAE7C,eAAO,MAAM,eAAe,SAAS,MAAM,CAAC,UAAU,KAAiB,MAA6C,CAAA;AAwBpH,eAAO,MAAM,SAAS,cAAe,MAAM,SAAS,WAAW,YAAY,MAAM,WAAoC,CAAA;AAErH,eAAO,MAAM,OAAO,cAAe,MAAM,KAAG,MAAmC,CAAA;AAO/E;;;GAGG;AACH,eAAO,MAAM,WAAW,UAAW,WAAW,aAAa,MAAM,KAAG,OAAiD,CAAA;AAErH,eAAO,MAAM,YAAY,UAAW,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,KAAG,OACA,CAAA;AAU5D,eAAO,MAAM,cAAc,UAAW,WAAW,KAAG,MAAgE,CAAA;AAEpH,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEvF,eAAO,MAAM,OAAO,UACX,WAAW,aACP,MAAM,6BACiB;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACrF,OAAO,CAAC,IAAI,CAGd,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,YAAY,UAChB,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,6BACM;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACrF,OAAO,CAAC,IAAI,CAOd,CAAA;AA4DD,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,MACgC,CAAA"}

package/dist/speech/install.js

@@ -0,0 +1,111 @@
+import { createHash, randomUUID } from "node:crypto";
+import { createWriteStream, mkdirSync, statSync } from "node:fs";
+import { rename, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { CliError } from "@wirecat/cli-base";
+import { wirecatDirectory } from "../store/path.js";
+import { VAD } from "./models.js";
+/** Shared by every CLI of the family, whatever it talks to: a model is hundreds of MB and is downloaded once. */
+export const sharedModelsDirectory = (kind, env = process.env) => join(wirecatDirectory(env), "models", kind);
+export const modelsDirectory = (env = process.env) => sharedModelsDirectory("audio", env);
+/** No byte for this long and the download is given up — however large the file, it is moving or not. */
+const STALL_MS = 60_000;
+const watchdog = (ms) => {
+    const controller = new AbortController();
+    let timer = setTimeout(() => controller.abort(), ms);
+    return {
+        signal: controller.signal,
+        poke: () => {
+            clearTimeout(timer);
+            timer = setTimeout(() => controller.abort(), ms);
+        },
+        stop: () => clearTimeout(timer),
+    };
+};
+export const modelPath = (directory, model) => (name) => join(directory, model.id, name);
+export const vadPath = (directory) => join(directory, VAD.name);
+const placed = (model, directory) => [
+    ...model.files.map((file) => [file, modelPath(directory, model)(file.name)]),
+    [VAD, vadPath(directory)],
+];
+/**
+ * Size, not hash: hashing 650 MB on every call would cost more than the transcription. The hash is
+ * checked once, as the file arrives, and a file only reaches its name after passing it.
+ */
+export const isInstalled = (model, directory) => filesPresent(placed(model, directory));
+export const filesPresent = (files) => files.every(([file, path]) => sizeOf(path) === file.bytes);
+const sizeOf = (path) => {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const installedBytes = (model) => model.files.reduce((sum, file) => sum + file.bytes, 0);
+export const install = async (model, directory, { fetch: get = fetch, progress } = {}) => {
+    mkdirSync(join(directory, model.id), { recursive: true, mode: 0o700 });
+    await installFiles(placed(model, directory), { fetch: get, ...(progress ? { progress } : {}) });
+};
+/** Each file not already in place, downloaded and checked against its sha256 before it takes its name. */
+export const installFiles = async (files, { fetch: get = fetch, progress } = {}) => {
+    for (const [file, path] of files) {
+        if (sizeOf(path) === file.bytes)
+            continue;
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        progress?.(`downloading ${file.name} (${megabytes(file.bytes)})`);
+        await fetchVerified(file, path, get);
+    }
+};
+const fetchVerified = async (file, path, get) => {
+    const stalled = watchdog(STALL_MS);
+    try {
+        await fetchInto(file, path, get, stalled);
+    }
+    catch (error) {
+        if (stalled.signal.aborted) {
+            throw new CliError("timeout", `${file.name} stopped downloading for ${STALL_MS / 1000} s — nothing was installed`);
+        }
+        throw error;
+    }
+    finally {
+        stalled.stop();
+    }
+};
+const fetchInto = async (file, path, get, stalled) => {
+    const response = await get(file.url, { signal: stalled.signal });
+    if (!response.ok || !response.body) {
+        await response.body?.cancel();
+        throw new CliError("network_error", `${file.name} could not be downloaded: HTTP ${response.status}`);
+    }
+    const partial = `${path}.${randomUUID()}.part`;
+    const hash = createHash("sha256");
+    let bytes = 0;
+    const hashing = new Transform({
+        transform(chunk, _encoding, done) {
+            stalled.poke();
+            bytes += chunk.length;
+            if (bytes > file.bytes) {
+                done(new CliError("invalid_response", `${file.name} is larger than this version expects — nothing was installed`));
+                return;
+            }
+            hash.update(chunk);
+            done(null, chunk);
+        },
+    });
+    try {
+        await pipeline(Readable.fromWeb(response.body), hashing, createWriteStream(partial, { flags: "wx", mode: 0o600 }));
+        const actual = hash.digest("hex");
+        if (actual !== file.sha256) {
+            throw new CliError("invalid_response", `${file.name} is not the file this version expects (sha256 ${actual}) — nothing was installed`);
+        }
+        await rename(partial, path);
+    }
+    finally {
+        await rm(partial, { force: true });
+    }
+};
+export const megabytes = (bytes) => bytes < 1_000_000 ? "under 1 MB" : `${Math.round(bytes / 1_000_000)} MB`;
+//# sourceMappingURL=install.js.map

package/dist/speech/install.js.map

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

package/dist/speech/local.d.ts

@@ -0,0 +1,30 @@
+import { type SpeechModel } from "./models.js";
+export interface LocalSpeechRecognitionModel {
+    engine: "sherpa-onnx";
+    model: string;
+    version: string;
+    sampleRate: 16000;
+    maxChunkSamples: 480000;
+}
+export interface LocalSpeechBackend {
+    recognize(pcm: Float32Array): string;
+    free(): void;
+}
+export interface LocalSpeechRecognizer extends LocalSpeechRecognitionModel {
+    recognize(pcm: Float32Array, options?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    close(): Promise<void>;
+}
+export interface LocalSpeechRecognizerOptions {
+    directory?: string;
+    env?: NodeJS.ProcessEnv;
+    signal?: AbortSignal;
+    maxTextBytes?: number;
+    open?: (model: SpeechModel, path: (name: string) => string, vad: string) => LocalSpeechBackend;
+}
+/** A pinned registry descriptor; no model files, credentials or network are accessed. */
+export declare const localSpeechRecognitionModel: (id: string) => Readonly<LocalSpeechRecognitionModel>;
+/** Existing installed models only. Synchronous inference cancels between bounded windows. */
+export declare const openLocalSpeechRecognizer: (id: string, input?: LocalSpeechRecognizerOptions) => Promise<LocalSpeechRecognizer>;
+//# sourceMappingURL=local.d.ts.map

package/dist/speech/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/speech/local.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAoB,MAAM,aAAa,CAAA;AAEhE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,KAAK,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;CACxB;AACD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAA;IACpC,IAAI,IAAI,IAAI,CAAA;CACb;AACD,MAAM,WAAW,qBAAsB,SAAQ,2BAA2B;IACxE,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AACD,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,kBAAkB,CAAA;CAC/F;AAOD,yFAAyF;AACzF,eAAO,MAAM,2BAA2B,OAAQ,MAAM,KAAG,QAAQ,CAAC,2BAA2B,CAa5F,CAAA;AACD,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,OAChC,MAAM,UACH,4BAA4B,KAClC,OAAO,CAAC,qBAAqB,CAuE/B,CAAA"}

package/dist/speech/local.js

@@ -0,0 +1,96 @@
+import { createHash } from "node:crypto";
+import { isAbsolute } from "node:path";
+import { setImmediate } from "node:timers/promises";
+import { CliError } from "@wirecat/cli-base";
+import { isInstalled, modelPath, modelsDirectory, vadPath } from "./install.js";
+import { speechModel, VAD } from "./models.js";
+const cancelled = (signal) => {
+    if (!signal?.aborted)
+        return;
+    if (signal.reason instanceof CliError)
+        throw signal.reason;
+    const timeout = signal.reason instanceof Error && signal.reason.name === "TimeoutError";
+    throw new CliError(timeout ? "timeout" : "cancelled", "local speech recognition was interrupted");
+};
+/** A pinned registry descriptor; no model files, credentials or network are accessed. */
+export const localSpeechRecognitionModel = (id) => {
+    const model = speechModel(id);
+    const version = createHash("sha256")
+        .update(JSON.stringify({
+        format: "pcm-window-v1",
+        files: model.files.map((file) => [file.name, file.sha256]),
+        vad: VAD.sha256,
+        featureDim: model.featureDim,
+    }))
+        .digest("hex");
+    return Object.freeze({ engine: "sherpa-onnx", model: model.id, version, sampleRate: 16000, maxChunkSamples: 480000 });
+};
+/** Existing installed models only. Synchronous inference cancels between bounded windows. */
+export const openLocalSpeechRecognizer = async (id, input = {}) => {
+    const options = { ...input };
+    const description = localSpeechRecognitionModel(id);
+    const model = speechModel(description.model);
+    const directory = options.directory ?? modelsDirectory(options.env);
+    const maxTextBytes = options.maxTextBytes ?? 65536;
+    if (typeof directory !== "string" ||
+        !isAbsolute(directory) ||
+        /[\0\r\n]/.test(directory) ||
+        !Number.isSafeInteger(maxTextBytes) ||
+        maxTextBytes < 1 ||
+        maxTextBytes > 4 * 1024 ** 2)
+        throw new CliError("validation_error", "local speech requires an absolute model directory and bounded output bytes");
+    cancelled(options.signal);
+    if (!isInstalled(model, directory))
+        throw new CliError("not_found", `speech model ${description.model} is not installed; download it explicitly with a WireCat messenger's models audio download command`);
+    const { openRecognizer, toModelRate } = await import("./recognize.js");
+    cancelled(options.signal);
+    const engine = (options.open ?? openRecognizer)(model, modelPath(directory, model), vadPath(directory));
+    let closing = false;
+    let active;
+    let closed;
+    return {
+        ...description,
+        async recognize(pcm, request = {}) {
+            if (closing)
+                throw new CliError("configuration_error", "local speech recognizer is closed");
+            if (active)
+                throw new CliError("configuration_error", "local speech recognizer accepts one window at a time");
+            const signal = options.signal && request.signal
+                ? AbortSignal.any([options.signal, request.signal])
+                : (options.signal ?? request.signal);
+            cancelled(signal);
+            if (!(pcm instanceof Float32Array) || pcm.length < 1 || pcm.length > description.maxChunkSamples)
+                throw new CliError("validation_error", "speech recognition requires at most 30 seconds of mono 16 kHz PCM");
+            const samples = new Float32Array(pcm);
+            if (samples.some((value) => !Number.isFinite(value) || Math.abs(value) > 1))
+                throw new CliError("validation_error", "speech PCM samples must be finite and normalized");
+            active = (async () => {
+                await setImmediate();
+                cancelled(signal);
+                const text = engine.recognize(toModelRate(samples, description.sampleRate));
+                cancelled(signal);
+                if (typeof text !== "string" ||
+                    text.includes("\0") ||
+                    text.length > maxTextBytes ||
+                    new TextEncoder().encode(text).byteLength > maxTextBytes)
+                    throw new CliError("invalid_response", "local speech output exceeds its text budget or is invalid");
+                return text.trim();
+            })();
+            try {
+                return await active;
+            }
+            finally {
+                active = undefined;
+            }
+        },
+        close() {
+            closing = true;
+            closed ??= (async () => {
+                await active?.catch(() => undefined);
+                engine.free();
+            })();
+            return closed;
+        },
+    };
+};
+//# sourceMappingURL=local.js.map

package/dist/speech/local.js.map

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

package/dist/speech/models.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The speech models `messages transcribe --local` can use, each **pinned to one commit** and checked by
+ * sha256: a file that does not match is refused, so nobody else's model runs in a program that
+ * holds the owner's session.
+ *
+ * Measured 2026-09-24 through the WebAssembly build of sherpa-onnx, one thread, a Ryzen AI 9 HX 470
+ * laptop, 5 minutes of Ogg Opus cut by VAD, Node 24 and Bun 1.3.14 alike (`FIND-131`, `FIND-133`):
+ * `gigaam-v3` ×7 real time, `gigaam-v3-ctc` ×8, `parakeet-v3` ×5 and 1.3 GB of memory. Whisper small
+ * ran at ×1.1 and is not offered.
+ */
+export interface ModelFile {
+    name: string;
+    url: string;
+    sha256: string;
+    bytes: number;
+}
+export interface SpeechModel {
+    id: string;
+    title: string;
+    languages: string;
+    files: ModelFile[];
+    /** The part of sherpa-onnx's `modelConfig` that names the files, given where they are. */
+    config: (path: (name: string) => string) => Record<string, unknown>;
+    featureDim: number;
+}
+export declare const MODELS: SpeechModel[];
+/** Cuts speech at pauses. Every model needs it: five minutes in one piece crash the WebAssembly build. */
+export declare const VAD: ModelFile;
+/**
+ * Parakeet first: it hears 25 languages, and a messenger's CLI whose people mostly speak one language
+ * puts that language's model first instead (`Messenger.speechModels`) — max-cli puts GigaAM first.
+ */
+export declare const DEFAULT_ORDER: string[];
+/** Every model, in the CLI's order; those it did not name follow in the default order. */
+export declare const orderedModels: (order?: readonly string[]) => SpeechModel[];
+export declare const findModel: (id: string) => SpeechModel | undefined;
+export declare const speechModel: (id: string) => SpeechModel;
+//# sourceMappingURL=models.d.ts.map

package/dist/speech/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/speech/models.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,0FAA0F;IAC1F,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnE,UAAU,EAAE,MAAM,CAAA;CACnB;AAeD,eAAO,MAAM,MAAM,EAAE,WAAW,EAqG/B,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,GAAG,EAAE,SAKjB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,UAAgD,CAAA;AAE1E,0FAA0F;AAC1F,eAAO,MAAM,aAAa,WAAW,SAAS,MAAM,EAAE,KAAmB,WAAW,EACvB,CAAA;AAE7D,eAAO,MAAM,SAAS,OAAQ,MAAM,KAAG,WAAW,GAAG,SAAoD,CAAA;AAEzG,eAAO,MAAM,WAAW,OAAQ,MAAM,KAAG,WASxC,CAAA"}