acra-cli 0.1.4__tar.gz → 0.1.5__tar.gz

{acra_cli-0.1.4/acra_cli.egg-info → acra_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acra-cli
-Version: 0.1.4
+Version: 0.1.5
 Summary: Agentic CLI for LLM task execution, research, and workflow automation.
 Author: Raj Tembe
 License: GNU Affero General Public License v3
@@ -79,6 +79,23 @@ It is built for developers who want a local CLI for asking an LLM-powered agent
 - ChromaDB-backed vector memory and JSON workflow memory modules
 - Optional extras for provider-specific dependencies and checkpoint backends
 
+## What's New in 0.1.5
+
+### New features
+
+- Provider credentials can now be stored with `acra keys` and used directly by Gemini, OpenAI, Groq, and HuggingFace Cloud workflows.
+- The configuration wizard stores provider and research credentials outside the plaintext profile file, using the OS keyring when available and a permission-restricted local fallback otherwise.
+- Long-running task and research commands show a live progress spinner.
+- Task and research results are rendered as readable summaries, findings, sources, and generated-file lists instead of raw workflow state.
+- Commands launched from the interactive shell now stream their output live.
+
+### Bug fixes
+
+- Fixed saved provider keys not being read by LLM initialization.
+- Fixed profile setup writing API and research keys to plaintext configuration.
+- Fixed interactive-shell commands buffering output until completion.
+- Fixed unwieldy raw dictionary and message-object output after task or research runs.
+
 ## Requirements
 
 - Python `>=3.11`
@@ -157,7 +174,7 @@ acra config show
 Store a key in your OS keyring:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 Run a research workflow:
@@ -304,13 +321,13 @@ The setup wizard prompts for:
 Set a key interactively:
 
 ```bash
-acra keys set provider
+acra keys set OPENAI_API_KEY
 ```
 
 Set a key directly:
 
 ```bash
-acra keys set provider "your-key"
+acra keys set OPENAI_API_KEY "your-key"
 ```
 
 List key status:
@@ -322,9 +339,11 @@ acra keys list
 Delete a key:
 
 ```bash
-acra keys delete provider
+acra keys delete OPENAI_API_KEY
 ```
 
+Supported provider key names are `GEMINI_API_KEY`, `OPENAI_API_KEY`, `GROQ_API_KEY`, and `HF_API_KEY`. Keys are stored in your OS keyring when it is available. On systems without a keyring backend, acra uses a local credentials file with owner-only permissions.
+
 Research key names:
 
 ```bash
@@ -336,7 +355,10 @@ acra keys set research.arxiv
 
 Environment fallback variables:
 
-- `ACRA_PROVIDER_KEY`
+- `GEMINI_API_KEY` or `GOOGLE_GEMINI_API_KEY`
+- `OPENAI_API_KEY`
+- `GROQ_API_KEY`
+- `HF_API_KEY`
 - `ACRA_RESEARCH_WEB_KEY`
 - `ACRA_RESEARCH_GITHUB_KEY`
 - `ACRA_RESEARCH_DOCS_KEY`
@@ -439,9 +461,9 @@ acra config show
 Keys:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 acra keys list
-acra keys delete provider
+acra keys delete GEMINI_API_KEY
 ```
 
 Memory:
@@ -548,6 +570,7 @@ export OMNIAGENT_DATA_DIR=/path/to/acra-data
 
 Important subdirectories:
 
+- `credentials.json`: permission-restricted credential fallback when no OS keyring is available
 - `projects/`: generated project files
 - `memory/storage/`: JSON memory files
 - `memory/chroma_db/`: ChromaDB vector memory
@@ -555,7 +578,7 @@ Important subdirectories:
 
 ## Current Beta Notes
 
-- The package version is `0.1.2`.
+- The package version is `0.1.5`.
 - The top-level CLI currently attaches `serve`, `config`, `keys`, `research`, `memory`, `session`, `graph`, and `workspace`.
 - The codebase contains additional command modules such as `brain`, `context`, `logs`, and `plugin`, but they are not currently attached to the top-level CLI.
 - Some CLI command groups return placeholder output while the Python modules behind them continue to evolve.
@@ -587,7 +610,7 @@ export HF_API_KEY="your-token"
 Or store it with:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 ### Ollama connection failure
@@ -616,7 +639,7 @@ export OLLAMA_BASE_URL=http://localhost:11434
 - PyPI package name: `acra-cli`
 - Console command: `acra`
 - Python import package: `acra`
-- Version: `0.1.2`
+- Version: `0.1.5`
 - Python: `>=3.11`
 - Console script: `acra=acra.cli:app_main`
 - Author: Raj Tembe

{acra_cli-0.1.4 → acra_cli-0.1.5}/README.md

@@ -23,6 +23,23 @@ It is built for developers who want a local CLI for asking an LLM-powered agent
 - ChromaDB-backed vector memory and JSON workflow memory modules
 - Optional extras for provider-specific dependencies and checkpoint backends
 
+## What's New in 0.1.5
+
+### New features
+
+- Provider credentials can now be stored with `acra keys` and used directly by Gemini, OpenAI, Groq, and HuggingFace Cloud workflows.
+- The configuration wizard stores provider and research credentials outside the plaintext profile file, using the OS keyring when available and a permission-restricted local fallback otherwise.
+- Long-running task and research commands show a live progress spinner.
+- Task and research results are rendered as readable summaries, findings, sources, and generated-file lists instead of raw workflow state.
+- Commands launched from the interactive shell now stream their output live.
+
+### Bug fixes
+
+- Fixed saved provider keys not being read by LLM initialization.
+- Fixed profile setup writing API and research keys to plaintext configuration.
+- Fixed interactive-shell commands buffering output until completion.
+- Fixed unwieldy raw dictionary and message-object output after task or research runs.
+
 ## Requirements
 
 - Python `>=3.11`
@@ -101,7 +118,7 @@ acra config show
 Store a key in your OS keyring:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 Run a research workflow:
@@ -248,13 +265,13 @@ The setup wizard prompts for:
 Set a key interactively:
 
 ```bash
-acra keys set provider
+acra keys set OPENAI_API_KEY
 ```
 
 Set a key directly:
 
 ```bash
-acra keys set provider "your-key"
+acra keys set OPENAI_API_KEY "your-key"
 ```
 
 List key status:
@@ -266,9 +283,11 @@ acra keys list
 Delete a key:
 
 ```bash
-acra keys delete provider
+acra keys delete OPENAI_API_KEY
 ```
 
+Supported provider key names are `GEMINI_API_KEY`, `OPENAI_API_KEY`, `GROQ_API_KEY`, and `HF_API_KEY`. Keys are stored in your OS keyring when it is available. On systems without a keyring backend, acra uses a local credentials file with owner-only permissions.
+
 Research key names:
 
 ```bash
@@ -280,7 +299,10 @@ acra keys set research.arxiv
 
 Environment fallback variables:
 
-- `ACRA_PROVIDER_KEY`
+- `GEMINI_API_KEY` or `GOOGLE_GEMINI_API_KEY`
+- `OPENAI_API_KEY`
+- `GROQ_API_KEY`
+- `HF_API_KEY`
 - `ACRA_RESEARCH_WEB_KEY`
 - `ACRA_RESEARCH_GITHUB_KEY`
 - `ACRA_RESEARCH_DOCS_KEY`
@@ -383,9 +405,9 @@ acra config show
 Keys:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 acra keys list
-acra keys delete provider
+acra keys delete GEMINI_API_KEY
 ```
 
 Memory:
@@ -492,6 +514,7 @@ export OMNIAGENT_DATA_DIR=/path/to/acra-data
 
 Important subdirectories:
 
+- `credentials.json`: permission-restricted credential fallback when no OS keyring is available
 - `projects/`: generated project files
 - `memory/storage/`: JSON memory files
 - `memory/chroma_db/`: ChromaDB vector memory
@@ -499,7 +522,7 @@ Important subdirectories:
 
 ## Current Beta Notes
 
-- The package version is `0.1.2`.
+- The package version is `0.1.5`.
 - The top-level CLI currently attaches `serve`, `config`, `keys`, `research`, `memory`, `session`, `graph`, and `workspace`.
 - The codebase contains additional command modules such as `brain`, `context`, `logs`, and `plugin`, but they are not currently attached to the top-level CLI.
 - Some CLI command groups return placeholder output while the Python modules behind them continue to evolve.
@@ -531,7 +554,7 @@ export HF_API_KEY="your-token"
 Or store it with:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 ### Ollama connection failure
@@ -560,7 +583,7 @@ export OLLAMA_BASE_URL=http://localhost:11434
 - PyPI package name: `acra-cli`
 - Console command: `acra`
 - Python import package: `acra`
-- Version: `0.1.2`
+- Version: `0.1.5`
 - Python: `>=3.11`
 - Console script: `acra=acra.cli:app_main`
 - Author: Raj Tembe

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/__init__.py

@@ -1,6 +1,6 @@
 """acra package root."""
 
-__version__ = "0.1.4"
+__version__ = "0.1.5"
 
 from .cli import main
 

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/agents/llm.py

@@ -73,10 +73,17 @@ class LLMInitializationError(Exception):
 
 def _init_gemini():
     """Initialize Google Gemini LLM."""
-    gemini_api_key = os.getenv("GOOGLE_GEMINI_API_KEY") or os.getenv("GEMINI_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    gemini_api_key = (
+        os.getenv("GOOGLE_GEMINI_API_KEY")
+        or os.getenv("GEMINI_API_KEY")
+        or get_key("GEMINI_API_KEY")
+    )
     if not gemini_api_key or gemini_api_key.startswith("your_"):
         raise EnvironmentError(
-            "GEMINI_API_KEY is not set. Add GOOGLE_GEMINI_API_KEY to your .env file."
+            "GEMINI_API_KEY is not set. Run 'acra keys set GEMINI_API_KEY' "
+            "or add GOOGLE_GEMINI_API_KEY to your .env file."
         )
     os.environ["GOOGLE_API_KEY"] = gemini_api_key
     return ChatGoogleGenerativeAI(
@@ -91,10 +98,13 @@ def _init_openai():
         raise LLMInitializationError(
             "OpenAI support is not installed. Install with: pip install langchain-openai"
         )
-    openai_api_key = os.getenv("OPENAI_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    openai_api_key = os.getenv("OPENAI_API_KEY") or get_key("OPENAI_API_KEY")
     if not openai_api_key or openai_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "OPENAI_API_KEY is not set. Add OPENAI_API_KEY to your .env file."
+            "OPENAI_API_KEY is not set. Run 'acra keys set OPENAI_API_KEY' "
+            "or add OPENAI_API_KEY to your .env file."
         )
     return ChatOpenAI(
         model=OPENAI_MODEL,
@@ -109,10 +119,13 @@ def _init_groq():
         raise LLMInitializationError(
             "Groq support is not installed. Install with: pip install langchain-groq"
         )
-    groq_api_key = os.getenv("GROQ_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    groq_api_key = os.getenv("GROQ_API_KEY") or get_key("GROQ_API_KEY")
     if not groq_api_key or groq_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "GROQ_API_KEY is not set. Add GROQ_API_KEY to your .env file."
+            "GROQ_API_KEY is not set. Run 'acra keys set GROQ_API_KEY' "
+            "or add GROQ_API_KEY to your .env file."
         )
     return ChatGroq(
         model=GROQ_MODEL,
@@ -150,10 +163,13 @@ def _init_huggingface_cloud():
             "HuggingFace not installed. Install with: pip install langchain-huggingface"
         )
 
-    huggingface_api_key = os.getenv("HF_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    huggingface_api_key = os.getenv("HF_API_KEY") or get_key("HF_API_KEY")
     if not huggingface_api_key or huggingface_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "HF_API_KEY is not set. Add HF_API_KEY to your .env file. "
+            "HF_API_KEY is not set. Run 'acra keys set HF_API_KEY' or add "
+            "HF_API_KEY to your .env file. "
             "Get a token at: https://huggingface.co/settings/tokens"
         )
 

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/commands/ask.py

@@ -7,6 +7,8 @@ import typer
 
 from acra.graph.workflow import OmniAgentCallbacks, omniagent_graph
 from acra.ui.components import render_panel
+from acra.ui.spinner import run_with_spinner
+from acra.utils.output_formatter import format_task_result
 
 app = typer.Typer(help="Agent task commands for acra.")
 
@@ -35,8 +37,13 @@ def _run_task(
         "callbacks": [OmniAgentCallbacks()],
         "configurable": {"thread_id": thread_id},
     }
-    result = omniagent_graph.invoke(state, config=config)
-    render_panel(result, title=task_label)
+    result = run_with_spinner(
+        omniagent_graph.invoke,
+        state,
+        config=config,
+        message=f"Running {task_label}",
+    )
+    render_panel(format_task_result(result), title=task_label)
     return result
 
 

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/commands/keys.py

@@ -16,7 +16,11 @@ app = typer.Typer(help="Key management commands for acra.")
 
 @app.command("set")
 def set_key_cmd(
-    name: str = typer.Argument(..., help="Key name, e.g. provider or research.github"),
+    name: str = typer.Argument(
+        ...,
+        help="Key name: GEMINI_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, HF_API_KEY, "
+        "or research.<source> (web, github, docs, arxiv).",
+    ),
     value: Optional[str] = typer.Argument(None, help="API key value. If omitted, you will be prompted."),
 ):
     """Set a provider or research API key."""
@@ -37,4 +41,4 @@ def list_key_cmd():
 def delete_key_cmd(name: str = typer.Argument(..., help="Key name to delete.")):
     """Delete a configured API key."""
     delete_key(name)
-    render_panel(f"Deleted key: {name}")
+    render_panel(f"Deleted key: {name}")

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/commands/research.py

@@ -10,6 +10,7 @@ from acra.config.profile_manager import ProfileManager
 from acra.utils.output_formatter import format_research_report
 from acra.utils.keyring_manager import get_research_key_status
 from acra.ui.components import render_panel
+from acra.ui.spinner import run_with_spinner
 
 app = typer.Typer(help="Research commands for acra.")
 
@@ -55,12 +56,14 @@ def research(
     }
 
     thread_id = str(uuid.uuid4())
-    result = workflow.invoke(
+    result = run_with_spinner(
+        workflow.invoke,
         state,
         config={
             "callbacks": [OmniAgentCallbacks()],
             "configurable": {"thread_id": thread_id},
         },
+        message="Researching",
     )
 
     report = format_research_report(result, output_format=format)

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/config/profile_manager.py

@@ -10,6 +10,16 @@ CONFIG_DIR = Path.home() / ".acra"
 CONFIG_FILE = CONFIG_DIR / "config.json"
 DEFAULT_PROFILE_NAME = "default"
 
+# Maps provider names to the credential name acra/agents/llm.py actually
+# reads via keyring_manager.get_key(). Ollama is local and needs no key.
+_PROVIDER_KEY_NAMES = {
+    "gemini": "GEMINI_API_KEY",
+    "openai": "OPENAI_API_KEY",
+    "groq": "GROQ_API_KEY",
+    "huggingface_cloud": "HF_API_KEY",
+    "huggingface_local": "HF_API_KEY",
+}
+
 
 def _ensure_config_dir() -> None:
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
@@ -69,19 +79,31 @@ class ProfileManager:
         api_key = getpass("Provider API key (hidden): ")
         theme = input("Theme (dark-orange/dark-blue/dark-green): ").strip() or "dark-orange"
         workspace = input("Workspace path (default=current directory): ").strip() or os.getcwd()
-        research_keys = {}
         print("Configure research keys. Press enter to skip a source.")
+        research_key_values = {}
         for source in ["web", "github", "docs", "arxiv"]:
             prompt = f"Research {source} API key (if required): "
             value = getpass(prompt) if source != "arxiv" else input(prompt).strip()
-            research_keys[source] = value or None
+            if value:
+                research_key_values[source] = value
+
+        # Secrets are stored via the OS keyring (falling back to a
+        # permission-locked local file when no OS backend is available),
+        # never written into the plaintext profile JSON. See
+        # acra/utils/keyring_manager.py.
+        from acra.utils.keyring_manager import set_key
+
+        provider_key_name = _PROVIDER_KEY_NAMES.get(provider)
+        if api_key and provider_key_name:
+            set_key(provider_key_name, api_key)
+        for source, value in research_key_values.items():
+            set_key(f"research.{source}", value)
 
         profile = {
             "provider": provider,
             "model": model,
             "theme": theme,
             "workspace": workspace,
-            "research_keys": research_keys,
         }
         self.save_profile(profile_name, profile)
-        return profile_name
+        return profile_name

acra_cli-0.1.5/acra/ui/components.py

@@ -0,0 +1,78 @@
+"""Shared UI render components for acra."""
+
+from rich.console import Console, Group
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from typing import Any
+
+console = Console()
+
+_MAX_FIELD_LENGTH = 2000
+
+
+def _stringify(value: Any) -> str:
+    if isinstance(value, list) and value and all(isinstance(v, str) for v in value):
+        return "\n".join(f"\u2022 {v}" for v in value)
+    if isinstance(value, (list, tuple)):
+        return ", ".join(str(v) for v in value)
+    if isinstance(value, dict):
+        return "\n".join(f"{k}: {v}" for k, v in value.items())
+    return str(value)
+
+
+def _render_dict(data: dict) -> Group:
+    """Render a dict as a lead answer (if present) plus a clean field table,
+    instead of a raw Python repr. Built for the summaries produced by
+    acra.utils.output_formatter, but degrades gracefully for any dict."""
+    renderables = []
+
+    answer = data.get("answer")
+    if answer:
+        renderables.append(Text(str(answer)))
+        renderables.append(Text(""))
+
+    table = Table(show_header=False, box=None, padding=(0, 1, 0, 0))
+    table.add_column("Field", style="bold cyan", no_wrap=True)
+    table.add_column("Value")
+    for key, value in data.items():
+        if key == "answer" or value in (None, "", [], {}):
+            continue
+        value_str = _stringify(value)
+        if len(value_str) > _MAX_FIELD_LENGTH:
+            value_str = value_str[:_MAX_FIELD_LENGTH] + "\u2026 (truncated)"
+        table.add_row(key.replace("_", " ").title(), value_str)
+
+    if table.rows:
+        renderables.append(table)
+
+    if not renderables:
+        renderables.append(Text("(empty)"))
+
+    return Group(*renderables)
+
+
+def render_panel(content: Any, title: str = "acra") -> None:
+    if isinstance(content, list):
+        table = Table(show_header=True, header_style="bold magenta")
+        table.add_column("Name")
+        table.add_column("Status")
+        table.add_column("Value")
+        for item in content:
+            if isinstance(item, dict):
+                table.add_row(
+                    str(item.get("name", "")),
+                    str(item.get("status", "")),
+                    str(item.get("value", "")),
+                )
+            else:
+                table.add_row(str(item), "", "")
+        console.print(Panel(table, title=title))
+    elif isinstance(content, dict):
+        console.print(Panel(_render_dict(content), title=title))
+    else:
+        console.print(Panel(str(content), title=title))
+
+
+def render_message(message: str) -> None:
+    console.print(message)

{acra_cli-0.1.4 → acra_cli-0.1.5}/acra/ui/shell.py

@@ -70,21 +70,17 @@ def launch_shell(profile: str = None, workspace: str = None, party: bool = False
             console.print(f"[dim]→[/dim] {user_input}")
 
             cmd = [sys.executable, "-m", "acra"] + shlex.split(command_text)
+            # stdout/stderr are inherited (not captured) so the child process
+            # sees a real tty and any live output -- the run_with_spinner
+            # progress indicator, the animated banner, streamed agent output
+            # -- renders in real time instead of being buffered up and
+            # dumped all at once after the command finishes.
             completed = subprocess.run(
                 cmd,
                 cwd=os.getcwd(),
-                stdin=sys.stdin,
-                stdout=subprocess.PIPE,
-                stderr=subprocess.STDOUT,
-                text=True,
             )
-            if completed.stdout:
-                console.print(completed.stdout, soft_wrap=True)
             if completed.returncode != 0:
-                if completed.stdout and "Missing command" in completed.stdout:
-                    console.print("[dim]Tip:[/dim] try a subcommand such as 'brain models' or 'config init'.")
-                else:
-                    console.print(f"[bold red]Command failed with exit code {completed.returncode}.[/bold red]")
+                console.print(f"[bold red]Command failed with exit code {completed.returncode}.[/bold red]")
         except KeyboardInterrupt:
             break
         except EOFError:

acra_cli-0.1.5/acra/ui/spinner.py

@@ -0,0 +1,97 @@
+"""Live 'running' spinner for long agent tasks.
+
+`acra ask/build/fix/review/explain/run` can take anywhere from a few
+seconds to a couple of minutes (planner -> researcher -> coder -> executor
+-> critic, each an LLM call), and until now the terminal went completely
+silent between hitting enter and the result panel appearing. This wraps a
+blocking call with the same braille spinner used in the animated startup
+banner (acra/ui/animated_banner.py), showing live progress and elapsed
+time instead.
+
+Kept as a small, self-contained module (rather than importing the
+startup-banner internals) so a bug here can't affect the startup banner
+and vice versa; the animation/color gating logic is intentionally
+duplicated in miniature from animated_banner.py, honoring the same
+conventions (NO_COLOR, FORCE_COLOR, TERM=dumb, CI, ACRA_NO_ANIMATION).
+"""
+
+import os
+import sys
+import threading
+import time
+from typing import Any, Callable
+
+RESET = "\033[0m"
+DIM = "\033[2m"
+CYAN = "\033[36m"
+GREEN = "\033[92m"
+
+_SPINNER_FRAMES = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+
+
+def _animations_enabled() -> bool:
+    if os.environ.get("ACRA_NO_ANIMATION"):
+        return False
+    if os.environ.get("CI"):
+        return False
+    return sys.stdout.isatty()
+
+
+def _supports_color() -> bool:
+    if os.environ.get("FORCE_COLOR", "") != "":
+        return True
+    if os.environ.get("NO_COLOR", "") != "":
+        return False
+    if os.environ.get("TERM") == "dumb":
+        return False
+    return True
+
+
+def run_with_spinner(fn: Callable[..., Any], *args, message: str = "Working", **kwargs) -> Any:
+    """Run fn(*args, **kwargs) on a background thread, showing a live spinner
+    with elapsed time until it finishes. Returns fn's return value, or
+    re-raises whatever exception fn raised.
+
+    Falls back to a single static line and a plain blocking call when
+    stdout isn't a real interactive terminal (piped, CI, ACRA_NO_ANIMATION),
+    so scripted/piped invocations pay no animation cost and never see
+    raw escape codes leaking into logs.
+    """
+    if not _animations_enabled():
+        print(f"{message}...")
+        return fn(*args, **kwargs)
+
+    outcome: dict = {}
+
+    def _target():
+        try:
+            outcome["value"] = fn(*args, **kwargs)
+        except BaseException as exc:  # re-raised on the main thread below
+            outcome["error"] = exc
+
+    thread = threading.Thread(target=_target, daemon=True)
+    thread.start()
+
+    color = CYAN if _supports_color() else ""
+    reset = RESET if _supports_color() else ""
+    dim = DIM if _supports_color() else ""
+    green = GREEN if _supports_color() else ""
+
+    start = time.time()
+    frame_idx = 0
+    while thread.is_alive():
+        frame = _SPINNER_FRAMES[frame_idx % len(_SPINNER_FRAMES)]
+        elapsed = time.time() - start
+        sys.stdout.write(f"\r{color}{frame}{reset} {dim}{message}\u2026 {elapsed:0.1f}s{reset}\033[K")
+        sys.stdout.flush()
+        time.sleep(0.08)
+        frame_idx += 1
+    thread.join()
+
+    elapsed = time.time() - start
+    sys.stdout.write(f"\r{green}\u2713{reset} {message} ({elapsed:.1f}s){' ' * 12}\n")
+    sys.stdout.flush()
+
+    if "error" in outcome:
+        raise outcome["error"]
+    return outcome.get("value")