@agent-relay/sdk 10.4.0 → 10.5.0

package/dist/messaging/event-fanin.js

@@ -0,0 +1,293 @@
+const DEFAULT_DEDUPE_WINDOW_MS = 30_000;
+const DEFAULT_DEDUPE_CAPACITY = 2048;
+const DEFAULT_NO_SOURCE_WARNING_MS = 10_000;
+/**
+ * Derive a cross-source identity for an event, or `null` for events that must
+ * never be deduplicated (per-connection transport state, unknown frames).
+ */
+function dedupeKey(event) {
+    switch (event.type) {
+        case 'messageCreated':
+        case 'messageUpdated':
+        case 'threadReply':
+            return event.message?.messageId ? `${event.type}:${event.message.messageId}` : null;
+        case 'dmReceived':
+        case 'groupDmReceived':
+            return event.message?.messageId
+                ? `${event.type}:${event.conversationId}:${event.message.messageId}`
+                : null;
+        case 'messageRead':
+            return `${event.type}:${event.messageId}:${event.agentName}`;
+        case 'reactionAdded':
+        case 'reactionRemoved':
+            return `${event.type}:${event.messageId}:${event.emoji}:${event.agentName}`;
+        case 'agentOnline':
+        case 'agentOffline':
+            return `${event.type}:${event.agent?.name}`;
+        case 'agentSpawnRequested':
+        case 'agentReleaseRequested':
+            return `${event.type}:${event.agent?.name}`;
+        case 'channelCreated':
+        case 'channelUpdated':
+        case 'channelArchived':
+            return `${event.type}:${event.channel?.name}`;
+        case 'memberJoined':
+        case 'memberLeft':
+        case 'channelMuted':
+        case 'channelUnmuted':
+            return `${event.type}:${event.channel}:${event.agentName}`;
+        case 'actionInvoked':
+            return `${event.type}:${event.invocationId}`;
+        default:
+            // connected / disconnected / error / reconnecting /
+            // permanentlyDisconnected / unknown: per-source transport state.
+            return null;
+    }
+}
+/**
+ * Create an events fan-in.
+ *
+ * @param fallback - The workspace-scoped client's events surface, used only
+ *   while no agent sources exist (it may still work against servers that
+ *   accept the workspace stream). It is detached as soon as the first agent
+ *   source connects.
+ */
+export function createEventFanIn(fallback, options = {}) {
+    const dedupeWindowMs = options.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS;
+    const dedupeCapacity = options.dedupeCapacity ?? DEFAULT_DEDUPE_CAPACITY;
+    const noSourceWarningMs = options.noSourceWarningMs ?? DEFAULT_NO_SOURCE_WARNING_MS;
+    const now = options.now ?? (() => Date.now());
+    const handlers = new Map();
+    const sources = [];
+    const seenSources = new Set();
+    /** Active `on('any', ...)` forwarding per source, so disconnect can detach. */
+    const sourceForwarding = new Map();
+    const desiredChannels = new Set();
+    /** Dedupe keys → current occurrence, insertion-ordered for eviction. */
+    const seenEvents = new Map();
+    let connectRequested = false;
+    let fallbackForwarding;
+    let fallbackConnected = false;
+    let noSourceTimer;
+    const report = (error) => {
+        if (options.onError) {
+            try {
+                options.onError(error);
+            }
+            catch {
+                // Error hooks must not throw into the event source.
+            }
+            return;
+        }
+        console.warn('[agent-relay] event stream:', error);
+    };
+    const emitLocal = (event) => {
+        for (const key of [event.type, 'any']) {
+            for (const handler of handlers.get(key) ?? []) {
+                try {
+                    void Promise.resolve(handler(event)).catch(report);
+                }
+                catch (error) {
+                    report(error);
+                }
+            }
+        }
+    };
+    /**
+     * Forward an event from one source, collapsing cross-source duplicates.
+     *
+     * The engine emits one delivery per locally-registered recipient, so N
+     * sources produce N copies of one occurrence — only the first is emitted.
+     * A copy from a source that already delivered the previous occurrence is a
+     * genuine repeat (message edit, re-reaction, presence flap) and starts a
+     * new occurrence, so same-source repeats are never dropped.
+     */
+    const forward = (source, event) => {
+        const key = dedupeKey(event);
+        if (key) {
+            const at = now();
+            const record = seenEvents.get(key);
+            if (record && at - record.at < dedupeWindowMs && !record.sources.has(source)) {
+                record.sources.add(source);
+                return;
+            }
+            seenEvents.delete(key);
+            seenEvents.set(key, { at, sources: new Set([source]) });
+            while (seenEvents.size > dedupeCapacity) {
+                const oldest = seenEvents.keys().next().value;
+                if (oldest === undefined)
+                    break;
+                seenEvents.delete(oldest);
+            }
+        }
+        emitLocal(event);
+    };
+    const clearNoSourceTimer = () => {
+        if (noSourceTimer !== undefined) {
+            clearTimeout(noSourceTimer);
+            noSourceTimer = undefined;
+        }
+    };
+    const scheduleNoSourceWarning = () => {
+        if (noSourceTimer !== undefined || noSourceWarningMs <= 0)
+            return;
+        noSourceTimer = setTimeout(() => {
+            noSourceTimer = undefined;
+            if (!connectRequested || sources.length > 0)
+                return;
+            report(new Error('Listening for relay events, but no registered agent is connected. ' +
+                "Relaycast delivers events over each agent's node transport, and the " +
+                'workspace-key stream cannot receive them. Register an agent first ' +
+                '(`relay.workspace.register(...)` / `workspace.reconnect(...)`) so the ' +
+                'listener has a live connection to stream through.'));
+        }, noSourceWarningMs);
+        noSourceTimer.unref?.();
+    };
+    const attachSourceForwarding = (source) => {
+        if (sourceForwarding.has(source))
+            return;
+        sourceForwarding.set(source, source.on('any', (event) => forward(source, event)));
+    };
+    const detachAllForwarding = () => {
+        for (const off of sourceForwarding.values())
+            off();
+        sourceForwarding.clear();
+    };
+    const connectSource = (source) => {
+        if (typeof source.connect === 'function') {
+            try {
+                source.connect();
+            }
+            catch (error) {
+                report(error);
+            }
+        }
+        if (desiredChannels.size > 0 && typeof source.subscribe === 'function') {
+            try {
+                source.subscribe([...desiredChannels]);
+            }
+            catch (error) {
+                report(error);
+            }
+        }
+    };
+    const attachFallback = () => {
+        // Injected fakes may carry a partial surface; only a stream that can be
+        // observed is worth attaching.
+        if (!fallback || fallbackForwarding || typeof fallback.on !== 'function')
+            return;
+        fallbackForwarding = fallback.on('any', (event) => forward(fallback, event));
+        if (typeof fallback.connect === 'function') {
+            try {
+                fallback.connect();
+                fallbackConnected = true;
+            }
+            catch (error) {
+                // A workspace-key client may have no stream at all; agent sources can
+                // still arrive later, so surface the failure without giving up.
+                report(error);
+            }
+        }
+    };
+    const detachFallback = () => {
+        if (!fallbackForwarding)
+            return;
+        fallbackForwarding();
+        fallbackForwarding = undefined;
+        if (fallbackConnected) {
+            fallbackConnected = false;
+            if (typeof fallback?.disconnect === 'function') {
+                try {
+                    void fallback.disconnect().catch(() => { });
+                }
+                catch {
+                    // Fallback surfaces whose disconnect misbehaves are left as-is.
+                }
+            }
+        }
+    };
+    return {
+        addSource: (source) => {
+            // A source without a subscribable stream (partial fakes injected via
+            // `createAgentMessaging`) contributes nothing; skip it entirely.
+            if (!source || typeof source.on !== 'function')
+                return;
+            if (seenSources.has(source))
+                return;
+            seenSources.add(source);
+            sources.push(source);
+            attachSourceForwarding(source);
+            if (connectRequested) {
+                connectSource(source);
+                clearNoSourceTimer();
+                // The agent transport is the real event stream; stop the workspace
+                // fallback so it does not sit in a doomed reconnect loop.
+                detachFallback();
+            }
+        },
+        hasAgentSources: () => sources.length > 0,
+        connect: () => {
+            connectRequested = true;
+            if (sources.length > 0) {
+                for (const source of sources) {
+                    // Re-attach forwarding dropped by a prior disconnect().
+                    attachSourceForwarding(source);
+                    connectSource(source);
+                }
+                return;
+            }
+            attachFallback();
+            scheduleNoSourceWarning();
+        },
+        disconnect: async () => {
+            connectRequested = false;
+            clearNoSourceTimer();
+            detachFallback();
+            // Stop forwarding first so a source another owner reconnects later
+            // cannot feed listeners that were explicitly disconnected.
+            detachAllForwarding();
+            await Promise.allSettled(sources.map((source) => Promise.resolve().then(() => {
+                if (typeof source.disconnect === 'function')
+                    return source.disconnect();
+                return undefined;
+            })));
+        },
+        subscribe: (channels) => {
+            for (const channel of channels)
+                desiredChannels.add(channel);
+            for (const source of sources) {
+                if (typeof source.subscribe !== 'function')
+                    continue;
+                try {
+                    source.subscribe(channels);
+                }
+                catch (error) {
+                    report(error);
+                }
+            }
+        },
+        unsubscribe: (channels) => {
+            for (const channel of channels)
+                desiredChannels.delete(channel);
+            for (const source of sources) {
+                if (typeof source.unsubscribe !== 'function')
+                    continue;
+                try {
+                    source.unsubscribe(channels);
+                }
+                catch (error) {
+                    report(error);
+                }
+            }
+        },
+        on: (event, handler) => {
+            const set = handlers.get(event) ?? new Set();
+            set.add(handler);
+            handlers.set(event, set);
+            return () => {
+                set.delete(handler);
+            };
+        },
+    };
+}
+//# sourceMappingURL=event-fanin.js.map

