sequence-base 0.8.0rc3__tar.gz → 0.8.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/PKG-INFO +1 -1
  2. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/pyproject.toml +1 -1
  3. sequence_base-0.8.1/sequence_base/constants/serving.py +52 -0
  4. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/constants/version.py +2 -1
  5. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/__init__.py +1 -2
  6. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/adapters.py +1 -1
  7. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/benchmarks.py +1 -2
  8. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/deployments.py +6 -2
  9. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/policy.py +7 -32
  10. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/settings.py +8 -5
  11. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/templates.py +1 -1
  12. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/volumes.py +3 -4
  13. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ActRequest.json +1 -1
  14. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ActResponse.json +1 -1
  15. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ActionChunk.json +1 -1
  16. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ActionContract.json +1 -1
  17. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ActionStep.json +1 -1
  18. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/AdapterPair.json +1 -1
  19. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/AddLocal.json +1 -1
  20. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Autoscaler.json +1 -1
  21. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/BenchmarkRegisterRequest.json +2 -2
  22. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/BenchmarkSpec.json +3 -3
  23. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/BenchmarkStatusResponse.json +1 -1
  24. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/BootstrapResponse.json +1 -1
  25. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Camera.json +1 -1
  26. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/CodeBundle.json +1 -1
  27. sequence_base-0.8.1/sequence_base/schemas/Concurrency.json +57 -0
  28. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/DeploymentAccepted.json +1 -1
  29. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/DeploymentPolicy.json +1 -1
  30. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/DeploymentRequest.json +3 -59
  31. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/DeploymentStatusResponse.json +1 -18
  32. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ErrorBody.json +1 -1
  33. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ErrorCodes.json +1 -1
  34. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Estimate.json +1 -1
  35. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/EvalDryRunResponse.json +1 -1
  36. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/EvalReport.json +1 -1
  37. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/EvalRequest.json +1 -1
  38. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/EvalResponse.json +1 -1
  39. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageFrame.json +1 -1
  40. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageSpec.json +2 -2
  41. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepAddLocal.json +1 -1
  42. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepApt.json +1 -1
  43. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepEnv.json +1 -1
  44. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepProject.json +1 -1
  45. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepRun.json +1 -1
  46. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepTemplateFiles.json +2 -2
  47. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ImageStepUvPip.json +1 -1
  48. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/InferParam.json +1 -1
  49. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Lease.json +1 -1
  50. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/MetricAgg.json +1 -1
  51. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Observation.json +1 -1
  52. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ObservationContract.json +1 -1
  53. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ObserveRequest.json +1 -1
  54. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ObserveResponse.json +1 -1
  55. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlanAppend.json +1 -1
  56. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlanAppended.json +1 -1
  57. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerMember.json +1 -1
  58. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerObservation.json +1 -1
  59. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerObserve.json +1 -1
  60. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerObserved.json +1 -1
  61. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerPlanIn.json +1 -1
  62. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerPlans.json +1 -1
  63. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerPlansWritten.json +1 -1
  64. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerRobot.json +1 -1
  65. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerRound.json +1 -1
  66. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerRoundRequest.json +1 -1
  67. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PlannerSpec.json +1 -1
  68. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PolicyRegistration.json +4 -60
  69. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/PolicySpec.json +3 -59
  70. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Project.json +1 -1
  71. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Proprioception.json +1 -1
  72. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/ReplaySpec.json +1 -1
  73. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Resources.json +1 -1
  74. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/RolloutResult.json +1 -1
  75. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SecretCreateRequest.json +1 -1
  76. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SecretInfo.json +1 -1
  77. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SecretRef.json +1 -1
  78. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SeqFlags.json +1 -1
  79. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SettingsChange.json +1 -1
  80. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SettingsChanged.json +1 -1
  81. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/SettingsView.json +1 -1
  82. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/TaskAgg.json +1 -1
  83. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/TemplateFiles.json +2 -2
  84. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Tensors.json +1 -1
  85. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/Timeouts.json +1 -1
  86. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/UploadTarget.json +1 -1
  87. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeFile.json +1 -1
  88. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeInfo.json +1 -1
  89. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeMount.json +1 -1
  90. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeRef.json +1 -1
  91. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeUploadRequest.json +1 -1
  92. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/VolumeUploadResponse.json +1 -1
  93. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schemas/WarmingError.json +1 -1
  94. sequence_base-0.8.0rc3/sequence_base/schemas/Concurrency.json +0 -113
  95. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/.gitignore +0 -0
  96. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/README.md +0 -0
  97. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/__init__.py +0 -0
  98. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/auth.py +0 -0
  99. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/by_name.py +0 -0
  100. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/codec/__init__.py +0 -0
  101. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/codec/blocks.py +0 -0
  102. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/codec/compressed.py +0 -0
  103. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/codec/image.py +0 -0
  104. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/codec/marked.py +0 -0
  105. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/constants/__init__.py +0 -0
  106. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/constants/cards.py +0 -0
  107. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/constants/headers.py +0 -0
  108. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/constants/limits.py +0 -0
  109. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/construct.py +0 -0
  110. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/accounts.py +0 -0
  111. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/connect.py +0 -0
  112. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/errors.py +0 -0
  113. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/eval.py +0 -0
  114. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/flags.py +0 -0
  115. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/observe.py +0 -0
  116. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/own_io.py +0 -0
  117. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/planner.py +0 -0
  118. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/contract/wire.py +0 -0
  119. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/episode.py +0 -0
  120. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/errors/__init__.py +0 -0
  121. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/errors/transport.py +0 -0
  122. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/msgpack_io.py +0 -0
  123. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/obs/__init__.py +0 -0
  124. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/obs/log.py +0 -0
  125. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/obs/rid.py +0 -0
  126. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/presets/__init__.py +0 -0
  127. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/presets/prompts.py +0 -0
  128. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/presets/robot_arm.py +0 -0
  129. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/schema_export.py +0 -0
  130. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/telemetry/__init__.py +0 -0
  131. {sequence_base-0.8.0rc3 → sequence_base-0.8.1}/sequence_base/telemetry/events.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: sequence-base
