@microsoft/agents-hosting 1.6.0-beta.9.gce9d8facd2 → 1.7.0-beta.1.g8bcd4f11a7

package/dist/src/getProductInfo.js

@@ -1,17 +1,87 @@
 "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.getProductInfo = void 0;
+exports.applyUserAgentHeader = applyUserAgentHeader;
+exports.applyAgenticHeaders = applyAgenticHeaders;
 const package_json_1 = require("../package.json");
 const os_1 = __importDefault(require("os"));
+const agents_activity_1 = require("@microsoft/agents-activity");
+const errorHelper_1 = require("./errorHelper");
+const AGENT_NAME_PATTERN = /^[A-Za-z0-9 _-]+$/;
+const AGENT_REGISTRAR = 'A365';
+const DEFAULT_AGENT_NAME = 'Agents-SDK-JS';
 /**
  * Generates a string containing information about the SDK version and runtime environment.
  * This is used for telemetry and User-Agent headers in HTTP requests.
  *
  * @returns A formatted string containing the SDK version, Node.js version, and OS details
  */
-const getProductInfo = () => `agents-sdk-js/${package_json_1.version} nodejs/${process.version} ${os_1.default.platform()}-${os_1.default.arch()}/${os_1.default.release()}`;
+const getProductInfo = () => `${DEFAULT_AGENT_NAME.toLowerCase()}/${package_json_1.version} nodejs/${process.version} ${os_1.default.platform()}-${os_1.default.arch()}/${os_1.default.release()}`;
 exports.getProductInfo = getProductInfo;
+/**
+ * Applies the SDK product information to the User-Agent header of outgoing requests.
+ * @param headers The HeaderPropagationCollection to which the User-Agent header will be added or updated
+ */
+function applyUserAgentHeader(headers) {
+    var _a, _b, _c;
+    const userAgentKey = (_b = (_a = headers.key) === null || _a === void 0 ? void 0 : _a.call(headers, 'User-Agent')) !== null && _b !== void 0 ? _b : 'User-Agent';
+    const userAgent = (_c = headers.outgoing[userAgentKey]) !== null && _c !== void 0 ? _c : headers.incoming[userAgentKey];
+    const productInfo = (0, exports.getProductInfo)();
+    if (!userAgent) {
+        headers.add({ [userAgentKey]: productInfo });
+    }
+    else if (!userAgent.includes(productInfo)) {
+        headers.concat({ [userAgentKey]: productInfo });
+    }
+    else {
+        headers.propagate([userAgentKey]);
+    }
+}
+/**
+ * Applies standardized agent-related headers for agentic requests.
+ *
+ * @param headers The HeaderPropagationCollection to which the agent headers will be applied.
+ * @param activity The incoming Activity containing agentic request information.
+ * @param agentName An optional human-friendly name for the agent, which will be validated and included in the headers.
+ *
+ * @remarks
+ * The function sets the following headers:
+ * - `AgentRegistrar`: A fixed value indicating the registrar of the agent (e.g., "A365").
+ * - `AgentName`: A human-friendly name for the agent, validated against a pattern to ensure it only contains allowed characters.
+ * - `AgentID`: A unique identifier for the agent instance, resolved from the activity's agentic instance ID or agentic user.
+ * - `Agent-Referrer`: The channel ID from the incoming activity, indicating the source of the request.
+ * The function ensures that the agent headers are consistently applied to outgoing requests for proper identification and tracing.
+ */
+function applyAgenticHeaders(headers, activity, agentName) {
+    var _a;
+    headers.override({
+        AgentRegistrar: AGENT_REGISTRAR,
+        AgentName: normalizeAgentName(agentName),
+        AgentID: resolveAgentId(activity),
+        'Agent-Referrer': (_a = activity.channelId) !== null && _a !== void 0 ? _a : '',
+    });
+}
+function resolveAgentId(activity) {
+    var _a;
+    const agentId = (_a = activity.getAgenticInstanceId()) !== null && _a !== void 0 ? _a : activity.getAgenticUser();
+    if (!agentId) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.AgentIdRequired);
+    }
+    return agentId;
+}
+function normalizeAgentName(agentName) {
+    const normalizedAgentName = agentName === null || agentName === void 0 ? void 0 : agentName.trim();
+    if (!normalizedAgentName) {
+        return DEFAULT_AGENT_NAME;
+    }
+    if (!AGENT_NAME_PATTERN.test(normalizedAgentName)) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.AgentNameInvalid, undefined, { agentName: normalizedAgentName });
+    }
+    return normalizedAgentName;
+}
 //# sourceMappingURL=getProductInfo.js.map

