very-happy-cli 0.2.109 → 0.2.111

package/dist/{index-DaQIcHvY.mjs → index-JAhGeW4_.mjs}

@@ -1,10 +1,10 @@
-import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-DOzPxcth.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-DOzPxcth.mjs';
-import { h as connectionState, A as ApiClient, j as readSettings, k as encodeBase64, l as logger, p as projectPath } from './types-BKCvo4Cv.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-DDN-Yir4.mjs';
+import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-CeXVb_s_.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-CeXVb_s_.mjs';
+import { h as connectionState, A as ApiClient, j as readSettings, k as encodeBase64, l as logger, p as projectPath } from './types-k_ipDb0c.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-vqdqfD1l.mjs';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-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-DO-9Ep72.mjs';
+import { h as initialMachineMetadata, j as createSessionMetadata, k as setupOfflineReconnection, n as notifyDaemonSessionStarted, m as MessageQueue2, o as hashObject, u as startHappyServer, v as registerKillSessionHandler, B as BasePermissionHandler } from './index-Bn-xsguz.mjs';
 import 'node:child_process';
 import '@agentclientprotocol/sdk';
 import 'axios';

package/dist/{index-B2U15moC.cjs → index-SjthsMid.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var index = require('./index-dd2R8uSE.cjs');
+var index = require('./index-BOoGJGQc.cjs');
 var claudeAgentSdk = require('@anthropic-ai/claude-agent-sdk');
 require('chalk');
 require('node:os');
 require('node:crypto');
-require('./types-Cg8zzX_f.cjs');
+require('./types-BG_5QKX5.cjs');
 require('axios');
 require('node:util');
 require('node:fs');

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 require('chalk');
-require('./index-dd2R8uSE.cjs');
-require('./types-Cg8zzX_f.cjs');
+require('./index-BOoGJGQc.cjs');
+require('./types-BG_5QKX5.cjs');
 require('zod');
 require('node:child_process');
 require('node:os');

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import 'chalk';
-import './index-DO-9Ep72.mjs';
-import './types-BKCvo4Cv.mjs';
+import './index-Bn-xsguz.mjs';
+import './types-k_ipDb0c.mjs';
 import 'zod';
 import 'node:child_process';
 import 'node:os';

package/dist/{installTerminalHooks-BDagPTQW.mjs → installTerminalHooks-ADNcNdnB.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-BKCvo4Cv.mjs';
-import { t as tmuxSupportsSessionEnv } from './index-DO-9Ep72.mjs';
+import { p as projectPath } from './types-k_ipDb0c.mjs';
+import { t as tmuxSupportsSessionEnv } from './index-Bn-xsguz.mjs';
 import 'axios';
 import 'node:util';
 import 'node:fs/promises';

package/dist/{installTerminalHooks-BoUmuYdq.cjs → installTerminalHooks-FbKaK149.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-Cg8zzX_f.cjs');
-var index = require('./index-dd2R8uSE.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
+var index = require('./index-BOoGJGQc.cjs');
 require('axios');
 require('node:util');
 require('node:fs/promises');

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var persistence = require('./types-Cg8zzX_f.cjs');
+var persistence = require('./types-BG_5QKX5.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-BKCvo4Cv.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-k_ipDb0c.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{mcp-Ck_y0mCB.mjs → mcp-DHPm_gvL.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-DO-9Ep72.mjs';
+import { p as pushClipboardViaDaemon } from './index-Bn-xsguz.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-BKCvo4Cv.mjs';
+import { l as logger } from './types-k_ipDb0c.mjs';
 import 'chalk';
 import 'node:os';
 import 'node:crypto';

package/dist/{mcp-Du1QEnIf.cjs → mcp-DPp-bYNE.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-dd2R8uSE.cjs');
+var index = require('./index-BOoGJGQc.cjs');
 var limits = require('./limits-KdWKmwtH.cjs');
-var persistence = require('./types-Cg8zzX_f.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
 require('chalk');
 require('node:os');
 require('node:crypto');

package/dist/{runGemini-D20S6Lc3.mjs → runGemini-CWWyjQMz.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-BKCvo4Cv.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-DO-9Ep72.mjs';
-import { A as AcpBackend } from './AcpBackend-DOzPxcth.mjs';
-import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-DnvzvFHR.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-k_ipDb0c.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-Bn-xsguz.mjs';
+import { A as AcpBackend } from './AcpBackend-CeXVb_s_.mjs';
+import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-vGkcq9nM.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{runGemini-DV2M0A_k.cjs → runGemini-D5ySpYIZ.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-Cg8zzX_f.cjs');
-var index = require('./index-dd2R8uSE.cjs');
-var AcpBackend = require('./AcpBackend-Cc4Ilypg.cjs');
-var config = require('./config-DiVKfYr0.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
+var index = require('./index-BOoGJGQc.cjs');
+var AcpBackend = require('./AcpBackend-B_olk79F.cjs');
+var config = require('./config-BR3tkFL_.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/{runOpenClaw-CuuXkfDE.mjs → runOpenClaw-Bv4rUTyJ.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-BKCvo4Cv.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-DDN-Yir4.mjs';
-import { g as initialMachineMetadata, h as createSessionMetadata, j as setupOfflineReconnection, n as notifyDaemonSessionStarted, k as MessageQueue2, u as registerKillSessionHandler } from './index-DO-9Ep72.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-k_ipDb0c.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-vqdqfD1l.mjs';
+import { h as initialMachineMetadata, j as createSessionMetadata, k as setupOfflineReconnection, n as notifyDaemonSessionStarted, m as MessageQueue2, v as registerKillSessionHandler } from './index-Bn-xsguz.mjs';
 import WebSocket from 'ws';
 import * as ed from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2.js';

package/dist/{runOpenClaw-C1Q2zl--.cjs → runOpenClaw-Bwrb1LXP.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-Cg8zzX_f.cjs');
-var AcpSessionManager = require('./AcpSessionManager-CLfzatC_.cjs');
-var index = require('./index-dd2R8uSE.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
+var AcpSessionManager = require('./AcpSessionManager-uXwWO2Tn.cjs');
+var index = require('./index-BOoGJGQc.cjs');
 var WebSocket = require('ws');
 var ed = require('@noble/ed25519');
 var sha2_js = require('@noble/hashes/sha2.js');

package/dist/{send-yUiBqHHL.mjs → send-BlkxFZu4.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-BKCvo4Cv.mjs';
-import { b as sendUserMessage, a as sessionWebUrl } from './index-DO-9Ep72.mjs';
+import { r as readPersistedSessions, c as configuration } from './types-k_ipDb0c.mjs';
+import { d as sendUserMessage, a as sessionWebUrl } from './index-Bn-xsguz.mjs';
 import 'axios';
 import 'node:util';
 import 'node:os';

package/dist/{send-CtgnnJic.cjs → send-DBfSNILO.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var persistence = require('./types-Cg8zzX_f.cjs');
-var index = require('./index-dd2R8uSE.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
+var index = require('./index-BOoGJGQc.cjs');
 require('axios');
 require('node:util');
 require('node:os');

package/dist/{sessions-BsaCq0Do.mjs → sessions-1fW8soBM.mjs}

@@ -1,6 +1,6 @@
 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-DO-9Ep72.mjs';
-import { i as isValidSessionId } from './types-BKCvo4Cv.mjs';
+import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listSessions, r as readSessionTranscript, e as stopSession, f as archiveSession } from './index-Bn-xsguz.mjs';
+import { i as isValidSessionId } from './types-k_ipDb0c.mjs';
 import 'node:os';
 import 'node:crypto';
 import 'cross-spawn';

package/dist/{sessions-CbbZhOTy.cjs → sessions-CVuEsdRl.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var chalk = require('chalk');
-var index = require('./index-dd2R8uSE.cjs');
-var persistence = require('./types-Cg8zzX_f.cjs');
+var index = require('./index-BOoGJGQc.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
 require('node:os');
 require('node:crypto');
 require('cross-spawn');

package/dist/{spawn-BKBY9P3J.mjs → spawn-BorKN3W2.mjs}

@@ -1,8 +1,8 @@
 import chalk from 'chalk';
 import { readFileSync, statSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { c as checkIfDaemonRunningAndCleanupStaleState, s as spawnDaemonSession, a as sessionWebUrl, i as isValidSpawnOrigin, w as waitForSessionKey, b as sendUserMessage } from './index-DO-9Ep72.mjs';
-import { l as logger } from './types-BKCvo4Cv.mjs';
+import { c as checkIfDaemonRunningAndCleanupStaleState, s as spawnDaemonSession, a as sessionWebUrl, i as isValidSpawnOrigin, b as sanitizeSpawnPermissionMode, A as ALLOWED_SPAWN_PERMISSION_MODES, w as waitForSessionKey, d as sendUserMessage } from './index-Bn-xsguz.mjs';
+import { l as logger } from './types-k_ipDb0c.mjs';
 import 'node:os';
 import 'node:crypto';
 import 'cross-spawn';
@@ -46,6 +46,14 @@ import 'node:util';
 import 'url';
 import 'node-pty';
 
+const SPAWN_AGENTS = ["claude", "codex", "gemini", "openclaw"];
+function parseEnvAssignment(raw) {
+  const eq = raw.indexOf("=");
+  if (eq <= 0) throw new Error(`--env expects KEY=VALUE, got: ${raw}`);
+  const key = raw.slice(0, eq);
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`--env key is not a valid variable name: ${key}`);
+  return [key, raw.slice(eq + 1)];
+}
 function parseSpawnArgs(args) {
   const options = { json: false, help: false };
   for (let i = 0; i < args.length; i++) {
@@ -69,6 +77,25 @@ function parseSpawnArgs(args) {
         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 === "--permission-mode") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--permission-mode requires a value");
+      if (sanitizeSpawnPermissionMode(value) === null) {
+        throw new Error(`--permission-mode must be one of: ${ALLOWED_SPAWN_PERMISSION_MODES.join(", ")}`);
+      }
+      options.permissionMode = value;
+    } else if (arg === "--agent") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--agent requires a value");
+      if (!SPAWN_AGENTS.includes(value)) {
+        throw new Error(`--agent must be one of: ${SPAWN_AGENTS.join(", ")}`);
+      }
+      options.agent = value;
+    } else if (arg === "--env") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--env requires a value");
+      const [key, val] = parseEnvAssignment(value);
+      options.env = { ...options.env ?? {}, [key]: val };
     } else if (arg === "--json") {
       options.json = true;
     } else if (arg === "--help" || arg === "-h") {
@@ -87,7 +114,9 @@ function printHelp() {
 ${chalk.bold("very-happy spawn")} - Spawn a remote session via the local daemon (for automation)
 
 ${chalk.bold("Usage:")}
-  very-happy spawn --dir <path> [--prompt <text> | --prompt-file <file>] [--json]
+  very-happy spawn --dir <path> [--prompt <text> | --prompt-file <file>]
+                   [--spawned-by <name>] [--permission-mode <mode>]
+                   [--agent <name>] [--env KEY=VALUE]... [--json]
 
 ${chalk.bold("Options:")}
   --dir, -d <path>       Working directory for the new session (required)
@@ -96,6 +125,17 @@ ${chalk.bold("Options:")}
   --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>.
+  --permission-mode <m>  Permission mode for the new session: default,
+                            acceptEdits, plan, yolo, bypassPermissions.
+                            WITHOUT this the session runs in 'default' and stops
+                            at the first un-allowlisted tool waiting for someone
+                            to approve \u2014 if nothing is watching, it just hangs.
+                            Unattended dispatchers want bypassPermissions.
+  --agent <name>         Backend to run: claude (default), codex, gemini,
+                            openclaw.
+  --env KEY=VALUE        Extra environment for the session process. Repeatable.
+                            \${VAR} is expanded against the daemon's environment;
+                            an unresolved reference fails the spawn.
   --json                 Machine-readable output: {"sessionId", "url"}
   -h, --help             Show this help
 
@@ -161,7 +201,12 @@ async function handleSpawnCommand(args) {
     process.exit(1);
   }
   logger.debug(`[SPAWN CMD] Spawning session in ${directory}`);
-  const result = await spawnDaemonSession(directory, void 0, { spawnedBy: options.spawnedBy });
+  const result = await spawnDaemonSession(directory, void 0, {
+    spawnedBy: options.spawnedBy,
+    permissionMode: options.permissionMode,
+    agent: options.agent,
+    environmentVariables: options.env
+  });
   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}`);
@@ -182,6 +227,12 @@ async function handleSpawnCommand(args) {
     if (options.spawnedBy !== void 0) {
       payload.spawnedBy = options.spawnedBy;
     }
+    if (options.permissionMode !== void 0) {
+      payload.permissionMode = options.permissionMode;
+    }
+    if (options.agent !== void 0) {
+      payload.agent = options.agent;
+    }
     if (prompt !== void 0) {
       payload.promptDelivered = promptError === null;
     }
@@ -204,4 +255,4 @@ async function handleSpawnCommand(args) {
   process.exit(0);
 }
 
-export { handleSpawnCommand, parseSpawnArgs, sessionWebUrl };
+export { SPAWN_AGENTS, handleSpawnCommand, parseEnvAssignment, parseSpawnArgs, sessionWebUrl };

package/dist/{spawn-CTO_hR8v.cjs → spawn-D_ZexrY9.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-dd2R8uSE.cjs');
-var persistence = require('./types-Cg8zzX_f.cjs');
+var index = require('./index-BOoGJGQc.cjs');
+var persistence = require('./types-BG_5QKX5.cjs');
 require('node:os');
 require('node:crypto');
 require('cross-spawn');
@@ -48,6 +48,14 @@ require('node:util');
 require('url');
 require('node-pty');
 
+const SPAWN_AGENTS = ["claude", "codex", "gemini", "openclaw"];
+function parseEnvAssignment(raw) {
+  const eq = raw.indexOf("=");
+  if (eq <= 0) throw new Error(`--env expects KEY=VALUE, got: ${raw}`);
+  const key = raw.slice(0, eq);
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`--env key is not a valid variable name: ${key}`);
+  return [key, raw.slice(eq + 1)];
+}
 function parseSpawnArgs(args) {
   const options = { json: false, help: false };
   for (let i = 0; i < args.length; i++) {
@@ -71,6 +79,25 @@ function parseSpawnArgs(args) {
         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 === "--permission-mode") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--permission-mode requires a value");
+      if (index.sanitizeSpawnPermissionMode(value) === null) {
+        throw new Error(`--permission-mode must be one of: ${index.ALLOWED_SPAWN_PERMISSION_MODES.join(", ")}`);
+      }
+      options.permissionMode = value;
+    } else if (arg === "--agent") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--agent requires a value");
+      if (!SPAWN_AGENTS.includes(value)) {
+        throw new Error(`--agent must be one of: ${SPAWN_AGENTS.join(", ")}`);
+      }
+      options.agent = value;
+    } else if (arg === "--env") {
+      const value = args[++i];
+      if (value === void 0) throw new Error("--env requires a value");
+      const [key, val] = parseEnvAssignment(value);
+      options.env = { ...options.env ?? {}, [key]: val };
     } else if (arg === "--json") {
       options.json = true;
     } else if (arg === "--help" || arg === "-h") {
@@ -89,7 +116,9 @@ function printHelp() {
 ${chalk.bold("very-happy spawn")} - Spawn a remote session via the local daemon (for automation)
 
 ${chalk.bold("Usage:")}
-  very-happy spawn --dir <path> [--prompt <text> | --prompt-file <file>] [--json]
+  very-happy spawn --dir <path> [--prompt <text> | --prompt-file <file>]
+                   [--spawned-by <name>] [--permission-mode <mode>]
+                   [--agent <name>] [--env KEY=VALUE]... [--json]
 
 ${chalk.bold("Options:")}
   --dir, -d <path>       Working directory for the new session (required)
@@ -98,6 +127,17 @@ ${chalk.bold("Options:")}
   --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>.
+  --permission-mode <m>  Permission mode for the new session: default,
+                            acceptEdits, plan, yolo, bypassPermissions.
+                            WITHOUT this the session runs in 'default' and stops
+                            at the first un-allowlisted tool waiting for someone
+                            to approve \u2014 if nothing is watching, it just hangs.
+                            Unattended dispatchers want bypassPermissions.
+  --agent <name>         Backend to run: claude (default), codex, gemini,
+                            openclaw.
+  --env KEY=VALUE        Extra environment for the session process. Repeatable.
+                            \${VAR} is expanded against the daemon's environment;
+                            an unresolved reference fails the spawn.
   --json                 Machine-readable output: {"sessionId", "url"}
   -h, --help             Show this help
 
@@ -163,7 +203,12 @@ async function handleSpawnCommand(args) {
     process.exit(1);
   }
   persistence.logger.debug(`[SPAWN CMD] Spawning session in ${directory}`);
-  const result = await index.spawnDaemonSession(directory, void 0, { spawnedBy: options.spawnedBy });
+  const result = await index.spawnDaemonSession(directory, void 0, {
+    spawnedBy: options.spawnedBy,
+    permissionMode: options.permissionMode,
+    agent: options.agent,
+    environmentVariables: options.env
+  });
   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}`);
@@ -184,6 +229,12 @@ async function handleSpawnCommand(args) {
     if (options.spawnedBy !== void 0) {
       payload.spawnedBy = options.spawnedBy;
     }
+    if (options.permissionMode !== void 0) {
+      payload.permissionMode = options.permissionMode;
+    }
+    if (options.agent !== void 0) {
+      payload.agent = options.agent;
+    }
     if (prompt !== void 0) {
       payload.promptDelivered = promptError === null;
     }
@@ -207,5 +258,7 @@ async function handleSpawnCommand(args) {
 }
 
 exports.sessionWebUrl = index.sessionWebUrl;
+exports.SPAWN_AGENTS = SPAWN_AGENTS;
 exports.handleSpawnCommand = handleSpawnCommand;
+exports.parseEnvAssignment = parseEnvAssignment;
 exports.parseSpawnArgs = parseSpawnArgs;

package/dist/{types-Cg8zzX_f.cjs → types-BG_5QKX5.cjs}

@@ -51,7 +51,7 @@ var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 var pty__namespace = /*#__PURE__*/_interopNamespaceDefault(pty);
 
 var name = "very-happy-cli";
-var version = "0.2.109";
+var version = "0.2.111";
 var description = "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.";
 var author = "Kirill Dubovitskiy";
 var contributors = [
@@ -164,12 +164,12 @@ var dependencies = {
 	zod: "^4.0.0"
 };
 var optionalDependencies = {
-	"very-happy-tools-arm64-darwin": "0.2.109",
-	"very-happy-tools-x64-darwin": "0.2.109",
-	"very-happy-tools-arm64-linux": "0.2.109",
-	"very-happy-tools-x64-linux": "0.2.109",
-	"very-happy-tools-arm64-win32": "0.2.109",
-	"very-happy-tools-x64-win32": "0.2.109"
+	"very-happy-tools-arm64-darwin": "0.2.111",
+	"very-happy-tools-x64-darwin": "0.2.111",
+	"very-happy-tools-arm64-linux": "0.2.111",
+	"very-happy-tools-x64-linux": "0.2.111",
+	"very-happy-tools-arm64-win32": "0.2.111",
+	"very-happy-tools-x64-win32": "0.2.111"
 };
 var devDependencies = {
 	"@slopus/happy-wire": "workspace:*",
@@ -1603,7 +1603,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-Cg8zzX_f.cjs', document.baseURI).href))));
+const __dirname$1 = path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-BG_5QKX5.cjs', document.baseURI).href))));
 function projectPath() {
   const path = path$1.resolve(__dirname$1, "..");
   return path;
@@ -15778,6 +15778,13 @@ class NotificationProducer {
 }
 const DEDUP_WINDOW_MS = 3e3;
 
+function describeSessionCreateError(error) {
+  const base = error instanceof Error ? error.message : "Unknown error";
+  if (!axios.isAxiosError(error) || !error.response) return base;
+  const data = error.response.data;
+  const code = data && typeof data === "object" && typeof data.error === "string" ? data.error : null;
+  return code ? `${base} (${code})` : base;
+}
 class ApiClient {
   static async create(credential) {
     return new ApiClient(credential);
@@ -15873,7 +15880,7 @@ class ApiClient {
           return null;
         }
       }
-      throw new Error(`Failed to get or create session: ${error instanceof Error ? error.message : "Unknown error"}`);
+      throw new Error(`Failed to get or create session: ${describeSessionCreateError(error)}`);
     }
   }
   /**
@@ -16252,7 +16259,8 @@ class ApiClient {
 
 var api = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  ApiClient: ApiClient
+  ApiClient: ApiClient,
+  describeSessionCreateError: describeSessionCreateError
 });
 
 const UsageSchema = z.z.object({

package/dist/{types-BKCvo4Cv.mjs → types-k_ipDb0c.mjs}

@@ -29,7 +29,7 @@ import { SandboxManager } from '@anthropic-ai/sandbox-runtime';
 import { Expo } from 'expo-server-sdk';
 
 var name = "very-happy-cli";
-var version = "0.2.109";
+var version = "0.2.111";
 var description = "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.";
 var author = "Kirill Dubovitskiy";
 var contributors = [
@@ -142,12 +142,12 @@ var dependencies = {
 	zod: "^4.0.0"
 };
 var optionalDependencies = {
-	"very-happy-tools-arm64-darwin": "0.2.109",
-	"very-happy-tools-x64-darwin": "0.2.109",
-	"very-happy-tools-arm64-linux": "0.2.109",
-	"very-happy-tools-x64-linux": "0.2.109",
-	"very-happy-tools-arm64-win32": "0.2.109",
-	"very-happy-tools-x64-win32": "0.2.109"
+	"very-happy-tools-arm64-darwin": "0.2.111",
+	"very-happy-tools-x64-darwin": "0.2.111",
+	"very-happy-tools-arm64-linux": "0.2.111",
+	"very-happy-tools-x64-linux": "0.2.111",
+	"very-happy-tools-arm64-win32": "0.2.111",
+	"very-happy-tools-x64-win32": "0.2.111"
 };
 var devDependencies = {
 	"@slopus/happy-wire": "workspace:*",
@@ -15756,6 +15756,13 @@ class NotificationProducer {
 }
 const DEDUP_WINDOW_MS = 3e3;
 
+function describeSessionCreateError(error) {
+  const base = error instanceof Error ? error.message : "Unknown error";
+  if (!axios.isAxiosError(error) || !error.response) return base;
+  const data = error.response.data;
+  const code = data && typeof data === "object" && typeof data.error === "string" ? data.error : null;
+  return code ? `${base} (${code})` : base;
+}
 class ApiClient {
   static async create(credential) {
     return new ApiClient(credential);
@@ -15851,7 +15858,7 @@ class ApiClient {
           return null;
         }
       }
-      throw new Error(`Failed to get or create session: ${error instanceof Error ? error.message : "Unknown error"}`);
+      throw new Error(`Failed to get or create session: ${describeSessionCreateError(error)}`);
     }
   }
   /**
@@ -16230,7 +16237,8 @@ class ApiClient {
 
 var api = /*#__PURE__*/Object.freeze({
   __proto__: null,
-  ApiClient: ApiClient
+  ApiClient: ApiClient,
+  describeSessionCreateError: describeSessionCreateError
 });
 
 const UsageSchema = z$1.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "very-happy-cli",
-  "version": "0.2.109",
+  "version": "0.2.111",
   "description": "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.",
   "author": "Kirill Dubovitskiy",
   "contributors": [
@@ -113,12 +113,12 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "very-happy-tools-arm64-darwin": "0.2.109",
-    "very-happy-tools-x64-darwin": "0.2.109",
-    "very-happy-tools-arm64-linux": "0.2.109",
-    "very-happy-tools-x64-linux": "0.2.109",
-    "very-happy-tools-arm64-win32": "0.2.109",
-    "very-happy-tools-x64-win32": "0.2.109"
+    "very-happy-tools-arm64-darwin": "0.2.111",
+    "very-happy-tools-x64-darwin": "0.2.111",
+    "very-happy-tools-arm64-linux": "0.2.111",
+    "very-happy-tools-x64-linux": "0.2.111",
+    "very-happy-tools-arm64-win32": "0.2.111",
+    "very-happy-tools-x64-win32": "0.2.111"
   },
   "devDependencies": {
     "@slopus/happy-wire": "workspace:*",