{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:orbiplex:schema:agent.external-runtime.turn-outcome:v1",
  "title": "Agent External Runtime Turn Outcome v1",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema", "outcome/ref", "turn/ref", "binding/ref", "agent/id", "status",
    "reason/code", "retryability", "budget/reserved", "budget/charged", "usage/fidelity",
    "selected/at", "selected/by"
  ],
  "properties": {
    "schema": { "const": "agent.external-runtime.turn-outcome.v1" },
    "outcome/ref": { "$ref": "#/$defs/ref" },
    "turn/ref": { "$ref": "#/$defs/ref" },
    "binding/ref": { "$ref": "#/$defs/ref" },
    "agent/id": { "$ref": "#/$defs/ref" },
    "status": { "enum": ["completed", "refused", "failed", "cancelled", "unknown"] },
    "reason/code": { "$ref": "#/$defs/reason-code" },
    "retryability": { "enum": ["terminal", "retryable", "reconciliation-required"] },
    "product/ref": { "$ref": "#/$defs/ref" },
    "product/digest": { "$ref": "#/$defs/digest" },
    "budget/reserved": { "$ref": "#/$defs/finite-budget" },
    "budget/charged": { "$ref": "#/$defs/usage-value" },
    "usage/fidelity": { "enum": ["authoritative", "host-measured", "estimated", "unavailable"] },
    "session/checkpoint-ref": { "$ref": "#/$defs/ref" },
    "selected/at": { "type": "string", "format": "date-time" },
    "selected/by": { "$ref": "#/$defs/ref" }
  },
  "allOf": [
    { "if": { "required": ["status"], "properties": { "status": { "const": "completed" } } }, "then": { "required": ["product/ref", "product/digest"] } },
    { "if": { "required": ["status"], "properties": { "status": { "enum": ["refused", "failed", "cancelled", "unknown"] } } }, "then": { "not": { "anyOf": [{ "required": ["product/ref"] }, { "required": ["product/digest"] }] } } },
    { "if": { "required": ["status"], "properties": { "status": { "const": "unknown" } } }, "then": { "properties": { "retryability": { "const": "reconciliation-required" }, "reason/code": { "const": "unknown" } } } }
  ],
  "$defs": {
    "ref": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[^\\s\\u0000-\\u001f\\u007f]+$" },
    "digest": { "type": "string", "pattern": "^sha256:[A-Za-z0-9_-]{43}$" },
    "positive-safe-integer": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
    "finite-budget": {
      "type": "object", "additionalProperties": false,
      "required": ["max_tokens", "max_cost_micros", "max_wall_time_ms", "max_steps"],
      "properties": {
        "max_tokens": { "$ref": "#/$defs/positive-safe-integer" },
        "max_cost_micros": { "$ref": "#/$defs/positive-safe-integer" },
        "max_wall_time_ms": { "$ref": "#/$defs/positive-safe-integer" },
        "max_steps": { "type": "integer", "minimum": 1, "maximum": 4294967295 }
      }
    },
    "usage-value": {
      "type": "object", "additionalProperties": false,
      "required": ["max_tokens", "max_cost_micros", "max_wall_time_ms", "max_steps"],
      "properties": {
        "max_tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
        "max_cost_micros": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
        "max_wall_time_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
        "max_steps": { "type": "integer", "minimum": 0, "maximum": 4294967295 }
      }
    },
    "reason-code": { "enum": [
      "completed", "policy-denied", "binding-missing", "binding-stale", "binding-mismatch",
      "binding-expired", "binding-revoked", "profile-disabled", "profile-mismatch",
      "budget-exhausted", "usage-missing", "usage-malformed", "usage-overflow", "usage-conflict",
      "session-fence-mismatch", "session-lost", "event-malformed", "event-duplicate",
      "event-reordered", "event-oversized", "event-unauthorized", "event-stale", "event-timeout",
      "tool-not-admitted", "approval-not-admitted", "provider-unavailable", "cancelled", "unknown"
    ] }
  }
}