localharness 0.61.0

Agents that own themselves: one Rust crate that's both an agent SDK (streaming, tools, hooks, policies, triggers, MCP) and a wallet-owning, self-sovereign agent that runs in the browser.
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
73
74
75
76
77
78
79
80
81
82
83
84
85

//! Shared helpers for the streaming-backend turn loops.
//!
//! Per the subsystem spec ("Fix plumbing in the SHARED core, not per-backend":
//! if a fix would be copy-pasted into two backends, it belongs here), these are
//! the small loop helpers that were byte-identical across gemini / anthropic /
//! openai. Hoisted to ONE home so a fix (e.g. canonical-path handling, the
//! malformed-args convention) can't drift between backends.
//!
//! The module is unconditional (`extract_canonical_path` is used by the
//! always-on gemini loop); `resolve_tool_args` gates on
//! `any(feature = "anthropic", feature = "openai")` — its consumers.

use serde_json::Value;
#[cfg(any(feature = "anthropic", feature = "openai"))]
use serde_json::json;
#[cfg(any(feature = "anthropic", feature = "openai"))]
use tracing::warn;

/// Resolve a tool call's concatenated streamed `arguments` fragment into parsed
/// args. An EMPTY/absent fragment is a valid no-arg call → `({}, None)`. A
/// NON-EMPTY fragment that fails to parse returns `({}, Some(error))`: the
/// caller surfaces that error to the model as a tool error rather than running
/// the tool with empty args silently.
#[cfg(any(feature = "anthropic", feature = "openai"))]
pub(crate) fn resolve_tool_args(name: &str, args_json: &str) -> (Value, Option<String>) {
    if args_json.trim().is_empty() {
        return (json!({}), None);
    }
    match serde_json::from_str(args_json) {
        Ok(v) => (v, None),
        Err(e) => {
            let msg = format!("malformed tool arguments for '{name}': {e} (got: {args_json})");
            warn!(error = %e, name = %name, "tool_call args not valid JSON; surfacing tool error");
            (json!({}), Some(msg))
        }
    }
}

/// Canonicalize a tool call's `"path"` arg so the `workspace_only` containment
/// policy has an absolute path to check. Existing targets canonicalize
/// directly; for a not-yet-existent target (e.g. `create_file`) the parent is
/// canonicalized and the file name re-joined. `None` when there's no path arg
/// or the parent can't be resolved.
pub(crate) fn extract_canonical_path(args: &Value) -> Option<String> {
    let path_str = args.get("path").and_then(|v| v.as_str())?;
    let path = std::path::Path::new(path_str);
    if let Ok(p) = dunce::canonicalize(path) {
        return Some(p.display().to_string());
    }
    let parent = path.parent()?;
    let file = path.file_name()?;
    let parent = if parent.as_os_str().is_empty() {
        std::path::Path::new(".")
    } else {
        parent
    };
    dunce::canonicalize(parent)
        .ok()
        .map(|p| p.join(file).display().to_string())
}

#[cfg(all(test, any(feature = "anthropic", feature = "openai")))]
mod tests {
    use super::*;

    /// THE canonical `resolve_tool_args` suite (the per-backend copies were
    /// deduped here — anthropic/openai consume this one impl).
    #[test]
    fn resolve_tool_args_valid_empty_and_malformed() {
        // Valid JSON parses.
        let (args, err) = resolve_tool_args("view_file", r#"{"path":"main.rs"}"#);
        assert!(err.is_none());
        assert_eq!(args["path"], "main.rs");
        // Empty / whitespace is a valid no-arg call, NOT a parse error.
        for empty in ["", "   "] {
            let (args, err) = resolve_tool_args("list_subdomains", empty);
            assert!(err.is_none(), "empty args must NOT be treated as malformed");
            assert_eq!(args, json!({}));
        }
        // A non-empty fragment that fails to parse surfaces an error (no silent {}).
        let (args, err) = resolve_tool_args("edit_file", r#"{"path":"a.rs","content":"#);
        assert!(err.unwrap().contains("malformed tool arguments for 'edit_file'"));
        assert_eq!(args, json!({}));
    }
}