@agent-relay/dashboard-server 2.0.83-beta.0 → 2.0.85

package/dist/lib/server-state.d.ts

@@ -0,0 +1,115 @@
+import fs from 'fs';
+import type { WebSocketServer, WebSocket } from 'ws';
+import type { StorageAdapter } from '@agent-relay/storage/adapter';
+import type { RelayAdapter } from '@agent-relay/sdk';
+import { MessageBuffer } from '../messageBuffer.js';
+export interface ResolveWorkspaceRequest {
+    query?: Record<string, unknown>;
+    body?: Record<string, unknown>;
+    headers?: Record<string, unknown>;
+}
+export interface SpawnWorkerLike {
+    name: string;
+    cli: string;
+    task: string;
+    team?: string;
+    spawnerName?: string;
+    spawnedAt: number;
+    pid?: number;
+}
+export interface SpawnReaderLike {
+    getActiveWorkers(): SpawnWorkerLike[];
+    hasWorker(name: string): boolean;
+    getWorkerOutput(name: string, limit?: number): string[] | undefined;
+    getWorkerRawOutput(name: string): string | undefined;
+    sendWorkerInput(name: string, data: string): Promise<boolean>;
+}
+type BrokerShimSpawnRequest = {
+    name: string;
+    cli: string;
+    task?: string;
+    team?: string;
+    cwd?: string;
+    interactive?: boolean;
+    shadowMode?: string;
+    shadowAgent?: string;
+    shadowOf?: string;
+    shadowTriggers?: string;
+    shadowSpeakOn?: string;
+    spawnerName?: string;
+    userId?: string;
+    includeWorkflowConventions?: boolean;
+};
+export type BrokerRelayClientShim = {
+    state: 'READY';
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    sendMessage: (to: string, body: string, _kind?: string, data?: unknown, thread?: string) => boolean;
+    joinChannel: (channel: string, displayName?: string) => boolean;
+    leaveChannel: (channel: string, reason?: string) => boolean;
+    sendChannelMessage: (channel: string, body: string, options?: {
+        thread?: string;
+        mentions?: string[];
+        attachments?: unknown[];
+        data?: Record<string, unknown>;
+    }) => boolean;
+    adminJoinChannel: (channel: string, member: string) => boolean;
+    adminRemoveMember: (channel: string, member: string) => boolean;
+    spawn: (req: BrokerShimSpawnRequest) => Promise<unknown>;
+    release: (name: string) => Promise<unknown>;
+};
+export interface ServerState<TPresenceState = unknown, TAttachment = unknown, TDecision = unknown, TTask = unknown> {
+    config: {
+        dataDir: string;
+        teamDir: string;
+        projectRoot?: string;
+        verbose: boolean;
+        defaultWorkspaceId?: string;
+    };
+    refs: {
+        storage?: StorageAdapter;
+        relayAdapter: RelayAdapter;
+        spawnReader: SpawnReaderLike;
+        wss: WebSocketServer;
+        wssBridge: WebSocketServer;
+        wssLogs: WebSocketServer;
+        wssPresence: WebSocketServer;
+    };
+    mainClientAlive: WeakMap<WebSocket, boolean>;
+    bridgeClientAlive: WeakMap<WebSocket, boolean>;
+    presenceHealth: WeakMap<WebSocket, {
+        isAlive: boolean;
+    }>;
+    mainMessageBuffer: MessageBuffer;
+    agentLogBuffers: Map<string, MessageBuffer>;
+    logSubscriptions: Map<string, Set<WebSocket>>;
+    fileWatchers: Map<string, fs.FSWatcher>;
+    fileLastSize: Map<string, number>;
+    onlineUsers: Map<string, TPresenceState>;
+    initializingClients: WeakSet<WebSocket>;
+    attachmentRegistry: Map<string, TAttachment>;
+    agentCwdMap: Map<string, string>;
+    decisions: Map<string, TDecision>;
+    tasks: Map<string, TTask>;
+    brokerClientShimCache: Map<string, BrokerRelayClientShim>;
+    getAgentLogBuffer: (agentName: string) => MessageBuffer;
+    getBrokerClientShim: (senderName: string) => BrokerRelayClientShim;
+    resolveWorkspaceId: (req: ResolveWorkspaceRequest) => string | undefined;
+}
+export interface CreateServerStateOptions {
+    dataDir: string;
+    teamDir: string;
+    projectRoot?: string;
+    verbose: boolean;
+    defaultWorkspaceId?: string;
+    storage?: StorageAdapter;
+    relayAdapter: RelayAdapter;
+    spawnReader: SpawnReaderLike;
+    wss: WebSocketServer;
+    wssBridge: WebSocketServer;
+    wssLogs: WebSocketServer;
+    wssPresence: WebSocketServer;
+}
+export declare function createServerState(options: CreateServerStateOptions): ServerState;
+export {};
+//# sourceMappingURL=server-state.d.ts.map

