Files

T

YeonGyu-Kim 6d66659025 docs(src): update hook composition counts in src and plugin AGENTS.md

- 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

2026-04-05 14:12:30 +09:00

2.8 KiB

Raw Blame History

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

2.8 KiB Raw Blame History