@keel_flow/pi-gateway 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/fake-pi.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter } from "node:events";
+import { PassThrough } from "node:stream";
+import type { spawn } from "node:child_process";
+export interface FakePiChild extends EventEmitter {
+    stdin: PassThrough;
+    stdout: PassThrough;
+    stderr: PassThrough;
+    killed: boolean;
+    kill(signal?: string): boolean;
+}
+export interface FakePiScript {
+    onCommand(command: Record<string, unknown>, child: FakePiChild): void;
+}
+export interface RecordedSpawnCall {
+    command: string;
+    args: string[];
+    options: {
+        env?: NodeJS.ProcessEnv;
+        cwd?: string;
+    };
+}
+export declare function createFakeSpawn(script: FakePiScript): {
+    spawnFn: typeof spawn;
+    children: FakePiChild[];
+    calls: RecordedSpawnCall[];
+};
+export declare function emit(child: FakePiChild, message: Record<string, unknown>): void;
+//# sourceMappingURL=fake-pi.d.ts.map

package/dist/fake-pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-pi.d.ts","sourceRoot":"","sources":["../src/fake-pi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CACvE;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG;IACrD,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAuCA;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE/E"}

package/dist/fake-pi.js

@@ -0,0 +1,43 @@
+import { EventEmitter } from "node:events";
+import { PassThrough } from "node:stream";
+export function createFakeSpawn(script) {
+    const calls = [];
+    const children = [];
+    const spawnFn = ((...spawnArgs) => {
+        calls.push({
+            command: spawnArgs[0],
+            args: spawnArgs[1] ?? [],
+            options: spawnArgs[2] ?? {},
+        });
+        const child = new EventEmitter();
+        child.stdin = new PassThrough();
+        child.stdout = new PassThrough();
+        child.stderr = new PassThrough();
+        child.killed = false;
+        child.kill = (signal) => {
+            child.killed = true;
+            queueMicrotask(() => child.emit("exit", 0, signal ?? null));
+            return true;
+        };
+        let buffer = "";
+        child.stdin.on("data", (chunk) => {
+            buffer += chunk.toString("utf8");
+            let index = buffer.indexOf("\n");
+            while (index !== -1) {
+                const line = buffer.slice(0, index);
+                buffer = buffer.slice(index + 1);
+                if (line.trim().length > 0) {
+                    script.onCommand(JSON.parse(line), child);
+                }
+                index = buffer.indexOf("\n");
+            }
+        });
+        children.push(child);
+        return child;
+    });
+    return { spawnFn, children, calls };
+}
+export function emit(child, message) {
+    child.stdout.write(`${JSON.stringify(message)}\n`);
+}
+//# sourceMappingURL=fake-pi.js.map

package/dist/fake-pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-pi.js","sourceRoot":"","sources":["../src/fake-pi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqB1C,MAAM,UAAU,eAAe,CAAC,MAAoB;IAKlD,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,SAAoB,EAAE,EAAE;QAC3C,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,CAAC,CAAW;YAC/B,IAAI,EAAG,SAAS,CAAC,CAAC,CAAc,IAAI,EAAE;YACtC,OAAO,EAAG,SAAS,CAAC,CAAC,CAAkC,IAAI,EAAE;SAC9D,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,YAAY,EAAiB,CAAC;QAChD,KAAK,CAAC,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,KAAK,CAAC,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,KAAK,CAAC,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,KAAK,CAAC,IAAI,GAAG,CAAC,MAAe,EAAE,EAAE;YAC/B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACpB,cAAc,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACpC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,EAAE,KAAK,CAAC,CAAC;gBACvE,CAAC;gBACD,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC,CAA4B,CAAC;IAE9B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAkB,EAAE,OAAgC;IACvE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/gateway.d.ts

