@microsoft/agents-hosting 0.4.1 → 0.5.1-g2e246ff274

package/dist/src/app/adaptiveCards/adaptiveCardsActions.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveCardsActions = exports.ACTION_INVOKE_NAME = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const __1 = require("../../");
+const adaptiveCardActionExecuteResponseType_1 = require("./adaptiveCardActionExecuteResponseType");
+const activityValueParsers_1 = require("./activityValueParsers");
+exports.ACTION_INVOKE_NAME = 'adaptiveCard/action';
+const ACTION_EXECUTE_TYPE = 'Action.Execute';
+const DEFAULT_ACTION_SUBMIT_FILTER = 'verb';
+const SEARCH_INVOKE_NAME = 'application/search';
+var AdaptiveCardInvokeResponseType;
+(function (AdaptiveCardInvokeResponseType) {
+    /**
+     * Indicates a response containing an Adaptive Card.
+     */
+    AdaptiveCardInvokeResponseType["ADAPTIVE"] = "application/vnd.microsoft.card.adaptive";
+    /**
+     * Indicates a response containing a message activity.
+     */
+    AdaptiveCardInvokeResponseType["MESSAGE"] = "application/vnd.microsoft.activity.message";
+    /**
+     * Indicates a response containing a search result.
+     */
+    AdaptiveCardInvokeResponseType["SEARCH"] = "application/vnd.microsoft.search.searchResponse";
+})(AdaptiveCardInvokeResponseType || (AdaptiveCardInvokeResponseType = {}));
+/**
+ * A class to handle Adaptive Card actions such as executing actions, submitting actions, and performing searches.
+ * @template TState - The type of the TurnState used in the application.
+ */
+class AdaptiveCardsActions {
+    /**
+     * Constructs an instance of AdaptiveCardsActions.
+     * @param app - The Teams application instance.
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Registers a handler for the Action.Execute event.
+     * @template 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.
+     * @returns The Teams application instance.
+     */
+    actionExecute(verb, handler) {
+        var _a, _b;
+        let actionExecuteResponseType = (_b = (_a = this._app.options.adaptiveCardsOptions) === null || _a === void 0 ? void 0 : _a.actionExecuteResponseType) !== null && _b !== void 0 ? _b : adaptiveCardActionExecuteResponseType_1.AdaptiveCardActionExecuteResponseType.REPLACE_FOR_INTERACTOR;
+        (Array.isArray(verb) ? verb : [verb]).forEach((v) => {
+            const selector = createActionExecuteSelector(v);
+            this._app.addRoute(selector, async (context, state) => {
+                var _a;
+                const a = context === null || context === void 0 ? void 0 : context.activity;
+                const invokeAction = (0, activityValueParsers_1.parseValueActionExecuteSelector)(a.value);
+                if ((a === null || a === void 0 ? void 0 : a.type) !== agents_activity_1.ActivityTypes.Invoke ||
+                    (a === null || a === void 0 ? void 0 : a.name) !== exports.ACTION_INVOKE_NAME ||
+                    ((invokeAction === null || invokeAction === void 0 ? void 0 : invokeAction.action.type) !== ACTION_EXECUTE_TYPE)) {
+                    throw new Error(`Unexpected AdaptiveCards.actionExecute() triggered for activity type: ${invokeAction === null || invokeAction === void 0 ? void 0 : invokeAction.action.type}`);
+                }
+                if (invokeAction.action.verb !== v) {
+                    // TODO: add logger to this class
+                    console.log(`AdaptiveCards.actionExecute() triggered for verb: ${invokeAction.action.verb} does not match expected verb: ${v}`);
+                }
+                // TODO: review any, and check verb
+                const result = await handler(context, state, (_a = a.value.action) !== null && _a !== void 0 ? _a : {});
+                if (!context.turnState.get(__1.INVOKE_RESPONSE_KEY)) {
+                    let response;
+                    if (typeof result === 'string') {
+                        response = {
+                            statusCode: 200,
+                            type: AdaptiveCardInvokeResponseType.MESSAGE,
+                            value: result
+                        };
+                        await sendInvokeResponse(context, response);
+                    }
+                    else {
+                        if (result.refresh &&
+                            actionExecuteResponseType !== adaptiveCardActionExecuteResponseType_1.AdaptiveCardActionExecuteResponseType.NEW_MESSAGE_FOR_ALL) {
+                            actionExecuteResponseType = adaptiveCardActionExecuteResponseType_1.AdaptiveCardActionExecuteResponseType.REPLACE_FOR_ALL;
+                        }
+                        const activity = __1.MessageFactory.attachment(__1.CardFactory.adaptiveCard(result));
+                        response = {
+                            statusCode: 200,
+                            type: AdaptiveCardInvokeResponseType.ADAPTIVE,
+                            value: result
+                        };
+                        if (actionExecuteResponseType === adaptiveCardActionExecuteResponseType_1.AdaptiveCardActionExecuteResponseType.NEW_MESSAGE_FOR_ALL) {
+                            await sendInvokeResponse(context, {
+                                statusCode: 200,
+                                type: AdaptiveCardInvokeResponseType.MESSAGE,
+                                value: 'Your response was sent to the app'
+                            });
+                            await context.sendActivity(activity);
+                        }
+                        else if (actionExecuteResponseType === adaptiveCardActionExecuteResponseType_1.AdaptiveCardActionExecuteResponseType.REPLACE_FOR_ALL) {
+                            activity.id = context.activity.replyToId;
+                            await context.updateActivity(activity);
+                            await sendInvokeResponse(context, response);
+                        }
+                        else {
+                            await sendInvokeResponse(context, response);
+                        }
+                    }
+                }
+            }, true);
+        });
+        return this._app;
+    }
+    /**
+     * Registers a handler for the Action.Submit event.
+     * @template 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.
+     * @returns The Teams application instance.
+     */
+    actionSubmit(verb, handler) {
+        var _a, _b;
+        const filter = (_b = (_a = this._app.options.adaptiveCardsOptions) === null || _a === void 0 ? void 0 : _a.actionSubmitFilter) !== null && _b !== void 0 ? _b : DEFAULT_ACTION_SUBMIT_FILTER;
+        (Array.isArray(verb) ? verb : [verb]).forEach((v) => {
+            const selector = createActionSubmitSelector(v, filter);
+            this._app.addRoute(selector, async (context, state) => {
+                var _a;
+                const a = context === null || context === void 0 ? void 0 : context.activity;
+                if ((a === null || a === void 0 ? void 0 : a.type) !== agents_activity_1.ActivityTypes.Message || (a === null || a === void 0 ? void 0 : a.text) || typeof (a === null || a === void 0 ? void 0 : a.value) !== 'object') {
+                    throw new Error(`Unexpected AdaptiveCards.actionSubmit() triggered for activity type: ${a === null || a === void 0 ? void 0 : a.type}`);
+                }
+                await handler(context, state, (_a = ((0, activityValueParsers_1.parseAdaptiveCardInvokeAction)(a.value))) !== null && _a !== void 0 ? _a : {});
+            });
+        });
+        return this._app;
+    }
+    /**
+     * 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.
+     */
+    search(dataset, handler) {
+        (Array.isArray(dataset) ? dataset : [dataset]).forEach((ds) => {
+            const selector = createSearchSelector(ds);
+            this._app.addRoute(selector, async (context, state) => {
+                var _a, _b, _c, _d, _e, _f;
+                const a = context === null || context === void 0 ? void 0 : context.activity;
+                if ((a === null || a === void 0 ? void 0 : a.type) !== 'invoke' || (a === null || a === void 0 ? void 0 : a.name) !== SEARCH_INVOKE_NAME) {
+                    throw new Error(`Unexpected AdaptiveCards.search() triggered for activity type: ${a === null || a === void 0 ? void 0 : a.type}`);
+                }
+                const parsedQuery = (0, activityValueParsers_1.parseValueSearchQuery)(a.value);
+                const query = {
+                    count: (_b = (_a = parsedQuery.queryOptions) === null || _a === void 0 ? void 0 : _a.top) !== null && _b !== void 0 ? _b : 25,
+                    skip: (_d = (_c = parsedQuery.queryOptions) === null || _c === void 0 ? void 0 : _c.skip) !== null && _d !== void 0 ? _d : 0,
+                    parameters: {
+                        queryText: (_e = parsedQuery.queryText) !== null && _e !== void 0 ? _e : '',
+                        dataset: (_f = parsedQuery.dataset) !== null && _f !== void 0 ? _f : ''
+                    }
+                };
+                const results = await handler(context, state, query);
+                if (!context.turnState.get(__1.INVOKE_RESPONSE_KEY)) {
+                    const response = {
+                        type: AdaptiveCardInvokeResponseType.SEARCH,
+                        value: {
+                            results
+                        }
+                    };
+                    await context.sendActivity({
+                        value: { body: response, status: 200 },
+                        type: agents_activity_1.ActivityTypes.InvokeResponse
+                    });
+                }
+            }, true);
+        });
+        return this._app;
+    }
+}
+exports.AdaptiveCardsActions = AdaptiveCardsActions;
+function createActionExecuteSelector(verb) {
+    if (typeof verb === 'function') {
+        return verb;
+    }
+    else if (verb instanceof RegExp) {
+        return (context) => {
+            var _a;
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            const valueAction = (0, activityValueParsers_1.parseValueActionExecuteSelector)(a.value);
+            const isInvoke = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Invoke &&
+                (a === null || a === void 0 ? void 0 : a.name) === exports.ACTION_INVOKE_NAME &&
+                ((_a = valueAction === null || valueAction === void 0 ? void 0 : valueAction.action) === null || _a === void 0 ? void 0 : _a.type) === ACTION_EXECUTE_TYPE;
+            if (isInvoke && typeof valueAction.action.verb === 'string') {
+                return Promise.resolve(verb.test(valueAction.action.verb));
+            }
+            else {
+                return Promise.resolve(false);
+            }
+        };
+    }
+    else {
+        return (context) => {
+            var _a, _b;
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            const valueAction = (0, activityValueParsers_1.parseValueActionExecuteSelector)(a.value);
+            const isInvoke = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Invoke &&
+                (a === null || a === void 0 ? void 0 : a.name) === exports.ACTION_INVOKE_NAME &&
+                ((_a = valueAction === null || valueAction === void 0 ? void 0 : valueAction.action) === null || _a === void 0 ? void 0 : _a.type) === ACTION_EXECUTE_TYPE;
+            if (isInvoke && ((_b = valueAction.action) === null || _b === void 0 ? void 0 : _b.verb) === verb) {
+                return Promise.resolve(true);
+            }
+            else {
+                return Promise.resolve(false);
+            }
+        };
+    }
+}
+function createActionSubmitSelector(verb, filter) {
+    if (typeof verb === 'function') {
+        return verb;
+    }
+    else if (verb instanceof RegExp) {
+        return (context) => {
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            const isSubmit = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Message && !(a === null || a === void 0 ? void 0 : a.text) && typeof (a === null || a === void 0 ? void 0 : a.value) === 'object';
+            if (isSubmit && typeof (a === null || a === void 0 ? void 0 : a.value)[filter] === 'string') {
+                return Promise.resolve(verb.test(a.value[filter]));
+            }
+            else {
+                return Promise.resolve(false);
+            }
+        };
+    }
+    else {
+        return (context) => {
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            const isSubmit = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Message && !(a === null || a === void 0 ? void 0 : a.text) && typeof (a === null || a === void 0 ? void 0 : a.value) === 'object';
+            return Promise.resolve(isSubmit && (a === null || a === void 0 ? void 0 : a.value)[filter] === verb);
+        };
+    }
+}
+function createSearchSelector(dataset) {
+    if (typeof dataset === 'function') {
+        return dataset;
+    }
+    else if (dataset instanceof RegExp) {
+        return (context) => {
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            const valueDataset = (0, activityValueParsers_1.parseValueDataset)(a.value);
+            const isSearch = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Invoke && (a === null || a === void 0 ? void 0 : a.name) === SEARCH_INVOKE_NAME;
+            if (isSearch && typeof (valueDataset === null || valueDataset === void 0 ? void 0 : valueDataset.dataset) === 'string') {
+                return Promise.resolve(dataset.test(valueDataset === null || valueDataset === void 0 ? void 0 : valueDataset.dataset));
+            }
+            else {
+                return Promise.resolve(false);
+            }
+        };
+    }
+    else {
+        return (context) => {
+            const a = context === null || context === void 0 ? void 0 : context.activity;
+            // const valueDataset = parseAdaptiveCardInvokeAction(a.value)
+            const isSearch = (a === null || a === void 0 ? void 0 : a.type) === agents_activity_1.ActivityTypes.Invoke && (a === null || a === void 0 ? void 0 : a.name) === SEARCH_INVOKE_NAME;
+            return Promise.resolve(isSearch);
+        };
+    }
+}
+async function sendInvokeResponse(context, response) {
+    await context.sendActivity({
+        value: { body: response, status: 200 },
+        type: agents_activity_1.ActivityTypes.InvokeResponse
+    });
+}
+//# sourceMappingURL=adaptiveCardsActions.js.map

