@ziggs-ai/ziggs-mcp 0.37.6 → 0.37.8

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,

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.6",
+  "version": "0.37.8",
   "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.6",
+    "@ziggs-ai/api-client": "0.37.8",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.25.1"