@openclaw/msteams 2026.1.29 → 2026.2.2

package/src/errors.ts

@@ -1,12 +1,22 @@
 export function formatUnknownError(err: unknown): string {
-  if (err instanceof Error) return err.message;
-  if (typeof err === "string") return err;
-  if (err === null) return "null";
-  if (err === undefined) return "undefined";
+  if (err instanceof Error) {
+    return err.message;
+  }
+  if (typeof err === "string") {
+    return err;
+  }
+  if (err === null) {
+    return "null";
+  }
+  if (err === undefined) {
+    return "undefined";
+  }
   if (typeof err === "number" || typeof err === "boolean" || typeof err === "bigint") {
     return String(err);
   }
-  if (typeof err === "symbol") return err.description ?? err.toString();
+  if (typeof err === "symbol") {
+    return err.description ?? err.toString();
+  }
   if (typeof err === "function") {
     return err.name ? `[function ${err.name}]` : "[function]";
   }
@@ -22,21 +32,31 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 }
 
 function extractStatusCode(err: unknown): number | null {
-  if (!isRecord(err)) return null;
+  if (!isRecord(err)) {
+    return null;
+  }
   const direct = err.statusCode ?? err.status;
-  if (typeof direct === "number" && Number.isFinite(direct)) return direct;
+  if (typeof direct === "number" && Number.isFinite(direct)) {
+    return direct;
+  }
   if (typeof direct === "string") {
     const parsed = Number.parseInt(direct, 10);
-    if (Number.isFinite(parsed)) return parsed;
+    if (Number.isFinite(parsed)) {
+      return parsed;
+    }
   }
 
   const response = err.response;
   if (isRecord(response)) {
     const status = response.status;
-    if (typeof status === "number" && Number.isFinite(status)) return status;
+    if (typeof status === "number" && Number.isFinite(status)) {
+      return status;
+    }
     if (typeof status === "string") {
       const parsed = Number.parseInt(status, 10);
-      if (Number.isFinite(parsed)) return parsed;
+      if (Number.isFinite(parsed)) {
+        return parsed;
+      }
     }
   }
 
@@ -44,7 +64,9 @@ function extractStatusCode(err: unknown): number | null {
 }
 
 function extractRetryAfterMs(err: unknown): number | null {
-  if (!isRecord(err)) return null;
+  if (!isRecord(err)) {
+    return null;
+  }
 
   const direct = err.retryAfterMs ?? err.retry_after_ms;
   if (typeof direct === "number" && Number.isFinite(direct) && direct >= 0) {
@@ -57,20 +79,28 @@ function extractRetryAfterMs(err: unknown): number | null {
   }
   if (typeof retryAfter === "string") {
     const parsed = Number.parseFloat(retryAfter);
-    if (Number.isFinite(parsed) && parsed >= 0) return parsed * 1000;
+    if (Number.isFinite(parsed) && parsed >= 0) {
+      return parsed * 1000;
+    }
   }
 
   const response = err.response;
-  if (!isRecord(response)) return null;
+  if (!isRecord(response)) {
+    return null;
+  }
 
   const headers = response.headers;
-  if (!headers) return null;
+  if (!headers) {
+    return null;
+  }
 
   if (isRecord(headers)) {
     const raw = headers["retry-after"] ?? headers["Retry-After"];
     if (typeof raw === "string") {
       const parsed = Number.parseFloat(raw);
-      if (Number.isFinite(parsed) && parsed >= 0) return parsed * 1000;
+      if (Number.isFinite(parsed) && parsed >= 0) {
+        return parsed * 1000;
+      }
     }
   }
 
@@ -84,7 +114,9 @@ function extractRetryAfterMs(err: unknown): number | null {
     const raw = (headers as { get: (name: string) => string | null }).get("retry-after");
     if (raw) {
       const parsed = Number.parseFloat(raw);
-      if (Number.isFinite(parsed) && parsed >= 0) return parsed * 1000;
+      if (Number.isFinite(parsed) && parsed >= 0) {
+        return parsed * 1000;
+      }
     }
   }
 

package/src/file-consent-helpers.test.ts

@@ -186,7 +186,10 @@ describe("prepareFileConsentActivity", () => {
       conversationId: "conv456",
     });
 
-    const attachment = (result.activity.attachments as unknown[])[0] as Record<string, { description: string }>;
+    const attachment = (result.activity.attachments as unknown[])[0] as Record<
+      string,
+      { description: string }
+    >;
     expect(attachment.content.description).toBe("File: document.docx");
   });
 
@@ -201,7 +204,10 @@ describe("prepareFileConsentActivity", () => {
       description: "Q4 Financial Report",
     });
 
-    const attachment = (result.activity.attachments as unknown[])[0] as Record<string, { description: string }>;
+    const attachment = (result.activity.attachments as unknown[])[0] as Record<
+      string,
+      { description: string }
+    >;
     expect(attachment.content.description).toBe("Q4 Financial Report");
   });
 
