@agent-relay/dashboard-server 0.1.0

package/dist/health-worker-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Health Worker Manager
+ *
+ * Manages the health check worker thread, sending periodic stats updates
+ * and handling worker lifecycle.
+ */
+export interface HealthWorkerConfig {
+    /** Port for health check server (default: main port + 1) */
+    port: number;
+    /** Interval for sending stats updates (default: 5000ms) */
+    statsInterval?: number;
+}
+export interface HealthStatsProvider {
+    getUptime: () => number;
+    getMemoryMB: () => number;
+    getRelayConnected: () => boolean;
+    getAgentCount: () => number;
+    getStatus: () => 'healthy' | 'busy' | 'degraded';
+}
+export declare class HealthWorkerManager {
+    private worker;
+    private statsInterval;
+    private config;
+    private statsProvider;
+    private ready;
+    constructor(config: HealthWorkerConfig, statsProvider: HealthStatsProvider);
+    /**
+     * Start the health worker thread
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the health worker thread
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if worker is ready
+     */
+    isReady(): boolean;
+    /**
+     * Get the port the health worker is listening on
+     */
+    getPort(): number;
+    /**
+     * Start periodic stats updates to worker
+     */
+    private startStatsUpdates;
+    /**
+     * Stop stats updates
+     */
+    private stopStatsUpdates;
+    /**
+     * Send current stats to worker
+     */
+    private sendStats;
+}
+/** Default health port offset from main port */
+export declare const HEALTH_PORT_OFFSET = 1;
+/**
+ * Calculate health port from main port
+ */
+export declare function getHealthPort(mainPort: number): number;
+//# sourceMappingURL=health-worker-manager.d.ts.map

package/dist/health-worker-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-worker-manager.d.ts","sourceRoot":"","sources":["../src/health-worker-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB;IAQ1E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,SAAS;CAiBlB;AAED,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/health-worker-manager.js

@@ -0,0 +1,144 @@
+/**
+ * Health Worker Manager
+ *
+ * Manages the health check worker thread, sending periodic stats updates
+ * and handling worker lifecycle.
+ */
+import { Worker } from 'node:worker_threads';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class HealthWorkerManager {
+    worker = null;
+    statsInterval = null;
+    config;
+    statsProvider;
+    ready = false;
+    constructor(config, statsProvider) {
+        this.config = {
+            statsInterval: 5000,
+            ...config,
+        };
+        this.statsProvider = statsProvider;
+    }
+    /**
+     * Start the health worker thread
+     */
+    async start() {
+        if (this.worker) {
+            console.warn('[health-manager] Worker already running');
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            // Worker script path - handle both dev (src) and prod (dist)
+            const workerPath = path.join(__dirname, 'health-worker.js');
+            this.worker = new Worker(workerPath, {
+                workerData: { port: this.config.port },
+            });
+            this.worker.on('message', (msg) => {
+                if (msg.type === 'ready') {
+                    this.ready = true;
+                    console.log(`[health-manager] Worker ready on port ${msg.port}`);
+                    this.startStatsUpdates();
+                    resolve();
+                }
+                else if (msg.type === 'error') {
+                    console.error('[health-manager] Worker error:', msg.error);
+                }
+            });
+            this.worker.on('error', (err) => {
+                console.error('[health-manager] Worker thread error:', err);
+                if (!this.ready) {
+                    reject(err);
+                }
+            });
+            this.worker.on('exit', (code) => {
+                console.log(`[health-manager] Worker exited with code ${code}`);
+                this.ready = false;
+                this.worker = null;
+                this.stopStatsUpdates();
+            });
+            // Timeout for worker startup
+            setTimeout(() => {
+                if (!this.ready) {
+                    reject(new Error('Health worker startup timeout'));
+                }
+            }, 10000);
+        });
+    }
+    /**
+     * Stop the health worker thread
+     */
+    async stop() {
+        this.stopStatsUpdates();
+        if (this.worker) {
+            await this.worker.terminate();
+            this.worker = null;
+            this.ready = false;
+        }
+    }
+    /**
+     * Check if worker is ready
+     */
+    isReady() {
+        return this.ready;
+    }
+    /**
+     * Get the port the health worker is listening on
+     */
+    getPort() {
+        return this.config.port;
+    }
+    /**
+     * Start periodic stats updates to worker
+     */
+    startStatsUpdates() {
+        if (this.statsInterval)
+            return;
+        // Send initial stats
+        this.sendStats();
+        // Send periodic updates
+        this.statsInterval = setInterval(() => {
+            this.sendStats();
+        }, this.config.statsInterval);
+    }
+    /**
+     * Stop stats updates
+     */
+    stopStatsUpdates() {
+        if (this.statsInterval) {
+            clearInterval(this.statsInterval);
+            this.statsInterval = null;
+        }
+    }
+    /**
+     * Send current stats to worker
+     */
+    sendStats() {
+        if (!this.worker || !this.ready)
+            return;
+        try {
+            const stats = {
+                uptime: this.statsProvider.getUptime(),
+                memoryMB: this.statsProvider.getMemoryMB(),
+                relayConnected: this.statsProvider.getRelayConnected(),
+                agentCount: this.statsProvider.getAgentCount(),
+                status: this.statsProvider.getStatus(),
+            };
+            this.worker.postMessage(stats);
+        }
+        catch (err) {
+            console.error('[health-manager] Failed to send stats:', err);
+        }
+    }
+}
+/** Default health port offset from main port */
+export const HEALTH_PORT_OFFSET = 1;
+/**
+ * Calculate health port from main port
+ */
+export function getHealthPort(mainPort) {
+    return mainPort + HEALTH_PORT_OFFSET;
+}
+//# sourceMappingURL=health-worker-manager.js.map

