@openclaw/msteams 2026.5.2 → 2026.5.3-beta.1

package/dist/probe-D_H8yFps.js

@@ -0,0 +1,2194 @@
+import { L as getMSTeamsRuntime, O as resolveChannelMediaMaxBytes, _ as getFileExtension, b as loadOutboundMediaFromUrl, d as detectMime, h as extractOriginalFilename, m as extensionForMime, w as normalizeStringEntries } from "./runtime-api-DV1iVMn1.js";
+import { C as loadMSTeamsSdkWithAuth, D as formatMSTeamsSendErrorHint, E as classifyMSTeamsSendError, O as formatUnknownError, S as createMSTeamsTokenProvider, _ as resolveMSTeamsStorePath, h as resolveMSTeamsCredentials, k as isRevokedProxyError, m as loadDelegatedTokens, w as buildUserAgent, x as createMSTeamsAdapter, y as readAccessToken } from "./graph-users-9uQJepqr.js";
+import { convertMarkdownTables, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, sleep } from "openclaw/plugin-sdk/text-runtime";
+import { withFileLock } from "openclaw/plugin-sdk/file-lock";
+import { resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
+import { lookup } from "node:dns/promises";
+import fs from "node:fs";
+import path from "node:path";
+import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
+import crypto from "node:crypto";
+import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
+import { SILENT_REPLY_TOKEN, isSilentReplyText } from "openclaw/plugin-sdk/reply-chunking";
+import { loadWebMedia } from "openclaw/plugin-sdk/web-media";
+//#region extensions/msteams/src/conversation-store-helpers.ts
+function normalizeStoredConversationId(raw) {
+	return raw.split(";")[0] ?? raw;
+}
+function parseStoredConversationTimestamp(value) {
+	if (!value) return null;
+	const parsed = Date.parse(value);
+	if (!Number.isFinite(parsed)) return null;
+	return parsed;
+}
+function toConversationStoreEntries(entries) {
+	return Array.from(entries, ([conversationId, reference]) => ({
+		conversationId,
+		reference
+	}));
+}
+function mergeStoredConversationReference(existing, incoming, nowIso) {
+	return {
+		...existing?.timezone && !incoming.timezone ? { timezone: existing.timezone } : {},
+		...existing?.graphChatId && !incoming.graphChatId ? { graphChatId: existing.graphChatId } : {},
+		...existing?.tenantId && !incoming.tenantId ? { tenantId: existing.tenantId } : {},
+		...existing?.aadObjectId && !incoming.aadObjectId ? { aadObjectId: existing.aadObjectId } : {},
+		...incoming,
+		lastSeenAt: nowIso
+	};
+}
+function findPreferredDmConversationByUserId(entries, id) {
+	const target = id.trim();
+	if (!target) return null;
+	const personalMatches = [];
+	const unknownTypeMatches = [];
+	for (const entry of entries) {
+		if (entry.reference.user?.aadObjectId !== target && entry.reference.user?.id !== target) continue;
+		const convType = normalizeLowercaseStringOrEmpty(entry.reference.conversation?.conversationType ?? "");
+		if (convType === "personal") personalMatches.push(entry);
+		else if (convType === "channel" || convType === "groupchat") {} else unknownTypeMatches.push(entry);
+	}
+	const candidates = personalMatches.length > 0 ? personalMatches : unknownTypeMatches;
+	if (candidates.length === 0) return null;
+	if (candidates.length > 1) candidates.sort((a, b) => (parseStoredConversationTimestamp(b.reference.lastSeenAt) ?? 0) - (parseStoredConversationTimestamp(a.reference.lastSeenAt) ?? 0));
+	return candidates[0] ?? null;
+}
+//#endregion
+//#region extensions/msteams/src/store-fs.ts
+const STORE_LOCK_OPTIONS = {
+	retries: {
+		retries: 10,
+		factor: 2,
+		minTimeout: 100,
+		maxTimeout: 1e4,
+		randomize: true
+	},
+	stale: 3e4
+};
+async function readJsonFile(filePath, fallback) {
+	return await readJsonFileWithFallback(filePath, fallback);
+}
+async function writeJsonFile(filePath, value) {
+	await writeJsonFileAtomically(filePath, value);
+}
+async function ensureJsonFile(filePath, fallback) {
+	try {
+		await fs.promises.access(filePath);
+	} catch {
+		await writeJsonFile(filePath, fallback);
+	}
+}
+async function withFileLock$1(filePath, fallback, fn) {
+	await ensureJsonFile(filePath, fallback);
+	return await withFileLock(filePath, STORE_LOCK_OPTIONS, async () => {
+		return await fn();
+	});
+}
+//#endregion
+//#region extensions/msteams/src/conversation-store-fs.ts
+const STORE_FILENAME$2 = "msteams-conversations.json";
+const MAX_CONVERSATIONS = 1e3;
+const CONVERSATION_TTL_MS = 365 * 24 * 60 * 60 * 1e3;
+function pruneToLimit$2(conversations) {
+	const entries = Object.entries(conversations);
+	if (entries.length <= MAX_CONVERSATIONS) return conversations;
+	entries.sort((a, b) => {
+		return (parseStoredConversationTimestamp(a[1].lastSeenAt) ?? 0) - (parseStoredConversationTimestamp(b[1].lastSeenAt) ?? 0);
+	});
+	const keep = entries.slice(entries.length - MAX_CONVERSATIONS);
+	return Object.fromEntries(keep);
+}
+function pruneExpired$2(conversations, nowMs, ttlMs) {
+	let removed = false;
+	const kept = {};
+	for (const [conversationId, reference] of Object.entries(conversations)) {
+		const lastSeenAt = parseStoredConversationTimestamp(reference.lastSeenAt);
+		if (lastSeenAt != null && nowMs - lastSeenAt > ttlMs) {
+			removed = true;
+			continue;
+		}
+		kept[conversationId] = reference;
+	}
+	return {
+		conversations: kept,
+		removed
+	};
+}
+function createMSTeamsConversationStoreFs(params) {
+	const ttlMs = params?.ttlMs ?? CONVERSATION_TTL_MS;
+	const filePath = resolveMSTeamsStorePath({
+		filename: STORE_FILENAME$2,
+		env: params?.env,
+		homedir: params?.homedir,
+		stateDir: params?.stateDir,
+		storePath: params?.storePath
+	});
+	const empty = {
+		version: 1,
+		conversations: {}
+	};
+	const readStore = async () => {
+		const { value } = await readJsonFile(filePath, empty);
+		if (value.version !== 1 || !value.conversations || typeof value.conversations !== "object" || Array.isArray(value.conversations)) return empty;
+		const nowMs = Date.now();
+		const pruned = pruneExpired$2(value.conversations, nowMs, ttlMs).conversations;
+		return {
+			version: 1,
+			conversations: pruneToLimit$2(pruned)
+		};
+	};
+	const list = async () => {
+		const store = await readStore();
+		return toConversationStoreEntries(Object.entries(store.conversations));
+	};
+	const get = async (conversationId) => {
+		return (await readStore()).conversations[normalizeStoredConversationId(conversationId)] ?? null;
+	};
+	const findPreferredDmByUserId = async (id) => {
+		return findPreferredDmConversationByUserId(await list(), id);
+	};
+	const upsert = async (conversationId, reference) => {
+		const normalizedId = normalizeStoredConversationId(conversationId);
+		await withFileLock$1(filePath, empty, async () => {
+			const store = await readStore();
+			store.conversations[normalizedId] = mergeStoredConversationReference(store.conversations[normalizedId], reference, (/* @__PURE__ */ new Date()).toISOString());
+			const nowMs = Date.now();
+			store.conversations = pruneExpired$2(store.conversations, nowMs, ttlMs).conversations;
+			store.conversations = pruneToLimit$2(store.conversations);
+			await writeJsonFile(filePath, store);
+		});
+	};
+	const remove = async (conversationId) => {
+		const normalizedId = normalizeStoredConversationId(conversationId);
+		return await withFileLock$1(filePath, empty, async () => {
+			const store = await readStore();
+			if (!(normalizedId in store.conversations)) return false;
+			delete store.conversations[normalizedId];
+			await writeJsonFile(filePath, store);
+			return true;
+		});
+	};
+	return {
+		upsert,
+		get,
+		list,
+		remove,
+		findPreferredDmByUserId,
+		findByUserId: findPreferredDmByUserId
+	};
+}
+//#endregion
+//#region extensions/msteams/src/polls.ts
+const STORE_FILENAME$1 = "msteams-polls.json";
+const MAX_POLLS = 1e3;
+const POLL_TTL_MS = 720 * 60 * 60 * 1e3;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeOptionalString$1(value) {
+	if (typeof value !== "string") return;
+	const trimmed = value.trim();
+	return trimmed ? trimmed : void 0;
+}
+function normalizeChoiceValue(value) {
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		return trimmed ? trimmed : null;
+	}
+	if (typeof value === "number" && Number.isFinite(value)) return String(value);
+	return null;
+}
+function extractSelections(value) {
+	if (Array.isArray(value)) return value.map(normalizeChoiceValue).filter((entry) => Boolean(entry));
+	const normalized = normalizeChoiceValue(value);
+	if (!normalized) return [];
+	if (normalized.includes(",")) return normalized.split(",").map((entry) => entry.trim()).filter(Boolean);
+	return [normalized];
+}
+function readNestedValue(value, keys) {
+	let current = value;
+	for (const key of keys) {
+		if (!isRecord(current)) return;
+		current = current[key];
+	}
+	return current;
+}
+function readNestedString(value, keys) {
+	return normalizeOptionalString$1(readNestedValue(value, keys));
+}
+function extractMSTeamsPollVote(activity) {
+	const value = activity?.value;
+	if (!value || !isRecord(value)) return null;
+	const pollId = readNestedString(value, ["openclawPollId"]) ?? readNestedString(value, ["pollId"]) ?? readNestedString(value, ["openclaw", "pollId"]) ?? readNestedString(value, [
+		"openclaw",
+		"poll",
+		"id"
+	]) ?? readNestedString(value, ["data", "openclawPollId"]) ?? readNestedString(value, ["data", "pollId"]) ?? readNestedString(value, [
+		"data",
+		"openclaw",
+		"pollId"
+	]);
+	if (!pollId) return null;
+	const directSelections = extractSelections(value.choices);
+	const nestedSelections = extractSelections(readNestedValue(value, ["choices"]));
+	const dataSelections = extractSelections(readNestedValue(value, ["data", "choices"]));
+	const selections = directSelections.length > 0 ? directSelections : nestedSelections.length > 0 ? nestedSelections : dataSelections;
+	if (selections.length === 0) return null;
+	return {
+		pollId,
+		selections
+	};
+}
+function buildMSTeamsPollCard(params) {
+	const pollId = params.pollId ?? crypto.randomUUID();
+	const maxSelections = typeof params.maxSelections === "number" && params.maxSelections > 1 ? Math.floor(params.maxSelections) : 1;
+	const cappedMaxSelections = Math.min(Math.max(1, maxSelections), params.options.length);
+	const choices = params.options.map((option, index) => ({
+		title: option,
+		value: String(index)
+	}));
+	const hint = cappedMaxSelections > 1 ? `Select up to ${cappedMaxSelections} option${cappedMaxSelections === 1 ? "" : "s"}.` : "Select one option.";
+	const card = {
+		type: "AdaptiveCard",
+		version: "1.5",
+		body: [
+			{
+				type: "TextBlock",
+				text: params.question,
+				wrap: true,
+				weight: "Bolder",
+				size: "Medium"
+			},
+			{
+				type: "Input.ChoiceSet",
+				id: "choices",
+				isMultiSelect: cappedMaxSelections > 1,
+				style: "expanded",
+				choices
+			},
+			{
+				type: "TextBlock",
+				text: hint,
+				wrap: true,
+				isSubtle: true,
+				spacing: "Small"
+			}
+		],
+		actions: [{
+			type: "Action.Submit",
+			title: "Vote",
+			data: {
+				openclawPollId: pollId,
+				pollId
+			},
+			msteams: {
+				type: "messageBack",
+				text: "openclaw poll vote",
+				displayText: "Vote recorded",
+				value: {
+					openclawPollId: pollId,
+					pollId
+				}
+			}
+		}]
+	};
+	const fallbackLines = [`Poll: ${params.question}`, ...params.options.map((option, index) => `${index + 1}. ${option}`)];
+	return {
+		pollId,
+		question: params.question,
+		options: params.options,
+		maxSelections: cappedMaxSelections,
+		card,
+		fallbackText: fallbackLines.join("\n")
+	};
+}
+function parseTimestamp(value) {
+	if (!value) return null;
+	const parsed = Date.parse(value);
+	return Number.isFinite(parsed) ? parsed : null;
+}
+function pruneExpired$1(polls) {
+	const cutoff = Date.now() - POLL_TTL_MS;
+	const entries = Object.entries(polls).filter(([, poll]) => {
+		return (parseTimestamp(poll.updatedAt ?? poll.createdAt) ?? 0) >= cutoff;
+	});
+	return Object.fromEntries(entries);
+}
+function pruneToLimit$1(polls) {
+	const entries = Object.entries(polls);
+	if (entries.length <= MAX_POLLS) return polls;
+	entries.sort((a, b) => {
+		return (parseTimestamp(a[1].updatedAt ?? a[1].createdAt) ?? 0) - (parseTimestamp(b[1].updatedAt ?? b[1].createdAt) ?? 0);
+	});
+	const keep = entries.slice(entries.length - MAX_POLLS);
+	return Object.fromEntries(keep);
+}
+function normalizeMSTeamsPollSelections(poll, selections) {
+	const maxSelections = Math.max(1, poll.maxSelections);
+	const mapped = selections.map((entry) => Number.parseInt(entry, 10)).filter((value) => Number.isFinite(value)).filter((value) => value >= 0 && value < poll.options.length).map((value) => String(value));
+	const limited = maxSelections > 1 ? mapped.slice(0, maxSelections) : mapped.slice(0, 1);
+	return Array.from(new Set(limited));
+}
+function createMSTeamsPollStoreFs(params) {
+	const filePath = resolveMSTeamsStorePath({
+		filename: STORE_FILENAME$1,
+		env: params?.env,
+		homedir: params?.homedir,
+		stateDir: params?.stateDir,
+		storePath: params?.storePath
+	});
+	const empty = {
+		version: 1,
+		polls: {}
+	};
+	const readStore = async () => {
+		const { value } = await readJsonFile(filePath, empty);
+		return {
+			version: 1,
+			polls: pruneToLimit$1(pruneExpired$1(value.polls ?? {}))
+		};
+	};
+	const writeStore = async (data) => {
+		await writeJsonFile(filePath, data);
+	};
+	const createPoll = async (poll) => {
+		await withFileLock$1(filePath, empty, async () => {
+			const data = await readStore();
+			data.polls[poll.id] = poll;
+			await writeStore({
+				version: 1,
+				polls: pruneToLimit$1(data.polls)
+			});
+		});
+	};
+	const getPoll = async (pollId) => await withFileLock$1(filePath, empty, async () => {
+		return (await readStore()).polls[pollId] ?? null;
+	});
+	const recordVote = async (params) => await withFileLock$1(filePath, empty, async () => {
+		const data = await readStore();
+		const poll = data.polls[params.pollId];
+		if (!poll) return null;
+		const normalized = normalizeMSTeamsPollSelections(poll, params.selections);
+		poll.votes[params.voterId] = normalized;
+		poll.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		data.polls[poll.id] = poll;
+		await writeStore({
+			version: 1,
+			polls: pruneToLimit$1(data.polls)
+		});
+		return poll;
+	});
+	return {
+		createPoll,
+		getPoll,
+		recordVote
+	};
+}
+//#endregion
+//#region extensions/msteams/src/file-consent.ts
+/**
+* FileConsentCard utilities for MS Teams large file uploads (>4MB) in personal chats.
+*
+* Teams requires user consent before the bot can upload large files. This module provides
+* utilities for:
+* - Building FileConsentCard attachments (to request upload permission)
+* - Building FileInfoCard attachments (to confirm upload completion)
+* - Parsing fileConsent/invoke activities
+*/
+function normalizeLowercaseStringOrEmpty$1(value) {
+	return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+/**
+* Allowlist of domains that are valid targets for file consent uploads.
+* These are the Microsoft/SharePoint domains that Teams legitimately provides
+* as upload destinations in the FileConsentCard flow.
+*/
+const CONSENT_UPLOAD_HOST_ALLOWLIST = [
+	"sharepoint.com",
+	"sharepoint.us",
+	"sharepoint.de",
+	"sharepoint.cn",
+	"sharepoint-df.com",
+	"storage.live.com",
+	"onedrive.com",
+	"1drv.ms",
+	"graph.microsoft.com",
+	"graph.microsoft.us",
+	"graph.microsoft.de",
+	"graph.microsoft.cn"
+];
+/**
+* Returns true if the given IPv4 or IPv6 address is in a private, loopback,
+* or link-local range that must never be reached via consent uploads.
+*/
+function isPrivateOrReservedIP(ip) {
+	const ipv4MappedMatch = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/i.exec(ip);
+	if (ipv4MappedMatch) return isPrivateOrReservedIP(ipv4MappedMatch[1]);
+	const v4Parts = ip.split(".");
+	if (v4Parts.length === 4) {
+		const octets = v4Parts.map(Number);
+		if (octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) return false;
+		const [a, b] = octets;
+		if (a === 10) return true;
+		if (a === 172 && b >= 16 && b <= 31) return true;
+		if (a === 192 && b === 168) return true;
+		if (a === 127) return true;
+		if (a === 169 && b === 254) return true;
+		if (a === 0) return true;
+	}
+	const normalized = normalizeLowercaseStringOrEmpty$1(ip);
+	if (normalized === "::1") return true;
+	if (normalized.startsWith("fe80:") || normalized.startsWith("fe80")) return true;
+	if (normalized.startsWith("fc") || normalized.startsWith("fd")) return true;
+	if (normalized === "::") return true;
+	return false;
+}
+/**
+* Validate that a consent upload URL is safe to PUT to.
+* Checks:
+* 1. Protocol is HTTPS
+* 2. Hostname matches the consent upload allowlist
+* 3. Resolved IP is not in a private/reserved range (anti-SSRF)
+*
+* @throws Error if the URL fails validation
+*/
+async function validateConsentUploadUrl(url, opts) {
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		throw new Error("Consent upload URL is not a valid URL");
+	}
+	if (parsed.protocol !== "https:") throw new Error(`Consent upload URL must use HTTPS, got ${parsed.protocol}`);
+	const hostname = normalizeLowercaseStringOrEmpty$1(parsed.hostname);
+	if (!(opts?.allowlist ?? CONSENT_UPLOAD_HOST_ALLOWLIST).some((entry) => hostname === entry || hostname.endsWith(`.${entry}`))) throw new Error(`Consent upload URL hostname "${hostname}" is not in the allowed domains`);
+	const resolveFn = opts?.resolveFn ?? ((name) => lookup(name, { all: true }));
+	let resolved;
+	try {
+		const result = await resolveFn(hostname);
+		resolved = Array.isArray(result) ? result : [result];
+	} catch {
+		throw new Error(`Failed to resolve consent upload URL hostname "${hostname}"`);
+	}
+	for (const entry of resolved) if (isPrivateOrReservedIP(entry.address)) throw new Error(`Consent upload URL resolves to a private/reserved IP (${entry.address})`);
+}
+/**
+* Build a FileConsentCard attachment for requesting upload permission.
+* Use this for files >= 4MB in personal (1:1) chats.
+*/
+function buildFileConsentCard(params) {
+	return {
+		contentType: "application/vnd.microsoft.teams.card.file.consent",
+		name: params.filename,
+		content: {
+			description: params.description ?? `File: ${params.filename}`,
+			sizeInBytes: params.sizeInBytes,
+			acceptContext: {
+				filename: params.filename,
+				...params.context
+			},
+			declineContext: {
+				filename: params.filename,
+				...params.context
+			}
+		}
+	};
+}
+/**
+* Build a FileInfoCard attachment for confirming upload completion.
+* Send this after successfully uploading the file to the consent URL.
+*/
+function buildFileInfoCard(params) {
+	return {
+		contentType: "application/vnd.microsoft.teams.card.file.info",
+		contentUrl: params.contentUrl,
+		name: params.filename,
+		content: {
+			uniqueId: params.uniqueId,
+			fileType: params.fileType
+		}
+	};
+}
+/**
+* Parse a fileConsent/invoke activity.
+* Returns null if the activity is not a file consent invoke.
+*/
+function parseFileConsentInvoke(activity) {
+	if (activity.name !== "fileConsent/invoke") return null;
+	const value = activity.value;
+	if (value?.type !== "fileUpload") return null;
+	return {
+		action: value.action === "accept" ? "accept" : "decline",
+		uploadInfo: value.uploadInfo,
+		context: value.context
+	};
+}
+/**
+* Upload a file to the consent URL provided by Teams.
+* The URL is provided in the fileConsent/invoke response after user accepts.
+*
+* @throws Error if the URL fails SSRF validation (non-HTTPS, disallowed host, private IP)
+*/
+async function uploadToConsentUrl(params) {
+	await validateConsentUploadUrl(params.url, params.validationOpts);
+	const res = await (params.fetchFn ?? fetch)(params.url, {
+		method: "PUT",
+		headers: {
+			"User-Agent": buildUserAgent(),
+			"Content-Type": params.contentType ?? "application/octet-stream",
+			"Content-Range": `bytes 0-${params.buffer.length - 1}/${params.buffer.length}`
+		},
+		body: new Uint8Array(params.buffer)
+	});
+	if (!res.ok) throw new Error(`File upload to consent URL failed: ${res.status} ${res.statusText}`);
+}
+//#endregion
+//#region extensions/msteams/src/pending-uploads-fs.ts
+/**
+* Filesystem-backed pending upload store for the FileConsentCard flow.
+*
+* The CLI `message send --media` path runs in a different process from the
+* gateway's bot monitor that receives the `fileConsent/invoke` callback.
+* An in-memory `pending-uploads.ts` store cannot bridge those processes, so
+* when the user clicks "Allow" the monitor handler's lookup misses and the
+* user sees "card action not supported".
+*
+* This FS store persists pending uploads to a JSON file (with the file buffer
+* base64-encoded) so any process that shares the OpenClaw state dir can read
+* them back. The in-memory store in `pending-uploads.ts` is still the fast
+* path for same-process flows (for example the messenger reply path); this FS
+* store is a cross-process fallback.
+*/
+/** TTL for persisted pending uploads (matches in-memory store). */
+const PENDING_UPLOAD_TTL_MS$1 = 300 * 1e3;
+/** Cap to avoid unbounded growth if a process crashes mid-flow. */
+const MAX_PENDING_UPLOADS = 100;
+const STORE_FILENAME = "msteams-pending-uploads.json";
+const empty = {
+	version: 1,
+	uploads: {}
+};
+function resolveFilePath(options) {
+	return resolveMSTeamsStorePath({
+		filename: STORE_FILENAME,
+		env: options?.env,
+		homedir: options?.homedir,
+		stateDir: options?.stateDir,
+		storePath: options?.storePath
+	});
+}
+function pruneExpired(uploads, nowMs, ttlMs) {
+	const kept = {};
+	for (const [id, record] of Object.entries(uploads)) if (nowMs - record.createdAt <= ttlMs) kept[id] = record;
+	return kept;
+}
+function pruneToLimit(uploads) {
+	const entries = Object.entries(uploads);
+	if (entries.length <= MAX_PENDING_UPLOADS) return uploads;
+	entries.sort((a, b) => a[1].createdAt - b[1].createdAt);
+	const keep = entries.slice(entries.length - MAX_PENDING_UPLOADS);
+	return Object.fromEntries(keep);
+}
+function recordToUpload(record) {
+	return {
+		id: record.id,
+		buffer: Buffer.from(record.bufferBase64, "base64"),
+		filename: record.filename,
+		contentType: record.contentType,
+		conversationId: record.conversationId,
+		consentCardActivityId: record.consentCardActivityId,
+		createdAt: record.createdAt
+	};
+}
+function isValidStore(value) {
+	if (!value || typeof value !== "object") return false;
+	const candidate = value;
+	return candidate.version === 1 && typeof candidate.uploads === "object" && candidate.uploads !== null && !Array.isArray(candidate.uploads);
+}
+async function readStore(filePath, ttlMs) {
+	const { value } = await readJsonFile(filePath, empty);
+	if (!isValidStore(value)) return {
+		version: 1,
+		uploads: {}
+	};
+	return {
+		version: 1,
+		uploads: pruneToLimit(pruneExpired(value.uploads, Date.now(), ttlMs))
+	};
+}
+/**
+* Persist a pending upload record so another process can read it back.
+* Pass in the pre-generated id (same as the one placed in the consent card
+* context) so the in-memory and FS stores share the same key.
+*/
+async function storePendingUploadFs(upload, options) {
+	const ttlMs = options?.ttlMs ?? PENDING_UPLOAD_TTL_MS$1;
+	const filePath = resolveFilePath(options);
+	await withFileLock$1(filePath, empty, async () => {
+		const store = await readStore(filePath, ttlMs);
+		store.uploads[upload.id] = {
+			id: upload.id,
+			bufferBase64: upload.buffer.toString("base64"),
+			filename: upload.filename,
+			contentType: upload.contentType,
+			conversationId: upload.conversationId,
+			consentCardActivityId: upload.consentCardActivityId,
+			createdAt: Date.now()
+		};
+		store.uploads = pruneToLimit(pruneExpired(store.uploads, Date.now(), ttlMs));
+		await writeJsonFile(filePath, store);
+	});
+}
+/**
+* Retrieve a persisted pending upload. Expired entries are treated as absent.
+*/
+async function getPendingUploadFs(id, options) {
+	if (!id) return;
+	const ttlMs = options?.ttlMs ?? PENDING_UPLOAD_TTL_MS$1;
+	const record = (await readStore(resolveFilePath(options), ttlMs)).uploads[id];
+	if (!record) return;
+	if (Date.now() - record.createdAt > ttlMs) return;
+	return recordToUpload(record);
+}
+/**
+* Remove a persisted pending upload (after successful upload or decline).
+* No-op if the entry is already gone.
+*/
+async function removePendingUploadFs(id, options) {
+	if (!id) return;
+	const ttlMs = options?.ttlMs ?? PENDING_UPLOAD_TTL_MS$1;
+	const filePath = resolveFilePath(options);
+	await withFileLock$1(filePath, empty, async () => {
+		const store = await readStore(filePath, ttlMs);
+		if (!(id in store.uploads)) return;
+		delete store.uploads[id];
+		await writeJsonFile(filePath, store);
+	});
+}
+/**
+* Set the consent card activity ID on a persisted entry. Called after the
+* FileConsentCard activity is sent and we know its message id.
+*/
+async function setPendingUploadActivityIdFs(id, activityId, options) {
+	const ttlMs = options?.ttlMs ?? PENDING_UPLOAD_TTL_MS$1;
+	const filePath = resolveFilePath(options);
+	await withFileLock$1(filePath, empty, async () => {
+		const store = await readStore(filePath, ttlMs);
+		const record = store.uploads[id];
+		if (!record) return;
+		record.consentCardActivityId = activityId;
+		await writeJsonFile(filePath, store);
+	});
+}
+//#endregion
+//#region extensions/msteams/src/pending-uploads.ts
+/**
+* In-memory storage for files awaiting user consent in the FileConsentCard flow.
+*
+* When sending large files (>=4MB) in personal chats, Teams requires user consent
+* before upload. This module stores the file data temporarily until the user
+* accepts or declines, or until the TTL expires.
+*/
+const pendingUploads = /* @__PURE__ */ new Map();
+/** Timer handles keyed by upload ID, cleared on explicit removal to prevent ghost cleanup */
+const pendingUploadTimers = /* @__PURE__ */ new Map();
+/** TTL for pending uploads: 5 minutes */
+const PENDING_UPLOAD_TTL_MS = 300 * 1e3;
+/**
+* Store a file pending user consent.
+* Returns the upload ID to include in the FileConsentCard context.
+*/
+function storePendingUpload(upload) {
+	const id = crypto.randomUUID();
+	const entry = {
+		...upload,
+		id,
+		createdAt: Date.now()
+	};
+	pendingUploads.set(id, entry);
+	const timer = setTimeout(() => {
+		pendingUploads.delete(id);
+		pendingUploadTimers.delete(id);
+	}, PENDING_UPLOAD_TTL_MS);
+	pendingUploadTimers.set(id, timer);
+	return id;
+}
+/**
+* Retrieve a pending upload by ID.
+* Returns undefined if not found or expired.
+*/
+function getPendingUpload(id) {
+	if (!id) return;
+	const entry = pendingUploads.get(id);
+	if (!entry) return;
+	if (Date.now() - entry.createdAt > PENDING_UPLOAD_TTL_MS) {
+		pendingUploads.delete(id);
+		const timer = pendingUploadTimers.get(id);
+		if (timer !== void 0) {
+			clearTimeout(timer);
+			pendingUploadTimers.delete(id);
+		}
+		return;
+	}
+	return entry;
+}
+/**
+* Remove a pending upload (after successful upload or user decline).
+* Also clears the TTL timer to prevent ghost Map deletions.
+*/
+function removePendingUpload(id) {
+	if (id) {
+		pendingUploads.delete(id);
+		const timer = pendingUploadTimers.get(id);
+		if (timer !== void 0) {
+			clearTimeout(timer);
+			pendingUploadTimers.delete(id);
+		}
+	}
+}
+/**
+* Set the consent card activity ID on an existing pending upload.
+* Called after the FileConsentCard is sent and we know its activity ID.
+*/
+function setPendingUploadActivityId(uploadId, activityId) {
+	const entry = pendingUploads.get(uploadId);
+	if (entry) entry.consentCardActivityId = activityId;
+}
+//#endregion
+//#region extensions/msteams/src/file-consent-helpers.ts
+/**
+* Shared helpers for FileConsentCard flow in MSTeams.
+*
+* FileConsentCard is required for:
+* - Personal (1:1) chats with large files (>=4MB)
+* - Personal chats with non-image files (PDFs, documents, etc.)
+*
+* This module consolidates the logic used by both send.ts (proactive sends)
+* and messenger.ts (reply path) to avoid duplication.
+*/
+function buildConsentActivity(params) {
+	const { media, description, uploadId } = params;
+	return {
+		type: "message",
+		attachments: [buildFileConsentCard({
+			filename: media.filename,
+			description: description || `File: ${media.filename}`,
+			sizeInBytes: media.buffer.length,
+			context: { uploadId }
+		})]
+	};
+}
+/**
+* Prepare a FileConsentCard activity for large files or non-images in personal chats.
+* Returns the activity object and uploadId - caller is responsible for sending.
+*
+* This variant only writes to the in-memory store. Use it when the caller and
+* the `fileConsent/invoke` handler share the same process (for example the
+* messenger reply path). For proactive CLI sends where the invoke arrives in
+* a different process, use {@link prepareFileConsentActivityFs} instead.
+*/
+function prepareFileConsentActivity(params) {
+	const { media, conversationId, description } = params;
+	const uploadId = storePendingUpload({
+		buffer: media.buffer,
+		filename: media.filename,
+		contentType: media.contentType,
+		conversationId
+	});
+	return {
+		activity: buildConsentActivity({
+			media,
+			description,
+			uploadId
+		}),
+		uploadId
+	};
+}
+/**
+* Prepare a FileConsentCard activity and persist the pending upload to the
+* filesystem so a different process can read it when the user accepts.
+*
+* This is used by the proactive CLI `message send --media` path: the CLI
+* process sends the card and exits, but the `fileConsent/invoke` callback is
+* delivered to the long-lived gateway monitor process. The FS-backed store
+* bridges those two processes. The in-memory store is also populated so
+* same-process flows keep the fast path.
+*/
+async function prepareFileConsentActivityFs(params) {
+	const { media, conversationId, description } = params;
+	const uploadId = storePendingUpload({
+		buffer: media.buffer,
+		filename: media.filename,
+		contentType: media.contentType,
+		conversationId
+	});
+	await storePendingUploadFs({
+		id: uploadId,
+		buffer: media.buffer,
+		filename: media.filename,
+		contentType: media.contentType,
+		conversationId
+	});
+	return {
+		activity: buildConsentActivity({
+			media,
+			description,
+			uploadId
+		}),
+		uploadId
+	};
+}
+/**
+* Check if a file requires FileConsentCard flow.
+* True for: personal chat AND (large file OR non-image)
+*/
+function requiresFileConsent(params) {
+	const isPersonal = normalizeOptionalLowercaseString(params.conversationType) === "personal";
+	const isImage = params.contentType?.startsWith("image/") ?? false;
+	const isLargeFile = params.bufferSize >= params.thresholdBytes;
+	return isPersonal && (isLargeFile || !isImage);
+}
+//#endregion
+//#region extensions/msteams/src/graph-chat.ts
+/**
+* Native Teams file card attachments for Bot Framework.
+*
+* The Bot Framework SDK supports `application/vnd.microsoft.teams.card.file.info`
+* content type which produces native Teams file cards.
+*
+* @see https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/bots-filesv4
+*/
+/**
+* Build a native Teams file card attachment for Bot Framework.
+*
+* This uses the `application/vnd.microsoft.teams.card.file.info` content type
+* which is supported by Bot Framework and produces native Teams file cards
+* (the same display as when a user manually shares a file).
+*
+* @param file - DriveItem properties from getDriveItemProperties()
+* @returns Attachment object for Bot Framework sendActivity()
+*/
+function buildTeamsFileInfoCard(file) {
+	const rawETag = file.eTag;
+	const uniqueId = rawETag.replace(/^["']|["']$/g, "").replace(/[{}]/g, "").split(",")[0] ?? rawETag;
+	const lastDot = file.name.lastIndexOf(".");
+	const fileType = lastDot >= 0 ? normalizeLowercaseStringOrEmpty(file.name.slice(lastDot + 1)) : "";
+	return {
+		contentType: "application/vnd.microsoft.teams.card.file.info",
+		contentUrl: file.webDavUrl,
+		name: file.name,
+		content: {
+			uniqueId,
+			fileType
+		}
+	};
+}
+//#endregion
+//#region extensions/msteams/src/graph-upload.ts
+const GRAPH_ROOT = "https://graph.microsoft.com/v1.0";
+const GRAPH_BETA = "https://graph.microsoft.com/beta";
+const GRAPH_SCOPE = "https://graph.microsoft.com";
+/**
+* Upload a file to the user's OneDrive root folder.
+* For larger files, this uses the simple upload endpoint (up to 4MB).
+*/
+async function uploadToOneDrive(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const res = await fetchFn(`${GRAPH_ROOT}/me/drive/root:${`/OpenClawShared/${encodeURIComponent(params.filename)}`}:/content`, {
+		method: "PUT",
+		headers: {
+			"User-Agent": buildUserAgent(),
+			Authorization: `Bearer ${token}`,
+			"Content-Type": params.contentType ?? "application/octet-stream"
+		},
+		body: new Uint8Array(params.buffer)
+	});
+	if (!res.ok) {
+		const body = await res.text().catch(() => "");
+		throw new Error(`OneDrive upload failed: ${res.status} ${res.statusText} - ${body}`);
+	}
+	const data = await res.json();
+	if (!data.id || !data.webUrl || !data.name) throw new Error("OneDrive upload response missing required fields");
+	return {
+		id: data.id,
+		webUrl: data.webUrl,
+		name: data.name
+	};
+}
+/**
+* Create a sharing link for a OneDrive file.
+* The link allows organization members to view the file.
+*/
+async function createSharingLink(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const res = await fetchFn(`${GRAPH_ROOT}/me/drive/items/${params.itemId}/createLink`, {
+		method: "POST",
+		headers: {
+			"User-Agent": buildUserAgent(),
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify({
+			type: "view",
+			scope: params.scope ?? "organization"
+		})
+	});
+	if (!res.ok) {
+		const body = await res.text().catch(() => "");
+		throw new Error(`Create sharing link failed: ${res.status} ${res.statusText} - ${body}`);
+	}
+	const data = await res.json();
+	if (!data.link?.webUrl) throw new Error("Create sharing link response missing webUrl");
+	return { webUrl: data.link.webUrl };
+}
+/**
+* Upload a file to OneDrive and create a sharing link.
+* Convenience function for the common case.
+*/
+async function uploadAndShareOneDrive(params) {
+	const uploaded = await uploadToOneDrive({
+		buffer: params.buffer,
+		filename: params.filename,
+		contentType: params.contentType,
+		tokenProvider: params.tokenProvider,
+		fetchFn: params.fetchFn
+	});
+	const shareLink = await createSharingLink({
+		itemId: uploaded.id,
+		tokenProvider: params.tokenProvider,
+		scope: params.scope,
+		fetchFn: params.fetchFn
+	});
+	return {
+		itemId: uploaded.id,
+		webUrl: uploaded.webUrl,
+		shareUrl: shareLink.webUrl,
+		name: uploaded.name
+	};
+}
+/**
+* Upload a file to a SharePoint site.
+* This is used for group chats and channels where /me/drive doesn't work for bots.
+*
+* @param params.siteId - SharePoint site ID (e.g., "contoso.sharepoint.com,guid1,guid2")
+*/
+async function uploadToSharePoint(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const uploadPath = `/OpenClawShared/${encodeURIComponent(params.filename)}`;
+	const res = await fetchFn(`${GRAPH_ROOT}/sites/${params.siteId}/drive/root:${uploadPath}:/content`, {
+		method: "PUT",
+		headers: {
+			"User-Agent": buildUserAgent(),
+			Authorization: `Bearer ${token}`,
+			"Content-Type": params.contentType ?? "application/octet-stream"
+		},
+		body: new Uint8Array(params.buffer)
+	});
+	if (!res.ok) {
+		const body = await res.text().catch(() => "");
+		throw new Error(`SharePoint upload failed: ${res.status} ${res.statusText} - ${body}`);
+	}
+	const data = await res.json();
+	if (!data.id || !data.webUrl || !data.name) throw new Error("SharePoint upload response missing required fields");
+	return {
+		id: data.id,
+		webUrl: data.webUrl,
+		name: data.name
+	};
+}
+/**
+* Get driveItem properties needed for native Teams file card attachments.
+* This fetches the eTag and webDavUrl which are required for "reference" type attachments.
+*
+* @param params.siteId - SharePoint site ID
+* @param params.itemId - The driveItem ID (returned from upload)
+*/
+async function getDriveItemProperties(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const res = await fetchFn(`${GRAPH_ROOT}/sites/${params.siteId}/drive/items/${params.itemId}?$select=eTag,webDavUrl,name`, { headers: {
+		"User-Agent": buildUserAgent(),
+		Authorization: `Bearer ${token}`
+	} });
+	if (!res.ok) {
+		const body = await res.text().catch(() => "");
+		throw new Error(`Get driveItem properties failed: ${res.status} ${res.statusText} - ${body}`);
+	}
+	const data = await res.json();
+	if (!data.eTag || !data.webDavUrl || !data.name) throw new Error("DriveItem response missing required properties (eTag, webDavUrl, or name)");
+	return {
+		eTag: data.eTag,
+		webDavUrl: data.webDavUrl,
+		name: data.name
+	};
+}
+/**
+* Resolve the Graph API-native chat ID from a Bot Framework conversation ID.
+*
+* Bot Framework personal DM conversation IDs use formats like `a:1xxx@unq.gbl.spaces`
+* or `8:orgid:xxx` that the Graph API does not accept. Graph API requires the
+* `19:xxx@thread.tacv2` or `19:xxx@unq.gbl.spaces` format.
+*
+* This function looks up the matching Graph chat by querying the bot's chats filtered
+* by the target user's AAD object ID.
+*/
+async function resolveGraphChatId(params) {
+	const { botFrameworkConversationId, userAadObjectId, tokenProvider } = params;
+	const fetchFn = params.fetchFn ?? fetch;
+	if (botFrameworkConversationId.startsWith("19:")) return botFrameworkConversationId;
+	const token = await tokenProvider.getAccessToken(GRAPH_SCOPE);
+	let path;
+	if (userAadObjectId) path = `/me/chats?$filter=${encodeURIComponent(`chatType eq 'oneOnOne' and members/any(m:m/microsoft.graph.aadUserConversationMember/userId eq '${userAadObjectId}')`)}&$select=id`;
+	else path = `/me/chats?$filter=${encodeURIComponent("chatType eq 'oneOnOne'")}&$select=id`;
+	const res = await fetchFn(`${GRAPH_ROOT}${path}`, { headers: {
+		"User-Agent": buildUserAgent(),
+		Authorization: `Bearer ${token}`
+	} });
+	if (!res.ok) return null;
+	const chats = (await res.json()).value ?? [];
+	if (userAadObjectId && chats.length > 0 && chats[0]?.id) return chats[0].id;
+	if (!userAadObjectId && chats.length === 1 && chats[0]?.id) return chats[0].id;
+	return null;
+}
+/**
+* Get members of a Teams chat for per-user sharing.
+* Used to create sharing links scoped to only the chat participants.
+*/
+async function getChatMembers(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const res = await fetchFn(`${GRAPH_ROOT}/chats/${params.chatId}/members`, { headers: {
+		"User-Agent": buildUserAgent(),
+		Authorization: `Bearer ${token}`
+	} });
+	if (!res.ok) {
+		const body = await res.text().catch(() => "");
+		throw new Error(`Get chat members failed: ${res.status} ${res.statusText} - ${body}`);
+	}
+	return ((await res.json()).value ?? []).map((m) => ({
+		aadObjectId: m.userId ?? "",
+		displayName: m.displayName
+	})).filter((m) => m.aadObjectId);
+}
+/**
+* Create a sharing link for a SharePoint drive item.
+* For organization scope (default), uses v1.0 API.
+* For per-user scope, uses beta API with recipients.
+*/
+async function createSharePointSharingLink(params) {
+	const fetchFn = params.fetchFn ?? fetch;
+	const token = await params.tokenProvider.getAccessToken(GRAPH_SCOPE);
+	const scope = params.scope ?? "organization";
+	const apiRoot = scope === "users" ? GRAPH_BETA : GRAPH_ROOT;
+	const body = {
+		type: "view",
+		scope: scope === "users" ? "users" : "organization"
+	};
+	if (scope === "users" && params.recipientObjectIds?.length) body.recipients = params.recipientObjectIds.map((id) => ({ objectId: id }));
+	const res = await fetchFn(`${apiRoot}/sites/${params.siteId}/drive/items/${params.itemId}/createLink`, {
+		method: "POST",
+		headers: {
+			"User-Agent": buildUserAgent(),
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		},
+		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}`);
+	}
+	const data = await res.json();
+	if (!data.link?.webUrl) throw new Error("Create SharePoint sharing link response missing webUrl");
+	return { webUrl: data.link.webUrl };
+}
+/**
+* Upload a file to SharePoint and create a sharing link.
+*
+* For group chats, this creates a per-user sharing link scoped to chat members.
+* For channels, this creates an organization-wide sharing link.
+*
+* @param params.siteId - SharePoint site ID
+* @param params.chatId - Optional chat ID for per-user sharing (group chats)
+* @param params.usePerUserSharing - Whether to use per-user sharing (requires beta API + Chat.Read.All)
+*/
+async function uploadAndShareSharePoint(params) {
+	const uploaded = await uploadToSharePoint({
+		buffer: params.buffer,
+		filename: params.filename,
+		contentType: params.contentType,
+		tokenProvider: params.tokenProvider,
+		siteId: params.siteId,
+		fetchFn: params.fetchFn
+	});
+	let scope = "organization";
+	let recipientObjectIds;
+	if (params.usePerUserSharing && params.chatId) try {
+		const members = await getChatMembers({
+			chatId: params.chatId,
+			tokenProvider: params.tokenProvider,
+			fetchFn: params.fetchFn
+		});
+		if (members.length > 0) {
+			scope = "users";
+			recipientObjectIds = members.map((m) => m.aadObjectId);
+		}
+	} catch {}
+	const shareLink = await createSharePointSharingLink({
+		siteId: params.siteId,
+		itemId: uploaded.id,
+		tokenProvider: params.tokenProvider,
+		scope,
+		recipientObjectIds,
+		fetchFn: params.fetchFn
+	});
+	return {
+		itemId: uploaded.id,
+		webUrl: uploaded.webUrl,
+		shareUrl: shareLink.webUrl,
+		name: uploaded.name
+	};
+}
+//#endregion
+//#region extensions/msteams/src/media-helpers.ts
+/**
+* MIME type detection and filename extraction for MSTeams media attachments.
+*/
+/**
+* Detect MIME type from URL extension or data URL.
+* Uses shared MIME detection for consistency with core handling.
+*/
+async function getMimeType(url) {
+	if (url.startsWith("data:")) {
+		const match = url.match(/^data:([^;,]+)/);
+		if (match?.[1]) return match[1];
+	}
+	return await detectMime({ filePath: url }) ?? "application/octet-stream";
+}
+/**
+* Extract filename from URL or local path.
+* For local paths, extracts original filename if stored with embedded name pattern.
+* Falls back to deriving the extension from MIME type when no extension present.
+*/
+async function extractFilename(url) {
+	if (url.startsWith("data:")) {
+		const mime = await getMimeType(url);
+		const ext = extensionForMime(mime) ?? ".bin";
+		return `${mime.startsWith("image/") ? "image" : "file"}${ext}`;
+	}
+	try {
+		const pathname = new URL(url).pathname;
+		const basename = path.basename(pathname);
+		const existingExt = getFileExtension(pathname);
+		if (basename && existingExt) return basename;
+		const mime = await getMimeType(url);
+		const ext = extensionForMime(mime) ?? ".bin";
+		const prefix = mime.startsWith("image/") ? "image" : "file";
+		return basename ? `${basename}${ext}` : `${prefix}${ext}`;
+	} catch {
+		return extractOriginalFilename(url);
+	}
+}
+/**
+* Check if a URL refers to a local file path.
+*/
+function isLocalPath(url) {
+	if (url.startsWith("file://") || url.startsWith("/") || url.startsWith("~")) return true;
+	if (url.startsWith("\\") && !url.startsWith("\\\\")) return true;
+	if (/^[a-zA-Z]:[\\/]/.test(url)) return true;
+	if (url.startsWith("\\\\")) return true;
+	return false;
+}
+/**
+* Extract the message ID from a Bot Framework response.
+*/
+function extractMessageId(response) {
+	if (!response || typeof response !== "object") return null;
+	if (!("id" in response)) return null;
+	const { id } = response;
+	if (typeof id !== "string" || !id) return null;
+	return id;
+}
+//#endregion
+//#region extensions/msteams/src/mentions.ts
+/**
+* Check whether an ID looks like a valid Teams user/bot identifier.
+* Accepts:
+* - Bot Framework IDs: "28:xxx..." / "29:xxx..." / "8:orgid:..."
+* - AAD object IDs (UUIDs): "d5318c29-33ac-4e6b-bd42-57b8b793908f"
+*
+* Keep this permissive enough for real Teams IDs while still rejecting
+* documentation placeholders like `@[表示名](ユーザーID)`.
+*/
+const TEAMS_BOT_ID_PATTERN = /^\d+:[a-z0-9._=-]+(?::[a-z0-9._=-]+)*$/i;
+const AAD_OBJECT_ID_PATTERN = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;
+function isValidTeamsId(id) {
+	return TEAMS_BOT_ID_PATTERN.test(id) || AAD_OBJECT_ID_PATTERN.test(id);
+}
+/**
+* Parse mentions from text in the format @[Name](id).
+* Example: "Hello @[John Doe](28:xxx-yyy-zzz)!"
+*
+* Only matches where the id looks like a real Teams user/bot ID are treated
+* as mentions. This avoids false positives from documentation or code samples
+* embedded in the message (e.g. `@[表示名](ユーザーID)` in backticks).
+*
+* Returns both the formatted text with <at> tags and the entities array.
+*/
+function parseMentions(text) {
+	const mentionPattern = /@\[([^\]]+)\]\(([^)]+)\)/g;
+	const entities = [];
+	return {
+		text: text.replace(mentionPattern, (match, name, id) => {
+			const trimmedId = id.trim();
+			if (!isValidTeamsId(trimmedId)) return match;
+			const trimmedName = name.trim();
+			const mentionTag = `<at>${trimmedName}</at>`;
+			entities.push({
+				type: "mention",
+				text: mentionTag,
+				mentioned: {
+					id: trimmedId,
+					name: trimmedName
+				}
+			});
+			return mentionTag;
+		}),
+		entities
+	};
+}
+//#endregion
+//#region extensions/msteams/src/revoked-context.ts
+async function withRevokedProxyFallback(params) {
+	try {
+		return await params.run();
+	} catch (err) {
+		if (!isRevokedProxyError(err)) throw err;
+		params.onRevokedLog?.();
+		return await params.onRevoked();
+	}
+}
+//#endregion
+//#region extensions/msteams/src/ai-entity.ts
+/** AI-generated content entity added to every outbound AI message. */
+const AI_GENERATED_ENTITY = {
+	type: "https://schema.org/Message",
+	"@type": "Message",
+	"@id": "",
+	additionalType: ["AIGeneratedContent"]
+};
+//#endregion
+//#region extensions/msteams/src/messenger.ts
+/**
+* MSTeams-specific media size limit (100MB).
+* Higher than the default because OneDrive upload handles large files well.
+*/
+const MSTEAMS_MAX_MEDIA_BYTES$1 = 100 * 1024 * 1024;
+/**
+* Threshold for large files that require FileConsentCard flow in personal chats.
+* Files >= 4MB use consent flow; smaller images can use inline base64.
+*/
+const FILE_CONSENT_THRESHOLD_BYTES$1 = 4 * 1024 * 1024;
+function normalizeConversationId(rawId) {
+	return rawId.split(";")[0] ?? rawId;
+}
+function buildConversationReference(ref) {
+	const conversationId = ref.conversation?.id?.trim();
+	if (!conversationId) throw new Error("Invalid stored reference: missing conversation.id");
+	const agent = ref.agent ?? ref.bot ?? void 0;
+	if (agent == null || !agent.id) throw new Error("Invalid stored reference: missing agent.id");
+	const user = ref.user;
+	if (!user?.id) throw new Error("Invalid stored reference: missing user.id");
+	const tenantId = ref.tenantId ?? ref.conversation?.tenantId;
+	const aadObjectId = ref.aadObjectId ?? user.aadObjectId;
+	return {
+		activityId: ref.activityId,
+		user: aadObjectId ? {
+			...user,
+			aadObjectId
+		} : user,
+		agent,
+		conversation: {
+			id: normalizeConversationId(conversationId),
+			conversationType: ref.conversation?.conversationType,
+			tenantId
+		},
+		channelId: ref.channelId ?? "msteams",
+		serviceUrl: ref.serviceUrl,
+		locale: ref.locale,
+		...tenantId ? { tenantId } : {},
+		...aadObjectId ? { aadObjectId } : {}
+	};
+}
+function pushTextMessages(out, text, opts) {
+	if (!text) return;
+	if (opts.chunkText) {
+		for (const chunk of getMSTeamsRuntime().channel.text.chunkMarkdownTextWithMode(text, opts.chunkLimit, opts.chunkMode)) {
+			const trimmed = chunk.trim();
+			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;
+	out.push({ text: trimmed });
+}
+function clampMs(value, maxMs) {
+	if (!Number.isFinite(value) || value < 0) return 0;
+	return Math.min(value, maxMs);
+}
+function resolveRetryOptions(retry) {
+	if (!retry) return {
+		enabled: false,
+		maxAttempts: 1,
+		baseDelayMs: 0,
+		maxDelayMs: 0
+	};
+	return {
+		enabled: true,
+		maxAttempts: Math.max(1, retry?.maxAttempts ?? 3),
+		baseDelayMs: Math.max(0, retry?.baseDelayMs ?? 250),
+		maxDelayMs: Math.max(0, retry?.maxDelayMs ?? 1e4)
+	};
+}
+function computeRetryDelayMs(attempt, classification, opts) {
+	if (classification.retryAfterMs != null) return clampMs(classification.retryAfterMs, opts.maxDelayMs);
+	return clampMs(opts.baseDelayMs * 2 ** Math.max(0, attempt - 1), opts.maxDelayMs);
+}
+function shouldRetry(classification) {
+	return classification.kind === "throttled" || classification.kind === "transient";
+}
+function renderReplyPayloadsToMessages(replies, options) {
+	const out = [];
+	const chunkLimit = Math.min(options.textChunkLimit, 4e3);
+	const chunkText = options.chunkText !== false;
+	const chunkMode = options.chunkMode ?? "length";
+	const mediaMode = options.mediaMode ?? "split";
+	const tableMode = options.tableMode ?? getMSTeamsRuntime().channel.text.resolveMarkdownTableMode({
+		cfg: getMSTeamsRuntime().config.current(),
+		channel: "msteams"
+	});
+	for (const payload of replies) {
+		const reply = resolveSendableOutboundReplyParts(payload, { text: getMSTeamsRuntime().channel.text.convertMarkdownTables(payload.text ?? "", tableMode) });
+		if (!reply.hasContent) continue;
+		if (!reply.hasMedia) {
+			pushTextMessages(out, reply.text, {
+				chunkText,
+				chunkLimit,
+				chunkMode
+			});
+			continue;
+		}
+		if (mediaMode === "inline") {
+			const firstMedia = reply.mediaUrls[0];
+			if (firstMedia) {
+				out.push({
+					text: reply.text || void 0,
+					mediaUrl: firstMedia
+				});
+				for (let i = 1; i < reply.mediaUrls.length; i++) if (reply.mediaUrls[i]) out.push({ mediaUrl: reply.mediaUrls[i] });
+			} else pushTextMessages(out, reply.text, {
+				chunkText,
+				chunkLimit,
+				chunkMode
+			});
+			continue;
+		}
+		pushTextMessages(out, reply.text, {
+			chunkText,
+			chunkLimit,
+			chunkMode
+		});
+		for (const mediaUrl of reply.mediaUrls) {
+			if (!mediaUrl) continue;
+			out.push({ mediaUrl });
+		}
+	}
+	return out;
+}
+async function buildActivity(msg, conversationRef, tokenProvider, sharePointSiteId, mediaMaxBytes, options) {
+	const activity = { type: "message" };
+	activity.channelData = { feedbackLoopEnabled: options?.feedbackLoopEnabled ?? false };
+	if (msg.text) {
+		const { text: formattedText, entities } = parseMentions(msg.text);
+		activity.text = formattedText;
+		activity.entities = [...entities.length > 0 ? entities : [], AI_GENERATED_ENTITY];
+	} else activity.entities = [AI_GENERATED_ENTITY];
+	if (msg.mediaUrl) {
+		let contentUrl = msg.mediaUrl;
+		let contentType = await getMimeType(msg.mediaUrl);
+		let fileName = await extractFilename(msg.mediaUrl);
+		if (isLocalPath(msg.mediaUrl)) {
+			const maxBytes = mediaMaxBytes ?? MSTEAMS_MAX_MEDIA_BYTES$1;
+			const media = await loadWebMedia(msg.mediaUrl, maxBytes);
+			contentType = media.contentType ?? contentType;
+			fileName = media.fileName ?? fileName;
+			const conversationType = normalizeOptionalLowercaseString(conversationRef.conversation?.conversationType);
+			const isPersonal = conversationType === "personal";
+			const isImage = media.kind === "image";
+			if (requiresFileConsent({
+				conversationType,
+				contentType,
+				bufferSize: media.buffer.length,
+				thresholdBytes: FILE_CONSENT_THRESHOLD_BYTES$1
+			})) {
+				const conversationId = conversationRef.conversation?.id ?? "unknown";
+				const { activity: consentActivity, uploadId } = prepareFileConsentActivity({
+					media: {
+						buffer: media.buffer,
+						filename: fileName,
+						contentType
+					},
+					conversationId,
+					description: msg.text || void 0
+				});
+				consentActivity._pendingUploadId = uploadId;
+				return consentActivity;
+			}
+			if (!isPersonal && !isImage && tokenProvider && sharePointSiteId) {
+				const chatId = conversationRef.graphChatId ?? conversationRef.conversation?.id;
+				activity.attachments = [buildTeamsFileInfoCard(await getDriveItemProperties({
+					siteId: sharePointSiteId,
+					itemId: (await uploadAndShareSharePoint({
+						buffer: media.buffer,
+						filename: fileName,
+						contentType,
+						tokenProvider,
+						siteId: sharePointSiteId,
+						chatId: chatId ?? void 0,
+						usePerUserSharing: conversationType === "groupchat"
+					})).itemId,
+					tokenProvider
+				}))];
+				return activity;
+			}
+			if (!isPersonal && media.kind !== "image" && tokenProvider) {
+				const uploaded = await uploadAndShareOneDrive({
+					buffer: media.buffer,
+					filename: fileName,
+					contentType,
+					tokenProvider
+				});
+				const fileLink = `📎 [${uploaded.name}](${uploaded.shareUrl})`;
+				const existingText = typeof activity.text === "string" ? activity.text : void 0;
+				activity.text = existingText ? `${existingText}\n\n${fileLink}` : fileLink;
+				return activity;
+			}
+			const base64 = media.buffer.toString("base64");
+			contentUrl = `data:${media.contentType};base64,${base64}`;
+		}
+		activity.attachments = [{
+			name: fileName,
+			contentType,
+			contentUrl
+		}];
+	}
+	return activity;
+}
+async function sendMSTeamsMessages(params) {
+	const messages = params.messages.filter((m) => m.text && m.text.trim().length > 0 || m.mediaUrl);
+	if (messages.length === 0) return [];
+	const retryOptions = resolveRetryOptions(params.retry);
+	const sendWithRetry = async (sendOnce, meta) => {
+		if (!retryOptions.enabled) return await sendOnce();
+		let attempt = 1;
+		while (true) try {
+			return await sendOnce();
+		} catch (err) {
+			const classification = classifyMSTeamsSendError(err);
+			if (!(attempt < retryOptions.maxAttempts && shouldRetry(classification))) throw err;
+			const delayMs = computeRetryDelayMs(attempt, classification, retryOptions);
+			const nextAttempt = attempt + 1;
+			params.onRetry?.({
+				messageIndex: meta.messageIndex,
+				messageCount: meta.messageCount,
+				nextAttempt,
+				maxAttempts: retryOptions.maxAttempts,
+				delayMs,
+				classification
+			});
+			await sleep(delayMs);
+			attempt = nextAttempt;
+		}
+	};
+	const sendMessageInContext = async (ctx, message, messageIndex) => {
+		let pendingUploadId;
+		const messageId = extractMessageId(await sendWithRetry(async () => {
+			const activity = await buildActivity(message, params.conversationRef, params.tokenProvider, params.sharePointSiteId, params.mediaMaxBytes, { feedbackLoopEnabled: params.feedbackLoopEnabled });
+			pendingUploadId = typeof activity._pendingUploadId === "string" ? activity._pendingUploadId : void 0;
+			if (pendingUploadId) delete activity._pendingUploadId;
+			return await ctx.sendActivity(activity);
+		}, {
+			messageIndex,
+			messageCount: messages.length
+		})) ?? "unknown";
+		if (pendingUploadId && messageId !== "unknown") setPendingUploadActivityId(pendingUploadId, messageId);
+		return messageId;
+	};
+	const sendMessageBatchInContext = async (ctx, batch, startIndex) => {
+		const messageIds = [];
+		for (const [idx, message] of batch.entries()) messageIds.push(await sendMessageInContext(ctx, message, startIndex + idx));
+		return messageIds;
+	};
+	const sendProactively = async (batch, startIndex, threadActivityId) => {
+		const baseRef = buildConversationReference(params.conversationRef);
+		const conversationId = params.conversationRef.conversation?.conversationType === "channel" && threadActivityId ? `${baseRef.conversation.id};messageid=${threadActivityId}` : baseRef.conversation.id;
+		const proactiveRef = {
+			...baseRef,
+			activityId: void 0,
+			conversation: {
+				...baseRef.conversation,
+				id: conversationId
+			}
+		};
+		const messageIds = [];
+		await params.adapter.continueConversation(params.appId, proactiveRef, async (ctx) => {
+			messageIds.push(...await sendMessageBatchInContext(ctx, batch, startIndex));
+		});
+		return messageIds;
+	};
+	const resolvedThreadId = params.conversationRef.threadId ?? params.conversationRef.activityId;
+	if (params.replyStyle === "thread") {
+		const ctx = params.context;
+		if (!ctx) throw new Error("Missing context for replyStyle=thread");
+		const messageIds = [];
+		for (const [idx, message] of messages.entries()) {
+			const result = await withRevokedProxyFallback({
+				run: async () => ({
+					ids: [await sendMessageInContext(ctx, message, idx)],
+					fellBack: false
+				}),
+				onRevoked: async () => {
+					const remaining = messages.slice(idx);
+					return {
+						ids: remaining.length > 0 ? await sendProactively(remaining, idx, resolvedThreadId) : [],
+						fellBack: true
+					};
+				}
+			});
+			messageIds.push(...result.ids);
+			if (result.fellBack) return messageIds;
+		}
+		return messageIds;
+	}
+	return await sendProactively(messages, 0);
+}
+//#endregion
+//#region extensions/msteams/src/send-context.ts
+/**
+* Parse the target value into a conversation reference lookup key.
+* Supported formats:
+* - conversation:19:abc@thread.tacv2 → lookup by conversation ID
+* - user:aad-object-id → lookup by user AAD object ID
+* - 19:abc@thread.tacv2 → direct conversation ID
+*/
+function parseRecipient(to) {
+	const trimmed = to.trim();
+	const finalize = (type, id) => {
+		const normalized = id.trim();
+		if (!normalized) throw new Error(`Invalid target value: missing ${type} id`);
+		return {
+			type,
+			id: normalized
+		};
+	};
+	if (trimmed.startsWith("conversation:")) return finalize("conversation", trimmed.slice(13));
+	if (trimmed.startsWith("user:")) return finalize("user", trimmed.slice(5));
+	if (trimmed.startsWith("19:") || trimmed.includes("@thread")) return finalize("conversation", trimmed);
+	return finalize("user", trimmed);
+}
+/**
+* Find a stored conversation reference for the given recipient.
+*/
+async function findConversationReference(recipient) {
+	if (recipient.type === "conversation") {
+		const ref = await recipient.store.get(recipient.id);
+		if (ref) return {
+			conversationId: recipient.id,
+			ref
+		};
+		return null;
+	}
+	const found = await recipient.store.findPreferredDmByUserId(recipient.id);
+	if (!found) return null;
+	return {
+		conversationId: found.conversationId,
+		ref: found.reference
+	};
+}
+async function resolveMSTeamsSendContext(params) {
+	const msteamsCfg = params.cfg.channels?.msteams;
+	if (!msteamsCfg?.enabled) throw new Error("msteams provider is not enabled");
+	const creds = resolveMSTeamsCredentials(msteamsCfg);
+	if (!creds) throw new Error("msteams credentials not configured");
+	const store = createMSTeamsConversationStoreFs();
+	const recipient = parseRecipient(params.to);
+	const found = await findConversationReference({
+		...recipient,
+		store
+	});
+	if (!found) throw new Error(`No conversation reference found for ${recipient.type}:${recipient.id}. The bot must receive a message from this conversation before it can send proactively.`);
+	const { conversationId, ref } = found;
+	if (recipient.type === "user") {
+		const resolvedType = normalizeLowercaseStringOrEmpty(ref.conversation?.conversationType ?? "");
+		if (resolvedType && resolvedType !== "personal") throw new Error(`Conversation reference for user:${recipient.id} resolved to a ${resolvedType} conversation (${conversationId}) instead of a personal DM. The bot must receive a DM from this user before it can send proactively.`);
+	}
+	const log = getMSTeamsRuntime().logging.getChildLogger({ name: "msteams:send" });
+	const { sdk, app } = await loadMSTeamsSdkWithAuth(creds);
+	const adapter = createMSTeamsAdapter(app, sdk);
+	const tokenProvider = createMSTeamsTokenProvider(app);
+	const storedConversationType = normalizeLowercaseStringOrEmpty(ref.conversation?.conversationType ?? "");
+	let conversationType;
+	if (storedConversationType === "personal") conversationType = "personal";
+	else if (storedConversationType === "channel") conversationType = "channel";
+	else conversationType = "groupChat";
+	const sharePointSiteId = msteamsCfg.sharePointSiteId;
+	const mediaMaxBytes = resolveChannelMediaMaxBytes({
+		cfg: params.cfg,
+		resolveChannelLimitMb: ({ cfg }) => cfg.channels?.msteams?.mediaMaxMb
+	});
+	let graphChatId = ref.graphChatId ?? void 0;
+	if (graphChatId === void 0 && sharePointSiteId) try {
+		const resolved = await resolveGraphChatId({
+			botFrameworkConversationId: conversationId,
+			userAadObjectId: ref.user?.aadObjectId,
+			tokenProvider
+		});
+		graphChatId = resolved;
+		if (resolved) await store.upsert(conversationId, {
+			...ref,
+			graphChatId: resolved
+		});
+		else log.warn?.("could not resolve Graph chat ID; file uploads may fail for this conversation", { conversationId });
+	} catch (err) {
+		log.warn?.("failed to resolve Graph chat ID; file uploads may fall back to Bot Framework ID", {
+			conversationId,
+			error: formatUnknownError(err)
+		});
+		graphChatId = null;
+	}
+	return {
+		appId: creds.appId,
+		conversationId,
+		ref,
+		adapter,
+		log,
+		conversationType,
+		tokenProvider,
+		sharePointSiteId,
+		mediaMaxBytes,
+		graphChatId
+	};
+}
+//#endregion
+//#region extensions/msteams/src/send.ts
+/** Threshold for large files that require FileConsentCard flow in personal chats */
+const FILE_CONSENT_THRESHOLD_BYTES = 4 * 1024 * 1024;
+/**
+* MSTeams-specific media size limit (100MB).
+* Higher than the default because OneDrive upload handles large files well.
+*/
+const MSTEAMS_MAX_MEDIA_BYTES = 100 * 1024 * 1024;
+/**
+* Send a message to a Teams conversation or user.
+*
+* Uses the stored ConversationReference from previous interactions.
+* The bot must have received at least one message from the conversation
+* before proactive messaging works.
+*
+* File handling by conversation type:
+* - Personal (1:1) chats: small images (<4MB) use base64, large files and non-images use FileConsentCard
+* - Group chats / channels: files are uploaded to OneDrive and shared via link
+*/
+async function sendMessageMSTeams(params) {
+	const { cfg, to, text, mediaUrl, filename, mediaLocalRoots, mediaReadFile } = params;
+	const tableMode = resolveMarkdownTableMode({
+		cfg,
+		channel: "msteams"
+	});
+	const messageText = convertMarkdownTables(text ?? "", tableMode);
+	const ctx = await resolveMSTeamsSendContext({
+		cfg,
+		to
+	});
+	const { adapter, appId, conversationId, ref, log, conversationType, tokenProvider, sharePointSiteId } = ctx;
+	log.debug?.("sending proactive message", {
+		conversationId,
+		conversationType,
+		textLength: messageText.length,
+		hasMedia: Boolean(mediaUrl)
+	});
+	if (mediaUrl) {
+		const media = await loadOutboundMediaFromUrl(mediaUrl, {
+			maxBytes: ctx.mediaMaxBytes ?? MSTEAMS_MAX_MEDIA_BYTES,
+			mediaLocalRoots,
+			mediaReadFile
+		});
+		const isLargeFile = media.buffer.length >= FILE_CONSENT_THRESHOLD_BYTES;
+		const isImage = media.contentType?.startsWith("image/") ?? false;
+		const fallbackFileName = await extractFilename(mediaUrl);
+		const fileName = filename?.trim() || media.fileName || fallbackFileName;
+		log.debug?.("processing media", {
+			fileName,
+			contentType: media.contentType,
+			size: media.buffer.length,
+			isLargeFile,
+			isImage,
+			conversationType
+		});
+		if (requiresFileConsent({
+			conversationType,
+			contentType: media.contentType,
+			bufferSize: media.buffer.length,
+			thresholdBytes: FILE_CONSENT_THRESHOLD_BYTES
+		})) {
+			const { activity, uploadId } = await prepareFileConsentActivityFs({
+				media: {
+					buffer: media.buffer,
+					filename: fileName,
+					contentType: media.contentType
+				},
+				conversationId,
+				description: messageText || void 0
+			});
+			log.debug?.("sending file consent card", {
+				uploadId,
+				fileName,
+				size: media.buffer.length
+			});
+			const messageId = await sendProactiveActivity({
+				adapter,
+				appId,
+				ref,
+				activity,
+				errorPrefix: "msteams consent card send"
+			});
+			setPendingUploadActivityId(uploadId, messageId);
+			await setPendingUploadActivityIdFs(uploadId, messageId);
+			log.info("sent file consent card", {
+				conversationId,
+				messageId,
+				uploadId
+			});
+			return {
+				messageId,
+				conversationId,
+				pendingUploadId: uploadId
+			};
+		}
+		if (conversationType === "personal") {
+			const base64 = media.buffer.toString("base64");
+			return sendTextWithMedia(ctx, messageText, `data:${media.contentType};base64,${base64}`);
+		}
+		if (isImage && !sharePointSiteId) {
+			const base64 = media.buffer.toString("base64");
+			return sendTextWithMedia(ctx, messageText, `data:${media.contentType};base64,${base64}`);
+		}
+		try {
+			if (sharePointSiteId) {
+				log.debug?.("uploading to SharePoint for native file card", {
+					fileName,
+					conversationType,
+					siteId: sharePointSiteId
+				});
+				const uploaded = await uploadAndShareSharePoint({
+					buffer: media.buffer,
+					filename: fileName,
+					contentType: media.contentType,
+					tokenProvider,
+					siteId: sharePointSiteId,
+					chatId: ctx.graphChatId ?? conversationId,
+					usePerUserSharing: conversationType === "groupChat"
+				});
+				log.debug?.("SharePoint upload complete", {
+					itemId: uploaded.itemId,
+					shareUrl: uploaded.shareUrl
+				});
+				const driveItem = await getDriveItemProperties({
+					siteId: sharePointSiteId,
+					itemId: uploaded.itemId,
+					tokenProvider
+				});
+				log.debug?.("driveItem properties retrieved", {
+					eTag: driveItem.eTag,
+					webDavUrl: driveItem.webDavUrl
+				});
+				const fileCardAttachment = buildTeamsFileInfoCard(driveItem);
+				const messageId = await sendProactiveActivityRaw({
+					adapter,
+					appId,
+					ref,
+					activity: {
+						type: "message",
+						text: messageText || void 0,
+						attachments: [fileCardAttachment]
+					}
+				});
+				log.info("sent native file card", {
+					conversationId,
+					messageId,
+					fileName: driveItem.name
+				});
+				return {
+					messageId,
+					conversationId
+				};
+			}
+			log.debug?.("uploading to OneDrive (no SharePoint site configured)", {
+				fileName,
+				conversationType
+			});
+			const uploaded = await uploadAndShareOneDrive({
+				buffer: media.buffer,
+				filename: fileName,
+				contentType: media.contentType,
+				tokenProvider
+			});
+			log.debug?.("OneDrive upload complete", {
+				itemId: uploaded.itemId,
+				shareUrl: uploaded.shareUrl
+			});
+			const fileLink = `📎 [${uploaded.name}](${uploaded.shareUrl})`;
+			const messageId = await sendProactiveActivityRaw({
+				adapter,
+				appId,
+				ref,
+				activity: {
+					type: "message",
+					text: messageText ? `${messageText}\n\n${fileLink}` : fileLink
+				}
+			});
+			log.info("sent message with OneDrive file link", {
+				conversationId,
+				messageId,
+				shareUrl: uploaded.shareUrl
+			});
+			return {
+				messageId,
+				conversationId
+			};
+		} catch (err) {
+			const classification = classifyMSTeamsSendError(err);
+			const hint = formatMSTeamsSendErrorHint(classification);
+			const status = classification.statusCode ? ` (HTTP ${classification.statusCode})` : "";
+			throw new Error(`msteams file send failed${status}: ${formatUnknownError(err)}${hint ? ` (${hint})` : ""}`, { cause: err });
+		}
+	}
+	return sendTextWithMedia(ctx, messageText, void 0);
+}
+/**
+* Send a text message with optional base64 media URL.
+*/
+async function sendTextWithMedia(ctx, text, mediaUrl) {
+	const { adapter, appId, conversationId, ref, log, tokenProvider, sharePointSiteId, mediaMaxBytes } = ctx;
+	let messageIds;
+	try {
+		messageIds = await sendMSTeamsMessages({
+			replyStyle: "top-level",
+			adapter,
+			appId,
+			conversationRef: ref,
+			messages: [{
+				text: text || void 0,
+				mediaUrl
+			}],
+			retry: {},
+			onRetry: (event) => {
+				log.debug?.("retrying send", {
+					conversationId,
+					...event
+				});
+			},
+			tokenProvider,
+			sharePointSiteId,
+			mediaMaxBytes
+		});
+	} catch (err) {
+		const classification = classifyMSTeamsSendError(err);
+		const hint = formatMSTeamsSendErrorHint(classification);
+		const status = classification.statusCode ? ` (HTTP ${classification.statusCode})` : "";
+		throw new Error(`msteams send failed${status}: ${formatUnknownError(err)}${hint ? ` (${hint})` : ""}`, { cause: err });
+	}
+	const messageId = messageIds[0] ?? "unknown";
+	log.info("sent proactive message", {
+		conversationId,
+		messageId
+	});
+	return {
+		messageId,
+		conversationId
+	};
+}
+async function sendProactiveActivityRaw({ adapter, appId, ref, activity }) {
+	const proactiveRef = {
+		...buildConversationReference(ref),
+		activityId: void 0
+	};
+	let messageId = "unknown";
+	await adapter.continueConversation(appId, proactiveRef, async (ctx) => {
+		messageId = extractMessageId(await ctx.sendActivity(activity)) ?? "unknown";
+	});
+	return messageId;
+}
+async function sendProactiveActivity({ adapter, appId, ref, activity, errorPrefix }) {
+	try {
+		return await sendProactiveActivityRaw({
+			adapter,
+			appId,
+			ref,
+			activity
+		});
+	} catch (err) {
+		const classification = classifyMSTeamsSendError(err);
+		const hint = formatMSTeamsSendErrorHint(classification);
+		const status = classification.statusCode ? ` (HTTP ${classification.statusCode})` : "";
+		throw new Error(`${errorPrefix} failed${status}: ${formatUnknownError(err)}${hint ? ` (${hint})` : ""}`, { cause: err });
+	}
+}
+/**
+* Send a poll (Adaptive Card) to a Teams conversation or user.
+*/
+async function sendPollMSTeams(params) {
+	const { cfg, to, question, options, maxSelections } = params;
+	const { adapter, appId, conversationId, ref, log } = await resolveMSTeamsSendContext({
+		cfg,
+		to
+	});
+	const pollCard = buildMSTeamsPollCard({
+		question,
+		options,
+		maxSelections
+	});
+	log.debug?.("sending poll", {
+		conversationId,
+		pollId: pollCard.pollId,
+		optionCount: pollCard.options.length
+	});
+	const messageId = await sendProactiveActivity({
+		adapter,
+		appId,
+		ref,
+		activity: {
+			type: "message",
+			attachments: [{
+				contentType: "application/vnd.microsoft.card.adaptive",
+				content: pollCard.card
+			}]
+		},
+		errorPrefix: "msteams poll send"
+	});
+	log.info("sent poll", {
+		conversationId,
+		pollId: pollCard.pollId,
+		messageId
+	});
+	return {
+		pollId: pollCard.pollId,
+		messageId,
+		conversationId
+	};
+}
+/**
+* Send an arbitrary Adaptive Card to a Teams conversation or user.
+*/
+async function sendAdaptiveCardMSTeams(params) {
+	const { cfg, to, card } = params;
+	const { adapter, appId, conversationId, ref, log } = await resolveMSTeamsSendContext({
+		cfg,
+		to
+	});
+	log.debug?.("sending adaptive card", {
+		conversationId,
+		cardType: card.type,
+		cardVersion: card.version
+	});
+	const messageId = await sendProactiveActivity({
+		adapter,
+		appId,
+		ref,
+		activity: {
+			type: "message",
+			attachments: [{
+				contentType: "application/vnd.microsoft.card.adaptive",
+				content: card
+			}]
+		},
+		errorPrefix: "msteams card send"
+	});
+	log.info("sent adaptive card", {
+		conversationId,
+		messageId
+	});
+	return {
+		messageId,
+		conversationId
+	};
+}
+/**
+* Edit (update) a previously sent message in a Teams conversation.
+*
+* Uses the Bot Framework `continueConversation` → `updateActivity` flow
+* for proactive edits outside of the original turn context.
+*/
+async function editMessageMSTeams(params) {
+	const { cfg, to, activityId, text } = params;
+	const { adapter, appId, conversationId, ref, log } = await resolveMSTeamsSendContext({
+		cfg,
+		to
+	});
+	log.debug?.("editing proactive message", {
+		conversationId,
+		activityId,
+		textLength: text.length
+	});
+	const proactiveRef = {
+		...buildConversationReference(ref),
+		activityId: void 0
+	};
+	try {
+		await adapter.continueConversation(appId, proactiveRef, async (ctx) => {
+			await ctx.updateActivity({
+				type: "message",
+				id: activityId,
+				text
+			});
+		});
+	} catch (err) {
+		const classification = classifyMSTeamsSendError(err);
+		const hint = formatMSTeamsSendErrorHint(classification);
+		const status = classification.statusCode ? ` (HTTP ${classification.statusCode})` : "";
+		throw new Error(`msteams edit failed${status}: ${formatUnknownError(err)}${hint ? ` (${hint})` : ""}`, { cause: err });
+	}
+	log.info("edited proactive message", {
+		conversationId,
+		activityId
+	});
+	return { conversationId };
+}
+/**
+* Delete a previously sent message in a Teams conversation.
+*
+* Uses the Bot Framework `continueConversation` → `deleteActivity` flow
+* for proactive deletes outside of the original turn context.
+*/
+async function deleteMessageMSTeams(params) {
+	const { cfg, to, activityId } = params;
+	const { adapter, appId, conversationId, ref, log } = await resolveMSTeamsSendContext({
+		cfg,
+		to
+	});
+	log.debug?.("deleting proactive message", {
+		conversationId,
+		activityId
+	});
+	const proactiveRef = {
+		...buildConversationReference(ref),
+		activityId: void 0
+	};
+	try {
+		await adapter.continueConversation(appId, proactiveRef, async (ctx) => {
+			await ctx.deleteActivity(activityId);
+		});
+	} catch (err) {
+		const classification = classifyMSTeamsSendError(err);
+		const hint = formatMSTeamsSendErrorHint(classification);
+		const status = classification.statusCode ? ` (HTTP ${classification.statusCode})` : "";
+		throw new Error(`msteams delete failed${status}: ${formatUnknownError(err)}${hint ? ` (${hint})` : ""}`, { cause: err });
+	}
+	log.info("deleted proactive message", {
+		conversationId,
+		activityId
+	});
+	return { conversationId };
+}
+//#endregion
+//#region extensions/msteams/src/probe.ts
+function decodeJwtPayload(token) {
+	const parts = token.split(".");
+	if (parts.length < 2) return null;
+	const payload = parts[1] ?? "";
+	const normalized = payload.padEnd(payload.length + (4 - payload.length % 4) % 4, "=").replace(/-/g, "+").replace(/_/g, "/");
+	try {
+		const decoded = Buffer.from(normalized, "base64").toString("utf8");
+		const parsed = JSON.parse(decoded);
+		return parsed && typeof parsed === "object" ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+function readStringArray(value) {
+	if (!Array.isArray(value)) return;
+	const out = normalizeStringEntries(value);
+	return out.length > 0 ? out : void 0;
+}
+function readScopes(value) {
+	if (typeof value !== "string") return;
+	const out = value.split(/\s+/).map((entry) => entry.trim()).filter(Boolean);
+	return out.length > 0 ? out : void 0;
+}
+async function probeMSTeams(cfg) {
+	const creds = resolveMSTeamsCredentials(cfg);
+	if (!creds) return {
+		ok: false,
+		error: "missing credentials (appId, appPassword, tenantId)"
+	};
+	try {
+		const { app } = await loadMSTeamsSdkWithAuth(creds);
+		const tokenProvider = createMSTeamsTokenProvider(app);
+		if (!await tokenProvider.getAccessToken("https://api.botframework.com")) throw new Error("Failed to acquire bot token");
+		let graph;
+		try {
+			const accessToken = readAccessToken(await tokenProvider.getAccessToken("https://graph.microsoft.com"));
+			const payload = accessToken ? decodeJwtPayload(accessToken) : null;
+			graph = {
+				ok: true,
+				roles: readStringArray(payload?.roles),
+				scopes: readScopes(payload?.scp)
+			};
+		} catch (err) {
+			graph = {
+				ok: false,
+				error: formatUnknownError(err)
+			};
+		}
+		let delegatedAuth;
+		if (cfg?.delegatedAuth?.enabled) try {
+			const tokens = loadDelegatedTokens();
+			if (tokens) {
+				const isExpired = tokens.expiresAt <= Date.now();
+				delegatedAuth = {
+					ok: !isExpired,
+					scopes: tokens.scopes,
+					userPrincipalName: tokens.userPrincipalName,
+					...isExpired ? { error: "token expired (will auto-refresh on next use)" } : {}
+				};
+			} else delegatedAuth = {
+				ok: false,
+				error: "no delegated tokens found (run setup wizard)"
+			};
+		} catch {
+			delegatedAuth = {
+				ok: false,
+				error: "failed to load delegated tokens"
+			};
+		}
+		return {
+			ok: true,
+			appId: creds.appId,
+			...graph ? { graph } : {},
+			...delegatedAuth ? { delegatedAuth } : {}
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			appId: creds.appId,
+			error: formatUnknownError(err)
+		};
+	}
+}
+//#endregion
+export { readJsonFile as C, createMSTeamsConversationStoreFs as S, writeJsonFile as T, buildFileInfoCard as _, sendMessageMSTeams as a, createMSTeamsPollStoreFs as b, renderReplyPayloadsToMessages as c, withRevokedProxyFallback as d, resolveGraphChatId as f, removePendingUploadFs as g, getPendingUploadFs as h, sendAdaptiveCardMSTeams as i, sendMSTeamsMessages as l, removePendingUpload as m, deleteMessageMSTeams as n, sendPollMSTeams as o, getPendingUpload as p, editMessageMSTeams as r, buildConversationReference as s, probeMSTeams as t, AI_GENERATED_ENTITY as u, parseFileConsentInvoke as v, withFileLock$1 as w, extractMSTeamsPollVote as x, uploadToConsentUrl as y };