agentic-runner-contracts 3.2.0__tar.gz → 3.4.0__tar.gz

{agentic_runner_contracts-3.2.0 → agentic_runner_contracts-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentic-runner-contracts
-Version: 3.2.0
+Version: 3.4.0
 Summary: Activity I/O contracts and Public Metadata name builders shared by the Agentic OS platform and the installable Runner
 License-Expression: AGPL-3.0-only
 License-File: LICENSE

{agentic_runner_contracts-3.2.0 → agentic_runner_contracts-3.4.0}/src/agentic_runner_contracts/__init__.py

@@ -32,6 +32,6 @@ the package the floor is *about*, and read back through ``agentic-runner --versi
 # Additive; an older payload parses with no Skills. But the context forbids extra keys,
 # so a Runner one minor behind refuses a context that carries `skills` -- the platform
 # must not send the field until its Runners are on 2.7.
-__version__ = "3.2.0"
+__version__ = "3.4.0"
 
 __all__ = ["__version__"]

{agentic_runner_contracts-3.2.0 → agentic_runner_contracts-3.4.0}/src/agentic_runner_contracts/activity_io.py

@@ -175,6 +175,29 @@ class QuestionAsked:
     owner_confirmation: OwnerConfirmationPending | None = None
 
 
+class HarnessHoldKind(StrEnum):
+    """Why a subscription-mode harness stopped on its person's account (local-agents 08)."""
+
+    # The plan's usage window is spent; the harness may say when it resets.
+    USAGE_LIMIT = "usage_limit"
+    # The sign-in expired, was revoked, or is absent: only the person can sign in again.
+    SIGN_IN_REQUIRED = "sign_in_required"
+
+
+@dataclass(frozen=True)
+class HarnessHold:
+    """A subscription Directive stopped for a reason a retry cannot fix (local-agents 08).
+
+    Returned instead of raised, with nothing pushed, so the loop can hold rather than
+    spend a fix Directive and Budget on it (issue 09). ``retry_not_before`` is ISO 8601
+    UTC text -- the same reason ``ContractDeviceLoginResult.expires_at`` is -- and None
+    when the harness named no reset time.
+    """
+
+    kind: HarnessHoldKind
+    retry_not_before: str | None = None
+
+
 @dataclass(frozen=True)
 class QuestionOpenInput:
     """Route an allowed Question and start its 24 h window (PRD issue 60)."""
@@ -328,6 +351,8 @@ class BranchPullRequestOutput:
     plan: EpicPlan | None = None
     # PRD issue 60: the Question this Directive's Agent asked over its callback socket.
     question: QuestionAsked | None = None
+    # Local-agents 08: the subscription harness hit its usage limit or lost its sign-in.
+    harness_hold: HarnessHold | None = None
 
 
 @dataclass(frozen=True)
@@ -649,6 +674,8 @@ class FixDirectiveOutput:
     plan: EpicPlan | None = None
     # PRD issue 60: the Question this Directive's Agent asked over its callback socket.
     question: QuestionAsked | None = None
+    # Local-agents 08: the subscription harness hit its usage limit or lost its sign-in.
+    harness_hold: HarnessHold | None = None
 
 
 @dataclass(frozen=True)
@@ -1032,6 +1059,7 @@ class LearningDirectiveOutput:
     usage: DirectiveUsage = field(default_factory=DirectiveUsage)
     outcome: str = LEARNING_PROPOSED
     summary: str = ""
+    harness_hold: HarnessHold | None = None
 
 
 @dataclass(frozen=True)

{agentic_runner_contracts-3.2.0 → agentic_runner_contracts-3.4.0}/src/agentic_runner_contracts/runner_registration.py

@@ -223,8 +223,36 @@ class BootstrapResponse(BaseModel):
     stale_after_seconds: int = int(HEARTBEAT_STALE_AFTER.total_seconds())
 
 
+class SelfTestFailure(StrEnum):
+    """Why a harness's ``--version`` under a Contract's uid did not answer (local-agents 17)."""
+
+    NOT_FOUND = "not_found"
+    BELOW_FLOOR = "below_floor"
+    SPAWN_FAILED = "spawn_failed"
+    TIMEOUT = "timeout"
+
+
+class HarnessSelfTest(BaseModel):
+    """The last ``--version`` run as the Contract would run it: a result, never its output."""
+
+    model_config = ConfigDict(extra="forbid")
+
+    ok: bool
+    at: datetime
+    reason: SelfTestFailure | None = None
+
+
+_HARNESS_DESCRIPTOR_FIELDS: Final = ("auth_modes", "permission_mode", "self_test")
+
+
 class HarnessVersion(BaseModel):
-    """One CLI as it stands under one Contract root (ADR-0015 §4, 23 item 5)."""
+    """One CLI as it stands under one Contract root (ADR-0015 §4, 23 item 5).
+
+    ``auth_modes``, ``permission_mode`` and ``self_test`` are the runtime's descriptor
+    (local-agents 17), self-reported like everything else here. The permission mode is
+    what the Runner passes the harness, reported and never trusted as a gate (ADR-0011
+    §12).
+    """
 
     model_config = ConfigDict(extra="forbid")
 
@@ -232,6 +260,25 @@ class HarnessVersion(BaseModel):
     cli_kind: Annotated[str, StringConstraints(pattern=r"^[a-z][a-z0-9_]{0,31}$")]
     version: Annotated[str, StringConstraints(max_length=64)]
     auth_mode: Annotated[str, StringConstraints(pattern=r"^[a-z][a-z0-9_]{0,31}$")]
+    auth_modes: (
+        list[Annotated[str, StringConstraints(pattern=r"^[a-z][a-z0-9_]{0,31}$")]] | None
+    ) = Field(default=None, max_length=8)
+    permission_mode: (
+        Annotated[str, StringConstraints(pattern=r"^[a-z][a-z0-9_=;.-]{0,95}$")] | None
+    ) = None
+    self_test: HarnessSelfTest | None = None
+
+    @model_serializer(mode="wrap")
+    def _omit_absent_descriptor(self, handler: SerializerFunctionWrapHandler) -> Any:
+        # A control plane on contracts 3.3 forbids extra keys, so a row without the
+        # descriptor is the body it already parses. One with it needs the control plane
+        # on this minor first -- upgrade the control plane before the Runner.
+        body = handler(self)
+        if isinstance(body, dict):
+            for name in _HARNESS_DESCRIPTOR_FIELDS:
+                if body.get(name) is None:
+                    body.pop(name, None)
+        return body
 
 
 class ResourcePressure(BaseModel):