@ziggs-ai/api-client 0.36.0 → 0.36.1

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

@@ -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

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/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.1",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",