@paigy/mcp 0.40.11 → 0.40.14

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

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

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

@@ -1,11 +1,13 @@
 import {
   AGENT_TOOLS,
   mcpInputSchema,
-  serverInstructions
-} from "./chunk-I5QINUN6.js";
+  serverInstructions,
+  sessionStartHook,
+  withSessionStartHook
+} from "./chunk-NOZRU5CD.js";
 import {
   agentName
-} from "./chunk-H5GGWCPS.js";
+} from "./chunk-R2GTL7N3.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.";
@@ -44,6 +46,15 @@ var IDENTITY_TOOLS = [
     name: "unpair",
     description: "Log out / unpair this agent from the user's Paigy account: revokes the token server-side (it stops working everywhere) and deletes the local ~/.paigy/token.json. Takes no arguments. After this, contact won't work until the user pairs again with the pair tool.",
     inputSchema: mcpInputSchema(z.object({}))
+  },
+  {
+    // A session asked to "start listening" can, in one call (#2265). Nothing can push an
+    // answer into a session started in a terminal — an answer waits for its next check_replies —
+    // and the only thing that reaches a running session mid-turn is a watched background task.
+    // So this tool decides and hands over: it never subscribes, spawns or writes settings.
+    name: "listen",
+    description: "Am I listening for answers, and if not, how do I start? Call it when the user asks you to start listening (or to stay reachable), and whenever you are unsure whether you are. Takes no arguments. Returns `status`: `listening` \u2014 nothing to do (a session started by the Paigy harness is ALWAYS listening: its pump types each answer in as it lands; or your own paigy-listen is already running, with its pid); `unpaired` \u2014 call onboard first; `start` \u2014 a `command` you MUST run NOW, in this same turn, as a watched BACKGROUND task (your harness's background-task/monitor tool), and leave running for the session. Each line that task prints is a Delivery waiting for you: claim_goal the Goal it names, read it, answer with contact. Start it once. This tool never subscribes or starts anything itself \u2014 the listener has to be YOUR watched task, or its lines reach no one.",
+    inputSchema: mcpInputSchema(z.object({}))
   }
 ];
 var TOOLS = [...AGENT_TOOLS, ...IDENTITY_TOOLS];
@@ -52,7 +63,7 @@ var HIDDEN_ALIASES = [];
 
 // src/clients.ts
 import { execFile } from "child_process";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir, platform } from "os";
 import { join, dirname } from "path";
 function openBrowser(url) {
@@ -208,6 +219,45 @@ function enablePaigyTools(scope = "user", cwd = process.cwd()) {
     already: PAIGY_TOOL_IDS.filter((t) => prevAllow.includes(t))
   };
 }
