@mulmoclaude/core 5.7.1 → 5.8.1

package/dist/skill-bridge/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/skill-bridge/index.ts"],"sourcesContent":["// @mulmoclaude/core/skill-bridge — the skill staging→active mirror RULE, shared by\n// MulmoClaude and MulmoTerminal so the two hosts can't drift on what crosses the\n// `.claude/` permission gate.\n//\n// The agent writes skill drafts under `data/skills/<slug>/` (a plain data dir, no\n// `.claude/` permission special-case). This package decides which writes are\n// allowlisted and mirrors them 1:1 into `.claude/skills/<slug>/` so Claude CLI's\n// skill discovery + the collection engine pick them up. It also mirrors a\n// `rm -rf data/skills/<slug>` delete.\n//\n// What crosses — a FIXED ALLOWLIST, not the whole dir:\n//   SKILL.md          the skill body Claude CLI reads\n//   schema.json       the collection definition (a \"collection skill\" ships one)\n//   templates/<path>  action templates a schema's `actions` reference — exactly the\n//                     set the schema validator accepts (`isSafeActionTemplatePath`)\n// Everything else (README.md, assets/, arbitrary nesting) stays staging-side.\n//\n// Pure rule + fs ops, parameterized by `workspaceRoot` (passed in, not read from a\n// host module) so either host can call it. Each host wires this into its own hook /\n// PostToolUse path and triggers its own config refresh afterward.\nimport path from \"node:path\";\nimport { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { isSafeActionTemplatePath } from \"../collection/server/templatePath\";\n\nconst DATA_SKILLS_DIR = path.join(\"data\", \"skills\");\nconst CLAUDE_SKILLS_DIR = path.join(\".claude\", \"skills\");\nconst SKILL_FILENAME = \"SKILL.md\";\nconst SCHEMA_FILENAME = \"schema.json\";\n\n// Slugs follow Claude Code's skill-name convention: lowercase ASCII letters/digits\n// with single-hyphen separators. Strict so a typo / traversal never reaches the dest.\n// eslint-disable-next-line security/detect-unsafe-regex -- input is a basename slice ≤64 chars; bounded backtracking.\nconst SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\n// `rm -rf data/skills/<slug>` matcher. `match[1]` is the flag run (must contain a\n// recursive flag); `match[2]` is the slug. Wildcards / the parent dir / non-recursive\n// `rm` are intentionally NOT matched (a non-recursive rm can't delete the dir anyway,\n// so mirroring would desync the trees).\n// eslint-disable-next-line security/detect-unsafe-regex -- single-line captured Bash command; bounded.\nconst RM_RE = /^\\s*rm\\s+((?:-[a-zA-Z]+\\s+)+)['\"]?data\\/skills\\/([a-z0-9-]+)\\/?['\"]?\\s*$/;\nconst RECURSIVE_FLAG_RE = /[rR]/;\n\n/** A staging file cleared to cross the `.claude/` gate. */\nexport interface BridgeTarget {\n  /** The skill slug (the dir directly under data/skills/). */\n  slug: string;\n  /** Path segments BELOW the slug dir, e.g. `[\"SKILL.md\"]`, `[\"templates\",\"x.md\"]`.\n   *  Used verbatim for both source and destination so the mirror is 1:1. */\n  relSegments: string[];\n}\n\n/** `<workspaceRoot>/data/skills/<slug>` — the staging dir for a skill. */\nexport function dataSkillDir(workspaceRoot: string, slug: string): string {\n  return path.join(workspaceRoot, DATA_SKILLS_DIR, slug);\n}\n\n/** `<workspaceRoot>/.claude/skills/<slug>` — the active dir Claude CLI discovers. */\nexport function claudeSkillDir(workspaceRoot: string, slug: string): string {\n  return path.join(workspaceRoot, CLAUDE_SKILLS_DIR, slug);\n}\n\n// Allowlist a path below the slug dir: SKILL.md / schema.json at the top, or a safe\n// `templates/<path>` (the same predicate the schema validator uses, so what a schema\n// can declare is exactly what crosses). Everything else → false.\nfunction isAllowlisted(relSegments: string[]): boolean {\n  if (relSegments.length === 1) {\n    return relSegments[0] === SKILL_FILENAME || relSegments[0] === SCHEMA_FILENAME;\n  }\n  return isSafeActionTemplatePath(relSegments.join(\"/\"));\n}\n\n/** Resolve a Write/Edit path to the staging file it mirrors, or null when it isn't a\n *  bridged file (not under `data/skills/<slug>/`, bad slug, or off the allowlist). */\nexport function bridgeTargetFromDataPath(workspaceRoot: string, filePath: string): BridgeTarget | null {\n  const staging = path.join(workspaceRoot, DATA_SKILLS_DIR);\n  const rel = path.relative(staging, filePath);\n  if (!rel || rel.startsWith(\"..\") || path.isAbsolute(rel)) return null;\n  const [slug, ...relSegments] = rel.split(path.sep);\n  if (!slug || relSegments.length === 0) return null; // need at least `<slug>/<file>`\n  if (!SLUG_RE.test(slug)) return null;\n  if (!isAllowlisted(relSegments)) return null;\n  return { slug, relSegments };\n}\n\n/** Extract the slug from a Bash `rm -rf data/skills/<slug>` command, or null on any\n *  mismatch (wildcards, paths outside staging, non-recursive `rm`). */\nexport function slugFromRmCommand(command: string): string | null {\n  const match = RM_RE.exec(command);\n  if (!match) return null;\n  // Both groups are mandatory in RM_RE; the \"\" defaults fail both tests below,\n  // i.e. they land on the same `null` a non-matching command already gets.\n  const [, flags = \"\", slug = \"\"] = match;\n  if (!RECURSIVE_FLAG_RE.test(flags)) return null;\n  return SLUG_RE.test(slug) ? slug : null;\n}\n\n/** Atomic mirror of one allowlisted staging file → its active path: write a tmp file\n *  in the dest dir, then rename onto the canonical path (atomic on POSIX; both paths\n *  share a filesystem). A killed mid-write leaves a harmless tmp and the previous\n *  SKILL.md intact. Returns the resolved src/dest for logging. */\nexport function mirrorSkillWrite(workspaceRoot: string, target: BridgeTarget): { src: string; dest: string } {\n  const { slug, relSegments } = target;\n  const src = path.join(dataSkillDir(workspaceRoot, slug), ...relSegments);\n  const content = readFileSync(src, \"utf-8\");\n  const dest = path.join(claudeSkillDir(workspaceRoot, slug), ...relSegments);\n  const destDir = path.dirname(dest);\n  mkdirSync(destDir, { recursive: true }); // covers templates/ + the slug dir on first install\n  const tmp = path.join(destDir, `.${path.basename(dest)}.${process.pid}.tmp`);\n  writeFileSync(tmp, content, \"utf-8\");\n  renameSync(tmp, dest);\n  return { src, dest };\n}\n\n/** Remove the active skill dir (mirrors a staging `rm -rf`). Returns the dest. */\nexport function mirrorSkillDelete(workspaceRoot: string, slug: string): { dest: string } {\n  const dest = claudeSkillDir(workspaceRoot, slug);\n  rmSync(dest, { recursive: true, force: true });\n  return { dest };\n}\n"],"mappings":";;;;;;;AAwBA,IAAM,kBAAkB,UAAA,QAAK,KAAK,QAAQ,QAAQ;AAClD,IAAM,oBAAoB,UAAA,QAAK,KAAK,WAAW,QAAQ;AACvD,IAAM,iBAAiB;AACvB,IAAM,kBAAkB;AAKxB,IAAM,UAAU;AAOhB,IAAM,QAAQ;AACd,IAAM,oBAAoB;;AAY1B,SAAgB,aAAa,eAAuB,MAAsB;CACxE,OAAO,UAAA,QAAK,KAAK,eAAe,iBAAiB,IAAI;AACvD;;AAGA,SAAgB,eAAe,eAAuB,MAAsB;CAC1E,OAAO,UAAA,QAAK,KAAK,eAAe,mBAAmB,IAAI;AACzD;AAKA,SAAS,cAAc,aAAgC;CACrD,IAAI,YAAY,WAAW,GACzB,OAAO,YAAY,OAAO,kBAAkB,YAAY,OAAO;CAEjE,OAAO,qBAAA,yBAAyB,YAAY,KAAK,GAAG,CAAC;AACvD;;;AAIA,SAAgB,yBAAyB,eAAuB,UAAuC;CACrG,MAAM,UAAU,UAAA,QAAK,KAAK,eAAe,eAAe;CACxD,MAAM,MAAM,UAAA,QAAK,SAAS,SAAS,QAAQ;CAC3C,IAAI,CAAC,OAAO,IAAI,WAAW,IAAI,KAAK,UAAA,QAAK,WAAW,GAAG,GAAG,OAAO;CACjE,MAAM,CAAC,MAAM,GAAG,eAAe,IAAI,MAAM,UAAA,QAAK,GAAG;CACjD,IAAI,CAAC,QAAQ,YAAY,WAAW,GAAG,OAAO;CAC9C,IAAI,CAAC,QAAQ,KAAK,IAAI,GAAG,OAAO;CAChC,IAAI,CAAC,cAAc,WAAW,GAAG,OAAO;CACxC,OAAO;EAAE;EAAM;CAAY;AAC7B;;;AAIA,SAAgB,kBAAkB,SAAgC;CAChE,MAAM,QAAQ,MAAM,KAAK,OAAO;CAChC,IAAI,CAAC,OAAO,OAAO;CAGnB,MAAM,GAAG,QAAQ,IAAI,OAAO,MAAM;CAClC,IAAI,CAAC,kBAAkB,KAAK,KAAK,GAAG,OAAO;CAC3C,OAAO,QAAQ,KAAK,IAAI,IAAI,OAAO;AACrC;;;;;AAMA,SAAgB,iBAAiB,eAAuB,QAAqD;CAC3G,MAAM,EAAE,MAAM,gBAAgB;CAC9B,MAAM,MAAM,UAAA,QAAK,KAAK,aAAa,eAAe,IAAI,GAAG,GAAG,WAAW;CACvE,MAAM,WAAA,GAAU,QAAA,aAAA,CAAa,KAAK,OAAO;CACzC,MAAM,OAAO,UAAA,QAAK,KAAK,eAAe,eAAe,IAAI,GAAG,GAAG,WAAW;CAC1E,MAAM,UAAU,UAAA,QAAK,QAAQ,IAAI;CACjC,CAAA,GAAA,QAAA,UAAA,CAAU,SAAS,EAAE,WAAW,KAAK,CAAC;CACtC,MAAM,MAAM,UAAA,QAAK,KAAK,SAAS,IAAI,UAAA,QAAK,SAAS,IAAI,EAAE,GAAG,QAAQ,IAAI,KAAK;CAC3E,CAAA,GAAA,QAAA,cAAA,CAAc,KAAK,SAAS,OAAO;CACnC,CAAA,GAAA,QAAA,WAAA,CAAW,KAAK,IAAI;CACpB,OAAO;EAAE;EAAK;CAAK;AACrB;;AAGA,SAAgB,kBAAkB,eAAuB,MAAgC;CACvF,MAAM,OAAO,eAAe,eAAe,IAAI;CAC/C,CAAA,GAAA,QAAA,OAAA,CAAO,MAAM;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CAC7C,OAAO,EAAE,KAAK;AAChB"}
+{"version":3,"file":"index.cjs","names":["path","isSafeActionTemplatePath","readFileSync"],"sources":["../../src/skill-bridge/index.ts"],"sourcesContent":["// @mulmoclaude/core/skill-bridge — the skill staging→active mirror RULE, shared by\n// MulmoClaude and MulmoTerminal so the two hosts can't drift on what crosses the\n// `.claude/` permission gate.\n//\n// The agent writes skill drafts under `data/skills/<slug>/` (a plain data dir, no\n// `.claude/` permission special-case). This package decides which writes are\n// allowlisted and mirrors them 1:1 into `.claude/skills/<slug>/` so Claude CLI's\n// skill discovery + the collection engine pick them up. It also mirrors a\n// `rm -rf data/skills/<slug>` delete.\n//\n// What crosses — a FIXED ALLOWLIST, not the whole dir:\n//   SKILL.md          the skill body Claude CLI reads\n//   schema.json       the collection definition (a \"collection skill\" ships one)\n//   templates/<path>  action templates a schema's `actions` reference — exactly the\n//                     set the schema validator accepts (`isSafeActionTemplatePath`)\n// Everything else (README.md, assets/, arbitrary nesting) stays staging-side.\n//\n// Pure rule + fs ops, parameterized by `workspaceRoot` (passed in, not read from a\n// host module) so either host can call it. Each host wires this into its own hook /\n// PostToolUse path and triggers its own config refresh afterward.\nimport path from \"node:path\";\nimport { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { isSafeActionTemplatePath } from \"../collection/server/templatePath\";\n\nconst DATA_SKILLS_DIR = path.join(\"data\", \"skills\");\nconst CLAUDE_SKILLS_DIR = path.join(\".claude\", \"skills\");\nconst SKILL_FILENAME = \"SKILL.md\";\nconst SCHEMA_FILENAME = \"schema.json\";\n\n// Slugs follow Claude Code's skill-name convention: lowercase ASCII letters/digits\n// with single-hyphen separators. Strict so a typo / traversal never reaches the dest.\n// eslint-disable-next-line security/detect-unsafe-regex -- input is a basename slice ≤64 chars; bounded backtracking.\nconst SLUG_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n\n// `rm -rf data/skills/<slug>` matcher. `match[1]` is the flag run (must contain a\n// recursive flag); `match[2]` is the slug. Wildcards / the parent dir / non-recursive\n// `rm` are intentionally NOT matched (a non-recursive rm can't delete the dir anyway,\n// so mirroring would desync the trees).\n// eslint-disable-next-line security/detect-unsafe-regex -- single-line captured Bash command; bounded.\nconst RM_RE = /^\\s*rm\\s+((?:-[a-zA-Z]+\\s+)+)['\"]?data\\/skills\\/([a-z0-9-]+)\\/?['\"]?\\s*$/;\nconst RECURSIVE_FLAG_RE = /[rR]/;\n\n/** A staging file cleared to cross the `.claude/` gate. */\nexport interface BridgeTarget {\n  /** The skill slug (the dir directly under data/skills/). */\n  slug: string;\n  /** Path segments BELOW the slug dir, e.g. `[\"SKILL.md\"]`, `[\"templates\",\"x.md\"]`.\n   *  Used verbatim for both source and destination so the mirror is 1:1. */\n  relSegments: string[];\n}\n\n/** `<workspaceRoot>/data/skills/<slug>` — the staging dir for a skill. */\nexport function dataSkillDir(workspaceRoot: string, slug: string): string {\n  return path.join(workspaceRoot, DATA_SKILLS_DIR, slug);\n}\n\n/** `<workspaceRoot>/.claude/skills/<slug>` — the active dir Claude CLI discovers. */\nexport function claudeSkillDir(workspaceRoot: string, slug: string): string {\n  return path.join(workspaceRoot, CLAUDE_SKILLS_DIR, slug);\n}\n\n// Allowlist a path below the slug dir: SKILL.md / schema.json at the top, or a safe\n// `templates/<path>` (the same predicate the schema validator uses, so what a schema\n// can declare is exactly what crosses). Everything else → false.\nfunction isAllowlisted(relSegments: string[]): boolean {\n  if (relSegments.length === 1) {\n    return relSegments[0] === SKILL_FILENAME || relSegments[0] === SCHEMA_FILENAME;\n  }\n  return isSafeActionTemplatePath(relSegments.join(\"/\"));\n}\n\n/** Resolve a Write/Edit path to the staging file it mirrors, or null when it isn't a\n *  bridged file (not under `data/skills/<slug>/`, bad slug, or off the allowlist). */\nexport function bridgeTargetFromDataPath(workspaceRoot: string, filePath: string): BridgeTarget | null {\n  const staging = path.join(workspaceRoot, DATA_SKILLS_DIR);\n  const rel = path.relative(staging, filePath);\n  if (!rel || rel.startsWith(\"..\") || path.isAbsolute(rel)) return null;\n  const [slug, ...relSegments] = rel.split(path.sep);\n  if (!slug || relSegments.length === 0) return null; // need at least `<slug>/<file>`\n  if (!SLUG_RE.test(slug)) return null;\n  if (!isAllowlisted(relSegments)) return null;\n  return { slug, relSegments };\n}\n\n/** Extract the slug from a Bash `rm -rf data/skills/<slug>` command, or null on any\n *  mismatch (wildcards, paths outside staging, non-recursive `rm`). */\nexport function slugFromRmCommand(command: string): string | null {\n  const match = RM_RE.exec(command);\n  if (!match) return null;\n  // Both groups are mandatory in RM_RE; the \"\" defaults fail both tests below,\n  // i.e. they land on the same `null` a non-matching command already gets.\n  const [, flags = \"\", slug = \"\"] = match;\n  if (!RECURSIVE_FLAG_RE.test(flags)) return null;\n  return SLUG_RE.test(slug) ? slug : null;\n}\n\n/** Atomic mirror of one allowlisted staging file → its active path: write a tmp file\n *  in the dest dir, then rename onto the canonical path (atomic on POSIX; both paths\n *  share a filesystem). A killed mid-write leaves a harmless tmp and the previous\n *  SKILL.md intact. Returns the resolved src/dest for logging. */\nexport function mirrorSkillWrite(workspaceRoot: string, target: BridgeTarget): { src: string; dest: string } {\n  const { slug, relSegments } = target;\n  const src = path.join(dataSkillDir(workspaceRoot, slug), ...relSegments);\n  const content = readFileSync(src, \"utf-8\");\n  const dest = path.join(claudeSkillDir(workspaceRoot, slug), ...relSegments);\n  const destDir = path.dirname(dest);\n  mkdirSync(destDir, { recursive: true }); // covers templates/ + the slug dir on first install\n  const tmp = path.join(destDir, `.${path.basename(dest)}.${process.pid}.tmp`);\n  writeFileSync(tmp, content, \"utf-8\");\n  renameSync(tmp, dest);\n  return { src, dest };\n}\n\n/** Remove the active skill dir (mirrors a staging `rm -rf`). Returns the dest. */\nexport function mirrorSkillDelete(workspaceRoot: string, slug: string): { dest: string } {\n  const dest = claudeSkillDir(workspaceRoot, slug);\n  rmSync(dest, { recursive: true, force: true });\n  return { dest };\n}\n"],"mappings":";;;;;;;AAwBA,IAAM,kBAAkBA,UAAAA,QAAK,KAAK,QAAQ,QAAQ;AAClD,IAAM,oBAAoBA,UAAAA,QAAK,KAAK,WAAW,QAAQ;AACvD,IAAM,iBAAiB;AACvB,IAAM,kBAAkB;AAKxB,IAAM,UAAU;AAOhB,IAAM,QAAQ;AACd,IAAM,oBAAoB;;AAY1B,SAAgB,aAAa,eAAuB,MAAsB;CACxE,OAAOA,UAAAA,QAAK,KAAK,eAAe,iBAAiB,IAAI;AACvD;;AAGA,SAAgB,eAAe,eAAuB,MAAsB;CAC1E,OAAOA,UAAAA,QAAK,KAAK,eAAe,mBAAmB,IAAI;AACzD;AAKA,SAAS,cAAc,aAAgC;CACrD,IAAI,YAAY,WAAW,GACzB,OAAO,YAAY,OAAO,kBAAkB,YAAY,OAAO;CAEjE,OAAOC,qBAAAA,yBAAyB,YAAY,KAAK,GAAG,CAAC;AACvD;;;AAIA,SAAgB,yBAAyB,eAAuB,UAAuC;CACrG,MAAM,UAAUD,UAAAA,QAAK,KAAK,eAAe,eAAe;CACxD,MAAM,MAAMA,UAAAA,QAAK,SAAS,SAAS,QAAQ;CAC3C,IAAI,CAAC,OAAO,IAAI,WAAW,IAAI,KAAKA,UAAAA,QAAK,WAAW,GAAG,GAAG,OAAO;CACjE,MAAM,CAAC,MAAM,GAAG,eAAe,IAAI,MAAMA,UAAAA,QAAK,GAAG;CACjD,IAAI,CAAC,QAAQ,YAAY,WAAW,GAAG,OAAO;CAC9C,IAAI,CAAC,QAAQ,KAAK,IAAI,GAAG,OAAO;CAChC,IAAI,CAAC,cAAc,WAAW,GAAG,OAAO;CACxC,OAAO;EAAE;EAAM;CAAY;AAC7B;;;AAIA,SAAgB,kBAAkB,SAAgC;CAChE,MAAM,QAAQ,MAAM,KAAK,OAAO;CAChC,IAAI,CAAC,OAAO,OAAO;CAGnB,MAAM,GAAG,QAAQ,IAAI,OAAO,MAAM;CAClC,IAAI,CAAC,kBAAkB,KAAK,KAAK,GAAG,OAAO;CAC3C,OAAO,QAAQ,KAAK,IAAI,IAAI,OAAO;AACrC;;;;;AAMA,SAAgB,iBAAiB,eAAuB,QAAqD;CAC3G,MAAM,EAAE,MAAM,gBAAgB;CAC9B,MAAM,MAAMA,UAAAA,QAAK,KAAK,aAAa,eAAe,IAAI,GAAG,GAAG,WAAW;CACvE,MAAM,WAAA,GAAUE,QAAAA,aAAAA,CAAa,KAAK,OAAO;CACzC,MAAM,OAAOF,UAAAA,QAAK,KAAK,eAAe,eAAe,IAAI,GAAG,GAAG,WAAW;CAC1E,MAAM,UAAUA,UAAAA,QAAK,QAAQ,IAAI;CACjC,CAAA,GAAA,QAAA,UAAA,CAAU,SAAS,EAAE,WAAW,KAAK,CAAC;CACtC,MAAM,MAAMA,UAAAA,QAAK,KAAK,SAAS,IAAIA,UAAAA,QAAK,SAAS,IAAI,EAAE,GAAG,QAAQ,IAAI,KAAK;CAC3E,CAAA,GAAA,QAAA,cAAA,CAAc,KAAK,SAAS,OAAO;CACnC,CAAA,GAAA,QAAA,WAAA,CAAW,KAAK,IAAI;CACpB,OAAO;EAAE;EAAK;CAAK;AACrB;;AAGA,SAAgB,kBAAkB,eAAuB,MAAgC;CACvF,MAAM,OAAO,eAAe,eAAe,IAAI;CAC/C,CAAA,GAAA,QAAA,OAAA,CAAO,MAAM;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CAC7C,OAAO,EAAE,KAAK;AAChB"}

