very-happy-cli 0.2.182 → 0.2.184

package/dist/{index-oh8XEozJ.cjs → index-Ub-5xbcU.cjs}

@@ -447,7 +447,7 @@ z.z.object({
   events: z.z.array(ConnectionDiagnosticEventSchema).min(1).max(32)
 }).strict();
 const TeamPermissionModeSchema = z.z.enum(["default", "bypassPermissions"]);
-const id$2 = z.z.string().min(1).max(128);
+const id$3 = z.z.string().min(1).max(128);
 const text$1 = z.z.string().min(1).max(32e3);
 const TeamAssistantSchema = z.z.enum(["claude", "codex", "pi-acp"]);
 const TeamModelSchema = z.z.string().trim().min(1).max(256);
@@ -458,40 +458,49 @@ const TeamActionSchema = z.z.discriminatedUnion("type", [
   z.z.object({ type: z.z.literal("start"), launch: TeamLaunchSchema }),
   z.z.object({ type: z.z.literal("set-defaults"), defaults: TeamDefaultsSchema }),
   z.z.object({ type: z.z.literal("set-permission-mode"), permissionMode: TeamPermissionModeSchema }),
-  z.z.object({ type: z.z.literal("schedule-create"), name: id$2, botId: id$2, body: text$1, runAt: z.z.number().int().positive().max(864e13), intervalMs: z.z.number().int().min(6e4).max(366 * 864e5).optional() }),
-  z.z.object({ type: z.z.literal("schedule-pause"), scheduleId: id$2, version: z.z.number().int().positive() }),
-  z.z.object({ type: z.z.literal("schedule-resume"), scheduleId: id$2, version: z.z.number().int().positive() }),
-  z.z.object({ type: z.z.literal("schedule-cancel"), scheduleId: id$2, version: z.z.number().int().positive() }),
-  z.z.object({ type: z.z.literal("reconcile-operation"), operationId: id$2, claimId: id$2, note: z.z.string().trim().min(1).max(4e3) }),
+  z.z.object({ type: z.z.literal("schedule-create"), name: id$3, botId: id$3, body: text$1, runAt: z.z.number().int().positive().max(864e13), intervalMs: z.z.number().int().min(6e4).max(366 * 864e5).optional() }),
+  z.z.object({ type: z.z.literal("schedule-pause"), scheduleId: id$3, version: z.z.number().int().positive() }),
+  z.z.object({ type: z.z.literal("schedule-resume"), scheduleId: id$3, version: z.z.number().int().positive() }),
+  z.z.object({ type: z.z.literal("schedule-cancel"), scheduleId: id$3, version: z.z.number().int().positive() }),
+  z.z.object({ type: z.z.literal("reconcile-operation"), operationId: id$3, claimId: id$3, note: z.z.string().trim().min(1).max(4e3) }),
   // B-689: owner asks the execution computer to run a failed/uncertain operation again.
-  z.z.object({ type: z.z.literal("retry-operation"), operationId: id$2, claimId: id$2 }),
+  z.z.object({ type: z.z.literal("retry-operation"), operationId: id$3, claimId: id$3 }),
   /** B-730: `transfer` = the owner confirmed moving a session that is bound in another live team (Web adopt); without it the server answers `session_in_other_team`. An old server strips it. */
-  z.z.object({ type: z.z.literal("join"), name: id$2, sessionId: id$2, botId: id$2.optional(), transfer: z.z.literal(true).optional() }),
-  z.z.object({ type: z.z.literal("delegate"), goal: text$1, acceptance: z.z.array(text$1).min(1).max(32), parentTaskId: id$2.optional(), assigneeBotId: id$2.optional(), botName: id$2.optional(), directory: z.z.string().min(1).max(4096).optional(), assistant: TeamAssistantSchema.optional(), model: TeamModelSchema.optional() }),
-  z.z.object({ type: z.z.literal("message"), taskId: id$2, body: text$1, recipientBotId: id$2.optional() }),
-  z.z.object({ type: z.z.literal("submit"), taskId: id$2, attemptId: id$2, goalVersion: z.z.number().int().positive(), result: text$1 }),
-  z.z.object({ type: z.z.literal("accept"), taskId: id$2, attemptId: id$2, goalVersion: z.z.number().int().positive() }),
-  z.z.object({ type: z.z.literal("return"), taskId: id$2, attemptId: id$2, goalVersion: z.z.number().int().positive(), reason: text$1 }),
-  z.z.object({ type: z.z.literal("cancel"), taskId: id$2, attemptId: id$2, goalVersion: z.z.number().int().positive(), reason: text$1 }),
-  z.z.object({ type: z.z.literal("handoff"), taskId: id$2, attemptId: id$2, goalVersion: z.z.number().int().positive(), assigneeBotId: id$2 }),
-  z.z.object({ type: z.z.literal("claim-operation"), operationId: id$2, machineId: id$2, teamLaunchVersion: z.z.literal(1).optional() }),
-  z.z.object({ type: z.z.literal("complete-operation"), operationId: id$2, machineId: id$2, claimId: id$2, sessionId: id$2.optional(), workingDirectory: z.z.string().min(1).max(4096).optional() }),
-  z.z.object({ type: z.z.literal("fail-operation"), operationId: id$2, machineId: id$2, claimId: id$2, error: text$1, unknown: z.z.boolean().optional() }),
-  z.z.object({ type: z.z.literal("session-event"), sessionId: id$2, event: z.z.enum(["idle", "blocked", "exited"]) }),
-  z.z.object({ type: z.z.literal("message-delivered"), messageId: id$2, recipientBotId: id$2, generation: z.z.number().int().positive(), sessionId: id$2 })
+  z.z.object({ type: z.z.literal("join"), name: id$3, sessionId: id$3, botId: id$3.optional(), transfer: z.z.literal(true).optional() }),
+  z.z.object({ type: z.z.literal("delegate"), goal: text$1, acceptance: z.z.array(text$1).min(1).max(32), parentTaskId: id$3.optional(), assigneeBotId: id$3.optional(), botName: id$3.optional(), directory: z.z.string().min(1).max(4096).optional(), assistant: TeamAssistantSchema.optional(), model: TeamModelSchema.optional() }),
+  z.z.object({ type: z.z.literal("message"), taskId: id$3, body: text$1, recipientBotId: id$3.optional() }),
+  z.z.object({ type: z.z.literal("submit"), taskId: id$3, attemptId: id$3, goalVersion: z.z.number().int().positive(), result: text$1 }),
+  z.z.object({ type: z.z.literal("accept"), taskId: id$3, attemptId: id$3, goalVersion: z.z.number().int().positive() }),
+  z.z.object({ type: z.z.literal("return"), taskId: id$3, attemptId: id$3, goalVersion: z.z.number().int().positive(), reason: text$1 }),
+  z.z.object({ type: z.z.literal("cancel"), taskId: id$3, attemptId: id$3, goalVersion: z.z.number().int().positive(), reason: text$1 }),
+  z.z.object({ type: z.z.literal("handoff"), taskId: id$3, attemptId: id$3, goalVersion: z.z.number().int().positive(), assigneeBotId: id$3 }),
+  z.z.object({ type: z.z.literal("claim-operation"), operationId: id$3, machineId: id$3, teamLaunchVersion: z.z.literal(1).optional() }),
+  z.z.object({ type: z.z.literal("complete-operation"), operationId: id$3, machineId: id$3, claimId: id$3, sessionId: id$3.optional(), workingDirectory: z.z.string().min(1).max(4096).optional() }),
+  z.z.object({
+    type: z.z.literal("fail-operation"),
+    operationId: id$3,
+    machineId: id$3,
+    claimId: id$3,
+    error: text$1,
+    unknown: z.z.boolean().optional(),
+    /** B-775: a failed cleanup whose wrapper was already stopped (only resources retained). */
+    sessionStopped: z.z.boolean().optional()
+  }),
+  z.z.object({ type: z.z.literal("session-event"), sessionId: id$3, event: z.z.enum(["idle", "blocked", "exited"]) }),
+  z.z.object({ type: z.z.literal("message-delivered"), messageId: id$3, recipientBotId: id$3, generation: z.z.number().int().positive(), sessionId: id$3 })
 ]);
