@paigy/harness 0.3.35 → 0.3.37

package/dist/cli.js

@@ -5285,7 +5285,7 @@ var require_util = __commonJS({
             }
             return controller.desiredSize > 0;
           },
-          async cancel(reason) {
+          async cancel(reason3) {
             await iterator.return();
           },
           type: "bytes"
@@ -5613,12 +5613,12 @@ var require_diagnostics = __commonJS({
         websocketDebuglog("connection opened %s%s", address, port ? `:${port}` : "");
       });
       diagnosticsChannel.channel("undici:websocket:close").subscribe((evt) => {
-        const { websocket, code, reason } = evt;
+        const { websocket, code, reason: reason3 } = evt;
         websocketDebuglog(
           "closed connection to %s - %s %s",
           websocket.url,
           code,
-          reason
+          reason3
         );
       });
       diagnosticsChannel.channel("undici:websocket:socket_error").subscribe((err) => {
@@ -7480,25 +7480,25 @@ var require_data_url = __commonJS({
     function isHTTPWhiteSpace(char) {
       return char === 13 || char === 10 || char === 9 || char === 32;
     }
-    function removeHTTPWhitespace(str3, leading = true, trailing = true) {
-      return removeChars(str3, leading, trailing, isHTTPWhiteSpace);
+    function removeHTTPWhitespace(str5, leading = true, trailing = true) {
+      return removeChars(str5, leading, trailing, isHTTPWhiteSpace);
     }
     function isASCIIWhitespace(char) {
       return char === 13 || char === 10 || char === 9 || char === 12 || char === 32;
     }
-    function removeASCIIWhitespace(str3, leading = true, trailing = true) {
-      return removeChars(str3, leading, trailing, isASCIIWhitespace);
+    function removeASCIIWhitespace(str5, leading = true, trailing = true) {
+      return removeChars(str5, leading, trailing, isASCIIWhitespace);
     }
-    function removeChars(str3, leading, trailing, predicate) {
+    function removeChars(str5, leading, trailing, predicate) {
       let lead = 0;
-      let trail = str3.length - 1;
+      let trail = str5.length - 1;
       if (leading) {
-        while (lead < str3.length && predicate(str3.charCodeAt(lead))) lead++;
+        while (lead < str5.length && predicate(str5.charCodeAt(lead))) lead++;
       }
       if (trailing) {
-        while (trail > 0 && predicate(str3.charCodeAt(trail))) trail--;
+        while (trail > 0 && predicate(str5.charCodeAt(trail))) trail--;
       }
-      return lead === 0 && trail === str3.length - 1 ? str3 : str3.slice(lead, trail + 1);
+      return lead === 0 && trail === str5.length - 1 ? str5 : str5.slice(lead, trail + 1);
     }
     function isomorphicDecode(input) {
       const length = input.length;
@@ -9417,7 +9417,7 @@ var require_body = __commonJS({
         const boundary = `----formdata-undici-0${`${random(1e11)}`.padStart(11, "0")}`;
         const prefix = `--${boundary}\r
 Content-Disposition: form-data`;
-        const escape = (str3) => str3.replace(/\n/g, "%0A").replace(/\r/g, "%0D").replace(/"/g, "%22");
+        const escape = (str5) => str5.replace(/\n/g, "%0A").replace(/\r/g, "%0D").replace(/"/g, "%22");
         const normalizeLinefeeds = (value) => value.replace(/\r?\n|\r/g, "\r\n");
         const blobParts = [];
         const rn = new Uint8Array([13, 10]);
@@ -9505,7 +9505,7 @@ Content-Type: ${value.type || "application/octet-stream"}\r
             }
             return controller.desiredSize > 0;
           },
-          async cancel(reason) {
+          async cancel(reason3) {
             await iterator.return();
           },
           type: "bytes"
@@ -9985,7 +9985,7 @@ var require_client_h1 = __commonJS({
           util2.destroy(this.socket, new HeadersOverflowError());
         }
       }
-      onUpgrade(head) {
+      onUpgrade(head2) {
         const { upgrade, client, socket, headers, statusCode } = this;
         assert(upgrade);
         assert(client[kSocket] === socket);
@@ -10000,7 +10000,7 @@ var require_client_h1 = __commonJS({
         this.shouldKeepAlive = null;
         this.headers = [];
         this.headersSize = 0;
-        socket.unshift(head);
+        socket.unshift(head2);
         socket[kParser].destroy();
         socket[kParser] = null;
         socket[kClient] = null;
@@ -12993,12 +12993,12 @@ var require_retry_handler = __commonJS({
         this.end = null;
         this.etag = null;
         this.resume = null;
-        this.handler.onConnect((reason) => {
+        this.handler.onConnect((reason3) => {
           this.aborted = true;
           if (this.abort) {
-            this.abort(reason);
+            this.abort(reason3);
           } else {
-            this.reason = reason;
+            this.reason = reason3;
           }
         });
       }
@@ -15383,9 +15383,9 @@ var require_dump = __commonJS({
         this.#abort = abort;
         this.#handler.onConnect(this.#customAbort.bind(this));
       }
-      #customAbort(reason) {
+      #customAbort(reason3) {
         this.#aborted = true;
-        this.#reason = reason;
+        this.#reason = reason3;
       }
       // TODO: will require adjustment after new hooks are out
       onHeaders(statusCode, rawHeaders, resume, statusMessage) {
@@ -16412,13 +16412,13 @@ var require_response = __commonJS({
         urlList: init?.urlList ? [...init.urlList] : []
       };
     }
-    function makeNetworkError(reason) {
-      const isError = isErrorLike(reason);
+    function makeNetworkError(reason3) {
+      const isError = isErrorLike(reason3);
       return makeResponse({
         type: "error",
         status: 0,
-        error: isError ? reason : new Error(reason ? String(reason) : reason),
-        aborted: reason && reason.name === "AbortError"
+        error: isError ? reason3 : new Error(reason3 ? String(reason3) : reason3),
+        aborted: reason3 && reason3.name === "AbortError"
       });
     }
     function isNetworkError(response) {
@@ -17400,13 +17400,13 @@ var require_fetch = __commonJS({
         this.dump = false;
         this.state = "ongoing";
       }
-      terminate(reason) {
+      terminate(reason3) {
         if (this.state !== "ongoing") {
           return;
         }
         this.state = "terminated";
-        this.connection?.destroy(reason);
-        this.emit("terminated", reason);
+        this.connection?.destroy(reason3);
+        this.emit("terminated", reason3);
       }
       // https://fetch.spec.whatwg.org/#fetch-controller-abort
       abort(error) {
@@ -17685,7 +17685,7 @@ var require_fetch = __commonJS({
         fetchParams.controller.dump = true;
       }
       if (request.integrity) {
-        const processBodyError = (reason) => fetchFinale(fetchParams, makeNetworkError(reason));
+        const processBodyError = (reason3) => fetchFinale(fetchParams, makeNetworkError(reason3));
         if (request.responseTainting === "opaque" || response.body == null) {
           processBodyError(response.error);
           return;
@@ -18163,9 +18163,9 @@ var require_fetch = __commonJS({
       const pullAlgorithm = async () => {
         await fetchParams.controller.resume();
       };
-      const cancelAlgorithm = (reason) => {
+      const cancelAlgorithm = (reason3) => {
         if (!isCancelled(fetchParams)) {
-          fetchParams.controller.abort(reason);
+          fetchParams.controller.abort(reason3);
         }
       };
       const stream = new ReadableStream(
@@ -18176,8 +18176,8 @@ var require_fetch = __commonJS({
           async pull(controller) {
             await pullAlgorithm(controller);
           },
-          async cancel(reason) {
-            await cancelAlgorithm(reason);
+          async cancel(reason3) {
+            await cancelAlgorithm(reason3);
           },
           type: "bytes"
         }
@@ -18226,7 +18226,7 @@ var require_fetch = __commonJS({
           }
         }
       };
-      function onAborted(reason) {
+      function onAborted(reason3) {
         if (isAborted2(fetchParams)) {
           response.aborted = true;
           if (isReadable(stream)) {
@@ -18237,7 +18237,7 @@ var require_fetch = __commonJS({
         } else {
           if (isReadable(stream)) {
             fetchParams.controller.controller.error(new TypeError("terminated", {
-              cause: isErrorLike(reason) ? reason : void 0
+              cause: isErrorLike(reason3) ? reason3 : void 0
             }));
           }
         }
@@ -20265,9 +20265,9 @@ var require_cookies = __commonJS({
       webidl.argumentLengthCheck(arguments, 2, "setCookie");
       webidl.brandCheck(headers, Headers, { strict: false });
       cookie = webidl.converters.Cookie(cookie);
-      const str3 = stringify(cookie);
-      if (str3) {
-        headers.append("Set-Cookie", str3);
+      const str5 = stringify(cookie);
+      if (str5) {
+        headers.append("Set-Cookie", str5);
       }
     }
     webidl.converters.DeleteCookieAttributes = webidl.dictionaryConverter([
@@ -20778,16 +20778,16 @@ var require_util7 = __commonJS({
       }
       return code >= 3e3 && code <= 4999;
     }
-    function failWebsocketConnection(ws, reason) {
+    function failWebsocketConnection(ws, reason3) {
       const { [kController]: controller, [kResponse]: response } = ws;
       controller.abort();
       if (response?.socket && !response.socket.destroyed) {
         response.socket.destroy();
       }
-      if (reason) {
+      if (reason3) {
         fireEvent("error", ws, (type, init) => new ErrorEvent(type, init), {
-          error: new Error(reason),
-          message: reason
+          error: new Error(reason3),
+          message: reason3
         });
       }
     }
@@ -21045,7 +21045,7 @@ var require_connection = __commonJS({
       });
       return controller;
     }
-    function closeWebSocketConnection(ws, code, reason, reasonByteLength) {
+    function closeWebSocketConnection(ws, code, reason3, reasonByteLength) {
       if (isClosing(ws) || isClosed(ws)) {
       } else if (!isEstablished(ws)) {
         failWebsocketConnection(ws, "Connection was closed before it was established.");
@@ -21053,13 +21053,13 @@ var require_connection = __commonJS({
       } else if (ws[kSentClose] === sentCloseFrameState.NOT_SENT) {
         ws[kSentClose] = sentCloseFrameState.PROCESSING;
         const frame3 = new WebsocketFrameSend();
-        if (code !== void 0 && reason === void 0) {
+        if (code !== void 0 && reason3 === void 0) {
           frame3.frameData = Buffer.allocUnsafe(2);
           frame3.frameData.writeUInt16BE(code, 0);
-        } else if (code !== void 0 && reason !== void 0) {
+        } else if (code !== void 0 && reason3 !== void 0) {
           frame3.frameData = Buffer.allocUnsafe(2 + reasonByteLength);
           frame3.frameData.writeUInt16BE(code, 0);
-          frame3.frameData.write(reason, 2, "utf-8");
+          frame3.frameData.write(reason3, 2, "utf-8");
         } else {
           frame3.frameData = emptyBuffer;
         }
@@ -21084,11 +21084,11 @@ var require_connection = __commonJS({
       response.socket.off("error", onSocketError);
       const wasClean = ws[kSentClose] === sentCloseFrameState.SENT && ws[kReceivedClose];
       let code = 1005;
-      let reason = "";
+      let reason3 = "";
       const result = ws[kByteParser].closingInfo;
       if (result && !result.error) {
         code = result.code ?? 1005;
-        reason = result.reason;
+        reason3 = result.reason;
       } else if (!ws[kReceivedClose]) {
         code = 1006;
       }
@@ -21096,13 +21096,13 @@ var require_connection = __commonJS({
       fireEvent("close", ws, (type, init) => new CloseEvent(type, init), {
         wasClean,
         code,
-        reason
+        reason: reason3
       });
       if (channels.close.hasSubscribers) {
         channels.close.publish({
           websocket: ws,
           code,
-          reason
+          reason: reason3
         });
       }
     }
@@ -21225,9 +21225,9 @@ var require_receiver = __commonJS({
     var { closeWebSocketConnection } = require_connection();
     var { PerMessageDeflate } = require_permessage_deflate();
     var { MessageSizeExceededError } = require_errors();
-    function failWebsocketConnectionWithCode(ws, code, reason) {
-      closeWebSocketConnection(ws, code, reason, Buffer.byteLength(reason));
-      failWebsocketConnection(ws, reason);
+    function failWebsocketConnectionWithCode(ws, code, reason3) {
+      closeWebSocketConnection(ws, code, reason3, Buffer.byteLength(reason3));
+      failWebsocketConnection(ws, reason3);
     }
     var ByteParser = class extends Writable {
       #buffers = [];
@@ -21497,16 +21497,16 @@ var require_receiver = __commonJS({
         if (code !== void 0 && !isValidStatusCode(code)) {
           return { code: 1002, reason: "Invalid status code", error: true };
         }
-        let reason = data.subarray(2);
-        if (reason[0] === 239 && reason[1] === 187 && reason[2] === 191) {
-          reason = reason.subarray(3);
+        let reason3 = data.subarray(2);
+        if (reason3[0] === 239 && reason3[1] === 187 && reason3[2] === 191) {
+          reason3 = reason3.subarray(3);
         }
         try {
-          reason = utf8Decode(reason);
+          reason3 = utf8Decode(reason3);
         } catch {
           return { code: 1007, reason: "Invalid UTF-8", error: true };
         }
-        return { code, reason, error: false };
+        return { code, reason: reason3, error: false };
       }
       /**
        * Parses control frames.
@@ -21521,9 +21521,9 @@ var require_receiver = __commonJS({
           }
           this.#info.closeInfo = this.parseCloseBody(body);
           if (this.#info.closeInfo.error) {
-            const { code, reason } = this.#info.closeInfo;
-            closeWebSocketConnection(this.ws, code, reason, reason.length);
-            failWebsocketConnection(this.ws, reason);
+            const { code, reason: reason3 } = this.#info.closeInfo;
+            closeWebSocketConnection(this.ws, code, reason3, reason3.length);
+            failWebsocketConnection(this.ws, reason3);
             return false;
           }
           if (this.ws[kSentClose] !== sentCloseFrameState.SENT) {
@@ -21760,14 +21760,14 @@ var require_websocket = __commonJS({
        * @param {number|undefined} code
        * @param {string|undefined} reason
        */
-      close(code = void 0, reason = void 0) {
+      close(code = void 0, reason3 = void 0) {
         webidl.brandCheck(this, _WebSocket);
         const prefix = "WebSocket.close";
         if (code !== void 0) {
           code = webidl.converters["unsigned short"](code, prefix, "code", { clamp: true });
         }
-        if (reason !== void 0) {
-          reason = webidl.converters.USVString(reason, prefix, "reason");
+        if (reason3 !== void 0) {
+          reason3 = webidl.converters.USVString(reason3, prefix, "reason");
         }
         if (code !== void 0) {
           if (code !== 1e3 && (code < 3e3 || code > 4999)) {
@@ -21775,8 +21775,8 @@ var require_websocket = __commonJS({
           }
         }
         let reasonByteLength = 0;
-        if (reason !== void 0) {
-          reasonByteLength = Buffer.byteLength(reason);
+        if (reason3 !== void 0) {
+          reasonByteLength = Buffer.byteLength(reason3);
           if (reasonByteLength > 123) {
             throw new DOMException(
               `Reason must be less than 123 bytes; received ${reasonByteLength}`,
@@ -21784,7 +21784,7 @@ var require_websocket = __commonJS({
             );
           }
         }
-        closeWebSocketConnection(this, code, reason, reasonByteLength);
+        closeWebSocketConnection(this, code, reason3, reasonByteLength);
       }
       /**
        * @see https://websockets.spec.whatwg.org/#dom-websocket-send
@@ -22749,13 +22749,11 @@ import { createHash, randomUUID } from "crypto";
 import { readFileSync } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-import { randomUUID as randomUUID3 } from "crypto";
-import { setTimeout as sleep2 } from "timers/promises";
 import { randomUUID as randomUUID2 } from "crypto";
+import { setTimeout as sleep2 } from "timers/promises";
 import { closeSync, existsSync as existsSync2, mkdirSync, openSync, readFileSync as readFileSync2, rmSync, statSync, writeFileSync } from "fs";
 import { homedir as homedir22 } from "os";
 import { join as join22 } from "path";
-import { execFileSync as execFileSync2 } from "child_process";
 async function proxy() {
   if (!PROXY_ENV.some((k) => process.env[k])) return void 0;
   return agent ??= new (await Promise.resolve().then(() => __toESM(require_undici(), 1))).EnvHttpProxyAgent();
@@ -23690,6 +23688,54 @@ function mcpInputSchema(s) {
   delete schema.$schema;
   return draft2020(schema);
 }
+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 });
+}
+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;
+}
 function sessionSlot(sessionId2) {
   const id22 = sessionId2 ?? sessionId();
   return `session:${id22.slice(0, 8)}`;
@@ -23815,12 +23861,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("&");
@@ -23831,13 +23871,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();
-}
 async function hatch(name, voice = null, opts = {}) {
   const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/hatch`, {
     method: "POST",
@@ -23949,96 +23982,64 @@ async function acceptTriage(proposalId, body, opts = {}) {
   if (!res.ok) throw new Error(`accept_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();
-}
-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;
+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();
 }
 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;
@@ -24046,12 +24047,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;
   }
 }
@@ -24062,6 +24063,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 ?? [];
+}
 function frame(line, topic, event, payload) {
   const ref = String(++line.ref);
   try {
@@ -24223,9 +24233,9 @@ async function subscribeWake(onNudge, opts = {}) {
   };
 }
 function withCodexEnv(text) {
-  const head = /^\[mcp_servers\.paigy\][ \t]*(?:#[^\n]*)?\r?\n/m.exec(text);
-  if (!head) return null;
-  const start = head.index + head[0].length;
+  const head2 = /^\[mcp_servers\.paigy\][ \t]*(?:#[^\n]*)?\r?\n/m.exec(text);
+  if (!head2) return null;
+  const start = head2.index + head2[0].length;
   const next = /^\[/m.exec(text.slice(start));
   const end = next ? start + next.index : text.length;
   const block2 = text.slice(start, end);
@@ -24244,7 +24254,7 @@ ${block2}`;
   }
   return text.slice(0, start) + updated + text.slice(end);
 }
-var import_undici, require2, CODEX_ENV, BACKEND_URL, NETWORK_MSG, PROXY_ENV, agent, INSTANCE_ID, WORKSPACE_ID, envSession, lineage, CLIENT, ignoreOverride, defaultOptions, getDefaultOptions, getRefs, getRelativePath, parseCatchDef, integerDateParser, isJsonSchema7AllOfType, emojiRegex2, zodPatterns, ALPHA_NUMERIC, primitiveMappings, asAnyOf, parseOptionalDef, parsePipelineDef, parseReadonlyDef, selectParser, get$ref, addMeta, zodToJsonSchema, OPTIONS_MIN, OPTIONS_MAX, OptionSchema, OptionInputSchema, NIGHT, AskInputSchema, StartContactSchema, ReceiveContactSchema, ContactSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, UpdateGoalSchema, UpdateGoalToolSchema, changedGoal, goalTitle, goalOutcome, CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange, read, GoalChangeSchema, editNames, ManageGoalsSchema, ManageGoalsToolSchema, MANAGE_GOALS_DESCRIPTION, ClaimGoalSchema, GetGoalSchema, GET_GOAL_DESCRIPTION, UPDATE_GOAL_DESCRIPTION, CLAIM_GOAL_DESCRIPTION, SearchToolSchema, SEARCH_DESCRIPTION, WhoIsWorkingSchema, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, BrainGoalChangeSchema, option, QuestionChangeSchema, lessonScope, LessonChangeSchema, BrainNextSchema, messageBase, BrainMessageSchema, BrainSearchSchema, BrainResultSchema, str, strs, CompactResultSchema, COMPACT_RESULT_JSON_SCHEMA, LIVE_MS, WORKING_MS, ContextSchema, ParticipantSchema, TransformSchema, VisualSchema, NotifyLevelSchema, SelectShapeSchema, ReceiptEventSchema, AttentionSchema, NotifyRequestFields, NotifyRequestSchema, NotifyStatusSchema, AgentStateSchema, TurnSchema, UserAnswerSchema, IntentSchema, RideAlongSchema, AwaitItemSchema, VoiceKeySchema, AgendaTurnSchema, CLAIM_STALE_MS, InboxItemSchema, APNS_TOKEN_RE, PushTokenSchema, MissedCallSchema, clock, QUIET, BrokerTuningSchema, UserSettingsSchema, HistoryWorkSchema, HistoryEntrySchema, HistoryPageSchema, ACTIVITY_LINES, ACTIVITY_LINE_MAX, AgentActivitySchema, ConnectionSummarySchema, LedgerItemSchema, AgentLedgerSchema, ReassignResultSchema, LessonStateSchema, LessonViewSchema, QueueQuestionSchema, QueueReplySchema, QueueItemSchema, QueueDeltaSchema, COLD_AFTER_MS, NoteSourceSchema, NoteStatusSchema, NoteRepeatSchema, DecisionSchema, NoteSchema, TriageItemSchema, TriageAssignmentSchema, TriageStatusSchema, SubmitTriageSchema, TriageProposalSchema, AcceptTriageSchema, AcceptTriageResultSchema, DeliveryModeSchema, WAKE_EVENT, wakeChannel, RegisterDeliverySchema, OAuthStartSchema, DeliveryConfigSchema, HostDecisionSchema, WakeNudgeSchema, PairingStatusSchema, DeviceCodeSchema, DeviceInfoSchema, DeviceTokenSchema, SupportRequestSchema, NotificationFeedbackKindSchema, SlimOptionSchema, QuestionRowSchema, WorkStateSchema, WorkRowSchema, ComputerRowSchema, AgentRowSchema, SnapshotSchema, CallRecapSchema, TOKEN_PATH, KEY_PATH, sleep, UnpairedError, RevokedError, ApiError, tokenOverride, authToken, AWAIT_WINDOW_MS, asked, NOT_SENT, DEMOTED, HEARTBEAT_MS, RETRY_MS, JOIN, JOIN_TIMEOUT_MS, lines;
+var import_undici, require2, CODEX_ENV, BACKEND_URL, NETWORK_MSG, PROXY_ENV, agent, INSTANCE_ID, WORKSPACE_ID, envSession, lineage, CLIENT, ignoreOverride, defaultOptions, getDefaultOptions, getRefs, getRelativePath, parseCatchDef, integerDateParser, isJsonSchema7AllOfType, emojiRegex2, zodPatterns, ALPHA_NUMERIC, primitiveMappings, asAnyOf, parseOptionalDef, parsePipelineDef, parseReadonlyDef, selectParser, get$ref, addMeta, zodToJsonSchema, OPTIONS_MIN, OPTIONS_MAX, OPTION_LABEL_MAX, OPTION_HINT_MAX, OptionSchema, OptionInputSchema, NIGHT, ASK_MAX, UNITS_MAX, UNIT_TITLE_MAX, UNIT_BODY_MAX, UnitInputSchema, questionHandle, NodeRef, BlockedAction, reason, actionFits, ACTION_FITS, userExplicitlyRequested, units, UpdateInputSchema, questionFields, refineQuestion, QuestionInputSchema, QuestionWireSchema, AnswerInputSchema, QuestionDependencySchema, sendFields, ContactSchema, sendsAnything, ContactWireSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, UpdateGoalSchema, changedGoal, goalTitle, GOAL_OUTCOME_MAX, goalOutcome, CreateChange, EditChange, StateChange, AssignChange, DeferChange, MoveChange, DependencyChange, read, GoalChangeSchema, editNames, ManageGoalsSchema, ManageGoalsToolSchema, MANAGE_GOALS_DESCRIPTION, GetGoalSchema, GET_GOAL_DESCRIPTION, SearchToolSchema, SEARCH_DESCRIPTION, CheckActivitySchema, FEEDBACK_TEXT_MAX, SendFeedbackSchema, SEND_FEEDBACK_DESCRIPTION, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, BrainGoalChangeSchema, option, QuestionChangeSchema, lessonScope, LessonChangeSchema, BrainNextSchema, messageBase, BrainMessageSchema, BrainSearchSchema, BrainResultSchema, str, strs, CompactResultSchema, COMPACT_RESULT_JSON_SCHEMA, str2, strs2, TalkerReplySchema, TALKER_REPLY_JSON_SCHEMA, str3, strs3, FilerReplySchema, FILER_REPLY_JSON_SCHEMA, ExplainerReplySchema, EXPLAINER_REPLY_JSON_SCHEMA, DISTILLER_DEFECTS, DistillerReplySchema, DISTILLER_REPLY_JSON_SCHEMA, TIDY_AUDIENCES, TidyReplySchema, TIDY_REPLY_JSON_SCHEMA, LIVE_MS, WORKING_MS, ContextSchema, ParticipantSchema, TransformSchema, VisualSchema, NotifyLevelSchema, SelectShapeSchema, ReceiptEventSchema, AttentionSchema, NotifyRequestFields, NotifyRequestSchema, NotifyStatusSchema, AgentStateSchema, TurnSchema, UserAnswerSchema, IntentSchema, RideAlongSchema, AwaitItemSchema, VoiceKeySchema, AgendaTurnSchema, CLAIM_STALE_MS, InboxItemSchema, APNS_TOKEN_RE, PushTokenSchema, MissedCallSchema, clock, QUIET, BrokerTuningSchema, UserSettingsSchema, HistoryWorkSchema, HistoryEntrySchema, HistoryPageSchema, ACTIVITY_LINES, ACTIVITY_LINE_MAX, AgentActivitySchema, ConnectionSummarySchema, LedgerItemSchema, AgentLedgerSchema, ReassignResultSchema, LessonStateSchema, LessonViewSchema, QueueQuestionSchema, QueueReplySchema, QueueItemSchema, QueueDeltaSchema, COLD_AFTER_MS, NoteSourceSchema, NoteStatusSchema, NoteRepeatSchema, DecisionSchema, NoteSchema, TriageItemSchema, TriageAssignmentSchema, TriageStatusSchema, SubmitTriageSchema, TriageProposalSchema, AcceptTriageSchema, AcceptTriageResultSchema, DeliveryModeSchema, WAKE_EVENT, wakeChannel, RegisterDeliverySchema, OAuthStartSchema, DeliveryConfigSchema, HostDecisionSchema, WakeNudgeSchema, PairingStatusSchema, DeviceCodeSchema, DeviceInfoSchema, DeviceTokenSchema, SupportRequestSchema, NotificationFeedbackKindSchema, SlimOptionSchema, QuestionRowSchema, WorkStateSchema, WorkRowSchema, ComputerRowSchema, AgentRowSchema, SnapshotSchema, CallRecapSchema, TOKEN_PATH, KEY_PATH, sleep, UnpairedError, RevokedError, ApiError, tokenOverride, authToken, AWAIT_WINDOW_MS, NOT_SENT, APPLIED, DEMOTED, HEARTBEAT_MS, RETRY_MS, JOIN, JOIN_TIMEOUT_MS, lines;
 var init_dist = __esm({
   "../../packages/sdk/dist/index.js"() {
     "use strict";
@@ -24256,6 +24266,10 @@ var init_dist = __esm({
     init_v3();
     init_zod();
     init_zod();
+    init_zod();
+    init_zod();
+    init_zod();
+    init_zod();
     import_undici = __toESM(require_undici(), 1);
     require2 = __sdkCreateRequire(import.meta.url);
     CODEX_ENV = ["CODEX_THREAD_ID", "CODEX_SESSION_ID", "CODEX_HOME", "PAIGY_TOKEN", "PAIGY_SESSION_ID", "PAIGY_HARNESS", "PAIGY_INSTANCE_ID", "PAIGY_ON_WAKE"];
@@ -24637,58 +24651,148 @@ var init_dist = __esm({
     };
     OPTIONS_MIN = 2;
     OPTIONS_MAX = 6;
+    OPTION_LABEL_MAX = 50;
+    OPTION_HINT_MAX = 200;
     OptionSchema = external_exports.object({
       id: external_exports.string(),
       label: external_exports.string(),
-      hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+      hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
       // .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()
     });
-    OptionInputSchema = OptionSchema.omit({ id: true }).extend({
-      label: external_exports.string().trim().min(1).max(1e3)
+    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.`
+      ),
+      // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+      // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+      label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX} characters, standing on its own.`),
+      hint: external_exports.string().max(OPTION_HINT_MAX, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
+      htmlPreview: OptionSchema.shape.html,
+      imgUrl: OptionSchema.shape.image
     }).strict();
     NIGHT = { from: 23, to: 7 };
-    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."
+    ASK_MAX = 250;
+    UNITS_MAX = 12;
+    UNIT_TITLE_MAX = 50;
+    UNIT_BODY_MAX = 200;
+    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();
+    questionHandle = external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/, "a question id, whole or its first eight characters");
+    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.");
+    BlockedAction = external_exports.enum(["start", "complete", "answer"]).describe("What waits: starting or completing a Goal, or answering a Question.");
+    reason = external_exports.string().trim().min(1).max(500).describe("Why, as an explanation, never as policy.");
+    actionFits = (b) => b.blocked.type === "goal" === (b.action !== "answer");
+    ACTION_FITS = "a goal is blocked from start or complete; a question from answer";
+    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.`
+    );
+    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.`
+    );
+    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));
+    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, at most 50 characters; a hint, at most 200."),
       // 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();
-    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();
-    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
+    };
+    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" });
+      }
+    };
+    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);
+    QuestionWireSchema = external_exports.object({ questionId: external_exports.string().uuid(), ...questionFields }).strict().superRefine(refineQuestion);
+    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));
+    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);
+    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."
+      )
+    };
+    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();
-    ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict(), ReceiveContactSchema]);
+    sendsAnything = (c) => !!(c.updates?.length || c.questions?.length || c.answers?.length || c.withdrawQuestionIds?.length || c.questionDependencies?.length);
+    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");
     CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-    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`).";
+    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\`).`;
     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
@@ -24722,29 +24826,20 @@ var init_dist = __esm({
         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();
-    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();
     changedGoal = external_exports.string().uuid().describe("The Goal to change, as a read shows it.");
     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.");
-    goalOutcome = external_exports.string().trim().min(1).max(1e4).describe("The full desired result. There is no third description field.");
+    GOAL_OUTCOME_MAX = 500;
+    goalOutcome = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
     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();
@@ -24754,7 +24849,7 @@ var init_dist = __esm({
     ) }).strict();
     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();
     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();
     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."
@@ -24765,7 +24860,7 @@ var init_dist = __esm({
       goalId: changedGoal,
       dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
       action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-      reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+      reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
     }).strict();
     read = { revision: external_exports.number().int().positive().optional() };
     GoalChangeSchema = external_exports.discriminatedUnion("kind", [
@@ -24789,8 +24884,7 @@ var init_dist = __esm({
     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));
-    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.";
-    ClaimGoalSchema = external_exports.object({ goalId: external_exports.string().uuid().optional() }).strict();
+    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 (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); 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.";
     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
@@ -24801,25 +24895,29 @@ var init_dist = __esm({
        *  between two of them named. Off by default; `docs/model/goal/diagnose-design.md`. */
       diagnose: external_exports.boolean().optional()
     }).strict();
-    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.";
-    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.";
-    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).";
+    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.";
     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(),
       goalId: external_exports.string().uuid().optional(),
       limit: external_exports.number().int().min(1).max(20).optional()
     }).strict();
-    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.";
-    WhoIsWorkingSchema = external_exports.object({}).strict();
+    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 replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, 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, the replies to its items, 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 (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, 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.";
+    CheckActivitySchema = external_exports.object({}).strict();
+    FEEDBACK_TEXT_MAX = 5e4;
+    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();
+    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.";
     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) }
     ];
     AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
     id = external_exports.string().uuid();
@@ -24867,6 +24965,7 @@ var init_dist = __esm({
       external_exports.object({
         kind: external_exports.literal("create"),
         text: external_exports.string().min(1),
+        summary: external_exports.string().optional(),
         answererId: participant,
         goal: ResultRefSchema.optional(),
         blocks: external_exports.array(external_exports.object({ question: ResultRefSchema }).strict()),
@@ -24917,12 +25016,12 @@ var init_dist = __esm({
     }).strict();
     BrainResultSchema = external_exports.object({
       messages: external_exports.array(BrainMessageSchema),
-      entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema) }).strict()),
+      entries: external_exports.array(external_exports.object({ key, sources: external_exports.array(SourceSchema).min(1), goals: external_exports.array(ResultRefSchema), summary: external_exports.string().optional() }).strict()),
       questions: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: QuestionChangeSchema }).strict()),
       answers: external_exports.array(external_exports.object({
         question: ResultRefSchema,
         entryKeys: external_exports.array(key).min(1),
-        summary: external_exports.string().min(1),
+        summary: external_exports.string(),
         selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
       }).strict()),
       goals: external_exports.array(external_exports.object({ key, entryKeys: external_exports.array(key), change: BrainGoalChangeSchema }).strict()),
@@ -24958,13 +25057,133 @@ var init_dist = __esm({
     COMPACT_RESULT_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
       zodToJsonSchema(CompactResultSchema, { $refStrategy: "none" })
     );
+    str2 = external_exports.string();
+    strs2 = external_exports.array(external_exports.string());
+    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"]),
+      /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+       *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+       *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+       *  end of this call), a question's handle (that question's answer) or an ISO time. */
+      replies: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2, summary: str2, defer: str2 }).strict()),
+      /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
+      instruction: strs2,
+      /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+       *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
+      file: strs2,
+      /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
+      need: 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();
+    TALKER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(TalkerReplySchema, { $refStrategy: "none" })
+    );
+    str3 = external_exports.string();
+    strs3 = external_exports.array(external_exports.string());
+    FilerReplySchema = external_exports.object({
+      /** Which Goals each new line goes on: a line's handle, Goal handles (or keys of new Goals), and what
+       *  the line says in at most ten words. */
+      filed: external_exports.array(external_exports.object({ line: str3, goals: strs3, summary: str3 }).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,
+        summary: 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();
+    FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(FilerReplySchema, { $refStrategy: "none" })
+    );
+    ExplainerReplySchema = external_exports.object({
+      /** The explanation, as sentences, spoken in order. */
+      say: external_exports.array(external_exports.string()),
+      /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+      followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+    }).strict();
+    EXPLAINER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(ExplainerReplySchema, { $refStrategy: "none" })
+    );
+    DISTILLER_DEFECTS = [
+      "reasked",
+      // a question put to the person again after they answered it
+      "unsupported",
+      // a fact stated that nothing in the input supports
+      "unsaid",
+      // an agent's answer arrived during the call and was never said
+      "skipped",
+      // an agenda item never put to the person
+      "unsaved",
+      // something the person answered or asked for did not save, was refused or dropped
+      "ignored",
+      // the person asked or said something and was never answered (the critic's ignored_a_question)
+      "promised"
+      // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+    ];
+    DistillerReplySchema = external_exports.object({
+      defects: external_exports.array(external_exports.object({
+        kind: external_exports.enum(DISTILLER_DEFECTS),
+        /** The handles of the lines it shows in. */
+        lines: external_exports.array(external_exports.string()),
+        /** The handle of the record it concerns, or "". */
+        about: external_exports.string(),
+        /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+        why: external_exports.string()
+      }).strict())
+    }).strict();
+    DISTILLER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(DistillerReplySchema, { $refStrategy: "none" })
+    );
+    TIDY_AUDIENCES = ["talker", "filer", "agents"];
+    TidyReplySchema = external_exports.object({
+      lessons: external_exports.array(external_exports.object({
+        lesson: external_exports.string(),
+        op: external_exports.enum(["keep", "revise", "withdraw"]),
+        text: external_exports.string(),
+        for: external_exports.enum([...TIDY_AUDIENCES, ""]),
+        into: external_exports.string()
+      }).strict())
+    }).strict();
+    TIDY_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(TidyReplySchema, { $refStrategy: "none" })
+    );
     LIVE_MS = 3 * 6e4;
     WORKING_MS = 60 * 6e4;
     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()
     });
     ParticipantSchema = external_exports.object({
       kind: external_exports.enum(["human", "agent"]),
@@ -25039,7 +25258,7 @@ var init_dist = __esm({
        *  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(
@@ -25637,7 +25856,7 @@ var init_dist = __esm({
        *  desktop app while open. Null = never seen; stale = offline. */
       lastSeenAt: external_exports.string().datetime().nullable().optional(),
       /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-       *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+       *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
        *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
       lastWorkedAt: external_exports.string().datetime().nullable().optional(),
       /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -25800,8 +26019,8 @@ var init_dist = __esm({
       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
@@ -25835,7 +26054,7 @@ var init_dist = __esm({
        *
        *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
        *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-       *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+       *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
        *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
        *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
       rev: external_exports.string().optional()
@@ -25959,7 +26178,7 @@ var init_dist = __esm({
       /** 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(),
@@ -26152,14 +26371,13 @@ var init_dist = __esm({
         owner: external_exports.string(),
         state: external_exports.string(),
         questions: external_exports.array(external_exports.object({ id: external_exports.string().uuid(), state: external_exports.string(), title: external_exports.string() })),
-        /** `words` is always what they SAID, verbatim — the record, never replaced. `headline` is
-         *  their answer on one line when the call's read wrote one (owner, 2026-10-01: "render them
-         *  summarized like a pre-made option is"), so the row scans like a chosen option and their
-         *  own words stay under it. Absent on every line stored before the read wrote them, and on
-         *  anything that is not an answer. */
+        /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+         *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+         *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+         *  neither wrote one. */
         /** `about` is the request the line answered (its question), null for words that answered none —
          *  the key the screen groups on, so one question is one row however many times it was answered. */
-        lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+        lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
       })),
       unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), words: external_exports.string(), atMs: external_exports.number() })),
       more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
@@ -26198,8 +26416,9 @@ var init_dist = __esm({
     tokenOverride = null;
     authToken = (explicit) => explicit ?? tokenOverride ?? readToken();
     AWAIT_WINDOW_MS = 45e3;
-    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.";
-    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.";
+    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.`;
+    APPLIED = "Applied; nothing was sent to the person.";
+    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.";
     HEARTBEAT_MS = 25e3;
     RETRY_MS = [1e3, 2e3, 5e3, 1e4, 3e4];
     JOIN = { config: { broadcast: { self: false } } };
@@ -27102,14 +27321,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);
     };
   }
 });
@@ -27611,13 +27830,13 @@ var require_segments = __commonJS({
     var Regex = require_regex();
     var Utils = require_utils2();
     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,
@@ -30451,13 +30670,13 @@ var require_svg_tag = __commonJS({
     var Utils = require_utils3();
     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 = "";
@@ -30989,9 +31208,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:"
   ];
@@ -31002,10 +31221,10 @@ function refusal(options, asked2) {
   lines2.push("", "Then re-run:  paigy-harness triage [--via ollama|claude|codex|agy]");
   return lines2.join("\n");
 }
-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 {
@@ -31026,9 +31245,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,
@@ -31462,7 +31681,7 @@ function onEnter(input, onLine) {
 // src/cli.ts
 init_dist();
 var import_qrcode = __toESM(require_lib(), 1);
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 import { hostname } from "os";
 import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { execFile as execFile2, execSync } from "child_process";
@@ -31471,7 +31690,7 @@ import { join as join11 } from "path";
 
 // src/run.ts
 init_dist();
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 
 // src/harness/session.ts
 init_dist();
@@ -31759,7 +31978,7 @@ init_catalog();
 import { mkdirSync as mkdirSync2, readdirSync, renameSync, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir3 } 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) {
@@ -31819,7 +32038,7 @@ function inboxFor(root = INBOX_ROOT) {
   } catch (error) {
     if (!missing(error)) throw error;
   }
-  return openInbox(join4(root, `${process.pid}-${randomUUID4().slice(0, 8)}`));
+  return openInbox(join4(root, `${process.pid}-${randomUUID3().slice(0, 8)}`));
 }
 
 // src/harness/session.ts
@@ -33252,23 +33471,37 @@ var zodToJsonSchema2 = (schema, options) => {
 // ../../packages/schema/dist/index.js
 init_zod();
 init_zod();
+init_zod();
+init_zod();
+init_zod();
+init_zod();
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
+var OPTION_LABEL_MAX2 = 50;
+var OPTION_HINT_MAX2 = 200;
 var OptionSchema2 = external_exports.object({
   id: external_exports.string(),
   label: external_exports.string(),
-  hint: external_exports.string().max(500).describe("Optional short projection of consequence or action if this option is chosen (e.g. 'Reruns test suite', 'Merges to main').").optional(),
+  hint: external_exports.string().max(500).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
   // .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.`
+  ),
+  // SHORT CHOICES (owner, 2026-10-07: "options label should be maybe max 50 characters and the hint 200"):
+  // a label is one choice the person reads, or hears on a call; a hint says its consequence in a line.
+  label: external_exports.string().trim().min(1).max(OPTION_LABEL_MAX2, `option_label_too_long: an option's label is at most ${OPTION_LABEL_MAX2} characters; say the choice, and put its consequence in the hint.`).describe(`The choice, at most ${OPTION_LABEL_MAX2} characters, standing on its own.`),
+  hint: external_exports.string().max(OPTION_HINT_MAX2, `option_hint_too_long: an option's hint is at most ${OPTION_HINT_MAX2} characters.`).describe(`Optional: what choosing it does, at most ${OPTION_HINT_MAX2} characters (e.g. 'Reruns test suite', 'Merges to main').`).optional(),
+  htmlPreview: OptionSchema2.shape.html,
+  imgUrl: OptionSchema2.shape.image
 }).strict();
 var NIGHT2 = { from: 23, to: 7 };
 function draft20202(node) {
@@ -33300,41 +33533,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, at most 50 characters; a hint, at most 200."),
   // 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
@@ -33368,29 +33722,20 @@ 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.");
+var GOAL_OUTCOME_MAX2 = 500;
+var goalOutcome2 = external_exports.string().trim().min(1).max(GOAL_OUTCOME_MAX2, `outcome_too_long: a Goal's outcome is one paragraph, at most ${GOAL_OUTCOME_MAX2} characters; split the rest into child Goals (create with parentGoalId).`).describe(`The desired result, one paragraph of at most ${GOAL_OUTCOME_MAX2} characters. More than that is more work: create child Goals under it (parentGoalId). There is no third description field.`);
 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();
@@ -33400,7 +33745,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."
@@ -33411,7 +33756,7 @@ var DependencyChange2 = external_exports.object({
   goalId: changedGoal2,
   dependsOnGoalId: external_exports.string().uuid().describe("The Goal it waits on."),
   action: external_exports.enum(["start", "complete"]).describe("What waits: starting goalId, or completing it."),
-  reason: external_exports.string().trim().min(1).max(2e3).optional().describe("Why, as an explanation, never as policy.")
+  reason: external_exports.string().trim().min(1).max(250).optional().describe("Why, at most 250 characters, as an explanation, never as policy.")
 }).strict();
 var read2 = { revision: external_exports.number().int().positive().optional() };
 var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
@@ -33435,8 +33780,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 (an outcome is one paragraph, at most 500 characters: split more into child Goals with parentGoalId); 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
@@ -33447,25 +33791,29 @@ 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(),
   goalId: external_exports.string().uuid().optional(),
   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 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 replies -- the person's answers, acknowledgements and deferrals (type answer; found by their summary, by the question or report they reply to, 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, the replies to its items, 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 (a reply carries its kind -- answered, acknowledged or deferred -- whether it is closed (a deferral is not), its summary in under ten words, its question or report, 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 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();
@@ -33513,6 +33861,7 @@ var QuestionChangeSchema2 = external_exports.union([
   external_exports.object({
     kind: external_exports.literal("create"),
     text: external_exports.string().min(1),
+    summary: external_exports.string().optional(),
     answererId: participant2,
     goal: ResultRefSchema2.optional(),
     blocks: external_exports.array(external_exports.object({ question: ResultRefSchema2 }).strict()),
@@ -33563,12 +33912,12 @@ var BrainSearchSchema2 = external_exports.object({
 }).strict();
 var BrainResultSchema2 = external_exports.object({
   messages: external_exports.array(BrainMessageSchema2),
-  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2) }).strict()),
+  entries: external_exports.array(external_exports.object({ key: key2, sources: external_exports.array(SourceSchema2).min(1), goals: external_exports.array(ResultRefSchema2), summary: external_exports.string().optional() }).strict()),
   questions: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: QuestionChangeSchema2 }).strict()),
   answers: external_exports.array(external_exports.object({
     question: ResultRefSchema2,
     entryKeys: external_exports.array(key2).min(1),
-    summary: external_exports.string().min(1),
+    summary: external_exports.string(),
     selectedOptionIds: external_exports.array(external_exports.string().min(1)).optional()
   }).strict()),
   goals: external_exports.array(external_exports.object({ key: key2, entryKeys: external_exports.array(key2), change: BrainGoalChangeSchema2 }).strict()),
@@ -33577,33 +33926,150 @@ 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"]),
+  /** The person's replies to items (replies, owner 2026-10-07): the item's handle, the chosen option
+   *  IDs, the line handles, how they replied in under ten words (keeping any condition), and `defer`:
+   *  "" when their words settle the item, else what a reply that puts it off waits for -- "call" (the
+   *  end of this call), a question's handle (that question's answer) or an ISO time. */
+  replies: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22, summary: str22, defer: str22 }).strict()),
+  /** The line handles that tell the talker how to run this call; they last until it ends and reach no agent. */
+  instruction: strs22,
+  /** The line handles the filer acts on, and the only ones it reads (3e): new work, a change to existing
+   *  work, feedback on Paigy, anything said to an agent, and any rule meant to outlast the call. */
+  file: 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, Goal handles (or keys of new Goals), and what
+   *  the line says in at most ten words. */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32, summary: str32 }).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,
+    summary: 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" })
+);
+var ExplainerReplySchema2 = external_exports.object({
+  /** The explanation, as sentences, spoken in order. */
+  say: external_exports.array(external_exports.string()),
+  /** Questions to an agent about gaps in what it read: the agent's handle and the question. */
+  followUps: external_exports.array(external_exports.object({ to: external_exports.string(), text: external_exports.string() }).strict())
+}).strict();
+var EXPLAINER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(ExplainerReplySchema2, { $refStrategy: "none" })
+);
+var DISTILLER_DEFECTS2 = [
+  "reasked",
+  // a question put to the person again after they answered it
+  "unsupported",
+  // a fact stated that nothing in the input supports
+  "unsaid",
+  // an agent's answer arrived during the call and was never said
+  "skipped",
+  // an agenda item never put to the person
+  "unsaved",
+  // something the person answered or asked for did not save, was refused or dropped
+  "ignored",
+  // the person asked or said something and was never answered (the critic's ignored_a_question)
+  "promised"
+  // said it did or would do something, and nothing shows it done (the critic's broken_promise)
+];
+var DistillerReplySchema2 = external_exports.object({
+  defects: external_exports.array(external_exports.object({
+    kind: external_exports.enum(DISTILLER_DEFECTS2),
+    /** The handles of the lines it shows in. */
+    lines: external_exports.array(external_exports.string()),
+    /** The handle of the record it concerns, or "". */
+    about: external_exports.string(),
+    /** One plain sentence, in words, never handles: it is what the feedback row keeps. */
+    why: external_exports.string()
+  }).strict())
+}).strict();
+var DISTILLER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(DistillerReplySchema2, { $refStrategy: "none" })
+);
+var TIDY_AUDIENCES2 = ["talker", "filer", "agents"];
+var TidyReplySchema2 = external_exports.object({
+  lessons: external_exports.array(external_exports.object({
+    lesson: external_exports.string(),
+    op: external_exports.enum(["keep", "revise", "withdraw"]),
+    text: external_exports.string(),
+    for: external_exports.enum([...TIDY_AUDIENCES2, ""]),
+    into: external_exports.string()
+  }).strict())
+}).strict();
+var TIDY_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TidyReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -33627,7 +34093,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"]),
@@ -33702,7 +34171,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(
@@ -34300,7 +34769,7 @@ var ConnectionSummarySchema2 = external_exports.object({
    *  desktop app while open. Null = never seen; stale = offline. */
   lastSeenAt: external_exports.string().datetime().nullable().optional(),
   /** WORKING, NOT JUST CONNECTED (owner, 2026-09-30): the last time the agent itself acted on one of
-   *  its Goals — took its lease or recorded an operation (`tokens.last_worked_at`). Within
+   *  its Goals — wrote on one or recorded an operation (`tokens.last_worked_at`). Within
    *  `WORKING_MS` it is working; otherwise it is connected but idle. Null = not seen working yet. */
   lastWorkedAt: external_exports.string().datetime().nullable().optional(),
   /** The oldest of its Goals that is `ready` for it — work handed to it that nobody has started.
@@ -34463,8 +34932,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
@@ -34498,7 +34967,7 @@ var QueueItemSchema2 = external_exports.object({
    *
    *  IT IS THE PAYLOAD'S OWN HASH, NEVER A STAMP ON THE WORK. Nothing here reasons about which
    *  writes change which field — the comparison is over the bytes the phone is holding, so a fact
-   *  the row shows that no `updated_at` moves for (a lease lapsing, a dependency's state, a
+   *  the row shows that no `updated_at` moves for (`active` lapsing, a dependency's state, a
    *  sibling appearing in `childGoalIds`) cannot go unnoticed. Optional because a hand-built
    *  queue (a fixture, the demo) spells none, and a row with no rev is simply always re-sent. */
   rev: external_exports.string().optional()
@@ -34620,7 +35089,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(),
@@ -34813,14 +35282,13 @@ var CallRecapSchema2 = external_exports.object({
     owner: external_exports.string(),
     state: external_exports.string(),
     questions: external_exports.array(external_exports.object({ id: external_exports.string().uuid(), state: external_exports.string(), title: external_exports.string() })),
-    /** `words` is always what they SAID, verbatim — the record, never replaced. `headline` is
-     *  their answer on one line when the call's read wrote one (owner, 2026-10-01: "render them
-     *  summarized like a pre-made option is"), so the row scans like a chosen option and their
-     *  own words stay under it. Absent on every line stored before the read wrote them, and on
-     *  anything that is not an answer. */
+    /** `words` is always what they SAID, verbatim — the record, never replaced. `summary` is what
+     *  the line says in ten words (owner, 2026-10-07): the filer's, or the talker's for the answer it
+     *  gave, so the row scans like a chosen option and their own words stay under it. Absent when
+     *  neither wrote one. */
     /** `about` is the request the line answered (its question), null for words that answered none —
      *  the key the screen groups on, so one question is one row however many times it was answered. */
-    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), headline: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
+    lines: external_exports.array(external_exports.object({ entryId: external_exports.string().uuid(), words: external_exports.string(), summary: external_exports.string().optional(), about: external_exports.string().nullable().optional() }))
   })),
   unfiled: external_exports.array(external_exports.object({ lineId: external_exports.string().uuid(), words: external_exports.string(), atMs: external_exports.number() })),
   more: external_exports.object({ lines: external_exports.number(), entries: external_exports.number(), topics: external_exports.number() })
@@ -34849,6 +35317,32 @@ function sameTail(a, b) {
 // src/paigy/bridge.ts
 init_dist();
 
+// src/paigy/cut.ts
+function cut(text, title = "Details") {
+  const all = text.trim();
+  if (all.length <= ASK_MAX2) return { main: all };
+  const main2 = head(all, ASK_MAX2);
+  const units3 = [];
+  let rest = all.slice(main2.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: main2.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",
@@ -34977,10 +35471,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);
@@ -35009,13 +35512,18 @@ function decisionFrom(result) {
 }
 async function ask(state, rail, input) {
   if (!state.goal) return null;
+  const { main: main2, 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: main2,
+        ...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);
@@ -35033,57 +35541,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: main2, units: units3 } = cut(report);
+  const say = (goalId) => rail.contact({ updates: [{ message: main2, ...units3 ? { units: units3 } : {}, goalIds: [goalId] }] });
+  const own = async () => (await rail.create({ title: "Agent cannot work", outcome: main2 })).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: main2, units: units3 } = cut(text);
+  const goalId = state.goal?.id ?? (await rail.create({ title: "Usage limit reset", outcome: main2 })).goalId;
+  return rail.contact({ updates: [{ message: main2, ...units3 ? { units: units3 } : {}, goalIds: [goalId], userExplicitlyRequested: "call" }] });
+}
 function conversationFull(result) {
   return /prompt is too long/i.test(result ?? "");
 }
@@ -35110,14 +35615,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() {
@@ -35217,18 +35722,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);
@@ -35253,7 +35763,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() ?? "";
@@ -35283,7 +35793,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, log);
+  for (const h of heard) {
+    const events = listed.get(h.goalId);
+    if (events) await acknowledge2(h.goalId, h.brief, events, state, rail, log);
+  }
 }
 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.";
@@ -35329,15 +35842,16 @@ function settle(session, state, inbox, log) {
   send2(session, state, [...seen.length ? [SEEN_MID_TURN, ...seen.map((b) => b.words)] : [], ...unseen.map((b) => b.words)].join("\n\n"));
   log?.(`\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, log) {
+async function acknowledge2(goalId, brief, events, state, rail, log) {
+  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) log?.(`\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) {
     log?.(`\u26A0 could not acknowledge ${goalId.slice(0, 8)}: ${error.message} \u2014 its words are typed in; it stays listed until acknowledged`);
   }
@@ -35363,13 +35877,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"));
@@ -35391,7 +35905,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);
@@ -35479,7 +35993,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") {
@@ -35493,7 +36007,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") {
@@ -35675,7 +36189,7 @@ function listRepos(deps) {
 
 // src/holder.ts
 init_dist();
-import { execFileSync as execFileSync3 } from "child_process";
+import { execFileSync as execFileSync2 } from "child_process";
 import { readFileSync as readFileSync5, readdirSync as readdirSync3 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join7 } from "path";
@@ -35690,7 +36204,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;
   }
@@ -35745,7 +36259,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 {
@@ -35869,7 +36383,7 @@ function ownerSession(slot, deps = {}) {
   const prefix = m[1];
   const root = deps.projectsDir ?? join8(homedir8(), ".claude", "projects");
   const list = deps.list ?? ((dir) => readdirSync4(dir));
-  const head = deps.head ?? readHead;
+  const head2 = deps.head ?? readHead;
   let folders;
   try {
     folders = list(root);
@@ -35887,7 +36401,7 @@ function ownerSession(slot, deps = {}) {
     if (!file) continue;
     let text;
     try {
-      text = head(join8(root, folder, file));
+      text = head2(join8(root, folder, file));
     } catch {
       continue;
     }
@@ -36829,7 +37343,7 @@ async function main() {
   let launched;
   if (parsed.launch) {
     overrideToken(readSlot("Desktop") || null);
-    const session = randomUUID6();
+    const session = randomUUID5();
     const minted = await hatch(parsed.launch, parsed.voice ?? null, {
       reach: reachAs(session),
       brief: parsed.prompt,