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

{copper_pilot_cli-0.1.8 → copper_pilot_cli-0.1.9}/HISTORY.md

@@ -4,6 +4,49 @@ Changelog
 
 (unreleased)
 ------------
+- Merge pull request #18 from CopperPilot/feat/acp-server. [Aditya]
+
+  feat: add `copper-pilot acp` Agent Client Protocol server
+- Fix(acp): surface hosted turn failures in the JSON-RPC error message.
+  [AdityaNG, Claude Fable 5.1]
+
+  T3 Code showed a bare "Internal error" for a prompt the hosted service
+  had refused with "Upgrade to a paid plan to use Intelligence." because the
+  explanation only lived in the error's `data`, which T3 does not display.
+  Carry the hosted message in the error `message` (keeping the code), map a
+  refused websocket handshake to auth_required when it is 401/403, log every
+  failed turn to the diagnostics log, and never let an unexpected exception
+  escape to the SDK's generic handler.
+- Fix(acp): accept `copper-pilot acp auth login` for clients that append
+  login args. [AdityaNG, Claude Fable 5.1]
+
+  T3 Code runs an ACP terminal auth method by appending the method's args to
+  the configured agent command, so the advertised `auth login` was spawned as
+  `copper-pilot acp auth login`. The acp parser rejected the extra arguments
+  with exit code 2 and T3 reported "The provider login command did not finish
+  successfully." Normalize `acp auth ...` onto `auth ...` before parsing and
+  document the alias.
+- Feat: add `copper-pilot acp` Agent Client Protocol server. [AdityaNG,
+  Claude Fable 5.1]
+
+  Serve the hosted CopperPilot agent over ACP stdio so editors such as Zed
+  can drive it with streaming messages, tool calls, permission prompts,
+  session modes (ask/plan/agent), an effort config option, session/load
+  resume of existing threads, and session/cancel.
+
+  - New copper_acp.py built directly on the agent-client-protocol SDK;
+    approvals and clarifying questions map onto session/request_permission.
+  - `acp` optional extra; the command prints an install hint without it.
+  - CI license gate ignores agent-client-protocol (Apache-2.0 LICENSE file,
+    no license metadata in the wheel).
+  - Tests: tests/test_acp.py (100% coverage of copper_acp.py, including a
+    real stdio JSON-RPC round trip), parser and entrypoint tests, and a
+    release-gate check for the extra.
+  - Docs: cli.md, harness.md (Zed setup), README.
+
+
+0.1.8 (2026-10-14)
+------------------
 
 Fix
 ~~~
@@ -19,6 +62,7 @@ Fix
 
 Other
 ~~~~~
+- Release: version 0.1.8 🚀 [AdityaNG]
 - Merge pull request #16 from CopperPilot/update/14_oct_2026. [Aditya]
 
   Add Intelligence effort, hosted survey workers, and modal keyboard focus

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: copper-pilot-cli
-Version: 0.1.8
+Version: 0.1.9
 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
@@ -37,7 +37,10 @@ Requires-Dist: rich<16,>=15
 Requires-Dist: textual<9,>=8.2.8
 Requires-Dist: uuid-utils<2,>=0.12
 Requires-Dist: websockets<18,>=15
+Provides-Extra: acp
+Requires-Dist: agent-client-protocol<1,>=0.12; extra == 'acp'
 Provides-Extra: dev
+Requires-Dist: agent-client-protocol<1,>=0.12; extra == 'dev'
 Requires-Dist: build<2,>=1.4; extra == 'dev'
 Requires-Dist: gitchangelog==3.0.4; extra == 'dev'
 Requires-Dist: pip-audit<3,>=2.10; extra == 'dev'