3
- Version: 0.8.0rc3
3
+ Version: 0.8.1
4
4
  Summary: Shared foundation for the Sequences platform — wire contract, correlation, error taxonomy, constants. Used by the robot SDK, gateway, and container harness.
5
5
  Project-URL: Changelog, https://generalsequences.com/docs/changelog/
6
6
  Requires-Python: >=3.10
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "sequence-base"
3
- version = "0.8.0rc3"
3
+ version = "0.8.1"
4
4
  description = "Shared foundation for the Sequences platform — wire contract, correlation, error taxonomy, constants. Used by the robot SDK, gateway, and container harness."
5
5
  requires-python = ">=3.10"
6
6
  dependencies = ["pydantic>=2.0"]
@@ -0,0 +1,52 @@
1
+ """The platform's serving numbers, defined once here: how long an idle worker stays, how long a start, a line and an act
2
+ may take, how a robot's heartbeat and a console's teleop are held, how many robots a copy of a model seats, how many
3
+ cards one machine has and why a worker stopped serving - the gateway, the worker and the SDK each kept a copy of these.
4
+
5
+ """
6
+
7
+
8
+
9
+ IDLE_S = 600
10
+
11
+ QUEUE_TIMEOUT_S = 120
12
+
13
+
14
+ START_WAIT_S = 600
15
+
16
+
17
+
18
+
19
+ STARTUP_TIMEOUT_S = 1800
20
+ REQUEST_TIMEOUT_S = 300
21
+ EPISODE_IDLE_S = 300
22
+
23
+
24
+
25
+ HEARTBEAT_WINDOW_S = 2.0
26
+
27
+
28
+ TELEOP_BEAT_S = 0.5
29
+ TELEOP_LOST_S = 3.0
30
+
31
+
32
+
33
+
34
+
35
+ MARGIN_MS = 50.0
36
+ LOAD_MAX = 0.9
37
+ ROUND_TRIP_MS = 100.0
38
+ MAX_ROBOTS_PER_COPY = 64
39
+
40
+
41
+ MACHINE_CARDS = 8
42
+
43
+ MAX_WARM_WORKERS = 16
44
+
45
+
46
+
47
+ MAX_SOURCE_TREE_BYTES = 64 * 1024 * 1024
48
+
49
+
50
+
51
+
52
+ DEATH_CAUSES = ("gpu_out_of_memory", "host_out_of_memory", "crashed", "hung", "group_member_lost", "load_failed")
@@ -4,7 +4,8 @@
4
4
 
5
5
 
6
6
 
7
- CONTRACT_VERSION = "0.5.38"
7
+ CONTRACT_VERSION = "0.5.39"
8
+
8
9
 
9
10
 
10
11
 
@@ -102,7 +102,6 @@ from sequence_base.contract.adapters import AdapterPair, parse_pairs
102
102
 
