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

package/dist/esm/tracing/scopes/InferenceScope.js

@@ -0,0 +1,79 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { SpanKind } from '@opentelemetry/api';
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { OpenTelemetryConstants } from '../constants';
+/**
+ * Provides OpenTelemetry tracing scope for generative AI inference operations.
+ */
+export class InferenceScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for inference tracing.
+     * @param details The inference call details
+     * @param agentDetails The agent details
+     * @param tenantDetails The tenant details
+     * @returns A new InferenceScope instance
+     */
+    static start(details, agentDetails, tenantDetails) {
+        return new InferenceScope(details, agentDetails, tenantDetails);
+    }
+    constructor(details, agentDetails, tenantDetails) {
+        super(SpanKind.CLIENT, details.operationName.toString(), `${details.operationName} ${details.model}`, agentDetails, tenantDetails);
+        // Set core inference information matching C# implementation
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY, details.operationName.toString());
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_REQUEST_MODEL_KEY, details.model);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_PROVIDER_NAME_KEY, details.providerName);
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, details.inputTokens?.toString());
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, details.outputTokens?.toString());
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, details.finishReasons?.join(','));
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY, details.responseId);
+    }
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, messages.join(','));
+    }
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, messages.join(','));
+    }
+    /**
+     * Records the number of input tokens for telemetry tracking.
+     * @param inputTokens Number of input tokens
+     */
+    recordInputTokens(inputTokens) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_INPUT_TOKENS_KEY, inputTokens.toString());
+    }
+    /**
+     * Records the number of output tokens for telemetry tracking.
+     * @param outputTokens Number of output tokens
+     */
+    recordOutputTokens(outputTokens) {
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_USAGE_OUTPUT_TOKENS_KEY, outputTokens.toString());
+    }
+    /**
+     * Records the response id for telemetry tracking.
+     * @param responseId The response ID
+     */
+    recordResponseId(responseId) {
+        if (responseId && responseId.trim()) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_ID_KEY, responseId);
+        }
+    }
+    /**
+     * Records the finish reasons for telemetry tracking.
+     * @param finishReasons Array of finish reasons
+     */
+    recordFinishReasons(finishReasons) {
+        if (finishReasons && finishReasons.length > 0) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_RESPONSE_FINISH_REASONS_KEY, finishReasons.join(','));
+        }
+    }
+}
+//# sourceMappingURL=InferenceScope.js.map

package/dist/esm/tracing/scopes/InferenceScope.js.map

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

package/dist/esm/tracing/scopes/InvokeAgentScope.d.ts

@@ -0,0 +1,33 @@
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { InvokeAgentDetails, TenantDetails, CallerDetails, EnhancedAgentDetails } from '../contracts';
+/**
+ * Provides OpenTelemetry tracing scope for AI agent invocation operations.
+ */
+export declare class InvokeAgentScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for agent invocation tracing.
+     * @param invokeAgentDetails The details of the agent invocation including endpoint, agent information, and conversation context.
+     * @param tenantDetails The tenant details.
+     * @param callerAgentDetails The details of the caller agent.
+     * @param callerDetails The details of the non-agentic caller.
+     * @returns A new InvokeAgentScope instance.
+     */
+    static start(invokeAgentDetails: InvokeAgentDetails, tenantDetails: TenantDetails, callerAgentDetails?: EnhancedAgentDetails, callerDetails?: CallerDetails): InvokeAgentScope;
+    private constructor();
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The invocation response
+     */
+    recordResponse(response: string): void;
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages: string[]): void;
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages: string[]): void;
+}
+//# sourceMappingURL=InvokeAgentScope.d.ts.map

package/dist/esm/tracing/scopes/InvokeAgentScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeAgentScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/InvokeAgentScope.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IAEtD;;;;;;;OAOG;WACW,KAAK,CACjB,kBAAkB,EAAE,kBAAkB,EACtC,aAAa,EAAE,aAAa,EAC5B,kBAAkB,CAAC,EAAE,oBAAoB,EACzC,aAAa,CAAC,EAAE,aAAa,GAC5B,gBAAgB;IAInB,OAAO;IA8DP;;;OAGG;IACI,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAMpD;;;OAGG;IACI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAKtD"}

