{
  "//": "Template for adding a coding agent to the dev environment service.",
  "//1": "Copy this file to ./agents/<your-agent>.json (drop the .template suffix),",
  "//2": "fill it in, and start the service with DEVMAN_AGENT=<name>.",
  "//3": "Wherever {{instruction}} appears, the request coming in from Devman /",
  "//4": "Wanda / any front-end is substituted. Also available: {{stdin}}, {{root}}.",

  "name": "my-coding-agent",
  "description": "What this agent is, shown in the session info",

  "//5": "kind 'http': you provide the JSON request to your agent's API.",
  "kind": "http",
  "request": {
    "method": "POST",
    "url": "http://localhost:11434/api/task",
    "headers": {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_AGENT_API_KEY"
    },
    "body": {
      "prompt": "{{instruction}}",
      "project": "{{root}}"
    }
  },
  "//6": "Optional: dot-path into the JSON response to use as the output.",
  "responsePath": "result.text",

  "//7": "Optional 'start' block: a long-running process the service launches",
  "//8": "on startup (e.g. this agent's API server) and kills on shutdown. Omit",
  "//9": "it if your agent is already running. Opt out at runtime with",
  "//10": "DEVMAN_START_AGENT=0 to manage the process yourself.",
  "start": {
    "command": ["my-agent-server", "--port", "11434", "--project", "{{root}}"],
    "//cwd": "Optional working dir (defaults to {{root}}).",
    "//env": { "MY_AGENT_KEY": "secret" },
    "//readyLog": "Optional regex; wait until it matches the agent's output.",
    "readyLog": "listening on",
    "//readyDelayMs": "Fixed wait instead of readyLog (e.g. 2000).",
    "//readyTimeoutMs": "Cap on the readyLog wait (default 30000)."
  },

  "//11": "Alternative — kind 'command': spawn a CLI agent instead of an API.",
  "//12": "Replace the http fields above with, e.g.:",
  "//13": "  \"kind\": \"command\",",
  "//14": "  \"command\": [\"my-agent-cli\", \"--project\", \"{{root}}\", \"--task\", \"{{instruction}}\"]"
}