@microsoft/agents-hosting 1.9.0-beta.3.gb2d23c1c44 → 1.9.1

package/dist/src/storage/storage.d.ts

@@ -57,7 +57,7 @@ export interface StoreItems {
  */
 export type StorageKeyFactory = (context: TurnContext) => string | Promise<string>;
 /**
- * Defines the interface for storage operations in the Agents platform.
+ * Defines the version 1 interface for storage operations in the Agents platform.
  *
  * @remarks
  * Storage providers persist state data across conversation turns, enabling
@@ -66,7 +66,9 @@ export type StorageKeyFactory = (context: TurnContext) => string | Promise<strin
  *
  * The interface is designed to be simple with just three core operations:
  * read, write, and delete. All operations are asynchronous to support both
- * in-memory and remote storage providers.
+ * in-memory and remote storage providers. New implementations should use
+ * {@link StorageV2}; this V1 interface remains supported by
+ * {@link StorageProvider} through a compatibility adapter.
  */
 export interface Storage {
     /**
@@ -93,3 +95,99 @@ export interface Storage {
      */
     delete: (keys: string[]) => Promise<void>;
 }
+/**
+ * The result of a version 2 storage read operation.
+ *
+ * A result is returned for every requested key. `value` and `version` are
+ * available when `status` is {@link StorageOperationStatus.Succeeded}.
+ */
+export interface StorageReadResult<T extends object = Record<string, unknown>> {
+    key: string;
+    status: StorageOperationStatus;
+    value?: T;
+    version?: string;
+}
+/**
+ * The result of a version 2 storage write operation.
+ */
+export interface StorageWriteResult {
+    key: string;
+    status: StorageOperationStatus;
+    version?: string;
+}
+/**
+ * The result of a version 2 storage delete operation.
+ */
+export interface StorageDeleteResult {
+    key: string;
+    status: StorageOperationStatus;
+    version?: string;
+}
+/** A keyed set of storage read results. */
+export type StorageReadResults<T extends object = Record<string, unknown>> = Record<string, StorageReadResult<T>>;
+/** A keyed set of storage write results. */
+export type StorageWriteResults = Record<string, StorageWriteResult>;
+/** A keyed set of storage delete results. */
+export type StorageDeleteResults = Record<string, StorageDeleteResult>;
+/** The outcome of one version 2 storage operation. */
+export declare enum StorageOperationStatus {
+    Succeeded = "succeeded",
+    NotFound = "notFound",
+    Conflict = "conflict",
+    ConditionNotMet = "conditionNotMet"
+}
+/** The write mode for a version 2 storage operation. */
+export declare enum StorageWriteMode {
+    Upsert = "upsert",
+    CreateOnly = "createOnly",
+    Replace = "replace"
+}
+/** Options applied to every item in a version 2 write operation. */
+export interface StorageWriteOptions {
+    /**
+     * Optional time to live, in seconds, for written items.
+     *
+     * When set, storage providers stop returning the written items after this
+     * duration has elapsed. Values must be finite numbers greater than zero.
+     */
+    ttl?: number;
+    mode?: StorageWriteMode;
+    expectedVersion?: string;
+}
+/** Options applied to every item in a version 2 delete operation. */
+export interface StorageDeleteOptions {
+    expectedVersion?: string;
+}
+/**
+ * The version 2 storage contract.
+ *
+ * This does not extend {@link Storage}: JavaScript cannot overload methods by
+ * return type at runtime. V2 providers are exposed as separately named classes.
+ */
+export declare abstract class StorageV2 {
+    /**
+     * Reads stored values and returns one result for every requested key.
+     *
+     * @param keys The keys to read. An empty array is valid.
+     * @returns Keyed results containing a value and storage version when found.
+     */
+    abstract read<T extends object = Record<string, unknown>>(keys: string[]): Promise<StorageReadResults<T>>;
+    /**
+     * Writes values with optional create, replace, or version conditions.
+     *
+     * @param changes Values indexed by their storage keys.
+     * @param options Conditions applied to every value in the batch.
+     * @returns One result for every supplied key.
+     */
+    abstract write<T extends object = Record<string, unknown>>(changes: Record<string, T>, options?: StorageWriteOptions): Promise<StorageWriteResults>;
+    /**
+     * Deletes values with an optional version condition.
+     *
+     * @param keys The keys to delete. An empty array is valid.
+     * @param options Conditions applied to every key in the batch.
+     * @returns One result for every supplied key.
+     */
+    abstract delete(keys: string[], options?: StorageDeleteOptions): Promise<StorageDeleteResults>;
+}
+/** A storage implementation supported by public hosting interfaces. */
+export type StorageProvider = Storage | StorageV2;

package/dist/src/storage/storage.js

@@ -4,4 +4,29 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageV2 = exports.StorageWriteMode = exports.StorageOperationStatus = void 0;
+/** The outcome of one version 2 storage operation. */
+var StorageOperationStatus;
+(function (StorageOperationStatus) {
+    StorageOperationStatus["Succeeded"] = "succeeded";
+    StorageOperationStatus["NotFound"] = "notFound";
+    StorageOperationStatus["Conflict"] = "conflict";
+    StorageOperationStatus["ConditionNotMet"] = "conditionNotMet";
+})(StorageOperationStatus || (exports.StorageOperationStatus = StorageOperationStatus = {}));
+/** The write mode for a version 2 storage operation. */
+var StorageWriteMode;
+(function (StorageWriteMode) {
+    StorageWriteMode["Upsert"] = "upsert";
+    StorageWriteMode["CreateOnly"] = "createOnly";
+    StorageWriteMode["Replace"] = "replace";
+})(StorageWriteMode || (exports.StorageWriteMode = StorageWriteMode = {}));
+/**
+ * The version 2 storage contract.
+ *
+ * This does not extend {@link Storage}: JavaScript cannot overload methods by
+ * return type at runtime. V2 providers are exposed as separately named classes.
+ */
+class StorageV2 {
+}
+exports.StorageV2 = StorageV2;
 //# sourceMappingURL=storage.js.map

package/dist/src/storage/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA+IH,sDAAsD;AACtD,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,+CAAqB,CAAA;IACrB,+CAAqB,CAAA;IACrB,6DAAmC,CAAA;AACrC,CAAC,EALW,sBAAsB,aAAtB,sBAAsB,GAAtB,sBAAsB,QAKjC;AAED,wDAAwD;AACxD,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,6CAAyB,CAAA;IACzB,uCAAmB,CAAA;AACrB,CAAC,EAJW,gBAAgB,aAAhB,gBAAgB,GAAhB,gBAAgB,QAI3B;AAoBD;;;;;GAKG;AACH;CA0BC"}

package/dist/src/storage/storageCompatibility.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { StorageDeleteResults, StorageProvider, StorageReadResults, StorageV2, StorageWriteResults } from './storage';
+/** Returns true when a storage implementation declares the V2 contract. */
+export declare function isStorageV2(storage: StorageProvider): storage is StorageV2;
+/** Converts a supported storage implementation to the V2 contract. */
+export declare function asStorageV2(storage: StorageProvider): StorageV2;
+/** Returns a successful V2 read value, maps not-found to undefined, and rejects invalid results. */
+export declare function getStorageReadValue<T extends object>(results: StorageReadResults<T> | null | undefined, key: string): T | undefined;
+/** Throws when a V2 write did not succeed for every requested key. */
+export declare function assertStorageWriteSucceeded(results: StorageWriteResults | null | undefined, keys: string[]): void;
+/** Throws the state-specific concurrency error when a state write does not succeed. */
+export declare function assertAgentStateWriteSucceeded(results: StorageWriteResults | null | undefined, key: string, name: string): void;
+/** Throws when a V2 delete did not complete with idempotent V1 semantics. */
+export declare function assertStorageDeleteSucceeded(results: StorageDeleteResults | null | undefined, keys: string[]): void;

package/dist/src/storage/storageCompatibility.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStorageV2 = isStorageV2;
+exports.asStorageV2 = asStorageV2;
+exports.getStorageReadValue = getStorageReadValue;
+exports.assertStorageWriteSucceeded = assertStorageWriteSucceeded;
+exports.assertAgentStateWriteSucceeded = assertAgentStateWriteSucceeded;
+exports.assertStorageDeleteSucceeded = assertStorageDeleteSucceeded;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const errorHelper_1 = require("../errorHelper");
+const storage_1 = require("./storage");
+/** Returns true when a storage implementation declares the V2 contract. */
+function isStorageV2(storage) {
+    return storage instanceof storage_1.StorageV2;
+}
+/** Converts a supported storage implementation to the V2 contract. */
+function asStorageV2(storage) {
+    return isStorageV2(storage) ? storage : new StorageToStorageV2Adapter(storage);
+}
+/** Returns a successful V2 read value, maps not-found to undefined, and rejects invalid results. */
+function getStorageReadValue(results, key) {
+    const result = results === null || results === void 0 ? void 0 : results[key];
+    if ((result === null || result === void 0 ? void 0 : result.status) === storage_1.StorageOperationStatus.NotFound)
+        return undefined;
+    if ((result === null || result === void 0 ? void 0 : result.status) === storage_1.StorageOperationStatus.Succeeded)
+        return result.value;
+    throwStorageResultError('read', key, result === null || result === void 0 ? void 0 : result.status);
+}
+/** Adapts the legacy storage contract to version 2 where its semantics allow it. */
+class StorageToStorageV2Adapter extends storage_1.StorageV2 {
+    constructor(storage) {
+        super();
+        this.storage = storage;
+    }
+    async read(keys) {
+        validateKeys(keys);
+        if (keys.length === 0)
+            return {};
+        const items = await this.storage.read(keys);
+        return Object.fromEntries(keys.map(key => {
+            const value = items[key];
+            return [key, Object.prototype.hasOwnProperty.call(items, key)
+                    ? { key, status: storage_1.StorageOperationStatus.Succeeded, value: value, version: value === null || value === void 0 ? void 0 : value.eTag }
+                    : { key, status: storage_1.StorageOperationStatus.NotFound }];
+        }));
+    }
+    async write(changes, options) {
+        validateChanges(changes);
+        if ((options === null || options === void 0 ? void 0 : options.mode) !== undefined && options.mode !== storage_1.StorageWriteMode.Upsert) {
+            throwUnsupportedOption('mode');
+        }
+        if ((options === null || options === void 0 ? void 0 : options.ttl) !== undefined) {
+            throwUnsupportedOption('ttl');
+        }
+        validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
+        if (Object.keys(changes).length === 0)
+            return {};
+        const legacyChanges = Object.fromEntries(Object.entries(changes).map(([key, value]) => [
+            key,
+            (options === null || options === void 0 ? void 0 : options.expectedVersion) === undefined
+                ? removeLegacyETag(value)
+                : { ...removeLegacyETag(value), eTag: options.expectedVersion },
+        ]));
+        await this.storage.write(legacyChanges);
+        return Object.fromEntries(Object.keys(changes).map(key => [key, { key, status: storage_1.StorageOperationStatus.Succeeded }]));
+    }
+    async delete(keys, options) {
+        validateDeleteKeys(keys);
+        validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
+        if ((options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined) {
+            throwUnsupportedOption('expectedVersion');
+        }
+        if (keys.length === 0)
+            return {};
+        await this.storage.delete(keys);
+        return Object.fromEntries(keys.map(key => [key, { key, status: storage_1.StorageOperationStatus.Succeeded }]));
+    }
+}
+function validateKeys(keys) {
+    if (!Array.isArray(keys)) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageReadKeysRequired);
+    }
+    if (keys.some(key => typeof key !== 'string' || key.trim() === '')) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
+    }
+}
+function validateDeleteKeys(keys) {
+    if (!Array.isArray(keys)) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageDeleteKeysRequired);
+    }
+    if (keys.some(key => typeof key !== 'string' || key.trim() === '')) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
+    }
+}
+function validateChanges(changes) {
+    if (changes === null || typeof changes !== 'object' || Array.isArray(changes)) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageWriteChangesRequired);
+    }
+    if (Object.keys(changes).some(key => key.trim() === '')) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
+    }
+}
+function removeLegacyETag(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return value;
+    const { eTag: _eTag, ...withoutETag } = value;
+    return withoutETag;
+}
+function validateExpectedVersion(expectedVersion) {
+    if (expectedVersion === '') {
+        throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.StorageV2ExpectedVersionEmpty);
+    }
+}
+function throwUnsupportedOption(option) {
+    throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.StorageV2UnsupportedOption, undefined, { option });
+}
+/** Throws when a V2 write did not succeed for every requested key. */
+function assertStorageWriteSucceeded(results, keys) {
+    assertStorageResults('write', results, keys, new Set([storage_1.StorageOperationStatus.Succeeded]));
+}
+/** Throws the state-specific concurrency error when a state write does not succeed. */
+function assertAgentStateWriteSucceeded(results, key, name) {
+    var _a;
+    const status = (_a = results === null || results === void 0 ? void 0 : results[key]) === null || _a === void 0 ? void 0 : _a.status;
+    if (status !== storage_1.StorageOperationStatus.Succeeded) {
+        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.AgentStateWriteConflict, undefined, {
+            name,
+            key,
+            status: status !== null && status !== void 0 ? status : 'missing',
+        });
+    }
+}
+/** Throws when a V2 delete did not complete with idempotent V1 semantics. */
+function assertStorageDeleteSucceeded(results, keys) {
+    assertStorageResults('delete', results, keys, new Set([storage_1.StorageOperationStatus.Succeeded, storage_1.StorageOperationStatus.NotFound]));
+}
+function assertStorageResults(operation, results, keys, acceptedStatuses) {
+    var _a;
+    for (const key of keys) {
+        const status = (_a = results === null || results === void 0 ? void 0 : results[key]) === null || _a === void 0 ? void 0 : _a.status;
+        if (status === undefined || !acceptedStatuses.has(status)) {
+            throwStorageResultError(operation, key, status);
+        }
+    }
+}
+function throwStorageResultError(operation, key, status) {
+    throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.StorageV2OperationFailed, undefined, {
+        operation,
+        key,
+        status: status !== null && status !== void 0 ? status : 'missing',
+    });
+}
+//# sourceMappingURL=storageCompatibility.js.map

