@paigy/mcp 0.40.10 → 0.40.11

package/dist/{chunk-QAQET3PZ.js → chunk-FQVK7SO4.js}

@@ -2,10 +2,10 @@ import {
   AGENT_TOOLS,
   mcpInputSchema,
   serverInstructions
-} from "./chunk-UFOR2QEP.js";
+} from "./chunk-I5QINUN6.js";
 import {
   agentName
-} from "./chunk-HCCUK3ZL.js";
+} from "./chunk-H5GGWCPS.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-HCCUK3ZL.js → chunk-H5GGWCPS.js}

@@ -1301,6 +1301,7 @@ var zodToJsonSchema = (schema, options) => {
 };
 var OPTIONS_MIN = 2;
 var OPTIONS_MAX = 6;
+var NIGHT = { from: 23, to: 7 };
 function draft2020(node) {
   if (Array.isArray(node)) return node.map(draft2020);
   if (node && typeof node === "object") {
@@ -1332,7 +1333,7 @@ function mcpInputSchema(s) {
 }
 var AskInputSchema = z.object({
   id: z.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: z.string().uuid().optional().describe("Optional explicit parent Goal ID. If omitted, the platform's semantic router will auto-cluster it."),
+  parentId: z.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: z.string().optional().describe("Optional repository context."),
   ask: z.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."
@@ -1351,7 +1352,7 @@ var StartContactSchema = z.object({
 }).strict();
 var ContactSchema = z.union([StartContactSchema, z.object({ deliveryId: z.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'. The platform will semantically cluster your asks under the correct Goals automatically. 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}. Never bundle multiple questions into a single 'ask' string; pass them as separate objects in the 'asks' array.";
 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
@@ -1407,9 +1408,9 @@ var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal y
 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.")
+  parentId: z2.string().describe("The Thread to read \u2014 the parentId of a search_threads hit.")
 }).strict();
-var GET_THREAD_DESCRIPTION = "Read the authorized durable Entries on one conversation Thread \u2014 what you wrote there and what was delivered to you, oldest first. Use claim_goal to find the work to resume; use this to rehydrate a Thread that a search hit or a Delivery named.";
+var GET_THREAD_DESCRIPTION = "Read the authorized durable Entries on one conversation Thread \u2014 what you wrote there and what was delivered to you, oldest first. Use claim_goal to find the work to resume and get_goal for the conversation on a Goal; use this only to rehydrate a Thread that a search hit named.";
 var SearchThreadsSchema = z2.object({
   q: z2.string().describe("What to look for \u2014 plain words or a phrase (e.g. 'the livekit timeout', 'deploy to prod').")
 }).strict();
@@ -1887,7 +1888,7 @@ var InboxItemSchema = z3.object({
   error: z3.string().optional(),
   clarifies: z3.string().optional(),
   /** The ring ladder ran out while this was still pending — we tried to reach you and
-   *  STOPPED trying (`arbitration/arbitrate.ts` `nextRing` → `stop`). Distinct from an
+   *  STOPPED trying (`arbitration/arbitrate.ts` `ringAt` → null). Distinct from an
    *  agent with nothing to say, which the roster drew identically until now: "nothing to
    *  say" and "gave up saying it" are opposite situations wearing the same face
    *  (navigation-design.md, gap 1). False for anything that never rang. */
@@ -1956,6 +1957,8 @@ var MissedCallSchema = z3.enum([
   "inbox",
   "dismiss"
 ]);
+var clock = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
+var QUIET = ` Nothing rings from ${clock(NIGHT.from)} to ${clock(NIGHT.to)} your time; the count waits for morning.`;
 var BrokerTuningSchema = z3.object({
   /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
   ackVerbosity: z3.enum(["normal", "none"]).optional(),
@@ -2646,10 +2649,12 @@ async function contact(input, opts = {}) {
     deliveryId = deliveries[0]?.deliveryId ?? "";
     if (!deliveryId) throw new Error("Goal contact returned no valid Delivery identity");
   }
+  const all = deliveries.filter((d) => !!d.deliveryId && !!d.goalId);
   const read = async (signal2) => {
     const res = ensureAuthed(await send2(`${BACKEND_URL}/api/deliveries/${encodeURIComponent(deliveryId)}`, { headers, signal: signal2 }));
     if (!res.ok) await fail("read_delivery", res);
-    return await res.json();
+    const one = await res.json();
+    return all.length > 1 ? { ...one, deliveries: all } : one;
   };
   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);
@@ -2745,6 +2750,8 @@ function deliveryView(d) {
     state: d.state,
     goalIds: d.goalIds,
     conversation: conversation(d),
+    // Each ask's own Delivery when a contact carried several — the only handle on the others.
+    deliveries: d.deliveries,
     next: d.kind === "notification" ? "Answers land on the Goal: read them with claim_goal or get_goal. Do not poll this notification." : d.message
   });
 }

package/dist/{chunk-UFOR2QEP.js → chunk-I5QINUN6.js}

@@ -5,6 +5,7 @@ import { zodToJsonSchema } from "zod-to-json-schema";
 import { z } from "zod";
 var OPTIONS_MIN = 2;
 var OPTIONS_MAX = 6;
+var NIGHT = { from: 23, to: 7 };
 function draft2020(node) {
   if (Array.isArray(node)) return node.map(draft2020);
   if (node && typeof node === "object") {
@@ -36,7 +37,7 @@ function mcpInputSchema(s) {
 }
 var AskInputSchema = z.object({
   id: z.string().optional().describe("Optional idempotency key or client-side ID for this specific ask."),
-  parentId: z.string().uuid().optional().describe("Optional explicit parent Goal ID. If omitted, the platform's semantic router will auto-cluster it."),
+  parentId: z.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: z.string().optional().describe("Optional repository context."),
   ask: z.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."
@@ -55,7 +56,7 @@ var StartContactSchema = z.object({
 }).strict();
 var ContactSchema = z.union([StartContactSchema, z.object({ deliveryId: z.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'. The platform will semantically cluster your asks under the correct Goals automatically. 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}. Never bundle multiple questions into a single 'ask' string; pass them as separate objects in the 'asks' array.";
 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
@@ -111,9 +112,9 @@ var CLAIM_GOAL_DESCRIPTION = "Claim the oldest runnable or review-pending Goal y
 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.")
+  parentId: z2.string().describe("The Thread to read \u2014 the parentId of a search_threads hit.")
 }).strict();
-var GET_THREAD_DESCRIPTION = "Read the authorized durable Entries on one conversation Thread \u2014 what you wrote there and what was delivered to you, oldest first. Use claim_goal to find the work to resume; use this to rehydrate a Thread that a search hit or a Delivery named.";
+var GET_THREAD_DESCRIPTION = "Read the authorized durable Entries on one conversation Thread \u2014 what you wrote there and what was delivered to you, oldest first. Use claim_goal to find the work to resume and get_goal for the conversation on a Goal; use this only to rehydrate a Thread that a search hit named.";
 var SearchThreadsSchema = z2.object({
   q: z2.string().describe("What to look for \u2014 plain words or a phrase (e.g. 'the livekit timeout', 'deploy to prod').")
 }).strict();
@@ -129,14 +130,15 @@ var AGENT_TOOLS = [
   { name: "update_goal", description: UPDATE_GOAL_DESCRIPTION, inputSchema: mcpInputSchema(UpdateGoalToolSchema) }
 ];
 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 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. 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.
+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.
 
-CRITICAL PAIGY WORKFLOW PHILOSOPHY:
-1. Atomicity: Never dump a 5-part question into a single \`ask\`. Emit 5 separate objects in the \`asks\` array during a single \`contact\` call so the user can answer them independently.
-2. Tree Structure: Always pass \`parentId\` to deliberately nest sub-decisions under the overarching Goal, ensuring the user workspace remains a clean tree rather than a flat mess.
-3. Urgency: Use \`waiting: hard\` strictly for immediate, blocking decisions, and \`waiting: none\` for async, long-running progress updates or non-blocking questions.
-4. Asynchrony: Never hold the process open with while-loops. Let the current process finish or explicitly schedule wakeups, and rely on \`check_replies\` or \`claim_goal\` on the next wake to process asynchronous answers.`;
+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.
+2. Name the Goal you are working on as the ask's \`parentId\`: the question goes onto that Goal and its answer comes back there. Without one, Paigy places it.
+3. \`waiting: hard\` only for a decision you are blocked on; \`waiting: none\` for a question you can keep working around.
+4. Never hold the process open with while-loops. Let the current process finish or schedule a wakeup, and collect answers with \`check_replies\` or \`claim_goal\` on the next wake.`;
 }
 function entryWords(entry) {
   const content = entry.content;
@@ -600,7 +602,7 @@ var InboxItemSchema = z3.object({
   error: z3.string().optional(),
   clarifies: z3.string().optional(),
   /** The ring ladder ran out while this was still pending — we tried to reach you and
-   *  STOPPED trying (`arbitration/arbitrate.ts` `nextRing` → `stop`). Distinct from an
+   *  STOPPED trying (`arbitration/arbitrate.ts` `ringAt` → null). Distinct from an
    *  agent with nothing to say, which the roster drew identically until now: "nothing to
    *  say" and "gave up saying it" are opposite situations wearing the same face
    *  (navigation-design.md, gap 1). False for anything that never rang. */
@@ -669,6 +671,8 @@ var MissedCallSchema = z3.enum([
   "inbox",
   "dismiss"
 ]);
+var clock = (h) => h === 0 ? "midnight" : h === 12 ? "noon" : h < 12 ? `${h} am` : `${h - 12} pm`;
+var QUIET = ` Nothing rings from ${clock(NIGHT.from)} to ${clock(NIGHT.to)} your time; the count waits for morning.`;
 var BrokerTuningSchema = z3.object({
   /** 'none' = skip the spoken ack after a mapped answer (power users find it slow). */
   ackVerbosity: z3.enum(["normal", "none"]).optional(),

package/dist/{chunk-AK5AVPF6.js → chunk-XIHVHYDU.js}

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

package/dist/enable.js

@@ -2,9 +2,9 @@
 import {
   PAIGY_TOOL_IDS,
   enablePaigyTools
-} from "./chunk-QAQET3PZ.js";
-import "./chunk-UFOR2QEP.js";
-import "./chunk-HCCUK3ZL.js";
+} from "./chunk-FQVK7SO4.js";
+import "./chunk-I5QINUN6.js";
+import "./chunk-H5GGWCPS.js";
 
 // src/enable.ts
 function main() {

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-AK5AVPF6.js";
+} from "./chunk-XIHVHYDU.js";
 import {
   ENABLE_COMMAND,
   OnboardSchema,
@@ -14,8 +14,8 @@ import {
   SERVER_INSTRUCTIONS,
   TOOLS,
   paigyToolsAllowlisted
-} from "./chunk-QAQET3PZ.js";
-import "./chunk-UFOR2QEP.js";
+} from "./chunk-FQVK7SO4.js";
+import "./chunk-I5QINUN6.js";
 import {
   clearSurface,
   writeSurface
@@ -35,7 +35,7 @@ import {
   setIdentity,
   slotName,
   whoAmI
-} from "./chunk-HCCUK3ZL.js";
+} from "./chunk-H5GGWCPS.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-UFOR2QEP.js";
+} from "./chunk-I5QINUN6.js";
 import {
   checkReplies,
   contact,
   getGoal,
   subscribeWake
-} from "./chunk-HCCUK3ZL.js";
+} from "./chunk-H5GGWCPS.js";
 
 // src/listen.ts
 import { spawn } from "child_process";

package/dist/onboard.js

@@ -3,13 +3,13 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-AK5AVPF6.js";
+} from "./chunk-XIHVHYDU.js";
 import {
   autoConfigureClients,
   claudeInstallHint,
   openBrowser
-} from "./chunk-QAQET3PZ.js";
-import "./chunk-UFOR2QEP.js";
+} from "./chunk-FQVK7SO4.js";
+import "./chunk-I5QINUN6.js";
 import {
   TOKEN_PATH,
   agentName,
@@ -20,7 +20,7 @@ import {
   saveToken,
   setIdentity,
   whoAmI
-} from "./chunk-HCCUK3ZL.js";
+} from "./chunk-H5GGWCPS.js";
 
 // src/onboard.ts
 function reportRegistered() {

package/dist/slot.js

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

package/dist/statusline.js

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

package/package.json

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