# ctx 服务目录（生成物）

> 由 `scripts/gen-service-catalog.cjs`（经 tsx 运行 `src-ui/scripts/gen-service-catalog.ts`）
> 从组合层源码机械推导生成 — 勿手改；服务面变更后重新生成并同 commit。
> 不含时间戳：字节稳定是 `--check`（doc-sync 门禁）的前提。

共 23 个 ctx 服务：seam 5 · 贡献通道 10 · 服务 8。
kind 三分规则（机械推导）：ctx 键 ∈ SEAM_DOMAINS（seam-resolution.ts 单一真源）= seam；
类体含 `register(def: *Contribution)` = 贡献通道；其余 = 服务。

## swappable seam（能力契约层——可换实现）

| ctx 键 | Service | owner | 默认实现 / 贡献者 | 消费面 |
|---|---|---|---|---|
| `ctx.fs` | `FsService` | `src/composition/fs-service.ts` | `builtin/rust-fs` | 3 文件 |
| `ctx.llm` | `LlmService` | `src/composition/services.ts` | `builtin/anthropic` · `builtin/openai` · `builtin/responses` | 2 文件 |
| `ctx.sessionPersistence` | `SessionPersistenceService` | `src/composition/session-persistence-service.ts` | `builtin/rust-sessions` | 3 文件 |
| `ctx.shell` | `ShellService` | `src/composition/shell-service.ts` | — | 3 文件 |
| `ctx.subagents` | `SubagentsService` | `src/composition/subagent-service.ts` | `builtin/in-process` | 3 文件 |

### `ctx.fs` — FsService（swappable seam（可换实现））

fs 后端能力注册表（平台化 Phase 2 · D11）——默认 provider = builtin/rust-fs（agent/fs-provider.ts）；消费面 = agent/tools/coding.ts fs 域。

- owner：`src/composition/fs-service.ts`
- 默认实现 / 贡献者 id：`builtin/rust-fs`
- 消费面（3）：`src/composition/contract-version.ts` · `src/plugins/builtin/fs-builtin/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.llm` — LlmService（swappable seam（可换实现））

LLM adapter 注册表（S1-1 起；平台化 Phase 1 升格为 ctx.llm seam）—— 行注册 → disposer；请求期解析语义见 provider/index.ts 方言解析器。

- owner：`src/composition/services.ts`
- 默认实现 / 贡献者 id：`builtin/anthropic` · `builtin/openai` · `builtin/responses`
- 消费面（2）：`src/composition/contract-version.ts` · `src/plugins/builtin/llm-adapters/index.ts`

### `ctx.sessionPersistence` — SessionPersistenceService（swappable seam（可换实现））

会话持久化注册表（平台化 Phase 2 · D11）——默认 provider = builtin/rust-sessions（plugins/builtin/sessions-builtin）；消费面 = 产品会话卷持久化（chat-session/chat-core 四动作）。

- owner：`src/composition/session-persistence-service.ts`
- 默认实现 / 贡献者 id：`builtin/rust-sessions`
- 消费面（3）：`src/composition/contract-version.ts` · `src/plugins/builtin/sessions-builtin/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.shell` — ShellService（swappable seam（可换实现））

shell 后端能力注册表（平台化 Phase 2 · D11；subprocess 并入本 seam）—— 默认 provider = builtin/rust-shell（agent/shell-provider.ts）； 消费面 = agent/tools/coding.ts shell 域四工具。

