orbital-discussion 0.1.1

Composable discussion and reply-thread components for Orbital
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use serde::{Deserialize, Serialize};
use serde_json::Value;

/// Lifecycle status for a tool invocation part.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub enum DiscussionToolRunStatus {
    #[default]
    Running,
    Success,
    Error,
    AwaitingApproval,
    Denied,
}

impl DiscussionToolRunStatus {
    pub fn as_str(&self) -> &'static str {
        match self {
            Self::Running => "running",
            Self::Success => "success",
            Self::Error => "error",
            Self::AwaitingApproval => "awaiting-approval",
            Self::Denied => "denied",
        }
    }
}

/// Tool invocation content part inside an agent reply body.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct DiscussionToolPart {
    pub tool_call_id: String,
    pub tool_name: String,
    pub input: Value,
    pub output: Option<Value>,
    pub status: DiscussionToolRunStatus,
    pub error_message: Option<String>,
}

impl DiscussionToolPart {
    pub fn new(
        tool_call_id: impl Into<String>,
        tool_name: impl Into<String>,
        input: Value,
    ) -> Self {
        Self {
            tool_call_id: tool_call_id.into(),
            tool_name: tool_name.into(),
            input,
            output: None,
            status: DiscussionToolRunStatus::Running,
            error_message: None,
        }
    }
}

/// User decision on a tool approval gate.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct ToolApprovalDecision {
    pub tool_call_id: String,
    pub reply_id: String,
    pub approved: bool,
    pub reason: Option<String>,
}

/// Streaming lifecycle for a reasoning (thinking) part.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub enum DiscussionReasoningStatus {
    Streaming,
    #[default]
    Done,
}

/// Chain-of-thought / reasoning trace part.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct DiscussionReasoningPart {
    pub text: String,
    pub status: DiscussionReasoningStatus,
}

impl DiscussionReasoningPart {
    pub fn new(text: impl Into<String>, status: DiscussionReasoningStatus) -> Self {
        Self {
            text: text.into(),
            status,
        }
    }
}

/// Status for a multi-step agent progress delimiter.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
pub enum DiscussionStepStatus {
    #[default]
    Active,
    Complete,
    Error,
}

impl DiscussionStepStatus {
    pub fn as_str(&self) -> &'static str {
        match self {
            Self::Active => "active",
            Self::Complete => "complete",
            Self::Error => "error",
        }
    }
}

/// Step delimiter part for multi-step agent replies.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub struct DiscussionStepPart {
    pub step_number: u32,
    pub label: String,
    pub status: DiscussionStepStatus,
}

impl DiscussionStepPart {
    pub fn new(step_number: u32, label: impl Into<String>, status: DiscussionStepStatus) -> Self {
        Self {
            step_number,
            label: label.into(),
            status,
        }
    }
}