-z.z.object({ requestId: id$2, action: TeamActionSchema });
+z.z.object({ requestId: id$3, action: TeamActionSchema });
 const TeamProjectChoiceSchema = z.z.object({
-  projectId: id$2.optional(),
-  inheritFromSessionId: id$2.optional(),
+  projectId: id$3.optional(),
+  inheritFromSessionId: id$3.optional(),
   create: z.z.boolean().optional(),
   directory: z.z.string().min(1).max(4096).optional()
 });
-z.z.object({ name: id$2, machineId: id$2, requestId: id$2.optional(), launch: TeamLaunchSchema.optional(), project: TeamProjectChoiceSchema.optional(), sessionId: id$2.optional(), transfer: z.z.literal(true).optional() });
+z.z.object({ name: id$3, machineId: id$3, requestId: id$3.optional(), launch: TeamLaunchSchema.optional(), project: TeamProjectChoiceSchema.optional(), sessionId: id$3.optional(), transfer: z.z.literal(true).optional() });
 z.z.object({
-  projectId: id$2.nullable().optional(),
+  projectId: id$3.nullable().optional(),
   create: z.z.boolean().optional(),
-  requestId: id$2.optional()
+  requestId: id$3.optional()
 }).refine((v) => v.projectId !== void 0 !== (v.create === true), "exactly one of projectId / create");
 const TEAM_WORKTREE = /\/teams\/worktrees\/([^/]+)(?:\/|$)/;
 function teamWorktreeId(path) {
@@ -508,7 +517,7 @@ function rebaseTeamWorktreePath(path, repository) {
   const rest = normalized.slice(match.index + match[0].length).replace(/\/+$/, "");
   return rest ? `${repository.replace(/\/+$/, "")}/${rest}` : repository;
 }
-const id$1 = z.z.string().min(1).max(128);
+const id$2 = z.z.string().min(1).max(128);
 const text = z.z.string().min(1).max(32e3);
 const AUTOMATION_NAME_PATTERN = /^[a-z0-9][a-z0-9-_.]{0,63}$/;
 const AutomationNameSchema = z.z.string().regex(AUTOMATION_NAME_PATTERN, "automation name must match [a-z0-9][a-z0-9-_.]{0,63}");
@@ -517,6 +526,7 @@ const AUTOMATION_MAX_INTERVAL_MS = 366 * 864e5;
 const AUTOMATION_MAX_TIMESTAMP = 864e13;
 const AUTOMATION_PAYLOAD_MAX_BYTES = 65536;
 const AUTOMATION_SUMMARY_MAX_CHARS = 4096;
+const AUTOMATION_ATTENTION_REASON_MAX_CHARS = 512;
 const AUTOMATION_DEFAULT_LEASE_MS = 6e4;
 const AUTOMATION_CLAIM_MAX_RUNS = 8;
 const AUTOMATION_PRECHECK_DEFAULT_TIMEOUT_MS = 6e4;
@@ -547,7 +557,7 @@ const AutomationActionSchema = z.z.discriminatedUnion("kind", [
     worktree: z.z.boolean().optional(),
     sticky: AutomationStickySchema.optional()
   }),
-  z.z.object({ kind: z.z.literal("send"), sessionId: id$1, prompt: text }),
+  z.z.object({ kind: z.z.literal("send"), sessionId: id$2, prompt: text }),
   z.z.object({
     kind: z.z.literal("script"),
     command: z.z.array(z.z.string().min(1).max(4096)).min(1).max(256),
@@ -573,7 +583,7 @@ const maxRuntimeMs = z.z.number().int().min(6e4).max(7 * 864e5);
 z.z.object({
   name: AutomationNameSchema,
   description: z.z.string().max(4e3).nullable().optional(),
-  machineId: id$1,
+  machineId: id$2,
   trigger: AutomationTriggerSchema,
   action: AutomationActionSchema,
   concurrency: AutomationConcurrencySchema.optional(),
@@ -582,13 +592,13 @@ z.z.object({
   /** B-548. Older servers strip it silently — clients must check the response echoes `precheck`. */
   precheck: AutomationPrecheckSchema.nullable().optional(),
   /** B-644: sessions this automation spawns join this project (quiet variant). Older servers strip it — check the echo. */
-  projectId: id$1.nullable().optional()
+  projectId: id$2.nullable().optional()
 });
 z.z.object({
   version: z.z.number().int().positive(),
   name: AutomationNameSchema.optional(),
   description: z.z.string().max(4e3).nullable().optional(),
-  machineId: id$1.optional(),
+  machineId: id$2.optional(),
   trigger: AutomationTriggerSchema.optional(),
   action: AutomationActionSchema.optional(),
   concurrency: AutomationConcurrencySchema.optional(),
@@ -596,41 +606,41 @@ z.z.object({
   /** B-548: omitted keeps the current precheck, `null` removes it. Changing `action` alone keeps it too. */
   precheck: AutomationPrecheckSchema.nullable().optional(),
   /** B-644: omitted keeps the current project, `null` detaches. */
-  projectId: id$1.nullable().optional()
+  projectId: id$2.nullable().optional()
 });
 const payload = z.z.string().max(AUTOMATION_PAYLOAD_MAX_BYTES).refine((v) => new TextEncoder().encode(v).length <= AUTOMATION_PAYLOAD_MAX_BYTES, "payload exceeds 64KB");
 z.z.object({ payload: payload.optional(), dedupeKey: z.z.string().min(1).max(256).optional() });
 z.z.object({ payload: payload.optional() });
 z.z.object({
-  machineId: id$1,
+  machineId: id$2,
   limit: z.z.number().int().min(1).max(AUTOMATION_CLAIM_MAX_RUNS).optional(),
   leaseMs: z.z.number().int().min(5e3).max(36e5).optional(),
   /** B-548: what this daemon can execute (e.g. `precheck`). Older daemons send nothing; older servers strip it. */
   capabilities: z.z.array(z.z.string().min(1).max(64)).max(32).optional()
 });
 z.z.object({
-  claimId: id$1.optional(),
+  claimId: id$2.optional(),
   status: z.z.enum(["running", "done", "failed", "skipped"]).optional(),
-  sessionId: id$1.nullable().optional(),
+  sessionId: id$2.nullable().optional(),
   stickyKey: z.z.string().min(1).max(512).optional(),
   summary: z.z.string().max(AUTOMATION_SUMMARY_MAX_CHARS).nullable().optional(),
   error: z.z.string().max(AUTOMATION_SUMMARY_MAX_CHARS).nullable().optional(),
   exitCode: z.z.number().int().nullable().optional(),
   needsAttention: z.z.boolean().optional(),
-  attentionReason: z.z.string().max(512).nullable().optional(),
+  attentionReason: z.z.string().max(AUTOMATION_ATTENTION_REASON_MAX_CHARS).nullable().optional(),
   leaseMs: z.z.number().int().min(5e3).max(36e5).optional()
 });
 z.z.object({ by: z.z.string().min(1).max(64).optional() });
-z.z.object({ key: z.z.string().min(1).max(512), sessionId: id$1 });
+z.z.object({ key: z.z.string().min(1).max(512), sessionId: id$2 });
 z.z.object({ key: z.z.string().min(1).max(512) });
 z.z.object({
-  automationId: id$1.optional(),
+  automationId: id$2.optional(),
   name: AutomationNameSchema.optional(),
   status: z.z.string().min(1).max(64).optional(),
   attention: z.z.enum(["1", "true", "0", "false"]).optional(),
   limit: z.z.coerce.number().int().min(1).max(200).optional()
 });
-z.z.object({ machineId: id$1.optional() });
+z.z.object({ machineId: id$2.optional() });
 const PROJECT_SESSION_CAPABILITY = "project-v1";
 const PROJECT_LIMITS = {
   nameChars: 120,
@@ -642,11 +652,11 @@ const PROJECT_LIMITS = {
   messageBytes: 64 * 1024,
   presenceBatch: 200,
   memberBatch: 200};
-const id = z.z.string().min(1).max(128);
+const id$1 = z.z.string().min(1).max(128);
 const utf8Bytes = (value) => new TextEncoder().encode(value).length;
 const boundedText = (maxBytes) => z.z.string().max(maxBytes).refine((v) => utf8Bytes(v) <= maxBytes, `exceeds ${maxBytes} bytes`);
 const ProjectFolderSchema = z.z.object({
-  machineId: id,
+  machineId: id$1,
   path: z.z.string().min(1).max(4096),
   primary: z.z.boolean().optional()
 });
@@ -666,9 +676,9 @@ z.z.object({
   folders: z.z.array(ProjectFolderSchema).max(PROJECT_LIMITS.folders).optional(),
   defaults: ProjectDefaultsSchema.optional(),
   /** Idempotency: the same requestId returns the project it created. */
-  requestId: id.optional(),
+  requestId: id$1.optional(),
   /** Optional initial members (e.g. "设为项目" moves a folder's sessions in one step). */
-  sessionIds: z.z.array(id).max(PROJECT_LIMITS.memberBatch).optional()
+  sessionIds: z.z.array(id$1).max(PROJECT_LIMITS.memberBatch).optional()
 });
 z.z.object({
   name: z.z.string().trim().min(1).max(PROJECT_LIMITS.nameChars).optional(),
@@ -684,7 +694,7 @@ z.z.object({
   summary: z.z.string().max(200).optional()
 });
 z.z.object({
-  sessionIds: z.z.array(id).min(1).max(PROJECT_LIMITS.memberBatch),
+  sessionIds: z.z.array(id$1).min(1).max(PROJECT_LIMITS.memberBatch),
   via: ProjectMemberViaInputSchema.optional()
 });
 z.z.object({
@@ -694,15 +704,15 @@ z.z.object({
   /** Entry id (or `#seq`) this entry replaces. */
   supersedes: z.z.string().min(1).max(128).optional(),
   /** Stamped by the wrapper (the agent cannot fill it). Absent = written by the user. */
-  authorSessionId: id.optional()
+  authorSessionId: id$1.optional()
 });
 z.z.object({
   /** When set, only entries this session authored may be revoked. Absent = the owner. */
-  bySessionId: id.optional()
+  bySessionId: id$1.optional()
 });
-z.z.object({ teamId: id });
+z.z.object({ teamId: id$1 });
 const ProjectPresenceEntrySchema = z.z.object({
-  sessionId: id,
+  sessionId: id$1,
   title: z.z.string().max(200).nullable().optional(),
   agent: z.z.string().max(64).nullable().optional(),
   machine: z.z.string().max(200).nullable().optional(),
@@ -714,19 +724,19 @@ const ProjectPresenceEntrySchema = z.z.object({
   capabilities: z.z.array(z.z.string().max(64)).max(32).optional()
 });
 z.z.object({
-  machineId: id,
+  machineId: id$1,
   sessions: z.z.array(ProjectPresenceEntrySchema).max(PROJECT_LIMITS.presenceBatch),
   /** Sessions of this machine that stopped; their presence rows are marked `offline`. */
-  gone: z.z.array(id).max(PROJECT_LIMITS.presenceBatch).optional()
+  gone: z.z.array(id$1).max(PROJECT_LIMITS.presenceBatch).optional()
 });
 z.z.object({
-  fromSessionId: id,
-  toSessionId: id,
+  fromSessionId: id$1,
+  toSessionId: id$1,
   body: boundedText(PROJECT_LIMITS.messageBytes).pipe(z.z.string().min(1))
 });
 z.z.object({
-  sessionId: id,
-  messageIds: z.z.array(id).min(1).max(100)
+  sessionId: id$1,
+  messageIds: z.z.array(id$1).min(1).max(100)
 });
 z.z.object({
   full: z.z.enum(["0", "1", "true", "false"]).optional(),
@@ -765,9 +775,9 @@ function object(value) {
 function stamp(value) {
   return typeof value === "number" && Number.isFinite(value) && value >= 0;
 }
-function parseBuiltinTodo(raw, key) {
+function parseBuiltinTodo(raw, key2) {
   if (!object(raw) || raw.schemaVersion !== 1 || typeof raw.id !== "string" || !UUID.test(raw.id)) return null;
-  if (key !== void 0 && key !== BUILTIN_TODO_PREFIX + raw.id) return null;
+  if (key2 !== void 0 && key2 !== BUILTIN_TODO_PREFIX + raw.id) return null;
   if (typeof raw.title !== "string" || !raw.title.trim() || raw.title.length > TITLE_MAX_LENGTH) return null;
   if (typeof raw.note !== "string" || raw.note.length > NOTE_MAX_LENGTH) return null;
   if (raw.status !== "open" && raw.status !== "done") return null;
@@ -792,11 +802,11 @@ function encodeBuiltinTodo(todo) {
   for (const byte of bytes) binary += String.fromCharCode(byte);
   return btoa(binary);
 }
-function decodeBuiltinTodo(value, key) {
+function decodeBuiltinTodo(value, key2) {
   try {
     const binary = atob(value);
     const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
-    return parseBuiltinTodo(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)), key);
+    return parseBuiltinTodo(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)), key2);
   } catch {
     return null;
   }
@@ -804,12 +814,12 @@ function decodeBuiltinTodo(value, key) {
 function sortBuiltinTodos(records) {
   return [...records].sort((a, b) => a.order - b.order || a.id.localeCompare(b.id));
 }
-function createBuiltinTodoClient(credentials, options) {
-  const serverUrl = options.serverUrl.replace(/\/$/, "");
+function createBuiltinTodoClient(credentials, options2) {
+  const serverUrl = options2.serverUrl.replace(/\/$/, "");
   const token = credentials.token;
-  const clientId = options.clientId;
-  const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
-  const timeoutMs = options.timeoutMs ?? 15e3;
+  const clientId = options2.clientId;
+  const fetcher = options2.fetch ?? globalThis.fetch.bind(globalThis);
+  const timeoutMs = options2.timeoutMs ?? 15e3;
   async function request(path, mutations, allowNotFound = false) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -888,19 +898,19 @@ function createBuiltinTodoClient(credentials, options) {
   const pendingCreates = /* @__PURE__ */ new Map();
   async function get(id2) {
     if (!UUID.test(id2)) throw new BuiltinTodoError("validation", "Invalid Todo ID");
-    const key = BUILTIN_TODO_PREFIX + id2;
-    const raw = await request(`/v1/kv/${encodeURIComponent(key)}`, void 0, true);
+    const key2 = BUILTIN_TODO_PREFIX + id2;
+    const raw = await request(`/v1/kv/${encodeURIComponent(key2)}`, void 0, true);
     if (raw === void 0) return null;
-    const todo = object(raw) && typeof raw.value === "string" ? decodeBuiltinTodo(raw.value, key) : null;
-    if (!todo || !object(raw) || raw.key !== key || !Number.isSafeInteger(raw.version) || raw.version < 0) {
+    const todo = object(raw) && typeof raw.value === "string" ? decodeBuiltinTodo(raw.value, key2) : null;
+    if (!todo || !object(raw) || raw.key !== key2 || !Number.isSafeInteger(raw.version) || raw.version < 0) {
       throw new BuiltinTodoError("invalid-response", "Invalid Todo read response");
     }
     return { ...todo, version: raw.version };
   }
-  async function create(title, note = "", id2) {
-    const cleanTitle = title.trim();
+  async function create(title2, note2 = "", id2) {
+    const cleanTitle = title2.trim();
     if (id2 !== void 0 && !UUID.test(id2)) throw new BuiltinTodoError("validation", "Invalid Todo ID");
-    const payloadKey = JSON.stringify([cleanTitle, note, id2]);
+    const payloadKey = JSON.stringify([cleanTitle, note2, id2]);
     let pending = pendingCreates.get(payloadKey);
     if (pending?.operation) return pending.operation;
     if (!pending) {
@@ -909,7 +919,7 @@ function createBuiltinTodoClient(credentials, options) {
         schemaVersion: 1,
         id: id2 ?? crypto.randomUUID(),
         title: cleanTitle,
-        note,
+        note: note2,
         status: "open",
         order: 0,
         createdAt: now,
@@ -922,14 +932,14 @@ function createBuiltinTodoClient(credentials, options) {
     const entry = pending;
     const operation = (async () => {
       if (entry.attempted) {
-        const key = BUILTIN_TODO_PREFIX + entry.draft.id;
-        const existing = await request(`/v1/kv/${encodeURIComponent(key)}`, void 0, true);
+        const key2 = BUILTIN_TODO_PREFIX + entry.draft.id;
+        const existing = await request(`/v1/kv/${encodeURIComponent(key2)}`, void 0, true);
         if (existing !== void 0) {
-          const todo = object(existing) && typeof existing.value === "string" ? decodeBuiltinTodo(existing.value, key) : null;
-          if (!todo || !object(existing) || existing.key !== key || !Number.isSafeInteger(existing.version) || existing.version < 0) {
+          const todo = object(existing) && typeof existing.value === "string" ? decodeBuiltinTodo(existing.value, key2) : null;
+          if (!todo || !object(existing) || existing.key !== key2 || !Number.isSafeInteger(existing.version) || existing.version < 0) {
             throw new BuiltinTodoError("invalid-response", "Cannot confirm the previous Todo creation");
           }
-          if (id2 && (todo.title !== cleanTitle || todo.note !== note)) throw new BuiltinTodoError("conflict", "This Todo ID already has different content; read it before deciding");
+          if (id2 && (todo.title !== cleanTitle || todo.note !== note2)) throw new BuiltinTodoError("conflict", "This Todo ID already has different content; read it before deciding");
           return { ...todo, version: existing.version };
         }
       }
@@ -1172,8 +1182,202 @@ const ServerMigrateNoticeSchema = z.z.object({
   handoff: z.z.string().regex(/^vh1\.[A-Za-z0-9_-]{16,2048}\.[A-Za-z0-9_-]{43}$/),
   issuedAt: z.z.number().int().positive()
 });
+const ATTENTION_SESSION_CAPABILITY = "owner-board-v1";
+const ATTENTION_DISABLED_ERROR = "owner_board_disabled";
+const ATTENTION_LIMITS = {
+  titleChars: 120,
+  bodyBytes: 8 * 1024,
+  keyChars: 256,
+  options: { min: 2, max: 4 },
+  optionIdChars: 16,
+  optionLabelChars: 120,
+  optionDetailChars: 1e3,
+  links: 16,
+  linkRefChars: 2048,
+  linkLabelChars: 120,
+  snippetChars: 200,
+  noteChars: 2e3,
+  listMax: 200,
+  /** Open `needsOwner` items per session before the playbook asks the lead to merge or drop stale ones (§5.1 rule 6). */
+  openPerSessionSoftCap: 5
+};
+const ATTENTION_SOURCES = ["lead", "agent", "owner", "automation", "team"];
+const ATTENTION_KINDS = ["decision", "todo", "blocked", "report", "answer", "question", "request", "pin"];
+const OWNER_BOARD_POST_KINDS = ["decision", "todo", "report", "answer"];
+const OWNER_BOARD_RESOLVE_OUTCOMES = ["done", "answered", "dropped", "superseded"];
+const ATTENTION_BOARD_LOCAL_ID_PREFIX = "board-";
+function isAttentionBoardLocalId(localId) {
+  return typeof localId === "string" && localId.startsWith(ATTENTION_BOARD_LOCAL_ID_PREFIX);
+}
+const id = z.z.string().min(1).max(128);
+const title = z.z.string().trim().min(1).max(ATTENTION_LIMITS.titleChars);
+const bodyMd = z.z.string().max(ATTENTION_LIMITS.bodyBytes * 4).refine((v) => new TextEncoder().encode(v).length <= ATTENTION_LIMITS.bodyBytes, "body exceeds 8KB");
+const note = z.z.string().max(ATTENTION_LIMITS.noteChars);
+const requestId = z.z.string().min(1).max(128);
+const key = z.z.string().min(1).max(ATTENTION_LIMITS.keyChars);
+const AttentionOptionSchema = z.z.object({
+  id: z.z.string().trim().min(1).max(ATTENTION_LIMITS.optionIdChars),
+  label: z.z.string().trim().min(1).max(ATTENTION_LIMITS.optionLabelChars),
+  detail: z.z.string().max(ATTENTION_LIMITS.optionDetailChars).optional(),
+  recommended: z.z.boolean().optional()
+});
+const options = z.z.array(AttentionOptionSchema).min(ATTENTION_LIMITS.options.min).max(ATTENTION_LIMITS.options.max).refine((o) => new Set(o.map((x) => x.id)).size === o.length, "option ids must be unique");
+const ATTENTION_LINK_TYPES = ["task", "pr", "commit", "url", "panel"];
+const AttentionLinkSchema = z.z.object({
+  type: z.z.enum(ATTENTION_LINK_TYPES),
+  ref: z.z.string().trim().min(1).max(ATTENTION_LIMITS.linkRefChars),
+  label: z.z.string().max(ATTENTION_LIMITS.linkLabelChars).optional()
+});
+const links = z.z.array(AttentionLinkSchema).max(ATTENTION_LIMITS.links);
+const AttentionAnchorSchema = z.z.object({
+  localId: z.z.string().min(1).max(256).optional(),
+  messageId: z.z.string().min(1).max(128).optional(),
+  snippet: z.z.string().max(ATTENTION_LIMITS.snippetChars).optional()
+}).refine((a) => a.localId !== void 0 || a.messageId !== void 0, "anchor needs localId or messageId");
+const AttentionItemSchema = z.z.object({
+  id: z.z.string(),
+  sessionId: z.z.string(),
+  teamId: z.z.string().nullable(),
+  projectId: z.z.string().nullable(),
+  source: z.z.string(),
+  kind: z.z.string(),
+  key: z.z.string().nullable(),
+  title: z.z.string(),
+  bodyMd: z.z.string().nullable(),
+  options: z.z.array(AttentionOptionSchema.passthrough()).nullable(),
+  links: z.z.array(z.z.object({ type: z.z.string(), ref: z.z.string(), label: z.z.string().optional() }).passthrough()).nullable(),
+  anchor: z.z.object({ localId: z.z.string().optional(), messageId: z.z.string().optional(), snippet: z.z.string().optional() }).nullable(),
+  /** The lead's first in-stream reply to an owner question (auto-attached by the CLI, §4.4). */
+  firstReply: z.z.object({ localId: z.z.string().optional(), messageId: z.z.string().optional(), snippet: z.z.string().optional() }).nullable(),
+  replyToId: z.z.string().nullable(),
+  /** D5: drafted by the CLI from the lead's text (「自动识别」), not posted by the lead. No push until the lead confirms it. */
+  inferred: z.z.boolean().default(false),
+  needsOwner: z.z.boolean(),
+  state: z.z.string(),
+  ownerChoice: z.z.string().nullable(),
+  ownerNote: z.z.string().nullable(),
+  resolvedBy: z.z.string().nullable(),
+  /** The lead's `owner_board_resolve` note. */
+  resolveNote: z.z.string().nullable(),
+  /** Times the same `(sessionId, key)` was posted again and folded into this item. */
+  repostCount: z.z.number(),
+  createdAt: z.z.number(),
+  updatedAt: z.z.number(),
+  resolvedAt: z.z.number().nullable(),
+  pushedAt: z.z.number().nullable(),
+  /** Bumped on every mutation; clients keep the highest version per id. */
+  version: z.z.number()
+});
+z.z.object({
+  t: z.z.literal("attention-item"),
+  item: AttentionItemSchema
+});
+z.z.object({
+  sessionId: id,
+  source: z.z.enum(ATTENTION_SOURCES),
+  kind: z.z.enum(ATTENTION_KINDS),
+  title,
+  bodyMd: bodyMd.optional(),
+  options: options.optional(),
+  links: links.optional(),
+  anchor: AttentionAnchorSchema.optional(),
+  replyToId: id.optional(),
+  key: key.optional(),
+  requestId: requestId.optional(),
+  /**
+   * D5 draft: only the CLI's auto-detect path sets it (`owner_board_post` does
+   * not expose it). A repost of the key with `false` confirms the draft (and
+   * pushes once); a draft never downgrades a confirmed item.
+   */
+  inferred: z.z.boolean().default(false)
+}).refine((p) => p.kind !== "decision" || p.options !== void 0, { message: "decision needs 2-4 options", path: ["options"] });
+z.z.object({
+  title: title.optional(),
+  bodyMd: bodyMd.nullable().optional(),
+  appendMd: bodyMd.optional(),
+  options: options.nullable().optional(),
+  links: links.nullable().optional(),
+  /** Only `question` → `request` (the lead reclassifies an owner message, §4.4). */
+  kind: z.z.literal("request").optional(),
+  state: z.z.enum(["open", "in_progress", "answered"]).optional(),
+  firstReply: AttentionAnchorSchema.optional(),
+  requestId: requestId.optional()
+}).refine((p) => !(p.bodyMd !== void 0 && p.appendMd !== void 0), "use bodyMd or appendMd, not both");
+z.z.object({
+  outcome: z.z.enum(OWNER_BOARD_RESOLVE_OUTCOMES),
+  note: note.optional(),
+  /** Defaults to `lead`. */
+  by: z.z.enum(["lead", "auto-first-reply"]).optional(),
+  requestId: requestId.optional()
+});
+z.z.discriminatedUnion("action", [
+  z.z.object({ action: z.z.literal("choose"), choice: z.z.string().trim().min(1).max(ATTENTION_LIMITS.optionIdChars), note: note.optional() }),
+  z.z.object({ action: z.z.literal("resolve"), note: note.optional() }),
+  z.z.object({ action: z.z.literal("reopen"), note: note.optional() })
+]);
+z.z.object({
+  sessionId: id.optional(),
+  /** `open` (default) = open + in_progress; `active` adds the latest `answered`; `all` = everything. */
+  state: z.z.enum(["open", "active", "all"]).optional(),
+  needsOwner: z.z.enum(["1", "true", "0", "false"]).optional(),
+  /** Epoch ms; only items updated after it. */
+  since: z.z.coerce.number().int().nonnegative().optional(),
+  limit: z.z.coerce.number().int().min(1).max(ATTENTION_LIMITS.listMax).optional()
+});
+const OwnerBoardPostInputSchema = z.z.object({
+  kind: z.z.enum(OWNER_BOARD_POST_KINDS),
+  title,
+  body_md: bodyMd.optional(),
+  options: options.optional(),
+  links: links.optional(),
+  reply_to: id.optional(),
+  key: key.optional(),
+  anchor: z.z.union([z.z.literal("this_turn"), z.z.object({ localId: z.z.string().min(1).max(256) })]).optional(),
+  request_id: requestId
+}).refine((p) => p.kind !== "decision" || p.options !== void 0, { message: "decision needs 2-4 options", path: ["options"] });
+const OwnerBoardUpdateInputSchema = z.z.object({
+  id,
+  title: title.optional(),
+  body_md: bodyMd.optional(),
+  append_md: bodyMd.optional(),
+  options: options.optional(),
+  links: links.optional(),
+  state: z.z.enum(["open", "in_progress"]).optional(),
+  request_id: requestId
+}).refine((p) => !(p.body_md !== void 0 && p.append_md !== void 0), "use body_md or append_md, not both");
+const OwnerBoardResolveInputSchema = z.z.object({
+  id,
+  outcome: z.z.enum(OWNER_BOARD_RESOLVE_OUTCOMES),
+  note: note.optional(),
+  request_id: requestId
+});
+const OwnerBoardListInputSchema = z.z.object({
+  state: z.z.enum(["open", "all"]).optional(),
+  /** ISO-8601 or epoch ms. */
+  since: z.z.string().min(1).max(64).optional()
+});
+function ownerBoardPostToRest(sessionId, input, anchor) {
+  return {
+    sessionId,
+    source: "lead",
+    kind: input.kind,
+    title: input.title,
+    ...input.body_md !== void 0 ? { bodyMd: input.body_md } : {},
+    ...input.options ? { options: input.options } : {},
+    ...input.links ? { links: input.links } : {},
+    ...anchor ? { anchor } : {},
+    ...input.reply_to ? { replyToId: input.reply_to } : {},
+    ...input.key ? { key: input.key } : {},
+    requestId: input.request_id,
+    inferred: false
+  };
+}
 
 exports.AGENT_VERSION_SOURCES = AGENT_VERSION_SOURCES;
+exports.ATTENTION_DISABLED_ERROR = ATTENTION_DISABLED_ERROR;
+exports.ATTENTION_LIMITS = ATTENTION_LIMITS;
+exports.ATTENTION_SESSION_CAPABILITY = ATTENTION_SESSION_CAPABILITY;
+exports.AUTOMATION_ATTENTION_REASON_MAX_CHARS = AUTOMATION_ATTENTION_REASON_MAX_CHARS;
 exports.AUTOMATION_CLAIM_MAX_RUNS = AUTOMATION_CLAIM_MAX_RUNS;
 exports.AUTOMATION_DAEMON_CAPABILITY_PRECHECK = AUTOMATION_DAEMON_CAPABILITY_PRECHECK;
 exports.AUTOMATION_DEFAULT_LEASE_MS = AUTOMATION_DEFAULT_LEASE_MS;
@@ -1192,6 +1396,10 @@ exports.BUILTIN_TODO_DISCOVERY = BUILTIN_TODO_DISCOVERY;
 exports.BUILTIN_TODO_SKILL = BUILTIN_TODO_SKILL;
 exports.CODEX_STEER_CAPABILITY = CODEX_STEER_CAPABILITY;
 exports.HARNESS_INSTALL_CAPABILITY_VERSION = HARNESS_INSTALL_CAPABILITY_VERSION;
+exports.OwnerBoardListInputSchema = OwnerBoardListInputSchema;
+exports.OwnerBoardPostInputSchema = OwnerBoardPostInputSchema;
+exports.OwnerBoardResolveInputSchema = OwnerBoardResolveInputSchema;
+exports.OwnerBoardUpdateInputSchema = OwnerBoardUpdateInputSchema;
 exports.PI_STEER_CAPABILITY = PI_STEER_CAPABILITY;
 exports.PROJECT_SESSION_CAPABILITY = PROJECT_SESSION_CAPABILITY;
 exports.PROMPT_QUEUE_CAPABILITY = PROMPT_QUEUE_CAPABILITY;
@@ -1203,11 +1411,13 @@ exports.ServerMigrateNoticeSchema = ServerMigrateNoticeSchema;
 exports.createBuiltinTodoClient = createBuiltinTodoClient;
 exports.createEnvelope = createEnvelope;
 exports.getAgentCodeDefaults = getAgentCodeDefaults;
+exports.isAttentionBoardLocalId = isAttentionBoardLocalId;
 exports.isAutomationRunTerminal = isAutomationRunTerminal;
 exports.isClaudeOpus55Model = isClaudeOpus55Model;
 exports.isHarnessInstallId = isHarnessInstallId;
 exports.isInsideTeamWorktree = isInsideTeamWorktree;
 exports.normalizeAgentKey = normalizeAgentKey;
+exports.ownerBoardPostToRest = ownerBoardPostToRest;
 exports.rebaseTeamWorktreePath = rebaseTeamWorktreePath;
 exports.streamKeyOf = streamKeyOf;
 exports.supportsClaudeOpus55 = supportsClaudeOpus55;