Agent Runner 插件化实现进度

本文档跟踪 Agent Runner 插件化的实现状态，便于快速了解当前进度。

总体进度

当前阶段: Phase 3 已完成，Event-first 基础设施已完成

Phase	描述	状态
Phase 0	PoC 验证	✅ 完成
Phase 1	核心架构（Registry、Orchestrator、上下文模型）	✅ 完成
Phase 2	权限、能力声明、资源注入	✅ 完成
Phase 3	内置 runner 迁移到插件	✅ 完成（7/7）
Phase 3.5	Event-first 基础设施	✅ 完成
Phase 4	EBA 事件支持	🔲 未开始（已预留 event-first 入口，EventGateway 由其他分支实现）

组件	状态	备注
`AgentRunner` 组件	✅	`api/definition/components/agent_runner/runner.py`
`AgentRunContext`	✅	`api/entities/builtin/agent_runner/context.py`
`AgentRunResult`	✅	`api/entities/builtin/agent_runner/result.py`
`AgentRunnerCapabilities`	✅	`api/entities/builtin/agent_runner/capabilities.py`
`AgentRunnerPermissions`	✅	`api/entities/builtin/agent_runner/permissions.py`
EBA 事件模型 (Event/Actor/Subject)	✅	`api/entities/builtin/agent_runner/event.py`
`LIST_AGENT_RUNNERS` action	✅	`runtime/io/handlers/control.py`
`RUN_AGENT` action	✅	`runtime/io/handlers/control.py`
`AgentRunAPIProxy`	✅	`api/proxies/agent_run_api.py`
Pull API handlers (State/History/Event/Artifact)	✅	`runtime/io/handlers/plugin.py`
`caller_plugin_identity` injection	✅	Pull API handlers inject caller identity

组件	状态	备注
`AgentRunnerRegistry`	✅	`pkg/agent/runner/registry.py`
`AgentRunOrchestrator`	✅	`pkg/agent/runner/orchestrator.py` - event-first `run(event, binding)`
`AgentRunnerDescriptor`	✅	`pkg/agent/runner/descriptor.py`
`AgentResourceBuilder`	✅	`pkg/agent/runner/resource_builder.py`
`AgentRunContextBuilder`	✅	`pkg/agent/runner/context_builder.py` - event-first context
`AgentResultNormalizer`	✅	`pkg/agent/runner/result_normalizer.py`
`ConfigMigration`	✅	`pkg/agent/runner/config_migration.py`
`PipelineAdapter`	✅	`pkg/agent/runner/pipeline_adapter.py` - Query → Event + Binding
`run_from_query()` → `run(event, binding)`	✅	Pipeline 路径委托到 event-first path
`ChatMessageHandler` 集成	✅	使用 orchestrator 替代 wrapper
`PipelineService` 集成	✅	从 registry 获取 runner metadata
Plugin connector	✅	`list_agent_runners()` / `run_agent()`
`EventLogStore`	✅	`pkg/agent/runner/event_log_store.py`
`TranscriptStore`	✅	`pkg/agent/runner/transcript_store.py`
`ArtifactStore`	✅	`pkg/agent/runner/artifact_store.py`
`PersistentStateStore`	✅	`pkg/agent/runner/persistent_state_store.py`
History / Event pull APIs	✅	Orchestrator + APIProxy
Artifact pull APIs	✅	Orchestrator + APIProxy
State pull APIs	✅	Orchestrator + APIProxy
`artifact.created` / `state.updated` handling	✅	Event-first handlers in orchestrator
Pipeline path host capability coverage	✅	EventLog/Transcript/ArtifactStore/PersistentStateStore

外部服务插件仓库：/home/glwuy/langbot-app/langbot-agent-runner/
本地 Local Agent 插件仓库：/home/glwuy/langbot-app/langbot-local-agent/

插件	状态	备注
`local-agent`	✅ 已完成	核心功能：模型、工具、知识库、流式、会话
`dify-agent`	✅ 已完成	支持 chat/agent/workflow 三种应用类型
`n8n-agent`	✅ 已完成	Webhook 调用，支持 basic/jwt/header 认证
`coze-agent`	✅ 已完成	多模态输入，思维链处理
`dashscope-agent`	✅ 已完成	阿里云百炼，支持 agent/workflow 两种模式
`langflow-agent`	✅ 已完成	SSE 流式，tweaks 配置支持
`tbox-agent`	✅ 已完成	蚂蚁百宝箱，多模态输入

注意: LangBot 内置 runner（pkg/provider/runners/）已停用，文件顶部添加了 DEPRECATED 注释。

以下项目属于本分支收尾工作：

以下能力由其他分支负责：

能力	负责分支	备注
EventGateway implementation	event branch	完整事件网关、事件路由、持久化管理
Event subscription / notification	event branch	事件订阅、推送通知
BindingResolver persistence UI	其他模块	绑定配置的持久化 UI
Event router integration	event branch	与 BindingResolver 集成
Scheduler / background event source	其他模块	定时任务、后台事件源

工具详情 API — SDK GET_TOOL_DETAIL action、AgentRunAPIProxy.get_tool_detail() 与 Host 侧授权校验已接通
Pipeline run_from_query() → run(event, binding) — 已完成
EventLog / Transcript / ArtifactStore / PersistentStateStore — 已完成
History / Event / Artifact / State pull APIs — 已完成
caller_plugin_identity 验证路径 — 已完成

日期	决策
2026-05-10	Phase 0 集成测试通过，SDK v1 协议验证成功
2026-05-13	Phase 3 完成：所有 7 个官方 runner 插件迁移完成
2026-05-23	Phase 3.5 完成：`run_from_query()` 委托到 event-first `run(event, binding)`，Pipeline path 获得 host capabilities