ai-whisper 0.5.8 → 0.5.9

package/dist/bin/companion-agent.js

@@ -5951,7 +5951,7 @@ function createLiveSessionRuntime(input) {
     input.interactiveSession.sendLocalMessage(CLEAR_LINE2);
   }
   let inputLineBuffer = "";
-  function feedLineBufferedInput(data) {
+  async function feedLineBufferedInput(data) {
     for (const char of data) {
       if (char === "") {
         if (inputLineBuffer.length > 0) {
@@ -5970,7 +5970,7 @@ function createLiveSessionRuntime(input) {
         const completed = inputLineBuffer;
         inputLineBuffer = "";
         const session = input.interactiveSession;
-        if (completed.length > 0 && session.echoUserInput) {
+        if (completed.length > 0) {
           const cols = ttyCols(input.stdout);
           const len = Array.from(completed).length;
           const plainRows = Math.max(1, Math.ceil((STRIPE_COLS + len) / cols));
@@ -5978,13 +5978,18 @@ function createLiveSessionRuntime(input) {
           if (plainRows > 1) erase += `\x1B[${plainRows - 1}A`;
           erase += "\x1B[J";
           input.stdout.write(erase);
-          session.echoUserInput(completed, cols);
+          if (await session.tryConsumeLocalCommand?.(completed)) {
+            continue;
+          }
+          if (session.echoUserInput) {
+            session.echoUserInput(completed, cols);
+          } else {
+            input.stdout.write("\n");
+          }
+          input.interactiveSession.writeUserInput(completed);
         } else {
           input.stdout.write("\n");
         }
-        if (completed.length > 0) {
-          input.interactiveSession.writeUserInput(completed);
-        }
         continue;
       }
       if (char === "\b" || char === "\x7F") {
@@ -6054,7 +6059,7 @@ function createLiveSessionRuntime(input) {
       clearRelayPreview();
       if (decision.kind === "passthrough") {
         if (input.lineBufferedInput) {
-          feedLineBufferedInput(decision.data);
+          await feedLineBufferedInput(decision.data);
         } else {
           input.interactiveSession.writeUserInput(decision.data);
         }
@@ -8596,6 +8601,360 @@ ${RED}\u258C ${event.message}${RESET2}`);
   };
 }
 
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/skills.js
+import { readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync3 } from "node:fs";
+import { join as join12 } from "node:path";
+function configBase(env) {
+  return env.xdgConfigHome && env.xdgConfigHome !== "" ? env.xdgConfigHome : join12(env.home, ".config");
+}
+function skillDirs(env) {
+  const base = configBase(env);
+  return [
+    { source: "project", path: join12(env.cwd, ".agents", "skills"), engineVisible: true },
+    {
+      source: "ai-ezio-global",
+      path: join12(base, "ai-ezio", "skills"),
+      // Engine-visible as of M4: ai-ezio sets HAX_EXTRA_SKILLS_DIR to this dir
+      // on launch, so hax injects these skills into the model prompt.
+      engineVisible: true
+    },
+    { source: "hax-global", path: join12(base, "hax", "skills"), engineVisible: true }
+  ];
+}
+function parseSkillDescription(md) {
+  const text = md.replace(/^/, "");
+  if (!/^---\r?\n/.test(text))
+    return null;
+  const end = text.indexOf("\n---", 4);
+  if (end === -1)
+    return null;
+  const front = text.slice(text.indexOf("\n") + 1, end);
+  for (const raw of front.split(/\r?\n/)) {
+    const m = raw.match(/^description:\s*(.*)$/);
+    if (m) {
+      let value = (m[1] ?? "").trim();
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      return value.length > 0 ? value : null;
+    }
+  }
+  return null;
+}
+function discoverSkills(env, fs2) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const dir of skillDirs(env)) {
+    if (!fs2.isDirectory(dir.path))
+      continue;
+    for (const name of fs2.listDirs(dir.path)) {
+      if (byName.has(name))
+        continue;
+      const skillMdPath = join12(dir.path, name, "SKILL.md");
+      const md = fs2.readFile(skillMdPath);
+      if (md === null)
+        continue;
+      byName.set(name, {
+        name,
+        description: parseSkillDescription(md),
+        skillMdPath,
+        source: dir.source,
+        engineVisible: dir.engineVisible
+      });
+    }
+  }
+  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function nodeSkillFs() {
+  return {
+    isDirectory: (path) => {
+      try {
+        return statSync3(path).isDirectory();
+      } catch {
+        return false;
+      }
+    },
+    listDirs: (path) => {
+      try {
+        return readdirSync2(path, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+      } catch {
+        return [];
+      }
+    },
+    readFile: (path) => {
+      try {
+        return readFileSync4(path, "utf8");
+      } catch {
+        return null;
+      }
+    }
+  };
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/clipboard.js
+import { spawn as spawn6 } from "node:child_process";
+function tryCopy(argv, text, spawnFn) {
+  return new Promise((resolve2, reject) => {
+    const child = spawnFn(argv[0], argv.slice(1), { stdio: ["pipe", "ignore", "ignore"] });
+    child.on("error", reject);
+    child.on("close", (code) => code === 0 ? resolve2() : reject(new Error(`${argv[0]} exited ${code}`)));
+    child.stdin?.end(text);
+  });
+}
+function makeClipboard(platform, spawnFn = spawn6) {
+  const candidates = platform === "darwin" ? [["pbcopy"]] : [["wl-copy"], ["xclip", "-selection", "clipboard"]];
+  return async (text) => {
+    let lastErr = new Error("no clipboard tool available");
+    for (const argv of candidates) {
+      try {
+        await tryCopy(argv, text, spawnFn);
+        return;
+      } catch (e) {
+        lastErr = e;
+      }
+    }
+    throw lastErr;
+  };
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/transcript-view.js
+import { join as join13 } from "node:path";
+async function showTranscript(deps) {
+  const text = deps.path ? deps.readText(deps.path) : void 0;
+  if (text === void 0 || text === "") {
+    deps.write("\x1B[2m\u2500 no transcript yet \u2500\x1B[0m\n");
+    return;
+  }
+  if (!deps.interactive) {
+    deps.write(text.endsWith("\n") ? text : `${text}
+`);
+    return;
+  }
+  deps.suspendRaw();
+  try {
+    await deps.spawnPager(deps.path);
+  } catch {
+    deps.write(text.endsWith("\n") ? text : `${text}
+`);
+  } finally {
+    deps.restoreRaw();
+  }
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/slash.js
+var NAME_RE = /^[a-zA-Z][\w-]*$/;
+function classifyLine(line, known) {
+  if (!line.startsWith("/"))
+    return { kind: "submit" };
+  if (line.includes("\n"))
+    return { kind: "submit" };
+  const body = line.slice(1);
+  const ws = body.search(/\s/);
+  const rawName = ws === -1 ? body : body.slice(0, ws);
+  const args = ws === -1 ? "" : body.slice(ws).trim();
+  if (rawName === "")
+    return { kind: "submit" };
+  if (!NAME_RE.test(rawName))
+    return { kind: "submit" };
+  const name = rawName.toLowerCase();
+  return known.has(name) ? { kind: "command", name, args } : { kind: "unknown", name };
+}
+function renderHelp(ctx, cmds) {
+  for (const c of cmds)
+    ctx.write(`  /${c.name}  ${c.summary}
+`);
+  ctx.write("\nshortcuts: Enter submit \xB7 Alt+Enter newline \xB7 paste multiline \xB7 Ctrl-C interrupt \xB7 Ctrl-D exit\n");
+}
+function formatUsage(u) {
+  if (!u)
+    return null;
+  const parts = [];
+  if (u.contextTokens !== void 0)
+    parts.push(`context ${u.contextTokens}`);
+  if (u.outputTokens !== void 0)
+    parts.push(`output ${u.outputTokens}`);
+  if (u.cachedTokens !== void 0)
+    parts.push(`cached ${u.cachedTokens}`);
+  if (u.contextLimit !== void 0)
+    parts.push(`limit ${u.contextLimit}`);
+  if (u.contextTokens !== void 0 && u.contextLimit !== void 0 && u.contextLimit > 0) {
+    parts.push(`${Math.round(u.contextTokens / u.contextLimit * 100)}%`);
+  }
+  return parts.length ? parts.join(" \xB7 ") : null;
+}
+function builtinCommands(listCommands) {
+  return [
+    {
+      name: "help",
+      summary: "list commands and keyboard shortcuts",
+      run: (ctx) => renderHelp(ctx, listCommands())
+    },
+    {
+      name: "new",
+      aliases: ["clear"],
+      summary: "start a new conversation",
+      run: async (ctx) => {
+        ctx.recorder?.noteNewConversation();
+        await ctx.session.newConversation();
+        ctx.write("\u2014 new conversation \u2014\n");
+      }
+    },
+    {
+      name: "status",
+      summary: "show provider, model, and effort",
+      run: async (ctx) => {
+        const s = await ctx.session.status();
+        const effort = s.effort ? ` \xB7 ${s.effort}` : "";
+        ctx.write(`${s.provider} \xB7 ${s.model}${effort}
+`);
+      }
+    },
+    {
+      name: "skills",
+      summary: "list discovered skills",
+      run: (ctx) => {
+        const skills = ctx.skills();
+        if (skills.length === 0) {
+          ctx.write("(no skills found)\n");
+          return;
+        }
+        for (const s of skills)
+          ctx.write(`  ${s.name} \xB7 ${s.source}
+`);
+      }
+    },
+    {
+      name: "copy",
+      summary: "copy the last response to the clipboard",
+      run: async (ctx) => {
+        const text = ctx.lastContent();
+        if (text === "") {
+          ctx.write("no response to copy\n");
+          return;
+        }
+        try {
+          await ctx.clipboard(text);
+          ctx.write(`copied ${Buffer.byteLength(text, "utf8")} bytes
+`);
+        } catch (e) {
+          ctx.write(`clipboard unavailable: ${e.message}
+`);
+        }
+      }
+    },
+    {
+      name: "usage",
+      summary: "show the last turn's token usage",
+      run: (ctx) => {
+        const formatted = formatUsage(ctx.lastUsage());
+        ctx.write(formatted ? `${formatted}
+` : "no usage yet\n");
+      }
+    },
+    {
+      name: "transcript",
+      summary: "view the model-perspective transcript (same as Ctrl+T)",
+      run: async (ctx) => {
+        if (!ctx.showTranscript) {
+          ctx.write("transcript unavailable\n");
+          return;
+        }
+        await ctx.showTranscript();
+      }
+    },
+    {
+      name: "compact",
+      summary: "summarize old history and free context",
+      run: async (ctx) => {
+        if (!ctx.compactor) {
+          ctx.write("compaction unavailable\n");
+          return;
+        }
+        const out = await ctx.compactor.compactNow();
+        if (out.kind === "skipped" && out.reason === "in-progress") {
+          ctx.write("compaction already in progress\n");
+        }
+      }
+    },
+    {
+      name: "quit",
+      aliases: ["exit"],
+      summary: "exit ezio",
+      run: () => {
+      }
+      // the controller maps /quit to the exit outcome before run()
+    }
+  ];
+}
+var SlashController = class {
+  ctx;
+  /** name OR alias → command (so classifyLine's `known` set is keys()). */
+  byKey = /* @__PURE__ */ new Map();
+  constructor(ctx, opts) {
+    this.ctx = ctx;
+    const exclude = new Set(opts?.excludeCommands ?? []);
+    for (const cmd of builtinCommands(() => this.summaries())) {
+      if (exclude.has(cmd.name))
+        continue;
+      this.register(cmd);
+    }
+  }
+  /** Register (or override) a command and its aliases. Last registration wins
+   * per key: any command that already owns this command's NAME is fully evicted
+   * (all of its keys removed) so an override replaces it cleanly; an alias key
+   * collision is resolved key-by-key (the alias now points at the new command,
+   * but the prior owner keeps its other keys). */
+  register(cmd) {
+    const displaced = this.byKey.get(cmd.name);
+    if (displaced) {
+      for (const [k, v] of this.byKey)
+        if (v === displaced)
+          this.byKey.delete(k);
+    }
+    this.byKey.set(cmd.name, cmd);
+    for (const a of cmd.aliases ?? [])
+      this.byKey.set(a, cmd);
+  }
+  /** Deduped canonical command list for /help. A command is listed only if it
+   * still OWNS its own name key — this filters out any command reachable only
+   * through a stolen alias key (e.g. another command claimed its name), so
+   * /help never shows a stale entry. */
+  summaries() {
+    const seen = /* @__PURE__ */ new Set();
+    const out = [];
+    for (const cmd of this.byKey.values()) {
+      if (seen.has(cmd))
+        continue;
+      seen.add(cmd);
+      if (this.byKey.get(cmd.name) !== cmd)
+        continue;
+      out.push({ name: cmd.name, summary: cmd.summary });
+    }
+    return out;
+  }
+  async handle(line) {
+    const c = classifyLine(line, new Set(this.byKey.keys()));
+    if (c.kind === "submit")
+      return { action: "submit", text: line };
+    if (c.kind === "unknown") {
+      this.ctx.write(`unknown command: /${c.name}. type /help for the list.
+`);
+      return { action: "handled" };
+    }
+    const cmd = this.byKey.get(c.name);
+    if (!cmd)
+      return { action: "handled" };
+    if (cmd.name === "quit")
+      return { action: "exit" };
+    try {
+      await cmd.run(this.ctx, c.args);
+    } catch (e) {
+      this.ctx.write(`/${c.name} failed: ${e.message}
+`);
+    }
+    return { action: "handled" };
+  }
+};
+
 // ../adapter-ai-ezio/dist/mid-composition-shape.js
 var DRAFTING_PREFIXES = [
   "let's draft",
@@ -8632,6 +8991,11 @@ function isMidCompositionShape(message) {
 }
 
 // ../adapter-ai-ezio/dist/create-ai-ezio-live-session.js
+import { spawn as spawn7 } from "node:child_process";
+import { randomUUID as randomUUID3 } from "node:crypto";
+import { readFileSync as readFileSync5 } from "node:fs";
+import { tmpdir } from "node:os";
+import { join as join14 } from "node:path";
 var defaultBuildAutoCompact = ({ session, host, write }) => {
   const { compaction } = loadConfig();
   return createAutoCompactDriver({
@@ -8653,6 +9017,9 @@ function createAiEzioLiveSession(input) {
   let driver = null;
   let sawTurn = false;
   let pendingContent = null;
+  let lastContent = "";
+  let lastUsage;
+  let slash = null;
   const outputHandlers = [];
   const turnFinishedHandlers = [];
   const fidelityDecisionHandlers = [];
@@ -8669,6 +9036,8 @@ function createAiEzioLiveSession(input) {
           break;
         case "assistant_turn_finished":
           sawTurn = true;
+          lastContent = event.content;
+          lastUsage = event.usage;
           if (pendingContent !== null) {
             const superseded = pendingContent;
             for (const h of fidelityDecisionHandlers)
@@ -8722,8 +9091,47 @@ function createAiEzioLiveSession(input) {
         for (const h of exitHandlers)
           h();
       });
-      await session.start();
+      const transcriptPath = join14(tmpdir(), `ezio-mounted-${randomUUID3()}.txt`);
+      await session.start({ transcriptPath });
       await host.start(session);
+      const skillEnv = {
+        cwd: process.cwd(),
+        home: process.env.HOME ?? "",
+        xdgConfigHome: process.env.XDG_CONFIG_HOME
+      };
+      const skillFs = nodeSkillFs();
+      const sessionFacet = session;
+      const slashCtx = {
+        write: (s) => input.stdout.write(s),
+        session: sessionFacet,
+        ...driver ? { compactor: { compactNow: () => driver.compactNow() } } : {},
+        lastContent: () => lastContent,
+        lastUsage: () => lastUsage,
+        skills: () => discoverSkills(skillEnv, skillFs).map((s) => ({
+          name: s.name,
+          source: s.source,
+          description: s.description
+        })),
+        clipboard: input.clipboard ?? makeClipboard(process.platform, spawn7),
+        showTranscript: () => showTranscript({
+          path: sessionFacet.transcriptPath ?? "",
+          readText: (p) => {
+            try {
+              return readFileSync5(p, "utf8");
+            } catch {
+              return void 0;
+            }
+          },
+          interactive: false,
+          spawnPager: () => Promise.resolve(),
+          suspendRaw: () => {
+          },
+          restoreRaw: () => {
+          },
+          write: (s) => input.stdout.write(s)
+        })
+      };
+      slash = new SlashController(slashCtx, { excludeCommands: ["quit"] });
     },
     async stop() {
       await host.stop();
@@ -8736,6 +9144,12 @@ function createAiEzioLiveSession(input) {
     interrupt() {
       session?.interrupt();
     },
+    async tryConsumeLocalCommand(line) {
+      if (!slash)
+        return false;
+      const outcome = await slash.handle(line);
+      return outcome.action !== "submit";
+    },
     echoUserInput(text, cols) {
       renderer.echoUserInput(text, cols);
     },

package/dist/bin/whisper.js

@@ -8047,11 +8047,25 @@ function codexNotifyArgs(input) {
   ]);
   return ["-c", `notify=${notify}`];
 }
+var RECOGNIZED_TURN_EVENTS_TOKENS = /* @__PURE__ */ new Set(["claude", "codex", "off", "none"]);
+function parseTurnEventsTokens(raw) {
+  return raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+}
 function resolveTurnEvents(flag) {
-  const source = flag ?? process.env["AI_WHISPER_TURN_EVENTS"] ?? "";
-  const set = new Set(source.split(",").map((s) => s.trim()).filter(Boolean));
+  const raw = flag ?? process.env["AI_WHISPER_TURN_EVENTS"];
+  if (raw === void 0) return { claude: true, codex: true };
+  const set = new Set(parseTurnEventsTokens(raw));
+  if (set.has("off") || set.has("none")) return { claude: false, codex: false };
   return { claude: set.has("claude"), codex: set.has("codex") };
 }
+function unrecognizedTurnEventsTokens(flag) {
+  const raw = flag ?? process.env["AI_WHISPER_TURN_EVENTS"];
+  if (raw === void 0) return [];
+  const unknown = parseTurnEventsTokens(raw).filter(
+    (t) => !RECOGNIZED_TURN_EVENTS_TOKENS.has(t)
+  );
+  return [...new Set(unknown)];
+}
 function formatTurnEventsStartupLine(e) {
   const on = (b) => b ? "ON" : "off";
   return `[ai-whisper] turn-events: claude=${on(e.claude)} codex=${on(e.codex)} (codex notify-chaining: off)`;
@@ -8605,7 +8619,7 @@ function createLiveSessionRuntime(input) {
     input.interactiveSession.sendLocalMessage(CLEAR_LINE2);
   }
   let inputLineBuffer = "";
-  function feedLineBufferedInput(data) {
+  async function feedLineBufferedInput(data) {
     for (const char of data) {
       if (char === "") {
         if (inputLineBuffer.length > 0) {
@@ -8624,7 +8638,7 @@ function createLiveSessionRuntime(input) {
         const completed = inputLineBuffer;
         inputLineBuffer = "";
         const session = input.interactiveSession;
-        if (completed.length > 0 && session.echoUserInput) {
+        if (completed.length > 0) {
           const cols = ttyCols(input.stdout);
           const len = Array.from(completed).length;
           const plainRows = Math.max(1, Math.ceil((STRIPE_COLS + len) / cols));
@@ -8632,13 +8646,18 @@ function createLiveSessionRuntime(input) {
           if (plainRows > 1) erase += `\x1B[${plainRows - 1}A`;
           erase += "\x1B[J";
           input.stdout.write(erase);
-          session.echoUserInput(completed, cols);
+          if (await session.tryConsumeLocalCommand?.(completed)) {
+            continue;
+          }
+          if (session.echoUserInput) {
+            session.echoUserInput(completed, cols);
+          } else {
+            input.stdout.write("\n");
+          }
+          input.interactiveSession.writeUserInput(completed);
         } else {
           input.stdout.write("\n");
         }
-        if (completed.length > 0) {
-          input.interactiveSession.writeUserInput(completed);
-        }
         continue;
       }
       if (char === "\b" || char === "\x7F") {
@@ -8708,7 +8727,7 @@ function createLiveSessionRuntime(input) {
       clearRelayPreview();
       if (decision.kind === "passthrough") {
         if (input.lineBufferedInput) {
-          feedLineBufferedInput(decision.data);
+          await feedLineBufferedInput(decision.data);
         } else {
           input.interactiveSession.writeUserInput(decision.data);
         }
@@ -8803,6 +8822,11 @@ function createLiveSessionRuntime(input) {
   };
 }
 
+// src/runtime/injected-input.ts
+function injectedWrite(session, value) {
+  session.writeUserInput(value);
+}
+
 // ../companion-core/dist/create-companion-runtime.js
 function createCompanionRuntime(input) {
   let sessionSecret = null;
@@ -11264,6 +11288,360 @@ ${RED}\u258C ${event.message}${RESET2}`);
   };
 }
 
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/skills.js
+import { readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync3 } from "node:fs";
+import { join as join15 } from "node:path";
+function configBase(env) {
+  return env.xdgConfigHome && env.xdgConfigHome !== "" ? env.xdgConfigHome : join15(env.home, ".config");
+}
+function skillDirs(env) {
+  const base = configBase(env);
+  return [
+    { source: "project", path: join15(env.cwd, ".agents", "skills"), engineVisible: true },
+    {
+      source: "ai-ezio-global",
+      path: join15(base, "ai-ezio", "skills"),
+      // Engine-visible as of M4: ai-ezio sets HAX_EXTRA_SKILLS_DIR to this dir
+      // on launch, so hax injects these skills into the model prompt.
+      engineVisible: true
+    },
+    { source: "hax-global", path: join15(base, "hax", "skills"), engineVisible: true }
+  ];
+}
+function parseSkillDescription(md) {
+  const text = md.replace(/^/, "");
+  if (!/^---\r?\n/.test(text))
+    return null;
+  const end = text.indexOf("\n---", 4);
+  if (end === -1)
+    return null;
+  const front = text.slice(text.indexOf("\n") + 1, end);
+  for (const raw of front.split(/\r?\n/)) {
+    const m = raw.match(/^description:\s*(.*)$/);
+    if (m) {
+      let value = (m[1] ?? "").trim();
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      return value.length > 0 ? value : null;
+    }
+  }
+  return null;
+}
+function discoverSkills(env, fs2) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const dir of skillDirs(env)) {
+    if (!fs2.isDirectory(dir.path))
+      continue;
+    for (const name of fs2.listDirs(dir.path)) {
+      if (byName.has(name))
+        continue;
+      const skillMdPath = join15(dir.path, name, "SKILL.md");
+      const md = fs2.readFile(skillMdPath);
+      if (md === null)
+        continue;
+      byName.set(name, {
+        name,
+        description: parseSkillDescription(md),
+        skillMdPath,
+        source: dir.source,
+        engineVisible: dir.engineVisible
+      });
+    }
+  }
+  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function nodeSkillFs() {
+  return {
+    isDirectory: (path4) => {
+      try {
+        return statSync3(path4).isDirectory();
+      } catch {
+        return false;
+      }
+    },
+    listDirs: (path4) => {
+      try {
+        return readdirSync3(path4, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+      } catch {
+        return [];
+      }
+    },
+    readFile: (path4) => {
+      try {
+        return readFileSync5(path4, "utf8");
+      } catch {
+        return null;
+      }
+    }
+  };
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/clipboard.js
+import { spawn as spawn7 } from "node:child_process";
+function tryCopy(argv2, text, spawnFn) {
+  return new Promise((resolve5, reject) => {
+    const child = spawnFn(argv2[0], argv2.slice(1), { stdio: ["pipe", "ignore", "ignore"] });
+    child.on("error", reject);
+    child.on("close", (code) => code === 0 ? resolve5() : reject(new Error(`${argv2[0]} exited ${code}`)));
+    child.stdin?.end(text);
+  });
+}
+function makeClipboard(platform, spawnFn = spawn7) {
+  const candidates = platform === "darwin" ? [["pbcopy"]] : [["wl-copy"], ["xclip", "-selection", "clipboard"]];
+  return async (text) => {
+    let lastErr = new Error("no clipboard tool available");
+    for (const argv2 of candidates) {
+      try {
+        await tryCopy(argv2, text, spawnFn);
+        return;
+      } catch (e) {
+        lastErr = e;
+      }
+    }
+    throw lastErr;
+  };
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/transcript-view.js
+import { join as join16 } from "node:path";
+async function showTranscript(deps) {
+  const text = deps.path ? deps.readText(deps.path) : void 0;
+  if (text === void 0 || text === "") {
+    deps.write("\x1B[2m\u2500 no transcript yet \u2500\x1B[0m\n");
+    return;
+  }
+  if (!deps.interactive) {
+    deps.write(text.endsWith("\n") ? text : `${text}
+`);
+    return;
+  }
+  deps.suspendRaw();
+  try {
+    await deps.spawnPager(deps.path);
+  } catch {
+    deps.write(text.endsWith("\n") ? text : `${text}
+`);
+  } finally {
+    deps.restoreRaw();
+  }
+}
+
+// ../../node_modules/.pnpm/@ai-ezio+surface@file+..+ai-ezio+packages+surface/node_modules/@ai-ezio/surface/dist/slash.js
+var NAME_RE = /^[a-zA-Z][\w-]*$/;
+function classifyLine(line, known) {
+  if (!line.startsWith("/"))
+    return { kind: "submit" };
+  if (line.includes("\n"))
+    return { kind: "submit" };
+  const body = line.slice(1);
+  const ws = body.search(/\s/);
+  const rawName = ws === -1 ? body : body.slice(0, ws);
+  const args = ws === -1 ? "" : body.slice(ws).trim();
+  if (rawName === "")
+    return { kind: "submit" };
+  if (!NAME_RE.test(rawName))
+    return { kind: "submit" };
+  const name = rawName.toLowerCase();
+  return known.has(name) ? { kind: "command", name, args } : { kind: "unknown", name };
+}
+function renderHelp(ctx, cmds) {
+  for (const c of cmds)
+    ctx.write(`  /${c.name}  ${c.summary}
+`);
+  ctx.write("\nshortcuts: Enter submit \xB7 Alt+Enter newline \xB7 paste multiline \xB7 Ctrl-C interrupt \xB7 Ctrl-D exit\n");
+}
+function formatUsage(u) {
+  if (!u)
+    return null;
+  const parts = [];
+  if (u.contextTokens !== void 0)
+    parts.push(`context ${u.contextTokens}`);
+  if (u.outputTokens !== void 0)
+    parts.push(`output ${u.outputTokens}`);
+  if (u.cachedTokens !== void 0)
+    parts.push(`cached ${u.cachedTokens}`);
+  if (u.contextLimit !== void 0)
+    parts.push(`limit ${u.contextLimit}`);
+  if (u.contextTokens !== void 0 && u.contextLimit !== void 0 && u.contextLimit > 0) {
+    parts.push(`${Math.round(u.contextTokens / u.contextLimit * 100)}%`);
+  }
+  return parts.length ? parts.join(" \xB7 ") : null;
+}
+function builtinCommands(listCommands) {
+  return [
+    {
+      name: "help",
+      summary: "list commands and keyboard shortcuts",
+      run: (ctx) => renderHelp(ctx, listCommands())
+    },
+    {
+      name: "new",
+      aliases: ["clear"],
+      summary: "start a new conversation",
+      run: async (ctx) => {
+        ctx.recorder?.noteNewConversation();
+        await ctx.session.newConversation();
+        ctx.write("\u2014 new conversation \u2014\n");
+      }
+    },
+    {
+      name: "status",
+      summary: "show provider, model, and effort",
+      run: async (ctx) => {
+        const s = await ctx.session.status();
+        const effort = s.effort ? ` \xB7 ${s.effort}` : "";
+        ctx.write(`${s.provider} \xB7 ${s.model}${effort}
+`);
+      }
+    },
+    {
+      name: "skills",
+      summary: "list discovered skills",
+      run: (ctx) => {
+        const skills = ctx.skills();
+        if (skills.length === 0) {
+          ctx.write("(no skills found)\n");
+          return;
+        }
+        for (const s of skills)
+          ctx.write(`  ${s.name} \xB7 ${s.source}
+`);
+      }
+    },
+    {
+      name: "copy",
+      summary: "copy the last response to the clipboard",
+      run: async (ctx) => {
+        const text = ctx.lastContent();
+        if (text === "") {
+          ctx.write("no response to copy\n");
+          return;
+        }
+        try {
+          await ctx.clipboard(text);
+          ctx.write(`copied ${Buffer.byteLength(text, "utf8")} bytes
+`);
+        } catch (e) {
+          ctx.write(`clipboard unavailable: ${e.message}
+`);
+        }
+      }
+    },
+    {
+      name: "usage",
+      summary: "show the last turn's token usage",
+      run: (ctx) => {
+        const formatted = formatUsage(ctx.lastUsage());
+        ctx.write(formatted ? `${formatted}
+` : "no usage yet\n");
+      }
+    },
+    {
+      name: "transcript",
+      summary: "view the model-perspective transcript (same as Ctrl+T)",
+      run: async (ctx) => {
+        if (!ctx.showTranscript) {
+          ctx.write("transcript unavailable\n");
+          return;
+        }
+        await ctx.showTranscript();
+      }
+    },
+    {
+      name: "compact",
+      summary: "summarize old history and free context",
+      run: async (ctx) => {
+        if (!ctx.compactor) {
+          ctx.write("compaction unavailable\n");
+          return;
+        }
+        const out = await ctx.compactor.compactNow();
+        if (out.kind === "skipped" && out.reason === "in-progress") {
+          ctx.write("compaction already in progress\n");
+        }
+      }
+    },
+    {
+      name: "quit",
+      aliases: ["exit"],
+      summary: "exit ezio",
+      run: () => {
+      }
+      // the controller maps /quit to the exit outcome before run()
+    }
+  ];
+}
+var SlashController = class {
+  ctx;
+  /** name OR alias → command (so classifyLine's `known` set is keys()). */
+  byKey = /* @__PURE__ */ new Map();
+  constructor(ctx, opts) {
+    this.ctx = ctx;
+    const exclude = new Set(opts?.excludeCommands ?? []);
+    for (const cmd of builtinCommands(() => this.summaries())) {
+      if (exclude.has(cmd.name))
+        continue;
+      this.register(cmd);
+    }
+  }
+  /** Register (or override) a command and its aliases. Last registration wins
+   * per key: any command that already owns this command's NAME is fully evicted
+   * (all of its keys removed) so an override replaces it cleanly; an alias key
+   * collision is resolved key-by-key (the alias now points at the new command,
+   * but the prior owner keeps its other keys). */
+  register(cmd) {
+    const displaced = this.byKey.get(cmd.name);
+    if (displaced) {
+      for (const [k, v] of this.byKey)
+        if (v === displaced)
+          this.byKey.delete(k);
+    }
+    this.byKey.set(cmd.name, cmd);
+    for (const a of cmd.aliases ?? [])
+      this.byKey.set(a, cmd);
+  }
+  /** Deduped canonical command list for /help. A command is listed only if it
+   * still OWNS its own name key — this filters out any command reachable only
+   * through a stolen alias key (e.g. another command claimed its name), so
+   * /help never shows a stale entry. */
+  summaries() {
+    const seen = /* @__PURE__ */ new Set();
+    const out = [];
+    for (const cmd of this.byKey.values()) {
+      if (seen.has(cmd))
+        continue;
+      seen.add(cmd);
+      if (this.byKey.get(cmd.name) !== cmd)
+        continue;
+      out.push({ name: cmd.name, summary: cmd.summary });
+    }
+    return out;
+  }
+  async handle(line) {
+    const c = classifyLine(line, new Set(this.byKey.keys()));
+    if (c.kind === "submit")
+      return { action: "submit", text: line };
+    if (c.kind === "unknown") {
+      this.ctx.write(`unknown command: /${c.name}. type /help for the list.
+`);
+      return { action: "handled" };
+    }
+    const cmd = this.byKey.get(c.name);
+    if (!cmd)
+      return { action: "handled" };
+    if (cmd.name === "quit")
+      return { action: "exit" };
+    try {
+      await cmd.run(this.ctx, c.args);
+    } catch (e) {
+      this.ctx.write(`/${c.name} failed: ${e.message}
+`);
+    }
+    return { action: "handled" };
+  }
+};
+
 // ../adapter-ai-ezio/dist/mid-composition-shape.js
 var DRAFTING_PREFIXES = [
   "let's draft",
@@ -11300,6 +11678,11 @@ function isMidCompositionShape(message) {
 }
 
 // ../adapter-ai-ezio/dist/create-ai-ezio-live-session.js
+import { spawn as spawn8 } from "node:child_process";
+import { randomUUID as randomUUID3 } from "node:crypto";
+import { readFileSync as readFileSync6 } from "node:fs";
+import { tmpdir } from "node:os";
+import { join as join17 } from "node:path";
 var defaultBuildAutoCompact = ({ session, host, write }) => {
   const { compaction } = loadConfig();
   return createAutoCompactDriver({
@@ -11321,6 +11704,9 @@ function createAiEzioLiveSession(input) {
   let driver = null;
   let sawTurn = false;
   let pendingContent = null;
+  let lastContent = "";
+  let lastUsage;
+  let slash = null;
   const outputHandlers = [];
   const turnFinishedHandlers = [];
   const fidelityDecisionHandlers = [];
@@ -11337,6 +11723,8 @@ function createAiEzioLiveSession(input) {
           break;
         case "assistant_turn_finished":
           sawTurn = true;
+          lastContent = event.content;
+          lastUsage = event.usage;
           if (pendingContent !== null) {
             const superseded = pendingContent;
             for (const h of fidelityDecisionHandlers)
@@ -11390,8 +11778,47 @@ function createAiEzioLiveSession(input) {
         for (const h of exitHandlers)
           h();
       });
-      await session.start();
+      const transcriptPath = join17(tmpdir(), `ezio-mounted-${randomUUID3()}.txt`);
+      await session.start({ transcriptPath });
       await host.start(session);
+      const skillEnv = {
+        cwd: process.cwd(),
+        home: process.env.HOME ?? "",
+        xdgConfigHome: process.env.XDG_CONFIG_HOME
+      };
+      const skillFs = nodeSkillFs();
+      const sessionFacet = session;
+      const slashCtx = {
+        write: (s) => input.stdout.write(s),
+        session: sessionFacet,
+        ...driver ? { compactor: { compactNow: () => driver.compactNow() } } : {},
+        lastContent: () => lastContent,
+        lastUsage: () => lastUsage,
+        skills: () => discoverSkills(skillEnv, skillFs).map((s) => ({
+          name: s.name,
+          source: s.source,
+          description: s.description
+        })),
+        clipboard: input.clipboard ?? makeClipboard(process.platform, spawn8),
+        showTranscript: () => showTranscript({
+          path: sessionFacet.transcriptPath ?? "",
+          readText: (p) => {
+            try {
+              return readFileSync6(p, "utf8");
+            } catch {
+              return void 0;
+            }
+          },
+          interactive: false,
+          spawnPager: () => Promise.resolve(),
+          suspendRaw: () => {
+          },
+          restoreRaw: () => {
+          },
+          write: (s) => input.stdout.write(s)
+        })
+      };
+      slash = new SlashController(slashCtx, { excludeCommands: ["quit"] });
     },
     async stop() {
       await host.stop();
@@ -11404,6 +11831,12 @@ function createAiEzioLiveSession(input) {
     interrupt() {
       session?.interrupt();
     },
+    async tryConsumeLocalCommand(line) {
+      if (!slash)
+        return false;
+      const outcome = await slash.handle(line);
+      return outcome.action !== "submit";
+    },
     echoUserInput(text, cols) {
       renderer.echoUserInput(text, cols);
     },
@@ -11586,9 +12019,9 @@ function createCliWorkItemId(now) {
 
 // src/ezio-staleness-check.ts
 import { createRequire as createRequire4 } from "node:module";
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join18 } from "node:path";
 
 // src/semver-compare.ts
 function parse(version) {
@@ -11634,10 +12067,10 @@ function compareSemver(a, b) {
 
 // src/generated/ezio-provenance.ts
 var EZIO_PROVENANCE = {
-  ezioCliVersion: "0.2.0-beta.3",
-  ezioGitSha: "4a1bdbf",
-  builtAt: "2026-06-13T13:56:01.916Z",
-  whisperVersion: "0.5.8"
+  ezioCliVersion: "0.2.0-beta.4",
+  ezioGitSha: "64f64ed",
+  builtAt: "2026-06-14T04:05:27.620Z",
+  whisperVersion: "0.5.9"
 };
 
 // src/ezio-provenance-types.ts
@@ -11661,18 +12094,18 @@ function parseCache(raw) {
   }
 }
 function cacheFile() {
-  return join15(homedir2(), ".ai-whisper", "update-check.json");
+  return join18(homedir2(), ".ai-whisper", "update-check.json");
 }
 function defaultReadCache() {
   try {
-    return parseCache(readFileSync5(cacheFile(), "utf8"));
+    return parseCache(readFileSync7(cacheFile(), "utf8"));
   } catch {
     return null;
   }
 }
 function defaultWriteCache(cache) {
   try {
-    mkdirSync6(join15(homedir2(), ".ai-whisper"), { recursive: true });
+    mkdirSync6(join18(homedir2(), ".ai-whisper"), { recursive: true });
     writeFileSync4(cacheFile(), JSON.stringify(cache), "utf8");
   } catch {
   }
@@ -11697,9 +12130,9 @@ function defaultResolveInstalledEzioVersion() {
     const require4 = createRequire4(import.meta.url);
     const paths = require4.resolve.paths("@ai-creed/ai-ezio") ?? [];
     for (const base of paths) {
-      const pkgPath = join15(base, "@ai-creed", "ai-ezio", "package.json");
+      const pkgPath = join18(base, "@ai-creed", "ai-ezio", "package.json");
       if (existsSync10(pkgPath)) {
-        const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
+        const pkg = JSON.parse(readFileSync7(pkgPath, "utf8"));
         return pkg.version ?? null;
       }
     }
@@ -13032,7 +13465,7 @@ async function captureHandbackText(input) {
 import { execFile as execFile3 } from "node:child_process";
 import { existsSync as existsSync11 } from "node:fs";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { dirname as dirname5, join as join16 } from "node:path";
+import { dirname as dirname5, join as join19 } from "node:path";
 var HELPER_BIN_NAME = "clipboard-change-count";
 function execFileText2(command, args = []) {
   return new Promise((resolve5, reject) => {
@@ -13049,7 +13482,7 @@ function makeChangeCountReader(deps) {
   const platform = deps?.platform ?? process.platform;
   const runHelper = deps?.runHelper ?? (async () => {
     const here = dirname5(fileURLToPath3(import.meta.url));
-    const bin = join16(here, "..", "native", HELPER_BIN_NAME);
+    const bin = join19(here, "..", "native", HELPER_BIN_NAME);
     if (!existsSync11(bin)) throw new Error("changeCount helper not built");
     return execFileText2(bin);
   });
@@ -13313,7 +13746,7 @@ function createMountSessionRuntime(input) {
             channel,
             data: value
           });
-          interactiveSession.writeUserInput(value);
+          injectedWrite(interactiveSession, value);
         };
         const submitInjectedInput2 = async (text) => {
           debugLog({
@@ -14094,6 +14527,12 @@ async function runCollabMount(input) {
   mkdirSync8(getStateSocketsDir(), { recursive: true });
   mkdirSync8(getStateLogsDir(), { recursive: true });
   console.error(formatTurnEventsStartupLine(enablement));
+  const unknownTurnEventsTokens = unrecognizedTurnEventsTokens(input.turnEventsFlag);
+  if (unknownTurnEventsTokens.length > 0) {
+    console.error(
+      `[ai-whisper] turn-events: ignoring unrecognized token(s) ${unknownTurnEventsTokens.map((t) => `"${t}"`).join(", ")} \u2014 expected claude, codex, off, or none`
+    );
+  }
   const tryResolve = () => {
     const db = openDatabase(getSharedSqlitePath());
     try {
@@ -15091,8 +15530,8 @@ import Database2 from "better-sqlite3";
 import { existsSync as existsSync12 } from "node:fs";
 
 // src/runtime/evaluator-config.ts
-import { readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
-import { join as join17 } from "node:path";
+import { readFileSync as readFileSync8, statSync as statSync4 } from "node:fs";
+import { join as join20 } from "node:path";
 function isEvaluatorReady(status) {
   return status === "ready" || status === "unknown";
 }
@@ -15778,7 +16217,7 @@ async function runSkillInstall(input) {
 init_dist2();
 
 // src/runtime/cli-package-info.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync9 } from "node:fs";
 import { dirname as dirname7 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 var PKG_CANDIDATES = ["../../package.json", "../package.json"];
@@ -15786,7 +16225,7 @@ function readWhisperPackage() {
   for (const rel of PKG_CANDIDATES) {
     try {
       const url = new URL(rel, import.meta.url);
-      const pkg = JSON.parse(readFileSync7(url, "utf8"));
+      const pkg = JSON.parse(readFileSync9(url, "utf8"));
       if (pkg.name === "ai-whisper" && typeof pkg.version === "string") {
         return { url, version: pkg.version };
       }
@@ -16007,7 +16446,7 @@ Not attached (stdin/stdout is not a TTY). To view the tmux session, run:
     "Args forwarded after `--` to the agent binary spawn (e.g. `mount codex -- --full-auto`)"
   ).option("--workspace <path>", "Workspace root", process.cwd()).option("--collab <id>", "Target a specific collab id (defaults to the active collab for cwd)").option(
     "--turn-events <providers>",
-    "Enable push turn-completion events for the given providers (comma-separated: claude,codex). Overrides AI_WHISPER_TURN_EVENTS. Default: off."
+    "Scope the push turn-completion event path to the given providers (comma-separated: claude,codex), or disable it with `off`/`none` to revert to pure clipboard capture. Overrides AI_WHISPER_TURN_EVENTS. Default: on (claude,codex)."
   ).action(
     async (target, passthroughArgs, opts) => {
       await runCollabMount({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-whisper",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Terminal-first relay for paired AI coding agents (Claude + Codex), driven by structured workflows.",
   "license": "Apache-2.0",
   "repository": {
@@ -51,12 +51,12 @@
     "@types/better-sqlite3": "^7.6.12",
     "@types/react": "^19.2.14",
     "ink-testing-library": "^4.0.0",
-    "@ai-whisper/adapter-codex": "0.0.0",
-    "@ai-whisper/adapter-ai-ezio": "0.0.0",
-    "@ai-whisper/shared": "0.0.0",
+    "@ai-whisper/adapter-claude": "0.0.0",
     "@ai-whisper/broker": "0.0.0",
+    "@ai-whisper/adapter-ai-ezio": "0.0.0",
     "@ai-whisper/companion-core": "0.0.0",
-    "@ai-whisper/adapter-claude": "0.0.0"
+    "@ai-whisper/adapter-codex": "0.0.0",
+    "@ai-whisper/shared": "0.0.0"
   },
   "files": [
     "dist",