openclaw-agent-dashboard 1.0.4

package/src/backend/api/agents.py

@@ -0,0 +1,73 @@
+"""
+Agent API 路由
+"""
+from fastapi import APIRouter
+from pydantic import BaseModel
+from typing import List, Optional
+import sys
+from pathlib import Path
+sys.path.append(str(Path(__file__).parent.parent))
+
+from status.status_calculator import (
+    get_agents_with_status,
+    format_last_active
+)
+
+router = APIRouter()
+
+
+class AgentStatus(BaseModel):
+    id: str
+    name: str
+    role: str
+    status: str  # idle/working/down
+    currentTask: Optional[str] = None
+    lastActiveAt: Optional[int] = None
+    lastActiveFormatted: Optional[str] = None
+    error: Optional[dict] = None
+
+
+@router.get("/agents", response_model=List[AgentStatus])
+async def get_agents():
+    """获取所有 Agent 列表及状态"""
+    agents = get_agents_with_status()
+    
+    # 格式化最后活跃时间
+    for agent in agents:
+        if agent.get('lastActiveAt'):
+            agent['lastActiveFormatted'] = format_last_active(agent['lastActiveAt'])
+    
+    return agents
+
+
+@router.get("/agents/{agent_id}", response_model=AgentStatus)
+async def get_agent(agent_id: str):
+    """获取单个 Agent 详情"""
+    agents = get_agents_with_status()
+    
+    for agent in agents:
+        if agent['id'] == agent_id:
+            if agent.get('lastActiveAt'):
+                agent['lastActiveFormatted'] = format_last_active(agent['lastActiveAt'])
+            return agent
+    
+    from fastapi import HTTPException
+    raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
+
+
+@router.get("/agents/{agent_id}/output")
+async def get_agent_output(agent_id: str, limit: int = 50):
+    """
+    获取 Agent 最近会话详情：每轮 user/assistant/toolResult 及 usage
+    用于调试视图展示
+    """
+    from data.session_reader import get_session_turns
+    from data.config_reader import get_agents_list
+    
+    agents = get_agents_list()
+    if not any(a.get('id') == agent_id for a in agents):
+        from fastapi import HTTPException
+        raise HTTPException(status_code=404, detail=f"Agent {agent_id} not found")
+    
+    turns = get_session_turns(agent_id, limit=limit)
+    return {"agentId": agent_id, "turns": turns}

package/src/backend/api/agents_config.py

@@ -0,0 +1,75 @@
+"""
+Agent 配置 API - 直接从 openclaw.json 读取
+仅依赖 config_reader，无其他模块依赖，作为协作流程的兜底数据源
+"""
+from fastapi import APIRouter
+from typing import List, Dict, Any
+
+router = APIRouter()
+
+
+@router.get("/agents-config")
+async def get_agents_config():
+    """
+    直接从 ~/.openclaw/openclaw.json 读取 agents.list
+    返回格式与协作流程兼容，用于 API 失败时的兜底展示
+    """
+    try:
+        from data.config_reader import (
+            get_agents_list,
+            get_main_agent_id,
+            get_agent_models,
+        )
+        agents_list = get_agents_list()
+        main_id = get_main_agent_id()
+        agent_models: Dict[str, Dict[str, Any]] = {}
+        for a in agents_list:
+            aid = a.get('id', '')
+            if aid:
+                agent_models[aid] = get_agent_models(aid)
+
+        nodes = []
+        edges = []
+        for agent in agents_list:
+            aid = agent.get('id', '')
+            if not aid:
+                continue
+            name = agent.get('name', aid)
+            nodes.append({
+                'id': aid,
+                'type': 'agent',
+                'name': name,
+                'status': 'idle',
+                'metadata': agent_models.get(aid),
+            })
+            if aid != main_id:
+                edges.append({
+                    'id': f'edge-{main_id}-{aid}',
+                    'source': main_id,
+                    'target': aid,
+                    'type': 'delegates',
+                    'label': '委托',
+                })
+
+        return {
+            'nodes': nodes,
+            'edges': edges,
+            'activePath': [],
+            'mainAgentId': main_id,
+            'agentModels': agent_models,
+            'models': [],
+            'recentCalls': [],
+            'lastUpdate': int(__import__('time').time() * 1000),
+        }
+    except Exception as e:
+        return {
+            'nodes': [],
+            'edges': [],
+            'activePath': [],
+            'mainAgentId': 'main',
+            'agentModels': {},
+            'models': [],
+            'recentCalls': [],
+            'lastUpdate': 0,
+            '_error': str(e),
+        }

