@ziggs-ai/api-client 0.36.2 → 0.36.3

package/dist/capabilities/context.js

@@ -327,12 +327,16 @@ export const openCapability = {
     names: { sdk: 'open', mcp: 'ziggs_open' },
     title: 'Open a returned resource',
     descriptions: {
-        sdk: 'Read a returned resource: pass exactly one of artifactId, chatId, taskId, agreementId. The backend resolves access and returns scoped actions with required inputs and recovery calls. Opening executes none of those actions. Extraction pending/failed is not an empty document.',
+        sdk: 'Read a returned resource: pass exactly one of artifactId, chatId, taskId, agreementId. The backend resolves access and returns scoped actions with required inputs and recovery calls. Opening executes none of those actions. Extraction pending/failed is not an empty document. To read a chat\'s messages under one agreement, use context_read with type=messages, via=chat:<id> and agreementId.',
     },
     annotation: 'read-only',
+    // agreementId here is the agreement to open, one id among four
+    // (OPEN_ID_PARAMS). It used to carry context_read's filter wording, so an
+    // agent passed it beside chatId as a filter and was refused by the
+    // exactly-one rule. Filtering a room's messages to one agreement is
+    // context_read's job, and the description says so.
     params: {
         ...OPEN_ID_PARAMS,
-        agreementId: { type: 'string', description: 'Filter message history to this exact work agreement. Use cursor pagination to expand a wake packet.' },
         cursor: { type: 'string', description: 'Opaque cursor from a prior open page' },
         after: { type: 'string', description: 'ISO timestamp for a forward-delta' },
         limit: { type: 'number', description: 'Page size' },

package/dist/capabilities/mcpBriefs.js

@@ -125,7 +125,7 @@ const BRIEFS = {
     },
     // Reading context
     ziggs_open: {
-        does: 'Reads one artifact, chat, task or agreement by id, with the actions you may take and any recovery call. Hidden and unknown look the same.',
+        does: 'Reads one artifact, chat, task or agreement by id (exactly one id), with the actions you may take and any recovery call. Hidden and unknown look the same. A chat\'s messages under one agreement: ziggs_context_read with agreementId.',
     },
     ziggs_access_explain: {
         does: 'Explains what you may do with one artifact, chat, task or agreement, and the recovery calls; runs none of them.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.36.2",
+  "version": "0.36.3",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",