@paigy/mcp 0.40.15 → 0.40.17

package/dist/{chunk-37FS33UP.js → chunk-7VLZIOLF.js}

@@ -4,10 +4,10 @@ import {
   serverInstructions,
   sessionStartHook,
   withSessionStartHook
-} from "./chunk-SE2JCKDI.js";
+} from "./chunk-MWHYYLCE.js";
 import {
   agentName
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/toolset.ts
 var ONBOARD_DESCRIPTION = "Get this agent talking to Paigy \u2014 call it FIRST, before contact, and any time you're unsure who you are. One call, and it does whatever the situation needs: NOT SET UP \u2192 hatches an identity instantly if this machine holds a device credential (the user ran the Paigy desktop app or harness), otherwise starts the code ceremony; ALREADY SET UP \u2192 returns your current identity and offers the two things left to decide, renaming it or unpairing; TOKEN NO LONGER VALID \u2192 says so, then re-pairs. Pass { name, voice } to choose who you are when hatching, or to RENAME yourself when already set up (voices: rachel, george, jessica, brian, lily). Safe to call any time: idempotent, and it never writes settings \u2014 the tool-allowlist state it reports is read-only. If it returns a `user_code`, print it to the user immediately and call onboard again with the `device_code`. If it returns `enable_command`, PRINT that command for the user to run \u2014 you cannot apply it yourself (it writes your own permission allowlist, which hosts block as privilege escalation), so print it, don't wait for it, and carry on.";

package/dist/{chunk-SE2JCKDI.js → chunk-MWHYYLCE.js}

@@ -68,7 +68,7 @@ var StartContactSchema = z2.object({
 }).strict();
 var ContactSchema = z2.union([StartContactSchema, z2.object({ deliveryId: z2.string().uuid() }).strict()]);
 var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read \u2014 parts of one piece of work under one Goal, separate things as separate Goals.";
+var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read \u2014 parts of one piece of work under one Goal, separate things as separate Goals. An ask with no options that is not blocking is a report: on a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so).";
 var CreateGoalSchema = z3.object({
   outcome: z3.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -115,9 +115,9 @@ var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({
 var ClaimGoalSchema = z3.object({ goalId: z3.string().uuid().optional() }).strict();
 var GetGoalSchema = z3.object({ goalId: z3.string().uuid() }).strict();
 var GET_GOAL_DESCRIPTION = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), and `next`, the one step to take. Foreign or sibling-owned Goals are not disclosed.";
-var UPDATE_GOAL_DESCRIPTION = "Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. 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. Returns the Goal as get_goal reads it, at its new revision.";
+var UPDATE_GOAL_DESCRIPTION = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. 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. 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. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
 var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Another agent's Goal that has gone quiet for 3 days (check_replies lists them as stalledOthers) is taken over when you claim it, and becomes yours to finish or cancel. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
-var CHECK_REPLIES_DESCRIPTION = "Your open Deliveries: every Notification or Call currently addressed to you \u2014 a request the user started toward you, an answer relayed to something you asked, a handoff \u2014 one row each: its Goals, how many decisions are still open, and the newest words in brief. 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 it in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true closes the Deliveries addressed to you on that Goal. Your runnable and review-pending Goals come from claim_goal, not from here.";
+var CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
 var CheckRepliesSchema = z3.object({}).strict();
 var AGENT_TOOLS = [
   { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
@@ -472,9 +472,9 @@ var AgendaTurnSchema = z4.object({
   /** Twin coverage (#1089): sibling claim ids this asking turn's answer ALSO settles —
    *  the planner declares duplicates instead of asking them twice. */
   coveredIds: z4.array(z4.string()).optional(),
-  /** At most three short spoken sentences. Capped because a turn is a breath: a 1031-char
-   *  line went out on 2026-07-28 and the caller could not answer it at all. */
-  info: z4.array(z4.string().min(1)).max(3).default([]),
+  /** The spoken sentences of the turn, in order. No count: how long a turn is is the brain's call
+   *  (owner, 2026-09-25), and a count here refused whole plans. */
+  info: z4.array(z4.string().min(1)).default([]),
   question: z4.string().min(1).nullable(),
   /** True on the one turn carrying the agent's own declared question. */
   asks: z4.boolean().optional(),
@@ -585,6 +585,11 @@ var InboxItemSchema = z4.object({
    *  and "dismiss the stalled ones" cancelled 37 pieces of live work). */
   cold: z4.string().datetime().optional(),
   clarifies: z4.string().optional(),
+  /** THIS CARD'S QUESTION IS ON A LIVE CALL (owner, 2026-09-24: "Mark it while the call is
+   *  live"). Present only while an open Call Delivery carries the card's request Entry — read
+   *  off the same open list the card came from, so it clears when the Call does. A card is the
+   *  backup for a call not taken; while the call has it, the call is where it is answered. */
+  onCall: z4.literal(true).optional(),
   /** THE RING, ON THE ITEM (walk/design.md §12 §17, #2251): the last ring on this card was
    *  declined, and what the ladder will do next — read off the cron's own row, never computed
    *  on the phone. Present only while a `declined` receipt stands on the card's last Call.
@@ -1149,7 +1154,8 @@ next check_replies. Start your own listener now, as a BACKGROUND task whose outp
   npx -y -p @paigy/mcp@latest paigy-listen
 
 Each line it prints is a Delivery waiting for you: read the Goal, and reply with contact when
-the answer needs a decision. Start it once; if it is already running, do nothing.
+the answer needs a decision. Start it once; if it is already running, do nothing. Then call
+claim_goal once: work handed to you before this session started waits there.
 PAIGY
 exit 0
 `;

package/dist/{chunk-X6G7XXCP.js → chunk-UIZLBPRG.js}

@@ -4,7 +4,7 @@ import {
   requestCode,
   saveToken,
   sleep
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/identity.ts
 var CLIENT_LABELS = {

package/dist/{chunk-PHTQITTC.js → chunk-V5AQASR7.js}

@@ -1536,7 +1536,7 @@ var StartContactSchema = z2.object({
 }).strict();
 var ContactSchema = z2.union([StartContactSchema, z2.object({ deliveryId: z2.string().uuid() }).strict()]);
 var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
-var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read \u2014 parts of one piece of work under one Goal, separate things as separate Goals.";
+var CONTACT_DESCRIPTION = "Contact the user with one or more asks/questions. Pass an array of asks (each with 'ask', optional 'options', 'id', 'parentId', 'repo'), plus channel:'notification'|'call', and waiting:'none'|'hard'. An ask that names a Goal (parentId) goes onto that Goal; one that names none is placed in the person's tree by Paigy. Notification returns immediately; collect durable answers with check_replies. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. One question per 'ask'; several questions are several objects in 'asks'. A bundled ask is taken apart into its own cards by Paigy's one intake read \u2014 parts of one piece of work under one Goal, separate things as separate Goals. An ask with no options that is not blocking is a report: on a Goal whose report card is still open it is added to that card, with no new push; one that only says where your work stands while under way is recorded as the Goal's progress, not sent (the result says so).";
 var CreateGoalSchema = z3.object({
   outcome: z3.string().trim().min(1).max(1e4),
   /** The work's NAME (#2115) — one to five words, how a person refers to it out loud ("the night
@@ -1583,9 +1583,9 @@ var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({
 var ClaimGoalSchema = z3.object({ goalId: z3.string().uuid().optional() }).strict();
 var GetGoalSchema = z3.object({ goalId: z3.string().uuid() }).strict();
 var GET_GOAL_DESCRIPTION = "Read one Goal without claiming it: its outcome, state, revision, progress, blockers, the conversation on it (each question with its options and what was decided), and `next`, the one step to take. Foreign or sibling-owned Goals are not disclosed.";
-var UPDATE_GOAL_DESCRIPTION = "Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. 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. Returns the Goal as get_goal reads it, at its new revision.";
+var UPDATE_GOAL_DESCRIPTION = `Update an owned Goal at an exact revision. State, ownership, dependencies, children, progress, title, and review acknowledgement are explicit; stale revisions are rejected. 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. 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. cancelled is final. Returns the Goal as get_goal reads it, at its new revision.`;
 var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Another agent's Goal that has gone quiet for 3 days (check_replies lists them as stalledOthers) is taken over when you claim it, and becomes yours to finish or cancel. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
-var CHECK_REPLIES_DESCRIPTION = "Your open Deliveries: every Notification or Call currently addressed to you \u2014 a request the user started toward you, an answer relayed to something you asked, a handoff \u2014 one row each: its Goals, how many decisions are still open, and the newest words in brief. 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 it in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true closes the Deliveries addressed to you on that Goal. Your runnable and review-pending Goals come from claim_goal, not from here.";
+var CHECK_REPLIES_DESCRIPTION = "What is waiting for you: your open Deliveries (a request the user started toward you, a handoff), one row each with its Goals, how many decisions are still open, and the newest words in brief; `assigned`, your Goals nobody has started yet, however they became yours (claim_goal({goalId}) starts one); and `review`, your Goals with something new on them \u2014 the user's answers and notes are Entries on the Goal, not Deliveries. A pure read with no arguments: nothing is consumed, acknowledged or claimed by reading it, so call it on startup, after a long wait, or whenever you want to know what is outstanding. To act on one, claim its Goal (claim_goal) or reread a Delivery in full with contact({deliveryId}). Once you have acted on what arrived, update_goal with reviewed: true clears the Goal from `review` and closes the Deliveries addressed to you on it.";
 var CheckRepliesSchema = z3.object({}).strict();
 var AGENT_TOOLS = [
   { name: "contact", description: CONTACT_DESCRIPTION, inputSchema: CONTACT_SCHEMA },
@@ -1930,9 +1930,9 @@ var AgendaTurnSchema = z4.object({
   /** Twin coverage (#1089): sibling claim ids this asking turn's answer ALSO settles —
    *  the planner declares duplicates instead of asking them twice. */
   coveredIds: z4.array(z4.string()).optional(),
-  /** At most three short spoken sentences. Capped because a turn is a breath: a 1031-char
-   *  line went out on 2026-07-28 and the caller could not answer it at all. */
-  info: z4.array(z4.string().min(1)).max(3).default([]),
+  /** The spoken sentences of the turn, in order. No count: how long a turn is is the brain's call
+   *  (owner, 2026-09-25), and a count here refused whole plans. */
+  info: z4.array(z4.string().min(1)).default([]),
   question: z4.string().min(1).nullable(),
   /** True on the one turn carrying the agent's own declared question. */
   asks: z4.boolean().optional(),
@@ -2043,6 +2043,11 @@ var InboxItemSchema = z4.object({
    *  and "dismiss the stalled ones" cancelled 37 pieces of live work). */
   cold: z4.string().datetime().optional(),
   clarifies: z4.string().optional(),
+  /** THIS CARD'S QUESTION IS ON A LIVE CALL (owner, 2026-09-24: "Mark it while the call is
+   *  live"). Present only while an open Call Delivery carries the card's request Entry — read
+   *  off the same open list the card came from, so it clears when the Call does. A card is the
+   *  backup for a call not taken; while the call has it, the call is where it is answered. */
+  onCall: z4.literal(true).optional(),
   /** THE RING, ON THE ITEM (walk/design.md §12 §17, #2251): the last ring on this card was
    *  declined, and what the ladder will do next — read off the cron's own row, never computed
    *  on the phone. Present only while a `declined` receipt stands on the card's last Call.
@@ -2899,6 +2904,7 @@ function currentRepo(cwd = process.cwd()) {
   }
   return asked;
 }
+var 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.";
 async function contact(input, opts = {}) {
   const parsed = ContactSchema.parse(input);
   opts.signal?.throwIfAborted();
@@ -2906,6 +2912,7 @@ async function contact(input, opts = {}) {
   const headers = { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}`, "x-paigy-model": "goal-entry-v1" };
   let deliveryId;
   let deliveries = [];
+  let recorded = [];
   if ("deliveryId" in parsed) {
     deliveryId = parsed.deliveryId;
   } else {
@@ -2934,19 +2941,24 @@ async function contact(input, opts = {}) {
     if (!res.ok) await fail("batch contact", res);
     const receipt = await res.json();
     deliveries = receipt.deliveries ?? [];
-    if (deliveries.length === 0 && receipt.recorded?.length) {
-      return { recorded: receipt.recorded, message: receipt.message ?? "Recorded as progress on its Goal; nothing was sent to the person." };
-    }
+    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);
+  const all = deliveries.filter((d) => !!d.deliveryId && !!d.goalId).map(({ id, deliveryId: deliveryId2, goalId }) => ({ ...id ? { id } : {}, deliveryId: deliveryId2, goalId }));
+  const joinedCard = deliveries[0]?.joinedCard === true;
   const read = async (signal2) => {
     const res = ensureAuthed(await send2(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
     if (!res.ok) await fail("read_delivery", res);
     const one = await res.json();
-    return all.length > 1 ? { ...one, deliveries: all } : one;
+    return {
+      ...one,
+      ...all.length > 1 ? { deliveries: all } : {},
+      ...recorded.length ? { recorded, notSent: NOT_SENT } : {},
+      ...joinedCard ? { joinedCard: true } : {}
+    };
   };
   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);
@@ -3044,6 +3056,7 @@ function goalView(g) {
   });
 }
 function deliveryView(d) {
+  const answers = "Answers land on the Goal: read them with claim_goal or get_goal. Do not poll this notification.";
   return compact({
     deliveryId: d.deliveryId,
     kind: d.kind,
@@ -3052,11 +3065,17 @@ function deliveryView(d) {
     conversation: conversation(d),
     // Each ask's own Delivery when a contact carried several — the only handle on the others.
     deliveries: d.deliveries,
-    next: d.kind === "notification" ? "Answers land on the Goal: read them with claim_goal or get_goal. Do not poll this notification." : d.message
+    // WHAT THIS CONTACT DID NOT SEND (#2450): asks the intake read kept as progress, by name.
+    recorded: d.recorded,
+    notSent: d.notSent,
+    joinedCard: d.joinedCard,
+    next: d.kind === "notification" ? d.joinedCard ? `Added to the open report card on its Goal; no new push was sent. ${answers}` : answers : d.message
   });
 }
 function repliesView(r) {
   const deliveries = r.deliveries ?? [];
+  const assigned = r.assigned ?? [];
+  const review = r.review ?? [];
   const stalled = r.stalled ?? [];
   const others = r.stalledOthers ?? [];
   return {
@@ -3067,13 +3086,21 @@ function repliesView(r) {
       openDecisions: d.decisionNeeds.filter((n) => n.state === "open").length || void 0,
       latest: "about" in d ? d.about : void 0
     })),
+    // WORK ASSIGNED TO YOU (owner, 2026-09-24): your Goals nobody has started, however they
+    // became yours — a Goal handed to you is not a Delivery, and must not wait for a claim to be seen.
+    ...assigned.length ? { assigned } : {},
+    // NEW ON YOUR GOALS (owner, 2026-09-23): a reply is an Entry on the Goal, not a Delivery, so the
+    // Goals flagged for your review are listed here until you acknowledge them.
+    ...review.length ? { review } : {},
     // YOUR STALLED WORK (#2257): Goals you own with no progress for three days. Named here so an
     // agent that reads its replies also sees what it left, and says what to do about each.
     ...stalled.length ? { stalled } : {},
     // OTHER AGENTS' STALLED WORK (owner, 2026-09-23): any agent may take it over and close it.
     ...others.length ? { stalledOthers: others } : {},
     next: [
-      deliveries.length ? "Act on a Goal with claim_goal; reread one Delivery in full with contact({deliveryId})." : "Nothing is waiting.",
+      deliveries.length || review.length || assigned.length ? "Act on a Goal with claim_goal; reread one Delivery in full with contact({deliveryId})." : "Nothing is waiting.",
+      ...assigned.length ? [`${assigned.length} of your Goals are assigned to you and not started (assigned): claim_goal({goalId}) to start one.`] : [],
+      ...review.length ? [`${review.length} of your Goals have something new (review): read each with claim_goal or get_goal, then update_goal with reviewed: true.`] : [],
       ...stalled.length ? [`${stalled.length} of your Goals have had no progress for 3 days: update_goal each with progress, finish it, or cancel it.`] : [],
       ...others.length ? [`${others.length} of other agents' Goals have gone quiet for 3 days: claim_goal({goalId}) takes one over, then finish or cancel it with update_goal.`] : []
     ].join(" ")
@@ -3085,7 +3112,7 @@ async function runTool(name, args, opts) {
   switch (name) {
     case "contact": {
       const sent = await contact(input, { ...client, signal, waits });
-      return "recorded" in sent ? sent : deliveryView(sent);
+      return "sent" in sent ? sent : deliveryView(sent);
     }
     case "check_replies":
       CheckRepliesSchema.parse(input);
@@ -3113,47 +3140,108 @@ async function runTool(name, args, opts) {
 var HEARTBEAT_MS = 25e3;
 var RETRY_MS = [1e3, 2e3, 5e3, 1e4, 3e4];
 var JOIN = { config: { broadcast: { self: false } } };
+var JOIN_TIMEOUT_MS = 1e4;
 var lines = /* @__PURE__ */ new Map();
 function frame(line, topic, event, payload) {
+  const ref = String(++line.ref);
   try {
-    line.ws?.send(JSON.stringify({ topic, event, payload, ref: String(++line.ref) }));
+    line.ws?.send(JSON.stringify({ topic, event, payload, ref }));
   } catch {
   }
+  return ref;
 }
 function stop(line) {
   line.open = false;
+  line.beat = void 0;
   clearInterval(line.heart);
   clearTimeout(line.retry);
+  for (const t of line.topics.values()) {
+    clearTimeout(t.timer);
+    t.joined = false;
+    t.ref = void 0;
+  }
+}
+function join3(line, name, t) {
+  clearTimeout(t.timer);
+  t.joined = false;
+  t.ref = frame(line, `realtime:${name}`, "phx_join", JOIN);
+  t.timer = setTimeout(() => rejoin(line, name, t), JOIN_TIMEOUT_MS);
+}
+function rejoin(line, name, t) {
+  clearTimeout(t.timer);
+  t.joined = false;
+  t.ref = void 0;
+  if (!line.open || line.topics.get(name) !== t) return;
+  t.timer = setTimeout(() => {
+    if (line.open && line.topics.get(name) === t) join3(line, name, t);
+  }, RETRY_MS[Math.min(t.attempt++, RETRY_MS.length - 1)]);
+}
+function joined(t) {
+  clearTimeout(t.timer);
+  t.joined = true;
+  t.attempt = 0;
+  for (const l of t.listeners) l.onJoined?.(++l.joins);
 }
 function connect(line) {
   const base = line.url.replace(/^http/, "ws").replace(/\/+$/, "");
   const ws = line.ws = new WebSocket(`${base}/realtime/v1/websocket?apikey=${encodeURIComponent(line.anonKey)}&vsn=1.0.0`);
+  let gone = false;
+  const again = () => {
+    if (gone) return;
+    gone = true;
+    stop(line);
+    if (!line.topics.size) return;
+    line.retry = setTimeout(() => connect(line), RETRY_MS[Math.min(line.attempt++, RETRY_MS.length - 1)]);
+  };
   ws.addEventListener("open", () => {
+    if (gone) return;
     line.open = true;
     line.attempt = 0;
-    for (const topic of line.topics.keys()) frame(line, `realtime:${topic}`, "phx_join", JOIN);
-    line.heart = setInterval(() => frame(line, "phoenix", "heartbeat", {}), HEARTBEAT_MS);
+    for (const [name, t] of line.topics) join3(line, name, t);
+    line.heart = setInterval(() => {
+      if (line.beat) {
+        try {
+          ws.close();
+        } catch {
+        }
+        again();
+        return;
+      }
+      line.beat = frame(line, "phoenix", "heartbeat", {});
+    }, HEARTBEAT_MS);
   });
   ws.addEventListener("message", (e) => {
+    if (gone) return;
     let m;
     try {
       m = JSON.parse(String(e.data));
     } catch {
       return;
     }
-    if (m.event !== "broadcast" || !m.topic?.startsWith("realtime:")) return;
-    for (const l of line.topics.get(m.topic.slice("realtime:".length)) ?? []) {
+    if (m.topic === "phoenix") {
+      if (m.event === "phx_reply" && m.ref === line.beat) line.beat = void 0;
+      return;
+    }
+    if (!m.topic?.startsWith("realtime:")) return;
+    const name = m.topic.slice("realtime:".length);
+    const t = line.topics.get(name);
+    if (!t) return;
+    if (m.event === "phx_reply") {
+      if (!t.ref || m.ref !== t.ref) return;
+      if (m.payload?.status === "ok") joined(t);
+      else rejoin(line, name, t);
+      return;
+    }
+    if (m.event === "phx_error" || m.event === "phx_close") {
+      if (m.ref && m.ref !== t.ref) return;
+      rejoin(line, name, t);
+      return;
+    }
+    if (m.event !== "broadcast") return;
+    for (const l of t.listeners) {
       if (m.payload?.event === l.event) l.onMessage(m.payload.payload);
     }
   });
-  let gone = false;
-  const again = () => {
-    if (gone) return;
-    gone = true;
-    stop(line);
-    if (!line.topics.size) return;
-    line.retry = setTimeout(() => connect(line), RETRY_MS[Math.min(line.attempt++, RETRY_MS.length - 1)]);
-  };
   ws.addEventListener("close", again);
   ws.addEventListener("error", again);
 }
@@ -3161,17 +3249,22 @@ function subscribeRealtime(args) {
   const key = `${args.url} ${args.anonKey}`;
   let line = lines.get(key);
   if (!line) lines.set(key, line = { url: args.url, anonKey: args.anonKey, open: false, attempt: 0, ref: 0, topics: /* @__PURE__ */ new Map() });
-  let heard = line.topics.get(args.topic);
-  if (!heard) {
-    line.topics.set(args.topic, heard = /* @__PURE__ */ new Set());
-    if (line.open) frame(line, `realtime:${args.topic}`, "phx_join", JOIN);
-  }
-  const me = { event: args.event, onMessage: args.onMessage };
-  heard.add(me);
+  let t = line.topics.get(args.topic);
+  if (!t) {
+    line.topics.set(args.topic, t = { listeners: /* @__PURE__ */ new Set(), joined: false, attempt: 0 });
+    if (line.open) join3(line, args.topic, t);
+  }
+  const topic = t;
+  const me = { event: args.event, onMessage: args.onMessage, onJoined: args.onJoined, joins: 0 };
+  topic.listeners.add(me);
+  if (topic.joined && me.onJoined) queueMicrotask(() => {
+    if (topic.joined && topic.listeners.has(me)) me.onJoined?.(++me.joins);
+  });
   if (!line.ws) connect(line);
   return {
     close: () => {
-      if (!heard.delete(me) || heard.size) return;
+      if (!topic.listeners.delete(me) || topic.listeners.size) return;
+      clearTimeout(topic.timer);
       line.topics.delete(args.topic);
       if (line.topics.size) {
         if (line.open) frame(line, `realtime:${args.topic}`, "phx_leave", {});
@@ -3187,7 +3280,7 @@ function subscribeRealtime(args) {
   };
 }
 async function subscribeWake(onNudge, opts = {}) {
-  const { release = true, ...client } = opts;
+  const { release = true, onJoined, ...client } = opts;
   const cfg = await registerDelivery("self_hosted", client);
   const { url, anonKey } = cfg.realtime;
   const channel = wakeChannel(cfg.tokenId);
@@ -3196,7 +3289,8 @@ async function subscribeWake(onNudge, opts = {}) {
     anonKey,
     topic: channel,
     event: WAKE_EVENT,
-    onMessage: (payload) => onNudge(payload ?? {})
+    onMessage: (payload) => onNudge(payload ?? {}),
+    onJoined
   });
   return {
     tokenId: cfg.tokenId,

package/dist/{dist-DKP3DJQJ.js → dist-PJLF3B27.js}

@@ -52,7 +52,7 @@ import {
   updateGoal,
   updateSlot,
   whoAmI
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 export {
   AGENT_TOOLS,
   AGENT_TOOL_NAMES,

package/dist/enable.js

@@ -3,9 +3,9 @@ import {
   PAIGY_TOOL_IDS,
   enablePaigyTools,
   installSessionListening
-} from "./chunk-37FS33UP.js";
-import "./chunk-SE2JCKDI.js";
-import "./chunk-PHTQITTC.js";
+} from "./chunk-7VLZIOLF.js";
+import "./chunk-MWHYYLCE.js";
+import "./chunk-V5AQASR7.js";
 
 // src/enable.ts
 function main() {

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-X6G7XXCP.js";
+} from "./chunk-UIZLBPRG.js";
 import {
   ENABLE_COMMAND,
   OnboardSchema,
@@ -14,11 +14,11 @@ import {
   SERVER_INSTRUCTIONS,
   TOOLS,
   paigyToolsAllowlisted
-} from "./chunk-37FS33UP.js";
+} from "./chunk-7VLZIOLF.js";
 import {
   decideListen,
   listenerAlive
-} from "./chunk-SE2JCKDI.js";
+} from "./chunk-MWHYYLCE.js";
 import {
   clearSurface,
   writeSurface
@@ -39,7 +39,7 @@ import {
   setIdentity,
   slotName,
   whoAmI
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";

package/dist/listen.js

@@ -3,7 +3,7 @@ import {
   entryWords,
   removeListenMark,
   writeListenMark
-} from "./chunk-SE2JCKDI.js";
+} from "./chunk-MWHYYLCE.js";
 import {
   agentName,
   checkReplies,
@@ -11,7 +11,7 @@ import {
   getGoal,
   slotName,
   subscribeWake
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/listen.ts
 import { spawn } from "child_process";
@@ -133,11 +133,16 @@ function leadOf(deliveries, goalId) {
 function brief(waiting, reason, as, goalId) {
   const lead = leadOf(waiting.deliveries, goalId);
   const stalled = waiting.stalled?.length ? ` \xB7 ${waiting.stalled.length} of your Goals stalled 3+ days: update, finish or cancel each` : "";
-  if (!lead) return (reason === "boot" ? `Paigy \xB7 listening as ${as} \xB7 nothing waiting` : `Paigy \xB7 ${reason} \xB7 nothing waiting`) + stalled;
+  const review = waiting.review ?? [];
+  const named = (goalId ? review.find((g) => g.goalId === goalId) : void 0) ?? review[0];
+  const fresh = review.length ? ` \xB7 new on ${review.length === 1 ? "your Goal" : `${review.length} of your Goals`}, first ${named.goalId} ("${named.title}"): claim_goal to read it` : "";
+  const assigned = waiting.assigned ?? [];
+  const mine = assigned.length ? ` \xB7 assigned to you: ${assigned.length === 1 ? "1 Goal" : `${assigned.length} Goals`}, first ${assigned[0].goalId} ("${assigned[0].title}"): claim_goal({goalId}) to start it` : "";
+  if (!lead) return `Paigy \xB7 ${reason === "boot" ? `listening as ${as}` : reason}${mine}${fresh || (mine ? "" : " \xB7 nothing waiting")}${stalled}`;
   const said = saidIn(lead) || ("about" in lead ? lead.about : "");
   const shown = said.length > 160 ? `${said.slice(0, 160)}\u2026` : said;
   const goal = waiting.goal?.goalId ?? lead.goalIds[0];
-  return `Paigy \xB7 ${reason} \xB7 ${waiting.deliveries.length} waiting \xB7 lead ${lead.deliveryId} on Goal ${goal}: "${shown}"${stalled}`;
+  return `Paigy \xB7 ${reason} \xB7 ${waiting.deliveries.length} waiting \xB7 lead ${lead.deliveryId} on Goal ${goal}: "${shown}"${mine}${fresh}${stalled}`;
 }
 function launchEnv(waiting, reason, goalId) {
   const env = { PAIGY_WORK: JSON.stringify(waiting), PAIGY_EVENT: reason };
@@ -154,16 +159,16 @@ function launchEnv(waiting, reason, goalId) {
 async function sweep(reason, goalId) {
   try {
     const cmd = process.env.PAIGY_ON_WAKE;
-    const { deliveries: rows, stalled } = await checkReplies();
+    const { deliveries: rows, stalled, review, assigned } = await checkReplies();
     const lead = leadOf(rows, goalId);
-    const full = lead ? await contact({ deliveryId: lead.deliveryId }, { waits: false }).then((d) => "recorded" in d ? null : d).catch(() => null) : null;
+    const full = lead ? await contact({ deliveryId: lead.deliveryId }, { waits: false }).then((d) => "sent" in d ? null : d).catch(() => null) : null;
     const deliveries = rows.map((d) => d === lead && full ? full : d);
     const leadGoalId = lead?.goalIds[0];
     const goal = leadGoalId ? await getGoal(leadGoalId).then((g) => ({ goalId: leadGoalId, progress: g.progress })).catch(() => null) : null;
-    const waiting = { deliveries, goal, ...stalled?.length ? { stalled } : {} };
+    const waiting = { deliveries, goal, ...stalled?.length ? { stalled } : {}, ...review?.length ? { review } : {}, ...assigned?.length ? { assigned } : {} };
     if (BRIEF) line(brief(waiting, reason, listeningAs(), goalId));
     else emit({ type: "sweep", reason, ...goalId ? { about: goalId } : {}, ...waiting });
-    if (cmd && (deliveries.length || reason === "boot" && waiting.stalled?.length)) {
+    if (cmd && (deliveries.length || waiting.review?.length || waiting.assigned?.length || reason === "boot" && waiting.stalled?.length)) {
       spawn(cmd, { shell: true, stdio: "inherit", env: { ...process.env, ...launchEnv(waiting, reason, goalId) } });
     }
   } catch (e) {
@@ -171,8 +176,17 @@ async function sweep(reason, goalId) {
     else emit({ type: "error", reason, message: e.message });
   }
 }
+function catchUpReason(joins) {
+  return joins > 1 ? "resubscribed" : null;
+}
 async function main() {
-  const sub = await subscribeWake((nudge) => void sweep(`wake:${nudge.kind ?? "?"}`, nudge.parentId), { release: RELEASE });
+  const sub = await subscribeWake((nudge) => void sweep(`wake:${nudge.kind ?? "?"}`, nudge.parentId), {
+    release: RELEASE,
+    onJoined: (joins) => {
+      const reason = catchUpReason(joins);
+      if (reason) void sweep(reason);
+    }
+  });
   const slot = agentName();
   writeListenMark(slot, process.pid);
   process.on("exit", () => removeListenMark(slot));
@@ -211,6 +225,7 @@ if (isEntry()) {
 }
 export {
   brief,
+  catchUpReason,
   launchEnv,
   leadOf,
   listenOptions,

package/dist/onboard.js

@@ -3,13 +3,13 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-X6G7XXCP.js";
+} from "./chunk-UIZLBPRG.js";
 import {
   autoConfigureClients,
   claudeInstallHint,
   openBrowser
-} from "./chunk-37FS33UP.js";
-import "./chunk-SE2JCKDI.js";
+} from "./chunk-7VLZIOLF.js";
+import "./chunk-MWHYYLCE.js";
 import {
   TOKEN_PATH,
   agentName,
@@ -20,7 +20,7 @@ import {
   saveToken,
   setIdentity,
   whoAmI
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/onboard.ts
 function reportRegistered() {

package/dist/slot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   agentName
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/slot.ts
 process.stdout.write(agentName());

package/dist/stalled.js

@@ -22,7 +22,7 @@ async function main() {
   const dir = join(homedir(), ".paigy", "stalled-reminded");
   const mark = join(dir, `${session || "session"}-${day}`);
   if (existsSync(mark)) return;
-  const { checkReplies } = await import("./dist-DKP3DJQJ.js");
+  const { checkReplies } = await import("./dist-PJLF3B27.js");
   const reply = stopReply((await checkReplies()).stalled ?? []);
   if (!reply) return;
   mkdirSync(dir, { recursive: true });

package/dist/statusline.js

@@ -7,7 +7,7 @@ import {
   readToken,
   sessionSlot,
   slotName
-} from "./chunk-PHTQITTC.js";
+} from "./chunk-V5AQASR7.js";
 
 // src/statusline.ts
 import { realpathSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/mcp",
-  "version": "0.40.15",
+  "version": "0.40.17",
   "description": "Paigy MCP server — the AI agent harness that calls you. Lets an agent notify a user and await their reply.",
   "license": "MIT",
   "type": "module",