package/dist/health-worker-manager.js.map

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

package/dist/health-worker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Health Check Worker Thread
+ *
+ * Runs a minimal HTTP server on a separate thread to handle health checks.
+ * This ensures health checks respond even when the main event loop is blocked
+ * by heavy compute tasks (builds, large file operations, etc.).
+ */
+export {};
+//# sourceMappingURL=health-worker.d.ts.map

package/dist/health-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-worker.d.ts","sourceRoot":"","sources":["../src/health-worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/health-worker.js

@@ -0,0 +1,79 @@
+/**
+ * Health Check Worker Thread
+ *
+ * Runs a minimal HTTP server on a separate thread to handle health checks.
+ * This ensures health checks respond even when the main event loop is blocked
+ * by heavy compute tasks (builds, large file operations, etc.).
+ */
+import { parentPort, workerData } from 'node:worker_threads';
+import http from 'node:http';
+// Default stats until we receive updates from main thread
+let currentStats = {
+    uptime: 0,
+    memoryMB: 0,
+    relayConnected: false,
+    agentCount: 0,
+    status: 'healthy',
+};
+// Track when we last received stats from main thread
+let lastStatsUpdate = Date.now();
+const STATS_STALE_THRESHOLD_MS = 60_000; // 1 minute
+// Listen for stats updates from main thread
+if (parentPort) {
+    parentPort.on('message', (stats) => {
+        currentStats = stats;
+        lastStatsUpdate = Date.now();
+    });
+}
+const { port } = workerData;
+const server = http.createServer((req, res) => {
+    // Only handle /health endpoint
+    if (req.url !== '/health' && req.url !== '/') {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Not found' }));
+        return;
+    }
+    // Check if stats are stale (main thread might be blocked)
+    const statsAge = Date.now() - lastStatsUpdate;
+    const isStale = statsAge > STATS_STALE_THRESHOLD_MS;
+    // Determine status
+    let status = currentStats.status;
+    if (isStale) {
+        status = 'busy'; // Main thread is likely blocked
+    }
+    const response = {
+        status,
+        uptime: currentStats.uptime,
+        memoryMB: currentStats.memoryMB,
+        relayConnected: currentStats.relayConnected,
+        agentCount: currentStats.agentCount,
+        statsAgeMs: statsAge,
+        worker: true, // Indicates response is from worker thread
+    };
+    // Return 200 for healthy/busy, 503 for degraded
+    const statusCode = status === 'degraded' ? 503 : 200;
+    res.writeHead(statusCode, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(response));
+});
+server.listen(port, '0.0.0.0', () => {
+    console.log(`[health-worker] Health check server listening on port ${port}`);
+    // Notify main thread we're ready
+    if (parentPort) {
+        parentPort.postMessage({ type: 'ready', port });
+    }
+});
+// Handle errors gracefully
+server.on('error', (err) => {
+    console.error('[health-worker] Server error:', err);
+    if (parentPort) {
+        parentPort.postMessage({ type: 'error', error: String(err) });
+    }
+});
+// Keep the worker alive
+process.on('uncaughtException', (err) => {
+    console.error('[health-worker] Uncaught exception:', err);
+});
+process.on('unhandledRejection', (err) => {
+    console.error('[health-worker] Unhandled rejection:', err);
+});
+//# sourceMappingURL=health-worker.js.map

