Configuration Reference

On this page

PluginConfig (per-plugin runtime settings)
PluginManager constructor settings
PluginLoader constructor settings
PluginHotReloader constructor settings
ExecutionSandbox constructor settings

This page collects every configurable knob discoverable in the source, in one place. See each linked API page for full behavioral detail.

`PluginConfig` (per-plugin runtime settings)

Option	Type	Default	Accepted values	Runtime effect
`enabled`	`bool`	`True`	—	`safe_execute()` raises `PluginError` immediately if `False`
`timeout`	`float`	`30.0`	`> 0` (else `ValueError` at construction)	Per-call `asyncio.wait_for` timeout inside `safe_execute`
`max_retries`	`int`	`3`	`>= 0` (else `ValueError` at construction)	Number of extra attempts in `safe_execute_with_retry` (exponential backoff: `2**attempt` seconds)
`cache_results`	`bool`	`False`	—	Enables SHA-256-keyed in-memory result caching
`cache_ttl_sec`	`int`	`300`	any int	Cache entry lifetime in seconds
`custom`	`dict \| None`	`{}`	any dict	Free-form bag for plugin-specific settings; not interpreted by the framework

`PluginManager` constructor settings

Option	Type	Default	Runtime effect
`plugin_dirs`	`List[str] \| None`	`None`	Directories auto-scanned by `PluginLoader.discover_all()`
`system_version`	`str`	`"1.0.0"`	Compared against each plugin's `min_system_version`/`max_system_version` at registration
`safe_mode`	`bool`	`False`	Gates auto-permission-granting on `startup()` and permission checks on `register()`/`execute()`
`auto_discover`	`bool`	`True`	Whether `startup()` calls `loader.discover_all()`
`default_config`	`PluginConfig \| None`	`None` → `PluginConfig()`	Config applied to every plugin the loader instantiates
`embed_fn`	`Callable[[str], List[float]] \| None`	`None`	Enables semantic re-ranking in `AIPluginSelector`
`hard_timeout`	`float`	`60.0`	Constructs the manager's `ExecutionSandbox` — see the caveat in security.md about whether `execute()` currently uses it

`PluginLoader` constructor settings

Option	Type	Default	Runtime effect
`plugin_dirs`	`List[str] \| None`	`[]`	Directories scanned by `discover_all()` (non-recursive `*.py` glob, skips `_`-prefixed files)
`default_config`	`PluginConfig \| None`	`PluginConfig()`	Config given to every discovered plugin instance
`module_prefix`	`str`	`"rag_plugins"`	Synthetic module-name prefix used for `sys.modules` bookkeeping

`PluginHotReloader` constructor settings

Option	Type	Default	Runtime effect
`directories`	`List[str] \| None`	`loader.plugin_dirs`	Directories watched for `.py` changes
`poll_interval`	`float`	`1.0`	Seconds between mtime polls (ignored if `watchdog` backend is active)
`debounce_sec`	`float`	`0.5`	Minimum seconds between reloads of the same file

`ExecutionSandbox` constructor settings

Option	Type	Default	Runtime effect
`hard_timeout_sec`	`float`	`60.0`	`asyncio.wait_for` timeout for a wrapped coroutine
`log_slow_threshold`	`float`	`5.0`	Logs a warning (but still returns the result) if execution exceeds this

Related pages