@paigy/mcp 0.8.1 → 0.8.2

package/README.md

@@ -20,7 +20,7 @@ approve).
 No clone needed. Add it to Claude Code (`-s user` = available in every project; drop it for just the current one):
 
 ```bash
-claude mcp add paigy -s user -- npx -y @paigy/mcp
+claude mcp add paigy -s user -- npx -y @paigy/mcp@latest
 ```
 
 Or wire it into any MCP client config:
@@ -30,7 +30,7 @@ Or wire it into any MCP client config:
   "mcpServers": {
     "paigy": {
       "command": "npx",
-      "args": ["-y", "@paigy/mcp"]
+      "args": ["-y", "@paigy/mcp@latest"]
     }
   }
 }
@@ -39,7 +39,7 @@ Or wire it into any MCP client config:
 First-time pairing (link the server to your Paigy account):
 
 ```bash
-npx -p @paigy/mcp paigy-mcp-onboard
+npx -p @paigy/mcp@latest paigy-mcp-onboard
 ```
 
 It talks to the hosted backend by default — no config needed. Set
@@ -50,7 +50,7 @@ It talks to the hosted backend by default — no config needed. Set
 Codex speaks MCP, so the same server drops in. Add it (writes `~/.codex/config.toml`):
 
 ```bash
-codex mcp add paigy --env PAIGY_AGENT=codex -- npx -y @paigy/mcp
+codex mcp add paigy --env PAIGY_AGENT=codex -- npx -y @paigy/mcp@latest
 ```
 
 Or add the entry to `~/.codex/config.toml` by hand:
@@ -58,16 +58,16 @@ Or add the entry to `~/.codex/config.toml` by hand:
 ```toml
 [mcp_servers.paigy]
 command = "npx"
-args = ["-y", "@paigy/mcp"]
+args = ["-y", "@paigy/mcp@latest"]
 env = { PAIGY_AGENT = "codex" }
 ```
 
-Then pair: `npx -p @paigy/mcp paigy-mcp-onboard` (or have the agent call the `pair` tool).
+Then pair: `npx -p @paigy/mcp@latest paigy-mcp-onboard` (or have the agent call the `pair` tool).
 
 ### Gemini CLI
 
 ```bash
-gemini mcp add -s user -e PAIGY_AGENT=gemini paigy npx -y @paigy/mcp
+gemini mcp add -s user -e PAIGY_AGENT=gemini paigy npx -y @paigy/mcp@latest
 ```
 
 `-s user` makes it available across all projects — omit it for just the current one.
