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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.2
+Version: 0.16.4
 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.5
+Requires-Dist: qbraid-core>=0.6.11
 Provides-Extra: compute
-Requires-Dist: qbraid-core[compute]>=0.6.5; extra == "compute"
+Requires-Dist: qbraid-core[compute]>=0.6.11; extra == "compute"
 Provides-Extra: envs
-Requires-Dist: qbraid-core[environments]>=0.6.5; extra == "envs"
+Requires-Dist: qbraid-core[environments]>=0.6.11; extra == "envs"
 Provides-Extra: dev
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -161,3 +161,16 @@ Now you can continue to use the qBraid-CLI as normal from within your Jupyter no
 ```python
 In [2]: %qbraid jobs list
 ```
+
+### Agent updates
+
+Send yourself Slack or email updates and read Slack replies using existing qBraid credentials:
+
+```bash
+qbraid comms slack send "Tests passed" --json
+qbraid comms email send --subject "Progress" --file report.txt --json
+qbraid comms slack read --json
+```
+
+See [communication commands](docs/comms-cli.md) for Slack connection, stdin input,
+pagination, and deployment requirements.

{qbraid_cli-0.16.2 → qbraid_cli-0.16.4}/README.md

@@ -116,3 +116,16 @@ Now you can continue to use the qBraid-CLI as normal from within your Jupyter no
 ```python
 In [2]: %qbraid jobs list
 ```
+
+### Agent updates
+
+Send yourself Slack or email updates and read Slack replies using existing qBraid credentials:
+
+```bash
+qbraid comms slack send "Tests passed" --json
+qbraid comms email send --subject "Progress" --file report.txt --json
+qbraid comms slack read --json
+```
+
+See [communication commands](docs/comms-cli.md) for Slack connection, stdin input,
+pagination, and deployment requirements.

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.16.2"
+version = "0.16.4"
 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.5",
+    "qbraid-core>=0.6.11",
 ]
 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.5"]
-envs = ["qbraid-core[environments]>=0.6.5"]
+compute = ["qbraid-core[compute]>=0.6.11"]
+envs = ["qbraid-core[environments]>=0.6.11"]
 dev = ["isort", "black", "pytest", "pytest-cov", "pytest-asyncio"]
 
 [project.scripts]

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

@@ -89,13 +89,43 @@ def _ssh_cmd(ssh_alias: str, remote_cmd: str, timeout: int = 30) -> str:
         text=True,
         check=False,
         timeout=timeout,
+        # ssh reads stdin unless told otherwise, so inside a script or a
+        # `while read` loop it swallowed the caller's remaining input.
+        stdin=_sp.DEVNULL,
     )
     if result.returncode != 0:
-        console.print(f"[red]Remote command failed: {result.stderr.strip()}[/red]")
+        console.print(
+            f"[red]Remote command failed: {_remote_failure(result.stdout, result.stderr)}[/red]",
+            markup=True,
+        )
         raise typer.Exit(code=1)
     return result.stdout
 
 
