pi-remote-feishu 0.1.0

package/dist/bridge/message-normalizer.js

@@ -0,0 +1,81 @@
+/** 支持的飞书机器人命令集合（以 / 开头） */
+const COMMANDS = new Set(["help", "sessions", "models", "new", "stop", "reset", "status"]);
+/**
+ * 解析以 / 开头的命令文本。
+ * 例如 "/models" -> { name: "models", args: "" }；
+ * 不是命令或不在白名单里的命令返回 undefined。
+ */
+function parseCommand(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("/"))
+        return undefined;
+    const withoutSlash = trimmed.slice(1);
+    const [name = "", ...rest] = withoutSlash.split(/\s+/);
+    if (!COMMANDS.has(name))
+        return undefined;
+    return {
+        name: name,
+        args: rest.join(" "),
+    };
+}
+/**
+ * 去掉群聊消息开头的 @机器人 前缀。
+ * 例如 "@Pi check this" -> "check this"。
+ */
+function stripBotMention(text) {
+    return text.replace(/^@\S+\s*/, "").trim();
+}
+/**
+ * 归一化消息：
+ * 把飞书消息 + 路由结果 + 附件信息，转换成传给 Pi 的 NormalizedPiInput。
+ *
+ * 重点：
+ * - 群聊文本会剥掉 @机器人 前缀
+ * - 群聊会拼入发送者身份和会话模式的上下文说明，让模型知道在群里回复谁
+ * - 附件处理结果（文本内容/保存路径/失败原因）会追加到提示词里
+ * - 如果消息是 /命令，解析出 command 字段
+ */
+export function normalizeMessage(options) {
+    // 群聊去掉 @前缀，私聊直接 trim
+    const text = options.message.chatType === "group" ? stripBotMention(options.message.text) : options.message.text.trim();
+    const command = parseCommand(text);
+    const attachmentNotes = options.attachmentNotes ?? [];
+    const promptTextParts = [];
+    if (text.length > 0) {
+        if (options.message.chatType === "group") {
+            // 群聊场景：附加一段上下文说明，让模型知道当前会话模式及如何回复
+            const sender = options.message.senderName ?? options.message.userOpenId;
+            const groupMode = options.route.sessionKey.startsWith("group-user:") ? "per-user session" : "shared chat session";
+            promptTextParts.push([
+                "[Feishu group message]",
+                `Sender: ${sender}`,
+                `Session mode: ${groupMode}`,
+                "Reply naturally to the sender in the group. Keep the answer concise unless the user asks for detail.",
+                "Message:",
+                text,
+            ].join("\n"));
+        }
+        else {
+            // 私聊场景：直接使用消息文本
+            promptTextParts.push(text);
+        }
+    }
+    if (attachmentNotes.length > 0) {
+        promptTextParts.push(attachmentNotes.join("\n"));
+    }
+    const normalized = {
+        sessionKey: options.route.sessionKey,
+        chatId: options.message.chatId,
+        messageId: options.message.messageId,
+        userId: options.message.userOpenId,
+        chatType: options.message.chatType,
+        text: promptTextParts.join("\n\n"),
+        images: options.images ?? [],
+        attachmentNotes,
+        ...(options.message.tenantKey ? { tenantKey: options.message.tenantKey } : {}),
+        ...(options.message.senderName ? { senderName: options.message.senderName } : {}),
+        ...(command ? { command } : {}),
+    };
+    return normalized;
+}
+//# sourceMappingURL=message-normalizer.js.map

package/dist/bridge/message-normalizer.js.map

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

package/dist/bridge/prompt-queue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 提示词队列：保证"同一会话"内的多条飞书消息串行处理，
+ * 避免并发调用导致 Pi 会话状态错乱。
+ *
+ * 实现思路：维护一个 promise 链 tail，每次入队都把任务挂到链尾，
+ * 前一个任务完成后才会执行下一个。depth 用于观察当前排队深度。
+ */
+export declare class PromptQueue {
+    /** 队尾 promise：前一个任务结束时 resolve，唤醒下一个任务 */
+    private tail;
+    /** 当前排队/执行中的任务数 */
+    private depthValue;
+    /** 当前队列深度（含正在执行的那个） */
+    get depth(): number;
+    /**
+     * 入队执行一个任务。
+     * 返回任务本身的返回值；多个任务之间严格串行。
+     */
+    enqueue<T>(run: () => Promise<T>): Promise<T>;
+}

