@paigy/harness 0.3.35 → 0.3.36

package/dist/main.js

@@ -901,14 +901,14 @@ var require_regex = __commonJS({
     var TEST_KANJI = new RegExp("^" + kanji + "$");
     var TEST_NUMERIC = new RegExp("^" + numeric + "$");
     var TEST_ALPHANUMERIC = new RegExp("^[A-Z0-9 $%*+\\-./:]+$");
-    exports.testKanji = function testKanji(str3) {
-      return TEST_KANJI.test(str3);
+    exports.testKanji = function testKanji(str5) {
+      return TEST_KANJI.test(str5);
     };
-    exports.testNumeric = function testNumeric(str3) {
-      return TEST_NUMERIC.test(str3);
+    exports.testNumeric = function testNumeric(str5) {
+      return TEST_NUMERIC.test(str5);
     };
-    exports.testAlphanumeric = function testAlphanumeric(str3) {
-      return TEST_ALPHANUMERIC.test(str3);
+    exports.testAlphanumeric = function testAlphanumeric(str5) {
+      return TEST_ALPHANUMERIC.test(str5);
     };
   }
 });
@@ -1410,13 +1410,13 @@ var require_segments = __commonJS({
     var Regex = require_regex();
     var Utils = require_utils();
     var dijkstra = require_dijkstra();
-    function getStringByteLength(str3) {
-      return unescape(encodeURIComponent(str3)).length;
+    function getStringByteLength(str5) {
+      return unescape(encodeURIComponent(str5)).length;
     }
-    function getSegments(regex, mode, str3) {
+    function getSegments(regex, mode, str5) {
       const segments = [];
       let result;
-      while ((result = regex.exec(str3)) !== null) {
+      while ((result = regex.exec(str5)) !== null) {
         segments.push({
           data: result[0],
           index: result.index,
@@ -4250,13 +4250,13 @@ var require_svg_tag = __commonJS({
     var Utils = require_utils2();
     function getColorAttrib(color, attrib) {
       const alpha = color.a / 255;
-      const str3 = attrib + '="' + color.hex + '"';
-      return alpha < 1 ? str3 + " " + attrib + '-opacity="' + alpha.toFixed(2).slice(1) + '"' : str3;
+      const str5 = attrib + '="' + color.hex + '"';
+      return alpha < 1 ? str5 + " " + attrib + '-opacity="' + alpha.toFixed(2).slice(1) + '"' : str5;
     }
     function svgCmd(cmd, x, y) {
-      let str3 = cmd + x;
-      if (typeof y !== "undefined") str3 += " " + y;
-      return str3;
+      let str5 = cmd + x;
+      if (typeof y !== "undefined") str5 += " " + y;
+      return str5;
     }
     function qrToPath(data, size, margin) {
       let path = "";
@@ -4589,7 +4589,7 @@ import { createHash, randomUUID } from "crypto";
 import { readFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-import { randomUUID as randomUUID3 } from "crypto";
+import { randomUUID as randomUUID2 } from "crypto";
 import { setTimeout as sleep2 } from "timers/promises";
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/external.js
@@ -8634,11 +8634,9 @@ var coerce = {
 var NEVER = INVALID;
 
 // ../../packages/sdk/dist/index.js
-import { randomUUID as randomUUID2 } from "crypto";
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync as readFileSync2, rmSync, statSync, writeFileSync } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-import { execFileSync as execFileSync2 } from "child_process";
 var import_undici = __toESM(require_undici(), 1);
 var require2 = __sdkCreateRequire(import.meta.url);
 var CODEX_ENV = ["CODEX_THREAD_ID", "CODEX_SESSION_ID", "CODEX_HOME", "PAIGY_TOKEN", "PAIGY_SESSION_ID", "PAIGY_HARNESS", "PAIGY_INSTANCE_ID", "PAIGY_ON_WAKE"];
@@ -9932,14 +9930,20 @@ var OptionSchema = external_exports.object({
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
-    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use `image` instead."
+    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use the image URL instead."
   ).optional(),
   image: external_exports.string().url().describe(
-    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use `html` instead."
+    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use the HTML preview instead."
   ).optional()
 });
-var OptionInputSchema = OptionSchema.omit({ id: true }).extend({
-  label: external_exports.string().trim().min(1).max(1e3)
+var OptionInputSchema = external_exports.object({
+  id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
+    `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
+  ),
+  label: external_exports.string().trim().min(1).max(1e3),
+  hint: OptionSchema.shape.hint,
+  htmlPreview: OptionSchema.shape.html,
+  imgUrl: OptionSchema.shape.image
 }).strict();
 var NIGHT = { from: 23, to: 7 };
 function draft2020(node) {
@@ -9971,41 +9975,162 @@ function mcpInputSchema(s) {
   delete schema.$schema;
   return draft2020(schema);
 }
-var AskInputSchema = external_exports.object({
-  id: external_exports.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: external_exports.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: external_exports.string().optional().describe("Optional repository context."),
-  ask: external_exports.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 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."
+var ASK_MAX = 250;
+var UNITS_MAX = 12;
+var UNIT_TITLE_MAX = 50;
+var UNIT_BODY_MAX = 200;
+var UnitInputSchema = external_exports.object({
+  title: external_exports.string().trim().min(1).describe(`What this unit is about, at most ${UNIT_TITLE_MAX} characters. The app lists the titles; the person taps one to read its body.`),
+  body: external_exports.string().trim().min(1).describe(`The unit itself, at most ${UNIT_BODY_MAX} characters.`)
+}).strict();
+function capRefusals(text, units22, field) {
+  const out = [];
+  const name = field === "text" ? "answer" : field;
+  if (text.length > ASK_MAX) out.push({
+    refusal: "ask_too_long",
+    length: text.length,
+    cap: ASK_MAX,
+    path: field === "text" ? ["answer", "text"] : [field],
+    message: `ask_too_long: the ${name} is ${text.length} characters; the cap is ${ASK_MAX}. Keep the one point in the ${name} and move the context into units.`
+  });
+  const all = units22 ?? [];
+  if (all.length > UNITS_MAX) out.push({
+    refusal: "too_many_units",
+    length: all.length,
+    cap: UNITS_MAX,
+    path: ["units"],
+    message: `too_many_units: ${all.length} units; the cap is ${UNITS_MAX}. Keep only the context this ${name} needs.`
+  });
+  all.forEach((unit, index) => {
+    if (unit.title.length > UNIT_TITLE_MAX) out.push({
+      refusal: "unit_title_too_long",
+      index,
+      length: unit.title.length,
+      cap: UNIT_TITLE_MAX,
+      path: ["units", index, "title"],
+      message: `unit_title_too_long: units[${index}]'s title is ${unit.title.length} characters; the cap is ${UNIT_TITLE_MAX}.`
+    });
+    if (unit.body.length > UNIT_BODY_MAX) out.push({
+      refusal: "unit_body_too_long",
+      index,
+      length: unit.body.length,
+      cap: UNIT_BODY_MAX,
+      path: ["units", index, "body"],
+      message: `unit_body_too_long: units[${index}]'s body is ${unit.body.length} characters; the cap is ${UNIT_BODY_MAX}. Cut it into two units.`
+    });
+  });
+  return out;
+}
+function refuseOverCaps(text, units22, field, ctx) {
+  for (const { path, message, ...params } of capRefusals(text, units22, field)) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path, message, params });
+}
+var questionHandle = external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/, "a question id, whole or its first eight characters");
+var NodeRef = external_exports.object({
+  type: external_exports.enum(["goal", "question"]),
+  id: external_exports.string().uuid()
+}).strict().describe("A Goal or a Question, by its id.");
+var BlockedAction = external_exports.enum(["start", "complete", "answer"]).describe("What waits: starting or completing a Goal, or answering a Question.");
+var reason = external_exports.string().trim().min(1).max(500).describe("Why, as an explanation, never as policy.");
+var actionFits = (b) => b.blocked.type === "goal" === (b.action !== "answer");
+var ACTION_FITS = "a goal is blocked from start or complete; a question from answer";
+var userExplicitlyRequested = external_exports.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 = external_exports.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.`
+);
+var UpdateInputSchema = external_exports.object({
+  message: external_exports.string().trim().min(1).describe(`The one point, at most ${ASK_MAX} characters; the context goes in units.`),
+  goalIds: external_exports.array(external_exports.string().uuid()).min(1).max(10).describe("The Goals it is about, each one that exists: the one it is mainly about first."),
+  units,
+  userExplicitlyRequested
+}).strict().superRefine((u, ctx) => refuseOverCaps(u.message, u.units, "message", ctx));
+var questionFields = {
+  question: external_exports.string().trim().min(1).describe(
+    `ONE question, in at most ${ASK_MAX} characters, and only what is needed to answer it; the context goes in units. Several questions are several objects, one each: an answer settles the one question it was given, so a person who answers the part of a bundled question that interested them settles nothing and is asked again. Separate questions cost nothing: ANY contact for a person already on a call JOINS that call, so several arrive as one call.`
   ),
-  options: external_exports.array(OptionInputSchema).min(1).max(6).optional(),
+  goalId: external_exports.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: external_exports.array(OptionInputSchema).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
   // 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: external_exports.enum(["one", "many"]).optional().describe(
-    '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.'
+  // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
+  pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
+    'How the options are answered: "one" (the default) a pick, for alternatives; "many" a checklist, for independent options they may want several of; "rank" an order of all of them. Only with options.'
   ),
-  answers: external_exports.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. 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 = external_exports.object({
-  asks: external_exports.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: external_exports.enum(["none", "hard"]).default("none").describe("hard requests a call even when channel is notification; user permissions and ring cooldowns still apply."),
-  channel: external_exports.enum(["notification", "call"]).default("notification")
-}).strict();
-var ReceiveContactSchema = external_exports.object({
-  wait: external_exports.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)."
+  // WHAT THE QUESTION HOLDS UP (brain_prompts.md §2.1): replaces `waiting: 'hard'`. A question that
+  // blocks work asks for a call (the person's settings and ring cooldowns still decide).
+  workItBlocks: external_exports.array(external_exports.object({ blocked: NodeRef, action: BlockedAction, reason: reason.optional() }).strict().refine(actionFits, ACTION_FITS)).min(1).max(10).optional().describe(
+    "The work that cannot go on until this is answered: a Goal's start or completion, or another Question's answer. Only for work truly blocked; it asks for a call. Leave it out for a question you can keep working around."
+  ),
+  userExplicitlyRequested
+};
+var refineQuestion = (q, ctx) => {
+  refuseOverCaps(q.question, q.units, "question", ctx);
+  if (q.pickMode && !q.options) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["pickMode"], message: "pickMode comes only with options" });
+  const ids = (q.options ?? []).map((o) => o.id);
+  if (ids.some((id22) => id22) && (ids.some((id22) => !id22) || new Set(ids).size !== ids.length)) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["options"], message: "give every option a distinct id, or none" });
+  }
+};
+var QuestionInputSchema = external_exports.object({
+  questionId: external_exports.string().uuid().optional().describe("Optional: your own stable id for this question (a UUID), so a resend is the same question. Minted for you when omitted; the result returns it."),
+  ...questionFields
+}).strict().superRefine(refineQuestion);
+var QuestionWireSchema = external_exports.object({ questionId: external_exports.string().uuid(), ...questionFields }).strict().superRefine(refineQuestion);
+var AnswerInputSchema = external_exports.object({
+  questionId: questionHandle.describe("The Question you answer: its id as the event or the conversation shows it (8 characters or whole)."),
+  answer: external_exports.object({
+    text: external_exports.string().trim().min(1).describe(`Your answer in your own words, at most ${ASK_MAX} characters; the context goes in units.`),
+    selectedOptionIds: external_exports.array(external_exports.string().trim().min(1)).min(1).max(6).optional().describe("The ids of the options you choose, when the Question offered options (in order, for a ranking).")
+  }).strict(),
+  units
+}).strict().superRefine((a, ctx) => refuseOverCaps(a.answer.text, a.units, "text", ctx));
+var QuestionDependencySchema = external_exports.object({
+  questionId: questionHandle.describe("A Question you asked."),
+  change: external_exports.enum(["add", "remove"]),
+  blocked: NodeRef,
+  action: BlockedAction,
+  reason: reason.optional()
+}).strict().refine(actionFits, ACTION_FITS);
+var sendFields = {
+  updates: external_exports.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."
+  ),
+  answers: external_exports.array(AnswerInputSchema).min(1).max(20).optional().describe("Answers to Questions addressed to you."),
+  withdrawQuestionIds: external_exports.array(questionHandle).min(1).max(10).optional().describe(
+    "Questions you asked that no longer need an answer: you acted on them yourself, they no longer matter, or you asked wrongly. Each is cancelled, not answered: its card closes and nothing rings for it."
   ),
+  questionDependencies: external_exports.array(QuestionDependencySchema).min(1).max(20).optional().describe(
+    "Add or remove what a Question you asked holds up, after asking it."
+  )
+};
+var ContactSchema = external_exports.object({
+  ...sendFields,
+  questions: external_exports.array(QuestionInputSchema).min(1).max(20).optional().describe("Questions for the person, one per object."),
+  /** RECEIVING (2I, I2; brain_prompts.md §2.2): the events this agent handled. */
   ackEventIds: external_exports.array(external_exports.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."
+    "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."
+  ),
+  wait: external_exports.boolean().optional().describe(
+    "Only controls when this returns. Sending: false (the default) returns at once; true waits up to about 45 seconds for a response to what you sent. Sending nothing: true (the default) waits up to about 45 seconds for anything addressed to you; false returns 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; wait again without sending again), or `not_waited`."
   )
 }).strict();
-var ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict(), ReceiveContactSchema]);
+var sendsAnything = (c) => !!(c.updates?.length || c.questions?.length || c.answers?.length || c.withdrawQuestionIds?.length || c.questionDependencies?.length);
+var ContactWireSchema = external_exports.object({
+  operationId: external_exports.string().uuid(),
+  ...sendFields,
+  questions: external_exports.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 = "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 CONTACT_DESCRIPTION = `Send to and receive from the person: 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.
+
+QUESTIONS: one question per object; several questions are several objects in one contact, so each can be answered on its own. Each is sent exactly as written, with no reading in between: a bundled question arrives as one card. Give options when you have them. 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'). pickMode:'one' (the default) makes a pick, for alternatives; 'many' a checklist, for independent options they may want several of; 'rank' an ordering. The person can always answer in their own words, so never add an 'Other' option. workItBlocks names the work a question holds up, only when you are truly blocked: it asks for a call. Answers land on the question's Goal: collect them by receiving (below) or with get_goal.
+
+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.
+
+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. So when the work is finished, mark the Goal done first (manage_goals), then send one update saying what is done and anything they need to do or check. 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.
+
+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_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\`; your first write to it starts it) and your work gone quiet (\`stalled\`).`;
 var CreateGoalSchema = external_exports.object({
   outcome: external_exports.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
@@ -10039,21 +10164,11 @@ var UpdateGoalSchema = external_exports.object({
     state: external_exports.enum(["active", "done", "cancelled"]).optional(),
     progress: external_exports.string().trim().min(1).max(1e4).optional(),
     reviewed: external_exports.literal(true).optional(),
-    dueAt: external_exports.string().datetime({ offset: true }).nullable().optional(),
-    /** WITHDRAW YOUR OWN QUESTION (#2777, owner 2026-09-30). The question's id as every read shows it
-     *  (the conversation's `id`, eight characters, or the whole request Entry id), on THIS Goal, asked
-     *  by you and still open. It is cancelled, not answered: its cards close and nothing rings for it. */
-    withdraw: external_exports.array(external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/)).min(1).max(10).optional()
+    dueAt: external_exports.string().datetime({ offset: true }).nullable().optional()
   }).strict().refine((v) => Object.keys(v).length > 0),
   reason: external_exports.string().trim().min(1).max(2e3),
   operationId: external_exports.string().uuid().optional()
 }).strict();
-var UpdateGoalToolSchema = external_exports.object({
-  goalId: external_exports.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 = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle = external_exports.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 = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
@@ -10061,7 +10176,7 @@ var CreateChange = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle,
   outcome: goalOutcome,
-  ownerId: external_exports.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."),
+  ownerId: external_exports.string().trim().min(1).optional().describe("Who owns the work: an agent's participant (as check_activity shows it) or the person's. Omitted: you."),
   parentGoalId: external_exports.string().uuid().optional().describe("The Goal it belongs under. Omitted: a root."),
   sourceEntryIds: external_exports.array(external_exports.string().uuid()).max(20).optional().describe("The whole Entries the work came from, ones you can read.")
 }).strict();
@@ -10071,7 +10186,7 @@ var StateChange = external_exports.object({ kind: external_exports.literal("stat
 ) }).strict();
 var AssignChange = external_exports.object({ kind: external_exports.literal("assign"), goalId: changedGoal, ownerId: external_exports.string().trim().min(1).describe("The new owner's participant.") }).strict();
 var DeferChange = external_exports.object({ kind: external_exports.literal("defer"), goalId: changedGoal, until: external_exports.string().datetime({ offset: true }).nullable().describe(
-  "Postpone it until this instant (its owner is woken then), or null to take the postponement back."
+  "Postpone it until this instant: it waits until then, and its owner is woken when it passes (a promise to follow up later). null takes the postponement back."
 ) }).strict();
 var MoveChange = external_exports.object({ kind: external_exports.literal("move"), goalId: changedGoal, parentGoalId: external_exports.string().uuid().nullable().describe(
   "Its new parent, or null for a root. Only this Goal moves; its new parent's other children stay."
@@ -10106,8 +10221,7 @@ var ManageGoalsSchema = external_exports.object({
 var ManageGoalsToolSchema = external_exports.object({
   changes: external_exports.array(external_exports.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 = external_exports.object({ goalId: external_exports.string().uuid().optional() }).strict();
+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_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: the Goal waits until then and its owner is woken when it passes; null takes it back); 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 any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -10118,9 +10232,7 @@ var GetGoalSchema = external_exports.object({
    *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
   diagnose: external_exports.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 = "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 GET_GOAL_DESCRIPTION = "Read one Goal (a read never puts you on 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 SearchToolSchema = external_exports.object({
   query: external_exports.string().trim().min(1).max(500),
   types: external_exports.array(external_exports.enum(["entry", "goal", "answer"])).min(1).optional(),
@@ -10128,15 +10240,21 @@ var SearchToolSchema = external_exports.object({
   limit: external_exports.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 = external_exports.object({}).strict();
+var CheckActivitySchema = external_exports.object({}).strict();
+var FEEDBACK_TEXT_MAX = 5e4;
+var SendFeedbackSchema = external_exports.object({
+  text: external_exports.string().trim().min(1).max(FEEDBACK_TEXT_MAX).describe(`The report, in markdown: what happened, what was expected, how to reproduce it, versions, evidence. At most ${FEEDBACK_TEXT_MAX} characters.`),
+  title: external_exports.string().trim().min(1).max(200).optional().describe("One line naming it."),
+  kind: external_exports.enum(["bug", "idea", "other"]).default("other").describe("bug: something Paigy does wrong. idea: something it should do. other: anything else.")
+}).strict();
+var SEND_FEEDBACK_DESCRIPTION = "Send feedback about Paigy itself (a bug report, an idea) straight to the Paigy team. Send it only when the person asked you to, or agreed when you offered: it goes to Paigy, never to the person, and nobody answers it here. Not for your work or a question for the person: use contact for those. Returns whether it was stored.";
 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(WhoIsWorkingSchema) },
   { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
   { 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: "search", description: SEARCH_DESCRIPTION, inputSchema: mcpInputSchema(SearchToolSchema) }
+  { name: "search", description: SEARCH_DESCRIPTION, inputSchema: mcpInputSchema(SearchToolSchema) },
+  { name: "check_activity", 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(CheckActivitySchema) },
+  { name: "send_feedback", description: SEND_FEEDBACK_DESCRIPTION, inputSchema: mcpInputSchema(SendFeedbackSchema) }
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
 var id = external_exports.string().uuid();
@@ -10275,13 +10393,83 @@ var CompactResultSchema = external_exports.object({
 var COMPACT_RESULT_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema(CompactResultSchema, { $refStrategy: "none" })
 );
+var str2 = external_exports.string();
+var strs2 = external_exports.array(external_exports.string());
+var TalkerReplySchema = external_exports.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: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, blocks: str2 }).strict()),
+  /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
+  then: external_exports.enum(["listen", "hold", "end"]),
+  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
+  answers: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2 }).strict()),
+  /** The line handles that hold a new instruction from the person. */
+  instruction: strs2,
+  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
+   *  reads only these (3e). */
+  file: strs2,
+  /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
+  need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
+  /** The handle of the item to explain ("" for none). */
+  explain: str2
+}).strict();
+var TALKER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(TalkerReplySchema, { $refStrategy: "none" })
+);
+var str3 = external_exports.string();
+var strs3 = external_exports.array(external_exports.string());
+var FilerReplySchema = external_exports.object({
+  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
+  filed: external_exports.array(external_exports.object({ line: str3, goals: strs3 }).strict()),
+  goals: external_exports.array(external_exports.object({
+    op: external_exports.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,
+    gate: external_exports.enum(["start", "complete", "answer", ""]),
+    why: str3
+  }).strict()),
+  questions: external_exports.array(external_exports.object({
+    op: external_exports.enum(["create", "edit", "assign", "withdraw"]),
+    key: str3,
+    question: str3,
+    text: str3,
+    to: str3,
+    goal: str3,
+    options: external_exports.array(external_exports.object({ id: str3, label: str3 }).strict()),
+    pick: external_exports.enum(["one", "many", "rank", "words", ""]),
+    blocks: str3
+  }).strict()),
+  lessons: external_exports.array(external_exports.object({ op: external_exports.enum(["remember", "revise", "withdraw"]), lesson: str3, text: str3, scope: str3 }).strict()),
+  /** Line handles whose words comment on Paigy itself. */
+  feedback: strs3
+}).strict();
+var FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema(FilerReplySchema, { $refStrategy: "none" })
+);
+function entryUnit(entry) {
+  if (entry.kind !== "contribution" || !entry.aboutId) return null;
+  const plain = entry.content && "plain" in entry.content ? entry.content.plain : null;
+  if (!plain || typeof plain !== "object") return null;
+  const { title, text } = plain;
+  return typeof title === "string" && typeof text === "string" ? { title, body: text } : null;
+}
 var LIVE_MS = 3 * 6e4;
 var WORKING_MS = 60 * 6e4;
 var ContextSchema = external_exports.object({
   title: external_exports.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: external_exports.array(external_exports.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."
-  )
+  ),
+  /** THE ASK'S UNITS (3c): its context as titled units, in order. The app lists the titles and opens
+   *  a body on a tap. Absent on an ask sent without units, which renders as before. */
+  units: external_exports.array(external_exports.object({ title: external_exports.string(), body: external_exports.string() })).optional()
 });
 var ParticipantSchema = external_exports.object({
   kind: external_exports.enum(["human", "agent"]),
@@ -10356,7 +10544,7 @@ var NotifyRequestFields = external_exports.object({
    *  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: external_exports.array(OptionInputSchema).min(OPTIONS_MIN).max(OPTIONS_MAX).optional().describe(
+  options: external_exports.array(OptionSchema.omit({ id: true }).extend({ label: external_exports.string().trim().min(1).max(1e3) }).strict()).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: external_exports.array(external_exports.string().min(1)).optional().describe(
@@ -11117,8 +11305,8 @@ var QueueItemSchema = external_exports.object({
   repo: external_exports.string().nullable().optional(),
   createdAt: external_exports.string(),
   updatedAt: external_exports.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
+  /** When its owner last SAID something about it (the newest `progress` Entry: a contact update kept
+   *  as 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: external_exports.string().nullable().optional(),
   /** THE GOAL'S NEWEST WORD, FROM EITHER SIDE (owner, 2026-09-27): the newest Entry on it, of any
@@ -11276,7 +11464,7 @@ var HostDecisionSchema = external_exports.object({
   /** The agent's token id: the row's `recipient`. */
   agent: external_exports.string().uuid(),
   decision: external_exports.enum(["stood_back", "took_over"]),
-  /** The work it was about: the Goal `claim_goal` would hand that agent next. */
+  /** The work it was about: the Goal waiting on that agent next (`claimable` on its `contact({})` read). */
   goalId: external_exports.string().uuid().nullable().optional(),
   /** When the server last heard from the agent, as the host read it: the presence it stood back for. */
   seenAt: external_exports.string().datetime().nullable().optional(),
@@ -11633,12 +11821,6 @@ async function manageGoals(input, opts = {}) {
   if (!res.ok) await fail("manage_goals", res);
   return await res.json();
 }
-async function claimGoal(goalId, opts = {}) {
-  const token = authToken(opts.token) ?? "";
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/claim`, { method: "POST", headers: { "content-type": "application/json", authorization: `Bearer ${token}` }, body: JSON.stringify(goalId ? { goalId } : {}) }));
-  if (!res.ok) await fail("claim_goal", res);
-  return await res.json();
-}
 async function getGoal(goalId, opts = {}, read3 = {}) {
   const token = authToken(opts.token) ?? "";
   const query = [read3.history ? "history=1" : "", read3.diagnose ? "diagnose=1" : ""].filter(Boolean).join("&");
@@ -11649,13 +11831,6 @@ async function getGoal(goalId, opts = {}, read3 = {}) {
   if (!res.ok) await fail("get_goal", res);
   return await res.json();
 }
-async function updateGoal(goalId, input, opts = {}) {
-  const token = authToken(opts.token) ?? "";
-  const operationId = input.operationId ?? randomUUID2();
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/${encodeURIComponent(goalId)}`, { method: "PATCH", headers: { "content-type": "application/json", authorization: `Bearer ${token}` }, body: JSON.stringify({ ...input, operationId }) }));
-  if (!res.ok) await fail("update_goal", res);
-  return await res.json();
-}
 var AWAIT_WINDOW_MS = 45e3;
 async function whoAmI(opts = {}) {
   try {
@@ -11769,99 +11944,67 @@ async function dismissTriage(proposalId, opts = {}) {
   if (!res.ok) throw new Error(`dismiss_triage failed: ${res.status} ${await res.text()}`);
   return await res.json();
 }
-function repoFromRemote(url) {
-  const said = (url ?? "").trim();
-  if (!said) return null;
-  const path = said.replace(/^[a-z+]+:\/\/[^/]+\//i, "").replace(/^[^@]+@[^:]+:/, "").replace(/\.git$/i, "").replace(/\/+$/, "");
-  const parts = path.split("/").filter(Boolean);
-  if (parts.length < 2) return null;
-  const [owner, name] = parts.slice(-2);
-  if (!owner || !name) return null;
-  return `${owner}/${name}`.toLowerCase();
-}
-var asked;
-function currentRepo(cwd = process.cwd()) {
-  if (asked !== void 0) return asked;
-  try {
-    const url = execFileSync2("git", ["remote", "get-url", "origin"], {
-      cwd,
-      encoding: "utf8",
-      timeout: 2e3,
-      stdio: ["ignore", "pipe", "ignore"]
-    });
-    asked = repoFromRemote(url);
-  } catch {
-    asked = null;
-  }
-  return asked;
+var NOT_SENT = `Recorded as the Goal's progress, not sent: nobody was notified. The person is told only a question, an answer to one they asked you, and what you say once the Goal is done. To close the work, mark the Goal done first, then send the one update saying what is done and anything they need to do or check. If the person asked you, in so many words, to send them this, send it again with userExplicitlyRequested: "any" on that update.`;
+var APPLIED = "Applied; nothing was sent to the person.";
+var DEMOTED = "Delivered as a card, not a call: the person's settings do not allow a call right now (silent, quiet hours, or a mode). It has reached them; do not send it again.";
+async function readDelivery(deliveryId, opts = {}) {
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, {
+    headers: { authorization: `Bearer ${authToken(opts.token) ?? ""}` },
+    signal: opts.signal
+  }));
+  if (!res.ok) await fail("read_delivery", res);
+  return await res.json();
 }
-var NOT_SENT = "Recorded as the Goal's progress, not sent: nobody was notified. The person is told only a question, an answer to one they asked you, and what you say once the Goal is done. To close the work, mark the Goal done first, then send the one message saying what is done and anything they need to do or check.";
-var DEMOTED = "Delivered as a card, not a call: the person's settings do not allow a call right now (silent, quiet hours, or a mode). It has reached them; do not send it again, with or without a Goal.";
 async function contact(input, opts = {}) {
   const parsed = ContactSchema.parse(input);
-  if (!("asks" in parsed) && !("deliveryId" in parsed)) throw new Error("contact with nothing to send receives: call receiveContact");
+  if (!sendsAnything(parsed)) throw new Error("contact with nothing to send receives: call receiveContact");
   opts.signal?.throwIfAborted();
   const send22 = opts.reach ?? reach;
-  const headers = { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}` };
-  let deliveryId;
-  let deliveries = [];
-  let recorded = [];
-  let demoted;
-  if ("deliveryId" in parsed) {
-    deliveryId = parsed.deliveryId;
-  } else {
-    const reqAsks = parsed.asks.map((a) => ({
-      id: a.id,
-      parentId: a.parentId,
-      // Derived, not asked for (#2315): the agent's own remote, in one spelling, so a project's
-      // work does not grow three trees for "paigy", "mauurda/paigy" and "Paigy". An explicit one
-      // still wins — normalised the same way — because a caller that names one knows something
-      // this cannot see.
-      repo: repoFromRemote(a.repo) ?? a.repo ?? currentRepo() ?? void 0,
-      ask: a.ask,
-      options: a.options ?? [],
-      ...a.select ? { select: a.select } : {},
-      ...a.answers ? { answers: a.answers } : {}
-    }));
-    const res = await ensureAuthed(await send22(`${BACKEND_URL}/api/goals/contact`, {
-      method: "POST",
-      headers,
-      signal: opts.signal,
-      body: JSON.stringify({
-        operationId: opts.operationId ?? randomUUID3(),
-        asks: reqAsks,
-        waiting: parsed.waiting,
-        channel: parsed.channel === "call" ? "call" : "message"
-      })
-    }));
-    if (!res.ok) await fail("batch contact", res);
-    const receipt = await res.json();
-    deliveries = receipt.deliveries ?? [];
-    if (parsed.channel === "call" && receipt.channel && receipt.channel !== "call") demoted = DEMOTED;
-    recorded = receipt.recorded ?? [];
-    if (deliveries.length === 0 && recorded.length) return { sent: false, recorded, message: NOT_SENT };
-    if (deliveries.length === 0) throw new Error("Goal contact returned no Delivery identities");
-    deliveryId = deliveries[0]?.deliveryId ?? "";
-    if (!deliveryId) throw new Error("Goal contact returned no valid Delivery identity");
-  }
-  const all = deliveries.filter((d) => !!d.deliveryId && !!d.goalId).map(({ id: id22, deliveryId: deliveryId2, goalId }) => ({ ...id22 ? { id: id22 } : {}, deliveryId: deliveryId2, goalId }));
-  const joinedCard = deliveries[0]?.joinedCard === true;
-  const joinedCall = deliveries[0]?.joinedCall === true;
+  const acknowledged = parsed.ackEventIds?.length ? await acknowledge(parsed.ackEventIds, opts) : void 0;
+  const questions = parsed.questions?.map((q) => ({ ...q, questionId: q.questionId ?? randomUUID2() }));
+  const res = await ensureAuthed(await send22(`${BACKEND_URL}/api/goals/contact`, {
+    method: "POST",
+    signal: opts.signal,
+    headers: { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}` },
+    body: JSON.stringify({
+      operationId: opts.operationId ?? randomUUID2(),
+      ...parsed.updates ? { updates: parsed.updates } : {},
+      ...questions ? { questions } : {},
+      ...parsed.answers ? { answers: parsed.answers } : {},
+      ...parsed.withdrawQuestionIds ? { withdrawQuestionIds: parsed.withdrawQuestionIds } : {},
+      ...parsed.questionDependencies ? { questionDependencies: parsed.questionDependencies } : {}
+    })
+  }));
+  if (!res.ok) await fail("contact", res);
+  const receipt = await res.json();
+  const results = receipt.results ?? [];
+  const ok = receipt.ok ?? results.every((r) => r.status !== "failed");
+  const deliveries = receipt.deliveries ?? [];
+  const recorded = results.filter((r) => r.status === "recorded" && r.goalId).map((r) => ({ goalId: r.goalId }));
+  const askedCall = [...parsed.updates ?? [], ...questions ?? []].some((m) => m.userExplicitlyRequested === "call") || !!questions?.some((q) => q.workItBlocks?.length);
+  const demoted = askedCall && receipt.channel && receipt.channel !== "call" ? DEMOTED : void 0;
+  const acked = acknowledged ? { acknowledged } : {};
+  if (!deliveries.length) {
+    return { sent: false, ok, results, ...recorded.length ? { recorded } : {}, message: recorded.length ? NOT_SENT : APPLIED, waitOutcome: "not_waited", ...acked };
+  }
+  const lead = deliveries.find((d) => d.kind === "question") ?? deliveries[0];
   const read3 = async (signal2) => {
-    const res = await ensureAuthed(await send22(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
-    if (!res.ok) await fail("read_delivery", res);
-    const one = await res.json();
+    const one = await readDelivery(lead.deliveryId, { ...opts, signal: signal2 });
     return {
       ...one,
-      ...all.length > 1 ? { deliveries: all } : {},
+      ok,
+      results,
+      ...deliveries.length > 1 ? { deliveries: deliveries.map(({ deliveryId, goalId, kind, questionId }) => ({ deliveryId, goalId, kind, ...questionId ? { questionId } : {} })) } : {},
       ...recorded.length ? { recorded, notSent: NOT_SENT } : {},
-      ...joinedCard ? { joinedCard: true } : {},
-      ...joinedCall ? { joinedCall: true } : {},
-      ...demoted ? { demoted } : {}
+      ...lead.joinedCard ? { joinedCard: true } : {},
+      // IT WENT ONTO A CALL ALREADY HAPPENING (owner, 2026-09-28): the view words it as that call.
+      ...lead.joinedCall ? { joinedCall: true } : {},
+      ...demoted ? { demoted } : {},
+      ...acked
     };
   };
-  const settled = (d) => d.kind === "notification" || d.state === "closed" || d.answers.length > 0 || d.entries.some((e) => e.kind === "contribution");
-  if (opts.waits === false) return read3(opts.signal);
+  const settled = (d) => d.state === "closed" || d.answers.length > 0 || d.entries.some((e) => e.kind === "contribution" && !entryUnit(e));
+  if (parsed.wait !== true || opts.waits === false) return { ...await read3(opts.signal), waitOutcome: "not_waited" };
   const window = AbortSignal.timeout(AWAIT_WINDOW_MS);
   const signal = opts.signal ? AbortSignal.any([opts.signal, window]) : window;
   let latest;
@@ -11869,12 +12012,12 @@ async function contact(input, opts = {}) {
     while (true) {
       signal.throwIfAborted();
       latest = await read3(signal);
-      if (settled(latest)) return latest;
+      if (settled(latest)) return { ...latest, waitOutcome: "available" };
       await sleep2(5e3, void 0, { signal });
     }
   } catch (error) {
     opts.signal?.throwIfAborted();
-    if (window.aborted && latest) return latest;
+    if (window.aborted && latest) return { ...latest, waitOutcome: "expired" };
     throw error;
   }
 }
@@ -11885,6 +12028,15 @@ async function receive(opts = {}) {
   if (!res.ok) await fail("receive", res);
   return await res.json();
 }
+async function acknowledge(eventIds, opts = {}) {
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/deliveries/ack`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}` },
+    body: JSON.stringify({ eventIds })
+  }));
+  if (!res.ok) await fail("acknowledge", res);
+  return (await res.json()).results ?? [];
+}
 var HEARTBEAT_MS = 25e3;
 var RETRY_MS = [1e3, 2e3, 5e3, 1e4, 3e4];
 var JOIN = { config: { broadcast: { self: false } } };
@@ -12365,9 +12517,9 @@ async function available(deps = {}) {
   });
   return [ollama, ...harnesses];
 }
-function refusal(options, asked2) {
+function refusal(options, asked) {
   const lines2 = [
-    asked2 ? `Can't judge with --via ${asked2}: ${options.find((o) => o.provider === asked2)?.hint ?? "it isn't available on this machine"}` : "No local judge available \u2014 triage refuses rather than sending your queue to a cloud model.",
+    asked ? `Can't judge with --via ${asked}: ${options.find((o) => o.provider === asked)?.hint ?? "it isn't available on this machine"}` : "No local judge available \u2014 triage refuses rather than sending your queue to a cloud model.",
     "",
     "Triage runs the model where your queue already lives (#1106). Your options:"
   ];
@@ -12391,10 +12543,10 @@ var RUNNERS = {
   agy: { cli: "agy", argv: () => ["-p"] }
 };
 var RUN_TIMEOUT_MS = 5 * 6e4;
-async function judgeFor(asked2, deps = {}) {
+async function judgeFor(asked, deps = {}) {
   const options = await available(deps);
-  const chosen = asked2 ? options.find((o) => o.provider === asked2) : options.find((o) => o.ready);
-  if (!chosen?.ready) return { error: refusal(options, asked2) };
+  const chosen = asked ? options.find((o) => o.provider === asked) : options.find((o) => o.ready);
+  if (!chosen?.ready) return { error: refusal(options, asked) };
   if (chosen.provider === "ollama") {
     const model = chosen.model;
     return {
@@ -12415,9 +12567,9 @@ async function judgeFor(asked2, deps = {}) {
     };
   }
   const runner = RUNNERS[chosen.provider];
-  if (!runner) return { error: refusal(options, asked2) };
+  if (!runner) return { error: refusal(options, asked) };
   const bin = which(runner.cli);
-  if (!bin) return { error: refusal(options, asked2) };
+  if (!bin) return { error: refusal(options, asked) };
   return {
     provider: chosen.provider,
     model: null,
@@ -12686,10 +12838,10 @@ function ago(iso, now) {
   return `${plural2(Math.floor(hours / 24), "day")} ago`;
 }
 function standing(queue, proposal, now) {
-  const head = queue.length === 0 ? "Nothing open \u2014 the queue is clear" : `Holding ${plural2(queue.length, "open note")}`;
-  if (!proposal) return `${head} \xB7 no sweep waiting`;
+  const head2 = queue.length === 0 ? "Nothing open \u2014 the queue is clear" : `Holding ${plural2(queue.length, "open note")}`;
+  if (!proposal) return `${head2} \xB7 no sweep waiting`;
   const n = suggested(proposal);
-  return n === 0 ? `${head} \xB7 swept ${ago(proposal.runAt, now)}, nothing to suggest` : `${head} \xB7 ${plural2(n, "suggestion")} waiting on you, swept ${ago(proposal.runAt, now)}`;
+  return n === 0 ? `${head2} \xB7 swept ${ago(proposal.runAt, now)}, nothing to suggest` : `${head2} \xB7 ${plural2(n, "suggestion")} waiting on you, swept ${ago(proposal.runAt, now)}`;
 }
 async function brokerView(deps) {
   const now = (deps.now ?? Date.now)();
@@ -12789,7 +12941,7 @@ function listRepos(deps) {
 }
 
 // src/holder.ts
-import { execFileSync as execFileSync3 } from "child_process";
+import { execFileSync as execFileSync2 } from "child_process";
 import { readFileSync as readFileSync4, readdirSync as readdirSync2 } from "fs";
 import { homedir as homedir6 } from "os";
 import { join as join6 } from "path";
@@ -12804,7 +12956,7 @@ function isAlive(pid) {
 function psStart(pid, zone) {
   try {
     const env = zone === "UTC" ? { ...process.env, TZ: "UTC", LC_ALL: "C" } : { ...process.env, LC_ALL: "C" };
-    return execFileSync3("ps", ["-o", "lstart=", "-p", String(pid)], { env, encoding: "utf8", timeout: 2e3 }).trim() || null;
+    return execFileSync2("ps", ["-o", "lstart=", "-p", String(pid)], { env, encoding: "utf8", timeout: 2e3 }).trim() || null;
   } catch {
     return null;
   }
@@ -12859,7 +13011,7 @@ function localHolderPids(deps = {}) {
 }
 function psParent(pid) {
   try {
-    const out = execFileSync3("ps", ["-o", "ppid=", "-p", String(pid)], { encoding: "utf8", timeout: 2e3 }).trim();
+    const out = execFileSync2("ps", ["-o", "ppid=", "-p", String(pid)], { encoding: "utf8", timeout: 2e3 }).trim();
     const n = Number(out);
     return Number.isInteger(n) && n > 0 ? n : null;
   } catch {
@@ -12983,7 +13135,7 @@ function ownerSession(slot, deps = {}) {
   const prefix = m[1];
   const root = deps.projectsDir ?? join7(homedir7(), ".claude", "projects");
   const list = deps.list ?? ((dir) => readdirSync3(dir));
-  const head = deps.head ?? readHead;
+  const head2 = deps.head ?? readHead;
   let folders;
   try {
     folders = list(root);
@@ -13001,7 +13153,7 @@ function ownerSession(slot, deps = {}) {
     if (!file) continue;
     let text;
     try {
-      text = head(join7(root, folder, file));
+      text = head2(join7(root, folder, file));
     } catch {
       continue;
     }
@@ -14312,14 +14464,20 @@ var OptionSchema2 = external_exports.object({
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
-    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use `image` instead."
+    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use the image URL instead."
   ).optional(),
   image: external_exports.string().url().describe(
-    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use `html` instead."
+    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use the HTML preview instead."
   ).optional()
 });
-var OptionInputSchema2 = OptionSchema2.omit({ id: true }).extend({
-  label: external_exports.string().trim().min(1).max(1e3)
+var OptionInputSchema2 = external_exports.object({
+  id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
+    `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
+  ),
+  label: external_exports.string().trim().min(1).max(1e3),
+  hint: OptionSchema2.shape.hint,
+  htmlPreview: OptionSchema2.shape.html,
+  imgUrl: OptionSchema2.shape.image
 }).strict();
 var NIGHT2 = { from: 23, to: 7 };
 function draft20202(node) {
@@ -14351,41 +14509,162 @@ function mcpInputSchema2(s) {
   delete schema.$schema;
   return draft20202(schema);
 }
-var AskInputSchema2 = external_exports.object({
-  id: external_exports.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: external_exports.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: external_exports.string().optional().describe("Optional repository context."),
-  ask: external_exports.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 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."
+var ASK_MAX2 = 250;
+var UNITS_MAX2 = 12;
+var UNIT_TITLE_MAX2 = 50;
+var UNIT_BODY_MAX2 = 200;
+var UnitInputSchema2 = external_exports.object({
+  title: external_exports.string().trim().min(1).describe(`What this unit is about, at most ${UNIT_TITLE_MAX2} characters. The app lists the titles; the person taps one to read its body.`),
+  body: external_exports.string().trim().min(1).describe(`The unit itself, at most ${UNIT_BODY_MAX2} characters.`)
+}).strict();
+function capRefusals2(text, units22, field) {
+  const out = [];
+  const name = field === "text" ? "answer" : field;
+  if (text.length > ASK_MAX2) out.push({
+    refusal: "ask_too_long",
+    length: text.length,
+    cap: ASK_MAX2,
+    path: field === "text" ? ["answer", "text"] : [field],
+    message: `ask_too_long: the ${name} is ${text.length} characters; the cap is ${ASK_MAX2}. Keep the one point in the ${name} and move the context into units.`
+  });
+  const all = units22 ?? [];
+  if (all.length > UNITS_MAX2) out.push({
+    refusal: "too_many_units",
+    length: all.length,
+    cap: UNITS_MAX2,
+    path: ["units"],
+    message: `too_many_units: ${all.length} units; the cap is ${UNITS_MAX2}. Keep only the context this ${name} needs.`
+  });
+  all.forEach((unit, index) => {
+    if (unit.title.length > UNIT_TITLE_MAX2) out.push({
+      refusal: "unit_title_too_long",
+      index,
+      length: unit.title.length,
+      cap: UNIT_TITLE_MAX2,
+      path: ["units", index, "title"],
+      message: `unit_title_too_long: units[${index}]'s title is ${unit.title.length} characters; the cap is ${UNIT_TITLE_MAX2}.`
+    });
+    if (unit.body.length > UNIT_BODY_MAX2) out.push({
+      refusal: "unit_body_too_long",
+      index,
+      length: unit.body.length,
+      cap: UNIT_BODY_MAX2,
+      path: ["units", index, "body"],
+      message: `unit_body_too_long: units[${index}]'s body is ${unit.body.length} characters; the cap is ${UNIT_BODY_MAX2}. Cut it into two units.`
+    });
+  });
+  return out;
+}
+function refuseOverCaps2(text, units22, field, ctx) {
+  for (const { path, message, ...params } of capRefusals2(text, units22, field)) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path, message, params });
+}
+var questionHandle2 = external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/, "a question id, whole or its first eight characters");
+var NodeRef2 = external_exports.object({
+  type: external_exports.enum(["goal", "question"]),
+  id: external_exports.string().uuid()
+}).strict().describe("A Goal or a Question, by its id.");
+var BlockedAction2 = external_exports.enum(["start", "complete", "answer"]).describe("What waits: starting or completing a Goal, or answering a Question.");
+var reason2 = external_exports.string().trim().min(1).max(500).describe("Why, as an explanation, never as policy.");
+var actionFits2 = (b) => b.blocked.type === "goal" === (b.action !== "answer");
+var ACTION_FITS2 = "a goal is blocked from start or complete; a question from answer";
+var userExplicitlyRequested2 = external_exports.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 units2 = external_exports.array(UnitInputSchema2).optional().describe(
+  `The context this message needs, as up to ${UNITS_MAX2} units in reading order, each {title, body}: a title of at most ${UNIT_TITLE_MAX2} characters and a body of at most ${UNIT_BODY_MAX2}. One idea per unit. Leave it out when the main text says it all.`
+);
+var UpdateInputSchema2 = external_exports.object({
+  message: external_exports.string().trim().min(1).describe(`The one point, at most ${ASK_MAX2} characters; the context goes in units.`),
+  goalIds: external_exports.array(external_exports.string().uuid()).min(1).max(10).describe("The Goals it is about, each one that exists: the one it is mainly about first."),
+  units: units2,
+  userExplicitlyRequested: userExplicitlyRequested2
+}).strict().superRefine((u, ctx) => refuseOverCaps2(u.message, u.units, "message", ctx));
+var questionFields2 = {
+  question: external_exports.string().trim().min(1).describe(
+    `ONE question, in at most ${ASK_MAX2} characters, and only what is needed to answer it; the context goes in units. Several questions are several objects, one each: an answer settles the one question it was given, so a person who answers the part of a bundled question that interested them settles nothing and is asked again. Separate questions cost nothing: ANY contact for a person already on a call JOINS that call, so several arrive as one call.`
   ),
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional(),
+  goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
+  units: units2,
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
   // 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: external_exports.enum(["one", "many"]).optional().describe(
-    '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.'
+  // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
+  pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
+    'How the options are answered: "one" (the default) a pick, for alternatives; "many" a checklist, for independent options they may want several of; "rank" an order of all of them. Only with options.'
   ),
-  answers: external_exports.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. 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 StartContactSchema2 = external_exports.object({
-  asks: external_exports.array(AskInputSchema2).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: external_exports.enum(["none", "hard"]).default("none").describe("hard requests a call even when channel is notification; user permissions and ring cooldowns still apply."),
-  channel: external_exports.enum(["notification", "call"]).default("notification")
-}).strict();
-var ReceiveContactSchema2 = external_exports.object({
-  wait: external_exports.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)."
+  // WHAT THE QUESTION HOLDS UP (brain_prompts.md §2.1): replaces `waiting: 'hard'`. A question that
+  // blocks work asks for a call (the person's settings and ring cooldowns still decide).
+  workItBlocks: external_exports.array(external_exports.object({ blocked: NodeRef2, action: BlockedAction2, reason: reason2.optional() }).strict().refine(actionFits2, ACTION_FITS2)).min(1).max(10).optional().describe(
+    "The work that cannot go on until this is answered: a Goal's start or completion, or another Question's answer. Only for work truly blocked; it asks for a call. Leave it out for a question you can keep working around."
+  ),
+  userExplicitlyRequested: userExplicitlyRequested2
+};
+var refineQuestion2 = (q, ctx) => {
+  refuseOverCaps2(q.question, q.units, "question", ctx);
+  if (q.pickMode && !q.options) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["pickMode"], message: "pickMode comes only with options" });
+  const ids = (q.options ?? []).map((o) => o.id);
+  if (ids.some((id22) => id22) && (ids.some((id22) => !id22) || new Set(ids).size !== ids.length)) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["options"], message: "give every option a distinct id, or none" });
+  }
+};
+var QuestionInputSchema2 = external_exports.object({
+  questionId: external_exports.string().uuid().optional().describe("Optional: your own stable id for this question (a UUID), so a resend is the same question. Minted for you when omitted; the result returns it."),
+  ...questionFields2
+}).strict().superRefine(refineQuestion2);
+var QuestionWireSchema2 = external_exports.object({ questionId: external_exports.string().uuid(), ...questionFields2 }).strict().superRefine(refineQuestion2);
+var AnswerInputSchema2 = external_exports.object({
+  questionId: questionHandle2.describe("The Question you answer: its id as the event or the conversation shows it (8 characters or whole)."),
+  answer: external_exports.object({
+    text: external_exports.string().trim().min(1).describe(`Your answer in your own words, at most ${ASK_MAX2} characters; the context goes in units.`),
+    selectedOptionIds: external_exports.array(external_exports.string().trim().min(1)).min(1).max(6).optional().describe("The ids of the options you choose, when the Question offered options (in order, for a ranking).")
+  }).strict(),
+  units: units2
+}).strict().superRefine((a, ctx) => refuseOverCaps2(a.answer.text, a.units, "text", ctx));
+var QuestionDependencySchema2 = external_exports.object({
+  questionId: questionHandle2.describe("A Question you asked."),
+  change: external_exports.enum(["add", "remove"]),
+  blocked: NodeRef2,
+  action: BlockedAction2,
+  reason: reason2.optional()
+}).strict().refine(actionFits2, ACTION_FITS2);
+var sendFields2 = {
+  updates: external_exports.array(UpdateInputSchema2).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."
   ),
+  answers: external_exports.array(AnswerInputSchema2).min(1).max(20).optional().describe("Answers to Questions addressed to you."),
+  withdrawQuestionIds: external_exports.array(questionHandle2).min(1).max(10).optional().describe(
+    "Questions you asked that no longer need an answer: you acted on them yourself, they no longer matter, or you asked wrongly. Each is cancelled, not answered: its card closes and nothing rings for it."
+  ),
+  questionDependencies: external_exports.array(QuestionDependencySchema2).min(1).max(20).optional().describe(
+    "Add or remove what a Question you asked holds up, after asking it."
+  )
+};
+var ContactSchema2 = external_exports.object({
+  ...sendFields2,
+  questions: external_exports.array(QuestionInputSchema2).min(1).max(20).optional().describe("Questions for the person, one per object."),
+  /** RECEIVING (2I, I2; brain_prompts.md §2.2): the events this agent handled. */
   ackEventIds: external_exports.array(external_exports.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."
+    "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."
+  ),
+  wait: external_exports.boolean().optional().describe(
+    "Only controls when this returns. Sending: false (the default) returns at once; true waits up to about 45 seconds for a response to what you sent. Sending nothing: true (the default) waits up to about 45 seconds for anything addressed to you; false returns 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; wait again without sending again), or `not_waited`."
   )
 }).strict();
-var ContactSchema2 = external_exports.union([StartContactSchema2, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict(), ReceiveContactSchema2]);
+var sendsAnything2 = (c) => !!(c.updates?.length || c.questions?.length || c.answers?.length || c.withdrawQuestionIds?.length || c.questionDependencies?.length);
+var ContactWireSchema2 = external_exports.object({
+  operationId: external_exports.string().uuid(),
+  ...sendFields2,
+  questions: external_exports.array(QuestionWireSchema2).min(1).max(20).optional()
+}).strict().refine(sendsAnything2, "a contact sends at least one update, question, answer, withdrawal or question dependency");
 var CONTACT_SCHEMA2 = { type: "object", ...mcpInputSchema2(ContactSchema2) };
-var CONTACT_DESCRIPTION2 = "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 CONTACT_DESCRIPTION2 = `Send to and receive from the person: 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.
+
+QUESTIONS: one question per object; several questions are several objects in one contact, so each can be answered on its own. Each is sent exactly as written, with no reading in between: a bundled question arrives as one card. Give options when you have them. 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'). pickMode:'one' (the default) makes a pick, for alternatives; 'many' a checklist, for independent options they may want several of; 'rank' an ordering. The person can always answer in their own words, so never add an 'Other' option. workItBlocks names the work a question holds up, only when you are truly blocked: it asks for a call. Answers land on the question's Goal: collect them by receiving (below) or with get_goal.
+
+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_MAX2} characters; everything else it needs goes in 'units', up to ${UNITS_MAX2} {title, body} in reading order, one idea each, every title at most ${UNIT_TITLE_MAX2} characters and every body at most ${UNIT_BODY_MAX2}. 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.
+
+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. So when the work is finished, mark the Goal done first (manage_goals), then send one update saying what is done and anything they need to do or check. 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.
+
+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_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\`; your first write to it starts it) and your work gone quiet (\`stalled\`).`;
 var CreateGoalSchema2 = external_exports.object({
   outcome: external_exports.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
@@ -14419,21 +14698,11 @@ var UpdateGoalSchema2 = external_exports.object({
     state: external_exports.enum(["active", "done", "cancelled"]).optional(),
     progress: external_exports.string().trim().min(1).max(1e4).optional(),
     reviewed: external_exports.literal(true).optional(),
-    dueAt: external_exports.string().datetime({ offset: true }).nullable().optional(),
-    /** WITHDRAW YOUR OWN QUESTION (#2777, owner 2026-09-30). The question's id as every read shows it
-     *  (the conversation's `id`, eight characters, or the whole request Entry id), on THIS Goal, asked
-     *  by you and still open. It is cancelled, not answered: its cards close and nothing rings for it. */
-    withdraw: external_exports.array(external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/)).min(1).max(10).optional()
+    dueAt: external_exports.string().datetime({ offset: true }).nullable().optional()
   }).strict().refine((v) => Object.keys(v).length > 0),
   reason: external_exports.string().trim().min(1).max(2e3),
   operationId: external_exports.string().uuid().optional()
 }).strict();
-var UpdateGoalToolSchema2 = external_exports.object({
-  goalId: external_exports.string().uuid(),
-  revision: UpdateGoalSchema2.shape.revision,
-  changes: UpdateGoalSchema2.shape.changes.innerType().pick({ progress: true, reviewed: true, dueAt: true, withdraw: true }).strict().refine((v) => Object.keys(v).length > 0),
-  reason: UpdateGoalSchema2.shape.reason
-}).strict();
 var changedGoal2 = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
 var goalTitle2 = external_exports.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 goalOutcome2 = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
@@ -14441,7 +14710,7 @@ var CreateChange2 = external_exports.object({
   kind: external_exports.literal("create"),
   title: goalTitle2,
   outcome: goalOutcome2,
-  ownerId: external_exports.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."),
+  ownerId: external_exports.string().trim().min(1).optional().describe("Who owns the work: an agent's participant (as check_activity shows it) or the person's. Omitted: you."),
   parentGoalId: external_exports.string().uuid().optional().describe("The Goal it belongs under. Omitted: a root."),
   sourceEntryIds: external_exports.array(external_exports.string().uuid()).max(20).optional().describe("The whole Entries the work came from, ones you can read.")
 }).strict();
@@ -14451,7 +14720,7 @@ var StateChange2 = external_exports.object({ kind: external_exports.literal("sta
 ) }).strict();
 var AssignChange2 = external_exports.object({ kind: external_exports.literal("assign"), goalId: changedGoal2, ownerId: external_exports.string().trim().min(1).describe("The new owner's participant.") }).strict();
 var DeferChange2 = external_exports.object({ kind: external_exports.literal("defer"), goalId: changedGoal2, until: external_exports.string().datetime({ offset: true }).nullable().describe(
-  "Postpone it until this instant (its owner is woken then), or null to take the postponement back."
+  "Postpone it until this instant: it waits until then, and its owner is woken when it passes (a promise to follow up later). null takes the postponement back."
 ) }).strict();
 var MoveChange2 = external_exports.object({ kind: external_exports.literal("move"), goalId: changedGoal2, parentGoalId: external_exports.string().uuid().nullable().describe(
   "Its new parent, or null for a root. Only this Goal moves; its new parent's other children stay."
@@ -14486,8 +14755,7 @@ var ManageGoalsSchema2 = external_exports.object({
 var ManageGoalsToolSchema2 = external_exports.object({
   changes: external_exports.array(external_exports.discriminatedUnion("kind", [CreateChange2, EditChange2, StateChange2, AssignChange2, DeferChange2, MoveChange2, DependencyChange2])).min(1).max(50).describe("The changes, applied in order, each on its own.")
 }).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
-var MANAGE_GOALS_DESCRIPTION2 = "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 ClaimGoalSchema2 = external_exports.object({ goalId: external_exports.string().uuid().optional() }).strict();
+var MANAGE_GOALS_DESCRIPTION2 = "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_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: the Goal waits until then and its owner is woken when it passes; null takes it back); 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 any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -14498,9 +14766,7 @@ var GetGoalSchema2 = external_exports.object({
    *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
   diagnose: external_exports.boolean().optional()
 }).strict();
-var GET_GOAL_DESCRIPTION2 = "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_DESCRIPTION2 = "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_DESCRIPTION2 = "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 GET_GOAL_DESCRIPTION2 = "Read one Goal (a read never puts you on 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 SearchToolSchema2 = external_exports.object({
   query: external_exports.string().trim().min(1).max(500),
   types: external_exports.array(external_exports.enum(["entry", "goal", "answer"])).min(1).optional(),
@@ -14508,15 +14774,21 @@ var SearchToolSchema2 = external_exports.object({
   limit: external_exports.number().int().min(1).max(20).optional()
 }).strict();
 var SEARCH_DESCRIPTION2 = "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 WhoIsWorkingSchema2 = external_exports.object({}).strict();
+var CheckActivitySchema2 = external_exports.object({}).strict();
+var FEEDBACK_TEXT_MAX2 = 5e4;
+var SendFeedbackSchema2 = external_exports.object({
+  text: external_exports.string().trim().min(1).max(FEEDBACK_TEXT_MAX2).describe(`The report, in markdown: what happened, what was expected, how to reproduce it, versions, evidence. At most ${FEEDBACK_TEXT_MAX2} characters.`),
+  title: external_exports.string().trim().min(1).max(200).optional().describe("One line naming it."),
+  kind: external_exports.enum(["bug", "idea", "other"]).default("other").describe("bug: something Paigy does wrong. idea: something it should do. other: anything else.")
+}).strict();
+var SEND_FEEDBACK_DESCRIPTION2 = "Send feedback about Paigy itself (a bug report, an idea) straight to the Paigy team. Send it only when the person asked you to, or agreed when you offered: it goes to Paigy, never to the person, and nobody answers it here. Not for your work or a question for the person: use contact for those. Returns whether it was stored.";
 var AGENT_TOOLS2 = [
-  { 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: mcpInputSchema2(WhoIsWorkingSchema2) },
   { name: "contact", description: CONTACT_DESCRIPTION2, inputSchema: CONTACT_SCHEMA2 },
   { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION2, inputSchema: mcpInputSchema2(ManageGoalsToolSchema2) },
-  { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(ClaimGoalSchema2) },
   { name: "get_goal", description: GET_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(GetGoalSchema2) },
-  { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(UpdateGoalToolSchema2) },
-  { name: "search", description: SEARCH_DESCRIPTION2, inputSchema: mcpInputSchema2(SearchToolSchema2) }
+  { name: "search", description: SEARCH_DESCRIPTION2, inputSchema: mcpInputSchema2(SearchToolSchema2) },
+  { name: "check_activity", 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: mcpInputSchema2(CheckActivitySchema2) },
+  { name: "send_feedback", description: SEND_FEEDBACK_DESCRIPTION2, inputSchema: mcpInputSchema2(SendFeedbackSchema2) }
 ];
 var AGENT_TOOL_NAMES2 = AGENT_TOOLS2.map((t) => t.name);
 var id2 = external_exports.string().uuid();
@@ -14628,33 +14900,93 @@ var BrainResultSchema2 = external_exports.object({
   next: BrainNextSchema2,
   search: BrainSearchSchema2.optional()
 }).strict();
-var str2 = external_exports.string();
-var strs2 = external_exports.array(external_exports.string());
+var str4 = external_exports.string();
+var strs4 = external_exports.array(external_exports.string());
 var CompactResultSchema2 = external_exports.object({
-  next: external_exports.object({ say: strs2, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs2, reason: str2, instructions: strs2 }).strict(),
-  messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, entries: strs2, owed: strs2, inviteToCall: external_exports.boolean() }).strict()),
-  entries: external_exports.array(external_exports.object({ key: str2, from: str2, on: strs2 }).strict()),
-  answers: external_exports.array(external_exports.object({ question: str2, entries: strs2, summary: str2, picked: strs2 }).strict()),
+  next: external_exports.object({ say: strs4, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs4, reason: str4, instructions: strs4 }).strict(),
+  messages: external_exports.array(external_exports.object({ key: str4, to: str4, text: str4, about: strs4, entries: strs4, owed: strs4, inviteToCall: external_exports.boolean() }).strict()),
+  entries: external_exports.array(external_exports.object({ key: str4, from: str4, on: strs4 }).strict()),
+  answers: external_exports.array(external_exports.object({ question: str4, entries: strs4, summary: str4, picked: strs4 }).strict()),
   changes: external_exports.array(external_exports.object({
-    key: str2,
+    key: str4,
     what: external_exports.enum(["goal", "question", "lesson"]),
     op: external_exports.enum(["create", "edit", "assign", "open", "complete", "cancel", "defer", "move", "block", "unblock", "withdraw", "remember", "revise"]),
-    id: str2,
-    text: str2,
-    title: str2,
-    who: str2,
-    under: str2,
+    id: str4,
+    text: str4,
+    title: str4,
+    who: str4,
+    under: str4,
     gate: external_exports.enum(["start", "complete", "answer", "none"]),
-    options: external_exports.array(external_exports.object({ id: str2, label: str2 }).strict()),
+    options: external_exports.array(external_exports.object({ id: str4, label: str4 }).strict()),
     pick: external_exports.enum(["one", "many", "rank", "words"]),
-    entries: strs2
+    entries: strs4
   }).strict()),
-  feedback: external_exports.array(strs2),
-  search: external_exports.object({ query: str2, within: strs2, goal: str2 }).strict()
+  feedback: external_exports.array(strs4),
+  search: external_exports.object({ query: str4, within: strs4, goal: str4 }).strict()
 }).strict();
 var COMPACT_RESULT_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema2(CompactResultSchema2, { $refStrategy: "none" })
 );
+var str22 = external_exports.string();
+var strs22 = external_exports.array(external_exports.string());
+var TalkerReplySchema2 = external_exports.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: external_exports.array(external_exports.object({ key: str22, to: str22, text: str22, about: strs22, blocks: str22 }).strict()),
+  /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
+  then: external_exports.enum(["listen", "hold", "end"]),
+  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
+  answers: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22 }).strict()),
+  /** The line handles that hold a new instruction from the person. */
+  instruction: strs22,
+  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
+   *  reads only these (3e). */
+  file: strs22,
+  /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
+  need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str22 }).strict(),
+  /** The handle of the item to explain ("" for none). */
+  explain: str22
+}).strict();
+var TALKER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TalkerReplySchema2, { $refStrategy: "none" })
+);
+var str32 = external_exports.string();
+var strs32 = external_exports.array(external_exports.string());
+var FilerReplySchema2 = external_exports.object({
+  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32 }).strict()),
+  goals: external_exports.array(external_exports.object({
+    op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
+    key: str32,
+    goal: str32,
+    title: str32,
+    outcome: str32,
+    owner: str32,
+    under: str32,
+    until: str32,
+    on: str32,
+    gate: external_exports.enum(["start", "complete", "answer", ""]),
+    why: str32
+  }).strict()),
+  questions: external_exports.array(external_exports.object({
+    op: external_exports.enum(["create", "edit", "assign", "withdraw"]),
+    key: str32,
+    question: str32,
+    text: str32,
+    to: str32,
+    goal: str32,
+    options: external_exports.array(external_exports.object({ id: str32, label: str32 }).strict()),
+    pick: external_exports.enum(["one", "many", "rank", "words", ""]),
+    blocks: str32
+  }).strict()),
+  lessons: external_exports.array(external_exports.object({ op: external_exports.enum(["remember", "revise", "withdraw"]), lesson: str32, text: str32, scope: str32 }).strict()),
+  /** Line handles whose words comment on Paigy itself. */
+  feedback: strs32
+}).strict();
+var FILER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(FilerReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -14678,7 +15010,10 @@ var ContextSchema2 = external_exports.object({
   title: external_exports.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: external_exports.array(external_exports.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."
-  )
+  ),
+  /** THE ASK'S UNITS (3c): its context as titled units, in order. The app lists the titles and opens
+   *  a body on a tap. Absent on an ask sent without units, which renders as before. */
+  units: external_exports.array(external_exports.object({ title: external_exports.string(), body: external_exports.string() })).optional()
 });
 var ParticipantSchema2 = external_exports.object({
   kind: external_exports.enum(["human", "agent"]),
@@ -14753,7 +15088,7 @@ var NotifyRequestFields2 = external_exports.object({
    *  ABSENT on the E2EE path, where the sealed `envelope` below carries it. The
    *  superRefine at the bottom enforces exactly one of the two. */
   context: ContextSchema2.optional(),
-  options: external_exports.array(OptionInputSchema2).min(OPTIONS_MIN2).max(OPTIONS_MAX2).optional().describe(
+  options: external_exports.array(OptionSchema2.omit({ id: true }).extend({ label: external_exports.string().trim().min(1).max(1e3) }).strict()).min(OPTIONS_MIN2).max(OPTIONS_MAX2).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: external_exports.array(external_exports.string().min(1)).optional().describe(
@@ -15514,8 +15849,8 @@ var QueueItemSchema2 = external_exports.object({
   repo: external_exports.string().nullable().optional(),
   createdAt: external_exports.string(),
   updatedAt: external_exports.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
+  /** When its owner last SAID something about it (the newest `progress` Entry: a contact update kept
+   *  as 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: external_exports.string().nullable().optional(),
   /** THE GOAL'S NEWEST WORD, FROM EITHER SIDE (owner, 2026-09-27): the newest Entry on it, of any
@@ -15671,7 +16006,7 @@ var HostDecisionSchema2 = external_exports.object({
   /** The agent's token id: the row's `recipient`. */
   agent: external_exports.string().uuid(),
   decision: external_exports.enum(["stood_back", "took_over"]),
-  /** The work it was about: the Goal `claim_goal` would hand that agent next. */
+  /** The work it was about: the Goal waiting on that agent next (`claimable` on its `contact({})` read). */
   goalId: external_exports.string().uuid().nullable().optional(),
   /** When the server last heard from the agent, as the host read it: the presence it stood back for. */
   seenAt: external_exports.string().datetime().nullable().optional(),
@@ -15898,7 +16233,7 @@ function sameTail(a, b) {
 }
 
 // src/run.ts
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 
 // src/harness/session.ts
 import { spawn } from "child_process";
@@ -16182,7 +16517,7 @@ var frame2 = (body) => JSON.stringify({ jsonrpc: "2.0", ...body });
 import { mkdirSync as mkdirSync3, readdirSync as readdirSync4, renameSync, rmSync as rmSync2, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join8 } from "path";
 import { homedir as homedir8 } from "os";
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 var MIDTURN_HOOK = `d="$PAIGY_INBOX"; [ -n "$d" ] || { cat >/dev/null; exit 0; }; set -- "$d"/*.note; [ -e "$1" ] || { cat >/dev/null; exit 0; }; grep '"agent_id"' >/dev/null && exit 0; mkdir -p "$d/taken"; o=""; for f in "$@"; do n=\${f##*/}; mv "$f" "$d/taken/$n" 2>/dev/null || continue; touch "$d/taken/$n"; o="$o\${o:+\\n\\n}$(cat "$d/taken/$n")"; done; [ -n "$o" ] || exit 0; printf '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":"%s"}}' "$o"`;
 var missing = (error) => error.code === "ENOENT";
 function openInbox(dir) {
@@ -16242,7 +16577,7 @@ function inboxFor(root = INBOX_ROOT) {
   } catch (error) {
     if (!missing(error)) throw error;
   }
-  return openInbox(join8(root, `${process.pid}-${randomUUID4().slice(0, 8)}`));
+  return openInbox(join8(root, `${process.pid}-${randomUUID3().slice(0, 8)}`));
 }
 
 // src/harness/session.ts
@@ -16376,6 +16711,32 @@ function startSession(opts) {
   };
 }
 
+// src/paigy/cut.ts
+function cut(text, title = "Details") {
+  const all = text.trim();
+  if (all.length <= ASK_MAX2) return { main: all };
+  const main = head(all, ASK_MAX2);
+  const units3 = [];
+  let rest = all.slice(main.length).trim();
+  while (rest && units3.length < UNITS_MAX2) {
+    const last = units3.length === UNITS_MAX2 - 1;
+    const body = last && rest.length > UNIT_BODY_MAX2 ? `${head(rest, UNIT_BODY_MAX2 - 1).trimEnd()}\u2026` : head(rest, UNIT_BODY_MAX2);
+    units3.push({ title: units3.length ? `${title} (${units3.length + 1})` : title, body: body.trim() });
+    rest = last ? "" : rest.slice(body.length).trim();
+  }
+  return { main: main.trim(), units: units3 };
+}
+function head(text, max) {
+  if (text.length <= max) return text;
+  const window = text.slice(0, max + 1);
+  for (const boundary of [/\n\s*\n/g, /[.!?](\s)/g, /\s/g]) {
+    let at = -1;
+    for (const m of window.matchAll(boundary)) if (m.index > max / 3 && m.index < max) at = m.index + (boundary.source.startsWith("[") ? 1 : 0);
+    if (at > 0) return text.slice(0, at);
+  }
+  return text.slice(0, max);
+}
+
 // src/paigy/limit.ts
 var LIMIT_PREFIXES = [
   "You've hit your",
@@ -16504,10 +16865,19 @@ var LIMITS = episodes();
 // src/paigy/bridge.ts
 function railFor(opts) {
   return {
-    claim: (goalId) => claimGoal(goalId, opts),
+    next: async () => {
+      const waiting = await receive(opts);
+      const goalId = waiting.claimable?.goalId ?? waiting.review?.[0]?.goalId;
+      return goalId ? getGoal(goalId, opts) : { state: "idle", message: "" };
+    },
     read: (goalId) => getGoal(goalId, opts),
-    update: (goalId, input) => updateGoal(goalId, input, opts),
-    // One read and back: the pump owns the waiting, so a Call must not hold a window here.
+    complete: async (goalId, revision) => {
+      const done = await manageGoals({ changes: [{ kind: "state", goalId, state: "completed", ...revision !== void 0 ? { revision } : {} }] }, opts);
+      const result = done.results[0];
+      if (result?.status !== "applied") throw new Error(`manage_goals failed: ${result?.error ?? "no result"}`);
+    },
+    ack: (eventIds) => acknowledge(eventIds, opts),
+    // One read and back: the pump owns the waiting, so no wait is held here.
     contact: (input) => contact(input, { ...opts, waits: false }),
     create: async (input) => {
       const made = await manageGoals({ changes: [{ kind: "create", ...input }] }, opts);
@@ -16536,13 +16906,18 @@ function decisionFrom(result) {
 }
 async function ask(state, rail, input) {
   if (!state.goal) return null;
+  const { main, units: units3 } = cut(input.ask);
   try {
     const sent = await rail.contact({
-      asks: [{ ask: input.ask, parentId: state.goal.id, options: input.options }],
-      waiting: "hard",
-      channel: "call"
+      questions: [{
+        question: main,
+        ...units3 ? { units: units3 } : {},
+        goalId: state.goal.id,
+        options: input.options,
+        workItBlocks: [{ blocked: { type: "goal", id: state.goal.id }, action: "complete", reason: "The agent cannot go on without this approval." }]
+      }]
     });
-    if ("recorded" in sent) return null;
+    if ("sent" in sent) return null;
     const entryId = sent.requestEntryIds[0];
     if (!entryId) return null;
     (state.seen ??= /* @__PURE__ */ new Set()).add(entryId);
@@ -16560,57 +16935,54 @@ async function askPermission(event, state, rail) {
     ]
   }));
 }
-async function finish(result, state, rail, opts) {
+async function finish(state, rail, opts) {
   const goal = state.goal;
   if (!goal) return;
-  const progress = result?.trim().slice(0, 1e4) || void 0;
-  let revision = goal.revision;
   try {
     const held = await rail.read(goal.id);
-    revision = held.revision ?? revision;
     const owed = state.noted?.some((b) => b.goals.includes(goal.id));
     if (held.state === "done" || held.state === "cancelled") {
       if (!owed) state.goal = void 0;
       return;
     }
     if (!held.openDecisionNeedIds?.length && !owed) {
-      await rail.update(goal.id, { revision, changes: { state: "done", ...progress ? { progress } : {} }, reason: "The agent finished its turn." });
+      await rail.complete(goal.id, held.revision ?? goal.revision);
       state.goal = void 0;
-      return;
     }
   } catch (error) {
     opts?.log?.(`\u26A0 the Goal did not close, still holding it: ${error.message}`);
   }
-  if (!progress) return;
-  try {
-    await rail.update(goal.id, { revision, changes: { progress }, reason: "The agent's turn ended; its Goal is not closed yet." });
-  } catch (error) {
-    opts?.log?.(`\u26A0 could not keep the turn as progress: ${error.message}`);
-  }
 }
 async function cannotWork(report, state, rail, opts) {
   state.resting = true;
-  const say = (parentId) => rail.contact({ asks: [{ ask: report, ...parentId ? { parentId } : {} }], waiting: "none", channel: "notification" });
+  const { main, units: units3 } = cut(report);
+  const say = (goalId) => rail.contact({ updates: [{ message: main, ...units3 ? { units: units3 } : {}, goalIds: [goalId] }] });
+  const own = async () => (await rail.create({ title: "Agent cannot work", outcome: main })).goalId;
   try {
     if (!state.goal) {
-      const claimed = await rail.claim().catch(() => void 0);
-      if (claimed?.goalId && claimed.revision !== void 0) state.goal = { id: claimed.goalId, revision: claimed.revision };
+      const next = await rail.next().catch(() => void 0);
+      if (next?.goalId && next.revision !== void 0) state.goal = { id: next.goalId, revision: next.revision };
     }
     if (!state.goal) {
-      await say();
+      await say(await own());
       return;
     }
     try {
       await say(state.goal.id);
     } catch (error) {
-      if (!/goal_parent_invalid/.test(error.message)) throw error;
-      opts?.log?.(`\u26A0 the held Goal ${state.goal.id.slice(0, 8)} refused the notice (goal_parent_invalid) \u2014 saying it unplaced`);
-      await say();
+      if (!/goal_not_found/.test(error.message)) throw error;
+      opts?.log?.(`\u26A0 the held Goal ${state.goal.id.slice(0, 8)} is gone (goal_not_found) \u2014 saying it on a Goal of its own`);
+      await say(await own());
     }
   } catch (error) {
     opts?.log?.(`\u26A0 could not say the agent cannot work: ${error.message}`);
   }
 }
+async function callForResume(text, state, rail) {
+  const { main, units: units3 } = cut(text);
+  const goalId = state.goal?.id ?? (await rail.create({ title: "Usage limit reset", outcome: main })).goalId;
+  return rail.contact({ updates: [{ message: main, ...units3 ? { units: units3 } : {}, goalIds: [goalId], userExplicitlyRequested: "call" }] });
+}
 function conversationFull(result) {
   return /prompt is too long/i.test(result ?? "");
 }
@@ -16637,14 +17009,14 @@ async function afterTurn(event, state, rail, opts) {
 ${event.result?.trim() || "No result reported."}`, state, rail, opts);
     return void 0;
   }
-  await finish(event.result, state, rail, opts);
+  await finish(state, rail, opts);
   state.typed = void 0;
   state.resting = true;
   return void 0;
 }
 
 // src/paigy/conversation.ts
-var HARNESS_INSTRUCTION = "You are running as an unattended background harness agent; your user reaches you through Paigy and is not at this terminal. Nothing wakes you after your turn ends but the person, so wait on CI or a deploy inside the turn. The person never sees your turn's final message: it is kept as progress on this Goal. Anything the person needs \u2014 a question, a result, a blocker \u2014 you send through Paigy's contact tool, once; the harness sends nothing on your behalf. What the person says later arrives with the Goal it was said on named in front of it; answer them on that Goal (its id as the contact's parentId).";
+var HARNESS_INSTRUCTION = "You are running as an unattended background harness agent; your user reaches you through Paigy and is not at this terminal. Nothing wakes you after your turn ends but the person, so wait on CI or a deploy inside the turn. The person never sees your turn's final message, and it is not kept: report where the work stands with a contact update on this Goal (one the person does not need yet is kept as its progress). Anything the person needs \u2014 a question, a result, a blocker \u2014 you send through Paigy's contact tool, once; the harness sends nothing on your behalf. What the person says later arrives with the Goal it was said on named in front of it; answer them on that Goal (its id as the contact's goalId).";
 var SAFETY_MS = 6e4;
 var ASK_BEAT_MS = 5e3;
 function beat() {
@@ -16744,18 +17116,23 @@ async function gather(state, rail, held) {
     if (!looks.has(goalId)) looks.set(goalId, { via, ...title ? { title } : {}, ...since !== void 0 ? { since } : {} });
   };
   const waiting = await rail.waiting().catch(() => null);
-  const listed = /* @__PURE__ */ new Set();
+  const listed = /* @__PURE__ */ new Map();
+  const list = (goalId, eventId) => {
+    const ids = listed.get(goalId) ?? [];
+    if (eventId && !ids.includes(eventId)) ids.push(eventId);
+    listed.set(goalId, ids);
+  };
   const announced = state.announced ??= /* @__PURE__ */ new Set();
   if (waiting) {
     for (const id3 of announced) if (!(waiting.assigned ?? []).some((g) => g.goalId === id3)) announced.delete(id3);
   }
   for (const g of waiting?.assigned ?? []) if (g.goalId !== state.goal.id && !announced.has(g.goalId)) look2(g.goalId, "assigned", g.title);
   for (const g of waiting?.review ?? []) {
-    listed.add(g.goalId);
+    list(g.goalId, g.eventId);
     look2(g.goalId, "waiting work", g.title);
   }
   for (const d of waiting?.deliveries ?? []) for (const id3 of d.goalIds) {
-    listed.add(id3);
+    list(id3, d.deliveryId);
     look2(id3, "waiting work");
   }
   const moved = movedBelow(held, state);
@@ -16780,7 +17157,7 @@ async function gather(state, rail, held) {
   for (const { goal, since } of moved) if (read3.has(goal.goalId)) state.below.goals.set(goal.goalId, { since, at: goal.updatedAt ?? null });
   return { heard, listed };
 }
-var GIVEN = "This Goal was given to you, and nobody has started it. Carry on with what you're doing unless it changes that; claim_goal with its id when you take it up.";
+var GIVEN = "This Goal was given to you, and nobody has started it. Carry on with what you're doing unless it changes that; your first write to it (a contact update naming it) starts it when you take it up.";
 var says = (h) => h.words.length > 0 || h.via === "assigned";
 function whatItIs(h) {
   const outcome2 = h.brief.outcome?.trim() ?? "";
@@ -16810,7 +17187,10 @@ async function hear(session, state, rail, held, opts) {
       if (opts?.tally) opts.tally.announced += goals.length;
     }
   }
-  for (const h of heard) if (listed.has(h.goalId)) await acknowledge(h.goalId, h.brief, state, rail, log2);
+  for (const h of heard) {
+    const events = listed.get(h.goalId);
+    if (events) await acknowledge2(h.goalId, h.brief, events, state, rail, log2);
+  }
 }
 var NOTED = "New from the person while you work. Carry on unless it changes what you're doing: it comes back to you as your next turn when this one ends.";
 var SEEN_MID_TURN = "While you worked, the person said this, and you saw it mid-task. Act on it now, unless you already have.";
@@ -16856,15 +17236,16 @@ function settle(session, state, inbox, log2) {
   send2(session, state, [...seen.length ? [SEEN_MID_TURN, ...seen.map((b) => b.words)] : [], ...unseen.map((b) => b.words)].join("\n\n"));
   log2?.(`\u25B8 typed the person's words from ${short([...new Set(batches.flatMap((b) => b.goals))])} (noted mid-turn: ${seen.length} seen by the hook, ${unseen.length} not)`);
 }
-async function acknowledge(goalId, brief, state, rail, log2) {
+async function acknowledge2(goalId, brief, events, state, rail, log2) {
+  const ids = [.../* @__PURE__ */ new Set([...brief.reviewEventId ? [brief.reviewEventId] : [], ...events])];
+  if (!ids.length) return;
   const acked = state.acked ??= /* @__PURE__ */ new Map();
-  if (acked.has(goalId) && acked.get(goalId) === brief.revision) return;
-  acked.set(goalId, brief.revision);
+  const key3 = ids.join(",");
+  if (acked.get(goalId) === key3) return;
+  acked.set(goalId, key3);
   try {
-    if (brief.revision === void 0) throw new Error("review_revision_missing");
-    const done = await rail.update(goalId, { revision: brief.revision, changes: { reviewed: true }, reason: "Read by the harness session; the person's words on it are typed in." });
-    acked.set(goalId, done.revision);
-    if (state.goal?.id === goalId && done.revision !== void 0) state.goal.revision = done.revision;
+    const refused = (await rail.ack(ids)).filter((a) => a.refused);
+    if (refused.length) log2?.(`\u26A0 could not acknowledge ${goalId.slice(0, 8)}: ${refused.map((a) => `${a.eventId.slice(0, 8)} ${a.refused}`).join(", ")} \u2014 its words are typed in; it stays listed until acknowledged`);
   } catch (error) {
     log2?.(`\u26A0 could not acknowledge ${goalId.slice(0, 8)}: ${error.message} \u2014 its words are typed in; it stays listed until acknowledged`);
   }
@@ -16890,13 +17271,13 @@ async function look(session, state, rail, opts) {
   if (state.resting && state.noted?.length && !state.asks?.size) return settle(session, state, opts?.inbox, opts?.log);
   if (!state.goal) {
     if (!state.resting) return;
-    let brief2 = await rail.claim();
+    let brief2 = await rail.next();
     if (!brief2.goalId || brief2.revision === void 0) {
       if (opts?.initialPrompt?.trim()) {
         const prompt = opts.initialPrompt.trim();
         opts.initialPrompt = void 0;
         const admitted = await rail.create({ title: prompt.split(/\s+/).slice(0, 5).join(" ").slice(0, 80), outcome: prompt });
-        brief2 = await rail.claim();
+        brief2 = await rail.next();
         if (!brief2.goalId || brief2.revision === void 0) {
           state.goal = { id: admitted.goalId, revision: admitted.revision };
           send2(session, state, [HARNESS_INSTRUCTION, named(admitted.goalId, void 0, { outcome: prompt }), prompt].join("\n\n"));
@@ -16918,7 +17299,7 @@ async function look(session, state, rail, opts) {
     const earlier = left ? `(${left} earlier entries on this Goal are left out or shortened; get_goal with history: true reads them in full.)` : "";
     const fullText = [outcome2, earlier, ...said].filter(Boolean).join("\n\n");
     send2(session, state, [HARNESS_INSTRUCTION, named(brief2.goalId, void 0, brief2), fullText].filter(Boolean).join("\n\n"));
-    if (ended(brief2.state)) await acknowledge(brief2.goalId, brief2, state, rail, opts?.log);
+    if (ended(brief2.state)) await acknowledge2(brief2.goalId, brief2, [], state, rail, opts?.log);
     return;
   }
   const brief = await rail.read(state.goal.id);
@@ -17006,7 +17387,7 @@ function runHarness(opts) {
   const clock4 = beat();
   let session = null;
   const speaksAs = opts.session ?? opts.resume ?? sessionId();
-  const instance = randomUUID5();
+  const instance = randomUUID4();
   const rail = railFor({ token: opts.token, reach: reachAs(speaksAs, instance) });
   let inbox;
   if (opts.harness === "claude") {
@@ -17020,7 +17401,7 @@ function runHarness(opts) {
   function runningAgain() {
     state.carriedOn = false;
     opts.log("\u25B6 running again after the limit");
-    LIMITS.running(name, (text) => rail.contact({ asks: [{ ask: text, ...state.goal ? { parentId: state.goal.id } : {} }], waiting: "none", channel: "call" }), opts.log);
+    LIMITS.running(name, (text) => callForResume(text, state, rail), opts.log);
   }
   async function handle(event) {
     if (event.kind === "error") {