deep-agent-cli 0.1.3__tar.gz → 0.1.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/PKG-INFO +76 -21
  2. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/README.md +72 -20
  3. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/app.py +32 -14
  4. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/interactions.py +26 -9
  5. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/main.py +19 -5
  6. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/state.py +4 -2
  7. deep_agent_cli-0.1.5/agent/config.example.yaml +147 -0
  8. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/config.py +35 -25
  9. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/factory.py +2 -0
  10. deep_agent_cli-0.1.5/agent/llm.py +393 -0
  11. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/attachments.py +2 -2
  12. deep_agent_cli-0.1.5/agent/middleware/usage.py +29 -0
  13. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/runner.py +79 -13
  14. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/sandbox_worker.py +8 -9
  15. deep_agent_cli-0.1.5/agent/server/__init__.py +1 -0
  16. deep_agent_cli-0.1.5/agent/server/app.py +181 -0
  17. deep_agent_cli-0.1.5/agent/server/config.py +88 -0
  18. deep_agent_cli-0.1.5/agent/server/main.py +29 -0
  19. deep_agent_cli-0.1.5/agent/server/runtime.py +270 -0
  20. deep_agent_cli-0.1.5/agent/server/store.py +157 -0
  21. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/stream.py +10 -0
  22. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/human_interaction.py +12 -0
  23. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/pyproject.toml +2 -1
  24. deep_agent_cli-0.1.3/agent/config.example.yaml +0 -168
  25. deep_agent_cli-0.1.3/agent/llm.py +0 -391
  26. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/.gitignore +0 -0
  27. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/LICENSE +0 -0
  28. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/__init__.py +0 -0
  29. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/attachments.py +0 -0
  30. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/bootstrap.py +0 -0
  31. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cancel.py +0 -0
  32. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/__init__.py +0 -0
  33. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/clipboard.py +0 -0
  34. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/commands.py +0 -0
  35. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/gitinfo.py +0 -0
  36. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/input.py +0 -0
  37. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/pasted_content.py +0 -0
  38. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/previews.py +0 -0
  39. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/rendering.py +0 -0
  40. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/session_controller.py +0 -0
  41. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/skills.py +0 -0
  42. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/working_messages.py +0 -0
  43. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/cli/working_messages.yaml +0 -0
  44. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/control.py +0 -0
  45. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/file_mutation.py +0 -0
  46. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/__init__.py +0 -0
  47. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/cancel_tools.py +0 -0
  48. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/pause.py +0 -0
  49. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/recovery.py +0 -0
  50. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/runtime_config.py +0 -0
  51. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/steering.py +0 -0
  52. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/tool_arg_hints.py +0 -0
  53. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/workspace_filesystem.py +0 -0
  54. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/middleware/write_operation.py +0 -0
  55. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/network.py +0 -0
  56. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/permission.py +0 -0
  57. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/sandbox.py +0 -0
  58. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/sandbox_pool.py +0 -0
  59. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/session.py +0 -0
  60. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/session_lock.py +0 -0
  61. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/session_runtime.py +0 -0
  62. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/__init__.py +0 -0
  63. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/examples.py +0 -0
  64. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/execute.py +0 -0
  65. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/human_input.py +0 -0
  66. {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.5}/agent/tools/web_search.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: deep-agent-cli
3
- Version: 0.1.3
3
+ Version: 0.1.5
4
4
  Summary: A sandboxed coding agent CLI for Linux and WSL2
5
5
  License-Expression: MIT
6
6
  License-File: LICENSE
@@ -24,13 +24,16 @@ Provides-Extra: dev
24
24
  Requires-Dist: build<2,>=1.2; extra == 'dev'
25
25
  Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
26
26
  Requires-Dist: twine<7,>=6; extra == 'dev'
27
+ Provides-Extra: server
28
+ Requires-Dist: fastapi<1,>=0.115; extra == 'server'
29
+ Requires-Dist: uvicorn<1,>=0.30; extra == 'server'
27
30
  Description-Content-Type: text/markdown
28
31
 
29
32
  # deep-agent-cli
30
33
 
