@microsoft/opentelemetry 1.3.0 → 1.5.0

package/README.md

@@ -88,6 +88,38 @@ useMicrosoftOpenTelemetry({
 });
 ```
 
+When you enable the A365 HTTP exporter, durable delivery is enabled by default. Tune the durable
+store if you need a protected persistent volume or different bounds:
+
+```typescript
+useMicrosoftOpenTelemetry({
+  a365: {
+    enabled: true,
+    enableObservabilityExporter: true,
+    tokenResolver: (agentId, tenantId, authScopes) => getToken(agentId, tenantId, authScopes),
+    durableDelivery: {
+      storageDirectory: process.env.A365_DURABLE_STORAGE_DIRECTORY,
+      maxStorageBytes: 50 * 1024 * 1024,
+      maxRecordAgeMilliseconds: 2 * 24 * 60 * 60 * 1000,
+    },
+  },
+});
+```
+
+Set `durableDelivery.enabled: false` to force legacy network-only delivery.
+
+With durable delivery enabled, retryable A365 exporter payloads (including HTTP 401, 408, 429,
+and 5xx responses) are stored as plaintext local files in a stable per-application partition and
+replayed with a freshly resolved token plus the exporter's current cluster/domain routing; durable
+files never store bearer tokens or authoritative route metadata. Delivery is at-least-once, so
+duplicates are possible. The SDK restricts durable storage to the current user and Administrators
+on Windows and uses owner-only `0700` directories and `0600` files on POSIX. Use a protected
+persistent volume if records must survive container or host restarts; ephemeral container storage
+only survives process restarts and still counts against the container's ephemeral-storage quota.
+If durable storage permissions cannot be secured, the exporter logs the initialization failure and
+degrades to network-only delivery; successful and non-retryable live sends still complete, but
+retryable results that cannot be persisted fail.
+
 For A365 scenarios, scope APIs, baggage, hosting middleware, and official terminology alignment, see [A365_DOCUMENTATION.md](./A365_DOCUMENTATION.md).
 
 ### Azure Monitor
@@ -119,19 +151,19 @@ That's it — traces, metrics, and logs are collected automatically with built-i
 
 ### `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                                                                                                               |
 | `enableSensitiveData`    | `boolean`                          | `false`       | Capture GenAI message content (prompts, completions, tool args/results, system instructions) on LangChain spans. Only enable in trusted, non-production environments |
 
 ### `InstrumentationOptions`