@@ -137,8 +140,9 @@ Claude Code can also install the in-repo plugin:
 ```
 
 That plugin starts `copper-pilot mcp` and adds `@copper-pilot` plus
-`/copper-pilot-review`. Setup for Cursor, Codex, and approvals:
-[docs/harness.md](docs/harness.md).
+`/copper-pilot-review`. Editors that speak the Agent Client Protocol, such as
+Zed, can run `copper-pilot acp` after `pip install "copper-pilot-cli[acp]"`.
+Setup for Cursor, Codex, Zed, and approvals: [docs/harness.md](docs/harness.md).
 
 ## Configuration
 
@@ -197,7 +201,8 @@ normalizes hosted tool names, approval decisions, and result envelopes.
 Computer use, model/provider selection, local model execution, LangSmith
 tracing, content telemetry, MCP **host**/plugin-runtime controls, and server
 implementation code are not part of this package. A thin MCP **server**
-(`copper-pilot mcp`) that delegates to the hosted agent is.
+(`copper-pilot mcp`) and an ACP **server** (`copper-pilot acp`) that delegate
+to the hosted agent are.
 
 See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
 client attribution.

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

@@ -86,8 +86,9 @@ Claude Code can also install the in-repo plugin:
 ```
 
 That plugin starts `copper-pilot mcp` and adds `@copper-pilot` plus
-`/copper-pilot-review`. Setup for Cursor, Codex, and approvals:
-[docs/harness.md](docs/harness.md).
+`/copper-pilot-review`. Editors that speak the Agent Client Protocol, such as
+Zed, can run `copper-pilot acp` after `pip install "copper-pilot-cli[acp]"`.
+Setup for Cursor, Codex, Zed, and approvals: [docs/harness.md](docs/harness.md).
 
 ## Configuration
 
@@ -146,7 +147,8 @@ normalizes hosted tool names, approval decisions, and result envelopes.
 Computer use, model/provider selection, local model execution, LangSmith
 tracing, content telemetry, MCP **host**/plugin-runtime controls, and server
 implementation code are not part of this package. A thin MCP **server**
-(`copper-pilot mcp`) that delegates to the hosted agent is.
+(`copper-pilot mcp`) and an ACP **server** (`copper-pilot acp`) that delegate
+to the hosted agent are.
 
 See [UPSTREAM.md](UPSTREAM.md) and [NOTICE](NOTICE) for the retained Textual
 client attribution.

copper_pilot_cli-0.1.9/VERSION

@@ -0,0 +1 @@
+0.1.9

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

@@ -7,6 +7,7 @@ copper-pilot --help
 copper-pilot auth --help
 copper-pilot threads --help
 copper-pilot mcp --help
