deep-agent-cli 0.2.1__tar.gz → 0.3.0__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.2.1/README.md → deep_agent_cli-0.3.0/PKG-INFO +65 -23
- deep_agent_cli-0.2.1/PKG-INFO → deep_agent_cli-0.3.0/README.md +31 -54
- deep_agent_cli-0.3.0/agent/__init__.py +38 -0
- deep_agent_cli-0.3.0/agent/bootstrap/__init__.py +1 -0
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/bootstrap}/config.py +53 -198
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/bootstrap}/factory.py +99 -20
- deep_agent_cli-0.3.0/agent/bootstrap/setup.py +75 -0
- deep_agent_cli-0.3.0/agent/cli/__init__.py +9 -0
- deep_agent_cli-0.3.0/agent/cli/access_selection.py +351 -0
- deep_agent_cli-0.3.0/agent/cli/app.py +1445 -0
- deep_agent_cli-0.3.0/agent/cli/attachments_controller.py +176 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/clipboard.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/commands.py +33 -15
- deep_agent_cli-0.3.0/agent/cli/completion.py +99 -0
- deep_agent_cli-0.3.0/agent/cli/context_compaction.py +79 -0
- deep_agent_cli-0.3.0/agent/cli/display.py +43 -0
- deep_agent_cli-0.3.0/agent/cli/formatting.py +88 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/gitinfo.py +7 -5
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/input_actions.py +14 -4
- deep_agent_cli-0.3.0/agent/cli/interaction_flow.py +209 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/interactions.py +5 -4
- deep_agent_cli-0.3.0/agent/cli/key_bindings.py +256 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/lifecycle.py +49 -20
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/main.py +31 -11
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/mcp_controller.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/mcp_ui.py +54 -24
- deep_agent_cli-0.3.0/agent/cli/model_selection.py +249 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/pasted_content.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/previews.py +52 -45
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/rendering.py +242 -107
- deep_agent_cli-0.3.0/agent/cli/run_dispatch.py +278 -0
- deep_agent_cli-0.3.0/agent/cli/run_events_controller.py +139 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/session_controller.py +101 -73
- deep_agent_cli-0.3.0/agent/cli/session_summaries.py +98 -0
- deep_agent_cli-0.3.0/agent/cli/skill_selection.py +98 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/skills.py +3 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/state.py +44 -18
- deep_agent_cli-0.3.0/agent/cli/text_selection.py +92 -0
- deep_agent_cli-0.3.0/agent/cli/transcript_navigation.py +223 -0
- deep_agent_cli-0.3.0/agent/cli/view_state.py +35 -0
- deep_agent_cli-0.3.0/agent/cli/widgets.py +365 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/working_messages.py +0 -1
- deep_agent_cli-0.3.0/agent/companion/__init__.py +3 -0
- deep_agent_cli-0.3.0/agent/companion/animation.py +47 -0
- deep_agent_cli-0.3.0/agent/companion/ascii_art.py +120 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_concerned.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_curious.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_focused.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_idle.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_observing.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/lain_relieved.gif +0 -0
- deep_agent_cli-0.3.0/agent/companion/assets/manifest.json +109 -0
- deep_agent_cli-0.3.0/agent/companion/chart.py +98 -0
- deep_agent_cli-0.3.0/agent/companion/chat.md +7 -0
- deep_agent_cli-0.3.0/agent/companion/config.py +48 -0
- deep_agent_cli-0.3.0/agent/companion/controller.py +1160 -0
- deep_agent_cli-0.3.0/agent/companion/diagnosis.py +105 -0
- deep_agent_cli-0.3.0/agent/companion/diagnostic_io.py +36 -0
- deep_agent_cli-0.3.0/agent/companion/evidence.py +36 -0
- deep_agent_cli-0.3.0/agent/companion/monitor.py +122 -0
- deep_agent_cli-0.3.0/agent/companion/observation.md +13 -0
- deep_agent_cli-0.3.0/agent/companion/panel.py +294 -0
- deep_agent_cli-0.3.0/agent/companion/persona.md +13 -0
- deep_agent_cli-0.3.0/agent/companion/redaction.py +123 -0
- deep_agent_cli-0.3.0/agent/companion/repository.py +246 -0
- deep_agent_cli-0.3.0/agent/companion/session_inspector.py +491 -0
- deep_agent_cli-0.3.0/agent/companion/theme.py +8 -0
- deep_agent_cli-0.3.0/agent/companion/timeline.py +478 -0
- deep_agent_cli-0.3.0/agent/companion/worker.py +334 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/config.example.yaml +24 -4
- deep_agent_cli-0.3.0/agent/execution/__init__.py +1 -0
- deep_agent_cli-0.3.0/agent/execution/backend.py +245 -0
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/execution}/environment.py +24 -6
- deep_agent_cli-0.3.0/agent/execution/filesystem.py +922 -0
- deep_agent_cli-0.3.0/agent/execution/layout.py +489 -0
- deep_agent_cli-0.2.1/agent/sandbox_mounts.py → deep_agent_cli-0.3.0/agent/execution/mounts.py +5 -11
- deep_agent_cli-0.2.1/agent/file_mutation.py → deep_agent_cli-0.3.0/agent/execution/mutations.py +2 -0
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/execution}/network.py +2 -0
- deep_agent_cli-0.3.0/agent/execution/policy.py +83 -0
- deep_agent_cli-0.2.1/agent/sandbox_pool.py → deep_agent_cli-0.3.0/agent/execution/pool.py +12 -2
- deep_agent_cli-0.3.0/agent/execution/ports.py +12 -0
- deep_agent_cli-0.3.0/agent/execution/process.py +458 -0
- deep_agent_cli-0.3.0/agent/execution/service_observation.py +25 -0
- deep_agent_cli-0.3.0/agent/execution/types.py +22 -0
- deep_agent_cli-0.2.1/agent/sandbox_worker.py → deep_agent_cli-0.3.0/agent/execution/worker.py +3 -2
- deep_agent_cli-0.3.0/agent/mcp/__init__.py +13 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/adapter.py +14 -5
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/bridge.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/config.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/content.py +1 -0
- deep_agent_cli-0.3.0/agent/mcp/contracts.py +20 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/logging.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/manager.py +2 -18
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/middleware.py +2 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/names.py +2 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/oauth.py +2 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/oauth_storage.py +3 -2
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/tools.py +2 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/attachments.py +4 -2
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/cancel_tools.py +2 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/current_time.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/pause.py +3 -2
- deep_agent_cli-0.3.0/agent/middleware/payload_recovery.py +109 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/recovery.py +2 -26
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/runtime_config.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/steering.py +17 -5
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/tool_arg_hints.py +2 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/usage.py +1 -0
- deep_agent_cli-0.3.0/agent/middleware/workspace_filesystem.py +119 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/write_operation.py +4 -3
- deep_agent_cli-0.3.0/agent/models/__init__.py +1 -0
- deep_agent_cli-0.3.0/agent/models/catalog.py +30 -0
- deep_agent_cli-0.2.1/agent/llm.py → deep_agent_cli-0.3.0/agent/models/client.py +12 -10
- deep_agent_cli-0.2.1/agent/http_environment.py → deep_agent_cli-0.3.0/agent/models/http.py +2 -0
- deep_agent_cli-0.2.1/agent/stream.py → deep_agent_cli-0.3.0/agent/models/messages.py +35 -10
- deep_agent_cli-0.3.0/agent/models/profile.py +62 -0
- deep_agent_cli-0.3.0/agent/models/session_summary.py +46 -0
- deep_agent_cli-0.2.1/agent/llm_stream.py → deep_agent_cli-0.3.0/agent/models/stream_lifecycle.py +2 -1
- deep_agent_cli-0.3.0/agent/runtime/__init__.py +1 -0
- deep_agent_cli-0.2.1/agent/cancel.py → deep_agent_cli-0.3.0/agent/runtime/cancellation.py +1 -0
- deep_agent_cli-0.3.0/agent/runtime/configuration.py +68 -0
- deep_agent_cli-0.3.0/agent/runtime/contracts.py +82 -0
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/runtime}/control.py +40 -1
- deep_agent_cli-0.2.1/agent/run_events.py → deep_agent_cli-0.3.0/agent/runtime/events.py +26 -80
- deep_agent_cli-0.3.0/agent/runtime/graph_execution.py +75 -0
- deep_agent_cli-0.3.0/agent/runtime/metrics.py +247 -0
- deep_agent_cli-0.2.1/agent/permission.py → deep_agent_cli-0.3.0/agent/runtime/permissions.py +4 -3
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/runtime}/runner.py +315 -318
- deep_agent_cli-0.3.0/agent/sessions/__init__.py +1 -0
- {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/sessions}/attachments.py +11 -143
- deep_agent_cli-0.3.0/agent/sessions/contracts.py +60 -0
- deep_agent_cli-0.3.0/agent/sessions/images.py +160 -0
- deep_agent_cli-0.2.1/agent/session_runtime.py → deep_agent_cli-0.3.0/agent/sessions/lifecycle.py +27 -25
- deep_agent_cli-0.2.1/agent/session_lock.py → deep_agent_cli-0.3.0/agent/sessions/locks.py +2 -0
- deep_agent_cli-0.3.0/agent/sessions/ports.py +36 -0
- deep_agent_cli-0.3.0/agent/sessions/reader.py +51 -0
- deep_agent_cli-0.3.0/agent/sessions/recovery.py +31 -0
- deep_agent_cli-0.3.0/agent/sessions/snapshots.py +38 -0
- deep_agent_cli-0.2.1/agent/session.py → deep_agent_cli-0.3.0/agent/sessions/store.py +36 -182
- deep_agent_cli-0.3.0/agent/sessions/summary.py +87 -0
- deep_agent_cli-0.3.0/agent/sessions/transcript.py +177 -0
- deep_agent_cli-0.3.0/agent/subagents/__init__.py +1 -0
- deep_agent_cli-0.3.0/agent/subagents/configuration.py +42 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/subagents/log_store.py +2 -0
- deep_agent_cli-0.3.0/agent/subagents/manager.py +142 -0
- deep_agent_cli-0.3.0/agent/subagents/notifications.py +39 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/subagents/runtime.py +65 -14
- deep_agent_cli-0.3.0/agent/tools/background_tasks.py +89 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/examples.py +2 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/execute.py +6 -3
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/grep.py +8 -4
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/human_input.py +10 -16
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/human_interaction.py +3 -1
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/subagent_logs.py +3 -2
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/web_search.py +4 -3
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/version.py +1 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/pyproject.toml +11 -8
- deep_agent_cli-0.2.1/agent/__init__.py +0 -42
- deep_agent_cli-0.2.1/agent/bootstrap.py +0 -44
- deep_agent_cli-0.2.1/agent/cli/__init__.py +0 -5
- deep_agent_cli-0.2.1/agent/cli/app.py +0 -2973
- deep_agent_cli-0.2.1/agent/mcp/__init__.py +0 -4
- deep_agent_cli-0.2.1/agent/middleware/workspace_filesystem.py +0 -38
- deep_agent_cli-0.2.1/agent/performance.py +0 -118
- deep_agent_cli-0.2.1/agent/sandbox.py +0 -2029
- deep_agent_cli-0.2.1/agent/subagents/__init__.py +0 -1
- deep_agent_cli-0.2.1/agent/subagents/manager.py +0 -50
- deep_agent_cli-0.2.1//347/273/210/347/253/257.png +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/.gitignore +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/LICENSE +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/input.py +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/working_messages.yaml +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/__init__.py +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/__init__.py +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/_grep_worker.py +0 -0
- {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/assets/readme/runtime-map.svg +0 -0
|
@@ -1,3 +1,37 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: deep-agent-cli
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: A sandboxed coding agent CLI for Linux and WSL2
|
|
5
|
+
License-Expression: MIT
|
|
6
|
+
License-File: LICENSE
|
|
7
|
+
Classifier: Environment :: Console
|
|
8
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
9
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
10
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
11
|
+
Classifier: Topic :: Software Development
|
|
12
|
+
Requires-Python: >=3.12
|
|
13
|
+
Requires-Dist: cryptography<51,>=43
|
|
14
|
+
Requires-Dist: deepagents<0.8.0,>=0.7.35
|
|
15
|
+
Requires-Dist: httpx[socks]<1,>=0.27
|
|
16
|
+
Requires-Dist: langchain-core<2.0,>=1.7.7
|
|
17
|
+
Requires-Dist: langchain-openai<1.8.0,>=1.7.4
|
|
18
|
+
Requires-Dist: langchain[mcp]<2.0,>=1.4.9
|
|
19
|
+
Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1.3
|
|
20
|
+
Requires-Dist: langgraph-prebuilt<2,>=1.1.1
|
|
21
|
+
Requires-Dist: langgraph<2.0,>=1.2.20
|
|
22
|
+
Requires-Dist: numpy<3,>=2
|
|
23
|
+
Requires-Dist: pillow<14,>=11
|
|
24
|
+
Requires-Dist: prompt-toolkit<4.0,>=3.0.48
|
|
25
|
+
Requires-Dist: py-key-value-aio[filetree]<0.5,>=0.4.4
|
|
26
|
+
Requires-Dist: pyyaml<7.0,>=6.0
|
|
27
|
+
Requires-Dist: rich<15.0,>=13.9
|
|
28
|
+
Requires-Dist: ripgrep-bin<16,>=15.2.0
|
|
29
|
+
Provides-Extra: dev
|
|
30
|
+
Requires-Dist: build<2,>=1.2; extra == 'dev'
|
|
31
|
+
Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
|
|
32
|
+
Requires-Dist: twine<7,>=6; extra == 'dev'
|
|
33
|
+
Description-Content-Type: text/markdown
|
|
34
|
+
|
|
1
35
|
<div align="center">
|
|
2
36
|
|
|
3
37
|
# deep-agent-cli
|
|
@@ -7,27 +41,28 @@
|
|
|
7
41
|
Linux / WSL2 · Python 3.12+<br>
|
|
8
42
|
OpenAI 兼容接口 · Bubblewrap
|
|
9
43
|
|
|
10
|
-
[快速开始](#快速开始) · [常用操作](#常用操作) · [架构与安全](#架构与安全) · [文档](#文档)
|
|
44
|
+
[快速开始](#快速开始) · [常用操作](#常用操作) · [Lain Companion](#lain-companion) · [架构与安全](#架构与安全) · [文档](#文档)
|
|
11
45
|
|
|
12
|
-
|
|
46
|
+
<br>
|
|
13
47
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
</
|
|
48
|
+

|
|
49
|
+
|
|
50
|
+
</div>
|
|
17
51
|
|
|
18
52
|
`deep-agent` 是基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 的终端 Coding Agent。它在当前项目中工作,主 Agent 默认在文件变更、命令执行和网页搜索前请求批准,通过 [Bubblewrap](https://github.com/containers/bubblewrap) 隔离命令执行。
|
|
19
53
|
|
|
20
54
|
在项目目录运行 `deep-agent` 进入交互式终端,用 `deep-agent resume` 恢复已有会话。要在其他 Python 程序里复用同一套运行核心,使用 [Python API](docs/library.md)。
|
|
21
55
|
|
|
22
|
-
> 当前版本 **
|
|
56
|
+
> 当前版本 **v0.3.0**,处于早期开发阶段。稳定版前,配置、会话存储格式和 Python API 可能出现不兼容变更。
|
|
23
57
|
|
|
24
58
|
## 能做什么
|
|
25
59
|
|
|
26
60
|
- **查代码、改文件** — 浏览、读取、正则搜索、编辑和删除;`Ctrl+R` 审阅完整改动,`F2` 处理审批。
|
|
27
61
|
- **运行项目命令** — 实时查看输出,会话内复用持久沙箱;默认审批、隔离直接 IP 网络。
|
|
28
62
|
- **随时介入任务** — 追加指令、排队后续任务、暂停、取消,以及结构化人工输入。
|
|
29
|
-
- **拆分独立任务** — 仅当问题能分解为多个独立、互不干扰的子问题时派生 SubAgent;默认最多并行 2
|
|
63
|
+
- **拆分独立任务** — 仅当问题能分解为多个独立、互不干扰的子问题时派生 SubAgent;默认最多并行 2 个;主 Agent 可同步等待最终结果,也可把耗时子任务放到后台继续工作,完成后自动收到结果。TUI 为每个子任务显示独立卡片、状态及可展开的完整返回结果,内部思考和工具输出保持隔离。
|
|
30
64
|
- **保留工作上下文** — SQLite 会话恢复、模型与推理强度切换、上下文压缩;支持图片输入的模型可接收附件。
|
|
65
|
+
- **观察当前会话** — Lain 侧栏显示工具活动热力图、资源占用、Git 状态和正在运行的服务,也可以通过流式对话查询异常。
|
|
31
66
|
|
|
32
67
|
支持通过 Skills 和 `AGENTS.md` 扩展项目指令。SubAgent 配置、独立思考强度及日志查询见 [SubAgent 委派](docs/configuration.md#subagent-委派)。
|
|
33
68
|
|
|
@@ -53,7 +88,7 @@ deep-agent --version
|
|
|
53
88
|
|
|
54
89
|
### 2. 初始化与配置
|
|
55
90
|
|
|
56
|
-
从项目目录启动,首次运行会创建 `~/.deep-agent/config.yaml
|
|
91
|
+
从项目目录启动,首次运行会创建 `~/.deep-agent/config.yaml`、Skills 目录,以及 Lain 的提示词和 GIF,然后退出。已有配置会保留。设置了 `DEEP_AGENT_CONFIG` 时使用指定配置。
|
|
57
92
|
|
|
58
93
|
```bash
|
|
59
94
|
cd ~/projects/my-app # 替换为你的项目目录
|
|
@@ -64,11 +99,11 @@ deep-agent
|
|
|
64
99
|
|
|
65
100
|
默认模板是 `mode: restricted`,不预置工具挂载;需要 Node、Cargo / Rustup、Chrome、X11 或浏览器缓存时,按 [默认工具挂载](docs/configuration.md#默认工具挂载) 中的示例手动添加,可选源不存在时跳过。NVM 挂载整个版本目录后,使用哪个版本由用户在沙箱 `PATH` 中指定;程序不自动发现工具安装位置或选择版本。已有配置需手动对照模板合并,升级不会覆盖用户配置。
|
|
66
101
|
|
|
67
|
-
默认模板使用 `
|
|
102
|
+
默认模板使用 `deepseek/deepseek-flash`。在启动 Agent 的同一个 Bash 终端中输入 DeepSeek 密钥。
|
|
68
103
|
|
|
69
104
|
```bash
|
|
70
|
-
read -rsp '
|
|
71
|
-
export
|
|
105
|
+
read -rsp 'DeepSeek API key: ' DEEPSEEK_API_KEY
|
|
106
|
+
export DEEPSEEK_API_KEY
|
|
72
107
|
printf '\n'
|
|
73
108
|
```
|
|
74
109
|
|
|
@@ -81,20 +116,16 @@ printf '\n'
|
|
|
81
116
|
|
|
82
117
|
```yaml
|
|
83
118
|
llm:
|
|
84
|
-
default:
|
|
119
|
+
default: deepseek/deepseek-flash
|
|
85
120
|
timeout: 60
|
|
86
121
|
models:
|
|
87
|
-
|
|
88
|
-
base_url: https://
|
|
89
|
-
api_key: ${
|
|
122
|
+
deepseek:
|
|
123
|
+
base_url: https://api.deepseek.com/v1
|
|
124
|
+
api_key: ${DEEPSEEK_API_KEY}
|
|
90
125
|
api: chat_completions
|
|
91
|
-
|
|
92
|
-
stream_chunk_timeout: 120
|
|
93
|
-
reasoning_efforts: [none, low, medium, xhigh]
|
|
126
|
+
reasoning_efforts: [none, low, high, max]
|
|
94
127
|
models:
|
|
95
|
-
|
|
96
|
-
input: [text, image]
|
|
97
|
-
context_window: 1m
|
|
128
|
+
deepseek-flash: {}
|
|
98
129
|
```
|
|
99
130
|
|
|
100
131
|
端点、上下文窗口、输入模态和推理强度取决于所选服务,完整说明见 [配置参考](docs/configuration.md)。
|
|
@@ -116,12 +147,12 @@ llm:
|
|
|
116
147
|
<summary>恢复会话、升级与虚拟环境安装</summary>
|
|
117
148
|
|
|
118
149
|
```bash
|
|
119
|
-
deep-agent resume #
|
|
150
|
+
deep-agent resume # 按中文摘要选择会话,无摘要时显示 ID
|
|
120
151
|
deep-agent resume 01a08aae # 换成已有会话的 ID 或前缀
|
|
121
152
|
pipx upgrade deep-agent-cli
|
|
122
153
|
```
|
|
123
154
|
|
|
124
|
-
|
|
155
|
+
会话按工作区保存,请从原项目目录运行 `resume`。新会话收到第一条提问后会在后台生成中文标题,恢复命令仍使用会话 ID。底栏显示当前模型最近一次有效的上下文用量。恢复只加载状态,不自动继续未完成任务;旧数据库格式不自动迁移。取消不回滚已发生的文件修改或外部副作用。
|
|
125
156
|
|
|
126
157
|
不使用 pipx 时,也可安装到虚拟环境:
|
|
127
158
|
|
|
@@ -142,12 +173,23 @@ python3.12 -m venv ~/.venvs/deep-agent
|
|
|
142
173
|
| `Enter` / `Alt+Enter` | 提交或运行中追加指令 / 排队后续任务 |
|
|
143
174
|
| `Esc` | 请求取消当前任务 |
|
|
144
175
|
| `Ctrl+O` / `Ctrl+T` | 展开工具输出 / 思考内容 |
|
|
176
|
+
| `Ctrl+C` | 清空当前输入框,1 秒内再按一次退出 |
|
|
145
177
|
| `/resume` / `/new` | 恢复或新建会话 |
|
|
146
178
|
| `/mcp` | 查看、开关和配置宿主 MCP 服务 |
|
|
147
179
|
| `/help` / `/status` | 查看完整操作与当前状态 |
|
|
148
180
|
|
|
149
181
|
更多按键、图片附件、队列、Skills 和显示设置见 [终端界面](docs/tui.md)。
|
|
150
182
|
|
|
183
|
+
## Lain Companion
|
|
184
|
+
|
|
185
|
+
终端至少为 **120 列 × 32 行**时,Lain 会显示在右侧。侧栏显示当前时间与运行环境、CPU / GPU / RAM / 磁盘使用率、Git 分支和工作区服务。
|
|
186
|
+
|
|
187
|
+
- **Tool Health** 按完成顺序显示最近 60 次有明确结果的工具调用,每 3 次一列。颜色表示调用次数,出现失败时显示 `×`。
|
|
188
|
+
- **Talk To Lain** 用 `Ctrl+→` 进入,`Enter` 发送,`Ctrl+←` 返回主输入框。回复流式显示并以 Markdown 渲染;聊天历史可用鼠标滚轮翻看。可只读检查当前会话的工具明细与近期消息。
|
|
189
|
+
- **主动观察** 由本地工具统计触发。Lain 可根据当前会话的证据说明异常,也可应用户要求复盘。
|
|
190
|
+
|
|
191
|
+
Lain 的模型凭据优先读取 `COMPANION_DEEPSEEK_API_KEY`,也可保存在 `~/.deep-agent/companion.key`。本地监控和动画无需模型凭据。人设、观察提示词、聊天提示词和各状态 GIF 可在 `config.yaml` 的 `companion` 段配置。详见 [Lain 侧栏配置](docs/configuration.md#lain-侧栏companion) 和 [统计口径](docs/companion-phase2.md)。
|
|
192
|
+
|
|
151
193
|
## 架构与安全
|
|
152
194
|
|
|
153
195
|
**审批决定是否执行,隔离决定命令能访问哪些资源。** 文件工具和命令走不同通路:
|
|
@@ -1,34 +1,3 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: deep-agent-cli
|
|
3
|
-
Version: 0.2.1
|
|
4
|
-
Summary: A sandboxed coding agent CLI for Linux and WSL2
|
|
5
|
-
License-Expression: MIT
|
|
6
|
-
License-File: LICENSE
|
|
7
|
-
Classifier: Environment :: Console
|
|
8
|
-
Classifier: Operating System :: POSIX :: Linux
|
|
9
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
10
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
11
|
-
Classifier: Topic :: Software Development
|
|
12
|
-
Requires-Python: >=3.12
|
|
13
|
-
Requires-Dist: cryptography<51,>=43
|
|
14
|
-
Requires-Dist: deepagents<0.8.0,>=0.7.17
|
|
15
|
-
Requires-Dist: httpx[socks]<1,>=0.27
|
|
16
|
-
Requires-Dist: langchain-core<2.0,>=1.0
|
|
17
|
-
Requires-Dist: langchain-openai<1.7.0,>=1.6.2
|
|
18
|
-
Requires-Dist: langchain[mcp]<2.0,>=1.4.2
|
|
19
|
-
Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1.1
|
|
20
|
-
Requires-Dist: langgraph<2.0,>=1.0
|
|
21
|
-
Requires-Dist: prompt-toolkit<4.0,>=3.0.48
|
|
22
|
-
Requires-Dist: py-key-value-aio[filetree]<0.5,>=0.4.4
|
|
23
|
-
Requires-Dist: pyyaml<7.0,>=6.0
|
|
24
|
-
Requires-Dist: rich<15.0,>=13.9
|
|
25
|
-
Requires-Dist: ripgrep-bin<16,>=15.2.0
|
|
26
|
-
Provides-Extra: dev
|
|
27
|
-
Requires-Dist: build<2,>=1.2; extra == 'dev'
|
|
28
|
-
Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
|
|
29
|
-
Requires-Dist: twine<7,>=6; extra == 'dev'
|
|
30
|
-
Description-Content-Type: text/markdown
|
|
31
|
-
|
|
32
1
|
<div align="center">
|
|
33
2
|
|
|
34
3
|
# deep-agent-cli
|
|
@@ -38,27 +7,28 @@ Description-Content-Type: text/markdown
|
|
|
38
7
|
Linux / WSL2 · Python 3.12+<br>
|
|
39
8
|
OpenAI 兼容接口 · Bubblewrap
|
|
40
9
|
|
|
41
|
-
[快速开始](#快速开始) · [常用操作](#常用操作) · [架构与安全](#架构与安全) · [文档](#文档)
|
|
10
|
+
[快速开始](#快速开始) · [常用操作](#常用操作) · [Lain Companion](#lain-companion) · [架构与安全](#架构与安全) · [文档](#文档)
|
|
42
11
|
|
|
43
|
-
|
|
12
|
+
<br>
|
|
44
13
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
</
|
|
14
|
+

|
|
15
|
+
|
|
16
|
+
</div>
|
|
48
17
|
|
|
49
18
|
`deep-agent` 是基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 的终端 Coding Agent。它在当前项目中工作,主 Agent 默认在文件变更、命令执行和网页搜索前请求批准,通过 [Bubblewrap](https://github.com/containers/bubblewrap) 隔离命令执行。
|
|
50
19
|
|
|
51
20
|
在项目目录运行 `deep-agent` 进入交互式终端,用 `deep-agent resume` 恢复已有会话。要在其他 Python 程序里复用同一套运行核心,使用 [Python API](docs/library.md)。
|
|
52
21
|
|
|
53
|
-
> 当前版本 **
|
|
22
|
+
> 当前版本 **v0.3.0**,处于早期开发阶段。稳定版前,配置、会话存储格式和 Python API 可能出现不兼容变更。
|
|
54
23
|
|
|
55
24
|
## 能做什么
|
|
56
25
|
|
|
57
26
|
- **查代码、改文件** — 浏览、读取、正则搜索、编辑和删除;`Ctrl+R` 审阅完整改动,`F2` 处理审批。
|
|
58
27
|
- **运行项目命令** — 实时查看输出,会话内复用持久沙箱;默认审批、隔离直接 IP 网络。
|
|
59
28
|
- **随时介入任务** — 追加指令、排队后续任务、暂停、取消,以及结构化人工输入。
|
|
60
|
-
- **拆分独立任务** — 仅当问题能分解为多个独立、互不干扰的子问题时派生 SubAgent;默认最多并行 2
|
|
29
|
+
- **拆分独立任务** — 仅当问题能分解为多个独立、互不干扰的子问题时派生 SubAgent;默认最多并行 2 个;主 Agent 可同步等待最终结果,也可把耗时子任务放到后台继续工作,完成后自动收到结果。TUI 为每个子任务显示独立卡片、状态及可展开的完整返回结果,内部思考和工具输出保持隔离。
|
|
61
30
|
- **保留工作上下文** — SQLite 会话恢复、模型与推理强度切换、上下文压缩;支持图片输入的模型可接收附件。
|
|
31
|
+
- **观察当前会话** — Lain 侧栏显示工具活动热力图、资源占用、Git 状态和正在运行的服务,也可以通过流式对话查询异常。
|
|
62
32
|
|
|
63
33
|
支持通过 Skills 和 `AGENTS.md` 扩展项目指令。SubAgent 配置、独立思考强度及日志查询见 [SubAgent 委派](docs/configuration.md#subagent-委派)。
|
|
64
34
|
|
|
@@ -84,7 +54,7 @@ deep-agent --version
|
|
|
84
54
|
|
|
85
55
|
### 2. 初始化与配置
|
|
86
56
|
|
|
87
|
-
从项目目录启动,首次运行会创建 `~/.deep-agent/config.yaml
|
|
57
|
+
从项目目录启动,首次运行会创建 `~/.deep-agent/config.yaml`、Skills 目录,以及 Lain 的提示词和 GIF,然后退出。已有配置会保留。设置了 `DEEP_AGENT_CONFIG` 时使用指定配置。
|
|
88
58
|
|
|
89
59
|
```bash
|
|
90
60
|
cd ~/projects/my-app # 替换为你的项目目录
|
|
@@ -95,11 +65,11 @@ deep-agent
|
|
|
95
65
|
|
|
96
66
|
默认模板是 `mode: restricted`,不预置工具挂载;需要 Node、Cargo / Rustup、Chrome、X11 或浏览器缓存时,按 [默认工具挂载](docs/configuration.md#默认工具挂载) 中的示例手动添加,可选源不存在时跳过。NVM 挂载整个版本目录后,使用哪个版本由用户在沙箱 `PATH` 中指定;程序不自动发现工具安装位置或选择版本。已有配置需手动对照模板合并,升级不会覆盖用户配置。
|
|
97
67
|
|
|
98
|
-
默认模板使用 `
|
|
68
|
+
默认模板使用 `deepseek/deepseek-flash`。在启动 Agent 的同一个 Bash 终端中输入 DeepSeek 密钥。
|
|
99
69
|
|
|
100
70
|
```bash
|
|
101
|
-
read -rsp '
|
|
102
|
-
export
|
|
71
|
+
read -rsp 'DeepSeek API key: ' DEEPSEEK_API_KEY
|
|
72
|
+
export DEEPSEEK_API_KEY
|
|
103
73
|
printf '\n'
|
|
104
74
|
```
|
|
105
75
|
|
|
@@ -112,20 +82,16 @@ printf '\n'
|
|
|
112
82
|
|
|
113
83
|
```yaml
|
|
114
84
|
llm:
|
|
115
|
-
default:
|
|
85
|
+
default: deepseek/deepseek-flash
|
|
116
86
|
timeout: 60
|
|
117
87
|
models:
|
|
118
|
-
|
|
119
|
-
base_url: https://
|
|
120
|
-
api_key: ${
|
|
88
|
+
deepseek:
|
|
89
|
+
base_url: https://api.deepseek.com/v1
|
|
90
|
+
api_key: ${DEEPSEEK_API_KEY}
|
|
121
91
|
api: chat_completions
|
|
122
|
-
|
|
123
|
-
stream_chunk_timeout: 120
|
|
124
|
-
reasoning_efforts: [none, low, medium, xhigh]
|
|
92
|
+
reasoning_efforts: [none, low, high, max]
|
|
125
93
|
models:
|
|
126
|
-
|
|
127
|
-
input: [text, image]
|
|
128
|
-
context_window: 1m
|
|
94
|
+
deepseek-flash: {}
|
|
129
95
|
```
|
|
130
96
|
|
|
131
97
|
端点、上下文窗口、输入模态和推理强度取决于所选服务,完整说明见 [配置参考](docs/configuration.md)。
|
|
@@ -147,12 +113,12 @@ llm:
|
|
|
147
113
|
<summary>恢复会话、升级与虚拟环境安装</summary>
|
|
148
114
|
|
|
149
115
|
```bash
|
|
150
|
-
deep-agent resume #
|
|
116
|
+
deep-agent resume # 按中文摘要选择会话,无摘要时显示 ID
|
|
151
117
|
deep-agent resume 01a08aae # 换成已有会话的 ID 或前缀
|
|
152
118
|
pipx upgrade deep-agent-cli
|
|
153
119
|
```
|
|
154
120
|
|
|
155
|
-
|
|
121
|
+
会话按工作区保存,请从原项目目录运行 `resume`。新会话收到第一条提问后会在后台生成中文标题,恢复命令仍使用会话 ID。底栏显示当前模型最近一次有效的上下文用量。恢复只加载状态,不自动继续未完成任务;旧数据库格式不自动迁移。取消不回滚已发生的文件修改或外部副作用。
|
|
156
122
|
|
|
157
123
|
不使用 pipx 时,也可安装到虚拟环境:
|
|
158
124
|
|
|
@@ -173,12 +139,23 @@ python3.12 -m venv ~/.venvs/deep-agent
|
|
|
173
139
|
| `Enter` / `Alt+Enter` | 提交或运行中追加指令 / 排队后续任务 |
|
|
174
140
|
| `Esc` | 请求取消当前任务 |
|
|
175
141
|
| `Ctrl+O` / `Ctrl+T` | 展开工具输出 / 思考内容 |
|
|
142
|
+
| `Ctrl+C` | 清空当前输入框,1 秒内再按一次退出 |
|
|
176
143
|
| `/resume` / `/new` | 恢复或新建会话 |
|
|
177
144
|
| `/mcp` | 查看、开关和配置宿主 MCP 服务 |
|
|
178
145
|
| `/help` / `/status` | 查看完整操作与当前状态 |
|
|
179
146
|
|
|
180
147
|
更多按键、图片附件、队列、Skills 和显示设置见 [终端界面](docs/tui.md)。
|
|
181
148
|
|
|
149
|
+
## Lain Companion
|
|
150
|
+
|
|
151
|
+
终端至少为 **120 列 × 32 行**时,Lain 会显示在右侧。侧栏显示当前时间与运行环境、CPU / GPU / RAM / 磁盘使用率、Git 分支和工作区服务。
|
|
152
|
+
|
|
153
|
+
- **Tool Health** 按完成顺序显示最近 60 次有明确结果的工具调用,每 3 次一列。颜色表示调用次数,出现失败时显示 `×`。
|
|
154
|
+
- **Talk To Lain** 用 `Ctrl+→` 进入,`Enter` 发送,`Ctrl+←` 返回主输入框。回复流式显示并以 Markdown 渲染;聊天历史可用鼠标滚轮翻看。可只读检查当前会话的工具明细与近期消息。
|
|
155
|
+
- **主动观察** 由本地工具统计触发。Lain 可根据当前会话的证据说明异常,也可应用户要求复盘。
|
|
156
|
+
|
|
157
|
+
Lain 的模型凭据优先读取 `COMPANION_DEEPSEEK_API_KEY`,也可保存在 `~/.deep-agent/companion.key`。本地监控和动画无需模型凭据。人设、观察提示词、聊天提示词和各状态 GIF 可在 `config.yaml` 的 `companion` 段配置。详见 [Lain 侧栏配置](docs/configuration.md#lain-侧栏companion) 和 [统计口径](docs/companion-phase2.md)。
|
|
158
|
+
|
|
182
159
|
## 架构与安全
|
|
183
160
|
|
|
184
161
|
**审批决定是否执行,隔离决定命令能访问哪些资源。** 文件工具和命令走不同通路:
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
"""Public application API with lazy adapter loading."""
|
|
2
|
+
from importlib import import_module
|
|
3
|
+
|
|
4
|
+
_EXPORTS = {
|
|
5
|
+
'ModelProfile': ('agent.models.profile', 'ModelProfile'),
|
|
6
|
+
'BindMount': ('agent.execution.policy', 'BindMount'),
|
|
7
|
+
'SandboxConfig': ('agent.execution.policy', 'SandboxConfig'),
|
|
8
|
+
'RunController': ('agent.runtime.control', 'RunController'),
|
|
9
|
+
'AgentSpec': ('agent.bootstrap.factory', 'AgentSpec'),
|
|
10
|
+
'PreparedAgent': ('agent.bootstrap.factory', 'PreparedAgent'),
|
|
11
|
+
'build_agent': ('agent.bootstrap.factory', 'build_agent'),
|
|
12
|
+
'create_agent': ('agent.bootstrap.factory', 'create_agent'),
|
|
13
|
+
'PermissionMode': ('agent.runtime.permissions', 'PermissionMode'),
|
|
14
|
+
'AgentRunner': ('agent.runtime.runner', 'AgentRunner'),
|
|
15
|
+
'InterruptKind': ('agent.runtime.contracts', 'InterruptKind'),
|
|
16
|
+
'InterruptState': ('agent.runtime.contracts', 'InterruptState'),
|
|
17
|
+
'RunEvent': ('agent.runtime.contracts', 'RunEvent'),
|
|
18
|
+
'RunResult': ('agent.runtime.contracts', 'RunResult'),
|
|
19
|
+
'UnknownInterruptError': ('agent.runtime.contracts', 'UnknownInterruptError'),
|
|
20
|
+
'ExecutionMode': ('agent.execution.types', 'ExecutionMode'),
|
|
21
|
+
'SandboxUnavailableError': ('agent.execution.types', 'SandboxUnavailableError'),
|
|
22
|
+
'ImageAttachment': ('agent.sessions.images', 'ImageAttachment'),
|
|
23
|
+
'ImageAttachmentRef': ('agent.sessions.images', 'ImageAttachmentRef'),
|
|
24
|
+
'SessionStore': ('agent.sessions.store', 'SessionStore'),
|
|
25
|
+
'SessionInfo': ('agent.sessions.contracts', 'SessionInfo'),
|
|
26
|
+
'StopReason': ('agent.sessions.contracts', 'StopReason'),
|
|
27
|
+
'StreamDeltaCallback': ('agent.models.messages', 'StreamDeltaCallback'),
|
|
28
|
+
}
|
|
29
|
+
__all__ = list(_EXPORTS)
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def __getattr__(name: str):
|
|
33
|
+
if name not in _EXPORTS:
|
|
34
|
+
raise AttributeError(name)
|
|
35
|
+
module, symbol = _EXPORTS[name]
|
|
36
|
+
value = getattr(import_module(module), symbol)
|
|
37
|
+
globals()[name] = value
|
|
38
|
+
return value
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
"""Bootstrap bounded context."""
|