very-happy-cli 0.2.77 → 0.2.79

package/dist/lib.d.cts

@@ -1,3 +1,4 @@
+import * as _anthropic_ai_claude_agent_sdk from '@anthropic-ai/claude-agent-sdk';
 import * as z from 'zod';
 import { z as z$1 } from 'zod';
 import { EventEmitter } from 'node:events';
@@ -67,6 +68,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
             failed: "failed";
             cancelled: "cancelled";
         }>;
+        error: z.ZodOptional<z.ZodString>;
         costUsd: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         numTurns: z.ZodOptional<z.ZodNumber>;
@@ -273,6 +275,7 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         terminals: z$1.ZodArray<z$1.ZodObject<{
             id: z$1.ZodString;
             title: z$1.ZodOptional<z$1.ZodString>;
+            tags: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
             cwd: z$1.ZodOptional<z$1.ZodString>;
             createdAt: z$1.ZodOptional<z$1.ZodNumber>;
             activityAt: z$1.ZodOptional<z$1.ZodNumber>;
@@ -475,6 +478,8 @@ type AgentState$1 = {
             tool: string;
             arguments: any;
             createdAt: number;
+            kind?: 'tool' | 'elicitation' | 'user_dialog';
+            permissionSuggestions?: _anthropic_ai_claude_agent_sdk.PermissionUpdate[];
         };
     };
     completedRequests?: {
@@ -487,7 +492,7 @@ type AgentState$1 = {
             reason?: string;
             mode?: PermissionMode;
             decision?: 'approved' | 'approved_for_session' | 'denied' | 'abort';
-            allowTools?: string[];
+            allowedTools?: string[];
         };
     };
 };
@@ -733,7 +738,9 @@ declare class ApiSessionClient extends EventEmitter {
          *  unique constraint swallow every envelope after the first. */
         localIdFor?: (envelopeIndex: number) => string;
     }): void;
-    closeClaudeSessionTurn(status?: SessionTurnEndStatus): void;
+    closeClaudeSessionTurn(status?: SessionTurnEndStatus, meta?: {
+        error?: string;
+    }): void;
     sendCodexMessage(body: any): void;
     private enqueueSessionProtocolEnvelope;
     sendSessionProtocolMessage(envelope: SessionEnvelope, localId?: string): void;
@@ -974,6 +981,8 @@ type AgentState = 'working' | 'needs_input' | 'idle' | 'shell';
 interface TerminalListItem {
     id: string;
     title?: string;
+    /** Always present in new daemon output; optional for old persisted state. */
+    tags?: string[];
     cwd?: string;
     createdAt?: number;
     activityAt?: number;

package/dist/lib.d.mts

@@ -1,3 +1,4 @@
+import * as _anthropic_ai_claude_agent_sdk from '@anthropic-ai/claude-agent-sdk';
 import * as z from 'zod';
 import { z as z$1 } from 'zod';
 import { EventEmitter } from 'node:events';
@@ -67,6 +68,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
             failed: "failed";
             cancelled: "cancelled";
         }>;
+        error: z.ZodOptional<z.ZodString>;
         costUsd: z.ZodOptional<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
         numTurns: z.ZodOptional<z.ZodNumber>;
@@ -273,6 +275,7 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         terminals: z$1.ZodArray<z$1.ZodObject<{
             id: z$1.ZodString;
             title: z$1.ZodOptional<z$1.ZodString>;
+            tags: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
             cwd: z$1.ZodOptional<z$1.ZodString>;
             createdAt: z$1.ZodOptional<z$1.ZodNumber>;
             activityAt: z$1.ZodOptional<z$1.ZodNumber>;
@@ -475,6 +478,8 @@ type AgentState$1 = {
             tool: string;
             arguments: any;
             createdAt: number;
+            kind?: 'tool' | 'elicitation' | 'user_dialog';
+            permissionSuggestions?: _anthropic_ai_claude_agent_sdk.PermissionUpdate[];
         };
     };
     completedRequests?: {
@@ -487,7 +492,7 @@ type AgentState$1 = {
             reason?: string;
             mode?: PermissionMode;
             decision?: 'approved' | 'approved_for_session' | 'denied' | 'abort';
-            allowTools?: string[];
+            allowedTools?: string[];
         };
     };
 };
@@ -733,7 +738,9 @@ declare class ApiSessionClient extends EventEmitter {
          *  unique constraint swallow every envelope after the first. */
         localIdFor?: (envelopeIndex: number) => string;
     }): void;
