BrowserOS/packages/browseros-agent/apps/agent/entrypoints/app/agent-command/useAgentCardData.ts

import {
  type AgentEntry,
  getModelDisplayName,
  type OpenClawStatus,
} from '@/entrypoints/app/agents/useOpenClaw'
import type { AgentCardData } from '@/lib/agent-conversations/types'
import type { AgentOverview } from './useAgentDashboard'

function resolveAgentStatus(
  gatewayStatus: OpenClawStatus['status'] | undefined,
  liveStatus: AgentOverview['status'] | undefined,
): AgentCardData['status'] {
  // Gateway-level errors take precedence
  if (gatewayStatus === 'error') return 'error'
  if (gatewayStatus === 'starting') return 'working'

  // Per-agent live status from the WS observer
  if (liveStatus === 'working') return 'working'
  if (liveStatus === 'error') return 'error'

  return 'idle'
}

/**
 * Build agent card display data by merging the raw agent entries from
 * the gateway with enriched overview data from the dashboard API.
 *
 * Pure function — no hooks, no IndexedDB, no async.
 */
export function buildAgentCardData(
  agents: AgentEntry[],
  status: OpenClawStatus['status'] | undefined,
  dashboard: AgentOverview[] | undefined,
): AgentCardData[] {
  return agents.map((agent) => {
    const overview = dashboard?.find((d) => d.agentId === agent.agentId)

    return {
      agentId: agent.agentId,
      name: agent.name,
      model: getModelDisplayName(agent.model),
      status:
        agent.source === 'agent-harness'
          ? 'idle'
          : resolveAgentStatus(status, overview?.status),
      lastMessage: overview?.latestMessage?.slice(0, 200) ?? undefined,
      lastMessageTimestamp: overview?.latestMessageAt ?? undefined,
      activitySummary: overview?.activitySummary ?? undefined,
      currentTool: overview?.currentTool ?? undefined,
      costUsd: overview?.totalCostUsd ?? undefined,
    }
  })
}