@paigy/mcp 0.40.39 → 0.40.40

package/dist/{dist-DOFR2565.js → dist-EJWDUF5J.js}

@@ -11,6 +11,7 @@ import {
   NotifyRequestSchema,
   PROTO,
   RevokedError,
+  ServerFault,
   TOKEN_PATH,
   UnpairedError,
   acknowledge,
@@ -62,7 +63,7 @@ import {
   updateSlot,
   whoAmI,
   withCodexEnv
-} from "./chunk-X4UIGUEX.js";
+} from "./chunk-V4OVLFMP.js";
 export {
   AGENT_TOOLS,
   AGENT_TOOL_NAMES,
@@ -76,6 +77,7 @@ export {
   NotifyRequestSchema,
   PROTO,
   RevokedError,
+  ServerFault,
   TOKEN_PATH,
   UnpairedError,
   acknowledge,

package/dist/enable.js

@@ -3,9 +3,9 @@ import {
   PAIGY_TOOL_IDS,
   enablePaigyTools,
   installSessionListening
-} from "./chunk-4IAK4ATB.js";
-import "./chunk-QE33A5XK.js";
-import "./chunk-X4UIGUEX.js";
+} from "./chunk-PKJJSHLW.js";
+import "./chunk-H2EBILBE.js";
+import "./chunk-V4OVLFMP.js";
 
 // src/enable.ts
 function main() {

package/dist/index.js

@@ -6,10 +6,11 @@ import {
   clearPairing,
   identify,
   joinBackgroundPair,
+  pendingText,
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-PMZBYLLJ.js";
+} from "./chunk-6FG3PZR2.js";
 import {
   ConfigureSchema,
   ENABLE_COMMAND,
@@ -17,14 +18,18 @@ import {
   SERVER_INSTRUCTIONS,
   TOOLS,
   paigyToolsAllowlisted
-} from "./chunk-4IAK4ATB.js";
+} from "./chunk-PKJJSHLW.js";
 import {
+  ReachTeller,
   decideListen,
   existingListener,
   harnessDriven,
+  hookStale,
+  listenBlock,
   listenerKey,
-  wakeStatusPath
-} from "./chunk-QE33A5XK.js";
+  wakeStatusPath,
+  withReach
+} from "./chunk-H2EBILBE.js";
 import {
   clearSurface,
   writeSurface
@@ -45,7 +50,7 @@ import {
   setClient,
   slotName,
   whoAmI
-} from "./chunk-X4UIGUEX.js";
+} from "./chunk-V4OVLFMP.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -97,7 +102,25 @@ function afterUnpaired(hatched, deviceCredential) {
 }
 
 // src/index.ts
+var REACH = new ReachTeller();
 var JOIN_CAP_MS = 45e3;
+function listenFacts() {
+  const session = sessionId();
+  const slot = agentName();
+  const pid = existingListener(slot, process.env);
+  const client = server.getClientVersion?.()?.name;
+  return {
+    env: process.env,
+    pidAlive: pid !== null,
+    wake: readWakeStatus(wakeStatusPath(listenerKey(slot, process.env))),
+    ...pid !== null ? { pid } : {},
+    execPath: process.execPath,
+    listenJs: fileURLToPath(new URL("./listen.js", import.meta.url)),
+    slot,
+    session,
+    ...client ? { client } : {}
+  };
+}
 function pairedResult(token, sas, note) {
   clearSurface();
   const base = {
@@ -113,6 +136,11 @@ function pairedResult(token, sas, note) {
   base.enable_tool_ids = PAIGY_TOOL_IDS;
   base.enable_command = ENABLE_COMMAND;
   base.enable_prompt = "REQUIRED \u2014 before you do anything else, print `enable_command` to the user and say: \"Run this to let Paigy's tools work without an approval prompt each time \u2014 it only allowlists Paigy's own tools.\" Print it every time you pair; don't skip it.";
+  try {
+    const facts = listenFacts();
+    Object.assign(base, listenBlock(decideListen(facts), facts, hookStale()));
+  } catch {
+  }
   base.enable_apply = "You cannot apply this yourself, and must not try: it writes YOUR OWN permission allowlist, which hosts block as privilege escalation no matter what the user said here. PRINT the command and move on \u2014 don't wait for them to run it, and don't re-ask. Paigy's tools still work meanwhile; they just prompt for approval each time until the user runs it. If the host isn't Claude Code, tell them to add `enable_tool_ids` to that tool's own allowlist instead, merging \u2014 never clobbering.";
   return { content: [{ type: "text", text: JSON.stringify(base) }] };
 }
@@ -151,7 +179,7 @@ function renderPairOutcome(outcome, device_code) {
           text: JSON.stringify({
             status: "pending",
             device_code,
-            message: "Still awaiting approval \u2014 the user hasn't entered the code yet. Call configure again with this device_code RIGHT NOW to keep waiting; each call returns after ~45s so it can't be killed by a host tool-call timeout. Nothing is lost between calls: the code stays valid and approval keeps being polled in the background, so a re-call returns the instant they approve."
+            message: pendingText(outcome.kind === "pending" ? outcome.fault : void 0)
           })
         }]
       };
