very-happy-cli 0.2.108 → 0.2.110

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 require('chalk');
-require('./index-DM0Ku1Rv.cjs');
-require('./types-D4bwyM-D.cjs');
+require('./index-CvnMiYgh.cjs');
+require('./types--t4zLibT.cjs');
 require('zod');
 require('node:child_process');
 require('node:os');

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import 'chalk';
-import './index-CzSv4d_S.mjs';
-import './types-D0-nhvuW.mjs';
+import './index-BW9kDx5m.mjs';
+import './types-BdO0jg7G.mjs';
 import 'zod';
 import 'node:child_process';
 import 'node:os';

package/dist/{installTerminalHooks-Cs49gg_E.mjs → installTerminalHooks-CJyoR9jp.mjs}

@@ -3,8 +3,8 @@ import { join, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { spawnSync } from 'node:child_process';
 import chalk from 'chalk';
-import { p as projectPath } from './types-D0-nhvuW.mjs';
-import { t as tmuxSupportsSessionEnv } from './index-CzSv4d_S.mjs';
+import { p as projectPath } from './types-BdO0jg7G.mjs';
+import { t as tmuxSupportsSessionEnv } from './index-BW9kDx5m.mjs';
 import 'axios';
 import 'node:util';
 import 'node:fs/promises';

package/dist/{installTerminalHooks-BpvWmkZ9.cjs → installTerminalHooks-DhQ6k7YD.cjs}

@@ -5,8 +5,8 @@ var path = require('node:path');
 var os = require('node:os');
 var node_child_process = require('node:child_process');
 var chalk = require('chalk');
-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('node:util');
 require('node:fs/promises');

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var persistence = require('./types-D4bwyM-D.cjs');
+var persistence = require('./types--t4zLibT.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/lib.mjs

@@ -1,4 +1,4 @@
-export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-D0-nhvuW.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-BdO0jg7G.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{mcp-DY17lhMH.mjs → mcp-BO9-sxMr.mjs}

@@ -1,9 +1,9 @@
 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-CzSv4d_S.mjs';
+import { p as pushClipboardViaDaemon } from './index-BW9kDx5m.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-D0-nhvuW.mjs';
+import { l as logger } from './types-BdO0jg7G.mjs';
 import 'chalk';
 import 'node:os';
 import 'node:crypto';

package/dist/{mcp-rTSmj-tn.cjs → mcp-Dr1PegOw.cjs}

@@ -3,9 +3,9 @@
 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-DM0Ku1Rv.cjs');
+var index = require('./index-CvnMiYgh.cjs');
 var limits = require('./limits-KdWKmwtH.cjs');
-var persistence = require('./types-D4bwyM-D.cjs');
+var persistence = require('./types--t4zLibT.cjs');
 require('chalk');
 require('node:os');
 require('node:crypto');

package/dist/{runGemini-Bqs52hw_.mjs → runGemini-CuzqF6Ys.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, i as readSettings, e as errorLogMetadata, j as encodeBase64, p as projectPath, d as contentLogMetadata } from './types-D0-nhvuW.mjs';
-import { g as GEMINI_API_KEY_ENV, j as GOOGLE_API_KEY_ENV, G as GEMINI_MODEL_ENV, B as BasePermissionHandler, k as BaseReasoningProcessor, i as initialMachineMetadata, d as createSessionMetadata, e as setupOfflineReconnection, n as notifyDaemonSessionStarted, M as MessageQueue2, h as hashObject, l as MessageBuffer, C as CHANGE_TITLE_INSTRUCTION, r as registerKillSessionHandler, f as startHappyServer } from './index-CzSv4d_S.mjs';
-import { A as AcpBackend } from './AcpBackend-DwR8rrkS.mjs';
-import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-DKMwLc1k.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-BdO0jg7G.mjs';
+import { v as GEMINI_API_KEY_ENV, x as GOOGLE_API_KEY_ENV, G as GEMINI_MODEL_ENV, B as BasePermissionHandler, y as BaseReasoningProcessor, g as initialMachineMetadata, h as createSessionMetadata, j as setupOfflineReconnection, n as notifyDaemonSessionStarted, k as MessageQueue2, m as hashObject, z as MessageBuffer, C as CHANGE_TITLE_INSTRUCTION, u as registerKillSessionHandler, o as startHappyServer } from './index-BW9kDx5m.mjs';
+import { A as AcpBackend } from './AcpBackend-DzZR7TEv.mjs';
+import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-CTyyVXHj.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{runGemini-B3Mme1zr.cjs → runGemini-D6Wwfk_0.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-D4bwyM-D.cjs');
-var index = require('./index-DM0Ku1Rv.cjs');
-var AcpBackend = require('./AcpBackend-D4vV6SVl.cjs');
-var config = require('./config-BvVwprR0.cjs');
+var persistence = require('./types--t4zLibT.cjs');
+var index = require('./index-CvnMiYgh.cjs');
+var AcpBackend = require('./AcpBackend-D0_wbTs6.cjs');
+var config = require('./config-CTCGilz_.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/{runOpenClaw-CpbsQ7NZ.mjs → runOpenClaw-B5pkmSTb.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 { k as ensurePrivateDirectorySync, m as hardenPrivateFileSync, w as writePrivateFileSync, e as errorLogMetadata, d as contentLogMetadata, h as connectionState, A as ApiClient, i as readSettings, j as encodeBase64, l as logger, c as configuration } from './types-D0-nhvuW.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-C057dkLF.mjs';
-import { i as initialMachineMetadata, d as createSessionMetadata, e as setupOfflineReconnection, n as notifyDaemonSessionStarted, M as MessageQueue2, r as registerKillSessionHandler } from './index-CzSv4d_S.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-BdO0jg7G.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-tWuFWeIF.mjs';
+import { g as initialMachineMetadata, h as createSessionMetadata, j as setupOfflineReconnection, n as notifyDaemonSessionStarted, k as MessageQueue2, u as registerKillSessionHandler } from './index-BW9kDx5m.mjs';
 import WebSocket from 'ws';
 import * as ed from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2.js';

package/dist/{runOpenClaw-B2V9j9Le.cjs → runOpenClaw-BYmlS-4Q.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-D4bwyM-D.cjs');
-var AcpSessionManager = require('./AcpSessionManager-CPHDZ-nz.cjs');
-var index = require('./index-DM0Ku1Rv.cjs');
+var persistence = require('./types--t4zLibT.cjs');
+var AcpSessionManager = require('./AcpSessionManager-Dcj_iHw8.cjs');
+var index = require('./index-CvnMiYgh.cjs');
 var WebSocket = require('ws');
 var ed = require('@noble/ed25519');
 var sha2_js = require('@noble/hashes/sha2.js');

package/dist/{send-uHgpvIqm.mjs → send-Btz1IZ9U.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-D0-nhvuW.mjs';
-import { b as sendUserMessage, a as sessionWebUrl } from './index-CzSv4d_S.mjs';
+import { r as readPersistedSessions, c as configuration } from './types-BdO0jg7G.mjs';
+import { b as sendUserMessage, a as sessionWebUrl } from './index-BW9kDx5m.mjs';
 import 'axios';
 import 'node:util';
 import 'node:os';

package/dist/{send-CLdMBQ8e.cjs → send-CuajooZC.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-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('node:util');
 require('node:os');

package/dist/sessions-CVUBS3LG.cjs

@@ -0,0 +1,204 @@
+'use strict';
+
+var chalk = require('chalk');
+var index = require('./index-CvnMiYgh.cjs');
+var persistence = require('./types--t4zLibT.cjs');
+require('node:os');
+require('node:crypto');
+require('cross-spawn');
+require('node:path');
+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');
+require('expo-server-sdk');
+require('crypto');
+require('ps-list');
+require('tmp');
+require('open');
+require('fastify');
+require('zod');
+require('fastify-type-provider-zod');
+require('node:module');
+require('@modelcontextprotocol/sdk/server/mcp.js');
+require('node:http');
+require('@modelcontextprotocol/sdk/server/streamableHttp.js');
+require('./limits-KdWKmwtH.cjs');
+require('http');
+require('util');
+require('inquirer');
+require('node:url');
+require('node:readline/promises');
+require('node:util');
+require('url');
+require('node-pty');
+
+const ACTIONS_NEEDING_ID = /* @__PURE__ */ new Set(["read", "stop", "archive"]);
+function parseSessionsArgs(args) {
+  const options = { action: "help", json: false };
+  let actionSeen = false;
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      return { action: "help", json: false };
+    } else if (arg === "--json") {
+      options.json = true;
+    } 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 (arg !== "list" && arg !== "read" && arg !== "stop" && arg !== "archive") {
+        throw new Error(`Unknown action: ${arg} (expected list, read, stop or archive)`);
+      }
+      options.action = arg;
+      actionSeen = true;
+    } else {
+      positionals.push(arg);
+    }
+  }
+  if (!actionSeen) return { action: "help", json: false };
+  if (positionals.length > 1) throw new Error(`Unexpected extra argument: ${positionals[1]}`);
+  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 (!persistence.isValidSessionId(id)) throw new Error(`Invalid session id: ${id}`);
+    options.sessionId = id;
+  } else if (positionals.length > 0) {
+    throw new Error(`Unexpected argument: ${positionals[0]}`);
+  }
+  if (options.action !== "list" && options.tag !== void 0) {
+    throw new Error("--tag only applies to `sessions list`");
+  }
+  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 [--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]
+
+${chalk.bold("Actions:")}
+  list       Running sessions plus recently seen ones, newest first.
+  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).
+
+${chalk.bold("Options:")}
+  --tag <name>   list only: keep sessions carrying this origin tag (see
+                 \`spawn --spawned-by\`).
+  --limit <n>    list: how many NOT-running sessions to include (default ${index.DEFAULT_RECENT_LIMIT};
+                 running ones are never cut). read: how many messages
+                 (default 20, max ${index.MAX_READ_LIMIT}).
+  --json         Machine-readable output.
+  -h, --help     Show this help
+
+${chalk.bold("Scope:")}
+  This machine only. Reads need the session key from ~/.happy/sessions.json,
+  which exists for sessions this machine's daemon spawned and is pruned after
+  14 days. A session on another machine cannot be read or stopped from here.
+
+${chalk.bold("Exit codes:")}
+  0  success
+  1  bad arguments, unknown session, no local key, or the operation failed
+     (including \`stop\` on a session the daemon is not running)
+`;
+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") {
+      const sessions = await index.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 index.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 index.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);
+    }
+    await index.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);
+  }
+}
+
+exports.SESSIONS_HELP = SESSIONS_HELP;
+exports.handleSessionsCommand = handleSessionsCommand;
+exports.parseSessionsArgs = parseSessionsArgs;