package/dist/esm/tracing/scopes/InvokeAgentScope.js

@@ -0,0 +1,90 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { SpanKind } from '@opentelemetry/api';
+import { OpenTelemetryScope } from './OpenTelemetryScope';
+import { OpenTelemetryConstants } from '../constants';
+/**
+ * Provides OpenTelemetry tracing scope for AI agent invocation operations.
+ */
+export class InvokeAgentScope extends OpenTelemetryScope {
+    /**
+     * Creates and starts a new scope for agent invocation tracing.
+     * @param invokeAgentDetails The details of the agent invocation including endpoint, agent information, and conversation context.
+     * @param tenantDetails The tenant details.
+     * @param callerAgentDetails The details of the caller agent.
+     * @param callerDetails The details of the non-agentic caller.
+     * @returns A new InvokeAgentScope instance.
+     */
+    static start(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails) {
+        return new InvokeAgentScope(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails);
+    }
+    constructor(invokeAgentDetails, tenantDetails, callerAgentDetails, callerDetails) {
+        super(SpanKind.CLIENT, OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, invokeAgentDetails.agentName
+            ? `${OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME} ${invokeAgentDetails.agentName}`
+            : OpenTelemetryConstants.INVOKE_AGENT_OPERATION_NAME, invokeAgentDetails, tenantDetails);
+        // Set session ID and endpoint information
+        this.setTagMaybe(OpenTelemetryConstants.SESSION_ID_KEY, invokeAgentDetails.sessionId);
+        if (invokeAgentDetails.endpoint) {
+            this.setTagMaybe(OpenTelemetryConstants.SERVER_ADDRESS_KEY, invokeAgentDetails.endpoint.host);
+            // Only record port if it is different from 443 (default HTTPS port)
+            if (invokeAgentDetails.endpoint.port && invokeAgentDetails.endpoint.port !== 443) {
+                this.setTagMaybe(OpenTelemetryConstants.SERVER_PORT_KEY, invokeAgentDetails.endpoint.port);
+            }
+        }
+        // Set request-related tags
+        const requestToUse = invokeAgentDetails.request;
+        if (requestToUse) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_EXECUTION_TYPE_KEY, requestToUse.executionType?.toString());
+            if (requestToUse.sourceMetadata) {
+                this.setTagMaybe(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_ID_KEY, requestToUse.sourceMetadata.id);
+                this.setTagMaybe(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_NAME_KEY, requestToUse.sourceMetadata.name);
+                this.setTagMaybe(OpenTelemetryConstants.GEN_AI_EXECUTION_SOURCE_DESCRIPTION_KEY, requestToUse.sourceMetadata.description);
+            }
+        }
+        this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, invokeAgentDetails.conversationId);
+        // Set caller details tags
+        if (callerDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_ID_KEY, callerDetails.callerId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_UPN_KEY, callerDetails.callerUpn);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_NAME_KEY, callerDetails.callerName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_USER_ID_KEY, callerDetails.callerUserId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_TENANT_ID_KEY, callerDetails.tenantId);
+        }
+        // Set caller agent details tags
+        if (callerAgentDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_NAME_KEY, callerAgentDetails.agentName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_ID_KEY, callerAgentDetails.agentId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY, callerAgentDetails.agentBlueprintId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_USER_ID_KEY, callerAgentDetails.agentAUID);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_UPN_KEY, callerAgentDetails.agentUPN);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CALLER_AGENT_TENANT_ID_KEY, callerAgentDetails.tenantId);
+        }
+    }
+    /**
+     * Records response information for telemetry tracking.
+     * @param response The invocation response
+     */
+    recordResponse(response) {
+        this.recordOutputMessages([response]);
+    }
+    /**
+     * Records the input messages for telemetry tracking.
+     * @param messages Array of input messages
+     */
+    recordInputMessages(messages) {
+        if (InvokeAgentScope.enableTelemetry) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_INPUT_MESSAGES_KEY, messages.join(','));
+        }
+    }
+    /**
+     * Records the output messages for telemetry tracking.
+     * @param messages Array of output messages
+     */
+    recordOutputMessages(messages) {
+        if (InvokeAgentScope.enableTelemetry) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_OUTPUT_MESSAGES_KEY, messages.join(','));
+        }
+    }
+}
+//# sourceMappingURL=InvokeAgentScope.js.map

