sequence-base 0.6.0__tar.gz → 0.7.0__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 (134) hide show
  1. {sequence_base-0.6.0 → sequence_base-0.7.0}/PKG-INFO +1 -1
  2. {sequence_base-0.6.0 → sequence_base-0.7.0}/pyproject.toml +1 -1
  3. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/constants/version.py +2 -1
  4. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/construct.py +7 -1
  5. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/__init__.py +5 -2
  6. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/connect.py +5 -3
  7. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/deployments.py +7 -7
  8. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/eval.py +23 -5
  9. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/policy.py +44 -11
  10. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/obs/log.py +5 -1
  11. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/presets/robot_arm.py +19 -27
  12. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ActRequest.json +1 -1
  13. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ActResponse.json +1 -1
  14. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ActionChunk.json +1 -1
  15. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ActionContract.json +1 -1
  16. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ActionStep.json +1 -1
  17. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/AdapterPair.json +1 -1
  18. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/AddLocal.json +1 -1
  19. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Autoscaler.json +1 -1
  20. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/BenchmarkRegisterRequest.json +1 -1
  21. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/BenchmarkSpec.json +2 -2
  22. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/BenchmarkStatusResponse.json +1 -1
  23. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/BootstrapResponse.json +1 -1
  24. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Camera.json +1 -51
  25. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/CodeBundle.json +1 -1
  26. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Concurrency.json +1 -1
  27. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ConnectRequest.json +1 -1
  28. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ConnectResponse.json +5 -5
  29. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/DeploymentAccepted.json +1 -1
  30. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/DeploymentPolicy.json +5 -5
  31. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/DeploymentRequest.json +5 -5
  32. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/DeploymentStatusResponse.json +1 -1
  33. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ErrorBody.json +1 -1
  34. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ErrorCodes.json +1 -1
  35. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Estimate.json +1 -1
  36. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/EvalDryRunResponse.json +1 -1
  37. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/EvalReport.json +2 -14
  38. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/EvalRequest.json +1 -14
  39. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/EvalResponse.json +1 -1
  40. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageFrame.json +1 -1
  41. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageSpec.json +1 -1
  42. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepAddLocal.json +1 -1
  43. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepApt.json +1 -1
  44. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepEnv.json +1 -1
  45. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepProject.json +1 -1
  46. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepRun.json +1 -1
  47. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepTemplateFiles.json +1 -1
  48. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ImageStepUvPip.json +1 -1
  49. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/InferParam.json +1 -1
  50. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Lease.json +1 -1
  51. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/MetricAgg.json +1 -1
  52. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Observation.json +1 -1
  53. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ObservationContract.json +1 -51
  54. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ObserveRequest.json +1 -1
  55. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ObserveResponse.json +1 -1
  56. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlanAppend.json +1 -1
  57. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlanAppended.json +1 -1
  58. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerMember.json +1 -1
  59. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerObservation.json +1 -1
  60. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerObserve.json +1 -1
  61. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerObserved.json +1 -1
  62. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerPlanIn.json +1 -1
  63. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerPlans.json +1 -1
  64. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerPlansWritten.json +1 -1
  65. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerRobot.json +1 -1
  66. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerRound.json +1 -1
  67. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerRoundRequest.json +1 -1
  68. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PlannerSpec.json +1 -1
  69. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PolicyRegistration.json +6 -6
  70. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/PolicySpec.json +5 -5
  71. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Project.json +1 -1
  72. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Proprioception.json +1 -1
  73. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/ReplaySpec.json +1 -1
  74. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Resources.json +1 -1
  75. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/RolloutResult.json +1 -1
  76. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SecretCreateRequest.json +1 -1
  77. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SecretInfo.json +1 -1
  78. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SecretRef.json +1 -1
  79. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SeqFlags.json +1 -1
  80. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SettingsChange.json +1 -1
  81. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SettingsChanged.json +1 -1
  82. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/SettingsView.json +1 -1
  83. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Standby.json +1 -1
  84. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/TaskAgg.json +1 -1
  85. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/TemplateFiles.json +1 -1
  86. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Tensors.json +1 -1
  87. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/Timeouts.json +1 -1
  88. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/UploadTarget.json +1 -1
  89. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeFile.json +1 -1
  90. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeInfo.json +1 -1
  91. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeMount.json +1 -1
  92. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeRef.json +1 -1
  93. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeUploadRequest.json +1 -1
  94. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/VolumeUploadResponse.json +1 -1
  95. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schemas/WarmingError.json +1 -1
  96. {sequence_base-0.6.0 → sequence_base-0.7.0}/.gitignore +0 -0
  97. {sequence_base-0.6.0 → sequence_base-0.7.0}/README.md +0 -0
  98. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/__init__.py +0 -0
  99. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/auth.py +0 -0
  100. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/by_name.py +0 -0
  101. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/codec/__init__.py +0 -0
  102. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/codec/compressed.py +0 -0
  103. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/codec/image.py +0 -0
  104. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/codec/marked.py +0 -0
  105. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/constants/__init__.py +0 -0
  106. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/constants/cards.py +0 -0
  107. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/constants/headers.py +0 -0
  108. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/constants/limits.py +0 -0
  109. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/accounts.py +0 -0
  110. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/act.py +0 -0
  111. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/adapters.py +0 -0
  112. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/benchmarks.py +0 -0
  113. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/errors.py +0 -0
  114. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/flags.py +0 -0
  115. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/io.py +0 -0
  116. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/observe.py +0 -0
  117. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/own_io.py +0 -0
  118. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/planner.py +0 -0
  119. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/retired.py +0 -0
  120. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/settings.py +0 -0
  121. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/templates.py +0 -0
  122. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/volumes.py +0 -0
  123. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/contract/wire.py +0 -0
  124. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/episode.py +0 -0
  125. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/errors/__init__.py +0 -0
  126. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/errors/transport.py +0 -0
  127. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/msgpack_io.py +0 -0
  128. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/obs/__init__.py +0 -0
  129. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/obs/rid.py +0 -0
  130. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/presets/__init__.py +0 -0
  131. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/presets/frames.py +0 -0
  132. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/schema_export.py +0 -0
  133. {sequence_base-0.6.0 → sequence_base-0.7.0}/sequence_base/telemetry/__init__.py +0 -0
  134. {sequence_base-0.6.0 → sequence_base-0.7.0}/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.6.0