package/dist/health-worker.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @relay/dashboard-server
+ *
+ * HTTP/WebSocket server for agent coordination and dashboard UI.
+ *
+ * This package provides:
+ * - Dashboard HTTP API for agent management
+ * - WebSocket connections for real-time updates
+ * - User bridge for browser-based users
+ * - Metrics collection and reporting
+ */
+export { startDashboard } from './server.js';
+export { UserBridge, type IRelayClient } from './user-bridge.js';
+export { computeNeedsAttention, type AttentionMessage } from './needs-attention.js';
+export { computeSystemMetrics, formatPrometheusMetrics, type AgentMetrics, type ThroughputMetrics, } from './metrics.js';
+export { HealthWorkerManager, getHealthPort, type HealthWorkerConfig, type HealthStatsProvider } from './health-worker-manager.js';
+export type { ThreadMetadata } from './types/threading.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACnI,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @relay/dashboard-server
+ *
+ * HTTP/WebSocket server for agent coordination and dashboard UI.
+ *
+ * This package provides:
+ * - Dashboard HTTP API for agent management
+ * - WebSocket connections for real-time updates
+ * - User bridge for browser-based users
+ * - Metrics collection and reporting
+ */
+export { startDashboard } from './server.js';
+export { UserBridge } from './user-bridge.js';
+export { computeNeedsAttention } from './needs-attention.js';
+export { computeSystemMetrics, formatPrometheusMetrics, } from './metrics.js';
+export { HealthWorkerManager, getHealthPort } from './health-worker-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAyB,MAAM,sBAAsB,CAAC;AACpF,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAqD,MAAM,4BAA4B,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Metrics collection and computation for the Agent Relay dashboard.
+ * Provides real-time metrics for monitoring: throughput, agent health, error rates.
+ */
+export interface AgentMetrics {
+    name: string;
+    messagesSent: number;
+    messagesReceived: number;
+    firstSeen: string;
+    lastSeen: string;
+    isOnline: boolean;
+    uptimeSeconds: number;
+}
+export interface ThroughputMetrics {
+    messagesLastMinute: number;
+    messagesLastHour: number;
+    messagesLast24Hours: number;
+    avgMessagesPerMinute: number;
+}
+export interface SessionMetrics {
+    totalSessions: number;
+    activeSessions: number;
+    closedByAgent: number;
+    closedByDisconnect: number;
+    closedByError: number;
+    errorRate: number;
+    recentSessions: Array<{
+        id: string;
+        agentName: string;
+        startedAt: string;
+        endedAt?: string;
+        closedBy?: 'agent' | 'disconnect' | 'error';
+        messageCount: number;
+    }>;
+}
+export interface SystemMetrics {
+    totalAgents: number;
+    onlineAgents: number;
+    offlineAgents: number;
+    totalMessages: number;
+    throughput: ThroughputMetrics;
+    sessions: SessionMetrics;
+    agents: AgentMetrics[];
+    timestamp: string;
+}
+export interface PrometheusMetric {
+    name: string;
+    help: string;
+    type: 'counter' | 'gauge' | 'histogram';
+    values: Array<{
+        labels: Record<string, string>;
+        value: number;
+    }>;
+}
+/**
+ * Compute agent-level metrics from registry data
+ */
+export declare function computeAgentMetrics(agents: Array<{
+    name: string;
+    messagesSent: number;
+    messagesReceived: number;
+    firstSeen: string;
+    lastSeen: string;
+}>): AgentMetrics[];
+/**
+ * Compute throughput metrics from message history
+ */
+export declare function computeThroughputMetrics(messages: Array<{
+    timestamp: string;
+}>): ThroughputMetrics;
+/**
+ * Compute session lifecycle metrics from session history
+ */
+export declare function computeSessionMetrics(sessions: Array<{
+    id: string;
+    agentName: string;
+    startedAt: number;
+    endedAt?: number;
+    closedBy?: 'agent' | 'disconnect' | 'error';
+    messageCount: number;
+}>): SessionMetrics;
+/**
+ * Compute full system metrics
+ */
+export declare function computeSystemMetrics(agents: Array<{
+    name: string;
+    messagesSent: number;
+    messagesReceived: number;
+    firstSeen: string;
+    lastSeen: string;
+}>, messages: Array<{
+    timestamp: string;
+}>, sessions?: Array<{
+    id: string;
+    agentName: string;
+    startedAt: number;
+    endedAt?: number;
+    closedBy?: 'agent' | 'disconnect' | 'error';
+    messageCount: number;
+}>): SystemMetrics;
+/**
+ * Format metrics in Prometheus exposition format
+ */
+export declare function formatPrometheusMetrics(metrics: SystemMetrics): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

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

package/dist/metrics.js

