@ziggs-ai/api-client 0.1.28 → 0.1.29

package/dist/http/ContextDiscoveryClient.d.ts

@@ -1,16 +1,4 @@
 import 'dotenv/config';
-export interface ContextReachDescriptor {
-    grantId: string;
-    scope: {
-        kind: 'chat' | 'agreement' | 'org';
-        id: string;
-    };
-    temporal: 'from-now' | 'from-start';
-    watermarkAt: string;
-    expiresAt: string | null;
-    parentGrantId: string | null;
-    createdAt: string;
-}
 /** Labels-only pointer to context the agent could request access to (P4). */
 export interface DiscoverableItem {
     type: 'chat';
@@ -22,7 +10,9 @@ export interface DiscoverableItem {
     orgId: string;
 }
 /**
- * ZIG-412 discovery — scope descriptors only, no content.
+ * P4 discovery — labels-only pointers to context the agent could REQUEST but
+ * does not yet hold (`GET /context/discovery/available`). Grants the agent
+ * already holds are listed via the unified `GrantsClient` (GET /grants).
  */
 export declare class ContextDiscoveryClient {
     private readonly operatorKey;
@@ -33,7 +23,6 @@ export declare class ContextDiscoveryClient {
      * @param agentId Required for fleet keys (sent as X-Agent-Id). Omit for agent-scoped keys.
      */
     constructor(operatorKey: string, agentId?: string, baseUrl?: string);
-    discover(): Promise<ContextReachDescriptor[]>;
     /**
      * P4: what context EXISTS in the agent's engaged orgs that it does NOT hold
      * a grant for — so it can request access rather than fail blind. Labels only.

package/dist/http/ContextDiscoveryClient.js

@@ -2,7 +2,9 @@ import 'dotenv/config';
 import { getBackendUrl } from '../utils/urlUtils.js';
 import { buildOperatorHeaders } from './operatorHeaders.js';
 /**
- * ZIG-412 discovery — scope descriptors only, no content.
+ * P4 discovery — labels-only pointers to context the agent could REQUEST but
+ * does not yet hold (`GET /context/discovery/available`). Grants the agent
+ * already holds are listed via the unified `GrantsClient` (GET /grants).
  */
 export class ContextDiscoveryClient {
     operatorKey;
@@ -20,17 +22,6 @@ export class ContextDiscoveryClient {
         this.agentId = agentId;
         this.baseUrl = baseUrl || getBackendUrl();
     }
-    async discover() {
-        const res = await fetch(`${this.baseUrl}/context/discovery`, {
-            headers: buildOperatorHeaders(this.operatorKey, this.agentId),
-        });
-        const body = await res.text().catch(() => '');
-        if (!res.ok) {
-            throw new Error(`ContextDiscoveryClient.discover ${res.status} ${body.slice(0, 200)}`);
-        }
-        const parsed = JSON.parse(body);
-        return parsed.reach ?? [];
-    }
     /**
      * P4: what context EXISTS in the agent's engaged orgs that it does NOT hold
      * a grant for — so it can request access rather than fail blind. Labels only.

package/dist/http/GrantsClient.d.ts

@@ -0,0 +1,45 @@
+import 'dotenv/config';
+import type { GrantView, GrantScopeKind, GrantHealth } from './grants.js';
+export interface ListGrantsQuery {
+    /**
+     * Filter to grants held by this agent. Admin-gated server-side when the caller
+     * is not impersonating that agent.
+     */
+    holderId?: string;
+    /**
+     * Rail/resource filter. One kind or several (the context rail spans three
+     * kinds: chat, agreement, org). Absent = every rail.
+     */
+    scopeKind?: GrantScopeKind | GrantScopeKind[];
+    /** Filter to grants of one health. */
+    health?: GrantHealth;
+    cursor?: string;
+    limit?: number;
+}
+export interface ListGrantsResult {
+    items: GrantView[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+/**
+ * ZIG-648 — unified grant listing across every rail. `GET /grants` returns the
+ * canonical GrantView for each grant the caller holds (or, admin-gated, a named
+ * holder), filterable by scope kind and health, with cursor pagination. Replaces
+ * the old per-rail listers (context discovery, connection-grants,
+ * payment-grants).
+ */
+export declare class GrantsClient {
+    private readonly operatorKey;
+    private readonly agentId?;
+    private readonly baseUrl;
+    constructor(operatorKey: string, agentId?: string, baseUrl?: string);
+    listGrants(query?: ListGrantsQuery): Promise<ListGrantsResult>;
+    /**
+     * Every grant matching `query`, following the cursor to completion. Use when a
+     * caller needs the whole set (reach tagging, catch-up, an owner listing) rather
+     * than a single page — `listGrants` returns only one page (server default 30),
+     * so a holder with more grants than a page would otherwise be silently
+     * truncated. `maxPages` bounds the loop as a runaway guard.
+     */
+    listAllGrants(query?: Omit<ListGrantsQuery, 'cursor'>, maxPages?: number): Promise<GrantView[]>;
+}

package/dist/http/GrantsClient.js

@@ -0,0 +1,72 @@
+import 'dotenv/config';
+import { getBackendUrl } from '../utils/urlUtils.js';
+import { buildOperatorHeaders } from './operatorHeaders.js';
+/**
+ * ZIG-648 — unified grant listing across every rail. `GET /grants` returns the
+ * canonical GrantView for each grant the caller holds (or, admin-gated, a named
+ * holder), filterable by scope kind and health, with cursor pagination. Replaces
+ * the old per-rail listers (context discovery, connection-grants,
+ * payment-grants).
+ */
+export class GrantsClient {
+    operatorKey;
+    agentId;
+    baseUrl;
+    constructor(operatorKey, agentId, baseUrl) {
+        if (!operatorKey)
+            throw new Error('GrantsClient: operatorKey is required');
+        this.operatorKey = operatorKey;
+        this.agentId = agentId;
+        this.baseUrl = baseUrl || getBackendUrl();
+    }
+    async listGrants(query = {}) {
+        const url = new URL(`${this.baseUrl}/grants`);
+        if (query.holderId)
+            url.searchParams.set('holderId', query.holderId);
+        if (query.scopeKind) {
+            const kinds = Array.isArray(query.scopeKind)
+                ? query.scopeKind
+                : [query.scopeKind];
+            for (const k of kinds)
+                url.searchParams.append('scopeKind', k);
+        }
+        if (query.health)
+            url.searchParams.set('health', query.health);
+        if (query.cursor)
+            url.searchParams.set('cursor', query.cursor);
+        if (query.limit != null)
+            url.searchParams.set('limit', String(query.limit));
+        const res = await fetch(url.toString(), {
+            headers: buildOperatorHeaders(this.operatorKey, this.agentId),
+        });
+        const body = await res.text().catch(() => '');
+        if (!res.ok) {
+            throw new Error(`GrantsClient.listGrants ${res.status} ${body.slice(0, 200)}`);
+        }
+        const parsed = JSON.parse(body);
+        return {
+            items: parsed.items ?? [],
+            nextCursor: parsed.nextCursor ?? null,
+            hasMore: parsed.hasMore ?? false,
+        };
+    }
+    /**
+     * Every grant matching `query`, following the cursor to completion. Use when a
+     * caller needs the whole set (reach tagging, catch-up, an owner listing) rather
+     * than a single page — `listGrants` returns only one page (server default 30),
+     * so a holder with more grants than a page would otherwise be silently
+     * truncated. `maxPages` bounds the loop as a runaway guard.
+     */
+    async listAllGrants(query = {}, maxPages = 50) {
+        const all = [];
+        let cursor;
+        for (let page = 0; page < maxPages; page++) {
+            const res = await this.listGrants({ ...query, cursor });
+            all.push(...res.items);
+            if (!res.nextCursor)
+                return all;
+            cursor = res.nextCursor;
+        }
+        return all;
+    }
+}

package/dist/http/grants.d.ts

@@ -15,6 +15,12 @@ export type GrantScopeKind = 'chat' | 'agreement' | 'org' | 'connection' | 'wall
 export interface GrantScopeView {
     kind: GrantScopeKind;
     id: string;
+    /**
+     * Human-readable name for the scoped resource, populated only by the unified
+     * list read (GET /grants / GrantsClient); the per-rail issue/delegate
+     * responses omit it. Optional so the one shape stays additive.
+     */
+    label?: string;
 }
 export interface GrantCaveatView {
     type: string;

package/dist/http/index.d.ts

@@ -9,7 +9,9 @@ export type { ArtifactVisibility, ListArtifactsOptions, ListArtifactsQuery, List
 export { ContextReadClient } from './ContextReadClient.js';
 export type { ContextReadType, ContextReadQuery, ContextReadEnvelope, ContextSnapshotResult, } from './ContextReadClient.js';
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
-export type { ContextReachDescriptor } from './ContextDiscoveryClient.js';
+export type { DiscoverableItem } from './ContextDiscoveryClient.js';
+export { GrantsClient } from './GrantsClient.js';
+export type { ListGrantsQuery, ListGrantsResult } from './GrantsClient.js';
 export { ContextGrantsClient } from './ContextGrantsClient.js';
 export type { ContextGrantRecord, ContextGrantScope, ContextGrantScopeKind, ContextTemporal, IssueContextGrantInput, DelegateContextGrantInput, } from './ContextGrantsClient.js';
 export { grantCaveat } from './grants.js';

package/dist/http/index.js

@@ -6,6 +6,7 @@ export { MessagesClient } from './MessagesClient.js';
 export { ArtifactsClient } from './ArtifactsClient.js';
 export { ContextReadClient } from './ContextReadClient.js';
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
+export { GrantsClient } from './GrantsClient.js';
 export { ContextGrantsClient } from './ContextGrantsClient.js';
 export { grantCaveat } from './grants.js';
 export { AgentSearchClient } from './AgentSearchClient.js';

package/dist/websocket/WebSocketClient.js

@@ -109,6 +109,15 @@ export class WebSocketClient {
         this.socket.on('error', (error) => {
             runtimeLog.error(this.label, `Socket.IO error: ${String(error)}`);
         });
+        // ZIG-860: the send path is fire-and-forget (no ack callback), so the
+        // backend's structured rejection is the ONLY failure signal. Not listening
+        // made every rejected send silent — an agent's message just vanished (the
+        // a2a schema bug hid behind exactly this). Log loudly; delivery recovery
+        // stays with the inbox/catch-up machinery.
+        this.socket.on('chat:error', (payload) => {
+            const p = (payload ?? {});
+            runtimeLog.error(this.label, `chat:error [${p['code'] ?? 'UNKNOWN'}] chatId=${p['chatId'] ?? '-'} messageId=${p['messageId'] ?? '-'}: ${p['message'] ?? ''}`);
+        });
     }
     connectAsync(timeout = 10_000) {
         if (this.socket?.connected)

package/package.json

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