@microsoft/agents-hosting-extensions-msteams 1.7.0-beta.8.gc2b086aef6

package/README.md

@@ -0,0 +1,147 @@
+# @microsoft/agents-hosting-extensions-msteams
+
+Microsoft Teams extension for the Microsoft 365 Agents SDK for JavaScript.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-hosting-extensions-msteams
+```
+
+## Overview
+
+This package provides Teams-specific functionality for building agents in Microsoft Teams. It includes support for:
+
+- Message handling (edit, delete, undelete)
+- Meeting events (start, end, participant join/leave)
+- Message reactions (added/removed)
+- Message extensions and task modules
+- Teams information access
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { AgentApplication, MemoryStorage, TurnContext, TurnState } from '@microsoft/agents-hosting'
+import { startServer } from '@microsoft/agents-hosting-express'
+import { TeamsAgentExtension } from '@microsoft/agents-hosting-extensions-msteams'
+
+// Create the agent application
+const app = new AgentApplication<TurnState>({ storage: new MemoryStorage() })
+
+// Create and register the Teams extension
+const teamsExt = new TeamsAgentExtension(app)
+
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  // Configure Teams-specific handlers here
+  console.log('Teams extension registered')
+})
+
+// Handle messages
+app.onActivity('message', async (context: TurnContext, state: TurnState) => {
+  await context.sendActivity(`I received your message: "${context.activity.text}"`)
+})
+
+// Start the server
+startServer(app)
+```
+
+### Meeting Events
+
+Handle various meeting events in Teams:
+
+```typescript
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  tae.meetings
+    .onStart(async (context, state) => {
+      await context.sendActivity('Meeting started! I\'m here to assist.')
+    })
+    .onEnd(async (context, state) => {
+      await context.sendActivity('The meeting has ended. Thanks for participating!')
+    })
+    .onParticipantsJoin(async (context, state) => {
+      await context.sendActivity('Welcome to the meeting!')
+    })
+    .onParticipantsLeave(async (context, state) => {
+      await context.sendActivity('Goodbye from the meeting!')
+    })
+})
+```
+
+### Message Handling
+
+Handle message events in Teams:
+
+```typescript
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  tae.messages
+  .onMessageEdit(async (context, state) => {
+    await context.sendActivity('I noticed you edited your message.')
+  })
+
+  tae.onMessageDelete(async (context, state) => {
+    await context.sendActivity('I noticed you deleted a message.')
+  })
+
+  tae.onMessageUndelete(async (context, state) => {
+    await context.sendActivity('I noticed you undeleted a message.')
+  })
+})
+```
+
+### Message Extensions
+
+Work with Teams message extensions:
+
+```typescript
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  tae.messageExtensions
+    .onQuery(async (context, state) => {
+      // Handle message extension query
+      return {
+        composeExtension: {
+          type: 'result',
+          attachmentLayout: 'list',
+          attachments: [
+            // Your card attachments here
+          ]
+        }
+      }
+    })
+    .onSelectItem(async (context, state) => {
+      // Handle item selection
+    })
+})
+```
+
+### Task Modules
+
+Handle Teams task modules:
+
+```typescript
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  tae.taskModules
+    .onFetch('simple_form', async (context, state, request) => {
+      return {
+        task: {
+          type: 'message',
+          value: 'Open task module'
+        }
+      }
+    })
+    .onSubmit('simple_form', async (context, state, request) => {
+      return {
+        task: {
+          type: 'message',
+          value: 'Task module submitted'
+        }
+      }
+    })
+})
+```
+
+## License
+
+MIT
+

package/dist/package.json

