@kodelyth/msteams 2026.5.42 → 2026.6.2

package/src/resolve-allowlist.ts

@@ -1,309 +0,0 @@
-import { mapAllowlistResolutionInputs } from "klaw/plugin-sdk/allow-from";
-import {
-  normalizeLowercaseStringOrEmpty,
-  normalizeOptionalLowercaseString,
-} from "klaw/plugin-sdk/string-coerce-runtime";
-import { searchGraphUsers } from "./graph-users.js";
-import {
-  listChannelsForTeam,
-  listTeamsByName,
-  normalizeQuery,
-  resolveGraphToken,
-} from "./graph.js";
-
-type MSTeamsChannelResolution = {
-  input: string;
-  resolved: boolean;
-  teamId?: string;
-  teamName?: string;
-  channelId?: string;
-  channelName?: string;
-  note?: string;
-};
-
-type MSTeamsUserResolution = {
-  input: string;
-  resolved: boolean;
-  id?: string;
-  name?: string;
-  note?: string;
-};
-
-function stripProviderPrefix(raw: string): string {
-  return raw.replace(/^(msteams|teams):/i, "");
-}
-
-export function normalizeMSTeamsMessagingTarget(raw: string): string | undefined {
-  let trimmed = raw.trim();
-  if (!trimmed) {
-    return undefined;
-  }
-  trimmed = stripProviderPrefix(trimmed).trim();
-  if (/^conversation:/i.test(trimmed)) {
-    const id = trimmed.slice("conversation:".length).trim();
-    return id ? `conversation:${id}` : undefined;
-  }
-  if (/^user:/i.test(trimmed)) {
-    const id = trimmed.slice("user:".length).trim();
-    return id ? `user:${id}` : undefined;
-  }
-  return trimmed || undefined;
-}
-
-export function normalizeMSTeamsUserInput(raw: string): string {
-  return stripProviderPrefix(raw)
-    .replace(/^(user|conversation):/i, "")
-    .trim();
-}
-
-export function parseMSTeamsConversationId(raw: string): string | null {
-  const trimmed = stripProviderPrefix(raw).trim();
-  if (!/^conversation:/i.test(trimmed)) {
-    return null;
-  }
-  const id = trimmed.slice("conversation:".length).trim();
-  return id;
-}
-
-/**
- * Detect whether a raw target string looks like a Microsoft Teams conversation
- * or user id that cron announce delivery and other explicit-target paths can
- * forward verbatim to the channel adapter.
- *
- * Accepts both prefixed and bare formats:
- * - `conversation:<id>` — explicit conversation prefix
- * - `user:<aad-guid>`   — user id (16+ hex chars, UUID-like)
- * - `19:abc@thread.tacv2` / `19:abc@thread.skype` — channel / legacy group
- * - `19:{userId}_{appId}@unq.gbl.spaces` — Graph 1:1 chat thread format
- * - `a:1xxx` — Bot Framework personal (1:1) chat id
- * - `8:orgid:xxx` — Bot Framework org-scoped personal chat id
- * - `29:xxx` — Bot Framework user id
- *
- * Display-name user targets such as `user:John Smith` intentionally return
- * false so that the Graph API directory lookup still runs for them.
- */
-export function looksLikeMSTeamsTargetId(raw: string): boolean {
-  const trimmed = raw.trim();
-  if (!trimmed) {
-    return false;
-  }
-  if (/^conversation:/i.test(trimmed)) {
-    return true;
-  }
-  if (/^user:/i.test(trimmed)) {
-    // Only treat as an id when the value after `user:` looks like a UUID;
-    // display names must fall through to directory lookup.
-    const id = trimmed.slice("user:".length).trim();
-    return /^[0-9a-fA-F-]{16,}$/.test(id);
-  }
-  // Bare Bot Framework / Graph conversation id formats.
-  // Channel / group ids always start with `19:` and include an `@thread.*`
-  // suffix (`@thread.tacv2` or the legacy `@thread.skype`). Personal chat
-  // ids come in three shapes: `a:1...` (Bot Framework), `8:orgid:...`
-  // (org-scoped Bot Framework), and `19:{userId}_{appId}@unq.gbl.spaces`
-  // (Graph API 1:1 chat thread). Bot Framework user ids use `29:...`.
-  if (/^19:.+@thread\.(tacv2|skype)$/i.test(trimmed)) {
-    return true;
-  }
-  if (/^19:.+@unq\.gbl\.spaces$/i.test(trimmed)) {
-    return true;
-  }
-  if (/^a:1[A-Za-z0-9_-]+$/i.test(trimmed)) {
-    return true;
-  }
-  if (/^8:orgid:[A-Za-z0-9-]+$/i.test(trimmed)) {
-    return true;
-  }
-  if (/^29:[A-Za-z0-9_-]+$/i.test(trimmed)) {
-    return true;
-  }
-  // Fallback: anything containing @thread is still treated as a conversation
-  // id so the current matches for tenant-specific suffixes remain accepted.
-  return /@thread\b/i.test(trimmed);
-}
-
-function normalizeMSTeamsTeamKey(raw: string): string | undefined {
-  const trimmed = stripProviderPrefix(raw)
-    .replace(/^team:/i, "")
-    .trim();
-  return trimmed || undefined;
-}
-
-function normalizeMSTeamsChannelKey(raw?: string | null): string | undefined {
-  const trimmed = raw?.trim().replace(/^#/, "").trim() ?? "";
-  return trimmed || undefined;
-}
-
-function normalizeMSTeamsConversationTargetId(raw: string): string {
-  const trimmed = stripProviderPrefix(raw).trim();
-  return parseMSTeamsConversationId(trimmed) ?? trimmed;
-}
-
-function looksLikeMSTeamsThreadConversationId(raw: string): boolean {
-  const normalized = normalizeMSTeamsConversationTargetId(raw);
-  return /^19:.+@thread\./i.test(normalized);
-}
-
-export function parseMSTeamsTeamChannelInput(raw: string): { team?: string; channel?: string } {
-  const trimmed = stripProviderPrefix(raw).trim();
-  if (!trimmed) {
-    return {};
-  }
-  const parts = trimmed.split("/");
-  const team = normalizeMSTeamsTeamKey(parts[0] ?? "");
-  const channel =
-    parts.length > 1 ? normalizeMSTeamsChannelKey(parts.slice(1).join("/")) : undefined;
-  return {
-    ...(team ? { team } : {}),
-    ...(channel ? { channel } : {}),
-  };
-}
-
-export function parseMSTeamsTeamEntry(
-  raw: string,
-): { teamKey: string; channelKey?: string } | null {
-  const { team, channel } = parseMSTeamsTeamChannelInput(raw);
-  if (!team) {
-    return null;
-  }
-  return {
-    teamKey: team,
-    ...(channel ? { channelKey: channel } : {}),
-  };
-}
-
-export async function resolveMSTeamsChannelAllowlist(params: {
-  cfg: unknown;
-  entries: string[];
-}): Promise<MSTeamsChannelResolution[]> {
-  let tokenPromise: Promise<string> | undefined;
-  const getToken = () => {
-    tokenPromise ??= resolveGraphToken(params.cfg);
-    return tokenPromise;
-  };
-  return await mapAllowlistResolutionInputs({
-    inputs: params.entries,
-    mapInput: async (input): Promise<MSTeamsChannelResolution> => {
-      const { team, channel } = parseMSTeamsTeamChannelInput(input);
-      if (!team) {
-        return { input, resolved: false };
-      }
-      if (looksLikeMSTeamsThreadConversationId(team)) {
-        const teamId = normalizeMSTeamsConversationTargetId(team);
-        if (!channel) {
-          return { input, resolved: true, teamId, teamName: teamId };
-        }
-        if (!looksLikeMSTeamsThreadConversationId(channel)) {
-          return {
-            input,
-            resolved: false,
-            teamId,
-            teamName: teamId,
-            note: "channel id required for conversation-id team",
-          };
-        }
-        const channelId = normalizeMSTeamsConversationTargetId(channel);
-        return {
-          input,
-          resolved: true,
-          teamId,
-          teamName: teamId,
-          channelId,
-          channelName: channelId,
-        };
-      }
-      const token = await getToken();
-      const teams = /^[0-9a-fA-F-]{16,}$/.test(team)
-        ? [{ id: team, displayName: team }]
-        : await listTeamsByName(token, team);
-      if (teams.length === 0) {
-        return { input, resolved: false, note: "team not found" };
-      }
-      const teamMatch = teams[0];
-      const graphTeamId = teamMatch.id?.trim();
-      const teamName = teamMatch.displayName?.trim() || team;
-      if (!graphTeamId) {
-        return { input, resolved: false, note: "team id missing" };
-      }
-      // Bot Framework sends the General channel's conversation ID as
-      // channelData.team.id at runtime, NOT the Graph API group GUID.
-      // Fetch channels upfront so we can resolve the correct key format for
-      // runtime matching and reuse the list for channel lookups.
-      let teamChannels: Awaited<ReturnType<typeof listChannelsForTeam>> = [];
-      try {
-        teamChannels = await listChannelsForTeam(token, graphTeamId);
-      } catch {
-        // API failure (rate limit, network error) — fall back to Graph GUID as team key
-      }
-      const generalChannel = teamChannels.find(
-        (ch) => normalizeOptionalLowercaseString(ch.displayName) === "general",
-      );
-      // Use the General channel's conversation ID as the team key — this
-      // matches what Bot Framework sends at runtime. Fall back to the Graph
-      // GUID if the General channel isn't found (renamed or deleted).
-      const teamId = generalChannel?.id?.trim() || graphTeamId;
-      if (!channel) {
-        return {
-          input,
-          resolved: true,
-          teamId,
-          teamName,
-          note: teams.length > 1 ? "multiple teams; chose first" : undefined,
-        };
-      }
-      // Reuse teamChannels — already fetched above
-      const normalizedChannel = normalizeOptionalLowercaseString(channel);
-      const channelMatch =
-        teamChannels.find((item) => item.id === channel) ??
-        teamChannels.find(
-          (item) => normalizeOptionalLowercaseString(item.displayName) === normalizedChannel,
-        ) ??
-        teamChannels.find((item) =>
-          normalizeLowercaseStringOrEmpty(item.displayName ?? "").includes(normalizedChannel ?? ""),
-        );
-      if (!channelMatch?.id) {
-        return { input, resolved: false, note: "channel not found" };
-      }
-      return {
-        input,
-        resolved: true,
-        teamId,
-        teamName,
-        channelId: channelMatch.id,
-        channelName: channelMatch.displayName ?? channel,
-        note: teamChannels.length > 1 ? "multiple channels; chose first" : undefined,
-      };
-    },
-  });
-}
-
-export async function resolveMSTeamsUserAllowlist(params: {
-  cfg: unknown;
-  entries: string[];
-}): Promise<MSTeamsUserResolution[]> {
-  const token = await resolveGraphToken(params.cfg);
-  return await mapAllowlistResolutionInputs({
-    inputs: params.entries,
-    mapInput: async (input): Promise<MSTeamsUserResolution> => {
-      const query = normalizeQuery(normalizeMSTeamsUserInput(input));
-      if (!query) {
-        return { input, resolved: false };
-      }
-      if (/^[0-9a-fA-F-]{16,}$/.test(query)) {
-        return { input, resolved: true, id: query };
-      }
-      const users = await searchGraphUsers({ token, query, top: 10 });
-      const match = users[0];
-      if (!match?.id) {
-        return { input, resolved: false };
-      }
-      return {
-        input,
-        resolved: true,
-        id: match.id,
-        name: match.displayName ?? undefined,
-        note: users.length > 1 ? "multiple matches; chose first" : undefined,
-      };
-    },
-  });
-}

package/src/revoked-context.ts

@@ -1,17 +0,0 @@
-import { isRevokedProxyError } from "./errors.js";
-
-export async function withRevokedProxyFallback<T>(params: {
-  run: () => Promise<T>;
-  onRevoked: () => Promise<T>;
-  onRevokedLog?: () => void;
-}): Promise<T> {
-  try {
-    return await params.run();
-  } catch (err) {
-    if (!isRevokedProxyError(err)) {
-      throw err;
-    }
-    params.onRevokedLog?.();
-    return await params.onRevoked();
-  }
-}

package/src/runtime.ts

@@ -1,12 +0,0 @@
-import { createPluginRuntimeStore } from "klaw/plugin-sdk/runtime-store";
-import type { PluginRuntime } from "klaw/plugin-sdk/runtime-store";
-
-const {
-  setRuntime: setMSTeamsRuntime,
-  getRuntime: getMSTeamsRuntime,
-  tryGetRuntime: getOptionalMSTeamsRuntime,
-} = createPluginRuntimeStore<PluginRuntime>({
-  pluginId: "msteams",
-  errorMessage: "MSTeams runtime not initialized",
-});
-export { getMSTeamsRuntime, getOptionalMSTeamsRuntime, setMSTeamsRuntime };

package/src/sdk-types.ts

@@ -1,59 +0,0 @@
-/**
- * Minimal public surface we depend on from the Microsoft SDK types.
- *
- * Note: we intentionally avoid coupling to SDK classes with private members
- * (like TurnContext) in our own public signatures. The SDK's TS surface is also
- * stricter than what the runtime accepts (e.g. it allows plain activity-like
- * objects), so we model the minimal structural shape we rely on.
- */
-
-type MSTeamsActivity = {
-  type: string;
-  id?: string;
-  timestamp?: string;
-  localTimestamp?: string;
-  channelId?: string;
-  from?: { id?: string; name?: string; aadObjectId?: string; role?: string };
-  conversation?: {
-    id?: string;
-    conversationType?: string;
-    tenantId?: string;
-    name?: string;
-    isGroup?: boolean;
-  };
-  recipient?: { id?: string; name?: string };
-  text?: string;
-  textFormat?: string;
-  locale?: string;
-  serviceUrl?: string;
-  channelData?: {
-    team?: { id?: string; name?: string };
-    channel?: { id?: string; name?: string };
-    tenant?: { id?: string };
-    [key: string]: unknown;
-  };
-  attachments?: Array<{
-    contentType?: string;
-    contentUrl?: string;
-    content?: unknown;
-    name?: string;
-    thumbnailUrl?: string;
-  }>;
-  entities?: Array<Record<string, unknown>>;
-  value?: unknown;
-  name?: string;
-  membersAdded?: Array<{ id?: string; name?: string }>;
-  membersRemoved?: Array<{ id?: string; name?: string }>;
-  replyToId?: string;
-  [key: string]: unknown;
-};
-
-export type MSTeamsTurnContext = {
-  activity: MSTeamsActivity;
-  sendActivity: (textOrActivity: string | object) => Promise<unknown>;
-  sendActivities: (
-    activities: Array<{ type: string } & Record<string, unknown>>,
-  ) => Promise<unknown>;
-  updateActivity: (activity: object) => Promise<{ id?: string } | void>;
-  deleteActivity: (activityId: string) => Promise<void>;
-};