@paigy/harness 0.3.34 → 0.3.36

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)}`;
@@ -23805,39 +23851,26 @@ function overrideToken(secret) {
 async function fail(what, res) {
   throw new ApiError(what, res.status, await res.text());
 }
-async function createGoal(input, opts = {}) {
+async function manageGoals(input, opts = {}) {
   const token = authToken(opts.token) ?? "";
-  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals`, {
+  const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/manage`, {
     method: "POST",
-    headers: { "content-type": "application/json", authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" },
+    headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
     body: JSON.stringify(input)
   }));
-  if (!res.ok) await fail("create_goal", 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}`, "x-paigy-model": "goal-entry-v1" }, body: JSON.stringify(goalId ? { goalId } : {}) }));
-  if (!res.ok) await fail("claim_goal", res);
+  if (!res.ok) await fail("manage_goals", res);
   return await res.json();
 }
-async function getGoal(goalId, opts = {}, read = {}) {
+async function getGoal(goalId, opts = {}, read3 = {}) {
   const token = authToken(opts.token) ?? "";
-  const query = [read.history ? "history=1" : "", read.diagnose ? "diagnose=1" : ""].filter(Boolean).join("&");
+  const query = [read3.history ? "history=1" : "", read3.diagnose ? "diagnose=1" : ""].filter(Boolean).join("&");
   const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/goals/${encodeURIComponent(goalId)}${query ? `?${query}` : ""}`, {
     method: "GET",
-    headers: { authorization: `Bearer ${token}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${token}` }
   }));
   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}`, "x-paigy-model": "goal-entry-v1" }, 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",
@@ -23926,7 +23959,7 @@ async function listNotes(opts = {}) {
 }
 async function listConnections(opts = {}) {
   const res = await ensureAuthed(await reach(`${BACKEND_URL}/api/tokens`, {
-    headers: { authorization: `Bearer ${authToken(opts.token)}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
   }));
   if (!res.ok) throw new Error(`list_connections failed: ${res.status} ${await res.text()}`);
   return await res.json();
@@ -23949,118 +23982,96 @@ 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 (!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) ?? ""}`, "x-paigy-model": "goal-entry-v1" };
-  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 read = 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 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 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 read(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;
   try {
     while (true) {
       signal.throwIfAborted();
-      latest = await read(signal);
-      if (settled(latest)) return latest;
+      latest = await read3(signal);
+      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;
   }
 }
-async function checkReplies(opts = {}) {
+async function receive(opts = {}) {
   const res = await ensureAuthed(await (opts.reach ?? reach)(`${BACKEND_URL}/api/deliveries`, {
-    headers: { authorization: `Bearer ${authToken(opts.token) ?? ""}`, "x-paigy-model": "goal-entry-v1" }
+    headers: { authorization: `Bearer ${authToken(opts.token) ?? ""}` }
   }));
-  if (!res.ok) await fail("check_replies", res);
+  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 {
@@ -24222,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);
@@ -24243,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, ContactSchema, CONTACT_SCHEMA, CONTACT_DESCRIPTION, CreateGoalSchema, CreateGoalToolSchema, CREATE_GOAL_DESCRIPTION, UpdateGoalSchema, UpdateGoalToolSchema, ClaimGoalSchema, GetGoalSchema, GET_GOAL_DESCRIPTION, UPDATE_GOAL_DESCRIPTION, CLAIM_GOAL_DESCRIPTION, CHECK_REPLIES_DESCRIPTION, CheckRepliesSchema, AGENT_TOOLS, AGENT_TOOL_NAMES, id, key, participant, SourceSchema, ResultRefSchema, NodeRefSchema, DependencySchema, goalState, existingGoalChanges, GoalChangeSchema, 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, 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, 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, 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";
@@ -24255,6 +24266,8 @@ var init_dist = __esm({
     init_v3();
     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"];
@@ -24643,43 +24656,137 @@ var init_dist = __esm({
       // .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.`
+      ),
+      label: external_exports.string().trim().min(1).max(1e3),
+      hint: OptionSchema.shape.hint,
+      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."),
       // 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.'
+      ),
+      // 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."
       ),
-      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."
+      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 (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();
-    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();
-    ContactSchema = external_exports.union([StartContactSchema, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
+    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 durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. 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, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; Where your work stands while under way is progress: report it with update_goal, not contact. 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, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+    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
@@ -24699,10 +24806,6 @@ var init_dist = __esm({
        *  repo name. Delegated work inherits this from its parent Goal when omitted. */
       repo: external_exports.string().trim().min(1).max(200).optional()
     });
-    CreateGoalToolSchema = CreateGoalSchema.extend({
-      idempotencyKey: CreateGoalSchema.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
-    }).strict();
-    CREATE_GOAL_DESCRIPTION = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass repo to anchor the work to a specific repository ("owner/repo" or repo name); delegated children inherit it. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
     UpdateGoalSchema = external_exports.object({
       revision: external_exports.number().int().positive(),
       changes: external_exports.object({
@@ -24717,17 +24820,64 @@ 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 = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: external_exports.string().uuid() }).strict();
-    ClaimGoalSchema = external_exports.object({ goalId: external_exports.string().uuid().optional() }).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.");
+    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 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();
+    EditChange = external_exports.object({ kind: external_exports.literal("edit"), goalId: changedGoal, title: goalTitle.optional(), outcome: goalOutcome.optional() }).strict();
+    StateChange = external_exports.object({ kind: external_exports.literal("state"), goalId: changedGoal, state: external_exports.enum(["open", "completed", "canceled"]).describe(
+      "completed: the Goal's own work is done now (refused while required children are open); open: reopen it; canceled: it will not be done."
+    ) }).strict();
+    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: 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."
+    ) }).strict();
+    DependencyChange = external_exports.object({
+      kind: external_exports.literal("dependency"),
+      change: external_exports.enum(["add", "remove"]),
+      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.")
+    }).strict();
+    read = { revision: external_exports.number().int().positive().optional() };
+    GoalChangeSchema = external_exports.discriminatedUnion("kind", [
+      CreateChange,
+      EditChange.extend(read),
+      StateChange.extend(read),
+      AssignChange.extend(read),
+      DeferChange.extend(read),
+      MoveChange.extend(read),
+      DependencyChange
+    ]);
+    editNames = (changes, ctx) => changes.forEach((c, i) => {
+      if (c.kind === "edit" && c.title === void 0 && c.outcome === void 0) {
+        ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["changes", i], message: "an edit supplies title, outcome, or both" });
+      }
+    });
+    ManageGoalsSchema = external_exports.object({
+      requestId: external_exports.string().uuid().optional(),
+      changes: external_exports.array(GoalChangeSchema).min(1).max(50)
+    }).strict().superRefine((v, ctx) => editNames(v.changes, ctx));
+    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_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
     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
@@ -24738,19 +24888,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 = `Update a Goal you are on at an exact revision. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
-    CLAIM_GOAL_DESCRIPTION = "Claim a pending answer to your question or the oldest runnable or review-pending Goal you own. Pass goalId to join any Goal of your person; its assignment stays unchanged. Read others before overlapping another agent\u2019s work. Joining lets you contribute and change its state; use update_goal with ownerParticipant when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
-    CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
-    CheckRepliesSchema = external_exports.object({}).strict();
+    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.";
+    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(CheckRepliesSchema) },
       { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
-      { name: "check_replies", description: CHECK_REPLIES_DESCRIPTION, inputSchema: mcpInputSchema(CheckRepliesSchema) },
-      { name: "create_goal", description: CREATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(CreateGoalToolSchema) },
-      { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(ClaimGoalSchema) },
+      { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION, inputSchema: mcpInputSchema(ManageGoalsToolSchema) },
       { 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: "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();
@@ -24781,17 +24941,6 @@ var init_dist = __esm({
         reason: external_exports.string().max(500).optional()
       }).strict()
     ];
-    GoalChangeSchema = external_exports.union([
-      external_exports.object({
-        kind: external_exports.literal("create"),
-        title: external_exports.string().min(1).max(120),
-        outcome: external_exports.string().min(1),
-        ownerId: participant,
-        parentGoalId: id.optional(),
-        sourceEntryIds: external_exports.array(id)
-      }).strict(),
-      ...existingGoalChanges
-    ]);
     BrainGoalChangeSchema = external_exports.union([
       // newSession: Paigy starts a session to own it (owner, 2026-10-06); until it has, the person owns it.
       external_exports.object({
@@ -24900,13 +25049,76 @@ 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"]),
+      /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
+      answers: external_exports.array(external_exports.object({ item: str2, options: strs2, lines: strs2 }).strict()),
+      /** The line handles that hold a new instruction from the person. */
+      instruction: strs2,
+      /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
+       *  reads only these (3e). */
+      file: strs2,
+      /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
+      need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str2 }).strict(),
+      /** The handle of the item to explain ("" for none). */
+      explain: str2
+    }).strict();
+    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 and Goal handles (or keys of new Goals). */
+      filed: external_exports.array(external_exports.object({ line: str3, goals: strs3 }).strict()),
+      goals: external_exports.array(external_exports.object({
+        op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
+        key: str3,
+        goal: str3,
+        title: str3,
+        outcome: str3,
+        owner: str3,
+        under: str3,
+        until: str3,
+        on: str3,
+        gate: external_exports.enum(["start", "complete", "answer", ""]),
+        why: str3
+      }).strict()),
+      questions: external_exports.array(external_exports.object({
+        op: external_exports.enum(["create", "edit", "assign", "withdraw"]),
+        key: str3,
+        question: str3,
+        text: str3,
+        to: str3,
+        goal: str3,
+        options: external_exports.array(external_exports.object({ id: str3, label: str3 }).strict()),
+        pick: external_exports.enum(["one", "many", "rank", "words", ""]),
+        blocks: str3
+      }).strict()),
+      lessons: external_exports.array(external_exports.object({ op: external_exports.enum(["remember", "revise", "withdraw"]), lesson: str3, text: str3, scope: str3 }).strict()),
+      /** Line handles whose words comment on Paigy itself. */
+      feedback: strs3
+    }).strict();
+    FILER_REPLY_JSON_SCHEMA = (({ $schema: _, ...rest }) => rest)(
+      zodToJsonSchema(FilerReplySchema, { $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"]),
@@ -24981,7 +25193,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(
@@ -25175,7 +25387,7 @@ var init_dist = __esm({
       /** The awaited ask was REPLACED by a newer notification on its thread (e.g. a
        *  post-feedback revision, #633) — the user will never answer this id. Stop
        *  awaiting it; the live ask is the thread's newest turn (await that one, or
-       *  re-orient via check_replies). */
+       *  re-orient via contact({})). */
       external_exports.object({
         type: external_exports.literal("superseded"),
         parentId: external_exports.string(),
@@ -25742,8 +25954,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
@@ -25901,11 +26113,11 @@ 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(),
-      /** When that work last moved (`claimable.since` on `check_replies`), the fact the bound is judged on. */
+      /** When that work last moved (`claimable.since` on an agent's `contact({})` read), the fact the bound is judged on. */
       since: external_exports.string().datetime().nullable().optional(),
       /** What the host said, in its log's own words: why it stood back, or what the take-over did. */
       said: external_exports.string().max(300).optional()
@@ -26140,8 +26352,9 @@ var init_dist = __esm({
     tokenOverride = null;
     authToken = (explicit) => explicit ?? tokenOverride ?? readToken();
     AWAIT_WINDOW_MS = 45e3;
-    NOT_SENT = "Recorded as progress, not sent: nobody was notified. If the person should see it (a result, something to try or check, a finding), contact again and say so; report progress with update_goal.";
-    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 } } };
@@ -27044,14 +27257,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);
     };
   }
 });
@@ -27553,13 +27766,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,
@@ -28073,27 +28286,27 @@ var require_chunkstream = __commonJS({
       this._buffers = null;
       this.emit("close");
     };
-    ChunkStream.prototype._processReadAllowingLess = function(read) {
+    ChunkStream.prototype._processReadAllowingLess = function(read3) {
       this._reads.shift();
       let smallerBuf = this._buffers[0];
-      if (smallerBuf.length > read.length) {
-        this._buffered -= read.length;
-        this._buffers[0] = smallerBuf.slice(read.length);
-        read.func.call(this, smallerBuf.slice(0, read.length));
+      if (smallerBuf.length > read3.length) {
+        this._buffered -= read3.length;
+        this._buffers[0] = smallerBuf.slice(read3.length);
+        read3.func.call(this, smallerBuf.slice(0, read3.length));
       } else {
         this._buffered -= smallerBuf.length;
         this._buffers.shift();
-        read.func.call(this, smallerBuf);
+        read3.func.call(this, smallerBuf);
       }
     };
-    ChunkStream.prototype._processRead = function(read) {
+    ChunkStream.prototype._processRead = function(read3) {
       this._reads.shift();
       let pos = 0;
       let count = 0;
-      let data = Buffer.alloc(read.length);
-      while (pos < read.length) {
+      let data = Buffer.alloc(read3.length);
+      while (pos < read3.length) {
         let buf = this._buffers[count++];
-        let len = Math.min(buf.length, read.length - pos);
+        let len = Math.min(buf.length, read3.length - pos);
         buf.copy(data, pos, 0, len);
         pos += len;
         if (len !== buf.length) {
@@ -28103,17 +28316,17 @@ var require_chunkstream = __commonJS({
       if (count > 0) {
         this._buffers.splice(0, count);
       }
-      this._buffered -= read.length;
-      read.func.call(this, data);
+      this._buffered -= read3.length;
+      read3.func.call(this, data);
     };
     ChunkStream.prototype._process = function() {
       try {
         while (this._buffered > 0 && this._reads && this._reads.length > 0) {
-          let read = this._reads[0];
-          if (read.allowLess) {
-            this._processReadAllowingLess(read);
-          } else if (this._buffered >= read.length) {
-            this._processRead(read);
+          let read3 = this._reads[0];
+          if (read3.allowLess) {
+            this._processReadAllowingLess(read3);
+          } else if (this._buffered >= read3.length) {
+            this._processRead(read3);
           } else {
             break;
           }
@@ -29738,12 +29951,12 @@ var require_sync_reader = __commonJS({
     };
     SyncReader.prototype.process = function() {
       while (this._reads.length > 0 && this._buffer.length) {
-        let read = this._reads[0];
-        if (this._buffer.length && (this._buffer.length >= read.length || read.allowLess)) {
+        let read3 = this._reads[0];
+        if (this._buffer.length && (this._buffer.length >= read3.length || read3.allowLess)) {
           this._reads.shift();
           let buf = this._buffer;
-          this._buffer = buf.slice(read.length);
-          read.func.call(this, buf.slice(0, read.length));
+          this._buffer = buf.slice(read3.length);
+          read3.func.call(this, buf.slice(0, read3.length));
         } else {
           break;
         }
@@ -30393,13 +30606,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 = "";
@@ -30931,9 +31144,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:"
   ];
@@ -30944,10 +31157,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 {
@@ -30968,9 +31181,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,
@@ -31404,7 +31617,7 @@ function onEnter(input, onLine) {
 // src/cli.ts
 init_dist();
 var import_qrcode = __toESM(require_lib(), 1);
-import { randomUUID as randomUUID7 } 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";
@@ -31413,7 +31626,7 @@ import { join as join11 } from "path";
 
 // src/run.ts
 init_dist();
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 
 // src/harness/session.ts
 init_dist();
@@ -31701,7 +31914,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) {
@@ -31761,7 +31974,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
@@ -33194,6 +33407,8 @@ var zodToJsonSchema2 = (schema, options) => {
 // ../../packages/schema/dist/index.js
 init_zod();
 init_zod();
+init_zod();
+init_zod();
 var OPTIONS_MIN2 = 2;
 var OPTIONS_MAX2 = 6;
 var OptionSchema2 = external_exports.object({
@@ -33203,14 +33418,20 @@ var OptionSchema2 = external_exports.object({
   // .describe() flows into the MCP contact JSON schema (zodToJsonSchema), so
   // the constraints below are what an agent reads when deciding to use these.
   html: external_exports.string().max(16384).describe(
-    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use `image` instead."
+    "Optional sandboxed HTML/CSS preview for a visual 'pick one' (shown in the option card). Untrusted-sandboxed: NO JavaScript, NO external network or images \u2014 inline CSS and data: URIs only; <=16KB. Rendered edge-to-edge in a responsive card that is 200pt tall (about 320pt wide on a phone, with the next option peeking beside it); make your HTML fit that viewport. Use for layout/CSS mockups, tables, diffs. For a hosted image use the image URL instead."
   ).optional(),
   image: external_exports.string().url().describe(
-    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use `html` instead."
+    "Optional image URL rendered as the option's preview (plain image, not sandboxed). For agent-generated HTML/CSS mockups, use the HTML preview instead."
   ).optional()
 });
-var OptionInputSchema2 = OptionSchema2.omit({ id: true }).extend({
-  label: external_exports.string().trim().min(1).max(1e3)
+var OptionInputSchema2 = external_exports.object({
+  id: external_exports.string().trim().min(1).max(64).regex(/^[A-Za-z0-9_.:-]+$/).optional().describe(
+    `Optional: this option's own id, which answers name it by (selectedOptionIds). Give every option one, or none: without them the options are numbered "1", "2", \u2026 in order.`
+  ),
+  label: external_exports.string().trim().min(1).max(1e3),
+  hint: OptionSchema2.shape.hint,
+  htmlPreview: OptionSchema2.shape.html,
+  imgUrl: OptionSchema2.shape.image
 }).strict();
 var NIGHT2 = { from: 23, to: 7 };
 function draft20202(node) {
@@ -33242,33 +33463,162 @@ function mcpInputSchema2(s) {
   delete schema.$schema;
   return draft20202(schema);
 }
-var AskInputSchema2 = external_exports.object({
-  id: external_exports.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: external_exports.string().uuid().optional().describe("The Goal this question is about \u2014 usually the one you are working on. The question goes onto that Goal and its answer comes back there. Omit it and the question starts a new Goal of yours."),
-  repo: external_exports.string().optional().describe("Optional repository context."),
-  ask: external_exports.string().trim().min(1).max(1e4).describe(
-    "ONE question, and only what is needed to answer it. Several questions are several asks in the array, one each: an answer settles the one ask it was given in the shape that ask declares, so a person who answers the part of a bundled ask that interested them settles nothing and is asked again. Paigy sends each ask exactly as you wrote it: a bundled ask arrives as one card. News, progress and findings are their own contact; ANY contact for a person already on a call JOINS that call, whatever channel you asked for, so several arrive as one call."
+var ASK_MAX2 = 250;
+var UNITS_MAX2 = 12;
+var UNIT_TITLE_MAX2 = 50;
+var UNIT_BODY_MAX2 = 200;
+var UnitInputSchema2 = external_exports.object({
+  title: external_exports.string().trim().min(1).describe(`What this unit is about, at most ${UNIT_TITLE_MAX2} characters. The app lists the titles; the person taps one to read its body.`),
+  body: external_exports.string().trim().min(1).describe(`The unit itself, at most ${UNIT_BODY_MAX2} characters.`)
+}).strict();
+function capRefusals2(text, units22, field) {
+  const out = [];
+  const name = field === "text" ? "answer" : field;
+  if (text.length > ASK_MAX2) out.push({
+    refusal: "ask_too_long",
+    length: text.length,
+    cap: ASK_MAX2,
+    path: field === "text" ? ["answer", "text"] : [field],
+    message: `ask_too_long: the ${name} is ${text.length} characters; the cap is ${ASK_MAX2}. Keep the one point in the ${name} and move the context into units.`
+  });
+  const all = units22 ?? [];
+  if (all.length > UNITS_MAX2) out.push({
+    refusal: "too_many_units",
+    length: all.length,
+    cap: UNITS_MAX2,
+    path: ["units"],
+    message: `too_many_units: ${all.length} units; the cap is ${UNITS_MAX2}. Keep only the context this ${name} needs.`
+  });
+  all.forEach((unit, index) => {
+    if (unit.title.length > UNIT_TITLE_MAX2) out.push({
+      refusal: "unit_title_too_long",
+      index,
+      length: unit.title.length,
+      cap: UNIT_TITLE_MAX2,
+      path: ["units", index, "title"],
+      message: `unit_title_too_long: units[${index}]'s title is ${unit.title.length} characters; the cap is ${UNIT_TITLE_MAX2}.`
+    });
+    if (unit.body.length > UNIT_BODY_MAX2) out.push({
+      refusal: "unit_body_too_long",
+      index,
+      length: unit.body.length,
+      cap: UNIT_BODY_MAX2,
+      path: ["units", index, "body"],
+      message: `unit_body_too_long: units[${index}]'s body is ${unit.body.length} characters; the cap is ${UNIT_BODY_MAX2}. Cut it into two units.`
+    });
+  });
+  return out;
+}
+function refuseOverCaps2(text, units22, field, ctx) {
+  for (const { path, message, ...params } of capRefusals2(text, units22, field)) ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path, message, params });
+}
+var questionHandle2 = external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/, "a question id, whole or its first eight characters");
+var NodeRef2 = external_exports.object({
+  type: external_exports.enum(["goal", "question"]),
+  id: external_exports.string().uuid()
+}).strict().describe("A Goal or a Question, by its id.");
+var BlockedAction2 = external_exports.enum(["start", "complete", "answer"]).describe("What waits: starting or completing a Goal, or answering a Question.");
+var reason2 = external_exports.string().trim().min(1).max(500).describe("Why, as an explanation, never as policy.");
+var actionFits2 = (b) => b.blocked.type === "goal" === (b.action !== "answer");
+var ACTION_FITS2 = "a goal is blocked from start or complete; a question from answer";
+var userExplicitlyRequested2 = external_exports.enum(["any", "call"]).optional().describe(
+  `Only what the person said about THIS message, in so many words: "any" when they asked you to send it to them ("send it to my phone", "message me the result"), "call" when they asked to be called about it. It is then delivered (a call rings for the whole contact, and carries everything waiting on them); omitted, an update is only recorded as the Goal's progress unless the person needs it. Never set it to make a message louder.`
+);
+var units2 = external_exports.array(UnitInputSchema2).optional().describe(
+  `The context this message needs, as up to ${UNITS_MAX2} units in reading order, each {title, body}: a title of at most ${UNIT_TITLE_MAX2} characters and a body of at most ${UNIT_BODY_MAX2}. One idea per unit. Leave it out when the main text says it all.`
+);
+var UpdateInputSchema2 = external_exports.object({
+  message: external_exports.string().trim().min(1).describe(`The one point, at most ${ASK_MAX2} characters; the context goes in units.`),
+  goalIds: external_exports.array(external_exports.string().uuid()).min(1).max(10).describe("The Goals it is about, each one that exists: the one it is mainly about first."),
+  units: units2,
+  userExplicitlyRequested: userExplicitlyRequested2
+}).strict().superRefine((u, ctx) => refuseOverCaps2(u.message, u.units, "message", ctx));
+var questionFields2 = {
+  question: external_exports.string().trim().min(1).describe(
+    `ONE question, in at most ${ASK_MAX2} characters, and only what is needed to answer it; the context goes in units. Several questions are several objects, one each: an answer settles the one question it was given, so a person who answers the part of a bundled question that interested them settles nothing and is asked again. Separate questions cost nothing: ANY contact for a person already on a call JOINS that call, so several arrive as one call.`
   ),
-  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional(),
+  goalId: external_exports.string().uuid().describe("The Goal the question is about, which must exist (create it with manage_goals first). Its answer comes back there."),
+  units: units2,
+  options: external_exports.array(OptionInputSchema2).min(1).max(6).optional().describe("The choices, when you have them. Each label stands on its own."),
   // HOW THE OPTIONS ARE ANSWERED, SAID BY THE AGENT (owner, 2026-10-02: "one and many makes sense";
-  // brain_prompts.md §1: structured agent questions need no model). Every card was pick-one while no
-  // agent sent this; no read reshapes cards any more, so this is the card's shape, and the
-  // description says so plainly.
-  select: external_exports.enum(["one", "many"]).optional().describe(
-    'How the options are answered: "many" makes a checklist (they may want several, e.g. independent fixes), "one" (the default) a pick (choosing one rules out the others). Send "many" whenever more than one option could be wanted at once. The person can always answer in their own words as well. Ignored without options.'
+  // brain_prompts.md §1: structured agent questions need no model). The app draws all three.
+  pickMode: external_exports.enum(["one", "many", "rank"]).optional().describe(
+    'How the options are answered: "one" (the default) a pick, for alternatives; "many" a checklist, for independent options they may want several of; "rank" an order of all of them. Only with options.'
   ),
-  answers: external_exports.string().trim().regex(/^[0-9a-fA-F-]{8,36}$/).optional().describe(
-    "Your reply answers a question the person asked you: the id the conversation shows for it (8 characters or whole). Their question closes with this reply as its answer, and any decision of yours it was holding back goes back to them. parentId is optional here: the question's own Goal is used. The reply is sent to them as it is; to also ask something new, send that as its own ask."
+  // 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 (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 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 ContactSchema2 = external_exports.union([StartContactSchema2, external_exports.object({ deliveryId: external_exports.string().uuid() }).strict()]);
+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 durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. 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, and a report is an UPDATE, never a claim on them: it reaches them and is listed apart from what waits on them, so no answer is owed and none should be awaited. On a Goal whose report card is still open it is added to that card, with no new push; Where your work stands while under way is progress: report it with update_goal, not contact. 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, your contact joins that call automatically \u2014 whatever channel you asked for, with no ring \u2014 and the Delivery it returns IS that call: reread it with contact({deliveryId}) to see everything answered on it so far, and contact again while it is live to add information or a further question to the same call.";
+var CONTACT_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
@@ -33288,10 +33638,6 @@ var CreateGoalSchema2 = external_exports.object({
    *  repo name. Delegated work inherits this from its parent Goal when omitted. */
   repo: external_exports.string().trim().min(1).max(200).optional()
 });
-var CreateGoalToolSchema2 = CreateGoalSchema2.extend({
-  idempotencyKey: CreateGoalSchema2.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
-}).strict();
-var CREATE_GOAL_DESCRIPTION2 = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass repo to anchor the work to a specific repository ("owner/repo" or repo name); delegated children inherit it. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
 var UpdateGoalSchema2 = external_exports.object({
   revision: external_exports.number().int().positive(),
   changes: external_exports.object({
@@ -33306,17 +33652,64 @@ 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 = UpdateGoalSchema2.omit({ operationId: true }).extend({ goalId: external_exports.string().uuid() }).strict();
-var ClaimGoalSchema2 = external_exports.object({ goalId: external_exports.string().uuid().optional() }).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 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 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();
+var EditChange2 = external_exports.object({ kind: external_exports.literal("edit"), goalId: changedGoal2, title: goalTitle2.optional(), outcome: goalOutcome2.optional() }).strict();
+var StateChange2 = external_exports.object({ kind: external_exports.literal("state"), goalId: changedGoal2, state: external_exports.enum(["open", "completed", "canceled"]).describe(
+  "completed: the Goal's own work is done now (refused while required children are open); open: reopen it; canceled: it will not be done."
+) }).strict();
+var 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: 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."
+) }).strict();
+var DependencyChange2 = external_exports.object({
+  kind: external_exports.literal("dependency"),
+  change: external_exports.enum(["add", "remove"]),
+  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.")
+}).strict();
+var read2 = { revision: external_exports.number().int().positive().optional() };
+var GoalChangeSchema2 = external_exports.discriminatedUnion("kind", [
+  CreateChange2,
+  EditChange2.extend(read2),
+  StateChange2.extend(read2),
+  AssignChange2.extend(read2),
+  DeferChange2.extend(read2),
+  MoveChange2.extend(read2),
+  DependencyChange2
+]);
+var editNames2 = (changes, ctx) => changes.forEach((c, i) => {
+  if (c.kind === "edit" && c.title === void 0 && c.outcome === void 0) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["changes", i], message: "an edit supplies title, outcome, or both" });
+  }
+});
+var ManageGoalsSchema2 = external_exports.object({
+  requestId: external_exports.string().uuid().optional(),
+  changes: external_exports.array(GoalChangeSchema2).min(1).max(50)
+}).strict().superRefine((v, ctx) => editNames2(v.changes, ctx));
+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_found) and the rest still apply, so read every result: a partial result is never a complete success. Kinds: create (title, outcome, ownerId, parentGoalId, sourceEntryIds) returns the new Goal's id in `results[i].goalId`, in the order requested, to use in later calls; edit (title and/or outcome); state (open, completed, canceled); assign (ownerId); defer (until: the Goal waits until then and its owner is woken when it passes; null takes it back); move (parentGoalId, or null for a root: only this Goal moves); dependency (add or remove: goalId waits on dependsOnGoalId to start or to complete). A Goal cannot be completed while its required children or dependencies remain open: finish or move them first. Finishing the children does not prove the parent's own work is done. An edit applies at the version you last read: if someone changed the Goal since, it is refused as goal_revision_conflict, so read it again (get_goal) and reconsider. You may change any Goal of your person; a change puts you on it. Returns `ok` (every change applied), `results` per change (applied or failed), and `goals`, each changed Goal's id, state, title, outcome and revision.";
 var GetGoalSchema2 = external_exports.object({
   goalId: external_exports.string().uuid(),
   /** Every entry in full. Without it the read carries the person's words, open questions and your
@@ -33327,19 +33720,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 = `Update a Goal you are on at an exact revision. You are on a Goal you own, or one you have written on (an update with progress, or a contact on it); any of your person's agents may write on any of their Goals, and one that never touched a Goal is refused (409 goal_not_joined). State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. A CONTACT ON THIS GOAL MOVES ITS REVISION: a question filed on a Goal is a change to it, so an update prepared before a contact and sent after it is refused as stale (409 goal_revision_conflict) \u2014 re-read the Goal, then write. title is the work's name in one to five words, as a person would refer to it out loud (it is spoken on a call and heads every list); null clears it. reviewed: true acknowledges new evidence and closes the Deliveries addressed to you on that Goal, never over an open decision. dueAt (an ISO instant, or null) makes the Goal wait until then; when it passes you are woken for it \u2014 use it for a promise to follow up later. withdraw: [questionId] takes back a question YOU asked on this Goal that is still open \u2014 because you acted on it yourself, it no longer matters, or you asked it wrongly (e.g. waiting: hard when nothing was blocked): it is cancelled, not answered, its card closes and it stops ringing; the id is the one the conversation shows. state: done means the work was accomplished, and it can be reopened: when the person says it is not done ("it's not working"), set state: active on that same Goal instead of starting a new one; its parent reopens with it. state: done while children are still open records your part as done: the Goal waits and closes by itself when its last open child closes. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
-var CLAIM_GOAL_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 its state; use update_goal with ownerParticipant when the assignment itself should change. Returns the Goal as get_goal reads it, and marks you as on it, which never shuts another agent out: other agents of your person may write on it and change it too, and two changes at once are told apart by revision (409 goal_revision_conflict).";
-var CHECK_REPLIES_DESCRIPTION2 = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
-var CheckRepliesSchema2 = external_exports.object({}).strict();
+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 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(CheckRepliesSchema2) },
   { name: "contact", description: CONTACT_DESCRIPTION2, inputSchema: CONTACT_SCHEMA2 },
-  { name: "check_replies", description: CHECK_REPLIES_DESCRIPTION2, inputSchema: mcpInputSchema2(CheckRepliesSchema2) },
-  { name: "create_goal", description: CREATE_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(CreateGoalToolSchema2) },
-  { name: "claim_goal", description: CLAIM_GOAL_DESCRIPTION2, inputSchema: mcpInputSchema2(ClaimGoalSchema2) },
+  { name: "manage_goals", description: MANAGE_GOALS_DESCRIPTION2, inputSchema: mcpInputSchema2(ManageGoalsToolSchema2) },
   { 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: "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();
@@ -33370,17 +33773,6 @@ var existingGoalChanges2 = [
     reason: external_exports.string().max(500).optional()
   }).strict()
 ];
-var GoalChangeSchema2 = external_exports.union([
-  external_exports.object({
-    kind: external_exports.literal("create"),
-    title: external_exports.string().min(1).max(120),
-    outcome: external_exports.string().min(1),
-    ownerId: participant2,
-    parentGoalId: id2.optional(),
-    sourceEntryIds: external_exports.array(id2)
-  }).strict(),
-  ...existingGoalChanges2
-]);
 var BrainGoalChangeSchema2 = external_exports.union([
   // newSession: Paigy starts a session to own it (owner, 2026-10-06); until it has, the person owns it.
   external_exports.object({
@@ -33462,33 +33854,93 @@ var BrainResultSchema2 = external_exports.object({
   next: BrainNextSchema2,
   search: BrainSearchSchema2.optional()
 }).strict();
-var str2 = external_exports.string();
-var strs2 = external_exports.array(external_exports.string());
+var str4 = external_exports.string();
+var strs4 = external_exports.array(external_exports.string());
 var CompactResultSchema2 = external_exports.object({
-  next: external_exports.object({ say: strs2, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs2, reason: str2, instructions: strs2 }).strict(),
-  messages: external_exports.array(external_exports.object({ key: str2, to: str2, text: str2, about: strs2, entries: strs2, owed: strs2, inviteToCall: external_exports.boolean() }).strict()),
-  entries: external_exports.array(external_exports.object({ key: str2, from: str2, on: strs2 }).strict()),
-  answers: external_exports.array(external_exports.object({ question: str2, entries: strs2, summary: str2, picked: strs2 }).strict()),
+  next: external_exports.object({ say: strs4, then: external_exports.enum(["listen", "hold", "end", "none"]), waitFor: strs4, reason: str4, instructions: strs4 }).strict(),
+  messages: external_exports.array(external_exports.object({ key: str4, to: str4, text: str4, about: strs4, entries: strs4, owed: strs4, inviteToCall: external_exports.boolean() }).strict()),
+  entries: external_exports.array(external_exports.object({ key: str4, from: str4, on: strs4 }).strict()),
+  answers: external_exports.array(external_exports.object({ question: str4, entries: strs4, summary: str4, picked: strs4 }).strict()),
   changes: external_exports.array(external_exports.object({
-    key: str2,
+    key: str4,
     what: external_exports.enum(["goal", "question", "lesson"]),
     op: external_exports.enum(["create", "edit", "assign", "open", "complete", "cancel", "defer", "move", "block", "unblock", "withdraw", "remember", "revise"]),
-    id: str2,
-    text: str2,
-    title: str2,
-    who: str2,
-    under: str2,
+    id: str4,
+    text: str4,
+    title: str4,
+    who: str4,
+    under: str4,
     gate: external_exports.enum(["start", "complete", "answer", "none"]),
-    options: external_exports.array(external_exports.object({ id: str2, label: str2 }).strict()),
+    options: external_exports.array(external_exports.object({ id: str4, label: str4 }).strict()),
     pick: external_exports.enum(["one", "many", "rank", "words"]),
-    entries: strs2
+    entries: strs4
   }).strict()),
-  feedback: external_exports.array(strs2),
-  search: external_exports.object({ query: str2, within: strs2, goal: str2 }).strict()
+  feedback: external_exports.array(strs4),
+  search: external_exports.object({ query: str4, within: strs4, goal: str4 }).strict()
 }).strict();
 var COMPACT_RESULT_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
   zodToJsonSchema2(CompactResultSchema2, { $refStrategy: "none" })
 );
+var str22 = external_exports.string();
+var strs22 = external_exports.array(external_exports.string());
+var TalkerReplySchema2 = external_exports.object({
+  /** What to say and send, messages to the person first: spoken in the order written. `to` is "user"
+   *  or an agent's handle; `about` names handles; `blocks` is the item a question to an agent must be
+   *  answered before ("" for none). */
+  messages: external_exports.array(external_exports.object({ key: str22, to: str22, text: str22, about: strs22, blocks: str22 }).strict()),
+  /** What the call does next: listen, hold (the person asked for a moment) or end (they asked to). */
+  then: external_exports.enum(["listen", "hold", "end"]),
+  /** Items the person's words settle: the item's handle, the chosen option IDs, the line handles. */
+  answers: external_exports.array(external_exports.object({ item: str22, options: strs22, lines: strs22 }).strict()),
+  /** The line handles that hold a new instruction from the person. */
+  instruction: strs22,
+  /** The line handles that ask for new work, a change to existing work, or a standing rule: the filer
+   *  reads only these (3e). */
+  file: strs22,
+  /** Evidence to fetch for a second round: a search, an item's full text, or an agent by name. */
+  need: external_exports.object({ kind: external_exports.enum(["search", "item", "agent", ""]), text: str22 }).strict(),
+  /** The handle of the item to explain ("" for none). */
+  explain: str22
+}).strict();
+var TALKER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(TalkerReplySchema2, { $refStrategy: "none" })
+);
+var str32 = external_exports.string();
+var strs32 = external_exports.array(external_exports.string());
+var FilerReplySchema2 = external_exports.object({
+  /** Which Goals each new line goes on: a line's handle and Goal handles (or keys of new Goals). */
+  filed: external_exports.array(external_exports.object({ line: str32, goals: strs32 }).strict()),
+  goals: external_exports.array(external_exports.object({
+    op: external_exports.enum(["create", "edit", "complete", "cancel", "reopen", "assign", "defer", "move", "block", "unblock"]),
+    key: str32,
+    goal: str32,
+    title: str32,
+    outcome: str32,
+    owner: str32,
+    under: str32,
+    until: str32,
+    on: str32,
+    gate: external_exports.enum(["start", "complete", "answer", ""]),
+    why: str32
+  }).strict()),
+  questions: external_exports.array(external_exports.object({
+    op: external_exports.enum(["create", "edit", "assign", "withdraw"]),
+    key: str32,
+    question: str32,
+    text: str32,
+    to: str32,
+    goal: str32,
+    options: external_exports.array(external_exports.object({ id: str32, label: str32 }).strict()),
+    pick: external_exports.enum(["one", "many", "rank", "words", ""]),
+    blocks: str32
+  }).strict()),
+  lessons: external_exports.array(external_exports.object({ op: external_exports.enum(["remember", "revise", "withdraw"]), lesson: str32, text: str32, scope: str32 }).strict()),
+  /** Line handles whose words comment on Paigy itself. */
+  feedback: strs32
+}).strict();
+var FILER_REPLY_JSON_SCHEMA2 = (({ $schema: _, ...rest }) => rest)(
+  zodToJsonSchema2(FilerReplySchema2, { $refStrategy: "none" })
+);
 function entryWords(entry) {
   const content = entry.content;
   if (content && "sealed" in content) return "";
@@ -33512,7 +33964,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"]),
@@ -33587,7 +34042,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(
@@ -33781,7 +34236,7 @@ var AwaitItemSchema2 = external_exports.discriminatedUnion("type", [
   /** The awaited ask was REPLACED by a newer notification on its thread (e.g. a
    *  post-feedback revision, #633) — the user will never answer this id. Stop
    *  awaiting it; the live ask is the thread's newest turn (await that one, or
-   *  re-orient via check_replies). */
+   *  re-orient via contact({})). */
   external_exports.object({
     type: external_exports.literal("superseded"),
     parentId: external_exports.string(),
@@ -34348,8 +34803,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
@@ -34505,11 +34960,11 @@ 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(),
-  /** When that work last moved (`claimable.since` on `check_replies`), the fact the bound is judged on. */
+  /** When that work last moved (`claimable.since` on an agent's `contact({})` read), the fact the bound is judged on. */
   since: external_exports.string().datetime().nullable().optional(),
   /** What the host said, in its log's own words: why it stood back, or what the take-over did. */
   said: external_exports.string().max(300).optional()
@@ -34734,6 +35189,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",
@@ -34862,13 +35343,27 @@ 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: (input) => createGoal(input, opts),
-    waiting: () => checkReplies(opts)
+    create: async (input) => {
+      const made = await manageGoals({ changes: [{ kind: "create", ...input }] }, opts);
+      const goal = made.goals.find((g) => g.goalId === made.results[0]?.goalId);
+      if (!goal) throw new Error(`manage_goals create failed: ${made.results[0]?.error ?? "no goal"}`);
+      return { goalId: goal.goalId, revision: goal.revision };
+    },
+    waiting: () => receive(opts)
   };
 }
 function cancelAsks(state) {
@@ -34889,13 +35384,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);
@@ -34913,57 +35413,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 ?? "");
 }
@@ -34990,15 +35487,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
-import { randomUUID as randomUUID5 } from "crypto";
-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() {
@@ -35098,43 +35594,48 @@ 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);
   for (const { goal, since } of moved) look2(goal.goalId, "subtree", goal.title, since);
   const heard = [];
-  const read = /* @__PURE__ */ new Set();
+  const read3 = /* @__PURE__ */ new Set();
   for (const [goalId, { since, ...found }] of looks) {
     let brief = found.brief;
     if (!brief) {
       try {
         brief = await rail.read(goalId);
       } catch (error) {
-        if (error.status === 404) read.add(goalId);
+        if (error.status === 404) read3.add(goalId);
         continue;
       }
     }
-    read.add(goalId);
+    read3.add(goalId);
     const fresh = !brief.reviewSince && (found.via === "waiting work" || found.via === "assigned") ? sinceTheWork(brief) : { after: -1 };
     if (found.via === "assigned") announced.add(goalId);
     heard.push({ goalId, ...found, brief, words: unheard(brief, state, brief.reviewSince ? null : since ?? null, fresh.after, brief.reviewSince), ...fresh.note ? { note: fresh.note } : {} });
   }
-  for (const { goal, since } of moved) if (read.has(goal.goalId)) state.below.goals.set(goal.goalId, { since, at: goal.updatedAt ?? null });
+  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() ?? "";
@@ -35164,7 +35665,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.";
@@ -35210,15 +35714,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`);
   }
@@ -35244,13 +35749,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({ outcome: prompt, idempotencyKey: randomUUID5() });
-        brief2 = await rail.claim();
+        const admitted = await rail.create({ title: prompt.split(/\s+/).slice(0, 5).join(" ").slice(0, 80), outcome: prompt });
+        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"));
@@ -35272,7 +35777,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);
@@ -35340,9 +35845,9 @@ async function pump(session, state, rail, opts) {
     }
     if (!await opts.onIdle()) return;
     if (now() - since >= BEAT_REPORT_MS) {
-      const read = counts.wake + counts.rest + counts.safety;
-      if (read || counts.skipped || tally.noted || tally.seen || tally.announced) {
-        opts.log?.(`\u25B9 beats: ${read} read (${counts.wake} wake, ${counts.rest} rest, ${counts.safety} safety), ${counts.skipped} wake mid-turn skipped, ${tally.noted} noted mid-turn, ${tally.seen} seen by the hook, ${tally.announced} assigned announced${tally.paused ? `, ${tally.paused} held by the usage limit` : ""}`);
+      const read3 = counts.wake + counts.rest + counts.safety;
+      if (read3 || counts.skipped || tally.noted || tally.seen || tally.announced) {
+        opts.log?.(`\u25B9 beats: ${read3} read (${counts.wake} wake, ${counts.rest} rest, ${counts.safety} safety), ${counts.skipped} wake mid-turn skipped, ${tally.noted} noted mid-turn, ${tally.seen} seen by the hook, ${tally.announced} assigned announced${tally.paused ? `, ${tally.paused} held by the usage limit` : ""}`);
       }
       counts.wake = counts.rest = counts.safety = counts.skipped = tally.noted = tally.seen = tally.announced = tally.paused = 0;
       since = now();
@@ -35360,7 +35865,7 @@ function runHarness(opts) {
   const clock4 = beat();
   let session = null;
   const speaksAs = opts.session ?? opts.resume ?? sessionId();
-  const instance = randomUUID6();
+  const instance = randomUUID4();
   const rail = railFor({ token: opts.token, reach: reachAs(speaksAs, instance) });
   let inbox;
   if (opts.harness === "claude") {
@@ -35374,7 +35879,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") {
@@ -35556,7 +36061,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";
@@ -35571,7 +36076,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;
   }
@@ -35599,7 +36104,7 @@ function proven(pid, procStart, deps) {
 function localHolderPids(deps = {}) {
   const dir = deps.dir ?? join7(process.env.CLAUDE_CONFIG_DIR?.trim() || join7(homedir7(), ".claude"), "sessions");
   const list = deps.list ?? ((d) => readdirSync3(d));
-  const read = deps.read ?? ((f) => readFileSync5(f, "utf8"));
+  const read3 = deps.read ?? ((f) => readFileSync5(f, "utf8"));
   const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
   const held = /* @__PURE__ */ new Map();
   let files;
@@ -35612,7 +36117,7 @@ function localHolderPids(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read(join7(dir, file)));
+      row = JSON.parse(read3(join7(dir, file)));
     } catch {
       continue;
     }
@@ -35626,7 +36131,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 {
@@ -35644,7 +36149,7 @@ function descendsFrom(pid, ancestor, parent = psParent) {
 function localHolders(deps = {}) {
   const dir = deps.dir ?? join7(process.env.CLAUDE_CONFIG_DIR?.trim() || join7(homedir7(), ".claude"), "sessions");
   const list = deps.list ?? ((d) => readdirSync3(d));
-  const read = deps.read ?? ((f) => readFileSync5(f, "utf8"));
+  const read3 = deps.read ?? ((f) => readFileSync5(f, "utf8"));
   const check = { alive: deps.alive ?? isAlive, started: deps.started ?? psStart };
   const held = /* @__PURE__ */ new Map();
   let files;
@@ -35657,7 +36162,7 @@ function localHolders(deps = {}) {
     if (!/^\d+\.json$/.test(file)) continue;
     let row;
     try {
-      row = JSON.parse(read(join7(dir, file)));
+      row = JSON.parse(read3(join7(dir, file)));
     } catch {
       continue;
     }
@@ -35750,7 +36255,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);
@@ -35768,7 +36273,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;
     }
@@ -35891,7 +36396,7 @@ async function waitingWork(token, session) {
   if (quiet !== void 0 && Date.now() < quiet) return { skip: BOUND_SKIP };
   let found;
   try {
-    found = await checkReplies({ token, ...session ? { reach: reachAs(session) } : {} });
+    found = await receive({ token, ...session ? { reach: reachAs(session) } : {} });
   } catch (error) {
     if (error instanceof RevokedError) return { skip: "was revoked: its credential is gone for good", revoked: true };
     if (error instanceof ApiError && error.body?.error === "identity_session_mismatch") {
@@ -36130,7 +36635,7 @@ function startHost(opts) {
         skip(`has a full conversation (${resumes.slice(0, 8)}) \u2014 not resuming it; its Goals go to the dead-agent handoff`);
         return;
       }
-      const read = async () => {
+      const read3 = async () => {
         const got = await waitingWork(token, identity.sessionId ?? owner?.sessionId);
         if (!("skip" in got)) return got;
         if (got.revoked) {
@@ -36142,7 +36647,7 @@ function startHost(opts) {
         return null;
       };
       if (decided.why === "presence") {
-        found = await read() ?? void 0;
+        found = await read3() ?? void 0;
         if (!found) return;
         const since = found.since;
         decided = wakeAction(false, Date.now(), seenByServer, { ...here, ...since ? { movedAt: Date.parse(since) } : {} });
@@ -36168,7 +36673,7 @@ function startHost(opts) {
         skip("has no granted folder to wake in");
         return;
       }
-      found ??= await read() ?? void 0;
+      found ??= await read3() ?? void 0;
       if (!found) return;
       if (runs.has(key3)) {
         skip("was started by the wake that read it first");
@@ -36304,7 +36809,7 @@ function startHost(opts) {
         return {
           name,
           // The slot key rides along so the window's agent page can speak AS this agent —
-          // its pending reads (`checkReplies`, the same pure read the sweep does) need the
+          // its pending reads (`receive`, the same pure read the sweep does) need the
           // slot's own token, and the display name is not a key.
           slot,
           tokenId: id3.tokenId,
@@ -36710,7 +37215,7 @@ async function main() {
   let launched;
   if (parsed.launch) {
     overrideToken(readSlot("Desktop") || null);
-    const session = randomUUID7();
+    const session = randomUUID5();
     const minted = await hatch(parsed.launch, parsed.voice ?? null, {
       reach: reachAs(session),
       brief: parsed.prompt,