calute.operators.config

Configuration and shared constants for Calute operator tooling.

Defines the three operator tool-name sets (SAFE_OPERATOR_TOOLS, HIGH_POWER_OPERATOR_TOOLS, and ALL_OPERATOR_TOOLS) used by the policy engine to gate tool access, as well as the OperatorRuntimeConfig dataclass that holds all runtime-tuneable knobs.

calute.operators.config.ALL_OPERATOR_TOOLS: frozenset[str] = frozenset({'apply_patch', 'ask_user', 'close_agent', 'exec_command', 'resume_agent', 'send_input', 'spawn_agent', 'update_plan', 'view_image', 'wait_agent', 'web.click', 'web.finance', 'web.find', 'web.image_query', 'web.open', 'web.screenshot', 'web.search_query', 'web.sports', 'web.time', 'web.weather', 'write_stdin'})

Union of safe and high-power operator tool names.

calute.operators.config.HIGH_POWER_OPERATOR_TOOLS: frozenset[str] = frozenset({'apply_patch', 'close_agent', 'exec_command', 'resume_agent', 'send_input', 'spawn_agent', 'view_image', 'wait_agent', 'web.click', 'web.finance', 'web.find', 'web.image_query', 'web.open', 'web.screenshot', 'web.search_query', 'web.sports', 'web.weather', 'write_stdin'})

Operator tools that require explicit power_tools_enabled to be active. They can execute shell commands, modify files, spawn agents, or interact with external services.

class calute.operators.config.OperatorRuntimeConfig(enabled: bool = False, power_tools_enabled: bool = True, browser_headless: bool = True, browser_screenshot_dir: str | None = None, shell_default_workdir: str | None = None, shell_default_yield_ms: int = 1000, shell_default_max_output_chars: int = 4000, subagent_default_profile: calute.runtime.profiles.PromptProfile | str = PromptProfile.MINIMAL, subagent_default_timeout_ms: int = 30000, allowed_tool_names: set[str] = <factory>)

Bases: object

Opt-in runtime configuration for operator-style tools.

Encapsulates every knob that controls how the operator subsystem behaves: whether it is enabled at all, which power level is active, browser and shell defaults, and sub-agent profile settings.

enabled

Master switch that activates operator tooling in the runtime. When False, none of the operator tools are registered.

Type

bool

power_tools_enabled

When True, high-power tools (shell, patch, browser navigation, sub-agents) are made available. Defaults to True so newly created agents and spawned sub-agents can use the full operator toolset unless a caller opts into a narrower policy.

Type

bool

browser_headless

Whether the Playwright browser runs without a visible window.

Type

bool

browser_screenshot_dir

Optional directory for browser screenshots. When None, temporary directories are used.

Type

str | None

shell_default_workdir

Default working directory for new PTY sessions. None means the process working directory.

Type

str | None

shell_default_yield_ms

Default milliseconds to wait for initial PTY output before returning.

Type

int

shell_default_max_output_chars

Default maximum characters captured per PTY read operation.

Type

int

subagent_default_profile

Default prompt profile applied to newly spawned sub-agents.

Type

calute.runtime.profiles.PromptProfile | str

subagent_default_timeout_ms

Default timeout in milliseconds when waiting for sub-agent completion.

Type

int

allowed_tool_names

Set of tool names the policy engine should permit. Defaults to ALL_OPERATOR_TOOLS.

Type

set[str]

allowed_tool_names: set[str]

browser_headless: bool = True

browser_screenshot_dir: str | None = None

enabled: bool = False

power_tools_enabled: bool = True

shell_default_max_output_chars: int = 4000

shell_default_workdir: str | None = None

shell_default_yield_ms: int = 1000

subagent_default_profile: calute.runtime.profiles.PromptProfile | str = 'minimal'

subagent_default_timeout_ms: int = 30000

calute.operators.config.SAFE_OPERATOR_TOOLS: frozenset[str] = frozenset({'ask_user', 'update_plan', 'web.time'})

Operator tools that are always allowed, regardless of the power_tools_enabled flag. These are low-risk, read-only or informational tools.