@ziggs-ai/ziggs-mcp 0.32.1 → 0.33.0

package/README.md

@@ -21,7 +21,7 @@ claude mcp add ziggs \
   -- npx -y @ziggs-ai/ziggs-mcp
 ```
 
-Use an **agent-scoped** operator key from the Ziggs Developer Portal — no `registerAgent`, no separate `ZIGGS_AGENT_ID`.
+Use an **agent-scoped** operator key from Agents → Access keys in the Ziggs app — no `registerAgent`, no separate `ZIGGS_AGENT_ID`.
 
 Full walkthrough: [`examples/claude-code.md`](examples/claude-code.md)
 
@@ -127,9 +127,9 @@ Sign up and log in at the web app.
 
 ### 2. Delegate agent + operator key
 
-**Agent-scoped key (Claude Code):** Developer Portal → your agent → **Issue operator key**.
+**Agent-scoped key (Claude Code):** Agents → your agent → **Issue operator key**.
 
-**Fleet key (Cursor / multi-agent):** Developer Portal → Operator keys, then set `ZIGGS_AGENT_ID`.
+**Fleet key (Cursor / multi-agent):** Agents → Access keys (/app/agents/access-keys), then set `ZIGGS_AGENT_ID`.
 
 Minimum scopes to get started: `agents:impersonate`, `agents:read`, `agents:write`, `context:read`.
 
@@ -149,7 +149,7 @@ Authorization: Bearer <ZIGGS_OPERATOR_KEY>
 X-Agent-Id: <resolved delegate agent id>
 ```
 
-Startup validates the key shape, expiry (JWT `exp`), and agent resolution — errors point to Developer Portal.
+Startup validates the key shape, expiry (JWT `exp`), and agent resolution — errors point to Agents → Access keys.
 
 ---
 

package/dist/operatorKey.js

@@ -1,6 +1,6 @@
 import { decodeOperatorKeyClaims, isOperatorKeyExpired } from '@ziggs-ai/api-client';
 export { decodeOperatorKeyClaims, isOperatorKeyExpired, isDirectoryBoarded, ISSUED_VIA_MCP_OAUTH, ISSUED_VIA_DEVICE_CODE } from '@ziggs-ai/api-client';
-const MINT_KEY_HELP = 'Mint a key in the Ziggs app: Developer Portal → Operator keys (fleet key + set ZIGGS_AGENT_ID), ' +
+const MINT_KEY_HELP = 'Mint a key in the Ziggs app: Agents → Access keys (/app/agents/access-keys) (fleet key + set ZIGGS_AGENT_ID), ' +
     'or open your delegate agent → Issue operator key (agent-scoped — no ZIGGS_AGENT_ID needed). ' +
     'Docs: https://ziggsai.com/docs (Claude Code MCP tier).';
 /**

package/dist/pendingDecisions.js

@@ -1,4 +1,4 @@
-import { agreementAppUrl, agreementsListAppUrl, connectionsSettingsAppUrl, walletAppUrl } from '@ziggs-ai/api-client';
+import { formatPoints, agreementAppUrl, agreementsListAppUrl, connectionsSettingsAppUrl, walletAppUrl } from '@ziggs-ai/api-client';
 export { resolveWebAppOrigin, agreementAppUrl, agreementsListAppUrl, connectionsSettingsAppUrl, walletAppUrl } from '@ziggs-ai/api-client';
 import { decisionWords, partySideIds, speakableActor, } from '@ziggs-ai/api-client';
 /**
@@ -343,7 +343,7 @@ function buildPaymentApprovalSection(items, startIndex = 1) {
         n += 1;
         lines.push('');
         const what = item.amount != null
-            ? `**ϟ${(item.amount / 100).toFixed(2)} points${item.toWalletId ? ` → \`${item.toWalletId}\`` : ''}**`
+            ? `**${formatPoints(item.amount)} points${item.toWalletId ? ` → \`${item.toWalletId}\`` : ''}**`
             : '**Paused points settlement**';
         lines.push(what);
         lines.push('');

package/dist/toolError.d.ts

@@ -16,6 +16,12 @@ export interface ToolErrorShape {
      * ask its human instead of re-reading the message.
      */
     choices?: unknown[];
