@microsoft/agents-a365-observability 0.1.0-preview.95 → 0.2.0-preview.3

package/dist/esm/configuration/ObservabilityConfiguration.js

@@ -0,0 +1,56 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+// Default constants
+const PROD_OBSERVABILITY_SCOPE = 'https://api.powerplatform.com/.default';
+/**
+ * Configuration for observability package.
+ * Inherits runtime settings and adds observability-specific settings.
+ */
+export class ObservabilityConfiguration extends RuntimeConfiguration {
+    get observabilityOverrides() {
+        return this.overrides;
+    }
+    constructor(overrides) {
+        super(overrides);
+    }
+    // Inherited: clusterCategory, isDevelopmentEnvironment, isNodeEnvDevelopment
+    /**
+     * Gets the observability authentication scopes.
+     * Used by AgenticTokenCache for observability service authentication.
+     */
+    get observabilityAuthenticationScopes() {
+        const result = this.observabilityOverrides.observabilityAuthenticationScopes?.();
+        if (result !== undefined) {
+            return result;
+        }
+        const override = process.env.A365_OBSERVABILITY_SCOPES_OVERRIDE;
+        if (override?.trim()) {
+            return override.trim().split(/\s+/);
+        }
+        return [PROD_OBSERVABILITY_SCOPE];
+    }
+    get isObservabilityExporterEnabled() {
+        const result = this.observabilityOverrides.isObservabilityExporterEnabled?.();
+        if (result !== undefined)
+            return result;
+        return RuntimeConfiguration.parseEnvBoolean(process.env.ENABLE_A365_OBSERVABILITY_EXPORTER);
+    }
+    get observabilityDomainOverride() {
+        const result = this.observabilityOverrides.observabilityDomainOverride?.();
+        if (result !== undefined) {
+            return result;
+        }
+        const override = process.env.A365_OBSERVABILITY_DOMAIN_OVERRIDE;
+        if (override?.trim()) {
+            return override.trim().replace(/\/+$/, '');
+        }
+        return null;
+    }
+    get observabilityLogLevel() {
+        return this.observabilityOverrides.observabilityLogLevel?.()
+            ?? process.env.A365_OBSERVABILITY_LOG_LEVEL
+            ?? 'none';
+    }
+}
+//# sourceMappingURL=ObservabilityConfiguration.js.map

package/dist/esm/configuration/ObservabilityConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/ObservabilityConfiguration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,oBAAoB;AACpB,MAAM,wBAAwB,GAAG,wCAAwC,CAAC;AAE1E;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,oBAAoB;IAClE,IAAc,sBAAsB;QAClC,OAAO,IAAI,CAAC,SAA8C,CAAC;IAC7D,CAAC;IAED,YAAY,SAA6C;QACvD,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;IAED,6EAA6E;IAE7E;;;OAGG;IACH,IAAI,iCAAiC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,iCAAiC,EAAE,EAAE,CAAC;QACjF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;QAChE,IAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,8BAA8B;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,8BAA8B,EAAE,EAAE,CAAC;QAC9E,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,OAAO,oBAAoB,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,2BAA2B;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,2BAA2B,EAAE,EAAE,CAAC;QAC3E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;QAChE,IAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,EAAE;eACvD,OAAO,CAAC,GAAG,CAAC,4BAA4B;eACxC,MAAM,CAAC;IACd,CAAC;CAEF"}

package/dist/esm/configuration/ObservabilityConfigurationOptions.d.ts