@@ -353,27 +381,23 @@ async function handleTool(request, signal) {
     // daemon is the `listen.js` beside our own entry, so the command never resolves a package.
     case "listen": {
       if (!harnessDriven(process.env) && !readToken()) throw new UnpairedError();
-      const slot = agentName();
-      const key = listenerKey(slot, process.env);
-      const pid = existingListener(slot, process.env);
-      const decision = decideListen({
-        env: process.env,
-        pidAlive: pid !== null,
-        wake: readWakeStatus(wakeStatusPath(key)),
-        ...pid !== null ? { pid } : {},
-        execPath: process.execPath,
-        listenJs: fileURLToPath(new URL("./listen.js", import.meta.url)),
-        slot,
-        session: sessionId()
-      });
-      return { content: [{ type: "text", text: JSON.stringify(decision) }] };
+      return { content: [{ type: "text", text: JSON.stringify(decideListen(listenFacts())) }] };
     }
     default: {
       const name = request.params.name;
       const result = await runTool(name, request.params.arguments ?? {}, { waits: true, signal });
       const sentAs = name === "contact" ? slotName(agentName()) : null;
       const shaped = sentAs && result && typeof result === "object" ? { ...result, sentAs } : result;
-      return { content: [{ type: "text", text: JSON.stringify(shaped) }] };
+      let reach = null;
+      try {
+        reach = await REACH.note(agentName(), name, {
+          facts: listenFacts,
+          poll: () => runTool("contact", { wait: false }, { waits: false, signal }),
+          now: Date.now
+        });
+      } catch {
+      }
+      return { content: [{ type: "text", text: JSON.stringify(withReach(shaped, reach)) }] };
     }
   }
 }

package/dist/listen.js

@@ -11,7 +11,7 @@ import {
   removeListenMark,
   wakeStatusPath,
   writeListenMark
-} from "./chunk-QE33A5XK.js";
+} from "./chunk-H2EBILBE.js";
 import {
   agentName,
   getGoals,
@@ -20,7 +20,7 @@ import {
   receive,
   slotName,
   subscribeWake
-} from "./chunk-X4UIGUEX.js";
+} from "./chunk-V4OVLFMP.js";
 
 // src/listen.ts
 import { createHash } from "crypto";
@@ -131,28 +131,51 @@ function listenOptions(argv) {
 }
 var { brief: BRIEF, release: RELEASE } = listenOptions(process.argv);
 var line = (text) => void process.stdout.write(text + "\n");
+var briefSeen = /* @__PURE__ */ new Set();
 var emit = (obj) => line(JSON.stringify(obj));
 var listeningAs = () => slotName(agentName()) ?? agentName();
 var SWEEP_EVERY_MS = Number(process.env.PAIGY_SWEEP_MS) || 9e4;
 function saidIn(delivery) {
   return ("entries" in delivery ? delivery.entries : []).filter((entry) => entry.kind === "contribution" && !entryUnit(entry)).map((entry) => entryWords(entry)).filter(Boolean).join("\n");
 }
+function newestSaid(delivery) {
+  const said = ("entries" in delivery ? delivery.entries : []).filter((entry) => entry.kind === "contribution" && !entryUnit(entry) && entryWords(entry));
+  const newest = said.reduce(
+    (best, e) => !best || Date.parse(e.createdAt) >= Date.parse(best.createdAt) ? e : best,
+    void 0
+  );
+  return newest ? entryWords(newest) : "";
+}
 function leadOf(deliveries, goalId) {
   return (goalId ? deliveries.find((d) => d.goalIds.includes(goalId)) : void 0) ?? deliveries[0];
 }
