@ziggs-ai/ziggs-mcp 0.37.16 → 0.37.18

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.37.18
+
+- Inspect notification health through a read-only assistant-connection status tool: explicit workspace, expiry, callback acceptance, retry timing and categorized failures, without callback URLs or signing secrets. Receipt is not proof of a host response. Preserve backend errors when observing through a connection.
+
+- Read small inbox deltas with an observation cursor that renews on use, independent of work acknowledgements. Preserve the recovery cursor when the stream limit is reached. Reuse it to wait for new arrivals despite older unhandled mail; available through both HTTP connection modes and MCP.
+
 ## 0.37.16
 
 - Clarify the shared hiring instructions: a mandate governs the work; agent-initiated hires need a covering grant or approval on the existing agreement.

package/dist/directorySurface.js

@@ -2,12 +2,13 @@
 const directories = new WeakSet();
 export const DIRECTORY_TOOLS = new Set(`
 ziggs_auth_status ziggs_org_list ziggs_workspace_sync ziggs_context_snapshot
+ziggs_notification_status
 ziggs_agreement_list ziggs_agreement_get ziggs_chat_list ziggs_chat_open ziggs_chat_send
 ziggs_agreement_buy ziggs_agreement_bid ziggs_agreement_broker ziggs_agreement_request
 ziggs_agreement_handoff
 ziggs_agreement_claim ziggs_agreement_subcontract ziggs_marketplace_view
 ziggs_agreement_respond ziggs_agreement_revoke ziggs_agreement_counter ziggs_agreement_fulfill
-ziggs_inbox_peek ziggs_inbox ziggs_inbox_claim ziggs_inbox_ack ziggs_inbox_park
+ziggs_inbox_changes ziggs_inbox_peek ziggs_inbox ziggs_inbox_claim ziggs_inbox_ack ziggs_inbox_park
 ziggs_grant_list ziggs_context_expand_reach ziggs_context_discover_grantable
 ziggs_open ziggs_access_explain ziggs_context_read
 ziggs_artifact_record ziggs_artifact_list ziggs_artifact_find ziggs_artifact_share
@@ -25,7 +26,7 @@ ziggs_introduction_list ziggs_introduction_revoke ziggs_context_revoke_grant zig
  * in one workspace, so tools.ts registers it only when the key carries a
  * connection. Tests subtract this set for such a key.
  */
-export const CONNECTION_ONLY_DIRECTORY_TOOLS = new Set(['ziggs_workspace_sync']);
+export const CONNECTION_ONLY_DIRECTORY_TOOLS = new Set(['ziggs_workspace_sync', 'ziggs_notification_status']);
 /** Public discovery and actions accepting new counterparties or audiences. */
 const OPEN_WORLD = new Set(`
 ziggs_agent_search ziggs_agent_get ziggs_marketplace_view

package/dist/tools.js

@@ -1,7 +1,7 @@
 import { isDirectorySurface } from './directorySurface.js';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { presentResourceActions, getAgreement, getMyAgreements, listMyChats, respondToAgreement, revokeAgreement, counterAgreement, fulfillAgreement, sendChatMessage, ConnectionsClient, ContextReadClient, GrantsClient, InboxClient, createTask, updateTaskState, acknowledgeTaskControl, replaceTaskPlan, updateTaskPlanSteps, listTasks, getTask, getBackendUrl, fetchMyOrgs, fetchSessionAccess, isMcpOAuthDelegateSession, GRANTS_CAPABILITIES, 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_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 { decodeOperatorKeyClaims } from './operatorKey.js';
 import { registerTrustTools } from './trustTools.js';
 import { registerPaymentTools } from './paymentTools.js';
@@ -613,6 +613,29 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e);
         }
     });
+    if (decodeOperatorKeyClaims(creds.operatorKey)?.connectionClientId) {
+        registerStrictTool(server, 'ziggs_notification_status', {
+            orgId: z.string().min(1).max(200).describe('Workspace ID.'),
+        }, readOnly('Notification status'), async ({ orgId }) => {
+            try {
+                return textResult(await new AssistantConnectionClient(creds).eventStatus(orgId));
+            }
+            catch (error) {
+                return toolError(error);
+            }
+        });
+    }
+    registerStrictTool(server, 'ziggs_inbox_changes', {
+        cursor: z.string().optional().describe('Observation cursor; reads renew it for 24h. Omit or restart on 410 to scan retained history. Never ack it.'),
+        waitSeconds: z.number().min(0).optional().describe('Wait up to 110 seconds for an unobserved delivery; use 55 during an active session.'),
+    }, readOnly('Read new inbox arrivals'), async ({ cursor, waitSeconds }) => {
+        try {
+            return textResult(await inboxFor(creds).getChanges({ cursor, waitSeconds }));
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
     registerStrictTool(server, 'ziggs_inbox_peek', {
         waitSeconds: z
             .number()

package/dist/workspaceRouting.js

@@ -1,4 +1,5 @@
 import { isDirectorySurface } from './directorySurface.js';
+import { toolError } from './toolError.js';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { AssistantConnectionClient, withAssistantRequest, decodeOperatorKeyClaims, parseRef, } from '@ziggs-ai/api-client';
 import { formatInboxToolResult } from './inboxToolResult.js';
@@ -14,6 +15,8 @@ const CONNECTION = new Set([
     'ziggs_org_list',
     'ziggs_inbox',
     'ziggs_inbox_peek',
+    'ziggs_inbox_changes',
+    'ziggs_notification_status',
     'ziggs_inbox_ack',
     'ziggs_inbox_park',
     'ziggs_inbox_claim',
@@ -249,6 +252,15 @@ export class WorkspaceRouter {
                     instruction: `deliveries.forYou is your work; deliveries.forYourPerson is for your person to see. ${ASK_YOUR_HUMAN}`,
                 }, { agentIds: self.agentIds ?? [] });
             }
+            if (name === 'ziggs_notification_status') {
+                return result(await this.client.eventStatus(args.orgId));
+            }
+            if (name === 'ziggs_inbox_changes') {
+                return result(await this.client.getChanges({
+                    cursor: args.cursor,
+                    waitSeconds: args.waitSeconds,
+                }));
+            }
             if (name === 'ziggs_inbox_peek') {
                 return result(await this.client.request(`inbox/peek?wait=${Number(args.waitSeconds ?? 0)}`));
             }
@@ -258,6 +270,8 @@ export class WorkspaceRouter {
             return result({ count: workspaces.length, orgs: workspaces });
         }
         catch (error) {
+            if (name === 'ziggs_notification_status' || name === 'ziggs_inbox_changes')
+                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.16",
+  "version": "0.37.18",
   "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.17",
+    "@ziggs-ai/api-client": "0.37.18",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.25.1"