Skip to main content

Module extensions

Module extensions 

Source
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 1

Modules§

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.