package/dist/utils/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("../dist-Gj7ygaW2.cjs");
-const require_errors = require("../errors-CdXsfFCF.cjs");
+const require_dist = require("../dist-BZ62pKuU.cjs");
+const require_errors = require("../errors-B0xloJ3E.cjs");
 const require_text = require("../text-CaAh9ZSO.cjs");
 exports.errorMessage = require_dist.errorMessage;
 exports.toError = require_errors.toError;

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-import { t as errorMessage } from "../dist-BzoA9pDR.js";
-import { t as toError } from "../errors-C7TI_t_4.js";
+import { t as errorMessage } from "../dist-MFUV9FYo.js";
+import { t as toError } from "../errors-zTAsW7dS.js";
 import { t as truncate } from "../text-CjDbP2O1.js";
 export { errorMessage, toError, truncate };

package/dist/whisper/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../rolldown-runtime-VH7oDXx4.cjs");
-const require_dist = require("../dist-Gj7ygaW2.cjs");
-require("../errors-CdXsfFCF.cjs");
+const require_dist = require("../dist-BZ62pKuU.cjs");
+require("../errors-B0xloJ3E.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);

package/dist/whisper/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/whisper/internal.ts","../../src/whisper/ffmpeg.ts","../../src/whisper/models.ts","../../src/whisper/sidecar-helpers.ts","../../src/whisper/sidecar.ts","../../src/whisper/whisper.ts"],"sourcesContent":["// Small self-contained utilities so the package has no host dependencies.\n\nexport const ONE_SECOND_MS = 1_000;\nexport const ONE_MINUTE_MS = 60_000;\n\nexport { errorMessage } from \"../utils/errors.js\";\n\n/** Minimal logger the host can inject; defaults to no-op so the package\n *  is silent unless wired up. */\nexport interface WhisperLogger {\n  info: (message: string, data?: unknown) => void;\n  warn: (message: string, data?: unknown) => void;\n  error: (message: string, data?: unknown) => void;\n}\n\nconst NOOP = (): void => undefined;\nexport const NOOP_LOGGER: WhisperLogger = { info: NOOP, warn: NOOP, error: NOOP };\n","// Thin wrapper around the system `ffmpeg` binary (provided by the host) for\n// converting a browser webm/opus clip to the 16 kHz mono 16-bit WAV whisper.cpp\n// requires.\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { ONE_MINUTE_MS } from \"./internal.ts\";\n\nconst execFileAsync = promisify(execFile);\n\n/** ffmpeg args to decode any input to 16 kHz mono signed-16-bit WAV. Pure +\n *  exported for unit tests. */\nexport function buildWav16kArgs(inputPath: string, outputPath: string): string[] {\n  return [\"-y\", \"-loglevel\", \"error\", \"-i\", inputPath, \"-ar\", \"16000\", \"-ac\", \"1\", \"-c:a\", \"pcm_s16le\", outputPath];\n}\n\n/** Convert `inputPath` to a 16 kHz mono WAV at `outputPath`. Throws on ffmpeg\n *  failure or timeout. */\nexport async function convertToWav16k(inputPath: string, outputPath: string, ffmpegBinary = \"ffmpeg\"): Promise<void> {\n  await execFileAsync(ffmpegBinary, buildWav16kArgs(inputPath, outputPath), {\n    timeout: ONE_MINUTE_MS,\n  });\n}\n","// Whisper GGML model registry + on-disk management. The host injects the models\n// directory (e.g. `{workspace}/models`); nothing here reads a host module.\n\nimport { createWriteStream, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { once } from \"node:events\";\nimport path from \"node:path\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, type WhisperLogger } from \"./internal.ts\";\n\nexport interface WhisperModelSpec {\n  /** GGML filename — identical on disk and in the Hugging Face repo. */\n  readonly file: string;\n  /** Download URL (Hugging Face whisper.cpp model repo). */\n  readonly url: string;\n  /** Conservative lower bound on the finished file size, in bytes — guards\n   *  against a truncated transfer or an HTML error page saved as the model\n   *  without pinning an exact checksum. */\n  readonly minBytes: number;\n}\n\nconst HF_BASE = \"https://huggingface.co/ggerganov/whisper.cpp/resolve/main\";\n\n// large-v3-turbo: strong accuracy, near-real-time on Apple Silicon with Metal.\n// small/base are lighter fallbacks for low-RAM machines.\nexport const WHISPER_MODELS = {\n  \"large-v3-turbo\": { file: \"ggml-large-v3-turbo.bin\", url: `${HF_BASE}/ggml-large-v3-turbo.bin`, minBytes: 1_000_000_000 },\n  small: { file: \"ggml-small.bin\", url: `${HF_BASE}/ggml-small.bin`, minBytes: 300_000_000 },\n  base: { file: \"ggml-base.bin\", url: `${HF_BASE}/ggml-base.bin`, minBytes: 100_000_000 },\n} as const satisfies Record<string, WhisperModelSpec>;\n\nexport type WhisperModelName = keyof typeof WHISPER_MODELS;\nexport const DEFAULT_WHISPER_MODEL: WhisperModelName = \"large-v3-turbo\";\n\nexport function isWhisperModelName(value: unknown): value is WhisperModelName {\n  // Own-property check — `in` would accept inherited keys like \"toString\",\n  // which then crash the `WHISPER_MODELS[name]` lookups instead of falling\n  // back to the default.\n  return typeof value === \"string\" && Object.prototype.hasOwnProperty.call(WHISPER_MODELS, value);\n}\n\n/** Resolve a possibly-unset / unknown model name to a valid one. */\nexport function resolveModelName(name: string | undefined): WhisperModelName {\n  return isWhisperModelName(name) ? name : DEFAULT_WHISPER_MODEL;\n}\n\nexport function modelFilePath(modelsDir: string, name: WhisperModelName): string {\n  return path.join(modelsDir, WHISPER_MODELS[name].file);\n}\n\n/** A model is \"ready\" when its file exists and meets the size floor. */\nexport function isModelReady(modelsDir: string, name: WhisperModelName): boolean {\n  try {\n    return statSync(modelFilePath(modelsDir, name)).size >= WHISPER_MODELS[name].minBytes;\n  } catch {\n    return false;\n  }\n}\n\nexport type ModelDownloadState = \"idle\" | \"downloading\" | \"ready\" | \"error\";\n\nexport interface ModelStatus {\n  state: ModelDownloadState;\n  /** 0..1 — present only while downloading and Content-Length is known. */\n  progress?: number;\n  /** Present only in the \"error\" state. */\n  error?: string;\n}\n\n/** Report status precedence: an in-flight download wins, then an on-disk ready\n *  file, then the last transient state (idle if none). Pure so the precedence\n *  is unit-testable without touching the filesystem. */\nexport function pickModelStatus(live: ModelStatus | undefined, isReady: boolean): ModelStatus {\n  if (live?.state === \"downloading\") return live;\n  if (isReady) return { state: \"ready\" };\n  return live ?? { state: \"idle\" };\n}\n\n/** Parse a `Content-Length` header to a byte count; unknown / malformed → 0. */\nexport function parseContentLength(header: string | null): number {\n  return Number(header) || 0;\n}\n\n// Abort a download if no bytes arrive for this long (stalled connection).\nconst DOWNLOAD_STALL_TIMEOUT_MS = ONE_MINUTE_MS;\n\nexport interface ModelDownloader {\n  getStatus: (name: WhisperModelName) => ModelStatus;\n  ensure: (name: WhisperModelName) => Promise<void>;\n}\n\ninterface StreamToFileDeps {\n  downloadStatus: Map<WhisperModelName, ModelStatus>;\n  onProgress: () => void;\n}\n\n/** Drain the response stream into the `.partial` file, resetting the stall\n *  timer on every chunk and publishing progress once the total size is known. */\nasync function streamToFile(\n  body: ReadableStream<Uint8Array>,\n  partialPath: string,\n  total: number,\n  name: WhisperModelName,\n  deps: StreamToFileDeps,\n): Promise<void> {\n  const reader = body.getReader();\n  const fileStream = createWriteStream(partialPath);\n  let received = 0;\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      deps.onProgress();\n      received += value.byteLength;\n      if (!fileStream.write(value)) await once(fileStream, \"drain\");\n      if (total > 0) deps.downloadStatus.set(name, { state: \"downloading\", progress: received / total });\n    }\n    fileStream.end();\n    await once(fileStream, \"finish\");\n  } catch (err) {\n    // `createWriteStream` opens lazily. Destroying it while that open is still\n    // in flight lets the open's own failure land later as an `error` event with\n    // no listener — an uncaughtException that kills the process. `err` already\n    // carries the real cause, so absorb the late one.\n    fileStream.on(\"error\", () => {});\n    fileStream.destroy();\n    throw err;\n  }\n}\n\n/** Fetch a model into a `.partial` file, reject a truncated transfer via the\n *  size floor, then atomically rename it into place. */\nasync function downloadModel(name: WhisperModelName, modelsDir: string, downloadStatus: Map<WhisperModelName, ModelStatus>): Promise<void> {\n  const spec = WHISPER_MODELS[name];\n  mkdirSync(modelsDir, { recursive: true });\n  const dest = modelFilePath(modelsDir, name);\n  const partial = `${dest}.partial`;\n  const controller = new AbortController();\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  const resetStall = () => {\n    if (stallTimer) clearTimeout(stallTimer);\n    stallTimer = setTimeout(() => controller.abort(), DOWNLOAD_STALL_TIMEOUT_MS);\n  };\n  try {\n    const response = await fetch(spec.url, { signal: controller.signal });\n    if (!response.ok || !response.body) {\n      throw new Error(`download failed: HTTP ${response.status}`);\n    }\n    const total = parseContentLength(response.headers.get(\"content-length\"));\n    resetStall();\n    await streamToFile(response.body, partial, total, name, { downloadStatus, onProgress: resetStall });\n    if (statSync(partial).size < spec.minBytes) {\n      unlinkSync(partial);\n      throw new Error(\"downloaded file is smaller than expected — likely truncated\");\n    }\n    renameSync(partial, dest);\n  } finally {\n    if (stallTimer) clearTimeout(stallTimer);\n  }\n}\n\nexport function createModelDownloader(modelsDir: string, logger: WhisperLogger = NOOP_LOGGER): ModelDownloader {\n  // A finished file on disk is the source of truth for \"ready\"; this map tracks\n  // transient progress + the last error.\n  const downloadStatus = new Map<WhisperModelName, ModelStatus>();\n\n  function getStatus(name: WhisperModelName): ModelStatus {\n    return pickModelStatus(downloadStatus.get(name), isModelReady(modelsDir, name));\n  }\n\n  // Fire-and-forget friendly: errors land in the status map, never thrown.\n  // Idempotent — a second call while a download is in flight does nothing.\n  async function ensure(name: WhisperModelName): Promise<void> {\n    if (isModelReady(modelsDir, name)) {\n      downloadStatus.set(name, { state: \"ready\" });\n      return;\n    }\n    if (downloadStatus.get(name)?.state === \"downloading\") return;\n    downloadStatus.set(name, { state: \"downloading\", progress: 0 });\n    logger.info(\"model download: start\", { model: name });\n    try {\n      await downloadModel(name, modelsDir, downloadStatus);\n      downloadStatus.set(name, { state: \"ready\" });\n      logger.info(\"model download: ok\", { model: name });\n    } catch (err) {\n      const error = errorMessage(err);\n      downloadStatus.set(name, { state: \"error\", error });\n      logger.error(\"model download: failed\", { model: name, error });\n    }\n  }\n\n  return { getStatus, ensure };\n}\n","// Pure helpers for the whisper-server sidecar. Kept separate from `sidecar.ts`\n// so the argv/response/stderr logic can be unit-tested without spawning a\n// process or opening a socket.\n\nimport { hasStringProp } from \"@mulmoclaude/common\";\n\n/** whisper-server CLI args to preload `modelPath` and bind to `host:port`. */\nexport function buildServerArgs(modelPath: string, host: string, port: number): string[] {\n  return [\"--model\", modelPath, \"--host\", host, \"--port\", String(port)];\n}\n\n/** Append `chunk` to a bounded stderr tail, keeping only the last `maxChars`. */\nexport function appendStderrTail(previous: string, chunk: string, maxChars: number): string {\n  return (previous + chunk).slice(-maxChars);\n}\n\n/** Extract the transcript from a whisper-server `/inference` JSON response.\n *  Returns \"\" for any shape that lacks a string `text` field. */\nexport function parseInferenceText(data: unknown): string {\n  return hasStringProp(data, \"text\") ? data.text : \"\";\n}\n","// whisper.cpp warm-model sidecar. Spawns `whisper-server` once with the model\n// preloaded and reuses it across transcriptions over its local HTTP API, so the\n// weights stay resident (no per-request reload). State is encapsulated per\n// instance via the factory closure.\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { createServer } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, ONE_SECOND_MS, type WhisperLogger } from \"./internal.ts\";\nimport { modelFilePath, type WhisperModelName } from \"./models.ts\";\nimport { appendStderrTail, buildServerArgs, parseInferenceText } from \"./sidecar-helpers.ts\";\n\nconst HOST = \"127.0.0.1\";\nconst READY_TIMEOUT_MS = 60 * ONE_SECOND_MS;\nconst READY_POLL_INTERVAL_MS = 500;\nconst INFERENCE_TIMEOUT_MS = 2 * ONE_MINUTE_MS;\nconst STDERR_TAIL_MAX_CHARS = 4_000;\n\nexport interface ActiveSidecar {\n  readonly port: number;\n  readonly proc: ChildProcess;\n  readonly model: WhisperModelName;\n}\n\nexport interface Sidecar {\n  transcribeWav: (wavPath: string, language: string, model: WhisperModelName) => Promise<string>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  shutdown: () => void;\n}\n\nasync function findFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const srv = createServer();\n    srv.on(\"error\", reject);\n    srv.listen(0, HOST, () => {\n      const addr = srv.address();\n      if (addr && typeof addr === \"object\") {\n        const { port } = addr;\n        srv.close(() => resolve(port));\n      } else {\n        srv.close(() => reject(new Error(\"could not determine a free port\")));\n      }\n    });\n  });\n}\n\n/** Resolve once the server answers any HTTP request (any status = listener up),\n *  or throw after the ready timeout. */\nasync function waitUntilReady(port: number): Promise<void> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      await fetch(`http://${HOST}:${port}/`, { signal: AbortSignal.timeout(ONE_SECOND_MS) });\n      return;\n    } catch {\n      await delay(READY_POLL_INTERVAL_MS);\n    }\n  }\n  throw new Error(\"whisper-server did not become ready in time\");\n}\n\n// whisper-server logs verbosely to stderr; left unread the OS pipe buffer fills\n// and the child blocks on its next write. Drain into a small tail buffer.\nfunction drainStderr(proc: ChildProcess, tail: { text: string }): void {\n  proc.stderr?.setEncoding(\"utf8\");\n  proc.stderr?.on(\"data\", (chunk: string) => {\n    tail.text = appendStderrTail(tail.text, chunk, STDERR_TAIL_MAX_CHARS);\n  });\n}\n\n// Resolve when the server answers, or reject on spawn failure (e.g. ENOENT) /\n// early exit. Listeners are one-shot and removed once the race settles.\nfunction waitForReadyOrFailure(proc: ChildProcess, port: number): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    let onError: (err: Error) => void = () => undefined;\n    let onExit: (code: number | null) => void = () => undefined;\n    const cleanup = () => {\n      proc.removeListener(\"error\", onError);\n      proc.removeListener(\"exit\", onExit);\n    };\n    onError = (err: Error) => {\n      cleanup();\n      reject(new Error(`spawn failed: ${errorMessage(err)}`));\n    };\n    onExit = (code: number | null) => {\n      cleanup();\n      reject(new Error(`exited early (code ${code})`));\n    };\n    proc.once(\"error\", onError);\n    proc.once(\"exit\", onExit);\n    waitUntilReady(port)\n      .then(() => {\n        cleanup();\n        resolve();\n      })\n      .catch((err: unknown) => {\n        cleanup();\n        reject(err instanceof Error ? err : new Error(String(err)));\n      });\n  });\n}\n\n// POST the wav to whisper-server's `/inference` and return the transcript.\n// Isolated from the lifecycle so the HTTP contract is unit-testable without a\n// live child (stub `fetch`, hand it a real wav path).\nexport async function postInference(port: number, wavPath: string, language: string): Promise<string> {\n  const buf = await readFile(wavPath);\n  const form = new FormData();\n  form.append(\"file\", new Blob([buf], { type: \"audio/wav\" }), \"audio.wav\");\n  form.append(\"response_format\", \"json\");\n  form.append(\"language\", language || \"auto\");\n  let res: Response;\n  try {\n    res = await fetch(`http://${HOST}:${port}/inference`, { method: \"POST\", body: form, signal: AbortSignal.timeout(INFERENCE_TIMEOUT_MS) });\n  } catch (err) {\n    throw new Error(`whisper-server request failed: ${errorMessage(err)}`);\n  }\n  if (!res.ok) throw new Error(`whisper-server returned HTTP ${res.status}`);\n  return parseInferenceText(await res.json());\n}\n\n// The impure primitives the start lifecycle depends on, injected so the\n// cancellation / single-flight / model-switch logic can be driven with fakes.\nexport interface StartLifecycleDeps {\n  /** Reserve a free TCP port for the next child — the sole async step of a start. */\n  allocatePort: () => Promise<number>;\n  /** Spawn the whisper-server child on `port`. MUST be synchronous so the spawn\n   *  and the `startingProc` handoff stay in one tick: `shutdown()` has to be able\n   *  to kill an in-flight child immediately, with no await gap after it exists. */\n  spawnServer: (model: WhisperModelName, port: number) => ChildProcess;\n  /** Resolve once the child answers HTTP, or reject on spawn failure / early exit. */\n  waitReady: (proc: ChildProcess, port: number) => Promise<void>;\n  logger: WhisperLogger;\n}\n\nexport interface StartLifecycle {\n  ensureSidecar: (model: WhisperModelName) => Promise<ActiveSidecar>;\n  shutdown: () => void;\n}\n\nexport function defaultSpawnServer(modelsDir: string, serverBinary: string, logger: WhisperLogger): StartLifecycleDeps[\"spawnServer\"] {\n  return (model: WhisperModelName, port: number): ChildProcess => {\n    const args = buildServerArgs(modelFilePath(modelsDir, model), HOST, port);\n    logger.info(\"sidecar: spawning\", { model, port });\n    return spawn(serverBinary, args, { stdio: [\"ignore\", \"ignore\", \"pipe\"] });\n  };\n}\n\n// Wires the three listeners every whisper-server child needs: stderr drain,\n// permanent `error` handler (an unhandled 'error' from ENOENT etc. would crash\n// the host), and `exit` handler that both logs and lets the caller decide\n// whether this proc is still the active one (identity check via `onExit` — a\n// stale process must not evict a newer live sidecar).\nfunction instrumentChildProcess(proc: ChildProcess, model: WhisperModelName, logger: WhisperLogger, onExit: (exited: ChildProcess) => void): { text: string } {\n  const stderrTail = { text: \"\" };\n  drainStderr(proc, stderrTail);\n  proc.on(\"error\", (err) => logger.warn(\"sidecar: process error\", { model, error: errorMessage(err) }));\n  proc.on(\"exit\", (code) => {\n    logger.warn(\"sidecar: exited\", { model, code, stderrTail: stderrTail.text.slice(-500) });\n    onExit(proc);\n  });\n  return stderrTail;\n}\n\n// Await server readiness; on failure, kill the child and surface both the\n// underlying error and the tail of stderr (whisper-server usually explains its\n// crash there). Kept at module scope so `startSidecar` stays under the\n// per-function line cap.\nasync function awaitReadyOrThrow(proc: ChildProcess, port: number, stderrTail: { text: string }, waitReady: StartLifecycleDeps[\"waitReady\"]): Promise<void> {\n  try {\n    await waitReady(proc, port);\n  } catch (err) {\n    proc.kill();\n    throw new Error(`whisper-server failed to start: ${errorMessage(err)} — stderr: ${stderrTail.text.slice(-500)}`);\n  }\n}\n\n// Abort a start that was raced by `shutdown()` (or a newer start). Compares\n// the token captured at start entry against the current token; if they differ,\n// kill the freshly-booted child rather than publish it after shutdown returned.\nfunction throwIfStartCancelled(startedToken: number, currentToken: number, proc: ChildProcess): void {\n  if (startedToken !== currentToken) {\n    proc.kill();\n    throw new Error(\"whisper-server start cancelled\");\n  }\n}\n\n// Owns the single warm child's lifecycle: which model is live, the in-flight\n// start, and the cancellation token. Kept as a factory closure so the mutable\n// state is encapsulated rather than threaded through parameters.\nexport function createStartLifecycle(deps: StartLifecycleDeps): StartLifecycle {\n  const { allocatePort, spawnServer, waitReady, logger } = deps;\n  let sidecar: ActiveSidecar | null = null;\n  let starting: { model: WhisperModelName; promise: Promise<ActiveSidecar> } | null = null;\n  // The child of an in-flight start (before it's published as `sidecar`), plus a\n  // token that `shutdown()` bumps to cancel a start that's still booting — so\n  // shutdown can't return with a child that then publishes itself afterwards.\n  let startingProc: ChildProcess | null = null;\n  let startToken = 0;\n\n  function shutdown(): void {\n    startToken += 1;\n    startingProc?.kill();\n    startingProc = null;\n    sidecar?.proc.kill();\n    sidecar = null;\n  }\n\n  async function startSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    const token = ++startToken;\n    const port = await allocatePort();\n    const proc = spawnServer(model, port);\n    startingProc = proc;\n    // onExit fires when THIS proc exits: only null out `sidecar` if it's still the live one.\n    const stderrTail = instrumentChildProcess(proc, model, logger, (exited) => sidecar?.proc === exited && (sidecar = null));\n    try {\n      await awaitReadyOrThrow(proc, port, stderrTail, waitReady);\n    } finally {\n      if (startingProc === proc) startingProc = null;\n    }\n    throwIfStartCancelled(token, startToken, proc);\n    sidecar = { port, proc, model };\n    logger.info(\"sidecar: ready\", { model, port });\n    return sidecar;\n  }\n\n  // Own function so it isn't a loop closure (no-loop-func). Only ever one start\n  // is in flight at a time, so clearing `starting` on settle is safe.\n  function beginStart(model: WhisperModelName): Promise<ActiveSidecar> {\n    const promise = startSidecar(model).finally(() => (starting = null));\n    starting = { model, promise };\n    return promise;\n  }\n\n  async function ensureSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    // Loop so that after awaiting an in-flight start for a DIFFERENT model we\n    // re-evaluate; the decision-to-spawn path (beginStart) has no await, so the\n    // first waiter sets `starting` synchronously and siblings then reuse it.\n    for (;;) {\n      if (sidecar && sidecar.model === model && !sidecar.proc.killed) return sidecar;\n      if (starting && starting.model === model) return starting.promise;\n      if (starting) {\n        await starting.promise.catch(() => undefined);\n        continue;\n      }\n      if (sidecar && sidecar.model !== model) shutdown();\n      return beginStart(model);\n    }\n  }\n\n  return { ensureSidecar, shutdown };\n}\n\nexport function createSidecar(modelsDir: string, serverBinary = \"whisper-server\", logger: WhisperLogger = NOOP_LOGGER): Sidecar {\n  const lifecycle = createStartLifecycle({\n    allocatePort: findFreePort,\n    spawnServer: defaultSpawnServer(modelsDir, serverBinary, logger),\n    waitReady: waitForReadyOrFailure,\n    logger,\n  });\n\n  async function warmup(model: WhisperModelName): Promise<void> {\n    try {\n      await lifecycle.ensureSidecar(model);\n    } catch (err) {\n      logger.warn(\"sidecar: warmup failed\", { model, error: errorMessage(err) });\n    }\n  }\n\n  async function transcribeWav(wavPath: string, language: string, model: WhisperModelName): Promise<string> {\n    const active = await lifecycle.ensureSidecar(model);\n    return postInference(active.port, wavPath, language);\n  }\n\n  return { transcribeWav, warmup, shutdown: lifecycle.shutdown };\n}\n","// Public server-side façade: wires the model downloader, the warm sidecar, and\n// ffmpeg conversion into one host-agnostic service. The host injects the models\n// directory + a logger and gates capability itself (platform / binary presence);\n// this package assumes the binaries exist when called.\n\nimport { mkdirSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport path from \"node:path\";\nimport { NOOP_LOGGER, type WhisperLogger } from \"./internal.ts\";\nimport { convertToWav16k } from \"./ffmpeg.ts\";\nimport { createModelDownloader } from \"./models.ts\";\nimport { createSidecar } from \"./sidecar.ts\";\nimport { isModelReady, type ModelStatus, type WhisperModelName } from \"./models.ts\";\n\nexport interface WhisperOptions {\n  /** Directory that holds the GGML model files (e.g. `{workspace}/models`). */\n  modelsDir: string;\n  logger?: WhisperLogger;\n  /** Defaults to \"whisper-server\" / \"ffmpeg\" on PATH. */\n  serverBinary?: string;\n  ffmpegBinary?: string;\n}\n\nexport interface TranscribeRequest {\n  base64: string;\n  mimeType: string;\n  language: string;\n  model: WhisperModelName;\n}\n\nexport interface Whisper {\n  isModelReady: (model: WhisperModelName) => boolean;\n  getModelStatus: (model: WhisperModelName) => ModelStatus;\n  /** Fire-and-forget friendly; never throws (errors land in the status). */\n  ensureModelDownloaded: (model: WhisperModelName) => Promise<void>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  transcribe: (req: TranscribeRequest) => Promise<{ text: string }>;\n  shutdown: () => void;\n}\n\n// whisper.cpp returns these sentinels for non-speech windows; treat them as\n// empty so the UI shows \"didn't catch that\" rather than a literal marker.\nconst BLANK_MARKERS = new Set([\"[blank_audio]\", \"[silence]\", \"(silence)\", \"[ inaudible ]\"]);\n\nfunction normalizeTranscript(raw: string): string {\n  const trimmed = raw.trim().replace(/\\s+/g, \" \");\n  return BLANK_MARKERS.has(trimmed.toLowerCase()) ? \"\" : trimmed;\n}\n\nexport function createWhisper(opts: WhisperOptions): Whisper {\n  const { modelsDir } = opts;\n  const logger = opts.logger ?? NOOP_LOGGER;\n  const ffmpegBinary = opts.ffmpegBinary ?? \"ffmpeg\";\n  const downloader = createModelDownloader(modelsDir, logger);\n  const sidecar = createSidecar(modelsDir, opts.serverBinary ?? \"whisper-server\", logger);\n\n  // Scratch dir for transient audio — a hidden subdir of the models dir so it\n  // shares the (non-git) models tree. Files are deleted after each transcription.\n  const scratchDir = path.join(modelsDir, \".scratch\");\n\n  async function transcribe(req: TranscribeRequest): Promise<{ text: string }> {\n    mkdirSync(scratchDir, { recursive: true });\n    const clipId = randomUUID();\n    const inputPath = path.join(scratchDir, `utterance-${clipId}.webm`);\n    const wavPath = path.join(scratchDir, `utterance-${clipId}.wav`);\n    try {\n      await writeFile(inputPath, Buffer.from(req.base64, \"base64\"));\n      await convertToWav16k(inputPath, wavPath, ffmpegBinary);\n      const text = await sidecar.transcribeWav(wavPath, req.language, req.model);\n      return { text: normalizeTranscript(text) };\n    } finally {\n      await rm(inputPath, { force: true });\n      await rm(wavPath, { force: true });\n    }\n  }\n\n  return {\n    isModelReady: (model) => isModelReady(modelsDir, model),\n    getModelStatus: (model) => downloader.getStatus(model),\n    ensureModelDownloaded: (model) => downloader.ensure(model),\n    warmup: (model) => sidecar.warmup(model),\n    transcribe,\n    shutdown: () => sidecar.shutdown(),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["promisify","execFile","path","statSync","createWriteStream","once","errorMessage","hasStringProp","createServer","delay","errorMessage","readFile","spawn","path","randomUUID","writeFile","rm"],"sources":["../../src/whisper/internal.ts","../../src/whisper/ffmpeg.ts","../../src/whisper/models.ts","../../src/whisper/sidecar-helpers.ts","../../src/whisper/sidecar.ts","../../src/whisper/whisper.ts"],"sourcesContent":["// Small self-contained utilities so the package has no host dependencies.\n\nexport const ONE_SECOND_MS = 1_000;\nexport const ONE_MINUTE_MS = 60_000;\n\nexport { errorMessage } from \"../utils/errors.js\";\n\n/** Minimal logger the host can inject; defaults to no-op so the package\n *  is silent unless wired up. */\nexport interface WhisperLogger {\n  info: (message: string, data?: unknown) => void;\n  warn: (message: string, data?: unknown) => void;\n  error: (message: string, data?: unknown) => void;\n}\n\nconst NOOP = (): void => undefined;\nexport const NOOP_LOGGER: WhisperLogger = { info: NOOP, warn: NOOP, error: NOOP };\n","// Thin wrapper around the system `ffmpeg` binary (provided by the host) for\n// converting a browser webm/opus clip to the 16 kHz mono 16-bit WAV whisper.cpp\n// requires.\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { ONE_MINUTE_MS } from \"./internal.ts\";\n\nconst execFileAsync = promisify(execFile);\n\n/** ffmpeg args to decode any input to 16 kHz mono signed-16-bit WAV. Pure +\n *  exported for unit tests. */\nexport function buildWav16kArgs(inputPath: string, outputPath: string): string[] {\n  return [\"-y\", \"-loglevel\", \"error\", \"-i\", inputPath, \"-ar\", \"16000\", \"-ac\", \"1\", \"-c:a\", \"pcm_s16le\", outputPath];\n}\n\n/** Convert `inputPath` to a 16 kHz mono WAV at `outputPath`. Throws on ffmpeg\n *  failure or timeout. */\nexport async function convertToWav16k(inputPath: string, outputPath: string, ffmpegBinary = \"ffmpeg\"): Promise<void> {\n  await execFileAsync(ffmpegBinary, buildWav16kArgs(inputPath, outputPath), {\n    timeout: ONE_MINUTE_MS,\n  });\n}\n","// Whisper GGML model registry + on-disk management. The host injects the models\n// directory (e.g. `{workspace}/models`); nothing here reads a host module.\n\nimport { createWriteStream, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { once } from \"node:events\";\nimport path from \"node:path\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, type WhisperLogger } from \"./internal.ts\";\n\nexport interface WhisperModelSpec {\n  /** GGML filename — identical on disk and in the Hugging Face repo. */\n  readonly file: string;\n  /** Download URL (Hugging Face whisper.cpp model repo). */\n  readonly url: string;\n  /** Conservative lower bound on the finished file size, in bytes — guards\n   *  against a truncated transfer or an HTML error page saved as the model\n   *  without pinning an exact checksum. */\n  readonly minBytes: number;\n}\n\nconst HF_BASE = \"https://huggingface.co/ggerganov/whisper.cpp/resolve/main\";\n\n// large-v3-turbo: strong accuracy, near-real-time on Apple Silicon with Metal.\n// small/base are lighter fallbacks for low-RAM machines.\nexport const WHISPER_MODELS = {\n  \"large-v3-turbo\": { file: \"ggml-large-v3-turbo.bin\", url: `${HF_BASE}/ggml-large-v3-turbo.bin`, minBytes: 1_000_000_000 },\n  small: { file: \"ggml-small.bin\", url: `${HF_BASE}/ggml-small.bin`, minBytes: 300_000_000 },\n  base: { file: \"ggml-base.bin\", url: `${HF_BASE}/ggml-base.bin`, minBytes: 100_000_000 },\n} as const satisfies Record<string, WhisperModelSpec>;\n\nexport type WhisperModelName = keyof typeof WHISPER_MODELS;\nexport const DEFAULT_WHISPER_MODEL: WhisperModelName = \"large-v3-turbo\";\n\nexport function isWhisperModelName(value: unknown): value is WhisperModelName {\n  // Own-property check — `in` would accept inherited keys like \"toString\",\n  // which then crash the `WHISPER_MODELS[name]` lookups instead of falling\n  // back to the default.\n  return typeof value === \"string\" && Object.prototype.hasOwnProperty.call(WHISPER_MODELS, value);\n}\n\n/** Resolve a possibly-unset / unknown model name to a valid one. */\nexport function resolveModelName(name: string | undefined): WhisperModelName {\n  return isWhisperModelName(name) ? name : DEFAULT_WHISPER_MODEL;\n}\n\nexport function modelFilePath(modelsDir: string, name: WhisperModelName): string {\n  return path.join(modelsDir, WHISPER_MODELS[name].file);\n}\n\n/** A model is \"ready\" when its file exists and meets the size floor. */\nexport function isModelReady(modelsDir: string, name: WhisperModelName): boolean {\n  try {\n    return statSync(modelFilePath(modelsDir, name)).size >= WHISPER_MODELS[name].minBytes;\n  } catch {\n    return false;\n  }\n}\n\nexport type ModelDownloadState = \"idle\" | \"downloading\" | \"ready\" | \"error\";\n\nexport interface ModelStatus {\n  state: ModelDownloadState;\n  /** 0..1 — present only while downloading and Content-Length is known. */\n  progress?: number;\n  /** Present only in the \"error\" state. */\n  error?: string;\n}\n\n/** Report status precedence: an in-flight download wins, then an on-disk ready\n *  file, then the last transient state (idle if none). Pure so the precedence\n *  is unit-testable without touching the filesystem. */\nexport function pickModelStatus(live: ModelStatus | undefined, isReady: boolean): ModelStatus {\n  if (live?.state === \"downloading\") return live;\n  if (isReady) return { state: \"ready\" };\n  return live ?? { state: \"idle\" };\n}\n\n/** Parse a `Content-Length` header to a byte count; unknown / malformed → 0. */\nexport function parseContentLength(header: string | null): number {\n  return Number(header) || 0;\n}\n\n// Abort a download if no bytes arrive for this long (stalled connection).\nconst DOWNLOAD_STALL_TIMEOUT_MS = ONE_MINUTE_MS;\n\nexport interface ModelDownloader {\n  getStatus: (name: WhisperModelName) => ModelStatus;\n  ensure: (name: WhisperModelName) => Promise<void>;\n}\n\ninterface StreamToFileDeps {\n  downloadStatus: Map<WhisperModelName, ModelStatus>;\n  onProgress: () => void;\n}\n\n/** Drain the response stream into the `.partial` file, resetting the stall\n *  timer on every chunk and publishing progress once the total size is known. */\nasync function streamToFile(\n  body: ReadableStream<Uint8Array>,\n  partialPath: string,\n  total: number,\n  name: WhisperModelName,\n  deps: StreamToFileDeps,\n): Promise<void> {\n  const reader = body.getReader();\n  const fileStream = createWriteStream(partialPath);\n  let received = 0;\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      deps.onProgress();\n      received += value.byteLength;\n      if (!fileStream.write(value)) await once(fileStream, \"drain\");\n      if (total > 0) deps.downloadStatus.set(name, { state: \"downloading\", progress: received / total });\n    }\n    fileStream.end();\n    await once(fileStream, \"finish\");\n  } catch (err) {\n    // `createWriteStream` opens lazily. Destroying it while that open is still\n    // in flight lets the open's own failure land later as an `error` event with\n    // no listener — an uncaughtException that kills the process. `err` already\n    // carries the real cause, so absorb the late one.\n    fileStream.on(\"error\", () => {});\n    fileStream.destroy();\n    throw err;\n  }\n}\n\n/** Fetch a model into a `.partial` file, reject a truncated transfer via the\n *  size floor, then atomically rename it into place. */\nasync function downloadModel(name: WhisperModelName, modelsDir: string, downloadStatus: Map<WhisperModelName, ModelStatus>): Promise<void> {\n  const spec = WHISPER_MODELS[name];\n  mkdirSync(modelsDir, { recursive: true });\n  const dest = modelFilePath(modelsDir, name);\n  const partial = `${dest}.partial`;\n  const controller = new AbortController();\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  const resetStall = () => {\n    if (stallTimer) clearTimeout(stallTimer);\n    stallTimer = setTimeout(() => controller.abort(), DOWNLOAD_STALL_TIMEOUT_MS);\n  };\n  try {\n    const response = await fetch(spec.url, { signal: controller.signal });\n    if (!response.ok || !response.body) {\n      throw new Error(`download failed: HTTP ${response.status}`);\n    }\n    const total = parseContentLength(response.headers.get(\"content-length\"));\n    resetStall();\n    await streamToFile(response.body, partial, total, name, { downloadStatus, onProgress: resetStall });\n    if (statSync(partial).size < spec.minBytes) {\n      unlinkSync(partial);\n      throw new Error(\"downloaded file is smaller than expected — likely truncated\");\n    }\n    renameSync(partial, dest);\n  } finally {\n    if (stallTimer) clearTimeout(stallTimer);\n  }\n}\n\nexport function createModelDownloader(modelsDir: string, logger: WhisperLogger = NOOP_LOGGER): ModelDownloader {\n  // A finished file on disk is the source of truth for \"ready\"; this map tracks\n  // transient progress + the last error.\n  const downloadStatus = new Map<WhisperModelName, ModelStatus>();\n\n  function getStatus(name: WhisperModelName): ModelStatus {\n    return pickModelStatus(downloadStatus.get(name), isModelReady(modelsDir, name));\n  }\n\n  // Fire-and-forget friendly: errors land in the status map, never thrown.\n  // Idempotent — a second call while a download is in flight does nothing.\n  async function ensure(name: WhisperModelName): Promise<void> {\n    if (isModelReady(modelsDir, name)) {\n      downloadStatus.set(name, { state: \"ready\" });\n      return;\n    }\n    if (downloadStatus.get(name)?.state === \"downloading\") return;\n    downloadStatus.set(name, { state: \"downloading\", progress: 0 });\n    logger.info(\"model download: start\", { model: name });\n    try {\n      await downloadModel(name, modelsDir, downloadStatus);\n      downloadStatus.set(name, { state: \"ready\" });\n      logger.info(\"model download: ok\", { model: name });\n    } catch (err) {\n      const error = errorMessage(err);\n      downloadStatus.set(name, { state: \"error\", error });\n      logger.error(\"model download: failed\", { model: name, error });\n    }\n  }\n\n  return { getStatus, ensure };\n}\n","// Pure helpers for the whisper-server sidecar. Kept separate from `sidecar.ts`\n// so the argv/response/stderr logic can be unit-tested without spawning a\n// process or opening a socket.\n\nimport { hasStringProp } from \"@mulmoclaude/common\";\n\n/** whisper-server CLI args to preload `modelPath` and bind to `host:port`. */\nexport function buildServerArgs(modelPath: string, host: string, port: number): string[] {\n  return [\"--model\", modelPath, \"--host\", host, \"--port\", String(port)];\n}\n\n/** Append `chunk` to a bounded stderr tail, keeping only the last `maxChars`. */\nexport function appendStderrTail(previous: string, chunk: string, maxChars: number): string {\n  return (previous + chunk).slice(-maxChars);\n}\n\n/** Extract the transcript from a whisper-server `/inference` JSON response.\n *  Returns \"\" for any shape that lacks a string `text` field. */\nexport function parseInferenceText(data: unknown): string {\n  return hasStringProp(data, \"text\") ? data.text : \"\";\n}\n","// whisper.cpp warm-model sidecar. Spawns `whisper-server` once with the model\n// preloaded and reuses it across transcriptions over its local HTTP API, so the\n// weights stay resident (no per-request reload). State is encapsulated per\n// instance via the factory closure.\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { createServer } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, ONE_SECOND_MS, type WhisperLogger } from \"./internal.ts\";\nimport { modelFilePath, type WhisperModelName } from \"./models.ts\";\nimport { appendStderrTail, buildServerArgs, parseInferenceText } from \"./sidecar-helpers.ts\";\n\nconst HOST = \"127.0.0.1\";\nconst READY_TIMEOUT_MS = 60 * ONE_SECOND_MS;\nconst READY_POLL_INTERVAL_MS = 500;\nconst INFERENCE_TIMEOUT_MS = 2 * ONE_MINUTE_MS;\nconst STDERR_TAIL_MAX_CHARS = 4_000;\n\nexport interface ActiveSidecar {\n  readonly port: number;\n  readonly proc: ChildProcess;\n  readonly model: WhisperModelName;\n}\n\nexport interface Sidecar {\n  transcribeWav: (wavPath: string, language: string, model: WhisperModelName) => Promise<string>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  shutdown: () => void;\n}\n\nasync function findFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const srv = createServer();\n    srv.on(\"error\", reject);\n    srv.listen(0, HOST, () => {\n      const addr = srv.address();\n      if (addr && typeof addr === \"object\") {\n        const { port } = addr;\n        srv.close(() => resolve(port));\n      } else {\n        srv.close(() => reject(new Error(\"could not determine a free port\")));\n      }\n    });\n  });\n}\n\n/** Resolve once the server answers any HTTP request (any status = listener up),\n *  or throw after the ready timeout. */\nasync function waitUntilReady(port: number): Promise<void> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      await fetch(`http://${HOST}:${port}/`, { signal: AbortSignal.timeout(ONE_SECOND_MS) });\n      return;\n    } catch {\n      await delay(READY_POLL_INTERVAL_MS);\n    }\n  }\n  throw new Error(\"whisper-server did not become ready in time\");\n}\n\n// whisper-server logs verbosely to stderr; left unread the OS pipe buffer fills\n// and the child blocks on its next write. Drain into a small tail buffer.\nfunction drainStderr(proc: ChildProcess, tail: { text: string }): void {\n  proc.stderr?.setEncoding(\"utf8\");\n  proc.stderr?.on(\"data\", (chunk: string) => {\n    tail.text = appendStderrTail(tail.text, chunk, STDERR_TAIL_MAX_CHARS);\n  });\n}\n\n// Resolve when the server answers, or reject on spawn failure (e.g. ENOENT) /\n// early exit. Listeners are one-shot and removed once the race settles.\nfunction waitForReadyOrFailure(proc: ChildProcess, port: number): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    let onError: (err: Error) => void = () => undefined;\n    let onExit: (code: number | null) => void = () => undefined;\n    const cleanup = () => {\n      proc.removeListener(\"error\", onError);\n      proc.removeListener(\"exit\", onExit);\n    };\n    onError = (err: Error) => {\n      cleanup();\n      reject(new Error(`spawn failed: ${errorMessage(err)}`));\n    };\n    onExit = (code: number | null) => {\n      cleanup();\n      reject(new Error(`exited early (code ${code})`));\n    };\n    proc.once(\"error\", onError);\n    proc.once(\"exit\", onExit);\n    waitUntilReady(port)\n      .then(() => {\n        cleanup();\n        resolve();\n      })\n      .catch((err: unknown) => {\n        cleanup();\n        reject(err instanceof Error ? err : new Error(String(err)));\n      });\n  });\n}\n\n// POST the wav to whisper-server's `/inference` and return the transcript.\n// Isolated from the lifecycle so the HTTP contract is unit-testable without a\n// live child (stub `fetch`, hand it a real wav path).\nexport async function postInference(port: number, wavPath: string, language: string): Promise<string> {\n  const buf = await readFile(wavPath);\n  const form = new FormData();\n  form.append(\"file\", new Blob([buf], { type: \"audio/wav\" }), \"audio.wav\");\n  form.append(\"response_format\", \"json\");\n  form.append(\"language\", language || \"auto\");\n  let res: Response;\n  try {\n    res = await fetch(`http://${HOST}:${port}/inference`, { method: \"POST\", body: form, signal: AbortSignal.timeout(INFERENCE_TIMEOUT_MS) });\n  } catch (err) {\n    throw new Error(`whisper-server request failed: ${errorMessage(err)}`);\n  }\n  if (!res.ok) throw new Error(`whisper-server returned HTTP ${res.status}`);\n  return parseInferenceText(await res.json());\n}\n\n// The impure primitives the start lifecycle depends on, injected so the\n// cancellation / single-flight / model-switch logic can be driven with fakes.\nexport interface StartLifecycleDeps {\n  /** Reserve a free TCP port for the next child — the sole async step of a start. */\n  allocatePort: () => Promise<number>;\n  /** Spawn the whisper-server child on `port`. MUST be synchronous so the spawn\n   *  and the `startingProc` handoff stay in one tick: `shutdown()` has to be able\n   *  to kill an in-flight child immediately, with no await gap after it exists. */\n  spawnServer: (model: WhisperModelName, port: number) => ChildProcess;\n  /** Resolve once the child answers HTTP, or reject on spawn failure / early exit. */\n  waitReady: (proc: ChildProcess, port: number) => Promise<void>;\n  logger: WhisperLogger;\n}\n\nexport interface StartLifecycle {\n  ensureSidecar: (model: WhisperModelName) => Promise<ActiveSidecar>;\n  shutdown: () => void;\n}\n\nexport function defaultSpawnServer(modelsDir: string, serverBinary: string, logger: WhisperLogger): StartLifecycleDeps[\"spawnServer\"] {\n  return (model: WhisperModelName, port: number): ChildProcess => {\n    const args = buildServerArgs(modelFilePath(modelsDir, model), HOST, port);\n    logger.info(\"sidecar: spawning\", { model, port });\n    return spawn(serverBinary, args, { stdio: [\"ignore\", \"ignore\", \"pipe\"] });\n  };\n}\n\n// Wires the three listeners every whisper-server child needs: stderr drain,\n// permanent `error` handler (an unhandled 'error' from ENOENT etc. would crash\n// the host), and `exit` handler that both logs and lets the caller decide\n// whether this proc is still the active one (identity check via `onExit` — a\n// stale process must not evict a newer live sidecar).\nfunction instrumentChildProcess(proc: ChildProcess, model: WhisperModelName, logger: WhisperLogger, onExit: (exited: ChildProcess) => void): { text: string } {\n  const stderrTail = { text: \"\" };\n  drainStderr(proc, stderrTail);\n  proc.on(\"error\", (err) => logger.warn(\"sidecar: process error\", { model, error: errorMessage(err) }));\n  proc.on(\"exit\", (code) => {\n    logger.warn(\"sidecar: exited\", { model, code, stderrTail: stderrTail.text.slice(-500) });\n    onExit(proc);\n  });\n  return stderrTail;\n}\n\n// Await server readiness; on failure, kill the child and surface both the\n// underlying error and the tail of stderr (whisper-server usually explains its\n// crash there). Kept at module scope so `startSidecar` stays under the\n// per-function line cap.\nasync function awaitReadyOrThrow(proc: ChildProcess, port: number, stderrTail: { text: string }, waitReady: StartLifecycleDeps[\"waitReady\"]): Promise<void> {\n  try {\n    await waitReady(proc, port);\n  } catch (err) {\n    proc.kill();\n    throw new Error(`whisper-server failed to start: ${errorMessage(err)} — stderr: ${stderrTail.text.slice(-500)}`);\n  }\n}\n\n// Abort a start that was raced by `shutdown()` (or a newer start). Compares\n// the token captured at start entry against the current token; if they differ,\n// kill the freshly-booted child rather than publish it after shutdown returned.\nfunction throwIfStartCancelled(startedToken: number, currentToken: number, proc: ChildProcess): void {\n  if (startedToken !== currentToken) {\n    proc.kill();\n    throw new Error(\"whisper-server start cancelled\");\n  }\n}\n\n// Owns the single warm child's lifecycle: which model is live, the in-flight\n// start, and the cancellation token. Kept as a factory closure so the mutable\n// state is encapsulated rather than threaded through parameters.\nexport function createStartLifecycle(deps: StartLifecycleDeps): StartLifecycle {\n  const { allocatePort, spawnServer, waitReady, logger } = deps;\n  let sidecar: ActiveSidecar | null = null;\n  let starting: { model: WhisperModelName; promise: Promise<ActiveSidecar> } | null = null;\n  // The child of an in-flight start (before it's published as `sidecar`), plus a\n  // token that `shutdown()` bumps to cancel a start that's still booting — so\n  // shutdown can't return with a child that then publishes itself afterwards.\n  let startingProc: ChildProcess | null = null;\n  let startToken = 0;\n\n  function shutdown(): void {\n    startToken += 1;\n    startingProc?.kill();\n    startingProc = null;\n    sidecar?.proc.kill();\n    sidecar = null;\n  }\n\n  async function startSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    const token = ++startToken;\n    const port = await allocatePort();\n    const proc = spawnServer(model, port);\n    startingProc = proc;\n    // onExit fires when THIS proc exits: only null out `sidecar` if it's still the live one.\n    const stderrTail = instrumentChildProcess(proc, model, logger, (exited) => sidecar?.proc === exited && (sidecar = null));\n    try {\n      await awaitReadyOrThrow(proc, port, stderrTail, waitReady);\n    } finally {\n      if (startingProc === proc) startingProc = null;\n    }\n    throwIfStartCancelled(token, startToken, proc);\n    sidecar = { port, proc, model };\n    logger.info(\"sidecar: ready\", { model, port });\n    return sidecar;\n  }\n\n  // Own function so it isn't a loop closure (no-loop-func). Only ever one start\n  // is in flight at a time, so clearing `starting` on settle is safe.\n  function beginStart(model: WhisperModelName): Promise<ActiveSidecar> {\n    const promise = startSidecar(model).finally(() => (starting = null));\n    starting = { model, promise };\n    return promise;\n  }\n\n  async function ensureSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    // Loop so that after awaiting an in-flight start for a DIFFERENT model we\n    // re-evaluate; the decision-to-spawn path (beginStart) has no await, so the\n    // first waiter sets `starting` synchronously and siblings then reuse it.\n    for (;;) {\n      if (sidecar && sidecar.model === model && !sidecar.proc.killed) return sidecar;\n      if (starting && starting.model === model) return starting.promise;\n      if (starting) {\n        await starting.promise.catch(() => undefined);\n        continue;\n      }\n      if (sidecar && sidecar.model !== model) shutdown();\n      return beginStart(model);\n    }\n  }\n\n  return { ensureSidecar, shutdown };\n}\n\nexport function createSidecar(modelsDir: string, serverBinary = \"whisper-server\", logger: WhisperLogger = NOOP_LOGGER): Sidecar {\n  const lifecycle = createStartLifecycle({\n    allocatePort: findFreePort,\n    spawnServer: defaultSpawnServer(modelsDir, serverBinary, logger),\n    waitReady: waitForReadyOrFailure,\n    logger,\n  });\n\n  async function warmup(model: WhisperModelName): Promise<void> {\n    try {\n      await lifecycle.ensureSidecar(model);\n    } catch (err) {\n      logger.warn(\"sidecar: warmup failed\", { model, error: errorMessage(err) });\n    }\n  }\n\n  async function transcribeWav(wavPath: string, language: string, model: WhisperModelName): Promise<string> {\n    const active = await lifecycle.ensureSidecar(model);\n    return postInference(active.port, wavPath, language);\n  }\n\n  return { transcribeWav, warmup, shutdown: lifecycle.shutdown };\n}\n","// Public server-side façade: wires the model downloader, the warm sidecar, and\n// ffmpeg conversion into one host-agnostic service. The host injects the models\n// directory + a logger and gates capability itself (platform / binary presence);\n// this package assumes the binaries exist when called.\n\nimport { mkdirSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport path from \"node:path\";\nimport { NOOP_LOGGER, type WhisperLogger } from \"./internal.ts\";\nimport { convertToWav16k } from \"./ffmpeg.ts\";\nimport { createModelDownloader } from \"./models.ts\";\nimport { createSidecar } from \"./sidecar.ts\";\nimport { isModelReady, type ModelStatus, type WhisperModelName } from \"./models.ts\";\n\nexport interface WhisperOptions {\n  /** Directory that holds the GGML model files (e.g. `{workspace}/models`). */\n  modelsDir: string;\n  logger?: WhisperLogger;\n  /** Defaults to \"whisper-server\" / \"ffmpeg\" on PATH. */\n  serverBinary?: string;\n  ffmpegBinary?: string;\n}\n\nexport interface TranscribeRequest {\n  base64: string;\n  mimeType: string;\n  language: string;\n  model: WhisperModelName;\n}\n\nexport interface Whisper {\n  isModelReady: (model: WhisperModelName) => boolean;\n  getModelStatus: (model: WhisperModelName) => ModelStatus;\n  /** Fire-and-forget friendly; never throws (errors land in the status). */\n  ensureModelDownloaded: (model: WhisperModelName) => Promise<void>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  transcribe: (req: TranscribeRequest) => Promise<{ text: string }>;\n  shutdown: () => void;\n}\n\n// whisper.cpp returns these sentinels for non-speech windows; treat them as\n// empty so the UI shows \"didn't catch that\" rather than a literal marker.\nconst BLANK_MARKERS = new Set([\"[blank_audio]\", \"[silence]\", \"(silence)\", \"[ inaudible ]\"]);\n\nfunction normalizeTranscript(raw: string): string {\n  const trimmed = raw.trim().replace(/\\s+/g, \" \");\n  return BLANK_MARKERS.has(trimmed.toLowerCase()) ? \"\" : trimmed;\n}\n\nexport function createWhisper(opts: WhisperOptions): Whisper {\n  const { modelsDir } = opts;\n  const logger = opts.logger ?? NOOP_LOGGER;\n  const ffmpegBinary = opts.ffmpegBinary ?? \"ffmpeg\";\n  const downloader = createModelDownloader(modelsDir, logger);\n  const sidecar = createSidecar(modelsDir, opts.serverBinary ?? \"whisper-server\", logger);\n\n  // Scratch dir for transient audio — a hidden subdir of the models dir so it\n  // shares the (non-git) models tree. Files are deleted after each transcription.\n  const scratchDir = path.join(modelsDir, \".scratch\");\n\n  async function transcribe(req: TranscribeRequest): Promise<{ text: string }> {\n    mkdirSync(scratchDir, { recursive: true });\n    const clipId = randomUUID();\n    const inputPath = path.join(scratchDir, `utterance-${clipId}.webm`);\n    const wavPath = path.join(scratchDir, `utterance-${clipId}.wav`);\n    try {\n      await writeFile(inputPath, Buffer.from(req.base64, \"base64\"));\n      await convertToWav16k(inputPath, wavPath, ffmpegBinary);\n      const text = await sidecar.transcribeWav(wavPath, req.language, req.model);\n      return { text: normalizeTranscript(text) };\n    } finally {\n      await rm(inputPath, { force: true });\n      await rm(wavPath, { force: true });\n    }\n  }\n\n  return {\n    isModelReady: (model) => isModelReady(modelsDir, model),\n    getModelStatus: (model) => downloader.getStatus(model),\n    ensureModelDownloaded: (model) => downloader.ensure(model),\n    warmup: (model) => sidecar.warmup(model),\n    transcribe,\n    shutdown: () => sidecar.shutdown(),\n  };\n}\n"],"mappings":"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"}

package/dist/whisper/index.js

@@ -1,5 +1,5 @@
-import { i as hasStringProp, t as errorMessage } from "../dist-BzoA9pDR.js";
-import "../errors-C7TI_t_4.js";
+import { i as hasStringProp, t as errorMessage } from "../dist-MFUV9FYo.js";
+import "../errors-zTAsW7dS.js";
 import { createWriteStream, mkdirSync, renameSync, statSync, unlinkSync } from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";

package/dist/whisper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/whisper/internal.ts","../../src/whisper/ffmpeg.ts","../../src/whisper/models.ts","../../src/whisper/sidecar-helpers.ts","../../src/whisper/sidecar.ts","../../src/whisper/whisper.ts"],"sourcesContent":["// Small self-contained utilities so the package has no host dependencies.\n\nexport const ONE_SECOND_MS = 1_000;\nexport const ONE_MINUTE_MS = 60_000;\n\nexport { errorMessage } from \"../utils/errors.js\";\n\n/** Minimal logger the host can inject; defaults to no-op so the package\n *  is silent unless wired up. */\nexport interface WhisperLogger {\n  info: (message: string, data?: unknown) => void;\n  warn: (message: string, data?: unknown) => void;\n  error: (message: string, data?: unknown) => void;\n}\n\nconst NOOP = (): void => undefined;\nexport const NOOP_LOGGER: WhisperLogger = { info: NOOP, warn: NOOP, error: NOOP };\n","// Thin wrapper around the system `ffmpeg` binary (provided by the host) for\n// converting a browser webm/opus clip to the 16 kHz mono 16-bit WAV whisper.cpp\n// requires.\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { ONE_MINUTE_MS } from \"./internal.ts\";\n\nconst execFileAsync = promisify(execFile);\n\n/** ffmpeg args to decode any input to 16 kHz mono signed-16-bit WAV. Pure +\n *  exported for unit tests. */\nexport function buildWav16kArgs(inputPath: string, outputPath: string): string[] {\n  return [\"-y\", \"-loglevel\", \"error\", \"-i\", inputPath, \"-ar\", \"16000\", \"-ac\", \"1\", \"-c:a\", \"pcm_s16le\", outputPath];\n}\n\n/** Convert `inputPath` to a 16 kHz mono WAV at `outputPath`. Throws on ffmpeg\n *  failure or timeout. */\nexport async function convertToWav16k(inputPath: string, outputPath: string, ffmpegBinary = \"ffmpeg\"): Promise<void> {\n  await execFileAsync(ffmpegBinary, buildWav16kArgs(inputPath, outputPath), {\n    timeout: ONE_MINUTE_MS,\n  });\n}\n","// Whisper GGML model registry + on-disk management. The host injects the models\n// directory (e.g. `{workspace}/models`); nothing here reads a host module.\n\nimport { createWriteStream, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { once } from \"node:events\";\nimport path from \"node:path\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, type WhisperLogger } from \"./internal.ts\";\n\nexport interface WhisperModelSpec {\n  /** GGML filename — identical on disk and in the Hugging Face repo. */\n  readonly file: string;\n  /** Download URL (Hugging Face whisper.cpp model repo). */\n  readonly url: string;\n  /** Conservative lower bound on the finished file size, in bytes — guards\n   *  against a truncated transfer or an HTML error page saved as the model\n   *  without pinning an exact checksum. */\n  readonly minBytes: number;\n}\n\nconst HF_BASE = \"https://huggingface.co/ggerganov/whisper.cpp/resolve/main\";\n\n// large-v3-turbo: strong accuracy, near-real-time on Apple Silicon with Metal.\n// small/base are lighter fallbacks for low-RAM machines.\nexport const WHISPER_MODELS = {\n  \"large-v3-turbo\": { file: \"ggml-large-v3-turbo.bin\", url: `${HF_BASE}/ggml-large-v3-turbo.bin`, minBytes: 1_000_000_000 },\n  small: { file: \"ggml-small.bin\", url: `${HF_BASE}/ggml-small.bin`, minBytes: 300_000_000 },\n  base: { file: \"ggml-base.bin\", url: `${HF_BASE}/ggml-base.bin`, minBytes: 100_000_000 },\n} as const satisfies Record<string, WhisperModelSpec>;\n\nexport type WhisperModelName = keyof typeof WHISPER_MODELS;\nexport const DEFAULT_WHISPER_MODEL: WhisperModelName = \"large-v3-turbo\";\n\nexport function isWhisperModelName(value: unknown): value is WhisperModelName {\n  // Own-property check — `in` would accept inherited keys like \"toString\",\n  // which then crash the `WHISPER_MODELS[name]` lookups instead of falling\n  // back to the default.\n  return typeof value === \"string\" && Object.prototype.hasOwnProperty.call(WHISPER_MODELS, value);\n}\n\n/** Resolve a possibly-unset / unknown model name to a valid one. */\nexport function resolveModelName(name: string | undefined): WhisperModelName {\n  return isWhisperModelName(name) ? name : DEFAULT_WHISPER_MODEL;\n}\n\nexport function modelFilePath(modelsDir: string, name: WhisperModelName): string {\n  return path.join(modelsDir, WHISPER_MODELS[name].file);\n}\n\n/** A model is \"ready\" when its file exists and meets the size floor. */\nexport function isModelReady(modelsDir: string, name: WhisperModelName): boolean {\n  try {\n    return statSync(modelFilePath(modelsDir, name)).size >= WHISPER_MODELS[name].minBytes;\n  } catch {\n    return false;\n  }\n}\n\nexport type ModelDownloadState = \"idle\" | \"downloading\" | \"ready\" | \"error\";\n\nexport interface ModelStatus {\n  state: ModelDownloadState;\n  /** 0..1 — present only while downloading and Content-Length is known. */\n  progress?: number;\n  /** Present only in the \"error\" state. */\n  error?: string;\n}\n\n/** Report status precedence: an in-flight download wins, then an on-disk ready\n *  file, then the last transient state (idle if none). Pure so the precedence\n *  is unit-testable without touching the filesystem. */\nexport function pickModelStatus(live: ModelStatus | undefined, isReady: boolean): ModelStatus {\n  if (live?.state === \"downloading\") return live;\n  if (isReady) return { state: \"ready\" };\n  return live ?? { state: \"idle\" };\n}\n\n/** Parse a `Content-Length` header to a byte count; unknown / malformed → 0. */\nexport function parseContentLength(header: string | null): number {\n  return Number(header) || 0;\n}\n\n// Abort a download if no bytes arrive for this long (stalled connection).\nconst DOWNLOAD_STALL_TIMEOUT_MS = ONE_MINUTE_MS;\n\nexport interface ModelDownloader {\n  getStatus: (name: WhisperModelName) => ModelStatus;\n  ensure: (name: WhisperModelName) => Promise<void>;\n}\n\ninterface StreamToFileDeps {\n  downloadStatus: Map<WhisperModelName, ModelStatus>;\n  onProgress: () => void;\n}\n\n/** Drain the response stream into the `.partial` file, resetting the stall\n *  timer on every chunk and publishing progress once the total size is known. */\nasync function streamToFile(\n  body: ReadableStream<Uint8Array>,\n  partialPath: string,\n  total: number,\n  name: WhisperModelName,\n  deps: StreamToFileDeps,\n): Promise<void> {\n  const reader = body.getReader();\n  const fileStream = createWriteStream(partialPath);\n  let received = 0;\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      deps.onProgress();\n      received += value.byteLength;\n      if (!fileStream.write(value)) await once(fileStream, \"drain\");\n      if (total > 0) deps.downloadStatus.set(name, { state: \"downloading\", progress: received / total });\n    }\n    fileStream.end();\n    await once(fileStream, \"finish\");\n  } catch (err) {\n    // `createWriteStream` opens lazily. Destroying it while that open is still\n    // in flight lets the open's own failure land later as an `error` event with\n    // no listener — an uncaughtException that kills the process. `err` already\n    // carries the real cause, so absorb the late one.\n    fileStream.on(\"error\", () => {});\n    fileStream.destroy();\n    throw err;\n  }\n}\n\n/** Fetch a model into a `.partial` file, reject a truncated transfer via the\n *  size floor, then atomically rename it into place. */\nasync function downloadModel(name: WhisperModelName, modelsDir: string, downloadStatus: Map<WhisperModelName, ModelStatus>): Promise<void> {\n  const spec = WHISPER_MODELS[name];\n  mkdirSync(modelsDir, { recursive: true });\n  const dest = modelFilePath(modelsDir, name);\n  const partial = `${dest}.partial`;\n  const controller = new AbortController();\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  const resetStall = () => {\n    if (stallTimer) clearTimeout(stallTimer);\n    stallTimer = setTimeout(() => controller.abort(), DOWNLOAD_STALL_TIMEOUT_MS);\n  };\n  try {\n    const response = await fetch(spec.url, { signal: controller.signal });\n    if (!response.ok || !response.body) {\n      throw new Error(`download failed: HTTP ${response.status}`);\n    }\n    const total = parseContentLength(response.headers.get(\"content-length\"));\n    resetStall();\n    await streamToFile(response.body, partial, total, name, { downloadStatus, onProgress: resetStall });\n    if (statSync(partial).size < spec.minBytes) {\n      unlinkSync(partial);\n      throw new Error(\"downloaded file is smaller than expected — likely truncated\");\n    }\n    renameSync(partial, dest);\n  } finally {\n    if (stallTimer) clearTimeout(stallTimer);\n  }\n}\n\nexport function createModelDownloader(modelsDir: string, logger: WhisperLogger = NOOP_LOGGER): ModelDownloader {\n  // A finished file on disk is the source of truth for \"ready\"; this map tracks\n  // transient progress + the last error.\n  const downloadStatus = new Map<WhisperModelName, ModelStatus>();\n\n  function getStatus(name: WhisperModelName): ModelStatus {\n    return pickModelStatus(downloadStatus.get(name), isModelReady(modelsDir, name));\n  }\n\n  // Fire-and-forget friendly: errors land in the status map, never thrown.\n  // Idempotent — a second call while a download is in flight does nothing.\n  async function ensure(name: WhisperModelName): Promise<void> {\n    if (isModelReady(modelsDir, name)) {\n      downloadStatus.set(name, { state: \"ready\" });\n      return;\n    }\n    if (downloadStatus.get(name)?.state === \"downloading\") return;\n    downloadStatus.set(name, { state: \"downloading\", progress: 0 });\n    logger.info(\"model download: start\", { model: name });\n    try {\n      await downloadModel(name, modelsDir, downloadStatus);\n      downloadStatus.set(name, { state: \"ready\" });\n      logger.info(\"model download: ok\", { model: name });\n    } catch (err) {\n      const error = errorMessage(err);\n      downloadStatus.set(name, { state: \"error\", error });\n      logger.error(\"model download: failed\", { model: name, error });\n    }\n  }\n\n  return { getStatus, ensure };\n}\n","// Pure helpers for the whisper-server sidecar. Kept separate from `sidecar.ts`\n// so the argv/response/stderr logic can be unit-tested without spawning a\n// process or opening a socket.\n\nimport { hasStringProp } from \"@mulmoclaude/common\";\n\n/** whisper-server CLI args to preload `modelPath` and bind to `host:port`. */\nexport function buildServerArgs(modelPath: string, host: string, port: number): string[] {\n  return [\"--model\", modelPath, \"--host\", host, \"--port\", String(port)];\n}\n\n/** Append `chunk` to a bounded stderr tail, keeping only the last `maxChars`. */\nexport function appendStderrTail(previous: string, chunk: string, maxChars: number): string {\n  return (previous + chunk).slice(-maxChars);\n}\n\n/** Extract the transcript from a whisper-server `/inference` JSON response.\n *  Returns \"\" for any shape that lacks a string `text` field. */\nexport function parseInferenceText(data: unknown): string {\n  return hasStringProp(data, \"text\") ? data.text : \"\";\n}\n","// whisper.cpp warm-model sidecar. Spawns `whisper-server` once with the model\n// preloaded and reuses it across transcriptions over its local HTTP API, so the\n// weights stay resident (no per-request reload). State is encapsulated per\n// instance via the factory closure.\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { createServer } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, ONE_SECOND_MS, type WhisperLogger } from \"./internal.ts\";\nimport { modelFilePath, type WhisperModelName } from \"./models.ts\";\nimport { appendStderrTail, buildServerArgs, parseInferenceText } from \"./sidecar-helpers.ts\";\n\nconst HOST = \"127.0.0.1\";\nconst READY_TIMEOUT_MS = 60 * ONE_SECOND_MS;\nconst READY_POLL_INTERVAL_MS = 500;\nconst INFERENCE_TIMEOUT_MS = 2 * ONE_MINUTE_MS;\nconst STDERR_TAIL_MAX_CHARS = 4_000;\n\nexport interface ActiveSidecar {\n  readonly port: number;\n  readonly proc: ChildProcess;\n  readonly model: WhisperModelName;\n}\n\nexport interface Sidecar {\n  transcribeWav: (wavPath: string, language: string, model: WhisperModelName) => Promise<string>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  shutdown: () => void;\n}\n\nasync function findFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const srv = createServer();\n    srv.on(\"error\", reject);\n    srv.listen(0, HOST, () => {\n      const addr = srv.address();\n      if (addr && typeof addr === \"object\") {\n        const { port } = addr;\n        srv.close(() => resolve(port));\n      } else {\n        srv.close(() => reject(new Error(\"could not determine a free port\")));\n      }\n    });\n  });\n}\n\n/** Resolve once the server answers any HTTP request (any status = listener up),\n *  or throw after the ready timeout. */\nasync function waitUntilReady(port: number): Promise<void> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      await fetch(`http://${HOST}:${port}/`, { signal: AbortSignal.timeout(ONE_SECOND_MS) });\n      return;\n    } catch {\n      await delay(READY_POLL_INTERVAL_MS);\n    }\n  }\n  throw new Error(\"whisper-server did not become ready in time\");\n}\n\n// whisper-server logs verbosely to stderr; left unread the OS pipe buffer fills\n// and the child blocks on its next write. Drain into a small tail buffer.\nfunction drainStderr(proc: ChildProcess, tail: { text: string }): void {\n  proc.stderr?.setEncoding(\"utf8\");\n  proc.stderr?.on(\"data\", (chunk: string) => {\n    tail.text = appendStderrTail(tail.text, chunk, STDERR_TAIL_MAX_CHARS);\n  });\n}\n\n// Resolve when the server answers, or reject on spawn failure (e.g. ENOENT) /\n// early exit. Listeners are one-shot and removed once the race settles.\nfunction waitForReadyOrFailure(proc: ChildProcess, port: number): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    let onError: (err: Error) => void = () => undefined;\n    let onExit: (code: number | null) => void = () => undefined;\n    const cleanup = () => {\n      proc.removeListener(\"error\", onError);\n      proc.removeListener(\"exit\", onExit);\n    };\n    onError = (err: Error) => {\n      cleanup();\n      reject(new Error(`spawn failed: ${errorMessage(err)}`));\n    };\n    onExit = (code: number | null) => {\n      cleanup();\n      reject(new Error(`exited early (code ${code})`));\n    };\n    proc.once(\"error\", onError);\n    proc.once(\"exit\", onExit);\n    waitUntilReady(port)\n      .then(() => {\n        cleanup();\n        resolve();\n      })\n      .catch((err: unknown) => {\n        cleanup();\n        reject(err instanceof Error ? err : new Error(String(err)));\n      });\n  });\n}\n\n// POST the wav to whisper-server's `/inference` and return the transcript.\n// Isolated from the lifecycle so the HTTP contract is unit-testable without a\n// live child (stub `fetch`, hand it a real wav path).\nexport async function postInference(port: number, wavPath: string, language: string): Promise<string> {\n  const buf = await readFile(wavPath);\n  const form = new FormData();\n  form.append(\"file\", new Blob([buf], { type: \"audio/wav\" }), \"audio.wav\");\n  form.append(\"response_format\", \"json\");\n  form.append(\"language\", language || \"auto\");\n  let res: Response;\n  try {\n    res = await fetch(`http://${HOST}:${port}/inference`, { method: \"POST\", body: form, signal: AbortSignal.timeout(INFERENCE_TIMEOUT_MS) });\n  } catch (err) {\n    throw new Error(`whisper-server request failed: ${errorMessage(err)}`);\n  }\n  if (!res.ok) throw new Error(`whisper-server returned HTTP ${res.status}`);\n  return parseInferenceText(await res.json());\n}\n\n// The impure primitives the start lifecycle depends on, injected so the\n// cancellation / single-flight / model-switch logic can be driven with fakes.\nexport interface StartLifecycleDeps {\n  /** Reserve a free TCP port for the next child — the sole async step of a start. */\n  allocatePort: () => Promise<number>;\n  /** Spawn the whisper-server child on `port`. MUST be synchronous so the spawn\n   *  and the `startingProc` handoff stay in one tick: `shutdown()` has to be able\n   *  to kill an in-flight child immediately, with no await gap after it exists. */\n  spawnServer: (model: WhisperModelName, port: number) => ChildProcess;\n  /** Resolve once the child answers HTTP, or reject on spawn failure / early exit. */\n  waitReady: (proc: ChildProcess, port: number) => Promise<void>;\n  logger: WhisperLogger;\n}\n\nexport interface StartLifecycle {\n  ensureSidecar: (model: WhisperModelName) => Promise<ActiveSidecar>;\n  shutdown: () => void;\n}\n\nexport function defaultSpawnServer(modelsDir: string, serverBinary: string, logger: WhisperLogger): StartLifecycleDeps[\"spawnServer\"] {\n  return (model: WhisperModelName, port: number): ChildProcess => {\n    const args = buildServerArgs(modelFilePath(modelsDir, model), HOST, port);\n    logger.info(\"sidecar: spawning\", { model, port });\n    return spawn(serverBinary, args, { stdio: [\"ignore\", \"ignore\", \"pipe\"] });\n  };\n}\n\n// Wires the three listeners every whisper-server child needs: stderr drain,\n// permanent `error` handler (an unhandled 'error' from ENOENT etc. would crash\n// the host), and `exit` handler that both logs and lets the caller decide\n// whether this proc is still the active one (identity check via `onExit` — a\n// stale process must not evict a newer live sidecar).\nfunction instrumentChildProcess(proc: ChildProcess, model: WhisperModelName, logger: WhisperLogger, onExit: (exited: ChildProcess) => void): { text: string } {\n  const stderrTail = { text: \"\" };\n  drainStderr(proc, stderrTail);\n  proc.on(\"error\", (err) => logger.warn(\"sidecar: process error\", { model, error: errorMessage(err) }));\n  proc.on(\"exit\", (code) => {\n    logger.warn(\"sidecar: exited\", { model, code, stderrTail: stderrTail.text.slice(-500) });\n    onExit(proc);\n  });\n  return stderrTail;\n}\n\n// Await server readiness; on failure, kill the child and surface both the\n// underlying error and the tail of stderr (whisper-server usually explains its\n// crash there). Kept at module scope so `startSidecar` stays under the\n// per-function line cap.\nasync function awaitReadyOrThrow(proc: ChildProcess, port: number, stderrTail: { text: string }, waitReady: StartLifecycleDeps[\"waitReady\"]): Promise<void> {\n  try {\n    await waitReady(proc, port);\n  } catch (err) {\n    proc.kill();\n    throw new Error(`whisper-server failed to start: ${errorMessage(err)} — stderr: ${stderrTail.text.slice(-500)}`);\n  }\n}\n\n// Abort a start that was raced by `shutdown()` (or a newer start). Compares\n// the token captured at start entry against the current token; if they differ,\n// kill the freshly-booted child rather than publish it after shutdown returned.\nfunction throwIfStartCancelled(startedToken: number, currentToken: number, proc: ChildProcess): void {\n  if (startedToken !== currentToken) {\n    proc.kill();\n    throw new Error(\"whisper-server start cancelled\");\n  }\n}\n\n// Owns the single warm child's lifecycle: which model is live, the in-flight\n// start, and the cancellation token. Kept as a factory closure so the mutable\n// state is encapsulated rather than threaded through parameters.\nexport function createStartLifecycle(deps: StartLifecycleDeps): StartLifecycle {\n  const { allocatePort, spawnServer, waitReady, logger } = deps;\n  let sidecar: ActiveSidecar | null = null;\n  let starting: { model: WhisperModelName; promise: Promise<ActiveSidecar> } | null = null;\n  // The child of an in-flight start (before it's published as `sidecar`), plus a\n  // token that `shutdown()` bumps to cancel a start that's still booting — so\n  // shutdown can't return with a child that then publishes itself afterwards.\n  let startingProc: ChildProcess | null = null;\n  let startToken = 0;\n\n  function shutdown(): void {\n    startToken += 1;\n    startingProc?.kill();\n    startingProc = null;\n    sidecar?.proc.kill();\n    sidecar = null;\n  }\n\n  async function startSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    const token = ++startToken;\n    const port = await allocatePort();\n    const proc = spawnServer(model, port);\n    startingProc = proc;\n    // onExit fires when THIS proc exits: only null out `sidecar` if it's still the live one.\n    const stderrTail = instrumentChildProcess(proc, model, logger, (exited) => sidecar?.proc === exited && (sidecar = null));\n    try {\n      await awaitReadyOrThrow(proc, port, stderrTail, waitReady);\n    } finally {\n      if (startingProc === proc) startingProc = null;\n    }\n    throwIfStartCancelled(token, startToken, proc);\n    sidecar = { port, proc, model };\n    logger.info(\"sidecar: ready\", { model, port });\n    return sidecar;\n  }\n\n  // Own function so it isn't a loop closure (no-loop-func). Only ever one start\n  // is in flight at a time, so clearing `starting` on settle is safe.\n  function beginStart(model: WhisperModelName): Promise<ActiveSidecar> {\n    const promise = startSidecar(model).finally(() => (starting = null));\n    starting = { model, promise };\n    return promise;\n  }\n\n  async function ensureSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    // Loop so that after awaiting an in-flight start for a DIFFERENT model we\n    // re-evaluate; the decision-to-spawn path (beginStart) has no await, so the\n    // first waiter sets `starting` synchronously and siblings then reuse it.\n    for (;;) {\n      if (sidecar && sidecar.model === model && !sidecar.proc.killed) return sidecar;\n      if (starting && starting.model === model) return starting.promise;\n      if (starting) {\n        await starting.promise.catch(() => undefined);\n        continue;\n      }\n      if (sidecar && sidecar.model !== model) shutdown();\n      return beginStart(model);\n    }\n  }\n\n  return { ensureSidecar, shutdown };\n}\n\nexport function createSidecar(modelsDir: string, serverBinary = \"whisper-server\", logger: WhisperLogger = NOOP_LOGGER): Sidecar {\n  const lifecycle = createStartLifecycle({\n    allocatePort: findFreePort,\n    spawnServer: defaultSpawnServer(modelsDir, serverBinary, logger),\n    waitReady: waitForReadyOrFailure,\n    logger,\n  });\n\n  async function warmup(model: WhisperModelName): Promise<void> {\n    try {\n      await lifecycle.ensureSidecar(model);\n    } catch (err) {\n      logger.warn(\"sidecar: warmup failed\", { model, error: errorMessage(err) });\n    }\n  }\n\n  async function transcribeWav(wavPath: string, language: string, model: WhisperModelName): Promise<string> {\n    const active = await lifecycle.ensureSidecar(model);\n    return postInference(active.port, wavPath, language);\n  }\n\n  return { transcribeWav, warmup, shutdown: lifecycle.shutdown };\n}\n","// Public server-side façade: wires the model downloader, the warm sidecar, and\n// ffmpeg conversion into one host-agnostic service. The host injects the models\n// directory + a logger and gates capability itself (platform / binary presence);\n// this package assumes the binaries exist when called.\n\nimport { mkdirSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport path from \"node:path\";\nimport { NOOP_LOGGER, type WhisperLogger } from \"./internal.ts\";\nimport { convertToWav16k } from \"./ffmpeg.ts\";\nimport { createModelDownloader } from \"./models.ts\";\nimport { createSidecar } from \"./sidecar.ts\";\nimport { isModelReady, type ModelStatus, type WhisperModelName } from \"./models.ts\";\n\nexport interface WhisperOptions {\n  /** Directory that holds the GGML model files (e.g. `{workspace}/models`). */\n  modelsDir: string;\n  logger?: WhisperLogger;\n  /** Defaults to \"whisper-server\" / \"ffmpeg\" on PATH. */\n  serverBinary?: string;\n  ffmpegBinary?: string;\n}\n\nexport interface TranscribeRequest {\n  base64: string;\n  mimeType: string;\n  language: string;\n  model: WhisperModelName;\n}\n\nexport interface Whisper {\n  isModelReady: (model: WhisperModelName) => boolean;\n  getModelStatus: (model: WhisperModelName) => ModelStatus;\n  /** Fire-and-forget friendly; never throws (errors land in the status). */\n  ensureModelDownloaded: (model: WhisperModelName) => Promise<void>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  transcribe: (req: TranscribeRequest) => Promise<{ text: string }>;\n  shutdown: () => void;\n}\n\n// whisper.cpp returns these sentinels for non-speech windows; treat them as\n// empty so the UI shows \"didn't catch that\" rather than a literal marker.\nconst BLANK_MARKERS = new Set([\"[blank_audio]\", \"[silence]\", \"(silence)\", \"[ inaudible ]\"]);\n\nfunction normalizeTranscript(raw: string): string {\n  const trimmed = raw.trim().replace(/\\s+/g, \" \");\n  return BLANK_MARKERS.has(trimmed.toLowerCase()) ? \"\" : trimmed;\n}\n\nexport function createWhisper(opts: WhisperOptions): Whisper {\n  const { modelsDir } = opts;\n  const logger = opts.logger ?? NOOP_LOGGER;\n  const ffmpegBinary = opts.ffmpegBinary ?? \"ffmpeg\";\n  const downloader = createModelDownloader(modelsDir, logger);\n  const sidecar = createSidecar(modelsDir, opts.serverBinary ?? \"whisper-server\", logger);\n\n  // Scratch dir for transient audio — a hidden subdir of the models dir so it\n  // shares the (non-git) models tree. Files are deleted after each transcription.\n  const scratchDir = path.join(modelsDir, \".scratch\");\n\n  async function transcribe(req: TranscribeRequest): Promise<{ text: string }> {\n    mkdirSync(scratchDir, { recursive: true });\n    const clipId = randomUUID();\n    const inputPath = path.join(scratchDir, `utterance-${clipId}.webm`);\n    const wavPath = path.join(scratchDir, `utterance-${clipId}.wav`);\n    try {\n      await writeFile(inputPath, Buffer.from(req.base64, \"base64\"));\n      await convertToWav16k(inputPath, wavPath, ffmpegBinary);\n      const text = await sidecar.transcribeWav(wavPath, req.language, req.model);\n      return { text: normalizeTranscript(text) };\n    } finally {\n      await rm(inputPath, { force: true });\n      await rm(wavPath, { force: true });\n    }\n  }\n\n  return {\n    isModelReady: (model) => isModelReady(modelsDir, model),\n    getModelStatus: (model) => downloader.getStatus(model),\n    ensureModelDownloaded: (model) => downloader.ensure(model),\n    warmup: (model) => sidecar.warmup(model),\n    transcribe,\n    shutdown: () => sidecar.shutdown(),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["delay"],"sources":["../../src/whisper/internal.ts","../../src/whisper/ffmpeg.ts","../../src/whisper/models.ts","../../src/whisper/sidecar-helpers.ts","../../src/whisper/sidecar.ts","../../src/whisper/whisper.ts"],"sourcesContent":["// Small self-contained utilities so the package has no host dependencies.\n\nexport const ONE_SECOND_MS = 1_000;\nexport const ONE_MINUTE_MS = 60_000;\n\nexport { errorMessage } from \"../utils/errors.js\";\n\n/** Minimal logger the host can inject; defaults to no-op so the package\n *  is silent unless wired up. */\nexport interface WhisperLogger {\n  info: (message: string, data?: unknown) => void;\n  warn: (message: string, data?: unknown) => void;\n  error: (message: string, data?: unknown) => void;\n}\n\nconst NOOP = (): void => undefined;\nexport const NOOP_LOGGER: WhisperLogger = { info: NOOP, warn: NOOP, error: NOOP };\n","// Thin wrapper around the system `ffmpeg` binary (provided by the host) for\n// converting a browser webm/opus clip to the 16 kHz mono 16-bit WAV whisper.cpp\n// requires.\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { ONE_MINUTE_MS } from \"./internal.ts\";\n\nconst execFileAsync = promisify(execFile);\n\n/** ffmpeg args to decode any input to 16 kHz mono signed-16-bit WAV. Pure +\n *  exported for unit tests. */\nexport function buildWav16kArgs(inputPath: string, outputPath: string): string[] {\n  return [\"-y\", \"-loglevel\", \"error\", \"-i\", inputPath, \"-ar\", \"16000\", \"-ac\", \"1\", \"-c:a\", \"pcm_s16le\", outputPath];\n}\n\n/** Convert `inputPath` to a 16 kHz mono WAV at `outputPath`. Throws on ffmpeg\n *  failure or timeout. */\nexport async function convertToWav16k(inputPath: string, outputPath: string, ffmpegBinary = \"ffmpeg\"): Promise<void> {\n  await execFileAsync(ffmpegBinary, buildWav16kArgs(inputPath, outputPath), {\n    timeout: ONE_MINUTE_MS,\n  });\n}\n","// Whisper GGML model registry + on-disk management. The host injects the models\n// directory (e.g. `{workspace}/models`); nothing here reads a host module.\n\nimport { createWriteStream, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { once } from \"node:events\";\nimport path from \"node:path\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, type WhisperLogger } from \"./internal.ts\";\n\nexport interface WhisperModelSpec {\n  /** GGML filename — identical on disk and in the Hugging Face repo. */\n  readonly file: string;\n  /** Download URL (Hugging Face whisper.cpp model repo). */\n  readonly url: string;\n  /** Conservative lower bound on the finished file size, in bytes — guards\n   *  against a truncated transfer or an HTML error page saved as the model\n   *  without pinning an exact checksum. */\n  readonly minBytes: number;\n}\n\nconst HF_BASE = \"https://huggingface.co/ggerganov/whisper.cpp/resolve/main\";\n\n// large-v3-turbo: strong accuracy, near-real-time on Apple Silicon with Metal.\n// small/base are lighter fallbacks for low-RAM machines.\nexport const WHISPER_MODELS = {\n  \"large-v3-turbo\": { file: \"ggml-large-v3-turbo.bin\", url: `${HF_BASE}/ggml-large-v3-turbo.bin`, minBytes: 1_000_000_000 },\n  small: { file: \"ggml-small.bin\", url: `${HF_BASE}/ggml-small.bin`, minBytes: 300_000_000 },\n  base: { file: \"ggml-base.bin\", url: `${HF_BASE}/ggml-base.bin`, minBytes: 100_000_000 },\n} as const satisfies Record<string, WhisperModelSpec>;\n\nexport type WhisperModelName = keyof typeof WHISPER_MODELS;\nexport const DEFAULT_WHISPER_MODEL: WhisperModelName = \"large-v3-turbo\";\n\nexport function isWhisperModelName(value: unknown): value is WhisperModelName {\n  // Own-property check — `in` would accept inherited keys like \"toString\",\n  // which then crash the `WHISPER_MODELS[name]` lookups instead of falling\n  // back to the default.\n  return typeof value === \"string\" && Object.prototype.hasOwnProperty.call(WHISPER_MODELS, value);\n}\n\n/** Resolve a possibly-unset / unknown model name to a valid one. */\nexport function resolveModelName(name: string | undefined): WhisperModelName {\n  return isWhisperModelName(name) ? name : DEFAULT_WHISPER_MODEL;\n}\n\nexport function modelFilePath(modelsDir: string, name: WhisperModelName): string {\n  return path.join(modelsDir, WHISPER_MODELS[name].file);\n}\n\n/** A model is \"ready\" when its file exists and meets the size floor. */\nexport function isModelReady(modelsDir: string, name: WhisperModelName): boolean {\n  try {\n    return statSync(modelFilePath(modelsDir, name)).size >= WHISPER_MODELS[name].minBytes;\n  } catch {\n    return false;\n  }\n}\n\nexport type ModelDownloadState = \"idle\" | \"downloading\" | \"ready\" | \"error\";\n\nexport interface ModelStatus {\n  state: ModelDownloadState;\n  /** 0..1 — present only while downloading and Content-Length is known. */\n  progress?: number;\n  /** Present only in the \"error\" state. */\n  error?: string;\n}\n\n/** Report status precedence: an in-flight download wins, then an on-disk ready\n *  file, then the last transient state (idle if none). Pure so the precedence\n *  is unit-testable without touching the filesystem. */\nexport function pickModelStatus(live: ModelStatus | undefined, isReady: boolean): ModelStatus {\n  if (live?.state === \"downloading\") return live;\n  if (isReady) return { state: \"ready\" };\n  return live ?? { state: \"idle\" };\n}\n\n/** Parse a `Content-Length` header to a byte count; unknown / malformed → 0. */\nexport function parseContentLength(header: string | null): number {\n  return Number(header) || 0;\n}\n\n// Abort a download if no bytes arrive for this long (stalled connection).\nconst DOWNLOAD_STALL_TIMEOUT_MS = ONE_MINUTE_MS;\n\nexport interface ModelDownloader {\n  getStatus: (name: WhisperModelName) => ModelStatus;\n  ensure: (name: WhisperModelName) => Promise<void>;\n}\n\ninterface StreamToFileDeps {\n  downloadStatus: Map<WhisperModelName, ModelStatus>;\n  onProgress: () => void;\n}\n\n/** Drain the response stream into the `.partial` file, resetting the stall\n *  timer on every chunk and publishing progress once the total size is known. */\nasync function streamToFile(\n  body: ReadableStream<Uint8Array>,\n  partialPath: string,\n  total: number,\n  name: WhisperModelName,\n  deps: StreamToFileDeps,\n): Promise<void> {\n  const reader = body.getReader();\n  const fileStream = createWriteStream(partialPath);\n  let received = 0;\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      deps.onProgress();\n      received += value.byteLength;\n      if (!fileStream.write(value)) await once(fileStream, \"drain\");\n      if (total > 0) deps.downloadStatus.set(name, { state: \"downloading\", progress: received / total });\n    }\n    fileStream.end();\n    await once(fileStream, \"finish\");\n  } catch (err) {\n    // `createWriteStream` opens lazily. Destroying it while that open is still\n    // in flight lets the open's own failure land later as an `error` event with\n    // no listener — an uncaughtException that kills the process. `err` already\n    // carries the real cause, so absorb the late one.\n    fileStream.on(\"error\", () => {});\n    fileStream.destroy();\n    throw err;\n  }\n}\n\n/** Fetch a model into a `.partial` file, reject a truncated transfer via the\n *  size floor, then atomically rename it into place. */\nasync function downloadModel(name: WhisperModelName, modelsDir: string, downloadStatus: Map<WhisperModelName, ModelStatus>): Promise<void> {\n  const spec = WHISPER_MODELS[name];\n  mkdirSync(modelsDir, { recursive: true });\n  const dest = modelFilePath(modelsDir, name);\n  const partial = `${dest}.partial`;\n  const controller = new AbortController();\n  let stallTimer: ReturnType<typeof setTimeout> | null = null;\n  const resetStall = () => {\n    if (stallTimer) clearTimeout(stallTimer);\n    stallTimer = setTimeout(() => controller.abort(), DOWNLOAD_STALL_TIMEOUT_MS);\n  };\n  try {\n    const response = await fetch(spec.url, { signal: controller.signal });\n    if (!response.ok || !response.body) {\n      throw new Error(`download failed: HTTP ${response.status}`);\n    }\n    const total = parseContentLength(response.headers.get(\"content-length\"));\n    resetStall();\n    await streamToFile(response.body, partial, total, name, { downloadStatus, onProgress: resetStall });\n    if (statSync(partial).size < spec.minBytes) {\n      unlinkSync(partial);\n      throw new Error(\"downloaded file is smaller than expected — likely truncated\");\n    }\n    renameSync(partial, dest);\n  } finally {\n    if (stallTimer) clearTimeout(stallTimer);\n  }\n}\n\nexport function createModelDownloader(modelsDir: string, logger: WhisperLogger = NOOP_LOGGER): ModelDownloader {\n  // A finished file on disk is the source of truth for \"ready\"; this map tracks\n  // transient progress + the last error.\n  const downloadStatus = new Map<WhisperModelName, ModelStatus>();\n\n  function getStatus(name: WhisperModelName): ModelStatus {\n    return pickModelStatus(downloadStatus.get(name), isModelReady(modelsDir, name));\n  }\n\n  // Fire-and-forget friendly: errors land in the status map, never thrown.\n  // Idempotent — a second call while a download is in flight does nothing.\n  async function ensure(name: WhisperModelName): Promise<void> {\n    if (isModelReady(modelsDir, name)) {\n      downloadStatus.set(name, { state: \"ready\" });\n      return;\n    }\n    if (downloadStatus.get(name)?.state === \"downloading\") return;\n    downloadStatus.set(name, { state: \"downloading\", progress: 0 });\n    logger.info(\"model download: start\", { model: name });\n    try {\n      await downloadModel(name, modelsDir, downloadStatus);\n      downloadStatus.set(name, { state: \"ready\" });\n      logger.info(\"model download: ok\", { model: name });\n    } catch (err) {\n      const error = errorMessage(err);\n      downloadStatus.set(name, { state: \"error\", error });\n      logger.error(\"model download: failed\", { model: name, error });\n    }\n  }\n\n  return { getStatus, ensure };\n}\n","// Pure helpers for the whisper-server sidecar. Kept separate from `sidecar.ts`\n// so the argv/response/stderr logic can be unit-tested without spawning a\n// process or opening a socket.\n\nimport { hasStringProp } from \"@mulmoclaude/common\";\n\n/** whisper-server CLI args to preload `modelPath` and bind to `host:port`. */\nexport function buildServerArgs(modelPath: string, host: string, port: number): string[] {\n  return [\"--model\", modelPath, \"--host\", host, \"--port\", String(port)];\n}\n\n/** Append `chunk` to a bounded stderr tail, keeping only the last `maxChars`. */\nexport function appendStderrTail(previous: string, chunk: string, maxChars: number): string {\n  return (previous + chunk).slice(-maxChars);\n}\n\n/** Extract the transcript from a whisper-server `/inference` JSON response.\n *  Returns \"\" for any shape that lacks a string `text` field. */\nexport function parseInferenceText(data: unknown): string {\n  return hasStringProp(data, \"text\") ? data.text : \"\";\n}\n","// whisper.cpp warm-model sidecar. Spawns `whisper-server` once with the model\n// preloaded and reuses it across transcriptions over its local HTTP API, so the\n// weights stay resident (no per-request reload). State is encapsulated per\n// instance via the factory closure.\n\nimport { spawn, type ChildProcess } from \"node:child_process\";\nimport { createServer } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { errorMessage, NOOP_LOGGER, ONE_MINUTE_MS, ONE_SECOND_MS, type WhisperLogger } from \"./internal.ts\";\nimport { modelFilePath, type WhisperModelName } from \"./models.ts\";\nimport { appendStderrTail, buildServerArgs, parseInferenceText } from \"./sidecar-helpers.ts\";\n\nconst HOST = \"127.0.0.1\";\nconst READY_TIMEOUT_MS = 60 * ONE_SECOND_MS;\nconst READY_POLL_INTERVAL_MS = 500;\nconst INFERENCE_TIMEOUT_MS = 2 * ONE_MINUTE_MS;\nconst STDERR_TAIL_MAX_CHARS = 4_000;\n\nexport interface ActiveSidecar {\n  readonly port: number;\n  readonly proc: ChildProcess;\n  readonly model: WhisperModelName;\n}\n\nexport interface Sidecar {\n  transcribeWav: (wavPath: string, language: string, model: WhisperModelName) => Promise<string>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  shutdown: () => void;\n}\n\nasync function findFreePort(): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const srv = createServer();\n    srv.on(\"error\", reject);\n    srv.listen(0, HOST, () => {\n      const addr = srv.address();\n      if (addr && typeof addr === \"object\") {\n        const { port } = addr;\n        srv.close(() => resolve(port));\n      } else {\n        srv.close(() => reject(new Error(\"could not determine a free port\")));\n      }\n    });\n  });\n}\n\n/** Resolve once the server answers any HTTP request (any status = listener up),\n *  or throw after the ready timeout. */\nasync function waitUntilReady(port: number): Promise<void> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      await fetch(`http://${HOST}:${port}/`, { signal: AbortSignal.timeout(ONE_SECOND_MS) });\n      return;\n    } catch {\n      await delay(READY_POLL_INTERVAL_MS);\n    }\n  }\n  throw new Error(\"whisper-server did not become ready in time\");\n}\n\n// whisper-server logs verbosely to stderr; left unread the OS pipe buffer fills\n// and the child blocks on its next write. Drain into a small tail buffer.\nfunction drainStderr(proc: ChildProcess, tail: { text: string }): void {\n  proc.stderr?.setEncoding(\"utf8\");\n  proc.stderr?.on(\"data\", (chunk: string) => {\n    tail.text = appendStderrTail(tail.text, chunk, STDERR_TAIL_MAX_CHARS);\n  });\n}\n\n// Resolve when the server answers, or reject on spawn failure (e.g. ENOENT) /\n// early exit. Listeners are one-shot and removed once the race settles.\nfunction waitForReadyOrFailure(proc: ChildProcess, port: number): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    let onError: (err: Error) => void = () => undefined;\n    let onExit: (code: number | null) => void = () => undefined;\n    const cleanup = () => {\n      proc.removeListener(\"error\", onError);\n      proc.removeListener(\"exit\", onExit);\n    };\n    onError = (err: Error) => {\n      cleanup();\n      reject(new Error(`spawn failed: ${errorMessage(err)}`));\n    };\n    onExit = (code: number | null) => {\n      cleanup();\n      reject(new Error(`exited early (code ${code})`));\n    };\n    proc.once(\"error\", onError);\n    proc.once(\"exit\", onExit);\n    waitUntilReady(port)\n      .then(() => {\n        cleanup();\n        resolve();\n      })\n      .catch((err: unknown) => {\n        cleanup();\n        reject(err instanceof Error ? err : new Error(String(err)));\n      });\n  });\n}\n\n// POST the wav to whisper-server's `/inference` and return the transcript.\n// Isolated from the lifecycle so the HTTP contract is unit-testable without a\n// live child (stub `fetch`, hand it a real wav path).\nexport async function postInference(port: number, wavPath: string, language: string): Promise<string> {\n  const buf = await readFile(wavPath);\n  const form = new FormData();\n  form.append(\"file\", new Blob([buf], { type: \"audio/wav\" }), \"audio.wav\");\n  form.append(\"response_format\", \"json\");\n  form.append(\"language\", language || \"auto\");\n  let res: Response;\n  try {\n    res = await fetch(`http://${HOST}:${port}/inference`, { method: \"POST\", body: form, signal: AbortSignal.timeout(INFERENCE_TIMEOUT_MS) });\n  } catch (err) {\n    throw new Error(`whisper-server request failed: ${errorMessage(err)}`);\n  }\n  if (!res.ok) throw new Error(`whisper-server returned HTTP ${res.status}`);\n  return parseInferenceText(await res.json());\n}\n\n// The impure primitives the start lifecycle depends on, injected so the\n// cancellation / single-flight / model-switch logic can be driven with fakes.\nexport interface StartLifecycleDeps {\n  /** Reserve a free TCP port for the next child — the sole async step of a start. */\n  allocatePort: () => Promise<number>;\n  /** Spawn the whisper-server child on `port`. MUST be synchronous so the spawn\n   *  and the `startingProc` handoff stay in one tick: `shutdown()` has to be able\n   *  to kill an in-flight child immediately, with no await gap after it exists. */\n  spawnServer: (model: WhisperModelName, port: number) => ChildProcess;\n  /** Resolve once the child answers HTTP, or reject on spawn failure / early exit. */\n  waitReady: (proc: ChildProcess, port: number) => Promise<void>;\n  logger: WhisperLogger;\n}\n\nexport interface StartLifecycle {\n  ensureSidecar: (model: WhisperModelName) => Promise<ActiveSidecar>;\n  shutdown: () => void;\n}\n\nexport function defaultSpawnServer(modelsDir: string, serverBinary: string, logger: WhisperLogger): StartLifecycleDeps[\"spawnServer\"] {\n  return (model: WhisperModelName, port: number): ChildProcess => {\n    const args = buildServerArgs(modelFilePath(modelsDir, model), HOST, port);\n    logger.info(\"sidecar: spawning\", { model, port });\n    return spawn(serverBinary, args, { stdio: [\"ignore\", \"ignore\", \"pipe\"] });\n  };\n}\n\n// Wires the three listeners every whisper-server child needs: stderr drain,\n// permanent `error` handler (an unhandled 'error' from ENOENT etc. would crash\n// the host), and `exit` handler that both logs and lets the caller decide\n// whether this proc is still the active one (identity check via `onExit` — a\n// stale process must not evict a newer live sidecar).\nfunction instrumentChildProcess(proc: ChildProcess, model: WhisperModelName, logger: WhisperLogger, onExit: (exited: ChildProcess) => void): { text: string } {\n  const stderrTail = { text: \"\" };\n  drainStderr(proc, stderrTail);\n  proc.on(\"error\", (err) => logger.warn(\"sidecar: process error\", { model, error: errorMessage(err) }));\n  proc.on(\"exit\", (code) => {\n    logger.warn(\"sidecar: exited\", { model, code, stderrTail: stderrTail.text.slice(-500) });\n    onExit(proc);\n  });\n  return stderrTail;\n}\n\n// Await server readiness; on failure, kill the child and surface both the\n// underlying error and the tail of stderr (whisper-server usually explains its\n// crash there). Kept at module scope so `startSidecar` stays under the\n// per-function line cap.\nasync function awaitReadyOrThrow(proc: ChildProcess, port: number, stderrTail: { text: string }, waitReady: StartLifecycleDeps[\"waitReady\"]): Promise<void> {\n  try {\n    await waitReady(proc, port);\n  } catch (err) {\n    proc.kill();\n    throw new Error(`whisper-server failed to start: ${errorMessage(err)} — stderr: ${stderrTail.text.slice(-500)}`);\n  }\n}\n\n// Abort a start that was raced by `shutdown()` (or a newer start). Compares\n// the token captured at start entry against the current token; if they differ,\n// kill the freshly-booted child rather than publish it after shutdown returned.\nfunction throwIfStartCancelled(startedToken: number, currentToken: number, proc: ChildProcess): void {\n  if (startedToken !== currentToken) {\n    proc.kill();\n    throw new Error(\"whisper-server start cancelled\");\n  }\n}\n\n// Owns the single warm child's lifecycle: which model is live, the in-flight\n// start, and the cancellation token. Kept as a factory closure so the mutable\n// state is encapsulated rather than threaded through parameters.\nexport function createStartLifecycle(deps: StartLifecycleDeps): StartLifecycle {\n  const { allocatePort, spawnServer, waitReady, logger } = deps;\n  let sidecar: ActiveSidecar | null = null;\n  let starting: { model: WhisperModelName; promise: Promise<ActiveSidecar> } | null = null;\n  // The child of an in-flight start (before it's published as `sidecar`), plus a\n  // token that `shutdown()` bumps to cancel a start that's still booting — so\n  // shutdown can't return with a child that then publishes itself afterwards.\n  let startingProc: ChildProcess | null = null;\n  let startToken = 0;\n\n  function shutdown(): void {\n    startToken += 1;\n    startingProc?.kill();\n    startingProc = null;\n    sidecar?.proc.kill();\n    sidecar = null;\n  }\n\n  async function startSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    const token = ++startToken;\n    const port = await allocatePort();\n    const proc = spawnServer(model, port);\n    startingProc = proc;\n    // onExit fires when THIS proc exits: only null out `sidecar` if it's still the live one.\n    const stderrTail = instrumentChildProcess(proc, model, logger, (exited) => sidecar?.proc === exited && (sidecar = null));\n    try {\n      await awaitReadyOrThrow(proc, port, stderrTail, waitReady);\n    } finally {\n      if (startingProc === proc) startingProc = null;\n    }\n    throwIfStartCancelled(token, startToken, proc);\n    sidecar = { port, proc, model };\n    logger.info(\"sidecar: ready\", { model, port });\n    return sidecar;\n  }\n\n  // Own function so it isn't a loop closure (no-loop-func). Only ever one start\n  // is in flight at a time, so clearing `starting` on settle is safe.\n  function beginStart(model: WhisperModelName): Promise<ActiveSidecar> {\n    const promise = startSidecar(model).finally(() => (starting = null));\n    starting = { model, promise };\n    return promise;\n  }\n\n  async function ensureSidecar(model: WhisperModelName): Promise<ActiveSidecar> {\n    // Loop so that after awaiting an in-flight start for a DIFFERENT model we\n    // re-evaluate; the decision-to-spawn path (beginStart) has no await, so the\n    // first waiter sets `starting` synchronously and siblings then reuse it.\n    for (;;) {\n      if (sidecar && sidecar.model === model && !sidecar.proc.killed) return sidecar;\n      if (starting && starting.model === model) return starting.promise;\n      if (starting) {\n        await starting.promise.catch(() => undefined);\n        continue;\n      }\n      if (sidecar && sidecar.model !== model) shutdown();\n      return beginStart(model);\n    }\n  }\n\n  return { ensureSidecar, shutdown };\n}\n\nexport function createSidecar(modelsDir: string, serverBinary = \"whisper-server\", logger: WhisperLogger = NOOP_LOGGER): Sidecar {\n  const lifecycle = createStartLifecycle({\n    allocatePort: findFreePort,\n    spawnServer: defaultSpawnServer(modelsDir, serverBinary, logger),\n    waitReady: waitForReadyOrFailure,\n    logger,\n  });\n\n  async function warmup(model: WhisperModelName): Promise<void> {\n    try {\n      await lifecycle.ensureSidecar(model);\n    } catch (err) {\n      logger.warn(\"sidecar: warmup failed\", { model, error: errorMessage(err) });\n    }\n  }\n\n  async function transcribeWav(wavPath: string, language: string, model: WhisperModelName): Promise<string> {\n    const active = await lifecycle.ensureSidecar(model);\n    return postInference(active.port, wavPath, language);\n  }\n\n  return { transcribeWav, warmup, shutdown: lifecycle.shutdown };\n}\n","// Public server-side façade: wires the model downloader, the warm sidecar, and\n// ffmpeg conversion into one host-agnostic service. The host injects the models\n// directory + a logger and gates capability itself (platform / binary presence);\n// this package assumes the binaries exist when called.\n\nimport { mkdirSync } from \"node:fs\";\nimport { rm, writeFile } from \"node:fs/promises\";\nimport { randomUUID } from \"node:crypto\";\nimport path from \"node:path\";\nimport { NOOP_LOGGER, type WhisperLogger } from \"./internal.ts\";\nimport { convertToWav16k } from \"./ffmpeg.ts\";\nimport { createModelDownloader } from \"./models.ts\";\nimport { createSidecar } from \"./sidecar.ts\";\nimport { isModelReady, type ModelStatus, type WhisperModelName } from \"./models.ts\";\n\nexport interface WhisperOptions {\n  /** Directory that holds the GGML model files (e.g. `{workspace}/models`). */\n  modelsDir: string;\n  logger?: WhisperLogger;\n  /** Defaults to \"whisper-server\" / \"ffmpeg\" on PATH. */\n  serverBinary?: string;\n  ffmpegBinary?: string;\n}\n\nexport interface TranscribeRequest {\n  base64: string;\n  mimeType: string;\n  language: string;\n  model: WhisperModelName;\n}\n\nexport interface Whisper {\n  isModelReady: (model: WhisperModelName) => boolean;\n  getModelStatus: (model: WhisperModelName) => ModelStatus;\n  /** Fire-and-forget friendly; never throws (errors land in the status). */\n  ensureModelDownloaded: (model: WhisperModelName) => Promise<void>;\n  warmup: (model: WhisperModelName) => Promise<void>;\n  transcribe: (req: TranscribeRequest) => Promise<{ text: string }>;\n  shutdown: () => void;\n}\n\n// whisper.cpp returns these sentinels for non-speech windows; treat them as\n// empty so the UI shows \"didn't catch that\" rather than a literal marker.\nconst BLANK_MARKERS = new Set([\"[blank_audio]\", \"[silence]\", \"(silence)\", \"[ inaudible ]\"]);\n\nfunction normalizeTranscript(raw: string): string {\n  const trimmed = raw.trim().replace(/\\s+/g, \" \");\n  return BLANK_MARKERS.has(trimmed.toLowerCase()) ? \"\" : trimmed;\n}\n\nexport function createWhisper(opts: WhisperOptions): Whisper {\n  const { modelsDir } = opts;\n  const logger = opts.logger ?? NOOP_LOGGER;\n  const ffmpegBinary = opts.ffmpegBinary ?? \"ffmpeg\";\n  const downloader = createModelDownloader(modelsDir, logger);\n  const sidecar = createSidecar(modelsDir, opts.serverBinary ?? \"whisper-server\", logger);\n\n  // Scratch dir for transient audio — a hidden subdir of the models dir so it\n  // shares the (non-git) models tree. Files are deleted after each transcription.\n  const scratchDir = path.join(modelsDir, \".scratch\");\n\n  async function transcribe(req: TranscribeRequest): Promise<{ text: string }> {\n    mkdirSync(scratchDir, { recursive: true });\n    const clipId = randomUUID();\n    const inputPath = path.join(scratchDir, `utterance-${clipId}.webm`);\n    const wavPath = path.join(scratchDir, `utterance-${clipId}.wav`);\n    try {\n      await writeFile(inputPath, Buffer.from(req.base64, \"base64\"));\n      await convertToWav16k(inputPath, wavPath, ffmpegBinary);\n      const text = await sidecar.transcribeWav(wavPath, req.language, req.model);\n      return { text: normalizeTranscript(text) };\n    } finally {\n      await rm(inputPath, { force: true });\n      await rm(wavPath, { force: true });\n    }\n  }\n\n  return {\n    isModelReady: (model) => isModelReady(modelsDir, model),\n    getModelStatus: (model) => downloader.getStatus(model),\n    ensureModelDownloaded: (model) => downloader.ensure(model),\n    warmup: (model) => sidecar.warmup(model),\n    transcribe,\n    shutdown: () => sidecar.shutdown(),\n  };\n}\n"],"mappings":"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"}

package/dist/wiki/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("../dist-Gj7ygaW2.cjs");
+const require_dist = require("../dist-BZ62pKuU.cjs");
 const require_graph = require("../graph-CURotEkH.cjs");
 const require_slug = require("../slug-JxgB0ru9.cjs");
 //#region src/wiki/route.ts

package/dist/wiki/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/wiki/route.ts","../../src/wiki/render.ts"],"sourcesContent":["// Pure helpers for reading, building, and validating wiki route\n// params. Kept free of Vue / vue-router imports so it can be shared\n// across hosts (MulmoClaude + MulmoTerminal) from\n// `@mulmoclaude/core/wiki`:\n//\n//  - the host router guard (synchronous validation at navigation time)\n//  - the wiki View (watcher + push helpers)\n//  - the workspace-link click handler\n//  - unit tests\n//\n// Mirrors the \"one file owns the URL ↔ domain mapping\" pattern so the\n// literals don't drift across the router definition, guards, views,\n// and tests.\n\nimport { isRecord } from \"@mulmoclaude/common\";\nimport { isSafeSlug } from \"./slug.js\";\n\n// URL segment used in `/wiki/:section/...`. Closed enum — the router\n// regex `(pages|log|lint-report)` rejects anything else.\nexport const WIKI_ROUTE_SECTION = {\n  pages: \"pages\",\n  log: \"log\",\n  lintReport: \"lint-report\",\n  graph: \"graph\",\n} as const;\n\nexport type WikiRouteSection = (typeof WIKI_ROUTE_SECTION)[keyof typeof WIKI_ROUTE_SECTION];\n\n// Internal action name sent to the server / shown in the View. Diverges\n// from the URL segment in one place only: `lint-report` (URL) vs\n// `lint_report` (action), because the server API still speaks the\n// underscore form.\nexport const WIKI_ACTION = {\n  index: \"index\",\n  page: \"page\",\n  log: \"log\",\n  lintReport: \"lint_report\",\n  graph: \"graph\",\n  save: \"save\",\n} as const;\n\nexport type WikiAction = (typeof WIKI_ACTION)[keyof typeof WIKI_ACTION];\n\n// Route-level representation. `pushWiki(target)` and\n// `readWikiRouteTarget(params)` both speak this so the watcher, the\n// button handlers, and the router guard agree on the same shape.\nexport type WikiTarget = { kind: \"index\" } | { kind: \"page\"; slug: string } | { kind: \"log\" } | { kind: \"lint_report\" } | { kind: \"graph\" };\n\n// Reject anything that could escape `data/wiki/pages/` or collide\n// with a different page. Vue Router decodes `%2F` back to `/` in\n// `route.params.slug`, so `/wiki/pages/..%2Fsecrets` lands here as\n// `slug === \"../secrets\"` — this check is the last line of defence\n// before the slug is passed to the server's page resolver. Non-\n// ASCII characters (e.g. Japanese page titles) are allowed; only\n// separators and the literal `.` / `..` are blocked.\n//\n// Delegates the actual rule to `isSafeSlug` in\n// `src/lib/wiki-page/slug.ts` (imported at the top of this file)\n// so server and frontend share one implementation (#1297). The\n// wrapper adds the type-guard / non-string-input handling the\n// router needs.\nexport function isSafeWikiSlug(value: unknown): value is string {\n  return typeof value === \"string\" && isSafeSlug(value);\n}\n\n// Read `route.params` from the wiki route and normalise to a\n// `WikiTarget`. Returns `null` when the params describe an invalid\n// state (unknown section, missing slug for a page view, unsafe slug)\n// so the caller can decide what to do — the router guard redirects to\n// `/wiki`, the view watcher treats it as \"render the index\".\nexport function readWikiRouteTarget(params: unknown): WikiTarget | null {\n  if (!isRecord(params)) return null;\n  const { section, slug } = params;\n\n  if (section === undefined || section === \"\") return { kind: \"index\" };\n\n  if (section === WIKI_ROUTE_SECTION.pages) {\n    if (!isSafeWikiSlug(slug)) return null;\n    return { kind: \"page\", slug };\n  }\n  if (section === WIKI_ROUTE_SECTION.log) return { kind: \"log\" };\n  if (section === WIKI_ROUTE_SECTION.lintReport) return { kind: \"lint_report\" };\n  if (section === WIKI_ROUTE_SECTION.graph) return { kind: \"graph\" };\n\n  return null;\n}\n\n// Inverse of `readWikiRouteTarget`: given a target, produce the\n// `{ section, slug }` params object that `router.push({ name: \"wiki\",\n// params })` needs.\n//\n// Optional route params are NOT cleared by named-route navigation\n// unless explicitly set — returning `{}` for `kind: \"index\"` would\n// leak the previous `section`/`slug` into the URL when navigating\n// from `/wiki/pages/foo` back to the index, leaving the user on\n// `/wiki/pages/foo` with the View believing it's the index. Pass\n// empty strings so the router writes out `/wiki` cleanly. The\n// readWikiRouteTarget() branch for `section === \"\"` already\n// normalises those back to `{ kind: \"index\" }`.\nexport function buildWikiRouteParams(target: WikiTarget): Record<string, string> {\n  switch (target.kind) {\n    case \"index\":\n      return { section: \"\", slug: \"\" };\n    case \"page\":\n      return { section: WIKI_ROUTE_SECTION.pages, slug: target.slug };\n    case \"log\":\n      return { section: WIKI_ROUTE_SECTION.log, slug: \"\" };\n    case \"lint_report\":\n      return { section: WIKI_ROUTE_SECTION.lintReport, slug: \"\" };\n    case \"graph\":\n      return { section: WIKI_ROUTE_SECTION.graph, slug: \"\" };\n    default: {\n      const exhaustive: never = target;\n      throw new Error(`unreachable WikiTarget kind: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n\n// Resolve a target to the action name the server expects. Centralises\n// the one place URL-shape and action-shape diverge (`lint-report` ↔\n// `lint_report`).\nexport function wikiActionFor(target: WikiTarget): WikiAction {\n  switch (target.kind) {\n    case \"index\":\n      return WIKI_ACTION.index;\n    case \"page\":\n      return WIKI_ACTION.page;\n    case \"log\":\n      return WIKI_ACTION.log;\n    case \"lint_report\":\n      return WIKI_ACTION.lintReport;\n    case \"graph\":\n      return WIKI_ACTION.graph;\n    default: {\n      const exhaustive: never = target;\n      throw new Error(`unreachable WikiTarget kind: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n","// Pure `[[wiki-link]]` → HTML renderer, shared across hosts via\n// `@mulmoclaude/core/wiki`. Extracted from the MulmoClaude host's\n// `src/plugins/wiki/helpers.ts` so MulmoTerminal can render the same\n// internal-link markup without forking the walker.\n//\n// String-only, no `marked` / DOM / Node deps — the host pipeline\n// (image-ref rewrite, marked.parse, task-interactive) wraps this.\n\nimport { escapeHtml } from \"@mulmoclaude/common\";\nimport { parseWikiLink, WIKI_LINK_MAX_LEN } from \"./link.js\";\n\n// `escapeHtml` moved down to the zero-dep leaf `@mulmoclaude/common` (#2483) so\n// `@mulmoclaude/markdown-utils` — a leaf THIS package depends on, hence unable\n// to import back up — can share it. Re-exported here because the wiki\n// consumers (collection-plugin's graph view, the host's wiki embeds and\n// spreadsheet view) already import it from `@mulmoclaude/core/wiki`.\nexport { escapeHtml };\n\n/**\n * Replace every `[[page name]]` occurrence in `content` with a\n * `<span class=\"wiki-link\" data-page=\"…\">…</span>` element. The\n * page name may not contain `[` or `]`; an opening `[[` that is\n * not followed later by `]]` (with no bare `[` or `]` in between)\n * is left untouched so malformed text renders as-is — matching the\n * previous regex's non-match behaviour.\n *\n * `[[target|display]]` is split via the shared `parseWikiLink`\n * helper so `data-page` carries only the target slug while the\n * visible text shows the display half (#1297). Both halves are\n * HTML-escaped before interpolation — `parseWikiLink` runs BEFORE\n * the host's `marked.parse`, so escaping has to happen here.\n */\nexport function renderWikiLinks(content: string): string {\n  const out: string[] = [];\n  let i = 0;\n  while (i < content.length) {\n    if (content[i] === \"[\" && content[i + 1] === \"[\") {\n      const closeStart = findNextCloseBrackets(content, i + 2);\n      if (closeStart !== -1) {\n        const inner = content.slice(i + 2, closeStart);\n        const { target, display } = parseWikiLink(inner);\n        out.push(`<span class=\"wiki-link\" data-page=\"${escapeHtml(target)}\">${escapeHtml(display)}</span>`);\n        i = closeStart + 2;\n        continue;\n      }\n    }\n    out.push(content.charAt(i));\n    i++;\n  }\n  return out.join(\"\");\n}\n\n/**\n * Starting at `from`, scan forward for a `]]` sequence. Returns\n * the index of the first `]` of that pair, or -1 if the span isn't\n * a valid wiki-link body — mirroring `WIKI_LINK_PATTERN` exactly so\n * the renderer can't accept a link the graph / backlinks / lint\n * would reject. The pattern's body class is `[^\\][\\r\\n]`, so it\n * rejects `[` as well as `]`. Bails (-1) on:\n *   - a bare `]` (regex `[^\\]]`),\n *   - a `[` inside the body (regex `[^\\[]` — a nested `[[` opener\n *     never belongs in a page name, and the pattern would not match),\n *   - a `\\r` or `\\n` (regex `[^\\r\\n]` — a newline-bearing link must\n *     not render clickable, and its slug must not reach the URL),\n *   - a body longer than WIKI_LINK_MAX_LEN (regex `{1,200}`),\n *   - a zero-length body (regex `{1,}` minimum),\n *   - reaching end-of-input with no `]]`.\n */\nfunction findNextCloseBrackets(str: string, from: number): number {\n  let j = from;\n  while (j < str.length) {\n    const char = str[j];\n    if (char === \"]\") {\n      if (str[j + 1] === \"]\" && j > from) return j;\n      // Bare `]` inside the page-name span — regex would not match.\n      return -1;\n    }\n    // A `[`, a newline, or a span past the cap: none match the pattern's\n    // `[^\\][\\r\\n]{1,200}` body, so bail and let the caller emit `[[` literally.\n    if (char === \"[\" || char === \"\\n\" || char === \"\\r\" || j - from >= WIKI_LINK_MAX_LEN) return -1;\n    j++;\n  }\n  return -1;\n}\n"],"mappings":";;;;;AAmBA,IAAa,qBAAqB;CAChC,OAAO;CACP,KAAK;CACL,YAAY;CACZ,OAAO;AACT;AAQA,IAAa,cAAc;CACzB,OAAO;CACP,MAAM;CACN,KAAK;CACL,YAAY;CACZ,OAAO;CACP,MAAM;AACR;AAsBA,SAAgB,eAAe,OAAiC;CAC9D,OAAO,OAAO,UAAU,YAAY,aAAA,WAAW,KAAK;AACtD;AAOA,SAAgB,oBAAoB,QAAoC;CACtE,IAAI,CAAC,aAAA,SAAS,MAAM,GAAG,OAAO;CAC9B,MAAM,EAAE,SAAS,SAAS;CAE1B,IAAI,YAAY,KAAA,KAAa,YAAY,IAAI,OAAO,EAAE,MAAM,QAAQ;CAEpE,IAAI,YAAY,mBAAmB,OAAO;EACxC,IAAI,CAAC,eAAe,IAAI,GAAG,OAAO;EAClC,OAAO;GAAE,MAAM;GAAQ;EAAK;CAC9B;CACA,IAAI,YAAY,mBAAmB,KAAK,OAAO,EAAE,MAAM,MAAM;CAC7D,IAAI,YAAY,mBAAmB,YAAY,OAAO,EAAE,MAAM,cAAc;CAC5E,IAAI,YAAY,mBAAmB,OAAO,OAAO,EAAE,MAAM,QAAQ;CAEjE,OAAO;AACT;AAcA,SAAgB,qBAAqB,QAA4C;CAC/E,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO;GAAE,SAAS;GAAI,MAAM;EAAG;EACjC,KAAK,QACH,OAAO;GAAE,SAAS,mBAAmB;GAAO,MAAM,OAAO;EAAK;EAChE,KAAK,OACH,OAAO;GAAE,SAAS,mBAAmB;GAAK,MAAM;EAAG;EACrD,KAAK,eACH,OAAO;GAAE,SAAS,mBAAmB;GAAY,MAAM;EAAG;EAC5D,KAAK,SACH,OAAO;GAAE,SAAS,mBAAmB;GAAO,MAAM;EAAG;EACvD,SAEE,MAAM,IAAI,MAAM,gCAAgC,KAAK,UAAU,MAAU,GAAG;CAEhF;AACF;AAKA,SAAgB,cAAc,QAAgC;CAC5D,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,QACH,OAAO,YAAY;EACrB,KAAK,OACH,OAAO,YAAY;EACrB,KAAK,eACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,SAEE,MAAM,IAAI,MAAM,gCAAgC,KAAK,UAAU,MAAU,GAAG;CAEhF;AACF;;;;;;;;;;;;;;;;;AC1GA,SAAgB,gBAAgB,SAAyB;CACvD,MAAM,MAAgB,CAAC;CACvB,IAAI,IAAI;CACR,OAAO,IAAI,QAAQ,QAAQ;EACzB,IAAI,QAAQ,OAAO,OAAO,QAAQ,IAAI,OAAO,KAAK;GAChD,MAAM,aAAa,sBAAsB,SAAS,IAAI,CAAC;GACvD,IAAI,eAAe,IAAI;IACrB,MAAM,QAAQ,QAAQ,MAAM,IAAI,GAAG,UAAU;IAC7C,MAAM,EAAE,QAAQ,YAAY,cAAA,cAAc,KAAK;IAC/C,IAAI,KAAK,sCAAsC,aAAA,WAAW,MAAM,EAAE,IAAI,aAAA,WAAW,OAAO,EAAE,QAAQ;IAClG,IAAI,aAAa;IACjB;GACF;EACF;EACA,IAAI,KAAK,QAAQ,OAAO,CAAC,CAAC;EAC1B;CACF;CACA,OAAO,IAAI,KAAK,EAAE;AACpB;;;;;;;;;;;;;;;;;AAkBA,SAAS,sBAAsB,KAAa,MAAsB;CAChE,IAAI,IAAI;CACR,OAAO,IAAI,IAAI,QAAQ;EACrB,MAAM,OAAO,IAAI;EACjB,IAAI,SAAS,KAAK;GAChB,IAAI,IAAI,IAAI,OAAO,OAAO,IAAI,MAAM,OAAO;GAE3C,OAAO;EACT;EAGA,IAAI,SAAS,OAAO,SAAS,QAAQ,SAAS,QAAQ,IAAI,QAAA,KAA2B,OAAO;EAC5F;CACF;CACA,OAAO;AACT"}
+{"version":3,"file":"index.cjs","names":["isSafeSlug","isRecord","exhaustive","parseWikiLink","escapeHtml"],"sources":["../../src/wiki/route.ts","../../src/wiki/render.ts"],"sourcesContent":["// Pure helpers for reading, building, and validating wiki route\n// params. Kept free of Vue / vue-router imports so it can be shared\n// across hosts (MulmoClaude + MulmoTerminal) from\n// `@mulmoclaude/core/wiki`:\n//\n//  - the host router guard (synchronous validation at navigation time)\n//  - the wiki View (watcher + push helpers)\n//  - the workspace-link click handler\n//  - unit tests\n//\n// Mirrors the \"one file owns the URL ↔ domain mapping\" pattern so the\n// literals don't drift across the router definition, guards, views,\n// and tests.\n\nimport { isRecord } from \"@mulmoclaude/common\";\nimport { isSafeSlug } from \"./slug.js\";\n\n// URL segment used in `/wiki/:section/...`. Closed enum — the router\n// regex `(pages|log|lint-report)` rejects anything else.\nexport const WIKI_ROUTE_SECTION = {\n  pages: \"pages\",\n  log: \"log\",\n  lintReport: \"lint-report\",\n  graph: \"graph\",\n} as const;\n\nexport type WikiRouteSection = (typeof WIKI_ROUTE_SECTION)[keyof typeof WIKI_ROUTE_SECTION];\n\n// Internal action name sent to the server / shown in the View. Diverges\n// from the URL segment in one place only: `lint-report` (URL) vs\n// `lint_report` (action), because the server API still speaks the\n// underscore form.\nexport const WIKI_ACTION = {\n  index: \"index\",\n  page: \"page\",\n  log: \"log\",\n  lintReport: \"lint_report\",\n  graph: \"graph\",\n  save: \"save\",\n} as const;\n\nexport type WikiAction = (typeof WIKI_ACTION)[keyof typeof WIKI_ACTION];\n\n// Route-level representation. `pushWiki(target)` and\n// `readWikiRouteTarget(params)` both speak this so the watcher, the\n// button handlers, and the router guard agree on the same shape.\nexport type WikiTarget = { kind: \"index\" } | { kind: \"page\"; slug: string } | { kind: \"log\" } | { kind: \"lint_report\" } | { kind: \"graph\" };\n\n// Reject anything that could escape `data/wiki/pages/` or collide\n// with a different page. Vue Router decodes `%2F` back to `/` in\n// `route.params.slug`, so `/wiki/pages/..%2Fsecrets` lands here as\n// `slug === \"../secrets\"` — this check is the last line of defence\n// before the slug is passed to the server's page resolver. Non-\n// ASCII characters (e.g. Japanese page titles) are allowed; only\n// separators and the literal `.` / `..` are blocked.\n//\n// Delegates the actual rule to `isSafeSlug` in\n// `src/lib/wiki-page/slug.ts` (imported at the top of this file)\n// so server and frontend share one implementation (#1297). The\n// wrapper adds the type-guard / non-string-input handling the\n// router needs.\nexport function isSafeWikiSlug(value: unknown): value is string {\n  return typeof value === \"string\" && isSafeSlug(value);\n}\n\n// Read `route.params` from the wiki route and normalise to a\n// `WikiTarget`. Returns `null` when the params describe an invalid\n// state (unknown section, missing slug for a page view, unsafe slug)\n// so the caller can decide what to do — the router guard redirects to\n// `/wiki`, the view watcher treats it as \"render the index\".\nexport function readWikiRouteTarget(params: unknown): WikiTarget | null {\n  if (!isRecord(params)) return null;\n  const { section, slug } = params;\n\n  if (section === undefined || section === \"\") return { kind: \"index\" };\n\n  if (section === WIKI_ROUTE_SECTION.pages) {\n    if (!isSafeWikiSlug(slug)) return null;\n    return { kind: \"page\", slug };\n  }\n  if (section === WIKI_ROUTE_SECTION.log) return { kind: \"log\" };\n  if (section === WIKI_ROUTE_SECTION.lintReport) return { kind: \"lint_report\" };\n  if (section === WIKI_ROUTE_SECTION.graph) return { kind: \"graph\" };\n\n  return null;\n}\n\n// Inverse of `readWikiRouteTarget`: given a target, produce the\n// `{ section, slug }` params object that `router.push({ name: \"wiki\",\n// params })` needs.\n//\n// Optional route params are NOT cleared by named-route navigation\n// unless explicitly set — returning `{}` for `kind: \"index\"` would\n// leak the previous `section`/`slug` into the URL when navigating\n// from `/wiki/pages/foo` back to the index, leaving the user on\n// `/wiki/pages/foo` with the View believing it's the index. Pass\n// empty strings so the router writes out `/wiki` cleanly. The\n// readWikiRouteTarget() branch for `section === \"\"` already\n// normalises those back to `{ kind: \"index\" }`.\nexport function buildWikiRouteParams(target: WikiTarget): Record<string, string> {\n  switch (target.kind) {\n    case \"index\":\n      return { section: \"\", slug: \"\" };\n    case \"page\":\n      return { section: WIKI_ROUTE_SECTION.pages, slug: target.slug };\n    case \"log\":\n      return { section: WIKI_ROUTE_SECTION.log, slug: \"\" };\n    case \"lint_report\":\n      return { section: WIKI_ROUTE_SECTION.lintReport, slug: \"\" };\n    case \"graph\":\n      return { section: WIKI_ROUTE_SECTION.graph, slug: \"\" };\n    default: {\n      const exhaustive: never = target;\n      throw new Error(`unreachable WikiTarget kind: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n\n// Resolve a target to the action name the server expects. Centralises\n// the one place URL-shape and action-shape diverge (`lint-report` ↔\n// `lint_report`).\nexport function wikiActionFor(target: WikiTarget): WikiAction {\n  switch (target.kind) {\n    case \"index\":\n      return WIKI_ACTION.index;\n    case \"page\":\n      return WIKI_ACTION.page;\n    case \"log\":\n      return WIKI_ACTION.log;\n    case \"lint_report\":\n      return WIKI_ACTION.lintReport;\n    case \"graph\":\n      return WIKI_ACTION.graph;\n    default: {\n      const exhaustive: never = target;\n      throw new Error(`unreachable WikiTarget kind: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n","// Pure `[[wiki-link]]` → HTML renderer, shared across hosts via\n// `@mulmoclaude/core/wiki`. Extracted from the MulmoClaude host's\n// `src/plugins/wiki/helpers.ts` so MulmoTerminal can render the same\n// internal-link markup without forking the walker.\n//\n// String-only, no `marked` / DOM / Node deps — the host pipeline\n// (image-ref rewrite, marked.parse, task-interactive) wraps this.\n\nimport { escapeHtml } from \"@mulmoclaude/common\";\nimport { parseWikiLink, WIKI_LINK_MAX_LEN } from \"./link.js\";\n\n// `escapeHtml` moved down to the zero-dep leaf `@mulmoclaude/common` (#2483) so\n// `@mulmoclaude/markdown-utils` — a leaf THIS package depends on, hence unable\n// to import back up — can share it. Re-exported here because the wiki\n// consumers (collection-plugin's graph view, the host's wiki embeds and\n// spreadsheet view) already import it from `@mulmoclaude/core/wiki`.\nexport { escapeHtml };\n\n/**\n * Replace every `[[page name]]` occurrence in `content` with a\n * `<span class=\"wiki-link\" data-page=\"…\">…</span>` element. The\n * page name may not contain `[` or `]`; an opening `[[` that is\n * not followed later by `]]` (with no bare `[` or `]` in between)\n * is left untouched so malformed text renders as-is — matching the\n * previous regex's non-match behaviour.\n *\n * `[[target|display]]` is split via the shared `parseWikiLink`\n * helper so `data-page` carries only the target slug while the\n * visible text shows the display half (#1297). Both halves are\n * HTML-escaped before interpolation — `parseWikiLink` runs BEFORE\n * the host's `marked.parse`, so escaping has to happen here.\n */\nexport function renderWikiLinks(content: string): string {\n  const out: string[] = [];\n  let i = 0;\n  while (i < content.length) {\n    if (content[i] === \"[\" && content[i + 1] === \"[\") {\n      const closeStart = findNextCloseBrackets(content, i + 2);\n      if (closeStart !== -1) {\n        const inner = content.slice(i + 2, closeStart);\n        const { target, display } = parseWikiLink(inner);\n        out.push(`<span class=\"wiki-link\" data-page=\"${escapeHtml(target)}\">${escapeHtml(display)}</span>`);\n        i = closeStart + 2;\n        continue;\n      }\n    }\n    out.push(content.charAt(i));\n    i++;\n  }\n  return out.join(\"\");\n}\n\n/**\n * Starting at `from`, scan forward for a `]]` sequence. Returns\n * the index of the first `]` of that pair, or -1 if the span isn't\n * a valid wiki-link body — mirroring `WIKI_LINK_PATTERN` exactly so\n * the renderer can't accept a link the graph / backlinks / lint\n * would reject. The pattern's body class is `[^\\][\\r\\n]`, so it\n * rejects `[` as well as `]`. Bails (-1) on:\n *   - a bare `]` (regex `[^\\]]`),\n *   - a `[` inside the body (regex `[^\\[]` — a nested `[[` opener\n *     never belongs in a page name, and the pattern would not match),\n *   - a `\\r` or `\\n` (regex `[^\\r\\n]` — a newline-bearing link must\n *     not render clickable, and its slug must not reach the URL),\n *   - a body longer than WIKI_LINK_MAX_LEN (regex `{1,200}`),\n *   - a zero-length body (regex `{1,}` minimum),\n *   - reaching end-of-input with no `]]`.\n */\nfunction findNextCloseBrackets(str: string, from: number): number {\n  let j = from;\n  while (j < str.length) {\n    const char = str[j];\n    if (char === \"]\") {\n      if (str[j + 1] === \"]\" && j > from) return j;\n      // Bare `]` inside the page-name span — regex would not match.\n      return -1;\n    }\n    // A `[`, a newline, or a span past the cap: none match the pattern's\n    // `[^\\][\\r\\n]{1,200}` body, so bail and let the caller emit `[[` literally.\n    if (char === \"[\" || char === \"\\n\" || char === \"\\r\" || j - from >= WIKI_LINK_MAX_LEN) return -1;\n    j++;\n  }\n  return -1;\n}\n"],"mappings":";;;;;AAmBA,IAAa,qBAAqB;CAChC,OAAO;CACP,KAAK;CACL,YAAY;CACZ,OAAO;AACT;AAQA,IAAa,cAAc;CACzB,OAAO;CACP,MAAM;CACN,KAAK;CACL,YAAY;CACZ,OAAO;CACP,MAAM;AACR;AAsBA,SAAgB,eAAe,OAAiC;CAC9D,OAAO,OAAO,UAAU,YAAYA,aAAAA,WAAW,KAAK;AACtD;AAOA,SAAgB,oBAAoB,QAAoC;CACtE,IAAI,CAACC,aAAAA,SAAS,MAAM,GAAG,OAAO;CAC9B,MAAM,EAAE,SAAS,SAAS;CAE1B,IAAI,YAAY,KAAA,KAAa,YAAY,IAAI,OAAO,EAAE,MAAM,QAAQ;CAEpE,IAAI,YAAY,mBAAmB,OAAO;EACxC,IAAI,CAAC,eAAe,IAAI,GAAG,OAAO;EAClC,OAAO;GAAE,MAAM;GAAQ;EAAK;CAC9B;CACA,IAAI,YAAY,mBAAmB,KAAK,OAAO,EAAE,MAAM,MAAM;CAC7D,IAAI,YAAY,mBAAmB,YAAY,OAAO,EAAE,MAAM,cAAc;CAC5E,IAAI,YAAY,mBAAmB,OAAO,OAAO,EAAE,MAAM,QAAQ;CAEjE,OAAO;AACT;AAcA,SAAgB,qBAAqB,QAA4C;CAC/E,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO;GAAE,SAAS;GAAI,MAAM;EAAG;EACjC,KAAK,QACH,OAAO;GAAE,SAAS,mBAAmB;GAAO,MAAM,OAAO;EAAK;EAChE,KAAK,OACH,OAAO;GAAE,SAAS,mBAAmB;GAAK,MAAM;EAAG;EACrD,KAAK,eACH,OAAO;GAAE,SAAS,mBAAmB;GAAY,MAAM;EAAG;EAC5D,KAAK,SACH,OAAO;GAAE,SAAS,mBAAmB;GAAO,MAAM;EAAG;EACvD,SAEE,MAAM,IAAI,MAAM,gCAAgC,KAAK,UAAUC,MAAU,GAAG;CAEhF;AACF;AAKA,SAAgB,cAAc,QAAgC;CAC5D,QAAQ,OAAO,MAAf;EACE,KAAK,SACH,OAAO,YAAY;EACrB,KAAK,QACH,OAAO,YAAY;EACrB,KAAK,OACH,OAAO,YAAY;EACrB,KAAK,eACH,OAAO,YAAY;EACrB,KAAK,SACH,OAAO,YAAY;EACrB,SAEE,MAAM,IAAI,MAAM,gCAAgC,KAAK,UAAUA,MAAU,GAAG;CAEhF;AACF;;;;;;;;;;;;;;;;;AC1GA,SAAgB,gBAAgB,SAAyB;CACvD,MAAM,MAAgB,CAAC;CACvB,IAAI,IAAI;CACR,OAAO,IAAI,QAAQ,QAAQ;EACzB,IAAI,QAAQ,OAAO,OAAO,QAAQ,IAAI,OAAO,KAAK;GAChD,MAAM,aAAa,sBAAsB,SAAS,IAAI,CAAC;GACvD,IAAI,eAAe,IAAI;IACrB,MAAM,QAAQ,QAAQ,MAAM,IAAI,GAAG,UAAU;IAC7C,MAAM,EAAE,QAAQ,YAAYC,cAAAA,cAAc,KAAK;IAC/C,IAAI,KAAK,sCAAsCC,aAAAA,WAAW,MAAM,EAAE,IAAIA,aAAAA,WAAW,OAAO,EAAE,QAAQ;IAClG,IAAI,aAAa;IACjB;GACF;EACF;EACA,IAAI,KAAK,QAAQ,OAAO,CAAC,CAAC;EAC1B;CACF;CACA,OAAO,IAAI,KAAK,EAAE;AACpB;;;;;;;;;;;;;;;;;AAkBA,SAAS,sBAAsB,KAAa,MAAsB;CAChE,IAAI,IAAI;CACR,OAAO,IAAI,IAAI,QAAQ;EACrB,MAAM,OAAO,IAAI;EACjB,IAAI,SAAS,KAAK;GAChB,IAAI,IAAI,IAAI,OAAO,OAAO,IAAI,MAAM,OAAO;GAE3C,OAAO;EACT;EAGA,IAAI,SAAS,OAAO,SAAS,QAAQ,SAAS,QAAQ,IAAI,QAAA,KAA2B,OAAO;EAC5F;CACF;CACA,OAAO;AACT"}

package/dist/wiki/index.js

@@ -1,4 +1,4 @@
-import { n as escapeHtml, s as isRecord } from "../dist-BzoA9pDR.js";
+import { c as isRecord, n as escapeHtml } from "../dist-MFUV9FYo.js";
 import { _ as resolveLinkTarget, a as findMissingFiles, b as parseWikiLink, c as formatLintReport, d as buildTableColumnMap, f as extractHashTags, g as matchWikiSlug, h as parseTagsCell, i as findBrokenLinksInPage, l as BULLET_LINK_PATTERN, m as parseIndexEntries, n as incomingLinks, o as findOrphanPages, p as extractSlugFromBulletHref, r as pageOutgoingSlugs, s as findTagDrift, t as buildWikiGraph, u as BULLET_WIKI_LINK_PATTERN, v as slugByIndexTitle, y as WIKI_LINK_PATTERN } from "../graph-DBxSOx3v.js";
 import { n as wikiPageStem, r as wikiSlugify, t as isSafeSlug } from "../slug-BpjumQfe.js";
 //#region src/wiki/route.ts