@microsoft/agents-hosting 1.0.0 → 1.0.3-g444d99f704

package/dist/src/turnContext.js

@@ -55,14 +55,15 @@ class TurnContext {
     /**
      * Sends a trace activity for debugging purposes.
      *
-     * Trace activities are typically used for debugging and are only visible in
-     * channels that support them, like the Bot Framework Emulator.
-     *
      * @param name The name/category of the trace
      * @param value The value/data to include in the trace
      * @param valueType Optional type name for the value
      * @param label Optional descriptive label for the trace
      * @returns A promise that resolves to the resource response or undefined
+     *
+     * @remarks
+     * Trace activities are typically used for debugging and are only visible in
+     * channels that support them, like the Bot Framework Emulator.
      */
     async sendTraceActivity(name, value, valueType, label) {
         const traceActivityObj = {
@@ -79,14 +80,15 @@ class TurnContext {
     /**
      * Sends an activity to the sender of the incoming activity.
      *
-     * This is the primary method used to respond to the user. It automatically
-     * addresses the response to the correct conversation and recipient using
-     * information from the incoming activity.
-     *
      * @param activityOrText The activity to send or a string for a simple message
      * @param speak Optional text to be spoken by the agent
      * @param inputHint Optional input hint to indicate if the agent is expecting input
      * @returns A promise that resolves to the resource response or undefined
+     *
+     * @remarks
+     * This is the primary method used to respond to the user. It automatically
+     * addresses the response to the correct conversation and recipient using
+     * information from the incoming activity.
      */
     async sendActivity(activityOrText, speak, inputHint) {
         let activityObject;
@@ -106,12 +108,13 @@ class TurnContext {
     /**
      * Sends multiple activities to the sender of the incoming activity.
      *
+     * @param activities The array of activities to send
+     * @returns A promise that resolves to an array of resource responses
+     *
+     * @remarks
      * This method applies conversation references to each activity and
      * emits them through the middleware chain before sending them to
      * the adapter.
-     *
-     * @param activities The array of activities to send
-     * @returns A promise that resolves to an array of resource responses
      */
     async sendActivities(activities) {
         let sentNonTraceActivity = false;
@@ -163,11 +166,12 @@ class TurnContext {
     /**
      * Updates an existing activity in the conversation.
      *
-     * This can be used to edit previously sent activities, for example to
-     * update the content of an adaptive card or change a message.
-     *
      * @param activity The activity to update with its ID specified
      * @returns A promise that resolves when the activity has been updated
+     *
+     * @remarks
+     * This can be used to edit previously sent activities, for example to
+     * update the content of an adaptive card or change a message.
      */
     async updateActivity(activity) {
         const ref = this.activity.getConversationReference();
@@ -223,11 +227,12 @@ class TurnContext {
     /**
      * Registers a handler for intercepting and processing activities being sent.
      *
-     * This method follows a middleware pattern, allowing multiple handlers to
-     * be chained together. Handlers can modify activities or inject new ones.
-     *
      * @param handler The handler to register
      * @returns The current TurnContext instance for chaining
+     *
+     * @remarks
+     * This method follows a middleware pattern, allowing multiple handlers to
+     * be chained together. Handlers can modify activities or inject new ones.
      */
     onSendActivities(handler) {
         this._onSendActivities.push(handler);
@@ -267,6 +272,7 @@ class TurnContext {
     /**
      * Gets the adapter that created this context.
      *
+     * @remarks
      * The adapter is responsible for sending and receiving activities
      * to and from the user's channel.
      */
@@ -276,6 +282,7 @@ class TurnContext {
     /**
      * Gets the incoming activity that started this turn.
      *
+     * @remarks
      * This is the activity that was received from the user or channel
      * and triggered the creation of this context.
      */
@@ -285,6 +292,7 @@ class TurnContext {
     /**
      * Gets or sets whether the turn has sent a response to the user.
      *
+     * @remarks
      * This is used to track whether the agent has responded to the user's
      * activity. Once set to true, it cannot be set back to false.
      */
@@ -300,6 +308,7 @@ class TurnContext {
     /**
      * Gets or sets the locale for the turn.
      *
+     * @remarks
      * The locale affects language-dependent operations like
      * formatting dates or numbers.
      */
@@ -323,6 +332,7 @@ class TurnContext {
     /**
      * Gets the turn state collection for storing data during the turn.
      *
+     * @remarks
      * The turn state collection provides a dictionary-like interface
      * for storing arbitrary data that needs to be accessible during
      * the processing of the current turn.
@@ -336,15 +346,16 @@ class TurnContext {
     /**
      * Emits events to registered middleware handlers.
      *
-     * This internal method implements the middleware pattern, allowing
-     * handlers to be chained together with each having the option to
-     * short-circuit the chain.
-     *
      * @param handlers Array of handlers to execute
      * @param arg The argument to pass to each handler
      * @param next The function to execute at the end of the middleware chain
      * @returns A promise that resolves to the result from the handlers or next function
      * @private
+     *
+     * @remarks
+     * This internal method implements the middleware pattern, allowing
+     * handlers to be chained together with each having the option to
+     * short-circuit the chain.
      */
     async emit(handlers, arg, next) {
         const runHandlers = async ([handler, ...remaining]) => {

package/dist/src/turnContext.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting",
-  "version": "1.0.0",
+  "version": "1.0.3-g444d99f704",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
   "dependencies": {
     "@azure/core-auth": "^1.10.0",
     "@azure/msal-node": "^3.6.0",
-    "@microsoft/agents-activity": "1.0.0",
+    "@microsoft/agents-activity": "1.0.3-g444d99f704",
     "axios": "^1.10.0",
     "jsonwebtoken": "^9.0.2",
     "jwks-rsa": "^3.2.0"

package/src/activityHandler.ts

@@ -31,7 +31,6 @@ const logger = debug('agents:activity-handler')
  * Handles incoming activities from channels and dispatches them to the appropriate handlers.
  *
  * @remarks
- *
  * This class is provided to simplify the migration from Bot Framework SDK v4 to the Agents Hosting framework.
  *
  * The ActivityHandler serves as the central hub for processing incoming activities in conversational AI applications.

package/src/agent-client/agentResponseHandler.ts

@@ -17,17 +17,12 @@ interface ConversationReferenceState {
 /**
  * To enable Agent to Agent communication, configures the agent response controller endpoint for handling incoming activities from external services.
  *
+ * @remarks
  * This function sets up a POST endpoint that receives activities (messages, events, etc.) from external
  * services and processes them through the bot framework's activity handling pipeline. It's typically used
  * when the agent needs to receive and respond to activities from channels or services that send activities
  * to a specific webhook endpoint.
  *
- * @param app - The Express application instance to configure the route on
- * @param adapter - The CloudAdapter instance used for processing bot framework activities and managing conversations
- * @param agent - The ActivityHandler instance that contains the bot's logic for processing different types of activities
- * @param conversationState - The ConversationState instance used for managing conversation-specific state and conversation references
- *
- * @remarks
  * The endpoint expects activities to be sent to:
  * `POST /api/agentresponse/v3/conversations/{conversationId}/activities/{activityId}`
  *
@@ -38,6 +33,11 @@ interface ConversationReferenceState {
  * - Processing EndOfConversation activities by cleaning up conversation state
  * - Sending activities through the turn context and returning responses
  *
+ * @param app - The Express application instance to configure the route on
+ * @param adapter - The CloudAdapter instance used for processing bot framework activities and managing conversations
+ * @param agent - The ActivityHandler instance that contains the bot's logic for processing different types of activities
+ * @param conversationState - The ConversationState instance used for managing conversation-specific state and conversation references
+ *
  * @example
  * ```typescript
  * const app = express();

package/src/app/adaptiveCards/adaptiveCardsActions.ts

@@ -34,7 +34,8 @@ enum AdaptiveCardInvokeResponseType {
 }
 
 /**
- * @summary Represents a single search result item returned from an Adaptive Card search operation.
+ * Represents a single search result item returned from an Adaptive Card search operation.
+ *
  * @remarks
  * This interface defines the structure for search results that are displayed to users
  * when they perform searches within Adaptive Cards, such as typeahead or dropdown searches.
@@ -46,10 +47,12 @@ enum AdaptiveCardInvokeResponseType {
  *   value: "john.doe@company.com"
  * };
  * ```
+ *
  */
 export interface AdaptiveCardSearchResult {
   /**
-   * @summary The display text shown to the user in the search results.
+   * The display text shown to the user in the search results.
+   *
    * @remarks
    * This is typically the human-readable label that appears in dropdowns,
    * typeahead suggestions, or search result lists.
@@ -59,7 +62,8 @@ export interface AdaptiveCardSearchResult {
   title: string;
 
   /**
-   * @summary The underlying value associated with this search result.
+   * The underlying value associated with this search result.
+   *
    * @remarks
    * This is usually the actual data value that gets selected when the user
    * chooses this result, such as an ID, email address, or other identifier.
@@ -71,6 +75,7 @@ export interface AdaptiveCardSearchResult {
 
 /**
  * A class to handle Adaptive Card actions such as executing actions, submitting actions, and performing searches.
+ *
  * @typeParam TState - The type of the TurnState used in the application.
  */
 export class AdaptiveCardsActions<TState extends TurnState> {
@@ -88,7 +93,8 @@ export class AdaptiveCardsActions<TState extends TurnState> {
   }
 
   /**
-   * Registers a handler for the Action.Execute event.
+   * Registers a handler for the `Action.Execute` event.
+   *
    * @typeParam TData - The type of the data passed to the handler.
    * @param verb - A string, RegExp, RouteSelector, or an array of these to match the action verb.
    * @param handler - A function to handle the action execution.
@@ -174,6 +180,7 @@ export class AdaptiveCardsActions<TState extends TurnState> {
 
   /**
    * Registers a handler for the Action.Submit event.
+   *
    * @typeParam TData - The type of the data passed to the handler.
    * @param verb - A string, RegExp, RouteSelector, or an array of these to match the action verb.
    * @param handler - A function to handle the action submission.
@@ -200,6 +207,7 @@ export class AdaptiveCardsActions<TState extends TurnState> {
 
   /**
    * Registers a handler for the search event.
+   *
    * @param dataset - A string, RegExp, RouteSelector, or an array of these to match the dataset.
    * @param handler - A function to handle the search query.
    * @returns The Teams application instance.

package/src/app/agentApplication.ts

@@ -36,7 +36,9 @@ const TYPING_TIMER_DELAY = 1000
 export type ApplicationEventHandler<TState extends TurnState> = (context: TurnContext, state: TState) => Promise<boolean>
 
 /**
- * @summary Main application class for handling agent conversations and routing.
+ * Main application class for handling agent conversations and routing.
+ *
+ * @typeParam TState - The state type extending TurnState.
  *
  * @remarks
  * The AgentApplication class provides a framework for building conversational agents.
@@ -65,7 +67,6 @@ export type ApplicationEventHandler<TState extends TurnState> = (context: TurnCo
  * await app.run(turnContext);
  * ```
  *
- * @typeParam TState - The state type extending TurnState.
  */
 export class AgentApplication<TState extends TurnState> {
   protected readonly _options: AgentApplicationOptions<TState>
@@ -79,7 +80,7 @@ export class AgentApplication<TState extends TurnState> {
   private readonly _adaptiveCards: AdaptiveCardsActions<TState>
 
   /**
-   * @summary Creates a new instance of AgentApplication.
+   * Creates a new instance of AgentApplication.
    *
    * @param options - Optional configuration options for the application.
    *
@@ -142,7 +143,7 @@ export class AgentApplication<TState extends TurnState> {
   }
 
   /**
-   * @summary Gets the authorization instance for the application.
+   * Gets the authorization instance for the application.
    *
    * @returns The authorization instance.
    * @throws Error if no authentication options were configured.
@@ -155,7 +156,7 @@ export class AgentApplication<TState extends TurnState> {
   }
 
   /**
-   * @summary Gets the options used to configure the application.
+   * Gets the options used to configure the application.
    *
    * @returns The application options.
    */
@@ -164,7 +165,7 @@ export class AgentApplication<TState extends TurnState> {
   }
 
   /**
-   * @summary Gets the adapter used by the application.
+   * Gets the adapter used by the application.
    *
    * @returns The adapter instance.
    */
@@ -173,7 +174,7 @@ export class AgentApplication<TState extends TurnState> {
   }
 
   /**
-   * @summary Gets the adaptive cards actions handler for the application.
+   * Gets the adaptive cards actions handler for the application.
    *
    * @returns The adaptive cards actions instance.
    *
@@ -209,6 +210,7 @@ export class AgentApplication<TState extends TurnState> {
    *   await context.sendActivity('Sorry, something went wrong!');
    * });
    * ```
+   *
    */
   public onError (handler: (context: TurnContext, error: Error) => Promise<void>): this {
     if (this._adapter) {
@@ -243,6 +245,7 @@ export class AgentApplication<TState extends TurnState> {
    *   RouteRank.First // rank
    * );
    * ```
+   *
    */
   public addRoute (selector: RouteSelector, handler: RouteHandler<TState>, isInvokeRoute: boolean = false, rank: number = RouteRank.Unspecified, authHandlers: string[] = []): this {
     this._routes.addRoute(selector, handler, isInvokeRoute, rank, authHandlers)
@@ -268,6 +271,7 @@ export class AgentApplication<TState extends TurnState> {
    *   await context.sendActivity('I received your message');
    * });
    * ```
+   *
    */
   public onActivity (
     type: string | RegExp | RouteSelector | (string | RegExp | RouteSelector)[],
@@ -306,6 +310,7 @@ export class AgentApplication<TState extends TurnState> {
    *   }
    * });
    * ```
+   *
    */
   public onConversationUpdate (
     event: ConversationUpdateEvents,
@@ -383,6 +388,7 @@ export class AgentApplication<TState extends TurnState> {
    *   await context.sendActivity('How can I help you?');
    * });
    * ```
+   *
    */
   public onMessage (
     keyword: string | RegExp | RouteSelector | (string | RegExp | RouteSelector)[],
@@ -414,6 +420,7 @@ export class AgentApplication<TState extends TurnState> {
    *   await context.sendActivity('You have successfully signed in!');
    * });
    * ```
+   *
    */
   public onSignInSuccess (handler: (context: TurnContext, state: TurnState, id?: string) => Promise<void>): this {
     if (this.options.authorization) {
@@ -443,6 +450,7 @@ export class AgentApplication<TState extends TurnState> {
    *   await context.sendActivity('Sign-in failed. Please try again.');
    * });
    * ```
+   *
    */
   public onSignInFailure (handler: (context: TurnContext, state: TurnState, id?: string) => Promise<void>): this {
     if (this.options.authorization) {
@@ -475,6 +483,7 @@ export class AgentApplication<TState extends TurnState> {
    *   }
    * });
    * ```
+   *
    */
   public onMessageReactionAdded (
     handler: (context: TurnContext, state: TState) => Promise<void>,
@@ -509,6 +518,7 @@ export class AgentApplication<TState extends TurnState> {
    *   }
    * });
    * ```
+   *
    */
   public onMessageReactionRemoved (
     handler: (context: TurnContext, state: TState) => Promise<void>,
@@ -539,6 +549,7 @@ export class AgentApplication<TState extends TurnState> {
    * const app = new AgentApplication();
    * await app.run(turnContext);
    * ```
+   *
    */
   public async run (turnContext:TurnContext): Promise<void> {
     await this.runInternal(turnContext)
@@ -573,6 +584,7 @@ export class AgentApplication<TState extends TurnState> {
    *   console.log('No handler matched the activity');
    * }
    * ```
+   *
    */
   public async runInternal (turnContext: TurnContext): Promise<boolean> {
     logger.info('Running application with activity:', turnContext.activity.id!)
@@ -688,6 +700,7 @@ export class AgentApplication<TState extends TurnState> {
    * // From an existing context
    * await app.sendProactiveActivity(turnContext, 'Important notification!');
    * ```
+   *
    */
   public async sendProactiveActivity (
     context: TurnContext | ConversationReference,
@@ -724,6 +737,7 @@ export class AgentApplication<TState extends TurnState> {
    * await turnContext.sendActivity('Response after processing');
    * // Typing timer automatically stops when sending a message
    * ```
+   *
    */
   public startTypingTimer (context: TurnContext): void {
     if (context.activity.type === ActivityTypes.Message && !this._typingTimer) {
@@ -782,6 +796,7 @@ export class AgentApplication<TState extends TurnState> {
    *   console.log('Extension registered:', ext.name);
    * });
    * ```
+   *
    */
   public registerExtension<T extends AgentExtension<TState>> (extension: T, regcb : (ext:T) => void): void {
     if (this._extensions.includes(extension)) {
@@ -807,6 +822,7 @@ export class AgentApplication<TState extends TurnState> {
    * // Do some processing...
    * app.stopTypingTimer(); // Manually stop the typing indicator
    * ```
+   *
    */
   public stopTypingTimer (): void {
     if (this._typingTimer) {
@@ -834,6 +850,7 @@ export class AgentApplication<TState extends TurnState> {
    *   return true; // Continue execution
    * });
    * ```
+   *
    */
   public onTurn (
     event: TurnEvents | TurnEvents[],

package/src/app/appRoute.ts

@@ -10,14 +10,14 @@ import { TurnState } from './turnState'
 /**
  * Represents a route configuration for handling bot activities within an application.
  *
+ * @typeParam TState - The type of turn state that extends TurnState, allowing for
+ *                    type-safe access to custom state properties within route handlers
+ *
  * @remarks
  * An AppRoute defines how incoming activities are matched and processed by combining
  * a selector function that determines when the route should be activated with a handler
  * function that processes the matched activities.
  *
- * @typeParam TState - The type of turn state that extends TurnState, allowing for
- *                    type-safe access to custom state properties within route handlers
- *
  * @example
  * ```typescript
  * const echoRoute: AppRoute<MyTurnState> = {
@@ -27,6 +27,7 @@ import { TurnState } from './turnState'
  *   }
  * };
  * ```
+ *
  */
 export interface AppRoute<TState extends TurnState> {
   /**
@@ -53,18 +54,20 @@ export interface AppRoute<TState extends TurnState> {
   /**
    * Indicates whether this route is an invoke route.
    *
+   * @default false
+   *
    * @remarks
    * Invoke routes are used for specific types of activities, such as messaging extensions,
    * adaptive card actions, or other invoke-based interactions. When set to true, this route
    * will be processed differently than regular message routes, typically with special
    * handling for invoke responses.
    *
-   * @default false
    */
   isInvokeRoute?: boolean;
 
   /**
    * Optional rank of the route, used to determine the order in which routes are evaluated.
+   *
    * 0 - number.MAX_VALUE. Ranks of the same value are evaluated in order of addition.
    */
   rank?: number;
@@ -82,6 +85,7 @@ export interface AppRoute<TState extends TurnState> {
    * ```typescript
    * authHandlers: ['oauth', 'admin-only']
    * ```
+   *
    */
   authHandlers?: string[]
 }

package/src/app/attachmentDownloader.ts

@@ -17,11 +17,12 @@ const logger = debug('agents:attachmentDownloader')
 /**
  * A utility class for downloading input files from activity attachments.
  *
+ * @typeParam TState - The type of the turn state used in the application.
+ *
  * @remarks
  * This class provides functionality to filter and download attachments from a turn context,
  * supporting various content types and handling authentication for secure URLs.
  *
- * @typeParam TState - The type of the turn state used in the application.
  */
 export class AttachmentDownloader<TState extends TurnState = TurnState> implements InputFileDownloader<TState> {
   private _httpClient: AxiosInstance
@@ -36,6 +37,7 @@ export class AttachmentDownloader<TState extends TurnState = TurnState> implemen
 
   /**
    * Downloads files from the attachments in the current turn context.
+   *
    * @param context The turn context containing the activity with attachments.
    * @param state The turn state for the current conversation.
    * @returns A promise that resolves to an array of downloaded input files.