@newrelic/browser-agent 1.285.0 → 1.287.0

package/dist/cjs/loaders/micro-agent-base.js

@@ -23,7 +23,7 @@ class MicroAgentBase {
    * @param  {...any} args
    */
   #callMethod(methodName, ...args) {
-    if (typeof this.api?.[methodName] !== 'function') (0, _console.warn)(35, methodName);else return this.api[methodName](...args);
+    if (this[methodName] === MicroAgentBase.prototype[methodName]) (0, _console.warn)(35, methodName);else return this[methodName](...args);
   }
 
   // MicroAgent class custom defines its own start
@@ -38,6 +38,22 @@ class MicroAgentBase {
     return this.#callMethod('addPageAction', name, attributes);
   }
 
+  /**
+   * @experimental
+   * IMPORTANT: This feature is being developed for use internally and is not in a public-facing production-ready state.
+   * It is not recommended for use in production environments and will not receive support for issues.
+   *
+   * Registers an external caller to report through the base agent to a different target than the base agent.
+   * @param {object} target the target object to report data to
+   * @param {string} target.licenseKey The licenseKey to report data to
+   * @param {string} target.applicationID The applicationID to report data to
+   * @param {string=} target.entityGuid The entityGuid to report data to
+   * @returns {object} Returns an object that contains the available API methods and configurations to use with the external caller. See loaders/api/api.js for more information.
+   */
+  register(target) {
+    return this.#callMethod('register', target);
+  }
+
   /**
    * Records a custom event with a specified eventType and attributes.
    * {@link https://docs.newrelic.com/docs/browser/new-relic-browser/browser-apis/recordCustomEvent/}

package/dist/cjs/loaders/micro-agent.js

@@ -20,6 +20,7 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
 const nonAutoFeatures = [_features.FEATURE_NAMES.jserrors, _features.FEATURE_NAMES.genericEvents, _features.FEATURE_NAMES.metrics, _features.FEATURE_NAMES.logging];
 
 /**
+ * @deprecated This feature has been deprecated and will be removed in a future release. A future product centralizing around a single agent instance will be released as a replacement, at which time this loader will be removed.
  * A minimal agent class designed to only respond to manual user input. As such, this class does not
  * automatically instrument. Instead, each MicroAgent instance will lazy load the required features and can support loading multiple instances on one page.
  * Out of the box, it can manually handle and report Page View, Page Action, and Error events.
@@ -38,7 +39,6 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
         isolatedBacklog: true
       }
     }, options.loaderType || 'micro-agent');
-    Object.assign(this, this.api); // the APIs should be available at the class level for micro-agent
 
     /**
      * Starts a set of agent features if not running in "autoStart" mode
@@ -91,5 +91,8 @@ class MicroAgent extends _microAgentBase.MicroAgentBase {
       runtime: this.runtime
     };
   }
+  get api() {
+    return this;
+  }
 }
 exports.MicroAgent = MicroAgent;

package/dist/esm/common/config/init-types.js

@@ -0,0 +1,92 @@
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ */
+
+/**
+ * @typedef {Object} Init
+ * @property {Object} [ajax]
+ * @property {Array<string>} [ajax.deny_list] - List of domain URLs to be excluded from AjaxRequest collection.
+ * @property {boolean} [ajax.block_internal] - If true, agent requests going to harvest endpoint are treated as on deny list. In other words, agent will not self-report AJAX.
+ * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
+ * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [api]
+ * @property {boolean} [api.allow_registered_children] - If true, the agent will allow registered children to be sent to the server.
+ * @property {boolean} [api.duplicate_registered_data] - If true, the agent will capture registered child data to the main agent as well as the registered child.
+ * @property {Object} [distributed_tracing]
+ * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
+ * @property {boolean} [distributed_tracing.exclude_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_newrelic_header]
+ * @property {boolean} [distributed_tracing.cors_use_tracecontext_headers]
+ * @property {Array<string>} [distributed_tracing.allowed_origins]
+ * @property {Array<string>} [feature_flags] - An array of feature flags to enable experimental features.
+ * @property {Object} [generic_events]
+ * @property {boolean} [generic_events.enabled] - Turn on/off the generic events feature (on by default). This is required for `PageAction`, `UserAction`, and `BrowserPerformance` events.
+ * @property {boolean} [generic_events.autoStart] - If true, the agent will automatically start the generic events feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [harvest]
+ * @property {number} [harvest.interval] - The interval in seconds at which the agent will send out data. It's not recommended to change this value.
+ * @property {Object} [jserrors]
+ * @property {boolean} [jserrors.enabled] - Turn on/off the jserrors feature (on by default).
+ * @property {boolean} [jserrors.autoStart] - If true, the agent will automatically start the jserrors feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [logging]
+ * @property {boolean} [logging.enabled] - Turn on/off the logging feature (on by default).
+ * @property {boolean} [logging.autoStart] - If true, the agent will automatically start the logging feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [metrics]
+ * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
+ * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
+ * @property {Object} [page_action]
+ * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
+ * @property {Object} [page_view_event]
+ * @property {boolean} [page_view_event.enabled] - This setting is ignored! PageViewEvent is always enabled by force.
+ * @property {boolean} [page_view_event.autoStart] - If true, the agent will automatically send the RUM request. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [page_view_timing]
+ * @property {boolean} [page_view_timing.enabled] - Turn on/off the page view timing feature (on by default).
+ * @property {boolean} [page_view_timing.autoStart] - If true, the agent will automatically start the page view timing feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [performance]
+ * @property {boolean} [performance.capture_marks] - If true, the agent will capture PerformanceMark events.
+ * @property {boolean} [performance.capture_measures] - If true, the agent will capture PerformanceMeasure events.
+ * @property {boolean} [performance.capture_detail] - If true, `BrowserPerformance` events from marks and measures will include, as attribute(s), the `detail` metadata provided to `markOptions` and `measureOptions`.
+ * @property {Object} [performance.resources]
+ * @property {boolean} [performance.resources.enabled] - If true, the agent will capture PerformanceResourceTiming entries.
+ * @property {Array<string>} [performance.resources.asset_types] - Array of `initiatorType` strings to filter the desired ResourceTiming entries. By default, all resource types are captured.
+ * @property {Array<string>} [performance.resources.first_party_domains] - Each resource URL will be checked against this list to determine if it should be labeled "first party" in the resulting `BrowserPerformance` event.
+ * @property {boolean} [performance.resources.ignore_newrelic] - When true (default), resource entries associated with New Relic domains will be ignored.
+ * @property {Object} [privacy]
+ * @property {boolean} [privacy.cookies_enabled] - If true (default), session tracking of users across page loads is enabled in the agent. This is required for session trace, replay, and session-related features.
+ * @property {Object} [proxy]
+ * @property {string} [proxy.assets] - Set value will be used to overwrite the webpack asset path used to fetch agent assets.
+ * @property {string} [proxy.beacon] - Set value will be used to overwrite the endpoint URL to which we send analytics.
+ * @property {Object} [session]
+ * @property {number} [session.expiresMs] - When session tracking is on, this determines how long a session will last before expiring. Modifying this value is not recommended.
+ * @property {number} [session.inactiveMs] - When session tracking is on, this determines how long a session will last without user activity before expiring. Modifying this value is not recommended.
+ * @property {Object} [session_replay]
+ * @property {boolean} [session_replay.autoStart] - If true, the agent will automatically start the session replay feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [session_replay.enabled] - Turn on/off the session replay feature (off by default).
+ * @property {boolean} [session_replay.preload] - If true, allow the agent to run rrweb recorder immediately instead of waiting until after the window.load event, for new sessions. Existing sessions ignore this setting.
+ * @property {number} [session_replay.sampling_rate] - This setting is deprecated and ineffective. Sampling is controlled in New Relic by server-side configuration.
+ * @property {number} [session_replay.error_sampling_rate] - This setting is deprecated and ineffective.
+ * @property {boolean} [session_replay.collect_fonts] - When true, serialize fonts for collection without public asset url. This is currently broken -- https://github.com/rrweb-io/rrweb/issues/1304.
+ * @property {boolean} [session_replay.inline_images] - When true, serialize images for collection without public asset url. Not recommended for use. This is currently for TESTING as it easily generates payloads too large to be harvested.
+ * @property {boolean} [session_replay.fix_stylesheets] - When true, tries to fetch any missing stylesheets again to inline in replayer.
+ * @property {boolean} [session_replay.mask_all_inputs] - If true, all input content will be masked with asterisks.
+ * @property {string} [session_replay.mask_text_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to mask.
+ * @property {string} [session_replay.block_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to block.
+ * @property {Object} [session_replay.mask_input_options] - If mask_all_inputs is not true, this object will be used to select what input to mask. Passwords are forcibly always masked.
+ * @property {Object} [session_trace]
+ * @property {boolean} [session_trace.enabled] - Turn on/off the session trace feature (on by default).
+ * @property {boolean} [session_trace.autoStart] - If true, the agent will automatically start the session trace feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [soft_navigations]
+ * @property {boolean} [soft_navigations.enabled] - Turn on/off the soft navigations feature (on by default).
+ * @property {boolean} [soft_navigations.autoStart] - If true, the agent will automatically start the soft navigations feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {Object} [spa]
+ * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
+ * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
+ * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
+ * @property {Object} [user_actions]
+ * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
+ * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ */
+
+export default {};

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

