Feat/agent runner plugin

docs/agent-runner-pluginization/PHASE0_INTEGRATION_LOG.md

@@ -0,0 +1,125 @@
+# AgentRunner Pluginization Phase 0 聃调记录
+
+## 时间
+
+2026-05-10 10:09
+
+## 参与仓库
+
+- **langbot-plugin-sdk**: feat/agent-runner-plugin 分支
+- **LangBot**: feat/agent-runner-plugin 分支
+- **langbot-agent-runner**: feat/agent-runner-plugin 分支
+
+## 聃调配置
+
+### Runner 选择
+
+```
+plugin:langbot/local-agent/default
+```
+
+### 输入
+
+```
+1
+```
+
+### 输出
+
+```
+[stub] Echo: 1
+```
+
+## 验证链路
+
+```
+前端选择 plugin:langbot/local-agent/default
+  -> LangBot pipeline
+  -> AgentRunOrchestrator
+  -> SDK runtime RUN_AGENT
+  -> langbot-agent-runner/local-agent DefaultAgentRunner
+  -> AgentRunResult
+  -> LangBot response
+```
+
+## 协议要点
+
+### LIST_AGENT_RUNNERS 响应 (v1)
+
+```json
+{
+  "runners": [
+    {
+      "plugin_author": "langbot",
+      "plugin_name": "local-agent",
+      "runner_name": "default",
+      "manifest": { ... },
+      "protocol_version": "1",
+      "capabilities": { ... },
+      "permissions": { ... },
+      "config": []
+    }
+  ]
+}
+```
+
+### RUN_AGENT 流式响应 (v1)
+
+```json
+{
+  "type": "run.completed",
+  "data": {
+    "message": {
+      "role": "assistant",
+      "content": "[stub] Echo: 1"
+    },
+    "finish_reason": "stop"
+  }
+}
+```
+
+## 结论
+
+LangBot + SDK + runner repo Phase 0 聃调通过。
+
+这是最小协议闭环，证明新 AgentRunner 插件化主链路可运行。
+
+## 下一步
+
+1. **Phase 1: 迁 Dify** - 让 dify-agent 从 stub 变成真实实现
+2. **LangBot 后续项**:
+   - 前端保存新格式 `ai.runner.id` / `ai.runner_config`
+   - 持久化 migration
+   - 模板 `ai.yaml/default-pipeline-config.json` 更新
+   - proxy action 二次权限校验
+
+---
+
+## Phase 3 完成记录 (2026-05-13)
+
+### 迁移完成
+
+所有 7 个官方 runner 插件已完成迁移：
+
+| 插件 | 状态 | 实现位置 |
+|------|------|----------|
+| local-agent | ✅ | `langbot-local-agent/` (独立仓库) |
+| dify-agent | ✅ | `langbot-agent-runner/dify-agent/` |
+| n8n-agent | ✅ | `langbot-agent-runner/n8n-agent/` |
+| coze-agent | ✅ | `langbot-agent-runner/coze-agent/` |
+| dashscope-agent | ✅ | `langbot-agent-runner/dashscope-agent/` |
+| langflow-agent | ✅ | `langbot-agent-runner/langflow-agent/` |
+| tbox-agent | ✅ | `langbot-agent-runner/tbox-agent/` |
+
+### 新增文件
+
+每个插件包含：
+- `components/agent_runner/default.py` - AgentRunner 实现
+- `components/agent_runner/default.yaml` - 组件 manifest
+- `pkg/*_client.py` - 平台 API 客户端
+- `main.py` - 插件入口
+
+### LangBot 侧变更
+
+- 旧 runner 文件标记为 legacy（添加 DEPRECATED docstring）
+- 新增 `PROGRESS.md` 跟踪实现进度