@ziggs-ai/ziggs-mcp 0.37.23 → 0.37.25

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+## 0.37.25
+
+- `ziggs_inbox_claim` takes the lease and returns that it claimed, plus how many deliveries are waiting. It does not return the inbox.
+- A malformed inbox acknowledgement is a request error, not a connection failure.
+- Agreement list `fields` resolve the same aliases as the other lists and report `unknownFields`.
+
+## 0.37.24
+
+- `tools/list` marks `ziggs_inbox` read-only, with no ack parameters. `ziggs_inbox_ack` stays the write that moves the watermark. The inbox description says a full read takes this host's lease and that waitSeconds long-polls.
+
 ## 0.37.23
 
 - `ziggs_agreement_list` with no scope returns the agreements you can reach, including hires. `scope: mine` is the party-only filter. `ziggs_agent_search` says already hired and names the agreement and workspace when you already hire that agent. The skill says the same.

package/dist/tools.js

@@ -2,7 +2,7 @@ import { isDirectorySurface } from './directorySurface.js';
 import { INBOX_CARD_TOOL_META, inboxCardResult, registerInboxCardResource, } from './inboxCard.js';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { presentResourceActions, getAgreement, getMyAgreements, listMyChats, respondToAgreement, revokeAgreement, counterAgreement, fulfillAgreement, sendChatMessage, ConnectionsClient, ContextReadClient, GrantsClient, InboxClient, AssistantConnectionClient, createTask, updateTaskState, acknowledgeTaskControl, replaceTaskPlan, updateTaskPlanSteps, listTasks, getTask, getBackendUrl, fetchMyOrgs, fetchSessionAccess, isMcpOAuthDelegateSession, GRANTS_CAPABILITIES, AGREEMENT_TERMS_PARAMS, AGREEMENT_VERB_CAPABILITIES, LISTING_DOOR_CAPABILITIES, CONTEXT_GRANT_SCOPE_KINDS, contextReadCapability, openCapability, accessExplainCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, recordArtifactCapability, listArtifactsCapability, findArtifactsCapability, shareArtifactCapability, attachArtifactCapability, uploadArtifactUrlCapability, completeArtifactFileCapability, downloadArtifactCapability, openConversationCapability, connectionProxyCapability, requestConnectionCapability, agreementClaimCapability, agreementSubcontractCapability, listTasksCapability, cancelTaskCapability, marketplaceViewCapability, parseListFields, pickListedRows, projectChatListRows, sessionOrientation, presentSendResult, presentTaskOutcome, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, SOURCES_DESCRIPTION, } from '@ziggs-ai/api-client';
+import { presentResourceActions, getAgreement, getMyAgreements, listMyChats, respondToAgreement, revokeAgreement, counterAgreement, fulfillAgreement, sendChatMessage, ConnectionsClient, ContextReadClient, GrantsClient, InboxClient, AssistantConnectionClient, createTask, updateTaskState, acknowledgeTaskControl, replaceTaskPlan, updateTaskPlanSteps, listTasks, getTask, getBackendUrl, fetchMyOrgs, fetchSessionAccess, isMcpOAuthDelegateSession, GRANTS_CAPABILITIES, AGREEMENT_TERMS_PARAMS, AGREEMENT_VERB_CAPABILITIES, LISTING_DOOR_CAPABILITIES, CONTEXT_GRANT_SCOPE_KINDS, contextReadCapability, openCapability, accessExplainCapability, contextExpandReachCapability, contextDiscoverGrantableCapability, recordArtifactCapability, listArtifactsCapability, findArtifactsCapability, shareArtifactCapability, attachArtifactCapability, uploadArtifactUrlCapability, completeArtifactFileCapability, downloadArtifactCapability, openConversationCapability, connectionProxyCapability, requestConnectionCapability, agreementClaimCapability, agreementSubcontractCapability, listTasksCapability, cancelTaskCapability, marketplaceViewCapability, parseListFields, pickListedRows, listedFieldNote, projectChatListRows, sessionOrientation, presentSendResult, presentTaskOutcome, explainRefusedRead, RESOURCE_HIDDEN_MESSAGE, SOURCES_DESCRIPTION, } from '@ziggs-ai/api-client';
 import { decodeOperatorKeyClaims } from './operatorKey.js';
 import { registerTrustTools } from './trustTools.js';
 import { registerPaymentTools } from './paymentTools.js';
