@microsoft/agents-telemetry 1.5.0-beta.23.g2277c6f0ab

package/dist/cjs/src/loggers/debug.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDebugLogger = createDebugLogger;
+exports.link = link;
+const debug_1 = __importDefault(require("debug"));
+const platform_js_1 = require("../utils/platform.js");
+const base_js_1 = require("./base.js");
+/**
+ * Creates a debug logger with the specified namespace and log levels. The logger will use different colors for each log level and will work in both Node.js and browser environments.
+ */
+function createDebugLogger(namespace) {
+    return {
+        info: createLogger(namespace, 'info'),
+        warn: createLogger(namespace, 'warn'),
+        error: createLogger(namespace, 'error'),
+        debug: createLogger(namespace, 'debug'),
+    };
+}
+const colors = {
+    node: {
+        info: '2', // Green
+        warn: '3', // Yellow
+        error: '1', // Red
+        debug: '4', // Blue
+    },
+    browser: {
+        info: '#33CC99', // Green
+        warn: '#CCCC33', // Yellow
+        error: '#CC3366', // Red
+        debug: '#0066FF', // Blue
+    },
+};
+function createLogger(namespace, level) {
+    const logger = (0, debug_1.default)(`${namespace}:${level}`);
+    if (platform_js_1.isBrowser) {
+        logger.color = colors.browser[level];
+    }
+    else {
+        logger.color = colors.node[level];
+    }
+    return logger;
+}
+/**
+ * Links the debug logger with additional logger implementations.
+ *
+ * @remarks
+ * - Linked loggers only receive messages when the corresponding debug namespace is enabled.
+ */
+function link(debugLogger, ...loggers) {
+    return base_js_1.levels.reduce((acc, level) => {
+        acc[level] = (message, ...args) => {
+            if (!debugLogger[level].enabled) {
+                return;
+            }
+            debugLogger[level](message, ...args);
+            for (const logger of loggers) {
+                logger[level](message, ...args);
+            }
+        };
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=debug.js.map

package/dist/cjs/src/loggers/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../../src/loggers/debug.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAYH,8CAOC;AAoCD,oBAaC;AAlED,kDAA+B;AAC/B,sDAAgD;AAChD,uCAAkC;AAKlC;;GAEG;AACH,SAAgB,iBAAiB,CAAE,SAAiB;IAClD,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC;QACrC,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC;QACrC,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC;QACvC,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC;KACxC,CAAA;AACH,CAAC;AAED,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,GAAG,EAAE,QAAQ;QACnB,IAAI,EAAE,GAAG,EAAE,SAAS;QACpB,KAAK,EAAE,GAAG,EAAE,MAAM;QAClB,KAAK,EAAE,GAAG,EAAE,OAAO;KACpB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS,EAAE,QAAQ;QACzB,IAAI,EAAE,SAAS,EAAE,SAAS;QAC1B,KAAK,EAAE,SAAS,EAAE,MAAM;QACxB,KAAK,EAAE,SAAS,EAAE,OAAO;KAC1B;CAEF,CAAA;AAED,SAAS,YAAY,CAAE,SAAiB,EAAE,KAAkB;IAC1D,MAAM,MAAM,GAAG,IAAA,eAAW,EAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAA;IAEnD,IAAI,uBAAS,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,IAAI,CAAE,WAAmB,EAAE,GAAG,OAAqB;IACjE,OAAO,gBAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE;YAC/C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;gBAChC,OAAM;YACR,CAAC;YACD,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;YACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;YACjC,CAAC;QACH,CAAC,CAAA;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAgB,CAAC,CAAA;AACtB,CAAC"}

package/dist/cjs/src/loggers/otel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { OTelLogs } from '../types.js';
+import type { Logger } from './base.js';
+/**
+ * Creates an OpenTelemetry logger that implements the Logger interface for the Agents SDK. The logger will emit logs with the appropriate severity level and namespace attributes.
+ */
+export declare function createOTelLogger(otelLogs: OTelLogs, namespace: string): Logger;

package/dist/cjs/src/loggers/otel.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOTelLogger = createOTelLogger;
+/**
+ * Creates an OpenTelemetry logger that implements the Logger interface for the Agents SDK. The logger will emit logs with the appropriate severity level and namespace attributes.
+ */
+function createOTelLogger(otelLogs, namespace) {
+    return {
+        info: createLogger(otelLogs, namespace, 'info'),
+        warn: createLogger(otelLogs, namespace, 'warn'),
+        error: createLogger(otelLogs, namespace, 'error'),
+        debug: createLogger(otelLogs, namespace, 'debug'),
+    };
+}
+function createLogger(otelLogs, namespace, level) {
+    var _a;
+    const logger = otelLogs.logs.getLogger(namespace);
+    const _level = (_a = level === null || level === void 0 ? void 0 : level.toLowerCase()) !== null && _a !== void 0 ? _a : 'debug';
+    const severityNumber = {
+        debug: otelLogs.SeverityNumber.DEBUG,
+        info: otelLogs.SeverityNumber.INFO,
+        warn: otelLogs.SeverityNumber.WARN,
+        error: otelLogs.SeverityNumber.ERROR,
+    }[_level];
+    return function log(message, ...args) {
+        logger.emit({
+            severityNumber,
+            severityText: _level.toUpperCase(),
+            body: formatMessage(message, args),
+            attributes: {
+                'log.namespace': namespace,
+                'log.level': _level,
+            },
+        });
+    };
+}
+/**
+ * Formats the message body sent to the OTel log record.
+ *
+ * @remarks
+ * - Extra arguments are serialized and appended to the main message.
+ */
+function formatMessage(message, args) {
+    if (args.length === 0) {
+        return message;
+    }
+    const serialized = args.map((value) => serializeLogValue(value)).join(' ');
+    return `${message} ${serialized}`;
+}
+/**
+ * Converts log arguments to a string form that is safe to emit.
+ */
+function serializeLogValue(value) {
+    if (value instanceof Error) {
+        return `${value.name}: ${value.message}`;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (value === null || value === undefined) {
+        return String(value);
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=otel.js.map

package/dist/cjs/src/loggers/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../../src/loggers/otel.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAQH,4CAOC;AAVD;;GAEG;AACH,SAAgB,gBAAgB,CAAE,QAAkB,EAAE,SAAiB;IACrE,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;QAC/C,IAAI,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;QAC/C,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;QACjD,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;KAClD,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAE,QAAkB,EAAE,SAAiB,EAAE,KAAkB;;IAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,WAAW,EAAE,mCAAI,OAAO,CAAA;IAC9C,MAAM,cAAc,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,KAAK;QACpC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI;QAClC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI;QAClC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,KAAK;KACrC,CAAC,MAAM,CAAC,CAAA;IAET,OAAO,SAAS,GAAG,CAAE,OAAe,EAAE,GAAG,IAAW;QAClD,MAAM,CAAC,IAAI,CAAC;YACV,cAAc;YACd,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE;YAClC,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC;YAClC,UAAU,EAAE;gBACV,eAAe,EAAE,SAAS;gBAC1B,WAAW,EAAE,MAAM;aACpB;SACF,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAE,OAAe,EAAE,IAAe;IACtD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1E,OAAO,GAAG,OAAO,IAAI,UAAU,EAAE,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAE,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;IAC1C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/cjs/src/observability/category.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { SpanName } from '../types.js';
+/**
+ * Determines if a span is disabled based on its name and the `AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES` environment variable or configuration setting.
+ * @param name The name of the span to check.
+ * @returns A boolean indicating whether the span is disabled.
+ */
+export declare function isSpanDisabled(name: SpanName): boolean;

package/dist/cjs/src/observability/category.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSpanDisabled = isSpanDisabled;
+const constants_js_1 = require("./constants.js");
+const debug_js_1 = require("../loggers/debug.js");
+const setting_js_1 = require("../utils/setting.js");
+const logger = (0, debug_js_1.createDebugLogger)('agents:telemetry');
+/**
+ * Resolves disabled spans once at module load time.
+ *
+ * @remarks
+ * - Unknown categories are ignored and logged as warnings.
+ * - Duplicate categories are de-duplicated by prefix before span names are expanded.
+ */
+const disabledSpans = (() => {
+    const rawValue = (0, setting_js_1.getSetting)(constants_js_1.AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES).trim().toUpperCase();
+    if (!rawValue) {
+        return [];
+    }
+    const envCategories = rawValue
+        .split(/[\s,]+/)
+        .map((category) => category.trim())
+        .filter(Boolean);
+    const spanNames = Object.entries(constants_js_1.SpanNames);
+    const processed = new Set();
+    const result = [];
+    for (const category of envCategories) {
+        const prefixes = constants_js_1.SpanCategories[category];
+        if (!prefixes) {
+            logger.warn(`Invalid span category "${category}" in ${constants_js_1.AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES}. Valid categories are: ${Object.keys(constants_js_1.SpanCategories).join(', ')}`);
+            continue;
+        }
+        for (const prefix of prefixes) {
+            if (processed.has(prefix)) {
+                continue;
+            }
+            processed.add(prefix);
+            for (const [key, name] of spanNames) {
+                if (key.startsWith(prefix)) {
+                    result.push(name);
+                }
+            }
+        }
+    }
+    if (result.length > 0) {
+        logger.debug('Disabled Span names:', result);
+    }
+    return result;
+})();
+/**
+ * Determines if a span is disabled based on its name and the `AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES` environment variable or configuration setting.
+ * @param name The name of the span to check.
+ * @returns A boolean indicating whether the span is disabled.
+ */
+function isSpanDisabled(name) {
+    if (disabledSpans.length === 0) {
+        return false;
+    }
+    const result = disabledSpans.includes(name);
+    logger.debug(`Span "${name}" disabled:`, result);
+    return result;
+}
+//# sourceMappingURL=category.js.map

package/dist/cjs/src/observability/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../../../../src/observability/category.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA+DH,wCAQC;AArED,iDAAqG;AACrG,kDAAuD;AAEvD,oDAAgD;AAEhD,MAAM,MAAM,GAAG,IAAA,4BAAiB,EAAC,kBAAkB,CAAC,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE;IAC1B,MAAM,QAAQ,GAAG,IAAA,uBAAU,EAAC,wDAAyC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC3F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ;SAC3B,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAA;IAElB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAS,CAAC,CAAA;IAE3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,MAAM,MAAM,GAAe,EAAE,CAAA;IAC7B,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,6BAAc,CAAC,QAAuC,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,QAAQ,wDAAyC,2BAA2B,MAAM,CAAC,IAAI,CAAC,6BAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnK,SAAQ;QACV,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,SAAQ;YACV,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAErB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;gBACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAA;IAC9C,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAC,EAAE,CAAA;AAEJ;;;;GAIG;AACH,SAAgB,cAAc,CAAE,IAAc;IAC5C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,aAAa,EAAE,MAAM,CAAC,CAAA;IAChD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/cjs/src/observability/constants.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Environment variable or configuration setting name for disabling spans by category in the Agents SDK telemetry. The value should be comma-separated or whitespace-separated list of span categories to disable. See `SpanCategories` for available categories.
+ */
+export declare const AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES = "AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES";
+/**
+ * Categories of spans used for telemetry in the Agents SDK. Spans can be disabled by category using the `AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES` environment variable or configuration setting.
+ */
+export declare const SpanCategories: {
+    readonly STORAGE: readonly ["STORAGE_"];
+    readonly AUTHORIZATION: readonly ["AUTHORIZATION_", "USER_TOKEN_CLIENT_"];
+    readonly AUTHENTICATION: readonly ["AUTHENTICATION_"];
+};
+/**
+ * Span names used for telemetry in the Agents SDK.
+ */
+export declare const SpanNames: {
+    readonly ADAPTER_PROCESS: "agents.adapter.process";
+    readonly ADAPTER_SEND_ACTIVITIES: "agents.adapter.send_activities";
+    readonly ADAPTER_UPDATE_ACTIVITY: "agents.adapter.update_activity";
+    readonly ADAPTER_DELETE_ACTIVITY: "agents.adapter.delete_activity";
+    readonly ADAPTER_CONTINUE_CONVERSATION: "agents.adapter.continue_conversation";
+    readonly ADAPTER_CREATE_CONNECTOR_CLIENT: "agents.adapter.create_connector_client";
+    readonly ADAPTER_CREATE_USER_TOKEN_CLIENT: "agents.adapter.create_user_token_client";
+    readonly AGENTS_APP_RUN: "agents.app.run";
+    readonly AGENTS_APP_ROUTE_HANDLER: "agents.app.route_handler";
+    readonly AGENTS_APP_BEFORE_TURN: "agents.app.before_turn";
+    readonly AGENTS_APP_AFTER_TURN: "agents.app.after_turn";
+    readonly AGENTS_APP_DOWNLOAD_FILES: "agents.app.download_files";
+    readonly CONNECTOR_SEND_TO_CONVERSATION: "agents.connector.send_to_conversation";
+    readonly CONNECTOR_REPLY_TO_ACTIVITY: "agents.connector.reply_to_activity";
+    readonly CONNECTOR_UPDATE_ACTIVITY: "agents.connector.update_activity";
+    readonly CONNECTOR_DELETE_ACTIVITY: "agents.connector.delete_activity";
+    readonly CONNECTOR_CREATE_CONVERSATION: "agents.connector.create_conversation";
+    readonly CONNECTOR_GET_CONVERSATIONS: "agents.connector.get_conversations";
+    readonly CONNECTOR_GET_CONVERSATION_MEMBER: "agents.connector.get_conversation_member";
+    readonly CONNECTOR_UPLOAD_ATTACHMENT: "agents.connector.upload_attachment";
+    readonly CONNECTOR_GET_ATTACHMENT: "agents.connector.get_attachment";
+    readonly CONNECTOR_GET_ATTACHMENT_INFO: "agents.connector.get_attachment_info";
+    readonly STORAGE_READ: "agents.storage.read";
+    readonly STORAGE_WRITE: "agents.storage.write";
+    readonly STORAGE_DELETE: "agents.storage.delete";
+    readonly AGENT_CLIENT_POST_ACTIVITY: "agents.agent_client.post_activity";
+    readonly AUTHENTICATION_GET_ACCESS_TOKEN: "agents.authentication.get_access_token";
+    readonly AUTHENTICATION_ACQUIRE_TOKEN_ON_BEHALF_OF: "agents.authentication.acquire_token_on_behalf_of";
+    readonly AUTHENTICATION_GET_AGENTIC_INSTANCE_TOKEN: "agents.authentication.get_agentic_instance_token";
+    readonly AUTHENTICATION_GET_AGENTIC_USER_TOKEN: "agents.authentication.get_agentic_user_token";
+    readonly AUTHORIZATION_AGENTIC_TOKEN: "agents.authorization.agentic_token";
+    readonly AUTHORIZATION_AZURE_BOT_TOKEN: "agents.authorization.azure_bot_token";
+    readonly AUTHORIZATION_AZURE_BOT_SIGNIN: "agents.authorization.azure_bot_signin";
+    readonly AUTHORIZATION_AZURE_BOT_SIGNOUT: "agents.authorization.azure_bot_signout";
+    readonly USER_TOKEN_CLIENT_GET_USER_TOKEN: "agents.user_token_client.get_user_token";
+    readonly USER_TOKEN_CLIENT_SIGN_OUT: "agents.user_token_client.sign_out";
+    readonly USER_TOKEN_CLIENT_GET_SIGN_IN_RESOURCE: "agents.user_token_client.get_sign_in_resource";
+    readonly USER_TOKEN_CLIENT_EXCHANGE_TOKEN: "agents.user_token_client.exchange_token";
+    readonly USER_TOKEN_CLIENT_GET_TOKEN_OR_SIGN_IN_RESOURCE: "agents.user_token_client.get_token_or_sign_in_resource";
+    readonly USER_TOKEN_CLIENT_GET_TOKEN_STATUS: "agents.user_token_client.get_token_status";
+    readonly USER_TOKEN_CLIENT_GET_AAD_TOKENS: "agents.user_token_client.get_aad_tokens";
+    readonly PROACTIVE_STORE_CONVERSATION: "agents.proactive.store_conversation";
+    readonly PROACTIVE_GET_CONVERSATION: "agents.proactive.get_conversation";
+    readonly PROACTIVE_GET_CONVERSATION_OR_THROW: "agents.proactive.get_conversation_or_throw";
+    readonly PROACTIVE_DELETE_CONVERSATION: "agents.proactive.delete_conversation";
+    readonly PROACTIVE_SEND_ACTIVITY: "agents.proactive.send_activity";
+    readonly PROACTIVE_CONTINUE_CONVERSATION: "agents.proactive.continue_conversation";
+    readonly PROACTIVE_CREATE_CONVERSATION: "agents.proactive.create_conversation";
+    readonly TURN_SEND_ACTIVITIES: "agents.turn.send_activities";
+    readonly COPILOT_START_CONVERSATION: "agents.copilot_client.start_conversation";
+    readonly COPILOT_SEND_ACTIVITY: "agents.copilot_client.send_activity";
+    readonly COPILOT_POST_REQUEST: "agents.copilot_client.post_request";
+    readonly COPILOT_CREATE_CONNECTION: "agents.copilot_client.webchat.create_connection";
+    readonly COPILOT_EXECUTE_STREAMING: "agents.copilot_client.execute_streaming";
+    readonly COPILOT_SUBSCRIBE_ASYNC: "agents.copilot_client.subscribe_async";
+};
+/**
+ * Metric names used for telemetry in the Agents SDK.
+ */
+export declare const MetricNames: {
+    readonly ADAPTER_PROCESS_DURATION: "agents.adapter.process.duration";
+    readonly ACTIVITIES_RECEIVED: "agents.activities.received";
+    readonly ACTIVITIES_SENT: "agents.activities.sent";
+    readonly ACTIVITIES_UPDATED: "agents.activities.updated";
+    readonly ACTIVITIES_DELETED: "agents.activities.deleted";
+    readonly CONNECTOR_REQUESTS: "agents.connector.request.count";
+    readonly CONNECTOR_REQUEST_DURATION: "agents.connector.request.duration";
+    readonly AGENT_CLIENT_REQUESTS: "agents.agent_client.request.count";
+    readonly AGENT_CLIENT_REQUEST_DURATION: "agents.agent_client.request.duration";
+    readonly TURNS_COUNT: "agents.turn.count";
+    readonly TURNS_ERRORS: "agents.turn.error.count";
+    readonly TURN_DURATION: "agents.turn.duration";
+    readonly STORAGE_OPERATION_DURATION: "agents.storage.operation.duration";
+    readonly AUTH_TOKEN_REQUEST_COUNT: "agents.auth.token.request.count";
+    readonly AUTH_TOKEN_DURATION: "agents.auth.token.duration";
+    readonly USER_TOKEN_CLIENT_REQUESTS: "agents.user_token_client.request.count";
+    readonly USER_TOKEN_CLIENT_REQUEST_DURATION: "agents.user_token_client.request.duration";
+    readonly PROACTIVE_OPERATION_COUNT: "agents.proactive.operation.count";
+    readonly PROACTIVE_OPERATION_DURATION: "agents.proactive.operation.duration";
+    readonly CSC_ACTIVITIES_RECEIVED: "agents.copilot_client.activities.received";
+    readonly CSC_ACTIVITIES_SENT: "agents.copilot_client.activities.sent";
+    readonly CSC_CONVERSATIONS_STARTED: "agents.copilot_client.conversations.started";
+    readonly CSC_WEBCHAT_CONNECTIONS: "agents.copilot_client.webchat.connection.count";
+    readonly CSC_REQUEST_COUNT: "agents.copilot_client.request.count";
+    readonly CSC_REQUEST_ERRORS: "agents.copilot_client.request.error.count";
+    readonly CSC_STREAM_DURATION: "agents.copilot_client.stream.duration";
+    readonly CSC_REQUEST_DURATION: "agents.copilot_client.request.duration";
+    readonly CSC_EXECUTE_STREAMING: "agents.copilot_client.execute_streaming.count";
+    readonly CSC_SUBSCRIBE_ASYNC: "agents.copilot_client.subscribe_async.count";
+    readonly CSC_SUBSCRIBE_EVENT: "agents.copilot_client.subscribe_event.count";
+};

package/dist/cjs/src/observability/constants.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricNames = exports.SpanNames = exports.SpanCategories = exports.AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES = void 0;
+/**
+ * Environment variable or configuration setting name for disabling spans by category in the Agents SDK telemetry. The value should be comma-separated or whitespace-separated list of span categories to disable. See `SpanCategories` for available categories.
+ */
+exports.AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES = 'AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES';
+/**
+ * Categories of spans used for telemetry in the Agents SDK. Spans can be disabled by category using the `AGENTS_TELEMETRY_DISABLED_SPAN_CATEGORIES` environment variable or configuration setting.
+ */
+exports.SpanCategories = {
+    STORAGE: ['STORAGE_'],
+    AUTHORIZATION: ['AUTHORIZATION_', 'USER_TOKEN_CLIENT_'],
+    AUTHENTICATION: ['AUTHENTICATION_'],
+};
+/**
+ * Span names used for telemetry in the Agents SDK.
+ */
+exports.SpanNames = {
+    // CloudAdapter / BaseAdapter
+    ADAPTER_PROCESS: 'agents.adapter.process',
+    ADAPTER_SEND_ACTIVITIES: 'agents.adapter.send_activities',
+    ADAPTER_UPDATE_ACTIVITY: 'agents.adapter.update_activity',
+    ADAPTER_DELETE_ACTIVITY: 'agents.adapter.delete_activity',
+    ADAPTER_CONTINUE_CONVERSATION: 'agents.adapter.continue_conversation',
+    ADAPTER_CREATE_CONNECTOR_CLIENT: 'agents.adapter.create_connector_client',
+    ADAPTER_CREATE_USER_TOKEN_CLIENT: 'agents.adapter.create_user_token_client',
+    // AgentApplication
+    AGENTS_APP_RUN: 'agents.app.run',
+    AGENTS_APP_ROUTE_HANDLER: 'agents.app.route_handler',
+    AGENTS_APP_BEFORE_TURN: 'agents.app.before_turn',
+    AGENTS_APP_AFTER_TURN: 'agents.app.after_turn',
+    AGENTS_APP_DOWNLOAD_FILES: 'agents.app.download_files',
+    // ConnectorClient
+    CONNECTOR_SEND_TO_CONVERSATION: 'agents.connector.send_to_conversation',
+    CONNECTOR_REPLY_TO_ACTIVITY: 'agents.connector.reply_to_activity',
+    CONNECTOR_UPDATE_ACTIVITY: 'agents.connector.update_activity',
+    CONNECTOR_DELETE_ACTIVITY: 'agents.connector.delete_activity',
+    CONNECTOR_CREATE_CONVERSATION: 'agents.connector.create_conversation',
+    CONNECTOR_GET_CONVERSATIONS: 'agents.connector.get_conversations',
+    CONNECTOR_GET_CONVERSATION_MEMBER: 'agents.connector.get_conversation_member',
+    CONNECTOR_UPLOAD_ATTACHMENT: 'agents.connector.upload_attachment',
+    CONNECTOR_GET_ATTACHMENT: 'agents.connector.get_attachment',
+    CONNECTOR_GET_ATTACHMENT_INFO: 'agents.connector.get_attachment_info',
+    // Storage
+    STORAGE_READ: 'agents.storage.read',
+    STORAGE_WRITE: 'agents.storage.write',
+    STORAGE_DELETE: 'agents.storage.delete',
+    // AgentClient
+    AGENT_CLIENT_POST_ACTIVITY: 'agents.agent_client.post_activity',
+    // Authentication
+    AUTHENTICATION_GET_ACCESS_TOKEN: 'agents.authentication.get_access_token',
+    AUTHENTICATION_ACQUIRE_TOKEN_ON_BEHALF_OF: 'agents.authentication.acquire_token_on_behalf_of',
+    AUTHENTICATION_GET_AGENTIC_INSTANCE_TOKEN: 'agents.authentication.get_agentic_instance_token',
+    AUTHENTICATION_GET_AGENTIC_USER_TOKEN: 'agents.authentication.get_agentic_user_token',
+    // Authorization
+    AUTHORIZATION_AGENTIC_TOKEN: 'agents.authorization.agentic_token',
+    AUTHORIZATION_AZURE_BOT_TOKEN: 'agents.authorization.azure_bot_token',
+    AUTHORIZATION_AZURE_BOT_SIGNIN: 'agents.authorization.azure_bot_signin',
+    AUTHORIZATION_AZURE_BOT_SIGNOUT: 'agents.authorization.azure_bot_signout',
+    // UserTokenClient
+    USER_TOKEN_CLIENT_GET_USER_TOKEN: 'agents.user_token_client.get_user_token',
+    USER_TOKEN_CLIENT_SIGN_OUT: 'agents.user_token_client.sign_out',
+    USER_TOKEN_CLIENT_GET_SIGN_IN_RESOURCE: 'agents.user_token_client.get_sign_in_resource',
+    USER_TOKEN_CLIENT_EXCHANGE_TOKEN: 'agents.user_token_client.exchange_token',
+    USER_TOKEN_CLIENT_GET_TOKEN_OR_SIGN_IN_RESOURCE: 'agents.user_token_client.get_token_or_sign_in_resource',
+    USER_TOKEN_CLIENT_GET_TOKEN_STATUS: 'agents.user_token_client.get_token_status',
+    USER_TOKEN_CLIENT_GET_AAD_TOKENS: 'agents.user_token_client.get_aad_tokens',
+    // Proactive
+    PROACTIVE_STORE_CONVERSATION: 'agents.proactive.store_conversation',
+    PROACTIVE_GET_CONVERSATION: 'agents.proactive.get_conversation',
+    PROACTIVE_GET_CONVERSATION_OR_THROW: 'agents.proactive.get_conversation_or_throw',
+    PROACTIVE_DELETE_CONVERSATION: 'agents.proactive.delete_conversation',
+    PROACTIVE_SEND_ACTIVITY: 'agents.proactive.send_activity',
+    PROACTIVE_CONTINUE_CONVERSATION: 'agents.proactive.continue_conversation',
+    PROACTIVE_CREATE_CONVERSATION: 'agents.proactive.create_conversation',
+    // TurnContext
+    TURN_SEND_ACTIVITIES: 'agents.turn.send_activities',
+    // Copilot Studio Client
+    COPILOT_START_CONVERSATION: 'agents.copilot_client.start_conversation',
+    COPILOT_SEND_ACTIVITY: 'agents.copilot_client.send_activity',
+    COPILOT_POST_REQUEST: 'agents.copilot_client.post_request',
+    COPILOT_CREATE_CONNECTION: 'agents.copilot_client.webchat.create_connection',
+    COPILOT_EXECUTE_STREAMING: 'agents.copilot_client.execute_streaming',
+    COPILOT_SUBSCRIBE_ASYNC: 'agents.copilot_client.subscribe_async',
+};
+/**
+ * Metric names used for telemetry in the Agents SDK.
+ */
+exports.MetricNames = {
+    // CloudAdapter
+    ADAPTER_PROCESS_DURATION: 'agents.adapter.process.duration',
+    // Hosting activity counters
+    ACTIVITIES_RECEIVED: 'agents.activities.received',
+    ACTIVITIES_SENT: 'agents.activities.sent',
+    ACTIVITIES_UPDATED: 'agents.activities.updated',
+    ACTIVITIES_DELETED: 'agents.activities.deleted',
+    // Connector metrics
+    CONNECTOR_REQUESTS: 'agents.connector.request.count',
+    CONNECTOR_REQUEST_DURATION: 'agents.connector.request.duration',
+    // AgentClient metrics
+    AGENT_CLIENT_REQUESTS: 'agents.agent_client.request.count',
+    AGENT_CLIENT_REQUEST_DURATION: 'agents.agent_client.request.duration',
+    // Turn metrics
+    TURNS_COUNT: 'agents.turn.count',
+    TURNS_ERRORS: 'agents.turn.error.count',
+    TURN_DURATION: 'agents.turn.duration',
+    // Storage metrics
+    STORAGE_OPERATION_DURATION: 'agents.storage.operation.duration',
+    // Authentication metrics
+    AUTH_TOKEN_REQUEST_COUNT: 'agents.auth.token.request.count',
+    AUTH_TOKEN_DURATION: 'agents.auth.token.duration',
+    // UserTokenClient metrics
+    USER_TOKEN_CLIENT_REQUESTS: 'agents.user_token_client.request.count',
+    USER_TOKEN_CLIENT_REQUEST_DURATION: 'agents.user_token_client.request.duration',
+    // Proactive
+    PROACTIVE_OPERATION_COUNT: 'agents.proactive.operation.count',
+    PROACTIVE_OPERATION_DURATION: 'agents.proactive.operation.duration',
+    // Copilot Studio Client
+    CSC_ACTIVITIES_RECEIVED: 'agents.copilot_client.activities.received',
+    CSC_ACTIVITIES_SENT: 'agents.copilot_client.activities.sent',
+    CSC_CONVERSATIONS_STARTED: 'agents.copilot_client.conversations.started',
+    CSC_WEBCHAT_CONNECTIONS: 'agents.copilot_client.webchat.connection.count',
+    CSC_REQUEST_COUNT: 'agents.copilot_client.request.count',
+    CSC_REQUEST_ERRORS: 'agents.copilot_client.request.error.count',
+    CSC_STREAM_DURATION: 'agents.copilot_client.stream.duration',
+    CSC_REQUEST_DURATION: 'agents.copilot_client.request.duration',
+    CSC_EXECUTE_STREAMING: 'agents.copilot_client.execute_streaming.count',
+    CSC_SUBSCRIBE_ASYNC: 'agents.copilot_client.subscribe_async.count',
+    CSC_SUBSCRIBE_EVENT: 'agents.copilot_client.subscribe_event.count',
+};
+//# sourceMappingURL=constants.js.map

package/dist/cjs/src/observability/constants.js.map

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

package/dist/cjs/src/observability/metric.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { Metric, OTel } from '../types.js';
+/**
+ * Creates metric helpers backed by the package meter.
+ */
+export declare function metricFactory(otel: OTel): Metric;

package/dist/cjs/src/observability/metric.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricFactory = metricFactory;
+/**
+ * Creates metric helpers backed by the package meter.
+ */
+function metricFactory(otel) {
+    const meter = otel.metrics.getMeter('@microsoft/agents-telemetry');
+    return {
+        histogram: meter.createHistogram.bind(meter),
+        counter: meter.createCounter.bind(meter),
+    };
+}
+//# sourceMappingURL=metric.js.map

package/dist/cjs/src/observability/metric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric.js","sourceRoot":"","sources":["../../../../src/observability/metric.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,sCAMC;AATD;;GAEG;AACH,SAAgB,aAAa,CAAE,IAAU;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAA;IAClE,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5C,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;KACzC,CAAA;AACH,CAAC"}

package/dist/cjs/src/observability/trace.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { OTel, TraceFunction } from '../types.js';
+/**
+ * Creates the trace helper bound to the package tracer.
+ *
+ * @remarks
+ * - Only span names declared in `SpanNames` are accepted.
+ * - Disabled span categories return a no-op context instead of creating a real span.
+ */
+export declare function traceFactory(otel: OTel): TraceFunction;