dirigent-plugin 0.20.0__tar.gz → 0.21.0__tar.gz

{dirigent_plugin-0.20.0 → dirigent_plugin-0.21.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: dirigent-plugin
-Version: 0.20.0
+Version: 0.21.0
 Summary: The dirigent plugin contract: block specs, protocols, and markers.
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: dirigent-common==0.20.0
+Requires-Dist: dirigent-common==0.21.0
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: pluginkit>=0.5.0
 Requires-Dist: pydantic>=2.13.5

{dirigent_plugin-0.20.0 → dirigent_plugin-0.21.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-plugin"
-version = "0.20.0"
+version = "0.21.0"
 description = "The dirigent plugin contract: block specs, protocols, and markers."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.20.0",
+    "dirigent-common==0.21.0",
     "httpx2>=2.12.0",
     "pluginkit>=0.5.0",
     "pydantic>=2.13.5",

{dirigent_plugin-0.20.0 → dirigent_plugin-0.21.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-plugin"
-version = "0.20.0"
+version = "0.21.0"
 description = "The dirigent plugin contract: block specs, protocols, and markers."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,7 +11,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-common==0.20.0",
+    "dirigent-common==0.21.0",
     "httpx2>=2.12.0",
     "pluginkit>=0.5.0",
     "pydantic>=2.13.5",

{dirigent_plugin-0.20.0 → dirigent_plugin-0.21.0}/src/dirigent_plugin/blocks.py

@@ -280,8 +280,9 @@ class NotYet(BaseModel):
     worker that dies before that commit leaves the older cursor for the next poke to read
     from again. So a poke must tolerate reading the same ground twice.
 
-    The cursor's life is the waiting attempt. A poke that succeeds ends the step, and
-    nothing carries the cursor past it.
+    The cursor's life is the waiting attempt. A poke that succeeds ends the step, and only
+    :meth:`Sensor.resume_cursor` carries a cursor past it: a watch hands what that returns to
+    the first poke of the run it arms next.
     """
 
 
@@ -551,7 +552,9 @@ class StepContext(Protocol):
     cursor: JsonMap | None
     """The cursor the last committed :class:`NotYet` returned, and None on the first poke.
 
-    Only a sensor's poke reads it; every other call sees None.
+    The first poke of a run a watch armed is handed where the watch's last success left off
+    instead, which is what :meth:`Sensor.resume_cursor` returned. Only a sensor's poke reads
+    it; every other call sees None.
     """
 
     def connection[C: BaseModel](self, ref: ConnectionRef, model: type[C]) -> C:
@@ -682,6 +685,16 @@ class Sensor[ConfigT: BaseModel, OutputT: BaseModel](ABC):
         """Observe the world once, read-only and briefly; NotYet is not a failure."""
         ...
 
+    def resume_cursor(self, output: OutputT) -> JsonMap | None:
+        """Say where a poke that succeeded left off, read from the output it succeeded with.
+
+        A watch stores what this returns and hands it to the first poke of the next run it
+        arms as ``ctx.cursor``. None, the default, starts every run fresh. It is stored in the
+        transaction that settles the step, so it is only as far along as the last success that
+        committed, and the next poke may read that ground again.
+        """
+        return None
+
     def check_config(self, config: BaseModel) -> list[Issue]:
         """List the extra refusals this block makes at apply, beyond what its schema says.