@paigy/mcp 0.40.23 → 0.40.25

package/dist/{chunk-JLRBZZNT.js → chunk-GHSB2VP6.js}

@@ -1,9 +1,11 @@
 // ../../packages/schema/dist/index.js
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 import { z } from "zod";
 import { z as z3 } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { z as z2 } from "zod";
+import { z as z4 } from "zod";
+import { zodToJsonSchema as zodToJsonSchema2 } from "zod-to-json-schema";
 var OPTIONS_MIN = 2;
 var OPTIONS_MAX = 6;
 var OptionSchema = z.object({
@@ -54,32 +56,39 @@ function mcpInputSchema(s) {
 }
 var AskInputSchema = z2.object({
   id: z2.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: z2.string().uuid().optional().describe("The Goal this question is about \u2014 usually the one you are working on. The question goes onto that Goal and its answer comes back there. Omit it and Paigy places the question in the tree itself."),
+  parentId: z2.string().uuid().optional().describe("The Goal this question is about \u2014 usually the one you are working on. The question goes onto that Goal and its answer comes back there. Omit it and the question starts a new Goal of yours."),
   repo: z2.string().optional().describe("Optional repository context."),
   ask: z2.string().trim().min(1).max(1e4).describe(
-    "ONE question, and only what is needed to answer it. Several questions are several asks in the array, one each: an answer settles the one ask it was given in the shape that ask declares, so a person who answers the part of a bundled ask that interested them settles nothing and is asked again. Paigy reads every ask once and takes a bundled one apart into its own cards anyway \u2014 each question a Question on the one Goal the ask lands on, never a Goal of its own \u2014 but the words it splits are its reading, not yours. News, progress and findings are their own contact; ANY contact for a person already on a call JOINS that call, whatever channel you asked for, so several arrive as one call."
+    "ONE question, and only what is needed to answer it. Several questions are several asks in the array, one each: an answer settles the one ask it was given in the shape that ask declares, so a person who answers the part of a bundled ask that interested them settles nothing and is asked again. Paigy sends each ask exactly as you wrote it: a bundled ask arrives as one card. News, progress and findings are their own contact; ANY contact for a person already on a call JOINS that call, whatever channel you asked for, so several arrive as one call."
   ),
   options: z2.array(OptionInputSchema).min(1).max(6).optional(),
-  // YOUR VIEW OF ONE OR MANY, A HINT TO PAIGY'S READ (owner, 2026-10-02: "one and many makes sense...
-  // make sure the brain that formats is aware of how it should work"). Three independent fixes went
-  // out as "All three / 1 and 3 only / Just log it" because every card was pick-one. #2943 made this
-  // field override the read; no agent sent it, so nothing changed. The read now decides each card's
-  // shape (`goal/intake.ts` `answerOf`), and this reaches it as the agent's view, weighed, not obeyed.
+  // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
+  // brain_prompts.md §1: structured agent questions need no model). Every card was pick-one while no
+  // agent sent this; no read reshapes cards any more, so this is the card's shape, and the
+  // description says so plainly.
   select: z2.enum(["one", "many"]).optional().describe(
-    `Your view of how the options are answered: "one" to pick one, "many" to tick any number of them. A hint: Paigy's read decides each card's shape, a checklist when the options can all be wanted at once, a pick when choosing one rules out the others. The person can always answer in their own words as well. Ignored without options.`
+    'How the options are answered: "many" makes a checklist (they may want several, e.g. independent fixes), "one" (the default) a pick (choosing one rules out the others). Send "many" whenever more than one option could be wanted at once. The person can always answer in their own words as well. Ignored without options.'
   ),
   answers: z2.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
-    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. Needs parentId: the Goal the question is on. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. parentId is optional here: the question's own Goal is used. The reply is sent to them as it is; to also ask something new, send that as its own ask."
   )
 }).strict();
 var StartContactSchema = z2.object({
-  asks: z2.array(AskInputSchema).min(1).describe("The questions to pose, one per object. An ask with a parentId is filed on that Goal as it is; only an ask naming no Goal is placed in the tree by Paigy."),
+  asks: z2.array(AskInputSchema).min(1).describe("The questions to pose, one per object. An ask with a parentId is filed on that Goal as it is; an ask naming no Goal starts a new Goal of yours."),
   waiting: z2.enum(["none", "hard"]).default("none").describe("hard requests a call even when channel is notification; user permissions and ring cooldowns still apply."),
   channel: z2.enum(["notification", "call"]).default("notification")
 }).strict();
-var ContactSchema = z2.union([StartContactSchema, z2.object({ deliveryId: z2.string().uuid() }).strict()]);
+var ReceiveContactSchema = z2.object({
+  wait: z2.boolean().optional().describe(
+    "Only controls when this returns. true (the default when you send and acknowledge nothing): wait up to about 45 seconds for incoming communication addressed to you, and return as soon as some is available. false: return what is waiting now. It does not mean work is blocked, set urgency, or ask for a call. `waitOutcome` says which happened: `available`, `expired` (nothing arrived in the window; wait again without sending again), or `not_waited` (a hosted connection never holds a wait)."
+  ),
+  ackEventIds: z2.array(z2.string().uuid()).min(1).max(100).optional().describe(
+    "The exact eventIds of the events you have handled: an acknowledgment (ACK). Reading alone acknowledges nothing, so an event comes back until you acknowledge it; after that the next batch can come. Each recipient acknowledges separately, for itself only. A Question you owe is answered (an ask with `answers`), never acknowledged away: that id is refused until it is answered."
+  )
+}).strict();
+var ContactSchema = z2.union([StartContactSchema, z2.object({ deliveryId: z2.string().uuid() }).strict(), ReceiveContactSchema]);
 var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read, every one on the Goal the ask lands on; separate pieces of work are separate asks. An ask with no options that is not blocking is a report, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so). Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). Whether a card is a checklist or a pick is decided by Paigy's read: independent options they may want several of become a checklist, alternatives a pick. select:'many' or select:'one' tells it your view, a hint it weighs. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'select', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none starts a new Goal of yours. Notification returns immediately; collect answers by receiving (below). On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. Each ask is sent exactly as written, with no reading in between: a bundled ask arrives as one card, so separate questions are separate asks. An ask with no options that is not blocking is a report, never a claim on them, so no answer is owed and none should be awaited. A report reaches the person only when it answers something they asked you, or once the Goal is done; any other report is recorded as the Goal's progress and nobody is notified. So when the work is finished, mark the Goal done first, then send one message saying what is done and anything they need to do or check. On a Goal whose report card is still open, a report that does reach them is added to that card, with no new push. Send options (or waiting:'hard') when you actually need an answer. Each option's label must stand on its own \u2014 the person may see only the labels \u2014 so never a label that points into your text ('All three', 'Option 2', '1 and 3 only'). select:'many' makes the card a checklist, for independent options they may want several of; select:'one' (the default) a pick, for alternatives. The person can always answer in their own words, so never add an 'Other' option. If the person is already on a call, a contact that reaches them joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.\n\nRECEIVING: contact with no asks sends nothing and returns `events`, a limited batch of what is addressed to you (not a history page): `question`, a Question you owe (answer it with an ask whose `answers` is its questionId); `update`, something new on one of your Goals (a reply, an answer: read it with get_goal); `instruction`, a request or note sent to you. `hasMore` says more are waiting. Reading acknowledges nothing: once you have handled events, confirm their eventIds with contact({ackEventIds}), and the next batch can come. contact({}) waits up to about 45 seconds for something to arrive; contact({wait:false}) returns at once. It also lists work given to you that nobody has started (`assigned`; claim_goal starts it) and your work gone quiet (`stalled`).";
 var CreateGoalSchema = z3.object({
   outcome: z3.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -99,10 +108,6 @@ var CreateGoalSchema = z3.object({
    *  repo name. Delegated work inherits this from its parent Goal when omitted. */
   repo: z3.string().trim().min(1).max(200).optional()
 });
-var CreateGoalToolSchema = CreateGoalSchema.extend({
-  idempotencyKey: CreateGoalSchema.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
-}).strict();
-var CREATE_GOAL_DESCRIPTION = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass repo to anchor the work to a specific repository ("owner/repo" or repo name); delegated children inherit it. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
 var UpdateGoalSchema = z3.object({
   revision: z3.number().int().positive(),
   changes: z3.object({
@@ -126,7 +131,65 @@ var UpdateGoalSchema = z3.object({
   reason: z3.string().trim().min(1).max(2e3),
   operationId: z3.string().uuid().optional()
 }).strict();
-var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: z3.string().uuid() }).strict();
+var UpdateGoalToolSchema = z3.object({
+  goalId: z3.string().uuid(),
+  revision: UpdateGoalSchema.shape.revision,
+  changes: UpdateGoalSchema.shape.changes.innerType().pick({ progress: true, reviewed: true, dueAt: true, withdraw: true }).strict().refine((v) => Object.keys(v).length > 0),
+  reason: UpdateGoalSchema.shape.reason
+}).strict();
+var changedGoal = z3.string().uuid().describe("The Goal to change, as a read shows it.");
+var goalTitle = z3.string().trim().min(1).max(80).describe("The Goal's short display name: one to five words, how a person refers to it out loud.");
+var goalOutcome = z3.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+var CreateChange = z3.object({
+  kind: z3.literal("create"),
+  title: goalTitle,
+  outcome: goalOutcome,
+  ownerId: z3.string().trim().min(1).optional().describe("Who owns the work: an agent's participant (as who_is_working shows it) or the person's. Omitted: you."),
+  parentGoalId: z3.string().uuid().optional().describe("The Goal it belongs under. Omitted: a root."),
+  sourceEntryIds: z3.array(z3.string().uuid()).max(20).optional().describe("The whole Entries the work came from, ones you can read.")
+}).strict();
+var EditChange = z3.object({ kind: z3.literal("edit"), goalId: changedGoal, title: goalTitle.optional(), outcome: goalOutcome.optional() }).strict();
+var StateChange = z3.object({ kind: z3.literal("state"), goalId: changedGoal, state: z3.enum(["open", "completed", "canceled"]).describe(
+  "completed: the Goal's own work is done now (refused while required children are open); open: reopen it; canceled: it will not be done."
+) }).strict();
+var AssignChange = z3.object({ kind: z3.literal("assign"), goalId: changedGoal, ownerId: z3.string().trim().min(1).describe("The new owner's participant.") }).strict();
+var DeferChange = z3.object({ kind: z3.literal("defer"), goalId: changedGoal, until: z3.string().datetime({ offset: true }).nullable().describe(
+  "Postpone it until this instant (its owner is woken then), or null to take the postponement back."
+) }).strict();
+var MoveChange = z3.object({ kind: z3.literal("move"), goalId: changedGoal, parentGoalId: z3.string().uuid().nullable().describe(
+  "Its new parent, or null for a root. Only this Goal moves; its new parent's other children stay."
+) }).strict();
+var DependencyChange = z3.object({
+  kind: z3.literal("dependency"),
+  change: z3.enum(["add", "remove"]),
+  goalId: changedGoal,
+  dependsOnGoalId: z3.string().uuid().describe("The Goal it waits on."),
+  action: z3.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
+  reason: z3.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+}).strict();
+var read = { revision: z3.number().int().positive().optional() };
+var GoalChangeSchema = z3.discriminatedUnion("kind", [
+  CreateChange,
+  EditChange.extend(read),
+  StateChange.extend(read),
+  AssignChange.extend(read),
+  DeferChange.extend(read),
+  MoveChange.extend(read),
+  DependencyChange
+]);
+var editNames = (changes, ctx) => changes.forEach((c, i) => {
+  if (c.kind === "edit" && c.title === void 0 && c.outcome === void 0) {
+    ctx.addIssue({ code: z3.ZodIssueCode.custom, path: ["changes", i], message: "an edit supplies title, outcome, or both" });
+  }
+});
+var ManageGoalsSchema = z3.object({
+  requestId: z3.string().uuid().optional(),
+  changes: z3.array(GoalChangeSchema).min(1).max(50)
+}).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
+var ManageGoalsToolSchema = z3.object({
+  changes: z3.array(z3.discriminatedUnion("kind", [CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange])).min(1).max(50).describe("The changes, applied in order, each on its own.")
+}).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
+var MANAGE_GOALS_DESCRIPTION = "Create, edit, assign, organize or close work. Every change here changes Goals; answering, withdrawing or asking Questions stays in contact. Each change applies independently: a refused one names why (`results[i].error`, e.g. goal_revision_conflict, goal_children_open, goal_not_joined, goal_not_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until, or null); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change a Goal you own or have written on. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var ClaimGoalSchema = z3.object({ goalId: z3.string().uuid().optional() }).strict();
 var GetGoalSchema = z3.object({
   goalId: z3.string().uuid(),
@@ -139,34 +202,176 @@ var GetGoalSchema = z3.object({
   diagnose: z3.boolean().optional()
 }).strict();
 var GET_GOAL_DESCRIPTION = "Read one Goal without claiming it, including others (the ten most recent other contributors, with names, latest entry headlines and times): its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), `next`, the one step to take, and `more`, where to read further. A question in that conversation reads `open` (nothing yet), `answered` (a choice was made, and `answer` carries it), `replied` (they said something and the read settled the question on their words \u2014 NO option of yours was chosen, and the words are the reply line beside it, so read that before you act), or `closed`. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Every Goal of your person is readable, whichever of their agents owns it; another account's Goals are not disclosed.\n\ndiagnose: true is for when a read has CONFUSED you \u2014 not for the working loop. It adds `diagnosis`, which asks every reader that already answers a question about your work and NAMES the reader behind every value, so you never guess which of two places to look: what state your work is really in (the stored `goals.state` beside the derived `goal_execution_state`, which can differ); whether anything is armed to ring and when (`ladder_candidates`, with the ladder's own last decision); whether a wake fired for you and what it did (durable `wake.*` events, beside when your process was last heard from); and what has reached you (`list_waiting` \u2014 review flags, unstarted work, open questions, the person's newest words). Read `diagnosis.disagreements` FIRST: each one is two readers giving different values for the same fact, with both values and both sources, and it never chooses between them \u2014 that is yours to do, from the Goal's own history. `diagnosis.looked` names every reader asked, including any that could not answer, so an empty answer is never confused with a broken one.";
-var UPDATE_GOAL_DESCRIPTION = `Update a Goal you are on at an exact revision. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
-var CLAIM_GOAL_DESCRIPTION = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change its state; use update_goal with ownerParticipant when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
-var CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
-var CheckRepliesSchema = z3.object({}).strict();
+var UPDATE_GOAL_DESCRIPTION = "Report work on a Goal you are on, at an exact revision: progress, review acknowledgement, when to wake for it, and withdrawing a question of yours. What the Goal is (its title, outcome, state, owner, parent, dependencies) changes with manage_goals. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). Stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. progress says where the work stands. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision (contact({ackEventIds}) does the same for an `update` event). dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. Returns the Goal as get_goal reads it, at its new revision.";
+var CLAIM_GOAL_DESCRIPTION = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change it; use manage_goals (assign) when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
+var SearchToolSchema = z3.object({
+  query: z3.string().trim().min(1).max(500),
+  types: z3.array(z3.enum(["entry", "goal", "answer"])).min(1).optional(),
+  goalId: z3.string().uuid().optional(),
+  limit: z3.number().int().min(1).max(20).optional()
+}).strict();
+var SEARCH_DESCRIPTION = "Search your person's history across all of their agents: Entries (what anyone said or wrote, typed or spoken on a call), Goals (by title and outcome) and Answers (found by their Question or by the words that gave them). query is words to look for; records sharing more of its words rank first, and exact names work. types narrows it to entry, goal and/or answer (default: all three). goalId searches under one Goal: its Entries, its Questions' Answers, and it and its immediate children. limit is matches per type, 1 to 20 (default 8). Read-only. Each match carries its whole saved words, its ID and its links (an Answer carries its Question, the choice made and the Entries that support it); `omitted` counts what matched but was left out, so narrow the words or add a goalId to see it. Nothing found is not proof that nothing exists; a refused search says why. Sealed (encrypted) content is never searched or returned.";
+var WhoIsWorkingSchema = z3.object({}).strict();
 var AGENT_TOOLS = [
-  { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema(CheckRepliesSchema) },
+  { name: "who_is_working", description: "Read your person's agents that contributed in the last 24 hours, newest first: at most 30 agents and their five most recently touched Goals, with their latest entry headline and time. Use get_goal to read a Goal and its other contributors before starting overlapping work. Read-only; no arguments.", inputSchema: mcpInputSchema(WhoIsWorkingSchema) },
   { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
-  { name: "check_replies", description: CHECK_REPLIES_DESCRIPTION, inputSchema: mcpInputSchema(CheckRepliesSchema) },
-  { name: "create_goal", description: CREATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(CreateGoalToolSchema) },
+  { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION, inputSchema: mcpInputSchema(ManageGoalsToolSchema) },
   { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(ClaimGoalSchema) },
   { name: "get_goal", description: GET_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(GetGoalSchema) },
-  { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) }
+  { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) },
+  { name: "search", description: SEARCH_DESCRIPTION, inputSchema: mcpInputSchema(SearchToolSchema) }
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
 function serverInstructions(opts) {
   const calls = opts.waits ? "A Call holds one bounded window here; continue with contact({deliveryId}) to hold the next or reread that exact Delivery." : "A Call returns after one read; continue with contact({deliveryId}) to reread that exact Delivery.";
-  return `On startup and after a wake, call check_replies for the open Deliveries addressed to you, and claim_goal for your runnable or review-pending Goal and the conversation on it. get_goal rereads it without claiming. Every Goal of your person is open to you, whichever of their agents owns it: read it with get_goal, write on it (contact with its id as parentId, or update_goal progress), and once you have written on it you may change it too. Every read ends in \`next\`, the one step to take. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. ${calls} Evidence can repeat: reads do not acknowledge or hide it. Report progress and acknowledge review with update_goal, never as a contact. Never infer ringing from an open Call Delivery. Soft waiting and re-presentation are unsupported. Your user is remote. Always interact with the user through Paigy. For decisions, approvals, or questions, contact them with structured options. Never assume anyone is reading the terminal stdout.
+  return `On startup and after a wake, call contact({wait:false}) for the events addressed to you (acknowledge the ones you handled with contact({ackEventIds})), and claim_goal for your runnable or review-pending Goal and the conversation on it. get_goal rereads it without claiming. Every Goal of your person is open to you, whichever of their agents owns it: read it with get_goal, write on it (contact with its id as parentId, or update_goal progress), and once you have written on it you may change it too (manage_goals). Create, edit, assign, organize or close work with manage_goals, never as a contact. Every read ends in \`next\`, the one step to take. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. ${calls} Events repeat until you acknowledge them: reading alone acknowledges nothing. Report progress with update_goal, never as a contact. Never infer ringing from an open Call Delivery. Soft waiting and re-presentation are unsupported. Your user is remote. Always interact with the user through Paigy. For decisions, approvals, or questions, contact them with structured options. Never assume anyone is reading the terminal stdout.
 
 HOW TO ASK:
 1. One question per ask. Five questions are five objects in \`asks\`, in one contact, so each can be answered on its own; one question with five parts settles nothing until all five are answered.
 2. Name the Goal you are working on as the ask's \`parentId\`: the question goes onto that Goal and its answer comes back there. Without one, Paigy places it.
 3. \`waiting: hard\` only for a decision you are blocked on; \`waiting: none\` for a question you can keep working around.
-4. Never hold the process open with while-loops. For an open Call with a pending decision, follow its \`next\` with another bounded \`contact({deliveryId})\` tool call; a returned wait window is not a completed conversation. STOP REREADING when a window comes back with nothing new said \u2014 they are not typing, the question stays open, and its answer reaches you on the Goal. Otherwise, yield only with a working listener or scheduled wakeup, and collect answers with \`check_replies\` or \`claim_goal\` on that wake.
+4. Never hold the process open with while-loops. For an open Call with a pending decision, follow its \`next\` with another bounded \`contact({deliveryId})\` tool call; a returned wait window is not a completed conversation. STOP REREADING when a window comes back with nothing new said \u2014 they are not typing, the question stays open, and its answer reaches you on the Goal. Otherwise, yield only with a working listener or scheduled wakeup, and collect answers with \`contact({wait:false})\` or \`claim_goal\` on that wake.
 5. One ask, one row. Never restate a question that is still waiting inside a new contact: keep waiting on the original, or the answer lands on one copy and the other stays open.
 6. Read the Goal's conversation before asking. Never ask again what was answered or already shipped \u2014 and tell its states apart: \`answered\` carries the choice in \`answer\`, while \`replied\` means they said something and chose none of your options, so that question is still yours to settle and their words are the line beside it.
-7. A question carries its options. Without them it reaches the person as a bare title nobody can answer. Each option names its choice in full -- never \`All three\` or \`Option 2\`. Paigy's read decides whether a card is a checklist (options they may want several of) or a pick (one rules out the others); \`select: "many"\` or \`"one"\` is your view, a hint it weighs. They can always answer in their own words, so no "Other" option.
+7. A question carries its options. Without them it reaches the person as a bare title nobody can answer. Each option names its choice in full -- never \`All three\` or \`Option 2\`. \`select: "many"\` makes the card a checklist (options they may want several of); \`"one"\`, the default, a pick (one rules out the others). Your ask is sent exactly as you wrote it. They can always answer in their own words, so no "Other" option.
 8. A diagnosis says when, why and how it happens, then proposes one fix. Never options first.`;
 }
+var id = z4.string().uuid();
+var key = z4.string().min(1).max(40);
+var participant = z4.string().regex(/^(human|agent):.+$/, "a participant ID such as agent:<uuid>");
+var SourceSchema = z4.object({ entryId: id }).strict();
+var ResultRefSchema = z4.union([z4.object({ id }).strict(), z4.object({ local: key }).strict()]);
+var NodeRefSchema = z4.object({ type: z4.enum(["goal", "question"]), id }).strict();
+var DependencySchema = z4.object({
+  blocker: NodeRefSchema,
+  blocked: NodeRefSchema,
+  action: z4.enum(["start", "complete", "answer"]),
+  reason: z4.string().max(500).optional()
+}).strict();
+var goalState = z4.enum(["open", "completed", "canceled"]);
+var existingGoalChanges = [
+  z4.object({ kind: z4.literal("edit"), goalId: id, title: z4.string().min(1).max(120).optional(), outcome: z4.string().min(1).optional() }).strict().refine((c) => c.title !== void 0 || c.outcome !== void 0, "an edit changes the title or the outcome"),
+  z4.object({ kind: z4.literal("state"), goalId: id, state: goalState }).strict(),
+  z4.object({ kind: z4.literal("assign"), goalId: id, ownerId: participant }).strict(),
+  z4.object({ kind: z4.literal("defer"), goalId: id, until: z4.string().datetime().nullable() }).strict(),
+  z4.object({ kind: z4.literal("move"), goalId: id, parentGoalId: id.nullable() }).strict(),
+  z4.object({
+    kind: z4.literal("dependency"),
+    change: z4.enum(["add", "remove"]),
+    goalId: id,
+    dependsOnGoalId: id,
+    action: z4.enum(["start", "complete"]),
+    reason: z4.string().max(500).optional()
+  }).strict()
+];
+var BrainGoalChangeSchema = z4.union([
+  // newSession: Paigy starts a session to own it (owner, 2026-10-06); until it has, the person owns it.
+  z4.object({
+    kind: z4.literal("create"),
+    outcome: z4.string().min(1),
+    title: z4.string().min(1).max(120),
+    ownerId: participant,
+    parentGoal: ResultRefSchema.nullable(),
+    newSession: z4.literal(true).optional()
+  }).strict(),
+  ...existingGoalChanges
+]);
+var option = z4.object({ id: z4.string().min(1).max(40), label: z4.string().min(1), hint: z4.string().optional() }).strict();
+var QuestionChangeSchema = z4.union([
+  z4.object({
+    kind: z4.literal("create"),
+    text: z4.string().min(1),
+    answererId: participant,
+    goal: ResultRefSchema.optional(),
+    blocks: z4.array(z4.object({ question: ResultRefSchema }).strict()),
+    options: z4.array(option).min(2).optional(),
+    pickMode: z4.enum(["one", "many", "rank"]).optional()
+  }).strict().refine((c) => c.options === void 0 === (c.pickMode === void 0), "options and pickMode come together"),
+  z4.object({ kind: z4.literal("edit"), questionId: id, text: z4.string().min(1) }).strict(),
+  z4.object({ kind: z4.literal("assign"), questionId: id, answererId: participant }).strict(),
+  z4.object({ kind: z4.literal("withdraw"), questionId: id }).strict(),
+  z4.object({ kind: z4.literal("dependency"), change: z4.enum(["add", "remove"]), edge: DependencySchema }).strict()
+]);
+var lessonScope = z4.union([
+  z4.object({ kind: z4.literal("user") }).strict(),
+  z4.object({ kind: z4.literal("goal"), goal: ResultRefSchema }).strict()
+]);
+var LessonChangeSchema = z4.union([
+  z4.object({ kind: z4.literal("remember"), text: z4.string().min(1), scope: lessonScope }).strict(),
+  z4.object({ kind: z4.literal("revise"), lessonId: id, text: z4.string().min(1), scope: lessonScope }).strict(),
+  z4.object({ kind: z4.literal("withdraw"), lessonId: id }).strict()
+]);
+var BrainNextSchema = z4.object({
+  instructions: z4.array(z4.object({ entryKeys: z4.array(key).min(1) }).strict()),
+  say: z4.array(key),
+  then: z4.enum(["listen", "hold", "end", "none"]),
+  waitFor: z4.array(ResultRefSchema),
+  reason: z4.string()
+}).strict();
+var messageBase = {
+  key,
+  text: z4.string().min(1),
+  goals: z4.array(ResultRefSchema),
+  questions: z4.array(ResultRefSchema),
+  entryKeys: z4.array(key),
+  obligationIds: z4.array(id)
+};
+var BrainMessageSchema = z4.union([
+  z4.object({ ...messageBase, to: z4.object({ kind: z4.literal("user") }).strict() }).strict(),
+  z4.object({
+    ...messageBase,
+    to: z4.object({ kind: z4.literal("agent"), agentId: z4.string().regex(/^agent:(?!paigy$)\S+$/) }).strict(),
+    call: z4.object({ callId: id, listen: z4.literal(true) }).strict().optional()
+  }).strict()
+]);
+var BrainSearchSchema = z4.object({
+  query: z4.string().min(1).max(500),
+  within: z4.array(z4.enum(["entries", "goals", "answers"])).min(1),
+  goalId: id.optional()
+}).strict();
+var BrainResultSchema = z4.object({
+  messages: z4.array(BrainMessageSchema),
+  entries: z4.array(z4.object({ key, sources: z4.array(SourceSchema).min(1), goals: z4.array(ResultRefSchema) }).strict()),
+  questions: z4.array(z4.object({ key, entryKeys: z4.array(key), change: QuestionChangeSchema }).strict()),
+  answers: z4.array(z4.object({
+    question: ResultRefSchema,
+    entryKeys: z4.array(key).min(1),
+    summary: z4.string().min(1),
+    selectedOptionIds: z4.array(z4.string().min(1)).optional()
+  }).strict()),
+  goals: z4.array(z4.object({ key, entryKeys: z4.array(key), change: BrainGoalChangeSchema }).strict()),
+  feedback: z4.array(z4.object({ entryKeys: z4.array(key).min(1) }).strict()),
+  lessons: z4.array(z4.object({ entryKeys: z4.array(key).min(1), change: LessonChangeSchema }).strict()),
+  next: BrainNextSchema,
+  search: BrainSearchSchema.optional()
+}).strict();
+var str = z4.string();
+var strs = z4.array(z4.string());
+var CompactResultSchema = z4.object({
+  next: z4.object({ say: strs, then: z4.enum(["listen", "hold", "end", "none"]), waitFor: strs, reason: str, instructions: strs }).strict(),
+  messages: z4.array(z4.object({ key: str, to: str, text: str, about: strs, entries: strs, owed: strs, inviteToCall: z4.boolean() }).strict()),
+  entries: z4.array(z4.object({ key: str, from: str, on: strs }).strict()),
+  answers: z4.array(z4.object({ question: str, entries: strs, summary: str, picked: strs }).strict()),
+  changes: z4.array(z4.object({
+    key: str,
+    what: z4.enum(["goal", "question", "lesson"]),
+    op: z4.enum(["create", "edit", "assign", "open", "complete", "cancel", "defer", "move", "block", "unblock", "withdraw", "remember", "revise"]),
+    id: str,
+    text: str,
+    title: str,
+    who: str,
+    under: str,
+    gate: z4.enum(["start", "complete", "answer", "none"]),
+    options: z4.array(z4.object({ id: str, label: str }).strict()),
+    pick: z4.enum(["one", "many", "rank", "words"]),
+    entries: strs
+  }).strict()),
+  feedback: z4.array(strs),
+  search: z4.object({ query: str, within: strs, goal: str }).strict()
+}).strict();
+var COMPACT_RESULT_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(CompactResultSchema, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -179,22 +384,24 @@ function entryWords(entry) {
     const description = plain.description;
     const parts = [title, ...Array.isArray(description) ? description : []].filter((v) => typeof v === "string");
     if (parts.length) return parts.join("\n\n");
+    const line = plain.line;
+    if (typeof line === "string" && line.trim()) return line;
   }
   return entry.sources.map((source) => source.text).join("\n");
 }
 var LIVE_MS = 3 * 6e4;
 var WORKING_MS = 60 * 6e4;
-var ContextSchema = z4.object({
-  title: z4.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
-  description: z4.array(z4.string().min(1)).describe(
+var ContextSchema = z5.object({
+  title: z5.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
+  description: z5.array(z5.string().min(1)).describe(
     "Semantic chunks of detail (each a standalone, non-empty piece). The user can select chunks to ask you to expand. MAY BE EMPTY: a claim whose whole content is its heading \u2014 a single sentence \u2014 has no body, and saying so beats repeating the heading underneath itself. That repeat is what `min(1)` used to force, at 2x the storage, with every reader subtracting it back out at render time."
   )
 });
-var ParticipantSchema = z4.object({
-  kind: z4.enum(["human", "agent"]),
-  id: z4.string()
+var ParticipantSchema = z5.object({
+  kind: z5.enum(["human", "agent"]),
+  id: z5.string()
 });
-var TransformSchema = z4.enum([
+var TransformSchema = z5.enum([
   "structure",
   // shape intent into an answer contract; pick channel/urgency — broker `ask`, `select` shapes, `points`
   "request_more",
@@ -210,13 +417,13 @@ var TransformSchema = z4.enum([
   "summarize"
   // reduce volume, keep decision value — 30-turn cap, spoken briefing
 ]);
-var VisualSchema = z4.object({
-  url: z4.string().url(),
-  label: z4.string().optional()
+var VisualSchema = z5.object({
+  url: z5.string().url(),
+  label: z5.string().optional()
 });
-var NotifyLevelSchema = z4.enum(["inbox", "push", "banner", "call"]);
-var SelectShapeSchema = z4.enum(["one", "many", "rank", "confirm", "text"]);
-var ReceiptEventSchema = z4.enum([
+var NotifyLevelSchema = z5.enum(["inbox", "push", "banner", "call"]);
+var SelectShapeSchema = z5.enum(["one", "many", "rank", "confirm", "text"]);
+var ReceiptEventSchema = z5.enum([
   "delivered",
   // the bundle reached the recipient at some level
   "seen",
@@ -246,47 +453,47 @@ var ReceiptEventSchema = z4.enum([
   // be rewound by a writer that forgot to advance it.
   "restarted"
 ]);
-var AttentionSchema = z4.object({
+var AttentionSchema = z5.object({
   urgency: NotifyLevelSchema,
   /** The required answer shape, or null for a plain notify that asks nothing back. */
   select: SelectShapeSchema.nullable(),
   /** Coverage contract (#396) — points the answer must address; null = none declared. */
-  points: z4.array(z4.string()).nullable(),
+  points: z5.array(z5.string()).nullable(),
   /** Whether the ask blocks the sender — what lets arbitration escalate it on silence. */
-  blocking: z4.boolean(),
+  blocking: z5.boolean(),
   /** Reserved (docs/model/model.md lists it): a response deadline. No row column yet — a later Phase 2
    *  slice wires it; optional so today's rows/callers project cleanly. */
-  deadline: z4.string().datetime().nullable().optional()
+  deadline: z5.string().datetime().nullable().optional()
 });
-var NotifyRequestFields = z4.object({
+var NotifyRequestFields = z5.object({
   /** Plaintext message content. Present on the plaintext path (today's shape);
    *  ABSENT on the E2EE path, where the sealed `envelope` below carries it. The
    *  superRefine at the bottom enforces exactly one of the two. */
   context: ContextSchema.optional(),
-  options: z4.array(OptionInputSchema).min(OPTIONS_MIN).max(OPTIONS_MAX).optional().describe(
+  options: z5.array(OptionInputSchema).min(OPTIONS_MIN).max(OPTIONS_MAX).optional().describe(
     "The choices, in order \u2014 required when select is 'one'/'many'/'rank', omitted otherwise. Ids are assigned automatically by position ('1', '2', \u2026); the user's answer references them as optionId(s)."
   ),
-  points: z4.array(z4.string().min(1)).optional().describe(
+  points: z5.array(z5.string().min(1)).optional().describe(
     "The distinct things you need answered, each a short phrase \u2014 on a call the broker keeps the conversation going until each is addressed, and the reply reports which were covered, so a half-answer is never silently returned as final. Omit for single-part asks."
   ),
-  visuals: z4.array(VisualSchema).optional().describe(
+  visuals: z5.array(VisualSchema).optional().describe(
     "Images attached to the message itself \u2014 context for the whole question (a screenshot, a chart). For a preview on one selectable choice, use that option's `html`/`image` instead."
   ),
   /** Git repo the agent is working in ("owner/name"). Local MCP fills this from the checkout — omit unless overriding. */
-  repo: z4.string().optional(),
+  repo: z5.string().optional(),
   /** Git branch the agent is on. Local MCP fills this from the checkout — omit unless overriding. */
-  branch: z4.string().optional(),
+  branch: z5.string().optional(),
   /** Continue an existing conversation — the id of any notification in it (its root
    *  is the conversation's identity). Omitted = start a new conversation. Renamed
    *  from `parentId` (2026-08-03): one linkage system, the parent; the API edge
    *  still accepts the old name from older clients. */
-  parentId: z4.string().uuid().optional(),
+  parentId: z5.string().uuid().optional(),
   /** The durable outcome this contact advances. Optional during the notification-to-Work
    *  migration; when present, a blocking ask creates a DecisionNeed for this Work. */
-  workId: z4.string().uuid().optional(),
+  workId: z5.string().uuid().optional(),
   /** Target Goal scope. During staged migration this is accepted by the shared contract but
    * target delivery activation remains model-gated; workId and goalId are mutually exclusive. */
-  goalId: z4.string().uuid().optional(),
+  goalId: z5.string().uuid().optional(),
   urgency: NotifyLevelSchema.default("inbox").describe(
     "The level you're requesting \u2014 the user's account permissions + session mode can lower it. 'inbox' (default) = sits silently in the inbox for the user to get to. 'push' = a quiet passive push (lands in Notification Center, no sound) \u2014 a gentle heads-up. 'banner' = a time-sensitive banner/lock-screen push with sound (a 'paige') they tap to open \u2014 use when you need them soon-ish but it's not worth ringing them. 'call' = rings the user's phone now (a CallKit voice call) \u2014 use only when you genuinely need them in the moment (blocked and waiting, time-sensitive). context.title is what they see on the banner/ring, so make it specific."
   ),
@@ -294,7 +501,7 @@ var NotifyRequestFields = z4.object({
    *  visible and marks it needs_input. Renamed from the old `parentId` (2026-08-03)
    *  when `parentId` became the conversation handle: `parentId` says WHERE, this
    *  says HOW. */
-  clarifies: z4.string().optional(),
+  clarifies: z5.string().optional(),
   select: SelectShapeSchema.optional().describe(
     "How the user answers \u2014 required on the fully-shaped form, pick the shape that fits the question: 'one' = pick one option, 'many' = pick several, 'rank' = pick & order (each needs `options`); 'confirm' = yes/no or approve/deny; 'text' = free-form reply only (status updates, open questions). 'confirm' and 'text' take no options. Omit only when sending the simplified `ask` form \u2014 the broker picks the shape."
   ),
@@ -308,20 +515,20 @@ var NotifyRequestFields = z4.object({
   // (docs/brain/broker/agenda-design.md) — not by a wire cap the agent has to pre-summarize under.
   // Owner, 2026-07-28: "our actual limitation on how long something is to the user should
   // come from the broker splitting and summarizing." The cap that remains is a size guard.
-  ask: z4.string().min(1).max(1e4).optional().describe(
+  ask: z5.string().min(1).max(1e4).optional().describe(
     'SIMPLIFIED FORM \u2014 state in plain prose what you need to learn from the user and why it matters now (e.g. "I need to know whether to deploy the auth fix \u2014 tests are green, staging verified"). Write as much as the situation needs (up to 10k characters) \u2014 Paigy breaks it into topics and reads it back a few sentences at a time; do NOT pre-summarize it into one line. Paigy derives the title, answer shape, options, and delivery channel for you. Mutually exclusive with context/select/options \u2014 send one form or the other.'
   ),
-  needs: z4.array(z4.string().min(1)).optional().describe(
+  needs: z5.array(z5.string().min(1)).optional().describe(
     "With `ask` only: the distinct things you need answered when the ask is multi-part \u2014 becomes the coverage contract (`points`), so a half-answer is never silently final."
   ),
-  urgencyHint: z4.enum(["whenever", "soon", "now"]).optional().describe(
+  urgencyHint: z5.enum(["whenever", "soon", "now"]).optional().describe(
     "With `ask` only: how urgently you need the answer \u2014 'whenever' (inbox), 'soon' (worth a heads-up), 'now' (you're blocked this minute). A hint, not a command: the user's settings still have the final word."
   ),
   /** #575: the ONE self-report that replaces urgencyHint + blocking — what happens
    *  to the agent's work while it waits. Normalized server-side into those two
    *  fields (normalizeWaiting) so everything downstream is untouched; explicit
    *  urgencyHint/blocking win when both are sent. */
-  waiting: z4.enum(["none", "soft", "hard"]).optional().describe(
+  waiting: z5.enum(["none", "soft", "hard"]).optional().describe(
     "With `ask`: what happens to your work while you wait. 'none' = you're just informing the user. 'soft' = you'd like an answer but can keep working. 'hard' = you are stopped until they answer (reaches them urgently and escalates to a real phone call if unanswered). Replaces urgencyHint + blocking \u2014 send this one field."
   ),
   /** Δ9b (#895): HOLD this claim so the sender can correct the plan before anyone is
@@ -329,98 +536,98 @@ var NotifyRequestFields = z4.object({
    *  holding by default would charge every quiet claim that minute before any agent could
    *  correct anything. Ignored for `waiting: 'hard'`: a blocking ask rings on what we have,
    *  and the enrichment can still land mid-call (#781 re-plans the unspoken tail). */
-  confirm: z4.boolean().optional().describe(
+  confirm: z5.boolean().optional().describe(
     "Hold this one so you can correct the plan before the user is interrupted. The response comes back with `held: true` and the plan; POST the confirm route to release it (with options/visuals/urgency corrections, or nothing at all). If you never do, it is announced anyway a couple of minutes later. Ignored when waiting is 'hard'."
   ),
   /** #575: a RELAY of the user's explicitly stated preference, never the agent's
    *  choice. Outranks waiting in both directions: 'call' rings even for a
    *  waiting:'none' "call me when it's done"; 'message' never rings even for
    *  waiting:'hard'. */
-  channel: z4.enum(["call", "message"]).optional().describe(
+  channel: z5.enum(["call", "message"]).optional().describe(
     "Only if the user explicitly said how to reach them \u2014 'call me' \u2192 'call', 'just message/text me' \u2192 'message'. Omit otherwise; Paigy picks."
   ),
-  confirmStyle: z4.enum(["yesno", "approve"]).default("yesno").describe(
+  confirmStyle: z5.enum(["yesno", "approve"]).default("yesno").describe(
     "Labels for a select:'confirm' paige \u2014 'yesno' (Yes/No) or 'approve' (Approve/Deny). Ignored unless select is 'confirm'."
   ),
-  blocking: z4.boolean().default(false).describe(
+  blocking: z5.boolean().default(false).describe(
     "Set true when real downstream work is stuck behind this specific decision \u2014 you can't make meaningful progress until it's answered. This is the real signal for how urgently the user should be reached; it's what the premier use case (an agent that stays unblocked instead of going idle) depends on. Independent of `urgency`: a `banner`-level question can still be `blocking` (something IS stuck, just not time-critical enough to ring for immediately) \u2014 if it goes unanswered a while, Paigy escalates it to a real call using this flag rather than guessing from how many other things happen to be pending. Leave false for anything you could work around, defer, or where other useful work exists meanwhile."
   )
 });
 var NotifyRequestSchema = NotifyRequestFields.superRefine((r, ctx) => {
-  if (r.workId && r.goalId) ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["goalId"], message: "pass goalId or workId, not both" });
+  if (r.workId && r.goalId) ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["goalId"], message: "pass goalId or workId, not both" });
   if (r.ask !== void 0) {
     for (const f of ["context", "select", "points"]) {
       if (r[f] !== void 0)
-        ctx.addIssue({ code: z4.ZodIssueCode.custom, path: [f], message: `the simplified \`ask\` form takes no ${f} \u2014 the broker derives the answer shape from your prose. Drop ${f} and say it in \`ask\` instead ("should I\u2026" for approve/deny, "which of these\u2026" for a pick), passing \`options\` when you're offering concrete alternatives.` });
+        ctx.addIssue({ code: z5.ZodIssueCode.custom, path: [f], message: `the simplified \`ask\` form takes no ${f} \u2014 the broker derives the answer shape from your prose. Drop ${f} and say it in \`ask\` instead ("should I\u2026" for approve/deny, "which of these\u2026" for a pick), passing \`options\` when you're offering concrete alternatives.` });
     }
     return;
   }
   if (r.needs !== void 0 || r.urgencyHint !== void 0)
-    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["needs"], message: "needs/urgencyHint belong to the simplified `ask` form \u2014 with a shaped request use points/urgency" });
+    ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["needs"], message: "needs/urgencyHint belong to the simplified `ask` form \u2014 with a shaped request use points/urgency" });
   if (!r.context)
-    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["context"], message: "context is required (plaintext path)" });
+    ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["context"], message: "context is required (plaintext path)" });
   if (!r.select)
-    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["select"], message: "select is required on the shaped form" });
+    ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["select"], message: "select is required on the shaped form" });
   const needsOptions = r.select === "one" || r.select === "many" || r.select === "rank";
   if (needsOptions && !r.options?.length)
-    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["options"], message: `select:'${r.select}' requires options` });
+    ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["options"], message: `select:'${r.select}' requires options` });
   if (!needsOptions && r.options?.length)
-    ctx.addIssue({ code: z4.ZodIssueCode.custom, path: ["options"], message: `select:'${r.select}' takes no options` });
+    ctx.addIssue({ code: z5.ZodIssueCode.custom, path: ["options"], message: `select:'${r.select}' takes no options` });
 });
-var NotifyStatusSchema = z4.enum(["pending", "answered", "ignored"]);
-var AgentStateSchema = z4.enum(["idle", "in_progress", "completed", "needs_input"]);
-var TurnSchema = z4.object({
-  prompt: z4.string(),
-  reply: z4.string()
+var NotifyStatusSchema = z5.enum(["pending", "answered", "ignored"]);
+var AgentStateSchema = z5.enum(["idle", "in_progress", "completed", "needs_input"]);
+var TurnSchema = z5.object({
+  prompt: z5.string(),
+  reply: z5.string()
 });
-var UserAnswerSchema = z4.discriminatedUnion("kind", [
-  z4.object({ kind: z4.literal("option"), optionId: z4.string(), label: z4.string().optional() }),
-  z4.object({ kind: z4.literal("text"), text: z4.string() }),
-  z4.object({ kind: z4.literal("ignored") }),
-  z4.object({ kind: z4.literal("multi"), optionIds: z4.array(z4.string()), labels: z4.array(z4.string()).optional() }),
-  z4.object({ kind: z4.literal("ranked"), optionIds: z4.array(z4.string()), labels: z4.array(z4.string()).optional() }),
-  z4.object({ kind: z4.literal("clarify"), chunks: z4.array(z4.string()).min(1) }),
-  z4.object({ kind: z4.literal("confirm"), approved: z4.boolean() }),
-  z4.object({ kind: z4.literal("turns"), turns: z4.array(TurnSchema).min(1) }),
+var UserAnswerSchema = z5.discriminatedUnion("kind", [
+  z5.object({ kind: z5.literal("option"), optionId: z5.string(), label: z5.string().optional() }),
+  z5.object({ kind: z5.literal("text"), text: z5.string() }),
+  z5.object({ kind: z5.literal("ignored") }),
+  z5.object({ kind: z5.literal("multi"), optionIds: z5.array(z5.string()), labels: z5.array(z5.string()).optional() }),
+  z5.object({ kind: z5.literal("ranked"), optionIds: z5.array(z5.string()), labels: z5.array(z5.string()).optional() }),
+  z5.object({ kind: z5.literal("clarify"), chunks: z5.array(z5.string()).min(1) }),
+  z5.object({ kind: z5.literal("confirm"), approved: z5.boolean() }),
+  z5.object({ kind: z5.literal("turns"), turns: z5.array(TurnSchema).min(1) }),
   /** An auto-answer derived from the user's PAST decisions (docs/brain/broker/precedent-design.md §2):
    *  delivered through the same settle/await path as a human answer, carrying the judge's
    *  derivation and the precedent ids it grew from. Always paired with a visible trail
    *  card the user can reply to — the broker never overrides the user. */
-  z4.object({ kind: z4.literal("precedent"), answer: z4.string(), derivation: z4.string(), sources: z4.array(z4.string()).min(1) })
+  z5.object({ kind: z5.literal("precedent"), answer: z5.string(), derivation: z5.string(), sources: z5.array(z5.string()).min(1) })
 ]);
-var IntentSchema = z4.object({
+var IntentSchema = z5.object({
   // The full vocabulary the bot's mapper emits (mapper.INTENT_KINDS) — the schema lagged
   // it by two ("detail", "feedback"), and because the settle handler parsed the array
   // all-or-nothing, ONE feedback act silently dropped EVERY intent on the call,
   // questions included. Found auditing five calls' stored feedback, 2026-08-01.
-  kind: z4.enum(["defer", "delegate", "channel", "question", "detail", "feedback", "command", "control"]),
-  detail: z4.string(),
+  kind: z5.enum(["defer", "delegate", "channel", "question", "detail", "feedback", "command", "control"]),
+  detail: z5.string(),
   /** Defer only: seconds until the callback the caller asked for, when something upstream
    *  already read the time. Nothing sets it today (#397 documented an MCP parser that was
    *  never written) — the API reads the defer's `detail` itself with `notes/when.ts`
    *  (`parseDelay`, #1292), and a value here simply wins over that reading. */
-  dueInSeconds: z4.number().int().positive().optional(),
+  dueInSeconds: z5.number().int().positive().optional(),
   /** Feedback only (#812): WHICH failure the complaint names — typed by the mapper that
-   *  already read the utterance, so `feedback_from_call.kind` stops defaulting to
+   *  already read the utterance, so `signals.kind` stops defaulting to
    *  'other' on every row. A table that records that something was wrong and nothing
    *  about what cannot answer "is the bot looping less this week?". */
-  fault: z4.enum(["loop", "unanswered", "overridden", "misheard", "slow", "other"]).optional()
+  fault: z5.enum(["loop", "unanswered", "overridden", "misheard", "slow", "other"]).optional()
 });
-var RideAlongSchema = z4.object({
+var RideAlongSchema = z5.object({
   /** The note this came from — assign/clarify/close it through /api/notes/:id. */
-  noteId: z4.string(),
+  noteId: z5.string(),
   /** What to do, in the owner's own words (the note's headline). Never model-rewritten. */
-  text: z4.string(),
+  text: z5.string(),
   /** The thread to report back on, when the note was dispatched over the request rail. */
-  parentId: z4.string().nullable()
+  parentId: z5.string().nullable()
 });
-var AwaitItemSchema = z4.discriminatedUnion("type", [
-  z4.object({
-    type: z4.literal("reply"),
-    parentId: z4.string(),
-    notificationId: z4.string(),
-    workId: z4.string().uuid().optional(),
-    decisionId: z4.string().uuid().optional(),
+var AwaitItemSchema = z5.discriminatedUnion("type", [
+  z5.object({
+    type: z5.literal("reply"),
+    parentId: z5.string(),
+    notificationId: z5.string(),
+    workId: z5.string().uuid().optional(),
+    decisionId: z5.string().uuid().optional(),
     answer: UserAnswerSchema,
     /** WHAT THE AGENT CANNOT KNOW FROM THE FIELDS BESIDE IT (owner, 2026-09-04, issue
      *  #1537). One line, built from the record: the ask and the caller's reply VERBATIM,
@@ -430,103 +637,103 @@ var AwaitItemSchema = z4.discriminatedUnion("type", [
      *  "call me back after you merge" in their own words decides for itself what to do,
      *  and now knows exactly which call to make. Absent when either half is missing —
      *  a sentence with a hole in it is worse than no sentence. */
-    note: z4.string().optional(),
+    note: z5.string().optional(),
     /** The call record rendered for THIS agent (`docs/brain/voice/record-design.md`): the words the
      *  shaped answer was mapped from, filtered to its own claims. There is no second list
      *  of labels beside it — the acts went 2026-09-04 and `intents` went with them (owner,
      *  2026-09-04): the agent reads the sentence and decides. */
-    transcript: z4.string().optional(),
+    transcript: z5.string().optional(),
     /** Coverage report (#396), when the ask declared `points`: which of them this
      *  answer addressed. Missing points = re-ask or proceed knowingly partial. */
-    covered: z4.array(z4.string()).optional(),
+    covered: z5.array(z5.string()).optional(),
     /** Ride-alongs (RideAlongSchema) — pending work for you, attached to the moment you
      *  became free. Only `reply` and `idle` carry it: those are the two outcomes that
      *  END a wait. `remind`, `superseded` and `turn` are mid-flight, and handing an
      *  agent a side-quest while it is still holding the line is how the main thing gets
      *  dropped. Absent/empty = nothing owed. */
-    also: z4.array(RideAlongSchema).optional()
+    also: z5.array(RideAlongSchema).optional()
   }),
-  z4.object({
-    type: z4.literal("remind"),
-    parentId: z4.string(),
-    notificationId: z4.string(),
-    remindAt: z4.string().datetime({ offset: true }),
+  z5.object({
+    type: z5.literal("remind"),
+    parentId: z5.string(),
+    notificationId: z5.string(),
+    remindAt: z5.string().datetime({ offset: true }),
     /** Seconds until remindAt, server-computed — pass straight to ScheduleWakeup. */
-    remindInSeconds: z4.number()
+    remindInSeconds: z5.number()
   }),
   /** The awaited ask was REPLACED by a newer notification on its thread (e.g. a
    *  post-feedback revision, #633) — the user will never answer this id. Stop
    *  awaiting it; the live ask is the thread's newest turn (await that one, or
-   *  re-orient via check_replies). */
-  z4.object({
-    type: z4.literal("superseded"),
-    parentId: z4.string(),
-    notificationId: z4.string()
+   *  re-orient via contact({})). */
+  z5.object({
+    type: z5.literal("superseded"),
+    parentId: z5.string(),
+    notificationId: z5.string()
   }),
   /** A LIVE call's turn, streamed as it lands (#783). PROVISIONAL: the user can still
    *  revise any of these until the final reply arrives — partial = intelligence,
    *  settled = authorization. Use it to PREPARE (fetch, draft, warm), never to act
    *  irreversibly. If `acts` carries a question aimed at you and you know the answer,
    *  contact on the same thread right away — the caller hears it on the same call. */
-  z4.object({
-    type: z4.literal("partial"),
-    notificationId: z4.string(),
-    inFlight: z4.literal(true),
-    turn: z4.object({
-      idx: z4.number(),
-      prompt: z4.string(),
-      reply: z4.string(),
-      acts: z4.array(IntentSchema).nullable().optional()
+  z5.object({
+    type: z5.literal("partial"),
+    notificationId: z5.string(),
+    inFlight: z5.literal(true),
+    turn: z5.object({
+      idx: z5.number(),
+      prompt: z5.string(),
+      reply: z5.string(),
+      acts: z5.array(IntentSchema).nullable().optional()
     })
   }),
-  z4.object({
-    type: z4.literal("idle"),
-    also: z4.array(RideAlongSchema).optional(),
+  z5.object({
+    type: z5.literal("idle"),
+    also: z5.array(RideAlongSchema).optional(),
     /** Is a call live for this agent's user right now? The SDK polls the partial stream
      *  (#783) between idle ticks ONLY while this is not `false` — a partial can only exist
      *  during a live call, and polling for one on a banner/message was a wasted HTTP call +
      *  3 queries on every idle tick of every waiting agent (~80% of all traffic at scale).
      *  Absent = an older API → the SDK keeps polling, exactly as before. */
-    inFlight: z4.boolean().optional()
+    inFlight: z5.boolean().optional()
   })
 ]);
-var VoiceKeySchema = z4.enum(["rachel", "george", "jessica", "brian", "lily"]);
-var AgendaTurnSchema = z4.object({
+var VoiceKeySchema = z5.enum(["rachel", "george", "jessica", "brian", "lily"]);
+var AgendaTurnSchema = z5.object({
   /** THE TURN'S IDENTITY (the first-sentence stream, 2026-09-09): the brain call that wrote
    *  it and its place in that reply — `<brainCallId>:<index>`, with `:p` on the first
    *  sentence a re-plan publishes ahead of the rest. A turn is spoken once, by this id: the
    *  completion of a streamed re-plan carries the published sentence again, and the walk
    *  drops what it already said by identity, never by the API's guess of what was polled.
    *  Absent on plans nothing streams (a ring plan, a floor). */
-  id: z4.string().optional(),
+  id: z5.string().optional(),
   /** Twin coverage (#1089): sibling claim ids this asking turn's answer ALSO settles —
    *  the planner declares duplicates instead of asking them twice. */
-  coveredIds: z4.array(z4.string()).optional(),
+  coveredIds: z5.array(z5.string()).optional(),
   /** The spoken sentences of the turn, in order. No count: how long a turn is is the brain's call
    *  (owner, 2026-09-25), and a count here refused whole plans. */
-  info: z4.array(z4.string().min(1)).default([]),
-  question: z4.string().min(1).nullable(),
+  info: z5.array(z5.string().min(1)).default([]),
+  question: z5.string().min(1).nullable(),
   /** True on the one turn carrying the agent's own declared question. */
-  asks: z4.boolean().optional(),
+  asks: z5.boolean().optional(),
   /** The claim this turn belongs to (#781) — the RETURN identity: answers route by it.
    *  Absent on a single-claim plan (the session's own claim) and on shared context turns,
    *  which route nothing. */
-  claimId: z4.string().optional(),
+  claimId: z5.string().optional(),
   /** The claim's voice key (#462) — the OUTBOUND identity, audible who-is-asking. */
-  voice: z4.string().optional(),
+  voice: z5.string().optional(),
   /** The claim's AGENT NAME (#838) — the spoken identity. A voice alone doesn't say
    *  whose request this is: an item that folded in from another agent arrived as a bare
    *  non-sequitur ("First real production sign-in is yours to make whenever you want.")
    *  and the owner answered "What?". The bot names the agent before its first turn. */
-  agent: z4.string().optional(),
+  agent: z5.string().optional(),
   /** The claim's agent by ID — the pairing's connection id (`notifications.token_id`), the
    *  same id a face is minted from. A name is not an identity: two pairings may be called
    *  "Claude", and a name cannot be joined on. The record's entries carry it (`agent_id`)
    *  so "who said that" survives the call, and it rides PER TURN because a coalesced call
    *  speaks for several agents — the turn is the only place that knows which. */
-  agentId: z4.string().optional(),
+  agentId: z5.string().optional(),
   select: SelectShapeSchema.optional(),
-  options: z4.array(OptionSchema.omit({ id: true })).optional(),
+  options: z5.array(OptionSchema.omit({ id: true })).optional(),
   /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
      paces itself now — a short beat between the sentences of a turn, the longer one at its end
      (owner, 2026-09-30: "remove the bot deciding pace") — and it does that where the words are
@@ -535,33 +742,33 @@ var AgendaTurnSchema = z4.object({
   /** Whether the walk WAITS for an answer before moving on. Absent = derived as today
    *  (a question blocks, context flows). blocking:false on a question = ask and move
    *  on, the claim stays pending; blocking:true on context = hold for a reply. */
-  blocking: z4.boolean().optional(),
+  blocking: z5.boolean().optional(),
   /** SPOKEN ONLY IF THEY SAY NOTHING (owner, 2026-10-01, call 812de935: "you're gonna re-ask, but it
    *  shouldn't be the same words … more like, hey, are you still there, or are you able to answer, or
    *  would you need more information"). The walk holds this turn out of its queue; at the queue's end it
    *  listens for the last word, and only if that listen is silent is this turn said and asked. If they
    *  speak, it is dropped and their words are taken like any reply. */
-  ifSilent: z4.boolean().optional()
+  ifSilent: z5.boolean().optional()
 });
 var CLAIM_STALE_MS = 30 * 6e4;
-var InboxItemSchema = z4.object({
-  id: z4.string(),
-  tokenId: z4.string().optional(),
+var InboxItemSchema = z5.object({
+  id: z5.string(),
+  tokenId: z5.string().optional(),
   status: NotifyStatusSchema,
   context: ContextSchema,
-  options: z4.array(OptionSchema).optional(),
+  options: z5.array(OptionSchema).optional(),
   /** The ask's declared coverage points (#396), when the agent sent them. */
-  points: z4.array(z4.string()).optional(),
+  points: z5.array(z5.string()).optional(),
   /** Does this claim want an ANSWER, or is it telling you something? Written per row from
    *  `requestAsks` — the agent's own declaration, not a guess. `false` is what earns a card
    *  its acknowledge affordance: without it a status update offers a text box and a dismiss,
    *  and neither of those is "got it" (owner, 2026-08-10). */
-  asks: z4.boolean().optional(),
+  asks: z5.boolean().optional(),
   /** When a live process last pulsed for this row's agent — the liveness input for
    *  "working requires a pulse" (#928): the list said "Working…" from agent_state alone
    *  while the party called the same dead claim stalled. Absent = no token/no data,
    *  which must never CLAIM stalled. */
-  lastSeenAt: z4.string().optional(),
+  lastSeenAt: z5.string().optional(),
   /** WHEN THE AGENT LAST SAID ANYTHING ABOUT THIS CLAIM — the newest `agent_state` row in
    *  the `notification_events` ledger (trigger-written since 20260621010000, so every row a
    *  user can see has one). The age input for `CLAIM_STALE_MS`, and it has to be this rather
@@ -571,7 +778,7 @@ var InboxItemSchema = z4.object({
    *  work. Reading the row's birth as the claim's age brands that "No update in 8h" the
    *  instant the agent picks it up (#997). Absent = pre-trigger row; fall back to
    *  `createdAt`. */
-  agentStateAt: z4.string().datetime().optional(),
+  agentStateAt: z5.string().datetime().optional(),
   /** THE QUESTIONS A CALL CARRIES — the call screen's agenda spine (docs/clients/app/walk/design.md §11, owner
    *  2026-09-22). One per DecisionNeed on the Call, in the Call's order, answered or open (a
    *  superseded or cancelled need is no longer a question anyone is asked). Present only on a
@@ -585,54 +792,54 @@ var InboxItemSchema = z4.object({
    *  `turn` topic (`asking`, `settled`), because the bot never sees a DecisionNeed id. `title` is
    *  the card's own concise heading; `answer` the accepted answer in words, null while open. It
    *  REPLACED `agenda` (turns), which nothing ever filled. */
-  questions: z4.array(z4.object({
-    id: z4.string(),
-    entryId: z4.string(),
-    title: z4.string(),
-    state: z4.enum(["open", "answered"]),
-    answer: z4.string().nullable(),
+  questions: z5.array(z5.object({
+    id: z5.string(),
+    entryId: z5.string(),
+    title: z5.string(),
+    state: z5.enum(["open", "answered"]),
+    answer: z5.string().nullable(),
     /** WHO ASKED IT (owner, 2026-09-23, Goal a345e906: each agenda row wears its agent's face) — the
      *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
      *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
      *  author is not an agent this account holds (unpaired since, or a person). */
-    agent: z4.object({ tokenId: z4.string(), name: z4.string(), voice: VoiceKeySchema.optional() }).optional(),
+    agent: z5.object({ tokenId: z5.string(), name: z5.string(), voice: VoiceKeySchema.optional() }).optional(),
     /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
      *  its need offers, exactly as its own card carries them, present only when one of them has a
      *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
      *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
      *  says those, and the list stays small (an `html` is up to 16 KB). */
-    options: z4.array(OptionSchema).optional()
+    options: z5.array(OptionSchema).optional()
   })).optional(),
-  visuals: z4.array(VisualSchema).optional(),
+  visuals: z5.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
    *  agent's suggestion, or a default silly name). */
-  name: z4.string(),
+  name: z5.string(),
   /** The pairing's assigned voice (#462); absent = the default voice. */
   voice: VoiceKeySchema.optional(),
-  repo: z4.string().optional(),
-  branch: z4.string().optional(),
-  createdAt: z4.string().datetime(),
-  snoozedUntil: z4.string().datetime().optional(),
+  repo: z5.string().optional(),
+  branch: z5.string().optional(),
+  createdAt: z5.string().datetime(),
+  snoozedUntil: z5.string().datetime().optional(),
   agentState: AgentStateSchema.default("idle"),
   /** Whose action the item is waiting on: "you" = an agent asked you (the default,
    *  every agent→user notification); "agent" = you sent a request and it's awaiting the
    *  agent (held in the inbox until the agent replies on the thread). */
-  turn: z4.enum(["you", "agent"]).default("you"),
+  turn: z5.enum(["you", "agent"]).default("you"),
   /** Hard error reason on an awaiting request (turn="agent") — the wake failed to reach
    *  the agent (provider-agnostic; set server-side). Absent = no hard error. Drives the inbox
    *  error badge + Retry. */
-  error: z4.string().optional(),
+  error: z5.string().optional(),
   /** WHEN THIS AGENT WORK WENT QUIET (turn="agent"), by the one rule (`coldSince`: three days
    *  with nothing said), or absent while it is not stalled. The inbox's stalled badge reads
    *  this and nothing else (2026-09-23: a 3-minute age rule badged every live Goal stalled,
    *  and "dismiss the stalled ones" cancelled 37 pieces of live work). */
-  cold: z4.string().datetime().optional(),
-  clarifies: z4.string().optional(),
+  cold: z5.string().datetime().optional(),
+  clarifies: z5.string().optional(),
   /** THIS CARD'S QUESTION IS ON A LIVE CALL (owner, 2026-09-24: "Mark it while the call is
    *  live"). Present only while an open Call Delivery carries the card's request Entry — read
    *  off the same open list the card came from, so it clears when the Call does. A card is the
    *  backup for a call not taken; while the call has it, the call is where it is answered. */
-  onCall: z4.literal(true).optional(),
+  onCall: z5.literal(true).optional(),
   /** THE RING, ON THE ITEM (docs/clients/app/walk/design.md §12 §17, #2251): the last ring on this card was
    *  declined, and what the ladder will do next — read off the cron's own row, never computed
    *  on the phone. Present only while a `declined` receipt stands on the card's last Call.
@@ -642,31 +849,31 @@ var InboxItemSchema = z4.object({
    *  It replaced `gaveUp` (deleted 2026-09-22): "the ladder spent" was a boolean the projection
    *  never set, and it is `nextRingAt === null` here — the party's *Missed you* (`party/dress.ts`)
    *  and the roster's `unreached` read `declinedAt`, and stand while it does. */
-  ring: z4.object({
-    declinedAt: z4.string().datetime(),
-    anchorAt: z4.string().datetime(),
-    nextRingAt: z4.string().datetime().nullable(),
-    step: z4.number().int()
+  ring: z5.object({
+    declinedAt: z5.string().datetime(),
+    anchorAt: z5.string().datetime(),
+    nextRingAt: z5.string().datetime().nullable(),
+    step: z5.number().int()
   }).optional(),
   /** Why this arrived the way it did, read back off the delivery receipt (`notify/why.ts`).
    *  Absent for anything never delivered through a push, and for older rows written before
    *  the reason was recorded. Deliberately a debug affordance, shown small (owner,
    *  2026-08-07) — its real job is to give "this didn't need a call" something to be
    *  feedback ABOUT. */
-  why: z4.object({
+  why: z5.object({
     asked: NotifyLevelSchema,
     got: NotifyLevelSchema,
-    because: z4.enum(["unresponsive", "dismissed", "not_permitted", "silent", "coalesced", "agent_capped", "unplanned", "learned_raise"]).optional(),
-    line: z4.string()
+    because: z5.enum(["unresponsive", "dismissed", "not_permitted", "silent", "coalesced", "agent_capped", "unplanned", "learned_raise"]).optional(),
+    line: z5.string()
   }).optional(),
-  select: z4.enum(["one", "many", "rank", "confirm", "text"]).default("one"),
-  confirmStyle: z4.enum(["yesno", "approve"]).default("yesno").describe(
+  select: z5.enum(["one", "many", "rank", "confirm", "text"]).default("one"),
+  confirmStyle: z5.enum(["yesno", "approve"]).default("yesno").describe(
     "Labels for a select:'confirm' paige \u2014 'yesno' (Yes/No) or 'approve' (Approve/Deny). Ignored unless select is 'confirm'."
   ),
   /** Real downstream work is stuck behind this one — set by the agent, independent of
    *  urgency (see the main README's "premier use case" + docs/delivery/notify/states.md). Drives the
    *  inbox's blocking badge and the extra confirm step before dismissing it. */
-  blocking: z4.boolean().default(false),
+  blocking: z5.boolean().default(false),
   /** The user's locked-in answer; present only for replied items (GET /api/replied/:id). */
   answer: UserAnswerSchema.optional(),
   /** THE TARGET FACTS A CARD RENDERS (#1796 point 5, 2026-09-11): the Delivery it is a view of,
@@ -674,38 +881,49 @@ var InboxItemSchema = z4.object({
    *  for a request that asks nothing), whether its content is sealed, and that Goal's state. The
    *  answer writer (`POST /api/entries`) and the disposition (`close_delivery`) take their ids from
    *  here. The server projects it (`apps/api/src/inbox/project.ts`); a client never builds it. */
-  communication: z4.object({
-    deliveryId: z4.string(),
-    kind: z4.enum(["notification", "call"]),
-    entryId: z4.string(),
-    goalIds: z4.array(z4.string()),
-    decisionNeedId: z4.string().optional(),
-    sealed: z4.boolean(),
-    goalState: z4.string().optional(),
+  communication: z5.object({
+    deliveryId: z5.string(),
+    kind: z5.enum(["notification", "call"]),
+    entryId: z5.string(),
+    goalIds: z5.array(z5.string()),
+    decisionNeedId: z5.string().optional(),
+    sealed: z5.boolean(),
+    goalState: z5.string().optional(),
     /** THAT GOAL'S NAME (#2416) — what Activity's row is headed by, since a row there is one Goal
      *  and the cards it holds sit behind it. Stamped by the same read as `goalState`. */
-    goalTitle: z4.string().optional()
-  }).optional()
+    goalTitle: z5.string().optional()
+  }).optional(),
+  /** WHAT THIS CARD IS, IN TWELVE CHARACTERS (#3019) — the hash of every other field on it, stamped
+   *  by the one read that serves the open list (`apps/api/src/inbox/project.ts` `inboxFor`). It is
+   *  how the incremental read knows a card has not moved: the phone echoes back the revs it holds
+   *  (`POST /api/inbox/changes`) and is sent only the cards whose rev differs.
+   *
+   *  THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK — the same mechanism as `QueueItem.rev`
+   *  (#2928) and an entry's (#3018), for the same reason: a card shows facts no `updated_at` of its
+   *  own moves (its Goal's state and name, how cold the work behind it has gone, whether a ring is
+   *  live). Optional, so a fixture, the demo and the archive lens need not spell one, and a card
+   *  with no rev is simply always re-sent. */
+  rev: z5.string().optional()
 });
 var APNS_TOKEN_RE = /^[0-9a-fA-F]{64}$/;
-var PushTokenSchema = z4.object({
-  voipToken: z4.string().min(1).optional(),
-  alertToken: z4.string().min(1).optional(),
-  fcmToken: z4.string().min(1).optional(),
-  platform: z4.enum(["ios", "android"])
+var PushTokenSchema = z5.object({
+  voipToken: z5.string().min(1).optional(),
+  alertToken: z5.string().min(1).optional(),
+  fcmToken: z5.string().min(1).optional(),
+  platform: z5.enum(["ios", "android"])
 }).superRefine((v, ctx) => {
   if (v.platform !== "ios") return;
   for (const field of ["voipToken", "alertToken"]) {
     const token = v[field];
     if (token === void 0 || APNS_TOKEN_RE.test(token)) continue;
     ctx.addIssue({
-      code: z4.ZodIssueCode.custom,
+      code: z5.ZodIssueCode.custom,
       path: [field],
       message: `not an APNs device token (want 64 hex chars, got ${token.length})`
     });
   }
 });
-var MissedCallSchema = z4.enum([
+var MissedCallSchema = z5.enum([
   "retry_10m",
   "retry_30m",
   "retry_60m",
@@ -717,31 +935,31 @@ var MissedCallSchema = z4.enum([
 ]);
 var clock = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
 var QUIET = ` Nothing rings from ${clock(NIGHT.from)} to ${clock(NIGHT.to)} your time; the count waits for morning.`;
-var BrokerTuningSchema = z4.object({
+var BrokerTuningSchema = z5.object({
   /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
-  ackVerbosity: z4.enum(["normal", "none"]).optional(),
+  ackVerbosity: z5.enum(["normal", "none"]).optional(),
   /** How readily the mapper asks its one clarification: 'low' = only when truly
    *  uninterpretable, 'high' = whenever not fully certain. */
-  clarifyEagerness: z4.enum(["low", "normal", "high"]).optional(),
+  clarifyEagerness: z5.enum(["low", "normal", "high"]).optional(),
   /** The user's own shorthand: when they say `say`, they mean `mean`. */
-  phrasebook: z4.array(z4.object({ say: z4.string().min(1).max(60), mean: z4.string().min(1).max(120) })).max(24).optional(),
+  phrasebook: z5.array(z5.object({ say: z5.string().min(1).max(60), mean: z5.string().min(1).max(120) })).max(24).optional(),
   /** The language calls are PLANNED in, when the account has chosen one (#1272). Absent —
    *  which is every account today — means the agent's own words decide, per ask: a call
    *  about an English ask opens in English. This is the only thing that overrides that,
    *  and a live caller who switches language mid-call still outranks it (broker/lang.ts).
    *  Set per user (no UI yet), like `voiceTuning`. */
-  language: z4.enum(["en", "es"]).optional()
+  language: z5.enum(["en", "es"]).optional()
 });
-var UserSettingsSchema = z4.object({
-  permissions: z4.object({
-    call: z4.boolean(),
-    banner: z4.boolean(),
-    push: z4.boolean()
+var UserSettingsSchema = z5.object({
+  permissions: z5.object({
+    call: z5.boolean(),
+    banner: z5.boolean(),
+    push: z5.boolean()
   }),
   /** LockedIn / Default / DateNight on screen; the stored words are unchanged on purpose —
    *  they are an enum on a live column across every account, and the rename is a rename of
    *  what people read (owner, 2026-09-30). */
-  sessionMode: z4.enum(["default", "all_calls", "silent"]),
+  sessionMode: z5.enum(["default", "all_calls", "silent"]),
   /** `silentPush` lived here until #2813 and is now GONE, field and column both. It was kept as an
    *  optional long after DateNight stopped reading it, on the theory that a phone on an older
    *  bundle PATCHing the whole settings object would be REFUSED for sending a key we had stopped
@@ -750,7 +968,7 @@ var UserSettingsSchema = z4.object({
    *  an old bundle's `silentPush` is accepted and ignored. Worth remembering before keeping the
    *  next dead field for the same reason. */
   /** Opt-in (default false) to using your content to improve Paigy and train models. */
-  improveConsent: z4.boolean(),
+  improveConsent: z5.boolean(),
   missedCall: MissedCallSchema.default("backoff_standard"),
   /** Where voice audio is processed. 'hosted' (default) = Paigy's voice services
    *  (ElevenLabs TTS, faster-whisper STT, the call bot); 'on_device' = the phone
@@ -758,17 +976,17 @@ var UserSettingsSchema = z4.object({
    *  Optional, NOT defaulted: a stale client PATCHing the full settings object
    *  must not silently reset this privacy choice. Absent = leave unchanged on
    *  write, 'hosted' on read (see store.ts). */
-  voiceMode: z4.enum(["hosted", "on_device"]).optional(),
+  voiceMode: z5.enum(["hosted", "on_device"]).optional(),
   /** Talk — after you answer, the next step is read aloud (docs/clients/app/walk/design.md §6). ALWAYS ON until
    *  turned off (owner, 2026-09-18, #2249): a setting, not a per-walk toggle. Optional, NOT
    *  defaulted, for the same reason `voiceMode` is: a stale client PATCHing the full settings
    *  object must not silently turn it back on. Absent = leave unchanged on write, true on
    *  read (see store.ts). */
-  talk: z4.boolean().optional(),
+  talk: z5.boolean().optional(),
   /** CALL DIAGNOSTICS (owner, 2026-10-01): the call report carries each listen and the bot's own
    *  load timings. SERVER-SET, no UI — on for every account that existed on 2026-10-01, off for
    *  newer ones (migration 20261001132859). Read-only here: the settings PATCH never writes it. */
-  callDiagnostics: z4.boolean().optional(),
+  callDiagnostics: z5.boolean().optional(),
   /** Per-user ring budget (#603): calls per rolling day before further calls
    *  degrade to banner. Absent = the global default (25). A number, never a
    *  bypass — every account keeps a ceiling. No UI; set per user for testing. */
@@ -776,7 +994,7 @@ var UserSettingsSchema = z4.object({
    *  payload['tuning'] (e.g. { silence_s: 3.5 } — a longer pause window for a
    *  slower speaker). No API-side semantics; the bot resolves each key with its
    *  own defaults. Set per user (no UI yet); absent = bot defaults. */
-  voiceTuning: z4.record(z4.string(), z4.union([z4.number(), z4.string()])).optional(),
+  voiceTuning: z5.record(z5.string(), z5.union([z5.number(), z5.string()])).optional(),
   /** The user's IANA timezone (e.g. "America/Bogota"), recorded by the app — it is the
    *  only party that knows it. REMINDERS are why it exists: "remind me at ten" becomes
    *  an absolute `due_at` only if we know whose ten. Optional and never defaulted, for
@@ -785,53 +1003,53 @@ var UserSettingsSchema = z4.object({
    *  that failure reads as the reminder rail being unreliable rather than as a missing
    *  setting. Absent = a spoken time can't be landed, so the reminder rides the next
    *  call — honest about what we know. */
-  timezone: z4.string().min(1).max(64).optional(),
+  timezone: z5.string().min(1).max(64).optional(),
   /** Rung-2 broker tuning (#381). Optional and NOT defaulted, same stale-client
    *  clobber guard as voiceMode: absent = leave unchanged on write. */
   broker: BrokerTuningSchema.optional()
 });
-var HistoryWorkSchema = z4.object({
-  id: z4.string(),
-  title: z4.string(),
-  state: z4.enum(["done", "cancelled"]),
+var HistoryWorkSchema = z5.object({
+  id: z5.string(),
+  title: z5.string(),
+  state: z5.enum(["done", "cancelled"]),
   /** Who held it (`agent:<tokenId>` or `human:<userId>`). */
-  assignee: z4.string()
+  assignee: z5.string()
 });
-var HistoryEntrySchema = z4.union([
-  z4.object({ at: z4.string(), card: InboxItemSchema }),
-  z4.object({ at: z4.string(), work: HistoryWorkSchema })
+var HistoryEntrySchema = z5.union([
+  z5.object({ at: z5.string(), card: InboxItemSchema }),
+  z5.object({ at: z5.string(), work: HistoryWorkSchema })
 ]);
-var HistoryPageSchema = z4.object({
-  entries: z4.array(HistoryEntrySchema),
-  next: z4.string().nullable()
+var HistoryPageSchema = z5.object({
+  entries: z5.array(HistoryEntrySchema),
+  next: z5.string().nullable()
 });
 var ACTIVITY_LINES = 2;
 var ACTIVITY_LINE_MAX = 80;
-var AgentActivitySchema = z4.object({
+var AgentActivitySchema = z5.object({
   /** Oldest first, so the newest line is last — the one that replaces in place. */
-  lines: z4.array(z4.string().max(ACTIVITY_LINE_MAX)).max(ACTIVITY_LINES),
+  lines: z5.array(z5.string().max(ACTIVITY_LINE_MAX)).max(ACTIVITY_LINES),
   /** When the harness observed this tail. Its own timestamp, not the heartbeat's: a beat
    *  that carries an UNCHANGED tail must not make a stalled agent look like it just moved. */
-  at: z4.string().datetime()
+  at: z5.string().datetime()
 });
-var ConnectionSummarySchema = z4.object({
+var ConnectionSummarySchema = z5.object({
   /** The connection = the agent's token id (used to address a request). */
-  id: z4.string(),
+  id: z5.string(),
   /** The credential kind: "device" = a paired machine (mint-only — it hosts and mints, it
    *  never talks); "agent" = an identity that sends. The roster and devices surfaces split
    *  on this. Optional/absent reads as "agent" (a row predating the kind column). See
    *  docs/server/tokens/devices-vs-agents-design.md. */
-  kind: z4.enum(["device", "agent"]).optional(),
+  kind: z5.enum(["device", "agent"]).optional(),
   /** For an agent, the token id of the DEVICE that minted it — so agents group under their
    *  machine, and revoking a device cascades to them. Null on devices, and on unlinked
    *  agents (phone-launched, provider-managed, or minted before the link existed). */
-  mintedByDevice: z4.string().nullable().optional(),
-  device: z4.string().nullable(),
+  mintedByDevice: z5.string().nullable().optional(),
+  device: z5.string().nullable(),
   /** The agent's display name (the single pairing name). */
-  name: z4.string(),
+  name: z5.string(),
   /** For a managed connection, the provider key (e.g. "cma") that agentOrigin maps to a
    *  label; null for a local connection. Sourced from the token's provider, not the name. */
-  provider: z4.string().nullable(),
+  provider: z5.string().nullable(),
   /** The pairing's assigned voice (#462); null = the default voice. */
   voice: VoiceKeySchema.nullable(),
   /** The LOUDEST this agent may ever reach you — a ceiling on `NOTIFY_LADDER`, set by the
@@ -842,34 +1060,34 @@ var ConnectionSummarySchema = z4.object({
    *  every surface at once and outranks even `sessionMode: all_calls` — a mode the user
    *  set once must not overrule a rule they set about one agent. */
   reach: NotifyLevelSchema.nullable().optional(),
-  createdAt: z4.string().datetime(),
+  createdAt: z5.string().datetime(),
   /** Most recent notification on this connection, either direction. Null = no contact yet.
    *  Drives the agents-page recency grouping (Today / This week / …). */
-  lastContactAt: z4.string().datetime().nullable(),
+  lastContactAt: z5.string().datetime().nullable(),
   /** Last presence heartbeat from a running agent process (POST /api/presence) — the
    *  desktop app while open. Null = never seen; stale = offline. */
-  lastSeenAt: z4.string().datetime().nullable().optional(),
+  lastSeenAt: z5.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
    *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
-  lastWorkedAt: z4.string().datetime().nullable().optional(),
+  lastWorkedAt: z5.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
    *  With no work of its own for `WORKING_MS`, an agent sitting on this is not taking its work. */
-  oldestReadyAt: z4.string().datetime().nullable().optional(),
+  oldestReadyAt: z5.string().datetime().nullable().optional(),
   /** What a live desktop can run (docs/clients/desktop/companion.md §2.2), advertised on its heartbeat:
    *  harness availabilities + granted workspaces — the option set the phone's
    *  "new session" sheet offers. Absent for ordinary MCP agents. */
-  runtime: z4.object({
+  runtime: z5.object({
     /** The @paigy/harness this host is running — a machine the self-update has not reached
      *  shows its age here (`apps/desktop/src/update.ts`). */
-    version: z4.string().optional(),
-    harnesses: z4.array(z4.object({ name: z4.string(), label: z4.string(), status: z4.string() })).optional(),
-    workspaces: z4.array(z4.string()).optional(),
+    version: z5.string().optional(),
+    harnesses: z5.array(z5.object({ name: z5.string(), label: z5.string(), status: z5.string() })).optional(),
+    workspaces: z5.array(z5.string()).optional(),
     /** THE GIT REPOS IN THOSE FOLDERS (2026-10-01, Goal 26982211): each granted folder that is a
      *  repo, and each repo directly inside one, with its `origin` remote. A session started for
      *  work on `mauurda/paigy` opens in that repo rather than the folder above it, where the repo's
      *  own AGENTS.md is never read (`workspaceForRepo`). Absent on hosts that predate it. */
-    repos: z4.array(z4.object({ path: z4.string(), remote: z4.string() })).optional()
+    repos: z5.array(z5.object({ path: z5.string(), remote: z5.string() })).optional()
   }).optional(),
   /** The tail of this agent's working log, when a harness is driving it — the agent page's
    *  live strip. Absent for anything the desktop harness isn't running (a hatched identity
@@ -878,173 +1096,156 @@ var ConnectionSummarySchema = z4.object({
   activity: AgentActivitySchema.optional(),
   /** True = a provider-managed agent running in the provider's cloud (e.g. Anthropic CMA);
    *  false = a local MCP connection running on the user's computer (Claude Code/Codex/…). */
-  managed: z4.boolean()
+  managed: z5.boolean()
 });
-var LedgerItemSchema = z4.object({ id: z4.string(), parentId: z4.string(), title: z4.string(), createdAt: z4.string() });
-var AgentLedgerSchema = z4.object({
+var LedgerItemSchema = z5.object({ id: z5.string(), parentId: z5.string(), title: z5.string(), createdAt: z5.string() });
+var AgentLedgerSchema = z5.object({
   /** Null when the agent has not named itself yet — never a placeholder (owner, 2026-10-01). */
-  agent: z4.object({ id: z4.string(), name: z4.string().nullable(), revokedAt: z4.string().nullable() }),
+  agent: z5.object({ id: z5.string(), name: z5.string().nullable(), revokedAt: z5.string().nullable() }),
   /** Its own questions you have not answered. */
-  asks: z4.array(LedgerItemSchema),
+  asks: z5.array(LedgerItemSchema),
   /** Its questions you answered that nobody acted on — still owed to somebody. */
-  answered: z4.array(LedgerItemSchema),
+  answered: z5.array(LedgerItemSchema),
   /** Requests you sent it that it never took. */
-  requests: z4.array(LedgerItemSchema),
-  goals: z4.array(z4.object({ id: z4.string(), outcome: z4.string(), state: z4.string() })),
-  callbacks: z4.array(z4.object({ id: z4.string(), parentId: z4.string(), trigger: z4.string(), note: z4.string(), dueAt: z4.string().nullable() }))
+  requests: z5.array(LedgerItemSchema),
+  goals: z5.array(z5.object({ id: z5.string(), outcome: z5.string(), state: z5.string() })),
+  callbacks: z5.array(z5.object({ id: z5.string(), parentId: z5.string(), trigger: z5.string(), note: z5.string(), dueAt: z5.string().nullable() }))
 });
-var ReassignResultSchema = z4.object({
-  moved: z4.object({ asks: z4.number(), answered: z4.number(), requests: z4.number(), goals: z4.number(), callbacks: z4.number() }),
-  parentId: z4.string().nullable()
+var ReassignResultSchema = z5.object({
+  moved: z5.object({ asks: z5.number(), answered: z5.number(), requests: z5.number(), goals: z5.number(), callbacks: z5.number() }),
+  parentId: z5.string().nullable()
 });
-var MoveRingSchema = z4.enum(["home", "travels", "retired", "quarantined"]);
-var MoveSchema = z4.object({
-  id: z4.string(),
-  /** The reusable question, as distill normalized it. */
-  question: z4.string(),
-  /** The operative ruling. Editable by the user (PATCH) — which resets the ledger. */
-  answer: z4.string(),
-  /** The user's stated reason, when they gave one. Null = inherently narrow: the judge is
-   *  told so, and the ruling only derives essentially the same question in the same scope. */
-  rationale: z4.string().nullable(),
-  /** Where the ruling lives: a repo/workspace, or 'global'. */
-  scope: z4.string(),
-  ring: MoveRingSchema,
-  /** True = the user pinned it with `always` (travel granted by hand, not by evidence). */
-  pinned: z4.boolean(),
-  /** True = a pin the user placed was BROKEN by later counter-evidence. Surfaced so the
-   *  break is visible instead of a pin silently disappearing. */
-  pinBroken: z4.boolean(),
-  /** When the ruling was distilled. */
-  learnedAt: z4.string(),
-  /** Last time it answered an ask. Null = never fired. */
-  lastUsedAt: z4.string().nullable(),
-  /** How many asks it has answered. Instrumentation — deliberately NOT an input to the
-   *  evidence curve: firing says the question keeps arising, not that the ruling is right. */
-  usedCount: z4.number(),
-  /** Ledger: outcomes that said it held up. Saturating — the tenth is worth almost nothing. */
-  confirms: z4.number(),
-  /** Ledger: contradictions, in signal units (a full override = 1, weaker signals less).
-   *  Linear and priced above the entire confirmation budget, so any full counter wins. */
-  counters: z4.number(),
-  /** The agent that asked the question this move came from, when known. Null for a move
-   *  distilled from a clarify ruling (those carry no agent) or one whose source rows are gone. */
-  learnedFrom: z4.object({ id: z4.string(), name: z4.string() }).nullable()
+var LessonStateSchema = z5.enum(["active", "proposed", "retired"]);
+var LessonViewSchema = z5.object({
+  id: z5.string(),
+  text: z5.string(),
+  state: LessonStateSchema,
+  /** The Goal it is scoped to; null = the whole account. */
+  scopeGoalId: z5.string().nullable(),
+  goalTitle: z5.string().nullable(),
+  version: z5.number(),
+  pinned: z5.boolean(),
+  /** When the person last wrote its text themselves. */
+  editedAt: z5.string().nullable(),
+  createdAt: z5.string(),
+  updatedAt: z5.string(),
+  /** The Entries it came from, oldest first; `words` is null when an Entry has none to show (sealed). */
+  sources: z5.array(z5.object({ entryId: z5.string(), words: z5.string().nullable(), at: z5.string() }))
 });
-var QueueQuestionSchema = z4.object({
+var QueueQuestionSchema = z5.object({
   /** The decision need's id — what an answer is accepted against. */
-  id: z4.string(),
+  id: z5.string(),
   /** The words that were asked, from the request Entry that asked them. */
-  question: z4.string(),
+  question: z5.string(),
   /** Where it was asked — which is where the ruling goes (`POST /api/entries`). Null only
    *  for a need whose request Entry is carried by no interactive Delivery, which nothing
    *  can answer. */
-  deliveryId: z4.string().nullable().default(null),
+  deliveryId: z5.string().nullable().default(null),
   /** The Entry the ruling is about. */
-  aboutId: z4.string().nullable().default(null),
+  aboutId: z5.string().nullable().default(null),
   /** Empty for a free-text question. */
-  options: z4.array(OptionSchema).default([]),
-  select: z4.enum(["one", "many", "rank", "confirm", "text"]).default("text"),
-  askedAt: z4.string(),
+  options: z5.array(OptionSchema).default([]),
+  select: z5.enum(["one", "many", "rank", "confirm", "text"]).default("text"),
+  askedAt: z5.string(),
   /** Null while the question is open — which is how the page tells the two apart. */
-  answeredAt: z4.string().nullable().default(null),
+  answeredAt: z5.string().nullable().default(null),
   /** The ruling in the person's own words, from the contribution that replied — not the
    *  option id, which is not something anyone reads back. Null while it is open, and null
    *  for a settled question whose reply carried nothing readable. */
-  answer: z4.string().nullable().default(null),
+  answer: z5.string().nullable().default(null),
   /** The Goal this question belongs to — a step knows its Goal on its own, not only through
    *  an `InboxItem`'s `communication.goalIds[0]` (docs/clients/app/walk/design.md §12 item 3).
    *  READ BY `apps/client/src/walk/order.ts`, which stamps it onto every `WalkStep`: the walk's
    *  order, its route, home's trees and the list of steps all take a step's Goal from here, so
    *  this is the field they agree through rather than each re-deriving it from the row it
    *  arrived under. Required because the API projects it on every need it sends. */
-  goalId: z4.string(),
+  goalId: z5.string(),
   /** True only while an unmet START gate holds the Goal — a Goal that merely waits to
    *  *finish* does not stop a person from answering (owner, 2026-09-16: "per need gate from
    *  the API"; §4's dashed node). Not the same fact as `QueueItem.blocked`, which counts any
    *  gate at all. */
-  blocked: z4.boolean().default(false)
+  blocked: z5.boolean().default(false)
 });
-var QueueReplySchema = z4.object({
+var QueueReplySchema = z5.object({
   /** The card this note was (`deliveryId:requestEntryId`, minted by the server like every card
    *  id) — so the phone can tell a reply it just sent from one the queue already carries, and the
    *  walk can name it in its zoom. */
-  id: z4.string(),
+  id: z5.string(),
   /** The Goal the note is on. */
-  goalId: z4.string(),
+  goalId: z5.string(),
   /** What the note said. */
-  note: z4.string(),
+  note: z5.string(),
   /** Where it was carried — where a second reply goes (`POST /api/entries`, #2252). */
-  deliveryId: z4.string(),
-  requestEntryId: z4.string(),
-  askedAt: z4.string(),
+  deliveryId: z5.string(),
+  requestEntryId: z5.string(),
+  askedAt: z5.string(),
   /** When the person last replied — the window's start. */
-  repliedAt: z4.string(),
+  repliedAt: z5.string(),
   /** The person's latest words about it; null when there is nothing readable in them. */
-  reply: z4.string().nullable()
+  reply: z5.string().nullable()
 });
-var QueueItemSchema = z4.object({
-  id: z4.string(),
+var QueueItemSchema = z5.object({
+  id: z5.string(),
   /** One-line headline — the first sentence of the outcome. */
-  title: z4.string(),
+  title: z5.string(),
   /** The outcome in full, verbatim: the person's own words are what an assignee sees. */
-  intent: z4.string(),
+  intent: z5.string(),
   /** `ready` | `active` | `waiting` | `done` | `cancelled`, straight off the Goal. */
-  state: z4.string(),
+  state: z5.string(),
   /** Who holds it (a participant ref); null when nobody does yet. */
-  assignee: z4.string().nullable().default(null),
+  assignee: z5.string().nullable().default(null),
   /** What the agent last said it was doing; null if it has said nothing. */
-  progress: z4.string().nullable().default(null),
+  progress: z5.string().nullable().default(null),
   /** HOME'S LINE FOR THAT NOTE (owner, 2026-09-23): a few plain words one read wrote from `progress`,
    *  served only while it was written for the current note. Null means show the Goal's name. */
-  progressLine: z4.string().nullable().optional(),
-  reviewPending: z4.boolean().default(false),
-  dueAt: z4.string().nullable().default(null),
+  progressLine: z5.string().nullable().optional(),
+  reviewPending: z5.boolean().default(false),
+  dueAt: z5.string().nullable().default(null),
   /** WHEN ITS OWNER SAID DONE WHILE CHILDREN WERE OPEN (#2704): its own work is finished and it closes
    *  with its last open child. Null otherwise; optional, so hand-built queues need not spell it. */
-  finishedAt: z4.string().nullable().optional(),
+  finishedAt: z5.string().nullable().optional(),
   /** The Goal this one was opened under; null at the root. */
-  parentGoalId: z4.string().nullable().default(null),
+  parentGoalId: z5.string().nullable().default(null),
   /** Goals opened under this one — only those the same list holds. */
-  childGoalIds: z4.array(z4.string()).default([]),
+  childGoalIds: z5.array(z5.string()).default([]),
   /** Goals this one waits on (start or finish gates). */
-  dependencyGoalIds: z4.array(z4.string()).default([]),
+  dependencyGoalIds: z5.array(z5.string()).default([]),
   /** True while any gate is on a Goal that is not done — the walk draws it dashed. */
-  blocked: z4.boolean().default(false),
+  blocked: z5.boolean().default(false),
   /** Its questions: every OPEN one, and at most ten settled, newest settled first
    *  (20260929133308) — the page decides which of them to show. NOT the whole set: `asked` and
    *  `answered` are, and a settled one's words are a line (280 characters), its body read when the
    *  question is opened. */
-  questions: z4.array(QueueQuestionSchema).default([]),
+  questions: z5.array(QueueQuestionSchema).default([]),
   /** HOW MANY QUESTIONS THIS WORK HAS ASKED, and how many are answered — the Goal's own totals,
    *  bounded at 100 server-side. A tally counted off `questions` is a wrong number that looks
    *  right once the cap bites (`walk/trees.ts` `tallyOf`). Optional, and defaulted from the array
    *  by the projection, so hand-built queues (fixtures, the demo) need not spell them. */
-  asked: z4.number().optional(),
-  answered: z4.number().optional(),
+  asked: z5.number().optional(),
+  answered: z5.number().optional(),
   /** Every note on it the person replied to (`QueueReplySchema`) — the page decides which to show.
    *  Optional, not defaulted: absent is none, and every hand-built queue (fixtures, the demo) need
    *  not spell an empty list. */
-  replies: z4.array(QueueReplySchema).optional(),
+  replies: z5.array(QueueReplySchema).optional(),
   /** The repository or project identifier this Goal belongs to (#2280), null if untracked. */
-  repo: z4.string().nullable().optional(),
-  createdAt: z4.string(),
-  updatedAt: z4.string().nullable().default(null),
+  repo: z5.string().nullable().optional(),
+  createdAt: z5.string(),
+  updatedAt: z5.string().nullable().default(null),
   /** When its owner last SAID something about it (`goals.last_progress_at`, written by every
    *  `update_goal` that changes `progress`). `updatedAt` moves for reasons nobody chose — a
    *  state recomputed, a review flag — so it cannot tell work in hand from work gone quiet. */
-  lastProgressAt: z4.string().nullable().optional(),
+  lastProgressAt: z5.string().nullable().optional(),
   /** THE GOAL'S NEWEST WORD, FROM EITHER SIDE (owner, 2026-09-27): the newest Entry on it, of any
    *  kind — what the person added ("Add to this"), their reply, the agent's ask or its progress
    *  note. A progress note is an Entry, so this is already the newer of the two: the person's note
    *  shows the moment it is written, and the agent's reply or next note replaces it by being newer.
    *  `said` is bounded to 280 characters server-side (a line, not the conversation). Null when the
    *  Goal carries no readable Entry; optional, so hand-built queues need not spell it. */
-  latest: z4.object({
-    from: z4.enum(["person", "agent"]),
-    said: z4.string(),
-    at: z4.string(),
-    entryId: z4.string()
+  latest: z5.object({
+    from: z5.enum(["person", "agent"]),
+    said: z5.string(),
+    at: z5.string(),
+    entryId: z5.string()
   }).nullable().optional(),
   /** WHEN THIS PERSON LAST PUT A HAND ON IT THEMSELVES (owner, Paigy Goal 16d18f51, 2026-09-30):
    *  the newest Entry on the Goal they wrote, of any kind — a line they added, a reply to a note, an
@@ -1057,36 +1258,51 @@ var QueueItemSchema = z4.object({
    *  minute after the person speaks erases their instant from it, and the durable traces the client
    *  can see (`replies`, `questions[].answeredAt`) miss a spontaneous note entirely — a `request`
    *  Entry with no `about_id` is in neither. */
-  lastPersonAt: z4.string().nullable().optional()
+  lastPersonAt: z5.string().nullable().optional(),
+  /** WHAT THIS ROW IS, IN TWELVE CHARACTERS (#2928) — the hash of every other field on it, stamped
+   *  by the one projection that builds the row (`apps/api/src/goal/queue.ts`). It is how the
+   *  incremental read knows a row has not moved: the phone echoes back the revs it holds
+   *  (`POST /api/goals/changes`) and is sent only the rows whose rev differs.
+   *
+   *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
+   *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
+   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
+   *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
+  rev: z5.string().optional()
+});
+var QueueDeltaSchema = z5.object({
+  ids: z5.array(z5.string()),
+  items: z5.array(QueueItemSchema)
 });
 var COLD_AFTER_MS = 3 * 24 * 60 * 60 * 1e3;
-var NoteSourceSchema = z4.enum(["app", "call"]);
-var NoteStatusSchema = z4.enum(["open", "assigned", "in_progress", "done"]);
-var NoteRepeatSchema = z4.enum(["once", "until_done"]);
-var DecisionSchema = z4.object({
-  id: z4.string(),
+var NoteSourceSchema = z5.enum(["app", "call"]);
+var NoteStatusSchema = z5.enum(["open", "assigned", "in_progress", "done"]);
+var NoteRepeatSchema = z5.enum(["once", "until_done"]);
+var DecisionSchema = z5.object({
+  id: z5.string(),
   /** The note this decision refines; null = recorded on a bare thread (the
    *  extensibility seam — any conversation can accrue decisions). */
-  noteId: z4.string().nullable(),
+  noteId: z5.string().nullable(),
   /** What was ambiguous — the broker's (or the user's own) question. */
-  question: z4.string(),
+  question: z5.string(),
   /** The user's ruling; null while the question is open. */
-  answer: z4.string().nullable(),
-  decidedAt: z4.string().nullable(),
-  createdAt: z4.string()
+  answer: z5.string().nullable(),
+  decidedAt: z5.string().nullable(),
+  createdAt: z5.string()
 });
-var NoteSchema = z4.object({
-  id: z4.string(),
+var NoteSchema = z5.object({
+  id: z5.string(),
   /** One-line headline (broker-titled; deterministic floor). */
-  title: z4.string(),
+  title: z5.string(),
   /** The original intent, verbatim — assignees always see the user's own words. */
-  intent: z4.string(),
+  intent: z5.string(),
   source: NoteSourceSchema,
   status: NoteStatusSchema,
   /** Who it was assigned to (a participant ref, 'agent:<tokenId>'); null = unassigned. */
-  assignee: z4.string().nullable(),
+  assignee: z5.string().nullable(),
   /** The request thread minted at assignment; null until assigned. */
-  parentId: z4.string().nullable(),
+  parentId: z5.string().nullable(),
   /** REMINDERS (docs/model/notes/reminders-design.md): the NOT-BEFORE this becomes eligible to ride a
    *  call — never a deadline. It only ever comes from the user's own words, so when it
    *  passes Paigy rings ONCE (#1293, owner 2026-08-26: a time said out loud is consent to
@@ -1095,147 +1311,152 @@ var NoteSchema = z4.object({
   //  Defaulted, not required: a Note from an API deploy older than the reminders
   //  migration has none of these, and the defaults ARE what it means — no not-before,
   //  one ride, never ridden. Parsing must not fail across a rolling deploy.
-  dueAt: z4.string().nullable().default(null),
+  dueAt: z5.string().nullable().default(null),
   repeat: NoteRepeatSchema.default("once"),
   /** How many calls have already carried it — the fatigue cap counts rides, not days. */
-  rides: z4.number().int().default(0),
-  lastRideAt: z4.string().nullable().default(null),
-  createdAt: z4.string()
+  rides: z5.number().int().default(0),
+  lastRideAt: z5.string().nullable().default(null),
+  createdAt: z5.string()
 });
-var TriageItemSchema = z4.object({
-  noteId: z4.string(),
+var TriageItemSchema = z5.object({
+  noteId: z5.string(),
   /** The note's headline at run time. */
-  title: z4.string(),
+  title: z5.string(),
   /** WHY, in one short human line, evidence first — this is read on a phone underneath
    *  the note's title: "no movement in 34 days", "worked 3 notes in this repo this week".
    *  Never a model's reasoning transcript, never an id. */
-  why: z4.string()
+  why: z5.string()
 });
-var TriageAssignmentSchema = z4.object({
+var TriageAssignmentSchema = z5.object({
   /** The agent's token id — what `dispatchNote` resolves and what a request is addressed to. */
-  agent: z4.string(),
+  agent: z5.string(),
   /** Its display name at run time (the name on the hatchling's card). Denormalized for the
    *  same reason as `title`: the card must render from the proposal alone. */
-  agentName: z4.string(),
-  notes: z4.array(TriageItemSchema)
+  agentName: z5.string(),
+  notes: z5.array(TriageItemSchema)
 });
-var TriageStatusSchema = z4.enum(["open", "superseded", "dismissed"]);
-var SubmitTriageSchema = z4.object({
+var TriageStatusSchema = z5.enum(["open", "superseded", "dismissed"]);
+var SubmitTriageSchema = z5.object({
   /** Which runtime judged: "ollama" (inference never left the machine) or a harness the
    *  user already runs under their own credentials ("claude" / "codex" / "agy"). Recorded
    *  so the phone can say where the content went — an unattributed privacy claim is worth
    *  nothing, and #1106's promise is precisely "Paigy's servers never see this". */
-  provider: z4.string().min(1).max(60),
+  provider: z5.string().min(1).max(60),
   /** The concrete model when the provider names one (an ollama tag); null otherwise. */
-  model: z4.string().max(200).nullable().optional(),
+  model: z5.string().max(200).nullable().optional(),
   /** How many open notes the run actually looked at — the denominator on the phone
    *  ("6 of 50"), and the honest answer to "did it read the whole queue?". */
-  reviewed: z4.number().int().min(0).max(1e4).default(0),
-  close: z4.array(TriageItemSchema).max(200).default([]),
-  stale: z4.array(TriageItemSchema).max(200).default([]),
-  assign: z4.array(TriageAssignmentSchema).max(50).default([])
+  reviewed: z5.number().int().min(0).max(1e4).default(0),
+  close: z5.array(TriageItemSchema).max(200).default([]),
+  stale: z5.array(TriageItemSchema).max(200).default([]),
+  assign: z5.array(TriageAssignmentSchema).max(50).default([])
 });
 var TriageProposalSchema = SubmitTriageSchema.extend({
-  id: z4.string(),
-  runAt: z4.string(),
+  id: z5.string(),
+  runAt: z5.string(),
   status: TriageStatusSchema,
-  model: z4.string().nullable().default(null)
+  model: z5.string().nullable().default(null)
 });
-var AcceptTriageSchema = z4.discriminatedUnion("group", [
-  z4.object({ group: z4.literal("close"), noteIds: z4.array(z4.string()).max(200).optional() }),
-  z4.object({ group: z4.literal("stale"), noteIds: z4.array(z4.string()).max(200).optional() }),
-  z4.object({
-    group: z4.literal("assign"),
-    agent: z4.string().min(1),
-    noteIds: z4.array(z4.string()).max(200).optional()
+var AcceptTriageSchema = z5.discriminatedUnion("group", [
+  z5.object({ group: z5.literal("close"), noteIds: z5.array(z5.string()).max(200).optional() }),
+  z5.object({ group: z5.literal("stale"), noteIds: z5.array(z5.string()).max(200).optional() }),
+  z5.object({
+    group: z5.literal("assign"),
+    agent: z5.string().min(1),
+    noteIds: z5.array(z5.string()).max(200).optional()
   })
 ]);
-var AcceptTriageResultSchema = z4.object({
-  accepted: z4.array(z4.string()),
-  failed: z4.array(z4.object({ noteId: z4.string(), reason: z4.string() }))
+var AcceptTriageResultSchema = z5.object({
+  accepted: z5.array(z5.string()),
+  failed: z5.array(z5.object({ noteId: z5.string(), reason: z5.string() }))
 });
-var DeliveryModeSchema = z4.enum(["poll", "self_hosted"]);
-var RegisterDeliverySchema = z4.object({ mode: DeliveryModeSchema });
-var OAuthStartSchema = z4.object({
-  provider: z4.enum(["cma"]),
-  returnTo: z4.string().min(1)
+var DeliveryModeSchema = z5.enum(["poll", "self_hosted"]);
+var RegisterDeliverySchema = z5.object({ mode: DeliveryModeSchema });
+var OAuthStartSchema = z5.object({
+  provider: z5.enum(["cma"]),
+  returnTo: z5.string().min(1)
 });
-var DeliveryConfigSchema = z4.object({
-  tokenId: z4.string(),
+var DeliveryConfigSchema = z5.object({
+  tokenId: z5.string(),
   mode: DeliveryModeSchema,
   /** null when the deployment has no anon key configured. `self_hosted` is then REFUSED
    *  (503 `self_hosted_unavailable`) rather than registered, so a self_hosted config always
    *  carries credentials; only a `poll` registration can come back with null here. */
-  realtime: z4.object({ url: z4.string(), anonKey: z4.string() }).nullable()
+  realtime: z5.object({ url: z5.string(), anonKey: z5.string() }).nullable()
 });
-var HostDecisionSchema = z4.object({
+var HostDecisionSchema = z5.object({
   /** The agent's token id: the row's `recipient`. */
-  agent: z4.string().uuid(),
-  decision: z4.enum(["stood_back", "took_over"]),
+  agent: z5.string().uuid(),
+  decision: z5.enum(["stood_back", "took_over"]),
   /** The work it was about: the Goal `claim_goal` would hand that agent next. */
-  goalId: z4.string().uuid().nullable().optional(),
+  goalId: z5.string().uuid().nullable().optional(),
   /** When the server last heard from the agent, as the host read it: the presence it stood back for. */
-  seenAt: z4.string().datetime().nullable().optional(),
-  /** When that work last moved (`claimable.since` on `check_replies`), the fact the bound is judged on. */
-  since: z4.string().datetime().nullable().optional(),
+  seenAt: z5.string().datetime().nullable().optional(),
+  /** When that work last moved (`claimable.since` on an agent's `contact({})` read), the fact the bound is judged on. */
+  since: z5.string().datetime().nullable().optional(),
   /** What the host said, in its log's own words: why it stood back, or what the take-over did. */
-  said: z4.string().max(300).optional()
+  said: z5.string().max(300).optional()
 });
-var WakeNudgeSchema = z4.object({
-  kind: z4.enum(["reply", "request", "callback"]),
-  notificationId: z4.string().optional(),
-  parentId: z4.string()
+var WakeNudgeSchema = z5.object({
+  kind: z5.enum(["reply", "request", "callback"]),
+  notificationId: z5.string().optional(),
+  parentId: z5.string()
 });
-var PairingStatusSchema = z4.enum(["pending", "approved", "denied", "expired"]);
-var DeviceCodeSchema = z4.object({
-  device_code: z4.string(),
-  user_code: z4.string(),
-  verification_uri: z4.string().url(),
-  verification_uri_complete: z4.string().url(),
-  interval: z4.number(),
-  expires_in: z4.number()
+var PairingStatusSchema = z5.enum(["pending", "approved", "denied", "expired"]);
+var DeviceCodeSchema = z5.object({
+  device_code: z5.string(),
+  user_code: z5.string(),
+  verification_uri: z5.string().url(),
+  verification_uri_complete: z5.string().url(),
+  interval: z5.number(),
+  expires_in: z5.number()
 });
-var DeviceInfoSchema = z4.object({
-  code: z4.string(),
+var DeviceInfoSchema = z5.object({
+  code: z5.string(),
   /** The agent's suggested name (from /device/code) — shown on the approval screen,
    *  pre-filling the name field the human can edit. */
-  name: z4.string(),
+  name: z5.string(),
   /** @deprecated Legacy alias of `name` for the pre-#531 embedded bundle in App Store
    *  build 35, whose DeviceFlow renders `info.agent.slice(0, 2)` — without this a FRESH
    *  install crashes on the pairing screen on first launch, before the OTA lands
    *  (seen live: PAIGY-5T, 2026-07-21). Remove once a newer binary is the floor. */
-  agent: z4.string().optional(),
-  device: z4.string().nullable(),
+  agent: z5.string().optional(),
+  device: z5.string().nullable(),
   status: PairingStatusSchema
 });
-var DeviceTokenSchema = z4.object({
-  access_token: z4.string(),
+var DeviceTokenSchema = z5.object({
+  access_token: z5.string(),
   /** The pairing's single name (user-typed at approval, the agent's suggestion, or
    *  a default silly name). */
-  name: z4.string(),
-  device: z4.string().nullable(),
+  name: z5.string(),
+  device: z5.string().nullable(),
   /** The pairing's assigned voice, cached so the desktop can seed the SAME face the phone
    *  draws — voice is the third ingredient of a hatchling's build (party/traits.ts). */
-  voice: z4.string().nullable().optional(),
+  voice: z5.string().nullable().optional(),
   /** The token's server-side id — the face's COLOUR anchor, and the only seed ingredient
    *  that survives a rename. Cached by the host's identity beat. */
-  token_id: z4.string().nullable().optional(),
+  token_id: z5.string().nullable().optional(),
   /** WHERE this identity works — the folder a wake should land it in. Written by the host
    *  at spawn and by `paigy-harness handoff` from a live terminal. Without it every wake
    *  landed in the FIRST granted workspace and the agent rediscovered its own repo from
    *  the thread each time (host.ts, live catch 2026-08-06 — prompt-papered until now). */
-  workspace: z4.string().nullable().optional(),
+  workspace: z5.string().nullable().optional(),
   /** Local host recovery must preserve the launch's runtime and Paigy identity. */
-  harness: z4.enum(["claude", "codex", "agy"]).optional(),
-  session_id: z4.string().uuid().optional(),
-  uik_pub: z4.string().nullable().optional()
+  harness: z5.enum(["claude", "codex", "agy"]).optional(),
+  session_id: z5.string().uuid().optional(),
+  /** A conversation the host must not resume: its context is full, so every turn fails
+   *  ("Prompt is too long"). Written when a run hits it (`run.ts` `onFull`); the host skips a slot
+   *  whose resumable session is this one, so its Goals reach the dead-agent handoff instead of a
+   *  copy that types the person's words into a turn that cannot run (Calls, 2026-10-06). */
+  full_session: z5.string().optional(),
+  uik_pub: z5.string().nullable().optional()
 });
-var SupportRequestSchema = z4.object({
-  email: z4.string().email().max(320),
-  message: z4.string().trim().min(1).max(5e3),
-  name: z4.string().trim().max(120).optional()
+var SupportRequestSchema = z5.object({
+  email: z5.string().email().max(320),
+  message: z5.string().trim().min(1).max(5e3),
+  name: z5.string().trim().max(120).optional()
 });
-var NotificationFeedbackKindSchema = z4.enum([
+var NotificationFeedbackKindSchema = z5.enum([
   "break_down",
   // "This should be more than one ask — break it down."
   "regenerate_options",
@@ -1250,116 +1471,116 @@ var NotificationFeedbackKindSchema = z4.enum([
   // anything else — the note carries it.
 ]);
 var SlimOptionSchema = OptionSchema.omit({ html: true });
-var QuestionRowSchema = z4.object({
+var QuestionRowSchema = z5.object({
   /** The card's id (`deliveryId:needId`, or `deliveryId:entryId` for an update), as the inbox mints it. */
-  id: z4.string(),
-  deliveryId: z4.string(),
-  entryId: z4.string(),
+  id: z5.string(),
+  deliveryId: z5.string(),
+  entryId: z5.string(),
   /** The decision it waits on; null for an update, which asks nothing. */
-  needId: z4.string().nullable(),
-  goalIds: z4.array(z4.string()),
+  needId: z5.string().nullable(),
+  goalIds: z5.array(z5.string()),
   /** The name of the work it is about, when the read could word it. */
-  goalTitle: z4.string().optional(),
-  tokenId: z4.string().optional(),
-  name: z4.string(),
-  title: z4.string(),
-  body: z4.string(),
-  select: z4.enum(["one", "many", "rank", "confirm", "text"]),
-  options: z4.array(SlimOptionSchema),
-  hasPreview: z4.boolean(),
-  blocking: z4.boolean(),
-  askedAt: z4.string().datetime(),
+  goalTitle: z5.string().optional(),
+  tokenId: z5.string().optional(),
+  name: z5.string(),
+  title: z5.string(),
+  body: z5.string(),
+  select: z5.enum(["one", "many", "rank", "confirm", "text"]),
+  options: z5.array(SlimOptionSchema),
+  hasPreview: z5.boolean(),
+  blocking: z5.boolean(),
+  askedAt: z5.string().datetime(),
   ring: InboxItemSchema.shape.ring,
-  onCall: z4.literal(true).optional(),
-  sealed: z4.boolean()
+  onCall: z5.literal(true).optional(),
+  sealed: z5.boolean()
 });
-var WorkStateSchema = z4.enum(["ready", "active", "waiting", "done", "cancelled"]);
-var WorkRowSchema = z4.object({
-  id: z4.string(),
-  parentId: z4.string().nullable(),
-  title: z4.string(),
+var WorkStateSchema = z5.enum(["ready", "active", "waiting", "done", "cancelled"]);
+var WorkRowSchema = z5.object({
+  id: z5.string(),
+  parentId: z5.string().nullable(),
+  title: z5.string(),
   /** Straight off the Goal. */
   state: WorkStateSchema,
-  owner: z4.string().nullable(),
-  revision: z4.number().int(),
+  owner: z5.string().nullable(),
+  revision: z5.number().int(),
   /** Open questions on it, counted to 100. */
-  waiting: z4.number().int(),
+  waiting: z5.number().int(),
   /** Held by a gate on work that is not done. */
-  blocked: z4.boolean(),
-  lastProgressAt: z4.string().datetime().nullable(),
+  blocked: z5.boolean(),
+  lastProgressAt: z5.string().datetime().nullable(),
   /** The line written for its newest progress note, else that note's first words. */
-  line: z4.string().nullable(),
+  line: z5.string().nullable(),
   /** Work directly under it, counted to 100; the list carries up to 12 of them. */
-  children: z4.number().int(),
-  createdAt: z4.string().datetime(),
-  updatedAt: z4.string().datetime(),
+  children: z5.number().int(),
+  createdAt: z5.string().datetime(),
+  updatedAt: z5.string().datetime(),
   /** When anything at or under it last moved — the order the list is in. */
-  activeAt: z4.string().datetime(),
+  activeAt: z5.string().datetime(),
   /** A sealed outcome has no title here; the work's page opens it. */
-  sealed: z4.boolean()
+  sealed: z5.boolean()
 });
 var ComputerRowSchema = ConnectionSummarySchema.omit({ activity: true });
 var AgentRowSchema = ComputerRowSchema.extend({
   /** Open questions it is asking the person, over every open card; null when that read failed. */
-  asking: z4.number().int().nullable(),
-  oldestAskAt: z4.string().datetime().nullable(),
+  asking: z5.number().int().nullable(),
+  oldestAskAt: z5.string().datetime().nullable(),
   /** Up to three of the live Goals it holds, oldest first (the order it picks them up), and how
    *  many in all among the account's 200 most recently active agent-held live Goals
    *  (`agent_holds`); null when that read failed. */
-  holds: z4.array(z4.object({ id: z4.string(), title: z4.string() })).nullable(),
-  held: z4.number().int().nullable(),
+  holds: z5.array(z5.object({ id: z5.string(), title: z5.string() })).nullable(),
+  held: z5.number().int().nullable(),
   /** The earliest instant any Goal it holds went quiet, by the one rule (`coldSince`); null
    *  while none has, or when that read failed. */
-  cold: z4.string().datetime().nullable(),
+  cold: z5.string().datetime().nullable(),
   /** The newest line of its working log, and when the harness saw it. */
-  line: z4.string().nullable(),
-  lineAt: z4.string().datetime().nullable()
+  line: z5.string().nullable(),
+  lineAt: z5.string().datetime().nullable()
 });
-var SnapshotSchema = z4.object({
+var SnapshotSchema = z5.object({
   /** The API's clock, taken before the first read: what a later delta will start from. */
-  at: z4.string().datetime(),
-  questions: z4.object({
+  at: z5.string().datetime(),
+  questions: z5.object({
     /** The newest 30 open cards, questions before updates. */
-    items: z4.array(QuestionRowSchema),
+    items: z5.array(QuestionRowSchema),
     /** Every open question, and apart from them every update, and what was put off. */
-    total: z4.number().int(),
-    updates: z4.number().int(),
-    putOff: z4.number().int()
+    total: z5.number().int(),
+    updates: z5.number().int(),
+    putOff: z5.number().int()
   }).nullable(),
-  agents: z4.object({
+  agents: z5.object({
     /** Up to 60, most recently seen first. */
-    items: z4.array(AgentRowSchema),
-    more: z4.boolean()
+    items: z5.array(AgentRowSchema),
+    more: z5.boolean()
   }).nullable(),
-  work: z4.object({
+  work: z5.object({
     /** The 60 most recently active roots, each followed by up to 12 children; 240 rows at most. */
-    items: z4.array(WorkRowSchema),
+    items: z5.array(WorkRowSchema),
     /** How much work is behind each of the Work tab's four filters, each counted to 100, read with
      *  the rows. `work_list` (20260928023533) owns the predicates: Live is `ready`, `active` or
      *  `waiting`; Waiting on you is live work with an open question or an unmet gate; Not started
      *  is `ready`; Done is `done` or `cancelled`. */
-    counts: z4.object({ live: z4.number().int(), waiting: z4.number().int(), notStarted: z4.number().int(), done: z4.number().int() })
+    counts: z5.object({ live: z5.number().int(), waiting: z5.number().int(), notStarted: z5.number().int(), done: z5.number().int() })
   }).nullable(),
-  you: z4.object({
+  you: z5.object({
     settings: UserSettingsSchema,
-    callable: z4.boolean(),
+    callable: z5.boolean(),
     /** Up to 20 paired computers; null when the roster read failed. */
-    computers: z4.array(ComputerRowSchema).nullable()
+    computers: z5.array(ComputerRowSchema).nullable()
   }).nullable()
 });
-var CallRecapSchema = z4.object({
-  call: z4.object({
-    status: z4.string(),
-    startedAt: z4.string(),
-    durationMs: z4.number().nullable(),
-    agents: z4.array(z4.object({ id: z4.string(), name: z4.string().nullable() }))
+var CallRecapSchema = z5.object({
+  call: z5.object({
+    status: z5.string(),
+    startedAt: z5.string(),
+    durationMs: z5.number().nullable(),
+    agents: z5.array(z5.object({ id: z5.string(), name: z5.string().nullable() }))
   }),
-  topics: z4.array(z4.object({
-    goalId: z4.string().uuid(),
-    title: z4.string(),
-    owner: z4.string(),
-    state: z4.string(),
-    questions: z4.array(z4.object({ id: z4.string().uuid(), state: z4.string(), title: z4.string() })),
+  topics: z5.array(z5.object({
+    goalId: z5.string().uuid(),
+    title: z5.string(),
+    owner: z5.string(),
+    state: z5.string(),
+    questions: z5.array(z5.object({ id: z5.string().uuid(), state: z5.string(), title: z5.string() })),
     /** `words` is always what they SAID, verbatim — the record, never replaced. `headline` is
      *  their answer on one line when the call's read wrote one (owner, 2026-10-01: "render them
      *  summarized like a pre-made option is"), so the row scans like a chosen option and their
@@ -1367,17 +1588,18 @@ var CallRecapSchema = z4.object({
      *  anything that is not an answer. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: z4.array(z4.object({ entryId: z4.string().uuid(), words: z4.string(), headline: z4.string().optional(), about: z4.string().nullable().optional() }))
+    lines: z5.array(z5.object({ entryId: z5.string().uuid(), words: z5.string(), headline: z5.string().optional(), about: z5.string().nullable().optional() }))
   })),
-  unfiled: z4.array(z4.object({ lineId: z4.string().uuid(), words: z4.string(), atMs: z4.number() })),
-  more: z4.object({ lines: z4.number(), entries: z4.number(), topics: z4.number() })
+  unfiled: z5.array(z5.object({ lineId: z5.string().uuid(), words: z5.string(), atMs: z5.number() })),
+  more: z5.object({ lines: z5.number(), entries: z5.number(), topics: z5.number() })
 });
 
 // src/listening.ts
+import { createHash } from "crypto";
 import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
-var HARNESS_MARKS = ["PAIGY_HARNESS", "PAIGY_SESSION_ID"];
+var HARNESS_MARKS = ["PAIGY_HARNESS"];
 function harnessDriven(env) {
   return HARNESS_MARKS.some((mark) => !!env[mark]);
 }
@@ -1390,7 +1612,7 @@ function sessionStartHook() {
 [ -f "\${HOME}/.paigy/token.json" ] || exit 0  # not paired on this machine: nothing to listen as
 cat <<'PAIGY'
 Paigy: nothing pushes answers into a session started in a terminal \u2014 an answer waits for your
-next check_replies. Start your own listener now, as a BACKGROUND task whose output you watch
+next contact({ wait: false }). Start your own listener now, as a BACKGROUND task whose output you watch
 (your harness's monitor/background-task tool), and leave it running for this session:
 
   npx -y -p @paigy/mcp@latest paigy-listen
@@ -1433,11 +1655,12 @@ function decideListen(f) {
     };
   }
   if (f.pidAlive && f.pid !== void 0) {
-    return { status: "listening", via: "daemon", pid: f.pid, message: `Already listening (paigy-listen pid ${f.pid}). Do nothing.` };
+    const connected = f.wake?.ready === true && (f.wake.target.kind !== "codex" || f.wake.target.thread === f.env.CODEX_THREAD_ID);
+    return { status: connected ? "listening" : "receiving", via: "daemon", pid: f.pid, ...f.wake ? { wake: f.wake } : {}, message: connected ? `Listener running (pid ${f.pid}); wake adapter ready. A queued message is not proof the agent handled it.` : `Listener running (pid ${f.pid}), but automatic session resume is not confirmed${f.wake?.lastError ? `: ${f.wake.lastError}` : ". Watch its output or configure a supported wake adapter"}. Do not start a second listener.` };
   }
   return {
     status: "start",
-    command: `PAIGY_AGENT=${word(f.slot)} PAIGY_SESSION_ID=${word(f.session)} ${word(f.execPath)} ${word(f.listenJs)} --brief`,
+    command: `PAIGY_AGENT=${word(f.slot)} PAIGY_SESSION_ID=${word(f.session)} ${f.env.CODEX_THREAD_ID ? `CODEX_THREAD_ID=${word(f.env.CODEX_THREAD_ID)} ` : ""}${f.env.PAIGY_ON_WAKE ? `PAIGY_ON_WAKE=${word(f.env.PAIGY_ON_WAKE)} ` : ""}${word(f.execPath)} ${word(f.listenJs)} --brief`,
     how: "Run this command NOW as a watched background task (your harness's background-task/monitor tool), and leave it running for this session. Each line it prints is a Delivery waiting for you: claim_goal the Goal it names, read it, and answer with contact. Start it once."
   };
 }
@@ -1475,16 +1698,28 @@ function listenerAlive(slot, home = homedir()) {
     return null;
   }
 }
+function listenerKey(slot, env) {
+  return env.CODEX_THREAD_ID ? `${slot}-${createHash("sha256").update(env.CODEX_THREAD_ID).digest("hex")}` : slot;
+}
+function wakeStatusPath(slot, home = homedir()) {
+  return `${listenMark(slot, home)}.wake.json`;
+}
+function existingListener(slot, env, home = homedir()) {
+  return listenerAlive(listenerKey(slot, env), home) ?? (env.CODEX_THREAD_ID ? listenerAlive(slot, home) : null);
+}
 
 export {
   mcpInputSchema,
   AGENT_TOOLS,
   serverInstructions,
   entryWords,
+  harnessDriven,
   sessionStartHook,
   withSessionStartHook,
   decideListen,
   writeListenMark,
   removeListenMark,
-  listenerAlive
+  listenerKey,
+  wakeStatusPath,
+  existingListener
 };