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

{cade_cli-0.9.0 → cade_cli-0.11.0}/.gitignore

@@ -5,6 +5,7 @@ __pycache__/
 
 .claude/
 CLAUDE.md
+.context/
 .env
 
 
@@ -40,7 +41,6 @@ build/
 # Virtual environment
 .venv
 activate.sh
-docs/
 
 # uv
 uv.lock

cade_cli-0.11.0/PKG-INFO

@@ -0,0 +1,326 @@
+Metadata-Version: 2.4
+Name: cade-cli
+Version: 0.11.0
+Summary: Cade - The CLI Agent from Arcade.dev
+Project-URL: Homepage, https://arcade.dev
+Project-URL: Documentation, https://docs.arcade.dev
+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
+Author-email: "Arcade AI Inc." <dev@arcade.dev>
+License: MIT License
+        
+        Copyright (c) 2024 Arcade AI Inc.
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agent,ai,arcade,cli,coding-assistant,llm,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+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: 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-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
+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'
+Requires-Dist: pytest-cov<5.0.0,>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-mock<4.0.0,>=3.11.0; extra == 'dev'
+Requires-Dist: pytest<9.0.0,>=8.0.0; extra == 'dev'
+Requires-Dist: ruff<1.0.0,>=0.5.0; extra == 'dev'
+Provides-Extra: training
+Requires-Dist: accelerate>=0.27.0; extra == 'training'
+Requires-Dist: safetensors>=0.4.2; extra == 'training'
+Requires-Dist: torch>=2.1.0; extra == 'training'
+Requires-Dist: transformers>=4.38.0; extra == 'training'
+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: webrtcvad>=2.0.10; extra == 'voice'
+Description-Content-Type: text/markdown
+
+# Cade
+
+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
+brew install ArcadeAI/tap/cade   #  or:  uv tool install cade-cli   |   pip install cade-cli
+cade login
+cade
+```
+
+---
+
+## Highlights
+
+- **Three deployment modes from the same binary.** Interactive chat (`cade`), one-shot or pipe (`cade -m "…"`), or a headless daemon that replies over messaging (`cade serve`).
+- **Tools from anywhere.** Built-in local tools (filesystem / shell / git / search / tasks / channels / memory), [Arcade Cloud](https://arcade.dev) tools (Slack, GitHub, Gmail, calendars, …), and any [MCP](https://modelcontextprotocol.io/) server you register — all unified under one tool surface.
+- **Bidirectional MCP.** Tools can call `context.ui.elicit(…)` for structured input, `context.log.*` for live operator logs, and `context.progress.report(…)` for editable progress UI — routed end-to-end through whichever adapter is active (Telegram inline keyboard, terminal prompt).
+- **Personas + per-persona memory.** Multiple agent profiles with their own system prompt and an indexed memory store backed by [agent-library](https://pypi.org/project/agent-library/).
+- **Extensibility surface.** Hooks (lifecycle events), tasks (file-backed durable work), cron (scheduled prompts), channels (cross-session pub/sub) — all available to the agent as `Local_*` tools and to you as `cade <subcommand>`.
+- **Bring your own LLM.** OpenAI, Anthropic, or any OpenAI-compatible endpoint (Ollama, vLLM, Together, Groq, Fireworks, …). `--local-only` skips Arcade Cloud entirely.
+
+---
+
+## Install
+
+| Source | Command |
+|---|---|
+| Homebrew | `brew install ArcadeAI/tap/cade` |
+| 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` |
+
+**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
+cade login          # Arcade Cloud OAuth (skip with --local-only)
+cade --version
+```
+
+---
+
+## Quick start
+
+```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 -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)
+```
+
+### Top-level options
+
+| Flag | Description |
+|---|---|
+| `-r`, `--resume` | Resume most recent thread |
+| `-m`, `--message` | Single-message mode (reads stdin if no arg) |
+| `-P`, `--persona` | Use a saved persona |
+| `-V`, `--voice` | Voice mode |
+| `-v`, `--verbose` | Debug logging |
+| `--version` | Print version |
+
+### In-chat slash commands
+
+| Command | Description |
+|---|---|
+| `/help` | List commands |
+| `/clear` | Clear screen |
+| `/copy` | Copy last response |
+| `/logs` | Recent log entries |
+| `/thread`, `/history` | Current thread info |
+| `/pin`, `/unpin` | Pin reference material into the session |
+| `/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 |
+
+---
+
+## Tools
+
+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`.
+- **`Memory_*`** — agent-library backed, per-persona indexed knowledge store.
+- **Arcade Cloud + user MCP servers** — anything you register.
+
+```bash
+cade tools list                         # all tools, all sources
+cade tools list --source local          # filter by source
+cade tools search "send slack"          # keyword search
+cade tools info Local_ReadFile          # full schema + description
+```
+
+The full local tool surface (including the bidirectional MCP capabilities and `cade serve` integration) is documented in [`docs/mcp.md`](./docs/mcp.md).
+
+### Custom MCP servers
+
+```bash
+cade mcp add my-server http://localhost:8080
+cade mcp add my-server http://… --auth bearer -t <token>
+cade mcp authorize my-server                      # OAuth flow (browser)
+cade mcp list / status / test / enable / disable / rm
+```
+
+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`.
+
+---
+
+## Personas + memory
+
+```bash
+cade persona list / create / get / edit / delete / default   # manage system prompts
+cade --persona reviewer                       # use one for a session
+
+cade mem list                                 # sources indexed for the active persona
+cade mem add ~/notes                          # index a directory
+cade mem search "auth design"                 # semantic search
+```
+
+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.
+
+```bash
+cade serve init                          # wizard: bot token, allowed senders
+cade serve                               # foreground
+cade serve --install launchd             # macOS LaunchAgent (or --install systemd)
+cade serve status / stop                 # health, uptime; SIGTERM running daemon
+```
+
+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.
+
+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.
+
+---
+
+## Extensibility: hooks, tasks, cron, channels
+
+Four primitives the agent uses directly (as `Local_*` tools) and you can drive from the CLI:
+
+| Surface | What it is | CLI |
+|---|---|---|
+| **Hooks** | Lifecycle event handlers (pre/post tool, user prompt submit) | `cade hooks list / add / remove / test` |
+| **Tasks** | File-backed durable work units that survive turn boundaries | `cade tasks list / get / create / update / delete` |
+| **Cron** | Scheduled prompts the agent runs on a timer | `cade cron list / add / remove / enable / disable / run-now` |
+| **Channels** | JSONL-backed inter-session pub/sub | `cade channels list / send / recv / clear` |
+
+See [`docs/channels.md`](./docs/channels.md) for the channels protocol; hooks and tasks/cron details live in their respective `cade <subcommand> --help` outputs.
+
+---
+
+## Bring your own LLM
+
+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
+
+# Environment
+export OPENAI_BASE_URL="http://localhost:11434/v1"
+export OPENAI_API_KEY="ollama"   # any non-empty value
+cade chat --model llama3
+
+# Config — ~/.cade/config/cade.toml
+[model_settings]
+host = "http://localhost:11434/v1"
+api_key = "ollama"
+```
+
+Skip Arcade Cloud authentication entirely with `--local-only` or `CADE_LOCAL_ONLY=1` when running against local LLMs.
+
+---
+
+## Configuration
+
+All state lives under `~/.cade/`. Override the location with `CADE_HOME=/path/to/alt`.
+
+| File | Purpose |
+|---|---|
+| `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).
+
+### Common env vars
+
+| Variable | Purpose |
+|---|---|
+| `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` | LLM provider keys |
+| `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 |
+| `CADE_HOME` | Override config directory |
+| `CADE_PROJECT_ROOT` | Sandbox `Local_*` filesystem tools to this root |
+
+---
+
+## Contributing
+
+```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/
+```
+
+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.
+
+---
+
+## Resources
+
+- [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`
+- [Issues](https://github.com/arcadeai-labs/cade/issues) · [Releases](https://github.com/arcadeai-labs/cade/releases)
+
+## License
+
+MIT

cade_cli-0.11.0/README.md

@@ -0,0 +1,237 @@
+# Cade
+
+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
+brew install ArcadeAI/tap/cade   #  or:  uv tool install cade-cli   |   pip install cade-cli
+cade login
+cade
+```
+
+---
+
+## Highlights
+
+- **Three deployment modes from the same binary.** Interactive chat (`cade`), one-shot or pipe (`cade -m "…"`), or a headless daemon that replies over messaging (`cade serve`).
+- **Tools from anywhere.** Built-in local tools (filesystem / shell / git / search / tasks / channels / memory), [Arcade Cloud](https://arcade.dev) tools (Slack, GitHub, Gmail, calendars, …), and any [MCP](https://modelcontextprotocol.io/) server you register — all unified under one tool surface.
+- **Bidirectional MCP.** Tools can call `context.ui.elicit(…)` for structured input, `context.log.*` for live operator logs, and `context.progress.report(…)` for editable progress UI — routed end-to-end through whichever adapter is active (Telegram inline keyboard, terminal prompt).
+- **Personas + per-persona memory.** Multiple agent profiles with their own system prompt and an indexed memory store backed by [agent-library](https://pypi.org/project/agent-library/).
+- **Extensibility surface.** Hooks (lifecycle events), tasks (file-backed durable work), cron (scheduled prompts), channels (cross-session pub/sub) — all available to the agent as `Local_*` tools and to you as `cade <subcommand>`.
+- **Bring your own LLM.** OpenAI, Anthropic, or any OpenAI-compatible endpoint (Ollama, vLLM, Together, Groq, Fireworks, …). `--local-only` skips Arcade Cloud entirely.
+
+---
+
+## Install
+
+| Source | Command |
+|---|---|
+| Homebrew | `brew install ArcadeAI/tap/cade` |
+| 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` |
+
+**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
+cade login          # Arcade Cloud OAuth (skip with --local-only)
+cade --version
+```
+
+---
+
+## Quick start
+
+```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 -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)
+```
+
+### Top-level options
+
+| Flag | Description |
+|---|---|
+| `-r`, `--resume` | Resume most recent thread |
+| `-m`, `--message` | Single-message mode (reads stdin if no arg) |
+| `-P`, `--persona` | Use a saved persona |
+| `-V`, `--voice` | Voice mode |
+| `-v`, `--verbose` | Debug logging |
+| `--version` | Print version |
+
+### In-chat slash commands
+
+| Command | Description |
+|---|---|
+| `/help` | List commands |
+| `/clear` | Clear screen |
+| `/copy` | Copy last response |
+| `/logs` | Recent log entries |
+| `/thread`, `/history` | Current thread info |
+| `/pin`, `/unpin` | Pin reference material into the session |
+| `/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 |
+
+---
+
+## Tools
+
+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`.
+- **`Memory_*`** — agent-library backed, per-persona indexed knowledge store.
+- **Arcade Cloud + user MCP servers** — anything you register.
+
+```bash
+cade tools list                         # all tools, all sources
+cade tools list --source local          # filter by source
+cade tools search "send slack"          # keyword search
+cade tools info Local_ReadFile          # full schema + description
+```
+
+The full local tool surface (including the bidirectional MCP capabilities and `cade serve` integration) is documented in [`docs/mcp.md`](./docs/mcp.md).
+
+### Custom MCP servers
+
+```bash
+cade mcp add my-server http://localhost:8080
+cade mcp add my-server http://… --auth bearer -t <token>
+cade mcp authorize my-server                      # OAuth flow (browser)
+cade mcp list / status / test / enable / disable / rm
+```
+
+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`.
+
+---
+
+## Personas + memory
+
+```bash
+cade persona list / create / get / edit / delete / default   # manage system prompts
+cade --persona reviewer                       # use one for a session
+
+cade mem list                                 # sources indexed for the active persona
+cade mem add ~/notes                          # index a directory
+cade mem search "auth design"                 # semantic search
+```
+
+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.
+
+```bash
+cade serve init                          # wizard: bot token, allowed senders
+cade serve                               # foreground
+cade serve --install launchd             # macOS LaunchAgent (or --install systemd)
+cade serve status / stop                 # health, uptime; SIGTERM running daemon
+```
+
+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.
+
+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.
+
+---
+
+## Extensibility: hooks, tasks, cron, channels
+
+Four primitives the agent uses directly (as `Local_*` tools) and you can drive from the CLI:
+
+| Surface | What it is | CLI |
+|---|---|---|
+| **Hooks** | Lifecycle event handlers (pre/post tool, user prompt submit) | `cade hooks list / add / remove / test` |
+| **Tasks** | File-backed durable work units that survive turn boundaries | `cade tasks list / get / create / update / delete` |
+| **Cron** | Scheduled prompts the agent runs on a timer | `cade cron list / add / remove / enable / disable / run-now` |
+| **Channels** | JSONL-backed inter-session pub/sub | `cade channels list / send / recv / clear` |
+
+See [`docs/channels.md`](./docs/channels.md) for the channels protocol; hooks and tasks/cron details live in their respective `cade <subcommand> --help` outputs.
+
+---
+
+## Bring your own LLM
+
+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
+
+# Environment
+export OPENAI_BASE_URL="http://localhost:11434/v1"
+export OPENAI_API_KEY="ollama"   # any non-empty value
+cade chat --model llama3
+
+# Config — ~/.cade/config/cade.toml
+[model_settings]
+host = "http://localhost:11434/v1"
+api_key = "ollama"
+```
+
+Skip Arcade Cloud authentication entirely with `--local-only` or `CADE_LOCAL_ONLY=1` when running against local LLMs.
+
+---
+
+## Configuration
+
+All state lives under `~/.cade/`. Override the location with `CADE_HOME=/path/to/alt`.
+
+| File | Purpose |
+|---|---|
+| `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).
+
+### Common env vars
+
+| Variable | Purpose |
+|---|---|
+| `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` | LLM provider keys |
+| `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 |
+| `CADE_HOME` | Override config directory |
+| `CADE_PROJECT_ROOT` | Sandbox `Local_*` filesystem tools to this root |
+
+---
+
+## Contributing
+
+```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/
+```
+
+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.
+
+---
+
+## Resources
+
+- [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`
+- [Issues](https://github.com/arcadeai-labs/cade/issues) · [Releases](https://github.com/arcadeai-labs/cade/releases)
+
+## License
+
+MIT

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

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.9.0"
+version = "0.11.0"
 description = "Cade - The CLI Agent from Arcade.dev"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -31,17 +31,22 @@ dependencies = [
     "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.21.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.11.0,<1.0.0",
+    "agent-library>=0.12.0,<1.0.0",
     "sounddevice>=0.5.5",
+    "croniter>=2.0.0,<4.0.0",
+    "python-telegram-bot>=21.0,<22.0",
+    "keyring>=24.0,<26.0",
+    "html2text>=2024.2.26",
 ]
 
 [project.urls]
@@ -116,19 +121,19 @@ python_version = "3.11"
 warn_unused_ignores = false
 ignore_missing_imports = true
 follow_imports = "silent"
+plugins = ["pydantic.mypy"]
 disable_error_code = [
+    # Third-party stubs are inconsistently shipped; ignore unrelated import noise.
     "import-untyped",
-    "assignment",
+    # Pydantic models with Field(alias="id") aren't recognised by mypy as
+    # accepting init-by-alias, even with populate_by_name=True. Re-enabling
+    # requires switching every callsite away from the alias.
     "call-arg",
+    # Tracked tech debt — re-enable in follow-up passes.
+    "assignment",
     "arg-type",
-    "var-annotated",
     "attr-defined",
-    "index",
     "union-attr",
-    "typeddict-item",
-    "no-redef",
-    "return-value",
-    "annotation-unchecked",
 ]
 files = ["src/cadecoder", "src/cade_mcp_local"]
 

{cade_cli-0.9.0 → cade_cli-0.11.0}/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",
 ]
 
-__version__ = "0.9.0"
+from cadecoder import __version__ as __version__  # noqa: E402