@@ -0,0 +1,58 @@
+import { RuntimeConfigurationOptions } from '@microsoft/agents-a365-runtime';
+/**
+ * Observability configuration options - extends runtime options.
+ * All overrides are functions called on each property access.
+ *
+ * Inherited from RuntimeConfigurationOptions:
+ * - clusterCategory
+ * - isNodeEnvDevelopment
+ *
+ * Note: `isDevelopmentEnvironment` is a derived getter on the configuration class
+ * (based on clusterCategory), not an overridable option.
+ */
+export type ObservabilityConfigurationOptions = RuntimeConfigurationOptions & {
+    /**
+     * Override for observability authentication scopes.
+     * Used by AgenticTokenCache for observability service authentication.
+     *
+     * @returns Array of OAuth scopes for observability service authentication.
+     * @envvar A365_OBSERVABILITY_SCOPES_OVERRIDE - Space-separated list of scopes.
+     * @default ['https://api.powerplatform.com/.default']
+     */
+    observabilityAuthenticationScopes?: () => string[];
+    /**
+     * Override to enable/disable the Agent365 observability span exporter.
+     * When enabled, spans are exported to the Agent365 observability service.
+     *
+     * @returns `true` to enable the exporter, `false` to disable.
+     * @envvar ENABLE_A365_OBSERVABILITY_EXPORTER - 'true', '1', 'yes', 'on' to enable.
+     * @default false
+     */
+    isObservabilityExporterEnabled?: () => boolean;
+    /**
+     * Override for the custom observability domain/endpoint.
+     * Trailing slashes are automatically removed.
+     *
+     * @returns Custom domain URL string, or `null` for no override.
+     * @envvar A365_OBSERVABILITY_DOMAIN_OVERRIDE - Full URL of custom endpoint.
+     * @default null
+     */
+    observabilityDomainOverride?: () => string | null;
+    /**
+     * Override for the internal SDK log level.
+     * Controls which log messages are output by the observability SDK's internal logger.
+     *
+     * Supported values (pipe-separated for multiple):
+     * - 'none' - No logging (default)
+     * - 'info' - Information messages
+     * - 'warn' - Warning messages
+     * - 'error' - Error messages
+     * - 'info|warn|error' - All messages
+     *
+     * @returns Log level string.
+     * @envvar A365_OBSERVABILITY_LOG_LEVEL
+     * @default 'none'
+     */
+    observabilityLogLevel?: () => string;
+};
+//# sourceMappingURL=ObservabilityConfigurationOptions.d.ts.map

package/dist/esm/configuration/ObservabilityConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/ObservabilityConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iCAAiC,GAAG,2BAA2B,GAAG;IAC5E;;;;;;;OAOG;IACH,iCAAiC,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAEnD;;;;;;;OAOG;IACH,8BAA8B,CAAC,EAAE,MAAM,OAAO,CAAC;IAE/C;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAElD;;;;;;;;;;;;;;OAcG;IACH,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC;CACtC,CAAC"}

package/dist/esm/configuration/ObservabilityConfigurationOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=ObservabilityConfigurationOptions.js.map

package/dist/esm/configuration/ObservabilityConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityConfigurationOptions.js","sourceRoot":"","sources":["../../../src/configuration/ObservabilityConfigurationOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/esm/configuration/PerRequestSpanProcessorConfiguration.d.ts

@@ -0,0 +1,22 @@
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+import { PerRequestSpanProcessorConfigurationOptions } from './PerRequestSpanProcessorConfigurationOptions';
+/**
+ * Configuration for PerRequestSpanProcessor.
+ * Inherits runtime settings (clusterCategory, isNodeEnvDevelopment) and adds
+ * per-request processor guardrails.
+ *
+ * This is separated from ObservabilityConfiguration because PerRequestSpanProcessor
+ * is used only in specific scenarios and these settings should not be exposed
+ * in the common ObservabilityConfiguration.
+ */
+export declare class PerRequestSpanProcessorConfiguration extends RuntimeConfiguration {
+    protected get perRequestOverrides(): PerRequestSpanProcessorConfigurationOptions;
+    constructor(overrides?: PerRequestSpanProcessorConfigurationOptions);
+    get isPerRequestExportEnabled(): boolean;
+    get perRequestMaxTraces(): number;
+    get perRequestMaxSpansPerTrace(): number;
+    get perRequestMaxConcurrentExports(): number;
+    get perRequestFlushGraceMs(): number;
+    get perRequestMaxTraceAgeMs(): number;
+}
+//# sourceMappingURL=PerRequestSpanProcessorConfiguration.d.ts.map

package/dist/esm/configuration/PerRequestSpanProcessorConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestSpanProcessorConfiguration.d.ts","sourceRoot":"","sources":["../../../src/configuration/PerRequestSpanProcessorConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,2CAA2C,EAAE,MAAM,+CAA+C,CAAC;AAU5G;;;;;;;;GAQG;AACH,qBAAa,oCAAqC,SAAQ,oBAAoB;IAC5E,SAAS,KAAK,mBAAmB,IAAI,2CAA2C,CAY/E;gBAEW,SAAS,CAAC,EAAE,2CAA2C;IAInE,IAAI,yBAAyB,IAAI,OAAO,CAIvC;IAED,IAAI,mBAAmB,IAAI,MAAM,CAIhC;IAED,IAAI,0BAA0B,IAAI,MAAM,CAIvC;IAED,IAAI,8BAA8B,IAAI,MAAM,CAI3C;IAED,IAAI,sBAAsB,IAAI,MAAM,CAInC;IAED,IAAI,uBAAuB,IAAI,MAAM,CAIpC;CACF"}