package/dist/src/getProductInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"getProductInfo.js","sourceRoot":"","sources":["../../src/getProductInfo.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyC;AACzC,4CAAmB;AAEnB;;;;;GAKG;AACI,MAAM,cAAc,GAAG,GAAY,EAAE,CAAC,iBAAiB,sBAAO,WAAW,OAAO,CAAC,OAAO,IAAI,YAAE,CAAC,QAAQ,EAAE,IAAI,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,EAAE,CAAA;AAAlI,QAAA,cAAc,kBAAoH"}
+{"version":3,"file":"getProductInfo.js","sourceRoot":"","sources":["../../src/getProductInfo.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;AAwBlC,oDAWC;AAiBD,kDAWC;AA7DD,kDAAyC;AACzC,4CAAmB;AACnB,gEAAsE;AACtE,+CAAsC;AAGtC,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAC9C,MAAM,eAAe,GAAG,MAAM,CAAA;AAC9B,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAE1C;;;;;GAKG;AACI,MAAM,cAAc,GAAG,GAAY,EAAE,CAAC,GAAG,kBAAkB,CAAC,WAAW,EAAE,IAAI,sBAAO,WAAW,OAAO,CAAC,OAAO,IAAI,YAAE,CAAC,QAAQ,EAAE,IAAI,YAAE,CAAC,IAAI,EAAE,IAAI,YAAE,CAAC,OAAO,EAAE,EAAE,CAAA;AAAxJ,QAAA,cAAc,kBAA0I;AAErK;;;GAGG;AACH,SAAgB,oBAAoB,CAAE,OAAoC;;IACxE,MAAM,YAAY,GAAG,MAAA,MAAA,OAAO,CAAC,GAAG,wDAAG,YAAY,CAAC,mCAAI,YAAY,CAAA;IAChE,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,mCAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IAClF,MAAM,WAAW,GAAG,IAAA,sBAAc,GAAE,CAAA;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;IAC9C,CAAC;SAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IACnC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,mBAAmB,CACjC,OAAoC,EACpC,QAAkB,EAClB,SAAkB;;IAElB,OAAO,CAAC,QAAQ,CAAC;QACf,cAAc,EAAE,eAAe;QAC/B,SAAS,EAAE,kBAAkB,CAAC,SAAS,CAAC;QACxC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC;QACjC,gBAAgB,EAAE,MAAA,QAAQ,CAAC,SAAS,mCAAI,EAAE;KAC3C,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,cAAc,CAAE,QAAkB;;IACzC,MAAM,OAAO,GAAG,MAAA,QAAQ,CAAC,oBAAoB,EAAE,mCAAI,QAAQ,CAAC,cAAc,EAAE,CAAA;IAE5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,iCAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,oBAAM,CAAC,eAAe,CAAC,CAAA;IACxE,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAE,SAAkB;IAC7C,MAAM,mBAAmB,GAAG,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,EAAE,CAAA;IAC7C,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClD,MAAM,iCAAe,CAAC,iBAAiB,CAAC,KAAK,EAAE,oBAAM,CAAC,gBAAgB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACxH,CAAC;IAED,OAAO,mBAAmB,CAAA;AAC5B,CAAC"}

package/dist/src/headerPropagation.d.ts

@@ -7,9 +7,10 @@
  * It filters the incoming request headers based on the definition provided and loads them into the outgoing headers collection.
  */
 export declare class HeaderPropagation implements HeaderPropagationCollection {
+    private _keys;
     private _incomingRequests;
     private _outgoingHeaders;
-    private _headersToPropagate;
+    private _protectedHeaders;
     get incoming(): Record<string, string>;
     get outgoing(): Record<string, string>;
     constructor(headers: Record<string, string | string[] | undefined>);
@@ -17,8 +18,15 @@ export declare class HeaderPropagation implements HeaderPropagationCollection {
     add(headers: Record<string, string>): void;
     concat(headers: Record<string, string>): void;
     override(headers: Record<string, string>): void;
+    key(key: string): string | undefined;
     /**
-     * Normalizes the headers by lowercasing the keys and ensuring the values are strings.
+     * A helper method to process headers based on a provided callback function. It iterates over the headers and applies the callback to each header key and value.
+     * @param headers An array of header key-value pairs to process.
+     * @param callback A function that takes a header key and value, allowing for custom processing logic to be applied to each header.
+     */
+    private process;
+    /**
+     * Normalizes the headers by ensuring the values are strings.
      * @param headers The headers to normalize.
      * @returns A new object with normalized headers.
      */
@@ -80,4 +88,11 @@ export interface HeaderPropagationCollection {
      * If the header does not exist in the incoming headers, it will be added to the outgoing collection.
      */
     override(headers: Record<string, string>): void;
+    /**
+     * Resolves the actual header key in a case-insensitive manner.
+     * This is useful for ensuring that headers are accessed correctly regardless of their case in the incoming request.
+     * @param key The header key to resolve.
+     * @returns The resolved header key or undefined if not found.
+     */
+    key?(key: string): string | undefined;
 }

package/dist/src/headerPropagation.js

@@ -17,56 +17,78 @@ class HeaderPropagation {
         return this._outgoingHeaders;
     }
     constructor(headers) {
+        this._keys = [];
         this._outgoingHeaders = {};
-        this._headersToPropagate = ['x-ms-correlation-id'];
+        this._protectedHeaders = ['x-ms-correlation-id'];
         if (!headers) {
             throw new Error('Headers must be provided.');
         }
         this._incomingRequests = this.normalizeHeaders(headers);
-        this.propagate(this._headersToPropagate);
+        // Ensure protected headers are propagated from incoming to outgoing by default without allowing modifications.
+        const protectedHeaders = [...this._protectedHeaders];
+        this._protectedHeaders = []; // Temporarily clear protected headers to allow propagation without restriction
+        this.propagate(protectedHeaders);
+        this._protectedHeaders = protectedHeaders; // Restore protected headers list after propagation
     }
     propagate(headers) {
-        for (const key of headers !== null && headers !== void 0 ? headers : []) {
-            const lowerKey = key.toLowerCase();
-            if (this._incomingRequests[lowerKey] && !this._outgoingHeaders[lowerKey]) {
-                this._outgoingHeaders[lowerKey] = this._incomingRequests[lowerKey];
+        this.process(headers.map(h => [h, '']), key => {
+            if (this._incomingRequests[key] && !this._outgoingHeaders[key]) {
+                this._outgoingHeaders[key] = this._incomingRequests[key];
             }
-        }
+        });
     }
     add(headers) {
-        for (const [key, value] of Object.entries(headers !== null && headers !== void 0 ? headers : {})) {
-            const lowerKey = key.toLowerCase();
-            if (!this._incomingRequests[lowerKey] && !this._outgoingHeaders[lowerKey]) {
-                this._outgoingHeaders[lowerKey] = value;
+        this.process(Object.entries(headers !== null && headers !== void 0 ? headers : {}), (key, value) => {
+            if (!this._incomingRequests[key] && !this._outgoingHeaders[key]) {
+                this._outgoingHeaders[key] = value;
             }
-        }
+        });
     }
     concat(headers) {
-        var _a;
-        for (const [key, value] of Object.entries(headers !== null && headers !== void 0 ? headers : {})) {
-            const lowerKey = key.toLowerCase();
-            if (this._incomingRequests[lowerKey] && !this._headersToPropagate.includes(lowerKey)) {
-                this._outgoingHeaders[lowerKey] = `${(_a = this._outgoingHeaders[lowerKey]) !== null && _a !== void 0 ? _a : this._incomingRequests[lowerKey]} ${value}`.trim();
+        this.process(Object.entries(headers !== null && headers !== void 0 ? headers : {}), (key, value) => {
+            var _a;
+            if (this._incomingRequests[key] || this._outgoingHeaders[key]) {
+                this._outgoingHeaders[key] = `${(_a = this._outgoingHeaders[key]) !== null && _a !== void 0 ? _a : this._incomingRequests[key]} ${value}`.trim();
             }
-        }
+        });
     }
     override(headers) {
-        for (const [key, value] of Object.entries(headers !== null && headers !== void 0 ? headers : {})) {
-            const lowerKey = key.toLowerCase();
-            if (!this._headersToPropagate.includes(lowerKey)) {
-                this._outgoingHeaders[lowerKey] = value;
+        this.process(Object.entries(headers !== null && headers !== void 0 ? headers : {}), (key, value) => {
+            this._outgoingHeaders[key] = value;
+        });
+    }
+    key(key) {
+        return this._keys.find(k => k.toLowerCase() === key.toLowerCase());
+    }
+    /**
+     * A helper method to process headers based on a provided callback function. It iterates over the headers and applies the callback to each header key and value.
+     * @param headers An array of header key-value pairs to process.
+     * @param callback A function that takes a header key and value, allowing for custom processing logic to be applied to each header.
+     */
+    process(headers, callback) {
+        for (const [key, value] of headers) {
+            const savedKey = this.key(key);
+            const realKey = savedKey !== null && savedKey !== void 0 ? savedKey : key;
+            if (!savedKey) {
+                this._keys.push(realKey);
+            }
+            if (!this._protectedHeaders.includes(key.toLowerCase())) {
+                callback(realKey, value);
             }
         }
     }
     /**
-     * Normalizes the headers by lowercasing the keys and ensuring the values are strings.
+     * Normalizes the headers by ensuring the values are strings.
      * @param headers The headers to normalize.
      * @returns A new object with normalized headers.
      */
     normalizeHeaders(headers) {
         return Object.entries(headers).reduce((acc, [key, value]) => {
             if (value) {
-                acc[key.toLowerCase()] = Array.isArray(value) ? value.join(' ') : value;
+                acc[key] = Array.isArray(value) ? value.join(' ') : value;
+                if (!this._keys.includes(key)) {
+                    this._keys.push(key); // Store the original casing of the header keys
+                }
             }
             return acc;
         }, {});

package/dist/src/headerPropagation.js.map

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

package/dist/src/httpClient.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Configuration for an HTTP request.
+ */
+export interface HttpRequestConfig {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    data?: unknown;
+    params?: Record<string, string | undefined>;
+    responseType?: 'json' | 'arraybuffer' | 'stream';
+    timeout?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Represents an HTTP response.
+ */
+export interface HttpResponse<T = unknown> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    config: HttpRequestConfig;
+}
+/**
+ * Options for creating an HttpClient instance.
+ */
+export interface HttpClientOptions {
+    baseURL?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * A lightweight HTTP client built on native fetch.
+ */
+export declare class HttpClient {
+    private _baseURL;
+    private _defaultHeaders;
+    constructor(options?: HttpClientOptions);
+    get baseURL(): string;
+    get defaultHeaders(): Record<string, string>;
+    set defaultHeaders(headers: Record<string, string>);
+    setHeader(name: string, value: string): void;
+    request<T = unknown>(config: HttpRequestConfig): Promise<HttpResponse<T>>;
+    get<T = unknown>(url: string, options?: Partial<HttpRequestConfig>): Promise<HttpResponse<T>>;
+    private buildUrl;
+    private normalizeHeaders;
+}
+/**
+ * Error thrown when an HTTP request fails.
+ */
+export declare class HttpError extends Error {
+    readonly response: HttpResponse;
+    readonly config: HttpRequestConfig;
+    readonly status: number;
+    constructor(message: string, response: HttpResponse, config: HttpRequestConfig);
+    toJSON(): Record<string, unknown>;
+}

package/dist/src/httpClient.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.HttpClient = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const node_stream_1 = require("node:stream");
+const errorHelper_1 = require("./errorHelper");
+/**
+ * A lightweight HTTP client built on native fetch.
+ */
+class HttpClient {
+    constructor(options = {}) {
+        var _a;
+        this._baseURL = (_a = options.baseURL) !== null && _a !== void 0 ? _a : '';
+        this._defaultHeaders = this.normalizeHeaders(options.headers);
+    }
+    get baseURL() {
+        return this._baseURL;
+    }
+    get defaultHeaders() {
+        return this._defaultHeaders;
+    }
+    set defaultHeaders(headers) {
+        this._defaultHeaders = this.normalizeHeaders(headers);
+    }
+    setHeader(name, value) {
+        this._defaultHeaders[name.toLowerCase()] = value;
+    }
+    async request(config) {
+        var _a, _b, _c;
+        const url = this.buildUrl(config.url, config.params);
+        const headers = this.normalizeHeaders({ ...this._defaultHeaders, ...config.headers });
+        const requestHeaders = new Headers(headers);
+        const fetchOptions = {
+            method: config.method.toUpperCase(),
+            headers: requestHeaders,
+            signal: (_a = config.signal) !== null && _a !== void 0 ? _a : (config.timeout ? AbortSignal.timeout(config.timeout) : undefined)
+        };
+        if (config.data !== undefined && config.data !== null) {
+            const contentType = (_b = requestHeaders.get('content-type')) !== null && _b !== void 0 ? _b : '';
+            if (contentType.includes('application/x-www-form-urlencoded')) {
+                fetchOptions.body = new URLSearchParams(config.data).toString();
+            }
+            else if (config.data instanceof URLSearchParams) {
+                if (!contentType) {
+                    requestHeaders.set('content-type', 'application/x-www-form-urlencoded;charset=utf-8');
+                }
+                fetchOptions.body = config.data.toString();
+            }
+            else if (typeof config.data === 'string') {
+                fetchOptions.body = config.data;
+            }
+            else if (config.data instanceof Uint8Array || config.data instanceof ArrayBuffer ||
+                config.data instanceof Blob || config.data instanceof FormData ||
+                config.data instanceof ReadableStream) {
+                fetchOptions.body = config.data;
+            }
+            else {
+                if (!contentType) {
+                    requestHeaders.set('content-type', 'application/json');
+                }
+                fetchOptions.body = JSON.stringify(config.data);
+            }
+        }
+        const response = await fetch(url, fetchOptions);
+        let data;
+        if (config.responseType === 'stream') {
+            if (!response.ok) {
+                data = await response.text();
+            }
+            else {
+                data = node_stream_1.Readable.fromWeb((_c = response.body) !== null && _c !== void 0 ? _c : new ReadableStream());
+            }
+        }
+        else if (config.responseType === 'arraybuffer') {
+            data = await response.arrayBuffer();
+        }
+        else {
+            const text = await response.text();
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+        }
+        const httpResponse = {
+            data,
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers,
+            config,
+        };
+        if (!response.ok) {
+            const error = new HttpError(`Request failed with status ${response.status}`, httpResponse, config);
+            throw error;
+        }
+        return httpResponse;
+    }
+    async get(url, options) {
+        return this.request({ method: 'get', url, ...options });
+    }
+    buildUrl(path, params) {
+        let url;
+        if (path.startsWith('http://') || path.startsWith('https://')) {
+            url = path;
+        }
+        else {
+            if (!this._baseURL) {
+                throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.HttpClientRelativeUrlRequiresBaseUrl, undefined, { url: path });
+            }
+            const base = this._baseURL.endsWith('/') ? this._baseURL.slice(0, -1) : this._baseURL;
+            const cleanPath = path.startsWith('/') ? path : `/${path}`;
+            url = `${base}${cleanPath}`;
+        }
+        if (params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    searchParams.set(key, value);
+                }
+            }
+            const queryString = searchParams.toString();
+            if (queryString) {
+                url += `${url.includes('?') ? '&' : '?'}${queryString}`;
+            }
+        }
+        return url;
+    }
+    normalizeHeaders(headers) {
+        if (!headers) {
+            return {};
+        }
+        return Object.entries(headers).reduce((normalized, [name, value]) => {
+            normalized[name.toLowerCase()] = value;
+            return normalized;
+        }, {});
+    }
+}
+exports.HttpClient = HttpClient;
+/**
+ * Error thrown when an HTTP request fails.
+ */
+class HttpError extends Error {
+    constructor(message, response, config) {
+        super(message);
+        this.name = 'HttpError';
+        this.response = response;
+        this.config = config;
+        this.status = response.status;
+    }
+    toJSON() {
+        return {
+            message: this.message,
+            status: this.status,
+            config: {
+                url: this.config.url,
+                method: this.config.method,
+                data: this.config.data,
+            },
+            response: {
+                status: this.response.status,
+                statusText: this.response.statusText,
+                data: this.response.data,
+            },
+        };
+    }
+}
+exports.HttpError = HttpError;
+//# sourceMappingURL=httpClient.js.map

package/dist/src/httpClient.js.map

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

package/dist/src/index.d.ts

@@ -3,7 +3,7 @@
  * Licensed under the MIT License.
  */
 export * from './auth/';
-export { authorizeJWT, buildJwksUri } from './auth/jwt-middleware';
+export { authorizeJWT, buildJwksUri, clearJwksClients } from './auth/jwt-middleware';
 export * from './app';
 export * from './cards';
 export * from './connector-client';
@@ -15,7 +15,7 @@ export * from './storage';
 export * from './transcript';
 export * from './activityHandler';
 export * from './baseAdapter';
-export * from './cloudAdapter';
+export { CloudAdapter, type CloudAdapterOptions } from './cloudAdapter';
 export * from './middlewareSet';
 export * from './messageFactory';
 export * from './statusCodes';
@@ -23,4 +23,5 @@ export * from './turnContext';
 export * from './turnContextStateCollection';
 export * from './storage/storage';
 export * from './headerPropagation';
+export * from './httpClient';
 export * from './agent-client';

package/dist/src/index.js

@@ -18,11 +18,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HostingErrors = exports.buildJwksUri = exports.authorizeJWT = void 0;
+exports.CloudAdapter = exports.HostingErrors = exports.clearJwksClients = exports.buildJwksUri = exports.authorizeJWT = void 0;
 __exportStar(require("./auth/"), exports);
 var jwt_middleware_1 = require("./auth/jwt-middleware");
 Object.defineProperty(exports, "authorizeJWT", { enumerable: true, get: function () { return jwt_middleware_1.authorizeJWT; } });
 Object.defineProperty(exports, "buildJwksUri", { enumerable: true, get: function () { return jwt_middleware_1.buildJwksUri; } });
+Object.defineProperty(exports, "clearJwksClients", { enumerable: true, get: function () { return jwt_middleware_1.clearJwksClients; } });
 __exportStar(require("./app"), exports);
 __exportStar(require("./cards"), exports);
 __exportStar(require("./connector-client"), exports);
@@ -35,7 +36,11 @@ __exportStar(require("./storage"), exports);
 __exportStar(require("./transcript"), exports);
 __exportStar(require("./activityHandler"), exports);
 __exportStar(require("./baseAdapter"), exports);
-__exportStar(require("./cloudAdapter"), exports);
+// Note: re-export the public surface of `cloudAdapter` explicitly so the
+// test-only internals (e.g., the per-process warning dedup set) do not leak
+// into the package's public API.
+var cloudAdapter_1 = require("./cloudAdapter");
+Object.defineProperty(exports, "CloudAdapter", { enumerable: true, get: function () { return cloudAdapter_1.CloudAdapter; } });
 __exportStar(require("./middlewareSet"), exports);
 __exportStar(require("./messageFactory"), exports);
 __exportStar(require("./statusCodes"), exports);
@@ -43,5 +48,6 @@ __exportStar(require("./turnContext"), exports);
 __exportStar(require("./turnContextStateCollection"), exports);
 __exportStar(require("./storage/storage"), exports);
 __exportStar(require("./headerPropagation"), exports);
+__exportStar(require("./httpClient"), exports);
 __exportStar(require("./agent-client"), exports);
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,0CAAuB;AACvB,wDAAkE;AAAzD,8GAAA,YAAY,OAAA;AAAE,8GAAA,YAAY,OAAA;AAEnC,wCAAqB;AACrB,0CAAuB;AACvB,qDAAkC;AAClC,6CAAuD;AAA9C,4GAAA,MAAM,OAAiB;AAChC,2CAAwB;AACxB,0CAAuB;AACvB,0CAAuB;AACvB,4CAAyB;AACzB,+CAA4B;AAE5B,oDAAiC;AACjC,gDAA6B;AAC7B,iDAA8B;AAC9B,kDAA+B;AAC/B,mDAAgC;AAChC,gDAA6B;AAC7B,gDAA6B;AAC7B,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC;AAEnC,iDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,0CAAuB;AACvB,wDAAoF;AAA3E,8GAAA,YAAY,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,kHAAA,gBAAgB,OAAA;AAErD,wCAAqB;AACrB,0CAAuB;AACvB,qDAAkC;AAClC,6CAAuD;AAA9C,4GAAA,MAAM,OAAiB;AAChC,2CAAwB;AACxB,0CAAuB;AACvB,0CAAuB;AACvB,4CAAyB;AACzB,+CAA4B;AAE5B,oDAAiC;AACjC,gDAA6B;AAC7B,yEAAyE;AACzE,4EAA4E;AAC5E,iCAAiC;AACjC,+CAAuE;AAA9D,4GAAA,YAAY,OAAA;AACrB,kDAA+B;AAC/B,mDAAgC;AAChC,gDAA6B;AAC7B,gDAA6B;AAC7B,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC;AACnC,+CAA4B;AAE5B,iDAA8B"}

package/dist/src/oauth/userTokenClient.d.ts

@@ -1,4 +1,4 @@
-import { AxiosInstance } from 'axios';
+import { HttpClient } from '../httpClient';
 import { ConversationReference } from '@microsoft/agents-activity';
 import { AadResourceUrls, SignInResource, TokenExchangeRequest, TokenOrSinginResourceResponse, TokenResponse, TokenStatus } from './userTokenClient.types';
 import { AuthProvider } from '../auth';
@@ -7,8 +7,12 @@ import { HeaderPropagationCollection } from '../headerPropagation';
  * Client for managing user tokens.
  */
 export declare class UserTokenClient {
-    client: AxiosInstance;
+    client: HttpClient;
     private msAppId;
+    private authProvider?;
+    private authScope?;
+    private authInitialized;
+    private authInitialization?;
     /**
      * Creates a new instance of UserTokenClient.
      * @param msAppId The Microsoft application ID.
@@ -16,9 +20,16 @@ export declare class UserTokenClient {
     constructor(msAppId: string);
     /**
      * Creates a new instance of UserTokenClient.
-     * @param axiosInstance The axios instance.
+     * @param httpClient The HttpClient instance.
      */
-    constructor(axiosInstance: AxiosInstance);
+    constructor(httpClient: HttpClient);
+    /**
+     * Creates a new instance of UserTokenClient with lazy authentication.
+     * @param httpClient The HttpClient instance.
+     * @param authProvider The authentication provider.
+     * @param authScope The authentication scope.
+     */
+    constructor(httpClient: HttpClient, authProvider?: AuthProvider, authScope?: string);
     /**
      * Creates a new instance of UserTokenClient with authentication.
      * @param baseURL - The base URL for the API.
@@ -95,4 +106,6 @@ export declare class UserTokenClient {
      */
     getAadTokens(userId: string, connectionName: string, channelIdComposite: string, resourceUrls: AadResourceUrls): Promise<Record<string, TokenResponse>>;
     updateAuthToken(token: string): void;
+    private executeRequest;
+    private ensureAuthorizationHeader;
 }