behest-core 0.5.2

Core types for the behest agent runtime: messages, errors, tool definitions, and sans-IO run state machine
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

//! Streaming event schema for chat providers.

use serde::{Deserialize, Serialize};

use crate::id::{ModelName, ProviderId};
use crate::message::{FinishReason, TokenUsage};
use crate::tool_types::ToolCall;

/// Event emitted by a streaming chat provider.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case", tag = "type")]
#[non_exhaustive]
pub enum ChatStreamEvent {
    /// Stream has started.
    Started {
        /// Provider serving the stream.
        provider: ProviderId,
        /// Model serving the stream.
        model: ModelName,
    },
    /// Text delta produced by the model.
    TextDelta {
        /// Incremental text chunk.
        delta: String,
    },
    /// Tool call has started.
    ToolCallStarted {
        /// Provider-generated call identifier.
        id: String,
        /// Tool name requested by the model.
        name: String,
    },
    /// Tool call argument JSON delta.
    ToolCallArgumentsDelta {
        /// Provider-generated call identifier.
        id: String,
        /// Incremental argument chunk.
        delta: String,
    },
    /// Tool call has completed and can be executed.
    ToolCallCompleted {
        /// Completed tool call.
        call: ToolCall,
    },
    /// Stream has finished.
    Finished {
        /// Reason the provider stopped generation.
        finish_reason: FinishReason,
        /// Token accounting, when supplied by the provider.
        usage: Option<TokenUsage>,
    },
}