synapse-cli-agent 0.1.32__tar.gz → 0.1.34__tar.gz

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/.gitignore

@@ -19,6 +19,7 @@ wheels/
 .coding-agent/
 .cmd-agent/
 .tmp/
+.tmp-pytest/
 .synapse/
 .pytest_cache/
 .ruff_cache/
@@ -30,6 +31,10 @@ htmlcov/
 large_tool_results/
 conversation_history/
 
+# Local misc files (unrelated to the repo)
+/ear-anatomy-exploded.html
+/ear-models/
+
 # IDE
 .idea/
 .vscode/

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/CHANGELOG.md

@@ -8,6 +8,43 @@ All entries are written in English.
 
 ---
 
+## v0.1.34
+
+### Bug Fixes
+
+- Fixed clipboard image paste on Linux/WSLg: WSLg syncs Windows screenshots as `image/bmp`, so the Linux reader now tries `image/png`, `image/bmp`, and `image/jpeg` and normalizes non-PNG data to PNG.
+- Fixed pasted image bytes being rendered as a text placeholder (`[BP... chars]`) instead of an image attachment by detecting mangled image signatures with binary noise and falling back to a clipboard image re-read.
+- Fixed multi-line and long Shift+Insert pastes being truncated to the first line; full content is preserved and expanded on submit.
+
+### Engineering
+
+- Added clipboard unit tests for BMP normalization, explicit text MIME requests, and mangled-prefix detection.
+
+---
+
+## v0.1.33
+
+### New Features
+
+- Added per-subagent model and reasoning-effort configuration in the TUI, with layered configuration and display metadata for subagent tool calls.
+- Improved subagent activity rendering with live reasoning, tool-calling, and answering phases, including attribution for concurrent activity.
+
+### Bug Fixes
+
+- Fixed subagent tool-call inheritance and model selection behavior.
+- Enforced non-overridable file-tool path rules in subagent prompts.
+- Fixed TUI model and subagent picker keyboard interactions.
+- Fixed subagent sub-call display windows so recent calls remain visible as new calls arrive.
+- Fixed long-line Ruff violations in selectable-text and cancellation status rendering.
+
+### Engineering
+
+- Simplified subagent specifications and removed the obsolete DAG parallel-subagent runtime.
+- Improved TUI responsiveness by batching session replay and moving blocking work off the event loop.
+- Updated the bundled `synapse-core-tool` dependency metadata to v0.1.3.
+
+---
+
 ## v0.1.32
 
 ### New Features

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: synapse-cli-agent
-Version: 0.1.32
+Version: 0.1.34
 Summary: Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)
 Project-URL: Homepage, https://github.com/alex8224/synapse-agent
 Project-URL: Repository, https://github.com/alex8224/synapse-agent
@@ -339,7 +339,7 @@ Three ways to talk to it:
 - **MCP built in** — attach MCP servers and their tools appear in the agent automatically.
 - **Sessions that resume** — SQLite checkpoints, a global project catalog across all your projects, and a lightweight paged transcript so even huge sessions reopen fast.
 - **Memory and skills** — `AGENTS.md` memory plus Agent Skills (`skills/**`) that load only when relevant.
-- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation.
+- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation, plus user-defined subagents from `.synapse/agents/*.md`.
 - **Approvals when you want them** — optional human-in-the-loop (`--require-approval`) and safety profiles.
 
 ## Slash commands

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/README.md

@@ -107,7 +107,7 @@ Three ways to talk to it:
 - **MCP built in** — attach MCP servers and their tools appear in the agent automatically.
 - **Sessions that resume** — SQLite checkpoints, a global project catalog across all your projects, and a lightweight paged transcript so even huge sessions reopen fast.
 - **Memory and skills** — `AGENTS.md` memory plus Agent Skills (`skills/**`) that load only when relevant.
-- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation.
+- **Sub-agents** — built-in `researcher`, `tester`, and `reviewer` roles for parallel delegation, plus user-defined subagents from `.synapse/agents/*.md`.
 - **Approvals when you want them** — optional human-in-the-loop (`--require-approval`) and safety profiles.
 
 ## Slash commands

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/README.zh-CN.md

