@microsoft/agents-hosting-extensions-teams 0.6.21-g3c2261b2fc → 1.0.15

package/src/teamsAgentExtension.ts

@@ -4,23 +4,14 @@ import { AgentApplication, AgentExtension, RouteHandler, RouteSelector, TurnCont
 import { parseTeamsChannelData } from './activity-extensions/teamsChannelDataParser'
 import { MessageExtension } from './messageExtension/messageExtension'
 import { TaskModule } from './taskModule/taskModule'
+import { FeedbackLoopData } from './feedbackLoopData'
 
-/**
- * Microsoft Teams-specific extension for agent applications that provides event handlers and functionality
- * for Teams-specific activities such as message operations, member management, channel operations, and team lifecycle events.
- * @template TState The type of turn state, extending TurnState
- */
 export class TeamsAgentExtension<TState extends TurnState = TurnState> extends AgentExtension<TState> {
-  _app: AgentApplication<TState>
-  _meeting: Meeting<TState>
-  _messageExtension: MessageExtension<TState>
-  _taskModule: TaskModule<TState>
-
-  /**
-   * Creates a new instance of TeamsAgentExtension.
-   * @param app The agent application instance to extend with Teams functionality
-   */
-  constructor (private app: AgentApplication<TState>) {
+  private _app: AgentApplication<TState>
+  private _meeting: Meeting<TState>
+  private _messageExtension: MessageExtension<TState>
+  private _taskModule: TaskModule<TState>
+  constructor (app: AgentApplication<TState>) {
     super('msteams')
     this._app = app
     this._meeting = new Meeting(app)
@@ -28,36 +19,32 @@ export class TeamsAgentExtension<TState extends TurnState = TurnState> extends A
     this._taskModule = new TaskModule(app)
   }
 
-  /**
-   * Gets the meeting functionality for handling Teams meeting-related activities.
-   * @returns The Meeting instance for this extension
-   */
   public get meeting (): Meeting<TState> {
     return this._meeting
   }
 
-  /**
-   * Gets the message extension functionality for handling Teams message extension activities.
-   * @returns The MessageExtension instance for this extension
-   */
   public get messageExtension (): MessageExtension<TState> {
     return this._messageExtension
   }
 
-  /**
-   * Gets the task module functionality for handling Teams task module activities.
-   * @returns The TaskModule instance for this extension
-   */
   public get taskModule (): TaskModule<TState> {
     return this._taskModule
   }
 
-  /**
-   * Registers a handler for message edit events in Teams.
-   * @param handler The route handler to execute when a message is edited
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onMessageEdit = (handler: RouteHandler<TurnState>) => {
+  onFeedback (handler: RouteHandler<TurnState>) {
+    const routeSel: RouteSelector = (context: TurnContext) => {
+      return Promise.resolve(
+        context.activity.type === ActivityTypes.Invoke &&
+        context.activity.channelId === 'msteams' &&
+        context.activity.name === 'message/submitAction' &&
+        (context.activity.value as FeedbackLoopData).actionName === 'feedback'
+      )
+    }
+    this._app.addRoute(routeSel, handler, true) // Invoke requires true
+    return this
+  }
+
+  onMessageEdit (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(!!(context.activity.type === ActivityTypes.MessageUpdate && channelData?.eventType === 'editMessage'))
@@ -66,12 +53,7 @@ export class TeamsAgentExtension<TState extends TurnState = TurnState> extends A
     return this
   }
 
-  /**
-   * Registers a handler for message delete events in Teams.
-   * @param handler The route handler to execute when a message is deleted
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onMessageDelete = (handler: RouteHandler<TurnState>) => {
+  onMessageDelete (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.MessageDelete && channelData && channelData.eventType === 'softDeleteMessage')
@@ -80,12 +62,7 @@ export class TeamsAgentExtension<TState extends TurnState = TurnState> extends A
     return this
   }
 
-  /**
-   * Registers a handler for message undelete events in Teams.
-   * @param handler The route handler to execute when a message is undeleted
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onMessageUndelete = (handler: RouteHandler<TurnState>) => {
+  onMessageUndelete (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.MessageUpdate && channelData && channelData.eventType === 'undeleteMessage')
@@ -94,203 +71,143 @@ export class TeamsAgentExtension<TState extends TurnState = TurnState> extends A
     return this
   }
 
-  /**
-   * Registers a handler for when members are added to a Teams conversation.
-   * @param handler The route handler to execute when members are added
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsMembersAdded = (handler: RouteHandler<TurnState>) => {
+  onTeamsMembersAdded (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       return Promise.resolve(!!(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        context.activity.membersAdded &&
-        context.activity.membersAdded.length > 0))
+                context.activity.channelId === 'msteams' &&
+                context.activity.membersAdded &&
+                context.activity.membersAdded.length > 0))
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when members are removed from a Teams conversation.
-   * @param handler The route handler to execute when members are removed
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsMembersRemoved = (handler: RouteHandler<TurnState>) => {
+  onTeamsMembersRemoved (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       return Promise.resolve(!!(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        context.activity.membersRemoved &&
-        context.activity.membersRemoved.length > 0))
+                context.activity.channelId === 'msteams' &&
+                context.activity.membersRemoved &&
+                context.activity.membersRemoved.length > 0))
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams channel is created.
-   * @param handler The route handler to execute when a channel is created
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsChannelCreated = (handler: RouteHandler<TurnState>) => {
+  onTeamsChannelCreated (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'channelCreated')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'channelCreated')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams channel is deleted.
-   * @param handler The route handler to execute when a channel is deleted
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsChannelDeleted = (handler: RouteHandler<TurnState>) => {
+  onTeamsChannelDeleted (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'channelDeleted')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'channelDeleted')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams channel is renamed.
-   * @param handler The route handler to execute when a channel is renamed
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsChannelRenamed = (handler: RouteHandler<TurnState>) => {
+  onTeamsChannelRenamed (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'channelRenamed')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'channelRenamed')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams channel is restored.
-   * @param handler The route handler to execute when a channel is restored
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsChannelRestored = (handler: RouteHandler<TurnState>) => {
+  onTeamsChannelRestored (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'channelRestored')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'channelRestored')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is renamed.
-   * @param handler The route handler to execute when a team is renamed
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamRenamed = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamRenamed (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamRenamed')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamRenamed')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is archived.
-   * @param handler The route handler to execute when a team is archived
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamArchived = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamArchived (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamArchived')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamArchived')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is unarchived.
-   * @param handler The route handler to execute when a team is unarchived
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamUnarchived = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamUnarchived (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamUnarchived')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamUnarchived')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is deleted (soft delete).
-   * @param handler The route handler to execute when a team is deleted
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamDeleted = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamDeleted (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamDeleted')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamDeleted')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is hard deleted (permanently deleted).
-   * @param handler The route handler to execute when a team is hard deleted
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamHardDeleted = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamHardDeleted (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamHardDeleted')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamHardDeleted')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this
   }
 
-  /**
-   * Registers a handler for when a Teams team is restored.
-   * @param handler The route handler to execute when a team is restored
-   * @returns This TeamsAgentExtension instance for method chaining
-   */
-  onTeamsTeamRestored = (handler: RouteHandler<TurnState>) => {
+  onTeamsTeamRestored (handler: RouteHandler<TurnState>) {
     const routeSel: RouteSelector = (context: TurnContext) => {
       const channelData = parseTeamsChannelData(context.activity.channelData)
       return Promise.resolve(context.activity.type === ActivityTypes.ConversationUpdate &&
-        context.activity.channelId === 'msteams' &&
-        channelData &&
-        channelData.eventType === 'teamRestored')
+                context.activity.channelId === 'msteams' &&
+                channelData &&
+                channelData.eventType === 'teamRestored')
     }
     this.addRoute(this._app, routeSel, handler, false)
     return this

package/src/teamsAttachmentDownloader.ts

@@ -12,8 +12,10 @@ import { z } from 'zod'
  */
 export class TeamsAttachmentDownloader<TState extends TurnState = TurnState> implements InputFileDownloader<TState> {
   private _httpClient: AxiosInstance
-  public constructor () {
+  private _stateKey: string
+  public constructor (stateKey: string = 'inputFiles') {
     this._httpClient = axios.create()
+    this._stateKey = stateKey
   }
 
   /**
@@ -23,7 +25,7 @@ export class TeamsAttachmentDownloader<TState extends TurnState = TurnState> imp
      * @param {TState} state Application state for the current turn of conversation.
      * @returns {Promise<InputFile[]>} Promise that resolves to an array of downloaded input files.
      */
-  public async downloadFiles (context: TurnContext, state: TState): Promise<InputFile[]> {
+  public async downloadFiles (context: TurnContext): Promise<InputFile[]> {
     // Filter out HTML attachments
     const attachments = context.activity.attachments?.filter((a) => !a.contentType.startsWith('text/html'))
     if (!attachments || attachments.length === 0) {
@@ -75,4 +77,16 @@ export class TeamsAttachmentDownloader<TState extends TurnState = TurnState> imp
     }
     return inputFile
   }
+
+  /**
+   * Downloads files from the attachments in the current turn context and stores them in state.
+   *
+   * @param context The turn context containing the activity with attachments.
+   * @param state The turn state to store the files in.
+   * @returns A promise that resolves when the downloaded files are stored.
+   */
+  public async downloadAndStoreFiles (context: TurnContext, state: TState): Promise<void> {
+    const files = await this.downloadFiles(context)
+    state.setValue(this._stateKey, files)
+  }
 }

package/src/teamsInfo.ts

@@ -156,7 +156,7 @@ export class TeamsInfo {
       //   context.activity.serviceUrl
       // )
       const connectorClient : ConnectorClient = context.turnState.get<ConnectorClient>('connectorClient')
-      const conversationResourceResponse = await connectorClient.createConversationAsync(convoParams)
+      const conversationResourceResponse = await connectorClient.createConversation(convoParams)
       conversationReference = context.activity.getConversationReference()
       conversationReference.conversation!.id = conversationResourceResponse.id
       newActivityId = conversationResourceResponse.activityId