everruns-contracts 0.44.0

Shared runtime, provider, capability, and model profile contracts for Everruns
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! Neutral hook seam for capability-owned transforms after model tool calls
//! have been finalized and before the assistant message is persisted.

use async_trait::async_trait;

use crate::runtime::event_emitter::EventEmitter;
use crate::runtime::execution_context::ExecutionContext;
use crate::runtime::tool_types::{ToolCall, ToolDefinition};
use crate::runtime::typed_id::SessionId;

/// A finalized model tool call that must fail before tool dispatch.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct FinalizedToolCallRejection {
    /// Provider-assigned identifier of the rejected call.
    pub tool_call_id: String,
    /// Error returned to the model as the tool result.
    pub error: String,
}

/// Per-turn context supplied to finalized tool-call hooks.
pub struct FinalizedToolCallsContext<'a> {
    pub event_emitter: &'a dyn EventEmitter,
    pub session_id: SessionId,
    pub execution_context: &'a ExecutionContext,
    pub tool_definitions: &'a [ToolDefinition],
    pub iteration: u32,
}

/// Capability-owned transform over a completed model tool-call batch.
#[async_trait]
pub trait FinalizedToolCallsHook: Send + Sync {
    async fn apply(&self, context: &FinalizedToolCallsContext<'_>, calls: &mut [ToolCall]);

    /// Apply transforms and return calls that must enter the ordinary tool-error path.
    ///
    /// The default preserves existing transform-only hook behavior.
    async fn apply_with_rejections(
        &self,
        context: &FinalizedToolCallsContext<'_>,
        calls: &mut [ToolCall],
    ) -> Vec<FinalizedToolCallRejection> {
        self.apply(context, calls).await;
        Vec::new()
    }
}