Function classify_tool_call

atomic-agent/src/provenance/classify.rs:80–146

Classify a tool call into a [`NodeKind`] based on tool name and arguments. This is the primary entry point for the rule-based classifier. It inspects the tool name first, then falls back to argument inspection for ambiguous tools (like `bash`). # Arguments `tool_name` — The tool name as reported by the agent (e.g., "read", "edit", "bash"). `tool_input` — The tool's input arguments as a JSON val

(
    tool_name: &str,
    tool_input: Option<&serde_json::Value>,
    tool_output: Option<&str>,
    status: Option<&str>,
)

/// The [`NodeKind`] that best describes this tool call's role in the
/// agent's decision chain.
pub fn classify_tool_call(
    tool_name: &str,
    tool_input: Option<&serde_json::Value>,
    tool_output: Option<&str>,
    status: Option<&str>,
) -> NodeKind {
    // Error status always produces an error node, regardless of tool
    if status == Some("error") {
        return NodeKind::Error;
    }

    let normalized = tool_name.to_lowercase();
    let normalized = normalized.trim();

    match normalized {
        // Read-family tools → Exploration
        "read" | "read_file" | "readfile" | "view" | "cat" => NodeKind::Exploration,

        // Search tools → Exploration
        "grep" | "glob" | "find_path" | "find" | "search" | "ripgrep" | "rg" => {
            NodeKind::Exploration
        }

        // Directory listing → Exploration
        "list_directory" | "listdir" | "ls" | "list" | "tree" => NodeKind::Exploration,

        // Internal reasoning → Exploration
        "thinking" | "think" | "reason" | "plan" => NodeKind::Exploration,

        // Fetch/web tools → Exploration
        "fetch" | "curl" | "web_search" | "browser" => NodeKind::Exploration,

        // Write-family tools → Commitment
        "edit" | "edit_file" | "editfile" => NodeKind::Commitment,
        "write" | "write_file" | "writefile" | "write_to_file" => NodeKind::Commitment,
        "multiedit" | "multi_edit" | "multifile_edit" => NodeKind::Commitment,
        "patch" | "apply_patch" | "apply_diff" => NodeKind::Commitment,
        "create" | "create_file" | "createfile" => NodeKind::Commitment,
        "insert" | "replace" | "delete_file" | "remove_file" => NodeKind::Commitment,

        // Todo/note tools → Commitment (they write structured data)
        "todocreate" | "todowrite" | "todo_create" | "todo_write" => NodeKind::Commitment,

        // Shell commands: inspect the command string to sub-classify
        "bash" | "terminal" | "shell" | "command" | "exec" | "run" => {
            classify_shell_command(tool_input, tool_output)
        }

        // Task/sub-agent → Execution
        "task" | "subagent" | "agent" | "dispatch" | "delegate" => NodeKind::Execution,

        // File operations that are ambiguous — classify by looking at args
        "mv" | "move" | "rename" | "move_path" | "copy" | "copy_path" => NodeKind::Commitment,

        // Diagnostic tools → Exploration
        "diagnostics" | "diagnostic" | "check" => NodeKind::Exploration,

        // Open tools (open file in editor/browser) → Exploration