{"openapi":"3.1.0","info":{"title":"Sparse Supernova USL Transport API","version":"0.1.0","description":"Pre-flight USL v3.1.1 transport modelling and receipt layer. Claim levels: research_harness_preflight_only (core transport), template_generation_and_calibration_assist_only (QM Bridge), control_recommendation_only (Control Assist). API/model-validated coherence-loss law for pre-flight planning — not physically validated quantum transport."},"servers":[{"url":"https://signal.sparse-supernova.com"}],"tags":[{"name":"USL","description":"Universal Saturation Law transport and field routes"}],"paths":{"/api/v1/usl":{"get":{"summary":"Catalogue","responses":{"200":{"description":"Service catalogue"}}}},"/api/v1/usl/status":{"get":{"summary":"Status","responses":{"200":{"description":"Operational status"}}}},"/api/v1/usl/transport/simulate":{"post":{"summary":"Run transport protocol","description":"claim_level: research_harness_preflight_only. Pre-flight USL monolith receipt; may include closed_form_coherence_loss and qm_bridge when t_window > 0.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportSimulateInput"}}}},"responses":{"200":{"description":"Transport receipt (ok may be false). Includes closed_form_coherence_loss when D_target or D_suppress is set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportSimulateResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/transport/coherence-loss":{"post":{"summary":"Closed-form transport coherence loss CL(D_target)","description":"claim_level: research_harness_preflight_only. CL = (2D+1)/(D+1)^2 D-only law. Conservative QEC rule: D_target > 200 for CL < 1%. API/model-validated; not physically validated quantum transport.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoherenceLossInput"}}}},"responses":{"200":{"description":"Coherence loss receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoherenceLossResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/transport/qec-threshold":{"post":{"summary":"Minimum integer D_target for loss target","description":"claim_level: research_harness_preflight_only. Exact min integer D=199 at 1% loss; conservative operator rule D_target > 200.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QecThresholdInput"}}}},"responses":{"200":{"description":"QEC threshold receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QecThresholdResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/control/recommend":{"post":{"summary":"USL Control Assist bounded recommendation","description":"claim_level: control_recommendation_only. Theory-B-weighted bounded proportional recommendation only — not autonomous control, not Sontag/CLF stable. Requires /transport/simulate before QUA/OPX.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlRecommendInput"}}}},"responses":{"200":{"description":"Control recommendation receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlRecommendResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/lab/transport-result":{"post":{"summary":"Lab validation transport receipt","description":"claim_level: lab_validation_receipt_only. Compares predicted CL to measured_CL. stored false, model_update none. Does not certify physical transport.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabTransportResultInput"}}}},"responses":{"200":{"description":"Validation receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabTransportResultResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/qm/qua-template":{"post":{"summary":"USL-QM Bridge QUA/Python template","description":"claim_level: template_generation_and_calibration_assist_only. Reviewable QUA/Python template only; requires local QM config and lab review. Does not call qm.execute or run OPX jobs.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuaTemplateInput"}}}},"responses":{"200":{"description":"QUA template receipt (success and ok true)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuaTemplateResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/qm/calibration-step":{"post":{"summary":"USL-QM Bridge calibration-step recommendation","description":"claim_level: template_generation_and_calibration_assist_only. Calibration recommendations only; not applied automatically.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationStepInput"}}}},"responses":{"200":{"description":"Calibration assist receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationStepResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/transport/sweep":{"post":{"summary":"Suppression sweep","description":"claim_level: research_harness_preflight_only. Pre-flight suppression sweep. Accepts D_crit or auto-computed from lambdaDB/deltaR; optional D_suppress_min/D_suppress_max bounds. Invalid points returned with valid_regime=false.","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportSweepRequest"}}}},"responses":{"200":{"description":"Sweep results with success and ok true","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportSweepResponse"}}}},"400":{"description":"Validation error"}}}},"/api/v1/usl/field/scan-scales":{"post":{"summary":"FRAI scale scan","description":"claim_level: research_harness_preflight_only. Field scale scan for D estimation assist.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Scale rows"}}}},"/api/v1/usl/field/estimate-d":{"post":{"summary":"Estimate D from observations","description":"claim_level: research_harness_preflight_only. D estimator from FRAI observations.","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Estimated D"}}}},"/api/v1/usl/field/fit-correlation":{"post":{"summary":"Fit C(d) correlation function","description":"claim_level: research_harness_preflight_only. Fits C(d)=g0*exp(-b*d^alpha) per annealing time via alpha grid search. Extracts correlation length xi and, with multiple ta values spanning >=4x range, fits mu from xi(ta)~ta^(1/mu). Validated on real Dryad data from Tindall et al. Science 2026 Figure 5: R²>0.999, alpha_mean=1.42, mu_fitted=2.53 vs paper μ≈2.75. Fast diagnostic only; not a replacement for full KZ collapse.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FitCorrelationRequest"}}}},"responses":{"200":{"description":"Correlation fit receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FitCorrelationResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/field/calibrate-d-chi":{"post":{"summary":"Kibble-Zurek D-chi calibration","description":"claim_level: template_generation_and_calibration_assist_only. Maps tensor-network bond dimension chi to USL D using a two-component truncation + Trotter model. Classification priority: chi_ratio, p_norm, em_bootstrap. Advisory calibration only. Response includes model.xi_chi_dependence diagnostic and chi_prediction.chi_min_conservative when xi varies >2x across truncation-dominated chi pairs.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrateDChiRequest"}}}},"responses":{"200":{"description":"D-chi calibration receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrateDChiResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/ode-router":{"post":{"summary":"ODE router decision receipt","description":"claim_level: certified_routing | validated_routing | advisory_routing | research_preflight | logical_window_closed. Enterprise pre-flight routing guidance only; not hardware certification.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterRequest"}}}},"responses":{"200":{"description":"ODE routing receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/ode-router/calibrate":{"post":{"summary":"Calibrate ODE router coherent fraction","description":"claim_level: calibration_receipt_only. Inverts observed R_phys points to infer posterior f_coh and uncertainty.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterCalibrateRequest"}}}},"responses":{"200":{"description":"Calibration receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterCalibrateResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/ode-router/quote":{"post":{"summary":"Broker quote estimate from ODE routing decision","description":"claim_level: broker_quote_estimate_only. Prices each provider using live qBraid device catalog and/or IBM Quantum Runtime backends; optional samples[128+] runs USL ODE preflight for recommendation. Secrets: QBRAID_API_KEY, IBM_QUANTUM_* (optional AWS_* / IONQ_API_KEY for extended live metadata). circuit_type/topology fields are accepted but do not trigger layout routing.","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterQuoteRequest"}}}},"responses":{"200":{"description":"Quote estimates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OdeRouterQuoteResponse"}}}},"400":{"description":"Validation error"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"}}}},"/api/v1/usl/fixtures/transport-standard":{"get":{"summary":"Canned standard transport","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Standard regime receipt"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"ClaimLevelResearchHarness":{"type":"string","const":"research_harness_preflight_only","description":"Core USL transport, closed-form CL, QEC threshold, field routes, fixtures."},"ClaimLevelQmBridge":{"type":"string","const":"template_generation_and_calibration_assist_only","description":"QM Bridge QUA templates and calibration-step assist only; no OPX execution."},"ClaimLevelControlAssist":{"type":"string","const":"control_recommendation_only","description":"Bounded control recommendations only; verify via /transport/simulate before hardware."},"ClaimLevelLabValidation":{"type":"string","const":"lab_validation_receipt_only","description":"Lab validation receipt only; does not update model or certify physical transport."},"TransportSimulateInput":{"type":"object","required":["dim","lambdaDB","D_A","D_B","r_A","r_B","D_boundary","deltaR","D_suppress","Gamma_suppress","Gamma_restore","v_atom"],"properties":{"dim":{"type":"integer"},"lambdaDB":{"type":"number"},"D_A":{"type":"number"},"D_B":{"type":"number"},"r_A":{"type":"number"},"r_B":{"type":"number"},"D_boundary":{"type":"number"},"deltaR":{"type":"number"},"D_suppress":{"type":"number"},"Gamma_suppress":{"type":"number"},"Gamma_restore":{"type":"number"},"v_atom":{"type":"number"},"steps":{"type":"integer"},"fraiThreshold":{"type":"number"},"D_target":{"type":"number","exclusiveMinimum":0,"description":"Optional. Adds closed_form_coherence_loss using this D; else D_suppress is used for CL only."},"v_sound":{"type":"number"},"epsilon":{"type":"number"},"detail":{"type":"string","enum":["summary","light","full"],"default":"full"}}},"ClosedFormCoherenceLossReceipt":{"type":"object","description":"Extra pre-flight receipt from usl_closed_form.js; does not replace monolith ok.","properties":{"formula":{"type":"string","example":"CL = (2D + 1) / (D + 1)^2"},"formula_scope":{"type":"string","example":"dim=1 transport-quality convention; API/model-validated curve"},"dim_convention":{"type":"integer","const":1},"D_target":{"type":"number","exclusiveMinimum":0},"value":{"type":"number","description":"Coherence loss CL in [0,1]"},"percent":{"type":"number","description":"CL × 100"},"qec_compatible_conservative":{"type":"boolean","description":"True when D_target > 200 (1% conservative rule)"},"conservative_rule":{"type":"string","example":"D_target > 200 for CL < 1%"},"caveat":{"type":"string"}}},"TransportSimulateResponse":{"type":"object","description":"Full runTransportProtocol receipt plus honesty envelope.","properties":{"ok":{"type":"boolean"},"summary":{"type":"object"},"boundary":{"type":"object"},"phases":{"type":"object"},"fidelity":{"type":"object"},"qm_bridge":{"$ref":"#/components/schemas/QmBridgeReceipt"},"closed_form_coherence_loss":{"$ref":"#/components/schemas/ClosedFormCoherenceLossReceipt"},"usl_version":{"type":"string","example":"3.1.1"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelResearchHarness"},"claim_statement":{"type":"string"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"detail_applied":{"type":"string","enum":["summary","light"]},"constraint_hint":{"type":"object","properties":{"isInverted":{"type":"boolean"},"D_crit":{"type":"number"},"message":{"type":"string"}}}}},"TransportSweepRequest":{"type":"object","required":["D_boundary","Gamma_restore","deltaR","v_atom","lambdaDB","dim"],"properties":{"D_boundary":{"type":"number","exclusiveMinimum":0},"D_crit":{"type":"number","exclusiveMinimum":0},"D_suppress_min":{"type":"number","exclusiveMinimum":0},"D_suppress_max":{"type":"number","exclusiveMinimum":0},"D_min":{"type":"number","exclusiveMinimum":0},"D_max":{"type":"number","exclusiveMinimum":0},"D_values":{"type":"array","items":{"type":"number"}},"Gamma_restore":{"type":"number","exclusiveMinimum":0},"deltaR":{"type":"number","exclusiveMinimum":0},"v_atom":{"type":"number","exclusiveMinimum":0},"lambdaDB":{"type":"number","exclusiveMinimum":0},"dim":{"type":"integer","minimum":1},"steps":{"type":"integer","minimum":2},"fraiThreshold":{"type":"number"},"detail":{"type":"string","enum":["summary","light","full"],"default":"full"}}},"CoherenceLossInput":{"type":"object","required":["D_target"],"properties":{"D_target":{"type":"number","exclusiveMinimum":0},"loss_target":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1,"default":0.01}}},"TransportSweepRow":{"type":"object","required":["D_suppress"],"properties":{"D_suppress":{"type":"number","nullable":false},"valid_regime":{"type":"boolean"},"rejection_reason":{"type":["string","null"]},"t_window":{"type":"number","nullable":true},"v_min":{"type":"number","nullable":true},"minFrai":{"type":"number","nullable":true},"inputVelocityOk":{"type":"boolean"},"isInverted":{"type":"boolean"},"recommended":{"type":"boolean"}}},"TransportSweepResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"summary":{"type":"object"},"claim_statement":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}},"detail_applied":{"type":"string","enum":["summary","light"]},"sweep_input_mode":{"type":"string","enum":["explicit_D_suppress_bounds","auto_from_D_crit"]},"D_crit":{"type":"number"},"isInverted":{"type":"boolean"},"count":{"type":"integer"},"valid_count":{"type":"integer"},"reason":{"type":"string"},"warning":{"type":"string"},"usl_version":{"type":"string"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelResearchHarness"},"input":{"type":"object"},"results":{"type":"array","items":{"$ref":"#/components/schemas/TransportSweepRow"}},"recommended_operating_band":{"type":"array","items":{"$ref":"#/components/schemas/TransportSweepRow"}},"recommended_count":{"type":"integer","minimum":0},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"CoherenceLossResponse":{"type":"object","properties":{"success":{"type":"boolean"},"ok":{"type":"boolean"},"usl_version":{"type":"string"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelResearchHarness"},"formula":{"type":"string","example":"CL = (2D + 1) / (D + 1)^2"},"formula_scope":{"type":"string"},"coherence_loss":{"type":"object"},"qec_compatibility":{"type":"object"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"QecThresholdInput":{"type":"object","properties":{"loss_target":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1,"default":0.01}}},"QecThresholdResponse":{"type":"object","properties":{"success":{"type":"boolean"},"ok":{"type":"boolean"},"usl_version":{"type":"string"},"threshold":{"type":"object"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"QmBridgeReceipt":{"type":"object","description":"USL-QM Bridge v0.1 planning receipt from simulate when t_window > 0","properties":{"qm_bridge_version":{"type":"string","example":"0.1.0"},"bridge_level":{"type":"string","example":"template_generation_and_calibration_assist_only"},"clock_cycle_ns":{"type":"number","example":4},"duration_cycles":{"type":"integer"},"duration_cycles_4ns":{"type":"integer"},"recommended_D_target":{"type":"number"},"recommended_gamma_suppress":{"type":"number"},"recommended_gamma_restore":{"type":"number"},"closed_form_coherence_loss":{"type":"number"},"qec_compatible":{"type":"boolean"},"qua_template_inputs":{"type":"object"},"claim_boundary":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"QuaTemplateInput":{"type":"object","required":["D_target"],"properties":{"D_target":{"type":"number","exclusiveMinimum":0},"duration_seconds":{"type":"number","exclusiveMinimum":0},"clock_cycle_ns":{"type":"number","exclusiveMinimum":0,"default":4},"duration_cycles":{"type":"integer","minimum":4},"duration_cycles_4ns":{"type":"integer","minimum":4},"amp_scale":{"type":"number","minimum":0},"amp_offset":{"type":"number"},"max_amp":{"type":"number","exclusiveMinimum":0,"maximum":2},"element":{"type":"string"},"operation":{"type":"string"},"mode":{"type":"string","enum":["constants","input_stream"]}}},"QuaTemplateResponse":{"type":"object","properties":{"success":{"type":"boolean"},"ok":{"type":"boolean"},"usl_version":{"type":"string"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelQmBridge"},"qm_bridge_version":{"type":"string"},"qua_template":{"type":"string"},"qm_bridge":{"type":"object","properties":{"clock_cycle_ns":{"type":"number"},"duration_cycles":{"type":"integer"},"duration_cycles_4ns":{"type":"integer"}}},"safety_notes":{"type":"array","items":{"type":"string"}},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"CalibrationStepInput":{"type":"object","required":["observations","current_amp","amp_to_D_gain"],"properties":{"observations":{"type":"array","items":{"type":"object"}},"dim":{"type":"integer"},"target_loss":{"type":"number"},"current_amp":{"type":"number"},"amp_to_D_gain":{"type":"number","exclusiveMinimum":0},"max_amp_step":{"type":"number","exclusiveMinimum":0}}},"CalibrationStepResponse":{"type":"object","properties":{"success":{"type":"boolean"},"estimated_D":{"type":"number"},"decision":{"type":"string","enum":["PASS_NO_ADJUST","ADJUST_AND_RETRY","CALIBRATION_LIMITED"]},"recommended":{"type":"object"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelQmBridge"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"LabTransportResultInput":{"type":"object","required":["D_target","measured_CL"],"properties":{"D_target":{"type":"number","exclusiveMinimum":0},"measured_CL":{"type":"number","minimum":0,"maximum":1},"lab_id":{"type":"string","maxLength":128},"run_id":{"type":"string","maxLength":128},"metadata":{"type":"object"}}},"LabTransportResultResponse":{"type":"object","properties":{"success":{"type":"boolean"},"ok":{"type":"boolean"},"usl_version":{"type":"string"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelLabValidation"},"stored":{"type":"boolean","const":false},"model_update":{"type":"string","const":"none"},"receipt":{"type":"object"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"ControlRecommendInput":{"type":"object","required":["D_obs","D_target","current_v_atom","current_amp","amp_to_D_gain","v_atom_to_D_gain"],"properties":{"D_obs":{"type":"number","exclusiveMinimum":0},"D_target":{"type":"number","exclusiveMinimum":0},"base_gain":{"type":"number","minimum":0,"default":0.15},"current_v_atom":{"type":"number","exclusiveMinimum":0},"current_amp":{"type":"number","minimum":0,"maximum":1},"amp_to_D_gain":{"type":"number","exclusiveMinimum":0},"v_atom_to_D_gain":{"type":"number","exclusiveMinimum":0},"max_delta_v_atom":{"type":"number","exclusiveMinimum":0,"default":0.25},"max_delta_amp":{"type":"number","exclusiveMinimum":0,"default":0.03},"deadband_D":{"type":"number","minimum":0,"default":2},"target_loss":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1,"default":0.01}}},"CalibrateDChiObservation":{"type":"object","required":["chi","ta","gate_error"],"properties":{"chi":{"type":"integer","minimum":1},"ta":{"type":"number","exclusiveMinimum":0},"gate_error":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}}},"CalibrateDChiRequest":{"type":"object","required":["dt_ns","observations"],"properties":{"dt_ns":{"type":"number","exclusiveMinimum":0},"observations":{"type":"array","minItems":2,"items":{"$ref":"#/components/schemas/CalibrateDChiObservation"}},"mu_kz":{"type":"number","exclusiveMinimum":0,"default":2.75},"target_gate_error":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1,"default":1e-9},"target_ta_ns":{"type":"number","exclusiveMinimum":0,"default":7},"K_seed":{"type":"number","exclusiveMinimum":0}}},"CalibrateDChiResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"success":{"type":"boolean","const":true},"claim_level":{"$ref":"#/components/schemas/ClaimLevelQmBridge"},"classification_test_used":{"type":"string","enum":["chi_ratio","p_norm","em_bootstrap"]},"model":{"type":"object","properties":{"xi_chi_dependence":{"type":["number","null"]},"xi_chi_dependence_note":{"type":["string","null"]}}},"classification":{"type":"array","items":{"type":"object"}},"chi_prediction":{"type":"object","properties":{"chi_min_conservative":{"type":"boolean"},"chi_min_note":{"type":"string"}}},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}},"FitCorrelationRequest":{"type":"object","properties":{"distances":{"type":"array","items":{"type":"number","exclusiveMinimum":0}},"corrs":{"type":"array","items":{"type":"number","exclusiveMinimum":0}},"series":{"type":"array","items":{"type":"object","required":["ta","distances","corrs"],"properties":{"ta":{"type":"number","exclusiveMinimum":0},"distances":{"type":"array","items":{"type":"number"}},"corrs":{"type":"array","items":{"type":"number"}}}}},"alpha_min":{"type":"number","default":0.5},"alpha_max":{"type":"number","default":2.5},"alpha_steps":{"type":"integer","minimum":2,"default":81},"mu_kz_expected":{"type":"number","default":2.75}}},"FitCorrelationResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"success":{"type":"boolean"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelResearchHarness"},"mode":{"type":"string","enum":["single_series","multi_series"]},"fit":{"type":["object","null"]},"series_fits":{"type":"array"},"kz_fit":{"type":"object"},"forbidden_claim":{"type":"string"}}},"OdeRouterRequest":{"type":"object","required":["samples"],"properties":{"samples":{"type":"array","items":{"type":"number"},"minItems":128},"hardware":{"type":"object","properties":{"gate_fidelity":{"type":"number"},"hardware_model":{"type":"string"},"custom_f_coh":{"type":["number","null"]},"custom_sigma":{"type":["number","null"]}}},"code":{"type":"string","default":"4_2_2"},"dim":{"type":"number","default":2}}},"OdeRouterResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"claim_level":{"type":"string"},"routing":{"type":"object"},"characterisation":{"type":"object"},"predicted_performance":{"type":"object"},"warnings":{"type":"array","items":{"type":"object"}},"forbidden_claim":{"type":"string"}}},"OdeRouterCalibrateRequest":{"type":"object","required":["hardware_model","observations"],"properties":{"hardware_model":{"type":"string"},"gate_fidelity":{"type":"number","default":0.994},"observations":{"type":"array","minItems":1,"items":{"type":"object","required":["D","R_phys"],"properties":{"D":{"type":"number"},"R_phys":{"type":"number"}}}}}},"OdeRouterCalibrateResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"claim_level":{"type":"string","const":"calibration_receipt_only"},"calibration":{"type":"object"},"next_step":{"type":"string"}}},"OdeRouterQuoteRequest":{"type":"object","required":["providers","recommendation"],"properties":{"providers":{"type":"array","items":{"type":"string","example":"ibm"},"minItems":1,"description":"Provider ids: ibm, quera, rigetti, pasqal, ionq, google, xanadu, quantinuum"},"recommendation":{"type":"string","enum":["LOGICAL","PHYSICAL","INDETERMINATE"]},"n_training_points":{"type":"integer","minimum":1},"D":{"type":"number","minimum":1,"description":"Alias for n_training_points when set"},"shots_per_eval":{"type":"integer","minimum":1,"default":1000},"discard_rate":{"type":"number","minimum":0,"maximum":0.999,"default":0.32},"improvement_ratio":{"type":"number","minimum":0},"routing_tier":{"type":"string"},"circuit_profile":{"type":"object","description":"Optional client metadata; not used for layout routing"},"circuit_type":{"type":"string","enum":["static","dynamic"],"description":"Optional client metadata; not used for layout routing"},"topology":{"type":"string","enum":["linear","star","all-to-all"],"description":"Optional client metadata; not used for layout routing"},"n_qubits":{"type":"integer","minimum":2,"description":"Optional client metadata"},"n_sys":{"type":"integer","minimum":1,"default":1,"description":"Optional client metadata"},"dynamic":{"type":"boolean","description":"Optional client metadata"},"backends":{"type":"array","items":{"type":"string"},"description":"Explicit QRN or backend names"},"samples":{"type":"array","items":{"type":"number"},"minItems":128,"description":"Optional USL preflight for recommendation"}}},"OdeRouterQuoteLine":{"type":"object","properties":{"provider":{"type":"string"},"price_source":{"type":"string","enum":["live","ibm_runtime","fallback_table"]},"n_training_points":{"type":"integer"},"shots_per_eval":{"type":"integer"},"discard_rate":{"type":"number"},"shots":{"type":"integer","description":"Total shots after discard inflation"},"n_tasks":{"type":"integer"},"quote_usd":{"type":"object","properties":{"physical":{"type":"number"},"logical":{"type":"number"}}},"qrn":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"queue_depth":{"type":"integer","nullable":true}}},"OdeRouterQuoteResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"claim_level":{"type":"string","const":"broker_quote_estimate_only"},"caveat":{"type":"string"},"qbraid_configured":{"type":"boolean"},"qbraid_devices_source":{"type":"string"},"ibm_configured":{"type":"boolean"},"ibm_backends_source":{"type":"string"},"ibm_warning":{"type":"string"},"total_quoted_usd":{"type":"number"},"warning":{"type":"string","enum":["HIGH_COST_JOB"]},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/OdeRouterQuoteLine"}},"usl_preflight":{"type":"object","description":"Present when samples[128+] was sent"}}},"ControlRecommendResponse":{"type":"object","properties":{"success":{"type":"boolean"},"ok":{"type":"boolean"},"usl_version":{"type":"string"},"control_version":{"type":"string","example":"0.1.0"},"claim_level":{"$ref":"#/components/schemas/ClaimLevelControlAssist"},"controller":{"type":"object"},"state":{"type":"object"},"recommended":{"type":"object"},"decision":{"type":"string","enum":["PASS_NO_ADJUST","ADJUST_AND_VERIFY","ADJUST_LIMITED_AND_VERIFY","HOLD_AND_RECHECK"]},"required_next_step":{"type":"string"},"forbidden_claim":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}}}}}}}