YeonGyu-Kim
6d66659025
- Core hooks: 39 -> 43 (Session 24, ToolGuard 14, Transform 5) - Total hooks: 48 -> 52 - Add transform hooks tier to plugin composition table - Update session/tool-guard hook name lists
55 lines
2.8 KiB
Markdown
55 lines
2.8 KiB
Markdown
# src/plugin/ — 10 OpenCode Hook Handlers + Hook Composition
|
|
|
|
**Generated:** 2026-04-05
|
|
|
|
## OVERVIEW
|
|
|
|
Core glue layer. 20 source files assembling the 10 OpenCode hook handlers and composing 50 hooks into the PluginInterface. Every handler file corresponds to one OpenCode hook type.
|
|
|
|
## HANDLER FILES
|
|
|
|
| File | OpenCode Hook | Purpose |
|
|
|------|---------------|---------|
|
|
| `config.ts` | `config` | 6-phase config loading pipeline |
|
|
| `tool-registry.ts` | `tool` | 26 tools assembled from factories |
|
|
| `chat-message.ts` | `chat.message` | First-message variant, session setup, keyword detection |
|
|
| `chat-params.ts` | `chat.params` | Anthropic effort level, think mode |
|
|
| `chat-headers.ts` | `chat.headers` | Copilot x-initiator header injection |
|
|
| `event.ts` | `event` | Session lifecycle (created, deleted, idle, error) |
|
|
| `tool-execute-before.ts` | `tool.execute.before` | Pre-tool guards (file guard, label truncator, rules injector) |
|
|
| `tool-execute-after.ts` | `tool.execute.after` | Post-tool hooks (output truncation, comment checker, metadata) |
|
|
| `messages-transform.ts` | `experimental.chat.messages.transform` | Context injection, thinking block validation |
|
|
| `session-compacting.ts` | `experimental.session.compacting` | Context + todo preservation during compaction |
|
|
| `skill-context.ts` | — | Skill/browser/category context for tool creation |
|
|
|
|
## HOOK COMPOSITION (hooks/ subdir)
|
|
|
|
| File | Tier | Count |
|
|
|------|------|-------|
|
|
| `create-session-hooks.ts` | Session | 23 |
|
|
| `create-tool-guard-hooks.ts` | Tool Guard | 14 |
|
|
| `create-transform-hooks.ts` | Transform | 5 |
|
|
| `create-skill-hooks.ts` | Skill | 2 |
|
|
| `create-core-hooks.ts` | Aggregator | Session + Guard + Transform = 42 |
|
|
|
|
## SUPPORT FILES
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `available-categories.ts` | Build `AvailableCategory[]` for agent prompt injection |
|
|
| `session-agent-resolver.ts` | Resolve which agent owns a session |
|
|
| `session-status-normalizer.ts` | Normalize session status across OpenCode versions |
|
|
| `recent-synthetic-idles.ts` | Dedup rapid idle events |
|
|
| `unstable-agent-babysitter.ts` | Track unstable agent behavior across sessions |
|
|
| `types.ts` | `PluginContext`, `PluginInterface`, `ToolsRecord`, `TmuxConfig` |
|
|
| `ultrawork-model-override.ts` | Ultrawork mode model override logic |
|
|
| `ultrawork-db-model-override.ts` | DB-level model override for ultrawork |
|
|
| `config-handler.ts` | Runtime config loading and caching |
|
|
|
|
## KEY PATTERNS
|
|
|
|
- Each handler exports a function receiving `(hookRecord, ctx, pluginConfig, managers)` → returns OpenCode hook function
|
|
- Handlers iterate over hook records, calling each hook with `(input, output)` in sequence
|
|
- `safeHook()` wrapper in composition files catches errors per-hook without breaking the chain
|
|
- Tool registry uses `filterDisabledTools()` before returning
|