@ziggs-ai/api-client 0.1.13 → 0.1.15

package/dist/http/ArtifactsClient.d.ts

@@ -18,8 +18,9 @@ export interface WriteArtifactInput {
     visibility?: ArtifactVisibility;
     /** When the artifact is associated with a chat. */
     chatId?: string;
-    /** When the artifact is associated with an agreement (and optionally a task). */
+    /** When the artifact is associated with an agreement. */
     agreementId?: string;
+    /** Optional task binding — creates a TaskArtifactLink alongside the primary scope link. */
     taskId?: string;
     service?: Record<string, unknown>;
 }

package/dist/http/ChatClient.d.ts

@@ -13,7 +13,12 @@ export declare function openConversation(participantId: string, creds: Creds): P
 }>;
 export interface SendChatMessageInput {
     chatId: string;
-    receiverId: string;
+    /**
+     * Recipient id. Optional (ZIG-548): when omitted, the backend infers the
+     * receiver if the chat has exactly one other member (one agent, or one
+     * other human). Provide it explicitly in chats with multiple members.
+     */
+    receiverId?: string;
     text: string;
     messageId: string;
     entryType?: string;

package/dist/http/InboxClient.d.ts

@@ -1,5 +1,15 @@
 import 'dotenv/config';
 export type InboxScopeKind = 'chat' | 'agreement' | 'org';
+/**
+ * ZIG-543: which chats a multi-chat scope's news is in. Lets a scope-granted
+ * agent open the conversations behind the count (e.g. GET /chats/:chatId/messages).
+ */
+export interface InboxScopeChat {
+    chatId: string;
+    newMessages: number;
+    newArtifacts: number;
+    latestAt: string | null;
+}
 export interface InboxScopeEntry {
     scope: {
         kind: InboxScopeKind;
@@ -9,6 +19,10 @@ export interface InboxScopeEntry {
     newArtifacts: number;
     latestAt: string | null;
     since: string;
+    /** Per-chat breakdown for org / agreement scopes (ZIG-543). Absent for a chat scope. */
+    chats?: InboxScopeChat[];
+    /** Chats with news beyond the per-scope cap, not listed in `chats`. */
+    truncatedChats?: number;
 }
 export interface InboxProposalRef {
     agreementId: string;

package/dist/http/TaskClient.d.ts

@@ -46,6 +46,17 @@ export declare function claimLedgerTask(agreementId: string, creds: Creds, optio
 }): Promise<Agreement>;
 export declare function reportTask(taskId: string, message: string | undefined, creds: Creds): Promise<Task>;
 export declare function setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative', creds: Creds): Promise<Task>;
+export interface ListTasksOptions {
+    state?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface ListTasksResult {
+    tasks: Task[];
+    hasMore: boolean;
+    nextCursor?: string | null;
+}
+export declare function listTasks(options: ListTasksOptions | undefined, creds: Creds): Promise<ListTasksResult>;
 export interface CountTasksFilters {
     chatId?: string;
     state?: string;
@@ -71,5 +82,6 @@ export declare class TaskClient {
     }): Promise<Agreement>;
     reportTask(taskId: string, message?: string): Promise<Task>;
     setTaskSatisfaction(taskId: string, satisfaction: 'positive' | 'negative'): Promise<Task>;
+    listTasks(options?: ListTasksOptions): Promise<ListTasksResult>;
     countTasks(filters?: CountTasksFilters): Promise<number>;
 }

package/dist/http/TaskClient.js

@@ -305,6 +305,31 @@ export async function setTaskSatisfaction(taskId, satisfaction, creds) {
         throw new Error('Invalid response: task data not found');
     return task;
 }
+export async function listTasks(options = {}, creds) {
+    assertCreds(creds, 'list tasks');
+    const url = new URL(getTaskBaseUrl());
+    if (options.state)
+        url.searchParams.set('state', options.state);
+    if (options.cursor)
+        url.searchParams.set('cursor', options.cursor);
+    if (options.limit != null)
+        url.searchParams.set('limit', String(options.limit));
+    const res = await fetch(url.toString(), {
+        method: 'GET',
+        headers: buildHeaders(creds),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        throwApiError(res, body, `List tasks failed: ${res.status} ${res.statusText}`);
+    }
+    const data = await res.json().catch(() => null);
+    const tasks = Array.isArray(data?.['tasks']) ? data['tasks'] : [];
+    return {
+        tasks,
+        hasMore: Boolean(data?.['hasMore']),
+        nextCursor: data?.['nextCursor'] ?? null,
+    };
+}
 export async function countTasks(filters = {}, creds) {
     assertCreds(creds, 'count tasks');
     // Canonical REST: GET /tasks/count.
@@ -353,5 +378,6 @@ export class TaskClient {
     claimLedgerTask(taskId, options) { return claimLedgerTask(taskId, this.creds, options); }
     reportTask(taskId, message) { return reportTask(taskId, message, this.creds); }
     setTaskSatisfaction(taskId, satisfaction) { return setTaskSatisfaction(taskId, satisfaction, this.creds); }
+    listTasks(options) { return listTasks(options ?? {}, this.creds); }
     countTasks(filters) { return countTasks(filters, this.creds); }
 }

package/package.json

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