Cannot enable acp with `deepagents-cli`

[toniher]

Checked other resources

• This is a bug, not a usage question.
• I added a clear and descriptive title.
• I searched existing issues and didn't find this.
• I can reproduce this with the latest released version.
• I included a minimal reproducible example and steps to reproduce.

Area (Required)

• deepagents (SDK)
• cli
• acp
• evals
• harbor
• repl
• daytona
• modal
• quickjs
• runloop
• langsmith-sandbox
• Other / not sure / general

Related Issues / PRs

No response

Reproduction Steps / Example Code (Python)

uv tool install deepagents-cli --with deepagents-acp

Error Message and Stack Trace (if applicable)

🕙  19:21:24  ➜ deepagents --acp
ACP dependencies not available: cannot import name 'SessionConfigOption' from 'acp.schema' (/home/toniher/.local/share/uv/tools/deepagents-cli/lib/python3.13/site-packages/acp/schema.py)
Install with: pip install deepagents-acp

Description

Despite using with as pointed above, it cannot find deepagents-acp.
However, the file: /home/toniher/.local/share/uv/tools/deepagents-cli/lib/python3.13/site-packages/acp/schema.py does exist
It prompts you to install deepagents-acp via pip, but I think it makes no sense.

Environment / System Info

OS: Ubuntu 24.04
Python: provided by uv, here 3.13

[mishazawa]

For me error disappears after installing previous version of deepagents-acp

uv add "deepagents-acp==0.0.4"

[ethan6188]

Hi Mason Daugherty (@mdrxy) Eugene Yurtsev (@eyurtsev), I'd like to work on this. Could you please assign it to me?

Root cause analysis:

agent-client-protocol v0.9.0 (released 2026-03-26) upgraded the ACP schema from v0.10.8 to v0.11.2 (agentclientprotocol/python-sdk#80). This removed the SessionConfigOption wrapper type — config options are now bare SessionConfigOptionSelect / SessionConfigOptionBoolean instances.

Since deepagents-acp pins agent-client-protocol>=0.8.0 (no upper bound), uv/pip resolves to v0.9.0 which breaks from acp.schema import SessionConfigOption at import time. The CLI's broad except ImportError in main.py:1291 catches it and prints the misleading "ACP dependencies not available" message.

Proposed fix:

Use a conditional import in libs/acp/deepagents_acp/server.py to support both v0.8.x (with SessionConfigOption wrapper) and v0.9.0+ (without wrapper):

try:
    from acp.schema import SessionConfigOption
except ImportError:
    SessionConfigOption = None

Then construct config options as bare SessionConfigOptionSelect(...) when the wrapper is unavailable. I've verified all 76 existing ACP tests pass with this approach.