very-happy-cli 0.2.140 → 0.2.142

package/dist/{index-__h-pCTK.cjs → index-CSQZhQ0C.cjs}

@@ -3,13 +3,14 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var api = require('./types-DCVS050m.cjs');
-var persistence = require('./limits-Dbip6eVO.cjs');
+var api = require('./types-Xd_LJRJN.cjs');
+var persistence = require('./limits-B3hngubn.cjs');
 var spawn = require('cross-spawn');
 var path = require('node:path');
 var node_readline = require('node:readline');
 var node_fs = require('node:fs');
-var agentGuidance = require('./agentGuidance-Dl3apItH.cjs');
+var projectPath = require('./projectPath-ChLhdOyt.cjs');
+var agentGuidance = require('./agentGuidance-Bi8iBjy3.cjs');
 var promises = require('node:fs/promises');
 var fs = require('fs/promises');
 var ink = require('ink');
@@ -505,7 +506,7 @@ class ExitCodeError extends Error {
     this.exitCode = exitCode;
   }
 }
-const claudeCliPath = path.resolve(path.join(api.projectPath(), "scripts", "claude_local_launcher.cjs"));
+const claudeCliPath = path.resolve(path.join(projectPath.projectPath(), "scripts", "claude_local_launcher.cjs"));
 function quoteShellArg(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
@@ -1304,7 +1305,21 @@ function createRuntimeControls(isThinking) {
     });
     return { operationId: op.id };
   }
