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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.10.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,28 +43,29 @@ 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.1.0
-Requires-Dist: arcade-mcp-server>=1.0.0
-Requires-Dist: arcade-tdk>=2.0.0
+Requires-Dist: arcade-core<5.0.0,>=4.7.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
 Requires-Dist: croniter<4.0.0,>=2.0.0
 Requires-Dist: filelock<4.0.0,>=3.0.0
+Requires-Dist: html2text>=2024.2.26
 Requires-Dist: httpx<1.0.0,>=0.27.0
 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'
@@ -81,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
 
@@ -117,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
@@ -124,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
@@ -131,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
@@ -143,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 |
 
@@ -159,7 +165,8 @@ cade --voice                               # speak / hear (voice mode)
 | `/logs` | Recent log entries |
 | `/thread`, `/history` | Current thread info |
 | `/pin`, `/unpin` | Pin reference material into the session |
-| `/task`, `/cron`, `/hooks`, `/channel`, `/notify` | Coordination surfaces |
+| `/tasks`, `/cron`, `/hooks`, `/channels`, `/notify` | Coordination surfaces (mirrored as `cade tasks` / `cade cron` / `cade hooks` / `cade channels`) |
+| `/usage` | Context-window status and token usage |
 | `/cd`, `/pwd`, `/!` | Shell shortcuts |
 | `Ctrl+C` | Exit |
 
@@ -169,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.
 
@@ -191,7 +198,7 @@ cade mcp authorize my-server                      # OAuth flow (browser)
 cade mcp list / status / test / enable / disable / rm
 ```
 
-User MCP servers register at `~/.cadecoder/mcp_servers.yaml`. Servers with large catalogs are auto-deferred (parameter schemas stripped to keep tool-list bytes down) and fetched on demand via `Local_ToolSchema`.
+User MCP servers register at `~/.cade/config/contexts/<context>.toml [[mcp]]`. Servers with large catalogs are auto-deferred (parameter schemas stripped to keep tool-list bytes down) and fetched on demand via `Local_ToolSchema`.
 
 ---
 
@@ -206,13 +213,13 @@ cade mem add ~/notes                          # index a directory
 cade mem search "auth design"                 # semantic search
 ```
 
-Memory is persona-scoped — each persona has its own `~/.cadecoder/memory/<persona>/.librarian/` index, so a `reviewer` persona's notes never leak into `default`.
+Memory is persona-scoped — each persona has its own `~/.cade/data/contexts/<context>/memory/<persona>/.librarian/` index, so a `reviewer` persona's notes never leak into `default`.
 
 ---
 
 ## 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
@@ -221,11 +228,11 @@ cade serve --install launchd             # macOS LaunchAgent (or --install syste
 cade serve status / stop                 # health, uptime; SIGTERM running daemon
 ```
 
-Config lives at `~/.cadecoder/serve.toml`. Edit and `kill -HUP $(cat ~/.cadecoder/serve.pid)` to reload without restart.
+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.
 
 ---
 
@@ -249,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 — ~/.cadecoder/cadecoder.toml
+# Config — ~/.cade/config/cade.toml
 [model_settings]
-host = "http://localhost:11434/v1"
+host = "http://localhost:8000/v1"
 api_key = "ollama"
 ```
 
