@dyyz1993/pi-coding-agent 0.74.24 → 0.74.27

package/dist/extensions/lsp/lsp/utils/dependency-resolver.ts

@@ -0,0 +1,147 @@
+import { readFile, readdir } from "node:fs/promises";
+import { basename, dirname, extname, join, relative, resolve } from "node:path";
+
+const SUPPORTED_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", ".next", ".nuxt", "coverage", "__pycache__"]);
+
+const IMPORT_PATTERNS = [
+	/import\s+(?:type\s+)?(?:[\w$*,\s{}]+)\s+from\s+['"]([^'"]+)['"]/g,
+	/require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+];
+
+export interface DependencyResolverOptions {
+	cwd?: string;
+	maxFilesToScan?: number;
+	maxDependents?: number;
+}
+
+export interface DependencyResolver {
+	resolveDependents(touchedFiles: string[]): Promise<string[]>;
+}
+
+export function createDependencyResolver(options: DependencyResolverOptions = {}): DependencyResolver {
+	const cwd = options.cwd ?? process.cwd();
+	const maxFilesToScan = options.maxFilesToScan ?? 300;
+	const maxDependents = options.maxDependents ?? 20;
+
+	return {
+		async resolveDependents(touchedFiles: string[]): Promise<string[]> {
+			if (touchedFiles.length === 0) return [];
+
+			const specifiers = buildModuleSpecifiers(touchedFiles, cwd);
+			if (specifiers.size === 0) return [];
+
+			const projectFiles = await collectProjectFiles(cwd, maxFilesToScan);
+			if (projectFiles.length === 0) return [];
+
+			const dependents = new Set<string>();
+
+			for (const projectFile of projectFiles) {
+				if (dependents.size >= maxDependents) break;
+
+				const normalized = projectFile.replace(/\\/g, "/");
+				if (touchedFiles.some((tf) => tf.replace(/\\/g, "/") === normalized)) continue;
+
+				try {
+					const content = await readFile(resolve(cwd, projectFile), "utf8");
+					const imports = extractImports(content);
+
+					for (const imp of imports) {
+						if (specifiers.has(imp)) {
+							dependents.add(normalized);
+							break;
+						}
+					}
+				} catch {
+					continue;
+				}
+			}
+
+			return [...dependents];
+		},
+	};
+}
+
+function buildModuleSpecifiers(touchedFiles: string[], cwd: string): Set<string> {
+	const specifiers = new Set<string>();
+
+	for (const filePath of touchedFiles) {
+		const absPath = resolve(cwd, filePath);
+		const dir = dirname(absPath);
+		const nameWithoutExt = basename(absPath, extname(absPath));
+		const indexName = nameWithoutExt === "index" ? "" : undefined;
+
+		const relDir = relative(cwd, dir).replace(/\\/g, "/");
+
+		if (relDir === "" || relDir === ".") {
+			specifiers.add(`./${nameWithoutExt}`);
+			if (indexName !== undefined) specifiers.add("./");
+		} else {
+			specifiers.add(`./${relDir}/${nameWithoutExt}`);
+			specifiers.add(`../${relDir}/${nameWithoutExt}`);
+			specifiers.add(relDir + "/" + nameWithoutExt);
+			if (indexName !== undefined) {
+				specifiers.add(`./${relDir}/`);
+				specifiers.add(`../${relDir}/`);
+				specifiers.add(relDir + "/");
+			}
+		}
+
+		if (nameWithoutExt === "index") {
+			const parentDir = basename(dir);
+			specifiers.add(`./${parentDir}`);
+			specifiers.add(parentDir);
+		}
+	}
+
+	return specifiers;
+}
+
+async function collectProjectFiles(cwd: string, maxFiles: number): Promise<string[]> {
+	const files: string[] = [];
+
+	async function walk(dir: string, depth: number): Promise<void> {
+		if (files.length >= maxFiles || depth > 10) return;
+
+		let entries;
+		try {
+			entries = await readdir(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+
+		for (const entry of entries) {
+			if (files.length >= maxFiles) return;
+
+			if (entry.isDirectory()) {
+				if (SKIP_DIRS.has(entry.name)) continue;
+				await walk(join(dir, entry.name), depth + 1);
+			} else if (entry.isFile()) {
+				const ext = extname(entry.name).toLowerCase();
+				if (SUPPORTED_EXTENSIONS.has(ext)) {
+					files.push(relative(cwd, join(dir, entry.name)).replace(/\\/g, "/"));
+				}
+			}
+		}
+	}
+
+	await walk(cwd, 0);
+	return files;
+}
+
+function extractImports(content: string): string[] {
+	const imports: string[] = [];
+
+	for (const pattern of IMPORT_PATTERNS) {
+		const regex = new RegExp(pattern.source, "g");
+		let match: RegExpExecArray | null;
+		while ((match = regex.exec(content)) !== null) {
+			const specifier = match[1];
+			if (specifier && (specifier.startsWith(".") || specifier.startsWith("/"))) {
+				imports.push(specifier);
+			}
+		}
+	}
+
+	return imports;
+}

package/dist/extensions/lsp/lsp/utils/diagnostics-wait.ts

@@ -0,0 +1,41 @@
+import type { LspRuntimeRegistry } from "../client/registry.js";
+
+export interface DiagnosticsWaitOptions {
+	initialDelayMs?: number;
+	pollIntervalMs?: number;
+	maxWaitMs?: number;
+}
+
+const DEFAULT_INITIAL_DELAY_MS = 500;
+const DEFAULT_POLL_INTERVAL_MS = 300;
+const DEFAULT_MAX_WAIT_MS = 2500;
+
+export async function waitForPushDiagnostics(
+	runtime: LspRuntimeRegistry,
+	filePath: string,
+	options: DiagnosticsWaitOptions = {},
+): Promise<void> {
+	const initialDelayMs = options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;
+	const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+	const maxWaitMs = options.maxWaitMs ?? DEFAULT_MAX_WAIT_MS;
+
+	await sleep(initialDelayMs);
+
+	const start = Date.now();
+	let previousCount = runtime.getPublishedDiagnostics(filePath).length;
+
+	if (previousCount > 0) return;
+
+	while (Date.now() - start < maxWaitMs) {
+		await sleep(pollIntervalMs);
+		const currentCount = runtime.getPublishedDiagnostics(filePath).length;
+		if (currentCount > 0) return;
+		if (currentCount !== previousCount) {
+			previousCount = currentCount;
+		}
+	}
+}
+
+function sleep(ms: number): Promise<void> {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/extensions/lsp/lsp/utils/lsp-helpers.d.ts

@@ -0,0 +1,20 @@
+export interface LspPosition {
+    line: number;
+    character: number;
+}
+export interface LspRange {
+    start: LspPosition;
+    end: LspPosition;
+}
+export interface LspDiagnostic {
+    range: LspRange;
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message: string;
+}
+export declare function normalizeRange(raw: unknown): LspRange | undefined;
+export declare function normalizePosition(raw: unknown): LspPosition | undefined;
+export declare function languageIdFromPath(filePath: string): string;
+export declare function extractPullDiagnostics(payload: unknown): LspDiagnostic[];
+//# sourceMappingURL=lsp-helpers.d.ts.map

package/dist/extensions/lsp/lsp/utils/lsp-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-helpers.d.ts","sourceRoot":"","sources":["lsp-helpers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAOjE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAKvE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmB3D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAoBxE","sourcesContent":["export interface LspPosition {\n\tline: number;\n\tcharacter: number;\n}\n\nexport interface LspRange {\n\tstart: LspPosition;\n\tend: LspPosition;\n}\n\nexport interface LspDiagnostic {\n\trange: LspRange;\n\tseverity?: number;\n\tcode?: string | number;\n\tsource?: string;\n\tmessage: string;\n}\n\nexport function normalizeRange(raw: unknown): LspRange | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst record = raw as Record<string, unknown>;\n\tconst start = normalizePosition(record.start);\n\tconst end = normalizePosition(record.end);\n\tif (!start || !end) return undefined;\n\treturn { start, end };\n}\n\nexport function normalizePosition(raw: unknown): LspPosition | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst record = raw as Record<string, unknown>;\n\tif (typeof record.line !== \"number\" || typeof record.character !== \"number\") return undefined;\n\treturn { line: record.line, character: record.character };\n}\n\nexport function languageIdFromPath(filePath: string): string {\n\tconst ext = filePath.split(\".\").pop()?.toLowerCase() ?? \"\";\n\tconst map: Record<string, string> = {\n\t\tts: \"typescript\",\n\t\ttsx: \"typescriptreact\",\n\t\tjs: \"javascript\",\n\t\tjsx: \"javascriptreact\",\n\t\tjson: \"json\",\n\t\tcss: \"css\",\n\t\thtml: \"html\",\n\t\tmd: \"markdown\",\n\t\tpy: \"python\",\n\t\trs: \"rust\",\n\t\tgo: \"go\",\n\t\tc: \"c\",\n\t\tcpp: \"cpp\",\n\t\tlua: \"lua\",\n\t};\n\treturn map[ext] ?? ext;\n}\n\nexport function extractPullDiagnostics(payload: unknown): LspDiagnostic[] {\n\tif (!payload || typeof payload !== \"object\") return [];\n\tconst record = payload as Record<string, unknown>;\n\tconst items = Array.isArray(record.items) ? record.items : [];\n\tconst diagnostics: LspDiagnostic[] = [];\n\tfor (const item of items) {\n\t\tif (!item || typeof item !== \"object\") continue;\n\t\tconst d = item as Record<string, unknown>;\n\t\tif (typeof d.message !== \"string\") continue;\n\t\tconst range = normalizeRange(d.range);\n\t\tif (!range) continue;\n\t\tdiagnostics.push({\n\t\t\trange,\n\t\t\tmessage: d.message,\n\t\t\tseverity: typeof d.severity === \"number\" ? d.severity : undefined,\n\t\t\tcode: typeof d.code === \"string\" || typeof d.code === \"number\" ? d.code : undefined,\n\t\t\tsource: typeof d.source === \"string\" ? d.source : undefined,\n\t\t});\n\t}\n\treturn diagnostics;\n}\n"]}

package/dist/extensions/lsp/lsp/utils/lsp-helpers.js

@@ -0,0 +1,64 @@
+export function normalizeRange(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const record = raw;
+    const start = normalizePosition(record.start);
+    const end = normalizePosition(record.end);
+    if (!start || !end)
+        return undefined;
+    return { start, end };
+}
+export function normalizePosition(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const record = raw;
+    if (typeof record.line !== "number" || typeof record.character !== "number")
+        return undefined;
+    return { line: record.line, character: record.character };
+}
+export function languageIdFromPath(filePath) {
+    const ext = filePath.split(".").pop()?.toLowerCase() ?? "";
+    const map = {
+        ts: "typescript",
+        tsx: "typescriptreact",
+        js: "javascript",
+        jsx: "javascriptreact",
+        json: "json",
+        css: "css",
+        html: "html",
+        md: "markdown",
+        py: "python",
+        rs: "rust",
+        go: "go",
+        c: "c",
+        cpp: "cpp",
+        lua: "lua",
+    };
+    return map[ext] ?? ext;
+}
+export function extractPullDiagnostics(payload) {
+    if (!payload || typeof payload !== "object")
+        return [];
+    const record = payload;
+    const items = Array.isArray(record.items) ? record.items : [];
+    const diagnostics = [];
+    for (const item of items) {
+        if (!item || typeof item !== "object")
+            continue;
+        const d = item;
+        if (typeof d.message !== "string")
+            continue;
+        const range = normalizeRange(d.range);
+        if (!range)
+            continue;
+        diagnostics.push({
+            range,
+            message: d.message,
+            severity: typeof d.severity === "number" ? d.severity : undefined,
+            code: typeof d.code === "string" || typeof d.code === "number" ? d.code : undefined,
+            source: typeof d.source === "string" ? d.source : undefined,
+        });
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=lsp-helpers.js.map

package/dist/extensions/lsp/lsp/utils/lsp-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-helpers.js","sourceRoot":"","sources":["lsp-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["export interface LspPosition {\n\tline: number;\n\tcharacter: number;\n}\n\nexport interface LspRange {\n\tstart: LspPosition;\n\tend: LspPosition;\n}\n\nexport interface LspDiagnostic {\n\trange: LspRange;\n\tseverity?: number;\n\tcode?: string | number;\n\tsource?: string;\n\tmessage: string;\n}\n\nexport function normalizeRange(raw: unknown): LspRange | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst record = raw as Record<string, unknown>;\n\tconst start = normalizePosition(record.start);\n\tconst end = normalizePosition(record.end);\n\tif (!start || !end) return undefined;\n\treturn { start, end };\n}\n\nexport function normalizePosition(raw: unknown): LspPosition | undefined {\n\tif (!raw || typeof raw !== \"object\") return undefined;\n\tconst record = raw as Record<string, unknown>;\n\tif (typeof record.line !== \"number\" || typeof record.character !== \"number\") return undefined;\n\treturn { line: record.line, character: record.character };\n}\n\nexport function languageIdFromPath(filePath: string): string {\n\tconst ext = filePath.split(\".\").pop()?.toLowerCase() ?? \"\";\n\tconst map: Record<string, string> = {\n\t\tts: \"typescript\",\n\t\ttsx: \"typescriptreact\",\n\t\tjs: \"javascript\",\n\t\tjsx: \"javascriptreact\",\n\t\tjson: \"json\",\n\t\tcss: \"css\",\n\t\thtml: \"html\",\n\t\tmd: \"markdown\",\n\t\tpy: \"python\",\n\t\trs: \"rust\",\n\t\tgo: \"go\",\n\t\tc: \"c\",\n\t\tcpp: \"cpp\",\n\t\tlua: \"lua\",\n\t};\n\treturn map[ext] ?? ext;\n}\n\nexport function extractPullDiagnostics(payload: unknown): LspDiagnostic[] {\n\tif (!payload || typeof payload !== \"object\") return [];\n\tconst record = payload as Record<string, unknown>;\n\tconst items = Array.isArray(record.items) ? record.items : [];\n\tconst diagnostics: LspDiagnostic[] = [];\n\tfor (const item of items) {\n\t\tif (!item || typeof item !== \"object\") continue;\n\t\tconst d = item as Record<string, unknown>;\n\t\tif (typeof d.message !== \"string\") continue;\n\t\tconst range = normalizeRange(d.range);\n\t\tif (!range) continue;\n\t\tdiagnostics.push({\n\t\t\trange,\n\t\t\tmessage: d.message,\n\t\t\tseverity: typeof d.severity === \"number\" ? d.severity : undefined,\n\t\t\tcode: typeof d.code === \"string\" || typeof d.code === \"number\" ? d.code : undefined,\n\t\t\tsource: typeof d.source === \"string\" ? d.source : undefined,\n\t\t});\n\t}\n\treturn diagnostics;\n}\n"]}

package/dist/extensions/lsp/lsp/utils/lsp-helpers.ts

@@ -0,0 +1,76 @@
+export interface LspPosition {
+	line: number;
+	character: number;
+}
+
+export interface LspRange {
+	start: LspPosition;
+	end: LspPosition;
+}
+
+export interface LspDiagnostic {
+	range: LspRange;
+	severity?: number;
+	code?: string | number;
+	source?: string;
+	message: string;
+}
+
+export function normalizeRange(raw: unknown): LspRange | undefined {
+	if (!raw || typeof raw !== "object") return undefined;
+	const record = raw as Record<string, unknown>;
+	const start = normalizePosition(record.start);
+	const end = normalizePosition(record.end);
+	if (!start || !end) return undefined;
+	return { start, end };
+}
+
+export function normalizePosition(raw: unknown): LspPosition | undefined {
+	if (!raw || typeof raw !== "object") return undefined;
+	const record = raw as Record<string, unknown>;
+	if (typeof record.line !== "number" || typeof record.character !== "number") return undefined;
+	return { line: record.line, character: record.character };
+}
+
+export function languageIdFromPath(filePath: string): string {
+	const ext = filePath.split(".").pop()?.toLowerCase() ?? "";
+	const map: Record<string, string> = {
+		ts: "typescript",
+		tsx: "typescriptreact",
+		js: "javascript",
+		jsx: "javascriptreact",
+		json: "json",
+		css: "css",
+		html: "html",
+		md: "markdown",
+		py: "python",
+		rs: "rust",
+		go: "go",
+		c: "c",
+		cpp: "cpp",
+		lua: "lua",
+	};
+	return map[ext] ?? ext;
+}
+
+export function extractPullDiagnostics(payload: unknown): LspDiagnostic[] {
+	if (!payload || typeof payload !== "object") return [];
+	const record = payload as Record<string, unknown>;
+	const items = Array.isArray(record.items) ? record.items : [];
+	const diagnostics: LspDiagnostic[] = [];
+	for (const item of items) {
+		if (!item || typeof item !== "object") continue;
+		const d = item as Record<string, unknown>;
+		if (typeof d.message !== "string") continue;
+		const range = normalizeRange(d.range);
+		if (!range) continue;
+		diagnostics.push({
+			range,
+			message: d.message,
+			severity: typeof d.severity === "number" ? d.severity : undefined,
+			code: typeof d.code === "string" || typeof d.code === "number" ? d.code : undefined,
+			source: typeof d.source === "string" ? d.source : undefined,
+		});
+	}
+	return diagnostics;
+}

package/dist/extensions/message-bridge/GUIDE.md

@@ -0,0 +1,210 @@
+# Message Bridge UI 拦截插件
+
+## 背景
+
+pi-coding-agent 的扩展系统支持 `ui` 事件拦截机制。扩展可以通过 `pi.on("ui", handler)` 拦截 `ctx.ui.confirm()`、`ctx.ui.select()`、`ctx.ui.input()`、`ctx.ui.notify()` 调用，将 UI 交互转发到外部系统（如移动端、Web 控制台），实现远程裁决。
+
+本插件将 pi 的 UI 交互桥接到 Message Bridge 服务，使 Agent 在执行过程中可以：
+1. 将 confirm/select/input/notify 推送到移动端或 Web 控制台
+2. 等待用户远程回复后注入结果
+3. Agent 完成后将最终输出推送，用户可回复触发新任务
+
+## Message Bridge 服务文档
+
+> 详见：[Message Bridge README](../../extensions/message-bridge/README.md)
+>
+> 服务地址：`https://message-bridge.docker.19930810.xyz:8443`
+>
+> API 端点：
+> - `POST /push` — 推送问题，返回消息 ID
+> - `GET /pull/{msg_id}` — 长轮询拉取回复（阻塞直到用户回复）
+> - `POST /answer/{msg_id}` — 提交回复
+> - `GET /messages` — 获取消息历史
+
+## 类型映射
+
+| pi `ctx.ui` 方法 | Message Bridge 推送格式 | 回复解析 |
+|---|---|---|
+| `confirm(title, message)` | `{type: "confirm", question: "..."}` | `"【确认】: 确定"` → `confirmed: true`<br>`"【确认】: 取消"` → `confirmed: false` |
+| `select(title, options)` | `{type: "radio", question: "...", options: [{label, description}]}` | `"【问题】: 选项A"` → `value: "选项A"` |
+| `input(title, placeholder)` | 纯文本 `"{title}\n\nPlaceholder: {placeholder}"` | 直接返回 answer |
+| `notify(message)` | 纯文本 | fire-and-forget，不等待回复 |
+
+## 事件处理流程
+
+### 1. UI 拦截（confirm/select/input）
+
+```
+Agent 调用 ctx.ui.confirm("Permission", "Deploy?")
+  → pi 触发 ui 事件，调用 handler
+  → handler 返回 {action: "responded", confirmed: true}
+     （short-circuit：原始 UI 不会被调用）
+  → 工具拿到 confirmed=true，继续执行
+```
+
+推荐写法（直接 await，不触发 race）：
+
+```typescript
+pi.on("ui", async (event, ctx) => {
+    if (event.method === "confirm") {
+        const question = { type: "confirm", question: `${event.title} - ${event.message}` };
+        const id = await pushQuestion(question, sessionId);
+        const answer = await pullAnswer(id);
+        return { action: "responded", confirmed: parseConfirmAnswer(answer) };
+    }
+    // select, input 同理...
+    return undefined;
+});
+```
+
+### 2. Agent 结束推送
+
+```
+Agent 完成所有任务 → 触发 agent_end 事件
+  → 插件将 assistant 回复拼接为纯文本
+  → push 到 Message Bridge
+  → pullAnswer 阻塞等待用户指令
+  → 用户回复 "继续做XXX" → pi.sendUserMessage("继续做XXX")
+  → Agent 开始新一轮处理
+```
+
+```typescript
+pi.on("agent_end", async (event) => {
+    const texts = event.messages
+        .filter(m => m.role === "assistant")
+        .map(m => extractText(m))
+        .filter(t => t.trim());
+    if (texts.length === 0) return;
+
+    const id = await pushQuestion(texts.join("\n\n---\n\n"), sessionId);
+    const answer = await pullAnswer(id);
+    if (answer?.trim()) {
+        pi.sendUserMessage(answer.trim());
+    }
+});
+```
+
+### 3. 时序图
+
+```mermaid
+sequenceDiagram
+    participant Agent as pi Agent
+    participant Tool as ask-confirm Tool
+    participant Runner as ExtensionRunner
+    participant Plugin as message-bridge Plugin
+    participant Bridge as Message Bridge
+    participant User as User (Mobile/Web)
+
+    Agent->>Tool: LLM 调用 ask-confirm
+    Tool->>Runner: ctx.ui.confirm("Permission", "Deploy?")
+    Runner->>Plugin: emitUIEvent({method:"confirm", ...})
+    Plugin->>Bridge: POST /push {type:"confirm", question:"..."}
+    Bridge-->>User: 推送通知
+    User->>Bridge: POST /answer "【确认】: 确定"
+    Bridge-->>Plugin: GET /pull 返回 answer
+    Plugin->>Runner: return {action:"responded", confirmed:true}
+    Runner->>Tool: return true (short-circuit)
+    Tool->>Agent: tool result
+
+    Note over Agent: Agent 完成...
+
+    Agent->>Plugin: agent_end event
+    Plugin->>Bridge: POST /push (最终文本)
+    Bridge-->>User: 推送通知
+    User->>Bridge: POST /answer "继续做XXX"
+    Bridge-->>Plugin: GET /pull 返回 answer
+    Plugin->>Agent: pi.sendUserMessage("继续做XXX")
+    Note over Agent: 开始新一轮处理
+```
+
+## pi 扩展 API 参考
+
+### 注册事件
+
+```typescript
+export default function myExtension(pi) {
+    // 拦截 UI 事件
+    pi.on("ui", async (event, ctx) => {
+        // event.type: "ui"
+        // event.id: string (唯一标识)
+        // event.method: "confirm" | "select" | "input" | "notify"
+        // event.title: string
+        // event.message?: string
+        // event.options?: string[]  (select 方法)
+        // event.placeholder?: string (input 方法)
+
+        // 返回 {action:"responded", ...} → short-circuit，原始 UI 不调用
+        // 返回 undefined → 放行到原始 UI
+        return { action: "responded", confirmed: true };
+    });
+
+    // 监听 Agent 结束
+    pi.on("agent_end", async (event) => {
+        // event.messages: AgentMessage[]
+        // 可以提取 assistant 文本推送
+    });
+}
+```
+
+### 注册工具
+
+```typescript
+pi.registerTool({
+    name: "ask-confirm",
+    label: "Ask Confirm",
+    description: "Asks a yes/no question",
+    parameters: Type.Object({ question: Type.String() }),
+    execute: async (id, params, signal, onUpdate, ctx) => {
+        // ctx.ui.confirm() → 被 ui 事件拦截
+        const confirmed = await ctx.ui.confirm("Title", params.question);
+        return { content: [{ type: "text", text: confirmed ? "yes" : "no" }] };
+    },
+});
+```
+
+### UIEvent 类型
+
+```typescript
+interface UIEvent {
+    type: "ui";
+    id: string;
+    method: "confirm" | "select" | "input" | "notify";
+    title: string;
+    message?: string;
+    options?: string[];       // select
+    placeholder?: string;     // input
+    notifyType?: "info" | "warning" | "error";
+}
+
+type UIEventResult = { action: "responded"; confirmed?: boolean; value?: string } | undefined;
+```
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `MESSAGE_BRIDGE_URL` | `https://message-bridge.docker.19930810.xyz:8443` | Bridge 服务地址 |
+| `MESSAGE_BRIDGE_SESSION_ID` | (空) | 可选 session 过滤 |
+
+## 启用方式
+
+```bash
+# CLI
+pi --extension ./extensions/message-bridge/index.ts
+
+# settings.json
+{ "extensions": ["./extensions/message-bridge/index.ts"] }
+```
+
+## 已验证场景
+
+| # | 场景 | 方式 |
+|---|---|---|
+| 1 | confirm → confirmed=true | 单元测试 + E2E + 真实 pi |
+| 2 | confirm → confirmed=false (取消) | 单元测试 + E2E |
+| 3 | select → radio 单选 | 单元测试 + E2E + 真实 pi |
+| 4 | select → 多选 JSON 解析 | 单元测试 |
+| 5 | input → 纯文本回复 | 单元测试 + E2E |
+| 6 | notify → fire-and-forget | 单元测试 + E2E |
+| 7 | agent_end → 推送最终文本 | 真实 pi |
+| 8 | agent_end → 回复触发 sendUserMessage 新任务 | 真实 pi |