@microsoft/agents-hosting 1.9.0-beta.8.gf58e66b2ee → 1.9.1

package/dist/src/app/rateLimit.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentApplicationRateLimiter = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_telemetry_1 = require("@microsoft/agents-telemetry");
+const activityHandler_1 = require("../activityHandler");
+const storage_1 = require("../storage");
+const storageCompatibility_1 = require("../storage/storageCompatibility");
+const statusCodes_1 = require("../statusCodes");
+const logger = (0, agents_telemetry_1.debug)('agents:rate-limit');
+const DEFAULT_THROTTLE_MESSAGE = 'Too many requests. Please try again later.';
+const DEFAULT_MAX_STORAGE_RETRIES = 3;
+class AgentApplicationRateLimiter {
+    /**
+     * Creates a limiter for the configured rules, using application storage as
+     * the shared fallback when a rule does not provide its own storage.
+     */
+    constructor(rules, storage) {
+        this.rules = rules;
+        this.storage = storage;
+        this.fallbackStorage = (0, storageCompatibility_1.asStorageV2)(new storage_1.MemoryStorage());
+        this.storageAdapters = new WeakMap();
+        this.storageIds = new WeakMap();
+        this.locks = new Map();
+        this.nextStorageId = 1;
+    }
+    /**
+     * Evaluates every applicable rule and stages window writes. The turn is
+     * allowed only when no rule is over its limit and all required writes succeed.
+     */
+    async shouldAllowTurn(context) {
+        const pendingEvaluations = [];
+        for (let i = 0; i < this.rules.length; i++) {
+            const rule = this.rules[i];
+            if (!(await this.appliesToTurn(rule, context))) {
+                continue;
+            }
+            const key = await this.getScopeKey(rule, context);
+            if (!key) {
+                return {
+                    allowed: false,
+                    rule,
+                    result: { ruleIndex: i, retryAfterMs: rule.windowMs }
+                };
+            }
+            try {
+                pendingEvaluations.push(this.createPendingEvaluation(rule, i, key));
+            }
+            catch (err) {
+                const decision = this.handleStorageError(rule, { ruleIndex: i, key, retryAfterMs: rule.windowMs }, err);
+                if (!decision) {
+                    continue;
+                }
+                return decision;
+            }
+        }
+        if (pendingEvaluations.length > 0) {
+            return await this.withLocks(pendingEvaluations.map(pending => this.getLockKey(pending.storage, pending.storageKey)), async () => {
+                const decision = await this.commitPendingEvaluations(pendingEvaluations);
+                return decision !== null && decision !== void 0 ? decision : { allowed: true };
+            });
+        }
+        return { allowed: true };
+    }
+    /**
+     * Reads and persists fixed-window state updates while holding key locks.
+     *
+     * The evaluation happens here so reads and writes use fresh eTags, and so
+     * concurrent first requests cannot all write wildcard-created counters.
+     */
+    async commitPendingEvaluations(pendingEvaluations) {
+        var _a, _b;
+        let attempt = 0;
+        const committed = new Set();
+        while (true) {
+            const writes = [];
+            let retry = false;
+            for (const pending of pendingEvaluations) {
+                if (committed.has(this.getLockKey(pending.storage, pending.storageKey))) {
+                    continue;
+                }
+                try {
+                    const { result, write } = await this.evaluateRule(pending);
+                    if (result) {
+                        return { allowed: false, rule: pending.rule, result };
+                    }
+                    if (write) {
+                        writes.push(write);
+                    }
+                }
+                catch (err) {
+                    if (attempt >= ((_a = pending.rule.maxStorageRetries) !== null && _a !== void 0 ? _a : DEFAULT_MAX_STORAGE_RETRIES)) {
+                        const decision = this.handleStorageError(pending.rule, {
+                            ruleIndex: pending.ruleIndex,
+                            key: pending.key,
+                            retryAfterMs: pending.rule.windowMs
+                        }, err);
+                        if (decision) {
+                            return decision;
+                        }
+                        continue;
+                    }
+                    retry = true;
+                    break;
+                }
+            }
+            if (retry) {
+                attempt++;
+                continue;
+            }
+            for (const pending of writes) {
+                try {
+                    const results = await pending.storage.write({ [pending.storageKey]: pending.window }, pending.window.eTag === undefined ? undefined : { expectedVersion: pending.window.eTag });
+                    (0, storageCompatibility_1.assertStorageWriteSucceeded)(results, [pending.storageKey]);
+                    committed.add(this.getLockKey(pending.storage, pending.storageKey));
+                }
+                catch (err) {
+                    if (attempt >= ((_b = pending.rule.maxStorageRetries) !== null && _b !== void 0 ? _b : DEFAULT_MAX_STORAGE_RETRIES)) {
+                        const decision = this.handleStorageError(pending.rule, {
+                            ruleIndex: pending.ruleIndex,
+                            key: pending.key,
+                            retryAfterMs: pending.rule.windowMs
+                        }, err);
+                        if (decision) {
+                            return decision;
+                        }
+                        continue;
+                    }
+                    retry = true;
+                    break;
+                }
+            }
+            if (!retry) {
+                return undefined;
+            }
+            attempt++;
+        }
+    }
+    /**
+     * Converts storage failures into the configured fail-open, fail-closed, or
+     * throw behavior.
+     */
+    handleStorageError(rule, result, err) {
+        var _a;
+        const behavior = (_a = rule.storageErrorBehavior) !== null && _a !== void 0 ? _a : 'throttle';
+        if (behavior === 'allow') {
+            logger.warn('Rate limit storage failed; allowing turn:', err);
+            return undefined;
+        }
+        if (behavior === 'throw') {
+            throw err;
+        }
+        logger.warn('Rate limit storage failed; throttling turn:', err);
+        return {
+            allowed: false,
+            rule,
+            result
+        };
+    }
+    /**
+     * Sends the throttled response through the correct channel mechanism.
+     */
+    async handleThrottledTurn(context, rule, result) {
+        var _a;
+        const message = await this.resolveMessage(context, rule, result);
+        if (context.activity.type === agents_activity_1.ActivityTypes.Invoke) {
+            context.turnState.set(activityHandler_1.INVOKE_RESPONSE_KEY, {
+                type: agents_activity_1.ActivityTypes.InvokeResponse,
+                value: {
+                    status: statusCodes_1.StatusCodes.TOO_MANY_REQUESTS,
+                    body: { message: typeof message === 'string' ? message : (_a = message === null || message === void 0 ? void 0 : message.text) !== null && _a !== void 0 ? _a : this.getDefaultMessage() }
+                }
+            });
+            return;
+        }
+        if (!message) {
+            return;
+        }
+        try {
+            await context.sendActivity(message);
+        }
+        catch (err) {
+            logger.warn('Failed to send rate limit message:', err);
+        }
+    }
+    /**
+     * Checks activity type and custom predicate filters before touching storage.
+     */
+    async appliesToTurn(rule, context) {
+        if (rule.activityTypes && !rule.activityTypes.some(t => { var _a; return t.toLocaleLowerCase() === ((_a = context.activity.type) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()); })) {
+            return false;
+        }
+        if (rule.appliesTo && !(await rule.appliesTo(context))) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Resolves and normalizes the storage key fragment for this rule and turn.
+     */
+    async getScopeKey(rule, context) {
+        const key = await rule.scope(context);
+        return (key === null || key === void 0 ? void 0 : key.trim()) || undefined;
+    }
+    /**
+     * Reads the current window, decides whether the turn is over limit, and
+     * prepares the next window state when the turn should be counted.
+     */
+    async evaluateRule(pending) {
+        const { rule, ruleIndex, storage, storageKey, key } = pending;
+        const items = await storage.read([storageKey]);
+        const value = (0, storageCompatibility_1.getStorageReadValue)(items, storageKey);
+        const current = value === undefined
+            ? undefined
+            : { ...value, eTag: items[storageKey].version };
+        const now = Date.now();
+        const window = this.getFixedWindow(rule, current, now);
+        if (window.count >= rule.limit) {
+            return {
+                result: {
+                    ruleIndex,
+                    key,
+                    retryAfterMs: Math.max(0, window.resetAt - now)
+                }
+            };
+        }
+        window.count++;
+        return {
+            write: { ...pending, window }
+        };
+    }
+    createPendingEvaluation(rule, ruleIndex, key) {
+        var _a, _b;
+        const storage = this.getStorageV2((_b = (_a = rule.storage) !== null && _a !== void 0 ? _a : this.storage) !== null && _b !== void 0 ? _b : this.fallbackStorage);
+        const storageKey = `rateLimit:${ruleIndex}:${key}`;
+        return { rule, ruleIndex, storage, storageKey, key };
+    }
+    getStorageV2(storage) {
+        if (storage instanceof storage_1.StorageV2) {
+            return storage;
+        }
+        const existing = this.storageAdapters.get(storage);
+        if (existing) {
+            return existing;
+        }
+        const adapter = (0, storageCompatibility_1.asStorageV2)(storage);
+        this.storageAdapters.set(storage, adapter);
+        return adapter;
+    }
+    async withLocks(lockKeys, action) {
+        const releases = [];
+        const uniqueLockKeys = [...new Set(lockKeys)].sort();
+        for (const key of uniqueLockKeys) {
+            releases.push(await this.acquireLock(key));
+        }
+        try {
+            return await action();
+        }
+        finally {
+            for (const release of releases.reverse()) {
+                release();
+            }
+        }
+    }
+    async acquireLock(key) {
+        var _a;
+        const previous = (_a = this.locks.get(key)) !== null && _a !== void 0 ? _a : Promise.resolve();
+        let releaseCurrent;
+        const current = new Promise(resolve => {
+            releaseCurrent = resolve;
+        });
+        const next = previous.then(() => current);
+        this.locks.set(key, next);
+        await previous;
+        return () => {
+            if (this.locks.get(key) === next) {
+                this.locks.delete(key);
+            }
+            releaseCurrent();
+        };
+    }
+    getLockKey(storage, storageKey) {
+        return `${this.getStorageId(storage)}:${storageKey}`;
+    }
+    getStorageId(storage) {
+        const existing = this.storageIds.get(storage);
+        if (existing) {
+            return existing;
+        }
+        const id = this.nextStorageId++;
+        this.storageIds.set(storage, id);
+        return id;
+    }
+    /**
+     * Reuses the active window or starts a new one after the reset time.
+     */
+    getFixedWindow(rule, current, now) {
+        if (!current || !Number.isFinite(current.resetAt) || current.resetAt <= now) {
+            return {
+                count: 0,
+                resetAt: now + rule.windowMs,
+                // TODO: Once microsoft/Agents-for-net#883 lands in this SDK's storage
+                // contract, use a create-if-absent write for new rate limit counters.
+                // Unconditional writes are not protected by process-local locks in
+                // scaled-out deployments.
+                eTag: current === null || current === void 0 ? void 0 : current.eTag
+            };
+        }
+        return { ...current };
+    }
+    /**
+     * Resolves static and factory throttling messages to a sendable value.
+     */
+    async resolveMessage(context, rule, result) {
+        var _a;
+        if (typeof rule.message === 'function') {
+            return await rule.message(context, result);
+        }
+        return (_a = rule.message) !== null && _a !== void 0 ? _a : this.getDefaultMessage();
+    }
+    /**
+     * Returns the fallback throttling text when a rule does not provide one.
+     */
+    getDefaultMessage() {
+        return DEFAULT_THROTTLE_MESSAGE;
+    }
+}
+exports.AgentApplicationRateLimiter = AgentApplicationRateLimiter;
+//# sourceMappingURL=rateLimit.js.map

package/dist/src/app/rateLimit.js.map

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

package/dist/src/app/turnState.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
-import { Storage } from '../storage';
+import { StorageProvider } from '../storage';
 import { AppMemory } from './appMemory';
 import { TurnStateEntry } from './turnStateEntry';
 import { TurnContext } from '../turnContext';
@@ -57,6 +57,8 @@ export interface DefaultUserState {
  */
 export declare class TurnState<TConversationState = DefaultConversationState, TUserState = DefaultUserState> implements AppMemory {
     private _scopes;
+    private _versions;
+    private _missingStorageKeys;
     private _isLoaded;
     private _loadingPromise?;
     /**
@@ -173,7 +175,7 @@ export declare class TurnState<TConversationState = DefaultConversationState, TU
      * @param force - If true, forces a reload from storage even if state is already loaded
      * @returns Promise that resolves to true if state was loaded, false if it was already loaded
      */
-    load(context: TurnContext, storage?: Storage, force?: boolean): Promise<boolean>;
+    load(context: TurnContext, storage?: StorageProvider, force?: boolean): Promise<boolean>;
     /**
      * Saves state changes to storage.
      *
@@ -185,7 +187,8 @@ export declare class TurnState<TConversationState = DefaultConversationState, TU
      * @remarks
      * Only changed scopes will be persisted.
      */
-    save(context: TurnContext, storage?: Storage): Promise<void>;
+    save(context: TurnContext, storage?: StorageProvider): Promise<void>;
+    private getStorageScopeName;
     /**
      * Computes the storage keys for each scope based on the turn context.
      *

package/dist/src/app/turnState.js

@@ -5,6 +5,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TurnState = void 0;
+const storage_1 = require("../storage");
+const storageCompatibility_1 = require("../storage/storageCompatibility");
 const turnStateEntry_1 = require("./turnStateEntry");
 const agents_telemetry_1 = require("@microsoft/agents-telemetry");
 const agents_activity_1 = require("@microsoft/agents-activity");
@@ -53,6 +55,8 @@ const TEMP_SCOPE = 'temp';
 class TurnState {
     constructor() {
         this._scopes = {};
+        this._versions = {};
+        this._missingStorageKeys = new Set();
         this._isLoaded = false;
     }
     /**
@@ -233,17 +237,27 @@ class TurnState {
                 const keys = [];
                 this.onComputeStorageKeys(context)
                     .then(async (scopes) => {
+                    var _a, _b;
                     for (const key in scopes) {
                         if (Object.prototype.hasOwnProperty.call(scopes, key)) {
                             keys.push(scopes[key]);
                         }
                     }
-                    const items = storage ? await storage.read(keys) : {};
+                    const items = storage
+                        ? await (0, storageCompatibility_1.asStorageV2)(storage).read(keys)
+                        : undefined;
                     for (const key in scopes) {
                         if (Object.prototype.hasOwnProperty.call(scopes, key)) {
                             const storageKey = scopes[key];
-                            const value = items[storageKey];
+                            const value = storage ? (0, storageCompatibility_1.getStorageReadValue)(items, storageKey) : undefined;
                             this._scopes[key] = new turnStateEntry_1.TurnStateEntry(value, storageKey);
+                            this._versions[storageKey] = (_a = items === null || items === void 0 ? void 0 : items[storageKey]) === null || _a === void 0 ? void 0 : _a.version;
+                            if (((_b = items === null || items === void 0 ? void 0 : items[storageKey]) === null || _b === void 0 ? void 0 : _b.status) === storage_1.StorageOperationStatus.NotFound) {
+                                this._missingStorageKeys.add(storageKey);
+                            }
+                            else {
+                                this._missingStorageKeys.delete(storageKey);
+                            }
                         }
                     }
                     this._scopes[TEMP_SCOPE] = new turnStateEntry_1.TurnStateEntry({});
@@ -304,17 +318,42 @@ class TurnState {
         }
         if (storage) {
             const promises = [];
+            const storageV2 = (0, storageCompatibility_1.asStorageV2)(storage);
             if (changes) {
-                promises.push(storage.write(changes));
+                for (const [key, value] of Object.entries(changes)) {
+                    const expectedVersion = this._versions[key];
+                    const options = expectedVersion !== undefined
+                        ? { expectedVersion }
+                        : (0, storageCompatibility_1.isStorageV2)(storage) && this._missingStorageKeys.has(key)
+                            ? { mode: storage_1.StorageWriteMode.CreateOnly }
+                            : undefined;
+                    promises.push(storageV2.write({ [key]: value }, options).then(results => {
+                        var _a;
+                        (0, storageCompatibility_1.assertAgentStateWriteSucceeded)(results, key, this.getStorageScopeName(key));
+                        this._versions[key] = (_a = results === null || results === void 0 ? void 0 : results[key]) === null || _a === void 0 ? void 0 : _a.version;
+                        this._missingStorageKeys.delete(key);
+                    }));
+                }
             }
             if (deletions) {
-                promises.push(storage.delete(deletions));
+                promises.push(storageV2.delete(deletions).then(results => {
+                    (0, storageCompatibility_1.assertStorageDeleteSucceeded)(results, deletions);
+                    for (const key of deletions) {
+                        delete this._versions[key];
+                        this._missingStorageKeys.delete(key);
+                    }
+                }));
             }
             if (promises.length > 0) {
                 await Promise.all(promises);
             }
         }
     }
+    getStorageScopeName(storageKey) {
+        var _a;
+        var _b;
+        return (_b = (_a = Object.entries(this._scopes).find(([, entry]) => entry.storageKey === storageKey)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : this.constructor.name;
+    }
     /**
      * Computes the storage keys for each scope based on the turn context.
      *

package/dist/src/app/turnState.js.map

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

package/dist/src/auth/authConfiguration.d.ts

@@ -4,6 +4,13 @@
  */
 import { AuthConfiguration } from './settings';
 export { type AuthConfiguration, type ConnectionSettings, type ConnectionSettingsBase, type MsalConnectionSettings, type SidecarConnectionSettings, AuthType, resolveAuthority, type ConnectionMapItem, resolveAuthType } from './settings';
+import { ConfigurationContext } from '../configuration/configuration';
+/**
+ * Optional host-scoped inputs used while resolving authentication settings.
+ */
+export interface AuthConfigurationResolutionOptions {
+    configurationContext?: ConfigurationContext;
+}
 /**
  * Loads the authentication configuration from environment variables.
  *
@@ -30,7 +37,7 @@ export { type AuthConfiguration, type ConnectionSettings, type ConnectionSetting
  * ```
  *
  */
-export declare const loadAuthConfigFromEnv: (cnxName?: string) => AuthConfiguration;
+export declare const loadAuthConfigFromEnv: (cnxName?: string, options?: AuthConfigurationResolutionOptions) => AuthConfiguration;
 /**
  * Loads the agent authentication configuration from previous version environment variables.
  *
@@ -45,7 +52,7 @@ export declare const loadAuthConfigFromEnv: (cnxName?: string) => AuthConfigurat
  * ```
  *
  */
-export declare const loadPrevAuthConfigFromEnv: () => AuthConfiguration;
+export declare const loadPrevAuthConfigFromEnv: (options?: AuthConfigurationResolutionOptions) => AuthConfiguration;
 /**
  * Loads the authentication configuration from the provided config or from the environment variables
  * providing default values for authority and issuers.
@@ -70,4 +77,4 @@ export declare const loadPrevAuthConfigFromEnv: () => AuthConfiguration;
  * ```
  *
  */
-export declare function getAuthConfigWithDefaults(config?: AuthConfiguration): AuthConfiguration;
+export declare function getAuthConfigWithDefaults(config?: AuthConfiguration, options?: AuthConfigurationResolutionOptions): AuthConfiguration;