103
103
  from sequence_base.contract.volumes import (
104
104
  MAX_FILES,
105
- MAX_UPLOAD_BYTES,
106
105
  UploadTarget,
107
106
  VolumeFile,
108
107
  VolumeInfo,
@@ -179,7 +178,7 @@ __all__ = [
179
178
 
180
179
  "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse",
181
180
 
182
- "MAX_FILES", "MAX_UPLOAD_BYTES", "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse",
181
+ "MAX_FILES", "VolumeFile", "VolumeUploadRequest", "UploadTarget", "VolumeUploadResponse",
183
182
  "VolumeInfo", "check_volume_name", "parse_vol",
184
183
 
185
184
  "SETTINGS", "Setting", "SettingsChange", "Applied", "SettingState", "SettingsView", "SettingChanged",
@@ -57,7 +57,7 @@ def _side(value: Any, which: str, i: int) -> str:
57
57
  return side
58
58
  if side.startswith(TEMPLATE):
59
59
  if not _TEMPLATE_NAME.fullmatch(side[len(TEMPLATE):]):
60
- raise ValueError(f"pair {i}: {which} {value!r}: a template is template:<name>, the name `seq init` takes "
60
+ raise ValueError(f"pair {i}: {which} {value!r}: a template is template:<name>, an official template's name "
61
61
  "(lowercase letters, digits or '-'), e.g. template:libero-10")
62
62
  return side
63
63
  if not _NAME.fullmatch(side):
@@ -36,8 +36,7 @@ TASK_NAME = r"^[A-Za-z0-9][A-Za-z0-9._/:-]{0,127}$"
36
36
 
37
37
  SETUP_GONE = ("@seq.setup is gone: a benchmark builds its worlds in its constructor, after the machine's snapshot - "
38
38
  'init= its arguments, "{num_worlds}" how many worlds this eval builds and "{policy.<field>}" what the '
39
- "evaluated policy declares; a benchmark registered with @seq.setup is registered again with sequence-ai "
40
- "0.51.1 or later (seq deploy)")
39
+ "evaluated policy declares; a benchmark registered with @seq.setup has to be registered again")
41
40
 
42
41
 
43
42
  def _names_worlds(constructor: PolicyConstructor | None) -> bool:
@@ -56,6 +56,8 @@ class Resources(BaseModel):
56
56
 
57
57
 
58
58
 
59
+
60
+
59
61
  cpu: float | None = Field(default=None, ge=0.125, le=64)
60
62
  cpu_limit: float | None = Field(default=None, ge=0.125, le=128)
61
63
  memory_gb: float | None = Field(default=None, ge=0.125, le=1024)
@@ -366,6 +368,10 @@ class DeploymentRequest(BaseModel):
366
368
 
367
369
 
368
370
 
371
+
372
+
373
+
374
+
369
375
  _NAME = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,63}")
370
376
 
371
377
 
@@ -395,5 +401,3 @@ class DeploymentStatusResponse(BaseModel):
395
401
  status: DeploymentState
396
402
  model: str
397
403
  error: str | None = Field(default=None, description="Build-failure reason; set only when FAILED")
398
-
399
- reason: Literal["gpu_out_of_memory", "host_out_of_memory", "crashed"] | None = None
@@ -115,7 +115,7 @@ class TemplateFiles(BaseModel):
115
115
 
116
116
  model_config = ConfigDict(extra="forbid")
117
117
 
118
- template: str = Field(..., pattern=r"^[a-z0-9][a-z0-9-]{0,63}$", description="the template's name, as seq init takes it")
118
+ template: str = Field(..., pattern=r"^[a-z0-9][a-z0-9-]{0,63}$", description="the official template's name")
119
119
  version: int = Field(..., ge=1, le=999_999_999, description="the template version whose files these are")
120
120
 
121
121
 
@@ -279,11 +279,8 @@ class VolumeRef(BaseModel):
279
279
 
280
280
 
281
281
  class Concurrency(BaseModel):
282
- """How one worker serves robots, every field optional. `replicas_per_gpu` model copies share each card (each copy is
283
- its own process and serves one control loop); `gpus_per_replica` cards make one copy (None: every card of the
284
- worker). A worker's slots = cards // gpus_per_replica × replicas_per_gpu. `target_inputs` is how many robot sessions
285
- a worker holds before another starts, `max_inputs` the most it takes while a new one boots — both default to the
286
- slots.
282
+ """How one worker serves robots, every field optional. `gpus_per_replica` cards make one copy (None: every card of
283
+ the worker makes its own copy).
287
284
 
288
285
  `sizes` (contract 0.5.31) - from `@seq.concurrent(sizes=[1, 2, 4, 8])` on the policy's infer method - are the batch
289
286
  sizes its infer is called with, ascending, the largest the most acts one forward takes (None: one robot a copy,
@@ -292,25 +289,14 @@ class Concurrency(BaseModel):
292
289
  robot's act being a batch of one. A copy seats as many robots
293
290
  as the largest size whose batch answers their control loops in time, and its worker holds an early act a little so
294
291
  robots fall into one batch.
295
- `dynamic` - seating robots apart while each could be served
296
- alone, or max_concurrent a copy however late - is gone. The SDK takes `gpus_per_replica` and `replica_start` in
292
+ The SDK takes `gpus_per_replica` and `replica_start` in
297
293
  `@seq.policy(...)`.
298
-
299
-
300
- `max_concurrent` (contract 0.5.5: one number, the largest batch, every size up to it possible), `max_inputs`,
301
- `target_inputs` and `replicas_per_gpu` are older ways': kept so a stored spec and an older SDK's request still
302
- read, and refused on a new deploy by the platform; the SDK from contract 0.5.31 sends none of them.
303
-
304
- """
294
+ """
305
295
 
306
296
  model_config = ConfigDict(extra="forbid")
307
297
 
308
298
  sizes: list[int] | None = Field(default=None, min_length=1, max_length=256,
309
299
  description="The batch sizes infer is called with, ascending; the largest the most")
310
- max_concurrent: int | None = Field(default=None, ge=2, le=256)
311
- max_inputs: int | None = Field(default=None, ge=1, le=1024)
312
- target_inputs: int | None = Field(default=None, ge=1, le=1024)
313
- replicas_per_gpu: int | None = Field(default=None, ge=1, le=64)
314
300
  gpus_per_replica: int | None = Field(default=None, ge=1, le=256)
315
301
 
316
302
 
@@ -331,17 +317,6 @@ class Concurrency(BaseModel):
331
317
  raise ValueError("the batch sizes begin with 1: a lone robot's act is a batch of one")
332
318
  return v
333
319
 
334
- @model_validator(mode="after")
335
- def _consistent(self) -> "Concurrency":
336
- if self.sizes is not None and self.max_concurrent is not None:
337
- raise ValueError("a policy declares its batch sizes (sizes) or, as an older SDK did, one max_concurrent - "
338
- "not both")
339
- if self.max_inputs is not None and self.target_inputs is not None and self.max_inputs < self.target_inputs:
340
- raise ValueError("max_inputs must be at least target_inputs")
341
- if (self.gpus_per_replica or 1) > 1 and (self.replicas_per_gpu or 1) > 1:
342
- raise ValueError("a copy that spans several cards is one copy per card group: replicas_per_gpu must be 1")
343
- return self
344
-
345
320
 
346
321
 
347
322
 
@@ -436,7 +411,7 @@ class PolicySpec(BaseModel):
436
411
  if self.planner is not None:
437
412
  said = [name for name in ("hz", "action_chunk_valid_len", "action_chunk_replan_at", "tensors")
438
413
  if getattr(self, name) is not None]
439
- said += [f"concurrency.{name}" for name in ("sizes", "max_concurrent", "max_inputs", "target_inputs")
414
+ said += [f"concurrency.{name}" for name in ("sizes",)
440
415
  if self.concurrency is not None and getattr(self.concurrency, name) is not None]
441
416
  if said:
442
417
  raise ValueError(f"a planner answers no act, so it declares no {', '.join(said)}")
@@ -481,7 +456,7 @@ def check_weights_uri(v: str, what: str = "weights") -> str:
481
456
  if v.startswith("hf://") and len(v) > len("hf://"):
482
457
  return v
483
458
  raise ValueError(f"{what} must be a template:// official template, an hf:// repo or a vol:// volume: upload files "
484
- "of your own once as a volume (seq volume put <name> <dir>) and use vol://<name>")
459
+ "of your own once as a volume and use vol://<name>")
485
460
 
486
461
 
487
462
  def check_weights_parts(weights_name: str | None, extra: dict) -> None:
@@ -25,6 +25,8 @@ from typing import Literal
25
25
 
26
26
  from pydantic import BaseModel, ConfigDict, Field
27
27
 
28
+ from sequence_base.constants.serving import EPISODE_IDLE_S, MAX_WARM_WORKERS, STARTUP_TIMEOUT_S
29
+
28
30
  __all__ = [
29
31
  "Reads",
30
32
  "Setting",
@@ -90,14 +92,15 @@ SETTINGS: tuple[Setting, ...] = (
90
92
  minimum=1, maximum=256, unit="GPUs", code="max_gpus"),
91
93
  _s("min_workers", "int", "gateway", "scaling", "Workers kept running, and billed, whether or not a robot is "
92
94
  "connected.",
93
- minimum=0, maximum=16, unit="workers", code="min_workers", default=0),
95
+ minimum=0, maximum=MAX_WARM_WORKERS, unit="workers", code="min_workers", default=0),
94
96
  _s("buffer_workers", "int", "gateway", "scaling", "Spare running workers, billed, beside the busy ones, so a robot "
95
- "that connects or loses its worker starts at once.", minimum=0, maximum=16, unit="workers", code="buffer_workers",
97
+ "that connects or loses its worker starts at once.", minimum=0, maximum=MAX_WARM_WORKERS, unit="workers",
98
+ code="buffer_workers",
96
99
  default=0),
97
100
  _s("schedule.hours", "str", "gateway", "scaling", "Days and hours it keeps schedule.min_workers running, as "
98
101
  "'Mon-Fri 08:00-18:00'.", max_length=80),
99
102
  _s("schedule.min_workers", "int", "gateway", "scaling", "Workers kept running in schedule.hours.",
100
- minimum=0, maximum=16, unit="workers"),
103
+ minimum=0, maximum=MAX_WARM_WORKERS, unit="workers"),
101
104
  _s("schedule.tz", "str", "gateway", "scaling", "The time zone of schedule.hours, as 'America/Los_Angeles'.",
102
105
  max_length=64, default="UTC"),
103
106
 
@@ -124,9 +127,9 @@ SETTINGS: tuple[Setting, ...] = (
124
127
  "that it timed out.", minimum=1, maximum=3600, unit="s", code="seq.Timeouts(request=)"),
125
128
  _s("timeouts.episode_idle", "int", "workers", "timeouts", "How long an episode may go without an act before its "
126
129
  "place goes to a new one.", minimum=10, maximum=86400, unit="s", code="seq.Timeouts(episode_idle=)",
127
- default=300),
130
+ default=EPISODE_IDLE_S),
128
131
  _s("timeouts.startup", "int", "new_workers", "timeouts", "How long a worker may take to load.",
129
- minimum=60, maximum=18000, unit="s", code="seq.Timeouts(startup=)", default=1800),
132
+ minimum=60, maximum=18000, unit="s", code="seq.Timeouts(startup=)", default=STARTUP_TIMEOUT_S),
130
133
 