package/dist/esm/configuration/PerRequestSpanProcessorConfiguration.js

@@ -0,0 +1,69 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { RuntimeConfiguration } from '@microsoft/agents-a365-runtime';
+import { getPerRequestProcessorInternalOverrides } from '../internal/PerRequestProcessorInternalOverrides';
+/** Guardrails to prevent unbounded memory growth / export bursts. Used for PerRequestSpanProcessor only. */
+const DEFAULT_MAX_BUFFERED_TRACES = 1000;
+const DEFAULT_MAX_SPANS_PER_TRACE = 5000;
+const DEFAULT_MAX_CONCURRENT_EXPORTS = 20;
+const DEFAULT_FLUSH_GRACE_MS = 250;
+const DEFAULT_MAX_TRACE_AGE_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Configuration for PerRequestSpanProcessor.
+ * Inherits runtime settings (clusterCategory, isNodeEnvDevelopment) and adds
+ * per-request processor guardrails.
+ *
+ * This is separated from ObservabilityConfiguration because PerRequestSpanProcessor
+ * is used only in specific scenarios and these settings should not be exposed
+ * in the common ObservabilityConfiguration.
+ */
+export class PerRequestSpanProcessorConfiguration extends RuntimeConfiguration {
+    get perRequestOverrides() {
+        const internal = getPerRequestProcessorInternalOverrides();
+        const instanceOverrides = this.overrides;
+        return {
+            ...(instanceOverrides ?? {}),
+            ...(internal?.isPerRequestExportEnabled !== undefined && { isPerRequestExportEnabled: internal.isPerRequestExportEnabled }),
+            ...(internal?.perRequestMaxTraces !== undefined && { perRequestMaxTraces: internal.perRequestMaxTraces }),
+            ...(internal?.perRequestMaxSpansPerTrace !== undefined && { perRequestMaxSpansPerTrace: internal.perRequestMaxSpansPerTrace }),
+            ...(internal?.perRequestMaxConcurrentExports !== undefined && { perRequestMaxConcurrentExports: internal.perRequestMaxConcurrentExports }),
+            ...(internal?.perRequestFlushGraceMs !== undefined && { perRequestFlushGraceMs: internal.perRequestFlushGraceMs }),
+            ...(internal?.perRequestMaxTraceAgeMs !== undefined && { perRequestMaxTraceAgeMs: internal.perRequestMaxTraceAgeMs }),
+        };
+    }
+    constructor(overrides) {
+        super(overrides);
+    }
+    get isPerRequestExportEnabled() {
+        const result = this.perRequestOverrides.isPerRequestExportEnabled?.();
+        if (result !== undefined)
+            return result;
+        return RuntimeConfiguration.parseEnvBoolean(process.env.ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT);
+    }
+    get perRequestMaxTraces() {
+        const value = this.perRequestOverrides.perRequestMaxTraces?.()
+            ?? RuntimeConfiguration.parseEnvInt(process.env.A365_PER_REQUEST_MAX_TRACES, DEFAULT_MAX_BUFFERED_TRACES);
+        return value > 0 ? value : DEFAULT_MAX_BUFFERED_TRACES;
+    }
+    get perRequestMaxSpansPerTrace() {
+        const value = this.perRequestOverrides.perRequestMaxSpansPerTrace?.()
+            ?? RuntimeConfiguration.parseEnvInt(process.env.A365_PER_REQUEST_MAX_SPANS_PER_TRACE, DEFAULT_MAX_SPANS_PER_TRACE);
+        return value > 0 ? value : DEFAULT_MAX_SPANS_PER_TRACE;
+    }
+    get perRequestMaxConcurrentExports() {
+        const value = this.perRequestOverrides.perRequestMaxConcurrentExports?.()
+            ?? RuntimeConfiguration.parseEnvInt(process.env.A365_PER_REQUEST_MAX_CONCURRENT_EXPORTS, DEFAULT_MAX_CONCURRENT_EXPORTS);
+        return value > 0 ? value : DEFAULT_MAX_CONCURRENT_EXPORTS;
+    }
+    get perRequestFlushGraceMs() {
+        const value = this.perRequestOverrides.perRequestFlushGraceMs?.()
+            ?? RuntimeConfiguration.parseEnvInt(process.env.A365_PER_REQUEST_FLUSH_GRACE_MS, DEFAULT_FLUSH_GRACE_MS);
+        return value > 0 ? value : DEFAULT_FLUSH_GRACE_MS;
+    }
+    get perRequestMaxTraceAgeMs() {
+        const value = this.perRequestOverrides.perRequestMaxTraceAgeMs?.()
+            ?? RuntimeConfiguration.parseEnvInt(process.env.A365_PER_REQUEST_MAX_TRACE_AGE_MS, DEFAULT_MAX_TRACE_AGE_MS);
+        return value > 0 ? value : DEFAULT_MAX_TRACE_AGE_MS;
+    }
+}
+//# sourceMappingURL=PerRequestSpanProcessorConfiguration.js.map

