copper-pilot-cli 0.1.6__tar.gz → 0.1.8__tar.gz

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/.gitignore

@@ -7,3 +7,5 @@ __pycache__/
 .venv/
 dist/
 build/
+
+.DS_Store

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/CONTRIBUTING.md

@@ -8,7 +8,7 @@ CopperPilot agent. It is not the desktop app or the hosted backend.
 
 ## Prerequisites
 
-- Python 3.12 or newer
+- Python 3.11 or newer
 - [pip](https://pip.pypa.io/en/stable/)
 - [make](https://www.gnu.org/software/make/) (optional; the same commands are
   listed below)

copper_pilot_cli-0.1.8/HISTORY.md

@@ -0,0 +1,217 @@
+Changelog
+=========
+
+
+(unreleased)
+------------
+
+Fix
+~~~
+- Annotate async context managers for ty 0.0.87. [AdityaNG]
+
+  CI resolves the unpinned ty dependency to 0.0.87, which rejects AsyncIterator returns on asynccontextmanager.
+- Upgrade the pinned Deep Agents runtime to 0.7.19. [AdityaNG]
+
+  Keep the exact runtime pin while picking up the filesystem and media-handling fixes from 0.7.14.
+- Align the CLI with hosted usage limits. [AdityaNG]
+
+  Keep blocked turns machine-readable, shrink oversized resumed chats to the desktop frame budget, and report the installed client version.
+
+Other
+~~~~~
+- Merge pull request #16 from CopperPilot/update/14_oct_2026. [Aditya]
+
+  Add Intelligence effort, hosted survey workers, and modal keyboard focus
+- Fix(tests/test_tui.py) [AdityaNG]
+- Feat(src/copper_pilot_cli/copper_status_events.py) [AdityaNG]
+- Merge pull request #3 from
+  CopperPilot/dependabot/github_actions/softprops/action-gh-release-3.
+  [Aditya]
+
+  build(deps): bump softprops/action-gh-release from 2 to 3
+- Build(deps): bump softprops/action-gh-release from 2 to 3.
+  [dependabot[bot]]
+
+  Bumps [softprops/action-gh-release](https://github.com/softprops/action-gh-release) from 2 to 3.
+  - [Release notes](https://github.com/softprops/action-gh-release/releases)
+  - [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md)
+  - [Commits](https://github.com/softprops/action-gh-release/compare/v2...v3)
+
+  ---
+  updated-dependencies:
+  - dependency-name: softprops/action-gh-release
+    dependency-version: '3'
+    dependency-type: direct:production
+    update-type: version-update:semver-major
+  ...
+- Merge pull request #4 from CopperPilot/dependabot/pip/websockets-
+  gte-15-and-lt-18. [Aditya]
+
+  build(deps): update websockets requirement from <17,>=15 to >=15,<18
+- Build(deps): update websockets requirement from <17,>=15 to >=15,<18.
+  [dependabot[bot]]
+
+  Updates the requirements on [websockets](https://github.com/python-websockets/websockets) to permit the latest version.
+  - [Release notes](https://github.com/python-websockets/websockets/releases)
+  - [Commits](https://github.com/python-websockets/websockets/compare/15.0...17.1)
+
+  ---
+  updated-dependencies:
+  - dependency-name: websockets
+    dependency-version: '17.1'
+    dependency-type: direct:production
+  ...
+- Merge pull request #5 from CopperPilot/dependabot/pip/uuid-utils-
+  gte-0.12-and-lt-2. [Aditya]
+
+  build(deps): update uuid-utils requirement from <1,>=0.12 to >=0.12,<2
+- Build(deps): update uuid-utils requirement from <1,>=0.12 to
+  >=0.12,<2. [dependabot[bot]]
+
+  Updates the requirements on [uuid-utils](https://github.com/aminalaee/uuid-utils) to permit the latest version.
+  - [Release notes](https://github.com/aminalaee/uuid-utils/releases)
+  - [Commits](https://github.com/aminalaee/uuid-utils/compare/0.12.0...1.0.0)
+
+  ---
+  updated-dependencies:
+  - dependency-name: uuid-utils
+    dependency-version: 1.0.0
+    dependency-type: direct:production
+  ...
+- Merge pull request #2 from
+  CopperPilot/dependabot/github_actions/actions/setup-python-7. [Aditya]
+
+  build(deps): bump actions/setup-python from 5 to 7
+- Build(deps): bump actions/setup-python from 5 to 7. [dependabot[bot]]
+
+  Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 7.
+  - [Release notes](https://github.com/actions/setup-python/releases)
+  - [Commits](https://github.com/actions/setup-python/compare/v5...v7)
+
+  ---
+  updated-dependencies:
+  - dependency-name: actions/setup-python
+    dependency-version: '7'
+    dependency-type: direct:production
+    update-type: version-update:semver-major
+  ...
+- Merge pull request #13 from
+  CopperPilot/update/deepagents_0_7_19_3_oct. [Aditya]
+
+  Upgrade the pinned Deep Agents runtime to 0.7.19
+- Merge pull request #1 from
+  CopperPilot/dependabot/github_actions/actions/checkout-7. [Aditya]
+
+  build(deps): bump actions/checkout from 4 to 7
+- Build(deps): bump actions/checkout from 4 to 7. [dependabot[bot]]
+
+  Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.
+  - [Release notes](https://github.com/actions/checkout/releases)
+  - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
+  - [Commits](https://github.com/actions/checkout/compare/v4...v7)
+
+  ---
+  updated-dependencies:
+  - dependency-name: actions/checkout
+    dependency-version: '7'
+    dependency-type: direct:production
+    update-type: version-update:semver-major
+  ...
+- Merge pull request #12 from
+  CopperPilot/update/contract_alignment_3_oct. [Aditya]
+
+  Align the CLI with hosted usage limits
+
+
+0.1.7 (2026-10-03)
+------------------
+- Release: version 0.1.7 🚀 [AdityaNG]
+- Merge pull request #11 from
+  CopperPilot/feat/python_versions_support_expansion. [Aditya]
+
+  Support Python 3.11 and future releases
+- Ci: probe Python 3.15 weekly instead of on pull requests. [AdityaNG]
+
+  Keep the upstream install failure visible without turning required pull request checks red.
+- Feat(py11) [AdityaNG]
+- Merge pull request #7 from CopperPilot/feat/example_002_cm5_camera.
+  [Aditya]
+
+  feat(examples/002_cm5_camera): add 3D pose audit and generated carrier
+- Fix(examples/002_cm5_camera): render the README PCB as a dimetric 3D
+  view. [AdityaNG, Cursor]
+
+  Use an orthogonal high-quality camera with a slight isometric tilt so the
+  hero PNG shows connector height instead of a flat top-down shot.
+- Fix(examples/002_cm5_camera): skip library dirs relative to the
+  workspace. [AdityaNG, Cursor]
+
+  Absolute path parts named tmp (Linux /tmp pytest roots) were skipping the
+  entire haystack, so libraries_ready failed on Ubuntu CI.
+- Feat(examples/002_cm5_camera): add 3D pose audit and generated
+  carrier. [AdityaNG, Cursor]
+
+  Lock connector 3D offsets, Module1 pad orientation, and the generated
+  KiCad project so the example reproduces NANO-C assembly parity.
+- Feat(examples/002_cm5_camera/main.py): new example. [AdityaNG]
+
+
+0.1.6 (2026-09-18)
+------------------
+- Release: version 0.1.6 🚀 [AdityaNG]
+- Merge pull request #6 from CopperPilot/feat/plugins. [Aditya]
+
+  feat: add MCP conductor and Claude Code plugin
+- Clarify server restrictions in PR template. [Aditya]
+
+  Updated checklist item to clarify server restrictions.
+- Feat: add MCP conductor and Claude Code plugin. [AdityaNG, Cursor]
+
+  Let Claude Code, Cursor, and Codex delegate electronics work to the hosted agent via copper-pilot mcp, a portable review skill, and an in-repo plugin.
+
+
+0.1.5 (2026-09-17)
+------------------
+- Release: version 0.1.5 🚀 [AdityaNG]
+- Fix(README.md) [AdityaNG]
+
+
+0.1.4 (2026-09-17)
+------------------
+- Release: version 0.1.4 🚀 [AdityaNG]
+- Fix(tests/test_release_gates.py) [AdityaNG]
+
+
+0.1.3 (2026-09-17)
+------------------
+- Release: version 0.1.3 🚀 [AdityaNG]
+- Docs. [AdityaNG]
+
+
+0.1.2 (2026-09-17)
+------------------
+- Release: version 0.1.2 🚀 [AdityaNG]
+- Ci(pyproject.toml) [AdityaNG]
+- Fix(tests/test_tui.py) [AdityaNG]
+
+
+0.1.1 (2026-09-17)
+------------------
+- Release: version 0.1.1 🚀 [AdityaNG]
+
+
+0.1.0 (2026-09-17)
+------------------
+- Release: version 0.1.0 🚀 [AdityaNG]
+- Fix(tests/test_release_gates.py) [AdityaNG]
+- Test. [AdityaNG]
+- Docs. [AdityaNG]
+- Docs. [AdityaNG]
+- Example(examples/001_esp32/) [AdityaNG]
+- Makefile. [AdityaNG]
+- Ci. [AdityaNG]
+- Docs. [AdityaNG]
+- Refactor(name) [AdityaNG]
+- Init. [AdityaNG]
+
+

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: copper-pilot-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: CopperPilot hosted agent for the terminal and LangChain
 Project-URL: Homepage, https://copperpilot.ai
 Project-URL: Repository, https://github.com/CopperPilot/copper-pilot-cli
@@ -14,13 +14,14 @@ License-File: NOTICE
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: <4,>=3.12
+Requires-Python: >=3.11
 Requires-Dist: aiosqlite<1,>=0.22
 Requires-Dist: certifi>=2024.8.30
-Requires-Dist: deepagents==0.7.14
+Requires-Dist: deepagents==0.7.19
 Requires-Dist: httpx<1,>=0.28
 Requires-Dist: langchain-core<2,>=1.6
 Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1
@@ -34,8 +35,8 @@ Requires-Dist: pyperclip<2,>=1.11
 Requires-Dist: pyyaml<7,>=6
 Requires-Dist: rich<16,>=15
 Requires-Dist: textual<9,>=8.2.8
-Requires-Dist: uuid-utils<1,>=0.12
-Requires-Dist: websockets<17,>=15
+Requires-Dist: uuid-utils<2,>=0.12
+Requires-Dist: websockets<18,>=15
 Provides-Extra: dev
 Requires-Dist: build<2,>=1.4; extra == 'dev'
 Requires-Dist: gitchangelog==3.0.4; extra == 'dev'
@@ -86,9 +87,9 @@ CopperPilot in your terminal: a thin, open-source client for CopperPilot electro
 
 ## Prerequisites
 
-- Python 3.12 or newer
+- Python 3.11 or newer
 - A [CopperPilot](https://copperpilot.ai) account for login
-- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32)
+- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32) or [`examples/002_cm5_camera`](examples/002_cm5_camera)
 
 ## Install and run
 
@@ -106,12 +107,18 @@ copper-pilot ./my-board
 copper-pilot --resume
 copper-pilot threads list
 copper-pilot -n -m "Review this board" --json
+copper-pilot --mode plan --effort intelligence -m "Survey and plan this board"
 ```
 
 Both `copper-pilot` and `copper-pilot-cli` run the same program.
 `copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
 command reference.
 
+Balanced effort is the default. Paid-plan users can select Intelligence with
+`--effort intelligence` or interactive `/effort`. Intelligence uses
+server-owned survey subagents and shows their lifecycle through the existing
+Deep Agents task rows; Intelligence Plan turns survey before writing a plan.
+
 ## Use from Claude Code, Cursor, or Codex
 
 CopperPilot stays the electronics agent. Copy
@@ -146,13 +153,16 @@ the parent directory is mode `0700` and the file is mode `0600`.
 ## LangChain
 
 ```python
-from copper_pilot_cli.copper_protocol import CopperMode
+from copper_pilot_cli.copper_protocol import CopperEffort, CopperMode
 from copper_pilot_cli.langchain import CopperPilotAgent
 from helper import drc_violations, erc_errors, render_pcb, run
 
 PLAN = CopperMode.PLAN
 
-copper_pilot = CopperPilotAgent(workspace="esp32")
+copper_pilot = CopperPilotAgent(
+    workspace="esp32",
+    effort=CopperEffort.INTELLIGENCE,
+)
 
 run(copper_pilot, "Build me an ESP32 dev board.", PLAN)
 run(copper_pilot, "Let us build this plan.")
@@ -170,7 +180,8 @@ Deep Agent. The compatible `deepagents` runtime is installed and pinned by this
 package.
 
 That snippet is the runnable example in
-[`examples/001_esp32`](examples/001_esp32).
+[`examples/001_esp32`](examples/001_esp32). A phased CM5 camera carrier lives in
+[`examples/002_cm5_camera`](examples/002_cm5_camera).
 
 ## Security boundary
 

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/README.md

@@ -36,9 +36,9 @@ CopperPilot in your terminal: a thin, open-source client for CopperPilot electro
 
 ## Prerequisites
 
-- Python 3.12 or newer
+- Python 3.11 or newer
 - A [CopperPilot](https://copperpilot.ai) account for login
-- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32)
+- KiCad 10 on `PATH` only if you run [`examples/001_esp32`](examples/001_esp32) or [`examples/002_cm5_camera`](examples/002_cm5_camera)
 
 ## Install and run
 
@@ -56,12 +56,18 @@ copper-pilot ./my-board
 copper-pilot --resume
 copper-pilot threads list
 copper-pilot -n -m "Review this board" --json
+copper-pilot --mode plan --effort intelligence -m "Survey and plan this board"
 ```
 
 Both `copper-pilot` and `copper-pilot-cli` run the same program.
 `copper-pilot --help` lists flags; [docs/cli.md](docs/cli.md) is the full
 command reference.
 
+Balanced effort is the default. Paid-plan users can select Intelligence with
+`--effort intelligence` or interactive `/effort`. Intelligence uses
+server-owned survey subagents and shows their lifecycle through the existing
+Deep Agents task rows; Intelligence Plan turns survey before writing a plan.
+
 ## Use from Claude Code, Cursor, or Codex
 
 CopperPilot stays the electronics agent. Copy
@@ -96,13 +102,16 @@ the parent directory is mode `0700` and the file is mode `0600`.
 ## LangChain
 
 ```python
-from copper_pilot_cli.copper_protocol import CopperMode
+from copper_pilot_cli.copper_protocol import CopperEffort, CopperMode
 from copper_pilot_cli.langchain import CopperPilotAgent
 from helper import drc_violations, erc_errors, render_pcb, run
 
 PLAN = CopperMode.PLAN
 
-copper_pilot = CopperPilotAgent(workspace="esp32")
+copper_pilot = CopperPilotAgent(
+    workspace="esp32",
+    effort=CopperEffort.INTELLIGENCE,
+)
 
 run(copper_pilot, "Build me an ESP32 dev board.", PLAN)
 run(copper_pilot, "Let us build this plan.")
@@ -120,7 +129,8 @@ Deep Agent. The compatible `deepagents` runtime is installed and pinned by this
 package.
 
 That snippet is the runnable example in
-[`examples/001_esp32`](examples/001_esp32).
+[`examples/001_esp32`](examples/001_esp32). A phased CM5 camera carrier lives in
+[`examples/002_cm5_camera`](examples/002_cm5_camera).
 
 ## Security boundary
 

copper_pilot_cli-0.1.8/VERSION

@@ -0,0 +1 @@
+0.1.8

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/docs/cli.md

@@ -9,7 +9,7 @@ copper-pilot threads --help
 copper-pilot mcp --help
 ```
 
-Python 3.12 or newer is required. Install with `pip install copper-pilot-cli`.
+Python 3.11 or newer is required. Install with `pip install copper-pilot-cli`.
 
 ## Chat
 
@@ -30,6 +30,7 @@ valid.
 | `--no-stream` | Print the final assistant message after the run instead of streaming. |
 | `--json` | Emit JSON events (or a final JSON document with `--no-stream`). |
 | `--mode {agent,plan,ask}` | Hosted chat mode. Default: `agent`. |
+| `--effort {balanced,intelligence}` | Hosted effort. Default: `balanced`; Intelligence requires a paid plan. |
 | `-y`, `--auto-approve` | Auto approval: routine writes and known-safe shell still run; unknown actions prompt. |
 | `--yolo` | Permit local side effects without prompting. Must be set explicitly. |
 | `--version` | Print the package version. |
@@ -41,6 +42,7 @@ copper-pilot ./my-board
 copper-pilot --resume
 copper-pilot -n -m "Review this board" --json
 copper-pilot ./my-board --mode plan -m "Propose a power tree"
+copper-pilot ./my-board --mode plan --effort intelligence -m "Survey and plan the power tree"
 ```
 
 Headless mode is also used when `--message` is set and stdout is not a TTY.
@@ -60,15 +62,33 @@ write to stdout; the protocol owns it.
 | Tool | Role |
 |------|------|
 | `status` | Login state and discovered schematic/PCB paths. No hosted call. |
-| `ask` | `--mode ask`. Auto approval. Optional `thread_id`. |
-| `plan` | `--mode plan`. Auto approval. |
-| `run` | `--mode agent`. `approval` is `auto` (default) or `yolo`. |
-| `resume` | Continue `thread_id`. Same approval as `run`. |
+| `ask` | `--mode ask`. Auto approval. Optional `thread_id` and `effort`. |
+| `plan` | `--mode plan`. Auto approval. Optional `effort`. |
+| `run` | `--mode agent`. Optional `effort`; `approval` is `auto` (default) or `yolo`. |
+| `resume` | Continue `thread_id`. Optional `mode`, `effort`, and the same approval as `run`. |
 | `threads_list` | List threads for this workspace (`limit`, `all_workspaces`). |
 
 Workspace is the tool argument, else `CLAUDE_PROJECT_DIR`, else the process
 current directory. Manual approval is TUI-only. See [harness.md](harness.md).
 
+## Effort and Intelligence
+
+Balanced is the default. Intelligence is available on paid plans and lets the
+hosted parent run one to four survey subagents. Intelligence Plan turns survey
+before creating or revising a plan. Workers are server-owned, survey-only, and
+appear in the TUI through the existing Deep Agents task rows; they do not open
+nested chats or execute through the local tool broker.
+
+The interactive `/effort` command changes effort for the current thread.
+Resuming that thread restores it; a new thread starts Balanced. In headless
+text mode, worker state changes print as compact lines. `--json` retains raw
+`status_event` objects.
+
+Interactive clarification can offer suggested answers, custom text, or Skip
+and waits without a client timeout. Headless and MCP calls cannot present that
+UI, so an `ask_user_question` tool request is rejected with a clear error
+instead of guessing or auto-skipping.
+
 ## Auth
 
 ```console
@@ -118,6 +138,37 @@ searches run freely. Writes, edits, deletes, and shell commands are gated:
 
 `--yolo` wins over `--auto-approve`. Saved preferences never enable YOLO.
 
+## Usage limits
+
+The hosted service owns weekly and window usage. The CLI does not show raw
+token balances, sell credits, or complete checkout.
+
+Inside the interactive app, `/tokens` prints the current window as a
+percentage, the next refresh time, and any additional-usage state.
+`/tokens json` prints the member-safe API payload instead.
+
+A blocked turn stays readable in `--json` output. An error event uses `data`
+as an object:
+
+```json
+{
+  "type": "error",
+  "data": {
+    "message": "Usage limit reached.",
+    "code": "http_402",
+    "status": 402,
+    "block_reason": "weekly",
+    "can_purchase_overage": true,
+    "retryable": false
+  }
+}
+```
+
+`block_reason` is `window`, `weekly`, `cost_cap`, `busy`, or `billing` when
+the server sends one. A `busy` block and an ordinary rate limit use status
+`429` with `retryable: true`. `can_purchase_overage` only says whether the
+billing page can offer additional usage. The Textual UI prints `message`.
+
 ## Configuration
 
 | Setting | Location |

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/docs/development.md

@@ -21,7 +21,7 @@ See [UPSTREAM.md](../UPSTREAM.md) and [NOTICE](../NOTICE).
 
 ## Environment
 
-Python 3.12 or newer. From the repository root:
+Python 3.11 or newer. From the repository root:
 
 ```console
 python3 -m venv .venv
@@ -39,6 +39,12 @@ pip install -e ".[dev]"
 
 CI also runs `pip-audit`, `piplicenses` (fails on GPL/AGPL/UNKNOWN), a wheel
 build, and `copper-pilot --version` / `copper-pilot-cli --version`.
+Required CI covers every supported stable Python minor on Linux and the minimum
+supported minor on macOS and Windows. Python 3.15 is probed weekly, outside
+pull requests, by `.github/workflows/forward-python.yml`. When that scheduled
+run is green, add the `Programming Language :: Python :: 3.15` classifier, add
+3.15 to the required CI matrix, and retarget the scheduled probe at the next
+unreleased Python.
 
 ## Tests
 
@@ -50,6 +56,40 @@ build, and `copper-pilot --version` / `copper-pilot-cli --version`.
 
 Do not commit credentials, `.venv/`, or `dist/`.
 
+## Hosted protocol
+
+The client speaks protocol v1. Agent turns, and plan turns that carry plan
+context, use `/api/copperpilot/analyze/agent/ws`. Ask turns and plan turns
+without that context use `/api/copperpilot/analyze/chat/ws`.
+
+`make_chat_start` in `copper_protocol.py` bounds history before the socket
+send, matching the desktop harness:
+
+| Attempt | Message cap | History cap | Frame cap |
+|---------|-------------|-------------|-----------|
+| 1 | 64 KiB | 4 MiB | 12 MiB |
+| 2 | 32 KiB | 2 MiB | 8 MiB |
+| 3 | 8 KiB | 128 KiB | 8 MiB |
+| 4 | 4 KiB | 64 KiB | 8 MiB |
+
+History is kept newest-first. Inline `data:` attachments are replaced before
+the byte caps apply. A query or workspace snapshot that still cannot fit
+raises `ProtocolError` with `code="PAYLOAD_TOO_LARGE"`.
+
+A WebSocket `error` frame keeps `code`, `status`, `block_reason`,
+`can_purchase_overage`, and `retryable` on both `ProtocolError` and the
+`copper.error` event. Absent fields stay absent. The interactive UI and MCP
+`error` string use `public_message`; `--json` and the MCP event digest keep
+the object.
+
+Device login and the WebSocket `User-Agent` (`CopperPilot CLI/<version>`)
+read the installed package version. That version comes from `VERSION`.
+
+`POST /api/copperpilot/analyze/token_limits` is the account-usage read. It
+returns percentages and reset state even when chat is blocked. Do not add
+token counts, plan allocations, Stripe checkout, or a per-chat context meter
+here. The server does not expose those on this contract.
+
 ## Release
 
 Version is the contents of [`VERSION`](../VERSION). `make release` writes that

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/docs/harness.md

@@ -32,7 +32,8 @@ copper-pilot -n -m "Review this board" --json --no-stream --mode ask
 next turn can pass `--resume THREAD_ID`.
 
 Use `--mode plan` for a plan, `--mode agent -y` for Auto local writes, and
-`--yolo` only when the user asked to skip local approval.
+`--yolo` only when the user asked to skip local approval. Add
+`--effort intelligence` for a paid Intelligence turn; Balanced is the default.
 
 ## Option 2: MCP conductor (`copper-pilot mcp`)
 
@@ -82,10 +83,10 @@ Point the host at `copper-pilot mcp` on stdio. Tools:
 | Tool | Role |
 |------|------|
 | `status` | Login state and discovered schematic/PCB paths |
-| `ask` | Read-oriented specialist (`--mode ask`) |
-| `plan` | Plan without applying (`--mode plan`) |
-| `run` | Mutating agent turn (`--mode agent`) |
-| `resume` | Continue `thread_id` (`mode` defaults to `agent`; pass `mode="ask"` to keep it read-only) |
+| `ask` | Read-oriented specialist (`--mode ask`); optional `effort` |
+| `plan` | Plan without applying (`--mode plan`); optional `effort` |
+| `run` | Mutating agent turn (`--mode agent`); optional `effort` |
+| `resume` | Continue `thread_id` (`mode` defaults to `agent`; optional `effort`) |
 | `threads_list` | List threads for this workspace |
 
 Workspace is the tool `workspace` argument, else `CLAUDE_PROJECT_DIR`, else the
@@ -102,7 +103,18 @@ process current directory.
 MCP cannot show the TUI, so Manual is not available there. `ask` and `plan`
 always use Auto. `run` and `resume` default to Auto.
 
+`effort` is `balanced` (default) or `intelligence`. Intelligence requires a
+paid plan. It may run server-owned survey subagents; Plan turns survey before
+the parent writes a plan. Progress reports compact worker transitions and the
+result digest omits full worker output. If the hosted agent asks a clarification,
+MCP returns a clear rejection because it cannot present the interactive options
+and Skip UI; continue the returned `thread_id` in the terminal TUI to answer.
+
 Missing credentials: MCP tools return `login_required` and tell the user to run
 `copper-pilot auth login`. The server does not open a browser.
 
-See [docs/cli.md](cli.md) for the full command reference.
+A hosted usage block sets `ok` and `success` to false. `error` remains the
+server's public message. The matching digest entry keeps the structured
+`data` object (`status`, `code`, `block_reason`, `can_purchase_overage`, and
+`retryable` when the server sends them). Checkout stays on the CopperPilot
+billing page. See [docs/cli.md](cli.md).

copper_pilot_cli-0.1.8/examples/.gitignore

@@ -0,0 +1,14 @@
+.copperpilot/tmp/
+.copperpilot/references/
+.copperpilot/oracle/
+.copperpilot/skills/
+__pycache__/
+fp-info-cache
+*.kicad_prl
+*-backups/
+*.bak
+*.lck
+.history
+*.rpt
+generate_schematic.py
+build_pcb.py

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/examples/001_esp32/.copperpilot/TOOLS.md

@@ -2,4 +2,4 @@
 
 ## Standard Tooling
 - `kicad-cli 10.0.3`: Primary verification and netlist/export toolchain.
-- `Python 3.12+`: Local script execution and DRC/ERC summary processing.
+- `Python 3.11+`: Local script execution and DRC/ERC summary processing.

{copper_pilot_cli-0.1.6 → copper_pilot_cli-0.1.8}/examples/001_esp32/README.md

@@ -26,4 +26,4 @@ render_pcb("esp32.png")
 python examples/001_esp32/main.py
 ```
 
-Python 3.12, `pip install -e .`, `copper-pilot auth login`, and KiCad 10 on `PATH`.
+Python 3.11+, `pip install -e .`, `copper-pilot auth login`, and KiCad 10 on `PATH`.

copper_pilot_cli-0.1.8/examples/002_cm5_camera/.copperpilot/PLANS.md

@@ -0,0 +1,5 @@
+# Project Implementation Plans
+
+| Plan | Target | Status | Overview |
+| :--- | :--- | :--- | :--- |
+| [cm5-camera-carrier](plans/cm5-camera-carrier.plan.md) | CM5 Nano Camera Carrier | `open` | 55.0 x 40.0 mm 6-layer nano camera carrier for CM5 with onboard IMX219-D160, DF40 mezzanine, Mini-HDMI, DSI, USB-C, vertical USB-A, Micro SD, and 40-pin GPIO. |

copper_pilot_cli-0.1.8/examples/002_cm5_camera/.copperpilot/README.md

@@ -0,0 +1,33 @@
+# CM5 Nano Camera Carrier Project Index
+
+## Project Summary
+High-density nano camera carrier board for the Raspberry Pi Compute Module 5 (CM5). Integrates an onboard Sony IMX219-D160 image sensor, high-speed display/video outputs (Mini-HDMI, 15-pin DSI FPC), dual-role USB routing with FSUSB42UMX switch, power management, Micro SD storage, and a 40-pin GPIO header into an ultra-compact 55.0 x 40.0 mm footprint.
+
+## Key Specifications
+- **Dimensions**: 55.0 x 40.0 mm with 3.0 mm corner radii and 4x M2.5 mounting holes.
+- **Layer Stackup**: 6-layer controlled impedance stackup (100 ohm differential pairs for HDMI, CSI, DSI; 90 ohm differential pairs for USB).
+- **Compute Module Interface**: Dual 100-pin Hirose DF40 mezzanine connectors H1A/H1B for CM5 (5V in, 3.3V/1.8V out, GPIO, I2C/SPI/UART, MIPI CSI/DSI, HDMI, nRPIBOOT, RUN_PG, GLOBAL_EN).
+- **Onboard Camera**: IMX219-D160 with triple LDOs:
+  - RT9193-28GB (VA2V8, 2.8V analog)
+  - RT9193-18GB (VO1V8, 1.8V I/O)
+  - RT9013-12 (VD1V2, 1.2V digital core)
+  - 24.000 MHz crystal oscillator through 22 ohm damping resistor to MCLK
+  - DMG1012T I2C level shift (3.3V to 1.8V)
+  - MCF1210BF2-900T01 common-mode noise filters on CAM0_D0, CAM0_D1, and CAM0_CLK
+- **Power Architecture**:
+  - USB-C power input into CM5_5V with 5.1 kOhm CC pulldown resistors
+  - MP1658GTF-Z synchronous step-down converter for PWR_3V3
+  - DIO7003HCST5 load switches for HDMI_5V and SD_3.3V
+  - STMPS2171STR power switch for USB_5V
+- **USB Subsystem**:
+  - FSUSB42UMX high-speed USB switch multiplexing USB0 between USB-C (rpiboot provisioning) and vertical USB-A (host peripheral), selected by USB_SEL jumper
+- **Peripherals & Indicators**:
+  - Mini-HDMI video output
+  - 15-pin 1.0 mm pitch DSI FPC connector
+  - Micro SD card slot (TF1)
+  - 40-pin standard GPIO header (PI1)
+  - User push-button Key1 connected to GPIO21
+  - Power (PWR) and Activity (ACT) LEDs
+
+## References
+- `cm5-minima-rev3`: Cloned and upgraded in-place to KiCad 10.0 under `.copperpilot/references/cm5-minima-rev3/`.