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

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

@@ -0,0 +1,146 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryScope = void 0;
+const api_1 = require("@opentelemetry/api");
+const constants_1 = require("../constants");
+const util_1 = require("../util");
+const logging_1 = __importDefault(require("../../utils/logging"));
+/**
+ * Base class for OpenTelemetry tracing scopes
+ */
+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 = api_1.context.active();
+        logging_1.default.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: {
+                [constants_1.OpenTelemetryConstants.GEN_AI_SYSTEM_KEY]: constants_1.OpenTelemetryConstants.GEN_AI_SYSTEM_VALUE,
+                [constants_1.OpenTelemetryConstants.GEN_AI_OPERATION_NAME_KEY]: operationName,
+            },
+        }, currentContext);
+        logging_1.default.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(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_ID_KEY, agentDetails.agentId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_NAME_KEY, agentDetails.agentName);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_DESCRIPTION_KEY, agentDetails.agentDescription);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_CONVERSATION_ID_KEY, agentDetails.conversationId);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_ICON_URI_KEY, agentDetails.iconUri);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_AUID_KEY, agentDetails.agentAUID);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_UPN_KEY, agentDetails.agentUPN);
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.GEN_AI_AGENT_BLUEPRINT_ID_KEY, agentDetails.agentBlueprintId);
+        }
+        // Set tenant details if provided
+        if (tenantDetails) {
+            this.setTagMaybe(constants_1.OpenTelemetryConstants.TENANT_ID_KEY, tenantDetails.tenantId);
+        }
+    }
+    /**
+     * Makes this span active for the duration of the async callback execution
+     */
+    withActiveSpanAsync(callback) {
+        const newContext = api_1.trace.setSpan(api_1.context.active(), this.span);
+        return api_1.context.with(newContext, callback);
+    }
+    /**
+     * Records an error that occurred during the operation
+     * @param error The error that occurred
+     */
+    recordError(error) {
+        if (OpenTelemetryScope.enableTelemetry) {
+            logging_1.default.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: api_1.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) {
+            logging_1.default.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[constants_1.OpenTelemetryConstants.ERROR_TYPE_KEY] = this.errorType;
+            this.span.setAttributes({ [constants_1.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;
+        logging_1.default.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]();
+    }
+}
+exports.OpenTelemetryScope = OpenTelemetryScope;
+OpenTelemetryScope.tracer = api_1.trace.getTracer(constants_1.OpenTelemetryConstants.SOURCE_NAME);
+OpenTelemetryScope.enableTelemetry = (0, util_1.isAgent365TelemetryEnabled)();
+//# sourceMappingURL=OpenTelemetryScope.js.map

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

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

package/dist/cjs/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/cjs/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/cjs/tracing/util.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAgent365TelemetryEnabled = exports.isAgent365ExporterEnabled = void 0;
+const constants_1 = require("./constants");
+/**
+ * Check if exporter is enabled via environment variables
+ */
+const isAgent365ExporterEnabled = () => {
+    const enableA365Exporter = process.env[constants_1.OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY_EXPORTER]?.toLowerCase();
+    return (enableA365Exporter === 'true' ||
+        enableA365Exporter === '1' ||
+        enableA365Exporter === 'yes' ||
+        enableA365Exporter === 'on');
+};
+exports.isAgent365ExporterEnabled = isAgent365ExporterEnabled;
+/**
+   * Gets the enable telemetry configuration value
+   */
+const isAgent365TelemetryEnabled = () => {
+    const enableObservability = process.env[constants_1.OpenTelemetryConstants.ENABLE_OBSERVABILITY]?.toLowerCase();
+    const enableA365 = process.env[constants_1.OpenTelemetryConstants.ENABLE_A365_OBSERVABILITY]?.toLowerCase();
+    return (enableObservability === 'true' ||
+        enableObservability === '1' ||
+        enableA365 === 'true' ||
+        enableA365 === '1');
+};
+exports.isAgent365TelemetryEnabled = isAgent365TelemetryEnabled;
+//# sourceMappingURL=util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/tracing/util.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAGrD;;GAEG;AACI,MAAM,yBAAyB,GAAkB,GAAY,EAAE;IACpE,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAsB,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;AATW,QAAA,yBAAyB,6BASpC;AAEF;;KAEK;AACE,MAAM,0BAA0B,GAAkB,GAAY,EAAE;IACrE,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAsB,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC;IACpG,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAsB,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;AAVW,QAAA,0BAA0B,8BAUrC"}

package/dist/cjs/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/cjs/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/cjs/utils/logging.js

@@ -0,0 +1,84 @@
+"use strict";
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatError = formatError;
+/**
+ * Format error object for logging with message and stack trace
+ */
+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);
+        }
+    }
+};
+exports.default = logger;
+//# sourceMappingURL=logging.js.map

