@microsoft/agents-hosting-extensions-teams 0.5.1-g2e246ff274

package/dist/src/messageExtension/messagingExtensionResponse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { MessagingExtensionResult } from './messagingExtensionResult';
+/**
+ * Represents the response of a messaging extension.
+ */
+export interface MessagingExtensionResponse {
+    /**
+     * The result of the compose extension.
+     */
+    composeExtension?: MessagingExtensionResult;
+    /**
+     * Cache information for the response.
+     */
+    cacheInfo?: unknown;
+}

package/dist/src/messageExtension/messagingExtensionResponse.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=messagingExtensionResponse.js.map

package/dist/src/messageExtension/messagingExtensionResponse.js.map

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

package/dist/src/messageExtension/messagingExtensionResult.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { Activity } from '@microsoft/agents-activity';
+import { MessagingExtensionAttachment } from './messagingExtensionAttachment';
+import { MessagingExtensionSuggestedAction } from './messagingExtensionSuggestedAction';
+/**
+ * Layout options for attachments.
+ */
+export type AttachmentLayout = 'list' | 'grid';
+/**
+ * Types of messaging extension results.
+ * - `result`: Represents a standard result.
+ * - `auth`: Represents an authentication request.
+ * - `config`: Represents a configuration request.
+ * - `message`: Represents a message result.
+ * - `botMessagePreview`: Represents a bot message preview.
+ * - `silentAuth`: Represents a silent authentication request.
+ */
+export type MessagingExtensionResultType = 'result' | 'auth' | 'config' | 'message' | 'botMessagePreview' | 'silentAuth';
+/**
+ * Represents the result of a messaging extension.
+ */
+export interface MessagingExtensionResult {
+    /**
+     * The layout of the attachments.
+     */
+    attachmentLayout?: AttachmentLayout;
+    /**
+     * The type of the result.
+     */
+    type?: MessagingExtensionResultType;
+    /**
+     * A list of attachments.
+     */
+    attachments?: MessagingExtensionAttachment[];
+    /**
+     * Suggested actions for the result.
+     */
+    suggestedActions?: MessagingExtensionSuggestedAction;
+    /**
+     * Text content of the result.
+     */
+    text?: string;
+    /**
+     * Preview of the activity.
+     */
+    activityPreview?: Activity;
+}

package/dist/src/messageExtension/messagingExtensionResult.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=messagingExtensionResult.js.map

package/dist/src/messageExtension/messagingExtensionResult.js.map

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

package/dist/src/messageExtension/messagingExtensionSuggestedAction.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { CardAction } from '@microsoft/agents-activity';
+/**
+ * Represents suggested actions for a messaging extension.
+ */
+export interface MessagingExtensionSuggestedAction {
+    /**
+     * A list of card actions.
+     */
+    actions?: CardAction[];
+}

package/dist/src/messageExtension/messagingExtensionSuggestedAction.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=messagingExtensionSuggestedAction.js.map

package/dist/src/messageExtension/messagingExtensionSuggestedAction.js.map

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

package/dist/src/messages/messages.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { AgentApplication, TurnContext, TurnState } from '@microsoft/agents-hosting';
+import { TaskModuleTaskInfo } from '../taskModule';
+/**
+ * Enum representing the names of message invoke actions.
+ *
+ * This enum is used to define the specific invoke actions that can be triggered
+ * in the context of message handling.
+ */
+export declare enum MessageInvokeNames {
+    /**
+     * Represents the action to fetch a task associated with a message.
+     */
+    FETCH_INVOKE_NAME = "message/fetchTask"
+}
+/**
+ * Handles message-related operations for Teams applications.
+ * Provides methods for handling message fetch operations.
+ * @template TState Type extending TurnState to be used by the application
+ */
+export declare class Messages<TState extends TurnState> {
+    private readonly _app;
+    /**
+     * Creates a new Messages instance.
+     * @param app The TeamsApplication instance to associate with this Messages instance
+     */
+    constructor(app: AgentApplication<TState>);
+    /**
+     * Handles fetch requests for messages in Teams, which typically occur when
+     * a message action is invoked.
+     *
+     * @template TData Type of data expected in the message fetch request
+     * @param handler Function to handle the message fetch request
+     * @returns The TeamsApplication instance for chaining
+     */
+    fetch<TData extends Record<string, any> = Record<string, any>>(handler: (context: TurnContext, state: TState, data: TData) => Promise<TaskModuleTaskInfo | string>): AgentApplication<TState>;
+}