@@ -125,6 +125,7 @@ Synapse 采用**分层配置**策略：用户全局配置（`~/.synapse/`）与
   mcp.json               # MCP Server 定义
   settings.json          # 非敏感 Settings 覆盖
   themes.json            # 自定义 UI 主题
+  agents/                # 自定义子代理定义（*.md，YAML frontmatter + system prompt 正文）
 
 <workspace>/.synapse/    # 项目层（优先级高，覆盖用户层）
   models.json
@@ -132,6 +133,7 @@ Synapse 采用**分层配置**策略：用户全局配置（`~/.synapse/`）与
   settings.json
   themes.json
   system_prompt.md       # 自定义系统提示
+  agents/                # 项目级子代理定义（同名覆盖用户层）
   sessions.sqlite
   checkpoints.sqlite
 ```

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/docs/architecture-flow.md

@@ -2,7 +2,7 @@
 
 > 基于 `src/synapse/**/*.py` 全部源文件分析，版本 v0.1.10+
 > 侧重**运行时流程与组件交互**。结构总览参见 `docs/architecture.md`
-> 第四轮更新：完整15中间件栈 / 工具输出变换管道 / DAG子代理调度 / MCP SessionPool / 交互账本 / Steer中程引导（2025-07）
+> 第四轮更新：完整15中间件栈 / 工具输出变换管道 / MCP SessionPool / 交互账本 / Steer中程引导（2025-07）
 
 ---
 
@@ -85,21 +85,20 @@ Settings
   ├─ 8. _build_checkpointer(settings)                ← AsyncSqliteSaver / MemorySaver
   ├─ 9. 解析 memory_paths / skills_paths
   ├─ 10. build_default_subagents(...)                ← researcher / tester / reviewer
-  ├─ 11. DAGSubAgentMiddleware (可选, 并行模式)
-  ├─ 12. build_filesystem_permissions(...)           ← 默认 None (LocalShellBackend)
-  ├─ 13. 构造工具列表: session_tools + MCP tools + extra_tools
-  ├─ 14. MCP 加载决策 (eager / deferred)
-  ├─ 15. 初始化 ToolOutputRepository + ToolOutputTransformPipeline
-  ├─ 16. 组装 middleware 列表 (15个中间件, 见第三节)
-  ├─ 17. 可选: RAG (ProjectKnowledgeBase) / LTM (LongTermMemory)
+  ├─ 11. build_filesystem_permissions(...)           ← 默认 None (LocalShellBackend)
+  ├─ 12. 构造工具列表: session_tools + MCP tools + extra_tools
+  ├─ 13. MCP 加载决策 (eager / deferred)
+  ├─ 14. 初始化 ToolOutputRepository + ToolOutputTransformPipeline
+  ├─ 15. 组装 middleware 列表 (14个中间件, 见第三节)
+  ├─ 16. 可选: RAG (ProjectKnowledgeBase) / LTM (LongTermMemory)
   │
-  └─ 18. create_deep_agent(
+  └─ 17. create_deep_agent(
          model=model,
          system_prompt=build_system_prompt(root),
          backend=backend, tools=tools,
-         middleware=middleware,       ← 15个中间件
+         middleware=middleware,       ← 14个中间件
          memory=memory_paths, skills=skills_paths,
-         subagents=None,             ← DAGSubAgentMiddleware 接管
+         subagents=subagents,        ← deepagents 原生委派
          permissions=None,           ← LocalShellBackend 不兼容
          interrupt_on=None,          ← dev-autopass 无中断
          checkpointer=saver, debug=settings.debug,
@@ -136,7 +135,6 @@ deferred → 仅读服务器名称(UI状态栏), 后续 /mcp reload 触发 hot-a
 | `_coding_checkpointer` | AsyncSqliteSaver 实例 |
 | `_coding_steer_queue` | SteerQueue (跨图重建保持) |
 | `_coding_subagents` | subagent 声明列表 |
-| `_coding_parallel_subagents` | DAG 并行模式是否激活 |
 | `_coding_async_only` | 是否仅支持异步调用 |
 | `_coding_mcp_attached` | MCP 是否已连接 |
 | `_coding_knowledge_base` | ProjectKnowledgeBase (可选) |
@@ -161,12 +159,12 @@ deferred → 仅读服务器名称(UI状态栏), 后续 /mcp reload 触发 hot-a
 | 9 | **IntentSchemaMiddleware** (x2) | `build_intent_schema_middleware()` | before_model+after_tool | 注入/剥离 intent 字段 |
 | 10 | **SteerMiddleware** | `build_steer_middleware(steer_queue)` | before_model | 中程用户引导注入 |
 | 11 | **CompactToolMiddleware** | `build_compact_tool_middleware()` | after_tool | compact_conversation 工具 |
-| 12 | **DAGSubAgentMiddleware** (可选) | `DAGSubAgentMiddleware(...)` | before_model | DAG并行子代理调度 |
-| 13 | **StripRedundantPromptMiddleware** | `build_strip_redundant_prompt_blocks()` | before_model | 移除冗余 blocks |
-| 14 | **CompactToolDescriptionsMiddleware** | `build_compact_tool_descriptions()` | before_model | 压缩工具描述(~30K token) |
-| 15 | **ModelRequestCompressionMiddleware** | `build_model_request_compression_middleware()` | before_model | 诊断:token计数,stale替换 |
+> 注：仓库曾引入自研 `DAGSubAgentMiddleware`（第12位，可选），已回退。当前子代理走 deepagents 原生 `SubAgentMiddleware`（框架内置，不在本表）。
+| 12 | **StripRedundantPromptMiddleware** | `build_strip_redundant_prompt_blocks()` | before_model | 移除冗余 blocks |
+| 13 | **CompactToolDescriptionsMiddleware** | `build_compact_tool_descriptions()` | before_model | 压缩工具描述(~30K token) |
+| 14 | **ModelRequestCompressionMiddleware** | `build_model_request_compression_middleware()` | before_model | 诊断:token计数,stale替换 |
 
-> deepagents 内置中间件(框架自动添加): SummarizationMiddleware, FilesystemMiddleware, TodoListMiddleware, SkillsMiddleware, MemoryMiddleware。DAGSubAgentMiddleware 替代内置 SubAgentMiddleware。
+> deepagents 内置中间件(框架自动添加): SummarizationMiddleware, FilesystemMiddleware, TodoListMiddleware, SkillsMiddleware, MemoryMiddleware, SubAgentMiddleware。
 
 ### 3.2 洋葱模型执行顺序
 
@@ -242,7 +240,7 @@ before_model:
 │  4. LangGraph ToolNode 路由                              │
 │     ├─ 文件工具 → FilesystemMiddleware → backend         │
 │     ├─ execute → CodingLocalShellBackend._execute()      │
-│     ├─ task → DAGSubAgentMiddleware                      │
+│     ├─ task → SubAgentMiddleware (原生)                      │
 │     └─ compact_conversation → SummarizationMiddleware    │
 │  5. wrap_tool_call 洋葱层                                │
 │     PathNormalize → Intent(strip) → ErrorRecovery →      │
@@ -369,20 +367,17 @@ interaction_events      ← 模型/工具交互事件
 | **自定义 model** | researcher_model | tester_model | reviewer_model |
 | **共同排除** | write_todos | write_todos | write_todos |
 
-### 7.2 DAGSubAgentMiddleware 调度算法
+### 7.2 子 Agent 调度（deepagents 原生 SubAgentMiddleware）
 
 ```
