agent-relay 1.0.8 → 1.0.9

package/dist/dashboard/metrics.js

@@ -0,0 +1,192 @@
+/**
+ * Metrics collection and computation for the Agent Relay dashboard.
+ * Provides real-time metrics for monitoring: throughput, agent health, error rates.
+ */
+// Consider agents offline after 5 minutes of inactivity
+const OFFLINE_THRESHOLD_MS = 5 * 60 * 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

package/dist/dashboard/metrics.js.map

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

package/dist/dashboard/needs-attention.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Derive which agents currently need attention based on message history.
+ *
+ * Heuristic:
+ * - Track the most recent inbound message to an agent for each conversation key.
+ * - Conversation key is thread ID if present, otherwise the counterparty agent.
+ * - Track the most recent outbound message from the agent for the same key.
+ * - An agent needs attention if their latest inbound message for any key is newer
+ *   than their latest outbound message for that key.
+ */
+export interface AttentionMessage {
+    from: string;
+    to: string;
+    timestamp: string;
+    thread?: string;
+    /** Whether the message was sent as a broadcast (to: '*') */
+    isBroadcast?: boolean;
+}
+/**
+ * Compute which agents have pending inbound messages they haven't answered.
+ * Only considers messages within the attention window (last 30 minutes).
+ */
+export declare function computeNeedsAttention(messages: AttentionMessage[]): Set<string>;
+//# sourceMappingURL=needs-attention.d.ts.map

package/dist/dashboard/needs-attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"needs-attention.d.ts","sourceRoot":"","sources":["../../src/dashboard/needs-attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CA6D/E"}

package/dist/dashboard/needs-attention.js

@@ -0,0 +1,78 @@
+/**
+ * Derive which agents currently need attention based on message history.
+ *
+ * Heuristic:
+ * - Track the most recent inbound message to an agent for each conversation key.
+ * - Conversation key is thread ID if present, otherwise the counterparty agent.
+ * - Track the most recent outbound message from the agent for the same key.
+ * - An agent needs attention if their latest inbound message for any key is newer
+ *   than their latest outbound message for that key.
+ */
+// Only consider messages from the last 30 minutes for "needs attention"
+const ATTENTION_WINDOW_MS = 30 * 60 * 1000;
+function updateLatest(map, agent, key, ts) {
+    const agentMap = map.get(agent) ?? new Map();
+    const prev = agentMap.get(key) ?? -Infinity;
+    if (ts > prev) {
+        agentMap.set(key, ts);
+        map.set(agent, agentMap);
+    }
+}
+/**
+ * Compute which agents have pending inbound messages they haven't answered.
+ * Only considers messages within the attention window (last 30 minutes).
+ */
+export function computeNeedsAttention(messages) {
+    const latestInbound = new Map(); // agent -> (key -> ts)
+    const latestOutbound = new Map(); // agent -> (key -> ts)
+    const now = Date.now();
+    const cutoffTime = now - ATTENTION_WINDOW_MS;
+    for (const message of messages) {
+        const ts = Date.parse(message.timestamp);
+        if (Number.isNaN(ts))
+            continue;
+        // Detect broadcasts: either explicit isBroadcast flag or to === '*'
+        const isBroadcast = message.isBroadcast || message.to === '*';
+        // Inbound: messages directed to a specific agent (ignore broadcasts)
+        // Note: isBroadcast indicates the message was originally a broadcast, even though
+        // the 'to' field is set to the individual recipient for storage purposes
+        if (message.to && !isBroadcast) {
+            const inboundKey = message.thread ? `thread:${message.thread}` : `sender:${message.from}`;
+            updateLatest(latestInbound, message.to, inboundKey, ts);
+        }
+        // Outbound: track replies by thread (preferred) or by target agent
+        // Also treat broadcasts as clearing attention for all prior senders
+        if (message.from) {
+            const outboundKey = message.thread
+                ? `thread:${message.thread}`
+                : (message.to && !isBroadcast)
+                    ? `sender:${message.to}`
+                    : null;
+            if (outboundKey) {
+                updateLatest(latestOutbound, message.from, outboundKey, ts);
+            }
+            // Broadcasts clear attention: agent is actively participating
+            // Track as a "catch-all" outbound timestamp for this agent
+            if (isBroadcast) {
+                updateLatest(latestOutbound, message.from, '__broadcast__', ts);
+            }
+        }
+    }
+    const needsAttention = new Set();
+    latestInbound.forEach((keyMap, agent) => {
+        keyMap.forEach((inboundTs, key) => {
+            // Skip if inbound message is too old (outside attention window)
+            if (inboundTs < cutoffTime)
+                return;
+            const outboundTs = latestOutbound.get(agent)?.get(key) ?? -Infinity;
+            // Also check if agent sent a broadcast after the inbound message
+            const broadcastTs = latestOutbound.get(agent)?.get('__broadcast__') ?? -Infinity;
+            const latestReply = Math.max(outboundTs, broadcastTs);
+            if (inboundTs > latestReply) {
+                needsAttention.add(agent);
+            }
+        });
+    });
+    return needsAttention;
+}
+//# sourceMappingURL=needs-attention.js.map

package/dist/dashboard/needs-attention.js.map

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