{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/shruggietech/insonic/v1.0.1/schemas/v1.0.1/runtime-response.schema.json",
  "title": "Runtime response",
  "description": "A versioned operation result or redacted typed error. Early CLI errors omit unavailable identities; runtime replies include the workspace, request and session correlation.",
  "type": "object",
  "required": [
    "schema_version",
    "kind"
  ],
  "additionalProperties": false,
  "properties": {
    "schema_version": {
      "const": "1.0.1",
      "description": "Shared software and contract version."
    },
    "kind": {
      "const": "runtime-response",
      "description": "Master-registry document discriminator."
    },
    "workspace_id": {
      "$ref": "common.schema.json#/$defs/uuid",
      "description": "Workspace authority when known."
    },
    "request_id": {
      "$ref": "common.schema.json#/$defs/uuid",
      "description": "Validated request correlation when known."
    },
    "runtime_session_id": {
      "$ref": "common.schema.json#/$defs/uuid",
      "description": "Current runtime owner session when known."
    },
    "result": {
      "type": "object",
      "description": "Operation-specific workspace, diagnostic or attempt result. Resolved credentials are excluded.",
      "properties": {
        "model_selections": {
          "type": "array",
          "items": {
            "$ref": "common.schema.json#/$defs/modelResolution",
            "description": "Frozen exact model selection."
          },
          "maxItems": 128,
          "description": "Exact selected models retained by a durable work election."
        },
        "acquisition_ids": {
          "type": "array",
          "items": {
            "$ref": "common.schema.json#/$defs/uuid",
            "description": "Shared exact-bundle acquisition work identity."
          },
          "maxItems": 128,
          "description": "Separate prerequisite work IDs; pending acquisition never means inference succeeded."
        },
        "model_selection_count": {
          "type": "integer",
          "minimum": 0,
          "description": "Total frozen model/acquisition entries; bounded inspection may show only the first hundred."
        },
        "acquisition_count": {
          "type": "integer",
          "minimum": 0,
          "description": "Total frozen model/acquisition entries; bounded inspection may show only the first hundred."
        }
      }
    },
    "error": {
      "type": "object",
      "description": "Fixed redacted error code and message.",
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false,
      "properties": {
        "code": {
          "enum": [
            "checksum_mismatch",
            "acquisition_timeout",
            "mixed_item_failure",
            "timing_unavailable",
            "invalid_audio",
            "audio_limit",
            "unsupported_audio",
            "model_unavailable",
            "model_acquisition_failed",
            "unsupported_capability",
            "unsupported_retrieval",
            "empty_dataset",
            "unsupported_resume",
            "incompatible_checkpoint",
            "training_incomplete",
            "text_unavailable",
            "input_limit",
            "invalid_engine_output",
            "invalid_timing",
            "engine_ci_forbidden",
            "engine_unavailable",
            "unsupported_device",
            "invalid_embedding",
            "invalid_request",
            "incompatible_version",
            "workspace_mismatch",
            "not_found",
            "conflict",
            "unavailable",
            "cancelled",
            "output_limit",
            "operation_failed",
            "insufficient_space"
          ],
          "description": "Stable machine-readable failure category."
        },
        "message": {
          "type": "string",
          "description": "Fixed diagnostic text without raw child output or credential values."
        },
        "diagnostics": {
          "description": "Redacted condition groups with complete represented occurrence counts and a first generated cue/media pointer, without raw child text.",
          "type": "array",
          "items": {
            "additionalProperties": false,
            "type": "object",
            "required": [
              "code",
              "message",
              "count"
            ],
            "properties": {
              "pointer": {
                "maxLength": 256,
                "type": "string",
                "description": "First generated current document occurrence.",
                "pattern": "^/(media_timing|cues/(0|[1-9][0-9]*)/speaker_attributions/(0|[1-9][0-9]*))$"
              },
              "count": {
                "description": "Number of represented occurrences of this condition.",
                "minimum": 1,
                "type": "integer",
                "maximum": 65536
              },
              "message": {
                "maxLength": 256,
                "type": "string",
                "description": "Fixed locally authored explanation, never raw child output."
              },
              "code": {
                "description": "Fixed current subtitle diagnostic vocabulary or redacted generic condition.",
                "type": "string",
                "pattern": "^[a-z][a-z0-9_]{0,127}$"
              }
            }
          },
          "maxItems": 64
        },
        "reason": {
          "type": "string",
          "enum": [
            "workspace_missing",
            "input_missing",
            "input_invalid",
            "revision_stale",
            "credential_duplicate",
            "credential_capacity",
            "credential_locked",
            "credential_bootstrap",
            "source_map_incompatible",
            "backup_checksum",
            "backup_size",
            "backup_identity",
            "model_not_acquired",
            "model_damaged",
            "model_storage_unavailable",
            "profile_prerequisite",
            "runtime_directory",
            "runtime_owner",
            "runtime_endpoint",
            "runtime_catalog",
            "startup_launch",
            "startup_exit",
            "startup_report",
            "startup_timeout",
            "wait_timeout",
            "wait_interrupted"
          ],
          "description": "Allowlisted locally generated operation condition; never external text."
        }
      }
    }
  },
  "examples": [
    {
      "schema_version": "1.0.1",
      "kind": "runtime-response",
      "error": {
        "code": "unavailable",
        "message": "The selected dependency is unavailable."
      }
    }
  ],
  "anyOf": [
    {
      "required": [
        "result"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}