@@ -78,14 +78,14 @@ Or add the entry to `~/.gemini/settings.json`:
   "mcpServers": {
     "paigy": {
       "command": "npx",
-      "args": ["-y", "@paigy/mcp"],
+      "args": ["-y", "@paigy/mcp@latest"],
       "env": { "PAIGY_AGENT": "gemini" }
     }
   }
 }
 ```
 
-Then pair: `npx -p @paigy/mcp paigy-mcp-onboard`.
+Then pair: `npx -p @paigy/mcp@latest paigy-mcp-onboard`.
 
 > `PAIGY_AGENT` just names the agent on the device-approval screen (defaults to
 > `mcp-agent`) — set it per client so you can tell your connected agents apart.
@@ -102,6 +102,17 @@ Then pair: `npx -p @paigy/mcp paigy-mcp-onboard`.
 
 - `PAIGY_BACKEND_URL` — the Paigy API base (defaults to the hosted backend).
 
+## Publishing (maintainers)
+
+Tool input schemas are generated from zod in `src/schema.ts` as draft-2020-12 JSON
+Schema, and `src/schema.test.ts` guards that every tool stays valid (strict clients
+like the Anthropic API reject anything else). **A schema fix only reaches agents once
+a new version is published to npm** — 0.8.0 once shipped *without* a committed fix and
+400'd strict clients for weeks. So after any change under `src/schema*` or the tool
+definitions: **bump the version and `pnpm publish`** (don't rely on the commit alone).
+Install recipes pin `@paigy/mcp@latest` so a fresh `npx` picks up the new version; if a
+stale one sticks, `rm -rf ~/.npm/_npx` and restart the client.
+
 ## License
 
 MIT

package/dist/{chunk-XXBSXCOC.js → chunk-AILC3H3U.js}

@@ -1,9 +1,13 @@
+import {
+  BACKEND_URL,
+  reach
+} from "./chunk-GU7C5H6L.js";
+
 // src/device.ts
 import { execFile } from "child_process";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir, platform } from "os";
 import { join } from "path";
-var BACKEND_URL = process.env.PAIGY_BACKEND_URL ?? "https://paigy.ai";
 var AGENT_NAME = process.env.PAIGY_AGENT ?? "mcp-agent";
 var TOKEN_PATH = join(homedir(), ".paigy", "token.json");
 function openBrowser(url) {
@@ -33,14 +37,14 @@ function deleteToken() {
   return true;
 }
 async function revokeToken(token) {
-  const res = await fetch(`${BACKEND_URL}/api/device/revoke`, {
+  const res = await reach(`${BACKEND_URL}/api/device/revoke`, {
     method: "POST",
     headers: { authorization: `Bearer ${token}` }
   });
   return res.ok;
 }
 async function requestCode(agent = AGENT_NAME) {
-  const res = await fetch(`${BACKEND_URL}/api/device/code`, {
+  const res = await reach(`${BACKEND_URL}/api/device/code`, {
     method: "POST",
     headers: { "content-type": "application/json" },
     body: JSON.stringify({ agent })
@@ -49,7 +53,7 @@ async function requestCode(agent = AGENT_NAME) {
   return await res.json();
 }
 async function pollToken(deviceCode) {
-  const res = await fetch(`${BACKEND_URL}/api/device/token`, {
+  const res = await reach(`${BACKEND_URL}/api/device/token`, {
     method: "POST",
     headers: { "content-type": "application/json" },
     body: JSON.stringify({ device_code: deviceCode })

package/dist/{chunk-2BJSWNUX.js → chunk-BUELEUTV.js}

@@ -1,3 +1,8 @@
+import {
+  BACKEND_URL,
+  reach
+} from "./chunk-GU7C5H6L.js";
+
 // ../../packages/schema/dist/index.js
 import { z } from "zod";
 var ContextSchema = z.object({
@@ -275,7 +280,6 @@ var SupportRequestSchema = z.object({
 import { existsSync, readFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-var BACKEND_URL = process.env.PAIGY_BACKEND_URL ?? "https://paigy.ai";
 var TOKEN_PATH = join(homedir(), ".paigy", "token.json");
 function loadToken() {
   if (process.env.PAIGY_TOKEN) return process.env.PAIGY_TOKEN;
@@ -296,7 +300,7 @@ function ensureAuthed(res) {
 }
 async function submitNotification(req) {
   const token = loadToken();
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/notify`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/notify`, {
     method: "POST",
     headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
     body: JSON.stringify(req)
@@ -313,7 +317,7 @@ async function awaitReply(notificationId, opts = {}) {
   const token = loadToken();
   const start = now();
   while (true) {
-    const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/await?notificationId=${encodeURIComponent(notificationId)}`, {
+    const res = ensureAuthed(await reach(`${BACKEND_URL}/api/await?notificationId=${encodeURIComponent(notificationId)}`, {
       headers: { authorization: `Bearer ${token}` }
     }));
     if (!res.ok) throw new Error(`await failed: ${res.status} ${await res.text()}`);
@@ -325,14 +329,14 @@ async function awaitReply(notificationId, opts = {}) {
 }
 async function checkReplies() {
   const token = loadToken();
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/pending`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/pending`, {
     headers: { authorization: `Bearer ${token}` }
   }));
   if (!res.ok) throw new Error(`check_replies failed: ${res.status} ${await res.text()}`);
   return await res.json();
 }
 async function setTaskState(id, state) {
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/notify/${id}/state`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/notify/${id}/state`, {
     method: "PATCH",
     headers: { "content-type": "application/json", authorization: `Bearer ${loadToken()}` },
     body: JSON.stringify({ state })
@@ -341,7 +345,7 @@ async function setTaskState(id, state) {
   return await res.json();
 }
 async function registerDelivery(mode) {
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/delivery`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/delivery`, {
     method: "POST",
     headers: { "content-type": "application/json", authorization: `Bearer ${loadToken()}` },
     body: JSON.stringify({ mode })
@@ -351,7 +355,7 @@ async function registerDelivery(mode) {
 }
 async function scheduleCallback(req) {
   const token = loadToken();
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/callback`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/callback`, {
     method: "POST",
     headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
     body: JSON.stringify(req)
@@ -361,7 +365,7 @@ async function scheduleCallback(req) {
 }
 async function pollAnswer(id) {
   const token = loadToken();
-  const res = ensureAuthed(await fetch(`${BACKEND_URL}/api/poll/${id}`, {
+  const res = ensureAuthed(await reach(`${BACKEND_URL}/api/poll/${id}`, {
     headers: { authorization: `Bearer ${token}` }
   }));
   if (!res.ok) throw new Error(`poll failed: ${res.status} ${await res.text()}`);

package/dist/chunk-GU7C5H6L.js

@@ -0,0 +1,15 @@
+// src/http.ts
+var BACKEND_URL = process.env.PAIGY_BACKEND_URL ?? "https://paigy.ai";
+var NETWORK_MSG = `Can't reach ${BACKEND_URL} \u2014 the connection was blocked or dropped before an HTTP response. If this agent runs in a sandboxed environment with a network allowlist (e.g. Claude Code on the web, CI), ask the user to add the Paigy domain (paigy.ai) to the environment's allowed domains, then retry.`;
+async function reach(url, init) {
+  try {
+    return await fetch(url, init);
+  } catch (e) {
+    throw new Error(`${NETWORK_MSG} (${e?.message ?? String(e)})`);
+  }
+}
+
+export {
+  BACKEND_URL,
+  reach
+};

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   scheduleCallback,
   setTaskState,
   submitNotification
-} from "./chunk-2BJSWNUX.js";
+} from "./chunk-BUELEUTV.js";
 import {
   deleteToken,
   openBrowser,
@@ -21,7 +21,8 @@ import {
   revokeToken,
   saveToken,
   sleep
-} from "./chunk-XXBSXCOC.js";
+} from "./chunk-AILC3H3U.js";
+import "./chunk-GU7C5H6L.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";

package/dist/listen.js

@@ -4,7 +4,8 @@ import {
   checkReplies,
   registerDelivery,
   wakeChannel
-} from "./chunk-2BJSWNUX.js";
+} from "./chunk-BUELEUTV.js";
+import "./chunk-GU7C5H6L.js";
 
 // src/listen.ts
 import { createClient } from "@supabase/supabase-js";

package/dist/onboard.js

@@ -7,7 +7,8 @@ import {
   requestCode,
   saveToken,
   sleep
-} from "./chunk-XXBSXCOC.js";
+} from "./chunk-AILC3H3U.js";
+import "./chunk-GU7C5H6L.js";
 
 // src/onboard.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/mcp",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Paigy MCP server — a voice inbox for your AI agents. Lets an agent notify a user and await their reply.",
   "license": "MIT",
   "type": "module",