@@ -0,0 +1,193 @@
+/**
+ * Metrics collection and computation for the Agent Relay dashboard.
+ * Provides real-time metrics for monitoring: throughput, agent health, error rates.
+ */
+// Consider agents offline after 30 seconds of inactivity
+// Aligns with heartbeat timeout (5s heartbeat * 6 multiplier = 30s)
+const OFFLINE_THRESHOLD_MS = 30 * 1000;
+/**
+ * Compute agent-level metrics from registry data
+ */
+export function computeAgentMetrics(agents) {
+    const now = Date.now();
+    return agents.map((agent) => {
+        const lastSeenTime = new Date(agent.lastSeen).getTime();
+        const firstSeenTime = new Date(agent.firstSeen).getTime();
+        const isOnline = now - lastSeenTime < OFFLINE_THRESHOLD_MS;
+        const uptimeSeconds = Math.floor((now - firstSeenTime) / 1000);
+        return {
+            name: agent.name,
+            messagesSent: agent.messagesSent,
+            messagesReceived: agent.messagesReceived,
+            firstSeen: agent.firstSeen,
+            lastSeen: agent.lastSeen,
+            isOnline,
+            uptimeSeconds,
+        };
+    });
+}
+/**
+ * Compute throughput metrics from message history
+ */
+export function computeThroughputMetrics(messages) {
+    const now = Date.now();
+    const oneMinuteAgo = now - 60 * 1000;
+    const oneHourAgo = now - 60 * 60 * 1000;
+    const oneDayAgo = now - 24 * 60 * 60 * 1000;
+    let lastMinute = 0;
+    let lastHour = 0;
+    let last24Hours = 0;
+    for (const msg of messages) {
+        const ts = new Date(msg.timestamp).getTime();
+        if (ts >= oneMinuteAgo)
+            lastMinute++;
+        if (ts >= oneHourAgo)
+            lastHour++;
+        if (ts >= oneDayAgo)
+            last24Hours++;
+    }
+    // Calculate average messages per minute over the last hour
+    const avgMessagesPerMinute = lastHour / 60;
+    return {
+        messagesLastMinute: lastMinute,
+        messagesLastHour: lastHour,
+        messagesLast24Hours: last24Hours,
+        avgMessagesPerMinute: Math.round(avgMessagesPerMinute * 100) / 100,
+    };
+}
+/**
+ * Compute session lifecycle metrics from session history
+ */
+export function computeSessionMetrics(sessions) {
+    let activeSessions = 0;
+    let closedByAgent = 0;
+    let closedByDisconnect = 0;
+    let closedByError = 0;
+    for (const session of sessions) {
+        if (!session.endedAt) {
+            activeSessions++;
+        }
+        else {
+            switch (session.closedBy) {
+                case 'agent':
+                    closedByAgent++;
+                    break;
+                case 'disconnect':
+                    closedByDisconnect++;
+                    break;
+                case 'error':
+                    closedByError++;
+                    break;
+                default:
+                    // Ended but no closedBy - treat as disconnect
+                    closedByDisconnect++;
+            }
+        }
+    }
+    const closedSessions = closedByAgent + closedByDisconnect + closedByError;
+    const errorRate = closedSessions > 0 ? (closedByError / closedSessions) * 100 : 0;
+    // Format recent sessions for display (most recent 10)
+    const recentSessions = sessions
+        .slice(0, 10)
+        .map((s) => ({
+        id: s.id,
+        agentName: s.agentName,
+        startedAt: new Date(s.startedAt).toISOString(),
+        endedAt: s.endedAt ? new Date(s.endedAt).toISOString() : undefined,
+        closedBy: s.closedBy,
+        messageCount: s.messageCount,
+    }));
+    return {
+        totalSessions: sessions.length,
+        activeSessions,
+        closedByAgent,
+        closedByDisconnect,
+        closedByError,
+        errorRate: Math.round(errorRate * 100) / 100,
+        recentSessions,
+    };
+}
+/**
+ * Compute full system metrics
+ */
+export function computeSystemMetrics(agents, messages, sessions = []) {
+    const agentMetrics = computeAgentMetrics(agents);
+    const throughput = computeThroughputMetrics(messages);
+    const sessionMetrics = computeSessionMetrics(sessions);
+    const onlineAgents = agentMetrics.filter((a) => a.isOnline).length;
+    const totalMessages = agents.reduce((sum, a) => sum + a.messagesSent + a.messagesReceived, 0) / 2; // Divide by 2 since each message is counted twice (sent + received)
+    return {
+        totalAgents: agents.length,
+        onlineAgents,
+        offlineAgents: agents.length - onlineAgents,
+        totalMessages: Math.round(totalMessages),
+        throughput,
+        sessions: sessionMetrics,
+        agents: agentMetrics,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Format metrics in Prometheus exposition format
+ */
+export function formatPrometheusMetrics(metrics) {
+    const lines = [];
+    // Agent counts
+    lines.push('# HELP agent_relay_agents_total Total number of registered agents');
+    lines.push('# TYPE agent_relay_agents_total gauge');
+    lines.push(`agent_relay_agents_total ${metrics.totalAgents}`);
+    lines.push('# HELP agent_relay_agents_online Number of online agents');
+    lines.push('# TYPE agent_relay_agents_online gauge');
+    lines.push(`agent_relay_agents_online ${metrics.onlineAgents}`);
+    // Message throughput
+    lines.push('# HELP agent_relay_messages_total Total messages processed');
+    lines.push('# TYPE agent_relay_messages_total counter');
+    lines.push(`agent_relay_messages_total ${metrics.totalMessages}`);
+    lines.push('# HELP agent_relay_messages_last_minute Messages in last minute');
+    lines.push('# TYPE agent_relay_messages_last_minute gauge');
+    lines.push(`agent_relay_messages_last_minute ${metrics.throughput.messagesLastMinute}`);
+    lines.push('# HELP agent_relay_messages_last_hour Messages in last hour');
+    lines.push('# TYPE agent_relay_messages_last_hour gauge');
+    lines.push(`agent_relay_messages_last_hour ${metrics.throughput.messagesLastHour}`);
+    lines.push('# HELP agent_relay_messages_avg_per_minute Average messages per minute');
+    lines.push('# TYPE agent_relay_messages_avg_per_minute gauge');
+    lines.push(`agent_relay_messages_avg_per_minute ${metrics.throughput.avgMessagesPerMinute}`);
+    // Per-agent metrics
+    lines.push('# HELP agent_relay_agent_messages_sent Messages sent by agent');
+    lines.push('# TYPE agent_relay_agent_messages_sent counter');
+    for (const agent of metrics.agents) {
+        lines.push(`agent_relay_agent_messages_sent{agent="${agent.name}"} ${agent.messagesSent}`);
+    }
+    lines.push('# HELP agent_relay_agent_messages_received Messages received by agent');
+    lines.push('# TYPE agent_relay_agent_messages_received counter');
+    for (const agent of metrics.agents) {
+        lines.push(`agent_relay_agent_messages_received{agent="${agent.name}"} ${agent.messagesReceived}`);
+    }
+    lines.push('# HELP agent_relay_agent_online Agent online status (1=online, 0=offline)');
+    lines.push('# TYPE agent_relay_agent_online gauge');
+    for (const agent of metrics.agents) {
+        lines.push(`agent_relay_agent_online{agent="${agent.name}"} ${agent.isOnline ? 1 : 0}`);
+    }
+    lines.push('# HELP agent_relay_agent_uptime_seconds Agent uptime in seconds');
+    lines.push('# TYPE agent_relay_agent_uptime_seconds gauge');
+    for (const agent of metrics.agents) {
+        lines.push(`agent_relay_agent_uptime_seconds{agent="${agent.name}"} ${agent.uptimeSeconds}`);
+    }
+    // Session lifecycle metrics
+    lines.push('# HELP agent_relay_sessions_total Total number of sessions');
+    lines.push('# TYPE agent_relay_sessions_total counter');
+    lines.push(`agent_relay_sessions_total ${metrics.sessions.totalSessions}`);
+    lines.push('# HELP agent_relay_sessions_active Number of active sessions');
+    lines.push('# TYPE agent_relay_sessions_active gauge');
+    lines.push(`agent_relay_sessions_active ${metrics.sessions.activeSessions}`);
+    lines.push('# HELP agent_relay_sessions_closed_total Sessions closed by type');
+    lines.push('# TYPE agent_relay_sessions_closed_total counter');
+    lines.push(`agent_relay_sessions_closed_total{closed_by="agent"} ${metrics.sessions.closedByAgent}`);
+    lines.push(`agent_relay_sessions_closed_total{closed_by="disconnect"} ${metrics.sessions.closedByDisconnect}`);
+    lines.push(`agent_relay_sessions_closed_total{closed_by="error"} ${metrics.sessions.closedByError}`);
+    lines.push('# HELP agent_relay_sessions_error_rate Percentage of sessions closed by error');
+    lines.push('# TYPE agent_relay_sessions_error_rate gauge');
+    lines.push(`agent_relay_sessions_error_rate ${metrics.sessions.errorRate}`);
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=metrics.js.map