31
34
  `deep-agent` 是一个在终端中运行的 Coding Agent,支持 Linux 和 WSL2。它把启动时所在的目录作为工作区,调用你配置的 OpenAI 兼容模型服务,并在 [Bubblewrap](https://github.com/containers/bubblewrap) 沙箱中执行命令。Agent 运行时基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 构建。
32
35
 
33
- 当前版本 0.1.3,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
36
+ 当前版本 0.1.5,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
34
37
 
35
38
  ## 功能
36
39
 
@@ -46,6 +49,7 @@ Description-Content-Type: text/markdown
46
49
  - **上下文压缩**:接近模型上下文窗口时自动摘要旧对话,也可以手动压缩。
47
50
  - **技能**:从 `~/.deep-agent/skills/` 加载 Skills,通过 `/skill` 选择技能并附带任务说明,支持读取技能目录中的参考文件。
48
51
  - **可选扩展**:配置 Tavily API key 后可以搜索公开网页;读取工作区根目录的 `AGENTS.md` 作为项目说明。
52
+ - **HTTP 后端服务**:通过可选 `server` 依赖提供后台任务、SSE 进度、会话恢复和系统界面审批,见 [后端接入](docs/server.md)。
49
53
 
50
54
  ## 运行要求
51
55
 
@@ -89,27 +93,24 @@ deep-agent
89
93
 
90
94
  ```yaml
91
95
  llm:
92
- default: local/main # 启动时使用的模型:来源/模型键
96
+ default: token-plan/qwen3.8-flash
93
97
  models:
94
- local: # 来源名,自定义
95
- base_url: http://localhost:8000/v1
96
- api_key: ${MY_API_KEY} # 也可以直接写密钥
97
- provider: openai-compatible # 端点支持 Responses API 时可改为 qwen-responses
98
- stream_usage: true
99
- reasoning_efforts: [none, low, medium, high] # 来源级列表,见下文
98
+ token-plan:
99
+ base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
100
+ api_key: ${TOKEN_PLAN_API_KEY}
101
+ api: chat_completions
102
+ reasoning_efforts: [none, low, medium, xhigh]
100
103
  models:
101
- main: # 模型键,自定义
102
- model: your-model-name # 发给服务端的模型名
103
- context_window: 128k
104
- input: [text] # 支持图片时写 [text, image]
105
- fast: {} # 省略的字段全部继承来源
106
- other:
107
- reasoning_efforts: [low, high] # 写了就完整替换来源列表
104
+ qwen3.8-flash:
105
+ input: [text, image]
106
+ context_window: 1m
108
107
  ```
109
108
 
110
109
  模型按「来源」分组。来源下可以写的字段,模型项中也都可以写:模型项省略则继承来源,写了就覆盖。列表字段(`input`、`reasoning_efforts`)是整表替换,不是合并;`reasoning_efforts` 写成 `null` 或 `[]` 会清除继承。
111
110
 
112
- `provider` 未填写时默认为 `qwen-responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `openai-compatible`。
111
+ `api` 未填写时默认为 `responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `chat_completions`。
112
+
113
+ 配置只接受 `api: responses/chat_completions`;`provider`、`stream_usage` 已移除,出现时直接报错。Chat Completions 固定请求 usage。右下角 Context 仅显示最近一次 API 返回的输入 token 占用,缺失时显示 `Unknown`,不做估算。
113
114
 
114
115
  `reasoning_efforts` 需要按服务商文档填写,程序不会自动探测。常见取值包括 `none`、`low`、`medium`、`high`、`xhigh`、`max`,同一模型在不同端点上可能不同。列表非空时,`/model` 只显示这些值,默认选中第一项;空列表或未配置时只显示 `default`,请求不携带强度参数。`default` 是 CLI 选项,不能写进列表。`none` 仅在端点明确支持关闭思考时才写;`low` 仍然会思考。Chat Completions 发送 `reasoning_effort`,Responses API 发送 `reasoning.effort`。
115
116
 
@@ -229,6 +230,8 @@ ls -R ~/.deep-agent/skills/playwright-cli
229
230
 
230
231
  加载技能只提供操作说明。工具链要在宿主机装好,再通过沙箱挂载暴露给命令。沙箱不能 `sudo` 或 `apt-get`,所以不要在里面执行 `npx playwright install chrome`。
231
232
 
233
+ `network=false` 使用 Bubblewrap 的独立网络命名空间(`--unshare-net`),限制本次命令及子进程直接访问 IP 网络;不保证完全没有间接联网。例如有网后台服务在共享 `/workspace` 创建 Unix Socket,无网命令通过它请求服务代为联网;共享文件或 FIFO 也可形成类似通路。这是已知隔离边界,不是沙箱逃逸,也不表示本轮已修复。见 [网络边界](docs/sandbox.md#网络)。
234
+
232
235
  ### 沙箱里的工具链
233
236
 
234
237
  首次启动时,[`agent/config.example.yaml`](agent/config.example.yaml) 会复制成 `~/.deep-agent/config.yaml`。其中的 `sandbox` 段已经是默认工具链配置:`PATH` 包含 Node.js 和 Cargo,并挂载下面这些目录。`optional: true` 的源目录在宿主机上不存在时会被跳过,不会阻止启动。
@@ -238,13 +241,64 @@ ls -R ~/.deep-agent/skills/playwright-cli
238
241
  | `~/.nvm/versions/node/v22.23.2` | `/opt/node` | 只读 | `node`、`npm`、`playwright-cli` |
239
242
  | `~/.cargo` | `/opt/cargo` | 只读 | Rust 工具链 |
240
243
  | `/opt/google` | `/opt/google` | 只读 | 系统 Chrome。`playwright-cli open` 使用 `/opt/google/chrome/chrome` |
241
- | `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
244
+ | `/mnt/wslg/.X11-unix` | `/tmp/.X11-unix` | 只读 | WSLg 的 X11 文件 socket,供有头浏览器连接宿主显示服务 |
245
+ | `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | CLI 版本对应的 Chromium / Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
242
246
 
243
247
  Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模板不一致时改 `source`。其他装在 `~/.local`、`/opt` 或家目录里的程序同样处理:用 `readlink -f "$(command -v 工具名)"` 找到落在 `/usr`、`/bin`、`/lib` 之外的目录,按同样格式追加挂载,并把可执行文件所在目录加到 `PATH` 前面。`PATH` 会替换沙箱默认值,末尾保留 `/usr/local/bin:/usr/bin:/bin`。
244
248
 
245
- `playwright-cli open` 走系统 Chrome,不读浏览器缓存。没有系统 Chrome 时,在宿主机执行 `npx playwright install chromium`(先保证 `~/.cache/ms-playwright` 存在),沙箱里再用 `playwright-cli open --browser=chromium`。缓存目录可写,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器时,把该项改到 `extra_read_only_mounts`。下载浏览器的命令需要网络。
249
+ `playwright-cli open` 默认走系统 Chrome(通常位于 `/opt/google/chrome/chrome`),而 `playwright-cli open --browser=chromium` 选择 CLI 依赖版本对应的缓存 Chromium。没有系统 Chrome 时,先在宿主机查看当前版本的帮助,再安装浏览器:
250
+
251
+ ```bash
252
+ playwright-cli install-browser --help
253
+ playwright-cli install-browser chromium
254
+ ```
255
+
256
+ 不要用独立的 `npx playwright install chromium` 代替:它可能解析到另一版 Playwright,下载的浏览器修订号与 CLI 查找的缓存目录不同。命令以实际安装的 CLI 帮助为准;本轮核对的 CLI 0.1.22 支持上述命令(包括 `--dry-run`),不要求锁定项目 Node 或 Playwright 版本。缓存目录可写时,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器且需要只读缓存时,先从 `extra_read_write_mounts` 移除该项,再加入 `extra_read_only_mounts`,不要在两个列表中重复配置同一目标。下载浏览器需要网络,由用户在宿主机完成。
257
+
258
+ Node 本体也可以来自系统 `/usr/bin/node`。若 CLI 和 npm 包安装在自定义 npm prefix(例如 `npm config get prefix` 返回 `~/.local`),必须挂载整个 prefix,而不只是它的 `bin` 目录,再调整 `PATH`。系统 Node 已在默认只读系统目录内,无需 nvm:
259
+
260
+ ```yaml
261
+ sandbox:
262
+ extra_read_only_mounts:
263
+ - source: ~/.local # 替换为本机 npm prefix
264
+ destination: /opt/npm-prefix
265
+ env_set:
266
+ PATH: /opt/npm-prefix/bin:/usr/local/bin:/usr/bin:/bin
267
+ PLAYWRIGHT_BROWSERS_PATH: /opt/ms-playwright
268
+ ```
269
+
270
+ 此示例只新增 npm prefix 挂载;浏览器缓存沿用默认模板中的 `extra_read_write_mounts`,目标仍为 `/opt/ms-playwright`,不要重复添加。
271
+
272
+ 使用系统 Chrome 时保留 `/opt/google` 的只读挂载。系统目录以外的 Node 本体则需要另行只读挂载,并把其 `bin` 加到 `PATH`。
273
+
274
+ 有头模式需要宿主提供 X Server、传入 `DISPLAY`,并让沙箱访问显示 socket。默认模板已允许 `DISPLAY`,并可选挂载 WSLg 的 `/mnt/wslg/.X11-unix` 到沙箱 `/tmp/.X11-unix`。在 WSLg 环境中可直接复用现有显示服务,无需另装 Xvfb。启动 `deep-agent` 的终端必须已有正确的 `DISPLAY`(WSLg 通常为 `:0`)。
275
+
276
+ 已有配置请合并以下内容,保留其他环境变量和挂载:
277
+
278
+ ```yaml
279
+ sandbox:
280
+ env_allowlist:
281
+ - DISPLAY
282
+ extra_read_only_mounts:
283
+ - source: /mnt/wslg/.X11-unix
284
+ destination: /tmp/.X11-unix
285
+ optional: true
286
+ ```
287
+
288
+ 保存后退出并重新启动 `deep-agent`,让新沙箱加载配置,再执行 `playwright-cli open about:blank --headed`。已在 WSLg 下实测 `network=false` 的有头启动、页面截图及关闭成功;访问互联网页面仍需要声明 `network=true`,ask 模式需审批。此配置允许沙箱连接宿主 X Server,不改变 IP 网络或 IPC 隔离。
289
+
290
+ 普通 Linux X11 桌面可把挂载源改为 `/tmp/.X11-unix`。仅使用 X11 抽象 socket 时,无网沙箱无法访问宿主网络命名空间中的该 socket,需要有网沙箱。Xauthority 认证可能需要传入 `XAUTHORITY` 并挂载对应认证文件,该场景未验证;原生 Wayland 连接也未验证,WSLg 此处使用的是 X11。
291
+
292
+ 保留 Bubblewrap 的 `--unshare-ipc`。用户提供的真实机器 A/B 验证表明,在专用 Xvfb 关闭 MIT-SHM 可以稳定渲染,无需添加 Chrome 启动参数:
293
+
294
+ ```bash
295
+ Xvfb :2 -screen 0 1600x900x24 -extension MIT-SHM
296
+ # 启动 deep-agent 前设置 DISPLAY=:2,并在 env_allowlist 中允许 DISPLAY
297
+ ```
298
+
299
+ Xvfb 示例仅适用于宿主没有现成显示服务的情况;CLI 不会自动安装 Node、浏览器或 Xvfb。有头渲染必须通过实际 X 窗口截图核验;读取 title、DOM 或看到窗口存在不足以证明渲染成功。详细 A/B 结果和挂载说明见 [docs/sandbox.md](docs/sandbox.md#playwright-与有头-x11)。Playwright CLI 可能生成 `.playwright-cli/`,建议在自己的项目 `.gitignore` 中忽略它;程序不会自动修改 `.gitignore`。
246
300
 
247
- 已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
301
+ 已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_allowlist`、`sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
248
302
 
249
303
  ## 安全模型
250
304
 
@@ -267,7 +321,7 @@ Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模
267
321
  - 文件工具在 `deep-agent` 进程中直接读写宿主文件,不经过沙箱,路径限定在工作区和 Skills 目录内。工作区里的所有内容 Agent 都能读写,包括 `.git/` 和 `.env`。
268
322
  - 程序会在工作区中创建 `.deep-agent/`(命令输出超限时的日志)和 `.deepagents/`(上下文压缩时保存的历史),但不会修改 `.gitignore`。
269
323
  - 不能在家目录或其上层目录启动,因为配置目录 `~/.deep-agent` 必须位于工作区之外。
270
- - 只能在交互式终端中使用,没有非交互或批处理模式。
324
+ - CLI 需要交互式终端;非交互调用使用可选的 [HTTP 服务](docs/server.md)。
271
325
  - 模型请求和 Tavily 请求不读取 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 等代理环境变量。
272
326
  - 从剪贴板粘贴图片只支持 WSL;其他环境需要通过文件路径添加图片。
273
327
  - 推理强度的可选值需要按服务商文档手动配置,程序不会自动探测。
@@ -280,6 +334,7 @@ Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模
280
334
  - [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md):隔离范围、网络、日志、Ubuntu / WSL2 排查
281
335
  - [终端界面](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/tui.md):命令、快捷键、图片、会话、显示规则
282
336
  - [作为 Python 库使用](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/library.md):`AgentRunner`、事件、自定义工具
337
+ - [HTTP 后端服务](docs/server.md):部署、接口、任务与事件、审批和现有系统接入
283
338
  - [架构](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/architecture.md):分层、中间件、会话存储、上下文压缩
284
339
  - [开发](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/development.md):测试、冒烟脚本、CI 与发布
285
340
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  `deep-agent` 是一个在终端中运行的 Coding Agent,支持 Linux 和 WSL2。它把启动时所在的目录作为工作区,调用你配置的 OpenAI 兼容模型服务,并在 [Bubblewrap](https://github.com/containers/bubblewrap) 沙箱中执行命令。Agent 运行时基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 构建。
4
4
 
5
- 当前版本 0.1.3,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
5
+ 当前版本 0.1.5,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
6
6
 
7
7
  ## 功能
8
8
 
@@ -18,6 +18,7 @@
18
18
  - **上下文压缩**:接近模型上下文窗口时自动摘要旧对话,也可以手动压缩。
19
19
  - **技能**:从 `~/.deep-agent/skills/` 加载 Skills,通过 `/skill` 选择技能并附带任务说明,支持读取技能目录中的参考文件。
20
20
  - **可选扩展**:配置 Tavily API key 后可以搜索公开网页;读取工作区根目录的 `AGENTS.md` 作为项目说明。
21
+ - **HTTP 后端服务**:通过可选 `server` 依赖提供后台任务、SSE 进度、会话恢复和系统界面审批,见 [后端接入](docs/server.md)。
21
22
 
22
23
  ## 运行要求
23
24
 
@@ -61,27 +62,24 @@ deep-agent
61
62
 
62
63
  ```yaml
63
64
  llm:
64
- default: local/main # 启动时使用的模型:来源/模型键
65
+ default: token-plan/qwen3.8-flash
65
66
  models:
66
- local: # 来源名,自定义
67
- base_url: http://localhost:8000/v1
68
- api_key: ${MY_API_KEY} # 也可以直接写密钥
69
- provider: openai-compatible # 端点支持 Responses API 时可改为 qwen-responses
70
- stream_usage: true
71
- reasoning_efforts: [none, low, medium, high] # 来源级列表,见下文
67
+ token-plan:
68
+ base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
69
+ api_key: ${TOKEN_PLAN_API_KEY}
70
+ api: chat_completions
71
+ reasoning_efforts: [none, low, medium, xhigh]
72
72
  models:
73
- main: # 模型键,自定义
74
- model: your-model-name # 发给服务端的模型名
75
- context_window: 128k
76
- input: [text] # 支持图片时写 [text, image]
77
- fast: {} # 省略的字段全部继承来源
78
- other:
79
- reasoning_efforts: [low, high] # 写了就完整替换来源列表
73
+ qwen3.8-flash:
74
+ input: [text, image]
75
+ context_window: 1m
80
76
  ```
81
77
 
82
78
  模型按「来源」分组。来源下可以写的字段,模型项中也都可以写:模型项省略则继承来源,写了就覆盖。列表字段(`input`、`reasoning_efforts`)是整表替换,不是合并;`reasoning_efforts` 写成 `null` 或 `[]` 会清除继承。
83
79
 
84
- `provider` 未填写时默认为 `qwen-responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `openai-compatible`。
80
+ `api` 未填写时默认为 `responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `chat_completions`。
81
+
82
+ 配置只接受 `api: responses/chat_completions`;`provider`、`stream_usage` 已移除,出现时直接报错。Chat Completions 固定请求 usage。右下角 Context 仅显示最近一次 API 返回的输入 token 占用,缺失时显示 `Unknown`,不做估算。
85
83
 
86
84
  `reasoning_efforts` 需要按服务商文档填写,程序不会自动探测。常见取值包括 `none`、`low`、`medium`、`high`、`xhigh`、`max`,同一模型在不同端点上可能不同。列表非空时,`/model` 只显示这些值,默认选中第一项;空列表或未配置时只显示 `default`,请求不携带强度参数。`default` 是 CLI 选项,不能写进列表。`none` 仅在端点明确支持关闭思考时才写;`low` 仍然会思考。Chat Completions 发送 `reasoning_effort`,Responses API 发送 `reasoning.effort`。
87
85
 
@@ -201,6 +199,8 @@ ls -R ~/.deep-agent/skills/playwright-cli
201
199
 
202
200
  加载技能只提供操作说明。工具链要在宿主机装好,再通过沙箱挂载暴露给命令。沙箱不能 `sudo` 或 `apt-get`,所以不要在里面执行 `npx playwright install chrome`。
203
201
 
202
+ `network=false` 使用 Bubblewrap 的独立网络命名空间(`--unshare-net`),限制本次命令及子进程直接访问 IP 网络;不保证完全没有间接联网。例如有网后台服务在共享 `/workspace` 创建 Unix Socket,无网命令通过它请求服务代为联网;共享文件或 FIFO 也可形成类似通路。这是已知隔离边界,不是沙箱逃逸,也不表示本轮已修复。见 [网络边界](docs/sandbox.md#网络)。
203
+
204
204
  ### 沙箱里的工具链
205
205
 
206
206
  首次启动时,[`agent/config.example.yaml`](agent/config.example.yaml) 会复制成 `~/.deep-agent/config.yaml`。其中的 `sandbox` 段已经是默认工具链配置:`PATH` 包含 Node.js 和 Cargo,并挂载下面这些目录。`optional: true` 的源目录在宿主机上不存在时会被跳过,不会阻止启动。
@@ -210,13 +210,64 @@ ls -R ~/.deep-agent/skills/playwright-cli
210
210
  | `~/.nvm/versions/node/v22.23.2` | `/opt/node` | 只读 | `node`、`npm`、`playwright-cli` |
211
211
  | `~/.cargo` | `/opt/cargo` | 只读 | Rust 工具链 |
212
212
  | `/opt/google` | `/opt/google` | 只读 | 系统 Chrome。`playwright-cli open` 使用 `/opt/google/chrome/chrome` |
213
- | `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
213
+ | `/mnt/wslg/.X11-unix` | `/tmp/.X11-unix` | 只读 | WSLg 的 X11 文件 socket,供有头浏览器连接宿主显示服务 |
214
+ | `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | CLI 版本对应的 Chromium / Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
214
215
 
215
216
  Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模板不一致时改 `source`。其他装在 `~/.local`、`/opt` 或家目录里的程序同样处理:用 `readlink -f "$(command -v 工具名)"` 找到落在 `/usr`、`/bin`、`/lib` 之外的目录,按同样格式追加挂载,并把可执行文件所在目录加到 `PATH` 前面。`PATH` 会替换沙箱默认值,末尾保留 `/usr/local/bin:/usr/bin:/bin`。
216
217
 
217
- `playwright-cli open` 走系统 Chrome,不读浏览器缓存。没有系统 Chrome 时,在宿主机执行 `npx playwright install chromium`(先保证 `~/.cache/ms-playwright` 存在),沙箱里再用 `playwright-cli open --browser=chromium`。缓存目录可写,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器时,把该项改到 `extra_read_only_mounts`。下载浏览器的命令需要网络。
218
+ `playwright-cli open` 默认走系统 Chrome(通常位于 `/opt/google/chrome/chrome`),而 `playwright-cli open --browser=chromium` 选择 CLI 依赖版本对应的缓存 Chromium。没有系统 Chrome 时,先在宿主机查看当前版本的帮助,再安装浏览器:
219
+
220
+ ```bash
221
+ playwright-cli install-browser --help
222
+ playwright-cli install-browser chromium
223
+ ```
224
+
225
+ 不要用独立的 `npx playwright install chromium` 代替:它可能解析到另一版 Playwright,下载的浏览器修订号与 CLI 查找的缓存目录不同。命令以实际安装的 CLI 帮助为准;本轮核对的 CLI 0.1.22 支持上述命令(包括 `--dry-run`),不要求锁定项目 Node 或 Playwright 版本。缓存目录可写时,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器且需要只读缓存时,先从 `extra_read_write_mounts` 移除该项,再加入 `extra_read_only_mounts`,不要在两个列表中重复配置同一目标。下载浏览器需要网络,由用户在宿主机完成。
226
+
227
+ Node 本体也可以来自系统 `/usr/bin/node`。若 CLI 和 npm 包安装在自定义 npm prefix(例如 `npm config get prefix` 返回 `~/.local`),必须挂载整个 prefix,而不只是它的 `bin` 目录,再调整 `PATH`。系统 Node 已在默认只读系统目录内,无需 nvm:
228
+
229
+ ```yaml
230
+ sandbox:
231
+ extra_read_only_mounts:
232
+ - source: ~/.local # 替换为本机 npm prefix
233
+ destination: /opt/npm-prefix
234
+ env_set:
235
+ PATH: /opt/npm-prefix/bin:/usr/local/bin:/usr/bin:/bin
236
+ PLAYWRIGHT_BROWSERS_PATH: /opt/ms-playwright
237
+ ```
238
+
239
+ 此示例只新增 npm prefix 挂载;浏览器缓存沿用默认模板中的 `extra_read_write_mounts`,目标仍为 `/opt/ms-playwright`,不要重复添加。
240
+
241
+ 使用系统 Chrome 时保留 `/opt/google` 的只读挂载。系统目录以外的 Node 本体则需要另行只读挂载,并把其 `bin` 加到 `PATH`。
242
+
243
+ 有头模式需要宿主提供 X Server、传入 `DISPLAY`,并让沙箱访问显示 socket。默认模板已允许 `DISPLAY`,并可选挂载 WSLg 的 `/mnt/wslg/.X11-unix` 到沙箱 `/tmp/.X11-unix`。在 WSLg 环境中可直接复用现有显示服务,无需另装 Xvfb。启动 `deep-agent` 的终端必须已有正确的 `DISPLAY`(WSLg 通常为 `:0`)。
244
+
245
+ 已有配置请合并以下内容,保留其他环境变量和挂载:
246
+
247
+ ```yaml
248
+ sandbox:
249
+ env_allowlist:
250
+ - DISPLAY
251
+ extra_read_only_mounts:
252
+ - source: /mnt/wslg/.X11-unix
253
+ destination: /tmp/.X11-unix
254
+ optional: true
255
+ ```
256
+
257
+ 保存后退出并重新启动 `deep-agent`,让新沙箱加载配置,再执行 `playwright-cli open about:blank --headed`。已在 WSLg 下实测 `network=false` 的有头启动、页面截图及关闭成功;访问互联网页面仍需要声明 `network=true`,ask 模式需审批。此配置允许沙箱连接宿主 X Server,不改变 IP 网络或 IPC 隔离。
258
+
259
+ 普通 Linux X11 桌面可把挂载源改为 `/tmp/.X11-unix`。仅使用 X11 抽象 socket 时,无网沙箱无法访问宿主网络命名空间中的该 socket,需要有网沙箱。Xauthority 认证可能需要传入 `XAUTHORITY` 并挂载对应认证文件,该场景未验证;原生 Wayland 连接也未验证,WSLg 此处使用的是 X11。
260
+
261
+ 保留 Bubblewrap 的 `--unshare-ipc`。用户提供的真实机器 A/B 验证表明,在专用 Xvfb 关闭 MIT-SHM 可以稳定渲染,无需添加 Chrome 启动参数:
262
+
263
+ ```bash
264
+ Xvfb :2 -screen 0 1600x900x24 -extension MIT-SHM
265
+ # 启动 deep-agent 前设置 DISPLAY=:2,并在 env_allowlist 中允许 DISPLAY
266
+ ```
267
+
268
+ Xvfb 示例仅适用于宿主没有现成显示服务的情况;CLI 不会自动安装 Node、浏览器或 Xvfb。有头渲染必须通过实际 X 窗口截图核验;读取 title、DOM 或看到窗口存在不足以证明渲染成功。详细 A/B 结果和挂载说明见 [docs/sandbox.md](docs/sandbox.md#playwright-与有头-x11)。Playwright CLI 可能生成 `.playwright-cli/`,建议在自己的项目 `.gitignore` 中忽略它;程序不会自动修改 `.gitignore`。
218
269
 
219
- 已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
270
+ 已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_allowlist`、`sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
220
271
 
221
272
  ## 安全模型
222
273
 
@@ -239,7 +290,7 @@ Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模
239
290
  - 文件工具在 `deep-agent` 进程中直接读写宿主文件,不经过沙箱,路径限定在工作区和 Skills 目录内。工作区里的所有内容 Agent 都能读写,包括 `.git/` 和 `.env`。
240
291
  - 程序会在工作区中创建 `.deep-agent/`(命令输出超限时的日志)和 `.deepagents/`(上下文压缩时保存的历史),但不会修改 `.gitignore`。
241
292
  - 不能在家目录或其上层目录启动,因为配置目录 `~/.deep-agent` 必须位于工作区之外。
242
- - 只能在交互式终端中使用,没有非交互或批处理模式。
293
+ - CLI 需要交互式终端;非交互调用使用可选的 [HTTP 服务](docs/server.md)。
243
294
  - 模型请求和 Tavily 请求不读取 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 等代理环境变量。
244
295
  - 从剪贴板粘贴图片只支持 WSL;其他环境需要通过文件路径添加图片。
245
296
  - 推理强度的可选值需要按服务商文档手动配置,程序不会自动探测。
@@ -252,6 +303,7 @@ Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模
252
303
  - [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md):隔离范围、网络、日志、Ubuntu / WSL2 排查
253
304
  - [终端界面](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/tui.md):命令、快捷键、图片、会话、显示规则
254
305
  - [作为 Python 库使用](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/library.md):`AgentRunner`、事件、自定义工具
306
+ - [HTTP 后端服务](docs/server.md):部署、接口、任务与事件、审批和现有系统接入
255
307
  - [架构](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/architecture.md):分层、中间件、会话存储、上下文压缩
256
308
  - [开发](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/development.md):测试、冒烟脚本、CI 与发布
257
309
 
@@ -81,6 +81,7 @@ from agent.runner import AgentRunner, InterruptKind, RunEvent, RunResult, Unknow
81
81
  # Workspace/model and execution settings on the left; git/context on the right.
82
82
  FOOTER_LINES = 2
83
83
  INPUT_CLEARED_HINT = "Input cleared · press Ctrl+C again to exit"
84
+ CTRL_C_EXIT_WINDOW_SECONDS = 1.0
84
85
  STATUS_NOTICE_SECONDS = 1.0
85
86
 
86
87
 
@@ -98,10 +99,10 @@ def format_context_usage(usage: dict[str, int], window: int) -> str:
98
99
  if window <= 0:
99
100
  return ""
100
101
  label = f"{format_context_window(window)} Context"
101
- used = usage.get("total_tokens") or usage.get("input_tokens") or 0
102
- if used <= 0:
103
- return label
104
- percent = min(100.0, used / window * 100)
102
+ used = usage.get("input_tokens")
103
+ if type(used) is not int or used < 0:
104
+ return f"{label} · Unknown"
105
+ percent = used / window * 100
105
106
  return f"{label} · {percent:.1f}% used"
106
107
 
107
108
 
@@ -366,7 +367,7 @@ class CliApplication:
366
367
  self._loop: asyncio.AbstractEventLoop | None = None
367
368
  self._run_task: asyncio.Task[None] | None = None
368
369
  self._compacting = False
369
- self._last_ctrl_c = 0.0
370
+ self._last_ctrl_c: float | None = None
370
371
  self._status_notice_handle: asyncio.TimerHandle | None = None
371
372
  self._status_before_notice = "Ready"
372
373
  self._status_notice: str | None = None
@@ -694,7 +695,7 @@ class CliApplication:
694
695
  "\n"
695
696
  f" deep-agent resume {self.runner.thread_id}\n"
696
697
  "\n"
697
- f"Or run deep-agent resume and select. Model: {model_name}"
698
+ f"Or run deep-agent resume and select. Model: {model_name} · {self.runner.reasoning_effort()}"
698
699
  )
699
700
 
700
701
  def set_status(self, text: str, *, transient: bool = True) -> None:
@@ -720,7 +721,8 @@ class CliApplication:
720
721
  self._status_before_notice = previous
721
722
  self._status_notice = text
722
723
  self._status_notice_handle = loop.call_later(
723
- STATUS_NOTICE_SECONDS, self._hide_status_notice,
724
+ CTRL_C_EXIT_WINDOW_SECONDS if text == INPUT_CLEARED_HINT else STATUS_NOTICE_SECONDS,
725
+ self._hide_status_notice,
724
726
  )
725
727
  self.application.invalidate()
726
728
 
@@ -761,18 +763,28 @@ class CliApplication:
761
763
  notice = f"Model queued: {model_display_name(profile)} · {self.runner.pending_reasoning_effort() or self.runner.reasoning_effort()}"
762
764
  if interrupt is not None and interrupt.kind is InterruptKind.WAITING_CONFIRMATION:
763
765
  notice += " · F2: pending approval"
764
- self.state.add_system(notice)
765
766
  self.set_status(notice)
766
767
  return profile
767
768
 
768
769
  def _request_permission_mode(self, mode: PermissionMode) -> None:
769
770
  before = self.runner.permission_mode()
770
771
  self.runner.request_permission_change(mode)
772
+ interrupt = self.runner.current_interrupt()
773
+ if not self.state.running and interrupt is None and self.runner._operation_lock.acquire(blocking=False):
774
+ events: list[RunEvent] = []
775
+ try:
776
+ self.runner._apply_pending_runtime_config(events.append)
777
+ finally:
778
+ self.runner._operation_lock.release()
779
+ for event in events:
780
+ self._apply_event(event, announce=False)
781
+ if any(event.type == "runtime_config_failed" for event in events):
782
+ self.set_status(f"Permission switch failed; permission remains {self.runner.permission_mode().value}.")
783
+ return
771
784
  if self.runner.pending_permission_mode() is None:
772
- notice = f"Pending permission switch cancelled; permission remains {before.value}."
785
+ notice = f"Permission: {self.runner.permission_mode().value}."
773
786
  else:
774
787
  notice = f"Permission switch queued: {before.value} → {mode.value}. Current work uses {before.value}."
775
- interrupt = self.runner.current_interrupt()
776
788
  if interrupt is not None and interrupt.kind is InterruptKind.WAITING_CONFIRMATION:
777
789
  notice += " Existing approval remains under ask; press F2 to approve or reject."
778
790
  self.state.add_system(notice)
@@ -1060,7 +1072,6 @@ class CliApplication:
1060
1072
  self.state.add_system("There are no older messages to compact yet.")
1061
1073
  self.set_status("No older context to compact")
1062
1074
  elif result.status == "compacted":
1063
- self.state.usage.clear()
1064
1075
  self.state.add_system(result.message)
1065
1076
  self.set_status("Context compacted")
1066
1077
  else:
@@ -1719,7 +1730,11 @@ class CliApplication:
1719
1730
 
1720
1731
  @bind("interrupt")
1721
1732
  def escape(event) -> None: # type: ignore[no-untyped-def]
1722
- if self.interaction is None and event.current_buffer.text.startswith("/") and "\n" not in event.current_buffer.text:
1733
+ if self.interaction is None and event.current_buffer.complete_state is not None:
1734
+ # Dismiss the menu without cancel_completion restoring its pre-selection document.
1735
+ event.current_buffer.complete_state = None
1736
+ self.application.invalidate()
1737
+ elif self.interaction is None and event.current_buffer.text.startswith("/") and "\n" not in event.current_buffer.text:
1723
1738
  self.slash_completer.accepted_text = None
1724
1739
  event.current_buffer.reset()
1725
1740
  self._pasted_content.clear()
@@ -1759,7 +1774,7 @@ class CliApplication:
1759
1774
  self._finish_interaction(cancelled=True)
1760
1775
  return
1761
1776
  now = time.monotonic()
1762
- if now - self._last_ctrl_c < 0.5:
1777
+ if self._last_ctrl_c is not None and now - self._last_ctrl_c < CTRL_C_EXIT_WINDOW_SECONDS:
1763
1778
  self.exit()
1764
1779
  return
1765
1780
  event.current_buffer.reset()
@@ -2096,7 +2111,10 @@ class CliApplication:
2096
2111
  if event.result.get("permission_changed"):
2097
2112
  changes.append(f"permission: {event.result['permission_mode']}")
2098
2113
  if announce:
2099
- self.state.add_system("; ".join(changes))
2114
+ if event.result.get("model_changed") or event.result.get("reasoning_changed"):
2115
+ self.set_status("; ".join(changes))
2116
+ if event.result.get("permission_changed"):
2117
+ self.state.add_system(f"permission: {event.result['permission_mode']}")
2100
2118
  elif event.type == "runtime_config_failed":
2101
2119
  self.state.add_system(f"Pending runtime config failed: {event.content}", error=True)
2102
2120
  self.application.invalidate()
@@ -1,6 +1,7 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from dataclasses import dataclass, field
4
+ import re
4
5
  from typing import Any
5
6
 
6
7
  from rich.console import Group
@@ -11,6 +12,16 @@ from rich.text import Text
11
12
  from agent.tools.human_interaction import ensure_other_option
12
13
 
13
14
 
15
+ def _approval_summary(value: Any, kind: str = "command") -> str:
16
+ command = str(value or "<not supplied>")
17
+ # Do not add credential literals to the approval card. Full details remain
18
+ # in the existing tool block; arbitrary JSON arguments are never rendered here.
19
+ if re.search(r"(?i)(api[_-]?key|authorization|bearer\s|password|secret|token\s*[=:]|--token\b|\bsk-[\w.-]+)", command):
20
+ return f"[redacted: {kind} may contain credentials]"
21
+ command = " ".join("".join(c if c.isprintable() else " " for c in command).split())
22
+ return command if len(command) <= 180 else command[:180] + "… [truncated; Ctrl+O to expand tool]"
23
+
24
+
14
25
  @dataclass
15
26
  class InteractionController:
16
27
  kind: str
@@ -59,21 +70,27 @@ class InteractionController:
59
70
  def approval(cls, calls: list[dict[str, Any]]) -> "InteractionController":
60
71
  from agent.network import network_requested
61
72
 
62
- declared: list[str] = []
73
+ details: list[str] = []
63
74
  for call in calls:
64
- name = str(call.get("name") or "tool")
75
+ name = " ".join(str(call.get("name") or "tool").split())[:80]
65
76
  args = call.get("args") if isinstance(call.get("args"), dict) else {}
66
- if name == "execute" and network_requested(args):
67
- declared.append("HOST NETWORK (internet, localhost, LAN)")
68
- elif name == "web_search":
69
- declared.append("PUBLIC WEB SEARCH (Tavily)")
77
+ details.append(f"Tool: {name}")
78
+ if name == "execute":
79
+ if network_requested(args):
80
+ details.append("Network: ON — allows access to host network (internet, localhost, LAN)")
81
+ else:
82
+ details.append("Network: OFF" + (" (default)" if "network" not in args else ""))
83
+ details.append(f"Command: {_approval_summary(args.get('command'))}")
70
84
  elif name in {"write_file", "edit_file", "delete"}:
71
- declared.append(name.upper())
72
- caps = ", ".join(dict.fromkeys(declared)) if declared else "declared capabilities"
85
+ target = args.get("file_path") or args.get("path")
86
+ details.append(f"Target: {_approval_summary(target, kind='target')}")
87
+ elif name == "web_search":
88
+ details.append("Network: public web search via Tavily")
89
+ details.append("Run executes the listed tool calls. Reject denies them.")
73
90
  return cls(
74
91
  kind="approval",
75
92
  title="Approve tool call?",
76
- question=f"Approve runs this call with its declared capabilities ({caps}).",
93
+ question="\n".join(details),
77
94
  fields=[{
78
95
  "id": "approved", "type": "single_select", "label": "Decision", "required": True,
79
96
  "options": [
@@ -88,6 +88,7 @@ def parse_startup_args(argv: list[str]) -> tuple[str | None, bool]:
88
88
  )
89
89
  parser.add_argument("--version", action="version", version=f"%(prog)s {package_version()}")
90
90
  commands = parser.add_subparsers(dest="command", title="commands")
91
+ commands.add_parser("serve", help="Run the optional HTTP service (deep-agent serve --help)")
91
92
  resume = commands.add_parser("resume", help="Resume a saved session or open the session picker")
92
93
  resume.add_argument("session_id", nargs="?", help="Session ID or unique prefix; omit to select interactively")
93
94
  args = parser.parse_args(argv)
@@ -95,8 +96,17 @@ def parse_startup_args(argv: list[str]) -> tuple[str | None, bool]:
95
96
 
96
97
 
97
98
  def main(argv: list[str] | None = None) -> None:
98
- resume_id, open_picker = parse_startup_args(sys.argv[1:] if argv is None else argv)
99
- created = initialize_user_files()
99
+ startup_args = sys.argv[1:] if argv is None else argv
100
+ if startup_args[:1] == ["serve"]:
101
+ from agent.server.main import main as serve
102
+ serve(startup_args[1:])
103
+ return
104
+ resume_id, open_picker = parse_startup_args(startup_args)
105
+ try:
106
+ created = initialize_user_files()
107
+ except (ValueError, OSError) as exc:
108
+ print(f"Configuration error: {exc}", file=sys.stderr)
109
+ raise SystemExit(2) from None
100
110
  if created is not None:
101
111
  Console(stderr=True).print(
102
112
  f"Created {created} and ~/.deep-agent/skills/.\n"
@@ -109,12 +119,16 @@ def main(argv: list[str] | None = None) -> None:
109
119
  raise SystemExit(2)
110
120
  try:
111
121
  settings = Settings.load()
122
+ config_dir = settings.config_dir or default_config_dir()
123
+ require_keybindings_outside_workspace(config_dir, settings.sandbox.workspace)
112
124
  except (ConfigError, FileNotFoundError) as exc:
113
125
  print(f"Configuration error: {exc}", file=sys.stderr)
114
126
  raise SystemExit(2) from None
115
- config_dir = settings.config_dir or default_config_dir()
116
- require_keybindings_outside_workspace(config_dir, settings.sandbox.workspace)
117
- runner = create_runner(settings)
127
+ try:
128
+ runner = create_runner(settings)
129
+ except ValueError as exc:
130
+ print(f"Startup error: {exc}\nCheck the sandbox and model settings in your config.", file=sys.stderr)
131
+ raise SystemExit(2) from None
118
132
  if runner.prepared.execution_mode is ExecutionMode.UNSANDBOXED:
119
133
  Console(stderr=True).print(f"[bold red]UNSANDBOXED: {runner.prepared.security_warning}[/bold red]")
120
134
  Console(stderr=True).print(f"[dim]workspace={settings.sandbox.workspace}[/dim]")
@@ -140,9 +140,11 @@ class CliState:
140
140
  key: int(value)
141
141
  for key, value in event.result.items()
142
142
  if key in {"input_tokens", "output_tokens", "total_tokens"}
143
- and isinstance(value, int)
143
+ and type(value) is int and value >= 0
144
144
  }
145
- if usage:
145
+ # Keep the last reported context size until a new input count arrives.
146
+ # Empty/start events and output-only usage cannot replace that reading.
147
+ if "input_tokens" in usage:
146
148
  self.usage = usage
147
149
  elif event.type in {"thinking_delta", "assistant_delta"}:
148
150
  block = touch(self._assistant_block())