@cotal-ai/pi 0.29.2 → 0.30.0

package/dist/inbox-turn.d.ts

@@ -2,7 +2,7 @@ import type { ExactDrainResult, InboxItem, InboxScope } from "./inbox-types.js";
 export interface InboxSource {
     peekInbox(scope?: InboxScope): InboxItem[];
     drainInbox(limit?: number): InboxItem[];
-    drainInboxIds(ids: readonly string[]): ExactDrainResult;
+    drainInboxDeliveries(keys: readonly string[]): ExactDrainResult;
 }
 export interface CommitResult {
     drained: number;
@@ -19,11 +19,14 @@ export declare class InboxTurn {
     private previousTombstones;
     constructor(source: InboxSource);
     peek(scope?: InboxScope): InboxItem[];
-    /** Remove already-confirmed late duplicates by exact id, even behind pull-only traffic. */
+    /** Remove already-confirmed late duplicates by exact receive key, even behind pull-only traffic.
+     *  #624: tombstones and selection address the DELIVERY (InboxItem.recvKey). An empty wire id is
+     *  never a key, so two distinct id-less deliveries never cross-reserve or cross-tombstone each
+     *  other inside a turn. */
     discardTombstoned(): number;
     /** Exact discard for adapter-local traffic such as own echoes, even behind pull-only items. */
     discardMatching(match: (item: InboxItem) => boolean): number;
-    /** Select the next automatic FIFO batch after already-reserved ids. */
+    /** Select the next automatic FIFO batch after already-reserved receive keys. */
     select(reserved: ReadonlySet<string>, limit: number): InboxItem[];
     /** Commit provider-confirmed ids exactly; tombstone any already absent after overflow. */
     commitConfirmed(ids: readonly string[]): CommitResult;

package/dist/inbox-turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-turn.d.ts","sourceRoot":"","sources":["../src/inbox-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,EAAE,CAAC;IAC3C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACxC,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;GAIG;AACH,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,kBAAkB,CAAqB;gBAElB,MAAM,EAAE,WAAW;IAEhD,IAAI,CAAC,KAAK,GAAE,UAAkB,GAAG,SAAS,EAAE;IAI5C,2FAA2F;IAC3F,iBAAiB,IAAI,MAAM;IAM3B,+FAA+F;IAC/F,eAAe,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM;IAM5D,uEAAuE;IACvE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAUjE,0FAA0F;IAC1F,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY;IASrD,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAOrB"}
+{"version":3,"file":"inbox-turn.d.ts","sourceRoot":"","sources":["../src/inbox-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,EAAE,CAAC;IAC3C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACxC,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAAC;CACjE;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;GAIG;AACH,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,kBAAkB,CAAqB;gBAElB,MAAM,EAAE,WAAW;IAEhD,IAAI,CAAC,KAAK,GAAE,UAAkB,GAAG,SAAS,EAAE;IAI5C;;;+BAG2B;IAC3B,iBAAiB,IAAI,MAAM;IAM3B,+FAA+F;IAC/F,eAAe,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM;IAM5D,gFAAgF;IAChF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAUjE,0FAA0F;IAC1F,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY;IASrD,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/inbox-types.d.ts

@@ -12,6 +12,10 @@
 export type InboxScope = "all" | "automatic" | "pull-only";
 export interface InboxItem {
     id: string;
+    /** Opaque per-delivery receive key (#624): the address for exact drains and in-flight holds. The
+     *  wire id when the message carries one; a minted key when the id is empty (an empty id is never
+     *  a dedup key and never an address). Never dedup authority. */
+    recvKey: string;
     ts: number;
     fromId: string;
     fromName: string;
@@ -31,9 +35,9 @@ export interface InboxItem {
     replyTo?: string;
     contextId?: string;
 }
-/** An exact-id drain: the items found plus the ids that were not present. */
+/** An exact-key drain: the items found plus the receive keys that were not present. */
 export interface ExactDrainResult {
     items: InboxItem[];
-    missingIds: string[];
+    missingKeys: string[];
 }
 //# sourceMappingURL=inbox-types.d.ts.map

package/dist/inbox-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-types.d.ts","sourceRoot":"","sources":["../src/inbox-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,+FAA+F;IAC/F,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB"}
+{"version":3,"file":"inbox-types.d.ts","sourceRoot":"","sources":["../src/inbox-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;;oEAEgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,+FAA+F;IAC/F,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB"}