@ziggs-ai/api-client 0.36.1 → 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/marketplace.js

@@ -1,5 +1,5 @@
 import { marketplaceFormation } from '../engagementGuide.js';
-import { pullOffers, pullRequests } from '../http/MarketplaceClient.js';
+import { pullOffersPage, pullRequests } from '../http/MarketplaceClient.js';
 import { fullCreds } from './types.js';
 import { nextCall } from './nextCall.js';
 import { LIST_FIELDS_PARAM, parseListFields, pickListedRows } from './listedFields.js';
@@ -94,10 +94,13 @@ export const marketplaceViewCapability = {
             limit: typeof args['limit'] === 'number' ? args['limit'] : 20,
             ...(args['since'] ? { since: args['since'] } : {}),
         };
-        const [requests, offers] = await Promise.all([
+        const [requests, offerPage] = await Promise.all([
             kind === 'offers' ? Promise.resolve([]) : pullRequests(options, creds),
-            kind === 'requests' ? Promise.resolve([]) : pullOffers(options, creds),
+            kind === 'requests'
+                ? Promise.resolve({ offers: [], total: null, hasMore: false })
+                : pullOffersPage(options, creds),
         ]);
+        const offers = offerPage.offers;
         const fields = parseListFields(args['fields']);
         const requestRows = pickListedRows(requests.map((q) => toListingRow(q, 'request')), fields);
         const offerRows = pickListedRows(offers.map((o) => toListingRow(o, 'offer')), fields);
@@ -110,7 +113,20 @@ export const marketplaceViewCapability = {
                 ? { requests: requestRows, requestCount: requests.length }
                 : {}),
             ...(kind !== 'requests'
-                ? { offers: offerRows, offerCount: offers.length }
+                ? {
+                    offers: offerRows,
+                    offerCount: offers.length,
+                    // The board is capped: say so only when more exist, so the count
+                    // above is never read as all of them.
+                    ...(offerPage.hasMore
+                        ? {
+                            moreOffers: {
+                                total: offerPage.total,
+                                note: 'More listings exist than this read returned. Read again with a larger limit (at most 100) or narrow with since.',
+                            },
+                        }
+                        : {}),
+                }
                 : {}),
             engagement,
             // Claiming is the move after browsing, and the id is in the row the

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/dist/http/MarketplaceClient.d.ts

@@ -47,6 +47,16 @@ export interface PullOffersOptions {
     since?: string;
 }
 export declare function pullOffers(options: PullOffersOptions | undefined, creds: Creds): Promise<Agreement[]>;
+/**
+ * The board read with its total. The board is capped (at most 100 rows), so
+ * the number of rows returned is not the number of listings. `total` and
+ * `hasMore` are absent from an older server; read them as unknown, not none.
+ */
+export declare function pullOffersPage(options: PullOffersOptions | undefined, creds: Creds): Promise<{
+    offers: Agreement[];
+    total: number | null;
+    hasMore: boolean;
+}>;
 export interface PullRequestsOptions {
     limit?: number;
     since?: string;

package/dist/http/MarketplaceClient.js

@@ -64,6 +64,14 @@ async function setOfferPaused(agreementId, verb, creds) {
     return shapeAgreement(data['agreement']);
 }
 export async function pullOffers(options, creds) {
+    return (await pullOffersPage(options, creds)).offers;
+}
+/**
+ * The board read with its total. The board is capped (at most 100 rows), so
+ * the number of rows returned is not the number of listings. `total` and
+ * `hasMore` are absent from an older server; read them as unknown, not none.
+ */
+export async function pullOffersPage(options, creds) {
     assertCreds(creds, 'marketplace offers pull');
     const params = new URLSearchParams();
     if (options?.limit != null)
@@ -80,7 +88,9 @@ export async function pullOffers(options, creds) {
         throwApiError(res, body, `Marketplace offers pull failed: ${res.status}`);
     }
     const data = await res.json().catch(() => null);
-    return data?.['offers'] ?? [];
+    const offers = data?.['offers'] ?? [];
+    const total = typeof data?.['total'] === 'number' ? data['total'] : null;
+    return { offers, total, hasMore: data?.['hasMore'] === true };
 }
 export async function pullRequests(options, creds) {
     assertCreds(creds, 'request pull');

package/package.json

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