very-happy-cli 0.2.125 → 0.2.127

package/dist/{index-CrSifgJM.mjs → index-B1qzJIMw.mjs}

@@ -1,13 +1,13 @@
 import{createRequire as _pkgrollCR}from"node:module";const require=_pkgrollCR(import.meta.url);import chalk from 'chalk';
 import os, { homedir, userInfo, tmpdir } from 'node:os';
 import { randomUUID, randomBytes, createHash as createHash$1, timingSafeEqual } from 'node:crypto';
-import { g as getProjectPath, p as projectPath, h as initializeSandbox, w as wrapCommand, b as contentLogMetadata, I as InvalidateSync, R as RawJSONLinesSchema, d as delay, j as AsyncLock, S as STREAM_DELTA_MAX_CHARS, M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES, k as commandOnPath, l as deriveLocalCliUpdateSummary, m as isClaudeSessionId, n as getLocalHappyAgentCredentialPath, r as readLocalHappyAgentCredentials, o as parseExactVersion, q as compareExactVersions, t as extractCompleteLines, u as decideBackfill, v as parseTerminalHookPayload, x as tmuxArgs, y as scrubTmuxClientEnv, z as decideMirrorBinding, B as MIRROR_BACKFILL_LINES_DEFAULT, C as mirrorLineKey, D as mirrorLocalId, E as detectCLIAvailability, F as detectResumeSupport, G as summarizeSpawnSessionForLog, H as shellescape, A as ApiClient, J as fetchCliUpdateState, K as resolveCliUpdateCheckInterval, L as DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS, i as isValidSessionId, N as listVhTerminals, O as isValidTerminalId, P as readVhTerminal, Q as sendToVhTerminal, T as TITLE_PROMPT_PREFIX, U as BOARD_ANALYZER_PROMPT_PREFIX, f as connectionState, V as startOfflineReconnection, c as createEnvelope, W as CodexAppServerClient } from './types-DLDkfrTC.mjs';
-import { z as readDaemonState, l as logger, c as configuration, A as clearDaemonState, B as ensurePrivateDirectory, D as hardenPrivateFile, p as packageJson, f as readSettings, E as readCredentials, s as credentialRelayProblem, g as encodeBase64, F as readSettingsOutcome, G as updateSettings, H as encodeBase64Url, m as decodeBase64, I as writeCredentialsLegacy, J as writeCredentialsDataKey, i as readCredentialsForConfiguredRelay, j as encrypt, r as readPersistedSessions, w as writePrivateFileSync, K as decryptWithDataKey, L as decryptLegacy, M as persistSession, k as decrypt, e as ensurePrivateDirectorySync, N as acquireDaemonLock, O as deletePersistedSessions, P as writeDaemonState, Q as writeSettings, R as releaseDaemonLock, C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, d as CLIPBOARD_MAX_BYTES, S as clearCredentials, T as clearMachineId, U as SandboxConfigSchema, V as getLatestDaemonLog } from './limits-FjbPJPsF.mjs';
+import { j as getProjectPath, h as BUILTIN_TODO_DISCOVERY, p as projectPath, k as initializeSandbox, w as wrapCommand, d as contentLogMetadata, I as InvalidateSync, R as RawJSONLinesSchema, f as delay, l as AsyncLock, S as STREAM_DELTA_MAX_CHARS, M as MAX_CHAT_ATTACHMENT_SOURCE_BYTES, m as commandOnPath, n as deriveLocalCliUpdateSummary, o as isClaudeSessionId, q as getLocalHappyAgentCredentialPath, r as readLocalHappyAgentCredentials, t as parseExactVersion, u as compareExactVersions, v as extractCompleteLines, x as decideBackfill, y as parseTerminalHookPayload, z as tmuxArgs, C as scrubTmuxClientEnv, D as decideMirrorBinding, E as MIRROR_BACKFILL_LINES_DEFAULT, F as mirrorLineKey, G as mirrorLocalId, H as detectCLIAvailability, J as detectResumeSupport, K as summarizeSpawnSessionForLog, L as shellescape, A as ApiClient, N as fetchCliUpdateState, O as resolveCliUpdateCheckInterval, P as DEFAULT_CLI_UPDATE_CHECK_INTERVAL_MS, i as isValidSessionId, Q as listVhTerminals, T as isValidTerminalId, U as readVhTerminal, V as sendToVhTerminal, W as TITLE_PROMPT_PREFIX, X as BOARD_ANALYZER_PROMPT_PREFIX, g as connectionState, Y as startOfflineReconnection, c as createEnvelope, Z as CodexAppServerClient } from './types-Df_vXvzD.mjs';
+import { z as readDaemonState, l as logger, c as configuration, A as clearDaemonState, B as ensurePrivateDirectory, D as hardenPrivateFile, p as packageJson, g as readSettings, E as readCredentials, s as credentialRelayProblem, i as encodeBase64, F as readSettingsOutcome, G as updateSettings, H as encodeBase64Url, m as decodeBase64, I as writeCredentialsLegacy, J as writeCredentialsDataKey, d as readCredentialsForConfiguredRelay, j as encrypt, r as readPersistedSessions, w as writePrivateFileSync, K as decryptWithDataKey, L as decryptLegacy, M as persistSession, k as decrypt, f as ensurePrivateDirectorySync, N as acquireDaemonLock, O as deletePersistedSessions, P as writeDaemonState, Q as writeSettings, R as releaseDaemonLock, C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION, e as CLIPBOARD_MAX_BYTES, S as clearCredentials, T as clearMachineId, U as SandboxConfigSchema, V as getLatestDaemonLog } from './limits-D2XM3dvN.mjs';
 import spawn$1, { spawn } from 'cross-spawn';
 import path, { join, resolve, basename, isAbsolute, dirname, sep, delimiter, normalize } from 'node:path';
 import { createInterface } from 'node:readline';
 import { existsSync, readFileSync, readdirSync, statSync, mkdirSync, unlinkSync, renameSync, writeFileSync, accessSync, constants, openSync, fsyncSync, closeSync, rmSync as rmSync$1, chmodSync as chmodSync$1 } from 'node:fs';
