@ziggs-ai/ziggs-mcp 0.37.7 → 0.37.9

package/dist/inboxCompact.d.ts

@@ -17,7 +17,8 @@
  *   which `ziggs_auth_status` returns in full;
  * - a read step's `why` that only restates its tool and args, and the ack
  *   step's long one, whose ids are the step's own args;
- * - an `outOfReach` entry's scope and remedy, which its delivery row carries;
+ * - a delivery's out-of-reach scope and remedy: the row keeps `outOfReach: true`
+ *   beside its own ids, and the chat list says how to ask for the room;
  * - `sessionCardHint` ("the card is not in this response") when the card is.
  *   Both doors assemble the session start from the long-poll result plus the
  *   card, and the long-poll half's hint said the opposite of what followed.
@@ -92,5 +93,5 @@ export declare function compactTextResult(data: Json, reader?: InboxReader): {
  * inbox while assigned messages waited in `deliveries`. This adds what the
  * window holds, without changing what counts as pending or actionable.
  */
-export declare function windowNote(deliveries: unknown, selfAgentIds: readonly string[], outOfReach: number): string;
+export declare function windowNote(deliveries: unknown, selfAgentIds: readonly string[]): string;
 export {};

package/dist/inboxCompact.js

@@ -17,7 +17,8 @@
  *   which `ziggs_auth_status` returns in full;
  * - a read step's `why` that only restates its tool and args, and the ack
  *   step's long one, whose ids are the step's own args;
- * - an `outOfReach` entry's scope and remedy, which its delivery row carries;
+ * - a delivery's out-of-reach scope and remedy: the row keeps `outOfReach: true`
+ *   beside its own ids, and the chat list says how to ask for the room;
  * - `sessionCardHint` ("the card is not in this response") when the card is.
  *   Both doors assemble the session start from the long-poll result plus the
  *   card, and the long-poll half's hint said the opposite of what followed.
@@ -53,6 +54,10 @@ export function compactDelivery(row, kindOfParty, usualPartyId) {
             continue;
         if (key === 'partyId' && usualPartyId !== undefined && value === usualPartyId)
             continue;
+        if (key === 'outOfReach') {
+            out[key] = true;
+            continue;
+        }
         out[key] = value;
     }
     return out;
@@ -244,16 +249,6 @@ export function compactInboxResult(result, reader) {
     }
     if (isRecord(result.session))
         out.session = compactSession(result.session, result.connectionNotices);
-    // The row already carries its scope and remedy; the list names the rows
-    // and the request to make, which only it has.
-    if (Array.isArray(result.outOfReach))
-        out.outOfReach = result.outOfReach.map((entry) => isRecord(entry)
-            ? {
-                resourceId: entry.resourceId,
-                ...(entry.requestAccess ? { requestAccess: entry.requestAccess } : {}),
-                ...(entry.requestReplyAccess ? { requestReplyAccess: entry.requestReplyAccess } : {}),
-            }
-            : entry);
     if (Array.isArray(result.readPlan))
         out.readPlan = result.readPlan.map((step) => {
             if (!isRecord(step))
@@ -287,10 +282,11 @@ export function compactTextResult(data, reader) {
  * inbox while assigned messages waited in `deliveries`. This adds what the
  * window holds, without changing what counts as pending or actionable.
  */
-export function windowNote(deliveries, selfAgentIds, outOfReach) {
+export function windowNote(deliveries, selfAgentIds) {
     const rows = Array.isArray(deliveries) ? deliveries.filter(isRecord) : [];
     if (!rows.length)
         return '';
+    const outOfReach = rows.filter((d) => d.outOfReach).length;
     // The same rule the grouping uses, so each count is its section's size.
     const count = (s) => rows.filter((d) => sectionOf(d, selfAgentIds) === s).length;
     const words = {

package/dist/inboxToolResult.d.ts

@@ -52,6 +52,8 @@ interface OutOfReachNote {
     /** Optional alternative when the person's work includes answering here. */
     requestReplyAccess?: AccessRequestCall<'reply'>;
 }
+/** What to do with rows marked `outOfReach`, said once per inbox read. */
+export declare const OUT_OF_REACH_NOTE = "Rows with outOfReach: true are in rooms or resources you cannot read. ziggs_chat_list with readable: false shows each room you may list and the read request to file; for anything else, ziggs_open on it returns the request to make.";
 /**
  * replace the free-text `nextActions` hints with typed `readPlan`
  * call objects — tool name + pre-filled args — so the most common loop

package/dist/inboxToolResult.js

@@ -2,6 +2,8 @@ import { decisionWords, grantCaveat, hintsFromTasks, inboxEngagement, planInboxA
 import { buildDecidedForMeItems, formatPendingDecisionsPayload, humanAttentionForResult, resolveWebAppOrigin, } from './pendingDecisions.js';
 /** Keep the plan bounded; the full deliveries array still carries everything. */
 const MAX_READ_PLAN = 12;
+/** What to do with rows marked `outOfReach`, said once per inbox read. */
+export const OUT_OF_REACH_NOTE = 'Rows with outOfReach: true are in rooms or resources you cannot read. ziggs_chat_list with readable: false shows each room you may list and the read request to file; for anything else, ziggs_open on it returns the request to make.';
 function outOfReachOf(d) {
     const note = d.outOfReach;
     if (!note || typeof note !== 'object')
@@ -416,10 +418,10 @@ self = { agentId: '' }) {
             : {}),
         ...(readPlan.length ? { readPlan } : {}),
         ...(readPlanTruncated ? { readPlanTruncated } : {}),
-        // Named `outOfReach` on the result too, so the one word covers the whole
-        // path: the row carries it, the plan skips it, and this is where the agent
-        // reads what to say about it.
-        ...(unreadable.length ? { outOfReach: unreadable } : {}),
+        // The row carries the flag and the plan skips it. Which room it is and how
+        // to ask for it is the chat list's answer, so the inbox says where to look
+        // once instead of repeating every row.
+        ...(unreadable.length ? { outOfReachNote: OUT_OF_REACH_NOTE } : {}),
     };
     const { humanAttention, ...rest } = inbox;
     const engagement = inboxEngagement({

package/dist/tools.js

@@ -418,14 +418,25 @@ export function registerZiggsTools(server, creds, cfg) {
         fields: z
             .array(z.string())
             .optional()
-            .describe('Return only these keys on each row. Omit for the default (chatId, name, updatedAt, lastMessage, unreadCount, participantSummary). Pass members and/or rosterSummary to include the other web-app rosters. Keep chatId if you will open or send next.'),
-    }, readOnly('List your chats'), async ({ fields }) => {
+            .describe('Return only these keys on each row. Omit for the default (chatId, name, updatedAt, lastMessage, unreadCount, participantSummary, readable, requestAccess). Pass members and/or rosterSummary to include the other web-app rosters. Keep chatId if you will open or send next.'),
+        participantId: z
+            .string()
+            .optional()
+            .describe('Only rooms this person or agent is in.'),
+        readable: z
+            .boolean()
+            .optional()
+            .describe('true: only rooms you can read. false: only rooms you may list but not read, each with the read request to file.'),
+    }, readOnly('List your chats'), async ({ fields, participantId, readable }) => {
         try {
-            const chats = await listMyChats(creds);
+            const chats = await listMyChats(creds, {
+                ...(participantId?.trim() ? { participantId: participantId.trim() } : {}),
+                ...(readable === undefined ? {} : { readable }),
+            });
             return textResult({
                 count: chats.length,
                 chats: projectChatListRows(chats, fields),
-                note: 'These are existing rooms, not everyone you can contact. To contact a known person or agent, use ziggs_chat_open with their returned participant id; use ziggs_agent_search to find a teammate by name, which returns the person to message, not their agents. The server checks whether contact is allowed. No existing room does not mean contact is forbidden.',
+                note: 'These are existing rooms, not everyone you can contact. A row with readable: false is a room a person let you see in their list; its messages need the read request it carries. To list a person\'s rooms, ask them with ziggs_access_request (scopeKind person, permission list). To contact a known person or agent, use ziggs_chat_open with their returned participant id; use ziggs_agent_search to find a teammate by name, which returns the person to message, not their agents. The server checks whether contact is allowed. No existing room does not mean contact is forbidden.',
             });
         }
         catch (e) {
@@ -735,7 +746,7 @@ export function registerZiggsTools(server, creds, cfg) {
             // No prose list of next actions rides here: the calls are in
             // `readPlan`, the human cues sit on the `decisions` and `activeWork`
             // rows, and how to present them is said once, on connect.
-            const note = windowNote(news.deliveries, [creds.agentId], Array.isArray(news.outOfReach) ? news.outOfReach.length : 0);
+            const note = windowNote(news.deliveries, [creds.agentId]);
             return compactTextResult({
                 ...news,
                 session,
@@ -869,31 +880,31 @@ export function registerZiggsTools(server, creds, cfg) {
             .array(z.string())
             .optional()
             .describe('Task ids this task waits for. It is created now but its assignee is not woken, and cannot start it, until every task named here has finished — so you can state a join up front (four probes and a synthesis that waits on all four) instead of polling for each one and creating the next yourself. Releases when ALL of them are terminal, whatever state each reached; what a failed dependency means is your call. You must be able to read a task to name it here.'),
-        graph: z
-            .object({
-            nodes: z
-                .array(z.object({
-                nodeId: z.string().min(1).max(200),
-                agreementId: z.string(),
-                description: z.string().min(1),
-                title: z.string().max(80).optional(),
-                assigneeId: z.string().optional(),
-                waitsOn: z.array(z.string()).optional(),
-                joinKind: z.enum(['all', 'any']).optional(),
-                runIf: z
-                    .string()
-                    .min(1)
-                    .max(500)
-                    .optional()
-                    .describe('A yes/no question over the results of the nodes this one waits on, such as "Does the review report at least one bug?". On yes the node runs; on no it is skipped, and nodes waiting on it go ahead. When the answer is unclear it waits for the buyer. Needs waitsOn.'),
-            }))
+        closesBy: z
+            .enum(['result', 'children'])
+            .optional()
+            .describe('How this task closes, fixed now. children (the default with children): a job, never handed out, that closes when its children close. result (the default otherwise): closes by its own result.'),
+        children: z
+            .array(z.object({
+            name: z.string().min(1).max(200),
+            agreementId: z.string(),
+            description: z.string().min(1),
+            title: z.string().max(80).optional(),
+            assigneeId: z.string().optional(),
+            waitsOn: z.array(z.string()).optional(),
+            joinKind: z.enum(['all', 'any']).optional(),
+            runIf: z
+                .string()
                 .min(1)
-                .max(100),
+                .max(500)
+                .optional()
+                .describe('A yes/no question over the results of the children this one waits on, such as "Does the review report at least one bug?". On yes it runs; on no it is skipped, and children waiting on it go ahead. When the answer is unclear it waits for the buyer. Needs waitsOn.'),
             inputArtifactIds: z.array(z.string()).optional(),
-            review: z.literal('before_execution').optional(),
-        })
+        }))
+            .min(1)
+            .max(100)
             .optional()
-            .describe('Native atomic graph. waitsOn values name nodeId values in this payload; all nodes are created or none are. Root nodes receive graph inputArtifactIds. review holds every node until the root acknowledgement. runIf makes a node conditional on what the nodes before it found.'),
+            .describe('Children created with this task, all or none. waitsOn names sibling names. The answer maps each name to its task id. This task\'s inputArtifactIds go to children that wait on nothing; planReviewTiming before_execution holds every child until this task\'s plan is acknowledged. runIf makes a child conditional on what the children before it found.'),
         // POST /tasks and the SDK's task_create have always taken
         // these three; only this surface hid them, so an agent on MCP had to
         // create-then-replace_plan even when it already knew the steps.
@@ -951,7 +962,7 @@ export function registerZiggsTools(server, creds, cfg) {
             .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.'),
         sources: sourcesField(),
-    }, write('Create a task'), async ({ agreementId, description, title, parentTaskId, assigneeId, inputArtifactIds, waitsOn, graph, plan, planReviewTiming, requireMidWorkPlanAck, dueAt, checkBack, sources, }) => {
+    }, write('Create a task'), async ({ agreementId, description, title, parentTaskId, assigneeId, inputArtifactIds, waitsOn, closesBy, children, plan, planReviewTiming, requireMidWorkPlanAck, dueAt, checkBack, sources, }) => {
         try {
             const task = await createTask({
                 ...(sources ? { sources: sources } : {}),
@@ -962,7 +973,8 @@ export function registerZiggsTools(server, creds, cfg) {
                 assigneeId,
                 inputArtifactIds,
                 waitsOn,
-                graph,
+                closesBy,
+                children,
                 plan,
                 planReviewTiming,
                 requireMidWorkPlanAck,

package/dist/workspaceRouting.js

@@ -228,7 +228,7 @@ export class WorkspaceRouter {
                 // The connection door gets the same compact read and the same
                 // counter note as the compact door; this path builds its own result,
                 // so it has to ask for both.
-                const note = windowNote(news.deliveries, self.agentIds ?? [], Array.isArray(news.outOfReach) ? news.outOfReach.length : 0);
+                const note = windowNote(news.deliveries, self.agentIds ?? []);
                 return compactTextResult({
                     ...news,
                     ...pending,

package/package.json

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