@@ -0,0 +1,42 @@
+import type { spawn } from "node:child_process";
+export interface PromptHandlers {
+    onDelta?(text: string): void;
+    onToolStart?(toolName: string, args: Record<string, unknown> | undefined): void;
+    onToolEnd?(toolName: string, isError: boolean): void;
+}
+export interface PromptOpts {
+    cwd?: string | undefined;
+}
+export interface PromptResult {
+    text: string;
+}
+export interface PiGatewayOptions {
+    bin?: string | undefined;
+    cwd?: string | undefined;
+    sessionDir?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    appendSystemPrompt?: string | undefined;
+    instructions?: string | undefined;
+    idleMs?: number | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+    spawnFn?: typeof spawn | undefined;
+}
+export declare class ConversationBusyError extends Error {
+    constructor(conversationId: string);
+}
+export declare class PiGateway {
+    private readonly conversations;
+    private readonly opts;
+    constructor(opts?: PiGatewayOptions);
+    activeConversations(): string[];
+    conversationCwd(conversationId: string): string | undefined;
+    prompt(conversationId: string, message: string, handlers?: PromptHandlers, opts?: PromptOpts): Promise<PromptResult>;
+    stop(conversationId: string): void;
+    stopAll(): void;
+    private ensure;
+    private runPrompt;
+    private armIdleTimer;
+    private clearIdleTimer;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAUhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAChF,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CACpC;AAYD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,cAAc,EAAE,MAAM;CAGnC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;gBAE5B,IAAI,GAAE,gBAAqB;IAIvC,mBAAmB,IAAI,MAAM,EAAE;IAI/B,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD,MAAM,CACV,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,cAAmB,EAC7B,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,YAAY,CAAC;IAuBxB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAQlC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,MAAM;IAoCd,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/gateway.js

@@ -0,0 +1,204 @@
+import { PiProcess, PiProcessError, } from "./rpc.js";
+const DEFAULT_IDLE_MS = 10 * 60 * 1000;
+export class ConversationBusyError extends Error {
+    constructor(conversationId) {
+        super(`conversation ${conversationId} is already streaming`);
+    }
+}
+export class PiGateway {
+    conversations = new Map();
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    activeConversations() {
+        return [...this.conversations.keys()];
+    }
+    conversationCwd(conversationId) {
+        return this.conversations.get(conversationId)?.cwd;
+    }
+    async prompt(conversationId, message, handlers = {}, opts = {}) {
+        const entry = this.ensure(conversationId, opts.cwd);
+        if (entry.busy)
+            throw new ConversationBusyError(conversationId);
+        entry.busy = true;
+        this.clearIdleTimer(entry);
+        const outgoing = !entry.primed && this.opts.instructions
+            ? `<workspace-instructions>\n${this.opts.instructions}\n</workspace-instructions>\n\n${message}`
+            : message;
+        entry.primed = true;
+        try {
+            return await this.runPrompt(entry.process, outgoing, handlers);
+        }
+        finally {
+            entry.busy = false;
+            if (this.conversations.get(conversationId) === entry) {
+                if (entry.process.alive)
+                    this.armIdleTimer(conversationId, entry);
+                else
+                    this.conversations.delete(conversationId);
+            }
+        }
+    }
+    stop(conversationId) {
+        const entry = this.conversations.get(conversationId);
+        if (!entry)
+            return;
+        this.clearIdleTimer(entry);
+        entry.process.dispose();
+        this.conversations.delete(conversationId);
+    }
+    stopAll() {
+        for (const conversationId of [...this.conversations.keys()])
+            this.stop(conversationId);
+    }
+    ensure(conversationId, requestedCwd) {
+        const existing = this.conversations.get(conversationId);
+        if (existing?.process.alive)
+            return existing;
+        const cwd = requestedCwd ?? existing?.cwd ?? this.opts.cwd;
+        if (existing)
+            this.conversations.delete(conversationId);
+        const childEnv = { ...(this.opts.env ?? process.env) };
+        if (this.opts.provider === "claude-bridge") {
+            delete childEnv["ANTHROPIC_API_KEY"];
+        }
+        const piProcess = new PiProcess({
+            bin: this.opts.bin,
+            cwd,
+            sessionId: conversationId,
+            sessionDir: this.opts.sessionDir,
+            sessionName: `keel-chat-${conversationId.slice(0, 8)}`,
+            provider: this.opts.provider,
+            model: this.opts.model,
+            appendSystemPrompt: this.opts.appendSystemPrompt,
+            env: childEnv,
+            spawnFn: this.opts.spawnFn,
+        });
+        piProcess.onEvent((event) => {
+            if (event.type === "extension_ui_request") {
+                const request = event;
+                if (["select", "confirm", "input", "editor"].includes(request.method)) {
+                    piProcess.respondToUi(request.id, { cancelled: true });
+                }
+            }
+        });
+        const entry = { process: piProcess, busy: false, idleTimer: null, cwd, primed: false };
+        this.conversations.set(conversationId, entry);
+        return entry;
+    }
+    runPrompt(piProcess, message, handlers) {
+        return new Promise((resolve, reject) => {
+            let text = "";
+            const unsubscribe = piProcess.onEvent((event) => {
+                if (process.env["KEEL_PI_DEBUG"]) {
+                    process.stderr.write(`[pi event] ${JSON.stringify(event).slice(0, 300)}\n`);
+                }
+                if (event.type === "message_update") {
+                    const update = event;
+                    if (update.assistantMessageEvent.type === "text_delta" && update.assistantMessageEvent.delta) {
+                        text += update.assistantMessageEvent.delta;
+                        handlers.onDelta?.(update.assistantMessageEvent.delta);
+                    }
+                    return;
+                }
+                if (event.type === "tool_execution_start") {
+                    const tool = event;
+                    handlers.onToolStart?.(tool.toolName, tool.args);
+                    return;
+                }
+                if (event.type === "tool_execution_end") {
+                    const tool = event;
+                    handlers.onToolEnd?.(tool.toolName, tool.isError ?? false);
+                    return;
+                }
+                if (event.type === "agent_end") {
+                    const end = event;
+                    unsubscribe();
+                    const failure = extractTurnError(end.messages);
+                    if (failure !== null && text.length === 0) {
+                        reject(new PiProcessError(failure));
+                        return;
+                    }
+                    resolve({ text: text.length > 0 ? text : extractLastAssistantText(end.messages) });
+                    return;
+                }
+                if (event.type === "process_exit" || event.type === "process_error") {
+                    unsubscribe();
+                    reject(new PiProcessError("pi process terminated mid-prompt"));
+                }
+            });
+            piProcess
+                .request({ type: "prompt", message })
+                .then((response) => {
+                if (!response.success) {
+                    unsubscribe();
+                    reject(new PiProcessError(response.error ?? "prompt rejected"));
+                }
+            })
+                .catch((err) => {
+                unsubscribe();
+                reject(err);
+            });
+        });
+    }
+    armIdleTimer(conversationId, entry) {
+        const idleMs = this.opts.idleMs ?? DEFAULT_IDLE_MS;
+        entry.idleTimer = setTimeout(() => {
+            if (!entry.busy)
+                this.stop(conversationId);
+        }, idleMs);
+        entry.idleTimer.unref?.();
+    }
+    clearIdleTimer(entry) {
+        if (entry.idleTimer) {
+            clearTimeout(entry.idleTimer);
+            entry.idleTimer = null;
+        }
+    }
+}
+function extractTurnError(messages) {
+    for (let i = messages.length - 1; i >= 0; i -= 1) {
+        const message = messages[i];
+        if (typeof message !== "object" || message === null)
+            continue;
+        const record = message;
+        if (record["role"] !== "assistant")
+            continue;
+        if (record["stopReason"] !== "error" && record["stopReason"] !== "aborted")
+            return null;
+        const errorMessage = record["errorMessage"];
+        return typeof errorMessage === "string" && errorMessage.length > 0
+            ? errorMessage
+            : `agent turn failed (${String(record["stopReason"])})`;
+    }
+    return null;
+}
+function extractLastAssistantText(messages) {
+    for (let i = messages.length - 1; i >= 0; i -= 1) {
+        const message = messages[i];
+        if (typeof message !== "object" || message === null)
+            continue;
+        const record = message;
+        if (record["role"] !== "assistant")
+            continue;
+        const content = record["content"];
+        if (typeof content === "string")
+            return content;
+        if (!Array.isArray(content))
+            continue;
+        const parts = [];
+        for (const block of content) {
+            if (typeof block === "object" && block !== null) {
+                const blockRecord = block;
+                if (blockRecord["type"] === "text" && typeof blockRecord["text"] === "string") {
+                    parts.push(blockRecord["text"]);
+                }
+            }
+        }
+        if (parts.length > 0)
+            return parts.join("");
+    }
+    return "";
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,cAAc,GAKf,MAAM,UAAU,CAAC;AA6BlB,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAUvC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,cAAsB;QAChC,KAAK,CAAC,gBAAgB,cAAc,uBAAuB,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACH,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,IAAI,CAAmB;IAExC,YAAY,OAAyB,EAAE;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,eAAe,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,cAAsB,EACtB,OAAe,EACf,WAA2B,EAAE,EAC7B,OAAmB,EAAE;QAErB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,MAAM,QAAQ,GACZ,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY;YACrC,CAAC,CAAC,6BAA6B,IAAI,CAAC,IAAI,CAAC,YAAY,kCAAkC,OAAO,EAAE;YAChG,CAAC,CAAC,OAAO,CAAC;QACd,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC;YACnB,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,KAAK,EAAE,CAAC;gBACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK;oBAAE,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;;oBAC7D,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,cAAsB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,KAAK,MAAM,cAAc,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzF,CAAC;IAEO,MAAM,CAAC,cAAsB,EAAE,YAAqB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxD,IAAI,QAAQ,EAAE,OAAO,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC;QAC7C,MAAM,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3D,IAAI,QAAQ;YAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,QAAQ,GAAsB,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YAC3C,OAAO,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;YAClB,GAAG;YACH,SAAS,EAAE,cAAc;YACzB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,WAAW,EAAE,aAAa,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACtD,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YAC5B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB;YAChD,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;SAC3B,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,MAAM,OAAO,GAAG,KAAuC,CAAC;gBACxD,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtE,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAsB,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC1G,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,SAAS,CACf,SAAoB,EACpB,OAAe,EACf,QAAwB;QAExB,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,KAAiB,EAAE,EAAE;gBAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;oBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC9E,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBACpC,MAAM,MAAM,GAAG,KAA6B,CAAC;oBAC7C,IAAI,MAAM,CAAC,qBAAqB,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,CAAC;wBAC7F,IAAI,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC;wBAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;oBACzD,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,KAA6B,CAAC;oBAC3C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjD,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,KAA6B,CAAC;oBAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;oBAC3D,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC/B,MAAM,GAAG,GAAG,KAAwB,CAAC;oBACrC,WAAW,EAAE,CAAC;oBACd,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC/C,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC1C,MAAM,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;wBACpC,OAAO;oBACT,CAAC;oBACD,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACnF,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBACpE,WAAW,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,cAAc,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,SAAS;iBACN,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;iBACpC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACjB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACtB,WAAW,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;gBACpB,WAAW,EAAE,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,cAAsB,EAAE,KAAwB;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;QACnD,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAC5B,CAAC;IAEO,cAAc,CAAC,KAAwB;QAC7C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC9B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,QAAmB;IAC3C,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAC9D,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW;YAAE,SAAS;QAC7C,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,OAAO,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACxF,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAChE,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,sBAAsB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAmB;IACnD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAC9D,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW;YAAE,SAAS;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,WAAW,GAAG,KAAgC,CAAC;gBACrD,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC9E,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createJsonlSplitter } from "./jsonl.js";
+export type { JsonlSplitter } from "./jsonl.js";
+export { PiProcess, PiProcessError } from "./rpc.js";
+export type { PiProcessOptions, PiRpcResponse, PiRpcEvent, PiMessageUpdateEvent, PiToolExecutionEvent, PiAgentEndEvent, PiExtensionUiRequest, PiEventListener, } from "./rpc.js";
+export { PiGateway, ConversationBusyError } from "./gateway.js";
+export type { PiGatewayOptions, PromptHandlers, PromptResult, } from "./gateway.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,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createJsonlSplitter } from "./jsonl.js";
+export { PiProcess, PiProcessError } from "./rpc.js";
+export { PiGateway, ConversationBusyError } from "./gateway.js";
+//# 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,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAYrD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/jsonl.d.ts

@@ -0,0 +1,6 @@
+export interface JsonlSplitter {
+    push(chunk: Buffer | string): void;
+    flush(): void;
+}
+export declare function createJsonlSplitter(onLine: (line: string) => void): JsonlSplitter;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../src/jsonl.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,aAAa,CAyBjF"}

package/dist/jsonl.js

@@ -0,0 +1,28 @@
+import { StringDecoder } from "node:string_decoder";
+export function createJsonlSplitter(onLine) {
+    const decoder = new StringDecoder("utf8");
+    let buffer = "";
+    const emit = (line) => {
+        const clean = line.endsWith("\r") ? line.slice(0, -1) : line;
+        if (clean.length > 0)
+            onLine(clean);
+    };
+    return {
+        push(chunk) {
+            buffer += typeof chunk === "string" ? chunk : decoder.write(chunk);
+            let newlineIndex = buffer.indexOf("\n");
+            while (newlineIndex !== -1) {
+                emit(buffer.slice(0, newlineIndex));
+                buffer = buffer.slice(newlineIndex + 1);
+                newlineIndex = buffer.indexOf("\n");
+            }
+        },
+        flush() {
+            buffer += decoder.end();
+            if (buffer.length > 0)
+                emit(buffer);
+            buffer = "";
+        },
+    };
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../src/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD,MAAM,UAAU,mBAAmB,CAAC,MAA8B;IAChE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;gBACpC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBACxC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,KAAK;YACH,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,76 @@
+import { spawn } from "node:child_process";
+export interface PiRpcResponse {
+    type: "response";
+    command: string;
+    success: boolean;
+    id?: string;
+    error?: string;
+    data?: unknown;
+}
+export interface PiTextDelta {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+}
+export interface PiMessageUpdateEvent {
+    type: "message_update";
+    message: unknown;
+    assistantMessageEvent: {
+        type: string;
+        delta?: string;
+        contentIndex?: number;
+    };
+}
+export interface PiToolExecutionEvent {
+    type: "tool_execution_start" | "tool_execution_end";
+    toolCallId: string;
+    toolName: string;
+    args?: Record<string, unknown>;
+    isError?: boolean;
+}
+export interface PiAgentEndEvent {
+    type: "agent_end";
+    messages: unknown[];
+}
+export interface PiExtensionUiRequest {
+    type: "extension_ui_request";
+    id: string;
+    method: string;
+}
+export type PiRpcEvent = PiMessageUpdateEvent | PiToolExecutionEvent | PiAgentEndEvent | PiExtensionUiRequest | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface PiProcessOptions {
+    bin?: string | undefined;
+    cwd?: string | undefined;
+    sessionId?: string | undefined;
+    sessionDir?: string | undefined;
+    sessionName?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    appendSystemPrompt?: string | undefined;
+    extraArgs?: string[] | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+    spawnFn?: typeof spawn | undefined;
+}
+export type PiEventListener = (event: PiRpcEvent) => void;
+export declare class PiProcessError extends Error {
+}
+export declare class PiProcess {
+    private readonly child;
+    private readonly pending;
+    private readonly listeners;
+    private exited;
+    private exitError;
+    constructor(opts?: PiProcessOptions);
+    get alive(): boolean;
+    onEvent(listener: PiEventListener): () => void;
+    send(command: Record<string, unknown>): void;
+    request(command: Record<string, unknown>): Promise<PiRpcResponse>;
+    respondToUi(requestId: string, body: Record<string, unknown>): void;
+    dispose(): void;
+    private handleLine;
+    private emit;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

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

package/dist/rpc.js

@@ -0,0 +1,114 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { createJsonlSplitter } from "./jsonl.js";
+export class PiProcessError extends Error {
+}
+export class PiProcess {
+    child;
+    pending = new Map();
+    listeners = new Set();
+    exited = false;
+    exitError = null;
+    constructor(opts = {}) {
+        const args = ["--mode", "rpc"];
+        if (opts.sessionId)
+            args.push("--session-id", opts.sessionId);
+        if (opts.sessionDir)
+            args.push("--session-dir", opts.sessionDir);
+        if (opts.sessionName)
+            args.push("--name", opts.sessionName);
+        if (opts.provider)
+            args.push("--provider", opts.provider);
+        if (opts.model)
+            args.push("--model", opts.model);
+        if (opts.appendSystemPrompt)
+            args.push("--append-system-prompt", opts.appendSystemPrompt);
+        if (opts.extraArgs)
+            args.push(...opts.extraArgs);
+        const spawnFn = opts.spawnFn ?? spawn;
+        this.child = spawnFn(opts.bin ?? "pi", args, {
+            cwd: opts.cwd,
+            env: opts.env ?? process.env,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const splitter = createJsonlSplitter((line) => this.handleLine(line));
+        this.child.stdout.on("data", (chunk) => splitter.push(chunk));
+        this.child.stdout.on("end", () => splitter.flush());
+        this.child.stderr.on("data", (chunk) => {
+            process.stderr.write(`[pi stderr] ${chunk.toString("utf8")}`);
+        });
+        this.child.on("exit", (code, signal) => {
+            this.exited = true;
+            this.exitError = new PiProcessError(`pi exited (code=${code ?? "null"}, signal=${signal ?? "null"})`);
+            for (const pending of this.pending.values())
+                pending.reject(this.exitError);
+            this.pending.clear();
+            this.emit({ type: "process_exit", code, signal });
+        });
+        this.child.on("error", (err) => {
+            this.exited = true;
+            this.exitError = err;
+            for (const pending of this.pending.values())
+                pending.reject(err);
+            this.pending.clear();
+            this.emit({ type: "process_error", error: err.message });
+        });
+    }
+    get alive() {
+        return !this.exited;
+    }
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    send(command) {
+        if (this.exited)
+            throw this.exitError ?? new PiProcessError("pi process has exited");
+        this.child.stdin.write(`${JSON.stringify(command)}\n`);
+    }
+    async request(command) {
+        const id = randomUUID();
+        const response = new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+        });
+        this.send({ ...command, id });
+        return response;
+    }
+    respondToUi(requestId, body) {
+        this.send({ type: "extension_ui_response", id: requestId, ...body });
+    }
+    dispose() {
+        if (this.exited)
+            return;
+        this.child.stdin.end();
+        this.child.kill("SIGTERM");
+    }
+    handleLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (typeof parsed !== "object" || parsed === null)
+            return;
+        const message = parsed;
+        if (message["type"] === "response" && typeof message["id"] === "string") {
+            const pending = this.pending.get(message["id"]);
+            if (pending) {
+                this.pending.delete(message["id"]);
+                pending.resolve(message);
+                return;
+            }
+        }
+        if (message["type"] === "response")
+            return;
+        this.emit(message);
+    }
+    emit(event) {
+        for (const listener of this.listeners)
+            listener(event);
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,3 @@
+export { createFakeSpawn, emit } from "./fake-pi.js";
+export type { FakePiChild, FakePiScript, RecordedSpawnCall } from "./fake-pi.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/testing.js

@@ -0,0 +1,2 @@
+export { createFakeSpawn, emit } from "./fake-pi.js";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@keel_flow/pi-gateway",
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.js",
+      "types": "./dist/testing.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}