blobhub-cli 0.7.0__tar.gz → 0.8.0__tar.gz

{blobhub_cli-0.7.0 → blobhub_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: blobhub-cli
-Version: 0.7.0
+Version: 0.8.0
 Summary: BlobHub command line interface — work with blobs, revisions, and their contents from the terminal
 Project-URL: Homepage, https://blobhub.io/
 Project-URL: Documentation, https://docs.blobhub.io/

{blobhub_cli-0.7.0 → blobhub_cli-0.8.0}/src/blobhub_cli/__init__.py

@@ -5,4 +5,4 @@ Contract: this module is the sole source of the package version — hatchling re
 Invariant: no other file in this package defines `__version__`.
 """
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{blobhub_cli-0.7.0 → blobhub_cli-0.8.0}/src/blobhub_cli/commands/events.py

@@ -18,6 +18,7 @@ from blobhub_cli.api.commands import Api
 from blobhub_cli.api.errors import ApiAuthError, ApiCommandError
 from blobhub_cli.config import settings
 from blobhub_cli.config.settings import Settings
+from blobhub_cli.definition.listener import DEFAULT_RETRY_DELAY_SECONDS
 from blobhub_cli.exit import CliExit
 from blobhub_cli.workflow import event_filter, follow, session_reference
 from blobhub_cli.workflow import events as event_lines
@@ -166,7 +167,7 @@ def events(
     return payload
 
 
-_ROW = "{:<{width}} {:<13} {:<9} {:<6} {:<8} {:<40} {}"
+_ROW = "{:<{width}} {:<13} {:<9} {:<7} {:<6} {:<8} {:<40} {}"
 _MORE_RUNS = "no runs in the newest 1,000 executions; more exist"
 
 
@@ -194,15 +195,25 @@ def _mode(entry: dict) -> str:
     return entry["definition"].get("concurrency", {}).get("mode", "serial")
 
 
+def _retry(entry: dict) -> str:
+    retry = entry["definition"].get("retry")
+    if not isinstance(retry, dict) or "attempts" not in retry:
+        return "-"
+    return f"{retry['attempts']}x{retry.get('delay_seconds', DEFAULT_RETRY_DELAY_SECONDS)}s"
+
+
 def _render_entry_line(entry: dict, width: int) -> str:
     pending = entry.get("pending", {}).get("count", 0)
-    cells = (entry["alias"], _enabled(entry), _mode(entry), _slots(entry), pending, _last(entry), _counts(entry))
+    cells = (
+        entry["alias"], _enabled(entry), _mode(entry), _retry(entry), _slots(entry), pending, _last(entry),
+        _counts(entry),
+    )
     return _ROW.format(*cells, width=width)
 
 
 def _render_listeners(payload: dict) -> None:
     width = max([len("ALIAS"), *(len(entry["alias"]) for entry in payload["listeners"])])
-    print(_ROW.format("ALIAS", "ENABLED", "MODE", "SLOTS", "PENDING", "LAST", "COUNTS", width=width))
+    print(_ROW.format("ALIAS", "ENABLED", "MODE", "RETRY", "SLOTS", "PENDING", "LAST", "COUNTS", width=width))
     for entry in payload["listeners"]:
         print(_render_entry_line(entry, width))
     if payload["connections"]:
@@ -220,12 +231,13 @@ def _render_listener_detail(payload: dict) -> None:
     print(f"{entry['alias']}  {_enabled(entry)}  slots {_slots(entry)}  {_counts(entry)}")
     if entry.get("description"):
         print(f"description: {entry['description']}")
-    for field in ("filter", "batch", "concurrency", "invocation_target_type", "invocation_target"):
+    for field in ("filter", "batch", "concurrency", "retry", "invocation_target_type", "invocation_target"):
         if field in body:
             print(f"{field}: {json.dumps(body[field])}")
     print("\nOutcomes")
     for outcome in entry["outcomes"] or []:
-        print(f"  {outcome['at']}  {outcome['status']}  count={outcome['count']}  batch={outcome['batch_id']}")
+        retry = f" retry={outcome['retry']}" if "retry" in outcome else ""
+        print(f"  {outcome['at']}  {outcome['status']}  count={outcome['count']}  batch={outcome['batch_id']}{retry}")
     if not entry["outcomes"]:
         print("  none")
     print("\nRuns")

{blobhub_cli-0.7.0 → blobhub_cli-0.8.0}/src/blobhub_cli/definition/listener.py

@@ -1,7 +1,8 @@
 """Offline validation, write-target shapes and comparison of a listener definition body.
 
-Contract: `error` returns the first violation of docs/specs/2026-11-10-workflow_listeners.md section 4.4, in the
-platform's wording (blobhub-infra `listeners/definition.py`), or None; `comparable` fills the documented defaults.
+Contract: `error` returns the first violation of docs/specs/2026-11-10-workflow_listeners.md section 4.4 and of
+docs/specs/2026-11-14-listener-retry.md, in the platform's wording (blobhub-infra `listeners/definition.py`), or
+None; `comparable` fills the documented defaults.
 Invariant: templates are only checked for being strings -- their syntax and names are the platform's -- and nothing
 here reads the catalog except through the `groups` a caller hands in.
 """
@@ -15,7 +16,7 @@ TYPE = "listener_definition"
 VERSION = "1.0.0"
 BODY_KEYS = (
     "type", "version", "description", "enabled", "filter", "batch", "concurrency", "invocation_target_type",
-    "invocation_target", "receipt",
+    "invocation_target", "receipt", "retry",
 )
 CONTEXTS = ("batch", "event", "listener", "item", "object")
 MARKERS = ("{{", "{%", "{#")
@@ -25,6 +26,7 @@ BATCH_KEYS = ("window_seconds", "max_events", "distinct_by")
 CONCURRENCY_KEYS = ("mode", "key", "key_segments", "max_parallel")
 CONCURRENCY_MODES = ("serial", "keyed", "parallel")
 RECEIPT_KEYS = ("alias", "type", "parent")
+RETRY_KEYS = ("attempts", "delay_seconds")
 WORKFLOW_TARGET_KEYS = ("workflow", "input_data")
 THREAD_ITEM_KEYS = ("alias", "content", "metadata", "parent_id")
 OBJECT_KEYS = ("alias", "value")
@@ -33,6 +35,9 @@ REFERENCE_KEYS = ("org", "blob", "revision", "definition")
 REFERENCE_DEPENDENCIES = {"org": "blob", "revision": "blob", "blob": "revision"}
 
 DEFAULT_MAX_EVENTS = 100
+MAX_RETRY_ATTEMPTS = 3
+MAX_RETRY_DELAY_SECONDS = 900
+DEFAULT_RETRY_DELAY_SECONDS = 30
 MAX_DISTINCT_BY = 8
 MAX_PATH_SEGMENTS = 8
 MAX_KEY_SEGMENTS = 16
@@ -60,6 +65,7 @@ def error(body: object, *, groups: list[dict] | None = None) -> str | None:
         or _concurrency(body.get("concurrency", {}), groups)
         or _target(body)
         or (_receipt(body["receipt"]) if "receipt" in body else None)
+        or (_retry(body["retry"], body["invocation_target_type"]) if "retry" in body else None)
     )
 
 
@@ -111,6 +117,9 @@ def comparable(local: dict, remote: dict) -> tuple[dict, dict]:
         if isinstance(batch, dict):
             batch.setdefault("window_seconds", 0)
             batch.setdefault("max_events", DEFAULT_MAX_EVENTS)
+        retry = body.get("retry")
+        if isinstance(retry, dict):
+            retry.setdefault("delay_seconds", DEFAULT_RETRY_DELAY_SECONDS)
     omitted = isinstance(local["concurrency"], dict) and "max_parallel" not in local["concurrency"]
     if omitted and isinstance(remote["concurrency"], dict):
         remote["concurrency"].pop("max_parallel", None)
@@ -323,3 +332,17 @@ def _receipt(receipt: object) -> str | None:
     if "parent" in receipt and receipt["parent"] != "item":
         return 'receipt.parent: must be "item"'
     return None
+
+
+def _retry(retry: object, target_type: str) -> str | None:
+    if message := _keys("retry", retry, RETRY_KEYS):
+        return message
+    attempts = retry.get("attempts")
+    if not _is_int(attempts) or not 1 <= attempts <= MAX_RETRY_ATTEMPTS:
+        return f"retry.attempts: must be an integer from 1 to {MAX_RETRY_ATTEMPTS}"
+    delay = retry.get("delay_seconds", DEFAULT_RETRY_DELAY_SECONDS)
+    if not _is_int(delay) or not 0 <= delay <= MAX_RETRY_DELAY_SECONDS:
+        return f"retry.delay_seconds: must be an integer from 0 to {MAX_RETRY_DELAY_SECONDS}"
+    if target_type != "workflow":
+        return "retry: only a workflow action has a run to retry"
+    return None