package/dist/src/storage/storageCompatibility.js.map

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

package/dist/src/storage/storageExpiry.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { StorageWriteOptions } from './storage';
+export declare function getStorageWriteExpiry(options?: StorageWriteOptions): number | undefined;

package/dist/src/storage/storageExpiry.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStorageWriteExpiry = getStorageWriteExpiry;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const errorHelper_1 = require("../errorHelper");
+function getStorageWriteExpiry(options) {
+    const ttl = options === null || options === void 0 ? void 0 : options.ttl;
+    if (ttl === undefined) {
+        return undefined;
+    }
+    if (!Number.isFinite(ttl) || ttl <= 0) {
+        throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.InvalidStorageTtl);
+    }
+    return Date.now() + ttl * 1000;
+}
+//# sourceMappingURL=storageExpiry.js.map

package/dist/src/storage/storageExpiry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageExpiry.js","sourceRoot":"","sources":["../../../src/storage/storageExpiry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,gEAA4D;AAC5D,gDAAuC;AAEvC,+BAAuC,OAA6B;IAClE,MAAM,GAAG,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,CAAA;IACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,iCAAe,CAAC,iBAAiB,CAAC,UAAU,EAAE,oBAAM,CAAC,iBAAiB,CAAC,CAAA;IAC/E,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAA;AAChC,CAAC"}