-_execute_dag(task_calls):
-  1. 解析 task 调用 → tasks 列表
-  2. while remaining:
-       ready, remaining = _topological_waves(remaining, completed)
-       if not ready and remaining → 死锁报错
-       batch = ready[:max_parallel]  (默认6)
-       ★ asyncio.gather(*batch) 并行执行
-  3. 返回 (results, task_wave, task_deps, total_waves)
+SubAgentMiddleware (deepagents 内置):
+  1. 主 Agent 在模型输出中调用 task(subagent_type, description)
+  2. ToolNode 阶段执行: 每个 task 编译为独立子图 (独立上下文)
+  3. 子 Agent 完成后仅返回最终文本 → ToolMessage
+  4. 主 Agent 收到所有 task 结果后继续推理
 ```
 
-**depends_on 语义**: 依赖任务输出注入下游描述；循环依赖→ValueError；task() 同步阻塞: 同轮 task 在本轮内全部执行完。
+子 Agent 工具隔离由 `build_default_subagents()` 的 tool-exclusion middleware 实现；无 depends_on / task_id / 波次并行。
 
 ---
 
@@ -473,7 +468,7 @@ load_settings(**overrides):
 | 安全 | require_approval(False), safety_profile("dev-autopass") | -- |
 | 检查点 | checkpoint_backend("sqlite") | project/.synapse/ |
 | 工具输出 | enable_tool_output_transform(True), threshold_bytes(512) | -- |
-| 子代理 | enable_subagents(True), parallel_subagents(False), max_parallel(6) | -- |
+| 子代理 | enable_subagents(True) | -- |
 | MCP | enable_mcp(True), mcp_eager(False) | -- |
 | UI | theme("cursor-dark"), history_tail_turns(20) | -- |
 | 记忆/RAG | enable_memory(False), enable_rag(False) | -- |
@@ -570,8 +565,8 @@ Tab 补全: slash_complete.py 按命令分派，支持模型名/会话ID/服务
           │              build_coding_agent()                       │
           │  Middleware: 15 个中间件 (洋葱模型)                      │
           │  Tools: session_tools + MCP tools                       │
-          │  Subagents: DAGSubAgentMiddleware (researcher/tester/   │
-          │             reviewer, max_parallel=6)                   │
+          │  Subagents: deepagents 原生委派 (researcher/tester/      │
+          │             reviewer)                                    │
           │  Backend: CodingLocalShellBackend (UTF-8, pwsh)         │
           │  Checkpointer: AsyncSqliteSaver (WAL)                   │
           └──────────────────────────┬──────────────────────────────┘
@@ -611,7 +606,7 @@ agent.py ──────┬──▶ agent_md.py (AgentMdMiddleware)
                ├──▶ middleware.py (retry, path_normalize, intent, ...)
                ├──▶ steer.py (SteerQueue → SteerMiddleware)
                ├──▶ context_compact.py (SummarizationToolMiddleware)
-               ├──▶ subagents.py → parallel_subagents.py (DAG)
+               ├──▶ subagents.py (researcher/tester/reviewer specs)
                ├──▶ fs_permissions.py (None for LocalShell)
                ├──▶ model_request_compression_middleware.py
                ├──▶ tool_output_middleware.py

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/docs/architecture.md

@@ -108,10 +108,9 @@
 │  │  │ 9. IntentSchema (x2)         工具注入/剥离 intent 字段  │ │  │
 │  │  │ 10. SteerMiddleware           中程用户引导注入           │ │  │
 │  │  │ 11. CompactTool              compact_conversation 工具   │ │  │
-│  │  │ 12. DAGSubAgentMiddleware    DAG 并行子Agent 调度       │ │  │
-│  │  │ 13. StripRedundantPrompt      移除冗余 prompt blocks     │ │  │
-│  │  │ 14. CompactToolDescriptions   压缩冗长工具描述           │ │  │
-│  │  │ 15. ModelRequestCompression   诊断:token计数,stale替换   │ │  │
+│  │  │ 12. StripRedundantPrompt      移除冗余 prompt blocks     │ │  │
+│  │  │ 13. CompactToolDescriptions   压缩冗长工具描述           │ │  │
+│  │  │ 14. ModelRequestCompression   诊断:token计数,stale替换   │ │  │
 │  │  └─────────────────────────────────────────────────────────┘ │  │
 │  │                                                               │  │
 │  │  deepagents 内置中间件 (框架自动添加):                         │  │
@@ -122,7 +121,7 @@
 │  │  ├─ model:        BaseChatModel (来自 models_registry)       │  │
 │  │  ├─ backend:      CodingLocalShellBackend                     │  │
 │  │  ├─ tools:        [session_tools] + [MCP tools]               │  │
-│  │  ├─ subagents:    None (由 DAGSubAgentMiddleware 接管)        │  │
+│  │  ├─ subagents:    subagents (deepagents 原生委派)             │  │
 │  │  ├─ checkpointer: AsyncSqliteSaver / MemorySaver              │  │
 │  │  ├─ interrupt_on: None (dev-autopass 默认无HITL)               │  │
 │  │  └─ permissions:  FilesystemPermission (非shell模式)          │  │
@@ -130,19 +129,26 @@
 │                                                                     │
 │  ┌────────────────────  子Agent 系统  ──────────────────────────┐  │
 │  │                                                               │  │
-│  │  subagents.py          parallel_subagents.py                  │  │
-│  │  build_default_subagents() → 3 种规范:                        │  │
-│  │  ┌──────────┬──────────┬──────────┐                          │  │
-│  │  │researcher│  tester  │ reviewer │                          │  │
-│  │  │ 只读分析  │ 运行测试 │ 代码审查 │                          │  │
-│  │  │ 无execute│ execute  │ 无write  │                          │  │
-│  │  └──────────┴──────────┴──────────┘                          │  │
+│  │  subagent_specs.py  (定义/注册/编译 三层)                     │  │
+│  │  ├─ SubAgentDefinition: 拓扑无关声明                          │  │
+│  │  │   name/description/system_prompt/model/tools               │  │
+│  │  │   ownership(预留 handoff)/output_schema(预留 workflow)     │  │
+│  │  ├─ SubagentRegistry: 分层加载 .synapse/agents/*.md          │  │
+│  │  │   user → project 同名覆盖 · 坏文件降级跳过                 │  │
+│  │  └─ compile_task_specs: Definition → deepagents SubAgent      │  │
 │  │                                                               │  │
-│  │  DAGSubAgentMiddleware                                        │  │
-│  │  ├─ _execute_dag()  解析 task() tool_calls                    │  │
-│  │  ├─ _topological_waves() 拓扑排序→波次分组                    │  │
-│  │  ├─ asyncio.gather(*batch) 波次内并行                        │  │
-│  │  └─ depends_on 声明依赖关系                                   │  │
+│  │  subagents.py                                                 │  │
+│  │  build_default_subagents() → 内置 + 自定义合并 → 3+ 规范:       │  │
+│  │  ┌──────────┬──────────┬──────────┬──────────────┐            │  │
+│  │  │researcher│  tester  │ reviewer │ 自定义...     │            │  │
+│  │  │ 只读分析  │ 运行测试 │ 代码审查 │ 用户定义      │            │  │
+│  │  │ 无execute│ execute  │ 无write  │ 覆盖/追加     │            │  │
+│  │  └──────────┴──────────┴──────────┴──────────────┘            │  │
+│  │                                                               │  │
+│  │  deepagents SubAgentMiddleware (原生)                          │  │
+│  │  ├─ task 工具 → ToolNode 阶段执行                                │  │
+│  │  ├─ 子 Agent 在独立子图上下文运行                                │  │
+│  │  └─ 结果仅返回最终文本给主 Agent                                │  │
 │  └──────────────────────────────────────────────────────────────┘  │
 │                                                                     │
 │  ┌────────────────────  工具系统  ──────────────────────────────┐  │
@@ -265,7 +271,6 @@ cli.py
         ├── backends.py           ← CodingLocalShellBackend
         ├── middleware.py         ← 中间件工厂
         ├── subagents.py          ← 子Agent 规范
-        ├── parallel_subagents.py ← DAG 调度
         ├── mcp_client.py         ← MCP 集成
         ├── safety.py ── hitl.py ── fs_permissions.py
         ├── vision_middleware.py ── describe_image.py ── multimodal.py
@@ -299,7 +304,7 @@ cli.py
       ├─ vision: 图片→文字 (非视觉模型)
       ├─ retry:  429/5xx 重试
       ├─ steer:  注入用户引导
-      ├─ DAG:    发现 task() 调用 → 拓扑排序 → 波次并行子Agent
+      ├─ task:   发现 task() 调用 → SubAgentMiddleware 原生委派
       └─ compact: 自动压缩 (token阈值触发)
       │
       ▼
@@ -312,7 +317,7 @@ cli.py
       ├─ read_file/write_file/edit_file/glob/grep/execute
       │    └→ CodingLocalShellBackend (subprocess)
       ├─ task (子Agent)
-      │    └→ DAGSubAgentMiddleware (缓存结果)
+      │    └→ SubAgentMiddleware (原生子图执行)
       ├─ search_session/read_session
       │    └→ SessionStore (SQLite)
       ├─ MCP tools
@@ -361,12 +366,11 @@ cli.py
 | **工厂模式** | `build_coding_agent()`, `build_backend()`, `build_default_subagents()`, `build_session_tools()` |
 | **中间件链** | `AgentMiddleware.awrap_model_call` 链式拦截 (9 个中间件) |
 | **依赖注入** | `SessionStore` 闭包注入工具; 子Agent 中间件注入 Backend |
-| **拓扑排序+DAG** | `DAGSubAgentMiddleware._topological_waves()` 波次并行 |
-| **预编译缓存** | `compile_subagent_runnables()` 预编译子Agent图 |
+| **原生委派** | deepagents `SubAgentMiddleware` 子Agent独立子图执行 |
 | **3层覆盖配置** | 用户 `~/.synapse/` -> 便携包 -> 项目 `.synapse/` |
 | **幂等三态机** | `CodexImportLedger.claim()` (new/completed/recover) |
 | **自适应节流** | `_stream_interval()` 0.12s~0.40s 动态间隔 |
-| **退化保护** | TaskPlanner 快速启发式; MCP 连接断开自动移除; DAG 未启用时回退原生 |
+| **退化保护** | TaskPlanner 快速启发式; MCP 连接断开自动移除 |
 
 ---
 
@@ -381,7 +385,6 @@ cli.py
 | `backends.py` | `CodingLocalShellBackend`, `build_backend` | 本地 Shell 执行 |
 | `middleware.py` | `build_*_middleware` 工厂函数 | 中间件构造 |
 | `subagents.py` | `build_default_subagents` | 3 种子Agent 规范 |
-| `parallel_subagents.py` | `DAGSubAgentMiddleware` | DAG 拓扑调度 |
 | `tools/session_tools.py` | `build_session_tools` | 会话查阅工具 |
 | `mcp_client.py` | `McpSessionPool`, `load_mcp_tools` | MCP 协议集成 |
 | `planner/task_planner.py` | `TaskPlanner`, `TaskPlan` | 任务分解规划 |
@@ -463,7 +466,6 @@ TurnRail (Vertical, id="turn-rail", dock:right, overlay, width:34)
 | McpPanelDialog | `("mcp-toggle", name)` 或 `("mcp-reload", None)` | `r` 键重载 MCP 配置 |
 | SafetyPanelDialog | `("safety", key)` | 三选一 profile (dev-autopass/dev-approve/readonly) |
 | CodexSessionListDialog | `("codex-import", native_id)` | 扫描 Codex 目录，只列可导入会话 |
-| SubagentMonitorDialog | (只读) | 独占 ModalScreen，不走 DialogBase，显示 DAG 列表+详情 |
 | ThemeDesignerDialog | (直接写文件) | 独占 ModalScreen，HSV 选择器+JSON 预览+实时 CSS 刷新 |
 
 统一调用模式：`self.push_screen(SomeDialog(...), self._on_some_dialog_done)`，回调中解包 `(action, value)` 元组。
@@ -664,7 +666,7 @@ ledger.claim(source_id, digest, proposed_thread_id):
 | **上下文** | `/compact`, `/context` | 手动压缩 + 上下文状态 |
 | **安全** | `/safety [profile]`, `/approve`, `/reject [reason]` | 安全 profile + HITL 审批 |
 | **主题** | `/theme [name]` | 主题切换 |
-| **其他** | `/skills`, `/memory`, `/subagents` | 技能/记忆/子代理状态 |
+| **其他** | `/skills`, `/memory`, `/subagent` | 技能/记忆/子代理模型配置（`/subagent` 仅 TUI） |
 
 **SlashResult 三种逻辑状态**: `handled`（已处理，显示 lines）→ `passthru`（非斜杠命令，传递给 LLM）→ `rebuild`（agent 非 None，模型/MCP/安全变更需重建图）。
 
@@ -680,22 +682,6 @@ ledger.claim(source_id, digest, proposed_thread_id):
 
 **实现原理**: 7x5 像素位图 → Unicode Braille 字符（每个 Braille 格编码 4x2 点阵）。`_breathing_intensity()` 计算每个字符亮度：呼吸分量 `sin(2π*t/5.0)` + 涟漪分量（基于距离的正弦波）+ 渐入分量（从中心扩散，0.5s 完全显现）。定时器 12 FPS（~83ms），CSS class `#main.welcome` 控制显示/隐藏。
 