@@ -0,0 +1,46 @@
+{
+    "$schema": "https://json.schemastore.org/package.json",
+    "name": "@microsoft/agents-hosting-extensions-msteams",
+    "version": "1.7.0-beta.8.gc2b086aef6",
+    "homepage": "https://github.com/microsoft/Agents-for-js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/microsoft/Agents-for-js.git"
+    },
+    "author": {
+        "name": "Microsoft",
+        "email": "agentssdk@microsoft.com",
+        "url": "https://aka.ms/Agents"
+    },
+    "description": "Microsoft 365 Agents SDK for JavaScript. MS Teams extensions",
+    "keywords": [
+        "Agents"
+    ],
+    "main": "dist/src/index.js",
+    "types": "dist/src/index.d.ts",
+    "dependencies": {
+        "@microsoft/agents-activity": "1.7.0-beta.8.gc2b086aef6",
+        "@microsoft/agents-hosting": "1.7.0-beta.8.gc2b086aef6",
+        "@microsoft/microsoft-graph-client": "3.0.7",
+        "@microsoft/teams.api": "2.0.14",
+        "zod": "3.25.75"
+    },
+    "license": "MIT",
+    "files": [
+        "README.md",
+        "dist/package.json",
+        "dist/src",
+        "src",
+        "package.json"
+    ],
+    "exports": {
+        ".": {
+            "import": "./dist/src/index.js",
+            "require": "./dist/src/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    }
+}

package/dist/src/activity-extensions/index.d.ts

@@ -0,0 +1 @@
+export { parseTeamsChannelData } from './teamsChannelData';

package/dist/src/activity-extensions/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTeamsChannelData = void 0;
+var teamsChannelData_1 = require("./teamsChannelData");
+Object.defineProperty(exports, "parseTeamsChannelData", { enumerable: true, get: function () { return teamsChannelData_1.parseTeamsChannelData; } });
+//# sourceMappingURL=index.js.map

package/dist/src/activity-extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/activity-extensions/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAElC,uDAA0D;AAAjD,yHAAA,qBAAqB,OAAA"}

package/dist/src/activity-extensions/teamsChannelData.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { ChannelData } from '@microsoft/teams.api';
+/**
+ * Parses the given object as Teams ChannelData.
+ *
+ * @param {unknown} o - The value to parse.
+ * @returns {ChannelData} - The parsed ChannelData.
+ */
+export declare function parseTeamsChannelData(o: unknown): ChannelData;

package/dist/src/activity-extensions/teamsChannelData.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Copyright(c) Microsoft Corporation.All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTeamsChannelData = parseTeamsChannelData;
+const zod_1 = require("zod");
+/**
+ * Root-level validation for Teams channel data objects.
+ *
+ * The Teams SDK already defines the nested ChannelData shape. This parser
+ * normalizes missing root data to an empty object, verifies non-nullish input is
+ * an object, and preserves all properties as-is.
+ */
+const teamsChannelDataZodSchema = zod_1.z.object({}).passthrough();
+/**
+ * Parses the given object as Teams ChannelData.
+ *
+ * @param {unknown} o - The value to parse.
+ * @returns {ChannelData} - The parsed ChannelData.
+ */
+function parseTeamsChannelData(o) {
+    if (o == null) {
+        return {};
+    }
+    return teamsChannelDataZodSchema.parse(o);
+}
+//# sourceMappingURL=teamsChannelData.js.map

package/dist/src/activity-extensions/teamsChannelData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teamsChannelData.js","sourceRoot":"","sources":["../../../src/activity-extensions/teamsChannelData.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAoBH,sDAMC;AAxBD,6BAAuB;AAGvB;;;;;;GAMG;AACH,MAAM,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AAE5D;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAE,CAAU;IAC/C,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACd,OAAO,EAAiB,CAAA;IAC1B,CAAC;IAED,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAgB,CAAA;AAC1D,CAAC"}

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

@@ -0,0 +1 @@
+export * from './teamsAppExtensions';

package/dist/src/app/index.js

@@ -0,0 +1,20 @@
+"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("./teamsAppExtensions"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/index.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;;;;;;;;;;;;;;AAElC,uDAAoC"}

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

