@cotal-ai/pi 0.11.3 → 0.11.5

package/README.md

@@ -38,8 +38,8 @@ Inbound traffic is injected as a `cotal-inbox` custom message. Its opaque batch
 in Pi's `message_start` and in the exact provider `context`. A successful `after_provider_response`
 confirms the batch early when the transport exposes an HTTP response; transports such as the Codex
 subscription may omit that hook, so an exact context is confirmed instead by its following clean
-terminal boundary. Acknowledgement waits for that boundary and drains only an exact current inbox
-prefix.
+  terminal boundary. Acknowledgement waits for that boundary and drains only the confirmed IDs,
+  even when pull-only quiet traffic is interleaved ahead of them.
 
 - Crash or quit before a terminal boundary: acknowledge nothing; durable traffic redelivers.
 - Non-aborted `stop`, `toolUse`, and non-overflow `length` (positive output) are terminal and may
@@ -55,6 +55,9 @@ is attributed context rather than a human prompt. Provider hooks, tool hooks, an
 permission/sandbox extensions still run. Replies remain deliberate model actions through
 `cotal_dm`, `cotal_send`, or `cotal_anycast`; chat output alone is not sent to peers.
 
+Quiet-channel ambient is never included in automatic or continuation batches. It remains buffered
+until `cotal_inbox` explicitly surfaces and clears it; quiet `@mention`s remain automatic.
+
 Pi resume, model variants, MCP sharing, and raw launch options are not implemented and fail loudly.
 Persona files and `--model` are supported; an explicit spawn model wins over the persona file.
 

package/dist/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAQrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE;QAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,CACT,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,iBAAiB,CAAA;KAAE,EAC9F,OAAO,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GACjD,IAAI,CAAC;CACT;AAiCD,yGAAyG;AACzG,qBAAa,QAAQ;IAiBjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAjBjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,wBAAwB,CAAqB;IACrD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;gBAGT,IAAI,EAAE,SAAS,EACf,cAAc,SAA2B;IAK5D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAS5C,iBAAiB,IAAI,IAAI;IAIzB,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,IAAI;IAId,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAWpC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAsB1C,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAetC,SAAS,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAS7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,IAAI;IAKjB,UAAU,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IA2CtE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAMzD,eAAe,IAAI,IAAI;IAOjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,OAAO,CAAC,IAAI;IAiDZ,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;CAGpB"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAQrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,cAAc,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE;QAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,CACT,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,iBAAiB,CAAA;KAAE,EAC9F,OAAO,EAAE;QAAE,WAAW,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GACjD,IAAI,CAAC;CACT;AAgCD,yGAAyG;AACzG,qBAAa,QAAQ;IAiBjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAjBjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,wBAAwB,CAAqB;IACrD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;gBAGT,IAAI,EAAE,SAAS,EACf,cAAc,SAA2B;IAK5D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAS5C,iBAAiB,IAAI,IAAI;IAIzB,UAAU,IAAI,IAAI;IAIlB,MAAM,IAAI,IAAI;IAId,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAWpC,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAsB1C,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAetC,SAAS,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAS7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,SAAS,IAAI,IAAI;IAKjB,UAAU,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IA2CtE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAMzD,eAAe,IAAI,IAAI;IAOjB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,OAAO,CAAC,IAAI;IAiDZ,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/inbox-turn.d.ts

@@ -1,41 +1,31 @@
-import type { InboxItem } from "@cotal-ai/connector-core";
+import type { ExactDrainResult, InboxItem, InboxScope } from "./inbox-types.js";
 export interface InboxSource {
-    peekInbox(): InboxItem[];
+    peekInbox(scope?: InboxScope): InboxItem[];
     drainInbox(limit?: number): InboxItem[];
+    drainInboxIds(ids: readonly string[]): ExactDrainResult;
 }
 export interface CommitResult {
     drained: number;
     tombstoned: number;
-    error?: string;
 }
 /**
- * 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.
+ * Pi-local acknowledgement ledger over MeshAgent's exact-id drain API. Provider-confirmed items
+ * can be committed around interleaved pull-only traffic without positional acknowledgement;
+ * overflow-missing ids are tombstoned for exact late-duplicate discard.
  */
 export declare class InboxTurn {
     private readonly source;
     private tombstones;
     private previousTombstones;
     constructor(source: InboxSource);
-    peek(): InboxItem[];
-    /** Remove already-confirmed late duplicates from the front, one exact item at a time. */
-    discardTombstonedFront(): number;
-    /** Prefix-only discard for adapter-local traffic such as own channel echoes. */
-    discardFront(match: (item: InboxItem) => boolean): number;
-    /**
-     * 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: ReadonlySet<string>, boundary: (item: InboxItem) => boolean, limit: number): InboxItem[];
-    /**
-     * 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.
-     */
+    peek(scope?: InboxScope): InboxItem[];
+    /** Remove already-confirmed late duplicates by exact id, even behind pull-only traffic. */
+    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(reserved: ReadonlySet<string>, limit: number): InboxItem[];
+    /** Commit provider-confirmed ids exactly; tombstone any already absent after overflow. */
     commitConfirmed(ids: readonly string[]): CommitResult;
     private hasTombstone;
     private addTombstone;

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,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,SAAS,IAAI,SAAS,EAAE,CAAC;IACzB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;GAOG;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,IAAI,SAAS,EAAE;IAInB,yFAAyF;IACzF,sBAAsB,IAAI,MAAM;IAUhC,gFAAgF;IAChF,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM;IAUzD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAWzG;;;;OAIG;IACH,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY;IAmCrD,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,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"}

package/dist/inbox-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pi's PUBLIC inbox type surface (the SDK-embedder exports on the `.` entry). These describe the
+ * shape of what `MeshAgent`'s inbox API returns — which pi bundles at runtime — but pi must not leak
+ * `@cotal-ai/connector-core` (a build-only dep, absent from an installed plugin) into its shipped
+ * `.d.ts`, so it OWNS the public contract here instead of re-exporting connector-core's types.
+ *
+ * The drift guard at the bottom proves these stay structurally identical to connector-core's, at
+ * pi's build (where connector-core IS resolvable, as a devDep); a skew is a loud typecheck error,
+ * never a silent one. It is referenced by no exported symbol, so it is elided from the shipped
+ * declarations and erased from the bundle.
+ */
+export type InboxScope = "all" | "automatic" | "pull-only";
+export interface InboxItem {
+    id: string;
+    ts: number;
+    fromId: string;
+    fromName: string;
+    fromRole?: string;
+    kind: "channel" | "dm" | "anycast";
+    /** Set when kind === "channel". */
+    channel?: string;
+    /** Set when kind === "anycast" (the role addressed). */
+    service?: string;
+    /** Lowercased names called out on a channel message (priority hint). */
+    mentions?: string[];
+    /** True iff this message mentions us by name. */
+    mentionsMe: boolean;
+    /** True iff this is backfilled history (a "catching up" block on join), not a live message. */
+    historical: boolean;
+    text: string;
+    replyTo?: string;
+    contextId?: string;
+}
+/** An exact-id drain: the items found plus the ids that were not present. */
+export interface ExactDrainResult {
+    items: InboxItem[];
+    missingIds: string[];
+}
+//# sourceMappingURL=inbox-types.d.ts.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAC9D,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}