@naylence/runtime 0.3.6 → 0.3.9

package/dist/node/index.cjs

@@ -14,12 +14,12 @@ var fastify = require('fastify');
 var websocketPlugin = require('@fastify/websocket');
 
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.6
+// Generated from package.json version: 0.3.9
 /**
  * The package version, injected at build time.
  * @internal
  */
-const VERSION = '0.3.6';
+const VERSION = '0.3.9';
 
 /**
  * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -2248,6 +2248,50 @@ function validateKeyCorrelationTtlSec(ttlSec) {
     });
 }
 
+function isModuleNotFoundError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message || '';
+    if (message.includes('Cannot find module') ||
+        message.includes('ERR_MODULE_NOT_FOUND') ||
+        message.includes('MODULE_NOT_FOUND')) {
+        return true;
+    }
+    const code = error.code;
+    if (typeof code === 'string') {
+        return code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND';
+    }
+    return false;
+}
+/**
+ * Wraps a dynamic import loader and enriches "module not found" failures with an actionable error message.
+ */
+async function safeImport(loader, dependencyNameOrOptions, maybeOptions) {
+    const options = typeof dependencyNameOrOptions === 'string'
+        ? { dependencyName: dependencyNameOrOptions, ...(maybeOptions ?? {}) }
+        : dependencyNameOrOptions;
+    const dependencyName = options.dependencyName;
+    try {
+        return await loader();
+    }
+    catch (error) {
+        if (isModuleNotFoundError(error)) {
+            const message = options.helpMessage ??
+                `Missing optional dependency "${dependencyName}". Install it to enable this feature.`;
+            const enrichedError = new Error(message);
+            try {
+                enrichedError.cause = error;
+            }
+            catch {
+                // Ignore environments that do not support attaching a cause.
+            }
+            throw enrichedError;
+        }
+        throw error;
+    }
+}
+
 /**
  * flow_controller.ts - credit window management with cooperative back-pressure.
  *
@@ -3452,50 +3496,6 @@ function normalizeSecretSource(value) {
     return SecretSource.normalize(value);
 }
 
-function isModuleNotFoundError(error) {
-    if (!(error instanceof Error)) {
-        return false;
-    }
-    const message = error.message || '';
-    if (message.includes('Cannot find module') ||
-        message.includes('ERR_MODULE_NOT_FOUND') ||
-        message.includes('MODULE_NOT_FOUND')) {
-        return true;
-    }
-    const code = error.code;
-    if (typeof code === 'string') {
-        return code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND';
-    }
-    return false;
-}
-/**
- * Wraps a dynamic import loader and enriches "module not found" failures with an actionable error message.
- */
-async function safeImport(loader, dependencyNameOrOptions, maybeOptions) {
-    const options = typeof dependencyNameOrOptions === 'string'
-        ? { dependencyName: dependencyNameOrOptions, ...(maybeOptions ?? {}) }
-        : dependencyNameOrOptions;
-    const dependencyName = options.dependencyName;
-    try {
-        return await loader();
-    }
-    catch (error) {
-        if (isModuleNotFoundError(error)) {
-            const message = options.helpMessage ??
-                `Missing optional dependency "${dependencyName}". Install it to enable this feature.`;
-            const enrichedError = new Error(message);
-            try {
-                enrichedError.cause = error;
-            }
-            catch {
-                // Ignore environments that do not support attaching a cause.
-            }
-            throw enrichedError;
-        }
-        throw error;
-    }
-}
-
 const indexedDBConfigSchema = zod.z
     .object({
     type: zod.z
@@ -7091,9 +7091,6 @@ class DefaultDeliveryTracker extends TaskSpawner {
         this.ackDoneSince = new Map();
         this.replyDoneSince = new Map();
         this.pendingAckDispatches = new Set();
-        this.recentlyHandled = new Map();
-        this.recentlyHandledOrder = [];
-        this.recentlyHandledTtlMs = 60000;
         this.isPreparingToStop = false;
         this.shutdownRequestedAtMs = null;
         this.shutdownRetryGraceMs = 1000;
@@ -7315,22 +7312,6 @@ class DefaultDeliveryTracker extends TaskSpawner {
                 }
             }
             else {
-                const wasRecentlyHandled = await this.lock.runExclusive(async () => this.wasRecentlyHandled(envelope.id));
-                if (wasRecentlyHandled) {
-                    logger$12.debug('tracker_duplicate_envelope_recently_handled', {
-                        envp_id: envelope.id,
-                    });
-                    return new TrackedEnvelope({
-                        timeoutAtMs: 0,
-                        overallTimeoutAtMs: 0,
-                        expectedResponseType: envelope.rtype ?? core.FameResponseType.NONE,
-                        createdAtMs: Date.now(),
-                        status: EnvelopeStatus.HANDLED,
-                        mailboxType: MailboxType.INBOX,
-                        originalEnvelope: envelope,
-                        serviceName: inboxName,
-                    });
-                }
                 tracked = new TrackedEnvelope({
                     timeoutAtMs: 0,
                     overallTimeoutAtMs: 0,
@@ -7352,12 +7333,8 @@ class DefaultDeliveryTracker extends TaskSpawner {
     async onEnvelopeHandled(envelope) {
         const inbox = this.ensureInbox();
         envelope.status = EnvelopeStatus.HANDLED;
+        // Delete the envelope from inbox to prevent growth
         await inbox.delete(envelope.originalEnvelope.id);
-        await this.lock.runExclusive(async () => {
-            this.markRecentlyHandled(envelope.originalEnvelope.id);
-        });
-        // Preserve handled envelope to prevent duplicate redelivery during shutdown drains.
-        // await inbox.set(envelope.originalEnvelope.id, envelope);
     }
     async onEnvelopeHandleFailed(inboxName, envelope, context, error, isFinalFailure = false) {
         const inbox = this.ensureInbox();
@@ -7572,9 +7549,9 @@ class DefaultDeliveryTracker extends TaskSpawner {
         });
         await this.markDoneSince(this.replyFutures, trackedEnvelope.originalEnvelope.id, this.replyDoneSince);
         await this.markDoneSince(this.ackFutures, trackedEnvelope.originalEnvelope.id, this.ackDoneSince);
-        if (envelope.rtype && Boolean(envelope.rtype & core.FameResponseType.ACK)) {
-            await this.sendAck(envelope);
-        }
+        // Note: ACK is already sent in onCorrelatedMessage (lines 655-657)
+        // when the reply envelope is first delivered. No need to send it again here.
+        // Removing this duplicate sendAck call fixes the duplicate DeliveryAck bug.
         for (const handler of this.eventHandlers) {
             await handler.onEnvelopeReplied?.(trackedEnvelope, envelope);
         }
@@ -7724,8 +7701,6 @@ class DefaultDeliveryTracker extends TaskSpawner {
             }
             this.streamDone.clear();
             this.correlationToEnvelope.clear();
-            this.recentlyHandled.clear();
-            this.recentlyHandledOrder.length = 0;
             return values;
         });
         for (const timer of timers) {
@@ -8307,39 +8282,6 @@ class DefaultDeliveryTracker extends TaskSpawner {
             this.pendingAckDispatches.delete(ackDispatch);
         }
     }
-    markRecentlyHandled(envelopeId) {
-        const now = Date.now();
-        this.recentlyHandled.set(envelopeId, now);
-        this.recentlyHandledOrder.push(envelopeId);
-        this.trimRecentlyHandled(now);
-    }
-    wasRecentlyHandled(envelopeId) {
-        const now = Date.now();
-        const timestamp = this.recentlyHandled.get(envelopeId);
-        if (timestamp === undefined) {
-            return false;
-        }
-        if (now - timestamp > this.recentlyHandledTtlMs) {
-            this.recentlyHandled.delete(envelopeId);
-            return false;
-        }
-        return true;
-    }
-    trimRecentlyHandled(now) {
-        while (this.recentlyHandledOrder.length > 0) {
-            const candidate = this.recentlyHandledOrder[0];
-            const timestamp = this.recentlyHandled.get(candidate);
-            if (timestamp === undefined) {
-                this.recentlyHandledOrder.shift();
-                continue;
-            }
-            if (now - timestamp <= this.recentlyHandledTtlMs) {
-                break;
-            }
-            this.recentlyHandled.delete(candidate);
-            this.recentlyHandledOrder.shift();
-        }
-    }
     getShutdownRetryDeferDelay(nowMs) {
         if (!this.isPreparingToStop || this.shutdownRequestedAtMs === null) {
             return null;
@@ -9833,7 +9775,8 @@ const ensureBroadcastEnvironment = () => {
 };
 let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAsyncConnector {
     static generateConnectorId() {
-        const globalCrypto = globalThis.crypto;
+        const globalCrypto = globalThis
+            .crypto;
         if (globalCrypto?.randomUUID) {
             return globalCrypto.randomUUID();
         }
@@ -9888,7 +9831,8 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         this.listenerRegistered = false;
         this.visibilityChangeListenerRegistered = false;
         this.channelName =
-            typeof config.channelName === 'string' && config.channelName.trim().length > 0
+            typeof config.channelName === 'string' &&
+                config.channelName.trim().length > 0
                 ? config.channelName.trim()
                 : DEFAULT_CHANNEL$7;
         const preferredCapacity = typeof config.inboxCapacity === 'number' &&
@@ -9912,6 +9856,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             local_node_id: this.localNodeId,
             target_node_id: this.targetNodeId ?? null,
             inbox_capacity: preferredCapacity,
+            passive: config.passive ?? false,
             timestamp: new Date().toISOString(),
         });
         this.onMsg = (event) => {
@@ -9929,7 +9874,8 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 message_type: message && typeof message === 'object'
-                    ? message.constructor?.name ?? typeof message
+                    ? (message.constructor
+                        ?.name ?? typeof message)
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
                 has_sender_node_id: Boolean(message?.senderNodeId),
@@ -10159,7 +10105,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
                 timestamp: new Date().toISOString(),
             });
         }
-        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+        if (this.visibilityChangeListenerRegistered &&
+            this.visibilityChangeHandler &&
+            typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
@@ -10187,7 +10135,7 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
         return rawOrEnvelope;
     }
     _isWildcardTarget() {
-        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+        return (this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined');
     }
     _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
         if (this._isWildcardTarget()) {
@@ -10207,7 +10155,9 @@ let BroadcastChannelConnector$2 = class BroadcastChannelConnector extends BaseAs
             return true;
         }
         const expectedSender = this.targetNodeId;
-        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+        if (expectedSender &&
+            expectedSender !== '*' &&
+            senderNodeId !== expectedSender) {
             logger$_.debug('broadcast_channel_message_rejected', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -10426,14 +10376,16 @@ function normalizeBroadcastChannelConnectionGrant(candidate) {
         type,
         purpose,
     };
-    const channelValue = candidate.channelName ?? candidate['channel_name'];
+    const channelValue = candidate.channelName ??
+        candidate['channel_name'];
     if (channelValue !== undefined) {
         if (typeof channelValue !== 'string' || channelValue.trim().length === 0) {
             throw new TypeError('BroadcastChannelConnectionGrant "channelName" must be a non-empty string when provided');
         }
         result.channelName = channelValue.trim();
     }
-    const inboxValue = candidate.inboxCapacity ?? candidate['inbox_capacity'];
+    const inboxValue = candidate.inboxCapacity ??
+        candidate['inbox_capacity'];
     if (inboxValue !== undefined) {
         if (typeof inboxValue !== 'number' ||
             !Number.isFinite(inboxValue) ||
@@ -10442,7 +10394,8 @@ function normalizeBroadcastChannelConnectionGrant(candidate) {
         }
         result.inboxCapacity = Math.floor(inboxValue);
     }
-    const windowValue = candidate.initialWindow ?? candidate['initial_window'];
+    const windowValue = candidate.initialWindow ??
+        candidate['initial_window'];
     if (windowValue !== undefined) {
         if (typeof windowValue !== 'number' ||
             !Number.isFinite(windowValue) ||
@@ -10779,25 +10732,56 @@ class UpstreamSessionManager extends TaskSpawner {
         await connector.start(this.wrappedHandler);
         this.connector = connector;
         const callbackGrants = this.node.gatherSupportedCallbackGrants();
+        logger$Z.debug('callback_grants_before_augmentation', {
+            count: callbackGrants.length,
+            types: callbackGrants.map((g) => g.type),
+        });
+        // Check if we should create a broadcast callback grant before processing connection grants
+        // This prevents adding duplicate broadcast grants
+        const shouldAddBroadcastGrant = this.shouldAdvertiseBroadcastGrant(grant, callbackGrants);
+        const broadcastCallbackGrant = shouldAddBroadcastGrant
+            ? this.createBroadcastCallbackGrant(grant)
+            : null;
+        logger$Z.debug('broadcast_callback_grant_check', {
+            should_add: shouldAddBroadcastGrant,
+            grant_created: !!broadcastCallbackGrant,
+        });
         // Include admission client's connection grants as callback grants
         // This ensures DirectAdmissionClient grants are available for grant selection
-        if (welcome.frame.connectionGrants && Array.isArray(welcome.frame.connectionGrants)) {
+        if (welcome.frame.connectionGrants &&
+            Array.isArray(welcome.frame.connectionGrants)) {
             for (const grant of welcome.frame.connectionGrants) {
                 if (grant && typeof grant === 'object') {
                     // Avoid duplicates by checking if grant already exists
-                    const isDuplicate = callbackGrants.some(existing => JSON.stringify(existing) === JSON.stringify(grant));
+                    const isDuplicate = callbackGrants.some((existing) => JSON.stringify(existing) === JSON.stringify(grant));
                     if (!isDuplicate) {
                         callbackGrants.push(grant);
+                        logger$Z.debug('added_connection_grant_as_callback', {
+                            type: grant.type,
+                        });
+                    }
+                    else {
+                        logger$Z.debug('skipped_duplicate_connection_grant', {
+                            type: grant.type,
+                        });
                     }
                 }
             }
         }
-        if (this.shouldAdvertiseBroadcastGrant(grant, callbackGrants)) {
-            const augmented = this.createBroadcastCallbackGrant(grant);
-            if (augmented) {
-                callbackGrants.push(augmented);
-            }
+        // Add broadcast grant after connection grants to ensure we don't duplicate
+        // any broadcast grants that may have been in connectionGrants
+        if (broadcastCallbackGrant &&
+            this.shouldAdvertiseBroadcastGrant(grant, callbackGrants)) {
+            callbackGrants.push(broadcastCallbackGrant);
+            logger$Z.debug('added_broadcast_callback_grant');
+        }
+        else if (broadcastCallbackGrant) {
+            logger$Z.debug('skipped_duplicate_broadcast_callback_grant');
         }
+        logger$Z.debug('callback_grants_after_augmentation', {
+            count: callbackGrants.length,
+            types: callbackGrants.map((g) => g.type),
+        });
         const attachInfo = await this.attachClient.attach(this.node, this.outboundOriginType, connector, welcome.frame, this.wrappedHandler, this.getKeys() ?? undefined, callbackGrants);
         this.targetSystemId = attachInfo.targetSystemId ?? null;
         if (this.targetSystemId) {
@@ -11038,7 +11022,8 @@ class UpstreamSessionManager extends TaskSpawner {
                 continue;
             }
             // Reset ack time if just resumed from pause (prevents immediate timeout)
-            if (previousState === core.ConnectorState.PAUSED && currentState === core.ConnectorState.STARTED) {
+            if (previousState === core.ConnectorState.PAUSED &&
+                currentState === core.ConnectorState.STARTED) {
                 logger$Z.debug('connector_just_resumed_resetting_ack_time', {
                     previous_state: previousState,
                     current_state: currentState,
@@ -12595,15 +12580,30 @@ class DefaultNodeAttachClient {
     constructor(options = {}) {
         this.buffer = [];
         this.inHandshake = false;
+        this.expectedSystemId = null;
         this.timeoutMs = options.timeoutMs ?? 10000;
         this.attachmentKeyValidator = options.attachmentKeyValidator;
         this.replicaStickinessManager = options.replicaStickinessManager ?? null;
     }
     async attach(node, originType, connector, welcomeFrame, finalHandler, keys, callbackGrants) {
         this.inHandshake = true;
+        this.expectedSystemId = welcomeFrame.systemId;
         const interimHandler = async (envelope, context) => {
             if (this.inHandshake) {
-                this.buffer.push(envelope);
+                // Filter: only buffer frames related to our systemId or frames without systemId info
+                const frameSystemId = envelope.frame
+                    ?.systemId;
+                if (!frameSystemId || frameSystemId === this.expectedSystemId) {
+                    this.buffer.push(envelope);
+                }
+                else {
+                    // Silently ignore frames from other agents during concurrent handshakes
+                    logger$W.debug('handshake_ignoring_frame_from_different_system', {
+                        frame_type: envelope.frame.type,
+                        frame_system_id: frameSystemId,
+                        expected_system_id: this.expectedSystemId,
+                    });
+                }
                 return null;
             }
             return finalHandler(envelope, context);
@@ -12730,6 +12730,7 @@ class DefaultNodeAttachClient {
             parent_id: ackFrame.targetSystemId,
         });
         this.inHandshake = false;
+        this.expectedSystemId = null;
         await connector.replaceHandler(finalHandler);
         while (this.buffer.length > 0) {
             const bufferedEnvelope = this.buffer.shift();
@@ -12787,7 +12788,8 @@ class DefaultNodeAttachClient {
         const deadline = Date.now() + this.timeoutMs;
         while (Date.now() < deadline) {
             // Allow both STARTED and PAUSED states (PAUSED = tab hidden but connection alive)
-            if (connector.state !== core.ConnectorState.STARTED && connector.state !== core.ConnectorState.PAUSED) {
+            if (connector.state !== core.ConnectorState.STARTED &&
+                connector.state !== core.ConnectorState.PAUSED) {
                 let errorMessage = 'Connector closed while waiting for NodeAttachAck';
                 if (connector.closeCode !== undefined) {
                     errorMessage += ` (code=${connector.closeCode}`;
@@ -12806,9 +12808,21 @@ class DefaultNodeAttachClient {
                 if (envelope.frame.type === 'NodeAttachAck') {
                     return envelope;
                 }
-                logger$W.error('unexpected_frame_during_handshake', {
-                    frame_type: envelope.frame.type,
-                });
+                // NodeAttach frames during handshake are expected in multi-agent scenarios
+                // where multiple agents attach concurrently to the same channel
+                if (envelope.frame.type === 'NodeAttach') {
+                    logger$W.debug('handshake_ignoring_concurrent_attach', {
+                        frame_type: envelope.frame.type,
+                        frame_system_id: envelope.frame?.systemId ??
+                            'unknown',
+                    });
+                }
+                else {
+                    // Other unexpected frames are still logged as errors
+                    logger$W.error('unexpected_frame_during_handshake', {
+                        frame_type: envelope.frame.type,
+                    });
+                }
             }
             await delay(HANDSHAKE_POLL_INTERVAL_MS);
         }
@@ -13527,7 +13541,8 @@ function createFsShim() {
                 else if (options &&
                     typeof options === 'object' &&
                     'encoding' in options &&
-                    typeof options.encoding === 'string') {
+                    typeof options.encoding ===
+                        'string') {
                     encoding = options.encoding;
                 }
                 const data = fsBinding.readFileUtf8(pathOrDescriptor, 0);
@@ -20460,7 +20475,8 @@ class InPageConnector extends BaseAsyncConnector {
         this.listenerRegistered = false;
         this.visibilityChangeListenerRegistered = false;
         this.channelName =
-            typeof config.channelName === 'string' && config.channelName.trim().length > 0
+            typeof config.channelName === 'string' &&
+                config.channelName.trim().length > 0
                 ? config.channelName.trim()
                 : DEFAULT_CHANNEL$6;
         const preferredCapacity = typeof config.inboxCapacity === 'number' &&
@@ -20499,7 +20515,8 @@ class InPageConnector extends BaseAsyncConnector {
                 channel: this.channelName,
                 connector_id: this.connectorId,
                 message_type: message && typeof message === 'object'
-                    ? message.constructor?.name ?? typeof message
+                    ? (message.constructor
+                        ?.name ?? typeof message)
                     : typeof message,
                 has_sender_id: Boolean(message?.senderId),
                 has_sender_node_id: Boolean(message?.senderNodeId),
@@ -20508,7 +20525,8 @@ class InPageConnector extends BaseAsyncConnector {
                 return;
             }
             const busMessage = message;
-            const senderId = typeof busMessage.senderId === 'string' && busMessage.senderId.length > 0
+            const senderId = typeof busMessage.senderId === 'string' &&
+                busMessage.senderId.length > 0
                 ? busMessage.senderId
                 : null;
             const senderNodeId = InPageConnector.normalizeNodeId(busMessage.senderNodeId);
@@ -20759,7 +20777,9 @@ class InPageConnector extends BaseAsyncConnector {
                 timestamp: new Date().toISOString(),
             });
         }
-        if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+        if (this.visibilityChangeListenerRegistered &&
+            this.visibilityChangeHandler &&
+            typeof document !== 'undefined') {
             document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
             this.visibilityChangeListenerRegistered = false;
             this.visibilityChangeHandler = undefined;
@@ -20776,7 +20796,7 @@ class InPageConnector extends BaseAsyncConnector {
         return rawOrEnvelope;
     }
     _isWildcardTarget() {
-        return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+        return (this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined');
     }
     _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
         if (this._isWildcardTarget()) {
@@ -20796,7 +20816,9 @@ class InPageConnector extends BaseAsyncConnector {
             return true;
         }
         const expectedSender = this.targetNodeId;
-        if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+        if (expectedSender &&
+            expectedSender !== '*' &&
+            senderNodeId !== expectedSender) {
             logger$G.debug('inpage_message_rejected', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
@@ -21216,8 +21238,8 @@ class CertificateManagerFactory extends factory.AbstractResourceFactory {
     }
 }
 
-const DEFAULT_UNCONFIGURED_MESSAGE = "Trust store is not configured. Set FAME_CA_CERTS to a PEM value, a file path, a data URI, or an HTTPS bundle URL.";
-const TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE = "TrustStoreProviderFactory";
+const DEFAULT_UNCONFIGURED_MESSAGE = 'Trust store is not configured. Set FAME_CA_CERTS to a PEM value, a file path, a data URI, or an HTTPS bundle URL.';
+const TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE = 'TrustStoreProviderFactory';
 class TrustStoreProviderFactory extends factory.AbstractResourceFactory {
     createUnconfiguredProvider(reason) {
         return new NoopTrustStoreProvider(reason ?? DEFAULT_UNCONFIGURED_MESSAGE);
@@ -24945,7 +24967,8 @@ class DefaultSecurityManager {
             const hasSignature = Boolean(envelope.sec?.sig);
             if (!hasSignature) {
                 const nodeSid = node.sid;
-                const envelopeSid = envelope.sid;
+                const envelopeSid = envelope
+                    .sid;
                 const isLocalUnsignedSelfEnvelope = localContext.originType === core.DeliveryOriginType.LOCAL &&
                     typeof nodeSid === 'string' &&
                     nodeSid.length > 0 &&
@@ -28225,14 +28248,16 @@ function normalizeInPageConnectionGrant(candidate) {
         type,
         purpose,
     };
-    const channelValue = candidate.channelName ?? candidate['channel_name'];
+    const channelValue = candidate.channelName ??
+        candidate['channel_name'];
     if (channelValue !== undefined) {
         if (typeof channelValue !== 'string' || channelValue.trim().length === 0) {
             throw new TypeError('InPageConnectionGrant "channelName" must be a non-empty string when provided');
         }
         result.channelName = channelValue.trim();
     }
-    const inboxValue = candidate.inboxCapacity ?? candidate['inbox_capacity'];
+    const inboxValue = candidate.inboxCapacity ??
+        candidate['inbox_capacity'];
     if (inboxValue !== undefined) {
         if (typeof inboxValue !== 'number' ||
             !Number.isFinite(inboxValue) ||
@@ -28748,6 +28773,44 @@ function normalizeRouterOptions(options) {
     return { welcomeService, prefix };
 }
 
+/**
+ * Fabric Registry
+ *
+ * Provides a mapping from nodes to their associated fabrics.
+ * This allows agents to retrieve the fabric they were registered on
+ * without relying on the global fabric stack.
+ */
+/**
+ * WeakMap to store the node-to-fabric mapping.
+ * Using WeakMap ensures that nodes can be garbage collected
+ * when no longer referenced elsewhere.
+ */
+const nodeToFabric = new WeakMap();
+/**
+ * @internal
+ * Associates a node with its fabric. This should only be called
+ * by fabric implementations when they create or adopt a node.
+ *
+ * @param node - The node to associate
+ * @param fabric - The fabric that owns the node
+ */
+function _setFabricForNode(node, fabric) {
+    nodeToFabric.set(node, fabric);
+}
+/**
+ * Retrieves the fabric associated with a node.
+ *
+ * This is useful for agents that need to access the fabric they
+ * were registered on, particularly in environments where multiple
+ * fabrics exist (e.g., React with multiple FabricProviders).
+ *
+ * @param node - The node to look up
+ * @returns The fabric associated with the node, or undefined if not found
+ */
+function getFabricForNode(node) {
+    return nodeToFabric.get(node);
+}
+
 /**
  * Browser-friendly entry point for Naylence Runtime.
  *
@@ -28838,10 +28901,12 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
         };
         const channelCandidate = record.channelName ?? record['channel_name'];
-        if (typeof channelCandidate === 'string' && channelCandidate.trim().length > 0) {
+        if (typeof channelCandidate === 'string' &&
+            channelCandidate.trim().length > 0) {
             config.channelName = channelCandidate.trim();
         }
-        const inboxCandidate = record.inboxCapacity ?? record['inbox_capacity'];
+        const inboxCandidate = record.inboxCapacity ??
+            record['inbox_capacity'];
         if (typeof inboxCandidate === 'number' &&
             Number.isFinite(inboxCandidate) &&
             inboxCandidate > 0) {
@@ -28865,9 +28930,11 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
             throw new Error('BroadcastChannelConnectorFactory requires a configuration');
         }
         const normalized = this._normalizeConfig(config);
-        const options = (factoryArgs[0] ?? {});
+        const options = (factoryArgs[0] ??
+            {});
         const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
-        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ??
+            normalizedLocalNodeFromConfig;
         if (!localNodeId) {
             throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
         }
@@ -28892,6 +28959,7 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
             inboxCapacity,
             localNodeId,
             initialTargetNodeId: resolvedTarget,
+            passive: normalized.passive,
         };
         const connector = new BroadcastChannelConnector(connectorConfig, baseConfig);
         if (options.authorization) {
@@ -28930,6 +28998,9 @@ class BroadcastChannelConnectorFactory extends ConnectorFactory {
         if (normalizedLocalNodeId) {
             normalized.localNodeId = normalizedLocalNodeId;
         }
+        if (typeof candidate.passive === 'boolean') {
+            normalized.passive = candidate.passive;
+        }
         if (typeof candidate.flowControl === 'boolean') {
             normalized.flowControl = candidate.flowControl;
         }
@@ -29010,7 +29081,9 @@ function normalizeConfig$r(config) {
         : DEFAULT_CHANNEL$4;
     const rawInbox = record.inboxCapacity ?? record['inbox_capacity'];
     let inboxCapacity = DEFAULT_INBOX_CAPACITY$4;
-    if (typeof rawInbox === 'number' && Number.isFinite(rawInbox) && rawInbox > 0) {
+    if (typeof rawInbox === 'number' &&
+        Number.isFinite(rawInbox) &&
+        rawInbox > 0) {
         inboxCapacity = Math.floor(rawInbox);
     }
     else if (typeof rawInbox === 'string') {
@@ -29527,7 +29600,8 @@ class InPageConnectorFactory extends ConnectorFactory {
         const normalized = this._normalizeConfig(config);
         const options = (factoryArgs[0] ?? {});
         const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
-        const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+        const localNodeId = this._normalizeNodeId(options.localNodeId) ??
+            normalizedLocalNodeFromConfig;
         if (!localNodeId) {
             throw new Error('InPageConnectorFactory requires a localNodeId from config or create() options');
         }
@@ -29677,7 +29751,9 @@ function normalizeConfig$p(config) {
         : DEFAULT_CHANNEL$2;
     const rawInbox = record.inboxCapacity ?? record['inbox_capacity'];
     let inboxCapacity = DEFAULT_INBOX_CAPACITY$2;
-    if (typeof rawInbox === 'number' && Number.isFinite(rawInbox) && rawInbox > 0) {
+    if (typeof rawInbox === 'number' &&
+        Number.isFinite(rawInbox) &&
+        rawInbox > 0) {
         inboxCapacity = Math.floor(rawInbox);
     }
     else if (typeof rawInbox === 'string') {
@@ -29705,9 +29781,7 @@ class InPageListenerFactory extends TransportListenerFactory {
     }
     async create(config, ...factoryArgs) {
         const normalized = normalizeConfig$p(config);
-        const [{ InPageListener }] = await Promise.all([
-            getInPageListenerModule(),
-        ]);
+        const [{ InPageListener }] = await Promise.all([getInPageListenerModule()]);
         return new InPageListener({
             channelName: normalized.channelName,
             inboxCapacity: normalized.inboxCapacity,
@@ -30617,6 +30691,8 @@ class InProcessFameFabric extends core.FameFabric {
             this._currentNode = await NodeLikeFactory.createNode(nodeConfig);
             this._ownsNode = true;
         }
+        // Register this fabric in the registry so agents can look it up
+        _setFabricForNode(this._currentNode, this);
         if (this._ownsNode && !this._nodeStarted) {
             await this.getRequiredNode().start();
             this._nodeStarted = true;
@@ -32758,19 +32834,23 @@ function normalizeConfig$a(config) {
         normalized.clientSecretConfig = normalizeSecretSource(clientSecretSource);
     }
     const audienceCandidate = candidate.audience ?? candidate.aud;
-    if (typeof audienceCandidate === 'string' && audienceCandidate.trim().length > 0) {
+    if (typeof audienceCandidate === 'string' &&
+        audienceCandidate.trim().length > 0) {
         normalized.audience = audienceCandidate.trim();
     }
     const codeChallengeMethod = candidate.codeChallengeMethod ?? candidate.code_challenge_method;
-    if (typeof codeChallengeMethod === 'string' && codeChallengeMethod.trim().length > 0) {
+    if (typeof codeChallengeMethod === 'string' &&
+        codeChallengeMethod.trim().length > 0) {
         normalized.codeChallengeMethod = codeChallengeMethod.trim();
     }
     const codeVerifierLength = candidate.codeVerifierLength ?? candidate.code_verifier_length;
-    if (typeof codeVerifierLength === 'number' && Number.isFinite(codeVerifierLength)) {
+    if (typeof codeVerifierLength === 'number' &&
+        Number.isFinite(codeVerifierLength)) {
         normalized.codeVerifierLength = codeVerifierLength;
     }
     const clockSkewSeconds = candidate.clockSkewSeconds ?? candidate.clock_skew_seconds;
-    if (typeof clockSkewSeconds === 'number' && Number.isFinite(clockSkewSeconds)) {
+    if (typeof clockSkewSeconds === 'number' &&
+        Number.isFinite(clockSkewSeconds)) {
         normalized.clockSkewSeconds = clockSkewSeconds;
     }
     const loginHintParam = candidate.loginHintParam ?? candidate.login_hint_param;
@@ -32815,8 +32895,8 @@ class OAuth2PkceTokenProviderFactory extends TokenProviderFactory {
             options.audience = normalized.audience;
         }
         if (normalized.codeChallengeMethod) {
-            options.codeChallengeMethod = normalized.codeChallengeMethod
-                .toUpperCase();
+            options.codeChallengeMethod =
+                normalized.codeChallengeMethod.toUpperCase();
         }
         if (normalized.codeVerifierLength) {
             options.codeVerifierLength = normalized.codeVerifierLength;
@@ -34573,14 +34653,14 @@ var eddsaEnvelopeVerifierFactory = /*#__PURE__*/Object.freeze({
 
 const FACTORY_META$d = {
     base: TRUST_STORE_PROVIDER_FACTORY_BASE_TYPE,
-    key: "NoopTrustStoreProvider",
+    key: 'NoopTrustStoreProvider',
     isDefault: true,
     priority: 10,
 };
 class NoopTrustStoreProviderFactory extends TrustStoreProviderFactory {
     constructor() {
         super(...arguments);
-        this.type = "NoopTrustStoreProvider";
+        this.type = 'NoopTrustStoreProvider';
         this.isDefault = true;
         this.priority = 10;
     }
@@ -36283,9 +36363,7 @@ const defaultGrantSelectionPolicy = new GrantSelectionPolicy();
 const logger$a = getLogger('naylence.fame.connector.broadcast_channel_listener');
 const DEFAULT_CHANNEL$1 = 'naylence-fabric';
 const DEFAULT_INBOX_CAPACITY$1 = 2048;
-const RESPONSE_TYPE_MASK = core.FameResponseType.ACK |
-    core.FameResponseType.REPLY |
-    core.FameResponseType.STREAM;
+const RESPONSE_TYPE_MASK = core.FameResponseType.ACK | core.FameResponseType.REPLY | core.FameResponseType.STREAM;
 const isBrowserEnvironment$2 = () => typeof window !== 'undefined' &&
     typeof BroadcastChannel !== 'undefined' &&
     typeof MessageEvent !== 'undefined';
@@ -36499,9 +36577,7 @@ class BroadcastChannelListener extends TransportListener {
                     return null;
                 }
             })();
-            if (error instanceof zod.ZodError &&
-                decoded &&
-                decoded.length > 0) {
+            if (error instanceof zod.ZodError && decoded && decoded.length > 0) {
                 try {
                     const reparsed = JSON.parse(decoded);
                     const candidate = reparsed.rtype;
@@ -36724,11 +36800,19 @@ class BroadcastChannelListener extends TransportListener {
             ? Math.floor(initialWindowCandidate)
             : undefined;
         const initialTargetNodeId = this._normalizeNodeId(targetCandidate) ?? targetSystemId;
+        const passive = typeof passiveCandidate === 'boolean' ? passiveCandidate : true;
+        logger$a.debug('broadcast_channel_listener_building_connector_config', {
+            system_id: systemId,
+            channel_name: channelName,
+            passive,
+            has_base_config: !!baseConfig,
+            passive_candidate: passiveCandidate,
+        });
         return {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             channelName,
             inboxCapacity,
-            passive: typeof passiveCandidate === 'boolean' ? passiveCandidate : true,
+            passive,
             initialWindow,
             localNodeId,
             initialTargetNodeId,
@@ -37479,7 +37563,9 @@ class InPageListener extends TransportListener {
             typeof channelCandidate === 'string' && channelCandidate.trim().length > 0
                 ? channelCandidate.trim()
                 : DEFAULT_CHANNEL;
-        const normalizedCapacity = typeof inboxCandidate === 'number' && Number.isFinite(inboxCandidate) && inboxCandidate > 0
+        const normalizedCapacity = typeof inboxCandidate === 'number' &&
+            Number.isFinite(inboxCandidate) &&
+            inboxCandidate > 0
             ? Math.floor(inboxCandidate)
             : DEFAULT_INBOX_CAPACITY;
         this._inboxCapacity = normalizedCapacity;
@@ -37754,7 +37840,8 @@ class InPageListener extends TransportListener {
         if (grant.type === INPAGE_CONNECTION_GRANT_TYPE) {
             return inPageGrantToConnectorConfig(grant);
         }
-        if (typeof grant?.toConnectorConfig === 'function') {
+        if (typeof grant
+            ?.toConnectorConfig === 'function') {
             return grant.toConnectorConfig();
         }
         throw new Error(`Unsupported grant type: ${grant.type}`);
@@ -39292,8 +39379,7 @@ function normalizeOptions$2(raw) {
     const scopes = normalizeScopes(camel.scopes) ??
         normalizeScopes(snake.scopes ?? snake.scope) ??
         DEFAULT_SCOPES.slice();
-    const audience = coerceString(camel.audience) ??
-        coerceString(snake.audience ?? snake.aud);
+    const audience = coerceString(camel.audience) ?? coerceString(snake.audience ?? snake.aud);
     const fetchImpl = (camel.fetchImpl ?? snake.fetch_impl);
     const clockSkewSeconds = coerceNumber(camel.clockSkewSeconds) ??
         coerceNumber(snake.clock_skew_seconds) ??
@@ -40997,6 +41083,7 @@ exports.formatTimestamp = formatTimestamp;
 exports.formatTimestampForConsole = formatTimestampForConsole$1;
 exports.frameDigest = frameDigest;
 exports.getCurrentEnvelope = getCurrentEnvelope;
+exports.getFabricForNode = getFabricForNode;
 exports.getFameRoot = getFameRoot;
 exports.getKeyProvider = getKeyProvider;
 exports.getKeyStore = getKeyStore;
@@ -41063,6 +41150,7 @@ exports.registerRuntimeFactories = registerRuntimeFactories;
 exports.requireCryptoSupport = requireCryptoSupport;
 exports.retryWithBackoff = retryWithBackoff;
 exports.safeColor = safeColor;
+exports.safeImport = safeImport;
 exports.sealedDecrypt = sealedDecrypt;
 exports.sealedEncrypt = sealedEncrypt;
 exports.secureDigest = secureDigest;