agent_sdk_toolkit/lib.rs
1//! Optional concrete tool-pack helpers for the Agent SDK.
2//!
3//! This crate owns filesystem, search, edit, write, shell, resource-reader,
4//! discovery, and adapter-conformance helpers. `agent-sdk-core` stays
5//! product-neutral and only sees runtime-package capabilities, tool executor
6//! refs, policy refs, content refs, and effect lineage.
7
8pub use agent_sdk_core;
9pub use serde_json;
10
11/// Public agent-pool toolkit namespace. Use it for concrete pool-store
12/// adapters layered over `agent-sdk-core` coordination ports.
13pub mod agent_pool;
14pub mod discovery;
15/// Public environment namespace. Use it for data-only helpers that lower
16/// portable environment policy into core isolation contracts.
17pub mod environment;
18/// Public evaluation namespace. Use it for optional post-hoc agent-run
19/// evaluation helpers layered over `agent-sdk-eval` and core traces.
20pub mod evaluation;
21/// Public packs namespace. Use it for the documented packs API surface;
22/// prefer crate-root re-exports for common imports. Module items must
23/// preserve the toolkit ownership and side-effect boundaries described
24/// in this file.
25pub mod packs;
26/// Public protocol namespace. Use it for the documented protocol API
27/// surface; prefer crate-root re-exports for common imports. Module
28/// items must preserve the toolkit ownership and side-effect boundaries
29/// described in this file.
30pub mod protocol;
31/// Public resources namespace. Use it for the documented resources API
32/// surface; prefer crate-root re-exports for common imports. Module
33/// items must preserve the toolkit ownership and side-effect boundaries
34/// described in this file.
35pub mod resources;
36/// Public shell namespace. Use it for the documented shell API surface;
37/// prefer crate-root re-exports for common imports. Module items must
38/// preserve the toolkit ownership and side-effect boundaries described
39/// in this file.
40pub mod shell;
41/// Public testing namespace. Use it for the documented testing API
42/// surface; prefer crate-root re-exports for common imports. Module
43/// items must preserve the toolkit ownership and side-effect boundaries
44/// described in this file.
45pub mod testing;
46/// Public typed tool namespace. Use it for typed arguments, schemas, handlers,
47/// and executor adapters that lower into core tool execution.
48pub mod typed_tool;
49/// Public workspace namespace. Use it for the documented workspace API
50/// surface; prefer crate-root re-exports for common imports. Module
51/// items must preserve the toolkit ownership and side-effect boundaries
52/// described in this file.
53pub mod workspace;
54
55pub use agent_pool::SqliteAgentPoolStore;
56pub use discovery::{ToolDiscoveryExecutor, ToolDiscoveryIndex, ToolDiscoveryRequest};
57pub use environment::{
58 AgentWorkspaceEnvironment, AgentWorkspaceEnvironmentProfile, EgressAllowlist, EgressProtocol,
59 EgressTarget, EnvironmentRuntime,
60};
61pub use evaluation::{AgentTraceEvaluation, AiTraceEvaluator};
62pub use packs::{
63 AsyncTool, Tool, ToolBuilder, ToolPackBuilder, ToolkitPackBundle, ToolkitToolExecutionMode,
64 tool_snapshot,
65};
66pub use protocol::{
67 JsonRpcErrorObject, JsonRpcFrame, JsonRpcId, JsonRpcLineCodec, JsonRpcLineEndpoint,
68 JsonRpcNotification, JsonRpcRequest, JsonRpcResponse,
69};
70pub use resources::{InMemoryResourceResolver, ResourceReaderExecutor, ResourceReaderRequest};
71pub use shell::{ShellExecutionPolicy, ShellExecutor, ShellRequest, ShellResult};
72pub use testing::{InMemoryJsonArgumentStore, InMemoryToolkitContentStore};
73pub use typed_tool::{
74 AsyncToolRunner, FunctionTool, FunctionToolBuilder, JsonToolArgumentStore,
75 JsonToolContentStore, ToolArgs, ToolError, ToolErrorKind, ToolIdentity, ToolOutput, ToolResult,
76 ToolSchemaSnapshot, TypedTool, TypedToolBuilder, TypedToolContext,
77};
78pub use workspace::{
79 BoundedWorkspace, HashLineAnchor, SearchMatch, WorkspaceApplePhotosMetadata,
80 WorkspaceArchiveEntry, WorkspaceArchiveMetadata, WorkspaceDocumentMetadata,
81 WorkspaceEditExecutor, WorkspaceEditOutput, WorkspaceEditRequest,
82 WorkspaceEmbeddedPreviewMetadata, WorkspaceFileKind, WorkspaceFileTypeConfidence,
83 WorkspaceMediaMetadata, WorkspaceOcrMetadata, WorkspacePolicy, WorkspaceRawSensorMetadata,
84 WorkspaceReadDetection, WorkspaceReadExecutor, WorkspaceReadOutput, WorkspaceReadRequest,
85 WorkspaceReaderStep, WorkspaceResourceMetadata, WorkspaceSearchExecutor, WorkspaceSearchOutput,
86 WorkspaceSearchRequest, WorkspaceSqliteMetadata, WorkspaceSqliteTableMetadata,
87 WorkspaceWriteExecutor, WorkspaceWriteMode, WorkspaceWriteOutput, WorkspaceWriteRequest,
88};