Expand description
Embeddable Talos agent runtime facade.
This crate is the SDK-style entrypoint for Rust projects that want to reuse Talos’s agent turn loop without depending on the Talos CLI or TUI crates.
Structs§
- Evaluator
Admission - Read-only admission policy for evaluator tools.
- Evaluator
Failure - Explicit non-PASS outcome when evaluation cannot safely produce a report.
- Evaluator
Request - The bounded, fresh context sent to an evaluator.
- Independent
Evaluator - Independent evaluator coordinator with bounded, fail-closed execution.
- Message
Tool Result - Result of a tool execution (message-layer).
- Provider
Evaluator Assessor - Provider-backed assessor that sends one tool-free request with a fresh context.
- Runtime
Builder - Builder for an embeddable Talos runtime.
- Runtime
Handle - Handle for interacting with a running embedded Talos runtime.
- Runtime
Hook Registry - Per-agent hook registry.
- Runtime
Shutdown Handle - Cloneable shutdown-only controller for one runtime.
- Runtime
Skill Index - Lightweight skill index entry for Level 0 progressive disclosure.
- Sandbox
Fallback Context - A redacted, typed request for a sandbox fallback decision.
- Shutdown
Finalizer Id - Code-owned identifier for a runtime shutdown finalizer.
- Shutdown
Finalizer Report - Redacted report entry for one fixed runtime-owned finalizer.
- Shutdown
Options - Validated options for one runtime shutdown request.
- Shutdown
Plan Id - Opaque identifier of the first accepted shutdown plan.
- Shutdown
Report - Immutable redacted result shared by every shutdown caller.
- Tool
Call - A tool call requested by the assistant.
- Tool
Definition - Usage
- Token usage statistics for a turn.
- Validation
Evidence - Provenance-preserving validation evidence made available to an evaluator.
Enums§
- Active
Turn Policy - Policy for the turn active when runtime admission closes.
- Agent
Event - Events emitted during a turn for streaming.
- Evaluator
Error - Errors raised before a safe evaluator outcome can be constructed.
- Evaluator
Outcome - Result of one independent evaluation attempt.
- Provider
Error - Runtime
Error - Errors returned by the embeddable runtime facade.
- Runtime
Preset - Explicit built-in capability preset for embedded runtimes.
- Runtime
Turn Completion Status - Sandbox
Fallback Decision - A dedicated sandbox fallback decision. It intentionally has no permanent or reusable approval variant.
- Sandbox
Fallback Policy - Controls what happens when a configured sandbox is unavailable.
- Shutdown
Active Turn Outcome - Redacted outcome for the turn active at the shutdown fence.
- Shutdown
Actor Outcome - Redacted actor containment outcome.
- Shutdown
Durable Outcome - Redacted durable pending-custody outcome.
- Shutdown
Finalizer Outcome - Redacted terminal outcome for one runtime-owned shutdown finalizer.
- Shutdown
Finalizer Registry Error - Validation failure for the frozen runtime-owned finalizer registry.
- Shutdown
Options Error - Validation errors for
ShutdownOptions. - Stop
Reason - Reason the assistant stopped generating.
- Tool
Nature - Categorizes a tool by its operational nature for permission decisions.
- Tool
Provenance - Provenance of a registered tool.
- Validation
Evidence Status - Validation status recorded in a bounded evidence snapshot.
Traits§
- Approval
Handler - Handles approval requests for permission-gated runtime tool calls.
- Evaluator
Assessor - A model assessor used by the independent evaluator. It cannot execute tools through this API.
Functions§
- collect_
until_ turn_ completed - Collects events until the current turn completes.
Type Aliases§
- Runtime
Result - Result alias for runtime facade operations.