@microsoft/opentelemetry 0.1.0-alpha.3 → 0.1.0-alpha.5

package/README.md

@@ -1,5 +1,8 @@
 # @microsoft/opentelemetry
 
+[![npm version](https://badge.fury.io/js/%40microsoft%2Fopentelemetry.svg)](https://www.npmjs.com/package/@microsoft/opentelemetry)
+[![license](https://img.shields.io/npm/l/%40microsoft%2Fopentelemetry)](https://github.com/microsoft/opentelemetry-distro-javascript/blob/main/LICENSE)
+
 Microsoft OpenTelemetry distribution for Node.js — one import, one call, full observability across Azure Monitor, OTLP-compatible backends, and A365.
 
 ## Getting Started
@@ -8,6 +11,23 @@ Microsoft OpenTelemetry distribution for Node.js — one import, one call, full
 npm install @microsoft/opentelemetry
 ```
 
+> **Important:** Import and call `useMicrosoftOpenTelemetry()` as early as possible in your application entry point so instrumentations can patch libraries before they are loaded.
+
+### A365
+
+```typescript
+import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
+
+useMicrosoftOpenTelemetry({
+  a365: {
+    enabled: true,
+    tokenResolver: (agentId, tenantId) => getToken(agentId, tenantId),
+  },
+});
+```
+
+### Azure Monitor
+
 ```typescript
 import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
 
@@ -20,6 +40,16 @@ useMicrosoftOpenTelemetry({
 });
 ```
 
+### OTLP only (no Azure Monitor)
+
+```typescript
+import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
+
+// Set OTEL_EXPORTER_OTLP_ENDPOINT in your environment
+useMicrosoftOpenTelemetry();
+```
+
+
 That's it — traces, metrics, and logs are collected automatically with built-in instrumentations for HTTP, databases, and more.
 
 ## Configuration
@@ -31,13 +61,97 @@ That's it — traces, metrics, and logs are collected automatically with built-i
 | `resource` | `Resource` | auto-detected | OpenTelemetry Resource (service name, version, etc.) |
 | `samplingRatio` | `number` | `1.0` | Ratio of telemetry items to transmit (0.0–1.0) |
 | `tracesPerSecond` | `number` | `5` | Max traces per second. Set to `0` to use `samplingRatio` instead |
-| `instrumentationOptions` | `InstrumentationOptions` | all enabled | Toggle built-in instrumentations (HTTP, MongoDB, MySQL, PostgreSQL, Redis, Azure SDK, Azure Functions, Winston, Bunyan, OpenAI Agents, LangChain) |
+| `instrumentationOptions` | `InstrumentationOptions` | all enabled | Toggle built-in instrumentations (see below) |
 | `spanProcessors` | `SpanProcessor[]` | — | Additional span processors |
 | `logRecordProcessors` | `LogRecordProcessor[]` | — | Additional log record processors |
 | `metricReaders` | `MetricReader[]` | — | Additional metric readers |
 | `views` | `ViewOptions[]` | — | Metric views |
-| `azureMonitor` | `AzureMonitorOpenTelemetryOptions` | — | Azure Monitor backend config (see below) |
+| `azureMonitor` | `AzureMonitorOpenTelemetryOptions` | — | Azure Monitor backend config. When provided, Azure Monitor export is enabled |
 | `a365` | `A365Options` | — | A365 observability config |
+| `enableConsoleExporters` | `boolean` | auto | Enable console exporters for traces, metrics, and logs |
+
+### `InstrumentationOptions`
+
+Most instrumentations use `InstrumentationConfig` shape (`{ enabled?: boolean, ... }`).
+
+- Built-in infra instrumentations (`http`, `azureSdk`, `azureFunctions`, `mongoDb`, `mySql`, `postgreSql`, `redis`, `redis4`) are enabled by default.
+- Logging instrumentations (`bunyan`, `winston`) are disabled by default.
+- GenAI instrumentations (`openaiAgents`, `langchain`) are enabled by default.
+
+Set `enabled: true` or `enabled: false` explicitly for predictable behavior.
+
+| Key | Type | Default | Description |
+|---|---|---|---|
+| `http` | `InstrumentationConfig` | enabled | HTTP client/server instrumentation |
+| `azureSdk` | `InstrumentationConfig` | enabled | Azure SDK instrumentation |
+| `mongoDb` | `InstrumentationConfig` | enabled | MongoDB instrumentation |
+| `mySql` | `InstrumentationConfig` | enabled | MySQL instrumentation |
+| `postgreSql` | `InstrumentationConfig` | enabled | PostgreSQL instrumentation |
+| `redis` | `InstrumentationConfig` | enabled | Redis instrumentation |
+| `redis4` | `InstrumentationConfig` | enabled | Redis 4 instrumentation |
+| `bunyan` | `InstrumentationConfig` | disabled | Bunyan log instrumentation |
+| `winston` | `InstrumentationConfig` | disabled | Winston log instrumentation |
+| `openaiAgents` | `OpenAIAgentsInstrumentationConfig` | enabled | OpenAI Agents SDK instrumentation (requires `@openai/agents`) |
+| `langchain` | `LangChainInstrumentationConfig` | enabled | LangChain instrumentation (requires `@langchain/core`) |
+
+#### Turn instrumentations on/off
+
+```typescript
+useMicrosoftOpenTelemetry({
+  instrumentationOptions: {
+    // Disable specific built-in instrumentations
+    http: { enabled: false },
+    redis: { enabled: false },
+
+    // Enable GenAI instrumentations
+    openaiAgents: {
+      enabled: true,
+      isContentRecordingEnabled: true,
+    },
+    langchain: {
+      enabled: true,
+      isContentRecordingEnabled: true,
+    },
+  },
+});
+```
+
+Disable most built-in auto-instrumentation:
+
+```typescript
+useMicrosoftOpenTelemetry({
+  instrumentationOptions: {
+    http: { enabled: false },
+    azureSdk: { enabled: false },
+    azureFunctions: { enabled: false },
+    mongoDb: { enabled: false },
+    mySql: { enabled: false },
+    postgreSql: { enabled: false },
+    redis: { enabled: false },
+    redis4: { enabled: false },
+    bunyan: { enabled: false },
+    winston: { enabled: false },
+    openaiAgents: { enabled: false },
+    langchain: { enabled: false },
+  },
+});
+```
+
+### Console exporters
+
+Use console exporters when validating local telemetry or debugging setup.
+
+```typescript
+useMicrosoftOpenTelemetry({
+  enableConsoleExporters: true,
+});
+```
+
+Behavior:
+
+- `enableConsoleExporters: true`: always enable console exporters (traces, metrics, logs).
+- `enableConsoleExporters: false`: do not auto-add the standard console exporters, except for the A365 span console fallback when `a365` options are provided but `a365.enabled` is `false` or omitted.
+- Omitted: console exporters auto-enable only when no other exporter path is active; if `a365` options are provided but `a365.enabled` is `false` or omitted, the A365 span console fallback can still be added.
 
 ### `azureMonitor` options
 
@@ -48,7 +162,7 @@ That's it — traces, metrics, and logs are collected automatically with built-i
 | `enableStandardMetrics` | `boolean` | `true` | Enable standard metrics collection |
 | `enableTraceBasedSamplingForLogs` | `boolean` | `false` | Enable log sampling based on trace |
 | `enablePerformanceCounters` | `boolean` | `true` | Enable performance counter collection |
-| `browserSdkLoaderOptions` | `BrowserSdkLoaderOptions` | — | Application Insights browser SDK loader config |
+| `browserSdkLoaderOptions` | `BrowserSdkLoaderOptions` | disabled | Application Insights browser SDK loader config (`enabled`, `connectionString`) |
 
 ### OTLP via environment variables
 
@@ -61,21 +175,65 @@ See the [OpenTelemetry OTLP Exporter specification](https://opentelemetry.io/doc
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `enabled` | `boolean` | `false` | Enable A365 observability export |
-| `tokenResolver` | `(agentId, tenantId) => string \| Promise<string>` | — | Token resolver for A365 service authentication |
+| `tokenResolver` | `(agentId, tenantId, authScopes?) => string \| Promise<string>` | — | Token resolver for A365 service authentication |
 | `clusterCategory` | `ClusterCategory` | `"prod"` | Cluster category for endpoint resolution (`local`, `dev`, `test`, `preprod`, `firstrelease`, `prod`, `gov`, `high`, `dod`, `mooncake`, `ex`, `rx`) |
 | `domainOverride` | `string` | — | Override the A365 observability service domain |
 | `authScopes` | `string[]` | `["https://api.powerplatform.com/.default"]` | OAuth scopes for A365 service authentication |
-| `perRequestExport` | `boolean` | `false` | Buffer spans per trace and export on root completion instead of batch export |
+| `baggage` | `A365BaggageOptions` | see below | Baggage propagation and span enrichment options |
+| `hosting` | `A365HostingOptions` | see below | Hosting middleware options (requires `@microsoft/agents-hosting`) |
+
+#### `a365.baggage` options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `propagationEnabled` | `boolean` | `true` | Enable baggage propagation from request headers to span context |
+| `enrichSpans` | `boolean` | `true` | Copy baggage items (tenant, agent, session, etc.) to span attributes |
+
+#### `a365.hosting` options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | `boolean` | `false` | Enable hosting middleware integration (baggage middleware, output logging, etc.) |
+| `adapter` | `{ use(...middlewares): void }` | — | Adapter instance where middleware is auto-registered when `enabled` is true |
+| `enableOutputLogging` | `boolean` | `true` | Enable output logging middleware auto-registration |
+
+
+| `httpRequestTimeoutMilliseconds` | `number` | `30000` | HTTP request timeout (ms) when sending spans to A365 service |
+
+Example:
+
+```typescript
+useMicrosoftOpenTelemetry({
+  a365: {
+    enabled: true,
+    tokenResolver: (agentId, tenantId) => getToken(agentId, tenantId),
+    exporterOptions: {
+      maxQueueSize: 4096,
+      maxExportBatchSize: 1024,
+      scheduledDelayMilliseconds: 10000,
+      httpRequestTimeoutMilliseconds: 15000,
+    },
+  },
+});
+```
+
+#### A365 environment variables
 
 A365 options can also be set via environment variables (highest precedence):
 
 | Environment Variable | Description |
 |---|---|
 | `ENABLE_A365_OBSERVABILITY_EXPORTER` | `"true"` / `"false"` — override `enabled` |
-| `ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT` | `"true"` / `"false"` — override `perRequestExport` |
 | `A365_OBSERVABILITY_SCOPES_OVERRIDE` | Space-separated list of OAuth scopes |
 | `A365_OBSERVABILITY_DOMAIN_OVERRIDE` | Override service domain |
 | `CLUSTER_CATEGORY` | Override cluster category |
+| `A365_OBSERVABILITY_LOG_LEVEL` | A365 internal logger filter level (`none`, `info`, `warn`, `error`, or pipe-delimited combination) — overrides `observabilityLogLevel` |
+| `A365_PER_REQUEST_MAX_TRACES` | Max buffered traces (default: `1000`) |
+| `A365_PER_REQUEST_MAX_SPANS_PER_TRACE` | Max spans per trace (default: `5000`) |
+| `A365_PER_REQUEST_MAX_CONCURRENT_EXPORTS` | Max concurrent exports (default: `20`) |
+| `A365_PER_REQUEST_FLUSH_GRACE_MS` | Grace period after root span ends (default: `250`) |
+| `A365_PER_REQUEST_MAX_TRACE_AGE_MS` | Max trace age before forced flush (default: `1800000`) |
+
 
 ### Example
 
@@ -90,7 +248,6 @@ useMicrosoftOpenTelemetry({
     azureMonitorExporterOptions: {
       connectionString: process.env.APPLICATIONINSIGHTS_CONNECTION_STRING,
     },
-    enableLiveMetrics: true,
   },
 });
 

package/dist/commonjs/a365/configuration/A365Configuration.d.ts

@@ -1,41 +1,44 @@
-import type { A365Options, ClusterCategory, A365BaggageOptions, A365HostingOptions } from "./A365ConfigurationOptions.js";
+import type { A365Options, ClusterCategory, A365BaggageOptions } from "./A365ConfigurationOptions.js";
 /**
  * Environment variable names for A365 configuration.
  * These match the upstream Agent365-nodejs conventions.
  */
 export declare const A365_ENV_VARS: {
     readonly EXPORTER_ENABLED: "ENABLE_A365_OBSERVABILITY_EXPORTER";
-    readonly PER_REQUEST_EXPORT: "ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT";
     readonly AUTH_SCOPES: "A365_OBSERVABILITY_SCOPES_OVERRIDE";
     readonly DOMAIN: "A365_OBSERVABILITY_DOMAIN_OVERRIDE";
     readonly CLUSTER_CATEGORY: "CLUSTER_CATEGORY";
+    readonly LOG_LEVEL: "A365_OBSERVABILITY_LOG_LEVEL";
 };
 /**
  * Resolved A365 configuration.
  *
- * Merges values from four sources (lowest to highest precedence):
+ * Merges values from three sources (lowest to highest precedence):
  *   1. Defaults
  *   2. Programmatic options (`A365Options`)
- *   3. JSON config (`applicationinsights.json` → `a365` key)
- *   4. Environment variables (see `A365_ENV_VARS`)
+ *   3. Environment variables (see `A365_ENV_VARS`)
  */
 export declare class A365Configuration {
     /** Whether A365 observability is enabled. */
     readonly enabled: boolean;
     /** Token resolver callback for A365 service authentication. */
-    readonly tokenResolver?: (agentId: string, tenantId: string) => string | Promise<string>;
+    readonly tokenResolver?: (agentId: string, tenantId: string, authScopes?: string[]) => string | Promise<string>;
     /** Cluster category. */
     readonly clusterCategory: ClusterCategory;
     /** Domain override for the A365 observability service. */
     readonly domainOverride?: string;
     /** OAuth scopes for A365 service authentication. */
     readonly authScopes: string[];
-    /** Whether to use per-request export mode. */
-    readonly perRequestExport: boolean;
     /** Baggage options. */
     readonly baggage: Required<A365BaggageOptions>;
     /** Hosting options. */
-    readonly hosting: Required<A365HostingOptions>;
+    readonly hosting: {
+        enabled: boolean;
+        adapter?: {
+            use(...middlewares: unknown[]): void;
+        };
+        enableOutputLogging: boolean;
+    };
     constructor(options?: A365Options);
     private _warnIfOptionsSetButDisabled;
 }

package/dist/commonjs/a365/configuration/A365Configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"A365Configuration.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365Configuration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAwBvC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAmBX;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,6CAA6C;IAC7C,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,+DAA+D;IAC/D,SAAgB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhG,wBAAwB;IACxB,SAAgB,eAAe,EAAE,eAAe,CAAC;IAEjD,0DAA0D;IAC1D,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExC,oDAAoD;IACpD,SAAgB,UAAU,EAAE,MAAM,EAAE,CAAC;IAErC,8CAA8C;IAC9C,SAAgB,gBAAgB,EAAE,OAAO,CAAC;IAE1C,uBAAuB;IACvB,SAAgB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAEtD,uBAAuB;IACvB,SAAgB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBAE1C,OAAO,CAAC,EAAE,WAAW;IAiFjC,OAAO,CAAC,4BAA4B;CAgBrC"}
+{"version":3,"file":"A365Configuration.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365Configuration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAuBvC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAmBX;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,6CAA6C;IAC7C,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,+DAA+D;IAC/D,SAAgB,aAAa,CAAC,EAAE,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAAE,KAClB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,wBAAwB;IACxB,SAAgB,eAAe,EAAE,eAAe,CAAC;IAEjD,0DAA0D;IAC1D,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExC,oDAAoD;IACpD,SAAgB,UAAU,EAAE,MAAM,EAAE,CAAC;IAErC,uBAAuB;IACvB,SAAgB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAEtD,uBAAuB;IACvB,SAAgB,OAAO,EAAE;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;SAAE,CAAC;QACnD,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;gBAEU,OAAO,CAAC,EAAE,WAAW;IA8DjC,OAAO,CAAC,4BAA4B;CAerC"}

package/dist/commonjs/a365/configuration/A365Configuration.js

@@ -3,8 +3,7 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.A365Configuration = exports.A365_ENV_VARS = void 0;
-const index_js_1 = require("../../shared/logging/index.js");
-const jsonConfig_js_1 = require("../../shared/jsonConfig.js");
+const logging_js_1 = require("../logging.js");
 /**
  * Parse an environment variable as a boolean.
  * Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true and
@@ -32,10 +31,10 @@ function parseEnvBoolean(envValue) {
  */
 exports.A365_ENV_VARS = {
     EXPORTER_ENABLED: "ENABLE_A365_OBSERVABILITY_EXPORTER",
-    PER_REQUEST_EXPORT: "ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT",
     AUTH_SCOPES: "A365_OBSERVABILITY_SCOPES_OVERRIDE",
     DOMAIN: "A365_OBSERVABILITY_DOMAIN_OVERRIDE",
     CLUSTER_CATEGORY: "CLUSTER_CATEGORY",
+    LOG_LEVEL: "A365_OBSERVABILITY_LOG_LEVEL",
 };
 const DEFAULT_AUTH_SCOPE = "https://api.powerplatform.com/.default";
 const VALID_CLUSTER_CATEGORIES = new Set([
@@ -55,11 +54,10 @@ const VALID_CLUSTER_CATEGORIES = new Set([
 /**
  * Resolved A365 configuration.
  *
- * Merges values from four sources (lowest to highest precedence):
+ * Merges values from three sources (lowest to highest precedence):
  *   1. Defaults
  *   2. Programmatic options (`A365Options`)
- *   3. JSON config (`applicationinsights.json` → `a365` key)
- *   4. Environment variables (see `A365_ENV_VARS`)
+ *   3. Environment variables (see `A365_ENV_VARS`)
  */
 class A365Configuration {
     /** Whether A365 observability is enabled. */
@@ -72,8 +70,6 @@ class A365Configuration {
     domainOverride;
     /** OAuth scopes for A365 service authentication. */
     authScopes;
-    /** Whether to use per-request export mode. */
-    perRequestExport;
     /** Baggage options. */
     baggage;
     /** Hosting options. */
@@ -84,33 +80,16 @@ class A365Configuration {
         let clusterCategory = "prod";
         let domainOverride = options?.domainOverride;
         let authScopes = options?.authScopes ?? [DEFAULT_AUTH_SCOPE];
-        let perRequestExport = false;
         // 2. Apply programmatic options
         if (options) {
             enabled = options.enabled ?? enabled;
             clusterCategory = options.clusterCategory ?? clusterCategory;
-            perRequestExport = options.perRequestExport ?? perRequestExport;
         }
-        // 3. Apply JSON config (takes precedence over programmatic options)
-        const jsonA365 = jsonConfig_js_1.JsonConfig.getInstance().a365;
-        if (jsonA365) {
-            enabled = jsonA365.enabled ?? enabled;
-            clusterCategory = jsonA365.clusterCategory ?? clusterCategory;
-            domainOverride = jsonA365.domainOverride ?? domainOverride;
-            perRequestExport = jsonA365.perRequestExport ?? perRequestExport;
-            if (jsonA365.authScopes) {
-                authScopes = jsonA365.authScopes;
-            }
-        }
-        // 4. Apply environment variable overrides (highest precedence)
+        // 3. Apply environment variable overrides (highest precedence)
         const envEnabled = parseEnvBoolean(process.env[exports.A365_ENV_VARS.EXPORTER_ENABLED]);
         if (envEnabled !== undefined) {
             enabled = envEnabled;
         }
-        const envPerRequest = parseEnvBoolean(process.env[exports.A365_ENV_VARS.PER_REQUEST_EXPORT]);
-        if (envPerRequest !== undefined) {
-            perRequestExport = envPerRequest;
-        }
         const envScopes = process.env[exports.A365_ENV_VARS.AUTH_SCOPES]?.trim();
         if (envScopes) {
             authScopes = envScopes.split(/\s+/).filter(Boolean);
@@ -124,7 +103,7 @@ class A365Configuration {
             clusterCategory = envCluster;
         }
         else if (envCluster) {
-            index_js_1.Logger.getInstance().warn(`Invalid ${exports.A365_ENV_VARS.CLUSTER_CATEGORY} value '${envCluster}'. Using default cluster category.`);
+            (0, logging_js_1.getA365Logger)().warn(`Invalid ${exports.A365_ENV_VARS.CLUSTER_CATEGORY} value '${envCluster}'. Using default cluster category.`);
         }
         // Assign resolved values
         this.enabled = enabled;
@@ -132,13 +111,14 @@ class A365Configuration {
         this.clusterCategory = clusterCategory;
         this.domainOverride = domainOverride;
         this.authScopes = authScopes;
-        this.perRequestExport = perRequestExport;
         this.baggage = {
-            propagationEnabled: jsonA365?.baggage?.propagationEnabled ?? options?.baggage?.propagationEnabled ?? true,
-            enrichSpans: jsonA365?.baggage?.enrichSpans ?? options?.baggage?.enrichSpans ?? true,
+            propagationEnabled: options?.baggage?.propagationEnabled ?? true,
+            enrichSpans: options?.baggage?.enrichSpans ?? true,
         };
         this.hosting = {
-            enabled: jsonA365?.hosting?.enabled ?? options?.hosting?.enabled ?? false,
+            enabled: options?.hosting?.enabled ?? false,
+            adapter: options?.hosting?.adapter,
+            enableOutputLogging: options?.hosting?.enableOutputLogging ?? true,
         };
         // Warn when A365-scoped options are set but A365 is not enabled
         if (!this.enabled) {
@@ -150,10 +130,9 @@ class A365Configuration {
             return;
         const hasNonTrivialOptions = options.tokenResolver !== undefined ||
             options.domainOverride !== undefined ||
-            options.perRequestExport !== undefined ||
             options.hosting?.enabled === true;
         if (hasNonTrivialOptions) {
-            index_js_1.Logger.getInstance().warn("A365 configuration options are set but A365 is not enabled. " +
+            (0, logging_js_1.getA365Logger)().warn("A365 configuration options are set but A365 is not enabled. " +
                 "Set `a365.enabled: true` or `ENABLE_A365_OBSERVABILITY_EXPORTER=true` to enable.");
         }
     }

package/dist/commonjs/a365/configuration/A365Configuration.js.map

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

package/dist/commonjs/a365/configuration/A365ConfigurationOptions.d.ts

@@ -14,22 +14,16 @@ export interface A365Options {
     enabled?: boolean;
     /**
      * Token resolver for authenticating with the A365 observability service.
-     * Called with (agentId, tenantId) extracted from span attributes.
+     * Called with (agentId, tenantId, authScopes) extracted from span attributes/config.
      * Must return a bearer token string or a promise resolving to one.
      */
-    tokenResolver?: (agentId: string, tenantId: string) => string | Promise<string>;
+    tokenResolver?: (agentId: string, tenantId: string, authScopes?: string[]) => string | Promise<string>;
     /** Cluster category for the A365 service endpoint. */
     clusterCategory?: ClusterCategory;
     /** Override the A365 observability service domain. */
     domainOverride?: string;
     /** OAuth scopes for A365 service authentication. */
     authScopes?: string[];
-    /**
-     * Use per-request export mode (buffer spans per trace, export on root completion).
-     * When false, uses standard batch export.
-     * @default false
-     */
-    perRequestExport?: boolean;
     /** Baggage propagation and span enrichment options. */
     baggage?: A365BaggageOptions;
     /** Hosting middleware options (requires @microsoft/agents-hosting). */
@@ -49,5 +43,17 @@ export interface A365HostingOptions {
      * Requires `@microsoft/agents-hosting` as an optional peer dependency.
      */
     enabled?: boolean;
+    /**
+     * Adapter instance where hosting middleware will be auto-registered.
+     * Must expose a `use(...middlewares)` method compatible with agents-hosting adapters.
+     */
+    adapter?: {
+        use(...middlewares: unknown[]): void;
+    };
+    /**
+     * Enable output logging middleware auto-registration when hosting is enabled.
+     * @default true
+     */
+    enableOutputLogging?: boolean;
 }
 //# sourceMappingURL=A365ConfigurationOptions.d.ts.map

package/dist/commonjs/a365/configuration/A365ConfigurationOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"A365ConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,IAAI,GACJ,IAAI,CAAC;AAET;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhF,sDAAsD;IACtD,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,uDAAuD;IACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"A365ConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,IAAI,GACJ,IAAI,CAAC;AAET;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAAE,KAClB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B,sDAAsD;IACtD,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAEnD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/commonjs/a365/configuration/index.d.ts

@@ -1,3 +1,4 @@
 export { A365Configuration, A365_ENV_VARS } from "./A365Configuration.js";
 export type { A365Options, ClusterCategory, A365BaggageOptions, A365HostingOptions, } from "./A365ConfigurationOptions.js";
+export type { ILogger } from "../logging.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/commonjs/a365/configuration/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/commonjs/a365/constants.d.ts

@@ -17,12 +17,25 @@ export declare class OpenTelemetryConstants {
     static readonly AZ_NAMESPACE_KEY = "az.namespace";
     static readonly SERVER_ADDRESS_KEY = "server.address";
     static readonly SERVER_PORT_KEY = "server.port";
+    static readonly AZURE_RP_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
     static readonly SOURCE_NAME = "Agent365Sdk";
+    static readonly ENABLE_OPENTELEMETRY_SWITCH = "Azure.Experimental.EnableActivitySource";
+    static readonly TRACE_CONTENTS_SWITCH = "Azure.Experimental.TraceGenAIMessageContent";
+    static readonly TRACE_CONTENTS_ENVIRONMENT_VARIABLE = "AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED";
+    static readonly ENABLE_OBSERVABILITY = "ENABLE_OBSERVABILITY";
+    static readonly ENABLE_A365_OBSERVABILITY_EXPORTER = "ENABLE_A365_OBSERVABILITY_EXPORTER";
+    static readonly ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY";
     static readonly GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
     static readonly GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
     static readonly GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
     static readonly GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
     static readonly GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    static readonly GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    static readonly GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
+    static readonly GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p";
+    static readonly GEN_AI_CHOICE = "gen_ai.choice";
+    static readonly GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration";
+    static readonly GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
     static readonly GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
     static readonly GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens";
     static readonly GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions";
@@ -36,6 +49,7 @@ export declare class OpenTelemetryConstants {
     static readonly GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id";
     static readonly GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process";
     static readonly GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    static readonly AGENT_ID_KEY = "gen_ai.agent.id";
     static readonly GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
     static readonly GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link";
     static readonly SESSION_ID_KEY = "microsoft.session.id";
@@ -61,6 +75,8 @@ export declare class OpenTelemetryConstants {
     static readonly GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id";
     static readonly GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email";
     static readonly GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id";
+    static readonly GEN_AI_TASK_ID_KEY = "gen_ai.task.id";
+    static readonly GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload";
     static readonly CHANNEL_NAME_KEY = "microsoft.channel.name";
     static readonly CHANNEL_LINK_KEY = "microsoft.channel.link";
     static readonly CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id";
@@ -71,6 +87,6 @@ export declare class OpenTelemetryConstants {
     static readonly TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version";
     static readonly TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK";
     static readonly TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
-    static readonly TELEMETRY_SDK_VERSION_VALUE = "0.1.0";
+    static readonly TELEMETRY_SDK_VERSION_VALUE = "0.1.0-alpha.5";
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/commonjs/a365/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IAEjC,gBAAuB,2BAA2B,kBAAkB;IACpE,gBAAuB,2BAA2B,kBAAkB;IACpE,gBAAuB,8BAA8B,qBAAqB;IAC1E,gBAAuB,mBAAmB,UAAU;IAGpD,gBAAuB,cAAc,gBAAgB;IACrD,gBAAuB,oBAAoB,2BAA2B;IACtE,gBAAuB,iBAAiB,mBAAmB;IAC3D,gBAAuB,gBAAgB,kBAAkB;IACzD,gBAAuB,kBAAkB,oBAAoB;IAC7D,gBAAuB,eAAe,iBAAiB;IAGvD,gBAAuB,WAAW,iBAAiB;IAGnD,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,wBAAwB,0BAA0B;IACzE,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,kCAAkC,oCAAoC;IAC7F,gBAAuB,wBAAwB,0BAA0B;IAGzE,gBAAuB,6BAA6B,+BAA+B;IACnF,gBAAuB,8BAA8B,gCAAgC;IAGrF,gBAAuB,8BAA8B,gCAAgC;IACrF,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,gCAAgC,4CACZ;IAG3C,gBAAuB,mBAAmB,qBAAqB;IAC/D,gBAAuB,qBAAqB,uBAAuB;IACnE,gBAAuB,4BAA4B,8BAA8B;IACjF,gBAAuB,wBAAwB,0BAA0B;IACzE,gBAAuB,4BAA4B,sCAAsC;IACzF,gBAAuB,gCAAgC,0CAA0C;IACjG,gBAAuB,mBAAmB,8BAA8B;IAGxE,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,iCAAiC,sCAAsC;IAC9F,gBAAuB,cAAc,0BAA0B;IAC/D,gBAAuB,uBAAuB,mCAAmC;IAGjF,gBAAuB,uBAAuB,yBAAyB;IACvE,gBAAuB,oBAAoB,sBAAsB;IACjE,gBAAuB,2BAA2B,6BAA6B;IAC/E,gBAAuB,oBAAoB,gCAAgC;IAC3E,gBAAuB,2BAA2B,6BAA6B;IAC/E,gBAAuB,oBAAoB,sBAAsB;IAGjE,gBAAuB,aAAa,yBAAyB;IAG7D,gBAAuB,WAAW,aAAa;IAC/C,gBAAuB,aAAa,eAAe;IACnD,gBAAuB,cAAc,gBAAgB;IACrD,gBAAuB,2BAA2B,oBAAoB;IAGtE,gBAAuB,+BAA+B,yCAAyC;IAC/F,gBAAuB,6BAA6B,4CAA4C;IAChG,gBAAuB,4BAA4B,sCAAsC;IACzF,gBAAuB,0BAA0B,oCAAoC;IACrF,gBAAuB,sCAAsC,8CAChB;IAC7C,gBAAuB,mCAAmC,6CACd;IAC5C,gBAAuB,+BAA+B,yCAAyC;IAG/F,gBAAuB,qBAAqB,6BAA6B;IACzE,gBAAuB,sBAAsB,gCAAgC;IAC7E,gBAAuB,6BAA6B,uCAAuC;IAG3F,gBAAuB,gBAAgB,4BAA4B;IACnE,gBAAuB,gBAAgB,4BAA4B;IAGnE,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,oBAAoB,sBAAsB;IAGjE,gBAAuB,gBAAgB,kBAAkB;IAGzD,gBAAuB,sBAAsB,wBAAwB;IACrE,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,wBAAwB,0BAA0B;IACzE,gBAAuB,4BAA4B,YAAY;IAC/D,gBAAuB,2BAA2B,WAAW;CAC9D"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/a365/constants.js

@@ -3,6 +3,7 @@
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenTelemetryConstants = void 0;
+const types_js_1 = require("../types.js");
 /**
  * OpenTelemetry constants for A365 observability.
  *
@@ -24,14 +25,29 @@ class OpenTelemetryConstants {
     static AZ_NAMESPACE_KEY = "az.namespace";
     static SERVER_ADDRESS_KEY = "server.address";
     static SERVER_PORT_KEY = "server.port";
+    static AZURE_RP_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
     // ── Source / SDK identity ─────────────────────────────────────────
     static SOURCE_NAME = "Agent365Sdk";
+    // ── Feature flags / env var names ─────────────────────────────────
+    static ENABLE_OPENTELEMETRY_SWITCH = "Azure.Experimental.EnableActivitySource";
+    static TRACE_CONTENTS_SWITCH = "Azure.Experimental.TraceGenAIMessageContent";
+    static TRACE_CONTENTS_ENVIRONMENT_VARIABLE = "AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED";
+    static ENABLE_OBSERVABILITY = "ENABLE_OBSERVABILITY";
+    static ENABLE_A365_OBSERVABILITY_EXPORTER = "ENABLE_A365_OBSERVABILITY_EXPORTER";
+    static ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY";
     // ── GenAI core attributes ────────────────────────────────────────
     static GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
     static GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
     static GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
     static GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
     static GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    static GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    static GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
+    static GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p";
+    static GEN_AI_CHOICE = "gen_ai.choice";
+    // ── GenAI metrics ────────────────────────────────────────────────
+    static GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration";
+    static GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
     // ── GenAI usage ──────────────────────────────────────────────────
     static GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
     static GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens";
@@ -48,6 +64,7 @@ class OpenTelemetryConstants {
     static GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id";
     static GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process";
     static GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    static AGENT_ID_KEY = "gen_ai.agent.id";
     // ── GenAI conversation / session ─────────────────────────────────
     static GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
     static GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link";
@@ -79,6 +96,9 @@ class OpenTelemetryConstants {
     static GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id";
     static GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email";
     static GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id";
+    // ── Execution context ────────────────────────────────────────────
+    static GEN_AI_TASK_ID_KEY = "gen_ai.task.id";
+    static GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload";
     // ── Channel dimensions ───────────────────────────────────────────
     static CHANNEL_NAME_KEY = "microsoft.channel.name";
     static CHANNEL_LINK_KEY = "microsoft.channel.link";
@@ -93,7 +113,7 @@ class OpenTelemetryConstants {
     static TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version";
     static TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK";
     static TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
-    static TELEMETRY_SDK_VERSION_VALUE = "0.1.0";
+    static TELEMETRY_SDK_VERSION_VALUE = types_js_1.MICROSOFT_OPENTELEMETRY_VERSION;
 }
 exports.OpenTelemetryConstants = OpenTelemetryConstants;
 //# sourceMappingURL=constants.js.map