Module operator 

The Operator protocol — what one operator does per cycle.

Structs

OperatorConfig

Per-operator configuration overrides. Every field is optional — None means “use the implementation’s default.”

OperatorInput

Input to an operator. Everything the operator needs to execute.

OperatorMetadata

Execution metadata. Every field is concrete (not optional) because every operator produces this data. Implementations that can’t track a field (e.g., cost for a local model) use zero/default.

OperatorOutput

Output from an operator. Contains the response, metadata about execution, and any side-effects the operator wants executed.

SubDispatchRecord

Record of a single sub-dispatch within an operator execution.

ToolMetadata

Metadata describing a tool/sub-operator’s external interface.

Enums

ExitReason

Why an operator invocation ended. The caller needs to know this to decide what happens next (retry? continue? escalate?).

TriggerType

What triggers an operator invocation. Informs context assembly — a scheduled trigger means you need to reconstruct everything from state, while a user message carries conversation context naturally.

Traits

Operator

Protocol ① — The Operator