package/dist/src/utils/env.d.ts

@@ -6,6 +6,48 @@
  * authentication, and connector-client modules. Keeping them internal lets us
  * normalize behavior across the package without growing the public API.
  */
+export interface LoadEnv {
+    [upperKey: string]: {
+        key: string;
+        value: any;
+    };
+}
+type ParserSettings<K extends string> = {
+    [key in K]: (value: string) => {
+        key?: string;
+        value?: any;
+    } | undefined;
+};
+/**
+ * Indexes non-empty environment values case-insensitively while preserving
+ * their original key spelling.
+ */
+export declare function loadEnvSettings(callback: (key: string, value: string) => void, environment?: NodeJS.ProcessEnv): LoadEnv;
+/**
+ * Creates a case-insensitive parser for a fixed set of environment keys.
+ */
+export declare function envParser<K extends string>(settings: ParserSettings<K> & ThisType<ParserSettings<K>>): {
+    keys: K[];
+    parse(key: K, value: string): {
+        key?: undefined;
+        value?: undefined;
+    } | {
+        key: string;
+        value: any;
+    };
+};
+export declare const envParserUtils: {
+    bypass: (value: string) => {
+        value: string;
+    };
+    redirect: <Parser extends ReturnType<typeof envParser>>(parser: Parser, key: Parameters<Parser['parse']>[0]) => (value: string) => {
+        key?: undefined;
+        value?: undefined;
+    } | {
+        key: string;
+        value: any;
+    };
+};
 /**
  * Parses an environment-variable string into a boolean.
  *
@@ -48,3 +90,4 @@ export declare function parseIntEnv(value: string | undefined, fallback: number)
  * @param maxDistance - Maximum edit distance to consider a match (default 2).
  */
 export declare function suggestClosest(input: string, candidates: readonly string[], maxDistance?: number): string | undefined;
