very-happy-cli 0.2.125 → 0.2.127

package/dist/{index-Do-kjc30.cjs → index-DgjzHewW.cjs}

@@ -3,13 +3,13 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var api = require('./types-BGHnQXl5.cjs');
-var persistence = require('./limits-DViGHwSj.cjs');
+var api = require('./types-BuxqyzYf.cjs');
+var persistence = require('./limits-BDG3QjIB.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-Cg9ZG1pP.cjs');
+var agentGuidance = require('./agentGuidance-B-CazXmT.cjs');
 var promises = require('node:fs/promises');
 var fs = require('fs/promises');
 var ink = require('ink');
@@ -669,7 +669,7 @@ function shouldIncludeCoAuthoredBy() {
 
 const BASE_SYSTEM_PROMPT = (() => agentGuidance.trimIdent(`
     ALWAYS when you start a new chat - you must call a tool "mcp__happy__change_title" to set a chat title. When you think chat title is not relevant anymore - call the tool again to change it. When chat name is too generic and you have a change to make it more specific - call the tool again to change it. This title is needed to easily find the chat in the future. Help human.
-`))() + "\n\n" + agentGuidance.AGENT_GUIDANCE;
+`))() + "\n\n" + agentGuidance.AGENT_GUIDANCE + "\n\n" + api.BUILTIN_TODO_DISCOVERY;
 const CO_AUTHORED_CREDITS = (() => agentGuidance.trimIdent(`
     When making commit messages, instead of just giving co-credit to Claude, also give credit to Happy like so:
 
@@ -5853,7 +5853,8 @@ async function sendUserMessage(sessionId, persisted, text, client, options = {})
       text
     },
     meta: {
-      sentFrom: options.sentFrom ?? "cli"
+      sentFrom: options.sentFrom ?? "cli",
+      ...options.model ? { model: options.model } : {}
     }
   };
   const encrypted = persistence.encodeBase64(persistence.encrypt(
@@ -7675,7 +7676,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-Do-kjc30.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-DgjzHewW.cjs', document.baseURI).href))).resolve(s)) {
   const platformArch = `${platform}-${arch}`;
   const candidates = [
     `@anthropic-ai/claude-agent-sdk-${platformArch}/claude`,
@@ -8822,6 +8823,100 @@ async function claimSessionOrExit(happySessionId, options) {
   process.on("exit", () => releaseSessionLock(happySessionId));
 }
 
+const TEAM_SKILL = `---
+name: very-happy-teams
+description: Coordinate coding agents through Very Happy teams: delegate tasks, exchange messages, review results, and recover interrupted work. Use when asked to organize or participate in an agent team.
+---
+
+# Very Happy Agent Teams
+
+Use the team_* tools in a managed Very Happy session. If absent, explain that this host needs Very Happy Teams setup; reading this skill alone does not establish a connection.
+
+Start with team_inspect if already assigned. Otherwise team_create or team_join connects the current session. A scoped worker cannot create another root identity or use account-wide tools to bypass its scope.
+
+Work yourself when delegation would add needless overhead. Delegate independent work with a clear goal and acceptance criteria. When delegating within your assignment, pass its parentTaskId. Members may delegate further within their existing authority. After delegating child work, wait for those results instead of continuing parallel edits yourself. Waiting parents yield their execution slot to their children; the team limit counts progressing leaf assignments, not OS processes.
+
+Name exactly one integrator for each team. Workers edit only their assigned worktrees; they must not merge main, publish releases, change global daemon or npm installations, or allocate shared backlog IDs. The integrator serializes these operations. Across teams, the owner coordinates shared resources: a worktree is not a global lock.
+
+Use a unique requestId for each action and reuse it with identical arguments when the outcome is unknown. Inspect state before retrying; a timeout does not prove no action occurred. A delivered message is not proof its recipient processed it.
+
+Inspect the current attemptId and goalVersion before team_submit. Include artifact locations and verification evidence. The owner reviews and accepts or returns the result. All children completing does not automatically satisfy the parent goal.
+
+Acceptance and cleanup are separate. Never delete dirty worktrees, stop user-owned sessions, or bypass permissions to finish cleanup. Use team_cancel or team_handoff and inspect the resulting status. Keep summaries concise; do not repeatedly forward full descendant transcripts.
+
+A root member may create a persistent schedule for itself with the schedule tools; team_inspect shows schedules. Timely delivery requires an online daemon. A scheduled delivery does not prove the model completed the work. Pause or cancel schedules explicitly when they are no longer needed.
+
+On restart inspect authoritative state and messages before taking new actions. Do not invent completed work from a previous context. Scope credentials are runtime-owned; never read, print, or copy them into prompts.
+`;
+const PI_TEAMS_EXTENSION = `// Managed by Very Happy Agent Teams.
+export default async function(pi) {
+  const endpoint = process.env.HAPPY_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');
+  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)) {
+      try { mode = JSON.parse(await readFile(join(process.env.HAPPY_HOME_DIR || join(homedir(), '.happy'), 'session-modes', sid + '.json'), 'utf8')).permissionMode; }
+      catch (error) { if (error.code !== 'ENOENT') mode = 'default'; }
+    }
+    if (mode === 'yolo') mode = 'bypassPermissions';
+    if (!['default','plan','acceptEdits','bypassPermissions'].includes(mode)) mode = 'default';
+    if (mode === 'bypassPermissions') return;
+    if (['read','ls','find','grep','team_inspect','change_title','report_progress'].includes(event.toolName)) return;
+    if (mode === 'plan') return {block:true,reason:'Plan mode allows read-only tools'};
+    if (mode === 'acceptEdits' && ['write','edit'].includes(event.toolName)) return;
+    try {
+      const allowed = await ctx.ui.confirm('Allow ' + event.toolName + '?', JSON.stringify(event.input || {}).slice(0,4000));
+      if (allowed === true) return;
+    } catch {}
+    return {block:true,reason:'Tool requires explicit approval'};
+  });
+  let nextId = 0;
+  async function rpc(method, params) {
+    const requestId = ++nextId;
+    const response = await fetch(endpoint, { method: 'POST', redirect: 'error', headers: {'content-type':'application/json', accept:'application/json, text/event-stream'}, body: JSON.stringify({jsonrpc:'2.0',id:requestId,method,params}), signal: AbortSignal.timeout(30000) });
+    if (!response.ok) throw new Error('Very Happy tools unavailable (HTTP ' + response.status + ')');
+    const body = await response.text();
+    let data;
+    if ((response.headers.get('content-type') || '').includes('text/event-stream')) {
+      for (const event of body.split(/\\r?\\n\\r?\\n/)) {
+        const payload = event.split(/\\r?\\n/).filter(line => line.startsWith('data:')).map(line => line.slice(5).trimStart()).join('\\n');
+        if (payload) { const candidate = JSON.parse(payload); if (candidate.id === requestId) data = candidate; }
+      }
+    } else data = JSON.parse(body);
+    if (!data || data.error) throw new Error('Very Happy tool request failed');
+    return data.result;
+  }
+  await rpc('initialize', {protocolVersion:'2024-11-05',capabilities:{},clientInfo:{name:'very-happy-pi-teams',version:'1'}});
+  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}}; }
+    });
+  }
+}
+`;
+
+function teamInitialPrompt(goal, root, directory) {
+  const role = root ? "You are the team lead. Inspect your assigned goal, arrange independent work when useful, review member results, integrate changes, and submit the final result for the user to accept. Delegate under your assigned goal using parentTaskId. You must not accept your own root goal." : "You are a team member. Inspect your assigned task and work in your assigned worktree. Delegate within your task when useful, then submit evidence for the lead to review.";
+  return `${TEAM_SKILL}
+
+## Your role
+${role}
+
+## Working directory
+${directory ? JSON.stringify(directory) : "Use your current managed session working directory."}
+Delegate from this working directory unless a different repository was explicitly requested.
+
+## Assigned goal
+${goal}`;
+}
+
 const MAX_LINE_CHARS = 500;
 const MAX_ARGS_CHARS = 160;
 function truncateText(text, max = MAX_LINE_CHARS) {
@@ -9403,7 +9498,7 @@ function createTeamWorker(deps) {
   let knownSessionIds = /* @__PURE__ */ new Set();
   const action = async (teamId, requestId, value) => (await http.post(`/v1/teams/${encodeURIComponent(teamId)}/actions`, { requestId, action: value })).data;
   async function complete(op, receipt) {
-    await action(op.teamId, `complete-${op.id}`, { type: "complete-operation", operationId: op.id, machineId: deps.machineId, claimId: receipt.claimId, ...receipt.sessionId ? { sessionId: receipt.sessionId } : {} });
+    await action(op.teamId, `complete-${op.id}`, { type: "complete-operation", operationId: op.id, machineId: deps.machineId, claimId: receipt.claimId, ...receipt.sessionId ? { sessionId: receipt.sessionId } : {}, ...op.type === "spawn" && receipt.directory ? { workingDirectory: receipt.directory } : {} });
     writeReceipt(home, { ...receipt, phase: "completed" });
   }
   async function execute(op) {
@@ -9416,7 +9511,7 @@ function createTeamWorker(deps) {
         }
         return;
       }
-      const claimed = await action(op.teamId, `claim-${op.id}`, { type: "claim-operation", operationId: op.id, machineId: deps.machineId });
+      const claimed = await action(op.teamId, `claim-${op.id}`, { type: "claim-operation", operationId: op.id, machineId: deps.machineId, ...op.teamLaunchVersion === 1 ? { teamLaunchVersion: 1 } : {} });
       if (!claimed.operation?.claimId) throw new Error("Operation claim did not return a receipt");
       op = claimed.operation;
       credential = claimed.credential;
@@ -9427,7 +9522,7 @@ function createTeamWorker(deps) {
     try {
       if (op.type === "spawn") {
         if (receipt.phase === "prepared") {
-          if (!credential) credential = (await action(op.teamId, `claim-${op.id}`, { type: "claim-operation", operationId: op.id, machineId: deps.machineId })).credential;
+          if (!credential) credential = (await action(op.teamId, `claim-${op.id}`, { type: "claim-operation", operationId: op.id, machineId: deps.machineId, ...op.teamLaunchVersion === 1 ? { teamLaunchVersion: 1 } : {} })).credential;
           if (!credential) throw new Error("No scoped credential for worker");
           const current = (await http.get(`/v1/teams/${encodeURIComponent(op.teamId)}`)).data.team;
           const task = current.tasks.find((t) => t.id === op.taskId);
@@ -9445,7 +9540,7 @@ function createTeamWorker(deps) {
           persistence.writePrivateFileSync(scopeFile, JSON.stringify({ serverUrl: server, scopeToken: credential.token, teamId: op.teamId, botId: op.botId, taskId: op.taskId, attemptId: op.attemptId }));
           receipt = { ...receipt, ...resource, scopeFile, phase: "spawning" };
           writeReceipt(home, receipt);
-          const spawned = await deps.spawn({ directory: resource.directory, agent: op.assistant === "pi-acp" ? "pi" : op.assistant, permissionMode: "default", spawnedBy: "teams", environmentVariables: { VH_TEAM_SCOPE_FILE: scopeFile, VH_TEAM_OPERATION_ID: op.id } });
+          const spawned = await deps.spawn({ directory: resource.directory, agent: op.assistant === "pi-acp" ? "pi" : op.assistant, permissionMode: op.permissionMode === "bypassPermissions" ? "bypassPermissions" : "default", spawnedBy: "teams", environmentVariables: { VH_TEAM_SCOPE_FILE: scopeFile, VH_TEAM_OPERATION_ID: op.id } });
           if (spawned.type !== "success") throw new Error(spawned.type === "error" ? spawned.errorMessage : "Directory approval required");
           receipt = { ...receipt, sessionId: spawned.sessionId, phase: "spawned" };
           writeReceipt(home, receipt);
@@ -9467,7 +9562,7 @@ function createTeamWorker(deps) {
             return;
           }
           const key = await waitForSessionKey(receipt.sessionId, 1e4);
-          await sendUserMessage(receipt.sessionId, key, op.prompt, "teams", { localId: `teams-initial-${op.id}`, sentFrom: "team" });
+          await sendUserMessage(receipt.sessionId, key, teamInitialPrompt(op.prompt, bot?.root === true, receipt.directory), "teams", { localId: `teams-initial-${op.id}`, sentFrom: "team", ...op.model ? { model: op.model } : {} });
           receipt = { ...receipt, phase: "delivered" };
           writeReceipt(home, receipt);
         }
@@ -9569,7 +9664,7 @@ Use the teams tools to inspect current task state before acting. This message is
         const status = axios.isAxiosError(error) ? error.response?.status : void 0;
         if (status !== 404) deps.log("Teams schedule advancement unavailable; regular reconciliation continues");
       }
-      const { data } = await http.get("/v1/teams/operations", { params: { machineId: deps.machineId, schedulesVersion: 1 } });
+      const { data } = await http.get("/v1/teams/operations", { params: { machineId: deps.machineId, schedulesVersion: 1, teamLaunchVersion: 1 } });
       knownSessionIds = new Set((data.teams ?? []).flatMap((team) => team.bots.flatMap((bot) => bot.sessionId ? [bot.sessionId] : [])));
       for (const op of data.operations) {
         if (closed) break;
@@ -9613,6 +9708,7 @@ const hostSuffix = process.env.HAPPY_VARIANT === "dev" ? "-dev" : "";
 const startupCliAvailability = api.detectCLIAvailability();
 const initialMachineMetadata = {
   teamsVersion: 1,
+  teamLaunchVersion: 1,
   host: os$1.hostname() + hostSuffix,
   platform: os$1.platform(),
   happyCliVersion: persistence.packageJson.version,
@@ -10883,7 +10979,8 @@ async function startDaemon() {
     });
     void apiMachine.updateMachineMetadata((current) => ({
       ...current ?? initialMachineMetadata,
-      teamsVersion: 1
+      teamsVersion: 1,
+      teamLaunchVersion: 1
     })).catch(() => persistence.logger.debug("[DAEMON RUN] Teams capability publication will retry on reconnect"));
     const cleanupAndShutdown = async (source, errorMessage) => {
       persistence.logger.debug(`[DAEMON RUN] Starting proper cleanup (source: ${source}, errorMessage: ${errorMessage})...`);
@@ -10922,6 +11019,113 @@ async function startDaemon() {
   }
 }
 
+const TEAMS_ADOPT_CAPABILITY = "teams-adopt-v1";
+const TeamAdoptSchema = z.z.object({
+  requestId: z.z.string().min(1).max(128),
+  name: z.z.string().trim().min(1).max(128),
+  teamId: z.z.string().min(1).max(128).optional()
+}).strict();
+async function retainIntent(path$1, input) {
+  await promises.mkdir(path.dirname(path$1), { recursive: true, mode: 448 });
+  let file;
+  try {
+    file = await promises.open(path$1, node_fs.constants.O_WRONLY | node_fs.constants.O_CREAT | node_fs.constants.O_EXCL, 384);
+  } catch (error) {
+    if (error.code !== "EEXIST") throw new Error("Cannot retain team connection request");
+  }
+  if (file) {
+    try {
+      await file.writeFile(JSON.stringify(input));
+      await file.sync();
+    } finally {
+      await file.close();
+    }
+    return { fresh: true };
+  }
+  const existing = await promises.open(path$1, node_fs.constants.O_RDONLY | (node_fs.constants.O_NOFOLLOW ?? 0));
+  try {
+    const stat = await existing.stat();
+    if (!stat.isFile() || process.platform !== "win32" && (stat.mode & 63) !== 0 || typeof process.getuid === "function" && stat.uid !== process.getuid()) throw new Error("Unsafe team connection receipt");
+    const stored = JSON.parse(await existing.readFile("utf8"));
+    const { resolvedTeamId, guidanceDelivered, ...request } = stored;
+    const previous = TeamAdoptSchema.parse(request);
+    if (JSON.stringify(previous) !== JSON.stringify(input)) throw new Error("Another team connection request already exists; retry the original request");
+    if (resolvedTeamId !== void 0 && (typeof resolvedTeamId !== "string" || !resolvedTeamId)) throw new Error("Invalid connection receipt");
+    if (guidanceDelivered !== void 0 && typeof guidanceDelivered !== "boolean") throw new Error("Invalid guidance receipt");
+    return { resolvedTeamId, guidanceDelivered };
+  } finally {
+    await existing.close();
+  }
+}
+async function retainTeam(path, input, resolvedTeamId, guidanceDelivered = false) {
+  const temporary = `${path}.${node_crypto.randomUUID()}.new`;
+  const file = await promises.open(temporary, "wx", 384);
+  try {
+    await file.writeFile(JSON.stringify({ ...input, resolvedTeamId, guidanceDelivered }));
+    await file.sync();
+  } finally {
+    await file.close();
+  }
+  try {
+    await promises.rename(temporary, path);
+  } finally {
+    await promises.unlink(temporary).catch(() => {
+    });
+  }
+}
+function createTeamAdoption(sessionId) {
+  const client = agentGuidance.createTeamsClient(sessionId);
+  let current;
+  return (raw) => {
+    const parsed = TeamAdoptSchema.safeParse(raw);
+    if (!parsed.success) return { error: "Invalid team connection request" };
+    if (process.env.VH_TEAM_SCOPE_FILE) return { error: "Assigned team members cannot create or join another team" };
+    let path;
+    try {
+      path = `${agentGuidance.teamScopePath(sessionId)}.adopt.json`;
+    } catch {
+      return { error: "A managed session identity is required" };
+    }
+    const input = parsed.data;
+    const signature = JSON.stringify(input);
+    if (current) {
+      if (current.signature !== signature && current.safeToChange) current = void 0;
+      else if (current.signature !== signature) return { error: "Another team connection request already exists; retry the original request" };
+    }
+    if (current) {
+      const result = current.result;
+      if (result && "error" in result) current = void 0;
+      return result ?? { status: "pending", requestId: input.requestId };
+    }
+    const operation = { signature };
+    current = operation;
+    void (async () => {
+      let intent;
+      try {
+        intent = await retainIntent(path, input);
+        const connected = await client.initialize(input, { resumeAdoption: true, expectedTeamId: intent.resolvedTeamId, onTeamResolved: (teamId) => retainTeam(path, input, teamId, intent?.guidanceDelivered) });
+        const instructions = `${TEAM_SKILL}
+
+This session is now connected as the team lead. Call team_inspect to read the authoritative state before continuing the user's goal. Do not call team_create or team_join again.`;
+        if (!intent.guidanceDelivered) {
+          const key = await waitForSessionKey(sessionId, 1e4);
+          await sendUserMessage(sessionId, key, instructions, "teams", { localId: `teams-adopt-${input.requestId}`, sentFrom: "team" });
+          await retainTeam(path, input, connected.team.id, true);
+        }
+        operation.result = { status: "connected", teamId: connected.team.id, botId: connected.botId, instructions };
+      } catch (error) {
+        if (error instanceof agentGuidance.TeamConnectionPreflightError && intent?.fresh && !intent.resolvedTeamId) {
+          await promises.unlink(path).catch(() => {
+          });
+          operation.safeToChange = true;
+        }
+        operation.result = { error: error instanceof Error ? error.message : "Team connection failed; retry the same request", ...operation.safeToChange ? { safeToChange: true } : {} };
+      }
+    })();
+    return { status: "pending", requestId: input.requestId };
+  };
+}
+
 const PERSONAL_MEMORY_SOFT_LIMIT_CHARS = 2e3;
 function headingTitle(line) {
   const m = /^##(?!#)\s*(.*?)\s*$/.exec(line);
@@ -11565,6 +11769,11 @@ async function startHappyServer(client, options) {
       resolve(new URL(`http://127.0.0.1:${addr.port}`));
     });
   });
+  const adoptionEnabled = !process.env.VH_TEAM_SCOPE_FILE;
+  if (adoptionEnabled) {
+    client.rpcHandlerManager.registerHandler("teams-adopt", createTeamAdoption(client.sessionId));
+    client.updateMetadata((metadata) => ({ ...metadata, capabilities: [.../* @__PURE__ */ new Set([...metadata.capabilities ?? [], TEAMS_ADOPT_CAPABILITY])] }));
+  }
   persistence.logger.debug(`[happyMCP] server:ready sessionId=${client.sessionId} url=${baseUrl.toString()}`);
   return {
     url: baseUrl.toString(),
@@ -11578,6 +11787,7 @@ async function startHappyServer(client, options) {
     ],
     stop: () => {
       persistence.logger.debug(`[happyMCP] server:stop sessionId=${client.sessionId}`);
+      if (adoptionEnabled) client.rpcHandlerManager.unregisterHandler("teams-adopt");
       server.close();
     }
   };
@@ -11834,7 +12044,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-D_Rm9dw9.cjs'); });
+    const { query } = await Promise.resolve().then(function () { return require('./index-DhCEmP3d.cjs'); });
     return runSideQuestion(query, input);
   });
   const slots = /* @__PURE__ */ new Map();
@@ -11936,7 +12146,7 @@ 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-Do-kjc30.cjs', document.baseURI).href)));
+    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-DgjzHewW.cjs', document.baseURI).href)));
     const utilsPath = path.resolve(path.join(api.projectPath(), "scripts", "claude_version_utils.cjs"));
     const { getClaudeCliPath } = require$1(utilsPath);
     const path$1 = getClaudeCliPath();
@@ -14154,9 +14364,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-Do-kjc30.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-DgjzHewW.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-Do-kjc30.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-DgjzHewW.cjs', document.baseURI).href)));
 const PRISMA_QUERY_ENGINE_FILES = {
   "arm64-darwin": "libquery_engine-darwin-arm64.dylib.node",
   "x64-darwin": "libquery_engine-darwin.dylib.node",
@@ -15895,6 +16105,7 @@ function buildCodexTurnPrompt(opts) {
   parts.push(opts.message);
   if (opts.includeTitleInstruction) {
     parts.push(CHANGE_TITLE_INSTRUCTION);
+    parts.push(api.BUILTIN_TODO_DISCOVERY);
   }
   return parts.join("\n\n");
 }
@@ -16787,7 +16998,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     process.exit(0);
   } else if (subcommand === "install-terminal-hooks") {
     try {
-      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-CPsdeOM4.cjs'); });
+      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-DfBvxRdw.cjs'); });
       const command = parseTerminalHooksArgs(args.slice(1));
       if (command.action === "help") {
         console.log(TERMINAL_HOOKS_HELP);
@@ -16804,7 +17015,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-CqMLY6dE.cjs'); });
+      const { handleSpawnCommand } = await Promise.resolve().then(function () { return require('./spawn-Cu_kM761.cjs'); });
       await handleSpawnCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16816,7 +17027,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-DSoaBHwA.cjs'); });
+      const { handleSessionsCommand } = await Promise.resolve().then(function () { return require('./sessions-CtrMbMBJ.cjs'); });
       await handleSessionsCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16828,7 +17039,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-DCzyBxLl.cjs'); });
+      const { handleSendCommand } = await Promise.resolve().then(function () { return require('./send-DbqRxLQW.cjs'); });
       await handleSendCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16934,9 +17145,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-BxHOGtEK.cjs'); });
-        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-DViGHwSj.cjs'); }).then(function (n) { return n.persistence; });
-        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-BGHnQXl5.cjs'); }).then(function (n) { return n.api; });
+        const { saveGoogleCloudProjectToConfig } = await Promise.resolve().then(function () { return require('./config-Dwt-15hE.cjs'); });
+        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-BDG3QjIB.cjs'); }).then(function (n) { return n.persistence; });
+        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-BuxqyzYf.cjs'); }).then(function (n) { return n.api; });
         let userEmail = void 0;
         try {
           const credentials = await readCredentialsForConfiguredRelay2();
@@ -16967,7 +17178,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-BxHOGtEK.cjs'); });
+        const { readGeminiLocalConfig } = await Promise.resolve().then(function () { return require('./config-Dwt-15hE.cjs'); });
         const config = readGeminiLocalConfig();
         if (config.googleCloudProject) {
           console.log(`Current Google Cloud Project: ${config.googleCloudProject}`);
@@ -17007,7 +17218,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-BnHGYX-H.cjs'); });
+      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-BE_nghsj.cjs'); });
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -17037,7 +17248,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-CBj99SO6.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DyvVjr8Y.cjs'); });
       const parsed = parsePiRunnerArgs(args.slice(1));
       const resolved = resolveAcpAgentConfig(["pi", ...parsed.passthrough]);
       const { credentials } = await authAndSetupMachineIfNeeded();
@@ -17064,7 +17275,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-CBj99SO6.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DyvVjr8Y.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       const acpArgs = [];
@@ -17104,7 +17315,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-3Ld1eoWV.cjs'); });
+      const { runOpenClaw } = await Promise.resolve().then(function () { return require('./runOpenClaw-Cqun9jar.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       let gatewayUrl;
@@ -17153,9 +17364,18 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(1);
     }
     return;
+  } else if (subcommand === "todo") {
+    try {
+      const { handleTodoCommand } = await Promise.resolve().then(function () { return require('./todo-yvodzg_y.cjs'); });
+      await handleTodoCommand(args.slice(1));
+    } catch (error) {
+      console.error(JSON.stringify({ error: error instanceof Error ? error.message : "Todo command failed" }));
+      process.exitCode = 1;
+    }
+    return;
   } else if (subcommand === "teams") {
     try {
-      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-CmU3K9vB.cjs'); });
+      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-C2MfKWFe.cjs'); });
       await handleTeamsCommand(args.slice(1));
     } catch (error) {
       console.error(error instanceof Error ? error.message : "Teams command failed");
@@ -17164,7 +17384,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "mcp" && args.length === 1) {
     try {
-      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-BbQ5FWcQ.cjs'); });
+      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-BZ3iYnBc.cjs'); });
       await handleMcpCommand();
     } catch (error) {
       process.stderr.write(`[very-happy mcp] Fatal: ${error instanceof Error ? error.message : String(error)}
@@ -17391,6 +17611,7 @@ ${chalk.bold("Usage:")}
                             Install optional Claude terminal mirror hooks
                             (add --remove to uninstall them)
   very-happy connect           Connect AI vendor API keys
+  very-happy todo              Built-in Todos and official agent skill (todo --help)
   very-happy sandbox           Configure and manage OS-level sandboxing
   very-happy notify            Send push notification
   very-happy mcp               Stdio MCP server exposing copy_to_clipboard for a
@@ -17537,8 +17758,10 @@ exports.GOOGLE_API_KEY_ENV = GOOGLE_API_KEY_ENV;
 exports.MAX_READ_LIMIT = MAX_READ_LIMIT;
 exports.MessageBuffer = MessageBuffer;
 exports.MessageQueue2 = MessageQueue2;
+exports.PI_TEAMS_EXTENSION = PI_TEAMS_EXTENSION;
 exports.SPAWN_AGENTS = SPAWN_AGENTS;
 exports.StreamRelay = StreamRelay;
+exports.TEAM_SKILL = TEAM_SKILL;
 exports.TitleGenerator = TitleGenerator;
 exports.archiveSession = archiveSession;
 exports.checkIfDaemonRunningAndCleanupStaleState = checkIfDaemonRunningAndCleanupStaleState;

package/dist/{index-D_Rm9dw9.cjs → index-DhCEmP3d.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index = require('./index-Do-kjc30.cjs');
+var index = require('./index-DgjzHewW.cjs');
 var claudeAgentSdk = require('@anthropic-ai/claude-agent-sdk');
 require('chalk');
 require('node:os');
 require('node:crypto');
-require('./types-BGHnQXl5.cjs');
+require('./types-BuxqyzYf.cjs');
 require('axios');
-require('./limits-DViGHwSj.cjs');
+require('./limits-BDG3QjIB.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('node:path');
@@ -31,7 +31,7 @@ require('fs');
 require('node:readline');
 require('@anthropic-ai/sandbox-runtime');
 require('expo-server-sdk');
-require('./agentGuidance-Cg9ZG1pP.cjs');
+require('./agentGuidance-B-CazXmT.cjs');
 require('ink');
 require('react');
 require('ps-list');

package/dist/{index-CBj99SO6.cjs → index-DyvVjr8Y.cjs}

@@ -1,14 +1,13 @@
 'use strict';
 
-var AcpBackend = require('./AcpBackend-ssQpTLks.cjs');
-var persistence = require('./limits-DViGHwSj.cjs');
-var AcpSessionManager = require('./AcpSessionManager-DHLc-D50.cjs');
+var AcpBackend = require('./AcpBackend-Cbykm5Pg.cjs');
+var persistence = require('./limits-BDG3QjIB.cjs');
+var AcpSessionManager = require('./AcpSessionManager-DGCsNKRd.cjs');
+var api = require('./types-BuxqyzYf.cjs');
 var promises = require('node:fs/promises');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
-var resources = require('./resources-CVl7NdOB.cjs');
-var api = require('./types-BGHnQXl5.cjs');
-var index = require('./index-Do-kjc30.cjs');
+var index = require('./index-DgjzHewW.cjs');
 require('node:child_process');
 require('@agentclientprotocol/sdk');
 require('node:fs');
@@ -34,7 +33,7 @@ require('fs');
 require('node:readline');
 require('@anthropic-ai/sandbox-runtime');
 require('expo-server-sdk');
-require('./agentGuidance-Cg9ZG1pP.cjs');
+require('./agentGuidance-B-CazXmT.cjs');
 require('ink');
 require('react');
 require('@anthropic-ai/claude-agent-sdk');
@@ -75,7 +74,7 @@ async function preparePiTeamsRuntime() {
   const directory = path.join(persistence.configuration.happyHomeDir, "teams", "pi-runtime");
   await promises.mkdir(directory, { recursive: true, mode: 448 });
   const extension = path.join(directory, "very-happy-teams.mjs");
-  await publish(extension, resources.PI_TEAMS_EXTENSION, 384);
+  await publish(extension, index.PI_TEAMS_EXTENSION, 384);
   const launcher = path.join(directory, "pi-teams.mjs");
   const script = `#!${process.execPath}
 import { spawn } from 'node:child_process';
@@ -1075,6 +1074,7 @@ async function runAcp(opts) {
         logAcp("muted", `Outgoing models from ${opts.agentName}: not reported yet`);
       }
     }
+    let todoDiscoverySent = false;
     while (!shouldExit) {
       const waitSignal = abortController.signal;
       const batch = await messageQueue.waitForMessagesAndGetAsString(waitSignal);
@@ -1101,7 +1101,11 @@ async function runAcp(opts) {
         if (typeof batch.mode.model === "string" && batch.mode.model.length > 0) {
           await switchModelIfRequested(batch.mode.model);
         }
-        await backend.sendPrompt(acpSessionId, batch.message);
+        const prompt = todoDiscoverySent ? batch.message : `${batch.message}
+
+${api.BUILTIN_TODO_DISCOVERY}`;
+        await backend.sendPrompt(acpSessionId, prompt);
+        todoDiscoverySent = true;
         await turnEnded;
         sendEnvelopes(sessionManager.endTurn("completed"));
         streamRelay.endTurn();

package/dist/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
 require('chalk');
-require('./index-Do-kjc30.cjs');
-require('./limits-DViGHwSj.cjs');
+require('./index-DgjzHewW.cjs');
+require('./limits-BDG3QjIB.cjs');
 require('zod');
-require('./types-BGHnQXl5.cjs');
+require('./types-BuxqyzYf.cjs');
 require('node:child_process');
 require('node:os');
 require('node:crypto');
@@ -12,7 +12,7 @@ require('cross-spawn');
 require('node:path');
 require('node:readline');
 require('node:fs');
-require('./agentGuidance-Cg9ZG1pP.cjs');
+require('./agentGuidance-B-CazXmT.cjs');
 require('node:fs/promises');
 require('fs/promises');
 require('ink');