131
134
  _s("plan.every_s", "float", "workers", "planner", "Seconds between calls of its @seq.plan method.",
132
135
  above=0, unit="s", code="@seq.plan(every_s=)"),
@@ -24,7 +24,7 @@ def parse_template(uri: str) -> tuple[str, int | None]:
24
24
  name, _, ver = uri[len(TEMPLATE_SCHEME):].strip().rstrip("/").partition("@")
25
25
  if not _NAME.fullmatch(name):
26
26
  raise ValueError(f"{uri!r}: a template name is 1-64 lowercase letters, digits or '-', starting with a "
27
- "letter or digit — the name `seq init` takes, e.g. template://pi05-droid")
27
+ "letter or digit, e.g. template://pi05-droid")
28
28
  if not ver:
29
29
  return name, None
30
30
  m = _VERSION.fullmatch(ver)
@@ -26,8 +26,9 @@ _NAME = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,63}")
26
26
  _VERSION = re.compile(r"v([1-9][0-9]{0,8})")
27
27
 
28
28
 
29
+
30
+
29
31
  MAX_FILES = 10_000
30
- MAX_UPLOAD_BYTES = 500 * 1024 ** 3
31
32
 
32
33
 
33
34
  def parse_vol(uri: str) -> tuple[str, int | None]:
