@paigy/mcp 0.40.38 → 0.40.40

package/dist/{chunk-4PP522IN.js → chunk-V4OVLFMP.js}

@@ -1,4 +1,4 @@
-// ../../../../../../private/tmp/paigy-draft-reaches/packages/sdk/dist/index.js
+// ../../packages/sdk/dist/index.js
 import { createRequire as __sdkCreateRequire } from "module";
 import { execFileSync } from "child_process";
 import { createHash, randomUUID } from "crypto";
@@ -59,6 +59,24 @@ function parentOf(pid) {
     return void 0;
   }
 }
+var CODEX_PARENT = /(^|\/)\.codex\/|CodexCLI\.app|(^|[\/\s])codex(\s|$)/;
+var codexParent;
+function underCodex() {
+  if (codexParent !== void 0) return codexParent;
+  codexParent = false;
+  if (process.platform === "win32") return codexParent;
+  for (const pid of ancestors()) {
+    try {
+      const command = execFileSync("ps", ["-o", "command=", "-p", String(pid)], { encoding: "utf8", timeout: 1e3 });
+      if (CODEX_PARENT.test(command)) {
+        codexParent = true;
+        break;
+      }
+    } catch {
+    }
+  }
+  return codexParent;
+}
 var lineage;
 function ancestors() {
   if (lineage) return lineage;
@@ -116,7 +134,8 @@ function parseSessionRecord(text) {
   return void 0;
 }
 function sessionId() {
-  return envSession("PAIGY_SESSION_ID") ?? claudeConversation() ?? envSession("CLAUDE_CODE_SESSION_ID") ?? envSession("CODEX_THREAD_ID") ?? envSession("CODEX_SESSION_ID") ?? WORKSPACE_ID;
+  return envSession("PAIGY_SESSION_ID") ?? claudeConversation() ?? envSession("CLAUDE_CODE_SESSION_ID") ?? envSession("CODEX_THREAD_ID") ?? envSession("CODEX_SESSION_ID") ?? // A Codex thread that was handed no id is its own agent, not the folder's (`underCodex`).
+  (underCodex() ? INSTANCE_ID : WORKSPACE_ID);
 }
 function isNetworkError(e) {
   return e instanceof Error && e.message.startsWith(NETWORK_MSG);
@@ -1498,16 +1517,16 @@ function parseWhen(said2, tz, nowMs, read22 = "earliest") {
   let hour = null;
   let minute = 0;
   const spoken = new RegExp(`\\bat\\s+(${Object.keys(SPOKEN_HOUR).join("|")})\\b`, "i").exec(text);
-  const clock3 = CLOCK.exec(text);
+  const clock2 = CLOCK.exec(text);
   if (spoken) {
     hour = SPOKEN_HOUR[spoken[1].toLowerCase()];
-  } else if (clock3 && (clock3[3] || /\bat\s/i.test(clock3[0]))) {
-    hour = Number(clock3[1]);
-    minute = clock3[2] ? Number(clock3[2]) : 0;
+  } else if (clock2 && (clock2[3] || /\bat\s/i.test(clock2[0]))) {
+    hour = Number(clock2[1]);
+    minute = clock2[2] ? Number(clock2[2]) : 0;
     if (hour > 23 || minute > 59) return null;
   }
   if (hour !== null) {
-    const mer = clock3?.[3]?.toLowerCase().replace(/\./g, "") ?? "";
+    const mer = clock2?.[3]?.toLowerCase().replace(/\./g, "") ?? "";
     const pmWord = /\b(p\.?m\.?|afternoon|evening|tonight|at night)\b/i.test(text);
     const amWord = /\b(a\.?m\.?|morning)\b/i.test(text);
     if (mer.startsWith("p") || pmWord && !amWord) {
@@ -1551,7 +1570,7 @@ function parseDelay(said2, tz, nowMs, read22 = "earliest") {
   return Math.max(0, Math.round((Date.parse(at2) - nowMs) / 1e3));
 }
 var NIGHT = { from: 23, to: 7 };
-var ASK_MAX = 250;
+var ASK_MAX = 80;
 var UNITS_MAX = 12;
 var UNIT_TITLE_MAX = 50;
 var UNIT_BODY_MAX = 200;
@@ -1616,15 +1635,15 @@ var CompletionSchema = z3.object({
 }).strict();
 var CompleteChangeSchema = CompletionSchema.extend({ kind: z3.literal("complete") });
 var ASKING_RULES = `HOW TO ASK:
-1. Write one question per object. Five questions are five objects in \`questions\`, 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 question's \`goalId\`: the question goes onto that Goal and its answer comes back there. It must exist: create it with manage_goals first.
-3. \`workItBlocks\` only for work you are truly blocked on (it asks for a call); leave it out for a question you can keep working around.
-4. Never hold the process open with while-loops. A wait that comes back \`expired\` is not a finished conversation: wait again with contact({wait:true}) only while you have nothing else to do. While a Call you placed is open, keep receiving window after window until it ends, even when a window is empty: the person may give follow-ups or instructions. With no open Call, STOP WAITING when a window comes back with nothing new \u2014 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 \`get_goals\` on that wake.
-5. One question, 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. Take back one that no longer matters with \`withdrawQuestionIds\`.
-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 when you have them; a free-text question may omit them. Each option\u2019s label must stand on its own and name its choice in full -- never \`All three\` or \`Option 2\`. \`pickMode: "many"\` makes the card a checklist (options they may want several of); \`"one"\`, the default, a pick (one rules out the others); \`"rank"\` an ordering. Each question is sent exactly as written, with no reading in between. They can always answer in their own words, so never add an 'Other' option.
-8. A diagnosis says when, why and how it happens, then proposes one fix. Never options first.
-9. GIVE A REPORT ITS REPLY: an update takes \`reply\` too, one line the person can tap instead of typing, written in THEIR voice for THAT report ("Sounds good, I'll test later") \u2014 the same care you give a question's options. What they tap is what you read back, which tells you whether they verified your work or only received it. One line, because a report has one way to close, and it may not change what happens next: a reply that would is a question. Requested delivery and completed-Goal reports require a reply (reply_required); ordinary progress may omit it.`;
+1. One question per object in \`questions\`, so each is answered on its own.
+2. \`goalId\` names the existing Goal it is about (create one with manage_goals first); the answer comes back there.
+3. \`workItBlocks\` only when you are truly blocked: it asks for a call.
+4. No while-loops. While any Call is open, even one your question joined from their items, keep receiving through empty windows; otherwise stop at one: the answer reaches you on the Goal. Yield only with a listener or wakeup.
+5. One question, one row: never re-send one still waiting; take back one that no longer matters with \`withdrawQuestionIds\`.
+6. Read the Goal before asking; never re-ask what was answered or shipped. \`replied\` means they chose no option: it is still yours to settle.
+7. Give options when you have them. Each label names its choice in full (never "Option 2"); never add "Other". \`pickMode\`: one (default), many, rank.
+8. A diagnosis says when, why and how it happens, then proposes one fix.
+9. Give a report its \`reply\`: one line in THEIR voice for THAT report, so you learn whether they verified it or only received it. Required when it reaches them or completes a Goal.`;
 function draft2020(node) {
   if (Array.isArray(node)) return node.map(draft2020);
   if (node && typeof node === "object") {
@@ -1667,7 +1686,7 @@ var userExplicitlyRequested = z4.enum(["any", "call"]).optional().describe(
   `Only what the person said about THIS message, in so many words: "any" when they asked you to send it to them ("send it to my phone", "message me the result"), "call" when they asked to be called about it. It is then delivered (a call rings for the whole contact, and carries everything waiting on them); omitted, an update is only recorded as the Goal's progress unless the person needs it. Never set it to make a message louder.`
 );
 var units = z4.array(UnitInputSchema).optional().describe(
-  `The context this message needs, as up to ${UNITS_MAX} units in reading order, each {title, body}: a title of at most ${UNIT_TITLE_MAX} characters and a body of at most ${UNIT_BODY_MAX}. One idea per unit. Leave it out when the main text says it all.`
+  `The context this message needs, as up to ${UNITS_MAX} units in reading order, each {title, body}: a title of at most ${UNIT_TITLE_MAX} characters and a body of at most ${UNIT_BODY_MAX}. One idea per unit. Leave it out when the main text says it all. Over a cap is refused by name (ask_too_long, too_many_units, unit_title_too_long, unit_body_too_long) and nothing is sent.`
 );
 var UpdateInputSchema = z4.object({
   message: z4.string().trim().min(1).describe(`The one point, at most ${ASK_MAX} characters; the context goes in units.`),
@@ -1722,7 +1741,7 @@ var questionFields = {
   ),
   goalId: z4.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
   units,
-  options: z4.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200."),
+  options: z4.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own, at most 50 characters; a hint, at most 200. They can always answer in their own words, so no 'Other' or 'None of these'."),
   // 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). The app draws all three.
   pickMode: z4.enum(["one", "many", "rank"]).optional().describe(
@@ -1764,7 +1783,9 @@ var QuestionDependencySchema = z4.object({
   reason: reason.optional()
 }).strict().refine(actionFits, ACTION_FITS);
 var sendFields = {
-  completions: z4.array(CompletionSchema).min(1).max(20).optional().describe("Close existing Goals and deliver their completion reports atomically. Ordinary updates never close work."),
+  completions: z4.array(CompletionSchema).min(1).max(20).optional().describe(
+    "COMPLETIONS close and report in one operation, the same contract as manage_goals kind:complete: closure and the report commit together or neither does. Required children and dependencies must already be finished. options suggest next steps: a tap acknowledges the report and requests that step, and never reopens the Goal (follow-up work needs a new one). No reviewer rejudges it: say only what your evidence supports. Ordinary updates never close a Goal."
+  ),
   updates: z4.array(UpdateInputSchema).min(1).max(20).optional().describe(
     "News: progress, findings, a result. An update asks nothing. It reaches the person only when they asked for it (userExplicitlyRequested), when it answers something they said, or once its Goal is done; otherwise it is recorded as the Goal's progress and nobody is notified."
   ),
@@ -1778,7 +1799,7 @@ var sendFields = {
 };
 var ContactSchema = z4.object({
   ...sendFields,
-  questions: z4.array(QuestionInputSchema).min(1).max(20).optional().describe("Questions for the person, one per object."),
+  questions: z4.array(QuestionInputSchema).min(1).max(20).optional().describe("Questions for the person, one per object, each sent exactly as written, with no reading in between."),
   /** RECEIVING (2I, I2; brain_prompts.md §2.2): the events this agent handled. */
   ackEventIds: z4.array(z4.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 (answers), never acknowledged away."
@@ -1794,15 +1815,13 @@ var ContactWireSchema = z4.object({
   questions: z4.array(QuestionWireSchema).min(1).max(20).optional()
 }).strict().refine(sendsAnything, "a contact sends at least one update, question, answer, withdrawal or question dependency");
 var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-var CONTACT_DESCRIPTION = "Send to and receive from the person: completions, updates, questions, answers to questions addressed to you, withdrawals of your own questions, and what a question holds up. Every Goal you name must already exist: create it with manage_goals first; an unknown Goal is refused and nothing is sent. Every item applies on its own: read `results`, where a failed item names why while the rest still apply.\n\n" + ASKING_RULES + `
-
-CUT A LONG MESSAGE BEFORE YOU SEND IT: a question, an update's message or an answer is the one point, in at most ${ASK_MAX} characters; everything else it needs goes in 'units', up to ${UNITS_MAX} {title, body} in reading order, one idea each, every title at most ${UNIT_TITLE_MAX} characters and every body at most ${UNIT_BODY_MAX}. The person sees the main text and the titles, and opens a unit to read its body. Over a cap is refused by name (ask_too_long, too_many_units, unit_title_too_long, unit_body_too_long) and nothing is sent.
+var CONTACT_DESCRIPTION = "Send to and receive from the person: completions, updates, questions, answers to questions addressed to you, withdrawals, and what a question holds up. Every Goal named must exist: an unknown one refuses the whole contact. Each item applies on its own: read `results`, where a failed one names why.\n\n" + ASKING_RULES + `
 
-UPDATES ask nothing, so no answer is owed and none should be awaited. An update reaches the person only when they asked you for it (userExplicitlyRequested), when it answers something they said, or once its Goal is done; any other is recorded as the Goal's progress and nobody is notified. Ordinary updates never close a Goal. On a Goal whose report card is still open, an update that reaches them is added to that card, with no new push. If the person is already on a call, anything that reaches them joins that call, with no ring.
+LENGTH: the question, message or answer is the one point, at most ${ASK_MAX} characters; the rest goes in \`units\`, one idea each. Over a cap is refused by name and nothing is sent. Several results are several updates.
 
-COMPLETIONS close and report in one operation: completions:[{goalId,message,units?,reply,options?}]. The same contract works in manage_goals changes with kind:complete. message is at most 50 characters; use units when useful for initial state, changes, current state (verification and limits), and next steps / leftover work with its owner. reply is one acknowledgement in the person's voice. Optional options:[{label,hint}] suggest next steps: a tap acknowledges the report and requests that step from its author. It never reopens the completed Goal; follow-up work needs a new Goal. Closure and the report commit together or neither does. Required children and dependencies must already be finished. No Reviewer rejudges your completion; say only what your evidence supports.
+UPDATES ask nothing. One reaches the person only when they asked for it, it answers something they said, or its Goal is done; else it is kept as progress. One that reaches them joins an open report card or a live call.
 
-RECEIVING: a contact that sends nothing returns \`events\`, a limited batch of what is addressed to you (not a history page): \`question\`, a Question you owe (answer it in answers, with its questionId); \`update\`, something new on one of your Goals (a reply, an answer: read it with get_goals); \`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\`; your first write to it starts it) and your work gone quiet (\`stalled\`).`;
+RECEIVING: contact({}) waits ~45 s; contact({wait:false}) returns \`events\` at once. Confirm the ones you handled with contact({ackEventIds}).`;
 var CreateGoalSchema = z5.object({
   outcome: z5.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
@@ -2017,11 +2036,28 @@ var messageBase = {
   obligationIds: z6.array(id)
 };
 var BrainMessageSchema = z6.union([
-  z6.object({ ...messageBase, to: z6.object({ kind: z6.literal("user") }).strict() }).strict(),
+  // A MESSAGE TO THE PERSON KEEPS ITS SENTENCES (turns.md): the talker writes them one by one, and each is
+  // its own unit of speech (`<cycle>:<key>:<n>`). `text` is the same words joined, for every reader of a
+  // message's words. Absent on results written before sentences.
+  z6.object({
+    ...messageBase,
+    to: z6.object({ kind: z6.literal("user") }).strict(),
+    sentences: z6.array(z6.string().min(1)).min(1).optional(),
+    // THE REPORTS IT TELLS, BY THEIR OWN IDENTITY (call 9d1c096c, 2026-10-15): the talker's message names the report
+    // Entries it speaks of, so the plan's line names that report rather than re-finding it by its Goal. Absent on
+    // results written before it.
+    tells: z6.array(z6.object({ id }).strict()).optional()
+  }).strict(),
   z6.object({
     ...messageBase,
     to: z6.object({ kind: z6.literal("agent"), agentId: z6.string().regex(/^agent:(?!paigy$)\S+$/) }).strict(),
-    call: z6.object({ callId: id, listen: z6.literal(true) }).strict().optional()
+    call: z6.object({ callId: id, listen: z6.literal(true) }).strict().optional(),
+    // WHAT IT ASKS THE AGENT, IN UNDER TEN WORDS (owner, 2026-10-15: "Yes, add the summary"): the talker's own, stored
+    // as the sent Entry's summary, which the recap's "Sent to <agent>: …" row shows. Absent on results written before it.
+    summary: z6.string().optional(),
+    // THE PERSON ASKED TO BE CALLED BACK ONCE THIS AGENT'S WORK IS DONE (turns.md, step 0): the agent owes
+    // the call, and its next contact about it rings them (`public.callbacks`).
+    callback: z6.literal(true).optional()
   }).strict()
 ]);
 var BrainSearchSchema = z6.object({
@@ -2045,92 +2081,97 @@ var BrainResultSchema = z6.object({
   next: BrainNextSchema,
   search: BrainSearchSchema.optional()
 }).strict();
-var str = z6.string();
+var str2 = z6.string();
 var strs = z6.array(z6.string());
 var CompactResultSchema = z6.object({
-  next: z6.object({ say: strs, then: z6.enum(["listen", "hold", "end", "none"]), waitFor: strs, reason: str, instructions: strs }).strict(),
-  messages: z6.array(z6.object({ key: str, to: str, text: str, about: strs, entries: strs, owed: strs, inviteToCall: z6.boolean() }).strict()),
-  entries: z6.array(z6.object({ key: str, from: str, on: strs }).strict()),
-  answers: z6.array(z6.object({ question: str, entries: strs, summary: str, picked: strs }).strict()),
+  next: z6.object({ say: strs, then: z6.enum(["listen", "hold", "end", "none"]), waitFor: strs, reason: str2, instructions: strs }).strict(),
+  messages: z6.array(z6.object({ key: str2, to: str2, text: str2, about: strs, entries: strs, owed: strs, inviteToCall: z6.boolean() }).strict()),
+  entries: z6.array(z6.object({ key: str2, from: str2, on: strs }).strict()),
+  answers: z6.array(z6.object({ question: str2, entries: strs, summary: str2, picked: strs }).strict()),
   changes: z6.array(z6.object({
-    key: str,
+    key: str2,
     what: z6.enum(["goal", "question", "lesson"]),
     op: z6.enum(["create", "edit", "assign", "open", "complete", "cancel", "defer", "move", "block", "unblock", "withdraw", "remember", "revise"]),
-    id: str,
-    text: str,
-    title: str,
-    who: str,
-    under: str,
+    id: str2,
+    text: str2,
+    title: str2,
+    who: str2,
+    under: str2,
     gate: z6.enum(["start", "complete", "answer", "none"]),
-    options: z6.array(z6.object({ id: str, label: str }).strict()),
+    options: z6.array(z6.object({ id: str2, label: str2 }).strict()),
     pick: z6.enum(["one", "many", "rank", "words"]),
     entries: strs
   }).strict()),
   feedback: z6.array(strs),
-  search: z6.object({ query: str, within: strs, goal: str }).strict()
+  search: z6.object({ query: str2, within: strs, goal: str2 }).strict()
 }).strict();
 var COMPACT_RESULT_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(CompactResultSchema, { $refStrategy: "none" })
 );
-var str2 = z7.string();
+var str3 = z7.string();
 var strs2 = z7.array(z7.string());
 var TalkerReplySchema = z7.object({
   /** What to say and send, messages to the person first: spoken in the order written. `to` is "user"
-   *  or an agent's handle; `about` names handles; `blocks` is the item a question to an agent must be
-   *  answered before ("" for none). */
-  messages: z7.array(z7.object({ key: str2, to: str2, text: str2, about: strs2, blocks: str2 }).strict()),
+   *  or an agent's handle; `sentences` is what a message to the person says, one short sentence each
+   *  ([] to an agent); `text` is what a message to an agent says ("" to the person); `summary` is what it
+   *  asks the agent, in under ten words, as the person would put it ("" to the person; owner, 2026-10-15:
+   *  "Yes, add the summary"), which the recap's "Sent to <agent>: …" row shows; `about` names
+   *  handles; `blocks` is the item a question to an agent must be answered before ("" for none);
+   *  `callback` is true on a message to the agent doing work the person asked to be called back about
+   *  once it is done (false otherwise): that agent then owes the call (turns.md, step 0). */
+  messages: z7.array(z7.object({ key: str3, to: str3, sentences: strs2, text: str3, summary: str3, about: strs2, blocks: str3, callback: z7.boolean() }).strict()),
   /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
   then: z7.enum(["listen", "hold", "end"]),
   /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
    *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
    *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
    *  end of this call), a question's handle (that question's answer) or an ISO time. */
-  replies: z7.array(z7.object({ item: str2, options: strs2, lines: strs2, summary: str2, defer: str2 }).strict()),
+  replies: z7.array(z7.object({ item: str3, options: strs2, lines: strs2, summary: str3, defer: str3 }).strict()),
   /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
   instruction: strs2,
   /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
    *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
   file: strs2,
   /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
-  need: z7.object({ kind: z7.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
+  need: z7.object({ kind: z7.enum(["search", "item", "agent", ""]), text: str3 }).strict(),
   /** The handle of the item to explain ("" for none). */
-  explain: str2
+  explain: str3
 }).strict();
 var TALKER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(TalkerReplySchema, { $refStrategy: "none" })
 );
-var str3 = z8.string();
+var str4 = z8.string();
 var strs3 = z8.array(z8.string());
 var FilerReplySchema = z8.object({
   /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
    *  the line says in at most ten words. */
-  filed: z8.array(z8.object({ line: str3, goals: strs3, summary: str3 }).strict()),
+  filed: z8.array(z8.object({ line: str4, goals: strs3, summary: str4 }).strict()),
   goals: z8.array(z8.object({
     op: z8.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
-    key: str3,
-    goal: str3,
-    title: str3,
-    outcome: str3,
-    owner: str3,
-    under: str3,
-    until: str3,
-    on: str3,
+    key: str4,
+    goal: str4,
+    title: str4,
+    outcome: str4,
+    owner: str4,
+    under: str4,
+    until: str4,
+    on: str4,
     gate: z8.enum(["start", "complete", "answer", ""]),
-    why: str3
+    why: str4
   }).strict()),
   questions: z8.array(z8.object({
     op: z8.enum(["create", "edit", "assign", "withdraw"]),
-    key: str3,
-    question: str3,
-    text: str3,
-    summary: str3,
-    to: str3,
-    goal: str3,
-    options: z8.array(z8.object({ id: str3, label: str3 }).strict()),
+    key: str4,
+    question: str4,
+    text: str4,
+    summary: str4,
+    to: str4,
+    goal: str4,
+    options: z8.array(z8.object({ id: str4, label: str4 }).strict()),
     pick: z8.enum(["one", "many", "rank", "words", ""]),
-    blocks: str3
+    blocks: str4
   }).strict()),
-  lessons: z8.array(z8.object({ op: z8.enum(["remember", "revise", "withdraw"]), lesson: str3, text: str3, scope: str3 }).strict()),
+  lessons: z8.array(z8.object({ op: z8.enum(["remember", "revise", "withdraw"]), lesson: str4, text: str4, scope: str4 }).strict()),
   /** Line handles whose words comment on Paigy itself. */
   feedback: strs3
 }).strict();
@@ -2191,6 +2232,27 @@ var TidyReplySchema = z10.object({
 var TIDY_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(TidyReplySchema, { $refStrategy: "none" })
 );
+var HandoutReplySchema = z11.object({
+  assign: z11.array(z11.object({
+    /** The Goal's handle (G). */
+    goal: z11.string(),
+    /** The agent's handle (A). */
+    to: z11.string(),
+    /** At most ten words, naming the Goal of theirs it is most like: the reason the hand-out records. */
+    why: z11.string()
+  }).strict()),
+  /** The Goals no listed agent's work is even loosely like: Paigy starts a session for them (owner, 2026-10-24,
+   *  Goal 37603006, "One per family of related Goals"). */
+  new: z11.array(z11.object({
+    /** The Goal's handle (G). */
+    goal: z11.string(),
+    /** At most ten words: why nothing active fits it. */
+    why: z11.string()
+  }).strict())
+}).strict();
+var HANDOUT_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(HandoutReplySchema, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -2226,42 +2288,6 @@ var LIVE_MS = 3 * 6e4;
 var WORKING_MS = 60 * 6e4;
 var WORKING_TIER_MS = 2 * 60 * 6e4;
 var RECENT_TIER_MS = 24 * 60 * 6e4;
-var json = z11.lazy(() => z11.union([
-  z11.string(),
-  z11.number().finite(),
-  z11.boolean(),
-  z11.null(),
-  z11.array(json),
-  z11.record(json)
-]));
-var clock = z11.number().int().nonnegative().safe();
-var HeardEventSchema = z11.object({
-  eventId: z11.string().uuid(),
-  source: z11.enum(["phone", "bot"]),
-  sequence: clock,
-  kind: z11.string().min(1),
-  phoneAtMs: clock.optional(),
-  botAtMs: clock.optional(),
-  payload: z11.record(json)
-}).strict();
-var HeardCursorSchema = HeardEventSchema.pick({ source: true, sequence: true, eventId: true });
-var HeardPageSchema = z11.object({
-  events: z11.array(HeardEventSchema).max(200),
-  next: HeardCursorSchema.nullable()
-}).strict();
-var MAX_EVENTS = 50;
-var MAX_BYTES = 8e4;
-var batchBytes = (events) => {
-  let bytes = 0;
-  for (const char of JSON.stringify({ events })) {
-    const point = char.codePointAt(0);
-    bytes += point < 128 ? 1 : point < 2048 ? 2 : point < 65536 ? 3 : 4;
-  }
-  return bytes;
-};
-var HeardBatchSchema = z11.object({
-  events: z11.array(HeardEventSchema).min(1).max(MAX_EVENTS)
-}).strict().refine((value) => batchBytes(value.events) <= MAX_BYTES, "heard_batch_too_large");
 var ContextSchema = z12.object({
   title: z12.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: z12.array(z12.string().min(1)).describe(
@@ -2593,6 +2619,10 @@ var AgendaTurnSchema = z12.object({
   /** 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: z12.array(z12.string().min(1)).default([]),
+  /** THE ID OF EACH SENTENCE, when the plan names them (turns.md): a talker message's sentences are its
+   *  `info`, one piece each, and `units[i]` is the id the bot's line receipt carries for `info[i]`
+   *  (`<cycle>:<key>:<n>`), so what was heard is known per sentence. Absent on every other turn. */
+  units: z12.array(z12.string().min(1)).optional(),
   question: z12.string().min(1).nullable(),
   /** True on the one turn carrying the agent's own declared question. */
   asks: z12.boolean().optional(),
@@ -2617,6 +2647,21 @@ var AgendaTurnSchema = z12.object({
    *  the phone (`asking`, so the agenda goes gold and its options show) without treating the line as a
    *  question turn — the talker owns re-asking and the waits, so `question` stays null. */
   onTable: z12.boolean().optional(),
+  /** THE CARRIED ITEM THIS LINE TELLS (Goal 2a1e50eb, owner 2026-10-14: "Build the whole design") — a
+   *  request the Call carries that asks NOTHING: a report, a progress note, another agent's waiting news.
+   *  Its request Entry id, so the phone can make that agenda row the current one while it is read
+   *  (`telling` on the `turn` topic, `docs/clients/app/walk/design.md` §11).
+   *
+   *  A FIELD OF ITS OWN, NEVER `claimId`: the claim is the RETURN identity — answers route by it and the
+   *  record tags the line with it (`workId`) — and an answer must never route to an Entry that asks
+   *  nothing. Absent on a turn speaking for a question (`claimId` says that) and on one speaking for no
+   *  carried item at all (an opener, a sign-off, Paigy's own line). */
+  telling: z12.string().optional(),
+  /** PAIGY'S OWN LINE (owner, 2026-10-15; calls ed2cbdce, ad50ad25): a turn that speaks for no item -- an
+   *  opener, a sign-off, a reply about nothing an agent asked or told -- is recorded as Paigy's, not as the
+   *  agent that rang. Absent on every turn that speaks for an item (`agentId` names whose), and on plans
+   *  from before it: a bot that does not know it records the ringing agent, as before. */
+  speaksFor: z12.literal("paigy").optional(),
   select: SelectShapeSchema.optional(),
   options: z12.array(OptionSchema.omit({ id: true })).optional(),
   /* `pace` STOOD HERE (#826). A turn could carry seconds and the model chose them. The walk
@@ -2705,7 +2750,7 @@ var InboxItemSchema = z12.object({
   questions: z12.array(CallQuestionSchema).optional(),
   /** The same call carrying order, including request Entries with no DecisionNeed as reports.
    *  Additive: questions stays decision-only for every other surface and older bundles. */
-  callItems: z12.array(CallQuestionSchema.extend({ state: z12.enum(["open", "answered", "report"]) })).optional(),
+  callItems: z12.array(CallQuestionSchema.extend({ state: z12.enum(["open", "answered", "report"]), acknowledged: z12.boolean().optional() })).optional(),
   visuals: z12.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
    *  agent's suggestion, or a default silly name). */
@@ -2770,6 +2815,21 @@ var InboxItemSchema = z12.object({
    *  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: z12.boolean().default(false),
+  /** WHAT FREED THIS QUESTION (owner, 2026-10-16, Goal 2383ef14: "we don't really show the question
+   *  at the top until the question it could reply to with is resolved. And then we show it again
+   *  with the context of the other thing that was resolved"; asked how it should carry that, "The
+   *  answer above it"). A question they answered with a question of their own waits for theirs
+   *  (`private.ask_back`) and drops out of the front while it waits; when it comes back, the card
+   *  draws their question and the answer it got ABOVE the ask, as one card. Absent on a question
+   *  nothing ever held back. */
+  freedBy: z12.object({
+    questionId: z12.string(),
+    asked: z12.string(),
+    answer: z12.string(),
+    answeredAt: z12.string(),
+    /** The answer in ten words, when the talker wrote one beside it. */
+    summary: z12.string().optional()
+  }).optional(),
   /** 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,
@@ -2829,8 +2889,8 @@ var MissedCallSchema = z12.enum([
   "inbox",
   "dismiss"
 ]);
-var clock2 = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
-var QUIET = ` Nothing rings from ${clock2(NIGHT.from)} to ${clock2(NIGHT.to)} your time; the count waits for morning.`;
+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 = z12.object({
   /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
   ackVerbosity: z12.enum(["normal", "none"]).optional(),
@@ -3167,6 +3227,13 @@ var QueueItemSchema = z12.object({
    *  can see (`replies`, `questions[].answeredAt`) miss a spontaneous note entirely — a `request`
    *  Entry with no `about_id` is in neither. */
   lastPersonAt: z12.string().nullable().optional(),
+  /** EACH SIDE'S NEWEST WORD IN THE LAST DAY (owner, 2026-10-13, the Work tab's order): the person's
+   *  (`yours`) and the agents' (`theirs`), each null when that side wrote nothing on it in 24 hours.
+   *  `latest` holds one Entry, so whichever side wrote first is hidden there; Work orders a Goal by
+   *  these two and draws the side it was placed by under its title. Optional, so hand-built queues
+   *  and a door older than 20261013045542 need not spell them. */
+  yours: GoalLatestSchema.nullable().optional(),
+  theirs: GoalLatestSchema.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
@@ -3440,10 +3507,20 @@ var CallRecapSchema = z12.object({
     title: z12.string(),
     owner: z12.string(),
     state: z12.string(),
+    /** Presented Entry content and its author, separately from the current Goal owner. */
+    items: z12.array(z12.object({ entryId: z12.string(), author: z12.string(), text: z12.string(), summary: z12.string().nullable(), acknowledged: z12.boolean().optional() })).optional(),
     /** Whether the call put it to the person. An item it carried and never said has no row on the
      *  review (owner, 2026-10-08: "why do we get the third one when it didn't happen in the call?"). */
     presented: z12.boolean(),
-    questions: z12.array(z12.object({ id: z12.string().uuid(), state: z12.string(), title: z12.string() })),
+    /** Whether THIS call created it — the third way a call touches work, beside carrying a request
+     *  there and filing words there (owner, 2026-10-08, Goal `5b4b1a0a`: "Show the new work, keep my
+     *  words under it"). Created work is never carried, so it is never `presented`; without this the
+     *  row is dropped by the "only what happened on the call" filter. False on a database before
+     *  20261013080133. */
+    created: z12.boolean(),
+    /** `request` is the Entry that asked it — what a line's `about` names when the line answered or put
+     *  it off. Optional: an older API sent none. */
+    questions: z12.array(z12.object({ id: z12.string().uuid(), state: z12.string(), title: z12.string(), request: z12.string().optional() })),
     /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
      *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
      *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
@@ -3479,7 +3556,44 @@ var CallRecapSchema = z12.object({
   })),
   more: z12.object({ lines: z12.number(), entries: z12.number(), topics: z12.number() }),
   /** Last stored position on this page when another exists; absent before paging shipped. */
-  next: z12.number().int().nonnegative().nullable().optional()
+  next: z12.number().int().nonnegative().nullable().optional(),
+  /** THE CALL AS ONE LIST OF ROWS (owner, 2026-10-14: "we only really want a thing like transcript but
+   *  built from the summaries", then "the transcript tabs should show the same but with full words").
+   *  Both tabs draw these rows, in this order: Summary from `summary`, Transcript from `words`.
+   *  - `put`: an item put to the person, at the first agent line that voiced it. Paigy's sentences
+   *    that voiced it are folded into `spoken`, never rows of their own.
+   *  - `said`: the person's words, one row per reply or per filed line no reply covers.
+   *  - `did`: what Paigy did ("Sent to Mouth: …", "Recorded: …", "Filed on …").
+   *  `by` is the row's real author, never inferred from `kind`: a relay Paigy sent to an agent is
+   *  Paigy's, not the person's. Optional and additive (owner: "make sure whatever you do is backward
+   *  compatible"): an API before it sends none, and the screen falls back to `topics` and `said`. */
+  timeline: z12.array(z12.object({
+    id: z12.string(),
+    position: z12.number(),
+    atMs: z12.number(),
+    kind: z12.enum(["put", "said", "did"]),
+    by: z12.object({ participant: z12.string().nullable(), agentId: z12.string().nullable(), name: z12.string().nullable() }),
+    goalId: z12.string().uuid().nullable(),
+    requestId: z12.string().nullable(),
+    summary: z12.string().nullable(),
+    words: z12.string(),
+    /** Paigy's sentences folded into this row: on a `put` row, what it said putting the item to the
+     *  person (before their next row); on a `said` row, what it said in reply (until their next row).
+     *  `atMs` is when each was said; optional, absent before 2026-10-14's fix. */
+    spoken: z12.array(z12.object({ lineId: z12.string(), words: z12.string(), atMs: z12.number().optional() })),
+    /** On a `said` row: the work these words were filed on, and whether they answered (recorded) a
+     *  question. They replace the "Filed on ..." and "Recorded: ..." rows that repeated the person's own
+     *  summary (Brain, 2026-10-14). Optional: absent from an API before it. */
+    filedOn: z12.array(z12.object({ goalId: z12.string().uuid(), title: z12.string() })).optional(),
+    recorded: z12.boolean().optional(),
+    settled: z12.object({ requestId: z12.string(), answer: z12.string() }).nullable().optional(),
+    acknowledged: z12.boolean().optional(),
+    /** On a `put` row: still waiting for the person's answer (not settled, not answered, not put off).
+     *  The server's judgement; the screen draws "Still waiting for your answer" from it. Optional: absent
+     *  from an API before it, where the screen falls back to its own reading. */
+    waiting: z12.boolean().optional(),
+    lineIds: z12.array(z12.string())
+  })).optional()
 });
 function sessionSlot(sessionId2) {
   const id2 = sessionId2 ?? sessionId();
@@ -3586,6 +3700,14 @@ async function requestCode(suggestedName = agentName(), device) {
   if (!res.ok) throw new Error(`/api/device/code failed: ${res.status} ${await res.text()}`);
   return await res.json();
 }
+var ServerFault = class extends Error {
+  constructor(status) {
+    super(`Paigy's server failed (HTTP ${status}) while checking the code.`);
+    this.status = status;
+    this.name = "ServerFault";
+  }
+  status;
+};
 async function pollToken(deviceCode) {
   const res = await reach(`${BACKEND_URL}/api/device/token`, {
     method: "POST",
@@ -3593,6 +3715,7 @@ async function pollToken(deviceCode) {
     body: JSON.stringify({ device_code: deviceCode })
   });
   if (res.ok) return await res.json();
+  if (res.status >= 500) throw new ServerFault(res.status);
   const body = await res.json().catch(() => ({ error: "unknown" }));
   const err = body.error ?? "unknown";
   if (err === "authorization_pending") return null;
@@ -3954,6 +4077,9 @@ async function receiveContact(input, opts = {}) {
     throw error;
   }
 }
+function viaLine(via) {
+  return via ? `a card they shared by link${via.decidedBy ? `, decided by ${via.decidedBy}` : ""}` : void 0;
+}
 function compact(o) {
   return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0 && v !== null && v !== "" && !(Array.isArray(v) && v.length === 0)));
 }
@@ -3977,7 +4103,8 @@ function decided(result) {
       return void 0;
   }
 }
-function stateOf(state, answer, decided2) {
+function stateOf(state, answer, decided2, withdrawn) {
+  if (withdrawn && state === "answered") return "closed";
   return state === "answered" && answer && decided2 === void 0 ? "replied" : state;
 }
 var handle = (entryId) => entryId.slice(0, 8);
@@ -4006,10 +4133,11 @@ function conversation(e) {
       at: at(entry.createdAt),
       said: sealed ? "[encrypted]" : entryWords(entry).trim(),
       caveat: entry.callOngoing ? "Call ongoing; what the person decides may change." : void 0,
+      via: viaLine(entry.via),
       units: askUnits(entry, e.entries ?? []).map((u) => `${u.title}: ${u.body}`),
       re: re ? handle(re) : void 0,
       options,
-      decision: need ? compact({ state: stateOf(need.state, answer, decision), answer: decision }) : void 0
+      decision: need ? compact({ state: stateOf(need.state, answer, decision, need.withdrawn), answer: decision, via: viaLine(answer?.via) }) : void 0
     });
   });
 }
@@ -4177,7 +4305,7 @@ function receivedView(r, now = Date.now()) {
       ...rings.map((r2) => rerings(r2, now)),
       ...assigned.length ? [`${assigned.length} of your Goals are assigned to you and not started (assigned): read one with get_goals({goalIds:[goalId]}); your first write to it starts it.`] : [],
       ...w.claimable && !assigned.length ? [`Next waiting on you: ${w.claimable.title ?? w.claimable.goalId} (get_goals({ goalIds: ["${w.claimable.goalId}"] })).`] : [],
-      ...stalled.length ? [`${stalled.length} of your Goals have had no progress${stalled.length === 1 ? " " : ""}${quietFor(stalled, now)}: report on each with a contact update, or finish or cancel it with manage_goals.`] : [],
+      ...stalled.length ? [`${stalled.length} of your Goals have had no progress${stalled.length === 1 ? " " : ""}${quietFor(stalled, now)}: report on each with a contact update, or finish, cancel or defer it with manage_goals.`] : [],
       // The COUNT, oldest three, and where to read them (owner, 2026-10-08): it was 34 rows of
       // other agents' work on every window, ahead of this agent's own next step.
       ...others ? [`${others.count} of other agents' Goals have gone quiet${others.count === 1 ? " " : ""}${quietFor([{ since: others.oldestSince }], now, others.count)}: The oldest three are in others.goals: get_goals({goalIds:[goalId]}) reads one in full. A write to it puts you on it without changing its owner.`] : [],
@@ -4522,6 +4650,7 @@ export {
   deleteToken,
   revokeToken,
   requestCode,
+  ServerFault,
   pollToken,
   UnpairedError,
   RevokedError,