@@ -269,15 +277,15 @@ Skip Arcade Cloud authentication entirely with `--local-only` or `CADE_LOCAL_ONL
 
 ## Configuration
 
-All state lives under `~/.cadecoder/`. Override the location with `CADECODER_HOME=/path/to/alt`.
+All state lives under `~/.cade/`. Override the location with `CADE_HOME=/path/to/alt`.
 
 | File | Purpose |
 |---|---|
-| `cadecoder.toml` | Model / provider / UI settings |
-| `cadecoder_history.db` | Thread + message storage |
-| `cadecoder.log` | Rotating log file |
-| `mcp_servers.yaml` | User MCP server registry |
-| `serve.toml` | `cade serve` daemon config |
+| `config/cade.toml` | Model / provider / UI settings |
+| `data/contexts/<context>/history.db` | Thread + message storage |
+| `logs/cade.log` | Rotating log file |
+| `config/contexts/<context>.toml [[mcp]]` | User MCP server registry |
+| `config/contexts/<context>.toml [serve]` | `cade serve` daemon config |
 | `personas/`, `memory/`, `tasks/`, `channels/` | Persona-scoped state |
 
 Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/configuration.md).
@@ -290,7 +298,7 @@ Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/confi
 | `OPENAI_BASE_URL` | Custom OpenAI-compatible endpoint |
 | `ARCADE_API_KEY`, `ARCADE_BASE_URL` | Arcade Cloud (alternative to OAuth) |
 | `CADE_LOCAL_ONLY=1` | Skip remote tools entirely |
-| `CADECODER_HOME` | Override config directory |
+| `CADE_HOME` | Override config directory |
 | `CADE_PROJECT_ROOT` | Sandbox `Local_*` filesystem tools to this root |
 
 ---
@@ -300,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.
 
 ---
 
@@ -315,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.10.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 |
 
@@ -72,7 +77,8 @@ cade --voice                               # speak / hear (voice mode)
 | `/logs` | Recent log entries |
 | `/thread`, `/history` | Current thread info |
 | `/pin`, `/unpin` | Pin reference material into the session |
-| `/task`, `/cron`, `/hooks`, `/channel`, `/notify` | Coordination surfaces |
+| `/tasks`, `/cron`, `/hooks`, `/channels`, `/notify` | Coordination surfaces (mirrored as `cade tasks` / `cade cron` / `cade hooks` / `cade channels`) |
+| `/usage` | Context-window status and token usage |
 | `/cd`, `/pwd`, `/!` | Shell shortcuts |
 | `Ctrl+C` | Exit |
 
@@ -82,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.
 
@@ -104,7 +110,7 @@ cade mcp authorize my-server                      # OAuth flow (browser)
 cade mcp list / status / test / enable / disable / rm
 ```
 
-User MCP servers register at `~/.cadecoder/mcp_servers.yaml`. Servers with large catalogs are auto-deferred (parameter schemas stripped to keep tool-list bytes down) and fetched on demand via `Local_ToolSchema`.
+User MCP servers register at `~/.cade/config/contexts/<context>.toml [[mcp]]`. Servers with large catalogs are auto-deferred (parameter schemas stripped to keep tool-list bytes down) and fetched on demand via `Local_ToolSchema`.
 
 ---
 
@@ -119,13 +125,13 @@ cade mem add ~/notes                          # index a directory
 cade mem search "auth design"                 # semantic search
 ```
 
-Memory is persona-scoped — each persona has its own `~/.cadecoder/memory/<persona>/.librarian/` index, so a `reviewer` persona's notes never leak into `default`.
+Memory is persona-scoped — each persona has its own `~/.cade/data/contexts/<context>/memory/<persona>/.librarian/` index, so a `reviewer` persona's notes never leak into `default`.
 
 ---
 
 ## 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
@@ -134,11 +140,11 @@ cade serve --install launchd             # macOS LaunchAgent (or --install syste
 cade serve status / stop                 # health, uptime; SIGTERM running daemon
 ```
 
-Config lives at `~/.cadecoder/serve.toml`. Edit and `kill -HUP $(cat ~/.cadecoder/serve.pid)` to reload without restart.
+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.
 
 ---
 
@@ -162,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 — ~/.cadecoder/cadecoder.toml
+# Config — ~/.cade/config/cade.toml
 [model_settings]
-host = "http://localhost:11434/v1"
+host = "http://localhost:8000/v1"
 api_key = "ollama"
 ```
 
@@ -182,15 +189,15 @@ Skip Arcade Cloud authentication entirely with `--local-only` or `CADE_LOCAL_ONL
 
 ## Configuration
 
