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

{cade_cli-0.16.0 → cade_cli-0.16.2}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.16.0
-Summary: Cade - The CLI Agent from Arcade.dev
+Version: 0.16.2
+Summary: Cade - The CLI Agent from Arcade.dev (install: curl -fsSL https://arcadeagent.dev/install | sh)
 Project-URL: Homepage, https://arcade.dev
-Project-URL: Documentation, https://docs.arcade.dev
+Project-URL: Documentation, https://arcadeagent.dev/docs
+Project-URL: Install, https://arcadeagent.dev/install
 Project-URL: Repository, https://github.com/arcadeai-labs/cade
 Project-URL: Issues, https://github.com/arcadeai-labs/cade/issues
 Project-URL: Changelog, https://github.com/arcadeai-labs/cade/releases
@@ -93,11 +94,15 @@ Description-Content-Type: text/markdown
 The CLI agent from [Arcade.dev](https://arcade.dev). Coding, research, and everyday automation — driven from a terminal, a single shell pipe, or a long-lived daemon that replies over Telegram.
 
 ```bash
-curl -fsSL https://arcadeagent.dev/install | sh   #  or:  uv tool install cade-cli  |  pip install cade-cli
-cade login
+curl -fsSL https://arcadeagent.dev/install | sh
 cade
 ```
 
+That is the **recommended install** — a prebuilt binary from
+[arcadeagent.dev](https://arcadeagent.dev/install). No GitHub token, no Python
+toolchain. First `cade` walks you through model setup, Arcade login, and the
+[Arcade Agent Hub](https://hub.arcade.dev). Re-run the same curl to upgrade.
+
 ---
 
 ## Highlights
@@ -113,19 +118,18 @@ cade
 
 ## Install
 
-| Source | Command |
-|---|---|
-| **Install script** (recommended) | `curl -fsSL https://arcadeagent.dev/install \| sh` |
-| uv | `uv tool install cade-cli` |
-| pip | `pip install cade-cli` |
-| From source | `git clone https://github.com/arcadeai-labs/cade.git && cd cade && uv sync` |
+### Recommended (macOS + Linux)
+
+```bash
+curl -fsSL https://arcadeagent.dev/install | sh
+```
 
-The install script detects your OS/arch, downloads the matching prebuilt binary
+The script detects your OS/arch, downloads the matching prebuilt binary
 (macOS arm64, Linux x64), verifies its checksum, and drops `cade` in
-`~/.local/bin` — no GitHub token required. Pin a version or install location:
+`~/.local/bin`. Pin a version or install location:
 
 ```bash
-CADE_VERSION=0.15.5 CADE_INSTALL_DIR=/usr/local/bin \
+CADE_VERSION=0.16.2 CADE_INSTALL_DIR=/usr/local/bin \
   sh -c "$(curl -fsSL https://arcadeagent.dev/install)"
 ```
 
@@ -133,9 +137,21 @@ On Linux the installer auto-picks a **cpu** or **gpu** build (GPU when
 `nvidia-smi` detects a card; the GPU build bundles the CUDA stack and is a much
 larger download). Force it with `CADE_VARIANT=cpu` or `CADE_VARIANT=gpu`.
 
-(Windows: grab the `.zip` from the releases page, or `pip install cade-cli`.)
+### Alternatives
+
+| Source | Command | When |
+|---|---|---|
+| uv | `uv tool install cade-cli` | Prefer a PyPI-managed tool venv |
+| pip | `pip install cade-cli` | Windows, or no curl install |
+| From source | `git clone … && uv sync` | Contributing / hacking on Cade |
+
+(Windows: grab the `.zip` from the [releases](https://github.com/arcadeai-labs/cade/releases) page, or `pip install cade-cli`.)
 
-**Prerequisites:** Python 3.11+, an Arcade account ([arcade.dev](https://arcade.dev)) for cloud tools, and an LLM provider key (`OPENAI_API_KEY` or `ANTHROPIC_API_KEY`). Skip the Arcade account with `--local-only` or `CADE_LOCAL_ONLY=1`.
+**Prerequisites to run Cade:** an LLM provider key (`OPENAI_API_KEY` or
+`ANTHROPIC_API_KEY`), and an Arcade account ([arcade.dev](https://arcade.dev))
+for cloud tools. Skip Arcade with `--local-only` or `CADE_LOCAL_ONLY=1`. The
+curl installer does **not** require a local Python — Python 3.11+ is only needed
+for the uv / pip / from-source paths.
 
 The first run walks you through picking a model provider and key (stored in your
 OS keyring); re-run it any time with `cade init`.

{cade_cli-0.16.0 → cade_cli-0.16.2}/README.md

@@ -3,11 +3,15 @@
 The CLI agent from [Arcade.dev](https://arcade.dev). Coding, research, and everyday automation — driven from a terminal, a single shell pipe, or a long-lived daemon that replies over Telegram.
 
 ```bash
-curl -fsSL https://arcadeagent.dev/install | sh   #  or:  uv tool install cade-cli  |  pip install cade-cli
-cade login
+curl -fsSL https://arcadeagent.dev/install | sh
 cade
 ```
 
+That is the **recommended install** — a prebuilt binary from
+[arcadeagent.dev](https://arcadeagent.dev/install). No GitHub token, no Python
+toolchain. First `cade` walks you through model setup, Arcade login, and the
+[Arcade Agent Hub](https://hub.arcade.dev). Re-run the same curl to upgrade.
+
 ---
 
 ## Highlights
@@ -23,19 +27,18 @@ cade
 
 ## Install
 
-| Source | Command |
-|---|---|
-| **Install script** (recommended) | `curl -fsSL https://arcadeagent.dev/install \| sh` |
-| uv | `uv tool install cade-cli` |
-| pip | `pip install cade-cli` |
-| From source | `git clone https://github.com/arcadeai-labs/cade.git && cd cade && uv sync` |
+### Recommended (macOS + Linux)
+
+```bash
+curl -fsSL https://arcadeagent.dev/install | sh
+```
 
-The install script detects your OS/arch, downloads the matching prebuilt binary
+The script detects your OS/arch, downloads the matching prebuilt binary
 (macOS arm64, Linux x64), verifies its checksum, and drops `cade` in
-`~/.local/bin` — no GitHub token required. Pin a version or install location:
+`~/.local/bin`. Pin a version or install location:
 
 ```bash
-CADE_VERSION=0.15.5 CADE_INSTALL_DIR=/usr/local/bin \
+CADE_VERSION=0.16.2 CADE_INSTALL_DIR=/usr/local/bin \
   sh -c "$(curl -fsSL https://arcadeagent.dev/install)"
 ```
 
@@ -43,9 +46,21 @@ On Linux the installer auto-picks a **cpu** or **gpu** build (GPU when
 `nvidia-smi` detects a card; the GPU build bundles the CUDA stack and is a much
 larger download). Force it with `CADE_VARIANT=cpu` or `CADE_VARIANT=gpu`.
 
-(Windows: grab the `.zip` from the releases page, or `pip install cade-cli`.)
+### Alternatives
+
+| Source | Command | When |
+|---|---|---|
+| uv | `uv tool install cade-cli` | Prefer a PyPI-managed tool venv |
+| pip | `pip install cade-cli` | Windows, or no curl install |
+| From source | `git clone … && uv sync` | Contributing / hacking on Cade |
+
+(Windows: grab the `.zip` from the [releases](https://github.com/arcadeai-labs/cade/releases) page, or `pip install cade-cli`.)
 
-**Prerequisites:** Python 3.11+, an Arcade account ([arcade.dev](https://arcade.dev)) for cloud tools, and an LLM provider key (`OPENAI_API_KEY` or `ANTHROPIC_API_KEY`). Skip the Arcade account with `--local-only` or `CADE_LOCAL_ONLY=1`.
+**Prerequisites to run Cade:** an LLM provider key (`OPENAI_API_KEY` or
+`ANTHROPIC_API_KEY`), and an Arcade account ([arcade.dev](https://arcade.dev))
+for cloud tools. Skip Arcade with `--local-only` or `CADE_LOCAL_ONLY=1`. The
+curl installer does **not** require a local Python — Python 3.11+ is only needed
+for the uv / pip / from-source paths.
 
 The first run walks you through picking a model provider and key (stored in your
 OS keyring); re-run it any time with `cade init`.

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

@@ -1,7 +1,7 @@
 [project]
 name = "cade-cli"
-version = "0.16.0"
-description = "Cade - The CLI Agent from Arcade.dev"
+version = "0.16.2"
+description = "Cade - The CLI Agent from Arcade.dev (install: curl -fsSL https://arcadeagent.dev/install | sh)"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {file = "LICENSE"}
@@ -47,7 +47,8 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://arcade.dev"
-Documentation = "https://docs.arcade.dev"
+Documentation = "https://arcadeagent.dev/docs"
+Install = "https://arcadeagent.dev/install"
 Repository = "https://github.com/arcadeai-labs/cade"
 Issues = "https://github.com/arcadeai-labs/cade/issues"
 Changelog = "https://github.com/arcadeai-labs/cade/releases"

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/cli/app.py

@@ -304,7 +304,7 @@ def _doctor_paths(runtime: Any) -> dict[str, Any]:
     rich_help_panel=PANEL_SETUP,
 )
 def init_cmd() -> None:
-    from cadecoder.cli.onboarding import can_prompt, run_onboarding
+    from cadecoder.cli.onboarding import can_prompt, finish_first_run_cloud, run_onboarding
 
     if not can_prompt():
         console.print(
@@ -312,7 +312,11 @@ def init_cmd() -> None:
             "Set OPENAI_API_KEY or ANTHROPIC_API_KEY instead."
         )
         raise typer.Exit(1)
-    run_onboarding(console, force=True)
+    result = run_onboarding(console, force=True)
+    if result:
+        runtime = build_runtime()
+        set_runtime(runtime)
+        finish_first_run_cloud(console, prefer_skip_login=result.chose_local)
 
 
 @app.command(
@@ -484,11 +488,16 @@ def main_callback(
     # provider + model before we build the runtime, so the first session uses
     # what they chose (not the hardcoded default). No-ops when already set up or
     # when not attached to an interactive terminal (piped/CI).
-    from cadecoder.cli.onboarding import needs_onboarding, run_onboarding
-
-    did_onboard = False
+    from cadecoder.cli.onboarding import (
+        finish_first_run_cloud,
+        needs_onboarding,
+        run_onboarding,
+    )
+    from cadecoder.cli.onboarding import OnboardingResult
+
+    onboard_result = OnboardingResult()
     if needs_onboarding():
-        did_onboard = run_onboarding(console)
+        onboard_result = run_onboarding(console)
 
     # Interaction + runtime-backed commands run as the current agent, auto-creating
     # a `default` agent on first run via build_runtime → ensure_current_agent.
@@ -496,13 +505,10 @@ def main_callback(
     set_runtime(runtime)
     ctx.obj["runtime"] = runtime
 
-    # Right after first-run setup (runtime now available), offer to connect
-    # Arcade Omni so external tools work out of the box. No-op otherwise.
-    if did_onboard:
+    # After runtime is up: Arcade login (if needed) + Arcade Agent Hub connect.
+    if onboard_result:
         try:
-            from cadecoder.cli.commands.mcp import offer_connect_omni
-
-            offer_connect_omni(console)
+            finish_first_run_cloud(console, prefer_skip_login=onboard_result.chose_local)
         except Exception:  # noqa: BLE001
             pass
 

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/cli/commands/auth.py

@@ -86,15 +86,15 @@ def login(
 
         log.info(f"User {whoami.email} logged in via OAuth.")
 
-        # Offer to connect Arcade Omni so the agent can use external tools
-        # (Gmail, Slack, web search, …) without a separate API key. No-op when
-        # non-interactive or already authorized.
+        # Offer to connect the Arcade Agent Hub so the agent can use external
+        # tools (Gmail, Slack, web search, …) without a separate API key.
+        # No-op when non-interactive or already authorized.
         try:
-            from cadecoder.cli.commands.mcp import offer_connect_omni
+            from cadecoder.cli.commands.mcp import offer_connect_hub
 
-            offer_connect_omni(console)
+            offer_connect_hub(console)
         except Exception as e:  # noqa: BLE001
-            log.debug(f"omni connect offer skipped: {e}")
+            log.debug(f"hub connect offer skipped: {e}")
 
     except OAuthLoginError as e:
         console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/cli/commands/mcp.py

@@ -372,22 +372,26 @@ def run_mcp_authorization(
     """Run the MCP OAuth authorization flow for a server. Returns success.
 
     If ``name`` isn't configured yet but is a built-in known server (e.g.
-    ``omni``), it's added in a disabled state first and only enabled once
+    ``hub``), it's added in a disabled state first and only enabled once
     authorization succeeds — so a cancelled/failed flow never leaves a broken
-    server that would error during chat.
+    server that would error during chat. The legacy name ``omni`` resolves to
+    the Arcade Agent Hub.
     """
     global _oauth_result
     _oauth_result = {"code": None, "error": None}
 
     store = MCPServerStore()
-    server = store.get(name)
+    # Resolve aliases (omni → hub) before looking up a stored config.
+    known = known_server_config(name)
+    lookup_name = known.name if known is not None else name
+    server = store.get(lookup_name) or store.get(name)
     if server is None:
-        server = known_server_config(name)
+        server = known
         if server is None:
             console.print(f"[red]Server '{name}' not found.[/red]")
             console.print(
                 "[dim]Add it with 'cade mcp add <name> <url>', "
-                "or authorize a known server like 'omni'.[/dim]"
+                "or authorize a known server like 'hub'.[/dim]"
             )
             return False
         store.add(server)  # persisted disabled; enabled on success
@@ -515,16 +519,17 @@ def run_mcp_authorization(
     return asyncio.run(run_oauth_flow())
 
 
-def offer_connect_omni(target_console: Console | None = None) -> None:
-    """Offer to connect Arcade Omni (external tools) if not already authorized.
+def offer_connect_hub(target_console: Console | None = None) -> None:
+    """Offer to connect the Arcade Agent Hub if not already authorized.
 
     Called after ``cade login`` and after first-run onboarding. No-op when the
-    terminal isn't interactive or when Omni is already authorized, so it never
-    blocks scripted/CI use.
+    terminal isn't interactive or when the Hub is already authorized, so it
+    never blocks scripted/CI use.
     """
     con = target_console or console
 
-    from cadecoder.cli.onboarding import can_prompt
+    from cadecoder.cli.onboarding import can_prompt, is_arcade_logged_in, offer_arcade_login
+    from cadecoder.tools.manager.config import HUB_SERVER_NAME
 
     if not can_prompt():
         return
@@ -534,30 +539,57 @@ def offer_connect_omni(target_console: Console | None = None) -> None:
     except Exception:  # noqa: BLE001
         return
 
-    existing = store.get("omni")
+    existing = store.get(HUB_SERVER_NAME) or store.get("omni")
     if existing is not None and existing.oauth_tokens is not None:
         return  # already connected
 
+    if not is_arcade_logged_in():
+        con.print()
+        con.print(
+            "[bold]Arcade login required[/bold] before connecting the "
+            "[cyan]Arcade Agent Hub[/cyan]."
+        )
+        if not offer_arcade_login(con, prefer_skip=False):
+            con.print(
+                "[dim]Skipped. Log in later with [bold]cade login[/bold], then "
+                "[bold]cade mcp authorize hub[/bold].[/dim]"
+            )
+            return
+
     from rich.prompt import Confirm
 
     con.print()
     con.print(
-        "[bold]Connect external tools?[/bold] Arcade [cyan]Omni[/cyan] lets Cade use "
-        "Gmail, Slack, GitHub, web search and more — authorized with your Arcade login "
-        "(no API key needed)."
+        "[bold]Connect external tools?[/bold] The [cyan]Arcade Agent Hub[/cyan] "
+        "([link=https://hub.arcade.dev]hub.arcade.dev[/link]) lets Cade use "
+        "Gmail, Slack, GitHub, web search and more — authorized with your Arcade "
+        "login (no API key needed)."
     )
     try:
-        proceed = Confirm.ask("Authorize Omni now? (opens your browser)", default=True, console=con)
+        proceed = Confirm.ask(
+            "Authorize Arcade Agent Hub now? (opens your browser)",
+            default=True,
+            console=con,
+        )
     except (KeyboardInterrupt, EOFError):
         con.print()
         return
 
     if not proceed:
-        con.print("[dim]Skipped. Connect anytime with [bold]cade mcp authorize omni[/bold].[/dim]")
+        con.print(
+            "[dim]Skipped. Connect anytime with [bold]cade mcp authorize hub[/bold].[/dim]"
+        )
         return
 
-    if not run_mcp_authorization("omni"):
-        con.print("[dim]You can retry later with [bold]cade mcp authorize omni[/bold].[/dim]")
+    if not run_mcp_authorization(HUB_SERVER_NAME):
+        con.print(
+            "[dim]You can retry later with [bold]cade mcp authorize hub[/bold].[/dim]"
+        )
+
+
+def offer_connect_omni(target_console: Console | None = None) -> None:
+    """Deprecated alias for :func:`offer_connect_hub`."""
+    offer_connect_hub(target_console)
 
 
 @mcp_app.command("authorize")
@@ -579,7 +611,7 @@ def authorize_server(
     """Authorize an MCP server over OAuth (browser flow).
 
     Works with any configured server, or a built-in known server by name
-    (e.g. ``cade mcp authorize omni`` to connect Arcade's external tools).
+    (e.g. ``cade mcp authorize hub`` to connect the Arcade Agent Hub).
     """
     if not run_mcp_authorization(name, client_id=client_id, scope=scope, skip_dcr=skip_dcr):
         raise typer.Exit(1)

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/cli/onboarding.py

@@ -3,14 +3,18 @@
 A brand-new install has no obvious way to pick a model provider, and the silent
 provider fallback used to log a GPT model even when only an Anthropic key was
 set. This wizard runs once on first launch (and on demand via ``cade init``):
-it asks which provider to use, captures/stores an API key in the OS keyring,
-records a recommended default model, and writes the global config + default
-agent so the very first session uses exactly what the user chose.
+
+1. Model provider + API key + default model
+2. Arcade Cloud login (browser OAuth) — skipped only if the user opts out
+3. Arcade Agent Hub connect (after the runtime is up)
+
+Step 3 is :func:`finish_first_run_cloud` and must run after ``build_runtime``.
 """
 
 from __future__ import annotations
 
 import os
+from dataclasses import dataclass
 
 from rich.console import Console
 from rich.panel import Panel
@@ -28,6 +32,17 @@ _PROVIDER_LOCAL = "local"
 _KEYRING_SERVICE = "cade/model"
 
 
+@dataclass(frozen=True)
+class OnboardingResult:
+    """Outcome of the model-setup half of first-run onboarding."""
+
+    configured: bool = False
+    chose_local: bool = False
+
+    def __bool__(self) -> bool:
+        return self.configured
+
+
 def _marker_path():
     """Path to the sentinel that records onboarding has completed."""
     return get_paths().state_dir / "onboarded"
@@ -168,28 +183,170 @@ class OnboardingAborted(Exception):
     """Raised when the user cancels onboarding (Ctrl-C / empty required input)."""
 
 
-def run_onboarding(console: Console, *, force: bool = False) -> bool:
-    """Run the interactive setup wizard.
+def is_arcade_logged_in() -> bool:
+    """Return True when Arcade Cloud credentials are present and usable."""
+    try:
+        from cadecoder.cli.auth import check_existing_login
+
+        return check_existing_login(suppress_message=True)
+    except Exception:  # noqa: BLE001
+        return False
+
+
+def offer_arcade_login(console: Console, *, prefer_skip: bool = False) -> bool:
+    """Offer Arcade Cloud OAuth during first-run / init.
+
+    Args:
+        console: Rich console for prompts.
+        prefer_skip: When True (local model path), default the confirm to No.
+
+    Returns:
+        True if the user is logged in when this returns (already was, or just did).
+    """
+    if not can_prompt():
+        return is_arcade_logged_in()
+
+    if is_arcade_logged_in():
+        console.print()
+        console.print("[green]✓[/green] Already logged in to Arcade Cloud.")
+        return True
+
+    console.print()
+    console.print(
+        Panel.fit(
+            "[bold]Step 2 of 3 — Arcade Cloud[/bold]\n\n"
+            "Log in so Cade can use Gmail, Slack, GitHub, calendars, and the\n"
+            "rest of the Arcade catalogue. Opens your browser (free account).\n\n"
+            "[dim]Skip only if you want local tools + your model — nothing else.[/dim]",
+            border_style="cyan",
+        )
+    )
+    try:
+        proceed = Confirm.ask(
+            "Log in to Arcade Cloud now?",
+            default=not prefer_skip,
+            console=console,
+        )
+    except (KeyboardInterrupt, EOFError):
+        console.print()
+        proceed = False
+
+    if not proceed:
+        console.print(
+            "[dim]Skipped. Chat still works with your model and local tools.\n"
+            "Run [bold]cade login[/bold] anytime for cloud apps "
+            "(or [bold]cade --local-only[/bold] to stay offline).[/dim]"
+        )
+        return False
+
+    return try_interactive_login(console)
+
+
+def try_interactive_login(console: Console) -> bool:
+    """Run browser OAuth login; return True on success. Never raises Exit."""
+    from arcade_core.constants import PROD_COORDINATOR_HOST
+    from rich.markup import escape
+
+    from cadecoder.cli.auth import (
+        OAuthLoginError,
+        build_coordinator_url,
+        perform_oauth_login,
+        save_credentials_from_whoami,
+    )
+
+    try:
+        coordinator_url = build_coordinator_url(PROD_COORDINATOR_HOST, None)
+
+        def on_status(msg: str) -> None:
+            console.print(f"[dim]{msg}[/dim]")
+
+        tokens, whoami, client_id = perform_oauth_login(coordinator_url, on_status=on_status)
+        save_credentials_from_whoami(tokens, whoami, coordinator_url, client_id)
+        console.print("\n[green]✓ Login successful![/green]")
+        console.print(f"  Email: {whoami.email}")
+        org = whoami.get_selected_org()
+        project = whoami.get_selected_project()
+        if org and project:
+            console.print(
+                f"  Active: {org.get('name', 'unknown')} / {project.get('name', 'unknown')}"
+            )
+        return True
+    except OAuthLoginError as e:
+        console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")
+        console.print(
+            "[dim]Continue without cloud tools for now — "
+            "retry with [bold]cade login[/bold].[/dim]"
+        )
+        return False
+    except (KeyboardInterrupt, EOFError):
+        console.print("\n[yellow]Login cancelled.[/yellow]")
+        return False
+    except Exception as e:  # noqa: BLE001
+        console.print(f"\n[red]✗ Login failed:[/red] {escape(str(e))}")
+        console.print("[dim]Retry anytime with [bold]cade login[/bold].[/dim]")
+        return False
+
+
+def finish_first_run_cloud(console: Console, *, prefer_skip_login: bool = False) -> None:
+    """After runtime is ready: Arcade login (if needed), then Agent Hub connect.
+
+    Call this only after ``build_runtime()`` / ``set_runtime()`` so the Hub
+    MCP store can resolve the current agent.
+    """
+    if not can_prompt():
+        return
+
+    logged_in = offer_arcade_login(console, prefer_skip=prefer_skip_login)
+    if not logged_in:
+        return
+
+    try:
+        from cadecoder.cli.commands.mcp import offer_connect_hub
+
+        console.print()
+        console.print("[bold]Step 3 of 3 — Arcade Agent Hub[/bold] ([cyan]hub.arcade.dev[/cyan])")
+        offer_connect_hub(console)
+    except Exception:  # noqa: BLE001
+        console.print(
+            "[dim]Skipped Arcade Agent Hub. Connect later with "
+            "[bold]cade mcp authorize hub[/bold].[/dim]"
+        )
+
+
+def run_onboarding(console: Console, *, force: bool = False) -> OnboardingResult:
+    """Run the interactive model-setup wizard (step 1 of first-run).
 
     Args:
         console: Rich console (stderr) to render prompts on.
         force: Re-run even if already onboarded (``cade init``).
 
     Returns:
-        True if a provider was configured; False if skipped/aborted.
+        :class:`OnboardingResult` (truthy when a provider was configured).
+        Call :func:`finish_first_run_cloud` after the runtime is built for
+        steps 2–3 (login + Arcade Agent Hub).
     """
     if not force and not needs_onboarding():
-        return False
+        return OnboardingResult()
 
     if not can_prompt():
         # Non-interactive (piped/CI). Don't block; the provider error path will
         # guide the user if nothing is configured.
-        return False
+        return OnboardingResult()
 
     console.print(
         Panel.fit(
-            "Welcome to [bold]Cade[/bold] — let's pick a model provider.\n"
-            "You can change this anytime with [bold]cade init[/bold].",
+            "Welcome to [bold]Cade[/bold] — three quick steps:\n"
+            "  [bold]1.[/bold] Pick a model provider\n"
+            "  [bold]2.[/bold] Log in to Arcade Cloud (cloud apps)\n"
+            "  [bold]3.[/bold] Connect the Arcade Agent Hub\n\n"
+            "You can re-run this anytime with [bold]cade init[/bold].",
+            border_style="cyan",
+        )
+    )
+    console.print()
+    console.print(
+        Panel.fit(
+            "[bold]Step 1 of 3 — Model provider[/bold]",
             border_style="cyan",
         )
     )
@@ -238,10 +395,10 @@ def run_onboarding(console: Console, *, force: bool = False) -> bool:
         model = Prompt.ask("Model", default=default_model, console=console).strip() or default_model
     except (KeyboardInterrupt, EOFError):
         console.print("\n[yellow]Setup cancelled.[/yellow]")
-        return False
+        return OnboardingResult()
     except OnboardingAborted as e:
         console.print(f"[yellow]Setup cancelled: {e}[/yellow]")
-        return False
+        return OnboardingResult()
 
     _persist(
         provider=provider,
@@ -257,15 +414,16 @@ def run_onboarding(console: Console, *, force: bool = False) -> bool:
     console.print()
     console.print(
         Panel.fit(
-            f"[bold]You're set up.[/bold]\n"
+            f"[bold]Step 1 done.[/bold]\n"
             f"Model:    [cyan]{model}[/cyan]\n"
             f"Provider: [cyan]{label}[/cyan]\n\n"
-            "Change it later with [bold]cade init[/bold] or edit "
+            "Next: Arcade login + Arcade Agent Hub (cloud apps).\n"
+            "Change the model later with [bold]cade init[/bold] or edit "
             f"[dim]{get_paths().global_config}[/dim].",
             border_style="green",
         )
     )
-    return True
+    return OnboardingResult(configured=True, chose_local=(choice == "3"))
 
 
 def _persist(

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/daemon/gateway/app.py

@@ -151,6 +151,12 @@ def build_gateway_app(
     Returns:
         A configured MCPApp with ``Cade_Ask`` registered.
     """
+    # Idempotent; required for curl/PyInstaller installs where tool source
+    # text is unavailable to arcade-core's return-value introspection.
+    from cadecoder.core.frozen import patch_frozen_return_detection
+
+    patch_frozen_return_detection()
+
     validator = CadeTokenValidator(token_store) if require_auth else None
     # Exposure enforcement runs as MCP middleware (forwarded to MCPServer via
     # server_kwargs): it hides/blocks tools the principal's groups exclude.

{cade_cli-0.16.0 → cade_cli-0.16.2}/src/cadecoder/daemon/server.py

@@ -92,6 +92,12 @@ async def run_daemon(
     seam: an async ``(app, host, port)`` callable used instead of the real
     uvicorn server so the wiring can be exercised without binding a socket.
     """
+    # Frozen/PyInstaller builds have no .py source for inspect.getsource();
+    # arcade-core needs this patch before any MCPApp.add_tool (Cade_Ask).
+    from cadecoder.core.frozen import patch_frozen_return_detection
+
+    patch_frozen_return_detection()
+
     host, port = _parse_bind(bind)
     _guard_auth_bind(host, require_auth)
     prewarm = prewarm or []