very-happy-cli 0.2.159 → 0.2.161

package/dist/terminals-Dlg0x3nY.mjs

@@ -0,0 +1,235 @@
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { p as piSessionNameFromTitle } from './terminalTitleSuggest-CeKsX_V6.mjs';
+import { s as shellescape, t as tmuxArgs, a as scrubTmuxClientEnv } from './tmuxSocket-B8Yx20sT.mjs';
+
+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 ${shellescape(socket)}` : "";
+  return ` TMUX= tmux${sock} attach-session -t ${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 = 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 = spawnSync("tmux", tmuxArgs(args), {
+      encoding: "utf8",
+      timeout: TMUX_TIMEOUT_MS,
+      input,
+      env: 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 };
+}
+
+export { LIST_SESSIONS_FORMAT as L, TMUX_SESSION_ID_RE as T, USER_SESSIONS_FORMAT as U, attachStartupCommand as a, isVhSessionName as b, parseSessionListLine as c, deriveAutoTitle as d, LIST_FIELD_SEP as e, isSafeTmuxSessionName as i, listVhTerminals as l, parseUserSessions as p, readVhTerminal as r, sendToVhTerminal as s, validateTerminalTags as v };

package/dist/time-BZNdNiIV.mjs

@@ -0,0 +1,38 @@
+import { l as logger } from './logger-fXoNzNuB.mjs';
+
+async function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function exponentialBackoffDelay(currentFailureCount, minDelay, maxDelay, maxFailureCount) {
+  let maxDelayRet = minDelay + (maxDelay - minDelay) / maxFailureCount * Math.min(currentFailureCount, maxFailureCount);
+  return Math.round(Math.random() * maxDelayRet);
+}
+function createBackoff(opts) {
+  return async (callback) => {
+    let currentFailureCount = 0;
+    const minDelay = opts && opts.minDelay !== void 0 ? opts.minDelay : 250;
+    const maxDelay = opts && opts.maxDelay !== void 0 ? opts.maxDelay : 1e3;
+    const maxFailureCount = opts && opts.maxFailureCount !== void 0 ? opts.maxFailureCount : 50;
+    while (true) {
+      try {
+        return await callback();
+      } catch (e) {
+        if (currentFailureCount < maxFailureCount) {
+          currentFailureCount++;
+        }
+        if (opts && opts.onError) {
+          opts.onError(e, currentFailureCount);
+        }
+        let waitForRequest = exponentialBackoffDelay(currentFailureCount, minDelay, maxDelay, maxFailureCount);
+        await delay(waitForRequest);
+      }
+    }
+  };
+}
+let backoff = createBackoff({
+  onError: (e, failuresCount) => {
+    logger.debug(`[BACKOFF] retry ${failuresCount}:`, e?.message || e);
+  }
+});
+
+export { backoff as b, delay as d, exponentialBackoffDelay as e };

package/dist/time-CNRE4ChD.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var logger = require('./logger-Bc8-u1w0.cjs');
+
+async function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function exponentialBackoffDelay(currentFailureCount, minDelay, maxDelay, maxFailureCount) {
+  let maxDelayRet = minDelay + (maxDelay - minDelay) / maxFailureCount * Math.min(currentFailureCount, maxFailureCount);
+  return Math.round(Math.random() * maxDelayRet);
+}
+function createBackoff(opts) {
+  return async (callback) => {
+    let currentFailureCount = 0;
+    const minDelay = opts && opts.minDelay !== void 0 ? opts.minDelay : 250;
+    const maxDelay = opts && opts.maxDelay !== void 0 ? opts.maxDelay : 1e3;
+    const maxFailureCount = opts && opts.maxFailureCount !== void 0 ? opts.maxFailureCount : 50;
+    while (true) {
+      try {
+        return await callback();
+      } catch (e) {
+        if (currentFailureCount < maxFailureCount) {
+          currentFailureCount++;
+        }
+        if (opts && opts.onError) {
+          opts.onError(e, currentFailureCount);
+        }
+        let waitForRequest = exponentialBackoffDelay(currentFailureCount, minDelay, maxDelay, maxFailureCount);
+        await delay(waitForRequest);
+      }
+    }
+  };
+}
+let backoff = createBackoff({
+  onError: (e, failuresCount) => {
+    logger.logger.debug(`[BACKOFF] retry ${failuresCount}:`, e?.message || e);
+  }
+});
+
+exports.backoff = backoff;
+exports.delay = delay;
+exports.exponentialBackoffDelay = exponentialBackoffDelay;

package/dist/titleGenerator-CFRhU-xq.cjs

@@ -0,0 +1,172 @@
+'use strict';
+
+var node_child_process = require('node:child_process');
+var module$1 = require('node:module');
+var oneShotPrompts = require('./oneShotPrompts-CL0dip9C.cjs');
+var node_crypto = require('node:crypto');
+var path = require('node:path');
+var logger = require('./logger-Bc8-u1w0.cjs');
+var projectPath = require('./projectPath-ChLhdOyt.cjs');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+const MAX_PROMPT_SAMPLE_CHARS = 500;
+const MAX_TITLE_CHARS = 60;
+const GENERATION_TIMEOUT_MS = 3e4;
+function resolveClaudeBinary() {
+  try {
+    const require$1 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('titleGenerator-CFRhU-xq.cjs', document.baseURI).href)));
+    const utilsPath = path.resolve(path.join(projectPath.projectPath(), "scripts", "claude_version_utils.cjs"));
+    const { getClaudeCliPath } = require$1(utilsPath);
+    const path$1 = getClaudeCliPath();
+    if (typeof path$1 === "string" && path$1.length > 0) return path$1;
+  } catch (error) {
+    logger.logger.debug("[titleGenerator] getClaudeCliPath failed; falling back to PATH", { error: String(error) });
+  }
+  return process.env.HAPPY_CLAUDE_PATH || "claude";
+}
+function buildPrompt(firstUserMessage) {
+  const sample = firstUserMessage.slice(0, MAX_PROMPT_SAMPLE_CHARS);
+  return `${oneShotPrompts.TITLE_PROMPT_PREFIX} (match the message's language). Be concrete \u2014 name the actual task/subject. Do NOT output generic placeholders like "\u65B0\u5BF9\u8BDD"/"New chat"/"Conversation"/"Untitled". No quotes, no trailing punctuation. Reply with ONLY the title.
+
+Message: "${sample}"`;
+}
+const GENERIC_TITLES = /* @__PURE__ */ new Set([
+  "new chat",
+  "new conversation",
+  "conversation",
+  "chat",
+  "untitled",
+  "new session",
+  "\u65B0\u5BF9\u8BDD",
+  "\u65B0\u4F1A\u8BDD",
+  "\u5BF9\u8BDD",
+  "\u4F1A\u8BDD",
+  "\u804A\u5929",
+  "\u672A\u547D\u540D"
+]);
+function sanitizeTitle(raw) {
+  let title = raw.trim();
+  if (!title) return null;
+  const firstLine = title.split(/\r?\n/).map((l) => l.trim()).find((l) => l.length > 0);
+  if (!firstLine) return null;
+  title = firstLine;
+  title = title.replace(/^["'`]+/, "").replace(/["'`]+$/, "").trim();
+  title = title.replace(/[.。!?！？,，:：;；]+$/, "").trim();
+  if (!title) return null;
+  if (title.length > MAX_TITLE_CHARS) {
+    title = title.slice(0, MAX_TITLE_CHARS).trim();
+  }
+  if (!title) return null;
+  if (GENERIC_TITLES.has(title.toLowerCase().replace(/\s+/g, " ").trim())) return null;
+  return title;
+}
+function runClaudeOneShot(binary, prompt) {
+  return new Promise((resolve2) => {
+    let settled = false;
+    const done = (value) => {
+      if (settled) return;
+      settled = true;
+      resolve2(value);
+    };
+    let child;
+    try {
+      child = node_child_process.spawn(binary, ["-p", "--model", "haiku", prompt], {
+        stdio: ["ignore", "pipe", "ignore"],
+        // HAPPY_MANAGED=1: this claude is run BY happy. The user-wide
+        // terminal-mirror SessionStart hook exits on it, so a one-shot
+        // spawned from inside a vh web terminal (VH_TERMINAL_ID
+        // inherited — B-500's pi terminal bridge, or `very-happy` typed
+        // in a terminal) never binds a mirror session to itself.
+        env: { ...process.env, HAPPY_MANAGED: "1" }
+      });
+    } catch (error) {
+      logger.logger.debug("[titleGenerator] spawn failed", { error: String(error) });
+      done(null);
+      return;
+    }
+    const timer = setTimeout(() => {
+      logger.logger.debug("[titleGenerator] generation timed out, killing claude one-shot");
+      try {
+        child.kill("SIGKILL");
+      } catch {
+      }
+      done(null);
+    }, GENERATION_TIMEOUT_MS);
+    let stdout = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf8");
+    });
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      logger.logger.debug("[titleGenerator] claude one-shot error", { error: String(error) });
+      done(null);
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (code !== 0) {
+        logger.logger.debug(`[titleGenerator] claude one-shot exited with code ${code}`);
+        done(null);
+        return;
+      }
+      done(stdout);
+    });
+  });
+}
+async function suggestTitleForPrompt(prompt) {
+  const binary = resolveClaudeBinary();
+  if (!binary) {
+    logger.logger.debug("[titleGenerator] no claude binary; skipping auto-title");
+    return null;
+  }
+  const stdout = await runClaudeOneShot(binary, buildPrompt(prompt));
+  if (stdout == null) return null;
+  const title = sanitizeTitle(stdout);
+  if (!title) logger.logger.debug("[titleGenerator] empty/unusable title output; skipping");
+  return title;
+}
+class TitleGenerator {
+  constructor(session) {
+    this.session = session;
+  }
+  triggered = false;
+  /**
+   * Fire-and-forget. Returns immediately. Safe to call on every user
+   * message; only the first call on a session without an existing summary
+   * does anything.
+   */
+  maybeGenerate(firstUserMessage) {
+    if (this.triggered) return;
+    if (!firstUserMessage || firstUserMessage.trim().length === 0) return;
+    if (this.session.getMetadata()?.summary?.text) {
+      this.triggered = true;
+      return;
+    }
+    this.triggered = true;
+    void this.generate(firstUserMessage).catch((error) => {
+      logger.logger.debug("[titleGenerator] generation rejected", { error: String(error) });
+    });
+  }
+  async generate(firstUserMessage) {
+    if (this.session.getMetadata()?.summary?.text) {
+      logger.logger.debug("[titleGenerator] summary appeared before generation; skipping");
+      return;
+    }
+    const title = await suggestTitleForPrompt(firstUserMessage);
+    if (!title) return;
+    if (this.session.getMetadata()?.summary?.text) {
+      logger.logger.debug("[titleGenerator] summary set during generation; not overwriting");
+      return;
+    }
+    logger.logger.debug(`[titleGenerator] setting auto-title: ${title}`);
+    this.session.sendClaudeSessionMessage({
+      type: "summary",
+      summary: title,
+      leafUuid: node_crypto.randomUUID()
+    });
+  }
+}
+
+exports.TitleGenerator = TitleGenerator;
+exports.resolveClaudeBinary = resolveClaudeBinary;
+exports.runClaudeOneShot = runClaudeOneShot;
+exports.suggestTitleForPrompt = suggestTitleForPrompt;

