sequence-base 0.3.0__py3-none-any.whl

sequence_base/schemas/PolicySpec.json

@@ -0,0 +1,346 @@
+{
+  "$defs": {
+    "ActionContract": {
+      "additionalProperties": false,
+      "description": "The fixed obs→ActionChunk contract a policy promises. Every field required; `action_space` reuses\ncontract 4's enum (not a free string). Each ActionChunk echoes exactly these invariants back.",
+      "properties": {
+        "action_dim": {
+          "title": "Action Dim",
+          "type": "integer"
+        },
+        "action_space": {
+          "$ref": "#/$defs/ActionSpace"
+        },
+        "control_frequency_hz": {
+          "title": "Control Frequency Hz",
+          "type": "number"
+        },
+        "robot": {
+          "title": "Robot",
+          "type": "string"
+        }
+      },
+      "required": [
+        "robot",
+        "action_space",
+        "action_dim",
+        "control_frequency_hz"
+      ],
+      "title": "ActionContract",
+      "type": "object"
+    },
+    "ActionSpace": {
+      "description": "Must be explicit: the same floats mean opposite things across spaces — executing an absolute\njoint position as a delta flings the arm into its limit stops. {schema.py:124}",
+      "enum": [
+        "joint_absolute",
+        "joint_delta",
+        "ee_absolute",
+        "ee_delta"
+      ],
+      "title": "ActionSpace",
+      "type": "string"
+    },
+    "Concurrency": {
+      "additionalProperties": false,
+      "description": "= Modal max/target_concurrent_inputs. Both required.",
+      "properties": {
+        "max_inputs": {
+          "title": "Max Inputs",
+          "type": "integer"
+        },
+        "target_inputs": {
+          "title": "Target Inputs",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "max_inputs",
+        "target_inputs"
+      ],
+      "title": "Concurrency",
+      "type": "object"
+    },
+    "ImageSpec": {
+      "additionalProperties": false,
+      "description": "Declarative image (gateway builds it via Cloud Build) — = Modal `Image` message. Exactly one of\n`base` (a pullable registry ref) or `dockerfile` (inline Dockerfile source) is set — the Dockerfile\nis its OWN component, never smuggled into the `base` string (S2 goal 4), so the gateway can tell a\nregistry build from a Dockerfile build. `steps` is an ordered list of the four-variant union above\n(a bare list[dict] is refused), extending whichever base was chosen.",
+      "properties": {
+        "base": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Base"
+        },
+        "dockerfile": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Dockerfile"
+        },
+        "steps": {
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/ImageStepUvPip"
+              },
+              {
+                "$ref": "#/$defs/ImageStepApt"
+              },
+              {
+                "$ref": "#/$defs/ImageStepEnv"
+              },
+              {
+                "$ref": "#/$defs/ImageStepRun"
+              }
+            ]
+          },
+          "title": "Steps",
+          "type": "array"
+        }
+      },
+      "title": "ImageSpec",
+      "type": "object"
+    },
+    "ImageStepApt": {
+      "additionalProperties": false,
+      "properties": {
+        "apt_install": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Apt Install",
+          "type": "array"
+        }
+      },
+      "required": [
+        "apt_install"
+      ],
+      "title": "ImageStepApt",
+      "type": "object"
+    },
+    "ImageStepEnv": {
+      "additionalProperties": false,
+      "properties": {
+        "env": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "title": "Env",
+          "type": "object"
+        }
+      },
+      "required": [
+        "env"
+      ],
+      "title": "ImageStepEnv",
+      "type": "object"
+    },
+    "ImageStepRun": {
+      "additionalProperties": false,
+      "properties": {
+        "run_commands": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Run Commands",
+          "type": "array"
+        }
+      },
+      "required": [
+        "run_commands"
+      ],
+      "title": "ImageStepRun",
+      "type": "object"
+    },
+    "ImageStepUvPip": {
+      "additionalProperties": false,
+      "properties": {
+        "uv_pip_install": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Uv Pip Install",
+          "type": "array"
+        }
+      },
+      "required": [
+        "uv_pip_install"
+      ],
+      "title": "ImageStepUvPip",
+      "type": "object"
+    },
+    "SecretRef": {
+      "additionalProperties": false,
+      "description": "A by-name reference to a secret (PolicySpec.secrets / BenchmarkSpec.secrets). Name only — the\nvalue lives in Secret Manager and is injected at worker bootstrap. Never carries a value.",
+      "properties": {
+        "name": {
+          "title": "Name",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "title": "SecretRef",
+      "type": "object"
+    },
+    "VolumeRef": {
+      "additionalProperties": false,
+      "description": "PolicySpec.volumes value — at least a `uri`; a `mount` may pin the container path.",
+      "properties": {
+        "mount": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Mount"
+        },
+        "uri": {
+          "title": "Uri",
+          "type": "string"
+        }
+      },
+      "required": [
+        "uri"
+      ],
+      "title": "VolumeRef",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "description": "What `@seq.policy(...)` accrues — a policy's complete infra declaration, losslessly. `action` is\nrequired (no default): a policy without an obs→ActionChunk contract is not deployable.",
+  "properties": {
+    "action": {
+      "$ref": "#/$defs/ActionContract"
+    },
+    "buffer_containers": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Buffer Containers"
+    },
+    "concurrency": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/Concurrency"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "frames_per_chunk": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Frames Per Chunk"
+    },
+    "gpu": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      ],
+      "description": "A GPU type, or a list = cross-provider fallback",
+      "title": "Gpu"
+    },
+    "image": {
+      "$ref": "#/$defs/ImageSpec"
+    },
+    "max_containers": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Max Containers"
+    },
+    "min_containers": {
+      "default": 0,
+      "title": "Min Containers",
+      "type": "integer"
+    },
+    "name": {
+      "title": "Name",
+      "type": "string"
+    },
+    "scaledown_window": {
+      "default": 600,
+      "title": "Scaledown Window",
+      "type": "integer"
+    },
+    "secrets": {
+      "items": {
+        "$ref": "#/$defs/SecretRef"
+      },
+      "title": "Secrets",
+      "type": "array"
+    },
+    "streaming": {
+      "default": false,
+      "title": "Streaming",
+      "type": "boolean"
+    },
+    "volumes": {
+      "additionalProperties": {
+        "$ref": "#/$defs/VolumeRef"
+      },
+      "title": "Volumes",
+      "type": "object"
+    },
+    "weights": {
+      "description": "Weights URI; scheme restricted to gs:// or hf://",
+      "title": "Weights",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "gpu",
+    "image",
+    "weights",
+    "action"
+  ],
+  "title": "PolicySpec",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/Proprioception.json

