dd-trace 6.20.1 → 6.22.0

package/ci/diagnose.js

@@ -1743,9 +1743,7 @@ function readTextFiles (root, physicalRoot, files, maxTotalBytes) {
 
   for (const relativePath of files) {
     const file = getSafeScannedFile(root, physicalRoot, relativePath)
-    if (!file) continue
-
-    if (file.stat.size > MAX_TEXT_FILE_SIZE) continue
+    if (!file || file.stat.size > MAX_TEXT_FILE_SIZE) continue
     if (totalBytes + file.stat.size > maxTotalBytes) {
       textFiles.truncated = true
       break
@@ -1862,15 +1860,13 @@ function isTestSetupOrCiFile (file) {
   const relativePath = file.relativePath
   const basename = path.basename(relativePath)
 
-  if (isWorkflowFile(relativePath)) return true
-  if (basename === 'package.json') return true
-  if (/^(?:jest|config-jest|vitest|vite|playwright|cypress|cucumber)\.config\./.test(basename)) return true
-  if (/^\.mocharc\./.test(basename)) return true
-  if (basename === 'cypress.json') return true
-  if (/setup|bootstrap/i.test(basename)) return true
-  if (relativePath.startsWith('cypress/support/')) return true
-
-  return false
+  return isWorkflowFile(relativePath) ||
+    basename === 'package.json' ||
+    /^(?:jest|config-jest|vitest|vite|playwright|cypress|cucumber)\.config\./.test(basename) ||
+    /^\.mocharc\./.test(basename) ||
+    basename === 'cypress.json' ||
+    /setup|bootstrap/i.test(basename) ||
+    relativePath.startsWith('cypress/support/')
 }
 
 /**
@@ -2014,8 +2010,7 @@ function coerceVersion (rawVersion) {
  */
 function isAmbiguousRange (rawVersion) {
   const version = String(rawVersion || '').trim()
-  if (!version) return true
-  if (version.includes('||')) return true
+  if (!version || version.includes('||')) return true
   return /<=?\s*\d/.test(version)
 }
 

package/ci/init.js

@@ -32,8 +32,7 @@ function detectTestWorkerType () {
   if (getEnvironmentVariable('CUCUMBER_WORKER_ID')) return 'cucumber'
   if (getEnvironmentVariable('MOCHA_WORKER_ID')) return 'mocha'
   if (getValueFromEnvSources('DD_PLAYWRIGHT_WORKER')) return 'playwright'
-  if (getEnvironmentVariable('TINYPOOL_WORKER_ID')) return 'vitest'
-  if (getValueFromEnvSources('DD_VITEST_WORKER')) return 'vitest'
+  if (getEnvironmentVariable('TINYPOOL_WORKER_ID') || getValueFromEnvSources('DD_VITEST_WORKER')) return 'vitest'
   return null
 }
 

package/ci/test-optimization-validation/ci-discovery.js

@@ -40,8 +40,7 @@ function buildCiDiscovery ({ manifest, diagnosis }) {
   const candidateFound = getManifestWorkflowLocations(manifest)
   const manifestFound = uniqueStrings([...declaredFound, ...candidateFound])
   const searched = normalizeStringArray(declared.searched)
-  let method = 'validator-static-diagnosis'
-  if (candidateFound.length > 0) method = 'framework-ci-command'
+  let method = candidateFound.length > 0 ? 'framework-ci-command' : 'validator-static-diagnosis'
   if (declaredFound.length > 0) method = 'manifest'
   if (typeof declared.method === 'string' && declared.method) method = declared.method
   const found = manifestFound.length > 0 ? manifestFound : staticFound
@@ -83,8 +82,14 @@ function getManifestWorkflowLocations (manifest) {
 
 function getFrameworkCiDiscoveryContradiction (framework, manifest) {
   const ciDiscovery = manifest?.ciDiscovery
-  if (!ciDiscovery || !Array.isArray(ciDiscovery.staticFound) || ciDiscovery.staticFound.length === 0) return null
-  if (!frameworkClaimsNoCi(framework)) return null
+  if (
+    !ciDiscovery ||
+    !Array.isArray(ciDiscovery.staticFound) ||
+    ciDiscovery.staticFound.length === 0 ||
+    !frameworkClaimsNoCi(framework)
+  ) {
+    return null
+  }
 
   return {
     reason: 'CI workflow files were found by validator static diagnosis, but this manifest entry says no CI ' +

package/ci/test-optimization-validation/executable.js

@@ -158,11 +158,7 @@ function splitNodeOptions (source) {
       }
     }
     const next = source[index + 1]
-    if (character === '\\' && next && (next === quote || /[\s'"\\]/.test(next))) {
-      value += source[++index]
-    } else {
-      value += character
-    }
+    value += character === '\\' && next && (next === quote || /[\s'"\\]/.test(next)) ? source[++index] : character
     started = true
   }
   if (quote) throw new Error('NODE_OPTIONS contains an unterminated quoted value.')

package/ci/test-optimization-validation/framework-adapters/cypress.js

@@ -37,10 +37,7 @@ function getTestExtension (filename) {
  * @param {string} input.testName generated test name
  */
 function getGeneratedTestContent ({ scenarioId, testName }) {
-  let content = ''
-  if (scenarioId === 'atr-fail-once') {
-    content = 'let attempt = 0\n\n'
-  }
+  let content = scenarioId === 'atr-fail-once' ? 'let attempt = 0\n\n' : ''
   content += "describe('dd-test-optimization-validation', () => {\n" +
     `  it(${JSON.stringify(testName)}, () => {\n` +
     (scenarioId === 'atr-fail-once'

package/ci/test-optimization-validation/framework-adapters/vitest.js

@@ -361,7 +361,7 @@ function getDelimitedRanges (source, open, close) {
 function getLiteralStringProperties (source, property) {
   return getPropertyPositions(source, property).flatMap(({ index, valueStart }) => {
     const literal = /^(["'])([^"'\\]+)\1/.exec(source.slice(valueStart))
-    return literal ? [{ index, value: literal[2] }] : []
+    return literal ? { index, value: literal[2] } : []
   })
 }
 

package/ci/test-optimization-validation/generated-files.js

@@ -305,12 +305,14 @@ function isCleanupAuthorizationValid (filename, authorization) {
   try {
     const currentPhysicalRoot = fs.realpathSync(authorization.lexicalRoot)
     const rootStat = fs.statSync(currentPhysicalRoot, { bigint: true })
-    if (currentPhysicalRoot !== authorization.physicalRoot ||
-      rootStat.dev !== authorization.rootDevice || rootStat.ino !== authorization.rootInode) {
+    if (
+      currentPhysicalRoot !== authorization.physicalRoot ||
+      rootStat.dev !== authorization.rootDevice ||
+      rootStat.ino !== authorization.rootInode ||
+      authorization.physicalParent === undefined
+    ) {
       return false
     }
-
-    if (authorization.physicalParent === undefined) return false
     const physicalParent = fs.realpathSync(path.dirname(filename))
     const parentStat = fs.statSync(physicalParent, { bigint: true })
     if (physicalParent !== authorization.physicalParent ||

package/ci/test-optimization-validation/generated-test-contract.js

@@ -124,9 +124,13 @@ function getGeneratedTestContent ({ framework, moduleSystem, scenarioId, stateFi
  */
 function getGeneratedTestContractError (framework) {
   const strategy = framework.generatedTestStrategy
-  if (!strategy || !['planned', 'verified'].includes(strategy.status)) return
-
-  if (!['cucumber', 'cypress', 'jest', 'mocha', 'playwright', 'vitest'].includes(framework.framework)) return
+  if (
+    !strategy ||
+    !['planned', 'verified'].includes(strategy.status) ||
+    !['cucumber', 'cypress', 'jest', 'mocha', 'playwright', 'vitest'].includes(framework.framework)
+  ) {
+    return
+  }
   if (!['commonjs', 'esm'].includes(strategy.moduleSystem)) {
     return 'must retain generatedTestStrategy.moduleSystem as "commonjs" or "esm".'
   }

package/ci/test-optimization-validation/manifest-scaffold.js

@@ -750,8 +750,13 @@ function hasCucumberBrowserSupport (files, retainedInputs, projectRoot) {
 function isTestFile (filename, source, framework, projectRoot, allowDirectoryConvention) {
   const basename = path.basename(filename)
   const normalized = filename.replaceAll('\\', '/')
-  if (normalized.includes('/dd-test-optimization-validation-')) return false
-  if (TYPE_ONLY_TEST_PATTERN.test(basename) || TYPE_ONLY_DIRECTORY_PATTERN.test(normalized)) return false
+  if (
+    normalized.includes('/dd-test-optimization-validation-') ||
+    TYPE_ONLY_TEST_PATTERN.test(basename) ||
+    TYPE_ONLY_DIRECTORY_PATTERN.test(normalized)
+  ) {
+    return false
+  }
   if (framework === 'cucumber') return cucumber.isTestFile(filename)
   if (framework === 'cypress') return cypress.isTestFile(basename, path.dirname(filename), projectRoot)
   if (framework === 'playwright') return playwright.isTestFile(basename, path.dirname(filename), projectRoot)

package/ci/test-optimization-validation/manifest-schema.js

@@ -441,16 +441,15 @@ function validateCiWiring (repositoryRoot, ciWiring, prefix, errors) {
   if (typeof ciWiring.reviewComplete !== 'boolean') errors.push(`${prefix}.reviewComplete must be a boolean.`)
   validateStringArray(ciWiring.unresolved, `${prefix}.unresolved`, errors)
 
-  if (!isObject(ciWiring.initialization) ||
-    !INITIALIZATION_STATUSES.has(ciWiring.initialization.status)) {
-    errors.push(`${prefix}.initialization.status must be configured, not_configured, or unknown.`)
-  } else {
+  if (isObject(ciWiring.initialization) && INITIALIZATION_STATUSES.has(ciWiring.initialization.status)) {
     validateStringArray(ciWiring.initialization.evidence, `${prefix}.initialization.evidence`, errors)
-  }
-  if (!isObject(ciWiring.transport) || !TRANSPORT_MODES.has(ciWiring.transport.mode)) {
-    errors.push(`${prefix}.transport.mode must be agent, agentless, none, or unknown.`)
   } else {
+    errors.push(`${prefix}.initialization.status must be configured, not_configured, or unknown.`)
+  }
+  if (isObject(ciWiring.transport) && TRANSPORT_MODES.has(ciWiring.transport.mode)) {
     validateStringArray(ciWiring.transport.evidence, `${prefix}.transport.evidence`, errors)
+  } else {
+    errors.push(`${prefix}.transport.mode must be agent, agentless, none, or unknown.`)
   }
 }
 

package/ci/test-optimization-validation/report-writer.js

@@ -332,8 +332,12 @@ function getActions (results) {
 function getActionPriority (result, localPasses) {
   if (result.evidence?.possibleLibraryBug) return 0
   if (result.scenario === 'ci-wiring' && localPasses.has(result.frameworkId)) return 0
-  if (result.evidence?.blockerCategory === 'EXECUTION_ENVIRONMENT_BLOCKED') return 1
-  if (result.evidence?.blockerCategory === 'VALIDATOR_LIMITATION') return 1
+  if (
+    result.evidence?.blockerCategory === 'EXECUTION_ENVIRONMENT_BLOCKED' ||
+    result.evidence?.blockerCategory === 'VALIDATOR_LIMITATION'
+  ) {
+    return 1
+  }
   if (result.scenario === 'ci-wiring') return 2
   return 3
 }

package/ci/test-optimization-validation/runner-command.js

@@ -46,8 +46,7 @@ function getGeneratedCommand (framework, scenario) {
  * @returns {Array<[string, object]>} labeled direct-runner commands
  */
 function getFrameworkCommands (framework, requestedScenario = null) {
-  if (framework.status !== 'runnable') return []
-  if (requestedScenario === 'ci-wiring') return []
+  if (framework.status !== 'runnable' || requestedScenario === 'ci-wiring') return []
 
   const commands = [['basic-reporting', getBasicCommand(framework)]]
   const fallbackTests = framework.validation.fallbackTests
@@ -99,8 +98,7 @@ function getManifestInputFiles (manifest, { includeLocal = true } = {}) {
     for (const framework of manifest.frameworks) {
       addExistingFile(files, framework.ciWiring?.configFile)
       addExistingFile(files, framework.project?.packageJson)
-      if (!includeLocal) continue
-      if (framework.status !== 'runnable') continue
+      if (!includeLocal || framework.status !== 'runnable') continue
       addExistingFile(files, framework.validation?.runner)
       addExistingFile(files, framework.validation?.testFile)
       const fallbackTests = framework.validation?.fallbackTests

package/ci/test-optimization-validation/runner-contract.js

@@ -450,8 +450,7 @@ function getRunnerInputError (args, environment, projectRoot, repositoryRoot, co
  * @returns {{error?: string, runnerIndex: number, tokens: string[]}|undefined} parsed invocation
  */
 function getFrameworkInvocation (command, framework) {
-  if (CONTROL_PATTERN.test(String(command || ''))) return
-  if (command === `direct ${framework} binary`) return
+  if (CONTROL_PATTERN.test(String(command || '')) || command === `direct ${framework} binary`) return
   const tokens = tokenizeCommand(command)
   const executable = getRunnerExecutableName(framework)
   const runnerIndex = tokens.findIndex(token => {

package/ci/test-optimization-validation/scenarios/auto-test-retries.js

@@ -100,21 +100,7 @@ async function runAutoTestRetries ({ framework, out, options }) {
       })
     }
 
-    if (run.result.exitCode !== 0) {
-      return failWithDebugRerun({
-        command: scenario.runCommand,
-        fixtureConfig,
-        diagnosis: getAutoTestRetriesFailureDiagnosis(framework, evidence),
-        evidence,
-        framework,
-        options,
-        out,
-        outDir,
-        scenarioName,
-      })
-    }
-
-    if (tests.length < 2 || autoTestRetryEvents.length === 0) {
+    if (run.result.exitCode !== 0 || tests.length < 2 || autoTestRetryEvents.length === 0) {
       return failWithDebugRerun({
         command: scenario.runCommand,
         fixtureConfig,

package/ci/vitest-no-worker-init-setup.mjs

@@ -3,7 +3,7 @@ import { afterEach, beforeAll, beforeEach, inject } from 'vitest'
 // Instrumentation-less setup for DD_EXPERIMENTAL_TEST_OPT_VITEST_NO_WORKER_INIT.
 // It applies Test Optimization execution changes without initializing dd-trace and also supports Browser Mode.
 const VITEST_NO_WORKER_INIT_ACTIVE_ENV = 'DD_TEST_OPT_VITEST_NO_WORKER_INIT_ACTIVE'
-const SERIALIZED_CONTEXT_PREFIX = '\u0000dd-vitest-context:'
+const SERIALIZED_CONTEXT_PREFIX = '\0dd-vitest-context:'
 const providedContext = getProvidedContext()
 const isNoWorkerInitActive = providedContext.isActive ?? getIsNoWorkerInitActive()
 const attemptToFixTests = providedContext.attemptToFixTests || {}
@@ -220,9 +220,8 @@ function getNextAttemptIndex (task) {
  */
 function prepareRumCorrelation (task, attemptIndex) {
   // A per-origin cookie cannot identify overlapping attempts without racing.
-  if (!isRumCorrelationEnabled || isConcurrentTask(task)) return
-
   if (
+    !isRumCorrelationEnabled || isConcurrentTask(task) ||
     typeof window === 'undefined' ||
     typeof document === 'undefined' ||
     typeof rumTestExecutionIdCookieName !== 'string'
@@ -289,8 +288,7 @@ function getRum () {
  * @param {object|undefined} rum
  */
 function getIsRumActive (rum) {
-  if (!rum) return false
-  if (typeof rum.getInternalContext !== 'function') return false
+  if (!rum || typeof rum.getInternalContext !== 'function') return false
 
   try {
     return !!rum.getInternalContext()
@@ -770,8 +768,13 @@ function getEarlyFlakeDetectionSuiteCandidate (suite) {
 
     const testSuite = getTestSuite(task)
     const testName = getTestName(task)
-    if (attemptToFixTests[testSuite]?.[testName] || disabledTests[testSuite]?.[testName]) continue
-    if (!isEarlyFlakeDetectionTest(testSuite, testName)) continue
+    if (
+      attemptToFixTests[testSuite]?.[testName] ||
+      disabledTests[testSuite]?.[testName] ||
+      !isEarlyFlakeDetectionTest(testSuite, testName)
+    ) {
+      continue
+    }
 
     candidate ||= {
       hasNewTest: false,

package/index.d.ts

@@ -218,7 +218,6 @@ interface Tracer extends opentracing.Tracer {
    * @env DD_FEATURE_FLAGS_ENABLED
    * @env DD_FEATURE_FLAGS_CONFIGURATION_SOURCE
    * @env DD_FLAGGING_EVALUATION_COUNTS_ENABLED
-   * @beta This feature is in preview and not ready for production use
    */
   openfeature: tracer.OpenFeatureProvider;
 
@@ -275,7 +274,7 @@ interface Tracer extends opentracing.Tracer {
    *
    * Removes all baggage items from the current context and returns the new context.
    *
-   * @see https://opentelemetry.io/docs/specs/otel/baggage/api/#remove-all-values
+   * @see https://opentelemetry.io/docs/specs/otel/baggage/api/#clear-baggage-in-the-context
    */
   removeAllBaggageItems (): Record<string, string>;
 }
@@ -818,6 +817,22 @@ declare namespace tracer {
      */
     site?: string;
 
+    /**
+     * Feature Flags configuration.
+     */
+    featureFlags?: {
+      /**
+       * Allow boolean true in dd_evaluation_telemetry_opt_out to suppress evaluation events, metrics, and span tags.
+       * The attribute remains available to targeting rules and exposure reporting.
+       * Enabling this option does not change exposure events or flag evaluation results.
+       * Captured when the provider is constructed.
+       * Explicit configuration takes precedence over the environment variable, including false.
+       * @default false
+       * @env DD_FEATURE_FLAGS_EVALUATION_TELEMETRY_PER_SUBJECT_OPT_OUT_ENABLED
+       */
+      enableEvaluationTelemetryOptOutParameter?: boolean
+    }
+
     /**
      * Experimental features can be enabled individually using key / value pairs.
      * @default {}
@@ -890,8 +905,6 @@ declare namespace tracer {
 
       /**
        * Configuration for Feature Flagging & Experimentation.
-       *
-       * @beta This feature is in preview and not ready for production use
        */
       flaggingProvider?: {
         /**
@@ -1728,8 +1741,6 @@ declare namespace tracer {
    *
    * Wraps @datadog/openfeature-node-server with agentless and Agent Remote Config delivery.
    * Implements the OpenFeature Provider interface for flag evaluation.
-   *
-   * @beta This feature is in preview and not ready for production use
    */
   export interface OpenFeatureProvider {
     /**
@@ -2494,14 +2505,14 @@ declare namespace tracer {
     /**
      * This plugin patches the [browser-bunyan](https://github.com/philmander/browser-bunyan)
      * to automatically inject trace identifiers in log records when the
-     * [logInjection](interfaces/traceroptions.html#logInjection) option is enabled
+     * {@link TracerOptions.logInjection | logInjection} option is enabled
      * on the tracer.
      */
     interface browser_bunyan extends Integration {}
 
     /**
      * This plugin automatically instruments the
-     * [bullmq](https://github.com/npmjs/package/bullmq) message queue library.
+     * [bullmq](https://www.npmjs.com/package/bullmq) message queue library.
      */
     interface bullmq extends Instrumentation {
       /**
@@ -2522,7 +2533,7 @@ declare namespace tracer {
     /**
      * This plugin patches the [bunyan](https://github.com/trentm/node-bunyan)
      * to automatically inject trace identifiers in log records when the
-     * [logInjection](interfaces/traceroptions.html#logInjection) option is enabled
+     * {@link TracerOptions.logInjection | logInjection} option is enabled
      * on the tracer.
      */
     interface bunyan extends Integration {}
@@ -2975,7 +2986,7 @@ declare namespace tracer {
 
     /**
      * This plugin automatically instruments the
-     * [langgraph](https://github.com/npmjs/package/langgraph) library.
+     * [langgraph](https://www.npmjs.com/package/@langchain/langgraph) library.
      */
     interface langgraph extends Instrumentation, LLMObsIntegration {}
 
@@ -3011,7 +3022,7 @@ declare namespace tracer {
 
     /**
      * This plugin automatically instruments the
-     * [modelcontextprotocol-sdk](https://github.com/npmjs/package/@modelcontextprotocol/sdk) library.
+     * [modelcontextprotocol-sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk) library.
      */
     interface modelcontextprotocol_sdk extends Instrumentation, LLMObsIntegration {}
 
@@ -3190,7 +3201,7 @@ declare namespace tracer {
     /**
      * This plugin patches the [pino](http://getpino.io)
      * to automatically inject trace identifiers in log records when the
-     * [logInjection](interfaces/traceroptions.html#logInjection) option is enabled
+     * {@link TracerOptions.logInjection | logInjection} option is enabled
      * on the tracer.
      */
     interface pino extends Integration {}
@@ -3361,7 +3372,7 @@ declare namespace tracer {
     /**
      * This plugin patches the [winston](https://github.com/winstonjs/winston)
      * to automatically inject trace identifiers in log records when the
-     * [logInjection](interfaces/traceroptions.html#logInjection) option is enabled
+     * {@link TracerOptions.logInjection | logInjection} option is enabled
      * on the tracer.
      */
     interface winston extends Integration {}
@@ -3652,7 +3663,7 @@ declare namespace tracer {
        * key/value pair separated by an equals sign `=`. Spaces and horizontal tabs
        * surrounding `list-members` are ignored. There can be a maximum of 32
        * `list-members` in a `list`.
-       * More Info: https://www.w3.org/TR/trace-context/#tracestate-field
+       * More Info: https://www.w3.org/TR/trace-context/#tracestate-header
        *
        * Examples:
        *     Single tracing system (generic format):
@@ -3857,7 +3868,8 @@ declare namespace tracer {
 
       /**
        * Sets inputs, outputs, tags, metadata, and metrics as provided for a given LLM Observability span.
-       * Note that with the exception of tags, this method will override any existing values for the provided fields.
+       * Note that with the exception of tags and agent, this method will override any existing values for the provided fields.
+       * Agent fields update earlier agent annotations one top-level field at a time.
        *
        * For example:
        * ```javascript
@@ -3882,7 +3894,7 @@ declare namespace tracer {
        * ```
        *
        * @param span The span to annotate (defaults to the current LLM Observability span if not provided)
-       * @param options An object containing the inputs, outputs, tags, metadata, tool definitions, and metrics to set on the span.
+       * @param options An object containing the inputs, outputs, tags, metadata, tool definitions, metrics, and agent to set on the span.
        */
       annotate (options: llmobs.AnnotationOptions): void
       annotate (span: tracer.Span | undefined, options: llmobs.AnnotationOptions): void
@@ -4808,6 +4820,81 @@ declare namespace tracer {
       version? : string
     }
 
+    interface AgentToolParameter {
+      type?: string,
+      required?: boolean
+    }
+
+    /**
+     * A plain JSON Schema object with `type: 'object'`, which is how it is told apart from a parameter map.
+     * Schema-library objects (for example Zod schemas) must be converted first, for example with
+     * `z.toJSONSchema()`, or they are dropped.
+     */
+    interface AgentToolJsonSchema {
+      type: 'object',
+      properties: { [param: string]: { type?: string, [key: string]: unknown } },
+      required?: string[]
+    }
+
+    interface AgentTool {
+      name: string,
+      description?: string,
+      /**
+       * Parameters as `{ [param]: { type, required } }`, or a JSON Schema object, which is flattened to the
+       * same shape.
+       */
+      parameters?: { [param: string]: AgentToolParameter } | AgentToolJsonSchema
+    }
+
+    /**
+     * Inference parameters reported in an agent manifest. Keys are accepted in snake_case or camelCase and
+     * reported in snake_case. Other keys are dropped, since provider-specific settings can carry secrets.
+     */
+    interface AgentModelSettings {
+      frequency_penalty?: number,
+      frequencyPenalty?: number,
+      logit_bias?: { [token: string]: number },
+      logitBias?: { [token: string]: number },
+      logprobs?: boolean,
+      max_tokens?: number,
+      maxTokens?: number,
+      parallel_tool_calls?: boolean,
+      parallelToolCalls?: boolean,
+      presence_penalty?: number,
+      presencePenalty?: number,
+      seed?: number,
+      stop_sequences?: string[],
+      stopSequences?: string[],
+      temperature?: number,
+      timeout?: number,
+      tool_choice?: string,
+      toolChoice?: string,
+      top_k?: number,
+      topK?: number,
+      top_logprobs?: number,
+      topLogprobs?: number,
+      top_p?: number,
+      topP?: number
+    }
+
+    /**
+     * Declares the agent an `agent` span represents, reported as the agent's manifest. Only applies to
+     * `agent` spans. Unreportable values are dropped with a warning, and unset values (`undefined`, `null`,
+     * `''`, `[]`) leave what an earlier annotation declared in place.
+     */
+    interface Agent {
+      /** The agent's name. Defaults to the agent span's name. */
+      name?: string,
+      /** The system instructions the agent runs with. */
+      instructions?: string,
+      /** The model the agent is configured to call. */
+      model?: string,
+      /** Inference parameters. Replaces the settings an earlier annotation declared as a whole. */
+      modelSettings?: AgentModelSettings,
+      /** The tools the agent can call. Replaces tools declared by an earlier annotation. */
+      tools?: AgentTool[]
+    }
+
     /**
      * Annotation options for LLM Observability spans.
      */
@@ -4858,7 +4945,12 @@ declare namespace tracer {
        * A list of ToolDefinition object that represents the tools available to the LLM for this span
        * Each definition requires a `name` and optionally accepts `description`, `schema`, and `version`.
        * */
-      toolDefinitions?: ToolDefinition[]
+      toolDefinitions?: ToolDefinition[],
+
+      /**
+       * Declares the agent this span represents. Only used on `agent` spans.
+       */
+      agent?: Agent
     }
 
     interface AnnotationContextOptions {
@@ -4883,6 +4975,13 @@ declare namespace tracer {
        * A Prompt object that represents the prompt used for an LLM call. Only used on `llm` spans.
        */
       prompt?: Prompt,
+
+      /**
+       * Declares the agent running in this context, read when the context is entered. The manifest is
+       * reported on every `agent` span in the context, nested ones included. Use `annotate` on a nested agent
+       * span to declare its own agent.
+       */
+      agent?: Agent,
     }
 
     interface RoutingContextOptions {

package/initialize.mjs

@@ -101,8 +101,6 @@ if (isMainThread) {
   // Only register the loader hook when instrumentation initialized. On a bailout the
   // loader has nothing to instrument and can keep a short-lived process from exiting.
   if (Module.register && initialized) {
-    // The loader builds its own include/exclude matcher in `initialize`, so no
-    // options need to cross the registration boundary.
-    Module.register('./loader-hook.mjs', import.meta.url)
+    require('./register.js')
   }
 }

package/openfeature/rules-based.d.ts

@@ -0,0 +1,11 @@
+export {
+  configurationToString,
+  ConfigurationFetchError,
+  fetchRulesConfiguration,
+} from '../vendor/dist/@datadog/openfeature-node-server/rules-based';
+export type {
+  ConfigurationFetchErrorCode,
+  FlagsConfiguration,
+  FlagsConfigurationWire,
+  RulesConfigurationFetchOptions,
+} from '../vendor/dist/@datadog/openfeature-node-server/rules-based';

package/openfeature/rules-based.js

@@ -0,0 +1,7 @@
+'use strict'
+
+const rules = require('../vendor/dist/@datadog/openfeature-node-server/rules-based')
+
+exports.configurationToString = rules.configurationToString
+exports.ConfigurationFetchError = rules.ConfigurationFetchError
+exports.fetchRulesConfiguration = rules.fetchRulesConfiguration