-import { t as trimIdent, A as AGENT_GUIDANCE, P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, T as TEAM_TOOL_NAMES, r as registerTeamsTools, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, d as REPORT_PROGRESS_TOOL_TITLE, e as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-QpYwykb9.mjs';
+import { f as trimIdent, A as AGENT_GUIDANCE, t as teamScopePath, T as TeamConnectionPreflightError, e as createTeamsClient, P as PREVIEW_TOOL_NAME, R as REPORT_PROGRESS_TOOL_NAME, g as TEAM_TOOL_NAMES, r as registerTeamsTools, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, h as REPORT_PROGRESS_TOOL_TITLE, i as REPORT_PROGRESS_TOOL_DESCRIPTION } from './agentGuidance-CTyzeLCQ.mjs';
 import { readFile, writeFile, rename, unlink, mkdir, symlink, rm, readlink, lstat, stat, open as open$1, appendFile } from 'node:fs/promises';
 import fs, { watch, access } from 'fs/promises';
 import { useStdout, useInput, Box, Text, render } from 'ink';
@@ -647,7 +647,7 @@ function shouldIncludeCoAuthoredBy() {
 
 const BASE_SYSTEM_PROMPT = (() => 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" + AGENT_GUIDANCE;
+`))() + "\n\n" + AGENT_GUIDANCE + "\n\n" + BUILTIN_TODO_DISCOVERY;
 const CO_AUTHORED_CREDITS = (() => trimIdent(`
     When making commit messages, instead of just giving co-credit to Claude, also give credit to Happy like so:
 
@@ -5831,7 +5831,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 = encodeBase64(encrypt(
@@ -8800,6 +8801,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) {
@@ -9381,7 +9476,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) {
@@ -9394,7 +9489,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;
@@ -9405,7 +9500,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);
@@ -9423,7 +9518,7 @@ function createTeamWorker(deps) {
           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);
@@ -9445,7 +9540,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);
         }
@@ -9547,7 +9642,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;
@@ -9591,6 +9686,7 @@ const hostSuffix = process.env.HAPPY_VARIANT === "dev" ? "-dev" : "";
 const startupCliAvailability = detectCLIAvailability();
 const initialMachineMetadata = {
   teamsVersion: 1,
+  teamLaunchVersion: 1,
   host: os$1.hostname() + hostSuffix,
   platform: os$1.platform(),
   happyCliVersion: packageJson.version,
@@ -10861,7 +10957,8 @@ async function startDaemon() {
     });
     void apiMachine.updateMachineMetadata((current) => ({
       ...current ?? initialMachineMetadata,
-      teamsVersion: 1
+      teamsVersion: 1,
+      teamLaunchVersion: 1
     })).catch(() => logger.debug("[DAEMON RUN] Teams capability publication will retry on reconnect"));
     const cleanupAndShutdown = async (source, errorMessage) => {
       logger.debug(`[DAEMON RUN] Starting proper cleanup (source: ${source}, errorMessage: ${errorMessage})...`);
@@ -10900,6 +10997,113 @@ async function startDaemon() {
   }
 }
 
+const TEAMS_ADOPT_CAPABILITY = "teams-adopt-v1";
+const TeamAdoptSchema = z.object({
+  requestId: z.string().min(1).max(128),
+  name: z.string().trim().min(1).max(128),
+  teamId: z.string().min(1).max(128).optional()
+}).strict();
+async function retainIntent(path, input) {
+  await mkdir(dirname(path), { recursive: true, mode: 448 });
+  let file;
+  try {
+    file = await open$1(path, constants.O_WRONLY | constants.O_CREAT | 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 open$1(path, constants.O_RDONLY | (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}.${randomUUID()}.new`;
+  const file = await open$1(temporary, "wx", 384);
+  try {
+    await file.writeFile(JSON.stringify({ ...input, resolvedTeamId, guidanceDelivered }));
+    await file.sync();
+  } finally {
+    await file.close();
+  }
+  try {
+    await rename(temporary, path);
+  } finally {
+    await unlink(temporary).catch(() => {
+    });
+  }
+}
+function createTeamAdoption(sessionId) {
+  const client = 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 = `${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 TeamConnectionPreflightError && intent?.fresh && !intent.resolvedTeamId) {
+          await 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);
@@ -11543,6 +11747,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])] }));
+  }
   logger.debug(`[happyMCP] server:ready sessionId=${client.sessionId} url=${baseUrl.toString()}`);
   return {
     url: baseUrl.toString(),
@@ -11556,6 +11765,7 @@ async function startHappyServer(client, options) {
     ],
     stop: () => {
       logger.debug(`[happyMCP] server:stop sessionId=${client.sessionId}`);
+      if (adoptionEnabled) client.rpcHandlerManager.unregisterHandler("teams-adopt");
       server.close();
     }
   };