package/dist/lib/server-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-state.d.ts","sourceRoot":"","sources":["../../src/lib/server-state.ts"],"names":[],"mappings":"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"}

package/dist/lib/server-state.js

@@ -0,0 +1,138 @@
+import { MessageBuffer } from '../messageBuffer.js';
+const asString = (value) => {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (typeof item === 'string' && item.length > 0)
+                return item;
+        }
+    }
+    return undefined;
+};
+const getWorkspaceHeader = (headers) => {
+    if (!headers)
+        return undefined;
+    const direct = headers['x-workspace-id'];
+    if (typeof direct === 'string' && direct.length > 0)
+        return direct;
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === 'x-workspace-id' && typeof value === 'string' && value.length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+};
+export function createServerState(options) {
+    const { dataDir, teamDir, projectRoot, verbose, defaultWorkspaceId, storage, relayAdapter, spawnReader, wss, wssBridge, wssLogs, wssPresence, } = options;
+    const brokerClientShimCache = new Map();
+    const getBrokerClientShim = (senderName) => {
+        let shim = brokerClientShimCache.get(senderName);
+        if (!shim) {
+            const sendViaBroker = (to, body, thread, data) => {
+                void relayAdapter.sendMessage({
+                    to,
+                    text: body,
+                    from: senderName,
+                    threadId: thread,
+                    data,
+                }).catch((err) => {
+                    console.error(`[dashboard] Failed to send broker message from ${senderName} to ${to}:`, err);
+                });
+                return true;
+            };
+            shim = {
+                state: 'READY',
+                connect: async () => { },
+                disconnect: () => { },
+                sendMessage: (to, body, _kind, data, thread) => {
+                    const typedData = (data && typeof data === 'object') ? data : undefined;
+                    return sendViaBroker(to, body, thread, typedData);
+                },
+                joinChannel: (_channel, _displayName) => true,
+                leaveChannel: (_channel, _reason) => true,
+                sendChannelMessage: (channel, body, options) => {
+                    const channelData = {
+                        ...(options?.data || {}),
+                        _isChannelMessage: true,
+                    };
+                    if (options?.mentions)
+                        channelData.mentions = options.mentions;
+                    if (options?.attachments)
+                        channelData.attachments = options.attachments;
+                    return sendViaBroker(channel, body, options?.thread, channelData);
+                },
+                adminJoinChannel: (_channel, _member) => true,
+                adminRemoveMember: (_channel, _member) => true,
+                spawn: async (req) => {
+                    return relayAdapter.spawn({
+                        name: req.name,
+                        cli: req.cli,
+                        task: req.task,
+                        team: req.team,
+                        cwd: req.cwd,
+                        interactive: req.interactive,
+                        shadowMode: req.shadowMode,
+                        shadowOf: req.shadowOf,
+                        spawnerName: req.spawnerName,
+                        userId: req.userId,
+                        includeWorkflowConventions: req.includeWorkflowConventions,
+                    });
+                },
+                release: async (name) => relayAdapter.release(name),
+            };
+            brokerClientShimCache.set(senderName, shim);
+        }
+        return shim;
+    };
+    const state = {
+        config: {
+            dataDir,
+            teamDir,
+            projectRoot,
+            verbose,
+            defaultWorkspaceId,
+        },
+        refs: {
+            storage,
+            relayAdapter,
+            spawnReader,
+            wss,
+            wssBridge,
+            wssLogs,
+            wssPresence,
+        },
+        mainClientAlive: new WeakMap(),
+        bridgeClientAlive: new WeakMap(),
+        presenceHealth: new WeakMap(),
+        mainMessageBuffer: new MessageBuffer(500),
+        agentLogBuffers: new Map(),
+        logSubscriptions: new Map(),
+        fileWatchers: new Map(),
+        fileLastSize: new Map(),
+        onlineUsers: new Map(),
+        initializingClients: new WeakSet(),
+        attachmentRegistry: new Map(),
+        agentCwdMap: new Map(),
+        decisions: new Map(),
+        tasks: new Map(),
+        brokerClientShimCache,
+        getAgentLogBuffer: (agentName) => {
+            let buffer = state.agentLogBuffers.get(agentName);
+            if (!buffer) {
+                buffer = new MessageBuffer(200);
+                state.agentLogBuffers.set(agentName, buffer);
+            }
+            return buffer;
+        },
+        getBrokerClientShim,
+        resolveWorkspaceId: (req) => {
+            const fromQuery = asString(req.query?.workspaceId);
+            const fromBody = asString(req.body?.workspaceId);
+            const fromHeader = getWorkspaceHeader(req.headers);
+            return fromQuery || fromBody || fromHeader || defaultWorkspaceId;
+        },
+    };
+    return state;
+}
+//# sourceMappingURL=server-state.js.map