package/dist/esm/tracing/scopes/InvokeAgentScope.js.map

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

package/dist/esm/tracing/scopes/OpenTelemetryScope.d.ts

@@ -0,0 +1,57 @@
+import { SpanKind, Span } from '@opentelemetry/api';
+import { EnhancedAgentDetails, TenantDetails } from '../contracts';
+/**
+ * Base class for OpenTelemetry tracing scopes
+ */
+export declare abstract class OpenTelemetryScope implements Disposable {
+    private static readonly tracer;
+    protected readonly span: Span;
+    private readonly startTime;
+    protected static enableTelemetry: boolean;
+    private errorType?;
+    private exception?;
+    private hasEnded;
+    /**
+     * Initializes a new instance of the OpenTelemetryScope class
+     * @param kind The kind of span (CLIENT, SERVER, INTERNAL, etc.)
+     * @param operationName The name of the operation being traced
+     * @param spanName The name of the span for display purposes
+     * @param agentDetails Optional agent details
+     * @param tenantDetails Optional tenant details
+     */
+    protected constructor(kind: SpanKind, operationName: string, spanName: string, agentDetails?: EnhancedAgentDetails, tenantDetails?: TenantDetails);
+    /**
+     * Makes this span active for the duration of the async callback execution
+     */
+    withActiveSpanAsync<T>(callback: () => Promise<T>): Promise<T>;
+    /**
+     * Records an error that occurred during the operation
+     * @param error The error that occurred
+     */
+    recordError(error: Error): void;
+    /**
+     * Sets a tag on the span if telemetry is enabled
+     * @param name The tag name
+     * @param value The tag value
+     */
+    protected setTagMaybe<T extends string | number | boolean>(name: string, value: T | null | undefined): void;
+    /**
+     * Add baggage to the current context
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    protected addBaggage(key: string, value: string): void;
+    /**
+     * Finalizes the scope and records metrics
+     */
+    private end;
+    /**
+     * Disposes the scope and finalizes telemetry data collection
+     */
+    [Symbol.dispose](): void;
+    /**
+     * Legacy dispose method for compatibility
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=OpenTelemetryScope.d.ts.map

package/dist/esm/tracing/scopes/OpenTelemetryScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryScope.d.ts","sourceRoot":"","sources":["../../../../src/tracing/scopes/OpenTelemetryScope.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,QAAQ,EAAE,IAAI,EAAuC,MAAM,oBAAoB,CAAC;AAGhG,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,8BAAsB,kBAAmB,YAAW,UAAU;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAErF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,SAAS,CAAC,MAAM,CAAC,eAAe,UAAgC;IAEhE,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;;;OAOG;IACH,SAAS,aACP,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,oBAAoB,EACnC,aAAa,CAAC,EAAE,aAAa;IAoC/B;;OAEG;IACI,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAKrE;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAoBtC;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAM3G;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQtD;;OAEG;IACH,OAAO,CAAC,GAAG;IAsBX;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAO/B;;OAEG;IACI,OAAO,IAAI,IAAI;CAIvB"}

package/dist/esm/tracing/scopes/OpenTelemetryScope.js

@@ -0,0 +1,139 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { trace, SpanStatusCode, context } from '@opentelemetry/api';
+import { OpenTelemetryConstants } from '../constants';
+import { isAgent365TelemetryEnabled } from '../util';
+import logger from '../../utils/logging';
+/**
+ * Base class for OpenTelemetry tracing scopes
+ */
+export class OpenTelemetryScope {
+    /**
+     * Initializes a new instance of the OpenTelemetryScope class
+     * @param kind The kind of span (CLIENT, SERVER, INTERNAL, etc.)
+     * @param operationName The name of the operation being traced
+     * @param spanName The name of the span for display purposes
+     * @param agentDetails Optional agent details
+     * @param tenantDetails Optional tenant details
+     */
+    constructor(kind, operationName, spanName, agentDetails, tenantDetails) {
+        this.hasEnded = false;
+        const currentContext = context.active();
+        logger.info(`[A365Observability] Starting span: ${spanName}, operation: ${operationName} for tenantId: ${tenantDetails?.tenantId || 'unknown'}, agentId: ${agentDetails?.agentId || 'unknown'}`);
+        // Start span with current context to establish parent-child relationship
+        this.span = OpenTelemetryScope.tracer.startSpan(spanName, {
+            kind,
+            attributes: {
+                [OpenTelemetryConstants.GEN_AI_SYSTEM_KEY]: OpenTelemetryConstants.GEN_AI_SYSTEM_VALUE,
+                [OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY]: operationName,
+            },
+        }, currentContext);
+        logger.info(`[A365Observability] Span[${this.span.spanContext().spanId}] ${spanName}, operation: ${operationName} started successfully`);
+        this.startTime = Date.now();
+        // Set agent details if provided
+        if (agentDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, agentDetails.agentId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, agentDetails.agentName);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, agentDetails.agentDescription);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, agentDetails.conversationId);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_ICON_URI_KEY, agentDetails.iconUri);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, agentDetails.agentAUID);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY, agentDetails.agentUPN);
+            this.setTagMaybe(OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, agentDetails.agentBlueprintId);
+        }
+        // Set tenant details if provided
+        if (tenantDetails) {
+            this.setTagMaybe(OpenTelemetryConstants.TENANT_ID_KEY, tenantDetails.tenantId);
+        }
+    }
+    /**
+     * Makes this span active for the duration of the async callback execution
+     */
+    withActiveSpanAsync(callback) {
+        const newContext = trace.setSpan(context.active(), this.span);
+        return context.with(newContext, callback);
+    }
+    /**
+     * Records an error that occurred during the operation
+     * @param error The error that occurred
+     */
+    recordError(error) {
+        if (OpenTelemetryScope.enableTelemetry) {
+            logger.error(`[A365Observability] Records an error that occurred during the operation span[${this.span.spanContext().spanId}]: ${error.message}`);
+            // Check if it's an HTTP error with status code
+            if ('status' in error && typeof error.status === 'number') {
+                this.errorType = error.status.toString();
+            }
+            else {
+                this.errorType = error.constructor.name;
+            }
+            this.exception = error;
+            this.span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error.message
+            });
+            this.span.recordException(error);
+        }
+    }
+    /**
+     * Sets a tag on the span if telemetry is enabled
+     * @param name The tag name
+     * @param value The tag value
+     */
+    setTagMaybe(name, value) {
+        if (OpenTelemetryScope.enableTelemetry && value != null) {
+            this.span.setAttributes({ [name]: value });
+        }
+    }
+    /**
+     * Add baggage to the current context
+     * @param key The baggage key
+     * @param value The baggage value
+     */
+    addBaggage(key, value) {
+        if (OpenTelemetryScope.enableTelemetry) {
+            // Note: OpenTelemetry JS doesn't have direct baggage API in span
+            // This would typically be handled through the baggage API
+            this.span.setAttributes({ [`baggage.${key}`]: value });
+        }
+    }
+    /**
+     * Finalizes the scope and records metrics
+     */
+    end() {
+        if (this.hasEnded) {
+            logger.info(`[A365Observability] Span already ended for span[${this.span.spanContext().spanId}]`);
+            return;
+        }
+        const duration = (Date.now() - this.startTime) / 1000; // Convert to seconds
+        const finalTags = {};
+        if (this.errorType) {
+            finalTags[OpenTelemetryConstants.ERROR_TYPE_KEY] = this.errorType;
+            this.span.setAttributes({ [OpenTelemetryConstants.ERROR_TYPE_KEY]: this.errorType });
+        }
+        // Record duration metric (would typically use a meter here)
+        // For now, we'll add it as a span attribute
+        this.span.setAttributes({ 'operation.duration': duration });
+        this.hasEnded = true;
+        logger.info(`[A365Observability] Ending span[${this.span.spanContext().spanId}], duration: ${duration}s`);
+    }
+    /**
+     * Disposes the scope and finalizes telemetry data collection
+     */
+    [Symbol.dispose]() {
+        if (!this.hasEnded) {
+            this.end();
+            this.span.end();
+        }
+    }
+    /**
+     * Legacy dispose method for compatibility
+     */
+    dispose() {
+        this[Symbol.dispose]();
+    }
+}
+OpenTelemetryScope.tracer = trace.getTracer(OpenTelemetryConstants.SOURCE_NAME);
+OpenTelemetryScope.enableTelemetry = isAgent365TelemetryEnabled();
+//# sourceMappingURL=OpenTelemetryScope.js.map

