very-happy-cli 0.2.178 → 0.2.180

package/dist/{controlClient-BTaZlbC6.cjs → controlClient-Bqv5v5OM.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var logger = require('./logger-DXTWlPzP.cjs');
-var persistence = require('./persistence-BfX72dne.cjs');
-var configuration = require('./configuration-4TGMrjul.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
+var persistence = require('./persistence-9BMYspxG.cjs');
+var configuration = require('./configuration-CYO-kPOS.cjs');
 
 function daemonControlHeaders(controlToken) {
   return {

package/dist/{controlClient-BYKyGyxj.mjs → controlClient-DoeYovwP.mjs}

@@ -1,6 +1,6 @@
-import { l as logger } from './logger--vAVtXB_.mjs';
-import { d as readDaemonState, f as clearDaemonState } from './persistence-DTk4sNpd.mjs';
-import { c as configuration } from './configuration-DVrb61aY.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
+import { d as readDaemonState, f as clearDaemonState } from './persistence-BFUOHW5h.mjs';
+import { c as configuration } from './configuration-PxzEJumr.mjs';
 
 function daemonControlHeaders(controlToken) {
   return {
@@ -278,4 +278,4 @@ async function checkDaemonHibernation(body) {
   };
 }
 
-export { checkIfDaemonRunningAndCleanupStaleState as a, stopDaemon as b, checkDaemonHibernation as c, pushFilePreviewViaDaemon as d, setTerminalTitleViaDaemon as e, spawnDaemonSession as f, listDaemonPeers as g, resumeDaemonSession as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, reportSessionEditToDaemon as j, notifyDaemonTurnEvent as k, listDaemonSessions as l, notifyDaemonBackgroundTasks as m, notifyDaemonSessionStarted as n, cleanupDaemonState as o, pushClipboardViaDaemon as p, notifyDaemonSessionEvent as q, reportRateLimitsToDaemon as r, stopDaemonSession as s, notifyDaemonClaudeAuthFailed as t };
+export { checkIfDaemonRunningAndCleanupStaleState as a, pushFilePreviewViaDaemon as b, checkDaemonHibernation as c, setTerminalTitleViaDaemon as d, spawnDaemonSession as e, stopDaemonSession as f, listDaemonPeers as g, resumeDaemonSession as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, reportSessionEditToDaemon as j, notifyDaemonTurnEvent as k, listDaemonSessions as l, notifyDaemonBackgroundTasks as m, notifyDaemonSessionStarted as n, notifyDaemonSessionEvent as o, pushClipboardViaDaemon as p, notifyDaemonClaudeAuthFailed as q, reportRateLimitsToDaemon as r, stopDaemon as s, cleanupDaemonState as t };

package/dist/{createSessionMetadata-8Fuj2-IV.mjs → createSessionMetadata-DDIChCx8.mjs}

@@ -1,8 +1,8 @@
 import os from 'node:os';
 import { resolve, isAbsolute, dirname } from 'node:path';
-import { c as configuration } from './configuration-DVrb61aY.mjs';
+import { c as configuration } from './configuration-PxzEJumr.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-B7B03ejW.mjs';
+import { p as packageJson } from './package-7Ld1YMhh.mjs';
 import { existsSync, readFileSync, statSync } from 'node:fs';
 
 const realFs = {

package/dist/{createSessionMetadata-B2NynaWZ.cjs → createSessionMetadata-xz767pcG.cjs}

@@ -2,9 +2,9 @@
 
 var os = require('node:os');
 var path = require('node:path');
-var configuration = require('./configuration-4TGMrjul.cjs');
-var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-DY4zTbKS.cjs');
+var configuration = require('./configuration-CYO-kPOS.cjs');
+var projectPath = require('./projectPath-C3ioB4Bu.cjs');
+var _package = require('./package-KhLqBDX9.cjs');
 var node_fs = require('node:fs');
 
 const realFs = {

package/dist/{defaultPermissionMode-BEWCqJU-.cjs → defaultPermissionMode-PkZGsQDk.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var logger = require('./logger-DXTWlPzP.cjs');
-var persistence = require('./persistence-BfX72dne.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
+var persistence = require('./persistence-9BMYspxG.cjs');
 
 const PRESENCE_SETTLE_MS = 6e3;
 async function commitHibernation(deps) {

package/dist/{defaultPermissionMode-B8kJG9uI.mjs → defaultPermissionMode-i5KzdK09.mjs}

@@ -1,5 +1,5 @@
-import { l as logger } from './logger--vAVtXB_.mjs';
-import { e as evaluateWrapperIdle, j as HIBERNATION_UNSUPPORTED_BACKOFF_MS } from './persistence-DTk4sNpd.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
+import { e as evaluateWrapperIdle, j as HIBERNATION_UNSUPPORTED_BACKOFF_MS } from './persistence-BFUOHW5h.mjs';
 
 const PRESENCE_SETTLE_MS = 6e3;
 async function commitHibernation(deps) {

package/dist/{detectCLI-DR9ZaN6B.cjs → detectCLI-BuYR_Qxe.cjs}

@@ -2,8 +2,8 @@
 
 var child_process = require('child_process');
 var os = require('os');
-var fs = require('fs');
-var path = require('path');
+var require$$0 = require('fs');
+var require$$1 = require('path');
 
 function detectCLIAvailability() {
   const isWindows = os.platform() === "win32";
@@ -38,7 +38,7 @@ function detectPosix() {
   const codex = commandExists("codex");
   const gemini = commandExists("gemini");
   const openclawCommand = commandExists("openclaw");
-  const openclawConfig = fs.existsSync(path.join(os.homedir(), ".openclaw", "openclaw.json"));
+  const openclawConfig = require$$0.existsSync(require$$1.join(os.homedir(), ".openclaw", "openclaw.json"));
   const openclawEnv = !!process.env.OPENCLAW_GATEWAY_URL;
   const openclaw = openclawCommand || openclawConfig || openclawEnv;
   const pi = commandExists("pi") && commandExists("pi-acp");
@@ -50,7 +50,7 @@ function detectWindows() {
   const codex = checkCommand("codex");
   const gemini = checkCommand("gemini");
   const openclawCommand = checkCommand("openclaw");
-  const openclawConfig = fs.existsSync(path.join(process.env.USERPROFILE || os.homedir(), ".openclaw", "openclaw.json"));
+  const openclawConfig = require$$0.existsSync(require$$1.join(process.env.USERPROFILE || os.homedir(), ".openclaw", "openclaw.json"));
   const openclawEnv = !!process.env.OPENCLAW_GATEWAY_URL;
   const openclaw = openclawCommand || openclawConfig || openclawEnv;
   const pi = checkCommand("pi") && checkCommand("pi-acp");

package/dist/{deterministicJson-C5ZwZ7hu.mjs → deterministicJson-CTEJDqtS.mjs}

@@ -1,26 +1,124 @@
-import { C as ContextUsageSchema } from './index-Clqlu17M.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
+import { p as prependToMessage, b as buildDigestLine, a as buildFirstTurnPrefix } from './prompt-BOouDaTM.mjs';
+import { P as ProjectsUnsupportedError } from './client-Ca5Pcgy_.mjs';
+import { c as createSelfReportState, A as AUTOMATION_TOOL_NAMES, P as PROJECT_TOOL_NAMES, r as registerAutomationTools, a as registerProjectTools, d as createProjectToolExecutor, b as registerReportProgressTool, n as normalizeAttention, e as normalizePhase, f as normalizeProgress, s as shouldAcceptSelfReport } from './reportProgressTool-ZOCNjWHr.mjs';
+import { C as ContextUsageSchema } from './index-C6Vn5Eac.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-BTX9hsbr.mjs';
-import { t as teamScopePath } from './context-B3XPVJlj.mjs';
-import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-BVoXe12O.mjs';
-import { T as TEAM_SKILL } from './resources-BdFBQi8r.mjs';
-import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-BtsrQnNS.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-D5tEoXMW.mjs';
-import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-3R9RUARX.mjs';
+import { T as TeamConnectionPreflightError, c as createTeamsClient } from './client-D4uPb1uu.mjs';
+import { t as teamScopePath } from './context-CJGRRGWW.mjs';
+import { g as waitForSessionKey, e as sendUserMessage } from './sessionOps-C58iDeD5.mjs';
+import { T as TEAM_SKILL } from './resources-y9jfyO-_.mjs';
+import { T as TEAM_TOOL_NAMES, r as registerTeamsTools } from './tools-Cho7iIWf.mjs';
+import { S as SESSION_PEER_TOOL_NAMES, r as registerSessionPeerTools, a as createSessionPeerToolExecutor } from './peerTools-BOlDRyhi.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--vAVtXB_.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, c as checkDownloadTarget } from './downloadTarget-DJPwAZlu.mjs';
+import { A as ASSISTANT_TOOL_NAMES, a as registerAssistantTools, c as checkDownloadTarget } from './downloadTarget-jbOz1egC.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 { n as normalizeWebPanels, w as webPanelPath } from './webPanels-B2_C2-3g.mjs';
+import { r as readSettings } from './persistence-BFUOHW5h.mjs';
+import { g as getSessionNotificationBody } from './pushNotifications-DCiBEVeC.mjs';
 import { c as checkPreviewPath } from './previewPath-CXN4Vag0.mjs';
 import { createHash } from 'crypto';
 
+function createProjectInjector(deps) {
+  const timeoutMs = deps.timeoutMs ?? 1500;
+  const now = deps.now ?? Date.now;
+  const presenceEvery = deps.presenceMinIntervalMs ?? 3e4;
+  const state = { projectId: null, prefixSent: false, cursor: 0, injectedVersion: null };
+  const titles = /* @__PURE__ */ new Map();
+  let lastPresenceAt = 0;
+  let lastPresenceVersion = null;
+  const label = (id) => titles.get(id) ?? id.slice(0, 8);
+  function withTimeout(p) {
+    return Promise.race([p, new Promise((_, reject) => setTimeout(() => reject(new Error("project injection timeout")), timeoutMs).unref?.())]);
+  }
+  function reportPresence(force) {
+    const sid = deps.sessionId();
+    const meta = deps.metadata?.() ?? null;
+    const machineId = typeof meta?.machineId === "string" ? meta.machineId : null;
+    if (!sid || !machineId || !state.projectId) return;
+    const t = now();
+    if (!force && state.injectedVersion === lastPresenceVersion && t - lastPresenceAt < presenceEvery) return;
+    lastPresenceAt = t;
+    lastPresenceVersion = state.injectedVersion;
+    const entry = {
+      sessionId: sid,
+      agent: deps.agent,
+      state: "running",
+      injectedInstructionsVersion: state.injectedVersion,
+      ...typeof meta?.summary?.text === "string" ? { title: String(meta.summary.text).slice(0, 200) } : {},
+      ...typeof meta?.board?.progress === "string" ? { doing: String(meta.board.progress).slice(0, 200) } : {},
+      ...typeof meta?.worktree?.branch === "string" ? { branch: String(meta.worktree.branch).slice(0, 200) } : {},
+      ...typeof meta?.host === "string" ? { machine: String(meta.host).slice(0, 200) } : {},
+      ...Array.isArray(meta?.capabilities) ? { capabilities: meta.capabilities.filter((c) => typeof c === "string").slice(0, 32) } : {}
+    };
+    void deps.client.presence(machineId, [entry]).catch((error) => logger.debug(`[projects] presence write skipped: ${String(error)}`));
+  }
+  function markDelivered(sid, ids) {
+    if (ids.length) void deps.client.delivered(sid, ids).catch((error) => logger.debug(`[projects] delivered ack skipped: ${String(error)}`));
+  }
+  async function firstTurn(sid, message) {
+    const ctx = await withTimeout(deps.client.context(sid, {}, timeoutMs));
+    for (const s of ctx.sessions) if (s.title) titles.set(s.sessionId, s.title);
+    const built = buildFirstTurnPrefix(ctx, { label });
+    if (!built || !ctx.project) {
+      state.projectId = null;
+      return message;
+    }
+    state.projectId = ctx.project.id;
+    state.prefixSent = true;
+    state.cursor = ctx.asOf;
+    state.injectedVersion = built.instructionsVersion;
+    markDelivered(sid, ctx.unread.map((u) => u.id));
+    reportPresence(true);
+    return prependToMessage(message, built.prefix);
+  }
+  async function laterTurn(sid, message) {
+    const d = await withTimeout(deps.client.digest(sid, state.cursor, timeoutMs));
+    if (!d.projectId) {
+      state.projectId = null;
+      state.prefixSent = false;
+      state.injectedVersion = null;
+      return message;
+    }
+    if (d.projectId !== state.projectId) {
+      state.prefixSent = false;
+      return firstTurn(sid, message);
+    }
+    state.cursor = d.asOf;
+    if (d.instructions) state.injectedVersion = d.instructions.version;
+    markDelivered(sid, d.messages.map((m) => m.id));
+    reportPresence(!!d.instructions);
+    return prependToMessage(message, buildDigestLine(d, { label }));
+  }
+  return {
+    state: () => ({ ...state }),
+    /** A fresh agent with no memory of earlier turns (ACP backend restart, new Claude conversation) needs P again. */
+    reset() {
+      state.prefixSent = false;
+      state.cursor = 0;
+    },
+    async decorate(message) {
+      if (typeof message !== "string") return message;
+      const sid = deps.sessionId();
+      if (!sid || deps.client.isDisabled()) return message;
+      try {
+        const out = state.prefixSent ? await laterTurn(sid, message) : await firstTurn(sid, message);
+        return out;
+      } catch (error) {
+        if (!(error instanceof ProjectsUnsupportedError)) logger.debug(`[projects] injection skipped: ${String(error)}`);
+        return message;
+      }
+    }
+  };
+}
+
 const TEAMS_ADOPT_CAPABILITY = "teams-adopt-v1";
 const TeamAdoptSchema = z.object({
   requestId: z.string().min(1).max(128),
@@ -128,6 +226,41 @@ This session is now connected as the team lead. Call team_inspect to read the au
   };
 }
 
+const REQUEST_HUMAN_TOOL_NAME = "request_human";
+const REQUEST_HUMAN_REASON_MAX = 200;
+const REQUEST_HUMAN_DEDUPE_MS = 6e4;
+const REQUEST_HUMAN_TOOL_DESCRIPTION = "Ask the user to step in when you cannot continue on your own: a captcha, 2FA code, QR scan, OAuth consent page, or a decision only they can make. Sends a push notification and marks the task board as blocked. Give a short reason (no secrets; the server can read it). If this machine declares a web panel showing what you are working in (e.g. a remote desktop or browser dashboard), pass its id as `panel` so the notification opens it. Afterwards, poll for your own completion condition (the page changed, the element disappeared) instead of waiting for a reply.";
+function createRequestHuman(deps) {
+  const now = deps.now ?? Date.now;
+  let last = null;
+  return async (rawReason, panel) => {
+    const reason = rawReason.replace(/\s+/g, " ").trim().slice(0, REQUEST_HUMAN_REASON_MAX);
+    if (!reason) return { notified: false, error: "reason must be a non-empty string" };
+    await deps.reportBlocked(reason);
+    const at = now();
+    if (last && last.reason === reason && at - last.at < REQUEST_HUMAN_DEDUPE_MS) {
+      return { notified: true, deduped: true };
+    }
+    let url = `/session/${encodeURIComponent(deps.sessionId)}`;
+    let unknownPanel;
+    if (panel) {
+      const machineId = deps.machineId();
+      const { panels } = normalizeWebPanels(await deps.readPanels().catch(() => void 0));
+      if (machineId && panels.some((p) => p.id === panel)) url = webPanelPath(machineId, panel);
+      else unknownPanel = panel;
+    }
+    const sent = await deps.sendAttention({ sessionId: deps.sessionId, reason, url });
+    if (sent.sent) last = { reason, at };
+    return { notified: sent.sent, url, ...unknownPanel ? { unknownPanel } : {}, ...sent.error ? { error: sent.error } : {} };
+  };
+}
+function requestHumanResultText(r) {
+  if (r.deduped) return "Already asked for this in the last minute; the board still shows it. Keep polling your completion condition.";
+  if (!r.notified) return `Could not notify the user: ${r.error ?? "unknown error"}. The task board is marked blocked.`;
+  const panelNote = r.unknownPanel ? ` (panel "${r.unknownPanel}" is not declared on this machine, so the notification opens the session instead)` : "";
+  return `Notified the user${panelNote}. This does not mean they have seen it. Poll your own completion condition (URL changed, element gone) instead of waiting for a reply.`;
+}
+
 function createMcpServer(handlers, options, sessionId, client) {
   const mcp = new McpServer({
     name: "Very Happy Tools",
@@ -136,6 +269,7 @@ function createMcpServer(handlers, options, sessionId, client) {
   registerTeamsTools(mcp, sessionId);
   registerAutomationTools(mcp);
   if (client) registerSessionPeerTools(mcp, createSessionPeerToolExecutor(client));
+  if (client) registerProjectTools(mcp, createProjectToolExecutor(() => client.sessionId));
   mcp.registerTool("change_title", {
     description: "Change the title of the current chat session",
     title: "Change Chat Title",
@@ -222,6 +356,18 @@ function createMcpServer(handlers, options, sessionId, client) {
       isError: true
     };
   });
+  mcp.registerTool(REQUEST_HUMAN_TOOL_NAME, {
+    description: REQUEST_HUMAN_TOOL_DESCRIPTION,
+    title: "Ask the user to step in",
+    inputSchema: {
+      reason: z.string().describe("What you need from the user, one short line (no secrets)"),
+      panel: z.string().optional().describe("Id of this machine's web panel that shows what you are working in (from ~/.happy/settings.json webPanels)")
+    }
+  }, async (args) => {
+    const response = await handlers.requestHuman(String(args.reason ?? ""), args.panel);
+    logger.debug("[happyMCP] request_human response:", response);
+    return { content: [{ type: "text", text: requestHumanResultText(response) }], isError: response.error === "reason must be a non-empty string" };
+  });
   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);
@@ -319,10 +465,66 @@ async function startHappyServer(client, options) {
       } catch (error) {
         return { delivered: false, truncated: false, totalBytes: 0, error: String(error) };
       }
-    }
+    },
+    requestHuman: createRequestHuman({
+      sessionId: client.sessionId,
+      machineId: () => client.getMetadata()?.machineId,
+      readPanels: async () => (await readSettings()).webPanels,
+      // Same board write (and attention-change throttle bypass) as report_progress.
+      reportBlocked: (reason) => handlers.reportProgress(reason, "blocked"),
+      sendAttention: (input) => options?.push ? options.push.sendAttention({ ...input, sessionTitle: getSessionNotificationBody(client.getMetadata()) }) : Promise.resolve({ sent: false, error: "push is not available in this runner" })
+    })
   };
   const contextPath = "/runtime-context/" + randomUUID();
+  const steerPath = "/runtime-steer/" + randomUUID();
   const server = createServer(async (req, res) => {
+    if (req.url?.startsWith("/runtime-steer/")) {
+      const steer = options?.piSteer;
+      if (!steer || req.headers.origin) {
+        res.writeHead(403).end();
+        return;
+      }
+      if (req.method === "GET" && req.url === steerPath) {
+        const gone = new AbortController();
+        res.on("close", () => gone.abort());
+        const item = await steer.take(25e3, gone.signal);
+        if (res.writableEnded || gone.signal.aborted) {
+          return;
+        }
+        if (!item) {
+          res.writeHead(204).end();
+          return;
+        }
+        res.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify(item));
+        return;
+      }
+      if (req.method === "POST" && (req.url === steerPath + "/hello" || req.url === steerPath + "/ack")) {
+        let body = "";
+        for await (const chunk of req) {
+          body += chunk.toString();
+          if (Buffer.byteLength(body) > 1024) {
+            res.writeHead(413).end();
+            return;
+          }
+        }
+        if (req.url.endsWith("/hello")) {
+          steer.hello();
+          res.writeHead(204).end();
+          return;
+        }
+        try {
+          const ack = JSON.parse(body);
+          if (typeof ack.id !== "number") throw new Error("id");
+          steer.ack(ack.id, ack.delivered === true);
+          res.writeHead(204).end();
+        } catch {
+          res.writeHead(400).end();
+        }
+        return;
+      }
+      res.writeHead(403).end();
+      return;
+    }
     if (req.url?.startsWith("/runtime-context/")) {
       if (!options?.onContextUsage || req.url !== contextPath || req.method !== "POST" || req.headers.origin) {
         res.writeHead(403).end();
@@ -379,14 +581,17 @@ async function startHappyServer(client, options) {
   return {
     url: baseUrl.toString(),
     contextUsageUrl: options?.onContextUsage ? new URL(contextPath, baseUrl).toString() : void 0,
+    steerUrl: options?.piSteer ? new URL(steerPath, baseUrl).toString() : void 0,
     toolNames: [
       "change_title",
       CLIPBOARD_TOOL_NAME,
       PREVIEW_TOOL_NAME,
       REPORT_PROGRESS_TOOL_NAME,
+      REQUEST_HUMAN_TOOL_NAME,
       ...TEAM_TOOL_NAMES,
       ...AUTOMATION_TOOL_NAMES,
       ...SESSION_PEER_TOOL_NAMES,
+      ...PROJECT_TOOL_NAMES,
       ...options?.assistant && !process.env.VH_TEAM_SCOPE_FILE ? ASSISTANT_TOOL_NAMES : []
     ],
     stop: () => {
@@ -483,4 +688,4 @@ function hashObject(obj, options, encoding = "hex") {
   return createHash("sha256").update(jsonString).digest(encoding);
 }
 
-export { hashObject as h, startHappyServer as s };
+export { createProjectInjector as c, hashObject as h, startHappyServer as s };