package/dist/titleGenerator-ox6ptCsp.mjs

@@ -0,0 +1,166 @@
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { T as TITLE_PROMPT_PREFIX } from './oneShotPrompts-DT4p6RNd.mjs';
+import { randomUUID } from 'node:crypto';
+import { resolve, join } from 'node:path';
+import { l as logger } from './logger-fXoNzNuB.mjs';
+import { p as projectPath } from './projectPath-BTBIMB57.mjs';
+
+const MAX_PROMPT_SAMPLE_CHARS = 500;
+const MAX_TITLE_CHARS = 60;
+const GENERATION_TIMEOUT_MS = 3e4;
+function resolveClaudeBinary() {
+  try {
+    const require = createRequire(import.meta.url);
+    const utilsPath = resolve(join(projectPath(), "scripts", "claude_version_utils.cjs"));
+    const { getClaudeCliPath } = require(utilsPath);
+    const path = getClaudeCliPath();
+    if (typeof path === "string" && path.length > 0) return path;
+  } catch (error) {
+    logger.debug("[titleGenerator] getClaudeCliPath failed; falling back to PATH", { error: String(error) });
+  }
+  return process.env.HAPPY_CLAUDE_PATH || "claude";
+}
+function buildPrompt(firstUserMessage) {
+  const sample = firstUserMessage.slice(0, MAX_PROMPT_SAMPLE_CHARS);
+  return `${TITLE_PROMPT_PREFIX} (match the message's language). Be concrete \u2014 name the actual task/subject. Do NOT output generic placeholders like "\u65B0\u5BF9\u8BDD"/"New chat"/"Conversation"/"Untitled". No quotes, no trailing punctuation. Reply with ONLY the title.
+
+Message: "${sample}"`;
+}
+const GENERIC_TITLES = /* @__PURE__ */ new Set([
+  "new chat",
+  "new conversation",
+  "conversation",
+  "chat",
+  "untitled",
+  "new session",
+  "\u65B0\u5BF9\u8BDD",
+  "\u65B0\u4F1A\u8BDD",
+  "\u5BF9\u8BDD",
+  "\u4F1A\u8BDD",
+  "\u804A\u5929",
+  "\u672A\u547D\u540D"
+]);
+function sanitizeTitle(raw) {
+  let title = raw.trim();
+  if (!title) return null;
+  const firstLine = title.split(/\r?\n/).map((l) => l.trim()).find((l) => l.length > 0);
+  if (!firstLine) return null;
+  title = firstLine;
+  title = title.replace(/^["'`]+/, "").replace(/["'`]+$/, "").trim();
+  title = title.replace(/[.。!?！？,，:：;；]+$/, "").trim();
+  if (!title) return null;
+  if (title.length > MAX_TITLE_CHARS) {
+    title = title.slice(0, MAX_TITLE_CHARS).trim();
+  }
+  if (!title) return null;
+  if (GENERIC_TITLES.has(title.toLowerCase().replace(/\s+/g, " ").trim())) return null;
+  return title;
+}
+function runClaudeOneShot(binary, prompt) {
+  return new Promise((resolve2) => {
+    let settled = false;
+    const done = (value) => {
+      if (settled) return;
+      settled = true;
+      resolve2(value);
+    };
+    let child;
+    try {
+      child = spawn(binary, ["-p", "--model", "haiku", prompt], {
+        stdio: ["ignore", "pipe", "ignore"],
+        // HAPPY_MANAGED=1: this claude is run BY happy. The user-wide
+        // terminal-mirror SessionStart hook exits on it, so a one-shot
+        // spawned from inside a vh web terminal (VH_TERMINAL_ID
+        // inherited — B-500's pi terminal bridge, or `very-happy` typed
+        // in a terminal) never binds a mirror session to itself.
+        env: { ...process.env, HAPPY_MANAGED: "1" }
+      });
+    } catch (error) {
+      logger.debug("[titleGenerator] spawn failed", { error: String(error) });
+      done(null);
+      return;
+    }
+    const timer = setTimeout(() => {
+      logger.debug("[titleGenerator] generation timed out, killing claude one-shot");
+      try {
+        child.kill("SIGKILL");
+      } catch {
+      }
+      done(null);
+    }, GENERATION_TIMEOUT_MS);
+    let stdout = "";
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk.toString("utf8");
+    });
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      logger.debug("[titleGenerator] claude one-shot error", { error: String(error) });
+      done(null);
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (code !== 0) {
+        logger.debug(`[titleGenerator] claude one-shot exited with code ${code}`);
+        done(null);
+        return;
+      }
+      done(stdout);
+    });
+  });
+}
+async function suggestTitleForPrompt(prompt) {
+  const binary = resolveClaudeBinary();
+  if (!binary) {
+    logger.debug("[titleGenerator] no claude binary; skipping auto-title");
+    return null;
+  }
+  const stdout = await runClaudeOneShot(binary, buildPrompt(prompt));
+  if (stdout == null) return null;
+  const title = sanitizeTitle(stdout);
+  if (!title) logger.debug("[titleGenerator] empty/unusable title output; skipping");
+  return title;
+}
+class TitleGenerator {
+  constructor(session) {
+    this.session = session;
+  }
+  triggered = false;
+  /**
+   * Fire-and-forget. Returns immediately. Safe to call on every user
+   * message; only the first call on a session without an existing summary
+   * does anything.
+   */
+  maybeGenerate(firstUserMessage) {
+    if (this.triggered) return;
+    if (!firstUserMessage || firstUserMessage.trim().length === 0) return;
+    if (this.session.getMetadata()?.summary?.text) {
+      this.triggered = true;
+      return;
+    }
+    this.triggered = true;
+    void this.generate(firstUserMessage).catch((error) => {
+      logger.debug("[titleGenerator] generation rejected", { error: String(error) });
+    });
+  }
+  async generate(firstUserMessage) {
+    if (this.session.getMetadata()?.summary?.text) {
+      logger.debug("[titleGenerator] summary appeared before generation; skipping");
+      return;
+    }
+    const title = await suggestTitleForPrompt(firstUserMessage);
+    if (!title) return;
+    if (this.session.getMetadata()?.summary?.text) {
+      logger.debug("[titleGenerator] summary set during generation; not overwriting");
+      return;
+    }
+    logger.debug(`[titleGenerator] setting auto-title: ${title}`);
+    this.session.sendClaudeSessionMessage({
+      type: "summary",
+      summary: title,
+      leafUuid: randomUUID()
+    });
+  }
+}
+
+export { TitleGenerator as T, runClaudeOneShot as a, resolveClaudeBinary as r, suggestTitleForPrompt as s };

package/dist/tmuxSocket-B8Yx20sT.mjs

@@ -0,0 +1,19 @@
+function shellescape(s) {
+  return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+
+const VH_TMUX_SOCKET_ENV = "VH_TMUX_SOCKET";
+function tmuxSocketFlags(env = process.env) {
+  const socket = env[VH_TMUX_SOCKET_ENV];
+  return socket ? ["-S", socket] : [];
+}
+function tmuxArgs(args, env = process.env) {
+  return [...tmuxSocketFlags(env), ...args];
+}
+function scrubTmuxClientEnv(env) {
+  delete env.TMUX;
+  delete env.TMUX_PANE;
+  return env;
+}
+
+export { VH_TMUX_SOCKET_ENV as V, scrubTmuxClientEnv as a, shellescape as s, tmuxArgs as t };