-All state lives under `~/.cadecoder/`. Override the location with `CADECODER_HOME=/path/to/alt`.
+All state lives under `~/.cade/`. Override the location with `CADE_HOME=/path/to/alt`.
 
 | File | Purpose |
 |---|---|
-| `cadecoder.toml` | Model / provider / UI settings |
-| `cadecoder_history.db` | Thread + message storage |
-| `cadecoder.log` | Rotating log file |
-| `mcp_servers.yaml` | User MCP server registry |
-| `serve.toml` | `cade serve` daemon config |
+| `config/cade.toml` | Model / provider / UI settings |
+| `data/contexts/<context>/history.db` | Thread + message storage |
+| `logs/cade.log` | Rotating log file |
+| `config/contexts/<context>.toml [[mcp]]` | User MCP server registry |
+| `config/contexts/<context>.toml [serve]` | `cade serve` daemon config |
 | `personas/`, `memory/`, `tasks/`, `channels/` | Persona-scoped state |
 
 Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/configuration.md).
@@ -203,7 +210,7 @@ Full layout, env vars, and TOML schema in [`docs/configuration.md`](./docs/confi
 | `OPENAI_BASE_URL` | Custom OpenAI-compatible endpoint |
 | `ARCADE_API_KEY`, `ARCADE_BASE_URL` | Arcade Cloud (alternative to OAuth) |
 | `CADE_LOCAL_ONLY=1` | Skip remote tools entirely |
-| `CADECODER_HOME` | Override config directory |
+| `CADE_HOME` | Override config directory |
 | `CADE_PROJECT_ROOT` | Sandbox `Local_*` filesystem tools to this root |
 
 ---
@@ -213,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.
 
 ---
 
@@ -228,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.10.0 → cade_cli-0.13.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.10.0"
+version = "0.13.2"
 description = "Cade - The CLI Agent from Arcade.dev"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -27,24 +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>=2.0.0",
-    "arcade-mcp-server>=1.0.0",
-    "arcade-core>=4.1.0,<5.0.0",
+    "arcade-tdk>=3.8.0,<4.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]
@@ -67,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",
 ]
@@ -98,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.10.0 → cade_cli-0.13.2}/src/cade_mcp_local/__init__.py

