@naylence/runtime 0.3.5-test.953 → 0.3.5-test.955

package/dist/cjs/naylence/fame/connector/inpage-listener.js

@@ -65,7 +65,6 @@ class InPageListener extends transport_listener_js_1.TransportListener {
         this._busHandler = null;
         this._senderRegistry = new Map();
         this._systemToSender = new Map();
-        this._flowIdToSender = new Map();
         this._pendingAttachments = new Map();
         ensureBrowserEnvironment();
         const channelCandidate = options?.channelName;
@@ -132,7 +131,6 @@ class InPageListener extends transport_listener_js_1.TransportListener {
         this._unregisterBusListener();
         this._senderRegistry.clear();
         this._systemToSender.clear();
-        this._flowIdToSender.clear();
         this._pendingAttachments.clear();
         logger.debug('inpage_listener_stopped', {
             channel: this._channelName,
@@ -186,25 +184,10 @@ class InPageListener extends transport_listener_js_1.TransportListener {
             await this._handleAttachFrame(senderId, envelope);
             return;
         }
-        // Try to find connector by sender ID first
-        let entry = this._senderRegistry.get(senderId);
-        // If not found and we have a flowId, try to route based on flow
-        if (!entry && envelope.flowId) {
-            const originalSenderId = this._flowIdToSender.get(envelope.flowId);
-            if (originalSenderId) {
-                entry = this._senderRegistry.get(originalSenderId);
-                logger.debug('inpage_listener_routed_by_flow_id', {
-                    sender_id: senderId,
-                    original_sender_id: originalSenderId,
-                    flow_id: envelope.flowId,
-                    frame_type: envelope.frame?.type ?? 'unknown',
-                });
-            }
-        }
+        const entry = this._senderRegistry.get(senderId);
         if (!entry) {
             logger.debug('inpage_listener_no_connector_for_sender', {
                 sender_id: senderId,
-                flow_id: envelope.flowId,
                 frame_type: envelope.frame?.type ?? 'unknown',
             });
             return;
@@ -281,15 +264,6 @@ class InPageListener extends transport_listener_js_1.TransportListener {
         }
         this._senderRegistry.set(senderId, entry);
         this._systemToSender.set(entry.systemId, senderId);
-        // Track the flowId if present so we can route responses back
-        if (envelope.flowId) {
-            this._flowIdToSender.set(envelope.flowId, senderId);
-            logger.debug('inpage_listener_registered_flow_id', {
-                sender_id: senderId,
-                system_id: entry.systemId,
-                flow_id: envelope.flowId,
-            });
-        }
         await this._deliverEnvelope(entry, envelope);
     }
     async _createConnectorForAttach(params) {
@@ -337,7 +311,7 @@ class InPageListener extends transport_listener_js_1.TransportListener {
                 origin_type: originType,
                 connector_type: connector.constructor?.name ?? 'unknown',
             });
-            return { connector, systemId, originType, senderId: params.senderId };
+            return { connector, systemId, originType };
         }
         catch (error) {
             logger.error('inpage_listener_connector_creation_failed', {
@@ -391,12 +365,6 @@ class InPageListener extends transport_listener_js_1.TransportListener {
             if (this._systemToSender.get(systemId) === senderId) {
                 this._systemToSender.delete(systemId);
             }
-            // Clean up flowId mappings for this sender
-            for (const [flowId, sid] of this._flowIdToSender.entries()) {
-                if (sid === senderId) {
-                    this._flowIdToSender.delete(flowId);
-                }
-            }
         })
             .catch((error) => {
             logger.debug('inpage_listener_wait_until_closed_failed', {
@@ -408,24 +376,9 @@ class InPageListener extends transport_listener_js_1.TransportListener {
             if (this._systemToSender.get(systemId) === senderId) {
                 this._systemToSender.delete(systemId);
             }
-            // Clean up flowId mappings for this sender
-            for (const [flowId, sid] of this._flowIdToSender.entries()) {
-                if (sid === senderId) {
-                    this._flowIdToSender.delete(flowId);
-                }
-            }
         });
     }
     async _deliverEnvelope(entry, envelope) {
-        // Track flowId for routing responses back
-        if (envelope.flowId && !this._flowIdToSender.has(envelope.flowId)) {
-            this._flowIdToSender.set(envelope.flowId, entry.senderId);
-            logger.debug('inpage_listener_registered_flow_id_on_delivery', {
-                sender_id: entry.senderId,
-                system_id: entry.systemId,
-                flow_id: envelope.flowId,
-            });
-        }
         const message = this._buildChannelMessage({
             envelope,
             connector: entry.connector,

package/dist/cjs/naylence/fame/grants/broadcast-channel-connection-grant.js

@@ -25,12 +25,9 @@ function isBroadcastChannelConnectionGrant(candidate) {
             record.inboxCapacity <= 0)) {
         return false;
     }
-    if (record.localNodeId !== undefined &&
-        (typeof record.localNodeId !== 'string' || record.localNodeId.length === 0)) {
-        return false;
-    }
-    if (record.remoteNodeId !== undefined &&
-        (typeof record.remoteNodeId !== 'string' || record.remoteNodeId.length === 0)) {
+    if (record.initialWindow !== undefined &&
+        (!Number.isFinite(record.initialWindow) ||
+            record.initialWindow <= 0)) {
         return false;
     }
     return true;
@@ -66,19 +63,14 @@ function normalizeBroadcastChannelConnectionGrant(candidate) {
         }
         result.inboxCapacity = Math.floor(inboxValue);
     }
-    const localNodeIdValue = candidate.localNodeId ?? candidate['local_node_id'];
-    if (localNodeIdValue !== undefined) {
-        if (typeof localNodeIdValue !== 'string' || localNodeIdValue.trim().length === 0) {
-            throw new TypeError('BroadcastChannelConnectionGrant "localNodeId" must be a non-empty string when provided');
+    const windowValue = candidate.initialWindow ?? candidate['initial_window'];
+    if (windowValue !== undefined) {
+        if (typeof windowValue !== 'number' ||
+            !Number.isFinite(windowValue) ||
+            windowValue <= 0) {
+            throw new TypeError('BroadcastChannelConnectionGrant "initialWindow" must be a positive number when provided');
         }
-        result.localNodeId = localNodeIdValue.trim();
-    }
-    const remoteNodeIdValue = candidate.remoteNodeId ?? candidate['remote_node_id'];
-    if (remoteNodeIdValue !== undefined) {
-        if (typeof remoteNodeIdValue !== 'string' || remoteNodeIdValue.trim().length === 0) {
-            throw new TypeError('BroadcastChannelConnectionGrant "remoteNodeId" must be a non-empty string when provided');
-        }
-        result.remoteNodeId = remoteNodeIdValue.trim();
+        result.initialWindow = Math.floor(windowValue);
     }
     return result;
 }
@@ -93,11 +85,8 @@ function broadcastChannelGrantToConnectorConfig(grant) {
     if (normalized.inboxCapacity !== undefined) {
         config.inboxCapacity = normalized.inboxCapacity;
     }
-    if (normalized.localNodeId) {
-        config.localNodeId = normalized.localNodeId;
-    }
-    if (normalized.remoteNodeId) {
-        config.remoteNodeId = normalized.remoteNodeId;
+    if (normalized.initialWindow !== undefined) {
+        config.initialWindow = normalized.initialWindow;
     }
     return config;
 }

package/dist/cjs/naylence/fame/grants/inpage-connection-grant.js

@@ -25,14 +25,6 @@ function isInPageConnectionGrant(candidate) {
             record.inboxCapacity <= 0)) {
         return false;
     }
-    if (record.localNodeId !== undefined &&
-        (typeof record.localNodeId !== 'string' || record.localNodeId.length === 0)) {
-        return false;
-    }
-    if (record.remoteNodeId !== undefined &&
-        (typeof record.remoteNodeId !== 'string' || record.remoteNodeId.length === 0)) {
-        return false;
-    }
     return true;
 }
 function normalizeInPageConnectionGrant(candidate) {
@@ -66,20 +58,6 @@ function normalizeInPageConnectionGrant(candidate) {
         }
         result.inboxCapacity = Math.floor(inboxValue);
     }
-    const localNodeIdValue = candidate.localNodeId ?? candidate['local_node_id'];
-    if (localNodeIdValue !== undefined) {
-        if (typeof localNodeIdValue !== 'string' || localNodeIdValue.trim().length === 0) {
-            throw new TypeError('InPageConnectionGrant "localNodeId" must be a non-empty string when provided');
-        }
-        result.localNodeId = localNodeIdValue.trim();
-    }
-    const remoteNodeIdValue = candidate.remoteNodeId ?? candidate['remote_node_id'];
-    if (remoteNodeIdValue !== undefined) {
-        if (typeof remoteNodeIdValue !== 'string' || remoteNodeIdValue.trim().length === 0) {
-            throw new TypeError('InPageConnectionGrant "remoteNodeId" must be a non-empty string when provided');
-        }
-        result.remoteNodeId = remoteNodeIdValue.trim();
-    }
     return result;
 }
 function inPageGrantToConnectorConfig(grant) {
@@ -93,11 +71,5 @@ function inPageGrantToConnectorConfig(grant) {
     if (normalized.inboxCapacity !== undefined) {
         config.inboxCapacity = normalized.inboxCapacity;
     }
-    if (normalized.localNodeId) {
-        config.localNodeId = normalized.localNodeId;
-    }
-    if (normalized.remoteNodeId) {
-        config.remoteNodeId = normalized.remoteNodeId;
-    }
     return config;
 }

package/dist/cjs/naylence/fame/node/admission/default-node-attach-client.js

@@ -166,20 +166,6 @@ class DefaultNodeAttachClient {
         if (!targetSystemId) {
             throw new Error('Target system ID must be set in NodeAttachAckFrame on success');
         }
-        // Update connector's remote node ID if it supports it (e.g., BroadcastChannelConnector, InPageConnector)
-        // This allows upstream connectors to switch from wildcard '*' to specific node addressing
-        const updatableConnector = connector;
-        if (typeof updatableConnector.updateRemoteNodeId === 'function') {
-            try {
-                updatableConnector.updateRemoteNodeId(targetSystemId);
-            }
-            catch (error) {
-                logger.debug('connector_remote_node_id_update_failed', {
-                    target_system_id: targetSystemId,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
         try {
             if (this.replicaStickinessManager) {
                 this.replicaStickinessManager.accept(ackFrame.stickiness ?? null);

package/dist/cjs/naylence/fame/node/upstream-session-manager.js

@@ -299,12 +299,6 @@ class UpstreamSessionManager extends task_spawner_js_1.TaskSpawner {
             cryptoProvider.prepareForAttach(welcome.frame.systemId, welcome.frame.assignedPath, welcome.frame.acceptedLogicals ?? []);
         }
         await this.onWelcome(welcome.frame);
-        // Inject node ID into grant for transport frame multiplexing
-        // This ensures localNodeId matches the node's systemId for proper frame filtering
-        grant.localNodeId = welcome.frame.systemId;
-        if (welcome.frame.targetSystemId) {
-            grant.remoteNodeId = welcome.frame.targetSystemId;
-        }
         const connector = await connector_factory_js_1.ConnectorFactory.createConnector(grant, {
             systemId: welcome.frame.systemId,
         });

package/dist/cjs/version.js

@@ -1,10 +1,10 @@
 "use strict";
 // This file is auto-generated during build - do not edit manually
-// Generated from package.json version: 0.3.5-test.953
+// Generated from package.json version: 0.3.5-test.955
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
 /**
  * The package version, injected at build time.
  * @internal
  */
-exports.VERSION = '0.3.5-test.953';
+exports.VERSION = '0.3.5-test.955';

package/dist/esm/naylence/fame/channel/flow-controller.js

@@ -22,6 +22,8 @@
  * flow at any time.
  */
 import { FlowFlags } from '@naylence/core';
+import { getLogger } from '../util/logging.js';
+const logger = getLogger('naylence.fame.flow.flow_controller');
 /**
  * Simple condition variable implementation for TypeScript/Node.js
  * Similar to Python's asyncio.Condition
@@ -147,8 +149,17 @@ export class FlowController {
         // clamp into [0, initialWindow]
         const newBalance = Math.max(0, Math.min(this.initialWindow, prev + delta));
         this.credits.set(flowId, newBalance);
+        const crossedZero = prev <= 0 && newBalance > 0;
+        logger.debug('flow_controller_add_credits', {
+            flow_id: flowId,
+            delta,
+            prev_balance: prev,
+            new_balance: newBalance,
+            initial_window: this.initialWindow,
+            crossed_zero: crossedZero,
+        });
         // wake waiters only if we crossed the zero boundary
-        if (prev <= 0 && newBalance > 0) {
+        if (crossedZero) {
             this.wakeWaiters(flowId);
         }
         return newBalance;
@@ -159,11 +170,27 @@ export class FlowController {
     async acquire(flowId) {
         this.ensureFlow(flowId);
         const condition = this.conditions.get(flowId);
+        logger.debug('flow_controller_acquire_attempt', {
+            flow_id: flowId,
+            current_balance: this.credits.get(flowId),
+        });
         while (this.credits.get(flowId) <= 0) {
+            logger.debug('flow_controller_waiting_for_credit', {
+                flow_id: flowId,
+            });
             await condition.wait();
+            logger.debug('flow_controller_woke_with_credit', {
+                flow_id: flowId,
+                balance_after_wake: this.credits.get(flowId),
+            });
         }
         const current = this.credits.get(flowId);
         this.credits.set(flowId, current - 1);
+        logger.debug('flow_controller_credit_consumed', {
+            flow_id: flowId,
+            prev_balance: current,
+            remaining_balance: current - 1,
+        });
     }
     /**
      * Consume *credits* immediately (non-blocking).
@@ -183,6 +210,12 @@ export class FlowController {
         const current = this.credits.get(flowId);
         const remaining = Math.max(current - credits, 0);
         this.credits.set(flowId, remaining);
+        logger.debug('flow_controller_consume', {
+            flow_id: flowId,
+            requested: credits,
+            prev_balance: current,
+            remaining_balance: remaining,
+        });
         return remaining;
     }
     /**
@@ -203,6 +236,10 @@ export class FlowController {
         this.windowIds.delete(flowId);
         this.credits.set(flowId, this.initialWindow);
         this.wakeWaiters(flowId);
+        logger.debug('flow_controller_flow_reset', {
+            flow_id: flowId,
+            reset_balance: this.initialWindow,
+        });
     }
     /**
      * Return `[windowId, flags]` for the next outbound envelope.

package/dist/esm/naylence/fame/connector/broadcast-channel-connector-factory.js

@@ -37,8 +37,7 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
                 type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                 channelName: connectorConfig.channelName,
                 inboxCapacity: connectorConfig.inboxCapacity,
-                localNodeId: connectorConfig.localNodeId,
-                remoteNodeId: connectorConfig.remoteNodeId,
+                initialWindow: connectorConfig.initialWindow,
             };
         }
         const config = {
@@ -63,6 +62,7 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             purpose: 'connection',
             channelName: normalizedConfig.channelName,
             inboxCapacity: normalizedConfig.inboxCapacity,
+            initialWindow: normalizedConfig.initialWindow,
         });
         return grant;
     }
@@ -88,8 +88,6 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
             channelName,
             inboxCapacity,
-            localNodeId: normalized.localNodeId,
-            remoteNodeId: normalized.remoteNodeId,
         };
         const connector = new BroadcastChannelConnector(connectorConfig, baseConfig);
         if (options.authorization) {
@@ -151,16 +149,6 @@ export class BroadcastChannelConnectorFactory extends ConnectorFactory {
         if (candidate.authorizationContext !== undefined) {
             normalized.authorizationContext = candidate.authorizationContext;
         }
-        // Handle localNodeId
-        const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
-        if (typeof localNodeId === 'string' && localNodeId.trim().length > 0) {
-            normalized.localNodeId = localNodeId.trim();
-        }
-        // Handle remoteNodeId
-        const remoteNodeId = candidate.remoteNodeId ?? candidate['remote_node_id'];
-        if (typeof remoteNodeId === 'string' && remoteNodeId.trim().length > 0) {
-            normalized.remoteNodeId = remoteNodeId.trim();
-        }
         normalized.channelName = normalized.channelName ?? DEFAULT_CHANNEL;
         normalized.inboxCapacity =
             normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY;

package/dist/esm/naylence/fame/connector/broadcast-channel-connector.browser.js

@@ -3,7 +3,6 @@ import { FameTransportClose } from '../errors/errors.js';
 import { getLogger } from '../util/logging.js';
 import { BoundedAsyncQueue, QueueFullError, } from '../util/bounded-async-queue.js';
 import { ConnectorState } from '@naylence/core';
-import { wrapTransportFrame, unwrapTransportFrame, serializeTransportFrame, } from './transport-frame.js';
 const logger = getLogger('naylence.fame.connector.broadcast_channel_connector');
 export const BROADCAST_CHANNEL_CONNECTOR_TYPE = 'broadcast-channel-connector';
 const DEFAULT_CHANNEL = 'naylence-fabric';
@@ -67,22 +66,12 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             ? Math.floor(config.inboxCapacity)
             : DEFAULT_INBOX_CAPACITY;
         this.inbox = new BoundedAsyncQueue(preferredCapacity);
+        this.inboxCapacity = preferredCapacity;
         this.connectorId = BroadcastChannelConnector.generateConnectorId();
         this.channel = new BroadcastChannel(this.channelName);
-        // Set local and remote node IDs (defaults to connector ID for backwards compatibility)
-        this.localNodeId =
-            typeof config.localNodeId === 'string' && config.localNodeId.trim().length > 0
-                ? config.localNodeId.trim()
-                : this.connectorId;
-        this.remoteNodeId =
-            typeof config.remoteNodeId === 'string' && config.remoteNodeId.trim().length > 0
-                ? config.remoteNodeId.trim()
-                : '*'; // Accept from any remote if not specified
         logger.debug('broadcast_channel_connector_created', {
             channel: this.channelName,
             connector_id: this.connectorId,
-            local_node_id: this.localNodeId,
-            remote_node_id: this.remoteNodeId,
             inbox_capacity: preferredCapacity,
             timestamp: new Date().toISOString(),
         });
@@ -115,67 +104,6 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             if (busMessage.senderId === this.connectorId) {
                 return;
             }
-            // Try to unwrap as transport frame
-            const frame = unwrapTransportFrame(busMessage.payload);
-            if (frame) {
-                // Apply connector's filtering policy: strict dst check, src accepts wildcard
-                const srcMatches = this.remoteNodeId === '*' || frame.src === this.remoteNodeId;
-                const dstMatches = frame.dst === this.localNodeId;
-                if (dstMatches && srcMatches) {
-                    // Successfully received and filtered transport frame
-                    logger.debug('broadcast_channel_transport_frame_received', {
-                        channel: this.channelName,
-                        sender_id: busMessage.senderId,
-                        connector_id: this.connectorId,
-                        local_node_id: this.localNodeId,
-                        remote_node_id: this.remoteNodeId,
-                        frame_src: frame.src,
-                        frame_dst: frame.dst,
-                        payload_length: frame.payload.byteLength,
-                    });
-                    const unwrapped = frame.payload;
-                    if (this._shouldSkipDuplicateAck(busMessage.senderId, unwrapped)) {
-                        return;
-                    }
-                    try {
-                        if (typeof this.inbox.tryEnqueue === 'function') {
-                            const accepted = this.inbox.tryEnqueue(unwrapped);
-                            if (accepted) {
-                                return;
-                            }
-                        }
-                        this.inbox.enqueue(unwrapped);
-                    }
-                    catch (error) {
-                        if (error instanceof QueueFullError) {
-                            logger.warning('broadcast_channel_receive_queue_full', {
-                                channel: this.channelName,
-                            });
-                        }
-                        else {
-                            logger.error('broadcast_channel_receive_error', {
-                                channel: this.channelName,
-                                error: error instanceof Error ? error.message : String(error),
-                            });
-                        }
-                    }
-                    return;
-                }
-                else {
-                    // Frame filtered out by addressing rules
-                    logger.debug('broadcast_channel_transport_frame_filtered', {
-                        channel: this.channelName,
-                        connector_id: this.connectorId,
-                        local_node_id: this.localNodeId,
-                        remote_node_id: this.remoteNodeId,
-                        frame_src: frame.src,
-                        frame_dst: frame.dst,
-                        reason: !dstMatches ? 'wrong_destination' : 'wrong_source',
-                    });
-                    return;
-                }
-            }
-            // Fall back to legacy format (no transport frame)
             const payload = BroadcastChannelConnector.coercePayload(busMessage.payload);
             if (!payload) {
                 logger.debug('broadcast_channel_payload_rejected', {
@@ -198,15 +126,27 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
                 if (typeof this.inbox.tryEnqueue === 'function') {
                     const accepted = this.inbox.tryEnqueue(payload);
                     if (accepted) {
+                        this.logInboxSnapshot('broadcast_channel_inbox_enqueued', {
+                            source: 'listener',
+                            enqueue_strategy: 'try',
+                            payload_length: payload.byteLength,
+                        });
                         return;
                     }
                 }
                 this.inbox.enqueue(payload);
+                this.logInboxSnapshot('broadcast_channel_inbox_enqueued', {
+                    source: 'listener',
+                    enqueue_strategy: 'enqueue',
+                    payload_length: payload.byteLength,
+                });
             }
             catch (error) {
                 if (error instanceof QueueFullError) {
                     logger.warning('broadcast_channel_receive_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                 }
                 else {
@@ -290,15 +230,25 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             if (typeof this.inbox.tryEnqueue === 'function') {
                 const accepted = this.inbox.tryEnqueue(item);
                 if (accepted) {
+                    this.logInboxSnapshot('broadcast_channel_push_enqueued', {
+                        enqueue_strategy: 'try',
+                        item_type: this._describeInboxItem(item),
+                    });
                     return;
                 }
             }
             this.inbox.enqueue(item);
+            this.logInboxSnapshot('broadcast_channel_push_enqueued', {
+                enqueue_strategy: 'enqueue',
+                item_type: this._describeInboxItem(item),
+            });
         }
         catch (error) {
             if (error instanceof QueueFullError) {
                 logger.warning('broadcast_channel_push_queue_full', {
                     channel: this.channelName,
+                    inbox_capacity: this.inboxCapacity,
+                    inbox_remaining_capacity: this.inbox.remainingCapacity,
                 });
                 throw error;
             }
@@ -314,30 +264,18 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         logger.debug('broadcast_channel_message_sending', {
             channel: this.channelName,
             sender_id: this.connectorId,
-            local_node_id: this.localNodeId,
-            remote_node_id: this.remoteNodeId,
         });
-        // Only use transport framing if both localNodeId and remoteNodeId are explicitly set
-        // (not using default values). This ensures backwards compatibility.
-        const useTransportFrame = this.localNodeId !== this.connectorId ||
-            this.remoteNodeId !== '*';
-        let payload;
-        if (useTransportFrame) {
-            // Wrap payload in transport frame
-            const frame = wrapTransportFrame(data, this.localNodeId, this.remoteNodeId);
-            payload = serializeTransportFrame(frame);
-        }
-        else {
-            // Legacy format: send raw payload
-            payload = data;
-        }
         this.channel.postMessage({
             senderId: this.connectorId,
-            payload,
+            payload: data,
         });
     }
     async _transportReceive() {
-        return await this.inbox.dequeue();
+        const item = await this.inbox.dequeue();
+        this.logInboxSnapshot('broadcast_channel_inbox_dequeued', {
+            item_type: this._describeInboxItem(item),
+        });
+        return item;
     }
     async _transportClose(code, reason) {
         logger.debug('broadcast_channel_transport_closing', {
@@ -391,6 +329,28 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
         }
         return rawOrEnvelope;
     }
+    _describeInboxItem(item) {
+        if (item instanceof Uint8Array) {
+            return 'bytes';
+        }
+        if (item.envelope) {
+            return 'channel_message';
+        }
+        if (item.frame) {
+            return 'envelope';
+        }
+        return 'unknown';
+    }
+    logInboxSnapshot(event, extra = {}) {
+        logger.debug(event, {
+            channel: this.channelName,
+            connector_id: this.connectorId,
+            connector_state: this.state,
+            inbox_capacity: this.inboxCapacity,
+            inbox_remaining_capacity: this.inbox.remainingCapacity,
+            ...extra,
+        });
+    }
     _shouldSkipDuplicateAck(senderId, payload) {
         const dedupKey = this._extractAckDedupKey(payload);
         if (!dedupKey) {
@@ -489,24 +449,6 @@ export class BroadcastChannelConnector extends BaseAsyncConnector {
             });
         }
     }
-    /**
-     * Update the remote node ID after learning it from NodeAttachAck
-     * This allows upstream connectors to switch from wildcard to specific addressing
-     */
-    updateRemoteNodeId(newRemoteNodeId) {
-        if (typeof newRemoteNodeId !== 'string' || newRemoteNodeId.trim().length === 0) {
-            throw new Error('Invalid remote node ID');
-        }
-        const oldValue = this.remoteNodeId;
-        this.remoteNodeId = newRemoteNodeId.trim();
-        logger.debug('broadcast_channel_connector_remote_node_id_updated', {
-            channel: this.channelName,
-            connector_id: this.connectorId,
-            local_node_id: this.localNodeId,
-            old_remote_node_id: oldValue,
-            new_remote_node_id: this.remoteNodeId,
-        });
-    }
     _trimSeenAcks(now) {
         while (this.seenAckOrder.length > 0) {
             const candidate = this.seenAckOrder[0];