package/dist/esm/tracing/scopes/OpenTelemetryScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenTelemetryScope.js","sourceRoot":"","sources":["../../../../src/tracing/scopes/OpenTelemetryScope.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF,OAAO,EAAE,KAAK,EAAkB,cAAc,EAAc,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,MAAM,MAAM,qBAAqB,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAgB,kBAAkB;IAYtC;;;;;;;OAOG;IACH,YACE,IAAc,EACd,aAAqB,EACrB,QAAgB,EAChB,YAAmC,EACnC,aAA6B;QAfvB,aAAQ,GAAG,KAAK,CAAC;QAiBvB,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,sCAAsC,QAAQ,gBAAgB,aAAa,kBAAkB,aAAa,EAAE,QAAQ,IAAI,SAAS,cAAc,YAAY,EAAE,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;QAEjM,yEAAyE;QACzE,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE;YACxD,IAAI;YACJ,UAAU,EAAE;gBACV,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,mBAAmB;gBACtF,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,EAAE,aAAa;aAClE;SACF,EAAE,cAAc,CAAC,CAAC;QAEnB,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,QAAQ,gBAAgB,aAAa,uBAAuB,CAAC,CAAC;QAEzI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,gCAAgC;QAChC,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,4BAA4B,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;YACrG,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,0BAA0B,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;YACjG,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,mBAAmB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACnF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,oBAAoB,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;YACrF,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,6BAA6B,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;QACxG,CAAC;QAED,iCAAiC;QACjC,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAI,QAA0B;QACtD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,KAAY;QAC7B,IAAI,kBAAkB,CAAC,eAAe,EAAE,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,gFAAgF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAClJ,+CAA+C;YAC/C,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC1D,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;YAC1C,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;gBAClB,IAAI,EAAE,cAAc,CAAC,KAAK;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,WAAW,CAAsC,IAAY,EAAE,KAA2B;QAClG,IAAI,kBAAkB,CAAC,eAAe,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAkC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;;;OAIG;IACO,UAAU,CAAC,GAAW,EAAE,KAAa;QAC7C,IAAI,kBAAkB,CAAC,eAAe,EAAE,CAAC;YACvC,iEAAiE;YACjE,0DAA0D;YAC1D,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,GAAG;QACT,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,mDAAmD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAClG,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,qBAAqB;QAE5E,MAAM,SAAS,GAAc,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,SAAS,CAAC,sBAAsB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAClE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,4DAA4D;QAC5D,4CAA4C;QAC5C,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,gBAAgB,QAAQ,GAAG,CAAC,CAAC;IAC5G,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACzB,CAAC;;AA5JuB,yBAAM,GAAG,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,WAAW,CAAC,AAAtD,CAAuD;AAKpE,kCAAe,GAAG,0BAA0B,EAAE,AAA/B,CAAgC"}

