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.
Files changed (176) hide show
  1. deep_agent_cli-0.2.1/README.md → deep_agent_cli-0.3.0/PKG-INFO +65 -23
  2. deep_agent_cli-0.2.1/PKG-INFO → deep_agent_cli-0.3.0/README.md +31 -54
  3. deep_agent_cli-0.3.0/agent/__init__.py +38 -0
  4. deep_agent_cli-0.3.0/agent/bootstrap/__init__.py +1 -0
  5. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/bootstrap}/config.py +53 -198
  6. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/bootstrap}/factory.py +99 -20
  7. deep_agent_cli-0.3.0/agent/bootstrap/setup.py +75 -0
  8. deep_agent_cli-0.3.0/agent/cli/__init__.py +9 -0
  9. deep_agent_cli-0.3.0/agent/cli/access_selection.py +351 -0
  10. deep_agent_cli-0.3.0/agent/cli/app.py +1445 -0
  11. deep_agent_cli-0.3.0/agent/cli/attachments_controller.py +176 -0
  12. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/clipboard.py +1 -0
  13. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/commands.py +33 -15
  14. deep_agent_cli-0.3.0/agent/cli/completion.py +99 -0
  15. deep_agent_cli-0.3.0/agent/cli/context_compaction.py +79 -0
  16. deep_agent_cli-0.3.0/agent/cli/display.py +43 -0
  17. deep_agent_cli-0.3.0/agent/cli/formatting.py +88 -0
  18. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/gitinfo.py +7 -5
  19. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/input_actions.py +14 -4
  20. deep_agent_cli-0.3.0/agent/cli/interaction_flow.py +209 -0
  21. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/interactions.py +5 -4
  22. deep_agent_cli-0.3.0/agent/cli/key_bindings.py +256 -0
  23. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/lifecycle.py +49 -20
  24. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/main.py +31 -11
  25. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/mcp_controller.py +1 -0
  26. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/mcp_ui.py +54 -24
  27. deep_agent_cli-0.3.0/agent/cli/model_selection.py +249 -0
  28. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/pasted_content.py +1 -0
  29. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/previews.py +52 -45
  30. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/rendering.py +242 -107
  31. deep_agent_cli-0.3.0/agent/cli/run_dispatch.py +278 -0
  32. deep_agent_cli-0.3.0/agent/cli/run_events_controller.py +139 -0
  33. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/session_controller.py +101 -73
  34. deep_agent_cli-0.3.0/agent/cli/session_summaries.py +98 -0
  35. deep_agent_cli-0.3.0/agent/cli/skill_selection.py +98 -0
  36. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/skills.py +3 -1
  37. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/state.py +44 -18
  38. deep_agent_cli-0.3.0/agent/cli/text_selection.py +92 -0
  39. deep_agent_cli-0.3.0/agent/cli/transcript_navigation.py +223 -0
  40. deep_agent_cli-0.3.0/agent/cli/view_state.py +35 -0
  41. deep_agent_cli-0.3.0/agent/cli/widgets.py +365 -0
  42. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/working_messages.py +0 -1
  43. deep_agent_cli-0.3.0/agent/companion/__init__.py +3 -0
  44. deep_agent_cli-0.3.0/agent/companion/animation.py +47 -0
  45. deep_agent_cli-0.3.0/agent/companion/ascii_art.py +120 -0
  46. deep_agent_cli-0.3.0/agent/companion/assets/lain_concerned.gif +0 -0
  47. deep_agent_cli-0.3.0/agent/companion/assets/lain_curious.gif +0 -0
  48. deep_agent_cli-0.3.0/agent/companion/assets/lain_focused.gif +0 -0
  49. deep_agent_cli-0.3.0/agent/companion/assets/lain_idle.gif +0 -0
  50. deep_agent_cli-0.3.0/agent/companion/assets/lain_observing.gif +0 -0
  51. deep_agent_cli-0.3.0/agent/companion/assets/lain_relieved.gif +0 -0
  52. deep_agent_cli-0.3.0/agent/companion/assets/manifest.json +109 -0
  53. deep_agent_cli-0.3.0/agent/companion/chart.py +98 -0
  54. deep_agent_cli-0.3.0/agent/companion/chat.md +7 -0
  55. deep_agent_cli-0.3.0/agent/companion/config.py +48 -0
  56. deep_agent_cli-0.3.0/agent/companion/controller.py +1160 -0
  57. deep_agent_cli-0.3.0/agent/companion/diagnosis.py +105 -0
  58. deep_agent_cli-0.3.0/agent/companion/diagnostic_io.py +36 -0
  59. deep_agent_cli-0.3.0/agent/companion/evidence.py +36 -0
  60. deep_agent_cli-0.3.0/agent/companion/monitor.py +122 -0
  61. deep_agent_cli-0.3.0/agent/companion/observation.md +13 -0
  62. deep_agent_cli-0.3.0/agent/companion/panel.py +294 -0
  63. deep_agent_cli-0.3.0/agent/companion/persona.md +13 -0
  64. deep_agent_cli-0.3.0/agent/companion/redaction.py +123 -0
  65. deep_agent_cli-0.3.0/agent/companion/repository.py +246 -0
  66. deep_agent_cli-0.3.0/agent/companion/session_inspector.py +491 -0
  67. deep_agent_cli-0.3.0/agent/companion/theme.py +8 -0
  68. deep_agent_cli-0.3.0/agent/companion/timeline.py +478 -0
  69. deep_agent_cli-0.3.0/agent/companion/worker.py +334 -0
  70. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/config.example.yaml +24 -4
  71. deep_agent_cli-0.3.0/agent/execution/__init__.py +1 -0
  72. deep_agent_cli-0.3.0/agent/execution/backend.py +245 -0
  73. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/execution}/environment.py +24 -6
  74. deep_agent_cli-0.3.0/agent/execution/filesystem.py +922 -0
  75. deep_agent_cli-0.3.0/agent/execution/layout.py +489 -0
  76. deep_agent_cli-0.2.1/agent/sandbox_mounts.py → deep_agent_cli-0.3.0/agent/execution/mounts.py +5 -11
  77. deep_agent_cli-0.2.1/agent/file_mutation.py → deep_agent_cli-0.3.0/agent/execution/mutations.py +2 -0
  78. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/execution}/network.py +2 -0
  79. deep_agent_cli-0.3.0/agent/execution/policy.py +83 -0
  80. deep_agent_cli-0.2.1/agent/sandbox_pool.py → deep_agent_cli-0.3.0/agent/execution/pool.py +12 -2
  81. deep_agent_cli-0.3.0/agent/execution/ports.py +12 -0
  82. deep_agent_cli-0.3.0/agent/execution/process.py +458 -0
  83. deep_agent_cli-0.3.0/agent/execution/service_observation.py +25 -0
  84. deep_agent_cli-0.3.0/agent/execution/types.py +22 -0
  85. deep_agent_cli-0.2.1/agent/sandbox_worker.py → deep_agent_cli-0.3.0/agent/execution/worker.py +3 -2
  86. deep_agent_cli-0.3.0/agent/mcp/__init__.py +13 -0
  87. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/adapter.py +14 -5
  88. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/bridge.py +1 -0
  89. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/config.py +1 -0
  90. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/content.py +1 -0
  91. deep_agent_cli-0.3.0/agent/mcp/contracts.py +20 -0
  92. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/logging.py +1 -0
  93. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/manager.py +2 -18
  94. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/middleware.py +2 -0
  95. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/names.py +2 -0
  96. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/oauth.py +2 -1
  97. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/oauth_storage.py +3 -2
  98. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/mcp/tools.py +2 -0
  99. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/attachments.py +4 -2
  100. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/cancel_tools.py +2 -1
  101. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/current_time.py +1 -0
  102. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/pause.py +3 -2
  103. deep_agent_cli-0.3.0/agent/middleware/payload_recovery.py +109 -0
  104. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/recovery.py +2 -26
  105. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/runtime_config.py +1 -0
  106. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/steering.py +17 -5
  107. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/tool_arg_hints.py +2 -1
  108. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/usage.py +1 -0
  109. deep_agent_cli-0.3.0/agent/middleware/workspace_filesystem.py +119 -0
  110. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/write_operation.py +4 -3
  111. deep_agent_cli-0.3.0/agent/models/__init__.py +1 -0
  112. deep_agent_cli-0.3.0/agent/models/catalog.py +30 -0
  113. deep_agent_cli-0.2.1/agent/llm.py → deep_agent_cli-0.3.0/agent/models/client.py +12 -10
  114. deep_agent_cli-0.2.1/agent/http_environment.py → deep_agent_cli-0.3.0/agent/models/http.py +2 -0
  115. deep_agent_cli-0.2.1/agent/stream.py → deep_agent_cli-0.3.0/agent/models/messages.py +35 -10
  116. deep_agent_cli-0.3.0/agent/models/profile.py +62 -0
  117. deep_agent_cli-0.3.0/agent/models/session_summary.py +46 -0
  118. deep_agent_cli-0.2.1/agent/llm_stream.py → deep_agent_cli-0.3.0/agent/models/stream_lifecycle.py +2 -1
  119. deep_agent_cli-0.3.0/agent/runtime/__init__.py +1 -0
  120. deep_agent_cli-0.2.1/agent/cancel.py → deep_agent_cli-0.3.0/agent/runtime/cancellation.py +1 -0
  121. deep_agent_cli-0.3.0/agent/runtime/configuration.py +68 -0
  122. deep_agent_cli-0.3.0/agent/runtime/contracts.py +82 -0
  123. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/runtime}/control.py +40 -1
  124. deep_agent_cli-0.2.1/agent/run_events.py → deep_agent_cli-0.3.0/agent/runtime/events.py +26 -80
  125. deep_agent_cli-0.3.0/agent/runtime/graph_execution.py +75 -0
  126. deep_agent_cli-0.3.0/agent/runtime/metrics.py +247 -0
  127. deep_agent_cli-0.2.1/agent/permission.py → deep_agent_cli-0.3.0/agent/runtime/permissions.py +4 -3
  128. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/runtime}/runner.py +315 -318
  129. deep_agent_cli-0.3.0/agent/sessions/__init__.py +1 -0
  130. {deep_agent_cli-0.2.1/agent → deep_agent_cli-0.3.0/agent/sessions}/attachments.py +11 -143
  131. deep_agent_cli-0.3.0/agent/sessions/contracts.py +60 -0
  132. deep_agent_cli-0.3.0/agent/sessions/images.py +160 -0
  133. deep_agent_cli-0.2.1/agent/session_runtime.py → deep_agent_cli-0.3.0/agent/sessions/lifecycle.py +27 -25
  134. deep_agent_cli-0.2.1/agent/session_lock.py → deep_agent_cli-0.3.0/agent/sessions/locks.py +2 -0
  135. deep_agent_cli-0.3.0/agent/sessions/ports.py +36 -0
  136. deep_agent_cli-0.3.0/agent/sessions/reader.py +51 -0
  137. deep_agent_cli-0.3.0/agent/sessions/recovery.py +31 -0
  138. deep_agent_cli-0.3.0/agent/sessions/snapshots.py +38 -0
  139. deep_agent_cli-0.2.1/agent/session.py → deep_agent_cli-0.3.0/agent/sessions/store.py +36 -182
  140. deep_agent_cli-0.3.0/agent/sessions/summary.py +87 -0
  141. deep_agent_cli-0.3.0/agent/sessions/transcript.py +177 -0
  142. deep_agent_cli-0.3.0/agent/subagents/__init__.py +1 -0
  143. deep_agent_cli-0.3.0/agent/subagents/configuration.py +42 -0
  144. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/subagents/log_store.py +2 -0
  145. deep_agent_cli-0.3.0/agent/subagents/manager.py +142 -0
  146. deep_agent_cli-0.3.0/agent/subagents/notifications.py +39 -0
  147. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/subagents/runtime.py +65 -14
  148. deep_agent_cli-0.3.0/agent/tools/background_tasks.py +89 -0
  149. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/examples.py +2 -1
  150. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/execute.py +6 -3
  151. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/grep.py +8 -4
  152. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/human_input.py +10 -16
  153. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/human_interaction.py +3 -1
  154. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/subagent_logs.py +3 -2
  155. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/web_search.py +4 -3
  156. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/version.py +1 -0
  157. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/pyproject.toml +11 -8
  158. deep_agent_cli-0.2.1/agent/__init__.py +0 -42
  159. deep_agent_cli-0.2.1/agent/bootstrap.py +0 -44
  160. deep_agent_cli-0.2.1/agent/cli/__init__.py +0 -5
  161. deep_agent_cli-0.2.1/agent/cli/app.py +0 -2973
  162. deep_agent_cli-0.2.1/agent/mcp/__init__.py +0 -4
  163. deep_agent_cli-0.2.1/agent/middleware/workspace_filesystem.py +0 -38
  164. deep_agent_cli-0.2.1/agent/performance.py +0 -118
  165. deep_agent_cli-0.2.1/agent/sandbox.py +0 -2029
  166. deep_agent_cli-0.2.1/agent/subagents/__init__.py +0 -1
  167. deep_agent_cli-0.2.1/agent/subagents/manager.py +0 -50
  168. deep_agent_cli-0.2.1//347/273/210/347/253/257.png +0 -0
  169. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/.gitignore +0 -0
  170. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/LICENSE +0 -0
  171. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/input.py +0 -0
  172. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/cli/working_messages.yaml +0 -0
  173. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/middleware/__init__.py +0 -0
  174. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/__init__.py +0 -0
  175. {deep_agent_cli-0.2.1 → deep_agent_cli-0.3.0}/agent/tools/_grep_worker.py +0 -0
  176. {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
- </div>
46
+ <br>
13
47
 
14
- <p align="center">
15
- <img src="终端.png" width="760" alt="deep-agent 真实终端空闲界面,底栏显示工作区、模型来源、SANDBOXED 和 perm:ask。">
16
- </p>
48
+ ![deep-agent 终端界面:主转录区与右侧 Lain Companion](assets/readme/terminal.png)
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
- > 当前版本 **0.2.1**,处于早期开发阶段。稳定版前,配置、会话存储格式和 Python API 可能出现不兼容变更。
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 个,主 Agent 同步等待最终结果。TUI 为每个子任务显示独立卡片、状态及可展开的完整返回结果,内部思考和工具输出保持隔离。
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` 和 Skills 目录,然后退出。已有配置不会被覆盖;设置了 `DEEP_AGENT_CONFIG` 时使用指定配置。
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
- 默认模板使用 `token-plan/qwen3.8-flash`。在启动 Agent 的同一个 Bash 终端中输入对应密钥:
102
+ 默认模板使用 `deepseek/deepseek-flash`。在启动 Agent 的同一个 Bash 终端中输入 DeepSeek 密钥。
68
103
 
69
104
  ```bash
70
- read -rsp 'Token Plan API key: ' TOKEN_PLAN_API_KEY
71
- export TOKEN_PLAN_API_KEY
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: token-plan/qwen3.8-flash
119
+ default: deepseek/deepseek-flash
85
120
  timeout: 60
86
121
  models:
87
- token-plan:
88
- base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
89
- api_key: ${TOKEN_PLAN_API_KEY}
122
+ deepseek:
123
+ base_url: https://api.deepseek.com/v1
124
+ api_key: ${DEEPSEEK_API_KEY}
90
125
  api: chat_completions
91
- max_retries: 5
92
- stream_chunk_timeout: 120
93
- reasoning_efforts: [none, low, medium, xhigh]
126
+ reasoning_efforts: [none, low, high, max]
94
127
  models:
95
- qwen3.8-flash:
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
- </div>
12
+ <br>
44
13
 
45
- <p align="center">
46
- <img src="终端.png" width="760" alt="deep-agent 真实终端空闲界面,底栏显示工作区、模型来源、SANDBOXED 和 perm:ask。">
47
- </p>
14
+ ![deep-agent 终端界面:主转录区与右侧 Lain Companion](assets/readme/terminal.png)
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
- > 当前版本 **0.2.1**,处于早期开发阶段。稳定版前,配置、会话存储格式和 Python API 可能出现不兼容变更。
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 个,主 Agent 同步等待最终结果。TUI 为每个子任务显示独立卡片、状态及可展开的完整返回结果,内部思考和工具输出保持隔离。
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` 和 Skills 目录,然后退出。已有配置不会被覆盖;设置了 `DEEP_AGENT_CONFIG` 时使用指定配置。
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
- 默认模板使用 `token-plan/qwen3.8-flash`。在启动 Agent 的同一个 Bash 终端中输入对应密钥:
68
+ 默认模板使用 `deepseek/deepseek-flash`。在启动 Agent 的同一个 Bash 终端中输入 DeepSeek 密钥。
99
69
 
100
70
  ```bash
101
- read -rsp 'Token Plan API key: ' TOKEN_PLAN_API_KEY
102
- export TOKEN_PLAN_API_KEY
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: token-plan/qwen3.8-flash
85
+ default: deepseek/deepseek-flash
116
86
  timeout: 60
117
87
  models:
118
- token-plan:
119
- base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
120
- api_key: ${TOKEN_PLAN_API_KEY}
88
+ deepseek:
89
+ base_url: https://api.deepseek.com/v1
90
+ api_key: ${DEEPSEEK_API_KEY}
121
91
  api: chat_completions
122
- max_retries: 5
123
- stream_chunk_timeout: 120
124
- reasoning_efforts: [none, low, medium, xhigh]
92
+ reasoning_efforts: [none, low, high, max]
125
93
  models:
126
- qwen3.8-flash:
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."""