qbraid-cli 0.16.10__tar.gz → 0.16.11__tar.gz

{qbraid_cli-0.16.10/qbraid_cli.egg-info → qbraid_cli-0.16.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.10
+Version: 0.16.11
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License-Expression: LicenseRef-Proprietary
@@ -30,11 +30,11 @@ Requires-Dist: typer>=0.12.1
 Requires-Dist: rich>=10.11.0
 Requires-Dist: click<=8.5.0
 Requires-Dist: questionary>=2.0.0
-Requires-Dist: qbraid-core>=0.6.27
+Requires-Dist: qbraid-core>=0.6.29
 Provides-Extra: compute
-Requires-Dist: qbraid-core[compute]>=0.6.27; extra == "compute"
+Requires-Dist: qbraid-core[compute]>=0.6.29; extra == "compute"
 Provides-Extra: envs
-Requires-Dist: qbraid-core[environments]>=0.6.27; extra == "envs"
+Requires-Dist: qbraid-core[environments]>=0.6.29; extra == "envs"
 Provides-Extra: dev
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: black; extra == "dev"

{qbraid_cli-0.16.10 → qbraid_cli-0.16.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.16.10"
+version = "0.16.11"
 description = "Command Line Interface for interacting with all parts of the qBraid platform."
 readme = "README.md"
 authors = [{ name = "qBraid Development Team", email = "contact@qbraid.com" }]
@@ -32,7 +32,7 @@ dependencies = [
     "rich>=10.11.0",
     "click<=8.5.0",
     "questionary>=2.0.0",
-    "qbraid-core>=0.6.27",
+    "qbraid-core>=0.6.29",
 ]
 requires-python = ">= 3.10"
 
@@ -43,8 +43,8 @@ Documentation = "https://docs.qbraid.com/v2/cli/api-reference/qbraid"
 Discord = "https://discord.gg/KugF6Cnncm"
 
 [project.optional-dependencies]
-compute = ["qbraid-core[compute]>=0.6.27"]
-envs = ["qbraid-core[environments]>=0.6.27"]
+compute = ["qbraid-core[compute]>=0.6.29"]
+envs = ["qbraid-core[environments]>=0.6.29"]
 dev = ["isort", "black", "pytest", "pytest-cov", "pytest-asyncio"]
 
 [project.scripts]

{qbraid_cli-0.16.10 → qbraid_cli-0.16.11}/qbraid_cli/agents/app.py

@@ -23,6 +23,8 @@ from rich.table import Table
 
 from qbraid_cli.handlers import handle_error, run_progress_task
 
+from .work import register_work_commands
+
 agents_app = typer.Typer(
     help=(
         "Manage AI coding agent sessions.\n\n"
@@ -69,6 +71,8 @@ agents_app.add_typer(inbox_app, name="inbox")
 
 console = Console()
 
+register_work_commands(agents_app)
+
 
 def _get_registry():
     """Get AgentSessionRegistryManager instance."""

qbraid_cli-0.16.11/qbraid_cli/agents/work.py

@@ -0,0 +1,188 @@
+# Copyright (c) 2026, qBraid Development Team
+# All rights reserved.
+"""Read-only access to provider-reported background jobs and schedules."""
+
+import json
+import re
+import shlex
+import subprocess
+import unicodedata
+from datetime import datetime, timezone
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+
+# C0 except tab, DEL, C1, and lone surrogates. A destination may run a Core
+# that stored them verbatim, so rendering never trusts Core to have removed
+# them: ESC/CSI/OSC/BEL can clear, hide, retitle, or hyperlink the terminal.
+_UNSAFE = re.compile("[\x00-\x08\x0a-\x1f\x7f-\x9f\ud800-\udfff]")
+_LINE_BREAKS = "\n\r\x0b\x0c\x85"
+COMMAND_PREVIEW = 160
+
+
+def _safe(value, multiline: bool = False) -> Text:
+    """Provider text as literal, terminal-inert text (never rich markup).
+
+    Line breaks become newlines (spaces in one-line cells); other controls
+    become U+FFFD in one pass, so nothing removed can join a new sequence.
+    """
+    text = value if isinstance(value, str) else ""
+    if multiline:
+        text = text.replace("\r\n", "\n")
+    text = _UNSAFE.sub(
+        lambda match: (("\n" if multiline else " ") if match.group() in _LINE_BREAKS else "\ufffd"),
+        text,
+    )
+    # Older destinations may retain bidi overrides, invisible formatting marks,
+    # and Unicode line/paragraph separators. Make them visible instead of
+    # joining their neighbours or allowing them to reorder IDs and statuses.
+    # Joiners remain in prose for ordinary scripts and emoji sequences.
+    return Text(
+        "".join(
+            (
+                "\ufffd"
+                if unicodedata.category(char) in {"Cf", "Zl", "Zp"}
+                and not (multiline and char in {"\u200c", "\u200d"})
+                else char
+            )
+            for char in text
+        )
+    )
+
+
+def _detail(row: dict) -> Text:
+    """Description, plus a one-line preview of a job's command (full text in --json)."""
+    cell = _safe(row.get("prompt", row.get("description", "")), multiline=True)
+    command = row.get("command")
+    if isinstance(command, str) and command:
+        preview = _safe(command).plain
+        if len(preview) > COMMAND_PREVIEW:
+            preview = preview[: COMMAND_PREVIEW - 1] + "\u2026"
+        cell.append(("\n" if cell.plain else "") + "$ " + preview, style="dim")
+    return cell
+
+
+class JobsReadError(ValueError):
+    """A safe, actionable error without provider prompts or transport output."""
+
+
+def _work_model():
+    """Load the optional Core capability without breaking other CLI commands."""
+    try:
+        from qbraid_core.services.agents.work import SessionWork
+    except ImportError:
+        raise JobsReadError(
+            "Update qbraid-core to a release supporting session-work-v1 to list jobs."
+        ) from None
+    return SessionWork
+
+
+def _read(session_id: str, compute: Optional[str]):
+    if compute:
+        if not re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9_.-]{0,127}", compute):
+            raise JobsReadError("Use a configured SSH alias for --compute.")
+        command = "qbraid agents jobs --json -- " + shlex.quote(session_id)
+        result = subprocess.run(
+            ["ssh", "-o", "BatchMode=yes", "-o", "ConnectTimeout=10", "--", compute, command],
+            stdin=subprocess.DEVNULL,
+            capture_output=True,
+            text=True,
+            timeout=30,
+            check=False,
+        )
+        if result.returncode:
+            raise JobsReadError(
+                "Could not read jobs on that machine. Check SSH and the destination CLI version."
+            )
+        try:
+            data = json.loads(result.stdout)
+        except ValueError:
+            raise JobsReadError("The destination returned an invalid jobs response.") from None
+        if not isinstance(data, dict) or data.get("sessionId") != session_id:
+            raise JobsReadError("The destination did not return this session's jobs.")
+        return data
+    from qbraid_core.services.agents.machine_protocol import CAPABILITIES, MachineProtocol
+
+    if "session-work-v1" not in CAPABILITIES:
+        raise JobsReadError("Update qbraid-core to a release supporting session-work-v1 to list jobs.")
+    return MachineProtocol().dispatch({"op": "session_work", "sessionId": session_id})
+
+
+def jobs(
+    session_id: str = typer.Argument(..., help="Exact qBraid session ID from agents list."),
+    compute: Optional[str] = typer.Option(None, "--compute", "-c", help="SSH alias for the owning machine."),
+    json_output: bool = typer.Option(False, "--json", help="Emit one JSON object; errors go to stderr."),
+):
+    """Inspect agent schedules and jobs.
+
+    This observes provider-owned work. It never creates a schedule, wakes an
+    agent, or treats missing telemetry as an empty list. Manage tasks through
+    the agent's own terminal. Claude reports snapshots after completing turns;
+    other providers report unsupported until they expose an inventory.
+    """
+    try:
+        model = _work_model()
+        data = _read(session_id, compute)
+        # Validate remote output too, before either JSON output or human tables.
+        # Model errors include input values, so never print their raw text.
+        data = model.model_validate(data).model_dump(by_alias=True)
+        if data["sessionId"] != session_id:
+            raise JobsReadError("The destination did not return this session's jobs.")
+    except Exception as error:
+        message = (
+            str(error)
+            if isinstance(error, JobsReadError)
+            else "Jobs could not be read for this exact session ID. Check it with "
+            "`qbraid agents list`; for a session on another machine, pass --compute <alias>."
+        )
+        typer.echo(message, err=True)
+        raise typer.Exit(1) from None
+    if json_output:
+        typer.echo(json.dumps(data, allow_nan=False))
+        return
+    console = Console()
+    snapshot = data.get("snapshot")
+    if data.get("state") != "observed" or not isinstance(snapshot, dict):
+        message = {
+            "unsupported": "This provider does not expose a supported jobs inventory.",
+            "not_observed": "No jobs snapshot has been reported for this runtime yet.",
+        }.get(
+            data.get("state"),
+            "No jobs snapshot can be read here. For a session on another machine, pass "
+            "--compute <alias>; otherwise its snapshot is unreadable, so check the agent's terminal.",
+        )
+        console.print(message, markup=False)
+        return
+    observed = datetime.fromtimestamp(snapshot["observedAt"], timezone.utc).isoformat()
+    console.print(
+        f"Last reported {observed}. This is an observation, not a live scheduler check.", markup=False
+    )
+    for key, title in (("schedules", "Schedules and loops"), ("jobs", "Background jobs")):
+        rows = snapshot.get(key)
+        if rows is None:
+            console.print(f"{title}: not reported.", markup=False)
+            continue
+        if not rows:
+            console.print(f"{title}: none reported.", markup=False)
+            continue
+        table = Table(title=title)
+        for heading in ("ID", "Schedule / status", "Prompt / description"):
+            table.add_column(heading)
+        for row in rows:
+            detail = _safe(row.get("schedule") if key == "schedules" else row.get("status"))
+            if not detail.plain:
+                detail = Text("unknown")
+            if key == "schedules":
+                detail.append(" (recurring)" if row.get("recurring") else " (once)")
+            table.add_row(_safe(row.get("id")), detail, _detail(row))
+        console.print(table)
+    if snapshot.get("truncated"):
+        console.print("Some entries were shortened or omitted. Check the agent's terminal for the full list.")
+
+
+def register_work_commands(app: typer.Typer):
+    """Keep the agent CLI's command registration thin."""
+    app.command("jobs")(jobs)

{qbraid_cli-0.16.10 → qbraid_cli-0.16.11/qbraid_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.10
+Version: 0.16.11
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License-Expression: LicenseRef-Proprietary
@@ -30,11 +30,11 @@ Requires-Dist: typer>=0.12.1
 Requires-Dist: rich>=10.11.0
 Requires-Dist: click<=8.5.0
 Requires-Dist: questionary>=2.0.0
-Requires-Dist: qbraid-core>=0.6.27
+Requires-Dist: qbraid-core>=0.6.29
 Provides-Extra: compute
-Requires-Dist: qbraid-core[compute]>=0.6.27; extra == "compute"
+Requires-Dist: qbraid-core[compute]>=0.6.29; extra == "compute"
 Provides-Extra: envs
-Requires-Dist: qbraid-core[environments]>=0.6.27; extra == "envs"
+Requires-Dist: qbraid-core[environments]>=0.6.29; extra == "envs"
 Provides-Extra: dev
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: black; extra == "dev"

{qbraid_cli-0.16.10 → qbraid_cli-0.16.11}/qbraid_cli.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ qbraid_cli/admin/validation.py
 qbraid_cli/agents/__init__.py
 qbraid_cli/agents/app.py
 qbraid_cli/agents/permission_response.py
+qbraid_cli/agents/work.py
 qbraid_cli/ai/__init__.py
 qbraid_cli/ai/app.py
 qbraid_cli/ai/token.py

{qbraid_cli-0.16.10 → qbraid_cli-0.16.11}/qbraid_cli.egg-info/requires.txt

@@ -2,10 +2,10 @@ typer>=0.12.1
 rich>=10.11.0
 click<=8.5.0
 questionary>=2.0.0
-qbraid-core>=0.6.27
+qbraid-core>=0.6.29
 
 [compute]
-qbraid-core[compute]>=0.6.27
+qbraid-core[compute]>=0.6.29
 
 [dev]
 isort
@@ -15,4 +15,4 @@ pytest-cov
 pytest-asyncio
 
 [envs]
-qbraid-core[environments]>=0.6.27
+qbraid-core[environments]>=0.6.29