7b7526e2f6
- tools: 15 -> 16 dirs, writing model kimi-k2p5 -> gemini-3-flash - features: builtin skills 6 -> 8 (+review-work, +ai-slop-remover) - config: schema files 24 -> 27 (+git-env-prefix, model-capabilities, openclaw) - cli: commands 5 -> 6 (+refresh-model-capabilities) - plugin-handlers: 13 -> 14 non-test files - shared: 95+ -> 100+ utility files
2.3 KiB
2.3 KiB
src/plugin-handlers/ — 6-Phase Config Loading Pipeline
Generated: 2026-04-05
OVERVIEW
14 non-test files implementing the ConfigHandler — the config hook handler. Executes 6 sequential phases to register agents, tools, MCPs, and commands with OpenCode.
6-PHASE PIPELINE
| Phase | Handler | Purpose |
|---|---|---|
| 1 | applyProviderConfig |
Cache model context limits, detect anthropic-beta headers |
| 2 | loadPluginComponents |
Discover Claude Code plugins (10s timeout, error isolation) |
| 3 | applyAgentConfig |
Load agents from 5 sources, skill discovery, plan demotion |
| 4 | applyToolConfig |
Agent-specific tool permissions |
| 5 | applyMcpConfig |
Merge builtin + CC + plugin MCPs |
| 6 | applyCommandConfig |
Merge commands/skills from 9 parallel sources |
FILES
| File | Lines | Purpose |
|---|---|---|
config-handler.ts |
~200 | Main orchestrator, 6-phase sequential |
plugin-components-loader.ts |
~100 | CC plugin discovery (10s timeout) |
agent-config-handler.ts |
~300 | Agent loading + skill discovery from 5 sources |
mcp-config-handler.ts |
~150 | Builtin + CC + plugin MCP merge |
command-config-handler.ts |
~200 | 9 parallel sources for commands/skills |
tool-config-handler.ts |
~100 | Agent-specific tool grants/denials |
provider-config-handler.ts |
~80 | Provider config + model cache |
prometheus-agent-config-builder.ts |
~100 | Prometheus config with model resolution |
plan-model-inheritance.ts |
28 | Plan demotion logic |
agent-priority-order.ts |
~30 | sisyphus, hephaestus, prometheus, atlas first |
agent-key-remapper.ts |
~30 | Agent key → display name |
category-config-resolver.ts |
~40 | User vs default category lookup |
index.ts |
~10 | Barrel exports |
TOOL PERMISSIONS
| Agent | Granted | Denied |
|---|---|---|
| Librarian | grep_app_* | — |
| Atlas, Sisyphus, Prometheus | task, task_*, teammate | — |
| Hephaestus | task | — |
| Default (all others) | — | grep_app_, task_, teammate, LSP |
MULTI-LEVEL CONFIG MERGE
User (~/.config/opencode/oh-my-opencode.jsonc)
↓ deepMerge
Project (.opencode/oh-my-opencode.jsonc)
↓ Zod defaults
Final Config
agents,categories,claude_code: deep mergeddisabled_*arrays: Set union