@paigy/mcp 0.40.14 → 0.40.15

package/README.md

@@ -215,6 +215,20 @@ script and branch on `$PAIGY_EVENT` there:
 codex exec "Paigy goal $PAIGY_GOAL_ID. claim_goal it first. The user said: $PAIGY_TEXT. Reply with contact when done."
 ```
 
+## Stalled work (Claude Code stop hook)
+
+An agent that goes quiet leaves its Goals behind. Three things hand it that work back, all
+reading one rule (no progress for 3 days, `COLD_AFTER_MS`): `check_replies` lists it under
+`stalled`, `paigy-listen` carries it in `PAIGY_WORK` (and launches for it on boot), and this
+hook holds a Claude Code session's stop once a day to list it:
+
+```json
+{ "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y -p @paigy/mcp paigy-stalled" }] }] } }
+```
+
+It is silent when nothing is stalled, when the stop is already being continued by a hook, and
+after it has reminded that session once today.
+
 ## Statusline (Claude Code)
 
 `paigy-statusline` prints which Paigy identity this Claude Code session is, for the

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

@@ -4,10 +4,10 @@ import {
   serverInstructions,
   sessionStartHook,
   withSessionStartHook
-} from "./chunk-NOZRU5CD.js";
+} from "./chunk-SE2JCKDI.js";
 import {
   agentName
-} from "./chunk-R2GTL7N3.js";
+} from "./chunk-PHTQITTC.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-R2GTL7N3.js → chunk-PHTQITTC.js}

@@ -79,6 +79,9 @@ function isNetworkError(e) {
 async function reach(url, init) {
   return send(url, init, sessionId());
 }
+function reachAs(session) {
+  return (url, init) => send(url, init, session);
+}
 async function send(url, init, session) {
   try {
     const headers = {
@@ -1319,6 +1322,174 @@ var OptionSchema = z.object({
 var OptionInputSchema = OptionSchema.omit({ id: true }).extend({
   label: z.string().trim().min(1).max(1e3)
 }).strict();
+function tzOffsetMinutes(tz, atMs) {
+  try {
+    const dtf = new Intl.DateTimeFormat("en-US", {
+      timeZone: tz,
+      hour12: false,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit"
+    });
+    const p = {};
+    for (const { type, value } of dtf.formatToParts(new Date(atMs))) p[type] = value;
+    const asUtc = Date.UTC(
+      Number(p["year"]),
+      Number(p["month"]) - 1,
+      Number(p["day"]),
+      Number(p["hour"]) === 24 ? 0 : Number(p["hour"]),
+      Number(p["minute"]),
+      Number(p["second"])
+    );
+    return Math.round((asUtc - atMs) / 6e4);
+  } catch {
+    return null;
+  }
+}
+function instantAt(tz, local) {
+  const naive = Date.UTC(local.y, local.mo - 1, local.d, local.h, local.mi, 0);
+  const first = tzOffsetMinutes(tz, naive);
+  if (first === null) return null;
+  const guess = naive - first * 6e4;
+  const second = tzOffsetMinutes(tz, guess);
+  return second === null ? guess : naive - second * 6e4;
+}
+function localDate(tz, atMs) {
+  const off = tzOffsetMinutes(tz, atMs);
+  if (off === null) return null;
+  const shifted = new Date(atMs + off * 6e4);
+  return {
+    y: shifted.getUTCFullYear(),
+    mo: shifted.getUTCMonth() + 1,
+    d: shifted.getUTCDate(),
+    h: shifted.getUTCHours(),
+    mi: shifted.getUTCMinutes()
+  };
+}
+var PARTS = {
+  earliest: { morning: 8, afternoon: 13, evening: 18, night: 20, noon: 12, midday: 12, lunch: 13 },
+  ring: { morning: 9, afternoon: 13, evening: 18, night: 20, noon: 12, midday: 12, lunch: 13 }
+};
+var END_OF_DAY = 17;
+var VAGUE = /\b(later|in a bit|in a while)\b/i;
+var TODAY_ONLY = /\b(tonight|this evening)\b/i;
+var RELATIVE = /\bin\s+(a\s+couple\s+of|a\s+few|a|an|one|two|three|four|five|six|seven|eight|nine|ten|fifteen|twenty|thirty|forty|forty[- ]five|half\s+an|\d{1,3})\s*(minute|minutes|min|mins|hour|hours|hr|hrs|day|days|week|weeks)\b/i;
+var WORD_NUM = {
+  a: 1,
+  an: 1,
+  one: 1,
+  two: 2,
+  three: 3,
+  four: 4,
+  five: 5,
+  six: 6,
+  seven: 7,
+  eight: 8,
+  nine: 9,
+  ten: 10,
+  fifteen: 15,
+  twenty: 20,
+  thirty: 30,
+  forty: 40,
+  "forty-five": 45,
+  "forty five": 45,
+  // Vague-but-real quantities the SDK's parser read and this one did not (#1367). "A few"
+  // is deliberately small and "a couple" is exactly two — a caller who says either has
+  // named a rough size, and rounding it away to null loses the request entirely.
+  "a couple of": 2,
+  "a few": 3
+};
+var CLOCK = /\b(?:at\s+)?(\d{1,2})(?::(\d{2}))?\s*(a\.?m\.?|p\.?m\.?|o'?clock)?\b/i;
+var SPOKEN_HOUR = {
+  one: 1,
+  two: 2,
+  three: 3,
+  four: 4,
+  five: 5,
+  six: 6,
+  seven: 7,
+  eight: 8,
+  nine: 9,
+  ten: 10,
+  eleven: 11,
+  twelve: 12
+};
+function parseWhen(said2, tz, nowMs, read = "earliest") {
+  const text = said2.trim();
+  if (!text) return null;
+  const rel = RELATIVE.exec(text);
+  if (rel) {
+    const rawN = rel[1].toLowerCase();
+    const half = /half/.test(rawN);
+    const n = half ? 0.5 : WORD_NUM[rawN] ?? Number(rawN);
+    if (Number.isFinite(n) && n > 0) {
+      const unit = rel[2].toLowerCase();
+      const ms = unit.startsWith("min") ? n * 6e4 : unit.startsWith("h") ? n * 36e5 : unit.startsWith("d") ? n * 864e5 : n * 7 * 864e5;
+      return new Date(nowMs + ms).toISOString();
+    }
+  }
+  const today = localDate(tz, nowMs);
+  if (!today) return null;
+  let dayShift = /\btomorrow\b/i.test(text) ? 1 : 0;
+  if (/\bnext week\b/i.test(text)) dayShift = 7;
+  let hour = null;
+  let minute = 0;
+  const spoken = new RegExp(`\\bat\\s+(${Object.keys(SPOKEN_HOUR).join("|")})\\b`, "i").exec(text);
+  const clock2 = CLOCK.exec(text);
+  if (spoken) {
+    hour = SPOKEN_HOUR[spoken[1].toLowerCase()];
+  } else if (clock2 && (clock2[3] || /\bat\s/i.test(clock2[0]))) {
+    hour = Number(clock2[1]);
+    minute = clock2[2] ? Number(clock2[2]) : 0;
+    if (hour > 23 || minute > 59) return null;
+  }
+  if (hour !== null) {
+    const mer = clock2?.[3]?.toLowerCase().replace(/\./g, "") ?? "";
+    const pmWord = /\b(p\.?m\.?|afternoon|evening|tonight|at night)\b/i.test(text);
+    const amWord = /\b(a\.?m\.?|morning)\b/i.test(text);
+    if (mer.startsWith("p") || pmWord && !amWord) {
+      if (hour < 12) hour += 12;
+    } else if (mer.startsWith("a") || amWord) {
+      if (hour === 12) hour = 0;
+    } else if (hour < 12 && dayShift === 0 && hour <= today.h) hour += 12;
+  } else {
+    const parts = PARTS[read];
+    const part = Object.keys(parts).find((k) => new RegExp(`\\b${k}\\b`, "i").test(text));
+    if (/\btonight\b/i.test(text)) hour = parts["night"];
+    else if (part) hour = parts[part];
+    else if (dayShift > 0) hour = 9;
+    else if (/\bend of (the )?day\b|\beod\b/i.test(text)) hour = END_OF_DAY;
+    else if (read === "ring" && VAGUE.test(text)) return new Date(nowMs + 30 * 6e4).toISOString();
+    else return null;
+  }
+  const at2 = instantAt(tz, {
+    y: today.y,
+    mo: today.mo,
+    d: today.d + dayShift,
+    h: hour,
+    mi: minute
+  });
+  if (at2 === null) return null;
+  if (at2 <= nowMs && dayShift === 0 && TODAY_ONLY.test(text)) {
+    return new Date(nowMs + 36e5).toISOString();
+  }
+  const rolled = at2 <= nowMs && dayShift === 0 ? instantAt(tz, {
+    y: today.y,
+    mo: today.mo,
+    d: today.d + 1,
+    h: hour,
+    mi: minute
+  }) : at2;
+  return new Date(rolled ?? at2).toISOString();
+}
+function parseDelay(said2, tz, nowMs, read = "earliest") {
+  const at2 = parseWhen(said2, tz, nowMs, read);
+  if (!at2) return null;
+  return Math.max(0, Math.round((Date.parse(at2) - nowMs) / 1e3));
+}
 var NIGHT = { from: 23, to: 7 };
 function draft2020(node) {
   if (Array.isArray(node)) return node.map(draft2020);
@@ -1354,7 +1525,7 @@ var AskInputSchema = z2.object({
   parentId: z2.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 Paigy places the question in the tree itself."),
   repo: z2.string().optional().describe("Optional repository context."),
   ask: z2.string().trim().min(1).max(1e4).describe(
-    "The question, and only what is needed to answer it. News, progress and findings are their own contact \u2014 a call contact JOINS a call already happening, so several arrive as one call. Do not bundle: a DecisionNeed is settled only by an answer in the shape this ask declares, so someone who answers the part that interested them settles nothing and is asked again."
+    "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 reads every ask once and takes a bundled one apart into its own cards anyway \u2014 parts of one piece of work under one Goal, separate things as separate Goals \u2014 but the words it splits are its reading, not yours. News, progress and findings are their own contact; a call contact JOINS a call already happening, so several arrive as one call."
   ),
   options: z2.array(OptionInputSchema).min(2).max(6).optional()
 }).strict();
@@ -1365,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}. Never bundle multiple questions into a single 'ask' string; pass them as separate objects in the 'asks' array.";
+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 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
@@ -1413,7 +1584,7 @@ var ClaimGoalSchema = z3.object({ goalId: z3.string().uuid().optional() }).stric
 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 CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
+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 CheckRepliesSchema = z3.object({}).strict();
 var AGENT_TOOLS = [
@@ -1796,32 +1967,6 @@ var AgendaTurnSchema = z4.object({
 var CLAIM_STALE_MS = 30 * 6e4;
 var InboxItemSchema = z4.object({
   id: z4.string(),
-  /** The conversation thread + connection this item lives on. Present on the replied
-   *  detail — they power History's "Continue" / "New session from this" (#57/#251). */
-  parentId: z4.string().optional(),
-  /** THE ARRIVAL this row is one unit of (`notifications.ask_id` → `asks`). A claim is one
-   *  arrival and its units are N rows of it, so this — not `parentId` — is what makes a
-   *  multi-part notification one thing on screen. The thread is the whole CONVERSATION: it
-   *  accumulates every message an agent ever sent, so grouping by it renders a day of
-   *  unrelated updates as a single "12-part request". Absent on rows written before the
-   *  `asks` table, and on anything that never went through `notify` — both fall back to the
-   *  thread, which is what the client did for all rows until now. */
-  askId: z4.string().optional(),
-  /** WHERE this unit sat in the message it was cut from (`notifications.seq`). The batch
-   *  shares one `created_at` to the microsecond, so without it the author's order is
-   *  unrecoverable client-side — a four-paragraph briefing rendered opening-paragraph-last
-   *  (live 2026-08-10, D35). The API already orders by it; this lets a reader that
-   *  re-sorts (grouping, filtering) put an arrival back in the order it was written. */
-  seq: z4.number().int().optional(),
-  /** HOW MANY units the arrival was cut into. A device reads a LENS, never the arrival —
-   *  `/api/inbox` serves `open`, so the units already settled are gone from it — and a client
-   *  counting what it can see is counting what is LEFT. Walking a three-unit ask on the answer
-   *  screen read "1 of 3", then "1 of 2", then no chip at all, each answer having removed the
-   *  only evidence of itself. How big an arrival is, is a fact about the arrival, so the
-   *  server that can still see every row states it. Absent on any row with no `askId`: a
-   *  unit knows WHICH ask it came from and WHERE it sat in it, and how many there were is
-   *  the one part of its own arrival a single row cannot answer. */
-  units: z4.number().int().positive().optional(),
   tokenId: z4.string().optional(),
   status: NotifyStatusSchema,
   context: ContextSchema,
@@ -1866,7 +2011,12 @@ var InboxItemSchema = z4.object({
     entryId: z4.string(),
     title: z4.string(),
     state: z4.enum(["open", "answered"]),
-    answer: z4.string().nullable()
+    answer: z4.string().nullable(),
+    /** WHO ASKED IT (owner, 2026-09-23, Goal a345e906: each agenda row wears its agent's face) — the
+     *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
+     *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
+     *  author is not an agent this account holds (unpaired since, or a person). */
+    agent: z4.object({ tokenId: z4.string(), name: z4.string(), voice: VoiceKeySchema.optional() }).optional()
   })).optional(),
   visuals: z4.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -1884,9 +2034,14 @@ var InboxItemSchema = z4.object({
    *  agent (held in the inbox until the agent replies on the thread). */
   turn: z4.enum(["you", "agent"]).default("you"),
   /** Hard error reason on an awaiting request (turn="agent") — the wake failed to reach
-   *  the agent (provider-agnostic; set server-side). Absent = no hard error, though the
-   *  client may still flag a stall by age. Drives the inbox error badge + Retry. */
+   *  the agent (provider-agnostic; set server-side). Absent = no hard error. Drives the inbox
+   *  error badge + Retry. */
   error: z4.string().optional(),
+  /** WHEN THIS AGENT WORK WENT QUIET (turn="agent"), by the one rule (`coldSince`: three days
+   *  with nothing said), or absent while it is not stalled. The inbox's stalled badge reads
+   *  this and nothing else (2026-09-23: a 3-minute age rule badged every live Goal stalled,
+   *  and "dismiss the stalled ones" cancelled 37 pieces of live work). */
+  cold: z4.string().datetime().optional(),
   clarifies: z4.string().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
@@ -1936,7 +2091,10 @@ var InboxItemSchema = z4.object({
     goalIds: z4.array(z4.string()),
     decisionNeedId: z4.string().optional(),
     sealed: z4.boolean(),
-    goalState: z4.string().optional()
+    goalState: z4.string().optional(),
+    /** THAT GOAL'S NAME (#2416) — what Activity's row is headed by, since a row there is one Goal
+     *  and the cards it holds sit behind it. Stamped by the same read as `goalState`. */
+    goalTitle: z4.string().optional()
   }).optional()
 });
 var APNS_TOKEN_RE = /^[0-9a-fA-F]{64}$/;
@@ -2035,7 +2193,6 @@ var UserSettingsSchema = z4.object({
 });
 var HistoryItemSchema = z4.object({
   id: z4.string(),
-  parentId: z4.string(),
   /** 'user' = a request you sent; 'agent' = a notification an agent sent you. */
   initiator: z4.enum(["user", "agent"]),
   title: z4.string(),
@@ -2194,6 +2351,24 @@ var QueueQuestionSchema = z4.object({
    *  gate at all. */
   blocked: z4.boolean().default(false)
 });
+var QueueReplySchema = z4.object({
+  /** The card this note was (`deliveryId:requestEntryId`, minted by the server like every card
+   *  id) — so the phone can tell a reply it just sent from one the queue already carries, and the
+   *  walk can name it in its zoom. */
+  id: z4.string(),
+  /** The Goal the note is on. */
+  goalId: z4.string(),
+  /** What the note said. */
+  note: z4.string(),
+  /** Where it was carried — where a second reply goes (`POST /api/entries`, #2252). */
+  deliveryId: z4.string(),
+  requestEntryId: z4.string(),
+  askedAt: z4.string(),
+  /** When the person last replied — the window's start. */
+  repliedAt: z4.string(),
+  /** The person's latest words about it; null when there is nothing readable in them. */
+  reply: z4.string().nullable()
+});
 var QueueItemSchema = z4.object({
   id: z4.string(),
   /** One-line headline — the first sentence of the outcome. */
@@ -2221,6 +2396,10 @@ var QueueItemSchema = z4.object({
   blocked: z4.boolean().default(false),
   /** Every decision need on it, open or settled — the page decides which to show. */
   questions: z4.array(QueueQuestionSchema).default([]),
+  /** Every note on it the person replied to (`QueueReplySchema`) — the page decides which to show.
+   *  Optional, not defaulted: absent is none, and every hand-built queue (fixtures, the demo) need
+   *  not spell an empty list. */
+  replies: z4.array(QueueReplySchema).optional(),
   /** The repository or project identifier this Goal belongs to (#2280), null if untracked. */
   repo: z4.string().nullable().optional(),
   createdAt: z4.string(),
@@ -2413,6 +2592,7 @@ function sessionSlot(sessionId2) {
 function agentName() {
   return process.env.PAIGY_AGENT || sessionSlot();
 }
+var PROTO = "paigy-pair-v2|sas=24";
 var TOKEN_PATH = join2(homedir2(), ".paigy", "token.json");
 var KEY_PATH = join2(homedir2(), ".paigy", "key.json");
 function readTokenFile() {
@@ -2453,6 +2633,20 @@ function saveToken(token, agent2 = agentName()) {
     writeFileSync(TOKEN_PATH, JSON.stringify(slots, null, 2) + "\n", { mode: 384 });
   });
 }
+function updateSlot(agent2, patch) {
+  return withTokenLock(() => {
+    const slots = readTokenFile();
+    const existing = slots[agent2];
+    if (!existing) return false;
+    slots[agent2] = { ...existing, ...patch };
+    writeFileSync(TOKEN_PATH, JSON.stringify(slots, null, 2) + "\n", { mode: 384 });
+    return true;
+  });
+}
+function slotIdentity(agent2) {
+  const t = readTokenFile()[agent2];
+  return { name: t?.name ?? null, voice: t?.voice ?? null, tokenId: t?.token_id ?? null, workspace: t?.workspace ?? null };
+}
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 function readToken(agent2 = agentName()) {
   if (process.env.PAIGY_TOKEN) return process.env.PAIGY_TOKEN;
@@ -2603,6 +2797,14 @@ async function setIdentity(patch, opts = {}) {
   if (!res.ok) throw new Error(`set_identity failed: ${res.status} ${await res.text()}`);
   return await res.json();
 }
+async function claimSessions(opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/sessions/claim`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+    // the HOST's identity
+  }));
+  if (!res.ok) throw new Error(`claim_sessions failed: ${res.status}`);
+  return (await res.json()).sessions;
+}
 async function heartbeat(runtime, opts = {}) {
   const body = {
     ...runtime !== void 0 ? { runtime } : {},
@@ -2624,6 +2826,53 @@ async function registerDelivery(mode, opts = {}) {
   if (!res.ok) throw new Error(`register_delivery failed: ${res.status} ${await res.text()}`);
   return await res.json();
 }
+async function listNotes(opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/notes`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+  }));
+  if (!res.ok) throw new Error(`list_notes failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
+async function listConnections(opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/tokens`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}`, "x-paigy-model": "goal-entry-v1" }
+  }));
+  if (!res.ok) throw new Error(`list_connections failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
+async function submitTriage(run, opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/triage`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token)}` },
+    body: JSON.stringify(run)
+  }));
+  if (!res.ok) throw new Error(`submit_triage failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
+async function getTriage(opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/triage`, {
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+  }));
+  if (!res.ok) throw new Error(`get_triage failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
+async function acceptTriage(proposalId, body, opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/triage/${encodeURIComponent(proposalId)}/accept`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token)}` },
+    body: JSON.stringify(body)
+  }));
+  if (!res.ok) throw new Error(`accept_triage failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
+async function dismissTriage(proposalId, opts = {}) {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/triage/${encodeURIComponent(proposalId)}/dismiss`, {
+    method: "POST",
+    headers: { authorization: `Bearer ${authToken(opts.token)}` }
+  }));
+  if (!res.ok) throw new Error(`dismiss_triage failed: ${res.status} ${await res.text()}`);
+  return await res.json();
+}
 function repoFromRemote(url) {
   const said = (url ?? "").trim();
   if (!said) return null;
@@ -2685,6 +2934,9 @@ 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." };
+    }
     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");