package/dist/bridge/prompt-queue.js

@@ -0,0 +1,39 @@
+/**
+ * 提示词队列：保证"同一会话"内的多条飞书消息串行处理，
+ * 避免并发调用导致 Pi 会话状态错乱。
+ *
+ * 实现思路：维护一个 promise 链 tail，每次入队都把任务挂到链尾，
+ * 前一个任务完成后才会执行下一个。depth 用于观察当前排队深度。
+ */
+export class PromptQueue {
+    /** 队尾 promise：前一个任务结束时 resolve，唤醒下一个任务 */
+    tail = Promise.resolve();
+    /** 当前排队/执行中的任务数 */
+    depthValue = 0;
+    /** 当前队列深度（含正在执行的那个） */
+    get depth() {
+        return this.depthValue;
+    }
+    /**
+     * 入队执行一个任务。
+     * 返回任务本身的返回值；多个任务之间严格串行。
+     */
+    async enqueue(run) {
+        this.depthValue += 1;
+        const previous = this.tail;
+        let release = () => { };
+        // 在链尾挂一个"信号"，前一个完成 -> release() -> 本任务启动
+        this.tail = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            return await run();
+        }
+        finally {
+            this.depthValue -= 1;
+            release();
+        }
+    }
+}
+//# sourceMappingURL=prompt-queue.js.map

package/dist/bridge/prompt-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-queue.js","sourceRoot":"","sources":["../../src/bridge/prompt-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,0CAA0C;IAClC,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAChD,mBAAmB;IACX,UAAU,GAAG,CAAC,CAAC;IAEvB,uBAAuB;IACvB,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAI,GAAqB;QACpC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;QACnC,yCAAyC;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACxC,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,EAAE,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/bridge/runtime-host.d.ts

