Agent Preflight

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['request', 'schema'], 'properties': {'schema': {'type': 'object', 'description': 'JSON Schema applied to request.body', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'request': {'type': 'object', 'required': ['method', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Absolute http(s) URL. This tool never fetches the URL.'}, 'body': {'description': 'JSON body checked against schema'}, 'query': {'type': 'object', 'description': 'Query parameters', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'method': {'type': 'string', 'description': 'HTTP method of the proposed request'}, 'headers': {'type': 'object', 'description': 'HTTP headers as string key/value pairs', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}}, 'economics': {'type': 'object', 'required': ['downstreamCostUsd', 'billsOnInvalidRequest', 'retryCostUsd'], 'properties': {'retryCostUsd': {'type': 'number', 'minimum': 0, 'description': 'USD model/tool-turn cost of one failed attempt'}, 'downstreamCostUsd': {'type': 'number', 'minimum': 0, 'description': 'USD cost of the target API attempt or success'}, 'preflightPriceUsd': {'type': 'number', 'minimum': 0, 'description': 'Price of this check. Default 0.001'}, 'budgetRemainingUsd': {'type': 'number', 'minimum': 0, 'description': 'Remaining agent budget. Checks above this are not +EV'}, 'billsOnInvalidRequest': {'type': 'boolean', 'description': 'True when the target API charges or consumes quota on 4xx'}, 'priorInvalidProbability': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Prior probability the payload is doomed. Default 0.25'}}, 'description': 'Optional V0.2 cost context. Omit for V0.1 validation-only output.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['valid', 'errors', 'warnings', 'requestHash'], 'properties': {'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'object', 'required': ['path', 'code', 'message'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'warnings': {'type': 'array', 'items': {'type': 'object', 'required': ['path', 'code', 'message'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'economics': {'type': 'object', 'required': ['decision', 'reason', 'preflightPriceUsd', 'wasteIfSentUsd', 'realizedNetUsd', 'worthCheckingAPriori', 'aPrioriExpectedWasteUsd', 'aPrioriExpectedNetUsd'], 'properties': {'reason': {'enum': ['valid', 'invalid_doomed_request'], 'type': 'string'}, 'decision': {'enum': ['proceed', 'abort'], 'type': 'string'}, 'realizedNetUsd': {'type': 'number'}, 'wasteIfSentUsd': {'type': 'number'}, 'preflightPriceUsd': {'type': 'number'}, 'worthCheckingAPriori': {'type': 'boolean'}, 'aPrioriExpectedNetUsd': {'type': 'number'}, 'aPrioriExpectedWasteUsd': {'type': 'number'}}, 'additionalProperties': False}, 'requestHash': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['runId', 'stepId', 'tool', 'budget'], 'properties': {'task': {'type': 'object', 'required': ['goalHash'], 'properties': {'goalHash': {'type': 'string'}}}, 'tool': {'type': 'object', 'required': ['provider', 'operation', 'request', 'estimatedExternalCostUsd'], 'properties': {'request': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'provider': {'type': 'string'}, 'operation': {'type': 'string'}, 'estimatedModelCostUsd': {'type': 'number', 'minimum': 0}, 'estimatedExternalCostUsd': {'type': 'number', 'minimum': 0}}}, 'runId': {'type': 'string'}, 'budget': {'type': 'object', 'required': ['remainingUsd'], 'properties': {'reservedUsd': {'type': 'number', 'minimum': 0}, 'remainingUsd': {'type': 'number', 'minimum': 0}, 'maxToolCallsRemaining': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}}, 'stepId': {'type': 'string'}, 'history': {'type': 'array', 'items': {'type': 'object', 'required': ['toolCallId', 'fingerprint', 'outcome', 'ageSeconds'], 'properties': {'outcome': {'enum': ['success', 'terminal_failure', 'transient_failure'], 'type': 'string'}, 'goalHash': {'type': 'string'}, 'ageSeconds': {'type': 'number', 'minimum': 0}, 'toolCallId': {'type': 'string'}, 'fingerprint': {'type': 'string'}, 'resultReference': {'type': 'string'}}}}, 'retryCap': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'capabilities': {'type': 'object', 'properties': {'canReduceScope': {'type': 'boolean'}, 'canReusePriorResult': {'type': 'boolean'}}}, 'preflightPriceUsd': {'type': 'number', 'minimum': 0}, 'freshnessTtlSeconds': {'type': 'number', 'minimum': 0}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['decision', 'enforcement', 'reasonCodes', 'issues'], 'properties': {'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['path', 'code', 'message'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}}, 'decision': {'enum': ['allow', 'block', 'reuse', 'defer', 'advise'], 'type': 'string'}, 'estimated': {'type': 'object', 'required': ['preflightCostUsd', 'priceChargedUsd', 'avoidableExternalCostUsd', 'avoidableModelCostUsd', 'netSavingsUsd', 'billable', 'confidence'], 'properties': {'billable': {'type': 'boolean', 'description': 'Modeled actionable status; MCP is unpaid'}, 'confidence': {'type': 'number', 'description': 'Rule constant, not a calibrated probability'}, 'netSavingsUsd': {'type': 'number'}, 'priceChargedUsd': {'type': 'number', 'description': 'Modeled fee, not a settlement receipt'}, 'preflightCostUsd': {'type': 'number'}, 'avoidableModelCostUsd': {'type': 'number'}, 'avoidableExternalCostUsd': {'type': 'number'}}, 'additionalProperties': False}, 'enforcement': {'enum': ['execute', 'safe_to_skip', 'advisory'], 'type': 'string'}, 'reasonCodes': {'type': 'array', 'items': {'type': 'string'}}, 'matchedCallId': {'type': 'string'}, 'recommendation': {'type': 'object', 'required': ['action'], 'properties': {'action': {'type': 'string'}, 'resultReference': {'type': 'string'}}, 'additionalProperties': False}, 'requestFingerprint': {'type': 'string', 'description': 'SHA-256 of version-2 exact proposal; absent on invalid input'}}, 'additionalProperties': False}