+export {};

package/dist/src/utils/env.js

@@ -2,17 +2,53 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.envParserUtils = void 0;
+exports.loadEnvSettings = loadEnvSettings;
+exports.envParser = envParser;
 exports.parseBooleanEnv = parseBooleanEnv;
 exports.parseIntEnv = parseIntEnv;
 exports.suggestClosest = suggestClosest;
 /**
- * Internal helpers for parsing environment-variable strings into typed values.
- *
- * These helpers are intentionally NOT exported from the package's public
- * `index.ts`; they are an internal utility shared between the adapter,
- * authentication, and connector-client modules. Keeping them internal lets us
- * normalize behavior across the package without growing the public API.
+ * Indexes non-empty environment values case-insensitively while preserving
+ * their original key spelling.
+ */
+function loadEnvSettings(callback, environment = process.env) {
+    const env = {};
+    for (const [envKey, envValue] of Object.entries(environment)) {
+        if (!(envValue === null || envValue === void 0 ? void 0 : envValue.trim())) {
+            continue;
+        }
+        env[envKey.toUpperCase()] = { key: envKey, value: envValue };
+        callback(envKey, envValue);
+    }
+    return env;
+}
+/**
+ * Creates a case-insensitive parser for a fixed set of environment keys.
  */
+function envParser(settings) {
+    const keys = Object.keys(settings);
+    const upperKeys = keys.reduce((acc, key) => {
+        acc[key.toUpperCase()] = key;
+        return acc;
+    }, {});
+    return {
+        keys,
+        parse(key, value) {
+            var _a;
+            const match = upperKeys[key.toUpperCase()];
+            if (!match) {
+                return {};
+            }
+            const result = settings[match](value);
+            return { key: (_a = result === null || result === void 0 ? void 0 : result.key) !== null && _a !== void 0 ? _a : match, value: result === null || result === void 0 ? void 0 : result.value };
+        }
+    };
+}
+exports.envParserUtils = {
+    bypass: (value) => ({ value }),
+    redirect: (parser, key) => (value) => parser.parse(key, value)
+};
 /**
  * Parses an environment-variable string into a boolean.
  *

package/dist/src/utils/env.js.map

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

package/dist/src/utils.d.ts

@@ -8,3 +8,4 @@
  * @returns A new object with all undefined values removed
  */
 export declare const prune: <T extends Record<string, any>>(obj: T) => T;
