openclaw/extensions/msteams/src/inbound.ts

// Msteams plugin module implements inbound behavior.
import { decodeHtmlEntities } from "openclaw/plugin-sdk/html-entity-runtime";

type MSTeamsQuoteInfo = {
  sender: string;
  body: string;
  /**
   * The quoted message's Teams id (the blockquote `itemid`). Present when Teams
   * includes it; used to fetch the complete message text via Graph because the
   * inbound blockquote only carries a truncated `preview` snippet.
   */
  id?: string;
};

/**
 * Strip HTML tags, preserving text content.
 */
function htmlToPlainText(html: string): string {
  return decodeHtmlEntities(html.replace(/<[^>]*>/g, " "))
    .replaceAll("\u00a0", " ")
    .replace(/\s+/g, " ")
    .trim();
}

/**
 * Extract quote info from MS Teams HTML reply attachments.
 * Teams wraps quoted content in a blockquote with itemtype="http://schema.skype.com/Reply".
 */
export function extractMSTeamsQuoteInfo(
  attachments: Array<{ contentType?: string | null; content?: unknown }>,
): MSTeamsQuoteInfo | undefined {
  for (const att of attachments) {
    // Content may be a plain string or an object with .text/.body (e.g. Adaptive Card payloads).
    let content = "";
    if (typeof att.content === "string") {
      content = att.content;
    } else if (typeof att.content === "object" && att.content !== null) {
      const record = att.content as Record<string, unknown>;
      content =
        typeof record.text === "string"
          ? record.text
          : typeof record.body === "string"
            ? record.body
            : "";
    }
    if (!content) {
      continue;
    }

    // Look for the Skype Reply schema blockquote.
    if (!content.includes("http://schema.skype.com/Reply")) {
      continue;
    }

    // Extract sender from <strong itemprop="mri">.
    const senderMatch = /<strong[^>]*itemprop=["']mri["'][^>]*>(.*?)<\/strong>/i.exec(content);
    const sender = senderMatch?.[1] ? htmlToPlainText(senderMatch[1]) : undefined;

    // Extract body from <p itemprop="copy"> (full quoted text) and fall back to
    // <p itemprop="preview"> — the truncated snippet Teams actually sends for
    // quote replies. Prefer `copy` when both are present.
    const copyMatch = /<p[^>]*itemprop=["']copy["'][^>]*>(.*?)<\/p>/is.exec(content);
    const bodyMatch =
      copyMatch ?? /<p[^>]*itemprop=["']preview["'][^>]*>(.*?)<\/p>/is.exec(content);
    const body = bodyMatch?.[1] ? htmlToPlainText(bodyMatch[1]) : undefined;

    // Capture the blockquote `itemid` (the quoted message's Teams id) so callers
    // can fetch the complete message text via Graph when only a preview snippet
    // is available.
    const idMatch = /<blockquote[^>]*\bitemid=["']([^"']+)["'][^>]*>/is.exec(content);
    const id = idMatch?.[1]?.trim() || undefined;

    if (body) {
      return { sender: sender ?? "unknown", body, ...(id ? { id } : {}) };
    }
  }
  return undefined;
}

type MentionableActivity = {
  recipient?: { id?: string } | null;
  entities?: Array<{
    type?: string;
    mentioned?: { id?: string };
  }> | null;
};

export function normalizeMSTeamsConversationId(raw: string): string {
  return raw.split(";")[0] ?? raw;
}

export function extractMSTeamsConversationMessageId(raw: string): string | undefined {
  if (!raw) {
    return undefined;
  }
  const match = /(?:^|;)messageid=([^;]+)/i.exec(raw);
  const value = match?.[1]?.trim() ?? "";
  return value || undefined;
}

export function parseMSTeamsActivityTimestamp(value: unknown): Date | undefined {
  if (!value) {
    return undefined;
  }
  if (value instanceof Date) {
    return value;
  }
  if (typeof value !== "string") {
    return undefined;
  }
  const date = new Date(value);
  return Number.isNaN(date.getTime()) ? undefined : date;
}

export function stripMSTeamsMentionTags(text: string): string {
  // Teams wraps mentions in <at>...</at> tags
  return text.replace(/<at[^>]*>.*?<\/at>/gi, "").trim();
}

export function wasMSTeamsBotMentioned(activity: MentionableActivity): boolean {
  const botId = activity.recipient?.id;
  if (!botId) {
    return false;
  }
  const entities = activity.entities ?? [];
  return entities.some((e) => e.type === "mention" && e.mentioned?.id === botId);
}