@@ -2776,6 +3028,14 @@ function goalView(g) {
     owner: g.ownerParticipant,
     parentGoalId: g.parentGoalId,
     childGoalIds: g.childGoalIds,
+    // EVERYTHING BELOW, read through this Goal (umbrella reads): one line per Goal, indented by
+    // depth, then each question with its answer — so an agent that asked through an umbrella
+    // reads every answer in one call, whoever owns the child it landed on.
+    subtree: g.subtree?.length ? g.subtree.map((c) => compact({
+      goal: `${"  ".repeat(c.depth - 1)}${c.title} (${c.state})`,
+      goalId: c.goalId,
+      questions: c.questions.length ? c.questions.map((q) => q.answer ? `${q.question} \u2192 ${q.answer}` : `${q.question} \u2192 (open)`) : void 0
+    })) : void 0,
     blockedBy: g.blockedDependencyGoalIds,
     dueAt: g.dueAt,
     leaseExpiresAt: g.leaseExpiresAt,
@@ -2797,6 +3057,8 @@ function deliveryView(d) {
 }
 function repliesView(r) {
   const deliveries = r.deliveries ?? [];
+  const stalled = r.stalled ?? [];
+  const others = r.stalledOthers ?? [];
   return {
     deliveries: deliveries.map((d) => compact({
       deliveryId: d.deliveryId,
@@ -2805,15 +3067,26 @@ function repliesView(r) {
       openDecisions: d.decisionNeeds.filter((n) => n.state === "open").length || void 0,
       latest: "about" in d ? d.about : void 0
     })),
-    next: deliveries.length ? "Act on a Goal with claim_goal; reread one Delivery in full with contact({deliveryId})." : "Nothing is waiting."
+    // 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.",
+      ...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(" ")
   };
 }
 async function runTool(name, args, opts) {
   const { waits, signal, ...client } = opts;
   const input = args ?? {};
   switch (name) {
-    case "contact":
-      return deliveryView(await contact(input, { ...client, signal, waits }));
+    case "contact": {
+      const sent = await contact(input, { ...client, signal, waits });
+      return "recorded" in sent ? sent : deliveryView(sent);
+    }
     case "check_replies":
       CheckRepliesSchema.parse(input);
       return repliesView(await checkReplies(client));
@@ -2935,14 +3208,37 @@ async function subscribeWake(onNudge, opts = {}) {
     }
   };
 }
+function parseDue(detail, now = /* @__PURE__ */ new Date()) {
+  const tz = machineZone();
+  if (!tz) return null;
+  return parseDelay(detail, tz, now.getTime(), "ring");
+}
+function machineZone() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
+  } catch {
+    return null;
+  }
+}
 
 export {
+  BACKEND_URL,
+  NETWORK_MSG,
   sessionId,
   isNetworkError,
+  reach,
+  reachAs,
+  AGENT_TOOLS,
+  AGENT_TOOL_NAMES,
+  NotifyRequestSchema,
   sessionSlot,
   agentName,
+  PROTO,
   TOKEN_PATH,
+  KEY_PATH,
   saveToken,
+  updateSlot,
+  slotIdentity,
   sleep,
   readToken,
   listSlots,
@@ -2952,14 +3248,31 @@ export {
   requestCode,
   pollToken,
   UnpairedError,
+  ApiError,
   overrideToken,
+  authToken,
+  createGoal,
+  claimGoal,
   getGoal,
+  updateGoal,
+  AWAIT_WINDOW_MS,
   hatch,
   whoAmI,
   setIdentity,
+  claimSessions,
   heartbeat,
+  registerDelivery,
+  listNotes,
+  listConnections,
+  submitTriage,
+  getTriage,
+  acceptTriage,
+  dismissTriage,
+  repoFromRemote,
+  currentRepo,
   contact,
   checkReplies,
   runTool,
-  subscribeWake
+  subscribeWake,
+  parseDue
 };

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

@@ -57,7 +57,7 @@ var AskInputSchema = z2.object({
   parentId: z2.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 Paigy places the question in the tree itself."),
   repo: z2.string().optional().describe("Optional repository context."),
   ask: z2.string().trim().min(1).max(1e4).describe(
-    "The question, and only what is needed to answer it. News, progress and findings are their own contact \u2014 a call contact JOINS a call already happening, so several arrive as one call. Do not bundle: a DecisionNeed is settled only by an answer in the shape this ask declares, so someone who answers the part that interested them settles nothing and is asked again."
+    "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 reads every ask once and takes a bundled one apart into its own cards anyway \u2014 parts of one piece of work under one Goal, separate things as separate Goals \u2014 but the words it splits are its reading, not yours. News, progress and findings are their own contact; a call contact JOINS a call already happening, so several arrive as one call."
   ),
   options: z2.array(OptionInputSchema).min(2).max(6).optional()
 }).strict();
@@ -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}. Never bundle multiple questions into a single 'ask' string; pass them as separate objects in the 'asks' array.";
+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 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
@@ -116,7 +116,7 @@ var ClaimGoalSchema = z3.object({ goalId: z3.string().uuid().optional() }).stric
 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 CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Returns the Goal as get_goal reads it, and creates or renews the execution lease.";
