Module tools

Expand description

Tool definitions, dispatch, toolsets, the confirmation flow, and frames.

Modules§

dispatcher: Tool dispatcher — routes function calls to the right tool implementation.
policy: Per-tool execution policy — timeout, caching, and confirmation.
simple: Simple function tool that wraps an async closure.
typed: Type-safe function tool with auto-generated JSON Schema.

ActiveStreamingTool: Handle to a running streaming tool.
ConfirmationRequest: A request for confirmation of a sensitive tool call, handed to a ConfirmationProvider before the tool executes.
FrameSpec: The slot definition of a frame — the source of truth for what a stage that collects this frame must gather, plus the metadata that drives confirmation and repair.
PolicyTool: A ToolFunction decorator that enforces a ToolPolicy.
RecordExtractor: A TurnExtractor that runs an Extract record’s recognizers and resolvers, and promotes the recognized fields into state.
SimpleTool: Simple function tool that wraps an async closure.
SlotSpec: Metadata for a single slot within a FrameSpec.
StaticConfirmation: A ConfirmationProvider that approves or denies every request uniformly — handy for tests and “deny-all” / “allow-all” defaults.
StaticToolset: A simple toolset backed by a fixed list of tools.
ToolConfirmation: Represents a user’s confirmation decision for a tool call.
ToolDispatcher: Routes function calls to the right tool implementation.
ToolPolicy: Optional per-tool execution policy.
TypedTool: Type-safe function tool with auto-generated JSON Schema.

ConfirmPolicy: When a slot’s value should be confirmed back to the user before it is trusted.
Recognizer: A deterministic transcript recognizer: text -> (value, confidence).
SlotRecognizer: A serializable description of the deterministic recognizer that fills a slot.
SlotValidator: A serializable validator applied to a recognized slot value; a value failing it is rejected (the slot stays unfilled until a valid value is recognized).
ToolClass: Classification of a registered tool.
ToolKind: Unified tool storage.

ConfirmationProvider: Decides whether a confirmation-gated tool call may proceed.
InputStreamingTool: An input-streaming tool — receives duplicated live input while running.
StreamingTool: A streaming tool — runs in background, yields multiple results.
ToolFunction: A regular tool — called once, returns a result.
Toolset: A collection of tools that can be enumerated.