package/dist/cjs/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;;AAKjF,kCAKC;AARD;;GAEG;AACH,SAAgB,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,kBAAe,MAAM,CAAC"}

package/dist/esm/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/esm/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/esm/ObservabilityBuilder.js

@@ -0,0 +1,137 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { ConsoleSpanExporter, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { SpanProcessor } from './tracing/processors/SpanProcessor';
+import { isAgent365ExporterEnabled } from './tracing/util';
+import { Agent365Exporter } from './tracing/exporter/Agent365Exporter';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+import { trace } from '@opentelemetry/api';
+/**
+ * Builder for configuring Agent 365 with OpenTelemetry tracing
+ */
+export 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 (isAgent365ExporterEnabled()) {
+            if (!this.options.tokenResolver) {
+                throw new Error('tokenResolver must be provided when Agent 365 exporter is enabled');
+            }
+            return new Agent365Exporter(this.options.tokenResolver, this.options.clusterCategory || 'prod');
+        }
+        else {
+            return new ConsoleSpanExporter();
+        }
+    }
+    createResource() {
+        const serviceName = this.options.serviceVersion
+            ? `${this.options.serviceName}-${this.options.serviceVersion}`
+            : this.options.serviceName ?? 'Agent365-TypeScript';
+        return resourceFromAttributes({
+            [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();
+        // 2. batch processor that actually ships spans out
+        const batchProcessor = new BatchSpanProcessor(this.getTraceExporter());
+        const globalProvider = 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 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);
+        }
+    }
+}
+//# sourceMappingURL=ObservabilityBuilder.js.map

package/dist/esm/ObservabilityBuilder.js.map

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

package/dist/esm/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/esm/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/esm/ObservabilityManager.js

@@ -0,0 +1,57 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+import { ObservabilityBuilder } from './ObservabilityBuilder';
+/**
+ * Main entry point for Agent 365 providing OpenTelemetry tracing for AI agents and tools
+ */
+export 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();
+        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();
+        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;
+        }
+    }
+}
+//# sourceMappingURL=ObservabilityManager.js.map

package/dist/esm/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,OAAO,EAAE,oBAAoB,EAAkB,MAAM,wBAAwB,CAAC;AAE9E;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAI/B;;;;OAIG;IACI,MAAM,CAAC,SAAS,CACrB,SAAmD;QAEnD,MAAM,OAAO,GAAG,IAAI,oBAAoB,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,oBAAoB,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"}

package/dist/esm/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/esm/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/esm/index.js

@@ -0,0 +1,18 @@
+// ------------------------------------------------------------------------------
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// ------------------------------------------------------------------------------
+// Main SDK classes
+export { ObservabilityManager } from './ObservabilityManager';
+export { ObservabilityBuilder as Builder } from './ObservabilityBuilder';
+// Tracing constants
+export { OpenTelemetryConstants } from './tracing/constants';
+// Baggage builder
+export { BaggageBuilder, BaggageScope } from './tracing/middleware/BaggageBuilder';
+// Contracts and interfaces
+export { ExecutionType, InvocationRole, InferenceOperationType } from './tracing/contracts';
+// Scopes
+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.js.map