package/src/backend/api/chains.py

@@ -0,0 +1,126 @@
+"""
+任务链路 API 路由
+"""
+from fastapi import APIRouter, Query, HTTPException
+from pydantic import BaseModel
+from typing import Optional, List, Dict, Any
+import sys
+from pathlib import Path
+sys.path.append(str(Path(__file__).parent.parent))
+
+from data.chain_reader import (
+    build_task_chains,
+    get_task_chain,
+    get_active_chain,
+    get_chains_summary
+)
+
+router = APIRouter()
+
+
+class ChainNode(BaseModel):
+    agentId: str
+    agentName: str
+    role: str
+    status: str
+    startedAt: Optional[int] = None
+    endedAt: Optional[int] = None
+    duration: Optional[int] = None
+    task: Optional[str] = None
+    runId: Optional[str] = None
+    input: Optional[str] = None
+    output: Optional[str] = None
+    artifacts: List[str] = []
+    toolCallCount: int = 0
+    tokenUsage: Dict[str, int] = {"input": 0, "output": 0}
+
+
+class ChainEdge(BaseModel):
+    from_: str
+    to: str
+
+
+class TaskChain(BaseModel):
+    chainId: str
+    projectId: Optional[str] = None
+    rootTask: str
+    startedAt: Optional[int] = None
+    status: str
+    nodes: List[ChainNode]
+    edges: List[Dict[str, str]]
+    progress: float
+    completedNodes: int
+    totalNodes: int
+    totalDuration: int
+
+
+class TaskChainListResponse(BaseModel):
+    chains: List[TaskChain]
+    activeChain: Optional[TaskChain] = None
+
+
+class ChainSummaryResponse(BaseModel):
+    total: int
+    running: int
+    completed: int
+    error: int
+    chains: List[Dict[str, Any]]
+
+
+@router.get("/chains", response_model=TaskChainListResponse)
+async def list_chains(
+    limit: int = Query(20, ge=1, le=100, description="返回链路数量")
+):
+    """
+    获取所有任务链路列表
+
+    返回 Agent 间的任务派发链路，包括：
+    - 链路中的所有节点（Agent）
+    - 节点间的派发关系
+    - 各节点的状态和进度
+    """
+    chains = build_task_chains(limit=limit)
+    active = get_active_chain()
+
+    return {
+        "chains": chains,
+        "activeChain": active
+    }
+
+
+@router.get("/chains/summary", response_model=ChainSummaryResponse)
+async def get_summary():
+    """
+    获取任务链路摘要统计
+
+    快速查看所有链路的状态分布
+    """
+    return get_chains_summary()
+
+
+@router.get("/chains/active")
+async def get_active():
+    """
+    获取当前活跃的任务链路
+
+    返回正在执行的任务链
+    """
+    chain = get_active_chain()
+    if not chain:
+        return {"activeChain": None, "message": "当前没有正在执行的任务链"}
+
+    return {"activeChain": chain}
+
+
+@router.get("/chains/{chain_id}")
+async def get_chain(chain_id: str):
+    """
+    获取单个任务链的详情
+
+    返回完整的链路信息，包括所有节点和边
+    """
+    chain = get_task_chain(chain_id)
+    if not chain:
+        raise HTTPException(status_code=404, detail=f"Chain {chain_id} not found")
+
+    return chain