Built-in Tools Reference

{
  "message": "hello world"
}

{}

{
  "timestamp": "2026-03-03T15:30:45Z",
  "unix": 1772783445,
  "timezone": "UTC",
  "formatted": "Tuesday, March 3, 2026 at 3:30 PM"
}

{
  "data": {"any": "json", "value": [1, 2, 3]},
  "format": "pretty"
}

{
  "method": "POST",
  "url": "https://api.example.com/data",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {API_TOKEN}"
  },
  "body": {"query": "test"},
  "timeout_secs": 30
}

{
  "url": "https://example.com/page",
  "include_links": true,
  "timeout_secs": 10
}

{
  "path": "src/main.rs",
  "encoding": "utf8"
}

{
  "path": "output.txt",
  "content": "file contents",
  "create_dirs": true,
  "encoding": "utf8"
}

{
  "path": "src",
  "recursive": false,
  "include_hidden": false
}

{
  "entries": [
    {
      "name": "main.rs",
      "path": "src/main.rs",
      "type": "file",
      "size": 1024,
      "modified": "2026-03-03T10:00:00Z"
    }
  ]
}

{
  "file_path": "src/lib.rs",
  "patch": "--- a/src/lib.rs\n+++ b/src/lib.rs\n@@ -1,3 +1,4 @@\n+use std::io;\n fn main() {\n     println!(\"Hello\");\n }"
}

{
  "command": "cargo build --release",
  "workdir": "/workspace",
  "timeout_secs": 300,
  "capture_output": true
}

const DESTRUCTIVE_PATTERNS: &[&str] = &[
    "rm -rf", "rm -fr", "rm -r",
    "format", "mkfs",
    "dd if=",
    "> /dev/",
    "shutdown", "reboot", "poweroff",
    "iptables -F", "iptables -X",
];

{
  "key": "user_preferences",
  "value": {"theme": "dark", "language": "en"},
  "ttl_secs": 86400,
  "tags": ["settings", "user"]
}

{
  "key": "user_preferences"
}

{
  "query": "user",
  "tags": ["settings"],
  "limit": 10
}

{
  "prefix": "config/"
}

{
  "description": "Analyze codebase and generate report",
  "instructions": "Read all .rs files and create a summary",
  "context": {"project": "ironclaw"},
  "container": {
    "image": "rust:1.75",
    "workspace_path": "/workspace"
  }
}

{
  "status": "running",
  "limit": 10
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "User requested cancellation"
}

{
  "query": "github",
  "type": "wasm",
  "limit": 10
}

{
  "source": "https://tools.ironclaw.dev/github-tool.wasm",
  "name": "github",
  "auto_activate": true
}

{
  "tool_name": "github"
}

{
  "tool_name": "github"
}

{
  "status": "active"
}

{
  "tool_name": "github",
  "force": false
}

{
  "name": "daily_report",
  "schedule": "0 9 * * *",
  "action": "create_job",
  "params": {"description": "Generate daily report"}
}

{
  "channel": "slack",
  "target": "#engineering",
  "text": "Build completed successfully",
  "metadata": {"build_id": "123"}
}

{
  "requirement": "Create a WASM tool that checks GitHub PR status",
  "software_type": "wasm_tool",
  "language": "rust",
  "output_path": "/workspace/github-pr-tool",
  "test_cases": [
    {"input": "owner=rust-lang repo=rust pr=12345", "expected": "status: open"}
  ]
}

// Extract required string parameter
pub fn require_str<'a>(params: &'a Value, name: &str) -> Result<&'a str, ToolError>

// Extract required parameter of any type
pub fn require_param<'a>(params: &'a Value, name: &str) -> Result<&'a Value, ToolError>

async fn execute(&self, params: Value, ctx: &JobContext) -> Result<ToolOutput, ToolError> {
    let path = require_str(&params, "path")?;
    let content = require_str(&params, "content")?;
    
    // ... implementation
}