package/dist/esm/tracing/util.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check if exporter is enabled via environment variables
+ */
+export declare const isAgent365ExporterEnabled: () => boolean;
+/**
+   * Gets the enable telemetry configuration value
+   */
+export declare const isAgent365TelemetryEnabled: () => boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/esm/tracing/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/tracing/util.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,OAS7C,CAAC;AAEF;;KAEK;AACL,eAAO,MAAM,0BAA0B,EAAE,MAAM,OAU9C,CAAC"}

package/dist/esm/tracing/util.js

@@ -0,0 +1,23 @@
+import { OpenTelemetryConstants } from './constants';
+/**
+ * Check if exporter is enabled via environment variables
+ */
+export const isAgent365ExporterEnabled = () => {
+    const enableA365Exporter = process.env[OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER]?.toLowerCase();
+    return (enableA365Exporter === 'true' ||
+        enableA365Exporter === '1' ||
+        enableA365Exporter === 'yes' ||
+        enableA365Exporter === 'on');
+};
+/**
+   * Gets the enable telemetry configuration value
+   */
+export const isAgent365TelemetryEnabled = () => {
+    const enableObservability = process.env[OpenTelemetryConstants.ENABLE_OBSERVABILITY]?.toLowerCase();
+    const enableA365 = process.env[OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY]?.toLowerCase();
+    return (enableObservability === 'true' ||
+        enableObservability === '1' ||
+        enableA365 === 'true' ||
+        enableA365 === '1');
+};
+//# sourceMappingURL=util.js.map