@@ -0,0 +1,45 @@
+import { type AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
+import type { FeishuChannel, FeishuConfig, NormalizedPiInput } from "../types.js";
+/**
+ * 运行时宿主：把一个 Pi 的 AgentSessionRuntime 与飞书通道绑定，
+ * 并提供 prompt（生成）、abort（中止）、dispose（释放）等操作。
+ *
+ * 每次 prompt：
+ * 1. 注入飞书 UI 上下文（让 ui.select 变成飞书权限卡片）
+ * 2. 在 AsyncLocalStorage 里挂载 FeishuRunContext（供 send_file_to_chat 等工具读取）
+ * 3. 通过 renderPromptStream 以流式卡片方式渲染回复
+ * 4. 结束后清理临时附件、恢复之前的 UI 上下文
+ */
+export declare class RuntimeHost {
+    readonly sessionKey: string;
+    readonly runtime: AgentSessionRuntime;
+    private readonly config;
+    private readonly channel;
+    constructor(options: {
+        sessionKey: string;
+        runtime: AgentSessionRuntime;
+        config: FeishuConfig;
+        channel: FeishuChannel;
+    });
+    /** 当前模型是否支持图片输入（决定附件图片是转为 base64 还是落盘） */
+    supportsImages(): boolean;
+    /** 把一条归一化消息送入 Pi 会话生成，并以流式方式渲染到飞书 */
+    prompt(input: NormalizedPiInput): Promise<void>;
+    /** 中止当前生成（/stop 或卡片上的"停止生成"按钮） */
+    abort(): Promise<void>;
+    /** 释放运行时资源（会话被回收/删除时调用） */
+    dispose(): Promise<void>;
+}
+/**
+ * 创建一个新的运行时宿主：
+ * - 有历史会话文件（sessionFile）则用 SessionManager.open 恢复
+ * - 否则用 SessionManager.create 新建
+ * - 注册 pi-remote-feishu-runtime 隐藏扩展，注入 send_file_to_chat 工具
+ */
+export declare function createRuntimeHost(options: {
+    sessionKey: string;
+    sessionFile?: string;
+    cwd: string;
+    config: FeishuConfig;
+    channel: FeishuChannel;
+}): Promise<RuntimeHost>;

package/dist/bridge/runtime-host.js

@@ -0,0 +1,133 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, SessionManager, } from "@earendil-works/pi-coding-agent";
+import { cleanupTempAttachments } from "../attachments/temp-files.js";
+import { createFeishuUIContext } from "./ui-context.js";
+import { runWithFeishuContext } from "../feishu/context.js";
+import { createSendFileToChatTool } from "../tools/send-file-to-chat.js";
+import { renderPromptStream } from "./stream-renderer.js";
+/**
+ * 运行时宿主：把一个 Pi 的 AgentSessionRuntime 与飞书通道绑定，
+ * 并提供 prompt（生成）、abort（中止）、dispose（释放）等操作。
+ *
+ * 每次 prompt：
+ * 1. 注入飞书 UI 上下文（让 ui.select 变成飞书权限卡片）
+ * 2. 在 AsyncLocalStorage 里挂载 FeishuRunContext（供 send_file_to_chat 等工具读取）
+ * 3. 通过 renderPromptStream 以流式卡片方式渲染回复
+ * 4. 结束后清理临时附件、恢复之前的 UI 上下文
+ */
+export class RuntimeHost {
+    sessionKey;
+    runtime;
+    config;
+    channel;
+    constructor(options) {
+        this.sessionKey = options.sessionKey;
+        this.runtime = options.runtime;
+        this.config = options.config;
+        this.channel = options.channel;
+    }
+    /** 当前模型是否支持图片输入（决定附件图片是转为 base64 还是落盘） */
+    supportsImages() {
+        return this.runtime.session.model?.input?.includes("image") ?? false;
+    }
+    /** 把一条归一化消息送入 Pi 会话生成，并以流式方式渲染到飞书 */
+    async prompt(input) {
+        // 注入飞书 UI 上下文：Pi 的 ui.select/confirm 会转化为飞书卡片
+        const uiContext = createFeishuUIContext();
+        const previousUIContext = this.runtime.session.extensionRunner.getUIContext();
+        this.runtime.session.extensionRunner.setUIContext(uiContext, "rpc");
+        try {
+            // 挂载运行上下文，让 send_file_to_chat 等工具能拿到 channel/chatId
+            await runWithFeishuContext({
+                sessionKey: this.sessionKey,
+                chatId: input.chatId,
+                messageId: input.messageId,
+                channel: this.channel,
+                uiContext,
+                config: this.config,
+            }, async () => {
+                await renderPromptStream({
+                    config: this.config,
+                    channel: this.channel,
+                    chatId: input.chatId,
+                    replyTo: input.messageId,
+                    session: this.runtime.session,
+                    runPrompt: async () => {
+                        await this.runtime.session.prompt(input.text, {
+                            // steer：把模型回复内容交给事件订阅器，由我们决定如何渲染
+                            streamingBehavior: "steer",
+                            ...(input.images.length > 0 ? { images: input.images } : {}),
+                        });
+                    },
+                });
+            });
+        }
+        finally {
+            // 恢复之前的 UI 上下文（tui 模式），并清理本会话的临时附件
+            this.runtime.session.extensionRunner.setUIContext(previousUIContext, "tui");
+            await cleanupTempAttachments(this.config.files.tempDir ?? ".", this.sessionKey).catch(() => { });
+        }
+    }
+    /** 中止当前生成（/stop 或卡片上的"停止生成"按钮） */
+    async abort() {
+        await this.runtime.session.abort();
+    }
+    /** 释放运行时资源（会话被回收/删除时调用） */
+    async dispose() {
+        await this.runtime.dispose();
+    }
+}
+/**
+ * 创建一个新的运行时宿主：
+ * - 有历史会话文件（sessionFile）则用 SessionManager.open 恢复
+ * - 否则用 SessionManager.create 新建
+ * - 注册 pi-remote-feishu-runtime 隐藏扩展，注入 send_file_to_chat 工具
+ */
+export async function createRuntimeHost(options) {
+    const cwd = resolve(options.cwd);
+    const agentDir = getAgentDir();
+    const sessionManager = options.sessionFile && existsSync(options.sessionFile)
+        ? SessionManager.open(options.sessionFile, undefined, cwd)
+        : SessionManager.create(cwd);
+    // 扩展工厂：为每个 Pi 会话注册 send_file_to_chat 工具
+    const createRuntime = async ({ cwd: runtimeCwd, agentDir: runtimeAgentDir, sessionManager: runtimeSessionManager, sessionStartEvent, }) => {
+        const services = await createAgentSessionServices({
+            cwd: runtimeCwd,
+            agentDir: runtimeAgentDir,
+            resourceLoaderOptions: {
+                extensionFactories: [
+                    {
+                        name: "pi-remote-feishu-runtime",
+                        hidden: true,
+                        factory(pi) {
+                            pi.registerTool(createSendFileToChatTool(options.config));
+                        },
+                    },
+                ],
+            },
+        });
+        return {
+            ...(await createAgentSessionFromServices({
+                services,
+                sessionManager: runtimeSessionManager,
+                ...(sessionStartEvent ? { sessionStartEvent } : {}),
+            })),
+            services,
+            diagnostics: services.diagnostics,
+        };
+    };
+    const runtime = await createAgentSessionRuntime(createRuntime, {
+        cwd,
+        agentDir,
+        sessionManager,
+    });
+    await runtime.session.bindExtensions({});
+    return new RuntimeHost({
+        sessionKey: options.sessionKey,
+        runtime,
+        config: options.config,
+        channel: options.channel,
+    });
+}
+//# sourceMappingURL=runtime-host.js.map

