very-happy-cli 0.2.158 → 0.2.160

package/dist/{teams-BZ1tayg_.cjs → teams-Dl8g8kTI.cjs}

@@ -4,51 +4,20 @@ var os = require('node:os');
 var promises = require('node:fs/promises');
 var z = require('zod');
 var node_crypto = require('node:crypto');
-var agentGuidance = require('./agentGuidance-DwOWbX55.cjs');
-var persistence = require('./limits-kqFqhfsh.cjs');
-var install = require('./install-wKQGgXvN.cjs');
+var client = require('./client-3Ac-O4pw.cjs');
+var persistence = require('./persistence-yKTH3-5X.cjs');
+var install = require('./install-Cs5qAPrB.cjs');
+require('./configuration-BSYpcPwE.cjs');
 require('node:fs');
 require('node:path');
-require('axios');
-require('socket.io-client');
-require('@paralleldrive/cuid2');
+require('./package-BwMrPwqH.cjs');
+require('./context-DsDr6E2t.cjs');
+require('./authRelay-BdYkC1Po.cjs');
 require('tweetnacl');
+require('./logger-CS0mw3fa.cjs');
 require('chalk');
 require('node:util');
-require('./index-BG932eCh.cjs');
-require('./types-DnrPeN80.cjs');
-require('node:events');
-require('child_process');
-require('util');
-require('fs/promises');
-require('crypto');
-require('path');
-require('cross-spawn');
-require('./terminalTitleSuggest-Dji8I0Jy.cjs');
-require('url');
-require('os');
-require('node:child_process');
-require('node-pty');
-require('fs');
-require('node:readline');
-require('@anthropic-ai/sandbox-runtime');
-require('expo-server-sdk');
-require('ink');
-require('react');
-require('@anthropic-ai/claude-agent-sdk');
-require('ps-list');
-require('tmp');
-require('open');
-require('fastify');
-require('fastify-type-provider-zod');
-require('node:module');
-require('@modelcontextprotocol/sdk/server/mcp.js');
-require('node:http');
-require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-require('http');
-require('inquirer');
-require('node:url');
-require('node:readline/promises');
+require('./resources-JDPugcDq.cjs');
 
 const legacyTask = z.z.object({
   id: z.z.string().regex(/^T-\d{3,}$/),
@@ -90,7 +59,7 @@ async function setTeamPermissionMode(teamId, mode, requestId) {
   if (mode !== "default" && mode !== "bypassPermissions") throw new Error("Mode must be default or bypassPermissions");
   const credentials = await persistence.readCredentialsForConfiguredRelay();
   if (!credentials) throw new Error("Sign in before changing team execution mode");
-  const result = await agentGuidance.teamRequest(
+  const result = await client.teamRequest(
     `/v1/teams/${encodeURIComponent(teamId)}/actions`,
     "POST",
     credentials.token,
@@ -148,21 +117,21 @@ async function handleTeamsCommand(args) {
     console.log(JSON.stringify(await setTeamPermissionMode(teamId, mode, requestId)));
     return;
   }
-  const client = agentGuidance.createTeamsClient(value("--session-id"));
+  const client$1 = client.createTeamsClient(value("--session-id"));
   let result;
-  if (command === "inspect") result = await client.inspect();
+  if (command === "inspect") result = await client$1.inspect();
   else if (command === "create" || command === "join") {
     const name = value("--name");
     if (!name) throw new Error("--name is required");
     if (command === "join" && !value("--team-id")) throw new Error("--team-id is required");
-    result = await client.initialize({ name, teamId: command === "join" ? value("--team-id") : void 0, machineId: value("--machine-id"), botId: value("--bot-id"), requestId: value("--request-id") ?? node_crypto.randomUUID() });
+    result = await client$1.initialize({ name, teamId: command === "join" ? value("--team-id") : void 0, machineId: value("--machine-id"), botId: value("--bot-id"), requestId: value("--request-id") ?? node_crypto.randomUUID() });
   } else if (command === "action") {
     const payload = value("--json");
     const requestId = value("--request-id");
     if (!payload || !requestId) throw new Error("--json and --request-id are required");
     const action = JSON.parse(payload);
     if (!["delegate", "message", "submit", "accept", "return", "cancel", "handoff", "schedule-create", "schedule-pause", "schedule-resume", "schedule-cancel"].includes(action.type)) throw new Error("Unsupported team action");
-    result = await client.action(action, requestId);
+    result = await client$1.action(action, requestId);
   } else throw new Error("Unknown teams command; use teams --help");
   console.log(JSON.stringify(result));
 }

package/dist/template-BaHAmH2K.cjs

@@ -0,0 +1,129 @@
+'use strict';
+
+function payloadJson(payload) {
+  if (!payload) return void 0;
+  try {
+    return JSON.parse(payload);
+  } catch {
+    return void 0;
+  }
+}
+function lookupPath(root, path) {
+  let current = root;
+  for (const segment of path) {
+    if (current === null || typeof current !== "object") return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function scalar(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return "";
+  }
+}
+function formatNow(now, tz) {
+  if (!tz) return new Date(now).toISOString();
+  try {
+    const parts = new Intl.DateTimeFormat("en-CA", { timeZone: tz, hourCycle: "h23", year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit", timeZoneName: "longOffset" }).formatToParts(new Date(now));
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    const offset = get("timeZoneName").replace(/^GMT$/, "+00:00").replace(/^GMT/, "");
+    return `${get("year")}-${get("month")}-${get("day")}T${get("hour")}:${get("minute")}:${get("second")}${offset || "Z"}`;
+  } catch {
+    return new Date(now).toISOString();
+  }
+}
+function renderTemplate(text, context) {
+  const json = payloadJson(context.payload);
+  return text.replace(/\{\{\s*([a-zA-Z_][a-zA-Z0-9_.-]*)\s*\}\}/g, (whole, name) => {
+    if (name === "payload") return context.payload ?? "";
+    if (name.startsWith("payload.")) return scalar(lookupPath(json, name.slice("payload.".length).split(".")));
+    if (name === "run.id") return context.runId;
+    if (name === "automation.name") return context.automationName;
+    if (name === "now") return formatNow(context.now ?? Date.now(), context.tz);
+    return whole;
+  });
+}
+function renderAction(action, context) {
+  const r = (value) => renderTemplate(value, context);
+  if (action.kind === "spawn") return { ...action, prompt: r(action.prompt) };
+  if (action.kind === "send") return { ...action, prompt: r(action.prompt) };
+  return { ...action, command: action.command.map(r), ...action.env ? { env: Object.fromEntries(Object.entries(action.env).map(([k, v]) => [k, r(v)])) } : {} };
+}
+function clipText(text, maxChars, keep = "head") {
+  if (text.length <= maxChars) return text;
+  return keep === "head" ? text.slice(0, maxChars) : text.slice(text.length - maxChars);
+}
+const DURATION_UNITS = { ms: 1, s: 1e3, m: 6e4, h: 36e5, d: 864e5 };
+function parseDuration(raw) {
+  const text = raw.trim();
+  if (/^\d+$/.test(text)) return Number(text);
+  const re = /(\d+(?:\.\d+)?)(ms|s|m|h|d)/gy;
+  let total = 0;
+  let matched = 0;
+  let last = 0;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    total += Number(m[1]) * DURATION_UNITS[m[2]];
+    matched++;
+    last = re.lastIndex;
+  }
+  if (matched === 0 || last !== text.length) throw new Error(`Invalid duration: ${raw} (use e.g. 90s, 5m, 1h30m, 2d)`);
+  return Math.round(total);
+}
+function formatDuration(ms) {
+  if (ms % 864e5 === 0) return `${ms / 864e5}d`;
+  if (ms % 36e5 === 0) return `${ms / 36e5}h`;
+  if (ms % 6e4 === 0) return `${ms / 6e4}m`;
+  if (ms % 1e3 === 0) return `${ms / 1e3}s`;
+  return `${ms}ms`;
+}
+function triggerFromFlags(flags, now = Date.now()) {
+  const given = [flags.cron !== void 0, flags.every !== void 0, flags.at !== void 0, flags.manual === true].filter(Boolean).length;
+  if (given === 0) {
+    if (flags.tz !== void 0) throw new Error("--tz only applies with --cron");
+    return void 0;
+  }
+  if (given > 1) throw new Error("Use exactly one of --cron, --every, --at, --manual");
+  if (flags.cron !== void 0) {
+    if (!flags.tz) throw new Error("--cron requires --tz <IANA zone> (e.g. Asia/Singapore)");
+    return { kind: "cron", expr: flags.cron, tz: flags.tz };
+  }
+  if (flags.tz !== void 0) throw new Error("--tz only applies with --cron");
+  if (flags.every !== void 0) return { kind: "interval", everyMs: parseDuration(flags.every), anchorAt: now };
+  if (flags.at !== void 0) {
+    const at = Date.parse(flags.at);
+    if (!Number.isFinite(at)) throw new Error(`--at must be an ISO 8601 timestamp, got: ${flags.at}`);
+    return { kind: "once", at };
+  }
+  return { kind: "manual" };
+}
+function describeTrigger(trigger) {
+  switch (trigger.kind) {
+    case "cron":
+      return `cron ${trigger.expr} (${trigger.tz})`;
+    case "interval":
+      return `every ${formatDuration(trigger.everyMs)}`;
+    case "once":
+      return `once at ${new Date(trigger.at).toISOString()}`;
+    default:
+      return "manual";
+  }
+}
+function describeAction(action) {
+  if (action.kind === "spawn") return `spawn ${action.agent} in ${action.directory}${action.sticky ? ` (sticky ${action.sticky.key})` : ""}`;
+  if (action.kind === "send") return `send to session ${action.sessionId}`;
+  return `script ${action.command.join(" ")}`;
+}
+
+exports.clipText = clipText;
+exports.describeAction = describeAction;
+exports.describeTrigger = describeTrigger;
+exports.parseDuration = parseDuration;
+exports.renderAction = renderAction;
+exports.renderTemplate = renderTemplate;
+exports.triggerFromFlags = triggerFromFlags;

package/dist/template-CiOPa2rd.mjs

@@ -0,0 +1,121 @@
+function payloadJson(payload) {
+  if (!payload) return void 0;
+  try {
+    return JSON.parse(payload);
+  } catch {
+    return void 0;
+  }
+}
+function lookupPath(root, path) {
+  let current = root;
+  for (const segment of path) {
+    if (current === null || typeof current !== "object") return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function scalar(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return "";
+  }
+}
+function formatNow(now, tz) {
+  if (!tz) return new Date(now).toISOString();
+  try {
+    const parts = new Intl.DateTimeFormat("en-CA", { timeZone: tz, hourCycle: "h23", year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit", timeZoneName: "longOffset" }).formatToParts(new Date(now));
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    const offset = get("timeZoneName").replace(/^GMT$/, "+00:00").replace(/^GMT/, "");
+    return `${get("year")}-${get("month")}-${get("day")}T${get("hour")}:${get("minute")}:${get("second")}${offset || "Z"}`;
+  } catch {
+    return new Date(now).toISOString();
+  }
+}
+function renderTemplate(text, context) {
+  const json = payloadJson(context.payload);
+  return text.replace(/\{\{\s*([a-zA-Z_][a-zA-Z0-9_.-]*)\s*\}\}/g, (whole, name) => {
+    if (name === "payload") return context.payload ?? "";
+    if (name.startsWith("payload.")) return scalar(lookupPath(json, name.slice("payload.".length).split(".")));
+    if (name === "run.id") return context.runId;
+    if (name === "automation.name") return context.automationName;
+    if (name === "now") return formatNow(context.now ?? Date.now(), context.tz);
+    return whole;
+  });
+}
+function renderAction(action, context) {
+  const r = (value) => renderTemplate(value, context);
+  if (action.kind === "spawn") return { ...action, prompt: r(action.prompt) };
+  if (action.kind === "send") return { ...action, prompt: r(action.prompt) };
+  return { ...action, command: action.command.map(r), ...action.env ? { env: Object.fromEntries(Object.entries(action.env).map(([k, v]) => [k, r(v)])) } : {} };
+}
+function clipText(text, maxChars, keep = "head") {
+  if (text.length <= maxChars) return text;
+  return keep === "head" ? text.slice(0, maxChars) : text.slice(text.length - maxChars);
+}
+const DURATION_UNITS = { ms: 1, s: 1e3, m: 6e4, h: 36e5, d: 864e5 };
+function parseDuration(raw) {
+  const text = raw.trim();
+  if (/^\d+$/.test(text)) return Number(text);
+  const re = /(\d+(?:\.\d+)?)(ms|s|m|h|d)/gy;
+  let total = 0;
+  let matched = 0;
+  let last = 0;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    total += Number(m[1]) * DURATION_UNITS[m[2]];
+    matched++;
+    last = re.lastIndex;
+  }
+  if (matched === 0 || last !== text.length) throw new Error(`Invalid duration: ${raw} (use e.g. 90s, 5m, 1h30m, 2d)`);
+  return Math.round(total);
+}
+function formatDuration(ms) {
+  if (ms % 864e5 === 0) return `${ms / 864e5}d`;
+  if (ms % 36e5 === 0) return `${ms / 36e5}h`;
+  if (ms % 6e4 === 0) return `${ms / 6e4}m`;
+  if (ms % 1e3 === 0) return `${ms / 1e3}s`;
+  return `${ms}ms`;
+}
+function triggerFromFlags(flags, now = Date.now()) {
+  const given = [flags.cron !== void 0, flags.every !== void 0, flags.at !== void 0, flags.manual === true].filter(Boolean).length;
+  if (given === 0) {
+    if (flags.tz !== void 0) throw new Error("--tz only applies with --cron");
+    return void 0;
+  }
+  if (given > 1) throw new Error("Use exactly one of --cron, --every, --at, --manual");
+  if (flags.cron !== void 0) {
+    if (!flags.tz) throw new Error("--cron requires --tz <IANA zone> (e.g. Asia/Singapore)");
+    return { kind: "cron", expr: flags.cron, tz: flags.tz };
+  }
+  if (flags.tz !== void 0) throw new Error("--tz only applies with --cron");
+  if (flags.every !== void 0) return { kind: "interval", everyMs: parseDuration(flags.every), anchorAt: now };
+  if (flags.at !== void 0) {
+    const at = Date.parse(flags.at);
+    if (!Number.isFinite(at)) throw new Error(`--at must be an ISO 8601 timestamp, got: ${flags.at}`);
+    return { kind: "once", at };
+  }
+  return { kind: "manual" };
+}
+function describeTrigger(trigger) {
+  switch (trigger.kind) {
+    case "cron":
+      return `cron ${trigger.expr} (${trigger.tz})`;
+    case "interval":
+      return `every ${formatDuration(trigger.everyMs)}`;
+    case "once":
+      return `once at ${new Date(trigger.at).toISOString()}`;
+    default:
+      return "manual";
+  }
+}
+function describeAction(action) {
+  if (action.kind === "spawn") return `spawn ${action.agent} in ${action.directory}${action.sticky ? ` (sticky ${action.sticky.key})` : ""}`;
+  if (action.kind === "send") return `send to session ${action.sessionId}`;
+  return `script ${action.command.join(" ")}`;
+}
+
+export { describeAction as a, renderTemplate as b, clipText as c, describeTrigger as d, parseDuration as p, renderAction as r, triggerFromFlags as t };

package/dist/{terminalTitleSuggest-DKgX3osW.mjs → terminalTitleSuggest-CeKsX_V6.mjs}

@@ -1,13 +1,5 @@
-import { dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
 import { z } from 'zod';
 
-const __dirname$1 = dirname(fileURLToPath(import.meta.url));
-function projectPath() {
-  const path = resolve(__dirname$1, "..");
-  return path;
-}
-
 const TERMINAL_TITLE_SUGGEST_METHOD = "very-happy/terminal-title-suggest";
 const TerminalTitleSuggestRequestSchema = z.object({
   method: z.literal(TERMINAL_TITLE_SUGGEST_METHOD),
@@ -35,4 +27,4 @@ function piSessionNameFromTitle(title, cwd) {
   return name || void 0;
 }
 
-export { TERMINAL_TITLE_SUGGEST_METHOD as T, TerminalTitleSuggestResultSchema as a, TerminalTitleSuggestRequestSchema as b, piSessionNameFromTitle as c, projectPath as p };
+export { TERMINAL_TITLE_SUGGEST_METHOD as T, TerminalTitleSuggestResultSchema as a, TerminalTitleSuggestRequestSchema as b, piSessionNameFromTitle as p };

package/dist/{terminalTitleSuggest-Dji8I0Jy.cjs → terminalTitleSuggest-DhvRFX3H.cjs}

@@ -1,16 +1,7 @@
 'use strict';
 
-var path = require('path');
-var url = require('url');
 var z = require('zod');
 
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-const __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('terminalTitleSuggest-Dji8I0Jy.cjs', document.baseURI).href))));
-function projectPath() {
-  const path$1 = path.resolve(__dirname$1, "..");
-  return path$1;
-}
-
 const TERMINAL_TITLE_SUGGEST_METHOD = "very-happy/terminal-title-suggest";
 const TerminalTitleSuggestRequestSchema = z.z.object({
   method: z.z.literal(TERMINAL_TITLE_SUGGEST_METHOD),
@@ -42,4 +33,3 @@ exports.TERMINAL_TITLE_SUGGEST_METHOD = TERMINAL_TITLE_SUGGEST_METHOD;
 exports.TerminalTitleSuggestRequestSchema = TerminalTitleSuggestRequestSchema;
 exports.TerminalTitleSuggestResultSchema = TerminalTitleSuggestResultSchema;
 exports.piSessionNameFromTitle = piSessionNameFromTitle;
-exports.projectPath = projectPath;

package/dist/terminals-B_bfC9c2.cjs

@@ -0,0 +1,250 @@
+'use strict';
+
+var os = require('node:os');
+var node_child_process = require('node:child_process');
+var terminalTitleSuggest = require('./terminalTitleSuggest-DhvRFX3H.cjs');
+var tmuxSocket = require('./tmuxSocket-D-Xt6Vn-.cjs');
+
+const USER_SESSION_FIELD_SEP = "<~|~>";
+const USER_SESSIONS_FORMAT = [
+  "#{session_id}",
+  "#{session_name}",
+  "#{session_windows}",
+  "#{session_attached}",
+  "#{session_activity}",
+  "#{session_created}",
+  "#{pane_current_command}",
+  "#{pane_current_path}"
+].join(USER_SESSION_FIELD_SEP);
+const TMUX_SESSION_ID_RE = /^\$\d{1,9}$/;
+const TMUX_SESSION_NAME_MAX = 128;
+function isSafeTmuxSessionName(name) {
+  if (typeof name !== "string") return false;
+  if (name.length === 0 || name.length > TMUX_SESSION_NAME_MAX) return false;
+  return !/[\x00-\x1f\x7f]/.test(name);
+}
+function isVhSessionName(name) {
+  return name.startsWith("vh-");
+}
+function parseUserSessionLine(line) {
+  if (!line) return void 0;
+  const parts = line.split(USER_SESSION_FIELD_SEP);
+  if (parts.length < 8) return void 0;
+  const [id, name, windows, attached, activity, created, command] = parts;
+  if (!TMUX_SESSION_ID_RE.test(id) || !isSafeTmuxSessionName(name)) return void 0;
+  const cwd = parts.slice(7).join(USER_SESSION_FIELD_SEP);
+  const num = (v) => {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : void 0;
+  };
+  return {
+    id,
+    name,
+    windows: Math.max(0, Math.floor(num(windows) ?? 0)),
+    attached: (num(attached) ?? 0) > 0,
+    activityAt: activity ? (num(activity) ?? 0) * 1e3 || void 0 : void 0,
+    createdAt: created ? (num(created) ?? 0) * 1e3 || void 0 : void 0,
+    command: command.trim() || void 0,
+    cwd: cwd || void 0
+  };
+}
+const USER_SESSIONS_MAX = 50;
+function parseUserSessions(stdout, max = USER_SESSIONS_MAX) {
+  const out = [];
+  for (const line of stdout.split("\n")) {
+    const s = parseUserSessionLine(line);
+    if (!s || isVhSessionName(s.name)) continue;
+    out.push(s);
+  }
+  out.sort((a, b) => (b.activityAt ?? 0) - (a.activityAt ?? 0));
+  return out.slice(0, max);
+}
+function attachStartupCommand(sessionId, socket) {
+  if (!TMUX_SESSION_ID_RE.test(sessionId)) throw new Error(`not a tmux session id: ${sessionId}`);
+  const sock = socket ? ` -S ${tmuxSocket.shellescape(socket)}` : "";
+  return ` TMUX= tmux${sock} attach-session -t ${tmuxSocket.shellescape(sessionId)}`;
+}
+
+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]);
+function deriveAutoTitle(paneTitle, hostname, cwd) {
+  if (typeof paneTitle !== "string") return void 0;
+  const t = paneTitle.replace(/^[^\p{L}\p{N}]+/u, "").replace(/\s+/g, " ").trim();
+  if (!t) return void 0;
+  const piName = terminalTitleSuggest.piSessionNameFromTitle(t, cwd);
+  if (piName) {
+    const chars2 = Array.from(piName);
+    return chars2.length > TITLE_MAX_CHARS ? chars2.slice(0, TITLE_MAX_CHARS).join("") : piName;
+  }
+  const lower = t.toLowerCase();
+  const host = (hostname || "").toLowerCase();
+  const shortHost = host.split(".")[0];
+  if (host && (lower === host || lower === shortHost)) return void 0;
+  if (JUNK_TITLES.has(lower)) return void 0;
+  const chars = Array.from(t);
+  return chars.length > TITLE_MAX_CHARS ? chars.slice(0, TITLE_MAX_CHARS).join("") : t;
+}
+const LIST_FIELD_SEP = "<~|~>";
+const LIST_SESSIONS_FORMAT = [
+  "#{session_name}",
+  "#{session_created}",
+  "#{session_activity}",
+  "#{pane_current_path}",
+  "#{@vh_title}",
+  "#{@vh_title_manual}",
+  "#{@vh_tags}",
+  // B-273: the user tmux session this terminal was opened to attach (name),
+  // carried into close records so a restore can re-attach.
+  "#{@vh_attach}",
+  // B-287: the pane's REAL geometry, persisted with the live snapshot so a
+  // cold restore (daemon boot auto-restore, archive ↻) recreates the session
+  // at the size it last had — claude's one-shot welcome banner then never
+  // gets reflowed by the first web open (the "half-drawn logo").
+  "#{pane_width}",
+  "#{pane_height}",
+  // B-121: the control-mode client has no `pty.process`, so the agent-state
+  // fast path lost its live `#{pane_current_command}` equivalent. Carry it in
+  // the ONE list-sessions call the tracker already makes — the value goes
+  // from "live" to "≤ LIST_TRACK_INTERVAL_MS old", which classifyPane
+  // tolerates (its dialog/working judgments come from the pane TEXT; the
+  // command only separates shell/idle). MUST stay before pane_title: that
+  // field is deliberately last so a pathological 0x1f inside a title can only
+  // garble the title, never shift the fields.
+  "#{pane_current_command} #{pane_pid}",
+  "#{pane_title}"
+].join(LIST_FIELD_SEP);
+function parseSessionListLine(line) {
+  if (!line) return void 0;
+  const parts = line.split(LIST_FIELD_SEP);
+  if (parts.length < 12) return void 0;
+  const [name, created, activity, cwd, vhTitle, manual, vhTags, vhAttach, paneW, paneH, paneCommand] = parts;
+  if (!name) return void 0;
+  const geom = parsePositiveInt(paneW) !== void 0 && parsePositiveInt(paneH) !== void 0 ? { paneCols: parsePositiveInt(paneW), paneRows: parsePositiveInt(paneH) } : {};
+  return {
+    name,
+    created: created ? Number(created) * 1e3 : void 0,
+    activity: activity ? Number(activity) * 1e3 : void 0,
+    cwd: cwd || void 0,
+    vhTitle: vhTitle.trim() || void 0,
+    manual: manual.trim().length > 0,
+    tags: parseTerminalTags(vhTags),
+    paneCurrentCommand: paneCommand.trim().replace(/ \d+$/, "") || void 0,
+    .../ (\d+)$/.test(paneCommand) ? { panePid: Number(paneCommand.match(/ (\d+)$/)[1]) } : {},
+    // Verbatim (no trim): tmux allows edge spaces in a session name and the
+    // restore lookup / attach echo compare it exactly.
+    attachTmux: isSafeTmuxSessionName(vhAttach) ? vhAttach : void 0,
+    ...geom,
+    // pane_title is last, so anything after field 11 is title content that
+    // contained the separator — rejoin it rather than dropping it.
+    paneTitle: parts.slice(11).join(LIST_FIELD_SEP) || void 0
+  };
+}
+function parsePositiveInt(raw) {
+  if (raw === void 0 || !/^[0-9]{1,5}$/.test(raw.trim())) return void 0;
+  const n = Number(raw.trim());
+  return n > 0 ? n : void 0;
+}
+const TERMINAL_TAG_MAX_COUNT = 64;
+const TERMINAL_TAG_MAX_LENGTH = 24;
+const TERMINAL_TAGS_MAX_BYTES = 4096;
+function validateTerminalTags(value) {
+  if (!Array.isArray(value) || value.length > TERMINAL_TAG_MAX_COUNT) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const valueTag of value) {
+    if (typeof valueTag !== "string") return void 0;
+    const tag = valueTag.trim().replace(/^#+/, "").trim().replace(/\s+/g, "-").slice(0, TERMINAL_TAG_MAX_LENGTH);
+    if (!tag || tag !== valueTag) return void 0;
+    const key = tag.toLowerCase();
+    if (seen.has(key)) return void 0;
+    seen.add(key);
+    out.push(tag);
+  }
+  if (Buffer.byteLength(JSON.stringify(out), "utf8") > TERMINAL_TAGS_MAX_BYTES) return void 0;
+  return out;
+}
+function parseTerminalTags(raw) {
+  if (typeof raw !== "string" || !raw.trim()) return [];
+  try {
+    return validateTerminalTags(JSON.parse(raw)) ?? [];
+  } catch {
+    return [];
+  }
+}
+
+const TMUX_TIMEOUT_MS = 3e3;
+const VH_LIST_SESSIONS_FORMAT = LIST_SESSIONS_FORMAT;
+function parseVhTerminals(stdout, hostname = os.hostname()) {
+  const out = [];
+  for (const line of stdout.split("\n")) {
+    const s = parseSessionListLine(line);
+    if (!s || !s.name.startsWith("vh-")) continue;
+    out.push({
+      id: s.name.slice(3),
+      title: s.vhTitle ?? deriveAutoTitle(s.paneTitle, hostname, s.cwd),
+      cwd: s.cwd,
+      createdAt: s.created,
+      activityAt: s.activity
+    });
+  }
+  return out;
+}
+function runTmux(args, input) {
+  try {
+    const r = node_child_process.spawnSync("tmux", tmuxSocket.tmuxArgs(args), {
+      encoding: "utf8",
+      timeout: TMUX_TIMEOUT_MS,
+      input,
+      env: tmuxSocket.scrubTmuxClientEnv({ ...process.env })
+    });
+    if (r.error) return { ok: false, stdout: "", error: r.error.message };
+    if (r.status !== 0) return { ok: false, stdout: r.stdout ?? "", error: (r.stderr || `tmux exited with ${r.status}`).trim() };
+    return { ok: true, stdout: r.stdout ?? "" };
+  } catch (error) {
+    return { ok: false, stdout: "", error: error instanceof Error ? error.message : String(error) };
+  }
+}
+function listVhTerminals() {
+  const r = runTmux(["list-sessions", "-F", VH_LIST_SESSIONS_FORMAT]);
+  if (!r.ok) {
+    if ((r.error ?? "").includes("no server running")) return { ok: true, terminals: [] };
+    return { ok: false, terminals: [], error: r.error };
+  }
+  return { ok: true, terminals: parseVhTerminals(r.stdout) };
+}
+function target(terminalId) {
+  return `=vh-${terminalId}:`;
+}
+function readVhTerminal(terminalId, lines) {
+  const n = Math.max(1, Math.min(2e3, Math.floor(lines)));
+  const r = runTmux(["capture-pane", "-p", "-t", target(terminalId), "-S", `-${n}`]);
+  return { ok: r.ok, text: r.stdout, error: r.error };
+}
+const PASTE_BUFFER_NAME = "vh-assistant-paste";
+function sendToVhTerminal(terminalId, text, submit) {
+  const load = runTmux(["load-buffer", "-b", PASTE_BUFFER_NAME, "-"], text);
+  if (!load.ok) return { ok: false, error: `load-buffer failed: ${load.error}` };
+  const paste = runTmux(["paste-buffer", "-p", "-d", "-b", PASTE_BUFFER_NAME, "-t", target(terminalId)]);
+  if (!paste.ok) return { ok: false, error: `paste-buffer failed: ${paste.error}` };
+  if (submit) {
+    const enter = runTmux(["send-keys", "-t", target(terminalId), "Enter"]);
+    if (!enter.ok) return { ok: false, error: `send-keys Enter failed: ${enter.error}` };
+  }
+  return { ok: true };
+}
+
+exports.LIST_FIELD_SEP = LIST_FIELD_SEP;
+exports.LIST_SESSIONS_FORMAT = LIST_SESSIONS_FORMAT;
+exports.TMUX_SESSION_ID_RE = TMUX_SESSION_ID_RE;
+exports.USER_SESSIONS_FORMAT = USER_SESSIONS_FORMAT;
+exports.attachStartupCommand = attachStartupCommand;
+exports.deriveAutoTitle = deriveAutoTitle;
+exports.isSafeTmuxSessionName = isSafeTmuxSessionName;
+exports.isVhSessionName = isVhSessionName;
+exports.listVhTerminals = listVhTerminals;
+exports.parseSessionListLine = parseSessionListLine;
+exports.parseUserSessions = parseUserSessions;
+exports.readVhTerminal = readVhTerminal;
+exports.sendToVhTerminal = sendToVhTerminal;
+exports.validateTerminalTags = validateTerminalTags;