package/dist/esm/tracing/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/tracing/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAkB,GAAY,EAAE;IACpE,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,kCAAkC,CAAC,EAAE,WAAW,EAAE,CAAC;IAEjH,OAAO,CACL,kBAAkB,KAAK,MAAM;QAC7B,kBAAkB,KAAK,GAAG;QAC1B,kBAAkB,KAAK,KAAK;QAC5B,kBAAkB,KAAK,IAAI,CAC5B,CAAC;AACJ,CAAC,CAAC;AAEF;;KAEK;AACL,MAAM,CAAC,MAAM,0BAA0B,GAAkB,GAAY,EAAE;IACrE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC;IACpG,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,EAAE,WAAW,EAAE,CAAC;IAEhG,OAAO,CACL,mBAAmB,KAAK,MAAM;QAC9B,mBAAmB,KAAK,GAAG;QAC3B,UAAU,KAAK,MAAM;QACrB,UAAU,KAAK,GAAG,CACnB,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/utils/logging.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format error object for logging with message and stack trace
+ */
+export declare function formatError(error: unknown): string;
+declare const logger: {
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};
+export default logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/esm/utils/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/utils/logging.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlD;AA2DD,QAAA,MAAM,MAAM;oBACM,MAAM,WAAW,OAAO,EAAE;oBAO1B,MAAM,WAAW,OAAO,EAAE;qBAOzB,MAAM,WAAW,OAAO,EAAE;CAM5C,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/esm/utils/logging.js