+var HOOK_CONFIGS = [
+  { harness: "Claude Code", path: () => join(homedir(), ".claude", "settings.json") },
+  { harness: "Codex", path: () => join(homedir(), ".codex", "hooks.json") }
+];
+function installSessionListening() {
+  const script = join(homedir(), ".paigy", "hooks", "session-start.sh");
+  try {
+    mkdirSync(dirname(script), { recursive: true });
+    writeFileSync(script, sessionStartHook(), { mode: 493 });
+    chmodSync(script, 493);
+  } catch (e) {
+    return [{ harness: "all", path: script, ok: false, why: e.message }];
+  }
+  const out = [];
+  for (const { harness, path: at } of HOOK_CONFIGS) {
+    const path = at();
+    if (!existsSync(dirname(path))) continue;
+    let existing = null;
+    try {
+      existing = existsSync(path) ? readFileSync(path, "utf8") : null;
+    } catch (e) {
+      out.push({ harness, path, ok: false, why: e.message });
+      continue;
+    }
+    const already = existing?.includes(script) ?? false;
+    const updated = withSessionStartHook(existing, script);
+    if (updated === null) {
+      out.push({ harness, path, ok: false, why: `${path} didn't parse as JSON \u2014 not overwriting it` });
+      continue;
+    }
+    try {
+      writeFileSync(path, updated + "\n");
+      out.push({ harness, path, ok: true, already });
+    } catch (e) {
+      out.push({ harness, path, ok: false, why: e.message });
+    }
+  }
+  return out;
+}
 
 export {
   SERVER_INSTRUCTIONS,
@@ -220,5 +270,6 @@ export {
   ENABLE_COMMAND,
   PAIGY_TOOL_IDS,
   paigyToolsAllowlisted,
-  enablePaigyTools
+  enablePaigyTools,
+  installSessionListening
 };

package/dist/enable.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import {
   PAIGY_TOOL_IDS,
-  enablePaigyTools
-} from "./chunk-FQVK7SO4.js";
-import "./chunk-I5QINUN6.js";
-import "./chunk-H5GGWCPS.js";
+  enablePaigyTools,
+  installSessionListening
+} from "./chunk-SO5NRTXG.js";
+import "./chunk-NOZRU5CD.js";
+import "./chunk-R2GTL7N3.js";
 
 // src/enable.ts
 function main() {
@@ -52,5 +53,9 @@ function main() {
   if (result.already.length && result.added.length) {
     console.log(`  (${result.already.length} already present)`);
   }
+  for (const hook of installSessionListening()) {
+    if (!hook.ok) console.log(`  ! ${hook.harness}: ${hook.why}`);
+    else console.log(`\u2713 ${hook.harness} sessions will be told to listen (${hook.path})${hook.already ? " \u2014 already set" : ""}`);
+  }
 }
 main();

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   resolvePairing,
   startPairing,
   suggestedAgentName
-} from "./chunk-XIHVHYDU.js";
+} from "./chunk-SKLVQ73Q.js";
 import {
   ENABLE_COMMAND,
   OnboardSchema,
@@ -14,8 +14,11 @@ import {
   SERVER_INSTRUCTIONS,
   TOOLS,
   paigyToolsAllowlisted
-} from "./chunk-FQVK7SO4.js";
-import "./chunk-I5QINUN6.js";
+} from "./chunk-SO5NRTXG.js";
+import {
+  decideListen,
+  listenerAlive
+} from "./chunk-NOZRU5CD.js";
 import {
   clearSurface,
   writeSurface
@@ -32,10 +35,11 @@ import {
   revokeToken,
   runTool,
   saveToken,
+  sessionId,
   setIdentity,
   slotName,
   whoAmI
-} from "./chunk-H5GGWCPS.js";
+} from "./chunk-R2GTL7N3.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -44,6 +48,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+import { fileURLToPath } from "url";
 import qrcode from "qrcode-generator";
 var JOIN_CAP_MS = 45e3;
 function pairedResult(token, sas, note) {
@@ -205,7 +210,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     return await handleTool(request, extra?.signal);
   } catch (e) {
     if (e instanceof UnpairedError) {
-      const IDENTITY_TOOLS = /* @__PURE__ */ new Set(["pair", "onboard", "unpair"]);
+      const IDENTITY_TOOLS = /* @__PURE__ */ new Set(["pair", "onboard", "unpair", "listen"]);
       const hatched = IDENTITY_TOOLS.has(request.params.name) ? null : await hatchUnderDevice();
       if (hatched) return await handleTool(request, extra?.signal);
       if (listSlots().includes("Desktop")) return unidentifiedResult();
@@ -304,6 +309,25 @@ async function handleTool(request, signal) {
         }]
       };
     }
+    // AM I LISTENING? (#2265) Decides and hands over — `listening.ts` owns the rule and the four
+    // answers. The facts are read here, once: the harness's session mark, a token to listen as,
+    // a live listener's mark for this slot, and where THIS server's node and daemon live. The
+    // daemon is the `listen.js` beside our own entry, so the command never resolves a package.
+    case "listen": {
+      const slot = agentName();
+      const pid = listenerAlive(slot);
+      const decision = decideListen({
+        env: process.env,
+        token: !!readToken(),
+        pidAlive: pid !== null,
+        ...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) }] };
+    }
     default: {
       const name = request.params.name;
       const result = await runTool(name, request.params.arguments ?? {}, { waits: true, signal });

package/dist/listen.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
 import {
-  entryWords
-} from "./chunk-I5QINUN6.js";
+  entryWords,
+  removeListenMark,
+  writeListenMark
+} from "./chunk-NOZRU5CD.js";
 import {
+  agentName,
   checkReplies,
   contact,
   getGoal,
+  slotName,
   subscribeWake
-} from "./chunk-H5GGWCPS.js";
+} from "./chunk-R2GTL7N3.js";
 
 // src/listen.ts
 import { spawn } from "child_process";
@@ -112,17 +116,34 @@ function uninstallService() {
 }
 
 // src/listen.ts