package/dist/messaging/event-fanin.js.map

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

package/dist/messaging/index.d.ts

@@ -1,5 +1,7 @@
 export * from './types.js';
 export * from './normalize.js';
+export { createEventFanIn, type EventFanInOptions, type RelayEventFanIn } from './event-fanin.js';
+export { createObserverEventSource, type ObserverEventSourceOptions, type ObserverLiveStream, } from './observer-source.js';
 export { RelayPlacementError, RelaycastMessagingClient, type RelaycastMessagingOptions, } from './relaycast.js';
 export * from './thin-client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/messaging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/messaging/index.js

@@ -1,5 +1,7 @@
 export * from './types.js';
 export * from './normalize.js';
+export { createEventFanIn } from './event-fanin.js';
+export { createObserverEventSource, } from './observer-source.js';
 export { RelayPlacementError, RelaycastMessagingClient, } from './relaycast.js';
 export * from './thin-client.js';
 //# sourceMappingURL=index.js.map

package/dist/messaging/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAgD,MAAM,kBAAkB,CAAC;AAClG,OAAO,EACL,yBAAyB,GAG1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/messaging/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/messaging/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EAGtB,YAAY,EACZ,kBAAkB,EAElB,sBAAsB,EACtB,4BAA4B,EAC5B,4BAA4B,EAC5B,UAAU,EAIV,YAAY,EACZ,sBAAsB,EAEtB,gBAAgB,EAEhB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAwDpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AA+BD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAWvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAsBzD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAYjF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CASzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAazE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAmB7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAuE1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAOtE;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAwE3F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAa3D;AAqCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAwBzD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAarE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CASjF;AAWD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAEjF;AAmBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CA2BtG;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,EAC9C,KAAK,EAAE,OAAO,GACb,4BAA4B,CAW9B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAYvE;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAoB7F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAuL3E"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/messaging/normalize.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,4BAA4B,EAC5B,4BAA4B,EAC5B,UAAU,EAIV,YAAY,EACZ,sBAAsB,EAGtB,gBAAgB,EAChB,oBAAoB,EAEpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAuFpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AA4HD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CASvE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAczD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAUjF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAQzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAUzE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAc7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAgD1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAOtE;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CAmC3F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAgB3D;AAiCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAWzD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAQrE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAOjF;AAqBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAGjF;AAgBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CAkBtG;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,EAC9C,KAAK,EAAE,OAAO,GACb,4BAA4B,CAU9B;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAUvE;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,CAiB7F;AASD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA2I3E"}