@ziggs-ai/api-client 0.1.18 → 0.1.20

package/dist/http/ChatClient.d.ts

@@ -1,12 +1,14 @@
 import 'dotenv/config';
 import { type Creds } from '../types.js';
+/** Shape of GET /chats/mine items — the backend's ChatReadDto (ZIG-665). */
 export interface ChatSummary {
     chatId: string;
-    userIds?: string[];
-    agentIds?: string[];
-    createdAt?: string;
-    updatedAt?: string;
-    [key: string]: unknown;
+    members: Array<{
+        principalId: string;
+        agentId: string | null;
+    }>;
+    orgId: string | null;
+    isOrgChat: boolean;
 }
 export declare function openConversation(participantId: string, creds: Creds): Promise<{
     chatId: string;

package/dist/http/ContextGrantsClient.d.ts

@@ -39,7 +39,6 @@ export declare class ContextGrantsClient {
     private readonly agentId;
     private readonly baseUrl;
     constructor(operatorKey: string, agentId: string, baseUrl?: string);
-    listGrants(holderId?: string): Promise<ContextGrantRecord[]>;
     issueGrant(input: IssueContextGrantInput): Promise<ContextGrantRecord>;
     delegateGrant(parentGrantId: string, input: DelegateContextGrantInput): Promise<ContextGrantRecord>;
     revokeGrant(grantId: string): Promise<{

package/dist/http/ContextGrantsClient.js

@@ -49,24 +49,6 @@ export class ContextGrantsClient {
         this.agentId = agentId;
         this.baseUrl = baseUrl || getBackendUrl();
     }
-    async listGrants(holderId) {
-        assertCreds({ operatorKey: this.operatorKey, agentId: this.agentId }, 'listGrants');
-        const qs = holderId
-            ? `?${new URLSearchParams({ holderId }).toString()}`
-            : '';
-        const res = await fetch(`${this.baseUrl}/context/grants${qs}`, {
-            headers: buildHeaders({
-                operatorKey: this.operatorKey,
-                agentId: this.agentId,
-            }),
-        });
-        const body = await res.text().catch(() => '');
-        if (!res.ok) {
-            throwApiError(res, body, `listGrants failed: ${res.status} ${res.statusText}`);
-        }
-        const parsed = JSON.parse(body);
-        return parsed.grants ?? [];
-    }
     async issueGrant(input) {
         assertCreds({ operatorKey: this.operatorKey, agentId: this.agentId }, 'issueGrant');
         const res = await fetch(`${this.baseUrl}/context/grants`, {

package/dist/http/InboxClient.d.ts

@@ -35,14 +35,25 @@ export interface InboxConnectionRequestRef {
     message: string | null;
     requestedAt: string | null;
 }
+/** Agent asking its principal to connect an MCP server + grant tools (ZIG-686). */
+export interface InboxMcpServerRequestRef {
+    requestId: string;
+    requesterAgentId: string;
+    serverUrl: string;
+    tools: string[];
+    reason: string | null;
+    requestedAt: string | null;
+}
 /** Pull-only MCP: prompt the human when proposals need a decision (ZIG-482 / ZIG-481). */
 export interface InboxHumanAttention {
     required: true;
-    reason: 'proposals_awaiting_me' | 'connection_requests_awaiting_me' | 'multiple';
+    reason: 'proposals_awaiting_me' | 'connection_requests_awaiting_me' | 'mcp_server_requests_awaiting_me' | 'multiple';
     proposalCount: number;
     truncatedProposals: number;
     connectionRequestCount: number;
     truncatedConnectionRequests: number;
+    mcpServerRequestCount: number;
+    truncatedMcpServerRequests: number;
     promptUser: string;
 }
 export interface InboxEnvelope {
@@ -54,6 +65,9 @@ export interface InboxEnvelope {
     truncatedProposals: number;
     connectionRequestsAwaitingMe: InboxConnectionRequestRef[];
     truncatedConnectionRequests: number;
+    /** Agent requests to connect an MCP server awaiting the user (ZIG-686). */
+    mcpServerRequestsAwaitingMe: InboxMcpServerRequestRef[];
+    truncatedMcpServerRequests: number;
     humanAttention?: InboxHumanAttention;
 }
 export interface InboxAck {

package/dist/http/index.d.ts

@@ -17,4 +17,4 @@ export type { ContextGrantRecord, ContextGrantScope, ContextGrantScopeKind, Cont
 export { AgentSearchClient } from './AgentSearchClient.js';
 export { TelemetryClient } from './TelemetryClient.js';
 export { InboxClient } from './InboxClient.js';
-export type { InboxScopeKind, InboxScopeEntry, InboxProposalRef, InboxConnectionRequestRef, InboxEnvelope, InboxAck, InboxAckResult, } from './InboxClient.js';
+export type { InboxScopeKind, InboxScopeEntry, InboxProposalRef, InboxConnectionRequestRef, InboxMcpServerRequestRef, InboxHumanAttention, InboxEnvelope, InboxAck, InboxAckResult, } from './InboxClient.js';

package/dist/types.d.ts

@@ -23,18 +23,26 @@ export interface Task {
     /** Explicit delegation target (ZIG-586) — id of the agent/user this task is assigned to, or null when unassigned. */
     assigneeId?: string | null;
     agreementId?: string;
-    agreement?: Agreement;
+    /** Compact reference to the governing agreement (ZIG-665). Read endpoints
+     * never inline the full agreement — fetch it via getAgreement when the
+     * paper-work (money, approvals) matters. */
+    agreement?: AgreementSummary | null;
     state: TaskState;
-    processing?: boolean;
-    deleted?: boolean;
     result?: unknown;
     errorMessage?: string;
     createdAt?: string;
     updatedAt?: string;
     parentTaskId?: string;
     rootTaskId?: string;
-    plan?: PlanStep[];
+    plan?: {
+        steps?: PlanStep[];
+    };
+    planReview?: unknown;
     history?: unknown[];
+    creatorIsYou?: boolean;
+    providerIsYou?: boolean;
+    payerIsYou?: boolean;
+    proposedToIsYou?: boolean;
 }
 export type AgreementStatus = 'pending' | 'active' | 'fulfilled' | 'cancelled' | 'rejected' | (string & {});
 export type ProposalStatus = 'pending' | 'approved' | 'rejected' | 'countered' | 'expired' | (string & {});
@@ -46,6 +54,23 @@ export declare const AGREEMENT_ENGAGEMENT_KIND: {
     readonly LINK: "link";
 };
 export type EngagementKind = (typeof AGREEMENT_ENGAGEMENT_KIND)[keyof typeof AGREEMENT_ENGAGEMENT_KIND];
+/** Compact agreement reference carried by task reads (ZIG-665). */
+export interface AgreementSummary {
+    agreementId: string;
+    description: string;
+    status: AgreementStatus;
+    parties?: {
+        proposedTo?: string | null;
+        provider?: string | null;
+        payer?: string | null;
+        creator?: string | null;
+        creatorAgent?: string | null;
+        providerAgent?: string | null;
+    };
+    /** The opposite party relative to the requesting agent; null for observers,
+     * broadcast sentinels, and self-agreements. */
+    counterparty: string | null;
+}
 export interface AgreementApprovalEntry {
     partyId: string;
     role?: string;

package/package.json

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