sequence-base 0.3.0__py3-none-any.whl

sequence_base/schemas/BootstrapResponse.json

@@ -0,0 +1,76 @@
+{
+  "$defs": {
+    "Lease": {
+      "additionalProperties": false,
+      "description": "A time-boxed grant of the direct coordinates. Renewed before `expires_at`; `epoch` is the\nworker/secret generation — a client holding a stale epoch against a new worker gets 401 and must\nre-connect.",
+      "properties": {
+        "epoch": {
+          "description": "Worker/secret generation counter; rolls on worker change",
+          "title": "Epoch",
+          "type": "integer"
+        },
+        "expires_at": {
+          "format": "date-time",
+          "title": "Expires At",
+          "type": "string"
+        },
+        "ttl_s": {
+          "title": "Ttl S",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "ttl_s",
+        "expires_at",
+        "epoch"
+      ],
+      "title": "Lease",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "description": "POST /v1/internal/bootstrap (worker instance-identity JWT) — everything a worker needs to serve\ndirect TLS `/act`. `direct_secret` + `tls_key` are DOWN-direction platform secrets; `env` is the\nWRITE-direction injection of the policy's declared user secrets into its subprocess (goal 15).",
+  "properties": {
+    "direct_secret": {
+      "description": "Platform-minted bearer the worker's guard checks",
+      "title": "Direct Secret",
+      "type": "string"
+    },
+    "env": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Policy's user secrets, expanded ENV_KEY → value",
+      "title": "Env",
+      "type": "object"
+    },
+    "lease": {
+      "$ref": "#/$defs/Lease"
+    },
+    "tls_cert": {
+      "description": "Self-signed TLS certificate (public)",
+      "title": "Tls Cert",
+      "type": "string"
+    },
+    "tls_key": {
+      "description": "Self-signed TLS private key (down-direction platform secret)",
+      "title": "Tls Key",
+      "type": "string"
+    },
+    "weights_uri": {
+      "title": "Weights Uri",
+      "type": "string"
+    }
+  },
+  "required": [
+    "direct_secret",
+    "tls_key",
+    "tls_cert",
+    "env",
+    "weights_uri",
+    "lease"
+  ],
+  "title": "BootstrapResponse",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/ClampInfo.json

@@ -0,0 +1,27 @@
+{
+  "additionalProperties": false,
+  "description": "Why the granted GPU count was clamped below the request — structured, not a bare value.",
+  "properties": {
+    "granted": {
+      "title": "Granted",
+      "type": "integer"
+    },
+    "limit": {
+      "description": "Which limit bound it, e.g. 'account_quota'",
+      "title": "Limit",
+      "type": "string"
+    },
+    "requested": {
+      "title": "Requested",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "limit",
+    "requested",
+    "granted"
+  ],
+  "title": "ClampInfo",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/CodeBundle.json

@@ -0,0 +1,27 @@
+{
+  "additionalProperties": false,
+  "description": "The policy's own source, shipped with the deploy so the worker can import `policy.handler_ref`\n(what Modal's automount does for the entrypoint module). A gzip'd tar of the handler's top-level module\nor package, base64 on the wire, with the sha256 of the decoded bytes so a truncated or altered upload\nis refused at the edge instead of failing as an ImportError on a GPU.",
+  "properties": {
+    "data": {
+      "title": "Data",
+      "type": "string"
+    },
+    "format": {
+      "const": "tar.gz",
+      "default": "tar.gz",
+      "title": "Format",
+      "type": "string"
+    },
+    "sha256": {
+      "title": "Sha256",
+      "type": "string"
+    }
+  },
+  "required": [
+    "data",
+    "sha256"
+  ],
+  "title": "CodeBundle",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/Concurrency.json

@@ -0,0 +1,21 @@
+{
+  "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",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/Conditions.json

@@ -0,0 +1,59 @@
+{
+  "$defs": {
+    "Variant": {
+      "additionalProperties": false,
+      "description": "One structured variant axis of the eval matrix (e.g. axis=\"lighting\", values=[\"day\",\"night\"]).",
+      "properties": {
+        "axis": {
+          "title": "Axis",
+          "type": "string"
+        },
+        "values": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Values",
+          "type": "array"
+        }
+      },
+      "required": [
+        "axis",
+        "values"
+      ],
+      "title": "Variant",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "description": "The eval matrix — structured, not a bare dict. `tasks` and `seeds` required; `variants` optional.",
+  "properties": {
+    "seeds": {
+      "items": {
+        "type": "integer"
+      },
+      "title": "Seeds",
+      "type": "array"
+    },
+    "tasks": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Tasks",
+      "type": "array"
+    },
+    "variants": {
+      "items": {
+        "$ref": "#/$defs/Variant"
+      },
+      "title": "Variants",
+      "type": "array"
+    }
+  },
+  "required": [
+    "tasks",
+    "seeds"
+  ],
+  "title": "Conditions",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/ConnectRequest.json

@@ -0,0 +1,16 @@
+{
+  "additionalProperties": false,
+  "properties": {
+    "model": {
+      "description": "Deployment name to connect to",
+      "title": "Model",
+      "type": "string"
+    }
+  },
+  "required": [
+    "model"
+  ],
+  "title": "ConnectRequest",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/ConnectResponse.json

@@ -0,0 +1,81 @@
+{
+  "$defs": {
+    "Lease": {
+      "additionalProperties": false,
+      "description": "A time-boxed grant of the direct coordinates. Renewed before `expires_at`; `epoch` is the\nworker/secret generation — a client holding a stale epoch against a new worker gets 401 and must\nre-connect.",
+      "properties": {
+        "epoch": {
+          "description": "Worker/secret generation counter; rolls on worker change",
+          "title": "Epoch",
+          "type": "integer"
+        },
+        "expires_at": {
+          "format": "date-time",
+          "title": "Expires At",
+          "type": "string"
+        },
+        "ttl_s": {
+          "title": "Ttl S",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "ttl_s",
+        "expires_at",
+        "epoch"
+      ],
+      "title": "Lease",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "description": "200 — the full set of coordinates for a direct worker connection.\n\n`direct_secret` is a plaintext platform-minted bearer for the worker's `/act`; it is on the\nallow-list of fields permitted to carry a secret value in the down direction (契约 6 / goal 15).",
+  "properties": {
+    "cert_fingerprint": {
+      "description": "Self-signed cert fingerprint the SDK pins",
+      "title": "Cert Fingerprint",
+      "type": "string"
+    },
+    "direct_secret": {
+      "description": "Bearer for the worker /act; valid within the lease",
+      "title": "Direct Secret",
+      "type": "string"
+    },
+    "lease": {
+      "$ref": "#/$defs/Lease"
+    },
+    "warming": {
+      "default": false,
+      "description": "True → worker still warming; see warming_eta_s",
+      "title": "Warming",
+      "type": "boolean"
+    },
+    "warming_eta_s": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Seconds until warm, when warming",
+      "title": "Warming Eta S"
+    },
+    "worker_url": {
+      "description": "Worker static-IP direct URL, e.g. https://<ip>:8080",
+      "title": "Worker Url",
+      "type": "string"
+    }
+  },
+  "required": [
+    "worker_url",
+    "cert_fingerprint",
+    "direct_secret",
+    "lease"
+  ],
+  "title": "ConnectResponse",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/DeploymentAccepted.json

@@ -0,0 +1,22 @@
+{
+  "additionalProperties": false,
+  "description": "202 — the build is async; the id comes back first, status pinned to `building`.",
+  "properties": {
+    "deployment_id": {
+      "title": "Deployment Id",
+      "type": "string"
+    },
+    "status": {
+      "const": "building",
+      "default": "building",
+      "title": "Status",
+      "type": "string"
+    }
+  },
+  "required": [
+    "deployment_id"
+  ],
+  "title": "DeploymentAccepted",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}

sequence_base/schemas/DeploymentPolicy.json

@@ -0,0 +1,101 @@
+{
+  "$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"
+    },
+    "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"
+    }
+  },
+  "additionalProperties": false,
+  "description": "The policy block of the deployments body. `handler_ref` and `action` are required; `action` is the\nfixed obs→ActionChunk contract, not a bare dict.\n\n`secrets` carries the policy's declared secret BUNDLES BY NAME ONLY (list[SecretRef]) — the gateway\nvalidates each name exists and belongs to the deployer at submit time (accounts ⑦ / S3 goal 14), and the\nworker bootstrap fetches the matching env group by name. A secret VALUE never travels here: SecretRef is\nname-only, so this field cannot carry one (S3 goal 15). Defaults to `[]` so a policy with no secrets is\nunaffected.",
+  "properties": {
+    "action": {
+      "$ref": "#/$defs/ActionContract"
+    },
+    "frames_per_chunk": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Frames Per Chunk"
+    },
+    "handler_ref": {
+      "title": "Handler Ref",
+      "type": "string"
+    },
+    "secrets": {
+      "items": {
+        "$ref": "#/$defs/SecretRef"
+      },
+      "title": "Secrets",
+      "type": "array"
+    },
+    "streaming": {
+      "default": false,
+      "title": "Streaming",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "handler_ref",
+    "action"
+  ],
+  "title": "DeploymentPolicy",
+  "type": "object",
+  "x-contract-version": "0.4.1"
+}