@microsoft/agents-hosting 0.2.14 → 0.3.5

package/dist/src/app/oauth/authorization.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Authorization = void 0;
+const logger_1 = require("../../logger");
+const oauth_1 = require("../../oauth");
+const state_1 = require("../../state");
+const logger = (0, logger_1.debug)('agents:authorization');
+/**
+ * Class responsible for managing authorization and OAuth flows
+ * @class Authorization
+ */
+class Authorization {
+    /**
+     * Creates a new instance of UserAuthorization.
+     * @param {Storage} storage - The storage system to use for state management.
+     * @param {AuthorizationHandlers} authHandlers - Configuration for OAuth providers
+     * @throws {Error} If storage is null/undefined or no auth handlers are provided
+     */
+    constructor(storage, authHandlers) {
+        var _a, _b, _c, _d;
+        /**
+         * Resolves the auth handler to use based on the provided ID
+         * @param {string} [authHandlerId] - Optional ID of the auth handler to resolve, defaults to first handler
+         * @returns {AuthHandler} The resolved auth handler
+         */
+        this.resolverHandler = (authHandlerId) => {
+            if (authHandlerId) {
+                return this._authHandlers[authHandlerId];
+            }
+            return this._authHandlers[Object.keys(this._authHandlers)[0]];
+        };
+        this._signInHandler = null;
+        if (storage === undefined || storage === null) {
+            throw new Error('Storage is required for UserAuthorization');
+        }
+        const userState = new state_1.UserState(storage);
+        if (authHandlers === undefined || Object.keys(authHandlers).length === 0) {
+            throw new Error('The authorization does not have any auth handlers');
+        }
+        this._authHandlers = authHandlers;
+        for (const ah in this._authHandlers) {
+            if (this._authHandlers[ah].name === undefined && process.env[ah + '_connectionName'] === undefined) {
+                throw new Error(`AuthHandler name ${ah}_connectionName not set in autorization and not found in env vars.`);
+            }
+            const currentAuthHandler = this._authHandlers[ah];
+            currentAuthHandler.name = (_a = currentAuthHandler.name) !== null && _a !== void 0 ? _a : process.env[ah + '_connectionName'];
+            currentAuthHandler.title = (_b = currentAuthHandler.title) !== null && _b !== void 0 ? _b : process.env[ah + '_connectionTitle'];
+            currentAuthHandler.text = (_c = currentAuthHandler.text) !== null && _c !== void 0 ? _c : process.env[ah + '_connectionText'];
+            currentAuthHandler.auto = (_d = currentAuthHandler.auto) !== null && _d !== void 0 ? _d : process.env[ah + '_connectionAuto'] === 'true';
+            currentAuthHandler.flow = new oauth_1.OAuthFlow(userState, currentAuthHandler.name, null, currentAuthHandler.title, currentAuthHandler.text);
+        }
+        logger.info('Authorization handlers configured with', this._authHandlers.length, 'handlers');
+    }
+    /**
+     * Gets the token for a specific auth handler
+     * @param {TurnContext} context - The context object for the current turn
+     * @param {string} [authHandlerId] - Optional ID of the auth handler to use, defaults to first handler
+     * @returns {Promise<TokenResponse>} The token response from the OAuth provider
+     */
+    async getToken(context, authHandlerId) {
+        var _a;
+        logger.info('getToken from user token service for authHandlerId:', authHandlerId);
+        const authHandler = this.resolverHandler(authHandlerId);
+        return await ((_a = authHandler.flow) === null || _a === void 0 ? void 0 : _a.getUserToken(context));
+    }
+    /**
+     * Begins or continues an OAuth flow
+     * @param {TurnContext} context - The context object for the current turn
+     * @param {TurnState} state - The state object for the current turn
+     * @param {string} [authHandlerId] - Optional ID of the auth handler to use, defaults to first handler
+     * @returns {Promise<TokenResponse>} The token response from the OAuth provider
+     */
+    async beginOrContinueFlow(context, state, authHandlerId) {
+        logger.info('beginOrContinueFlow for authHandlerId:', authHandlerId);
+        const flow = this.resolverHandler(authHandlerId).flow;
+        let tokenResponse;
+        if (flow.state.flowStarted === false) {
+            tokenResponse = await flow.beginFlow(context);
+        }
+        else {
+            tokenResponse = await flow.continueFlow(context);
+            if (tokenResponse.status === oauth_1.TokenRequestStatus.Success) {
+                if (this._signInHandler) {
+                    await this._signInHandler(context, state, authHandlerId);
+                }
+            }
+        }
+        return tokenResponse;
+    }
+    /**
+     * Gets the current state of the OAuth flow
+     * @param {string} [authHandlerId] - Optional ID of the auth handler to check, defaults to first handler
+     * @returns {boolean} Whether the flow has started
+     */
+    getFlowState(authHandlerId) {
+        var _a;
+        const flow = this.resolverHandler(authHandlerId).flow;
+        return (_a = flow.state) === null || _a === void 0 ? void 0 : _a.flowStarted;
+    }
+    /**
+     * Signs out the current user.
+     * This method clears the user's token and resets the SSO state.
+     *
+     * @param {TurnContext} context - The context object for the current turn.
+     * @param {TurnState} state - The state object for the current turn.
+     * @param {string} [authHandlerId] - Optional ID of the auth handler to use for sign out
+     * @returns {Promise<void>}
+     */
+    async signOut(context, state, authHandlerId) {
+        var _a;
+        logger.info('signOut for authHandlerId:', authHandlerId);
+        if (authHandlerId === undefined) { // aw
+            for (const ah in this._authHandlers) {
+                const flow = this._authHandlers[ah].flow;
+                await (flow === null || flow === void 0 ? void 0 : flow.signOut(context));
+            }
+        }
+        else {
+            await ((_a = this.resolverHandler(authHandlerId).flow) === null || _a === void 0 ? void 0 : _a.signOut(context));
+        }
+    }
+    /**
+     * Sets a handler to be called when sign-in is successfully completed
+     * @param {Function} handler - The handler function to call on successful sign-in
+     */
+    onSignInSuccess(handler) {
+        this._signInHandler = handler;
+    }
+}
+exports.Authorization = Authorization;
+//# sourceMappingURL=authorization.js.map

