very-happy-cli 0.2.165 → 0.2.167

package/dist/{deterministicJson-BBwG-Ase.mjs → deterministicJson-BMMifViN.mjs}

@@ -1,23 +1,23 @@
-import { C as ContextUsageSchema } from './index-vVWpCoTr.mjs';
+import { C as ContextUsageSchema } from './index-B0HEEYGh.mjs';
 import { unlink, mkdir, open, rename } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { constants } from 'node:fs';
 import { dirname } from 'node:path';
 import { z } from 'zod';
-import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-BwaWdlCm.mjs';
-import { t as teamScopePath } from './context-DaCCB4cm.mjs';
-import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-DG5MMEp_.mjs';
+import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-Dsfy_SAb.mjs';
+import { t as teamScopePath } from './context-Cr6a3NTg.mjs';
+import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-DZRH4-hV.mjs';
 import { T as TEAM_SKILL } from './resources-BdFBQi8r.mjs';
-import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-jof0Bu54.mjs';
-import { A as AUTOMATION_TOOL_NAMES, r as registerAutomationTools } from './tools-BVRoGcQH.mjs';
-import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-SWITnkqz.mjs';
+import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-D91mq5Ib.mjs';
+import { c as createSelfReportState, A as AUTOMATION_TOOL_NAMES, r as registerAutomationTools, a as registerReportProgressTool, n as normalizeAttention, b as normalizePhase, d as normalizeProgress, s as shouldAcceptSelfReport } from './reportProgressTool-BvB13EwC.mjs';
+import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-os2DVjA0.mjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { createServer } from 'node:http';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
 import { C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, c as CLIPBOARD_MAX_BYTES } from './limits-DIo7rEBR.mjs';
-import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools } from './assistantTools-DPGga5lM.mjs';
-import { P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as REPORT_PROGRESS_TOOL_TITLE, d as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-CQuNlNx8.mjs';
+import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools, c as checkDownloadTarget } from './downloadTarget-Cp48jrIP.mjs';
+import { P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as PREVIEW_DOWNLOAD_PARAM_DESCRIPTION } from './agentGuidance-BDYt2Qy2.mjs';
 import { c as checkPreviewPath } from './previewPath-CXN4Vag0.mjs';
 import { createHash } from 'crypto';
 
@@ -128,29 +128,6 @@ This session is now connected as the team lead. Call team_inspect to read the au
   };
 }
 
