@cuylabs/agent-channel-teams 3.2.1 → 4.1.0

package/dist/index.js

@@ -1,3 +1,38 @@
+import {
+  Conversation,
+  ConversationBuilder,
+  ConversationReferenceBuilder,
+  CreateConversationOptionsBuilder,
+  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,
+  captureM365ConversationReference,
+  captureTeamsConversationReference,
+  continueM365Conversation,
+  isTargetedTeamsActivity,
+  makeTargetedTeamsActivity,
+  parseTeamsActivity,
+  parseTeamsActivitySafe,
+  restoreM365ConversationReference
+} from "./chunk-MBDHSFBF.js";
 import {
   TeamsAttachmentDownloader,
   TeamsInfo,
@@ -10,7 +45,7 @@ import {
   extractUserIdentity,
   runWithM365TurnContext
 } from "@cuylabs/agent-channel-m365";
-import { ActivityTypes as ActivityTypes3 } from "@microsoft/agents-activity";
+import { ActivityTypes as ActivityTypes2 } from "@microsoft/agents-activity";
 
 // src/invoke.ts
 import { Activity, ActivityTypes } from "@microsoft/agents-activity";
@@ -28,275 +63,6 @@ async function sendTeamsInvoke(context, body, status = 200) {
   );
 }
 
