very-happy-cli 0.2.178 → 0.2.180

package/dist/{index-DFPT4HOO.cjs → query-BETKBrnz.cjs}

@@ -2,6 +2,8 @@
 
 var claudeAgentSdk = require('@anthropic-ai/claude-agent-sdk');
 var smallFastModel = require('./smallFastModel-D_uxGMo3.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
+var processTreeSnapshot = require('./processTreeSnapshot-mDbnuojn.cjs');
 
 const HAPPY_DEFAULT_ENTRYPOINT = "remote_mobile";
 function resolveHappyEntrypoint(currentValue) {
@@ -11,6 +13,20 @@ function resolveHappyEntrypoint(currentValue) {
   return HAPPY_DEFAULT_ENTRYPOINT;
 }
 
+const CLAUDE_TREE_REAP_DELAY_MS = 8e3;
+function scheduleClaudeTreeReap(pid, deps = {}) {
+  const snapshot = (deps.snapshot ?? ((root) => processTreeSnapshot.snapshotTree(root, { includeRoot: true, read: deps.read })))(pid);
+  if (snapshot.length === 0) return snapshot;
+  const schedule = deps.schedule ?? ((callback, delayMs) => {
+    setTimeout(callback, delayMs).unref?.();
+  });
+  schedule(() => {
+    const killed = processTreeSnapshot.killSurvivors(snapshot, deps);
+    if (killed.length > 0) logger.logger.debug(`[claude] Reaped ${killed.length} process(es) left from aborted Claude Code ${pid}: ${killed.join(", ")}`);
+  }, CLAUDE_TREE_REAP_DELAY_MS);
+  return snapshot;
+}
+
 function query(params) {
   const opts = params.options;
   let systemPrompt = void 0;
@@ -63,12 +79,20 @@ function query(params) {
     onUserDialog: opts?.onUserDialog,
     supportedDialogKinds: opts?.onUserDialog ? opts.supportedDialogKinds : void 0
   };
+  let claudePid;
+  sdkOptions.onProcessSpawned = (pid) => {
+    claudePid = pid;
+    opts?.onProcessSpawned?.(pid);
+  };
   if (opts?.abort) {
     const controller = new AbortController();
     if (opts.abort.aborted) {
       controller.abort(opts.abort.reason);
     } else {
-      opts.abort.addEventListener("abort", () => controller.abort(opts.abort?.reason), { once: true });
+      opts.abort.addEventListener("abort", () => {
+        if (claudePid !== void 0) scheduleClaudeTreeReap(claudePid);
+        controller.abort(opts.abort?.reason);
+      }, { once: true });
     }
     sdkOptions.abortController = controller;
   }
@@ -103,8 +127,4 @@ function query(params) {
   });
 }
 
-Object.defineProperty(exports, "AbortError", {
-    enumerable: true,
-    get: function () { return claudeAgentSdk.AbortError; }
-});
 exports.query = query;

package/dist/{index-CEjJnq05.mjs → query-ywZbQUzR.mjs}

@@ -1,6 +1,7 @@
 import { query as query$1 } from '@anthropic-ai/claude-agent-sdk';
-export { AbortError } from '@anthropic-ai/claude-agent-sdk';
 import { p as pinSmallFastModel, e as ensureLocalProxyBypass } from './smallFastModel-BLNgMrwR.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
+import { s as snapshotTree, k as killSurvivors } from './processTreeSnapshot-CuLJDNC-.mjs';
 
 const HAPPY_DEFAULT_ENTRYPOINT = "remote_mobile";
 function resolveHappyEntrypoint(currentValue) {
@@ -10,6 +11,20 @@ function resolveHappyEntrypoint(currentValue) {
   return HAPPY_DEFAULT_ENTRYPOINT;
 }
 
+const CLAUDE_TREE_REAP_DELAY_MS = 8e3;
+function scheduleClaudeTreeReap(pid, deps = {}) {
+  const snapshot = (deps.snapshot ?? ((root) => snapshotTree(root, { includeRoot: true, read: deps.read })))(pid);
+  if (snapshot.length === 0) return snapshot;
+  const schedule = deps.schedule ?? ((callback, delayMs) => {
+    setTimeout(callback, delayMs).unref?.();
+  });
+  schedule(() => {
+    const killed = killSurvivors(snapshot, deps);
+    if (killed.length > 0) logger.debug(`[claude] Reaped ${killed.length} process(es) left from aborted Claude Code ${pid}: ${killed.join(", ")}`);
+  }, CLAUDE_TREE_REAP_DELAY_MS);
+  return snapshot;
+}
+
 function query(params) {
   const opts = params.options;
   let systemPrompt = void 0;
@@ -62,12 +77,20 @@ function query(params) {
     onUserDialog: opts?.onUserDialog,
     supportedDialogKinds: opts?.onUserDialog ? opts.supportedDialogKinds : void 0
   };
+  let claudePid;
+  sdkOptions.onProcessSpawned = (pid) => {
+    claudePid = pid;
+    opts?.onProcessSpawned?.(pid);
+  };
   if (opts?.abort) {
     const controller = new AbortController();
     if (opts.abort.aborted) {
       controller.abort(opts.abort.reason);
     } else {
-      opts.abort.addEventListener("abort", () => controller.abort(opts.abort?.reason), { once: true });
+      opts.abort.addEventListener("abort", () => {
+        if (claudePid !== void 0) scheduleClaudeTreeReap(claudePid);
+        controller.abort(opts.abort?.reason);
+      }, { once: true });
     }
     sdkOptions.abortController = controller;
   }
@@ -102,4 +125,4 @@ function query(params) {
   });
 }
 
-export { query };
+export { query as q };

package/dist/{rateLimitWindows-XrJiiBpU.mjs → rateLimitWindows-BkfuUB1a.mjs}

@@ -1,4 +1,4 @@
-import { l as logger } from './logger--vAVtXB_.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
 
 const MAX_WINDOWS_PER_PROVIDER = 8;
 function finite(value) {

package/dist/{rateLimitWindows-Czb7_7cK.cjs → rateLimitWindows-YRIYVdo4.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var logger = require('./logger-DXTWlPzP.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
 
 const MAX_WINDOWS_PER_PROVIDER = 8;
 function finite(value) {

package/dist/{registerCommonHandlers-C0_fyBQ0.cjs → registerCommonHandlers-C7a_dUWs.cjs}

@@ -1,18 +1,18 @@
 'use strict';
 
-var logger = require('./logger-DXTWlPzP.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
 var child_process = require('child_process');
 var util = require('util');
 var fs = require('fs/promises');
-var crypto = require('crypto');
-var path = require('path');
+var require$$3 = require('crypto');
+var require$$1 = require('path');
 var spawn = require('cross-spawn');
-var projectPath = require('./projectPath-ChLhdOyt.cjs');
+var projectPath = require('./projectPath-C3ioB4Bu.cjs');
 var os = require('os');
-var configuration = require('./configuration-4TGMrjul.cjs');
+var configuration = require('./configuration-CYO-kPOS.cjs');
 
 function run$1(args, options) {
-  const RUNNER_PATH = path.resolve(path.join(projectPath.projectPath(), "scripts", "ripgrep_launcher.cjs"));
+  const RUNNER_PATH = require$$1.resolve(require$$1.join(projectPath.projectPath(), "scripts", "ripgrep_launcher.cjs"));
   return new Promise((resolve2, reject) => {
     const child = spawn.spawn("node", [RUNNER_PATH, JSON.stringify(args)], {
       stdio: ["pipe", "pipe", "pipe"],
@@ -43,7 +43,7 @@ function run$1(args, options) {
 function getBinaryPath() {
   const platformName = os.platform();
   const binaryName = platformName === "win32" ? "difft.exe" : "difft";
-  return path.resolve(path.join(projectPath.projectPath(), "tools", "unpacked", binaryName));
+  return require$$1.resolve(require$$1.join(projectPath.projectPath(), "tools", "unpacked", binaryName));
 }
 function run(args, options) {
   const binaryPath = getBinaryPath();
@@ -80,9 +80,9 @@ function run(args, options) {
 }
 
 function validatePath(targetPath, workingDirectory) {
-  const resolvedTarget = path.resolve(workingDirectory, targetPath);
-  const resolvedWorkingDir = path.resolve(workingDirectory);
-  if (!resolvedTarget.startsWith(resolvedWorkingDir + path.sep) && resolvedTarget !== resolvedWorkingDir) {
+  const resolvedTarget = require$$1.resolve(workingDirectory, targetPath);
+  const resolvedWorkingDir = require$$1.resolve(workingDirectory);
+  if (!resolvedTarget.startsWith(resolvedWorkingDir + require$$1.sep) && resolvedTarget !== resolvedWorkingDir) {
     return {
       valid: false,
       resolvedPath: resolvedTarget,
@@ -155,9 +155,9 @@ function createUploadFileHandlers(happyHomeDir, now = Date.now, pathQuoteStyle =
     const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
     await Promise.all(entries.map(async (entry) => {
       if (!entry.isFile() || !/^\..+\.[A-Za-z0-9_-]{8,80}\.part$/.test(entry.name)) return;
-      const path$1 = path.join(dir, entry.name);
-      const fileStat = await fs.stat(path$1).catch(() => null);
-      if (fileStat && fileStat.mtimeMs < cutoff) await fs.unlink(path$1).catch(() => {
+      const path = require$$1.join(dir, entry.name);
+      const fileStat = await fs.stat(path).catch(() => null);
+      if (fileStat && fileStat.mtimeMs < cutoff) await fs.unlink(path).catch(() => {
       });
     }));
   };
@@ -165,12 +165,12 @@ function createUploadFileHandlers(happyHomeDir, now = Date.now, pathQuoteStyle =
     let tempPath = null;
     try {
       const buffer = decodeUploadBase64(data.content, MAX_USER_UPLOAD_BYTES);
-      const dir = path.join(happyHomeDir, "uploads", safeSegment(data.subdir, "misc", 80));
+      const dir = require$$1.join(happyHomeDir, "uploads", safeSegment(data.subdir, "misc", 80));
       await fs.mkdir(dir, { recursive: true });
       const name = safeFileName(data.name);
-      const token = crypto.randomUUID().replace(/-/g, "").slice(0, 12);
-      const target = path.join(dir, uniqueFileName(name, token));
-      tempPath = path.join(dir, `.${name}.legacy_${crypto.randomUUID().replace(/-/g, "")}.part`);
+      const token = require$$3.randomUUID().replace(/-/g, "").slice(0, 12);
+      const target = require$$1.join(dir, uniqueFileName(name, token));
+      tempPath = require$$1.join(dir, `.${name}.legacy_${require$$3.randomUUID().replace(/-/g, "")}.part`);
       await fs.writeFile(tempPath, buffer, { flag: "wx" });
       await fs.rename(tempPath, target);
       tempPath = null;
@@ -191,12 +191,12 @@ function createUploadFileHandlers(happyHomeDir, now = Date.now, pathQuoteStyle =
         }
         if (active.has(uploadId)) throw new Error("Upload id is already active");
         if (active.size >= MAX_ACTIVE_UPLOADS) throw new Error("Too many active uploads");
-        const dir = path.join(happyHomeDir, "uploads", safeSegment(data.subdir, "misc", 80));
+        const dir = require$$1.join(happyHomeDir, "uploads", safeSegment(data.subdir, "misc", 80));
         await fs.mkdir(dir, { recursive: true });
         await sweepExpiredFiles(dir);
         const name = safeFileName(data.name);
-        const targetPath = path.join(dir, uniqueFileName(name, crypto.randomUUID().replace(/-/g, "").slice(0, 12)));
-        const tempPath = path.join(dir, `.${name}.${uploadId}.part`);
+        const targetPath = require$$1.join(dir, uniqueFileName(name, require$$3.randomUUID().replace(/-/g, "").slice(0, 12)));
+        const tempPath = require$$1.join(dir, `.${name}.${uploadId}.part`);
         await fs.writeFile(tempPath, Buffer.alloc(0), { flag: "wx" });
         active.set(uploadId, { tempPath, targetPath, totalSize: data.totalSize, received: 0, touchedAt: now() });
         return { success: true, size: 0 };
@@ -333,7 +333,7 @@ function registerCommonHandlers(rpcHandlerManager, workingDirectory) {
       if (data.expectedHash !== null && data.expectedHash !== void 0) {
         try {
           const existingBuffer = await fs.readFile(validation.resolvedPath);
-          const existingHash = crypto.createHash("sha256").update(existingBuffer).digest("hex");
+          const existingHash = require$$3.createHash("sha256").update(existingBuffer).digest("hex");
           if (existingHash !== data.expectedHash) {
             return {
               success: false,
@@ -366,7 +366,7 @@ function registerCommonHandlers(rpcHandlerManager, workingDirectory) {
       }
       const buffer = Buffer.from(data.content, "base64");
       await fs.writeFile(validation.resolvedPath, buffer);
-      const hash = crypto.createHash("sha256").update(buffer).digest("hex");
+      const hash = require$$3.createHash("sha256").update(buffer).digest("hex");
       return { success: true, hash };
     } catch (error) {
       logger.logger.debug("Failed to write file:", error);
@@ -387,7 +387,7 @@ function registerCommonHandlers(rpcHandlerManager, workingDirectory) {
       const entries = await fs.readdir(directoryPath, { withFileTypes: true });
       const directoryEntries = await Promise.all(
         entries.map(async (entry) => {
-          const fullPath = path.join(directoryPath, entry.name);
+          const fullPath = require$$1.join(directoryPath, entry.name);
           let type = "other";
           let size;
           let modified;
@@ -428,26 +428,26 @@ function registerCommonHandlers(rpcHandlerManager, workingDirectory) {
     if (!validation.valid) {
       return { success: false, error: validation.error };
     }
-    async function buildTree(path$1, name, currentDepth) {
+    async function buildTree(path, name, currentDepth) {
       try {
-        const stats = await fs.stat(path$1);
+        const stats = await fs.stat(path);
         const node = {
           name,
-          path: path$1,
+          path,
           type: stats.isDirectory() ? "directory" : "file",
           size: stats.size,
           modified: stats.mtime.getTime()
         };
         if (stats.isDirectory() && currentDepth < data.maxDepth) {
-          const entries = await fs.readdir(path$1, { withFileTypes: true });
+          const entries = await fs.readdir(path, { withFileTypes: true });
           const children = [];
           await Promise.all(
             entries.map(async (entry) => {
               if (entry.isSymbolicLink()) {
-                logger.logger.debug(`Skipping symlink: ${path.join(path$1, entry.name)}`);
+                logger.logger.debug(`Skipping symlink: ${require$$1.join(path, entry.name)}`);
                 return;
               }
-              const childPath = path.join(path$1, entry.name);
+              const childPath = require$$1.join(path, entry.name);
               const childNode = await buildTree(childPath, entry.name, currentDepth + 1);
               if (childNode) {
                 children.push(childNode);
@@ -463,7 +463,7 @@ function registerCommonHandlers(rpcHandlerManager, workingDirectory) {
         }
         return node;
       } catch (error) {
-        logger.logger.debug(`Failed to process ${path$1}:`, error instanceof Error ? error.message : String(error));
+        logger.logger.debug(`Failed to process ${path}:`, error instanceof Error ? error.message : String(error));
         return null;
       }
     }

package/dist/{registerCommonHandlers-CvIedVRf.mjs → registerCommonHandlers-CTkCvjxt.mjs}

@@ -1,4 +1,4 @@
-import { l as logger } from './logger--vAVtXB_.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
 import { spawn as spawn$1, exec } from 'child_process';
 import { promisify } from 'util';
 import { mkdir, writeFile, appendFile, stat, rename, unlink, readdir, readFile } from 'fs/promises';
@@ -7,7 +7,7 @@ import { resolve, join, sep } from 'path';
 import { spawn } from 'cross-spawn';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
 import { platform } from 'os';
-import { c as configuration } from './configuration-DVrb61aY.mjs';
+import { c as configuration } from './configuration-PxzEJumr.mjs';
 
 function run$1(args, options) {
   const RUNNER_PATH = resolve(join(projectPath(), "scripts", "ripgrep_launcher.cjs"));

package/dist/{registerKillSessionHandler-DYl7l4Ts.cjs → registerKillSessionHandler-CIsvBrVe.cjs}

@@ -1,19 +1,19 @@
 'use strict';
 
-var logger = require('./logger-DXTWlPzP.cjs');
+var logger = require('./logger-CphW5nUE.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');
-require('./attachmentLimits-SqeAHrVC.cjs');
+require('./pushNotifications-DI92havG.cjs');
 require('node:crypto');
 require('tweetnacl');
-require('./configuration-4TGMrjul.cjs');
-require('./index-_l1Sdmbi.cjs');
-require('./registerCommonHandlers-C0_fyBQ0.cjs');
+require('./configuration-CYO-kPOS.cjs');
+require('./index-Dv0Q48P3.cjs');
+require('./registerCommonHandlers-C7a_dUWs.cjs');
 require('os');
 require('child_process');
 require('@paralleldrive/cuid2');
-require('./persistence-BfX72dne.cjs');
+require('./persistence-9BMYspxG.cjs');
 require('chalk');
 require('./types-CRS-srZK.cjs');
 

package/dist/{registerKillSessionHandler-gwJ5lTf0.mjs → registerKillSessionHandler-CaqqRYq6.mjs}

@@ -1,17 +1,17 @@
-import { l as logger } from './logger--vAVtXB_.mjs';
+import { l as logger } from './logger-BUngm5Xg.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';
-import './attachmentLimits-UyFn8fkQ.mjs';
+import './pushNotifications-DCiBEVeC.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './configuration-DVrb61aY.mjs';
-import './index-Clqlu17M.mjs';
-import './registerCommonHandlers-CvIedVRf.mjs';
+import './configuration-PxzEJumr.mjs';
+import './index-C6Vn5Eac.mjs';
+import './registerCommonHandlers-CTkCvjxt.mjs';
 import 'os';
 import 'child_process';
 import '@paralleldrive/cuid2';
-import './persistence-DTk4sNpd.mjs';
+import './persistence-BFUOHW5h.mjs';
 import 'chalk';
 import './types-CkqAACXx.mjs';
 

package/dist/{remoteSessionClient-BRTIOX5b.cjs → remoteSessionClient-D843fkzL.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
-var controlClient = require('./controlClient-BTaZlbC6.cjs');
-var sessionOps = require('./sessionOps-BAnr7n8t.cjs');
-var time = require('./time-A6zR3Iy6.cjs');
+var controlClient = require('./controlClient-Bqv5v5OM.cjs');
+var sessionOps = require('./sessionOps-BrGiU9-s.cjs');
+var time = require('./time-Cjv0zxQO.cjs');
 var axios = require('axios');
 var os = require('node:os');
-var configuration = require('./configuration-4TGMrjul.cjs');
-var persistence = require('./persistence-BfX72dne.cjs');
+var configuration = require('./configuration-CYO-kPOS.cjs');
+var persistence = require('./persistence-9BMYspxG.cjs');
 var node_crypto = require('node:crypto');
 
 const ACTIVE_FRESH_WINDOW_MS = 15 * 60 * 1e3;

package/dist/{remoteSessionClient-DRb2Jr5s.mjs → remoteSessionClient-PP-mOKmw.mjs}

@@ -1,10 +1,10 @@
-import { h as resumeDaemonSession, l as listDaemonSessions } from './controlClient-BYKyGyxj.mjs';
-import { d as archiveSession, u as unarchiveSession, h as sessionLiveness, e as sendUserMessage, i as readSessionState, o as openUserScopedSocket } from './sessionOps-BVoXe12O.mjs';
-import { d as delay } from './time-BuGWTVP6.mjs';
+import { h as resumeDaemonSession, l as listDaemonSessions } from './controlClient-DoeYovwP.mjs';
+import { d as archiveSession, u as unarchiveSession, h as sessionLiveness, e as sendUserMessage, i as readSessionState, o as openUserScopedSocket } from './sessionOps-C58iDeD5.mjs';
+import { d as delay } from './time-D3ETL7Jb.mjs';
 import axios from 'axios';
 import { hostname } from 'node:os';
-import { c as configuration } from './configuration-DVrb61aY.mjs';
-import { r as readSettings, c as readCredentialsForConfiguredRelay } from './persistence-DTk4sNpd.mjs';
+import { c as configuration } from './configuration-PxzEJumr.mjs';
+import { r as readSettings, b as readCredentialsForConfiguredRelay } from './persistence-BFUOHW5h.mjs';
 import { randomUUID } from 'node:crypto';
 
 const ACTIVE_FRESH_WINDOW_MS = 15 * 60 * 1e3;

package/dist/{reportProgressTool-B9nCzbkL.cjs → reportProgressTool-14AXr959.cjs}

@@ -1,9 +1,11 @@
 'use strict';
 
 var z = require('zod');
-var index = require('./index-_l1Sdmbi.cjs');
-var client = require('./client-C4zKGjiJ.cjs');
+var index = require('./index-Dv0Q48P3.cjs');
+var client = require('./client-BWjaHKtj.cjs');
 var precheckCompat = require('./precheckCompat-CWOi5c9L.cjs');
+var client$1 = require('./client-DJplzPjD.cjs');
+var prompt = require('./prompt-lgF9IE82.cjs');
 var agentGuidance = require('./agentGuidance-BtBx2xxE.cjs');
 
 const AUTOMATION_TOOL_NAMES = [
@@ -183,6 +185,83 @@ function registerAutomationTools(server, execute = createAutomationToolExecutor(
   }
 }
 
+const PROJECT_TOOL_NAMES = ["project_context", "project_note"];
+const PROJECT_TOOL_SCHEMAS = {
+  project_context: {
+    title: "Read Project Context",
+    readOnly: true,
+    description: `Read this session's Very Happy project: instructions, decisions in effect, recent log entries, other sessions and unread messages. By default returns only what changed since you last read it (\u22642KB); full=true returns everything. Returns "not in a project" when the session has no project.`,
+    inputSchema: {
+      section: z.z.enum(["instructions", "log", "sessions", "messages"]).optional().describe("Only this part"),
+      full: z.z.boolean().optional().describe("Everything, not just changes since your last read")
+    }
+  },
+  project_note: {
+    title: "Write Project Note",
+    readOnly: false,
+    description: 'Append to the project log what other sessions will need: kind "decision" (changes how they work), "finding" (they would otherwise redo it) or "handoff" (when you stop). Not progress. Takes effect immediately; the user can revoke it. To change an entry, write a new one with supersedes; revoke=true with supersedes withdraws your own entry.',
+    inputSchema: {
+      kind: z.z.enum(["decision", "finding", "handoff"]).describe("decision | finding | handoff"),
+      title: z.z.string().min(1).max(200).describe("One line"),
+      body: z.z.string().max(4e3).optional().describe("Details (\u22644KB)"),
+      supersedes: z.z.string().min(1).max(128).optional().describe('Entry it replaces: "#12" or its id'),
+      revoke: z.z.boolean().optional().describe("With supersedes: withdraw that entry (only your own) instead of writing a new one")
+    }
+  }
+};
+function describeError(error) {
+  if (error instanceof client$1.ProjectsUnsupportedError) return "This Very Happy server does not support projects yet.";
+  if (error instanceof client$1.ProjectRequestError) {
+    if (error.code === "project_note_quota_exceeded" && typeof error.details.suggestion === "string") return error.details.suggestion;
+    if (error.code === "not_a_project_member") return "not in a project";
+    if (error.code) return `Project request failed: ${error.code}`;
+    return "Project request failed";
+  }
+  return error instanceof Error && error.message ? error.message : "Project request failed";
+}
+function createProjectToolExecutor(sessionId, client = client$1.sharedProjectsClient()) {
+  return async (name, args) => {
+    const sid = sessionId();
+    if (name === "project_context") {
+      const full = args?.full === true;
+      const ctx = await client.context(sid, { full });
+      return { text: prompt.formatContextForTool(ctx, { full, section: typeof args?.section === "string" ? args.section : void 0 }) };
+    }
+    const membership = await client.membership(sid);
+    if (!membership.projectId) return { text: "not in a project" };
+    if (args?.revoke) {
+      if (!args?.supersedes) throw new Error("revoke needs supersedes (the entry to withdraw)");
+      const { entry: entry2 } = await client.revoke(membership.projectId, String(args.supersedes), sid);
+      return { text: `revoked #${entry2.seq}` };
+    }
+    const { entry } = await client.note(membership.projectId, {
+      kind: String(args?.kind),
+      title: String(args?.title ?? ""),
+      authorSessionId: sid,
+      ...typeof args?.body === "string" && args.body ? { body: args.body } : {},
+      ...typeof args?.supersedes === "string" ? { supersedes: args.supersedes } : {}
+    });
+    return { text: `recorded #${entry.seq}${entry.supersedes ? " (supersedes an earlier entry)" : ""}` };
+  };
+}
+function registerProjectTools(server, execute) {
+  for (const name of PROJECT_TOOL_NAMES) {
+    const spec = PROJECT_TOOL_SCHEMAS[name];
+    server.registerTool(name, {
+      description: spec.description,
+      title: spec.title,
+      inputSchema: spec.inputSchema,
+      annotations: { readOnlyHint: spec.readOnly, idempotentHint: spec.readOnly, openWorldHint: false, destructiveHint: false }
+    }, async (args) => {
+      try {
+        return { content: [{ type: "text", text: (await execute(name, args ?? {})).text }], isError: false };
+      } catch (error) {
+        return { content: [{ type: "text", text: describeError(error) }], isError: true };
+      }
+    });
+  }
+}
+
 const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
 const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
 const ATTENTION_VALUES = ["none", "review", "blocked"];
@@ -234,11 +313,14 @@ function registerReportProgressTool(server, execute) {
 }
 
 exports.AUTOMATION_TOOL_NAMES = AUTOMATION_TOOL_NAMES;
+exports.PROJECT_TOOL_NAMES = PROJECT_TOOL_NAMES;
+exports.createProjectToolExecutor = createProjectToolExecutor;
 exports.createSelfReportState = createSelfReportState;
 exports.isSelfReportFresh = isSelfReportFresh;
 exports.normalizeAttention = normalizeAttention;
 exports.normalizePhase = normalizePhase;
 exports.normalizeProgress = normalizeProgress;
 exports.registerAutomationTools = registerAutomationTools;
+exports.registerProjectTools = registerProjectTools;
 exports.registerReportProgressTool = registerReportProgressTool;
 exports.shouldAcceptSelfReport = shouldAcceptSelfReport;

package/dist/{reportProgressTool-D5tEoXMW.mjs → reportProgressTool-ZOCNjWHr.mjs}

@@ -1,7 +1,9 @@
 import { z } from 'zod';
-import { h as AutomationNameSchema, b as AutomationPrecheckSchema, j as AutomationConcurrencySchema, k as AutomationActionSchema, l as AutomationTriggerSchema } from './index-Clqlu17M.mjs';
-import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv } from './client-CnlkkrZO.mjs';
+import { k as AutomationNameSchema, c as AutomationPrecheckSchema, l as AutomationConcurrencySchema, m as AutomationActionSchema, o as AutomationTriggerSchema } from './index-C6Vn5Eac.mjs';
+import { a as authenticatedAutomationsClient, b as automationRunIdFromEnv } from './client-CnB7kRCT.mjs';
 import { u as updateAutomationChecked, c as createAutomationChecked } from './precheckCompat-DeEbilbr.mjs';
+import { P as ProjectsUnsupportedError, a as ProjectRequestError, s as sharedProjectsClient } from './client-Ca5Pcgy_.mjs';
+import { f as formatContextForTool } from './prompt-BOouDaTM.mjs';
 import { R as REPORT_PROGRESS_TOOL_NAME, d as REPORT_PROGRESS_TOOL_TITLE, e as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-BDYt2Qy2.mjs';
 
 const AUTOMATION_TOOL_NAMES = [
@@ -181,6 +183,83 @@ function registerAutomationTools(server, execute = createAutomationToolExecutor(
   }
 }
 
+const PROJECT_TOOL_NAMES = ["project_context", "project_note"];
+const PROJECT_TOOL_SCHEMAS = {
+  project_context: {
+    title: "Read Project Context",
+    readOnly: true,
+    description: `Read this session's Very Happy project: instructions, decisions in effect, recent log entries, other sessions and unread messages. By default returns only what changed since you last read it (\u22642KB); full=true returns everything. Returns "not in a project" when the session has no project.`,
+    inputSchema: {
+      section: z.enum(["instructions", "log", "sessions", "messages"]).optional().describe("Only this part"),
+      full: z.boolean().optional().describe("Everything, not just changes since your last read")
+    }
+  },
+  project_note: {
+    title: "Write Project Note",
+    readOnly: false,
+    description: 'Append to the project log what other sessions will need: kind "decision" (changes how they work), "finding" (they would otherwise redo it) or "handoff" (when you stop). Not progress. Takes effect immediately; the user can revoke it. To change an entry, write a new one with supersedes; revoke=true with supersedes withdraws your own entry.',
+    inputSchema: {
+      kind: z.enum(["decision", "finding", "handoff"]).describe("decision | finding | handoff"),
+      title: z.string().min(1).max(200).describe("One line"),
+      body: z.string().max(4e3).optional().describe("Details (\u22644KB)"),
+      supersedes: z.string().min(1).max(128).optional().describe('Entry it replaces: "#12" or its id'),
+      revoke: z.boolean().optional().describe("With supersedes: withdraw that entry (only your own) instead of writing a new one")
+    }
+  }
+};
+function describeError(error) {
+  if (error instanceof ProjectsUnsupportedError) return "This Very Happy server does not support projects yet.";
+  if (error instanceof ProjectRequestError) {
+    if (error.code === "project_note_quota_exceeded" && typeof error.details.suggestion === "string") return error.details.suggestion;
+    if (error.code === "not_a_project_member") return "not in a project";
+    if (error.code) return `Project request failed: ${error.code}`;
+    return "Project request failed";
+  }
+  return error instanceof Error && error.message ? error.message : "Project request failed";
+}
+function createProjectToolExecutor(sessionId, client = sharedProjectsClient()) {
+  return async (name, args) => {
+    const sid = sessionId();
+    if (name === "project_context") {
+      const full = args?.full === true;
+      const ctx = await client.context(sid, { full });
+      return { text: formatContextForTool(ctx, { full, section: typeof args?.section === "string" ? args.section : void 0 }) };
+    }
+    const membership = await client.membership(sid);
+    if (!membership.projectId) return { text: "not in a project" };
+    if (args?.revoke) {
+      if (!args?.supersedes) throw new Error("revoke needs supersedes (the entry to withdraw)");
+      const { entry: entry2 } = await client.revoke(membership.projectId, String(args.supersedes), sid);
+      return { text: `revoked #${entry2.seq}` };
+    }
+    const { entry } = await client.note(membership.projectId, {
+      kind: String(args?.kind),
+      title: String(args?.title ?? ""),
+      authorSessionId: sid,
+      ...typeof args?.body === "string" && args.body ? { body: args.body } : {},
+      ...typeof args?.supersedes === "string" ? { supersedes: args.supersedes } : {}
+    });
+    return { text: `recorded #${entry.seq}${entry.supersedes ? " (supersedes an earlier entry)" : ""}` };
+  };
+}
+function registerProjectTools(server, execute) {
+  for (const name of PROJECT_TOOL_NAMES) {
+    const spec = PROJECT_TOOL_SCHEMAS[name];
+    server.registerTool(name, {
+      description: spec.description,
+      title: spec.title,
+      inputSchema: spec.inputSchema,
+      annotations: { readOnlyHint: spec.readOnly, idempotentHint: spec.readOnly, openWorldHint: false, destructiveHint: false }
+    }, async (args) => {
+      try {
+        return { content: [{ type: "text", text: (await execute(name, args ?? {})).text }], isError: false };
+      } catch (error) {
+        return { content: [{ type: "text", text: describeError(error) }], isError: true };
+      }
+    });
+  }
+}
+
 const SELF_REPORT_MIN_INTERVAL_MS = 30 * 1e3;
 const SELF_REPORT_FRESH_MS = 15 * 60 * 1e3;
 const ATTENTION_VALUES = ["none", "review", "blocked"];
@@ -231,4 +310,4 @@ function registerReportProgressTool(server, execute) {
   });
 }
 
-export { AUTOMATION_TOOL_NAMES as A, registerReportProgressTool as a, normalizePhase as b, createSelfReportState as c, normalizeProgress as d, isSelfReportFresh as i, normalizeAttention as n, registerAutomationTools as r, shouldAcceptSelfReport as s };
+export { AUTOMATION_TOOL_NAMES as A, PROJECT_TOOL_NAMES as P, registerProjectTools as a, registerReportProgressTool as b, createSelfReportState as c, createProjectToolExecutor as d, normalizePhase as e, normalizeProgress as f, isSelfReportFresh as i, normalizeAttention as n, registerAutomationTools as r, shouldAcceptSelfReport as s };

package/dist/{resources-JDPugcDq.cjs → resources-CvIlkzpP.cjs}

@@ -53,6 +53,36 @@ export default async function(pi) {
       });
     }
   }
+  const steerEndpoint = managed && process.env.HAPPY_PI_STEER_URL;
+  if (steerEndpoint && pi.sendUserMessage) {
+    // B-632: \u300CSteer\u300D from the web \u2014 taken from the wrapper's long poll while pi runs,
+    // handed to pi as a steer, acknowledged (agent/acp/piSteerChannel.ts).
+    const target = new URL(steerEndpoint);
+    if (target.origin !== url.origin || !target.pathname.startsWith('/runtime-steer/')) throw new Error('Very Happy steer must be local');
+    const post = (suffix, body) => fetch(steerEndpoint + suffix, {method:'POST', redirect:'error', headers:{'content-type':'application/json'}, body:JSON.stringify(body || {}), signal:AbortSignal.timeout(2000)}).catch(() => {});
+    let running = false, polling = false;
+    const poll = async () => {
+      if (polling) return;
+      polling = true;
+      try {
+        while (running) {
+          let item = null;
+          try {
+            const response = await fetch(steerEndpoint, {redirect:'error', signal:AbortSignal.timeout(30000)});
+            if (response.status === 200) item = await response.json();
+            else if (response.status !== 204) await new Promise(r => setTimeout(r, 1000));
+          } catch { await new Promise(r => setTimeout(r, 1000)); continue; }
+          if (!item || typeof item.text !== 'string') continue;
+          if (!running) { await post('/ack', {id:item.id, delivered:false}); continue; }
+          try { pi.sendUserMessage(item.text, {deliverAs:'steer'}); await post('/ack', {id:item.id, delivered:true}); }
+          catch { await post('/ack', {id:item.id, delivered:false}); }
+        }
+      } finally { polling = false; }
+    };
+    pi.on('agent_start', async () => { running = true; void poll(); });
+    pi.on('agent_end', async () => { running = false; });
+    await post('/hello');
+  }
   if (managed) pi.on('tool_call', async (event, ctx) => {
     let mode = process.env.HAPPY_PERMISSION_MODE || 'default';
     const sid = process.env.HAPPY_SESSION_ID;