@@ -94,12 +95,10 @@ class VolumeUploadRequest(BaseModel):
94
95
  files: list[VolumeFile] = Field(..., min_length=1, max_length=MAX_FILES)
95
96
 
96
97
  @model_validator(mode="after")
97
- def _unique_and_bounded(self) -> "VolumeUploadRequest":
98
+ def _unique(self) -> "VolumeUploadRequest":
98
99
  paths = [f.path for f in self.files]
99
100
  if len(set(paths)) != len(paths):
100
101
  raise ValueError("each file path may appear only once")
101
- if sum(f.size for f in self.files) > MAX_UPLOAD_BYTES:
102
- raise ValueError(f"one upload may hold at most {MAX_UPLOAD_BYTES // 1024 ** 3} GB")
103
102
  return self
104
103
 
105
104
 
@@ -78,5 +78,5 @@
78
78
  },
79
79
  "title": "ActRequest",
80
80
  "type": "object",
81
- "x-contract-version": "0.5.38"
81
+ "x-contract-version": "0.5.39"
82
82
  }
@@ -53,5 +53,5 @@
53
53
  ],
54
54
  "title": "ActResponse",
55
55
  "type": "object",
56
- "x-contract-version": "0.5.38"
56
+ "x-contract-version": "0.5.39"
57
57
  }
