omnirush 0.8.6 → 0.9.1

package/scripts/brand-engine.js

@@ -0,0 +1,526 @@
+#!/usr/bin/env node
+// Rebrand the vendored agent core (@earendil-works/pi-coding-agent) so
+// users see "omnirush", never the core's upstream name. Runs on
+// postinstall (before the bun download) and at package time
+// (scripts/build-all-packages.py); safe to re-run (idempotent).
+//
+// Mechanisms, in order of preference:
+//   1. package.json `piConfig` — the core's supported rebrand hook.
+//      `name: "omnirush"` drives APP_NAME/APP_TITLE (banner, terminal and
+//      process title, --help usage lines, auth hints, debug-log name, the
+//      OMNIRUSH_CODING_AGENT_DIR / _SESSION_DIR env vars) and disables the
+//      core's official-distribution first-run wizard. `configDir:
+//      ".omnirush"` names the project config folder (<project>/.omnirush)
+//      and every path the core prints (~/.omnirush/agent/...). The launcher
+//      always passes the agent dir explicitly (src/compat.js migrates the
+//      pre-0.9 folder).
+//   2. The core's CHANGELOG.md (shown by /changelog and the "what's new"
+//      block after an update) is replaced by ours (assets/CHANGELOG.md).
+//   3. Literal string replacements across the installed dist/**/*.js (the
+//      standalone files and the runtime bundle the launcher runs) for the
+//      display strings that do not go through APP_NAME, plus a few code
+//      shapes: the OMNIRUSH_PROJECT_CONFIG_DIR hook (legacy project
+//      folders), OMNIRUSH_* copies of the env the core exports to shell
+//      commands, AI_AGENT, the HTTP User-Agent and temp-file names.
+//
+// Not renamed (internal, never shown): package ids and imports, code
+// identifiers, session entry/customType ids, telemetry attribute keys,
+// protocol values third-party providers expect, and the PI_* env names the
+// core reads (the launcher maps OMNIRUSH_* spellings onto them).
+//
+// Maintenance: after bumping the core, run `node scripts/brand-engine.js`
+// and `node --test test/branding.test.js`; a target that moved is reported
+// as missing (fail-soft here, a failing test there) — re-derive its `from`
+// from the new dist. test/branding.test.js also scans the dist for
+// user-visible upstream-name strings.
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const PKG = "@earendil-works/pi-coding-agent";
+const BRAND = "omnirush";
+export const BRAND_CONFIG_DIR = ".omnirush";
+const OUR_CHANGELOG = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "assets", "CHANGELOG.md");
+
+// `from` must match the installed dist exactly; applied with replaceAll to
+// every dist/**/*.js. A `to` must never contain its own `from` (idempotency).
+export const REPLACEMENTS = [
+  // --- project config folder: legacy <project>/.pi fallback -------------
+  {
+    label: "project config dir hook (bundle)",
+    from: 'CONFIG_DIR_NAME=pkg.piConfig?.configDir||".pi"',
+    to: 'CONFIG_DIR_NAME=process.env.OMNIRUSH_PROJECT_CONFIG_DIR||pkg.piConfig?.configDir||".pi"',
+  },
+  {
+    label: "project config dir hook (dist)",
+    from: 'CONFIG_DIR_NAME = pkg.piConfig?.configDir || ".pi"',
+    to: 'CONFIG_DIR_NAME = process.env.OMNIRUSH_PROJECT_CONFIG_DIR || pkg.piConfig?.configDir || ".pi"',
+  },
+
+  // --- nothing goes to the core's upstream developers ---------------------
+  // /bug (report upload) and /share (session upload) send user data to the
+  // core's upstream service: hidden from the command list/autocomplete and
+  // no-ops when typed. Crash notes no longer point at /bug. Install
+  // telemetry, analytics ids, the upstream version check, the upstream
+  // model-catalog overlay and the upstream Radius gateway provider are off
+  // regardless of PI_OFFLINE / PI_TELEMETRY (the launcher also sets those).
+  {
+    label: "hide /share and /bug from the command list (bundle)",
+    from:
+      '{name:"share",description:"Share session as a secret GitHub gist"},{name:"bug",description:"Report a bug to the Pi developers",argumentHint:"<description>"},',
+    to: "",
+  },
+  {
+    label: "hide /share and /bug from the command list (dist)",
+    from:
+      '    { name: "share", description: "Share session as a secret GitHub gist" },\n    { name: "bug", description: "Report a bug to the Pi developers", argumentHint: "<description>" },\n',
+    to: "",
+  },
+  {
+    label: "/share is a no-op",
+    from: "async handleShareCommand(){",
+    to: 'async handleShareCommand(_off){return this.showWarning("/share is not available in omnirush");',
+  },
+  {
+    label: "/bug is a no-op",
+    from: "async handleBugCommand(hint){",
+    to: 'async handleBugCommand(_off){return this.showWarning("/bug is not available in omnirush");',
+  },
+  {
+    label: "no /bug hint after errors",
+    from: "suggestBugReport(){this.bugReportHintShown||",
+    to: "suggestBugReport(){return;this.bugReportHintShown||",
+  },
+  {
+    label: "startup crash note without /bug",
+    from: " Run /bug to report it; the crash details are attached automatically.",
+    to: "",
+  },
+  {
+    label: "crash exit note without /bug",
+    from: "crashReportInstructions(){return`To report this crash:",
+    to: 'crashReportInstructions(){return"The crash details were saved in the agent data folder (crashes.json).";`To report this crash:',
+  },
+  {
+    label: "install telemetry off",
+    from: "function isInstallTelemetryEnabled(settingsManager,telemetryEnv=process.env.PI_TELEMETRY){",
+    to: "function isInstallTelemetryEnabled(_s,_e){return!1;",
+  },
+  {
+    label: "install report off",
+    from: "reportInstallTelemetry(version2){",
+    to: "reportInstallTelemetry(_v){return;",
+  },
+  {
+    label: "analytics off",
+    from: "getEnableAnalytics(){return this.settings.enableAnalytics??!1}getTrackingId(){return this.settings.trackingId}",
+    to: "getEnableAnalytics(){return!1}getTrackingId(){return}",
+  },
+  {
+    label: "upstream version check off",
+    from: "async function getLatestPiRelease(currentVersion,options={}){if(process.env.PI_OFFLINE)return;",
+    to: "async function getLatestPiRelease(currentVersion,options={}){return;",
+  },
+  {
+    label: "upstream model-catalog overlay off",
+    from: "if(!await context.publish({update:()=>{dynamicModels=restored}})||!context.allowNetwork",
+    to: "if(!await context.publish({update:()=>{dynamicModels=restored}})||!0||!context.allowNetwork",
+  },
+  {
+    label: "upstream Radius gateway provider off",
+    from: 'providers=builtinProviders().map(provider=>provider.id==="radius"?provider:',
+    to: 'providers=builtinProviders().filter(provider=>provider.id!=="radius").map(provider=>provider.id==="radius"?provider:',
+  },
+
+  // --- TUI -----------------------------------------------------------------
+  {
+    label: "TUI banner onboarding line",
+    from: "Pi can explain its own features and look up its docs. Ask it how to use or extend Pi.",
+    to: "Omnirush can explain its own features and look up its docs. Ask it how to use or extend Omnirush.",
+  },
+  {
+    label: "untrusted-project warning",
+    from: "then restart pi.",
+    to: "then restart omnirush.",
+  },
+  {
+    label: "crash hint",
+    from: '"start pi and"',
+    to: '"start omnirush and"',
+  },
+  {
+    label: "tmux keys hint",
+    from: "Pi works best with csi-u.",
+    to: "Omnirush works best with csi-u.",
+  },
+  {
+    label: "/bug disclaimer",
+    from: "This report goes to the Pi developers (Earendil) and is not shared publicly. It includes your pi version,",
+    to: "This report goes to the agent core's upstream developers (Earendil) and is not shared publicly. It includes your omnirush version,",
+  },
+  {
+    label: "announcement easter egg",
+    from: '"pi has joined Earendil"',
+    to: '"The agent core has joined Earendil"',
+  },
+  {
+    label: "external editor note",
+    from: "Pi will resume when the editor exits.",
+    to: "Omnirush will resume when the editor exits.",
+  },
+  {
+    label: "first-run analytics text",
+    from: "and bugs within Pi.",
+    to: "and bugs within omnirush.",
+  },
+  {
+    label: "/share artifact title",
+    from: '"Pi session"',
+    to: '"Omnirush session"',
+  },
+
+  // --- system prompt (also what traces record) ---------------------------
+  {
+    label: "system prompt persona",
+    from: "operating inside pi, a coding agent harness",
+    to: "operating inside omnirush, a coding agent harness",
+  },
+  {
+    label: "system prompt docs section header",
+    from:
+      "Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):",
+    to: "Omnirush documentation (read only when the user asks about the agent itself, its SDK, extensions, themes, skills, or TUI):",
+  },
+  {
+    // Inside a template literal in the core: no backticks in `to`.
+    label: "system prompt docs reading rule",
+    from: "When reading pi docs or examples",
+    to:
+      "The docs use the agent core's upstream name: when answering from them, call the CLI omnirush, its data folder ~/.omnirush/agent, the project folder .omnirush/ and use the OMNIRUSH_ environment prefix\n- When reading the bundled docs or examples",
+  },
+  {
+    label: "system prompt packages doc reference",
+    from: "pi packages (docs/packages.md)",
+    to: "agent packages (docs/packages.md)",
+  },
+  {
+    label: "system prompt topics rule",
+    from: "When working on pi topics, read the docs and examples",
+    to: "When working on agent topics, read the docs and examples",
+  },
+  {
+    label: "system prompt read-fully rule",
+    from: "Always read pi .md files completely",
+    to: "Always read the agent .md files completely",
+  },
+  {
+    label: "bug report persona",
+    from: "about pi, the coding agent they are talking to",
+    to: "about omnirush, the coding agent they are talking to",
+  },
+  {
+    label: "bug report recipient",
+    from: "Write a report for the pi developers",
+    to: "Write a report for the omnirush developers",
+  },
+
+  // --- CLI help and subcommand output ------------------------------------
+  {
+    label: "--help update line",
+    from: "Update pi, extensions, or model catalogs",
+    to: "Update omnirush, extensions, or model catalogs",
+  },
+  {
+    label: "--help update alias token",
+    from: "[source|self|pi]",
+    to: "[source|self]",
+  },
+  {
+    label: "update help: summary",
+    from: "Update pi, installed packages, or model catalogs.",
+    to: "Update omnirush, installed packages, or model catalogs.",
+  },
+  {
+    label: "update help: --self",
+    from: "Update pi only (default when no target is given)",
+    to: "Update omnirush only (default when no target is given)",
+  },
+  {
+    label: "update help: --all",
+    from: "Update pi and installed packages",
+    to: "Update omnirush and installed packages",
+  },
+  {
+    label: "update help: --force",
+    from: "Reinstall pi even if the current version is latest",
+    to: "Reinstall omnirush even if the current version is latest",
+  },
+  {
+    label: "update help: short form",
+    from: "update                Update pi only",
+    to: "update                Update omnirush only",
+  },
+  {
+    label: "update help: short form --all",
+    from: "Update pi and all extensions",
+    to: "Update omnirush and all extensions",
+  },
+  {
+    label: "update help: self alias",
+    from: "update pi             Update pi only (self works as alias to pi)",
+    to: "update self           Update omnirush only (same as --self)",
+  },
+  {
+    // What the 0.8.x patcher left behind (dev checkouts that were patched before).
+    label: "update help: self alias (0.8 patch)",
+    from: "update pi             Update the agent only (self works as an alias)",
+    to: "update self           Update omnirush only (same as --self)",
+  },
+  {
+    label: "update: managed install errors",
+    from: "managed Pi ",
+    to: "managed omnirush ",
+  },
+  {
+    label: "update: managed install smoke test",
+    from: "Managed Pi smoke test",
+    to: "Managed omnirush smoke test",
+  },
+  {
+    label: "update: binary download hint",
+    from: "Download from: https://github.com/earendil-works/pi/releases/latest",
+    to: "Update with: npm install -g omnirush@latest",
+  },
+  {
+    label: "auth subcommand usage",
+    from: "\n  pi auth ",
+    to: "\n  omnirush auth ",
+  },
+  {
+    label: "--help env: package dir",
+    from: "  PI_PACKAGE_DIR                   - ",
+    to: "  OMNIRUSH_PACKAGE_DIR             - ",
+  },
+  {
+    label: "--help env: offline",
+    from: "  PI_OFFLINE                       - ",
+    to: "  OMNIRUSH_OFFLINE                 - ",
+  },
+  {
+    label: "--help env: telemetry",
+    from: "  PI_TELEMETRY                     - ",
+    to: "  OMNIRUSH_TELEMETRY               - ",
+  },
+  {
+    label: "--help env: share viewer",
+    from: "  PI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://pi.dev/session/)",
+    to: "  OMNIRUSH_SHARE_VIEWER_URL        - Base URL for /share command",
+  },
+  {
+    label: "--help --offline flag",
+    from: "(same as PI_OFFLINE=1)",
+    to: "(same as OMNIRUSH_OFFLINE=1)",
+  },
+
+  // --- environment the core sets for itself and for shell commands ------
+  {
+    label: "AI_AGENT (bundle)",
+    from: 'process.env.AI_AGENT="pi"',
+    to: 'process.env.AI_AGENT="omnirush"',
+  },
+  {
+    label: "AI_AGENT (dist)",
+    from: 'process.env.AI_AGENT = "pi"',
+    to: 'process.env.AI_AGENT = "omnirush"',
+  },
+  {
+    label: "OMNIRUSH_CODING_AGENT marker",
+    from: 'process.env.PI_CODING_AGENT="true"',
+    to: 'process.env.PI_CODING_AGENT=process.env.OMNIRUSH_CODING_AGENT="true"',
+  },
+  {
+    // Shell commands the agent runs see PI_SESSION_ID & co.; mirror each as
+    // OMNIRUSH_<NAME> (and drop a stale inherited one when the PI_ one is unset).
+    label: "OMNIRUSH_* session env for shell commands",
+    from: "ctx.thinkingLevel&&(env2.PI_REASONING_LEVEL=ctx.thinkingLevel)}let baseContext={command,cwd,env:env2}",
+    to:
+      'ctx.thinkingLevel&&(env2.PI_REASONING_LEVEL=ctx.thinkingLevel)}for(let k of["SESSION_ID","SESSION_FILE","PROVIDER","MODEL","REASONING_LEVEL"])env2["PI_"+k]===void 0?delete env2["OMNIRUSH_"+k]:env2["OMNIRUSH_"+k]=env2["PI_"+k];let baseContext={command,cwd,env:env2}',
+  },
+
+  // --- HTTP User-Agent (the omnirush gateway sees it) --------------------
+  {
+    label: "provider User-Agent",
+    from: "`pi (${nodeOs.platform()}",
+    to: "`omnirush (${nodeOs.platform()}",
+  },
+  {
+    label: "provider User-Agent (browser)",
+    from: '"pi (browser)"',
+    to: '"omnirush (browser)"',
+  },
+  {
+    label: "core User-Agent",
+    from: "`pi/${version",
+    to: "`omnirush/${version",
+  },
+
+  // --- file names users see (tool output notes, editor, zip, crash log) --
+  { label: "bash output temp file", from: '"pi-bash"', to: '"omnirush-bash"' },
+  { label: "bash executor temp file", from: "`pi-bash-${id}.log`", to: "`omnirush-bash-${id}.log`" },
+  { label: "tool output temp file", from: '"pi-output"', to: '"omnirush-output"' },
+  { label: "powershell temp file", from: '"pi-powershell"', to: '"omnirush-powershell"' },
+  { label: "external editor temp dir", from: '"pi-editor-"', to: '"omnirush-editor-"' },
+  { label: "clipboard image file", from: "`pi-clipboard-${", to: "`omnirush-clipboard-${" },
+  { label: "WSL clipboard file", from: "`pi-wsl-clip-${", to: "`omnirush-wsl-clip-${" },
+  { label: "share temp dir", from: '"pi-share-"', to: '"omnirush-share-"' },
+  { label: "bug report zip", from: "`pi-bug-report-${id}.zip`", to: "`omnirush-bug-report-${id}.zip`" },
+  { label: "TUI crash log", from: '"pi-tui-crash.log"', to: '"omnirush-tui-crash.log"' },
+  { label: "TUI debug log", from: '"pi-tui-debug.log"', to: '"omnirush-tui-debug.log"' },
+
+  // --- update banner (belt-and-braces; the launcher sets PI_OFFLINE) -----
+  // showNewVersionNotification returns before its body (the parameter is
+  // renamed so the replacement never re-matches); the standalone dist and
+  // the minified bundle spell the parameter differently.
+  {
+    label: "TUI update banner (standalone dist)",
+    from: "showNewVersionNotification(release) {",
+    to: "showNewVersionNotification(_release) { return;",
+  },
+  {
+    label: "TUI update banner (runtime bundle chunk)",
+    from: "showNewVersionNotification(release2){",
+    to: "showNewVersionNotification(_r){return;",
+  },
+  {
+    label: "upstream changelog URL",
+    from: '"https://pi.dev/changelog"',
+    to: '""',
+  },
+];
+
+function findPiRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 8; i++) {
+    const candidate = path.join(dir, "node_modules", PKG);
+    if (fs.existsSync(path.join(candidate, "package.json"))) return candidate;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+  return null;
+}
+
+function listDistFiles(root) {
+  const out = [];
+  const stack = [root];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) stack.push(full);
+      else if (entry.isFile() && entry.name.endsWith(".js")) out.push(full);
+    }
+  }
+  return out;
+}
+
+/**
+ * Apply the rebrand to the installed core. Returns a report:
+ *   { piRoot, packageJsonPatched, changelogReplaced, applied: [{label, files}], missing: [{label, reason}] }
+ */
+export function applyBrandingPatches(startDir, { version } = {}) {
+  const piRoot = findPiRoot(startDir);
+  if (!piRoot) {
+    return { piRoot: null, packageJsonPatched: false, applied: [], missing: [{ label: "core", reason: `${PKG} not installed` }] };
+  }
+
+  // 1. The supported rebrand hook (+ the product version: the banner and
+  //    --version of the core read their own package.json).
+  let packageJsonPatched = false;
+  const pkgPath = path.join(piRoot, "package.json");
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  if (pkg.piConfig?.name !== BRAND || pkg.piConfig?.configDir !== BRAND_CONFIG_DIR || (version && pkg.version !== version)) {
+    pkg.piConfig = { ...(pkg.piConfig || {}), name: BRAND, configDir: BRAND_CONFIG_DIR };
+    if (version) pkg.version = version;
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    packageJsonPatched = true;
+  }
+
+  // 2. Our release notes in place of the core's.
+  let changelogReplaced = false;
+  try {
+    const ours = fs.readFileSync(OUR_CHANGELOG, "utf8");
+    const target = path.join(piRoot, "CHANGELOG.md");
+    let current = null;
+    try {
+      current = fs.readFileSync(target, "utf8");
+    } catch {
+      /* absent */
+    }
+    if (current !== ours) {
+      fs.writeFileSync(target, ours);
+      changelogReplaced = true;
+    }
+  } catch {
+    /* no changelog shipped: the core's stays */
+  }
+
+  // 3. Literal display strings, everywhere under dist/.
+  const applied = [];
+  const missing = [];
+  const files = listDistFiles(path.join(piRoot, "dist"));
+  const contents = new Map();
+  for (const file of files) {
+    try {
+      contents.set(file, fs.readFileSync(file, "utf8"));
+    } catch {
+      /* unreadable: skipped */
+    }
+  }
+  const dirty = new Set();
+  for (const replacement of REPLACEMENTS) {
+    let hits = 0;
+    for (const [file, content] of contents) {
+      if (!content.includes(replacement.from)) continue;
+      contents.set(file, content.replaceAll(replacement.from, replacement.to));
+      dirty.add(file);
+      hits++;
+    }
+    if (hits > 0) applied.push({ label: replacement.label, files: hits });
+    else missing.push({ label: replacement.label, reason: "target string not found (already applied or core updated)" });
+  }
+  for (const file of dirty) fs.writeFileSync(file, contents.get(file));
+  return { piRoot, packageJsonPatched, changelogReplaced, applied, missing };
+}
+
+function main() {
+  const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+  let version;
+  try {
+    version = JSON.parse(fs.readFileSync(path.join(repoRoot, "package.json"), "utf8")).version;
+  } catch {
+    /* cosmetic: keep the core's own version */
+  }
+  const report = applyBrandingPatches(repoRoot, { version });
+  if (!report.piRoot) {
+    console.log("omnirush: agent core not installed; skipped branding patch");
+    return;
+  }
+  const patched = report.packageJsonPatched ? "package.json + " : "";
+  const notes = report.changelogReplaced ? " + release notes" : "";
+  console.log(
+    `omnirush: branding applied (${patched}${report.applied.length} display strings${notes})` +
+      (report.missing.length > 0 ? `; ${report.missing.length} already-applied/absent` : ""),
+  );
+}
+
+// CLI entry (postinstall). Imported as a module by tests — never exit there.
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    main();
+  } catch (error) {
+    // Fail-soft: a cosmetic patch must never break `npm install`.
+    console.warn("omnirush: branding patch skipped:", error?.message ?? error);
+  }
+}

