very-happy-cli 0.2.115 → 0.2.117

package/dist/{mcp-CiNrjYox.mjs → mcp-D_5aOK0I.mjs}

@@ -1,30 +1,30 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { p as pushClipboardViaDaemon } from './index-BHNEb4bc.mjs';
+import { p as pushClipboardViaDaemon, k as setTerminalTitleViaDaemon, m as registerAssistantSessionTools } from './index-BYZKuQoy.mjs';
 import { C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, c as CLIPBOARD_MAX_BYTES } from './limits-CwFb5S2b.mjs';
-import { l as logger } from './types-B3qx8Ga1.mjs';
-import 'chalk';
+import { l as logger } from './types-jSfU_0o1.mjs';
+import 'node:fs/promises';
 import 'node:os';
 import 'node:crypto';
-import 'cross-spawn';
+import 'axios';
+import 'tweetnacl';
+import 'socket.io-client';
+import 'node:child_process';
+import 'node:fs';
 import 'node:path';
+import 'chalk';
+import 'cross-spawn';
 import 'node:readline';
-import 'node:fs';
 import './agentGuidance-C2_pkgRI.mjs';
-import 'node:fs/promises';
 import 'fs/promises';
 import 'ink';
 import 'react';
 import '@anthropic-ai/claude-agent-sdk';
-import 'axios';
 import 'node:events';
-import 'socket.io-client';
-import 'tweetnacl';
 import 'os';
 import 'child_process';
 import '@paralleldrive/cuid2';
-import 'node:child_process';
 import 'fs';
 import 'path';
 import '@anthropic-ai/sandbox-runtime';
@@ -47,11 +47,19 @@ import 'node:util';
 import 'url';
 import 'node-pty';
 
