@ziggs-ai/ziggs-mcp 0.17.0 → 0.17.1

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "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.17.1",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.25.1"