@@ -99,5 +99,5 @@
99
99
  ],
100
100
  "title": "ActionChunk",
101
101
  "type": "object",
102
- "x-contract-version": "0.5.38"
102
+ "x-contract-version": "0.5.39"
103
103
  }
@@ -96,5 +96,5 @@
96
96
  ],
97
97
  "title": "ActionContract",
98
98
  "type": "object",
99
- "x-contract-version": "0.5.38"
99
+ "x-contract-version": "0.5.39"
100
100
  }
@@ -19,5 +19,5 @@
19
19
  ],
20
20
  "title": "ActionStep",
21
21
  "type": "object",
22
- "x-contract-version": "0.5.38"
22
+ "x-contract-version": "0.5.39"
23
23
  }
@@ -17,5 +17,5 @@
17
17
  ],
18
18
  "title": "AdapterPair",
19
19
  "type": "object",
20
- "x-contract-version": "0.5.38"
20
+ "x-contract-version": "0.5.39"
21
21
  }
@@ -23,5 +23,5 @@
23
23
  ],
24
24
  "title": "AddLocal",
25
25
  "type": "object",
26
- "x-contract-version": "0.5.38"
26
+ "x-contract-version": "0.5.39"
27
27
  }
@@ -36,5 +36,5 @@
36
36
  },
37
37
  "title": "Autoscaler",
38
38
  "type": "object",
39
- "x-contract-version": "0.5.38"
39
+ "x-contract-version": "0.5.39"
40
40
  }
@@ -519,7 +519,7 @@
519
519
  "description": "An official template version's frozen build files - the source at its pinned commit, every Python package and\nsystem package its image installs, the assets it downloads - which the platform keeps itself, so a build never\nreaches the sites they came from (`seq.Image.template_files`). Each run_commands step after this one reads them,\nread-only, at FROZEN_PATH; nothing of them stays in the image unless a step copies or installs it.",
520
520
  "properties": {
521
521
  "template": {
522
- "description": "the template's name, as seq init takes it",
522
+ "description": "the official template's name",
523
523
  "pattern": "^[a-z0-9][a-z0-9-]{0,63}$",
524
524
  "title": "Template",
525
525
  "type": "string"
@@ -773,5 +773,5 @@
773
773
  ],
774
774
  "title": "BenchmarkRegisterRequest",
775
775
  "type": "object",
776
- "x-contract-version": "0.5.38"
776
+ "x-contract-version": "0.5.39"
777
777
  }
@@ -435,7 +435,7 @@
435
435
  ],
436
436
  "title": "SeqFlags",
437
437
  "type": "integer",
438
- "x-contract-version": "0.5.38",
438
+ "x-contract-version": "0.5.39",
439
439
  "x-flag-names": {
440
440
  "ACTION": 1048576,
441
441
  "CHECK": 65536,
@@ -458,7 +458,7 @@
458
458
  "description": "An official template version's frozen build files - the source at its pinned commit, every Python package and\nsystem package its image installs, the assets it downloads - which the platform keeps itself, so a build never\nreaches the sites they came from (`seq.Image.template_files`). Each run_commands step after this one reads them,\nread-only, at FROZEN_PATH; nothing of them stays in the image unless a step copies or installs it.",
459
459
  "properties": {
460
460
  "template": {
461
- "description": "the template's name, as seq init takes it",
461
+ "description": "the official template's name",
462
462
  "pattern": "^[a-z0-9][a-z0-9-]{0,63}$",
463
463
  "title": "Template",
464
464
  "type": "string"
@@ -702,5 +702,5 @@
702
702
  ],
703
703
  "title": "BenchmarkSpec",
704
704
  "type": "object",
705
- "x-contract-version": "0.5.38"
705
+ "x-contract-version": "0.5.39"
706
706
  }
@@ -40,5 +40,5 @@
40
40
  ],
41
41
  "title": "BenchmarkStatusResponse",
42
42
  "type": "object",
43
- "x-contract-version": "0.5.38"
43
+ "x-contract-version": "0.5.39"
44
44
  }
@@ -79,5 +79,5 @@
79
79
  ],
