very-happy-cli 0.2.115 → 0.2.117

package/dist/{types-B3qx8Ga1.mjs → types-jSfU_0o1.mjs}

@@ -29,7 +29,7 @@ import { SandboxManager } from '@anthropic-ai/sandbox-runtime';
 import { Expo } from 'expo-server-sdk';
 
 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 = [
@@ -142,12 +142,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:*",
@@ -1017,6 +1017,8 @@ z$1.object({
     codex: z$1.boolean(),
     gemini: z$1.boolean(),
     openclaw: z$1.boolean(),
+    pi: z$1.boolean().optional(),
+    // absent on daemons that predate the pi runner
     detectedAt: z$1.number()
   }).optional(),
   resumeSupport: z$1.object({
@@ -1054,7 +1056,14 @@ const CliUpdateStateSchema = z$1.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$1.object({ reason: z$1.string(), at: z$1.number() }).nullable().optional()
+  handoverHold: z$1.object({ reason: z$1.string(), at: z$1.number() }).nullable().optional(),
+  /** B-327: the last thing the machine's auto-update did, or why it did nothing. */
+  autoUpdate: z$1.object({
+    state: z$1.union([z$1.enum(["installing", "installed", "failed", "skipped"]), z$1.string()]),
+    version: z$1.string().nullable(),
+    detail: z$1.string().optional(),
+    at: z$1.number()
+  }).nullable().optional()
 });
 const WebTerminalListItemSchema = z$1.object({
   id: z$1.string(),
@@ -9834,6 +9843,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("'\\''")}'`;
@@ -10744,6 +10796,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;
@@ -10790,6 +10854,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
@@ -10809,6 +10928,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 {
@@ -10888,6 +11008,7 @@ class TerminalSession {
       } catch {
       }
     }
+    this.clearFlushTimer();
     try {
       this.headless.dispose();
     } catch {
@@ -11739,14 +11860,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;
@@ -11768,6 +11891,7 @@ class WebTerminalManager {
         },
         onExit: (code) => {
           if (this.terminals.get(id) !== created) return;
+          created.flushOutput();
           this.terminals.delete(id);
           this.snapshots.drop(id);
           created.dispose();
@@ -11788,14 +11912,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();
@@ -11939,6 +12066,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
@@ -12605,6 +12733,19 @@ function commandExists(command) {
     return false;
   }
 }
+function commandExistsWindows(name) {
+  try {
+    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.platform() === "win32" ? commandExistsWindows(name) : commandExists(name);
+}
 function detectPosix() {
   const claude = commandExists("claude");
   const codex = commandExists("codex");
@@ -12613,17 +12754,11 @@ function detectPosix() {
   const openclawConfig = existsSync$1(join$1(os.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 {
-      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");
@@ -12631,7 +12766,8 @@ function detectWindows() {
   const openclawConfig = existsSync$1(join$1(process.env.USERPROFILE || os.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$1.object({
@@ -14409,6 +14545,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)) {
@@ -14431,6 +14576,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).
@@ -15239,7 +15400,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;
@@ -16462,4 +16623,4 @@ const RawJSONLinesSchema = z$1.discriminatedUnion("type", [
   }).passthrough()
 ]);
 
-export { mirrorLineKey as $, ApiClient as A, credentialRelayProblem as B, deriveLocalCliUpdateSummary as C, updateSettings as D, encodeBase64Url as E, decodeBase64 as F, writeCredentialsLegacy as G, writeCredentialsDataKey as H, InvalidateSync as I, readCredentialsForConfiguredRelay as J, encrypt as K, isClaudeSessionId as L, MAX_CHAT_ATTACHMENT_SOURCE_BYTES as M, getLocalHappyAgentCredentialPath as N, readLocalHappyAgentCredentials as O, decryptWithDataKey as P, decryptLegacy as Q, RawJSONLinesSchema as R, STREAM_DELTA_MAX_CHARS as S, extractCompleteLines as T, decideBackfill as U, parseTerminalHookPayload as V, tmuxArgs as W, scrubTmuxClientEnv as X, decideMirrorBinding as Y, MIRROR_BACKFILL_LINES_DEFAULT as Z, persistSession as _, ApiSessionClient as a, mirrorLocalId as a0, detectResumeSupport as a1, detectCLIAvailability as a2, acquireDaemonLock as a3, summarizeSpawnSessionForLog as a4, deletePersistedSessions as a5, shellescape as a6, decrypt as a7, writeDaemonState as a8, writeSettings as a9, fetchCliUpdateState as aa, resolveCliUpdateCheckInterval as ab, DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS as ac, releaseDaemonLock as ad, listVhTerminals as ae, isValidTerminalId as af, readVhTerminal as ag, sendToVhTerminal as ah, TITLE_PROMPT_PREFIX as ai, BOARD_ANALYZER_PROMPT_PREFIX as aj, startOfflineReconnection as ak, clearCredentials as al, clearMachineId as am, SandboxConfigSchema as an, CodexAppServerClient as ao, getLatestDaemonLog as ap, persistence as aq, api as ar, createEnvelope as b, configuration as c, contentLogMetadata as d, errorLogMetadata as e, packageJson as f, delay as g, connectionState as h, isValidSessionId as i, readSettings as j, encodeBase64 as k, logger as l, ensurePrivateDirectorySync as m, hardenPrivateFileSync as n, readDaemonState as o, projectPath as p, clearDaemonState as q, readPersistedSessions as r, getProjectPath as s, initializeSandbox as t, wrapCommand as u, AsyncLock as v, writePrivateFileSync as w, ensurePrivateDirectory as x, hardenPrivateFile as y, readCredentials as z };
+export { MIRROR_BACKFILL_LINES_DEFAULT as $, ApiClient as A, readCredentials as B, credentialRelayProblem as C, deriveLocalCliUpdateSummary as D, updateSettings as E, encodeBase64Url as F, decodeBase64 as G, writeCredentialsLegacy as H, InvalidateSync as I, writeCredentialsDataKey as J, readCredentialsForConfiguredRelay as K, encrypt as L, MAX_CHAT_ATTACHMENT_SOURCE_BYTES as M, isClaudeSessionId as N, getLocalHappyAgentCredentialPath as O, readLocalHappyAgentCredentials as P, decryptWithDataKey as Q, RawJSONLinesSchema as R, STREAM_DELTA_MAX_CHARS as S, decryptLegacy as T, compareExactVersions as U, extractCompleteLines as V, decideBackfill as W, parseTerminalHookPayload as X, tmuxArgs as Y, scrubTmuxClientEnv as Z, decideMirrorBinding as _, ApiSessionClient as a, persistSession as a0, mirrorLineKey as a1, mirrorLocalId as a2, detectCLIAvailability as a3, detectResumeSupport as a4, acquireDaemonLock as a5, summarizeSpawnSessionForLog as a6, deletePersistedSessions as a7, shellescape as a8, decrypt as a9, writeDaemonState as aa, writeSettings as ab, fetchCliUpdateState as ac, resolveCliUpdateCheckInterval as ad, DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS as ae, releaseDaemonLock as af, listVhTerminals as ag, isValidTerminalId as ah, readVhTerminal as ai, sendToVhTerminal as aj, TITLE_PROMPT_PREFIX as ak, BOARD_ANALYZER_PROMPT_PREFIX as al, startOfflineReconnection as am, clearCredentials as an, clearMachineId as ao, SandboxConfigSchema as ap, CodexAppServerClient as aq, getLatestDaemonLog as ar, persistence as as, api as at, createEnvelope as b, configuration as c, contentLogMetadata as d, errorLogMetadata as e, packageJson as f, delay as g, connectionState as h, isValidSessionId as i, readSettings as j, encodeBase64 as k, logger as l, ensurePrivateDirectorySync as m, hardenPrivateFileSync as n, readDaemonState as o, projectPath as p, clearDaemonState as q, readPersistedSessions as r, getProjectPath as s, initializeSandbox as t, wrapCommand as u, AsyncLock as v, writePrivateFileSync as w, ensurePrivateDirectory as x, hardenPrivateFile as y, commandOnPath as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "very-happy-cli",
-  "version": "0.2.115",
+  "version": "0.2.117",
   "description": "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.",
   "author": "Kirill Dubovitskiy",
   "contributors": [
@@ -113,12 +113,12 @@
     "zod": "^4.0.0"
   },
   "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"
   },
   "devDependencies": {
     "@slopus/happy-wire": "workspace:*",

package/dist/sessions-CGdcF05T.cjs

@@ -1,204 +0,0 @@
-'use strict';
-
-var chalk = require('chalk');
-var index = require('./index-tPXwlc_t.cjs');
-var persistence = require('./types-CpnzfHHS.cjs');
-require('node:os');
-require('node:crypto');
-require('cross-spawn');
-require('node:path');
-require('node:readline');
-require('node:fs');
-require('./agentGuidance-BifkGXdE.cjs');
-require('node:fs/promises');
-require('fs/promises');
-require('ink');
-require('react');
-require('@anthropic-ai/claude-agent-sdk');
-require('axios');
-require('node:events');
-require('socket.io-client');
-require('tweetnacl');
-require('os');
-require('child_process');
-require('@paralleldrive/cuid2');
-require('node:child_process');
-require('fs');
-require('path');
-require('@anthropic-ai/sandbox-runtime');
-require('expo-server-sdk');
-require('crypto');
-require('ps-list');
-require('tmp');
-require('open');
-require('fastify');
-require('zod');
-require('fastify-type-provider-zod');
-require('node:module');
-require('@modelcontextprotocol/sdk/server/mcp.js');
-require('node:http');
-require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-require('./limits-KdWKmwtH.cjs');
-require('http');
-require('util');
-require('inquirer');
-require('node:url');
-require('node:readline/promises');
-require('node:util');
-require('url');
-require('node-pty');
-
-const ACTIONS_NEEDING_ID = /* @__PURE__ */ new Set(["read", "stop", "archive"]);
-function parseSessionsArgs(args) {
-  const options = { action: "help", json: false };
-  let actionSeen = false;
-  const positionals = [];
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--help" || arg === "-h") {
-      return { action: "help", json: false };
-    } else if (arg === "--json") {
-      options.json = true;
-    } else if (arg === "--tag") {
-      const value = args[++i];
-      if (value === void 0) throw new Error("--tag requires a value");
-      options.tag = value;
-    } else if (arg === "--limit") {
-      const value = args[++i];
-      if (value === void 0) throw new Error("--limit requires a value");
-      const parsed = Number(value);
-      if (!Number.isInteger(parsed) || parsed < 1) throw new Error("--limit must be a positive integer");
-      options.limit = parsed;
-    } else if (arg.startsWith("-")) {
-      throw new Error(`Unknown argument: ${arg}`);
-    } else if (!actionSeen) {
-      if (arg !== "list" && arg !== "read" && arg !== "stop" && arg !== "archive") {
-        throw new Error(`Unknown action: ${arg} (expected list, read, stop or archive)`);
-      }
-      options.action = arg;
-      actionSeen = true;
-    } else {
-      positionals.push(arg);
-    }
-  }
-  if (!actionSeen) return { action: "help", json: false };
-  if (positionals.length > 1) throw new Error(`Unexpected extra argument: ${positionals[1]}`);
-  if (ACTIONS_NEEDING_ID.has(options.action)) {
-    const id = positionals[0];
-    if (id === void 0) throw new Error(`${options.action} requires a session id`);
-    if (!persistence.isValidSessionId(id)) throw new Error(`Invalid session id: ${id}`);
-    options.sessionId = id;
-  } else if (positionals.length > 0) {
-    throw new Error(`Unexpected argument: ${positionals[0]}`);
-  }
-  if (options.action !== "list" && options.tag !== void 0) {
-    throw new Error("--tag only applies to `sessions list`");
-  }
-  return options;
-}
-const SESSIONS_HELP = `
-${chalk.bold("very-happy sessions")} - Inspect and control sessions on this machine (for automation)
-
-${chalk.bold("Usage:")}
-  very-happy sessions list [--tag <name>] [--limit <n>] [--json]
-  very-happy sessions read <id> [--limit <n>] [--json]
-  very-happy sessions stop <id> [--json]
-  very-happy sessions archive <id> [--json]
-
-${chalk.bold("Actions:")}
-  list       Running sessions plus recently seen ones, newest first.
-  read       The tail of a session as a role-tagged transcript.
-  stop       SIGTERM the session's process via the local daemon.
-  archive    Mark the session inactive server-side (it stays resumable).
-
-${chalk.bold("Options:")}
-  --tag <name>   list only: keep sessions carrying this origin tag (see
-                 \`spawn --spawned-by\`).
-  --limit <n>    list: how many NOT-running sessions to include (default ${index.DEFAULT_RECENT_LIMIT};
-                 running ones are never cut). read: how many messages
-                 (default 20, max ${index.MAX_READ_LIMIT}).
-  --json         Machine-readable output.
-  -h, --help     Show this help
-
-${chalk.bold("Scope:")}
-  This machine only. Reads need the session key from ~/.happy/sessions.json,
-  which exists for sessions this machine's daemon spawned and is pruned after
-  14 days. A session on another machine cannot be read or stopped from here.
-
-${chalk.bold("Exit codes:")}
-  0  success
-  1  bad arguments, unknown session, no local key, or the operation failed
-     (including \`stop\` on a session the daemon is not running)
-`;
-function formatSummaryLine(summary) {
-  const parts = [summary.id, summary.live ? "[running]" : "[not running]"];
-  if (summary.title) parts.push(`title="${summary.title}"`);
-  if (summary.flavor) parts.push(`agent=${summary.flavor}`);
-  if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
-  if (summary.variant) parts.push(`variant=${summary.variant}`);
-  if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
-  if (summary.pid !== void 0) parts.push(`pid=${summary.pid}`);
-  parts.push(summary.url);
-  return parts.join(" ");
-}
-async function handleSessionsCommand(args) {
-  let options;
-  try {
-    options = parseSessionsArgs(args);
-  } catch (error) {
-    console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
-    console.error(`Run ${chalk.cyan("very-happy sessions --help")} for usage.`);
-    process.exit(1);
-  }
-  if (options.action === "help") {
-    console.log(SESSIONS_HELP);
-    process.exit(0);
-  }
-  try {
-    if (options.action === "list") {
-      const sessions = await index.listSessions({ tag: options.tag, recentLimit: options.limit });
-      if (options.json) {
-        console.log(JSON.stringify({ sessions }));
-      } else if (sessions.length === 0) {
-        console.log(options.tag ? `No sessions tagged "${options.tag}" on this machine.` : "No sessions found on this machine.");
-      } else {
-        for (const summary of sessions) console.log(formatSummaryLine(summary));
-      }
-      process.exit(0);
-    }
-    const sessionId = options.sessionId;
-    if (options.action === "read") {
-      const result = await index.readSessionTranscript(sessionId, options.limit ?? 20);
-      if (options.json) {
-        console.log(JSON.stringify(result));
-      } else {
-        console.log(formatSummaryLine(result.summary));
-        console.log(`--- last ${result.messageCount} message(s) ---`);
-        console.log(result.transcript.length > 0 ? result.transcript : "(no readable conversation content in this range)");
-      }
-      process.exit(0);
-    }
-    if (options.action === "stop") {
-      const stopped = await index.stopSession(sessionId);
-      if (!stopped) {
-        if (options.json) console.log(JSON.stringify({ sessionId, stopped: false }));
-        console.error(chalk.red("Error:"), `Session ${sessionId} is not among the daemon's running sessions.`);
-        process.exit(1);
-      }
-      if (options.json) console.log(JSON.stringify({ sessionId, stopped: true }));
-      else console.log(`Stopped ${sessionId}`);
-      process.exit(0);
-    }
-    await index.archiveSession(sessionId);
-    if (options.json) console.log(JSON.stringify({ sessionId, archived: true }));
-    else console.log(`Archived ${sessionId}`);
-    process.exit(0);
-  } catch (error) {
-    console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
-
-exports.SESSIONS_HELP = SESSIONS_HELP;
-exports.handleSessionsCommand = handleSessionsCommand;
-exports.parseSessionsArgs = parseSessionsArgs;