agent.info

The agent.info tool returns metadata about the calling agent: its ID, name, trust level, and current lifecycle state.

Capability Required

tool.invoke:agent.info

Input Schema

{
  "type": "object",
  "properties": {}
}

No input fields required. Pass an empty object {}.

Output Schema

{
  "type": "object",
  "properties": {
    "id":              { "type": "string", "description": "Agent UUID." },
    "name":            { "type": "string", "description": "Agent name from manifest." },
    "trust_level":     { "type": "string", "description": "Trust level: untrusted/sandboxed/trusted/privileged." },
    "lifecycle_state": { "type": "string", "description": "Current state: plan/act/observe/terminate." }
  }
}

Examples

#![allow(unused)]
fn main() {
let info = agent.invoke_tool("agent.info", json!({})).await?;
println!("Agent ID: {}", info["id"]);
println!("Name: {}", info["name"]);
println!("Trust: {}", info["trust_level"]);
println!("State: {}", info["lifecycle_state"]);
}

ash tools invoke <agent-id> agent.info '{}'
# Output:
# {
#   "id": "550e8400-e29b-41d4-a716-446655440000",
#   "name": "my-agent",
#   "trust_level": "sandboxed",
#   "lifecycle_state": "act"
# }

Cost

Estimated cost: 0.1 (minimal; in-memory lookup)

Category

Internal

Use Cases

• Self-introspection (agent checking its own identity)
• Debugging (verifying agent state from within the agent)
• Logging (including agent metadata in observations)
• Parent agents checking a child's current state via IPC