{
  "version": "1.0",
  "tools": [
    {
      "id": "list_files",
      "description": "List files under `path` inside the workspace. If `path` is empty, list whole workspace.",
      "params": { "path": "string (optional)" },
      "returns": "newline-separated file paths or '(empty)'"
    },
    {
      "id": "read_file",
      "description": "Read file contents using a workspace-safe path. All paths are relative to the safe workspace.",
      "params": { "path": "string" },
      "returns": "file contents as text or an error message"
    },
    {
      "id": "write_file",
      "description": "Write `content` to `path` inside the workspace (creates directories as needed).",
      "params": { "path": "string", "content": "string" },
      "returns": "status string 'Wrote <path>' or error message"
    },
    {
      "id": "run_command",
      "description": "Run a shell command in the workspace directory. Captures stdout/stderr and returns them, or an exit code message.",
      "params": { "command": "string", "timeout": "int (optional, seconds)" },
      "returns": "combined stdout/stderr or an error/exit message"
    },
    {
      "id": "research",
      "description": "Placeholder research tool. Currently returns a short string noting it's unimplemented.",
      "params": { "query": "string" },
      "returns": "short text summary (implementation-specific)"
    }
  ]
}