very-happy-cli 0.2.115 → 0.2.117

package/dist/{types-CpnzfHHS.cjs → types-DD3AK6Nb.cjs}

@@ -51,7 +51,7 @@ var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 var pty__namespace = /*#__PURE__*/_interopNamespaceDefault(pty);
 
 var name = "very-happy-cli";
-var version = "0.2.115";
+var version = "0.2.117";
 var description = "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.";
 var author = "Kirill Dubovitskiy";
 var contributors = [
@@ -164,12 +164,12 @@ var dependencies = {
 	zod: "^4.0.0"
 };
 var optionalDependencies = {
-	"very-happy-tools-arm64-darwin": "0.2.115",
-	"very-happy-tools-x64-darwin": "0.2.115",
-	"very-happy-tools-arm64-linux": "0.2.115",
-	"very-happy-tools-x64-linux": "0.2.115",
-	"very-happy-tools-arm64-win32": "0.2.115",
-	"very-happy-tools-x64-win32": "0.2.115"
+	"very-happy-tools-arm64-darwin": "0.2.117",
+	"very-happy-tools-x64-darwin": "0.2.117",
+	"very-happy-tools-arm64-linux": "0.2.117",
+	"very-happy-tools-x64-linux": "0.2.117",
+	"very-happy-tools-arm64-win32": "0.2.117",
+	"very-happy-tools-x64-win32": "0.2.117"
 };
 var devDependencies = {
 	"@slopus/happy-wire": "workspace:*",
@@ -1039,6 +1039,8 @@ z.z.object({
     codex: z.z.boolean(),
     gemini: z.z.boolean(),
     openclaw: z.z.boolean(),
+    pi: z.z.boolean().optional(),
+    // absent on daemons that predate the pi runner
     detectedAt: z.z.number()
   }).optional(),
   resumeSupport: z.z.object({
@@ -1076,7 +1078,14 @@ const CliUpdateStateSchema = z.z.object({
    * serving the old code. Present only while that is true. Optional and additive:
    * old web builds ignore it, old daemons never send it (iron rule 4).
    */
-  handoverHold: z.z.object({ reason: z.z.string(), at: z.z.number() }).nullable().optional()
+  handoverHold: z.z.object({ reason: z.z.string(), at: z.z.number() }).nullable().optional(),
+  /** B-327: the last thing the machine's auto-update did, or why it did nothing. */
+  autoUpdate: z.z.object({
+    state: z.z.union([z.z.enum(["installing", "installed", "failed", "skipped"]), z.z.string()]),
+    version: z.z.string().nullable(),
+    detail: z.z.string().optional(),
+    at: z.z.number()
+  }).nullable().optional()
 });
 const WebTerminalListItemSchema = z.z.object({
   id: z.z.string(),
@@ -1673,7 +1682,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-CpnzfHHS.cjs', document.baseURI).href))));
+const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-DD3AK6Nb.cjs', document.baseURI).href))));
 function projectPath() {
   const path = path$1.resolve(__dirname$1, "..");
   return path;
@@ -9856,6 +9865,49 @@ class SnapshotStore {
   }
 }
 
+const OUTPUT_COALESCE_MS = 16;
+const OUTPUT_COALESCE_MAX_BYTES = 64 * 1024;
+function createOutputCoalescer({ maxDelayMs, maxBytes } = {
+  maxDelayMs: OUTPUT_COALESCE_MS,
+  maxBytes: OUTPUT_COALESCE_MAX_BYTES
+}) {
+  let buffered = [];
+  let bufferedBytes = 0;
+  let firstBufferedAt = 0;
+  let lastEmitAt = Number.NEGATIVE_INFINITY;
+  const drain = (now) => {
+    if (bufferedBytes === 0) return null;
+    const out = buffered.length === 1 ? buffered[0] : Buffer.concat(buffered, bufferedBytes);
+    buffered = [];
+    bufferedBytes = 0;
+    firstBufferedAt = 0;
+    lastEmitAt = now;
+    return out;
+  };
+  return {
+    push(data, now) {
+      if (data.length === 0) return null;
+      if (bufferedBytes === 0 && now - lastEmitAt >= maxDelayMs) {
+        lastEmitAt = now;
+        return data;
+      }
+      if (bufferedBytes === 0) firstBufferedAt = now;
+      buffered.push(data);
+      bufferedBytes += data.length;
+      return bufferedBytes >= maxBytes ? drain(now) : null;
+    },
+    flush(now) {
+      return drain(now);
+    },
+    dueAt() {
+      return bufferedBytes === 0 ? null : firstBufferedAt + maxDelayMs;
+    },
+    pendingBytes() {
+      return bufferedBytes;
+    }
+  };
+}
+
 const MAX_SEND_KEYS_PAYLOAD_BYTES = 1e3;
 function tmuxSingleQuote(text) {
   return `'${text.split("'").join("'\\''")}'`;
@@ -10766,6 +10818,18 @@ class TerminalSession {
   lastOutputAt;
   cols;
   rows;
+  /**
+   * B-334: `%output` arrives as one message per producer write — pi's startup
+   * frame measured 1029 chunks of a median 9 bytes. Merging them before they
+   * are given a seq is what keeps the wire (and the web's write chain) from
+   * carrying a thousand frames for 12 KB. See outputCoalescer.ts.
+   */
+  coalescer = createOutputCoalescer();
+  flushTimer = null;
+  /** Set by the manager right after construction: how a merged chunk reaches
+   *  the subscribers. Left undefined ⇒ the session buffers and drops nothing,
+   *  it just has nobody to tell. */
+  onOutputChunk;
   constructor(id, transport, tmuxSession, cols, rows) {
     this.id = id;
     this.transport = transport;
@@ -10812,6 +10876,61 @@ class TerminalSession {
     }
     return chunk;
   }
+  /**
+   * The live-output entry point (B-334). Every `%output` / pty chunk goes
+   * through here instead of straight to `ingest`: the coalescer decides
+   * whether this byte run is emitted now (the common interactive case — an
+   * echo after an idle window pays zero extra latency) or merged into the
+   * frame currently forming. Merging is byte-exact concatenation, so one seq
+   * covering the merged run is indistinguishable from tmux having handed us
+   * one bigger read — the ring/replay/gap protocol is untouched.
+   */
+  pushOutput(data) {
+    const ready = this.coalescer.push(data, Date.now());
+    if (ready) {
+      this.clearFlushTimer();
+      this.emitOutput(ready);
+    }
+    this.armFlushTimer();
+  }
+  /**
+   * Emit whatever is buffered right now. MUST be called before anything that
+   * reads or changes the screen's identity, because buffered bytes have not
+   * been ingested yet and therefore own no seq:
+   *  - the capture anchor (`runCaptureBatch`) — pre-anchor output is already
+   *    inside the capture, so it has to own a seq <= `seqAtAnchor` or the
+   *    client applies it a second time on top of the restore;
+   *  - `resizeHeadless` — those bytes were produced at the OLD size;
+   *  - transport exit — otherwise the last frame before a shell dies is lost.
+   */
+  flushOutput() {
+    this.clearFlushTimer();
+    const ready = this.coalescer.flush(Date.now());
+    if (ready) this.emitOutput(ready);
+  }
+  emitOutput(data) {
+    const chunk = this.ingest(data);
+    this.onOutputChunk?.(chunk);
+  }
+  armFlushTimer() {
+    const due = this.coalescer.dueAt();
+    if (due === null) {
+      this.clearFlushTimer();
+      return;
+    }
+    if (this.flushTimer) return;
+    const timer = setTimeout(() => {
+      this.flushTimer = null;
+      this.flushOutput();
+    }, Math.max(0, due - Date.now()));
+    timer.unref?.();
+    this.flushTimer = timer;
+  }
+  clearFlushTimer() {
+    if (!this.flushTimer) return;
+    clearTimeout(this.flushTimer);
+    this.flushTimer = null;
+  }
   /**
    * Write a RESTORE payload (the open capture) into the authoritative screen
    * WITHOUT giving it a seq: it is not a live chunk, so it must not enter the
@@ -10831,6 +10950,7 @@ class TerminalSession {
   /** Keep the authoritative screen's dimensions in lockstep with the terminal
    *  so a later snapshot serialize() reflects the real geometry. */
   resizeHeadless(cols, rows) {
+    this.flushOutput();
     this.cols = cols;
     this.rows = rows;
     try {
@@ -10910,6 +11030,7 @@ class TerminalSession {
       } catch {
       }
     }
+    this.clearFlushTimer();
     try {
       this.headless.dispose();
     } catch {
@@ -11761,14 +11882,16 @@ class WebTerminalManager {
         client: void 0
         // replaced below
       }, tmuxSession, cols, rows);
+      created.onOutputChunk = (chunk) => {
+        this.emit("terminal-output", { terminalId: id, data: chunk.data, seq: chunk.seq });
+        this.noteActivity();
+      };
       const client = new ControlClient(tmuxSession, env, {
         onOutput: (pane, data) => {
           if (this.terminals.get(id) !== created) return;
           if (!created.ingesting) return;
           if (created.paneId && pane !== created.paneId) return;
-          const chunk = created.ingest(data);
-          this.emit("terminal-output", { terminalId: id, data: chunk.data, seq: chunk.seq });
-          this.noteActivity();
+          created.pushOutput(data);
         },
         onNotification: (name, args2) => {
           if (this.terminals.get(id) !== created) return;
@@ -11790,6 +11913,7 @@ class WebTerminalManager {
         },
         onExit: (code) => {
           if (this.terminals.get(id) !== created) return;
+          created.flushOutput();
           this.terminals.delete(id);
           this.snapshots.drop(id);
           created.dispose();
@@ -11810,14 +11934,17 @@ class WebTerminalManager {
         }
       }
       const created = new TerminalSession(id, { kind: "pty", pty: proc }, void 0, cols, rows);
-      proc.onData((data) => {
-        if (this.terminals.get(id) !== created) return;
-        const chunk = created.ingest(Buffer.from(data, "utf8"));
+      created.onOutputChunk = (chunk) => {
         this.emit("terminal-output", { terminalId: id, data: chunk.data, seq: chunk.seq });
         this.noteActivity();
+      };
+      proc.onData((data) => {
+        if (this.terminals.get(id) !== created) return;
+        created.pushOutput(Buffer.from(data, "utf8"));
       });
       proc.onExit(({ exitCode }) => {
         if (this.terminals.get(id) !== created) return;
+        created.flushOutput();
         this.terminals.delete(id);
         this.snapshots.drop(id);
         created.dispose();
@@ -11961,6 +12088,7 @@ class WebTerminalManager {
       command: c.command,
       label: c.key,
       onBlock: c.key === "anchor" ? () => {
+        session.flushOutput();
         seqAtAnchor = session.seq;
         if (fresh) session.ingesting = true;
       } : void 0
@@ -12627,6 +12755,19 @@ function commandExists(command) {
     return false;
   }
 }
+function commandExistsWindows(name) {
+  try {
+    child_process.execSync(`powershell -NoProfile -Command "Get-Command ${name} -ErrorAction SilentlyContinue"`, { stdio: "ignore", windowsHide: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+const SAFE_COMMAND_NAME = /^[A-Za-z0-9._-]+$/;
+function commandOnPath(name) {
+  if (!SAFE_COMMAND_NAME.test(name)) return false;
+  return os$1.platform() === "win32" ? commandExistsWindows(name) : commandExists(name);
+}
 function detectPosix() {
   const claude = commandExists("claude");
   const codex = commandExists("codex");
@@ -12635,17 +12776,11 @@ function detectPosix() {
   const openclawConfig = fs$1.existsSync(path$1.join(os$1.homedir(), ".openclaw", "openclaw.json"));
   const openclawEnv = !!process.env.OPENCLAW_GATEWAY_URL;
   const openclaw = openclawCommand || openclawConfig || openclawEnv;
-  return { claude, codex, gemini, openclaw, detectedAt: Date.now() };
+  const pi = commandExists("pi") && commandExists("pi-acp");
+  return { claude, codex, gemini, openclaw, pi, detectedAt: Date.now() };
 }
 function detectWindows() {
-  const checkCommand = (name) => {
-    try {
-      child_process.execSync(`powershell -NoProfile -Command "Get-Command ${name} -ErrorAction SilentlyContinue"`, { stdio: "ignore", windowsHide: true });
-      return true;
-    } catch {
-      return false;
-    }
-  };
+  const checkCommand = commandExistsWindows;
   const claude = checkCommand("claude");
   const codex = checkCommand("codex");
   const gemini = checkCommand("gemini");
@@ -12653,7 +12788,8 @@ function detectWindows() {
   const openclawConfig = fs$1.existsSync(path$1.join(process.env.USERPROFILE || os$1.homedir(), ".openclaw", "openclaw.json"));
   const openclawEnv = !!process.env.OPENCLAW_GATEWAY_URL;
   const openclaw = openclawCommand || openclawConfig || openclawEnv;
-  return { claude, codex, gemini, openclaw, detectedAt: Date.now() };
+  const pi = checkCommand("pi") && checkCommand("pi-acp");
+  return { claude, codex, gemini, openclaw, pi, detectedAt: Date.now() };
 }
 
 const AgentCredentialsSchema = z.z.object({
@@ -14431,6 +14567,15 @@ class ApiMachineClient {
   // recover account material or impersonate a Web client. (Declared before
   // webTerminal so the emit closure can read it.)
   encTerminals = /* @__PURE__ */ new Set();
+  /** B-327: an auto-update swaps the process that owns these terminals, so it
+   *  waits until there are none. */
+  hasLiveTerminals() {
+    try {
+      return this.webTerminal.buildTerminalList().length > 0;
+    } catch {
+      return true;
+    }
+  }
   webTerminal = new WebTerminalManager((event, payload) => {
     let out = payload;
     if (event === "terminal-output" && this.encTerminals.has(payload.terminalId)) {
@@ -14453,6 +14598,22 @@ class ApiMachineClient {
       event: n.event
     });
   });
+  /**
+   * The CLI availability last advertised in machine metadata (re-probed by
+   * the keep-alive). Null until the first keep-alive tick; the daemon falls
+   * back to its startup probe then.
+   */
+  getCLIAvailability() {
+    return this.lastKnownCLIAvailability;
+  }
+  /**
+   * Title a web terminal from inside it (`very-happy mcp` change_title →
+   * daemon /terminal-title → here). Same tmux truthfulness as the
+   * `set-terminal-title` RPC.
+   */
+  setTerminalTitle(terminalId, title, ifAbsent) {
+    return this.webTerminal.setTitle(terminalId, title, ifAbsent);
+  }
   /**
    * Push text to the clipboard of every web client the user has open
    * (terminal-path claude → `very-happy mcp` → daemon /clipboard → here).
@@ -15261,7 +15422,7 @@ class ApiMachineClient {
       const prev = this.lastKnownCLIAvailability;
       const newResumeSupport = detectResumeSupport();
       const prevResume = this.lastKnownResumeSupport;
-      const cliAvailabilityChanged = !prev || prev.claude !== newAvailability.claude || prev.codex !== newAvailability.codex || prev.gemini !== newAvailability.gemini || prev.openclaw !== newAvailability.openclaw;
+      const cliAvailabilityChanged = !prev || prev.claude !== newAvailability.claude || prev.codex !== newAvailability.codex || prev.gemini !== newAvailability.gemini || prev.openclaw !== newAvailability.openclaw || prev.pi !== newAvailability.pi;
       const resumeSupportChanged = !prevResume || prevResume.rpcAvailable !== newResumeSupport.rpcAvailable || prevResume.happyAgentAuthenticated !== newResumeSupport.happyAgentAuthenticated;
       if (cliAvailabilityChanged || resumeSupportChanged) {
         this.lastKnownCLIAvailability = newAvailability;
@@ -16502,6 +16663,8 @@ exports.api = api;
 exports.clearCredentials = clearCredentials;
 exports.clearDaemonState = clearDaemonState;
 exports.clearMachineId = clearMachineId;
+exports.commandOnPath = commandOnPath;
+exports.compareExactVersions = compareExactVersions;
 exports.configuration = configuration;
 exports.connectionState = connectionState;
 exports.contentLogMetadata = contentLogMetadata;