@microsoft/agents-a365-observability 0.1.0-preview.30

package/README.md

@@ -0,0 +1,33 @@
+# @microsoft/agents-a365-observability
+
+[![npm](https://img.shields.io/npm/v/@microsoft/agents-a365-observability?label=npm&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-observability)
+[![npm Downloads](https://img.shields.io/npm/dm/@microsoft/agents-a365-observability?label=Downloads&logo=npm)](https://www.npmjs.com/package/@microsoft/agents-a365-observability)
+
+OpenTelemetry-based observability and tracing for Microsoft Agents A365 applications. This package provides comprehensive monitoring capabilities for agent invocations, tool executions, and AI model inference calls with seamless Azure Monitor integration.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-a365-observability
+```
+
+## Usage
+
+For detailed usage examples and implementation guidance, see the [Microsoft Agent 365 Observability Documentation](https://learn.microsoft.com/microsoft-agent-365/developer/observability?tabs=nodejs).
+
+## Support
+
+For issues, questions, or feedback:
+
+- File issues in the [GitHub Issues](https://github.com/microsoft/Agent365-nodejs/issues) section
+- See the [main documentation](../../README.md) for more information
+
+## Trademarks
+
+*Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.*
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the MIT License - see the [LICENSE](../../LICENSE.md) file for details

package/dist/cjs/ObservabilityBuilder.d.ts

@@ -0,0 +1,61 @@
+import { TokenResolver } from './tracing/exporter/Agent365Exporter';
+import { ClusterCategory } from '@microsoft/agents-a365-runtime';
+/**
+ * Configuration options for Agent 365 Observability Builder
+ */
+export interface BuilderOptions {
+    /** Custom service name for telemetry */
+    serviceName?: string;
+    /** Custom service version for telemetry */
+    serviceVersion?: string;
+    tokenResolver?: TokenResolver;
+    /** Environment / cluster category (e.g., "preprod", "prod"). */
+    clusterCategory?: ClusterCategory;
+}
+/**
+ * Builder for configuring Agent 365 with OpenTelemetry tracing
+ */
+export declare class ObservabilityBuilder {
+    private options;
+    private isBuilt;
+    private sdk?;
+    /**
+     * Configures the service name and version for telemetry
+     * @param serviceName The service name
+     * @param serviceVersion The service version
+     * @returns The builder instance for method chaining
+     */
+    withService(serviceName: string, serviceVersion?: string): ObservabilityBuilder;
+    /**
+     * Configures the token resolver for Agent 365 exporter
+     * @param tokenResolver Function to resolve authentication tokens
+     * @returns The builder instance for method chaining
+     */
+    withTokenResolver(tokenResolver: TokenResolver): ObservabilityBuilder;
+    /**
+     * Configures the cluster category for Agent 365 exporter
+     * @param clusterCategory The cluster category (e.g., "preprod", "prod")
+     * @returns The builder instance for method chaining
+     */
+    withClusterCategory(clusterCategory: ClusterCategory): ObservabilityBuilder;
+    private getTraceExporter;
+    private createResource;
+    /**
+     * Builds and initializes the Agent 365 configuration
+     * @returns The configured NodeSDK instance
+     */
+    build(): boolean;
+    /**
+     * Starts the OpenTelemetry SDK
+     */
+    start(): void;
+    /**
+     * Shuts down the OpenTelemetry SDK
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Helper to avoid double-registering same processor type.
+     */
+    private attachProcessorIfMissing;
+}
+//# sourceMappingURL=ObservabilityBuilder.d.ts.map

package/dist/cjs/ObservabilityBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityBuilder.d.ts","sourceRoot":"","sources":["../../src/ObservabilityBuilder.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAItF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gEAAgE;IAChE,eAAe,CAAC,EAAE,eAAe,CAAC;CAEnC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAC,CAAU;IAEtB;;;;;OAKG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,oBAAoB;IAMtF;;;;OAIG;IACI,iBAAiB,CAAC,aAAa,EAAE,aAAa,GAAG,oBAAoB;IAK5E;;;;OAIG;IACI,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,oBAAoB;IAKlF,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,cAAc;IAUtB;;;OAGG;IACI,KAAK,IAAI,OAAO;IA6CvB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CASjC"}

package/dist/cjs/ObservabilityBuilder.js

@@ -0,0 +1,141 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityBuilder = void 0;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const SpanProcessor_1 = require("./tracing/processors/SpanProcessor");
+const util_1 = require("./tracing/util");
+const Agent365Exporter_1 = require("./tracing/exporter/Agent365Exporter");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const api_1 = require("@opentelemetry/api");
+/**
+ * Builder for configuring Agent 365 with OpenTelemetry tracing
+ */
+class ObservabilityBuilder {
+    constructor() {
+        this.options = {};
+        this.isBuilt = false;
+    }
+    /**
+     * Configures the service name and version for telemetry
+     * @param serviceName The service name
+     * @param serviceVersion The service version
+     * @returns The builder instance for method chaining
+     */
+    withService(serviceName, serviceVersion) {
+        this.options.serviceName = serviceName;
+        this.options.serviceVersion = serviceVersion;
+        return this;
+    }
+    /**
+     * Configures the token resolver for Agent 365 exporter
+     * @param tokenResolver Function to resolve authentication tokens
+     * @returns The builder instance for method chaining
+     */
+    withTokenResolver(tokenResolver) {
+        this.options.tokenResolver = tokenResolver;
+        return this;
+    }
+    /**
+     * Configures the cluster category for Agent 365 exporter
+     * @param clusterCategory The cluster category (e.g., "preprod", "prod")
+     * @returns The builder instance for method chaining
+     */
+    withClusterCategory(clusterCategory) {
+        this.options.clusterCategory = clusterCategory;
+        return this;
+    }
+    getTraceExporter() {
+        if ((0, util_1.isAgent365ExporterEnabled)()) {
+            if (!this.options.tokenResolver) {
+                throw new Error('tokenResolver must be provided when Agent 365 exporter is enabled');
+            }
+            return new Agent365Exporter_1.Agent365Exporter(this.options.tokenResolver, this.options.clusterCategory || 'prod');
+        }
+        else {
+            return new sdk_trace_base_1.ConsoleSpanExporter();
+        }
+    }
+    createResource() {
+        const serviceName = this.options.serviceVersion
+            ? `${this.options.serviceName}-${this.options.serviceVersion}`
+            : this.options.serviceName ?? 'Agent365-TypeScript';
+        return (0, resources_1.resourceFromAttributes)({
+            [semantic_conventions_1.ATTR_SERVICE_NAME]: serviceName,
+        });
+    }
+    /**
+     * Builds and initializes the Agent 365 configuration
+     * @returns The configured NodeSDK instance
+     */
+    build() {
+        if (this.isBuilt) {
+            return this.isBuilt;
+        }
+        // Create processors in the desired order:
+        // 1. baggage enricher (copies baggage -> span attributes)
+        const spanProcessor = new SpanProcessor_1.SpanProcessor();
+        // 2. batch processor that actually ships spans out
+        const batchProcessor = new sdk_trace_base_1.BatchSpanProcessor(this.getTraceExporter());
+        const globalProvider = api_1.trace.getTracerProvider();
+        const canAddProcessors = typeof globalProvider?.addSpanProcessor === 'function' &&
+            typeof globalProvider?.resource !== 'undefined';
+        if (canAddProcessors) {
+            // Someone else already created a provider (maybe their own NodeSDK).
+            // We DO NOT create a new NodeSDK.
+            // We just add our baggage enricher + batch exporter to their provider,
+            // but only if they aren't already there.
+            this.attachProcessorIfMissing(globalProvider, spanProcessor);
+            this.attachProcessorIfMissing(globalProvider, batchProcessor);
+            this.isBuilt = true;
+            this.sdk = undefined; // we didn't create/own one
+            return this.isBuilt;
+        }
+        // Create & configure the NodeSDK manually so we can inject processors + resource.
+        this.sdk = new sdk_node_1.NodeSDK({
+            resource: this.createResource(),
+            spanProcessors: [
+                spanProcessor,
+                batchProcessor,
+            ],
+        });
+        this.isBuilt = true;
+        return this.isBuilt;
+    }
+    /**
+     * Starts the OpenTelemetry SDK
+     */
+    start() {
+        if (!this.isBuilt) {
+            this.build();
+        }
+        if (this.sdk) {
+            this.sdk.start();
+        }
+    }
+    /**
+     * Shuts down the OpenTelemetry SDK
+     */
+    async shutdown() {
+        if (this.sdk) {
+            await this.sdk.shutdown();
+        }
+    }
+    /**
+     * Helper to avoid double-registering same processor type.
+     */
+    attachProcessorIfMissing(provider, processor) {
+        const active = provider._activeSpanProcessor?._spanProcessors;
+        const alreadyAdded = Array.isArray(active) &&
+            active.some((p) => p?.constructor?.name === processor.constructor.name);
+        if (!alreadyAdded) {
+            provider.addSpanProcessor(processor);
+        }
+    }
+}
+exports.ObservabilityBuilder = ObservabilityBuilder;
+//# sourceMappingURL=ObservabilityBuilder.js.map

package/dist/cjs/ObservabilityBuilder.js.map

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

package/dist/cjs/ObservabilityManager.d.ts

@@ -0,0 +1,29 @@
+import { ObservabilityBuilder, BuilderOptions } from './ObservabilityBuilder';
+/**
+ * Main entry point for Agent 365 providing OpenTelemetry tracing for AI agents and tools
+ */
+export declare class ObservabilityManager {
+    private static instance?;
+    /**
+     * Configures Agent 365 with OpenTelemetry tracing for AI agents and tools
+     * @param configure Optional configuration callback for the Builder
+     * @returns The configured Builder instance
+     */
+    static configure(configure?: (builder: ObservabilityBuilder) => void): ObservabilityBuilder;
+    /**
+     * Configures and starts Agent 365 with simplified options
+     * @param options Configuration options
+     * @returns The configured and started Builder instance
+     */
+    static start(options?: BuilderOptions): ObservabilityBuilder;
+    /**
+     * Gets the current Agent 365 instance
+     * @returns The current instance or null if not configured
+     */
+    static getInstance(): ObservabilityBuilder | null;
+    /**
+     * Shuts down Agent 365
+     */
+    static shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ObservabilityManager.d.ts.map

package/dist/cjs/ObservabilityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityManager.d.ts","sourceRoot":"","sources":["../../src/ObservabilityManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAuB;IAG/C;;;;OAIG;WACW,SAAS,CACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAClD,oBAAoB;IASvB;;;;OAIG;WACW,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,oBAAoB;IAqBnE;;;OAGG;WACW,WAAW,IAAI,oBAAoB,GAAG,IAAI;IAIxD;;OAEG;WACiB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAM9C"}

package/dist/cjs/ObservabilityManager.js

@@ -0,0 +1,61 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityManager = void 0;
+const ObservabilityBuilder_1 = require("./ObservabilityBuilder");
+/**
+ * Main entry point for Agent 365 providing OpenTelemetry tracing for AI agents and tools
+ */
+class ObservabilityManager {
+    /**
+     * Configures Agent 365 with OpenTelemetry tracing for AI agents and tools
+     * @param configure Optional configuration callback for the Builder
+     * @returns The configured Builder instance
+     */
+    static configure(configure) {
+        const builder = new ObservabilityBuilder_1.ObservabilityBuilder();
+        configure?.(builder);
+        ObservabilityManager.instance = builder;
+        return builder;
+    }
+    /**
+     * Configures and starts Agent 365 with simplified options
+     * @param options Configuration options
+     * @returns The configured and started Builder instance
+     */
+    static start(options) {
+        const builder = new ObservabilityBuilder_1.ObservabilityBuilder();
+        if (options?.serviceName) {
+            builder.withService(options.serviceName, options.serviceVersion);
+        }
+        if (options?.tokenResolver) {
+            builder.withTokenResolver(options.tokenResolver);
+        }
+        if (options?.clusterCategory) {
+            builder.withClusterCategory(options.clusterCategory);
+        }
+        builder.start();
+        ObservabilityManager.instance = builder;
+        return builder;
+    }
+    /**
+     * Gets the current Agent 365 instance
+     * @returns The current instance or null if not configured
+     */
+    static getInstance() {
+        return ObservabilityManager.instance || null;
+    }
+    /**
+     * Shuts down Agent 365
+     */
+    static async shutdown() {
+        if (ObservabilityManager.instance) {
+            await ObservabilityManager.instance.shutdown();
+            ObservabilityManager.instance = undefined;
+        }
+    }
+}
+exports.ObservabilityManager = ObservabilityManager;
+//# sourceMappingURL=ObservabilityManager.js.map

package/dist/cjs/ObservabilityManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObservabilityManager.js","sourceRoot":"","sources":["../../src/ObservabilityManager.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,iEAA8E;AAE9E;;GAEG;AACH,MAAa,oBAAoB;IAI/B;;;;OAIG;IACI,MAAM,CAAC,SAAS,CACrB,SAAmD;QAEnD,MAAM,OAAO,GAAG,IAAI,2CAAoB,EAAE,CAAC;QAE3C,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;QAErB,oBAAoB,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAwB;QAC1C,MAAM,OAAO,GAAG,IAAI,2CAAoB,EAAE,CAAC;QAE3C,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACzB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;YAC7B,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,oBAAoB,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,WAAW;QACvB,OAAO,oBAAoB,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC/C,oBAAoB,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5C,CAAC;IACH,CAAC;CACF;AA/DD,oDA+DC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,10 @@
+export { ObservabilityManager } from './ObservabilityManager';
+export { ObservabilityBuilder as Builder, BuilderOptions } from './ObservabilityBuilder';
+export { OpenTelemetryConstants } from './tracing/constants';
+export { BaggageBuilder, BaggageScope } from './tracing/middleware/BaggageBuilder';
+export { ExecutionType, InvocationRole, SourceMetadata, AgentRequest, AgentDetails, TenantDetails, ToolCallDetails, InvokeAgentDetails, CallerDetails, EnhancedAgentDetails, ServiceEndpoint, InferenceDetails, InferenceOperationType, InferenceResponse } from './tracing/contracts';
+export { OpenTelemetryScope } from './tracing/scopes/OpenTelemetryScope';
+export { ExecuteToolScope } from './tracing/scopes/ExecuteToolScope';
+export { InvokeAgentScope } from './tracing/scopes/InvokeAgentScope';
+export { InferenceScope } from './tracing/scopes/InferenceScope';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGnF,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAC,MAAM,iCAAiC,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,33 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InferenceScope = exports.InvokeAgentScope = exports.ExecuteToolScope = exports.OpenTelemetryScope = exports.InferenceOperationType = exports.InvocationRole = exports.ExecutionType = exports.BaggageScope = exports.BaggageBuilder = exports.OpenTelemetryConstants = exports.Builder = exports.ObservabilityManager = void 0;
+// Main SDK classes
+var ObservabilityManager_1 = require("./ObservabilityManager");
+Object.defineProperty(exports, "ObservabilityManager", { enumerable: true, get: function () { return ObservabilityManager_1.ObservabilityManager; } });
+var ObservabilityBuilder_1 = require("./ObservabilityBuilder");
+Object.defineProperty(exports, "Builder", { enumerable: true, get: function () { return ObservabilityBuilder_1.ObservabilityBuilder; } });
+// Tracing constants
+var constants_1 = require("./tracing/constants");
+Object.defineProperty(exports, "OpenTelemetryConstants", { enumerable: true, get: function () { return constants_1.OpenTelemetryConstants; } });
+// Baggage builder
+var BaggageBuilder_1 = require("./tracing/middleware/BaggageBuilder");
+Object.defineProperty(exports, "BaggageBuilder", { enumerable: true, get: function () { return BaggageBuilder_1.BaggageBuilder; } });
+Object.defineProperty(exports, "BaggageScope", { enumerable: true, get: function () { return BaggageBuilder_1.BaggageScope; } });
+// Contracts and interfaces
+var contracts_1 = require("./tracing/contracts");
+Object.defineProperty(exports, "ExecutionType", { enumerable: true, get: function () { return contracts_1.ExecutionType; } });
+Object.defineProperty(exports, "InvocationRole", { enumerable: true, get: function () { return contracts_1.InvocationRole; } });
+Object.defineProperty(exports, "InferenceOperationType", { enumerable: true, get: function () { return contracts_1.InferenceOperationType; } });
+// Scopes
+var OpenTelemetryScope_1 = require("./tracing/scopes/OpenTelemetryScope");
+Object.defineProperty(exports, "OpenTelemetryScope", { enumerable: true, get: function () { return OpenTelemetryScope_1.OpenTelemetryScope; } });
+var ExecuteToolScope_1 = require("./tracing/scopes/ExecuteToolScope");
+Object.defineProperty(exports, "ExecuteToolScope", { enumerable: true, get: function () { return ExecuteToolScope_1.ExecuteToolScope; } });
+var InvokeAgentScope_1 = require("./tracing/scopes/InvokeAgentScope");
+Object.defineProperty(exports, "InvokeAgentScope", { enumerable: true, get: function () { return InvokeAgentScope_1.InvokeAgentScope; } });
+var InferenceScope_1 = require("./tracing/scopes/InferenceScope");
+Object.defineProperty(exports, "InferenceScope", { enumerable: true, get: function () { return InferenceScope_1.InferenceScope; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;;;AAEjF,mBAAmB;AACnB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,+DAAyF;AAAhF,+GAAA,oBAAoB,OAAW;AAExC,oBAAoB;AACpB,iDAA6D;AAApD,mHAAA,sBAAsB,OAAA;AAE/B,kBAAkB;AAClB,sEAAmF;AAA1E,gHAAA,cAAc,OAAA;AAAE,8GAAA,YAAY,OAAA;AAErC,2BAA2B;AAC3B,iDAe6B;AAd3B,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AAWd,mHAAA,sBAAsB,OAAA;AAIxB,SAAS;AACT,0EAAyE;AAAhE,wHAAA,kBAAkB,OAAA;AAC3B,sEAAqE;AAA5D,oHAAA,gBAAgB,OAAA;AACzB,sEAAqE;AAA5D,oHAAA,gBAAgB,OAAA;AACzB,kEAAgE;AAAvD,gHAAA,cAAc,OAAA"}

package/dist/cjs/tracing/constants.d.ts

@@ -0,0 +1,83 @@
+/**
+ * OpenTelemetry constants for Agent 365
+ */
+export declare class OpenTelemetryConstants {
+    static readonly INVOKE_AGENT_OPERATION_NAME = "invoke_agent";
+    static readonly EXECUTE_TOOL_OPERATION_NAME = "execute_tool";
+    static readonly ERROR_TYPE_KEY = "error.type";
+    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 AZURE_RP_NAMESPACE_VALUE = "Microsoft.CognitiveServices";
+    static readonly SOURCE_NAME = "Agent365Sdk";
+    static readonly ENABLE_OPENTELEMETRY_SWITCH = "Azure.Experimental.EnableActivitySource";
+    static readonly TRACE_CONTENTS_SWITCH = "Azure.Experimental.TraceGenAIMessageContent";
+    static readonly TRACE_CONTENTS_ENVIRONMENT_VARIABLE = "AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED";
+    static readonly ENABLE_OBSERVABILITY = "ENABLE_OBSERVABILITY";
+    static readonly ENABLE_A365_OBSERVABILITY_EXPORTER = "ENABLE_A365_OBSERVABILITY_EXPORTER";
+    static readonly ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY";
+    static readonly GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration";
+    static readonly GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage";
+    static readonly GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name";
+    static readonly GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens";
+    static readonly GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model";
+    static readonly GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature";
+    static readonly GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p";
+    static readonly GEN_AI_RESPONSE_ID_KEY = "gen_ai.response.id";
+    static readonly GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons";
+    static readonly GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model";
+    static readonly GEN_AI_SYSTEM_KEY = "gen_ai.system";
+    static readonly GEN_AI_SYSTEM_VALUE = "az.ai.agent365";
+    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_CONVERSATION_ID_KEY = "gen_ai.conversation.id";
+    static readonly GEN_AI_CONVERSATION_ITEM_LINK_KEY = "gen_ai.conversation.item.link";
+    static readonly GEN_AI_TOKEN_TYPE_KEY = "gen_ai.token.type";
+    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_CHOICE = "gen_ai.choice";
+    static readonly GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name";
+    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 GEN_AI_EVENT_CONTENT = "gen_ai.event.content";
+    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.event.content";
+    static readonly GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type";
+    static readonly GEN_AI_AGENT_USER_ID_KEY = "gen_ai.agent.userid";
+    static readonly GEN_AI_CALLER_USER_ID_KEY = "gen_ai.caller.userid";
+    static readonly GEN_AI_CALLER_TENANT_ID_KEY = "gen_ai.caller.tenantid";
+    static readonly GEN_AI_CALLER_ID_KEY = "gen_ai.caller.id";
+    static readonly GEN_AI_CALLER_NAME_KEY = "gen_ai.caller.name";
+    static readonly GEN_AI_CALLER_UPN_KEY = "gen_ai.caller.upn";
+    static readonly GEN_AI_CALLER_AGENT_USER_ID_KEY = "gen_ai.caller.agent.userid";
+    static readonly GEN_AI_CALLER_AGENT_UPN_KEY = "gen_ai.caller.agent.upn";
+    static readonly GEN_AI_CALLER_AGENT_TENANT_ID_KEY = "gen_ai.caller.agent.tenantid";
+    static readonly GEN_AI_CALLER_AGENT_NAME_KEY = "gen_ai.caller.agent.name";
+    static readonly GEN_AI_CALLER_AGENT_ID_KEY = "gen_ai.caller.agent.id";
+    static readonly GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "gen_ai.caller.agent.applicationid";
+    static readonly AGENT_ID_KEY = "gen_ai.agent.id";
+    static readonly GEN_AI_TASK_ID_KEY = "gen_ai.task.id";
+    static readonly SESSION_ID_KEY = "session.id";
+    static readonly GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri";
+    static readonly TENANT_ID_KEY = "tenant.id";
+    static readonly OPERATION_SOURCE_KEY = "operation.source";
+    static readonly GEN_AI_AGENT_AUID_KEY = "gen_ai.agent.user.id";
+    static readonly GEN_AI_AGENT_UPN_KEY = "gen_ai.agent.upn";
+    static readonly GEN_AI_AGENT_BLUEPRINT_ID_KEY = "gen_ai.agent.applicationid";
+    static readonly CORRELATION_ID_KEY = "correlation.id";
+    static readonly HIRING_MANAGER_ID_KEY = "hiring.manager.id";
+    static readonly GEN_AI_EXECUTION_TYPE_KEY = "gen_ai.execution.type";
+    static readonly GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload";
+    static readonly GEN_AI_EXECUTION_SOURCE_ID_KEY = "gen_ai.execution.sourceMetadata.id";
+    static readonly GEN_AI_EXECUTION_SOURCE_NAME_KEY = "gen_ai.channel.name";
+    static readonly GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY = "gen_ai.channel.link";
+    static readonly CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id";
+    static readonly CUSTOM_SPAN_NAME_KEY = "custom.span.name";
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/tracing/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/tracing/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,sBAAsB;IAEjC,gBAAuB,2BAA2B,kBAAkB;IACpE,gBAAuB,2BAA2B,kBAAkB;IAGpE,gBAAuB,cAAc,gBAAgB;IACrD,gBAAuB,iBAAiB,mBAAmB;IAC3D,gBAAuB,gBAAgB,kBAAkB;IACzD,gBAAuB,kBAAkB,oBAAoB;IAC7D,gBAAuB,eAAe,iBAAiB;IACvD,gBAAuB,wBAAwB,iCAAiC;IAChF,gBAAuB,WAAW,iBAAiB;IACnD,gBAAuB,2BAA2B,6CAA6C;IAC/F,gBAAuB,qBAAqB,iDAAiD;IAC7F,gBAAuB,mCAAmC,oDAAoD;IAC9G,gBAAuB,oBAAoB,0BAA0B;IACrE,gBAAuB,kCAAkC,wCAAwC;IACjG,gBAAuB,yBAAyB,+BAA+B;IAG/E,gBAAuB,4CAA4C,sCAAsC;IACzG,gBAAuB,qCAAqC,+BAA+B;IAC3F,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,6BAA6B,+BAA+B;IACnF,gBAAuB,wBAAwB,0BAA0B;IACzE,gBAAuB,8BAA8B,gCAAgC;IACrF,gBAAuB,wBAAwB,0BAA0B;IACzE,gBAAuB,sBAAsB,wBAAwB;IACrE,gBAAuB,kCAAkC,oCAAoC;IAC7F,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,iBAAiB,mBAAmB;IAC3D,gBAAuB,mBAAmB,oBAAoB;IAE9D,gBAAuB,mBAAmB,qBAAqB;IAC/D,gBAAuB,qBAAqB,uBAAuB;IACnE,gBAAuB,4BAA4B,8BAA8B;IACjF,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,iCAAiC,mCAAmC;IAC3F,gBAAuB,qBAAqB,uBAAuB;IACnE,gBAAuB,6BAA6B,+BAA+B;IACnF,gBAAuB,8BAA8B,gCAAgC;IACrF,gBAAuB,aAAa,mBAAmB;IACvD,gBAAuB,wBAAwB,0BAA0B;IAEzE,gBAAuB,8BAA8B,gCAAgC;IACrF,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,oBAAoB,0BAA0B;IAGrE,gBAAuB,uBAAuB,yBAAyB;IACvE,gBAAuB,oBAAoB,sBAAsB;IACjE,gBAAuB,2BAA2B,6BAA6B;IAC/E,gBAAuB,oBAAoB,gCAAgC;IAC3E,gBAAuB,2BAA2B,0BAA0B;IAC5E,gBAAuB,oBAAoB,sBAAsB;IAGjE,gBAAuB,wBAAwB,yBAAyB;IACxE,gBAAuB,yBAAyB,0BAA0B;IAC1E,gBAAuB,2BAA2B,4BAA4B;IAC9E,gBAAuB,oBAAoB,sBAAsB;IACjE,gBAAuB,sBAAsB,wBAAwB;IACrE,gBAAuB,qBAAqB,uBAAuB;IAGnE,gBAAuB,+BAA+B,gCAAgC;IACtF,gBAAuB,2BAA2B,6BAA6B;IAC/E,gBAAuB,iCAAiC,kCAAkC;IAC1F,gBAAuB,4BAA4B,8BAA8B;IACjF,gBAAuB,0BAA0B,4BAA4B;IAC7E,gBAAuB,sCAAsC,uCAAuC;IAGpG,gBAAuB,YAAY,qBAAqB;IACxD,gBAAuB,kBAAkB,oBAAoB;IAC7D,gBAAuB,cAAc,gBAAgB;IACrD,gBAAuB,mBAAmB,8BAA8B;IACxE,gBAAuB,aAAa,eAAe;IAGnD,gBAAuB,oBAAoB,sBAAsB;IACjE,gBAAuB,qBAAqB,0BAA0B;IACtE,gBAAuB,oBAAoB,sBAAsB;IACjE,gBAAuB,6BAA6B,gCAAgC;IACpF,gBAAuB,kBAAkB,oBAAoB;IAC7D,gBAAuB,qBAAqB,uBAAuB;IAGnE,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,4BAA4B,8BAA8B;IAGjF,gBAAuB,8BAA8B,wCAAwC;IAC7F,gBAAuB,gCAAgC,yBAAyB;IAChF,gBAAuB,uCAAuC,yBAAyB;IAGvF,gBAAuB,yBAAyB,2BAA2B;IAC3E,gBAAuB,oBAAoB,sBAAsB;CAClE"}

package/dist/cjs/tracing/constants.js

@@ -0,0 +1,101 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryConstants = void 0;
+/**
+ * OpenTelemetry constants for Agent 365
+ */
+class OpenTelemetryConstants {
+}
+exports.OpenTelemetryConstants = OpenTelemetryConstants;
+// Span operation names
+OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME = 'invoke_agent';
+OpenTelemetryConstants.EXECUTE_TOOL_OPERATION_NAME = 'execute_tool';
+// OpenTelemetry semantic conventions
+OpenTelemetryConstants.ERROR_TYPE_KEY = 'error.type';
+OpenTelemetryConstants.ERROR_MESSAGE_KEY = 'error.message';
+OpenTelemetryConstants.AZ_NAMESPACE_KEY = 'az.namespace';
+OpenTelemetryConstants.SERVER_ADDRESS_KEY = 'server.address';
+OpenTelemetryConstants.SERVER_PORT_KEY = 'server.port';
+OpenTelemetryConstants.AZURE_RP_NAMESPACE_VALUE = 'Microsoft.CognitiveServices';
+OpenTelemetryConstants.SOURCE_NAME = 'Agent365Sdk';
+OpenTelemetryConstants.ENABLE_OPENTELEMETRY_SWITCH = 'Azure.Experimental.EnableActivitySource';
+OpenTelemetryConstants.TRACE_CONTENTS_SWITCH = 'Azure.Experimental.TraceGenAIMessageContent';
+OpenTelemetryConstants.TRACE_CONTENTS_ENVIRONMENT_VARIABLE = 'AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED';
+OpenTelemetryConstants.ENABLE_OBSERVABILITY = 'ENABLE_OBSERVABILITY';
+OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER = 'ENABLE_A365_OBSERVABILITY_EXPORTER';
+OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY = 'ENABLE_A365_OBSERVABILITY';
+// GenAI semantic conventions
+OpenTelemetryConstants.GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = 'gen_ai.client.operation.duration';
+OpenTelemetryConstants.GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = 'gen_ai.client.token.usage';
+OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY = 'gen_ai.operation.name';
+OpenTelemetryConstants.GEN_AI_REQUEST_MAX_TOKENS_KEY = 'gen_ai.request.max_tokens';
+OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY = 'gen_ai.request.model';
+OpenTelemetryConstants.GEN_AI_REQUEST_TEMPERATURE_KEY = 'gen_ai.request.temperature';
+OpenTelemetryConstants.GEN_AI_REQUEST_TOP_P_KEY = 'gen_ai.request.top_p';
+OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY = 'gen_ai.response.id';
+OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY = 'gen_ai.response.finish_reasons';
+OpenTelemetryConstants.GEN_AI_RESPONSE_MODEL_KEY = 'gen_ai.response.model';
+OpenTelemetryConstants.GEN_AI_SYSTEM_KEY = 'gen_ai.system';
+OpenTelemetryConstants.GEN_AI_SYSTEM_VALUE = 'az.ai.agent365';
+OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY = 'gen_ai.agent.id';
+OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY = 'gen_ai.agent.name';
+OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY = 'gen_ai.agent.description';
+OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY = 'gen_ai.conversation.id';
+OpenTelemetryConstants.GEN_AI_CONVERSATION_ITEM_LINK_KEY = 'gen_ai.conversation.item.link';
+OpenTelemetryConstants.GEN_AI_TOKEN_TYPE_KEY = 'gen_ai.token.type';
+OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY = 'gen_ai.usage.input_tokens';
+OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY = 'gen_ai.usage.output_tokens';
+OpenTelemetryConstants.GEN_AI_CHOICE = 'gen_ai.choice';
+OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY = 'gen_ai.provider.name';
+OpenTelemetryConstants.GEN_AI_SYSTEM_INSTRUCTIONS_KEY = 'gen_ai.system_instructions';
+OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY = 'gen_ai.input.messages';
+OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY = 'gen_ai.output.messages';
+OpenTelemetryConstants.GEN_AI_EVENT_CONTENT = 'gen_ai.event.content';
+// Tool execution constants
+OpenTelemetryConstants.GEN_AI_TOOL_CALL_ID_KEY = 'gen_ai.tool.call.id';
+OpenTelemetryConstants.GEN_AI_TOOL_NAME_KEY = 'gen_ai.tool.name';
+OpenTelemetryConstants.GEN_AI_TOOL_DESCRIPTION_KEY = 'gen_ai.tool.description';
+OpenTelemetryConstants.GEN_AI_TOOL_ARGS_KEY = 'gen_ai.tool.call.arguments';
+OpenTelemetryConstants.GEN_AI_TOOL_CALL_RESULT_KEY = 'gen_ai.event.content'; // GEN_AI_EVENT_CONTENT
+OpenTelemetryConstants.GEN_AI_TOOL_TYPE_KEY = 'gen_ai.tool.type';
+// Agent user (user tied to agent instance during creation) or caller dimensions
+OpenTelemetryConstants.GEN_AI_AGENT_USER_ID_KEY = 'gen_ai.agent.userid';
+OpenTelemetryConstants.GEN_AI_CALLER_USER_ID_KEY = 'gen_ai.caller.userid';
+OpenTelemetryConstants.GEN_AI_CALLER_TENANT_ID_KEY = 'gen_ai.caller.tenantid';
+OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY = 'gen_ai.caller.id';
+OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY = 'gen_ai.caller.name';
+OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY = 'gen_ai.caller.upn';
+// Agent to Agent caller agent dimensions
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_USER_ID_KEY = 'gen_ai.caller.agent.userid';
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_UPN_KEY = 'gen_ai.caller.agent.upn';
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_TENANT_ID_KEY = 'gen_ai.caller.agent.tenantid';
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_NAME_KEY = 'gen_ai.caller.agent.name';
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_ID_KEY = 'gen_ai.caller.agent.id';
+OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = 'gen_ai.caller.agent.applicationid';
+// Agent-specific dimensions
+OpenTelemetryConstants.AGENT_ID_KEY = 'gen_ai.agent.id';
+OpenTelemetryConstants.GEN_AI_TASK_ID_KEY = 'gen_ai.task.id';
+OpenTelemetryConstants.SESSION_ID_KEY = 'session.id';
+OpenTelemetryConstants.GEN_AI_ICON_URI_KEY = 'gen_ai.agent365.icon_uri';
+OpenTelemetryConstants.TENANT_ID_KEY = 'tenant.id';
+// Baggage keys
+OpenTelemetryConstants.OPERATION_SOURCE_KEY = 'operation.source';
+OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY = 'gen_ai.agent.user.id';
+OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY = 'gen_ai.agent.upn';
+OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY = 'gen_ai.agent.applicationid';
+OpenTelemetryConstants.CORRELATION_ID_KEY = 'correlation.id';
+OpenTelemetryConstants.HIRING_MANAGER_ID_KEY = 'hiring.manager.id';
+// Execution context dimensions
+OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY = 'gen_ai.execution.type';
+OpenTelemetryConstants.GEN_AI_EXECUTION_PAYLOAD_KEY = 'gen_ai.execution.payload';
+// Source metadata dimensions
+OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY = 'gen_ai.execution.sourceMetadata.id';
+OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY = 'gen_ai.channel.name';
+OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY = 'gen_ai.channel.link';
+// Custom parent id and parent name key
+OpenTelemetryConstants.CUSTOM_PARENT_SPAN_ID_KEY = 'custom.parent.span.id';
+OpenTelemetryConstants.CUSTOM_SPAN_NAME_KEY = 'custom.span.name';
+//# sourceMappingURL=constants.js.map

package/dist/cjs/tracing/constants.js.map

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