very-happy-cli 0.2.146 → 0.2.148

package/dist/{types-DjB5fcAr.mjs → types-CXF6tULJ.mjs}

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import { l as logger, g as encodeBase64, j as encrypt, k as decrypt, m as decodeBase64, c as configuration, o as readDaemonState, q as clearDaemonState, s as decryptBlob, t as prepareClipboardText, v as prepareClipboardHistoryText, r as readSettings, d as readPersistedSessions, x as credentialRelayProblem, p as packageJson, y as readTrackedClaudeSessionIds, z as readTrackedCodexThreadIds, A as libsodiumEncryptForPublicKey, B as libsodiumPublicKeyFromSecretKey, D as getRandomBytes, E as redactLogValue } from './limits-DNPVbu0o.mjs';
+import { l as logger, g as encodeBase64, j as encrypt, k as decrypt, m as decodeBase64, c as configuration, o as readDaemonState, q as clearDaemonState, s as decryptBlob, t as prepareClipboardText, v as prepareClipboardHistoryText, r as readSettings, d as readPersistedSessions, x as credentialRelayProblem, p as packageJson, y as readTrackedClaudeSessionIds, z as readTrackedCodexThreadIds, A as libsodiumEncryptForPublicKey, B as libsodiumPublicKeyFromSecretKey, D as getRandomBytes, E as redactLogValue } from './limits-BfYfA7tt.mjs';
 import { EventEmitter } from 'node:events';
 import { io } from 'socket.io-client';
 import * as z from 'zod';