package/scripts/build-all-packages.py

@@ -51,6 +51,33 @@ def find_bin(root, names):
 
 RELEASE_NAME = {"darwin-aarch64": "macos-arm64", "darwin-x64": "macos-x64"}
 
+# Voice mode's native recorder (@picovoice/pvrecorder-node, an optional
+# dependency: Apache-2.0, no access key). The npm package carries every
+# platform's addon; each archive keeps only its own. linux-arm64 gets the
+# Raspberry Pi aarch64 builds (the only arm64 Linux ones upstream ships);
+# elsewhere voice falls back to the system recorders.
+PVRECORDER = os.path.join("node_modules", "@picovoice", "pvrecorder-node")
+PVRECORDER_LIBS = {
+    "linux-x64": ["linux/x86_64"],
+    "linux-arm64": ["raspberry-pi/cortex-a53-aarch64", "raspberry-pi/cortex-a72-aarch64", "raspberry-pi/cortex-a76-aarch64"],
+    "darwin-aarch64": ["mac/arm64"],
+    "darwin-x64": ["mac/x86_64"],
+    "windows-x64": ["windows/amd64"],
+}
+
+
+def vendor_pvrecorder(plat, stage):
+    src = os.path.join(REPO, PVRECORDER)
+    if not os.path.isdir(src):
+        raise SystemExit(f"missing voice recorder: {src} (run npm install first)")
+    dest = os.path.join(stage, PVRECORDER)
+    shutil.copytree(src, dest, ignore=shutil.ignore_patterns("lib", "src", "test", "*.map"))
+    for sub in PVRECORDER_LIBS[plat]:
+        lib = os.path.join(src, "lib", sub)
+        if not os.path.isdir(lib):
+            raise SystemExit(f"voice recorder has no {sub} build")
+        shutil.copytree(lib, os.path.join(dest, "lib", sub))
+
 for plat, cfg in PLATFORMS.items():
     if ONLY and plat not in ONLY:
         continue