@@ -27,12 +27,17 @@ from cade_mcp_local.config import (
 from cade_mcp_local.errors import (
     CommandExecutionError,
     CommandTimeoutError,
+    ContentTooLargeError,
     FileOperationError,
     GitOperationError,
     InvalidInputError,
     PathNotFoundError,
     PathSecurityError,
+    RedirectError,
     SearchError,
+    WebFetchError,
+    WebSearchError,
+    WebTransientError,
 )
 from cade_mcp_local.server import app, create_app
 
@@ -67,6 +72,11 @@ __all__ = [
     "GitOperationError",
     "SearchError",
     "FileOperationError",
+    "WebFetchError",
+    "WebSearchError",
+    "RedirectError",
+    "ContentTooLargeError",
+    "WebTransientError",
 ]
 
 from cadecoder import __version__ as __version__  # noqa: E402

cade_cli-0.13.2/src/cade_mcp_local/_metadata.py

@@ -0,0 +1,84 @@
+"""Reusable :class:`ToolMetadata` builders for Local_* tools.
+
+Local tools run in-process against the user's machine. None of them have a
+``ServiceDomain`` (those describe an external service like Slack or Gmail);
+``open_world`` is therefore ``False`` for everything in this package, and
+the per-tool metadata below only varies on operation/read-only/destructive/
+idempotent.
+
+Web tools (``WebFetch`` / ``WebSearch``) are the exception — they declare
+``ServiceDomain.WEB_SCRAPING`` and ``open_world=True`` inline, since their
+backing data lives on the open internet.
+"""
+
+from arcade_mcp_server.metadata import (
+    Behavior,
+    Classification,
+    Operation,
+    ToolMetadata,
+)
+
+
+def _meta(
+    *,
+    operations: list[Operation],
+    read_only: bool,
+    destructive: bool = False,
+    idempotent: bool = False,
+) -> ToolMetadata:
+    """All Local_* tools share open_world=False and no service_domains."""
+    return ToolMetadata(
+        classification=Classification(service_domains=None),
+        behavior=Behavior(
+            operations=operations,
+            read_only=read_only,
+            destructive=destructive,
+            idempotent=idempotent,
+            open_world=False,
+        ),
+    )
+
+
+READ_META = _meta(operations=[Operation.READ], read_only=True, idempotent=True)
+"""Pure read of local state. Idempotent."""
+
+READ_VOLATILE_META = _meta(operations=[Operation.READ], read_only=True, idempotent=False)
+"""Reads local state that changes under the agent's feet (e.g. compaction backups)."""
+
+CREATE_META = _meta(operations=[Operation.CREATE], read_only=False, idempotent=False)
+"""Creates a new local resource (file, task, snippet, notification)."""
+
+UPDATE_META = _meta(operations=[Operation.UPDATE], read_only=False, idempotent=False)
+"""Modifies an existing local resource."""
+
+CREATE_OR_UPDATE_META = _meta(operations=[Operation.CREATE, Operation.UPDATE], read_only=False)
+"""Upsert-style write that may create or update."""
+
+DELETE_META = _meta(
+    operations=[Operation.DELETE], read_only=False, destructive=True, idempotent=True
+)
+"""Removes a local resource. Destructive."""
+
+OPAQUE_META = ToolMetadata(
+    classification=Classification(service_domains=None),
+    behavior=Behavior(
+        operations=[Operation.OPAQUE],
+        read_only=False,
+        destructive=False,
+        idempotent=False,
+        open_world=False,
+    ),
+    strict=False,  # Bash/Channel can do anything; we keep destructive=False per "best case"
+)
+"""Action depends on runtime inputs (e.g. Bash, Channel multiplexer)."""
+
+
+__all__ = (
+    "CREATE_META",
+    "CREATE_OR_UPDATE_META",
+    "DELETE_META",
+    "OPAQUE_META",
+    "READ_META",
+    "READ_VOLATILE_META",
+    "UPDATE_META",
+)

{cade_cli-0.10.0 → cade_cli-0.13.2}/src/cade_mcp_local/errors.py

@@ -120,3 +120,49 @@ class FileOperationError(FatalToolError):
         self.operation = operation
         self.path = path
         super().__init__(f"Failed to {operation} '{path}': {message}")
+
+
+class WebFetchError(FatalToolError):
+    """Generic non-retriable WebFetch failure (DNS, 4xx, blocked host)."""
+
+    def __init__(self, url: str, message: str):
+        self.url = url
+        super().__init__(f"WebFetch failed for {url}: {message}")
+
+
+class RedirectError(FatalToolError):
+    """Cross-host redirect; the agent should re-fetch the new URL explicitly."""
+
+    def __init__(self, from_url: str, to_url: str):
+        self.from_url = from_url
+        self.to_url = to_url
+        super().__init__(
+            f"Cross-host redirect from {from_url} to {to_url}; re-call WebFetch with the new URL."
+        )
+
+
+class ContentTooLargeError(FatalToolError):
+    """Body exceeded max_bytes."""
+
+    def __init__(self, url: str, limit_bytes: int):
+        self.url = url
+        self.limit_bytes = limit_bytes
+        super().__init__(f"Body for {url} exceeded {limit_bytes} bytes; aborted.")
+
+
+class WebSearchError(FatalToolError):
+    """Backend misconfigured or returned an unparseable response."""
+
+    def __init__(self, backend: str, message: str):
+        self.backend = backend
+        super().__init__(f"WebSearch ({backend}) failed: {message}")
+
+
+class WebTransientError(RetryableToolError):
+    """5xx, network reset, rate-limit. Agent may retry."""
+
+    def __init__(self, url: str, status: int | None, message: str):
+        self.url = url
+        self.status = status
+        detail = f" (HTTP {status})" if status else ""
+        super().__init__(f"Transient web error for {url}{detail}: {message}")