Module tools 

Extensible Tool System

Provides a trait-based abstraction for tools.

Architecture

ToolRegistry
  └── builtin tools (file, search, execution, web, and Code Intelligence queries)

Re-exports

pub use crate::dynamic_workflow::register_dynamic_workflow;

pub use task::parallel_task_params_schema;

pub use task::task_params_schema;

pub use task::ParallelTaskParams;

pub use task::ParallelTaskTool;

pub use task::TaskExecutor;

pub use task::TaskParams;

pub use task::TaskResult;

pub use task::TaskTool;

Modules

skill

Skill Tool - Invoke skills as callable tools with temporary permission grants

task

Task tools for delegated child runs.

Structs

AgentDirScriptTool

A named, pre-parameterized program script call.

ArtifactStore

ArtifactStoreLimits

ImmutableContentAdapterBindingV1

Secret-free identity of the host authority bound to one Code session.

ImmutableContentAdapterSession

Runtime pairing of a durable authority binding with one host adapter.

ImmutableContentDescriptorV1

Content identity computed by Code before a provider is called.

ImmutableContentReferenceV1

Provider-neutral immutable reference returned by the authorized adapter.

ImmutableContentWriteRequestV1

Borrowed provider request. Its Debug representation excludes content.

InvocationRuntime

Governed capabilities available to a tool during an agent/session invocation.

ProgramTool

ToolArtifact

ToolCapabilities

Execution properties used by orchestrators to make safe scheduling choices.

ToolContext

Tool execution context

ToolExecutor

Tool executor with workspace sandboxing

ToolOutput

Tool execution output

ToolPresentationProfileV1

Versioned, serializable Tool-presentation policy frozen by a Session and copied into each admitted Run.

ToolRegistry

Tool registry for managing all available tools

ToolResult

Tool execution result returned by direct tool execution.

ToolResultEvidenceV1

ToolResultTransformBindingV1

Bounded evidence that binds one Tool result to its exact deterministic transform algorithm and policy without copying Cloud or provider identity into Core.

ToolResultTransformPolicyV1

Enums

ImmutableContentError

Validation and provider failures at the immutable-content boundary.

ImmutableContentKindV1

Closed purpose for one retained original-content object.

ToolErrorKind

Structured discriminant for tool failures.

ToolOutputKind

Primary representation produced by a tool invocation.

ToolPresentationError

ToolPresentationModeV1

Closed presentation modes supported by the version-1 profile contract.

ToolResultLossModeV1

ToolStreamEvent

Events emitted by tools during execution

Constants

IMMUTABLE_CONTENT_ADAPTER_BINDING_SCHEMA_V1

IMMUTABLE_CONTENT_DESCRIPTOR_SCHEMA_V1

IMMUTABLE_CONTENT_REFERENCE_SCHEMA_V1

MAX_LINE_LENGTH

Maximum line length before truncation

MAX_OUTPUT_SIZE

Maximum output size in bytes before truncation

MAX_PROGRAM_SCRIPT_SOURCE_BYTES

MAX_READ_LINES

Maximum lines to read from a file

TOOL_PRESENTATION_PROFILE_V1_SCHEMA

TOOL_RESULT_CONTENT_MEDIA_TYPE

TOOL_RESULT_EVIDENCE_SCHEMA_V1

TOOL_RESULT_TOKEN_ESTIMATOR_V1

TOOL_RESULT_TRANSFORM_ALGORITHM_V1

TOOL_RESULT_TRANSFORM_BINDING_METADATA_KEY

TOOL_RESULT_TRANSFORM_BINDING_SCHEMA_V1

TOOL_RESULT_TRANSFORM_POLICY_DIGEST_DOMAIN_V1

TOOL_RESULT_TRANSFORM_SCHEMA_V1

Traits

ImmutableContentAdapter

Host port for create-only, exact-replay immutable content retention.

Tool

Tool trait - the core abstraction for all tools

Functions

register_generate_object

Register the generate_object tool for structured JSON output.

register_program

Register the programmatic tool calling wrapper.

register_program_with_catalog

Register the programmatic tool calling wrapper with a custom catalog.

register_task

Register the canonical task tool and hidden parallel_task compatibility alias.

register_task_with_mcp

Register the task delegation tools with optional MCP manager and parent context.

register_task_with_mcp_managers

Register task delegation tools with ordered MCP capability sources.

select_tools_for_messages

Select the tools that should be exposed to the model for this turn.

select_tools_for_prompt

Type Aliases

ImmutableContentResult

ToolEventSender

Sender for streaming tool output deltas during execution.