@@ -887,7 +887,9 @@ const WebTerminalListItemSchema = z$1.object({
   /** B-265: @vh_title_manual is set (user renamed it). */
   manual: z$1.boolean().optional(),
   /** B-273: opened attached to the user's tmux session of this name. */
-  attachTmux: z$1.string().optional()
+  attachTmux: z$1.string().optional(),
+  /** B-486: direct-pty shell (no tmux) — not restorable after a daemon restart. */
+  direct: z$1.boolean().optional()
 });
 const ClosedTerminalRecordSchema = z$1.object({
   id: z$1.string(),
@@ -991,6 +993,17 @@ z$1.object({
     rpcAvailable: z$1.boolean(),
     detectedAt: z$1.number()
   }).optional(),
+  /**
+   * B-486: can web terminals on this machine be durable? `tmuxAvailable:
+   * false` ⇒ every new terminal is a direct shell that dies with the daemon,
+   * so the web tells the user to install tmux. Same trust rule
+   * (`detectedAt >= startedAt`); old webs ignore it.
+   */
+  terminalHost: z$1.object({
+    tmuxAvailable: z$1.boolean(),
+    tmuxVersion: z$1.string().optional(),
+    detectedAt: z$1.number()
+  }).optional(),
   /** Relay-owned CLI compatibility/update policy last checked by this daemon. */
   cliUpdate: CliUpdateStateSchema.optional(),
   /**
@@ -10479,6 +10492,25 @@ function sanitizeClosedTerminals(raw, max = CLOSED_TERMINALS_MAX) {
   return out.slice(0, max);
 }
 
+function directTerminalItems(sessions, tmuxIds) {
+  const out = [];
+  for (const s of sessions) {
+    if (!s.direct || tmuxIds.has(s.id)) continue;
+    const title = (s.direct.title ?? "").trim();
+    out.push({
+      id: s.id,
+      ...title ? { title } : {},
+      tags: s.direct.tags ?? [],
+      ...s.direct.manual ? { manual: true } : {},
+      cwd: s.direct.cwd,
+      createdAt: s.direct.createdAt,
+      ...s.lastOutputAt ? { activityAt: s.lastOutputAt } : {},
+      direct: true
+    });
+  }
+  return out.sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+
 const TOMBSTONE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
 function tmuxKillVerified(kill, probe) {
   return !kill.error && !probe.error && typeof probe.status === "number" && probe.status !== 0;
@@ -10615,10 +10647,14 @@ function terminalListSignature(items) {
     // B-105: a mirror binding appearing/disappearing MUST push the
     // list, or the web never learns the toggle became available.
     t.mirrorSessionId ?? "",
-    t.attachTmux ?? ""
+    t.attachTmux ?? "",
+    t.direct ? 1 : 0
   ]);
   return JSON.stringify(canon);
 }
+function hostListSignature(items) {
+  return `${isTmuxAvailable() ? "tmux" : "no-tmux"}|${terminalListSignature(items)}`;
+}
 const SHELL_COMMANDS = /* @__PURE__ */ new Set(["zsh", "bash", "fish", "sh", "dash", "ksh", "tcsh", "csh"]);
 const TITLE_MAX_CHARS = 60;
 const JUNK_TITLES = /* @__PURE__ */ new Set(["tmux", "claude", "node", ...SHELL_COMMANDS]);
@@ -10767,16 +10803,38 @@ function tmuxSupportsNewSessionEnv(versionOutput) {
   return maj > 3 || maj === 3 && min >= 2;
 }
 let tmuxAvailableCache = null;
+let tmuxMissingSince = 0;
+const TMUX_MISSING_REPROBE_MS = 3e4;
 function isTmuxAvailable() {
-  if (tmuxAvailableCache !== null) return tmuxAvailableCache;
+  if (tmuxAvailableCache === true) return true;
+  if (tmuxAvailableCache === false && Date.now() - tmuxMissingSince < TMUX_MISSING_REPROBE_MS) return false;
   try {
     const r = spawnSync("tmux", tmuxArgs(["-V"]), { stdio: "ignore", env: ptyEnv() });
     tmuxAvailableCache = r.status === 0;
   } catch {
     tmuxAvailableCache = false;
   }
+  if (tmuxAvailableCache) {
+    tmuxEnvFlagCache = null;
+    tmuxVersionCache = void 0;
+  } else {
+    tmuxMissingSince = Date.now();
+  }
   return tmuxAvailableCache;
 }
+function tmuxRuntimeInfo() {
+  if (!isTmuxAvailable()) return { tmuxAvailable: false };
+  if (tmuxVersionCache === void 0) {
+    try {
+      const r = spawnSync("tmux", tmuxArgs(["-V"]), { encoding: "utf8", timeout: TMUX_PROBE_TIMEOUT_MS, env: ptyEnv() });
+      tmuxVersionCache = (r.stdout || "").trim().slice(0, 64);
+    } catch {
+      tmuxVersionCache = "";
+    }
+  }
+  return tmuxVersionCache ? { tmuxAvailable: true, tmuxVersion: tmuxVersionCache } : { tmuxAvailable: true };
+}
+let tmuxVersionCache;
 let tmuxEnvFlagCache = null;
 function tmuxSupportsEnvFlag() {
   if (tmuxEnvFlagCache !== null) return tmuxEnvFlagCache;
@@ -10861,6 +10919,9 @@ class TerminalSession {
   id;
   tmuxSession;
   transport;
+  /** B-486: set only for a direct-pty (no tmux) session — the list row's
+   *  source, since tmux knows nothing about it. */
+  direct;
   /** B-273: the user tmux session this terminal was created to attach —
    *  echoed to any later open of the same live session. */
   attachedTmux;
@@ -11324,7 +11385,7 @@ class WebTerminalManager {
    *  other means (the connect-time daemonState write carries the initial
    *  snapshot), so the first tick doesn't re-push an identical list. */
   primeListSignature(list) {
-    this.lastListSignature = terminalListSignature(list);
+    this.lastListSignature = hostListSignature(list);
     this.noteSeen(list);
   }
   /** The retained closed-terminal records (newest first) — shipped by
@@ -11365,6 +11426,7 @@ class WebTerminalManager {
    */
   buildTerminalList() {
     const list = this.listSessions();
+    list.push(...directTerminalItems(this.terminals.values(), new Set(list.map((t) => t.id))));
     for (const item of list) {
       const live = this.terminals.get(item.id);
       if (live?.lastOutputAt) {
@@ -11402,7 +11464,7 @@ class WebTerminalManager {
         list.filter((t) => t.activityAt).map((t) => [t.id, t.activityAt])
       ));
       this.mirrorTickObserver?.(list);
-      const sig = terminalListSignature(list);
+      const sig = hostListSignature(list);
       if (sig === this.lastListSignature) return;
       this.lastListSignature = sig;
       cb(list);
@@ -11750,6 +11812,7 @@ class WebTerminalManager {
     const now = Date.now();
     this.snapshots.sweep(now);
     for (const [id, session] of [...this.terminals]) {
+      if (session.direct) continue;
       if (session.subscribers === 0 && now - session.lastTouch > SESSION_IDLE_MS) {
         logger.debug(`[WEB TERMINAL] reaping orphaned idle session ${id} (idle ${Math.round((now - session.lastTouch) / 6e4)}m)`);
         this.detach(id);
@@ -12026,6 +12089,10 @@ class WebTerminalManager {
         }
       }
       const created = new TerminalSession(id, { kind: "pty", pty: proc }, void 0, cols, rows);
+      created.direct = { cwd, createdAt: Date.now() };
+      created.onTitleChange((title) => {
+        if (created.direct && !created.direct.manual) created.direct.title = deriveAutoTitle(title, os$1.hostname());
+      });
       created.onOutputChunk = (chunk) => {
         this.emit("terminal-output", { terminalId: id, data: chunk.data, seq: chunk.seq });
         this.noteActivity();
@@ -12378,6 +12445,26 @@ class WebTerminalManager {
    *  session (so a local `tmux attach` won't find it either). Used when the
    *  user deletes the terminal from the sidebar. */
   killSession(terminalId, opts) {
+    const liveDirect = this.terminals.get(terminalId);
+    if (liveDirect?.direct) {
+      this.recordClosed({
+        id: terminalId,
+        ...liveDirect.direct.title?.trim() ? { title: liveDirect.direct.title.trim() } : {},
+        cwd: liveDirect.direct.cwd,
+        tags: liveDirect.direct.tags ?? [],
+        ...liveDirect.direct.manual ? { manual: true } : {},
+        reason: "closed",
+        closedAt: Date.now()
+      });
+      this.lastSeenInfo.delete(terminalId);
+      this.detach(terminalId);
+      this.tombstones[terminalId] = Date.now();
+      saveTombstones(this.tombstones);
+      this.notifyTracker.remove(terminalId);
+      logger.debug(`[WEB TERMINAL] killed direct pty ${terminalId}`);
+      this.kickListRefresh();
+      return true;
+    }
     const info = this.lastSeenInfo.get(terminalId) ?? (() => {
       const t = this.listSessions().find((x) => x.id === terminalId);
       return t ? seenInfoOf(t) : void 0;
@@ -12662,6 +12749,14 @@ class WebTerminalManager {
    *  landed. `ifAbsent` finding an existing title counts as success (there IS
    *  a title; nothing to retry). */
   setTitle(terminalId, title, ifAbsent = false) {
+    const direct = this.terminals.get(terminalId)?.direct;
+    if (direct) {
+      if (ifAbsent && (direct.manual || direct.title?.trim())) return true;
+      direct.title = title;
+      if (!ifAbsent) direct.manual = true;
+      this.kickListRefresh();
+      return true;
+    }
     if (!isTmuxAvailable()) return false;
     if (!/^[a-zA-Z0-9_-]{1,64}$/.test(terminalId)) return false;
     const name = `vh-${terminalId}`;
@@ -12686,10 +12781,16 @@ class WebTerminalManager {
   }
   /** Persist terminal tags in tmux, parallel to @vh_title. */
   setTags(terminalId, tags) {
-    if (!isTmuxAvailable()) return false;
+    const direct = this.terminals.get(terminalId)?.direct;
+    if (!direct && !isTmuxAvailable()) return false;
     if (!/^[a-zA-Z0-9_-]{1,64}$/.test(terminalId)) return false;
     const valid = validateTerminalTags(tags);
     if (!valid) return false;
+    if (direct) {
+      direct.tags = valid;
+      this.kickListRefresh();
+      return true;
+    }
     const name = `vh-${terminalId}`;
     try {
       const r = spawnSync("tmux", tmuxArgs(["set-option", "-t", name, "@vh_tags", JSON.stringify(valid)]), {
@@ -15777,6 +15878,9 @@ class ApiMachineClient {
         // even in the (unreachable) case of a null prior state.
         status: state?.status ?? "running",
         webTerminals: { updatedAt: Date.now(), terminals: list },
+        // B-486: tmux can appear (user installs it) mid-run; the
+        // tracker forces a push on that flip, so restamp here too.
+        terminalHost: { ...tmuxRuntimeInfo(), detectedAt: Date.now() },
         // B-084: the closed-terminal records ride every list push
         // (a close always changes the list, so they stay in step).
         // Read at write time — same freshness rule as the list.
@@ -15926,6 +16030,8 @@ class ApiMachineClient {
         terminalRestore: { rpcAvailable: true, detectedAt: now },
         // B-273 capability flag (same restamp discipline).
         tmuxSessions: { rpcAvailable: true, detectedAt: now, killAttached: true },
+        // B-486: tmux presence (same restamp discipline).
+        terminalHost: { ...tmuxRuntimeInfo(), detectedAt: now },
         // B-290 capability flag: `claude-list-history` (same restamp discipline).
         claudeHistory: { rpcAvailable: true, detectedAt: now },
         // B-464 capability flag: `codex-list-history` / `codex-import-session`.

package/dist/{types-CgOMSh1y.cjs → types-IU5nGuaQ.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var axios = require('axios');
-var persistence = require('./limits-Cs9ZqLsR.cjs');
+var persistence = require('./limits-D364Cpe3.cjs');
 var node_events = require('node:events');
 var socket_ioClient = require('socket.io-client');
 var z = require('zod');
@@ -908,7 +908,9 @@ const WebTerminalListItemSchema = z.z.object({
   /** B-265: @vh_title_manual is set (user renamed it). */
   manual: z.z.boolean().optional(),
   /** B-273: opened attached to the user's tmux session of this name. */
-  attachTmux: z.z.string().optional()
+  attachTmux: z.z.string().optional(),
+  /** B-486: direct-pty shell (no tmux) — not restorable after a daemon restart. */
+  direct: z.z.boolean().optional()
 });
 const ClosedTerminalRecordSchema = z.z.object({
   id: z.z.string(),
@@ -1012,6 +1014,17 @@ z.z.object({
     rpcAvailable: z.z.boolean(),
     detectedAt: z.z.number()
   }).optional(),
+  /**
+   * B-486: can web terminals on this machine be durable? `tmuxAvailable:
+   * false` ⇒ every new terminal is a direct shell that dies with the daemon,
+   * so the web tells the user to install tmux. Same trust rule
+   * (`detectedAt >= startedAt`); old webs ignore it.
+   */
+  terminalHost: z.z.object({
+    tmuxAvailable: z.z.boolean(),
+    tmuxVersion: z.z.string().optional(),
+    detectedAt: z.z.number()
+  }).optional(),
   /** Relay-owned CLI compatibility/update policy last checked by this daemon. */
   cliUpdate: CliUpdateStateSchema.optional(),
   /**
@@ -10500,6 +10513,25 @@ function sanitizeClosedTerminals(raw, max = CLOSED_TERMINALS_MAX) {
   return out.slice(0, max);
 }
 
+function directTerminalItems(sessions, tmuxIds) {
+  const out = [];
+  for (const s of sessions) {
+    if (!s.direct || tmuxIds.has(s.id)) continue;
+    const title = (s.direct.title ?? "").trim();
+    out.push({
+      id: s.id,
+      ...title ? { title } : {},
+      tags: s.direct.tags ?? [],
+      ...s.direct.manual ? { manual: true } : {},
+      cwd: s.direct.cwd,
+      createdAt: s.direct.createdAt,
+      ...s.lastOutputAt ? { activityAt: s.lastOutputAt } : {},
+      direct: true
+    });
+  }
+  return out.sort((a, b) => a.createdAt - b.createdAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+
 const TOMBSTONE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
 function tmuxKillVerified(kill, probe) {
   return !kill.error && !probe.error && typeof probe.status === "number" && probe.status !== 0;
@@ -10636,10 +10668,14 @@ function terminalListSignature(items) {
     // B-105: a mirror binding appearing/disappearing MUST push the
     // list, or the web never learns the toggle became available.
     t.mirrorSessionId ?? "",
-    t.attachTmux ?? ""
+    t.attachTmux ?? "",
+    t.direct ? 1 : 0
   ]);
   return JSON.stringify(canon);
 }
+function hostListSignature(items) {
+  return `${isTmuxAvailable() ? "tmux" : "no-tmux"}|${terminalListSignature(items)}`;
+}
 const SHELL_COMMANDS = /* @__PURE__ */ new Set(["zsh", "bash", "fish", "sh", "dash", "ksh", "tcsh", "csh"]);
 const TITLE_MAX_CHARS = 60;
 const JUNK_TITLES = /* @__PURE__ */ new Set(["tmux", "claude", "node", ...SHELL_COMMANDS]);
@@ -10788,16 +10824,38 @@ function tmuxSupportsNewSessionEnv(versionOutput) {
   return maj > 3 || maj === 3 && min >= 2;
 }
 let tmuxAvailableCache = null;
+let tmuxMissingSince = 0;
+const TMUX_MISSING_REPROBE_MS = 3e4;
 function isTmuxAvailable() {
-  if (tmuxAvailableCache !== null) return tmuxAvailableCache;
+  if (tmuxAvailableCache === true) return true;
+  if (tmuxAvailableCache === false && Date.now() - tmuxMissingSince < TMUX_MISSING_REPROBE_MS) return false;
   try {
     const r = node_child_process.spawnSync("tmux", tmuxArgs(["-V"]), { stdio: "ignore", env: ptyEnv() });
     tmuxAvailableCache = r.status === 0;
   } catch {
     tmuxAvailableCache = false;
   }
+  if (tmuxAvailableCache) {
+    tmuxEnvFlagCache = null;
+    tmuxVersionCache = void 0;
+  } else {
+    tmuxMissingSince = Date.now();
+  }
   return tmuxAvailableCache;
 }
+function tmuxRuntimeInfo() {
+  if (!isTmuxAvailable()) return { tmuxAvailable: false };
+  if (tmuxVersionCache === void 0) {
+    try {
+      const r = node_child_process.spawnSync("tmux", tmuxArgs(["-V"]), { encoding: "utf8", timeout: TMUX_PROBE_TIMEOUT_MS, env: ptyEnv() });
+      tmuxVersionCache = (r.stdout || "").trim().slice(0, 64);
+    } catch {
+      tmuxVersionCache = "";
+    }
+  }
+  return tmuxVersionCache ? { tmuxAvailable: true, tmuxVersion: tmuxVersionCache } : { tmuxAvailable: true };
+}
+let tmuxVersionCache;
 let tmuxEnvFlagCache = null;
 function tmuxSupportsEnvFlag() {
   if (tmuxEnvFlagCache !== null) return tmuxEnvFlagCache;
@@ -10882,6 +10940,9 @@ class TerminalSession {
   id;
   tmuxSession;
   transport;
+  /** B-486: set only for a direct-pty (no tmux) session — the list row's
+   *  source, since tmux knows nothing about it. */
+  direct;
   /** B-273: the user tmux session this terminal was created to attach —
    *  echoed to any later open of the same live session. */
   attachedTmux;
@@ -11345,7 +11406,7 @@ class WebTerminalManager {
    *  other means (the connect-time daemonState write carries the initial
    *  snapshot), so the first tick doesn't re-push an identical list. */
   primeListSignature(list) {
-    this.lastListSignature = terminalListSignature(list);
+    this.lastListSignature = hostListSignature(list);
     this.noteSeen(list);
   }
   /** The retained closed-terminal records (newest first) — shipped by
@@ -11386,6 +11447,7 @@ class WebTerminalManager {
    */
   buildTerminalList() {
     const list = this.listSessions();
+    list.push(...directTerminalItems(this.terminals.values(), new Set(list.map((t) => t.id))));
     for (const item of list) {
       const live = this.terminals.get(item.id);
       if (live?.lastOutputAt) {
@@ -11423,7 +11485,7 @@ class WebTerminalManager {
         list.filter((t) => t.activityAt).map((t) => [t.id, t.activityAt])
       ));
       this.mirrorTickObserver?.(list);
-      const sig = terminalListSignature(list);
+      const sig = hostListSignature(list);
       if (sig === this.lastListSignature) return;
       this.lastListSignature = sig;
       cb(list);
@@ -11771,6 +11833,7 @@ class WebTerminalManager {
     const now = Date.now();
     this.snapshots.sweep(now);
     for (const [id, session] of [...this.terminals]) {
+      if (session.direct) continue;
       if (session.subscribers === 0 && now - session.lastTouch > SESSION_IDLE_MS) {
         persistence.logger.debug(`[WEB TERMINAL] reaping orphaned idle session ${id} (idle ${Math.round((now - session.lastTouch) / 6e4)}m)`);
         this.detach(id);
@@ -12047,6 +12110,10 @@ class WebTerminalManager {
         }
       }
       const created = new TerminalSession(id, { kind: "pty", pty: proc }, void 0, cols, rows);
+      created.direct = { cwd, createdAt: Date.now() };
+      created.onTitleChange((title) => {
+        if (created.direct && !created.direct.manual) created.direct.title = deriveAutoTitle(title, os$1.hostname());
+      });
       created.onOutputChunk = (chunk) => {
         this.emit("terminal-output", { terminalId: id, data: chunk.data, seq: chunk.seq });
         this.noteActivity();
@@ -12399,6 +12466,26 @@ class WebTerminalManager {
    *  session (so a local `tmux attach` won't find it either). Used when the
    *  user deletes the terminal from the sidebar. */
   killSession(terminalId, opts) {
+    const liveDirect = this.terminals.get(terminalId);
+    if (liveDirect?.direct) {
+      this.recordClosed({
+        id: terminalId,
+        ...liveDirect.direct.title?.trim() ? { title: liveDirect.direct.title.trim() } : {},
+        cwd: liveDirect.direct.cwd,
+        tags: liveDirect.direct.tags ?? [],
+        ...liveDirect.direct.manual ? { manual: true } : {},
+        reason: "closed",
+        closedAt: Date.now()
+      });
+      this.lastSeenInfo.delete(terminalId);
+      this.detach(terminalId);
+      this.tombstones[terminalId] = Date.now();
+      saveTombstones(this.tombstones);
+      this.notifyTracker.remove(terminalId);
+      persistence.logger.debug(`[WEB TERMINAL] killed direct pty ${terminalId}`);
+      this.kickListRefresh();
+      return true;
+    }
     const info = this.lastSeenInfo.get(terminalId) ?? (() => {
       const t = this.listSessions().find((x) => x.id === terminalId);
       return t ? seenInfoOf(t) : void 0;
@@ -12683,6 +12770,14 @@ class WebTerminalManager {
    *  landed. `ifAbsent` finding an existing title counts as success (there IS
    *  a title; nothing to retry). */
   setTitle(terminalId, title, ifAbsent = false) {
+    const direct = this.terminals.get(terminalId)?.direct;
+    if (direct) {
+      if (ifAbsent && (direct.manual || direct.title?.trim())) return true;
+      direct.title = title;
+      if (!ifAbsent) direct.manual = true;
+      this.kickListRefresh();
+      return true;
+    }
     if (!isTmuxAvailable()) return false;
     if (!/^[a-zA-Z0-9_-]{1,64}$/.test(terminalId)) return false;
     const name = `vh-${terminalId}`;
@@ -12707,10 +12802,16 @@ class WebTerminalManager {
   }
   /** Persist terminal tags in tmux, parallel to @vh_title. */
   setTags(terminalId, tags) {
-    if (!isTmuxAvailable()) return false;
+    const direct = this.terminals.get(terminalId)?.direct;
+    if (!direct && !isTmuxAvailable()) return false;
     if (!/^[a-zA-Z0-9_-]{1,64}$/.test(terminalId)) return false;
     const valid = validateTerminalTags(tags);
     if (!valid) return false;
+    if (direct) {
+      direct.tags = valid;
+      this.kickListRefresh();
+      return true;
+    }
     const name = `vh-${terminalId}`;
     try {
       const r = node_child_process.spawnSync("tmux", tmuxArgs(["set-option", "-t", name, "@vh_tags", JSON.stringify(valid)]), {
@@ -15798,6 +15899,9 @@ class ApiMachineClient {
         // even in the (unreachable) case of a null prior state.
         status: state?.status ?? "running",
         webTerminals: { updatedAt: Date.now(), terminals: list },
+        // B-486: tmux can appear (user installs it) mid-run; the
+        // tracker forces a push on that flip, so restamp here too.
+        terminalHost: { ...tmuxRuntimeInfo(), detectedAt: Date.now() },
         // B-084: the closed-terminal records ride every list push
         // (a close always changes the list, so they stay in step).
         // Read at write time — same freshness rule as the list.
@@ -15947,6 +16051,8 @@ class ApiMachineClient {
         terminalRestore: { rpcAvailable: true, detectedAt: now },
         // B-273 capability flag (same restamp discipline).
         tmuxSessions: { rpcAvailable: true, detectedAt: now, killAttached: true },
+        // B-486: tmux presence (same restamp discipline).
+        terminalHost: { ...tmuxRuntimeInfo(), detectedAt: now },
         // B-290 capability flag: `claude-list-history` (same restamp discipline).
         claudeHistory: { rpcAvailable: true, detectedAt: now },
         // B-464 capability flag: `codex-list-history` / `codex-import-session`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "very-happy-cli",
-  "version": "0.2.146",
+  "version": "0.2.148",
   "description": "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.",
   "author": "Kirill Dubovitskiy",
   "contributors": [
@@ -117,12 +117,12 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "very-happy-tools-arm64-darwin": "0.2.146",
-    "very-happy-tools-x64-darwin": "0.2.146",
-    "very-happy-tools-arm64-linux": "0.2.146",
-    "very-happy-tools-x64-linux": "0.2.146",
-    "very-happy-tools-arm64-win32": "0.2.146",
-    "very-happy-tools-x64-win32": "0.2.146"
+    "very-happy-tools-arm64-darwin": "0.2.148",
+    "very-happy-tools-x64-darwin": "0.2.148",
+    "very-happy-tools-arm64-linux": "0.2.148",
+    "very-happy-tools-x64-linux": "0.2.148",
+    "very-happy-tools-arm64-win32": "0.2.148",
+    "very-happy-tools-x64-win32": "0.2.148"
   },
   "devDependencies": {
     "@slopus/happy-wire": "workspace:*",