Agent Traffic Lab

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "description": "Natural-language task. ATL infers the required capability when possible."
    },
    "required_capability": {
      "type": "string",
      "description": "Capability the selected provider must support."
    },
    "desired_outcome": {
      "type": "string",
      "description": "Optional result the caller wants from the task."
    },
    "constraints": {
      "type": "object",
      "description": "Optional hard requirements the selected provider must meet."
    },
    "preferences": {
      "type": "object",
      "description": "Optional trade-offs such as cost, latency, or reliability."
    },
    "auth_available": {
      "type": "boolean",
      "description": "Whether the caller can authenticate to the selected provider."
    },
    "max_retries": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2,
      "description": "Optional maximum retries allowed for the decision request."
    },
    "timeout_ms": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional time limit for the decision request in milliseconds."
    }
  },
  "required": [
    "task"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "MCP session ID returned by initialize."
    },
    "request_id": {
      "type": "string",
      "description": "Caller request ID associated with the prior ATL decision."
    },
    "correlation_id": {
      "type": "string",
      "description": "Caller correlation ID linking this result to related work."
    },
    "decision_reference": {
      "type": "string",
      "description": "ATL decision ID returned by the prior atl_decide call."
    },
    "outcome_correlation_token": {
      "type": "string",
      "description": "ATL token returned with the prior decision to authorize this outcome link."
    },
    "provider_id": {
      "type": "string",
      "description": "Provider selected by ATL for the prior decision."
    },
    "final_provider_id": {
      "type": "string",
      "description": "Provider that actually completed execution, if it changed."
    },
    "outcome_status": {
      "type": "string",
      "description": "Final real-world execution result, such as SUCCESS or FAILURE."
    },
    "observed_latency_ms": {
      "type": "number",
      "description": "Observed provider execution latency in milliseconds."
    },
    "observed_cost": {
      "type": "number",
      "description": "Observed provider execution cost."
    },
    "error_code": {
      "type": "string",
      "description": "Provider error code observed during execution."
    },
    "failure_type": {
      "type": "string",
      "description": "Category of the observed execution failure."
    },
    "http_status": {
      "type": "integer",
      "description": "HTTP status returned by the provider, when applicable."
    },
    "cancelled": {
      "type": "boolean",
      "description": "Whether execution was cancelled before completion."
    },
    "attempt_outcomes": {
      "type": "array",
      "description": "Observed results for individual provider execution attempts."
    }
  },
  "required": [
    "decision_reference",
    "outcome_correlation_token",
    "outcome_status"
  ],
  "additionalProperties": false
}