@@ -0,0 +1,67 @@
+{
+  "additionalProperties": false,
+  "description": "Proprioceptive state. Only joint_positions is required; the rest is zero-padded per model.",
+  "properties": {
+    "end_effector_pose": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "maxItems": 7,
+          "minItems": 7,
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "End Effector Pose"
+    },
+    "gripper": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Gripper"
+    },
+    "joint_positions": {
+      "description": "Joint angles, in radians",
+      "items": {
+        "type": "number"
+      },
+      "title": "Joint Positions",
+      "type": "array"
+    },
+    "joint_velocities": {
+      "anyOf": [
+        {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Joint Velocities"
+    }
+  },
+  "required": [
+    "joint_positions"
+  ],
+  "title": "Proprioception",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/RenderSpec.json

@@ -0,0 +1,22 @@
+{
+  "additionalProperties": false,
+  "description": "a.k.a. `seq.Record` — declares the mp4 the platform records (money-shot is a platform tool, not user\nglue). `camera` picks which camera stream to pull frames from; `fps` is the output frame rate. Used two\nways: as `BenchmarkSpec.render` (record the whole eval) and as `Step.record` (a per-frame hint).",
+  "properties": {
+    "camera": {
+      "description": "Which camera to pull frames from, e.g. 'wrist' / 'agentview'",
+      "title": "Camera",
+      "type": "string"
+    },
+    "fps": {
+      "default": 30,
+      "title": "Fps",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "camera"
+  ],
+  "title": "RenderSpec",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/Resources.json

@@ -0,0 +1,29 @@
+{
+  "additionalProperties": false,
+  "description": "= Modal Resources + GPUConfig. `gpu` is list[str] (the PolicySpec `str | list[str]` normalized).",
+  "properties": {
+    "cpu": {
+      "title": "Cpu",
+      "type": "integer"
+    },
+    "gpu": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Gpu",
+      "type": "array"
+    },
+    "memory_gb": {
+      "title": "Memory Gb",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "gpu",
+    "cpu",
+    "memory_gb"
+  ],
+  "title": "Resources",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/RolloutResult.json

@@ -0,0 +1,59 @@
+{
+  "additionalProperties": false,
+  "description": "One episode's result, ASSEMBLED BY THE PLATFORM from the per-step `@seq.check` returns — the user\nnever returns a success flag. `metrics` is the episode's closed-out user metrics (passthrough; the\nplatform does not know the field names). `video_uri` points at the mp4 the platform tool produced.\n\nScope: W0.1 delivers this wire shape only; the runtime that settles per-step `check.done` per-env and\nassembles it lives in the container / gateway, not in this pure-types unit.",
+  "properties": {
+    "metrics": {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "description": "Episode's user-named metrics (passthrough; platform does not name them)",
+      "title": "Metrics",
+      "type": "object"
+    },
+    "steps": {
+      "title": "Steps",
+      "type": "integer"
+    },
+    "terminated": {
+      "title": "Terminated",
+      "type": "boolean"
+    },
+    "trajectory_uri": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Trajectory Uri"
+    },
+    "truncated": {
+      "title": "Truncated",
+      "type": "boolean"
+    },
+    "video_uri": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Video Uri"
+    }
+  },
+  "required": [
+    "metrics",
+    "steps",
+    "terminated",
+    "truncated"
+  ],
+  "title": "RolloutResult",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/SecretCreateRequest.json

@@ -0,0 +1,25 @@
+{
+  "additionalProperties": false,
+  "description": "POST /v1/secrets — one name = one group of env values (e.g. openrouter = {OPENROUTER_API_KEY}).\n`env` carries plaintext values; this is the WRITE-direction allow-list field (goal 15).",
+  "properties": {
+    "env": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "ENV_KEY → value; write-only, never echoed back",
+      "title": "Env",
+      "type": "object"
+    },
+    "name": {
+      "title": "Name",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "env"
+  ],
+  "title": "SecretCreateRequest",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/SecretInfo.json

@@ -0,0 +1,44 @@
+{
+  "additionalProperties": false,
+  "description": "GET /v1/secrets element — metadata only, NO values. Exposes `env_keys`, not `env`.",
+  "properties": {
+    "created_at": {
+      "format": "date-time",
+      "title": "Created At",
+      "type": "string"
+    },
+    "env_keys": {
+      "description": "The env var names in this secret — values withheld",
+      "items": {
+        "type": "string"
+      },
+      "title": "Env Keys",
+      "type": "array"
+    },
+    "last_used_at": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Last Used At"
+    },
+    "name": {
+      "title": "Name",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name",
+    "env_keys",
+    "created_at"
+  ],
+  "title": "SecretInfo",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/SecretRef.json

@@ -0,0 +1,16 @@
+{
+  "additionalProperties": false,
+  "description": "A by-name reference to a secret (PolicySpec.secrets / BenchmarkSpec.secrets). Name only — the\nvalue lives in Secret Manager and is injected at worker bootstrap. Never carries a value.",
+  "properties": {
+    "name": {
+      "title": "Name",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name"
+  ],
+  "title": "SecretRef",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/SeqFlags.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "Lifecycle bitmask (IntFlag). One bit per lifecycle entrypoint.",
+  "enum": [
+    1,
+    2,
+    4,
+    8,
+    16,
+    1024,
+    4096,
+    8192,
+    16384,
+    32768,
+    65536
+  ],
+  "title": "SeqFlags",
+  "type": "integer",
+  "x-contract-version": "0.4.1",
+  "x-flag-names": {
+    "CHECK": 65536,
+    "INFER": 16,
+    "LOAD": 2,
+    "ON_EPISODE": 1024,
+    "PLAN": 4,
+    "RESET": 32768,
+    "ROLLOUT": 8192,
+    "SCORE": 16384,
+    "SETUP": 4096,
+    "SHUTDOWN": 8,
+    "WARMUP": 1
+  }
+}