@paigy/mcp 0.40.16 → 0.40.19

package/README.md

@@ -215,19 +215,48 @@ 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)
+## Stalled work (turn-end hook — Claude Code, Codex, Gemini CLI, Antigravity)
 
 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:
+hook holds a session's turn end once a day to list it. One program, four tools:
+
+**Claude Code** (`~/.claude/settings.json`) — installed by the paigy plugin:
 
 ```json
 { "hooks": { "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y -p @paigy/mcp paigy-stalled" }] }] } }
 ```
 
+**Codex** (`~/.codex/config.toml`) — its `Stop` event takes the same `{ decision, reason }`, so
+the same program serves it. Written for you when you pair from another tool:
+
+```toml
+[[hooks.Stop]]
+
+[[hooks.Stop.hooks]]
+type = "command"
+command = "npx -y -p @paigy/mcp@latest paigy-stalled --agent codex"
+timeout = 60
+```
+
+**Gemini CLI / Antigravity** (`~/.gemini/settings.json`, `~/.gemini/antigravity-cli/settings.json`)
+— the turn-end event there is `AfterAgent`, and the reminder also arrives as a `systemMessage`,
+which is the field that event promises will reach somebody:
+
+```json
+{ "hooks": { "AfterAgent": [{ "matcher": "*", "hooks": [{ "name": "paigy-stalled", "type": "command",
+  "command": "npx -y -p @paigy/mcp@latest paigy-stalled --agent antigravity", "timeout": 60000 }] }] } }
+```
+
+`--agent <slot>` is not optional outside Claude Code: a hook is not the MCP server, so it never
+inherits the `PAIGY_AGENT` that server was registered with, and without the flag it reads this
+session's own slot — a different identity, with no stalled work of its own. Pass the same value as
+the tool's MCP registration (`codex`, `antigravity`, or whatever you set `PAIGY_AGENT` to).
+
 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.
+after it has reminded that session once today. Codex's older `notify` program is not a place for
+this: it is spawned fire-and-forget with stdio null, so nothing it prints can reach the agent.
 
 ## Statusline (Claude Code)
 

package/dist/{chunk-JWMR6K6D.js → chunk-76ILN3YV.js}

@@ -4,10 +4,10 @@ import {
   serverInstructions,
   sessionStartHook,
   withSessionStartHook
-} from "./chunk-SFGGZLVO.js";
+} from "./chunk-HGXXGOGG.js";
 import {
   agentName
-} from "./chunk-6OBUH2FB.js";
+} from "./chunk-VYWIPFEY.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.";
@@ -99,6 +99,55 @@ function withPaigyMcpToml(existing, agent) {
   ].join("\n");
   return existing + entry;
 }
+function stalledHookCommand(agent) {
+  return `npx -y -p @paigy/mcp@latest paigy-stalled --agent ${agent}`;
+}
+function withPaigyStopHookToml(existing, agent) {
+  if (existing.includes("paigy-stalled")) return null;
+  const entry = [
+    "",
+    "[[hooks.Stop]]",
+    "",
+    "[[hooks.Stop.hooks]]",
+    'type = "command"',
+    `command = "${stalledHookCommand(agent)}"`,
+    "timeout = 60",
+    // seconds, in Codex — a cold `npx` resolve is slow the first time
+    ""
+  ].join("\n");
+  return existing + entry;
+}
+function withPaigyStopHookJson(existing, agent) {
+  let config = {};
+  if (existing) {
+    try {
+      config = JSON.parse(existing);
+    } catch {
+      return null;
+    }
+  }
+  const hooks = config.hooks ?? {};
+  const kept = (hooks.AfterAgent ?? []).map((group) => ({ ...group, hooks: (group.hooks ?? []).filter((hook) => hook.name !== "paigy-stalled") })).filter((group) => group.hooks.length > 0);
+  config.hooks = {
+    ...hooks,
+    AfterAgent: [
+      ...kept,
+      {
+        matcher: "*",
+        hooks: [
+          {
+            name: "paigy-stalled",
+            type: "command",
+            command: stalledHookCommand(agent),
+            timeout: 6e4
+            // milliseconds, in Gemini CLI
+          }
+        ]
+      }
+    ]
+  };
+  return JSON.stringify(config, null, 2);
+}
 function autoConfigureClients(skip = agentName()) {
   const home = homedir();
   const registered = [];
@@ -118,6 +167,20 @@ function autoConfigureClients(skip = agentName()) {
       } catch {
       }
     }