-// src/teams-activity.ts
-import { ActivityTypes as ActivityTypes2 } from "@microsoft/agents-activity";
-function asObject(value) {
-  return value && typeof value === "object" ? value : void 0;
-}
-function readString(value, key) {
-  const candidate = value?.[key];
-  return typeof candidate === "string" && candidate.trim() ? candidate : void 0;
-}
-function detectSurface(conversationType, meetingId, teamId) {
-  if (meetingId) return "meeting";
-  if (teamId) return "channel";
-  if (conversationType === "personal") return "personal";
-  if (conversationType === "groupChat") return "group";
-  return "unknown";
-}
-function includesName(names, candidate) {
-  return !!candidate && names.includes(candidate);
-}
-function parseTypedChannelData(channelData, options = {}) {
-  if (!channelData) return void 0;
-  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"];
-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"
-];
-var TEAMS_TASK_MODULE_SUBMIT_NAMES = ["task/submit"];
-var TEAMS_TAB_FETCH_NAMES = ["tab/fetch"];
-var TEAMS_TAB_SUBMIT_NAMES = ["tab/submit"];
-var TEAMS_MESSAGE_EXTENSION_QUERY_NAMES = [
-  "composeExtension/query",
-  "composeExtension/queryLink",
-  "composeExtension/anonymousQueryLink"
-];
-var TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES = [
-  "composeExtension/submitAction"
-];
-var TEAMS_MESSAGE_EXTENSION_FETCH_TASK_NAMES = [
-  "composeExtension/fetchTask"
-];
-var TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES = [
-  "composeExtension/querySettingUrl"
-];
-var TEAMS_MESSAGE_EXTENSION_SETTING_NAMES = [
-  "composeExtension/setting"
-];
-var TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES = [
-  "composeExtension/onCardButtonClicked"
-];
-var TEAMS_MESSAGE_EXTENSION_SELECT_NAMES = [
-  "composeExtension/selectItem"
-];
-var TEAMS_CARD_ACTION_SUBMIT_NAMES = ["message/submitAction"];
-var TEAMS_CONVERSATION_UPDATE_EVENT_NAMES = {
-  channelCreated: "channel-created",
-  channelDeleted: "channel-deleted",
-  channelRenamed: "channel-renamed",
-  channelRestored: "channel-restored",
-  channelShared: "channel-shared",
-  channelUnshared: "channel-unshared",
-  teamRenamed: "team-renamed",
-  teamArchived: "team-archived",
-  teamUnarchived: "team-unarchived",
-  teamDeleted: "team-deleted",
-  teamHardDeleted: "team-hard-deleted",
-  teamRestored: "team-restored"
-};
-var TEAMS_MEETING_EVENT_NAMES = {
-  "application/vnd.microsoft.readReceipt": "read-receipt",
-  "application/vnd.microsoft.meetingStart": "meeting-start",
-  "application/vnd.microsoft.meetingEnd": "meeting-end",
-  "application/vnd.microsoft.meetingParticipantJoin": "participants-join",
-  "application/vnd.microsoft.meetingParticipantLeave": "participants-leave",
-  "application/vnd.microsoft.meetingRoomJoin": "meeting-room-join",
-  "application/vnd.microsoft.meetingRoomLeave": "meeting-room-leave",
-  "application/vnd.microsoft.meetingReaction": "meeting-reaction",
-  "application/vnd.microsoft.meetingPollResponse": "meeting-poll-response",
-  "application/vnd.microsoft.meetingAppsInstalled": "meeting-apps-installed",
-  "application/vnd.microsoft.meetingAppsUninstalled": "meeting-apps-uninstalled",
-  "application/vnd.microsoft.meetingRecordingStarted": "meeting-recording-started",
-  "application/vnd.microsoft.meetingRecordingStopped": "meeting-recording-stopped",
-  "application/vnd.microsoft.meetingFocusChange": "meeting-focus-change",
-  "application/vnd.microsoft.meetingScreenShareStart": "meeting-screen-share-start",
-  "application/vnd.microsoft.meetingScreenShareStop": "meeting-screen-share-stop"
-};
-var TEAMS_MEETING_INVOKE_NAMES = {
-  "application/vnd.microsoft.meetingStageView": "meeting-stage-view",
-  "application/vnd.microsoft.meetingSmartReply": "meeting-smart-reply"
-};
-function detectKind(context, eventType) {
-  const { activity } = context;
-  const payload = asObject(activity.value);
-  const invokeName = activity.name;
-  switch (activity.type) {
-    case ActivityTypes2.Message:
-      return "message";
-    case ActivityTypes2.MessageReaction:
-      return "reaction";
-    case ActivityTypes2.ConversationUpdate:
-      if (Array.isArray(activity.membersAdded) && activity.membersAdded.length > 0) {
-        return "members-added";
-      }
-      if (Array.isArray(activity.membersRemoved) && activity.membersRemoved.length > 0) {
-        return "members-removed";
-      }
-      if (eventType && eventType in TEAMS_CONVERSATION_UPDATE_EVENT_NAMES) {
-        return TEAMS_CONVERSATION_UPDATE_EVENT_NAMES[eventType];
-      }
-      return "conversation-update";
-    case ActivityTypes2.MessageUpdate:
-      if (eventType === "editMessage") return "message-edit";
-      if (eventType === "undeleteMessage") return "message-restore";
-      return "other";
-    case ActivityTypes2.MessageDelete:
-      if (eventType === "softDeleteMessage") return "message-delete";
-      return "other";
-    case ActivityTypes2.Event:
-      if (invokeName && invokeName in TEAMS_MEETING_EVENT_NAMES) {
-        return TEAMS_MEETING_EVENT_NAMES[invokeName];
-      }
-      return "other";
-    case ActivityTypes2.Invoke:
-      if (invokeName && invokeName in TEAMS_MEETING_INVOKE_NAMES) {
-        return TEAMS_MEETING_INVOKE_NAMES[invokeName];
-      }
-      if (includesName(TEAMS_CONFIG_FETCH_NAMES, invokeName)) {
-        return "config-fetch";
-      }
-      if (includesName(TEAMS_CONFIG_SUBMIT_NAMES, invokeName)) {
-        return "config-submit";
-      }
-      if (includesName(TEAMS_FILE_CONSENT_NAMES, invokeName)) {
-        return "file-consent";
-      }
-      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";
-      }
-      if (includesName(TEAMS_TASK_MODULE_SUBMIT_NAMES, invokeName)) {
-        return "task-submit";
-      }
-      if (includesName(TEAMS_TAB_FETCH_NAMES, invokeName)) {
-        return "tab-fetch";
-      }
-      if (includesName(TEAMS_TAB_SUBMIT_NAMES, invokeName)) {
-        return "tab-submit";
-      }
-      if (includesName(TEAMS_MESSAGE_EXTENSION_QUERY_NAMES, invokeName)) {
-        switch (invokeName) {
-          case "composeExtension/queryLink":
-            return "message-extension-query-link";
-          case "composeExtension/anonymousQueryLink":
-            return "message-extension-anonymous-query-link";
-          default:
-            return "message-extension-query";
-        }
-      }
-      if (includesName(TEAMS_MESSAGE_EXTENSION_SELECT_NAMES, invokeName)) {
-        return "message-extension-select-item";
-      }
-      if (includesName(TEAMS_MESSAGE_EXTENSION_SUBMIT_ACTION_NAMES, invokeName)) {
-        return "message-extension-submit-action";
-      }
-      if (includesName(
-        TEAMS_MESSAGE_EXTENSION_QUERY_SETTING_URL_NAMES,
-        invokeName
-      )) {
-        return "message-extension-query-setting-url";
-      }
-      if (includesName(TEAMS_MESSAGE_EXTENSION_SETTING_NAMES, invokeName)) {
-        return "message-extension-setting";
-      }
-      if (includesName(
-        TEAMS_MESSAGE_EXTENSION_CARD_BUTTON_CLICKED_NAMES,
-        invokeName
-      )) {
-        return "message-extension-card-button-clicked";
-      }
-      if (includesName(TEAMS_CARD_ACTION_SUBMIT_NAMES, invokeName)) {
-        return payload?.actionName === "feedback" ? "feedback" : "card-submit";
-      }
-      return "invoke";
-    default:
-      return "other";
-  }
-}
-function parseActors(channelData) {
-  const raw = channelData?.onBehalfOf;
-  if (!Array.isArray(raw)) return [];
-  const actors = [];
-  for (const item of raw) {
-    const actor = asObject(item);
-    const itemRef = asObject(actor?.item);
-    actors.push({
-      id: readString(itemRef, "id"),
-      displayName: readString(itemRef, "displayName"),
-      tenantId: readString(actor, "tenantId"),
-      userPrincipalName: readString(itemRef, "userPrincipalName")
-    });
-  }
-  return actors.filter(
-    (actor) => actor.id !== void 0 || actor.displayName !== void 0 || actor.userPrincipalName !== void 0
-  );
-}
-function parseTeamsActivity(context, options = {}) {
-  const { activity } = context;
-  const channelData = asObject(activity.channelData);
-  const parsedChannelData = parseTypedChannelData(channelData, options);
-  const team = asObject(channelData?.team);
-  const channel = asObject(channelData?.channel);
-  const tenant = asObject(channelData?.tenant);
-  const meeting = asObject(channelData?.meeting);
-  const eventType = parsedChannelData?.eventType ?? readString(channelData, "eventType");
-  const conversationType = typeof activity.conversation?.conversationType === "string" ? activity.conversation.conversationType : void 0;
-  const teamId = parsedChannelData?.team?.aadGroupId ?? parsedChannelData?.team?.id ?? readString(team, "aadGroupId") ?? readString(team, "id");
-  const meetingId = parsedChannelData?.meeting?.id ?? readString(meeting, "id");
-  const surface = detectSurface(
-    conversationType,
-    meetingId,
-    teamId
-  );
-  return {
-    channelId: activity.channelId ?? "unknown",
-    conversationId: activity.conversation?.id ?? "unknown",
-    activityId: activity.id ?? void 0,
-    messageId: activity.id ?? void 0,
-    replyToId: activity.replyToId ?? void 0,
-    invokeName: activity.name ?? void 0,
-    eventType,
-    tenantId: parsedChannelData?.tenant?.id ?? readString(tenant, "id") ?? activity.conversation?.tenantId,
-    teamId,
-    channelData: parsedChannelData,
-    channelThreadId: parsedChannelData?.channel?.id ?? readString(channel, "id"),
-    meetingId,
-    surface,
-    kind: detectKind(context, eventType),
-    actors: parseActors(channelData)
-  };
-}
-function parseTeamsActivitySafe(context) {
-  return parseTeamsActivity(context, { strictChannelData: false });
-}
-
 // src/adapter.ts
 function createTeamsChannelAdapter(options) {
   const {
@@ -362,8 +128,8 @@ function createTeamsChannelAdapter(options) {
       await base.handler(context);
       return;
     }
-    const isTeamsSpecificEvent = context.activity.type === ActivityTypes3.Event && teams.kind !== "other";
-    const isTeamsSpecificActivity = context.activity.type === ActivityTypes3.ConversationUpdate || context.activity.type === ActivityTypes3.MessageUpdate || context.activity.type === ActivityTypes3.MessageDelete || context.activity.type === ActivityTypes3.MessageReaction || isTeamsSpecificEvent;
+    const isTeamsSpecificEvent = context.activity.type === ActivityTypes2.Event && teams.kind !== "other";
+    const isTeamsSpecificActivity = context.activity.type === ActivityTypes2.ConversationUpdate || context.activity.type === ActivityTypes2.MessageUpdate || context.activity.type === ActivityTypes2.MessageDelete || context.activity.type === ActivityTypes2.MessageReaction || isTeamsSpecificEvent;
     if (isTeamsSpecificActivity) {
       const dispatch = await dispatchTeamsHandler(
         handlers,
@@ -433,7 +199,7 @@ async function dispatchTeamsHandler(handlers, kind, context) {
     return { handled: false };
   }
   const result = await handler(context);
-  if (context.turnContext.activity.type === ActivityTypes3.Invoke && result !== "continue") {
+  if (context.turnContext.activity.type === ActivityTypes2.Invoke && result !== "continue") {
     if (!getInvokeResponseSent(context) && isTeamsInvokeResult(result)) {
       await context.sendInvoke(result.body, result.status);
     } else if (!getInvokeResponseSent(context) && result === void 0) {
@@ -959,13 +725,13 @@ function createTeamsHumanInputRequestCard(input, options = {}) {
 }
 function parseTeamsInputRequestSubmit(value) {
   const data = readSubmitData(value);
-  const verb = readString2(data, "verb");
-  const requestId = readString2(data, "requestId");
+  const verb = readString(data, "verb");
+  const requestId = readString(data, "requestId");
   if (!requestId || verb !== TEAMS_INPUT_REQUEST_APPROVAL_VERB && verb !== TEAMS_INPUT_REQUEST_HUMAN_VERB) {
     return void 0;
   }
-  const sessionId = readString2(data, "sessionId");
-  const turnId = readString2(data, "turnId");
+  const sessionId = readString(data, "sessionId");
+  const turnId = readString(data, "turnId");
   if (verb === TEAMS_INPUT_REQUEST_APPROVAL_VERB) {
     const action = readApprovalAction(data);
     if (!action) {
@@ -1067,10 +833,10 @@ function readSubmitData(value) {
   };
 }
 function readHumanInputResponse(data) {
-  const responseKind = readString2(data, "responseKind");
+  const responseKind = readString(data, "responseKind");
   switch (responseKind) {
     case "text": {
-      const text = readString2(data, "text") ?? "";
+      const text = readString(data, "text") ?? "";
       return { kind: "text", text };
     }
     case "confirm": {
@@ -1078,7 +844,7 @@ function readHumanInputResponse(data) {
       if (confirmed === void 0) {
         return void 0;
       }
-      const text = readString2(data, "text") ?? (confirmed ? "confirmed" : "denied");
+      const text = readString(data, "text") ?? (confirmed ? "confirmed" : "denied");
       return { kind: "confirm", confirmed, text };
     }
     case "choice": {
@@ -1090,11 +856,11 @@ function readHumanInputResponse(data) {
   }
 }
 function readApprovalAction(data) {
-  const action = readString2(data, "action");
+  const action = readString(data, "action");
   return action === "allow" || action === "deny" || action === "remember" ? action : void 0;
 }
 function readRememberScope(data) {
-  const scope = readString2(data, "rememberScope");
+  const scope = readString(data, "rememberScope");
   return scope === "session" || scope === "project" || scope === "user" ? scope : void 0;
 }
 function readSelectedValues(data, key) {
@@ -1108,9 +874,9 @@ function readSelectedValues(data, key) {
   return [];
 }
 function readTrimmedString(data, key) {
-  return readString2(data, key)?.trim() || void 0;
+  return readString(data, key)?.trim() || void 0;
 }
-function readString2(data, key) {
+function readString(data, key) {
   const value = data?.[key];
   return typeof value === "string" ? value : void 0;
 }
@@ -1131,6 +897,10 @@ function asRecord(value) {
   return value && typeof value === "object" ? value : void 0;
 }
 export {
+  Conversation,
+  ConversationBuilder,
+  ConversationReferenceBuilder,
+  CreateConversationOptionsBuilder,
   TEAMS_ACTIONABLE_MESSAGE_NAMES,
   TEAMS_ADAPTIVE_CARD_ACTION_NAMES,
   TEAMS_ADAPTIVE_CARD_SEARCH_NAMES,
@@ -1156,6 +926,9 @@ export {
   TEAMS_TASK_MODULE_SUBMIT_NAMES,
   TeamsAttachmentDownloader,
   TeamsInfo,
+  captureM365ConversationReference,
+  captureTeamsConversationReference,
+  continueM365Conversation,
   createTeamsApprovalRequestCard,
   createTeamsChannelAdapter,
   createTeamsDialog,
@@ -1165,11 +938,14 @@ export {
   createTeamsSearchMessage,
   createTeamsSearchResult,
   currentTeamsTurnContext,
+  isTargetedTeamsActivity,
+  makeTargetedTeamsActivity,
   mountTeamsAgent,
   parseTeamsActivity,
   parseTeamsActivitySafe,
   parseTeamsChannelData,
   parseTeamsInputRequestSubmit,
+  restoreM365ConversationReference,
   runWithTeamsTurnContext,
   sendTeamsInvoke
 };