3
+ Version: 0.7.0
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.6.0"
3
+ version = "0.7.0"
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"]
@@ -4,7 +4,8 @@
4
4
 
5
5
 
6
6
 
7
- CONTRACT_VERSION = "0.5.34"
7
+ CONTRACT_VERSION = "0.5.35"
8
+
8
9
 
9
10
 
10
11
 
@@ -35,7 +35,10 @@ CONFIG_KEY, SET_KEY = "$config", "$set"
35
35
 
36
36
 
37
37
 
38
- POLICY_FIELDS = ("hz", "action_chunk_len", "action_chunk_exec_len")
38
+ POLICY_FIELDS = ("hz", "action_chunk_valid_len", "action_chunk_replan_at")
39
+
40
+
41
+ _RENAMED = {"action_chunk_len": "action_chunk_valid_len", "action_chunk_exec_len": "action_chunk_replan_at"}
39
42
 
40
43
 
41
44
  FORMS = re.compile(r"\{(?:weights(?:\.(?P<part>[A-Za-z_][A-Za-z0-9_-]*))?|(?P<worlds>num_worlds)"
@@ -112,6 +115,9 @@ def _filled(form: re.Match, weights: Any, worlds: int | None, policy: Any) -> An
112
115
  return worlds
113
116
  field = form.group("field")
114
117
  if field is not None:
118
+ if field in _RENAMED:
119
+ raise ConstructError(f"{{policy.{field}}} is now {{policy.{_RENAMED[field]}}}: a policy declares "
120
+ f"{', '.join(POLICY_FIELDS)}")
115
121
  if field not in POLICY_FIELDS:
116
122
  raise ConstructError(f"{{policy.{field}}}: a policy declares {', '.join(POLICY_FIELDS)}")
117
123
  if policy is None:
@@ -20,6 +20,7 @@ from sequence_base.contract.observe import ObserveFrame, ObserveRequest, Observe
20
20
 
21
21
  from sequence_base.contract.flags import SeqFlags
22
22
  from sequence_base.contract.policy import (
23
+ CHUNK_NAMES,
23
24
  Camera,
24
25
  ObservationContract,
25
26
  ActionContract,
@@ -42,6 +43,7 @@ from sequence_base.contract.policy import (
42
43
  PolicySpec,
43
44
  VolumeMount,
44
45
  VolumeRef,
46
+ chunk_names_said,
45
47
  )
46
48
 
47
49
 
@@ -73,6 +75,7 @@ from sequence_base.contract.benchmarks import (
73
75
  ReplaySpec,
74
76
  )
75
77
  from sequence_base.contract.eval import (
78
+ LATENCY_GONE,
76
79
  Estimate,
77
80
  EvalDryRunResponse,
78
81
  EvalReport,
@@ -163,7 +166,7 @@ __all__ = [
163
166
  "ImageStepUvPip", "ImageStepApt", "ImageStepEnv", "ImageStepRun", "AddLocal", "ImageStepAddLocal",
164
167
  "TemplateFiles", "ImageStepTemplateFiles", "Project", "ImageStepProject", "FROZEN_PATH", "ImageStep", "ImageSpec",
165
168
  "VolumeMount", "VolumeRef", "Concurrency", "ActionContract", "Camera", "ObservationContract",
166
- "PolicySpec", "PolicyRegistration", "PolicyConstructor",
169
+ "PolicySpec", "PolicyRegistration", "PolicyConstructor", "CHUNK_NAMES", "chunk_names_said",
167
170
  "OBSERVATIONS_GONE", "Tensors",
168
171
 
169
172
  "MAX_CODE_BUNDLE_BYTES", "CodeBundle",
@@ -173,7 +176,7 @@ __all__ = [
173
176
  "Lease", "ConnectRequest", "ConnectResponse", "Standby",
174
177
 
175
178
  "ReplaySpec", "BenchmarkSpec", "BenchmarkRegisterRequest", "BenchmarkStatusResponse",
176
- "EvalRequest", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
179
+ "LATENCY_GONE", "EvalRequest", "Estimate", "EvalResponse", "EvalDryRunResponse", "RolloutResult",
177
180
  "EvalStatus", "TaskAgg", "MetricAgg", "EvalReport",
178
181
 
179
182
  "SecretRef", "SecretCreateRequest", "SecretInfo", "BootstrapResponse",
@@ -92,8 +92,8 @@ class ConnectResponse(BaseModel):
92
92
 
93
93
 
94
94
  hz: float | None = Field(default=None, gt=0, le=1000)
95
- action_chunk_len: int | None = Field(default=None, ge=1, le=100_000)
96
- action_chunk_exec_len: int | None = Field(default=None, ge=1, le=100_000)
95
+ action_chunk_valid_len: int | None = Field(default=None, ge=1, le=100_000)
96
+ action_chunk_replan_at: int | None = Field(default=None, ge=1, le=100_000)
97
97
 
98
98
  io: str | None = None
99
99
 
@@ -111,4 +111,6 @@ class ConnectResponse(BaseModel):
111
111
  def _retired(cls, data: Any) -> Any:
112
112
 
113
113
 
114
- return dropped(data, "embodiment", "feedback", "action", "observation", "actions", "observations")
114
+
115
+ return dropped(data, "embodiment", "feedback", "action", "observation", "actions", "observations",
116
+ "action_chunk_len", "action_chunk_exec_len")
@@ -32,6 +32,7 @@ from sequence_base.contract.policy import (
32
32
  ImageSpec,
33
33
  VolumeMount,
34
34
  check_chunk_lens,
35
+ chunk_names_renamed,
35
36
  )
36
37
 
37
38
  __all__ = [
@@ -185,18 +186,17 @@ class DeploymentPolicy(BaseModel):
185
186
  @model_validator(mode="before")
186
187
  @classmethod
187
188
  def _retired(cls, data: Any) -> Any:
188
- return dropped(team_gone(observations_gone(data)), "embodiments", "feedback", "action", "observation",
189
- "action_declared", "actions")
189
+ return dropped(chunk_names_renamed(team_gone(observations_gone(data))), "embodiments", "feedback", "action",
190
+ "observation", "action_declared", "actions")
190
191
 
191
192
  handler_ref: str
192
193
 
193
194
 
194
195
 
195
196
 
196
-
197
197
  hz: float | None = Field(default=None, gt=0, le=1000)
198
- action_chunk_len: int | None = Field(default=None, ge=1, le=100_000)
199
- action_chunk_exec_len: int | None = Field(default=None, ge=1, le=100_000)
198
+ action_chunk_valid_len: int | None = Field(default=None, ge=1, le=100_000)
199
+ action_chunk_replan_at: int | None = Field(default=None, ge=1, le=100_000)
200
200
 
201
201
 
202
202
  episodes: Episodes | None = None
@@ -233,7 +233,7 @@ class DeploymentPolicy(BaseModel):
233
233
  @model_validator(mode="after")
234
234
  def _planner_answers_no_act(self) -> "DeploymentPolicy":
235
235
  if self.planner is not None:
236
- said = [name for name in ("hz", "action_chunk_len", "action_chunk_exec_len", "tensors")
236
+ said = [name for name in ("hz", "action_chunk_valid_len", "action_chunk_replan_at", "tensors")
237
237
  if getattr(self, name) is not None]
238
238
  if said:
239
239
  raise ValueError(f"a planner answers no act, so it declares no {', '.join(said)}")
@@ -256,7 +256,7 @@ class DeploymentPolicy(BaseModel):
256
256
 
257
257
  @model_validator(mode="after")
258
258
  def _plays_what_it_holds(self) -> "DeploymentPolicy":
259
- check_chunk_lens(self.action_chunk_len, self.action_chunk_exec_len)
259
+ check_chunk_lens(self.action_chunk_valid_len, self.action_chunk_replan_at)
260
260
  return self
261
261
 
262
262
  @model_validator(mode="after")
@@ -15,8 +15,10 @@ from typing import Annotated, Literal
15
15
  from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
16
16
 
17
17
  from sequence_base.constants.limits import MAX_USD
18
+ from sequence_base.contract.retired import dropped
18
19
 
19
20
  __all__ = [
21
+ "LATENCY_GONE",
20
22
  "EvalRequest",
21
23
  "ArmReport",
22
24
  "EvalTiming",
@@ -40,6 +42,15 @@ __all__ = [
40
42
  _Trials = Annotated[int, Field(ge=1, le=100000)]
41
43
 
42
44
 
45
+
46
+
47
+
48
+
49
+ LATENCY_GONE = ("latency_ms is gone: an eval models no network - it sends each act at the policy's "
50
+ "action_chunk_replan_at step and swaps its answer in at the action_chunk_valid_len step, the world "
51
+ "paused until the answer comes; leave latency_ms out")
52
+
53
+
43
54
  class EvalRequest(BaseModel):
44
55
  """`POST /v1/eval`. A real eval names `model` + `benchmark`; a rerun (`rerun_of` / `rerun_unsuccessful_of`) may
45
56
  leave them out and take the earlier eval's. `dry_run` selects the estimate-only response shape below.
@@ -100,8 +111,12 @@ class EvalRequest(BaseModel):
100
111
 
101
112
 
102
113
 
103
-
104
- latency_ms: float | None = Field(default=None, ge=0)
114
+ @model_validator(mode="before")
115
+ @classmethod
116
+ def _latency_gone(cls, data: object) -> object:
117
+ if isinstance(data, dict) and data.get("latency_ms") is not None:
118
+ raise ValueError(LATENCY_GONE)
119
+ return dropped(data, "latency_ms")
105
120
 
106
121
  @model_validator(mode="after")
107
122
  def _selection(self) -> "EvalRequest":
@@ -338,8 +353,8 @@ class EvalReport(BaseModel):
338
353
  """GET /v1/eval/{id} (eval-raw revision). NO hard-coded `overall_sr` / `success_rate` top-level field —
339
354
  `metrics` is a passthrough dict keyed by the user's metric names, each value a `MetricAgg`; `success` is among
340
355
  them when the benchmark's `@seq.step` reported one, aggregated per task like any other
341
- . The platform aggregates per key and invents nothing. `latency_ms` is the virtual-timeline latency this
342
- run used (§2). `incomplete` flags that some episode did not finish (never pass a subset off as the whole)."""
356
+ . The platform aggregates per key and invents nothing. `incomplete` flags that some episode did not finish
357
+ (never pass a subset off as the whole)."""
343
358
 
344
359
  model_config = ConfigDict(extra="forbid")
345
360
 
@@ -370,4 +385,7 @@ class EvalReport(BaseModel):
370
385
 
371
386
 
372
387
 
373
- latency_ms: float | None = None
388
+ @model_validator(mode="before")
389
+ @classmethod
390
+ def _latency_gone(cls, data: object) -> object:
391
+ return dropped(data, "latency_ms")
@@ -48,7 +48,10 @@ __all__ = [
48
48
  "ActionContract",
49
49
  "PolicySpec",
50
50
  "PolicyRegistration",
51
+ "CHUNK_NAMES",
51
52
  "check_chunk_lens",
53
+ "chunk_names_renamed",
54
+ "chunk_names_said",
52
55
  ]
53
56
 
54
57
 
@@ -390,8 +393,8 @@ class PolicySpec(BaseModel):
390
393
  @model_validator(mode="before")
391
394
  @classmethod
392
395
  def _retired(cls, data: Any) -> Any:
393
- return dropped(team_gone(observations_gone(data)), "embodiments", "feedback", "action", "observation",
394
- "actions", *SCALING_RETIRED)
396
+ return dropped(chunk_names_renamed(team_gone(observations_gone(data))), "embodiments", "feedback", "action",
397
+ "observation", "actions", *SCALING_RETIRED)
395
398
 
396
399
  name: str
397
400
 
@@ -421,9 +424,11 @@ class PolicySpec(BaseModel):
421
424
 
422
425
 
423
426
 
427
+
428
+
424
429
  hz: float | None = Field(default=None, gt=0, le=1000)
425
- action_chunk_len: int | None = Field(default=None, ge=1, le=100_000)
426
- action_chunk_exec_len: int | None = Field(default=None, ge=1, le=100_000)
430
+ action_chunk_valid_len: int | None = Field(default=None, ge=1, le=100_000)
431
+ action_chunk_replan_at: int | None = Field(default=None, ge=1, le=100_000)
427
432
 
428
433
 
429
434
 
@@ -471,7 +476,7 @@ class PolicySpec(BaseModel):
471
476
 
472
477
  @model_validator(mode="after")
473
478
  def _plays_what_it_holds(self) -> "PolicySpec":
474
- check_chunk_lens(self.action_chunk_len, self.action_chunk_exec_len)
479
+ check_chunk_lens(self.action_chunk_valid_len, self.action_chunk_replan_at)
475
480
  return self
476
481
 
477
482
  @model_validator(mode="after")
@@ -479,7 +484,7 @@ class PolicySpec(BaseModel):
479
484
 
480
485
 
481
486
  if self.planner is not None:
482
- said = [name for name in ("hz", "action_chunk_len", "action_chunk_exec_len", "tensors")
487
+ said = [name for name in ("hz", "action_chunk_valid_len", "action_chunk_replan_at", "tensors")
483
488
  if getattr(self, name) is not None]
484
489
  said += [f"concurrency.{name}" for name in ("sizes", "max_concurrent", "max_inputs", "target_inputs")
485
490
  if self.concurrency is not None and getattr(self.concurrency, name) is not None]
@@ -488,11 +493,39 @@ class PolicySpec(BaseModel):
488
493
  return self
489
494
 
490
495
 
491
- def check_chunk_lens(length: int | None, exec_len: int | None) -> None:
492
- """A policy plays at most the steps its answer holds: action_chunk_exec_len never past action_chunk_len."""
493
- if length is not None and exec_len is not None and exec_len > length:
494
- raise ValueError(f"action_chunk_exec_len {exec_len} is more than action_chunk_len {length}: a robot plays at "
495
- "most the steps an answer holds")
496
+ def check_chunk_lens(valid_len: int | None, replan_at: int | None) -> None:
497
+ """The next answer is needed no later than this one's valid steps run out: action_chunk_replan_at never past
498
+ action_chunk_valid_len."""
499
+ if valid_len is not None and replan_at is not None and replan_at > valid_len:
500
+ raise ValueError(f"action_chunk_replan_at {replan_at} is more than action_chunk_valid_len {valid_len}: the next "
501
+ "answer is needed no later than the step this one's valid steps run out")
502
+
503
+
504
+
505
+
506
+
507
+
508
+ CHUNK_NAMES = {"action_chunk_len": "action_chunk_valid_len", "action_chunk_exec_len": "action_chunk_replan_at"}
509
+ _CHUNK_EXAMPLE = "@seq.policy(hz=15, action_chunk_valid_len=15, action_chunk_replan_at=8)"
510
+
511
+
512
+ def chunk_names_said(*olds: str) -> str:
513
+ """What a body or a declaration that still names the control loop's old names `olds` is told - the contract's
514
+ models here, the SDK's @seq.policy and the gateway alike, word for word: each one's new name, what the two mean,
515
+ and how to write them."""
516
+ renamed = "; ".join(f"{old} is now {CHUNK_NAMES[old]}" for old in olds)
517
+ return (f"{renamed} - action_chunk_valid_len the steps of an answer that are valid, action_chunk_replan_at the "
518
+ f"step, counted from when its act is sent, at which the next answer is needed: {_CHUNK_EXAMPLE}")
519
+
520
+
521
+ def chunk_names_renamed(data: Any) -> Any:
522
+ """A model's before-validator for a body that may hold the control loop's old names: refused (chunk_names_said)
523
+ when it gives one a value, read without it when it is null."""
524
+ if isinstance(data, dict):
525
+ said = [old for old in CHUNK_NAMES if data.get(old) is not None]
526
+ if said:
527
+ raise ValueError(chunk_names_said(*said))
528
+ return dropped(data, *CHUNK_NAMES)
496
529
 
497
530
 
498
531
 
@@ -13,7 +13,11 @@ from sequence_base.obs.rid import clean, clean_text
13
13
 
14
14
 
15
15
 
16
- TEXT_FIELDS = frozenset({"error"})
16
+
17
+
18
+
19
+
20
+ TEXT_FIELDS = frozenset({"error", "warning"})
17
21
 
18
22
 
19
23
  def enabled() -> bool:
@@ -17,6 +17,8 @@ from typing import Any, Literal
17
17
 
18
18
  from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
19
19
 
20
+ from sequence_base.contract.retired import dropped
21
+
20
22
  class ImageFrame(BaseModel):
21
23
  """One camera frame at one instant. Repeat a `view` (ordered by timestamp_ms) for a series."""
22
24
 
@@ -154,6 +156,15 @@ class ActionContract(BaseModel):
154
156
  PROPRIO_FIELDS = ("joint_positions", "joint_velocities", "end_effector_pose", "gripper")
155
157
 
156
158
 
159
+
160
+
161
+
162
+ CAMERA_FRAMES_GONE = ("Camera codec=, quality= and layout= are gone: a frame reaches the policy as its robot sends it - "
163
+ "send it as sequence_ai.Video(frame) to compress it, and lay it out in the policy's own code (e.g. "
164
+ "frame.transpose(2, 0, 1) / 255 for channels first in 0..1)")
165
+ _FRAMES_GONE = ("codec", "quality", "layout")
166
+
167
+
157
168
  class Camera(BaseModel):
158
169
  """One camera view a policy reads: the size its colour frames arrive at. The worker refuses a frame of another size
159
170
  (400 invalid_request naming the view, the size it got and the SDK call that fits it) and never resizes one: the
@@ -185,20 +196,14 @@ class Camera(BaseModel):
185
196
 
186
197
 
187
198
 
188
-
189
-
190
-
191
- codec: Literal["raw", "png", "jpeg"] | None = Field(
192
- default=None, description='how a frame travels: "raw", "png" or "jpeg"; unset, as the robot sent it')
193
- quality: int | None = Field(default=None, ge=1, le=100, description="a JPEG frame's quality (unset: 95)")
194
- layout: Literal["hwc_uint8", "chw_float"] | None = Field(
195
- default=None, description='how the policy\'s code takes a frame: "hwc_uint8" or "chw_float" (0..1)')
196
-
197
- @model_validator(mode="after")
198
- def _quality_is_a_jpegs(self) -> "Camera":
199
- if self.quality is not None and self.codec != "jpeg":
200
- raise ValueError("quality= is a JPEG frame's; it needs codec='jpeg'")
201
- return self
199
+ @model_validator(mode="before")
200
+ @classmethod
201
+ def _frames_gone(cls, data: Any) -> Any:
202
+ """A camera that still says how its frames travelled is refused (CAMERA_FRAMES_GONE); one stored with them null
203
+ reads as it did."""
204
+ if isinstance(data, dict) and any(data.get(name) is not None for name in _FRAMES_GONE):
205
+ raise ValueError(CAMERA_FRAMES_GONE)
206
+ return dropped(data, *_FRAMES_GONE)
202
207
 
203
208
 
204
209
 
@@ -255,19 +260,6 @@ class ObservationContract(BaseModel):
255
260
  description="named extra state vector → its length (Observation.state)")
256
261
  instruction: bool = Field(default=True, description="whether a non-empty instruction is required")
257
262
 
258
- @field_validator("cameras")
259
- @classmethod
260
- def _preset_cameras(cls, v: dict[str, Camera]) -> dict[str, Camera]:
261
-
262
-
263
- for view, cam in v.items():
264
- given = [name for name in ("codec", "quality", "layout") if getattr(cam, name) is not None]
265
- if given:
266
- raise ValueError(f"camera {view!r}: {', '.join(given)} {'is' if len(given) == 1 else 'are'} for a "
267
- "policy of its own inputs (observations=); the robot-arm contract's frames are images "
268
- "the robot fits and encodes itself")
269
- return v
270
-
271
263
  @field_validator("proprio")
272
264
  @classmethod
273
265
  def _known_proprio(cls, v: dict[str, int]) -> dict[str, int]:
@@ -66,5 +66,5 @@
66
66
  ],
67
67
  "title": "ActRequest",
68
68
  "type": "object",
69
- "x-contract-version": "0.5.34"
69
+ "x-contract-version": "0.5.35"
70
70
  }
@@ -75,5 +75,5 @@
75
75
  ],
76
76
  "title": "ActResponse",
77
77
  "type": "object",
78
- "x-contract-version": "0.5.34"
78
+ "x-contract-version": "0.5.35"
79
79
  }
@@ -99,5 +99,5 @@
99
99
  ],
100
100
  "title": "ActionChunk",
101
101
  "type": "object",
102
- "x-contract-version": "0.5.34"
102
+ "x-contract-version": "0.5.35"
103
103
  }
@@ -96,5 +96,5 @@
96
96
  ],
97
97
  "title": "ActionContract",
98
98
  "type": "object",
99
- "x-contract-version": "0.5.34"
99
+ "x-contract-version": "0.5.35"
100
100
  }
@@ -19,5 +19,5 @@
19
19
  ],
20
20
  "title": "ActionStep",
21
21
  "type": "object",
22
- "x-contract-version": "0.5.34"
22
+ "x-contract-version": "0.5.35"
23
23
  }
@@ -17,5 +17,5 @@
17
17
  ],
18
18
  "title": "AdapterPair",
19
19
  "type": "object",
20
- "x-contract-version": "0.5.34"
20
+ "x-contract-version": "0.5.35"
21
21
  }
@@ -23,5 +23,5 @@
23
23
  ],
24
24
  "title": "AddLocal",
25
25
  "type": "object",
26
- "x-contract-version": "0.5.34"
26
+ "x-contract-version": "0.5.35"
27
27
  }
@@ -36,5 +36,5 @@
36
36
  },
37
37
  "title": "Autoscaler",
38
38
  "type": "object",
39
- "x-contract-version": "0.5.34"
39
+ "x-contract-version": "0.5.35"
40
40
  }
@@ -766,5 +766,5 @@
766
766
  ],
767
767
  "title": "BenchmarkRegisterRequest",
768
768
  "type": "object",
769
- "x-contract-version": "0.5.34"
769
+ "x-contract-version": "0.5.35"
770
770
  }
@@ -435,7 +435,7 @@
435
435
  ],
436
436
  "title": "SeqFlags",
437
437
  "type": "integer",
438
- "x-contract-version": "0.5.34",
438
+ "x-contract-version": "0.5.35",
439
439
  "x-flag-names": {
440
440
  "ACTION": 1048576,
441
441
  "CHECK": 65536,
@@ -702,5 +702,5 @@
702
702
  ],
703
703
  "title": "BenchmarkSpec",
704
704
  "type": "object",
705
- "x-contract-version": "0.5.34"
705
+ "x-contract-version": "0.5.35"
706
706
  }
@@ -40,5 +40,5 @@
40
40
  ],
41
41
  "title": "BenchmarkStatusResponse",
42
42
  "type": "object",
43
- "x-contract-version": "0.5.34"
43
+ "x-contract-version": "0.5.35"
44
44
  }
@@ -79,5 +79,5 @@
79
79
  ],
80
80
  "title": "BootstrapResponse",
81
81
  "type": "object",
82
- "x-contract-version": "0.5.34"
82
+ "x-contract-version": "0.5.35"
83
83
  }
@@ -2,24 +2,6 @@
2
2
  "additionalProperties": false,
3
3
  "description": "One camera view a policy reads: the size its colour frames arrive at. The worker refuses a frame of another size\n(400 invalid_request naming the view, the size it got and the SDK call that fits it) and never resizes one: the\nrobot fits its frames before sending - with `sequence_ai.resize_image`, the way `resize` and `filter` say the policy\nwas trained.",
4
4
  "properties": {
5
- "codec": {
6
- "anyOf": [
7
- {
8
- "enum": [
9
- "raw",
10
- "png",
11
- "jpeg"
12
- ],
13
- "type": "string"
14
- },
15
- {
16
- "type": "null"
17
- }
18
- ],
19
- "default": null,
20
- "description": "how a frame travels: \"raw\", \"png\" or \"jpeg\"; unset, as the robot sent it",
21
- "title": "Codec"
22
- },
23
5
  "depth": {
24
6
  "anyOf": [
25
7
  {
@@ -60,38 +42,6 @@
60
42
  "title": "Height",
61
43
  "type": "integer"
62
44
  },
63
- "layout": {
64
- "anyOf": [
65
- {
66
- "enum": [
67
- "hwc_uint8",
68
- "chw_float"
69
- ],
70
- "type": "string"
71
- },
72
- {
73
- "type": "null"
74
- }
75
- ],
76
- "default": null,
77
- "description": "how the policy's code takes a frame: \"hwc_uint8\" or \"chw_float\" (0..1)",
78
- "title": "Layout"
79
- },
80
- "quality": {
81
- "anyOf": [
82
- {
83
- "maximum": 100,
84
- "minimum": 1,
85
- "type": "integer"
86
- },
87
- {
88
- "type": "null"
89
- }
90
- ],
91
- "default": null,
92
- "description": "a JPEG frame's quality (unset: 95)",
93
- "title": "Quality"
94
- },
95
45
  "resize": {
96
46
  "anyOf": [
97
47
  {
@@ -122,5 +72,5 @@
122
72
  ],
123
73
  "title": "Camera",
124
74
  "type": "object",
125
- "x-contract-version": "0.5.34"
75
+ "x-contract-version": "0.5.35"
126
76
  }
@@ -23,5 +23,5 @@
23
23
  ],
24
24
  "title": "CodeBundle",
25
25
  "type": "object",
26
- "x-contract-version": "0.5.34"
26
+ "x-contract-version": "0.5.35"
27
27
  }
@@ -109,5 +109,5 @@
109
109
  },
110
110
  "title": "Concurrency",
111
111
  "type": "object",
112
- "x-contract-version": "0.5.34"
112
+ "x-contract-version": "0.5.35"
113
113
  }
@@ -24,5 +24,5 @@
24
24
  ],
25
25
  "title": "ConnectRequest",
26
26
  "type": "object",
27
- "x-contract-version": "0.5.34"
27
+ "x-contract-version": "0.5.35"
28
28
  }
@@ -93,7 +93,7 @@
93
93
  "additionalProperties": false,
94
94
  "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 (contract 6 / goal 15).",
95
95
  "properties": {
96
- "action_chunk_exec_len": {
96
+ "action_chunk_replan_at": {
97
97
  "anyOf": [
98
98
  {
99
99
  "maximum": 100000,
@@ -105,9 +105,9 @@
105
105
  }
106
106
  ],
107
107
  "default": null,
108
- "title": "Action Chunk Exec Len"
108
+ "title": "Action Chunk Replan At"
109
109
  },
110
- "action_chunk_len": {
110
+ "action_chunk_valid_len": {
111
111
  "anyOf": [
112
112
  {
113
113
  "maximum": 100000,
@@ -119,7 +119,7 @@
119
119
  }
120
120
  ],
121
121
  "default": null,
122
- "title": "Action Chunk Len"
122
+ "title": "Action Chunk Valid Len"
123
123
  },
124
124
  "cert_fingerprint": {
125
125
  "description": "Self-signed cert fingerprint the SDK pins",
@@ -200,5 +200,5 @@
200
200
  ],
201
201
  "title": "ConnectResponse",
202
202
  "type": "object",
203
- "x-contract-version": "0.5.34"
203
+ "x-contract-version": "0.5.35"
204
204
  }