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

package/LICENSE

@@ -1,21 +1,23 @@
-    MIT License
+opentelemetry-distro-javascript
 
-    Copyright (c) Microsoft Corporation.
+MIT License
 
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
+Copyright (c) Microsoft Corporation.
 
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE

package/README.md

@@ -56,6 +56,27 @@ Set `OTEL_EXPORTER_OTLP_ENDPOINT` and OTLP export is enabled automatically — n
 
 See the [OpenTelemetry OTLP Exporter specification](https://opentelemetry.io/docs/specs/otel/protocol/exporter/) for the full list.
 
+### `a365` options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | `boolean` | `false` | Enable A365 observability export |
+| `tokenResolver` | `(agentId, tenantId) => string \| Promise<string>` | — | Token resolver for A365 service authentication |
+| `clusterCategory` | `ClusterCategory` | `"prod"` | Cluster category for endpoint resolution (`local`, `dev`, `test`, `preprod`, `firstrelease`, `prod`, `gov`, `high`, `dod`, `mooncake`, `ex`, `rx`) |
+| `domainOverride` | `string` | — | Override the A365 observability service domain |
+| `authScopes` | `string[]` | `["https://api.powerplatform.com/.default"]` | OAuth scopes for A365 service authentication |
+| `perRequestExport` | `boolean` | `false` | Buffer spans per trace and export on root completion instead of batch export |
+
+A365 options can also be set via environment variables (highest precedence):
+
+| Environment Variable | Description |
+|---|---|
+| `ENABLE_A365_OBSERVABILITY_EXPORTER` | `"true"` / `"false"` — override `enabled` |
+| `ENABLE_A365_OBSERVABILITY_PER_REQUEST_EXPORT` | `"true"` / `"false"` — override `perRequestExport` |
+| `A365_OBSERVABILITY_SCOPES_OVERRIDE` | Space-separated list of OAuth scopes |
+| `A365_OBSERVABILITY_DOMAIN_OVERRIDE` | Override service domain |
+| `CLUSTER_CATEGORY` | Override cluster category |
+
 ### Example
 
 ```typescript
@@ -86,6 +107,31 @@ See the [samples/](./samples/) directory for working TypeScript examples coverin
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md).
 
+This project has adopted the
+[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more
+information see the
+[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
+or contact [opencode@microsoft.com](mailto:opencode@microsoft.com)
+with any additional questions or comments.
+
+## Data Collection
+
+As this SDK is designed to enable applications to perform data collection which is sent to the Microsoft collection endpoints the following is required to identify our privacy statement.
+
+The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
+
+### Internal Telemetry
+
+Internal telemetry can be disabled by setting the environment variable `APPLICATIONINSIGHTS_STATSBEAT_DISABLED` to `true`.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.
+
+## Reporting Security Issues
+
+See [SECURITY.md](./SECURITY.md) for information on reporting vulnerabilities.
+
 ## License
 
 [MIT](LICENSE)

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.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.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.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.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"}