+    for (const path of [
+      join(home, ".gemini", "settings.json"),
+      join(home, ".gemini", "antigravity-cli", "settings.json")
+    ]) {
+      try {
+        if (!existsSync(dirname(path))) continue;
+        const existing = existsSync(path) ? readFileSync(path, "utf8") : null;
+        const updated = withPaigyStopHookJson(existing, "antigravity");
+        if (updated === null) continue;
+        writeFileSync(path, updated);
+        registered.push(`Paigy's turn-end reminder (${path})`);
+      } catch {
+      }
+    }
   }
   if (skip !== "codex") {
     const codexConfig = join(home, ".codex", "config.toml");
@@ -129,6 +192,12 @@ function autoConfigureClients(skip = agentName()) {
           writeFileSync(codexConfig, updated);
           registered.push(`OpenAI Codex (${codexConfig})`);
         }
+        const afterMcp = existsSync(codexConfig) ? readFileSync(codexConfig, "utf8") : "";
+        const withHook = withPaigyStopHookToml(afterMcp, "codex");
+        if (withHook !== null) {
+          writeFileSync(codexConfig, withHook);
+          registered.push(`Paigy's turn-end reminder (${codexConfig})`);
+        }
       }
     } catch {
     }

package/dist/{chunk-SFGGZLVO.js → chunk-HGXXGOGG.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
@@ -113,11 +113,16 @@ var UpdateGoalSchema = z3.object({
 }).strict();
 var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: z3.string().uuid() }).strict();
 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 GetGoalSchema = z3.object({
+  goalId: z3.string().uuid(),
+  /** Every entry in full. Without it the read carries the person's words, open questions and your
+   *  newest entry, and counts what it left out (`apps/api/src/goal/collapse.ts`). */
+  history: z3.boolean().optional()
+}).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), `next`, the one step to take, and `more`, where to read further. The conversation carries everything the person said, every open question and your newest entry; your older entries are left out and counted \u2014 history: true reads every entry in full. Another account's Goals, and another agent's Goal that is not below one of yours, 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. 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 = "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; 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 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 },
@@ -128,9 +133,10 @@ var AGENT_TOOLS = [
   { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) }
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
+var DONE_MESSAGE = "When the work is done, send one message through contact saying what is done and anything the person needs to do or check.";
 function serverInstructions(opts) {
   const calls = opts.waits ? "A Call holds one bounded window here; continue with contact({deliveryId}) to hold the next or reread that exact Delivery." : "A Call returns after one read; continue with contact({deliveryId}) to reread that exact Delivery.";
-  return `On startup and after a wake, call check_replies for the open Deliveries addressed to you, and claim_goal for your runnable or review-pending Goal and the conversation on it. get_goal rereads it without claiming. Every read ends in \`next\`, the one step to take. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. ${calls} Evidence can repeat: reads do not acknowledge or hide it. Report progress and acknowledge review with update_goal, never as a contact. Never infer ringing from an open Call Delivery. Soft waiting and re-presentation are unsupported. Your user is remote. Always interact with the user through Paigy. For decisions, approvals, or questions, contact them with structured options. Never assume anyone is reading the terminal stdout.
+  return `On startup and after a wake, call check_replies for the open Deliveries addressed to you, and claim_goal for your runnable or review-pending Goal and the conversation on it. get_goal rereads it without claiming. Every read ends in \`next\`, the one step to take. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. ${calls} Evidence can repeat: reads do not acknowledge or hide it. Report progress and acknowledge review with update_goal, never as a contact. ${DONE_MESSAGE} Never infer ringing from an open Call Delivery. Soft waiting and re-presentation are unsupported. Your user is remote. Always interact with the user through Paigy. For decisions, approvals, or questions, contact them with structured options. Never assume anyone is reading the terminal stdout.
 
 HOW TO ASK:
 1. One question per ask. Five questions are five objects in \`asks\`, in one contact, so each can be answered on its own; one question with five parts settles nothing until all five are answered.
@@ -472,9 +478,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(),
@@ -558,7 +564,13 @@ var InboxItemSchema = z4.object({
      *  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()
+    agent: z4.object({ tokenId: z4.string(), name: z4.string(), voice: VoiceKeySchema.optional() }).optional(),
+    /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
+     *  its need offers, exactly as its own card carries them, present only when one of them has a
+     *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
+     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
+     *  says those, and the list stays small (an `html` is up to 16 KB). */
+    options: z4.array(OptionSchema).optional()
   })).optional(),
   visuals: z4.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -585,6 +597,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.
@@ -949,7 +966,19 @@ var QueueItemSchema = z4.object({
   /** When its owner last SAID something about it (`goals.last_progress_at`, written by every
    *  `update_goal` that changes `progress`). `updatedAt` moves for reasons nobody chose — a
    *  state recomputed, a review flag — so it cannot tell work in hand from work gone quiet. */
-  lastProgressAt: z4.string().nullable().optional()
+  lastProgressAt: z4.string().nullable().optional(),
+  /** THE GOAL'S NEWEST WORD, FROM EITHER SIDE (owner, 2026-09-27): the newest Entry on it, of any
+   *  kind — what the person added ("Add to this"), their reply, the agent's ask or its progress
+   *  note. A progress note is an Entry, so this is already the newer of the two: the person's note
+   *  shows the moment it is written, and the agent's reply or next note replaces it by being newer.
+   *  `said` is bounded to 280 characters server-side (a line, not the conversation). Null when the
+   *  Goal carries no readable Entry; optional, so hand-built queues need not spell it. */
+  latest: z4.object({
+    from: z4.enum(["person", "agent"]),
+    said: z4.string(),
+    at: z4.string(),
+    entryId: z4.string()
+  }).nullable().optional()
 });
 var COLD_AFTER_MS = 3 * 24 * 60 * 60 * 1e3;
 var NoteSourceSchema = z4.enum(["app", "call"]);
@@ -1125,6 +1154,104 @@ var NotificationFeedbackKindSchema = z4.enum([
   "other"
   // anything else — the note carries it.
 ]);
+var SlimOptionSchema = OptionSchema.omit({ html: true });
+var QuestionRowSchema = z4.object({
+  /** The card's id (`deliveryId:needId`, or `deliveryId:entryId` for an update), as the inbox mints it. */
+  id: z4.string(),
+  deliveryId: z4.string(),
+  entryId: z4.string(),
+  /** The decision it waits on; null for an update, which asks nothing. */
+  needId: z4.string().nullable(),
+  goalIds: z4.array(z4.string()),
+  /** The name of the work it is about, when the read could word it. */
+  goalTitle: z4.string().optional(),
+  tokenId: z4.string().optional(),
+  name: z4.string(),
+  title: z4.string(),
+  body: z4.string(),
+  select: z4.enum(["one", "many", "rank", "confirm", "text"]),
+  options: z4.array(SlimOptionSchema),
+  hasPreview: z4.boolean(),
+  blocking: z4.boolean(),
+  askedAt: z4.string().datetime(),
+  ring: InboxItemSchema.shape.ring,
+  onCall: z4.literal(true).optional(),
+  sealed: z4.boolean()
+});
+var WorkStateSchema = z4.enum(["ready", "active", "waiting", "done", "cancelled"]);
+var WorkRowSchema = z4.object({
+  id: z4.string(),
+  parentId: z4.string().nullable(),
+  title: z4.string(),
+  /** Straight off the Goal. */
+  state: WorkStateSchema,
+  owner: z4.string().nullable(),
+  revision: z4.number().int(),
+  /** Open questions on it, counted to 100. */
+  waiting: z4.number().int(),
+  /** Held by a gate on work that is not done. */
+  blocked: z4.boolean(),
+  lastProgressAt: z4.string().datetime().nullable(),
+  /** The line written for its newest progress note, else that note's first words. */
+  line: z4.string().nullable(),
+  /** Work directly under it, counted to 100; the list carries up to 12 of them. */
+  children: z4.number().int(),
+  createdAt: z4.string().datetime(),
+  updatedAt: z4.string().datetime(),
+  /** When anything at or under it last moved — the order the list is in. */
+  activeAt: z4.string().datetime(),
+  /** A sealed outcome has no title here; the work's page opens it. */
+  sealed: z4.boolean()
+});
+var ComputerRowSchema = ConnectionSummarySchema.omit({ activity: true });
+var AgentRowSchema = ComputerRowSchema.extend({
+  /** Open questions it is asking the person, over every open card; null when that read failed. */
+  asking: z4.number().int().nullable(),
+  oldestAskAt: z4.string().datetime().nullable(),
+  /** Up to three of the live Goals it holds, oldest first (the order it picks them up), and how
+   *  many in all among the account's 200 most recently active agent-held live Goals
+   *  (`agent_holds`); null when that read failed. */
+  holds: z4.array(z4.object({ id: z4.string(), title: z4.string() })).nullable(),
+  held: z4.number().int().nullable(),
+  /** The earliest instant any Goal it holds went quiet, by the one rule (`coldSince`); null
+   *  while none has, or when that read failed. */
+  cold: z4.string().datetime().nullable(),
+  /** The newest line of its working log, and when the harness saw it. */
+  line: z4.string().nullable(),
+  lineAt: z4.string().datetime().nullable()
+});
+var SnapshotSchema = z4.object({
+  /** The API's clock, taken before the first read: what a later delta will start from. */
+  at: z4.string().datetime(),
+  questions: z4.object({
+    /** The newest 30 open cards, questions before updates. */
+    items: z4.array(QuestionRowSchema),
+    /** Every open question, and apart from them every update, and what was put off. */
+    total: z4.number().int(),
+    updates: z4.number().int(),
+    putOff: z4.number().int()
+  }).nullable(),
+  agents: z4.object({
+    /** Up to 60, most recently seen first. */
+    items: z4.array(AgentRowSchema),
+    more: z4.boolean()
+  }).nullable(),
+  work: z4.object({
+    /** The 60 most recently active roots, each followed by up to 12 children; 240 rows at most. */
+    items: z4.array(WorkRowSchema),
+    /** How much work is behind each of the Work tab's four filters, each counted to 100, read with
+     *  the rows. `work_list` (20260928023533) owns the predicates: Live is `ready`, `active` or
+     *  `waiting`; Waiting on you is live work with an open question or an unmet gate; Not started
+     *  is `ready`; Done is `done` or `cancelled`. */
+    counts: z4.object({ live: z4.number().int(), waiting: z4.number().int(), notStarted: z4.number().int(), done: z4.number().int() })
+  }).nullable(),
+  you: z4.object({
+    settings: UserSettingsSchema,
+    callable: z4.boolean(),
+    /** Up to 20 paired computers; null when the roster read failed. */
+    computers: z4.array(ComputerRowSchema).nullable()
+  }).nullable()
+});
 
 // src/listening.ts
 import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -1149,7 +1276,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-OGTH55QH.js → chunk-TRMYDJ5H.js}

@@ -1,10 +1,12 @@
 import {
+  NameTakenError,
   isNetworkError,
   pollToken,
   requestCode,
   saveToken,
+  setIdentity,
   sleep
-} from "./chunk-6OBUH2FB.js";
+} from "./chunk-VYWIPFEY.js";
 
 // src/identity.ts
 var CLIENT_LABELS = {
@@ -25,6 +27,21 @@ function suggestedAgentName(clientName) {
   if (!clientName) return void 0;
   return CLIENT_LABELS[clientName.toLowerCase()] ?? clientName.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
+async function identify(who, ask) {
+  let renamed = false;
+  if (ask.name || ask.voice) {
+    try {
+      who = await setIdentity({ ...ask.name ? { name: ask.name } : {}, ...ask.voice ? { voice: ask.voice } : {} });
+      renamed = true;
+    } catch (e) {
+      const message2 = e instanceof NameTakenError ? e.message : `The rename did not go through (${e.message}); nothing changed. Call onboard again to retry, or carry on.`;
+      return { name: who.name, voice: who.voice, message: message2 };
+    }
+  }
+  const voice = who.voice ? ` (voice: ${who.voice})` : "";
+  const message = !who.name ? [renamed && who.voice ? `Your voice is ${who.voice} now.` : "", who.unnamed ?? "Set up, with no name yet."].filter(Boolean).join(" ") : renamed ? `Renamed \u2014 this agent is "${who.name}"${voice} now.` : `Already set up as "${who.name}"${voice}. Ask the user if they want to rename it or unpair; otherwise carry on.`;
+  return { name: who.name, voice: who.voice, message };
+}
 
 // src/pairing.ts
 async function resolvePairing(deviceCode, capMs, pollMs = 2e3) {
@@ -102,6 +119,7 @@ function clearPairing(deviceCode) {
 
 export {
   suggestedAgentName,
+  identify,
   resolvePairing,
   startPairing,
   joinBackgroundPair,