@@ -11812,7 +12022,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 import('./index-D-BgvQi5.mjs');
+    const { query } = await import('./index-CWPgxeLD.mjs');
     return runSideQuestion(query, input);
   });
   const slots = /* @__PURE__ */ new Map();
@@ -15873,6 +16083,7 @@ function buildCodexTurnPrompt(opts) {
   parts.push(opts.message);
   if (opts.includeTitleInstruction) {
     parts.push(CHANGE_TITLE_INSTRUCTION);
+    parts.push(BUILTIN_TODO_DISCOVERY);
   }
   return parts.join("\n\n");
 }
@@ -16765,7 +16976,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 import('./installTerminalHooks-Z1Jb6yjb.mjs');
+      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await import('./installTerminalHooks-cpuDExTT.mjs');
       const command = parseTerminalHooksArgs(args.slice(1));
       if (command.action === "help") {
         console.log(TERMINAL_HOOKS_HELP);
@@ -16782,7 +16993,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
   } else if (subcommand === "spawn") {
     try {
-      const { handleSpawnCommand } = await import('./spawn-j9KBfj4e.mjs');
+      const { handleSpawnCommand } = await import('./spawn-DMx1JKXo.mjs');
       await handleSpawnCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16794,7 +17005,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "sessions") {
     try {
-      const { handleSessionsCommand } = await import('./sessions-Ba2oRTmw.mjs');
+      const { handleSessionsCommand } = await import('./sessions-D06cLJ7f.mjs');
       await handleSessionsCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16806,7 +17017,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "send") {
     try {
-      const { handleSendCommand } = await import('./send-BevgS1mf.mjs');
+      const { handleSendCommand } = await import('./send-D2xX42zg.mjs');
       await handleSendCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -16912,9 +17123,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 import('./config-CZNIz3W0.mjs');
-        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await import('./limits-FjbPJPsF.mjs').then(function (n) { return n.W; });
-        const { ApiClient: ApiClient2 } = await import('./types-DLDkfrTC.mjs').then(function (n) { return n.X; });
+        const { saveGoogleCloudProjectToConfig } = await import('./config-DotNknpP.mjs');
+        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await import('./limits-D2XM3dvN.mjs').then(function (n) { return n.W; });
+        const { ApiClient: ApiClient2 } = await import('./types-Df_vXvzD.mjs').then(function (n) { return n._; });
         let userEmail = void 0;
         try {
           const credentials = await readCredentialsForConfiguredRelay2();
@@ -16945,7 +17156,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 import('./config-CZNIz3W0.mjs');
+        const { readGeminiLocalConfig } = await import('./config-DotNknpP.mjs');
         const config = readGeminiLocalConfig();
         if (config.googleCloudProject) {
           console.log(`Current Google Cloud Project: ${config.googleCloudProject}`);
@@ -16985,7 +17196,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(0);
     }
     try {
-      const { runGemini } = await import('./runGemini-Bu49s_bN.mjs');
+      const { runGemini } = await import('./runGemini-BY7uA-Uk.mjs');
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -17015,7 +17226,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       }
     };
     try {
-      const { runAcp, resolveAcpAgentConfig } = await import('./index-Jrk6ud3g.mjs');
+      const { runAcp, resolveAcpAgentConfig } = await import('./index-C2kblG8-.mjs');
       const parsed = parsePiRunnerArgs(args.slice(1));
       const resolved = resolveAcpAgentConfig(["pi", ...parsed.passthrough]);
       const { credentials } = await authAndSetupMachineIfNeeded();
@@ -17042,7 +17253,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 import('./index-Jrk6ud3g.mjs');
+      const { runAcp, resolveAcpAgentConfig } = await import('./index-C2kblG8-.mjs');
       let startedBy = void 0;
       let verbose = false;
       const acpArgs = [];
@@ -17082,7 +17293,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "openclaw") {
     try {
-      const { runOpenClaw } = await import('./runOpenClaw-CznAYPCh.mjs');
+      const { runOpenClaw } = await import('./runOpenClaw-Be_U4DHZ.mjs');
       let startedBy = void 0;
       let verbose = false;
       let gatewayUrl;
@@ -17131,9 +17342,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 import('./todo-hKSIY23F.mjs');
+      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 import('./teams-C0ggJTJ-.mjs');
+      const { handleTeamsCommand } = await import('./teams-D7ubdfTY.mjs');
       await handleTeamsCommand(args.slice(1));
     } catch (error) {
       console.error(error instanceof Error ? error.message : "Teams command failed");
@@ -17142,7 +17362,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 import('./mcp-zqPJ94Bk.mjs');
+      const { handleMcpCommand } = await import('./mcp-CpUrsnoC.mjs');
       await handleMcpCommand();
     } catch (error) {
       process.stderr.write(`[very-happy mcp] Fatal: ${error instanceof Error ? error.message : String(error)}
@@ -17369,6 +17589,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
@@ -17503,4 +17724,4 @@ ${chalk.bold("Examples:")}
   }
 }
 
-export { ALLOWED_SPAWN_PERMISSION_MODES as A, hashObject as B, startHappyServer as C, DEFAULT_RECENT_LIMIT as D, BasePermissionHandler as E, writeSessionModeFile as F, GEMINI_MODEL_ENV as G, normalizeAcpPermissionMode as H, removeSessionModeFile as I, GEMINI_API_KEY_ENV as J, GOOGLE_API_KEY_ENV as K, BaseReasoningProcessor as L, MAX_READ_LIMIT as M, MessageBuffer as N, CHANGE_TITLE_INSTRUCTION as O, SPAWN_AGENTS as S, TitleGenerator as T, sessionWebUrl as a, sanitizeSpawnPermissionMode as b, checkIfDaemonRunningAndCleanupStaleState as c, sendUserMessage as d, listSessions as e, stopSession as f, resolvePermissionRequest as g, archiveSession as h, isValidSpawnOrigin as i, DEFAULT_GEMINI_MODEL as j, setTerminalTitleViaDaemon as k, listAccountSessions as l, registerAssistantSessionTools as m, initialMachineMetadata as n, createSessionMetadata as o, pushClipboardViaDaemon as p, query as q, readSessionTranscript as r, spawnDaemonSession as s, tmuxSupportsSessionEnv as t, setupOfflineReconnection as u, notifyDaemonSessionStarted as v, waitForSessionKey as w, MessageQueue2 as x, registerKillSessionHandler as y, StreamRelay as z };
+export { ALLOWED_SPAWN_PERMISSION_MODES as A, hashObject as B, startHappyServer as C, DEFAULT_RECENT_LIMIT as D, TitleGenerator as E, BasePermissionHandler as F, GEMINI_MODEL_ENV as G, writeSessionModeFile as H, normalizeAcpPermissionMode as I, removeSessionModeFile as J, GEMINI_API_KEY_ENV as K, GOOGLE_API_KEY_ENV as L, MAX_READ_LIMIT as M, BaseReasoningProcessor as N, MessageBuffer as O, PI_TEAMS_EXTENSION as P, CHANGE_TITLE_INSTRUCTION as Q, SPAWN_AGENTS as S, TEAM_SKILL as T, sessionWebUrl as a, sanitizeSpawnPermissionMode as b, checkIfDaemonRunningAndCleanupStaleState as c, sendUserMessage as d, listSessions as e, stopSession as f, resolvePermissionRequest as g, archiveSession as h, isValidSpawnOrigin as i, DEFAULT_GEMINI_MODEL as j, setTerminalTitleViaDaemon as k, listAccountSessions as l, registerAssistantSessionTools as m, initialMachineMetadata as n, createSessionMetadata as o, pushClipboardViaDaemon as p, query as q, readSessionTranscript as r, spawnDaemonSession as s, tmuxSupportsSessionEnv as t, setupOfflineReconnection as u, notifyDaemonSessionStarted as v, waitForSessionKey as w, MessageQueue2 as x, registerKillSessionHandler as y, StreamRelay as z };

package/dist/{index-Jrk6ud3g.mjs → index-C2kblG8-.mjs}

@@ -1,13 +1,12 @@
-import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-DOQGItcS.mjs';
-export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-DOQGItcS.mjs';
-import { c as configuration, f as readSettings, g as encodeBase64, l as logger } from './limits-FjbPJPsF.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-D4WkNsRs.mjs';
+import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-B9_vB_mY.mjs';
+export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-B9_vB_mY.mjs';
+import { c as configuration, g as readSettings, i as encodeBase64, l as logger } from './limits-D2XM3dvN.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-HsxKXreC.mjs';
+import { g as connectionState, A as ApiClient, p as projectPath, h as BUILTIN_TODO_DISCOVERY } from './types-Df_vXvzD.mjs';
 import { mkdir, chmod, writeFile, rename } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { P as PI_TEAMS_EXTENSION } from './resources-D-mn7ptO.mjs';
-import { f as connectionState, A as ApiClient, p as projectPath } from './types-DLDkfrTC.mjs';
-import { n as initialMachineMetadata, o as createSessionMetadata, u as setupOfflineReconnection, v as notifyDaemonSessionStarted, z as StreamRelay, x as MessageQueue2, B as hashObject, C as startHappyServer, T as TitleGenerator, y as registerKillSessionHandler, E as BasePermissionHandler, F as writeSessionModeFile, H as normalizeAcpPermissionMode, I as removeSessionModeFile } from './index-CrSifgJM.mjs';
+import { P as PI_TEAMS_EXTENSION, n as initialMachineMetadata, o as createSessionMetadata, u as setupOfflineReconnection, v as notifyDaemonSessionStarted, z as StreamRelay, x as MessageQueue2, B as hashObject, C as startHappyServer, E as TitleGenerator, y as registerKillSessionHandler, F as BasePermissionHandler, H as writeSessionModeFile, I as normalizeAcpPermissionMode, J as removeSessionModeFile } from './index-B1qzJIMw.mjs';
 import 'node:child_process';
 import '@agentclientprotocol/sdk';
 import 'node:fs';
@@ -33,7 +32,7 @@ import 'fs';
 import 'node:readline';
 import '@anthropic-ai/sandbox-runtime';
 import 'expo-server-sdk';
-import './agentGuidance-QpYwykb9.mjs';
+import './agentGuidance-CTyzeLCQ.mjs';
 import 'ink';
 import 'react';
 import '@anthropic-ai/claude-agent-sdk';
@@ -1074,6 +1073,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);
@@ -1100,7 +1100,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}
+
+${BUILTIN_TODO_DISCOVERY}`;
+        await backend.sendPrompt(acpSessionId, prompt);
+        todoDiscoverySent = true;
         await turnEnded;
         sendEnvelopes(sessionManager.endTurn("completed"));
         streamRelay.endTurn();

package/dist/{index-D-BgvQi5.mjs → index-CWPgxeLD.mjs}

@@ -1,11 +1,11 @@
-import { q as query } from './index-CrSifgJM.mjs';
+import { q as query } from './index-B1qzJIMw.mjs';
 export { AbortError } from '@anthropic-ai/claude-agent-sdk';
 import 'chalk';
 import 'node:os';
 import 'node:crypto';
-import './types-DLDkfrTC.mjs';
+import './types-Df_vXvzD.mjs';
 import 'axios';
-import './limits-FjbPJPsF.mjs';
+import './limits-D2XM3dvN.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import 'node:path';
@@ -29,7 +29,7 @@ import 'fs';
 import 'node:readline';
 import '@anthropic-ai/sandbox-runtime';
 import 'expo-server-sdk';
-import './agentGuidance-QpYwykb9.mjs';
+import './agentGuidance-CTyzeLCQ.mjs';
 import 'ink';
 import 'react';
 import 'ps-list';