+copper-pilot acp --help
 ```
 
 Python 3.11 or newer is required. Install with `pip install copper-pilot-cli`.
@@ -71,6 +72,34 @@ write to stdout; the protocol owns it.
 Workspace is the tool argument, else `CLAUDE_PROJECT_DIR`, else the process
 current directory. Manual approval is TUI-only. See [harness.md](harness.md).
 
+## ACP
+
+```console
+pip install "copper-pilot-cli[acp]"
+copper-pilot acp
+```
+
+Serves the Agent Client Protocol over stdio for editors such as Zed. The
+`acp` extra is optional; without it the command prints an install hint and
+exits with status 2. `copper-pilot acp auth login` is accepted as an alias for
+`copper-pilot auth login`, because some ACP clients (T3 Code) run the
+advertised login method by appending its arguments to the agent command. One ACP session is one CopperPilot thread, and the
+session `cwd` is the workspace. Uses the stored device-login credential and
+advertises a terminal auth method that runs `copper-pilot auth login`.
+
+| ACP feature | CopperPilot behavior |
+|-------------|----------------------|
+| Session modes | `ask`, `plan`, `agent` (default `agent`) |
+| Config options | `mode` and `effort` (`balanced` default, `intelligence` paid) |
+| `session/load` | Resumes an existing thread id and replays its history |
+| `session/request_permission` | Auto approval; non-routine writes and shell prompt the editor |
+| `session/cancel` | Cancels the hosted turn and local tools |
+
+"Allow all for this session" switches that session to YOLO until the server
+exits; it is never saved. Clarifying questions with options are shown as
+permission choices plus Skip; free-text questions are declined with a message
+to continue in the TUI. See [harness.md](harness.md).
+
 ## Effort and Intelligence
 
 Balanced is the default. Intelligence is available on paid plans and lets the

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

@@ -92,17 +92,73 @@ Point the host at `copper-pilot mcp` on stdio. Tools:
 Workspace is the tool `workspace` argument, else `CLAUDE_PROJECT_DIR`, else the
 process current directory.
 
+## Option 3: ACP server (`copper-pilot acp`)
+
+The Agent Client Protocol (ACP) lets editors drive an agent over stdio
+JSON-RPC with streaming messages, tool calls, and permission prompts. The SDK
+is an optional extra:
+
+```console
+pip install "copper-pilot-cli[acp]"
+```
+
+### Zed
+
+Add an external agent to Zed `settings.json`:
+
+```json
+{
+  "agent_servers": {
+    "CopperPilot": {
+      "command": "copper-pilot",
+      "args": ["acp"]
+    }
+  }
+}
+```
+
+Open the agent panel, pick CopperPilot, and chat. The project root is the
+workspace. The mode picker switches `ask`, `plan`, and `agent`; the `effort`
+option selects Balanced or Intelligence. If no credential is stored the server
+answers `auth_required` and offers a terminal login method that runs
+`copper-pilot auth login`.
+
+### Other ACP clients
+
+Launch `copper-pilot acp` on stdio. The server implements `initialize`,
+`authenticate`, `session/new`, `session/load`, `session/set_mode`,
+`session/set_config_option`, `session/prompt`, and `session/cancel`.
+`session/load` takes an existing CopperPilot thread id (see
+`copper-pilot threads list`) and replays its messages and tool calls.
+
+`initialize` advertises one terminal auth method whose arguments are
+`auth login`. Clients that run it as a standalone command get
+`copper-pilot auth login`; clients that append it to the agent command, such as
+T3 Code, get `copper-pilot acp auth login`, which the CLI treats the same way.
+
+Hosted text, reasoning, and status arrive as agent message and thought chunks;
+hosted tool requests and results arrive as `tool_call` and `tool_call_update`.
+A hosted error ends the prompt with a JSON-RPC error whose `details` carry the
+public message.
+
 ## Approval
 
 | Mode | Where | Behavior |
 |------|-------|----------|
 | Manual | Interactive CLI / TUI only | Prompt before gated writes and shell |
-| Auto | Harness default (`-y`, MCP `approval=auto`) | Routine writes and known-safe shell |
-| YOLO | Explicit `--yolo` or MCP `approval=yolo` | All local side effects. Never saved |
+| Auto | Harness default (`-y`, MCP `approval=auto`, ACP sessions) | Routine writes and known-safe shell |
+| YOLO | Explicit `--yolo`, MCP `approval=yolo`, or ACP "Allow all for this session" | All local side effects. Never saved |
 
 MCP cannot show the TUI, so Manual is not available there. `ask` and `plan`
 always use Auto. `run` and `resume` default to Auto.
 
+ACP sessions start in Auto. Anything Auto would have prompted for in the TUI
+is sent to the editor as `session/request_permission` with Allow, Allow all
+for this session, and Reject. Choosing "Allow all" puts that session in YOLO
+until the server exits. Hosted clarifying questions that offer options are
+presented the same way, with a Skip choice; free-text questions are declined
+with a pointer to the TUI.
+
 `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

{copper_pilot_cli-0.1.8 → copper_pilot_cli-0.1.9}/pyproject.toml

@@ -42,7 +42,11 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
+acp = [
+  "agent-client-protocol>=0.12,<1",
+]
 dev = [
+  "agent-client-protocol>=0.12,<1",
   "build>=1.4,<2",
   "gitchangelog==3.0.4",
   "pip-audit>=2.10,<3",