rskit-agent 0.2.0-alpha.1

Agentic loop — Provider + Tools + Hooks in a turn-based execution engine
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

use rskit_ai::StreamEventRef;
use rskit_llm::types::{AssistantMessage, Usage};
use rskit_tool::{ToolInput, ToolResult};

use super::AgentResult;

/// Events emitted during an agent run (for streaming / observability).
#[non_exhaustive]
pub enum AgentEvent {
    /// A new turn is starting.
    TurnStart {
        /// Turn number being started.
        turn: u32,
    },
    /// An LLM streaming event was received.
    LlmStreamEvent {
        /// Streaming event received from the LLM provider.
        event: StreamEventRef,
    },
    /// A tool is about to be executed.
    ToolExecuting {
        /// Provider tool-use identifier.
        tool_use_id: String,
        /// Tool name.
        name: String,
        /// Tool input payload.
        input: ToolInput,
    },
    /// A tool call completed.
    ToolComplete {
        /// Provider tool-use identifier.
        tool_use_id: String,
        /// Tool name.
        name: String,
        /// Successful tool result, when available.
        result: Option<ToolResult>,
        /// Error text, when execution failed.
        error: Option<String>,
    },
    /// Context was compacted to fit within the token budget.
    ContextCompacted {
        /// Previous approximate token count.
        old_tokens: usize,
        /// New approximate token count.
        new_tokens: usize,
    },
    /// A turn completed.
    TurnComplete {
        /// Completed turn number.
        turn: u32,
        /// Assistant message produced by the turn.
        message: AssistantMessage,
        /// Token usage for the turn.
        usage: Usage,
    },
    /// The agent run is complete.
    Complete {
        /// Final agent result.
        result: AgentResult,
    },
}