{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/codai-ro/json-schema/codai-ro-sandbox-schema.json",
  "title": "Sandbox",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/codai-ro-sandboxes-api-openapi.yml#/components/schemas/Sandbox",
  "type": "object",
  "required": [
    "id",
    "object",
    "status",
    "backend",
    "template",
    "egress",
    "created_at",
    "expires_at",
    "last_exec_at",
    "metadata",
    "usage"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "object": {
      "type": "string",
      "enum": [
        "sandbox"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "paused",
        "stopped",
        "expired",
        "destroyed"
      ]
    },
    "backend": {
      "type": "string",
      "enum": [
        "v1",
        "v2"
      ],
      "description": "Backend chosen at create time."
    },
    "restored": {
      "type": "boolean",
      "description": "Only on create of a `v2` sandbox: true when it started from a warm template snapshot."
    },
    "template": {
      "type": "string"
    },
    "egress": {
      "$ref": "#/$defs/SandboxEgress"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "last_exec_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "usage": {
      "type": "object",
      "required": [
        "exec_count",
        "exec_seconds"
      ],
      "properties": {
        "exec_count": {
          "type": "integer"
        },
        "exec_seconds": {
          "type": "number"
        }
      }
    }
  },
  "$defs": {
    "SandboxEgress": {
      "title": "Sandbox egress policy",
      "description": "Outbound network, on both backends. `none` (default) has no network at all; `allowlist` lets HTTPS reach at most 20 domains through the codai egress proxy (no IP literals, no internal hosts); `preset` opens a curated list (`pypi`, `npm`). The proxy opens plain tunnels and never injects credentials; v2 forks inherit the parent policy.",
      "oneOf": [
        {
          "type": "object",
          "title": "No network",
          "required": [
            "mode"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "none"
              ]
            }
          }
        },
        {
          "type": "object",
          "title": "Domain allowlist",
          "required": [
            "mode",
            "domains"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "allowlist"
              ]
            },
            "domains": {
              "type": "array",
              "minItems": 1,
              "maxItems": 20,
              "items": {
                "type": "string",
                "maxLength": 253
              },
              "description": "Host names, e.g. `api.anaf.ro`."
            }
          }
        },
        {
          "type": "object",
          "title": "Preset",
          "required": [
            "mode",
            "preset"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "preset"
              ]
            },
            "preset": {
              "type": "string",
              "enum": [
                "pypi",
                "npm"
              ]
            }
          }
        }
      ]
    }
  }
}