package/dist/src/messages/messages.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = exports.MessageInvokeNames = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+/**
+ * Enum representing the names of message invoke actions.
+ *
+ * This enum is used to define the specific invoke actions that can be triggered
+ * in the context of message handling.
+ */
+var MessageInvokeNames;
+(function (MessageInvokeNames) {
+    /**
+     * Represents the action to fetch a task associated with a message.
+     */
+    MessageInvokeNames["FETCH_INVOKE_NAME"] = "message/fetchTask";
+})(MessageInvokeNames || (exports.MessageInvokeNames = MessageInvokeNames = {}));
+/**
+ * Handles message-related operations for Teams applications.
+ * Provides methods for handling message fetch operations.
+ * @template TState Type extending TurnState to be used by the application
+ */
+class Messages {
+    /**
+     * Creates a new Messages instance.
+     * @param app The TeamsApplication instance to associate with this Messages instance
+     */
+    constructor(app) {
+        this._app = app;
+    }
+    /**
+     * Handles fetch requests for messages in Teams, which typically occur when
+     * a message action is invoked.
+     *
+     * @template TData Type of data expected in the message fetch request
+     * @param handler Function to handle the message fetch request
+     * @returns The TeamsApplication instance for chaining
+     */
+    fetch(handler) {
+        this._app.addRoute(async (context) => {
+            var _a, _b;
+            return (((_a = context === null || context === void 0 ? void 0 : context.activity) === null || _a === void 0 ? void 0 : _a.type) === agents_activity_1.ActivityTypes.Invoke &&
+                ((_b = context === null || context === void 0 ? void 0 : context.activity) === null || _b === void 0 ? void 0 : _b.name) === MessageInvokeNames.FETCH_INVOKE_NAME);
+        }, async (context, state) => {
+            var _a, _b, _c;
+            if (((_a = context === null || context === void 0 ? void 0 : context.activity) === null || _a === void 0 ? void 0 : _a.channelId) === agents_activity_1.Channels.Msteams) {
+                const result = await handler(context, state, (_c = (_b = context.activity.value) === null || _b === void 0 ? void 0 : _b.data) !== null && _c !== void 0 ? _c : {});
+                if (!context.turnState.get(agents_hosting_1.INVOKE_RESPONSE_KEY)) {
+                    let response;
+                    if (typeof result === 'string') {
+                        response = {
+                            task: {
+                                type: 'message',
+                                value: result
+                            }
+                        };
+                    }
+                    else {
+                        response = {
+                            task: {
+                                type: 'continue',
+                                value: result
+                            }
+                        };
+                    }
+                    await context.sendActivity({
+                        value: { body: response, status: 200 },
+                        type: agents_activity_1.ActivityTypes.InvokeResponse
+                    });
+                }
+            }
+        }, true);
+        return this._app;
+    }
+}
+exports.Messages = Messages;
+//# sourceMappingURL=messages.js.map