- owner：`src/composition/shell-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面（3）：`src/composition/contract-version.ts` · `src/plugins/builtin/shell-builtin/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.subagents` — SubagentsService（swappable seam（可换实现））

子代理 provider 注册表（平台化 Phase 1 · D3）——默认 provider = 进程内实现 （agent/subagent-provider.ts）；消费面 = Agent.spawnSubAgent。

- owner：`src/composition/subagent-service.ts`
- 默认实现 / 贡献者 id：`builtin/in-process`
- 消费面（3）：`src/composition/contract-version.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts` · `src/plugins/builtin/subagent-in-process/index.ts`

## 贡献通道

| ctx 键 | Service | owner | 默认实现 / 贡献者 | 消费面 |
|---|---|---|---|---|
| `ctx.capabilities` | `CapabilitiesService` | `src/composition/capability-service.ts` | `my/capability` | 2 文件 |
| `ctx.commands` | `CommandsService` | `src/composition/services.ts` | `canvas/sidebar-toggle` · `compose/space-status` · `my/say-hi` · `paper/toggle` · `settings/toggle` | 5 文件 |
| `ctx.hooks` | `HooksService` | `src/composition/hook-service.ts` | `plan-injector` | 0 文件 |
| `ctx.overlays` | `OverlayService` | `src/composition/overlay-service.ts` | `asset-rack` · `compose-dock` · `paper-minimap` · `toc-strip` | 2 文件 |
| `ctx.panels` | `PanelsService` | `src/composition/services.ts` | `canvas-sidebar` · `canvas-spine` · `my-panel` · `paper` · `settings` | 4 文件 |
| `ctx.prompts` | `PromptsService` | `src/composition/prompt-service.ts` | `goal` · `my/section` | 2 文件 |
| `ctx.renderers` | `RenderersService` | `src/composition/renderer-service.tsx` | `my/kind` | 7 文件 |
| `ctx.rootViews` | `RootViewsService` | `src/composition/root-views-service.ts` | `ask-cards` · `sessions-home` | 2 文件 |
| `ctx.steps` | `StepsService` | `src/composition/steps-service.ts` | — | 0 文件 |
| `ctx.tools` | `ToolsService` | `src/composition/services.ts` | `communication-tools` · `compaction-tools` · `discovery-tools` · `hologram/browser-desktop-domain/tools` · `hologram/composition-domain/composition` · `merge-tools` · `my/dynamic-tool` · `my/query` · `request-tool` · `spawn-tool` | 7 文件 |

### `ctx.capabilities` — CapabilitiesService（贡献通道）

capability 贡献注册表（A-3 第八贡献通道）——贡献注册 → disposer； 下次 Agent 装配生效语义。

- owner：`src/composition/capability-service.ts`
- 默认实现 / 贡献者 id：`my/capability`
- 消费面（2）：`src/plugins/builtin/capability-segments/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.commands` — CommandsService（贡献通道）

命令注册表（S1-1）——def 注册 → disposer；即时生效语义。

- owner：`src/composition/services.ts`
- 默认实现 / 贡献者 id：`canvas/sidebar-toggle` · `compose/space-status` · `my/say-hi` · `paper/toggle` · `settings/toggle`
- 消费面（5）：`src/plugins/builtin/canvas-nav/index.ts` · `src/plugins/builtin/compose-dock/index.ts` · `src/plugins/builtin/paper-shell/index.ts` · `src/plugins/builtin/settings-domain/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.hooks` — HooksService（贡献通道）

工具管道钩子注册表（A-2）——enrich/preflight 贡献注册 → disposer； 下次 Agent 装配生效语义。

- owner：`src/composition/hook-service.ts`
- 默认实现 / 贡献者 id：`plan-injector`
- 消费面：—（无直接 import/ctx 引用——运行时通道注入）

### `ctx.overlays` — OverlayService（贡献通道）

画布覆盖层通道（Stage-4）：创作坞/目次带等视口固定形态经此注册， 由 PaperPanel 在对应槽位渲染。

- owner：`src/composition/overlay-service.ts`
- 默认实现 / 贡献者 id：`asset-rack` · `compose-dock` · `paper-minimap` · `toc-strip`
- 消费面（2）：`src/plugins/builtin/compose-dock/index.ts` · `src/plugins/builtin/paper-minimap/index.ts`

### `ctx.panels` — PanelsService（贡献通道）

面板注册表（S1-1）——def 注册 → disposer；即时生效语义。

- owner：`src/composition/services.ts`
- 默认实现 / 贡献者 id：`canvas-sidebar` · `canvas-spine` · `my-panel` · `paper` · `settings`
- 消费面（4）：`src/plugins/builtin/canvas-nav/index.ts` · `src/plugins/builtin/paper-shell/index.ts` · `src/plugins/builtin/settings-domain/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.prompts` — PromptsService（贡献通道）

system-prompt 段落注册表（A-1 第六贡献通道）——段注册 → disposer； 下次 Agent 装配生效。

- owner：`src/composition/prompt-service.ts`
- 默认实现 / 贡献者 id：`goal` · `my/section`
- 消费面（2）：`src/plugins/builtin/prompt-segments/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.renderers` — RenderersService（贡献通道）

块渲染器注册表（V3b 第五贡献通道）——def 注册 → disposer；即时生效。

- owner：`src/composition/renderer-service.tsx`
- 默认实现 / 贡献者 id：`my/kind`
- 消费面（7）：`src/plugins/builtin/host-modules.ts` · `src/plugins/builtin/paper-renderers/index.tsx` · `src/plugins/builtin/paper-shell/host.ts` · `src/plugins/builtin/renderers/components.tsx` · `src/plugins/builtin/renderers/index.tsx` · `src/plugins/builtin/skill-domain/builtin-skills.ts` · `src/plugins/service-plugins.ts`

### `ctx.rootViews` — RootViewsService（贡献通道）

App 外壳视图槽通道（批 9e）：首页（slot:'home'）与根浮层（slot:'overlay'） 由产物贡献，App.tsx 按槽渲染。

- owner：`src/composition/root-views-service.ts`
- 默认实现 / 贡献者 id：`ask-cards` · `sessions-home`
- 消费面（2）：`src/plugins/builtin/ask-cards/index.tsx` · `src/plugins/builtin/sessions-home/index.tsx`

### `ctx.steps` — StepsService（贡献通道）

步骤钩子注册表（agent-hooks-plan）——钩子贡献注册 → disposer； 下次 Agent 装配生效语义。

- owner：`src/composition/steps-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面：—（无直接 import/ctx 引用——运行时通道注入）