package/dist/esm/configuration/PerRequestSpanProcessorConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestSpanProcessorConfiguration.js","sourceRoot":"","sources":["../../../src/configuration/PerRequestSpanProcessorConfiguration.ts"],"names":[],"mappings":"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"}

package/dist/esm/configuration/PerRequestSpanProcessorConfigurationOptions.d.ts

@@ -0,0 +1,71 @@
+import { RuntimeConfigurationOptions } from '@microsoft/agents-a365-runtime';
+/**
+ * Configuration options for PerRequestSpanProcessor - extends runtime options.
+ * All overrides are functions called on each property access.
+ *
+ * Inherited from RuntimeConfigurationOptions:
+ * - clusterCategory, isNodeEnvDevelopment
+ */
+export type PerRequestSpanProcessorConfigurationOptions = RuntimeConfigurationOptions & {
+    /**
+     * Override to enable/disable per-request export mode.
+     * When enabled, spans are buffered per-request and exported when the request completes,
+     * rather than using a batch processor.
+     *
+     * @returns `true` to enable per-request export, `false` for batch export.
+     * @envvar ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT - 'true', '1', 'yes', 'on' to enable.
+     * @default false
+     */
+    isPerRequestExportEnabled?: () => boolean;
+    /**
+     * Override for maximum number of traces to buffer in per-request export mode.
+     * When this limit is reached, oldest traces are dropped.
+     * Values <= 0 are ignored and the default is used.
+     *
+     * @returns Maximum number of buffered traces.
+     * @envvar A365_PER_REQUEST_MAX_TRACES
+     * @default 1000
+     */
+    perRequestMaxTraces?: () => number;
+    /**
+     * Override for maximum number of spans per trace in per-request export mode.
+     * Traces with more spans than this limit will have excess spans dropped.
+     * Values <= 0 are ignored and the default is used.
+     *
+     * @returns Maximum spans per trace.
+     * @envvar A365_PER_REQUEST_MAX_SPANS_PER_TRACE
+     * @default 5000
+     */
+    perRequestMaxSpansPerTrace?: () => number;
+    /**
+     * Override for maximum concurrent export operations in per-request export mode.
+     * Limits the number of parallel HTTP requests to the observability service.
+     * Values <= 0 are ignored and the default is used.
+     *
+     * @returns Maximum concurrent exports.
+     * @envvar A365_PER_REQUEST_MAX_CONCURRENT_EXPORTS
+     * @default 20
+     */
+    perRequestMaxConcurrentExports?: () => number;
+    /**
+     * Override for grace period (ms) to wait for child spans after root span ends.
+     * After the root span ends, the processor waits this long for remaining children
+     * before flushing the trace. Values <= 0 are ignored and the default is used.
+     *
+     * @returns Flush grace period in milliseconds.
+     * @envvar A365_PER_REQUEST_FLUSH_GRACE_MS
+     * @default 250
+     */
+    perRequestFlushGraceMs?: () => number;
+    /**
+     * Override for maximum age (ms) for a trace before forcing flush.
+     * Traces older than this are flushed regardless of whether all spans have ended.
+     * Values <= 0 are ignored and the default is used.
+     *
+     * @returns Maximum trace age in milliseconds.
+     * @envvar A365_PER_REQUEST_MAX_TRACE_AGE_MS
+     * @default 1800000 (30 minutes)
+     */
+    perRequestMaxTraceAgeMs?: () => number;
+};
+//# sourceMappingURL=PerRequestSpanProcessorConfigurationOptions.d.ts.map

package/dist/esm/configuration/PerRequestSpanProcessorConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestSpanProcessorConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../src/configuration/PerRequestSpanProcessorConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,MAAM,2CAA2C,GAAG,2BAA2B,GAAG;IACtF;;;;;;;;OAQG;IACH,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC;IAE1C;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IAEnC;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,MAAM,CAAC;IAE1C;;;;;;;;OAQG;IACH,8BAA8B,CAAC,EAAE,MAAM,MAAM,CAAC;IAE9C;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,MAAM,MAAM,CAAC;IAEtC;;;;;;;;OAQG;IACH,uBAAuB,CAAC,EAAE,MAAM,MAAM,CAAC;CACxC,CAAC"}