package/dist/sessions-DDwCphTQ.mjs

@@ -0,0 +1,200 @@
+import chalk from 'chalk';
+import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listSessions, r as readSessionTranscript, d as stopSession, e as archiveSession } from './index-BW9kDx5m.mjs';
+import { i as isValidSessionId } from './types-BdO0jg7G.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_NEEDING_ID = /* @__PURE__ */ new Set(["read", "stop", "archive"]);
+function parseSessionsArgs(args) {
+  const options = { action: "help", json: false };
+  let actionSeen = false;
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      return { action: "help", json: false };
+    } else if (arg === "--json") {
+      options.json = true;
+    } 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 (arg !== "list" && arg !== "read" && arg !== "stop" && arg !== "archive") {
+        throw new Error(`Unknown action: ${arg} (expected list, read, stop or archive)`);
+      }
+      options.action = arg;
+      actionSeen = true;
+    } else {
+      positionals.push(arg);
+    }
+  }
+  if (!actionSeen) return { action: "help", json: false };
+  if (positionals.length > 1) throw new Error(`Unexpected extra argument: ${positionals[1]}`);
+  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;
+  } else if (positionals.length > 0) {
+    throw new Error(`Unexpected argument: ${positionals[0]}`);
+  }
+  if (options.action !== "list" && options.tag !== void 0) {
+    throw new Error("--tag only applies to `sessions list`");
+  }
+  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 [--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]
+
+${chalk.bold("Actions:")}
+  list       Running sessions plus recently seen ones, newest first.
+  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).
+
+${chalk.bold("Options:")}
+  --tag <name>   list only: keep sessions carrying this origin tag (see
+                 \`spawn --spawned-by\`).
+  --limit <n>    list: how many NOT-running sessions to include (default ${DEFAULT_RECENT_LIMIT};
+                 running ones are never cut). read: how many messages
+                 (default 20, max ${MAX_READ_LIMIT}).
+  --json         Machine-readable output.
+  -h, --help     Show this help
+
+${chalk.bold("Scope:")}
+  This machine only. Reads need the session key from ~/.happy/sessions.json,
+  which exists for sessions this machine's daemon spawned and is pruned after
+  14 days. A session on another machine cannot be read or stopped from here.
+
+${chalk.bold("Exit codes:")}
+  0  success
+  1  bad arguments, unknown session, no local key, or the operation failed
+     (including \`stop\` on a session the daemon is not running)
+`;
+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") {
+      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);
+    }
+    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 };

