pi-courier 0.1.0

package/dist/rpc/pi-rpc.d.ts

@@ -0,0 +1,79 @@
+import { type ModelInfo, type RpcEventListener, type RpcSessionState } from "@earendil-works/pi-coding-agent";
+export interface PiRpcOptions {
+    /** Absolute path to pi's dist/cli.js (default: PI_CLI_PATH env, local node_modules, or `which pi` resolved) */
+    cliPath?: string;
+    /** Working directory for the agent (affects bash tool, project context) */
+    cwd?: string;
+    /** Extra CLI args, e.g. ["--session-dir", "/path"] */
+    args?: string[];
+}
+/** Minimal shape of a slash command returned by get_commands (duck-typed, not exported by the package) */
+export interface RpcSlashCommandInfo {
+    name: string;
+    description?: string;
+    source: "extension" | "prompt" | "skill";
+    location?: string;
+    path?: string;
+}
+export declare class PiRpc {
+    private client?;
+    private commandsCache?;
+    private options;
+    /** Listeners registered before start() — attached once the client connects */
+    private listeners;
+    constructor(options?: PiRpcOptions);
+    get isConnected(): boolean;
+    /** Locate the pi CLI entry point. */
+    static resolveCliPath(): Promise<string>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Restart the pi process. Keeps registered event listeners attached to the
+     * new process. The session persists on disk, so the same session is resumed.
+     * Useful after installing new extensions/skills or changing provider config.
+     */
+    restart(): Promise<void>;
+    /**
+     * Send a user prompt. If the agent is streaming, the RPC server rejects a
+     * plain prompt — retry as a steering message (queued, delivered after the
+     * current tool calls finish).
+     */
+    prompt(text: string): Promise<void>;
+    /** Subscribe to agent events. Safe to call before start(). Returns an unsubscribe function. */
+    onEvent(listener: RpcEventListener): () => void;
+    newSession(): Promise<{
+        cancelled: boolean;
+    }>;
+    compact(customInstructions?: string): Promise<{
+        summary: string;
+        tokensBefore: number;
+    }>;
+    abort(): Promise<void>;
+    getState(): Promise<RpcSessionState>;
+    getAvailableModels(): Promise<ModelInfo[]>;
+    setModel(provider: string, modelId: string): Promise<unknown>;
+    setThinkingLevel(level: string): Promise<void>;
+    setSessionName(name: string): Promise<void>;
+    getSessionStats(): Promise<{
+        sessionId: string;
+        totalMessages: number;
+        cost: number;
+        tokens: {
+            total: number;
+        };
+    }>;
+    exportHtml(outputPath?: string): Promise<{
+        path: string;
+    }>;
+    bash(command: string): Promise<{
+        output: string;
+        exitCode: number | undefined;
+    }>;
+    switchSession(sessionPath: string): Promise<{
+        cancelled: boolean;
+    }>;
+    /** Get available commands (extension commands, prompt templates, skills) with a short cache. */
+    getCommands(): Promise<RpcSlashCommandInfo[]>;
+    private requireClient;
+}
+//# sourceMappingURL=pi-rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi-rpc.d.ts","sourceRoot":"","sources":["../../src/rpc/pi-rpc.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0GAA0G;AAC1G,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,aAAa,CAAC,CAA8C;IACpE,OAAO,CAAC,OAAO,CAAe;IAC9B,8EAA8E;IAC9E,OAAO,CAAC,SAAS,CAA2C;gBAEhD,OAAO,GAAE,YAAiB;IAItC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,qCAAqC;WACxB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazC,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAgBzC,UAAU,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAI7C,OAAO,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAIxF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpC,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,eAAe,IAAI,OAAO,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC;IAII,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1D,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAIhF,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAIzE,gGAAgG;IAC1F,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAYnD,OAAO,CAAC,aAAa;CAItB"}

package/dist/rpc/pi-rpc.js

