agent-relay 1.0.7 → 1.0.9

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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"}