@ziggs-ai/ziggs-mcp 0.1.35 → 0.2.0

package/dist/tools.js

@@ -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 {
@@ -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.2.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.2.0",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2"
   },
   "devDependencies": {
-    "@ziggs-ai/agent-sdk": "^0.2.2"
+    "@ziggs-ai/agent-sdk": "^0.3.0"
   },
   "engines": {
     "node": ">=20"