+function briefItems(waiting) {
+  return [
+    // A list row carries its newest words as `about`; a Delivery read in full carries its entries.
+    ...waiting.deliveries.map((d) => `d:${d.deliveryId}:${"entries" in d ? newestSaid(d) : d.about}`),
+    ...(waiting.review ?? []).map((g) => `r:${g.goalId}@${g.saidAt ?? ""}`),
+    ...(waiting.assigned ?? []).map((g) => `a:${g.goalId}`)
+  ];
+}
+function briefIsNew(reason, items, seen) {
+  const gained = items.some((i) => !seen.has(i));
+  for (const i of items) seen.add(i);
+  return reason === "boot" || gained;
+}
 function brief(waiting, reason, as, goalId) {
   const lead = leadOf(waiting.deliveries, goalId);
-  const stalled = waiting.stalled?.length ? ` \xB7 ${waiting.stalled.length} of your Goals stalled 3+ days: update, finish or cancel each` : "";
+  const stalled = waiting.stalled?.length ? ` \xB7 ${waiting.stalled.length} of your Goals stalled 3+ days: update, finish, cancel or defer each` : "";
   const review = waiting.review ?? [];
   const named = (goalId ? review.find((g) => g.goalId === goalId) : void 0) ?? review[0];
   const fresh = review.length ? ` \xB7 new on ${review.length === 1 ? "your Goal" : `${review.length} of your Goals`}, first ${named.goalId} ("${named.title}"): get_goals to read it` : "";
   const assigned = waiting.assigned ?? [];
   const mine = assigned.length ? ` \xB7 assigned to you: ${assigned.length === 1 ? "1 Goal" : `${assigned.length} Goals`}, first ${assigned[0].goalId} ("${assigned[0].title}"): get_goals({goalIds:[goalId]}) to read it; your first write starts it` : "";
   if (!lead) return `Paigy \xB7 ${reason === "boot" ? `listening as ${as}` : reason}${mine}${fresh || (mine ? "" : " \xB7 nothing waiting")}${stalled}`;
-  const said = saidIn(lead) || ("about" in lead ? lead.about : "");
+  const said = newestSaid(lead) || ("about" in lead ? lead.about : "");
   const shown = said.length > 160 ? `${said.slice(0, 160)}\u2026` : said;
   const goal = waiting.goal?.goalId ?? lead.goalIds[0];
-  return `Paigy \xB7 ${reason} \xB7 ${waiting.deliveries.length} waiting \xB7 lead ${lead.deliveryId} on Goal ${goal}: "${shown}"${mine}${fresh}${stalled}`;
+  const act = ` \xB7 get_goals({goalIds:["${goal}"]}) to read it in full, then contact to answer; nothing is acknowledged until contact({ackEventIds})`;
+  return `Paigy \xB7 ${reason} \xB7 ${waiting.deliveries.length} waiting \xB7 lead ${lead.deliveryId} on Goal ${goal}: "${shown}"${mine}${fresh}${stalled}${act}`;
 }
 function launchEnv(waiting, reason, goalId) {
   const env = { PAIGY_WORK: JSON.stringify(waiting), PAIGY_EVENT: reason };
@@ -177,7 +200,7 @@ async function sweep(reason, goalId, bridge = new WakeBridge(process.env, wakeSt
     const leadGoalId = lead?.goalIds[0];
     const goal = leadGoalId ? await getGoals([leadGoalId]).then(([g]) => ({ goalId: leadGoalId, progress: g.progress })).catch(() => null) : null;
     const waiting = { deliveries, goal, ...stalled?.length ? { stalled } : {}, ...review?.length ? { review } : {}, ...assigned?.length ? { assigned } : {} };
-    if (BRIEF) line(brief(waiting, reason, listeningAs(), goalId));
+    if (BRIEF && briefIsNew(reason, briefItems(waiting), briefSeen)) line(brief(waiting, reason, listeningAs(), goalId));
     else emit({ type: "sweep", reason, ...goalId ? { about: goalId } : {}, ...waiting });
     if (deliveries.length || waiting.review?.length || waiting.assigned?.length || reason === "boot" && waiting.stalled?.length) {
       let unreadable = false;
@@ -298,11 +321,14 @@ if (isEntry()) {
 export {
   SWEEP_EVERY_MS,
   brief,
+  briefIsNew,
+  briefItems,
   catchUpReason,
   coalesceSweeps,
   launchEnv,
   leadOf,
   listenOptions,
+  newestSaid,
   saidIn,
   sweep
 };

package/dist/onboard.js

@@ -3,13 +3,14 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-PMZBYLLJ.js";
+} from "./chunk-6FG3PZR2.js";
 import {
   autoConfigureClients,
   claudeInstallHint,
-  openBrowser
-} from "./chunk-4IAK4ATB.js";
-import "./chunk-QE33A5XK.js";
+  openBrowser,
+  removeOldGeminiHooks
+} from "./chunk-PKJJSHLW.js";
+import "./chunk-H2EBILBE.js";
 import {
   TOKEN_PATH,
   agentName,
@@ -20,7 +21,7 @@ import {
   saveToken,
   setIdentity,
   whoAmI
-} from "./chunk-X4UIGUEX.js";
+} from "./chunk-V4OVLFMP.js";
 
 // src/onboard.ts
 function reportRegistered() {
@@ -38,6 +39,12 @@ async function main() {
   console.log(`
 Paigy MCP onboarding (agent: "${agentName()}")
 `);
+  const removed = removeOldGeminiHooks();
+  if (removed.length) {
+    console.log("Removed Paigy's old turn-end reminder, which named the wrong agent or never ran, from:");
+    for (const path of removed) console.log(`  - ${path}`);
+    console.log("");
+  }
   const chosen = process.env.PAIGY_NAME ?? suggestedAgentName();
   if (readToken()) {
     let who = await whoAmI().catch(() => null);
@@ -90,6 +97,7 @@ Paigy MCP onboarding (agent: "${agentName()}")
   process.stdout.write("Waiting for approval");
   const deadline = Date.now() + start.expiresIn * 1e3;
   let shownSas = null;
+  let fault;
   while (Date.now() < deadline) {
     const outcome = await resolvePairing(start.deviceCode, Math.max(1e3, deadline - Date.now()));
     if (outcome.kind === "awaiting_confirm") {
@@ -107,6 +115,7 @@ This pairing is end-to-end encrypted. Verify this code matches the one on the ph
       continue;
     }
     if (outcome.kind === "pending") {
+      fault = outcome.fault;
       process.stdout.write(".");
       continue;
     }
@@ -127,7 +136,10 @@ Paired! Token saved to ${TOKEN_PATH} (mode 0600).`);
     reportRegistered();
     return;
   }
-  console.error("\n\nDevice code expired without approval. Please re-run onboarding.\n");
+  console.error(fault ? `
+
+Device code expired before approval could be checked: ${fault} Please re-run onboarding.
+` : "\n\nDevice code expired without approval. Please re-run onboarding.\n");
   process.exit(1);
 }
 main().catch((err) => {

package/dist/slot.js

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

package/dist/stalled.js

@@ -4,6 +4,9 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
+function speaksOn(event) {
+  return event !== "AfterAgent";
+}
 function agentFlag(argv) {
   const inline = argv.find((arg) => arg.startsWith("--agent="));
   if (inline) return inline.slice("--agent=".length) || null;
@@ -11,15 +14,16 @@ function agentFlag(argv) {
   if (at === -1) return null;
   return argv[at + 1] ?? null;
 }
-function stopReply(stalled, event = "Stop") {
+function stopReply(stalled) {
   if (!stalled.length) return null;
   const list = stalled.slice(0, 8).map((g) => `"${g.title}" (${g.goalId})`).join(", ");
   const more = stalled.length > 8 ? ` and ${stalled.length - 8} more` : "";
-  const reason = `Before you stop: ${stalled.length} of your Paigy Goals have had no progress for 3 days: ${list}${more}. For each, report where it stands with a contact update, or finish or cancel it with manage_goals.`;
-  return event === "AfterAgent" ? { decision: "block", reason, systemMessage: reason } : { decision: "block", reason };
+  const reason = `Before you stop: ${stalled.length} of your Paigy Goals have had no progress for 3 days: ${list}${more}. For each, report where it stands with a contact update, or finish, cancel or defer it with manage_goals.`;
+  return { decision: "block", reason };
 }
 async function main() {
   const input = JSON.parse(readFileSync(0, "utf8") || "{}");
+  if (!speaksOn(input.hook_event_name ?? "Stop")) return;
   if (input.stop_hook_active) return;
   const session = input.session_id ?? "";
   if (session) process.env.PAIGY_SESSION_ID = session;
@@ -29,8 +33,8 @@ async function main() {
   const dir = join(homedir(), ".paigy", "stalled-reminded");
   const mark = join(dir, `${session || "session"}-${day}`);
   if (existsSync(mark)) return;
-  const { receive } = await import("./dist-DOFR2565.js");
-  const reply = stopReply((await receive()).stalled ?? [], input.hook_event_name ?? "Stop");
+  const { receive } = await import("./dist-EJWDUF5J.js");
+  const reply = stopReply((await receive()).stalled ?? []);
   if (!reply) return;
   mkdirSync(dir, { recursive: true });
   writeFileSync(mark, "");
@@ -39,5 +43,6 @@ async function main() {
 if (process.argv[1] && /stalled(\.[jt]s)?$/.test(process.argv[1])) main().catch(() => void 0);
 export {
   agentFlag,
+  speaksOn,
   stopReply
 };

package/dist/statusline.js

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

package/package.json

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