agent-trace 0.1.0

Git-backed document memory, trace continuity, and permissioned writes for agent workflows
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

use crate::data_plane::{self, WriteDocumentError};
use crate::observability::{format_permission_denied, CliOutput};
use crate::session::{session_id_for_actor, touch_session, AgentState};
use anyhow::Result;
use std::io::{self, Read};
use std::path::Path;

pub fn run(
    root: &Path,
    file: &Path,
    content: Option<String>,
    cli_agent: Option<String>,
    output: &dyn CliOutput,
) -> Result<()> {
    let body = match content {
        Some(c) => c,
        None => {
            let mut buf = String::new();
            io::stdin().read_to_string(&mut buf)?;
            buf
        }
    };

    let agent_state = AgentState::new(cli_agent);
    let actor = agent_state.current_actor(root);
    let session_id = session_id_for_actor(root, &actor);
    if let Some(name) = actor.agent_name() {
        let _ = touch_session(root, name);
    }

    let rel = match data_plane::write_document(
        root,
        file,
        &body,
        &actor,
        "agent write",
        session_id.as_deref(),
    ) {
        Ok(path) => path,
        Err(WriteDocumentError::PermissionDenied { path, reason }) => {
            output.error(&format_permission_denied(&path, &reason))?;
            std::process::exit(1);
        }
        Err(WriteDocumentError::Other(e)) => return Err(e),
    };

    output.line(&format!("OK: {} written", rel.display()))?;
    Ok(())
}