@microsoft/agents-hosting-extensions-teams 0.5.1-g2e246ff274 → 0.5.12-g2d752e9b13

package/README.md

@@ -0,0 +1,139 @@
+# @microsoft/agents-hosting-extensions-teams
+
+Microsoft Teams extension for the Microsoft 365 Agents SDK for JavaScript.
+
+## Installation
+
+```bash
+npm install @microsoft/agents-hosting-extensions-teams
+```
+
+## 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)
+- Reactions and screen sharing events
+- 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-teams'
+
+// 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.meeting
+    .onMeetingStart(async (context, state) => {
+      await context.sendActivity('Meeting started! I\'m here to assist.')
+    })
+    .onMeetingEnd(async (context, state) => {
+      await context.sendActivity('The meeting has ended. Thanks for participating!')
+    })
+    .onParticipantsJoin(async (context, state) => {
+      await context.sendActivity('Welcome to the meeting!')
+    })
+    .onScreenShareStart(async (context, state) => {
+      await context.sendActivity('Screen sharing has started.')
+    })
+    .onRecordingStarted(async (context, state) => {
+      await context.sendActivity('Recording has started.')
+    })
+})
+```
+
+### Message Handling
+
+Handle message events in Teams:
+
+```typescript
+app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
+  tae.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.messageExtension
+    .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.taskModule
+    .onFetch(async (context, state) => {
+      // Return task module card
+    })
+    .onSubmit(async (context, state) => {
+      // Handle task module submission
+    })
+})
+```
+
+## License
+
+MIT
+

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

@@ -53,6 +53,7 @@ export declare const messagingExtensionQueryZodSchema: z.ZodObject<{
     }>>;
     state: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    state?: string | undefined;
     commandId?: string | undefined;
     parameters?: {
         value?: any;
@@ -62,8 +63,8 @@ export declare const messagingExtensionQueryZodSchema: z.ZodObject<{
         skip?: number | undefined;
         count?: number | undefined;
     } | undefined;
-    state?: string | undefined;
 }, {
+    state?: string | undefined;
     commandId?: string | undefined;
     parameters?: {
         value?: any;
@@ -73,7 +74,6 @@ export declare const messagingExtensionQueryZodSchema: z.ZodObject<{
         skip?: number | undefined;
         count?: number | undefined;
     } | undefined;
-    state?: string | undefined;
 }>;
 /**
  * Parses the given value as a messaging extension query.

package/dist/src/messages/messages.js

@@ -68,10 +68,10 @@ class Messages {
                             }
                         };
                     }
-                    await context.sendActivity({
+                    await context.sendActivity(agents_activity_1.Activity.fromObject({
                         value: { body: response, status: 200 },
                         type: agents_activity_1.ActivityTypes.InvokeResponse
-                    });
+                    }));
                 }
             }
         }, true);

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

@@ -1 +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"}
+{"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,0BAAQ,CAAC,UAAU,CAAC;wBAC7C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAoB;wBACxD,IAAI,EAAE,+BAAa,CAAC,cAAc;qBACnC,CAAC,CAAC,CAAA;gBACL,CAAC;YACH,CAAC;QACH,CAAC,EACD,IAAI,CACL,CAAA;QAED,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF;AA/DD,4BA+DC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting-extensions-teams",
-  "version": "0.5.1-g2e246ff274",
+  "version": "0.5.12-g2d752e9b13",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@microsoft/agents-hosting": "0.5.1-g2e246ff274"
+    "@microsoft/agents-hosting": "0.5.12-g2d752e9b13"
   },
   "license": "MIT",
   "files": [

package/src/messages/messages.ts

@@ -76,10 +76,10 @@ export class Messages<TState extends TurnState> {
               }
             }
 
-            await context.sendActivity({
+            await context.sendActivity(Activity.fromObject({
               value: { body: response, status: 200 } as InvokeResponse,
               type: ActivityTypes.InvokeResponse
-            } as Activity)
+            }))
           }
         }
       },