@microsoft/opentelemetry 1.0.1 → 1.1.0

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/%40microsoft%2Fopentelemetry)](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)
+[![API Docs](https://img.shields.io/badge/API%20Docs-TypeDoc-blue)](https://microsoft.github.io/opentelemetry-distro-javascript/)
 
 Microsoft OpenTelemetry distribution for Node.js — one import, one call, full observability across Azure Monitor, OTLP-compatible backends, and A365.
 
@@ -112,26 +113,25 @@ import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
 useMicrosoftOpenTelemetry();
 ```
 
-
 That's it — traces, metrics, and logs are collected automatically with built-in instrumentations for HTTP, databases, and more.
 
 ## Configuration
 
 ### `MicrosoftOpenTelemetryOptions`
 
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `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 (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. When provided, Azure Monitor export is enabled |
-| `a365` | `A365Options` | — | A365 observability config |
-| `enableConsoleExporters` | `boolean` | auto | Enable console exporters for traces, metrics, and logs |
+| Option                   | Type                               | Default       | Description                                                                  |
+| ------------------------ | ---------------------------------- | ------------- | ---------------------------------------------------------------------------- |
+| `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 (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. When provided, Azure Monitor export is enabled |
+| `a365`                   | `A365Options`                      | —             | A365 observability config                                                    |
+| `enableConsoleExporters` | `boolean`                          | auto          | Enable console exporters for traces, metrics, and logs                       |
 
 ### `InstrumentationOptions`
 
@@ -144,19 +144,19 @@ Most instrumentations use `InstrumentationConfig` shape (`{ enabled?: boolean, .
 
 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`) |
+| 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
 
@@ -219,14 +219,14 @@ Behavior:
 
 ### `azureMonitor` options
 
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `azureMonitorExporterOptions` | `AzureMonitorExporterOptions` | — | Exporter config including `connectionString`, `storageDirectory`, `disableOfflineStorage` |
-| `enableLiveMetrics` | `boolean` | `true` | Enable Live Metrics streaming |
-| `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` | disabled | Application Insights browser SDK loader config (`enabled`, `connectionString`) |
+| Option                            | Type                          | Default  | Description                                                                               |
+| --------------------------------- | ----------------------------- | -------- | ----------------------------------------------------------------------------------------- |
+| `azureMonitorExporterOptions`     | `AzureMonitorExporterOptions` | —        | Exporter config including `connectionString`, `storageDirectory`, `disableOfflineStorage` |
+| `enableLiveMetrics`               | `boolean`                     | `true`   | Enable Live Metrics streaming                                                             |
+| `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`     | disabled | Application Insights browser SDK loader config (`enabled`, `connectionString`)            |
 
 ### OTLP via environment variables
 
@@ -236,17 +236,18 @@ See the [OpenTelemetry OTLP Exporter specification](https://opentelemetry.io/doc
 
 ### `a365` options
 
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `enabled` | `boolean` | `false` | Enable A365 observability. Registers the `A365SpanProcessor` for baggage/attribute enrichment of downstream exporters (Azure Monitor, OTLP, console). Does **not** send data to the A365 service on its own — set `enableObservabilityExporter` for that |
-| `enableObservabilityExporter` | `boolean` | `false` | Enable the A365 HTTP exporter (`Agent365Exporter`) to send spans to the A365 observability service. Requires `enabled: true`. Equivalent to `ENABLE_A365_OBSERVABILITY_EXPORTER` env var |
-| `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[]` | `["api://9b975845-388f-4429-889e-eab1ef63949c/.default"]` | OAuth scopes for A365 service authentication |
-| `observabilityScopeOverride` | `string` | — | Single-string scope override (highest precedence). Equivalent to `A365_OBSERVABILITY_SCOPES_OVERRIDE` env var |
-| `logLevel` | `string` | `"none"` | A365 internal log level: `none`, `info`, `warn`, `error`, or pipe-separated combination. Overrides `A365_OBSERVABILITY_LOG_LEVEL` env var |
-| `useS2SEndpoint` | `boolean` | `false` | Use the S2S (service-to-service) endpoint path for export |
+| Option                        | Type                                                                           | Default                                                   | Description                                                                                                                                                                                                                                              |
+| ----------------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`                     | `boolean`                                                                      | `false`                                                   | Enable A365 observability. Registers the `A365SpanProcessor` for baggage/attribute enrichment of downstream exporters (Azure Monitor, OTLP, console). Does **not** send data to the A365 service on its own — set `enableObservabilityExporter` for that |
+| `enableObservabilityExporter` | `boolean`                                                                      | `false`                                                   | Enable the A365 HTTP exporter (`Agent365Exporter`) to send spans to the A365 observability service. Requires `enabled: true`. Equivalent to `ENABLE_A365_OBSERVABILITY_EXPORTER` env var                                                                 |
+| `tokenResolver`               | `(agentId, tenantId, authScopes?) => string \| Promise<string>`                | —                                                         | Token resolver for A365 service authentication. When both this and `contextualTokenResolver` are set, `contextualTokenResolver` takes precedence                                                                                                         |
+| `contextualTokenResolver`     | `(context: TokenResolverContext) => string \| null \| Promise<string \| null>` | —                                                         | Contextual token resolver with rich context including the agentic user ID. Takes precedence over `tokenResolver` when set                                                                                                                                |
+| `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[]`                                                                     | `["api://9b975845-388f-4429-889e-eab1ef63949c/.default"]` | OAuth scopes for A365 service authentication                                                                                                                                                                                                             |
+| `observabilityScopeOverride`  | `string`                                                                       | —                                                         | Single-string scope override (highest precedence). Equivalent to `A365_OBSERVABILITY_SCOPES_OVERRIDE` env var                                                                                                                                            |
+| `logLevel`                    | `string`                                                                       | `"none"`                                                  | A365 internal log level: `none`, `info`, `warn`, `error`, or pipe-separated combination. Overrides `A365_OBSERVABILITY_LOG_LEVEL` env var                                                                                                                |
+| `useS2SEndpoint`              | `boolean`                                                                      | `false`                                                   | Use the S2S (service-to-service) endpoint path for export                                                                                                                                                                                                |
 
 When A365 export is enabled, the distro defaults to GenAI-focused telemetry. To opt back into non-GenAI auto-instrumentation, set explicit overrides:
 
@@ -316,14 +317,14 @@ new ObservabilityHostingManager().configure(adapter as unknown as { use(...m: un
 
 #### A365 exporter tuning
 
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `maxQueueSize` | `number` | `2048` | Maximum span queue size before drops occur |
-| `scheduledDelayMilliseconds` | `number` | `5000` | Delay (ms) between automatic batch flush attempts |
-| `exporterTimeoutMilliseconds` | `number` | `90000` | Maximum time (ms) for the entire export call |
+| Option                           | Type     | Default | Description                                                  |
+| -------------------------------- | -------- | ------- | ------------------------------------------------------------ |
+| `maxQueueSize`                   | `number` | `2048`  | Maximum span queue size before drops occur                   |
+| `scheduledDelayMilliseconds`     | `number` | `5000`  | Delay (ms) between automatic batch flush attempts            |
+| `exporterTimeoutMilliseconds`    | `number` | `90000` | Maximum time (ms) for the entire export call                 |
 | `httpRequestTimeoutMilliseconds` | `number` | `30000` | HTTP request timeout (ms) when sending spans to A365 service |
-| `maxExportBatchSize` | `number` | `512` | Maximum number of spans per export batch |
-| `maxPayloadBytes` | `number` | — | Maximum estimated payload size (bytes) per HTTP chunk |
+| `maxExportBatchSize`             | `number` | `512`   | Maximum number of spans per export batch                     |
+| `maxPayloadBytes`                | `number` | —       | Maximum estimated payload size (bytes) per HTTP chunk        |
 
 Example:
 
@@ -344,24 +345,26 @@ useMicrosoftOpenTelemetry({
 
 A365 options can also be set via environment variables (highest precedence):
 
-| Environment Variable | Description |
-|---|---|
-| `ENABLE_A365_OBSERVABILITY_EXPORTER` | `"true"` / `"false"` — override `enabled` |
-| `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`) |
-
+| Environment Variable                      | Description                                                                                                                            |
+| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `ENABLE_A365_OBSERVABILITY_EXPORTER`      | `"true"` / `"false"` — override `enabled`                                                                                              |
+| `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
 
 ```typescript
-import { useMicrosoftOpenTelemetry, shutdownMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
+import {
+  useMicrosoftOpenTelemetry,
+  shutdownMicrosoftOpenTelemetry,
+} from "@microsoft/opentelemetry";
 import { resourceFromAttributes } from "@opentelemetry/resources";
 
 useMicrosoftOpenTelemetry({
@@ -386,7 +389,6 @@ await shutdownMicrosoftOpenTelemetry();
 
 See the [samples/](./samples/) directory for working TypeScript examples covering connection setup, custom metrics, custom traces, sampling, OTLP dual-export, and more.
 
-
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md).

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

@@ -1,4 +1,5 @@
 import type { A365Options, ClusterCategory } from "./A365ConfigurationOptions.js";
+import type { ContextualTokenResolver } from "../exporter/Agent365ExporterOptions.js";
 /**
  * Environment variable names for A365 configuration.
  * These match the upstream Agent365-nodejs conventions.
@@ -23,6 +24,8 @@ export declare class A365Configuration {
     readonly enabled: boolean;
     /** Token resolver callback for A365 service authentication. */
     readonly tokenResolver?: (agentId: string, tenantId: string, authScopes?: string[]) => string | Promise<string>;
+    /** Contextual token resolver with rich context including the agentic user ID. */
+    readonly contextualTokenResolver?: ContextualTokenResolver;
     /** Cluster category. */
     readonly clusterCategory: ClusterCategory;
     /** Domain override for the A365 observability service. */

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,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAuBlF;;;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;;;;;;;;OAQG;IACH,SAAgB,2BAA2B,EAAE,OAAO,CAAC;IAErD;;;;;;OAMG;IACH,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,uDAAuD;IACvD,SAAgB,cAAc,EAAE,OAAO,CAAC;IAExC,kDAAkD;IAClD,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtC,yDAAyD;IACzD,SAAgB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpD,sDAAsD;IACtD,SAAgB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErD,gDAAgD;IAChD,SAAgB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExD,gDAAgD;IAChD,SAAgB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5C,6DAA6D;IAC7D,SAAgB,eAAe,CAAC,EAAE,MAAM,CAAC;gBAE7B,OAAO,CAAC,EAAE,WAAW;IA2FjC,OAAO,CAAC,4BAA4B;CAcrC"}
+{"version":3,"file":"A365Configuration.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365Configuration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAuBtF;;;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,iFAAiF;IACjF,SAAgB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElE,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;;;;;;;;OAQG;IACH,SAAgB,2BAA2B,EAAE,OAAO,CAAC;IAErD;;;;;;OAMG;IACH,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,uDAAuD;IACvD,SAAgB,cAAc,EAAE,OAAO,CAAC;IAExC,kDAAkD;IAClD,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtC,yDAAyD;IACzD,SAAgB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpD,sDAAsD;IACtD,SAAgB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErD,gDAAgD;IAChD,SAAgB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExD,gDAAgD;IAChD,SAAgB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5C,6DAA6D;IAC7D,SAAgB,eAAe,CAAC,EAAE,MAAM,CAAC;gBAE7B,OAAO,CAAC,EAAE,WAAW;IA4FjC,OAAO,CAAC,4BAA4B;CAgBrC"}

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

@@ -64,6 +64,8 @@ class A365Configuration {
     enabled;
     /** Token resolver callback for A365 service authentication. */
     tokenResolver;
+    /** Contextual token resolver with rich context including the agentic user ID. */
+    contextualTokenResolver;
     /** Cluster category. */
     clusterCategory;
     /** Domain override for the A365 observability service. */
@@ -164,6 +166,7 @@ class A365Configuration {
         this.enabled = enabled;
         this.enableObservabilityExporter = enableObservabilityExporter;
         this.tokenResolver = options?.tokenResolver;
+        this.contextualTokenResolver = options?.contextualTokenResolver;
         this.clusterCategory = clusterCategory;
         this.domainOverride = domainOverride;
         this.authScopes = authScopes;
@@ -183,7 +186,9 @@ class A365Configuration {
     _warnIfOptionsSetButDisabled(options) {
         if (!options)
             return;
-        const hasNonTrivialOptions = options.tokenResolver !== undefined || options.domainOverride !== undefined;
+        const hasNonTrivialOptions = options.tokenResolver !== undefined ||
+            options.contextualTokenResolver !== undefined ||
+            options.domainOverride !== undefined;
         if (hasNonTrivialOptions) {
             (0, logging_js_1.getA365Logger)().warn("A365 configuration options are set but A365 is not enabled. " +
                 "Set `a365.enabled: true` or set `ENABLE_A365_OBSERVABILITY_EXPORTER=true` " +

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

@@ -1,3 +1,4 @@
+import type { ContextualTokenResolver } from "../exporter/Agent365ExporterOptions.js";
 /**
  * Cluster categories for A365 service endpoint resolution.
  * Mirrors the ClusterCategory enum from Agent365-nodejs.
@@ -16,8 +17,16 @@ export interface A365Options {
      * Token resolver for authenticating with the A365 observability service.
      * Called with (agentId, tenantId, authScopes) extracted from span attributes/config.
      * Must return a bearer token string or a promise resolving to one.
+     * When both this and {@link contextualTokenResolver} are set,
+     * {@link contextualTokenResolver} takes precedence.
      */
     tokenResolver?: (agentId: string, tenantId: string, authScopes?: string[]) => string | Promise<string>;
+    /**
+     * Contextual token resolver for authenticating with the A365 observability service.
+     * Receives rich context including the agentic user ID.
+     * Takes precedence over {@link tokenResolver} when set.
+     */
+    contextualTokenResolver?: ContextualTokenResolver;
     /** Cluster category for the A365 service endpoint. */
     clusterCategory?: ClusterCategory;
     /** Override the A365 observability service domain. */

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,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;;;;;;;;;;OAUG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;;;;;;;OAYG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,sDAAsD;IACtD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,iFAAiF;IACjF,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"A365ConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEtF;;;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;;;;;;OAMG;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;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAElD,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;;;;;;;;;;OAUG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;;;;;;;OAYG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,sDAAsD;IACtD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,iFAAiF;IACjF,8BAA8B,CAAC,EAAE,MAAM,CAAC;IAExC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

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

@@ -85,8 +85,32 @@ export declare class OpenTelemetryConstants {
     static readonly TELEMETRY_SDK_NAME_KEY = "telemetry.sdk.name";
     static readonly TELEMETRY_SDK_LANGUAGE_KEY = "telemetry.sdk.language";
     static readonly TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version";
-    static readonly TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK";
+    static readonly TELEMETRY_SDK_NAME_VALUE = "microsoft-opentelemetry";
     static readonly TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
-    static readonly TELEMETRY_SDK_VERSION_VALUE = "1.0.1";
+    static readonly TELEMETRY_SDK_VERSION_VALUE = "1.1.0";
+    static readonly APPLY_GUARDRAIL_OPERATION_NAME = "apply_guardrail";
+    static readonly GUARDIAN_ID_KEY = "microsoft.guardian.id";
+    static readonly GUARDIAN_NAME_KEY = "microsoft.guardian.name";
+    static readonly GUARDIAN_PROVIDER_NAME_KEY = "microsoft.guardian.provider.name";
+    static readonly GUARDIAN_VERSION_KEY = "microsoft.guardian.version";
+    static readonly SECURITY_DECISION_TYPE_KEY = "microsoft.security.decision.type";
+    static readonly SECURITY_DECISION_REASON_KEY = "microsoft.security.decision.reason";
+    static readonly SECURITY_DECISION_CODE_KEY = "microsoft.security.decision.code";
+    static readonly SECURITY_TARGET_TYPE_KEY = "microsoft.security.target.type";
+    static readonly SECURITY_TARGET_ID_KEY = "microsoft.security.target.id";
+    static readonly SECURITY_POLICY_ID_KEY = "microsoft.security.policy.id";
+    static readonly SECURITY_POLICY_NAME_KEY = "microsoft.security.policy.name";
+    static readonly SECURITY_POLICY_VERSION_KEY = "microsoft.security.policy.version";
+    static readonly SECURITY_POLICY_DECISION_TYPE_KEY = "microsoft.security.policy.decision.type";
+    static readonly SECURITY_CONTENT_INPUT_HASH_KEY = "microsoft.security.content.input.hash";
+    static readonly SECURITY_CONTENT_MODIFIED_KEY = "microsoft.security.content.modified";
+    static readonly SECURITY_CONTENT_INPUT_VALUE_KEY = "microsoft.security.content.input.value";
+    static readonly SECURITY_CONTENT_OUTPUT_VALUE_KEY = "microsoft.security.content.output.value";
+    static readonly SECURITY_EXTERNAL_EVENT_ID_KEY = "microsoft.security.external_event_id";
+    static readonly SECURITY_FINDING_EVENT_NAME = "microsoft.security.finding";
+    static readonly SECURITY_RISK_CATEGORY_KEY = "microsoft.security.risk.category";
+    static readonly SECURITY_RISK_SEVERITY_KEY = "microsoft.security.risk.severity";
+    static readonly SECURITY_RISK_SCORE_KEY = "microsoft.security.risk.score";
+    static readonly SECURITY_RISK_METADATA_KEY = "microsoft.security.risk.metadata";
 }
 //# 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":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/a365/constants.js

@@ -111,9 +111,41 @@ class OpenTelemetryConstants {
     static TELEMETRY_SDK_NAME_KEY = "telemetry.sdk.name";
     static TELEMETRY_SDK_LANGUAGE_KEY = "telemetry.sdk.language";
     static TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version";
-    static TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK";
+    static TELEMETRY_SDK_NAME_VALUE = "microsoft-opentelemetry";
     static TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
     static TELEMETRY_SDK_VERSION_VALUE = types_js_1.MICROSOFT_OPENTELEMETRY_VERSION;
+    // Guardrail operation name
+    static APPLY_GUARDRAIL_OPERATION_NAME = "apply_guardrail";
+    // Guardian attributes
+    static GUARDIAN_ID_KEY = "microsoft.guardian.id";
+    static GUARDIAN_NAME_KEY = "microsoft.guardian.name";
+    static GUARDIAN_PROVIDER_NAME_KEY = "microsoft.guardian.provider.name";
+    static GUARDIAN_VERSION_KEY = "microsoft.guardian.version";
+    // Security decision attributes
+    static SECURITY_DECISION_TYPE_KEY = "microsoft.security.decision.type";
+    static SECURITY_DECISION_REASON_KEY = "microsoft.security.decision.reason";
+    static SECURITY_DECISION_CODE_KEY = "microsoft.security.decision.code";
+    // Security target attributes
+    static SECURITY_TARGET_TYPE_KEY = "microsoft.security.target.type";
+    static SECURITY_TARGET_ID_KEY = "microsoft.security.target.id";
+    // Security policy attributes
+    static SECURITY_POLICY_ID_KEY = "microsoft.security.policy.id";
+    static SECURITY_POLICY_NAME_KEY = "microsoft.security.policy.name";
+    static SECURITY_POLICY_VERSION_KEY = "microsoft.security.policy.version";
+    static SECURITY_POLICY_DECISION_TYPE_KEY = "microsoft.security.policy.decision.type";
+    // Security content attributes
+    static SECURITY_CONTENT_INPUT_HASH_KEY = "microsoft.security.content.input.hash";
+    static SECURITY_CONTENT_MODIFIED_KEY = "microsoft.security.content.modified";
+    static SECURITY_CONTENT_INPUT_VALUE_KEY = "microsoft.security.content.input.value";
+    static SECURITY_CONTENT_OUTPUT_VALUE_KEY = "microsoft.security.content.output.value";
+    // Security correlation attributes
+    static SECURITY_EXTERNAL_EVENT_ID_KEY = "microsoft.security.external_event_id";
+    // Security finding event
+    static SECURITY_FINDING_EVENT_NAME = "microsoft.security.finding";
+    static SECURITY_RISK_CATEGORY_KEY = "microsoft.security.risk.category";
+    static SECURITY_RISK_SEVERITY_KEY = "microsoft.security.risk.severity";
+    static SECURITY_RISK_SCORE_KEY = "microsoft.security.risk.score";
+    static SECURITY_RISK_METADATA_KEY = "microsoft.security.risk.metadata";
 }
 exports.OpenTelemetryConstants = OpenTelemetryConstants;
 //# sourceMappingURL=constants.js.map

package/dist/commonjs/a365/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,0CAA8D;AAE9D;;;;;;;GAOG;AACH,MAAa,sBAAsB;IACjC,qEAAqE;IAC9D,MAAM,CAAU,2BAA2B,GAAG,cAAc,CAAC;IAC7D,MAAM,CAAU,2BAA2B,GAAG,cAAc,CAAC;IAC7D,MAAM,CAAU,8BAA8B,GAAG,iBAAiB,CAAC;IACnE,MAAM,CAAU,mBAAmB,GAAG,MAAM,CAAC;IAEpD,qEAAqE;IAC9D,MAAM,CAAU,cAAc,GAAG,YAAY,CAAC;IAC9C,MAAM,CAAU,oBAAoB,GAAG,uBAAuB,CAAC;IAC/D,MAAM,CAAU,iBAAiB,GAAG,eAAe,CAAC;IACpD,MAAM,CAAU,gBAAgB,GAAG,cAAc,CAAC;IAClD,MAAM,CAAU,kBAAkB,GAAG,gBAAgB,CAAC;IACtD,MAAM,CAAU,eAAe,GAAG,aAAa,CAAC;IAChD,MAAM,CAAU,wBAAwB,GAAG,6BAA6B,CAAC;IAEhF,qEAAqE;IAC9D,MAAM,CAAU,WAAW,GAAG,aAAa,CAAC;IAEnD,qEAAqE;IAC9D,MAAM,CAAU,2BAA2B,GAAG,yCAAyC,CAAC;IACxF,MAAM,CAAU,qBAAqB,GAAG,6CAA6C,CAAC;IACtF,MAAM,CAAU,mCAAmC,GACxD,gDAAgD,CAAC;IAC5C,MAAM,CAAU,oBAAoB,GAAG,sBAAsB,CAAC;IAC9D,MAAM,CAAU,kCAAkC,GAAG,oCAAoC,CAAC;IAC1F,MAAM,CAAU,yBAAyB,GAAG,2BAA2B,CAAC;IAE/E,oEAAoE;IAC7D,MAAM,CAAU,yBAAyB,GAAG,uBAAuB,CAAC;IACpE,MAAM,CAAU,wBAAwB,GAAG,sBAAsB,CAAC;IAClE,MAAM,CAAU,yBAAyB,GAAG,uBAAuB,CAAC;IACpE,MAAM,CAAU,kCAAkC,GAAG,gCAAgC,CAAC;IACtF,MAAM,CAAU,wBAAwB,GAAG,sBAAsB,CAAC;IAClE,MAAM,CAAU,6BAA6B,GAAG,2BAA2B,CAAC;IAC5E,MAAM,CAAU,8BAA8B,GAAG,4BAA4B,CAAC;IAC9E,MAAM,CAAU,wBAAwB,GAAG,sBAAsB,CAAC;IAClE,MAAM,CAAU,aAAa,GAAG,eAAe,CAAC;IAEvD,oEAAoE;IAC7D,MAAM,CAAU,4CAA4C,GACjE,kCAAkC,CAAC;IAC9B,MAAM,CAAU,qCAAqC,GAAG,2BAA2B,CAAC;IAE3F,oEAAoE;IAC7D,MAAM,CAAU,6BAA6B,GAAG,2BAA2B,CAAC;IAC5E,MAAM,CAAU,8BAA8B,GAAG,4BAA4B,CAAC;IAErF,oEAAoE;IAC7D,MAAM,CAAU,8BAA8B,GAAG,4BAA4B,CAAC;IAC9E,MAAM,CAAU,yBAAyB,GAAG,uBAAuB,CAAC;IACpE,MAAM,CAAU,0BAA0B,GAAG,wBAAwB,CAAC;IACtE,MAAM,CAAU,gCAAgC,GACrD,wCAAwC,CAAC;IAE3C,oEAAoE;IAC7D,MAAM,CAAU,mBAAmB,GAAG,iBAAiB,CAAC;IACxD,MAAM,CAAU,qBAAqB,GAAG,mBAAmB,CAAC;IAC5D,MAAM,CAAU,4BAA4B,GAAG,0BAA0B,CAAC;IAC1E,MAAM,CAAU,wBAAwB,GAAG,sBAAsB,CAAC;IAClE,MAAM,CAAU,4BAA4B,GAAG,kCAAkC,CAAC;IAClF,MAAM,CAAU,gCAAgC,GAAG,sCAAsC,CAAC;IAC1F,MAAM,CAAU,mBAAmB,GAAG,0BAA0B,CAAC;IACjE,MAAM,CAAU,YAAY,GAAG,iBAAiB,CAAC;IAExD,oEAAoE;IAC7D,MAAM,CAAU,0BAA0B,GAAG,wBAAwB,CAAC;IACtE,MAAM,CAAU,iCAAiC,GAAG,kCAAkC,CAAC;IACvF,MAAM,CAAU,cAAc,GAAG,sBAAsB,CAAC;IACxD,MAAM,CAAU,uBAAuB,GAAG,+BAA+B,CAAC;IAEjF,oEAAoE;IAC7D,MAAM,CAAU,uBAAuB,GAAG,qBAAqB,CAAC;IAChE,MAAM,CAAU,oBAAoB,GAAG,kBAAkB,CAAC;IAC1D,MAAM,CAAU,2BAA2B,GAAG,yBAAyB,CAAC;IACxE,MAAM,CAAU,oBAAoB,GAAG,4BAA4B,CAAC;IACpE,MAAM,CAAU,2BAA2B,GAAG,yBAAyB,CAAC;IACxE,MAAM,CAAU,oBAAoB,GAAG,kBAAkB,CAAC;IAEjE,oEAAoE;IAC7D,MAAM,CAAU,aAAa,GAAG,qBAAqB,CAAC;IAE7D,oEAAoE;IAC7D,MAAM,CAAU,WAAW,GAAG,SAAS,CAAC;IACxC,MAAM,CAAU,aAAa,GAAG,WAAW,CAAC;IAC5C,MAAM,CAAU,cAAc,GAAG,YAAY,CAAC;IAC9C,MAAM,CAAU,2BAA2B,GAAG,gBAAgB,CAAC;IAEtE,oEAAoE;IAC7D,MAAM,CAAU,+BAA+B,GAAG,qCAAqC,CAAC;IACxF,MAAM,CAAU,6BAA6B,GAAG,wCAAwC,CAAC;IACzF,MAAM,CAAU,4BAA4B,GAAG,kCAAkC,CAAC;IAClF,MAAM,CAAU,0BAA0B,GAAG,gCAAgC,CAAC;IAC9E,MAAM,CAAU,sCAAsC,GAC3D,0CAA0C,CAAC;IACtC,MAAM,CAAU,mCAAmC,GACxD,yCAAyC,CAAC;IACrC,MAAM,CAAU,+BAA+B,GAAG,qCAAqC,CAAC;IAE/F,oEAAoE;IAC7D,MAAM,CAAU,qBAAqB,GAAG,yBAAyB,CAAC;IAClE,MAAM,CAAU,sBAAsB,GAAG,4BAA4B,CAAC;IACtE,MAAM,CAAU,6BAA6B,GAAG,mCAAmC,CAAC;IAE3F,oEAAoE;IAC7D,MAAM,CAAU,kBAAkB,GAAG,gBAAgB,CAAC;IACtD,MAAM,CAAU,4BAA4B,GAAG,0BAA0B,CAAC;IAEjF,oEAAoE;IAC7D,MAAM,CAAU,gBAAgB,GAAG,wBAAwB,CAAC;IAC5D,MAAM,CAAU,gBAAgB,GAAG,wBAAwB,CAAC;IAEnE,oEAAoE;IAC7D,MAAM,CAAU,yBAAyB,GAAG,uBAAuB,CAAC;IACpE,MAAM,CAAU,oBAAoB,GAAG,kBAAkB,CAAC;IAEjE,oEAAoE;IAC7D,MAAM,CAAU,gBAAgB,GAAG,cAAc,CAAC;IAEzD,oEAAoE;IAC7D,MAAM,CAAU,sBAAsB,GAAG,oBAAoB,CAAC;IAC9D,MAAM,CAAU,0BAA0B,GAAG,wBAAwB,CAAC;IACtE,MAAM,CAAU,yBAAyB,GAAG,uBAAuB,CAAC;IACpE,MAAM,CAAU,wBAAwB,GAAG,sBAAsB,CAAC;IAClE,MAAM,CAAU,4BAA4B,GAAG,QAAQ,CAAC;IACxD,MAAM,CAAU,2BAA2B,GAAG,0CAA+B,CAAC;;AA7HvF,wDA8HC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"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"}

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

@@ -5,7 +5,8 @@
  * following OTel gen-ai semantic conventions.
  */
 import type { SpanKind, TimeInput, Link, Context, TraceState } from "@opentelemetry/api";
-export declare const A365_MESSAGE_SCHEMA_VERSION: "0.1.0";
+/** Default finish reason applied when none is provided (per OTel spec). */
+export declare const DEFAULT_FINISH_REASON: "stop";
 /** Role of a message participant per OTEL gen-ai semantic conventions. */
 export declare enum MessageRole {
     SYSTEM = "system",
@@ -120,23 +121,22 @@ export interface ChatMessage {
     parts: MessagePart[];
     name?: string;
 }
-/** Versioned wrapper for input messages. */
 export interface InputMessages {
-    version: typeof A365_MESSAGE_SCHEMA_VERSION;
     messages: ChatMessage[];
 }
-/** An output message produced by a model (OTEL gen-ai semantic conventions). */
+/**
+ * An output message produced by a model (OTEL gen-ai semantic conventions).
+ * `finish_reason` defaults to `"stop"` per OTel spec when not provided.
+ */
 export interface OutputMessage extends ChatMessage {
     finish_reason?: FinishReason | string;
 }
-/** Versioned wrapper for output messages. */
 export interface OutputMessages {
-    version: typeof A365_MESSAGE_SCHEMA_VERSION;
     messages: OutputMessage[];
 }
-/** Accepted input for `recordInputMessages`. */
+/** Accepted input for `recordInputMessages`. Supports a single string, an array of strings (backward compat), or the structured wrapper. */
 export type InputMessagesParam = string | string[] | InputMessages;
-/** Accepted input for `recordOutputMessages`. */
+/** Accepted input for `recordOutputMessages`. Supports a single string, an array of strings (backward compat), or the structured wrapper. */
 export type OutputMessagesParam = string | string[] | OutputMessages;
 /** Accepted input for `OutputResponse.messages`. */
 export type ResponseMessagesParam = OutputMessagesParam | Record<string, unknown>;
@@ -247,4 +247,104 @@ export interface SpanDetails {
     spanKind?: SpanKind;
     spanLinks?: Link[];
 }
+/**
+ * The decision made by a security guardian during guardrail evaluation.
+ */
+export declare enum GuardrailDecisionType {
+    /** Content or action is allowed to proceed. */
+    Allow = "allow",
+    /** Content or action is logged for review but allowed to proceed. */
+    Audit = "audit",
+    /** Content or action is denied/blocked. */
+    Deny = "deny",
+    /** Content was modified (e.g., redacted, sanitized, rewritten). */
+    Modify = "modify",
+    /** Content or action triggered a warning but is allowed to proceed. */
+    Warn = "warn"
+}
+/**
+ * Well-known severity levels for security risks detected by guardrails.
+ */
+export declare const GuardrailRiskSeverity: {
+    readonly None: "none";
+    readonly Low: "low";
+    readonly Medium: "medium";
+    readonly High: "high";
+    readonly Critical: "critical";
+};
+/**
+ * Well-known values for the type of content or action a guardrail is applied to.
+ * Custom strings are also accepted.
+ */
+export declare const GuardrailTargetType: {
+    readonly LlmInput: "llm_input";
+    readonly LlmOutput: "llm_output";
+    readonly ToolCall: "tool_call";
+    readonly ToolDefinition: "tool_definition";
+    readonly MemoryStore: "memory_store";
+    readonly MemoryRetrieve: "memory_retrieve";
+    readonly KnowledgeQuery: "knowledge_query";
+    readonly KnowledgeResult: "knowledge_result";
+    readonly Message: "message";
+};
+/**
+ * Details of a guardrail evaluation for security operations tracing.
+ */
+export interface GuardrailDetails {
+    /** The type of content or action the guardrail is applied to (required). */
+    targetType: string;
+    /** The decision made by the guardian (required). */
+    decisionType: GuardrailDecisionType;
+    /** Human-readable name of the guardian. */
+    guardianName?: string;
+    /** Unique identifier of the guardian. */
+    guardianId?: string;
+    /** Provider of the guardian service (e.g., azure.ai.content_safety). */
+    guardianProviderName?: string;
+    /** Version of the guardian. */
+    guardianVersion?: string;
+    /** Identifier of the target being guarded. */
+    targetId?: string;
+    /** Human-readable explanation for the decision. */
+    decisionReason?: string;
+    /** Machine-readable decision code. */
+    decisionCode?: string;
+    /** Identifier of the policy that triggered the decision. */
+    policyId?: string;
+    /** Human-readable name of the policy. */
+    policyName?: string;
+    /** Version of the policy. */
+    policyVersion?: string;
+    /** Hash of the input content for forensic correlation. */
+    contentInputHash?: string;
+    /** Whether content was modified by the guardrail. */
+    contentModified?: boolean;
+    /** External correlation identifier for SIEM systems. */
+    externalEventId?: string;
+}
+/**
+ * Represents a single security finding detected during guardian evaluation.
+ * Multiple findings may be emitted for a single guardrail span.
+ */
+export interface GuardrailFinding {
+    /** The category of security risk detected (required). */
+    riskCategory: string;
+    /** The severity level of the detected risk (required). */
+    riskSeverity: string;
+    /** The decision type for this specific policy finding. */
+    policyDecisionType?: string;
+    /** Identifier of the policy that triggered the finding. */
+    policyId?: string;
+    /** Human-readable name of the triggered policy. */
+    policyName?: string;
+    /** Version of the policy. */
+    policyVersion?: string;
+    /** Numeric risk/confidence score (0.0 to 1.0). */
+    riskScore?: number;
+    /**
+     * Non-content metadata about the detected risk (MUST NOT contain PII).
+     * Example values: "field:bcc", "pattern:ssn", "count:3".
+     */
+    riskMetadata?: string[];
+}
 //# sourceMappingURL=contracts.d.ts.map