@paigy/mcp 0.40.24 → 0.40.26

package/README.md

@@ -117,18 +117,27 @@ Then pair: `PAIGY_AGENT=gemini npx -p @paigy/mcp@latest paigy-mcp-onboard`.
 ## Tools
 
 One catalog, on every transport (2026-09-11): the agent tools are `AGENT_TOOLS` in
-`packages/schema/src/tools.ts` — contact, check_replies, create_goal, claim_goal,
-get_goal, update_goal — and both this server and the hosted MCP
+`packages/schema/src/tools.ts` — who_is_working, contact, manage_goals, claim_goal,
+get_goal, search, send_feedback — and both this server and the hosted MCP
 (`apps/api/src/mcp`) publish that list and dispatch it through the SDK's one `runTool`.
 This server adds only onboard, pair and unpair, the tools that mint and delete the token
-file this machine holds. See the [SDK contract](../../packages/sdk/README.md) for the
-single-Goal start shape. Notification returns immediately. Call holds one cancellable
-~45-second window here (the hosted transport returns after one read); continue with
-contact({deliveryId}) without sending another ask. Durable Entries and accepted answers can
-repeat on reads; check_replies lists every open Delivery addressed to you (a request the
-user started toward you, an answer relayed to something you asked, a handoff) without
-consuming any of it, and claim_goal is the catch-up for your own Goals. Bookkeeping ids
-(`operationId`, `idempotencyKey`) are minted here, never asked of the model. Retired
+file this machine holds, and listen. See the [SDK contract](../../packages/sdk/README.md) for the
+contact shape. Sending returns immediately unless it asks to `wait`: `wait: true` holds one
+cancellable ~45-second window here for a response to what was sent (the hosted transport
+returns after one read), and `contact({})` holds one for anything addressed to you; after an
+`expired` window, wait again without sending again. Every Goal a contact names must already
+exist (create it with manage_goals); a question with `workItBlocks` asks for a call; a
+question, an update or an answer is at most 250 characters with its context in `units`; and
+`withdrawQuestionIds` takes back a question of yours. `update_goal` is gone (2026-10-07): progress
+is a contact update (one the person does not need yet is kept as the Goal's progress), a review is
+acknowledged with `ackEventIds`, and a Goal is postponed with manage_goals `defer` (you are woken
+when its time comes). Durable Entries and accepted answers can
+repeat on reads; contact with nothing to send receives what is addressed to you (a request the
+user started toward you, an answer relayed to something you asked, a handoff, a question you owe) without
+consuming any of it until you acknowledge it (`ackEventIds`), and claim_goal is the catch-up for
+your own Goals. manage_goals creates, edits, assigns, organizes and closes work, a change at a
+time. Bookkeeping (`operationId`, the manage request id, the revision an edit was read at) is
+minted here, never asked of the model. Retired
 reply-lease/ACK/work/callback tools and hidden notification aliases are rejected.
 
 The standalone listener below is still a **legacy host and target-release blocker**.
@@ -154,7 +163,7 @@ wake channel and reads what is waiting on every nudge. Keep it alive past the te
 with `paigy-listen --install` (launchd on macOS, systemd user unit on Linux;
 `--uninstall` removes it).
 
-The read is `check_replies` — the open Deliveries addressed to this agent — and it
+The read is `receive` (behind `contact({})`) — the open Deliveries addressed to this agent — and it
 **consumes nothing**: no lease, no acknowledgement, and the same read twice returns the
 same list. So the daemon hands the launcher what it found and stops there; claiming is
 the agent's own first act (`claim_goal`), because the daemon shares this machine's
@@ -169,7 +178,7 @@ To launch an agent — any agent, not just Claude — when work arrives, set
 | `PAIGY_WORK` | everything the wake found, as JSON (`deliveries`, `goal`) |
 | `PAIGY_EVENT` | the wake that caused this run — `boot`, `wake:reply`, `wake:request`… |
 | `PAIGY_PARENT_ID` | the thread to continue on (`PAIGY_THREAD_ID` is the same value, for existing scripts) |
-| `PAIGY_DELIVERY_ID` | the Delivery being acted on — `contact({deliveryId})` rereads it |
+| `PAIGY_DELIVERY_ID` | the Delivery being acted on (`get_goal` on `PAIGY_GOAL_ID` reads its conversation) |
 | `PAIGY_GOAL_ID` | the Goal it belongs to — `claim_goal` it **first** |
 | `PAIGY_TEXT` | what the person said, in prose |
 
@@ -231,7 +240,7 @@ codex exec "Paigy goal $PAIGY_GOAL_ID. claim_goal it first. The user said: $PAIG
 ## 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
+reading one rule (no progress for 3 days, `COLD_AFTER_MS`): `contact({})` lists it under
 `stalled`, `paigy-listen` carries it in `PAIGY_WORK` (and launches for it on boot), and this
 hook holds a session's turn end once a day to list it. One program, four tools:
 

package/dist/{chunk-J7T3EB5Y.js → chunk-5MQ3J6S3.js}

@@ -4,12 +4,12 @@ import {
   serverInstructions,
   sessionStartHook,
   withSessionStartHook
-} from "./chunk-VUKR2E24.js";
+} from "./chunk-7LQKX73K.js";
 import {
   CODEX_ENV,
   agentName,
   withCodexEnv
-} from "./chunk-WR2M3RME.js";
+} from "./chunk-OVSAQW3K.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.";
@@ -51,7 +51,7 @@ var IDENTITY_TOOLS = [
   },
   {
     name: "listen",
-    description: "Am I listening for answers, and can Paigy resume this session? Takes no arguments. Returns status `listening` for harness delivery or a running listener with a ready wake adapter; `receiving` means a process is running but automatic resume is not confirmed (read its wake error or watch its output); `unpaired` means call onboard; `start` gives the exact command to run NOW as a watched background task for this session. Start it once. Codex queues into CODEX_THREAD_ID automatically when its CLI supports queue; PAIGY_ON_WAKE overrides it. A successful queue is not evidence the agent handled the answer: read check_replies and the relevant Goal, then respond with contact. This tool never subscribes or starts anything itself.",
+    description: "Am I listening for answers, and can Paigy resume this session? Takes no arguments. Returns status `listening` for harness delivery or a running listener with a ready wake adapter; `receiving` means a process is running but automatic resume is not confirmed (read its wake error or watch its output); `unpaired` means call onboard; `start` gives the exact command to run NOW as a watched background task for this session. Start it once. Codex queues into CODEX_THREAD_ID automatically when its CLI supports queue; PAIGY_ON_WAKE overrides it. A successful queue is not evidence the agent handled the answer: receive with contact({ wait: false }) and read the relevant Goal, then respond with contact. This tool never subscribes or starts anything itself.",
     inputSchema: mcpInputSchema(z.object({}))
   }
 ];