@newrelic/browser-agent 1.320.1-rc.1 → 1.320.1-rc.2

package/dist/cjs/common/config/runtime.js

@@ -46,6 +46,8 @@ const RuntimeModel = {
   drainRegistry: new Map(),
   connector: undefined,
   harvester: undefined,
+  /** eagerly-created in configure() -- the v2 target representing the container (main) agent, see common/v2/utils#V2Target */
+  v2Target: undefined,
   isolatedBacklog: false,
   isRecording: false,
   // true when actively recording, false when paused or stopped

package/dist/cjs/common/constants/env.cdn.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.320.1-rc.1";
+const VERSION = exports.VERSION = "1.320.1-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.npm.js

@@ -17,7 +17,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.RRWEB_PACKAGE_NAME = exports.D
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.320.1-rc.1";
+const VERSION = exports.VERSION = "1.320.1-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/dom/selector-path.js

@@ -27,7 +27,7 @@ const analyzeElemPath = (elem, targetFields = [], agentRef) => {
     path: undefined,
     nearestFields: {},
     get targets() {
-      return targets.length ? targets : [undefined];
+      return targets.length ? targets : [agentRef.runtime.v2Target];
     },
     hasButton: false,
     hasLink: false

package/dist/cjs/common/session/session-entity.js

@@ -66,7 +66,7 @@ class SessionEntity {
     // key is intended to act as the k=v pair
     this.key = key;
     this.ee = agentRef.ee;
-    (0, _wrapEvents.wrapEvents)(this.ee);
+    (0, _wrapEvents.wrapEvents)(this.ee, agentRef);
     this.setup(opts);
 
     /**

package/dist/cjs/common/v2/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.V2_TYPES = void 0;
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @enum {string}
+ * @readonly
+ */
+const V2_TYPES = exports.V2_TYPES = {
+  /** Micro Frontend */
+  MFE: 'MFE',
+  /** Browser Application */
+  BA: 'BA'
+};

package/dist/cjs/common/v2/utils.js

@@ -3,7 +3,6 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.V2_TYPES = void 0;
 exports.dedupeRegisteredEntitiesByAsset = dedupeRegisteredEntitiesByAsset;
 exports.dedupeTargetsByInstance = dedupeTargetsByInstance;
 exports.findTargetsFromStackTrace = findTargetsFromStackTrace;
@@ -12,23 +11,31 @@ exports.getRegisteredTargetsFromFilename = getRegisteredTargetsFromFilename;
 exports.getRegisteredTargetsFromId = getRegisteredTargetsFromId;
 exports.getVersion2Attributes = getVersion2Attributes;
 exports.getVersion2DuplicationAttributes = getVersion2DuplicationAttributes;
+exports.isMfeTarget = isMfeTarget;
 exports.shouldDuplicate = shouldDuplicate;
 var _scriptTracker = require("./script-tracker");
+var _constants = require("./constants");
 /**
  * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
 /**
- * @enum {string}
- * @readonly
+ * @typedef {Object} V2Target
+ * @property {'BA'} type always V2_TYPES.BA -- identifies this as the container (main) agent, not a registered MFE
+ * @property {string} instance the container agent's agentIdentifier
+ * @property {string} [id] the container agent's entity guid, once known (getter, resolved asynchronously)
+ * @property {{[key:string]: any}} attributes the V2 payload attributes for the container agent (getter)
  */
-const V2_TYPES = exports.V2_TYPES = {
-  /** Micro Frontend */
-  MFE: 'MFE',
-  /** Browser Application */
-  BA: 'BA'
-};
+
+/**
+ * Determines if a given target represents a registered MFE (as opposed to the container agent).
+ * @param {*} target the target to check
+ * @returns {boolean} true if the target is a registered MFE target
+ */
+function isMfeTarget(target) {
+  return target?.type === _constants.V2_TYPES.MFE;
+}
 
 /**
  * Returns a single registered entity associated with a given iframe interface ID. Returns undefined if no entity is found.
@@ -124,14 +131,8 @@ function dedupeRegisteredEntitiesByAsset(entities) {
  */
 function getVersion2Attributes(target, aggregateInstance) {
   if (!supportsV2(aggregateInstance)) return {};
-  const containerAgentEntityGuid = aggregateInstance.agentRef.runtime.appMetadata.agents[0].entityGuid;
-  /** if there's no target, but we are in v2 mode, this means the data belongs to the container agent */
-  if (!target) {
-    return {
-      'entity.guid': containerAgentEntityGuid,
-      appId: aggregateInstance.agentRef.info.applicationID
-    };
-  }
+  /** if the target isn't a registered MFE, but we are in v2 mode, this means the data belongs to the container agent */
+  if (!isMfeTarget(target)) return aggregateInstance.agentRef.runtime.v2Target.attributes;
   /** otherwise, the data belongs to the target (MFE) and should be attributed as such */
   return target.attributes;
 }
@@ -161,16 +162,17 @@ function getVersion2DuplicationAttributes(target, aggregateInstance) {
  * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
  */
 function shouldDuplicate(target, aggregateInstance) {
-  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
+  return isMfeTarget(target) && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
 }
 
 /**
  * Finds the registered targets from the stack trace for a given agent reference.
  * @param {*} agentRef The agent reference to use for finding targets.
- * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
+ * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array containing the container target.
  */
 function findTargetsFromStackTrace(agentRef) {
-  if (!isValid(true, agentRef) || !agentRef?.runtime?.registeredEntities?.length) return [undefined];
+  if (!agentRef?.runtime) return [];
+  if (!isValid(true, agentRef) || !agentRef.runtime.registeredEntities?.length) return [agentRef.runtime.v2Target];
   const targets = [];
   try {
     var urls = (0, _scriptTracker.extractUrlsFromStack)((0, _scriptTracker.getDeepStackTrace)());
@@ -182,15 +184,15 @@ function findTargetsFromStackTrace(agentRef) {
     // Silent catch to prevent errors from propagating
   }
   const deduped = dedupeTargetsByInstance(targets);
-  if (!deduped.length) deduped.push(undefined); // if we can't find any targets from the stack trace, return an array with undefined to signify the container agent is the target
+  if (!deduped.length) deduped.push(agentRef.runtime.v2Target); // if we can't find any targets from the stack trace, the container agent is the target
   return deduped;
 }
 
 /**
  * Removes duplicate targets from an array, keyed by `target.instance`. This guards against the same canonical
  * target re-entering the array via multiple matched stack-frame URLs (e.g. a recursive call whose stack contains the
- * same file at multiple depths). Entries with no `instance` (i.e. `undefined`, meaning "the container agent")
- * naturally collapse to a single entry too, which is the desired behavior.
+ * same file at multiple depths). Multiple container-target entries (whose `instance` is the container agent's stable
+ * `agentIdentifier`) naturally collapse to a single entry too, which is the desired behavior.
  * @param {Array} targets
  * @returns {Array} deduped list of targets, preserving relative order of first occurrence
  */

package/dist/cjs/common/wrap/wrap-events.js

@@ -10,7 +10,7 @@ var _wrapFunction = require("./wrap-function");
 var _getOrSet = require("../util/get-or-set");
 var _runtime = require("../constants/runtime");
 /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -31,16 +31,17 @@ const flag = "nr@wrapped:".concat(_contextualEe.contextId);
  * `document` (if in a browser scope). Adds custom events in context of a new emitter scoped only to these methods.
  * @param {Object} sharedEE - The shared event emitter on which a new scoped
  *     event emitter will be based.
+ * @param {*} [agentRef] - The agent reference, used to attribute wrapped calls to the correct v2 target.
  * @returns {Object} Scoped event emitter with a debug ID of `events`.
  */
-function wrapEvents(sharedEE) {
+function wrapEvents(sharedEE, agentRef) {
   var ee = scopedEE(sharedEE);
 
   // Notice if our wrapping never ran yet, the falsy NaN will not early return; but if it has,
   // then we increment the count to track # of feats using this at runtime.
   if (wrapped[ee.debugId]++) return ee;
   wrapped[ee.debugId] = 1; // otherwise, first feature to wrap events
-  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee, true);
+  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee, true, agentRef);
 
   // Guard against instrumenting environments w/o necessary features
   if ('getPrototypeOf' in Object) {

package/dist/cjs/common/wrap/wrap-fetch.js

@@ -52,8 +52,8 @@ function wrapFetch(sharedEE, agentRef) {
   wrapPromiseMethod(_runtime.globalScope, 'fetch', prefix);
   ee.on(prefix + 'end', function (err, res, targets) {
     var ctx = this;
-    // undefined target reports to container
-    ctx.targets = targets || [undefined];
+    // default target reports to container
+    ctx.targets = targets || [agentRef.runtime.v2Target];
     if (res) {
       var size = res.headers.get('content-length');
       if (size !== null) {

package/dist/cjs/common/wrap/wrap-function.js

@@ -89,7 +89,7 @@ function createWrapperWithEmitter(emitter, always, agentRef) {
 
         // certain wrappers can inform the function wrapper to evaluate the stack of the executed wrapped function to find targets of the execution
         // (e.g. wrap-logger can inform this method to find try to find the MFE source of a console.log)
-        targets = evaluateStack ? (0, _utils.findTargetsFromStackTrace)(agentRef) : [undefined]; // undefined target always maps to the container agent
+        targets = evaluateStack ? (0, _utils.findTargetsFromStackTrace)(agentRef) : [agentRef?.runtime?.v2Target]; // default target always maps to the container agent
 
         if (typeof getContext === 'function') {
           ctx = getContext(args, originalThis);

package/dist/cjs/common/wrap/wrap-history.js

@@ -25,9 +25,10 @@ const HISTORY_FNS = ['pushState', 'replaceState'];
  * Wraps the `pushState` and `replaceState` methods of `window.history` and returns a corresponding event emitter
  * scoped to the history object.
  * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
+ * @param {*} [agentRef] - The agent reference, used to attribute wrapped calls to the correct v2 target.
  * @returns {Object} Scoped event emitter with a debug ID of `history`.
  */
-function wrapHistory(sharedEE) {
+function wrapHistory(sharedEE, agentRef) {
   const ee = scopedEE(sharedEE);
 
   // Notice if our wrapping never ran yet, the falsy NaN will not early return; but if it has,
@@ -36,7 +37,7 @@ function wrapHistory(sharedEE) {
   if (!_runtime.isBrowserScope || wrapped[ee.debugId]++) return ee;
   wrapped[ee.debugId] = 1; // otherwise, first feature to wrap history
 
-  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
+  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee, undefined, agentRef);
   /*
    * For objects that will be instantiated more than once, we wrap the object's prototype methods. The history object
    * is instantiated only once, so we can wrap its methods directly--and we must wrap the history methods directly as

package/dist/cjs/common/wrap/wrap-xhr.js

@@ -42,8 +42,8 @@ function wrapXhr(sharedEE, agentRef) {
   if (wrapped[ee.debugId]++) return ee;
   wrapped[ee.debugId] = 1; // otherwise, first feature to wrap XHR
 
-  (0, _wrapEvents.wrapEvents)(baseEE); // wrap-events patches XMLHttpRequest.prototype.addEventListener for us
-  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
+  (0, _wrapEvents.wrapEvents)(baseEE, agentRef); // wrap-events patches XMLHttpRequest.prototype.addEventListener for us
+  var wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee, undefined, agentRef);
   var OrigXHR = _runtime.globalScope.XMLHttpRequest;
   var MutationObserver = _runtime.globalScope.MutationObserver;
   var Promise = _runtime.globalScope.Promise;

package/dist/cjs/features/ajax/aggregate/index.js

@@ -126,7 +126,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (event.gql) this.reportSupportabilityMetric('Ajax/Events/GraphQL/Bytes-Added', (0, _stringify.stringify)(event.gql).length);
 
     /** make a copy of the event for the MFE target if it exists */
-    if (target) {
+    if ((0, _utils.isMfeTarget)(target)) {
       this.events.add({
         ...event,
         targetAttributes: (0, _utils.getVersion2Attributes)(target, this)

package/dist/cjs/features/generic_events/aggregate/index.js

@@ -262,7 +262,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
         this.addEvent(event, target);
       }, this.featureName, this.ee);
       if (agentRef.init.feature_flags.includes('websockets') || agentRef.init.web_sockets?.enabled) {
-        (0, _registerHandler.registerHandler)('ws-complete', (nrData, targets = [undefined]) => {
+        (0, _registerHandler.registerHandler)('ws-complete', (nrData, targets = [agentRef.runtime.v2Target]) => {
           targets.forEach(target => {
             const event = {
               ...nrData,

package/dist/cjs/features/generic_events/instrument/index.js

@@ -63,7 +63,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     if (_runtime.isBrowserScope) {
       (0, _wrapFetch.wrapFetch)(this.ee, agentRef);
       (0, _wrapXhr.wrapXhr)(this.ee, agentRef);
-      historyEE = (0, _wrapHistory.wrapHistory)(this.ee);
+      historyEE = (0, _wrapHistory.wrapHistory)(this.ee, agentRef);
       if (agentRef.init.user_actions.enabled) {
         _constants.OBSERVED_EVENTS.forEach(eventType => (0, _eventListenerOpts.windowAddEventListener)(eventType, evt => (0, _handle.handle)('ua', [evt], undefined, this.featureName, this.ee), true));
         _constants.OBSERVED_WINDOW_EVENTS.forEach(eventType => {

package/dist/cjs/features/jserrors/aggregate/index.js

@@ -210,7 +210,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
           if (targets.length) break;
         }
       }
-      if (!targets.length) targets.push(undefined);
+      if (!targets.length) targets.push(this.agentRef.runtime.v2Target);
     }
     return targets;
   }
@@ -254,7 +254,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     if (filterOutput?.group) params.errorGroup = filterOutput.group;
 
     // Should only decorate "hasReplay" for the container agent, so check if the target matches the config
-    if (hasReplay && !target) params.hasReplay = hasReplay;
+    if (hasReplay && !(0, _utils.isMfeTarget)(target)) params.hasReplay = hasReplay;
     /**
      * The bucketHash is different from the params.stackHash because the params.stackHash is based on the canonicalized
      * stack trace and is used downstream in NR1 to attempt to group the same errors across different browsers. However,
@@ -289,13 +289,13 @@ class Aggregate extends _aggregateBase.AggregateBase {
 
     // Trace sends the error in its payload, and both trace & replay simply listens for any error to occur.
     const jsErrorEvent = [type, bucketHash, params, newMetrics, customAttributes];
-    if (!target) (0, _handle.handle)('trace-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
+    if (!(0, _utils.isMfeTarget)(target)) (0, _handle.handle)('trace-jserror', jsErrorEvent, undefined, _features.FEATURE_NAMES.sessionTrace, this.ee);
     // still send EE events for other features such as above, but stop this one from aggregating internal data
     if (this.blocked) return;
     if (err.__newrelic?.socketId) {
       customAttributes.socketId = err.__newrelic.socketId;
     }
-    if (!target) {
+    if (!(0, _utils.isMfeTarget)(target)) {
       const softNavInUse = Boolean(this.agentRef.features?.[_features.FEATURE_NAMES.softNav]);
       if (softNavInUse) {
         // pass the error to soft nav for evaluation - it will return it via 'returnJserror' when interaction is resolved
@@ -306,7 +306,7 @@ class Aggregate extends _aggregateBase.AggregateBase {
     }
 
     // always add directly if scoped to a sub-entity, the other pathways above will be deterministic if the main agent should procede
-    if (target) this.#storeJserrorForHarvest(jsErrorEvent, {}, target);
+    if ((0, _utils.isMfeTarget)(target)) this.#storeJserrorForHarvest(jsErrorEvent, {}, target);
   }
 
   /**

package/dist/cjs/features/logging/instrument/index.js

@@ -36,7 +36,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     });
 
     /** emitted by wrap-logger function */
-    this.ee.on('wrap-logger-end', function handleLog([message], _, __, targets = []) {
+    this.ee.on('wrap-logger-end', function handleLog([message], _, __, targets = [agentRef.runtime.v2Target]) {
       const {
         level,
         customAttributes,

package/dist/cjs/features/session_trace/instrument/index.js

@@ -15,7 +15,7 @@ var _now = require("../../../common/timing/now");
 var _addToTrace = require("../../../loaders/api/addToTrace");
 var _finished = require("../../../loaders/api/finished");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 const {
@@ -42,8 +42,8 @@ class Instrument extends _instrumentBase.InstrumentBase {
       return;
     }
     const thisInstrumentEE = this.ee;
-    (0, _wrapHistory.wrapHistory)(thisInstrumentEE);
-    this.eventsEE = (0, _wrapEvents.wrapEvents)(thisInstrumentEE);
+    (0, _wrapHistory.wrapHistory)(thisInstrumentEE, agentRef);
+    this.eventsEE = (0, _wrapEvents.wrapEvents)(thisInstrumentEE, agentRef);
     this.eventsEE.on(FN_START, function (args, target) {
       this.bstStart = (0, _now.now)();
     });

package/dist/cjs/features/soft_navigations/instrument/index.js

@@ -15,7 +15,7 @@ var _constants = require("../constants");
 var _now = require("../../../common/timing/now");
 var _interaction = require("../../../loaders/api/interaction");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); } /**
- * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 /**
@@ -34,7 +34,7 @@ class Instrument extends _instrumentBase.InstrumentBase {
     (0, _interaction.setupInteractionAPI)(agentRef);
     if (!_runtime.isBrowserScope || !(0, _nreum.gosNREUMOriginals)().o.MO) return; // soft navigations is not supported outside web env or browsers without the mutation observer API
 
-    const historyEE = (0, _wrapHistory.wrapHistory)(this.ee);
+    const historyEE = (0, _wrapHistory.wrapHistory)(this.ee, agentRef);
     try {
       this.removeOnAbort = new AbortController();
     } catch (e) {}

package/dist/cjs/loaders/api/register.js

@@ -7,12 +7,12 @@ exports.setupRegisterAPI = setupRegisterAPI;
 exports.warnings = void 0;
 var _handle = require("../../common/event-emitter/handle");
 var _console = require("../../common/util/console");
-var _utils = require("../../common/v2/utils");
+var _constants = require("../../common/v2/constants");
 var _features = require("../features/features");
 var _now = require("../../common/timing/now");
-var _constants = require("../../features/metrics/constants");
+var _constants2 = require("../../features/metrics/constants");
 var _sharedHandlers = require("./sharedHandlers");
-var _constants2 = require("./constants");
+var _constants3 = require("./constants");
 var _log = require("./log");
 var _addPageAction = require("./addPageAction");
 var _noticeError = require("./noticeError");
@@ -57,7 +57,7 @@ const warnings = exports.warnings = {
  * It is not recommended for use in production environments and will not receive support for issues.
  */
 function setupRegisterAPI(agent) {
-  (0, _sharedHandlers.setupAPI)(_constants2.REGISTER, function (target) {
+  (0, _sharedHandlers.setupAPI)(_constants3.REGISTER, function (target) {
     return register(agent, target);
   }, agent);
 }
@@ -73,7 +73,7 @@ function register(agentRef, target) {
   warnings.experimental();
   target ||= {};
   target.instance = (0, _uniqueId.generateRandomHexString)(8);
-  target.type = _utils.V2_TYPES.MFE;
+  target.type = _constants.V2_TYPES.MFE;
   target.licenseKey ||= agentRef.info.licenseKey; // will inherit the license key from the container agent if not provided for brevity. A future state may dictate that we need different license keys to do different things.
   target.blocked = false;
   if (typeof target.tags !== 'object' || target.tags === null || Array.isArray(target.tags)) target.tags = {};
@@ -82,7 +82,7 @@ function register(agentRef, target) {
       return agentRef.runtime.appMetadata.agents?.[0].entityGuid;
     },
     // getter because this is asynchronously set
-    type: _utils.V2_TYPES.BA
+    type: _constants.V2_TYPES.BA
   };
   const timings = (0, _scriptTracker.findScriptTimings)(target);
 
@@ -99,7 +99,7 @@ function register(agentRef, target) {
           'source.id': target.id,
           'source.name': target.name,
           'source.type': target.type,
-          'parent.type': target.parent?.type || _utils.V2_TYPES.BA,
+          'parent.type': target.parent?.type || _constants.V2_TYPES.BA,
           'parent.id': target.parent?.id
         };
       }
@@ -281,7 +281,7 @@ function register(agentRef, target) {
     const timestamp = api.metadata.events.latestTimestamp ?? (0, _now.now)();
     api.metadata.events.latestTimestamp = undefined;
     const methodName = METHOD_NAMES.get(methodToCall) || 'unknown';
-    (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodName, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
+    (0, _handle.handle)(_constants2.SUPPORTABILITY_METRIC_CHANNEL, ["API/register/".concat(methodName, "/called")], undefined, _features.FEATURE_NAMES.metrics, agentRef.ee);
     try {
       return methodToCall(...args, target, timestamp); // always report to target
     } catch (err) {

package/dist/cjs/loaders/configure/configure.js

@@ -9,6 +9,7 @@ var _nreum = require("../../common/window/nreum");
 var _info = require("../../common/config/info");
 var _init = require("../../common/config/init");
 var _runtime = require("../../common/config/runtime");
+var _constants = require("../../common/v2/constants");
 var _runtime2 = require("../../common/constants/runtime");
 var _publicPath = require("./public-path");
 var _contextualEe = require("../../common/event-emitter/contextual-ee");
@@ -52,6 +53,19 @@ function configure(agent, opts = {}, loaderType, forceDrain) {
   agent.info = (0, _info.mergeInfo)(info);
   const updatedInit = agent.init;
   agent.runtime ??= (0, _runtime.mergeRuntime)(runtime);
+  agent.runtime.v2Target ??= {
+    type: _constants.V2_TYPES.BA,
+    instance: agent.agentIdentifier,
+    get id() {
+      return agent.runtime.appMetadata?.agents?.[0]?.entityGuid;
+    },
+    get attributes() {
+      return {
+        'entity.guid': this.id,
+        appId: agent.info.applicationID
+      };
+    }
+  };
 
   // Apply proxy settings whenever configure is called (supports late {init} setting)
   if (updatedInit.proxy.assets) {

package/dist/esm/common/config/runtime.js

@@ -40,6 +40,8 @@ const RuntimeModel = {
   drainRegistry: new Map(),
   connector: undefined,
   harvester: undefined,
+  /** eagerly-created in configure() -- the v2 target representing the container (main) agent, see common/v2/utils#V2Target */
+  v2Target: undefined,
   isolatedBacklog: false,
   isRecording: false,
   // true when actively recording, false when paused or stopped

package/dist/esm/common/constants/env.cdn.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.320.1-rc.1";
+export const VERSION = "1.320.1-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/constants/env.npm.js

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.320.1-rc.1";
+export const VERSION = "1.320.1-rc.2";
 
 /**
  * Exposes the build type of the agent

package/dist/esm/common/dom/selector-path.js

@@ -22,7 +22,7 @@ export const analyzeElemPath = (elem, targetFields = [], agentRef) => {
     path: undefined,
     nearestFields: {},
     get targets() {
-      return targets.length ? targets : [undefined];
+      return targets.length ? targets : [agentRef.runtime.v2Target];
     },
     hasButton: false,
     hasLink: false

package/dist/esm/common/session/session-entity.js

@@ -60,7 +60,7 @@ export class SessionEntity {
     // key is intended to act as the k=v pair
     this.key = key;
     this.ee = agentRef.ee;
-    wrapEvents(this.ee);
+    wrapEvents(this.ee, agentRef);
     this.setup(opts);
 
     /**

package/dist/esm/common/v2/constants.js

@@ -0,0 +1,15 @@
+/**
+ * Copyright 2020-2026 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @enum {string}
+ * @readonly
+ */
+export const V2_TYPES = {
+  /** Micro Frontend */
+  MFE: 'MFE',
+  /** Browser Application */
+  BA: 'BA'
+};

package/dist/esm/common/v2/utils.js

@@ -4,17 +4,24 @@
  */
 
 import { extractUrlsFromStack, getDeepStackTrace } from './script-tracker';
+import { V2_TYPES } from './constants';
 
 /**
- * @enum {string}
- * @readonly
+ * @typedef {Object} V2Target
+ * @property {'BA'} type always V2_TYPES.BA -- identifies this as the container (main) agent, not a registered MFE
+ * @property {string} instance the container agent's agentIdentifier
+ * @property {string} [id] the container agent's entity guid, once known (getter, resolved asynchronously)
+ * @property {{[key:string]: any}} attributes the V2 payload attributes for the container agent (getter)
  */
-export const V2_TYPES = {
-  /** Micro Frontend */
-  MFE: 'MFE',
-  /** Browser Application */
-  BA: 'BA'
-};
+
+/**
+ * Determines if a given target represents a registered MFE (as opposed to the container agent).
+ * @param {*} target the target to check
+ * @returns {boolean} true if the target is a registered MFE target
+ */
+export function isMfeTarget(target) {
+  return target?.type === V2_TYPES.MFE;
+}
 
 /**
  * Returns a single registered entity associated with a given iframe interface ID. Returns undefined if no entity is found.
@@ -110,14 +117,8 @@ export function dedupeRegisteredEntitiesByAsset(entities) {
  */
 export function getVersion2Attributes(target, aggregateInstance) {
   if (!supportsV2(aggregateInstance)) return {};
-  const containerAgentEntityGuid = aggregateInstance.agentRef.runtime.appMetadata.agents[0].entityGuid;
-  /** if there's no target, but we are in v2 mode, this means the data belongs to the container agent */
-  if (!target) {
-    return {
-      'entity.guid': containerAgentEntityGuid,
-      appId: aggregateInstance.agentRef.info.applicationID
-    };
-  }
+  /** if the target isn't a registered MFE, but we are in v2 mode, this means the data belongs to the container agent */
+  if (!isMfeTarget(target)) return aggregateInstance.agentRef.runtime.v2Target.attributes;
   /** otherwise, the data belongs to the target (MFE) and should be attributed as such */
   return target.attributes;
 }
@@ -147,16 +148,17 @@ export function getVersion2DuplicationAttributes(target, aggregateInstance) {
  * @returns {boolean} returns true if the event should be duplicated for the target, false otherwise
  */
 export function shouldDuplicate(target, aggregateInstance) {
-  return !!target && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
+  return isMfeTarget(target) && !!supportsV2(aggregateInstance) && aggregateInstance.agentRef.init.api.register.duplicate_data_to_container;
 }
 
 /**
  * Finds the registered targets from the stack trace for a given agent reference.
  * @param {*} agentRef The agent reference to use for finding targets.
- * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array with undefined.
+ * @returns {Array} An array of targets found from the stack trace. If no targets are found or allowed, returns an array containing the container target.
  */
 export function findTargetsFromStackTrace(agentRef) {
-  if (!isValid(true, agentRef) || !agentRef?.runtime?.registeredEntities?.length) return [undefined];
+  if (!agentRef?.runtime) return [];
+  if (!isValid(true, agentRef) || !agentRef.runtime.registeredEntities?.length) return [agentRef.runtime.v2Target];
   const targets = [];
   try {
     var urls = extractUrlsFromStack(getDeepStackTrace());
@@ -168,15 +170,15 @@ export function findTargetsFromStackTrace(agentRef) {
     // Silent catch to prevent errors from propagating
   }
   const deduped = dedupeTargetsByInstance(targets);
-  if (!deduped.length) deduped.push(undefined); // if we can't find any targets from the stack trace, return an array with undefined to signify the container agent is the target
+  if (!deduped.length) deduped.push(agentRef.runtime.v2Target); // if we can't find any targets from the stack trace, the container agent is the target
   return deduped;
 }
 
 /**
  * Removes duplicate targets from an array, keyed by `target.instance`. This guards against the same canonical
  * target re-entering the array via multiple matched stack-frame URLs (e.g. a recursive call whose stack contains the
- * same file at multiple depths). Entries with no `instance` (i.e. `undefined`, meaning "the container agent")
- * naturally collapse to a single entry too, which is the desired behavior.
+ * same file at multiple depths). Multiple container-target entries (whose `instance` is the container agent's stable
+ * `agentIdentifier`) naturally collapse to a single entry too, which is the desired behavior.
  * @param {Array} targets
  * @returns {Array} deduped list of targets, preserving relative order of first occurrence
  */