deepseek-loop 0.4.0

Claude-Code-shaped agent loop over the DeepSeek API: built-in tools, permission modes, cron scheduler with /loop semantics, streaming SdkMessage events
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

//! SDK message types — mirrors the Claude Agent SDK message stream.
//!
//! See <https://code.claude.com/docs/en/agent-sdk/agent-loop>. The loop yields
//! a sequence of these in order: `System{Init}` → (`Assistant` →
//! `User(tool_results)`)* → final `Assistant` → `Result`.

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

use crate::types::UsageInfo;

/// Per-block content inside an `Assistant` or `User` message.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum ContentBlock {
    /// Text emitted by the assistant.
    Text { text: String },

    /// Assistant requested a tool call.
    ToolUse {
        id: String,
        name: String,
        input: Value,
    },

    /// Result of a tool call, fed back to the model on the next turn.
    ToolResult {
        tool_use_id: String,
        content: String,
        #[serde(default, skip_serializing_if = "std::ops::Not::not")]
        is_error: bool,
    },
}

/// Subtype of a `System` message.
///
/// - `Init` is emitted once at session start, carrying the session id and
///   the run configuration.
/// - `Compact` is emitted after a successful history-compaction step (see
///   [`crate::agent::CompactionConfig`]). Its `data` field carries
///   `{"message_count_after": <usize>}`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum SystemSubtype {
    Init,
    Compact,
}

/// Final disposition of an agent run.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ResultSubtype {
    Success,
    ErrorMaxTurns,
    ErrorMaxBudgetUsd,
    ErrorDuringExecution,
}

impl ResultSubtype {
    pub fn is_success(self) -> bool {
        matches!(self, Self::Success)
    }
}

/// Streamed message types in turn order.
///
/// Matches `SystemMessage` / `AssistantMessage` / `UserMessage` /
/// `ResultMessage` from the Claude Agent SDK. We do not emit `StreamEvent`
/// (token deltas) — the loop runs in non-streaming mode.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum SdkMessage {
    /// Lifecycle event. `Init` carries session metadata.
    System {
        subtype: SystemSubtype,
        session_id: String,
        #[serde(default, skip_serializing_if = "Value::is_null")]
        data: Value,
    },

    /// One assistant turn — text and/or tool_use blocks. The final assistant
    /// message in a successful run has no tool_use blocks.
    Assistant {
        content: Vec<ContentBlock>,
        #[serde(skip_serializing_if = "Option::is_none")]
        stop_reason: Option<String>,
    },

    /// One synthetic user turn carrying tool_result blocks back to the model.
    User { content: Vec<ContentBlock> },

    /// Terminal message. `result` is `Some` only when `subtype = Success`.
    Result {
        subtype: ResultSubtype,
        #[serde(skip_serializing_if = "Option::is_none")]
        result: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        total_cost_usd: Option<f64>,
        #[serde(skip_serializing_if = "Option::is_none")]
        usage: Option<UsageInfo>,
        num_turns: u32,
        session_id: String,
        #[serde(skip_serializing_if = "Option::is_none")]
        stop_reason: Option<String>,
    },
}

impl SdkMessage {
    /// True for the terminal `Result` message.
    pub fn is_terminal(&self) -> bool {
        matches!(self, SdkMessage::Result { .. })
    }
}