package/dist/lib/server-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-state.js","sourceRoot":"","sources":["../../src/lib/server-state.ts"],"names":[],"mappings":"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"}

package/dist/lib/spawned-agents.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Spawned agent tracking: extraction, caching, filtering, and merging.
+ */
+import type { AgentStatus } from '../relaycast-provider.js';
+import type { SpawnedAgentSummary, SpawnedAgentNamesResult, LocalStateAgentSummary } from './types.js';
+export declare function extractSpawnedAgentNames(payload: unknown): SpawnedAgentNamesResult;
+export declare function filterPhantomAgents(agents: AgentStatus[], spawnedAgentNames: Set<string> | null, localAgentNames: Set<string> | null): AgentStatus[];
+export declare function mergeBrokerSpawnedAgents(agents: AgentStatus[], spawnedAgents: SpawnedAgentSummary[] | null): AgentStatus[];
+export declare function readStandaloneStateAgents(dataDir: string): LocalStateAgentSummary[];
+/**
+ * Creates cached getters for spawned agents and local agent names.
+ */
+export declare function createSpawnedAgentsCaches(opts: {
+    brokerProxyEnabled: boolean;
+    relayUrl: string | undefined;
+    dataDir: string;
+    verbose: boolean;
+}): {
+    getSpawnedAgents: () => Promise<{
+        names: Set<string> | null;
+        agents: SpawnedAgentSummary[] | null;
+    }>;
+    getLocalAgentNames: () => Set<string> | null;
+};
+export interface ProxyRequestHeaders {
+    authorization?: string;
+    workspaceId?: string;
+}
+export declare function fetchBrokerSpawnedAgents(opts?: {
+    env?: NodeJS.ProcessEnv;
+    query?: URLSearchParams;
+    headers?: ProxyRequestHeaders;
+    fetchImpl?: typeof fetch;
+}): Promise<Response>;
+//# sourceMappingURL=spawned-agents.d.ts.map

package/dist/lib/spawned-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawned-agents.d.ts","sourceRoot":"","sources":["../../src/lib/spawned-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAYvG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAmHlF;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EAAE,EACrB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EACrC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,GAClC,WAAW,EAAE,CAuBf;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,aAAa,EAAE,mBAAmB,EAAE,GAAG,IAAI,GAC1C,WAAW,EAAE,CA0Df;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAsCnF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG;IACF,gBAAgB,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACrG,kBAAkB,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC9C,CAkHA;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAsB,wBAAwB,CAAC,IAAI,GAAE;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQzB"}

package/dist/lib/spawned-agents.js

