scud-cli 1.67.0

Fast, simple task master for AI-driven development
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

//! DirectApiRunner - HeadlessRunner implementation using direct API calls.
//!
//! Runs an agentic loop via the Anthropic Messages API or OpenAI-compatible
//! Chat Completions APIs instead of spawning an external CLI process.

use anyhow::Result;
use std::path::Path;
use tokio::sync::mpsc;

use super::events::StreamEvent;
use super::runner::{BoxFuture, HeadlessRunner, SessionHandle};
use crate::commands::spawn::terminal::Harness;
use crate::llm::agent;
use crate::llm::provider::AgentProvider;

/// HeadlessRunner that calls LLM APIs directly.
pub struct DirectApiRunner {
    model: Option<String>,
    max_tokens: u32,
    provider: AgentProvider,
}

impl DirectApiRunner {
    pub fn new() -> Self {
        Self {
            model: None,
            max_tokens: 16_000,
            provider: AgentProvider::Anthropic,
        }
    }

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

    pub fn with_max_tokens(mut self, max_tokens: u32) -> Self {
        self.max_tokens = max_tokens;
        self
    }

    pub fn with_provider(mut self, provider: AgentProvider) -> Self {
        self.provider = provider;
        self
    }
}

impl HeadlessRunner for DirectApiRunner {
    fn start<'a>(
        &'a self,
        task_id: &'a str,
        prompt: &'a str,
        working_dir: &'a Path,
        model: Option<&'a str>,
    ) -> BoxFuture<'a, Result<SessionHandle>> {
        Box::pin(async move {
            let (tx, rx) = mpsc::channel(1000);

            let model = model.or(self.model.as_deref()).map(String::from);
            let max_tokens = self.max_tokens;
            let prompt = prompt.to_string();
            let working_dir = working_dir.to_path_buf();
            let task_id_owned = task_id.to_string();
            let provider = self.provider.clone();

            let tx_clone = tx.clone();
            let handle = tokio::spawn(async move {
                if let Err(e) = agent::run_agent_loop(
                    &prompt,
                    None,
                    &working_dir,
                    model.as_deref(),
                    max_tokens,
                    tx_clone,
                    &provider,
                    None,
                )
                .await
                {
                    let _ = tx.send(StreamEvent::error(&e.to_string())).await;
                    let _ = tx.send(StreamEvent::complete(false)).await;
                }
            });

            Ok(SessionHandle::from_task(task_id_owned, rx, handle))
        })
    }

    fn interactive_command(&self, _session_id: &str) -> Vec<String> {
        vec![
            "echo".to_string(),
            "Direct API sessions cannot be resumed".to_string(),
        ]
    }

    fn harness(&self) -> Harness {
        Harness::DirectApi
    }
}