package/dist/bridge/runtime-host.js.map

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

package/dist/bridge/session-host-manager.d.ts

@@ -0,0 +1,59 @@
+import type { FeishuChannel, FeishuConfig, FeishuIdentity, FeishuStore, SessionHost, SessionMapping } from "../types.js";
+import { PromptQueue } from "./prompt-queue.js";
+import { type RuntimeHost } from "./runtime-host.js";
+/** 被管理器管理的会话宿主：在 SessionHost 基础上增加 runtimeHost 和强类型 queue */
+interface ManagedSessionHost extends SessionHost {
+    runtimeHost: RuntimeHost;
+    queue: PromptQueue;
+}
+/**
+ * 会话宿主管理器：
+ * 以 sessionKey 为维度，在内存中维护一组 Pi 运行时实例，
+ * 并通过 FeishuStore 把"会话 key <-> 会话文件/工作目录"持久化到磁盘。
+ *
+ * 职责：
+ * - getHost：按需创建/复用运行时（懒加载）
+ * - newSession / switchToMapping / deleteMapping：会话生命周期管理
+ * - abort：中止当前生成
+ * - evictIdle：按 idleTtlMs 回收长时间不用的会话，释放内存
+ */
+export declare class SessionHostManager {
+    private readonly hosts;
+    private readonly config;
+    private readonly store;
+    private readonly channel;
+    constructor(options: {
+        config: FeishuConfig;
+        store: FeishuStore;
+        channel: FeishuChannel;
+    });
+    /**
+     * 获取（或创建）某个会话 key 的宿主。
+     * - 内存中已有：刷新 lastUsedAt 直接返回
+     * - 没有：查存储恢复历史会话（cwd、sessionFile），否则新建，并持久化映射
+     */
+    getHost(sessionKey: string, identity: FeishuIdentity): Promise<ManagedSessionHost>;
+    /** 只读查询内存中是否有该会话的宿主（不创建） */
+    getActiveHost(sessionKey: string): ManagedSessionHost | undefined;
+    /** 新建一个空会话（/new 命令），清空上下文并重新绑定扩展 */
+    newSession(sessionKey: string, identity: FeishuIdentity): Promise<void>;
+    /** 切换到另一个持久化的会话（/sessions 卡片上的"切换"按钮） */
+    switchToMapping(sessionKey: string, targetSessionKey: string, identity: FeishuIdentity): Promise<boolean>;
+    /** 中止当前生成（/stop 或卡片"停止生成"按钮）。没有活动会话时返回 false */
+    abort(sessionKey: string): Promise<boolean>;
+    /** 删除会话：先释放内存中的运行时，再删除持久化映射 */
+    deleteMapping(sessionKey: string): Promise<void>;
+    /** 列出全部持久化的会话映射 */
+    listMappings(): Promise<SessionMapping[]>;
+    /**
+     * 回收空闲会话：超过 idleTtlMs 未使用且当前没有生成任务的会话，
+     * 释放运行时并移出内存（下次使用会从磁盘恢复）。
+     */
+    evictIdle(now?: Date): Promise<void>;
+    /**
+     * 把宿主的会话信息持久化到 FeishuStore：
+     * 记录会话文件路径、工作目录、创建/更新时间，以及（私聊或 per-user 模式下）用户 id。
+     */
+    private persistHost;
+}
+export {};

