use std::{fmt, sync::Arc};
use serde_json::Value;
use stateknot_core::{BoundedJson, BoxFuture, Digest, ToolContext, ToolDescriptor, ToolInput};
use thiserror::Error;
use crate::{McpAuthorization, McpAuthorizationError, ProviderEndpoint};
pub fn mcp_tool_descriptor_digest(value: &Value) -> Result<Digest, McpToolDigestError> {
if !value.is_object() {
return Err(McpToolDigestError);
}
BoundedJson::try_from_value(value.clone()).map_err(|_| McpToolDigestError)?;
serde_json_canonicalizer::to_vec(value)
.map(Digest::sha256)
.map_err(|_| McpToolDigestError)
}
#[derive(Clone, Copy, Debug, Eq, Error, PartialEq)]
#[error("invalid MCP Tool descriptor for approval")]
pub struct McpToolDigestError;
#[derive(Clone)]
pub struct McpToolApproval {
pub(crate) digest: Digest,
pub(crate) authorizer: Arc<dyn McpToolAuthorizer>,
}
impl McpToolApproval {
pub fn new(digest: Digest, authorizer: Arc<dyn McpToolAuthorizer>) -> Self {
Self { digest, authorizer }
}
}
impl fmt::Debug for McpToolApproval {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("McpToolApproval")
.field("digest", &self.digest)
.finish_non_exhaustive()
}
}
pub struct McpToolAuthorizationRequest<'a> {
pub(crate) context: &'a ToolContext,
pub(crate) descriptor: &'a ToolDescriptor,
pub(crate) input: &'a ToolInput,
pub(crate) endpoint: &'a ProviderEndpoint,
pub(crate) remote_name: &'a str,
pub(crate) digest: Digest,
}
impl McpToolAuthorizationRequest<'_> {
pub const fn context(&self) -> &ToolContext {
self.context
}
pub const fn descriptor(&self) -> &ToolDescriptor {
self.descriptor
}
pub const fn input(&self) -> &ToolInput {
self.input
}
pub const fn endpoint(&self) -> &ProviderEndpoint {
self.endpoint
}
pub const fn remote_name(&self) -> &str {
self.remote_name
}
pub const fn tool_digest(&self) -> Digest {
self.digest
}
}
impl fmt::Debug for McpToolAuthorizationRequest<'_> {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("McpToolAuthorizationRequest")
.field("invocation_id", &self.context.invocation_id())
.field("attempt_id", &self.context.attempt_id())
.field("tool_digest", &self.digest)
.finish_non_exhaustive()
}
}
pub trait McpToolAuthorizer: Send + Sync + 'static {
fn resolve_startup(
&self,
descriptor: &ToolDescriptor,
) -> BoxFuture<'_, Result<McpAuthorization, McpAuthorizationError>>;
fn authorize_call<'a>(
&'a self,
request: McpToolAuthorizationRequest<'a>,
) -> BoxFuture<'a, Result<McpAuthorization, McpAuthorizationError>>;
}