// Shapes returned by the hub console API (see backend/agenthub/api/serializers.py). export type AgentStatus = "online" | "offline" | "degraded" | "unknown"; export type TaskStatus = "queued" | "running" | "completed" | "failed" | "cancelled"; // Which product an agent is (backend/agenthub/db/models.py: AGENT_TYPES). // "custom" is what anything outside the four named products resolves to. export type AgentType = "nanobot" | "deepseek_harness" | "openclaw" | "hermes" | "custom"; export interface ConnectorInfo { connected: boolean; token_preview: string; version: string; protocol_version: number; connected_at: string | null; remote: string; pending_requests: number; } export interface Agent { id: string; name: string; display_name: string; description: string; emoji: string; agent_type: AgentType; driver: string; connection_mode: "direct" | "connector" | "embedded"; deployment_kind: "local" | "docker" | "cloud"; deployment_ref: string; base_url: string; model: string; role: string; labels: Record; capabilities: Record; status: AgentStatus; live: boolean; reachable: boolean; source: string; max_concurrency: number; active_tasks: number; last_error: string; last_heartbeat_at: string | null; heartbeat_age_s: number | null; last_probe_at: string | null; last_task_at: string | null; created_at: string; teams: string[]; auth: Record; config: Record; health: Record; connector: ConnectorInfo; //: Which credential is installed — the plaintext comes from GET /agents/{ref}/credentials. credential?: { installed: boolean; preview: string; viewable: boolean }; } export interface Task { id: string; title: string; prompt: string; context: Record; agent_id: string; agent_name: string; team_id: string; run_id: string; step_id: string; session_key: string; status: TaskStatus; source: string; result: string; error: string; usage: Record; created_at: string; started_at: string | null; finished_at: string | null; duration_s: number | null; } export interface TaskEvent { id?: string; task_id?: string; seq: number; kind: string; payload: Record; created_at?: string; } export interface TeamMember { id: string; agent_id: string; agent_name: string; emoji: string; driver: string; role: string; instructions: string; position: number; } export interface Team { id: string; name: string; description: string; playbook: string; spec: Record; members: TeamMember[]; member_count: number; created_at: string; updated_at: string; } export interface RunStep { id: string; run_id: string; agent_id: string; agent_name: string; role: string; position: number; round: number; title: string; input: string; output: string; status: string; error: string; task_id: string; started_at: string | null; finished_at: string | null; } export interface BlackboardEntry { id: string; team_id: string; run_id: string; agent_id: string; key: string; value: Record; created_at: string; updated_at: string; } export interface TeamMessage { id: string; team_id: string; run_id: string; from_agent_id: string; to_agent_id: string; kind: string; body: string; payload: Record; created_at: string; } export interface Run { id: string; team_id: string; objective: string; playbook: string; spec: Record; status: string; output: string; error: string; grant_preview: string; created_at: string; started_at: string | null; finished_at: string | null; duration_s: number | null; steps?: RunStep[]; messages?: TeamMessage[]; blackboard?: BlackboardEntry[]; } export interface PresenceEntry { id: string; name: string; status: string; live: boolean; heartbeat_age_s: number | null; origin: string; error: string; } export interface AgentPresence { agent_id: string; status: string; live: boolean; origin: string; remote: string; pending_requests: number; inflight_tasks: string[]; heartbeat_age_s: number | null; health: Record; error: string; } export interface Frame { v: number; id: string; ts: number; type: string; kind: string; topic?: string; actor?: string; agent_id?: string; task_id?: string; run_id?: string; seq?: number; payload: Record; } export interface Stats { hub: { uptime_s: number; connector_connections: number; connected_agents: string[]; bus: Record; }; agents: { total: number; by_status: Record; by_driver: Record; by_deployment: Record; online_live: number; connected_agent_ids: string[]; }; tasks: { by_status: Record; inflight: number }; teams: number; recent_runs: { id: string; team_id: string; status: string; objective: string; created_at: string }[]; uptime_note: string; } export interface NamedInfo { name: string; description: string; } export interface DriverInfo extends NamedInfo { title: string; connection_modes: string[]; config_schema: Record; experimental: boolean; } export interface Meta { app: string; version: string; url: string; ws_url: string; auth_required: boolean; /** 驱动能力清单(含第三方 entry-point 注册进来的)。 */ drivers: DriverInfo[]; playbooks: NamedInfo[]; /** 下面四个枚举都由 /meta 下发:控制台不另存硬编码副本,避免和 hub 漂移。 */ agent_types: string[]; connection_modes: string[]; deployment_kinds: string[]; } export interface ApiKey { id: string; name: string; scope: string; key_preview: string; created_at: string; last_used_at: string | null; revoked: boolean; token?: string; } export interface AuditEntry { id: number; ts: number; actor: string; action: string; target_type: string; target_id: string; detail: Record; } export interface DeployFile { kind: string; filename: string; content: string; } export interface DeployPlan { agent: Record; hub_url: string; files: DeployFile[]; next_steps: string[]; note: string; } /** 一次签发的存档:当时那段配置连 token 一起留着,所以回看就是原样。 */ export interface Issuance { id: string; agent_id: string; agent_name: string; kind: string; hub_url: string; agent_token: string; files: DeployFile[]; active: boolean; created_at: string; } export interface GatewayStatus { uptime_s: number; connector_connections: number; connected_agents: string[]; bus: { published: number; dropped: number; subscribers: number; buffered: number }; connections: Record[]; } export interface ProbeResult { ok: boolean; driver?: string; detail?: Record; error?: string; [key: string]: unknown; }