@ziggs-ai/ziggs-mcp 0.17.0 → 0.18.0

package/dist/config.d.ts

@@ -19,6 +19,17 @@ declare const envSchema: z.ZodObject<{
      * states no lane.
      */
     ZIGGS_LANE_ID: z.ZodOptional<z.ZodString>;
+    /**
+     * Pins this server's inbox host identity (`X-Ziggs-Instance`).
+     *
+     * One host owns an agent's inbox and a second is refused for 330 seconds, so
+     * a stdio server that a SCHEDULER respawns per run — the NanoClaw
+     * one-minute task starting `npx @ziggs-ai/ziggs-mcp` — is a new host every
+     * run and is refused by the previous run's lease. Set this to the same value
+     * on every run and they are one host. A server that stays up needs nothing:
+     * its process is its host.
+     */
+    ZIGGS_INSTANCE_ID: z.ZodOptional<z.ZodString>;
     /** Set to 1/true/yes to register internal/debug-only MCP tools. */
     ZIGGS_MCP_DEBUG: z.ZodOptional<z.ZodString>;
     /**
@@ -35,6 +46,7 @@ declare const envSchema: z.ZodObject<{
     ZIGGS_AGENT_ID?: string | undefined;
     ZIGGS_OWNER_USER_ID?: string | undefined;
     ZIGGS_LANE_ID?: string | undefined;
+    ZIGGS_INSTANCE_ID?: string | undefined;
     ZIGGS_MCP_DEBUG?: string | undefined;
     ZIGGS_MCP_CORE_ONLY?: string | undefined;
 }, {
@@ -45,6 +57,7 @@ declare const envSchema: z.ZodObject<{
     ZIGGS_AGENT_ID?: string | undefined;
     ZIGGS_OWNER_USER_ID?: string | undefined;
     ZIGGS_LANE_ID?: string | undefined;
+    ZIGGS_INSTANCE_ID?: string | undefined;
     ZIGGS_MCP_DEBUG?: string | undefined;
     ZIGGS_MCP_CORE_ONLY?: string | undefined;
 }>;

package/dist/config.js

@@ -21,6 +21,17 @@ const envSchema = z.object({
      * states no lane.
      */
     ZIGGS_LANE_ID: z.string().optional(),
+    /**
+     * Pins this server's inbox host identity (`X-Ziggs-Instance`).
+     *
+     * One host owns an agent's inbox and a second is refused for 330 seconds, so
+     * a stdio server that a SCHEDULER respawns per run — the NanoClaw
+     * one-minute task starting `npx @ziggs-ai/ziggs-mcp` — is a new host every
+     * run and is refused by the previous run's lease. Set this to the same value
+     * on every run and they are one host. A server that stays up needs nothing:
+     * its process is its host.
+     */
+    ZIGGS_INSTANCE_ID: z.string().optional(),
     /** Set to 1/true/yes to register internal/debug-only MCP tools. */
     ZIGGS_MCP_DEBUG: z.string().optional(),
     /**
@@ -47,6 +58,7 @@ export function loadConfig() {
         ZIGGS_AGENT_ID: process.env.ZIGGS_AGENT_ID,
         ZIGGS_OWNER_USER_ID: process.env.ZIGGS_OWNER_USER_ID,
         ZIGGS_LANE_ID: process.env.ZIGGS_LANE_ID,
+        ZIGGS_INSTANCE_ID: process.env.ZIGGS_INSTANCE_ID,
         ZIGGS_MCP_DEBUG: process.env.ZIGGS_MCP_DEBUG,
         ZIGGS_MCP_CORE_ONLY: process.env.ZIGGS_MCP_CORE_ONLY,
     };

package/dist/connectionCreds.js

@@ -1,4 +1,4 @@
-import { configureApiClient } from '@ziggs-ai/api-client';
+import { configureApiClient, mcpConnectionIdentity, } from '@ziggs-ai/api-client';
 import { MINT_KEY_HELP, decodeOperatorKeyClaims, isDirectoryBoarded, resolveDelegateAgentId, } from './operatorKey.js';
 export function parseBearerAuthorization(header) {
     const raw = Array.isArray(header) ? header[0] : header;
@@ -44,11 +44,23 @@ export function connectionFromBearer(bearer, httpBaseUrl, ownerUserId, laneId) {
         // ZiggsMcpConfig.directConnection.
         directConnection: !isDirectoryBoarded(decodeOperatorKeyClaims(bearer)),
     };
+    /**
+     * The inbox host is this CONNECTION, not the process serving it.
+     *
+     * This server also runs inside the API process, which serves every connected
+     * assistant and gets a new identity on every deploy. Stamping that made all
+     * of them one host and moved it under all of them at once, so a hosted
+     * `ziggs_inbox` read answered 409 for up to 330 seconds after each restart.
+     * The key is what stays put across both. Undefined only for a credential
+     * carrying no `keyId`, which then falls back to the process default.
+     */
+    const instanceId = mcpConnectionIdentity(bearer);
     return {
         creds: {
             operatorKey: bearer,
             agentId: resolvedAgentId,
             ...(laneId ? { laneId } : {}),
+            ...(instanceId ? { instanceId } : {}),
         },
         cfg,
     };

package/dist/creds.js

@@ -6,5 +6,9 @@ export function credsFromConfig(cfg) {
         // Every client in this package reads it off `Creds`, so leaving it unset
         // here silently fences all of them to the agent's own estate.
         ...(cfg.ZIGGS_LANE_ID ? { laneId: cfg.ZIGGS_LANE_ID } : {}),
+        // Unset means this process is the host, which is right for a server that
+        // stays up and wrong for one a scheduler respawns per run — that one pins
+        // ZIGGS_INSTANCE_ID so every run is the same host.
+        ...(cfg.ZIGGS_INSTANCE_ID ? { instanceId: cfg.ZIGGS_INSTANCE_ID } : {}),
     };
 }

