Logical Resource Broker and Decoder Schemas — Operating Quantum Computers

This appendix provides schema sketches for logical resource scheduling, decoder release governance, and fault-tolerant service evidence.

Diagram loads as you read

Logical Resource Broker and Decoder Schemas · Figure 1

View diagram source

flowchart LR
    Schema[Schema] --> Contract[Contract]
    Contract --> Validation[Validation]
    Validation --> Execution[Execution]
    Execution --> Evidence[Evidence]

Logical workload contract

Illustrative listing · yaml

logical_workload_contract:
  id: lwc-0001
  objective: estimate_energy
  priority_class: validation
  target_family:
    allowed:
      - superconducting_surface_code
      - trapped_ion_color_code
  logical_requirements:
    max_logical_error_probability: 1.0e-6
    logical_qubits: 128
    min_code_distance: 17
  resources:
    max_physical_qubits: 250000
    max_syndrome_cycles: 100000000
    max_magic_states: 50000000
    decoder_bandwidth: required
  evidence:
    level: full_internal
    raw_shots_required: true
    decoder_trace_required: true
  abort_conditions:
    - decoder_deadline_miss_rate_gt_0_001
    - calibration_epoch_change
    - factory_error_rate_above_budget

Logical broker decision record

Illustrative listing · yaml

broker_decision:
  workload_id: lwc-0001
  decision: accepted
  limiting_resource: magic_state_factory
  allocation:
    logical_qubits: 128
    code_distance: 19
    factories: 4
    decoder_pool: gpu-decoder-pool-a
    reserved_window: 2026-05-10T08:00:00Z/2026-05-10T14:00:00Z
  assumptions:
    resource_estimator_version: re-3.4.1
    compiler_profile: ft-profile-2026-04
    factory_model: factory-v2
  reviewer:
    id: quantum-platform-review
    decision_hash: sha256:...

Diagram loads as you read

Logical broker decision record · Figure 2

View diagram source

flowchart TB
    Request[Request] --> Estimate[Estimate]
    Estimate --> Capacity[Capacity check]
    Capacity --> Decision[Decision]
    Decision --> Allocation[Allocation record]
    Allocation --> Evidence[Evidence]

Decoder release record

Illustrative listing · yaml

decoder_release:
  decoder_id: surface-decoder-prod
  version: 2.8.0
  type: neural_predecoder_plus_matching
  compatible_targets:
    - processor_family: surface_code_v1
      min_controller_version: 6.2.0
  performance:
    p99_latency_us: 7.5
    deadline_miss_rate: 0.00001
    shadow_divergence_rate: 0.0002
  training_data:
    dataset_id: syndrome-corpus-2026-04
    contamination_review: passed
  validation:
    baseline_decoder: matching-1.9
    stress_suite: decoder-stress-2026q2
    reviewer: decoder-cab
  rollback:
    previous_version: 2.7.4
    automatic_rollback_conditions:
      - p99_latency_us_gt_10
      - shadow_divergence_rate_gt_0.001

Diagram loads as you read

Decoder release record · Figure 3

View diagram source

stateDiagram-v2
    [*] --> Draft
    Draft --> Benchmarked
    Benchmarked --> Canary
    Canary --> Production
    Canary --> Rejected
    Production --> RolledBack

Decoder telemetry envelope

Illustrative listing · json

{
  "decoder_event_id": "dec-evt-0001",
  "run_id": "run-123",
  "decoder_id": "surface-decoder-prod",
  "decoder_version": "2.8.0",
  "target_snapshot": "target-sha256-...",
  "syndrome_batch": 14892,
  "latency_us": 6.8,
  "deadline_missed": false,
  "confidence": 0.997,
  "correction_weight": 4,
  "fallback_used": false,
  "shadow_compare": {
    "available": true,
    "diverged": false
  }
}

Fault-tolerant execution evidence manifest

Illustrative listing · yaml

ft_execution_manifest:
  run_id: ft-run-0001
  workload_contract: lwc-0001
  broker_decision: broker-decision-0001
  target_snapshot: sha256:...
  calibration_epoch: cal-2026-05-10-a
  compiler_profile: ft-profile-2026-04
  decoder_release: surface-decoder-prod@2.8.0
  runtime_window:
    start: 2026-05-10T08:11:04Z
    end: 2026-05-10T13:52:18Z
  artifacts:
    logical_trace: sha256:...
    syndrome_summary: sha256:...
    decoder_telemetry: sha256:...
    verification_report: sha256:...
  claim_status: qualified

Broker API sketch

Illustrative listing · yaml

openapi: 3.1.0
info:
  title: Logical Quantum Broker API
  version: 0.1.0
paths:
  /logical-workloads:
    post:
      summary: Submit a logical workload contract
      responses:
        '202':
          description: Workload submitted for admission review
  /logical-workloads/{id}/decision:
    get:
      summary: Retrieve broker decision and allocation
      parameters:
        - name: id
          in: path
          required: true
          schema: {type: string}
      responses:
        '200':
          description: Broker decision and any allocation
  /decoder-releases:
    post:
      summary: Register decoder release candidate
      responses:
        '201':
          description: Decoder release candidate registered
  /evidence/{run_id}:
    get:
      summary: Retrieve fault-tolerant execution manifest
      parameters:
        - name: run_id
          in: path
          required: true
          schema: {type: string}
      responses:
        '200':
          description: Fault-tolerant execution manifest

Diagram loads as you read

Broker API sketch · Figure 4

View diagram source

flowchart LR
    API[Broker API] --> Workloads[Workload contracts]
    API --> Decisions[Broker decisions]
    API --> Decoders[Decoder releases]
    API --> Evidence[Execution evidence]

Additional technical sources: [R238].