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

{qbraid_cli-0.16.3/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.3
+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.3 → 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.3 → qbraid_cli-0.16.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.16.3"
+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.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.3 → 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.3 → 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.3
+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.3 → 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.3 → 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