Expand description
Extension system for SynapsCLI.
Provides compiled-in hook call sites (HookBus) and external extension
runtimes that can subscribe to hooks, register tools, and register providers
via a stable JSON-RPC 2.0 protocol.
§Architecture
SynapsCLI binary
├─ HookBus (dispatcher) ← this module
├─ ExtensionManager (lifecycle) ← this module
└─ optional external extensions
└─ Process/JSON-RPC runtime ← phase 1Modules§
- active_
tasks - Generic active-task model for plugin-driven long-running work.
- audit
- Append-only provider invocation audit log.
- capability
- Unified capability snapshot for extensions.
- commands
- Plugin interactive command (
/command) output event types and parser. - config
- Config redaction helpers and diagnostics types for extensions.
- config_
store - Plugin-namespaced configuration store for extensions.
- hooks
- HookBus — the central dispatcher for extension hooks.
- info
- Extension-provided capability and build information returned by
info.get. - loader
- Async extension loading orchestration.
- manager
- Extension manager — discovers, starts, and manages extension lifecycles.
- manifest
- Extension manifest model and validation.
- permissions
- Permission model for extensions.
- providers
- runtime
- Extension runtime trait and registry.
- settings_
editor - Plugin custom-editor JSON-RPC payloads (Path B Phase 4).
- tasks
- Plugin long-running task notification types and parser.
- trust
- Per-provider trust state (enable/disable controls).
- validation
- Shared validation helpers for extension capability identifiers.