@cotal-ai/pi 0.11.1

package/dist/inbox-turn.js

@@ -0,0 +1,108 @@
+const TOMBSTONE_CAP = 4096;
+/**
+ * Pi-local acknowledgement ledger over MeshAgent's public prefix-drain API.
+ *
+ * A provider-confirmed batch is drained only when its still-buffered ids are the current front
+ * prefix. Missing ids are allowed only at the older edge, where MeshAgent's bounded inbox may have
+ * force-evicted them. Anything else is tombstoned and left unacked rather than risking a positional
+ * drain of unrelated traffic. A late duplicate is discarded only when it reaches the front.
+ */
+export class InboxTurn {
+    source;
+    tombstones = new Set();
+    previousTombstones = new Set();
+    constructor(source) {
+        this.source = source;
+    }
+    peek() {
+        return this.source.peekInbox();
+    }
+    /** Remove already-confirmed late duplicates from the front, one exact item at a time. */
+    discardTombstonedFront() {
+        let discarded = 0;
+        while (true) {
+            const front = this.source.peekInbox()[0];
+            if (!front || !this.hasTombstone(front.id))
+                return discarded;
+            this.source.drainInbox(1);
+            discarded++;
+        }
+    }
+    /** Prefix-only discard for adapter-local traffic such as own channel echoes. */
+    discardFront(match) {
+        let discarded = 0;
+        while (true) {
+            const front = this.source.peekInbox()[0];
+            if (!front || !match(front))
+                return discarded;
+            this.source.drainInbox(1);
+            discarded++;
+        }
+    }
+    /**
+     * Select the next FIFO batch after already-reserved ids. `boundary` is never skipped: a buried
+     * echo or other local boundary waits until older reserved work reaches a terminal decision.
+     */
+    select(reserved, boundary, limit) {
+        const selected = [];
+        for (const item of this.source.peekInbox()) {
+            if (reserved.has(item.id))
+                continue;
+            if (boundary(item))
+                break;
+            selected.push(item);
+            if (selected.length >= limit)
+                break;
+        }
+        return selected;
+    }
+    /**
+     * Commit provider-confirmed ids without ever calling drainInbox(0), which means "drain all" in
+     * MeshAgent. On an invariant mismatch, acknowledge nothing and retain tombstones for exact later
+     * discard.
+     */
+    commitConfirmed(ids) {
+        if (ids.length === 0)
+            return { drained: 0, tombstoned: 0 };
+        this.discardTombstonedFront();
+        const pending = this.source.peekInbox();
+        const pendingIds = new Set(pending.map((item) => item.id));
+        const firstPresent = ids.findIndex((id) => pendingIds.has(id));
+        if (firstPresent < 0) {
+            for (const id of ids)
+                this.addTombstone(id);
+            return { drained: 0, tombstoned: ids.length };
+        }
+        const remaining = ids.slice(firstPresent);
+        const missingAfterFront = remaining.find((id) => !pendingIds.has(id));
+        const actualPrefix = pending.slice(0, remaining.length).map((item) => item.id);
+        const prefixMatches = !missingAfterFront && actualPrefix.length === remaining.length && actualPrefix.every((id, i) => id === remaining[i]);
+        if (!prefixMatches) {
+            for (const id of ids)
+                this.addTombstone(id);
+            const expected = remaining.join(", ");
+            const actual = actualPrefix.join(", ");
+            return {
+                drained: 0,
+                tombstoned: ids.length,
+                error: `confirmed inbox prefix mismatch: expected [${expected}], found [${actual}]`,
+            };
+        }
+        if (remaining.length > 0)
+            this.source.drainInbox(remaining.length);
+        for (const id of ids.slice(0, firstPresent))
+            this.addTombstone(id);
+        return { drained: remaining.length, tombstoned: firstPresent };
+    }
+    hasTombstone(id) {
+        return this.tombstones.has(id) || this.previousTombstones.has(id);
+    }
+    addTombstone(id) {
+        this.tombstones.add(id);
+        if (this.tombstones.size >= TOMBSTONE_CAP) {
+            this.previousTombstones = this.tombstones;
+            this.tombstones = new Set();
+        }
+    }
+}
+//# sourceMappingURL=inbox-turn.js.map

package/dist/inbox-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-turn.js","sourceRoot":"","sources":["../src/inbox-turn.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import "./connector.js";
+export { piConnector } from "./connector.js";
+export { default as cotalMeshExtension } from "./extension.js";
+export { InboxTurn, type InboxSource } from "./inbox-turn.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import "./connector.js"; // self-registers the "pi" connector
+export { piConnector } from "./connector.js";
+export { default as cotalMeshExtension } from "./extension.js";
+export { InboxTurn } from "./inbox-turn.js"; // for SDK embedders driving their own session
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC,CAAC,oCAAoC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAoB,MAAM,iBAAiB,CAAC,CAAC,8CAA8C"}

package/dist/standalone.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./extension.js";
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}