rullama-tool-runtime 0.12.0

Tool execution runtime for the rullama agent framework — executor trait, registry, error taxonomy, sanitization, validation, transactions, smart router, plus optional orchestrator / OAuth / OpenAPI / sandbox / sessions / RAG-tool-search modules
docs.rs failed to build rullama-tool-runtime-0.12.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

rullama-tool-runtime

Crates.io Documentation License

The execution-runtime layer for rullama tool dispatch. Companion crate to rullama-tool-builtins, which provides the concrete bash / file_ops / git / web / etc. tools that this runtime knows how to dispatch.

What lives here

  • executor::ToolExecutor — the trait every tool dispatcher implements.
  • registry::ToolRegistry + ToolCategory — composable tool registry and category metadata.
  • error — tool-error taxonomy with retry classification.
  • sanitization — content-source tagging, injection detection, sensitive-data redaction.
  • tool_search::ToolSearchTool — meta-tool for keyword / regex / semantic tool discovery.
  • smart_router — query-driven category filtering.
  • transaction::TransactionManager — idempotency + staging for file-mutating tools (native).
  • validation::ValidationTool — duplicate / syntax / build checks (native).

Feature-gated runtime modules

Feature Module Notes
orchestrator (or orchestrator-wasm) orchestrator::OrchestratorTool Rhai script executor
oauth oauth OAuth 2.0 client, PKCE, pluggable token store
openapi openapi OpenAPI 3 spec → tool descriptor conversion
sandbox sandbox_executor::SandboxedToolExecutor Wrap any executor to route bash/code-exec through rullama-sandbox
sessions sessions::SessionsTool sessions_list / sessions_history / sessions_send / sessions_spawn over a rullama-session::SessionBroker
rag tool_embedding::ToolEmbeddingIndex RAG-backed semantic mode for ToolSearchTool

Usage

[dependencies]
rullama-tool-runtime = "0.12"
# Or, for the standard built-in tools too:
rullama-tool-builtins = "0.12"  # already pulls rullama-tool-runtime

use rullama_tool_runtime::{ToolExecutor, ToolRegistry};
use rullama_tool_builtins::{registry_with_builtins, BuiltinToolExecutor};

let registry = registry_with_builtins();
let executor = BuiltinToolExecutor::new(registry, Default::default());

See also

  • rullama-tool-builtins — concrete tools that plug into this runtime.
  • rullama — the umbrella facade with tools feature that re-exports both crates.

License

MIT OR Apache-2.0