package/dist/tools.js

@@ -605,7 +605,9 @@ export function registerZiggsTools(server, creds, cfg) {
             .describe('Long-poll: hold up to this many seconds (server-clamped, ~110 max) and return as soon as something new arrives — same response shape, no busy re-polling. Omit for an immediate snapshot.'),
     }, readOnly('Check your inbox'), async ({ ack, handledResourceIds, waitSeconds }) => {
         try {
-            const client = new InboxClient(creds.operatorKey, creds.agentId);
+            // Unset on stdio: that process IS the host, and a scheduler that
+            // respawns it per run pins ZIGGS_INSTANCE_ID instead.
+            const client = new InboxClient(creds.operatorKey, creds.agentId, undefined, creds.instanceId);
             // Ack-before-fetch is load-bearing; everything else is independent of
             // the envelope until we know whether there are deliveries to tag.
             const acked = ack
@@ -720,7 +722,7 @@ export function registerZiggsTools(server, creds, cfg) {
     // ---------------------------------------------------------------------------
     // Task mutation tools
     // ---------------------------------------------------------------------------
-    registerStrictTool(server, 'ziggs_task_create', 'Create one task, or atomically declare a native work graph under a root task. Every task and graph node cites exactly one active agreement (agreementId required). A plan is one assignee\'s checklist for its own task: pass plan to give the task its checklist in the same call — every step needs a non-blank description, since that is the label whoever is watching reads before anything closes — or leave it off and post it later with ziggs_task_replace_plan. Tick progress with ziggs_task_update_steps (name the steps that changed); do not resend the whole plan to mark one step done. Reach for graph instead of plan when work changes hands, contracts, or dependencies.', {
+    registerStrictTool(server, 'ziggs_task_create', 'Create one task, or atomically declare a native work graph under a root task. Every task and graph node cites exactly one active agreement (agreementId required). A plan is one assignee\'s checklist for its own task: pass plan to give the task its checklist in the same call — every step needs a non-blank description, since that is the label whoever is watching reads before anything closes — or leave it off and post it later with ziggs_task_replace_plan. Tick progress with ziggs_task_update_steps (name the steps that changed); do not resend the whole plan to mark one step done. Reach for graph instead of plan when work changes hands, contracts, or dependencies. For work that means getting an answer out of somebody, set dueAt and checkBack so whoever holds it knows when to stop and how often it may remind.', {
         agreementId: z.string().describe('Agreement this task belongs to'),
         description: z.string().describe('What the task entails'),
         title: z
@@ -793,7 +795,30 @@ export function registerZiggsTools(server, creds, cfg) {
             .boolean()
             .optional()
             .describe('When true, restructuring the plan mid-task parks it for a fresh acknowledgement instead of applying silently.'),
-    }, write('Create a task'), async ({ agreementId, description, title, parentTaskId, assigneeId, inputArtifactIds, waitsOn, graph, plan, planReviewTiming, requireMidWorkPlanAck, }) => {
+        // For work that means chasing an answer out of somebody.
+        // Nothing on the server makes the holder keep to these yet, so the
+        // wording here is the contract: it is what the holder reads.
+        dueAt: z
+            .string()
+            .optional()
+            .describe('Deadline, ISO 8601 (e.g. 2026-09-12T17:00:00Z). Whoever holds this task posts what it has and where it is stuck at the deadline, in the room where the question was asked, and then stops. A deadline already past is refused.'),
+        checkBack: z
+            .object({
+            everyMinutes: z
+                .number()
+                .int()
+                .min(5)
+                .describe('Minimum minutes between two reminders to the same person. A floor, not a schedule — reminding later is fine, sooner is not.'),
+            maxReminders: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .describe('Total reminders allowed per person asked, after the first ask. Then the holder stops and reports.'),
+        })
+            .optional()
+            .describe('How often the holder may remind, and how many times at most. Both halves are required together: a cadence with no budget is refused, because one reminder is one wake and a rule that never says stop is an open-ended loop. Omit entirely for a task nobody needs reminding about.'),
+    }, write('Create a task'), async ({ agreementId, description, title, parentTaskId, assigneeId, inputArtifactIds, waitsOn, graph, plan, planReviewTiming, requireMidWorkPlanAck, dueAt, checkBack, }) => {
         try {
             const task = await createTask({
                 agreementId,
@@ -807,6 +832,8 @@ export function registerZiggsTools(server, creds, cfg) {
                 plan,
                 planReviewTiming,
                 requireMidWorkPlanAck,
+                dueAt,
+                checkBack,
             }, creds);
             return textResult({ ok: true, task });
         }

package/package.json

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