@trim21/personal-pi-extensions 0.1.651 → 0.1.653

package/src/claude-code/search.ts

@@ -8,12 +8,13 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
+import type { ToolBus } from "../lib/tool-bus.js";
 import { registerGlobTool } from "./glob.js";
 import { registerGrepTool } from "./grep.js";
 
-export function registerSearchTools(pi: ExtensionAPI): void {
-  registerGlobTool(pi);
-  registerGrepTool(pi);
+export function registerSearchTools(bus: ToolBus, pi: ExtensionAPI): void {
+  registerGlobTool(bus);
+  registerGrepTool(bus, pi);
 }
 
 // Re-exported for tests that import pure functions from "./search.js"; the

package/src/claude-code/session-tools.ts

@@ -3,6 +3,7 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import { type Static, Type } from "typebox";
 import { Value } from "typebox/value";
 
+import type { ToolBus } from "../lib/tool-bus.js";
 import { selectMultiple, selectWithOptionalInput } from "../lib/ui.js";
 
 const TODO_STATUSES = ["pending", "in_progress", "completed"] as const;
@@ -121,7 +122,7 @@ async function askMultiple(
   return selected.length > 0 ? selected.join(", ") : "Unanswered";
 }
 
-export function registerSessionTools(pi: ExtensionAPI): void {
+export function registerSessionTools(bus: ToolBus, pi: ExtensionAPI): void {
   // TodoWrite 的列表随工具结果 details 持久化（跟随会话分支），但 widget 是
   // 纯 TUI 状态，进程重启后丢失。session 恢复时从当前分支取最后一个 TodoWrite
   // 的列表重新渲染（完整列表替换语义，后出现的覆盖前面的）。
@@ -139,7 +140,7 @@ export function registerSessionTools(pi: ExtensionAPI): void {
     }
   });
 
-  pi.registerTool({
+  bus.register({
     name: "TodoWrite",
     label: "Todo Write",
     description: [
@@ -177,7 +178,7 @@ export function registerSessionTools(pi: ExtensionAPI): void {
     },
   });
 
-  pi.registerTool({
+  bus.register({
     name: "AskUserQuestion",
     label: "Ask User Question",
     description: [

package/src/claude-code/shell.ts

@@ -13,12 +13,11 @@ import { Type } from "typebox";
 import {
   BashInterruptedError,
   type BwrapRuntime,
-  createBwrapRuntime,
   formatElapsedSeconds,
   sandboxHintBlock,
 } from "../bwrap/runtime.js";
 import { resolveWorkdir } from "../lib/path.js";
-import { createRequestPolicy } from "../lib/request-policy.js";
+import type { ToolBus } from "../lib/tool-bus.js";
 
 const DEFAULT_TIMEOUT_MS = 120_000;
 const MAX_TIMEOUT_MS = 7_200_000;
@@ -88,12 +87,8 @@ function formatBashSuccess(result: Awaited<ReturnType<BwrapRuntime["execute"]>>)
  * runtime 由调用方注入：扩展工厂持有一个实例（不依赖模块级全局状态），
  * 测试可注入预置模式的实例。状态随扩展实例生命周期，session 切换重建即重置。
  */
-export function registerShellTools(
-  pi: ExtensionAPI,
-  runtime: BwrapRuntime = createBwrapRuntime(createRequestPolicy(pi.events)),
-): void {
-  runtime.setup(pi);
-  pi.registerTool({
+export function registerShellTools(bus: ToolBus, pi: ExtensionAPI, runtime: BwrapRuntime): void {
+  bus.register({
     name: "Bash",
     promptSnippet: "execute command",
     promptGuidelines: [BASH_PROMPT],

package/src/gh/index.ts

@@ -36,6 +36,8 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
+import type { ToolBus } from "../lib/tool-bus.js";
+import { registerToolsOnSessionStart } from "../lib/tool-registration.js";
 import { GhClient, isGhAvailable } from "./base.js";
 import { addDownloadReleaseAssetsTool } from "./tools/download-release-assets.js";
 import { addGetWorkflowJobsTool } from "./tools/get-workflow-jobs.js";
@@ -62,20 +64,58 @@ export * from "./tools/download-release-assets.js";
 export * from "./tools/read-ci-logs.js";
 export * from "./tools/read-pr-status.js";
 
-export default function ghReadonlyTools(pi: ExtensionAPI) {
+/** 本工具集的工具：入口从它取注册函数（gh 不可用时返回 undefined）。 */
+export function createGithubTools(): { register(bus: ToolBus): void } | undefined {
   // Windows 上禁用：gh 可执行文件的探测（无扩展名 + POSIX 路径）与进程
   // 管理（SIGTERM 信号语义）都是 POSIX 假设，不做 Windows 适配。
   if (process.platform === "win32") {
-    pi.on("session_start", (_event, ctx) => {
-      ctx.ui.notify("gh-readonly tools are disabled on Windows.", "warning");
-    });
-    return;
+    return undefined;
   }
 
   // Fail fast: the `gh` CLI is the only backend for these tools. Without it the
   // extension registers nothing and reports the problem at session start, so
   // the user gets one clear error instead of a dozen failing tool calls.
   if (!isGhAvailable()) {
+    return undefined;
+  }
+
+  const gh = new GhClient();
+  return {
+    register(bus) {
+      addReadIssueTool(gh, bus);
+      addListIssuesTool(gh, bus);
+      addReadIssueCommentsTool(gh, bus);
+      addReadPrTool(gh, bus);
+      addListPrsTool(gh, bus);
+      addReadPrDiffTool(gh, bus);
+      addReadPrStatusTool(gh, bus);
+      addReadPrCommentsTool(gh, bus);
+      addReadCiLogsTool(gh, bus);
+      addListWorkflowRunsTool(gh, bus);
+      addGetWorkflowJobsTool(gh, bus);
+      addReadRepoTool(gh, bus);
+      addListReleasesTool(gh, bus);
+      addReadReleaseTool(gh, bus);
+      addDownloadReleaseAssetsTool(gh, bus);
+      addWaitPrChecksTool(gh, bus);
+      addWaitCommitChecksTool(gh, bus);
+      addWatchRunTool(gh, bus);
+    },
+  };
+}
+
+export default function ghReadonlyTools(pi: ExtensionAPI): void {
+  // Windows 上禁用：gh 可执行文件的探测与进程管理都是 POSIX 假设。
+  if (process.platform === "win32") {
+    pi.on("session_start", (_event, ctx) => {
+      ctx.ui.notify("gh-readonly tools are disabled on Windows.", "warning");
+    });
+    return;
+  }
+
+  // gh 不可用时一个工具都不注册，只在会话启动时报告一次问题。
+  const tools = createGithubTools();
+  if (!tools) {
     pi.on("session_start", (_event, ctx) => {
       ctx.ui.notify(
         "gh CLI not found in PATH: GitHub read-only tools are disabled. Install GitHub CLI (https://cli.github.com/) and reload the session.",
@@ -85,24 +125,7 @@ export default function ghReadonlyTools(pi: ExtensionAPI) {
     return;
   }
 
-  const gh = new GhClient();
-
-  addReadIssueTool(gh, pi);
-  addListIssuesTool(gh, pi);
-  addReadIssueCommentsTool(gh, pi);
-  addReadPrTool(gh, pi);
-  addListPrsTool(gh, pi);
-  addReadPrDiffTool(gh, pi);
-  addReadPrStatusTool(gh, pi);
-  addReadPrCommentsTool(gh, pi);
-  addReadCiLogsTool(gh, pi);
-  addListWorkflowRunsTool(gh, pi);
-  addGetWorkflowJobsTool(gh, pi);
-  addReadRepoTool(gh, pi);
-  addListReleasesTool(gh, pi);
-  addReadReleaseTool(gh, pi);
-  addDownloadReleaseAssetsTool(gh, pi);
-  addWaitPrChecksTool(gh, pi);
-  addWaitCommitChecksTool(gh, pi);
-  addWatchRunTool(gh, pi);
+  registerToolsOnSessionStart(pi, (bus) => {
+    tools.register(bus);
+  });
 }

package/src/gh/tools/download-release-assets.ts

@@ -2,11 +2,11 @@ import { mkdir, readdir, stat } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { Value } from "typebox/value";
 
 import { type ToolPendant } from "../../lib/pendant.js";
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   GhError,
@@ -203,8 +203,8 @@ export async function downloadReleaseAssets(
   };
 }
 
-export function addDownloadReleaseAssetsTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addDownloadReleaseAssetsTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "download-github-release-assets",
     label: "GitHub Release Download",
     description:

package/src/gh/tools/get-workflow-jobs.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   resolveRepo,
@@ -30,8 +30,8 @@ async function workflowJobs(gh: GhClient, call: ToolCall<RunIdParams>): Promise<
   return result;
 }
 
-export function addGetWorkflowJobsTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addGetWorkflowJobsTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "get-github-workflow-jobs",
     label: "GitHub Workflow Jobs",
     description:

package/src/gh/tools/list-issues.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   type ListFilters,
@@ -24,8 +24,8 @@ async function listIssues(gh: GhClient, call: ToolCall<ListFilters>): Promise<To
   return result;
 }
 
-export function addListIssuesTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addListIssuesTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "list-github-issues",
     label: "GitHub Issues List",
     description:

package/src/gh/tools/list-prs.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   type ListFilters,
@@ -24,8 +24,8 @@ async function listPrs(gh: GhClient, call: ToolCall<ListFilters>): Promise<ToolR
   return result;
 }
 
-export function addListPrsTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addListPrsTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "list-github-prs",
     label: "GitHub PRs List",
     description:

package/src/gh/tools/list-releases.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
 
-export function addListReleasesTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addListReleasesTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "list-github-releases",
     label: "GitHub Releases List",
     description: "List GitHub releases.",

package/src/gh/tools/list-workflow-runs.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
 
-export function addListWorkflowRunsTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addListWorkflowRunsTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "list-github-workflow-runs",
     label: "GitHub Workflow Runs",
     description: "List GitHub Actions workflow runs.",

package/src/gh/tools/read-ci-logs.ts

@@ -3,16 +3,15 @@
  * each executed step's block inside it, so the model can read the exact line
  * range of the step it needs.
  */
-
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
 import type { RunJob } from "../../lib/github.js";
 import { createSeqState } from "../../lib/seq-state.js";
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   ghExec,
@@ -422,8 +421,8 @@ async function ciLogs(gh: GhClient, call: ToolCall<JobIdParams>): Promise<ToolRe
   };
 }
 
-export function addReadCiLogsTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadCiLogsTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-ci-logs",
     label: "GitHub CI Logs",
     description:

package/src/gh/tools/read-issue-comments.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
-export function addReadIssueCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadIssueCommentsTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-issue-comments",
     label: "GitHub Issue Comments",
     description: "Get comments on a GitHub issue.",

package/src/gh/tools/read-issue.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
-export function addReadIssueTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadIssueTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-issue",
     label: "GitHub Issue",
     description: "Get details of a GitHub issue by number.",

package/src/gh/tools/read-pr-comments.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   ghApiList,
   type GhClient,
@@ -11,8 +11,8 @@ import {
   toToolResultJson,
 } from "../base.js";
 
-export function addReadPrCommentsTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadPrCommentsTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-pr-comments",
     label: "GitHub PR Comments",
     description:

package/src/gh/tools/read-pr-diff.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
 
-export function addReadPrDiffTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadPrDiffTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-pr-diff",
     label: "GitHub PR Diff",
     description: "Get the diff of a GitHub pull request.",

package/src/gh/tools/read-pr-status.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   mergeChecks,
@@ -52,8 +52,8 @@ export async function prStatus(gh: GhClient, call: ToolCall<PrStatusParams>): Pr
   };
 }
 
-export function addReadPrStatusTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadPrStatusTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-pr-status",
     label: "GitHub PR Status",
     description:

package/src/gh/tools/read-pr.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResultJson } from "../base.js";
 
-export function addReadPrTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadPrTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-pr",
     label: "GitHub PR",
     description: "Get details of a GitHub pull request by number.",

package/src/gh/tools/read-release.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, repoArgs, subtitlePendant, toToolResult } from "../base.js";
 
-export function addReadReleaseTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadReleaseTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-release",
     label: "GitHub Release",
     description: "Get details of a specific GitHub release by tag.",

package/src/gh/tools/read-repo.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, ghExec, subtitlePendant, toToolResult } from "../base.js";
 
-export function addReadRepoTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addReadRepoTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "read-github-repo",
     label: "GitHub Repo",
     description: "Get repository information.",

package/src/gh/tools/wait-commit-checks.ts

@@ -1,6 +1,6 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   resolveRepo,
@@ -53,8 +53,8 @@ async function waitCommitChecks(
   });
 }
 
-export function addWaitCommitChecksTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addWaitCommitChecksTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "wait-github-commit-checks",
     label: "Watch GitHub Commit Checks",
     description:

package/src/gh/tools/wait-pr-checks.ts

@@ -1,7 +1,7 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { Value } from "typebox/value";
 
+import type { ToolBus } from "../../lib/tool-bus.js";
 import {
   type GhClient,
   ghExec,
@@ -55,8 +55,8 @@ async function waitPrChecks(gh: GhClient, call: ToolCall<PrChecksWaitParams>): P
   });
 }
 
-export function addWaitPrChecksTool(gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addWaitPrChecksTool(gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "wait-github-pr-checks",
     label: "Watch GitHub PR Checks",
     description:

package/src/gh/tools/watch-run.ts

@@ -1,11 +1,11 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
 import { runGh } from "../../lib/gh-process.js";
+import type { ToolBus } from "../../lib/tool-bus.js";
 import { type GhClient, repoArgs, subtitlePendant } from "../base.js";
 
-export function addWatchRunTool(_gh: GhClient, pi: ExtensionAPI) {
-  pi.registerTool({
+export function addWatchRunTool(_gh: GhClient, bus: ToolBus) {
+  bus.register({
     name: "watch-github-run",
     label: "Watch GitHub Workflow Run",
     description:

package/src/index.ts

@@ -0,0 +1,120 @@
+/**
+ * 本仓库的统一扩展入口：所有工具都在这里注册。
+ *
+ * 为什么是单一入口：pi 给每个扩展入口单独的模块图，模块级状态不跨入口共享。
+ * 工具集中在一处之后，同一入口内的模块（codemode 等）才能看到并直接调用
+ * 全部工具；`personalExtensions` 配置（`fileIo` / `fileIoByModel` /
+ * `disabledTools` / `enabledTools`）也才有唯一的求值点。
+ *
+ * 注册时机：pi 在每次会话启动（启动、/new、resume、fork、/reload）时重建扩展，
+ * 所以在 `session_start` 里注册即「每个会话按自己的模型判定一次」。模型在扩展
+ * 加载期读不到（`ctx.model` 只在事件里），这是注册放在 session_start 的原因。
+ *
+ * 模块划分：两套文件 IO 工具集（claude-code / opencode）由 `ToolUnit` 表描述，
+ * 其余工具模块暴露 `createXxx(pi)`；各模块的默认导出保留给「按路径单独加载」
+ * （手工 `-e`），本入口直接调用 createXxx，因此一个实例里只有一份模块状态。
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+import { createAftTools } from "./aft/index.js";
+import { createClaudeCodeFileTools } from "./claude-code/files.js";
+import { createGithubTools } from "./gh/index.js";
+import type { ToolBus } from "./lib/tool-bus.js";
+import { createToolRegistration } from "./lib/tool-registration.js";
+import { createToolServices } from "./lib/tool-services.js";
+import { TOOL_UNITS, type ToolUnitDeps } from "./lib/tool-units.js";
+import { resolveFileIoToolset } from "./lib/tools-config.js";
+import { createOpencodeFileTools } from "./opencode/files.js";
+import { createSpawnAgentTool } from "./spawn-agent.js";
+import { createTalkTools } from "./talk/index.js";
+import { createVisionTools } from "./vision-agent.js";
+import { createWebFetch } from "./web/fetch.js";
+import { createWebSearchTool } from "./web/search.js";
+
+/** 只做工具注册、以及自己那些与会话无关的钩子的模块。 */
+interface ToolModule {
+  register(bus: ToolBus): void;
+}
+
+export default function personalExtensions(pi: ExtensionAPI): void {
+  const registration = createToolRegistration(pi);
+  // 共享服务要在 registration 之后创建：LSP manager 的 session_start handler 得
+  // 排在「记录本会话模型」的 handler 之后。
+  const services = createToolServices(pi);
+
+  // 与文件工具集无关的模块（各自在 create 里注册自己的会话钩子与提示）。
+  const modules: { name: string; module: ToolModule }[] = [];
+  const addModule = (name: string, module: ToolModule | undefined): void => {
+    if (module) {
+      modules.push({ name, module });
+    }
+  };
+  addModule("github", createGithubTools());
+  addModule("vision", createVisionTools());
+  addModule("talk", createTalkTools(pi));
+  addModule("spawn-agent", createSpawnAgentTool());
+  addModule("web_search", createWebSearchTool());
+  addModule("web_fetch", createWebFetch(pi));
+  const aft = createAftTools(pi);
+
+  // 注册期的失败攒起来，在会话启动时一次性上报（那里才有 UI）。
+  const warnings: string[] = [];
+
+  /** 单个模块/单元注册失败不影响其余：记下失败，继续注册。 */
+  function runModule<T>(name: string, run: () => T): T | undefined {
+    try {
+      return run();
+    } catch (error) {
+      warnings.push(`${name}: ${error instanceof Error ? error.message : String(error)}`);
+      return undefined;
+    }
+  }
+
+  registration.onSessionStart(async (bus, ctx) => {
+    // 配置解析期的警告是稳定的，注册期的失败每个会话重新收集（避免跨会话重复上报）。
+    warnings.length = 0;
+    warnings.push(...registration.config.warnings);
+
+    // 文件工具集跟着本会话的模型走（会话内切换模型不重建扩展，因此不重判）。
+    const kind = resolveFileIoToolset(registration.config, ctx.model);
+    const fileToolset =
+      kind === "opencode"
+        ? createOpencodeFileTools(pi, {
+            policy: services.policy,
+            bus,
+            manager: services.manager,
+          })
+        : createClaudeCodeFileTools(pi, {
+            policy: services.policy,
+            bus,
+            manager: services.manager,
+          });
+    services.setLspEnabledHandler((service) => fileToolset.onLspEnabled(bus, service));
+    runModule(kind, () => fileToolset.restoreReads(ctx));
+
+    const deps: ToolUnitDeps = {
+      pi,
+      bus,
+      policy: services.policy,
+      runtime: services.runtime,
+      fileToolset,
+    };
+    for (const unit of TOOL_UNITS[kind]) {
+      runModule(unit.tools.join("/"), () => unit.register(deps));
+    }
+
+    // aft 的二进制探测、bridge 状态与工具注册绑在一起（找不到二进制就不注册）。
+    await runModule("aft", () => aft.registerForSession(bus, ctx));
+    for (const { name, module } of modules) {
+      runModule(name, () => module.register(bus));
+    }
+
+    for (const warning of warnings) {
+      ctx.ui.notify(warning, "warning");
+    }
+    for (const { field, pattern } of registration.unmatchedPatterns()) {
+      ctx.ui.notify(`personalExtensions.${field}: pattern "${pattern}" matches no tool`, "warning");
+    }
+  });
+}