qbraid-cli 0.16.0__tar.gz → 0.16.2__tar.gz

{qbraid_cli-0.16.0/qbraid_cli.egg-info → qbraid_cli-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.0
+Version: 0.16.2
 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
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typer>=0.12.1
 Requires-Dist: rich>=10.11.0
-Requires-Dist: click<=8.3.3
+Requires-Dist: click<=8.5.0
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: qbraid-core>=0.6.5
 Provides-Extra: compute

{qbraid_cli-0.16.0 → qbraid_cli-0.16.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.16.0"
+version = "0.16.2"
 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" }]
@@ -30,7 +30,7 @@ classifiers = [
 dependencies = [
     "typer>=0.12.1",
     "rich>=10.11.0",
-    "click<=8.3.3",
+    "click<=8.5.0",
     "questionary>=2.0.0",
     "qbraid-core>=0.6.5",
 ]

{qbraid_cli-0.16.0 → qbraid_cli-0.16.2}/qbraid_cli/agents/app.py

@@ -327,7 +327,12 @@ def agents_list(
             remote_flags.extend(["--limit", str(limit)])
             remote_flags.extend(["--page", str(page)])
 
-            console.print(f"[dim]Listing agents on {compute}...[/dim]")
+            # Nothing but the payload on stdout when --json is set: a caller
+            # piping this into a parser gets the status line too, and Rich
+            # would read square brackets in the payload as markup and mangle
+            # it. Status goes to stderr, the payload through plain print.
+            if not json_output:
+                console.print(f"[dim]Listing agents on {compute}...[/dim]")
             result = subprocess.run(
                 ["ssh", "-o", "ConnectTimeout=10", compute, " ".join(remote_flags)],
                 capture_output=True,
@@ -336,8 +341,29 @@ def agents_list(
                 timeout=30,
             )
             if result.returncode == 0:
-                console.print(result.stdout)
+                if json_output:
+                    payload = result.stdout.strip()
+                    if not payload:
+                        # Exit 0 with nothing on stdout means the remote did
+                        # not produce a listing -- most likely a remote CLI
+                        # too old to know --json. Printing the blank through
+                        # would hand a parser a bare newline while still
+                        # reporting success; an empty result is "[]", never "".
+                        typer.echo(
+                            f"No JSON returned by 'qbraid agents list' on {compute} "
+                            "(is the remote qbraid-cli recent enough to support --json?)",
+                            err=True,
+                        )
+                        raise typer.Exit(code=1)
+                    print(payload)
+                else:
+                    # markup=False -- see agents_status. Pre-existing on this
+                    # branch; the --json path above already bypasses Rich.
+                    console.print(result.stdout, markup=False)
             else:
+                if json_output:
+                    typer.echo(f"Failed: {result.stderr.strip()}", err=True)
+                    raise typer.Exit(code=1)
                 console.print(f"[red]Failed: {result.stderr.strip()}[/red]")
             return
 
@@ -590,11 +616,28 @@ def agents_discover(
 @agents_app.command("status")
 def agents_status(
     session_id: str = typer.Argument(..., help="Session ID (full or prefix)"),
+    compute: Optional[str] = typer.Option(None, "--compute", "-c", help="SSH alias for remote compute"),
 ):
-    """Show detailed status for an agent session."""
+    """Show detailed status for an agent session.
+
+    Without ``--compute`` this reads the local registry, which is per-host: an
+    agent on another machine is simply absent and reports as not found.
+    """
     try:
         from qbraid_core.services.agents import AgentSessionRegistryManager
 
+        if compute:
+            import shlex
+
+            # markup=False: remote output is already rendered, and Rich would
+            # read square brackets in it -- a branch name, a path -- as markup
+            # and silently drop them.
+            console.print(
+                _ssh_cmd(compute, f"qbraid agents status {shlex.quote(session_id)}"),
+                markup=False,
+            )
+            return
+
         registry = AgentSessionRegistryManager()
 
         # Support prefix and name matching
@@ -825,11 +868,25 @@ def agents_update(
 def agents_kill(
     target: str = typer.Argument(..., help="Agent name, ID prefix, or PID"),
     force: bool = typer.Option(False, "--force", "-f", help="Use SIGKILL instead of SIGTERM"),
+    compute: Optional[str] = typer.Option(None, "--compute", "-c", help="SSH alias for remote compute"),
 ):
-    """Stop an agent by name, session ID, or PID."""
+    """Stop an agent by name, session ID, or PID.
+
+    With ``--compute`` the agent is stopped on that machine. Without it, an
+    agent running elsewhere is simply not in this host's registry and reports
+    as not found -- the registry is per-host.
+    """
     try:
         from qbraid_core.services.agents import AgentSessionRegistryManager
 
+        if compute:
+            import shlex
+
+            flags = " --force" if force else ""
+            _ssh_cmd(compute, f"qbraid agents kill {shlex.quote(target)}{flags}")
+            console.print(f"[green]Stopped '{target}' on {compute}.[/green]")
+            return
+
         registry = AgentSessionRegistryManager()
         all_sessions = registry.load_registry().sessions
 
@@ -1529,14 +1586,39 @@ def agents_resume(
     execution_mode: Optional[ExecutionMode] = typer.Option(
         None, "--execution-mode", help="Override the recorded Codex execution mode for this resume."
     ),
+    compute: Optional[str] = typer.Option(None, "--compute", "-c", help="SSH alias for remote compute"),
 ):
     """Resume a previous agent session.
 
-    Resumes in a managed tmux window.
+    Resumes in a managed tmux window. With ``--compute`` the session is resumed
+    on that machine, and a session id is required -- the interactive picker
+    reads the local registry and cannot see another host's sessions.
     """
     try:
         from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
 
+        if compute:
+            if session_id is None:
+                console.print(
+                    "[red]--compute needs an explicit session id.[/red] The picker "
+                    "lists this host's sessions only; use 'qbraid agents list "
+                    f"--compute {compute}' to find one."
+                )
+                raise typer.Exit(code=2)
+            import shlex
+
+            flags = ""
+            if name:
+                flags += f" --name {shlex.quote(name)}"
+            if execution_mode:
+                flags += f" --execution-mode {shlex.quote(execution_mode.value)}"
+            # markup=False -- see agents_status.
+            console.print(
+                _ssh_cmd(compute, f"qbraid agents resume {shlex.quote(session_id)}{flags}"),
+                markup=False,
+            )
+            return
+
         # Interactive mode if no session_id provided
         if session_id is None:
             session_id = _interactive_resume(console)
@@ -1712,6 +1794,12 @@ def agents_send(
 ):
     """Send text to a running agent's terminal."""
     try:
+        # Imported before anything else in this try: the `except
+        # AgentLauncherError` clause below cannot be evaluated unless the name
+        # is bound, so a failure in the --compute branch above would raise
+        # UnboundLocalError and bury the real error instead of reporting it.
+        from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
+
         if compute:
             import shlex
 
@@ -1719,8 +1807,6 @@ def agents_send(
             console.print(f"[green]Sent text to session {session_id} on {compute}.[/green]")
             return
 
-        from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
-
         launcher = AgentLauncher()
         launcher.send(session_id, text)
         console.print(f"[green]Sent text to session {session_id}.[/green]")
@@ -1748,15 +1834,21 @@ def agents_read(
 ):
     """Read recent terminal output from an agent."""
     try:
+        # Imported before anything else in this try: the `except
+        # AgentLauncherError` clause below cannot be evaluated unless the name
+        # is bound, so a failure in the --compute branch above would raise
+        # UnboundLocalError and bury the real error instead of reporting it.
+        from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
+
         if compute:
             import shlex
 
             output = _ssh_cmd(compute, f"qbraid agents read {shlex.quote(session_id)} --lines {lines}")
-            console.print(output)
+            # markup=False -- see agents_status. Terminal output is exactly
+            # where square brackets are most likely, and this was dropping them.
+            console.print(output, markup=False)
             return
 
-        from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
-
         launcher = AgentLauncher()
         output = launcher.read(session_id, lines)
         console.print(output)
@@ -1779,14 +1871,25 @@ def agents_read(
 @agents_app.command("approve")
 def agents_approve(
     session_id: str = typer.Argument(..., help="Session ID (prefix match)"),
+    compute: Optional[str] = typer.Option(None, "--compute", "-c", help="SSH alias for remote compute"),
 ):
     """Approve a tool-use prompt.
 
-    Sends 'y' + Enter to the agent's terminal.
+    Sends 'y' + Enter to the agent's terminal. With ``--compute`` the approval
+    is sent on that machine.
     """
     try:
+        # Bound before the --compute branch below, which can raise: evaluating
+        # the `except AgentLauncherError` clause needs the name.
         from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
 
+        if compute:
+            import shlex
+
+            _ssh_cmd(compute, f"qbraid agents approve {shlex.quote(session_id)}")
+            console.print(f"[green]Approval sent to session {session_id} on {compute}.[/green]")
+            return
+
         launcher = AgentLauncher()
         launcher.approve(session_id)
         console.print(f"[green]Approval sent to session {session_id}.[/green]")
@@ -2791,6 +2894,11 @@ def agents_send_to(
 
     For multi-recipient / team broadcast, use ``qbraid agents broadcast``.
 
+    Same-host only: an inbox is a JSONL file under ``~/.qbraid/inboxes/`` on
+    the machine that owns it, so there is no ``--compute``. Cross-host
+    messaging needs a transport, tracked in qBraid-CLI#328 / qbraid-core#307.
+
+
     Delivery is a JSONL append at ~/.qbraid/inboxes/<to-session-id>.jsonl
     (local host only — cross-host messaging isn't yet supported and will raise
     a clear error). Permission rules (leader/worker/observer/reviewer) are
@@ -2858,6 +2966,10 @@ def agents_broadcast(
 ) -> None:
     """Broadcast to multiple agent inboxes.
 
+    Same-host only: an inbox is a JSONL file under ``~/.qbraid/inboxes/`` on
+    the machine that owns it, so there is no ``--compute``. Cross-host
+    messaging needs a transport, tracked in qBraid-CLI#328 / qbraid-core#307.
+
     Two selectors — pick exactly one:
       * ``--team <team_id>``  — every session with that team_id (except sender)
       * ``--to A,B,C``        — explicit id/prefix/name list
@@ -2985,6 +3097,10 @@ def inbox_default(  # pylint: disable=too-many-arguments
 
     Without a subcommand this reads the inbox (optionally streams with
     --follow). Use ``qbraid agents inbox mark-read`` to mark manually.
+
+    Same-host only: an inbox is a JSONL file under ``~/.qbraid/inboxes/`` on
+    the machine that owns it, so there is no ``--compute``. Cross-host
+    messaging needs a transport, tracked in qBraid-CLI#328 / qbraid-core#307.
     """
     if ctx.invoked_subcommand is not None:
         return
@@ -3092,6 +3208,10 @@ def agents_team(
 ) -> None:
     """Show a team roster with unread counts.
 
+    Same-host only: an inbox is a JSONL file under ``~/.qbraid/inboxes/`` on
+    the machine that owns it, so there is no ``--compute``. Cross-host
+    messaging needs a transport, tracked in qBraid-CLI#328 / qbraid-core#307.
+
     Answers the leader-orchestrator question "who is on my team, how many
     unread messages do they have, and what was the last thing they heard from
     anyone?" — which today requires peeking each worker's inbox individually.

{qbraid_cli-0.16.0 → qbraid_cli-0.16.2/qbraid_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.0
+Version: 0.16.2
 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
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: typer>=0.12.1
 Requires-Dist: rich>=10.11.0
-Requires-Dist: click<=8.3.3
+Requires-Dist: click<=8.5.0
 Requires-Dist: questionary>=2.0.0
 Requires-Dist: qbraid-core>=0.6.5
 Provides-Extra: compute

{qbraid_cli-0.16.0 → qbraid_cli-0.16.2}/qbraid_cli.egg-info/requires.txt

@@ -1,6 +1,6 @@
 typer>=0.12.1
 rich>=10.11.0
-click<=8.3.3
+click<=8.5.0
 questionary>=2.0.0
 qbraid-core>=0.6.5