pi-courier 0.1.37 → 0.1.39

package/dist/auth/headless-login.js

@@ -0,0 +1,386 @@
+/**
+ * Headless login (issue #55, spec #51 ticket 4) — provider login without
+ * leaving Matrix.
+ *
+ * The admin runs `/login <provider> <oauth|api_key>` in the management room
+ * (single-project mode: a DM). An independent ModelRuntime (authPath pointing
+ * at pi's standard credential file, shared with every pi subprocess) drives
+ * the upstream login flow; the AuthInteraction callbacks are translated into
+ * chat messages — auth_url / device_code / progress become display messages,
+ * prompts (secret/text/select/manual_code) become questions whose answer is
+ * the room's next plain message, and 「取消」 aborts the flow at any time.
+ *
+ * The courier holds no credentials itself: the runtime writes them straight
+ * to <agentDir>/auth.json (file-locked merge write). pi subprocesses only
+ * read that file at startup, so after a successful login the caller restarts
+ * the IDLE rpcs (restartIdleRpcs in command-map) and tells the room to
+ * /reload the busy ones later.
+ *
+ * Capture priority: while a login flow in a room waits for an answer, plain
+ * messages there are captured BEFORE pending extension_ui questions (ticket
+ * requirement) — see the router's handleIncoming ordering.
+ *
+ * Upstream contract verified against
+ * node_modules/@earendil-works/pi-ai/dist/auth/types.d.ts (AuthInteraction:
+ * prompt rejects = abnormal exit, which is exactly the cancel path) and
+ * dist/core/model-runtime.d.ts (login/logout/listCredentials; listCredentials
+ * is ASYNC upstream — Promise<readonly CredentialInfo[]>).
+ */
+import * as path from "node:path";
+import { builtinProviders } from "@earendil-works/pi-ai/providers/all";
+import { getAgentDir, ModelRuntime } from "@earendil-works/pi-coding-agent";
+import { formatReloadAllResult, restartIdleRpcs } from "../rpc/command-map.js";
+/**
+ * Enumerate the builtin providers that support an INTERACTIVE login. Presence
+ * of `auth.apiKey`/`auth.oauth` alone is not enough — ambient-only providers
+ * (env vars, AWS profiles) omit `login` and cannot be logged in from a chat.
+ * Sorted by id for a stable listing.
+ */
+export function listLoginProviders() {
+    return builtinProviders()
+        .filter((p) => p.auth?.oauth?.login || p.auth?.apiKey?.login)
+        .map((p) => ({
+        id: p.id,
+        name: p.name,
+        oauth: Boolean(p.auth?.oauth?.login),
+        apiKey: Boolean(p.auth?.apiKey?.login),
+    }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
+/**
+ * Render the /login (no-arg) listing: one line per provider with its methods
+ * and a ✅ 已认证(<type>) badge for each stored credential. Pure.
+ */
+export function formatLoginProviders(providers, credentials = []) {
+    if (providers.length === 0)
+        return "没有可登录的 provider。";
+    const byProvider = new Map();
+    for (const c of credentials) {
+        const list = byProvider.get(c.providerId) ?? [];
+        list.push(c);
+        byProvider.set(c.providerId, list);
+    }
+    const lines = providers.map((p) => {
+        const methods = [p.oauth ? "oauth" : null, p.apiKey ? "api_key" : null]
+            .filter(Boolean)
+            .join(" / ");
+        const creds = byProvider.get(p.id);
+        const badge = creds?.length
+            ? ` ✅ 已认证(${creds.map((c) => c.type).join(" + ")})`
+            : "";
+        return `• ${p.id} — ${p.name}(${methods})${badge}`;
+    });
+    return `🔐 可登录 provider(${providers.length}):\n${lines.join("\n")}\n\n用 /login <provider> <oauth|api_key> 开始登录。`;
+}
+/** /auth — the stored credentials, one line each (no secrets, metadata only). */
+export function formatCredentials(credentials) {
+    if (credentials.length === 0) {
+        return "💤 暂无已保存凭据(用 /login <provider> <oauth|api_key> 登录)。";
+    }
+    const lines = credentials.map((c) => `• ${c.providerId} — ${c.type}`);
+    return `🔐 已保存凭据 (${credentials.length}):\n${lines.join("\n")}`;
+}
+// ===========================================================================
+// AuthInteraction translation (pure — directly testable)
+// ===========================================================================
+/** The room message for an upstream login prompt (issue #55). Secret prompts
+ *  must warn that the key stays in the room history. */
+export function translateAuthPrompt(prompt) {
+    switch (prompt.type) {
+        case "select": {
+            const lines = prompt.options.map((o, i) => {
+                const desc = o.description ? ` — ${o.description}` : "";
+                return `${i + 1}. ${o.label}${desc}`;
+            });
+            return `❓ ${prompt.message}\n${lines.join("\n")}\n回复序号选择(发送「取消」放弃)`;
+        }
+        case "secret":
+            return [
+                `❓ ${prompt.message}`,
+                "直接回复密钥内容。",
+                "⚠️ 密钥将留在房间历史,建议用后删除该消息(发送「取消」放弃)",
+            ].join("\n");
+        case "manual_code":
+            return `❓ ${prompt.message}\n把浏览器授权后最终跳转到的完整 URL 直接粘贴回来(发送「取消」放弃)`;
+        default: // text
+            return `❓ ${prompt.message}\n直接回复内容作为答案(发送「取消」放弃)`;
+    }
+}
+/** The room message for an upstream login event: auth_url / device_code /
+ *  progress / info → display-only lines (no answer expected). */
+export function translateAuthEvent(event) {
+    switch (event.type) {
+        case "auth_url": {
+            const lines = [`🌐 请在浏览器打开以下链接完成授权:\n${event.url}`];
+            if (event.instructions)
+                lines.push(event.instructions);
+            return lines.join("\n");
+        }
+        case "device_code": {
+            const lines = [
+                `🔑 设备码: ${event.userCode}`,
+                `请在浏览器打开 ${event.verificationUri} 并输入上述设备码。`,
+            ];
+            if (event.expiresInSeconds) {
+                lines.push(`(有效期约 ${Math.max(1, Math.round(event.expiresInSeconds / 60))} 分钟)`);
+            }
+            return lines.join("\n");
+        }
+        case "progress":
+            return `⏳ ${event.message}`;
+        default: { // info
+            const linkLines = (event.links ?? []).map((l) => `🔗 ${l.label ? `${l.label}: ` : ""}${l.url}`);
+            return [`ℹ️ ${event.message}`, ...linkLines].join("\n");
+        }
+    }
+}
+/** Map a room message onto a login prompt's answer (issue #55). Pure.
+ *  「取消」 is exact; select maps the 1-based index onto the option ID
+ *  (out of range re-asks); every other prompt type takes the whole message. */
+export function parseLoginAnswer(prompt, text) {
+    if (text === "取消")
+        return { kind: "cancel" };
+    if (prompt.type === "select") {
+        const count = prompt.options.length;
+        const index = /^\d+$/.test(text) ? Number.parseInt(text, 10) : 0;
+        if (index >= 1 && index <= count) {
+            return { kind: "value", value: prompt.options[index - 1].id };
+        }
+        return { kind: "invalid", hint: `⚠️ 请回复 1 到 ${count} 之间的序号(发送「取消」放弃)` };
+    }
+    return { kind: "value", value: text };
+}
+/** The credential file this module writes: pi's standard auth.json under the
+ *  agent dir (PI_CODING_AGENT_DIR respected) — shared with every pi subprocess. */
+export function defaultAuthPath() {
+    return path.join(getAgentDir(), "auth.json");
+}
+async function defaultRuntimeFactory(authPath) {
+    // No model-catalog network access needed for login (allowModelNetwork false
+    // is upstream's default) and no key validation — we only write credentials.
+    return ModelRuntime.create({ authPath });
+}
+/** Rejection carried out of a cancelled login flow (prompt rejects = upstream
+ *  exits abnormally — the documented cancel path). */
+export class LoginCancelledError extends Error {
+    constructor() {
+        super("login cancelled");
+        this.name = "LoginCancelledError";
+    }
+}
+export class LoginManager {
+    deps;
+    pending = new Map();
+    runtime;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Whether a login flow is active in this room (router capture gate). */
+    isPending(chatId) {
+        return this.pending.has(chatId);
+    }
+    /** /login with no arguments — the login-able provider list with auth badges. */
+    async listProviders(chatId, transport) {
+        let credentials = [];
+        try {
+            credentials = [...(await (await this.getRuntime()).listCredentials())];
+        }
+        catch {
+            // The badge is best-effort — the capability listing still stands.
+        }
+        await this.deps.sendReply(chatId, transport, formatLoginProviders(listLoginProviders(), credentials));
+    }
+    /** /login <provider> [oauth|api_key] — start a flow. Gates (admin +
+     *  management room) are the router's job; this validates the target. */
+    async startLogin(chatId, transport, providerId, method) {
+        if (this.pending.has(chatId)) {
+            await this.deps.sendReply(chatId, transport, "⚠️ 本房间已有登录流程进行中(发送「取消」中止后再试)。");
+            return;
+        }
+        const provider = listLoginProviders().find((p) => p.id === providerId);
+        if (!provider) {
+            await this.deps.sendReply(chatId, transport, `❌ 未知 provider: ${providerId}(用 /login 查看可登录列表)`);
+            return;
+        }
+        const supported = [];
+        if (provider.oauth)
+            supported.push("oauth");
+        if (provider.apiKey)
+            supported.push("api_key");
+        const requested = method?.toLowerCase();
+        let chosen;
+        if (requested === "oauth" || requested === "api_key") {
+            chosen = requested;
+        }
+        else if (requested) {
+            await this.deps.sendReply(chatId, transport, "用法: /login <provider> <oauth|api_key>");
+            return;
+        }
+        else if (supported.length === 1) {
+            chosen = supported[0]; // unambiguous — pick the only way
+        }
+        else {
+            await this.deps.sendReply(chatId, transport, `⚠️ ${providerId} 支持多种登录方式(${supported.join(" / ")}),请指定:\n` +
+                `/login ${providerId} oauth\n/login ${providerId} api_key`);
+            return;
+        }
+        if (!supported.includes(chosen)) {
+            await this.deps.sendReply(chatId, transport, `❌ ${providerId} 不支持 ${chosen} 登录(支持: ${supported.join(" / ")})`);
+            return;
+        }
+        const entry = {
+            chatId,
+            transport,
+            providerId,
+            method: chosen,
+            controller: new AbortController(),
+            finished: false,
+        };
+        this.pending.set(chatId, entry);
+        await this.deps.sendReply(chatId, transport, `🔑 已开始 ${providerId} ${chosen} 登录流程,请按提示操作(任意时刻发送「取消」中止)。`);
+        // Long-running by design: never block the message pipeline — the flow
+        // continues over the capture channel (deliver / cancel).
+        void this.run(entry);
+    }
+    /** Feed a plain room message into the pending flow. Returns true when the
+     *  message was consumed. 「取消」 aborts at ANY moment; otherwise only
+     *  messages arriving while a prompt is waiting count as the answer — the
+     *  room stays usable during long OAuth waits (device polling etc.). */
+    async deliver(chatId, text) {
+        const entry = this.pending.get(chatId);
+        if (!entry || entry.finished)
+            return false;
+        if (text === "取消") {
+            await this.cancel(chatId);
+            return true;
+        }
+        const current = entry.current;
+        if (!current)
+            return false;
+        const answer = parseLoginAnswer(current.prompt, text);
+        if (answer.kind === "invalid") {
+            await this.deps.sendReply(chatId, entry.transport, answer.hint);
+            return true;
+        }
+        if (answer.kind === "cancel")
+            return true; // unreachable: 取消 handled above
+        current.submit(answer.value);
+        return true;
+    }
+    /** Abort the room's pending flow (「取消」 or a replacement command). */
+    async cancel(chatId) {
+        const entry = this.pending.get(chatId);
+        if (!entry || entry.finished)
+            return false;
+        entry.finished = true;
+        this.pending.delete(chatId);
+        // Aborting rejects the parked prompt (LoginCancelledError) → upstream
+        // login exits abnormally; run() stays silent for this path.
+        entry.controller.abort();
+        await this.deps.sendReply(chatId, entry.transport, `🛑 已取消 ${entry.providerId} 的登录流程`);
+        return true;
+    }
+    /** /logout <provider> — delete the stored credential (metadata check first;
+     *  logout itself never sees the secret). Running pi processes keep their
+     *  in-memory credential until restarted. */
+    async logout(chatId, transport, providerId) {
+        try {
+            const runtime = await this.getRuntime();
+            const credentials = await runtime.listCredentials();
+            if (!credentials.some((c) => c.providerId === providerId)) {
+                await this.deps.sendReply(chatId, transport, `❌ ${providerId} 没有已保存的凭据(用 /auth 查看)`);
+                return;
+            }
+            await runtime.logout(providerId);
+            await this.deps.sendReply(chatId, transport, `✅ 已删除 ${providerId} 的凭据。运行中的 pi 进程仍持有旧凭据,空闲后执行 /reload all 使登出生效。`);
+        }
+        catch (err) {
+            await this.deps.sendReply(chatId, transport, `❌ 登出失败: ${err.message}`);
+        }
+    }
+    /** /auth — which providers are authenticated and how. */
+    async authStatus(chatId, transport) {
+        try {
+            const runtime = await this.getRuntime();
+            await this.deps.sendReply(chatId, transport, formatCredentials([...(await runtime.listCredentials())]));
+        }
+        catch (err) {
+            await this.deps.sendReply(chatId, transport, `❌ 读取凭据失败: ${err.message}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    async getRuntime() {
+        this.runtime ??= (this.deps.runtimeFactory ?? defaultRuntimeFactory)(this.deps.authPath ?? defaultAuthPath());
+        return this.runtime;
+    }
+    /** Drive one login flow to completion: translate the AuthInteraction into
+     *  chat round-trips, then restart the idle rpcs on success. */
+    async run(entry) {
+        const { chatId, transport, providerId, method } = entry;
+        const interaction = {
+            signal: entry.controller.signal,
+            prompt: (p) => this.promptUser(entry, p),
+            notify: (e) => {
+                void this.deps.sendReply(chatId, transport, translateAuthEvent(e));
+            },
+        };
+        try {
+            const runtime = await this.getRuntime();
+            await runtime.login(providerId, method, interaction);
+            if (entry.controller.signal.aborted)
+                return; // cancelled mid-write
+            entry.finished = true;
+            this.drop(entry);
+            const lines = [`✅ ${providerId} 登录成功,凭据已写入 ${this.deps.authPath ?? defaultAuthPath()}`];
+            try {
+                // pi subprocesses read the credential file once at startup — restart
+                // the idle ones now, tell the room about the busy ones (issue #55).
+                lines.push(formatReloadAllResult(await restartIdleRpcs(this.deps.allRpcs(), this.deps.onRestarted)));
+            }
+            catch {
+                // Restart trouble must never fail the (already persisted) login reply.
+            }
+            await this.deps.sendReply(chatId, transport, lines.join("\n"));
+        }
+        catch (err) {
+            entry.finished = true;
+            this.drop(entry);
+            if (err instanceof LoginCancelledError || entry.controller.signal.aborted)
+                return;
+            await this.deps.sendReply(chatId, transport, `❌ ${providerId} 登录失败: ${err.message}`);
+        }
+    }
+    /** Remove this flow's pending entry — and only its own: after a quick
+     *  cancel + re-login in the same room, a still-draining old flow must not
+     *  evict the NEW entry (the map is keyed by chat). */
+    drop(entry) {
+        if (this.pending.get(entry.chatId) === entry)
+            this.pending.delete(entry.chatId);
+    }
+    /** Park a prompt: post the question, resolve with the room's next answer,
+     *  reject on abort (upstream treats a rejected prompt as abnormal exit —
+     *  the documented cancel path). */
+    async promptUser(entry, prompt) {
+        await this.deps.sendReply(entry.chatId, entry.transport, translateAuthPrompt(prompt));
+        return new Promise((resolve, reject) => {
+            if (entry.controller.signal.aborted) {
+                reject(new LoginCancelledError());
+                return;
+            }
+            const onAbort = () => {
+                entry.current = undefined;
+                reject(new LoginCancelledError());
+            };
+            entry.controller.signal.addEventListener("abort", onAbort, { once: true });
+            entry.current = {
+                prompt,
+                submit: (value) => {
+                    entry.controller.signal.removeEventListener("abort", onAbort);
+                    entry.current = undefined;
+                    resolve(value);
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=headless-login.js.map

package/dist/auth/headless-login.js.map

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

package/dist/quote-cache.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Reply-quote ring cache (issue #56 票5) — pure, in-memory, no I/O.
+ *
+ * The Matrix transport records every inbound message's event_id → excerpt
+ * (per room, FIFO eviction at MAX_ENTRIES_PER_ROOM) so a later reply to a
+ * historical message can carry a short quote of the referenced text into the
+ * prompt. This is how "这个"/"上面那个" become resolvable for the agent.
+ *
+ * Deliberately memory-bounded: 50 entries/room, excerpt capped at 200 chars.
+ * Cache misses are a normal, silent downgrade — quotes are best-effort context.
+ */
+/** A cleaned one-line excerpt of a quoted message plus its sender. */
+export interface QuoteEntry {
+    username: string;
+    excerpt: string;
+}
+export interface QuoteCache {
+    /** Record a message for later quote lookups in that room. */
+    record(roomId: string, eventId: string, entry: QuoteEntry): void;
+    /** The recorded entry, or undefined when unknown (miss = silent no-quote). */
+    lookup(roomId: string, eventId: string): QuoteEntry | undefined;
+}
+/** Ring capacity per room; beyond this the oldest messages fall out. */
+export declare const MAX_ENTRIES_PER_ROOM = 50;
+/** Excerpt cap: enough context to identify a message, small enough for a prompt prefix. */
+export declare const EXCERPT_MAX_CHARS = 200;
+/** Single-line, trimmed excerpt capped at EXCERPT_MAX_CHARS ("…" marks truncation). */
+export declare function toExcerpt(body: string, max?: number): string;
+/**
+ * Per-room FIFO cache. Insertion-ordered Maps give O(1) refresh/evict:
+ * re-recording an existing event id deletes then re-inserts it, so the ring
+ * evicts by last-seen order and a refresh never wastes a slot.
+ */
+export declare function createQuoteCache(): QuoteCache;
+//# sourceMappingURL=quote-cache.d.ts.map

package/dist/quote-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-cache.d.ts","sourceRoot":"","sources":["../src/quote-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjE,8EAA8E;IAC9E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;CACjE;AAED,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAoB,GAAG,MAAM,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAsB7C"}

package/dist/quote-cache.js

@@ -0,0 +1,51 @@
+/**
+ * Reply-quote ring cache (issue #56 票5) — pure, in-memory, no I/O.
+ *
+ * The Matrix transport records every inbound message's event_id → excerpt
+ * (per room, FIFO eviction at MAX_ENTRIES_PER_ROOM) so a later reply to a
+ * historical message can carry a short quote of the referenced text into the
+ * prompt. This is how "这个"/"上面那个" become resolvable for the agent.
+ *
+ * Deliberately memory-bounded: 50 entries/room, excerpt capped at 200 chars.
+ * Cache misses are a normal, silent downgrade — quotes are best-effort context.
+ */
+/** Ring capacity per room; beyond this the oldest messages fall out. */
+export const MAX_ENTRIES_PER_ROOM = 50;
+/** Excerpt cap: enough context to identify a message, small enough for a prompt prefix. */
+export const EXCERPT_MAX_CHARS = 200;
+/** Single-line, trimmed excerpt capped at EXCERPT_MAX_CHARS ("…" marks truncation). */
+export function toExcerpt(body, max = EXCERPT_MAX_CHARS) {
+    const oneLine = body.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
+}
+/**
+ * Per-room FIFO cache. Insertion-ordered Maps give O(1) refresh/evict:
+ * re-recording an existing event id deletes then re-inserts it, so the ring
+ * evicts by last-seen order and a refresh never wastes a slot.
+ */
+export function createQuoteCache() {
+    const rooms = new Map();
+    return {
+        record(roomId, eventId, entry) {
+            if (!eventId || !entry.excerpt)
+                return;
+            let room = rooms.get(roomId);
+            if (!room) {
+                room = new Map();
+                rooms.set(roomId, room);
+            }
+            room.delete(eventId);
+            room.set(eventId, entry);
+            while (room.size > MAX_ENTRIES_PER_ROOM) {
+                const oldest = room.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                room.delete(oldest);
+            }
+        },
+        lookup(roomId, eventId) {
+            return rooms.get(roomId)?.get(eventId);
+        },
+    };
+}
+//# sourceMappingURL=quote-cache.js.map

package/dist/quote-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-cache.js","sourceRoot":"","sources":["../src/quote-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAG,GAAG,iBAAiB;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IACzD,OAAO;QACL,MAAM,CAAC,MAAc,EAAE,OAAe,EAAE,KAAiB;YACvD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,OAAO;YACvC,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;gBACjB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBACxC,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM;gBAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,MAAc,EAAE,OAAe;YACpC,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -15,11 +15,74 @@
  *  help surface; ChallengeAuth no longer has its own help text.
  */
 import type { PiRpc } from "./pi-rpc.js";
+/** Mirror of the upstream steering/followUp queues (router's queue_update view). */
+export interface QueueSnapshot {
+    steering: string[];
+    followUp: string[];
+}
 export interface SlashCommandContext {
     rpc: PiRpc;
     /** Send a reply back to the originating chat */
     reply: (text: string) => Promise<void>;
+    /** Live queue snapshot maintained by the router (queue_update mirror).
+     *  Absent/undefined entries mean "no queue seen yet" = empty. */
+    queueView?: () => QueueSnapshot | undefined;
+    /** Every rpc of this instance (default + started project rpcs) — enables
+     *  `/reload all` (issue #55). Absent = /reload stays single-process. */
+    allRpcs?: () => PiRpc[];
+    /** Router-owned per-rpc transient state (queue mirror, pending extension
+     *  questions) must not survive a restart: the new subprocess knows nothing
+     *  of old question ids, and a stale question would swallow the room's next
+     *  message as a bogus "answer". */
+    clearRpcState?: (rpc: PiRpc) => void;
+}
+/**
+ * Unified queue warning for /stop and /interrupt replies: abort preserves the
+ * upstream queues (RPC has no clear_queue), so remaining messages would fire
+ * on the NEXT turn — surface that explicitly. Null when nothing is queued.
+ */
+export declare function queueWarning(snapshot: QueueSnapshot | undefined): string | null;
+export interface ReloadAllResult {
+    /** Labels of rpcs that were idle and got restarted. */
+    restarted: string[];
+    /** Labels of rpcs that were streaming — skipped, need a later /reload. */
+    busy: string[];
+    /** Labels of rpcs that could not be queried (not started / unreachable) —
+     *  they pick the new credentials up on their next start anyway. */
+    skipped: string[];
 }
+/**
+ * Restart every IDLE rpc of the instance so a fresh pi subprocess re-reads
+ * pi's credential/config files (issue #55: after /login writes credentials,
+ * and for /reload all). Busy (streaming) rpcs are skipped — an abrupt restart
+ * would kill a running turn; the room is told to /reload them later.
+ * Unqueryable rpcs (lazy, never started) are skipped: their FIRST start reads
+ * the fresh file anyway.
+ */
+export declare function restartIdleRpcs(rpcs: readonly PiRpc[], onRestarted?: (rpc: PiRpc) => void): Promise<ReloadAllResult>;
+/** Render a reload summary for the room. Pure — directly testable. */
+export declare function formatReloadAllResult(result: ReloadAllResult): string;
+export interface SessionSummary {
+    /** Absolute path — what /switch hands to switchSession. */
+    path: string;
+    /** File name, e.g. 2026-09-05T12-00-00-000Z_<sessionId>.jsonl. */
+    file: string;
+    /** Last-modified time (ms epoch) — the list sorts by it, newest first. */
+    mtimeMs: number;
+}
+/**
+ * Scan a session dir for pi session files (*.jsonl), newest first. A missing
+ * or unreadable dir yields [] (the caller reports "找不到会话目录").
+ */
+export declare function listSessions(dir: string): SessionSummary[];
+/** The session dir a process scans: its own --session-dir, else pi's default. */
+export declare function resolveSessionDir(rpc: PiRpc): string;
+/**
+ * Display name of a session: the LAST "session_info" entry's name field.
+ * Regex-scanned per jsonl line (no full JSON parse); giant files skip the
+ * lookup — the name is a display nicety, never load-bearing.
+ */
+export declare function readSessionName(filePath: string): string | undefined;
 /** Returns true if the command was handled (something was done / replied). */
 export declare function handleSlashCommand(text: string, ctx: SlashCommandContext): Promise<boolean>;
 //# sourceMappingURL=command-map.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"command-map.d.ts","sourceRoot":"","sources":["../../src/rpc/command-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,KAAK,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CAoLlB"}
+{"version":3,"file":"command-map.d.ts","sourceRoot":"","sources":["../../src/rpc/command-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,KAAK,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;qEACiE;IACjE,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;IAC5C;4EACwE;IACxE,OAAO,CAAC,EAAE,MAAM,KAAK,EAAE,CAAC;IACxB;;;uCAGmC;IACnC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO/E;AAUD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;uEACmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,SAAS,KAAK,EAAE,EACtB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GACjC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAcrE;AA4CD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAkB1D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBpE;AAyBD,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,OAAO,CAAC,CAyTlB"}