cade-cli 0.11.0__tar.gz → 0.13.2__tar.gz

{cade_cli-0.11.0 → cade_cli-0.13.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.11.0
+Version: 0.13.2
 Summary: Cade - The CLI Agent from Arcade.dev
 Project-URL: Homepage, https://arcade.dev
 Project-URL: Documentation, https://docs.arcade.dev
@@ -43,10 +43,10 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
-Requires-Dist: agent-library<1.0.0,>=0.12.0
+Requires-Dist: agent-library<1.0.0,>=0.13.1
 Requires-Dist: anthropic<1.0.0,>=0.34.0
 Requires-Dist: arcade-core<5.0.0,>=4.7.0
-Requires-Dist: arcade-mcp-server<2.0.0,>=1.21.0
+Requires-Dist: arcade-mcp-server<2.0.0,>=1.22.0
 Requires-Dist: arcade-tdk<4.0.0,>=3.8.0
 Requires-Dist: arcadepy<2.0.0,>=1.10.0
 Requires-Dist: authlib<2.0.0,>=1.6.0
@@ -58,15 +58,14 @@ Requires-Dist: keyring<26.0,>=24.0
 Requires-Dist: openai<2.0.0,>=1.0.0
 Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
 Requires-Dist: pydantic[email]<3.0.0,>=2.0.0
-Requires-Dist: pyperclip<2.0.0,>=1.8.0
 Requires-Dist: python-telegram-bot<22.0,>=21.0
-Requires-Dist: pyyaml<7.0.0,>=6.0
 Requires-Dist: rich<14.0.0,>=13.0.0
-Requires-Dist: sounddevice>=0.5.5
-Requires-Dist: tiktoken<1.0.0,>=0.11.0
 Requires-Dist: toml<1.0.0,>=0.10.0
 Requires-Dist: typer>0.10.0
 Requires-Dist: ulid==1.1
+Requires-Dist: websockets<16.0,>=14.0
+Provides-Extra: build
+Requires-Dist: pyinstaller<7.0.0,>=6.16.0; extra == 'build'
 Provides-Extra: dev
 Requires-Dist: mypy<2.0.0,>=1.10.0; extra == 'dev'
 Requires-Dist: pytest-asyncio<1.0.0,>=0.24.0; extra == 'dev'
@@ -83,7 +82,7 @@ Provides-Extra: voice
 Requires-Dist: mlx-audio<0.4.0,>=0.2.0; extra == 'voice'
 Requires-Dist: mlx-whisper>=0.1.0; extra == 'voice'
 Requires-Dist: numpy>=1.24.0; extra == 'voice'
-Requires-Dist: sounddevice>=0.4.0; extra == 'voice'
+Requires-Dist: sounddevice<1.0.0,>=0.5.5; extra == 'voice'
 Requires-Dist: webrtcvad>=2.0.10; extra == 'voice'
 Description-Content-Type: text/markdown
 
@@ -119,6 +118,8 @@ cade
 | pip | `pip install cade-cli` |
 | From source | `git clone https://github.com/arcadeai-labs/cade.git && cd cade && uv sync` |
 
+Homebrew installs from a private release feed. Export `HOMEBREW_GITHUB_API_TOKEN` (a token with read access to `arcadeai-labs/cade`) before running `brew install`.
+
 **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`.
 
 ```bash
@@ -126,6 +127,9 @@ cade login          # Arcade Cloud OAuth (skip with --local-only)
 cade --version
 ```
 
+Full install and first-run docs: [`docs/install.md`](./docs/install.md) and
+[`docs/quickstart.md`](./docs/quickstart.md).
+
 ---
 
 ## Quick start
@@ -133,11 +137,11 @@ cade --version
 ```bash
 cade                                       # interactive chat
 cade -m "What changed in HEAD?"            # single message, then exit
-cat error.log | cade -m "What went wrong?" # pipe input
+cade -m "What went wrong?" < error.log     # prompt + file/stdin
 cade -r                                    # resume the most recent thread
 cade resume "auth-rewrite"                 # resume a thread by name
 cade --persona reviewer                    # use a saved persona's system prompt
-cade --voice                               # speak / hear (voice mode)
+cade --voice                               # speak / hear (requires cade-cli[voice])
 ```
 
 ### Top-level options
@@ -145,9 +149,9 @@ cade --voice                               # speak / hear (voice mode)
 | Flag | Description |
 |---|---|
 | `-r`, `--resume` | Resume most recent thread |
-| `-m`, `--message` | Single-message mode (reads stdin if no arg) |
+| `-m`, `--message` | Single-message mode; piped stdin is appended to the prompt |
 | `-P`, `--persona` | Use a saved persona |
-| `-V`, `--voice` | Voice mode |
+| `-V`, `--voice` | Voice mode; install `cade-cli[voice]` first |
 | `-v`, `--verbose` | Debug logging |
 | `--version` | Print version |
 
@@ -172,7 +176,7 @@ cade --voice                               # speak / hear (voice mode)
 
 Tools come from three sources and are addressed uniformly by their registered name:
 
-- **`Local_*`** — built-in: filesystem (`ReadFile`, `WriteFile`, `Edit`, `ListFiles`), shell (`Bash` — async with progress reporting), `Search`, `Git`, `Task*`, `Channel`, `AskUserQuestion`, `RetrieveToolResult`, `ToolSchema`, `Sleep`, `PinContext`, `PushNotification`.
+- **`Local_*`** — built-in: filesystem (`ReadFile`, `WriteFile`, `Edit`, `ListFiles`), shell (`Bash`), `Search`, `Git`, `Task*`, `AskUserQuestion`, `RetrieveToolResult`, `ToolSchema`, `PinContext`, `PushNotification`, `WebFetch`, and `WebSearch`.
 - **`Memory_*`** — agent-library backed, per-persona indexed knowledge store.
 - **Arcade Cloud + user MCP servers** — anything you register.
 
@@ -215,7 +219,7 @@ Memory is persona-scoped — each persona has its own `~/.cade/data/contexts/<co
 
 ## Headless daemon: `cade serve`
 
-Run Cade as a long-lived daemon that replies over messaging platforms (Telegram supported today; the adapter protocol is generic). Each chat gets its own persistent thread — persona, memory, and tools carry across messages.
+Run Cade as a long-lived daemon that replies through adapters. Telegram is supported for personal bot workflows, and Desktop exposes a local WebSocket for native clients. Each conversation gets its own persistent thread — persona, memory, and tools carry across messages.
 
 ```bash
 cade serve init                          # wizard: bot token, allowed senders
@@ -226,9 +230,9 @@ cade serve status / stop                 # health, uptime; SIGTERM running daemo
 
 Config lives at `~/.cade/config/contexts/<context>.toml [serve]`. Edit and `kill -HUP $(cat ~/.cade/run/serve.pid)` to reload without restart.
 
-**Security defaults are fail-closed:** `allowed_senders = []` blocks everyone; tools are default-deny against `[tools].allow` (globs / regex / pipe lists supported); `deny` always wins.
+**Security defaults are fail-closed:** `allowed_senders = []` blocks everyone; tools are default-deny against `[serve.tools].allow` (globs / regex / pipe lists supported); `deny` always wins.
 
-The MCP transport is fully bidirectional, so tools running inside the daemon can elicit structured input (rendered as Telegram inline keyboards), stream live progress (rendered as edited placeholder messages), and emit logs that flow into the daemon log. See [`docs/mcp.md`](./docs/mcp.md) for the protocol details, [`docs/configuration.md`](./docs/configuration.md) for the full daemon config reference.
+The MCP transport is fully bidirectional, so tools running inside the daemon can elicit structured input, stream live progress, and emit logs through whichever adapter is active. See [`docs/adapters/`](./docs/adapters/) for adapter details, [`docs/mcp.md`](./docs/mcp.md) for protocol details, and [`docs/configuration.md`](./docs/configuration.md) for the full daemon config reference.
 
 ---
 
@@ -252,17 +256,18 @@ See [`docs/channels.md`](./docs/channels.md) for the channels protocol; hooks an
 Cade works with any OpenAI-compatible endpoint. Three ways to wire one in (CLI flag → env → config, first match wins):
 
 ```bash
-# CLI flag
-cade chat --endpoint http://localhost:11434/v1 --model llama3
+# CLI flag for Ollama. Use a model from `ollama list`.
+cade chat -L --endpoint http://localhost:11434 --model qwen3:4b
 
-# Environment
-export OPENAI_BASE_URL="http://localhost:11434/v1"
-export OPENAI_API_KEY="ollama"   # any non-empty value
-cade chat --model llama3
+# Environment for one-shot mode
+cade context create local-qwen --model qwen3:4b
+cade context use local-qwen
+export OLLAMA_BASE_URL="http://localhost:11434"
+CADE_LOCAL_ONLY=1 cade -m "hello from a local model"
 
 # Config — ~/.cade/config/cade.toml
 [model_settings]
-host = "http://localhost:11434/v1"
+host = "http://localhost:8000/v1"
 api_key = "ollama"
 ```
 
@@ -303,14 +308,15 @@ Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/confi
 ```bash
 git clone https://github.com/arcadeai-labs/cade.git
 cd cade
-uv sync --all-extras --dev
-pytest                # full suite
-ruff check src/ tests/ && ruff format src/ tests/
+uv sync --extra dev
+uv run pytest
+uv run ruff check src/ tests/
 ```
 
 Style: Python 3.11+ with modern type hints (`dict`, `list`, `| None`); ruff for lint + format; pytest with `asyncio_mode = "auto"`. Public functions and classes get docstrings.
 
-PRs welcome — open an issue first for anything substantial.
+Build/release docs live in [`docs/development.md`](./docs/development.md). PRs
+welcome — open an issue first for anything substantial.
 
 ---
 
@@ -318,7 +324,7 @@ PRs welcome — open an issue first for anything substantial.
 
 - [arcade.dev](https://arcade.dev) — product
 - [docs.arcade.dev](https://docs.arcade.dev) — API and tool catalog
-- [`docs/`](./docs/) — `mcp.md` (tool protocol), `configuration.md`, `channels.md`, `install.md`
+- [`docs/`](./docs/) — quickstart, examples, install, config, MCP, channels, voice, development, and adapters
 - [Issues](https://github.com/arcadeai-labs/cade/issues) · [Releases](https://github.com/arcadeai-labs/cade/releases)
 
 ## License

{cade_cli-0.11.0 → cade_cli-0.13.2}/README.md

@@ -30,6 +30,8 @@ cade
 | pip | `pip install cade-cli` |
 | From source | `git clone https://github.com/arcadeai-labs/cade.git && cd cade && uv sync` |
 
+Homebrew installs from a private release feed. Export `HOMEBREW_GITHUB_API_TOKEN` (a token with read access to `arcadeai-labs/cade`) before running `brew install`.
+
 **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`.
 
 ```bash
@@ -37,6 +39,9 @@ cade login          # Arcade Cloud OAuth (skip with --local-only)
 cade --version
 ```
 
+Full install and first-run docs: [`docs/install.md`](./docs/install.md) and
+[`docs/quickstart.md`](./docs/quickstart.md).
+
 ---
 
 ## Quick start
@@ -44,11 +49,11 @@ cade --version
 ```bash
 cade                                       # interactive chat
 cade -m "What changed in HEAD?"            # single message, then exit
-cat error.log | cade -m "What went wrong?" # pipe input
+cade -m "What went wrong?" < error.log     # prompt + file/stdin
 cade -r                                    # resume the most recent thread
 cade resume "auth-rewrite"                 # resume a thread by name
 cade --persona reviewer                    # use a saved persona's system prompt
-cade --voice                               # speak / hear (voice mode)
+cade --voice                               # speak / hear (requires cade-cli[voice])
 ```
 
 ### Top-level options
@@ -56,9 +61,9 @@ cade --voice                               # speak / hear (voice mode)
 | Flag | Description |
 |---|---|
 | `-r`, `--resume` | Resume most recent thread |
-| `-m`, `--message` | Single-message mode (reads stdin if no arg) |
+| `-m`, `--message` | Single-message mode; piped stdin is appended to the prompt |
 | `-P`, `--persona` | Use a saved persona |
-| `-V`, `--voice` | Voice mode |
+| `-V`, `--voice` | Voice mode; install `cade-cli[voice]` first |
 | `-v`, `--verbose` | Debug logging |
 | `--version` | Print version |
 
@@ -83,7 +88,7 @@ cade --voice                               # speak / hear (voice mode)
 
 Tools come from three sources and are addressed uniformly by their registered name:
 
-- **`Local_*`** — built-in: filesystem (`ReadFile`, `WriteFile`, `Edit`, `ListFiles`), shell (`Bash` — async with progress reporting), `Search`, `Git`, `Task*`, `Channel`, `AskUserQuestion`, `RetrieveToolResult`, `ToolSchema`, `Sleep`, `PinContext`, `PushNotification`.
+- **`Local_*`** — built-in: filesystem (`ReadFile`, `WriteFile`, `Edit`, `ListFiles`), shell (`Bash`), `Search`, `Git`, `Task*`, `AskUserQuestion`, `RetrieveToolResult`, `ToolSchema`, `PinContext`, `PushNotification`, `WebFetch`, and `WebSearch`.
 - **`Memory_*`** — agent-library backed, per-persona indexed knowledge store.
 - **Arcade Cloud + user MCP servers** — anything you register.
 
@@ -126,7 +131,7 @@ Memory is persona-scoped — each persona has its own `~/.cade/data/contexts/<co
 
 ## Headless daemon: `cade serve`
 
-Run Cade as a long-lived daemon that replies over messaging platforms (Telegram supported today; the adapter protocol is generic). Each chat gets its own persistent thread — persona, memory, and tools carry across messages.
+Run Cade as a long-lived daemon that replies through adapters. Telegram is supported for personal bot workflows, and Desktop exposes a local WebSocket for native clients. Each conversation gets its own persistent thread — persona, memory, and tools carry across messages.
 
 ```bash
 cade serve init                          # wizard: bot token, allowed senders
@@ -137,9 +142,9 @@ cade serve status / stop                 # health, uptime; SIGTERM running daemo
 
 Config lives at `~/.cade/config/contexts/<context>.toml [serve]`. Edit and `kill -HUP $(cat ~/.cade/run/serve.pid)` to reload without restart.
 
-**Security defaults are fail-closed:** `allowed_senders = []` blocks everyone; tools are default-deny against `[tools].allow` (globs / regex / pipe lists supported); `deny` always wins.
+**Security defaults are fail-closed:** `allowed_senders = []` blocks everyone; tools are default-deny against `[serve.tools].allow` (globs / regex / pipe lists supported); `deny` always wins.
 
-The MCP transport is fully bidirectional, so tools running inside the daemon can elicit structured input (rendered as Telegram inline keyboards), stream live progress (rendered as edited placeholder messages), and emit logs that flow into the daemon log. See [`docs/mcp.md`](./docs/mcp.md) for the protocol details, [`docs/configuration.md`](./docs/configuration.md) for the full daemon config reference.
+The MCP transport is fully bidirectional, so tools running inside the daemon can elicit structured input, stream live progress, and emit logs through whichever adapter is active. See [`docs/adapters/`](./docs/adapters/) for adapter details, [`docs/mcp.md`](./docs/mcp.md) for protocol details, and [`docs/configuration.md`](./docs/configuration.md) for the full daemon config reference.
 
 ---
 
@@ -163,17 +168,18 @@ See [`docs/channels.md`](./docs/channels.md) for the channels protocol; hooks an
 Cade works with any OpenAI-compatible endpoint. Three ways to wire one in (CLI flag → env → config, first match wins):
 
 ```bash
-# CLI flag
-cade chat --endpoint http://localhost:11434/v1 --model llama3
+# CLI flag for Ollama. Use a model from `ollama list`.
+cade chat -L --endpoint http://localhost:11434 --model qwen3:4b
 
-# Environment
-export OPENAI_BASE_URL="http://localhost:11434/v1"
-export OPENAI_API_KEY="ollama"   # any non-empty value
-cade chat --model llama3
+# Environment for one-shot mode
+cade context create local-qwen --model qwen3:4b
+cade context use local-qwen
+export OLLAMA_BASE_URL="http://localhost:11434"
+CADE_LOCAL_ONLY=1 cade -m "hello from a local model"
 
 # Config — ~/.cade/config/cade.toml
 [model_settings]
-host = "http://localhost:11434/v1"
+host = "http://localhost:8000/v1"
 api_key = "ollama"
 ```
 
@@ -214,14 +220,15 @@ Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/confi
 ```bash
 git clone https://github.com/arcadeai-labs/cade.git
 cd cade
-uv sync --all-extras --dev
-pytest                # full suite
-ruff check src/ tests/ && ruff format src/ tests/
+uv sync --extra dev
+uv run pytest
+uv run ruff check src/ tests/
 ```
 
 Style: Python 3.11+ with modern type hints (`dict`, `list`, `| None`); ruff for lint + format; pytest with `asyncio_mode = "auto"`. Public functions and classes get docstrings.
 
-PRs welcome — open an issue first for anything substantial.
+Build/release docs live in [`docs/development.md`](./docs/development.md). PRs
+welcome — open an issue first for anything substantial.
 
 ---
 
@@ -229,7 +236,7 @@ PRs welcome — open an issue first for anything substantial.
 
 - [arcade.dev](https://arcade.dev) — product
 - [docs.arcade.dev](https://docs.arcade.dev) — API and tool catalog
-- [`docs/`](./docs/) — `mcp.md` (tool protocol), `configuration.md`, `channels.md`, `install.md`
+- [`docs/`](./docs/) — quickstart, examples, install, config, MCP, channels, voice, development, and adapters
 - [Issues](https://github.com/arcadeai-labs/cade/issues) · [Releases](https://github.com/arcadeai-labs/cade/releases)
 
 ## License

{cade_cli-0.11.0 → cade_cli-0.13.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.11.0"
+version = "0.13.2"
 description = "Cade - The CLI Agent from Arcade.dev"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -27,26 +27,23 @@ dependencies = [
     "typer>0.10.0",
     "pydantic[email]>=2.0.0,<3.0.0",
     "toml>=0.10.0,<1.0.0",
-    "pyyaml>=6.0,<7.0.0",
     "openai>=1.0.0,<2.0.0",
     "anthropic>=0.34.0,<1.0.0",
     "ulid==1.1",
     "arcade-tdk>=3.8.0,<4.0.0",
-    "arcade-mcp-server>=1.21.0,<2.0.0",
+    "arcade-mcp-server>=1.22.0,<2.0.0",
     "arcade-core>=4.7.0,<5.0.0",
     "arcadepy>=1.10.0,<2.0.0",
     "authlib>=1.6.0,<2.0.0",
-    "pyperclip>=1.8.0,<2.0.0",
     "prompt-toolkit>=3.0.52,<4.0.0",
-    "tiktoken>=0.11.0,<1.0.0",
     "httpx>=0.27.0,<1.0.0",
     "filelock>=3.0.0,<4.0.0",
-    "agent-library>=0.12.0,<1.0.0",
-    "sounddevice>=0.5.5",
+    "agent-library>=0.13.1,<1.0.0",
     "croniter>=2.0.0,<4.0.0",
     "python-telegram-bot>=21.0,<22.0",
     "keyring>=24.0,<26.0",
     "html2text>=2024.2.26",
+    "websockets>=14.0,<16.0",
 ]
 
 [project.urls]
@@ -69,10 +66,13 @@ dev = [
     "pytest-cov>=4.0.0,<5.0.0",
     "mypy>=1.10.0,<2.0.0",
 ]
+build = [
+    "pyinstaller>=6.16.0,<7.0.0",
+]
 voice = [
     "mlx-audio>=0.2.0,<0.4.0",
     "mlx-whisper>=0.1.0",
-    "sounddevice>=0.4.0",
+    "sounddevice>=0.5.5,<1.0.0",
     "numpy>=1.24.0",
     "webrtcvad>=2.0.10",
 ]
@@ -100,6 +100,9 @@ packages = ["src/cadecoder", "src/cade_mcp_local"]
 testpaths = ["tests"]
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "integration: tests that cross process or network boundaries without external services",
+]
 
 [tool.ruff]
 line-length = 100

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cade_mcp_local/server.py

@@ -13,8 +13,12 @@ os.environ.setdefault("LOGURU_LEVEL", "WARNING")
 
 from arcade_mcp_server import MCPApp
 
-from cade_mcp_local.resources import register_resources
-from cade_mcp_local.tools import (
+from cadecoder.core.frozen import patch_frozen_return_detection
+
+patch_frozen_return_detection()
+
+from cade_mcp_local.resources import register_resources  # noqa: E402
+from cade_mcp_local.tools import (  # noqa: E402
     ask_user_question_tool,
     bash_tool,
     edit_tool,
@@ -69,7 +73,7 @@ def create_app() -> MCPApp:
         name="Local",
         transport="stdio",
         instructions=SERVER_INSTRUCTIONS,
-        log_level="info",
+        log_level="INFO",
     )
 
     # Filesystem tools

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cadecoder/cli/app.py

@@ -10,6 +10,12 @@ os.environ.setdefault("TOKENIZERS_PARALLELISM", "false")
 # Suppress pkg_resources deprecation warning from webrtcvad and other packages
 # that haven't migrated to importlib.resources yet.
 # This MUST be set before any imports that might trigger the warning.
+# Note: webrtcvad emits UserWarning, not DeprecationWarning
+warnings.filterwarnings(
+    "ignore",
+    message=".*pkg_resources is deprecated.*",
+    category=UserWarning,
+)
 warnings.filterwarnings(
     "ignore",
     message=".*pkg_resources is deprecated.*",
@@ -42,7 +48,7 @@ from cadecoder.cli.commands.serve import serve_app
 from cadecoder.cli.commands.tasks import tasks_app
 from cadecoder.cli.commands.thread import thread_app
 from cadecoder.cli.commands.tools import tool_app
-from cadecoder.core.config import build_runtime, set_verbose_mode
+from cadecoder.core.config import build_runtime, is_local_only_mode, set_verbose_mode
 from cadecoder.core.logging import setup_logging
 from cadecoder.core.runtime import set_runtime
 
@@ -191,6 +197,30 @@ def doctor_cmd(
         raise typer.Exit(1)
 
 
+@app.command(name="__mcp-local", hidden=True)
+def _mcp_local_cmd() -> None:
+    """Run the bundled local MCP server over stdio."""
+    from cadecoder.core.frozen import patch_frozen_return_detection
+
+    patch_frozen_return_detection()
+
+    from cade_mcp_local import main
+
+    main()
+
+
+@app.command(name="__memory-mcp", hidden=True)
+def _memory_mcp_cmd() -> None:
+    """Run the bundled agent-library MCP server over stdio."""
+    from cadecoder.core.frozen import patch_frozen_return_detection
+
+    patch_frozen_return_detection()
+
+    from librarian.server import app as librarian_app
+
+    librarian_app.run(transport="stdio")
+
+
 @app.callback()
 def main_callback(
     ctx: typer.Context,
@@ -237,7 +267,7 @@ def main_callback(
             "--message",
             "-m",
             help="Single message mode: process one message and exit. "
-            "Reads from stdin if no argument given.",
+            "When stdin is piped, stdin is appended to this prompt.",
         ),
     ] = None,
     version: Annotated[
@@ -275,22 +305,27 @@ def main_callback(
 
         from cadecoder.ui.session import run_single_message_mode
 
-        # If message is empty string, read from stdin
-        if message == "":
-            # Check if stdin has data
-            if not sys.stdin.isatty():
-                message = sys.stdin.read().strip()
-            else:
-                console.print(
-                    "[red]Error: No message provided. Use -m 'message' or pipe input.[/red]"
-                )
-                raise typer.Exit(1)
+        # If stdin is piped, append it to the prompt. This makes the natural
+        # shell forms work: `cade -m "Explain this" < file` and
+        # `git diff | cade -m "Review this diff"`.
+        if not sys.stdin.isatty():
+            stdin_text = sys.stdin.read().strip()
+            if stdin_text:
+                message = stdin_text if message == "" else f"{message}\n\n{stdin_text}"
+        elif message == "":
+            console.print("[red]Error: No message provided. Use -m 'message' or pipe input.[/red]")
+            raise typer.Exit(1)
 
         if not message:
             console.print("[red]Error: Empty message provided.[/red]")
             raise typer.Exit(1)
 
-        exit_code = run_single_message_mode(message, persona=runtime.persona_name)
+        exit_code = run_single_message_mode(
+            message,
+            model=runtime.model,
+            local_only=is_local_only_mode(),
+            persona=runtime.persona_name,
+        )
         raise typer.Exit(exit_code)
 
     # Handle eager resume flag before default chat

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cadecoder/cli/commands/context.py

@@ -25,7 +25,14 @@ from cadecoder.core.runtime import reset_runtime
 
 console = Console(stderr=True)
 context_app = typer.Typer(help="Manage activation contexts", invoke_without_command=True)
-_EXPORT_SECRET_KEYS = {"secret", "secret_ref", "auth_value", "oauth_tokens", "oauth_client_secret"}
+_EXPORT_SECRET_KEYS = {
+    "auth_token",
+    "auth_value",
+    "oauth_client_secret",
+    "oauth_tokens",
+    "secret",
+    "secret_ref",
+}
 
 
 @context_app.callback()

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cadecoder/core/config.py

@@ -125,8 +125,20 @@ class TelegramAdapterConfig(BaseModel):
     drop_pending_updates: bool = True
 
 
+class DesktopAdapterConfig(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+    enabled: bool = False
+    host: str = "127.0.0.1"
+    port: int = 8765
+    auth_token: str = ""
+    allowed_senders: list[str] = Field(default_factory=lambda: ["desktop"])
+    allowed_conversations: list[str] = Field(default_factory=list)
+    speak_replies: bool = False
+
+
 class AdaptersConfig(BaseModel):
     model_config = ConfigDict(extra="allow")
+    desktop: DesktopAdapterConfig = Field(default_factory=DesktopAdapterConfig)
     telegram: TelegramAdapterConfig = Field(default_factory=TelegramAdapterConfig)
 
     def get(self, name: str) -> Any | None:

cade_cli-0.13.2/src/cadecoder/core/frozen.py

@@ -0,0 +1,37 @@
+"""Helpers for running Cade from frozen/PyInstaller binaries."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import Any
+
+
+def patch_frozen_return_detection() -> None:
+    """Avoid arcade-core source introspection failures in frozen builds.
+
+    arcade-core inspects function source to decide whether a tool returns a
+    value. Frozen binaries do not always expose source text through their
+    loader, so fall back to the function's return annotation when source is
+    unavailable.
+    """
+    try:
+        import arcade_core.catalog as catalog
+        import arcade_core.utils as utils
+    except Exception:
+        return
+
+    original = utils.does_function_return_value
+    if getattr(original, "_cade_frozen_safe", False):
+        return
+
+    def _safe_does_function_return_value(function: Callable[..., Any]) -> bool:
+        try:
+            return original(function)
+        except ValueError as exc:
+            if str(exc) != "Source code not found":
+                raise
+            return function.__annotations__.get("return") is not None
+
+    _safe_does_function_return_value._cade_frozen_safe = True  # type: ignore[attr-defined]
+    utils.does_function_return_value = _safe_does_function_return_value
+    catalog.does_function_return_value = _safe_does_function_return_value

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cadecoder/execution/tool_result_store.py

@@ -36,8 +36,10 @@ TINY_RESULT_BYTES = 1_024
 
 # Tools whose results must NEVER be externalized — doing so creates infinite
 # retrieval loops (agent retrieves → result externalized → agent retrieves again → ...)
+# or breaks schema-recovery flows that must stay directly visible in context.
 NEVER_EXTERNALIZE_TOOLS: frozenset[str] = frozenset(
     {
+        "Arcade_SelectTools",
         "Local_RetrieveToolResult",
         "Local_SearchRecentContext",
         "Local_ToolSchema",
@@ -326,8 +328,8 @@ def _extract_tool_name(tool_obj: dict[str, Any]) -> str:
     func = tool_obj.get("function", {})
     if isinstance(func, dict) and func.get("name"):
         return _strip_version_suffix(func["name"])
-    # Flat format: {"name": "..."}
-    return _strip_version_suffix(tool_obj.get("name", "unknown"))
+    # Flat / Arcade format: {"name": "..."} or {"tool_name": "..."}
+    return _strip_version_suffix(tool_obj.get("name") or tool_obj.get("tool_name") or "unknown")
 
 
 def _extract_tool_description(tool_obj: dict[str, Any]) -> str:

{cade_cli-0.11.0 → cade_cli-0.13.2}/src/cadecoder/execution/tool_schema_cache.py

@@ -135,6 +135,38 @@ class ToolSchemaCache:
             )
         return result
 
+    def iter_cached_tools(self, thread_id: str = "") -> list[CachedToolSchema]:
+        """Return cached schemas for one thread or every thread.
+
+        Args:
+            thread_id: Optional thread id. Empty means merge every thread cache.
+
+        Returns:
+            Cached schemas de-duplicated by name, preferring the newest entry.
+        """
+        entries: dict[str, CachedToolSchema] = {}
+        paths = (
+            [self._thread_path(thread_id)]
+            if thread_id
+            else self.storage_dir.glob("*/tool_schemas.json")
+        )
+        for path in paths:
+            if not self._disk_ok or not path.exists():
+                continue
+            try:
+                data = json.loads(path.read_text(encoding="utf-8"))
+            except (json.JSONDecodeError, OSError):
+                continue
+            for tool_data in data.get("tools", {}).values():
+                try:
+                    entry = CachedToolSchema(**tool_data)
+                except (TypeError, ValueError):
+                    continue
+                existing = entries.get(entry.name)
+                if existing is None or entry.cached_at > existing.cached_at:
+                    entries[entry.name] = entry
+        return list(entries.values())
+
     def list_all_cached(self) -> list[dict[str, Any]]:
         """List unique cached tools across every thread.
 
@@ -356,7 +388,7 @@ def _extract_tool_name(tool_obj: dict[str, Any]) -> str:
     func = tool_obj.get("function", {})
     if isinstance(func, dict) and func.get("name"):
         return _strip_version_suffix(func["name"])
-    return _strip_version_suffix(tool_obj.get("name", "unknown"))
+    return _strip_version_suffix(tool_obj.get("name") or tool_obj.get("tool_name") or "unknown")
 
 
 def _extract_tool_description(tool_obj: dict[str, Any]) -> str:
@@ -372,4 +404,4 @@ def _extract_tool_parameters(tool_obj: dict[str, Any]) -> dict[str, Any]:
     func = tool_obj.get("function", {})
     if isinstance(func, dict) and func.get("parameters"):
         return func["parameters"]
-    return tool_obj.get("parameters", {})
+    return tool_obj.get("parameters") or tool_obj.get("input_schema") or {}