echo

The echo tool returns its input unchanged. It is useful for testing capability enforcement and tool dispatch without side effects.

Capability Required

tool.invoke:echo

Input Schema

{
  "type": "object"
}

Any JSON object is accepted. No required fields.

Output Schema

The output is the same JSON object as the input.

Example

ash tools invoke <agent-id> echo '{"message": "hello", "count": 42}'
# Output: {"message": "hello", "count": 42}

#![allow(unused)]
fn main() {
let result = agent.invoke_tool("echo", json!({"message": "hello"})).await?;
assert_eq!(result["message"], "hello");
}

Cost

Estimated cost: 0.1 (minimal)

Category

Internal

Use Cases

• Testing that an agent can invoke tools at all
• Verifying capability token enforcement is working
• Smoke tests for the IPC pipeline
• Round-trip latency measurement