deep-agent-cli 0.1.3__tar.gz → 0.1.4__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.
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/PKG-INFO +76 -21
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/README.md +72 -20
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/app.py +31 -13
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/interactions.py +26 -9
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/main.py +19 -5
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/state.py +4 -2
- deep_agent_cli-0.1.4/agent/config.example.yaml +147 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/config.py +35 -25
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/factory.py +2 -0
- deep_agent_cli-0.1.4/agent/llm.py +393 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/attachments.py +2 -2
- deep_agent_cli-0.1.4/agent/middleware/usage.py +29 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/runner.py +79 -13
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/sandbox_worker.py +8 -9
- deep_agent_cli-0.1.4/agent/server/__init__.py +1 -0
- deep_agent_cli-0.1.4/agent/server/app.py +181 -0
- deep_agent_cli-0.1.4/agent/server/config.py +88 -0
- deep_agent_cli-0.1.4/agent/server/main.py +29 -0
- deep_agent_cli-0.1.4/agent/server/runtime.py +270 -0
- deep_agent_cli-0.1.4/agent/server/store.py +157 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/stream.py +10 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/tools/human_interaction.py +12 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/pyproject.toml +2 -1
- deep_agent_cli-0.1.3/agent/config.example.yaml +0 -168
- deep_agent_cli-0.1.3/agent/llm.py +0 -391
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/.gitignore +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/LICENSE +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/__init__.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/attachments.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/bootstrap.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cancel.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/__init__.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/clipboard.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/commands.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/gitinfo.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/input.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/pasted_content.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/previews.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/rendering.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/session_controller.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/skills.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/working_messages.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/cli/working_messages.yaml +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/control.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/file_mutation.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/__init__.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/cancel_tools.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/pause.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/recovery.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/runtime_config.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/steering.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/tool_arg_hints.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/workspace_filesystem.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/middleware/write_operation.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/network.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/permission.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/sandbox.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/sandbox_pool.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/session.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/session_lock.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/session_runtime.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/tools/__init__.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/tools/examples.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/tools/execute.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/agent/tools/human_input.py +0 -0
- {deep_agent_cli-0.1.3 → deep_agent_cli-0.1.4}/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
|
+
Version: 0.1.4
|
|
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.
|
|
36
|
+
当前版本 0.1.4,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 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:
|
|
96
|
+
default: token-plan/qwen3.8-flash
|
|
93
97
|
models:
|
|
94
|
-
|
|
95
|
-
base_url:
|
|
96
|
-
api_key: ${
|
|
97
|
-
|
|
98
|
-
|
|
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
|
-
|
|
102
|
-
|
|
103
|
-
context_window:
|
|
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
|
-
`
|
|
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
|
-
|
|
|
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`
|
|
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.
|
|
5
|
+
当前版本 0.1.4,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 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:
|
|
65
|
+
default: token-plan/qwen3.8-flash
|
|
65
66
|
models:
|
|
66
|
-
|
|
67
|
-
base_url:
|
|
68
|
-
api_key: ${
|
|
69
|
-
|
|
70
|
-
|
|
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
|
-
|
|
74
|
-
|
|
75
|
-
context_window:
|
|
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
|
-
`
|
|
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
|
-
|
|
|
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`
|
|
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("
|
|
102
|
-
if used
|
|
103
|
-
return label
|
|
104
|
-
percent =
|
|
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 =
|
|
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
|
|
@@ -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,
|
|
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"
|
|
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.
|
|
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 <
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
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
|
-
|
|
72
|
-
|
|
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=
|
|
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
|
-
|
|
99
|
-
|
|
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
|
-
|
|
116
|
-
|
|
117
|
-
|
|
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
|
|
143
|
+
and type(value) is int and value >= 0
|
|
144
144
|
}
|
|
145
|
-
|
|
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())
|