lernie 0.0.3

A git-backed agent harness
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

//! `lernie tool <name>` — in-process built-in tool entry (ARCH §3.3):
//! `tool_use.input` JSON on stdin, bytes on stdout, exit 0/non-zero. The
//! stdio arrives through [`Fx`](super::Fx) (locked by the binding), as
//! does the driver target the `dispatch` / `message` built-ins re-enter
//! the front door with (§2.11 — the same injected target the §3.3 tool
//! resolver's third hop addresses).

use super::{Error, Fx, Outcome};
use crate::prompt::tool::builtin;

/// `lernie tool <name>`.
#[derive(clap::Args, Debug)]
pub struct Args {
    // The help text is rendered from [`builtin::NAMES`], the same list the
    // unknown-tool decline names — one pool, two surfaces. The name is *not*
    // a `value_parser` over that set: the compactor pair (`write_summary` /
    // `mark_for_deletion`, §2.7) is routed but unadvertised, so a clap
    // possible-values gate would refuse the compactor's own re-entry, and
    // clap's parse error would replace the §3.3 decline (stderr concatenated
    // into `tool_result.content`) with its own voice and exit code.
    #[arg(help = name_help())]
    pub name: String,
}

/// The `<NAME>` argument's help line — the built-in pool, named.
fn name_help() -> String {
    format!("Built-in tool to run; one of: {}", builtin::pool())
}

/// Delegate to [`builtin::run`] over the injected stdio; the process
/// exit code rides back as [`Outcome::Code`](super::Outcome::Code)
/// (§3.3). The failure prefix is `tool <name>`, as today.
pub fn run(args: Args, fx: &mut Fx) -> Result<Outcome, Error> {
    let code = builtin::run(
        &args.name,
        &fx.driver_target,
        &mut fx.tool_stdin,
        &mut fx.tool_stdout,
        &mut fx.tool_stderr,
    )
    .map_err(|e| Error::new(format!("tool {}", args.name), e))?;
    // Tool exit codes ride within `u8` (POSIX), so `as u8` is faithful.
    Ok(Outcome::Code(code as u8))
}