-    closeClaudeSessionTurn(status?: SessionTurnEndStatus): void;
+    closeClaudeSessionTurn(status?: SessionTurnEndStatus, meta?: {
+        error?: string;
+    }): void;
     sendCodexMessage(body: any): void;
     private enqueueSessionProtocolEnvelope;
     sendSessionProtocolMessage(envelope: SessionEnvelope, localId?: string): void;
@@ -974,6 +981,8 @@ type AgentState = 'working' | 'needs_input' | 'idle' | 'shell';
 interface TerminalListItem {
     id: string;
     title?: string;
+    /** Always present in new daemon output; optional for old persisted state. */
+    tags?: string[];
     cwd?: string;
     createdAt?: number;
     activityAt?: number;

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-D2qSKjsO.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-BRDN6zN2.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{mcp-CsKnmeE5.cjs → mcp-DhQcmKO7.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-Dcv1RKe8.cjs');
+var index = require('./index-BGvGqzc1.cjs');
 var limits = require('./limits-KdWKmwtH.cjs');
-var persistence = require('./types-NwtcBgfS.cjs');
+var persistence = require('./types-Dy7P_1bh.cjs');
 require('chalk');
 require('node:os');
 require('node:crypto');

package/dist/{mcp-B-GdhlKD.mjs → mcp-DhUA22wj.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-DOb57EGb.mjs';
+import { p as pushClipboardViaDaemon } from './index-HYOkniru.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-D2qSKjsO.mjs';
+import { l as logger } from './types-BRDN6zN2.mjs';
 import 'chalk';
 import 'node:os';
 import 'node:crypto';

package/dist/{runGemini-D0lddF43.mjs → runGemini-BVxviS8T.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-D2qSKjsO.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-DOb57EGb.mjs';
-import { A as AcpBackend } from './AcpBackend-BFFC77vV.mjs';
-import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-CRFTYuTN.mjs';
+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-BRDN6zN2.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-HYOkniru.mjs';
+import { A as AcpBackend } from './AcpBackend-DPcRh_3n.mjs';
+import { readGeminiLocalConfig, determineGeminiModel, getGeminiModelSource, getInitialGeminiModel, saveGeminiModelToConfig } from './config-T7eM_8eT.mjs';
 import 'axios';
 import 'chalk';
 import 'node:util';

package/dist/{runGemini-DuUdmlVZ.cjs → runGemini-CfWCL9K7.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-NwtcBgfS.cjs');
-var index = require('./index-Dcv1RKe8.cjs');
-var AcpBackend = require('./AcpBackend-CsLnh1So.cjs');
-var config = require('./config-pv17N6Kg.cjs');
+var persistence = require('./types-Dy7P_1bh.cjs');
+var index = require('./index-BGvGqzc1.cjs');
+var AcpBackend = require('./AcpBackend-BuxJntPo.cjs');
+var config = require('./config-DB0v5eoc.cjs');
 require('axios');
 require('chalk');
 require('node:util');

package/dist/{runOpenClaw-BiwwYnYf.mjs → runOpenClaw-DVTaZJtj.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-D2qSKjsO.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-CU5vsxgF.mjs';
-import { i as initialMachineMetadata, d as createSessionMetadata, e as setupOfflineReconnection, n as notifyDaemonSessionStarted, M as MessageQueue2, r as registerKillSessionHandler } from './index-DOb57EGb.mjs';
+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-BRDN6zN2.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-DVGWPtBC.mjs';
+import { i as initialMachineMetadata, d as createSessionMetadata, e as setupOfflineReconnection, n as notifyDaemonSessionStarted, M as MessageQueue2, r as registerKillSessionHandler } from './index-HYOkniru.mjs';
 import WebSocket from 'ws';
 import * as ed from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2.js';

package/dist/{runOpenClaw-DEMCYSoD.cjs → runOpenClaw-kSy7Os3C.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-NwtcBgfS.cjs');
-var AcpSessionManager = require('./AcpSessionManager--CixPN-p.cjs');
-var index = require('./index-Dcv1RKe8.cjs');
+var persistence = require('./types-Dy7P_1bh.cjs');
+var AcpSessionManager = require('./AcpSessionManager-BOZPQZUQ.cjs');
+var index = require('./index-BGvGqzc1.cjs');
 var WebSocket = require('ws');
 var ed = require('@noble/ed25519');
 var sha2_js = require('@noble/hashes/sha2.js');

package/dist/{send-DM8oqJFp.mjs → send-DjjJQXJt.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-D2qSKjsO.mjs';
-import { b as sendUserMessage, a as sessionWebUrl } from './index-DOb57EGb.mjs';
+import { r as readPersistedSessions, c as configuration } from './types-BRDN6zN2.mjs';
+import { b as sendUserMessage, a as sessionWebUrl } from './index-HYOkniru.mjs';
 import 'axios';
 import 'node:util';
 import 'node:os';

package/dist/{send-DijSXAMp.cjs → send-jzwPToBN.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var persistence = require('./types-NwtcBgfS.cjs');
-var index = require('./index-Dcv1RKe8.cjs');
+var persistence = require('./types-Dy7P_1bh.cjs');
+var index = require('./index-BGvGqzc1.cjs');
 require('axios');
 require('node:util');
 require('node:os');

package/dist/{spawn-nISXbZD5.mjs → spawn-DBpgsEkS.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, w as waitForSessionKey, b as sendUserMessage } from './index-DOb57EGb.mjs';
-import { l as logger } from './types-D2qSKjsO.mjs';
+import { c as checkIfDaemonRunningAndCleanupStaleState, s as spawnDaemonSession, a as sessionWebUrl, w as waitForSessionKey, b as sendUserMessage } from './index-HYOkniru.mjs';
+import { l as logger } from './types-BRDN6zN2.mjs';
 import 'node:os';
 import 'node:crypto';
 import 'cross-spawn';

package/dist/{spawn-De3b5Hsu.cjs → spawn-DFnYIiKP.cjs}

@@ -3,8 +3,8 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-Dcv1RKe8.cjs');
-var persistence = require('./types-NwtcBgfS.cjs');
+var index = require('./index-BGvGqzc1.cjs');
+var persistence = require('./types-Dy7P_1bh.cjs');
 require('node:os');
 require('node:crypto');
 require('cross-spawn');

package/dist/{types-D2qSKjsO.mjs → types-BRDN6zN2.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.77";
+var version = "0.2.79";
 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.77",
-	"very-happy-tools-x64-darwin": "0.2.77",
-	"very-happy-tools-arm64-linux": "0.2.77",
-	"very-happy-tools-x64-linux": "0.2.77",
-	"very-happy-tools-arm64-win32": "0.2.77",
-	"very-happy-tools-x64-win32": "0.2.77"
+	"very-happy-tools-arm64-darwin": "0.2.79",
+	"very-happy-tools-x64-darwin": "0.2.79",
+	"very-happy-tools-arm64-linux": "0.2.79",
+	"very-happy-tools-x64-linux": "0.2.79",
+	"very-happy-tools-arm64-win32": "0.2.79",
+	"very-happy-tools-x64-win32": "0.2.79"
 };
 var devDependencies = {
 	"@slopus/happy-wire": "workspace:*",
@@ -672,6 +672,9 @@ const sessionTurnUsageSchema = z.object({
 const sessionTurnEndEventSchema = z.object({
   t: z.literal("turn-end"),
   status: sessionTurnEndStatusSchema,
+  // Human-readable SDK failure detail. Optional for backward compatibility;
+  // successful and cancelled turns normally omit it.
+  error: z.string().optional(),
   // Optional per-turn metadata sourced from the SDK result message. Present
   // only on turns ended by a result event; absent on lazily-closed turns.
   costUsd: z.number().optional(),
@@ -938,6 +941,9 @@ const CliUpdateStateSchema = z$1.object({
 const WebTerminalListItemSchema = z$1.object({
   id: z$1.string(),
   title: z$1.string().optional(),
+  /** New daemons always send an array (including []); absence identifies an
+   * old daemon that cannot persist terminal tags. */
+  tags: z$1.array(z$1.string()).optional(),
   cwd: z$1.string().optional(),
   createdAt: z$1.number().optional(),
   activityAt: z$1.number().optional(),
@@ -2444,12 +2450,14 @@ function closeTurn(state, status, envelopes, meta) {
   envelopes.push(createEnvelope("agent", {
     t: "turn-end",
     status,
+    ...meta?.error ? { error: meta.error } : {},
     ...typeof meta?.costUsd === "number" ? { costUsd: meta.costUsd } : {},
     ...typeof meta?.durationMs === "number" ? { durationMs: meta.durationMs } : {},
     ...typeof meta?.numTurns === "number" ? { numTurns: meta.numTurns } : {},
     ...meta?.usage ? { usage: meta.usage } : {}
   }, { turn: state.currentTurnId }));
   state.currentTurnId = null;
+  state.pendingAssistantError = void 0;
   clearSubagentTracking(state);
 }
 function toolTitle(name, input) {
@@ -2470,9 +2478,9 @@ function toToolArgs(input) {
   }
   return { input };
 }
-function closeClaudeTurnWithStatus(state, status) {
+function closeClaudeTurnWithStatus(state, status, meta) {
   const envelopes = [];
-  closeTurn(state, status, envelopes);
+  closeTurn(state, status, envelopes, meta);
   return {
     currentTurnId: state.currentTurnId,
     envelopes
@@ -2513,6 +2521,10 @@ function mapClaudeLogMessageToSessionEnvelopesInternal(message, state) {
     };
   }
   if (message.type === "assistant") {
+    const assistantError = message.error;
+    if (!message.isSidechain && typeof assistantError === "string" && assistantError.trim()) {
+      state.pendingAssistantError = assistantError.trim();
+    }
     const turnId = ensureTurn(state, envelopes);
     maybeEmitSubagentStart(state, turnId, subagent, envelopes);
     const usage = pickAssistantUsage(message);
@@ -2634,6 +2646,10 @@ function mapClaudeLogMessageToSessionEnvelopesInternal(message, state) {
   if (message.type === "result") {
     const raw = message;
     const status = raw.is_error === true ? "failed" : "completed";
+    const error = status === "failed" ? raw.errors?.filter((item) => typeof item === "string" && item.trim()).join("\n") || state.pendingAssistantError || raw.subtype || "Claude turn failed" : void 0;
+    if (status === "failed" && !state.currentTurnId) {
+      ensureTurn(state, envelopes);
+    }
     const usage = raw.usage && typeof raw.usage.input_tokens === "number" && typeof raw.usage.output_tokens === "number" ? {
       input_tokens: raw.usage.input_tokens,
       output_tokens: raw.usage.output_tokens,
@@ -2641,6 +2657,7 @@ function mapClaudeLogMessageToSessionEnvelopesInternal(message, state) {
       ...typeof raw.usage.cache_read_input_tokens === "number" ? { cache_read_input_tokens: raw.usage.cache_read_input_tokens } : {}
     } : void 0;
     closeTurn(state, status, envelopes, {
+      error,
       costUsd: typeof raw.total_cost_usd === "number" ? raw.total_cost_usd : void 0,
       durationMs: typeof raw.duration_ms === "number" ? raw.duration_ms : void 0,
       numTurns: typeof raw.num_turns === "number" ? raw.num_turns : void 0,
@@ -3376,9 +3393,9 @@ class ApiSessionClient extends EventEmitter {
       }));
     }
   }
-  closeClaudeSessionTurn(status = "completed") {
+  closeClaudeSessionTurn(status = "completed", meta) {
     this.emit("turn-ended", status);
-    const mapped = closeClaudeTurnWithStatus(this.claudeSessionProtocolState, status);
+    const mapped = closeClaudeTurnWithStatus(this.claudeSessionProtocolState, status, meta);
     this.claudeSessionProtocolState.currentTurnId = mapped.currentTurnId;
     for (const envelope of mapped.envelopes) {
       this.sendSessionProtocolMessage(envelope);
@@ -9786,6 +9803,7 @@ function terminalListSignature(items) {
   const canon = [...items].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0).map((t) => [
     t.id,
     t.title ?? "",
+    t.tags ?? [],
     t.cwd ?? "",
     t.createdAt ?? 0,
     Math.floor((t.activityAt ?? 0) / ACTIVITY_SIGNATURE_BUCKET_MS),
@@ -9819,6 +9837,7 @@ const LIST_SESSIONS_FORMAT = [
   "#{pane_current_path}",
   "#{@vh_title}",
   "#{@vh_title_manual}",
+  "#{@vh_tags}",
   // B-121: the control-mode client has no `pty.process`, so the agent-state
   // fast path lost its live `#{pane_current_command}` equivalent. Carry it in
   // the ONE list-sessions call the tracker already makes — the value goes
@@ -9833,8 +9852,8 @@ const LIST_SESSIONS_FORMAT = [
 function parseSessionListLine(line) {
   if (!line) return void 0;
   const parts = line.split(LIST_FIELD_SEP);
-  if (parts.length < 8) return void 0;
-  const [name, created, activity, cwd, vhTitle, manual, paneCommand] = parts;
+  if (parts.length < 9) return void 0;
+  const [name, created, activity, cwd, vhTitle, manual, vhTags, paneCommand] = parts;
   if (!name) return void 0;
   return {
     name,
@@ -9843,12 +9862,40 @@ function parseSessionListLine(line) {
     cwd: cwd || void 0,
     vhTitle: vhTitle.trim() || void 0,
     manual: manual.trim().length > 0,
+    tags: parseTerminalTags(vhTags),
     paneCurrentCommand: paneCommand.trim() || void 0,
     // pane_title is last, so anything after field 8 is title content that
     // contained the separator — rejoin it rather than dropping it.
-    paneTitle: parts.slice(7).join(LIST_FIELD_SEP) || void 0
+    paneTitle: parts.slice(8).join(LIST_FIELD_SEP) || void 0
   };
 }
+const TERMINAL_TAG_MAX_COUNT = 64;
+const TERMINAL_TAG_MAX_LENGTH = 24;
+const TERMINAL_TAGS_MAX_BYTES = 4096;
+function validateTerminalTags(value) {
+  if (!Array.isArray(value) || value.length > TERMINAL_TAG_MAX_COUNT) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const valueTag of value) {
+    if (typeof valueTag !== "string") return void 0;
+    const tag = valueTag.trim().replace(/^#+/, "").trim().replace(/\s+/g, "-").slice(0, TERMINAL_TAG_MAX_LENGTH);
+    if (!tag || tag !== valueTag) return void 0;
+    const key = tag.toLowerCase();
+    if (seen.has(key)) return void 0;
+    seen.add(key);
+    out.push(tag);
+  }
+  if (Buffer.byteLength(JSON.stringify(out), "utf8") > TERMINAL_TAGS_MAX_BYTES) return void 0;
+  return out;
+}
+function parseTerminalTags(raw) {
+  if (typeof raw !== "string" || !raw.trim()) return [];
+  try {
+    return validateTerminalTags(JSON.parse(raw)) ?? [];
+  } catch {
+    return [];
+  }
+}
 function classifyPane(currentCommand, tail) {
   const cmd = (currentCommand || "").trim().replace(/^-/, "").toLowerCase();
   const isShell = SHELL_COMMANDS.has(cmd);
@@ -11281,6 +11328,8 @@ class WebTerminalManager {
         out.push({
           id,
           title,
+          // Always include [] so Web can feature-detect tag support.
+          tags: s.tags,
           cwd: s.cwd,
           createdAt: s.created,
           // tmux last-activity (epoch s) → ms; optional so old daemons
@@ -11458,6 +11507,25 @@ class WebTerminalManager {
       return false;
     }
   }
+  /** Persist terminal tags in tmux, parallel to @vh_title. */
+  setTags(terminalId, tags) {
+    if (!isTmuxAvailable()) return false;
+    if (!/^[a-zA-Z0-9_-]{1,64}$/.test(terminalId)) return false;
+    const valid = validateTerminalTags(tags);
+    if (!valid) return false;
+    const name = `vh-${terminalId}`;
+    try {
+      const r = spawnSync("tmux", ["set-option", "-t", name, "@vh_tags", JSON.stringify(valid)], {
+        stdio: "ignore",
+        env: ptyEnv()
+      });
+      if (r.status !== 0) return false;
+      this.kickListRefresh();
+      return true;
+    } catch {
+      return false;
+    }
+  }
 }
 
 const TMUX_TIMEOUT_MS = 3e3;
@@ -13406,6 +13474,16 @@ class ApiMachineClient {
       }
       return { type: "success" };
     });
+    this.rpcHandlerManager.registerHandler("set-terminal-tags", async (params) => {
+      const { terminalId, tags } = params || {};
+      if (!terminalId || !Array.isArray(tags)) {
+        throw new Error("terminalId and tags are required");
+      }
+      if (!this.webTerminal.setTags(terminalId, tags)) {
+        throw new Error("Failed to set terminal tags (invalid tags, tmux unavailable, or session gone)");
+      }
+      return { type: "success" };
+    });
     this.rpcHandlerManager.registerHandler("stop-session", (params) => {
       const { sessionId } = params || {};
       if (!sessionId) {