@@ -0,0 +1,199 @@
+/**
+ * PiRpc — thin wrapper around the official RpcClient from @earendil-works/pi-coding-agent.
+ *
+ * Responsibilities:
+ *  - Locate the pi CLI (config/env/PATH) and spawn it in --mode rpc
+ *  - Retry startup handshake (cold start can take a moment)
+ *  - Provide typed convenience methods used by the command map
+ *  - Cache get_commands results briefly
+ *  - Fall back to steer() when a prompt arrives while the agent is streaming
+ */
+import { execFileSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { RpcClient, } from "@earendil-works/pi-coding-agent";
+export class PiRpc {
+    client;
+    commandsCache;
+    options;
+    /** Listeners registered before start() — attached once the client connects */
+    listeners = [];
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get isConnected() {
+        return this.client !== undefined;
+    }
+    /** Locate the pi CLI entry point. */
+    static async resolveCliPath() {
+        // 1. Explicit env override
+        if (process.env.PI_CLI_PATH)
+            return process.env.PI_CLI_PATH;
+        // 2. System-installed pi (`which pi`, resolve symlink to dist/cli.js).
+        //    Preferred: pi is installed independently and upgraded on its own.
+        try {
+            const bin = execFileSync("which", ["pi"], { encoding: "utf-8" }).trim();
+            if (bin) {
+                return fs.realpathSync(bin);
+            }
+        }
+        catch {
+            // fall through
+        }
+        // 3. Local node_modules copy (dev setup / peer auto-install). The package
+        //    exports block subpath resolution, so resolve the entry and derive
+        //    dist/cli.js from its directory.
+        try {
+            const entryUrl = import.meta.resolve("@earendil-works/pi-coding-agent");
+            const entry = fileURLToPath(entryUrl);
+            return path.join(path.dirname(entry), "cli.js");
+        }
+        catch {
+            // fall through
+        }
+        throw new Error("Cannot locate the pi CLI. Install @earendil-works/pi-coding-agent globally (npm i -g @earendil-works/pi-coding-agent) or set PI_CLI_PATH.");
+    }
+    async start() {
+        if (this.client)
+            return;
+        // The workdir becomes the pi child process's cwd; spawn requires it to
+        // exist, so create it on demand.
+        if (this.options.cwd) {
+            fs.mkdirSync(this.options.cwd, { recursive: true });
+        }
+        const cliPath = this.options.cliPath ?? (await PiRpc.resolveCliPath());
+        const client = new RpcClient({
+            cliPath,
+            cwd: this.options.cwd,
+            args: this.options.args,
+        });
+        await client.start();
+        // Attach any listeners that were registered before the client connected
+        for (const listener of this.listeners) {
+            if (listener)
+                client.onEvent(listener);
+        }
+        // Cold start handshake: the process may need a moment before answering.
+        let lastError;
+        for (let attempt = 1; attempt <= 5; attempt++) {
+            try {
+                await client.getState();
+                this.client = client;
+                return;
+            }
+            catch (err) {
+                lastError = err;
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+        }
+        await client.stop().catch(() => { });
+        throw new Error(`pi RPC did not become ready: ${lastError?.message}`);
+    }
+    async stop() {
+        if (!this.client)
+            return;
+        await this.client.stop();
+        this.client = undefined;
+        this.commandsCache = undefined;
+        this.listeners = [];
+    }
+    /**
+     * Restart the pi process. Keeps registered event listeners attached to the
+     * new process. The session persists on disk, so the same session is resumed.
+     * Useful after installing new extensions/skills or changing provider config.
+     */
+    async restart() {
+        const keptListeners = this.listeners;
+        await this.stop();
+        this.listeners = keptListeners;
+        await this.start();
+    }
+    /**
+     * Send a user prompt. If the agent is streaming, the RPC server rejects a
+     * plain prompt — retry as a steering message (queued, delivered after the
+     * current tool calls finish).
+     */
+    async prompt(text) {
+        if (!this.client)
+            throw new Error("pi RPC not connected");
+        try {
+            await this.client.prompt(text);
+        }
+        catch (err) {
+            if (/streaming/i.test(err.message)) {
+                await this.client.steer(text);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    /** Subscribe to agent events. Safe to call before start(). Returns an unsubscribe function. */
+    onEvent(listener) {
+        const index = this.listeners.push(listener) - 1;
+        let clientUnsub;
+        if (this.client) {
+            clientUnsub = this.client.onEvent(listener);
+        }
+        return () => {
+            this.listeners[index] = undefined;
+            clientUnsub?.();
+        };
+    }
+    // =========================================================================
+    // RPC command conveniences (used by the slash command map)
+    // =========================================================================
+    async newSession() {
+        return this.requireClient().newSession();
+    }
+    async compact(customInstructions) {
+        return this.requireClient().compact(customInstructions);
+    }
+    async abort() {
+        await this.requireClient().abort();
+    }
+    async getState() {
+        return this.requireClient().getState();
+    }
+    async getAvailableModels() {
+        return this.requireClient().getAvailableModels();
+    }
+    async setModel(provider, modelId) {
+        return this.requireClient().setModel(provider, modelId);
+    }
+    async setThinkingLevel(level) {
+        await this.requireClient().setThinkingLevel(level);
+    }
+    async setSessionName(name) {
+        await this.requireClient().setSessionName(name);
+    }
+    async getSessionStats() {
+        return this.requireClient().getSessionStats();
+    }
+    async exportHtml(outputPath) {
+        return this.requireClient().exportHtml(outputPath);
+    }
+    async bash(command) {
+        return this.requireClient().bash(command);
+    }
+    async switchSession(sessionPath) {
+        return this.requireClient().switchSession(sessionPath);
+    }
+    /** Get available commands (extension commands, prompt templates, skills) with a short cache. */
+    async getCommands() {
+        if (this.commandsCache && Date.now() - this.commandsCache.at < 60_000) {
+            return this.commandsCache.list;
+        }
+        const list = (await this.requireClient().getCommands());
+        const commands = list.commands ?? [];
+        this.commandsCache = { at: Date.now(), list: commands };
+        return commands;
+    }
+    requireClient() {
+        if (!this.client)
+            throw new Error("pi RPC not connected");
+        return this.client;
+    }
+}
+//# sourceMappingURL=pi-rpc.js.map

package/dist/rpc/pi-rpc.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Interactive first-run setup wizard.
+ *
+ * Usage: node dist/standalone.js --setup
+ *
+ * Walks through: Matrix homeserver → bot login (or pasted token) → trusted
+ * admin user → E2EE toggle, then writes ~/.pi/msg-bridge.json.
+ */
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkGH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAgE9C"}

package/dist/setup.js

@@ -0,0 +1,159 @@
+/**
+ * Interactive first-run setup wizard.
+ *
+ * Usage: node dist/standalone.js --setup
+ *
+ * Walks through: Matrix homeserver → bot login (or pasted token) → trusted
+ * admin user → E2EE toggle, then writes ~/.pi/msg-bridge.json.
+ */
+import * as os from "node:os";
+import { stdin, stdout } from "node:process";
+import { createInterface } from "node:readline";
+import { saveConfig } from "./config.js";
+/**
+ * Input abstraction that works in both modes:
+ *  - TTY: interactive question() (echoes prompt, reads one line at a time)
+ *  - piped/closed stdin: pre-read all lines, consume in order (no line loss,
+ *    which readline.question suffers from when input is buffered)
+ * Returns { ask, close } — close() releases stdin listeners so the process
+ * can exit naturally after setup finishes.
+ */
+function createPrompter() {
+    if (stdin.isTTY) {
+        const rl = createInterface({ input: stdin, output: stdout });
+        return {
+            ask: (prompt) => new Promise((resolve) => {
+                let done = false;
+                const finish = (answer) => {
+                    if (!done) {
+                        done = true;
+                        resolve(answer);
+                    }
+                };
+                rl.question(prompt, finish);
+                rl.once("close", () => finish(""));
+            }),
+            close: () => {
+                rl.close();
+            },
+        };
+    }
+    // Piped mode: read everything up front, then consume line by line
+    let data = "";
+    stdin.setEncoding("utf-8");
+    stdin.on("data", (chunk) => {
+        data += chunk;
+    });
+    const lines = [];
+    stdin.on("end", () => {
+        lines.push(...data.split("\n"));
+    });
+    return {
+        ask: async (prompt) => {
+            process.stdout.write(prompt);
+            await new Promise((resolve) => {
+                if (lines.length > 0 || data.length > 0)
+                    resolve(undefined);
+                else
+                    stdin.once("end", () => resolve(undefined));
+            });
+            return lines.shift()?.trim() ?? "";
+        },
+        close: () => {
+            stdin.removeAllListeners("data");
+            stdin.removeAllListeners("end");
+        },
+    };
+}
+async function matrixLogin(homeserver, username, password) {
+    const url = `${homeserver.replace(/\/$/, "")}/_matrix/client/v3/login`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            type: "m.login.password",
+            identifier: { type: "m.id.user", user: username },
+            password,
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`登录失败 (HTTP ${res.status}): ${body.slice(0, 300)}`);
+    }
+    const data = (await res.json());
+    if (!data.access_token)
+        throw new Error("登录响应缺少 access_token");
+    return { accessToken: data.access_token, userId: data.user_id ?? "" };
+}
+async function matrixWhoami(homeserver, accessToken) {
+    const url = `${homeserver.replace(/\/$/, "")}/_matrix/client/v3/account/whoami`;
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${accessToken}` } });
+    if (!res.ok)
+        throw new Error(`token 验证失败 (HTTP ${res.status})`);
+    const data = (await res.json());
+    return data.user_id ?? "unknown";
+}
+export async function runSetup() {
+    const { ask, close } = createPrompter();
+    console.log("");
+    console.log("=== pi-remote 首次配置向导 ===");
+    console.log("将生成 ~/.pi/msg-bridge.json(权限 600)\n");
+    try {
+        const homeserver = (await ask("Matrix homeserver URL (如 https://matrix.example.com): ")).trim();
+        if (!homeserver)
+            throw new Error("homeserver URL 不能为空");
+        const authMode = (await ask("获取 token 方式 [1=用户名密码登录, 2=粘贴已有 token] (1): ")).trim() || "1";
+        let accessToken;
+        let botUserId;
+        if (authMode === "2") {
+            accessToken = (await ask("粘贴 access token (syt_...): ")).trim();
+            if (!accessToken)
+                throw new Error("token 不能为空");
+            botUserId = await matrixWhoami(homeserver, accessToken);
+            console.log(`✅ token 有效,账号: ${botUserId}`);
+        }
+        else {
+            const username = (await ask("bot 用户名 (如 test2): ")).trim();
+            // 密码不回显(终端模式);普通模式会显示,注意遮挡
+            const password = await ask("bot 密码: ");
+            if (!username || !password)
+                throw new Error("用户名/密码不能为空");
+            console.log("登录中…");
+            const login = await matrixLogin(homeserver, username, password);
+            accessToken = login.accessToken;
+            botUserId = login.userId;
+            console.log(`✅ 登录成功,账号: ${botUserId}`);
+        }
+        const adminDefault = botUserId.replace(/^@/, "").split(":")[0];
+        const adminRaw = (await ask(`信任用户(管理员)MXID [默认 ${botUserId}]: `)).trim() || botUserId;
+        if (!adminRaw.startsWith("@"))
+            throw new Error("MXID 应以 @ 开头,如 @barry:matrix.example.com");
+        const encryption = (await ask("启用 E2EE 加密? [y/N]: ")).trim().toLowerCase() === "y";
+        const workdirDefault = `${os.homedir()}/Projects`;
+        const workdir = (await ask(`pi 工作目录 [默认 ${workdirDefault}]: `)).trim() || workdirDefault;
+        saveConfig({
+            matrix: { homeserverUrl: homeserver, accessToken, encryption },
+            auth: {
+                trustedUsers: [`matrix:${adminRaw}`],
+                adminUserId: `matrix:${adminRaw}`,
+            },
+            workdir,
+            autoConnect: true,
+            debug: true,
+        });
+        console.log("\n✅ 配置已写入 ~/.pi/msg-bridge.json");
+        console.log(`   账号: ${botUserId}`);
+        console.log(`   信任用户: ${adminRaw}`);
+        console.log(`   E2EE: ${encryption ? "开启" : "关闭"}`);
+        console.log(`   工作目录: ${workdir}`);
+        console.log("\n下一步: pi-remote enable(开机自启)或 pi-remote run(前台运行)");
+    }
+    catch (err) {
+        console.error(`\n❌ 配置失败: ${err.message}`);
+        process.exitCode = 1;
+    }
+    finally {
+        close(); // release stdin listeners so the process exits naturally
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/standalone.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Standalone entry — runs the bridge as its own process (systemd-friendly),
+ * talking to pi over RPC mode instead of living inside pi as an extension.
+ *
+ * Usage:
+ *   node dist/standalone.js [--workdir <dir>] [--pi-cli <path>] [--session-dir <dir>] [--debug]
+ *
+ * Architecture:
+ *   Messenger (Matrix/Telegram/...) ──> bridge ──> pi --mode rpc (JSONL over stdio)
+ *   Messenger <── replies <────────── bridge <── agent events (stdout JSONL)
+ */
+export declare function main(argv?: string[]): Promise<void>;
+//# 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;;;;;;;;;;GAUG;AA2DH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAsIhF"}