package/dist/bridge/session-host-manager.js

@@ -0,0 +1,143 @@
+import { PromptQueue } from "./prompt-queue.js";
+import { createRuntimeHost } from "./runtime-host.js";
+/**
+ * 会话宿主管理器：
+ * 以 sessionKey 为维度，在内存中维护一组 Pi 运行时实例，
+ * 并通过 FeishuStore 把"会话 key <-> 会话文件/工作目录"持久化到磁盘。
+ *
+ * 职责：
+ * - getHost：按需创建/复用运行时（懒加载）
+ * - newSession / switchToMapping / deleteMapping：会话生命周期管理
+ * - abort：中止当前生成
+ * - evictIdle：按 idleTtlMs 回收长时间不用的会话，释放内存
+ */
+export class SessionHostManager {
+    hosts = new Map();
+    config;
+    store;
+    channel;
+    constructor(options) {
+        this.config = options.config;
+        this.store = options.store;
+        this.channel = options.channel;
+    }
+    /**
+     * 获取（或创建）某个会话 key 的宿主。
+     * - 内存中已有：刷新 lastUsedAt 直接返回
+     * - 没有：查存储恢复历史会话（cwd、sessionFile），否则新建，并持久化映射
+     */
+    async getHost(sessionKey, identity) {
+        const existing = this.hosts.get(sessionKey);
+        if (existing) {
+            existing.lastUsedAt = new Date();
+            return existing;
+        }
+        const mapping = await this.store.getSessionMapping(sessionKey);
+        const cwd = mapping?.cwd ?? this.config.sessions.defaultCwd ?? process.cwd();
+        const runtimeHost = await createRuntimeHost({
+            sessionKey,
+            cwd,
+            config: this.config,
+            channel: this.channel,
+            ...(mapping?.sessionFile ? { sessionFile: mapping.sessionFile } : {}),
+        });
+        const host = {
+            sessionKey,
+            runtime: runtimeHost.runtime,
+            runtimeHost,
+            queue: new PromptQueue(),
+            lastUsedAt: new Date(),
+        };
+        this.hosts.set(sessionKey, host);
+        await this.persistHost(host, identity);
+        return host;
+    }
+    /** 只读查询内存中是否有该会话的宿主（不创建） */
+    getActiveHost(sessionKey) {
+        return this.hosts.get(sessionKey);
+    }
+    /** 新建一个空会话（/new 命令），清空上下文并重新绑定扩展 */
+    async newSession(sessionKey, identity) {
+        const host = await this.getHost(sessionKey, identity);
+        await host.runtime.newSession();
+        await host.runtime.session.bindExtensions({});
+        await this.persistHost(host, identity);
+    }
+    /** 切换到另一个持久化的会话（/sessions 卡片上的"切换"按钮） */
+    async switchToMapping(sessionKey, targetSessionKey, identity) {
+        const target = await this.store.getSessionMapping(targetSessionKey);
+        if (!target)
+            return false;
+        const host = await this.getHost(sessionKey, identity);
+        await host.runtime.switchSession(target.sessionFile, { cwdOverride: target.cwd });
+        await host.runtime.session.bindExtensions({});
+        await this.persistHost(host, identity);
+        return true;
+    }
+    /** 中止当前生成（/stop 或卡片"停止生成"按钮）。没有活动会话时返回 false */
+    async abort(sessionKey) {
+        const host = this.hosts.get(sessionKey);
+        if (!host)
+            return false;
+        await host.runtimeHost.abort();
+        return true;
+    }
+    /** 删除会话：先释放内存中的运行时，再删除持久化映射 */
+    async deleteMapping(sessionKey) {
+        const host = this.hosts.get(sessionKey);
+        if (host) {
+            await host.runtimeHost.dispose();
+            this.hosts.delete(sessionKey);
+        }
+        await this.store.deleteSessionMapping(sessionKey);
+    }
+    /** 列出全部持久化的会话映射 */
+    async listMappings() {
+        return await this.store.listSessionMappings();
+    }
+    /**
+     * 回收空闲会话：超过 idleTtlMs 未使用且当前没有生成任务的会话，
+     * 释放运行时并移出内存（下次使用会从磁盘恢复）。
+     */
+    async evictIdle(now = new Date()) {
+        const expired = [];
+        for (const [key, host] of this.hosts) {
+            if (now.getTime() - host.lastUsedAt.getTime() > this.config.sessions.idleTtlMs && !host.activeRun) {
+                expired.push(key);
+            }
+        }
+        for (const key of expired) {
+            const host = this.hosts.get(key);
+            if (host) {
+                await host.runtimeHost.dispose();
+                this.hosts.delete(key);
+            }
+        }
+    }
+    /**
+     * 把宿主的会话信息持久化到 FeishuStore：
+     * 记录会话文件路径、工作目录、创建/更新时间，以及（私聊或 per-user 模式下）用户 id。
+     */
+    async persistHost(host, identity) {
+        const sessionFile = host.runtime.session.sessionFile;
+        if (!sessionFile)
+            return;
+        const now = new Date().toISOString();
+        const previous = await this.store.getSessionMapping(host.sessionKey);
+        await this.store.setSessionMapping({
+            sessionKey: host.sessionKey,
+            appId: this.config.appId,
+            chatType: identity.chatType,
+            chatId: identity.chatId,
+            cwd: host.runtime.cwd,
+            sessionFile,
+            createdAt: previous?.createdAt ?? now,
+            updatedAt: now,
+            ...(identity.tenantKey ? { tenantKey: identity.tenantKey } : {}),
+            ...(identity.chatType === "private" || this.config.sessions.groupScope === "per-user"
+                ? { userId: identity.userOpenId }
+                : {}),
+        });
+    }
+}
+//# sourceMappingURL=session-host-manager.js.map

