openbox-sdk-python 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

openbox_core/__init__.py

@@ -37,7 +37,7 @@ from .errors import (
 # governance; eagerly it can deadlock package init as a circular import, and
 # lazily it can recurse unboundedly when a per-request header builder resolves
 # the version. Keep in sync with pyproject.toml on release.
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 
 __all__ = [
     "__version__",

openbox_core/contracts/results.py

@@ -20,9 +20,9 @@ __all__ = [
     "GuardrailsResult",
     "EvaluationResult",
     "ApprovalResult",
-    "RetryPlan",
-    "RetryDirective",
-    "handle_retryable_block",
+    "Patch",
+    "PatchDirective",
+    "handle_patch",
 ]
 
 
@@ -106,8 +106,8 @@ class GuardrailsResult:
         return [r.get("reason", "") for r in self.reasons if r.get("reason")]
 
 
-# Sentinel distinguishing an absent ``retry_plan`` field from a present JSON ``null``.
-# ``dict.get("retry_plan")`` would collapse both to None; membership via this sentinel does not.
+# Sentinel distinguishing an absent ``patch`` field from a present JSON ``null``.
+# ``dict.get("patch")`` would collapse both to None; membership via this sentinel does not.
 _MISSING = object()
 
 # JS Number.MAX_SAFE_INTEGER. Integral numbers must fit within +/- this bound so ``new_input`` can
@@ -120,7 +120,7 @@ def _numbers_are_safe(value: Any) -> bool:
     """Every number (recursively) must be finite and, if integral, within the JS-safe range.
 
     ``bool`` is a subclass of ``int`` but is not a number here; a nested bool is a plain leaf
-    (top-level ``new_input`` booleans are rejected separately by :func:`_parse_retry_plan`).
+    (top-level ``new_input`` booleans are rejected separately by :func:`_parse_patch`).
     """
     if isinstance(value, bool):
         return True
@@ -140,22 +140,22 @@ def _numbers_are_safe(value: Any) -> bool:
 
 
 @dataclass
-class RetryPlan:
-    """Optional remediation hint carried on a BLOCK verdict (policy-produced or admin-retry).
+class Patch:
+    """Optional remediation hint carried on a BLOCK verdict (policy-produced or admin-patch).
 
     ``new_input`` may be null | str | number | list | dict (boolean rejected). A present
-    ``new_input`` of ``None`` is a valid plan (retry with the original input) and is distinct
-    from an absent ``retry_plan`` field.
+    ``new_input`` of ``None`` is a valid patch (reuses the original input) and is distinct
+    from an absent ``patch`` field.
     """
 
     new_input: Any = None
 
 
 @dataclass
-class RetryDirective:
-    """Caller-facing view of a retryable BLOCK, surfaced only via :func:`handle_retryable_block`.
+class PatchDirective:
+    """Caller-facing view of a BLOCK with patch, surfaced only via :func:`handle_patch`.
 
-    It is a remediation hint, not proof that a retry was evaluated or executed.
+    It is a remediation hint, not proof that a patch was evaluated or executed.
     """
 
     new_input: Any = None
@@ -163,28 +163,28 @@ class RetryDirective:
     reason: str | None = None
 
 
-def _parse_retry_plan(container: dict[str, Any]) -> RetryPlan | None:
-    """Parse an optional ``retry_plan`` from a result dict against the frozen wire contract.
+def _parse_patch(container: dict[str, Any]) -> Patch | None:
+    """Parse an optional ``patch`` from a result dict against the frozen wire contract.
 
-    Returns a plan only when ``retry_plan`` is present, is a dict whose ONLY key is ``new_input``,
+    Returns a patch only when ``patch`` is present, is a dict whose ONLY key is ``new_input``,
     and ``new_input`` is null/str/number/list/dict (boolean rejected) with every number finite and,
     if integral, within the JS-safe integer range. An absent field, a JSON ``null`` field, or any
     contract violation yields ``None`` (treated as absent — never an error). A present
-    ``new_input`` of ``None`` is preserved as a valid plan.
+    ``new_input`` of ``None`` is preserved as a valid patch.
     """
-    plan = container.get("retry_plan", _MISSING)
-    if plan is _MISSING or not isinstance(plan, dict):
+    patch = container.get("patch", _MISSING)
+    if patch is _MISSING or not isinstance(patch, dict):
         return None
     # Exactly the single key new_input (also guarantees new_input is present, not merely null).
-    if set(plan.keys()) != {"new_input"}:
+    if set(patch.keys()) != {"new_input"}:
         return None
-    new_input = plan["new_input"]
+    new_input = patch["new_input"]
     # bool is a subclass of int — reject a boolean new_input BEFORE the number check.
     if isinstance(new_input, bool):
         return None
     if not _numbers_are_safe(new_input):
         return None
-    return RetryPlan(new_input=new_input)
+    return Patch(new_input=new_input)
 
 
 @dataclass
@@ -215,7 +215,7 @@ class EvaluationResult:
     fallback_used: bool = False  # True when fail-open produced this result
     diagnostics: list[Any] = field(default_factory=list)
     raw: dict[str, Any] = field(default_factory=dict)
-    retry_plan: RetryPlan | None = None  # Optional BLOCK remediation hint; None = absent
+    patch: Patch | None = None  # Optional BLOCK remediation hint; None = absent
 
     @property
     def guardrails_result(self) -> GuardrailsResult | None:
@@ -266,7 +266,7 @@ class EvaluationResult:
             fallback_used=bool(data.get("fallback_used", False)),
             diagnostics=data.get("diagnostics") or [],
             raw=dict(data),
-            retry_plan=_parse_retry_plan(data),
+            patch=_parse_patch(data),
         )
 
     @classmethod
@@ -299,7 +299,7 @@ class ApprovalResult:
     approval_expiration_time: str | None = None
     expired: bool = False
     raw: dict[str, Any] = field(default_factory=dict)
-    retry_plan: RetryPlan | None = None  # Present only on an admin-retry BLOCK
+    patch: Patch | None = None  # Present only on an admin-patch BLOCK
 
     # Known decision vocabulary for approvals (current values + accepted aliases).
     # Anything OUTSIDE this set parses to None (pending) — the evaluate-path
@@ -345,7 +345,7 @@ class ApprovalResult:
             approval_expiration_time=data.get("approval_expiration_time"),
             expired=bool(data.get("expired", False)),
             raw=dict(data),
-            retry_plan=_parse_retry_plan(data),
+            patch=_parse_patch(data),
         )
 
     @property
@@ -376,21 +376,22 @@ class ApprovalResult:
         return self.verdict in (Verdict.REQUIRE_APPROVAL, Verdict.CONSTRAIN)
 
 
-def handle_retryable_block(
+def handle_patch(
     result: EvaluationResult | ApprovalResult,
-) -> RetryDirective | None:
-    """Opt-in, pure inspector: surface a retry directive from a retryable BLOCK.
+) -> PatchDirective | None:
+    """Opt-in, pure inspector: surface a patch directive from a BLOCK with patch.
 
-    Returns a :class:`RetryDirective` ONLY for ``verdict == Verdict.BLOCK`` with a present, valid
-    ``retry_plan``. Returns ``None`` for plain BLOCK, every non-BLOCK verdict (including HALT),
+    Returns a :class:`PatchDirective` ONLY for ``verdict == Verdict.BLOCK`` with a present, valid
+    ``patch``. Returns ``None`` for plain BLOCK, every non-BLOCK verdict (including HALT),
     a pending/``None`` verdict, and an expired :class:`ApprovalResult`.
 
-    This does NOT change enforcement: importing or exposing it never auto-retries. A caller must
-    invoke it explicitly, and it makes no claim that a replacement was evaluated or executed.
+    This does NOT change enforcement: importing or exposing it never auto-applies the patch. A
+    caller must invoke it explicitly, and it makes no claim that a replacement was evaluated or
+    executed.
 
     The gate is deliberately ``verdict == Verdict.BLOCK`` — NOT ``is_blocking()`` /
     ``verdict.should_stop()``, which also match HALT (and, for approvals, expired results) and would
-    violate the wire-contract invariant that HALT always strips the plan.
+    violate the wire-contract invariant that HALT always strips the patch.
     """
     # A stale/expired poll result must not surface a directive, even if verdict == BLOCK.
     if isinstance(result, ApprovalResult) and result.expired:
@@ -400,8 +401,8 @@ def handle_retryable_block(
     if getattr(result, "verdict", None) != Verdict.BLOCK:
         return None
 
-    plan = result.retry_plan
-    if plan is None:
+    patch = result.patch
+    if patch is None:
         return None
 
     # governance_event_id is typed on EvaluationResult; ApprovalResult carries it only in raw.
@@ -410,8 +411,8 @@ def handle_retryable_block(
     else:
         governance_event_id = result.raw.get("governance_event_id") or result.raw.get("id")
 
-    return RetryDirective(
-        new_input=plan.new_input,
+    return PatchDirective(
+        new_input=patch.new_input,
         governance_event_id=governance_event_id,
         reason=result.reason,
     )

{openbox_sdk_python-1.1.0.dist-info → openbox_sdk_python-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openbox-sdk-python
-Version: 1.1.0
+Version: 1.2.0
 Summary: OpenBox base SDK - governance contracts, strict gate, identity/signing, evaluate client, context runtime, OTel span wire serialization, and generic instrumentation shared by every OpenBox framework SDK
 Author-email: OpenBox Team <tino@openbox.ai>
 License-Expression: MIT

{openbox_sdk_python-1.1.0.dist-info → openbox_sdk_python-1.2.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-openbox_core/__init__.py,sha256=d-dbV1PKppLsYU1yNUnfvwswrIC7Rap0syzbwx8NWdo,1983
+openbox_core/__init__.py,sha256=PYBEmt7aGSXdg_PUsxqHbAyUXBafHC9EJRudnEZhK0E,1983
 openbox_core/approvals.py,sha256=eobLN4rSBvaFaTbsPExu2XcGS5fSuWvo0GC1DR18w0I,4400
 openbox_core/client.py,sha256=Mo3HSFj7VmDYLiTJ0FnJdxNdetjU-NHK8IrBU7AL4vU,12615
 openbox_core/config.py,sha256=-YasfXrRmA2u_iywtFF0AysAp88hzHWu19je5cy4mo8,9684
@@ -20,7 +20,7 @@ openbox_core/contracts/__init__.py,sha256=7uBSUIxfUG6uZDsotQmT1jjXs3G75M2hFHtYEl
 openbox_core/contracts/context.py,sha256=V-eVbB-NIrXI1NKduengG0GVx7q1wKawyhwZh-D0C9Y,2873
 openbox_core/contracts/events.py,sha256=Loy5IW4UyPiffBVYK06IxiID6NKsNQjoTLguBb-j4Uw,13428
 openbox_core/contracts/otel_spans.py,sha256=PnElhgdOM_qlYVF9thPxvhNxloXOb3fpgSXDQN3evWg,10753
-openbox_core/contracts/results.py,sha256=Mm9MKDKduk8x65fsUIC7xgen1xvbiX8e3-KnuyVjImY,16185
+openbox_core/contracts/results.py,sha256=2ysg0wpOfA4IeKZ_wNd0RYJAX_fG3OSgreMb6hSrBX4,16075
 openbox_core/hooks/__init__.py,sha256=jAZGEbN-sZbBD7o_tV-9ZDhBki88yHXKVQf4qhhkYTc,63
 openbox_core/hooks/events.py,sha256=PQSzH_8vLyUopjCDu6dxCtVh7OvNbiWnLx87fCY5jnU,2129
 openbox_core/hooks/preflight.py,sha256=uTgwuiV_WkV5RorbWz3tk0FXV85B1YIcjsDfFj-b6Fg,12520
@@ -47,6 +47,6 @@ openbox_core/validation/span_normalization.py,sha256=mB8GghMwOo3WGdKNrm6g8krP7Km
 openbox_core/wire/__init__.py,sha256=bI-snmNkEvLKqyYl1fItOCwAo46ehKD9vykOFfqaZz0,105
 openbox_core/wire/core_span.py,sha256=U_d93VSa8992DQ_dqP2dgzp4Vu7eEROishH_oQZFuvM,5059
 openbox_core/wire/evaluate_payload.py,sha256=RQ9TaeMLQ08YSmN1FYlvVFfOy0FLp0ve6LBLDi2ZKeI,2027
-openbox_sdk_python-1.1.0.dist-info/METADATA,sha256=M9FRSJ4hn1Zn3vaEBtDQ9nf2q1ckSeYWdsY81vLRpgQ,4385
-openbox_sdk_python-1.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-openbox_sdk_python-1.1.0.dist-info/RECORD,,
+openbox_sdk_python-1.2.0.dist-info/METADATA,sha256=lKukdD0C2JtaTGVyKtz2PZ69VtqSBQRgifu70IxKNIQ,4385
+openbox_sdk_python-1.2.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+openbox_sdk_python-1.2.0.dist-info/RECORD,,