@@ -10,88 +10,14 @@ import { getNREUMInitializedAgent } from '../window/nreum';
 import { getModeledObject } from './configurable';
 
 /**
- * @typedef {Object} Init
- * @property {Object} [ajax]
- * @property {Array<string>} [ajax.deny_list] - List of domain URLs to be excluded from AjaxRequest collection.
- * @property {boolean} [ajax.block_internal] - If true, agent requests going to harvest endpoint are treated as on deny list. In other words, agent will not self-report AJAX.
- * @property {boolean} [ajax.enabled] - Turn on/off the ajax feature (on by default).
- * @property {boolean} [ajax.autoStart] - If true, the agent will automatically start the ajax feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [distributed_tracing]
- * @property {boolean} [distributed_tracing.enabled] - If true, distributed tracing headers will be added to outgoing requests. Requires ajax feature to be running.
- * @property {boolean} [distributed_tracing.exclude_newrelic_header]
- * @property {boolean} [distributed_tracing.cors_use_newrelic_header]
- * @property {boolean} [distributed_tracing.cors_use_tracecontext_headers]
- * @property {Array<string>} [distributed_tracing.allowed_origins]
- * @property {Array<string>} [feature_flags] - An array of feature flags to enable experimental features.
- * @property {Object} [generic_events]
- * @property {boolean} [generic_events.enabled] - Turn on/off the generic events feature (on by default). This is required for `PageAction`, `UserAction`, and `BrowserPerformance` events.
- * @property {boolean} [generic_events.autoStart] - If true, the agent will automatically start the generic events feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [harvest]
- * @property {number} [harvest.interval] - The interval in seconds at which the agent will send out data. It's not recommended to change this value.
- * @property {Object} [jserrors]
- * @property {boolean} [jserrors.enabled] - Turn on/off the jserrors feature (on by default).
- * @property {boolean} [jserrors.autoStart] - If true, the agent will automatically start the jserrors feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [logging]
- * @property {boolean} [logging.enabled] - Turn on/off the logging feature (on by default).
- * @property {boolean} [logging.autoStart] - If true, the agent will automatically start the logging feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [metrics]
- * @property {boolean} [metrics.enabled] - Turn on/off the metrics feature (on by default).
- * @property {boolean} [metrics.autoStart] - If true, the agent will automatically start the metrics feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Array<Object>} [obfuscate] - Array of regexp and corresponding replacement patterns for obfuscating data.
- * @property {Object} [page_action]
- * @property {boolean} [page_action.enabled] - Must be true to allow PageAction events to be captured.
- * @property {Object} [page_view_event]
- * @property {boolean} [page_view_event.enabled] - This setting is ignored! PageViewEvent is always enabled by force.
- * @property {boolean} [page_view_event.autoStart] - If true, the agent will automatically send the RUM request. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [page_view_timing]
- * @property {boolean} [page_view_timing.enabled] - Turn on/off the page view timing feature (on by default).
- * @property {boolean} [page_view_timing.autoStart] - If true, the agent will automatically start the page view timing feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [performance]
- * @property {boolean} [performance.capture_marks] - If true, the agent will capture PerformanceMark events.
- * @property {boolean} [performance.capture_measures] - If true, the agent will capture PerformanceMeasure events.
- * @property {boolean} [performance.capture_detail] - If true, `BrowserPerformance` events from marks and measures will include, as attribute(s), the `detail` metadata provided to `markOptions` and `measureOptions`.
- * @property {Object} [performance.resources]
- * @property {boolean} [performance.resources.enabled] - If true, the agent will capture PerformanceResourceTiming entries.
- * @property {Array<string>} [performance.resources.asset_types] - Array of `initiatorType` strings to filter the desired ResourceTiming entries. By default, all resource types are captured.
- * @property {Array<string>} [performance.resources.first_party_domains] - Each resource URL will be checked against this list to determine if it should be labeled "first party" in the resulting `BrowserPerformance` event.
- * @property {boolean} [performance.resources.ignore_newrelic] - When true (default), resource entries associated with New Relic domains will be ignored.
- * @property {Object} [privacy]
- * @property {boolean} [privacy.cookies_enabled] - If true (default), session tracking of users across page loads is enabled in the agent. This is required for session trace, replay, and session-related features.
- * @property {Object} [proxy]
- * @property {string} [proxy.assets] - Set value will be used to overwrite the webpack asset path used to fetch agent assets.
- * @property {string} [proxy.beacon] - Set value will be used to overwrite the endpoint URL to which we send analytics.
- * @property {Object} [session]
- * @property {number} [session.expiresMs] - When session tracking is on, this determines how long a session will last before expiring. Modifying this value is not recommended.
- * @property {number} [session.inactiveMs] - When session tracking is on, this determines how long a session will last without user activity before expiring. Modifying this value is not recommended.
- * @property {Object} [session_replay]
- * @property {boolean} [session_replay.autoStart] - If true, the agent will automatically start the session replay feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {boolean} [session_replay.enabled] - Turn on/off the session replay feature (off by default).
- * @property {boolean} [session_replay.preload] - If true, allow the agent to run rrweb recorder immediately instead of waiting until after the window.load event, for new sessions. Existing sessions ignore this setting.
- * @property {number} [session_replay.sampling_rate] - This setting is deprecated and ineffective. Sampling is controlled in New Relic by server-side configuration.
- * @property {number} [session_replay.error_sampling_rate] - This setting is deprecated and ineffective.
- * @property {boolean} [session_replay.collect_fonts] - When true, serialize fonts for collection without public asset url. This is currently broken -- https://github.com/rrweb-io/rrweb/issues/1304.
- * @property {boolean} [session_replay.inline_images] - When true, serialize images for collection without public asset url. Not recommended for use. This is currently for TESTING as it easily generates payloads too large to be harvested.
- * @property {boolean} [session_replay.fix_stylesheets] - When true, tries to fetch any missing stylesheets again to inline in replayer.
- * @property {boolean} [session_replay.mask_all_inputs] - If true, all input content will be masked with asterisks.
- * @property {string} [session_replay.mask_text_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to mask.
- * @property {string} [session_replay.block_selector] - Set value should be in CSS selector syntax and is used to identify matching elements to block.
- * @property {Object} [session_replay.mask_input_options] - If mask_all_inputs is not true, this object will be used to select what input to mask. Passwords are forcibly always masked.
- * @property {Object} [session_trace]
- * @property {boolean} [session_trace.enabled] - Turn on/off the session trace feature (on by default).
- * @property {boolean} [session_trace.autoStart] - If true, the agent will automatically start the session trace feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [soft_navigations]
- * @property {boolean} [soft_navigations.enabled] - Turn on/off the soft navigations feature (on by default).
- * @property {boolean} [soft_navigations.autoStart] - If true, the agent will automatically start the soft navigations feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {Object} [spa]
- * @property {boolean} [spa.enabled] - Turn on/off the single page application feature (on by default). NOTE: the SPA feature is deprecated and under removal procedure.
- * @property {boolean} [spa.autoStart] - If true, the agent will automatically start the single page application feature. Otherwise, it will be in a deferred state until the `start` API method is called.
- * @property {boolean} [ssl] - If explicitly false, the agent will use HTTP instead of HTTPS. This setting should NOT be used.
- * @property {Object} [user_actions]
- * @property {boolean} [user_actions.enabled] - Must be true to allow UserAction events to be captured.
- * @property {Array<string>} [user_actions.elementAttributes] - List of HTML Element properties to be captured with UserAction events' target elements. This may help to identify the source element being interacted with in the UI.
+ * @typedef {import('./init-types').Init} Init
  */
 
 const nrMask = '[data-nr-mask]';