package/dist/src/app/oauth/authorization.js.map

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

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

@@ -4,4 +4,12 @@
  */
 import { TurnContext } from '../turnContext';
 import { TurnState } from './turnState';
+/**
+ * A handler function for routing operations in a specific turn context and state.
+ *
+ * @typeParam TState - The type of the turn state.
+ * @param context - The turn context for the current operation.
+ * @param state - The state associated with the current turn.
+ * @returns A promise that resolves when the routing operation is complete.
+ */
 export type RouteHandler<TState extends TurnState> = (context: TurnContext, state: TState) => Promise<void>;

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

@@ -3,5 +3,14 @@
  * Licensed under the MIT License.
  */
 import { TurnContext } from '../turnContext';
+/**
+ * A function that determines whether a specific condition is met in the given turn context.
+ *
+ * @param context - The turn context for the current operation.
+ * @returns A promise that resolves to a boolean indicating whether the condition is met.
+ */
 export type Selector = (context: TurnContext) => Promise<boolean>;
+/**
+ * A specialized selector for routing operations.
+ */
 export type RouteSelector = Selector;

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

@@ -7,23 +7,48 @@ import { AppMemory } from './appMemory';
 import { InputFile } from './inputFileDownloader';
 import { TurnStateEntry } from './turnStateEntry';
 import { TurnContext } from '../turnContext';
+/**
+ * Default interface for conversation state.
+ * Extend this interface to define custom conversation state properties.
+ */
 export interface DefaultConversationState {
 }
+/**
+ * Default interface for user state.
+ * Extend this interface to define custom user state properties.
+ */
 export interface DefaultUserState {
 }
+/**
+ * Default interface for temporary state that persists only during the current turn.
+ * Contains properties used for handling user input, file attachments, and OAuth flows.
+ */
 export interface DefaultTempState {
+    /** Current user input text */
     input: string;
+    /** Collection of files attached to the current message */
     inputFiles: InputFile[];
+    /** Last output text generated by the agent */
     lastOutput: string;
+    /** Results from actions performed by the agent */
     actionOutputs: Record<string, string>;
+    /** OAuth tokens keyed by provider ID */
     authTokens: {
         [key: string]: string;
     };
+    /** Flag to prevent duplicate token exchanges */
     duplicateTokenExchange?: boolean;
 }