+# ssh's own chatter, which says nothing about why the remote command failed.
+_SSH_NOISE = ("Warning: Permanently added", "Connection to ", "Shared connection to ")
+
+
+def _remote_failure(stdout: str, stderr: str) -> str:
+    """Say why a remote qbraid command failed.
+
+    The remote CLI prints its errors through Rich on *stdout*; stderr usually
+    holds only ssh's known-hosts warning. Reporting stderr alone turned
+    "Session not found" into "Warning: Permanently added ... to the list of
+    known hosts", which names the one thing that went right.
+    """
+    from rich.markup import escape
+
+    def useful(text: str) -> list[str]:
+        # The remote's Rich error panel arrives as box-drawing borders around
+        # the message; keep the message, drop the frame.
+        lines = [line.strip().strip("│╭╮╰╯─ ") for line in (text or "").splitlines()]
+        return [line for line in lines if line and not line.startswith(_SSH_NOISE)]
+
+    lines = useful(stdout)[-3:] or useful(stderr)[-3:]
+    return escape(" / ".join(lines)) if lines else "no output from the remote command"
+
+
 def _status_style(status_value: str) -> str:
     """Return a rich style string for a given agent status."""
     styles = {
@@ -339,6 +369,7 @@ def agents_list(
                 text=True,
                 check=False,
                 timeout=30,
+                stdin=subprocess.DEVNULL,
             )
             if result.returncode == 0:
                 if json_output:
@@ -361,10 +392,14 @@ def agents_list(
                     # branch; the --json path above already bypasses Rich.
                     console.print(result.stdout, markup=False)
             else:
+                reason = _remote_failure(result.stdout, result.stderr)
                 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]")
+                    typer.echo(f"Failed: {reason}", err=True)
+                else:
+                    console.print(f"[red]Failed: {reason}[/red]")
+                # Both branches fail. The human-readable one used to print
+                # "Failed" and exit 0, so a script could not tell.
+                raise typer.Exit(code=1)
             return
 
         registry = _get_registry()
@@ -1868,6 +1903,44 @@ def agents_read(
 # =============================================================================
 
 
+@agents_app.command("notifier")
+def agents_notifier(
+    interval: float = typer.Option(4.0, "--interval", "-i", min=1.0, help="Seconds between checks"),
+    once: bool = typer.Option(False, "--once", help="Check once, print who was nudged, and exit"),
+):
+    """Wake idle agents when inbox mail arrives.
+
+    Inbox delivery is passive: an agent parked at its prompt never notices a
+    message. This watches the inboxes of this machine's managed agents and
+    types a one-line nudge into an idle agent's pane. Busy agents are left
+    alone until they go idle, and a burst of messages is one nudge.
+
+    qBraid Lab runs this for you. Use it on a machine reached only over SSH.
+    Same-host: it watches the inboxes on the machine it runs on.
+    """
+    try:
+        try:
+            from qbraid_core.services.agents.inbox_watcher import InboxWatcher, watch
+        except ImportError:
+            console.print("[red]This needs a newer qbraid-core.[/red] Run: pip install -U qbraid-core")
+            raise typer.Exit(code=1)  # pylint: disable=raise-missing-from
+
+        watcher = InboxWatcher()
+        if once:
+            nudged = watcher.poll_once()
+            console.print(f"Nudged: {', '.join(nudged) if nudged else 'nobody'}", markup=False)
+            return
+        console.print(f"[dim]Watching inboxes every {interval:g}s... (Ctrl+C to stop)[/dim]")
+        watch(interval=interval, watcher=watcher)
+    except KeyboardInterrupt:
+        console.print("[dim]Stopped.[/dim]")
+    except (typer.Exit, SystemExit):
+        raise
+    except Exception as e:  # pylint: disable=broad-exception-caught
+        handle_error(message=str(e))
+        raise typer.Exit(code=1)
+
+
 @agents_app.command("approve")
 def agents_approve(
     session_id: str = typer.Argument(..., help="Session ID (prefix match)"),
@@ -2014,6 +2087,7 @@ def agents_watch(
                 ["ssh", "-o", "ConnectTimeout=10", compute, remote_flags],
                 stdout=_sp.PIPE,
                 stderr=_sp.PIPE,
+                stdin=_sp.DEVNULL,
                 text=True,
             )
             try:

qbraid_cli-0.16.4/qbraid_cli/comms/__init__.py

@@ -0,0 +1,8 @@
+# Copyright (c) 2026, qBraid Development Team
+# All rights reserved.
+
+"""Communication with the authenticated account owner."""
+
+from .app import comms_app
+
+__all__ = ["comms_app"]

qbraid_cli-0.16.4/qbraid_cli/comms/app.py

@@ -0,0 +1,124 @@
+# Copyright (c) 2026, qBraid Development Team
+# All rights reserved.
+
+"""Agent-friendly Slack DMs and email updates through the qBraid API."""
+
+import json
+import sys
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+comms_app = typer.Typer(help="Send updates and read replies.", no_args_is_help=True)
+slack_app = typer.Typer(help="Message your linked Slack account.", no_args_is_help=True)
+email_app = typer.Typer(help="Email your qBraid account address.", no_args_is_help=True)
+comms_app.add_typer(slack_app, name="slack")
+comms_app.add_typer(email_app, name="email")
+
+
+def _message(text: Optional[str], file: Optional[str]) -> str:
+    """Require one explicit source; never wait on stdin implicitly."""
+    if (text is None) == (file is None):
+        raise typer.BadParameter("Provide message text or --file PATH (use --file - for stdin).")
+    try:
+        if text is not None:
+            value = text
+        else:
+            assert file is not None  # Exactly one source was validated above.
+            value = sys.stdin.read(20001) if file == "-" else Path(file).read_text(encoding="utf-8")
+    except (OSError, UnicodeError) as exc:
+        raise typer.BadParameter(f"Cannot read message: {exc}") from exc
+    return value
+
+
+def _get_client():
+    """Load core lazily so older installations can still use other commands."""
+    try:
+        from qbraid_core.services.comms import CommsClient
+    except ImportError as exc:
+        raise RuntimeError(
+            "Communication commands require a qbraid-core release with CommsClient. "
+            "Upgrade qbraid-core to version 0.6.11 or newer."
+        ) from exc
+    return CommsClient()
+
+
+def _run(method: str, *args, **kwargs):
+    """Translate core errors into CLI exit codes; core owns the API contract."""
+    try:
+        with _get_client() as client:
+            return getattr(client, method)(*args, **kwargs)
+    except ValueError as exc:
+        raise typer.BadParameter(str(exc)) from exc
+    except Exception as exc:
+        typer.echo(f"Error: {exc}", err=True)
+        if method in ("send_slack", "send_email"):
+            typer.echo(
+                "Delivery was not confirmed; check before retrying to avoid duplicate updates.", err=True
+            )
+        raise typer.Exit(1) from exc
+
+
+def _sent(data, as_json: bool, label: str):
+    typer.echo(json.dumps(data, ensure_ascii=True) if as_json else label)
+
+
+@slack_app.command("connect")
+def slack_connect():
+    """Print the URL to link your Slack account."""
+    typer.echo(_run("get_slack_auth_url"))
+
+
+@slack_app.command("send")
+def slack_send(
+    message: Optional[str] = typer.Argument(None, help="Message for your linked Slack DM."),
+    file: Optional[str] = typer.Option(None, "--file", "-f", help="UTF-8 file, or - for stdin."),
+    as_json: bool = typer.Option(False, "--json", help="Output the API result as JSON."),
+):
+    """Send a Slack DM to yourself."""
+    text = _message(message, file)
+    data = _run("send_slack", text)
+    _sent(data, as_json, "Slack update sent.")
+
+
+@email_app.command("send")
+def email_send(
+    message: Optional[str] = typer.Argument(None, help="Plain-text email body."),
+    subject: str = typer.Option(..., "--subject", "-s", help="Single-line subject (max 200 characters)."),
+    file: Optional[str] = typer.Option(None, "--file", "-f", help="UTF-8 file, or - for stdin."),
+    as_json: bool = typer.Option(False, "--json", help="Output the API result as JSON."),
+):
+    """Email an update to yourself."""
+    text = _message(message, file)
+    data = _run("send_email", subject, text)
+    _sent(data, as_json, "Email update sent.")
+
+
+@slack_app.command("read")
+def slack_read(
+    after: Optional[str] = typer.Option(
+        None, "--after", help="Only messages newer than this Slack timestamp."
+    ),
+    cursor: Optional[str] = typer.Option(
+        None, "--cursor", help="Continue with nextCursor from a prior page."
+    ),
+    limit: int = typer.Option(
+        15, "--limit", min=1, max=15, help="Slack history page size, before filtering."
+    ),
+    as_json: bool = typer.Option(False, "--json", help="Output messages and pagination as JSON."),
+):
+    """Read your messages to the Slack bot."""
+    data = _run("read_slack", after=after, cursor=cursor, limit=limit)
+    if as_json:
+        typer.echo(json.dumps(data, ensure_ascii=True))
+        return
+    for message in data["messages"]:
+        # Escape terminal control characters in remote message content.
+        typer.echo(f'{message["ts"]}  {json.dumps(message["text"], ensure_ascii=True)}')
+    if not data["messages"]:
+        typer.echo("No messages from you on this page.")
+    if data.get("nextCursor"):
+        typer.echo(f'Next cursor: {data["nextCursor"]}')
+    elif data.get("hasMore"):
+        typer.echo("More history is available; the API did not return a continuation cursor.")

{qbraid_cli-0.16.2 → qbraid_cli-0.16.4}/qbraid_cli/main.py

@@ -13,6 +13,7 @@ from qbraid_cli.account import account_app
 from qbraid_cli.admin import admin_app
 from qbraid_cli.agents import agents_app
 from qbraid_cli.ai.app import ai_app
+from qbraid_cli.comms import comms_app
 from qbraid_cli.compute import compute_app
 from qbraid_cli.configure import configure_app
 from qbraid_cli.devices import devices_app
@@ -46,6 +47,7 @@ app.add_typer(admin_app, name="admin")
 app.add_typer(agents_app, name="agents")
 app.add_typer(ai_app, name="ai")
 app.add_typer(compute_app, name="compute")
+app.add_typer(comms_app, name="comms")
 app.command(name="lab", context_settings=LAB_CONTEXT_SETTINGS)(lab_command)
 app.add_typer(configure_app, name="configure")
 app.add_typer(account_app, name="account")

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.16.2
+Version: 0.16.4
 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.5
+Requires-Dist: qbraid-core>=0.6.11
 Provides-Extra: compute
-Requires-Dist: qbraid-core[compute]>=0.6.5; extra == "compute"
+Requires-Dist: qbraid-core[compute]>=0.6.11; extra == "compute"
 Provides-Extra: envs
-Requires-Dist: qbraid-core[environments]>=0.6.5; extra == "envs"
+Requires-Dist: qbraid-core[environments]>=0.6.11; extra == "envs"
 Provides-Extra: dev
 Requires-Dist: isort; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -161,3 +161,16 @@ Now you can continue to use the qBraid-CLI as normal from within your Jupyter no
 ```python
 In [2]: %qbraid jobs list
 ```
+
+### Agent updates
+
+Send yourself Slack or email updates and read Slack replies using existing qBraid credentials:
+
+```bash
+qbraid comms slack send "Tests passed" --json
+qbraid comms email send --subject "Progress" --file report.txt --json
+qbraid comms slack read --json
+```
+
+See [communication commands](docs/comms-cli.md) for Slack connection, stdin input,
+pagination, and deployment requirements.

{qbraid_cli-0.16.2 → qbraid_cli-0.16.4}/qbraid_cli.egg-info/SOURCES.txt

@@ -26,6 +26,8 @@ qbraid_cli/agents/permission_response.py
 qbraid_cli/ai/__init__.py
 qbraid_cli/ai/app.py
 qbraid_cli/ai/token.py
+qbraid_cli/comms/__init__.py
+qbraid_cli/comms/app.py
 qbraid_cli/compute/__init__.py
 qbraid_cli/compute/app.py
 qbraid_cli/compute/instances.py

{qbraid_cli-0.16.2 → qbraid_cli-0.16.4}/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.5
+qbraid-core>=0.6.11
 
 [compute]
-qbraid-core[compute]>=0.6.5
+qbraid-core[compute]>=0.6.11
 
 [dev]
 isort
@@ -15,4 +15,4 @@ pytest-cov
 pytest-asyncio
 
 [envs]
-qbraid-core[environments]>=0.6.5
+qbraid-core[environments]>=0.6.11