| Name | Type | Description |
|---|---|---|
cwd* | Path | Session working directory. |
workspace_trusted | bool | Default: FalseWhether project-scoped hooks may be loaded for
|
config_dir | Path | None | Default: NoneAlternate user config directory for tests. |
transcript_root | Path | None | Default: None |
presenter | HookPresenter | None | Default: None |
plugin_sources | Sequence[tuple[PluginHooksSource, JsonValue]] | Default: () |
plugin_diagnostics | Sequence[HookDiagnostic] | Default: () |
Load configuration once and freeze a session runtime.
Alternate transcript store root for tests.
Defaults to ~/.deepagents/transcripts regardless of
config_dir (project and test hook configs must not relocate
the global transcript store).
Shared user-facing presenter. A private one is created when omitted, so output is logged rather than surfaced.
Hook documents contributed by enabled plugins, which the caller discovers so the runtime stays independent of plugin state. Merged last, holding the least authority.
Diagnostics the caller collected while
discovering plugin_sources.
