deepseek-loop 0.2.0

Claude-Code-shaped agent loop over the DeepSeek API: built-in tools, permission modes, 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

//! Options passed into [`crate::agent::run`].

use std::sync::Arc;

use crate::types::EffortLevel;

use super::permissions::{PermissionMode, PreToolHook};

/// Configuration for an agent run.
///
/// Mirrors `ClaudeAgentOptions` / `Options` from the Claude Agent SDK, scoped
/// to the fields meaningful for a non-streaming OpenAI-compatible loop.
pub struct RunOptions {
    pub model: String,
    pub system_prompt: String,
    /// If `Some`, only listed tools may be invoked. Tools not on the list are
    /// hidden from the model entirely.
    pub allowed_tools: Option<Vec<String>>,
    /// Tools listed here are hidden from the model and any call is denied.
    pub disallowed_tools: Vec<String>,
    pub max_turns: Option<u32>,
    pub max_budget_usd: Option<f64>,
    pub effort: EffortLevel,
    pub permission_mode: PermissionMode,
    pub pre_tool_hook: Option<Arc<dyn PreToolHook>>,
    pub session_id: Option<String>,
    pub base_url: String,
}

impl Default for RunOptions {
    fn default() -> Self {
        Self {
            model: "deepseek-v4-pro".into(),
            system_prompt: String::new(),
            allowed_tools: None,
            disallowed_tools: Vec::new(),
            max_turns: None,
            max_budget_usd: None,
            effort: EffortLevel::default(),
            permission_mode: PermissionMode::default(),
            pre_tool_hook: None,
            session_id: None,
            base_url: "https://api.deepseek.com/v1".into(),
        }
    }
}

impl RunOptions {
    pub fn new(model: impl Into<String>) -> Self {
        Self {
            model: model.into(),
            ..Self::default()
        }
    }

    pub fn system_prompt(mut self, p: impl Into<String>) -> Self {
        self.system_prompt = p.into();
        self
    }

    pub fn max_turns(mut self, n: u32) -> Self {
        self.max_turns = Some(n);
        self
    }

    pub fn max_budget_usd(mut self, b: f64) -> Self {
        self.max_budget_usd = Some(b);
        self
    }

    pub fn effort(mut self, e: EffortLevel) -> Self {
        self.effort = e;
        self
    }

    pub fn permission_mode(mut self, m: PermissionMode) -> Self {
        self.permission_mode = m;
        self
    }

    pub fn allowed_tools<I, S>(mut self, tools: I) -> Self
    where
        I: IntoIterator<Item = S>,
        S: Into<String>,
    {
        self.allowed_tools = Some(tools.into_iter().map(Into::into).collect());
        self
    }

    pub fn disallowed_tools<I, S>(mut self, tools: I) -> Self
    where
        I: IntoIterator<Item = S>,
        S: Into<String>,
    {
        self.disallowed_tools = tools.into_iter().map(Into::into).collect();
        self
    }

    pub fn pre_tool_hook(mut self, hook: Arc<dyn PreToolHook>) -> Self {
        self.pre_tool_hook = Some(hook);
        self
    }

    pub fn session_id(mut self, id: impl Into<String>) -> Self {
        self.session_id = Some(id.into());
        self
    }

    pub fn base_url(mut self, url: impl Into<String>) -> Self {
        self.base_url = url.into().trim_end_matches('/').to_string();
        self
    }
}