{"openapi":"3.1.0","info":{"title":"SimForge Cloud API","version":"2026-10-29","description":"The public SimForge API: what `simforge --cloud`, `simforge login` and the Python client call. Authenticate with a bearer token: the access token `simforge login` stores, an AI agent's access token (its recipe is `/auth.md`), or an `sfk_` API key. A `/api/v1` 401 carries `WWW-Authenticate: Bearer resource_metadata=\"<host>/.well-known/oauth-protected-resource\"`. `/api/v1` errors are an `ErrorEnvelope`; `/api/cli` and `/agent` errors are an OAuth error object.\n\nVersions: send `SimForge-Version: <date>` (2026-10-01, 2026-10-21, 2026-10-22, 2026-10-23, 2026-10-24, 2026-10-28, 2026-10-29) and every `/api/v1` response is in that version's shape and names it in the same header; this document describes 2026-10-29. A request without the header gets 2026-10-01, where an error's hint is `detail.hint` and `GET /api/v1/evaluations` names its rows `jobs`. A header that is not a date, or a date before 2026-10-01, is `400 bad_request`. Every response also carries `SimForge-Cli-Minimum`: the oldest `simforge` CLI the server serves.\n\nRetries: from 2026-10-21, send a new `Idempotency-Key` (1-255 characters) with every POST, PUT, PATCH and DELETE, and the same key when retrying that request. The first request's answer is kept for 24 hours and a repeat gets it again with `Idempotent-Replayed: true`; the key with any other request, or while the first is still running, is `409 idempotency_conflict` (`retryable` while running). A 5xx answer is not kept. Creating an API key refuses a key (its secret is shown once).","license":{"name":"Apache-2.0","identifier":"Apache-2.0"}},"components":{"schemas":{"RunEgoResult":{"type":"object","properties":{"egoDynamics":{"type":"object","properties":{"model":{"type":"string","enum":["dynamic-v1","kinematic-bicycle","full-car-v1"],"description":"The resolved selector."},"modelVersion":{"type":"string","description":"Model implementation id, for example `dynamic-v1@1`."},"vehicle":{"type":"string","description":"`pack:<catalog id>` when the ego ran on its dynamics pack, or `class-profile:<kind>` when it ran on a class profile."},"packDigest":{"type":"string","description":"Content hash (sha256, 64 hex) of the pack-derived profile that ran, not of the pack files; absent for a model without a pack."},"provSummary":{"type":"object","properties":{"measured":{"type":"integer","minimum":0},"derived":{"type":"integer","minimum":0},"synthetic":{"type":"integer","minimum":0}},"required":["measured","derived","synthetic"],"description":"Provenance counts of the pack fields; absent without a pack."},"stepPolicy":{"type":"object","properties":{"stepS":{"type":"number","exclusiveMinimum":0,"description":"Fixed integration step in seconds."},"substeps":{"type":"integer","exclusiveMinimum":0,"description":"Integration steps per recorded tick."}},"required":["stepS","substeps"]},"bodyAttitude":{"type":"object","properties":{"model":{"type":"string","description":"The body attitude model id, for example `body-attitude-v1`."},"paramsSource":{"type":"string","description":"`pack:<catalog id>` or `class-default:<class>`."},"paramsDigest":{"type":"string","description":"Content hash of the body attitude parameters that ran."},"peakPitchDeg":{"type":"number","description":"Largest pitch magnitude over the run in degrees (positive is nose down)."},"peakRollDeg":{"type":"number","description":"Largest roll magnitude over the run in degrees (positive is right side down)."},"clampedSteps":{"type":"integer","minimum":0,"description":"Steps on which the limit of the model clamped the attitude."}},"required":["model","paramsSource","paramsDigest","peakPitchDeg","peakRollDeg","clampedSteps"],"description":"The live body attitude of a closed-loop run (Helios `run.json`); derived, observation only. Absent when the run did not step one."}},"required":["model","modelVersion","vehicle","stepPolicy"],"description":"The trace-header record. A producer writes it for an explicit selection, or when the ego ran on a dynamics pack; otherwise a default run has none."},"egoSelection":{"type":"object","properties":{"model":{"type":"string","enum":["dynamic-v1","kinematic-bicycle","full-car-v1"]},"explicit":{"type":"boolean","description":"True when the run named the model; false when it is the run-mode default. The vehicle is separate: see egoVehicle."},"egoVehicle":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":"The ego actor id to catalog id map the run named; null when it named none."},"vehicleProvenance":{"type":"string","description":"Where the vehicle parameters come from: `class-profile`, `legacy-catalog-kind` or `pack`."},"vehicle":{"type":"string","description":"`pack:<catalog id>` when the ego ran on its dynamics pack; absent otherwise."},"packDigest":{"type":"string","description":"Content hash (sha256, 64 hex) of the pack-derived profile that ran, not of the pack files; present with `vehicle`."}},"required":["model","explicit","egoVehicle","vehicleProvenance"],"description":"The run summary echo of the resolved selection; written for default runs too."}}},"ApiKeyId":{"type":"string","pattern":"^key_[0-9A-HJKMNP-TV-Z]{26}$"},"ApiKeyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","scopes","createdBy","createdAt","lastUsedAt","expiresAt","revokedAt"]}}},"required":["data"]},"CreateApiKeyRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"scopes":{"type":"array","items":{"type":"string"},"minItems":1},"expiresInDays":{"type":"integer","exclusiveMinimum":0,"maximum":3650}},"required":["name","scopes"]},"CreateApiKeyResponse":{"type":"object","properties":{"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","scopes","createdBy","createdAt","lastUsedAt","expiresAt","revokedAt"]},"secret":{"type":"string"}},"required":["key","secret"]},"ArtifactDownload":{"type":"object","properties":{"url":{"type":"string","minLength":1},"expiresAt":{"type":"string"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"mediaType":{"type":"string"},"rendition":{"type":"string","enum":["preview","original"]}},"required":["url","expiresAt","sha256","sizeBytes","mediaType"]},"ArtifactId":{"type":"string","pattern":"^art_[0-9A-HJKMNP-TV-Z]{26}$"},"ArtifactList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"mediaType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"sha256":{"type":"string"},"state":{"type":"string","enum":["available"]},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"playback":{"type":"object","properties":{"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"rendition":{"type":"string","enum":["preview","original"]}},"required":["url","expiresAt","rendition"]}},"required":["id","kind","name","mediaType","sizeBytes","sha256","state","createdAt","expiresAt"]}}},"required":["data"]},"RunReplay":{"type":"object","properties":{"runId":{"type":"string"},"scenarioId":{"type":"string"},"revisionId":{"type":"string"},"mapVersionId":{"type":"string"},"egoActorId":{"type":["string","null"]},"timelineSha256":{"type":"string"},"timeline":{"type":"object","properties":{"artifactId":{"type":"string"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string"}},"required":["artifactId","sha256","sizeBytes","url","expiresAt"]},"plan2d":{"type":["object","null"],"properties":{"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","minLength":1}},"required":["sha256","sizeBytes","url"]}},"required":["runId","scenarioId","revisionId","mapVersionId","egoActorId","timelineSha256","timeline","plan2d"]},"Artifact":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"mediaType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"sha256":{"type":"string"},"state":{"type":"string","enum":["available"]},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"playback":{"type":"object","properties":{"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"rendition":{"type":"string","enum":["preview","original"]}},"required":["url","expiresAt","rendition"]}},"required":["id","kind","name","mediaType","sizeBytes","sha256","state","createdAt","expiresAt"]},"CloudId":{"type":"string","pattern":"^(?:run_|job_|art_|key_|req_)[0-9A-HJKMNP-TV-Z]{26}$"},"CloudScope":{"type":"string","enum":["maps:read","scenarios:read","scenarios:write","datasets:read","runs:read","runs:write","sessions:write","artifacts:read","usage:read","models:read","models:write","keys:admin","runtime:read"]},"DryRunResponse":{"type":"object","properties":{"dryRun":{"type":"boolean","enum":[true]},"type":{"type":"string"},"input":{},"requestSha256":{"type":"string"},"jobs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"kind":{"type":"string"},"input":{},"dependsOn":{"type":"array","items":{"type":"string"}},"maxAttempts":{"type":"integer","exclusiveMinimum":0}},"required":["key","kind","dependsOn"]}},"estimate":{"type":"object","properties":{"jobs":{"type":"integer","minimum":0},"seconds":{"type":"number","minimum":0}},"required":["jobs","seconds"]},"costEstimateCents":{"type":"integer","minimum":0},"costBreakdown":{"type":"array","items":{"type":"object","properties":{"jobKey":{"type":"string"},"kind":{"type":"string"},"cents":{"type":"integer","minimum":0}},"required":["jobKey","kind","cents"]}},"maxCost":{"type":["object","null"],"properties":{"limitCents":{"type":"integer","minimum":0},"exceeded":{"type":"boolean"}},"required":["limitCents","exceeded"],"description":"The request's maxCostCents and whether the estimate exceeds it (the same request without dryRun would be refused budget_exceeded); null when no maxCostCents was sent. A dry run over the cap is still priced, never refused."},"allowed":{"type":"boolean","description":"Whether the same request without dryRun would be admitted now."},"refusal":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"],"description":"Why it would be refused now, with the code and detail that submission would answer: evaluation_admissions_paused (evaluations are paused; the price still stands), budget_exceeded, insufficient_credits, rate_limited, or cloud_not_open when no worker serves its work right now (detail.code run_kind_unavailable, model_unavailable, render_preset_unavailable, or provider_boot_failed while the model's host is in boot cooldown, detail.retryAfter naming when it ends). Null when allowed."},"notes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]},"description":"What the run would do differently while still doing its work, in the words its run warnings will use (an open-loop evaluation of a render whose frames are off the model's 10 Hz clock: render_frame_rate_differs). Empty when nothing."},"model":{"$ref":"#/components/schemas/ModelIdentity"},"modelParams":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The model's parameters it would run with, by name, defaults filled in (the request's input.params, else each one's default); absent with model."},"customParams":{"type":"boolean","description":"True when a parameter whose comparability is custom is off its default: compare the run only with runs of the same params."},"cancellation":{"type":"object","properties":{"queuedCostCents":{"type":"number","enum":[0]},"failedRunCostCents":{"type":"number","enum":[0]},"partialCharge":{"type":"string","enum":["succeeded_jobs_only"]},"wholeRunPriceRequiresSuccess":{"type":"boolean"}},"required":["queuedCostCents","failedRunCostCents","partialCharge","wholeRunPriceRequiresSuccess"]}},"required":["dryRun","type","requestSha256","jobs","estimate","costEstimateCents","costBreakdown","maxCost","allowed","refusal","notes","cancellation"]},"ModelIdentity":{"type":"object","properties":{"modelVersionId":{"type":"string","description":"The model version: an offered model's id (`GET /api/v1/evaluation-options`) or one of this workspace's own."},"name":{"type":"string","description":"Its name, as `GET /api/v1/evaluation-options` lists an offered model."},"family":{"type":"string","description":"Its model family (architecture and upstream weights)."},"revision":{"type":"string","description":"The upstream weights revision (40 hex) its family pins."},"quant":{"type":"string","description":"Its quantization."},"checkpointDigest":{"type":"string","description":"The sha256 of the checkpoint it runs; a model job runs only beside a model host serving exactly this checkpoint."},"aliasOf":{"type":["string","null"],"description":"The offered model this workspace's own version copies (the same family, quantization and checkpoint); null for an offered model and any other version."},"owner":{"type":"string","description":"Whose model it is: `simforge` (a model SimForge offers) or `workspace` (this workspace's own version, an alias of an offered model included). An open string: a reader keeps a value it does not know."}},"required":["modelVersionId","name","family","revision","quant","checkpointDigest","aliasOf","owner"]},"ErrorCode":{"type":"string","enum":["bad_request","validation_failed","unauthorized","insufficient_scope","workspace_required","not_found","conflict","gone","idempotency_conflict","lease_lost","budget_exceeded","max_cost_required","idempotency_key_required","insufficient_credits","checkout_closed","cloud_not_open","email_unverified","terms_acceptance_required","evaluation_launch_disabled","evaluation_admissions_paused","fine_tunes_not_enabled","model_name_reserved","model_name_invalid","model_name_taken","model_quota_exceeded","checkpoint_too_large","checkpoint_format_unsupported","model_family_not_fine_tunable","checkpoint_file_unexpected","checkpoint_is_offered_model","model_version_exists","param_unknown","param_invalid","param_override_not_allowed","upload_incomplete","upload_mismatch","recording_too_large","model_in_use","rate_limited","prompt_out_of_scope","relevance_check_unavailable","oracle_capacity_paused","cost_cap_exceeded","internal_error"]},"ErrorDetail":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","validation_failed","unauthorized","insufficient_scope","workspace_required","not_found","conflict","gone","idempotency_conflict","lease_lost","budget_exceeded","max_cost_required","idempotency_key_required","insufficient_credits","checkout_closed","cloud_not_open","email_unverified","terms_acceptance_required","evaluation_launch_disabled","evaluation_admissions_paused","fine_tunes_not_enabled","model_name_reserved","model_name_invalid","model_name_taken","model_quota_exceeded","checkpoint_too_large","checkpoint_format_unsupported","model_family_not_fine_tunable","checkpoint_file_unexpected","checkpoint_is_offered_model","model_version_exists","param_unknown","param_invalid","param_override_not_allowed","upload_incomplete","upload_mismatch","recording_too_large","model_in_use","rate_limited","prompt_out_of_scope","relevance_check_unavailable","oracle_capacity_paused","cost_cap_exceeded","internal_error"]},"reason":{"type":"string"},"hint":{"type":"string"},"param":{"type":"string"},"retryable":{"type":"boolean"},"detail":{},"path":{"type":"string"},"requestId":{"type":"string","pattern":"^req_[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["code","reason","retryable","requestId"]},"ErrorEnvelope":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request","validation_failed","unauthorized","insufficient_scope","workspace_required","not_found","conflict","gone","idempotency_conflict","lease_lost","budget_exceeded","max_cost_required","idempotency_key_required","insufficient_credits","checkout_closed","cloud_not_open","email_unverified","terms_acceptance_required","evaluation_launch_disabled","evaluation_admissions_paused","fine_tunes_not_enabled","model_name_reserved","model_name_invalid","model_name_taken","model_quota_exceeded","checkpoint_too_large","checkpoint_format_unsupported","model_family_not_fine_tunable","checkpoint_file_unexpected","checkpoint_is_offered_model","model_version_exists","param_unknown","param_invalid","param_override_not_allowed","upload_incomplete","upload_mismatch","recording_too_large","model_in_use","rate_limited","prompt_out_of_scope","relevance_check_unavailable","oracle_capacity_paused","cost_cap_exceeded","internal_error"]},"reason":{"type":"string"},"hint":{"type":"string"},"param":{"type":"string"},"retryable":{"type":"boolean"},"detail":{},"path":{"type":"string"},"requestId":{"type":"string","pattern":"^req_[0-9A-HJKMNP-TV-Z]{26}$"}},"required":["code","reason","retryable","requestId"]}},"required":["error"]},"HealthResponse":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]}},"required":["status"]},"StatusResponse":{"type":"object","properties":{"updatedAt":{"type":"string"},"components":{"type":"array","items":{"$ref":"#/components/schemas/StatusComponent"}},"workers":{"type":"array","items":{"$ref":"#/components/schemas/StatusWorkers"}},"queues":{"type":"array","items":{"$ref":"#/components/schemas/StatusQueue"}},"incidents":{"type":"array","items":{"$ref":"#/components/schemas/StatusIncident"}}},"required":["updatedAt","components","workers","queues","incidents"]},"StatusComponent":{"type":"object","properties":{"id":{"type":"string","enum":["database","storage","email","auth","cli-downloads"]},"label":{"type":"string"},"state":{"type":"string","enum":["up","degraded","down","unchecked"]},"note":{"type":"string"}},"required":["id","label","state"]},"StatusWorkers":{"type":"object","properties":{"class":{"type":"string","enum":["cpu","gpu"]},"env":{"type":"string","enum":["dev","prod","local"]},"pool":{"type":"string","enum":["cloud","render"]},"online":{"type":"integer","minimum":0},"busy":{"type":"integer","minimum":0},"incompleteMaps":{"type":"integer","minimum":0}},"required":["class","env","pool","online","busy"]},"StatusQueue":{"type":"object","properties":{"source":{"type":"string","enum":["cloud","simulation","render"]},"kind":{"type":"string"},"queued":{"type":"integer","minimum":0},"oldestWaitSeconds":{"type":"integer","minimum":0},"onlineThatFit":{"type":"integer","minimum":0},"etaSeconds":{"type":"integer","minimum":0}},"required":["source","kind","queued","oldestWaitSeconds"]},"StatusIncident":{"type":"object","properties":{"title":{"type":"string"},"since":{"type":"string"},"state":{"type":"string","enum":["investigating","identified","monitoring","resolved"]}},"required":["title","since","state"]},"JobId":{"type":"string","pattern":"^job_[0-9A-HJKMNP-TV-Z]{26}$"},"MeResponse":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":["string","null"]},"name":{"type":["string","null"]}},"required":["id","email","name"]},"workspace":{"type":["object","null"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}},"required":["id","name","role"]},"principal":{"type":"object","properties":{"kind":{"type":"string","enum":["session","cli","api_key"]},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","scopes"]}},"required":["user","workspace","principal"]},"Principal":{"type":"object","properties":{"kind":{"type":"string","enum":["session","cli","api_key"]},"userId":{"type":"string","minLength":1},"workspaceId":{"type":["string","null"],"minLength":1},"scopes":{"type":"array","items":{"type":"string","enum":["maps:read","scenarios:read","scenarios:write","datasets:read","runs:read","runs:write","sessions:write","artifacts:read","usage:read","models:read","models:write","keys:admin","runtime:read"]}},"credentialId":{"type":"string","minLength":1}},"required":["kind","userId","workspaceId","scopes","credentialId"]},"RequestId":{"type":"string","pattern":"^req_[0-9A-HJKMNP-TV-Z]{26}$"},"PublicApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","scopes","createdBy","createdAt","lastUsedAt","expiresAt","revokedAt"]},"WorkspacesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}},"required":["id","name","role"]}}},"required":["data"]},"RunCreateRequest":{"type":"object","properties":{"type":{"type":"string","minLength":1},"input":{"description":"The run type's input. For `type: \"render\"` it is a RenderRunInput; the other run types' inputs are objects of their own.","anyOf":[{"$ref":"#/components/schemas/RenderRunInput"},{"type":"object","additionalProperties":true}]},"dryRun":{"type":"boolean"},"maxCostCents":{"type":"integer","minimum":0,"description":"Required for non-dry submissions with a positive cost estimate; the maximum approved price in cents."}},"required":["type"],"examples":[{"type":"render","input":{"scenarioId":"<scenario-id>","engine":"3d","preset":"showcase","rig":{"schema":"simforge.render-rig/v1","sources":[{"actorId":"ego","sensorId":"cam-front","outputName":"cam-front","transform":{"position":{"x":1.6,"y":1.45,"z":0},"rotation":{"yawRad":0,"pitchRad":-0.0524,"rollRad":0}},"modality":"rgb","attributes":{"width":1280,"height":720,"fps":20,"horizontalFovDeg":90,"nearM":0.05,"farM":1000}}]}},"maxCostCents":100}]},"EvaluationChoices":{"type":"object","properties":{"models":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"available":{"type":"boolean"},"reason":{"type":["string","null"]},"pricePerScenarioCents":{"type":["integer","null"],"minimum":0},"loops":{"type":"object","properties":{"closedLoop":{"$ref":"#/components/schemas/LoopOffer"},"openLoop":{"$ref":"#/components/schemas/LoopOffer"}},"required":["closedLoop","openLoop"],"description":"Its offer in each loop; null: not offered in that loop. The top-level available, reason and pricePerScenarioCents are closedLoop's."},"params":{"type":"array","items":{"$ref":"#/components/schemas/ModelParam"},"description":"The parameters it takes, each in its `loops`; evaluation requests do not take them yet."}},"required":["id","name","family","available","reason","pricePerScenarioCents"]}},"admissionsPaused":{"type":"boolean"},"pricePerScenarioCents":{"type":"integer","minimum":0},"balanceCents":{"type":"integer"},"billingExempt":{"type":"boolean"},"creditsUrl":{"type":"string"},"datasets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"scenarioCount":{"type":"integer","minimum":0},"filling":{"type":["object","null"],"properties":{"total":{"type":"integer","minimum":0}},"required":["total"],"description":"Sample scenarios still being copied in: the dataset will hold `total` scenarios once they are all in; null otherwise."}},"required":["id","name","scenarioCount","filling"]}},"scenarios":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["models","admissionsPaused","pricePerScenarioCents","balanceCents","billingExempt","creditsUrl","datasets"]},"LoopOffer":{"type":["object","null"],"properties":{"available":{"type":"boolean","description":"Whether an evaluation in this loop can be launched now: offered here and served by a worker."},"reason":{"type":["string","null"],"description":"Why not, when it is not available (Coming soon, Temporarily unavailable, or Unavailable: the model host could not start, with the UTC time to try again); null when it is."},"pricePerScenarioCents":{"type":["integer","null"],"minimum":0,"description":"One scenario in this loop, in cents; null while it has no price."}},"required":["available","reason","pricePerScenarioCents"]},"ModelParam":{"type":"object","properties":{"name":{"type":"string","description":"The parameter's name."},"type":{"type":"string","description":"integer, number, string or enum."},"min":{"type":"number"},"max":{"type":"number"},"step":{"type":"number"},"maxLength":{"type":"integer","description":"A string's longest length."},"values":{"type":"array","items":{"type":"string"},"description":"An enum's values."},"default":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"description":"The value used when none is sent; null: none (the model's own behaviour)."},"loopDefaults":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The value used in a loop (closedLoop, openLoop) where it differs from default."},"fixed":{"anyOf":[{"type":"number"},{"type":"string"}],"description":"The one value this model runs with: shown, never changed."},"loops":{"type":"array","items":{"type":"string"},"description":"The loops it applies to: closedLoop, openLoop."},"advanced":{"type":"boolean","description":"Whether a form shows it under Advanced."},"comparability":{"type":"string","description":"standard, or custom: a run with another value than the default is compared only with runs of the same values."},"label":{"type":"string"},"hint":{"type":"string"}},"required":["name","type","default","loops","advanced","comparability"]},"RunEvent":{"type":"object","properties":{"runId":{"type":"string"},"seq":{"type":"integer","exclusiveMinimum":0},"type":{"type":"string"},"data":{},"createdAt":{"type":"string","format":"date-time"}},"required":["runId","seq","type","createdAt"]},"RunEventsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"seq":{"type":"integer","exclusiveMinimum":0},"type":{"type":"string"},"data":{},"createdAt":{"type":"string","format":"date-time"}},"required":["runId","seq","type","createdAt"]}},"nextAfter":{"type":"integer","minimum":0}},"required":["data","nextAfter"]},"SessionToken":{"type":"object","properties":{"token":{"type":"string","minLength":1},"expiresAt":{"type":"string"},"runId":{"type":"string"},"endpoint":{"type":"object","properties":{"transport":{"type":"string","enum":["tunnel"]},"address":{"type":"string","minLength":1,"maxLength":512}},"required":["transport","address"],"additionalProperties":false}},"required":["token","expiresAt","runId","endpoint"]},"RunSummary":{"type":"object","properties":{"id":{"type":"string"},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied run identity; qualification namespaces are excluded from evaluation suites."},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"input":{},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"createdBy":{"type":["object","null"],"properties":{"id":{"type":"string","minLength":1},"email":{"type":["string","null"]}},"required":["id","email"]},"published":{"type":"boolean","description":"A run published from another workspace (read-only here): a public benchmark. False for a master render of one of your Sample scenarios. Absent means false (a server older than this field)."},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"jobCount":{"type":"integer","minimum":0},"warningCount":{"type":"integer","minimum":0},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","leased","running","succeeded","failed","cancelled","skipped"]},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]}},"required":["id","kind","status","errorCode","errorReason"]}},"headline":{"description":"What a list shows of the run's result, without what its artifacts add: a closed-loop run's model and episode metrics without the per-step `events` (a batch: each scenario's row without its video); a transfer's `scenarioId`, the scenario its result names (the variation it created; an in-place transfer: the scenario it moved), null until it is finalized and when it placed nothing. Null for a type without one."},"unavailable":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"description":"Present when the run's headline could not be read: `headline` is null, while every other field still holds."}},"required":["id","type","status","createdAt","startedAt","finishedAt","createdBy","costEstimateCents","costCents","jobCount","warningCount","jobs"]},"RunPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied run identity; qualification namespaces are excluded from evaluation suites."},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"input":{},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"createdBy":{"type":["object","null"],"properties":{"id":{"type":"string","minLength":1},"email":{"type":["string","null"]}},"required":["id","email"]},"published":{"type":"boolean","description":"A run published from another workspace (read-only here): a public benchmark. False for a master render of one of your Sample scenarios. Absent means false (a server older than this field)."},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"jobCount":{"type":"integer","minimum":0},"warningCount":{"type":"integer","minimum":0},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","leased","running","succeeded","failed","cancelled","skipped"]},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]}},"required":["id","kind","status","errorCode","errorReason"]}},"headline":{"description":"What a list shows of the run's result, without what its artifacts add: a closed-loop run's model and episode metrics without the per-step `events` (a batch: each scenario's row without its video); a transfer's `scenarioId`, the scenario its result names (the variation it created; an in-place transfer: the scenario it moved), null until it is finalized and when it placed nothing. Null for a type without one."},"unavailable":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"description":"Present when the run's headline could not be read: `headline` is null, while every other field still holds."}},"required":["id","type","status","createdAt","startedAt","finishedAt","createdBy","costEstimateCents","costCents","jobCount","warningCount","jobs"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"RunFullPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied run identity; qualification namespaces are excluded from evaluation suites."},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"input":{},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"createdBy":{"type":["object","null"],"properties":{"id":{"type":"string","minLength":1},"email":{"type":["string","null"]}},"required":["id","email"]},"published":{"type":"boolean","description":"A run published from another workspace (read-only here): a public benchmark. False for a master render of one of your Sample scenarios. Absent means false (a server older than this field)."},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"billing":{"type":"object","properties":{"hold":{"type":["string","null"],"enum":["pending","released",null]},"heldCents":{"type":"integer","minimum":0},"chargedCents":{"type":"integer","minimum":0}},"required":["hold","heldCents","chargedCents"]},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","leased","running","succeeded","failed","cancelled","skipped"]},"attempt":{"type":"integer","minimum":0},"maxAttempts":{"type":"integer","exclusiveMinimum":0},"leaseExpiresAt":{"type":["string","null"],"format":"date-time"},"workerClass":{"type":["string","null"],"enum":["cpu","gpu",null]},"queue":{"type":["object","null"],"properties":{"blockedBy":{"type":"array","items":{"type":"string"}},"ahead":{"type":["integer","null"],"minimum":0},"etaSeconds":{"type":["integer","null"],"minimum":0},"waitingFor":{"type":["string","null"],"enum":["worker","gpu","map",null]}},"required":["blockedBy","ahead","etaSeconds","waitingFor"]},"progress":{},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","kind","status","attempt","maxAttempts","leaseExpiresAt","workerClass","queue","errorCode","errorReason","startedAt","finishedAt"]}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}},"jobId":{"type":"string"}},"required":["code","message"]}},"result":{"description":"The run's result; its shape depends on the run type. A run that moves an ego may carry `egoDynamics` and `egoSelection` (RunEgoResult)."},"unavailable":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"description":"Present when this run's artifacts and result could not be read: `result` is null and its artifacts are left out, while every other field still holds. The rest of a page is unaffected."}},"required":["id","type","status","createdAt","startedAt","finishedAt","createdBy","costEstimateCents","costCents","billing","jobs","warnings"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"Run":{"type":"object","properties":{"id":{"type":"string"},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied run identity; qualification namespaces are excluded from evaluation suites."},"type":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"input":{},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"createdBy":{"type":["object","null"],"properties":{"id":{"type":"string","minLength":1},"email":{"type":["string","null"]}},"required":["id","email"]},"published":{"type":"boolean","description":"A run published from another workspace (read-only here): a public benchmark. False for a master render of one of your Sample scenarios. Absent means false (a server older than this field)."},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"billing":{"type":"object","properties":{"hold":{"type":["string","null"],"enum":["pending","released",null]},"heldCents":{"type":"integer","minimum":0},"chargedCents":{"type":"integer","minimum":0}},"required":["hold","heldCents","chargedCents"]},"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string","enum":["queued","leased","running","succeeded","failed","cancelled","skipped"]},"attempt":{"type":"integer","minimum":0},"maxAttempts":{"type":"integer","exclusiveMinimum":0},"leaseExpiresAt":{"type":["string","null"],"format":"date-time"},"workerClass":{"type":["string","null"],"enum":["cpu","gpu",null]},"queue":{"type":["object","null"],"properties":{"blockedBy":{"type":"array","items":{"type":"string"}},"ahead":{"type":["integer","null"],"minimum":0},"etaSeconds":{"type":["integer","null"],"minimum":0},"waitingFor":{"type":["string","null"],"enum":["worker","gpu","map",null]}},"required":["blockedBy","ahead","etaSeconds","waitingFor"]},"progress":{},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]},"startedAt":{"type":["string","null"],"format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","kind","status","attempt","maxAttempts","leaseExpiresAt","workerClass","queue","errorCode","errorReason","startedAt","finishedAt"]}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}},"jobId":{"type":"string"}},"required":["code","message"]}},"result":{"description":"The run's result; its shape depends on the run type. A run that moves an ego may carry `egoDynamics` and `egoSelection` (RunEgoResult)."},"unavailable":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"description":"Present when this run's artifacts and result could not be read: `result` is null and its artifacts are left out, while every other field still holds. The rest of a page is unaffected."}},"required":["id","type","status","createdAt","startedAt","finishedAt","createdBy","costEstimateCents","costCents","billing","jobs","warnings"]},"DatasetFilesRequest":{"type":"object","properties":{"q":{"type":"string","description":"Free-text search, as in the library's search box."},"filter":{"type":"string","description":"Library filters: space-separated `facet:value[,value]` tokens, e.g. `grade:A tag:cut-in`."},"sourceLog":{"type":"string","description":"Only the scenarios of one recorded drive (its recording digest or source id)."},"ids":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Exactly these scenarios (document ids); not with q, filter or sourceLog."},"include":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"`renders[:training|showcase|schematic]`, `labels`, `gt`, `recordings`, `generated` (Factory clips), or `scenarios` for none of them; default `renders:training`."},"passes":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Keep only these render modalities: rgb, depth, semantic, instance, lidar, radar."},"cursor":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Files per page (whole scenarios, at least one); default 1000."},"format":{"type":"string","enum":["json","urls"],"description":"`urls`: the whole selection as an aria2c input file of 24-hour links (text/plain)."},"dryRun":{"type":"boolean","description":"Counts and size of the whole selection; no links, nothing prepared."}}},"DatasetFilesPage":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.dataset-files/v1"]},"dataset":{"$ref":"#/components/schemas/DatasetFilesDataset"},"selection":{"$ref":"#/components/schemas/DatasetFilesSelection"},"include":{"$ref":"#/components/schemas/DatasetFilesInclude"},"scenarios":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesScenario"},"description":"This page's scenarios.jsonl rows, by document id."},"files":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFile"},"description":"Every file of this page's scenarios, and the recordings they bring."},"excluded":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesExclusion"}},"nextCursor":{"type":["string","null"]}},"required":["schema","dataset","selection","include","scenarios","files","excluded","nextCursor"]},"DatasetFilesDataset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"DatasetFilesSelection":{"oneOf":[{"$ref":"#/components/schemas/DatasetFilesWholeDataset"},{"$ref":"#/components/schemas/DatasetFilesFiltered"},{"$ref":"#/components/schemas/DatasetFilesDocuments"}],"discriminator":{"propertyName":"kind","mapping":{"dataset":"#/components/schemas/DatasetFilesWholeDataset","query":"#/components/schemas/DatasetFilesFiltered","documents":"#/components/schemas/DatasetFilesDocuments"}}},"DatasetFilesWholeDataset":{"type":"object","properties":{"kind":{"type":"string","enum":["dataset"]}},"required":["kind"]},"DatasetFilesFiltered":{"type":"object","properties":{"kind":{"type":"string","enum":["query"]},"query":{"$ref":"#/components/schemas/DatasetFilesQuery"}},"required":["kind","query"]},"DatasetFilesQuery":{"type":"object","properties":{"q":{"type":"string"},"filters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"sourceLogId":{"type":["string","null"]}},"required":["q","filters","sourceLogId"]},"DatasetFilesDocuments":{"type":"object","properties":{"kind":{"type":"string","enum":["documents"]},"documentIds":{"type":"array","items":{"type":"string"}}},"required":["kind","documentIds"]},"DatasetFilesInclude":{"type":"object","properties":{"renders":{"$ref":"#/components/schemas/DatasetFilesRenders"},"labels":{"type":"boolean"},"groundTruth":{"type":"boolean"},"recordings":{"type":"boolean"},"generated":{"type":"boolean","description":"The scenarios' accepted and flagged SimForge Factory clips, under `generated/<look>-<seed>/`."}},"required":["renders","labels","groundTruth","recordings","generated"]},"DatasetFilesRenders":{"type":"object","properties":{"presets":{"type":"array","items":{"type":"string","enum":["training","showcase","schematic"]}},"modalities":{"type":["array","null"],"items":{"type":"string","enum":["rgb","depth","semantic","instance","lidar","radar"]}}},"required":["presets","modalities"]},"DatasetFilesScenario":{"type":"object","properties":{"id":{"type":"string"},"revisionId":{"type":"string"},"title":{"type":"string"},"dir":{"type":"string"},"map":{"$ref":"#/components/schemas/DatasetFilesMap"},"grade":{"type":["object","null"],"properties":{"tier":{"type":"string"},"basis":{"type":["string","null"]}},"required":["tier","basis"]},"tags":{"type":"array","items":{"type":"string"}},"split":{"type":"string"},"lineage":{"$ref":"#/components/schemas/DatasetFilesLineage"},"licence":{"type":["string","null"]},"simulation":{"type":"object","properties":{"simKey":{"type":"string"},"engineSemVer":{"type":"string"},"resolvedInputDigest":{"type":"string"}},"required":["simKey","engineSemVer","resolvedInputDigest"]},"recording":{"type":["string","null"],"description":"The source drive, when `recordings` is included."},"recordings":{"type":"array","items":{"type":"string"},"description":"The recordings the document pins (always pulled: the document replays them)."},"renders":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesRender"}},"generated":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesGenerated"},"description":"Its Factory clips, when `generated` is included."},"members":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesMember"}}},"required":["id","revisionId","title","dir","map","grade","tags","split","lineage","licence","simulation","recording","recordings","renders","generated","members"]},"DatasetFilesMap":{"type":"object","properties":{"versionId":{"type":"string"},"name":{"type":["string","null"]},"sourceMapId":{"type":["string","null"]},"xodrSha256":{"type":["string","null"]}},"required":["versionId","name","sourceMapId","xodrSha256"]},"DatasetFilesLineage":{"type":"object","properties":{"derivationKind":{"type":["string","null"]},"parentId":{"type":["string","null"]},"sourceRecordingSha256":{"type":["string","null"]},"source":{"type":["object","null"],"properties":{"dataset":{"type":["string","null"]},"logId":{"type":["string","null"]},"label":{"type":["string","null"]}},"required":["dataset","logId","label"]}},"required":["derivationKind","parentId","sourceRecordingSha256","source"]},"DatasetFilesRender":{"type":"object","properties":{"id":{"type":"string"},"preset":{"type":"string","enum":["training","showcase","schematic"]},"engine":{"type":"string"},"source":{"type":"string","enum":["studio","cloud"]},"dir":{"type":"string"},"files":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesRenderFile"}}},"required":["id","preset","engine","source","dir","files"]},"DatasetFilesRenderFile":{"type":"object","properties":{"path":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size":{"type":"integer","minimum":0},"role":{"type":"string"},"mediaType":{"type":"string"},"sensorId":{"type":["string","null"]},"actorId":{"type":["string","null"]},"modality":{"type":["string","null"]}},"required":["path","sha256","size","role","mediaType","sensorId","actorId","modality"]},"DatasetFilesGenerated":{"type":"object","properties":{"dir":{"type":"string","description":"`<scenario dir>/generated/<look>-<seed>`."},"runId":{"type":"string","description":"The Factory run that made it; when two runs made the same folder, the newest."},"lookId":{"type":"string"},"seed":{"type":"integer","minimum":0},"verdict":{"type":"string","enum":["accepted","flagged"],"description":"The clip check's verdict. A rejected clip is delivered with its run, never in a pull."},"files":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesGeneratedFile"},"description":"Every file of the clip, `manifest.json` and `quality.json` among them."}},"required":["dir","runId","lookId","seed","verdict","files"]},"DatasetFilesGeneratedFile":{"type":"object","properties":{"path":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"size":{"type":"integer","minimum":0},"mediaType":{"type":"string"}},"required":["path","sha256","size","mediaType"]},"DatasetFilesMember":{"type":"object","properties":{"path":{"type":"string"},"role":{"type":"string","enum":["document","openscenario","trace","resolution","labels","gt-ego","gt-actors"]},"sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"size":{"type":["integer","null"],"minimum":0}},"required":["path","role","sha256","size"]},"DatasetFile":{"type":"object","properties":{"path":{"type":"string","description":"Where the file goes in the pulled folder (relative, `/`-separated)."},"role":{"type":"string","enum":["document","openscenario","trace","resolution","labels","gt-ego","gt-actors","recording","render","generated"]},"mediaType":{"type":"string"},"state":{"type":"string","enum":["ready","pending"],"description":"`pending`: still being prepared (no digest, size or URL yet); ask for the same page again."},"sha256":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"size":{"type":["integer","null"],"minimum":0},"url":{"type":["string","null"],"description":"A signed GET of the stored object; it supports HTTP range requests. Ask for the page again for a fresh one."},"urlExpiresAt":{"type":["string","null"]},"documentId":{"type":["string","null"],"description":"The scenario it belongs to; null for a recording several scenarios share."}},"required":["path","role","mediaType","state","sha256","size","url","urlExpiresAt","documentId"]},"DatasetFilesExclusion":{"type":"object","properties":{"documentId":{"type":"string"},"title":{"type":"string"},"code":{"type":"string"},"reason":{"type":"string"},"path":{"type":["string","null"],"description":"The file that cannot be produced; null when the whole scenario is left out."}},"required":["documentId","title","code","reason","path"]},"DatasetFilesSummary":{"type":"object","properties":{"dryRun":{"type":"boolean","enum":[true]},"schema":{"type":"string","enum":["simforge.dataset-files/v1"]},"dataset":{"$ref":"#/components/schemas/DatasetFilesDataset"},"selection":{"$ref":"#/components/schemas/DatasetFilesSelection"},"include":{"$ref":"#/components/schemas/DatasetFilesInclude"},"counts":{"$ref":"#/components/schemas/DatasetFilesCounts"},"excluded":{"type":"array","items":{"$ref":"#/components/schemas/DatasetFilesExclusion"},"description":"The first 100 exclusions."}},"required":["dryRun","schema","dataset","selection","include","counts","excluded"]},"DatasetFilesCounts":{"type":"object","properties":{"scenarios":{"type":"integer","minimum":0},"files":{"type":"integer","minimum":0},"bytes":{"type":"number","minimum":0,"description":"The bytes of every file whose size is known."},"pendingFiles":{"type":"integer","minimum":0,"description":"Files not prepared yet; sized when they are first listed."},"renders":{"type":"integer","minimum":0},"generated":{"type":"integer","minimum":0,"description":"Factory clips."},"recordings":{"type":"integer","minimum":0},"excluded":{"type":"integer","minimum":0}},"required":["scenarios","files","bytes","pendingFiles","renders","generated","recordings","excluded"]},"DatasetCopyCreateRequest":{"type":"object","properties":{"scope":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["dataset"]},"datasetId":{"type":"string","minLength":1,"maxLength":200}},"required":["kind","datasetId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["query"]},"datasetId":{"type":"string","minLength":1,"maxLength":200},"query":{"type":"object","properties":{"q":{"type":"string","maxLength":500},"filters":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"maxItems":500}},"sourceLogId":{"type":["string","null"],"minLength":1,"maxLength":200}},"required":["q","filters","sourceLogId"],"additionalProperties":false}},"required":["kind","datasetId","query"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["documents"]},"datasetId":{"type":"string","minLength":1,"maxLength":200},"documentIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"minItems":1,"maxItems":100000}},"required":["kind","datasetId","documentIds"],"additionalProperties":false}]},"target":{"anyOf":[{"type":"object","properties":{"datasetId":{"type":"string","minLength":1,"maxLength":200}},"required":["datasetId"],"additionalProperties":false},{"type":"object","properties":{"newDatasetName":{"type":"string","minLength":1,"maxLength":200}},"required":["newDatasetName"],"additionalProperties":false}]},"dryRun":{"type":"boolean"}},"required":["scope"],"additionalProperties":false},"DatasetCopyEstimate":{"type":"object","properties":{"dryRun":{"type":"boolean","enum":[true]},"scenarios":{"type":"integer","minimum":0},"estimateSeconds":{"type":"integer","minimum":0}},"required":["dryRun","scenarios","estimateSeconds"]},"DatasetCopy":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"target":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"scope":{"type":"string","enum":["dataset","query","documents"]},"state":{"type":"string","enum":["queued","running","succeeded","failed"]},"progress":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"done":{"type":"integer","minimum":0},"copied":{"type":"integer","minimum":0},"skipped":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"estimateSeconds":{"type":"integer","minimum":0}},"required":["total","done","copied","skipped","failed","estimateSeconds"]},"failures":{"type":"array","items":{"type":"object","properties":{"scenarioId":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["scenarioId","code","message"]}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","source","target","scope","state","progress","failures","warnings","error","createdAt","updatedAt","finishedAt"]},"DatasetCopyList":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"target":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"scope":{"type":"string","enum":["dataset","query","documents"]},"state":{"type":"string","enum":["queued","running","succeeded","failed"]},"progress":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"done":{"type":"integer","minimum":0},"copied":{"type":"integer","minimum":0},"skipped":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"estimateSeconds":{"type":"integer","minimum":0}},"required":["total","done","copied","skipped","failed","estimateSeconds"]},"failures":{"type":"array","items":{"type":"object","properties":{"scenarioId":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}},"required":["scenarioId","code","message"]}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"finishedAt":{"type":["string","null"]}},"required":["id","source","target","scope","state","progress","failures","warnings","error","createdAt","updatedAt","finishedAt"]}}},"required":["data"]},"UsageDay":{"type":"object","properties":{"day":{"type":"string"},"runs":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0},"byType":{"type":"object","additionalProperties":{"type":"object","properties":{"runs":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0}},"required":["runs","costCents"]}}},"required":["day","runs","costCents","byType"]},"EvaluationCreateRequest":{"type":"object","properties":{"path":{"type":"string","enum":["episode"],"default":"episode","description":"Open-loop evaluations run as a non-reactive episode: the scenario's authored drive stays in control while the model's cameras are rendered live and each plan is scored against the drive that followed it."},"scenarioId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$","description":"The scenario to evaluate. Its latest revision is used unless revisionId names one explicitly."},"revisionId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$","description":"The scenario revision to evaluate, including its pinned map; absent: the latest revision."},"textures":{"type":"string","enum":["uastc-full","bc7-512"],"description":"The texture tier for the live episode cameras; absent: the model family's open-loop tier."},"predictionIntervalS":{"type":"number","exclusiveMinimum":0,"default":0.5,"description":"Seconds between scored prediction instants. Episode evaluations run at 0.5 s (2 Hz)."},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The model's parameters by name (GET /api/v1/evaluation-options lists each model's params with their type, bounds, default and loops); absent ones take their defaults. A name the model does not take in this loop, or a value it does not take, is refused naming params.<name>."},"seed":{"type":"integer","minimum":0,"description":"Alias of params.seed (sent both ways, the two must agree). Absent: the model's default seed."},"numTrajSamples":{"type":"integer","minimum":1,"maximum":64,"description":"Alias of params.numTrajSamples (sent both ways, the two must agree): trajectory samples per instant. Absent: the model's default, or the one count a model returns (its param's fixed value)."},"modelVersionId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]+$","description":"The model to evaluate: an offered model's id from GET /api/v1/evaluation-options, or a registered model version in this workspace. Required from API version 2026-10-24; older versions run the default model without it and say so."},"maxCostCents":{"type":"integer","minimum":0},"dryRun":{"type":"boolean","default":false}},"required":["scenarioId","modelVersionId","maxCostCents"],"additionalProperties":false},"Evaluation":{"type":"object","properties":{"id":{"type":"string","pattern":"^run_"},"kind":{"type":"string","description":"Legacy: alpamayo.openloop for the default model or a workspace alias of it, policy.openloop for every other model (before API version 2026-10-24: the lane it ran on, the default model's family lane or policy.openloop). Name the model by model.modelVersionId."},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied job identity; qualification namespaces are excluded from evaluation suites."},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"published":{"type":"boolean","enum":[true],"description":"An evaluation SimForge published to every workspace (`GET /api/v1/evaluations?published=true`): read-only, without its workspace, origin, submitter, estimate or cost."},"origin":{"type":"string","enum":["browser","desktop","cli","api"],"description":"Where it was launched from: Studio (browser), the desktop app, the simforge CLI (cli) or an API key (api)."},"model":{"type":"object","properties":{"family":{"type":"string","description":"Its model family (architecture and upstream weights)."},"revision":{"type":"string","description":"The upstream weights revision (40 hex) its family pins."},"quant":{"type":"string","description":"Its quantization."},"modelVersionId":{"type":["string","null"],"description":"The registered model version it ran; absent or null on an evaluation from before cloud runs that names none."},"name":{"type":"string","description":"Its name, as `GET /api/v1/evaluation-options` lists an offered model."},"checkpointDigest":{"type":["string","null"],"description":"The sha256 of the checkpoint it runs; a model job runs only beside a model host serving exactly this checkpoint."},"aliasOf":{"type":["string","null"],"description":"The offered model this workspace's own version copies (the same family, quantization and checkpoint); null for an offered model and any other version."},"owner":{"type":"string","description":"Whose model it is: `simforge` (a model SimForge offers) or `workspace` (this workspace's own version, an alias of an offered model included). An open string: a reader keeps a value it does not know."}},"required":["family","revision","quant"],"description":"What it ran: the identity block (`ModelIdentity`); an evaluation from before cloud runs may lack modelVersionId, name, checkpointDigest, aliasOf and owner."},"params":{"type":"object","additionalProperties":{},"description":"The runner's job parameters (its instants, render source and sampling)."},"modelParams":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The model's parameters it runs with, by name, defaults filled in (what params sent, else each one's default)."},"customParams":{"type":"boolean","description":"True when a parameter whose comparability is custom (a sampling setting, a navigation instruction) was off its default: compare it only with runs of the same params."},"estimateCents":{"type":"object","properties":{"lowCents":{"type":"number","minimum":0},"highCents":{"type":"number","minimum":0},"basis":{"type":"string","enum":["measured","unbenchmarked","per_scenario"]}},"required":["lowCents","highCents","basis"]},"reservedCents":{"type":"number"},"settledCents":{"type":["number","null"]},"scored":{"type":["boolean","null"]},"result":{"type":["object","null"],"properties":{"metrics":{"type":"object","additionalProperties":{}},"artifacts":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"artifactId":{"type":"string"},"mediaType":{"type":"string"},"bytes":{"type":"number","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["role","artifactId","mediaType","bytes","sha256"]}}},"required":["metrics","artifacts"],"additionalProperties":{}}},"required":["id","kind","status","model","params","scored","result"],"additionalProperties":{}},"EvaluationQuote":{"type":"object","properties":{"dryRun":{"type":"boolean","enum":[true]},"type":{"type":"string","description":"Legacy: alpamayo.openloop for the default model or a workspace alias of it, policy.openloop for every other model (before API version 2026-10-24: the lane it ran on, the default model's family lane or policy.openloop). Name the model by model.modelVersionId."},"scenarioId":{"type":"string","description":"The scenario it would evaluate."},"estimate":{"type":"object","properties":{"lowCents":{"type":"number","minimum":0},"highCents":{"type":"number","minimum":0},"basis":{"type":"string","enum":["measured","unbenchmarked","per_scenario"]}},"required":["lowCents","highCents","basis"]},"allowed":{"type":"boolean"},"refusal":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"object","additionalProperties":{}}},"required":["code","message"],"description":"Why the same request without dryRun would be refused now, with that submission's code and detail (cloud_not_open with detail.code model_unavailable while no worker serves the model, or provider_boot_failed while its model host is in boot cooldown after failing to start twice, detail.retryAfter naming when it ends). Null when allowed."},"notes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]},"description":"Warnings attached to the evaluation while it runs, including model_defaulted before API version 2026-10-24 when the request names no model. Empty when nothing."},"availableCreditsCents":{"type":"number"},"concurrency":{"type":"object","properties":{"active":{"type":"number"},"limit":{"type":["number","null"],"description":"The workspace's active-job limit; null when it has none."}},"required":["active","limit"]},"maxCostCents":{"type":"integer","minimum":0},"cancellationTerms":{"type":"string"},"modelVersionId":{"type":"string","description":"The model version it would run (before API version 2026-10-24, the default model when the request names none); `model.modelVersionId`."},"modelName":{"type":"string","description":"`model.name`."},"model":{"$ref":"#/components/schemas/ModelIdentity"},"modelParams":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The model's parameters it runs with, by name, defaults filled in (what params sent, else each one's default)."},"customParams":{"type":"boolean","description":"True when a parameter whose comparability is custom (a sampling setting, a navigation instruction) was off its default: compare it only with runs of the same params."}},"required":["dryRun","type","scenarioId","estimate","allowed","refusal","notes","availableCreditsCents","concurrency","maxCostCents","cancellationTerms"]},"EvaluationPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^run_"},"kind":{"type":"string","description":"Legacy: alpamayo.openloop for the default model or a workspace alias of it, policy.openloop for every other model (before API version 2026-10-24: the lane it ran on, the default model's family lane or policy.openloop). Name the model by model.modelVersionId."},"idempotencyKey":{"type":["string","null"],"description":"Caller-supplied job identity; qualification namespaces are excluded from evaluation suites."},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"published":{"type":"boolean","enum":[true],"description":"An evaluation SimForge published to every workspace (`GET /api/v1/evaluations?published=true`): read-only, without its workspace, origin, submitter, estimate or cost."},"origin":{"type":"string","enum":["browser","desktop","cli","api"],"description":"Where it was launched from: Studio (browser), the desktop app, the simforge CLI (cli) or an API key (api)."},"model":{"type":"object","properties":{"family":{"type":"string","description":"Its model family (architecture and upstream weights)."},"revision":{"type":"string","description":"The upstream weights revision (40 hex) its family pins."},"quant":{"type":"string","description":"Its quantization."},"modelVersionId":{"type":["string","null"],"description":"The registered model version it ran; absent or null on an evaluation from before cloud runs that names none."},"name":{"type":"string","description":"Its name, as `GET /api/v1/evaluation-options` lists an offered model."},"checkpointDigest":{"type":["string","null"],"description":"The sha256 of the checkpoint it runs; a model job runs only beside a model host serving exactly this checkpoint."},"aliasOf":{"type":["string","null"],"description":"The offered model this workspace's own version copies (the same family, quantization and checkpoint); null for an offered model and any other version."},"owner":{"type":"string","description":"Whose model it is: `simforge` (a model SimForge offers) or `workspace` (this workspace's own version, an alias of an offered model included). An open string: a reader keeps a value it does not know."}},"required":["family","revision","quant"],"description":"What it ran: the identity block (`ModelIdentity`); an evaluation from before cloud runs may lack modelVersionId, name, checkpointDigest, aliasOf and owner."},"params":{"type":"object","additionalProperties":{},"description":"The runner's job parameters (its instants, render source and sampling)."},"modelParams":{"type":"object","additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"}]},"description":"The model's parameters it runs with, by name, defaults filled in (what params sent, else each one's default)."},"customParams":{"type":"boolean","description":"True when a parameter whose comparability is custom (a sampling setting, a navigation instruction) was off its default: compare it only with runs of the same params."},"estimateCents":{"type":"object","properties":{"lowCents":{"type":"number","minimum":0},"highCents":{"type":"number","minimum":0},"basis":{"type":"string","enum":["measured","unbenchmarked","per_scenario"]}},"required":["lowCents","highCents","basis"]},"reservedCents":{"type":"number"},"settledCents":{"type":["number","null"]},"scored":{"type":["boolean","null"]},"result":{"type":["object","null"],"properties":{"metrics":{"type":"object","additionalProperties":{}},"artifacts":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"artifactId":{"type":"string"},"mediaType":{"type":"string"},"bytes":{"type":"number","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["role","artifactId","mediaType","bytes","sha256"]}}},"required":["metrics","artifacts"],"additionalProperties":{}}},"required":["id","kind","status","model","params","scored","result"],"additionalProperties":{}}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"EvaluationResult":{"type":"object","properties":{"manifestSchema":{"type":"string"},"status":{"type":"string","enum":["succeeded","partial","failed","cancelled"]},"scored":{"type":"boolean"},"evidenceRetainedUntil":{"type":["string","null"]},"manifest":{"type":"object","additionalProperties":{}},"metrics":{"type":"object","additionalProperties":{}},"artifacts":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"artifactId":{"type":"string"},"mediaType":{"type":"string"},"bytes":{"type":"number","minimum":0},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["role","artifactId","mediaType","bytes","sha256"]}}},"required":["manifestSchema","status","scored","evidenceRetainedUntil","manifest","metrics","artifacts"]},"EvaluationDownload":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string"},"sha256":{"type":"string"},"bytes":{"type":"number"},"mediaType":{"type":"string"}},"required":["url","expiresAt","sha256","bytes","mediaType"]},"EvaluationCancel":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"cancelRequestedAt":{"type":["string","null"]}},"required":["id","status","cancelRequestedAt"]},"UsageResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"runs":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0},"byType":{"type":"object","additionalProperties":{"type":"object","properties":{"runs":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0}},"required":["runs","costCents"]}}},"required":["day","runs","costCents","byType"]}},"totalCents":{"type":"integer","minimum":0},"balanceCents":{"type":"integer"}},"required":["data","totalCents","balanceCents"]},"DatasetDetail":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"scenarioCount":{"type":"integer","minimum":0},"updatedAt":{"type":"string","format":"date-time"},"shared":{"type":"boolean"},"readOnly":{"type":"boolean"},"owner":{"type":"string","enum":["workspace","simforge"]},"filling":{"type":["object","null"],"properties":{"total":{"type":"integer","minimum":0}},"required":["total"]},"scenarioIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","scenarioCount","updatedAt","shared","readOnly","owner","filling","scenarioIds"]},"DatasetSummary":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"scenarioCount":{"type":"integer","minimum":0},"updatedAt":{"type":"string","format":"date-time"},"shared":{"type":"boolean"},"readOnly":{"type":"boolean"},"owner":{"type":"string","enum":["workspace","simforge"]},"filling":{"type":["object","null"],"properties":{"total":{"type":"integer","minimum":0}},"required":["total"]}},"required":["id","name","scenarioCount","updatedAt","shared","readOnly","owner","filling"]},"MapPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"version":{"type":["string","null"]},"displayName":{"type":"string"},"public":{"type":"boolean"},"capabilities":{"type":"object","properties":{"render2d":{"type":"boolean"},"render3d":{"type":"boolean"}},"required":["render2d","render3d"]},"packs":{"type":"array","items":{"type":"object","properties":{"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"downloadBytes":{"type":"integer","minimum":0},"installedBytes":{"type":"integer","minimum":0}},"required":["variant","version","downloadBytes","installedBytes"]}}},"required":["id","name","version","displayName","public","capabilities","packs"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"MapSummary":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"version":{"type":["string","null"]},"displayName":{"type":"string"},"public":{"type":"boolean"},"capabilities":{"type":"object","properties":{"render2d":{"type":"boolean"},"render3d":{"type":"boolean"}},"required":["render2d","render3d"]},"packs":{"type":"array","items":{"type":"object","properties":{"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"downloadBytes":{"type":"integer","minimum":0},"installedBytes":{"type":"integer","minimum":0}},"required":["variant","version","downloadBytes","installedBytes"]}}},"required":["id","name","version","displayName","public","capabilities","packs"]},"VehicleImportRequest":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9_-]{1,48}$"},"name":{"type":"string","minLength":1,"maxLength":120},"vehicleClass":{"type":"string","enum":["car","van","truck","bus"]},"dims":{"type":"array","prefixItems":[{"type":"number","exclusiveMinimum":0},{"type":"number","exclusiveMinimum":0},{"type":"number","exclusiveMinimum":0}]},"license":{"type":"string","pattern":"^(?:LicenseRef-[A-Za-z0-9.-]{1,100}|[A-Za-z0-9][A-Za-z0-9.+-]{0,63})$"},"licenseText":{"type":"string","minLength":1,"maxLength":20000},"attribution":{"type":"string","minLength":1,"maxLength":1000},"source":{"type":"string","minLength":1,"maxLength":1000},"uploadId":{"type":"string"}},"required":["id","vehicleClass","license","attribution","uploadId"]},"VehiclePage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"catalogId":{"type":"string","minLength":1},"name":{"type":"string"},"source":{"type":"string","enum":["shared","workspace"]},"vehicleClass":{"type":"string"},"dims":{"type":"object","properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["length","width","height"]},"license":{"type":"string"},"attribution":{"type":"string"},"glbSha256":{"type":"string"},"wheels":{"type":"boolean"},"tintable":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["catalogId","name","source","vehicleClass","dims"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"VehicleSummary":{"type":"object","properties":{"catalogId":{"type":"string","minLength":1},"name":{"type":"string"},"source":{"type":"string","enum":["shared","workspace"]},"vehicleClass":{"type":"string"},"dims":{"type":"object","properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["length","width","height"]},"license":{"type":"string"},"attribution":{"type":"string"},"glbSha256":{"type":"string"},"wheels":{"type":"boolean"},"tintable":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["catalogId","name","source","vehicleClass","dims"]},"AssetList":{"type":"object","properties":{"closure":{"type":"string","pattern":"^[0-9a-f]{64}$"},"runtime":{"type":"string","pattern":"^[0-9a-f]{40}$"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"family":{"type":"string","enum":["car","truck","bus","van","motorcycle","bicycle","scooter","pedestrian","animal","drone","sidewalk_robot","prop"]},"subfamily":{"type":"string","enum":["construction","hazard","occluder","street"]},"source":{"type":"string","enum":["carla","simforge-procedural","generated-meshy","simforge-custom"]},"licence":{"type":["string","null"]},"licenceConfirmed":{"type":"boolean"},"attribution":{"type":"string"},"authorable":{"type":"boolean"},"editor":{"type":"boolean"},"status":{"type":"string","enum":["rendered","failed"]},"image":{"type":["string","null"]},"thumb":{"type":["string","null"]},"sha256":{"type":["string","null"]},"failure":{"type":"string"}},"required":["id","name","family","source","licence","attribution","authorable","editor","status","image","thumb","sha256"]}}},"required":["closure","runtime","data"]},"AssetSummary":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"family":{"type":"string","enum":["car","truck","bus","van","motorcycle","bicycle","scooter","pedestrian","animal","drone","sidewalk_robot","prop"]},"subfamily":{"type":"string","enum":["construction","hazard","occluder","street"]},"source":{"type":"string","enum":["carla","simforge-procedural","generated-meshy","simforge-custom"]},"licence":{"type":["string","null"]},"licenceConfirmed":{"type":"boolean"},"attribution":{"type":"string"},"authorable":{"type":"boolean"},"editor":{"type":"boolean"},"status":{"type":"string","enum":["rendered","failed"]},"image":{"type":["string","null"]},"thumb":{"type":["string","null"]},"sha256":{"type":["string","null"]},"failure":{"type":"string"}},"required":["id","name","family","source","licence","attribution","authorable","editor","status","image","thumb","sha256"]},"ScenarioCopyRequest":{"type":"object","properties":{"datasetId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":200}}},"ScenarioCopy":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"mapId":{"type":["string","null"]},"mapVersionId":{"type":["string","null"]},"latestRevisionId":{"type":["string","null"]},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"datasetIds":{"type":"array","items":{"type":"string"}},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time"},"contentSha256":{"type":"string"},"mapVersionId":{"type":["string","null"]},"mapClosureSha256":{"type":["string","null"]}},"required":["id","createdAt","contentSha256","mapVersionId","mapClosureSha256"]}},"copiedFrom":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"}},"required":["id","name"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}}},"required":["id","name","mapId","mapVersionId","latestRevisionId","updatedAt","createdBy","tags","datasetIds","revisions","copiedFrom"]},"ScenarioDetail":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"mapId":{"type":["string","null"]},"mapVersionId":{"type":["string","null"]},"latestRevisionId":{"type":["string","null"]},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"datasetIds":{"type":"array","items":{"type":"string"}},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time"},"contentSha256":{"type":"string"},"mapVersionId":{"type":["string","null"]},"mapClosureSha256":{"type":["string","null"]}},"required":["id","createdAt","contentSha256","mapVersionId","mapClosureSha256"]}}},"required":["id","name","mapId","mapVersionId","latestRevisionId","updatedAt","createdBy","tags","datasetIds","revisions"]},"ScenarioPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"mapId":{"type":["string","null"]},"mapVersionId":{"type":["string","null"]},"latestRevisionId":{"type":["string","null"]},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","mapId","mapVersionId","latestRevisionId","updatedAt","createdBy","tags","datasetIds"]}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"ScenarioRevision":{"type":"object","properties":{"id":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time"},"contentSha256":{"type":"string"},"mapVersionId":{"type":["string","null"]},"mapClosureSha256":{"type":["string","null"]}},"required":["id","createdAt","contentSha256","mapVersionId","mapClosureSha256"]},"ScenarioSummary":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"mapId":{"type":["string","null"]},"mapVersionId":{"type":["string","null"]},"latestRevisionId":{"type":["string","null"]},"updatedAt":{"type":"string","format":"date-time"},"createdBy":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"datasetIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","mapId","mapVersionId","latestRevisionId","updatedAt","createdBy","tags","datasetIds"]},"RunId":{"type":"string","pattern":"^run_[0-9A-HJKMNP-TV-Z]{26}$"},"RecordingCreateRequest":{"type":"object","properties":{"uploadId":{"type":"string"}},"required":["uploadId"]},"RecordingDownload":{"type":"object","properties":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sourceKind":{"type":"string","enum":["log","manual-drive","rollout","openscenario"]},"producer":{"type":"string"},"clipRef":{"type":"string"},"licence":{"type":["string","null"]},"map":{"type":["object","null"],"properties":{"mapId":{"type":"string"},"version":{"type":["string","null"]},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["mapId","version","xodrSha256"]},"tickCount":{"type":"integer","minimum":0},"actorCount":{"type":"integer","minimum":0},"sizeBytes":{"type":"integer","exclusiveMinimum":0},"createdAt":{"type":"string"},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string"}},"required":["sha256","sourceKind","producer","clipRef","licence","map","tickCount","actorCount","sizeBytes","createdAt","url","expiresAt"]},"Recording":{"type":"object","properties":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sourceKind":{"type":"string","enum":["log","manual-drive","rollout","openscenario"]},"producer":{"type":"string"},"clipRef":{"type":"string"},"licence":{"type":["string","null"]},"map":{"type":["object","null"],"properties":{"mapId":{"type":"string"},"version":{"type":["string","null"]},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["mapId","version","xodrSha256"]},"tickCount":{"type":"integer","minimum":0},"actorCount":{"type":"integer","minimum":0},"sizeBytes":{"type":"integer","exclusiveMinimum":0},"createdAt":{"type":"string"}},"required":["sha256","sourceKind","producer","clipRef","licence","map","tickCount","actorCount","sizeBytes","createdAt"]},"UploadRequest":{"type":"object","properties":{"kind":{"type":"string","enum":["recording","clip-bundle","vehicle-model","mcap","openscenario","model-weights","factory-control","factory-vision","video"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$/i"},"sizeBytes":{"type":"integer","minimum":0,"maximum":5368709120,"description":"Recordings are at most 512 MiB; use MCAP or clip-bundle for larger data. Videos are at most 2 GiB. Other upload kinds are at most 5 GiB."}},"required":["kind","sha256","sizeBytes"]},"UploadResponse":{"type":"object","properties":{"uploadId":{"type":"string"},"uploadUrl":{"type":"string","minLength":1},"uploadHeaders":{"type":"object","additionalProperties":{"type":"string"}},"expiresAt":{"type":"string"}},"required":["uploadId","uploadUrl","uploadHeaders","expiresAt"]},"FineTuneFile":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":500},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$/i"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":5368709120}},"required":["path","sha256","bytes"],"additionalProperties":false},"FineTuneModel":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{40}$"},"quant":{"type":"string"},"checkpointDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"owner":{"type":"string","enum":["workspace"]},"state":{"type":"string","enum":["awaiting_upload","qualifying","ready","rejected","expired","deleted","legacy"]},"params":{"type":"object","additionalProperties":{}},"bytes":{"type":["integer","null"],"minimum":0},"rejection":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["code","message"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","family","revision","quant","checkpointDigest","owner","state","params","bytes","rejection","createdAt","updatedAt"],"additionalProperties":false},"FineTuneUpload":{"type":"object","properties":{"path":{"type":"string","minLength":1},"uploadId":{"type":"string"},"uploadUrl":{"type":"string","minLength":1},"uploadHeaders":{"type":"object","additionalProperties":{"type":"string"}},"expiresAt":{"type":"string","format":"date-time"}},"required":["path","uploadId","uploadUrl","uploadHeaders","expiresAt"],"additionalProperties":false},"FineTuneRegisterRequest":{"type":"object","properties":{"family":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":200},"format":{"type":"string","enum":["safetensors"]},"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":500},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$/i"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":5368709120}},"required":["path","sha256","bytes"],"additionalProperties":false},"minItems":1,"maxItems":32},"params":{"type":"object","additionalProperties":{}}},"required":["family","name","format","files"],"additionalProperties":false},"FineTuneRegisterResponse":{"type":"object","properties":{"model":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{40}$"},"quant":{"type":"string"},"checkpointDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"owner":{"type":"string","enum":["workspace"]},"state":{"type":"string","enum":["awaiting_upload","qualifying","ready","rejected","expired","deleted","legacy"]},"params":{"type":"object","additionalProperties":{}},"bytes":{"type":["integer","null"],"minimum":0},"rejection":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["code","message"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","family","revision","quant","checkpointDigest","owner","state","params","bytes","rejection","createdAt","updatedAt"],"additionalProperties":false},"uploads":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1},"uploadId":{"type":"string"},"uploadUrl":{"type":"string","minLength":1},"uploadHeaders":{"type":"object","additionalProperties":{"type":"string"}},"expiresAt":{"type":"string","format":"date-time"}},"required":["path","uploadId","uploadUrl","uploadHeaders","expiresAt"],"additionalProperties":false}}},"required":["model","uploads"],"additionalProperties":false},"FineTuneFinalizeRequest":{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1},"uploadId":{"type":"string"}},"required":["path","uploadId"],"additionalProperties":false},"minItems":1,"maxItems":32}},"required":["files"],"additionalProperties":false},"FineTuneFinalizeResponse":{"type":"object","properties":{"model":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{40}$"},"quant":{"type":"string"},"checkpointDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"owner":{"type":"string","enum":["workspace"]},"state":{"type":"string","enum":["awaiting_upload","qualifying","ready","rejected","expired","deleted","legacy"]},"params":{"type":"object","additionalProperties":{}},"bytes":{"type":["integer","null"],"minimum":0},"rejection":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["code","message"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","family","revision","quant","checkpointDigest","owner","state","params","bytes","rejection","createdAt","updatedAt"],"additionalProperties":false}},"required":["model"],"additionalProperties":false},"FineTunePage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"revision":{"type":"string","pattern":"^[a-f0-9]{40}$"},"quant":{"type":"string"},"checkpointDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"owner":{"type":"string","enum":["workspace"]},"state":{"type":"string","enum":["awaiting_upload","qualifying","ready","rejected","expired","deleted","legacy"]},"params":{"type":"object","additionalProperties":{}},"bytes":{"type":["integer","null"],"minimum":0},"rejection":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}}},"required":["code","message"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","family","revision","quant","checkpointDigest","owner","state","params","bytes","rejection","createdAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"AuthoringCatalogue":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.authoring-operations/v1"]},"operations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"summary":{"type":"string"},"inputSchema":{"type":"object","additionalProperties":{}},"resultSchema":{"type":"object","additionalProperties":{}},"applicability":{},"effectCategory":{"type":"string","enum":["document"]},"requiredContext":{"type":"array","items":{"type":"string"}},"diagnostics":{"type":"array","items":{}}},"required":["id","summary","inputSchema","resultSchema","effectCategory","requiredContext","diagnostics"],"additionalProperties":{}}}},"required":["schema","operations"],"additionalProperties":{}},"AuthoringResult":{"type":"object","additionalProperties":{}},"AuthoringDiscoveryRequest":{"type":"object","properties":{"kind":{"type":"string","enum":["locations","lanes","movements","catalogue"],"default":"lanes"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"x":{"type":["number","null"]},"z":{"type":["number","null"]},"withinM":{"type":"number","exclusiveMinimum":0},"roadId":{"type":"string","minLength":1,"maxLength":256},"type":{"type":"string","minLength":1,"maxLength":256},"cursor":{"type":"string","minLength":1,"maxLength":1024}},"additionalProperties":false},"AuthoringDiscoveryResult":{"type":"object","properties":{"mapPin":{"type":"object","properties":{"versionId":{"type":"string","minLength":1,"maxLength":256},"mapId":{"type":"string","minLength":1,"maxLength":256},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"closureSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"assetCatalogVersionId":{"type":"string","minLength":1,"maxLength":256},"assetCatalogSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"releaseDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["versionId","mapId","xodrSha256","closureSha256","assetCatalogVersionId","assetCatalogSha256"],"additionalProperties":false},"kind":{"type":"string","enum":["locations","lanes","movements","catalogue"]},"total":{"type":"integer","minimum":0},"records":{"type":"array","items":{"type":"object","additionalProperties":{}}},"nextCursor":{"type":["string","null"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}}},"required":["mapPin","kind","total","records","nextCursor","warnings"]},"AuthoringSpawnRequest":{"type":"object","properties":{"catalogId":{"type":"string","minLength":1,"maxLength":256},"laneRsl":{"type":"string","minLength":1,"maxLength":256},"s":{"type":"number","minimum":0},"x":{"type":"number"},"z":{"type":"number"},"headingRad":{"type":"number"},"lateralM":{"type":"number"},"opposing":{"type":"boolean"},"static":{"type":"boolean"},"draftId":{"type":"string","minLength":1,"maxLength":256},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"expectedDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["catalogId"],"additionalProperties":false},"DraftCreateRequest":{"type":"object","properties":{"mapId":{"type":"string","minLength":1,"maxLength":256},"mapReleaseDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"name":{"type":"string","minLength":1,"maxLength":256},"datasetId":{"type":"string","minLength":1,"maxLength":256},"clipSeconds":{"type":"number","minimum":3,"maximum":120},"createdAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"},"content":{"type":"object","additionalProperties":{}},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"provisional":{"type":"boolean"}},"required":["name"],"additionalProperties":false},"DraftReceipt":{"type":"object","properties":{"documentId":{"type":"string","minLength":1,"maxLength":256},"workspaceId":{"type":"string","minLength":1,"maxLength":256},"datasetId":{"type":"string","minLength":1,"maxLength":256},"draftVersion":{"type":"integer","minimum":0},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"operationDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"content":{"type":"object","additionalProperties":{}},"mapPin":{"type":"object","properties":{"versionId":{"type":"string","minLength":1,"maxLength":256},"mapId":{"type":"string","minLength":1,"maxLength":256},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"closureSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"assetCatalogVersionId":{"type":"string","minLength":1,"maxLength":256},"assetCatalogSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"releaseDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["versionId","mapId","xodrSha256","closureSha256","assetCatalogVersionId","assetCatalogSha256"],"additionalProperties":false},"actorPins":{"type":"array","items":{"type":"object","properties":{"actorId":{"type":"string","minLength":1,"maxLength":256},"catalogId":{"type":["string","null"],"minLength":1,"maxLength":256},"class":{"type":"string","minLength":1,"maxLength":256},"catalogueDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["actorId","catalogId","class","catalogueDigest"]}},"recordingPins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","sha256"],"additionalProperties":{}}},"provisional":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}},"upgradedFrom":{"type":"object","properties":{"scenarioVersion":{"type":"integer","exclusiveMinimum":0},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["scenarioVersion","contentDigest"]}},"required":["documentId","workspaceId","datasetId","draftVersion","contentDigest","operationDigest","content","mapPin","actorPins","recordingPins","provisional"],"additionalProperties":{}},"DraftRevisionReceipt":{"type":"object","properties":{"documentId":{"type":"string","minLength":1,"maxLength":256},"workspaceId":{"type":"string","minLength":1,"maxLength":256},"datasetId":{"type":"string","minLength":1,"maxLength":256},"draftVersion":{"type":"integer","minimum":0},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"operationDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"content":{"type":"object","additionalProperties":{}},"mapPin":{"type":"object","properties":{"versionId":{"type":"string","minLength":1,"maxLength":256},"mapId":{"type":"string","minLength":1,"maxLength":256},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"closureSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"assetCatalogVersionId":{"type":"string","minLength":1,"maxLength":256},"assetCatalogSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"releaseDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["versionId","mapId","xodrSha256","closureSha256","assetCatalogVersionId","assetCatalogSha256"],"additionalProperties":false},"actorPins":{"type":"array","items":{"type":"object","properties":{"actorId":{"type":"string","minLength":1,"maxLength":256},"catalogId":{"type":["string","null"],"minLength":1,"maxLength":256},"class":{"type":"string","minLength":1,"maxLength":256},"catalogueDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["actorId","catalogId","class","catalogueDigest"]}},"recordingPins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","sha256"],"additionalProperties":{}}},"provisional":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"]}},"upgradedFrom":{"type":"object","properties":{"scenarioVersion":{"type":"integer","exclusiveMinimum":0},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["scenarioVersion","contentDigest"]},"revisionId":{"type":"string","minLength":1,"maxLength":256},"revisionContentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["documentId","workspaceId","datasetId","draftVersion","contentDigest","operationDigest","content","mapPin","actorPins","recordingPins","provisional","revisionId","revisionContentDigest"],"additionalProperties":{}},"DraftTransactionRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"expectedDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"label":{"type":"string","minLength":1,"maxLength":256,"default":"CLI authoring transaction"},"operations":{"type":"array","items":{"$ref":"#/components/schemas/AuthoringOperationInput"},"minItems":1,"maxItems":128}},"required":["expectedVersion","expectedDigest","operations"],"additionalProperties":false},"DraftSaveRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"expectedDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"name":{"type":"string","minLength":1,"maxLength":256}},"required":["expectedVersion","expectedDigest"],"additionalProperties":false},"DraftValidateRequest":{"type":"object","properties":{"strict":{"type":"boolean","default":true},"preview":{"type":"boolean","default":false}},"additionalProperties":false},"DistributionAgreementResponse":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.distribution-agreement/v1"]},"status":{"type":"string","enum":["available","unavailable"]},"reason":{"type":["string","null"],"enum":["no_current_agreement","agreement_not_approved",null]},"agreement":{"type":["object","null"],"properties":{"version":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"draft":{"type":"boolean"},"audience":{"type":"string","enum":["staff","preview","public"]},"approvedBy":{"type":["string","null"]},"approvedAt":{"type":["string","null"]},"publishedAt":{"type":"string"}},"required":["version","title","text","sha256","draft","audience","approvedBy","approvedAt","publishedAt"]},"acceptance":{"type":["object","null"],"properties":{"agreementVersion":{"type":"string"},"agreementSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"acceptedAt":{"type":"string"}},"required":["agreementVersion","agreementSha256","acceptedAt"]}},"required":["schema","status","reason","agreement","acceptance"]},"DistributionAgreementAcceptRequest":{"type":"object","properties":{"agreementVersion":{"type":"string","minLength":1,"maxLength":128},"agreementSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["agreementVersion","agreementSha256"],"additionalProperties":false},"DistributionAgreementAcceptance":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.distribution-acceptance/v1"]},"agreementVersion":{"type":"string"},"agreementSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"acceptedAt":{"type":"string"}},"required":["schema","agreementVersion","agreementSha256","acceptedAt"]},"DistributionRuntimeRequest":{"type":"object","properties":{"target":{"type":"string","enum":["x86_64-unknown-linux-gnu","aarch64-apple-darwin","x86_64-apple-darwin","x86_64-pc-windows-gnu"]},"version":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]{0,63}$"},"variant":{"type":"string","enum":["3d","2d"]},"dryRun":{"type":"boolean"}},"required":["target"],"additionalProperties":false},"DistributionCliRequest":{"type":"object","properties":{"target":{"type":"string","enum":["x86_64-unknown-linux-gnu","aarch64-apple-darwin","x86_64-apple-darwin","x86_64-pc-windows-gnu","aarch64-pc-windows-gnullvm"]},"version":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]{0,63}$"},"dryRun":{"type":"boolean"}},"required":["target"],"additionalProperties":false},"DistributionMapRequest":{"type":"object","properties":{"version":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]{0,63}$"},"variant":{"type":"string","enum":["3d","2d"]},"dryRun":{"type":"boolean"}},"additionalProperties":false},"DistributionDownload":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.distribution-download/v1"]},"kind":{"type":"string","enum":["runtime","map","cli"]},"name":{"type":"string"},"target":{"type":"string"},"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"url":{"type":"string","format":"uri"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bytes":{"type":"integer","exclusiveMinimum":0},"expiresAt":{"type":"string"},"agreementVersion":{"type":"string"},"manifest":{"type":"object","additionalProperties":{}},"blobPack":{"type":"object","properties":{"index":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bytes":{"type":"integer","exclusiveMinimum":0},"signature":{"type":"object","additionalProperties":{}}},"required":["url","sha256","bytes","signature"]},"data":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"bytes":{"type":"integer","minimum":0}},"required":["url","bytes"]}},"required":["index","data"]}},"required":["schema","kind","name","version","url","sha256","bytes","expiresAt","agreementVersion","manifest"]},"DistributionReleaseSize":{"type":"object","properties":{"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"downloadBytes":{"type":"integer","minimum":0},"installedBytes":{"type":"integer","minimum":0}},"required":["variant","version","downloadBytes","installedBytes"]},"DistributionAvailable":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.distribution-available/v1"]},"kind":{"type":"string","enum":["runtime"]},"name":{"type":"string","enum":["simforge-runtime"]},"target":{"type":"string","enum":["x86_64-unknown-linux-gnu","aarch64-apple-darwin","x86_64-apple-darwin","x86_64-pc-windows-gnu"]},"releases":{"type":"array","items":{"type":"object","properties":{"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"downloadBytes":{"type":"integer","minimum":0},"installedBytes":{"type":"integer","minimum":0}},"required":["variant","version","downloadBytes","installedBytes"]}}},"required":["schema","kind","name","target","releases"]},"DistributionPlan":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.distribution-plan/v1"]},"kind":{"type":"string","enum":["runtime","map","cli"]},"name":{"type":"string"},"target":{"type":"string"},"variant":{"type":"string","enum":["3d","2d"]},"version":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bytes":{"type":"integer","exclusiveMinimum":0},"agreement":{"type":"object","properties":{"version":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"accepted":{"type":"boolean"}},"required":["version","sha256","accepted"]}},"required":["schema","kind","name","version","sha256","bytes","agreement"]},"FeedbackInput":{"type":"object","properties":{"kind":{"type":"string","enum":["bug","idea","question"]},"message":{"type":"string","minLength":1,"maxLength":4000},"email":{"type":"string","maxLength":254,"pattern":"^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"},"source":{"type":"string","enum":["cli","studio"]},"client":{"type":"object","properties":{"cliVersion":{"type":"string","maxLength":64},"commit":{"type":"string","maxLength":64},"os":{"type":"string","maxLength":32},"arch":{"type":"string","maxLength":32},"runtimeVersion":{"type":"string","maxLength":64},"gpu":{"type":"string","maxLength":200},"agent":{"type":"string","maxLength":32}},"additionalProperties":false},"lastError":{"type":"object","properties":{"command":{"type":"string","maxLength":128},"flags":{"type":"array","items":{"type":"string","maxLength":64},"maxItems":64},"exitCode":{"type":"integer"},"errorCode":{"type":["string","null"],"maxLength":128},"reason":{"type":["string","null"],"maxLength":2000},"httpStatus":{"type":["integer","null"]},"requestId":{"type":["string","null"],"maxLength":128},"map":{"type":["string","null"],"maxLength":96},"finishedAt":{"type":["integer","null"]},"cliVersion":{"type":["string","null"],"maxLength":64}},"required":["command","flags","exitCode","errorCode","reason","httpStatus","requestId","map","finishedAt","cliVersion"],"additionalProperties":false},"doctor":{"type":"object","properties":{"ok":{"type":"boolean"},"summary":{"type":"object","properties":{"ok":{"type":"integer","minimum":0},"warn":{"type":"integer","minimum":0},"fail":{"type":"integer","minimum":0},"skipped":{"type":"integer","minimum":0}},"required":["ok","warn","fail","skipped"],"additionalProperties":false},"checks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64},"status":{"type":"string","enum":["ok","warn","fail","skipped"]},"summary":{"type":"string","maxLength":1000},"fix":{"type":"string","maxLength":1000}},"required":["id","status","summary"],"additionalProperties":false},"maxItems":64}},"required":["ok","summary","checks"],"additionalProperties":false},"page":{"type":"string","maxLength":512}},"required":["kind","message","source"],"additionalProperties":false},"FeedbackReceipt":{"type":"object","properties":{"id":{"type":"string","minLength":1},"status":{"type":"string","enum":["open","closed"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","status","createdAt"],"additionalProperties":false},"TelemetryBatch":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.usage-batch/v1"]},"batchId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"sealedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"},"accountId":{"type":"string","minLength":1,"maxLength":128},"installId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"machine":{"type":"object","properties":{"os":{"type":"string","pattern":"^[a-z][a-z0-9-]{0,31}$"},"arch":{"type":"string","pattern":"^[a-z0-9_]{1,16}$"},"gpus":{"type":"array","items":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x20-\\x7e]+$"},"vramMib":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"driver":{"type":["string","null"],"maxLength":64,"pattern":"^[\\x20-\\x7e]*$"}},"required":["model","vramMib","driver"],"additionalProperties":false},"maxItems":16},"gpuCount":{"type":"integer","minimum":0,"maximum":16},"gpuProbe":{"type":"string","enum":["nvidia-smi","none"]}},"required":["os","arch","gpus","gpuCount","gpuProbe"],"additionalProperties":false},"droppedEvents":{"type":"integer","minimum":0,"maximum":1000000000000},"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"finishedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"},"runtimeVersion":{"type":"string","pattern":"^[0-9A-Za-z.+-]{1,32}$"},"cliVersion":{"type":["string","null"],"pattern":"^[0-9A-Za-z.+-]{1,32}$"},"kind":{"type":"string","enum":["simulate","compile","render","preview","env","evaluate","transfer","export","command"]},"command":{"type":"string","pattern":"^[a-z][a-z0-9-]{0,31}$"},"renderMode":{"type":["string","null"],"enum":["2d","schematic","3d",null]},"renderProfile":{"type":["string","null"],"enum":["training","showcase","schematic",null]},"sensors":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"frames":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"wallSeconds":{"type":"number","minimum":0,"maximum":100000000},"gpuBusySeconds":{"type":["number","null"],"minimum":0,"maximum":100000000},"outcome":{"type":"string","enum":["ok","findings","error"]},"errorCode":{"type":["string","null"],"pattern":"^[a-z][a-z0-9_]{0,63}$"},"episodes":{"type":"integer","minimum":0,"maximum":1000000000000},"envSteps":{"type":"integer","minimum":0,"maximum":1000000000000},"map":{"type":["string","null"],"enum":["belmont-research-center","di-rosa-sf","easterbrook-discovery-school","el-camino-road","richmond-field-station","san-ramon-phase-1","yale-street",null]},"sessionId":{"type":["string","null"],"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"}},"required":["eventId","finishedAt","runtimeVersion","cliVersion","kind","command","renderMode","renderProfile","sensors","frames","wallSeconds","gpuBusySeconds","outcome","errorCode","episodes","envSteps","map","sessionId"],"additionalProperties":false},"minItems":1,"maxItems":500}},"required":["schema","batchId","sealedAt","accountId","installId","machine","droppedEvents","events"],"additionalProperties":false},"TelemetryBatchV2":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.usage-batch/v2"]},"batchId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"sealedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"},"accountId":{"type":"string","minLength":1,"maxLength":128},"installId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"agreementVersion":{"type":"string","enum":["simforge-terms-draft-4"]},"machine":{"type":"object","properties":{"os":{"type":"string","pattern":"^[a-z][a-z0-9-]{0,31}$"},"arch":{"type":"string","pattern":"^[a-z0-9_]{1,16}$"},"gpus":{"type":"array","items":{"type":"object","properties":{"model":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x20-\\x7e]+$"},"vramMib":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"driver":{"type":["string","null"],"maxLength":64,"pattern":"^[\\x20-\\x7e]*$"}},"required":["model","vramMib","driver"],"additionalProperties":false},"maxItems":16},"gpuCount":{"type":"integer","minimum":0,"maximum":16},"gpuProbe":{"type":"string","enum":["nvidia-smi","none"]}},"required":["os","arch","gpus","gpuCount","gpuProbe"],"additionalProperties":false},"droppedEvents":{"type":"integer","minimum":0,"maximum":1000000000000},"events":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"finishedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"},"runtimeVersion":{"type":"string","pattern":"^[0-9A-Za-z.+-]{1,32}$"},"cliVersion":{"type":["string","null"],"pattern":"^[0-9A-Za-z.+-]{1,32}$"},"kind":{"type":"string","enum":["simulate","compile","render","preview","env","evaluate","transfer","export","command","cli","crash","session"]},"command":{"type":"string","pattern":"^[a-z][a-z0-9-]{0,31}$"},"renderMode":{"type":["string","null"],"enum":["2d","schematic","3d",null]},"renderProfile":{"type":["string","null"],"enum":["training","showcase","schematic",null]},"sensors":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"frames":{"type":["integer","null"],"minimum":0,"maximum":1000000000000},"wallSeconds":{"type":"number","minimum":0,"maximum":100000000},"gpuBusySeconds":{"type":["number","null"],"minimum":0,"maximum":100000000},"outcome":{"type":"string","enum":["ok","findings","error"]},"errorCode":{"type":["string","null"],"pattern":"^[a-z][a-z0-9_]{0,63}$"},"episodes":{"type":"integer","minimum":0,"maximum":1000000000000},"envSteps":{"type":"integer","minimum":0,"maximum":1000000000000},"map":{"type":["string","null"],"enum":["belmont-research-center","di-rosa-sf","easterbrook-discovery-school","el-camino-road","richmond-field-station","san-ramon-phase-1","yale-street",null]},"sessionId":{"type":["string","null"],"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"cliCommand":{"type":["string","null"],"pattern":"^[a-z][a-z0-9-]{0,31}( [a-z][a-z0-9-]{0,31}){0,3}$"},"cliFlags":{"type":["array","null"],"items":{"type":"string","pattern":"^(--[a-z][a-z0-9-]{0,47}|-[A-Za-z])$"},"maxItems":64},"crashSite":{"type":["string","null"],"pattern":"^[0-9a-f]{16}$"},"rigPreset":{"type":["string","null"],"enum":["basic-dash-camera","tesla-hw3","waymo-5th-gen","surround-7cam-1lidar","roof-8cam-6lidar-4radar","alpamayo-2cam","alpamayo-4cam","alpamayo-6cam","alpamayo-6cam-vqa","front-4cam-wide-cross-tele","physicalai-av-7cam","drone-fpv-forward","drone-inspection-wide-zoom","drone-inspection-wide","drone-mapping-nadir","custom",null]},"resolution":{"type":["string","null"],"enum":["sd","hd","fhd","qhd","uhd","uhd-plus",null]},"renderPasses":{"type":["array","null"],"items":{"type":"string","enum":["rgb","id","depth","semantic","instance","lidar","radar"]},"maxItems":7},"weather":{"type":["string","null"],"enum":["clear","cloudy","overcast","light_rain","heavy_rain","wet_road","fog_light","fog_dense","snow","sleet","custom",null]},"timeOfDay":{"type":["string","null"],"enum":["dawn","morning","noon","afternoon","dusk","night","night_lit","custom",null]},"datasetScenario":{"type":["string","null"],"pattern":"^[0-9a-f]{64}$"},"datasetVersion":{"type":["string","null"],"pattern":"^\\d{1,6}\\.\\d{1,6}\\.\\d{1,6}$"},"agent":{"type":["string","null"],"enum":["claude-code","codex","cursor","other-agent","none",null]},"cliSessionId":{"type":["string","null"],"pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"firstRun":{"type":["boolean","null"]},"daysSinceInstall":{"type":["integer","null"],"minimum":0,"maximum":100000}},"required":["eventId","finishedAt","runtimeVersion","cliVersion","kind","command","renderMode","renderProfile","sensors","frames","wallSeconds","gpuBusySeconds","outcome","errorCode","episodes","envSteps","map","sessionId","cliCommand","cliFlags","crashSite","rigPreset","resolution","renderPasses","weather","timeOfDay","datasetScenario","datasetVersion","agent","cliSessionId","firstRun","daysSinceInstall"],"additionalProperties":false},"minItems":1,"maxItems":500}},"required":["schema","batchId","sealedAt","accountId","installId","agreementVersion","machine","droppedEvents","events"],"additionalProperties":false},"TelemetryReceipt":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.usage-receipt/v1"]},"batchId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"firstDelivery":{"type":"boolean"},"accepted":{"type":"integer","minimum":0}},"required":["schema","batchId","firstDelivery","accepted"]},"TelemetryTerms":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.usage-terms/v1"]},"agreementVersion":{"type":["string","null"]},"batchSchema":{"type":"string","enum":["simforge.usage-batch/v1","simforge.usage-batch/v2"]}},"required":["schema","agreementVersion","batchSchema"],"additionalProperties":false},"CliOAuthError":{"type":"object","properties":{"error":{"type":"string","description":"Machine code: an RFC 6749/8628 error (`invalid_grant`, `authorization_pending`, `slow_down`, `invalid_token`, `insufficient_scope`) or a SimForge code (`not_found`, `rate_limited`, …)."},"error_description":{"type":"string","description":"One sentence for a person."},"detail":{"type":"object","additionalProperties":{}}},"required":["error","error_description"]},"CliAuthorizationServerMetadata":{"type":"object","properties":{"issuer":{"type":"string"},"resource":{"type":"string","description":"The protected resource (`/api/v1`), as its RFC 9728 metadata names it."},"authorization_servers":{"type":"array","items":{"type":"string"}},"bearer_methods_supported":{"type":"array","items":{"type":"string","enum":["header"]}},"authorization_endpoint":{"type":"string"},"token_endpoint":{"type":"string"},"device_authorization_endpoint":{"type":"string"},"revocation_endpoint":{"type":"string"},"userinfo_endpoint":{"type":"string"},"scopes_supported":{"type":"array","items":{"type":"string"}},"response_types_supported":{"type":"array","items":{"type":"string","enum":["code"]}},"grant_types_supported":{"type":"array","items":{"type":"string"}},"code_challenge_methods_supported":{"type":"array","items":{"type":"string","enum":["S256"]}},"token_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string","enum":["none"]}},"revocation_endpoint_auth_methods_supported":{"type":"array","items":{"type":"string","enum":["none"]}},"simforge_bench_results":{"type":"string"},"simforge_bench_packs":{"type":"string"},"simforge_scenario_documents":{"type":"string"},"simforge_cli_sessions_page":{"type":"string"},"agent_auth":{"type":"object","properties":{"skill":{"type":"string","description":"This host's auth.md: the agent recipe."},"identity_endpoint":{"type":"string"},"claim_endpoint":{"type":"string"},"identity_types_supported":{"type":"array","items":{"type":"string","enum":["service_auth","identity_assertion"]}},"events_endpoint":{"type":"string","description":"Where a trusted agent provider pushes Security Event Tokens (RFC 8935). Present while a provider is trusted."},"identity_assertion":{"type":"object","properties":{"assertion_types_supported":{"type":"array","items":{"type":"string","enum":["urn:ietf:params:oauth:token-type:id-jag"]}},"trusted_issuers":{"type":"array","items":{"type":"string"},"description":"The agent providers whose ID-JAGs this host accepts."}},"required":["assertion_types_supported","trusted_issuers"]},"events_supported":{"type":"array","items":{"type":"string","enum":["https://schemas.workos.com/events/agent/auth/identity/assertion/revoked"]}}},"required":["skill","identity_endpoint","claim_endpoint","identity_types_supported"],"description":"The auth.md profile: how an AI agent registers and is approved by a person."}},"required":["issuer","resource","authorization_servers","bearer_methods_supported","authorization_endpoint","token_endpoint","device_authorization_endpoint","revocation_endpoint","userinfo_endpoint","scopes_supported","response_types_supported","grant_types_supported","code_challenge_methods_supported","token_endpoint_auth_methods_supported","revocation_endpoint_auth_methods_supported","simforge_bench_results","simforge_bench_packs","simforge_scenario_documents","simforge_cli_sessions_page","agent_auth"]},"CliDeviceCodeRequest":{"type":"object","properties":{"client_id":{"type":"string","enum":["simforge-cli"]},"device_name":{"type":"string","maxLength":80,"description":"Shown on the approval page and the account's CLI sessions list."},"client_version":{"type":"string","maxLength":32},"client_platform":{"type":"string","maxLength":40},"scope":{"type":"string","description":"Space-separated scopes (default `maps:read`): maps:read, bench:write, scenarios:read, scenarios:write, datasets:read, runs:read, runs:write, sessions:write, artifacts:read, usage:read, models:read, models:write, keys:admin, runtime:read, challenge:write."}},"required":["client_id"]},"CliDeviceCodeResponse":{"type":"object","properties":{"device_code":{"type":"string"},"user_code":{"type":"string","description":"The code the person confirms on the verification page."},"verification_uri":{"type":"string"},"verification_uri_complete":{"type":"string"},"expires_in":{"type":"integer"},"interval":{"type":"integer","description":"Seconds between token polls."}},"required":["device_code","user_code","verification_uri","verification_uri_complete","expires_in","interval"]},"CliTokenRequest":{"oneOf":[{"type":"object","properties":{"client_id":{"type":"string","enum":["simforge-cli"]},"grant_type":{"type":"string","enum":["urn:ietf:params:oauth:grant-type:device_code"]},"device_code":{"type":"string"}},"required":["client_id","grant_type","device_code"]},{"type":"object","properties":{"client_id":{"type":"string","enum":["simforge-cli"]},"grant_type":{"type":"string","enum":["authorization_code"]},"code":{"type":"string"},"redirect_uri":{"type":"string","description":"The loopback redirect the authorization request named."},"code_verifier":{"type":"string","description":"The PKCE (S256) verifier."}},"required":["client_id","grant_type","code","redirect_uri","code_verifier"]},{"type":"object","properties":{"client_id":{"type":"string","enum":["simforge-cli"]},"grant_type":{"type":"string","enum":["refresh_token"]},"refresh_token":{"type":"string","description":"An unspent `sfc_rt_…` token. Refresh tokens rotate: each one is spent once."}},"required":["client_id","grant_type","refresh_token"]},{"type":"object","properties":{"grant_type":{"type":"string","enum":["urn:workos:agent-auth:grant-type:claim"]},"claim_token":{"type":"string","description":"The `claim_token` of the registration."}},"required":["grant_type","claim_token"]},{"type":"object","properties":{"grant_type":{"type":"string","enum":["urn:ietf:params:oauth:grant-type:jwt-bearer"]},"assertion":{"type":"string","description":"The `identity_assertion` the claim grant returned."},"resource":{"type":"string","description":"Optional (RFC 8707): the protected resource, which must be this host's `/api/v1`."}},"required":["grant_type","assertion"]}]},"CliTokenResponse":{"type":"object","properties":{"access_token":{"type":"string","description":"A `sfc_at_…` bearer token for `/api/v1` and `/api/cli`."},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer"},"refresh_token":{"type":"string"},"refresh_expires_in":{"type":"integer"},"scope":{"type":"string"},"session_id":{"type":"string"},"account":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"}},"required":["id","email","name"]},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspace_id":{"type":"string"}},"required":["id","name","workspace_id"]}},"required":["access_token","token_type","expires_in","refresh_token","refresh_expires_in","scope","session_id","account","organization"]},"CliRevokeRequest":{"type":"object","properties":{"client_id":{"type":"string","enum":["simforge-cli"],"description":"The CLI sends it; an agent may omit it."},"token":{"type":"string","description":"An access or refresh token, or an agent's identity assertion; each ends the whole session."},"token_type_hint":{"type":"string","description":"Accepted and ignored (RFC 7009)."}},"required":["token"]},"CliUserinfo":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"}},"required":["id","email","name"]},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspace_id":{"type":"string"}},"required":["id","name","workspace_id"]},"scopes":{"type":"array","items":{"type":"string"}},"session":{"type":"object","properties":{"id":{"type":"string"},"device_name":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","device_name","created_at"]},"access_token_expires_at":{"type":"string"},"email_verification":{"type":"object","properties":{"verified":{"type":"boolean","description":"Whether the account's email address is verified."},"required":{"type":"boolean","description":"Whether this host refuses runs and downloads to an unverified account (`email_unverified`)."},"resend_url":{"type":"string","description":"The page that resends the verification link to a signed-in account."}},"required":["verified","required","resend_url"],"description":"The account's email verification, read fresh on every request; separate from whether the token is valid."}},"required":["account","organization","scopes","session","access_token_expires_at","email_verification"]},"ProtectedResourceMetadata":{"type":"object","properties":{"resource":{"type":"string"},"resource_name":{"type":"string"},"resource_logo_uri":{"type":"string"},"resource_documentation":{"type":"string"},"authorization_servers":{"type":"array","items":{"type":"string"}},"scopes_supported":{"type":"array","items":{"type":"string"}},"bearer_methods_supported":{"type":"array","items":{"type":"string","enum":["header"]}}},"required":["resource","resource_name","resource_logo_uri","resource_documentation","authorization_servers","scopes_supported","bearer_methods_supported"]},"AgentIdentityRequest":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["service_auth"]},"login_hint":{"type":"string","minLength":3,"maxLength":320,"description":"The email of the SimForge account the agent acts for. Only that account, signed in and with a verified email, can approve the registration."},"scope":{"type":"string","maxLength":200,"description":"Space-separated scopes the person is asked to approve. Omitted: every scope in the metadata's `scopes_supported`."}},"required":["type","login_hint"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["identity_assertion"]},"assertion_type":{"type":"string","enum":["urn:ietf:params:oauth:token-type:id-jag"]},"assertion":{"type":"string","minLength":1,"maxLength":8192,"description":"An ID-JAG from a trusted agent provider: `aud` = this issuer, a fresh `jti`, `exp` within 10 minutes, `email` with `email_verified: true`, and `auth_time` within the last hour."}},"required":["type","assertion_type","assertion"],"additionalProperties":false}]},"AgentIdentityResponse":{"type":"object","properties":{"registration_id":{"type":"string"},"registration_type":{"type":"string","enum":["service_auth","identity_assertion"]},"claim_url":{"type":"string","description":"Where to re-mint a user code for this registration (`POST`, with `claim_token` and the same `email`)."},"claim_token":{"type":"string","description":"Returned once: poll the token endpoint with it. Keep it in memory only."},"claim_token_expires":{"type":"string","description":"When the registration closes (ISO 8601); after it, register again."},"post_claim_scopes":{"type":"array","items":{"type":"string"}},"claim":{"type":"object","properties":{"user_code":{"type":"string","description":"The code the person types on the verification page. Show it to the person, never send it anywhere."},"expires_in":{"type":"integer","description":"Seconds until this user code expires."},"verification_uri":{"type":"string","description":"The page the person opens: it asks them to sign in first, then for the code."},"interval":{"type":"integer","description":"Seconds between token polls."}},"required":["user_code","expires_in","verification_uri","interval"]}},"required":["registration_id","registration_type","claim_url","claim_token","claim_token_expires","post_claim_scopes","claim"]},"AgentAssertionResponse":{"type":"object","properties":{"registration_id":{"type":"string"},"registration_type":{"type":"string","enum":["identity_assertion"]},"identity_assertion":{"type":"string","description":"Exchange it with the JWT-bearer grant for an access token until `assertion_expires` (at most an hour)."},"assertion_expires":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["registration_id","registration_type","identity_assertion","assertion_expires","scopes"]},"AgentInteractionRequired":{"type":"object","properties":{"registration_id":{"type":"string"},"registration_type":{"type":"string","enum":["service_auth","identity_assertion"]},"claim_url":{"type":"string","description":"Where to re-mint a user code for this registration (`POST`, with `claim_token` and the same `email`)."},"claim_token":{"type":"string","description":"Returned once: poll the token endpoint with it. Keep it in memory only."},"claim_token_expires":{"type":"string","description":"When the registration closes (ISO 8601); after it, register again."},"post_claim_scopes":{"type":"array","items":{"type":"string"}},"claim":{"type":"object","properties":{"user_code":{"type":"string","description":"The code the person types on the verification page. Show it to the person, never send it anywhere."},"expires_in":{"type":"integer","description":"Seconds until this user code expires."},"verification_uri":{"type":"string","description":"The page the person opens: it asks them to sign in first, then for the code."},"interval":{"type":"integer","description":"Seconds between token polls."}},"required":["user_code","expires_in","verification_uri","interval"]},"error":{"type":"string","enum":["interaction_required"]},"error_description":{"type":"string"}},"required":["registration_id","registration_type","claim_url","claim_token","claim_token_expires","post_claim_scopes","claim","error","error_description"]},"AgentClaimRequest":{"type":"object","properties":{"claim_token":{"type":"string","minLength":1,"maxLength":128},"email":{"type":"string","minLength":3,"maxLength":320,"description":"The email the registration was made for."}},"required":["claim_token","email"],"additionalProperties":false},"AgentClaimResponse":{"type":"object","properties":{"registration_id":{"type":"string"},"claim_attempt_id":{"type":"string"},"status":{"type":"string","enum":["initiated"]},"expires_at":{"type":"string","description":"When this user code expires (ISO 8601)."},"claim_attempt":{"type":"object","properties":{"user_code":{"type":"string","description":"The code the person types on the verification page. Show it to the person, never send it anywhere."},"expires_in":{"type":"integer","description":"Seconds until this user code expires."},"verification_uri":{"type":"string","description":"The page the person opens: it asks them to sign in first, then for the code."},"interval":{"type":"integer","description":"Seconds between token polls."}},"required":["user_code","expires_in","verification_uri","interval"]}},"required":["registration_id","claim_attempt_id","status","expires_at","claim_attempt"]},"AgentClaimTokenResponse":{"type":"object","properties":{"access_token":{"type":"string","description":"A `sfc_at_…` bearer token for `/api/v1`, valid for `expires_in` seconds."},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer"},"scope":{"type":"string"},"identity_assertion":{"type":"string","description":"A service-signed JWT: exchange it with the JWT-bearer grant for a fresh access token until `assertion_expires`. A secret: keep it like a password."},"assertion_expires":{"type":"string"},"session_id":{"type":"string","description":"The session the account sees and can revoke under Account → CLI sessions."},"account":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"}},"required":["id","email","name"]},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"workspace_id":{"type":"string"}},"required":["id","name","workspace_id"]}},"required":["access_token","token_type","expires_in","scope","identity_assertion","assertion_expires","session_id","account","organization"]},"AgentJwtBearerTokenResponse":{"type":"object","properties":{"access_token":{"type":"string","description":"A `sfc_at_…` bearer token for `/api/v1`, valid for `expires_in` seconds."},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer"},"scope":{"type":"string"}},"required":["access_token","token_type","expires_in","scope"]},"CliScenarioDocument":{"type":"object","properties":{"content":{"description":"The scenario document as the editor stores it."},"mapVersionId":{"type":["string","null"]},"mapXodrSha256":{"type":["string","null"]}},"additionalProperties":{},"description":"One scenario of the session's workspace, as the editor stores it."},"CliBenchResult":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.bench-result/v1"]}},"required":["schema"],"additionalProperties":{},"description":"The `simforge.bench-result/v1` document `simforge bench --submit` writes."},"CliBenchReceipt":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","description":"The result's page."}},"required":["id","url"]},"ChallengeTeamStatus":{"type":"object","properties":{"team":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"}},"required":["id","slug","name"]},"role":{"type":"string","enum":["captain","member"]},"caps":{"type":"array","items":{"type":"object","properties":{"track":{"type":"string","enum":["dev","final"]},"limit":{"type":"integer"},"used":{"type":"integer"},"remaining":{"type":"integer"},"window":{"type":"string"},"resetsAt":{"type":"string"}},"required":["track","limit","used","remaining","window","resetsAt"]}},"registry":{"type":"object","properties":{"registry":{"type":"string"},"repository":{"type":"string"}},"required":["registry","repository"]}},"required":["team","role","caps","registry"]},"ChallengeSubmissionList":{"type":"object","properties":{"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"teamId":{"type":"string"},"track":{"type":"string","enum":["dev","final"]},"imageRef":{"type":"string"},"imageDigest":{"type":"string"},"status":{"type":"string","enum":["queued","scheduled","evaluating","scored","failed","rejected"]},"night":{"type":"string"},"score":{"type":["number","null"]},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]},"createdAt":{"type":"string"},"scoredAt":{"type":["string","null"]}},"required":["id","teamId","track","imageRef","imageDigest","status","night","score","errorCode","errorReason","createdAt","scoredAt"]}}},"required":["submissions"]},"ChallengeSubmissionReceipt":{"type":"object","properties":{"submission":{"type":"object","properties":{"id":{"type":"string"},"teamId":{"type":"string"},"track":{"type":"string","enum":["dev","final"]},"imageRef":{"type":"string"},"imageDigest":{"type":"string"},"status":{"type":"string","enum":["queued","scheduled","evaluating","scored","failed","rejected"]},"night":{"type":"string"},"score":{"type":["number","null"]},"errorCode":{"type":["string","null"]},"errorReason":{"type":["string","null"]},"createdAt":{"type":"string"},"scoredAt":{"type":["string","null"]}},"required":["id","teamId","track","imageRef","imageDigest","status","night","score","errorCode","errorReason","createdAt","scoredAt"]}},"required":["submission"]},"ChallengeSubmitRequest":{"type":"object","properties":{"track":{"type":"string","enum":["dev","final"]},"image":{"type":"string","minLength":1,"maxLength":512,"description":"`<registry>/<repository>@sha256:<digest>`, already pushed to the team's repository."}},"required":["track","image"],"additionalProperties":false},"ChallengeRegistryCredentials":{"type":"object","properties":{"registry":{"type":"string"},"repository":{"type":"string"},"username":{"type":"string"},"password":{"type":"string","description":"A secret: pipe it to `docker login --password-stdin`."},"expiresAt":{"type":"string"}},"required":["registry","repository","username","password","expiresAt"]},"FactoryLookList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactoryLook"}}},"required":["data"]},"FactoryLook":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"},"maxItems":8,"description":"Condition tags only: the generator writes each camera's description from them and the scenario's own facts."},"experimental":{"type":"boolean","description":"\"Experimental: may not apply well\": the look has not yet been seen clearly applied on two clips (fog, rain, snow, golden hour, dense urban, suburban today), and its conditions may come out weak or not at all. No check verifies them (the clip's `lookUnverified`)."}},"required":["id","name","tags","experimental"]},"FactoryEstimateRequest":{"type":"object","properties":{"scenarioIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":500,"description":"The scenarios to make clips of, in this workspace. Exactly one of scenarioIds and datasetId."},"datasetId":{"type":"string","minLength":1,"maxLength":128,"description":"Every scenario of this dataset (one this workspace owns, at most 500). Exactly one of scenarioIds and datasetId."},"lookIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"minItems":1,"maxItems":14,"description":"Looks from GET /api/v1/factory/looks, each once. In simulator mode every clip is made with `rendered` (Rendered lighting). Exactly one of lookIds and prompt."},"prompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Your own conditions in place of a look, stored and sent verbatim: they open every camera's prompt, before its description of the render. The clips' prompt is labeled custom (look `custom`), and no check verifies the conditions (the note look_unverified). Exactly one of lookIds and prompt."},"cameraPrompts":{"type":"object","properties":{"camera_cross_left_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_front_wide_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_cross_right_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_front_tele_30fov":{"type":"string","minLength":1,"maxLength":6000}},"description":"A camera's whole prompt, stored and sent verbatim, in place of its look sentence and description. Any makes the clips' prompt custom (look_unverified)."},"mode":{"type":"string","enum":["positions","simulator"],"default":"positions","description":"`positions`: the generator sees the layout and the look. `simulator`: the layout and each camera's first Helios frame, so the clip keeps the render's lighting: its look is always `rendered`, and any other look asked is replaced with the warning factory_look_unavailable_in_mode."},"seedsPerLook":{"type":"integer","minimum":1,"maximum":10,"description":"Clips per scenario and look, each on its own seed derived from the clip's id (default 1). Not with seeds."},"seeds":{"type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647},"minItems":1,"maxItems":10,"description":"These seeds, each a clip per scenario and look (in this order: the clip's slot). Not with seedsPerLook."},"cameras":{"type":"array","items":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"minItems":1,"maxItems":4,"default":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"],"description":"The cameras to generate, each once, in rig order: any of the Alpamayo 4-camera rig. A clip of fewer cameras is priced on its cameras."},"numInferenceSteps":{"type":"integer","description":"Fixed at 4: the checkpoint is distilled to a 4-step schedule."},"guidanceScale":{"type":"number","description":"Fixed at 1.0: the distilled student runs guidance 1.0 only."},"numFrames":{"type":"integer","description":"A scenario clip is fixed at 601 generated frames (600 kept: 20 s at 30 fps, owner rule)."},"fps":{"type":"integer","description":"A scenario clip is fixed at 30 fps."},"resolution":{"type":"string","description":"Fixed at \"480\", the checkpoint's trained bucket."},"aspectRatio":{"type":"string","description":"A scenario clip is fixed at \"16,9\" (832x480): its labels are drawn at that size."},"conditionVideoAsImage":{"type":"boolean","description":"Fixed at true: Sim-Auto conditions on each camera's first frame only."},"model":{"type":"string","description":"Fixed: one variant is deployed (nvidia/Cosmos3-Nano-Sim-Auto)."},"negativePrompt":{"type":"string","description":"Not available: Sim-Auto's multiview requests take no negative prompt (guidance 1.0 has no negative branch)."}},"additionalProperties":false},"FactoryEstimate":{"type":"object","properties":{"scenarios":{"type":"integer","minimum":0},"looks":{"type":"integer","minimum":0,"description":"The looks the clips are made with: 1 (`rendered`) in simulator mode."},"seedsPerLook":{"type":"integer","exclusiveMinimum":0},"clips":{"type":"integer","minimum":0,"description":"scenarios × looks × seedsPerLook."},"clipSeconds":{"type":"number","enum":[20]},"cameras":{"type":"integer","exclusiveMinimum":0},"cameraSeconds":{"type":"integer","minimum":0,"description":"clips × cameras × 20 s: what the run is priced on."},"centsPerCameraSecond":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0,"description":"The most the run can charge: every clip generated and checked, accepted, flagged or rejected alike. A clip our platform fails to make or check is free."},"etaSeconds":{"type":"integer","minimum":0,"description":"A rough wall-clock estimate from now; queues and cold starts move it."},"allowed":{"type":"boolean","description":"Whether the same request to POST /api/v1/factory/runs would be admitted now (with a maxCostCents at least costCents)."},"refusal":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"scenarioId":{"type":["string","null"]},"lookId":{"type":["string","null"],"description":"The look a warning is about (factory_look_unavailable_in_mode: the look replaced); null for a scenario's."}},"required":["code","message","scenarioId","lookId"]},"description":"What the run would do differently while still making its clips (a look simulator mode replaces with rendered lighting: factory_look_unavailable_in_mode, naming lookId; a scenario authored shorter than 20 s is simulated on to 20 s: simulated_past_authored_end; a longer one takes its first 20 s: scenario_clip_window)."}},"required":["scenarios","looks","seedsPerLook","clips","clipSeconds","cameras","cameraSeconds","centsPerCameraSecond","costCents","etaSeconds","allowed","refusal","warnings"]},"FactoryRunCreateRequest":{"type":"object","properties":{"scenarioIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":128},"minItems":1,"maxItems":500,"description":"The scenarios to make clips of, in this workspace. Exactly one of scenarioIds and datasetId."},"datasetId":{"type":"string","minLength":1,"maxLength":128,"description":"Every scenario of this dataset (one this workspace owns, at most 500). Exactly one of scenarioIds and datasetId."},"lookIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"minItems":1,"maxItems":14,"description":"Looks from GET /api/v1/factory/looks, each once. In simulator mode every clip is made with `rendered` (Rendered lighting). Exactly one of lookIds and prompt."},"prompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Your own conditions in place of a look, stored and sent verbatim: they open every camera's prompt, before its description of the render. The clips' prompt is labeled custom (look `custom`), and no check verifies the conditions (the note look_unverified). Exactly one of lookIds and prompt."},"cameraPrompts":{"type":"object","properties":{"camera_cross_left_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_front_wide_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_cross_right_120fov":{"type":"string","minLength":1,"maxLength":6000},"camera_front_tele_30fov":{"type":"string","minLength":1,"maxLength":6000}},"description":"A camera's whole prompt, stored and sent verbatim, in place of its look sentence and description. Any makes the clips' prompt custom (look_unverified)."},"mode":{"type":"string","enum":["positions","simulator"],"default":"positions","description":"`positions`: the generator sees the layout and the look. `simulator`: the layout and each camera's first Helios frame, so the clip keeps the render's lighting: its look is always `rendered`, and any other look asked is replaced with the warning factory_look_unavailable_in_mode."},"seedsPerLook":{"type":"integer","minimum":1,"maximum":10,"description":"Clips per scenario and look, each on its own seed derived from the clip's id (default 1). Not with seeds."},"seeds":{"type":"array","items":{"type":"integer","minimum":0,"maximum":2147483647},"minItems":1,"maxItems":10,"description":"These seeds, each a clip per scenario and look (in this order: the clip's slot). Not with seedsPerLook."},"cameras":{"type":"array","items":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"minItems":1,"maxItems":4,"default":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"],"description":"The cameras to generate, each once, in rig order: any of the Alpamayo 4-camera rig. A clip of fewer cameras is priced on its cameras."},"numInferenceSteps":{"type":"integer","description":"Fixed at 4: the checkpoint is distilled to a 4-step schedule."},"guidanceScale":{"type":"number","description":"Fixed at 1.0: the distilled student runs guidance 1.0 only."},"numFrames":{"type":"integer","description":"A scenario clip is fixed at 601 generated frames (600 kept: 20 s at 30 fps, owner rule)."},"fps":{"type":"integer","description":"A scenario clip is fixed at 30 fps."},"resolution":{"type":"string","description":"Fixed at \"480\", the checkpoint's trained bucket."},"aspectRatio":{"type":"string","description":"A scenario clip is fixed at \"16,9\" (832x480): its labels are drawn at that size."},"conditionVideoAsImage":{"type":"boolean","description":"Fixed at true: Sim-Auto conditions on each camera's first frame only."},"model":{"type":"string","description":"Fixed: one variant is deployed (nvidia/Cosmos3-Nano-Sim-Auto)."},"negativePrompt":{"type":"string","description":"Not available: Sim-Auto's multiview requests take no negative prompt (guidance 1.0 has no negative branch)."},"maxCostCents":{"type":"integer","minimum":0,"description":"The most this run may charge: every clip generated and checked, whatever its verdict. Below the estimate, the run is refused budget_exceeded."}},"required":["maxCostCents"],"additionalProperties":false},"FactoryRun":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"mode":{"type":"string","enum":["positions","simulator"]},"lookIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"description":"The looks the clips are made with; [`custom`] for a run made with your prompt."},"prompt":{"type":"string","enum":["look","custom"],"description":"custom: the run's clips carry text you wrote (prompt or cameraPrompts)."},"cameras":{"type":"array","items":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]}},"seedsPerLook":{"type":"integer","exclusiveMinimum":0},"scenarios":{"type":"integer","minimum":0},"clips":{"$ref":"#/components/schemas/FactoryClipCounts"},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"createdAt":{"type":"string","format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","status","mode","lookIds","prompt","cameras","seedsPerLook","scenarios","clips","costEstimateCents","costCents","createdAt","finishedAt"]},"FactoryClipCounts":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"inProgress":{"type":"integer","minimum":0},"accepted":{"type":"integer","minimum":0},"flagged":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"cancelled":{"type":"integer","minimum":0,"description":"Clips whose run was cancelled before they were checked; not counted as failed."}},"required":["total","inProgress","accepted","flagged","rejected","failed","cancelled"]},"FactoryRunPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactoryRun"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"FactoryRunDetail":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled"]},"mode":{"type":"string","enum":["positions","simulator"]},"lookIds":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"description":"The looks the clips are made with; [`custom`] for a run made with your prompt."},"prompt":{"type":"string","enum":["look","custom"],"description":"custom: the run's clips carry text you wrote (prompt or cameraPrompts)."},"cameras":{"type":"array","items":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]}},"seedsPerLook":{"type":"integer","exclusiveMinimum":0},"scenarios":{"type":"integer","minimum":0},"clips":{"$ref":"#/components/schemas/FactoryClipCounts"},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"createdAt":{"type":"string","format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"clipList":{"type":"array","items":{"$ref":"#/components/schemas/FactoryClip"},"description":"Every clip, scenario then look then slot."},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"scenarioId":{"type":["string","null"]},"lookId":{"type":["string","null"],"description":"The look a warning is about (factory_look_unavailable_in_mode: the look replaced); null for a scenario's."}},"required":["code","message","scenarioId","lookId"]}}},"required":["id","status","mode","lookIds","prompt","cameras","seedsPerLook","scenarios","clips","costEstimateCents","costCents","createdAt","finishedAt","clipList","warnings"]},"FactoryClip":{"type":"object","properties":{"id":{"type":"string","description":"Stable within the run: `<scenarioId>/<lookId>/<n>`, n the clip's slot (0-based) among its look's seeds."},"scenarioId":{"type":"string"},"scenarioName":{"type":"string"},"lookId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$","description":"The look, or `custom` for a clip made with your prompt."},"prompt":{"$ref":"#/components/schemas/FactoryClipPrompt"},"cameras":{"type":"array","items":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"description":"The clip's cameras, in rig order."},"seed":{"type":["integer","null"],"minimum":0,"description":"The seed of the clip's latest generation; null before it starts."},"reseeds":{"type":"integer","minimum":0,"maximum":3,"description":"Automatic re-seeds the clip had after rejections: always 0 since 2026-10-28, when they ended (a clip is generated once, and a new seed is your own retry); an earlier clip may show up to 3."},"status":{"type":"string","enum":["queued","rendering","generating","checking","accepted","flagged","rejected","failed","cancelled"],"description":"Where the clip stands: queued, rendering (the Helios render of its scenario), generating (the GPU step), checking (the verdict), then its verdict (accepted, flagged or rejected; charged and delivered whichever it is), failed (it could not be made; free) or cancelled (its run was cancelled before it was checked; free, and retry-cancelled makes it again)."},"waiting":{"type":["object","null"],"properties":{"reason":{"type":"string","description":"One of render_pending, preparing, queued_for_gpu, gpu_worker_starting, gpu_capacity_capped, finishing_up; a newer server may add codes."},"message":{"type":"string"},"since":{"type":"string","format":"date-time"},"clipsAhead":{"type":"integer","minimum":0,"description":"While the clip waits for a GPU: how many queued GPU attempts the fleet takes before it (oldest first, every workspace's). Absent otherwise."}},"required":["reason","message","since"],"description":"What the clip is waiting for while nothing visible happens, and since when: render_pending (its scenario's Helios render is queued), preparing (its rendered scenario waits to be prepared: \"Preparing its scenario\"), queued_for_gpu (a GPU worker is present or busy; message gives the clip's place in the queue, \"Waiting for a GPU, 5 clips ahead\"), gpu_worker_starting (no GPU worker was present, so one is starting; a cold start takes minutes; message says which start it is when an earlier one did not come up), gpu_capacity_capped (no worker can start: this environment's GPU-worker or spend cap is reached, as the run's warning says; message gives the clip's place in the queue), finishing_up (its generation is done and its check waits for a worker: \"Finishing up\"; nothing is charged until it is checked). since is when the clip began this wait, whatever workers start meanwhile. Null when the clip is not waiting. A preparation or check waiting over 10 minutes adds the clip warning factory_stage_delayed. A clip waiting on a capped, busy fleet is not failed by the 1 h queue deadline; it fails provider_unavailable after 24 h."},"verdict":{"type":["string","null"],"enum":["accepted","flagged","rejected",null]},"costCents":{"type":"integer","minimum":0,"description":"What this clip charges: its camera-seconds once checked, whatever its verdict; 0 for a clip that failed, was cancelled or is still being made."},"check":{"$ref":"#/components/schemas/FactoryClipCheck"},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"object","additionalProperties":{}}},"required":["code","message"]},"default":[],"description":"What its scenario's clips do differently while still being made: simulated_past_authored_end (a scenario authored shorter than 20 s, simulated on; detail.authoredEndS, detail.simulatedEndS), scenario_clip_window (a longer one, its first 20 s); and factory_stage_delayed while its preparation or check has waited over 10 minutes for a worker (\"Checking is delayed; your clip is safe and nothing is charged until it's checked.\")."},"files":{"type":["object","null"],"properties":{"videos":{"type":"array","items":{"type":"object","properties":{"camera":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"link":{"$ref":"#/components/schemas/FactorySignedLink"}},"required":["camera","link"]}},"layouts":{"type":"array","items":{"type":"object","properties":{"camera":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"link":{"$ref":"#/components/schemas/FactorySignedLink"}},"required":["camera","link"]}},"labels":{"type":"object","properties":{"boxes2d":{"$ref":"#/components/schemas/FactorySignedLink"},"actors3d":{"$ref":"#/components/schemas/FactorySignedLink"},"ego":{"$ref":"#/components/schemas/FactorySignedLink"}},"required":["boxes2d","actors3d","ego"]},"quality":{"$ref":"#/components/schemas/FactorySignedLink"},"manifest":{"$ref":"#/components/schemas/FactorySignedLink"}},"required":["videos","layouts","labels","quality","manifest"]}},"required":["id","scenarioId","scenarioName","lookId","prompt","cameras","seed","reseeds","status","waiting","verdict","costCents","check","error","files"]},"FactoryClipPrompt":{"type":"object","properties":{"source":{"type":"string","enum":["look","custom"],"description":"custom: the clip carries text you wrote (prompt or cameraPrompts); no check verifies its conditions (look_unverified)."},"text":{"type":["string","null"],"description":"Your overall prompt, verbatim; null when the look's sentence opens each camera's prompt."},"sha256":{"type":["string","null"],"description":"The sha256 of text (UTF-8)."},"cameras":{"type":"array","items":{"type":"object","properties":{"camera":{"type":"string","enum":["camera_cross_left_120fov","camera_front_wide_120fov","camera_cross_right_120fov","camera_front_tele_30fov"]},"text":{"type":"string"},"sha256":{"type":"string"}},"required":["camera","text","sha256"]},"description":"The cameras whose whole prompt you wrote, verbatim."}},"required":["source","text","sha256","cameras"]},"FactoryClipCheck":{"type":["object","null"],"properties":{"thresholdsVersion":{"type":"string"},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["rejected","flagged","note"],"description":"What this reason alone makes of the clip; `note`: recorded, it changes nothing."},"actorId":{"type":["string","null"]},"message":{"type":"string"}},"required":["code","severity","actorId","message"]}},"keyActors":{"type":"array","items":{"type":"object","properties":{"actorId":{"type":"string"},"role":{"type":"string","enum":["hazard","collision_course","closest","nearby"]},"class":{"type":["string","null"]},"generated":{"type":"object","properties":{"visibleFrames":{"type":"integer"},"hitFrames":{"type":"integer"},"rate":{"type":["number","null"]}},"required":["visibleFrames","hitFrames","rate"]},"render":{"type":"object","properties":{"visibleFrames":{"type":"integer"},"hitFrames":{"type":"integer"},"rate":{"type":["number","null"]}},"required":["visibleFrames","hitFrames","rate"],"description":"The actor's detection rate on the Helios render; absent under a check version that reads nothing of the render (`expected`)."},"expected":{"type":"object","properties":{"measurableFrames":{"type":"integer","description":"Sampled frames where the detector is expected to find the actor (in its best camera, at the version's minimum expected recall)."},"expectedHits":{"type":"number","description":"Its expected recall summed over those frames."},"hitFrames":{"type":"integer","description":"Of them, frames with a right-sized detection in some camera where it is visible."},"presentFrames":{"type":"integer","description":"Of them, frames with a detection of any size there."}},"required":["measurableFrames","expectedHits","hitFrames","presentFrames"],"description":"The actor against its expected recall, under a check version that reads nothing of the render (factory-check/2026-10-31-expected); absent otherwise."},"relativeRate":{"type":["number","null"],"description":"Generated detection rate over the render's for this actor (or, with `expected`, generated hits over expected hits); null when it cannot be measured."},"verdict":{"type":["string","null"],"enum":["accepted","flagged","rejected",null],"description":"Null: the actor could not be checked (the render, or its expected recall, cannot measure it)."},"frames":{"type":"array","items":{"type":"array","prefixItems":[{"type":"integer"},{"type":"integer"}]},"description":"The only clip frames [from, to] (inclusive) this actor was scored over: a collision_course actor's on-course frames, from factory-check/2026-10-30. Absent: the whole clip."}},"required":["actorId","role","class","generated","relativeRate","verdict"]}},"lookUnverified":{"type":"array","items":{"type":"string"},"description":"The look's conditions (tags) no check verified, from factory-check/2026-10-28: an accepted clip listing any is not proof they applied. The clip's `manifest.json` carries the same list. Empty when every condition was checked or the look needs none."}},"required":["thresholdsVersion","reasons","keyActors","lookUnverified"]},"FactorySignedLink":{"type":"object","properties":{"artifactId":{"type":"string"},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0}},"required":["artifactId","url","expiresAt","sha256","sizeBytes"]},"FactoryRetryFlaggedRequest":{"type":"object","properties":{"clipIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":5000,"description":"Flagged clips of the run to retry; absent: every flagged clip."},"maxCostCents":{"type":"integer","minimum":0,"description":"The most the retries may charge (every retried clip generated and checked)."}},"required":["maxCostCents"],"additionalProperties":false},"FactoryRetryFlaggedResponse":{"type":"object","properties":{"runId":{"type":"string","description":"The run the retries go to (a new factory_batch run of the flagged clips)."},"clips":{"type":"integer","minimum":0},"costEstimateCents":{"type":"integer","minimum":0}},"required":["runId","clips","costEstimateCents"]},"FactoryParams":{"type":"object","properties":{"schema":{"type":"string","enum":["simforge.factory-params/v1"]},"version":{"type":"integer","exclusiveMinimum":0,"description":"The newest params version this server knows."},"model":{"type":"object","properties":{"repo":{"type":"string"},"revision":{"type":"string"},"pipeline":{"type":"string"},"endpoint":{"type":"string","description":"The Sim-Auto server endpoint every generation calls (and a delivered request.json names)."},"servedModelName":{"type":"string"},"cameras":{"type":"array","items":{"type":"string"},"description":"Every camera the checkpoint was exported with."},"steps":{"type":"integer"},"guidance":{"type":"number"},"temporalCompression":{"type":"integer"},"latentFramesPerChunk":{"type":"integer"},"fps":{"type":"number"},"defaultFrames":{"type":"integer"},"recommendedFps":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}]},"resolution":{"type":"string"},"sizes":{"type":"object","additionalProperties":{"type":"array","prefixItems":[{"type":"integer"},{"type":"integer"}]},"description":"Output size (width, height) per aspect bucket."}},"required":["repo","revision","pipeline","endpoint","servedModelName","cameras","steps","guidance","temporalCompression","latentFramesPerChunk","fps","defaultFrames","recommendedFps","resolution","sizes"]},"scenarioClip":{"type":"object","properties":{"seconds":{"type":"number","enum":[20]},"fps":{"type":"integer"},"frames":{"type":"integer"},"resolution":{"type":"object","properties":{"width":{"type":"integer"},"height":{"type":"integer"}},"required":["width","height"]},"cameras":{"type":"array","items":{"type":"string"}},"rule":{"type":"string"}},"required":["seconds","fps","frames","resolution","cameras","rule"],"description":"A clip made from a scenario: always 20 s (owner rule)."},"rawMaxCameraFrames":{"type":"integer","exclusiveMinimum":0,"description":"A raw generation's most frames over all cameras (frames x cameras)."},"params":{"type":"array","items":{"$ref":"#/components/schemas/FactoryParam"}},"deployment":{"type":"object","properties":{"paramsVersion":{"type":"integer","exclusiveMinimum":0,"description":"The params version this deployment's GPU worker honours."},"raw":{"type":"object","properties":{"available":{"type":"boolean"},"centsPerGeneration":{"type":["integer","null"],"minimum":0,"description":"What one raw generation costs, whatever it shows; null where raw generation is not priced."}},"required":["available","centsPerGeneration"]}},"required":["paramsVersion","raw"]}},"required":["schema","version","model","scenarioClip","rawMaxCameraFrames","params","deployment"]},"FactoryParam":{"type":"object","properties":{"name":{"type":"string"},"flag":{"type":"string","description":"The `simforge factory clip create` flag."},"simAutoField":{"type":["string","null"],"description":"The Sim-Auto `/v1/videos/sync` field it sets (a path inside extra_params where it sits there); null for SimForge's own."},"type":{"type":"string","enum":["integer","number","string","boolean","enum","cameras","camera-prompts","camera-files"]},"description":{"type":"string"},"since":{"type":"integer","exclusiveMinimum":0,"description":"The params version a GPU worker needs to honour it."},"available":{"type":"boolean","description":"Whether this deployment's GPU worker honours it now (since <= deployment.paramsVersion); a request naming an unavailable parameter is refused factory_param_unavailable."},"scenario":{"anyOf":[{"type":"object","properties":{"settable":{"type":"boolean","enum":[true]},"default":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Used when the parameter is not given; null when it is derived (defaultNote says how)."},"defaultNote":{"type":"string"},"allowed":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"min":{"type":"number"},"max":{"type":"number"},"maxLength":{"type":"integer"},"rule":{"type":"string"}},"required":["settable","default"]},{"type":"object","properties":{"settable":{"type":"boolean","enum":[false]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"The only value: a request may name it (so a local Sim-Auto request carries over unchanged), never another."},"fixedBy":{"type":"string","enum":["model","product"],"description":"model: the checkpoint or its server refuses anything else. product: a SimForge rule (a scenario clip's 20 s, its labels' shape)."},"reason":{"type":"string"}},"required":["settable","value","fixedBy","reason"]}],"description":"In a clip made from a scenario."},"raw":{"anyOf":[{"type":"object","properties":{"settable":{"type":"boolean","enum":[true]},"default":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Used when the parameter is not given; null when it is derived (defaultNote says how)."},"defaultNote":{"type":"string"},"allowed":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"min":{"type":"number"},"max":{"type":"number"},"maxLength":{"type":"integer"},"rule":{"type":"string"}},"required":["settable","default"]},{"type":"object","properties":{"settable":{"type":"boolean","enum":[false]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"The only value: a request may name it (so a local Sim-Auto request carries over unchanged), never another."},"fixedBy":{"type":"string","enum":["model","product"],"description":"model: the checkpoint or its server refuses anything else. product: a SimForge rule (a scenario clip's 20 s, its labels' shape)."},"reason":{"type":"string"}},"required":["settable","value","fixedBy","reason"]}],"description":"In a raw generation (your own control videos, no scenario)."}},"required":["name","flag","simAutoField","type","description","since","available","scenario","raw"]},"FactoryGenerationCreateRequest":{"type":"object","properties":{"fields":{"$ref":"#/components/schemas/SimAutoFields"},"files":{"type":"array","items":{"type":"object","properties":{"uploadId":{"type":"string","description":"A factory-control (MP4) or factory-vision (PNG, JPEG) upload."},"filename":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9._-]+$","description":"The file's name in the request (and in the delivered inputs/ folder)."}},"required":["uploadId","filename"],"additionalProperties":false},"minItems":1,"maxItems":22,"description":"The request's input_references, in order: the indexes extra_params' views name."},"maxCostCents":{"type":"integer","minimum":0,"description":"The most it may charge: one generation's price, or it is refused budget_exceeded."}},"required":["fields","files","maxCostCents"],"additionalProperties":false},"SimAutoFields":{"type":"object","properties":{"model":{"type":"string","description":"The served model name; one variant is deployed (nvidia/Cosmos3-Nano-Sim-Auto)."},"prompt":{"type":"string","maxLength":2000,"description":"The request's overall prompt, sent as given (Sim-Auto reads the per-camera prompts)."},"size":{"type":"string","pattern":"^\\d+x\\d+$","description":"width x height; must be the aspect bucket's size (16,9: 832x480)."},"num_frames":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}],"description":"Frames per camera, on the 4k+1 grid (another count is rounded up, with a warning)."},"fps":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}]},"num_inference_steps":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}],"description":"Fixed at 4."},"guidance_scale":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}],"description":"Fixed at 1.0."},"seed":{"anyOf":[{"type":"number"},{"type":"string","minLength":1}],"description":"Absent: derived from the Idempotency-Key."},"negative_prompt":{"type":"string","description":"Refused: Sim-Auto's multiview requests take no negative prompt."},"extra_params":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":{}}],"description":"{multiview: {views: [{camera_key, prompt, control_reference_index, vision_reference_index?}], condition_video_as_image?, num_frames?, resolution?, aspect_ratio?}, wsm: {}, resolution?, aspect_ratio?}: views name the input_references files by index."}},"required":["extra_params"],"additionalProperties":false},"FactoryGeneration":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","generating","succeeded","failed","cancelled"]},"request":{"type":"object","properties":{"cameras":{"type":"array","items":{"type":"string"}},"numFrames":{"type":"integer","exclusiveMinimum":0,"description":"Frames per camera the generator makes (on the 4k+1 grid)."},"fps":{"type":"number","exclusiveMinimum":0},"size":{"type":"object","properties":{"width":{"type":"integer"},"height":{"type":"integer"}},"required":["width","height"]},"seed":{"type":"integer","minimum":0},"mode":{"type":"string","enum":["positions","simulator"],"description":"simulator: vision images were sent."}},"required":["cameras","numFrames","fps","size","seed","mode"]},"waiting":{"type":["object","null"],"properties":{"reason":{"type":"string"},"message":{"type":"string"},"since":{"type":"string","format":"date-time"},"clipsAhead":{"type":"integer","minimum":0}},"required":["reason","message","since"],"description":"What it waits for (queued_for_gpu: \"Waiting for a GPU, 2 clips ahead\", gpu_worker_starting, gpu_capacity_capped), as for a Factory clip; null when not waiting."},"costEstimateCents":{"type":["integer","null"],"minimum":0},"costCents":{"type":["integer","null"],"minimum":0},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"object","additionalProperties":{}}},"required":["code","message"]}},"files":{"type":["object","null"],"properties":{"request":{"type":"object","properties":{"artifactId":{"type":"string"},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0}},"required":["artifactId","url","expiresAt","sha256","sizeBytes"],"description":"request.json: the exact request, which a local Sim-Auto server takes unchanged with the inputs."},"response":{"type":"object","properties":{"artifactId":{"type":"string"},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0}},"required":["artifactId","url","expiresAt","sha256","sizeBytes"],"description":"response.mp4: the server's own camera-major MP4, as returned."},"videos":{"type":"array","items":{"type":"object","properties":{"camera":{"type":"string"},"link":{"$ref":"#/components/schemas/FactoryGenerationLink"}},"required":["camera","link"]},"description":"Each camera's frames as its own MP4."},"inputs":{"type":"array","items":{"type":"object","properties":{"filename":{"type":"string"},"link":{"$ref":"#/components/schemas/FactoryGenerationLink"}},"required":["filename","link"]},"description":"The input_references sent, by filename (request.json names them)."},"timing":{"$ref":"#/components/schemas/FactoryGenerationLink"}},"required":["request","response","videos","inputs","timing"],"description":"Absent until it succeeded."},"createdAt":{"type":"string","format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","status","request","waiting","costEstimateCents","costCents","error","warnings","files","createdAt","finishedAt"]},"FactoryGenerationLink":{"type":"object","properties":{"artifactId":{"type":"string"},"url":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"},"sha256":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0}},"required":["artifactId","url","expiresAt","sha256","sizeBytes"]},"FactoryGenerationPage":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactoryGeneration"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]},"FactoryGenerationRetryRequest":{"type":"object","properties":{"maxCostCents":{"type":"integer","minimum":0}},"required":["maxCostCents"],"additionalProperties":false},"FactoryInputCheckRequest":{"type":"object","properties":{"uploadId":{"type":"string"},"role":{"type":"string","enum":["control","vision"]},"numFrames":{"type":"integer","exclusiveMinimum":0,"description":"control: the frames the generation makes (default 201, the server's)."},"fps":{"type":"integer","exclusiveMinimum":0,"description":"control: the generation's fps (default 30)."},"aspectRatio":{"type":"string","description":"The generation's aspect bucket; absent: the bucket closest to this file's shape, as the server picks it."}},"required":["uploadId","role"],"additionalProperties":false},"FactoryInputCheck":{"type":"object","properties":{"ok":{"type":"boolean","description":"Whether the generation would take it."},"media":{"type":["object","null"],"properties":{"container":{"type":"string"},"codec":{"type":["string","null"]},"width":{"type":"integer"},"height":{"type":"integer"},"frames":{"type":["integer","null"]},"fps":{"type":["number","null"]}},"required":["container","codec","width","height","frames","fps"],"description":"What the file is; null when it could not be read."},"problems":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"description":"Why it would be refused."},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"object","additionalProperties":{}}},"required":["code","message"]},"description":"What it does differently while still being used (extra frames, which are not used)."}},"required":["ok","media","problems","warnings"]},"AuthoringDiagnostic":{"type":"object","additionalProperties":false,"required":["code","severity","path","message"],"properties":{"code":{"type":"string"},"severity":{"enum":["error","warning","info"]},"path":{"type":"string"},"message":{"type":"string"},"actorId":{"type":"string"}}},"AuthoringDocumentTransactionResult":{"type":"object","additionalProperties":false,"required":["document","version","digest","changedPaths","entityIds","diagnostics","inverseDocument"],"properties":{"document":{"type":"object"},"version":{"type":"integer","minimum":1},"digest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"changedPaths":{"type":"array","items":{"type":"string"}},"entityIds":{"type":"array","items":{"type":"string"}},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/AuthoringDiagnostic"}},"inverseDocument":{"type":"object"},"scene":{"type":"object","description":"Where every actor is relative to the ego: lane, metres ahead along the ego's route, lateral offset, when the ego reaches it, its events and any encounter expectation. Absent without an ego or a map.","properties":{"ego":{"type":"object"},"actors":{"type":"array","items":{"type":"object"}}}}}},"AuthoringHttpDraftTransactionResult":{"type":"object","additionalProperties":false,"required":["document","version","digest","changedPaths","entityIds","diagnostics","inverseDocument","documentId","workspaceId","datasetId","draftVersion","contentDigest","operationDigest","content","mapPin","actorPins","recordingPins","provisional"],"properties":{"document":{"type":"object"},"version":{"type":"integer","minimum":1},"digest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"changedPaths":{"type":"array","items":{"type":"string"}},"entityIds":{"type":"array","items":{"type":"string"}},"diagnostics":{"type":"array","items":{"$ref":"#/components/schemas/AuthoringDiagnostic"}},"inverseDocument":{"type":"object"},"scene":{"type":"object","description":"Where every actor is relative to the ego: lane, metres ahead along the ego's route, lateral offset, when the ego reaches it, its events and any encounter expectation. Absent without an ego or a map.","properties":{"ego":{"type":"object"},"actors":{"type":"array","items":{"type":"object"}}}},"documentId":{"type":"string","minLength":1,"maxLength":256},"workspaceId":{"type":"string","minLength":1,"maxLength":256},"datasetId":{"type":"string","minLength":1,"maxLength":256},"draftVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"operationDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"content":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"mapPin":{"type":"object","properties":{"versionId":{"type":"string","minLength":1,"maxLength":256},"mapId":{"type":"string","minLength":1,"maxLength":256},"xodrSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"closureSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"assetCatalogVersionId":{"type":"string","minLength":1,"maxLength":256},"assetCatalogSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"releaseDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["versionId","mapId","xodrSha256","closureSha256","assetCatalogVersionId","assetCatalogSha256"],"additionalProperties":false},"actorPins":{"type":"array","items":{"type":"object","properties":{"actorId":{"type":"string","minLength":1,"maxLength":256},"catalogId":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"class":{"type":"string","minLength":1,"maxLength":256},"catalogueDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["actorId","catalogId","class","catalogueDigest"],"additionalProperties":false}},"recordingPins":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","sha256"],"additionalProperties":{}}},"provisional":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"object","properties":{},"additionalProperties":{}}},"required":["code","message"],"additionalProperties":false}},"upgradedFrom":{"type":"object","properties":{"scenarioVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"contentDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["scenarioVersion","contentDigest"],"additionalProperties":false}}},"AuthoringAddActorInput":{"type":"object","additionalProperties":false,"required":["type","id","catalogId"],"properties":{"type":{"const":"addActor","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New actor id (never allocated implicitly)."},"catalogId":{"type":"string","description":"Built-in actor (`simforge scenario actors`): vehicle.sedan, pedestrian.adult, ..."},"laneRsl":{"type":"string","pattern":"^-?[0-9]+:[0-9]+:-?[0-9]+$","description":"Semantic lane `road:section:lane` (with s)."},"s":{"type":"number","description":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report.","minimum":0,"x-unit":"m"},"movementRsl":{"type":"string","description":"A junction movement's connecting lane (a junction_movement location's anchor.road.rsl): place the actor beforeM up its approach and turn it through that movement."},"beforeM":{"type":"number","description":"With movementRsl: distance before the junction (default 40).","minimum":1,"maximum":500,"x-unit":"m"},"x":{"type":"number","description":"Scene-frame x (east).","x-unit":"m"},"z":{"type":"number","description":"Scene-frame z (minus north).","x-unit":"m"},"y":{"type":"number","description":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground.","x-unit":"m"},"headingRad":{"type":"number","description":"Heading in the scene frame; default: the lane heading or the actor class default.","x-unit":"rad"},"lateralM":{"type":"number","description":"Lateral offset in the lane, positive to the left of travel.","x-unit":"m"},"overlapOverride":{"type":"boolean","default":false,"description":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles)."},"opposing":{"type":"boolean","default":false,"description":"Snap to the nearest genuinely opposing lane."},"static":{"type":"boolean","default":false,"description":"Place as a static actor (no motion, zero speed)."},"speedKph":{"type":"number","description":"Initial speed; default: posted limit for road vehicles.","minimum":0,"maximum":160,"x-unit":"km/h"},"bodyColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","description":"Presentation body colour `#rrggbb`."},"label":{"type":"string","maxLength":80,"description":"Display label."}},"oneOf":[{"required":["laneRsl","s"]},{"required":["x","z"]},{"required":["movementRsl"]}]},"AuthoringMoveActorInput":{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"const":"moveActor","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor to move."},"laneRsl":{"type":"string","pattern":"^-?[0-9]+:[0-9]+:-?[0-9]+$","description":"Semantic lane `road:section:lane` (with s)."},"s":{"type":"number","description":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report.","minimum":0,"x-unit":"m"},"x":{"type":"number","description":"Scene-frame x (east).","x-unit":"m"},"z":{"type":"number","description":"Scene-frame z (minus north).","x-unit":"m"},"y":{"type":"number","description":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground.","x-unit":"m"},"headingRad":{"type":"number","description":"Heading in the scene frame; default: the lane heading or the actor class default.","x-unit":"rad"},"lateralM":{"type":"number","description":"Lateral offset in the lane, positive to the left of travel.","x-unit":"m"},"overlapOverride":{"type":"boolean","default":false,"description":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles)."}},"oneOf":[{"required":["laneRsl","s"]},{"required":["x","z"]}]},"AuthoringDuplicateActorInput":{"type":"object","additionalProperties":false,"required":["type","id","newId"],"properties":{"type":{"const":"duplicateActor","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Source actor."},"newId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New actor id."},"laneRsl":{"type":"string","pattern":"^-?[0-9]+:[0-9]+:-?[0-9]+$","description":"Semantic lane `road:section:lane` (with s)."},"s":{"type":"number","description":"Metres along laneRsl in its direction of travel, from where traffic enters it: the same s a location's anchor.road.s and a crossing approach's stopS report.","minimum":0,"x-unit":"m"},"x":{"type":"number","description":"Scene-frame x (east).","x-unit":"m"},"z":{"type":"number","description":"Scene-frame z (minus north).","x-unit":"m"},"y":{"type":"number","description":"Explicit height; otherwise the map ground at (x,z) is used and refused without ground.","x-unit":"m"},"headingRad":{"type":"number","description":"Heading in the scene frame; default: the lane heading or the actor class default.","x-unit":"rad"},"lateralM":{"type":"number","description":"Lateral offset in the lane, positive to the left of travel.","x-unit":"m"},"overlapOverride":{"type":"boolean","default":false,"description":"Accept overlap with another actor (free/static actors only; refused for moving road vehicles)."}},"oneOf":[{"required":["laneRsl","s"]},{"required":["x","z"]}]},"AuthoringRemoveRoleInput":{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"const":"removeRole","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor to delete."}}},"AuthoringSetEgoInput":{"type":"object","additionalProperties":false,"required":["type","roleId"],"properties":{"type":{"const":"setEgo","description":"Operation id."},"roleId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor to make ego."}}},"AuthoringSetActorSpeedInput":{"type":"object","additionalProperties":false,"required":["type","id","speedKph"],"properties":{"type":{"const":"setActorSpeed","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"speedKph":{"type":"number","description":"Initial speed.","minimum":0,"maximum":160,"x-unit":"km/h"}}},"AuthoringSetActorStaticInput":{"type":"object","additionalProperties":false,"required":["type","id","static"],"properties":{"type":{"const":"setActorStatic","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"static":{"type":"boolean","description":"true: static; false: mobile."}}},"AuthoringAddLaneChangeInput":{"type":"object","additionalProperties":false,"required":["type","id","actorId","direction","startS"],"properties":{"type":{"const":"addLaneChange","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New event id."},"actorId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"direction":{"type":"string","enum":["left","right"],"description":"Target lane side."},"startS":{"type":"number","description":"Clip time the change starts.","minimum":0,"x-unit":"s"},"endS":{"type":"number","description":"Clip time the event ends.","minimum":0,"x-unit":"s"},"durationS":{"type":"number","description":"Lane-change duration.","exclusiveMinimum":0,"default":3,"x-unit":"s"}}},"AuthoringAddNextJunctionTurnInput":{"type":"object","additionalProperties":false,"required":["type","id","actorId","direction","startS"],"properties":{"type":{"const":"addNextJunctionTurn","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New event id."},"actorId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"direction":{"type":"string","enum":["left","right","straight"],"description":"Movement at the next junction."},"startS":{"type":"number","description":"Clip time the choice applies from.","minimum":0,"x-unit":"s"},"endS":{"type":"number","description":"Clip time the event ends.","minimum":0,"x-unit":"s"}}},"AuthoringAddUTurnInput":{"type":"object","additionalProperties":false,"required":["type","id","actorId"],"properties":{"type":{"const":"addUTurn","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New event id."},"actorId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"A moving road vehicle on a lane."},"movementRsl":{"type":"string","description":"A U-turn movement's connecting lane on the actor's route (authoring discover --kind movements, turnRelation UTurnLeft/UTurnRight); default: the first place it can turn."}}},"AuthoringSetWaypointRouteInput":{"type":"object","additionalProperties":false,"required":["type","id","actorId","points","startS","durationS"],"properties":{"type":{"const":"setWaypointRoute","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New event id."},"actorId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"points":{"type":"array","minItems":2,"description":"Scene points `X,Z` in metres (x east, z minus north; the height follows the map ground), the actor's current position first.","items":{"type":"object","additionalProperties":false,"required":["x","z"],"properties":{"x":{"type":"number"},"z":{"type":"number"}}}},"startS":{"type":"number","description":"Clip time the route starts.","minimum":0,"x-unit":"s"},"durationS":{"type":"number","description":"Route duration.","exclusiveMinimum":0,"x-unit":"s"},"endS":{"type":"number","description":"Clip time the event ends.","minimum":0,"x-unit":"s"}}},"AuthoringAddSpeedChangeInput":{"type":"object","additionalProperties":false,"required":["type","id","actorId","startS","targetKph"],"properties":{"type":{"const":"addSpeedChange","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New event id."},"actorId":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Actor."},"startS":{"type":"number","description":"Clip time the change starts.","minimum":0,"x-unit":"s"},"targetKph":{"type":"number","description":"Speed to reach; 0 brakes to a stop.","minimum":0,"maximum":160,"x-unit":"km/h"},"rateMps2":{"type":"number","description":"Acceleration or deceleration (default 4, at most the class limit: a car brakes at up to 8, speeds up at up to 3).","minimum":0.1,"maximum":20,"x-unit":"m/s²"},"endS":{"type":"number","description":"Clip time the event ends.","minimum":0,"x-unit":"s"}}},"AuthoringAddEncounterInput":{"type":"object","additionalProperties":false,"required":["type","kind","id"],"properties":{"type":{"const":"addEncounter","description":"Operation id."},"kind":{"type":"string","enum":["lead-brake","slow-lead","stopped","cut-in","crossing","oncoming","cross-traffic","reversing","pull-out","u-turn"],"description":"lead-brake: ahead in the target's lane, brakes to a stop at atS. slow-lead: ahead, slower. stopped: standing ahead in the lane. cut-in: from the lane on the target's side, into its lane from atS, starting gapM in front. crossing: a pedestrian on the target's path at atS (or at x,z), ttcS before the target. oncoming / cross-traffic: a car on the opposite / a crossing approach of a junction ahead crosses its path ttcS before it (the first junction whose movement enters within 30° of straight against / square to the target's heading, else the nearest to it). reversing: standing ahead, reverses toward the target from atS. pull-out: parked at the side edge of the target's lane gapM ahead, pulls into the lane at atS. u-turn: ahead in the target's lane gapM ahead, makes a U-turn at the first place it can (a mapped U-turn movement, else a path through a junction or across a road wide enough)."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"New actor id."},"catalogId":{"type":"string","description":"Built-in actor; default vehicle.sedan (box truck for reversing, pedestrian.adult for crossing)."},"target":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"The actor the encounter is with: a moving road vehicle on a lane.","default":"ego"},"atS":{"type":"number","description":"Clip time of the moment: lead-brake brake start (default 3), cut-in lane-change start (3), crossing time on the target's lane (4), reversing start (1), pull-out start (2).","minimum":0,"x-unit":"s"},"side":{"type":"string","enum":["left","right"],"description":"cut-in: the target's side the car comes from (required). crossing: the side the pedestrian starts on (default right). pull-out: the lane edge the car is parked at (default right)."},"gapM":{"type":"number","description":"Centre-to-centre distance ahead of the target: at the start (lead-brake 20, slow-lead 30, stopped 25, reversing 25, pull-out 30, u-turn 25) or when the cut-in starts (7).","minimum":0,"maximum":500,"x-unit":"m"},"speedKph":{"type":"number","description":"The new actor's speed: lead-brake the target's, slow-lead half of it, cut-in 10 faster, crossing walk 4.5, oncoming/cross-traffic the posted limit, reversing 6, pull-out 20, u-turn the target's within 15-30.","minimum":0,"maximum":160,"x-unit":"km/h"},"decelMps2":{"type":"number","description":"lead-brake deceleration (default 5.5, a hard stop that stays within comfort checks).","minimum":0.5,"maximum":12,"x-unit":"m/s²"},"ttcS":{"type":"number","description":"crossing, oncoming, cross-traffic: the target's time to the conflict point when the new actor is on it (crossing default 2, junctions 1.5; negative: after the target).","minimum":-10,"maximum":30,"x-unit":"s"},"turn":{"type":"string","enum":["left","right","straight"],"description":"oncoming / cross-traffic: the new car's movement through the junction (default straight)."},"x":{"type":"number","description":"crossing: a scene point on the target's path where the pedestrian crosses (a crosswalk), with z; replaces atS.","x-unit":"m"},"z":{"type":"number","description":"crossing: the point's scene z (minus north).","x-unit":"m"}}},"AuthoringSetEventTimingInput":{"type":"object","additionalProperties":false,"required":["type","id","startS"],"properties":{"type":{"const":"setEventTiming","description":"Operation id."},"id":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9_-]{0,63}$","description":"Event."},"startS":{"type":"number","description":"Start clip time.","minimum":0,"x-unit":"s"},"endS":{"type":"number","description":"End clip time.","minimum":0,"x-unit":"s"}}},"AuthoringSetWeatherInput":{"type":"object","additionalProperties":false,"required":["type","weather"],"properties":{"type":{"const":"setWeather","description":"Operation id."},"weather":{"type":"string","enum":["clear","cloudy","overcast","light_rain","heavy_rain","wet_road","fog_light","fog_dense","snow","sleet"],"description":"Canonical scenario weather."}}},"AuthoringSetClockInput":{"type":"object","additionalProperties":false,"required":["type","minutes"],"properties":{"type":{"const":"setClock","description":"Operation id."},"minutes":{"type":"integer","minimum":0,"maximum":1439,"description":"Minutes after local midnight.","x-unit":"min"}}},"AuthoringSetClipInput":{"type":"object","additionalProperties":false,"required":["type"],"properties":{"type":{"const":"setClip","description":"Operation id."},"clipSeconds":{"type":"number","description":"Clip length.","minimum":3,"maximum":120,"x-unit":"s"},"warmupSeconds":{"type":"number","description":"Warm-up before the clip.","minimum":0,"maximum":30,"x-unit":"s"}},"anyOf":[{"required":["clipSeconds"]},{"required":["warmupSeconds"]}]},"AuthoringTemplateOperationInput":{"type":"object","required":["type"],"properties":{"type":{"type":"string"}},"additionalProperties":true,"description":"Advanced existing TemplateOp request; common operations use the typed catalogue inputs."},"AuthoringOperationInput":{"anyOf":[{"$ref":"#/components/schemas/AuthoringAddActorInput"},{"$ref":"#/components/schemas/AuthoringMoveActorInput"},{"$ref":"#/components/schemas/AuthoringDuplicateActorInput"},{"$ref":"#/components/schemas/AuthoringRemoveRoleInput"},{"$ref":"#/components/schemas/AuthoringSetEgoInput"},{"$ref":"#/components/schemas/AuthoringSetActorSpeedInput"},{"$ref":"#/components/schemas/AuthoringSetActorStaticInput"},{"$ref":"#/components/schemas/AuthoringAddLaneChangeInput"},{"$ref":"#/components/schemas/AuthoringAddNextJunctionTurnInput"},{"$ref":"#/components/schemas/AuthoringAddUTurnInput"},{"$ref":"#/components/schemas/AuthoringSetWaypointRouteInput"},{"$ref":"#/components/schemas/AuthoringAddSpeedChangeInput"},{"$ref":"#/components/schemas/AuthoringAddEncounterInput"},{"$ref":"#/components/schemas/AuthoringSetEventTimingInput"},{"$ref":"#/components/schemas/AuthoringSetWeatherInput"},{"$ref":"#/components/schemas/AuthoringSetClockInput"},{"$ref":"#/components/schemas/AuthoringSetClipInput"},{"$ref":"#/components/schemas/AuthoringTemplateOperationInput"}]},"RenderRigOutputName":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"},"RenderRigVec3":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"},"z":{"type":"number"}},"required":["x","y","z"],"additionalProperties":false},"RenderRigTransform":{"type":"object","properties":{"position":{"$ref":"#/components/schemas/RenderRigVec3"},"rotation":{"default":{},"type":"object","properties":{"yawRad":{"default":0,"type":"number","minimum":-3.141593,"maximum":3.141593},"pitchRad":{"default":0,"type":"number","minimum":-1.5707963267948966,"maximum":1.5707963267948966},"rollRad":{"default":0,"type":"number","minimum":-3.141593,"maximum":3.141593}},"additionalProperties":false}},"required":["position"],"additionalProperties":false},"RenderRigSource":{"oneOf":[{"type":"object","properties":{"actorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorLabel":{"type":"string","minLength":1,"maxLength":200},"outputName":{"$ref":"#/components/schemas/RenderRigOutputName"},"transform":{"$ref":"#/components/schemas/RenderRigTransform"},"modality":{"type":"string","enum":["rgb","depth","semantic","instance"]},"mountFrame":{"type":"string","enum":["body","gimbal"]},"attributes":{"type":"object","properties":{"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"detector":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.hdr-detector-config/v1"},"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"noise":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-electron-ptc/v1"},"correlatedDetector":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-row-column-detector/v1"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fixedPatternSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"physicalInstanceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"epoch":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"rowFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rowReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000}},"required":["model","width","height","fixedPatternSeedHex","physicalInstanceId","epoch","rowFixedSigmaElectrons","columnFixedSigmaElectrons","rowReadSigmaElectrons","columnReadSigmaElectrons"],"additionalProperties":false},"electronsPerInputUnit":{"type":"number","minimum":1e-12,"maximum":1000000000000},"shotEnabled":{"type":"boolean"},"readSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rootSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"runNamespace":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"}},"required":["model","electronsPerInputUnit","shotEnabled","readSigmaElectrons","rootSeedHex","runNamespace"],"additionalProperties":false},"inputDomain":{"type":"string","const":"renderer-relative-scene-signal"},"responseGainPerRendererSignal":{"type":"number","exclusiveMinimum":0},"blackLevelNormalized":{"type":"number","minimum":0,"maximum":1},"bitDepth":{"anyOf":[{"type":"number","const":8},{"type":"number","const":10},{"type":"number","const":12},{"type":"number","const":16}]},"alphaPolicy":{"type":"string","const":"require-opaque-and-discard"}},"required":["schema","inputDomain","responseGainPerRendererSignal","blackLevelNormalized","bitDepth","alphaPolicy"],"additionalProperties":false},"temporal":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.camera-temporal-request/v1"},"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"noise":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-electron-ptc/v1"},"correlatedDetector":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-row-column-detector/v1"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fixedPatternSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"physicalInstanceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"epoch":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"rowFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rowReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000}},"required":["model","width","height","fixedPatternSeedHex","physicalInstanceId","epoch","rowFixedSigmaElectrons","columnFixedSigmaElectrons","rowReadSigmaElectrons","columnReadSigmaElectrons"],"additionalProperties":false},"electronsPerInputUnit":{"type":"number","minimum":1e-12,"maximum":1000000000000},"shotEnabled":{"type":"boolean"},"readSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rootSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"runNamespace":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"}},"required":["model","electronsPerInputUnit","shotEnabled","readSigmaElectrons","rootSeedHex","runNamespace"],"additionalProperties":false},"timing":{"type":"object","properties":{"height":{"type":"integer","minimum":1,"maximum":16384},"shutter":{"type":"string","enum":["global","rolling"]},"readoutDirection":{"type":"string","enum":["top-to-bottom","bottom-to-top"]},"readoutSeconds":{"type":"number","minimum":0,"maximum":60},"exposureSeconds":{"type":"number","exclusiveMinimum":0,"maximum":60},"processingLatencySeconds":{"type":"number","const":0}},"required":["height","shutter","readoutDirection","readoutSeconds","exposureSeconds","processingLatencySeconds"],"additionalProperties":false},"samplesPerRow":{"type":"integer","minimum":1,"maximum":4096},"response":{"type":"object","properties":{"inputDomain":{"type":"string","const":"renderer-relative-scene-signal-seconds"},"responseGainPerRendererSignalSecond":{"type":"number","exclusiveMinimum":0},"blackLevelNormalized":{"type":"number","minimum":0,"maximum":1},"bitDepth":{"anyOf":[{"type":"number","const":8},{"type":"number","const":10},{"type":"number","const":12},{"type":"number","const":16}]}},"required":["inputDomain","responseGainPerRendererSignalSecond","blackLevelNormalized","bitDepth"],"additionalProperties":false},"budgets":{"type":"object","properties":{"maxUniqueCaptures":{"type":"integer","minimum":1,"maximum":4096},"maxCapturePixels":{"type":"integer","minimum":1,"maximum":67108864},"maxCaptureBytes":{"type":"integer","minimum":1,"maximum":1073741824},"maxReductionReadBytes":{"type":"integer","minimum":1,"maximum":1073741824},"maxWeightedValues":{"type":"integer","minimum":1,"maximum":268435456},"maxSceneActorSamples":{"type":"integer","minimum":1,"maximum":262144},"maxResidentPixelBytes":{"type":"integer","minimum":1,"maximum":536870912},"maxRetainedBytes":{"type":"integer","minimum":1,"maximum":1073741824}},"required":["maxUniqueCaptures","maxCapturePixels","maxCaptureBytes","maxReductionReadBytes","maxWeightedValues","maxSceneActorSamples","maxResidentPixelBytes","maxRetainedBytes"],"additionalProperties":false}},"required":["schema","timing","samplesPerRow","response","budgets"],"additionalProperties":false},"width":{"type":"integer","minimum":64,"maximum":8192},"height":{"type":"integer","minimum":64,"maximum":8192},"fps":{"type":"number","exclusiveMinimum":0,"maximum":240},"horizontalFovDeg":{"type":"number","exclusiveMinimum":0,"maximum":180},"cameraModel":{"type":"object","properties":{"type":{"type":"string","const":"ftheta"},"referenceResolution":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"integer","minimum":1,"maximum":8192}},"principalPoint":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"number"}},"pixeldistToAnglePoly":{"minItems":2,"maxItems":8,"type":"array","items":{"type":"number"}},"angleToPixeldistPoly":{"type":"array","items":{"type":"number"}},"linearCde":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"number"}},"maxAngleRad":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":3.141592653589793}},"required":["type","referenceResolution","principalPoint","pixeldistToAnglePoly","maxAngleRad"],"additionalProperties":false},"nearM":{"type":"number","exclusiveMinimum":0},"farM":{"type":"number","exclusiveMinimum":0},"orthographicHeightM":{"type":"number","exclusiveMinimum":0,"maximum":10000}},"required":["width","height","fps","nearM","farM"],"additionalProperties":false},"sensorProfile":{"type":"string","const":"generic-rgb@1"},"reportedCalibration":{"type":"object","properties":{"transform":{"$ref":"#/components/schemas/RenderRigTransform"},"attributes":{"type":"object","properties":{"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"detector":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.hdr-detector-config/v1"},"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"noise":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-electron-ptc/v1"},"correlatedDetector":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-row-column-detector/v1"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fixedPatternSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"physicalInstanceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"epoch":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"rowFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rowReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000}},"required":["model","width","height","fixedPatternSeedHex","physicalInstanceId","epoch","rowFixedSigmaElectrons","columnFixedSigmaElectrons","rowReadSigmaElectrons","columnReadSigmaElectrons"],"additionalProperties":false},"electronsPerInputUnit":{"type":"number","minimum":1e-12,"maximum":1000000000000},"shotEnabled":{"type":"boolean"},"readSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rootSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"runNamespace":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"}},"required":["model","electronsPerInputUnit","shotEnabled","readSigmaElectrons","rootSeedHex","runNamespace"],"additionalProperties":false},"inputDomain":{"type":"string","const":"renderer-relative-scene-signal"},"responseGainPerRendererSignal":{"type":"number","exclusiveMinimum":0},"blackLevelNormalized":{"type":"number","minimum":0,"maximum":1},"bitDepth":{"anyOf":[{"type":"number","const":8},{"type":"number","const":10},{"type":"number","const":12},{"type":"number","const":16}]},"alphaPolicy":{"type":"string","const":"require-opaque-and-discard"}},"required":["schema","inputDomain","responseGainPerRendererSignal","blackLevelNormalized","bitDepth","alphaPolicy"],"additionalProperties":false},"temporal":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.camera-temporal-request/v1"},"captureStage":{"type":"string","const":"scene-pre-postprocess/v1"},"noise":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-electron-ptc/v1"},"correlatedDetector":{"type":"object","properties":{"model":{"type":"string","const":"gaussian-row-column-detector/v1"},"width":{"type":"integer","minimum":1,"maximum":16384},"height":{"type":"integer","minimum":1,"maximum":16384},"fixedPatternSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"physicalInstanceId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"epoch":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"},"rowFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnFixedSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rowReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"columnReadSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000}},"required":["model","width","height","fixedPatternSeedHex","physicalInstanceId","epoch","rowFixedSigmaElectrons","columnFixedSigmaElectrons","rowReadSigmaElectrons","columnReadSigmaElectrons"],"additionalProperties":false},"electronsPerInputUnit":{"type":"number","minimum":1e-12,"maximum":1000000000000},"shotEnabled":{"type":"boolean"},"readSigmaElectrons":{"type":"number","minimum":0,"maximum":1000000},"rootSeedHex":{"type":"string","pattern":"^[a-f0-9]{64}$"},"runNamespace":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"}},"required":["model","electronsPerInputUnit","shotEnabled","readSigmaElectrons","rootSeedHex","runNamespace"],"additionalProperties":false},"timing":{"type":"object","properties":{"height":{"type":"integer","minimum":1,"maximum":16384},"shutter":{"type":"string","enum":["global","rolling"]},"readoutDirection":{"type":"string","enum":["top-to-bottom","bottom-to-top"]},"readoutSeconds":{"type":"number","minimum":0,"maximum":60},"exposureSeconds":{"type":"number","exclusiveMinimum":0,"maximum":60},"processingLatencySeconds":{"type":"number","const":0}},"required":["height","shutter","readoutDirection","readoutSeconds","exposureSeconds","processingLatencySeconds"],"additionalProperties":false},"samplesPerRow":{"type":"integer","minimum":1,"maximum":4096},"response":{"type":"object","properties":{"inputDomain":{"type":"string","const":"renderer-relative-scene-signal-seconds"},"responseGainPerRendererSignalSecond":{"type":"number","exclusiveMinimum":0},"blackLevelNormalized":{"type":"number","minimum":0,"maximum":1},"bitDepth":{"anyOf":[{"type":"number","const":8},{"type":"number","const":10},{"type":"number","const":12},{"type":"number","const":16}]}},"required":["inputDomain","responseGainPerRendererSignalSecond","blackLevelNormalized","bitDepth"],"additionalProperties":false},"budgets":{"type":"object","properties":{"maxUniqueCaptures":{"type":"integer","minimum":1,"maximum":4096},"maxCapturePixels":{"type":"integer","minimum":1,"maximum":67108864},"maxCaptureBytes":{"type":"integer","minimum":1,"maximum":1073741824},"maxReductionReadBytes":{"type":"integer","minimum":1,"maximum":1073741824},"maxWeightedValues":{"type":"integer","minimum":1,"maximum":268435456},"maxSceneActorSamples":{"type":"integer","minimum":1,"maximum":262144},"maxResidentPixelBytes":{"type":"integer","minimum":1,"maximum":536870912},"maxRetainedBytes":{"type":"integer","minimum":1,"maximum":1073741824}},"required":["maxUniqueCaptures","maxCapturePixels","maxCaptureBytes","maxReductionReadBytes","maxWeightedValues","maxSceneActorSamples","maxResidentPixelBytes","maxRetainedBytes"],"additionalProperties":false}},"required":["schema","timing","samplesPerRow","response","budgets"],"additionalProperties":false},"width":{"type":"integer","minimum":64,"maximum":8192},"height":{"type":"integer","minimum":64,"maximum":8192},"fps":{"type":"number","exclusiveMinimum":0,"maximum":240},"horizontalFovDeg":{"type":"number","exclusiveMinimum":0,"maximum":180},"cameraModel":{"type":"object","properties":{"type":{"type":"string","const":"ftheta"},"referenceResolution":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"integer","minimum":1,"maximum":8192}},"principalPoint":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"number"}},"pixeldistToAnglePoly":{"minItems":2,"maxItems":8,"type":"array","items":{"type":"number"}},"angleToPixeldistPoly":{"type":"array","items":{"type":"number"}},"linearCde":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"number"}},"maxAngleRad":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":3.141592653589793}},"required":["type","referenceResolution","principalPoint","pixeldistToAnglePoly","maxAngleRad"],"additionalProperties":false},"nearM":{"type":"number","exclusiveMinimum":0},"farM":{"type":"number","exclusiveMinimum":0},"orthographicHeightM":{"type":"number","exclusiveMinimum":0,"maximum":10000}},"required":["width","height","fps","nearM","farM"],"additionalProperties":false}},"required":["transform","attributes"],"additionalProperties":false}},"required":["actorId","sensorId","outputName","transform","modality","attributes"],"additionalProperties":false},{"type":"object","properties":{"actorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorLabel":{"type":"string","minLength":1,"maxLength":200},"outputName":{"$ref":"#/components/schemas/RenderRigOutputName"},"transform":{"$ref":"#/components/schemas/RenderRigTransform"},"modality":{"type":"string","const":"lidar"},"attributes":{"type":"object","properties":{"observationRun":{"oneOf":[{"type":"object","properties":{"schema":{"type":"string","const":"simforge.cloud-lidar-observation/v1"},"profile":{"type":"string","const":"generic-uniform-cpu/v1"},"geometryPolicy":{"type":"string","const":"authored-dimension-primitives/v1"},"trajectoryKeyIntervalNs":{"type":"integer","minimum":1,"maximum":10000000000},"deliveryDelayNs":{"type":"integer","minimum":0,"maximum":10000000000},"consumerArchiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"rangeEstimation":{"type":"object","properties":{"effectId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"randomNamespace":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"seed":{"type":"integer","minimum":0,"maximum":9007199254740991},"biasM":{"type":"number","minimum":-3.4028234663852886e+38,"maximum":3.4028234663852886e+38},"uniformHalfWidthM":{"type":"number","minimum":0,"maximum":3.4028234663852886e+38},"profileRef":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.lidar-fitted-reference-ref/v1"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sizeBytes":{"type":"integer","minimum":1,"maximum":1048576}},"required":["schema","sha256","sizeBytes"],"additionalProperties":false}},"required":["effectId","randomNamespace","seed","biasM","uniformHalfWidthM"],"additionalProperties":false},"channelFault":{"type":"object","properties":{"effectId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"channel":{"type":"integer","minimum":0,"maximum":255},"startNs":{"type":"integer","minimum":0,"maximum":9007199254740991},"endNs":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["effectId","channel","startNs","endNs"],"additionalProperties":false},"engineering":{"type":"object","properties":{"archiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"truthArchiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"queryProvenance":{"type":"object","properties":{"maxUniqueTriangles":{"type":"integer","minimum":1,"maximum":4000000},"maxInstances":{"type":"integer","minimum":1,"maximum":65536}},"required":["maxUniqueTriangles","maxInstances"],"additionalProperties":false}},"required":["archiveByteLimit","truthArchiveByteLimit"],"additionalProperties":false}},"required":["schema","profile","geometryPolicy","trajectoryKeyIntervalNs","deliveryDelayNs","consumerArchiveByteLimit"],"additionalProperties":false},{"type":"object","properties":{"schema":{"type":"string","const":"simforge.cloud-lidar-observation/v2"},"profile":{"type":"string","const":"generic-uniform-response-cpu/v1"},"geometryPolicy":{"type":"string","const":"authored-dimension-primitives/v1"},"trajectoryKeyIntervalNs":{"type":"integer","minimum":1,"maximum":10000000000},"deliveryDelayNs":{"type":"integer","minimum":0,"maximum":10000000000},"consumerArchiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"rangeEstimation":{"type":"object","properties":{"effectId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"randomNamespace":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"seed":{"type":"integer","minimum":0,"maximum":9007199254740991},"biasM":{"type":"number","minimum":-3.4028234663852886e+38,"maximum":3.4028234663852886e+38},"uniformHalfWidthM":{"type":"number","minimum":0,"maximum":3.4028234663852886e+38},"profileRef":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.lidar-fitted-reference-ref/v1"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"sizeBytes":{"type":"integer","minimum":1,"maximum":1048576}},"required":["schema","sha256","sizeBytes"],"additionalProperties":false}},"required":["effectId","randomNamespace","seed","biasM","uniformHalfWidthM"],"additionalProperties":false},"channelFault":{"type":"object","properties":{"effectId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"channel":{"type":"integer","minimum":0,"maximum":255},"startNs":{"type":"integer","minimum":0,"maximum":9007199254740991},"endNs":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["effectId","channel","startNs","endNs"],"additionalProperties":false},"engineering":{"type":"object","properties":{"archiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"truthArchiveByteLimit":{"type":"integer","minimum":1,"maximum":1073741824},"queryProvenance":{"type":"object","properties":{"maxUniqueTriangles":{"type":"integer","minimum":1,"maximum":4000000},"maxInstances":{"type":"integer","minimum":1,"maximum":65536}},"required":["maxUniqueTriangles","maxInstances"],"additionalProperties":false}},"required":["archiveByteLimit","truthArchiveByteLimit"],"additionalProperties":false},"receiverResponse":{"type":"object","properties":{"schema":{"type":"string","const":"simforge.generic-lidar-receiver-response/v1"},"effectId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"},"enabled":{"type":"boolean"},"minSignal":{"type":"number","minimum":0,"maximum":3.4028234663852886e+38},"materialResponses":{"maxItems":7,"type":"array","items":{"type":"object","properties":{"material":{"type":"string","enum":["unknown","asphalt","lane_marking","retroreflective_sign","vehicle_paint","vegetation","building"]},"reflectivity":{"type":"number","minimum":0,"maximum":1}},"required":["material","reflectivity"],"additionalProperties":false}}},"required":["schema","effectId","enabled","minSignal","materialResponses"],"additionalProperties":false}},"required":["schema","profile","geometryPolicy","trajectoryKeyIntervalNs","deliveryDelayNs","consumerArchiveByteLimit","receiverResponse"],"additionalProperties":false}]},"minimumRangeM":{"type":"number","minimum":0},"returnMode":{"type":"string","const":"single"},"channels":{"type":"integer","minimum":1,"maximum":256},"rangeM":{"type":"number","exclusiveMinimum":0,"maximum":1000},"pointsPerSecond":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"rotationFrequencyHz":{"type":"number","exclusiveMinimum":0,"maximum":240},"upperFovDeg":{"type":"number","minimum":-180,"maximum":180},"lowerFovDeg":{"type":"number","minimum":-180,"maximum":180},"horizontalFovDeg":{"default":360,"type":"number","minimum":5,"maximum":360}},"required":["channels","rangeM","pointsPerSecond","rotationFrequencyHz","upperFovDeg","lowerFovDeg"],"additionalProperties":false}},"required":["actorId","sensorId","outputName","transform","modality","attributes"],"additionalProperties":false},{"type":"object","properties":{"actorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorLabel":{"type":"string","minLength":1,"maxLength":200},"outputName":{"$ref":"#/components/schemas/RenderRigOutputName"},"transform":{"$ref":"#/components/schemas/RenderRigTransform"},"modality":{"type":"string","const":"radar"},"attributes":{"type":"object","properties":{"horizontalFovDeg":{"type":"number","exclusiveMinimum":0,"maximum":180},"verticalFovDeg":{"type":"number","exclusiveMinimum":0,"maximum":180},"rangeM":{"type":"number","exclusiveMinimum":0,"maximum":1000},"pointsPerSecond":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["horizontalFovDeg","verticalFovDeg","rangeM","pointsPerSecond"],"additionalProperties":false}},"required":["actorId","sensorId","outputName","transform","modality","attributes"],"additionalProperties":false},{"type":"object","properties":{"actorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"sensorLabel":{"type":"string","minLength":1,"maxLength":200},"outputName":{"$ref":"#/components/schemas/RenderRigOutputName"},"transform":{"$ref":"#/components/schemas/RenderRigTransform"},"modality":{"type":"string","const":"topdown"},"attributes":{"type":"object","properties":{"width":{"type":"integer","minimum":320,"maximum":3840},"height":{"type":"integer","minimum":240,"maximum":2160},"fps":{"type":"number","exclusiveMinimum":0,"maximum":120},"camera":{"type":"string","enum":["follow-ego","overview"]},"northUp":{"type":"boolean"},"pxPerM":{"type":"number","exclusiveMinimum":0,"maximum":100}},"required":["width","height","fps","camera"],"additionalProperties":false}},"required":["actorId","sensorId","outputName","transform","modality","attributes"],"additionalProperties":false}]},"RenderRig":{"$comment":"GENERATED from RenderRigV1Schema by `pnpm --filter @simforge/scenario schema:render-rig`. Do not edit.","title":"simforge.render-rig/v1","description":"Actor-mounted capture sources. Consumers also enforce unique actor/sensor/modality identities and output names, reject topdown rig sources, and check cross-field camera and scan constraints.","type":"object","properties":{"schema":{"type":"string","const":"simforge.render-rig/v1"},"sources":{"minItems":1,"maxItems":64,"type":"array","items":{"$ref":"#/components/schemas/RenderRigSource"}},"sensorHosts":{"minItems":1,"maxItems":64,"type":"array","items":{"type":"object","properties":{"sourceId":{"$ref":"#/components/schemas/RenderRigOutputName"},"actorId":{"type":"string","pattern":"^[0-9A-Za-z][0-9A-Za-z_-]{0,63}$"},"vehicleAsset":{"type":"object","properties":{"catalogAssetId":{"type":"string","minLength":1,"maxLength":200}},"required":["catalogAssetId"],"additionalProperties":{}}},"required":["sourceId","actorId","vehicleAsset"],"additionalProperties":false}},"clip":{"type":"object","properties":{"startSeconds":{"type":"number","minimum":0},"endSeconds":{"type":"number","exclusiveMinimum":0}},"required":["startSeconds","endSeconds"],"additionalProperties":false},"video":{"type":"object","properties":{"width":{"type":"integer","minimum":64,"maximum":8192},"height":{"type":"integer","minimum":64,"maximum":8192},"fps":{"type":"number","exclusiveMinimum":0,"maximum":240},"container":{"type":"string","enum":["mp4","webm"]},"codec":{"type":"string","enum":["h264","vp9","av1"]},"quality":{"type":"string","enum":["draft","standard","high","lossless"]}},"required":["width","height","fps","container","codec","quality"],"additionalProperties":false}},"required":["schema","sources"],"additionalProperties":false,"examples":[{"schema":"simforge.render-rig/v1","sources":[{"actorId":"ego","sensorId":"cam-front","outputName":"cam-front","transform":{"position":{"x":1.6,"y":1.45,"z":0},"rotation":{"yawRad":0,"pitchRad":-0.0524,"rollRad":0}},"modality":"rgb","attributes":{"width":1280,"height":720,"fps":20,"horizontalFovDeg":90,"nearM":0.05,"farM":1000}}]}]},"RenderRunInput":{"type":"object","additionalProperties":false,"required":["scenarioId","engine"],"description":"The input of a `render` run: a scenario of the workspace (at a revision) rendered by the 3D Helios engine through a sensor rig.","properties":{"scenarioId":{"type":"string","minLength":1,"description":"A scenario of the workspace (`GET /api/v1/scenarios`)."},"revisionId":{"type":"string","minLength":1,"description":"An immutable revision of it. Default: the scenario's current revision."},"engine":{"enum":["3d"],"description":"`3d`: the Helios Engine (GPU); the schematic look is `3d` with `preset: schematic`."},"preset":{"type":"string","minLength":1,"description":"`training`, `showcase` or `schematic` (3D only). Default for a hosted 3D render: `training`."},"rig":{"description":"A complete simforge.render-rig/v1 rig. Default: the built-in front camera on the scenario's ego.","$ref":"#/components/schemas/RenderRig"},"outputs":{"enum":["video","stills"],"description":"`video` (default): one MP4 per sensor. `stills`: the RGB frames as PNGs (a preview)."},"replayOf":{"type":"string","pattern":"^run_","description":"A succeeded `closed_loop` run of this scenario: render the drive that run scored (its episode's render timeline, `GET /api/v1/runs/{id}/replay`) instead of the scenario's own simulation. The render is pinned to that run's revision."},"rigs":{"type":"array","minItems":1,"maxItems":16,"description":"Several ego actors (3D): which rig each ego carries, every source of `rig` hosted by one of them. `rigId` is a built-in sensor rig that fits the actor's kind (a car, truck, bus, van or motorcycle takes road rigs, a drone drone rigs), or `custom` for a rig file. Each actor must be an ego of the scenario (its `ego`, or a role marked `org.simforge.ego.v1`). Absent: one ego, every source mounted on it.","items":{"type":"object","additionalProperties":false,"required":["actorId","rigId"],"properties":{"actorId":{"type":"string","minLength":1},"rigId":{"type":"string","minLength":1}}}},"horizonSeconds":{"type":"number","minimum":3,"maximum":120,"description":"Simulate and render the scenario to this many seconds (3D). A scenario authored shorter is simulated on past its end without being edited: its authored vehicles drive on as traffic, and the run warns `simulated_past_authored_end`. At or under the scenario's clip, or absent: the scenario's own clip."},"egoDynamics":{"enum":["dynamic-v1","kinematic-bicycle","full-car-v1"],"description":"The ego's dynamics model for the simulation (3D; API version 2026-10-29 or later, earlier versions refuse it with `ego_dynamics_unavailable`). A render accepts `dynamic-v1`; `kinematic-bicycle` is `ego_dynamics_unsupported` here and `full-car-v1` is `ego_dynamics_unavailable` until admitted. Absent: `dynamic-v1`, with the input unchanged. Not allowed with `replayOf` (`ego_dynamics_conflict`)."},"egoVehicle":{"type":"object","minProperties":1,"description":"Which catalog vehicle each ego actor is parameterised as, keyed by actor id (3D; API version 2026-10-29 or later). An omitted ego uses its own catalog id. An unknown id is `ego_vehicle_unsupported`; a catalog id with no dynamics pack is refused the same way.","additionalProperties":{"type":"string","minLength":1,"maxLength":200}}}}},"parameters":{},"securitySchemes":{"simforgeToken":{"type":"http","scheme":"bearer","description":"A `sfc_at_…` access token from `simforge login`, or an `sfk_…` API key. An operation's security lists the scopes the credential must hold."}}},"paths":{"/api/v1/uploads":{"post":{"operationId":"createUpload","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRequest"}}}},"responses":{"201":{"description":"Created upload grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create an upload","tags":["Recordings and uploads"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/recordings":{"post":{"operationId":"createRecording","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordingCreateRequest"}}}},"responses":{"201":{"description":"Stored recording (idempotent by digest).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Recording"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Store a recording","tags":["Recordings and uploads"],"security":[{"simforgeToken":["scenarios:write"]}]}},"/api/v1/recordings/{sha256}":{"get":{"operationId":"getRecording","parameters":[{"in":"path","name":"sha256","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Recording and a time-limited download URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordingDownload"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a recording","tags":["Recordings and uploads"],"security":[{"simforgeToken":["scenarios:read"]}]}},"/api/v1/scenarios":{"get":{"operationId":"listScenarios","description":"List scenarios in the current workspace","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Scenarios.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioPage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List scenarios","tags":["Scenarios"],"security":[{"simforgeToken":["scenarios:read"]}]}},"/api/v1/scenarios/{id}":{"get":{"operationId":"getScenario","description":"Get a scenario in the current workspace","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Scenario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioDetail"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a scenario","tags":["Scenarios"],"security":[{"simforgeToken":["scenarios:read"]}]}},"/api/v1/scenarios/{id}/copy":{"post":{"operationId":"copyScenario","description":"Copy a scenario: an independent copy of its current draft (map pin, actors, timeline, settings and render rig) as a fresh draft whose lineage names the original; renders, runs and transfers are not copied. It lands in `datasetId`, else the original's dataset when the caller may write there, else the caller's default dataset (a read-only dataset is never written), named `<name> (copy)` (`(copy 2)`, ... when taken) unless `name` is given. An `Idempotency-Key` header makes it one copy per key: a repeat answers the same copy with 200, and a key already used for another scenario's copy is 409 `idempotency_conflict`. A map version that is no longer its map's latest is 409 `conflict` (`detail.code: scenario_map_version_not_latest`).","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioCopyRequest"}}}},"responses":{"200":{"description":"The copy an earlier request with this Idempotency-Key made.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioCopy"}}}},"201":{"description":"The new copy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioCopy"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Copy a scenario","tags":["Scenarios"],"security":[{"simforgeToken":["scenarios:write"]}]}},"/api/cli/scenarios/{documentId}":{"get":{"operationId":"pullCliScenario","description":"One scenario of the session's workspace as the editor stores it (`simforge scenario pull`). Unknown and inaccessible ids are the same 404.","parameters":[{"in":"path","name":"documentId","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$"}}],"responses":{"200":{"description":"The scenario.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliScenarioDocument"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Pull a scenario document","tags":["Scenarios"],"security":[{"simforgeToken":["scenarios:read"]}]}},"/api/cli/metadata":{"get":{"operationId":"getCliAuthorizationServer","description":"RFC 8414 authorization server metadata, also served at `/.well-known/oauth-authorization-server`. The CLI knows only the host's name and reads every endpoint here; an AI agent reads the auth.md `agent_auth` block.","responses":{"200":{"description":"The server's endpoints, scopes and grants.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliAuthorizationServerMetadata"}}}}},"summary":"Authorization server metadata","tags":["Sign-in"],"security":[]}},"/api/cli/device/code":{"post":{"operationId":"createCliDeviceCode","description":"RFC 8628 device authorization (`simforge login --device`). Show `user_code` to the person, who approves it at `verification_uri` in a signed-in browser; then poll the token endpoint every `interval` seconds.","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CliDeviceCodeRequest"}}}},"responses":{"200":{"description":"A device code to poll with and a user code to confirm.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliDeviceCodeResponse"}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Start a device sign-in","tags":["Sign-in"],"security":[]}},"/api/cli/token":{"post":{"operationId":"createCliToken","description":"The token endpoint (RFC 6749). The public `simforge-cli` client (its `client_id` required): the device code grant, `authorization_code` with PKCE, and rotating `refresh_token`. An AI agent (auth.md, no `client_id`): the claim grant `urn:workos:agent-auth:grant-type:claim`, polling its registration, and the JWT-bearer grant (RFC 7523) re-exchanging the identity assertion the claim grant returned; agents get no refresh token. Unauthenticated by design: each grant is bound by a device code, PKCE, a claim token, an assertion this host signed, or an unspent refresh token. While the person has not approved yet, the device and claim grants answer `authorization_pending` (or `slow_down`).","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CliTokenRequest"}}}},"responses":{"200":{"description":"A CLI session's access and refresh tokens; an agent's first access token and identity assertion (claim grant); or a fresh access token (JWT-bearer grant).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CliTokenResponse"},{"$ref":"#/components/schemas/AgentClaimTokenResponse"},{"$ref":"#/components/schemas/AgentJwtBearerTokenResponse"}]}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Exchange a grant for tokens","tags":["Sign-in"],"security":[]}},"/api/cli/revoke":{"post":{"operationId":"revokeCliToken","description":"RFC 7009 revocation (`simforge logout`, an agent's sign-out). An access or refresh token, or an agent's identity assertion, ends its whole session. Always 200 for a well-formed request, whether or not the token was known.","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CliRevokeRequest"}}}},"responses":{"200":{"description":"Revoked (or unknown).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Revoke a session","tags":["Sign-in"],"security":[]}},"/api/cli/protected-resource":{"get":{"operationId":"getProtectedResourceMetadata","description":"RFC 9728 protected resource metadata of `/api/v1`, also served at `/.well-known/oauth-protected-resource` (the URL every `/api/v1` 401 names in `WWW-Authenticate: Bearer resource_metadata=…`) and `/.well-known/oauth-protected-resource/api/v1`.","responses":{"200":{"description":"The resource, its authorization server and scopes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtectedResourceMetadata"}}}}},"summary":"Protected resource metadata","tags":["Sign-in"],"security":[]}},"/auth.md":{"get":{"operationId":"getAuthMd","description":"The auth.md recipe (https://workos.com/auth-md) for this host, also at `/.well-known/auth.md`: how an AI agent registers, is approved by a person and calls `/api/v1`. Generated from the same source as the metadata.","responses":{"200":{"description":"The recipe.","content":{"text/markdown":{"schema":{"type":"string"}}}}},"summary":"The agent sign-in recipe (auth.md)","tags":["Sign-in"],"security":[]}},"/agent/identity":{"post":{"operationId":"createAgentRegistration","description":"auth.md Step 3. `service_auth`: an AI agent registers for the account `login_hint` names; show the person `claim.verification_uri` and `claim.user_code` (only that account, signed in with a verified email, can approve it), then poll the token endpoint with the claim grant. `identity_assertion`: an ID-JAG from a trusted agent provider (`issuer_not_enabled` while none is); it never creates or verifies an account. The first ID-JAG of a provider subject answers `401 interaction_required` with a claim ceremony; once the person confirmed the link, an ID-JAG answers an identity assertion valid for at most an hour. `401 login_required` when `auth_time` is missing or over an hour old. Refusals carry `detail.reason`. `anonymous` answers `anonymous_not_enabled`. 10 registrations per address per minute; 30 ID-JAGs per provider subject per 10 minutes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentIdentityRequest"}}}},"responses":{"200":{"description":"A `service_auth` registration and its first user code, or an identity assertion for a linked provider subject.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/AgentIdentityResponse"},{"$ref":"#/components/schemas/AgentAssertionResponse"}]}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"`interaction_required` (the person confirms the first link; `WWW-Authenticate: AgentAuth error=\"interaction_required\"`), or `login_required` with `max_age` (an OAuth error object).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentInteractionRequired"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"503":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Register an AI agent","tags":["Sign-in"],"security":[]}},"/agent/event/notify":{"post":{"operationId":"receiveAgentSecurityEvent","description":"auth.md `events_endpoint` (present while an agent provider is trusted): the provider pushes a Security Event Token (RFC 8417, RFC 8935 push delivery), signed by its pinned JWKS with this issuer as `aud`. The identity-assertion revoked event revokes every session of its (provider, subject): their access tokens and identity assertions. Errors are `{err, description}` (RFC 8935 section 2.4).","requestBody":{"required":true,"content":{"application/secevent+jwt":{"schema":{"type":"string"}}}},"responses":{"202":{"description":"Processed (unknown event types are accepted and ignored)."},"400":{"description":"Refused: `err` is `invalid_request`, `invalid_key`, `invalid_issuer`, `invalid_audience` or `authentication_failed`.","content":{"application/json":{"schema":{"type":"object","properties":{"err":{"type":"string"},"description":{"type":"string"}},"required":["err","description"]}}}},"429":{"description":"Too many deliveries."}},"summary":"Receive an agent provider's revocation event","tags":["Sign-in"],"security":[]}},"/agent/identity/claim":{"post":{"operationId":"reissueAgentClaim","description":"auth.md Step 4: a fresh user code and verification link for a registration still waiting for its person; the previous ones stop working. `invalid_claim_token` (401), `claimed_or_in_flight` (409), `claim_expired` (410, after 24 hours).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClaimRequest"}}}},"responses":{"200":{"description":"The new claim attempt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClaimResponse"}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"409":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"410":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Re-mint an agent's user code","tags":["Sign-in"],"security":[]}},"/api/cli/userinfo":{"get":{"operationId":"getCliUserinfo","description":"The account, organization, workspace and scopes behind a CLI access token (`simforge whoami`, `simforge auth status`).","responses":{"200":{"description":"The session behind the bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliUserinfo"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Get the signed-in session","tags":["Sign-in"],"security":[{"simforgeToken":[]}]}},"/api/v1/health":{"get":{"operationId":"health","description":"Check Cloud API availability","responses":{"200":{"description":"The API is up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"summary":"Check availability","tags":["Account"],"security":[]}},"/api/v1/me":{"get":{"operationId":"getMe","responses":{"200":{"description":"Current principal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get the current principal","tags":["Account"],"security":[{"simforgeToken":[]}]}},"/api/v1/status":{"get":{"operationId":"getStatus","description":"System status for any signed-in caller: component health, worker counts per class, queue depths and incidents. Counts only, the same for every caller, refreshed at most every 20 seconds.","responses":{"200":{"description":"System status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get system status","tags":["Account"],"security":[{"simforgeToken":[]}]}},"/api/v1/workspaces":{"get":{"operationId":"listWorkspaces","responses":{"200":{"description":"Available workspaces.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspacesResponse"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List workspaces","tags":["Account"],"security":[{"simforgeToken":[]}]}},"/api/v1/api-keys":{"get":{"operationId":"listApiKeys","responses":{"200":{"description":"Workspace API keys.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyListResponse"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List API keys","tags":["Account"],"security":[{"simforgeToken":[]}]},"post":{"operationId":"createApiKey","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"}}}},"responses":{"201":{"description":"Created API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create an API key","tags":["Account"],"security":[{"simforgeToken":[]}]}},"/api/v1/api-keys/{id}":{"delete":{"operationId":"revokeApiKey","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"API key revoked."},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Revoke an API key","tags":["Account"],"security":[{"simforgeToken":[]}]}},"/api/v1/usage":{"get":{"operationId":"getUsage","parameters":[{"in":"query","name":"from","required":false,"description":"An ISO date or date-time (default 30 days ago).","schema":{"type":"string","minLength":1}},{"in":"query","name":"to","required":false,"description":"An ISO date or date-time after `from` (default tomorrow).","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Cloud run usage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get usage","tags":["Account"],"security":[{"simforgeToken":["usage:read"]}]}},"/api/v1/feedback":{"post":{"operationId":"sendFeedback","description":"Send a feedback ticket (a bug, an idea or a question) from the CLI or Studio. Any credential (API key, CLI login, session) or none: an anonymous sender may leave an email. Credentials in the text are redacted before it is stored. At most 10 tickets per account, or 5 per address without a credential, per hour","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackInput"}}}},"responses":{"200":{"description":"The stored ticket.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackReceipt"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Send a feedback ticket","tags":["Account"],"security":[{},{"simforgeToken":[]}]}},"/api/v1/runs":{"get":{"operationId":"listRuns","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"in":"query","name":"status","required":false,"description":"`active`: queued or running.","schema":{"type":"string","enum":["queued","running","succeeded","partial","failed","cancelled","active"]}},{"in":"query","name":"type","required":false,"schema":{"type":"string"}},{"in":"query","name":"since","required":false,"description":"Runs created at or after this ISO 8601 time.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"createdBy","required":false,"description":"`me`: only the runs the caller submitted in this workspace (no teammate's, none published from other workspaces).","schema":{"type":"string","enum":["me"]}},{"in":"query","name":"jobs","required":false,"description":"`true`: only jobs, leaving out 2D renders (the browser's visualization of the data).","schema":{"type":"string","enum":["true"]}},{"in":"query","name":"published","required":false,"description":"`true`: also the runs SimForge published to every workspace (public benchmarks; `createdBy` null). Without it the list holds only this workspace's runs. Not with `createdBy`.","schema":{"type":"string","enum":["true"]}},{"in":"query","name":"view","required":false,"description":"`summary` (default): one RunSummary row per run. `full`: whole Run objects.","schema":{"type":"string","enum":["summary","full"],"default":"summary"}}],"responses":{"200":{"description":"Runs, newest first: RunSummary rows, or Run objects with view=full.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RunPage"},{"$ref":"#/components/schemas/RunFullPage"}]}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List runs","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]},"post":{"operationId":"createRun","description":"Start a run; dryRun returns the quote without work. Driving evaluations use type closed_loop with datasetId, explicit scenarioIds and policy {kind:model_version,family,modelVersionId} naming an available model of GET /api/v1/evaluation-options (its id and family); each scenario costs that model's pricePerScenarioCents, preparation included. Other evaluation kinds and models remain 403 evaluation_launch_disabled. Paid submissions require maxCostCents and Idempotency-Key. Admission atomically checks balance and reserves the whole quote before work; insufficient credits return 402. Unserved work returns 403 cloud_not_open. Reusing the same key and request returns the original run.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreateRequest"}}}},"responses":{"200":{"description":"Quote or idempotent replay, including managed driving evaluations.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Run"},{"$ref":"#/components/schemas/DryRunResponse"},{"$ref":"#/components/schemas/Evaluation"},{"$ref":"#/components/schemas/EvaluationQuote"}]}}}},"201":{"description":"Created run or canonical managed evaluation.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Run"},{"$ref":"#/components/schemas/Evaluation"}]}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"`insufficient_credits`: the workspace's credits do not cover the estimate (`detail.requestedCents`, `detail.balanceCents`, `detail.creditsUrl`, `detail.checkout`); or `budget_exceeded`: the estimate is above the request's `maxCostCents` (`detail.limit` `max_cost`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"`cloud_not_open`: SimForge Cloud is off here, or no worker here runs the work yet (the reason names it, `detail.code` `run_kind_unavailable`, `detail.kinds` its job kinds); or `insufficient_scope`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create a run","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/evaluation-options":{"get":{"operationId":"getEvaluationChoices","description":"The driving models SimForge offers for evaluation, caller-owned saved scenarios on accessible maps, and available credit balance. Each of models[] is one offered model version: its id (the modelVersionId a run pins), name, family, whether it can run now (available, with a reason when not: coming soon, or no worker serving it right now) and its own closed-loop price, pricePerScenarioCents (null while it has none; such a model is not available). The top-level pricePerScenarioCents is the standard price. Requires run permission. This grants no map or dataset access.","parameters":[{"in":"query","name":"datasetId","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation choices and balance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationChoices"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Choose a driving evaluation","tags":["Runs"],"security":[{"simforgeToken":["runs:write","datasets:read","scenarios:read","maps:read"]}]}},"/api/v1/runs/{id}":{"get":{"operationId":"getRun","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a run","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/runs/{id}/events":{"get":{"operationId":"listRunEvents","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"after","required":false,"schema":{"type":"integer","minimum":0}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000}},{"in":"query","name":"wait","required":false,"description":"Seconds to wait for the run's next event when none follows `after` (long poll); 0 answers at once.","schema":{"type":"integer","minimum":0,"maximum":20}}],"responses":{"200":{"description":"Run events.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEventsResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List run events","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/runs/{id}/cancel":{"post":{"operationId":"cancelRun","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cancelled run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Cancel a run","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/runs/{id}/session-token":{"post":{"operationId":"createSessionToken","description":"A credential for attaching to the run's cloud session. It must be presented within its `expiresAt` (5 minutes, or sooner when the session's lease is nearer its end: usually under two minutes); once attached, a client stays attached for as long as the session runs. It is bound to the session's lease and registered endpoint and to the caller, and stops working the moment the session ends, the run is cancelled, the lease or endpoint changes, or the caller loses access to the workspace or has its API key revoked. Shown once; mint another to attach again. Needs the `sessions:write` scope; for one release a credential that holds `runs:write` is accepted too (deprecated: it will be refused after the next release). At most 20 per minute per run (429). A run that is not a session, another workspace's run, and a deployment without cloud sessions are all 404; a session that has not started or registered its endpoint, or is no longer live, is 409.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A session credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionToken"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Mint a credential to attach to a run's session","tags":["Runs"],"security":[{"simforgeToken":["sessions:write"]}]}},"/api/v1/runs/{id}/artifacts":{"get":{"operationId":"listRunArtifacts","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"rendition","required":false,"description":"`preview`: each video also carries `playback`, a short-lived URL of what a player streams (its lower-bitrate preview copy, else the clip itself). Without it the list is the artifacts alone.","schema":{"type":"string","enum":["preview"]}}],"responses":{"200":{"description":"Available run artifacts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactList"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List run artifacts","tags":["Runs"],"security":[{"simforgeToken":["artifacts:read"]}]}},"/api/v1/runs/{id}/evidence":{"get":{"operationId":"getRunEvidence","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The signed evidence index (`simforge.evidence-index/v1`) of a succeeded session run: its artifacts' paths, digests and sizes, chain heads and manifest digest. With no registered server key the index is returned unsigned (`signature: null`) and the response carries `X-Evidence-Unsigned: 1`.","content":{"application/json":{"schema":{"type":"object","description":"simforge.evidence-index/v1 (sdk/contracts/evidence-index.v1.schema.json)."}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a session run's evidence index","tags":["Runs"],"security":[{"simforgeToken":["runs:read","artifacts:read"]}]}},"/api/v1/runs/{id}/replay":{"get":{"operationId":"getRunReplay","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"scenarioId","required":false,"description":"The scenario whose episode to replay. Required when the run drove several scenarios (`replay_scenario_required` lists them); a run of one scenario replays it without.","schema":{"type":"string"}}],"responses":{"200":{"description":"The closed-loop run's replay: one episode's render timeline and the 2D map.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunReplay"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a closed-loop run's replay","tags":["Runs"],"security":[{"simforgeToken":["runs:read","artifacts:read"]}]}},"/api/v1/artifacts/{id}/download":{"get":{"operationId":"downloadArtifact","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"rendition","required":false,"description":"`preview`: what a player streams of a render's camera clip, its lower-bitrate preview copy when it has one, else the clip itself; the response's `rendition` says which. Without it the download is always the artifact itself.","schema":{"type":"string","enum":["preview"]}}],"responses":{"200":{"description":"Presigned artifact download.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDownload"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download an artifact","tags":["Runs"],"security":[{"simforgeToken":["artifacts:read"]}]}},"/api/v1/artifacts/{id}/content":{"get":{"operationId":"getArtifactContent","description":"The artifact's bytes behind a lasting link: every request is authorized and redirected to a freshly signed URL of the stored object, so a reloaded, bookmarked or shared link keeps working for a caller who may read the artifact. Link to this rather than to a signed URL.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"workspace","required":false,"description":"The artifact's workspace, for a browser that cannot send `X-SimForge-Workspace-Id` when it follows a link.","schema":{"type":"string"}},{"in":"query","name":"download","required":false,"description":"`1`: save the file under its name instead of showing it.","schema":{"type":"string","enum":["1"]}}],"responses":{"302":{"description":"Redirect to a freshly signed URL of the stored object."},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Open an artifact by its lasting link","tags":["Runs"],"security":[{"simforgeToken":["artifacts:read"]}]}},"/api/v1/evaluations":{"post":{"operationId":"createEvaluation","description":"Open-loop episode evaluation of one scenario by an offered driving model: the scenario's authored drive stays in control while the model's cameras render live and every plan is scored against the drive that followed it. modelVersionId names an available model of GET /api/v1/evaluation-options and is required (400 validation_failed, param modelVersionId, detail.code model_required). API versions before 2026-10-24 accept a request without it and run the default model, with a model_defaulted note and a SimForge-Warning header. The episode costs 300 cents per scenario (estimate basis per_scenario; maxCostCents at least 300), charged only when it succeeds with a verified, scored result.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationCreateRequest"}}}},"responses":{"200":{"description":"Quote or idempotent replay.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/EvaluationQuote"},{"$ref":"#/components/schemas/Evaluation"}]}}}},"201":{"description":"Created evaluation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evaluation"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Score a scenario render with a driving model","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]},"get":{"operationId":"listEvaluations","description":"The workspace's own evaluations, newest first, whichever model ran them; with published=true also those SimForge published to every workspace (read-only, without how SimForge ran them). Each one's model names the registered version it ran (modelVersionId) and its name; modelVersionId filters by it. Each one's legacy kind is alpamayo.openloop for the default model or a workspace alias of it and policy.openloop for every other model (API versions before 2026-10-24: the lane it ran on, which ?kind= filters by; from 2026-10-24 kind is refused, 400 validation_failed, param kind).","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"in":"query","name":"modelVersionId","required":false,"description":"Only evaluations of these models, comma-separated (an offered model's id from GET /api/v1/evaluation-options, or a workspace version), with those of a workspace version that is an alias of one. Default: every model.","schema":{"type":"string","minLength":1}},{"in":"query","name":"status","required":false,"description":"Only evaluations in these statuses, comma-separated.","schema":{"type":"string","minLength":1}},{"in":"query","name":"published","required":false,"description":"`true`: also the evaluations SimForge published to every workspace (public benchmarks). Without it the list holds only this workspace's evaluations.","schema":{"type":"string","enum":["true"]}}],"responses":{"200":{"description":"Evaluation data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationPage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List evaluations","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/evaluations/{id}":{"get":{"operationId":"getEvaluation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evaluation"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get an evaluation","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/evaluations/{id}/result":{"get":{"operationId":"getEvaluationResult","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Evaluation data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationResult"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get scored metrics and provenance","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/evaluations/{id}/cancel":{"post":{"operationId":"cancelEvaluation","description":"Cancel a queued or running evaluation (run_…); a cancelled evaluation is free and its hold is released.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The cancelled evaluation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationCancel"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Cancel an evaluation","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/evaluations/{id}/artifacts/{artifactId}/download":{"post":{"operationId":"downloadEvaluationArtifact","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"artifactId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Short-lived exact-object download grant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationDownload"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download an evaluation artifact","tags":["Runs"],"security":[{"simforgeToken":["artifacts:read","runs:read"]}]}},"/api/v1/factory/looks":{"get":{"operationId":"listFactoryLooks","description":"SimForge Factory's looks library: each look's id, name and condition tags (no prose; the generator writes each camera's description from the tags and the scenario's own facts).","responses":{"200":{"description":"The looks.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryLookList"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List Factory looks","tags":["Runs"],"security":[{"simforgeToken":[]}]}},"/api/v1/factory/inputs/check":{"post":{"operationId":"checkFactoryInput","description":"Check one uploaded raw-generation input (a `factory-control` MP4 or a `factory-vision` PNG/JPEG upload) against the rules the GPU worker applies: an MP4 of H.264 or HEVC at the output size and the request's fps, holding at least numFrames - 1 frames; an image at the output size. Nothing is created.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryInputCheckRequest"}}}},"responses":{"200":{"description":"The check.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryInputCheck"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Check a raw generation input","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/factory/generations":{"post":{"operationId":"createFactoryGeneration","description":"Create a raw generation: exactly a local Cosmos3-Nano-Sim-Auto `/v1/videos/sync` call run on SimForge's GPU. `fields` are the server's form fields as a local request sends them, `files` its `input_references` in order, each an upload. Checked in full before anything runs (a refusal names every problem). No scenario, labels or check; charged per generation (GET /api/v1/factory/params `deployment.raw.centsPerGeneration`) when it delivers, whatever it shows. Requires `maxCostCents` and `Idempotency-Key`; a replay returns the original generation (200).","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGenerationCreateRequest"}}}},"responses":{"200":{"description":"A replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGeneration"}}}},"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGeneration"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create a raw Sim-Auto generation","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]},"get":{"operationId":"listFactoryGenerations","description":"The workspace's raw generations, newest first.","responses":{"200":{"description":"A page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGenerationPage"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List raw Sim-Auto generations","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/factory/generations/{id}":{"get":{"operationId":"getFactoryGeneration","description":"One raw generation: its request, where it stands (\"Waiting for a GPU, 2 clips ahead\"), and once delivered short-lived signed links to request.json, response.mp4, each camera's MP4, the inputs sent and timing.json. Cancel it with POST /api/v1/runs/{id}/cancel.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The generation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGeneration"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a raw Sim-Auto generation","tags":["Runs"],"security":[{"simforgeToken":["runs:read","artifacts:read"]}]}},"/api/v1/factory/generations/{id}/retry":{"post":{"operationId":"retryFactoryGeneration","description":"Make a failed or cancelled raw generation again with the same request and inputs, as a new generation (charged when it delivers).","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGenerationRetryRequest"}}}},"responses":{"200":{"description":"A replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGeneration"}}}},"201":{"description":"Created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryGeneration"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retry a raw Sim-Auto generation","tags":["Runs"],"security":[{"simforgeToken":["runs:write"]}]}},"/api/v1/factory/params":{"get":{"operationId":"getFactoryParams","description":"Every Cosmos3-Nano-Sim-Auto parameter SimForge Factory honours: for a clip made from a scenario and for a raw generation, whether it is settable, its default and limits, or the value the model or a product rule fixes and why; the Sim-Auto request field it sets; and whether this deployment's GPU worker honours it now.","responses":{"200":{"description":"The parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryParams"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List Sim-Auto generation parameters","tags":["Runs"],"security":[{"simforgeToken":[]}]}},"/api/v1/factory/estimate":{"post":{"operationId":"estimateFactoryRun","description":"What a Factory run would make and cost now, with nothing created, held or queued: its clips (scenarios × looks × seedsPerLook; every clip is 20 s of the Alpamayo 4-camera rig), camera-seconds, a rough ETA and the most it can charge (every clip generated and checked, accepted, flagged or rejected alike; a clip SimForge fails to make or check is free). `warnings` names scenarios simulated on past their authored end (`simulated_past_authored_end`), cut to their first 20 s (`scenario_clip_window`) or left out (`render_ego_missing`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryEstimateRequest"}}}},"responses":{"200":{"description":"The quote.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryEstimate"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"`cloud_not_open`: SimForge Cloud is off here, or no worker here runs the work yet (the reason names it, `detail.code` `run_kind_unavailable`, `detail.kinds` its job kinds); or `insufficient_scope`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Estimate a Factory run","tags":["Runs"],"security":[{"simforgeToken":["runs:write","scenarios:read","maps:read","datasets:read"]}]}},"/api/v1/factory/runs":{"post":{"operationId":"createFactoryRun","description":"Create a Factory run (a `factory_batch` cloud run) under the caller's credential and workspace. Requires `maxCostCents` (at least the estimate) and `Idempotency-Key`; the whole quote is held, and every clip generated and checked is charged per camera-second, whatever its verdict; the hold is released only for clips SimForge failed to make or check, or cancelled before their check. A replay with the same key and request returns the original run (200).","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRunCreateRequest"}}}},"responses":{"200":{"description":"Idempotent replay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRun"}}}},"201":{"description":"Created run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRun"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"`cloud_not_open`: SimForge Cloud is off here, or no worker here runs the work yet (the reason names it, `detail.code` `run_kind_unavailable`, `detail.kinds` its job kinds); or `insufficient_scope`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create a Factory run","tags":["Runs"],"security":[{"simforgeToken":["runs:write","scenarios:read","maps:read","datasets:read"]}]},"get":{"operationId":"listFactoryRuns","description":"The workspace's Factory runs, newest first, with their clip counts.","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Factory runs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRunPage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List Factory runs","tags":["Runs"],"security":[{"simforgeToken":["runs:read"]}]}},"/api/v1/factory/runs/{id}":{"get":{"operationId":"getFactoryRun","description":"One Factory run with every clip: its status, what it waits for (`waiting`: render_pending, preparing, queued_for_gpu, gpu_worker_starting, gpu_capacity_capped, finishing_up, since when, and `clipsAhead` in the GPU queue), its check (each key actor's detection rate against its own rate on the Helios render, under a versioned threshold set), and short-lived signed links to its generated videos, layouts, labels, quality.json and manifest.json (every checked clip, a rejected one too).","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The run and its clips.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRunDetail"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a Factory run and its clips","tags":["Runs"],"security":[{"simforgeToken":["runs:read","artifacts:read"]}]}},"/api/v1/factory/runs/{id}/retry-failed":{"post":{"operationId":"retryFailedFactoryClips","description":"Make the run's failed clips (all, or `clipIds`) again, as a new Factory run: clips no worker delivered (no GPU worker within the queue deadline, a worker error), each on the seed it was to have. A clip whose generation succeeded on the GPU but failed after it (its outputs judged or delivered wrong) takes that generation again instead of a new one, for no GPU time. Distinct from retry-flagged, which re-generates delivered but flagged clips on new seeds. Every clip it generates is charged, whatever its verdict; `maxCostCents` and `Idempotency-Key` as for a run.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedRequest"}}}},"responses":{"201":{"description":"The retry run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retry a Factory run's failed clips","tags":["Runs"],"security":[{"simforgeToken":["runs:write","scenarios:read","maps:read","datasets:read"]}]}},"/api/v1/factory/runs/{id}/retry-cancelled":{"post":{"operationId":"retryCancelledFactoryClips","description":"Make the run's cancelled clips (all, or `clipIds`) again, as a new Factory run, each on the seed it was to have. A clip whose generation succeeded on the GPU before its run was cancelled (it was being checked) takes that generation again instead of a new one, for no GPU time. Distinct from retry-failed, which takes only failed clips. Every clip it generates is charged, whatever its verdict; `maxCostCents` and `Idempotency-Key` as for a run.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedRequest"}}}},"responses":{"201":{"description":"The retry run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retry a Factory run's cancelled clips","tags":["Runs"],"security":[{"simforgeToken":["runs:write","scenarios:read","maps:read","datasets:read"]}]}},"/api/v1/factory/runs/{id}/retry-flagged":{"post":{"operationId":"retryFlaggedFactoryClips","description":"Generate the run's flagged clips (all, or `clipIds`) again, each on a new seed, as a new Factory run; every clip it generates is charged, whatever its verdict. `maxCostCents` and `Idempotency-Key` as for a run.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedRequest"}}}},"responses":{"201":{"description":"The retry run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactoryRetryFlaggedResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retry a Factory run's flagged clips","tags":["Runs"],"security":[{"simforgeToken":["runs:write","scenarios:read","maps:read","datasets:read"]}]}},"/api/v1/models":{"get":{"operationId":"listModels","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Customer fine-tunes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTunePage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List customer fine-tunes","tags":["Models"],"security":[{"simforgeToken":["models:read"]}]},"post":{"operationId":"createModel","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneRegisterRequest"}}}},"responses":{"201":{"description":"Registered fine-tune and its upload grants.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneRegisterResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Register a customer fine-tune","tags":["Models"],"security":[{"simforgeToken":["models:write"]}]}},"/api/v1/models/{id}":{"get":{"operationId":"getModel","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Customer fine-tune.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneModel"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a customer fine-tune","tags":["Models"],"security":[{"simforgeToken":["models:read"]}]},"delete":{"operationId":"deleteModel","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Retired customer fine-tune.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneModel"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retire a customer fine-tune","tags":["Models"],"security":[{"simforgeToken":["models:write"]}]}},"/api/v1/models/{id}/finalize":{"post":{"operationId":"finalizeModel","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneFinalizeRequest"}}}},"responses":{"202":{"description":"Accepted fine-tune qualification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneFinalizeResponse"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Finalize a customer fine-tune","tags":["Models"],"security":[{"simforgeToken":["models:write"]}]}},"/api/v1/datasets":{"get":{"operationId":"listDatasets","description":"List the current workspace's datasets; the first page also lists datasets SimForge shares with every workspace (`shared`, `owner: simforge`, read-only). `shared=true` lists only those, `shared=false` only the workspace's own","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"shared","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Datasets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetPage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List datasets","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read"]}]}},"/api/v1/datasets/{id}":{"get":{"operationId":"getDataset","description":"Get a dataset of the current workspace, or one shared with every workspace","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dataset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetDetail"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a dataset","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read"]}]}},"/api/v1/datasets/{id}/files":{"get":{"operationId":"listDatasetFiles","description":"A dataset, a filter of it or chosen scenarios as files (simforge.dataset-files/v1): signed links to the stored objects, a page at a time; `format=urls` for an aria2c link list; `dryRun` for counts and size. Files still being prepared are `pending`: ask for the same page again.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"type":"string"},"description":"Free-text search, as in the library's search box."},{"in":"query","name":"filter","required":false,"schema":{"type":"string"},"description":"Library filters: space-separated `facet:value[,value]` tokens, e.g. `grade:A tag:cut-in`."},{"in":"query","name":"sourceLog","required":false,"schema":{"type":"string"},"description":"Only the scenarios of one recorded drive."},{"in":"query","name":"ids","required":false,"schema":{"type":"string"},"description":"Exactly these scenarios, comma-separated document ids (POST the same fields for long lists)."},{"in":"query","name":"include","required":false,"schema":{"type":"string"},"description":"Comma-separated: `renders[:training|showcase|schematic]`, `labels`, `gt`, `recordings`, or `scenarios` alone; default `renders:training`."},{"in":"query","name":"passes","required":false,"schema":{"type":"string"},"description":"Keep only these render modalities (comma-separated)."},{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000}},{"in":"query","name":"format","required":false,"schema":{"type":"string","enum":["json","urls"]},"description":"`urls`: the whole selection as an aria2c input file of 24-hour links."},{"in":"query","name":"dryRun","required":false,"schema":{"type":"boolean"},"description":"Counts and size of the whole selection; no links."}],"responses":{"200":{"description":"A page of files (each a signed GET of the stored object, range-capable; ask again for fresh links), the dry-run summary, or (`format=urls`) the link list.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DatasetFilesPage"},{"$ref":"#/components/schemas/DatasetFilesSummary"}]}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"`rate_limited`: too many requests this minute; `Retry-After` says when to ask again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List a dataset's files","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read","artifacts:read"]}]},"post":{"operationId":"listDatasetFilesBySelection","description":"The same listing with its fields in a JSON body, for id lists too long for a URL.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetFilesRequest"}}}},"responses":{"200":{"description":"A page of files (each a signed GET of the stored object, range-capable; ask again for fresh links), the dry-run summary, or (`format=urls`) the link list.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DatasetFilesPage"},{"$ref":"#/components/schemas/DatasetFilesSummary"}]}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"`rate_limited`: too many requests this minute; `Retry-After` says when to ask again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List a selection's files","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read","artifacts:read"]}]}},"/api/v1/dataset-files/links/{token}/{path}":{"get":{"operationId":"downloadDatasetFileLink","description":"One file of a link list: redirects to a fresh signed URL of the stored object while the link (24 hours) is valid. The link is the grant; no credential is needed.","parameters":[{"in":"path","name":"token","required":true,"schema":{"type":"string"}},{"in":"path","name":"path","required":true,"schema":{"type":"string"},"description":"The file's place in the pulled folder (may contain `/`)."}],"responses":{"302":{"description":"Redirect to the stored object."},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download one file of a link list","tags":["Datasets"],"security":[]}},"/api/v1/dataset-copies":{"post":{"operationId":"createDatasetCopy","description":"Copy chosen scenarios, a filter or all of a dataset shared with every workspace (SIMLOG-25k) into one of your own datasets, existing or new; a scenario already copied there is skipped. dryRun counts and estimates it","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopyCreateRequest"}}}},"responses":{"200":{"description":"The count and time estimate (dryRun).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopyEstimate"}}}},"201":{"description":"The copy, finished in the response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopy"}}}},"202":{"description":"The copy, going on in the background: follow it with getDatasetCopy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopy"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Copy scenarios of a shared dataset","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read","scenarios:write"]}]},"get":{"operationId":"listDatasetCopies","parameters":[{"in":"query","name":"datasetId","required":false,"schema":{"type":"string"}},{"in":"query","name":"open","required":false,"schema":{"type":"string","enum":["true"]}}],"responses":{"200":{"description":"The workspace's copies, newest first (at most 20).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopyList"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List dataset copies","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read"]}]}},"/api/v1/dataset-copies/{id}":{"get":{"operationId":"getDatasetCopy","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"State, counts (copied, skipped as already copied, failed), the first failures and the time left.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCopy"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a dataset copy","tags":["Datasets"],"security":[{"simforgeToken":["datasets:read"]}]}},"/api/v1/maps":{"get":{"operationId":"listMaps","description":"List maps visible in the current workspace, each with the packs `simforge maps pull` would download and their sizes. Without a credential: the public catalogue, the maps any signed-in account may download","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Maps.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapPage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List maps","tags":["Maps and vehicles"],"security":[{},{"simforgeToken":["maps:read"]}]}},"/api/v1/vehicles":{"get":{"operationId":"listVehicles","description":"List the vehicles a scenario in the current workspace can bind: the shared catalog's, then the workspace's own","parameters":[{"in":"query","name":"cursor","required":false,"schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Vehicles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehiclePage"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List vehicles","tags":["Maps and vehicles"],"security":[{"simforgeToken":["scenarios:read"]}]},"post":{"operationId":"importVehicle","description":"Store the model an upload of kind vehicle-model holds as the workspace's own vehicle workspace.<id>, private to it; the server re-validates it against the vehicle model contract","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleImportRequest"}}}},"responses":{"201":{"description":"The stored vehicle.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleSummary"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Import a vehicle","tags":["Maps and vehicles"],"security":[{"simforgeToken":["scenarios:write"]}]}},"/api/v1/vehicles/{id}":{"delete":{"operationId":"deleteVehicle","description":"Retire one of the workspace's own vehicles (workspace.<id>)","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Vehicle retired."},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Retire a vehicle","tags":["Maps and vehicles"],"security":[{"simforgeToken":["scenarios:write"]}]}},"/api/v1/assets":{"get":{"operationId":"listAssets","description":"List every catalog asset of the pinned actor closure with its rendered preview (Helios still and thumbnail), source, licence and whether authoring accepts it","responses":{"200":{"description":"Assets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetList"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List assets","tags":["Maps and vehicles"],"security":[{"simforgeToken":["scenarios:read"]}]}},"/api/v1/maps/{id}":{"get":{"operationId":"getMap","description":"Get a map visible in the current workspace (its id, name or name@vN), with its packs and their sizes. Without a credential: a map of the public catalogue","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Map.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MapSummary"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a map","tags":["Maps and vehicles"],"security":[{},{"simforgeToken":["maps:read"]}]}},"/api/v1/authoring/catalogue":{"get":{"operationId":"authoringCatalogue","parameters":[],"responses":{"200":{"description":"Workspace-bound authoring receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringCatalogue"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get the operation catalogue","tags":["Authoring"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/authoring/capabilities":{"get":{"operationId":"authoringCapabilities","parameters":[],"responses":{"200":{"description":"Workspace-bound authoring receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringResult"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get authoring capabilities","tags":["Authoring"],"security":[{"simforgeToken":[]}]}},"/api/v1/drafts/{id}":{"get":{"operationId":"readDraft","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Workspace-bound authoring receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftReceipt"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get a draft","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:read"]}]}},"/api/v1/drafts":{"post":{"operationId":"createDraft","description":"Create a pinned draft, or import an exact canonical scenario document. An `Idempotency-Key` header makes it one draft per key in the workspace: a repeat with the same request answers that draft, and the key with another request, or whose draft was deleted, is 409 `idempotency_conflict`.","parameters":[{"in":"header","name":"Idempotency-Key","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftCreateRequest"}}}},"responses":{"200":{"description":"The draft: created, or the one an earlier request with this Idempotency-Key made.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftReceipt"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Create a draft","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:write"]}]}},"/api/v1/drafts/{id}/transactions":{"post":{"operationId":"applyDraftTransaction","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftTransactionRequest"}}}},"responses":{"200":{"description":"Atomic authoring result; save returns an immutable revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringHttpDraftTransactionResult"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Apply a transaction","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:write"]}]}},"/api/v1/drafts/{id}/save":{"post":{"operationId":"saveDraft","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftSaveRequest"}}}},"responses":{"200":{"description":"Atomic authoring result; save returns an immutable revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftRevisionReceipt"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Save a draft","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:write"]}]}},"/api/v1/drafts/{id}/freeze-revision":{"post":{"operationId":"freezeDraftRevision","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftSaveRequest"}}}},"responses":{"200":{"description":"Atomic authoring result; save returns an immutable revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftRevisionReceipt"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Freeze a revision","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:write"]}]}},"/api/v1/drafts/{id}/validate":{"post":{"operationId":"validateDraft","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftValidateRequest"}}}},"responses":{"200":{"description":"Atomic authoring result; save returns an immutable revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringResult"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Validate a draft","tags":["Authoring"],"security":[{"simforgeToken":["maps:read","scenarios:read"]}]}},"/api/v1/authoring/maps/{mapVersionId}/spawn":{"post":{"operationId":"probeAuthoringSpawn","parameters":[{"in":"path","name":"mapVersionId","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringSpawnRequest"}}}},"responses":{"200":{"description":"Atomic authoring result; save returns an immutable revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringResult"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Probe a spawn point","tags":["Authoring"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/authoring/maps/{mapVersionId}/discovery":{"get":{"operationId":"discoverAuthoringMap","parameters":[{"in":"path","name":"mapVersionId","required":true,"schema":{"type":"string"}},{"schema":{"type":"string","enum":["locations","lanes","movements","catalogue"],"default":"lanes"},"required":false,"name":"kind","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"x","in":"query"},{"schema":{"type":["number","null"]},"required":false,"name":"z","in":"query"},{"schema":{"type":"number","exclusiveMinimum":0},"required":false,"name":"withinM","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":256},"required":false,"name":"roadId","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":256},"required":false,"name":"type","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":1024},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"One page of semantic map discovery; no map package bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthoringDiscoveryResult"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Discover a map","tags":["Authoring"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/distribution/license":{"get":{"operationId":"getDistributionAgreement","description":"Current runtime and map pack agreement (CLI credential, maps:read)","responses":{"200":{"description":"The current agreement, or why none is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionAgreementResponse"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get the agreement","tags":["Distribution"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/distribution/license/accept":{"post":{"operationId":"acceptDistributionAgreement","description":"Accept the exact current agreement version and digest (CLI credential, maps:read)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionAgreementAcceptRequest"}}}},"responses":{"200":{"description":"Recorded acceptance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionAgreementAcceptance"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Accept the agreement","tags":["Distribution"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/distribution/runtime":{"post":{"operationId":"downloadDistributionRuntime","description":"Sign a download of an entitled runtime release (CLI credential, runtime:read): the full (`3d`) release, or with `variant: \"2d\"` the same release without its 3D actor models and sky plates","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionRuntimeRequest"}}}},"responses":{"200":{"description":"A signed URL valid for at most 15 minutes, or with `dryRun: true` the plan of that download (nothing signed or recorded).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DistributionDownload"},{"$ref":"#/components/schemas/DistributionPlan"}]}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download the runtime","tags":["Distribution"],"security":[{"simforgeToken":["runtime:read"]}]},"get":{"operationId":"listDistributionRuntime","description":"The runtime releases this CLI login may install for a platform, newest per variant, with their download and installed sizes (CLI credential, runtime:read). Signs nothing and records nothing; needs no accepted agreement","parameters":[{"in":"query","name":"target","required":true,"schema":{"type":"string","enum":["x86_64-unknown-linux-gnu","aarch64-apple-darwin","x86_64-apple-darwin","x86_64-pc-windows-gnu"]}}],"responses":{"200":{"description":"The installable releases, possibly none.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionAvailable"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"List installable runtime releases","tags":["Distribution"],"security":[{"simforgeToken":["runtime:read"]}]}},"/api/v1/distribution/cli":{"post":{"operationId":"downloadDistributionCli","description":"Sign a download of the entitled staff local CLI (CLI credential, runtime:read)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionCliRequest"}}}},"responses":{"200":{"description":"A signed URL valid for at most 15 minutes, or with `dryRun: true` the plan of that download (nothing signed or recorded).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DistributionDownload"},{"$ref":"#/components/schemas/DistributionPlan"}]}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download the local CLI","tags":["Distribution"],"security":[{"simforgeToken":["runtime:read"]}]}},"/api/v1/distribution/maps/{slug}":{"post":{"operationId":"downloadDistributionMap","description":"Sign a download of an entitled map pack (CLI credential, maps:read): the full pack, or with `variant: \"2d\"` the 2D pack (planar install only)","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionMapRequest"}}}},"responses":{"200":{"description":"A signed URL valid for at most 15 minutes, or with `dryRun: true` the plan of that download (nothing signed or recorded).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DistributionDownload"},{"$ref":"#/components/schemas/DistributionPlan"}]}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Download a map pack","tags":["Distribution"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/v1/telemetry":{"get":{"operationId":"getRuntimeUsageTerms","description":"Which usage batch schema the caller's latest accepted agreement allows (CLI credential): v2 only under an agreement that lists the v2 records","responses":{"200":{"description":"The account's latest accepted agreement and the batch schema it allows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryTerms"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Get the usage batch schema the account's terms allow","tags":["Telemetry"],"security":[{"simforgeToken":[]}]},"post":{"operationId":"reportRuntimeUsage","description":"Deliver one sealed usage batch from an installed runtime (CLI credential; a condition of the SimForge account and download terms). A v2 batch is refused unless its agreementVersion is the account's latest accepted agreement and lists the v2 records","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/TelemetryBatch"},{"$ref":"#/components/schemas/TelemetryBatchV2"}]}}}},"responses":{"200":{"description":"Stored, or already stored under this batch ID.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryReceipt"}}}},"400":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"The request failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"summary":"Report runtime usage","tags":["Telemetry"],"security":[{"simforgeToken":[]}]}},"/api/cli/bench/results":{"post":{"operationId":"submitCliBenchResult","description":"Submit one renderer benchmark result (`simforge bench --submit`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliBenchResult"}}}},"responses":{"201":{"description":"The stored result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliBenchReceipt"}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"413":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"415":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Submit a bench result","tags":["Benchmark"],"security":[{"simforgeToken":["bench:write"]}]}},"/api/cli/bench/packs/{path}":{"get":{"parameters":[{"in":"path","name":"path","required":true,"description":"`closures/<digest>.json`, or `blobs/sha256/<aa>/<sha256>` for a member a listed closure names.","schema":{"type":"string"}}],"operationId":"getCliBenchPack","description":"The benchmark's extended scene pack (`simforge bench --extended`): a closure document, or a 302 to a short-lived URL of one of its members. The CLI verifies every byte against the closure's digests.","responses":{"200":{"description":"The closure document.","content":{"application/json":{"schema":{"type":"object"}}}},"302":{"description":"A short-lived URL of the blob."},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"502":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Get a bench pack file","tags":["Benchmark"],"security":[{"simforgeToken":["maps:read"]}]},"head":{"parameters":[{"in":"path","name":"path","required":true,"description":"`closures/<digest>.json`, or `blobs/sha256/<aa>/<sha256>` for a member a listed closure names.","schema":{"type":"string"}}],"operationId":"headCliBenchPack","description":"The same as GET without the body.","responses":{"200":{"description":"The closure exists."},"302":{"description":"A short-lived URL of the blob."},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"502":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Check a bench pack file","tags":["Benchmark"],"security":[{"simforgeToken":["maps:read"]}]}},"/api/cli/challenge/team":{"get":{"operationId":"getChallengeTeam","description":"The caller's driving-challenge team, the submission caps left in each window, and the registry repository to push driver images to (`simforge challenge status`). 404 while the challenge is closed.","responses":{"200":{"description":"The team and its caps.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeTeamStatus"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Get your team","tags":["Challenge"],"security":[{"simforgeToken":["challenge:write"]}]}},"/api/cli/challenge/submissions":{"get":{"operationId":"listChallengeSubmissions","description":"The team's submissions, newest first (`simforge challenge submissions`).","responses":{"200":{"description":"The submissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeSubmissionList"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"List submissions","tags":["Challenge"],"security":[{"simforgeToken":["challenge:write"]}]},"post":{"operationId":"createChallengeSubmission","description":"Queue a driver image, by digest in the team's repository, for the next nightly evaluation (`simforge challenge submit`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeSubmitRequest"}}}},"responses":{"201":{"description":"The queued submission.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeSubmissionReceipt"}}}},"400":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"409":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Submit a driver","tags":["Challenge"],"security":[{"simforgeToken":["challenge:write"]}]}},"/api/cli/challenge/registry-credentials":{"post":{"operationId":"issueChallengeRegistryCredentials","description":"A one-hour docker login that can push and pull only the team's repository. The password is a secret: pipe it to `docker login --password-stdin`.","responses":{"200":{"description":"The docker login.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeRegistryCredentials"}}}},"401":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"403":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"404":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}},"429":{"description":"The request failed: an OAuth error object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CliOAuthError"}}}}},"summary":"Get a registry login","tags":["Challenge"],"security":[{"simforgeToken":["challenge:write"]}]}}},"webhooks":{},"tags":[{"name":"Sign-in","description":"`simforge login`: OAuth 2.0 device and browser sign-in for the CLI, the session behind a token. AI agents sign in through auth.md (`/auth.md`): register, a person approves, then the claim and JWT-bearer grants."},{"name":"Account","description":"The principal, its workspaces, API keys and usage, and system status."},{"name":"Runs","description":"Cloud runs (`--cloud`): renders, simulations, Recast log ingestion and transfers, their events and artifacts."},{"name":"Models","description":"Customer fine-tunes and their workspace-owned model weights."},{"name":"Datasets","description":"Datasets, their files as signed links (`simforge.dataset-files/v1`, `simforge datasets pull`), and copies out of shared datasets (SIMLOG-25k)."},{"name":"Maps and vehicles","description":"Maps the workspace can use, the vehicles a scenario can bind and the asset gallery."},{"name":"Authoring","description":"Hosted scenario authoring: drafts, transactions, validation and map discovery."},{"name":"Distribution","description":"The runtime and map pack agreement and signed downloads (`simforge runtime install`, `simforge maps pull`)."},{"name":"Telemetry","description":"Runtime usage telemetry, a condition of the runtime terms."},{"name":"Benchmark","description":"Renderer benchmark results and scene packs (`simforge bench`)."},{"name":"Challenge","description":"The driving challenge: team, registry login and submissions (`simforge challenge`)."}]}