+    /**
+     * The call that is the next step, when the server sent one: the access
+     * request of WORK_ACCESS_REQUIRED, ready to send. Carried through verbatim,
+     * the same shape an open's action recovery has.
+     */
+    recovery?: Record<string, unknown>;
 }
 /**
  * Classify a thrown client error (or a plain string this layer raised) into a

package/dist/toolError.js

@@ -75,6 +75,26 @@ function thrownFields(err) {
     const message = typeof o.message === 'string' && o.message ? o.message : String(err);
     return { message, status, code, choices: choicesIn(o.body) };
 }
+/** The `recovery` call of a refusal body, when the server sent one. */
+function recoveryIn(body) {
+    if (typeof body !== 'string' || !body)
+        return null;
+    try {
+        const parsed = JSON.parse(body);
+        const recovery = parsed?.recovery;
+        if (!recovery || typeof recovery !== 'object' || Array.isArray(recovery))
+            return null;
+        // The server names its tools by verb; here they are the MCP tools, the
+        // same renaming an open's actions get.
+        const call = recovery;
+        return typeof call.tool === 'string' && !call.tool.startsWith('ziggs_')
+            ? { ...call, tool: `ziggs_${call.tool}` }
+            : call;
+    }
+    catch {
+        return null;
+    }
+}
 /** The `choices` list of a refusal body, when the server sent one. */
 function choicesIn(body) {
     if (typeof body !== 'string' || !body)
@@ -96,7 +116,14 @@ function choicesIn(body) {
 export function classifyToolError(input) {
     const shape = classify(input);
     const { choices } = thrownFields(input);
-    return choices ? { ...shape, choices } : shape;
+    const recovery = typeof input === 'object' && input !== null
+        ? recoveryIn(input.body)
+        : null;
+    return {
+        ...shape,
+        ...(choices ? { choices } : {}),
+        ...(recovery ? { recovery } : {}),
+    };
 }
 function classify(input) {
     const { message, status, code: machineCode } = thrownFields(input);
@@ -107,6 +134,12 @@ function classify(input) {
             hint: HUMAN_AUTHORITY_HINT,
         };
     }
+    // Can read the agreement, cannot work on it: the server's sentence and its
+    // recovery are the answer, and the generic scope hint would send the agent
+    // back for the read it already has.
+    if (machineCode === 'WORK_ACCESS_REQUIRED') {
+        return { code: machineCode, message };
+    }
     if (machineCode && COVERAGE_REFUSALS.has(machineCode)) {
         return { code: machineCode, message, hint: COVERAGE_HINT };
     }

package/examples/chatgpt-remote-oauth.md

@@ -72,7 +72,7 @@ your Ziggs chats. Tools appearing and answering is the connection working.
 
 Then, only if your plan allows writes, ask it to send a message in a chat you
 belong to. In the Ziggs web app the message appears from your delegate agent, and
-**Developer Portal → Agents** shows the connection either way.
+**Agents** shows the connection either way.
 
 If the read works and the send does not, nothing is broken on the Ziggs side —
 that is the plan gate in the table above.

package/examples/claude-ai-oauth.md

@@ -28,7 +28,7 @@ You always see the consent screen, even when already logged in — there is no s
 
 ## Verify
 
-Ask Claude to use Ziggs — list chats, or send a message in a chat you belong to. In the Ziggs web app the message appears from your **Claude delegate** agent, and **Developer Portal → Agents → Claude connection** shows **connected**.
+Ask Claude to use Ziggs — list chats, or send a message in a chat you belong to. In the Ziggs web app the message appears from your **Claude delegate** agent, and **Agents → Claude connection** shows **connected**.
 
 ## Disconnect
 

package/examples/claude-code.md

@@ -24,7 +24,7 @@ Cold session: follow the **ziggs** skill rhythm — `ziggs_inbox` → read delta
 
 In the Ziggs web app:
 
-1. **Developer Portal → Agents** — create a delegate agent (e.g. `claude-delegate`).
+1. **Agents** — create a delegate agent (e.g. `claude-delegate`).
 2. Open the agent → **Issue operator key** (agent-scoped). Copy the token **once**.
 
 Agent-scoped keys embed `boundAgentId` in the JWT — you do **not** need `ZIGGS_AGENT_ID`.
@@ -70,7 +70,7 @@ claude mcp add ziggs \
 
 | Error | Fix |
 |-------|-----|
-| `ZIGGS_OPERATOR_KEY is required` | Mint a key in Developer Portal |
+| `ZIGGS_OPERATOR_KEY is required` | Mint a key under Agents → Access keys |
 | `operator key expired` | Issue a new key |
 | `set ZIGGS_AGENT_ID, or mint an agent-scoped` | Use agent-scoped key **or** set `ZIGGS_AGENT_ID` |
 | `conflicts with agent-scoped key` | Remove `ZIGGS_AGENT_ID` — the key already names the agent |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.32.1",
+  "version": "0.33.0",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts \u2014 act as your Ziggs delegate agent",
   "type": "module",
   "bin": {
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.32.1",
+    "@ziggs-ai/api-client": "0.33.0",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.25.1"