@ziggs-ai/contracts 0.7.3 → 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/inbox.d.ts +28 -0
  2. package/package.json +1 -1
package/dist/inbox.d.ts CHANGED
@@ -101,6 +101,34 @@ export interface InboxDeliveryRef {
101
101
  to: string;
102
102
  cause: string;
103
103
  }>;
104
+ /**
105
+ * ZIG-1820 — present when the reader holds nothing that opens this row's
106
+ * container. The pointer is in their mail, the content is not.
107
+ *
108
+ * A row lands in a mailbox by participation; the read behind it is gated by
109
+ * a grant. The two can disagree — a grant expires, a room is left, admission
110
+ * never minted one — and before this the protocol stamped the row as the
111
+ * reader's work and pre-filled a read that refused. A row carrying this is
112
+ * reported with `assigneeId: null` and `needsHuman: true`: it is not the
113
+ * agent's to handle, it does not block their ack, and it is not planned as a
114
+ * read. `remedy` says in one line what would put it in reach.
115
+ */
116
+ outOfReach?: {
117
+ scopeKind: 'chat' | 'agreement' | 'task';
118
+ scopeId: string;
119
+ remedy: string;
120
+ } | null;
121
+ /**
122
+ * ZIG-1840 — the ack token covering this row and everything before it in
123
+ * this window. Absent on older servers, and on rows pinned into the envelope
124
+ * out of order (they must not move the mark — ZIG-1742).
125
+ *
126
+ * The envelope's `ackTo` covers the whole window, so a reader that acks only
127
+ * at the end of a pass holds the watermark for the entire pass. That is long
128
+ * enough for the stand-in's takeover window to elapse mid-work. Acking with
129
+ * this row's token instead ends the pass's exposure at each step.
130
+ */
131
+ ackTo?: string | null;
104
132
  /** Assigned host first returned this row. Peek does not stamp it. */
105
133
  firstReadAt?: string | null;
106
134
  /** Assignee next wrote in the same chat. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ziggs-ai/contracts",
3
- "version": "0.7.3",
3
+ "version": "0.7.5",
4
4
  "description": "Wire contracts for the Ziggs API — response shapes, error body, and socket events, shared by every client.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",