80
80
  "title": "BootstrapResponse",
81
81
  "type": "object",
82
- "x-contract-version": "0.5.38"
82
+ "x-contract-version": "0.5.39"
83
83
  }
@@ -72,5 +72,5 @@
72
72
  ],
73
73
  "title": "Camera",
74
74
  "type": "object",
75
- "x-contract-version": "0.5.38"
75
+ "x-contract-version": "0.5.39"
76
76
  }
@@ -23,5 +23,5 @@
23
23
  ],
24
24
  "title": "CodeBundle",
25
25
  "type": "object",
26
- "x-contract-version": "0.5.38"
26
+ "x-contract-version": "0.5.39"
27
27
  }
@@ -0,0 +1,57 @@
1
+ {
2
+ "additionalProperties": false,
3
+ "description": "How one worker serves robots, every field optional. `gpus_per_replica` cards make one copy (None: every card of\n the worker makes its own copy).\n\n `sizes` (contract 0.5.31) - from `@seq.concurrent(sizes=[1, 2, 4, 8])` on the policy's infer method - are the batch\n sizes its infer is called with, ascending, the largest the most acts one forward takes (None: one robot a copy,\n each act alone): the sizes its code is built for, which only its author knows - each warmed and timed on its sample\n episode before a copy serves, and a batch of some other number of acts split into them - 1 always among them, a lone\n robot's act being a batch of one. A copy seats as many robots\n as the largest size whose batch answers their control loops in time, and its worker holds an early act a little so\n robots fall into one batch.\nThe SDK takes `gpus_per_replica` and `replica_start` in\n `@seq.policy(...)`.\n ",
4
+ "properties": {
5
+ "gpus_per_replica": {
6
+ "anyOf": [
7
+ {
8
+ "maximum": 256,
9
+ "minimum": 1,
10
+ "type": "integer"
11
+ },
12
+ {
13
+ "type": "null"
14
+ }
15
+ ],
16
+ "default": null,
17
+ "title": "Gpus Per Replica"
18
+ },
19
+ "replica_start": {
20
+ "anyOf": [
21
+ {
22
+ "enum": [
23
+ "together",
24
+ "one_by_one"
25
+ ],
26
+ "type": "string"
27
+ },
28
+ {
29
+ "type": "null"
30
+ }
31
+ ],
32
+ "default": null,
33
+ "title": "Replica Start"
34
+ },
35
+ "sizes": {
36
+ "anyOf": [
37
+ {
38
+ "items": {
39
+ "type": "integer"
40
+ },
41
+ "maxItems": 256,
42
+ "minItems": 1,
43
+ "type": "array"
44
+ },
45
+ {
46
+ "type": "null"
47
+ }
48
+ ],
49
+ "default": null,
50
+ "description": "The batch sizes infer is called with, ascending; the largest the most",
51
+ "title": "Sizes"
52
+ }
53
+ },
54
+ "title": "Concurrency",
55
+ "type": "object",
56
+ "x-contract-version": "0.5.39"
57
+ }
@@ -18,5 +18,5 @@
18
18
  ],
19
19
  "title": "DeploymentAccepted",
20
20
  "type": "object",
21
- "x-contract-version": "0.5.38"
21
+ "x-contract-version": "0.5.39"
22
22
  }
@@ -330,5 +330,5 @@
330
330
  ],
331
331
  "title": "DeploymentPolicy",
332
332
  "type": "object",
333
- "x-contract-version": "0.5.38"
333
+ "x-contract-version": "0.5.39"
334
334
  }
@@ -93,7 +93,7 @@
93
93
  },