-### Subagent Monitor 状态机
-
-```
-SubagentMonitor (线程安全，RLock 保护)
-  ├─ start_task() → status="running" (revision += 1)
-  ├─ finish_task(error=False) → status="ok"
-  ├─ finish_task(error=True) → status="error"
-  └─ reset() → 清空所有 runs
-
-SubagentMonitorDialog (0.35s 轮询 snapshot，revision 去重)
-  ├─ 左侧列表: task_id / type / wave / depends_on / status
-  └─ 右侧详情: description + event 层级树
-```
-
-`SubagentMonitorCallback(BaseCallbackHandler)` 注入到子 Agent 的 callbacks 中：`on_llm_end` 捕获 tool_calls → `on_tool_start/end/error` 实时产生 events。通过全局 `_REGISTRY` + `monitor_from_config(config)` 查找 Monitor 实例。
-
 ---
 
 ## 补充架构流程细节
@@ -716,10 +702,9 @@ SubagentMonitorDialog (0.35s 轮询 snapshot，revision 去重)
  9. build_intent_schema_middleware()         # 注入/剥离 intent 字段 (双面中间件)
 10. build_steer_middleware()                 # 中运行用户引导 (SteerQueue)
 11. build_compact_tool_middleware()          # compact_conversation 工具 (SummarizationTool)
