XportL

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "gpu_count"
  ],
  "properties": {
    "gpu_count": {
      "type": "integer",
      "maximum": 2000000,
      "minimum": 1,
      "description": "Total GPUs in the cluster (or in the jobs being analyzed)."
    },
    "gpu_model": {
      "enum": [
        "a100",
        "h100",
        "h200",
        "b200",
        "gb200",
        "mi300x",
        "other"
      ],
      "type": "string",
      "default": "h100",
      "description": "GPU model, used only to pick a default cost per GPU-hour when gpu_hour_cost_usd is not given."
    },
    "recovery_pct": {
      "type": "number",
      "default": 25,
      "maximum": 100,
      "minimum": 0,
      "description": "Recovery scenario: share of the degradation-induced throughput loss you expect to recover by detecting and acting on degradation sooner. A planning assumption, not a measured XportL result. Default 25."
    },
    "comm_share_pct": {
      "type": "number",
      "default": 25,
      "maximum": 90,
      "minimum": 1,
      "description": "Share of a healthy training step spent in collective communication that is NOT overlapped with compute. Typically 10 to 40% for large-scale training. Default 25."
    },
    "utilization_pct": {
      "type": "number",
      "default": 80,
      "maximum": 100,
      "minimum": 1,
      "description": "Share of hours the GPUs are running distributed jobs. Default 80."
    },
    "degraded_time_pct": {
      "type": "number",
      "default": 10,
      "maximum": 100,
      "minimum": 0,
      "description": "Share of running time the fabric is degraded (flapping links, congestion, bad cables/optics, misrouted paths). Default 10."
    },
    "gpu_hour_cost_usd": {
      "type": "number",
      "maximum": 100,
      "minimum": 0.05,
      "description": "Actual fully-loaded cost per GPU-hour in USD (amortized hardware + power + facility, or cloud rate). Strongly preferred over the default."
    },
    "training_run_days": {
      "type": "number",
      "maximum": 3650,
      "minimum": 0.1,
      "description": "Optional: planned wall-clock length of one training run on this cluster, to show how many days degradation adds to it."
    },
    "bandwidth_loss_pct": {
      "type": "number",
      "default": 40,
      "maximum": 90,
      "minimum": 1,
      "description": "Collective bus bandwidth lost while degraded, vs. healthy. Measure with nccl-tests (see analyze_nccl_benchmark). Default 40."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fabrics",
    "gpu_vendor",
    "deployment"
  ],
  "properties": {
    "fabrics": {
      "type": "array",
      "items": {
        "enum": [
          "infiniband",
          "roce_v2",
          "nvlink",
          "ethernet_tcp",
          "omni_path",
          "slingshot",
          "efa",
          "other"
        ],
        "type": "string"
      },
      "maxItems": 8,
      "minItems": 1,
      "description": "Every interconnect the GPU jobs use, e.g. ['infiniband','nvlink']. efa = AWS Elastic Fabric Adapter."
    },
    "host_os": {
      "enum": [
        "linux",
        "windows",
        "other"
      ],
      "type": "string",
      "default": "linux",
      "description": "Host operating system on the GPU nodes."
    },
    "gpu_count": {
      "type": "integer",
      "maximum": 2000000,
      "minimum": 1,
      "description": "Total GPUs, for context."
    },
    "deployment": {
      "enum": [
        "on_prem",
        "cloud",
        "hybrid",
        "colo"
      ],
      "type": "string",
      "description": "Where the cluster runs."
    },
    "gpu_vendor": {
      "enum": [
        "nvidia",
        "amd",
        "intel",
        "other"
      ],
      "type": "string",
      "description": "GPU vendor."
    },
    "host_access": {
      "enum": [
        "root",
        "privileged_containers",
        "none",
        "unknown"
      ],
      "type": "string",
      "default": "unknown",
      "description": "Can you run a privileged agent on the GPU hosts? eBPF needs root or CAP_BPF/CAP_PERFMON. 'none' = fully managed service with no host access."
    },
    "linux_kernel": {
      "type": "string",
      "maxLength": 80,
      "description": "Host kernel version as printed by `uname -r`, e.g. '5.15.0-105-generic'. Leave empty for non-Linux hosts or if unknown."
    },
    "orchestrator": {
      "enum": [
        "slurm",
        "kubernetes",
        "ray",
        "bare_metal",
        "other"
      ],
      "type": "string",
      "description": "Job scheduler / orchestrator, for context."
    },
    "collective_library": {
      "type": "array",
      "items": {
        "enum": [
          "nccl",
          "rccl",
          "oneccl",
          "gloo",
          "mpi_only",
          "other"
        ],
        "type": "string"
      },
      "default": [
        "nccl"
      ],
      "maxItems": 6,
      "minItems": 1,
      "description": "Collective communication libraries in use. Default ['nccl']."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "gpu_count",
    "checkpoint_write_minutes"
  ],
  "properties": {
    "gpu_count": {
      "type": "integer",
      "maximum": 2000000,
      "minimum": 8,
      "description": "GPUs in the training job."
    },
    "job_mttf_hours": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0.05,
      "description": "Measured mean time between job-interrupting failures for a job this size, in hours. If omitted, it is estimated from Meta's published 2024 cluster reliability data."
    },
    "restart_minutes": {
      "type": "number",
      "default": 20,
      "maximum": 1440,
      "minimum": 0.5,
      "description": "Time from a failure to training resuming: detection, rescheduling, process start and checkpoint load, in minutes. Default 20."
    },
    "gpu_hour_cost_usd": {
      "type": "number",
      "default": 2.75,
      "maximum": 100,
      "minimum": 0.05,
      "description": "Cost per GPU-hour in USD. Default 2.75."
    },
    "checkpoint_write_minutes": {
      "type": "number",
      "maximum": 600,
      "minimum": 0.05,
      "description": "Time training is blocked while a checkpoint is written, in minutes. With asynchronous checkpointing, use only the blocking part."
    },
    "current_interval_minutes": {
      "type": "number",
      "maximum": 100000,
      "minimum": 1,
      "description": "Current checkpoint interval in minutes, to compare against the recommendation."
    }
  }
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "email",
    "company",
    "interest",
    "summary",
    "user_confirmed"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "The person's full name."
    },
    "role": {
      "type": "string",
      "maxLength": 100,
      "description": "Job title, e.g. 'Director of ML Infrastructure'."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 200,
      "description": "Work email address."
    },
    "phone": {
      "type": "string",
      "maxLength": 40,
      "description": "Phone number, optional."
    },
    "fabric": {
      "type": "string",
      "maxLength": 200,
      "description": "Fabric(s) and GPU types, e.g. 'NDR InfiniBand + NVLink, H100'."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "description": "Company or organization."
    },
    "summary": {
      "type": "string",
      "maxLength": 3000,
      "minLength": 20,
      "description": "What they need in a few sentences: cluster, symptoms, workloads, timeline, and any results from this conversation (benchmark status, cost estimate, compatibility verdict)."
    },
    "interest": {
      "enum": [
        "technical_assessment",
        "demo_deployment",
        "pilot",
        "pricing",
        "partnership",
        "other"
      ],
      "type": "string",
      "description": "What they want from XportL."
    },
    "cluster_gpus": {
      "type": "integer",
      "maximum": 2000000,
      "minimum": 1,
      "description": "Approximate number of GPUs in the cluster(s)."
    },
    "user_confirmed": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Only set it after showing the user exactly what will be sent and the user agreed to share it with XportL."
    }
  }
}