@ziggs-ai/api-client 0.37.28 → 0.38.0

package/dist/types.d.ts

@@ -19,23 +19,10 @@ export declare class RateLimitedError extends ApiError {
     constructor(message: string, retryAfterMs: number | null, body?: string, code?: string | null);
 }
 export interface Creds {
+    executionContextId?: string;
     operatorKey: string;
     agentId: string;
-    /**
-     * the lane (chat id, or `agrn-<agreementId>`) this call is being
-     * made from. Sent as `X-Ziggs-Lane` so the backend can fence the wake to the
-     * engagement the agent is actually acting inside.
-     *
-     * The operator key says WHO is calling; this says ON WHOSE BEHALF, RIGHT NOW.
-     * Without it an agent serving several customers carries its full authority
-     * into every call, so a read spans every engagement it holds rather than
-     * staying inside the one being worked.
-     *
-     * Optional, and omitting it can only narrow what comes back (the backend
-     * falls back to the agent's own org) — never widen it. Nothing here is
-     * trusted: the server re-derives the party orgs itself and refuses a lane the
-     * agent is not in.
-     */
+    /** Presentation routing only; authority comes from the execution context. */
     laneId?: string;
     /**
      * This host's stable identity, sent as `X-Ziggs-Instance` on inbox reads and
@@ -380,6 +367,8 @@ export interface InboxChatNews {
     latestAt: string;
 }
 export interface InboxProposalRef {
+    executionContext?: import('@ziggs-ai/contracts').WorkExecutionContext;
+    executionBlocked?: import('@ziggs-ai/contracts').ExecutionBlock;
     agreementId: string;
     title: string;
     proposedAt: string | null;
@@ -441,6 +430,8 @@ export interface InboxHumanAttention {
  * agreement (or self-assigned) reached nobody.
  */
 export interface InboxTaskRef {
+    executionContext?: import('@ziggs-ai/contracts').WorkExecutionContext;
+    executionBlocked?: import('@ziggs-ai/contracts').ExecutionBlock;
     taskId: string;
     agreementId: string | null;
     title: string;
@@ -488,7 +479,7 @@ export interface InboxEnvelope extends InboxRequestChannel {
     /** This agent's ASSIGNED chat mail, folded by chat. */
     chats: InboxChatNews[];
     /**
-     * Opaque watermark bundle. Pass to `ack(upTo, { handledResourceIds })`
+     * Opaque watermark bundle. Pass to `ack(upTo, { handledDeliveryIds })`
      * VERBATIM after acting — never construct or parse one; the per-mailbox
      * positions live inside the value. Null when there is nothing to ack. Ack
      * after acting, not after reading: a crash in between redelivers. Listing
@@ -510,6 +501,14 @@ export interface InboxEnvelope extends InboxRequestChannel {
 export interface InboxAckResult {
     /** Where the watermark now sits. Monotonic — a rewind is a no-op, not an error. */
     ackedUpTo: string | null;
+    /**
+     * Handled ids the server left pending: assigned to you, but the work became
+     * unreadable or blocked before the ack. Every other id in the ack settled.
+     */
+    refusedDeliveryIds?: Array<{
+        id: string;
+        reason: string;
+    }>;
 }
 /**
  * Long-poll option shared by the inbox reads. The server holds the request up

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.37.28",
+  "version": "0.38.0",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {
@@ -31,7 +31,7 @@
     "test:watch": "node --import tsx/esm --test --watch test/*.test.ts"
   },
   "dependencies": {
-    "@ziggs-ai/contracts": "^0.31.0",
+    "@ziggs-ai/contracts": "^0.32.0",
     "socket.io-client": "^4.7.0"
   },
   "keywords": [