package/dist/src/messages/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/messages/messages.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gEAA8E;AAC9E,8DAAyH;AAGzH;;;;;GAKG;AACH,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,6DAAuC,CAAA;AACzC,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B;AAED;;;;GAIG;AACH,MAAa,QAAQ;IAGnB;;;OAGG;IACH,YAAoB,GAA6B;QAC/C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CACV,OAAmG;QAEnG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAChB,KAAK,EAAE,OAAO,EAAE,EAAE;;YAChB,OAAO,CACL,CAAA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,0CAAE,IAAI,MAAK,+BAAa,CAAC,MAAM;gBACtC,CAAA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,0CAAE,IAAI,MAAK,kBAAkB,CAAC,iBAAiB,CAC3E,CAAA;QACH,CAAC,EACD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;;YACvB,IAAI,CAAA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,0CAAE,SAAS,MAAK,0BAAQ,CAAC,OAAO,EAAE,CAAC;gBACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAA,MAAC,OAAO,CAAC,QAAQ,CAAC,KAAe,0CAAE,IAAI,mCAAI,EAAW,CAAC,CAAA;gBAEpG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,oCAAmB,CAAC,EAAE,CAAC;oBAChD,IAAI,QAA4B,CAAA;oBAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAC/B,QAAQ,GAAG;4BACT,IAAI,EAAE;gCACJ,IAAI,EAAE,SAAS;gCACf,KAAK,EAAE,MAAM;6BACd;yBACF,CAAA;oBACH,CAAC;yBAAM,CAAC;wBACN,QAAQ,GAAG;4BACT,IAAI,EAAE;gCACJ,IAAI,EAAE,UAAU;gCAChB,KAAK,EAAE,MAAM;6BACd;yBACF,CAAA;oBACH,CAAC;oBAED,MAAM,OAAO,CAAC,YAAY,CAAC;wBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAoB;wBACxD,IAAI,EAAE,+BAAa,CAAC,cAAc;qBACvB,CAAC,CAAA;gBAChB,CAAC;YACH,CAAC;QACH,CAAC,EACD,IAAI,CACL,CAAA;QAED,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF;AA/DD,4BA+DC"}

package/dist/src/taskModule/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export * from './taskModuleContinueResponse';
+export * from './taskModuleMessageResponse';
+export * from './taskModuleRequest';
+export * from './taskModuleRequestContext';
+export * from './taskModuleResponse';
+export * from './taskModuleResponseBase';
+export * from './taskModuleTaskInfo';

