@cotal-ai/pi 0.11.1

package/dist/driver.js

@@ -0,0 +1,347 @@
+import { randomUUID } from "node:crypto";
+import { formatInjection } from "@cotal-ai/connector-core";
+import { InboxTurn } from "./inbox-turn.js";
+const CUSTOM_TYPE = "cotal-inbox";
+const BATCH_LIMIT = 32;
+const DEFAULT_START_TIMEOUT_MS = 5_000;
+function detailsOf(message) {
+    if (!message || typeof message !== "object")
+        return undefined;
+    const value = message;
+    if (value.role !== "custom" || value.customType !== CUSTOM_TYPE || !value.details || typeof value.details !== "object")
+        return undefined;
+    const details = value.details;
+    if (details.version !== 1 || typeof details.batchId !== "string" || !Array.isArray(details.ids))
+        return undefined;
+    if (!details.ids.every((id) => typeof id === "string"))
+        return undefined;
+    return details;
+}
+function ownChannelEcho(mesh, item) {
+    return item.kind === "channel" && item.fromId === mesh.id;
+}
+function wakeable(mesh, item) {
+    if (ownChannelEcho(mesh, item))
+        return false;
+    if (item.kind !== "channel" || item.mentionsMe)
+        return true;
+    if (mesh.channelMode(item.channel) === "quiet")
+        return false;
+    return mesh.attention === "open";
+}
+/** Serialized Pi-owned delivery driver. No event callback calls the host send API outside this class. */
+export class PiDriver {
+    mesh;
+    startTimeoutMs;
+    inbox;
+    host;
+    context;
+    batches = [];
+    contextBatchIds = new Set();
+    requestBatchIds = new Set();
+    terminalEvidenceBatchIds = new Set();
+    nudges = [];
+    presence = Promise.resolve();
+    activeSignal;
+    pendingContinuation = false;
+    overflowRetry = false;
+    _state = "idle";
+    heldReason;
+    constructor(mesh, startTimeoutMs = DEFAULT_START_TIMEOUT_MS) {
+        this.mesh = mesh;
+        this.startTimeoutMs = startTimeoutMs;
+        this.inbox = new InboxTurn(mesh);
+    }
+    get state() {
+        return this._state;
+    }
+    get reason() {
+        return this.heldReason;
+    }
+    bind(host) {
+        this.host = host;
+    }
+    onSessionStart(context) {
+        this.context = context;
+        if (this._state === "shuttingDown") {
+            context.shutdown();
+            return;
+        }
+        this.pump();
+    }
+    onSessionShutdown() {
+        this.context = undefined;
+    }
+    onIncoming() {
+        this.pump();
+    }
+    onWake() {
+        this.pump();
+    }
+    onMentionWake(item) {
+        if (this._state === "shuttingDown")
+            return;
+        const who = item.fromRole ? `${item.fromName}/${item.fromRole}` : item.fromName;
+        this.nudges.push(`Cotal: you were @mentioned on #${item.channel} by ${who} while focused. ` +
+            "The body is held; read it with cotal_inbox and reply with cotal_send if warranted.");
+        if (this.nudges.length > BATCH_LIMIT)
+            this.nudges.splice(0, this.nudges.length - BATCH_LIMIT);
+        this.pump();
+    }
+    onAgentStart(context) {
+        this.context = context;
+        if (this._state === "shuttingDown") {
+            context.shutdown();
+            return;
+        }
+        this.activeSignal = context.signal;
+        this.overflowRetry = false;
+        if (this.pendingContinuation) {
+            this.pendingContinuation = false;
+            this.heldReason = undefined;
+            this._state = this.batches.some((batch) => !batch.confirmed) ? "dispatching" : "streaming";
+        }
+        else if (this._state === "held" && this.batches.length === 0) {
+            this.heldReason = undefined;
+            this._state = "streaming";
+        }
+        else if (this._state !== "held") {
+            this._state = this.batches.some((batch) => !batch.confirmed) ? "dispatching" : "streaming";
+        }
+        this.enqueuePresence("working", "thinking");
+        if (this._state !== "held")
+            this.pump(true);
+    }
+    onMessageStart(message) {
+        if (this._state === "shuttingDown")
+            return;
+        const details = detailsOf(message);
+        if (!details)
+            return;
+        const batch = this.batches.find((candidate) => candidate.id === details.batchId);
+        if (!batch || batch.ids.length !== details.ids.length || !batch.ids.every((id, i) => id === details.ids[i]))
+            return;
+        batch.started = true;
+        if (this.contextBatchIds.has(batch.id)) {
+            this.requestBatchIds.add(batch.id);
+            this.terminalEvidenceBatchIds.add(batch.id);
+        }
+        if (batch.watchdog)
+            clearTimeout(batch.watchdog);
+        batch.watchdog = undefined;
+    }
+    onContext(messages) {
+        if (this._state === "shuttingDown")
+            return;
+        const visible = new Set(messages.map(detailsOf).filter((details) => Boolean(details)).map((d) => d.batchId));
+        const candidates = this.batches.filter((batch) => !batch.confirmed && visible.has(batch.id));
+        this.contextBatchIds = new Set(candidates.map((batch) => batch.id));
+        this.requestBatchIds = new Set(candidates.filter((batch) => batch.started).map((batch) => batch.id));
+        for (const id of this.requestBatchIds)
+            this.terminalEvidenceBatchIds.add(id);
+    }
+    onProviderResponse(status) {
+        if (this._state === "shuttingDown")
+            return;
+        if (status >= 200 && status < 300) {
+            for (const id of this.requestBatchIds) {
+                const batch = this.batches.find((candidate) => candidate.id === id);
+                if (batch)
+                    batch.confirmed = true;
+            }
+        }
+        else {
+            for (const id of this.requestBatchIds)
+                this.terminalEvidenceBatchIds.delete(id);
+        }
+        this.contextBatchIds.clear();
+        this.requestBatchIds.clear();
+        if (this._state !== "held") {
+            this._state = "streaming";
+            this.pump();
+        }
+    }
+    onToolStart(name) {
+        if (this._state === "shuttingDown")
+            return;
+        this.enqueuePresence("working", `running ${name || "tool"}`);
+    }
+    onToolEnd() {
+        if (this._state === "shuttingDown")
+            return;
+        this.enqueuePresence("working", "thinking");
+    }
+    onAgentEnd(messages, context) {
+        if (this._state === "shuttingDown")
+            return;
+        const lastAssistant = [...messages]
+            .reverse()
+            .find((message) => message && typeof message === "object" && message.role === "assistant");
+        const aborted = this.activeSignal?.aborted === true;
+        this.activeSignal = undefined;
+        this.contextBatchIds.clear();
+        this.requestBatchIds.clear();
+        const terminal = !aborted &&
+            (lastAssistant?.stopReason === "stop" ||
+                lastAssistant?.stopReason === "toolUse" ||
+                (lastAssistant?.stopReason === "length" && (lastAssistant.usage?.output ?? 0) > 0));
+        if (!terminal) {
+            this.terminalEvidenceBatchIds.clear();
+            if (this.batches.length === 0) {
+                this._state = "idle";
+                this.publishIdleWhenSettled(context);
+                return;
+            }
+            this.pendingContinuation = true;
+            this.hold(aborted || lastAssistant?.stopReason === "aborted"
+                ? "Pi turn was aborted; Cotal delivery is retained until a proven clean continuation completes"
+                : `Pi turn ended with ${lastAssistant?.stopReason ?? "an unknown stop reason"}; ` +
+                    "Cotal delivery is retained until a proven clean continuation completes");
+            return;
+        }
+        for (const id of this.terminalEvidenceBatchIds) {
+            const batch = this.batches.find((candidate) => candidate.id === id);
+            if (batch)
+                batch.confirmed = true;
+        }
+        this.terminalEvidenceBatchIds.clear();
+        this.pendingContinuation = false;
+        this.finalizeEnd(context);
+    }
+    onBeforeCompact(reason, willRetry) {
+        if (this._state === "shuttingDown")
+            return;
+        if (reason !== "overflow" || !willRetry)
+            return;
+        this.overflowRetry = true;
+    }
+    requestShutdown() {
+        if (this._state === "shuttingDown")
+            return;
+        this._state = "shuttingDown";
+        this.clearTimers();
+        if (this.context)
+            this.context.shutdown();
+    }
+    async quit() {
+        this._state = "shuttingDown";
+        this.clearTimers();
+        await this.presence.catch(() => { });
+    }
+    async flushPresence() {
+        await this.presence.catch(() => { });
+    }
+    pump(force = false) {
+        if (!this.host || !this.context || this._state === "held" || this._state === "shuttingDown")
+            return;
+        if (this.batches.some((batch) => !batch.confirmed))
+            return;
+        this.inbox.discardTombstonedFront();
+        this.inbox.discardFront((item) => ownChannelEcho(this.mesh, item));
+        const reserved = new Set(this.batches.flatMap((batch) => batch.ids));
+        const available = this.inbox.peek().filter((item) => !reserved.has(item.id));
+        if (!force && this.nudges.length === 0 && !available.some((item) => wakeable(this.mesh, item))) {
+            if (this.batches.length === 0)
+                this.publishIdleWhenSettled(this.context);
+            return;
+        }
+        let ids = [];
+        let content;
+        if (this.nudges.length > 0) {
+            content = this.nudges.splice(0).join("\n");
+        }
+        else {
+            const items = this.inbox.select(reserved, (item) => ownChannelEcho(this.mesh, item), BATCH_LIMIT);
+            if (items.length === 0)
+                return;
+            ids = items.map((item) => item.id);
+            content = formatInjection(items);
+        }
+        if (!content)
+            return;
+        const batch = { id: randomUUID(), ids, content, started: false, confirmed: false };
+        this.batches.push(batch);
+        this._state = "dispatching";
+        try {
+            this.host.sendMessage({
+                customType: CUSTOM_TYPE,
+                content,
+                display: true,
+                details: { version: 1, batchId: batch.id, ids: [...ids] },
+            }, { triggerTurn: true, deliverAs: "steer" });
+            if (!batch.started) {
+                batch.watchdog = setTimeout(() => {
+                    if (!batch.started)
+                        this.hold(`Pi did not start dispatched Cotal batch ${batch.id}`);
+                }, this.startTimeoutMs);
+                batch.watchdog.unref?.();
+            }
+        }
+        catch (error) {
+            this.hold(`Pi rejected Cotal dispatch: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    finalizeEnd(context) {
+        if (this._state === "shuttingDown")
+            return;
+        if (this.overflowRetry)
+            return;
+        const confirmed = this.batches.filter((batch) => batch.confirmed);
+        const ids = confirmed.flatMap((batch) => batch.ids);
+        const committed = this.inbox.commitConfirmed(ids);
+        this.batches = this.batches.filter((batch) => !batch.confirmed);
+        if (committed.error) {
+            this.hold(committed.error);
+            return;
+        }
+        if (this.batches.length > 0) {
+            this.hold("Pi ended before confirming a queued Cotal steer");
+            return;
+        }
+        this._state = "idle";
+        this.heldReason = undefined;
+        this.pump();
+        if (this._state === "idle")
+            this.publishIdleWhenSettled(context);
+    }
+    hold(reason) {
+        if (this._state === "shuttingDown")
+            return;
+        this._state = "held";
+        this.heldReason = reason;
+        this.clearWatchdogs();
+        this.enqueuePresence("waiting", reason);
+        if (this.context?.hasUI)
+            this.context.ui.notify(`Cotal delivery held: ${reason}`, "warning");
+    }
+    publishIdleWhenSettled(context) {
+        const check = () => {
+            if (this._state !== "idle")
+                return;
+            if (this.context !== context)
+                return;
+            if (!context.isIdle()) {
+                setTimeout(check, 10).unref?.();
+                return;
+            }
+            this.enqueuePresence("idle");
+        };
+        check();
+    }
+    enqueuePresence(status, activity) {
+        this.presence = this.presence
+            .then(() => this.mesh.setStatus(status, activity))
+            .catch(() => { });
+    }
+    clearWatchdogs() {
+        for (const batch of this.batches) {
+            if (batch.watchdog)
+                clearTimeout(batch.watchdog);
+            batch.watchdog = undefined;
+        }
+    }
+    clearTimers() {
+        this.clearWatchdogs();
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/extension.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/** Load Cotal into the operator's Pi. With no mesh identity this extension is completely inert. */
+export default function cotalMesh(pi: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AA2GtF,mGAAmG;AACnG,wBAA8B,SAAS,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CvE"}

package/dist/extension.js

@@ -0,0 +1,135 @@
+import { basename, dirname } from "node:path";
+import { rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { MeshAgent, configFromEnv, hasIdentity, startControlServer, } from "@cotal-ai/connector-core";
+import { PiDriver } from "./driver.js";
+import { registerCotalTools } from "./tools.js";
+const CUSTOM_TYPE = "cotal-inbox";
+const RUNTIMES = Symbol.for("cotal.pi.runtimes");
+function runtimeMap() {
+    const root = globalThis;
+    return (root[RUNTIMES] ??= new Map());
+}
+function runtimeKey(config) {
+    return `${config.space}\0${config.id ?? config.name}`;
+}
+function asContext(context) {
+    return context;
+}
+function messageText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return String(content ?? "");
+    return content
+        .map((part) => (part && typeof part === "object" && "text" in part ? String(part.text ?? "") : ""))
+        .filter(Boolean)
+        .join("\n");
+}
+function wrapped(line) {
+    return {
+        invalidate() { },
+        render(width) {
+            const size = Math.max(16, width);
+            const out = [];
+            for (const source of line.split("\n")) {
+                let rest = source;
+                while (rest.length > size) {
+                    const whitespace = rest.lastIndexOf(" ", size);
+                    const cut = whitespace > size / 2 ? whitespace : size;
+                    out.push(rest.slice(0, cut));
+                    rest = rest.slice(cut).trimStart();
+                }
+                out.push(rest);
+            }
+            return out;
+        },
+    };
+}
+function cleanPersonaFile(runtime) {
+    if (runtime.personaCleaned)
+        return;
+    runtime.personaCleaned = true;
+    const file = process.env.COTAL_PI_PERSONA_FILE;
+    if (!file)
+        return;
+    const dir = dirname(file);
+    if (basename(file) !== "persona.md" || !basename(dir).startsWith("cotal-persona-") || dirname(dir) !== tmpdir())
+        return;
+    try {
+        rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        // A pre-start crash can leave the OS-temp file behind; normal cleanup remains best-effort.
+    }
+}
+function createRuntime(config) {
+    const path = process.env.COTAL_CONTROL_SOCKET?.trim();
+    const token = process.env.COTAL_CONTROL_TOKEN?.trim();
+    if (Boolean(path) !== Boolean(token)) {
+        throw new Error("pi connector: COTAL_CONTROL_SOCKET and COTAL_CONTROL_TOKEN must be provided together");
+    }
+    const mesh = new MeshAgent(config);
+    const driver = new PiDriver(mesh);
+    const runtime = {
+        config,
+        mesh,
+        driver,
+        personaCleaned: false,
+    };
+    mesh.on("incoming", () => driver.onIncoming());
+    mesh.on("wake", () => driver.onWake());
+    mesh.on("mention-wake", (item) => driver.onMentionWake(item));
+    mesh.start();
+    if (path && token) {
+        runtime.controlServer = startControlServer(mesh, { path, token }, async () => ({ ok: false, error: "pi uses in-process lifecycle events; only shutdown is supported" }), { fatalBind: true, onShutdown: () => driver.requestShutdown() });
+    }
+    return runtime;
+}
+/** Load Cotal into the operator's Pi. With no mesh identity this extension is completely inert. */
+export default async function cotalMesh(pi) {
+    if (!hasIdentity())
+        return;
+    if (typeof pi.sendMessage !== "function" || typeof pi.registerMessageRenderer !== "function" || typeof pi.on !== "function") {
+        throw new Error("pi connector: this Pi version lacks the required custom-message lifecycle API (requires Pi 0.79.10)");
+    }
+    const config = configFromEnv();
+    config.connector = "pi";
+    const key = runtimeKey(config);
+    const runtimes = runtimeMap();
+    let runtime = runtimes.get(key);
+    if (!runtime) {
+        runtime = createRuntime(config);
+        runtimes.set(key, runtime);
+    }
+    runtime.driver.bind(pi);
+    registerCotalTools(pi, runtime.mesh, runtime.config);
+    pi.registerMessageRenderer(CUSTOM_TYPE, (message) => wrapped(messageText(message.content)));
+    pi.on("session_start", (_event, context) => {
+        cleanPersonaFile(runtime);
+        runtime.driver.onSessionStart(asContext(context));
+    });
+    pi.on("agent_start", (_event, context) => runtime.driver.onAgentStart(asContext(context)));
+    pi.on("message_start", (event) => runtime.driver.onMessageStart(event.message));
+    pi.on("context", (event) => runtime.driver.onContext(event.messages));
+    pi.on("after_provider_response", (event) => runtime.driver.onProviderResponse(event.status));
+    pi.on("tool_execution_start", (event) => runtime.driver.onToolStart(event.toolName));
+    pi.on("tool_execution_end", () => runtime.driver.onToolEnd());
+    pi.on("session_before_compact", (event) => runtime.driver.onBeforeCompact(event.reason, event.willRetry));
+    pi.on("agent_end", (event, context) => runtime.driver.onAgentEnd(event.messages, asContext(context)));
+    pi.on("session_shutdown", async (event) => {
+        runtime.driver.onSessionShutdown();
+        if (event.reason !== "quit")
+            return;
+        await runtime.driver.quit();
+        try {
+            runtime.controlServer?.close();
+        }
+        catch {
+            // The server may already be closing after the manager's shutdown request.
+        }
+        await runtime.mesh.stop().catch(() => { });
+        runtimes.delete(key);
+    });
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/inbox-turn.d.ts

@@ -0,0 +1,43 @@
+import type { InboxItem } from "@cotal-ai/connector-core";
+export interface InboxSource {
+    peekInbox(): InboxItem[];
+    drainInbox(limit?: number): InboxItem[];
+}
+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.
+ */
+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.
+     */
+    commitConfirmed(ids: readonly string[]): CommitResult;
+    private hasTombstone;
+    private addTombstone;
+}
+//# sourceMappingURL=inbox-turn.d.ts.map

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

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