{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/lium-io/json-schema/lium-io-executor-schema.json",
  "title": "Executor",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/lium-io-openapi.json#/components/schemas/Executor",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "title": "Created At"
    },
    "updated_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Updated At"
    },
    "miner_hotkey": {
      "type": "string",
      "title": "Miner Hotkey"
    },
    "miner_coldkey": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Miner Coldkey"
    },
    "validator_hotkey": {
      "type": "string",
      "title": "Validator Hotkey"
    },
    "executor_id": {
      "type": "string",
      "format": "uuid",
      "title": "Executor Id"
    },
    "executor_ip_address": {
      "type": "string",
      "title": "Executor Ip Address"
    },
    "executor_checked_ip": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Executor Checked Ip"
    },
    "executor_ip_port": {
      "type": "string",
      "title": "Executor Ip Port"
    },
    "executor_ssh_port": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Executor Ssh Port"
    },
    "specs": {
      "$ref": "#/$defs/MachineSpecs"
    },
    "active": {
      "type": "boolean",
      "title": "Active",
      "default": true
    },
    "machine_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Machine Name"
    },
    "price_per_hour": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Per Hour"
    },
    "price_per_gpu": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Per Gpu"
    },
    "gpu_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Count"
    },
    "gpu_uuid_anchor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gpu Uuid Anchor",
      "description": "Smallest normalized GPU UUID on this machine; stable hardware anchor across hotkey/IP rotation"
    },
    "location_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Location Id"
    },
    "finished_jobs": {
      "type": "integer",
      "title": "Finished Jobs",
      "default": 0
    },
    "uptime_in_minutes": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Uptime In Minutes",
      "default": 0
    },
    "last_counted_job_batch_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Counted Job Batch Id"
    },
    "previous_executor_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Previous Executor Ids"
    },
    "reliability_reset_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reliability Reset Ids"
    },
    "reliability_reset_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reliability Reset At"
    },
    "rental_check_verified_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rental Check Verified Status",
      "default": "RentalCheckVerifiedStatus.RENTAL_CHECK_PENDING"
    },
    "verified": {
      "type": "boolean",
      "title": "Verified",
      "default": false
    },
    "verified_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Verified Date"
    },
    "rental_verification_ssh_key_available": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rental Verification Ssh Key Available",
      "description": "Whether rental verification SSH key was available in the subnet SSH keys"
    },
    "reclaimed": {
      "type": "boolean",
      "title": "Reclaimed",
      "default": false
    },
    "reclaimed_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Reclaimed At"
    },
    "deactivated_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Deactivated At"
    },
    "is_responsive": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Responsive",
      "description": "Whether executor responds to health checks"
    },
    "unresponsive_since": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Unresponsive Since",
      "description": "When the 5-minute ping last flipped is_responsive to False; None while responsive. The provider portal shows it as 'port unreachable since'"
    },
    "availability_errors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array",
      "title": "Availability Errors",
      "description": "Reachability checks the last cycle failed, each with what we saw (DAH-2748)"
    },
    "availability_checked_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Availability Checked At",
      "description": "Scored-at time of the cycle that wrote availability_errors (DAH-2748)"
    },
    "idle_pay_blockers": {
      "anyOf": [
        {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Idle Pay Blockers",
      "description": "Why the last validator cycle paid no idle pay: its incentive_reasons as {code, context}; NULL until a cycle reports them"
    },
    "idle_pay_blockers_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Idle Pay Blockers At",
      "description": "Scored-at time of the cycle that wrote idle_pay_blockers"
    },
    "last_verified_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last Verified At",
      "description": "received_at of the newest passed validator report about this node, set by a trigger on executor_validation_report; the listing reads it instead of the report table. None until a passed report"
    },
    "pending_price_per_hour": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pending Price Per Hour",
      "description": "Pending price per hour that will be applied when price_change_effective_date is reached"
    },
    "price_change_effective_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Change Effective Date",
      "description": "Date when the pending price change will become effective"
    }
  },
  "type": "object",
  "required": [
    "miner_hotkey",
    "validator_hotkey",
    "executor_id",
    "executor_ip_address",
    "executor_ip_port",
    "specs",
    "machine_name",
    "location_id"
  ],
  "$defs": {
    "Checksums": {
      "properties": {
        "nvidia_smi": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvidia Smi"
        },
        "libnvidia_ml": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Libnvidia Ml"
        },
        "docker": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docker"
        }
      },
      "type": "object",
      "title": "Checksums"
    },
    "CpuSpec": {
      "properties": {
        "count": {
          "type": "integer",
          "title": "Count"
        },
        "model": {
          "type": "string",
          "title": "Model"
        },
        "utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Utilization"
        }
      },
      "type": "object",
      "required": [
        "count",
        "model"
      ],
      "title": "CpuSpec"
    },
    "DiskHealthSpec": {
      "properties": {
        "docker_root_dir": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Docker Root Dir"
        },
        "read_only_mounts": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Read Only Mounts"
        },
        "write_probe": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Write Probe"
        },
        "write_probe_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Write Probe Error"
        }
      },
      "type": "object",
      "title": "DiskHealthSpec",
      "description": "DAH-2929: the validator's disk probe (lium-io DAH-2928, lium-io#1278), one cycle's readings.\n\nlium-io#1278 (15 Sep, value audit) sends four keys: ``docker_root_dir``, ``read_only_mounts``,\n``write_probe`` and ``write_probe_error``. Each is what the scrape measured that cycle; None or\nempty where it could not. The dmesg, sysfs, NVMe and SMART readers were cut from the probe before\nit shipped and are not declared here; a follow-up in lium-io that re-adds a reader declares its key\nhere in the same change.\n\nCONTRACT OBLIGATION (same as GpuMetrics): MachineSpecs validates with Pydantic's default\n``extra=\"ignore\"``, so a probe key the validator starts emitting that is not declared here is\nstripped on the upsert, not stored. Declare it here to keep it.\n\nOnly PUBLIC_DISK_HEALTH_FIELDS leave the API on the anonymous routes (``ExecutorForPodResponse`` serializes\nspecs through ``public_specs_projection``, ``BillingHistoryForMinerResponse`` serves only the GPU name and count;\n``ExecutorForProviderResponse`` declares the same two fields in ``PublicDiskHealth``, DAH-3462): the\nfree-text readings (docker root path, exception text) stay in the\nstored specs for operators. The machine request owner's ``GET /machine-requests/{id}/executors`` serves the\nrow's address fields (DAH-2554: ip, ssh port, coldkey by design) and the projected specs (DAH-4180)."
    },
    "DiskPressureSpec": {
      "properties": {
        "syncfs_seconds": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Syncfs Seconds"
        },
        "syncfs_timed_out": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Syncfs Timed Out"
        },
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "mb_per_s": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Mb Per S"
        },
        "util_percent": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Util Percent"
        },
        "await_ms": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Await Ms"
        },
        "dirty_mb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Dirty Mb"
        },
        "writeback_mb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Writeback Mb"
        },
        "psi_io_full_avg10": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Psi Io Full Avg10"
        },
        "pressure": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pressure"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reason"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Error"
        }
      },
      "type": "object",
      "title": "DiskPressureSpec",
      "description": "What the validator read on the host right before it started its port-check container.\n\n`syncfs_seconds` is how long `sync -f` on the Docker root took (capped at the validator's poll\nbudget, then `syncfs_timed_out`): the wait every `docker run` pays while a tenant's dirty pages\nsit on that filesystem. The disk and memory fields are telemetry around it. Every field is None\nwhen that part could not be read; `error` says why the whole reading is missing."
    },
    "DockerSpec": {
      "properties": {
        "version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Version"
        },
        "container_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Container Id"
        },
        "containers": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Containers"
        },
        "host_cpu_percent": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Host Cpu Percent"
        }
      },
      "type": "object",
      "title": "DockerSpec"
    },
    "GpuActivitySpec": {
      "properties": {
        "index": {
          "type": "integer",
          "title": "Index"
        },
        "uuid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Uuid"
        },
        "util_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Util Pct"
        },
        "vram_used_mb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Used Mb"
        },
        "vram_total_mb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Total Mb"
        },
        "no_pod": {
          "type": "boolean",
          "title": "No Pod"
        }
      },
      "type": "object",
      "required": [
        "index",
        "no_pod"
      ],
      "title": "GpuActivitySpec",
      "description": "One GPU's load at scrape time next to whether a rental held it — a rule input, not a verdict.\n\nDerived by the backend on every validator report (`services/gpu_activity.py`, called from\n`worker.save_executor_into_db`), never sent by the validator. `util_pct` and `vram_used_mb` are\n`gpu.details[].gpu_utilization` / `memory_used_mb` of the same report; `no_pod` is \"no\n`executor_gpu` row with this `uuid` has a `pod_id`\" at save time — the backend's own record of\nwhich GPU a rental holds, which the scrape cannot see (its `gpu_processes` is read from inside\nthe executor container, so a process on the host is invisible to it: rel-box-34 case 11, executor\n252f0496, 14-100 % utilisation for hours with no pod and `gpu_processes` `[]` in 672/672 snapshots).\n\n`no_pod` says nothing about a default job (filler): a filler holds no `executor_gpu.pod_id`, so a\nGPU it uses reads `no_pod: true` with load. A consumer excludes fillers through\n`specs.docker.containers` (`filler_` prefix), as the loop's host-load detector already does."
    },
    "GpuMetrics": {
      "properties": {
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "cc": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cc"
        },
        "sm_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sm Count"
        },
        "clock_mhz": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Clock Mhz"
        },
        "vram_gb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vram Gb"
        },
        "n": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "N"
        },
        "fp32_tflops": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Tflops"
        },
        "fp32_median_tflops": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Median Tflops"
        },
        "fp32_cov_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fp32 Cov Pct"
        }
      },
      "type": "object",
      "title": "GpuMetrics",
      "description": "FP32 throughput metrics from libdmcompverify.so getMetrics() (device-0 representative).\n\nAll fields are optional: the .so may emit a subset, and the whole object is absent\nwhen TFLOPS benchmarking is disabled or fails (fail-safe).\n\nCONTRACT OBLIGATION: this model mirrors getMetrics() output. Because MachineSpecs has\n`extra` unset (Pydantic defaults to ignore -> undeclared keys are stripped on\nvalidation), any NEW field that libdmcompverify.so's getMetrics() starts emitting MUST\nbe added here too, or it is silently dropped on coercion. Adding the field here is the\ndocumented way to surface it; failing to do so is a silent-strip data-loss bug, not a\ncrash."
    },
    "GpuSpec": {
      "properties": {
        "count": {
          "type": "integer",
          "title": "Count"
        },
        "driver": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Driver"
        },
        "cuda_driver": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cuda Driver"
        },
        "details": {
          "items": {
            "$ref": "#/$defs/ReportedGpuDetail"
          },
          "type": "array",
          "title": "Details"
        }
      },
      "type": "object",
      "required": [
        "count",
        "details"
      ],
      "title": "GpuSpec"
    },
    "HardDiskSpec": {
      "properties": {
        "total": {
          "type": "integer",
          "title": "Total"
        },
        "used": {
          "type": "integer",
          "title": "Used"
        },
        "free": {
          "type": "integer",
          "title": "Free"
        },
        "utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Utilization"
        },
        "images": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Images"
        },
        "containers": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Containers"
        },
        "volumes": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Volumes"
        },
        "disk_type": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "nvme",
                "ssd",
                "hdd",
                "unknown"
              ]
            },
            {
              "type": "null"
            }
          ],
          "title": "Disk Type"
        },
        "engy_cache_used_gb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Engy Cache Used Gb"
        },
        "engy_cache_released_gb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Engy Cache Released Gb"
        },
        "by_volume": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "By Volume"
        },
        "by_container": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "By Container"
        }
      },
      "type": "object",
      "required": [
        "total",
        "used",
        "free"
      ],
      "title": "HardDiskSpec"
    },
    "InfinibandPortSpec": {
      "properties": {
        "device": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device"
        },
        "port": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Port"
        },
        "node_guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Node Guid"
        },
        "sys_image_guid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sys Image Guid"
        },
        "link_layer": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Link Layer"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "State"
        },
        "phys_state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Phys State"
        },
        "rate": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Rate"
        },
        "lid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Lid"
        },
        "sm_lid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sm Lid"
        },
        "pkey": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pkey"
        },
        "gids": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gids"
        },
        "driver": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Driver"
        }
      },
      "type": "object",
      "title": "InfinibandPortSpec",
      "description": "One RDMA port as the executor's kernel reports it (DAH-2571).\n\n`link_layer` is the ONLY safe way to tell InfiniBand from RoCE: mlx5 reports `lid` 0x0 on an\nEthernet port but Intel irdma reports 0x1, measured on prod 2026-08-05.\n\nWhat identifies a fabric: on InfiniBand, `sm_lid` with the LID set — a host running its own\nsubnet manager reports `sm_lid` 0x1 pointing at its own port, so it is a one-host subnet, while\nan external switch-side SM shows up as something else (0xe on the one real multi-node fabric in\nthe fleet). On RoCE it is the IPv4-mapped entry of `gids` — find it by the\n`0000:0000:0000:0000:0000:ffff:` prefix, never by index: mlx5 puts it at 2-3, Intel irdma at 1.\nThe GID prefix is NOT usable — every prod port carries the default `fe80::`.\n\nThose IPv4-mapped addresses are private (172.16/10.x observed on prod), so they identify a\nsegment only WITHIN one provider — two providers can hand out the same one. Pair on them only\ntogether with something provider-scoped.\n\n`rate` is meaningful only while `state` is ACTIVE; on a DOWN port the driver fills in a\nplaceholder rather than the card's real capability."
    },
    "InterconnectSpec": {
      "properties": {
        "gpu_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Count"
        },
        "gpu_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Pairs"
        },
        "nvlink": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink"
        },
        "nvlink_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Links"
        },
        "nvlink_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Pairs"
        },
        "nvlink_active_links": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvlink Active Links"
        },
        "pcie_class": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pcie Class"
        },
        "p2p": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P"
        },
        "p2p_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Pairs"
        },
        "p2p_ok_pairs": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "P2P Ok Pairs"
        },
        "matrix": {
          "anyOf": [
            {
              "items": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Matrix"
        }
      },
      "type": "object",
      "title": "InterconnectSpec",
      "description": "How the GPUs of one host are wired to each other, from the validator's `nvidia-smi topo` run.\n\nScraped by lium-io DAH-2922, declared and exposed here (DAH-2923).\n`nvlink` is True only when EVERY GPU pair is joined by NVLink (an HGX board); a box with NVLink\nbridges on some pairs reports False with `nvlink_pairs` < `gpu_pairs`. `p2p` is True only when\nevery pair of `nvidia-smi topo -p2p r` reads OK — False is the host where NCCL cannot start\nwithout NCCL_P2P_DISABLE=1. Both are None on a single-GPU host (nothing to judge) and when the\ntable that answers them could not be read (`interconnect_scrape_error` on MachineSpecs says why).\n`pcie_class` is nvidia-smi's worst class among the non-NVLink pairs (SYS > NODE > PHB > PXB > PIX).\n`matrix` is the GPU x GPU cell table, kept so a client can print the topology."
    },
    "MachineSpecs": {
      "properties": {
        "gpu": {
          "$ref": "#/$defs/GpuSpec"
        },
        "cpu": {
          "$ref": "#/$defs/CpuSpec"
        },
        "ram": {
          "$ref": "#/$defs/MemorySpec"
        },
        "hard_disk": {
          "anyOf": [
            {
              "$ref": "#/$defs/HardDiskSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "os": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Os"
        },
        "kernel": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Kernel"
        },
        "kernel_scrape_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Kernel Scrape Error"
        },
        "network": {
          "anyOf": [
            {
              "$ref": "#/$defs/NetworkSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "md5_checksums": {
          "anyOf": [
            {
              "$ref": "#/$defs/Checksums"
            },
            {
              "type": "null"
            }
          ]
        },
        "docker": {
          "anyOf": [
            {
              "$ref": "#/$defs/DockerSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "gpu_processes": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Processes"
        },
        "available_port_maps": {
          "anyOf": [
            {
              "items": {
                "prefixItems": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "integer"
                  }
                ],
                "type": "array",
                "maxItems": 2,
                "minItems": 2
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Available Port Maps"
        },
        "available_port_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Available Port Count"
        },
        "split_disk": {
          "anyOf": [
            {
              "$ref": "#/$defs/SplitDiskSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "sysbox_runtime": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sysbox Runtime"
        },
        "sysbox_version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sysbox Version"
        },
        "storage_limit_supported": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Storage Limit Supported"
        },
        "idle_disk_write_mb_per_s": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Idle Disk Write Mb Per S"
        },
        "idle_disk_write_measured_at": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Idle Disk Write Measured At"
        },
        "ncu_profiling_access": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ncu Profiling Access"
        },
        "ncu_profiling_scrape_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ncu Profiling Scrape Error"
        },
        "container_cap_eff": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Container Cap Eff"
        },
        "nvidiactl_owner_uid": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Nvidiactl Owner Uid"
        },
        "power_cap_probe_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Cap Probe Error"
        },
        "boot_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Boot Id"
        },
        "egress_ip": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Egress Ip"
        },
        "port_range": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Port Range"
        },
        "port_mappings": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Port Mappings"
        },
        "verified_ports": {
          "anyOf": [
            {
              "items": {
                "type": "integer"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verified Ports"
        },
        "tdx_attestation_passed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tdx Attestation Passed",
          "default": false
        },
        "tdx_host_supported": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tdx Host Supported"
        },
        "is_spot": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Is Spot",
          "default": false
        },
        "gpu_metrics": {
          "anyOf": [
            {
              "$ref": "#/$defs/GpuMetrics"
            },
            {
              "type": "null"
            }
          ]
        },
        "infiniband_ports": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/InfinibandPortSpec"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Infiniband Ports"
        },
        "infiniband_scrape_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Infiniband Scrape Error"
        },
        "roce_link_measurements": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/RoceLinkMeasurementSpec"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Roce Link Measurements"
        },
        "efa_link_measurements": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/RoceLinkMeasurementSpec"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Efa Link Measurements"
        },
        "provider_side_load": {
          "anyOf": [
            {
              "$ref": "#/$defs/ProviderSideLoadSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "disk_pressure": {
          "anyOf": [
            {
              "$ref": "#/$defs/DiskPressureSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "kernel_gpu_uuids": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Kernel Gpu Uuids"
        },
        "kernel_gpu_uuids_last_seen": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Kernel Gpu Uuids Last Seen"
        },
        "disk_health": {
          "anyOf": [
            {
              "$ref": "#/$defs/DiskHealthSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "disk_health_scrape_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Disk Health Scrape Error"
        },
        "interconnect": {
          "anyOf": [
            {
              "$ref": "#/$defs/InterconnectSpec"
            },
            {
              "type": "null"
            }
          ]
        },
        "interconnect_scrape_error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Interconnect Scrape Error"
        },
        "gpu_activity": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/GpuActivitySpec"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Activity"
        },
        "job_batch_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Job Batch Id"
        },
        "gpu_power_cap_capable": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Power Cap Capable",
          "readOnly": true
        }
      },
      "type": "object",
      "required": [
        "gpu",
        "cpu",
        "ram",
        "gpu_power_cap_capable"
      ],
      "title": "MachineSpecs"
    },
    "MemorySpec": {
      "properties": {
        "total": {
          "type": "number",
          "title": "Total"
        },
        "used": {
          "type": "number",
          "title": "Used"
        },
        "free": {
          "type": "number",
          "title": "Free"
        },
        "available": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Available"
        },
        "utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Utilization"
        }
      },
      "type": "object",
      "required": [
        "total",
        "used",
        "free"
      ],
      "title": "MemorySpec"
    },
    "NetworkSpec": {
      "properties": {
        "upload_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Upload Speed"
        },
        "download_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Download Speed"
        },
        "verifyx_download_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verifyx Download Speed"
        },
        "verifyx_upload_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Verifyx Upload Speed"
        },
        "ema_download_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ema Download Speed"
        },
        "ema_upload_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ema Upload Speed"
        },
        "ema_verifyx_download_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ema Verifyx Download Speed"
        },
        "ema_verifyx_upload_speed": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ema Verifyx Upload Speed"
        }
      },
      "type": "object",
      "title": "NetworkSpec"
    },
    "ProviderSideLoadSpec": {
      "properties": {
        "cpu_cores": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cpu Cores"
        },
        "disk_kb": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Disk Kb"
        }
      },
      "type": "object",
      "title": "ProviderSideLoadSpec",
      "description": "DAH-2734: what the machine's OWNER consumes outside Lium's containers.\n\nThe validator computes it and sends it with the specs, so the fleet cut is a plain JSON read.\nEach part is None when the scrape could not measure it that cycle - never a guess."
    },
    "ReportedGpuDetail": {
      "properties": {
        "name": {
          "type": "string",
          "title": "Name"
        },
        "cuda": {
          "type": "string",
          "title": "Cuda"
        },
        "power_limit": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Limit"
        },
        "power_default_limit": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Default Limit"
        },
        "power_max_limit": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Max Limit"
        },
        "power_min_limit": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Min Limit"
        },
        "graphics_speed": {
          "type": "integer",
          "title": "Graphics Speed"
        },
        "memory_speed": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Memory Speed"
        },
        "pcie": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pcie"
        },
        "pcie_speed": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pcie Speed"
        },
        "capacity": {
          "type": "integer",
          "title": "Capacity"
        },
        "gpu_utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gpu Utilization"
        },
        "memory_utilization": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Memory Utilization"
        },
        "memory_used_mb": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Memory Used Mb"
        },
        "temperature": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Temperature"
        },
        "uuid": {
          "type": "string",
          "title": "Uuid"
        },
        "power_host_limit": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Host Limit"
        }
      },
      "type": "object",
      "required": [
        "name",
        "cuda",
        "graphics_speed",
        "capacity",
        "uuid"
      ],
      "title": "ReportedGpuDetail"
    },
    "RoceLinkMeasurementSpec": {
      "properties": {
        "peer_executor_uuid": {
          "type": "string",
          "title": "Peer Executor Uuid"
        },
        "peer_address": {
          "type": "string",
          "title": "Peer Address"
        },
        "gigabits_per_second": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gigabits Per Second"
        },
        "measured_at": {
          "type": "string",
          "title": "Measured At"
        }
      },
      "type": "object",
      "required": [
        "peer_executor_uuid",
        "peer_address",
        "measured_at"
      ],
      "title": "RoceLinkMeasurementSpec",
      "description": "What the validator measured between this host and ONE neighbour on its segment (DAH-2667).\n\nA RoCE fabric is otherwise only inferred from addresses, and a shared segment is not proof that\nthe switch carries RDMA. The validator runs `ib_write_bw` between the free hosts of a segment\nand writes one of these per pair into the specs of BOTH hosts, each naming the other.\n\n`gigabits_per_second` is None when that pair could not talk — a recorded failure, not silence."
    },
    "SplitDiskSpec": {
      "properties": {
        "free_split_count": {
          "type": "integer",
          "title": "Free Split Count"
        },
        "listable_split_count": {
          "type": "integer",
          "title": "Listable Split Count"
        },
        "listable_gpu_count": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Listable Gpu Count"
        }
      },
      "type": "object",
      "required": [
        "free_split_count",
        "listable_split_count"
      ],
      "title": "SplitDiskSpec",
      "description": "The validator's disk verdict for the free splits of a partly rented split node (DAH-4961)."
    }
  }
}