thndrs 0.1.0

Terminal AI pair programmer with local tools, sessions, MCP, and ACP support
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

//! ACP agent server entrypoint and protocol handlers.
//!
//! This module exposes `thndrs` as an ACP agent over stdio. The initial server
//! boundary is deliberately small: stdout is reserved for JSON-RPC transport
//! and all diagnostics belong on stderr or tracing sinks configured by the
//! binary.

pub mod config_options;
pub mod events;
pub mod handlers;
pub mod session;

#[cfg(test)]
mod tests;

use std::path::PathBuf;

use crate::cli::{ReasoningEffort, ReasoningSummary};
use agent_client_protocol::Result;

/// Runtime configuration accepted by the ACP agent binary.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct ServerConfig {
    /// Workspace directory used for ACP sessions when the client does not
    /// provide a more specific root.
    pub cwd: PathBuf,
    /// Provider model selected for future harness turns.
    pub model: String,
    /// Web search policy label selected for future harness turns.
    pub websearch: String,
    /// Optional base URL for the SearXNG backend.
    pub websearch_url: Option<String>,
    /// Default reasoning effort for ChatGPT Codex GPT-5.6 sessions.
    pub reasoning_effort: ReasoningEffort,
    /// Default reasoning-summary policy for ChatGPT Codex GPT-5.6 sessions.
    pub reasoning_summary: ReasoningSummary,
    /// Optional append-only session directory.
    pub session_dir: Option<PathBuf>,
}

impl ServerConfig {
    /// Build a server config from parsed binary flags.
    pub fn new(cwd: PathBuf, model: String, websearch: String, session_dir: Option<PathBuf>) -> Self {
        Self {
            cwd,
            model,
            websearch,
            websearch_url: None,
            reasoning_effort: ReasoningEffort::default(),
            reasoning_summary: ReasoningSummary::default(),
            session_dir,
        }
    }

    /// Apply resolved reasoning defaults from local configuration.
    pub fn with_reasoning(mut self, effort: ReasoningEffort, summary: ReasoningSummary) -> Self {
        self.reasoning_effort = effort;
        self.reasoning_summary = summary;
        self
    }

    /// Apply the configured SearXNG base URL.
    pub fn with_search_url(mut self, url: Option<String>) -> Self {
        self.websearch_url = url;
        self
    }
}

/// Run `thndrs acp serve` over stdio until the ACP connection closes.
pub async fn run_stdio(config: ServerConfig) -> Result<()> {
    handlers::run_stdio(config).await
}