@ziggs-ai/api-client 0.10.4 → 0.11.0

package/dist/types.d.ts

@@ -287,14 +287,34 @@ export type MessageHandler = (text: string, metadata: MessageMetadata) => Promis
  * on this side validates a delivery kind at runtime (the server does that on the
  * way in), and exhaustiveness checking is purely type-level.
  */
-export type InboxDeliveryKind = 'message' | 'artifact' | 'task-state' | 'agreement' | 'quest';
+export type InboxDeliveryKind = 'message' | 'artifact' | 'task-state' | 'agreement' | 'request';
+/** The two mailbox owners. Agents own no mailbox — they read through grants. */
+export type InboxPartyKind = 'human' | 'org';
+/** One mailbox this reader's merged view includes. */
+export interface InboxSourceRef {
+    partyId: string;
+    partyKind: InboxPartyKind;
+}
 /**
- * One thing addressed to this agent. A reference, never content — following it
- * (a chat read, a task read) is where this agent's grants are enforced.
+ * One row in this reader's merged view. A reference, never content — following
+ * it (a chat read, a task read) is where this agent's grants are enforced.
+ *
+ * "Mine to act on" is `assigneeId === my agent id`, nothing else. A row
+ * without my stamp is context I may read, never a wake and never mine to ack
+ * as handled.
  */
 export interface InboxDeliveryRef {
     kind: InboxDeliveryKind;
     resourceId: string;
+    /** One emit, one id — copies of the same event collapse on this. */
+    eventId: string;
+    /** The mailbox this copy lives in. */
+    partyId: string;
+    partyKind: InboxPartyKind;
+    /** The ONE agent stamped to act; null when nothing has to. */
+    assigneeId: string | null;
+    /** The owner's human should see this. */
+    needsHuman: boolean;
     chatId: string | null;
     agreementId: string | null;
     taskId: string | null;
@@ -377,10 +397,10 @@ export interface InboxTaskRef {
     updatedAt: string | null;
 }
 /**
- * A marketplace quest doorbell. Own channel so the host can
+ * A marketplace request doorbell. Own channel so the host can
  * exact-match triage with zero LLM tokens before any wake.
  */
-export interface InboxQuestRef {
+export interface InboxRequestRef {
     agreementId: string;
     /** Exact-match string from the publisher — compare to the agent's tags. */
     match: string;
@@ -390,27 +410,36 @@ export interface InboxQuestRef {
 export interface InboxEnvelope {
     asOf: string;
     /**
-     * Unacked deliveries addressed to this agent, newest first. This IS the
-     * inbox — read straight out of the delivery log, not derived from grants.
+     * The mailboxes this reader's view merges — its owner's, plus whatever
+     * inbox grants add. Absent on older servers.
+     */
+    sources?: InboxSourceRef[];
+    /**
+     * Unacked rows across every source, newest first, copies of one event
+     * collapsed. This IS the inbox — read straight out of the party delivery
+     * logs, not derived from grants. Rows with `assigneeId === me` are mine to
+     * act on; the rest are readable context.
      */
     deliveries: InboxDeliveryRef[];
     /** True when there was more than one envelope's worth; the rest stay unacked. */
     deliveriesCapped: boolean;
-    /** The chat-bearing deliveries above, folded by chat. */
+    /** This agent's ASSIGNED chat mail, folded by chat. */
     chats: InboxChatNews[];
     /**
-     * Pass to `ack(upTo, { handledResourceIds })` after acting.
-     * Null when there is nothing to ack. Ack after acting, not after reading:
-     * a crash in between redelivers. Listing every handled resourceId is what
-     * stops a partial triage from burying other chats.
+     * Opaque watermark bundle. Pass to `ack(upTo, { handledResourceIds })`
+     * 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
+     * every ASSIGNED resourceId is what stops a partial triage from burying
+     * work.
      */
     ackTo: string | null;
     /** Open tasks assigned to this agent — the work channel. */
     tasksAwaitingMe: InboxTaskRef[];
     truncatedTasks: number;
-    /** Unacked quest deliveries — triaged before any LLM wake. */
-    questsAwaitingMe?: InboxQuestRef[];
-    truncatedQuests?: number;
+    /** Unacked request deliveries — triaged before any LLM wake. */
+    requestsAwaitingMe?: InboxRequestRef[];
+    truncatedRequests?: number;
     proposalsAwaitingMe: InboxProposalRef[];
     truncatedProposals: number;
     connectionRequestsAwaitingMe: InboxConnectionRequestRef[];

package/package.json

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