package/dist/src/app/adaptiveCards/adaptiveCardsActions.js.map

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

package/dist/src/app/adaptiveCards/adaptiveCardsOptions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { AdaptiveCardActionExecuteResponseType } from './adaptiveCardActionExecuteResponseType';
+/**
+ * Configuration options for Adaptive Cards.
+ */
+export interface AdaptiveCardsOptions {
+    /**
+     * Specifies the filter key used for Action.Submit events.
+     * If not provided, a default filter key will be used.
+     */
+    actionSubmitFilter?: string;
+    /**
+     * Specifies the response type for Action.Execute events.
+     * Determines how the response is handled after an action is executed.
+     */
+    actionExecuteResponseType?: AdaptiveCardActionExecuteResponseType;
+}

package/dist/src/app/adaptiveCards/adaptiveCardsOptions.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adaptiveCardsOptions.js.map

package/dist/src/app/adaptiveCards/adaptiveCardsOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveCardsOptions.js","sourceRoot":"","sources":["../../../../src/app/adaptiveCards/adaptiveCardsOptions.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/app/adaptiveCards/adaptiveCardsSearchParams.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { z } from 'zod';
+/**
+ * Interface representing the search parameters for adaptive cards.
+ */
+export interface AdaptiveCardsSearchParams {
+    /**
+     * The text query for the search.
+     */
+    queryText: string;
+    /**
+     * The dataset to search within.
+     */
+    dataset: string;
+}
+/**
+ * Zod schema for validating AdaptiveCardsSearchParams.
+ */
+export declare const adaptiveCardsSearchParamsZodSchema: z.ZodObject<{
+    queryText: z.ZodString;
+    dataset: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    queryText: string;
+    dataset: string;
+}, {
+    queryText: string;
+    dataset: string;
+}>;

