open-standards/eoc/eoc-rs/crates/eoc-tools/src/error.rs
Transaction Science 3fe109d58f ingest batch 4: 9 crates · table-stakes completers across all three workspaces
OpenPay (3 crates, ~13k LOC, 175 tests)
  op-connect           sub-merchant onboarding + KYB + split-payments + payouts + 1099-K
  op-3ds2              3DS2.3 SCA processor (AReq/ARes/CReq/CRes/RReq/RRes + exemptions)
  op-tax               US/EU/UK/AU/CA/IN tax with Avalara/Stripe/CCH/Vertex/TaxJar adapters

Smart Byte (3 crates, ~7k LOC, 57 tests)
  smart-byte-libp2p    libp2p transport (kad/gossipsub/mdns/autonat/relay/dcutr/identify/ping/req_resp)
  smart-byte-crdt      LWW/GCounter/PnCounter/OrSet/LwwMap/RgaList/2P-Set + HLC + vector clock + Automerge/Yjs interop
  smart-byte-keri-witness  KERI key-rotation cycle + witness layer + watchers + recovery + delegation

EOC (3 crates, ~8k LOC, 108 tests)
  eoc-tools            function-calling across Anthropic/OpenAI/Google/Mistral/Cohere + parallel exec + sandbox
  eoc-multimodal       vision (CLIP/SigLIP/ColPali) + audio (Whisper/MMS) + video sampling + modality router
  eoc-spec-decode      vanilla + SpS-with-temp + lookahead speculative decoding + EAGLE/Medusa stubs

All three workspaces compile cleanly. Forbidden-unsafe, no unwrap outside tests.

Co-Authored-By: Claude Opus 4.7 <[email protected]>
2026-05-24 04:00:04 -04:00

92 lines
2.4 KiB
Rust

//! Typed errors for the tool-use substrate.
use thiserror::Error;
/// Errors that can arise from schema generation, dispatch, vendor
/// translation, parallel execution, or the orchestration loop.
#[derive(Debug, Error)]
pub enum ToolError {
/// The requested tool is not registered.
#[error("tool not registered: {0}")]
NotRegistered(String),
/// Argument validation against the tool's JSON Schema failed.
#[error("argument validation failed for `{tool}`: {reason}")]
InvalidArguments {
/// Tool name.
tool: String,
/// Human-readable reason.
reason: String,
},
/// The tool itself returned an error.
#[error("tool execution failed: {0}")]
Execution(String),
/// A vendor schema translation failed.
#[error("schema translation error: {0}")]
SchemaTranslation(String),
/// Failed to parse a vendor response for tool-call requests.
#[error("vendor response parse error: {0}")]
VendorParse(String),
/// A tool call timed out.
#[error("tool `{0}` timed out")]
Timeout(String),
/// A safety policy denied the call.
#[error("policy denied call to `{tool}`: {reason}")]
PolicyDenied {
/// Tool name.
tool: String,
/// Human-readable reason.
reason: String,
},
/// A sandbox primitive rejected the call (e.g. allowlist).
#[error("sandbox denial in `{tool}`: {reason}")]
SandboxDenied {
/// Tool name.
tool: String,
/// Human-readable reason.
reason: String,
},
/// I/O failure.
#[error("io error: {0}")]
Io(String),
/// HTTP failure.
#[error("http error: {0}")]
Http(String),
/// JSON encode/decode failure.
#[error("serde error: {0}")]
Serde(String),
/// The tool loop exceeded its iteration cap.
#[error("tool loop hit max_iterations ({0})")]
MaxIterations(usize),
}
impl From<serde_json::Error> for ToolError {
fn from(e: serde_json::Error) -> Self {
ToolError::Serde(e.to_string())
}
}
impl From<std::io::Error> for ToolError {
fn from(e: std::io::Error) -> Self {
ToolError::Io(e.to_string())
}
}
impl From<reqwest::Error> for ToolError {
fn from(e: reqwest::Error) -> Self {
ToolError::Http(e.to_string())
}
}
/// Convenience `Result` alias.
pub type ToolResult<T> = std::result::Result<T, ToolError>;