@ziggs-ai/api-client 0.40.3 → 0.40.4

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.40.4
+
+- `InboxEnvelope.bellAt`: the latest delivery a read answered. `getInbox({ seen })` passes it back so a held read answers only mail delivered after it.
+
 ## 0.40.3
 
 - `InboxClient` takes `sharedHost` in its session options: it sends `X-Ziggs-Inbox-Hosts: shared`, so several processes can host one agent at once, and `getInbox({ capacity })` says how many more threads this host can start. `InboxEnvelope.host` reports whether this host leads.

package/dist/http/InboxClient.js

@@ -61,6 +61,8 @@ export class InboxClient {
         if (opts.waitSeconds != null && opts.waitSeconds > 0) {
             url.searchParams.set('wait', String(opts.waitSeconds));
         }
+        if (opts.seen)
+            url.searchParams.set('seen', opts.seen);
         return url.toString();
     }
     /** At most 25 retained references per page. Keep cursor for subsequent waits;

package/dist/types.d.ts

@@ -423,6 +423,8 @@ export interface InboxEnvelope extends InboxRequestChannel, Partial<InboxPlanAck
         leader: boolean;
     };
     asOf: string;
+    /** The latest delivery this read answered; pass it back as `seen`. */
+    bellAt?: string | null;
     /**
      * The mailboxes this reader's view merges — its owner's, plus whatever
      * inbox grants add. Absent on older servers.
@@ -497,6 +499,10 @@ export interface InboxAckResult {
  */
 export interface InboxReadOptions {
     waitSeconds?: number;
+    /** The `bellAt` of the last envelope this host read. A held read then answers
+     * only mail delivered after it, so a host still working on those rows waits
+     * for new mail instead of being handed them again. */
+    seen?: string;
 }
 /** Count-only peek. Does not take the inbox host lease. */
 export interface InboxPeek {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.40.3",
+  "version": "0.40.4",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "homepage": "https://ziggsai.com/docs",
   "bugs": {