@paigy/mcp 0.40.6 → 0.40.8

package/README.md

@@ -205,11 +205,11 @@ codex exec "Paigy goal $PAIGY_GOAL_ID on thread $PAIGY_THREAD_ID. claim_goal it
 
 ## Statusline (Claude Code)
 
-`paigy-statusline` prints a one-line connection status — the account's session
-mode and whether a phone is paired — for Claude Code's status bar:
+`paigy-statusline` prints which Paigy identity this Claude Code session is, for the
+status bar:
 
 ```
-paigy: all calls · phone ✓
+paigy: Marlow
 ```
 
 Enable it in `~/.claude/settings.json`:
@@ -218,11 +218,9 @@ Enable it in `~/.claude/settings.json`:
 "statusLine": { "type": "command", "command": "npx -y -p @paigy/mcp@latest paigy-statusline" }
 ```
 
-It reads `GET /api/status` with the pairing token and caches the result in
-`~/.paigy/status.json` for 60 seconds, so the bar's constant refreshes never
-hammer the API; when offline it shows the last known state. `paigy: unpaired`
-means there's no token (or the pairing was revoked) — run `/paigy-onboard` to
-pair; `paigy: …` means the status isn't known yet (first run while offline).
+It reads only `~/.paigy` — no network. `paigy: paired · session hatches on first use` means the
+machine is paired and this session's identity is minted by its first tool call;
+`paigy: unpaired` means there's no token — run `/paigy-onboard` to pair.
 
 ## Publishing (maintainers)
 

package/dist/{chunk-MD37G3TI.js → chunk-BT5S7VT2.js}

@@ -2298,11 +2298,14 @@ function isNetworkError(e) {
   return e instanceof Error && e.message.startsWith(NETWORK_MSG);
 }
 async function reach(url, init) {
+  return send(url, init, SESSION_ID);
+}
+async function send(url, init, session) {
   try {
     const headers = {
       ...init?.headers,
       "x-paigy-instance": INSTANCE_ID,
-      "x-paigy-session": SESSION_ID
+      "x-paigy-session": session
     };
     return await fetch(url, { ...init, headers, dispatcher: await proxy() });
   } catch (e) {
@@ -3578,6 +3581,9 @@ var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
 var CONTACT_DESCRIPTION = "Contact the user about exactly one existing Goal: pass goalIds:[goalId], ask, channel:'notification'|'call', and waiting:'none'|'hard'. Options supply choices. Notification returns immediately; collect durable answers with claim_goal/get_goal. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. Continuation sends nothing and rereads the same durable evidence, including previously read answers. Entries retain authorship and provenance; accepted decisions are separate from quoted speech. Call state open does not mean ringing. Unsupported: soft waiting, multiple Goals/questions, outcome admission, and re-presentation of an existing request. Create a Goal explicitly first; never resend a pending ask to continue waiting.";
 var CreateGoalSchema = z2.object({
   outcome: z2.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
+   *  rings"). Omit it and the brain writes one at admission from the outcome. */
+  title: z2.string().trim().min(1).max(80).optional(),
   ownerParticipant: z2.string().trim().min(1).optional(),
   idempotencyKey: z2.string().trim().min(1).max(200),
   /** A past conversation this Goal should be read against — History's "new session from this"
@@ -3597,11 +3603,14 @@ var CreateGoalSchema = z2.object({
 var CreateGoalToolSchema = CreateGoalSchema.extend({
   idempotencyKey: CreateGoalSchema.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
 }).strict();
-var CREATE_GOAL_DESCRIPTION = "Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Admission only: the owner must claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.";
+var CREATE_GOAL_DESCRIPTION = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: the owner must claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
 var UpdateGoalSchema = z2.object({
   revision: z2.number().int().positive(),
   changes: z2.object({
     outcome: z2.string().trim().min(1).max(1e4).optional(),
+    /** The work's NAME (#2115) — one to five words, how a person refers to it out loud. The
+     *  brain writes one at admission; this is the owner saying it better. Null clears it. */
+    title: z2.string().trim().min(1).max(80).nullable().optional(),
     ownerParticipant: z2.string().trim().min(1).optional(),
     parentGoalId: z2.string().uuid().nullable().optional(),
     dependencies: z2.array(z2.object({ goalId: z2.string().uuid(), gate: z2.enum(["start", "finish"]) }).strict()).optional(),
@@ -3617,10 +3626,10 @@ var UpdateGoalSchema = z2.object({
 var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: z2.string().uuid() }).strict();
 var ClaimGoalSchema = z2.object({ goalId: z2.string().uuid().optional() }).strict();
 var GetGoalSchema = z2.object({ goalId: z2.string().uuid() }).strict();
-var GET_GOAL_DESCRIPTION = "Read the current authorized Goal brief: state, owner, blockers, open decisions, progress, and the next operation. 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, and review acknowledgement are explicit; stale revisions are rejected. 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 new revision and a prose summary.";
-var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Returns a Goal-scoped brief, current revision, blockers, and the next valid operation. Claiming 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, the newest words in brief, accepted decisions and open decision needs, without the Entries. 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 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 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 = z2.object({}).strict();
 var GetThreadSchema = z2.object({
   parentId: z2.string().describe("The Thread to read \u2014 the threadId a Delivery returned, or the parentId of a search hit.")
@@ -3641,6 +3650,22 @@ var AGENT_TOOLS = [
   { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) }
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
+function entryWords(entry) {
+  const content = entry.content;
+  if (content && "sealed" in content) return "";
+  const plain = content?.plain;
+  if (typeof plain === "string") return plain;
+  if (plain && typeof plain === "object") {
+    const text = plain.text;
+    if (typeof text === "string") return text;
+    const title = plain.title;
+    const description = plain.description;
+    const parts = [title, ...Array.isArray(description) ? description : []].filter((v) => typeof v === "string");
+    if (parts.length) return parts.join("\n\n");
+  }
+  return entry.sources.map((source) => source.text).join("\n");
+}
+var LIVE_MS = 3 * 6e4;
 var ContextSchema = z3.object({
   title: z3.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: z3.array(z3.string().min(1)).describe(
@@ -4477,7 +4502,19 @@ var QueueQuestionSchema = z3.object({
   /** The ruling in the person's own words, from the contribution that replied — not the
    *  option id, which is not something anyone reads back. Null while it is open, and null
    *  for a settled question whose reply carried nothing readable. */
-  answer: z3.string().nullable().default(null)
+  answer: z3.string().nullable().default(null),
+  /** The Goal this question belongs to — a step knows its Goal on its own, not only through
+   *  an `InboxItem`'s `communication.goalIds[0]` (walk/design.md §12 item 3).
+   *  READ BY `apps/client/src/walk/order.ts`, which stamps it onto every `WalkStep`: the walk's
+   *  order, its route, home's trees and the list of steps all take a step's Goal from here, so
+   *  this is the field they agree through rather than each re-deriving it from the row it
+   *  arrived under. Required because the API projects it on every need it sends. */
+  goalId: z3.string(),
+  /** True only while an unmet START gate holds the Goal — a Goal that merely waits to
+   *  *finish* does not stop a person from answering (owner, 2026-09-16: "per need gate from
+   *  the API"; §4's dashed node). Not the same fact as `QueueItem.blocked`, which counts any
+   *  gate at all. */
+  blocked: z3.boolean().default(false)
 });
 var QueueItemSchema = z3.object({
   id: z3.string(),
@@ -4616,25 +4653,6 @@ var DeliveryConfigSchema = z3.object({
    *  carries credentials; only a `poll` registration can come back with null here. */
   realtime: z3.object({ url: z3.string(), anonKey: z3.string() }).nullable()
 });
-var StatusSchema = z3.object({
-  name: z3.string(),
-  sessionMode: z3.enum(["default", "all_calls", "silent"]),
-  /** A phone is registered for push/ring (any push token on the account). */
-  phone: z3.boolean(),
-  /** HOW MANY THINGS ARE WAITING ON THIS IDENTITY — replies it never collected and requests
-   *  it never picked up. THE SAME NUMBER the harness's wake gate reads
-   *  (`pendingSummary.unacknowledged`), from the same function, because a statusline saying
-   *  zero while the sweep sees one is two ideas of "waiting".
-   *
-   *  Why it is here at all (owner, 2026-09-07): nothing can interrupt an idle agent process
-   *  that nobody spawned, so a terminal session only learns of work by asking. The harness
-   *  used to paper over that by spawning a SECOND process on the identity; now it stands
-   *  back, correctly, and the person sitting at the terminal is the one who can act. A
-   *  coffee-beans request sat unread for three days.
-   *
-   *  Optional: an older API sends no field, and the statusline then renders exactly as before. */
-  waiting: z3.number().int().nonnegative().optional()
-});
 var EnvelopeRecipientSchema = z3.object({
   keyId: z3.string(),
   epk: z3.string(),
@@ -5251,14 +5269,14 @@ async function registerDelivery(mode, opts = {}) {
 async function contact(input, opts = {}) {
   const parsed = ContactSchema.parse(input);
   opts.signal?.throwIfAborted();
-  const send = opts.reach ?? reach;
+  const send2 = opts.reach ?? reach;
   const headers = { "content-type": "application/json", authorization: `Bearer ${authToken(opts.token) ?? ""}`, "x-paigy-model": "goal-entry-v1" };
   let deliveryId;
   if ("deliveryId" in parsed) deliveryId = parsed.deliveryId;
   else {
     if (!opts.reach && readKeyFile()?.e2ee) throw new Error("Goal contact does not support E2EE yet; refusing to send plaintext.");
     const shaped = deriveAsk(NotifyRequestSchema.parse({ ask: parsed.ask, waiting: parsed.waiting, options: parsed.options }));
-    const res = ensureAuthed(await send(`${BACKEND_URL}/api/goals/${parsed.goalIds[0]}/contact`, {
+    const res = ensureAuthed(await send2(`${BACKEND_URL}/api/goals/${parsed.goalIds[0]}/contact`, {
       method: "POST",
       headers,
       signal: opts.signal,
@@ -5270,11 +5288,9 @@ async function contact(input, opts = {}) {
     if (!deliveryId) throw new Error("Goal contact returned no Delivery identity");
   }
   const read = async (signal2) => {
-    const res = ensureAuthed(await send(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
+    const res = ensureAuthed(await send2(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
     if (!res.ok) await fail("read_delivery", res);
-    const delivery = await res.json();
-    return delivery.kind === "notification" ? { ...delivery, message: `${delivery.message}
-Inbox delivery is asynchronous; use claim_goal/get_goal to collect durable answers. Do not poll this Notification.` } : delivery;
+    return await res.json();
   };
   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);
@@ -5301,18 +5317,115 @@ async function checkReplies(opts = {}) {
   if (!res.ok) await fail("check_replies", res);
   return await res.json();
 }
+function compact(o) {
+  return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== void 0 && v !== null && v !== "" && !(Array.isArray(v) && v.length === 0)));
+}
+var who = (participant) => participant.startsWith("human:") ? "person" : participant.startsWith("agent:") ? "agent" : participant;
+var at = (iso) => {
+  const t = Date.parse(iso);
+  return Number.isFinite(t) ? new Date(t).toISOString().replace(/\.\d{3}Z$/, "Z") : iso;
+};
+function decided(result) {
+  if ("sealed" in result) return "[encrypted]";
+  switch (result.kind) {
+    case "confirm":
+      return result.approved ? "yes" : "no";
+    case "one":
+      return result.option.label;
+    case "many":
+      return result.options.map((o) => o.label).join(", ");
+    case "rank":
+      return result.options.map((o) => o.label).join(" > ");
+    default:
+      return void 0;
+  }
+}
+function conversation(e) {
+  const answers = new Map((e.answers ?? []).map((a) => [a.decisionNeedId, a]));
+  return (e.entries ?? []).map((entry) => {
+    const sealed = !!entry.content && "sealed" in entry.content;
+    const plain = entry.content && "plain" in entry.content ? entry.content.plain : null;
+    const options = plain && typeof plain === "object" && Array.isArray(plain.options) ? plain.options.map((o) => o.label).filter((l) => typeof l === "string") : [];
+    const need = (e.decisionNeeds ?? []).find((n) => n.requestEntryId === entry.entryId);
+    const answer = need ? answers.get(need.decisionNeedId) : void 0;
+    const answered = answer ? decided(answer.result) : void 0;
+    return compact({
+      id: entry.entryId,
+      from: who(entry.authorParticipant),
+      at: at(entry.createdAt),
+      said: sealed ? "[encrypted]" : entryWords(entry).trim(),
+      re: entry.aboutId ?? void 0,
+      options,
+      decision: need ? compact({ id: need.decisionNeedId, state: need.state, answer: answered }) : void 0
+    });
+  });
+}
+function goalView(g) {
+  if (!g.goalId) return compact({ state: g.state, next: g.message });
+  return compact({
+    goalId: g.goalId,
+    revision: g.revision,
+    state: g.state,
+    outcome: g.outcome,
+    progress: g.progress,
+    reviewPending: g.reviewPending || void 0,
+    owner: g.ownerParticipant,
+    parentGoalId: g.parentGoalId,
+    childGoalIds: g.childGoalIds,
+    blockedBy: g.blockedDependencyGoalIds,
+    dueAt: g.dueAt,
+    leaseExpiresAt: g.leaseExpiresAt,
+    contextThreadId: g.contextThreadId,
+    conversation: conversation(g),
+    next: g.message
+  });
+}
+function deliveryView(d) {
+  return compact({
+    deliveryId: d.deliveryId,
+    kind: d.kind,
+    state: d.state,
+    goalIds: d.goalIds,
+    threadId: d.threadId,
+    conversation: conversation(d),
+    next: d.kind === "notification" ? "Answers land on the Goal: read them with claim_goal or get_goal. Do not poll this notification." : d.message
+  });
+}
+function threadView(t) {
+  return {
+    parentId: t.parentId,
+    turns: (t.turns ?? []).map((turn) => {
+      const lines2 = turn.role === "user" ? [turn.text ?? ""] : [turn.title ?? "", ...turn.description ?? []];
+      const said = lines2.map((l) => l.trim()).filter((l, i, all) => l && all.indexOf(l) === i).join("\n");
+      return compact({ from: turn.role === "user" ? "person" : "agent", at: turn.at ? at(turn.at) : void 0, said });
+    })
+  };
+}
+function repliesView(r) {
+  const deliveries = r.deliveries ?? [];
+  return {
+    deliveries: deliveries.map((d) => compact({
+      deliveryId: d.deliveryId,
+      kind: d.kind,
+      goalIds: d.goalIds,
+      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."
+  };
+}
 async function runTool(name, args, opts) {
   const { waits, signal, ...client } = opts;
   const input = args ?? {};
   switch (name) {
     case "contact":
-      return contact(input, { ...client, signal, waits });
+      return deliveryView(await contact(input, { ...client, signal, waits }));
     case "check_replies":
       CheckRepliesSchema.parse(input);
-      return checkReplies(client);
+      return repliesView(await checkReplies(client));
     case "get_thread": {
       const { parentId } = GetThreadSchema.parse(input);
-      return getThread(parentId, client);
+      return threadView(await getThread(parentId, client));
     }
     case "search_threads": {
       const { q } = SearchThreadsSchema.parse(input);
@@ -5324,15 +5437,15 @@ async function runTool(name, args, opts) {
     }
     case "claim_goal": {
       const { goalId } = ClaimGoalSchema.parse(input);
-      return claimGoal(goalId, client);
+      return goalView(await claimGoal(goalId, client));
     }
     case "get_goal": {
       const { goalId } = GetGoalSchema.parse(input);
-      return getGoal(goalId, client);
+      return goalView(await getGoal(goalId, client));
     }
     case "update_goal": {
       const { goalId, ...body } = UpdateGoalToolSchema.parse(input);
-      return updateGoal(goalId, body, client);
+      return goalView(await updateGoal(goalId, body, client));
     }
     default:
       throw new Error(`Unknown tool: ${name}`);
@@ -5437,9 +5550,7 @@ async function subscribeWake(onNudge, opts = {}) {
 }
 
 export {
-  BACKEND_URL,
   isNetworkError,
-  reach,
   sessionSlot,
   AGENT_NAME,
   TOKEN_PATH,

package/dist/{chunk-7VMR7ONL.js → chunk-DRRAJMEE.js}

@@ -10,7 +10,7 @@ import {
   saveToken,
   sleep,
   startE2ee
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.js";
 
 // src/identity.ts
 var CLIENT_LABELS = {

package/dist/{chunk-QINMT6C2.js → chunk-GQ5J6WW5.js}

@@ -2,10 +2,10 @@ import {
   AGENT_TOOLS,
   mcpInputSchema,
   serverInstructions
-} from "./chunk-Z6S4THWU.js";
+} from "./chunk-XOL6UX6P.js";
 import {
   AGENT_NAME
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.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-Z6S4THWU.js → chunk-XOL6UX6P.js}

@@ -62,6 +62,9 @@ var CONTACT_SCHEMA = { type: "object", ...mcpInputSchema(ContactSchema) };
 var CONTACT_DESCRIPTION = "Contact the user about exactly one existing Goal: pass goalIds:[goalId], ask, channel:'notification'|'call', and waiting:'none'|'hard'. Options supply choices. Notification returns immediately; collect durable answers with claim_goal/get_goal. On stdio, a Call holds one cancellable ~45s window; continue with ONLY {deliveryId}. Continuation sends nothing and rereads the same durable evidence, including previously read answers. Entries retain authorship and provenance; accepted decisions are separate from quoted speech. Call state open does not mean ringing. Unsupported: soft waiting, multiple Goals/questions, outcome admission, and re-presentation of an existing request. Create a Goal explicitly first; never resend a pending ask to continue waiting.";
 var CreateGoalSchema = z2.object({
   outcome: z2.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
+   *  rings"). Omit it and the brain writes one at admission from the outcome. */
+  title: z2.string().trim().min(1).max(80).optional(),
   ownerParticipant: z2.string().trim().min(1).optional(),
   idempotencyKey: z2.string().trim().min(1).max(200),
   /** A past conversation this Goal should be read against — History's "new session from this"
@@ -81,11 +84,14 @@ var CreateGoalSchema = z2.object({
 var CreateGoalToolSchema = CreateGoalSchema.extend({
   idempotencyKey: CreateGoalSchema.shape.idempotencyKey.optional().describe("Optional. One is minted per call; pass your own only so a retry lands on the same Goal.")
 }).strict();
-var CREATE_GOAL_DESCRIPTION = "Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Admission only: the owner must claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.";
+var CREATE_GOAL_DESCRIPTION = 'Create a durable Goal for an outcome. Without parentGoalId it is placed against your open Goals: if one already IS this work, that Goal comes back (existing: true) and nothing new is created \u2014 continue it; if the work belongs under one, it is created there (parentGoalId in the receipt); otherwise it is a root. Pass parentGoalId yourself to put it under a specific Goal. Pass title to name it in one to five words, as a person would refer to it out loud ("the night rings") \u2014 it heads every list and is spoken on a call; without one the brain writes it. Admission only: the owner must claim it before doing work, then update it as it advances. Returns an admission receipt with goalId, current state, revision, ownerParticipant, and the next step; no Goal content or execution lease.';
 var UpdateGoalSchema = z2.object({
   revision: z2.number().int().positive(),
   changes: z2.object({
     outcome: z2.string().trim().min(1).max(1e4).optional(),
+    /** The work's NAME (#2115) — one to five words, how a person refers to it out loud. The
+     *  brain writes one at admission; this is the owner saying it better. Null clears it. */
+    title: z2.string().trim().min(1).max(80).nullable().optional(),
     ownerParticipant: z2.string().trim().min(1).optional(),
     parentGoalId: z2.string().uuid().nullable().optional(),
     dependencies: z2.array(z2.object({ goalId: z2.string().uuid(), gate: z2.enum(["start", "finish"]) }).strict()).optional(),
@@ -101,10 +107,10 @@ var UpdateGoalSchema = z2.object({
 var UpdateGoalToolSchema = UpdateGoalSchema.omit({ operationId: true }).extend({ goalId: z2.string().uuid() }).strict();
 var ClaimGoalSchema = z2.object({ goalId: z2.string().uuid().optional() }).strict();
 var GetGoalSchema = z2.object({ goalId: z2.string().uuid() }).strict();
-var GET_GOAL_DESCRIPTION = "Read the current authorized Goal brief: state, owner, blockers, open decisions, progress, and the next operation. 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, and review acknowledgement are explicit; stale revisions are rejected. 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 new revision and a prose summary.";
-var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal you own, or pass goalId to claim that Goal. Returns a Goal-scoped brief, current revision, blockers, and the next valid operation. Claiming 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, the newest words in brief, accepted decisions and open decision needs, without the Entries. 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 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 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 = z2.object({}).strict();
 var GetThreadSchema = z2.object({
   parentId: z2.string().describe("The Thread to read \u2014 the threadId a Delivery returned, or the parentId of a search hit.")
@@ -126,7 +132,7 @@ var AGENT_TOOLS = [
 ];
 var AGENT_TOOL_NAMES = AGENT_TOOLS.map((t) => t.name);
 function serverInstructions(_opts) {
-  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 its durable Entries and accepted decisions. get_goal rereads the same evidence without consuming it. Contact only for an existing Goal. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. On stdio, Calls hold one bounded window; on hosted MCP, Calls return after one read; continue with contact({deliveryId}) to reread that exact Delivery. Evidence can repeat: reads do not acknowledge or hide it. Use update_goal to report progress and explicitly acknowledge review. Never infer ringing from an open Call Delivery. Soft waiting, multipart contact, and re-presentation are unsupported. In an interactive session, ask the user directly; use Paigy when they asked for it or are away.";
+  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. Contact only for an existing Goal. Notifications return immediately: keep working and collect answers through claim_goal/get_goal. On stdio, Calls hold one bounded window; on hosted MCP, Calls return after one read; continue with contact({deliveryId}) to reread that exact Delivery. Evidence can repeat: reads do not acknowledge or hide it. Use update_goal to report progress and explicitly acknowledge review. Never infer ringing from an open Call Delivery. Soft waiting, multipart contact, and re-presentation are unsupported. In an interactive session, ask the user directly; use Paigy when they asked for it or are away.";
 }
 function entryWords(entry) {
   const content = entry.content;
@@ -143,6 +149,7 @@ function entryWords(entry) {
   }
   return entry.sources.map((source) => source.text).join("\n");
 }
+var LIVE_MS = 3 * 6e4;
 var ContextSchema = z3.object({
   title: z3.string().min(1).describe("One-line headline of what you need (required, non-empty)."),
   description: z3.array(z3.string().min(1)).describe(
@@ -924,7 +931,19 @@ var QueueQuestionSchema = z3.object({
   /** The ruling in the person's own words, from the contribution that replied — not the
    *  option id, which is not something anyone reads back. Null while it is open, and null
    *  for a settled question whose reply carried nothing readable. */
-  answer: z3.string().nullable().default(null)
+  answer: z3.string().nullable().default(null),
+  /** The Goal this question belongs to — a step knows its Goal on its own, not only through
+   *  an `InboxItem`'s `communication.goalIds[0]` (walk/design.md §12 item 3).
+   *  READ BY `apps/client/src/walk/order.ts`, which stamps it onto every `WalkStep`: the walk's
+   *  order, its route, home's trees and the list of steps all take a step's Goal from here, so
+   *  this is the field they agree through rather than each re-deriving it from the row it
+   *  arrived under. Required because the API projects it on every need it sends. */
+  goalId: z3.string(),
+  /** True only while an unmet START gate holds the Goal — a Goal that merely waits to
+   *  *finish* does not stop a person from answering (owner, 2026-09-16: "per need gate from
+   *  the API"; §4's dashed node). Not the same fact as `QueueItem.blocked`, which counts any
+   *  gate at all. */
+  blocked: z3.boolean().default(false)
 });
 var QueueItemSchema = z3.object({
   id: z3.string(),
@@ -1061,25 +1080,6 @@ var DeliveryConfigSchema = z3.object({
    *  carries credentials; only a `poll` registration can come back with null here. */
   realtime: z3.object({ url: z3.string(), anonKey: z3.string() }).nullable()
 });
-var StatusSchema = z3.object({
-  name: z3.string(),
-  sessionMode: z3.enum(["default", "all_calls", "silent"]),
-  /** A phone is registered for push/ring (any push token on the account). */
-  phone: z3.boolean(),
-  /** HOW MANY THINGS ARE WAITING ON THIS IDENTITY — replies it never collected and requests
-   *  it never picked up. THE SAME NUMBER the harness's wake gate reads
-   *  (`pendingSummary.unacknowledged`), from the same function, because a statusline saying
-   *  zero while the sweep sees one is two ideas of "waiting".
-   *
-   *  Why it is here at all (owner, 2026-09-07): nothing can interrupt an idle agent process
-   *  that nobody spawned, so a terminal session only learns of work by asking. The harness
-   *  used to paper over that by spawning a SECOND process on the identity; now it stands
-   *  back, correctly, and the person sitting at the terminal is the one who can act. A
-   *  coffee-beans request sat unread for three days.
-   *
-   *  Optional: an older API sends no field, and the statusline then renders exactly as before. */
-  waiting: z3.number().int().nonnegative().optional()
-});
 var EnvelopeRecipientSchema = z3.object({
   keyId: z3.string(),
   epk: z3.string(),

package/dist/enable.js

@@ -2,9 +2,9 @@
 import {
   PAIGY_TOOL_IDS,
   enablePaigyTools
-} from "./chunk-QINMT6C2.js";
-import "./chunk-Z6S4THWU.js";
-import "./chunk-MD37G3TI.js";
+} from "./chunk-GQ5J6WW5.js";
+import "./chunk-XOL6UX6P.js";
+import "./chunk-BT5S7VT2.js";
 
 // src/enable.ts
 function main() {

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-7VMR7ONL.js";
+} from "./chunk-DRRAJMEE.js";
 import {
   ENABLE_COMMAND,
   OnboardSchema,
@@ -16,8 +16,8 @@ import {
   autoConfigureClients,
   claudeInstallHint,
   paigyToolsAllowlisted
-} from "./chunk-QINMT6C2.js";
-import "./chunk-Z6S4THWU.js";
+} from "./chunk-GQ5J6WW5.js";
+import "./chunk-XOL6UX6P.js";
 import {
   clearSurface,
   writeSurface
@@ -38,7 +38,7 @@ import {
   setIdentity,
   slotName,
   whoAmI
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";

package/dist/listen.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   entryWords
-} from "./chunk-Z6S4THWU.js";
+} from "./chunk-XOL6UX6P.js";
 import {
   checkReplies,
   contact,
   getGoal,
   subscribeWake
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.js";
 
 // src/listen.ts
 import { spawn } from "child_process";
@@ -129,7 +129,7 @@ function launchEnv(waiting, reason, goalId) {
   put("PAIGY_DELIVERY_ID", lead.deliveryId);
   put("PAIGY_GOAL_ID", waiting.goal?.goalId ?? lead.goalIds[0]);
   put("PAIGY_CONTEXT_THREAD_ID", waiting.goal?.contextThreadId);
-  put("PAIGY_TEXT", saidIn(lead) || lead.message);
+  put("PAIGY_TEXT", saidIn(lead) || ("about" in lead ? lead.about : ""));
   return env;
 }
 async function sweep(reason, goalId) {

package/dist/onboard.js

@@ -3,13 +3,13 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-7VMR7ONL.js";
+} from "./chunk-DRRAJMEE.js";
 import {
   autoConfigureClients,
   claudeInstallHint,
   openBrowser
-} from "./chunk-QINMT6C2.js";
-import "./chunk-Z6S4THWU.js";
+} from "./chunk-GQ5J6WW5.js";
+import "./chunk-XOL6UX6P.js";
 import {
   AGENT_NAME,
   TOKEN_PATH,
@@ -20,7 +20,7 @@ import {
   saveToken,
   setIdentity,
   whoAmI
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.js";
 
 // src/onboard.ts
 function reportRegistered() {

package/dist/slot.js

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

package/dist/statusline.js

@@ -3,27 +3,15 @@ import {
   readSurface
 } from "./chunk-3SVNPJPN.js";
 import {
-  BACKEND_URL,
   listSlots,
-  reach,
   readToken,
   sessionSlot,
   slotName
-} from "./chunk-MD37G3TI.js";
+} from "./chunk-BT5S7VT2.js";
 
 // src/statusline.ts
-import { mkdirSync, readFileSync, realpathSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
+import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
-var DIR = join(homedir(), ".paigy");
-var CACHE = join(DIR, "status.json");
-var TTL_MS = 6e4;
-var MODE_LABEL = {
-  default: "default",
-  all_calls: "all calls",
-  silent: "silent"
-};
 function render(v) {
   switch (v.kind) {
     case "surface":
@@ -32,13 +20,8 @@ function render(v) {
       return "paigy: unpaired";
     case "device-only":
       return "paigy: paired \xB7 session hatches on first use";
-    case "session": {
-      const who = v.name ? `${v.name} \xB7 ` : "";
-      if (!v.status) return `paigy: ${who}revoked`;
-      const n = v.status.waiting ?? 0;
-      const waiting = n > 0 ? ` \xB7 ${n} waiting` : "";
-      return `paigy: ${who}${MODE_LABEL[v.status.sessionMode]} \xB7 ${v.status.phone ? "phone \u2713" : "no phone"}${waiting}`;
-    }
+    case "session":
+      return `paigy: ${v.name ?? "paired"}`;
   }
 }
 async function stdinSessionId(input = process.stdin) {
@@ -64,27 +47,6 @@ async function stdinSessionId(input = process.stdin) {
 function resolveSlot(sid) {
   return process.env.PAIGY_AGENT || sessionSlot(sid);
 }
-function readCache() {
-  try {
-    return JSON.parse(readFileSync(CACHE, "utf8"));
-  } catch {
-    return null;
-  }
-}
-async function fetchStatus(token) {
-  const res = await reach(`${BACKEND_URL}/api/status`, {
-    headers: { authorization: `Bearer ${token}` },
-    signal: AbortSignal.timeout(2e3)
-    // a statusline must render fast or not at all
-  });
-  if (res.status === 401) return null;
-  if (res.status === 404) {
-    if ((await res.text()).includes("not_found")) return null;
-    throw new Error("status 404");
-  }
-  if (!res.ok) throw new Error(`status ${res.status}`);
-  return await res.json();
-}
 async function main() {
   const surface = readSurface();
   if (surface) return render({ kind: "surface", ...surface });
@@ -93,17 +55,7 @@ async function main() {
   if (!token) {
     return render(listSlots().includes("Desktop") ? { kind: "device-only" } : { kind: "unpaired" });
   }
-  const name = slotName(slot);
-  const cached = readCache();
-  if (cached && Date.now() - cached.at < TTL_MS) return render({ kind: "session", name, status: cached.status });
-  try {
-    const status = await fetchStatus(token);
-    mkdirSync(DIR, { recursive: true });
-    writeFileSync(CACHE, JSON.stringify({ at: Date.now(), status }));
-    return render({ kind: "session", name, status });
-  } catch {
-    return cached ? render({ kind: "session", name, status: cached.status }) : "paigy: \u2026";
-  }
+  return render({ kind: "session", name: slotName(slot) });
 }
 function isEntry() {
   const arg = process.argv[1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/mcp",
-  "version": "0.40.6",
+  "version": "0.40.8",
   "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",