sequence-base 0.3.0__py3-none-any.whl

sequence_base/schemas/MetricAgg.json

@@ -0,0 +1,87 @@
+{
+  "$defs": {
+    "SuiteAgg": {
+      "additionalProperties": false,
+      "description": "Per-suite aggregate of ONE user-named metric — structured detail, not a bare dict. `value` is the\nmetric aggregated over that suite; the platform does not name or interpret the metric.",
+      "properties": {
+        "n": {
+          "title": "N",
+          "type": "integer"
+        },
+        "suite": {
+          "title": "Suite",
+          "type": "string"
+        },
+        "value": {
+          "title": "Value",
+          "type": "number"
+        }
+      },
+      "required": [
+        "suite",
+        "value",
+        "n"
+      ],
+      "title": "SuiteAgg",
+      "type": "object"
+    },
+    "TaskAgg": {
+      "additionalProperties": false,
+      "description": "Per-task aggregate of ONE user-named metric — structured detail, not a bare dict.",
+      "properties": {
+        "n": {
+          "title": "N",
+          "type": "integer"
+        },
+        "task": {
+          "title": "Task",
+          "type": "string"
+        },
+        "value": {
+          "title": "Value",
+          "type": "number"
+        }
+      },
+      "required": [
+        "task",
+        "value",
+        "n"
+      ],
+      "title": "TaskAgg",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "description": "The aggregate of one user-named metric key across the eval — overall plus per-suite / per-task\nbreakdowns and the sample count. The platform aggregates whatever the user returned in `Step.metrics`;\nit neither defines nor injects `success_rate` (success is just one key the user may or may not name).",
+  "properties": {
+    "n": {
+      "title": "N",
+      "type": "integer"
+    },
+    "overall": {
+      "title": "Overall",
+      "type": "number"
+    },
+    "per_suite": {
+      "items": {
+        "$ref": "#/$defs/SuiteAgg"
+      },
+      "title": "Per Suite",
+      "type": "array"
+    },
+    "per_task": {
+      "items": {
+        "$ref": "#/$defs/TaskAgg"
+      },
+      "title": "Per Task",
+      "type": "array"
+    }
+  },
+  "required": [
+    "overall",
+    "n"
+  ],
+  "title": "MetricAgg",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/Observation.json

@@ -0,0 +1,133 @@
+{
+  "$defs": {
+    "ImageFrame": {
+      "additionalProperties": false,
+      "description": "One camera frame at one instant. Repeat a `view` (ordered by timestamp_ms) for a series.",
+      "properties": {
+        "data": {
+          "description": "Base64-encoded image (PNG or JPEG). URLs are not fetched.",
+          "title": "Data",
+          "type": "string"
+        },
+        "timestamp_ms": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Orders multiple frames of a view; array order used when omitted",
+          "title": "Timestamp Ms"
+        },
+        "view": {
+          "description": "Logical view name, e.g. top / wrist_left / exterior_1. May appear more than once to express a time series",
+          "title": "View",
+          "type": "string"
+        }
+      },
+      "required": [
+        "view",
+        "data"
+      ],
+      "title": "ImageFrame",
+      "type": "object"
+    },
+    "Proprioception": {
+      "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"
+    }
+  },
+  "additionalProperties": false,
+  "description": "The robot's world at one instant: camera frames + proprioception + a language instruction.",
+  "properties": {
+    "images": {
+      "items": {
+        "$ref": "#/$defs/ImageFrame"
+      },
+      "maxItems": 256,
+      "minItems": 1,
+      "title": "Images",
+      "type": "array"
+    },
+    "instruction": {
+      "title": "Instruction",
+      "type": "string"
+    },
+    "proprioception": {
+      "$ref": "#/$defs/Proprioception"
+    }
+  },
+  "required": [
+    "images",
+    "proprioception",
+    "instruction"
+  ],
+  "title": "Observation",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/PolicyRegistration.json

@@ -0,0 +1,438 @@
+{
+  "$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"
+    },
+    "PolicySpec": {
+      "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"
+    },
+    "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"
+    },
+    "SeqFlags": {
+      "$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
+      }
+    },
+    "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 the harness loader introspects: the spec, the SeqFlags→method-name bindings, and the\n`handler_ref` it importlib-loads the policy class from. From one of these the loader recovers which\nmethod is which lifecycle entrypoint (load / infer / on_episode / plan …).",
+  "properties": {
+    "bindings": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "lifecycle flag → method name on the handler",
+      "propertyNames": {
+        "enum": [
+          "1",
+          "2",
+          "4",
+          "8",
+          "16",
+          "1024",
+          "4096",
+          "8192",
+          "16384",
+          "32768",
+          "65536"
+        ],
+        "type": "string"
+      },
+      "title": "Bindings",
+      "type": "object"
+    },
+    "handler_ref": {
+      "description": "\"module.path:ClassName\" for importlib load",
+      "title": "Handler Ref",
+      "type": "string"
+    },
+    "plan_every_s": {
+      "anyOf": [
+        {
+          "exclusiveMinimum": 0,
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Seconds between @seq.plan calls; set iff a PLAN binding exists",
+      "title": "Plan Every S"
+    },
+    "spec": {
+      "$ref": "#/$defs/PolicySpec"
+    }
+  },
+  "required": [
+    "spec",
+    "bindings",
+    "handler_ref"
+  ],
+  "title": "PolicyRegistration",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}