package/dist/esm/configuration/PerRequestSpanProcessorConfigurationOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=PerRequestSpanProcessorConfigurationOptions.js.map

package/dist/esm/configuration/PerRequestSpanProcessorConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestSpanProcessorConfigurationOptions.js","sourceRoot":"","sources":["../../../src/configuration/PerRequestSpanProcessorConfigurationOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/esm/configuration/index.d.ts

@@ -0,0 +1,16 @@
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { ObservabilityConfiguration } from './ObservabilityConfiguration';
+import { PerRequestSpanProcessorConfiguration } from './PerRequestSpanProcessorConfiguration';
+export * from './ObservabilityConfigurationOptions';
+export * from './ObservabilityConfiguration';
+export * from './PerRequestSpanProcessorConfigurationOptions';
+export * from './PerRequestSpanProcessorConfiguration';
+/**
+ * Shared default provider for ObservabilityConfiguration.
+ */
+export declare const defaultObservabilityConfigurationProvider: DefaultConfigurationProvider<ObservabilityConfiguration>;
+/**
+ * Shared default provider for PerRequestSpanProcessorConfiguration.
+ */
+export declare const defaultPerRequestSpanProcessorConfigurationProvider: DefaultConfigurationProvider<PerRequestSpanProcessorConfiguration>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/configuration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAE9F,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wCAAwC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,yCAAyC,0DACoB,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,mDAAmD,oEACoB,CAAC"}

package/dist/esm/configuration/index.js

