Skip to content

cayu.testing.ProcessIsolatedTool

Part of cayu.testing.base. Read the Python API overview and install the required extra.

from cayu.testing import ProcessIsolatedTool

Explicit host-side tool executed by Cayu in a disposable POSIX process.

Decorators: @final.

Bases: Tool.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
spec ToolSpec required
ProcessIsolatedTool.__init__(spec: ToolSpec, *, factory: ProcessIsolatedToolFactoryRef, limits: ProcessIsolatedToolLimits, factory_config: dict[str, Any] | None=None, context_projection: ProcessIsolatedToolContextProjection | None=None, environment: dict[str, str] | None=None) -> None
ProcessIsolatedTool.name() -> str
ProcessIsolatedTool.execution_profile_identity() -> ExecutionProfileBehaviorIdentity | None

Return the stable behavior declaration frozen with this tool’s spec.

ProcessIsolatedTool.retain_arguments_for_model() -> bool

Retain bounded redacted original inputs privately for the same profile.

Independent of audit publication; oversized and compacted-away inputs may be omitted. This does not grant knowledge read or activation rights.

ProcessIsolatedTool.description() -> str
ProcessIsolatedTool.schema() -> dict[str, Any]
async ProcessIsolatedTool.run(ctx: ToolContext, args: dict[str, Any]) -> ToolResult
ProcessIsolatedTool.factory() -> ProcessIsolatedToolFactoryRef
ProcessIsolatedTool.limits() -> ProcessIsolatedToolLimits
ProcessIsolatedTool.context_projection() -> ProcessIsolatedToolContextProjection
ProcessIsolatedTool.factory_config_copy() -> dict[str, Any]
ProcessIsolatedTool.environment_copy() -> dict[str, str]

Release source · Runtime guarantees · Capability guides