Crate agent_sdk_toolkit 

Optional concrete tool-pack helpers for the Agent SDK.

This crate owns filesystem, search, edit, write, shell, resource-reader, discovery, and adapter-conformance helpers. agent-sdk-core stays product-neutral and only sees runtime-package capabilities, tool executor refs, policy refs, content refs, and effect lineage.

Re-exports

pub use agent_pool::SqliteAgentPoolStore;

pub use discovery::ToolDiscoveryExecutor;

pub use discovery::ToolDiscoveryIndex;

pub use discovery::ToolDiscoveryRequest;

pub use environment::AgentWorkspaceEnvironment;

pub use environment::AgentWorkspaceEnvironmentProfile;

pub use environment::EgressAllowlist;

pub use environment::EgressProtocol;

pub use environment::EgressTarget;

pub use environment::EnvironmentRuntime;

pub use evaluation::AgentTraceEvaluation;

pub use evaluation::AiTraceEvaluator;

pub use packs::AsyncTool;

pub use packs::Tool;

pub use packs::ToolBuilder;

pub use packs::ToolPackBuilder;

pub use packs::ToolkitPackBundle;

pub use packs::ToolkitToolExecutionMode;

pub use packs::tool_snapshot;

pub use protocol::JsonRpcErrorObject;

pub use protocol::JsonRpcFrame;

pub use protocol::JsonRpcId;

pub use protocol::JsonRpcLineCodec;

pub use protocol::JsonRpcLineEndpoint;

pub use protocol::JsonRpcNotification;

pub use protocol::JsonRpcRequest;

pub use protocol::JsonRpcResponse;

pub use resources::InMemoryResourceResolver;

pub use resources::ResourceReaderExecutor;

pub use resources::ResourceReaderRequest;

pub use shell::ShellExecutionPolicy;

pub use shell::ShellExecutor;

pub use shell::ShellRequest;

pub use shell::ShellResult;

pub use testing::InMemoryJsonArgumentStore;

pub use testing::InMemoryToolkitContentStore;

pub use typed_tool::AsyncToolRunner;

pub use typed_tool::FunctionTool;

pub use typed_tool::FunctionToolBuilder;

pub use typed_tool::JsonToolArgumentStore;

pub use typed_tool::JsonToolContentStore;

pub use typed_tool::ToolArgs;

pub use typed_tool::ToolError;

pub use typed_tool::ToolErrorKind;

pub use typed_tool::ToolIdentity;

pub use typed_tool::ToolOutput;

pub use typed_tool::ToolResult;

pub use typed_tool::ToolSchemaSnapshot;

pub use typed_tool::TypedTool;

pub use typed_tool::TypedToolBuilder;

pub use typed_tool::TypedToolContext;

pub use workspace::BoundedWorkspace;

pub use workspace::HashLineAnchor;

pub use workspace::SearchMatch;

pub use workspace::WorkspaceApplePhotosMetadata;

pub use workspace::WorkspaceArchiveEntry;

pub use workspace::WorkspaceArchiveMetadata;

pub use workspace::WorkspaceDocumentMetadata;

pub use workspace::WorkspaceEditExecutor;

pub use workspace::WorkspaceEditOutput;

pub use workspace::WorkspaceEditRequest;

pub use workspace::WorkspaceEmbeddedPreviewMetadata;

pub use workspace::WorkspaceFileKind;

pub use workspace::WorkspaceFileTypeConfidence;

pub use workspace::WorkspaceMediaMetadata;

pub use workspace::WorkspaceOcrMetadata;

pub use workspace::WorkspacePolicy;

pub use workspace::WorkspaceRawSensorMetadata;

pub use workspace::WorkspaceReadDetection;

pub use workspace::WorkspaceReadExecutor;

pub use workspace::WorkspaceReadOutput;

pub use workspace::WorkspaceReadRequest;

pub use workspace::WorkspaceReaderStep;

pub use workspace::WorkspaceResourceMetadata;

pub use workspace::WorkspaceSearchExecutor;

pub use workspace::WorkspaceSearchOutput;

pub use workspace::WorkspaceSearchRequest;

pub use workspace::WorkspaceSqliteMetadata;

pub use workspace::WorkspaceSqliteTableMetadata;

pub use workspace::WorkspaceWriteExecutor;

pub use workspace::WorkspaceWriteMode;

pub use workspace::WorkspaceWriteOutput;

pub use workspace::WorkspaceWriteRequest;

pub use agent_sdk_core;

pub use serde_json;

Modules

agent_pool

Public agent-pool toolkit namespace. Use it for concrete pool-store adapters layered over agent-sdk-core coordination ports. SQLite-backed agent-pool coordination store.

discovery

Tool discovery helpers for optional toolkit capabilities. Use these modules to index hidden candidates, return model-facing discovery results, and construct package deltas for host-approved activation. Searching is data-only; package mutation happens only when a delta is applied.

environment

Public environment namespace. Use it for data-only helpers that lower portable environment policy into core isolation contracts. Environment profile helpers layered over the core isolation contract. These builders are data-only: they produce core ExecutionEnvironment values, isolation sidecars, and network policy DTOs without starting containers, opening sockets, or configuring host firewalls.

evaluation

Public evaluation namespace. Use it for optional post-hoc agent-run evaluation helpers layered over agent-sdk-eval and core traces. Toolkit helpers for post-hoc agent-run evaluation.

packs

Public packs namespace. Use it for the documented packs API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. Toolkit pack assembly helpers. Use these modules to turn toolkit operations into core package capabilities, sidecars, and routes. Pack assembly is data-only and does not execute tools or mutate a runtime package until explicitly installed.

protocol

Public protocol namespace. Use it for the documented protocol API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. JSON-RPC protocol primitives and line-transport helpers.

resources

Public resources namespace. Use it for the documented resources API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. Resource-reader helpers layered over explicit URI resolvers and core content refs. Use these modules when a host wants toolkit tools to read approved resources. Resolver implementations own any backing-store or network side effects.

shell

Public shell namespace. Use it for the documented shell API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. Concrete shell tool helpers layered over core policy and effect contracts. Use these modules only behind host approval, sandbox, timeout, and network policy. Execution starts host processes; request and policy types are data-only.

testing

Public testing namespace. Use it for the documented testing API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. Toolkit-specific deterministic test helpers. Use these fakes for content stores, argument stores, and scripted protocol harnesses without live editors, MCP servers, or product hosts. Helpers mutate only in-memory state unless noted.

typed_tool

Public typed tool namespace. Use it for typed arguments, schemas, handlers, and executor adapters that lower into core tool execution. Typed tool authoring helpers layered over core tool execution ports. Helpers in this module build tool declarations and executors; execution, policy, approval, journals, events, and recovery remain owned by agent-sdk-core.

workspace

Public workspace namespace. Use it for the documented workspace API surface; prefer crate-root re-exports for common imports. Module items must preserve the toolkit ownership and side-effect boundaries described in this file. Workspace tool-pack helpers.