@@ -392,10 +392,12 @@ export function registerZiggsTools(server, creds, cfg) {
                 ...(proposalStatus ? { proposalStatus } : {}),
                 partyOnly: scope === 'mine',
             }, creds);
+            const projected = parseListFields(fields);
             return textResult({
                 count: agreements.length,
                 scope: scope ?? 'reachable',
-                agreements: pickListedRows(agreements, parseListFields(fields)),
+                agreements: pickListedRows(agreements, projected),
+                ...listedFieldNote(agreements, projected),
             });
         }
         catch (e) {
@@ -709,7 +711,7 @@ export function registerZiggsTools(server, creds, cfg) {
             .number()
             .optional()
             .describe('Long-poll: hold up to this many seconds (the server clamps a hold at about 110) and return as soon as something new arrives, same response shape, no busy re-polling. Omit for an immediate snapshot. When your person asked you to wait for a reply, pass 55 and call again until it arrives or ten minutes have passed.'),
-    }, isDirectorySurface(server) ? readOnly('Read your inbox') : destructive('Acquire and read your inbox'), async ({ waitSeconds }) => {
+    }, readOnly('Read your inbox'), async ({ waitSeconds }) => {
         try {
             // Unset on stdio: that process IS the host, and a scheduler that
             // respawns it per run pins ZIGGS_INSTANCE_ID instead.
@@ -830,10 +832,9 @@ export function registerZiggsTools(server, creds, cfg) {
         registerStrictTool(server, 'ziggs_inbox_claim', {}, destructive('Claim the inbox for this worker'), async () => {
             try {
                 const client = inboxFor(creds);
-                return compactTextResult(await client.getInbox(), {
-                    agentIds: [creds.agentId],
-                    personId: ownerPrincipalId(creds, cfg),
-                });
+                const inbox = await client.getInbox();
+                const deliveryCount = Array.isArray(inbox.deliveries) ? inbox.deliveries.length : 0;
+                return textResult({ claimed: true, deliveryCount });
             }
             catch (e) {
                 return toolError(e);

package/dist/workspaceRouting.js

@@ -229,7 +229,15 @@ export class WorkspaceRouter {
                 this.remember(synced.workspaces);
                 return result(synced);
             }
-            if (name === 'ziggs_inbox' || name === 'ziggs_inbox_claim') {
+            if (name === 'ziggs_inbox_claim') {
+                const inbox = await this.client.inbox(0, false);
+                const workspaces = inbox.workspaces;
+                if (Array.isArray(workspaces))
+                    this.remember(workspaces);
+                const deliveryCount = Array.isArray(inbox.deliveries) ? inbox.deliveries.length : 0;
+                return compactTextResult({ claimed: true, deliveryCount });
+            }
+            if (name === 'ziggs_inbox') {
                 const inbox = await this.client.inbox(Number(args.waitSeconds ?? 0), this.directory && name === 'ziggs_inbox');
                 const workspaces = inbox.workspaces;
                 if (Array.isArray(workspaces))
@@ -248,7 +256,7 @@ export class WorkspaceRouter {
                 return compactTextResult({
                     ...news,
                     ...pending,
-                    ...(name === 'ziggs_inbox' && args.waitSeconds == null ? { rules: sessionRules('directory') } : {}),
+                    ...(args.waitSeconds == null ? { rules: sessionRules('directory') } : {}),
                     ...(note && typeof pending.notice === 'string' ? { notice: `${pending.notice} ${note}` } : {}),
                     session: { workspaces },
                     instruction: `deliveries.forYou is your work; deliveries.forYourPerson is for your person to see. ${ASK_YOUR_HUMAN}`,
@@ -282,7 +290,9 @@ export class WorkspaceRouter {
             return result({ count: workspaces.length, orgs: workspaces });
         }
         catch (error) {
-            if (name === 'ziggs_notification_status' || name === 'ziggs_inbox_changes')
+            if (name === 'ziggs_notification_status' ||
+                name === 'ziggs_inbox_changes' ||
+                name === 'ziggs_inbox_ack')
                 return toolError(error);
             return refusal('CONNECTION_REQUEST_FAILED', error instanceof Error ? error.message : String(error));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.37.23",
+  "version": "0.37.25",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts \u2014 act as your Ziggs delegate agent",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {
@@ -51,7 +51,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "0.37.21",
+    "@ziggs-ai/api-client": "0.37.23",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.25.1"