package/dist/{spawn-BXbVzbMs.cjs → spawn-CwS8CPbr.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-DM0Ku1Rv.cjs');
-var persistence = require('./types-D4bwyM-D.cjs');
+var index = require('./index-CvnMiYgh.cjs');
+var persistence = require('./types--t4zLibT.cjs');
 require('node:os');
 require('node:crypto');
 require('cross-spawn');
@@ -64,6 +64,13 @@ function parseSpawnArgs(args) {
       const value = args[++i];
       if (value === void 0) throw new Error("--prompt-file requires a value");
       options.promptFile = value;
+    } else if (arg === "--spawned-by") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--spawned-by requires a value");
+      if (!index.isValidSpawnOrigin(value)) {
+        throw new Error("--spawned-by must be 1-24 chars of [a-z0-9] plus - or _, starting with a letter or digit");
+      }
+      options.spawnedBy = value;
     } else if (arg === "--json") {
       options.json = true;
     } else if (arg === "--help" || arg === "-h") {
@@ -88,6 +95,9 @@ ${chalk.bold("Options:")}
   --dir, -d <path>       Working directory for the new session (required)
   --prompt, -p <text>    First message to send after the session starts
   --prompt-file <file>   Read the first message from a file (UTF-8)
+  --spawned-by <name>    Tag the new session with its origin (e.g. tanka).
+                            1-24 chars: [a-z0-9] plus - or _. Shows as a chip in
+                            the web list and is searchable as #<name>.
   --json                 Machine-readable output: {"sessionId", "url"}
   -h, --help             Show this help
 
@@ -153,7 +163,7 @@ async function handleSpawnCommand(args) {
     process.exit(1);
   }
   persistence.logger.debug(`[SPAWN CMD] Spawning session in ${directory}`);
-  const result = await index.spawnDaemonSession(directory);
+  const result = await index.spawnDaemonSession(directory, void 0, { spawnedBy: options.spawnedBy });
   if (result?.error || !result?.success || !result?.sessionId) {
     const message = result?.error || "Daemon returned no session ID";
     console.error(chalk.red("Error:"), `Failed to spawn session: ${message}`);
@@ -171,6 +181,9 @@ async function handleSpawnCommand(args) {
   }
   if (options.json) {
     const payload = { sessionId, url };
+    if (options.spawnedBy !== void 0) {
+      payload.spawnedBy = options.spawnedBy;
+    }
     if (prompt !== void 0) {
       payload.promptDelivered = promptError === null;
     }