@@ -256,6 +288,7 @@ See the [OpenTelemetry OTLP Exporter specification](https://opentelemetry.io/doc
 | `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                                                                                                                                                                                                |
+| `durableDelivery`             | `Agent365DurableDeliveryOptions`                                               | enabled with defaults                                     | Enabled-by-default local store-and-replay for retryable A365 HTTP export requests when the A365 HTTP exporter is active. Set `durableDelivery.enabled: false` to force network-only delivery. Replays use fresh tokens/current routing, records stay in bounded plaintext local storage, and storage-init failures degrade to network-only delivery |
 
 When A365 export is enabled, Microsoft OpenTelemetry defaults to GenAI-focused telemetry. To opt back into non-GenAI auto-instrumentation, set explicit overrides:
 
@@ -325,14 +358,68 @@ 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                 |
-| `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        |
+| 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` | `900 * 1024` | Maximum estimated payload size (bytes) per HTTP chunk        |
+
+#### A365 durable delivery
+
+Durable delivery applies only to the A365 HTTP exporter, so set both `a365.enabled: true` and
+`a365.enableObservabilityExporter: true` when you use it. Durable delivery is enabled by default;
+set `durableDelivery.enabled: false` to force legacy network-only delivery.
+
+| Option                               | Type      | Default                   | Description                                                                                                                                                                                                                                                                                |
+| ------------------------------------ | --------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `enabled`                            | `boolean` | `true`                    | Durable delivery stays on unless you explicitly disable it                                                                                                                                                                                                                                  |
+| `storageDirectory`                   | `string`  | auto                      | Root directory for durable records. When omitted, the SDK probes `LOCALAPPDATA`, then `TEMP`, then `os.tmpdir()` on Windows and appends `Microsoft/A365/otel-durable`; on POSIX it probes `TMPDIR`, then `/var/tmp`, then `/tmp` and uses the single `a365-otel-durable-<uid>` leaf. Every base root then gets a stable per-application `app-<hash>` child |
+| `maxStorageBytes`                    | `number`  | `50 * 1024 * 1024`        | Maximum total bytes retained for pending and quarantined durable records                                                                                                                                                                                                                   |
+| `maxRecordAgeMilliseconds`           | `number`  | `2 * 24 * 60 * 60 * 1000` | Maximum record age before expiry pruning                                                                                                                                                                                                                                                   |
+| `replayIntervalMilliseconds`         | `number`  | `2 * 60 * 1000`           | Delay between scheduled replay passes                                                                                                                                                                                                                                                      |
+| `maxReplayBatchSize`                 | `number`  | `10`                      | Maximum records claimed per replay pass                                                                                                                                                                                                                                                    |
+| `leaseDurationMilliseconds`          | `number`  | `2 * 60 * 1000`           | How long a claimed replay lease stays active before recovery                                                                                                                                                                                                                               |
+| `shutdownTimeoutMilliseconds`        | `number`  | `10_000`                  | Shared graceful-shutdown budget for accepted live exports and admitted durable handoff completion                                                                                                                                                                                          |
+| `tokenResolutionTimeoutMilliseconds` | `number`  | `30_000`                  | Timeout for each replay token-resolution attempt                                                                                                                                                                                                                                           |
+
+Operational notes:
+
+- Durable records are stored as plaintext JSON files. On POSIX, the SDK creates owner-only durable
+  directories/files (`0700` / `0600`). On Windows, the SDK removes inherited ACLs and grants full
+  control only to the current Windows identity and built-in Administrators. ACL hardening failures
+  cause durable storage initialization to fail and the exporter to use network-only delivery.
+- Durable delivery is enabled by default when the A365 HTTP exporter is active. Set
+  `durableDelivery.enabled: false` to force legacy network-only delivery.
+- Durable delivery is at-least-once. If a retryable request succeeds immediately before a crash or
+  after replay, duplicates are possible and receivers must be idempotent.
+- Every replay attempt and `forceFlush()` pass resolves a fresh token and uses the exporter's
+  current cluster/domain routing; durable files do not store bearer tokens or authoritative route
+  metadata.
+- If durable storage cannot initialize, the exporter logs the error and continues in network-only
+  mode. Successful and non-retryable live sends still complete, but retryable results that cannot
+  be persisted are reported as failures.
+- If token resolution returns no token, throws, or times out, live delivery attempts to persist the
+  record for replay and replay releases the claim without extending the shared transmission backoff.
+- Storage is bounded by both `maxStorageBytes` and `maxRecordAgeMilliseconds`; expired records are
+  pruned first, then the oldest retained records are evicted until the new record fits.
+- Live delivery and replay share the same `Retry-After` / exponential-backoff transmission gate, so
+  a retryable response (401, 408, 429, or 5xx) pauses both immediate sends and replay probes until
+  the gate reopens.
+- If you run in containers and need records to survive container restarts, rescheduling, or host
+  restarts outside the current container filesystem, set `storageDirectory` to a protected
+  persistent volume and size `maxStorageBytes` within your platform's storage quota.
+- During `shutdownMicrosoftOpenTelemetry()`, the exporter first waits up to
+  `shutdownTimeoutMilliseconds` for already accepted live exports to settle. When durable delivery
+  is enabled, it also stops replay scheduling immediately, aborts in-flight durable HTTP, and uses
+  the same deadline for already admitted durable handoff completion. Retryable aborted payloads
+  stay on disk for replay on the next process or startup pass; shutdown does not drain the existing
+  spool. If you use `Agent365Exporter` directly, you may call `forceFlush()` before shutdown for
+  one bounded replay pass. The distro shutdown path does not call `exporter.forceFlush()`. When
+  durable delivery is disabled—or durable storage never initialized and the exporter stayed
+  network-only—shutdown still drains accepted live exports but does not replay or persist anything.
 
 Example:
 
@@ -340,32 +427,38 @@ Example:
 useMicrosoftOpenTelemetry({
   a365: {
     enabled: true,
-    tokenResolver: (agentId, tenantId) => getToken(agentId, tenantId),
+    enableObservabilityExporter: true,
+    tokenResolver: (agentId, tenantId, authScopes) => getToken(agentId, tenantId, authScopes),
     maxQueueSize: 4096,
     maxExportBatchSize: 1024,
     scheduledDelayMilliseconds: 10000,
     httpRequestTimeoutMilliseconds: 15000,
+    durableDelivery: {
+      storageDirectory: process.env.A365_DURABLE_STORAGE_DIRECTORY,
+      maxStorageBytes: 50 * 1024 * 1024,
+      maxRecordAgeMilliseconds: 2 * 24 * 60 * 60 * 1000,
+    },
   },
 });
 ```
 
 #### 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`                                                                                              |
-| `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`)                                                                                 |
-| `A365_OBSERVABILITY_TOKEN_EXCHANGE_TIMEOUT_MS` | Per-attempt timeout (ms) for agentic token exchange; `0` or negative disables (default: `30000`)                                       |
+A365 also reads the following environment overrides:
+
+| Environment Variable                           | Description                                                                                                                                               |
+| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ENABLE_A365_OBSERVABILITY_EXPORTER`           | `"true"` / `"false"` — secondary toggle for the A365 HTTP exporter when `a365` options are provided in code; it does not enable `a365.enabled` on its own |
+| `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`)                                                                                                    |
+| `A365_OBSERVABILITY_TOKEN_EXCHANGE_TIMEOUT_MS` | Per-attempt timeout (ms) for agentic token exchange; `0` or negative disables (default: `30000`)                                                          |
 
 ### Example
 

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

@@ -1,4 +1,5 @@
 import type { A365Options, ClusterCategory } from "./A365ConfigurationOptions.js";
+import type { Agent365DurableDeliveryOptions } from "../exporter/durable/index.js";
 import type { ContextualTokenResolver } from "../exporter/Agent365ExporterOptions.js";
 /**
  * Environment variable names for A365 configuration.
@@ -64,6 +65,8 @@ export declare class A365Configuration {
     readonly maxExportBatchSize?: number;
     /** Maximum estimated payload size (bytes) per HTTP chunk. */
     readonly maxPayloadBytes?: number;
+    /** Durable delivery options for local spool-and-replay behavior. */
+    readonly durableDelivery?: Agent365DurableDeliveryOptions;
     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,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"}
+{"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,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AACnF,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;IAEzC,oEAAoE;IACpE,SAAgB,eAAe,CAAC,EAAE,8BAA8B,CAAC;gBAErD,OAAO,CAAC,EAAE,WAAW;IA6FjC,OAAO,CAAC,4BAA4B;CAiBrC"}

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

@@ -104,6 +104,8 @@ class A365Configuration {
     maxExportBatchSize;
     /** Maximum estimated payload size (bytes) per HTTP chunk. */
     maxPayloadBytes;
+    /** Durable delivery options for local spool-and-replay behavior. */
+    durableDelivery;
     constructor(options) {
         // 1. Set defaults
         let enabled = false;
@@ -178,6 +180,7 @@ class A365Configuration {
         this.httpRequestTimeoutMilliseconds = options?.httpRequestTimeoutMilliseconds;
         this.maxExportBatchSize = options?.maxExportBatchSize;
         this.maxPayloadBytes = options?.maxPayloadBytes;
+        this.durableDelivery = options?.durableDelivery;
         // Warn when A365-scoped options are set but A365 is not enabled
         if (!this.enabled) {
             this._warnIfOptionsSetButDisabled(options);
@@ -188,7 +191,8 @@ class A365Configuration {
             return;
         const hasNonTrivialOptions = options.tokenResolver !== undefined ||
             options.contextualTokenResolver !== undefined ||
-            options.domainOverride !== undefined;
+            options.domainOverride !== undefined ||
+            options.durableDelivery !== 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":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAIlC,8CAA8C;AAE9C;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,QAA4B;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACU,QAAA,aAAa,GAAG;IAC3B,gBAAgB,EAAE,oCAAoC;IACtD,WAAW,EAAE,oCAAoC;IACjD,MAAM,EAAE,oCAAoC;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,SAAS,EAAE,8BAA8B;CACjC,CAAC;AAEX,MAAM,kBAAkB,GAAG,qDAAqD,CAAC;AAEjF,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAC;IAC5D,OAAO;IACP,KAAK;IACL,MAAM;IACN,SAAS;IACT,cAAc;IACd,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,UAAU;IACV,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAa,iBAAiB;IAC5B,6CAA6C;IAC7B,OAAO,CAAU;IAEjC,+DAA+D;IAC/C,aAAa,CAIC;IAE9B,iFAAiF;IACjE,uBAAuB,CAA2B;IAElE,wBAAwB;IACR,eAAe,CAAkB;IAEjD,0DAA0D;IAC1C,cAAc,CAAU;IAExC,oDAAoD;IACpC,UAAU,CAAW;IAErC;;;;;;;;OAQG;IACa,2BAA2B,CAAU;IAErD;;;;;;OAMG;IACa,QAAQ,CAAU;IAElC,uDAAuD;IACvC,cAAc,CAAU;IAExC,kDAAkD;IAClC,YAAY,CAAU;IAEtC,yDAAyD;IACzC,0BAA0B,CAAU;IAEpD,sDAAsD;IACtC,2BAA2B,CAAU;IAErD,gDAAgD;IAChC,8BAA8B,CAAU;IAExD,gDAAgD;IAChC,kBAAkB,CAAU;IAE5C,6DAA6D;IAC7C,eAAe,CAAU;IAEzC,YAAY,OAAqB;QAC/B,kBAAkB;QAClB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,2BAA2B,GAAG,KAAK,CAAC;QACxC,IAAI,eAAe,GAAoB,MAAM,CAAC;QAC9C,IAAI,cAAc,GAAuB,OAAO,EAAE,cAAc,CAAC;QACjE,IAAI,UAAU,GAAa,OAAO,EAAE,UAAU,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEvE,gCAAgC;QAChC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;YACrC,2BAA2B;gBACzB,OAAO,CAAC,2BAA2B,IAAI,2BAA2B,CAAC;YACrE,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,eAAe,CAAC;QAC/D,CAAC;QAED,+DAA+D;QAC/D,0EAA0E;QAC1E,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACjF,IACE,WAAW,KAAK,SAAS;YACzB,OAAO,KAAK,SAAS;YACrB,OAAO,CAAC,2BAA2B,KAAK,SAAS,EACjD,CAAC;YACD,2BAA2B,GAAG,WAAW,CAAC;QAC5C,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAa,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;QACjE,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,2EAA2E;QAC3E,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,aAAa,GAAG,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,CAAC;QAClE,IAAI,aAAa,EAAE,CAAC;YAClB,UAAU,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QAC5D,IAAI,SAAS,EAAE,CAAC;YACd,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAa,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE,CAAC;QAC9E,IAAI,UAAU,IAAI,wBAAwB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,eAAe,GAAG,UAA6B,CAAC;QAClD,CAAC;aAAM,IAAI,UAAU,EAAE,CAAC;YACtB,IAAA,0BAAa,GAAE,CAAC,IAAI,CAClB,WAAW,qBAAa,CAAC,gBAAgB,WAAW,UAAU,oCAAoC,CACnG,CAAC;QACJ,CAAC;QAED,sEAAsE;QACtE,oEAAoE;QACpE,oEAAoE;QACpE,sEAAsE;QACtE,IAAI,QAAQ,GAAuB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC1E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAa,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;YACjE,IAAI,WAAW,EAAE,CAAC;gBAChB,QAAQ,GAAG,WAAW,CAAC;YACzB,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,2BAA2B,GAAG,2BAA2B,CAAC;QAC/D,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;QAC5C,IAAI,CAAC,uBAAuB,GAAG,OAAO,EAAE,uBAAuB,CAAC;QAChE,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;QACvD,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC1C,IAAI,CAAC,0BAA0B,GAAG,OAAO,EAAE,0BAA0B,CAAC;QACtE,IAAI,CAAC,2BAA2B,GAAG,OAAO,EAAE,2BAA2B,CAAC;QACxE,IAAI,CAAC,8BAA8B,GAAG,OAAO,EAAE,8BAA8B,CAAC;QAC9E,IAAI,CAAC,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,CAAC;QACtD,IAAI,CAAC,eAAe,GAAG,OAAO,EAAE,eAAe,CAAC;QAEhD,gEAAgE;QAChE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,4BAA4B,CAAC,OAAqB;QACxD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,oBAAoB,GACxB,OAAO,CAAC,aAAa,KAAK,SAAS;YACnC,OAAO,CAAC,uBAAuB,KAAK,SAAS;YAC7C,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;QAEvC,IAAI,oBAAoB,EAAE,CAAC;YACzB,IAAA,0BAAa,GAAE,CAAC,IAAI,CAClB,8DAA8D;gBAC5D,4EAA4E;gBAC5E,yEAAyE,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA5KD,8CA4KC"}
+{"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,4 +1,5 @@
 import type { ContextualTokenResolver } from "../exporter/Agent365ExporterOptions.js";
+import type { Agent365DurableDeliveryOptions } from "../exporter/durable/index.js";
 /**
  * Cluster categories for A365 service endpoint resolution.
  * Mirrors the ClusterCategory enum from Agent365-nodejs.
@@ -82,5 +83,7 @@ export interface A365Options {
     maxExportBatchSize?: number;
     /** Maximum estimated payload size (bytes) per HTTP chunk. */
     maxPayloadBytes?: number;
+    /** Durable delivery options for local spool-and-replay behavior. */
+    durableDelivery?: Agent365DurableDeliveryOptions;
 }
 //# 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,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"}
+{"version":3,"file":"A365ConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../../src/a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAEnF;;;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;IAEzB,oEAAoE;IACpE,eAAe,CAAC,EAAE,8BAA8B,CAAC;CAClD"}

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

@@ -1,3 +1,5 @@
+/** Internal baggage metadata key for registered custom attribute names. */
+export declare const INTERNAL_CUSTOM_KEYS_METADATA_KEY = "_internal.custom_keys";
 /**
  * OpenTelemetry constants for A365 observability.
  *
@@ -47,8 +49,16 @@ export declare class OpenTelemetryConstants {
     static readonly ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY";
     /** Attribute key for the gen-ai operation name (`gen_ai.operation.name`). */
     static readonly GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    /** Attribute key for the external data source identifier (`gen_ai.data_source.id`). */
+    static readonly GEN_AI_DATA_SOURCE_ID_KEY = "gen_ai.data_source.id";
+    /** Attribute key for the requested output type (`gen_ai.output.type`). */
+    static readonly GEN_AI_OUTPUT_TYPE_KEY = "gen_ai.output.type";
     /** Attribute key for the requested model name (`gen_ai.request.model`). */
     static readonly GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    /** Attribute key for the requested number of choices (`gen_ai.request.choice.count`). */
+    static readonly GEN_AI_REQUEST_CHOICE_COUNT_KEY = "gen_ai.request.choice.count";
+    /** Attribute key for the frequency penalty (`gen_ai.request.frequency_penalty`). */
+    static readonly GEN_AI_REQUEST_FREQUENCY_PENALTY_KEY = "gen_ai.request.frequency_penalty";
     /** Attribute key for the model that produced the response (`gen_ai.response.model`). */
     static readonly GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
     /** Attribute key for the finish reasons returned by the model (`gen_ai.response.finish_reasons`). */
@@ -57,6 +67,12 @@ export declare class OpenTelemetryConstants {
     static readonly GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
     /** Attribute key for the requested maximum number of tokens (`gen_ai.request.max_tokens`). */
     static readonly GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    /** Attribute key for the presence penalty (`gen_ai.request.presence_penalty`). */
+    static readonly GEN_AI_REQUEST_PRESENCE_PENALTY_KEY = "gen_ai.request.presence_penalty";
+    /** Attribute key for the request seed (`gen_ai.request.seed`). */
+    static readonly GEN_AI_REQUEST_SEED_KEY = "gen_ai.request.seed";
+    /** Attribute key for the stop sequences (`gen_ai.request.stop_sequences`). */
+    static readonly GEN_AI_REQUEST_STOP_SEQUENCES_KEY = "gen_ai.request.stop_sequences";
     /** Attribute key for the sampling temperature (`gen_ai.request.temperature`). */
     static readonly GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
     /** Attribute key for the nucleus-sampling top-p value (`gen_ai.request.top_p`). */
@@ -67,6 +83,10 @@ export declare class OpenTelemetryConstants {
     static readonly GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration";
     /** Metric name for gen-ai client token usage. */
     static readonly GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
+    /** Attribute key for the number of input tokens written into the cache (`gen_ai.usage.cache_write.input_tokens`). */
+    static readonly GEN_AI_USAGE_CACHE_WRITE_INPUT_TOKENS_KEY = "gen_ai.usage.cache_write.input_tokens";
+    /** Attribute key for the number of input tokens read from the cache (`gen_ai.usage.cache_read.input_tokens`). */
+    static readonly GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS_KEY = "gen_ai.usage.cache_read.input_tokens";
     /** Attribute key for the number of input (prompt) tokens (`gen_ai.usage.input_tokens`). */
     static readonly GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
     /** Attribute key for the number of output (completion) tokens (`gen_ai.usage.output_tokens`). */
@@ -170,7 +190,7 @@ export declare class OpenTelemetryConstants {
     /** Telemetry SDK language value reported by this distro. */
     static readonly TELEMETRY_SDK_LANGUAGE_VALUE = "nodejs";
     /** Telemetry SDK version value reported by this distro. */
-    static readonly TELEMETRY_SDK_VERSION_VALUE = "1.3.0";
+    static readonly TELEMETRY_SDK_VERSION_VALUE = "1.5.0";
     /** Operation name used for guardrail-evaluation spans. */
     static readonly APPLY_GUARDRAIL_OPERATION_NAME = "apply_guardrail";
     /** Attribute key for the guardian identifier (`microsoft.guardian.id`). */

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IAGjC,gFAAgF;IAChF,gBAAuB,2BAA2B,kBAAkB;IACpE,oDAAoD;IACpD,gBAAuB,2BAA2B,kBAAkB;IACpE,oDAAoD;IACpD,gBAAuB,8BAA8B,qBAAqB;IAC1E,0DAA0D;IAC1D,gBAAuB,mBAAmB,UAAU;IAIpD,0EAA0E;IAC1E,gBAAuB,cAAc,gBAAgB;IACrD,6DAA6D;IAC7D,gBAAuB,oBAAoB,2BAA2B;IACtE,0EAA0E;IAC1E,gBAAuB,iBAAiB,mBAAmB;IAC3D,gFAAgF;IAChF,gBAAuB,gBAAgB,kBAAkB;IACzD,6EAA6E;IAC7E,gBAAuB,kBAAkB,oBAAoB;IAC7D,qEAAqE;IACrE,gBAAuB,eAAe,iBAAiB;IACvD,sEAAsE;IACtE,gBAAuB,wBAAwB,iCAAiC;IAIhF,iEAAiE;IACjE,gBAAuB,WAAW,iBAAiB;IAInD,yEAAyE;IACzE,gBAAuB,2BAA2B,6CAA6C;IAC/F,0EAA0E;IAC1E,gBAAuB,qBAAqB,iDAAiD;IAC7F,kFAAkF;IAClF,gBAAuB,mCAAmC,oDACP;IACnD,4DAA4D;IAC5D,gBAAuB,oBAAoB,0BAA0B;IACrE,8EAA8E;IAC9E,gBAAuB,kCAAkC,wCAAwC;IACjG,iEAAiE;IACjE,gBAAuB,yBAAyB,+BAA+B;IAI/E,6EAA6E;IAC7E,gBAAuB,yBAAyB,2BAA2B;IAC3E,2EAA2E;IAC3E,gBAAuB,wBAAwB,0BAA0B;IACzE,wFAAwF;IACxF,gBAAuB,yBAAyB,2BAA2B;IAC3E,qGAAqG;IACrG,gBAAuB,kCAAkC,oCAAoC;IAC7F,2EAA2E;IAC3E,gBAAuB,wBAAwB,0BAA0B;IACzE,8FAA8F;IAC9F,gBAAuB,6BAA6B,+BAA+B;IACnF,iFAAiF;IACjF,gBAAuB,8BAA8B,gCAAgC;IACrF,mFAAmF;IACnF,gBAAuB,wBAAwB,0BAA0B;IACzE,2DAA2D;IAC3D,gBAAuB,aAAa,mBAAmB;IAIvD,4DAA4D;IAC5D,gBAAuB,4CAA4C,sCAC9B;IACrC,iDAAiD;IACjD,gBAAuB,qCAAqC,+BAA+B;IAI3F,2FAA2F;IAC3F,gBAAuB,6BAA6B,+BAA+B;IACnF,iGAAiG;IACjG,gBAAuB,8BAA8B,gCAAgC;IAIrF,gFAAgF;IAChF,gBAAuB,8BAA8B,gCAAgC;IACrF,iFAAiF;IACjF,gBAAuB,yBAAyB,2BAA2B;IAC3E,mFAAmF;IACnF,gBAAuB,0BAA0B,4BAA4B;IAC7E,0DAA0D;IAC1D,gBAAuB,gCAAgC,4CACZ;IAI3C,kEAAkE;IAClE,gBAAuB,mBAAmB,qBAAqB;IAC/D,sEAAsE;IACtE,gBAAuB,qBAAqB,uBAAuB;IACnE,4EAA4E;IAC5E,gBAAuB,4BAA4B,8BAA8B;IACjF,oEAAoE;IACpE,gBAAuB,wBAAwB,0BAA0B;IACzE,4FAA4F;IAC5F,gBAAuB,4BAA4B,sCAAsC;IACzF,4FAA4F;IAC5F,gBAAuB,gCAAgC,0CAA0C;IACjG,yEAAyE;IACzE,gBAAuB,mBAAmB,8BAA8B;IACxE,qFAAqF;IACrF,gBAAuB,YAAY,qBAAqB;IAIxD,gFAAgF;IAChF,gBAAuB,0BAA0B,4BAA4B;IAC7E,8FAA8F;IAC9F,gBAAuB,iCAAiC,sCAAsC;IAC9F,yEAAyE;IACzE,gBAAuB,cAAc,0BAA0B;IAC/D,mFAAmF;IACnF,gBAAuB,uBAAuB,mCAAmC;IAIjF,0EAA0E;IAC1E,gBAAuB,uBAAuB,yBAAyB;IACvE,4DAA4D;IAC5D,gBAAuB,oBAAoB,sBAAsB;IACjE,0EAA0E;IAC1E,gBAAuB,2BAA2B,6BAA6B;IAC/E,2FAA2F;IAC3F,gBAAuB,oBAAoB,gCAAgC;IAC3E,0EAA0E;IAC1E,gBAAuB,2BAA2B,6BAA6B;IAC/E,4DAA4D;IAC5D,gBAAuB,oBAAoB,sBAAsB;IAIjE,uEAAuE;IACvE,gBAAuB,aAAa,yBAAyB;IAI7D,yDAAyD;IACzD,gBAAuB,WAAW,aAAa;IAC/C,6DAA6D;IAC7D,gBAAuB,aAAa,eAAe;IACnD,+DAA+D;IAC/D,gBAAuB,cAAc,gBAAgB;IACrD,yEAAyE;IACzE,gBAAuB,2BAA2B,oBAAoB;IAItE,qEAAqE;IACrE,gBAAuB,+BAA+B,yCAAyC;IAC/F,gEAAgE;IAChE,gBAAuB,6BAA6B,4CAA4C;IAChG,kDAAkD;IAClD,gBAAuB,4BAA4B,sCAAsC;IACzF,wDAAwD;IACxD,gBAAuB,0BAA0B,oCAAoC;IACrF,gFAAgF;IAChF,gBAAuB,sCAAsC,8CAChB;IAC7C,iEAAiE;IACjE,gBAAuB,mCAAmC,6CACd;IAC5C,qDAAqD;IACrD,gBAAuB,+BAA+B,yCAAyC;IAI/F,yFAAyF;IACzF,gBAAuB,qBAAqB,6BAA6B;IACzE,uFAAuF;IACvF,gBAAuB,sBAAsB,gCAAgC;IAC7E,sGAAsG;IACtG,gBAAuB,6BAA6B,uCAAuC;IAI3F,gEAAgE;IAChE,gBAAuB,kBAAkB,oBAAoB;IAC7D,4EAA4E;IAC5E,gBAAuB,4BAA4B,8BAA8B;IAIjF,qEAAqE;IACrE,gBAAuB,gBAAgB,4BAA4B;IACnE,iFAAiF;IACjF,gBAAuB,gBAAgB,4BAA4B;IAInE,mFAAmF;IACnF,gBAAuB,yBAAyB,2BAA2B;IAC3E,iEAAiE;IACjE,gBAAuB,oBAAoB,sBAAsB;IAIjE,2DAA2D;IAC3D,gBAAuB,gBAAgB,kBAAkB;IAIzD,uEAAuE;IACvE,gBAAuB,sBAAsB,wBAAwB;IACrE,+EAA+E;IAC/E,gBAAuB,0BAA0B,4BAA4B;IAC7E,6EAA6E;IAC7E,gBAAuB,yBAAyB,2BAA2B;IAC3E,wDAAwD;IACxD,gBAAuB,wBAAwB,6BAA6B;IAC5E,4DAA4D;IAC5D,gBAAuB,4BAA4B,YAAY;IAC/D,2DAA2D;IAC3D,gBAAuB,2BAA2B,WAAmC;IAIrF,0DAA0D;IAC1D,gBAAuB,8BAA8B,qBAAqB;IAI1E,2EAA2E;IAC3E,gBAAuB,eAAe,2BAA2B;IACjE,uEAAuE;IACvE,gBAAuB,iBAAiB,6BAA6B;IACrE,yFAAyF;IACzF,gBAAuB,0BAA0B,sCAAsC;IACvF,6EAA6E;IAC7E,gBAAuB,oBAAoB,gCAAgC;IAI3E,0FAA0F;IAC1F,gBAAuB,0BAA0B,sCAAsC;IACvF,8FAA8F;IAC9F,gBAAuB,4BAA4B,wCAAwC;IAC3F,0FAA0F;IAC1F,gBAAuB,0BAA0B,sCAAsC;IAIvF,sFAAsF;IACtF,gBAAuB,wBAAwB,oCAAoC;IACnF,0FAA0F;IAC1F,gBAAuB,sBAAsB,kCAAkC;IAI/E,yFAAyF;IACzF,gBAAuB,sBAAsB,kCAAkC;IAC/E,qFAAqF;IACrF,gBAAuB,wBAAwB,oCAAoC;IACnF,2FAA2F;IAC3F,gBAAuB,2BAA2B,uCAAuC;IACzF,uGAAuG;IACvG,gBAAuB,iCAAiC,6CACZ;IAI5C,qGAAqG;IACrG,gBAAuB,+BAA+B,2CAA2C;IACjG,6GAA6G;IAC7G,gBAAuB,6BAA6B,yCAAyC;IAC7F,oGAAoG;IACpG,gBAAuB,gCAAgC,4CACZ;IAC3C,sGAAsG;IACtG,gBAAuB,iCAAiC,6CACZ;IAI5C,sHAAsH;IACtH,gBAAuB,8BAA8B,0CAA0C;IAI/F,gFAAgF;IAChF,gBAAuB,2BAA2B,gCAAgC;IAClF,yFAAyF;IACzF,gBAAuB,0BAA0B,sCAAsC;IACvF,yFAAyF;IACzF,gBAAuB,0BAA0B,sCAAsC;IACvF,kFAAkF;IAClF,gBAAuB,uBAAuB,mCAAmC;IACjF,wFAAwF;IACxF,gBAAuB,0BAA0B,sCAAsC;CACxF"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/a365/constants.js

@@ -2,8 +2,10 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenTelemetryConstants = void 0;
+exports.OpenTelemetryConstants = exports.INTERNAL_CUSTOM_KEYS_METADATA_KEY = void 0;
 const types_js_1 = require("../types.js");
+/** Internal baggage metadata key for registered custom attribute names. */
+exports.INTERNAL_CUSTOM_KEYS_METADATA_KEY = "_internal.custom_keys";
 /**
  * OpenTelemetry constants for A365 observability.
  *
@@ -58,8 +60,16 @@ class OpenTelemetryConstants {
     // ── GenAI core attributes ────────────────────────────────────────
     /** Attribute key for the gen-ai operation name (`gen_ai.operation.name`). */
     static GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    /** Attribute key for the external data source identifier (`gen_ai.data_source.id`). */
+    static GEN_AI_DATA_SOURCE_ID_KEY = "gen_ai.data_source.id";
+    /** Attribute key for the requested output type (`gen_ai.output.type`). */
+    static GEN_AI_OUTPUT_TYPE_KEY = "gen_ai.output.type";
     /** Attribute key for the requested model name (`gen_ai.request.model`). */
     static GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    /** Attribute key for the requested number of choices (`gen_ai.request.choice.count`). */
+    static GEN_AI_REQUEST_CHOICE_COUNT_KEY = "gen_ai.request.choice.count";
+    /** Attribute key for the frequency penalty (`gen_ai.request.frequency_penalty`). */
+    static GEN_AI_REQUEST_FREQUENCY_PENALTY_KEY = "gen_ai.request.frequency_penalty";
     /** Attribute key for the model that produced the response (`gen_ai.response.model`). */
     static GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
     /** Attribute key for the finish reasons returned by the model (`gen_ai.response.finish_reasons`). */
@@ -68,6 +78,12 @@ class OpenTelemetryConstants {
     static GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
     /** Attribute key for the requested maximum number of tokens (`gen_ai.request.max_tokens`). */
     static GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    /** Attribute key for the presence penalty (`gen_ai.request.presence_penalty`). */
+    static GEN_AI_REQUEST_PRESENCE_PENALTY_KEY = "gen_ai.request.presence_penalty";
+    /** Attribute key for the request seed (`gen_ai.request.seed`). */
+    static GEN_AI_REQUEST_SEED_KEY = "gen_ai.request.seed";
+    /** Attribute key for the stop sequences (`gen_ai.request.stop_sequences`). */
+    static GEN_AI_REQUEST_STOP_SEQUENCES_KEY = "gen_ai.request.stop_sequences";
     /** Attribute key for the sampling temperature (`gen_ai.request.temperature`). */
     static GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
     /** Attribute key for the nucleus-sampling top-p value (`gen_ai.request.top_p`). */
@@ -80,6 +96,10 @@ class OpenTelemetryConstants {
     /** Metric name for gen-ai client token usage. */
     static GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
     // ── GenAI usage ──────────────────────────────────────────────────
+    /** Attribute key for the number of input tokens written into the cache (`gen_ai.usage.cache_write.input_tokens`). */
+    static GEN_AI_USAGE_CACHE_WRITE_INPUT_TOKENS_KEY = "gen_ai.usage.cache_write.input_tokens";
+    /** Attribute key for the number of input tokens read from the cache (`gen_ai.usage.cache_read.input_tokens`). */
+    static GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS_KEY = "gen_ai.usage.cache_read.input_tokens";
     /** Attribute key for the number of input (prompt) tokens (`gen_ai.usage.input_tokens`). */
     static GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
     /** Attribute key for the number of output (completion) tokens (`gen_ai.usage.output_tokens`). */

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/a365/constants.ts"],"names":[],"mappings":"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"}
+{"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,6 +5,9 @@
  * following OTel gen-ai semantic conventions.
  */
 import type { SpanKind, TimeInput, Link, Context, TraceState } from "@opentelemetry/api";
+import type { ExecuteToolCallArguments } from "./tool-call-models.js";
+export { ToolCallAction, ToolCallOutcomeStatus, ToolPolicyDecision, ExecuteToolCallArguments, ExecuteToolCallResult, } from "./tool-call-models.js";
+export type { ToolCallExtensionData, ToolCallIdentifier, ToolCallContainer, ToolCallResource, ToolCallResultOutcome, ToolCallResultSensitivity, ToolCallResultPolicy, ToolCallResultSecurity, ToolCallResultPagination, ToolCallResultResource, } from "./tool-call-models.js";
 /** 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. */
@@ -168,6 +171,8 @@ export interface GenericPart {
     /** Additional, custom part fields. */
     [key: string]: unknown;
 }
+/** Content part accepted for system instructions. */
+export type SystemInstructionPart = TextPart | GenericPart;
 /** Union of all message part types per OTEL gen-ai semantic conventions. */
 export type MessagePart = TextPart | ToolCallRequestPart | ToolCallResponsePart | ReasoningPart | BlobPart | FilePart | UriPart | ServerToolCallPart | ServerToolCallResponsePart | GenericPart;
 /** An input message sent to a model (OTEL gen-ai semantic conventions). */
@@ -220,6 +225,8 @@ export interface Channel {
 export interface Request {
     /** The input content (prompt / messages) for the request. */
     content?: InputMessagesParam;
+    /** Name of the service or framework that initiated the operation. */
+    operationSource?: string;
     /** Identifier of the session this request belongs to. */
     sessionId?: string;
     /** The channel the request originated from. */
@@ -284,17 +291,61 @@ export interface ServiceEndpoint {
     /** Protocol scheme of the endpoint (e.g. `https`). */
     protocol?: string;
 }
+/** Request-side GenAI parameters captured for agent invocation telemetry. */
+export interface GenAiRequestParameters {
+    /** Name of the requested model. */
+    model?: string;
+    /** Seed used to make sampling reproducible. */
+    seed?: number;
+    /** Number of response choices requested from the model. */
+    choiceCount?: number;
+    /** Frequency penalty applied during token sampling. */
+    frequencyPenalty?: number;
+    /** Maximum number of tokens requested for generation. */
+    maxTokens?: number;
+    /** Presence penalty applied during token sampling. */
+    presencePenalty?: number;
+    /** Stop sequences supplied with the request. */
+    stopSequences?: string[];
+    /** Sampling temperature for the request. */
+    temperature?: number;
+    /** Nucleus-sampling top-p value for the request. */
+    topP?: number;
+    /** Identifier of the external data source used to ground the request. */
+    dataSourceId?: string;
+    /** Requested output type (for example, `json`). */
+    outputType?: string;
+    /** Structured system instructions provided to the model. */
+    systemInstructions?: SystemInstructionPart[];
+}
+/** Response-side GenAI parameters captured for agent invocation telemetry. */
+export interface GenAiResponseParameters {
+    /** Finish reasons returned by the model. */
+    finishReasons?: string[];
+    /** Number of input (prompt) tokens consumed by the response. */
+    inputTokens?: number;
+    /** Number of output (completion) tokens produced by the response. */
+    outputTokens?: number;
+    /** Number of input tokens written into the cache. */
+    cacheWriteInputTokens?: number;
+    /** Number of input tokens read from the cache. */
+    cacheReadInputTokens?: number;
+}
 /** Details for invoking agent scope. */
 export interface InvokeAgentScopeDetails {
     /** Endpoint the agent is being invoked on. */
     endpoint?: ServiceEndpoint;
+    /** Request-side GenAI parameters associated with the invoke-agent span. */
+    requestParameters?: GenAiRequestParameters;
+    /** Response-side GenAI parameters associated with the invoke-agent span. */
+    responseParameters?: GenAiResponseParameters;
 }
 /** Details of a tool call made by an agent. */
 export interface ToolCallDetails {
     /** Name of the tool being called (required). */
     toolName: string;
-    /** Arguments passed to the tool, as an object or serialized string. */
-    arguments?: Record<string, unknown> | string;
+    /** Arguments passed to the tool, as an object, execute-tool schema model, or serialized string. */
+    arguments?: Record<string, unknown> | ExecuteToolCallArguments | string;
     /** Unique identifier of the tool call. */
     toolCallId?: string;
     /** Human-readable description of the tool. */