package/dist/bridge/session-host-manager.js.map

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

package/dist/bridge/stream-renderer.d.ts

@@ -0,0 +1,50 @@
+import type { FeishuChannel, FeishuConfig } from "../types.js";
+/**
+ * ============================================================
+ * 流式渲染器
+ * ------------------------------------------------------------
+ * 把 Pi 会话运行过程中产生的事件流（文本增量、思考、工具调用、
+ * 压缩、自动重试等）实时转发成飞书流式 Markdown 消息。
+ *
+ * 支持三种渲染模式（config.rendering.mode）：
+ * - stream-card：默认。通过 channel.streamMarkdown 流式输出
+ * - text：不渲染任何事件，只跑 prompt（静默执行）
+ * ============================================================
+ */
+/** 助手消息事件（来自 Pi session 的事件流） */
+interface AssistantMessageEvent {
+    type: string;
+    delta?: string;
+    error?: unknown;
+}
+/** 运行时事件（Pi session 订阅到的事件） */
+interface RuntimeEvent {
+    type: string;
+    assistantMessageEvent?: AssistantMessageEvent;
+    toolName?: string;
+    partialResult?: unknown;
+    isError?: boolean;
+    attempt?: number;
+    maxAttempts?: number;
+    success?: boolean;
+}
+/** 可订阅会话接口：Pi 的 session 满足此结构 */
+export interface SubscribableSession {
+    subscribe(listener: (event: RuntimeEvent) => void): () => void;
+}
+export interface StreamRenderOptions {
+    config: FeishuConfig;
+    channel: FeishuChannel;
+    chatId: string;
+    replyTo?: string;
+    session: SubscribableSession;
+    runPrompt(): Promise<void>;
+}
+/**
+ * 运行一次 prompt 并渲染输出：
+ * - mode 为 text 时静默执行，不渲染
+ * - 其他模式通过 channel.streamMarkdown 创建流式消息，期间把会话事件
+ *   转发给 writer，消息发送完成后 Pi 侧会自动结束流
+ */
+export declare function renderPromptStream(options: StreamRenderOptions): Promise<void>;
+export {};