@@ -80,11 +107,12 @@ for plat, cfg in PLATFORMS.items():
     if not os.path.isdir(nm_src):
         raise SystemExit(f"missing vendored agent runtime: {nm_src} (run npm install first)")
     shutil.copytree(nm_src, os.path.join(stage, "node_modules", "@earendil-works"), symlinks=True)
+    vendor_pvrecorder(plat, stage)
     shutil.copytree(os.path.join(REPO, "scripts"), os.path.join(stage, "scripts"))
     import subprocess
 
     subprocess.run(
-        ["node", os.path.join(stage, "scripts", "patch-pi-branding.js")],
+        ["node", os.path.join(stage, "scripts", "brand-engine.js")],
         cwd=stage, check=True,
     )
     exe = "bun.exe" if plat == "windows-x64" else "bun"

package/scripts/smoke-packages.py

@@ -27,14 +27,38 @@ REQUIRED_PATHS = [
     "package.json",
     "src/bin.js",
     "src/lib.js",
+    "src/compat.js",
+    "src/sessions.js",
     "scripts/postinstall.js",
-    "scripts/patch-pi-branding.js",
+    "scripts/brand-engine.js",
     "assets/extensions/omnirush/index.ts",
+    "assets/CHANGELOG.md",
     "node_modules/@earendil-works/pi-coding-agent/package.json",
     "node_modules/@earendil-works/pi-coding-agent/dist",
     ".runtime/bin/bun",
 ]
 