+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 CheckRepliesSchema = z3.object({}).strict();
 var AGENT_TOOLS = [
@@ -509,32 +509,6 @@ var AgendaTurnSchema = z4.object({
 var CLAIM_STALE_MS = 30 * 6e4;
 var InboxItemSchema = z4.object({
   id: z4.string(),
-  /** The conversation thread + connection this item lives on. Present on the replied
-   *  detail — they power History's "Continue" / "New session from this" (#57/#251). */
-  parentId: z4.string().optional(),
-  /** THE ARRIVAL this row is one unit of (`notifications.ask_id` → `asks`). A claim is one
-   *  arrival and its units are N rows of it, so this — not `parentId` — is what makes a
-   *  multi-part notification one thing on screen. The thread is the whole CONVERSATION: it
-   *  accumulates every message an agent ever sent, so grouping by it renders a day of
-   *  unrelated updates as a single "12-part request". Absent on rows written before the
-   *  `asks` table, and on anything that never went through `notify` — both fall back to the
-   *  thread, which is what the client did for all rows until now. */
-  askId: z4.string().optional(),
-  /** WHERE this unit sat in the message it was cut from (`notifications.seq`). The batch
-   *  shares one `created_at` to the microsecond, so without it the author's order is
-   *  unrecoverable client-side — a four-paragraph briefing rendered opening-paragraph-last
-   *  (live 2026-08-10, D35). The API already orders by it; this lets a reader that
-   *  re-sorts (grouping, filtering) put an arrival back in the order it was written. */
-  seq: z4.number().int().optional(),
-  /** HOW MANY units the arrival was cut into. A device reads a LENS, never the arrival —
-   *  `/api/inbox` serves `open`, so the units already settled are gone from it — and a client
-   *  counting what it can see is counting what is LEFT. Walking a three-unit ask on the answer
-   *  screen read "1 of 3", then "1 of 2", then no chip at all, each answer having removed the
-   *  only evidence of itself. How big an arrival is, is a fact about the arrival, so the
-   *  server that can still see every row states it. Absent on any row with no `askId`: a
-   *  unit knows WHICH ask it came from and WHERE it sat in it, and how many there were is
-   *  the one part of its own arrival a single row cannot answer. */
-  units: z4.number().int().positive().optional(),
   tokenId: z4.string().optional(),
   status: NotifyStatusSchema,
   context: ContextSchema,
@@ -579,7 +553,12 @@ var InboxItemSchema = z4.object({
     entryId: z4.string(),
     title: z4.string(),
     state: z4.enum(["open", "answered"]),
-    answer: z4.string().nullable()
+    answer: z4.string().nullable(),
+    /** WHO ASKED IT (owner, 2026-09-23, Goal a345e906: each agenda row wears its agent's face) — the
+     *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
+     *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
+     *  author is not an agent this account holds (unpaired since, or a person). */
+    agent: z4.object({ tokenId: z4.string(), name: z4.string(), voice: VoiceKeySchema.optional() }).optional()
   })).optional(),
   visuals: z4.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -597,9 +576,14 @@ var InboxItemSchema = z4.object({
    *  agent (held in the inbox until the agent replies on the thread). */
   turn: z4.enum(["you", "agent"]).default("you"),
   /** Hard error reason on an awaiting request (turn="agent") — the wake failed to reach
-   *  the agent (provider-agnostic; set server-side). Absent = no hard error, though the
-   *  client may still flag a stall by age. Drives the inbox error badge + Retry. */
+   *  the agent (provider-agnostic; set server-side). Absent = no hard error. Drives the inbox
+   *  error badge + Retry. */
   error: z4.string().optional(),
+  /** WHEN THIS AGENT WORK WENT QUIET (turn="agent"), by the one rule (`coldSince`: three days
+   *  with nothing said), or absent while it is not stalled. The inbox's stalled badge reads
+   *  this and nothing else (2026-09-23: a 3-minute age rule badged every live Goal stalled,
+   *  and "dismiss the stalled ones" cancelled 37 pieces of live work). */
+  cold: z4.string().datetime().optional(),
   clarifies: z4.string().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
@@ -649,7 +633,10 @@ var InboxItemSchema = z4.object({
     goalIds: z4.array(z4.string()),
     decisionNeedId: z4.string().optional(),
     sealed: z4.boolean(),
-    goalState: z4.string().optional()
+    goalState: z4.string().optional(),
+    /** THAT GOAL'S NAME (#2416) — what Activity's row is headed by, since a row there is one Goal
+     *  and the cards it holds sit behind it. Stamped by the same read as `goalState`. */
+    goalTitle: z4.string().optional()
   }).optional()
 });
 var APNS_TOKEN_RE = /^[0-9a-fA-F]{64}$/;
@@ -748,7 +735,6 @@ var UserSettingsSchema = z4.object({
 });
 var HistoryItemSchema = z4.object({
   id: z4.string(),
-  parentId: z4.string(),
   /** 'user' = a request you sent; 'agent' = a notification an agent sent you. */
   initiator: z4.enum(["user", "agent"]),
   title: z4.string(),
@@ -907,6 +893,24 @@ var QueueQuestionSchema = z4.object({
    *  gate at all. */
   blocked: z4.boolean().default(false)
 });
+var QueueReplySchema = z4.object({
+  /** The card this note was (`deliveryId:requestEntryId`, minted by the server like every card
+   *  id) — so the phone can tell a reply it just sent from one the queue already carries, and the
+   *  walk can name it in its zoom. */
+  id: z4.string(),
+  /** The Goal the note is on. */
+  goalId: z4.string(),
+  /** What the note said. */
+  note: z4.string(),
+  /** Where it was carried — where a second reply goes (`POST /api/entries`, #2252). */
+  deliveryId: z4.string(),
+  requestEntryId: z4.string(),
+  askedAt: z4.string(),
+  /** When the person last replied — the window's start. */
+  repliedAt: z4.string(),
+  /** The person's latest words about it; null when there is nothing readable in them. */
+  reply: z4.string().nullable()
+});
 var QueueItemSchema = z4.object({
   id: z4.string(),
   /** One-line headline — the first sentence of the outcome. */
@@ -934,6 +938,10 @@ var QueueItemSchema = z4.object({
   blocked: z4.boolean().default(false),
   /** Every decision need on it, open or settled — the page decides which to show. */
   questions: z4.array(QueueQuestionSchema).default([]),
+  /** Every note on it the person replied to (`QueueReplySchema`) — the page decides which to show.
+   *  Optional, not defaulted: absent is none, and every hand-built queue (fixtures, the demo) need
+   *  not spell an empty list. */
+  replies: z4.array(QueueReplySchema).optional(),
   /** The repository or project identifier this Goal belongs to (#2280), null if untracked. */
   repo: z4.string().nullable().optional(),
   createdAt: z4.string(),

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

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

package/dist/dist-DKP3DJQJ.js

@@ -0,0 +1,110 @@
+import {
+  AGENT_TOOLS,
+  AGENT_TOOL_NAMES,
+  AWAIT_WINDOW_MS,
+  ApiError,
+  BACKEND_URL,
+  KEY_PATH,
+  NETWORK_MSG,
+  NotifyRequestSchema,
+  PROTO,
+  TOKEN_PATH,
+  UnpairedError,
+  acceptTriage,
+  agentName,
+  authToken,
+  checkReplies,
+  claimGoal,
+  claimSessions,
+  contact,
+  createGoal,
+  currentRepo,
+  deleteToken,
+  dismissTriage,
+  getGoal,
+  getTriage,
+  hatch,
+  heartbeat,
+  isNetworkError,
+  listConnections,
+  listNotes,
+  listSlots,
+  overrideToken,
+  parseDue,
+  pollToken,
+  reach,
+  reachAs,
+  readToken,
+  registerDelivery,
+  repoFromRemote,
+  requestCode,
+  revokeToken,
+  runTool,
+  saveToken,
+  sessionId,
+  sessionSlot,
+  setIdentity,
+  sleep,
+  slotIdentity,
+  slotName,
+  submitTriage,
+  subscribeWake,
+  updateGoal,
+  updateSlot,
+  whoAmI
+} from "./chunk-PHTQITTC.js";
+export {
+  AGENT_TOOLS,
+  AGENT_TOOL_NAMES,
+  AWAIT_WINDOW_MS,
+  ApiError,
+  BACKEND_URL,
+  KEY_PATH,
+  NETWORK_MSG,
+  NotifyRequestSchema,
+  PROTO,
+  TOKEN_PATH,
+  UnpairedError,
+  acceptTriage,
+  agentName,
+  authToken,
+  checkReplies,
+  claimGoal,
+  claimSessions,
+  contact,
+  createGoal,
+  currentRepo,
+  deleteToken,
+  dismissTriage,
+  getGoal,
+  getTriage,
+  hatch,
+  heartbeat,
+  isNetworkError,
+  listConnections,
+  listNotes,
+  listSlots,
+  overrideToken,
+  parseDue,
+  pollToken,
+  reach,
+  reachAs,
+  readToken,
+  registerDelivery,
+  repoFromRemote,
+  requestCode,
+  revokeToken,
+  runTool,
+  saveToken,
+  sessionId,
+  sessionSlot,
+  setIdentity,
+  sleep,
+  slotIdentity,
+  slotName,
+  submitTriage,
+  subscribeWake,
+  updateGoal,
+  updateSlot,
+  whoAmI
+};

package/dist/enable.js

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

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-SKLVQ73Q.js";
+} from "./chunk-X6G7XXCP.js";
 import {
   ENABLE_COMMAND,
   OnboardSchema,
@@ -14,11 +14,11 @@ import {
   SERVER_INSTRUCTIONS,
   TOOLS,
   paigyToolsAllowlisted
-} from "./chunk-SO5NRTXG.js";
+} from "./chunk-37FS33UP.js";
 import {
   decideListen,
   listenerAlive
-} from "./chunk-NOZRU5CD.js";
+} from "./chunk-SE2JCKDI.js";
 import {
   clearSurface,
   writeSurface
@@ -39,7 +39,7 @@ import {
   setIdentity,
   slotName,
   whoAmI
-} from "./chunk-R2GTL7N3.js";
+} from "./chunk-PHTQITTC.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-NOZRU5CD.js";
+} from "./chunk-SE2JCKDI.js";
 import {
   agentName,
   checkReplies,
@@ -11,7 +11,7 @@ import {
   getGoal,
   slotName,
   subscribeWake
-} from "./chunk-R2GTL7N3.js";
+} from "./chunk-PHTQITTC.js";
 
 // src/listen.ts
 import { spawn } from "child_process";
@@ -132,11 +132,12 @@ function leadOf(deliveries, goalId) {
 }
 function brief(waiting, reason, as, goalId) {
   const lead = leadOf(waiting.deliveries, goalId);
-  if (!lead) return reason === "boot" ? `Paigy \xB7 listening as ${as} \xB7 nothing waiting` : `Paigy \xB7 ${reason} \xB7 nothing waiting`;
+  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 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}"`;
+  return `Paigy \xB7 ${reason} \xB7 ${waiting.deliveries.length} waiting \xB7 lead ${lead.deliveryId} on Goal ${goal}: "${shown}"${stalled}`;
 }
 function launchEnv(waiting, reason, goalId) {
   const env = { PAIGY_WORK: JSON.stringify(waiting), PAIGY_EVENT: reason };
@@ -153,16 +154,16 @@ function launchEnv(waiting, reason, goalId) {
 async function sweep(reason, goalId) {
   try {
     const cmd = process.env.PAIGY_ON_WAKE;
-    const { deliveries: rows } = await checkReplies();
+    const { deliveries: rows, stalled } = await checkReplies();
     const lead = leadOf(rows, goalId);
-    const full = lead ? await contact({ deliveryId: lead.deliveryId }, { waits: false }).catch(() => null) : null;
+    const full = lead ? await contact({ deliveryId: lead.deliveryId }, { waits: false }).then((d) => "recorded" 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 };
+    const waiting = { deliveries, goal, ...stalled?.length ? { stalled } : {} };
     if (BRIEF) line(brief(waiting, reason, listeningAs(), goalId));
     else emit({ type: "sweep", reason, ...goalId ? { about: goalId } : {}, ...waiting });
-    if (cmd && deliveries.length) {
+    if (cmd && (deliveries.length || reason === "boot" && waiting.stalled?.length)) {
       spawn(cmd, { shell: true, stdio: "inherit", env: { ...process.env, ...launchEnv(waiting, reason, goalId) } });
     }
   } catch (e) {

package/dist/onboard.js

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

package/dist/slot.js

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

package/dist/stalled.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+// src/stalled.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function stopReply(stalled) {
+  if (!stalled.length) return null;
+  const list = stalled.slice(0, 8).map((g) => `"${g.title}" (${g.goalId})`).join(", ");
+  const more = stalled.length > 8 ? ` and ${stalled.length - 8} more` : "";
+  return {
+    decision: "block",
+    reason: `Before you stop: ${stalled.length} of your Paigy Goals have had no progress for 3 days: ${list}${more}. For each, update_goal with progress, finish it, or cancel it.`
+  };
+}
+async function main() {
+  const input = JSON.parse(readFileSync(0, "utf8") || "{}");
+  if (input.stop_hook_active) return;
+  const session = input.session_id ?? "";
+  if (session) process.env.PAIGY_SESSION_ID = session;
+  const day = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  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 reply = stopReply((await checkReplies()).stalled ?? []);
+  if (!reply) return;
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(mark, "");
+  process.stdout.write(JSON.stringify(reply));
+}
+if (process.argv[1] && /stalled(\.[jt]s)?$/.test(process.argv[1])) main().catch(() => void 0);
+export {
+  stopReply
+};

package/dist/statusline.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/mcp",
-  "version": "0.40.14",
+  "version": "0.40.15",
   "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",
@@ -11,7 +11,8 @@
     "paigy-listen": "dist/listen.js",
     "paigy-statusline": "dist/statusline.js",
     "paigy-enable-tools": "dist/enable.js",
-    "paigy-slot": "dist/slot.js"
+    "paigy-slot": "dist/slot.js",
+    "paigy-stalled": "dist/stalled.js"
   },
   "files": [
     "dist"