Agent Traffic Lab

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'description': 'The natural-language task to complete. Include the goal and any relevant input, constraints, or desired output.'}, 'required_capability': {'enum': ['search', 'extract', 'summarize', 'translate', 'classify'], 'type': 'string', 'description': 'Optional capability hint. Omit unless the caller already knows the required capability; ATL normally derives a structured TaskSpec from the task.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'stage', 'capability', 'execution_status', 'fallback_used', 'result', 'decision', 'execution', 'result_validation'], 'properties': {'ok': {'type': 'boolean', 'description': "True only when execution succeeded and ATL's task-level result verifier accepted the result."}, 'stage': {'enum': ['decision', 'execution', 'complete'], 'type': 'string', 'description': 'The furthest ATL product stage reached for this call.'}, 'result': {'type': 'string', 'description': "The provider's task result. When ok=false, inspect result_validation before trusting it."}, 'decision': {'type': ['object', 'null'], 'description': 'ATL Decision evidence retained for advanced/debug consumers.'}, 'execution': {'type': ['object', 'null'], 'description': 'ATL execution evidence retained for advanced/debug consumers; null when execution did not start.'}, 'capability': {'type': 'string', 'description': 'The supported capability selected or inferred for the task; empty if unavailable.'}, 'fallback_used': {'type': 'boolean', 'description': 'Whether bounded fallback/failover was used during execution.'}, 'execution_status': {'type': 'string', 'description': 'Provider execution status; EXECUTED alone does not imply task correctness.'}, 'result_validation': {'type': ['object', 'null'], 'description': 'ATL task-level correctness checks. passed must be true before the result is treated as product success.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'description': 'The natural-language task or routing goal. Include relevant input, constraints, and desired output.'}, 'timeout_ms': {'type': 'integer', 'minimum': 1, 'description': 'Optional time limit for the decision request in milliseconds.'}, 'constraints': {'type': 'object', 'description': 'Optional routing constraints that ATL should honor when selecting an eligible provider or tool.'}, 'max_retries': {'type': 'integer', 'maximum': 2, 'minimum': 0, 'description': 'Optional maximum retries allowed for the decision request.'}, '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.'}, 'desired_outcome': {'type': 'string', 'description': 'Optional result the caller wants from the task.'}, 'required_capability': {'type': 'string', 'description': "Optional capability hint. ATL's Task Intelligence layer normally derives the capability and semantic constraints from the task."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['decision_reference', 'outcome_correlation_token', 'input'], 'properties': {'input': {'type': 'string', 'description': 'The task input to execute with the provider/tool selected by the referenced ATL Decision.'}, 'tenant_scope': {'type': 'string', 'description': 'Optional tenant scope for the execution authorization.'}, 'decision_reference': {'type': 'string', 'description': 'Exact Decision reference returned by ATL. Copy it from atl_decide or next_step; never invent or modify it.'}, 'outcome_correlation_token': {'type': 'string', 'description': 'Exact Outcome correlation token returned with the ATL Decision. Copy it unchanged; never invent or modify it.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['decision_reference', 'outcome_correlation_token', 'outcome_status'], 'properties': {'cancelled': {'type': 'boolean', 'description': 'Whether execution was cancelled before completion.'}, 'error_code': {'type': 'string', 'description': 'Provider error code observed during execution.'}, 'request_id': {'type': 'string', 'description': 'Request identifier associated with the original ATL Decision. Reuse the original value when required by the schema.'}, 'session_id': {'type': 'string', 'description': 'MCP session ID returned by initialize.'}, 'http_status': {'type': 'integer', 'description': 'HTTP status returned by the provider, when applicable.'}, 'provider_id': {'type': 'string', 'description': "Provider identifier associated with the observed execution. Do not use this field to override ATL's selected provider."}, 'failure_type': {'type': 'string', 'description': 'Category of the observed execution failure.'}, 'observed_cost': {'type': 'number', 'description': 'Observed execution cost when known; omit when unavailable unless required by the schema.'}, 'correlation_id': {'type': 'string', 'description': 'Correlation identifier associated with the original ATL Decision. Reuse the original value when required by the schema.'}, 'outcome_status': {'type': 'string', 'description': "Observed outcome status for the referenced Decision/execution, such as success or failure, using the schema's allowed value when constrained."}, 'attempt_outcomes': {'type': 'array', 'description': 'Observed results for individual provider execution attempts.'}, 'final_provider_id': {'type': 'string', 'description': 'Provider that actually completed execution, if it changed.'}, 'decision_reference': {'type': 'string', 'description': 'Exact Decision reference returned by ATL. Copy it from atl_decide or next_step; never invent or modify it.'}, 'observed_latency_ms': {'type': 'number', 'description': 'Observed provider execution latency in milliseconds.'}, 'outcome_correlation_token': {'type': 'string', 'description': 'Exact Outcome correlation token returned with the ATL Decision. Copy it unchanged; never invent or modify it.'}}, 'additionalProperties': False}