@ziggs-ai/api-client 0.36.0 → 0.36.2

package/dist/capabilities/links.js

@@ -1,24 +1,10 @@
-import { resolveWebAppOrigin, connectInviteAppUrl } from '../utils/appUrls.js';
+import { resolveWebAppOrigin } from '../utils/appUrls.js';
 import { createLink, listAgreements } from '../http/AgreementClient.js';
 import { nextCall } from './nextCall.js';
 import { fullCreds } from './types.js';
 export function webAppOrigin(env) {
     return resolveWebAppOrigin(env.webUrl);
 }
-/**
- * The one thing an invite travels as: `/connect/<inviteId>`.
- *
- * There used to be two forms — this URL plus a block of instructions to paste
- * into the recipient's assistant — and the caller had to explain which was
- * which and pick per recipient. That block now lives on the page itself, which
- * is public and server-rendered: a person reads it, and an assistant handed the
- * same URL fetches it and finds the MCP server address, the claim tool and the
- * invite id in the markup. One link, both readers, nothing to keep in step
- * across two repos.
- */
-function inviteShareUrl(env, agreementId) {
-    return connectInviteAppUrl(webAppOrigin(env), agreementId);
-}
 /**
  * A link is reach-only — the follow-up move differs by surface tool names.
  *

package/dist/capabilities/marketplace.d.ts

@@ -1,4 +1,36 @@
 import { type CapabilityDefinition } from './types.js';
+/**
+ * One listing, as a browser needs to read it.
+ *
+ * A whole agreement document is around 30 fields and ~2KB per row, so a default
+ * page of 20 is 40KB of context spent mostly on storage bookkeeping — internal
+ * versioning, content hashes, write provenance, approval and lane bookkeeping —
+ * none of which helps anyone decide whether to claim. This projection is what the
+ * decision actually needs: what the work is, who does it, what it costs, on what
+ * terms, and the id to claim it with.
+ *
+ * Deliberately no `raw` escape hatch. The full document is one `agreement_get`
+ * away for the row you chose, and an escape hatch here would just restore the
+ * cost for every row you did not.
+ */
+export declare function toListingRow(a: Record<string, any>, kind: 'request' | 'offer'): {
+    createdAt: any;
+    requiredConnections?: any;
+    payer?: any;
+    provider?: any;
+    providerAgent?: any;
+    maxExecutions?: any;
+    conversationAllowance?: any;
+    expiresAt?: any;
+    engagementKind: any;
+    lifecycle: any;
+    billing?: any;
+    agreementId: any;
+    kind: "request" | "offer";
+    description: any;
+    price: any;
+    priceUnit: string;
+};
 /**
  * the marketplace read on both surfaces. Publishing and claiming
  * ride the agreement grammar (propose-with-audience / agreement_claim); this

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';
@@ -29,7 +29,7 @@ const named = (id) => typeof id === 'string' && id && !BROADCASTS.has(id) ? id :
  * away for the row you chose, and an escape hatch here would just restore the
  * cost for every row you did not.
  */
-function toListingRow(a, kind) {
+export function toListingRow(a, kind) {
     const terms = a?.terms ?? {};
     const parties = a?.parties ?? {};
     const requiredConnections = terms.requiredConnections ?? [];
@@ -38,6 +38,7 @@ function toListingRow(a, kind) {
         kind,
         description: terms.description ?? '',
         price: a?.money?.price ?? 0,
+        priceUnit: 'hundredths of a point',
         // What that price MEANS: a whole-engagement total, or a rate charged per
         // completed task. Omitting it left a metered standing hire indistinguishable
         // from a flat-priced one at the moment a caller decides to claim, and
@@ -93,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);
@@ -109,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/http/AssistantConnectionClient.js

@@ -22,6 +22,10 @@ export class AssistantConnectionClient {
                 Authorization: `Bearer ${this.creds.operatorKey}`,
                 'Content-Type': 'application/json',
                 'X-Ziggs-Instance': hostIdentity(this.creds.instanceId),
+                ...(this.creds.clientSessionId ? { 'X-Ziggs-Session': this.creds.clientSessionId } : {}),
+                ...(this.creds.workspaceIds ? { 'X-Ziggs-Workspaces': this.creds.workspaceIds } : {}),
+                ...(this.creds.app ? { 'X-Ziggs-App': this.creds.app } : {}),
+                ...(this.creds.sessionName ? { 'X-Ziggs-Session-Name': this.creds.sessionName } : {}),
             },
             ...(body === undefined ? {} : { body: JSON.stringify(body) }),
         });

package/dist/http/InboxClient.d.ts