-var emit = (obj) => void process.stdout.write(JSON.stringify(obj) + "\n");
+function listenOptions(argv) {
+  const brief2 = argv.includes("--brief");
+  return { brief: brief2, release: !brief2 };
+}
+var { brief: BRIEF, release: RELEASE } = listenOptions(process.argv);
+var line = (text) => void process.stdout.write(text + "\n");
+var emit = (obj) => line(JSON.stringify(obj));
+var listeningAs = () => slotName(agentName()) ?? agentName();
 function saidIn(delivery) {
   return ("entries" in delivery ? delivery.entries : []).filter((entry) => entry.kind === "contribution").map((entry) => entryWords(entry)).filter(Boolean).join("\n");
 }
+function leadOf(deliveries, goalId) {
+  return (goalId ? deliveries.find((d) => d.goalIds.includes(goalId)) : void 0) ?? deliveries[0];
+}
+function brief(waiting, reason, as, goalId) {
+  const lead = leadOf(waiting.deliveries, goalId);
+  if (!lead) return reason === "boot" ? `Paigy \xB7 listening as ${as} \xB7 nothing waiting` : `Paigy \xB7 ${reason} \xB7 nothing waiting`;
+  const said = saidIn(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}"`;
+}
 function launchEnv(waiting, reason, goalId) {
   const env = { PAIGY_WORK: JSON.stringify(waiting), PAIGY_EVENT: reason };
   const put = (key, value) => {
     if (value) env[key] = value;
   };
-  const named = goalId ? waiting.deliveries.find((d) => d.goalIds.includes(goalId)) : void 0;
-  const lead = named ?? waiting.deliveries[0];
+  const lead = leadOf(waiting.deliveries, goalId);
   if (!lead) return env;
   put("PAIGY_DELIVERY_ID", lead.deliveryId);
   put("PAIGY_GOAL_ID", waiting.goal?.goalId ?? lead.goalIds[0]);
@@ -133,25 +154,31 @@ async function sweep(reason, goalId) {
   try {
     const cmd = process.env.PAIGY_ON_WAKE;
     const { deliveries: rows } = await checkReplies();
-    const lead = (goalId ? rows.find((d) => d.goalIds.includes(goalId)) : void 0) ?? rows[0];
+    const lead = leadOf(rows, goalId);
     const full = lead ? await contact({ deliveryId: lead.deliveryId }, { waits: false }).catch(() => null) : null;
     const deliveries = rows.map((d) => d === lead && full ? full : d);
     const leadGoalId = lead?.goalIds[0];
     const goal = leadGoalId ? await getGoal(leadGoalId).then((g) => ({ goalId: leadGoalId, progress: g.progress })).catch(() => null) : null;
     const waiting = { deliveries, goal };
-    emit({ type: "sweep", reason, ...goalId ? { about: goalId } : {}, ...waiting });
+    if (BRIEF) line(brief(waiting, reason, listeningAs(), goalId));
+    else emit({ type: "sweep", reason, ...goalId ? { about: goalId } : {}, ...waiting });
     if (cmd && deliveries.length) {
       spawn(cmd, { shell: true, stdio: "inherit", env: { ...process.env, ...launchEnv(waiting, reason, goalId) } });
     }
   } catch (e) {
-    emit({ type: "error", reason, message: e.message });
+    if (BRIEF) line(`Paigy \xB7 error \xB7 ${e.message}`);
+    else emit({ type: "error", reason, message: e.message });
   }
 }
 async function main() {
-  const sub = await subscribeWake((nudge) => void sweep(`wake:${nudge.kind ?? "?"}`, nudge.parentId));
-  emit({ type: "listening", channel: sub.channel });
+  const sub = await subscribeWake((nudge) => void sweep(`wake:${nudge.kind ?? "?"}`, nudge.parentId), { release: RELEASE });
+  const slot = agentName();
+  writeListenMark(slot, process.pid);
+  process.on("exit", () => removeListenMark(slot));
+  if (!BRIEF) emit({ type: "listening", channel: sub.channel });
   await sweep("boot");
   const shutdown = async () => {
+    removeListenMark(slot);
     await sub.close();
     process.exit(0);
   };
@@ -175,13 +202,17 @@ if (isEntry()) {
     emit({ type: "uninstalled", unit: uninstallService() });
   } else {
     main().catch((e) => {
-      emit({ type: "fatal", message: e.message });
+      if (BRIEF) line(`Paigy \xB7 error \xB7 ${e.message}`);
+      else emit({ type: "fatal", message: e.message });
       process.exit(1);
     });
   }
 }
 export {
+  brief,
   launchEnv,
+  leadOf,
+  listenOptions,
   saidIn,
   sweep
 };

package/dist/onboard.js

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

package/dist/slot.js

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

package/dist/statusline.js

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

package/package.json

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