+# Voice mode's native recorder, one addon per archive (build-all-packages.py).
+PVRECORDER_ADDON = {
+    "omnirush-cli-linux-x64.tar.gz": "linux/x86_64",
+    "omnirush-cli-linux-arm64.tar.gz": "raspberry-pi/cortex-a72-aarch64",
+    "omnirush-cli-macos-arm64.zip": "mac/arm64",
+    "omnirush-cli-macos-x64.zip": "mac/x86_64",
+    "omnirush-cli-windows-x64.zip": "windows/amd64",
+}
+
+
+def check_pvrecorder(name, names, root):
+    base = "node_modules/@picovoice/pvrecorder-node"
+    for required in (f"{base}/package.json", f"{base}/dist/index.js", f"{base}/lib/{PVRECORDER_ADDON[name]}/pv_recorder.node",
+                     "assets/extensions/omnirush/voice.ts", "assets/extensions/omnirush/voice/pvrecorder-worker.cjs"):
+        if not has_entry(names, root, required):
+            fail(f"{name} lacks {required}")
+    others = {n for n in names if f"{base}/lib/" in n and n.endswith(".node") and PVRECORDER_ADDON[name] not in n
+              and not (name.endswith("linux-arm64.tar.gz") and "aarch64" in n)}
+    if others:
+        fail(f"{name} carries other platforms' recorder addons: {sorted(others)[:3]}")
+
 
 def fail(message):
     print(f"SMOKE FAIL: {message}")