+
+/**
+ * @returns {Init} the default configuration object
+ */
 const model = () => {
   const hiddenState = {
     feature_flags: [],
@@ -129,6 +55,10 @@ const model = () => {
       enabled: true,
       autoStart: true
     },
+    api: {
+      allow_registered_children: true,
+      duplicate_registered_data: false
+    },
     distributed_tracing: {
       enabled: undefined,
       exclude_newrelic_header: undefined,

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

@@ -19,21 +19,22 @@ const readonly = {
   originTime
 };
 const model = {
+  /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
+  appMetadata: {},
   customTransaction: undefined,
+  denyList: undefined,
   disabled: false,
+  entityManager: undefined,
+  harvester: undefined,
   isolatedBacklog: false,
   loaderType: undefined,
   maxBytes: 30000,
+  obfuscator: undefined,
   onerror: undefined,
   ptid: undefined,
   releaseIds: {},
-  /** Agent-specific metadata found in the RUM call response. ex. entityGuid */
-  appMetadata: {},
   session: undefined,
-  denyList: undefined,
-  timeKeeper: undefined,
-  obfuscator: undefined,
-  harvester: undefined
+  timeKeeper: undefined
 };
 const _cache = {};
 export function getRuntime(id) {

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

@@ -11,7 +11,7 @@
 /**
  * Exposes the version of the agent
  */
-export const VERSION = "1.285.0";
+export const VERSION = "1.287.0";
 
 /**
  * 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.285.0";
+export const VERSION = "1.287.0";
 
 /**
  * Exposes the build type of the agent

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

@@ -40,7 +40,7 @@ export const generateSelectorPath = (elem, targetFields = []) => {
         localName
       } = elem;
       targetFields.forEach(field => {
-        nearestFields[nearestAttrName(field)] ||= elem[field];
+        nearestFields[nearestAttrName(field)] ||= elem[field]?.baseVal || elem[field];
       });
       const selector = [localName, id ? "#".concat(id) : '', pathSelector ? ">".concat(pathSelector) : ''].join('');
       pathSelector = selector;

package/dist/esm/common/harvest/harvester.js

@@ -145,7 +145,7 @@ function send(agentRef, {
   const protocol = agentRef.init.ssl === false ? 'http' : 'https';
   const perceivedBeacon = agentRef.init.proxy.beacon || agentRef.info.errorBeacon;
   const url = raw ? "".concat(protocol, "://").concat(perceivedBeacon, "/").concat(endpoint) : "".concat(protocol, "://").concat(perceivedBeacon).concat(endpoint !== RUM ? '/' + endpoint : '', "/1/").concat(targetApp.licenseKey);
-  const baseParams = !raw ? baseQueryString(agentRef, qs, endpoint, targetApp.appId) : '';
+  const baseParams = !raw ? baseQueryString(agentRef, qs, endpoint, targetApp.applicationID) : '';
   let payloadParams = obj(qs, agentRef.runtime.maxBytes);
   if (baseParams === '' && payloadParams.startsWith('&')) {
     payloadParams = payloadParams.substring(1);
@@ -185,8 +185,8 @@ function send(agentRef, {
           sent: this.status !== 0,
           status: this.status,
           retry: shouldRetry(this.status),
-          xhr: this,
           fullUrl,
+          xhr: this,
           targetApp
         };
         if (localOpts.needResponse) cbResult.responseText = this.responseText;
@@ -210,7 +210,7 @@ function send(agentRef, {
   }
   dispatchGlobalEvent({
     agentIdentifier: agentRef.agentIdentifier,
-    loaded: !!activatedFeatures?.[agentRef.agentIdentifier],
+    drained: !!activatedFeatures?.[agentRef.agentIdentifier],
     type: 'data',
     name: 'harvest',
     feature: featureName,

package/dist/esm/common/util/feature-flags.js

@@ -2,7 +2,6 @@
  * Copyright 2020-2025 New Relic, Inc. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ee } from '../event-emitter/contextual-ee';
 import { dispatchGlobalEvent } from '../dispatch/global-event';
 const sentIds = new Set();
 
@@ -16,19 +15,20 @@ export const activatedFeatures = {};
  * @param {string} agentIdentifier agent instance identifier
  * @returns {void}
  */
-export function activateFeatures(flags, agentIdentifier) {
-  const sharedEE = ee.get(agentIdentifier);
+export function activateFeatures(flags, agentRef) {
+  const agentIdentifier = agentRef.agentIdentifier;
   activatedFeatures[agentIdentifier] ??= {};
-  if (!(flags && typeof flags === 'object')) return;
+  if (!flags || typeof flags !== 'object') return;
   if (sentIds.has(agentIdentifier)) return;
-  sharedEE.emit('rumresp', [flags]);
+  agentRef.ee.emit('rumresp', [flags]);
   activatedFeatures[agentIdentifier] = flags;
   sentIds.add(agentIdentifier);
 
-  // let any window level subscribers know that the agent is running
+  // let any window level subscribers know that the agent is running, per install docs
   dispatchGlobalEvent({
     agentIdentifier,
     loaded: true,
+    drained: true,
     type: 'lifecycle',
     name: 'load',
     feature: undefined,

package/dist/esm/common/util/target.js

@@ -0,0 +1,27 @@
+/**
+ * Copyright 2020-2025 New Relic, Inc. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @param {Object} [target] - the target to be validated
+ * @param {boolean} [allowUndefined=true]
+ * @returns {boolean}
+ */
+export function isValidTarget(target) {
+  /** target can be undefined to support legacy/default behaviors - main agent does not supply a target */
+  if (!target) return true;
+  /** if not undefined, we require specific values */
+  return !!(target.licenseKey && target.applicationID);
+}
+
+/**
+ * Checks if the target matches the container agent target
+ * @param {*} target the target to be validated
+ * @param {*} agentRef the agent reference to be validated
+ * @returns {boolean}
+ */
+export function isContainerAgentTarget(target, agentRef) {
+  if (!target) return true;
+  return target.licenseKey === agentRef.info.licenseKey && target.applicationID === agentRef.info.applicationID;
+}

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

@@ -54,7 +54,7 @@ export class Aggregate extends AggregateBase {
 
     // Report ajax timeslice metric (to be harvested by jserrors feature, but only if it's running).
     if (jserrorsInUse && (shouldCollect || !shouldOmitAjaxMetrics)) {
-      this.agentRef.sharedAggregator.add(['xhr', hash, params, metrics]);
+      this.agentRef.sharedAggregator?.add(['xhr', hash, params, metrics]);
     }
     if (!shouldCollect) {
       if (params.hostname === this.agentRef.info.errorBeacon || this.agentRef.init.proxy?.beacon && params.hostname === this.agentRef.init.proxy.beacon) {
@@ -107,6 +107,7 @@ export class Aggregate extends AggregateBase {
     }
   }
   serializer(eventBuffer) {
+    if (!eventBuffer.length) return;
     const addString = getAddStringContext(this.agentIdentifier);
     let payload = 'bel.7;';
     for (let i = 0; i < eventBuffer.length; i++) {

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

@@ -37,7 +37,8 @@ export class Aggregate extends AggregateBase {
         });
       }, this.featureName, this.ee);
       if (agentRef.init.page_action.enabled) {
-        registerHandler('api-addPageAction', (timestamp, name, attributes) => {
+        registerHandler('api-addPageAction', (timestamp, name, attributes, targetEntityGuid) => {
+          if (!this.agentRef.runtime.entityManager.get(targetEntityGuid)) return warn(56, this.featureName);
           this.addEvent({
             ...attributes,
             eventType: 'PageAction',
@@ -49,7 +50,7 @@ export class Aggregate extends AggregateBase {
               browserWidth: window.document.documentElement?.clientWidth,
               browserHeight: window.document.documentElement?.clientHeight
             })
-          });
+          }, targetEntityGuid);
         }, this.featureName, this.ee);
       }
       let addUserAction = () => {/** no-op */};
@@ -231,9 +232,10 @@ export class Aggregate extends AggregateBase {
    * * sessionTraceId: set by the `ptid=` query param
    * * userAgent*: set by the userAgent header
    * @param {object=} obj the event object for storing in the event buffer
+   * @param {string=} targetEntityGuid the target entity guid for the event to scope buffering and harvesting. Defaults to agent config if undefined
    * @returns void
    */
-  addEvent(obj = {}) {
+  addEvent(obj = {}, targetEntityGuid) {
     if (!obj || !Object.keys(obj).length) return;
     if (!obj.eventType) {
       warn(44);
@@ -258,14 +260,16 @@ export class Aggregate extends AggregateBase {
       /** Event-specific attributes take precedence over agent-level custom attributes and fallbacks */
       ...obj
     };
-    const addedEvent = this.events.add(eventAttributes);
-    if (!addedEvent && !this.events.isEmpty()) {
+    const addedEvent = this.events.add(eventAttributes, targetEntityGuid);
+    if (!addedEvent && !this.events.isEmpty(undefined, targetEntityGuid)) {
       /** could not add the event because it pushed the buffer over the limit
        * so we harvest early, and try to add it again now that the buffer is cleared
        * if it fails again, we do nothing
        */
       this.ee.emit(SUPPORTABILITY_METRIC_CHANNEL, ['GenericEvents/Harvest/Max/Seen']);
-      this.agentRef.runtime.harvester.triggerHarvestFor(this);
+      this.agentRef.runtime.harvester.triggerHarvestFor(this, {
+        targetEntityGuid
+      });
       this.events.add(eventAttributes);
     }
   }

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

@@ -17,6 +17,8 @@ import { AggregateBase } from '../../utils/aggregate-base';
 import { now } from '../../../common/timing/now';
 import { applyFnToProps } from '../../../common/util/traverse';
 import { evaluateInternalError } from './internal-errors';
+import { isContainerAgentTarget } from '../../../common/util/target';
+import { warn } from '../../../common/util/console';
 
 /**
  * @typedef {import('./compute-stack-trace.js').StackInfo} StackInfo
@@ -96,10 +98,13 @@ export class Aggregate extends AggregateBase {
    * @param {object=} customAttributes  any custom attributes to be included in the error payload
    * @param {boolean=} hasReplay a flag indicating if the error occurred during a replay session
    * @param {string=} swallowReason a string indicating pre-defined reason if swallowing the error.  Mainly used by the internal error SMs.
+   * @param {object=} target the target to buffer and harvest to, if undefined the default configuration target is used
    * @returns
    */
-  storeError(err, time, internal, customAttributes, hasReplay, swallowReason) {
+  storeError(err, time, internal, customAttributes, hasReplay, swallowReason, targetEntityGuid) {
     if (!err) return;
+    const target = this.agentRef.runtime.entityManager.get(targetEntityGuid);
+    if (!target) return warn(56, this.featureName);
     // are we in an interaction
     time = time || now();
     let filterOutput;
@@ -131,7 +136,9 @@ export class Aggregate extends AggregateBase {
     // Notice if filterOutput isn't false|undefined OR our specified object, this func would've returned already (so it's unnecessary to req-check group).
     // Do not modify the name ('errorGroup') of params without DEM approval!
     if (filterOutput?.group) params.errorGroup = filterOutput.group;
-    if (hasReplay) params.hasReplay = hasReplay;
+
+    // Should only decorate "hasReplay" for the container agent, so check if the target matches the config
+    if (hasReplay && isContainerAgentTarget(target, this.agentRef)) 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,
@@ -166,33 +173,38 @@ export class Aggregate extends 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];
-    handle('trace-jserror', jsErrorEvent, undefined, FEATURE_NAMES.sessionTrace, this.ee);
+    if (this.shouldAllowMainAgentToCapture(targetEntityGuid)) handle('trace-jserror', jsErrorEvent, undefined, 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?.[this.agentIdentifier]) {
       params._interactionId = err.__newrelic[this.agentIdentifier].interactionId;
       params._interactionNodeId = err.__newrelic[this.agentIdentifier].interactionNodeId;
     }
-    const softNavInUse = Boolean(this.agentRef.features?.[FEATURE_NAMES.softNav]);
-    // Note: the following are subject to potential race cond wherein if the other feature aren't fully initialized, it'll be treated as there being no associated interaction.
-    // They each will also tack on their respective properties to the params object as part of the decision flow.
-    if (softNavInUse) handle('jserror', [params, time], undefined, FEATURE_NAMES.softNav, this.ee);else handle('spa-jserror', jsErrorEvent, undefined, FEATURE_NAMES.spa, this.ee);
-    if (params.browserInteractionId && !params._softNavFinished) {
-      // hold onto the error until the in-progress interaction is done, eithered saved or discarded
-      this.bufferedErrorsUnderSpa[params.browserInteractionId] ??= [];
-      this.bufferedErrorsUnderSpa[params.browserInteractionId].push(jsErrorEvent);
-    } else if (params._interactionId != null) {
-      // same as above, except tailored for the way old spa does it
-      this.bufferedErrorsUnderSpa[params._interactionId] = this.bufferedErrorsUnderSpa[params._interactionId] || [];
-      this.bufferedErrorsUnderSpa[params._interactionId].push(jsErrorEvent);
-    } else {
-      // Either there is no interaction (then all these params properties will be undefined) OR there's a related soft navigation that's already completed.
-      // The old spa does not look up completed interactions at all, so there's no need to consider it.
-      this.#storeJserrorForHarvest(jsErrorEvent, params.browserInteractionId !== undefined, params._softNavAttributes);
+    if (this.shouldAllowMainAgentToCapture(targetEntityGuid)) {
+      const softNavInUse = Boolean(this.agentRef.features?.[FEATURE_NAMES.softNav]);
+      // Note: the following are subject to potential race cond wherein if the other feature aren't fully initialized, it'll be treated as there being no associated interaction.
+      // They each will also tack on their respective properties to the params object as part of the decision flow.
+      if (softNavInUse) handle('jserror', [params, time], undefined, FEATURE_NAMES.softNav, this.ee);else handle('spa-jserror', jsErrorEvent, undefined, FEATURE_NAMES.spa, this.ee);
+      if (params.browserInteractionId && !params._softNavFinished) {
+        // hold onto the error until the in-progress interaction is done, eithered saved or discarded
+        this.bufferedErrorsUnderSpa[params.browserInteractionId] ??= [];
+        this.bufferedErrorsUnderSpa[params.browserInteractionId].push(jsErrorEvent);
+      } else if (params._interactionId != null) {
+        // same as above, except tailored for the way old spa does it
+        this.bufferedErrorsUnderSpa[params._interactionId] = this.bufferedErrorsUnderSpa[params._interactionId] || [];
+        this.bufferedErrorsUnderSpa[params._interactionId].push(jsErrorEvent);
+      } else {
+        // Either there is no interaction (then all these params properties will be undefined) OR there's a related soft navigation that's already completed.
+        // The old spa does not look up completed interactions at all, so there's no need to consider it.
+        this.#storeJserrorForHarvest(jsErrorEvent, params.browserInteractionId !== undefined, params._softNavAttributes);
+      }
     }
+
+    // always add directly if scoped to a sub-entity, the other pathways above will be deterministic if the main agent should procede
+    if (targetEntityGuid) this.#storeJserrorForHarvest([...jsErrorEvent, targetEntityGuid], false, params._softNavAttributes);
   }
   #storeJserrorForHarvest(errorInfoArr, softNavOccurredFinished, softNavCustomAttrs = {}) {
-    let [type, bucketHash, params, newMetrics, localAttrs] = errorInfoArr;
+    let [type, bucketHash, params, newMetrics, localAttrs, targetEntityGuid] = errorInfoArr;
     const allCustomAttrs = {};
     if (softNavOccurredFinished) {
       Object.entries(softNavCustomAttrs).forEach(([k, v]) => setCustom(k, v)); // when an ixn finishes, it'll include stuff in jsAttributes + attrs specific to the ixn
@@ -208,12 +220,22 @@ export class Aggregate extends AggregateBase {
 
     const jsAttributesHash = stringHashCode(stringify(allCustomAttrs));
     const aggregateHash = bucketHash + ':' + jsAttributesHash;
-    this.events.add([type, aggregateHash, params, newMetrics, allCustomAttrs]);
+    this.events.add([type, aggregateHash, params, newMetrics, allCustomAttrs], targetEntityGuid);
     function setCustom(key, val) {
       allCustomAttrs[key] = val && typeof val === 'object' ? stringify(val) : val;
     }
   }
 
+  /**
+  * If the event lacks an entityGuid (the default behavior), the main agent should capture the data. If the data is assigned to a sub-entity target
+  * the main agent should not capture events unless it is configured to do so.
+  * @param {string} entityGuid - the context object for the event
+  * @returns {boolean} - whether the main agent should capture the event to its internal target
+  */
+  shouldAllowMainAgentToCapture(entityGuid) {
+    return !entityGuid || this.agentRef.init.api.duplicate_registered_data;
+  }
+
   // TO-DO: Remove this function when old spa is taken out. #storeJserrorForHarvest handles the work with the softnav feature.
   onInteractionDone(interaction, wasSaved) {
     if (!this.bufferedErrorsUnderSpa[interaction.id] || this.blocked) return;
@@ -232,7 +254,7 @@ export class Aggregate extends AggregateBase {
       var hash = wasSaved ? item[1] + interaction.root.attrs.id : item[1];
       var jsAttributesHash = stringHashCode(stringify(allCustomAttrs));
       var aggregateHash = hash + ':' + jsAttributesHash;
-      this.events.add([item[0], aggregateHash, params, item[3], allCustomAttrs]);
+      this.events.add([item[0], aggregateHash, params, item[3], allCustomAttrs], item[5]);
       function setCustom([key, val]) {
         allCustomAttrs[key] = val && typeof val === 'object' ? stringify(val) : val;
       }