Index
diapason.operators
¶
Operators — persistent, scheduled autonomous agents.
OperatorManager
¶
Manages operator manifests and their lifecycle via the TaskScheduler.
Parameters¶
system:
A DiapasonSystem instance (used to access scheduler, session_store,
memory_backend, and to run operators via system.ask()).
manifests
property
¶
All registered manifests.
activate(operator_id)
¶
Activate an operator by creating a scheduler task.
Returns the scheduler task ID (deterministic: operator:{id}).
Raises KeyError if the operator is not registered, or
RuntimeError if the scheduler is not available.
collect_metrics(operator_id, *, since=None, until=None)
¶
Collect telemetry metrics declared in the operator's manifest.
Reads the metrics list from :class:OperatorManifest and queries
the system's TelemetryAggregator (when available) for matching
statistics. Only fields explicitly listed in manifest.metrics are
returned, giving operators fine-grained control over what data they
expose.
Parameters¶
operator_id: ID of the registered operator. since: Optional Unix timestamp; restrict stats to records after this time. until: Optional Unix timestamp; restrict stats to records before this time.
Returns¶
Dict[str, Any]
Mapping of {metric_name: value} for every metric declared in
the manifest that could be resolved. Unknown metric names are
silently skipped and logged at DEBUG level.
Raises¶
KeyError If operator_id is not registered.
deactivate(operator_id)
¶
Deactivate an operator by cancelling its scheduler task.
discover(directory)
¶
Discover and register operator manifests from a directory.
Scans for *.toml files in directory and loads each as an
operator manifest.
get_manifest(operator_id)
¶
Return the manifest for an operator, or None.
pause(operator_id)
¶
Pause an active operator.
register(manifest)
¶
Register an operator manifest.
resume(operator_id)
¶
Resume a paused operator.
run_once(operator_id)
¶
Execute a single tick of an operator immediately.
Useful for development and testing. Returns the agent's response.
status()
¶
Return status of all registered operators.
Merges manifest info with scheduler task state.
OperatorManifest
dataclass
¶
Manifest describing a persistent autonomous operator.
load_operator(path)
¶
Load an operator manifest from a TOML file.
Supports inline system_prompt or external system_prompt_path
(resolved relative to the TOML file).