package/dist/src/taskModule/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+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("./taskModuleContinueResponse"), exports);
+__exportStar(require("./taskModuleMessageResponse"), exports);
+__exportStar(require("./taskModuleRequest"), exports);
+__exportStar(require("./taskModuleRequestContext"), exports);
+__exportStar(require("./taskModuleResponse"), exports);
+__exportStar(require("./taskModuleResponseBase"), exports);
+__exportStar(require("./taskModuleTaskInfo"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/taskModule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/taskModule/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,+DAA4C;AAC5C,8DAA2C;AAC3C,sDAAmC;AACnC,6DAA0C;AAC1C,uDAAoC;AACpC,2DAAwC;AACxC,uDAAoC"}

package/dist/src/taskModule/taskModule.d.ts

@@ -0,0 +1,72 @@
+import { AgentApplication, RouteHandler, RouteSelector, TurnContext, TurnState } from '@microsoft/agents-hosting';
+import { TaskModuleTaskInfo } from './taskModuleTaskInfo';
+export declare enum TaskModuleInvokeNames {
+    CONFIG_FETCH_INVOKE_NAME = "config/fetch",
+    CONFIG_SUBMIT_INVOKE_NAME = "config/submit",
+    FETCH_INVOKE_NAME = "task/fetch",
+    SUBMIT_INVOKE_NAME = "task/submit",
+    DEFAULT_TASK_DATA_FILTER = "verb"
+}
+interface TaskModuleOptions {
+    taskDataFilter?: string;
+}
+/**
+ * Class that exposes Teams task module-related events.
+ * Provides an organized way to handle task module operations in Microsoft Teams.
+ */
+export declare class TaskModule<TState extends TurnState> {
+    _app: AgentApplication<TState>;
+    _options: TaskModuleOptions;
+    /**
+     * Creates a new instance of the TaskModule class.
+     * @param app - The agent application
+     */
+    constructor(app: AgentApplication<TState>, options?: TaskModuleOptions);
+    /**
+     * Handles task module fetch events. These occur when a task module is requested to be displayed.
+     * @param handler - The handler to call when a task module fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onFetch(handler: RouteHandler<TurnState>): this;
+    /**
+       * Registers a handler to process the submission of a task module.
+       * @remarks
+       * Handlers should respond with another TaskInfo object, message string, or `null` to indicate
+       * the task is completed.
+       * @template TData Optional. Type of the data object being passed to the handler.
+       * @param {string | RegExp | RouteSelector | string[] | RegExp[] | RouteSelector[]} verb - Name of the verb(s) to register the handler for.
+       * @param {(context: TurnContext, state: TState, data: TData) => Promise<TaskModuleTaskInfo | string | null | undefined>} handler - Function to call when the handler is triggered.
+       * @param {TurnContext} handler.context - Context for the current turn of conversation with the user.
+       * @param {TState} handler.state - Current state of the turn.
+       * @param {TData} handler.data - Data object passed to the handler.
+       * @returns {Application<TState>} The application for chaining purposes.
+       */
+    submit<TData extends Record<string, any> = Record<string, any>>(verb: string | RegExp | RouteSelector | (string | RegExp | RouteSelector)[], handler: (context: TurnContext, state: TState, data: TData) => Promise<TaskModuleTaskInfo | string | null | undefined>): AgentApplication<TState>;
+    /**
+     * Handles specific task module fetch events based on a verb/action.
+     * @param verb - The verb or action identifier to match against in the task module data
+     * @param handler - The handler to call when a matching task module fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onFetchByVerb(verb: string, handler: RouteHandler<TurnState>): this;
+    /**
+     * Handles specific task module submit events based on a verb/action.
+     * @param verb - The verb or action identifier to match against in the task module data
+     * @param handler - The handler to call when a matching task module submit event occurs
+     * @returns this (for method chaining)
+     */
+    onSubmitByVerb(verb: string, handler: RouteHandler<TurnState>): this;
+    /**
+     * Handles configuration fetch events. These occur when an agent configuration is requested.
+     * @param handler - The handler to call when a configuration fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onConfigurationFetch(handler: RouteHandler<TurnState>): this;
+    /**
+     * Handles configuration submit events. These occur when an agent configuration is submitted.
+     * @param handler - The handler to call when a configuration submit event occurs
+     * @returns this (for method chaining)
+     */
+    onConfigurationSubmit(handler: RouteHandler<TurnState>): this;
+}
+export {};

package/dist/src/taskModule/taskModule.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskModule = exports.TaskModuleInvokeNames = void 0;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+var TaskModuleInvokeNames;
+(function (TaskModuleInvokeNames) {
+    TaskModuleInvokeNames["CONFIG_FETCH_INVOKE_NAME"] = "config/fetch";
+    TaskModuleInvokeNames["CONFIG_SUBMIT_INVOKE_NAME"] = "config/submit";
+    TaskModuleInvokeNames["FETCH_INVOKE_NAME"] = "task/fetch";
+    TaskModuleInvokeNames["SUBMIT_INVOKE_NAME"] = "task/submit";
+    TaskModuleInvokeNames["DEFAULT_TASK_DATA_FILTER"] = "verb";
+})(TaskModuleInvokeNames || (exports.TaskModuleInvokeNames = TaskModuleInvokeNames = {}));
+/**
+ * Class that exposes Teams task module-related events.
+ * Provides an organized way to handle task module operations in Microsoft Teams.
+ */
+class TaskModule {
+    /**
+     * Creates a new instance of the TaskModule class.
+     * @param app - The agent application
+     */
+    constructor(app, options) {
+        this._options = options !== null && options !== void 0 ? options : { taskDataFilter: TaskModuleInvokeNames.DEFAULT_TASK_DATA_FILTER };
+        this._app = app;
+    }
+    /**
+     * Handles task module fetch events. These occur when a task module is requested to be displayed.
+     * @param handler - The handler to call when a task module fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onFetch(handler) {
+        const routeSel = (context) => {
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'task/fetch');
+        };
+        this._app.addRoute(routeSel, handler, true); // Invoke requires true
+        return this;
+    }
+    /**
+       * Registers a handler to process the submission of a task module.
+       * @remarks
+       * Handlers should respond with another TaskInfo object, message string, or `null` to indicate
+       * the task is completed.
+       * @template TData Optional. Type of the data object being passed to the handler.
+       * @param {string | RegExp | RouteSelector | string[] | RegExp[] | RouteSelector[]} verb - Name of the verb(s) to register the handler for.
+       * @param {(context: TurnContext, state: TState, data: TData) => Promise<TaskModuleTaskInfo | string | null | undefined>} handler - Function to call when the handler is triggered.
+       * @param {TurnContext} handler.context - Context for the current turn of conversation with the user.
+       * @param {TState} handler.state - Current state of the turn.
+       * @param {TData} handler.data - Data object passed to the handler.
+       * @returns {Application<TState>} The application for chaining purposes.
+       */
+    submit(verb, handler) {
+        (Array.isArray(verb) ? verb : [verb]).forEach((v) => {
+            var _a;
+            const { DEFAULT_TASK_DATA_FILTER, SUBMIT_INVOKE_NAME } = TaskModuleInvokeNames;
+            const filterField = (_a = this._options.taskDataFilter) !== null && _a !== void 0 ? _a : DEFAULT_TASK_DATA_FILTER;
+            const selector = createTaskSelector(v, filterField, SUBMIT_INVOKE_NAME);
+            this._app.addRoute(selector, async (context, state) => {
+                var _a, _b, _c, _d, _e;
+                if (((_a = context === null || context === void 0 ? void 0 : context.activity) === null || _a === void 0 ? void 0 : _a.channelId) === agents_activity_1.Channels.Msteams) {
+                    if (((_b = context === null || context === void 0 ? void 0 : context.activity) === null || _b === void 0 ? void 0 : _b.type) !== agents_activity_1.ActivityTypes.Invoke || ((_c = context === null || context === void 0 ? void 0 : context.activity) === null || _c === void 0 ? void 0 : _c.name) !== SUBMIT_INVOKE_NAME) {
+                        throw new Error(`Unexpected TaskModules.submit() triggered for activity type: ${(_d = context === null || context === void 0 ? void 0 : context.activity) === null || _d === void 0 ? void 0 : _d.type}`);
+                    }
+                    const result = await handler(context, state, (_e = context.activity.value.data) !== null && _e !== void 0 ? _e : {});
+                    if (!result) {
+                        await context.sendActivity(agents_activity_1.Activity.fromObject({
+                            value: { status: 200 },
+                            type: agents_activity_1.ActivityTypes.InvokeResponse
+                        }));
+                    }
+                    if (!context.turnState.get(agents_hosting_1.INVOKE_RESPONSE_KEY)) {
+                        let response;
+                        if (typeof result === 'string') {
+                            response = {
+                                task: {
+                                    type: 'message',
+                                    value: result
+                                }
+                            };
+                        }
+                        else if (typeof result === 'object') {
+                            // Return card
+                            response = {
+                                task: {
+                                    type: 'continue',
+                                    value: result
+                                }
+                            };
+                        }
+                        // Queue up invoke response
+                        await context.sendActivity(agents_activity_1.Activity.fromObject({
+                            value: { body: response, status: 200 },
+                            type: agents_activity_1.ActivityTypes.InvokeResponse
+                        }));
+                    }
+                }
+            }, true);
+        });
+        return this._app;
+    }
+    /**
+     * Handles specific task module fetch events based on a verb/action.
+     * @param verb - The verb or action identifier to match against in the task module data
+     * @param handler - The handler to call when a matching task module fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onFetchByVerb(verb, handler) {
+        const routeSel = (context) => {
+            var _a;
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'task/fetch' &&
+                // @ts-ignore
+                ((_a = context.activity.value) === null || _a === void 0 ? void 0 : _a.data) === verb);
+        };
+        this._app.addRoute(routeSel, handler, true);
+        return this;
+    }
+    /**
+     * Handles specific task module submit events based on a verb/action.
+     * @param verb - The verb or action identifier to match against in the task module data
+     * @param handler - The handler to call when a matching task module submit event occurs
+     * @returns this (for method chaining)
+     */
+    onSubmitByVerb(verb, handler) {
+        const routeSel = (context) => {
+            var _a;
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'task/submit' &&
+                // @ts-ignore
+                ((_a = context.activity.value) === null || _a === void 0 ? void 0 : _a.data) === verb);
+        };
+        this._app.addRoute(routeSel, handler, true);
+        return this;
+    }
+    /**
+     * Handles configuration fetch events. These occur when an agent configuration is requested.
+     * @param handler - The handler to call when a configuration fetch event occurs
+     * @returns this (for method chaining)
+     */
+    onConfigurationFetch(handler) {
+        const routeSel = (context) => {
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'config/fetch');
+        };
+        this._app.addRoute(routeSel, handler, true);
+        return this;
+    }
+    /**
+     * Handles configuration submit events. These occur when an agent configuration is submitted.
+     * @param handler - The handler to call when a configuration submit event occurs
+     * @returns this (for method chaining)
+     */
+    onConfigurationSubmit(handler) {
+        const routeSel = (context) => {
+            return Promise.resolve(context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+                context.activity.channelId === 'msteams' &&
+                context.activity.name === 'config/submit');
+        };
+        this._app.addRoute(routeSel, handler, true);
+        return this;
+    }
+}
+exports.TaskModule = TaskModule;
+/**
+ * Creates a route selector function for a given verb, filter field, and invoke name.
+ * @param {string | RegExp | RouteSelector} verb - The verb to match.
+ * @param {string} filterField - The field to use for filtering.
+ * @param {string} invokeName - The name of the invoke action.
+ * @returns {RouteSelector} The route selector function.
+ * @private
+ * @remarks
+ * This function is used to create a route selector function for a given verb, filter field, and invoke name.
+ * The route selector function is used to match incoming requests to the appropriate handler function.
+ */
+function createTaskSelector(verb, filterField, invokeName) {
+    if (typeof verb === 'function') {
+        // Return the passed in selector function
+        return verb;
+    }
+    else if (verb instanceof RegExp) {
+        // Return a function that matches the verb using a RegExp
+        return (context) => {
+            var _a, _b, _c;
+            const isTeams = context.activity.channelId === agents_activity_1.Channels.Msteams;
+            const isInvoke = ((_a = context === null || context === void 0 ? void 0 : context.activity) === null || _a === void 0 ? void 0 : _a.type) === agents_activity_1.ActivityTypes.Invoke && ((_b = context === null || context === void 0 ? void 0 : context.activity) === null || _b === void 0 ? void 0 : _b.name) === invokeName;
+            const data = ((_c = context === null || context === void 0 ? void 0 : context.activity) === null || _c === void 0 ? void 0 : _c.value).data;
+            if (isInvoke && isTeams && typeof data === 'object' && typeof data[filterField] === 'string') {
+                return Promise.resolve(verb.test(data[filterField]));
+            }
+            else {
+                return Promise.resolve(false);
+            }
+        };
+    }
+    else {
+        // Return a function that attempts to match verb
+        return (context) => {
+            var _a, _b, _c;
+            const isInvoke = ((_a = context === null || context === void 0 ? void 0 : context.activity) === null || _a === void 0 ? void 0 : _a.type) === agents_activity_1.ActivityTypes.Invoke && ((_b = context === null || context === void 0 ? void 0 : context.activity) === null || _b === void 0 ? void 0 : _b.name) === invokeName;
+            const data = ((_c = context === null || context === void 0 ? void 0 : context.activity) === null || _c === void 0 ? void 0 : _c.value).data;
+            return Promise.resolve(isInvoke && typeof data === 'object' && data[filterField] === verb);
+        };
+    }
+}
+//# sourceMappingURL=taskModule.js.map

package/dist/src/taskModule/taskModule.js.map

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

package/dist/src/taskModule/taskModuleContinueResponse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { TaskModuleResponseBase } from './taskModuleResponseBase';
+import { TaskModuleTaskInfo } from './taskModuleTaskInfo';
+/**
+ * Interface representing the continue response of a task module.
+ */
+export interface TaskModuleContinueResponse extends TaskModuleResponseBase {
+    /**
+     * The task module task information.
+     */
+    value?: TaskModuleTaskInfo;
+}

package/dist/src/taskModule/taskModuleContinueResponse.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=taskModuleContinueResponse.js.map

package/dist/src/taskModule/taskModuleContinueResponse.js.map

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

package/dist/src/taskModule/taskModuleMessageResponse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { TaskModuleResponseBase } from './taskModuleResponseBase';
+/**
+ * Interface representing the message response of a task module.
+ */
+export interface TaskModuleMessageResponse extends TaskModuleResponseBase {
+    /**
+     * The value of the task module message response.
+     */
+    value?: string;
+}

package/dist/src/taskModule/taskModuleMessageResponse.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=taskModuleMessageResponse.js.map

package/dist/src/taskModule/taskModuleMessageResponse.js.map

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