+export declare const mergeDefined: <T extends Record<string, any>>(...layers: readonly (Partial<T> | undefined)[]) => T;

package/dist/src/utils.js

@@ -4,7 +4,7 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.prune = void 0;
+exports.mergeDefined = exports.prune = void 0;
 /**
  * Utility function to prune undefined values from an object. This is useful for cleaning up configuration objects before logging or processing, ensuring that only defined values are included.
  * @param obj The object to prune
@@ -15,4 +15,13 @@ const prune = (obj) => {
     return Object.fromEntries(entries);
 };
 exports.prune = prune;
+const mergeDefined = (...layers) => {
+    const result = {};
+    for (const layer of layers) {
+        if (layer)
+            Object.assign(result, (0, exports.prune)(layer));
+    }
+    return result;
+};
+exports.mergeDefined = mergeDefined;
 //# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;GAIG;AACI,MAAM,KAAK,GAAG,CAAgC,GAAM,EAAE,EAAE;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IAC9E,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAM,CAAA;AACzC,CAAC,CAAA;AAHY,QAAA,KAAK,GAAL,KAAK,CAGjB"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;;GAIG;AACI,MAAM,KAAK,GAAG,CAAgC,GAAM,EAAE,EAAE;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IAC9E,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAM,CAAA;AACzC,CAAC,CAAA;AAHY,QAAA,KAAK,GAAL,KAAK,CAGjB;AAEM,MAAM,YAAY,GAAG,CAC1B,GAAG,MAA2C,EAC3C,EAAE;IACL,MAAM,MAAM,GAAe,EAAE,CAAA;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAA,QAAA,KAAK,EAAC,KAAK,CAAC,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC,CAAA;AARY,QAAA,YAAY,GAAZ,YAAY,CAQxB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting",
-  "version": "1.9.0-beta.3.gb2d23c1c44",
+  "version": "1.9.1",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -21,8 +21,8 @@
   "dependencies": {
     "@azure/core-auth": "1.10.1",
     "@azure/msal-node": "5.6.0",
-    "@microsoft/agents-activity": "1.9.0-beta.3.gb2d23c1c44",
-    "@microsoft/agents-telemetry": "1.9.0-beta.3.gb2d23c1c44",
+    "@microsoft/agents-activity": "1.9.1",
+    "@microsoft/agents-telemetry": "1.9.1",
     "jsonwebtoken": "9.0.3",
     "jwks-rsa": "4.0.1",
     "zod": "3.25.75"