+/**
+ * Default interface for Single Sign-On (SSO) state.
+ * Contains properties used for managing OAuth authentication flows.
+ */
 export interface DefaultSSOState {
+    /** Whether an OAuth flow has been started */
     flowStarted: boolean;
+    /** The user's access token */
     userToken: string;
+    /** Expiration timestamp for the current flow */
     flowExpires: number;
 }
 /**
@@ -55,31 +80,156 @@ export interface DefaultSSOState {
  *   }
  * }
  * ```
+ * @template TConversationState - Type for conversation-scoped state
+ * @template TUserState - Type for user-scoped state
+ * @template TTempState - Type for temporary state that exists only for the current turn
+ * @template TSSOState - Type for Single Sign-On (SSO) state
  */
 export declare class TurnState<TConversationState = DefaultConversationState, TUserState = DefaultUserState, TTempState = DefaultTempState, TSSOState = DefaultSSOState> implements AppMemory {
     private _scopes;
     private _isLoaded;
     private _loadingPromise?;
     private _stateNotLoadedString;
+    /**
+     * Gets the conversation-scoped state.
+     * This state is shared by all users in the same conversation.
+     * @returns The conversation state object
+     * @throws Error if state hasn't been loaded
+     */
     get conversation(): TConversationState;
+    /**
+     * Sets the conversation-scoped state.
+     * @param value - The new conversation state object
+     * @throws Error if state hasn't been loaded
+     */
     set conversation(value: TConversationState);
+    /**
+     * Gets whether the state has been loaded from storage
+     * @returns True if the state has been loaded, false otherwise
+     */
     get isLoaded(): boolean;
+    /**
+     * Gets the temporary state for the current turn.
+     * This state is not persisted between turns.
+     * @returns The temporary state object
+     * @throws Error if state hasn't been loaded
+     */
     get temp(): TTempState;
+    /**
+     * Sets the temporary state for the current turn.
+     * @param value - The new temporary state object
+     * @throws Error if state hasn't been loaded
+     */
     set temp(value: TTempState);
+    /**
+     * Gets the user-scoped state.
+     * This state is unique to each user and persists across conversations.
+     * @returns The user state object
+     * @throws Error if state hasn't been loaded
+     */
     get user(): TUserState;
+    /**
+     * Sets the user-scoped state.
+     * @param value - The new user state object
+     * @throws Error if state hasn't been loaded
+     */
     set user(value: TUserState);
+    /**
+     * Gets the Single Sign-On (SSO) state.
+     * This state is used to manage OAuth authentication flows.
+     * @returns The SSO state object
+     * @throws Error if state hasn't been loaded
+     */
     get sso(): TSSOState;
+    /**
+     * Sets the Single Sign-On (SSO) state.
+     * @param value - The new SSO state object
+     * @throws Error if state hasn't been loaded
+     */
     set sso(value: TSSOState);
+    /**
+     * Marks the conversation state for deletion.
+     * The state will be deleted from storage on the next call to save().
+     * @throws Error if state hasn't been loaded
+     */
     deleteConversationState(): void;
+    /**
+     * Marks the temporary state for deletion.
+     * Since temporary state is not persisted, this just clears the in-memory object.
+     * @throws Error if state hasn't been loaded
+     */
     deleteTempState(): void;
+    /**
+     * Marks the user state for deletion.
+     * The state will be deleted from storage on the next call to save().
+     * @throws Error if state hasn't been loaded
+     */
     deleteUserState(): void;
+    /**
+     * Gets a specific state scope by name.
+     * @param scope - The name of the scope to retrieve
+     * @returns The state entry for the scope, or undefined if not found
+     */
     getScope(scope: string): TurnStateEntry | undefined;
+    /**
+     * Deletes a value from state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to the value to delete
+     */
     deleteValue(path: string): void;
+    /**
+     * Checks if a value exists in state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to check
+     * @returns True if the value exists, false otherwise
+     */
     hasValue(path: string): boolean;
+    /**
+     * Gets a value from state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @template TValue - The type of the value to retrieve
+     * @param path - The path to the value
+     * @returns The value at the specified path
+     */
     getValue<TValue = unknown>(path: string): TValue;
+    /**
+     * Sets a value in state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to set
+     * @param value - The value to set
+     */
     setValue(path: string, value: unknown): void;
+    /**
+     * Loads state from storage into memory.
+     * @param context - The turn context
+     * @param storage - Optional storage provider (if not provided, state will be in-memory only)
+     * @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>;
+    /**
+     * Saves state changes to storage.
+     * Only changed scopes will be persisted.
+     * @param context - The turn context
+     * @param storage - Optional storage provider (if not provided, state changes won't be persisted)
+     * @returns Promise that resolves when the save operation is complete
+     * @throws Error if state hasn't been loaded
+     */
     save(context: TurnContext, storage?: Storage): Promise<void>;
+    /**
+     * Computes the storage keys for each scope based on the turn context.
+     * Override this method in derived classes to add or modify storage keys.
+     * @param context - The turn context
+     * @returns Promise that resolves to a dictionary of scope names to storage keys
+     * @protected
+     */
     protected onComputeStorageKeys(context: TurnContext): Promise<Record<string, string>>;
+    /**
+     * Parses a dot-notation path into scope and property name.
+     * If no scope is specified, defaults to the temp scope.
+     * @param path - The path to parse (format: "scope.property" or just "property")
+     * @returns Object containing the scope entry and property name
+     * @private
+     */
     private getScopeAndName;
 }