-12. [DAG 子 Agent 中间件]                    # 可选: ParallelSubagentMiddleware
-13. build_strip_redundant_prompt_blocks()    # 移除 deepagents 冗余 prompt (~720 tokens)
-14. build_compact_tool_descriptions()        # 精简工具描述 (~30K tokens)
-15. build_model_request_compression_middleware() # 请求级压缩诊断 + token 分桶
+12. build_strip_redundant_prompt_blocks()    # 移除 deepagents 冗余 prompt (~720 tokens)
+13. build_compact_tool_descriptions()        # 精简工具描述 (~30K tokens)
+14. build_model_request_compression_middleware() # 请求级压缩诊断 + token 分桶
 ```
 
 **执行语义**:
@@ -959,31 +944,25 @@ repair_thread_after_cancel(agent, config) → list[str] (日志)
     └─ SessionStore.touch() 更新元数据
 ```
 
-### 子 Agent DAG 调度流程
+### 子 Agent 委派流程
 
 ```
 用户输入: "分析 bug 并写测试和审查修复"
 │
-├─ decide_subagent_routing(text) → 启发式判断是否适合 DAG 并行
-│   (检查关键词: "并"/"同时"/"并行"/多个任务...)
-│
-├─ 适合 → 注入 DAG 规划指令到 system prompt
+├─ build_coding_agent() 把 subagents 传给 create_deep_agent(subagents=...)
+│   (researcher / tester / reviewer, deepagents 原生 SubAgentMiddleware)
 │
-├─ 模型输出多个 task() tool_calls, 含 depends_on 声明:
-│   task("researcher", "搜索 bug 原因", task_id="search")
-│   task("tester", "基于搜索结果写测试", depends_on=["search"], task_id="test")
-│   task("reviewer", "审查修复", depends_on=["test"], task_id="review")
+├─ 模型按需输出 task() tool_calls:
+│   task("researcher", "搜索 bug 原因")
+│   task("tester", "运行测试并诊断失败")
+│   task("reviewer", "审查修复")
 │
-├─ DAGSubAgentMiddleware 拦截 tool_calls:
-│   ├─ _parse_dag() → 提取 task_id / depends_on
-│   ├─ _topological_waves() → 拓扑排序:
-│   │   Wave 1: [search]          ← 无依赖
-│   │   Wave 2: [test]            ← 依赖 search
-│   │   Wave 3: [review]          ← 依赖 test
-│   └─ 波次内并行: asyncio.gather(*wave_tasks)
-│       波次间串行: 等待上一波完成
+├─ SubAgentMiddleware 在 ToolNode 阶段执行:
+│   ├─ 每个子 Agent 在独立子图上下文运行
+│   ├─ 只读工具集由 tool-exclusion middleware 约束
+│   └─ 结果仅返回最终文本给主 Agent
 │
-└─ 不适合 → 回退原生顺序执行 (depends_on 仍被遵守，只是不并行)
+└─ 主 Agent 汇总所有子 Agent 结果后继续推理
 ```
 
 ### SteerQueue — 中运行用户引导