@@ -9,6 +9,7 @@ export declare class InboxClient {
     private readonly agentId?;
     private readonly baseUrl;
     private readonly instanceId;
+    private readonly session?;
     /**
      * @param operatorKey Agent-scoped or fleet operator key.
      * @param agentId Required for fleet keys (sent as X-Agent-Id). Omit for agent-scoped keys.
@@ -17,7 +18,12 @@ export declare class InboxClient {
      * process is not its host (the CLI, one hosted-MCP connection among many)
      * must pass its own; everything long-lived omits it.
      */
-    constructor(operatorKey: string, agentId?: string, baseUrl?: string, instanceId?: string);
+    constructor(operatorKey: string, agentId?: string, baseUrl?: string, instanceId?: string, session?: {
+        clientSessionId?: string;
+        workspaceIds?: string;
+        app?: string;
+        sessionName?: string;
+    });
     private headers;
     private inboxUrl;
     /** Read without acquiring worker ownership or recording receipts. */

package/dist/http/InboxClient.js

@@ -12,6 +12,7 @@ export class InboxClient {
     agentId;
     baseUrl;
     instanceId;
+    session;
     /**
      * @param operatorKey Agent-scoped or fleet operator key.
      * @param agentId Required for fleet keys (sent as X-Agent-Id). Omit for agent-scoped keys.
@@ -20,13 +21,14 @@ export class InboxClient {
      * process is not its host (the CLI, one hosted-MCP connection among many)
      * must pass its own; everything long-lived omits it.
      */
-    constructor(operatorKey, agentId, baseUrl, instanceId) {
+    constructor(operatorKey, agentId, baseUrl, instanceId, session) {
         if (!operatorKey)
             throw new Error('InboxClient: operatorKey is required');
         this.operatorKey = operatorKey;
         this.agentId = agentId;
         this.baseUrl = baseUrl || getBackendUrl();
         this.instanceId = hostIdentity(instanceId);
+        this.session = session;
     }
     headers() {
         const headers = {
@@ -38,6 +40,14 @@ export class InboxClient {
         };
         if (this.agentId)
             headers['X-Agent-Id'] = this.agentId;
+        if (this.session?.clientSessionId)
+            headers['X-Ziggs-Session'] = this.session.clientSessionId;
+        if (this.session?.workspaceIds)
+            headers['X-Ziggs-Workspaces'] = this.session.workspaceIds;
+        if (this.session?.app)
+            headers['X-Ziggs-App'] = this.session.app;
+        if (this.session?.sessionName)
+            headers['X-Ziggs-Session-Name'] = this.session.sessionName;
         return headers;
     }
     inboxUrl(path, opts) {

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

@@ -6,9 +6,13 @@ export interface PaymentsError extends Error {
 }
 export interface WalletBalance {
     walletId: string | null;
+    /** Always `points` on a read. The wallet row stores a different code. */
     currency: string;
+    /** Hundredths of a point. */
     balance: number;
+    /** Hundredths of a point, total minus holds. */
     availableBalance: number;
+    unit: 'hundredths of a point';
 }
 /**
  * A resolved wallet reference (GET /payments/wallets/resolve).

package/dist/http/PaymentsClient.js

@@ -5,6 +5,10 @@ import { throwApiError } from '../shared/apiError.js';
 function randomIdempotencyKey(prefix = 'op') {
     return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
 }
+/** The wallet stores `pez`. A person or an assistant reads points. */
+function shownPointCurrency(currency) {
+    return typeof currency === 'string' && currency && currency !== 'pez' ? currency : 'points';
+}
 /**
  * the one payments client for every surface (agent-sdk, ziggs-mcp,
  * scripts). Consolidates the former agent-sdk private ZiggsPayClient. Wallet
@@ -45,9 +49,10 @@ export class PaymentsClient {
         const wallet = w['wallet'];
         return {
             walletId: wallet?.['walletId'] || null,
-            currency: wallet?.['currency'] || 'pez',
+            currency: shownPointCurrency(wallet?.['currency']),
             balance: w['balance'] ?? 0,
             availableBalance: w['availableBalance'] ?? 0,
+            unit: 'hundredths of a point',
         };
     }
     async resolve({ userId, agentId } = {}) {

package/dist/types.d.ts

@@ -47,6 +47,18 @@ export interface Creds {
      * `src/instanceIdentity.ts` for what each rail sends.
      */
     instanceId?: string;
+    /**
+     * This window, sent as `X-Ziggs-Session`. Reconnects that present the same
+     * id land on the same row. Unset on a long-lived process: the inbox host
+     * header is the window.
+     */
+    clientSessionId?: string;
+    /** Comma-separated workspace ids. Sent as `X-Ziggs-Workspaces`. Absent does not narrow. */
+    workspaceIds?: string;
+    /** Connection label, sent as `X-Ziggs-App`. */
+    app?: string;
+    /** Person-readable window name, sent as `X-Ziggs-Session-Name`. */
+    sessionName?: string;
 }
 export type TaskState = 'active' | 'proposal' | 'completed' | 'failed' | 'cancelled' | 'ledger_open';
 export type PlanStepStatus = 'pending' | 'in_progress' | 'completed' | 'skipped';

package/package.json

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