@@ -0,0 +1,18 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { DefaultConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { ObservabilityConfiguration } from './ObservabilityConfiguration';
+import { PerRequestSpanProcessorConfiguration } from './PerRequestSpanProcessorConfiguration';
+export * from './ObservabilityConfigurationOptions';
+export * from './ObservabilityConfiguration';
+export * from './PerRequestSpanProcessorConfigurationOptions';
+export * from './PerRequestSpanProcessorConfiguration';
+/**
+ * Shared default provider for ObservabilityConfiguration.
+ */
+export const defaultObservabilityConfigurationProvider = new DefaultConfigurationProvider(() => new ObservabilityConfiguration());
+/**
+ * Shared default provider for PerRequestSpanProcessorConfiguration.
+ */
+export const defaultPerRequestSpanProcessorConfigurationProvider = new DefaultConfigurationProvider(() => new PerRequestSpanProcessorConfiguration());
+//# sourceMappingURL=index.js.map

package/dist/esm/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAE9F,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wCAAwC,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,yCAAyC,GACpD,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,0BAA0B,EAAE,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,CAAC,MAAM,mDAAmD,GAC9D,IAAI,4BAA4B,CAAC,GAAG,EAAE,CAAC,IAAI,oCAAoC,EAAE,CAAC,CAAC"}

package/dist/esm/index.d.ts

@@ -2,13 +2,21 @@ export { ObservabilityManager } from './ObservabilityManager';
 export { ObservabilityBuilder as Builder, BuilderOptions } from './ObservabilityBuilder';
 export { Agent365ExporterOptions } from './tracing/exporter/Agent365ExporterOptions';
 export { OpenTelemetryConstants } from './tracing/constants';
+export { ExporterEventNames } from './tracing/exporter/ExporterEventNames';
 export { BaggageBuilder, BaggageScope } from './tracing/middleware/BaggageBuilder';
-export { runWithExportToken, getExportToken } from './tracing/context/token-context';
+export { runWithExportToken, updateExportToken, getExportToken } from './tracing/context/token-context';
 export { ParentSpanRef, runWithParentSpanRef, createContextWithParentSpanRef } from './tracing/context/parent-span-context';
-export { ExecutionType, InvocationRole, SourceMetadata, AgentRequest, AgentDetails, TenantDetails, ToolCallDetails, InvokeAgentDetails, CallerDetails, EnhancedAgentDetails, ServiceEndpoint, InferenceDetails, InferenceOperationType, InferenceResponse } from './tracing/contracts';
+export { HeadersCarrier, ParentContext, injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext } from './tracing/context/trace-context-propagation';
+export { InvocationRole, Channel, Request, AgentDetails, ToolCallDetails, InvokeAgentScopeDetails, UserDetails, CallerDetails, EnhancedAgentDetails, ServiceEndpoint, InferenceDetails, InferenceOperationType, InferenceResponse, OutputResponse, SpanDetails, MessageRole, FinishReason, Modality, TextPart, ToolCallRequestPart, ToolCallResponsePart, ReasoningPart, BlobPart, FilePart, UriPart, ServerToolCallPart, ServerToolCallResponsePart, GenericServerToolCall, GenericServerToolCallResponse, GenericPart, MessagePart, ChatMessage, OutputMessage, InputMessages, OutputMessages, InputMessagesParam, OutputMessagesParam, ResponseMessagesParam, A365_MESSAGE_SCHEMA_VERSION, } from './tracing/contracts';
 export { OpenTelemetryScope } from './tracing/scopes/OpenTelemetryScope';
 export { ExecuteToolScope } from './tracing/scopes/ExecuteToolScope';
 export { InvokeAgentScope } from './tracing/scopes/InvokeAgentScope';
 export { InferenceScope } from './tracing/scopes/InferenceScope';
-export { logger, setLogger, getLogger, resetLogger, ILogger, formatError } from './utils/logging';
+export { OutputScope } from './tracing/scopes/OutputScope';
+export { logger, setLogger, getLogger, resetLogger, formatError } from './utils/logging';
+export type { ILogger } from './utils/logging';
+export { safeSerializeToJson } from './tracing/util';
+export { serializeMessages, normalizeInputMessages, normalizeOutputMessages } from './tracing/message-utils';
+export { isPerRequestExportEnabled, MAX_SPAN_SIZE_BYTES } from './tracing/exporter/utils';
+export * from './configuration';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGnF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGrF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAG5H,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAC,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGnF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGxG,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAG5H,OAAO,EACL,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,cAAc,EACd,OAAO,EACP,OAAO,EACP,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,aAAa,EAEb,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,EAC7B,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG7G,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG1F,cAAc,iBAAiB,CAAC"}

package/dist/esm/index.js

@@ -1,24 +1,36 @@
-// ------------------------------------------------------------------------------
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
 // Main SDK classes
 export { ObservabilityManager } from './ObservabilityManager';
 export { ObservabilityBuilder as Builder } from './ObservabilityBuilder';
 export { Agent365ExporterOptions } from './tracing/exporter/Agent365ExporterOptions';
 // Tracing constants
 export { OpenTelemetryConstants } from './tracing/constants';
+export { ExporterEventNames } from './tracing/exporter/ExporterEventNames';
 // Baggage builder
 export { BaggageBuilder, BaggageScope } from './tracing/middleware/BaggageBuilder';
 // Per-request export utilities
-export { runWithExportToken, getExportToken } from './tracing/context/token-context';
+export { runWithExportToken, updateExportToken, getExportToken } from './tracing/context/token-context';
 // Parent span context utilities
 export { runWithParentSpanRef, createContextWithParentSpanRef } from './tracing/context/parent-span-context';
+// Trace context propagation utilities (W3C traceparent/tracestate)
+export { injectContextToHeaders, extractContextFromHeaders, runWithExtractedTraceContext } from './tracing/context/trace-context-propagation';
 // Contracts and interfaces
-export { ExecutionType, InvocationRole, InferenceOperationType } from './tracing/contracts';
+export { InvocationRole, InferenceOperationType, 
+// OTEL gen-ai message format types
+MessageRole, FinishReason, Modality, A365_MESSAGE_SCHEMA_VERSION, } from './tracing/contracts';
 // Scopes
 export { OpenTelemetryScope } from './tracing/scopes/OpenTelemetryScope';
 export { ExecuteToolScope } from './tracing/scopes/ExecuteToolScope';
 export { InvokeAgentScope } from './tracing/scopes/InvokeAgentScope';
 export { InferenceScope } from './tracing/scopes/InferenceScope';
+export { OutputScope } from './tracing/scopes/OutputScope';
 export { logger, setLogger, getLogger, resetLogger, formatError } from './utils/logging';
+export { safeSerializeToJson } from './tracing/util';
+// Message utilities
+export { serializeMessages, normalizeInputMessages, normalizeOutputMessages } from './tracing/message-utils';
+// Exporter utilities
+export { isPerRequestExportEnabled, MAX_SPAN_SIZE_BYTES } from './tracing/exporter/utils';
+// Configuration
+export * from './configuration';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAkB,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnF,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAErF,gCAAgC;AAChC,OAAO,EAAiB,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAE5H,2BAA2B;AAC3B,OAAO,EACL,aAAa,EACb,cAAc,EAWd,sBAAsB,EAEvB,MAAM,qBAAqB,CAAC;AAE7B,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAC,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAW,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAkB,MAAM,wBAAwB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnF,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAExG,gCAAgC;AAChC,OAAO,EAAiB,oBAAoB,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAE5H,mEAAmE;AACnE,OAAO,EAGL,sBAAsB,EACtB,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,6CAA6C,CAAC;AAErD,2BAA2B;AAC3B,OAAO,EACL,cAAc,EAYd,sBAAsB;AAItB,mCAAmC;AACnC,WAAW,EACX,YAAY,EACZ,QAAQ,EAqBR,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAE7G,qBAAqB;AACrB,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE1F,gBAAgB;AAChB,cAAc,iBAAiB,CAAC"}

package/dist/esm/internal/PerRequestProcessorInternalOverrides.d.ts

@@ -0,0 +1,4 @@
+import type { PerRequestSpanProcessorConfigurationOptions } from '../configuration/PerRequestSpanProcessorConfigurationOptions';
+export declare function setPerRequestProcessorInternalOverrides(value?: PerRequestSpanProcessorConfigurationOptions): void;
+export declare function getPerRequestProcessorInternalOverrides(): PerRequestSpanProcessorConfigurationOptions | undefined;
+//# sourceMappingURL=PerRequestProcessorInternalOverrides.d.ts.map

package/dist/esm/internal/PerRequestProcessorInternalOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestProcessorInternalOverrides.d.ts","sourceRoot":"","sources":["../../../src/internal/PerRequestProcessorInternalOverrides.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2CAA2C,EAAE,MAAM,8DAA8D,CAAC;AAKhI,wBAAgB,uCAAuC,CAAC,KAAK,CAAC,EAAE,2CAA2C,QAE1G;AAED,wBAAgB,uCAAuC,IAAI,2CAA2C,GAAG,SAAS,CAEjH"}

package/dist/esm/internal/PerRequestProcessorInternalOverrides.js

@@ -0,0 +1,11 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+let overrides;
+// Only for tests / internal usage
+export function setPerRequestProcessorInternalOverrides(value) {
+    overrides = value;
+}
+export function getPerRequestProcessorInternalOverrides() {
+    return overrides;
+}
+//# sourceMappingURL=PerRequestProcessorInternalOverrides.js.map

package/dist/esm/internal/PerRequestProcessorInternalOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerRequestProcessorInternalOverrides.js","sourceRoot":"","sources":["../../../src/internal/PerRequestProcessorInternalOverrides.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,IAAI,SAAkE,CAAC;AAEvE,kCAAkC;AAClC,MAAM,UAAU,uCAAuC,CAAC,KAAmD;IACzG,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,uCAAuC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/tracing/PerRequestSpanProcessor.d.ts

@@ -1,5 +1,7 @@
 import { type Context } from '@opentelemetry/api';
 import type { ReadableSpan, SpanProcessor, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { IConfigurationProvider } from '@microsoft/agents-a365-runtime';
+import { PerRequestSpanProcessorConfiguration } from '../configuration';
 /**
  * Buffers spans per trace and exports once the request completes.
  * Token is not stored; we export under the saved request Context so that getExportToken()
@@ -7,17 +9,22 @@ import type { ReadableSpan, SpanProcessor, SpanExporter } from '@opentelemetry/s
  */
 export declare class PerRequestSpanProcessor implements SpanProcessor {
     private readonly exporter;
-    private readonly flushGraceMs;
-    private readonly maxTraceAgeMs;
     private traces;
     private sweepTimer?;
     private isSweeping;
     private readonly maxBufferedTraces;
     private readonly maxSpansPerTrace;
     private readonly maxConcurrentExports;
+    private readonly flushGraceMs;
+    private readonly maxTraceAgeMs;
     private inFlightExports;
     private exportWaiters;
-    constructor(exporter: SpanExporter, flushGraceMs?: number, maxTraceAgeMs?: number);
+    /**
+     * Construct a PerRequestSpanProcessor.
+     * @param exporter The span exporter to use.
+     * @param configProvider Optional configuration provider. Defaults to defaultPerRequestSpanProcessorConfigurationProvider if not specified.
+     */
+    constructor(exporter: SpanExporter, configProvider?: IConfigurationProvider<PerRequestSpanProcessorConfiguration>);
     onStart(span: ReadableSpan, ctx: Context): void;
     onEnd(span: ReadableSpan): void;
     forceFlush(): Promise<void>;

package/dist/esm/tracing/PerRequestSpanProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PerRequestSpanProcessor.d.ts","sourceRoot":"","sources":["../../../src/tracing/PerRequestSpanProcessor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAqC/F;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAazD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAdhC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAE9C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAyB;gBAG3B,QAAQ,EAAE,YAAY,EACtB,YAAY,GAAE,MAA+B,EAC7C,aAAa,GAAE,MAAiC;IASnE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IA6C/C,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA4CzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,oBAAoB;YAOd,KAAK;YAmCL,UAAU;YA4DV,iBAAiB;IAe/B,OAAO,CAAC,iBAAiB;CAM1B"}
+{"version":3,"file":"PerRequestSpanProcessor.d.ts","sourceRoot":"","sources":["../../../src/tracing/PerRequestSpanProcessor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,oCAAoC,EAAuD,MAAM,kBAAkB,CAAC;AAoB7H;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAoBzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAyB;IAE9C;;;;OAIG;gBAEgB,QAAQ,EAAE,YAAY,EACvC,cAAc,CAAC,EAAE,sBAAsB,CAAC,oCAAoC,CAAC;IAW/E,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IA6C/C,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA4CzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,oBAAoB;YAOd,KAAK;YAmCL,UAAU;YA4DV,iBAAiB;IAe/B,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/esm/tracing/PerRequestSpanProcessor.js

@@ -4,21 +4,7 @@
 // ------------------------------------------------------------------------------
 import { context } from '@opentelemetry/api';
 import logger from '../utils/logging';
-/** Default grace period (ms) to wait for child spans after root span ends */
-const DEFAULT_FLUSH_GRACE_MS = 250;
-/** Default maximum age (ms) for a trace before forcing flush */
-const DEFAULT_MAX_TRACE_AGE_MS = 30 * 60 * 1000; // 30 minutes
-/** Guardrails to prevent unbounded memory growth / export bursts */
-const DEFAULT_MAX_BUFFERED_TRACES = 1000;
-const DEFAULT_MAX_SPANS_PER_TRACE = 5000;
-const DEFAULT_MAX_CONCURRENT_EXPORTS = 20;
-function readEnvInt(name, fallback) {
-    const raw = process.env[name];
-    if (!raw)
-        return fallback;
-    const parsed = Number.parseInt(raw, 10);
-    return Number.isFinite(parsed) ? parsed : fallback;
-}
+import { defaultPerRequestSpanProcessorConfigurationProvider } from '../configuration';
 function isRootSpan(span) {
     return !span.parentSpanContext;
 }
@@ -28,19 +14,24 @@ function isRootSpan(span) {
  * can read the token from the active OpenTelemetry Context at export time.
  */
 export class PerRequestSpanProcessor {
-    constructor(exporter, flushGraceMs = DEFAULT_FLUSH_GRACE_MS, maxTraceAgeMs = DEFAULT_MAX_TRACE_AGE_MS) {
+    /**
+     * Construct a PerRequestSpanProcessor.
+     * @param exporter The span exporter to use.
+     * @param configProvider Optional configuration provider. Defaults to defaultPerRequestSpanProcessorConfigurationProvider if not specified.
+     */
+    constructor(exporter, configProvider) {
         this.exporter = exporter;
-        this.flushGraceMs = flushGraceMs;
-        this.maxTraceAgeMs = maxTraceAgeMs;
         this.traces = new Map();
         this.isSweeping = false;
         this.inFlightExports = 0;
         this.exportWaiters = [];
-        // Defaults are intentionally high but bounded; override via env vars if needed.
-        // Set to 0 (or negative) to disable a guardrail.
-        this.maxBufferedTraces = readEnvInt('A365_PER_REQUEST_MAX_TRACES', DEFAULT_MAX_BUFFERED_TRACES);
-        this.maxSpansPerTrace = readEnvInt('A365_PER_REQUEST_MAX_SPANS_PER_TRACE', DEFAULT_MAX_SPANS_PER_TRACE);
-        this.maxConcurrentExports = readEnvInt('A365_PER_REQUEST_MAX_CONCURRENT_EXPORTS', DEFAULT_MAX_CONCURRENT_EXPORTS);
+        const effectiveConfigProvider = configProvider ?? defaultPerRequestSpanProcessorConfigurationProvider;
+        const config = effectiveConfigProvider.getConfiguration();
+        this.maxBufferedTraces = config.perRequestMaxTraces;
+        this.maxSpansPerTrace = config.perRequestMaxSpansPerTrace;
+        this.maxConcurrentExports = config.perRequestMaxConcurrentExports;
+        this.flushGraceMs = config.perRequestFlushGraceMs;
+        this.maxTraceAgeMs = config.perRequestMaxTraceAgeMs;
     }
     onStart(span, ctx) {
         const traceId = span.spanContext().traceId;