{synapse_cli_agent-0.1.32 → synapse_cli_agent-0.1.34}/docs/config.md

@@ -101,6 +101,43 @@ Synapse 使用 **Pydantic Settings** 实现分层配置系统。
 | `AGENT_ENABLE_SUBAGENTS` | `true` | 启用子代理 |
 | `AGENT_SUBAGENT_TESTER_MODEL` | — | Tester 子代理模型 |
 | `AGENT_SUBAGENT_REVIEWER_MODEL` | — | Reviewer 子代理模型 |
+| `AGENT_SUBAGENT_RESEARCHER_MODEL` | — | Researcher 子代理模型 |
+| `AGENT_ENABLE_CUSTOM_SUBAGENTS` | `true` | 加载用户自定义子代理（`.synapse/agents/*.md`） |
+| `AGENT_CUSTOM_AGENTS_DIRS` | `[]` | 额外扫描的子代理定义目录（JSON 数组，绝对路径或相对 workspace） |
+| `AGENT_DISABLE_BUILTIN_SUBAGENTS` | `[]` | 禁用的内置子代理名（JSON 数组，如 `["tester"]`） |
+| `AGENT_SUBAGENT_DEFAULT_MODEL` | — | 所有子代理的全局默认模型；未配置时继承主 Agent 模型 |
+| `AGENT_SUBAGENT_DEFAULT_REASONING_EFFORT` | — | 所有子代理的全局默认推理级别（`off`/`minimal`/`low`/`medium`/`high`/`max`） |
+| `AGENT_SUBAGENT_MODEL_OVERRIDES_JSON` | `{}` | 按子代理名覆盖模型（JSON 对象，如 `{"tester":"algo:1"}`） |
+| `AGENT_SUBAGENT_REASONING_EFFORT_OVERRIDES_JSON` | `{}` | 按子代理名覆盖推理级别（JSON 对象） |
+
+#### 自定义子代理
+
+在用户层 `~/.synapse/agents/*.md` 或项目层 `<workspace>/.synapse/agents/*.md` 放置
+Markdown 文件即可新增子代理（项目层覆盖用户层同名定义）。YAML frontmatter 提供元数据，
+文件正文是子代理的 system prompt：
+
+```markdown
+---
+name: security-reviewer
+description: Use after security-sensitive changes. Reviews for injection and secret leaks.
+model: inherit            # 或 "provider:model-name"
+reasoning_effort: high    # 可选：off/minimal/low/medium/high/max；缺省继承主 Agent
+tools: [read_file, search_files, find_files, execute]   # 可选 allowlist；省略则继承 find_files/search_files
+disallowed_tools: [write_file, edit_file]               # 可选 denylist
+ownership: task           # 预留字段，仅支持 task
+---
+
+You are a security reviewer. Inspect diffs for...
+```
+
+- `name` 与内置（researcher/tester/reviewer）同名时覆盖内置定义。
+- `tools: []` 表示仅使用 deepagents 内置工具（不继承主代理工具）。
+- 解析失败的文件会被跳过并记录 warning，不会导致启动失败。
+- `ownership` / `output_schema` 为未来 handoff 与 workflow 编排预留，当前仅支持 `task`。
+- 首次启动会在 `~/.synapse/agents/` 生成 `researcher.md` / `tester.md` / `reviewer.md`
+  种子文件，编辑即可覆盖内置；已编辑内容不会被覆盖。同名文件存在但未显式写 `model`
+  时，`AGENT_SUBAGENT_*_MODEL` 仍会注入；在文件里显式写 `model`（或 `model: inherit`）
+  后由文件接管。
 
 ### MCP