@@ -86,6 +110,7 @@ def main():
         for required in REQUIRED_PATHS:
             if not has_entry(names, root, required):
                 fail(f"linux-x64 archive lacks {required}")
+        check_pvrecorder("omnirush-cli-linux-x64.tar.gz", names, root)
         with tarfile.open(tgz, "r:gz") as t:
             t.extractall(work)
         extracted = os.path.join(work, root)
@@ -106,6 +131,12 @@ def main():
         if repo_version and repo_version not in out:
             fail(f"--version {out!r} does not carry the repo version {repo_version}")
         print(f"ok (run): linux-x64 bin.js --version -> {out}")
+        core_pkg = json.load(open(os.path.join(
+            extracted, "node_modules", "@earendil-works", "pi-coding-agent", "package.json")))
+        if core_pkg.get("piConfig", {}).get("name") != "omnirush" or \
+                core_pkg.get("piConfig", {}).get("configDir") != ".omnirush":
+            fail(f"vendored agent core is not branded: piConfig={core_pkg.get('piConfig')!r}")
+        print("ok (branding): vendored agent core carries the omnirush name and folders")
 
         # Remaining archives: structural smoke only (cross-packaged OSes).
         for name in sorted(EXPECTED):
@@ -117,6 +148,7 @@ def main():
             for required in REQUIRED_PATHS[:len(REQUIRED_PATHS) - 1] + [bun_name]:
                 if not has_entry(names, root, required):
                     fail(f"{name} lacks {required}")
+            check_pvrecorder(name, names, root)
             print(f"ok (structure): {name}")
     finally:
         shutil.rmtree(work, ignore_errors=True)