@@ -0,0 +1,145 @@
+import { AgentApplication, ConversationUpdateEvents, RouteSelector, TurnState } from '@microsoft/agents-hosting';
+import { TeamsRouteHandler } from '../teamsRouteHandler';
+import { TeamsTurnContext } from '../teamsTurnContext';
+/**
+ * Value submitted by a Teams feedback loop action.
+ */
+export interface FeedbackActionValue {
+    /**
+     * Feedback reaction selected by the user.
+     */
+    reaction?: string;
+    /**
+     * Optional feedback text or structured feedback data.
+     */
+    feedback?: string | Record<string, unknown>;
+}
+/**
+ * Payload supplied to Teams feedback loop handlers.
+ */
+export interface FeedbackData {
+    /**
+     * Name of the submitted action.
+     */
+    actionName?: string;
+    /**
+     * Value submitted with the feedback action.
+     */
+    actionValue?: FeedbackActionValue;
+    /**
+     * ID of the activity that the feedback applies to.
+     */
+    replyToId?: string;
+}
+/**
+ * Handler for Teams handoff invoke activities.
+ */
+export type TeamsHandoffHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, continuation: string) => Promise<void>;
+/**
+ * Handler for Teams feedback loop invoke activities.
+ */
+export type TeamsFeedbackLoopHandler<TState extends TurnState> = (context: TeamsTurnContext, state: TState, feedbackData: FeedbackData) => Promise<void>;
+/**
+ * Registers a route that handles Teams activities by activity type.
+ *
+ * @param app - The agent application that receives the route.
+ * @param type - Activity type or regular expression to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsActivity<TState extends TurnState>(app: AgentApplication<TState>, type: string | RegExp, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams conversation update activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param event - Conversation update event name to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsConversationUpdate<TState extends TurnState>(app: AgentApplication<TState>, event: ConversationUpdateEvents | string, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams message activities by text.
+ *
+ * @param app - The agent application that receives the route.
+ * @param text - Message text or regular expression to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsMessage<TState extends TurnState>(app: AgentApplication<TState>, text: string | RegExp, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams event activities by event name.
+ *
+ * @param app - The agent application that receives the route.
+ * @param name - Event name or regular expression to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsEvent<TState extends TurnState>(app: AgentApplication<TState>, name: string | RegExp, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams event activities by custom selector.
+ *
+ * @param app - The agent application that receives the route.
+ * @param selector - Selector used to decide whether the route should run.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsEvent<TState extends TurnState>(app: AgentApplication<TState>, selector: RouteSelector, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams message reaction added activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsMessageReactionsAdded<TState extends TurnState>(app: AgentApplication<TState>, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams message reaction removed activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsMessageReactionsRemoved<TState extends TurnState>(app: AgentApplication<TState>, handler: TeamsRouteHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams handoff invoke activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with the handoff continuation value.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsHandoff<TState extends TurnState>(app: AgentApplication<TState>, handler: TeamsHandoffHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;
+/**
+ * Registers a route that handles Teams feedback loop invoke activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with feedback loop data.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+export declare function onTeamsFeedbackLoop<TState extends TurnState>(app: AgentApplication<TState>, handler: TeamsFeedbackLoopHandler<TState>, rank?: number, authHandlers?: string[], isAgenticRoute?: boolean): AgentApplication<TState>;

package/dist/src/app/teamsAppExtensions.js

@@ -0,0 +1,201 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onTeamsActivity = onTeamsActivity;
+exports.onTeamsConversationUpdate = onTeamsConversationUpdate;
+exports.onTeamsMessage = onTeamsMessage;
+exports.onTeamsEvent = onTeamsEvent;
+exports.onTeamsMessageReactionsAdded = onTeamsMessageReactionsAdded;
+exports.onTeamsMessageReactionsRemoved = onTeamsMessageReactionsRemoved;
+exports.onTeamsHandoff = onTeamsHandoff;
+exports.onTeamsFeedbackLoop = onTeamsFeedbackLoop;
+const agents_activity_1 = require("@microsoft/agents-activity");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
+const teamsRouteHandler_1 = require("../teamsRouteHandler");
+const teamsTurnContext_1 = require("../teamsTurnContext");
+function isTeamsRouteContext(context, isAgenticRoute) {
+    return context.activity.channelId === agents_activity_1.Channels.Msteams &&
+        (!isAgenticRoute || (isAgenticRoute && context.activity.isAgenticRequest()));
+}
+function matchesValue(actual, expected) {
+    if (typeof expected === 'string') {
+        return expected.toLocaleLowerCase() === (actual === null || actual === void 0 ? void 0 : actual.toLocaleLowerCase());
+    }
+    return actual != null && expected.test(actual);
+}
+function addTeamsRoute(app, selector, handler, isInvokeRoute, rank, authHandlers, isAgenticRoute) {
+    return app.addRoute(selector, handler, isInvokeRoute, rank, authHandlers, isAgenticRoute);
+}
+function addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute) {
+    return addTeamsRoute(app, selector, (0, teamsRouteHandler_1.createTeamsRouteHandler)(handler), false, rank, authHandlers, isAgenticRoute);
+}
+function createInvokeResponse() {
+    const invokeResponse = new agents_activity_1.Activity(agents_activity_1.ActivityTypes.InvokeResponse);
+    invokeResponse.value = { status: 200 };
+    return invokeResponse;
+}
+/**
+ * Registers a route that handles Teams activities by activity type.
+ *
+ * @param app - The agent application that receives the route.
+ * @param type - Activity type or regular expression to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsActivity(app, type, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => isTeamsRouteContext(context, isAgenticRoute) &&
+        matchesValue(context.activity.type, type);
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams conversation update activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param event - Conversation update event name to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsConversationUpdate(app, event, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => {
+        if (!isTeamsRouteContext(context, isAgenticRoute) ||
+            context.activity.type !== agents_activity_1.ActivityTypes.ConversationUpdate) {
+            return false;
+        }
+        if (event === 'membersAdded') {
+            return Array.isArray(context.activity.membersAdded) && context.activity.membersAdded.length > 0;
+        }
+        if (event === 'membersRemoved') {
+            return Array.isArray(context.activity.membersRemoved) && context.activity.membersRemoved.length > 0;
+        }
+        return true;
+    };
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams message activities by text.
+ *
+ * @param app - The agent application that receives the route.
+ * @param text - Message text or regular expression to match.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsMessage(app, text, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => isTeamsRouteContext(context, isAgenticRoute) &&
+        context.activity.type === agents_activity_1.ActivityTypes.Message &&
+        matchesValue(context.activity.text, text);
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+function onTeamsEvent(app, nameOrSelector, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => {
+        if (!isTeamsRouteContext(context, isAgenticRoute) ||
+            context.activity.type !== agents_activity_1.ActivityTypes.Event) {
+            return false;
+        }
+        if (typeof nameOrSelector === 'function') {
+            return await nameOrSelector(context);
+        }
+        return matchesValue(context.activity.name, nameOrSelector);
+    };
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams message reaction added activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsMessageReactionsAdded(app, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => isTeamsRouteContext(context, isAgenticRoute) &&
+        context.activity.type === agents_activity_1.ActivityTypes.MessageReaction &&
+        Array.isArray(context.activity.reactionsAdded) &&
+        context.activity.reactionsAdded.length > 0;
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams message reaction removed activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with a Teams turn context and turn state.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsMessageReactionsRemoved(app, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => isTeamsRouteContext(context, isAgenticRoute) &&
+        context.activity.type === agents_activity_1.ActivityTypes.MessageReaction &&
+        Array.isArray(context.activity.reactionsRemoved) &&
+        context.activity.reactionsRemoved.length > 0;
+    return addTeamsRouteHandler(app, selector, handler, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams handoff invoke activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with the handoff continuation value.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsHandoff(app, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => {
+        var _a;
+        return isTeamsRouteContext(context, isAgenticRoute) &&
+            context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+            ((_a = context.activity.name) === null || _a === void 0 ? void 0 : _a.toLocaleLowerCase()) === 'handoff/action';
+    };
+    const routeHandler = async (context, state) => {
+        const value = context.activity.value;
+        const continuation = typeof (value === null || value === void 0 ? void 0 : value.continuation) === 'string'
+            ? value.continuation
+            : typeof (value === null || value === void 0 ? void 0 : value.Continuation) === 'string' ? value.Continuation : '';
+        await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, continuation);
+        await context.sendActivity(createInvokeResponse());
+    };
+    return addTeamsRoute(app, selector, routeHandler, true, rank, authHandlers, isAgenticRoute);
+}
+/**
+ * Registers a route that handles Teams feedback loop invoke activities.
+ *
+ * @param app - The agent application that receives the route.
+ * @param handler - Handler invoked with feedback loop data.
+ * @param rank - Optional route rank used for route ordering.
+ * @param authHandlers - Optional authorization handlers required by the route.
+ * @param isAgenticRoute - Indicates whether the route should handle agentic requests only.
+ * @returns The agent application for chaining.
+ */
+function onTeamsFeedbackLoop(app, handler, rank = agents_hosting_1.RouteRank.Unspecified, authHandlers = [], isAgenticRoute = false) {
+    const selector = async (context) => {
+        var _a;
+        const actionName = (_a = context.activity.value) === null || _a === void 0 ? void 0 : _a.actionName;
+        return isTeamsRouteContext(context, isAgenticRoute) &&
+            context.activity.type === agents_activity_1.ActivityTypes.Invoke &&
+            context.activity.name === 'message/submitAction' &&
+            actionName === 'feedback';
+    };
+    const routeHandler = async (context, state) => {
+        const feedbackData = {
+            ...context.activity.value,
+            replyToId: context.activity.replyToId
+        };
+        await handler(new teamsTurnContext_1.TeamsTurnContext(context), state, feedbackData);
+        await context.sendActivity(createInvokeResponse());
+    };
+    return addTeamsRoute(app, selector, routeHandler, true, rank, authHandlers, isAgenticRoute);
+}
+//# sourceMappingURL=teamsAppExtensions.js.map

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

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

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

@@ -0,0 +1 @@
+export * from './teamsChannel';