very-happy-cli 0.2.108 → 0.2.110

package/dist/{AcpBackend-D4vV6SVl.cjs → AcpBackend-D0_wbTs6.cjs}

@@ -3,7 +3,7 @@
 var node_child_process = require('node:child_process');
 var sdk = require('@agentclientprotocol/sdk');
 var node_crypto = require('node:crypto');
-var persistence = require('./types-D4bwyM-D.cjs');
+var persistence = require('./types--t4zLibT.cjs');
 
 const DEFAULT_TIMEOUTS = {
   /** Default initialization timeout: 60 seconds */

package/dist/{AcpBackend-DwR8rrkS.mjs → AcpBackend-DzZR7TEv.mjs}

@@ -1,7 +1,7 @@
 import { spawn } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { randomUUID } from 'node:crypto';
-import { l as logger, d as contentLogMetadata, e as errorLogMetadata, f as packageJson, g as delay } from './types-D0-nhvuW.mjs';
+import { l as logger, d as contentLogMetadata, e as errorLogMetadata, f as packageJson, g as delay } from './types-BdO0jg7G.mjs';
 
 const DEFAULT_TIMEOUTS = {
   /** Default initialization timeout: 60 seconds */

package/dist/{AcpSessionManager-CPHDZ-nz.cjs → AcpSessionManager-Dcj_iHw8.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var cuid2 = require('@paralleldrive/cuid2');
-var persistence = require('./types-D4bwyM-D.cjs');
+var persistence = require('./types--t4zLibT.cjs');
 
 function turnOptions(turnId, time) {
   return turnId ? { turn: turnId, time } : { time };

package/dist/{AcpSessionManager-C057dkLF.mjs → AcpSessionManager-tWuFWeIF.mjs}

@@ -1,5 +1,5 @@
 import { createId } from '@paralleldrive/cuid2';
-import { b as createEnvelope } from './types-D0-nhvuW.mjs';
+import { b as createEnvelope } from './types-BdO0jg7G.mjs';
 
 function turnOptions(turnId, time) {
   return turnId ? { turn: turnId, time } : { time };

package/dist/{config-BvVwprR0.cjs → config-CTCGilz_.cjs}

@@ -4,8 +4,8 @@ var fs = require('fs');
 var path = require('path');
 var os = require('os');
 var child_process = require('child_process');
-var persistence = require('./types-D4bwyM-D.cjs');
-var index = require('./index-DM0Ku1Rv.cjs');
+var persistence = require('./types--t4zLibT.cjs');
+var index = require('./index-CvnMiYgh.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/{config-DKMwLc1k.mjs → config-CTyyVXHj.mjs}

@@ -2,8 +2,8 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
 import { execSync } from 'child_process';
-import { l as logger } from './types-D0-nhvuW.mjs';
-import { D as DEFAULT_GEMINI_MODEL, G as GEMINI_MODEL_ENV } from './index-CzSv4d_S.mjs';
+import { l as logger } from './types-BdO0jg7G.mjs';
+import { f as DEFAULT_GEMINI_MODEL, G as GEMINI_MODEL_ENV } from './index-BW9kDx5m.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{index-CzSv4d_S.mjs → index-BW9kDx5m.mjs}

@@ -1,7 +1,7 @@
 import{createRequire as _pkgrollCR}from"node:module";const require=_pkgrollCR(import.meta.url);import chalk from 'chalk';
 import os, { homedir, userInfo } from 'node:os';
 import { randomUUID, randomBytes, createHash as createHash$1, timingSafeEqual } from 'node:crypto';
-import { n as readDaemonState, l as logger, c as configuration, o as clearDaemonState, q as getProjectPath, p as projectPath, s as initializeSandbox, t as wrapCommand, d as contentLogMetadata, I as InvalidateSync, R as RawJSONLinesSchema, g as delay, u as AsyncLock, v as ensurePrivateDirectory, M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES, x as hardenPrivateFile, f as packageJson, i as readSettings, y as readCredentials, z as credentialRelayProblem, B as deriveLocalCliUpdateSummary, j as encodeBase64, C as updateSettings, D as encodeBase64Url, E as decodeBase64, F as writeCredentialsLegacy, G as writeCredentialsDataKey, H as readCredentialsForConfiguredRelay, J as encrypt, r as readPersistedSessions, K as isClaudeSessionId, L as getLocalHappyAgentCredentialPath, N as readLocalHappyAgentCredentials, O as decryptWithDataKey, P as decryptLegacy, Q as extractCompleteLines, S as decideBackfill, T as parseTerminalHookPayload, U as tmuxArgs, V as scrubTmuxClientEnv, W as decideMirrorBinding, X as MIRROR_BACKFILL_LINES_DEFAULT, Y as persistSession, Z as mirrorLineKey, _ as mirrorLocalId, w as writePrivateFileSync, $ as detectResumeSupport, a0 as detectCLIAvailability, a1 as acquireDaemonLock, a2 as summarizeSpawnSessionForLog, a3 as deletePersistedSessions, a4 as shellescape, a5 as decrypt, a6 as writeDaemonState, A as ApiClient, a7 as writeSettings, a8 as fetchCliUpdateState, a9 as resolveCliUpdateCheckInterval, aa as DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS, ab as releaseDaemonLock, ac as isValidSessionId, ad as listVhTerminals, ae as isValidTerminalId, af as readVhTerminal, ag as sendToVhTerminal, ah as TITLE_PROMPT_PREFIX, ai as BOARD_ANALYZER_PROMPT_PREFIX, h as connectionState, aj as startOfflineReconnection, ak as clearCredentials, al as clearMachineId, k as ensurePrivateDirectorySync, am as SandboxConfigSchema, b as createEnvelope, an as CodexAppServerClient, ao as getLatestDaemonLog } from './types-D0-nhvuW.mjs';
+import { o as readDaemonState, l as logger, c as configuration, q as clearDaemonState, s as getProjectPath, p as projectPath, t as initializeSandbox, u as wrapCommand, d as contentLogMetadata, I as InvalidateSync, R as RawJSONLinesSchema, g as delay, v as AsyncLock, x as ensurePrivateDirectory, M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES, y as hardenPrivateFile, f as packageJson, j as readSettings, z as readCredentials, B as credentialRelayProblem, C as deriveLocalCliUpdateSummary, k as encodeBase64, D as updateSettings, E as encodeBase64Url, F as decodeBase64, G as writeCredentialsLegacy, H as writeCredentialsDataKey, J as readCredentialsForConfiguredRelay, K as encrypt, r as readPersistedSessions, L as isClaudeSessionId, N as getLocalHappyAgentCredentialPath, O as readLocalHappyAgentCredentials, P as decryptWithDataKey, Q as decryptLegacy, S as extractCompleteLines, T as decideBackfill, U as parseTerminalHookPayload, V as tmuxArgs, W as scrubTmuxClientEnv, X as decideMirrorBinding, Y as MIRROR_BACKFILL_LINES_DEFAULT, Z as persistSession, _ as mirrorLineKey, $ as mirrorLocalId, w as writePrivateFileSync, a0 as detectResumeSupport, a1 as detectCLIAvailability, a2 as acquireDaemonLock, a3 as summarizeSpawnSessionForLog, a4 as deletePersistedSessions, a5 as shellescape, a6 as decrypt, a7 as writeDaemonState, A as ApiClient, a8 as writeSettings, a9 as fetchCliUpdateState, aa as resolveCliUpdateCheckInterval, ab as DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS, ac as releaseDaemonLock, i as isValidSessionId, ad as listVhTerminals, ae as isValidTerminalId, af as readVhTerminal, ag as sendToVhTerminal, ah as TITLE_PROMPT_PREFIX, ai as BOARD_ANALYZER_PROMPT_PREFIX, h as connectionState, aj as startOfflineReconnection, ak as clearCredentials, al as clearMachineId, m as ensurePrivateDirectorySync, am as SandboxConfigSchema, b as createEnvelope, an as CodexAppServerClient, ao as getLatestDaemonLog } from './types-BdO0jg7G.mjs';
 import spawn$1, { spawn } from 'cross-spawn';
 import path, { join, resolve, basename, delimiter, isAbsolute, normalize, sep, dirname } from 'node:path';
 import { createInterface } from 'node:readline';
@@ -4422,16 +4422,23 @@ function claudeModeHash(mode) {
   });
 }
 
-function assistantSpawnTags(env = process.env) {
-  if (env.HAPPY_SPAWNED_BY !== "assistant") return void 0;
+const SPAWN_ORIGIN_TAG_MAX = 24;
+function spawnOriginTags(env = process.env) {
   if (env.HAPPY_SESSION_VARIANT === "assistant") return void 0;
-  return ["assistant"];
+  const origin = (env.HAPPY_SPAWNED_BY ?? "").trim();
+  if (!origin) return void 0;
+  if (origin.length > SPAWN_ORIGIN_TAG_MAX) return void 0;
+  if (!/^[a-z0-9][a-z0-9_-]*$/.test(origin)) return void 0;
+  return [origin];
+}
+function isValidSpawnOrigin(value) {
+  return spawnOriginTags({ HAPPY_SPAWNED_BY: value }) !== void 0;
 }
 function createSessionMetadata(opts) {
   const state = {
     controlledByUser: false
   };
-  const assistantTags = assistantSpawnTags();
+  const originTags = spawnOriginTags();
   const metadata = {
     path: process.cwd(),
     host: os.hostname(),
@@ -4452,10 +4459,10 @@ function createSessionMetadata(opts) {
     dangerouslySkipPermissions: opts.dangerouslySkipPermissions ?? null,
     ...opts.parentSessionId ? { parentSessionId: opts.parentSessionId } : {},
     ...opts.forkedFromMessageId ? { forkedFromMessageId: opts.forkedFromMessageId } : {},
-    // B-091: assistant-dispatched sessions carry the 'assistant' tag from
-    // birth (see assistantSpawnTags) — applies to every flavor the daemon
+    // B-091/B-303: dispatched sessions carry their spawn origin as a tag
+    // from birth (see spawnOriginTags) — applies to every flavor the daemon
     // can spawn, since HAPPY_SPAWNED_BY is exported flavor-independently.
-    ...assistantTags ? { tags: assistantTags } : {}
+    ...originTags ? { tags: originTags } : {}
   };
   return { state, metadata };
 }
@@ -7416,12 +7423,38 @@ function createMirrorScanner(opts) {
   };
 }
 
+const PENDING_CREATE_BACKOFF_MS = [1e4, 3e4, 6e4, 12e4, 3e5];
+const PENDING_CREATE_MAX_AGE_MS = 30 * 6e4;
+function backoffForAttempt(attempts) {
+  const index = Math.min(Math.max(attempts, 1), PENDING_CREATE_BACKOFF_MS.length) - 1;
+  return PENDING_CREATE_BACKOFF_MS[index];
+}
+function pendingCreateAfterFailure(previous, event, now) {
+  const sameConversation = previous?.event.claudeSessionId === event.claudeSessionId;
+  const attempts = sameConversation ? previous.attempts + 1 : 1;
+  return {
+    event,
+    attempts,
+    firstFailedAt: sameConversation ? previous.firstFailedAt : now,
+    nextAttemptAt: now + backoffForAttempt(attempts)
+  };
+}
+function planPendingCreate(pending, now) {
+  if (now - pending.firstFailedAt >= PENDING_CREATE_MAX_AGE_MS) return "drop";
+  return now >= pending.nextAttemptAt ? "retry" : "wait";
+}
+function pendingCreateSupersededBy(pending, event) {
+  if (event.event === "SessionStart") return true;
+  return pending.event.claudeSessionId === event.claudeSessionId;
+}
+
 const TERMINAL_MIRROR_FLAVOR = "terminal-mirror";
 const RECONCILE_HYSTERESIS_MS = 2e4;
 function createMirrorManager(deps) {
   const backfillLines = deps.backfillLines ?? MIRROR_BACKFILL_LINES_DEFAULT;
   const bindings = /* @__PURE__ */ new Map();
   const lastEndedAt = /* @__PURE__ */ new Map();
+  const pendingCreates = /* @__PURE__ */ new Map();
   let chain = Promise.resolve();
   const reactivate = async (binding) => {
     try {
@@ -7581,6 +7614,14 @@ function createMirrorManager(deps) {
     logger.debug(`[MIRROR] reconcile reactivated (in place) terminal ${binding.terminalId}`);
     deps.onBindingsChanged?.();
   };
+  const parkFailedCreate = (event, reason) => {
+    const pending = pendingCreateAfterFailure(pendingCreates.get(event.terminalId), event, Date.now());
+    pendingCreates.set(event.terminalId, pending);
+    logger.debug(
+      `[MIRROR] mirror bind failed for terminal ${event.terminalId} (attempt ${pending.attempts}, retrying):`,
+      reason
+    );
+  };
   const createBinding = async (event, replaces) => {
     if (replaces) {
       await teardownBinding(replaces, "superseded by a fresh conversation");
@@ -7602,11 +7643,18 @@ function createMirrorManager(deps) {
       terminalId: event.terminalId,
       claudeSessionId: event.claudeSessionId
     };
-    const response = await deps.api.getOrCreateSession({ tag: randomUUID(), metadata, state: {} });
+    let response = null;
+    try {
+      response = await deps.api.getOrCreateSession({ tag: randomUUID(), metadata, state: {} });
+    } catch (error) {
+      parkFailedCreate(event, error);
+      return;
+    }
     if (!response) {
-      logger.debug(`[MIRROR] server unreachable \u2014 dropping mirror bind for terminal ${event.terminalId}`);
+      parkFailedCreate(event, "server unreachable");
       return;
     }
+    pendingCreates.delete(event.terminalId);
     const client = deps.api.sessionSyncClient(response);
     client.skipExistingMessages();
     const binding = {
@@ -7662,6 +7710,8 @@ function createMirrorManager(deps) {
     logger.debug(`[MIRROR] terminal ${binding.terminalId} mirror continues as claude ${event.claudeSessionId}`);
   };
   const handleEvent = async (event) => {
+    const parked = pendingCreates.get(event.terminalId);
+    if (parked && pendingCreateSupersededBy(parked, event)) pendingCreates.delete(event.terminalId);
     const binding = bindings.get(event.terminalId) ?? null;
     const decision = decideMirrorBinding(
       event,
@@ -7694,6 +7744,7 @@ function createMirrorManager(deps) {
       });
     },
     onTerminalClosed(terminalId) {
+      pendingCreates.delete(terminalId);
       const binding = bindings.get(terminalId);
       if (!binding) return;
       chain = chain.then(() => teardownBinding(binding, "terminal closed")).catch((error) => {
@@ -7717,6 +7768,7 @@ function createMirrorManager(deps) {
       for (const item of list) {
         const binding = bindings.get(item.id) ?? null;
         if (item.agentState === "shell") {
+          pendingCreates.delete(item.id);
           if (binding && binding.status === "active") {
             chain = chain.then(() => {
               const b = bindings.get(item.id);
@@ -7740,6 +7792,21 @@ function createMirrorManager(deps) {
             return b && b.status === "ended" ? reactivateInPlace(b) : void 0;
           }).catch((e) => logger.debug(`[MIRROR] reconcile in-place reactivate failed for ${item.id}:`, e));
         } else if (!binding) {
+          const pending = pendingCreates.get(item.id);
+          if (pending) {
+            const decision = planPendingCreate(pending, now);
+            if (decision === "drop") {
+              pendingCreates.delete(item.id);
+              logger.debug(`[MIRROR] giving up on the parked mirror bind for terminal ${item.id}`);
+            } else if (decision === "retry") {
+              chain = chain.then(() => {
+                const still = pendingCreates.get(item.id);
+                if (!still || still !== pending || bindings.has(item.id)) return void 0;
+                return createBinding(still.event);
+              }).catch((e) => logger.debug(`[MIRROR] reconcile create retry failed for ${item.id}:`, e));
+            }
+            continue;
+          }
           persisted ??= readPersistedSessions();
           const p = persisted;
           chain = chain.then(() => {
@@ -9297,6 +9364,109 @@ function formatTranscript(bodies) {
   return lines.join("\n");
 }
 
+const SESSION_OPS_CLIENT = "session-ops";
+const DEFAULT_RECENT_LIMIT = 15;
+const MAX_READ_LIMIT = 100;
+function mergeSessionSummaries(live, persisted, options = {}) {
+  const recentLimit = Math.max(0, options.recentLimit ?? DEFAULT_RECENT_LIMIT);
+  const seen = /* @__PURE__ */ new Set();
+  const summaries = [];
+  for (const child of live) {
+    const id = typeof child.happySessionId === "string" ? child.happySessionId : void 0;
+    if (!id || seen.has(id)) continue;
+    seen.add(id);
+    summaries.push(toSummary(id, persisted[id], {
+      live: true,
+      pid: typeof child.pid === "number" ? child.pid : void 0
+    }));
+  }
+  const rest = Object.entries(persisted).filter(([id]) => !seen.has(id)).filter(([, entry]) => entry.metadata?.flavor !== "terminal-mirror").sort((a, b) => b[1].savedAt - a[1].savedAt).slice(0, recentLimit);
+  for (const [id, entry] of rest) {
+    summaries.push(toSummary(id, entry, { live: false }));
+  }
+  if (!options.tag) return summaries;
+  const wanted = options.tag;
+  return summaries.filter((summary) => summary.tags?.includes(wanted) === true);
+}
+function toSummary(id, persisted, extra) {
+  const meta = persisted?.metadata;
+  return {
+    id,
+    live: extra.live,
+    ...extra.pid !== void 0 ? { pid: extra.pid } : {},
+    ...meta?.summary?.text ? { title: meta.summary.text } : {},
+    ...meta?.path ? { cwd: meta.path } : {},
+    ...meta?.flavor ? { flavor: meta.flavor } : {},
+    ...meta?.tags?.length ? { tags: [...meta.tags] } : {},
+    ...meta?.variant ? { variant: meta.variant } : {},
+    url: sessionWebUrl(id),
+    ...persisted?.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {}
+  };
+}
+async function listSessions(options = {}) {
+  const live = await listDaemonSessions();
+  return mergeSessionSummaries(live, readPersistedSessions(), options);
+}
+async function bearerToken() {
+  const credentials = await readCredentialsForConfiguredRelay();
+  if (!credentials) throw new Error("CLI is not authenticated (no ~/.happy/access.key)");
+  return credentials.token;
+}
+async function readSessionTranscript(sessionId, limit) {
+  const persisted = readPersistedSessions()[sessionId];
+  if (!persisted) {
+    throw new Error(
+      `No local key for session ${sessionId} \u2014 it was not spawned by this machine's daemon (or is older than 14 days).`
+    );
+  }
+  const bounded = Math.max(1, Math.min(MAX_READ_LIMIT, Math.floor(limit)));
+  const token = await bearerToken();
+  const response = await axios.get(
+    `${configuration.serverUrl}/v3/sessions/${encodeURIComponent(sessionId)}/messages`,
+    {
+      params: { before_seq: 2147483647, limit: bounded },
+      headers: {
+        "Authorization": `Bearer ${token}`,
+        "X-Happy-Client": `${SESSION_OPS_CLIENT}/${configuration.currentCliVersion}`
+      },
+      timeout: 15e3
+    }
+  );
+  const messages = Array.isArray(response.data?.messages) ? response.data.messages : [];
+  messages.reverse();
+  const key = decodeBase64(persisted.encryptionKey);
+  const bodies = messages.map((message) => {
+    if (message.content?.t !== "encrypted") return null;
+    try {
+      return decrypt(key, persisted.encryptionVariant, decodeBase64(message.content.c));
+    } catch {
+      return null;
+    }
+  });
+  return {
+    summary: toSummary(sessionId, persisted, { live: false }),
+    messageCount: messages.length,
+    transcript: formatTranscript(bodies)
+  };
+}
+async function stopSession(sessionId) {
+  return await stopDaemonSession(sessionId);
+}
+async function archiveSession(sessionId) {
+  const token = await bearerToken();
+  await axios.post(
+    `${configuration.serverUrl}/v1/sessions/${encodeURIComponent(sessionId)}/archive`,
+    {},
+    {
+      headers: {
+        "Authorization": `Bearer ${token}`,
+        "X-Happy-Client": `${SESSION_OPS_CLIENT}/${configuration.currentCliVersion}`
+      },
+      timeout: 1e4
+    }
+  );
+}
+
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;
 function headingTitle(line) {
   const m = /^##(?!#)\s*(.*?)\s*$/.exec(line);
@@ -9393,19 +9563,24 @@ function fail(text) {
 function describeSession(id, persisted, extra) {
   const meta = persisted?.metadata;
   const parts = [id];
-  if (extra?.live !== void 0) parts.push(extra.live ? "[running]" : "[not running]");
   if (meta?.summary?.text) parts.push(`title="${meta.summary.text}"`);
   if (meta?.path) parts.push(`cwd=${meta.path}`);
   if (meta?.flavor) parts.push(`agent=${meta.flavor}`);
+  if (meta?.tags?.length) parts.push(`tags=${meta.tags.join(",")}`);
   if (meta?.variant === "assistant") parts.push("(assistant)");
-  if (extra?.pid) parts.push(`pid=${extra.pid}`);
   parts.push(sessionWebUrl(id));
   return parts.join(" ");
 }
-async function bearerToken() {
-  const credentials = await readCredentialsForConfiguredRelay();
-  if (!credentials) throw new Error("CLI is not authenticated (no ~/.happy/access.key)");
-  return credentials.token;
+function describeSummary(summary) {
+  const parts = [summary.id, summary.live ? "[running]" : "[not running]"];
+  if (summary.title) parts.push(`title="${summary.title}"`);
+  if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
+  if (summary.flavor) parts.push(`agent=${summary.flavor}`);
+  if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
+  if (summary.variant === "assistant") parts.push("(assistant)");
+  if (summary.pid !== void 0) parts.push(`pid=${summary.pid}`);
+  parts.push(summary.url);
+  return parts.join(" ");
 }
 function registerAssistantTools(mcp) {
   mcp.registerTool("sessions_list", {
@@ -9414,22 +9589,10 @@ function registerAssistantTools(mcp) {
     inputSchema: {}
   }, async () => {
     try {
-      const live = await listDaemonSessions();
-      const persisted = readPersistedSessions();
-      const lines = [];
-      const seen = /* @__PURE__ */ new Set();
-      for (const child of live) {
-        const id = child.happySessionId;
-        seen.add(id);
-        lines.push(describeSession(id, persisted[id], { pid: child.pid, live: true }));
-      }
-      const rest = Object.entries(persisted).filter(([id]) => !seen.has(id)).filter(([, entry]) => entry.metadata?.flavor !== "terminal-mirror").sort((a, b) => b[1].savedAt - a[1].savedAt).slice(0, 15);
-      for (const [id, entry] of rest) {
-        lines.push(describeSession(id, entry, { live: false }));
-      }
-      if (lines.length === 0) return ok("No sessions found on this machine.");
-      return ok(`${lines.length} session(s):
-${lines.join("\n")}`);
+      const sessions = await listSessions();
+      if (sessions.length === 0) return ok("No sessions found on this machine.");
+      return ok(`${sessions.length} session(s):
+${sessions.map(describeSummary).join("\n")}`);
     } catch (error) {
       return fail(`Failed to list sessions: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -9443,37 +9606,12 @@ ${lines.join("\n")}`);
     }
   }, async (args) => {
     if (!isValidSessionId(args.sessionId)) return fail("Invalid sessionId");
-    const limit = Math.max(1, Math.min(100, Math.floor(args.limit ?? 20)));
     try {
-      const persisted = readPersistedSessions()[args.sessionId];
-      if (!persisted) {
-        return fail(`No local key for session ${args.sessionId} \u2014 it was not spawned by this machine's daemon (or is older than 14 days).`);
-      }
-      const token = await bearerToken();
-      const response = await axios.get(
-        `${configuration.serverUrl}/v3/sessions/${encodeURIComponent(args.sessionId)}/messages`,
-        {
-          params: { before_seq: 2147483647, limit },
-          headers: { "Authorization": `Bearer ${token}`, "X-Happy-Client": `${MCP_CLIENT_TAG}/${configuration.currentCliVersion}` },
-          timeout: 15e3
-        }
-      );
-      const messages = Array.isArray(response.data?.messages) ? response.data.messages : [];
-      messages.reverse();
-      const key = decodeBase64(persisted.encryptionKey);
-      const bodies = messages.map((m) => {
-        if (m.content?.t !== "encrypted") return null;
-        try {
-          return decrypt(key, persisted.encryptionVariant, decodeBase64(m.content.c));
-        } catch {
-          return null;
-        }
-      });
-      const transcript = formatTranscript(bodies);
-      const header = describeSession(args.sessionId, persisted);
-      return ok(`${header}
---- last ${messages.length} message(s) ---
-${transcript.length > 0 ? transcript : "(no readable conversation content in this range)"}`);
+      const result = await readSessionTranscript(args.sessionId, args.limit ?? 20);
+      const body = result.transcript.length > 0 ? result.transcript : "(no readable conversation content in this range)";
+      return ok(`${describeSummary(result.summary)}
+--- last ${result.messageCount} message(s) ---
+${body}`);
     } catch (error) {
       return fail(`Failed to read session: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -9538,7 +9676,7 @@ ${transcript.length > 0 ? transcript : "(no readable conversation content in thi
     if (!isValidSessionId(args.sessionId)) return fail("Invalid sessionId");
     try {
       const persisted = readPersistedSessions()[args.sessionId];
-      const success = await stopDaemonSession(args.sessionId);
+      const success = await stopSession(args.sessionId);
       if (!success) return fail(`Session ${args.sessionId} was not found among the daemon's running sessions.`);
       return ok(`Stopped ${describeSession(args.sessionId, persisted)}`);
     } catch (error) {
@@ -9554,15 +9692,7 @@ ${transcript.length > 0 ? transcript : "(no readable conversation content in thi
   }, async (args) => {
     if (!isValidSessionId(args.sessionId)) return fail("Invalid sessionId");
     try {
-      const token = await bearerToken();
-      await axios.post(
-        `${configuration.serverUrl}/v1/sessions/${encodeURIComponent(args.sessionId)}/archive`,
-        {},
-        {
-          headers: { "Authorization": `Bearer ${token}`, "X-Happy-Client": `${MCP_CLIENT_TAG}/${configuration.currentCliVersion}` },
-          timeout: 1e4
-        }
-      );
+      await archiveSession(args.sessionId);
       const persisted = readPersistedSessions()[args.sessionId];
       return ok(`Archived ${describeSession(args.sessionId, persisted)}`);
     } catch (error) {
@@ -10238,7 +10368,7 @@ function registerSideQuestionHandler(rpc, deps) {
   const retainMs = deps.retainMs ?? SIDE_QUESTION_RETAIN_MS;
   const maxRunMs = deps.maxRunMs ?? SIDE_QUESTION_MAX_RUN_MS;
   const run = deps.run ?? (async (input) => {
-    const { query } = await import('./index-DYY1DUOD.mjs');
+    const { query } = await import('./index-jYltd-ZW.mjs');
     return runSideQuestion(query, input);
   });
   const slots = /* @__PURE__ */ new Map();
@@ -10778,6 +10908,7 @@ async function runClaude(credentials, options = {}) {
   const forkedFromMessageId = process.env.HAPPY_FORKED_FROM_MESSAGE_ID;
   const importedFromClaudeSessionId = process.env.HAPPY_IMPORTED_FROM_CLAUDE_SESSION_ID;
   const importTitle = process.env.HAPPY_IMPORT_TITLE;
+  const originTags = spawnOriginTags();
   let metadata = {
     path: workingDirectory,
     host: os.hostname(),
@@ -10810,12 +10941,13 @@ async function runClaude(credentials, options = {}) {
     ...importedFromClaudeSessionId ? { importedFromClaudeSessionId } : {},
     ...importTitle ? { summary: { text: importTitle, updatedAt: Date.now() } } : {},
     ...isAssistantVariant ? { variant: "assistant" } : {},
-    // B-091: sessions the assistant dispatched (daemon spawn RPC exports
-    // HAPPY_SPAWNED_BY, B-069) are born with the 'assistant' tag so every
-    // list shows their origin. NOT on the meta-agent itself — that one is
-    // the variant above and never joins the lists at all. (Shared helper:
-    // the other flavors get the same tag via createSessionMetadata.)
-    ...assistantSpawnTags() ? { tags: assistantSpawnTags() } : {}
+    // B-091/B-303: dispatched sessions (daemon spawn RPC exports
+    // HAPPY_SPAWNED_BY, B-069) are born tagged with their spawn origin so
+    // every list shows where the work came from. NOT on the meta-agent
+    // itself — that one is the variant above and never joins the lists at
+    // all. (Shared helper: the other flavors get the same tag via
+    // createSessionMetadata.)
+    ...originTags ? { tags: originTags } : {}
   };
   const reconnectSessionId = process.env.HAPPY_RECONNECT_SESSION_ID;
   const reconnectKeyBase64 = process.env.HAPPY_RECONNECT_ENCRYPTION_KEY;
@@ -15166,7 +15298,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     process.exit(0);
   } else if (subcommand === "install-terminal-hooks") {
     try {
-      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await import('./installTerminalHooks-Cs49gg_E.mjs');
+      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await import('./installTerminalHooks-CJyoR9jp.mjs');
       const command = parseTerminalHooksArgs(args.slice(1));
       if (command.action === "help") {
         console.log(TERMINAL_HOOKS_HELP);
@@ -15183,7 +15315,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
   } else if (subcommand === "spawn") {
     try {
-      const { handleSpawnCommand } = await import('./spawn-Dt4ujmHH.mjs');
+      const { handleSpawnCommand } = await import('./spawn-DcA80_VN.mjs');
       await handleSpawnCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -15193,9 +15325,21 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(1);
     }
     return;
+  } else if (subcommand === "sessions") {
+    try {
+      const { handleSessionsCommand } = await import('./sessions-DDwCphTQ.mjs');
+      await handleSessionsCommand(args.slice(1));
+    } catch (error) {
+      console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
+      if (process.env.DEBUG) {
+        console.error(error);
+      }
+      process.exit(1);
+    }
+    return;
   } else if (subcommand === "send") {
     try {
-      const { handleSendCommand } = await import('./send-uHgpvIqm.mjs');
+      const { handleSendCommand } = await import('./send-Btz1IZ9U.mjs');
       await handleSendCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -15301,9 +15445,9 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     if (geminiSubcommand === "project" && args[2] === "set" && args[3]) {
       const projectId = args[3];
       try {
-        const { saveGoogleCloudProjectToConfig } = await import('./config-DKMwLc1k.mjs');
-        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await import('./types-D0-nhvuW.mjs').then(function (n) { return n.ap; });
-        const { ApiClient: ApiClient2 } = await import('./types-D0-nhvuW.mjs').then(function (n) { return n.aq; });
+        const { saveGoogleCloudProjectToConfig } = await import('./config-CTyyVXHj.mjs');
+        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await import('./types-BdO0jg7G.mjs').then(function (n) { return n.ap; });
+        const { ApiClient: ApiClient2 } = await import('./types-BdO0jg7G.mjs').then(function (n) { return n.aq; });
         let userEmail = void 0;
         try {
           const credentials = await readCredentialsForConfiguredRelay2();
@@ -15334,7 +15478,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
     if (geminiSubcommand === "project" && args[2] === "get") {
       try {
-        const { readGeminiLocalConfig } = await import('./config-DKMwLc1k.mjs');
+        const { readGeminiLocalConfig } = await import('./config-CTyyVXHj.mjs');
         const config = readGeminiLocalConfig();
         if (config.googleCloudProject) {
           console.log(`Current Google Cloud Project: ${config.googleCloudProject}`);
@@ -15374,7 +15518,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(0);
     }
     try {
-      const { runGemini } = await import('./runGemini-Bqs52hw_.mjs');
+      const { runGemini } = await import('./runGemini-CuzqF6Ys.mjs');
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -15396,7 +15540,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "acp") {
     try {
-      const { runAcp, resolveAcpAgentConfig } = await import('./index-BXnHT-Wu.mjs');
+      const { runAcp, resolveAcpAgentConfig } = await import('./index-Brhvj7p0.mjs');
       let startedBy = void 0;
       let verbose = false;
       const acpArgs = [];
@@ -15436,7 +15580,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "openclaw") {
     try {
-      const { runOpenClaw } = await import('./runOpenClaw-CpbsQ7NZ.mjs');
+      const { runOpenClaw } = await import('./runOpenClaw-B5pkmSTb.mjs');
       let startedBy = void 0;
       let verbose = false;
       let gatewayUrl;
@@ -15487,7 +15631,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "mcp" && args.length === 1) {
     try {
-      const { handleMcpCommand } = await import('./mcp-DY17lhMH.mjs');
+      const { handleMcpCommand } = await import('./mcp-BO9-sxMr.mjs');
       await handleMcpCommand();
     } catch (error) {
       process.stderr.write(`[very-happy mcp] Fatal: ${error instanceof Error ? error.message : String(error)}
@@ -15702,6 +15846,8 @@ ${chalk.bold("Usage:")}
                             print its web URL (for automation; see spawn --help)
   very-happy send              Send a message into an existing session
                             (for automation; see send --help)
+  very-happy sessions          List, read, stop or archive sessions on this
+                            machine (for automation; see sessions --help)
   very-happy codex             Start Codex mode
   very-happy gemini            Start Gemini mode (ACP)
   very-happy acp               Start a generic ACP-compatible agent
@@ -15843,4 +15989,4 @@ ${chalk.bold("Examples:")}
   }
 }
 
-export { BasePermissionHandler as B, CHANGE_TITLE_INSTRUCTION as C, DEFAULT_GEMINI_MODEL as D, GEMINI_MODEL_ENV as G, MessageQueue2 as M, sessionWebUrl as a, sendUserMessage as b, checkIfDaemonRunningAndCleanupStaleState as c, createSessionMetadata as d, setupOfflineReconnection as e, startHappyServer as f, GEMINI_API_KEY_ENV as g, hashObject as h, initialMachineMetadata as i, GOOGLE_API_KEY_ENV as j, BaseReasoningProcessor as k, MessageBuffer as l, notifyDaemonSessionStarted as n, pushClipboardViaDaemon as p, query as q, registerKillSessionHandler as r, spawnDaemonSession as s, tmuxSupportsSessionEnv as t, waitForSessionKey as w };
+export { BasePermissionHandler as B, CHANGE_TITLE_INSTRUCTION as C, DEFAULT_RECENT_LIMIT as D, GEMINI_MODEL_ENV as G, MAX_READ_LIMIT as M, sessionWebUrl as a, sendUserMessage as b, checkIfDaemonRunningAndCleanupStaleState as c, stopSession as d, archiveSession as e, DEFAULT_GEMINI_MODEL as f, initialMachineMetadata as g, createSessionMetadata as h, isValidSpawnOrigin as i, setupOfflineReconnection as j, MessageQueue2 as k, listSessions as l, hashObject as m, notifyDaemonSessionStarted as n, startHappyServer as o, pushClipboardViaDaemon as p, query as q, readSessionTranscript as r, spawnDaemonSession as s, tmuxSupportsSessionEnv as t, registerKillSessionHandler as u, GEMINI_API_KEY_ENV as v, waitForSessionKey as w, GOOGLE_API_KEY_ENV as x, BaseReasoningProcessor as y, MessageBuffer as z };

package/dist/{index-BXnHT-Wu.mjs → index-Brhvj7p0.mjs}

@@ -1,10 +1,10 @@
-import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-DwR8rrkS.mjs';
-export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-DwR8rrkS.mjs';
-import { h as connectionState, A as ApiClient, i as readSettings, j as encodeBase64, l as logger, p as projectPath } from './types-D0-nhvuW.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-C057dkLF.mjs';
+import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-DzZR7TEv.mjs';
+export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-DzZR7TEv.mjs';
+import { h as connectionState, A as ApiClient, j as readSettings, k as encodeBase64, l as logger, p as projectPath } from './types-BdO0jg7G.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-tWuFWeIF.mjs';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { i as initialMachineMetadata, d as createSessionMetadata, e as setupOfflineReconnection, n as notifyDaemonSessionStarted, M as MessageQueue2, h as hashObject, f as startHappyServer, r as registerKillSessionHandler, B as BasePermissionHandler } from './index-CzSv4d_S.mjs';
+import { g as initialMachineMetadata, h as createSessionMetadata, j as setupOfflineReconnection, n as notifyDaemonSessionStarted, k as MessageQueue2, m as hashObject, o as startHappyServer, u as registerKillSessionHandler, B as BasePermissionHandler } from './index-BW9kDx5m.mjs';
 import 'node:child_process';
 import '@agentclientprotocol/sdk';
 import 'axios';