-const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
-const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
-const PROGRESS_MAX_CHARS = 200;
-function createSelfReportState() {
-  return { lastAcceptedAt: 0 };
-}
-function shouldAcceptSelfReport(state, now, attention) {
-  if (state.lastAcceptedAt === 0) return true;
-  if (attention !== void 0 && attention !== state.lastAttention) return true;
-  return now - state.lastAcceptedAt >= SELF_REPORT_MIN_INTERVAL_MS;
-}
-function isSelfReportFresh(state, now) {
-  if (state.lastAcceptedAt === 0) return false;
-  const age = now - state.lastAcceptedAt;
-  return age >= 0 && age < SELF_REPORT_FRESH_MS;
-}
-function normalizeProgress(value) {
-  if (typeof value !== "string") return null;
-  const flat = value.replace(/\s+/g, " ").trim();
-  if (!flat) return null;
-  return flat.length > PROGRESS_MAX_CHARS ? flat.slice(0, PROGRESS_MAX_CHARS) : flat;
-}
-
 function createMcpServer(handlers, options, sessionId, client) {
   const mcp = new McpServer({
     name: "Very Happy Tools",
@@ -222,17 +199,20 @@ function createMcpServer(handlers, options, sessionId, client) {
     title: PREVIEW_TOOL_TITLE,
     inputSchema: {
       path: z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-      mode: z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'")
+      mode: z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'"),
+      // B-562: optional; old web clients ignore the resulting intent and just preview.
+      download: z.boolean().optional().describe(PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
     }
   }, async (args) => {
-    const response = await handlers.openPreview(args.path, args.mode ?? "file");
+    const response = await handlers.openPreview(args.path, args.mode ?? "file", args.download === true);
     logger.debug("[happyMCP] open_preview response:", response);
     if (response.delivered) {
+      const target = response.resolved ?? args.path;
       return {
         content: [{
           type: "text",
           // 明说不保证用户看到了——否则 claude 会基于「已预览」做后续推断（spec 风险 8）
-          text: `Asked the user's open web client(s) to preview ${response.resolved ?? args.path}. This does not confirm they looked at it.`
+          text: (args.download === true ? `Asked the user's open web client(s) to offer ${target} for download. This does not confirm they downloaded it.` : `Asked the user's open web client(s) to preview ${target}. This does not confirm they looked at it.`) + (response.note ? ` ${response.note}` : "")
         }],
         isError: false
       };
@@ -242,15 +222,8 @@ function createMcpServer(handlers, options, sessionId, client) {
       isError: true
     };
   });
-  mcp.registerTool(REPORT_PROGRESS_TOOL_NAME, {
-    description: REPORT_PROGRESS_TOOL_DESCRIPTION,
-    title: REPORT_PROGRESS_TOOL_TITLE,
-    inputSchema: {
-      progress: z.string().describe("One short line describing the current state of this task"),
-      attention: z.enum(["none", "review", "blocked"]).optional().describe("'blocked' = cannot proceed without the user; 'review' = wants their eyes; 'none' = ordinary progress")
-    }
-  }, async (args) => {
-    const response = await handlers.reportProgress(args.progress, args.attention ?? "none");
+  registerReportProgressTool(mcp, async (args) => {
+    const response = await handlers.reportProgress(String(args.progress ?? ""), normalizeAttention(args.attention), normalizePhase(args.phase));
     logger.debug("[happyMCP] report_progress response:", response);
     if (response.accepted) {
       return { content: [{ type: "text", text: "Board updated." }], isError: false };
@@ -265,39 +238,50 @@ function createMcpServer(handlers, options, sessionId, client) {
   }
   return mcp;
 }
+function withoutPhase(board) {
+  if (!board) return {};
+  const { phase: _phase, ...rest } = board;
+  return rest;
+}
 async function startHappyServer(client, options) {
   logger.debug(`[happyMCP] server:start sessionId=${client.sessionId} assistant=${!!options?.assistant}`);
   const selfReportState = options?.selfReportState ?? createSelfReportState();
   const handlers = {
-    openPreview: async (path, mode) => {
+    openPreview: async (path, mode, download = false) => {
       const verdict = checkPreviewPath(path);
       if (verdict.deniedReason) {
         logger.debug(`[happyMCP] open_preview denied: ${verdict.deniedReason}`);
         return { delivered: false, error: verdict.deniedReason };
       }
+      const target = download ? await checkDownloadTarget(verdict.resolved) : null;
+      if (target?.error) return { delivered: false, error: target.error };
       try {
-        const result = client.pushFilePreview(verdict.resolved, mode);
-        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error };
+        const result = client.pushFilePreview(verdict.resolved, mode, download ? "download" : void 0);
+        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error, note: target?.note ?? void 0 };
       } catch (error) {
         return { delivered: false, error: String(error) };
       }
     },
-    reportProgress: async (progress, attention) => {
+    reportProgress: async (progress, attention, phase) => {
       const text = normalizeProgress(progress);
       if (!text) {
         return { accepted: false, error: "progress must be a non-empty one-line string" };
       }
       const now = Date.now();
-      if (!shouldAcceptSelfReport(selfReportState, now, attention)) {
+      if (!shouldAcceptSelfReport(selfReportState, now, attention, phase)) {
         return { accepted: false };
       }
       selfReportState.lastAcceptedAt = now;
       selfReportState.lastAttention = attention;
+      selfReportState.lastPhase = phase;
       try {
         client.updateMetadata((metadata) => ({
           ...metadata,
           board: {
-            ...metadata?.board,
+            // B-556: a report without phase must not keep the previous one
+            // (a stale label next to fresh text); taskId etc. are kept.
+            ...withoutPhase(metadata?.board),
+            ...phase ? { phase } : {},
             attention,
             progress: text,
             analyzedAt: now,
@@ -499,4 +483,4 @@ function hashObject(obj, options, encoding = "hex") {
   return createHash("sha256").update(jsonString).digest(encoding);
 }
 
-export { createSelfReportState as c, hashObject as h, isSelfReportFresh as i, startHappyServer as s };
+export { hashObject as h, startHappyServer as s };

package/dist/{deterministicJson-C4Jo2RWy.cjs → deterministicJson-C7O2ulKY.cjs}

@@ -1,25 +1,25 @@
 'use strict';
 
-var index = require('./index-DqlyNgt4.cjs');
+var index = require('./index-C9hI8a10.cjs');
 var promises = require('node:fs/promises');
 var node_crypto = require('node:crypto');
 var node_fs = require('node:fs');
 var path = require('node:path');
 var z = require('zod');
-var client = require('./client-Do7cGPEq.cjs');
-var context = require('./context-3WVw8qPz.cjs');
-var sessionOps = require('./sessionOps-JP64uJmc.cjs');
+var client = require('./client-BKnKRLSt.cjs');
+var context = require('./context-Jrq4-eCZ.cjs');
+var sessionOps = require('./sessionOps-DzbZI3Eq.cjs');
 var resources = require('./resources-JDPugcDq.cjs');
-var tools = require('./tools-c2fb0CF5.cjs');
-var tools$1 = require('./tools-mWqsE6ji.cjs');
-var peerTools = require('./peerTools-CttfOxti.cjs');
+var tools = require('./tools-DJIANHSh.cjs');
+var reportProgressTool = require('./reportProgressTool-D4KB_4cP.cjs');
+var peerTools = require('./peerTools-Dkbu7gag.cjs');
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var node_http = require('node:http');
 var streamableHttp_js = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
 var limits = require('./limits-C-a7gr04.cjs');
-var assistantTools = require('./assistantTools-BsrG3PD-.cjs');
-var agentGuidance = require('./agentGuidance-B5NATuFa.cjs');
+var downloadTarget = require('./downloadTarget-CWTb2-EM.cjs');
+var agentGuidance = require('./agentGuidance-BtBx2xxE.cjs');
 var previewPath = require('./previewPath-B0rBdhy1.cjs');
 var crypto = require('crypto');
 
@@ -130,36 +130,13 @@ This session is now connected as the team lead. Call team_inspect to read the au
   };
 }
 
-const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
-const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
-const PROGRESS_MAX_CHARS = 200;
-function createSelfReportState() {
-  return { lastAcceptedAt: 0 };
-}
-function shouldAcceptSelfReport(state, now, attention) {
-  if (state.lastAcceptedAt === 0) return true;
-  if (attention !== void 0 && attention !== state.lastAttention) return true;
-  return now - state.lastAcceptedAt >= SELF_REPORT_MIN_INTERVAL_MS;
-}
-function isSelfReportFresh(state, now) {
-  if (state.lastAcceptedAt === 0) return false;
-  const age = now - state.lastAcceptedAt;
-  return age >= 0 && age < SELF_REPORT_FRESH_MS;
-}
-function normalizeProgress(value) {
-  if (typeof value !== "string") return null;
-  const flat = value.replace(/\s+/g, " ").trim();
-  if (!flat) return null;
-  return flat.length > PROGRESS_MAX_CHARS ? flat.slice(0, PROGRESS_MAX_CHARS) : flat;
-}
-
 function createMcpServer(handlers, options, sessionId, client) {
   const mcp = new mcp_js.McpServer({
     name: "Very Happy Tools",
     version: "1.0.0"
   });
   tools.registerTeamsTools(mcp, sessionId);
-  tools$1.registerAutomationTools(mcp);
+  reportProgressTool.registerAutomationTools(mcp);
   if (client) peerTools.registerSessionPeerTools(mcp, peerTools.createSessionPeerToolExecutor(client));
   mcp.registerTool("change_title", {
     description: "Change the title of the current chat session",
@@ -224,17 +201,20 @@ function createMcpServer(handlers, options, sessionId, client) {
     title: agentGuidance.PREVIEW_TOOL_TITLE,
     inputSchema: {
       path: z.z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-      mode: z.z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'")
+      mode: z.z.enum(["file", "diff"]).optional().describe("'file' (default) renders the file; 'diff' is reserved and currently falls back to 'file'"),
+      // B-562: optional; old web clients ignore the resulting intent and just preview.
+      download: z.z.boolean().optional().describe(agentGuidance.PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
     }
   }, async (args) => {
-    const response = await handlers.openPreview(args.path, args.mode ?? "file");
+    const response = await handlers.openPreview(args.path, args.mode ?? "file", args.download === true);
     logger.logger.debug("[happyMCP] open_preview response:", response);
     if (response.delivered) {
+      const target = response.resolved ?? args.path;
       return {
         content: [{
           type: "text",
           // 明说不保证用户看到了——否则 claude 会基于「已预览」做后续推断（spec 风险 8）
-          text: `Asked the user's open web client(s) to preview ${response.resolved ?? args.path}. This does not confirm they looked at it.`
+          text: (args.download === true ? `Asked the user's open web client(s) to offer ${target} for download. This does not confirm they downloaded it.` : `Asked the user's open web client(s) to preview ${target}. This does not confirm they looked at it.`) + (response.note ? ` ${response.note}` : "")
         }],
         isError: false
       };
@@ -244,15 +224,8 @@ function createMcpServer(handlers, options, sessionId, client) {
       isError: true
     };
   });
-  mcp.registerTool(agentGuidance.REPORT_PROGRESS_TOOL_NAME, {
-    description: agentGuidance.REPORT_PROGRESS_TOOL_DESCRIPTION,
-    title: agentGuidance.REPORT_PROGRESS_TOOL_TITLE,
-    inputSchema: {
-      progress: z.z.string().describe("One short line describing the current state of this task"),
-      attention: z.z.enum(["none", "review", "blocked"]).optional().describe("'blocked' = cannot proceed without the user; 'review' = wants their eyes; 'none' = ordinary progress")
-    }
-  }, async (args) => {
-    const response = await handlers.reportProgress(args.progress, args.attention ?? "none");
+  reportProgressTool.registerReportProgressTool(mcp, async (args) => {
+    const response = await handlers.reportProgress(String(args.progress ?? ""), reportProgressTool.normalizeAttention(args.attention), reportProgressTool.normalizePhase(args.phase));
     logger.logger.debug("[happyMCP] report_progress response:", response);
     if (response.accepted) {
       return { content: [{ type: "text", text: "Board updated." }], isError: false };
@@ -263,43 +236,54 @@ function createMcpServer(handlers, options, sessionId, client) {
     };
   });
   if (options?.assistant && !process.env.VH_TEAM_SCOPE_FILE) {
-    assistantTools.registerAssistantTools(mcp);
+    downloadTarget.registerAssistantTools(mcp);
   }
   return mcp;
 }
+function withoutPhase(board) {
+  if (!board) return {};
+  const { phase: _phase, ...rest } = board;
+  return rest;
+}
 async function startHappyServer(client, options) {
   logger.logger.debug(`[happyMCP] server:start sessionId=${client.sessionId} assistant=${!!options?.assistant}`);
-  const selfReportState = options?.selfReportState ?? createSelfReportState();
+  const selfReportState = options?.selfReportState ?? reportProgressTool.createSelfReportState();
   const handlers = {
-    openPreview: async (path, mode) => {
+    openPreview: async (path, mode, download = false) => {
       const verdict = previewPath.checkPreviewPath(path);
       if (verdict.deniedReason) {
         logger.logger.debug(`[happyMCP] open_preview denied: ${verdict.deniedReason}`);
         return { delivered: false, error: verdict.deniedReason };
       }
+      const target = download ? await downloadTarget.checkDownloadTarget(verdict.resolved) : null;
+      if (target?.error) return { delivered: false, error: target.error };
       try {
-        const result = client.pushFilePreview(verdict.resolved, mode);
-        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error };
+        const result = client.pushFilePreview(verdict.resolved, mode, download ? "download" : void 0);
+        return { delivered: result.delivered, resolved: verdict.resolved, error: result.error, note: target?.note ?? void 0 };
       } catch (error) {
         return { delivered: false, error: String(error) };
       }
     },
-    reportProgress: async (progress, attention) => {
-      const text = normalizeProgress(progress);
+    reportProgress: async (progress, attention, phase) => {
+      const text = reportProgressTool.normalizeProgress(progress);
       if (!text) {
         return { accepted: false, error: "progress must be a non-empty one-line string" };
       }
       const now = Date.now();
-      if (!shouldAcceptSelfReport(selfReportState, now, attention)) {
+      if (!reportProgressTool.shouldAcceptSelfReport(selfReportState, now, attention, phase)) {
         return { accepted: false };
       }
       selfReportState.lastAcceptedAt = now;
       selfReportState.lastAttention = attention;
+      selfReportState.lastPhase = phase;
       try {
         client.updateMetadata((metadata) => ({
           ...metadata,
           board: {
-            ...metadata?.board,
+            // B-556: a report without phase must not keep the previous one
+            // (a stale label next to fresh text); taskId etc. are kept.
+            ...withoutPhase(metadata?.board),
+            ...phase ? { phase } : {},
             attention,
             progress: text,
             analyzedAt: now,
@@ -403,9 +387,9 @@ async function startHappyServer(client, options) {
       agentGuidance.PREVIEW_TOOL_NAME,
       agentGuidance.REPORT_PROGRESS_TOOL_NAME,
       ...tools.TEAM_TOOL_NAMES,
-      ...tools$1.AUTOMATION_TOOL_NAMES,
+      ...reportProgressTool.AUTOMATION_TOOL_NAMES,
       ...peerTools.SESSION_PEER_TOOL_NAMES,
-      ...options?.assistant && !process.env.VH_TEAM_SCOPE_FILE ? assistantTools.ASSISTANT_TOOL_NAMES : []
+      ...options?.assistant && !process.env.VH_TEAM_SCOPE_FILE ? downloadTarget.ASSISTANT_TOOL_NAMES : []
     ],
     stop: () => {
       logger.logger.debug(`[happyMCP] server:stop sessionId=${client.sessionId}`);
@@ -501,7 +485,5 @@ function hashObject(obj, options, encoding = "hex") {
   return crypto.createHash("sha256").update(jsonString).digest(encoding);
 }
 
-exports.createSelfReportState = createSelfReportState;
 exports.hashObject = hashObject;
-exports.isSelfReportFresh = isSelfReportFresh;
 exports.startHappyServer = startHappyServer;

package/dist/{doctor-ZOQLE5AH.cjs → doctor-BykBaMTr.cjs}

@@ -1,14 +1,14 @@
 'use strict';
 
 var chalk = require('chalk');
-var configuration = require('./configuration-BE61XNsg.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var controlClient = require('./controlClient-RWTlQA4_.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
+var controlClient = require('./controlClient-BI6Fw3fQ.cjs');
 var doctor$1 = require('./doctor-u46qYYKX.cjs');
 var node_fs = require('node:fs');
 var path = require('node:path');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-UkmvSFsg.cjs');
+var _package = require('./package-C9ZP9bpX.cjs');
 var doctorReadiness = require('./doctorReadiness-BCZGcN0a.cjs');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 var cliUpdate = require('./cliUpdate-DsKXPFYp.cjs');
@@ -312,8 +312,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-D3Nn82kI.cjs'); });
-    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-DIodyAqF.cjs'); });
+    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-DeAWzhSe.cjs'); });
+    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./index-PNMQPKhz.cjs'); });
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));

package/dist/{doctor-CAC6qY9Z.mjs → doctor-D1KKyPzB.mjs}

@@ -1,12 +1,12 @@
 import chalk from 'chalk';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { readSettings, readCredentials, readDaemonState } from './persistence-DujtUH94.mjs';
-import { c as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-Ci7HTMII.mjs';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
+import { r as readSettings, g as readCredentials, d as readDaemonState } from './persistence-ON0zpHfb.mjs';
+import { a as checkIfDaemonRunningAndCleanupStaleState } from './controlClient-DTheOlvC.mjs';
 import { findAllHappyProcesses } from './doctor-BPkYWSuq.mjs';
 import { statSync, realpathSync, existsSync, readdirSync } from 'node:fs';
 import { isAbsolute, resolve, dirname, basename, delimiter, join } from 'node:path';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-VIUXrYZ1.mjs';
+import { p as packageJson } from './package-DU1DxhH9.mjs';
 import { s as shareableSettingsSummary, c as collectRuntimeReadiness, S as SUPPORTED_NODE_LABEL, r as resolveClaudeCredentialReadiness, a as toolProbeLabel, b as daemonReadiness, d as daemonEndpointsMatch } from './doctorReadiness-C208SMN9.mjs';
 import { c as credentialRelayProblem } from './authRelay-DSAvg1uv.mjs';
 import { d as deriveLocalCliUpdateSummary } from './cliUpdate-Y34VGe9Y.mjs';
@@ -310,8 +310,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await import('./agentHome-DvR176E5.mjs');
-    const { describeAgentHome } = await import('./index-Diu6HdWH.mjs');
+    const { resolveAgentHomesForCli } = await import('./agentHome-Ct-VXFeG.mjs');
+    const { describeAgentHome } = await import('./index-D8m8Ripb.mjs');
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));

package/dist/{assistantTools-BsrG3PD-.cjs → downloadTarget-CWTb2-EM.cjs}

@@ -3,14 +3,14 @@
 var promises = require('node:fs/promises');
 var os = require('node:os');
 var z = require('zod');
-var logger = require('./logger-D0hkk7Vo.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var controlClient = require('./controlClient-RWTlQA4_.cjs');
-var sessionOps = require('./sessionOps-JP64uJmc.cjs');
-var remoteSessionClient = require('./remoteSessionClient-BAkIwM2S.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
+var controlClient = require('./controlClient-BI6Fw3fQ.cjs');
+var sessionOps = require('./sessionOps-DzbZI3Eq.cjs');
+var remoteSessionClient = require('./remoteSessionClient-PyUAIhwK.cjs');
 var ids = require('./ids-B6ZC0HGt.cjs');
 var terminals = require('./terminals-B_bfC9c2.cjs');
-var bootstrap = require('./bootstrap-B1dMZA-u.cjs');
+var bootstrap = require('./bootstrap-Dj8WBiR2.cjs');
 var path = require('node:path');
 
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;
@@ -375,6 +375,44 @@ ${r.text}`);
   });
 }
 
+const WEB_DOWNLOAD_MAX_BYTES = 50 * 1024 * 1024;
+function downloadTargetVerdict(path, target) {
+  switch (target.kind) {
+    case "missing":
+      return { error: `${path} does not exist; create the file first, then call open_preview again`, note: null };
+    case "directory":
+      return {
+        error: `${path} is a directory; the user can only download a single file. Pack it first (e.g. \`zip -r out.zip <dir>\`) and call open_preview with the archive and download: true`,
+        note: null
+      };
+    case "other":
+      return { error: `${path} is not a regular file`, note: null };
+    case "error":
+      return { error: `cannot read ${path}: ${target.code} (${target.message})`, note: null };
+    case "file":
+      return target.size > WEB_DOWNLOAD_MAX_BYTES ? {
+        error: null,
+        note: `Note: the file is ${(target.size / 1024 / 1024).toFixed(1)} MiB, above the 50 MiB web download limit, so the user will see its size but cannot download it. Offer to compress it or split it into parts under 50 MiB (e.g. \`zip -s 45m\`).`
+      } : { error: null, note: null };
+  }
+}
+async function statDownloadTarget(path) {
+  try {
+    const s = await promises.stat(path);
+    if (s.isDirectory()) return { kind: "directory" };
+    if (!s.isFile()) return { kind: "other" };
+    return { kind: "file", size: s.size };
+  } catch (error) {
+    const code = error?.code;
+    if (code === "ENOENT") return { kind: "missing" };
+    return { kind: "error", code: code ?? "UNKNOWN", message: error instanceof Error ? error.message : String(error) };
+  }
+}
+async function checkDownloadTarget(path) {
+  return downloadTargetVerdict(path, await statDownloadTarget(path));
+}
+
 exports.ASSISTANT_TOOL_NAMES = ASSISTANT_TOOL_NAMES;
+exports.checkDownloadTarget = checkDownloadTarget;
 exports.registerAssistantSessionTools = registerAssistantSessionTools;
 exports.registerAssistantTools = registerAssistantTools;

package/dist/{assistantTools-DPGga5lM.mjs → downloadTarget-Cp48jrIP.mjs}

@@ -1,14 +1,14 @@
-import { readFile, writeFile, appendFile } from 'node:fs/promises';
+import { readFile, writeFile, appendFile, stat } from 'node:fs/promises';
 import os from 'node:os';
 import { z } from 'zod';
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { readPersistedSessions } from './persistence-DujtUH94.mjs';
-import { e as spawnDaemonSession } from './controlClient-Ci7HTMII.mjs';
-import { a as listSessions, r as readSessionTranscript, s as sessionWebUrl, g as waitForSessionKey, e as sendUserMessage, b as stopSession, d as archiveSession } from './sessionOps-DG5MMEp_.mjs';
-import { r as readRemoteTranscript, s as sendRemoteMessage, d as deliverToSession, R as RemoteSessionOpsError } from './remoteSessionClient-DCAUHgPz.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
+import { b as readPersistedSessions } from './persistence-ON0zpHfb.mjs';
+import { f as spawnDaemonSession } from './controlClient-DTheOlvC.mjs';
+import { a as listSessions, r as readSessionTranscript, s as sessionWebUrl, g as waitForSessionKey, e as sendUserMessage, b as stopSession, d as archiveSession } from './sessionOps-DZRH4-hV.mjs';
+import { r as readRemoteTranscript, s as sendRemoteMessage, d as deliverToSession, R as RemoteSessionOpsError } from './remoteSessionClient-BzPXSC21.mjs';
 import { i as isValidSessionId, a as isValidTerminalId } from './ids-DU6sLx4C.mjs';
 import { l as listVhTerminals, r as readVhTerminal, s as sendToVhTerminal } from './terminals-Dlg0x3nY.mjs';
-import { bootstrapAssistantHome, assistantPersonalMemoryPath } from './bootstrap-D_ExGrY2.mjs';
+import { bootstrapAssistantHome, assistantPersonalMemoryPath } from './bootstrap-BSOxYpaP.mjs';
 import { join, isAbsolute, normalize } from 'node:path';
 
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;
@@ -373,4 +373,41 @@ ${r.text}`);
   });
 }
 
-export { ASSISTANT_TOOL_NAMES as A, registerAssistantTools as a, registerAssistantSessionTools as r };
+const WEB_DOWNLOAD_MAX_BYTES = 50 * 1024 * 1024;
+function downloadTargetVerdict(path, target) {
+  switch (target.kind) {
+    case "missing":
+      return { error: `${path} does not exist; create the file first, then call open_preview again`, note: null };
+    case "directory":
+      return {
+        error: `${path} is a directory; the user can only download a single file. Pack it first (e.g. \`zip -r out.zip <dir>\`) and call open_preview with the archive and download: true`,
+        note: null
+      };
+    case "other":
+      return { error: `${path} is not a regular file`, note: null };
+    case "error":
+      return { error: `cannot read ${path}: ${target.code} (${target.message})`, note: null };
+    case "file":
+      return target.size > WEB_DOWNLOAD_MAX_BYTES ? {
+        error: null,
+        note: `Note: the file is ${(target.size / 1024 / 1024).toFixed(1)} MiB, above the 50 MiB web download limit, so the user will see its size but cannot download it. Offer to compress it or split it into parts under 50 MiB (e.g. \`zip -s 45m\`).`
+      } : { error: null, note: null };
+  }
+}
+async function statDownloadTarget(path) {
+  try {
+    const s = await stat(path);
+    if (s.isDirectory()) return { kind: "directory" };
+    if (!s.isFile()) return { kind: "other" };
+    return { kind: "file", size: s.size };
+  } catch (error) {
+    const code = error?.code;
+    if (code === "ENOENT") return { kind: "missing" };
+    return { kind: "error", code: code ?? "UNKNOWN", message: error instanceof Error ? error.message : String(error) };
+  }
+}
+async function checkDownloadTarget(path) {
+  return downloadTargetVerdict(path, await statDownloadTarget(path));
+}
+
+export { ASSISTANT_TOOL_NAMES as A, registerAssistantTools as a, checkDownloadTarget as c, registerAssistantSessionTools as r };

package/dist/{ensureDaemonRunning-b1pvEFcS.mjs → ensureDaemonRunning-Ba5fYoxb.mjs}

@@ -1,8 +1,8 @@
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { i as isDaemonRunningCurrentlyInstalledHappyVersion, c as checkIfDaemonRunningAndCleanupStaleState, a as stopDaemon } from './controlClient-Ci7HTMII.mjs';
-import { s as spawnHappyCLI } from './spawnHappyCLI-Dc4xYm8P.mjs';
-import { readDaemonState } from './persistence-DujtUH94.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
+import { i as isDaemonRunningCurrentlyInstalledHappyVersion, a as checkIfDaemonRunningAndCleanupStaleState, b as stopDaemon } from './controlClient-DTheOlvC.mjs';
+import { s as spawnHappyCLI } from './spawnHappyCLI-B2h0P4b5.mjs';
+import { d as readDaemonState } from './persistence-ON0zpHfb.mjs';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
 import { d as daemonEndpointsMatch } from './doctorReadiness-C208SMN9.mjs';
 
 function extractNoSandboxFlag(args) {

package/dist/{ensureDaemonRunning-mIgX2vnc.cjs → ensureDaemonRunning-CCxX7MoP.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var logger = require('./logger-D0hkk7Vo.cjs');
-var controlClient = require('./controlClient-RWTlQA4_.cjs');
-var spawnHappyCLI = require('./spawnHappyCLI-Dd5_8Vex.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var controlClient = require('./controlClient-BI6Fw3fQ.cjs');
+var spawnHappyCLI = require('./spawnHappyCLI-J4iEhfyZ.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
 var doctorReadiness = require('./doctorReadiness-BCZGcN0a.cjs');
 
 function extractNoSandboxFlag(args) {

package/dist/{handleResumeCommand-CTGbZkCL.mjs → handleResumeCommand-BTUGlNjB.mjs}

@@ -1,22 +1,22 @@
 import { existsSync } from 'node:fs';
-import { s as spawnHappyCLI } from './spawnHappyCLI-Dc4xYm8P.mjs';
+import { s as spawnHappyCLI } from './spawnHappyCLI-B2h0P4b5.mjs';
 import axios, { AxiosError } from 'axios';
 import tweetnacl from 'tweetnacl';
 import { z } from 'zod';
 import { d as decodeBase64, a as decryptWithDataKey, b as decryptLegacy } from './authRelay-DSAvg1uv.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { g as getLocalHappyAgentCredentialPath, r as readLocalHappyAgentCredentials } from './localHappyAgentAuth-BWvmc_Hg.mjs';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
+import { g as getLocalHappyAgentCredentialPath, r as readLocalHappyAgentCredentials } from './localHappyAgentAuth-B5XPEMwk.mjs';
 import 'cross-spawn';
 import 'node:path';
 import './projectPath-BTBIMB57.mjs';
 import 'path';
 import 'url';
-import './logger-CknSVkIe.mjs';
+import './logger-CbBv3q_b.mjs';
 import 'chalk';
 import 'node:util';
 import 'node:crypto';
 import 'node:os';
-import './package-VIUXrYZ1.mjs';
+import './package-DU1DxhH9.mjs';
 import 'node:fs/promises';
 
 const ResumableMetadataSchema = z.object({