codetether-rlm 0.1.0

Recursive Language Model processing for CodeTether
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

//! Host-provided trait for RLM tool dispatch.
//!
//! The router needs three host-defined capabilities that live in
//! `codetether-agent`: the REPL context, structured tool dispatch,
//! and tool-definition generation. This trait exposes them without
//! coupling the crate to concrete types.

use crate::traits::ToolDefinition;

/// Result of dispatching a single RLM tool call.
#[derive(Debug, Clone)]
pub enum HostToolResult {
    /// Normal output, fed back to the LLM.
    Output(String),
    /// Final answer — terminates the RLM loop.
    Final(String),
}

/// Narrow interface the router needs from the host environment.
///
/// Implemented by `codetether-agent` with `RlmRepl` and the
/// `dispatch_tool_call` function from `src/rlm/tools.rs`.
pub trait RouterHost: Send {
    /// Return the `rlm_head/tail/grep/…` tool definitions.
    fn tool_definitions(&self) -> Vec<ToolDefinition>;

    /// Dispatch one tool call. Returns `None` for unknown tools.
    fn dispatch(&mut self, name: &str, arguments: &str) -> Option<HostToolResult>;
}