### `ctx.tools` — ToolsService（贡献通道）

工具注册表（S1-1）——行注册 → disposer；下次 Agent 装配生效语义。

- owner：`src/composition/services.ts`
- 默认实现 / 贡献者 id：`communication-tools` · `compaction-tools` · `discovery-tools` · `hologram/browser-desktop-domain/tools` · `hologram/composition-domain/composition` · `merge-tools` · `my/dynamic-tool` · `my/query` · `request-tool` · `spawn-tool`
- 消费面（7）：`src/plugins/builtin/browser-desktop-domain/index.ts` · `src/plugins/builtin/composition-domain/index.ts` · `src/plugins/builtin/contribution-helpers.ts` · `src/plugins/builtin/goal-mode/index.ts` · `src/plugins/builtin/skill-domain/builtin-skills.ts` · `src/plugins/mcp-bridge.ts` · `src/plugins/tool-declarations.ts`

## 服务

| ctx 键 | Service | owner | 默认实现 / 贡献者 | 消费面 |
|---|---|---|---|---|
| `ctx.activation` | `ActivationService` | `src/composition/activation-service.ts` | — | 1 文件 |
| `ctx.agentLoop` | `AgentLoopService` | `src/plugins/builtin/agent-loop-service/index.ts` | — | 1 文件 |
| `ctx.codeRuntime` | `CodeRuntimeService` | `src/agent/code-run/runtime-service.ts` | — | 0 文件 |
| `ctx.dynamicRunner` | `DynamicRunnerService` | `src/agent/dynamic-runner/dynamic-runner-service.ts` | — | 0 文件 |
| `ctx.lsp` | `LspService` | `src/ui/lsp-client.ts` | — | 0 文件 |
| `ctx.shellRows` | `ShellRowsService` | `src/composition/shell-rows-service.ts` | `plugin/hologram/settings-domain/shell-update-check` | 1 文件 |
| `ctx.space` | `SpaceService` | `src/composition/space-service.ts` | — | 1 文件 |
| `ctx.workspaces` | `WorkspacesService` | `src/composition/workspaces-service.ts` | — | 1 文件 |

### `ctx.activation` — ActivationService（服务）

插件激活账（S6 P3a）——登记 ≠ 激活：组合装配期按插件引用计数， 首次激活启动副作用、归零停止（设计件 §3.5）。

- owner：`src/composition/activation-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面（1）：`src/plugins/loader.ts`

### `ctx.agentLoop` — AgentLoopService（服务）

agent loop 注册表（平台化 Phase 5 · D13；S5b 产物化后类本体在 plugins/builtin/agent-loop-service/——此声明用结构面，内核/产物 双域类型检查共享）。

- owner：`src/plugins/builtin/agent-loop-service/index.ts`
- 默认实现 / 贡献者 id：—
- 消费面（1）：`src/plugins/builtin/skill-domain/builtin-skills.ts`

### `ctx.codeRuntime` — CodeRuntimeService（服务）

执行腰服务（P3）——run() 门面 + 绑定面归一；后端可换。

- owner：`src/agent/code-run/runtime-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面：—（无直接 import/ctx 引用——运行时通道注入）

### `ctx.dynamicRunner` — DynamicRunnerService（服务）

动态插件运行时（平台化 Phase 4 · D7）——define/run/stop/undefine/ inspect；沙箱宿主半见 agent/dynamic-runner/sandbox.ts。

- owner：`src/agent/dynamic-runner/dynamic-runner-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面：—（无直接 import/ctx 引用——运行时通道注入）

### `ctx.lsp` — LspService（服务）

- owner：`src/ui/lsp-client.ts`
- 默认实现 / 贡献者 id：—
- 消费面：—（无直接 import/ctx 引用——运行时通道注入）

### `ctx.shellRows` — ShellRowsService（服务）

壳行贡献通道（§4-9）：产物 apply 期 `register({ id, boot })` 登记， `bootShell` 在内置行之后按注册序执行。

- owner：`src/composition/shell-rows-service.ts`
- 默认实现 / 贡献者 id：`plugin/hologram/settings-domain/shell-update-check`
- 消费面（1）：`src/plugins/builtin/settings-domain/index.ts`

### `ctx.space` — SpaceService（服务）

画布空间 API（Stage-2）：读画布状态 + 订阅 + 空间命令。

- owner：`src/composition/space-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面（1）：`src/plugins/builtin/compose-dock/index.ts`

### `ctx.workspaces` — WorkspacesService（服务）

工作区接线贡献面（批 10）：产物 apply 期 `onActivate` 登记， 工作区激活点按注册序串行回调。

- owner：`src/composition/workspaces-service.ts`
- 默认实现 / 贡献者 id：—
- 消费面（1）：`src/plugins/builtin/bundled-engine/index.ts`