API and operation reference
Generated from the current shared service contracts.
Download current OpenAPI JSON. These 42 service operation names are also MCP tool names. Adapter operations are parameters to these tools, not additional MCP tools.
Examples below come from the contract examples. Marked IDs, passwords and source metadata are placeholders; authored fixtures are not published benchmark results.
- run_goal
- describe_operation
- get_artifact_json
- get_workspace_usage
- set_workspace_quota
- get_service_metrics
- get_run_audit
- create_backup
- restore_backup
- apply_retention
- organization_login
- create_webhook
- read_webhook
- get_capabilities
- find_resources
- compile_goal
- create_campaign
- launch_campaign_case
- get_campaign
- finalize_campaign
- find_verified_results
- create_suite
- get_suite
- register_asset
- get_asset
- register_trajectory
- register_sensor_recording
- prepare_plan
- execute_plan
- get_run
- get_budget
- cancel_run
- reconcile_run
- resume_run
- get_result
- get_result_report
- read_signed_webhook
- get_dataset_generation
- verify_run_result
- compare_results
- verify_result
- export_result
run_goal
Compile, prepare, execute and read one typed goal through scoped service tools. Same key resumes the same logical run. Waiting is not task failure. Campaigns require the campaign tools.
POST /v1/goals/runEffect: compute.
Request schema
{
"type": "object",
"properties": {
"goal": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"parameters": {
"type": "object",
"additionalProperties": true,
"properties": {
"case_indices": {
"description": "Zero-based Moving AI case indices (0 through 8). Index N selects canonical resource movingai:N, not ordinal N+1. Use find_resources to inspect the pinned case; movingai:8 means case_indices [8]."
}
}
},
"workflow_kind": {
"enum": [
"single_operation",
"campaign"
]
},
"max_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 180
},
"resource_limits": {
"type": "object",
"properties": {
"cpu_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 180
},
"memory_bytes": {
"type": "integer",
"minimum": 67108864,
"maximum": 2147483648
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 134217728
}
},
"required": [],
"additionalProperties": false
},
"required_runner_capabilities": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"maxItems": 16
},
"verification": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute",
"replay"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"mode"
],
"additionalProperties": false
}
},
"required": [],
"additionalProperties": false
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource_id": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Exact resource ID returned by find_resources. Moving AI uses zero-based movingai:N; movingai:8 selects case_index 8. Explicit parameters must agree with this resource."
},
"wait_seconds": {
"type": "number",
"minimum": 0,
"maximum": 30
},
"include_artifacts": {
"type": "boolean"
}
},
"required": [
"goal",
"idempotency_key"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"enum": [
"needs_information",
"waiting",
"terminal"
]
},
"missing_parameters": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"run_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"run": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"result": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"report": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"artifacts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"export_skipped": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"status",
"missing_parameters",
"run_id",
"run",
"result",
"report",
"artifacts",
"export_skipped"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"goal": {
"operation": "solve_navigation",
"profile": "movingai.octile.v1",
"parameters": {
"case_indices": [
0
]
},
"max_seconds": 20
},
"idempotency_key": "published-case-0",
"wait_seconds": 20,
"include_artifacts": true
}describe_operation
Describe one callable tool with exact input/output schemas. Adapter operations are parameters of compile_goal, not MCP tool names.
POST /v1/operations/describeEffect: read.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Bare service tool name from tools/list, e.g. get_result_report. Do not include the MCP server name or an adapter operation."
}
},
"required": [
"name"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"namespace": {
"const": "service_tool"
},
"input_schema": {
"type": "object",
"additionalProperties": true
},
"output_schema": {
"type": "object",
"additionalProperties": true
},
"description": {
"type": "string",
"maxLength": 4096
}
},
"required": [
"name",
"namespace",
"input_schema",
"output_schema",
"description"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "compile_goal"
}get_artifact_json
Read a hash-checked JSON artifact as nanoseconds-decimal.v1 without modifying original bytes. Not JSONL or binary export.
POST /v1/results/{result_id}/artifact-jsonEffect: read.
Request schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"result_id",
"name"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"original_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"representation_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"representation": {
"type": "object",
"additionalProperties": true
},
"content": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"result_id",
"name",
"original_sha256",
"representation_sha256",
"representation",
"content"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"result_id": "replace-with-run-id",
"name": "sensor-recording-inventory.json"
}get_workspace_usage
Read quota limits, reservations, measured phases and explicit unknown consumption.
GET /v1/workspace/usageEffect: read.
Request schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"version": {
"type": "integer"
},
"limits": {
"type": "object",
"properties": {
"max_jobs": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"cpu_seconds": {
"type": "number",
"minimum": 0,
"maximum": 86400
},
"wall_seconds": {
"type": "number",
"minimum": 0,
"maximum": 172800
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 1073741824
},
"active_memory_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 4294967296
},
"model_calls": {
"const": 0
},
"device_calls": {
"const": 0
}
},
"required": [
"max_jobs",
"cpu_seconds",
"wall_seconds",
"artifact_bytes",
"active_memory_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"available": {
"type": "object",
"additionalProperties": true
},
"committed": {
"type": "object",
"additionalProperties": true
},
"measured": {
"type": "object",
"additionalProperties": true
},
"conservative_unknown_holds": {
"type": "object",
"additionalProperties": true
},
"unknown": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"reservations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"cost_usd": {
"const": null
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"workspace_id",
"version",
"limits",
"available",
"committed",
"measured",
"conservative_unknown_holds",
"unknown",
"reservations",
"cost_usd",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{}set_workspace_quota
Update a workspace lifetime quota with optimistic version matching; no usage reset.
POST /v1/workspace/quotaEffect: write.
Request schema
{
"type": "object",
"properties": {
"limits": {
"type": "object",
"properties": {
"max_jobs": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"cpu_seconds": {
"type": "number",
"minimum": 0,
"maximum": 86400
},
"wall_seconds": {
"type": "number",
"minimum": 0,
"maximum": 172800
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 1073741824
},
"active_memory_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 4294967296
},
"model_calls": {
"const": 0
},
"device_calls": {
"const": 0
}
},
"required": [
"max_jobs",
"cpu_seconds",
"wall_seconds",
"artifact_bytes",
"active_memory_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"expected_version": {
"type": "integer",
"minimum": 1
}
},
"required": [
"limits",
"expected_version"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"version": {
"type": "integer"
},
"limits": {
"type": "object",
"properties": {
"max_jobs": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"cpu_seconds": {
"type": "number",
"minimum": 0,
"maximum": 86400
},
"wall_seconds": {
"type": "number",
"minimum": 0,
"maximum": 172800
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 1073741824
},
"active_memory_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 4294967296
},
"model_calls": {
"const": 0
},
"device_calls": {
"const": 0
}
},
"required": [
"max_jobs",
"cpu_seconds",
"wall_seconds",
"artifact_bytes",
"active_memory_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"available": {
"type": "object",
"additionalProperties": true
},
"committed": {
"type": "object",
"additionalProperties": true
},
"measured": {
"type": "object",
"additionalProperties": true
},
"conservative_unknown_holds": {
"type": "object",
"additionalProperties": true
},
"unknown": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"reservations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"cost_usd": {
"const": null
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"workspace_id",
"version",
"limits",
"available",
"committed",
"measured",
"conservative_unknown_holds",
"unknown",
"reservations",
"cost_usd",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"limits": {
"max_jobs": 10,
"cpu_seconds": 300,
"wall_seconds": 600,
"artifact_bytes": 16777216,
"active_memory_bytes": 536870912,
"model_calls": 0,
"device_calls": 0
},
"expected_version": 1
}get_service_metrics
Read persisted service counters scoped to this workspace.
GET /v1/metricsEffect: read.
Request schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"requests": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"runs": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"retained_out_runs": {
"type": "integer"
},
"attempts_with_unknown_tail": {
"type": "integer"
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"workspace_id",
"requests",
"runs",
"retained_out_runs",
"attempts_with_unknown_tail",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{}get_run_audit
Read durable run transitions, attempt history and retention state.
GET /v1/runs/{run_id}/auditEffect: read.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"run_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"events": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"entries": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"retention": {
"type": [
"object",
"null"
],
"additionalProperties": true
}
},
"required": [
"run_id",
"events",
"attempts",
"entries",
"retention"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id"
}create_backup
Freeze metadata, history and registered blobs after run reconciliation.
POST /v1/backupsEffect: write.
Request schema
{
"type": "object",
"properties": {
"max_mib": {
"type": "integer",
"minimum": 1,
"maximum": 1024
}
},
"required": [],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"backup_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"manifest_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"files": {
"type": "integer"
},
"bytes": {
"type": "integer"
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"backup_id",
"manifest_sha256",
"files",
"bytes",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"max_mib": 256
}restore_backup
Restore an owned backup to a separate copy; never overwrite the active catalog.
POST /v1/backups/restoreEffect: write.
Request schema
{
"type": "object",
"properties": {
"backup_id": {
"type": "string",
"pattern": "[a-f0-9]{32}"
},
"max_mib": {
"type": "integer",
"minimum": 1,
"maximum": 1024
}
},
"required": [
"backup_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"restore_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"workspace_id": {
"type": [
"string",
"null"
]
},
"database": {
"type": "string",
"maxLength": 4096
},
"artifact_root": {
"type": "string",
"maxLength": 4096
},
"files_verified": {
"type": "integer"
},
"jobs_restarted": {
"const": 0
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"restore_id",
"workspace_id",
"database",
"artifact_root",
"files_verified",
"jobs_restarted",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"backup_id": "0123456789abcdef0123456789abcdef",
"max_mib": 256
}apply_retention
Preview or delete selected old terminal artifacts; retain history and protect suites/campaigns.
POST /v1/retentionEffect: write.
Request schema
{
"type": "object",
"properties": {
"run_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"minItems": 1,
"maxItems": 25
},
"before": {
"type": "number",
"minimum": 0
},
"dry_run": {
"type": "boolean"
}
},
"required": [
"run_ids",
"before"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"deleted_files": {
"type": "integer"
},
"dry_run": {
"type": "boolean"
},
"state": {
"enum": [
"preview",
"complete"
]
}
},
"required": [
"run_ids",
"deleted_files",
"dry_run",
"state"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_ids": [
"replace-with-run-id"
],
"before": 1789171200,
"dry_run": true
}organization_login
Authenticate a provisioned local organization principal and issue a workspace-scoped token.
POST /v1/organization/loginEffect: write.
Request schema
{
"type": "object",
"properties": {
"organization": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"principal": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"password": {
"type": "string",
"minLength": 16,
"maxLength": 1024
},
"workspace": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"operations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 100
},
"ttl_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 86400
}
},
"required": [
"organization",
"principal",
"password",
"workspace",
"operations"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"token": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"principal_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"expires_at": {
"type": "number"
}
},
"required": [
"token",
"workspace_id",
"principal_id",
"expires_at"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"organization": "demo-org",
"principal": "demo-user",
"workspace": "demo-workspace",
"password": "<supply-through-local-protected-input>",
"operations": [
"get_capabilities"
],
"ttl_seconds": 3600
}create_webhook
Create a workspace-local authenticated pull outbox; no external sending.
POST /v1/webhooksEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"name"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"delivery": {
"const": "authenticated_pull"
},
"external_delivery": {
"const": false
}
},
"required": [
"webhook_id",
"name",
"delivery",
"external_delivery"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "local-events"
}read_webhook
Read authorized durable run events from a workspace-local webhook outbox.
POST /v1/webhooks/readEffect: read.
Request schema
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"after": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"webhook_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"events": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"next_cursor": {
"type": "integer"
},
"delivery": {
"const": "authenticated_pull"
},
"external_delivery": {
"const": false
}
},
"required": [
"webhook_id",
"events",
"next_cursor",
"delivery",
"external_delivery"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"webhook_id": "replace-with-webhook-id",
"after": 0,
"limit": 25
}get_capabilities
Discover exact supported profiles, operations and local execution limits.
GET /v1/capabilitiesEffect: read.
Request schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"profiles": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"adapters": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"operations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"limits": {
"type": "object",
"additionalProperties": true
},
"schema_version": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"deployment": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"unsupported": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"discovery": {
"type": "object",
"additionalProperties": true
},
"evidence_rules": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4096
}
}
},
"required": [
"profiles",
"adapters",
"operations",
"limits",
"schema_version",
"deployment",
"unsupported"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{}find_resources
Find included tasks and stored episodes; returns a bounded page, not episode arrays.
POST /v1/resources/searchEffect: read.
Request schema
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"type": "integer",
"minimum": 0
}
},
"required": [],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"matches": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"next_cursor": {
"type": [
"integer",
"null"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"profiles": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"matches",
"next_cursor",
"total",
"profiles"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"profile": "movingai.octile.v1",
"limit": 10,
"cursor": 0
}compile_goal
Compile a structured goal into an authorized typed plan. Provider contract mode makes zero model calls.
POST /v1/goals/compileEffect: write.
Request schema
{
"type": "object",
"properties": {
"goal": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"parameters": {
"type": "object",
"additionalProperties": true,
"properties": {
"case_indices": {
"description": "Zero-based Moving AI case indices (0 through 8). Index N selects canonical resource movingai:N, not ordinal N+1. Use find_resources to inspect the pinned case; movingai:8 means case_indices [8]."
}
}
},
"workflow_kind": {
"enum": [
"single_operation",
"campaign"
]
},
"max_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 180
},
"resource_limits": {
"type": "object",
"properties": {
"cpu_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 180
},
"memory_bytes": {
"type": "integer",
"minimum": 67108864,
"maximum": 2147483648
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 134217728
}
},
"required": [],
"additionalProperties": false
},
"required_runner_capabilities": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"maxItems": 16
},
"verification": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute",
"replay"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"mode"
],
"additionalProperties": false
}
},
"required": [],
"additionalProperties": false
},
"provider_mode": {
"type": "string",
"enum": [
"disabled",
"contract_only"
]
}
},
"required": [
"goal"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ready",
"needs_information"
]
},
"missing_parameters": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"typed_request": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"prepared_plan": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"provider": {
"type": "object",
"additionalProperties": true
},
"provider_calls": {
"const": 0
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"status",
"missing_parameters",
"typed_request",
"prepared_plan",
"provider",
"provider_calls",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"goal": {
"operation": "solve_navigation",
"profile": "movingai.octile.v1",
"parameters": {
"case_indices": [
0
],
"max_cases": 1,
"algorithm": "astar"
},
"max_seconds": 30
},
"provider_mode": "disabled"
}create_campaign
Freeze a bounded campaign, allowed mutations, immutable criteria, typed case plans and total budget.
POST /v1/campaignsEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"cases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"goal": {
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"parameters": {
"type": "object",
"additionalProperties": true,
"properties": {
"case_indices": {
"description": "Zero-based Moving AI case indices (0 through 8). Index N selects canonical resource movingai:N, not ordinal N+1. Use find_resources to inspect the pinned case; movingai:8 means case_indices [8]."
}
}
},
"workflow_kind": {
"enum": [
"single_operation",
"campaign"
]
},
"max_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 180
},
"resource_limits": {
"type": "object",
"properties": {
"cpu_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 180
},
"memory_bytes": {
"type": "integer",
"minimum": 67108864,
"maximum": 2147483648
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 134217728
}
},
"required": [],
"additionalProperties": false
},
"required_runner_capabilities": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"maxItems": 16
},
"verification": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute",
"replay"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"mode"
],
"additionalProperties": false
}
},
"required": [],
"additionalProperties": false
},
"origin": {
"type": "string",
"enum": [
"published",
"derived"
]
},
"parent_case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"mutations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"path",
"value"
],
"additionalProperties": false
},
"maxItems": 16
}
},
"required": [
"case_id",
"goal",
"origin"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 16
},
"allowed_mutations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"maxItems": 32
},
"immutable_criteria": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 32
},
"budget": {
"type": "object",
"properties": {
"max_cases": {
"type": "integer",
"minimum": 1,
"maximum": 16
},
"max_attempts": {
"type": "integer",
"minimum": 1,
"maximum": 32
},
"cpu_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 2880
},
"wall_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 2880
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 536870912
}
},
"required": [
"max_cases",
"max_attempts",
"cpu_seconds",
"wall_seconds",
"artifact_bytes"
],
"additionalProperties": false
},
"reduction": {
"type": "string",
"enum": [
"exact_typed_request"
]
}
},
"required": [
"name",
"cases",
"allowed_mutations",
"immutable_criteria",
"budget"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"campaign": {
"type": "object",
"additionalProperties": true
},
"status": {
"const": "prepared"
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"campaign_id",
"campaign",
"status",
"attempts",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "Bounded published checks",
"cases": [
{
"case_id": "nav-0",
"origin": "published",
"goal": {
"operation": "solve_navigation",
"profile": "movingai.octile.v1",
"parameters": {
"case_indices": [
0
],
"max_cases": 1,
"algorithm": "astar"
}
}
}
],
"allowed_mutations": [
"goal.parameters.algorithm"
],
"immutable_criteria": [
"published source",
"verification protocol"
],
"budget": {
"max_cases": 2,
"max_attempts": 2,
"cpu_seconds": 60,
"wall_seconds": 60,
"artifact_bytes": 2097152
}
}launch_campaign_case
Start one campaign case as an ordinary durable job under the campaign budget.
POST /v1/campaigns/{campaign_id}/cases/{case_id}/runsEffect: compute.
Request schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"retry_key": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"campaign_id",
"case_id",
"retry_key"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"run": {
"type": "object",
"additionalProperties": true
},
"idempotent_replay": {
"type": "boolean"
}
},
"required": [
"campaign_id",
"case_id",
"run",
"idempotent_replay"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"campaign_id": "replace-with-campaign-id",
"case_id": "nav-0",
"retry_key": "nav-0-attempt-1"
}get_campaign
Read the immutable campaign, attempts and final report.
GET /v1/campaigns/{campaign_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"campaign_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"campaign": {
"type": "object",
"additionalProperties": true
},
"status": {
"type": "string",
"enum": [
"prepared",
"running",
"ready_to_finalize",
"finalized"
]
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"report": {
"type": [
"object",
"null"
],
"additionalProperties": true
}
},
"required": [
"campaign_id",
"campaign",
"status",
"attempts",
"report"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"campaign_id": "replace-with-campaign-id"
}finalize_campaign
Reduce terminal case results and freeze the complete phase/attempt ledger.
POST /v1/campaigns/{campaign_id}/finalizeEffect: write.
Request schema
{
"type": "object",
"properties": {
"campaign_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"campaign_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"campaign_id": "replace-with-campaign-id"
}find_verified_results
Find authorized verified results compatible with an exact dataset generation; never auto-include.
POST /v1/verified-results/searchEffect: read.
Request schema
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dataset_result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"purpose": {
"type": "string",
"enum": [
"training",
"evaluation"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"type": "integer",
"minimum": 0
}
},
"required": [
"profile",
"operation"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"matches": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"next_cursor": {
"type": [
"integer",
"null"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"automatic_inclusion": {
"const": false
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"matches",
"next_cursor",
"total",
"automatic_inclusion",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"profile": "movingai.octile.v1",
"operation": "solve_navigation",
"dataset_result_id": "replace-with-dataset-run-id",
"purpose": "evaluation",
"limit": 25,
"cursor": 0
}create_suite
Explicitly include unique compatible verified results in an immutable dataset-linked suite.
POST /v1/suitesEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"purpose": {
"type": "string",
"enum": [
"training",
"evaluation"
]
},
"selected_result_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"minItems": 1,
"maxItems": 100
},
"dataset_result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"name",
"purpose",
"selected_result_ids",
"dataset_result_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "Verified navigation suite",
"purpose": "evaluation",
"selected_result_ids": [
"replace-with-verified-run-id"
],
"dataset_result_id": "replace-with-dataset-run-id"
}get_suite
Read and revalidate an immutable task/run/evidence/dataset suite.
GET /v1/suites/{suite_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"suite_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"suite_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"suite_id": "replace-with-suite-id"
}register_asset
Register timestamped XYZ prediction/reference tracks, already in the same frame and metres. Does not control a device.
POST /v1/assetsEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"source_url": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"data_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"code_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"frame": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"units": {
"type": "string",
"enum": [
"m"
]
},
"prediction": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
},
"minItems": 4,
"maxItems": 4
},
"minItems": 2,
"maxItems": 10000
},
"reference": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "number"
},
"minItems": 4,
"maxItems": 4
},
"minItems": 2,
"maxItems": 10000
}
},
"required": [
"name",
"source_url",
"data_license",
"code_license",
"frame",
"units",
"prediction",
"reference"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"evidence": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label_origin": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"control_actions_present": {
"type": "boolean"
}
},
"required": [
"asset_id",
"sha256",
"evidence",
"label_origin",
"control_actions_present"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "Authored trajectory fixture",
"source_url": "urn:example:trajectory",
"data_license": "private test data",
"code_license": "MIT",
"frame": "world",
"units": "m",
"prediction": [
[
0,
0,
0,
0
],
[
1,
1,
0,
0
]
],
"reference": [
[
0,
0,
0,
0
],
[
1,
1,
0,
0
]
]
}get_asset
Read an integrity-checked registered sensor asset including source provenance and preserved input text.
GET /v1/assets/{asset_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"asset_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"asset": {
"type": "object",
"additionalProperties": true,
"properties": {
"recording": {
"type": "object",
"additionalProperties": true,
"properties": {
"messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"log_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"publish_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
},
"returned_messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"log_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"publish_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
},
"time_range_ns": {
"type": "object",
"additionalProperties": true,
"properties": {
"first_log": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"last_log": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
}
}
}
}
},
"required": [
"asset_id",
"sha256",
"asset"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"asset_id": "replace-with-returned-asset-id"
}register_trajectory
Import two TUM-format UTF-8 trajectories with exact matching timestamps. Preserves source text and hashes; evaluates XYZ only, no frame alignment or device control.
POST /v1/trajectory-assetsEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"source_url": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"data_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"code_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"frame": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"units": {
"type": "string",
"enum": [
"m"
]
},
"format": {
"type": "string",
"enum": [
"tum.v1"
]
},
"prediction_text": {
"type": "string",
"minLength": 1,
"maxLength": 500000
},
"reference_text": {
"type": "string",
"minLength": 1,
"maxLength": 500000
}
},
"required": [
"name",
"source_url",
"data_license",
"code_license",
"frame",
"units",
"format",
"prediction_text",
"reference_text"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"evidence": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label_origin": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"control_actions_present": {
"type": "boolean"
}
},
"required": [
"asset_id",
"sha256",
"evidence",
"label_origin",
"control_actions_present"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "Authored TUM fixture",
"source_url": "urn:example:tum",
"data_license": "private test data",
"code_license": "MIT",
"frame": "world",
"units": "m",
"format": "tum.v1",
"prediction_text": "0 0 0 0 0 0 0 1\n1 1 0 0 0 0 0 1",
"reference_text": "0 0 0 0 0 0 0 1\n1 1 0 0 0 0 0 1"
}register_sensor_recording
Register a bounded ROS 1 or ROS 2 MCAP recording. Preserves exact bytes, timestamps, schemas, units and the declared frame; does not infer commands or flight outcomes.
POST /v1/sensor-recordingsEffect: write.
Request schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"source_url": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"source_revision": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"data_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"code_license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"platform": {
"type": "string",
"enum": [
"aerial",
"ground",
"manipulator",
"unknown"
]
},
"frame": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"units": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 16
},
"ros_version": {
"type": "string",
"enum": [
"ros1",
"ros2"
]
},
"mcap_base64": {
"type": "string",
"minLength": 12,
"maxLength": 2800000
}
},
"required": [
"name",
"source_url",
"source_revision",
"data_license",
"code_license",
"platform",
"frame",
"units",
"ros_version",
"mcap_base64"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"evidence": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label_origin": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"control_actions_present": {
"type": "boolean"
}
},
"required": [
"asset_id",
"sha256",
"evidence",
"label_origin",
"control_actions_present"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"name": "Published ROS 2 recording",
"source_url": "https://example.invalid/source",
"source_revision": "replace-with-pinned-revision",
"data_license": "replace-with-source-license",
"code_license": "MIT",
"platform": "aerial",
"frame": "replace-with-declared-frame",
"units": [
"m",
"s"
],
"ros_version": "ros2",
"mcap_base64": "replace-with-base64-mcap"
}prepare_plan
Validate compatibility and freeze inputs, code identity and budget before any computation.
POST /v1/plansEffect: write.
Request schema
{
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"parameters": {
"type": "object",
"additionalProperties": true
},
"verification": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute",
"replay"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"mode"
],
"additionalProperties": false
},
"required_runner_capabilities": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"maxItems": 16
},
"resource_limits": {
"type": "object",
"properties": {
"cpu_seconds": {
"type": "number",
"minimum": 0.1,
"maximum": 180
},
"memory_bytes": {
"type": "integer",
"minimum": 67108864,
"maximum": 2147483648
},
"artifact_bytes": {
"type": "integer",
"minimum": 0,
"maximum": 134217728
}
},
"required": [],
"additionalProperties": false
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"algorithm": {
"type": "string",
"enum": [
"astar",
"dijkstra"
]
},
"filters": {
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"navigation",
"manipulation"
]
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"split": {
"type": "string",
"enum": [
"train",
"validation",
"test"
]
}
},
"required": [
"domain"
],
"additionalProperties": false
},
"asset_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"episode_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"max_messages": {
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"seed": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"start_index": {
"type": "integer",
"minimum": 0,
"maximum": 9999
},
"frame_count": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"stride": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"case_indices": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 8
},
"minItems": 1,
"maxItems": 9,
"description": "Zero-based Moving AI case indices (0 through 8). Index N selects canonical resource movingai:N, not ordinal N+1. Use find_resources to inspect the pinned case; movingai:8 means case_indices [8]."
},
"max_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 180
},
"max_cases": {
"type": "integer",
"minimum": 1,
"maximum": 9
},
"threshold_m": {
"type": "number",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"operation",
"profile"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_digest": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"compatibility": {
"const": "compatible"
},
"plan": {
"type": "object",
"additionalProperties": true,
"properties": {
"preparation": {
"type": "object",
"properties": {
"stage": {
"const": "prepared"
},
"execution_started": {
"const": false
},
"run_id": {
"const": null
},
"run": {
"const": null
},
"result_id": {
"const": null
},
"export_artifact_created": {
"const": false
}
},
"required": [
"stage",
"execution_started",
"run_id",
"run",
"result_id",
"export_artifact_created"
],
"additionalProperties": false
}
},
"required": [
"preparation"
]
},
"run_plan": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:RunPlan:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "RunPlan"
},
"schema_version": {
"const": "1.0.0"
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"task_ref": {
"$ref": "#/$defs/ref"
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"procedure_ref": {
"$ref": "#/$defs/ref"
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"parameters": {
"type": "array",
"items": {
"$ref": "#/$defs/parameter"
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"step_id",
"procedure_ref",
"depends_on",
"parameters"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 10000
},
"runner_requirements": {
"type": "object",
"properties": {
"execution_mode": {
"type": "string",
"enum": [
"metadata_inspection",
"offline_evaluation",
"observation_replay",
"closed_loop_simulation",
"external_result_ingestion"
]
},
"profile_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"environment_ref": {
"$ref": "#/$defs/ref"
}
},
"required": [
"execution_mode",
"profile_refs",
"environment_ref"
],
"additionalProperties": false
},
"resource_limits": {
"$ref": "#/$defs/limits"
},
"rights_decision": {
"$ref": "#/$defs/ref"
},
"estimated_usage": {
"$ref": "#/$defs/usage"
},
"expires_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"plan_id",
"digest",
"task_ref",
"input_versions",
"steps",
"runner_requirements",
"resource_limits",
"rights_decision",
"estimated_usage",
"expires_at"
],
"additionalProperties": false
},
"compatibility_decision": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:CompatibilityDecision:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "CompatibilityDecision"
},
"schema_version": {
"const": "1.0.0"
},
"decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"type": "string",
"enum": [
"compatible",
"incompatible",
"needs_information"
]
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"matched_requirements": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"missing_fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"expected": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"observed": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"field",
"expected",
"observed",
"reason"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"evidence_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 0,
"maxItems": 10000
},
"checked_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"decision_id",
"status",
"input_versions",
"matched_requirements",
"missing_fields",
"conflicts",
"evidence_refs",
"checked_at"
],
"additionalProperties": false
},
"authorization": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"minItems": 1
}
},
"required": [
"plan_id",
"plan_digest",
"compatibility",
"plan",
"run_plan",
"compatibility_decision",
"authorization"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"operation": "solve_navigation",
"profile": "movingai.octile.v1",
"case_indices": [
0
],
"max_seconds": 30
}execute_plan
Start one durable local job using a prepared digest and idempotency key. Poll get_run. Zero provider calls.
POST /v1/runsEffect: compute.
Request schema
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_digest": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"plan_id",
"plan_digest",
"idempotency_key"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"progress": {
"type": "object",
"additionalProperties": true
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"created_at": {
"type": "number"
},
"updated_at": {
"type": "number"
},
"result_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"error": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
}
},
"required": [
"seq",
"at",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"run_id",
"plan_id",
"status",
"progress",
"created_at",
"updated_at",
"result_id",
"error",
"events"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"plan_id": "replace-with-plan-id",
"plan_digest": "replace-with-plan-digest",
"idempotency_key": "project-case-0-v1"
}get_run
Read durable job status. Completion is separate from the task outcome.
GET /v1/runs/{run_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"run_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"progress": {
"type": "object",
"additionalProperties": true
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"created_at": {
"type": "number"
},
"updated_at": {
"type": "number"
},
"result_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"error": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
}
},
"required": [
"seq",
"at",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"run_id",
"plan_id",
"status",
"progress",
"created_at",
"updated_at",
"result_id",
"error",
"events"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id"
}get_budget
Read the atomic reservation, observed phase usage and explicitly unknown usage.
GET /v1/runs/{run_id}/budgetEffect: read.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"run_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"reservation": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:BudgetReservation:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "BudgetReservation"
},
"schema_version": {
"const": "1.0.0"
},
"reservation_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"plan_digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"limits": {
"$ref": "#/$defs/limits"
},
"estimated_usage": {
"$ref": "#/$defs/usage"
},
"actual_usage": {
"$ref": "#/$defs/usage"
},
"unknown_usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"reason"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"expires_at": {
"type": "number",
"minimum": 0
},
"state": {
"type": "string",
"enum": [
"reserved",
"consuming",
"reconciling",
"released",
"expired"
]
}
},
"required": [
"entity_type",
"schema_version",
"reservation_id",
"workspace_id",
"plan_digest",
"limits",
"estimated_usage",
"actual_usage",
"unknown_usage",
"expires_at",
"state"
],
"additionalProperties": false
},
"attempt_accounting": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"reservation",
"attempt_accounting",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id"
}cancel_run
Request cooperative cancellation; retains completed evidence.
POST /v1/runs/{run_id}/cancelEffect: cancel.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"run_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"progress": {
"type": "object",
"additionalProperties": true
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"created_at": {
"type": "number"
},
"updated_at": {
"type": "number"
},
"result_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"error": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
}
},
"required": [
"seq",
"at",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"run_id",
"plan_id",
"status",
"progress",
"created_at",
"updated_at",
"result_id",
"error",
"events"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id"
}reconcile_run
Reconcile an expired lease without replaying work; preserve attempts and partial evidence.
POST /v1/runs/{run_id}/reconcileEffect: write.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"run_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"progress": {
"type": "object",
"additionalProperties": true
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"created_at": {
"type": "number"
},
"updated_at": {
"type": "number"
},
"result_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"error": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
}
},
"required": [
"seq",
"at",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"run_id",
"plan_id",
"status",
"progress",
"created_at",
"updated_at",
"result_id",
"error",
"events"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id"
}resume_run
Explicitly resume one incomplete logical job under a retry key; preserve previous attempts.
POST /v1/runs/{run_id}/resumeEffect: compute.
Request schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"run_id",
"idempotency_key"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"progress": {
"type": "object",
"additionalProperties": true
},
"attempts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"created_at": {
"type": "number"
},
"updated_at": {
"type": "number"
},
"result_id": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 64
},
"error": {
"type": [
"string",
"null"
]
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
}
},
"required": [
"seq",
"at",
"status"
],
"additionalProperties": false
}
}
},
"required": [
"run_id",
"plan_id",
"status",
"progress",
"created_at",
"updated_at",
"result_id",
"error",
"events"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"run_id": "replace-with-run-id",
"idempotency_key": "explicit-recovery-1"
}get_result
Read an integrity-checked result manifest, evidence and artifact references.
GET /v1/results/{result_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"result_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"result_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"result": {
"type": "object",
"properties": {
"runner": {
"type": "object",
"additionalProperties": true
},
"verification": {
"type": "object",
"properties": {
"schema_version": {
"const": "1.0.0"
},
"verification_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"requested_mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute"
]
},
"performed_checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"const": "passed"
}
},
"required": [
"mode",
"protocol",
"status"
],
"additionalProperties": false
},
"minItems": 1
},
"proven_result": {
"type": "string",
"enum": [
"not_evaluated",
"no_violation_found",
"violation_found"
]
},
"physics_replayed": {
"const": false
},
"input_snapshot_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"artifact_hashes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"name",
"sha256"
],
"additionalProperties": false
}
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"verifier_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"schema_version",
"verification_id",
"requested_mode",
"performed_checks",
"proven_result",
"physics_replayed",
"input_snapshot_sha256",
"artifact_hashes",
"scope",
"verifier_sha256"
],
"additionalProperties": false
},
"schema_version": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"execution_status": {
"type": "string",
"enum": [
"running",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"provider_calls": {
"type": "integer",
"minimum": 0
},
"records": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"log_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"publish_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
},
"returned_messages": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"properties": {
"log_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"publish_time_ns": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
},
"time_range_ns": {
"type": "object",
"additionalProperties": true,
"properties": {
"first_log": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
},
"last_log": {
"type": "string",
"pattern": "-?(0|[1-9][0-9]*)",
"maxLength": 40
}
}
}
}
}
},
"artifacts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"elapsed_seconds": {
"type": "number",
"minimum": 0
},
"input_snapshot": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schema_version",
"execution_status",
"provider_calls"
],
"additionalProperties": false
}
},
"required": [
"result_id",
"result_sha256",
"plan_id",
"result"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"result_id": "replace-with-run-id"
}get_result_report
Read the same scoped evidence verdict for UI, embed and CI, with JSON and JUnit. Rechecks current access.
GET /v1/results/{result_id}/reportEffect: read.
Request schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"result_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"summary": {
"type": "object",
"properties": {
"schema_version": {
"const": "1.0.0"
},
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"result_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"execution_status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"task_outcome": {
"type": "string",
"enum": [
"not_evaluated",
"no_violation_found",
"violation_found"
]
},
"ci_status": {
"enum": [
"passed",
"violation",
"error",
"incomplete"
]
},
"exit_code": {
"type": "integer",
"enum": [
0,
1,
2,
3
]
},
"required_check": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"performed_checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"const": "passed"
}
},
"required": [
"mode",
"protocol",
"status"
],
"additionalProperties": false
}
},
"verification_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"physics_replayed": {
"const": false
},
"recording": {
"const": true
},
"meaning": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Short evidence statement. Moving AI lists canonical movingai:N and actual zero-based case_index. Dataset export is confirmed only after completed execution with existing hash-checked payload and manifest. Artifact references remain in get_result."
}
},
"required": [
"schema_version",
"result_id",
"result_sha256",
"profile",
"operation",
"execution_status",
"task_outcome",
"ci_status",
"exit_code",
"required_check",
"performed_checks",
"verification_scope",
"physics_replayed",
"recording",
"meaning"
],
"additionalProperties": false
},
"junit_xml": {
"type": "string",
"maxLength": 65536
}
},
"required": [
"summary",
"junit_xml"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"result_id": "replace-with-run-id"
}read_signed_webhook
Read workspace-bound HMAC signed run events. Pull only; no outbound delivery.
POST /v1/webhooks/{webhook_id}/signed-eventsEffect: read.
Request schema
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"after": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"webhook_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"delivery_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"payload": {
"type": "object",
"properties": {
"schema_version": {
"const": "1.0.0"
},
"workspace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"webhook_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"event": {
"type": "object",
"properties": {
"seq": {
"type": "integer",
"minimum": 0
},
"at": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"cancel_requested",
"completed",
"failed",
"cancelled",
"budget_exhausted",
"incomplete"
]
},
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"seq",
"at",
"status",
"run_id"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"workspace_id",
"webhook_id",
"event"
],
"additionalProperties": false
},
"signed_at": {
"type": "integer"
},
"signature": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"delivery_id",
"payload",
"signed_at",
"signature"
],
"additionalProperties": false
}
},
"next_cursor": {
"type": "integer"
},
"delivery": {
"const": "authenticated_signed_pull"
},
"external_delivery": {
"const": false
}
},
"required": [
"webhook_id",
"events",
"next_cursor",
"delivery",
"external_delivery"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"webhook_id": "replace-with-webhook-id",
"after": 0,
"limit": 25
}get_dataset_generation
Read a verified DatasetManifest, immutable split and native-reader round-trip receipt.
GET /v1/datasets/{result_id}Effect: read.
Request schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"result_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"dataset_manifest": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:DatasetManifest:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "DatasetManifest"
},
"schema_version": {
"const": "1.0.0"
},
"dataset_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"episode_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"split_ref": {
"$ref": "#/$defs/ref"
},
"filters": {
"type": "array",
"items": {
"$ref": "#/$defs/parameter"
},
"minItems": 0,
"maxItems": 10000
},
"transform_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"$ref": "#/$defs/rights"
},
"target_schema": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"checksums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"locator": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
},
"required": [
"locator",
"sha256"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 10000
}
},
"required": [
"entity_type",
"schema_version",
"dataset_id",
"version",
"episode_refs",
"split_ref",
"filters",
"transform_refs",
"rights",
"target_schema",
"checksums"
],
"additionalProperties": false
},
"split_manifest": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:SplitManifest:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "SplitManifest"
},
"schema_version": {
"const": "1.0.0"
},
"split_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"grouping_rule": {
"$ref": "#/$defs/ref"
},
"group_assignments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"group_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"split": {
"type": "string",
"enum": [
"train",
"validation",
"test",
"excluded"
]
}
},
"required": [
"group_id",
"split"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 10000
},
"source_lineage": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"seed_or_rule": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"heldout_policy": {
"type": "object",
"properties": {
"training_allowed": {
"type": "boolean"
},
"automatic_reassignment": {
"const": false
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"training_allowed",
"automatic_reassignment",
"description"
],
"additionalProperties": false
}
},
"required": [
"entity_type",
"schema_version",
"split_id",
"version",
"grouping_rule",
"group_assignments",
"source_lineage",
"seed_or_rule",
"heldout_policy"
],
"additionalProperties": false
},
"roundtrip": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"result_id",
"dataset_manifest",
"split_manifest",
"roundtrip"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"result_id": "replace-with-dataset-run-id"
}verify_run_result
Independently check stored bytes or supported offline metrics; never imply physical replay.
POST /v1/results/{result_id}/verifyEffect: write.
Request schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute",
"replay"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"result_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"schema_version": {
"const": "1.0.0"
},
"verification_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"requested_mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute"
]
},
"performed_checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"integrity",
"metric_recompute"
]
},
"protocol": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"const": "passed"
}
},
"required": [
"mode",
"protocol",
"status"
],
"additionalProperties": false
},
"minItems": 1
},
"proven_result": {
"type": "string",
"enum": [
"not_evaluated",
"no_violation_found",
"violation_found"
]
},
"physics_replayed": {
"const": false
},
"input_snapshot_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"artifact_hashes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"name",
"sha256"
],
"additionalProperties": false
}
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"verifier_sha256": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"schema_version",
"verification_id",
"requested_mode",
"performed_checks",
"proven_result",
"physics_replayed",
"input_snapshot_sha256",
"artifact_hashes",
"scope",
"verifier_sha256"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"result_id": "replace-with-run-id",
"mode": "integrity"
}compare_results
Compare completed results only when their task inputs and evaluation protocol match.
POST /v1/comparisons/queryEffect: read.
Request schema
{
"type": "object",
"properties": {
"left_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"right_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"mode": {
"type": "string",
"enum": [
"repeat",
"algorithms"
]
}
},
"required": [
"left_id",
"right_id"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"left_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"right_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"comparable": {
"type": "boolean"
},
"same_records": {
"type": "boolean"
},
"scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"equivalent_outcomes": {
"type": "boolean"
},
"summary": {
"type": "object",
"additionalProperties": true
},
"protocol": {
"type": "object",
"additionalProperties": true
},
"paired_results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"coverage": {
"type": "object",
"additionalProperties": true
},
"procedures": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"left_id",
"right_id",
"comparable",
"same_records",
"scope"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"left_id": "replace-with-left-run-id",
"right_id": "replace-with-right-run-id",
"mode": "repeat"
}verify_result
Recompute stored episode checks in a new run plan. Does not claim physics replay.
POST /v1/verification-plansEffect: write.
Request schema
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"filters": {
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"navigation",
"manipulation"
]
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"split": {
"type": "string",
"enum": [
"train",
"validation",
"test"
]
}
},
"required": [
"domain"
],
"additionalProperties": false
}
},
"required": [
"profile",
"filters"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_digest": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"compatibility": {
"const": "compatible"
},
"plan": {
"type": "object",
"additionalProperties": true,
"properties": {
"preparation": {
"type": "object",
"properties": {
"stage": {
"const": "prepared"
},
"execution_started": {
"const": false
},
"run_id": {
"const": null
},
"run": {
"const": null
},
"result_id": {
"const": null
},
"export_artifact_created": {
"const": false
}
},
"required": [
"stage",
"execution_started",
"run_id",
"run",
"result_id",
"export_artifact_created"
],
"additionalProperties": false
}
},
"required": [
"preparation"
]
},
"run_plan": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:RunPlan:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "RunPlan"
},
"schema_version": {
"const": "1.0.0"
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"task_ref": {
"$ref": "#/$defs/ref"
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"procedure_ref": {
"$ref": "#/$defs/ref"
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"parameters": {
"type": "array",
"items": {
"$ref": "#/$defs/parameter"
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"step_id",
"procedure_ref",
"depends_on",
"parameters"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 10000
},
"runner_requirements": {
"type": "object",
"properties": {
"execution_mode": {
"type": "string",
"enum": [
"metadata_inspection",
"offline_evaluation",
"observation_replay",
"closed_loop_simulation",
"external_result_ingestion"
]
},
"profile_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"environment_ref": {
"$ref": "#/$defs/ref"
}
},
"required": [
"execution_mode",
"profile_refs",
"environment_ref"
],
"additionalProperties": false
},
"resource_limits": {
"$ref": "#/$defs/limits"
},
"rights_decision": {
"$ref": "#/$defs/ref"
},
"estimated_usage": {
"$ref": "#/$defs/usage"
},
"expires_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"plan_id",
"digest",
"task_ref",
"input_versions",
"steps",
"runner_requirements",
"resource_limits",
"rights_decision",
"estimated_usage",
"expires_at"
],
"additionalProperties": false
},
"compatibility_decision": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:CompatibilityDecision:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "CompatibilityDecision"
},
"schema_version": {
"const": "1.0.0"
},
"decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"type": "string",
"enum": [
"compatible",
"incompatible",
"needs_information"
]
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"matched_requirements": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"missing_fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"expected": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"observed": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"field",
"expected",
"observed",
"reason"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"evidence_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 0,
"maxItems": 10000
},
"checked_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"decision_id",
"status",
"input_versions",
"matched_requirements",
"missing_fields",
"conflicts",
"evidence_refs",
"checked_at"
],
"additionalProperties": false
},
"authorization": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"minItems": 1
}
},
"required": [
"plan_id",
"plan_digest",
"compatibility",
"plan",
"run_plan",
"compatibility_decision",
"authorization"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"profile": "movingai.octile.v1",
"filters": {
"domain": "navigation"
}
}export_result
Prepare only: freeze a provenance-preserving dataset export plan with immutable group splits. Execution has NOT started; there is no run or export artifact. Execute the returned plan with execute_plan, or use run_goal with goal.operation export_dataset and explicit budgets. Confirm export only from a completed run and its existing hash-checked artifacts.
POST /v1/export-plansEffect: write.
Request schema
{
"type": "object",
"properties": {
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"filters": {
"type": "object",
"properties": {
"domain": {
"type": "string",
"enum": [
"navigation",
"manipulation"
]
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"split": {
"type": "string",
"enum": [
"train",
"validation",
"test"
]
}
},
"required": [
"domain"
],
"additionalProperties": false
}
},
"required": [
"profile",
"filters"
],
"additionalProperties": false
}Response schema
{
"type": "object",
"required": [
"schema_version",
"request_id",
"status",
"data",
"limitations",
"next_actions"
],
"properties": {
"schema_version": {
"type": "string"
},
"request_id": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
]
},
"data": {
"oneOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"plan_digest": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"compatibility": {
"const": "compatible"
},
"plan": {
"type": "object",
"additionalProperties": true,
"properties": {
"preparation": {
"type": "object",
"properties": {
"stage": {
"const": "prepared"
},
"execution_started": {
"const": false
},
"run_id": {
"const": null
},
"run": {
"const": null
},
"result_id": {
"const": null
},
"export_artifact_created": {
"const": false
}
},
"required": [
"stage",
"execution_started",
"run_id",
"run",
"result_id",
"export_artifact_created"
],
"additionalProperties": false
}
},
"required": [
"preparation"
]
},
"run_plan": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:RunPlan:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "RunPlan"
},
"schema_version": {
"const": "1.0.0"
},
"plan_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"task_ref": {
"$ref": "#/$defs/ref"
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"procedure_ref": {
"$ref": "#/$defs/ref"
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"parameters": {
"type": "array",
"items": {
"$ref": "#/$defs/parameter"
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"step_id",
"procedure_ref",
"depends_on",
"parameters"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 10000
},
"runner_requirements": {
"type": "object",
"properties": {
"execution_mode": {
"type": "string",
"enum": [
"metadata_inspection",
"offline_evaluation",
"observation_replay",
"closed_loop_simulation",
"external_result_ingestion"
]
},
"profile_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"environment_ref": {
"$ref": "#/$defs/ref"
}
},
"required": [
"execution_mode",
"profile_refs",
"environment_ref"
],
"additionalProperties": false
},
"resource_limits": {
"$ref": "#/$defs/limits"
},
"rights_decision": {
"$ref": "#/$defs/ref"
},
"estimated_usage": {
"$ref": "#/$defs/usage"
},
"expires_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"plan_id",
"digest",
"task_ref",
"input_versions",
"steps",
"runner_requirements",
"resource_limits",
"rights_decision",
"estimated_usage",
"expires_at"
],
"additionalProperties": false
},
"compatibility_decision": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:worldfuzz:entity:CompatibilityDecision:1.0.0",
"$defs": {
"ref": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"id",
"version"
],
"additionalProperties": false
},
"parameter": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"value",
"unit"
],
"additionalProperties": false
},
"limits": {
"type": "object",
"properties": {
"wall_seconds": {
"type": "number",
"minimum": 0
},
"cpu_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"memory_bytes": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
]
},
"artifact_bytes": {
"type": "integer",
"minimum": 0
},
"model_calls": {
"type": "integer",
"minimum": 0
},
"device_calls": {
"type": "integer",
"minimum": 0
}
},
"required": [
"wall_seconds",
"cpu_seconds",
"memory_bytes",
"artifact_bytes",
"model_calls",
"device_calls"
],
"additionalProperties": false
},
"usage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phase": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"resource": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"value": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"basis": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"phase",
"resource",
"value",
"unit",
"basis"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"rights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"enum": [
"data",
"code",
"model",
"scene"
]
},
"license": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"declared",
"verified",
"unknown",
"conflict"
]
},
"allowed_uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"inspect",
"evaluate",
"train",
"export",
"redistribute"
]
},
"minItems": 0,
"maxItems": 10000
},
"evidence_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
}
},
"required": [
"subject",
"license",
"status",
"allowed_uses",
"evidence_urls",
"limitations"
],
"additionalProperties": false
},
"minItems": 4,
"maxItems": 10000
},
"signal": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"dtype": {
"type": "string",
"enum": [
"float32",
"float64",
"int32",
"int64",
"uint8",
"bool",
"text"
]
},
"shape": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 0,
"maxItems": 10000
},
"unit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"frame": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"semantic": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"rate_hz": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"dtype",
"shape",
"unit",
"frame",
"semantic",
"rate_hz"
],
"additionalProperties": false
}
},
"type": "object",
"properties": {
"entity_type": {
"const": "CompatibilityDecision"
},
"schema_version": {
"const": "1.0.0"
},
"decision_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"status": {
"type": "string",
"enum": [
"compatible",
"incompatible",
"needs_information"
]
},
"input_versions": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 1,
"maxItems": 10000
},
"matched_requirements": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"minItems": 0,
"maxItems": 10000
},
"missing_fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"minItems": 0,
"maxItems": 10000
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"expected": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"observed": {
"anyOf": [
{
"type": "null"
},
{
"type": "boolean"
},
{
"type": "number"
},
{
"type": "string",
"minLength": 1,
"maxLength": 4096
},
{
"type": "array",
"items": {
"type": "number"
},
"minItems": 0,
"maxItems": 10000
}
]
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 4096
}
},
"required": [
"field",
"expected",
"observed",
"reason"
],
"additionalProperties": false
},
"minItems": 0,
"maxItems": 10000
},
"evidence_refs": {
"type": "array",
"items": {
"$ref": "#/$defs/ref"
},
"minItems": 0,
"maxItems": 10000
},
"checked_at": {
"type": "number",
"minimum": 0
}
},
"required": [
"entity_type",
"schema_version",
"decision_id",
"status",
"input_versions",
"matched_requirements",
"missing_fields",
"conflicts",
"evidence_refs",
"checked_at"
],
"additionalProperties": false
},
"authorization": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"minItems": 1
}
},
"required": [
"plan_id",
"plan_digest",
"compatibility",
"plan",
"run_plan",
"compatibility_decision",
"authorization"
],
"additionalProperties": false
},
{
"type": "object",
"maxProperties": 0
}
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"data_representation": {
"type": "object",
"properties": {
"version": {
"const": "nanoseconds-decimal.v1"
},
"encoding": {
"const": "base10_integer_string"
},
"unit": {
"const": "ns"
},
"hash_scope": {
"type": "string",
"minLength": 1,
"maxLength": 256
}
},
"required": [
"version",
"encoding",
"unit",
"hash_scope"
],
"additionalProperties": false
},
"error": {
"type": "object",
"additionalProperties": true
}
}
}Contract example
{
"profile": "movingai.octile.v1",
"filters": {
"domain": "navigation"
}
}