qbraid-cli 0.14.0__tar.gz → 0.15.0__tar.gz

{qbraid_cli-0.14.0/qbraid_cli.egg-info → qbraid_cli-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.14.0
+Version: 0.15.0
 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

{qbraid_cli-0.14.0 → qbraid_cli-0.15.0}/pyproject.toml

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

{qbraid_cli-0.14.0 → qbraid_cli-0.15.0}/qbraid_cli/agents/app.py

@@ -3,13 +3,15 @@
 
 """Agents CLI - Monitor and manage AI coding agent sessions."""
 
+import inspect
 import os
 import re
 import signal
 import time
 from datetime import datetime
+from enum import Enum
 from pathlib import Path
-from typing import List, Optional
+from typing import Any, Callable, Dict, List, Optional
 
 import click
 import typer
@@ -1096,10 +1098,59 @@ def _interactive_attach(console_: Console) -> str:
     return selected
 
 
+class ApprovalMode(str, Enum):
+    """How much the agent asks before acting.
+
+    A launched agent is detached, so a confirmation prompt has nobody to
+    answer it — ``auto`` is the mode for anything you intend to leave running.
+    """
+
+    ASK = "ask"
+    AUTO = "auto"
+
+
+def _approval_kwargs(method: Callable[..., Any], approval: Optional[str]) -> Dict[str, Any]:
+    """Forward ``approval`` only to a qbraid-core new enough to accept it.
+
+    The CLI's floor is qbraid-core>=0.5.0, which predates the parameter. Passing
+    it unconditionally would raise TypeError on EVERY launch there, not only
+    when --approval was used — so detect support and, when the user actually
+    asked for a mode we cannot honour, say so plainly instead of forwarding it.
+
+    A Mock reports ``(*args, **kwargs)``; VAR_KEYWORD therefore counts as
+    support, which is both correct in general and keeps test doubles working.
+    """
+    try:
+        params = inspect.signature(method).parameters
+        supported = "approval" in params or any(
+            param.kind is inspect.Parameter.VAR_KEYWORD for param in params.values()
+        )
+    except (TypeError, ValueError):  # pragma: no cover - non-introspectable callable
+        supported = True
+
+    if supported:
+        return {"approval": approval}
+
+    if approval is not None:
+        try:
+            from qbraid_core import __version__ as core_version
+        except ImportError:  # pragma: no cover
+            core_version = "unknown"
+        handle_error(
+            error_type="UnsupportedOptionError",
+            message=(
+                f"--approval requires a newer qbraid-core (installed: {core_version}). "
+                "Upgrade with: pip install -U qbraid-core"
+            ),
+            include_traceback=False,
+        )
+    return {}
+
+
 @agents_app.command("launch")
 def agents_launch(
     tool: Optional[str] = typer.Option(
-        None, "--tool", "-t", help="Agent tool (claude, claude-auto, codeq, codex)"
+        None, "--tool", "-t", help="Agent tool (claude, codeq, codex; claude-auto = claude --approval auto)"
     ),
     cwd: Optional[str] = typer.Option(None, "--cwd", help="Working directory"),
     name: Optional[str] = typer.Option(None, "--name", "-n", help="Agent name"),
@@ -1116,10 +1167,21 @@ def agents_launch(
     compute: Optional[str] = typer.Option(
         None, "--compute", "-c", help="SSH alias for remote compute server"
     ),
+    approval: Optional[ApprovalMode] = typer.Option(
+        None,
+        "--approval",
+        help="ask: the agent confirms before acting. auto: it acts without asking.",
+    ),
 ):
     """Launch an AI coding agent.
 
     Starts the agent in a managed tmux session.
+
+    The agent runs detached, so nothing is watching its confirmation prompts.
+    Pass --approval auto for an agent you intend to leave running: it starts
+    the tool in its own non-interactive mode instead of parking on a prompt
+    until you come back. Approval mode is remembered, so `qbraid agents
+    resume` restores it.
     """
     try:
         from qbraid_core.services.agents import AgentLauncher, AgentLauncherError
@@ -1148,6 +1210,7 @@ def agents_launch(
                 instructions=instructions,
                 agent_type=agent_type,
                 tags=tag,
+                **_approval_kwargs(launcher.remote_launch, approval.value if approval else None),
             )
         else:
 
@@ -1164,6 +1227,7 @@ def agents_launch(
                 parent_session_id=parent,
                 team_id=team,
                 tags=tag,
+                **_approval_kwargs(launcher.launch, approval.value if approval else None),
                 progress_callback=_clone_progress if repo else None,
             )
 
@@ -1334,12 +1398,15 @@ def agents_resume(
                     if original:
                         tool_value = original.tool.value if original.tool else "claude"
                         fork_name = name or f"{tmux_win}-fork"
-                        # Launch fresh with same tool and cwd
+                        # Launch fresh with same tool and cwd.
                         session = launcher.launch(
                             tool=tool_value,
                             cwd=original.cwd,
                             name=fork_name,
                             instructions=None,
+                            # A fork of a detached agent must not quietly
+                            # become one that waits for a human.
+                            **_approval_kwargs(launcher.launch, getattr(original, "approval", None)),
                         )
                     else:
                         console.print("[red]Could not find original session to fork.[/red]")

{qbraid_cli-0.14.0 → qbraid_cli-0.15.0/qbraid_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qbraid-cli
-Version: 0.14.0
+Version: 0.15.0
 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