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

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

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

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

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

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

@@ -0,0 +1,162 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A365Configuration = exports.A365_ENV_VARS = void 0;
+const index_js_1 = require("../../shared/logging/index.js");
+const jsonConfig_js_1 = require("../../shared/jsonConfig.js");
+/**
+ * Parse an environment variable as a boolean.
+ * Recognizes 'true', '1', 'yes', 'on' (case-insensitive) as true and
+ * 'false', '0', 'no', 'off' as false. Unset, empty, or unrecognized values
+ * are ignored and return undefined so they do not override an existing
+ * configuration value.
+ */
+function parseEnvBoolean(envValue) {
+    if (!envValue)
+        return undefined;
+    const normalized = envValue.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (["true", "1", "yes", "on"].includes(normalized)) {
+        return true;
+    }
+    if (["false", "0", "no", "off"].includes(normalized)) {
+        return false;
+    }
+    return undefined;
+}
+/**
+ * Environment variable names for A365 configuration.
+ * These match the upstream Agent365-nodejs conventions.
+ */
+exports.A365_ENV_VARS = {
+    EXPORTER_ENABLED: "ENABLE_A365_OBSERVABILITY_EXPORTER",
+    PER_REQUEST_EXPORT: "ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT",
+    AUTH_SCOPES: "A365_OBSERVABILITY_SCOPES_OVERRIDE",
+    DOMAIN: "A365_OBSERVABILITY_DOMAIN_OVERRIDE",
+    CLUSTER_CATEGORY: "CLUSTER_CATEGORY",
+};
+const DEFAULT_AUTH_SCOPE = "https://api.powerplatform.com/.default";
+const VALID_CLUSTER_CATEGORIES = new Set([
+    "local",
+    "dev",
+    "test",
+    "preprod",
+    "firstrelease",
+    "prod",
+    "gov",
+    "high",
+    "dod",
+    "mooncake",
+    "ex",
+    "rx",
+]);
+/**
+ * Resolved A365 configuration.
+ *
+ * Merges values from four sources (lowest to highest precedence):
+ *   1. Defaults
+ *   2. Programmatic options (`A365Options`)
+ *   3. JSON config (`applicationinsights.json` → `a365` key)
+ *   4. Environment variables (see `A365_ENV_VARS`)
+ */
+class A365Configuration {
+    /** Whether A365 observability is enabled. */
+    enabled;
+    /** Token resolver callback for A365 service authentication. */
+    tokenResolver;
+    /** Cluster category. */
+    clusterCategory;
+    /** Domain override for the A365 observability service. */
+    domainOverride;
+    /** OAuth scopes for A365 service authentication. */
+    authScopes;
+    /** Whether to use per-request export mode. */
+    perRequestExport;
+    /** Baggage options. */
+    baggage;
+    /** Hosting options. */
+    hosting;
+    constructor(options) {
+        // 1. Set defaults
+        let enabled = false;
+        let clusterCategory = "prod";
+        let domainOverride = options?.domainOverride;
+        let authScopes = options?.authScopes ?? [DEFAULT_AUTH_SCOPE];
+        let perRequestExport = false;
+        // 2. Apply programmatic options
+        if (options) {
+            enabled = options.enabled ?? enabled;
+            clusterCategory = options.clusterCategory ?? clusterCategory;
+            perRequestExport = options.perRequestExport ?? perRequestExport;
+        }
+        // 3. Apply JSON config (takes precedence over programmatic options)
+        const jsonA365 = jsonConfig_js_1.JsonConfig.getInstance().a365;
+        if (jsonA365) {
+            enabled = jsonA365.enabled ?? enabled;
+            clusterCategory = jsonA365.clusterCategory ?? clusterCategory;
+            domainOverride = jsonA365.domainOverride ?? domainOverride;
+            perRequestExport = jsonA365.perRequestExport ?? perRequestExport;
+            if (jsonA365.authScopes) {
+                authScopes = jsonA365.authScopes;
+            }
+        }
+        // 4. Apply environment variable overrides (highest precedence)
+        const envEnabled = parseEnvBoolean(process.env[exports.A365_ENV_VARS.EXPORTER_ENABLED]);
+        if (envEnabled !== undefined) {
+            enabled = envEnabled;
+        }
+        const envPerRequest = parseEnvBoolean(process.env[exports.A365_ENV_VARS.PER_REQUEST_EXPORT]);
+        if (envPerRequest !== undefined) {
+            perRequestExport = envPerRequest;
+        }
+        const envScopes = process.env[exports.A365_ENV_VARS.AUTH_SCOPES]?.trim();
+        if (envScopes) {
+            authScopes = envScopes.split(/\s+/).filter(Boolean);
+        }
+        const envDomain = process.env[exports.A365_ENV_VARS.DOMAIN]?.trim();
+        if (envDomain) {
+            domainOverride = envDomain.replace(/\/+$/, "");
+        }
+        const envCluster = process.env[exports.A365_ENV_VARS.CLUSTER_CATEGORY]?.toLowerCase();
+        if (envCluster && VALID_CLUSTER_CATEGORIES.has(envCluster)) {
+            clusterCategory = envCluster;
+        }
+        else if (envCluster) {
+            index_js_1.Logger.getInstance().warn(`Invalid ${exports.A365_ENV_VARS.CLUSTER_CATEGORY} value '${envCluster}'. Using default cluster category.`);
+        }
+        // Assign resolved values
+        this.enabled = enabled;
+        this.tokenResolver = options?.tokenResolver;
+        this.clusterCategory = clusterCategory;
+        this.domainOverride = domainOverride;
+        this.authScopes = authScopes;
+        this.perRequestExport = perRequestExport;
+        this.baggage = {
+            propagationEnabled: jsonA365?.baggage?.propagationEnabled ?? options?.baggage?.propagationEnabled ?? true,
+            enrichSpans: jsonA365?.baggage?.enrichSpans ?? options?.baggage?.enrichSpans ?? true,
+        };
+        this.hosting = {
+            enabled: jsonA365?.hosting?.enabled ?? options?.hosting?.enabled ?? false,
+        };
+        // Warn when A365-scoped options are set but A365 is not enabled
+        if (!this.enabled) {
+            this._warnIfOptionsSetButDisabled(options);
+        }
+    }
+    _warnIfOptionsSetButDisabled(options) {
+        if (!options)
+            return;
+        const hasNonTrivialOptions = options.tokenResolver !== undefined ||
+            options.domainOverride !== undefined ||
+            options.perRequestExport !== undefined ||
+            options.hosting?.enabled === true;
+        if (hasNonTrivialOptions) {
+            index_js_1.Logger.getInstance().warn("A365 configuration options are set but A365 is not enabled. " +
+                "Set `a365.enabled: true` or `ENABLE_A365_OBSERVABILITY_EXPORTER=true` to enable.");
+        }
+    }
+}
+exports.A365Configuration = A365Configuration;
+//# sourceMappingURL=A365Configuration.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,53 @@
+/**
+ * Cluster categories for A365 service endpoint resolution.
+ * Mirrors the ClusterCategory enum from Agent365-nodejs.
+ */
+export type ClusterCategory = "local" | "dev" | "test" | "preprod" | "firstrelease" | "prod" | "gov" | "high" | "dod" | "mooncake" | "ex" | "rx";
+/**
+ * A365 observability configuration options.
+ *
+ * These are the public-facing options passed via the `a365` scope
+ * of {@link MicrosoftOpenTelemetryOptions}.
+ */
+export interface A365Options {
+    /** Enable A365 observability. When false, no A365 components are created. */
+    enabled?: boolean;
+    /**
+     * Token resolver for authenticating with the A365 observability service.
+     * Called with (agentId, tenantId) extracted from span attributes.
+     * Must return a bearer token string or a promise resolving to one.
+     */
+    tokenResolver?: (agentId: string, tenantId: string) => string | Promise<string>;
+    /** Cluster category for the A365 service endpoint. */
+    clusterCategory?: ClusterCategory;
+    /** Override the A365 observability service domain. */
+    domainOverride?: string;
+    /** OAuth scopes for A365 service authentication. */
+    authScopes?: string[];
+    /**
+     * Use per-request export mode (buffer spans per trace, export on root completion).
+     * When false, uses standard batch export.
+     * @default false
+     */
+    perRequestExport?: boolean;
+    /** Baggage propagation and span enrichment options. */
+    baggage?: A365BaggageOptions;
+    /** Hosting middleware options (requires @microsoft/agents-hosting). */
+    hosting?: A365HostingOptions;
+}
+/** Baggage propagation and span enrichment options. */
+export interface A365BaggageOptions {
+    /** Enable baggage propagation from request headers to span context. */
+    propagationEnabled?: boolean;
+    /** Copy baggage items to span attributes. */
+    enrichSpans?: boolean;
+}
+/** Hosting middleware options. */
+export interface A365HostingOptions {
+    /**
+     * Enable hosting middleware integration (baggage middleware, output logging, etc.).
+     * Requires `@microsoft/agents-hosting` as an optional peer dependency.
+     */
+    enabled?: boolean;
+}
+//# sourceMappingURL=A365ConfigurationOptions.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=A365ConfigurationOptions.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A365_ENV_VARS = exports.A365Configuration = void 0;
+var A365Configuration_js_1 = require("./A365Configuration.js");
+Object.defineProperty(exports, "A365Configuration", { enumerable: true, get: function () { return A365Configuration_js_1.A365Configuration; } });
+Object.defineProperty(exports, "A365_ENV_VARS", { enumerable: true, get: function () { return A365Configuration_js_1.A365_ENV_VARS; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/a365/configuration/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,+DAA0E;AAAjE,yHAAA,iBAAiB,OAAA;AAAE,qHAAA,aAAa,OAAA"}

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

@@ -0,0 +1,76 @@
+/**
+ * OpenTelemetry constants for A365 observability.
+ *
+ * Attribute keys follow OTel gen-ai semantic conventions plus
+ * Microsoft-specific extensions under the `microsoft.*` namespace.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/constants.ts
+ */
+export declare class OpenTelemetryConstants {
+    static readonly INVOKE_AGENT_OPERATION_NAME = "invoke_agent";
+    static readonly EXECUTE_TOOL_OPERATION_NAME = "execute_tool";
+    static readonly OUTPUT_MESSAGES_OPERATION_NAME = "output_messages";
+    static readonly CHAT_OPERATION_NAME = "chat";
+    static readonly ERROR_TYPE_KEY = "error.type";
+    static readonly ERROR_TYPE_CANCELLED = "TaskCanceledException";
+    static readonly ERROR_MESSAGE_KEY = "error.message";
+    static readonly AZ_NAMESPACE_KEY = "az.namespace";
+    static readonly SERVER_ADDRESS_KEY = "server.address";
+    static readonly SERVER_PORT_KEY = "server.port";
+    static readonly SOURCE_NAME = "Agent365Sdk";
+    static readonly GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    static readonly GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    static readonly GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
+    static readonly GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
+    static readonly GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    static readonly GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
+    static readonly GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens";
+    static readonly GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions";
+    static readonly GEN_AI_INPUT_MESSAGES_KEY = "gen_ai.input.messages";
+    static readonly GEN_AI_OUTPUT_MESSAGES_KEY = "gen_ai.output.messages";
+    static readonly A365_MESSAGES_SCHEMA_VERSION_KEY = "microsoft.a365.messages.schema_version";
+    static readonly GEN_AI_AGENT_ID_KEY = "gen_ai.agent.id";
+    static readonly GEN_AI_AGENT_NAME_KEY = "gen_ai.agent.name";
+    static readonly GEN_AI_AGENT_DESCRIPTION_KEY = "gen_ai.agent.description";
+    static readonly GEN_AI_AGENT_VERSION_KEY = "gen_ai.agent.version";
+    static readonly GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id";
+    static readonly GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process";
+    static readonly GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    static readonly GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
+    static readonly GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link";
+    static readonly SESSION_ID_KEY = "microsoft.session.id";
+    static readonly SESSION_DESCRIPTION_KEY = "microsoft.session.description";
+    static readonly GEN_AI_TOOL_CALL_ID_KEY = "gen_ai.tool.call.id";
+    static readonly GEN_AI_TOOL_NAME_KEY = "gen_ai.tool.name";
+    static readonly GEN_AI_TOOL_DESCRIPTION_KEY = "gen_ai.tool.description";
+    static readonly GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.call.arguments";
+    static readonly GEN_AI_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result";
+    static readonly GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type";
+    static readonly TENANT_ID_KEY = "microsoft.tenant.id";
+    static readonly USER_ID_KEY = "user.id";
+    static readonly USER_NAME_KEY = "user.name";
+    static readonly USER_EMAIL_KEY = "user.email";
+    static readonly GEN_AI_CALLER_CLIENT_IP_KEY = "client.address";
+    static readonly GEN_AI_CALLER_AGENT_USER_ID_KEY = "microsoft.a365.caller.agent.user.id";
+    static readonly GEN_AI_CALLER_AGENT_EMAIL_KEY = "microsoft.a365.caller.agent.user.email";
+    static readonly GEN_AI_CALLER_AGENT_NAME_KEY = "microsoft.a365.caller.agent.name";
+    static readonly GEN_AI_CALLER_AGENT_ID_KEY = "microsoft.a365.caller.agent.id";
+    static readonly GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "microsoft.a365.caller.agent.blueprint.id";
+    static readonly GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY = "microsoft.a365.caller.agent.platform.id";
+    static readonly GEN_AI_CALLER_AGENT_VERSION_KEY = "microsoft.a365.caller.agent.version";
+    static readonly GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id";
+    static readonly GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email";
+    static readonly GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id";
+    static readonly CHANNEL_NAME_KEY = "microsoft.channel.name";
+    static readonly CHANNEL_LINK_KEY = "microsoft.channel.link";
+    static readonly CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id";
+    static readonly CUSTOM_SPAN_NAME_KEY = "custom.span.name";
+    static readonly SERVICE_NAME_KEY = "service.name";
+    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_LANGUAGE_VALUE = "nodejs";
+    static readonly TELEMETRY_SDK_VERSION_VALUE = "0.1.0";
+}
+//# sourceMappingURL=constants.d.ts.map

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

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

package/dist/commonjs/a365/constants.js

@@ -0,0 +1,99 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryConstants = void 0;
+/**
+ * OpenTelemetry constants for A365 observability.
+ *
+ * Attribute keys follow OTel gen-ai semantic conventions plus
+ * Microsoft-specific extensions under the `microsoft.*` namespace.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/constants.ts
+ */
+class OpenTelemetryConstants {
+    // ── Span operation names ──────────────────────────────────────────
+    static INVOKE_AGENT_OPERATION_NAME = "invoke_agent";
+    static EXECUTE_TOOL_OPERATION_NAME = "execute_tool";
+    static OUTPUT_MESSAGES_OPERATION_NAME = "output_messages";
+    static CHAT_OPERATION_NAME = "chat";
+    // ── Standard OTel semantic conventions ────────────────────────────
+    static ERROR_TYPE_KEY = "error.type";
+    static ERROR_TYPE_CANCELLED = "TaskCanceledException";
+    static ERROR_MESSAGE_KEY = "error.message";
+    static AZ_NAMESPACE_KEY = "az.namespace";
+    static SERVER_ADDRESS_KEY = "server.address";
+    static SERVER_PORT_KEY = "server.port";
+    // ── Source / SDK identity ─────────────────────────────────────────
+    static SOURCE_NAME = "Agent365Sdk";
+    // ── GenAI core attributes ────────────────────────────────────────
+    static GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    static GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    static GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
+    static GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
+    static GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    // ── GenAI usage ──────────────────────────────────────────────────
+    static GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens";
+    static GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens";
+    // ── GenAI message attributes ─────────────────────────────────────
+    static GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions";
+    static GEN_AI_INPUT_MESSAGES_KEY = "gen_ai.input.messages";
+    static GEN_AI_OUTPUT_MESSAGES_KEY = "gen_ai.output.messages";
+    static A365_MESSAGES_SCHEMA_VERSION_KEY = "microsoft.a365.messages.schema_version";
+    // ── GenAI agent attributes ───────────────────────────────────────
+    static GEN_AI_AGENT_ID_KEY = "gen_ai.agent.id";
+    static GEN_AI_AGENT_NAME_KEY = "gen_ai.agent.name";
+    static GEN_AI_AGENT_DESCRIPTION_KEY = "gen_ai.agent.description";
+    static GEN_AI_AGENT_VERSION_KEY = "gen_ai.agent.version";
+    static GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id";
+    static GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process";
+    static GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    // ── GenAI conversation / session ─────────────────────────────────
+    static GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
+    static GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link";
+    static SESSION_ID_KEY = "microsoft.session.id";
+    static SESSION_DESCRIPTION_KEY = "microsoft.session.description";
+    // ── GenAI tool attributes ────────────────────────────────────────
+    static GEN_AI_TOOL_CALL_ID_KEY = "gen_ai.tool.call.id";
+    static GEN_AI_TOOL_NAME_KEY = "gen_ai.tool.name";
+    static GEN_AI_TOOL_DESCRIPTION_KEY = "gen_ai.tool.description";
+    static GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.call.arguments";
+    static GEN_AI_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result";
+    static GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type";
+    // ── Tenant ───────────────────────────────────────────────────────
+    static TENANT_ID_KEY = "microsoft.tenant.id";
+    // ── Human caller dimensions (OTel user.* namespace) ──────────────
+    static USER_ID_KEY = "user.id";
+    static USER_NAME_KEY = "user.name";
+    static USER_EMAIL_KEY = "user.email";
+    static GEN_AI_CALLER_CLIENT_IP_KEY = "client.address";
+    // ── Agent-to-Agent caller dimensions ─────────────────────────────
+    static GEN_AI_CALLER_AGENT_USER_ID_KEY = "microsoft.a365.caller.agent.user.id";
+    static GEN_AI_CALLER_AGENT_EMAIL_KEY = "microsoft.a365.caller.agent.user.email";
+    static GEN_AI_CALLER_AGENT_NAME_KEY = "microsoft.a365.caller.agent.name";
+    static GEN_AI_CALLER_AGENT_ID_KEY = "microsoft.a365.caller.agent.id";
+    static GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "microsoft.a365.caller.agent.blueprint.id";
+    static GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY = "microsoft.a365.caller.agent.platform.id";
+    static GEN_AI_CALLER_AGENT_VERSION_KEY = "microsoft.a365.caller.agent.version";
+    // ── Baggage keys ─────────────────────────────────────────────────
+    static GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id";
+    static GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email";
+    static GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id";
+    // ── Channel dimensions ───────────────────────────────────────────
+    static CHANNEL_NAME_KEY = "microsoft.channel.name";
+    static CHANNEL_LINK_KEY = "microsoft.channel.link";
+    // ── Custom parent / span name ────────────────────────────────────
+    static CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id";
+    static CUSTOM_SPAN_NAME_KEY = "custom.span.name";
+    // ── Service attributes ───────────────────────────────────────────
+    static SERVICE_NAME_KEY = "service.name";
+    // ── Telemetry SDK attributes ─────────────────────────────────────
+    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_LANGUAGE_VALUE = "nodejs";
+    static TELEMETRY_SDK_VERSION_VALUE = "0.1.0";
+}
+exports.OpenTelemetryConstants = OpenTelemetryConstants;
+//# sourceMappingURL=constants.js.map

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

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

package/dist/commonjs/a365/context/tokenContext.d.ts

@@ -0,0 +1,25 @@
+import type { Context } from "@opentelemetry/api";
+/**
+ * Run a function within a Context that carries the per-request export token.
+ * This keeps the token only in OTel Context (ALS), never in any registry.
+ *
+ * The token can be updated later via `updateExportToken()` before the trace
+ * is flushed — useful when the callback is long-running and the original
+ * token may expire before export.
+ */
+export declare function runWithExportToken<T>(token: string, fn: () => T): T;
+/**
+ * Update the export token in the active OTel Context.
+ * Call this to refresh the token before ending the root span when the
+ * original token may have expired during a long-running request.
+ *
+ * Must be called within the same async context created by `runWithExportToken`.
+ * @param token The fresh token to use for export.
+ * @returns true if the token was updated successfully, false if no token holder was found.
+ */
+export declare function updateExportToken(token: string): boolean;
+/**
+ * Retrieve the per-request export token from a given OTel Context (or the active one).
+ */
+export declare function getExportToken(ctx?: Context): string | undefined;
+//# sourceMappingURL=tokenContext.d.ts.map

package/dist/commonjs/a365/context/tokenContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenContext.d.ts","sourceRoot":"","sources":["../../../../src/a365/context/tokenContext.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAclD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAKnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,OAA0B,GAAG,MAAM,GAAG,SAAS,CAUlF"}

package/dist/commonjs/a365/context/tokenContext.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWithExportToken = runWithExportToken;
+exports.updateExportToken = updateExportToken;
+exports.getExportToken = getExportToken;
+/**
+ * Per-request export token context propagation.
+ *
+ * Uses OpenTelemetry Context (backed by AsyncLocalStorage) to carry and
+ * refresh a per-request bearer token that the PerRequestSpanProcessor
+ * restores at export time.
+ *
+ * Adapted from microsoft/Agent365-nodejs agents-a365-observability/src/tracing/context/token-context.ts
+ */
+const api_1 = require("@opentelemetry/api");
+const index_js_1 = require("../../shared/logging/index.js");
+const EXPORT_TOKEN_KEY = (0, api_1.createContextKey)("a365_export_token");
+/**
+ * Run a function within a Context that carries the per-request export token.
+ * This keeps the token only in OTel Context (ALS), never in any registry.
+ *
+ * The token can be updated later via `updateExportToken()` before the trace
+ * is flushed — useful when the callback is long-running and the original
+ * token may expire before export.
+ */
+function runWithExportToken(token, fn) {
+    const holder = { token };
+    const ctxWithToken = api_1.context.active().setValue(EXPORT_TOKEN_KEY, holder);
+    index_js_1.Logger.getInstance().info("[TokenContext] Running function with export token in context.");
+    return api_1.context.with(ctxWithToken, fn);
+}
+/**
+ * Update the export token in the active OTel Context.
+ * Call this to refresh the token before ending the root span when the
+ * original token may have expired during a long-running request.
+ *
+ * Must be called within the same async context created by `runWithExportToken`.
+ * @param token The fresh token to use for export.
+ * @returns true if the token was updated successfully, false if no token holder was found.
+ */
+function updateExportToken(token) {
+    const value = api_1.context.active().getValue(EXPORT_TOKEN_KEY);
+    if (value && typeof value === "object" && "token" in value) {
+        value.token = token;
+        index_js_1.Logger.getInstance().info("[TokenContext] Export token updated in context.");
+        return true;
+    }
+    index_js_1.Logger.getInstance().warn("[TokenContext] updateExportToken called but no token holder found in active context. Was runWithExportToken called?");
+    return false;
+}
+/**
+ * Retrieve the per-request export token from a given OTel Context (or the active one).
+ */
+function getExportToken(ctx = api_1.context.active()) {
+    const value = ctx.getValue(EXPORT_TOKEN_KEY);
+    if (value && typeof value === "object" && "token" in value) {
+        return value.token;
+    }
+    // Backward compat: support raw string values from older callers
+    if (typeof value === "string") {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=tokenContext.js.map

package/dist/commonjs/a365/context/tokenContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenContext.js","sourceRoot":"","sources":["../../../../src/a365/context/tokenContext.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAmClC,gDAKC;AAWD,8CAWC;AAKD,wCAUC;AA3ED;;;;;;;;GAQG;AAEH,4CAA+D;AAE/D,4DAAuD;AAEvD,MAAM,gBAAgB,GAAG,IAAA,sBAAgB,EAAC,mBAAmB,CAAC,CAAC;AAW/D;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAI,KAAa,EAAE,EAAW;IAC9D,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,aAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACzE,iBAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC3F,OAAO,aAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAAG,aAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC1D,KAAqB,CAAC,KAAK,GAAG,KAAK,CAAC;QACrC,iBAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,iBAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CACvB,qHAAqH,CACtH,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAe,aAAO,CAAC,MAAM,EAAE;IAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAC3D,OAAQ,KAAqB,CAAC,KAAK,CAAC;IACtC,CAAC;IACD,gEAAgE;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { Context } from "@opentelemetry/api";
+import type { ParentSpanRef } from "./contracts.js";
+/** Type guard to distinguish a ParentSpanRef from an OTel Context. */
+export declare function isParentSpanRef(value: unknown): value is ParentSpanRef;
+/**
+ * Creates a new Context with an explicit parent span reference.
+ * This allows child spans to be correctly parented even when async context is broken.
+ */
+export declare function createContextWithParentSpanRef(base: Context, parent: ParentSpanRef): Context;
+/**
+ * Runs a callback within a context that has an explicit parent span reference.
+ */
+export declare function runWithParentSpanRef<T>(parent: ParentSpanRef, callback: () => T): T;
+/** Carrier type for HTTP headers. */
+export type HeadersCarrier = Record<string, string | string[] | undefined>;
+/**
+ * Injects the current trace context (`traceparent`/`tracestate` headers) into
+ * the provided headers object using the globally registered W3C propagator.
+ */
+export declare function injectContextToHeaders(headers: Record<string, string>, ctx?: Context): Record<string, string>;
+/**
+ * Extracts trace context from incoming HTTP headers using the globally
+ * registered W3C propagator.
+ */
+export declare function extractContextFromHeaders(headers: HeadersCarrier, baseCtx?: Context): Context;
+/**
+ * Extracts trace context from incoming HTTP headers and runs the callback
+ * within that context.
+ */
+export declare function runWithExtractedTraceContext<T>(headers: HeadersCarrier, callback: () => T): T;
+//# sourceMappingURL=context.d.ts.map