@cuylabs/agent-channel-teams 0.14.1 → 0.16.0

package/dist/index.d.ts

@@ -15,7 +15,7 @@ declare function createTeamsInvokeActivity<T = unknown>(result: TeamsInvokeResul
 declare function sendTeamsInvoke<T = unknown>(context: TurnContext, body?: T, status?: number): Promise<void>;
 
 type TeamsSurface = "personal" | "channel" | "group" | "meeting" | "unknown";
-type TeamsActivityKind = "message" | "conversation-update" | "members-added" | "members-removed" | "channel-created" | "channel-deleted" | "channel-renamed" | "channel-restored" | "channel-shared" | "channel-unshared" | "team-renamed" | "team-archived" | "team-unarchived" | "team-deleted" | "team-hard-deleted" | "team-restored" | "message-edit" | "message-delete" | "message-restore" | "reaction" | "read-receipt" | "config-fetch" | "config-submit" | "file-consent" | "actionable-message-execute-action" | "card-submit" | "feedback" | "dialog-open" | "dialog-submit" | "task-fetch" | "task-submit" | "search-command" | "message-extension-query" | "message-extension-query-link" | "message-extension-anonymous-query-link" | "select-result" | "message-extension-select-item" | "message-extension-submit-action" | "message-extension-fetch-task" | "message-extension-query-setting-url" | "message-extension-setting" | "message-extension-card-button-clicked" | "tab-fetch" | "tab-submit" | "invoke" | "meeting-start" | "meeting-end" | "participants-join" | "participants-leave" | "meeting-room-join" | "meeting-room-leave" | "meeting-stage-view" | "meeting-smart-reply" | "meeting-reaction" | "meeting-poll-response" | "meeting-apps-installed" | "meeting-apps-uninstalled" | "meeting-recording-started" | "meeting-recording-stopped" | "meeting-focus-change" | "meeting-screen-share-start" | "meeting-screen-share-stop" | "other";
+type TeamsActivityKind = "message" | "conversation-update" | "members-added" | "members-removed" | "channel-created" | "channel-deleted" | "channel-renamed" | "channel-restored" | "channel-shared" | "channel-unshared" | "team-renamed" | "team-archived" | "team-unarchived" | "team-deleted" | "team-hard-deleted" | "team-restored" | "message-edit" | "message-delete" | "message-restore" | "reaction" | "read-receipt" | "config-fetch" | "config-submit" | "file-consent" | "actionable-message-execute-action" | "adaptive-card-action" | "adaptive-card-search" | "card-submit" | "feedback" | "dialog-open" | "dialog-submit" | "task-fetch" | "task-submit" | "search-command" | "message-extension-query" | "message-extension-query-link" | "message-extension-anonymous-query-link" | "select-result" | "message-extension-select-item" | "message-extension-submit-action" | "message-extension-fetch-task" | "message-extension-query-setting-url" | "message-extension-setting" | "message-extension-card-button-clicked" | "tab-fetch" | "tab-submit" | "invoke" | "meeting-start" | "meeting-end" | "participants-join" | "participants-leave" | "meeting-room-join" | "meeting-room-leave" | "meeting-stage-view" | "meeting-smart-reply" | "meeting-reaction" | "meeting-poll-response" | "meeting-apps-installed" | "meeting-apps-uninstalled" | "meeting-recording-started" | "meeting-recording-stopped" | "meeting-focus-change" | "meeting-screen-share-start" | "meeting-screen-share-stop" | "other";
 interface TeamsActorReference {
     id?: string;
     displayName?: string;
@@ -94,6 +94,8 @@ interface TeamsMessageActivityHandlers {
 }
 interface TeamsCardActionHandlers {
     cardSubmit?: TeamsActivityHandler;
+    adaptiveCardAction?: TeamsActivityHandler;
+    adaptiveCardSearch?: TeamsActivityHandler;
     feedbackSubmit?: TeamsActivityHandler;
     fileConsent?: TeamsActivityHandler;
     actionableMessageExecuteAction?: TeamsActivityHandler;
@@ -171,6 +173,17 @@ interface TeamsActivityHandlers extends TeamsConversationUpdateHandlers, TeamsMe
     invoke?: TeamsActivityHandler;
 }
 interface TeamsChannelOptions extends Omit<M365ChannelOptions, "prepareTurn"> {
+    /**
+     * Whether malformed Teams channelData should throw while parsing.
+     *
+     * Keep this enabled in tests and strict hosts that want SDK payload drift to
+     * fail fast. Disable it in production bots that should continue handling the
+     * turn with best-effort Teams metadata when an unexpected channelData shape
+     * arrives.
+     *
+     * @default true
+     */
+    strictChannelData?: boolean;
     /**
      * Teams-native turn preparation hook. The result is forwarded into the
      * underlying M365 channel adapter.
@@ -282,10 +295,15 @@ interface TeamsDialogMessageBody {
 declare function createTeamsDialog(dialog: TeamsDialogDefinition): TeamsDialogResponse;
 declare function createTeamsDialogMessage(message: string): TeamsDialogMessageBody;
 
+interface ParseTeamsActivityOptions {
+    strictChannelData?: boolean;
+}
 declare const TEAMS_CONFIG_FETCH_NAMES: readonly ["config/fetch"];
 declare const TEAMS_CONFIG_SUBMIT_NAMES: readonly ["config/submit"];
 declare const TEAMS_FILE_CONSENT_NAMES: readonly ["fileConsent/invoke"];
 declare const TEAMS_ACTIONABLE_MESSAGE_NAMES: readonly ["actionableMessage/executeAction"];
+declare const TEAMS_ADAPTIVE_CARD_ACTION_NAMES: readonly ["adaptiveCard/action"];
+declare const TEAMS_ADAPTIVE_CARD_SEARCH_NAMES: readonly ["application/search"];
 declare const TEAMS_TASK_MODULE_FETCH_NAMES: readonly ["task/fetch", "composeExtension/fetchTask"];
 declare const TEAMS_TASK_MODULE_SUBMIT_NAMES: readonly ["task/submit"];
 declare const TEAMS_TAB_FETCH_NAMES: readonly ["tab/fetch"];
@@ -301,6 +319,7 @@ declare const TEAMS_CARD_ACTION_SUBMIT_NAMES: readonly ["message/submitAction"];
 declare const TEAMS_CONVERSATION_UPDATE_EVENT_NAMES: Readonly<Record<string, TeamsActivityKind>>;
 declare const TEAMS_MEETING_EVENT_NAMES: Readonly<Record<string, TeamsActivityKind>>;
 declare const TEAMS_MEETING_INVOKE_NAMES: Readonly<Record<string, TeamsActivityKind>>;
-declare function parseTeamsActivity(context: TurnContext): TeamsActivityInfo;
+declare function parseTeamsActivity(context: TurnContext, options?: ParseTeamsActivityOptions): TeamsActivityInfo;
+declare function parseTeamsActivitySafe(context: TurnContext): TeamsActivityInfo;
 
-export { type MountTeamsAgentOptions, type MountTeamsAgentResult, TEAMS_ACTIONABLE_MESSAGE_NAMES, TEAMS_CARD_ACTION_SUBMIT_NAMES, TEAMS_CONFIG_FETCH_NAMES, TEAMS_CONFIG_SUBMIT_NAMES, TEAMS_CONVERSATION_UPDATE_EVENT_NAMES, TEAMS_FILE_CONSENT_NAMES, TEAMS_MEETING_EVENT_NAMES, TEAMS_MEETING_INVOKE_NAMES, TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES, TEAMS_MESSAGE_EXTENSION_FETCH_TASK_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES, TEAMS_MESSAGE_EXTENSION_SELECT_NAMES, TEAMS_MESSAGE_EXTENSION_SETTING_NAMES, TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES, TEAMS_TAB_FETCH_NAMES, TEAMS_TAB_SUBMIT_NAMES, TEAMS_TASK_MODULE_FETCH_NAMES, TEAMS_TASK_MODULE_SUBMIT_NAMES, type TeamsActivityHandler, type TeamsActivityHandlers, type TeamsActivityInfo, type TeamsActivityKind, type TeamsActorReference, type TeamsAmbientTurnContext, type TeamsCardActionHandlers, type TeamsChannelAdapter, type TeamsChannelOptions, type TeamsConfigHandlers, type TeamsConversationUpdateHandlers, type TeamsDialogDefinition, type TeamsDialogMessageBody, type TeamsDialogResponse, type TeamsDialogSize, type TeamsHandlerContext, type TeamsHandlerDecision, type TeamsInvokeResult, type TeamsMeetingHandlers, type TeamsMessageActivityHandlers, type TeamsMessageExtensionHandlers, type TeamsSearchAttachment, type TeamsSearchLayout, type TeamsSearchMessageBody, type TeamsSearchResponse, type TeamsSearchResult, type TeamsSearchResultBody, type TeamsSearchResultType, type TeamsSurface, type TeamsTabHandlers, type TeamsTaskModuleHandlers, type TeamsTurnPreparation, type TeamsTurnRequestContext, createTeamsChannelAdapter, createTeamsDialog, createTeamsDialogMessage, createTeamsInvokeActivity, createTeamsSearchMessage, createTeamsSearchResult, currentTeamsTurnContext, mountTeamsAgent, parseTeamsActivity, runWithTeamsTurnContext, sendTeamsInvoke };
+export { type MountTeamsAgentOptions, type MountTeamsAgentResult, type ParseTeamsActivityOptions, TEAMS_ACTIONABLE_MESSAGE_NAMES, TEAMS_ADAPTIVE_CARD_ACTION_NAMES, TEAMS_ADAPTIVE_CARD_SEARCH_NAMES, TEAMS_CARD_ACTION_SUBMIT_NAMES, TEAMS_CONFIG_FETCH_NAMES, TEAMS_CONFIG_SUBMIT_NAMES, TEAMS_CONVERSATION_UPDATE_EVENT_NAMES, TEAMS_FILE_CONSENT_NAMES, TEAMS_MEETING_EVENT_NAMES, TEAMS_MEETING_INVOKE_NAMES, TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES, TEAMS_MESSAGE_EXTENSION_FETCH_TASK_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_NAMES, TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES, TEAMS_MESSAGE_EXTENSION_SELECT_NAMES, TEAMS_MESSAGE_EXTENSION_SETTING_NAMES, TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES, TEAMS_TAB_FETCH_NAMES, TEAMS_TAB_SUBMIT_NAMES, TEAMS_TASK_MODULE_FETCH_NAMES, TEAMS_TASK_MODULE_SUBMIT_NAMES, type TeamsActivityHandler, type TeamsActivityHandlers, type TeamsActivityInfo, type TeamsActivityKind, type TeamsActorReference, type TeamsAmbientTurnContext, type TeamsCardActionHandlers, type TeamsChannelAdapter, type TeamsChannelOptions, type TeamsConfigHandlers, type TeamsConversationUpdateHandlers, type TeamsDialogDefinition, type TeamsDialogMessageBody, type TeamsDialogResponse, type TeamsDialogSize, type TeamsHandlerContext, type TeamsHandlerDecision, type TeamsInvokeResult, type TeamsMeetingHandlers, type TeamsMessageActivityHandlers, type TeamsMessageExtensionHandlers, type TeamsSearchAttachment, type TeamsSearchLayout, type TeamsSearchMessageBody, type TeamsSearchResponse, type TeamsSearchResult, type TeamsSearchResultBody, type TeamsSearchResultType, type TeamsSurface, type TeamsTabHandlers, type TeamsTaskModuleHandlers, type TeamsTurnPreparation, type TeamsTurnRequestContext, createTeamsChannelAdapter, createTeamsDialog, createTeamsDialogMessage, createTeamsInvokeActivity, createTeamsSearchMessage, createTeamsSearchResult, currentTeamsTurnContext, mountTeamsAgent, parseTeamsActivity, parseTeamsActivitySafe, runWithTeamsTurnContext, sendTeamsInvoke };

package/dist/index.js

@@ -47,9 +47,16 @@ function detectSurface(conversationType, meetingId, teamId) {
 function includesName(names, candidate) {
   return !!candidate && names.includes(candidate);
 }
-function parseTypedChannelData(channelData) {
+function parseTypedChannelData(channelData, options = {}) {
   if (!channelData) return void 0;
-  return parseTeamsChannelData(channelData);
+  try {
+    return parseTeamsChannelData(channelData);
+  } catch (error) {
+    if (options.strictChannelData ?? true) {
+      throw error;
+    }
+    return void 0;
+  }
 }
 var TEAMS_CONFIG_FETCH_NAMES = ["config/fetch"];
 var TEAMS_CONFIG_SUBMIT_NAMES = ["config/submit"];
@@ -57,6 +64,10 @@ var TEAMS_FILE_CONSENT_NAMES = ["fileConsent/invoke"];
 var TEAMS_ACTIONABLE_MESSAGE_NAMES = [
   "actionableMessage/executeAction"
 ];
+var TEAMS_ADAPTIVE_CARD_ACTION_NAMES = [
+  "adaptiveCard/action"
+];
+var TEAMS_ADAPTIVE_CARD_SEARCH_NAMES = ["application/search"];
 var TEAMS_TASK_MODULE_FETCH_NAMES = [
   "task/fetch",
   "composeExtension/fetchTask"
@@ -172,6 +183,12 @@ function detectKind(context, eventType) {
       if (includesName(TEAMS_ACTIONABLE_MESSAGE_NAMES, invokeName)) {
         return "actionable-message-execute-action";
       }
+      if (includesName(TEAMS_ADAPTIVE_CARD_ACTION_NAMES, invokeName)) {
+        return "adaptive-card-action";
+      }
+      if (includesName(TEAMS_ADAPTIVE_CARD_SEARCH_NAMES, invokeName)) {
+        return "adaptive-card-search";
+      }
       if (includesName(TEAMS_TASK_MODULE_FETCH_NAMES, invokeName)) {
         return invokeName === "composeExtension/fetchTask" ? "message-extension-fetch-task" : "task-fetch";
       }
@@ -241,10 +258,10 @@ function parseActors(channelData) {
     (actor) => actor.id !== void 0 || actor.displayName !== void 0 || actor.userPrincipalName !== void 0
   );
 }
-function parseTeamsActivity(context) {
+function parseTeamsActivity(context, options = {}) {
   const { activity } = context;
   const channelData = asObject(activity.channelData);
-  const parsedChannelData = parseTypedChannelData(channelData);
+  const parsedChannelData = parseTypedChannelData(channelData, options);
   const team = asObject(channelData?.team);
   const channel = asObject(channelData?.channel);
   const tenant = asObject(channelData?.tenant);
@@ -276,6 +293,9 @@ function parseTeamsActivity(context) {
     actors: parseActors(channelData)
   };
 }
+function parseTeamsActivitySafe(context) {
+  return parseTeamsActivity(context, { strictChannelData: false });
+}
 
 // src/adapter.ts
 function createTeamsChannelAdapter(options) {
@@ -284,12 +304,15 @@ function createTeamsChannelAdapter(options) {
     handlers,
     onInvoke: fallbackInvoke,
     onTurn: onTurnHook,
+    strictChannelData,
     ...baseOptions
   } = options;
   const base = createM365ChannelAdapter({
     ...baseOptions,
     prepareTurn: async (request) => {
-      const teams = parseTeamsActivity(request.turnContext);
+      const teams = parseTeamsActivity(request.turnContext, {
+        strictChannelData
+      });
       const prepared = prepareTurn ? await prepareTurn({
         ...request,
         teams,
@@ -316,7 +339,9 @@ function createTeamsChannelAdapter(options) {
       };
     },
     onInvoke: async (context) => {
-      const teams = parseTeamsActivity(context);
+      const teams = parseTeamsActivity(context, {
+        strictChannelData
+      });
       const dispatch = await dispatchTeamsHandler(
         handlers,
         teams.kind,
@@ -330,7 +355,9 @@ function createTeamsChannelAdapter(options) {
     }
   });
   async function coreHandler(context) {
-    const teams = parseTeamsActivity(context);
+    const teams = parseTeamsActivity(context, {
+      strictChannelData
+    });
     if (teams.channelId !== "msteams") {
       await base.handler(context);
       return;
@@ -465,6 +492,10 @@ function resolveHandler(handlers, kind) {
       return handlers?.fileConsent ?? handlers?.invoke;
     case "actionable-message-execute-action":
       return handlers?.actionableMessageExecuteAction ?? handlers?.invoke;
+    case "adaptive-card-action":
+      return handlers?.adaptiveCardAction ?? handlers?.cardSubmit;
+    case "adaptive-card-search":
+      return handlers?.adaptiveCardSearch ?? handlers?.searchCommand;
     case "feedback":
       return handlers?.feedbackSubmit ?? handlers?.cardSubmit;
     case "card-submit":
@@ -739,6 +770,8 @@ function createTeamsDialogMessage(message) {
 }
 export {
   TEAMS_ACTIONABLE_MESSAGE_NAMES,
+  TEAMS_ADAPTIVE_CARD_ACTION_NAMES,
+  TEAMS_ADAPTIVE_CARD_SEARCH_NAMES,
   TEAMS_CARD_ACTION_SUBMIT_NAMES,
   TEAMS_CONFIG_FETCH_NAMES,
   TEAMS_CONFIG_SUBMIT_NAMES,
@@ -768,6 +801,7 @@ export {
   currentTeamsTurnContext,
   mountTeamsAgent,
   parseTeamsActivity,
+  parseTeamsActivitySafe,
   parseTeamsChannelData,
   runWithTeamsTurnContext,
   sendTeamsInvoke

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/agent-channel-teams",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Teams-native channel layer for @cuylabs/agent-core built on top of @cuylabs/agent-channel-m365",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,13 +23,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@microsoft/agents-activity": "^1.4.2",
-    "@microsoft/agents-hosting": "^1.4.2",
     "@microsoft/agents-hosting-extensions-teams": "^1.4.2",
-    "@cuylabs/agent-channel-m365": "^0.14.1",
-    "@cuylabs/agent-core": "^0.14.1"
+    "@cuylabs/agent-channel-m365": "^0.16.0",
+    "@cuylabs/agent-core": "^0.16.0"
   },
   "peerDependencies": {
+    "@microsoft/agents-activity": "^1.4.2",
+    "@microsoft/agents-hosting": "^1.4.2",
     "express": ">=4.21.0 || >=5.0.0"
   },
   "peerDependenciesMeta": {
@@ -38,6 +38,8 @@
     }
   },
   "devDependencies": {
+    "@microsoft/agents-activity": "^1.4.2",
+    "@microsoft/agents-hosting": "^1.4.2",
     "@types/express": "^5.0.0",
     "@types/node": "^22.0.0",
     "express": "^5.2.1",