package/dist/src/app/turnState.js

@@ -41,6 +41,10 @@ const SSO_SCOPE = 'sso';
  *   }
  * }
  * ```
+ * @template TConversationState - Type for conversation-scoped state
+ * @template TUserState - Type for user-scoped state
+ * @template TTempState - Type for temporary state that exists only for the current turn
+ * @template TSSOState - Type for Single Sign-On (SSO) state
  */
 class TurnState {
     constructor() {
@@ -48,6 +52,12 @@ class TurnState {
         this._isLoaded = false;
         this._stateNotLoadedString = 'TurnState hasn\'t been loaded. Call load() first.';
     }
+    /**
+     * Gets the conversation-scoped state.
+     * This state is shared by all users in the same conversation.
+     * @returns The conversation state object
+     * @throws Error if state hasn't been loaded
+     */
     get conversation() {
         const scope = this.getScope(CONVERSATION_SCOPE);
         if (!scope) {
@@ -55,6 +65,11 @@ class TurnState {
         }
         return scope.value;
     }
+    /**
+     * Sets the conversation-scoped state.
+     * @param value - The new conversation state object
+     * @throws Error if state hasn't been loaded
+     */
     set conversation(value) {
         const scope = this.getScope(CONVERSATION_SCOPE);
         if (!scope) {
@@ -62,9 +77,19 @@ class TurnState {
         }
         scope.replace(value);
     }
+    /**
+     * Gets whether the state has been loaded from storage
+     * @returns True if the state has been loaded, false otherwise
+     */
     get isLoaded() {
         return this._isLoaded;
     }
+    /**
+     * Gets the temporary state for the current turn.
+     * This state is not persisted between turns.
+     * @returns The temporary state object
+     * @throws Error if state hasn't been loaded
+     */
     get temp() {
         const scope = this.getScope(TEMP_SCOPE);
         if (!scope) {
@@ -72,6 +97,11 @@ class TurnState {
         }
         return scope.value;
     }
+    /**
+     * Sets the temporary state for the current turn.
+     * @param value - The new temporary state object
+     * @throws Error if state hasn't been loaded
+     */
     set temp(value) {
         const scope = this.getScope(TEMP_SCOPE);
         if (!scope) {
@@ -79,6 +109,12 @@ class TurnState {
         }
         scope.replace(value);
     }
+    /**
+     * Gets the user-scoped state.
+     * This state is unique to each user and persists across conversations.
+     * @returns The user state object
+     * @throws Error if state hasn't been loaded
+     */
     get user() {
         const scope = this.getScope(USER_SCOPE);
         if (!scope) {
@@ -86,6 +122,11 @@ class TurnState {
         }
         return scope.value;
     }
+    /**
+     * Sets the user-scoped state.
+     * @param value - The new user state object
+     * @throws Error if state hasn't been loaded
+     */
     set user(value) {
         const scope = this.getScope(USER_SCOPE);
         if (!scope) {
@@ -93,6 +134,12 @@ class TurnState {
         }
         scope.replace(value);
     }
+    /**
+     * Gets the Single Sign-On (SSO) state.
+     * This state is used to manage OAuth authentication flows.
+     * @returns The SSO state object
+     * @throws Error if state hasn't been loaded
+     */
     get sso() {
         const scope = this.getScope(SSO_SCOPE);
         if (!scope) {
@@ -100,6 +147,11 @@ class TurnState {
         }
         return scope.value;
     }
+    /**
+     * Sets the Single Sign-On (SSO) state.
+     * @param value - The new SSO state object
+     * @throws Error if state hasn't been loaded
+     */
     set sso(value) {
         const scope = this.getScope(SSO_SCOPE);
         if (!scope) {
@@ -107,6 +159,11 @@ class TurnState {
         }
         scope.replace(value);
     }
+    /**
+     * Marks the conversation state for deletion.
+     * The state will be deleted from storage on the next call to save().
+     * @throws Error if state hasn't been loaded
+     */
     deleteConversationState() {
         const scope = this.getScope(CONVERSATION_SCOPE);
         if (!scope) {
@@ -114,6 +171,11 @@ class TurnState {
         }
         scope.delete();
     }
+    /**
+     * Marks the temporary state for deletion.
+     * Since temporary state is not persisted, this just clears the in-memory object.
+     * @throws Error if state hasn't been loaded
+     */
     deleteTempState() {
         const scope = this.getScope(TEMP_SCOPE);
         if (!scope) {
@@ -121,6 +183,11 @@ class TurnState {
         }
         scope.delete();
     }
+    /**
+     * Marks the user state for deletion.
+     * The state will be deleted from storage on the next call to save().
+     * @throws Error if state hasn't been loaded
+     */
     deleteUserState() {
         const scope = this.getScope(USER_SCOPE);
         if (!scope) {
@@ -128,27 +195,63 @@ class TurnState {
         }
         scope.delete();
     }
+    /**
+     * Gets a specific state scope by name.
+     * @param scope - The name of the scope to retrieve
+     * @returns The state entry for the scope, or undefined if not found
+     */
     getScope(scope) {
         return this._scopes[scope];
     }
+    /**
+     * Deletes a value from state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to the value to delete
+     */
     deleteValue(path) {
         const { scope, name } = this.getScopeAndName(path);
         if (Object.prototype.hasOwnProperty.call(scope.value, name)) {
             delete scope.value[name];
         }
     }
+    /**
+     * Checks if a value exists in state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to check
+     * @returns True if the value exists, false otherwise
+     */
     hasValue(path) {
         const { scope, name } = this.getScopeAndName(path);
         return Object.prototype.hasOwnProperty.call(scope.value, name);
     }
+    /**
+     * Gets a value from state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @template TValue - The type of the value to retrieve
+     * @param path - The path to the value
+     * @returns The value at the specified path
+     */
     getValue(path) {
         const { scope, name } = this.getScopeAndName(path);
         return scope.value[name];
     }
+    /**
+     * Sets a value in state by dot-notation path.
+     * Format: "scope.property" or just "property" (defaults to temp scope)
+     * @param path - The path to set
+     * @param value - The value to set
+     */
     setValue(path, value) {
         const { scope, name } = this.getScopeAndName(path);
         scope.value[name] = value;
     }
+    /**
+     * Loads state from storage into memory.
+     * @param context - The turn context
+     * @param storage - Optional storage provider (if not provided, state will be in-memory only)
+     * @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, storage, force = false) {
         if (this._isLoaded && !force) {
             return Promise.resolve(false);
@@ -186,6 +289,14 @@ class TurnState {
         }
         return this._loadingPromise;
     }
+    /**
+     * Saves state changes to storage.
+     * Only changed scopes will be persisted.
+     * @param context - The turn context
+     * @param storage - Optional storage provider (if not provided, state changes won't be persisted)
+     * @returns Promise that resolves when the save operation is complete
+     * @throws Error if state hasn't been loaded
+     */
     async save(context, storage) {
         if (!this._isLoaded && this._loadingPromise) {
             await this._loadingPromise;
@@ -230,6 +341,13 @@ class TurnState {
             }
         }
     }
+    /**
+     * Computes the storage keys for each scope based on the turn context.
+     * Override this method in derived classes to add or modify storage keys.
+     * @param context - The turn context
+     * @returns Promise that resolves to a dictionary of scope names to storage keys
+     * @protected
+     */
     onComputeStorageKeys(context) {
         var _a, _b, _c;
         const activity = context.activity;
@@ -255,6 +373,13 @@ class TurnState {
         keys[SSO_SCOPE] = `${channelId}/${agentId}/sso`;
         return Promise.resolve(keys);
     }
+    /**
+     * Parses a dot-notation path into scope and property name.
+     * If no scope is specified, defaults to the temp scope.
+     * @param path - The path to parse (format: "scope.property" or just "property")
+     * @returns Object containing the scope entry and property name
+     * @private
+     */
     getScopeAndName(path) {
         const parts = path.split('.');
         if (parts.length > 2) {

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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"}