@@ -0,0 +1,340 @@
+/**
+ * Spawned agent tracking: extraction, caching, filtering, and merging.
+ */
+import fs from 'fs';
+import path from 'path';
+import { buildDashboardProxyUrl, getDashboardProxyRoute } from './proxy-route-table.js';
+import { normalizeName, parseCommandDescriptor, isRecord, parseTimestamp, isPidAlive, toIsoTimestamp, PHANTOM_OFFLINE_MAX_AGE_MS, SPAWNED_CACHE_TTL_MS, } from './utils.js';
+export function extractSpawnedAgentNames(payload) {
+    const names = new Set();
+    const agentsByName = new Map();
+    let hasSpawnedList = false;
+    let candidates = [];
+    const resolveCandidates = (value) => {
+        if (Array.isArray(value)) {
+            hasSpawnedList = true;
+            return value;
+        }
+        if (!isRecord(value)) {
+            return [];
+        }
+        if (Array.isArray(value.agents)) {
+            hasSpawnedList = true;
+            return value.agents;
+        }
+        if (Array.isArray(value.workers)) {
+            hasSpawnedList = true;
+            return value.workers;
+        }
+        if (Array.isArray(value.spawned)) {
+            hasSpawnedList = true;
+            return value.spawned;
+        }
+        return [];
+    };
+    candidates = resolveCandidates(payload);
+    if (candidates.length === 0 && isRecord(payload)) {
+        candidates = resolveCandidates(payload.data);
+    }
+    const upsertAgent = (candidate) => {
+        const normalizedName = normalizeName(candidate.name);
+        if (!normalizedName) {
+            return;
+        }
+        const existing = agentsByName.get(normalizedName);
+        if (!existing) {
+            agentsByName.set(normalizedName, candidate);
+            names.add(normalizedName);
+            return;
+        }
+        agentsByName.set(normalizedName, {
+            ...existing,
+            cli: existing.cli !== 'unknown' ? existing.cli : candidate.cli,
+            model: existing.model ?? candidate.model,
+            cwd: existing.cwd ?? candidate.cwd,
+            pid: existing.pid ?? candidate.pid,
+            online: existing.online === true || candidate.online === true
+                ? true
+                : (existing.online ?? candidate.online),
+        });
+    };
+    for (const candidate of candidates) {
+        if (typeof candidate === 'string') {
+            const trimmedName = candidate.trim();
+            if (!trimmedName) {
+                continue;
+            }
+            upsertAgent({
+                name: trimmedName,
+                cli: 'unknown',
+            });
+            continue;
+        }
+        if (!isRecord(candidate)) {
+            continue;
+        }
+        const name = typeof candidate.name === 'string'
+            ? candidate.name
+            : (typeof candidate.id === 'string' ? candidate.id : '');
+        const trimmedName = name.trim();
+        if (!trimmedName) {
+            continue;
+        }
+        const parsed = parseCommandDescriptor(typeof candidate.cli === 'string' ? candidate.cli : undefined, candidate.args, typeof candidate.model === 'string' ? candidate.model : undefined);
+        const cwd = typeof candidate.cwd === 'string' && candidate.cwd.trim()
+            ? candidate.cwd.trim()
+            : undefined;
+        const pid = typeof candidate.pid === 'number' && Number.isFinite(candidate.pid)
+            ? candidate.pid
+            : undefined;
+        const online = typeof candidate.online === 'boolean'
+            ? candidate.online
+            : (typeof candidate.status === 'string'
+                ? ['online', 'running', 'active', 'busy'].includes(candidate.status.trim().toLowerCase())
+                : undefined);
+        upsertAgent({
+            name: trimmedName,
+            cli: parsed.cli,
+            model: parsed.model,
+            cwd,
+            pid,
+            online,
+        });
+    }
+    const agents = [...agentsByName.values()];
+    return { names, agents, hasSpawnedList };
+}
+export function filterPhantomAgents(agents, spawnedAgentNames, localAgentNames) {
+    const now = Date.now();
+    return agents.filter((agent) => {
+        const status = (agent.status ?? '').toLowerCase();
+        const lastSeenTs = parseTimestamp(agent.lastSeen ?? agent.lastActive);
+        if (status === 'offline' && lastSeenTs !== null && (now - lastSeenTs) > PHANTOM_OFFLINE_MAX_AGE_MS) {
+            return false;
+        }
+        if (localAgentNames !== null) {
+            const normalizedName = normalizeName(agent.name);
+            return normalizedName ? localAgentNames.has(normalizedName) : false;
+        }
+        if (spawnedAgentNames !== null) {
+            const normalizedName = normalizeName(agent.name);
+            return normalizedName ? spawnedAgentNames.has(normalizedName) : false;
+        }
+        return true;
+    });
+}
+export function mergeBrokerSpawnedAgents(agents, spawnedAgents) {
+    if (!spawnedAgents || spawnedAgents.length === 0) {
+        return agents;
+    }
+    const mergedAgents = [...agents];
+    const agentIndexByName = new Map();
+    for (let index = 0; index < mergedAgents.length; index += 1) {
+        const normalized = normalizeName(mergedAgents[index]?.name ?? '');
+        if (normalized) {
+            agentIndexByName.set(normalized, index);
+        }
+    }
+    for (const spawnedAgent of spawnedAgents) {
+        const normalizedName = normalizeName(spawnedAgent.name);
+        if (!normalizedName) {
+            continue;
+        }
+        const spawnedOnline = spawnedAgent.online === true
+            ? true
+            : spawnedAgent.online === false
+                ? false
+                : (typeof spawnedAgent.pid === 'number' && Number.isFinite(spawnedAgent.pid) && spawnedAgent.pid > 0);
+        const normalizedCli = spawnedAgent.cli.trim() ? spawnedAgent.cli : 'unknown';
+        const existingIndex = agentIndexByName.get(normalizedName);
+        if (existingIndex !== undefined) {
+            const existing = mergedAgents[existingIndex];
+            const existingCli = typeof existing.cli === 'string' && existing.cli.trim() ? existing.cli : 'unknown';
+            mergedAgents[existingIndex] = {
+                ...existing,
+                cli: existingCli !== 'unknown' ? existingCli : normalizedCli,
+                model: existing.model ?? spawnedAgent.model,
+                cwd: existing.cwd ?? spawnedAgent.cwd,
+                status: spawnedOnline
+                    ? ((existing.status ?? 'offline').toLowerCase() === 'busy' ? 'busy' : 'online')
+                    : existing.status,
+                isSpawned: true,
+            };
+            continue;
+        }
+        mergedAgents.push({
+            name: spawnedAgent.name,
+            role: 'agent',
+            cli: normalizedCli,
+            messageCount: 0,
+            status: spawnedOnline ? 'online' : 'offline',
+            lastSeen: new Date().toISOString(),
+            isSpawned: true,
+            model: spawnedAgent.model,
+            cwd: spawnedAgent.cwd,
+        });
+        agentIndexByName.set(normalizedName, mergedAgents.length - 1);
+    }
+    return mergedAgents;
+}
+export function readStandaloneStateAgents(dataDir) {
+    const statePath = path.join(dataDir, 'state.json');
+    if (!fs.existsSync(statePath)) {
+        return [];
+    }
+    try {
+        const raw = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+        if (!isRecord(raw.agents)) {
+            return [];
+        }
+        const agents = [];
+        for (const [name, value] of Object.entries(raw.agents)) {
+            if (!isRecord(value)) {
+                continue;
+            }
+            const pid = typeof value.pid === 'number' ? value.pid : undefined;
+            const spec = isRecord(value.spec) ? value.spec : undefined;
+            const cli = typeof spec?.cli === 'string' && spec.cli.trim() ? spec.cli : 'unknown';
+            const cwd = typeof spec?.cwd === 'string' && spec.cwd.trim() ? spec.cwd : undefined;
+            agents.push({
+                name,
+                cli,
+                cwd,
+                pid,
+                online: pid !== undefined ? isPidAlive(pid) : false,
+                startedAt: toIsoTimestamp(value.started_at),
+            });
+        }
+        agents.sort((a, b) => a.name.localeCompare(b.name));
+        return agents;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Creates cached getters for spawned agents and local agent names.
+ */
+export function createSpawnedAgentsCaches(opts) {
+    const { brokerProxyEnabled, relayUrl, dataDir, verbose } = opts;
+    let spawnedAgentsCache = {
+        expiresAt: 0,
+        names: null,
+        agents: null,
+    };
+    let localAgentNamesCache = {
+        expiresAt: 0,
+        names: null,
+    };
+    const getSpawnedAgents = async () => {
+        if (!brokerProxyEnabled || !relayUrl) {
+            return { names: null, agents: null };
+        }
+        const now = Date.now();
+        if (spawnedAgentsCache.expiresAt > now) {
+            return {
+                names: spawnedAgentsCache.names,
+                agents: spawnedAgentsCache.agents,
+            };
+        }
+        try {
+            const response = await fetch(`${relayUrl}/api/spawned`, {
+                method: 'GET',
+                headers: { Accept: 'application/json' },
+            });
+            if (!response.ok) {
+                if (verbose) {
+                    console.warn(`[dashboard] Failed to fetch /api/spawned from broker: ${response.status}`);
+                }
+                spawnedAgentsCache = {
+                    expiresAt: now + SPAWNED_CACHE_TTL_MS,
+                    names: null,
+                    agents: null,
+                };
+                return { names: null, agents: null };
+            }
+            const payload = await response.json();
+            const { names, agents, hasSpawnedList } = extractSpawnedAgentNames(payload);
+            const resolvedNames = hasSpawnedList ? names : null;
+            const resolvedAgents = hasSpawnedList ? agents : null;
+            if (!hasSpawnedList && verbose) {
+                console.warn('[dashboard] /api/spawned payload missing agents/workers list; skipping phantom cross-reference');
+            }
+            spawnedAgentsCache = {
+                expiresAt: now + SPAWNED_CACHE_TTL_MS,
+                names: resolvedNames,
+                agents: resolvedAgents,
+            };
+            return { names: resolvedNames, agents: resolvedAgents };
+        }
+        catch (err) {
+            if (verbose) {
+                console.warn('[dashboard] Failed to fetch /api/spawned from broker:', err.message);
+            }
+            spawnedAgentsCache = {
+                expiresAt: now + SPAWNED_CACHE_TTL_MS,
+                names: null,
+                agents: null,
+            };
+            return { names: null, agents: null };
+        }
+    };
+    const getLocalAgentNames = () => {
+        if (brokerProxyEnabled) {
+            return null;
+        }
+        const now = Date.now();
+        if (localAgentNamesCache.expiresAt > now) {
+            return localAgentNamesCache.names;
+        }
+        const names = new Set();
+        const addName = (value) => {
+            if (typeof value !== 'string')
+                return;
+            const normalized = normalizeName(value);
+            if (normalized) {
+                names.add(normalized);
+            }
+        };
+        try {
+            const statePath = path.join(dataDir, 'state.json');
+            if (fs.existsSync(statePath)) {
+                const stateRaw = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+                if (isRecord(stateRaw.agents)) {
+                    for (const agentName of Object.keys(stateRaw.agents)) {
+                        addName(agentName);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore local state parsing failures.
+        }
+        localAgentNamesCache = {
+            expiresAt: now + (names.size > 0 ? SPAWNED_CACHE_TTL_MS : 500),
+            names: names.size > 0 ? names : null,
+        };
+        return names.size > 0 ? names : null;
+    };
+    return { getSpawnedAgents, getLocalAgentNames };
+}
+function buildHeaders(headers) {
+    if (!headers)
+        return undefined;
+    const out = {};
+    if (headers.authorization)
+        out.authorization = headers.authorization;
+    if (headers.workspaceId)
+        out['x-workspace-id'] = headers.workspaceId;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export async function fetchBrokerSpawnedAgents(opts = {}) {
+    const route = getDashboardProxyRoute('brokerSpawned');
+    const url = buildDashboardProxyUrl(route, { env: opts.env, query: opts.query });
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    return fetchImpl(url, {
+        method: route.method,
+        headers: buildHeaders(opts.headers),
+    });
+}
+//# sourceMappingURL=spawned-agents.js.map