uro-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{uro_cli-0.4.0 → uro_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: uro-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Uro Engine reference client — play, dry-run, and dev tools against the engine
 Project-URL: Homepage, https://github.com/cupskeee/uro
 Project-URL: Repository, https://github.com/cupskeee/uro
@@ -12,8 +12,8 @@ Requires-Python: >=3.12
 Requires-Dist: python-dotenv>=1.0
 Requires-Dist: rich>=13.9
 Requires-Dist: typer>=0.27.2
-Requires-Dist: uro-core[llm,postgres]==0.4.0
-Requires-Dist: uro-server==0.4.0
+Requires-Dist: uro-core[llm,postgres]==0.5.0
+Requires-Dist: uro-server==0.5.0
 Requires-Dist: websockets>=16.1
 Description-Content-Type: text/markdown
 

{uro_cli-0.4.0 → uro_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uro-cli"
-version = "0.4.0"
+version = "0.5.0"
 description = "Uro Engine reference client — play, dry-run, and dev tools against the engine"
 license = "MIT"
 license-files = ["LICENSE"]
@@ -13,8 +13,8 @@ requires-python = ">=3.12"
 # pair a new uro-cli with an old uro-core; `just release` bumps all three together, and the
 # `{workspace = true}` sources make a drifted pin fail `uv sync` locally.
 dependencies = [
-    "uro-core[postgres,llm]==0.4.0",
-    "uro-server==0.4.0",
+    "uro-core[postgres,llm]==0.5.0",
+    "uro-server==0.5.0",
     "typer>=0.27.2",
     "rich>=13.9",
     "websockets>=16.1",

{uro_cli-0.4.0 → uro_cli-0.5.0}/uro_cli/main.py

@@ -53,6 +53,10 @@ provider_app = typer.Typer(
     no_args_is_help=True,
     help="Model connections — the DB-backed LLM provider registry (D-47, docs/20).",
 )
+outbox_app = typer.Typer(
+    no_args_is_help=True,
+    help="The transactional outbox — publish committed beats to other processes (D-57).",
+)
 app.add_typer(db_app, name="db")
 app.add_typer(world_app, name="world")
 app.add_typer(branch_app, name="branch")
@@ -60,6 +64,7 @@ app.add_typer(campaign_app, name="campaign")
 app.add_typer(codex_app, name="codex")
 app.add_typer(token_app, name="token")
 app.add_typer(provider_app, name="provider")
+app.add_typer(outbox_app, name="outbox")
 
 # The engine roles a connection can back (resolved by the ProviderRouter) — shared with the server.
 _ROLES = tuple(sorted(ROLES))
@@ -733,6 +738,67 @@ def _server_post(server: str, path: str, token: str, body: dict[str, Any]) -> di
         raise typer.Exit(1) from exc
 
 
+@outbox_app.command("status")
+def outbox_status() -> None:
+    """How many committed beats are waiting to be published."""
+
+    async def _run() -> None:
+        store = build_store()
+        await connect_store(store)
+        try:
+            typer.echo(f"pending: {await store.outbox_pending()}")
+        finally:
+            await store.close()
+
+    _run_async(_run)
+
+
+@outbox_app.command("relay")
+def outbox_relay(
+    nats_url: str = typer.Option(..., "--nats", help="NATS server URL, e.g. nats://localhost:4222"),
+    stream: str = typer.Option("URO", help="JetStream stream (created if missing)"),
+    subject_prefix: str = typer.Option("uro", help="subjects are <prefix>.<world>.<branch>"),
+    once: bool = typer.Option(False, "--once", help="drain what is pending, then exit"),
+    interval: float = typer.Option(1.0, help="seconds between polls (without --once)"),
+    batch: int = typer.Option(100, min=1, help="commits claimed per transaction"),
+) -> None:
+    """Publish committed beats to NATS JetStream (D-57). At-least-once from the outbox; JetStream
+    drops a re-sent commit (Nats-Msg-Id = commit id). Run ONE relay to keep each branch in commit
+    order (there is no global order across branches); several are safe — no row is published
+    twice — but may interleave a branch. A publish error is retried with backoff (`--once` exits
+    instead)."""
+    try:
+        from uro_core.adapters.nats import NatsJetStreamPublisher
+    except ImportError as exc:
+        typer.echo("the NATS relay needs `pip install 'uro-core[nats]'`", err=True)
+        raise typer.Exit(1) from exc
+    from uro_core.outbox import relay_forever, relay_outbox
+
+    async def _run() -> None:
+        store = build_store()
+        await connect_store(store)
+        publisher = NatsJetStreamPublisher(nats_url, stream=stream, subject_prefix=subject_prefix)
+        await publisher.connect()
+        try:
+            if once:  # a one-shot drain: an error exits non-zero (right for scripts and cron)
+                sent = await relay_outbox(store, publisher, limit=batch)
+                typer.echo(f"published {sent} commit(s)")
+                return
+            # the daemon: a publish error is logged and retried with backoff, never fatal
+            await relay_forever(
+                store,
+                publisher,
+                interval=interval,
+                limit=batch,
+                on_published=lambda n: typer.echo(f"published {n} commit(s)"),
+            )
+        finally:
+            await publisher.close()
+            await store.close()
+
+    _run_async(_run)
+
+
 @token_app.command("mint")
 def token_mint(
     campaign_id: str,