@ziggs-ai/ziggs-mcp 0.37.2 → 0.37.3

package/dist/config.d.ts

@@ -107,6 +107,13 @@ export interface ZiggsMcpConfig extends EnvConfig {
      * call may do: every call is still authorized by the backend.
      */
     directConnection: boolean;
+    /**
+     * The serving backend delivers `ziggs.inbox.updated` events to hosts that
+     * subscribe (its `MCP_EVENTS_ENABLED`). Only the remote server knows, so it
+     * sets this; stdio leaves it unset. Adds one rule to the directory door's
+     * connect text, inside that text's budget.
+     */
+    eventsEnabled?: boolean;
 }
 /** Load delegate credentials from the environment. */
 export declare function loadConfig(): ZiggsMcpConfig;

package/dist/protocol/connectText.d.ts

@@ -24,4 +24,8 @@ export type ConnectDoor = 'directory' | 'compact';
  * inbox read, the first call an agent makes, in the same words as above.
  */
 export declare function sessionRules(door: ConnectDoor): string[];
-export declare function renderConnectText(door: ConnectDoor): string;
+export interface ConnectTextOptions {
+    /** The serving backend delivers `ziggs.inbox.updated` events. */
+    events?: boolean;
+}
+export declare function renderConnectText(door: ConnectDoor, options?: ConnectTextOptions): string;

package/dist/protocol/connectText.js

@@ -47,12 +47,21 @@ export function sessionRules(door) {
     return [DATA, INBOX[door], WAIT, ACCESS, REPLY, GROUNDING];
 }
 const CATALOG = 'Only the everyday tools are loaded. ziggs_tools lists the rest; call them through ziggs_tool_read or ziggs_tool_write.';
-export function renderConnectText(door) {
+/**
+ * Directory door only: inbox events ride the connection key that door is
+ * minted for. Said only when the serving backend has events on, so a host is
+ * never told to subscribe where nothing answers. Lives here, inside the
+ * budget the tests enforce, rather than appended by the backend after the
+ * text was already sized: that append is what cut the text mid-word.
+ */
+const EVENTS = 'Inbox events: a host may subscribe to ziggs.inbox.updated per workspace; promise alerts only once it confirms. An event carries only orgId: read that inbox and follow its rules.';
+export function renderConnectText(door, options = {}) {
     return [
         `- ${DATA}`,
         `- ${SESSION}`,
         `- ${INBOX[door]}`,
         ...RULES.map((r) => `- ${r}`),
         ...(door === 'compact' ? [`- ${CATALOG}`] : []),
+        ...(door === 'directory' && options.events ? [`- ${EVENTS}`] : []),
     ].join('\n');
 }

package/dist/server.js

@@ -23,7 +23,9 @@ export function createZiggsMcpServer(creds, cfg) {
         // this into model context on `initialize`: the short connect text, the
         // same for every client — clients truncate a long one. Covers
         // stdio and remote HTTP alike, since both build the server here.
-        instructions: renderConnectText(cfg.directConnection === false ? 'directory' : 'compact'),
+        instructions: renderConnectText(cfg.directConnection === false ? 'directory' : 'compact', {
+            events: cfg.eventsEnabled === true,
+        }),
     });
     if (cfg.directConnection === false)
         installDirectorySurface(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.37.2",
+  "version": "0.37.3",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts \u2014 act as your Ziggs delegate agent",
   "type": "module",
   "bin": {