-async function handleMcpCommand() {
-  const server = new McpServer({
-    name: "very-happy",
-    version: "1.0.0"
-  });
+const TERMINAL_TITLE_TOOL_NAME = "change_title";
+function resolveMcpTerminalId(env) {
+  if (env.HAPPY_MCP_URL) return null;
+  const id = env.VH_TERMINAL_ID;
+  return id && /^[a-zA-Z0-9_-]{1,64}$/.test(id) ? id : null;
+}
+function resolveMcpToolSurface(env) {
+  if (env.HAPPY_SESSION_VARIANT !== "assistant") return "clipboard";
+  if (env.HAPPY_MANAGED === "1") return "clipboard";
+  return "assistant";
+}
+
+function registerMcpTools(server, surface, terminalId = null) {
   server.registerTool(CLIPBOARD_TOOL_NAME, {
     description: CLIPBOARD_TOOL_DESCRIPTION,
     title: CLIPBOARD_TOOL_TITLE,
@@ -79,13 +87,50 @@ async function handleMcpCommand() {
       isError: true
     };
   });
+  if (terminalId) {
+    server.registerTool(TERMINAL_TITLE_TOOL_NAME, {
+      description: "Change the title of the very-happy web terminal this agent is running in",
+      title: "Change Terminal Title",
+      inputSchema: {
+        title: z.string().min(1).max(200).describe("The new title for this terminal")
+      }
+    }, async (args) => {
+      logger.debug(`[MCP] change_title called for terminal ${terminalId}`);
+      const result = await setTerminalTitleViaDaemon(terminalId, args.title);
+      if (result.ok) {
+        return {
+          content: [{ type: "text", text: `Successfully changed terminal title to: "${args.title}"` }],
+          isError: false
+        };
+      }
+      return {
+        content: [{
+          type: "text",
+          text: `Failed to change terminal title: ${result.error || "unknown error"}. The very-happy daemon must be running on this machine (start it with \`very-happy daemon start\`).`
+        }],
+        isError: true
+      };
+    });
+  }
+  if (surface === "assistant") {
+    registerAssistantSessionTools(server);
+  }
+}
+async function handleMcpCommand() {
+  const server = new McpServer({
+    name: "very-happy",
+    version: "1.0.0"
+  });
+  const surface = resolveMcpToolSurface(process.env);
+  const terminalId = resolveMcpTerminalId(process.env);
+  registerMcpTools(server, surface, terminalId);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  logger.debug("[MCP] very-happy stdio MCP server started");
+  logger.debug(`[MCP] very-happy stdio MCP server started (surface=${surface}, terminal=${terminalId ?? "none"})`);
   await new Promise((resolve) => {
     process.stdin.on("close", resolve);
     process.stdin.on("end", resolve);
   });
 }
 
-export { handleMcpCommand };
+export { handleMcpCommand, registerMcpTools };

package/dist/{mcp-CqjiDRnG.cjs → mcp-nYqC4FYm.cjs}

@@ -3,30 +3,30 @@
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
 var z = require('zod');
-var index = require('./index-tPXwlc_t.cjs');
+var index = require('./index-DcESl4cI.cjs');
 var limits = require('./limits-KdWKmwtH.cjs');
-var persistence = require('./types-CpnzfHHS.cjs');
-require('chalk');
+var persistence = require('./types-DD3AK6Nb.cjs');
+require('node:fs/promises');
 require('node:os');
 require('node:crypto');
-require('cross-spawn');
+require('axios');
+require('tweetnacl');
+require('socket.io-client');
+require('node:child_process');
+require('node:fs');
 require('node:path');
+require('chalk');
+require('cross-spawn');
 require('node:readline');
-require('node:fs');
 require('./agentGuidance-BifkGXdE.cjs');
-require('node:fs/promises');
 require('fs/promises');
 require('ink');
 require('react');
 require('@anthropic-ai/claude-agent-sdk');
-require('axios');
 require('node:events');
-require('socket.io-client');
-require('tweetnacl');
 require('os');
 require('child_process');
 require('@paralleldrive/cuid2');
-require('node:child_process');
 require('fs');
 require('path');
 require('@anthropic-ai/sandbox-runtime');
@@ -49,11 +49,19 @@ require('node:util');
 require('url');
 require('node-pty');
 
-async function handleMcpCommand() {
-  const server = new mcp_js.McpServer({
-    name: "very-happy",
-    version: "1.0.0"
-  });
+const TERMINAL_TITLE_TOOL_NAME = "change_title";
+function resolveMcpTerminalId(env) {
+  if (env.HAPPY_MCP_URL) return null;
+  const id = env.VH_TERMINAL_ID;
+  return id && /^[a-zA-Z0-9_-]{1,64}$/.test(id) ? id : null;
+}
+function resolveMcpToolSurface(env) {
+  if (env.HAPPY_SESSION_VARIANT !== "assistant") return "clipboard";
+  if (env.HAPPY_MANAGED === "1") return "clipboard";
+  return "assistant";
+}
+
+function registerMcpTools(server, surface, terminalId = null) {
   server.registerTool(limits.CLIPBOARD_TOOL_NAME, {
     description: limits.CLIPBOARD_TOOL_DESCRIPTION,
     title: limits.CLIPBOARD_TOOL_TITLE,
@@ -81,9 +89,46 @@ async function handleMcpCommand() {
       isError: true
     };
   });
+  if (terminalId) {
+    server.registerTool(TERMINAL_TITLE_TOOL_NAME, {
+      description: "Change the title of the very-happy web terminal this agent is running in",
+      title: "Change Terminal Title",
+      inputSchema: {
+        title: z.z.string().min(1).max(200).describe("The new title for this terminal")
+      }
+    }, async (args) => {
+      persistence.logger.debug(`[MCP] change_title called for terminal ${terminalId}`);
+      const result = await index.setTerminalTitleViaDaemon(terminalId, args.title);
+      if (result.ok) {
+        return {
+          content: [{ type: "text", text: `Successfully changed terminal title to: "${args.title}"` }],
+          isError: false
+        };
+      }
+      return {
+        content: [{
+          type: "text",
+          text: `Failed to change terminal title: ${result.error || "unknown error"}. The very-happy daemon must be running on this machine (start it with \`very-happy daemon start\`).`
+        }],
+        isError: true
+      };
+    });
+  }
+  if (surface === "assistant") {
+    index.registerAssistantSessionTools(server);
+  }
+}
+async function handleMcpCommand() {
+  const server = new mcp_js.McpServer({
+    name: "very-happy",
+    version: "1.0.0"
+  });
+  const surface = resolveMcpToolSurface(process.env);
+  const terminalId = resolveMcpTerminalId(process.env);
+  registerMcpTools(server, surface, terminalId);
   const transport = new stdio_js.StdioServerTransport();
   await server.connect(transport);
-  persistence.logger.debug("[MCP] very-happy stdio MCP server started");
+  persistence.logger.debug(`[MCP] very-happy stdio MCP server started (surface=${surface}, terminal=${terminalId ?? "none"})`);
   await new Promise((resolve) => {
     process.stdin.on("close", resolve);
     process.stdin.on("end", resolve);
@@ -91,3 +136,4 @@ async function handleMcpCommand() {
 }
 
 exports.handleMcpCommand = handleMcpCommand;
+exports.registerMcpTools = registerMcpTools;

package/dist/{runGemini-DdJqpywr.mjs → runGemini-CEURRmM4.mjs}

@@ -2,10 +2,10 @@ import { useStdout, useInput, Box, Text, render } from 'ink';
 import React, { useState, useRef, useEffect, useCallback } from 'react';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { l as logger, h as connectionState, A as ApiClient, j as readSettings, e as errorLogMetadata, k as encodeBase64, p as projectPath, d as contentLogMetadata } from './types-B3qx8Ga1.mjs';
-import { x as GEMINI_API_KEY_ENV, y as GOOGLE_API_KEY_ENV, G as GEMINI_MODEL_ENV, B as BasePermissionHandler, z as BaseReasoningProcessor, h as initialMachineMetadata, j as createSessionMetadata, k as setupOfflineReconnection, n as notifyDaemonSessionStarted, m as MessageQueue2, o as hashObject, C as MessageBuffer, E as CHANGE_TITLE_INSTRUCTION, v as registerKillSessionHandler, u as startHappyServer } from './index-BHNEb4bc.mjs';
-import { A as AcpBackend } from './AcpBackend-DEZTWZZu.mjs';
-import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-CMgRBQMS.mjs';
+import { l as logger, h as connectionState, A as ApiClient, j as readSettings, e as errorLogMetadata, k as encodeBase64, p as projectPath, d as contentLogMetadata } from './types-jSfU_0o1.mjs';
+import { I as GEMINI_API_KEY_ENV, J as GOOGLE_API_KEY_ENV, G as GEMINI_MODEL_ENV, C as BasePermissionHandler, K as BaseReasoningProcessor, n as initialMachineMetadata, o as createSessionMetadata, u as setupOfflineReconnection, v as notifyDaemonSessionStarted, x as MessageQueue2, y as hashObject, L as MessageBuffer, N as CHANGE_TITLE_INSTRUCTION, B as registerKillSessionHandler, z as startHappyServer } from './index-BYZKuQoy.mjs';
+import { A as AcpBackend } from './AcpBackend-C4RMHt0I.mjs';
+import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-CnA3JIUn.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{runGemini-UN5IznJp.cjs → runGemini-DYf3ntib.cjs}

@@ -4,10 +4,10 @@ var ink = require('ink');
 var React = require('react');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
-var persistence = require('./types-CpnzfHHS.cjs');
-var index = require('./index-tPXwlc_t.cjs');
-var AcpBackend = require('./AcpBackend-BrZN8KM-.cjs');
-var config = require('./config-BNAsx9Wg.cjs');
+var persistence = require('./types-DD3AK6Nb.cjs');
+var index = require('./index-DcESl4cI.cjs');
+var AcpBackend = require('./AcpBackend-CrbXvcgQ.cjs');
+var config = require('./config-O9quMfxg.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/{runOpenClaw-CM5UrVBy.mjs → runOpenClaw-BozfKWng.mjs}

@@ -3,9 +3,9 @@ import { execFileSync } from 'node:child_process';
 import os from 'node:os';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { m as ensurePrivateDirectorySync, n as hardenPrivateFileSync, w as writePrivateFileSync, e as errorLogMetadata, d as contentLogMetadata, h as connectionState, A as ApiClient, j as readSettings, k as encodeBase64, l as logger, c as configuration } from './types-B3qx8Ga1.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-BzP3eiOG.mjs';
-import { h as initialMachineMetadata, j as createSessionMetadata, k as setupOfflineReconnection, n as notifyDaemonSessionStarted, m as MessageQueue2, v as registerKillSessionHandler } from './index-BHNEb4bc.mjs';
+import { m as ensurePrivateDirectorySync, n as hardenPrivateFileSync, w as writePrivateFileSync, e as errorLogMetadata, d as contentLogMetadata, h as connectionState, A as ApiClient, j as readSettings, k as encodeBase64, l as logger, c as configuration } from './types-jSfU_0o1.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-Cnc8Jatl.mjs';
+import { n as initialMachineMetadata, o as createSessionMetadata, u as setupOfflineReconnection, v as notifyDaemonSessionStarted, x as MessageQueue2, B as registerKillSessionHandler } from './index-BYZKuQoy.mjs';
 import WebSocket from 'ws';
 import * as ed from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2.js';

package/dist/{runOpenClaw-9hhfGllZ.cjs → runOpenClaw-CNKjAw-H.cjs}

@@ -5,9 +5,9 @@ var node_child_process = require('node:child_process');
 var os = require('node:os');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var persistence = require('./types-CpnzfHHS.cjs');
-var AcpSessionManager = require('./AcpSessionManager-DjulpKY0.cjs');
-var index = require('./index-tPXwlc_t.cjs');
+var persistence = require('./types-DD3AK6Nb.cjs');
+var AcpSessionManager = require('./AcpSessionManager-CjAVO4RX.cjs');
+var index = require('./index-DcESl4cI.cjs');
 var WebSocket = require('ws');
 var ed = require('@noble/ed25519');
 var sha2_js = require('@noble/hashes/sha2.js');

package/dist/{send-CnVtXOj0.cjs → send-BZLhRZb-.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var persistence = require('./types-CpnzfHHS.cjs');
-var index = require('./index-tPXwlc_t.cjs');
+var persistence = require('./types-DD3AK6Nb.cjs');
+var index = require('./index-DcESl4cI.cjs');
 require('axios');
 require('node:util');
 require('node:os');

package/dist/{send-C6G2jsQp.mjs → send-CYznZGrp.mjs}

@@ -1,8 +1,8 @@
 import chalk from 'chalk';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { r as readPersistedSessions, c as configuration } from './types-B3qx8Ga1.mjs';
-import { d as sendUserMessage, a as sessionWebUrl } from './index-BHNEb4bc.mjs';
+import { r as readPersistedSessions, c as configuration } from './types-jSfU_0o1.mjs';
+import { d as sendUserMessage, a as sessionWebUrl } from './index-BYZKuQoy.mjs';
 import 'axios';
 import 'node:util';
 import 'node:os';

package/dist/sessions-DYPB3Peg.mjs

@@ -0,0 +1,317 @@
+import chalk from 'chalk';
+import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listAccountSessions, e as listSessions, r as readSessionTranscript, f as stopSession, g as resolvePermissionRequest, h as archiveSession } from './index-BYZKuQoy.mjs';
+import { i as isValidSessionId } from './types-jSfU_0o1.mjs';
+import 'node:os';
+import 'node:crypto';
+import 'cross-spawn';
+import 'node:path';
+import 'node:readline';
+import 'node:fs';
+import './agentGuidance-C2_pkgRI.mjs';
+import 'node:fs/promises';
+import 'fs/promises';
+import 'ink';
+import 'react';
+import '@anthropic-ai/claude-agent-sdk';
+import 'axios';
+import 'node:events';
+import 'socket.io-client';
+import 'tweetnacl';
+import 'os';
+import 'child_process';
+import '@paralleldrive/cuid2';
+import 'node:child_process';
+import 'fs';
+import 'path';
+import '@anthropic-ai/sandbox-runtime';
+import 'expo-server-sdk';
+import 'crypto';
+import 'ps-list';
+import 'tmp';
+import 'open';
+import 'fastify';
+import 'zod';
+import 'fastify-type-provider-zod';
+import 'node:module';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+import 'node:http';
+import '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import './limits-CwFb5S2b.mjs';
+import 'http';
+import 'util';
+import 'inquirer';
+import 'node:url';
+import 'node:readline/promises';
+import 'node:util';
+import 'url';
+import 'node-pty';
+
+const ACTIONS = ["list", "read", "stop", "archive", "approve", "deny"];
+const ACTIONS_NEEDING_ID = /* @__PURE__ */ new Set(["read", "stop", "archive", "approve", "deny"]);
+const ACTIONS_NEEDING_REQUEST_ID = /* @__PURE__ */ new Set(["approve", "deny"]);
+const REQUEST_ID_RE = /^[a-zA-Z0-9_.:-]{1,128}$/;
+function defaultOptions() {
+  return { action: "help", all: false, includeArchived: false, forSession: false, json: false };
+}
+function parseSessionsArgs(args) {
+  const options = defaultOptions();
+  let actionSeen = false;
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      return defaultOptions();
+    } else if (arg === "--json") {
+      options.json = true;
+    } else if (arg === "--all") {
+      options.all = true;
+    } else if (arg === "--include-archived") {
+      options.includeArchived = true;
+    } else if (arg === "--for-session") {
+      options.forSession = true;
+    } else if (arg === "--reason") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--reason requires a value");
+      options.reason = value;
+    } else if (arg === "--tag") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--tag requires a value");
+      options.tag = value;
+    } else if (arg === "--limit") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--limit requires a value");
+      const parsed = Number(value);
+      if (!Number.isInteger(parsed) || parsed < 1) throw new Error("--limit must be a positive integer");
+      options.limit = parsed;
+    } else if (arg.startsWith("-")) {
+      throw new Error(`Unknown argument: ${arg}`);
+    } else if (!actionSeen) {
+      if (!ACTIONS.includes(arg)) {
+        throw new Error(`Unknown action: ${arg} (expected ${ACTIONS.join(", ")})`);
+      }
+      options.action = arg;
+      actionSeen = true;
+    } else {
+      positionals.push(arg);
+    }
+  }
+  if (!actionSeen) return defaultOptions();
+  const expectedPositionals = ACTIONS_NEEDING_REQUEST_ID.has(options.action) ? 2 : ACTIONS_NEEDING_ID.has(options.action) ? 1 : 0;
+  if (positionals.length > expectedPositionals) {
+    throw new Error(`Unexpected ${expectedPositionals > 0 ? "extra " : ""}argument: ${positionals[expectedPositionals]}`);
+  }
+  if (ACTIONS_NEEDING_ID.has(options.action)) {
+    const id = positionals[0];
+    if (id === void 0) throw new Error(`${options.action} requires a session id`);
+    if (!isValidSessionId(id)) throw new Error(`Invalid session id: ${id}`);
+    options.sessionId = id;
+  }
+  if (ACTIONS_NEEDING_REQUEST_ID.has(options.action)) {
+    const requestId = positionals[1];
+    if (requestId === void 0) throw new Error(`${options.action} requires a session id and a request id`);
+    if (!REQUEST_ID_RE.test(requestId)) throw new Error(`Invalid request id: ${requestId}`);
+    options.requestId = requestId;
+  }
+  if (options.action !== "list") {
+    if (options.tag !== void 0) throw new Error("--tag only applies to `sessions list`");
+    if (options.all) throw new Error("--all only applies to `sessions list`");
+    if (options.includeArchived) throw new Error("--include-archived only applies to `sessions list --all`");
+  } else if (options.includeArchived && !options.all) {
+    throw new Error("--include-archived only applies to `sessions list --all`");
+  }
+  if (options.forSession && options.action !== "approve") throw new Error("--for-session only applies to `sessions approve`");
+  if (options.reason !== void 0 && options.action !== "deny") throw new Error("--reason only applies to `sessions deny`");
+  return options;
+}
+const SESSIONS_HELP = `
+${chalk.bold("very-happy sessions")} - Inspect and control sessions on this machine (for automation)
+
+${chalk.bold("Usage:")}
+  very-happy sessions list [--all [--include-archived]] [--tag <name>] [--limit <n>] [--json]
+  very-happy sessions read <id> [--limit <n>] [--json]
+  very-happy sessions stop <id> [--json]
+  very-happy sessions archive <id> [--json]
+  very-happy sessions approve <id> <requestId> [--for-session] [--json]
+  very-happy sessions deny <id> <requestId> [--reason <text>] [--json]
+
+${chalk.bold("Actions:")}
+  list       Running sessions plus recently seen ones, newest first.
+             With --all: every session on the account (newest 150, server
+             REST), attention first. Each row says whether this machine could
+             decrypt it (\`decryptable\`); rows from other machines show only
+             id / active / archived / timestamps / url.
+  read       The tail of a session as a role-tagged transcript.
+  stop       SIGTERM the session's process via the local daemon.
+  archive    Mark the session inactive server-side (it stays resumable).
+  approve    Answer a pending permission request \`requestId\` with approve \u2014
+             the same RPC the web permission card sends. --for-session makes
+             it \`approved_for_session\` (the card's "allow for this session").
+  deny       Answer it with deny (optional --reason is shown to the agent).
+
+${chalk.bold("Options:")}
+  --all              list only: account-wide over REST instead of this
+                     machine's daemon + local keys.
+  --include-archived list --all only: also show server-archived rows.
+  --tag <name>       list only: keep sessions carrying this origin tag (see
+                     \`spawn --spawned-by\`). With --all only decryptable rows
+                     can match.
+  --limit <n>        list: how many NOT-running / not-attention sessions to
+                     include (default ${DEFAULT_RECENT_LIMIT}; running and attention rows are
+                     never cut). read: how many messages (default 20, max ${MAX_READ_LIMIT}).
+  --for-session      approve only: approved_for_session instead of approved.
+  --reason <text>    deny only: reason forwarded to the wrapper.
+  --json             Machine-readable output.
+  -h, --help         Show this help
+
+${chalk.bold("Scope:")}
+  read / approve / deny need the session key from ~/.happy/sessions.json,
+  which exists for sessions this machine's daemon spawned and is pruned after
+  14 days (the message payloads and the permission RPC are encrypted with it).
+  \`list --all\` sees every session on the account but can only decrypt those
+  same ones; the rest come back with decryptable=false. Reading, listing in
+  full and answering another machine's session from here needs the CLI to hold
+  the account content key \u2014 a credentials change, not a flag.
+
+${chalk.bold("Exit codes:")}
+  0  success (approve/deny: the wrapper acknowledged the verdict; check
+     \`settled\` in --json to see whether the request has left the pending set)
+  1  bad arguments, unknown session, no local key, request not pending,
+     session not online, or the operation failed (including \`stop\` on a
+     session the daemon is not running)
+`;
+function formatWait(ms) {
+  const minutes = Math.floor(ms / 6e4);
+  if (minutes < 1) return `${Math.floor(ms / 1e3)}s`;
+  if (minutes < 60) return `${minutes}m`;
+  return `${Math.floor(minutes / 60)}h${minutes % 60}m`;
+}
+function formatAccountSummaryLine(summary) {
+  const state = summary.attention ? "[attention]" : summary.live ? "[running here]" : summary.active ? "[active elsewhere]" : summary.archived ? "[archived]" : "[idle]";
+  const parts = [summary.id, state];
+  if (!summary.decryptable) {
+    parts.push("(not decryptable from this machine)");
+  } else {
+    if (summary.title) parts.push(`title="${summary.title}"`);
+    if (summary.flavor) parts.push(`agent=${summary.flavor}`);
+    if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
+    if (summary.variant) parts.push(`variant=${summary.variant}`);
+    if (summary.machineId) parts.push(`machine=${summary.machineId}`);
+    if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
+    for (const request of summary.pending ?? []) {
+      parts.push(`pending=${request.id}:${request.tool}${request.waitingMs !== void 0 ? `(${formatWait(request.waitingMs)})` : ""}`);
+    }
+  }
+  parts.push(summary.url);
+  return parts.join(" ");
+}
+function permissionFailureRecord(sessionId, requestId, error) {
+  return { sessionId, requestId, error: error instanceof Error ? error.message : String(error) };
+}
+function formatSummaryLine(summary) {
+  const parts = [summary.id, summary.live ? "[running]" : "[not running]"];
+  if (summary.title) parts.push(`title="${summary.title}"`);
+  if (summary.flavor) parts.push(`agent=${summary.flavor}`);
+  if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
+  if (summary.variant) parts.push(`variant=${summary.variant}`);
+  if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
+  if (summary.pid !== void 0) parts.push(`pid=${summary.pid}`);
+  parts.push(summary.url);
+  return parts.join(" ");
+}
+async function handleSessionsCommand(args) {
+  let options;
+  try {
+    options = parseSessionsArgs(args);
+  } catch (error) {
+    console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
+    console.error(`Run ${chalk.cyan("very-happy sessions --help")} for usage.`);
+    process.exit(1);
+  }
+  if (options.action === "help") {
+    console.log(SESSIONS_HELP);
+    process.exit(0);
+  }
+  try {
+    if (options.action === "list" && options.all) {
+      const sessions = await listAccountSessions({ tag: options.tag, recentLimit: options.limit, includeArchived: options.includeArchived });
+      if (options.json) {
+        console.log(JSON.stringify({ sessions, scope: "account" }));
+      } else if (sessions.length === 0) {
+        console.log(options.tag ? `No decryptable sessions tagged "${options.tag}" on this account.` : "No sessions found on this account.");
+      } else {
+        for (const summary of sessions) console.log(formatAccountSummaryLine(summary));
+        const foreign = sessions.filter((summary) => !summary.decryptable).length;
+        if (foreign > 0) {
+          console.log(chalk.dim(`${foreign} session(s) belong to another machine and cannot be decrypted here (no local key).`));
+        }
+      }
+      process.exit(0);
+    }
+    if (options.action === "list") {
+      const sessions = await listSessions({ tag: options.tag, recentLimit: options.limit });
+      if (options.json) {
+        console.log(JSON.stringify({ sessions }));
+      } else if (sessions.length === 0) {
+        console.log(options.tag ? `No sessions tagged "${options.tag}" on this machine.` : "No sessions found on this machine.");
+      } else {
+        for (const summary of sessions) console.log(formatSummaryLine(summary));
+      }
+      process.exit(0);
+    }
+    const sessionId = options.sessionId;
+    if (options.action === "read") {
+      const result = await readSessionTranscript(sessionId, options.limit ?? 20);
+      if (options.json) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log(formatSummaryLine(result.summary));
+        console.log(`--- last ${result.messageCount} message(s) ---`);
+        console.log(result.transcript.length > 0 ? result.transcript : "(no readable conversation content in this range)");
+      }
+      process.exit(0);
+    }
+    if (options.action === "stop") {
+      const stopped = await stopSession(sessionId);
+      if (!stopped) {
+        if (options.json) console.log(JSON.stringify({ sessionId, stopped: false }));
+        console.error(chalk.red("Error:"), `Session ${sessionId} is not among the daemon's running sessions.`);
+        process.exit(1);
+      }
+      if (options.json) console.log(JSON.stringify({ sessionId, stopped: true }));
+      else console.log(`Stopped ${sessionId}`);
+      process.exit(0);
+    }
+    if (options.action === "approve" || options.action === "deny") {
+      const requestId = options.requestId;
+      const verdict = options.action === "approve" ? { kind: "approve", forSession: options.forSession } : { kind: "deny", reason: options.reason };
+      let result;
+      try {
+        result = await resolvePermissionRequest(sessionId, requestId, verdict);
+      } catch (error) {
+        if (options.json) console.log(JSON.stringify(permissionFailureRecord(sessionId, requestId, error)));
+        throw error;
+      }
+      if (result.outcome.status !== "acknowledged") {
+        if (options.json) console.log(JSON.stringify(result));
+        console.error(chalk.red("Error:"), `${options.action} of ${requestId} on ${sessionId} was not delivered (${result.outcome.status}): ${result.outcome.message}`);
+        process.exit(1);
+      }
+      if (options.json) {
+        console.log(JSON.stringify(result));
+      } else {
+        const verb = options.action === "approve" ? "Approved" : "Denied";
+        console.log(`${verb} ${requestId} on ${sessionId} (${result.payload.decision})${result.settled ? "" : " \u2014 wrapper acknowledged, but the request was still listed as pending when we stopped waiting"}`);
+      }
+      process.exit(0);
+    }
+    await archiveSession(sessionId);
+    if (options.json) console.log(JSON.stringify({ sessionId, archived: true }));
+    else console.log(`Archived ${sessionId}`);
+    process.exit(0);
+  } catch (error) {
+    console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+
+export { SESSIONS_HELP, handleSessionsCommand, parseSessionsArgs, permissionFailureRecord };