package/dist/src/app/adaptiveCards/adaptiveCardsSearchParams.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adaptiveCardsSearchParamsZodSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Zod schema for validating AdaptiveCardsSearchParams.
+ */
+exports.adaptiveCardsSearchParamsZodSchema = zod_1.z.object({
+    queryText: zod_1.z.string(),
+    dataset: zod_1.z.string(),
+});
+//# sourceMappingURL=adaptiveCardsSearchParams.js.map

package/dist/src/app/adaptiveCards/adaptiveCardsSearchParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveCardsSearchParams.js","sourceRoot":"","sources":["../../../../src/app/adaptiveCards/adaptiveCardsSearchParams.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6BAAuB;AAgBvB;;GAEG;AACU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAA"}

package/dist/src/app/adaptiveCards/index.d.ts

@@ -0,0 +1,3 @@
+export * from './adaptiveCardsActions';
+export * from './adaptiveCardsOptions';
+export * from './adaptiveCardActionExecuteResponseType';

package/dist/src/app/adaptiveCards/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./adaptiveCardsActions"), exports);
+__exportStar(require("./adaptiveCardsOptions"), exports);
+__exportStar(require("./adaptiveCardActionExecuteResponseType"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/app/adaptiveCards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/app/adaptiveCards/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAsC;AACtC,yDAAsC;AACtC,0EAAuD"}

package/dist/src/app/adaptiveCards/query.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+/**
+ * Represents a query with pagination and parameters.
+ * @template TParams - The type of the query parameters.
+ */
+export interface Query<TParams extends Record<string, any>> {
+    /**
+     * The number of items to retrieve.
+     */
+    count: number;
+    /**
+     * The number of items to skip.
+     */
+    skip: number;
+    /**
+     * The parameters for the query.
+     */
+    parameters: TParams;
+}

package/dist/src/app/adaptiveCards/query.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query.js.map

package/dist/src/app/adaptiveCards/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../src/app/adaptiveCards/query.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

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

@@ -3,17 +3,19 @@
  * Licensed under the MIT License.
  */
 import { Activity, ConversationReference } from '@microsoft/agents-activity';
-import { TurnState } from './turnState';
 import { BaseAdapter } from '../baseAdapter';
+import { ResourceResponse } from '../connector-client';
+import { TurnContext } from '../turnContext';
+import { AdaptiveCardsActions } from './adaptiveCards';
 import { AgentApplicationOptions } from './agentApplicationOptions';
-import { RouteSelector } from './routeSelector';
-import { RouteHandler } from './routeHandler';
-import { ConversationUpdateEvents } from './conversationUpdateEvents';
-import { TurnEvents } from './turnEvents';
 import { AppRoute } from './appRoute';
-import { TurnContext } from '../turnContext';
-import { ResourceResponse } from '../connector-client';
+import { ConversationUpdateEvents } from './conversationUpdateEvents';
+import { AgentExtension } from './extensions';
 import { Authorization } from './oauth/authorization';
+import { RouteHandler } from './routeHandler';
+import { RouteSelector } from './routeSelector';
+import { TurnEvents } from './turnEvents';
+import { TurnState } from './turnState';
 export type ApplicationEventHandler<TState extends TurnState> = (context: TurnContext, state: TState) => Promise<boolean>;
 /**
  * Executes the application logic for a given turn context.
@@ -40,6 +42,8 @@ export declare class AgentApplication<TState extends TurnState> {
     private readonly _adapter?;
     private readonly _authorization?;
     private _typingTimer;
+    protected readonly _extensions: AgentExtension<TState>[];
+    private readonly _adaptiveCards;
     constructor(options?: Partial<AgentApplicationOptions<TState>>);
     /**
      * Gets the adapter associated with the application.
@@ -56,6 +60,7 @@ export declare class AgentApplication<TState extends TurnState> {
      * @returns The application options.
      */
     get options(): AgentApplicationOptions<TState>;
+    get adaptiveCards(): AdaptiveCardsActions<TState>;
     /**
      * Sets an error handler for the application.
      *
@@ -95,7 +100,7 @@ export declare class AgentApplication<TState extends TurnState> {
      * );
      * ```
      */
-    addRoute(selector: RouteSelector, handler: RouteHandler<TState>): this;
+    addRoute(selector: RouteSelector, handler: RouteHandler<TState>, isInvokeRoute?: boolean): this;
     /**
      * Adds a handler for specific activity types.
      *
@@ -192,6 +197,48 @@ export declare class AgentApplication<TState extends TurnState> {
      * ```
      */
     onSignInSuccess(handler: (context: TurnContext, state: TurnState, id?: string) => void): this;
+    /**
+     * Adds a handler for message reaction added events.
+     *
+     * @param handler - The handler function that will be called when a message reaction is added.
+     * @returns The current instance of the application.
+     *
+     * @remarks
+     * This method registers a handler that will be invoked when a user adds a reaction to a message,
+     * such as a like, heart, or other emoji reaction.
+     *
+     * Example usage:
+     * ```typescript
+     * app.onMessageReactionAdded(async (context, state) => {
+     *   const reactionsAdded = context.activity.reactionsAdded;
+     *   if (reactionsAdded && reactionsAdded.length > 0) {
+     *     await context.sendActivity(`Thanks for your ${reactionsAdded[0].type} reaction!`);
+     *   }
+     * });
+     * ```
+     */
+    onMessageReactionAdded(handler: (context: TurnContext, state: TState) => Promise<void>): this;
+    /**
+     * Adds a handler for message reaction removed events.
+     *
+     * @param handler - The handler function that will be called when a message reaction is removed.
+     * @returns The current instance of the application.
+     *
+     * @remarks
+     * This method registers a handler that will be invoked when a user removes a reaction from a message,
+     * such as unliking or removing an emoji reaction.
+     *
+     * Example usage:
+     * ```typescript
+     * app.onMessageReactionRemoved(async (context, state) => {
+     *   const reactionsRemoved = context.activity.reactionsRemoved;
+     *   if (reactionsRemoved && reactionsRemoved.length > 0) {
+     *     await context.sendActivity(`You removed your ${reactionsRemoved[0].type} reaction.`);
+     *   }
+     * });
+     * ```
+     */
+    onMessageReactionRemoved(handler: (context: TurnContext, state: TState) => Promise<void>): this;
     /**
      * Executes the application logic for a given turn context.
      *
@@ -266,6 +313,7 @@ export declare class AgentApplication<TState extends TurnState> {
      * ```
      */
     startTypingTimer(context: TurnContext): void;
+    registerExtension<T extends AgentExtension<TState>>(extension: T, regcb: (ext: T) => void): void;
     /**
      * Stops the typing indicator timer if it's currently running.
      *