{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hud-ai/json-schema/hud-ai-rollout-submit-request-schema.json",
  "title": "RolloutSubmitRequest",
  "description": "One v6 rollout under the SDK's job/trace identity.\n\nThe SDK's rollout atom mints ``trace_id``/``job_id`` and submits the task\nby reference — env name, task id (the ``@env.task`` name), bound args —\nplus the serialized agent spec. The platform materializes the\ntask_version chain, schedules an instance, and runs the rollout co-located\nwith the env; the SDK polls the trace to completion.\n\n``slug`` is the taskset row key (``Task.external_id`` / portable\n``Task.slug``). It is distinct from ``task`` (the ``@env.task`` id used for\nscenario lookup) and is only needed when a job's taskset has multiple\nversions sharing the same scenario+args.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hud-ai-rollouts-api-openapi.yml#/components/schemas/RolloutSubmitRequest",
  "properties": {
    "trace_id": {
      "type": "string",
      "format": "uuid",
      "title": "Trace Id"
    },
    "job_id": {
      "type": "string",
      "format": "uuid",
      "title": "Job Id"
    },
    "group_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Group Id"
    },
    "env": {
      "type": "string",
      "minLength": 1,
      "title": "Env"
    },
    "task": {
      "type": "string",
      "minLength": 1,
      "title": "Task"
    },
    "slug": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Slug"
    },
    "args": {
      "additionalProperties": true,
      "type": "object",
      "title": "Args",
      "default": {}
    },
    "runtime_config": {
      "anyOf": [
        {
          "$ref": "#/$defs/SubmittedRuntimeConfig"
        },
        {
          "type": "null"
        }
      ]
    },
    "verifier": {
      "anyOf": [
        {
          "$ref": "#/$defs/SubmittedVerifierTask"
        },
        {
          "type": "null"
        }
      ]
    },
    "agent": {
      "$ref": "#/$defs/SubmittedAgentSpec"
    }
  },
  "type": "object",
  "required": [
    "trace_id",
    "job_id",
    "env",
    "task",
    "agent"
  ],
  "$defs": {
    "SubmittedAgentSpec": {
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "claude",
            "claude_cli",
            "codex_cli",
            "openai",
            "gemini",
            "openai_compatible"
          ],
          "title": "Type"
        },
        "config": {
          "additionalProperties": true,
          "type": "object",
          "title": "Config"
        }
      },
      "type": "object",
      "required": [
        "type",
        "config"
      ],
      "title": "SubmittedAgentSpec",
      "description": "Registered identity a hosted runner rebuilds the agent from.\n\nMirrors the v6 SDK's hosted submission: the ``AgentType`` value plus the\n``Agent.dump()`` config with runtime-only state and credentials stripped.\nThe control plane reads ``model`` (for inference routing and billing) and\n``max_steps`` from ``config``, and stores ``config`` as submitted except\nthat ``model`` becomes the catalog's canonical model name. The instance\nrebuilds the agent through ``AgentType``."
    },
    "SubmittedComposeDocument": {
      "properties": {
        "services": {
          "additionalProperties": {
            "$ref": "#/$defs/SubmittedComposeService"
          },
          "type": "object",
          "minProperties": 1,
          "title": "Services"
        }
      },
      "additionalProperties": true,
      "type": "object",
      "required": [
        "services"
      ],
      "title": "SubmittedComposeDocument",
      "description": "Normalized Compose document transported with a hosted runtime artifact."
    },
    "SubmittedComposeProject": {
      "properties": {
        "document": {
          "$ref": "#/$defs/SubmittedComposeDocument"
        },
        "root": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedComposeProjectRef"
            },
            {
              "type": "null"
            }
          ]
        },
        "service_access": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Service Access"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "document"
      ],
      "title": "SubmittedComposeProject",
      "description": "Compose document and its optional environment source artifact."
    },
    "SubmittedComposeProjectRef": {
      "properties": {
        "compose_path": {
          "type": "string",
          "minLength": 1,
          "title": "Compose Path"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "compose_path"
      ],
      "title": "SubmittedComposeProjectRef",
      "description": "Build-context location inside the selected environment source artifact."
    },
    "SubmittedComposeService": {
      "properties": {
        "image": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Image"
        },
        "build": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Build"
        },
        "user": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "User"
        },
        "environment": {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object",
          "title": "Environment"
        },
        "entrypoint": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Entrypoint"
        },
        "command": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Command"
        },
        "working_dir": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Working Dir"
        },
        "healthcheck": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Healthcheck"
        },
        "expose": {
          "items": {},
          "type": "array",
          "title": "Expose"
        },
        "ports": {
          "items": {},
          "type": "array",
          "title": "Ports"
        },
        "volumes": {
          "items": {},
          "type": "array",
          "title": "Volumes"
        },
        "scale": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Scale"
        }
      },
      "additionalProperties": true,
      "type": "object",
      "title": "SubmittedComposeService",
      "description": "Pullable service in a normalized hosted Compose document."
    },
    "SubmittedRuntimeConfig": {
      "properties": {
        "image": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Image"
        },
        "compose": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedComposeProject"
            },
            {
              "type": "null"
            }
          ]
        },
        "resources": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedRuntimeResources"
            },
            {
              "type": "null"
            }
          ]
        },
        "limits": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedRuntimeLimits"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "SubmittedRuntimeConfig",
      "description": "SDK ``RuntimeConfig`` accepted by hosted v6 submissions.\n\nProvider-specific support is validated by the SDK runtime implementation."
    },
    "SubmittedRuntimeGPU": {
      "properties": {
        "type": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 64,
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Type"
        },
        "count": {
          "type": "integer",
          "minimum": 1.0,
          "title": "Count",
          "default": 1
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "SubmittedRuntimeGPU",
      "description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeGPU``."
    },
    "SubmittedRuntimeLimits": {
      "properties": {
        "startup_timeout_s": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Startup Timeout S"
        },
        "run_timeout_s": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Run Timeout S"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "SubmittedRuntimeLimits",
      "description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeLimits``."
    },
    "SubmittedRuntimeResources": {
      "properties": {
        "cpu": {
          "anyOf": [
            {
              "type": "number",
              "exclusiveMinimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Cpu"
        },
        "memory_mb": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Memory Mb"
        },
        "storage_mb": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Storage Mb"
        },
        "gpu": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedRuntimeGPU"
            },
            {
              "type": "null"
            }
          ]
        },
        "os": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1
            },
            {
              "type": "null"
            }
          ],
          "title": "Os"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "title": "SubmittedRuntimeResources",
      "description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeResources``.\n\nHosted runtimes run Linux, so ``os`` accepts only ``linux`` in any case."
    },
    "SubmittedVerifierTask": {
      "properties": {
        "env": {
          "type": "string",
          "minLength": 1,
          "title": "Env"
        },
        "id": {
          "type": "string",
          "minLength": 1,
          "title": "Id"
        },
        "args": {
          "additionalProperties": true,
          "type": "object",
          "title": "Args"
        },
        "slug": {
          "type": "string",
          "minLength": 1,
          "title": "Slug"
        },
        "validation": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Validation"
        },
        "agent_config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Agent Config"
        },
        "columns": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Columns"
        },
        "runtime_config": {
          "anyOf": [
            {
              "$ref": "#/$defs/SubmittedRuntimeConfig"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "env",
        "id",
        "slug"
      ],
      "title": "SubmittedVerifierTask",
      "description": "Nested verifier task carried by a task row."
    }
  }
}