@@ -0,0 +1,81 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+/**
+ * Format error object for logging with message and stack trace
+ */
+export function formatError(error) {
+    if (error instanceof Error) {
+        return `${error.message}\nStack: ${error.stack || 'No stack trace'}`;
+    }
+    return String(error);
+}
+/**
+ * Simple logger for Agent 365 observability
+ *
+ * Usage:
+ *   import logger from './logging';
+ *   logger.info('Info message');    // Shows when A365ObservabilityLogLevel includes 'info'
+ *   logger.warn('Warning');         // Shows when A365ObservabilityLogLevel includes 'warn'
+ *   logger.error('Error');          // Shows when A365ObservabilityLogLevel includes 'error'
+ *
+ * Environment Variable:
+ *   A365ObservabilityLogLevel=none|info|warn|error|info|warn|info|error  (default: none)
+ *
+ *   Single values:
+ *   none = no logging (default)
+ *   info = info messages only
+ *   warn = warn messages only
+ *   error = error messages only
+ *
+ *   Multiple values (pipe-separated):
+ *   info|warn = info and warn messages
+ *   warn|error = warn and error messages
+ *   info|warn|error = all message types
+ */
+const LOG_LEVELS = {
+    none: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+function parseLogLevel(level) {
+    const levels = new Set();
+    // Split by | to support multiple levels like "info|warn|error"
+    const levelStrings = level.toLowerCase().trim().split('|');
+    for (const levelString of levelStrings) {
+        const normalizedLevel = levelString.trim();
+        const levelValue = LOG_LEVELS[normalizedLevel];
+        if (levelValue !== undefined) {
+            levels.add(levelValue);
+        }
+    }
+    // If no valid levels found, default to none
+    if (levels.size === 0) {
+        levels.add(LOG_LEVELS.none);
+    }
+    return levels;
+}
+const enabledLogLevels = parseLogLevel(process.env.A365_OBSERVABILITY_LOG_LEVEL || 'none');
+const logger = {
+    info: (message, ...args) => {
+        if (enabledLogLevels.has(LOG_LEVELS.info)) {
+            // eslint-disable-next-line no-console
+            console.log('[INFO]', message, ...args);
+        }
+    },
+    warn: (message, ...args) => {
+        if (enabledLogLevels.has(LOG_LEVELS.warn)) {
+            // eslint-disable-next-line no-console
+            console.warn('[WARN]', message, ...args);
+        }
+    },
+    error: (message, ...args) => {
+        if (enabledLogLevels.has(LOG_LEVELS.error)) {
+            // eslint-disable-next-line no-console
+            console.error('[ERROR]', message, ...args);
+        }
+    }
+};
+export default logger;
+//# sourceMappingURL=logging.js.map

package/dist/esm/utils/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/utils/logging.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4DAA4D;AAC5D,iFAAiF;AAEjF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC,OAAO,YAAY,KAAK,CAAC,KAAK,IAAI,gBAAgB,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAC;AAIX,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,+DAA+D;IAC/D,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3D,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,EAAc,CAAC;QACvD,MAAM,UAAU,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QAC/C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,gBAAgB,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,MAAM,CAAC,CAAC;AAE3F,MAAM,MAAM,GAAG;IACb,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC5C,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QAC7C,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@microsoft/agents-a365-observability",
+  "version": "0.1.0-preview.30",
+  "description": "OpenTelemetry tracing and monitoring SDK for AI agents built with TypeScript/Node.js",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "scripts": {
+    "build:cjs": "npx tsc --project tsconfig.cjs.json",
+    "build:esm": "npx tsc --project tsconfig.esm.json",
+    "build": "npm run build:cjs && npm run build:esm",
+    "build:watch": "npx tsc --watch",
+    "clean": "npx rimraf dist",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run clean && npm run build",
+    "ci": "npm ci",
+    "pack": "npm pack --pack-destination=../"
+  },
+  "keywords": [
+    "Agent365",
+    "opentelemetry",
+    "tracing",
+    "monitoring",
+    "ai",
+    "agents",
+    "azure",
+    "typescript"
+  ],
+  "author": "Microsoft Corporation",
+  "license": "See license file",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/Agent365-nodejs.git",
+    "directory": "packages/agents-a365-observability"
+  },
+  "dependencies": {
+    "@azure/monitor-opentelemetry-exporter": "*",
+    "@microsoft/agents-a365-runtime": "0.1.0-preview.30",
+    "@opentelemetry/api": "*",
+    "@opentelemetry/exporter-trace-otlp-http": "*",
+    "@opentelemetry/instrumentation": "*",
+    "@opentelemetry/resources": "*",
+    "@opentelemetry/sdk-node": "*",
+    "@opentelemetry/sdk-trace-base": "*",
+    "@opentelemetry/semantic-conventions": "*"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}