94
94
  "Concurrency": {
95
95
  "additionalProperties": false,
96
- "description": "How one worker serves robots, every field optional. `replicas_per_gpu` model copies share each card (each copy is\n its own process and serves one control loop); `gpus_per_replica` cards make one copy (None: every card of the\n worker). A worker's slots = cards // gpus_per_replica × replicas_per_gpu. `target_inputs` is how many robot sessions\n a worker holds before another starts, `max_inputs` the most it takes while a new one boots — both default to the\n slots.\n\n `sizes` (contract 0.5.31) - from `@seq.concurrent(sizes=[1, 2, 4, 8])` on the policy's infer method - are the batch\n sizes its infer is called with, ascending, the largest the most acts one forward takes (None: one robot a copy,\n each act alone): the sizes its code is built for, which only its author knows - each warmed and timed on its sample\n episode before a copy serves, and a batch of some other number of acts split into them - 1 always among them, a lone\n robot's act being a batch of one. A copy seats as many robots\n as the largest size whose batch answers their control loops in time, and its worker holds an early act a little so\n robots fall into one batch.\n`dynamic` - seating robots apart while each could be served\n alone, or max_concurrent a copy however late - is gone. The SDK takes `gpus_per_replica` and `replica_start` in\n `@seq.policy(...)`.\n\n\n `max_concurrent` (contract 0.5.5: one number, the largest batch, every size up to it possible), `max_inputs`,\n `target_inputs` and `replicas_per_gpu` are older ways': kept so a stored spec and an older SDK's request still\n read, and refused on a new deploy by the platform; the SDK from contract 0.5.31 sends none of them.\n ",
96
+ "description": "How one worker serves robots, every field optional. `gpus_per_replica` cards make one copy (None: every card of\n the worker makes its own copy).\n\n `sizes` (contract 0.5.31) - from `@seq.concurrent(sizes=[1, 2, 4, 8])` on the policy's infer method - are the batch\n sizes its infer is called with, ascending, the largest the most acts one forward takes (None: one robot a copy,\n each act alone): the sizes its code is built for, which only its author knows - each warmed and timed on its sample\n episode before a copy serves, and a batch of some other number of acts split into them - 1 always among them, a lone\n robot's act being a batch of one. A copy seats as many robots\n as the largest size whose batch answers their control loops in time, and its worker holds an early act a little so\n robots fall into one batch.\nThe SDK takes `gpus_per_replica` and `replica_start` in\n `@seq.policy(...)`.\n ",
97
97
  "properties": {
98
98
  "gpus_per_replica": {
99
99
  "anyOf": [
@@ -109,34 +109,6 @@
109
109
  "default": null,
110
110
  "title": "Gpus Per Replica"
111
111
  },
112
- "max_concurrent": {
113
- "anyOf": [
114
- {
115
- "maximum": 256,
116
- "minimum": 2,
117
- "type": "integer"
118
- },
119
- {
120
- "type": "null"
121
- }
122
- ],
123
- "default": null,
124
- "title": "Max Concurrent"
125
- },
126
- "max_inputs": {
127
- "anyOf": [
128
- {
129
- "maximum": 1024,
130
- "minimum": 1,
131
- "type": "integer"
132
- },
133
- {
134
- "type": "null"
135
- }
136
- ],
137
- "default": null,
138
- "title": "Max Inputs"
139
- },
140
112
  "replica_start": {
141
113
  "anyOf": [
142
114
  {
@@ -153,20 +125,6 @@
153
125
  "default": null,
154
126
  "title": "Replica Start"
155
127
  },
156
- "replicas_per_gpu": {
157
- "anyOf": [
158
- {
159
- "maximum": 64,
160
- "minimum": 1,
161
- "type": "integer"
162
- },
163
- {
164
- "type": "null"
165
- }
166
- ],
167
- "default": null,
168
- "title": "Replicas Per Gpu"
169
- },
170
128
  "sizes": {
171
129
  "anyOf": [
172
130
  {
@@ -184,20 +142,6 @@
184
142
  "default": null,
185
143
  "description": "The batch sizes infer is called with, ascending; the largest the most",
186
144
  "title": "Sizes"
187
- },
188
- "target_inputs": {
189
- "anyOf": [
190
- {
191
- "maximum": 1024,
192
- "minimum": 1,
193
- "type": "integer"
194
- },
195
- {
196
- "type": "null"
197
- }
198
- ],
199
- "default": null,
200
- "title": "Target Inputs"
201
145
  }
202
146
  },
203
147
  "title": "Concurrency",
@@ -897,7 +841,7 @@
897
841
  "description": "An official template version's frozen build files - the source at its pinned commit, every Python package and\nsystem package its image installs, the assets it downloads - which the platform keeps itself, so a build never\nreaches the sites they came from (`seq.Image.template_files`). Each run_commands step after this one reads them,\nread-only, at FROZEN_PATH; nothing of them stays in the image unless a step copies or installs it.",
898
842
  "properties": {
899
843
  "template": {
900
- "description": "the template's name, as seq init takes it",
844
+ "description": "the official template's name",
901
845
  "pattern": "^[a-z0-9][a-z0-9-]{0,63}$",
902
846
  "title": "Template",
903
847
  "type": "string"
@@ -1102,5 +1046,5 @@
1102
1046
  ],
1103
1047
  "title": "DeploymentRequest",
1104
1048
  "type": "object",
1105
- "x-contract-version": "0.5.38"
1049
+ "x-contract-version": "0.5.39"
1106
1050
  }