-  return { setQuery, observe, request };
+  async function stopRunningTasks() {
+    const q = query, runGeneration = generation;
+    if (!q || !q.canControl()) return [];
+    const running = [...tasks.values()].filter((task) => task.status === "running" && text(task.id)).map((task) => String(task.id)).slice(0, 20);
+    const stopped = [];
+    await Promise.all(running.map(async (id) => {
+      try {
+        await q.stopTask(id);
+        if (query === q && generation === runGeneration) stopped.push(id);
+      } catch {
+      }
+    }));
+    return stopped;
+  }
+  return { setQuery, observe, request, stopRunningTasks };
 }
 
 class MessageBuffer {
@@ -3919,6 +3934,9 @@ async function claudeRemoteLauncher(session, onPermissionModeChange, onEffective
     persistence.logger.debug("[remote]: doAbort");
     session.markAborting();
     session.onAbort();
+    void runtimeControls.stopRunningTasks().then((ids) => {
+      if (ids.length > 0) persistence.logger.debug(`[remote]: stopped ${ids.length} background task(s) on abort: ${ids.join(", ")}`);
+    }).catch((error) => persistence.logger.debug("[remote]: stopping background tasks on abort failed", error));
     if (session.thinking) {
       const interrupted = await turnSteering.interruptTurn().catch((e) => {
         persistence.logger.debug("[remote]: interruptTurn threw, falling back to hard abort", e);
@@ -4834,8 +4852,8 @@ function createSessionMetadata(opts) {
     ...opts.teamOperationId ? { teamOperationId: opts.teamOperationId } : {},
     homeDir: os.homedir(),
     happyHomeDir: persistence.configuration.happyHomeDir,
-    happyLibDir: api.projectPath(),
-    happyToolsDir: path.resolve(api.projectPath(), "tools", "unpacked"),
+    happyLibDir: projectPath.projectPath(),
+    happyToolsDir: path.resolve(projectPath.projectPath(), "tools", "unpacked"),
     startedFromDaemon: opts.startedBy === "daemon",
     hostPid: process.pid,
     startedBy: opts.startedBy || "terminal",
@@ -5235,7 +5253,7 @@ ${typeLabels[type] || type}:`));
     console.log(chalk.yellow("No log files found"));
   }
   console.log(chalk.bold("\n\u{1F527} Daemon Spawn Diagnostics"));
-  const projectRoot = api.projectPath();
+  const projectRoot = projectPath.projectPath();
   const wrapperPath = path.join(projectRoot, "bin", "very-happy.mjs");
   const cliEntrypoint = path.join(projectRoot, "dist", "index.mjs");
   console.log(`Project Root: ${chalk.blue(projectRoot)}`);
@@ -5840,7 +5858,7 @@ function getRuntime() {
 const isBun = () => getRuntime() === "bun";
 
 function spawnHappyCLI(args, options = {}) {
-  const projectRoot = api.projectPath();
+  const projectRoot = projectPath.projectPath();
   const entrypoint = path.join(projectRoot, "dist", "index.mjs");
   let directory;
   if ("cwd" in options) {
@@ -6087,6 +6105,83 @@ function isAuthorizedDaemonControlRequest(authorization, controlToken) {
   return configuredTokenIsUsable && node_crypto.timingSafeEqual(expectedDigest, candidateDigest);
 }
 
+const DENIED_HOME_DIRS = [
+  ".secrets",
+  ".ssh",
+  ".gnupg",
+  ".aws",
+  ".kube",
+  ".config/rbw"
+];
+const DENIED_HOME_FILES = [
+  ".claude.json",
+  ".claude/.credentials.json",
+  ".netrc",
+  ".pgpass"
+];
+const DENIED_BASENAME_PATTERNS = [
+  /^\.env$/i,
+  /^\.env\./i,
+  /\.env$/i,
+  /\.pem$/i,
+  /\.key$/i,
+  /\.p12$/i,
+  /\.pfx$/i,
+  /^id_(rsa|dsa|ecdsa|ed25519)$/i,
+  /^\.htpasswd$/i
+];
+const DENIED_PATH_SUFFIXES = [
+  `${path.sep}.git${path.sep}config`
+];
+function expandHome(input, home) {
+  if (input === "~") return home;
+  if (input.startsWith(`~${path.sep}`) || input.startsWith("~/")) {
+    return path.resolve(home, input.slice(2));
+  }
+  return input;
+}
+function basenameOf(p) {
+  const parts = p.split(path.sep);
+  return parts[parts.length - 1] ?? "";
+}
+function isUnder(child, parent) {
+  return child === parent || child.startsWith(parent.endsWith(path.sep) ? parent : parent + path.sep);
+}
+function checkPreviewPath(input, opts) {
+  const home = os.homedir();
+  const cwd = process.cwd();
+  if (typeof input !== "string" || !input.trim()) {
+    return { resolved: "", deniedReason: "path must be a non-empty string" };
+  }
+  if (input.includes("\0")) {
+    return { resolved: "", deniedReason: "path contains a NUL byte" };
+  }
+  const expanded = expandHome(input.trim(), home);
+  const resolved = path.isAbsolute(expanded) ? path.resolve(expanded) : path.resolve(cwd, expanded);
+  for (const dir of DENIED_HOME_DIRS) {
+    if (isUnder(resolved, path.resolve(home, dir))) {
+      return { resolved, deniedReason: `refusing to preview anything under ~/${dir} (credential material)` };
+    }
+  }
+  for (const file of DENIED_HOME_FILES) {
+    if (resolved === path.resolve(home, file)) {
+      return { resolved, deniedReason: `refusing to preview ~/${file} (credential material)` };
+    }
+  }
+  const base = basenameOf(resolved);
+  for (const pattern of DENIED_BASENAME_PATTERNS) {
+    if (pattern.test(base)) {
+      return { resolved, deniedReason: `refusing to preview "${base}" (looks like credential material)` };
+    }
+  }
+  for (const suffix of DENIED_PATH_SUFFIXES) {
+    if (resolved.endsWith(suffix)) {
+      return { resolved, deniedReason: `refusing to preview ${suffix} (may contain credentials)` };
+    }
+  }
+  return { resolved, deniedReason: null };
+}
+
 function startDaemonControlServer({
   controlToken,
   getChildren,
@@ -6098,6 +6193,7 @@ function startDaemonControlServer({
   onClaudeAuthFailed,
   onSessionTurnEvent,
   pushClipboard,
+  pushFilePreview,
   onTerminalHook,
   setTerminalTitle
 }) {
@@ -6312,7 +6408,8 @@ function startDaemonControlServer({
     typed.post("/clipboard", {
       schema: {
         body: z.z.object({
-          text: z.z.string()
+          text: z.z.string(),
+          terminalId: z.z.string().regex(/^[a-zA-Z0-9_-]{1,64}$/).optional()
         }),
         response: {
           200: z.z.object({
@@ -6324,9 +6421,25 @@ function startDaemonControlServer({
         }
       }
     }, async (request) => {
-      const { text } = request.body;
+      const { text, terminalId } = request.body;
       persistence.logger.debug(`[CONTROL SERVER] Clipboard push request (${text.length} chars)`);
-      return pushClipboard(text);
+      return terminalId ? pushClipboard(text, terminalId) : pushClipboard(text);
+    });
+    typed.post("/file-preview", {
+      schema: {
+        body: z.z.object({
+          terminalId: z.z.string().regex(/^[a-zA-Z0-9_-]{1,64}$/),
+          path: z.z.string().min(1),
+          mode: z.z.enum(["file", "diff"]).optional()
+        }),
+        response: { 200: z.z.object({ delivered: z.z.boolean(), error: z.z.string().optional() }) }
+      }
+    }, async (request) => {
+      const { terminalId, path, mode } = request.body;
+      const verdict = checkPreviewPath(path);
+      if (verdict.deniedReason) return { delivered: false, error: verdict.deniedReason };
+      if (!pushFilePreview) return { delivered: false, error: "daemon is still starting up" };
+      return pushFilePreview(terminalId, verdict.resolved, mode ?? "file");
     });
     typed.post("/terminal-title", {
       schema: {
@@ -7875,7 +7988,7 @@ function parseJsonObject(text) {
     return null;
   }
 }
-function resolveSdkClaudeBinary(platform = process.platform, arch = process.arch, resolver = (s) => node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-__h-pCTK.cjs', document.baseURI).href))).resolve(s)) {
+function resolveSdkClaudeBinary(platform = process.platform, arch = process.arch, resolver = (s) => node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-CSQZhQ0C.cjs', document.baseURI).href))).resolve(s)) {
   const platformArch = `${platform}-${arch}`;
   const candidates = [
     `@anthropic-ai/claude-agent-sdk-${platformArch}/claude`,
@@ -8588,8 +8701,8 @@ function createMirrorManager(deps) {
       machineId: deps.machineId,
       homeDir: os.homedir(),
       happyHomeDir: persistence.configuration.happyHomeDir,
-      happyLibDir: api.projectPath(),
-      happyToolsDir: path.resolve(api.projectPath(), "tools", "unpacked"),
+      happyLibDir: projectPath.projectPath(),
+      happyToolsDir: path.resolve(projectPath.projectPath(), "tools", "unpacked"),
       startedBy: "terminal",
       lifecycleState: "running",
       lifecycleStateSince: Date.now(),
@@ -9049,14 +9162,15 @@ On restart inspect authoritative state and messages before taking new actions. D
 `;
 const PI_TEAMS_EXTENSION = `// Managed by Very Happy Agent Teams.
 export default async function(pi) {
-  const endpoint = process.env.HAPPY_MCP_URL;
+  const managed = !!process.env.HAPPY_MCP_URL;
+  const endpoint = process.env.HAPPY_MCP_URL || process.env.HAPPY_TERMINAL_MCP_URL;
   if (!endpoint) return;
   const url = new URL(endpoint);
   if (!['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname) || url.protocol !== 'http:') throw new Error('Very Happy MCP must be local');
   const {readFile} = await import('node:fs/promises');
   const {join} = await import('node:path');
   const {homedir} = await import('node:os');
-  const contextEndpoint = process.env.HAPPY_CONTEXT_USAGE_URL;
+  const contextEndpoint = managed && process.env.HAPPY_CONTEXT_USAGE_URL;
   if (contextEndpoint) {
     const target = new URL(contextEndpoint);
     if (target.origin !== url.origin || !target.pathname.startsWith('/runtime-context/')) throw new Error('Very Happy context must be local');
@@ -9074,7 +9188,7 @@ export default async function(pi) {
       });
     }
   }
-  pi.on('tool_call', async (event, ctx) => {
+  if (managed) pi.on('tool_call', async (event, ctx) => {
     let mode = process.env.HAPPY_PERMISSION_MODE || 'default';
     const sid = process.env.HAPPY_SESSION_ID;
     if (sid && /^[a-zA-Z0-9_-]+$/.test(sid)) {
@@ -9113,7 +9227,11 @@ export default async function(pi) {
   const available = await rpc('tools/list', {});
   for (const tool of available.tools || []) {
     pi.registerTool({name:tool.name,label:tool.name,description:tool.description || tool.name,parameters:tool.inputSchema,
-      async execute(_id, args) { const result = await rpc('tools/call', {name:tool.name,arguments:args}); return {content:result.content,details:{isError:!!result.isError}}; }
+      async execute(_id, args) {
+        const result = await rpc('tools/call', {name:tool.name,arguments:args});
+        if (result.isError) throw new Error((result.content || []).filter(block => block.type === 'text').map(block => block.text).join('\\n') || 'Very Happy tool failed');
+        return {content:result.content,details:{isError:false}};
+      }
     });
   }
 }
@@ -9937,7 +10055,7 @@ const initialMachineMetadata = {
   happyCliVersion: persistence.packageJson.version,
   homeDir: os$1.homedir(),
   happyHomeDir: persistence.configuration.happyHomeDir,
-  happyLibDir: api.projectPath(),
+  happyLibDir: projectPath.projectPath(),
   cliAvailability: startupCliAvailability,
   resumeSupport: { ...api.detectResumeSupport(), rpcAvailable: true }
 };
@@ -10385,7 +10503,7 @@ async function startDaemon() {
           const sessionDesc = tmuxSessionName || "current/most recent session";
           persistence.logger.debug(`[DAEMON RUN] Attempting to spawn session in tmux: ${sessionDesc}`);
           const tmux = getTmuxUtilities(tmuxSessionName);
-          const cliPath = path$1.join(api.projectPath(), "dist", "index.mjs");
+          const cliPath = path$1.join(projectPath.projectPath(), "dist", "index.mjs");
           const agent = options.agent ?? "claude";
           if (!isSpawnAgent(agent)) {
             return {
@@ -10989,11 +11107,15 @@ async function startDaemon() {
       onSessionStateEvent,
       onClaudeAuthFailed: (sessionId) => claudeAuthServiceRef?.signalAuthFailed(sessionId),
       onSessionTurnEvent: (sessionId, event) => turnActivity.apply(sessionId, event),
-      pushClipboard: (text) => {
+      pushClipboard: (text, terminalId) => {
         if (!apiMachineRef) {
           return { delivered: false, truncated: false, totalBytes: 0, error: "daemon is still starting up" };
         }
-        return apiMachineRef.pushClipboard(text);
+        return apiMachineRef.pushClipboard(text, terminalId);
+      },
+      pushFilePreview: (terminalId, path, mode) => {
+        if (!apiMachineRef) return { delivered: false, error: "daemon is still starting up" };
+        return apiMachineRef.pushFilePreview(terminalId, path, mode);
       },
       onTerminalHook: (body) => {
         mirrorManagerRef?.handleHookPayload(body);
@@ -11017,7 +11139,7 @@ async function startDaemon() {
     };
     persistence.writeDaemonState(fileState);
     persistence.logger.debug("[DAEMON RUN] Daemon state written");
-    const bundlePath = path$1.join(api.projectPath(), "dist", "index.mjs");
+    const bundlePath = path$1.join(projectPath.projectPath(), "dist", "index.mjs");
     let initialBundleMtimeMs = 0;
     try {
       initialBundleMtimeMs = fs$1.statSync(bundlePath).mtimeMs;
@@ -11073,7 +11195,7 @@ async function startDaemon() {
     });
     const claudeAuthService = new ClaudeAuthService({
       happyHomeDir: persistence.configuration.happyHomeDir,
-      happyLibDir: api.projectPath(),
+      happyLibDir: projectPath.projectPath(),
       credentialSource: daemonClaudeCredentials.source,
       getCredentialStore: () => claudeCredentialStoreSetting,
       setCredentialStore: async (store) => {
@@ -11730,83 +11852,6 @@ function normalizeProgress(value) {
   return flat.length > PROGRESS_MAX_CHARS$1 ? flat.slice(0, PROGRESS_MAX_CHARS$1) : flat;
 }
 
-const DENIED_HOME_DIRS = [
-  ".secrets",
-  ".ssh",
-  ".gnupg",
-  ".aws",
-  ".kube",
-  ".config/rbw"
-];
-const DENIED_HOME_FILES = [
-  ".claude.json",
-  ".claude/.credentials.json",
-  ".netrc",
-  ".pgpass"
-];
-const DENIED_BASENAME_PATTERNS = [
-  /^\.env$/i,
-  /^\.env\./i,
-  /\.env$/i,
-  /\.pem$/i,
-  /\.key$/i,
-  /\.p12$/i,
-  /\.pfx$/i,
-  /^id_(rsa|dsa|ecdsa|ed25519)$/i,
-  /^\.htpasswd$/i
-];
-const DENIED_PATH_SUFFIXES = [
-  `${path.sep}.git${path.sep}config`
-];
-function expandHome(input, home) {
-  if (input === "~") return home;
-  if (input.startsWith(`~${path.sep}`) || input.startsWith("~/")) {
-    return path.resolve(home, input.slice(2));
-  }
-  return input;
-}
-function basenameOf(p) {
-  const parts = p.split(path.sep);
-  return parts[parts.length - 1] ?? "";
-}
-function isUnder(child, parent) {
-  return child === parent || child.startsWith(parent.endsWith(path.sep) ? parent : parent + path.sep);
-}
-function checkPreviewPath(input, opts) {
-  const home = os.homedir();
-  const cwd = process.cwd();
-  if (typeof input !== "string" || !input.trim()) {
-    return { resolved: "", deniedReason: "path must be a non-empty string" };
-  }
-  if (input.includes("\0")) {
-    return { resolved: "", deniedReason: "path contains a NUL byte" };
-  }
-  const expanded = expandHome(input.trim(), home);
-  const resolved = path.isAbsolute(expanded) ? path.resolve(expanded) : path.resolve(cwd, expanded);
-  for (const dir of DENIED_HOME_DIRS) {
-    if (isUnder(resolved, path.resolve(home, dir))) {
-      return { resolved, deniedReason: `refusing to preview anything under ~/${dir} (credential material)` };
-    }
-  }
-  for (const file of DENIED_HOME_FILES) {
-    if (resolved === path.resolve(home, file)) {
-      return { resolved, deniedReason: `refusing to preview ~/${file} (credential material)` };
-    }
-  }
-  const base = basenameOf(resolved);
-  for (const pattern of DENIED_BASENAME_PATTERNS) {
-    if (pattern.test(base)) {
-      return { resolved, deniedReason: `refusing to preview "${base}" (looks like credential material)` };
-    }
-  }
-  for (const suffix of DENIED_PATH_SUFFIXES) {
-    if (resolved.endsWith(suffix)) {
-      return { resolved, deniedReason: `refusing to preview ${suffix} (may contain credentials)` };
-    }
-  }
-  return { resolved, deniedReason: null };
-}
-
 function createMcpServer(handlers, options, sessionId) {
   const mcp = new mcp_js.McpServer({
     name: "Very Happy Tools",
@@ -11858,7 +11903,7 @@ function createMcpServer(handlers, options, sessionId) {
       return {
         content: [{
           type: "text",
-          text: `Sent to the user's clipboard on their currently open device(s)${note}. If the page was not focused, they may need to tap a confirmation button.`
+          text: `Queued a clipboard request for the user's open Very Happy device(s)${note}. This does not confirm that a browser wrote the clipboard; the user may need to tap a confirmation button.`
         }],
         isError: false
       };
@@ -12154,7 +12199,7 @@ function generateHookSettingsFile(port) {
   node_fs.mkdirSync(hooksDir, { recursive: true });
   const filename = `session-hook-${process.pid}.json`;
   const filepath = path.join(hooksDir, filename);
-  const forwarderScript = path.resolve(api.projectPath(), "scripts", "session_hook_forwarder.cjs");
+  const forwarderScript = path.resolve(projectPath.projectPath(), "scripts", "session_hook_forwarder.cjs");
   const hookCommand = `node "${forwarderScript}" ${port}`;
   const settings = {
     hooks: {
@@ -12327,7 +12372,7 @@ function registerSideQuestionHandler(rpc, deps) {
   const retainMs = deps.retainMs ?? SIDE_QUESTION_RETAIN_MS;
   const maxRunMs = deps.maxRunMs ?? SIDE_QUESTION_MAX_RUN_MS;
   const run = deps.run ?? (async (input) => {
-    const { query } = await Promise.resolve().then(function () { return require('./index-BuQn9kUK.cjs'); });
+    const { query } = await Promise.resolve().then(function () { return require('./index-Bom8mTuS.cjs'); });
     return runSideQuestion(query, input);
   });
   const slots = /* @__PURE__ */ new Map();
@@ -12429,8 +12474,8 @@ const MAX_TITLE_CHARS = 60;
 const GENERATION_TIMEOUT_MS = 3e4;
 function resolveClaudeBinary() {
   try {
-    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-__h-pCTK.cjs', document.baseURI).href)));
-    const utilsPath = path.resolve(path.join(api.projectPath(), "scripts", "claude_version_utils.cjs"));
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-CSQZhQ0C.cjs', document.baseURI).href)));
+    const utilsPath = path.resolve(path.join(projectPath.projectPath(), "scripts", "claude_version_utils.cjs"));
     const { getClaudeCliPath } = require$1(utilsPath);
     const path$1 = getClaudeCliPath();
     if (typeof path$1 === "string" && path$1.length > 0) return path$1;
@@ -12876,8 +12921,8 @@ async function runClaude(credentials, options = {}) {
     machineId,
     homeDir: os.homedir(),
     happyHomeDir: persistence.configuration.happyHomeDir,
-    happyLibDir: api.projectPath(),
-    happyToolsDir: path.resolve(api.projectPath(), "tools", "unpacked"),
+    happyLibDir: projectPath.projectPath(),
+    happyToolsDir: path.resolve(projectPath.projectPath(), "tools", "unpacked"),
     startedFromDaemon: options.startedBy === "daemon",
     hostPid: process.pid,
     startedBy: options.startedBy || "terminal",
@@ -14655,9 +14700,9 @@ function resolveLocalSignupBootstrap(configuredMode, configuredInviteCodes, gene
   };
 }
 
-const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-__h-pCTK.cjs', document.baseURI).href)));
+const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-CSQZhQ0C.cjs', document.baseURI).href)));
 const __dirname$1 = path.dirname(__filename$1);
-const require_ = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-__h-pCTK.cjs', document.baseURI).href)));
+const require_ = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-CSQZhQ0C.cjs', document.baseURI).href)));
 const PRISMA_QUERY_ENGINE_FILES = {
   "arm64-darwin": "libquery_engine-darwin-arm64.dylib.node",
   "x64-darwin": "libquery_engine-darwin.dylib.node",
@@ -17155,7 +17200,7 @@ async function runCodex(opts) {
     }
   });
   const happyServer = await startHappyServer(session);
-  const bridgeEntrypoint = path.join(api.projectPath(), "bin", "very-happy-mcp.mjs");
+  const bridgeEntrypoint = path.join(projectPath.projectPath(), "bin", "very-happy-mcp.mjs");
   const mcpServers = {
     happy: {
       command: process.execPath,
@@ -17561,9 +17606,18 @@ Conversation history is preserved on the server, but in-flight tool calls are in
   } else if (subcommand === "bye") {
     console.log("Bye!");
     process.exit(0);
+  } else if (subcommand === "install-pi-tools") {
+    try {
+      const { handleInstallPiTools } = await Promise.resolve().then(function () { return require('./installPiTools-BKnXjrVu.cjs'); });
+      await handleInstallPiTools(args.slice(1));
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : "Pi tools installation failed");
+      process.exitCode = 1;
+    }
+    return;
   } else if (subcommand === "install-terminal-hooks") {
     try {
-      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-D3jfvbyY.cjs'); });
+      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-DA7SyFYW.cjs'); });
       const command = parseTerminalHooksArgs(args.slice(1));
       if (command.action === "help") {
         console.log(TERMINAL_HOOKS_HELP);
@@ -17580,7 +17634,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
   } else if (subcommand === "spawn") {
     try {
-      const { handleSpawnCommand } = await Promise.resolve().then(function () { return require('./spawn-BhUK0Vt2.cjs'); });
+      const { handleSpawnCommand } = await Promise.resolve().then(function () { return require('./spawn-COOcUwkG.cjs'); });
       await handleSpawnCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -17592,7 +17646,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "sessions") {
     try {
-      const { handleSessionsCommand } = await Promise.resolve().then(function () { return require('./sessions-CGBBgVZn.cjs'); });
+      const { handleSessionsCommand } = await Promise.resolve().then(function () { return require('./sessions-DPimBZ8H.cjs'); });
       await handleSessionsCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -17604,7 +17658,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "send") {
     try {
-      const { handleSendCommand } = await Promise.resolve().then(function () { return require('./send-DP_S3wn0.cjs'); });
+      const { handleSendCommand } = await Promise.resolve().then(function () { return require('./send-Bg2oqt7f.cjs'); });
       await handleSendCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -17710,9 +17764,9 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     if (geminiSubcommand === "project" && args[2] === "set" && args[3]) {
       const projectId = args[3];
       try {
-        const { saveGoogleCloudProjectToConfig } = await Promise.resolve().then(function () { return require('./config-D0-jnCOC.cjs'); });
-        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-Dbip6eVO.cjs'); }).then(function (n) { return n.persistence; });
-        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-DCVS050m.cjs'); }).then(function (n) { return n.api; });
+        const { saveGoogleCloudProjectToConfig } = await Promise.resolve().then(function () { return require('./config-BIbYBmTd.cjs'); });
+        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-B3hngubn.cjs'); }).then(function (n) { return n.persistence; });
+        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-Xd_LJRJN.cjs'); }).then(function (n) { return n.api; });
         let userEmail = void 0;
         try {
           const credentials = await readCredentialsForConfiguredRelay2();
@@ -17743,7 +17797,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
     if (geminiSubcommand === "project" && args[2] === "get") {
       try {
-        const { readGeminiLocalConfig } = await Promise.resolve().then(function () { return require('./config-D0-jnCOC.cjs'); });
+        const { readGeminiLocalConfig } = await Promise.resolve().then(function () { return require('./config-BIbYBmTd.cjs'); });
         const config = readGeminiLocalConfig();
         if (config.googleCloudProject) {
           console.log(`Current Google Cloud Project: ${config.googleCloudProject}`);
@@ -17783,7 +17837,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(0);
     }
     try {
-      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-D34eCFpz.cjs'); });
+      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-eJ08cXk7.cjs'); });
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -17804,6 +17858,16 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
     return;
   } else if (subcommand === "pi") {
+    if (args[1] === "--terminal") {
+      try {
+        const { runPiTerminal } = await Promise.resolve().then(function () { return require('./piTerminal-DNr3hkzY.cjs'); });
+        process.exitCode = await runPiTerminal(args.slice(2));
+      } catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
+        process.exitCode = 1;
+      }
+      return;
+    }
     let hintPrinted = false;
     const printHint = (detail) => {
       const hint = piAdapterMissingHint(detail);
@@ -17813,7 +17877,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       }
     };
     try {
-      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DJvzGXVN.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-BPTPrjhL.cjs'); });
       const parsed = parsePiRunnerArgs(args.slice(1));
       const resolved = resolveAcpAgentConfig(["pi", ...parsed.passthrough]);
       const { credentials } = await authAndSetupMachineIfNeeded();
@@ -17841,7 +17905,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "acp") {
     try {
-      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DJvzGXVN.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-BPTPrjhL.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       const acpArgs = [];
@@ -17881,7 +17945,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "openclaw") {
     try {
-      const { runOpenClaw } = await Promise.resolve().then(function () { return require('./runOpenClaw-B8F8D--R.cjs'); });
+      const { runOpenClaw } = await Promise.resolve().then(function () { return require('./runOpenClaw-D0LVzxqM.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       let gatewayUrl;
@@ -17932,7 +17996,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "todo") {
     try {
-      const { handleTodoCommand } = await Promise.resolve().then(function () { return require('./todo-CeJX0z_2.cjs'); });
+      const { handleTodoCommand } = await Promise.resolve().then(function () { return require('./todo-DeauuUd6.cjs'); });
       await handleTodoCommand(args.slice(1));
     } catch (error) {
       console.error(JSON.stringify({ error: error instanceof Error ? error.message : "Todo command failed" }));
@@ -17941,17 +18005,17 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "teams") {
     try {
-      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-C29nEHFD.cjs'); });
+      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-DSQgHBLE.cjs'); });
       await handleTeamsCommand(args.slice(1));
     } catch (error) {
       console.error(error instanceof Error ? error.message : "Teams command failed");
       process.exitCode = 1;
     }
     return;
-  } else if (subcommand === "mcp" && args.length === 1) {
+  } else if (subcommand === "mcp" && (args.length === 1 || args.length === 2 && args[1] === "--terminal-tools")) {
     try {
-      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-DeapmTWN.cjs'); });
-      await handleMcpCommand();
+      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-ySrfNOYl.cjs'); });
+      await handleMcpCommand(args[1] === "--terminal-tools");
     } catch (error) {
       process.stderr.write(`[very-happy mcp] Fatal: ${error instanceof Error ? error.message : String(error)}
 `);
@@ -18171,6 +18235,10 @@ ${chalk.bold("Usage:")}
   very-happy codex             Start Codex mode
   very-happy gemini            Start Gemini mode (ACP)
   very-happy pi                Start pi mode (ACP via the pi-acp adapter)
+  very-happy pi --terminal     Run native pi with title, clipboard and preview tools
+                            inside a Very Happy terminal
+  very-happy install-pi-tools  Install tools for directly launched pi sessions
+                            (add --remove to uninstall)
   very-happy acp               Start a generic ACP-compatible agent
   very-happy openclaw          Connect through a configured OpenClaw gateway
   very-happy install-terminal-hooks
@@ -18332,6 +18400,7 @@ exports.TEAM_SKILL = TEAM_SKILL;
 exports.TitleGenerator = TitleGenerator;
 exports.appendStagedAttachmentsToPrompt = appendStagedAttachmentsToPrompt;
 exports.archiveSession = archiveSession;
+exports.checkPreviewPath = checkPreviewPath;
 exports.createSessionMetadata = createSessionMetadata;
 exports.hashObject = hashObject;
 exports.initialMachineMetadata = initialMachineMetadata;