@ziggs-ai/ziggs-mcp 0.1.35 → 0.3.0

package/dist/tools.js

@@ -135,7 +135,7 @@ function resolveOrgSelector(orgs, selector) {
  * every connection grant this agent holds, grouped by connection so
  * ziggs_connection_proxy's connectionId/grantId no longer has to arrive out of
  * band. `provider` comes from the grant's resolved scope label. The response is
- * scanned defensively for leaked secrets, as proxyConnection does.
+ * scanned defensively for leaked secrets, as ConnectionsClient.proxy does.
  */
 async function listConnectionsForHolder(creds) {
     const client = new GrantsClient(creds.operatorKey, creds.agentId);
@@ -649,11 +649,15 @@ export function registerZiggsTools(server, creds, cfg) {
         }))
             .optional()
             .describe('Scopes you finished handling — acked before fetching, monotonic'),
-    }, READ_ONLY, async ({ ack }) => {
+        waitSeconds: z
+            .number()
+            .optional()
+            .describe('Long-poll: hold up to this many seconds (server-clamped, ~25 max) and return as soon as something new arrives — same response shape, no busy re-polling. Omit for an immediate snapshot.'),
+    }, READ_ONLY, async ({ ack, waitSeconds }) => {
         try {
             const client = new InboxClient(creds.operatorKey, creds.agentId);
             const acked = ack?.length ? await client.ack(ack) : null;
-            const inbox = await client.getInbox();
+            const inbox = await client.getInbox(waitSeconds != null ? { waitSeconds } : {});
             let activeTasks = [];
             let activeTasksError;
             try {
@@ -738,7 +742,7 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e.message);
         }
     });
-    server.tool('ziggs_discover_grantable', 'See what context EXISTS in your orgs that you CANNOT read yet — so you can ask for it instead of failing blind. Returns labels only: { type, label, scopeRef, orgId } per item, never content, member names, tokens, or money. Bounded to orgs you have an active agreement in. To act on one, ask your human to grant it, or (if you hold a broader grant of your own) delegate via ziggs_delegate_grant using the scopeRef. Use ziggs_list_grants for what you already hold; this is what you lack.', {}, READ_ONLY, async () => {
+    server.tool('ziggs_discover_grantable', 'See what context EXISTS in your orgs that you CANNOT read yet — so you can ask for it instead of failing blind. Covers chats, agreements, and connections (type is "chat" | "agreement" | "connection"; connection labels are the provider name only). Returns labels only: { type, label, scopeRef, orgId } per item, never content, member names, tokens, or money. Bounded to orgs you have an active agreement in. To act on one, ask your human to grant it, or (if you hold a broader grant of your own) delegate via ziggs_delegate_grant using the scopeRef. Use ziggs_list_grants for what you already hold; this is what you lack.', {}, READ_ONLY, async () => {
         try {
             const client = new ContextDiscoveryClient(creds.operatorKey, creds.agentId);
             const items = await client.discoverGrantable();
@@ -800,12 +804,16 @@ export function registerZiggsTools(server, creds, cfg) {
             .optional()
             .describe('Optional task — creates a TaskArtifactLink alongside the primary scope link'),
         content_type: z.string().optional().describe('Default text'),
-    }, WRITE, async ({ text, visibility, chatId, agreementId, taskId, content_type }) => {
+        idempotencyKey: z
+            .string()
+            .optional()
+            .describe('Optional dedup key: a redelivered record with the same key no-ops and returns the original artifact. Derive it deterministically (e.g. from the source event + step) — not a random value — so a crash-replay reproduces it.'),
+    }, WRITE, async ({ text, visibility, chatId, agreementId, taskId, content_type, idempotencyKey }) => {
         try {
             if ((chatId && agreementId) || (!chatId && !agreementId)) {
                 return toolError('Pass exactly one of chatId or agreementId');
             }
-            const { artifactId } = await new ArtifactsClient(creds.operatorKey, creds.agentId).writeStrict({ text, visibility, chatId, agreementId, taskId, content_type });
+            const { artifactId } = await new ArtifactsClient(creds.operatorKey, creds.agentId).writeStrict({ text, visibility, chatId, agreementId, taskId, content_type, idempotencyKey });
             return textResult({
                 ok: true,
                 artifactId,
@@ -857,9 +865,13 @@ export function registerZiggsTools(server, creds, cfg) {
             .optional()
             .describe('Outcome payload (summary, status, links, …)'),
         errorMessage: z.string().optional().describe('Required when state=failed'),
-    }, WRITE, async ({ taskId, state, result, errorMessage }) => {
+        idempotencyKey: z
+            .string()
+            .optional()
+            .describe('Optional dedup key: a redelivered transition with the same key no-ops (returns the task) instead of erroring on an already-terminal task. Derive it deterministically (e.g. from taskId + target state) so a crash-replay reproduces it.'),
+    }, WRITE, async ({ taskId, state, result, errorMessage, idempotencyKey }) => {
         try {
-            const task = await updateTaskState(taskId, state, { result, errorMessage }, creds);
+            const task = await updateTaskState(taskId, state, { result, errorMessage, idempotencyKey }, creds);
             return textResult({ ok: true, task });
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.1.35",
+  "version": "0.3.0",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts — act as your Ziggs delegate agent",
   "type": "module",
   "bin": {
@@ -36,12 +36,12 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "^0.1.30",
+    "@ziggs-ai/api-client": "^0.3.0",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2"
   },
   "devDependencies": {
-    "@ziggs-ai/agent-sdk": "^0.2.2"
+    "@ziggs-ai/agent-sdk": "^0.4.0"
   },
   "engines": {
     "node": ">=20"