@naylence/agent-sdk 0.3.4-test.730 → 0.3.5

package/dist/browser/index.js

@@ -15674,12 +15674,12 @@
     // --- END ENV SHIM ---
 
     // This file is auto-generated during build - do not edit manually
-    // Generated from package.json version: 0.3.5-test.941
+    // Generated from package.json version: 0.3.6
     /**
      * The package version, injected at build time.
      * @internal
      */
-    const VERSION$1 = '0.3.5-test.941';
+    const VERSION$1 = '0.3.6';
 
     /**
      * Fame protocol specific error classes with WebSocket close codes and proper inheritance.
@@ -16383,7 +16383,7 @@
      * Provides functionality similar to Python's asyncio TaskSpawner with proper
      * error handling, cancellation, and graceful shutdown capabilities.
      */
-    const logger$1b = getLogger('naylence.fame.util.task_spawner');
+    const logger$1c = getLogger('naylence.fame.util.task_spawner');
     function firstDefined(source, keys) {
         for (const key of keys) {
             if (Object.prototype.hasOwnProperty.call(source, key)) {
@@ -16544,7 +16544,7 @@
             const taskId = `task-${++this._taskCounter}`;
             const taskName = normalizedOptions.name || `unnamed-${taskId}`;
             const timeout = normalizedOptions.timeout ?? this._config.defaultTimeout;
-            logger$1b.debug('starting_background_task', {
+            logger$1c.debug('starting_background_task', {
                 task_name: taskName,
                 task_id: taskId,
             });
@@ -16561,7 +16561,7 @@
             task.promise
                 .then(() => {
                 if (!this._suppressCompletionLogging) {
-                    logger$1b.debug('task_completed_successfully', {
+                    logger$1c.debug('task_completed_successfully', {
                         task_name: taskName,
                         task_id: taskId,
                         duration_ms: Date.now() - task.startTime,
@@ -16615,7 +16615,7 @@
                 error.name === 'AbortError' ||
                 error.message === 'Task cancelled' ||
                 error.message === 'Aborted') {
-                logger$1b.debug('task_cancelled', {
+                logger$1c.debug('task_cancelled', {
                     task_name: taskName,
                     note: 'Task cancelled as requested',
                 });
@@ -16623,7 +16623,7 @@
             }
             // Handle timeout
             if (error instanceof TaskTimeoutError) {
-                logger$1b.warning('task_timed_out', {
+                logger$1c.warning('task_timed_out', {
                     task_name: taskName,
                     error: error.message,
                 });
@@ -16635,7 +16635,7 @@
             // Handle known WebSocket shutdown race condition (similar to Python version)
             if (error.message.includes("await wasn't used with future") ||
                 error.message.includes('WebSocket closed during receive')) {
-                logger$1b.debug('task_shutdown_race_condition_handled', {
+                logger$1c.debug('task_shutdown_race_condition_handled', {
                     task_name: taskName,
                     note: 'Normal WebSocket close timing during shutdown - not an error',
                 });
@@ -16645,7 +16645,7 @@
             if (error.name === 'FameTransportClose' ||
                 error.message.includes('normal closure') ||
                 error.message.includes('Connection closed')) {
-                logger$1b.debug('task_shutdown_completed_normally', {
+                logger$1c.debug('task_shutdown_completed_normally', {
                     task_name: taskName,
                     note: 'Task closed normally during shutdown',
                 });
@@ -16658,14 +16658,14 @@
             // Log retriable errors as warnings (they'll be retried by upstream logic)
             // Log non-retriable errors as errors (fatal failures)
             if (isRetriableError) {
-                logger$1b.warning('background_task_failed', {
+                logger$1c.warning('background_task_failed', {
                     task_name: taskName,
                     error: error.message,
                     retriable: true,
                 });
             }
             else {
-                logger$1b.error('background_task_failed', {
+                logger$1c.error('background_task_failed', {
                     task_name: taskName,
                     error: error.message,
                     stack: error.stack,
@@ -16684,11 +16684,11 @@
         async shutdownTasks(options = {}) {
             const { gracePeriod, cancelHanging, joinTimeout } = normalizeShutdownOptions(options);
             if (this._tasks.size === 0) {
-                logger$1b.debug('shutdown_tasks_no_tasks_to_shutdown');
+                logger$1c.debug('shutdown_tasks_no_tasks_to_shutdown');
                 return;
             }
             this._suppressCompletionLogging = true;
-            logger$1b.debug('shutting_down_tasks', {
+            logger$1c.debug('shutting_down_tasks', {
                 task_count: this._tasks.size,
                 task_names: Array.from(this._tasks.values()).map((t) => t.name),
                 grace_period_ms: gracePeriod,
@@ -16703,7 +16703,7 @@
             if (cancelHanging) {
                 const stillRunning = tasks.filter((task) => task.getState() === TaskState.RUNNING && !completed.has(task));
                 if (stillRunning.length > 0) {
-                    logger$1b.debug('tasks_did_not_complete_within_grace_period', {
+                    logger$1c.debug('tasks_did_not_complete_within_grace_period', {
                         hanging_count: stillRunning.length,
                     });
                     // Wait for them to finish with individual timeouts
@@ -16713,7 +16713,7 @@
                         }
                         catch (error) {
                             if (error instanceof TaskTimeoutError) {
-                                logger$1b.warning('task_did_not_shutdown', {
+                                logger$1c.warning('task_did_not_shutdown', {
                                     task_name: task.name || task.id,
                                     join_timeout_ms: joinTimeout,
                                 });
@@ -16724,7 +16724,7 @@
                             }
                             else if (!(error instanceof TaskCancelledError)) {
                                 /* istanbul ignore next - unreachable defensive branch */
-                                logger$1b.error('task_raised_during_cancellation', {
+                                logger$1c.error('task_raised_during_cancellation', {
                                     task_name: task.name || task.id,
                                     error: error instanceof Error ? error.message : String(error),
                                 });
@@ -17298,6 +17298,7 @@
      * condition/promise and ensure at most one notifier coroutine exists for a
      * flow at any time.
      */
+    const logger$1b = getLogger('naylence.fame.flow.flow_controller');
     /**
      * Simple condition variable implementation for TypeScript/Node.js
      * Similar to Python's asyncio.Condition
@@ -17389,8 +17390,15 @@
             // Create a notifier promise
             const notifierPromise = (async () => {
                 try {
-                    // Use setImmediate to defer to next tick (similar to asyncio scheduling)
-                    await new Promise((resolve) => setImmediate(resolve));
+                    // Use setImmediate/setTimeout to defer to next tick (similar to asyncio scheduling)
+                    await new Promise((resolve) => {
+                        if (typeof setImmediate === 'function') {
+                            setImmediate(resolve);
+                        }
+                        else {
+                            setTimeout(resolve, 0);
+                        }
+                    });
                     condition.notifyAll();
                 }
                 finally {
@@ -17423,8 +17431,17 @@
             // 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$1b.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;
@@ -17435,11 +17452,29 @@
         async acquire(flowId) {
             this.ensureFlow(flowId);
             const condition = this.conditions.get(flowId);
+            logger$1b.debug('flow_controller_acquire_attempt', {
+                flow_id: flowId,
+                current_balance: this.credits.get(flowId),
+            });
             while (this.credits.get(flowId) <= 0) {
+                logger$1b.debug('flow_controller_waiting_for_credits', {
+                    flow_id: flowId,
+                    current_balance: this.credits.get(flowId),
+                });
                 await condition.wait();
             }
-            const current = this.credits.get(flowId);
-            this.credits.set(flowId, current - 1);
+            const newBalance = this.credits.get(flowId) - 1;
+            this.credits.set(flowId, newBalance);
+            logger$1b.debug('flow_controller_acquire_success', {
+                flow_id: flowId,
+                new_balance: newBalance,
+            });
+            if (newBalance <= this.lowWatermark) {
+                logger$1b.debug('flow_controller_acquire_below_low_watermark', {
+                    flow_id: flowId,
+                    low_watermark: this.lowWatermark,
+                });
+            }
         }
         /**
          * Consume *credits* immediately (non-blocking).
@@ -17459,6 +17494,12 @@
             const current = this.credits.get(flowId);
             const remaining = Math.max(current - credits, 0);
             this.credits.set(flowId, remaining);
+            logger$1b.debug('flow_controller_consume', {
+                flow_id: flowId,
+                requested: credits,
+                prev_balance: current,
+                remaining_balance: remaining,
+            });
             return remaining;
         }
         /**
@@ -17479,6 +17520,10 @@
             this.windowIds.delete(flowId);
             this.credits.set(flowId, this.initialWindow);
             this.wakeWaiters(flowId);
+            logger$1b.debug('flow_controller_flow_reset', {
+                flow_id: flowId,
+                reset_balance: this.initialWindow,
+            });
         }
         /**
          * Return `[windowId, flags]` for the next outbound envelope.
@@ -24039,10 +24084,12 @@
                 throw new FameTransportClose('Connection closed', 1006);
             }
             // Apply flow control if enabled and not a credit update
-            if (this._fcEnabled &&
-                !(envelope.frame &&
-                    'flow_id' in envelope.frame &&
-                    'credits' in envelope.frame)) {
+            const isCreditUpdateFrame = Boolean(envelope.frame &&
+                (envelope.frame.type === 'CreditUpdate' ||
+                    envelope.frame.type === 'credit_update' ||
+                    ('flowId' in envelope.frame && 'credits' in envelope.frame) ||
+                    ('flow_id' in envelope.frame && 'credits' in envelope.frame)));
+            if (this._fcEnabled && !isCreditUpdateFrame) {
                 const flowId = envelope.flowId || this._connectorFlowId;
                 envelope.flowId = flowId;
                 const t0 = this._metrics ? performance.now() : 0;
@@ -24285,11 +24332,31 @@
          * Emit credit update if flow control needs refill
          */
         async _maybeEmitCredit(flowId, traceId) {
-            if (!this._flowCtrl.needsRefill(flowId)) {
+            const remainingCredits = this._flowCtrl.getCredits(flowId);
+            const needsRefill = this._flowCtrl.needsRefill(flowId);
+            logger$$.debug('maybe_emit_credit_check', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                remaining_credits: remainingCredits,
+                low_watermark: this._flowCtrl instanceof FlowController
+                    ? this._flowCtrl.lowWatermark
+                    : null,
+                initial_window: this._initialWindow,
+                needs_refill: needsRefill,
+            });
+            if (!needsRefill) {
                 return;
             }
             const delta = this._initialWindow;
             this._flowCtrl.addCredits(flowId, delta);
+            logger$$.debug('maybe_emit_credit_emit', {
+                connector_id: this._connectorFlowId,
+                flow_id: flowId,
+                trace_id: traceId ?? null,
+                emitted_credits: delta,
+                post_emit_balance: this._flowCtrl.getCredits(flowId),
+            });
             const ackEnv = createFameEnvelope({
                 ...(traceId && { traceId }),
                 flowId,
@@ -24301,7 +24368,25 @@
                 },
                 flags: FlowFlags.ACK,
             });
-            await this.send(ackEnv);
+            try {
+                await this.send(ackEnv);
+                logger$$.debug('maybe_emit_credit_sent', {
+                    connector_id: this._connectorFlowId,
+                    flow_id: flowId,
+                    trace_id: traceId ?? null,
+                    credits_acknowledged: delta,
+                });
+            }
+            catch (error) {
+                logger$$.error('maybe_emit_credit_send_failed', {
+                    connector_id: this._connectorFlowId,
+                    flow_id: flowId,
+                    trace_id: traceId ?? null,
+                    credits_attempted: delta,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                throw error;
+            }
         }
         // ---------------------------------------------------------------------
         // Shutdown Management
@@ -24517,15 +24602,30 @@
             }
             return null;
         }
+        static normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        static normalizeTargetNodeId(value) {
+            if (typeof value !== 'string') {
+                return undefined;
+            }
+            const trimmed = value.trim();
+            if (trimmed.length === 0) {
+                return undefined;
+            }
+            if (trimmed === '*') {
+                return '*';
+            }
+            return trimmed;
+        }
         constructor(config, baseConfig = {}) {
             ensureBroadcastEnvironment();
             super(baseConfig);
             this.listenerRegistered = false;
-            this.seenAckKeys = new Map();
-            this.seenAckOrder = [];
-            this.ackDedupTtlMs = 30000;
-            this.ackDedupMaxEntries = 4096;
-            this.textDecoder = new TextDecoder();
             this.visibilityChangeListenerRegistered = false;
             this.channelName =
                 typeof config.channelName === 'string' && config.channelName.trim().length > 0
@@ -24537,11 +24637,20 @@
                 ? Math.floor(config.inboxCapacity)
                 : DEFAULT_INBOX_CAPACITY$7;
             this.inbox = new BoundedAsyncQueue(preferredCapacity);
+            this.inboxCapacity = preferredCapacity;
             this.connectorId = BroadcastChannelConnector.generateConnectorId();
+            const normalizedLocalNodeId = BroadcastChannelConnector.normalizeNodeId(config.localNodeId);
+            if (!normalizedLocalNodeId) {
+                throw new Error('BroadcastChannelConnector requires a non-empty localNodeId');
+            }
+            this.localNodeId = normalizedLocalNodeId;
+            this.targetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(config.initialTargetNodeId);
             this.channel = new BroadcastChannel(this.channelName);
             logger$_.debug('broadcast_channel_connector_created', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId ?? null,
                 inbox_capacity: preferredCapacity,
                 timestamp: new Date().toISOString(),
             });
@@ -24563,15 +24672,32 @@
                         ? message.constructor?.name ?? typeof message
                         : typeof message,
                     has_sender_id: Boolean(message?.senderId),
+                    has_sender_node_id: Boolean(message?.senderNodeId),
                 });
                 if (!message || typeof message !== 'object') {
                     return;
                 }
                 const busMessage = message;
-                if (typeof busMessage.senderId !== 'string' || busMessage.senderId.length === 0) {
+                const senderNodeId = BroadcastChannelConnector.normalizeNodeId(busMessage.senderNodeId);
+                if (!senderNodeId) {
+                    logger$_.debug('broadcast_channel_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'missing_sender_node_id',
+                    });
+                    return;
+                }
+                if (senderNodeId === this.localNodeId) {
+                    logger$_.debug('broadcast_channel_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'self_echo',
+                        sender_node_id: senderNodeId,
+                    });
                     return;
                 }
-                if (busMessage.senderId === this.connectorId) {
+                const incomingTargetNodeId = BroadcastChannelConnector.normalizeTargetNodeId(busMessage.targetNodeId);
+                if (!this._shouldAcceptMessageFromBus(senderNodeId, incomingTargetNodeId)) {
                     return;
                 }
                 const payload = BroadcastChannelConnector.coercePayload(busMessage.payload);
@@ -24585,26 +24711,37 @@
                 }
                 logger$_.debug('broadcast_channel_message_received', {
                     channel: this.channelName,
-                    sender_id: busMessage.senderId,
+                    sender_id: message?.senderId,
+                    sender_node_id: senderNodeId,
+                    target_node_id: incomingTargetNodeId ?? null,
                     connector_id: this.connectorId,
                     payload_length: payload.byteLength,
                 });
-                if (this._shouldSkipDuplicateAck(busMessage.senderId, payload)) {
-                    return;
-                }
                 try {
                     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 {
@@ -24615,8 +24752,10 @@
                     }
                 }
             };
-            this.channel.addEventListener('message', this.onMsg);
-            this.listenerRegistered = true;
+            if (!config.passive) {
+                this.channel.addEventListener('message', this.onMsg);
+                this.listenerRegistered = true;
+            }
             // Setup visibility change monitoring
             this.visibilityChangeHandler = () => {
                 const isHidden = document.hidden;
@@ -24681,22 +24820,29 @@
         }
         async pushToReceive(rawOrEnvelope) {
             const item = this._normalizeInboxItem(rawOrEnvelope);
-            if (this._shouldSkipDuplicateAckFromInboxItem(item)) {
-                return;
-            }
             try {
                 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;
                 }
@@ -24709,17 +24855,26 @@
         }
         async _transportSendBytes(data) {
             ensureBroadcastEnvironment();
+            const targetNodeId = this.targetNodeId ?? '*';
             logger$_.debug('broadcast_channel_message_sending', {
                 channel: this.channelName,
                 sender_id: this.connectorId,
+                sender_node_id: this.localNodeId,
+                target_node_id: targetNodeId,
             });
             this.channel.postMessage({
                 senderId: this.connectorId,
+                senderNodeId: this.localNodeId,
+                targetNodeId,
                 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', {
@@ -24764,8 +24919,6 @@
             const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
             const shutdownError = new FameTransportClose(closeReason, closeCode);
             this.inbox.drain(shutdownError);
-            this.seenAckKeys.clear();
-            this.seenAckOrder.length = 0;
         }
         _normalizeInboxItem(rawOrEnvelope) {
             if (rawOrEnvelope instanceof Uint8Array) {
@@ -24773,78 +24926,74 @@
             }
             return rawOrEnvelope;
         }
-        _shouldSkipDuplicateAck(senderId, payload) {
-            const dedupKey = this._extractAckDedupKey(payload);
-            if (!dedupKey) {
-                return false;
-            }
-            const normalizedSenderId = typeof senderId === 'string' && senderId.length > 0
-                ? senderId
-                : undefined;
-            return this._checkDuplicateAck(dedupKey, normalizedSenderId);
+        _isWildcardTarget() {
+            return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
         }
-        _shouldSkipDuplicateAckFromInboxItem(item) {
-            if (item instanceof Uint8Array) {
-                return this._shouldSkipDuplicateAck(undefined, item);
-            }
-            const envelope = this._extractEnvelopeFromInboxItem(item);
-            if (!envelope) {
-                return false;
-            }
-            const frame = envelope.frame;
-            if (!frame || frame.type !== 'DeliveryAck') {
-                return false;
+        _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
+            if (this._isWildcardTarget()) {
+                if (targetNodeId &&
+                    targetNodeId !== '*' &&
+                    targetNodeId !== this.localNodeId) {
+                    logger$_.debug('broadcast_channel_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'wildcard_target_mismatch',
+                        sender_node_id: senderNodeId,
+                        target_node_id: targetNodeId,
+                        local_node_id: this.localNodeId,
+                    });
+                    return false;
+                }
+                return true;
             }
-            const refId = typeof frame.refId === 'string' && frame.refId.length > 0
-                ? frame.refId
-                : null;
-            const dedupKey = refId ?? envelope.id ?? null;
-            if (!dedupKey) {
+            const expectedSender = this.targetNodeId;
+            if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+                logger$_.debug('broadcast_channel_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'unexpected_sender',
+                    expected_sender_node_id: expectedSender,
+                    sender_node_id: senderNodeId,
+                    local_node_id: this.localNodeId,
+                });
                 return false;
             }
-            const senderId = this._extractSenderIdFromInboxItem(item);
-            return this._checkDuplicateAck(dedupKey, senderId);
-        }
-        _checkDuplicateAck(dedupKey, senderId) {
-            const now = Date.now();
-            const lastSeen = this.seenAckKeys.get(dedupKey);
-            if (lastSeen && now - lastSeen < this.ackDedupTtlMs) {
-                logger$_.debug('broadcast_channel_duplicate_ack_suppressed', {
+            if (targetNodeId &&
+                targetNodeId !== '*' &&
+                targetNodeId !== this.localNodeId) {
+                logger$_.debug('broadcast_channel_message_rejected', {
                     channel: this.channelName,
                     connector_id: this.connectorId,
-                    sender_id: senderId ?? null,
-                    dedup_key: dedupKey,
+                    reason: 'unexpected_target',
+                    sender_node_id: senderNodeId,
+                    target_node_id: targetNodeId,
+                    local_node_id: this.localNodeId,
                 });
-                return true;
+                return false;
             }
-            this.seenAckKeys.set(dedupKey, now);
-            this.seenAckOrder.push(dedupKey);
-            this._trimSeenAcks(now);
-            return false;
+            return true;
         }
-        _extractEnvelopeFromInboxItem(item) {
-            if (!item || typeof item !== 'object') {
-                return null;
+        _describeInboxItem(item) {
+            if (item instanceof Uint8Array) {
+                return 'bytes';
             }
-            if ('envelope' in item) {
-                return item.envelope;
+            if (item.envelope) {
+                return 'channel_message';
             }
-            if ('frame' in item) {
-                return item;
+            if (item.frame) {
+                return 'envelope';
             }
-            return null;
+            return 'unknown';
         }
-        _extractSenderIdFromInboxItem(item) {
-            if (!item || typeof item !== 'object') {
-                return undefined;
-            }
-            if ('context' in item) {
-                const context = item.context;
-                if (context && typeof context.fromSystemId === 'string') {
-                    return context.fromSystemId;
-                }
-            }
-            return undefined;
+        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,
+            });
         }
         /**
          * Override start() to check initial visibility state
@@ -24871,46 +25020,33 @@
                 });
             }
         }
-        _trimSeenAcks(now) {
-            while (this.seenAckOrder.length > 0) {
-                const candidate = this.seenAckOrder[0];
-                const timestamp = this.seenAckKeys.get(candidate);
-                if (timestamp === undefined) {
-                    this.seenAckOrder.shift();
-                    continue;
-                }
-                if (this.seenAckKeys.size > this.ackDedupMaxEntries ||
-                    now - timestamp > this.ackDedupTtlMs) {
-                    this.seenAckKeys.delete(candidate);
-                    this.seenAckOrder.shift();
-                    continue;
-                }
-                break;
-            }
-        }
-        _extractAckDedupKey(payload) {
-            try {
-                const decoded = this.textDecoder.decode(payload);
-                const parsed = JSON.parse(decoded);
-                const envelopeId = typeof parsed?.id === 'string' ? parsed.id : null;
-                const frameType = parsed?.frame?.type;
-                if (typeof frameType !== 'string' || frameType !== 'DeliveryAck') {
-                    return null;
-                }
-                const refId = parsed.frame?.refId;
-                if (typeof refId === 'string' && refId.length > 0) {
-                    return refId;
-                }
-                return envelopeId;
+        setTargetNodeId(nodeId) {
+            const normalized = BroadcastChannelConnector.normalizeNodeId(nodeId);
+            if (!normalized) {
+                throw new Error('BroadcastChannelConnector target node id must be a non-empty string');
             }
-            catch (error) {
-                logger$_.debug('broadcast_channel_ack_dedup_parse_failed', {
-                    channel: this.channelName,
-                    connector_id: this.connectorId,
-                    error: error instanceof Error ? error.message : String(error),
-                });
-                return null;
+            if (normalized === '*') {
+                this.setWildcardTarget();
+                return;
             }
+            this.targetNodeId = normalized;
+            logger$_.debug('broadcast_channel_target_updated', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId,
+                target_mode: 'direct',
+            });
+        }
+        setWildcardTarget() {
+            this.targetNodeId = '*';
+            logger$_.debug('broadcast_channel_target_updated', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId,
+                target_mode: 'wildcard',
+            });
         }
     };
 
@@ -25019,6 +25155,15 @@
             }
             result.inboxCapacity = Math.floor(inboxValue);
         }
+        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.initialWindow = Math.floor(windowValue);
+        }
         return result;
     }
     function broadcastChannelGrantToConnectorConfig(grant) {
@@ -25032,6 +25177,9 @@
         if (normalized.inboxCapacity !== undefined) {
             config.inboxCapacity = normalized.inboxCapacity;
         }
+        if (normalized.initialWindow !== undefined) {
+            config.initialWindow = normalized.initialWindow;
+        }
         return config;
     }
 
@@ -25303,6 +25451,20 @@
         waitEvent(event, signal) {
             return signal ? event.wait({ signal }) : event.wait();
         }
+        _getLocalNodeId() {
+            const normalized = this._normalizeNodeId(this.node.id);
+            if (!normalized) {
+                throw new Error('UpstreamSessionManager requires node with a stable identifier');
+            }
+            return normalized;
+        }
+        _normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
         async connectCycle() {
             if (!this.admissionClient) {
                 throw new FameConnectError('Admission client is required to attach upstream');
@@ -25324,6 +25486,8 @@
             await this.onWelcome(welcome.frame);
             const connector = await ConnectorFactory.createConnector(grant, {
                 systemId: welcome.frame.systemId,
+                localNodeId: this._getLocalNodeId(),
+                initialTargetNodeId: '*',
             });
             await connector.start(this.wrappedHandler);
             this.connector = connector;
@@ -25349,6 +25513,20 @@
             }
             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) {
+                const targetAware = connector;
+                if (typeof targetAware.setTargetNodeId === 'function') {
+                    try {
+                        targetAware.setTargetNodeId(this.targetSystemId);
+                    }
+                    catch (error) {
+                        logger$Z.warning('broadcast_channel_target_apply_failed', {
+                            error: error instanceof Error ? error.message : String(error),
+                            target_node_id: this.targetSystemId,
+                        });
+                    }
+                }
+            }
             await this.onAttach(attachInfo, connector);
             // Close the admission client immediately after attach completes
             // This releases HTTP keep-alive connections (Node.js fetch/undici requires explicit cleanup)
@@ -25411,7 +25589,7 @@
                 this.currentStopSubtasks = null;
                 await Promise.allSettled(tasks.map((task) => task.promise));
                 if (this.connector) {
-                    logger$Z.info('upstream_stopping_old_connector', {
+                    logger$Z.debug('upstream_stopping_old_connector', {
                         connect_epoch: this.connectEpoch,
                         target_system_id: this.targetSystemId,
                         timestamp: new Date().toISOString(),
@@ -25422,7 +25600,7 @@
                             error: err instanceof Error ? err.message : String(err),
                         });
                     });
-                    logger$Z.info('upstream_old_connector_stopped', {
+                    logger$Z.debug('upstream_old_connector_stopped', {
                         connect_epoch: this.connectEpoch,
                         target_system_id: this.targetSystemId,
                         timestamp: new Date().toISOString(),
@@ -25624,8 +25802,15 @@
                 if (!envelope) {
                     continue;
                 }
+                logger$Z.debug('upstream_pump_sending_envelope', {
+                    envelopeId: envelope.id,
+                    type: envelope.frame?.type,
+                });
                 try {
                     await connector.send(envelope);
+                    logger$Z.debug('upstream_pump_sent_envelope', {
+                        envelopeId: envelope.id,
+                    });
                 }
                 catch (error) {
                     if (error instanceof FameMessageTooLarge) {
@@ -34846,10 +35031,31 @@
             }
             return null;
         }
+        static normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        static normalizeTargetNodeId(value) {
+            if (typeof value !== 'string') {
+                return undefined;
+            }
+            const trimmed = value.trim();
+            if (trimmed.length === 0) {
+                return undefined;
+            }
+            if (trimmed === '*') {
+                return '*';
+            }
+            return trimmed;
+        }
         constructor(config, baseConfig = {}) {
             ensureBrowserEnvironment$2();
             super(baseConfig);
             this.listenerRegistered = false;
+            this.visibilityChangeListenerRegistered = false;
             this.channelName =
                 typeof config.channelName === 'string' && config.channelName.trim().length > 0
                     ? config.channelName.trim()
@@ -34860,41 +35066,68 @@
                 ? Math.floor(config.inboxCapacity)
                 : DEFAULT_INBOX_CAPACITY$6;
             this.inbox = new BoundedAsyncQueue(preferredCapacity);
+            this.inboxCapacity = preferredCapacity;
             this.connectorId = InPageConnector.generateConnectorId();
+            const normalizedLocalNodeId = InPageConnector.normalizeNodeId(config.localNodeId);
+            if (!normalizedLocalNodeId) {
+                throw new Error('InPageConnector requires a non-empty localNodeId');
+            }
+            this.localNodeId = normalizedLocalNodeId;
+            this.targetNodeId = InPageConnector.normalizeTargetNodeId(config.initialTargetNodeId);
             logger$G.debug('inpage_connector_initialized', {
                 channel: this.channelName,
                 connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId ?? null,
+                inbox_capacity: preferredCapacity,
             });
             this.onMsg = (event) => {
+                if (!this.listenerRegistered) {
+                    logger$G.warning('inpage_message_after_unregister', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        timestamp: new Date().toISOString(),
+                    });
+                    return;
+                }
                 const messageEvent = event;
                 const message = messageEvent.data;
                 logger$G.debug('inpage_raw_event', {
                     channel: this.channelName,
                     connector_id: this.connectorId,
-                    message_type: message && typeof message === 'object' ? message.constructor?.name ?? typeof message : typeof message,
-                    has_sender_id: Boolean(message?.senderId),
-                    payload_type: message && typeof message === 'object'
-                        ? message?.payload instanceof Uint8Array
-                            ? 'Uint8Array'
-                            : message?.payload instanceof ArrayBuffer
-                                ? 'ArrayBuffer'
-                                : typeof message?.payload
+                    message_type: message && typeof message === 'object'
+                        ? message.constructor?.name ?? typeof message
                         : typeof message,
-                    payload_constructor: message && typeof message === 'object'
-                        ? message?.payload?.constructor?.name
-                        : undefined,
-                    payload_keys: message && typeof message === 'object' && message?.payload && typeof message?.payload === 'object'
-                        ? Object.keys(message.payload).slice(0, 5)
-                        : undefined,
+                    has_sender_id: Boolean(message?.senderId),
+                    has_sender_node_id: Boolean(message?.senderNodeId),
                 });
                 if (!message || typeof message !== 'object') {
                     return;
                 }
                 const busMessage = message;
-                if (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);
+                if (!senderId || !senderNodeId) {
+                    logger$G.debug('inpage_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'missing_sender_metadata',
+                    });
+                    return;
+                }
+                if (senderId === this.connectorId || senderNodeId === this.localNodeId) {
+                    logger$G.debug('inpage_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'self_echo',
+                        sender_node_id: senderNodeId,
+                    });
                     return;
                 }
-                if (busMessage.senderId === this.connectorId) {
+                const incomingTargetNodeId = InPageConnector.normalizeTargetNodeId(busMessage.targetNodeId);
+                if (!this._shouldAcceptMessageFromBus(senderNodeId, incomingTargetNodeId)) {
                     return;
                 }
                 const payload = InPageConnector.coercePayload(busMessage.payload);
@@ -34908,7 +35141,9 @@
                 }
                 logger$G.debug('inpage_message_received', {
                     channel: this.channelName,
-                    sender_id: busMessage.senderId,
+                    sender_id: senderId,
+                    sender_node_id: senderNodeId,
+                    target_node_id: incomingTargetNodeId ?? null,
                     connector_id: this.connectorId,
                     payload_length: payload.byteLength,
                 });
@@ -34916,15 +35151,27 @@
                     if (typeof this.inbox.tryEnqueue === 'function') {
                         const accepted = this.inbox.tryEnqueue(payload);
                         if (accepted) {
+                            this.logInboxSnapshot('inpage_inbox_enqueued', {
+                                source: 'listener',
+                                enqueue_strategy: 'try',
+                                payload_length: payload.byteLength,
+                            });
                             return;
                         }
                     }
                     this.inbox.enqueue(payload);
+                    this.logInboxSnapshot('inpage_inbox_enqueued', {
+                        source: 'listener',
+                        enqueue_strategy: 'enqueue',
+                        payload_length: payload.byteLength,
+                    });
                 }
                 catch (error) {
                     if (error instanceof QueueFullError) {
                         logger$G.warning('inpage_receive_queue_full', {
                             channel: this.channelName,
+                            inbox_capacity: this.inboxCapacity,
+                            inbox_remaining_capacity: this.inbox.remainingCapacity,
                         });
                     }
                     else {
@@ -34937,6 +35184,92 @@
             };
             getSharedBus$1().addEventListener(this.channelName, this.onMsg);
             this.listenerRegistered = true;
+            // Setup visibility change monitoring
+            this.visibilityChangeHandler = () => {
+                const isHidden = document.hidden;
+                logger$G.debug('inpage_visibility_changed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    visibility: isHidden ? 'hidden' : 'visible',
+                    timestamp: new Date().toISOString(),
+                });
+                // Pause/resume connector based on visibility
+                if (isHidden && this.state === ConnectorState.STARTED) {
+                    this.pause().catch((err) => {
+                        logger$G.warning('inpage_pause_failed', {
+                            channel: this.channelName,
+                            connector_id: this.connectorId,
+                            error: err instanceof Error ? err.message : String(err),
+                        });
+                    });
+                }
+                else if (!isHidden && this.state === ConnectorState.PAUSED) {
+                    this.resume().catch((err) => {
+                        logger$G.warning('inpage_resume_failed', {
+                            channel: this.channelName,
+                            connector_id: this.connectorId,
+                            error: err instanceof Error ? err.message : String(err),
+                        });
+                    });
+                }
+            };
+            if (typeof document !== 'undefined') {
+                document.addEventListener('visibilitychange', this.visibilityChangeHandler);
+                this.visibilityChangeListenerRegistered = true;
+                // Track page lifecycle events to detect browser unload/discard
+                if (typeof window !== 'undefined') {
+                    const lifecycleLogger = (event) => {
+                        logger$G.info('inpage_page_lifecycle', {
+                            channel: this.channelName,
+                            connector_id: this.connectorId,
+                            event_type: event.type,
+                            visibility_state: document.visibilityState,
+                            timestamp: new Date().toISOString(),
+                        });
+                    };
+                    window.addEventListener('beforeunload', lifecycleLogger);
+                    window.addEventListener('unload', lifecycleLogger);
+                    window.addEventListener('pagehide', lifecycleLogger);
+                    window.addEventListener('pageshow', lifecycleLogger);
+                    document.addEventListener('freeze', lifecycleLogger);
+                    document.addEventListener('resume', lifecycleLogger);
+                }
+                // Log initial state with detailed visibility info
+                logger$G.debug('inpage_initial_visibility', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    visibility: document.hidden ? 'hidden' : 'visible',
+                    document_hidden: document.hidden,
+                    visibility_state: document.visibilityState,
+                    has_focus: document.hasFocus(),
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+        /**
+         * Override start() to check initial visibility state
+         */
+        async start(inboundHandler) {
+            await super.start(inboundHandler);
+            // After transitioning to STARTED, check if tab is already hidden
+            if (typeof document !== 'undefined' && document.hidden) {
+                logger$G.debug('inpage_start_in_hidden_tab', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    document_hidden: document.hidden,
+                    visibility_state: document.visibilityState,
+                    has_focus: document.hasFocus(),
+                    timestamp: new Date().toISOString(),
+                });
+                // Immediately pause if tab is hidden at start time
+                await this.pause().catch((err) => {
+                    logger$G.warning('inpage_initial_pause_failed', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
         }
         // Allow listeners to feed envelopes directly into the in-page receive queue.
         async pushToReceive(rawOrEnvelope) {
@@ -34945,15 +35278,25 @@
                 if (typeof this.inbox.tryEnqueue === 'function') {
                     const accepted = this.inbox.tryEnqueue(item);
                     if (accepted) {
+                        this.logInboxSnapshot('inpage_push_enqueued', {
+                            enqueue_strategy: 'try',
+                            item_type: this._describeInboxItem(item),
+                        });
                         return;
                     }
                 }
                 this.inbox.enqueue(item);
+                this.logInboxSnapshot('inpage_push_enqueued', {
+                    enqueue_strategy: 'enqueue',
+                    item_type: this._describeInboxItem(item),
+                });
             }
             catch (error) {
                 if (error instanceof QueueFullError) {
                     logger$G.warning('inpage_push_queue_full', {
                         channel: this.channelName,
+                        inbox_capacity: this.inboxCapacity,
+                        inbox_remaining_capacity: this.inbox.remainingCapacity,
                     });
                     throw error;
                 }
@@ -34966,25 +35309,57 @@
         }
         async _transportSendBytes(data) {
             ensureBrowserEnvironment$2();
+            const targetNodeId = this.targetNodeId ?? '*';
             logger$G.debug('inpage_message_sending', {
                 channel: this.channelName,
                 sender_id: this.connectorId,
+                sender_node_id: this.localNodeId,
+                target_node_id: targetNodeId,
             });
             const event = new MessageEvent(this.channelName, {
                 data: {
                     senderId: this.connectorId,
+                    senderNodeId: this.localNodeId,
+                    targetNodeId,
                     payload: data,
                 },
             });
             getSharedBus$1().dispatchEvent(event);
         }
         async _transportReceive() {
-            return await this.inbox.dequeue();
+            const item = await this.inbox.dequeue();
+            this.logInboxSnapshot('inpage_inbox_dequeued', {
+                item_type: this._describeInboxItem(item),
+            });
+            return item;
         }
         async _transportClose(code, reason) {
+            logger$G.debug('inpage_transport_closing', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                code,
+                reason,
+                listener_registered: this.listenerRegistered,
+                timestamp: new Date().toISOString(),
+            });
             if (this.listenerRegistered) {
+                logger$G.debug('inpage_removing_listener', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    timestamp: new Date().toISOString(),
+                });
                 getSharedBus$1().removeEventListener(this.channelName, this.onMsg);
                 this.listenerRegistered = false;
+                logger$G.debug('inpage_listener_removed', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+            if (this.visibilityChangeListenerRegistered && this.visibilityChangeHandler && typeof document !== 'undefined') {
+                document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+                this.visibilityChangeListenerRegistered = false;
+                this.visibilityChangeHandler = undefined;
             }
             const closeCode = typeof code === 'number' ? code : 1000;
             const closeReason = typeof reason === 'string' && reason.length > 0 ? reason : 'closed';
@@ -34997,6 +35372,103 @@
             }
             return rawOrEnvelope;
         }
+        _isWildcardTarget() {
+            return this.targetNodeId === '*' || typeof this.targetNodeId === 'undefined';
+        }
+        _shouldAcceptMessageFromBus(senderNodeId, targetNodeId) {
+            if (this._isWildcardTarget()) {
+                if (targetNodeId &&
+                    targetNodeId !== '*' &&
+                    targetNodeId !== this.localNodeId) {
+                    logger$G.debug('inpage_message_rejected', {
+                        channel: this.channelName,
+                        connector_id: this.connectorId,
+                        reason: 'wildcard_target_mismatch',
+                        sender_node_id: senderNodeId,
+                        target_node_id: targetNodeId,
+                        local_node_id: this.localNodeId,
+                    });
+                    return false;
+                }
+                return true;
+            }
+            const expectedSender = this.targetNodeId;
+            if (expectedSender && expectedSender !== '*' && senderNodeId !== expectedSender) {
+                logger$G.debug('inpage_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'unexpected_sender',
+                    expected_sender_node_id: expectedSender,
+                    sender_node_id: senderNodeId,
+                    local_node_id: this.localNodeId,
+                });
+                return false;
+            }
+            if (targetNodeId &&
+                targetNodeId !== '*' &&
+                targetNodeId !== this.localNodeId) {
+                logger$G.debug('inpage_message_rejected', {
+                    channel: this.channelName,
+                    connector_id: this.connectorId,
+                    reason: 'unexpected_target',
+                    sender_node_id: senderNodeId,
+                    target_node_id: targetNodeId,
+                    local_node_id: this.localNodeId,
+                });
+                return false;
+            }
+            return true;
+        }
+        _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$G.debug(event, {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                connector_state: this.state,
+                inbox_capacity: this.inboxCapacity,
+                inbox_remaining_capacity: this.inbox.remainingCapacity,
+                ...extra,
+            });
+        }
+        setTargetNodeId(nodeId) {
+            const normalized = InPageConnector.normalizeNodeId(nodeId);
+            if (!normalized) {
+                throw new Error('InPageConnector target node id must be a non-empty string');
+            }
+            if (normalized === '*') {
+                this.setWildcardTarget();
+                return;
+            }
+            this.targetNodeId = normalized;
+            logger$G.debug('inpage_target_updated', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId,
+                target_mode: 'direct',
+            });
+        }
+        setWildcardTarget() {
+            this.targetNodeId = '*';
+            logger$G.debug('inpage_target_updated', {
+                channel: this.channelName,
+                connector_id: this.connectorId,
+                local_node_id: this.localNodeId,
+                target_node_id: this.targetNodeId,
+                target_mode: 'wildcard',
+            });
+        }
     }
 
     const RPC_REGISTRY = Symbol('naylence.rpc.registry');
@@ -42424,8 +42896,16 @@
             }
             const normalized = this._normalizeConfig(config);
             const options = (factoryArgs[0] ?? {});
+            const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+            const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+            if (!localNodeId) {
+                throw new Error('InPageConnectorFactory requires a localNodeId from config or create() options');
+            }
             const channelName = normalized.channelName ?? DEFAULT_CHANNEL$5;
             const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$5;
+            const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+            const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+            const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
             const baseConfig = {
                 drainTimeout: normalized.drainTimeout,
                 flowControl: normalized.flowControl,
@@ -42440,6 +42920,8 @@
                 type: INPAGE_CONNECTOR_TYPE,
                 channelName,
                 inboxCapacity,
+                localNodeId,
+                initialTargetNodeId: resolvedTarget,
             };
             const connector = new InPageConnector(connectorConfig, baseConfig);
             if (options.authorization) {
@@ -42475,6 +42957,16 @@
                 capacity > 0) {
                 normalized.inboxCapacity = Math.floor(capacity);
             }
+            const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+            const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+            if (normalizedLocalNodeId) {
+                normalized.localNodeId = normalizedLocalNodeId;
+            }
+            const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
+            const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+            if (normalizedTarget) {
+                normalized.initialTargetNodeId = normalizedTarget;
+            }
             if (typeof candidate.flowControl === 'boolean') {
                 normalized.flowControl = candidate.flowControl;
             }
@@ -42513,6 +43005,22 @@
                 normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$5;
             return normalized;
         }
+        _normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        _normalizeTargetNodeId(value) {
+            if (value === undefined || value === null) {
+                return undefined;
+            }
+            if (value === '*') {
+                return '*';
+            }
+            return this._normalizeNodeId(value) ?? undefined;
+        }
     }
 
     var inpageConnectorFactory = /*#__PURE__*/Object.freeze({
@@ -42558,6 +43066,7 @@
                     type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                     channelName: connectorConfig.channelName,
                     inboxCapacity: connectorConfig.inboxCapacity,
+                    initialWindow: connectorConfig.initialWindow,
                 };
             }
             const config = {
@@ -42582,6 +43091,7 @@
                 purpose: 'connection',
                 channelName: normalizedConfig.channelName,
                 inboxCapacity: normalizedConfig.inboxCapacity,
+                initialWindow: normalizedConfig.initialWindow,
             });
             return grant;
         }
@@ -42591,8 +43101,16 @@
             }
             const normalized = this._normalizeConfig(config);
             const options = (factoryArgs[0] ?? {});
+            const normalizedLocalNodeFromConfig = this._normalizeNodeId(normalized.localNodeId);
+            const localNodeId = this._normalizeNodeId(options.localNodeId) ?? normalizedLocalNodeFromConfig;
+            if (!localNodeId) {
+                throw new Error('BroadcastChannelConnectorFactory requires a localNodeId from config or create() options');
+            }
             const channelName = normalized.channelName ?? DEFAULT_CHANNEL$4;
             const inboxCapacity = normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$4;
+            const targetFromOptions = this._normalizeTargetNodeId(options.initialTargetNodeId);
+            const targetFromConfig = this._normalizeTargetNodeId(normalized.initialTargetNodeId);
+            const resolvedTarget = targetFromOptions ?? targetFromConfig ?? '*';
             const baseConfig = {
                 drainTimeout: normalized.drainTimeout,
                 flowControl: normalized.flowControl,
@@ -42607,6 +43125,8 @@
                 type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                 channelName,
                 inboxCapacity,
+                localNodeId,
+                initialTargetNodeId: resolvedTarget,
             };
             const connector = new BroadcastChannelConnector(connectorConfig, baseConfig);
             if (options.authorization) {
@@ -42630,11 +43150,21 @@
                 normalized.channelName = channel.trim();
             }
             const capacity = candidate.inboxCapacity ?? candidate['inbox_capacity'];
+            const initialTargetNodeId = candidate.initialTargetNodeId ?? candidate['initial_target_node_id'];
+            const normalizedTarget = this._normalizeTargetNodeId(initialTargetNodeId);
+            if (normalizedTarget) {
+                normalized.initialTargetNodeId = normalizedTarget;
+            }
             if (typeof capacity === 'number' &&
                 Number.isFinite(capacity) &&
                 capacity > 0) {
                 normalized.inboxCapacity = Math.floor(capacity);
             }
+            const localNodeId = candidate.localNodeId ?? candidate['local_node_id'];
+            const normalizedLocalNodeId = this._normalizeNodeId(localNodeId);
+            if (normalizedLocalNodeId) {
+                normalized.localNodeId = normalizedLocalNodeId;
+            }
             if (typeof candidate.flowControl === 'boolean') {
                 normalized.flowControl = candidate.flowControl;
             }
@@ -42673,6 +43203,22 @@
                 normalized.inboxCapacity ?? DEFAULT_INBOX_CAPACITY$4;
             return normalized;
         }
+        _normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        _normalizeTargetNodeId(value) {
+            if (value === undefined || value === null) {
+                return undefined;
+            }
+            if (value === '*') {
+                return '*';
+            }
+            return this._normalizeNodeId(value) ?? undefined;
+        }
     }
 
     var broadcastChannelConnectorFactory = /*#__PURE__*/Object.freeze({
@@ -43253,7 +43799,7 @@
                     node: routingNode,
                 });
                 const selection = defaultGrantSelectionPolicy.selectCallbackGrant(selectionContext);
-                connectorConfig = this._grantToConnectorConfig(selection.grant);
+                connectorConfig = this._buildConnectorConfigForSystem(systemId, this._grantToConnectorConfig(selection.grant));
             }
             catch (error) {
                 logger$p.debug('inpage_listener_grant_selection_failed', {
@@ -43261,13 +43807,13 @@
                     system_id: systemId,
                     error: error instanceof Error ? error.message : String(error),
                 });
-                connectorConfig =
-                    this._extractInPageConnectorConfig(frame) ??
-                        {
-                            type: INPAGE_CONNECTOR_TYPE,
-                            channelName: this._channelName,
-                            inboxCapacity: this._inboxCapacity,
-                        };
+                const fallbackConfig = this._extractInPageConnectorConfig(frame) ??
+                    {
+                        type: INPAGE_CONNECTOR_TYPE,
+                        channelName: this._channelName,
+                        inboxCapacity: this._inboxCapacity,
+                    };
+                connectorConfig = this._buildConnectorConfigForSystem(systemId, fallbackConfig);
             }
             try {
                 const connector = await routingNode.createOriginConnector({
@@ -43386,6 +43932,65 @@
                 typeof frame === 'object' &&
                 frame.type === 'NodeAttach');
         }
+        _buildConnectorConfigForSystem(systemId, baseConfig) {
+            const localNodeId = this._requireLocalNodeId();
+            const targetSystemId = this._normalizeNodeId(systemId);
+            if (!targetSystemId) {
+                throw new Error('InPageListener requires a valid system id for connector creation');
+            }
+            const candidate = baseConfig ?? null;
+            const channelCandidate = candidate && 'channelName' in candidate
+                ? candidate.channelName
+                : undefined;
+            const inboxCandidate = candidate && 'inboxCapacity' in candidate
+                ? candidate.inboxCapacity
+                : undefined;
+            const targetCandidate = candidate && 'initialTargetNodeId' in candidate
+                ? candidate.initialTargetNodeId
+                : undefined;
+            const channelName = typeof channelCandidate === 'string' && channelCandidate.trim().length > 0
+                ? channelCandidate.trim()
+                : this._channelName;
+            const inboxCapacity = typeof inboxCandidate === 'number' &&
+                Number.isFinite(inboxCandidate) &&
+                inboxCandidate > 0
+                ? Math.floor(inboxCandidate)
+                : this._inboxCapacity;
+            const normalizedTarget = this._normalizeTargetNodeId(targetCandidate);
+            return {
+                type: INPAGE_CONNECTOR_TYPE,
+                channelName,
+                inboxCapacity,
+                localNodeId,
+                initialTargetNodeId: normalizedTarget ?? targetSystemId,
+            };
+        }
+        _requireLocalNodeId() {
+            if (!this._routingNode) {
+                throw new Error('InPageListener requires routing node context');
+            }
+            const normalized = this._normalizeNodeId(this._routingNode.id);
+            if (!normalized) {
+                throw new Error('InPageListener requires routing node with a stable identifier');
+            }
+            return normalized;
+        }
+        _normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
+        }
+        _normalizeTargetNodeId(value) {
+            if (value === undefined || value === null) {
+                return undefined;
+            }
+            if (value === '*') {
+                return '*';
+            }
+            return this._normalizeNodeId(value) ?? undefined;
+        }
     }
     function getInPageListenerInstance() {
         return _lastInPageListenerInstance;
@@ -43776,7 +44381,7 @@
                     node: routingNode,
                 });
                 const selection = defaultGrantSelectionPolicy.selectCallbackGrant(selectionContext);
-                connectorConfig = this._grantToConnectorConfig(selection.grant);
+                connectorConfig = this._grantToConnectorConfig(selection.grant, systemId);
             }
             catch (error) {
                 logger$o.debug('broadcast_channel_listener_grant_selection_failed', {
@@ -43785,12 +44390,20 @@
                     error: error instanceof Error ? error.message : String(error),
                 });
                 connectorConfig =
-                    this._extractBroadcastConnectorConfig(frame) ??
-                        {
+                    this._extractBroadcastConnectorConfig(frame, systemId) ??
+                        this._buildConnectorConfigForSystem(systemId, {
                             type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
                             channelName: this._channelName,
                             inboxCapacity: this._inboxCapacity,
-                        };
+                            passive: true,
+                        });
+            }
+            if (!connectorConfig) {
+                logger$o.error('broadcast_channel_listener_missing_connector_config', {
+                    sender_id: params.senderId,
+                    system_id: systemId,
+                });
+                return null;
             }
             try {
                 const connector = await routingNode.createOriginConnector({
@@ -43816,7 +44429,7 @@
                 return null;
             }
         }
-        _extractBroadcastConnectorConfig(frame) {
+        _extractBroadcastConnectorConfig(frame, systemId) {
             const rawGrants = frame.callbackGrants;
             if (!Array.isArray(rawGrants)) {
                 return null;
@@ -43827,7 +44440,10 @@
                     (grant.type === BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE ||
                         grant.type === BROADCAST_CHANNEL_CONNECTOR_TYPE)) {
                     try {
-                        return this._grantToConnectorConfig(grant);
+                        if (grant.type === BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+                            return this._buildConnectorConfigForSystem(systemId, grant);
+                        }
+                        return this._buildConnectorConfigForSystem(systemId, broadcastChannelGrantToConnectorConfig(grant));
                     }
                     catch (error) {
                         logger$o.debug('broadcast_channel_listener_grant_normalization_failed', {
@@ -43838,30 +44454,86 @@
             }
             return null;
         }
-        _grantToConnectorConfig(grant) {
-            if (grant.type !== BROADCAST_CHANNEL_CONNECTOR_TYPE) {
-                if (grant.type === BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE) {
-                    return broadcastChannelGrantToConnectorConfig(grant);
+        _grantToConnectorConfig(grant, systemId) {
+            if (grant.type === BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+                return this._buildConnectorConfigForSystem(systemId, grant);
+            }
+            if (grant.type === BROADCAST_CHANNEL_CONNECTION_GRANT_TYPE) {
+                return this._buildConnectorConfigForSystem(systemId, broadcastChannelGrantToConnectorConfig(grant));
+            }
+            if ('toConnectorConfig' in grant &&
+                typeof grant.toConnectorConfig ===
+                    'function') {
+                const normalized = grant.toConnectorConfig();
+                if (normalized.type !== BROADCAST_CHANNEL_CONNECTOR_TYPE) {
+                    throw new Error(`Unsupported grant connector type: ${normalized.type}`);
                 }
-                throw new Error(`Unsupported grant type: ${grant.type}`);
+                return this._buildConnectorConfigForSystem(systemId, normalized);
             }
-            const candidate = grant;
-            const config = {
+            throw new Error(`Unsupported grant type: ${grant.type}`);
+        }
+        _buildConnectorConfigForSystem(systemId, baseConfig) {
+            const localNodeId = this._requireLocalNodeId();
+            const targetSystemId = this._normalizeNodeId(systemId);
+            if (!targetSystemId) {
+                throw new Error('BroadcastChannelListener requires a valid system id');
+            }
+            const candidate = baseConfig ?? null;
+            const channelCandidate = candidate && 'channelName' in candidate
+                ? candidate.channelName
+                : undefined;
+            const inboxCandidate = candidate && 'inboxCapacity' in candidate
+                ? candidate.inboxCapacity
+                : undefined;
+            const initialWindowCandidate = candidate && 'initialWindow' in candidate
+                ? candidate.initialWindow
+                : undefined;
+            const passiveCandidate = candidate && 'passive' in candidate
+                ? candidate.passive
+                : undefined;
+            const targetCandidate = candidate && 'initialTargetNodeId' in candidate
+                ? candidate.initialTargetNodeId
+                : undefined;
+            const channelName = typeof channelCandidate === 'string' && channelCandidate.trim().length > 0
+                ? channelCandidate.trim()
+                : this._channelName;
+            const inboxCapacity = typeof inboxCandidate === 'number' &&
+                Number.isFinite(inboxCandidate) &&
+                inboxCandidate > 0
+                ? Math.floor(inboxCandidate)
+                : this._inboxCapacity;
+            const initialWindow = typeof initialWindowCandidate === 'number' &&
+                Number.isFinite(initialWindowCandidate) &&
+                initialWindowCandidate > 0
+                ? Math.floor(initialWindowCandidate)
+                : undefined;
+            const initialTargetNodeId = this._normalizeNodeId(targetCandidate) ?? targetSystemId;
+            return {
                 type: BROADCAST_CHANNEL_CONNECTOR_TYPE,
-                channelName: this._channelName,
-                inboxCapacity: this._inboxCapacity,
+                channelName,
+                inboxCapacity,
+                passive: typeof passiveCandidate === 'boolean' ? passiveCandidate : true,
+                initialWindow,
+                localNodeId,
+                initialTargetNodeId,
             };
-            const channelCandidate = candidate.channelName ?? candidate['channel_name'];
-            if (typeof channelCandidate === 'string' && channelCandidate.trim().length > 0) {
-                config.channelName = channelCandidate.trim();
+        }
+        _requireLocalNodeId() {
+            if (!this._routingNode) {
+                throw new Error('BroadcastChannelListener requires routing node context');
             }
-            const inboxCandidate = candidate.inboxCapacity ?? candidate['inbox_capacity'];
-            if (typeof inboxCandidate === 'number' &&
-                Number.isFinite(inboxCandidate) &&
-                inboxCandidate > 0) {
-                config.inboxCapacity = Math.floor(inboxCandidate);
+            const normalized = this._normalizeNodeId(this._routingNode.id);
+            if (!normalized) {
+                throw new Error('BroadcastChannelListener requires routing node with a stable identifier');
             }
-            return config;
+            return normalized;
+        }
+        _normalizeNodeId(value) {
+            if (typeof value !== 'string') {
+                return null;
+            }
+            const trimmed = value.trim();
+            return trimmed.length > 0 ? trimmed : null;
         }
         _monitorConnectorLifecycle(senderId, systemId, connector) {
             const maybeClosable = connector;