{
  "schema_version": "1.0.0",
  "herdr_version": "0.8.2",
  "cli_command": "herdr agent wait <TARGET> [OPTIONS]",
  "options": {
    "--until": {
      "type": "string",
      "repeatable": true,
      "possible_values": [
        "idle",
        "working",
        "blocked",
        "done",
        "unknown"
      ],
      "default_when_omitted": [
        "idle",
        "done",
        "blocked"
      ]
    },
    "--timeout": {
      "type": "integer_ms",
      "required": false,
      "default_when_omitted": "unlimited (indefinite block)"
    }
  },
  "call_outcomes": [
    {
      "outcome": "state_matched",
      "exit_code": 0,
      "output_channel": "stdout",
      "sample_command": [
        "herdr",
        "agent",
        "wait",
        "creator-agy-01",
        "--until",
        "working",
        "--timeout",
        "1000"
      ],
      "evidence_reference": ".mam/jobs/129a95db/evidence/wait_agy_working_immediate.json"
    },
    {
      "outcome": "timeout",
      "exit_code": 1,
      "output_channel": "stderr",
      "error_code": "timeout",
      "sample_command": [
        "herdr",
        "agent",
        "wait",
        "creator-agy-01",
        "--until",
        "done",
        "--timeout",
        "50"
      ],
      "evidence_reference": ".mam/jobs/129a95db/evidence/timeout_stderr.json"
    },
    {
      "outcome": "agent_not_found",
      "exit_code": 1,
      "output_channel": "stderr",
      "error_code": "agent_not_found",
      "sample_command": [
        "herdr",
        "agent",
        "wait",
        "non-existent-agent-target",
        "--until",
        "idle",
        "--timeout",
        "50"
      ],
      "evidence_reference": ".mam/jobs/129a95db/evidence/unknown_target_stderr.txt"
    }
  ]
}