@paigy/mcp 0.18.0 → 0.20.0

package/dist/{chunk-HAG2VWKB.js → chunk-HO3OJHRA.js}

@@ -1,6 +1,6 @@
 import {
   AGENT_NAME
-} from "./chunk-RMTTO6BI.js";
+} from "./chunk-VWQQ3VJF.js";
 
 // src/clients.ts
 import { execFile } from "child_process";

package/dist/{chunk-DSWZOBK5.js → chunk-SLWESECN.js}

@@ -329,8 +329,9 @@ var InboxItemSchema = z.object({
    *  ("call back after lunch") — shown so they can see the commitment was captured. */
   intents: z.array(IntentSchema).optional(),
   visuals: z.array(VisualSchema).optional(),
-  agent: z.string(),
-  nickname: z.string(),
+  /** The connected agent's name (the single pairing name — user-typed, or the
+   *  agent's suggestion, or a default silly name). */
+  name: z.string(),
   /** The pairing's assigned voice (#462); absent = the default voice. */
   voice: VoiceKeySchema.optional(),
   repo: z.string().optional(),
@@ -438,8 +439,8 @@ var HistoryItemSchema = z.object({
   /** 'user' = a request you sent; 'agent' = a notification an agent sent you. */
   initiator: z.enum(["user", "agent"]),
   title: z.string(),
-  /** The agent on the other end (nickname). */
-  agent: z.string(),
+  /** The agent on the other end (its name). */
+  name: z.string(),
   createdAt: z.string(),
   /** When the agent fetched your request (user→agent only). */
   agentAckedAt: z.string().nullable(),
@@ -449,9 +450,12 @@ var HistoryItemSchema = z.object({
 var ConnectionSummarySchema = z.object({
   /** The connection = the agent's token id (used to address a request). */
   id: z.string(),
-  agent: z.string(),
   device: z.string().nullable(),
-  nickname: z.string(),
+  /** The agent's display name (the single pairing name). */
+  name: z.string(),
+  /** For a managed connection, the provider key (e.g. "cma") that agentOrigin maps to a
+   *  label; null for a local connection. Sourced from the token's provider, not the name. */
+  provider: z.string().nullable(),
   /** The pairing's assigned voice (#462); null = the default voice. */
   voice: VoiceKeySchema.nullable(),
   createdAt: z.string().datetime(),
@@ -502,8 +506,7 @@ var DeliveryConfigSchema = z.object({
   realtime: z.object({ url: z.string(), anonKey: z.string() }).nullable()
 });
 var StatusSchema = z.object({
-  agent: z.string(),
-  nickname: z.string(),
+  name: z.string(),
   sessionMode: z.enum(["default", "all_calls", "silent"]),
   /** A phone is registered for push/ring (any push token on the account). */
   phone: z.boolean()
@@ -550,14 +553,6 @@ var WakeNudgeSchema = z.object({
   notificationId: z.string().optional(),
   threadId: z.string()
 });
-var DeviceAgentTokenSchema = z.object({
-  token: z.string(),
-  deviceId: z.string(),
-  agentName: z.string(),
-  /** User-chosen session label; defaults to `<agent> <device>`. */
-  nickname: z.string(),
-  createdAt: z.string().datetime()
-});
 var PairingStatusSchema = z.enum(["pending", "approved", "denied", "expired"]);
 var PairingRevealSchema = z.object({
   x25519: z.string(),
@@ -565,6 +560,12 @@ var PairingRevealSchema = z.object({
   nonce: z.string()
 });
 var DeviceCodeRequestSchema = z.object({
+  /** The agent's suggested name for the pairing — the human sees it pre-filled at
+   *  approval and can override. Optional; blank → a default silly name server-side. */
+  suggestedName: z.string().optional(),
+  /** Legacy alias for suggestedName (older MCPs sent `agent`). Accepted for
+   *  back-compat; `suggestedName` wins when both are present. ponytail: drop once no
+   *  pre-`name` MCP is in the wild. */
   agent: z.union([z.string(), z.object({ name: z.string().optional() })]).optional(),
   device: z.string().optional(),
   proto: z.string().optional(),
@@ -582,7 +583,9 @@ var DeviceCodeSchema = z.object({
 });
 var DeviceInfoSchema = z.object({
   code: z.string(),
-  agent: z.string(),
+  /** The agent's suggested name (from /device/code) — shown on the approval screen,
+   *  pre-filling the name field the human can edit. */
+  name: z.string(),
   device: z.string().nullable(),
   status: PairingStatusSchema,
   proto: z.string().nullable().optional(),
@@ -605,8 +608,9 @@ var DeviceTokenRequestSchema = z.object({
 });
 var DeviceTokenSchema = z.object({
   access_token: z.string(),
-  nickname: z.string(),
-  agent: z.string(),
+  /** The pairing's single name (user-typed at approval, the agent's suggestion, or
+   *  a default silly name). */
+  name: z.string(),
   device: z.string().nullable(),
   phone_reveal: PairingRevealSchema.nullable().optional(),
   // present once the phone reveals

package/dist/{chunk-RMTTO6BI.js → chunk-VWQQ3VJF.js}

@@ -2618,8 +2618,9 @@ var InboxItemSchema = z.object({
    *  ("call back after lunch") — shown so they can see the commitment was captured. */
   intents: z.array(IntentSchema).optional(),
   visuals: z.array(VisualSchema).optional(),
-  agent: z.string(),
-  nickname: z.string(),
+  /** The connected agent's name (the single pairing name — user-typed, or the
+   *  agent's suggestion, or a default silly name). */
+  name: z.string(),
   /** The pairing's assigned voice (#462); absent = the default voice. */
   voice: VoiceKeySchema.optional(),
   repo: z.string().optional(),
@@ -2727,8 +2728,8 @@ var HistoryItemSchema = z.object({
   /** 'user' = a request you sent; 'agent' = a notification an agent sent you. */
   initiator: z.enum(["user", "agent"]),
   title: z.string(),
-  /** The agent on the other end (nickname). */
-  agent: z.string(),
+  /** The agent on the other end (its name). */
+  name: z.string(),
   createdAt: z.string(),
   /** When the agent fetched your request (user→agent only). */
   agentAckedAt: z.string().nullable(),
@@ -2738,9 +2739,12 @@ var HistoryItemSchema = z.object({
 var ConnectionSummarySchema = z.object({
   /** The connection = the agent's token id (used to address a request). */
   id: z.string(),
-  agent: z.string(),
   device: z.string().nullable(),
-  nickname: z.string(),
+  /** The agent's display name (the single pairing name). */
+  name: z.string(),
+  /** For a managed connection, the provider key (e.g. "cma") that agentOrigin maps to a
+   *  label; null for a local connection. Sourced from the token's provider, not the name. */
+  provider: z.string().nullable(),
   /** The pairing's assigned voice (#462); null = the default voice. */
   voice: VoiceKeySchema.nullable(),
   createdAt: z.string().datetime(),
@@ -2789,8 +2793,7 @@ var DeliveryConfigSchema = z.object({
   realtime: z.object({ url: z.string(), anonKey: z.string() }).nullable()
 });
 var StatusSchema = z.object({
-  agent: z.string(),
-  nickname: z.string(),
+  name: z.string(),
   sessionMode: z.enum(["default", "all_calls", "silent"]),
   /** A phone is registered for push/ring (any push token on the account). */
   phone: z.boolean()
@@ -2837,14 +2840,6 @@ var WakeNudgeSchema = z.object({
   notificationId: z.string().optional(),
   threadId: z.string()
 });
-var DeviceAgentTokenSchema = z.object({
-  token: z.string(),
-  deviceId: z.string(),
-  agentName: z.string(),
-  /** User-chosen session label; defaults to `<agent> <device>`. */
-  nickname: z.string(),
-  createdAt: z.string().datetime()
-});
 var PairingStatusSchema = z.enum(["pending", "approved", "denied", "expired"]);
 var PairingRevealSchema = z.object({
   x25519: z.string(),
@@ -2852,6 +2847,12 @@ var PairingRevealSchema = z.object({
   nonce: z.string()
 });
 var DeviceCodeRequestSchema = z.object({
+  /** The agent's suggested name for the pairing — the human sees it pre-filled at
+   *  approval and can override. Optional; blank → a default silly name server-side. */
+  suggestedName: z.string().optional(),
+  /** Legacy alias for suggestedName (older MCPs sent `agent`). Accepted for
+   *  back-compat; `suggestedName` wins when both are present. ponytail: drop once no
+   *  pre-`name` MCP is in the wild. */
   agent: z.union([z.string(), z.object({ name: z.string().optional() })]).optional(),
   device: z.string().optional(),
   proto: z.string().optional(),
@@ -2869,7 +2870,9 @@ var DeviceCodeSchema = z.object({
 });
 var DeviceInfoSchema = z.object({
   code: z.string(),
-  agent: z.string(),
+  /** The agent's suggested name (from /device/code) — shown on the approval screen,
+   *  pre-filling the name field the human can edit. */
+  name: z.string(),
   device: z.string().nullable(),
   status: PairingStatusSchema,
   proto: z.string().nullable().optional(),
@@ -2892,8 +2895,9 @@ var DeviceTokenRequestSchema = z.object({
 });
 var DeviceTokenSchema = z.object({
   access_token: z.string(),
-  nickname: z.string(),
-  agent: z.string(),
+  /** The pairing's single name (user-typed at approval, the agent's suggestion, or
+   *  a default silly name). */
+  name: z.string(),
   device: z.string().nullable(),
   phone_reveal: PairingRevealSchema.nullable().optional(),
   // present once the phone reveals
@@ -3266,11 +3270,13 @@ async function revokeToken(token) {
   });
   return res.ok;
 }
-async function requestCode(agent2 = AGENT_NAME, e2ee) {
+async function requestCode(suggestedName = AGENT_NAME, e2ee) {
   const res = await reach(`${BACKEND_URL}/api/device/code`, {
     method: "POST",
     headers: { "content-type": "application/json" },
-    body: JSON.stringify(e2ee ? { agent: agent2, proto: e2ee.proto, commitment: e2ee.commitment } : { agent: agent2 })
+    body: JSON.stringify(
+      e2ee ? { suggestedName, proto: e2ee.proto, commitment: e2ee.commitment } : { suggestedName }
+    )
   });
   if (!res.ok) throw new Error(`/api/device/code failed: ${res.status} ${await res.text()}`);
   return await res.json();

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   HandoffSchema
-} from "./chunk-DSWZOBK5.js";
+} from "./chunk-SLWESECN.js";
 import {
   PAIGY_TOOL_IDS,
   autoConfigureClients,
   claudeInstallHint,
   enablePaigyTools
-} from "./chunk-HAG2VWKB.js";
+} from "./chunk-HO3OJHRA.js";
 import {
   clearSurface,
   writeSurface
@@ -38,7 +38,7 @@ import {
   sleep,
   startE2ee,
   submitNotification
-} from "./chunk-RMTTO6BI.js";
+} from "./chunk-VWQQ3VJF.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -189,8 +189,7 @@ function pairedResult(token, sas, note, e2ee) {
   clearSurface();
   const base = {
     status: "paired",
-    nickname: token.nickname,
-    agent: token.agent,
+    name: token.name,
     device: token.device
   };
   if (sas) {
@@ -322,7 +321,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "handoff",
-      description: "Deposit your working context for a SUCCESSOR agent \u2014 what you did, what's left, links, gotchas \u2014 as one note on a thread ({ title, notes[] }). This does NOT ring the user or enter their inbox: it's context, not a question. The successor reads it back with get_thread. Pass `target` (a sibling connection's token id or agent nickname, SAME account only) to hand off DIRECTLY to that agent \u2014 the note is dispatched to it as a request it picks up. Omit `target` to leave the thread for the user to hand off to an agent themselves in the app. Pass `threadId` to land the handoff on an existing conversation; omit it to mint a fresh thread. Returns { threadId }.",
+      description: "Deposit your working context for a SUCCESSOR agent \u2014 what you did, what's left, links, gotchas \u2014 as one note on a thread ({ title, notes[] }). This does NOT ring the user or enter their inbox: it's context, not a question. The successor reads it back with get_thread. Pass `target` (a sibling connection's token id or agent name, SAME account only) to hand off DIRECTLY to that agent \u2014 the note is dispatched to it as a request it picks up. Omit `target` to leave the thread for the user to hand off to an agent themselves in the app. Pass `threadId` to land the handoff on an existing conversation; omit it to mint a fresh thread. Returns { threadId }.",
       inputSchema: json(HandoffSchema)
     }
   ]
@@ -335,13 +334,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     throw e;
   }
 });
+var CLIENT_LABELS = {
+  "claude-code": "Claude Code",
+  "claude-ai": "Claude",
+  cursor: "Cursor",
+  "cursor-vscode": "Cursor",
+  windsurf: "Windsurf",
+  cline: "Cline",
+  "roo-cline": "Roo Code",
+  continue: "Continue",
+  vscode: "VS Code",
+  "visual studio code": "VS Code",
+  zed: "Zed"
+};
+function suggestedAgentName() {
+  if (process.env.PAIGY_AGENT) return process.env.PAIGY_AGENT;
+  const raw = server.getClientVersion?.()?.name;
+  if (!raw) return void 0;
+  return CLIENT_LABELS[raw.toLowerCase()] ?? raw.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
 async function handleTool(request) {
   switch (request.params.name) {
     case "pair": {
       const { device_code } = PairSchema.parse(request.params.arguments ?? {});
       if (!device_code) {
         const { keyFile, offer } = startE2ee();
-        const code = await requestCode(void 0, offer);
+        const code = await requestCode(suggestedAgentName(), offer);
         saveKeyFile({ ...keyFile, userCode: code.user_code });
         writeSurface("pairing code", code.user_code, code.expires_in);
         startBackgroundPair(code.device_code, code.expires_in * 1e3);

package/dist/listen.js

@@ -2,11 +2,11 @@
 import {
   WAKE_EVENT,
   wakeChannel
-} from "./chunk-DSWZOBK5.js";
+} from "./chunk-SLWESECN.js";
 import {
   checkReplies,
   registerDelivery
-} from "./chunk-RMTTO6BI.js";
+} from "./chunk-VWQQ3VJF.js";
 
 // src/listen.ts
 import { createClient } from "@supabase/supabase-js";

package/dist/onboard.js

@@ -3,7 +3,7 @@ import {
   autoConfigureClients,
   claudeInstallHint,
   openBrowser
-} from "./chunk-HAG2VWKB.js";
+} from "./chunk-HO3OJHRA.js";
 import {
   AGENT_NAME,
   TOKEN_PATH,
@@ -11,7 +11,7 @@ import {
   requestCode,
   saveToken,
   sleep
-} from "./chunk-RMTTO6BI.js";
+} from "./chunk-VWQQ3VJF.js";
 
 // src/onboard.ts
 async function main() {
@@ -39,9 +39,8 @@ Paigy MCP onboarding (agent: "${AGENT_NAME}")
 
 Paired! Token saved to ${TOKEN_PATH} (mode 0600).`);
         console.log("Treat this token like a password \u2014 it grants account access. Never log, echo, or commit it.");
-        console.log(`  Nickname : ${token.nickname}`);
-        console.log(`  Agent    : ${token.agent}`);
-        console.log(`  Device   : ${token.device ?? "(none)"}
+        console.log(`  Name   : ${token.name}`);
+        console.log(`  Device : ${token.device ?? "(none)"}
 `);
         const registered = autoConfigureClients();
         if (registered.length) {

package/dist/statusline.js

@@ -6,7 +6,7 @@ import {
   BACKEND_URL,
   reach,
   readToken
-} from "./chunk-RMTTO6BI.js";
+} from "./chunk-VWQQ3VJF.js";
 
 // src/statusline.ts
 import { mkdirSync, readFileSync, realpathSync, writeFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/mcp",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "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",
@@ -36,8 +36,8 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@paigy/schema": "0.0.0",
     "@paigy/sdk": "0.1.0",
+    "@paigy/schema": "0.0.0",
     "@paigy/crypto": "0.0.0"
   },
   "scripts": {