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

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

use super::{
    DiscussionReasoningPart, DiscussionReasoningStatus, DiscussionStepPart, DiscussionStepStatus,
    DiscussionToolPart,
};

/// Content part composing a reply body.
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
pub enum DiscussionPart {
    Text {
        markdown: String,
        streaming: bool,
    },
    File {
        name: String,
        url: String,
        mime: Option<String>,
        size_bytes: Option<u64>,
    },
    Custom {
        kind: String,
        data: Value,
    },
    Tool(DiscussionToolPart),
    Reasoning(DiscussionReasoningPart),
    Step(DiscussionStepPart),
}

impl DiscussionPart {
    /// Plain markdown text part.
    pub fn text(markdown: impl Into<String>) -> Self {
        Self::Text {
            markdown: markdown.into(),
            streaming: false,
        }
    }

    /// Markdown text part with streaming cursor when AGENT_PARTS is enabled.
    pub fn streaming_text(markdown: impl Into<String>) -> Self {
        Self::Text {
            markdown: markdown.into(),
            streaming: true,
        }
    }

    /// Tool invocation part.
    pub fn tool(part: DiscussionToolPart) -> Self {
        Self::Tool(part)
    }

    /// Reasoning / thinking trace part.
    pub fn reasoning(text: impl Into<String>, status: DiscussionReasoningStatus) -> Self {
        Self::Reasoning(DiscussionReasoningPart::new(text, status))
    }

    /// Step delimiter part.
    pub fn step(step_number: u32, label: impl Into<String>, status: DiscussionStepStatus) -> Self {
        Self::Step(DiscussionStepPart::new(step_number, label, status))
    }
}