@@ -215,7 +221,10 @@ describe("prepareFileConsentActivity", () => {
       conversationId: "conv000",
     });
 
-    const attachment = (result.activity.attachments as unknown[])[0] as Record<string, { acceptContext: { uploadId: string } }>;
+    const attachment = (result.activity.attachments as unknown[])[0] as Record<
+      string,
+      { acceptContext: { uploadId: string } }
+    >;
     expect(attachment.content.acceptContext.uploadId).toBe(mockUploadId);
   });
 

package/src/file-consent.ts

@@ -78,7 +78,9 @@ export function parseFileConsentInvoke(activity: {
   name?: string;
   value?: unknown;
 }): FileConsentResponse | null {
-  if (activity.name !== "fileConsent/invoke") return null;
+  if (activity.name !== "fileConsent/invoke") {
+    return null;
+  }
 
   const value = activity.value as {
     type?: string;
@@ -87,7 +89,9 @@ export function parseFileConsentInvoke(activity: {
     context?: Record<string, unknown>;
   };
 
-  if (value?.type !== "fileUpload") return null;
+  if (value?.type !== "fileUpload") {
+    return null;
+  }
 
   return {
     action: value.action === "accept" ? "accept" : "decline",

package/src/graph-chat.ts

@@ -31,10 +31,11 @@ export function buildTeamsFileInfoCard(file: DriveItemProperties): {
   // Extract unique ID from eTag (remove quotes, braces, and version suffix)
   // Example eTag formats: "{GUID},version" or "\"{GUID},version\""
   const rawETag = file.eTag;
-  const uniqueId = rawETag
-    .replace(/^["']|["']$/g, "") // Remove outer quotes
-    .replace(/[{}]/g, "") // Remove curly braces
-    .split(",")[0] ?? rawETag; // Take the GUID part before comma
+  const uniqueId =
+    rawETag
+      .replace(/^["']|["']$/g, "") // Remove outer quotes
+      .replace(/[{}]/g, "") // Remove curly braces
+      .split(",")[0] ?? rawETag; // Take the GUID part before comma
 
   // Extract file extension from filename
   const lastDot = file.name.lastIndexOf(".");

package/src/graph-upload.ts

@@ -182,14 +182,17 @@ export async function uploadToSharePoint(params: {
   // Use "OpenClawShared" folder to organize bot-uploaded files
   const uploadPath = `/OpenClawShared/${encodeURIComponent(params.filename)}`;
 
-  const res = await fetchFn(`${GRAPH_ROOT}/sites/${params.siteId}/drive/root:${uploadPath}:/content`, {
-    method: "PUT",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": params.contentType ?? "application/octet-stream",
+  const res = await fetchFn(
+    `${GRAPH_ROOT}/sites/${params.siteId}/drive/root:${uploadPath}:/content`,
+    {
+      method: "PUT",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": params.contentType ?? "application/octet-stream",
+      },
+      body: new Uint8Array(params.buffer),
     },
-    body: new Uint8Array(params.buffer),
-  });
+  );
 
   if (!res.ok) {
     const body = await res.text().catch(() => "");
@@ -342,18 +345,23 @@ export async function createSharePointSharingLink(params: {
     body.recipients = params.recipientObjectIds.map((id) => ({ objectId: id }));
   }
 
-  const res = await fetchFn(`${apiRoot}/sites/${params.siteId}/drive/items/${params.itemId}/createLink`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json",
+  const res = await fetchFn(
+    `${apiRoot}/sites/${params.siteId}/drive/items/${params.itemId}/createLink`,
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify(body),
     },
-    body: JSON.stringify(body),
-  });
+  );
 
   if (!res.ok) {
     const respBody = await res.text().catch(() => "");
-    throw new Error(`Create SharePoint sharing link failed: ${res.status} ${res.statusText} - ${respBody}`);
+    throw new Error(
+      `Create SharePoint sharing link failed: ${res.status} ${res.statusText} - ${respBody}`,
+    );
   }
 
   const data = (await res.json()) as {

package/src/inbound.test.ts

@@ -1,5 +1,4 @@
 import { describe, expect, it } from "vitest";
-
 import {
   normalizeMSTeamsConversationId,
   parseMSTeamsActivityTimestamp,

package/src/inbound.ts

@@ -11,16 +11,24 @@ export function normalizeMSTeamsConversationId(raw: string): string {
 }
 
 export function extractMSTeamsConversationMessageId(raw: string): string | undefined {
-  if (!raw) return 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;
+  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;
 }
@@ -32,7 +40,9 @@ export function stripMSTeamsMentionTags(text: string): string {
 
 export function wasMSTeamsBotMentioned(activity: MentionableActivity): boolean {
   const botId = activity.recipient?.id;
-  if (!botId) return false;
+  if (!botId) {
+    return false;
+  }
   const entities = activity.entities ?? [];
   return entities.some((e) => e.type === "mention" && e.mentioned?.id === botId);
 }

package/src/media-helpers.test.ts

@@ -1,5 +1,4 @@
 import { describe, expect, it } from "vitest";
-
 import { extractFilename, extractMessageId, getMimeType, isLocalPath } from "./media-helpers.js";
 
 describe("msteams media-helpers", () => {
@@ -46,7 +45,9 @@ describe("msteams media-helpers", () => {
 
     it("defaults to application/octet-stream for unknown extensions", async () => {
       expect(await getMimeType("https://example.com/image")).toBe("application/octet-stream");
-      expect(await getMimeType("https://example.com/image.unknown")).toBe("application/octet-stream");
+      expect(await getMimeType("https://example.com/image.unknown")).toBe(
+        "application/octet-stream",
+      );
     });
 
     it("is case-insensitive", async () => {
@@ -110,15 +111,17 @@ describe("msteams media-helpers", () => {
 
     it("extracts original filename with uppercase UUID", async () => {
       expect(
-        await extractFilename("/media/inbound/Document---A1B2C3D4-E5F6-7890-ABCD-EF1234567890.docx"),
+        await extractFilename(
+          "/media/inbound/Document---A1B2C3D4-E5F6-7890-ABCD-EF1234567890.docx",
+        ),
       ).toBe("Document.docx");
     });
 
     it("falls back to UUID filename for legacy paths", async () => {
       // UUID-only filename (legacy format, no embedded name)
-      expect(
-        await extractFilename("/media/inbound/a1b2c3d4-e5f6-7890-abcd-ef1234567890.pdf"),
-      ).toBe("a1b2c3d4-e5f6-7890-abcd-ef1234567890.pdf");
+      expect(await extractFilename("/media/inbound/a1b2c3d4-e5f6-7890-abcd-ef1234567890.pdf")).toBe(
+        "a1b2c3d4-e5f6-7890-abcd-ef1234567890.pdf",
+      );
     });
 
     it("handles --- in filename without valid UUID pattern", async () => {

package/src/media-helpers.ts

@@ -3,7 +3,6 @@
  */
 
 import path from "node:path";
-
 import {
   detectMime,
   extensionForMime,
@@ -19,7 +18,9 @@ export async function getMimeType(url: string): Promise<string> {
   // Handle data URLs: data:image/png;base64,...
   if (url.startsWith("data:")) {
     const match = url.match(/^data:([^;,]+)/);
-    if (match?.[1]) return match[1];
+    if (match?.[1]) {
+      return match[1];
+    }
   }
 
   // Use shared MIME detection (extension-based for URLs)
@@ -46,7 +47,9 @@ export async function extractFilename(url: string): Promise<string> {
     const pathname = new URL(url).pathname;
     const basename = path.basename(pathname);
     const existingExt = getFileExtension(pathname);
-    if (basename && existingExt) return basename;
+    if (basename && existingExt) {
+      return basename;
+    }
     // No extension in URL, derive from MIME
     const mime = await getMimeType(url);
     const ext = extensionForMime(mime) ?? ".bin";
@@ -69,9 +72,15 @@ export function isLocalPath(url: string): boolean {
  * Extract the message ID from a Bot Framework response.
  */
 export function extractMessageId(response: unknown): string | null {
-  if (!response || typeof response !== "object") return null;
-  if (!("id" in response)) return null;
+  if (!response || typeof response !== "object") {
+    return null;
+  }
+  if (!("id" in response)) {
+    return null;
+  }
   const { id } = response as { id?: unknown };
-  if (typeof id !== "string" || !id) return null;
+  if (typeof id !== "string" || !id) {
+    return null;
+  }
   return id;
 }

package/src/messenger.test.ts

@@ -1,6 +1,5 @@
-import { beforeEach, describe, expect, it } from "vitest";
-
 import { SILENT_REPLY_TOKEN, type PluginRuntime } from "openclaw/plugin-sdk";
+import { beforeEach, describe, expect, it } from "vitest";
 import type { StoredConversationReference } from "./conversation-store.js";
 import {
   type MSTeamsAdapter,
@@ -10,8 +9,12 @@ import {
 import { setMSTeamsRuntime } from "./runtime.js";
 
 const chunkMarkdownText = (text: string, limit: number) => {
-  if (!text) return [];
-  if (limit <= 0 || text.length <= limit) return [text];
+  if (!text) {
+    return [];
+  }
+  if (limit <= 0 || text.length <= limit) {
+    return [text];
+  }
   const chunks: string[] = [];
   for (let index = 0; index < text.length; index += limit) {
     chunks.push(text.slice(index, index + limit));

package/src/messenger.ts

@@ -134,7 +134,9 @@ function pushTextMessages(
     chunkMode: ChunkMode;
   },
 ) {
-  if (!text) return;
+  if (!text) {
+    return;
+  }
   if (opts.chunkText) {
     for (const chunk of getMSTeamsRuntime().channel.text.chunkMarkdownTextWithMode(
       text,
@@ -142,26 +144,33 @@ function pushTextMessages(
       opts.chunkMode,
     )) {
       const trimmed = chunk.trim();
-      if (!trimmed || isSilentReplyText(trimmed, SILENT_REPLY_TOKEN)) continue;
+      if (!trimmed || isSilentReplyText(trimmed, SILENT_REPLY_TOKEN)) {
+        continue;
+      }
       out.push({ text: trimmed });
     }
     return;
   }
 
   const trimmed = text.trim();
-  if (!trimmed || isSilentReplyText(trimmed, SILENT_REPLY_TOKEN)) return;
+  if (!trimmed || isSilentReplyText(trimmed, SILENT_REPLY_TOKEN)) {
+    return;
+  }
   out.push({ text: trimmed });
 }
 
-
 function clampMs(value: number, maxMs: number): number {
-  if (!Number.isFinite(value) || value < 0) return 0;
+  if (!Number.isFinite(value) || value < 0) {
+    return 0;
+  }
   return Math.min(value, maxMs);
 }
 
 async function sleep(ms: number): Promise<void> {
   const delay = Math.max(0, ms);
-  if (delay === 0) return;
+  if (delay === 0) {
+    return;
+  }
   await new Promise<void>((resolve) => {
     setTimeout(resolve, delay);
   });
@@ -220,7 +229,9 @@ export function renderReplyPayloadsToMessages(
       tableMode,
     );
 
-    if (!text && mediaList.length === 0) continue;
+    if (!text && mediaList.length === 0) {
+      continue;
+    }
 
     if (mediaList.length === 0) {
       pushTextMessages(out, text, { chunkText, chunkLimit, chunkMode });
@@ -234,7 +245,9 @@ export function renderReplyPayloadsToMessages(
         out.push({ text: text || undefined, mediaUrl: firstMedia });
         // Additional media URLs as separate messages
         for (let i = 1; i < mediaList.length; i++) {
-          if (mediaList[i]) out.push({ mediaUrl: mediaList[i] });
+          if (mediaList[i]) {
+            out.push({ mediaUrl: mediaList[i] });
+          }
         }
       } else {
         pushTextMessages(out, text, { chunkText, chunkLimit, chunkMode });
@@ -245,7 +258,9 @@ export function renderReplyPayloadsToMessages(
     // mediaMode === "split"
     pushTextMessages(out, text, { chunkText, chunkLimit, chunkMode });
     for (const mediaUrl of mediaList) {
-      if (!mediaUrl) continue;
+      if (!mediaUrl) {
+        continue;
+      }
       out.push({ mediaUrl });
     }
   }
@@ -283,12 +298,14 @@ async function buildActivity(
       const isPersonal = conversationType === "personal";
       const isImage = contentType?.startsWith("image/") ?? false;
 
-      if (requiresFileConsent({
-        conversationType,
-        contentType,
-        bufferSize: media.buffer.length,
-        thresholdBytes: FILE_CONSENT_THRESHOLD_BYTES,
-      })) {
+      if (
+        requiresFileConsent({
+          conversationType,
+          contentType,
+          bufferSize: media.buffer.length,
+          thresholdBytes: FILE_CONSENT_THRESHOLD_BYTES,
+        })
+      ) {
         // Large file or non-image in personal chat: use FileConsentCard flow
         const conversationId = conversationRef.conversation?.id ?? "unknown";
         const { activity: consentActivity } = prepareFileConsentActivity({
@@ -382,7 +399,9 @@ export async function sendMSTeamsMessages(params: {
   const messages = params.messages.filter(
     (m) => (m.text && m.text.trim().length > 0) || m.mediaUrl,
   );
-  if (messages.length === 0) return [];
+  if (messages.length === 0) {
+    return [];
+  }
 
   const retryOptions = resolveRetryOptions(params.retry);
 
@@ -390,7 +409,9 @@ export async function sendMSTeamsMessages(params: {
     sendOnce: () => Promise<unknown>,
     meta: { messageIndex: number; messageCount: number },
   ): Promise<unknown> => {
-    if (!retryOptions.enabled) return await sendOnce();
+    if (!retryOptions.enabled) {
+      return await sendOnce();
+    }
 
     let attempt = 1;
     while (true) {
@@ -399,7 +420,9 @@ export async function sendMSTeamsMessages(params: {
       } catch (err) {
         const classification = classifyMSTeamsSendError(err);
         const canRetry = attempt < retryOptions.maxAttempts && shouldRetry(classification);
-        if (!canRetry) throw err;
+        if (!canRetry) {
+          throw err;
+        }
 
         const delayMs = computeRetryDelayMs(attempt, classification, retryOptions);
         const nextAttempt = attempt + 1;
@@ -428,7 +451,13 @@ export async function sendMSTeamsMessages(params: {
       const response = await sendWithRetry(
         async () =>
           await ctx.sendActivity(
-            await buildActivity(message, params.conversationRef, params.tokenProvider, params.sharePointSiteId, params.mediaMaxBytes),
+            await buildActivity(
+              message,
+              params.conversationRef,
+              params.tokenProvider,
+              params.sharePointSiteId,
+              params.mediaMaxBytes,
+            ),
           ),
         { messageIndex: idx, messageCount: messages.length },
       );
@@ -449,7 +478,13 @@ export async function sendMSTeamsMessages(params: {
       const response = await sendWithRetry(
         async () =>
           await ctx.sendActivity(
-            await buildActivity(message, params.conversationRef, params.tokenProvider, params.sharePointSiteId, params.mediaMaxBytes),
+            await buildActivity(
+              message,
+              params.conversationRef,
+              params.tokenProvider,
+              params.sharePointSiteId,
+              params.mediaMaxBytes,
+            ),
           ),
         { messageIndex: idx, messageCount: messages.length },
       );

package/src/monitor-handler/inbound-media.ts

@@ -1,3 +1,4 @@
+import type { MSTeamsTurnContext } from "../sdk-types.js";
 import {
   buildMSTeamsGraphMessageUrls,
   downloadMSTeamsAttachments,
@@ -7,7 +8,6 @@ import {
   type MSTeamsHtmlAttachmentSummary,
   type MSTeamsInboundMedia,
 } from "../attachments.js";
-import type { MSTeamsTurnContext } from "../sdk-types.js";
 
 type MSTeamsLogger = {
   debug: (message: string, meta?: Record<string, unknown>) => void;
@@ -18,6 +18,7 @@ export async function resolveMSTeamsInboundMedia(params: {
   htmlSummary?: MSTeamsHtmlAttachmentSummary;
   maxBytes: number;
   allowHosts?: string[];
+  authAllowHosts?: string[];
   tokenProvider: MSTeamsAccessTokenProvider;
   conversationType: string;
   conversationId: string;
@@ -46,6 +47,7 @@ export async function resolveMSTeamsInboundMedia(params: {
     maxBytes,
     tokenProvider,
     allowHosts,
+    authAllowHosts: params.authAllowHosts,
     preserveFilenames,
   });
 
@@ -85,6 +87,7 @@ export async function resolveMSTeamsInboundMedia(params: {
             tokenProvider,
             maxBytes,
             allowHosts,
+            authAllowHosts: params.authAllowHosts,
             preserveFilenames,
           });
           attempts.push({
@@ -99,7 +102,9 @@ export async function resolveMSTeamsInboundMedia(params: {
             mediaList = graphMedia.media;
             break;
           }
-          if (graphMedia.tokenError) break;
+          if (graphMedia.tokenError) {
+            break;
+          }
         }
         if (mediaList.length === 0) {
           log.debug("graph media fetch empty", { attempts });