Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
use crate::{RequestContext, ServiceContext};
use async_trait::async_trait;
use serde::Serialize;
/// Result type for tool calls, containing either the output or a [`ToolCallError`].
pub type ToolResult<T> = std::result::Result<T, ToolCallError>;
/// A unit type for tools that don't require any context.
pub struct NoContext();
/// Error type for failed tool calls.
///
/// Contains both an internal error for logging/debugging and a user-facing description.
#[derive(Debug)]
pub struct ToolCallError {
/// The underlying error that caused the tool call to fail.
pub internal_error: anyhow::Error,
/// A human-readable description of the error suitable for returning to the AI.
pub description: String,
}
impl std::fmt::Display for ToolCallError {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
write!(
f,
"description: {}. error: {}",
self.description, self.internal_error
)
}
}
/// Trait for asynchronous tools that can be called by an AI model.
///
/// # Type Parameters
///
/// - `Context`: Service context type (shared state like database connections)
#[async_trait]
pub trait AsyncTool<Context>: Sync + Send {
/// The output type produced by this tool.
type Output: Serialize + 'static;
/// Execute the tool asynchronously with the given contexts.
async fn call(
&self,
service_context: ServiceContext<Context>,
request_context: RequestContext,
) -> ToolResult<Self::Output>;
}