@ziggs-ai/api-client 0.1.8 → 0.1.9

package/dist/http/InboxClient.d.ts

@@ -0,0 +1,53 @@
+import 'dotenv/config';
+export type InboxScopeKind = 'chat' | 'agreement' | 'org';
+export interface InboxScopeEntry {
+    scope: {
+        kind: InboxScopeKind;
+        id: string;
+    };
+    newMessages: number;
+    newArtifacts: number;
+    latestAt: string | null;
+    since: string;
+}
+export interface InboxProposalRef {
+    agreementId: string;
+    title: string;
+    proposedAt: string | null;
+}
+export interface InboxEnvelope {
+    asOf: string;
+    scopes: InboxScopeEntry[];
+    truncatedScopes: number;
+    countCap: number;
+    proposalsAwaitingMe: InboxProposalRef[];
+    truncatedProposals: number;
+}
+export interface InboxAck {
+    kind: InboxScopeKind;
+    id: string;
+    upTo: string;
+}
+export interface InboxAckResult {
+    acked: Array<{
+        scope: {
+            kind: InboxScopeKind;
+            id: string;
+        };
+        ackedUpTo: string;
+    }>;
+}
+/**
+ * The doorbell, not the door (ZIG-434): references and counts since the
+ * agent's last ack — never content. Flow: inbox → read → act → ack (ZIG-446).
+ * Wraps `GET /agent-api/v1/inbox` and `POST /agent-api/v1/inbox/ack`.
+ */
+export declare class InboxClient {
+    private readonly operatorKey;
+    private readonly agentId;
+    private readonly baseUrl;
+    constructor(operatorKey: string, agentId: string, baseUrl?: string);
+    private headers;
+    getInbox(): Promise<InboxEnvelope>;
+    ack(scopes: InboxAck[]): Promise<InboxAckResult>;
+}

package/dist/http/InboxClient.js

@@ -0,0 +1,53 @@
+import 'dotenv/config';
+import { getBackendUrl } from '../utils/urlUtils.js';
+/**
+ * The doorbell, not the door (ZIG-434): references and counts since the
+ * agent's last ack — never content. Flow: inbox → read → act → ack (ZIG-446).
+ * Wraps `GET /agent-api/v1/inbox` and `POST /agent-api/v1/inbox/ack`.
+ */
+export class InboxClient {
+    operatorKey;
+    agentId;
+    baseUrl;
+    constructor(operatorKey, agentId, baseUrl) {
+        if (!operatorKey)
+            throw new Error('InboxClient: operatorKey is required');
+        if (!agentId) {
+            throw new Error('InboxClient: agentId is required (operator-token impersonation)');
+        }
+        this.operatorKey = operatorKey;
+        this.agentId = agentId;
+        this.baseUrl = baseUrl || getBackendUrl();
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.operatorKey}`,
+            'X-Agent-Id': this.agentId,
+            'Content-Type': 'application/json',
+        };
+    }
+    async getInbox() {
+        const res = await fetch(`${this.baseUrl}/agent-api/v1/inbox`, {
+            headers: this.headers(),
+        });
+        const body = await res.text().catch(() => '');
+        if (!res.ok) {
+            throw new Error(`InboxClient.getInbox ${res.status} ${body.slice(0, 200)}`);
+        }
+        return JSON.parse(body);
+    }
+    async ack(scopes) {
+        if (!scopes.length)
+            throw new Error('InboxClient.ack: scopes are required');
+        const res = await fetch(`${this.baseUrl}/agent-api/v1/inbox/ack`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({ scopes }),
+        });
+        const body = await res.text().catch(() => '');
+        if (!res.ok) {
+            throw new Error(`InboxClient.ack ${res.status} ${body.slice(0, 200)}`);
+        }
+        return JSON.parse(body);
+    }
+}

package/dist/http/index.d.ts

@@ -16,3 +16,5 @@ export { ContextGrantsClient } from './ContextGrantsClient.js';
 export type { ContextGrantRecord, ContextGrantScope, ContextGrantScopeKind, ContextTemporal, IssueContextGrantInput, DelegateContextGrantInput, } from './ContextGrantsClient.js';
 export { AgentSearchClient } from './AgentSearchClient.js';
 export { TelemetryClient } from './TelemetryClient.js';
+export { InboxClient } from './InboxClient.js';
+export type { InboxScopeKind, InboxScopeEntry, InboxProposalRef, InboxEnvelope, InboxAck, InboxAckResult, } from './InboxClient.js';

package/dist/http/index.js

@@ -10,3 +10,4 @@ export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
 export { ContextGrantsClient } from './ContextGrantsClient.js';
 export { AgentSearchClient } from './AgentSearchClient.js';
 export { TelemetryClient } from './TelemetryClient.js';
+export { InboxClient } from './InboxClient.js';

package/package.json

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