locode-engine 0.1.11

The sample-dispatch-append loop and Session driving API of the locode coding agent
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

//! The loop's terminal outcome and the cross-turn report accumulator (internal).

use locode_protocol::{Status, ToolCallRecord, Usage};

/// Why the loop stopped. Maps 1:1 onto [`Status`].
pub(crate) enum Terminal {
    /// The assistant turn had no tool calls.
    Completed { final_message: Option<String> },
    /// The max-turns ceiling was hit after a dispatch batch.
    MaxTurns,
    /// A provider error after the bounded resample budget was spent.
    ModelError { error: String },
    /// A `Dispatched.fatal` aborted the turn.
    Error { error: String },
    /// The run's cancel token fired (ADR-0018) — a structured stop, not a fault.
    Cancelled,
}

impl Terminal {
    pub(crate) fn status(&self) -> Status {
        match self {
            Terminal::Completed { .. } => Status::Completed,
            Terminal::MaxTurns => Status::MaxTurns,
            Terminal::ModelError { .. } => Status::ModelError,
            Terminal::Error { .. } => Status::Error,
            Terminal::Cancelled => Status::Cancelled,
        }
    }
}

/// Report-side state accumulated across turns.
#[derive(Default)]
pub(crate) struct RunAcc {
    pub(crate) turns: u32,
    pub(crate) tool_calls: Vec<ToolCallRecord>,
    pub(crate) usage: Usage,
    pub(crate) last_assistant_text: Option<String>,
    /// The final completion's stop reason, as the neutral string for the report
    /// (ADR-0009 amendment 2026-07-19).
    pub(crate) last_stop: Option<String>,
}