roborama 0.1.0

package/dist/index.js

@@ -0,0 +1,1342 @@
+// src/errors.ts
+var RoboramaError = class extends Error {
+  constructor(message, opts) {
+    super(message);
+    this.name = "RoboramaError";
+    this.code = opts.code;
+    this.status = opts.status;
+    this.run_id = opts.run_id;
+    this.doc_url = opts.doc_url;
+    this.partial_result = opts.partial_result;
+  }
+};
+function errorFromEnvelope(status, payload) {
+  const err = payload?.error ?? { code: "error", message: "Roborama API error" };
+  return new RoboramaError(err.message ?? "Roborama API error", {
+    code: err.code ?? "error",
+    status,
+    run_id: err.run_id,
+    doc_url: err.doc_url,
+    partial_result: err.partial_result
+  });
+}
+
+// src/data.ts
+var PRICING = { "currency": "USD", "meters": [{ "id": "robot_hours", "label": "Robot-hours", "unit": "robot-hour", "description": "Occupancy of an embodiment: metered per minute while your policy holds the cell, from first motor enable to final reset." }, { "id": "environment_hours", "label": "Environment-hours", "unit": "environment-hour", "description": "Occupancy of a versioned catalogue scene, metered per minute alongside the robot meter. Both meters appear in every quote and every result." }], "billing_note": "Metered per minute, displayed per hour. Hours in results are rounded to 0.1 h; billing uses exact minutes. A max_budget_usd on any run is a hard stop, metered live.", "robot_rates": [{ "id": "nori-a3", "class": "arm-pod", "tier": "soak", "usd_per_robot_hour": 7, "note": "Commodity soak pods, 24 cells. Iterate here; escalate when the numbers hold." }, { "id": "so-101", "class": "arm-pod", "tier": "soak", "usd_per_robot_hour": 9, "note": "Hobby-class 5-DoF pods, 16 cells. The cheapest smoke test for a policy." }, { "id": "stretch3", "class": "mobile-manipulator", "tier": "verify", "usd_per_robot_hour": 34, "note": "Mobile manipulation, firmware-pinned." }, { "id": "fr3-bench", "class": "fixed-arm", "tier": "verify", "usd_per_robot_hour": 38, "note": "Torque-controlled 7-DoF industrial arm on a fixed bench." }, { "id": "aloha-bimanual", "class": "bimanual", "tier": "verify", "usd_per_robot_hour": 52, "note": "Bimanual teleop-grade rig." }, { "id": "tiago-pro", "class": "mobile-manipulator", "tier": "verify", "usd_per_robot_hour": 61, "note": "Premium mobile manipulator; torso lift and force-torque wrists." }, { "id": "aloha2-pro", "class": "bimanual", "tier": "verify", "usd_per_robot_hour": 74, "note": "Second-generation bimanual rig, gravity-compensated, higher payload." }, { "id": "spot-arm", "class": "quadruped-manip", "tier": "verify", "usd_per_robot_hour": 89, "note": "Quadruped with a 6-DoF arm; uneven-floor manipulation cells." }, { "id": "g1-edu-pro", "class": "humanoid", "tier": "verify", "usd_per_robot_hour": 148, "note": "37-DoF humanoid with dex3-1 hands; the verification-tier default." }, { "id": "g1-edu-plus", "class": "humanoid", "tier": "verify", "usd_per_robot_hour": 176, "note": "43-DoF humanoid; limited cells." }], "environment_rates": [{ "adder_tier": "bare", "usd_per_env_hour": 12, "examples": ["cell-a@v1.0"], "note": "Bare bench cell, overhead camera." }, { "adder_tier": "standard", "usd_per_env_hour": 24, "examples": ["warehouse-std@v2.0"], "note": "Standard catalogue scene with mocap." }, { "adder_tier": "replica", "usd_per_env_hour": 39, "examples": ["kitchen-std@v1.2"], "note": "Full replica scene, mocap + force-torque." }, { "adder_tier": "instrumented-replica", "usd_per_env_hour": 85, "examples": ["surgical-replica@v3"], "note": "High-instrumentation replica, high-speed capture." }], "priority": [{ "id": "burst", "multiplier": 1.5, "note": "Expedited queue: next available cell, both meters at 1.5\xD7." }, { "id": "standard", "multiplier": 1, "note": "Default queue." }, { "id": "soak", "multiplier": 0.6, "note": "Off-peak, interruptible scheduling at 0.6\xD7." }], "adders": [{ "id": "teleop-fallback", "usd_per_robot_hour": 18, "note": "Human takeover on policy halt (Policy.endpoint fallback)." }, { "id": "extra-instrumentation", "usd_per_env_hour": 12, "note": "Additional mocap or high-speed capture beyond the environment's base kit." }], "packages": [{ "id": "suite-manip-core-v3", "label": "rbr-manip-core@v3 suite run", "usd": 9500, "includes": "5 tasks \xD7 300 episodes on g1-edu-pro@fw2.3; suite attestation (rbr:att: id) and the verification report." }, { "id": "threshold-contract", "label": "Outcome contract \u2014 threshold()", "usd": null, "pricing": "monthly_cap_usd you set", "includes": "Soak-tier iteration (e.g. nori-a3 pods) with automatic escalation to verification-tier hardware on threshold crossing; on_verified webhook; hard monthly cap." }], "worked_quote": { "label": "What do 600 humanoid episodes cost?", "robot": "g1-edu-pro", "environment": "kitchen-std@v1.2", "episodes": 600, "priority": "standard", "minutes_per_episode_est": 2, "robot_hours": 20, "env_hours": 20, "robot_usd_per_hour": 148, "env_usd_per_hour": 39, "robot_usd": 2960, "env_usd": 780, "usd": 3740, "queue_eta": "6h" } };
+var ROBOTS = [{ "id": "g1-edu-pro", "class": "humanoid", "dof": 37, "hands": "dex3-1", "firmwares": ["2.3", "2.4"], "cells": 6, "duty_cycle_pct": 71, "tier": "verify" }, { "id": "g1-edu-plus", "class": "humanoid", "dof": 43, "hands": "dex3-1", "firmwares": ["2.3"], "cells": 2, "duty_cycle_pct": 64, "tier": "verify" }, { "id": "spot-arm", "class": "quadruped-manip", "dof": 19, "hands": "gripper-2f", "firmwares": ["4.1"], "cells": 2, "duty_cycle_pct": 60, "tier": "verify" }, { "id": "aloha2-pro", "class": "bimanual", "dof": 14, "hands": "gripper-2f", "firmwares": ["1.1"], "cells": 2, "duty_cycle_pct": 62, "tier": "verify" }, { "id": "aloha-bimanual", "class": "bimanual", "dof": 14, "hands": "gripper-2f", "firmwares": ["3.1"], "cells": 3, "duty_cycle_pct": 66, "tier": "verify" }, { "id": "tiago-pro", "class": "mobile-manipulator", "dof": 12, "hands": "gripper-2f", "firmwares": ["2.0"], "cells": 2, "duty_cycle_pct": 55, "tier": "verify" }, { "id": "stretch3", "class": "mobile-manipulator", "dof": 10, "hands": "gripper-2f", "firmwares": ["1.9"], "cells": 4, "duty_cycle_pct": 58, "tier": "verify" }, { "id": "fr3-bench", "class": "fixed-arm", "dof": 7, "hands": "gripper-2f", "firmwares": ["5.2"], "cells": 8, "duty_cycle_pct": 74, "tier": "verify" }, { "id": "nori-a3", "class": "arm-pod", "dof": 6, "hands": "gripper-2f", "firmwares": ["1.0"], "cells": 24, "duty_cycle_pct": 83, "tier": "soak" }, { "id": "so-101", "class": "arm-pod", "dof": 5, "hands": "gripper-2f", "firmwares": ["1.2"], "cells": 16, "duty_cycle_pct": 79, "tier": "soak" }];
+var ENVIRONMENTS = [{ "id": "cell-a", "rev": "v1.0", "class": "bench", "instrumentation": ["overhead-cam"], "objects": 24, "reset": "scripted", "adder_tier": "bare" }, { "id": "warehouse-std", "rev": "v2.0", "class": "warehouse", "instrumentation": ["mocap"], "objects": 388, "reset": "scripted", "adder_tier": "standard" }, { "id": "kitchen-std", "rev": "v1.2", "class": "kitchen", "instrumentation": ["mocap", "ft"], "objects": 214, "reset": "scripted", "adder_tier": "replica" }, { "id": "kitchen-replica", "rev": "v2.0", "class": "kitchen", "instrumentation": ["mocap", "ft", "scale"], "objects": 178, "reset": "scripted", "adder_tier": "replica" }, { "id": "surgical-replica", "rev": "v3", "class": "surgical", "instrumentation": ["mocap", "ft", "high-speed-cam"], "objects": 61, "reset": "teleop-assisted", "adder_tier": "instrumented-replica" }];
+var SUITES = [{ "id": "rbr-manip-core", "rev": "v3", "frozen": "2026-03-14", "scoring": "binary success, Wilson 95% interval", "episodes_per_task": 300, "tasks": ["pick_place@v1", "load_dishwasher@v2", "shelf_restock@v1", "fold_towel@v2", "bin_pick@v1"], "environments": ["kitchen-std@v1.2", "warehouse-std@v2.0", "cell-a@v1.0"], "perturbation_rev": "suite-core@v3.0", "sample_report": { "robot": "g1-edu-pro@fw2.3", "overall": { "n": 1500, "success_rate": 0.859, "ci95": [0.841, 0.876] }, "per_task": [{ "task": "pick_place@v1", "n": 300, "success_rate": 0.903, "ci95": [0.865, 0.932] }, { "task": "load_dishwasher@v2", "n": 300, "success_rate": 0.873, "ci95": [0.831, 0.906] }, { "task": "shelf_restock@v1", "n": 300, "success_rate": 0.813, "ci95": [0.765, 0.853] }, { "task": "fold_towel@v2", "n": 300, "success_rate": 0.93, "ci95": [0.895, 0.954] }, { "task": "bin_pick@v1", "n": 300, "success_rate": 0.777, "ci95": [0.726, 0.82] }], "attestation": "rbr:att:9f3c2ab7", "attestation_url": "https://api.roborama.com/v1/attestations/rbr:att:9f3c2ab7", "citation": "Roborama Manip-Core v3, run 2026-09-04, attestation rbr:att:9f3c2ab7" } }];
+var TASKS = [{ "id": "task_espresso_01", "object": "task", "name": "espresso", "rev": "espresso@v1", "status": "frozen", "visibility": "private", "created": "2026-08-20T09:14:02Z", "frozen": "2026-08-24T16:40:11Z", "signatures": ["acct_acme", "roborama"], "initial_conditions": { "machine": { "object": "kit/acme-breville", "pose": "P1", "tol_mm": 20 }, "cup": { "object": "catalogue/cup-std-08", "randomize": "zone-A" } }, "success_predicates": [{ "cup_on_tray": "gt.pose(cup) within tray_zone" }, { "liquid_mass": "scale.delta between 22 and 42 g" }, { "no_spill": "vision.spill_area < 2 cm2" }, { "t_complete": "episode.duration < 180 s" }], "instructions": { "sampled_per_episode": ["make an espresso", "brew me a coffee", "fais un espresso"], "held_out": ["prepare a single shot"] }, "stages": [{ "grasp_cup": "gt.pose(cup) in gripper" }, { "cup_placed": "gt.pose(cup) within drip_zone" }, { "extraction": "scale.delta > 0 within 60s" }, { "served": "all success_predicates" }], "envelope": { "lighting": ["3000K", "5600K"], "distractors": "set-B", "out_of_scope": ["oat_milk"] }, "pilot": { "run_id": "run_9088", "robot": "g1-edu-pro@fw2.3", "episodes": 25, "amendments": 1 } }, { "id": "task_latte_art_01", "object": "task", "name": "latte_art", "rev": null, "status": "draft", "visibility": "private", "created": "2026-08-30T11:03:44Z", "frozen": null, "signatures": [], "initial_conditions": { "machine": { "object": "kit/acme-breville", "pose": "P1", "tol_mm": 20 }, "pitcher": { "object": "catalogue/pitcher-std-02", "randomize": "zone-A" } }, "success_predicates": [{ "pattern_visible": "vision.contrast_score > 0.6" }, { "no_spill": "vision.spill_area < 2 cm2" }, { "t_complete": "episode.duration < 240 s" }], "instructions": { "sampled_per_episode": ["pour a latte heart", "make latte art"], "held_out": ["draw a heart in the milk"] }, "stages": [{ "steam_milk": "audio.steam_event within 90s" }, { "poured": "scale.delta between 120 and 200 g" }, { "pattern": "all success_predicates" }], "envelope": { "lighting": ["3000K"], "distractors": "none", "out_of_scope": ["oat_milk", "tulip_pattern"] }, "pilot": null }];
+var KITS = [{ "id": "kit_acme_breville", "object": "kit", "name": "acme-breville", "status": "available", "status_history": [{ "status": "registered", "at": "2026-08-12T10:02:00Z" }, { "status": "received", "at": "2026-08-15T18:30:00Z" }, { "status": "tracked", "at": "2026-08-17T09:12:00Z" }, { "status": "available", "at": "2026-08-17T14:45:00Z" }], "items": [{ "desc": "Breville BES870", "qty": 1 }], "tracking": { "mocap_markers": 6, "mass_g": 10480, "mesh_scan": true }, "environment_ref": "kit/acme-breville", "shipping_label_url": "https://api.roborama.com/v1/kits/kit_acme_breville/shipping-label" }, { "id": "kit_pi_breville", "object": "kit", "name": "pi-breville", "status": "tracked", "status_history": [{ "status": "registered", "at": "2026-08-28T08:11:00Z" }, { "status": "received", "at": "2026-08-31T17:05:00Z" }, { "status": "tracked", "at": "2026-09-01T10:22:00Z" }], "items": [{ "desc": "Breville BES870", "qty": 2 }], "tracking": { "mocap_markers": 6, "mass_g": 10480, "mesh_scan": true }, "environment_ref": null, "shipping_label_url": "https://api.roborama.com/v1/kits/kit_pi_breville/shipping-label" }];
+var RUNS = [{ "id": "run_8842", "object": "run", "kind": "run", "status": "completed", "created": "2026-08-28T14:02:11Z", "completed": "2026-08-29T11:37:48Z", "robot": "g1-edu-pro@fw2.3", "environment": "kitchen-std@v1.2", "task": "load_dishwasher@v2", "policy": { "type": "container", "image": "ghcr.io/acme/skill:v4", "action_space": "joint_delta_50hz", "observation_contract": "droid-3cam" }, "episodes": "auto(ci=0.95, moe=0.03)", "priority": "standard", "perturbation": { "layout_jitter_mm": 25, "lighting": ["3000K", "5600K"], "distractors": "set-B", "seed": 42 }, "data": { "retention": "30d", "train_on_failures": false }, "max_budget_usd": 4e3, "resolved_pins": { "robot": "g1-edu-pro@fw2.3", "environment": "kitchen-std@v1.2", "task": "load_dishwasher@v2", "perturbation_rev": "set-B@v1.4" }, "result": { "n": 612, "success_rate": 0.874, "ci95": [0.846, 0.898], "interval_method": "wilson", "failure_clusters": { "grasp_slip": 41, "perception_miss": 22, "collision": 9 }, "robot_hours": 20.4, "environment_hours": 20.4, "cost_usd": 3812, "artifacts": { "mcap": "https://api.roborama.com/v1/runs/run_8842/episodes?artifact=mcap", "video": "https://api.roborama.com/v1/runs/run_8842/episodes?artifact=video", "ground_truth": "https://api.roborama.com/v1/runs/run_8842/episodes?artifact=ground_truth", "report_pdf": "https://api.roborama.com/v1/runs/run_8842/report?format=pdf" } } }, { "id": "run_9101", "object": "run", "kind": "run", "status": "completed", "created": "2026-08-26T08:15:33Z", "completed": "2026-08-27T04:02:19Z", "robot": "g1-edu-pro@fw2.3", "environment": "kitchen-std@v1.2", "task": "espresso@v1", "policy": { "type": "checkpoint", "hf": "pi/espresso-v7", "runtime": "openpi", "inference": { "action_horizon": 50, "chunk_size": 50, "temp": 0 }, "action_space": "joint_delta_50hz", "observation_contract": "droid-3cam" }, "episodes": 412, "priority": "standard", "interventions": "none", "perturbation": { "layout_jitter_mm": 25, "lighting": ["3000K", "5600K"], "distractors": "set-B", "seed": 7 }, "data": { "retention": "30d", "train_on_failures": false }, "max_budget_usd": 3e3, "resolved_pins": { "robot": "g1-edu-pro@fw2.3", "environment": "kitchen-std@v1.2", "task": "espresso@v1", "perturbation_rev": "set-B@v1.4" }, "result": { "n": 412, "success_rate": 0.85, "ci95": [0.812, 0.881], "interval_method": "wilson", "failure_clusters": { "cup_misplace": 24, "spill": 19, "timeout": 12 }, "stage_rates": [{ "stage": "grasp_cup", "n": 412, "success_rate": 0.966, "ci95": [0.944, 0.98] }, { "stage": "cup_placed", "n": 412, "success_rate": 0.932, "ci95": [0.904, 0.953] }, { "stage": "extraction", "n": 412, "success_rate": 0.893, "ci95": [0.86, 0.919] }, { "stage": "served", "n": 412, "success_rate": 0.85, "ci95": [0.812, 0.881] }], "instruction_breakdown": [{ "instruction": "make an espresso", "held_out": false, "n": 118, "success_rate": 0.873, "ci95": [0.801, 0.921] }, { "instruction": "brew me a coffee", "held_out": false, "n": 112, "success_rate": 0.866, "ci95": [0.791, 0.917] }, { "instruction": "fais un espresso", "held_out": false, "n": 99, "success_rate": 0.848, "ci95": [0.765, 0.906] }, { "instruction": "prepare a single shot", "held_out": true, "n": 83, "success_rate": 0.795, "ci95": [0.696, 0.868] }], "interventions": { "declared": "none", "count": 0, "timestamps": [] }, "robot_hours": 13.7, "environment_hours": 13.7, "cost_usd": 2562, "artifacts": { "mcap": "https://api.roborama.com/v1/runs/run_9101/episodes?artifact=mcap", "video": "https://api.roborama.com/v1/runs/run_9101/episodes?artifact=video", "ground_truth": "https://api.roborama.com/v1/runs/run_9101/episodes?artifact=ground_truth", "report_pdf": "https://api.roborama.com/v1/runs/run_9101/report?format=pdf" } } }];
+var MATRIX = { "id": "run_8901", "object": "run", "kind": "matrix", "status": "completed", "task": "pick_place_class3", "episodes_per_cell": "auto(ci=0.95, moe=0.05)", "gate": { "metric": "ci95_lower", "min": 0.8 }, "robots": ["g1-edu-pro@fw2.3", "g1-edu-pro@fw2.4", "g1-edu-plus@fw2.3", "aloha2-pro@fw1.1", "spot-arm@fw4.1", "tiago-pro@fw2.0", "fr3-bench@fw5.2", "stretch3@fw1.9", "nori-a3@fw1.0", "so-101@fw1.2"], "environments": ["cell-a@v1.0", "kitchen-std@v1.2", "warehouse-std@v2.0"], "cells": [{ "robot": "g1-edu-pro@fw2.3", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.937, "ci95": [0.893, 0.964], "status": "pass" }, { "robot": "g1-edu-pro@fw2.3", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.892, "ci95": [0.846, 0.925], "status": "pass" }, { "robot": "g1-edu-pro@fw2.3", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.862, "ci95": [0.809, 0.902], "status": "pass" }, { "robot": "g1-edu-pro@fw2.4", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.921, "ci95": [0.874, 0.952], "status": "pass" }, { "robot": "g1-edu-pro@fw2.4", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.787, "ci95": [0.731, 0.835], "status": "fail" }, { "robot": "g1-edu-pro@fw2.4", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.838, "ci95": [0.782, 0.882], "status": "fail" }, { "robot": "g1-edu-plus@fw2.3", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.953, "ci95": [0.912, 0.975], "status": "pass" }, { "robot": "g1-edu-plus@fw2.3", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.921, "ci95": [0.88, 0.949], "status": "pass" }, { "robot": "g1-edu-plus@fw2.3", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.89, "ci95": [0.841, 0.926], "status": "pass" }, { "robot": "stretch3@fw1.9", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.879, "ci95": [0.825, 0.918], "status": "pass" }, { "robot": "stretch3@fw1.9", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.729, "ci95": [0.67, 0.781], "status": "fail" }, { "robot": "stretch3@fw1.9", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.629, "ci95": [0.561, 0.691], "status": "fail" }, { "robot": "nori-a3@fw1.0", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.8, "ci95": [0.737, 0.851], "status": "fail" }, { "robot": "nori-a3@fw1.0", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.537, "ci95": [0.474, 0.599], "status": "fail" }, { "robot": "nori-a3@fw1.0", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.467, "ci95": [0.4, 0.534], "status": "fail" }, { "robot": "aloha2-pro@fw1.1", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.937, "ci95": [0.893, 0.964], "status": "pass" }, { "robot": "aloha2-pro@fw1.1", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.871, "ci95": [0.823, 0.908], "status": "pass" }, { "robot": "aloha2-pro@fw1.1", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.843, "ci95": [0.788, 0.886], "status": "fail" }, { "robot": "spot-arm@fw4.1", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.884, "ci95": [0.831, 0.922], "status": "pass" }, { "robot": "spot-arm@fw4.1", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.746, "ci95": [0.687, 0.797], "status": "fail" }, { "robot": "spot-arm@fw4.1", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.79, "ci95": [0.73, 0.84], "status": "fail" }, { "robot": "tiago-pro@fw2.0", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.905, "ci95": [0.855, 0.939], "status": "pass" }, { "robot": "tiago-pro@fw2.0", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.808, "ci95": [0.753, 0.853], "status": "fail" }, { "robot": "tiago-pro@fw2.0", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.724, "ci95": [0.66, 0.78], "status": "fail" }, { "robot": "fr3-bench@fw5.2", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.947, "ci95": [0.905, 0.971], "status": "pass" }, { "robot": "fr3-bench@fw5.2", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.821, "ci95": [0.768, 0.864], "status": "fail" }, { "robot": "fr3-bench@fw5.2", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.79, "ci95": [0.73, 0.84], "status": "fail" }, { "robot": "so-101@fw1.2", "environment": "cell-a@v1.0", "n": 190, "success_rate": 0.742, "ci95": [0.675, 0.799], "status": "fail" }, { "robot": "so-101@fw1.2", "environment": "kitchen-std@v1.2", "n": 240, "success_rate": 0.463, "ci95": [0.401, 0.526], "status": "fail" }, { "robot": "so-101@fw1.2", "environment": "warehouse-std@v2.0", "n": 210, "success_rate": 0.41, "ci95": [0.346, 0.478], "status": "fail" }], "regressions_vs": "run_8821", "regressions": [{ "robot": "g1-edu-pro@fw2.4", "environment": "kitchen-std@v1.2", "delta_pts": -10.5, "note": "fw2.4 wrist controller change; grasp_slip cluster opened" }] };
+var TRANSFER = { "object": "transfer", "task": "towel_fold@v1", "interval_method": "wilson", "source": { "robot": "aloha-bimanual@fw3.1", "success_rate": 0.942, "n": 380, "ci95": [0.914, 0.961] }, "target": { "robot": "g1-edu-pro@fw2.3", "success_rate": 0.715, "n": 340, "ci95": [0.665, 0.76] }, "delta_pts": -22.7, "new_failure_clusters": ["grasp_slip", "wrist_singularity"] };
+var USAGE = { "object": "usage", "period": "2026-09", "robot_hours": { "verify": 141.2, "soak": 2210.5 }, "env_hours": { "bare": 96, "standard": 402.3, "replica": 118.9, "instrumented-replica": 6.2 }, "usd_total": 18940, "budget": { "monthly_usd": 25e3, "hard": true, "remaining_usd": 6060 } };
+var STREAM = { "object": "stream", "run": "run_9101", "episode": 341, "of": 412, "cell": "cell-g1-04", "webrtc": "wss://streams.roborama.com/cells/cell-g1-04/webrtc", "mjpeg": "https://streams.roborama.com/cells/cell-g1-04/mjpeg", "viewer_token": "vt_7Kq2mHentXw4", "expires": "2026-09-01T20:00:00Z" };
+
+// src/stats.ts
+var Z_TABLE = {
+  "0.9": 1.6448536269514722,
+  "0.95": 1.959963984540054,
+  "0.99": 2.5758293035489004
+};
+var AUTO_RE = /^auto\(ci=(0\.[0-9]+), ?moe=(0\.[0-9]+)\)$/;
+function zForCi(ci) {
+  const exact = Z_TABLE[String(ci)];
+  if (exact !== void 0) return exact;
+  const p = 1 - (1 - ci) / 2;
+  const a = [
+    -39.69683028665376,
+    220.9460984245205,
+    -275.9285104469687,
+    138.357751867269,
+    -30.66479806614716,
+    2.506628277459239
+  ];
+  const b = [
+    -54.47609879822406,
+    161.5858368580409,
+    -155.6989798598866,
+    66.80131188771972,
+    -13.28068155288572
+  ];
+  const c = [
+    -0.007784894002430293,
+    -0.3223964580411365,
+    -2.400758277161838,
+    -2.549732539343734,
+    4.374664141464968,
+    2.938163982698783
+  ];
+  const d = [
+    0.007784695709041462,
+    0.3224671290700398,
+    2.445134137142996,
+    3.754408661907416
+  ];
+  const plow = 0.02425;
+  const phigh = 1 - plow;
+  if (p < plow) {
+    const q2 = Math.sqrt(-2 * Math.log(p));
+    return -(((((c[0] * q2 + c[1]) * q2 + c[2]) * q2 + c[3]) * q2 + c[4]) * q2 + c[5]) / ((((d[0] * q2 + d[1]) * q2 + d[2]) * q2 + d[3]) * q2 + 1);
+  }
+  if (p <= phigh) {
+    const q2 = p - 0.5;
+    const r = q2 * q2;
+    return (((((a[0] * r + a[1]) * r + a[2]) * r + a[3]) * r + a[4]) * r + a[5]) * q2 / (((((b[0] * r + b[1]) * r + b[2]) * r + b[3]) * r + b[4]) * r + 1);
+  }
+  const q = Math.sqrt(-2 * Math.log(1 - p));
+  return (((((c[0] * q + c[1]) * q + c[2]) * q + c[3]) * q + c[4]) * q + c[5]) / ((((d[0] * q + d[1]) * q + d[2]) * q + d[3]) * q + 1);
+}
+var round1 = (x) => Math.round(x * 10) / 10;
+var round3 = (x) => Math.round(x * 1e3) / 1e3;
+function wilsonCi(successes, n, ci = 0.95) {
+  if (n <= 0) return [0, 0];
+  const z = zForCi(ci);
+  const p = successes / n;
+  const z2 = z * z;
+  const denom = 1 + z2 / n;
+  const center = (p + z2 / (2 * n)) / denom;
+  const half = z * Math.sqrt(p * (1 - p) / n + z2 / (4 * n * n)) / denom;
+  return [round3(center - half), round3(center + half)];
+}
+function parseAuto(spec) {
+  const m = AUTO_RE.exec(spec.trim());
+  if (!m) return null;
+  return { ci: Number(m[1]), moe: Number(m[2]) };
+}
+function validateEpisodes(spec) {
+  if (typeof spec === "number") {
+    if (!Number.isInteger(spec) || spec < 1) {
+      throw new RangeError("episodes must be a positive integer or 'auto(ci=..., moe=...)'");
+    }
+    return;
+  }
+  if (parseAuto(spec) === null) {
+    throw new RangeError(
+      "episodes is neither a positive int nor a well-formed 'auto(ci=..., moe=...)'"
+    );
+  }
+}
+function planningN(ci, moe) {
+  const z = zForCi(ci);
+  return Math.ceil(z * z * 0.25 / (moe * moe));
+}
+function realizedN(ci, moe) {
+  const z = zForCi(ci);
+  const z95 = zForCi(0.95);
+  return Math.max(1, Math.round(612 * (0.03 / moe) ** 2 * (z / z95) ** 2));
+}
+
+// src/mock.ts
+var MOCK_NOW = "2026-09-08T00:00:00Z";
+var MOCK_LATER = "2026-09-08T01:00:00Z";
+var BASE_RATE = 535 / 612;
+var CLUSTER_SPLIT = [
+  ["grasp_slip", 41 / 77],
+  ["perception_miss", 22 / 77],
+  ["collision", 9 / 77]
+];
+var MINUTES_PER_EPISODE = 2;
+var QUEUE_ETA = { burst: "1h", standard: "6h", soak: "24h" };
+var PRIORITY_MULT = { burst: 1.5, standard: 1, soak: 0.6 };
+var DEFAULT_ROBOT_RATE = 148;
+var DEFAULT_ENV_TIER = "replica";
+var baseId = (ref) => ref.split("@", 1)[0].split("@")[0];
+var clone = (x) => JSON.parse(JSON.stringify(x));
+function notFound(message, run_id) {
+  return new RoboramaError(message, { code: "not_found", status: 404, run_id });
+}
+var MockBackend = class {
+  constructor() {
+    this.runs = /* @__PURE__ */ new Map();
+    this.tasks = /* @__PURE__ */ new Map();
+    this.kits = /* @__PURE__ */ new Map();
+    this.counters = /* @__PURE__ */ new Map();
+    this.robotRates = /* @__PURE__ */ new Map();
+    this.envTier = /* @__PURE__ */ new Map();
+    this.tierRates = /* @__PURE__ */ new Map();
+    for (const r of RUNS) this.runs.set(r.id, clone(r));
+    this.runs.set(MATRIX.id, clone(MATRIX));
+    const demo = clone(this.runs.get("run_8842"));
+    demo.id = "run_demo";
+    this.runs.set("run_demo", demo);
+    for (const t of TASKS) this.tasks.set(t.id, clone(t));
+    for (const k of KITS) this.kits.set(k.id, clone(k));
+    for (const r of PRICING.robot_rates) {
+      this.robotRates.set(r.id, r.usd_per_robot_hour);
+    }
+    for (const e of ENVIRONMENTS) this.envTier.set(e.id, e.adder_tier);
+    for (const e of PRICING.environment_rates) {
+      this.tierRates.set(e.adder_tier, e.usd_per_env_hour);
+    }
+  }
+  next(prefix, start) {
+    const n = this.counters.get(prefix) ?? start;
+    this.counters.set(prefix, n + 1);
+    return `${prefix}${n}`;
+  }
+  request(method, path, body, params) {
+    body = body ?? {};
+    params = params ?? {};
+    const parts = path.split("/").filter(Boolean);
+    const key = `${method.toUpperCase()} ${path}`;
+    if (key === "POST /v1/quote") return this.quote(body);
+    if (key === "POST /v1/runs") return this.createRun(body);
+    if (key === "GET /v1/runs") return this.listRuns(params);
+    if (method === "GET" && parts.length === 3 && parts[1] === "runs") {
+      return this.getRun(parts[2]);
+    }
+    if (method === "GET" && parts.length === 4 && parts[1] === "runs" && parts[3] === "episodes") {
+      return this.listEpisodes(parts[2]);
+    }
+    if (method === "GET" && parts.length === 4 && parts[1] === "runs" && parts[3] === "report") {
+      return this.report(parts[2]);
+    }
+    if (method === "POST" && parts.length === 4 && parts[1] === "runs" && parts[3] === "export") {
+      return this.export(parts[2], body.format ?? "lerobot");
+    }
+    if (method === "POST" && parts.length === 4 && parts[1] === "runs" && parts[3] === "on-verified") {
+      const run = this.getRun(parts[2]);
+      run.on_verified = { webhook: body.webhook };
+      return run;
+    }
+    if (key === "GET /v1/robots") {
+      return { object: "list", url: "/v1/robots", data: clone(ROBOTS) };
+    }
+    if (key === "GET /v1/environments") {
+      let data = clone(ENVIRONMENTS);
+      if (params.cls) data = data.filter((e) => e.class === params.cls);
+      return { object: "list", url: "/v1/environments", data };
+    }
+    if (key === "GET /v1/suites") {
+      return { object: "list", url: "/v1/suites", data: clone(SUITES) };
+    }
+    if (key === "POST /v1/gates") {
+      return {
+        object: "gate",
+        id: this.next("gate_", 312),
+        status: "active",
+        on: body.on,
+        suite: body.suite,
+        robots: body.robots ?? [],
+        fail_if: body.fail_if ?? {}
+      };
+    }
+    if (method === "GET" && parts.length === 3 && parts[1] === "streams") {
+      const cell = parts[2];
+      return {
+        ...clone(STREAM),
+        cell,
+        webrtc: `wss://streams.roborama.com/cells/${cell}/webrtc`,
+        mjpeg: `https://streams.roborama.com/cells/${cell}/mjpeg`
+      };
+    }
+    if (key === "GET /v1/usage") {
+      const usage = clone(USAGE);
+      if (params.period) usage.period = params.period;
+      return usage;
+    }
+    if (key === "PUT /v1/budgets") {
+      const monthly = Number(body.monthly_usd ?? 0);
+      return {
+        monthly_usd: monthly,
+        hard: Boolean(body.hard ?? false),
+        remaining_usd: Math.round((monthly - USAGE.usd_total) * 100) / 100
+      };
+    }
+    if (key === "POST /v1/keys") {
+      return {
+        object: "key",
+        id: this.next("key_", 7001),
+        scope: body.scope ?? [],
+        secret: "rbr_live_mock_0000000000000000",
+        created: MOCK_NOW
+      };
+    }
+    if (key === "GET /v1/keys") return { object: "list", data: [] };
+    if (key === "POST /v1/calibration/exports") {
+      const id = this.next("exp_cal_", 1);
+      return {
+        object: "export",
+        id,
+        format: "mcap-bundle",
+        status: "ready",
+        download_url: `https://artifacts.roborama.com/calibration/${id}.tar.gz`
+      };
+    }
+    if (method === "DELETE" && parts.length === 3 && parts[1] === "data") {
+      return {
+        object: "purge_receipt",
+        id: this.next("purge_", 1),
+        run_id: parts[2],
+        status: "completed",
+        purged_at: MOCK_NOW
+      };
+    }
+    if (key === "POST /v1/tasks") return this.createTask(body);
+    if (key === "GET /v1/tasks") {
+      return { object: "list", url: "/v1/tasks", data: [...this.tasks.values()] };
+    }
+    if (method === "GET" && parts.length === 3 && parts[1] === "tasks") {
+      return this.getTask(parts[2]);
+    }
+    if (method === "POST" && parts.length === 4 && parts[1] === "tasks") {
+      return this.taskAction(parts[2], parts[3], body);
+    }
+    if (key === "POST /v1/kits") return this.registerKit(body);
+    if (method === "GET" && parts.length === 3 && parts[1] === "kits") {
+      return this.getKit(parts[2]);
+    }
+    if (method === "GET" && parts.length === 4 && parts[1] === "kits" && parts[3] === "shipping-label") {
+      const kit = this.getKit(parts[2]);
+      return {
+        url: `https://artifacts.roborama.com/labels/${kit.id}.pdf`,
+        expires: MOCK_LATER
+      };
+    }
+    throw notFound(`No mock route for ${method} ${path}`);
+  }
+  *events(runId) {
+    const run = this.getRun(runId);
+    const n = this.realizedEpisodes(run);
+    const cell = "cell-g1-04";
+    for (const i of [1, 2, 3]) {
+      yield { episode: i, of: n, outcome: "success", duration_s: 121, status: "running" };
+    }
+    yield {
+      status: "completed",
+      episode: n,
+      of: n,
+      cell,
+      webrtc: `wss://streams.roborama.com/cells/${cell}/webrtc`
+    };
+  }
+  // -- rate card --------------------------------------------------------------
+  robotRate(robot) {
+    return this.robotRates.get(baseId(robot)) ?? DEFAULT_ROBOT_RATE;
+  }
+  envRate(environment) {
+    const tier = this.envTier.get(baseId(environment)) ?? DEFAULT_ENV_TIER;
+    return this.tierRates.get(tier) ?? this.tierRates.get(DEFAULT_ENV_TIER);
+  }
+  episodeCount(spec, realized) {
+    validateEpisodes(spec);
+    if (typeof spec === "number") return spec;
+    const auto = parseAuto(spec);
+    return realized ? realizedN(auto.ci, auto.moe) : planningN(auto.ci, auto.moe);
+  }
+  quote(body) {
+    const robot = body.robot ?? "g1-edu-pro";
+    const environment = body.environment ?? "kitchen-std";
+    const priority = body.priority ?? "standard";
+    const episodes = body.episodes ?? 600;
+    const n = this.episodeCount(episodes, false);
+    const hours = round1(n * MINUTES_PER_EPISODE / 60);
+    const rr = this.robotRate(robot);
+    const er = this.envRate(environment);
+    const robotUsd = Math.round(hours * rr);
+    const envUsd = Math.round(hours * er);
+    const mult = PRIORITY_MULT[priority] ?? 1;
+    return {
+      object: "quote",
+      robot,
+      environment,
+      episodes,
+      priority,
+      robot_hours: hours,
+      env_hours: hours,
+      usd: Math.round((robotUsd + envUsd) * mult),
+      queue_eta: QUEUE_ETA[priority] ?? "6h",
+      breakdown: {
+        minutes_per_episode_est: MINUTES_PER_EPISODE,
+        robot_usd_per_hour: rr,
+        env_usd_per_hour: er,
+        robot_usd: robotUsd,
+        env_usd: envUsd
+      },
+      expires: MOCK_NOW
+    };
+  }
+  // -- runs ---------------------------------------------------------------------
+  canonicalResult(runId) {
+    return clone(this.runs.get(runId).result);
+  }
+  genericResult(n, robot, environment, priority, rate = BASE_RATE) {
+    const successes = Math.round(n * rate);
+    const failures = n - successes;
+    const clusters = {};
+    for (const [name, share] of CLUSTER_SPLIT) {
+      const count = Math.round(failures * share);
+      if (count) clusters[name] = count;
+    }
+    const hours = round1(n * MINUTES_PER_EPISODE / 60);
+    const mult = PRIORITY_MULT[priority] ?? 1;
+    const cost = Math.round(
+      n * MINUTES_PER_EPISODE / 60 * (this.robotRate(robot) + this.envRate(environment)) * mult
+    );
+    return {
+      n,
+      success_rate: round3(successes / Math.max(n, 1)),
+      ci95: wilsonCi(successes, n),
+      interval_method: "wilson",
+      failure_clusters: clusters,
+      robot_hours: hours,
+      environment_hours: hours,
+      cost_usd: cost
+    };
+  }
+  artifacts(runId) {
+    const base = `https://api.roborama.com/v1/runs/${runId}`;
+    return {
+      mcap: `${base}/episodes?artifact=mcap`,
+      video: `${base}/episodes?artifact=video`,
+      ground_truth: `${base}/episodes?artifact=ground_truth`,
+      report_pdf: `${base}/report?format=pdf`
+    };
+  }
+  createRun(body) {
+    const kind = body.kind ?? "run";
+    const id = this.next("run_", 9200);
+    const run = {
+      id,
+      object: "run",
+      kind,
+      status: "completed",
+      created: MOCK_NOW,
+      completed: MOCK_LATER,
+      priority: body.priority ?? "standard"
+    };
+    for (const field of [
+      "robot",
+      "robots",
+      "environment",
+      "environments",
+      "task",
+      "suite",
+      "policy",
+      "policies",
+      "policy_stream",
+      "episodes",
+      "episodes_per_cell",
+      "perturbation",
+      "data",
+      "max_budget_usd",
+      "paired",
+      "publish",
+      "audit_sample",
+      "return_ground_truth",
+      "source",
+      "target",
+      "iterate_on",
+      "escalate_to",
+      "monthly_cap_usd",
+      "on_verified",
+      "interventions",
+      "scenarios"
+    ]) {
+      if (body[field] !== void 0 && body[field] !== null) run[field] = body[field];
+    }
+    const pins = {};
+    for (const field of ["robot", "environment", "task"]) {
+      if (typeof run[field] === "string") pins[field] = run[field];
+    }
+    if (run.perturbation) pins.perturbation_rev = "set-B@v1.4";
+    if (Object.keys(pins).length) run.resolved_pins = pins;
+    switch (kind) {
+      case "eval":
+        this.buildEval(run);
+        break;
+      case "verify":
+        this.buildVerify(run);
+        break;
+      case "matrix":
+        this.buildMatrix(run);
+        break;
+      case "threshold":
+        run.status = "running";
+        break;
+      case "compare":
+        this.buildCompare(run);
+        break;
+      case "transfer":
+        this.buildTransfer(run);
+        break;
+      default:
+        this.buildRun(run);
+    }
+    this.runs.set(id, run);
+    return run;
+  }
+  buildRun(run) {
+    const robot = run.robot ?? "g1-edu-pro@fw2.3";
+    const environment = run.environment ?? "kitchen-std@v1.2";
+    const priority = run.priority ?? "standard";
+    const spec = run.episodes ?? "auto(ci=0.95, moe=0.03)";
+    const n = this.episodeCount(spec, true);
+    const budget = run.max_budget_usd;
+    const episodeUsd = MINUTES_PER_EPISODE / 60 * (this.robotRate(robot) + this.envRate(environment)) * (PRIORITY_MULT[priority] ?? 1);
+    if (budget !== void 0 && episodeUsd * n > Number(budget)) {
+      const affordable = Math.max(0, Math.floor(Number(budget) / episodeUsd));
+      run.status = "stopped";
+      run.error = {
+        code: "budget_exceeded",
+        message: `Run halted at max_budget_usd=${budget} after ${affordable} episodes.`,
+        run_id: run.id,
+        doc_url: "https://roborama.com/docs/errors/#budget_exceeded",
+        partial_result: affordable ? this.genericResult(affordable, robot, environment, priority) : void 0
+      };
+      return;
+    }
+    let result;
+    const task = String(run.task ?? "");
+    if (task.startsWith("espresso")) {
+      result = this.canonicalResult("run_9101");
+    } else if (spec === "auto(ci=0.95, moe=0.03)" || n === 612) {
+      result = this.canonicalResult("run_8842");
+    } else {
+      result = this.genericResult(n, robot, environment, priority);
+    }
+    result.artifacts = this.artifacts(run.id);
+    run.result = result;
+  }
+  buildEval(run) {
+    const sample = (SUITES[0] ?? {}).sample_report ?? {};
+    run.citation = sample.citation;
+    run.attestation = sample.attestation;
+    run.attestation_url = sample.attestation_url;
+    run.overall = sample.overall;
+    run.per_task = sample.per_task;
+    const overall = { ...sample.overall ?? {} };
+    overall.interval_method = overall.interval_method ?? "wilson";
+    overall.artifacts = this.artifacts(run.id);
+    run.result = overall;
+  }
+  buildVerify(run) {
+    run.sim_agreement = 0.93;
+    run.disagreements = ["scn_0042", "scn_0113", "scn_0197"];
+    if (run.return_ground_truth) {
+      run.ground_truth_url = `https://artifacts.roborama.com/verify/${run.id}/ground_truth.tar.gz`;
+    }
+    const robots = run.robots ?? ["g1-edu-pro@fw2.3"];
+    const result = this.genericResult(340, robots[0], "kitchen-std", run.priority ?? "standard");
+    result.artifacts = this.artifacts(run.id);
+    run.result = result;
+  }
+  matrixCell(robot, environment) {
+    const envBase = baseId(environment);
+    for (const cell of MATRIX.cells) {
+      if (cell.robot === robot && baseId(cell.environment) === envBase) {
+        return { ...clone(cell), environment };
+      }
+    }
+    const n = { "cell-a": 190, "kitchen-std": 240, "warehouse-std": 210 }[envBase] ?? 240;
+    let rate = 0.85;
+    for (const cell of MATRIX.cells) {
+      if (cell.robot === robot && baseId(cell.environment) === "kitchen-std") {
+        rate = cell.success_rate;
+        break;
+      }
+    }
+    const successes = Math.round(n * rate);
+    const [lo, hi] = wilsonCi(successes, n);
+    return {
+      robot,
+      environment,
+      n,
+      success_rate: round3(successes / n),
+      ci95: [lo, hi],
+      status: lo >= 0.8 ? "pass" : "fail"
+    };
+  }
+  buildMatrix(run) {
+    const robots = run.robots ?? [];
+    const environments = run.environments ?? [];
+    const cells = robots.flatMap((r) => environments.map((e) => this.matrixCell(r, e)));
+    run.cells = cells;
+    run.gate = { metric: "ci95_lower", min: 0.8 };
+    run.regressions = clone(MATRIX.regressions);
+    const nTotal = cells.reduce((acc, c) => acc + c.n, 0);
+    const successes = cells.reduce((acc, c) => acc + Math.round(c.n * c.success_rate), 0);
+    const result = this.genericResult(
+      Math.max(nTotal, 1),
+      robots[0] ?? "g1-edu-pro@fw2.3",
+      environments[0] ?? "kitchen-std",
+      run.priority ?? "standard",
+      nTotal ? successes / nTotal : BASE_RATE
+    );
+    if (String(run.task ?? "").startsWith("espresso")) {
+      const canonical = this.canonicalResult("run_9101");
+      result.stage_rates = canonical.stage_rates;
+      result.instruction_breakdown = canonical.instruction_breakdown;
+    }
+    result.artifacts = this.artifacts(run.id);
+    run.result = result;
+  }
+  buildCompare(run) {
+    const names = Object.keys(run.policies ?? {}).sort();
+    const winner = names.length ? names[names.length - 1] : void 0;
+    run.winner = winner;
+    run.p_value = 8e-3;
+    run.effect_pts = 4.1;
+    const results = {};
+    for (const name of names) {
+      const rate = name === winner ? BASE_RATE : BASE_RATE - 0.041;
+      const successes = Math.round(340 * rate);
+      results[name] = {
+        n: 340,
+        success_rate: round3(successes / 340),
+        ci95: wilsonCi(successes, 340),
+        interval_method: "wilson"
+      };
+    }
+    run.results = results;
+  }
+  buildTransfer(run) {
+    const report = clone(TRANSFER);
+    if (run.task) report.task = run.task;
+    if (run.source) report.source = { ...report.source, robot: run.source };
+    if (typeof run.target === "string") report.target = { ...report.target, robot: run.target };
+    run.transfer = report;
+  }
+  listRuns(params) {
+    let data = [...this.runs.values()];
+    if (params.kind) data = data.filter((r) => r.kind === params.kind);
+    if (params.status) data = data.filter((r) => r.status === params.status);
+    const limit = Number(params.limit ?? 20);
+    return { object: "list", url: "/v1/runs", data: data.slice(0, limit) };
+  }
+  getRun(runId) {
+    const run = this.runs.get(runId);
+    if (!run) throw notFound(`No such run: ${runId}`, runId);
+    return run;
+  }
+  realizedEpisodes(run) {
+    if (run.result?.n) return Number(run.result.n);
+    try {
+      return this.episodeCount(run.episodes ?? 612, true);
+    } catch {
+      return 612;
+    }
+  }
+  listEpisodes(runId) {
+    const run = this.getRun(runId);
+    const n = this.realizedEpisodes(run);
+    const rate = run.result?.success_rate ?? BASE_RATE;
+    const successes = Math.round(n * rate);
+    const failures = n - successes;
+    const clusters = [];
+    for (const [name, count] of Object.entries(run.result?.failure_clusters ?? {})) {
+      for (let i = 0; i < Number(count); i++) clusters.push(name);
+    }
+    const episodes = [];
+    let failSeen = 0;
+    for (let i = 0; i < n; i++) {
+      const isFailure = failures > 0 && Math.floor(i * failures / n) !== Math.floor((i + 1) * failures / n);
+      const base = `https://artifacts.roborama.com/${runId}/ep_${String(i).padStart(5, "0")}`;
+      const episode = {
+        id: `${runId}_ep_${String(i).padStart(5, "0")}`,
+        object: "episode",
+        index: i,
+        outcome: isFailure ? "failure" : "success",
+        duration_s: 100 + i * 37 % 80,
+        video_url: `${base}/video.mp4`,
+        mcap_url: `${base}/episode.mcap`,
+        replay_spec: {
+          episode: i,
+          seed: run.perturbation?.seed ?? 42,
+          initial_conditions: { layout_seed: 42 + i }
+        }
+      };
+      if (isFailure) {
+        if (failSeen < clusters.length) episode.cluster = clusters[failSeen];
+        failSeen += 1;
+      }
+      episodes.push(episode);
+    }
+    return { object: "list", url: `/v1/runs/${runId}/episodes`, data: episodes };
+  }
+  raiseIfStopped(run) {
+    if (run.status === "stopped" && run.error) {
+      throw errorFromEnvelope(402, { error: run.error });
+    }
+  }
+  report(runId) {
+    const run = this.getRun(runId);
+    this.raiseIfStopped(run);
+    const pdf = `https://api.roborama.com/v1/runs/${runId}/report?format=pdf`;
+    return {
+      object: "report",
+      run_id: runId,
+      kind: "verification",
+      result: run.result,
+      resolved_pins: run.resolved_pins ?? {},
+      citation: `Roborama verification report, ${runId}, task ${run.task ?? "n/a"}, ${MOCK_NOW.slice(0, 10)}`,
+      pdf_url: pdf,
+      url: pdf
+    };
+  }
+  export(runId, format) {
+    this.getRun(runId);
+    const id = this.next("exp_", 1);
+    return {
+      object: "export",
+      id,
+      run_id: runId,
+      format,
+      status: "ready",
+      download_url: `https://artifacts.roborama.com/exports/${runId}-${format}.tar.gz`
+    };
+  }
+  // -- tasks / kits -------------------------------------------------------------
+  createTask(body) {
+    const name = body.name ?? "task";
+    const num = this.next(`tasknum_${name}_`, 1).split("_").pop();
+    const task = {
+      id: `task_${name}_${num.padStart(2, "0")}`,
+      object: "task",
+      name,
+      rev: null,
+      status: "draft",
+      visibility: body.visibility ?? "private",
+      created: MOCK_NOW,
+      frozen: null,
+      signatures: [],
+      initial_conditions: body.initial_conditions ?? {},
+      success_predicates: body.success_predicates ?? [],
+      instructions: body.instructions ?? {},
+      stages: body.stages ?? [],
+      envelope: body.envelope ?? {},
+      baseline: body.baseline,
+      pilot: null
+    };
+    this.tasks.set(task.id, task);
+    return task;
+  }
+  getTask(taskId) {
+    const task = this.tasks.get(taskId);
+    if (!task) throw notFound(`No such task: ${taskId}`);
+    return task;
+  }
+  taskAction(taskId, action, body) {
+    const task = this.getTask(taskId);
+    if (action === "pilot") {
+      task.status = "piloting";
+      const pilot = {
+        run_id: "run_9088",
+        robot: body.robot,
+        episodes: body.episodes ?? 25,
+        stream_url: "wss://streams.roborama.com/cells/cell-g1-02/webrtc",
+        amendments: task.pilot?.amendments ?? 0
+      };
+      task.pilot = pilot;
+      return pilot;
+    }
+    if (action === "amend") {
+      for (const [key, value] of Object.entries(body)) {
+        if (value !== void 0 && value !== null) task[key] = value;
+      }
+      if (task.pilot) task.pilot.amendments = (task.pilot.amendments ?? 0) + 1;
+      return task;
+    }
+    if (action === "freeze") {
+      task.status = "frozen";
+      task.rev = `${task.name}@v1`;
+      task.frozen = MOCK_NOW;
+      task.signatures = ["acct_customer", "roborama"];
+      return task;
+    }
+    throw notFound(`No mock route for task action: ${action}`);
+  }
+  registerKit(body) {
+    const name = body.name ?? "kit";
+    const id = `kit_${String(name).replace(/-/g, "_")}`;
+    const kit = {
+      id,
+      object: "kit",
+      name,
+      status: "registered",
+      status_history: [{ status: "registered", at: MOCK_NOW }],
+      items: body.items ?? [],
+      tracking: null,
+      environment_ref: null,
+      shipping_label_url: `https://api.roborama.com/v1/kits/${id}/shipping-label`
+    };
+    this.kits.set(id, kit);
+    return kit;
+  }
+  getKit(kitId) {
+    const kit = this.kits.get(kitId);
+    if (!kit) throw notFound(`No such kit: ${kitId}`);
+    return kit;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.roborama.com";
+var USER_AGENT = "roborama-typescript/0.1.0";
+function env(name) {
+  const proc = globalThis.process;
+  return proc?.env?.[name];
+}
+function envFlag(name) {
+  const value = (env(name) ?? "").trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes" || value === "on";
+}
+function idempotencyKey() {
+  const c = globalThis.crypto;
+  if (c?.randomUUID) return c.randomUUID();
+  return `idk-${Date.now()}-${Math.floor(Math.random() * 1e9)}`;
+}
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function cleanBody(params) {
+  const out = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null) out[key] = value;
+  }
+  return out;
+}
+var Transport = class {
+  constructor(opts = {}) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? env("ROBORAMA_BASE_URL") ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.mockOpt = opts.mock;
+    this.fetchImpl = opts.fetch;
+  }
+  get mock() {
+    return this.mockOpt ?? envFlag("ROBORAMA_MOCK");
+  }
+  engine() {
+    if (!this.mockBackend) this.mockBackend = new MockBackend();
+    return this.mockBackend;
+  }
+  key() {
+    const key = this.apiKey ?? env("ROBORAMA_API_KEY");
+    if (!key) {
+      throw new RoboramaError(
+        "No API key. Export ROBORAMA_API_KEY (keys use the rbr_live_ prefix), or set ROBORAMA_MOCK=1 / new Roborama({ mock: true }) to integrate offline against the deterministic mock backend.",
+        { code: "invalid_api_key", status: 401 }
+      );
+    }
+    return key;
+  }
+  async request(method, path, opts = {}) {
+    if (this.mock) {
+      return this.engine().request(method, path, opts.body, opts.params);
+    }
+    const fetchFn = this.fetchImpl ?? globalThis.fetch;
+    const headers = {
+      Authorization: `Bearer ${this.key()}`,
+      Accept: "application/json",
+      "User-Agent": USER_AGENT
+    };
+    if (opts.body !== void 0) headers["Content-Type"] = "application/json";
+    if (method === "POST" && path === "/v1/runs") {
+      headers["Idempotency-Key"] = idempotencyKey();
+    }
+    const url = new URL(this.baseUrl + path);
+    for (const [key, value] of Object.entries(opts.params ?? {})) {
+      if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
+    }
+    for (let attempt = 1; ; attempt++) {
+      let resp;
+      try {
+        resp = await fetchFn(url, {
+          method,
+          headers,
+          body: opts.body !== void 0 ? JSON.stringify(opts.body) : void 0
+        });
+      } catch (cause) {
+        if (attempt <= 2) {
+          await sleep(500 * attempt);
+          continue;
+        }
+        throw new RoboramaError(`Network error talking to ${this.baseUrl}: ${cause}`, {
+          code: "transport_error"
+        });
+      }
+      if (resp.status === 429 && attempt <= 2) {
+        const retryAfter = Number(resp.headers.get("Retry-After") ?? "1");
+        await sleep(Math.min(Number.isFinite(retryAfter) ? retryAfter * 1e3 : 1e3, 3e4));
+        continue;
+      }
+      if (resp.ok) {
+        const text = await resp.text();
+        return text ? JSON.parse(text) : null;
+      }
+      let payload;
+      try {
+        payload = await resp.json();
+      } catch {
+        payload = void 0;
+      }
+      if (!payload) {
+        throw new RoboramaError(`HTTP ${resp.status} from ${path}`, {
+          code: `http_${resp.status}`,
+          status: resp.status
+        });
+      }
+      throw errorFromEnvelope(resp.status, payload);
+    }
+  }
+  async *events(runId) {
+    if (this.mock) {
+      yield* this.engine().events(runId);
+      return;
+    }
+    const fetchFn = this.fetchImpl ?? globalThis.fetch;
+    const resp = await fetchFn(`${this.baseUrl}/v1/runs/${runId}/events`, {
+      headers: {
+        Authorization: `Bearer ${this.key()}`,
+        Accept: "text/event-stream",
+        "User-Agent": USER_AGENT
+      }
+    });
+    if (!resp.ok || !resp.body) {
+      let payload;
+      try {
+        payload = await resp.json();
+      } catch {
+        payload = void 0;
+      }
+      throw errorFromEnvelope(resp.status, payload);
+    }
+    const reader = resp.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType;
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let idx;
+      while ((idx = buffer.indexOf("\n")) >= 0) {
+        const line = buffer.slice(0, idx).trim();
+        buffer = buffer.slice(idx + 1);
+        if (!line) {
+          eventType = void 0;
+          continue;
+        }
+        if (line.startsWith("event:")) {
+          eventType = line.slice(6).trim();
+        } else if (line.startsWith("data:")) {
+          try {
+            const data = JSON.parse(line.slice(5).trim());
+            if (data.status === void 0) {
+              data.status = eventType === "episode" ? "running" : eventType ?? "running";
+            }
+            yield data;
+          } catch {
+          }
+        }
+      }
+    }
+  }
+};
+var Policy = {
+  /** A container image we run in-facility, GPU-adjacent. */
+  container(opts) {
+    return { type: "container", ...opts };
+  },
+  /** A checkpoint on a known runtime (`openpi`, `lerobot`). */
+  checkpoint(opts) {
+    return { type: "checkpoint", ...opts };
+  },
+  /** Customer-hosted inference; measured RTT is logged per step. */
+  endpoint(opts) {
+    return { type: "endpoint", latency_budget_ms: 80, fallback: "halt", ...opts };
+  }
+};
+var BaseRunHandle = class {
+  constructor(transport, data) {
+    this.transport = transport;
+    this.data = data;
+  }
+  get id() {
+    return this.data.id;
+  }
+  get kind() {
+    return this.data.kind;
+  }
+  get status() {
+    return this.data.status;
+  }
+  get resolved_pins() {
+    return this.data.resolved_pins ?? {};
+  }
+  /** The full wire payload, for forward compatibility. */
+  get raw() {
+    return this.data;
+  }
+  async refresh() {
+    this.data = await this.transport.request("GET", `/v1/runs/${this.id}`);
+    return this;
+  }
+  raiseIfStopped() {
+    const error = this.data.error;
+    if (this.data.status === "stopped" && error) {
+      throw errorFromEnvelope(402, { error });
+    }
+  }
+};
+var RunHandle = class extends BaseRunHandle {
+  /** `n`, `success_rate`, `ci95`, clusters, both meters, `cost_usd`. */
+  async result() {
+    await this.refresh();
+    this.raiseIfStopped();
+    return this.data.result ?? {};
+  }
+  /** Per-episode artifacts: `video_url`, `mcap_url`, `replay_spec`. */
+  async episodes() {
+    const payload = await this.transport.request("GET", `/v1/runs/${this.id}/episodes`);
+    return payload.data ?? [];
+  }
+  /** Live events: episode ticker plus WebRTC stream URLs. No polling. */
+  watch() {
+    return this.transport.events(this.id);
+  }
+  /** Dataset export: `lerobot`, `rlds`, or `mcap-bundle`. */
+  async export(opts) {
+    return this.transport.request("POST", `/v1/runs/${this.id}/export`, {
+      body: { format: opts.format }
+    });
+  }
+  /** The deployment verification report, citable. */
+  async report(opts = {}) {
+    return this.transport.request("GET", `/v1/runs/${this.id}/report`, {
+      params: { format: opts.format ?? "pdf" }
+    });
+  }
+};
+var EvalRunHandle = class extends RunHandle {
+  get citation() {
+    return this.data.citation;
+  }
+  get attestation() {
+    return this.data.attestation;
+  }
+  get attestation_url() {
+    return this.data.attestation_url;
+  }
+  get per_task() {
+    return this.data.per_task ?? [];
+  }
+};
+var CompareRunHandle = class extends RunHandle {
+  get winner() {
+    return this.data.winner;
+  }
+  get p_value() {
+    return this.data.p_value;
+  }
+  get effect_pts() {
+    return this.data.effect_pts;
+  }
+  get results() {
+    return this.data.results ?? {};
+  }
+};
+var VerifyRunHandle = class extends RunHandle {
+  /** Where reality matched sim predictions. */
+  get sim_agreement() {
+    return this.data.sim_agreement;
+  }
+  /** Scenario ids where reality diverged. */
+  get disagreements() {
+    return this.data.disagreements ?? [];
+  }
+  get ground_truth_url() {
+    return this.data.ground_truth_url;
+  }
+};
+var ThresholdContractHandle = class extends RunHandle {
+  /** Register the webhook fired after verification-tier confirmation. */
+  async onVerified(opts) {
+    this.data = await this.transport.request("POST", `/v1/runs/${this.id}/on-verified`, {
+      body: { webhook: opts.webhook }
+    });
+    return this;
+  }
+};
+var TransferRunHandle = class extends BaseRunHandle {
+  /** Source vs. target statistics and the failure clusters transfer opened. */
+  async report() {
+    await this.refresh();
+    this.raiseIfStopped();
+    return this.data.transfer ?? {};
+  }
+};
+var MatrixRunHandle = class extends RunHandle {
+  get cells() {
+    return this.data.cells ?? [];
+  }
+  /** Embodiment × environment grid of rate ± CI per cell. */
+  async heatmap() {
+    const grid = {};
+    for (const cell of this.cells) {
+      (grid[cell.robot] ??= {})[cell.environment] = {
+        n: cell.n,
+        success_rate: cell.success_rate,
+        ci95: cell.ci95,
+        status: cell.status
+      };
+    }
+    return grid;
+  }
+  /** Cells that degraded vs. a prior release run. */
+  async regressions(opts) {
+    await this.refresh();
+    return this.data.regressions ?? [];
+  }
+  /** The release-gate deliverable (PDF). */
+  async verificationReport(opts = {}) {
+    return this.report(opts);
+  }
+  /** Overall stats plus the grid and per-stage/per-instruction breakdowns. */
+  async result() {
+    await this.refresh();
+    this.raiseIfStopped();
+    return {
+      ...this.data.result ?? {},
+      heatmap: await this.heatmap(),
+      cells: this.cells
+    };
+  }
+};
+function makeRunHandle(transport, data) {
+  switch (data.kind) {
+    case "eval":
+      return new EvalRunHandle(transport, data);
+    case "compare":
+      return new CompareRunHandle(transport, data);
+    case "verify":
+      return new VerifyRunHandle(transport, data);
+    case "threshold":
+      return new ThresholdContractHandle(transport, data);
+    case "transfer":
+      return new TransferRunHandle(transport, data);
+    case "matrix":
+      return new MatrixRunHandle(transport, data);
+    default:
+      return new RunHandle(transport, data);
+  }
+}
+var TaskHandle = class {
+  constructor(transport, data) {
+    this.transport = transport;
+    this.data = data;
+  }
+  get id() {
+    return this.data.id;
+  }
+  get name() {
+    return this.data.name;
+  }
+  get status() {
+    return this.data.status;
+  }
+  /** Frozen revision id (`espresso@v1`); null until frozen. */
+  get rev() {
+    return this.data.rev;
+  }
+  get visibility() {
+    return this.data.visibility;
+  }
+  get raw() {
+    return this.data;
+  }
+  /** Run the calibration session; the returned `stream_url` is live. */
+  async pilot(opts) {
+    const pilot = await this.transport.request("POST", `/v1/tasks/${this.id}/pilot`, {
+      body: { robot: opts.robot, episodes: opts.episodes ?? 25 }
+    });
+    this.data.status = "piloting";
+    return pilot;
+  }
+  /** Iterate on the method while piloting. Omitted fields are unchanged. */
+  async amend(fields) {
+    this.data = await this.transport.request("POST", `/v1/tasks/${this.id}/amend`, {
+      body: cleanBody(fields)
+    });
+    return this;
+  }
+  /** Freeze to an immutable, co-signed revision (`name@vN`). */
+  async freeze() {
+    this.data = await this.transport.request("POST", `/v1/tasks/${this.id}/freeze`, {
+      body: {}
+    });
+    return this;
+  }
+};
+var KitHandle = class {
+  constructor(transport, data) {
+    this.transport = transport;
+    this.data = data;
+  }
+  get id() {
+    return this.data.id;
+  }
+  get name() {
+    return this.data.name;
+  }
+  /** `registered → received → tracked → available` (as `kit/<name>`). */
+  get status() {
+    return this.data.status;
+  }
+  get environment_ref() {
+    return this.data.environment_ref;
+  }
+  get raw() {
+    return this.data;
+  }
+  /** The inbound shipping label to the facility (URL). */
+  async shippingLabel() {
+    const payload = await this.transport.request(
+      "GET",
+      `/v1/kits/${this.id}/shipping-label`
+    );
+    return payload.url ?? "";
+  }
+};
+var Roborama = class {
+  constructor(options = {}) {
+    const transport = new Transport(options);
+    this.transport = transport;
+    this.runs = {
+      create: (async (params) => {
+        const body = cleanBody(params);
+        body.kind = body.kind ?? "run";
+        const data = await transport.request("POST", "/v1/runs", { body });
+        return makeRunHandle(transport, data);
+      }),
+      get: async (runId) => {
+        const data = await transport.request("GET", `/v1/runs/${runId}`);
+        return makeRunHandle(transport, data);
+      },
+      list: async (params = {}) => {
+        const payload = await transport.request("GET", "/v1/runs", { params });
+        return (payload.data ?? []).map(
+          (r) => makeRunHandle(transport, r)
+        );
+      }
+    };
+    this.verifications = {
+      create: (params) => this.runs.create({ ...params, kind: "verify" })
+    };
+    this.matrices = {
+      create: (params) => this.runs.create({ ...params, kind: "matrix" })
+    };
+    this.robots = {
+      list: async () => (await transport.request("GET", "/v1/robots")).data ?? []
+    };
+    this.environments = {
+      list: async (params = {}) => (await transport.request("GET", "/v1/environments", { params })).data ?? []
+    };
+    this.suites = {
+      list: async () => (await transport.request("GET", "/v1/suites")).data ?? []
+    };
+    this.gates = {
+      create: (params) => transport.request("POST", "/v1/gates", { body: cleanBody(params) })
+    };
+    this.streams = {
+      get: (cell) => transport.request("GET", `/v1/streams/${cell}`)
+    };
+    this.keys = {
+      create: (params) => transport.request("POST", "/v1/keys", { body: { scope: params.scope } }),
+      list: async () => (await transport.request("GET", "/v1/keys")).data ?? []
+    };
+    this.budgets = {
+      set: (params) => transport.request("PUT", "/v1/budgets", {
+        body: { monthly_usd: params.monthly_usd, hard: params.hard ?? false }
+      })
+    };
+    this.data = {
+      purge: (runId) => transport.request("DELETE", `/v1/data/${runId}`)
+    };
+    this.calibration = {
+      export: (params) => transport.request("POST", "/v1/calibration/exports", {
+        body: cleanBody(params)
+      })
+    };
+    this.tasks = {
+      create: async (params) => {
+        const data = await transport.request("POST", "/v1/tasks", {
+          body: cleanBody(params)
+        });
+        return new TaskHandle(transport, data);
+      },
+      get: async (taskId) => {
+        const data = await transport.request("GET", `/v1/tasks/${taskId}`);
+        return new TaskHandle(transport, data);
+      },
+      list: async () => {
+        const payload = await transport.request("GET", "/v1/tasks");
+        return (payload.data ?? []).map((t) => new TaskHandle(transport, t));
+      }
+    };
+    this.kits = {
+      register: async (params) => {
+        const data = await transport.request("POST", "/v1/kits", {
+          body: cleanBody(params)
+        });
+        return new KitHandle(transport, data);
+      },
+      get: async (kitId) => {
+        const data = await transport.request("GET", `/v1/kits/${kitId}`);
+        return new KitHandle(transport, data);
+      }
+    };
+    this.scenarios = {
+      fromFile: async (path) => {
+        const { readFile } = await import("fs/promises");
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        return Array.isArray(parsed) ? { scenarios: parsed } : parsed;
+      }
+    };
+  }
+  /** Whether this client is in mock mode. */
+  get mock() {
+    return this.transport.mock;
+  }
+  get baseUrl() {
+    return this.transport.baseUrl;
+  }
+  /** Both meters, dollars, and a queue ETA — before you commit. */
+  async quote(params) {
+    return this.transport.request("POST", "/v1/quote", {
+      body: cleanBody(params)
+    });
+  }
+  /** Metered usage for a period (`YYYY-MM`): hours by tier, dollars, budget. */
+  async usage(params = {}) {
+    return this.transport.request("GET", "/v1/usage", {
+      params: { period: params.period }
+    });
+  }
+};
+/** Policy constructors: `Roborama.Policy.checkpoint({...})`, etc. */
+Roborama.Policy = Policy;
+
+// src/index.ts
+var index_default = Roborama;
+export {
+  CompareRunHandle,
+  DEFAULT_BASE_URL,
+  EvalRunHandle,
+  KitHandle,
+  MatrixRunHandle,
+  Policy,
+  Roborama,
+  RoboramaError,
+  RunHandle,
+  TaskHandle,
+  ThresholdContractHandle,
+  TransferRunHandle,
+  VerifyRunHandle,
+  index_default as default,
+  parseAuto,
+  planningN,
+  wilsonCi,
+  zForCi
+};
+//# sourceMappingURL=index.js.map