@aion0/forge 0.8.1 → 0.8.2

package/lib/builtin-plugins/teams.yaml

@@ -1,913 +0,0 @@
-id: teams
-name: Microsoft Teams
-icon: "💬"
-version: "0.8.1"
-author: forge
-category: connector
-mode: browser-side
-runner: isolated
-description: |
-  Microsoft Teams web (v2 UI). Reuses the user's logged-in session via
-  the runner's ISOLATED world — page CSP doesn't apply, but window
-  globals (MSAL token etc.) are NOT accessible. Pure DOM extraction.
-
-  Wait strategy:
-    - Runner checks chrome.tabs.query first and reuses any existing
-      Teams tab via host_match.
-    - Each script waits up to ~30s for Teams hydration before extracting,
-      so cold-load is handled.
-    - Switching chats/channels polls up to 30s for the new content to
-      render (Teams can be slow on enterprise networks).
-
-  Selectors verified on teams.microsoft.com/v2/ via chrome-devtools-mcp.
-  Microsoft rotates Fluent UI hooks — when extraction starts returning
-  empty, re-probe and bump this manifest.
-
-settings:
-  base_url:
-    type: string
-    label: Teams base URL
-    description: "Usually https://teams.microsoft.com"
-    default: "https://teams.microsoft.com"
-    required: true
-
-host_match: "{base_url}/*"
-login_redirect: "login.microsoftonline.com"
-
-tools:
-  list_chats:
-    description: |
-      List chats from the left rail, grouped by section (Favorites,
-      Chats, Meeting threads, Teams and channels). Returns whatever
-      Teams has rendered — virtualized for very long lists.
-    parameters:
-      sections:
-        type: string
-        label: Sections to include (comma-separated)
-        description: "Defaults to 'Favorites,Chats'. Use 'all' for everything."
-        default: "Favorites,Chats"
-      limit:
-        type: number
-        default: 100
-    returns: "{ sections: [{ name, items: [{ title }] }], total }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      // Wait for left rail tree to populate (handles cold Teams load)
-      const tStart = Date.now();
-      while (Date.now() - tStart < 30000) {
-        if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      const sectionFilter = String(args.sections || 'Favorites,Chats').toLowerCase();
-      const wantAll = sectionFilter === 'all';
-      const wanted = new Set(sectionFilter.split(',').map(s => s.trim().toLowerCase()));
-
-      const level1 = Array.from(document.querySelectorAll('[role="treeitem"][aria-level="1"]'));
-      const sections = level1.map(group => {
-        const firstLine = (group.innerText || '').split('\n')[0].trim();
-        const items = Array.from(group.querySelectorAll('[role="treeitem"][aria-level="2"]'))
-          .map(t => ({
-            title: (t.innerText || '').split('\n')[0].trim(),
-            data_tid: t.getAttribute('data-tid') || '',
-            id: t.id || '',
-          }))
-          .filter(it => it.title);
-        return { name: firstLine, items };
-      }).filter(s => wantAll || wanted.has(s.name.toLowerCase()));
-
-      const total = sections.reduce((n, s) => n + s.items.length, 0);
-      const limit = args.limit || 100;
-      let remaining = limit;
-      const sliced = sections.map(s => {
-        const take = Math.max(0, remaining);
-        const out = { name: s.name, items: s.items.slice(0, take) };
-        remaining -= out.items.length;
-        return out;
-      });
-
-      return {
-        sections: sliced,
-        total,
-        _virtualized: true,
-        _waited_ms: Date.now() - tStart,
-        _page: location.href,
-      };
-
-  list_messages_in_current_chat:
-    description: |
-      Extract messages from the currently-open chat (the one visible in
-      the main pane). Returns id, author, body, timestamp. The user
-      should open the target chat in Teams first.
-
-      Prefer `read_chat(name)` instead — it does the switching for you.
-    parameters:
-      limit:
-        type: number
-        label: Max messages (most recent)
-        default: 50
-    returns: "{ chat_title, messages: [...], total, _virtualized }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      // Wait up to 30s for chat content to render
-      const tStart = Date.now();
-      while (Date.now() - tStart < 30000) {
-        if (document.querySelectorAll('[data-tid="chat-pane-item"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      const items = Array.from(document.querySelectorAll('[data-tid="chat-pane-item"]'));
-      const messages = items.map(item => {
-        const msg = item.querySelector('[data-tid="chat-pane-message"]');
-        const mid = msg?.getAttribute('data-mid') || '';
-        const authorEl = item.querySelector('[data-tid="message-author-name"]');
-        const contentEl = mid ? document.getElementById('content-' + mid) : null;
-        const tsEl = mid ? document.getElementById('timestamp-' + mid) : null;
-        const subjectEl = mid ? document.getElementById('subject-line-' + mid) : null;
-        const reactionEls = item.querySelectorAll('[data-tid="diverse-reaction-pill-button"], [data-tid*="reaction-pill"]');
-        const reactions = Array.from(reactionEls).map(r => r.getAttribute('aria-label') || r.textContent.trim()).filter(Boolean);
-        return {
-          mid,
-          author: authorEl?.innerText.trim() || '',
-          body: contentEl?.innerText.trim() || msg?.innerText.trim() || '',
-          subject: subjectEl?.innerText.trim() || '',
-          timestamp: tsEl?.getAttribute('title') || tsEl?.innerText.trim() || '',
-          reactions,
-        };
-      }).filter(m => m.body || m.author);
-
-      const headerParticipant = document.querySelector('[data-tid^="participant-"]');
-      let chatTitle = '';
-      if (headerParticipant) {
-        const node = headerParticipant.closest('div[class*="container"], div[class*="header"]');
-        chatTitle = (node?.innerText || headerParticipant.innerText || '').split('\n')[0].trim();
-      }
-
-      const limit = args.limit || 50;
-      return {
-        chat_title: chatTitle,
-        messages: messages.slice(-limit),
-        total: messages.length,
-        _virtualized: true,
-        _waited_ms: Date.now() - tStart,
-        _page: location.href,
-      };
-
-  get_current_chat_info:
-    description: |
-      Identify the currently-open chat — title, participants if visible.
-      Useful as a quick "where am I" call before list_messages.
-    returns: "{ chat_title, participants, url }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      const tStart = Date.now();
-      while (Date.now() - tStart < 30000) {
-        if (document.querySelector('[data-tid^="participant-"]')) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      const participantEls = Array.from(document.querySelectorAll('[data-tid^="participant-"]'));
-      const participants = participantEls.map(p => ({
-        name: (p.innerText || '').trim().split('\n')[0],
-        data_tid: p.getAttribute('data-tid') || '',
-      })).filter(p => p.name);
-
-      const seen = new Set();
-      const unique = participants.filter(p => {
-        if (seen.has(p.data_tid)) return false;
-        seen.add(p.data_tid);
-        return true;
-      });
-
-      const chatTitle = unique.map(p => p.name).join(', ');
-      return { chat_title: chatTitle, participants: unique, url: location.href };
-
-  read_chat:
-    description: |
-      Switch to a specific 1:1 or group chat by name (substring match,
-      case-insensitive) and extract its messages. Combines open + read
-      into one tool — no need to open the chat manually first.
-
-      Waits up to 30s for Teams to hydrate (handles cold load) and up
-      to 30s for the chat switch to complete.
-    parameters:
-      name:
-        type: string
-        label: Chat name (substring, case-insensitive — e.g. "Alice Wang", "Eng Leaders")
-        required: true
-      limit:
-        type: number
-        label: Max messages (most recent)
-        default: 50
-    returns: "{ ok, chat_title, messages: [...], total, switched_in_ms, waited_for_ready_ms }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      const name = String(args.name || '').trim();
-      if (!name) return { ok: false, error: 'name parameter is required' };
-
-      // 1. Wait for Teams left rail to be ready (cold load handling)
-      const readyStart = Date.now();
-      while (Date.now() - readyStart < 30000) {
-        if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-      const waitedForReadyMs = Date.now() - readyStart;
-      if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length === 0) {
-        return { ok: false, error: 'Teams did not finish loading in 30s — try again or refresh the tab.' };
-      }
-
-      // 2. Find candidate treeitem in the left rail
-      const candidates = [...document.querySelectorAll('[role="treeitem"][aria-level="2"]')];
-      const lower = name.toLowerCase();
-      const match = candidates.find(t => {
-        const first = (t.innerText || '').split('\n')[0].trim().toLowerCase();
-        return first.includes(lower);
-      });
-      if (!match) {
-        return {
-          ok: false,
-          error: `No chat in left rail matching "${name}". Either the chat is in "See more", or not in your visible list.`,
-          visible_chats: candidates.slice(0, 30).map(c => (c.innerText || '').split('\n')[0].trim()).filter(Boolean),
-        };
-      }
-
-      // 3. If already on this chat, skip the click+wait
-      const currentTitle = document.title;
-      const alreadyHere = currentTitle.toLowerCase().includes(lower);
-
-      let waitedMs = 0;
-      if (!alreadyHere) {
-        const oldMids = new Set(
-          [...document.querySelectorAll('[data-tid="chat-pane-message"]')]
-            .map(e => e.getAttribute('data-mid'))
-            .filter(Boolean)
-        );
-
-        match.click();
-
-        // Poll up to 30s for new mids to appear
-        let switched = false;
-        for (let i = 0; i < 150; i++) {
-          await new Promise(r => setTimeout(r, 200));
-          waitedMs += 200;
-          const cur = [...document.querySelectorAll('[data-tid="chat-pane-message"]')]
-            .map(e => e.getAttribute('data-mid'))
-            .filter(Boolean);
-          if (cur.length > 0 && cur.some(m => !oldMids.has(m))) { switched = true; break; }
-        }
-        if (!switched) {
-          return { ok: false, error: 'Timed out waiting for chat to switch (30s).', target_name: name };
-        }
-      }
-
-      // 4. Extract messages
-      const items = [...document.querySelectorAll('[data-tid="chat-pane-item"]')];
-      const messages = items.map(item => {
-        const msg = item.querySelector('[data-tid="chat-pane-message"]');
-        const mid = msg?.getAttribute('data-mid') || '';
-        const authorEl = item.querySelector('[data-tid="message-author-name"]');
-        const contentEl = mid ? document.getElementById('content-' + mid) : null;
-        const tsEl = mid ? document.getElementById('timestamp-' + mid) : null;
-        const reactionEls = item.querySelectorAll('[data-tid="diverse-reaction-pill-button"], [data-tid*="reaction-pill"]');
-        const reactions = [...reactionEls].map(r => r.getAttribute('aria-label') || r.textContent.trim()).filter(Boolean);
-        return {
-          mid,
-          author: authorEl?.innerText.trim() || '',
-          body: contentEl?.innerText.trim() || msg?.innerText.trim() || '',
-          timestamp: tsEl?.getAttribute('title') || tsEl?.innerText.trim() || '',
-          reactions,
-        };
-      }).filter(m => m.body || m.author);
-
-      const titleParts = (document.title || '').split('|').map(s => s.trim()).filter(Boolean);
-      const chatTitle = titleParts.length >= 3 ? titleParts[1] : (titleParts[0] || '');
-
-      const limit = args.limit || 50;
-      return {
-        ok: true,
-        chat_title: chatTitle,
-        matched_name: (match.innerText || '').split('\n')[0].trim(),
-        switched: !alreadyHere,
-        switched_in_ms: waitedMs,
-        waited_for_ready_ms: waitedForReadyMs,
-        messages: messages.slice(-limit),
-        total: messages.length,
-        _virtualized: true,
-        _page: location.href,
-      };
-
-  read_channel:
-    description: |
-      Switch to a specific channel by team name + channel name and
-      extract its top-level posts. The team must be expanded in the
-      left rail (collapsed teams have no channels in DOM).
-    parameters:
-      team:
-        type: string
-        label: Team name (substring, case-insensitive)
-        required: true
-      channel:
-        type: string
-        label: Channel name (substring, case-insensitive)
-        required: true
-      limit:
-        type: number
-        default: 20
-    returns: "{ ok, team, channel, posts: [...] }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      const teamName = String(args.team || '').trim();
-      const channelName = String(args.channel || '').trim();
-      if (!teamName || !channelName) {
-        return { ok: false, error: 'team and channel parameters are required' };
-      }
-
-      // Wait for Teams to be ready
-      const readyStart = Date.now();
-      while (Date.now() - readyStart < 30000) {
-        if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-      if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length === 0) {
-        return { ok: false, error: 'Teams did not finish loading in 30s.' };
-      }
-
-      const level1 = [...document.querySelectorAll('[role="treeitem"][aria-level="1"]')];
-      const tnc = level1.find(t => /teams\s*and\s*channels/i.test((t.innerText || '').split('\n')[0]));
-      if (!tnc) return { ok: false, error: 'Teams and channels section not found' };
-
-      const teams = [...tnc.querySelectorAll('[role="treeitem"][aria-level="2"]')];
-      const team = teams.find(t => (t.innerText || '').split('\n')[0].toLowerCase().includes(teamName.toLowerCase()));
-      if (!team) {
-        return {
-          ok: false,
-          error: `Team "${teamName}" not found`,
-          visible_teams: teams.map(t => (t.innerText || '').split('\n')[0].trim()),
-        };
-      }
-
-      const channels = [...team.querySelectorAll('[role="treeitem"][aria-level="3"]')];
-      if (channels.length === 0) {
-        return {
-          ok: false,
-          error: `Team "${teamName}" is collapsed — no channels in DOM. Expand it in Teams first.`,
-        };
-      }
-      const channel = channels.find(c => (c.innerText || '').split('\n')[0].toLowerCase().includes(channelName.toLowerCase()));
-      if (!channel) {
-        return {
-          ok: false,
-          error: `Channel "${channelName}" not found under team "${teamName}"`,
-          visible_channels: channels.map(c => (c.innerText || '').split('\n')[0].trim()),
-        };
-      }
-
-      const alreadyHere = document.title.toLowerCase().includes(channelName.toLowerCase());
-      let waitedMs = 0;
-      if (!alreadyHere) {
-        const oldKeys = new Set(
-          [...document.querySelectorAll('[data-tid="channel-pane-message"]')]
-            .map(e => e.id).filter(Boolean)
-        );
-        channel.click();
-        let switched = false;
-        for (let i = 0; i < 150; i++) {
-          await new Promise(r => setTimeout(r, 200));
-          waitedMs += 200;
-          const cur = [...document.querySelectorAll('[data-tid="channel-pane-message"]')]
-            .map(e => e.id).filter(Boolean);
-          if (cur.length > 0 && cur.some(k => !oldKeys.has(k))) { switched = true; break; }
-        }
-        if (!switched) {
-          return { ok: false, error: 'Timed out waiting for channel to load (30s).' };
-        }
-      }
-
-      const posts = [...document.querySelectorAll('[data-tid="channel-pane-message"]')];
-      const parsed = posts.map(post => {
-        const midMatch = (post.id || '').match(/reply-chain-summary-(\d+)/);
-        const mid = midMatch ? midMatch[1] : '';
-        const subject = post.querySelector('[data-tid="subject-line"]')?.textContent.trim() || '';
-        const subheader = post.querySelector('[data-tid="post-message-subheader"]')?.textContent.trim() || '';
-        const ts = post.querySelector('[data-tid="timestamp"]')?.textContent.trim() || '';
-        const allBodies = [...post.querySelectorAll('[data-tid="message-body"]')];
-        const bodyEl = allBodies.find(b => b.closest('[role="group"]')?.id === post.id) || allBodies[0];
-        const author = subheader.replace(new RegExp('\\s*' + ts.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '.*$'), '').replace(/(Edited|New).*$/, '').trim();
-        const replyContainers = [...post.querySelectorAll('[role="group"][id^="message-body-"]')].filter(r => !r.id.includes(mid));
-        const replies = replyContainers.map(r => {
-          const rMid = (r.id.match(/message-body-(\d+)/) || [])[1] || '';
-          return {
-            mid: rMid,
-            author: (rMid ? document.getElementById('author-' + rMid)?.textContent.trim() : '') || '',
-            body: (rMid ? document.getElementById('content-' + rMid)?.innerText.trim() : '') || r.querySelector('[data-tid="message-body"]')?.innerText.trim() || '',
-            timestamp: r.querySelector('[data-tid="timestamp"]')?.textContent.trim() || '',
-          };
-        });
-        return { mid, subject, author, timestamp: ts, body: (bodyEl?.innerText || '').trim(), replies };
-      });
-
-      const ordered = parsed.slice().reverse();
-      const titleParts = (document.title || '').split('|').map(s => s.trim()).filter(Boolean);
-      const channelTitle = titleParts.length >= 3 ? titleParts[1] : (titleParts[0] || '');
-
-      return {
-        ok: true,
-        team: (team.innerText || '').split('\n')[0].trim(),
-        channel: channelTitle,
-        switched: !alreadyHere,
-        switched_in_ms: waitedMs,
-        posts: ordered.slice(0, args.limit || 20),
-        total: parsed.length,
-        _page: location.href,
-      };
-
-  list_teams_and_channels:
-    description: |
-      List joined Teams (organizations) and their visible channels from
-      the left rail. Channels under collapsed teams aren't in DOM —
-      expand the team in Teams to render them.
-    parameters:
-      limit:
-        type: number
-        default: 50
-    returns: "{ teams: [{ name, unread, channels: [{ name, unread }] }], total }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      const tStart = Date.now();
-      while (Date.now() - tStart < 30000) {
-        if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      const level1 = Array.from(document.querySelectorAll('[role="treeitem"][aria-level="1"]'));
-      const tnc = level1.find(t => /teams\s*and\s*channels/i.test((t.innerText || '').split('\n')[0]));
-      if (!tnc) {
-        return { teams: [], total: 0, _error: 'Teams and channels section not found in left rail' };
-      }
-      const teamItems = Array.from(tnc.querySelectorAll('[role="treeitem"][aria-level="2"]'));
-      const teams = teamItems.map(team => {
-        const ariaLabel = team.getAttribute('aria-label') || '';
-        const visibleText = (team.innerText || '').split('\n')[0];
-        const label = ariaLabel || visibleText;
-        const unread = /\bUnread\b/.test(visibleText) || /\bUnread\b/.test(ariaLabel);
-        const name = label.replace(/^Unread\s+/, '').replace(/^Team\s+/, '').replace(/\s+Has context menu$/, '').trim();
-        const channelEls = Array.from(team.querySelectorAll('[role="treeitem"][aria-level="3"]'));
-        const channels = channelEls.map(c => {
-          const cAriaLabel = c.getAttribute('aria-label') || '';
-          const cVisible = (c.innerText || '').split('\n')[0];
-          const cLabel = cAriaLabel || cVisible;
-          const cUnread = /\bUnread\b/.test(cVisible) || /\bUnread\b/.test(cAriaLabel);
-          const cName = cLabel.replace(/^Unread\s+/, '').replace(/^Channel\s+/, '').replace(/\s+Channel at mention$/, '').replace(/\s+Has context menu$/, '').trim();
-          return { name: cName, unread: cUnread };
-        }).filter(c => c.name && c.name !== 'See all channels');
-        return { name, unread, channels, channels_visible: channels.length, channels_collapsed: channelEls.length === 0 };
-      }).filter(t => t.name && t.name !== 'See all your teams');
-      return {
-        teams: teams.slice(0, args.limit || 50),
-        total: teams.length,
-        _virtualized_channels: true,
-        _page: location.href,
-      };
-
-  list_channel_posts:
-    description: |
-      Read top-level posts from the currently-open channel. For each
-      post, returns subject, author, timestamp, body, visible inline
-      replies, and a hint about hidden reply count.
-
-      Prefer `read_channel(team, channel)` to do switch+read in one tool.
-    parameters:
-      limit:
-        type: number
-        default: 20
-    returns: "{ channel, posts: [...], total }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      // Wait up to 30s for channel content to render
-      const tStart = Date.now();
-      while (Date.now() - tStart < 30000) {
-        if (document.querySelectorAll('[data-tid="channel-pane-message"]').length > 0) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      const posts = Array.from(document.querySelectorAll('[data-tid="channel-pane-message"]'));
-      const titleParts = (document.title || '').split('|').map(s => s.trim()).filter(Boolean);
-      const channelName = titleParts.length >= 3 ? titleParts[1] : (titleParts[0] || '');
-
-      const parsed = posts.map(post => {
-        const midMatch = (post.id || '').match(/reply-chain-summary-(\d+)/);
-        const mid = midMatch ? midMatch[1] : '';
-        const subjectEl = post.querySelector('[data-tid="subject-line"]');
-        const subheaderEl = post.querySelector('[data-tid="post-message-subheader"]');
-        const tsEl = post.querySelector('[data-tid="timestamp"]');
-        const allBodies = Array.from(post.querySelectorAll('[data-tid="message-body"]'));
-        const postBody = allBodies.find(b => {
-          const closest = b.closest('[role="group"]');
-          return closest === null || closest.id === post.id;
-        }) || allBodies[0];
-        const subheaderText = subheaderEl?.textContent.trim() || '';
-        const tsText = tsEl?.textContent.trim() || '';
-        const author = subheaderText.replace(new RegExp('\\s*' + tsText.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '.*$'), '').replace(/(Edited|New).*$/, '').trim();
-        const replyContainers = Array.from(post.querySelectorAll('[role="group"][id^="message-body-"]'))
-          .filter(r => !r.id.includes(mid));
-        const replies = replyContainers.map(r => {
-          const rMid = (r.id.match(/message-body-(\d+)/) || [])[1] || '';
-          const rTs = r.querySelector('[data-tid="timestamp"]');
-          const rContent = rMid ? document.getElementById('content-' + rMid) : null;
-          const rAuthor = rMid ? document.getElementById('author-' + rMid) : null;
-          return {
-            mid: rMid,
-            author: rAuthor?.textContent.trim() || '',
-            timestamp: rTs?.textContent.trim() || '',
-            body: (rContent?.innerText || r.querySelector('[data-tid="message-body"]')?.innerText || '').trim(),
-          };
-        });
-        let openRepliesBtn = null;
-        const parent = post.parentElement;
-        if (parent) {
-          const allButtons = parent.querySelectorAll('button[aria-label*="replies from"], button[aria-label*="Open"][aria-label*="replies"]');
-          for (const btn of allButtons) {
-            if (post.compareDocumentPosition(btn) & Node.DOCUMENT_POSITION_FOLLOWING) {
-              openRepliesBtn = btn;
-              break;
-            }
-          }
-        }
-        const moreLabel = openRepliesBtn?.getAttribute('aria-label') || '';
-        const moreMatch = moreLabel.match(/(\d+)\s+replies/);
-        const totalReplyCount = moreMatch ? Number(moreMatch[1]) : replies.length;
-        const hiddenReplies = Math.max(0, totalReplyCount - replies.length);
-
-        return {
-          mid,
-          subject: subjectEl?.textContent.trim() || '',
-          author,
-          timestamp: tsText,
-          body: (postBody?.innerText || '').trim(),
-          replies,
-          more_replies: hiddenReplies > 0 ? hiddenReplies : 0,
-        };
-      });
-
-      const ordered = parsed.slice().reverse();
-      return {
-        channel: channelName,
-        posts: ordered.slice(0, args.limit || 20),
-        total: parsed.length,
-        _virtualized: true,
-        _waited_ms: Date.now() - tStart,
-        _page: location.href,
-      };
-
-  _probe:
-    description: |
-      Diagnostic — returns the current Teams page state without touching
-      anything. Use to debug failed send_message / read_chat. Reports:
-      where we landed (URL + title), composer + send-button presence,
-      current chat header info, left-rail group + chat counts, top search
-      input + popup state, message stream height. Returns rich JSON; run
-      it after a failed call and share the output.
-    parameters: {}
-    returns: "{ url, title, ready, composer, send_btn, chat_header, left_rail, search, messages, time_ms }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 2000
-    script: |
-      const t0 = Date.now();
-      function quickCount(sel) { try { return document.querySelectorAll(sel).length; } catch { return 0; } }
-      function quickEl(sel) {
-        try {
-          const el = document.querySelector(sel);
-          if (!el) return null;
-          return {
-            present: true,
-            disabled: el.hasAttribute('disabled') || el.getAttribute('aria-disabled') === 'true',
-            dataTid: el.getAttribute('data-tid'),
-            ariaLabel: (el.getAttribute('aria-label') || '').slice(0, 60),
-            text: (el.innerText || '').replace(/\s+/g, ' ').trim().slice(0, 80),
-          };
-        } catch { return null; }
-      }
-      const lefRailLevel1 = [...document.querySelectorAll('[role="treeitem"][aria-level="1"]')].slice(0, 12).map(g => ({
-        label: (g.innerText || '').split('\n')[0].trim().slice(0, 30),
-        expanded: g.getAttribute('aria-expanded'),
-      }));
-      const composer = quickEl('[role="textbox"][contenteditable="true"][data-tid="ckeditor"]');
-      const sendBtn = quickEl('[data-tid="sendMessageCommands-send"]');
-      const chatHeader = quickEl('[data-tid^="participant-"]') || quickEl('[role="banner"]');
-      const popup = document.querySelector('[data-tid="ms-searchux-popup"]');
-      const messageStream = document.querySelector('[role="log"], [data-tid="message-pane-list-viewport"]');
-      return {
-        ok: true,
-        url: location.href,
-        title: document.title,
-        ready: !!composer && !!sendBtn,
-        composer,
-        send_btn: sendBtn,
-        chat_header: chatHeader,
-        left_rail: {
-          level_1_count: quickCount('[role="treeitem"][aria-level="1"]'),
-          level_2_count: quickCount('[role="treeitem"][aria-level="2"]'),
-          groups: lefRailLevel1,
-        },
-        search: {
-          input: !!document.querySelector('#ms-searchux-input'),
-          toggle_btn: !!document.querySelector('[data-tid="title-bar-toggle-search-btn"]'),
-          popup_present: !!popup,
-          popup_text_len: popup ? (popup.innerText || '').length : 0,
-        },
-        messages: {
-          stream_found: !!messageStream,
-          scroll_height: messageStream?.scrollHeight ?? 0,
-          li_count: quickCount('[role="log"] [role="listitem"], [data-tid="message-pane-list-viewport"] [data-tid^="chat-pane-message"]'),
-        },
-        ckeditor_classes_seen: [...document.querySelectorAll('[data-tid="ckeditor"]')].map(e => e.className.toString().slice(0, 30)).slice(0, 3),
-        time_ms: Date.now() - t0,
-      };
-
-  send_message:
-    description: |
-      Send a text message. Three resolution tiers for `name`:
-        1. Left-rail treeitem (existing 1:1 / group chat).
-        2. Expand any collapsed left-rail GROUP heading (aria-expanded=false
-           on level-1 items like "Favorites", "Chats", "Teams and channels")
-           and retry tier 1 — fixes the case where the chat is hidden under
-           a folded section.
-        3. Top search box (#ms-searchux-input) — type the name, pick the
-           first matching person/chat from the suggestion popup, click it
-           to open (creating a NEW 1:1 chat if none exists).
-
-      Without `name`: send to the currently-open chat.
-
-      ⚠ Sends IMMEDIATELY without user confirmation. Caller is responsible
-      for verifying the target and content before invoking. Plain text only
-      — CKEditor 5 paste injection + click on the Send button.
-    parameters:
-      text:
-        type: string
-        label: Message text
-        required: true
-      name:
-        type: string
-        label: Chat name (optional — substring, case-insensitive). If omitted, sends to the currently-open chat.
-        required: false
-    returns: "{ ok, sent_text, chat_title, switched, switched_in_ms, resolve_tier, groups_expanded, search_picked }"
-    page:
-      url: "{base_url}/v2/"
-      on_target: "teams.microsoft.com"
-      settle_after_load_ms: 5000
-    script: |
-      const text = String(args.text || '').trim();
-      if (!text) return { ok: false, error: 'text is required and must be non-empty' };
-      const name = String(args.name || '').trim();
-
-      // Wait for Teams ready
-      const readyStart = Date.now();
-      while (Date.now() - readyStart < 30000) {
-        if (document.querySelector('[role="textbox"][contenteditable="true"][data-tid="ckeditor"]')) break;
-        if (document.querySelectorAll('[role="treeitem"][aria-level="2"]').length > 0 && name) break;
-        await new Promise(r => setTimeout(r, 500));
-      }
-
-      // ─── Resolve target chat by name (3-tier) ─────────────────────
-      let switched = false;
-      let switchedMs = 0;
-      let resolveTier = null;      // 'already-here' / 'left-rail' / 'expanded-group' / 'search'
-      let groupsExpanded = [];
-      let searchPicked = null;
-
-      function findLeftRailMatch(lower) {
-        const items = [...document.querySelectorAll('[role="treeitem"][aria-level="2"]')];
-        return items.find(t => (t.innerText || '').split('\n')[0].trim().toLowerCase().includes(lower)) || null;
-      }
-      async function waitForChatSwitch(lowerName, titleBefore, maxMs = 30000) {
-        const t0 = Date.now();
-        while (Date.now() - t0 < maxMs) {
-          await new Promise(r => setTimeout(r, 200));
-          if (document.title !== titleBefore &&
-              (!lowerName || document.title.toLowerCase().includes(lowerName))) {
-            return Date.now() - t0;
-          }
-        }
-        return -1;
-      }
-
-      if (name) {
-        const lower = name.toLowerCase();
-        if (document.title.toLowerCase().includes(lower)) {
-          resolveTier = 'already-here';
-        } else {
-          // Tier 1: left rail as-is
-          let match = findLeftRailMatch(lower);
-          // Tier 2: expand collapsed level-1 group headings ("Favorites",
-          // "Chats", "Teams and channels", …) then retry the search.
-          if (!match) {
-            const collapsed = [...document.querySelectorAll('[role="treeitem"][aria-level="1"][aria-expanded="false"]')];
-            for (const g of collapsed) {
-              const label = (g.innerText || '').split('\n')[0].trim();
-              try { g.click(); groupsExpanded.push(label); } catch {}
-              await new Promise(r => setTimeout(r, 250));
-            }
-            if (groupsExpanded.length > 0) {
-              // Settle for the newly-revealed treeitems to mount
-              await new Promise(r => setTimeout(r, 600));
-              match = findLeftRailMatch(lower);
-            }
-          }
-
-          if (match) {
-            resolveTier = groupsExpanded.length > 0 ? 'expanded-group' : 'left-rail';
-            const titleBefore = document.title;
-            match.click();
-            const took = await waitForChatSwitch(lower, titleBefore);
-            if (took < 0) {
-              return { ok: false, error: 'Timed out waiting for chat switch (30s).', target_name: name, resolve_tier: resolveTier, groups_expanded: groupsExpanded };
-            }
-            switchedMs = took; switched = true;
-            await new Promise(r => setTimeout(r, 800));     // composer remount settle
-          } else {
-            // Tier 3: top search box. Open it (some Teams layouts collapse
-            // the search bar behind a button), then type and pick.
-            let searchInput = document.querySelector('#ms-searchux-input');
-            if (!searchInput) {
-              const toggle = document.querySelector('[data-tid="title-bar-toggle-search-btn"]');
-              if (toggle) {
-                try { toggle.click(); } catch {}
-                for (let i = 0; i < 20 && !searchInput; i++) {
-                  await new Promise(r => setTimeout(r, 150));
-                  searchInput = document.querySelector('#ms-searchux-input');
-                }
-              }
-            }
-            if (!searchInput) {
-              return {
-                ok: false,
-                error: `No left-rail match for "${name}" and search input not found. Open the chat manually first.`,
-                groups_expanded: groupsExpanded,
-                visible_chats: [...document.querySelectorAll('[role="treeitem"][aria-level="2"]')].slice(0, 30).map(c => (c.innerText || '').split('\n')[0].trim()).filter(Boolean),
-              };
-            }
-            // Programmatic type — Teams uses React-controlled input and
-            // sometimes also listens to keyboard events to trigger the
-            // backend autosuggest fetch. Empirically: synthetic
-            // \`input\` alone left the popup empty; pairing it with
-            // beforeinput/keydown/keyup makes Teams actually call the
-            // search backend.
-            searchInput.focus(); searchInput.click();
-            await new Promise(r => setTimeout(r, 200));
-            const nativeSetter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set;
-            // Send char-by-char so React + Teams' autosuggest get every event
-            // they need (the all-at-once path was unreliable in probing).
-            nativeSetter.call(searchInput, '');
-            searchInput.dispatchEvent(new Event('input', { bubbles: true }));
-            for (let i = 0; i < name.length; i++) {
-              const ch = name[i];
-              const partial = name.slice(0, i + 1);
-              searchInput.dispatchEvent(new KeyboardEvent('keydown', { key: ch, bubbles: true }));
-              nativeSetter.call(searchInput, partial);
-              searchInput.dispatchEvent(new InputEvent('beforeinput', { inputType: 'insertText', data: ch, bubbles: true, cancelable: true }));
-              searchInput.dispatchEvent(new InputEvent('input', { inputType: 'insertText', data: ch, bubbles: true }));
-              searchInput.dispatchEvent(new KeyboardEvent('keyup', { key: ch, bubbles: true }));
-              await new Promise(r => setTimeout(r, 40));
-            }
-
-            // Wait for the suggestion popup to populate (Teams backend call
-            // takes ~500-2000ms over corp network).
-            let popup = null;
-            for (let i = 0; i < 40; i++) {
-              await new Promise(r => setTimeout(r, 200));
-              popup = document.querySelector('[data-tid="ms-searchux-popup"]');
-              if (popup && (popup.innerText || '').trim().length > 30) break;
-            }
-            if (!popup) {
-              // Clear the search box on failure
-              nativeSetter.call(searchInput, ''); searchInput.dispatchEvent(new Event('input', { bubbles: true }));
-              return { ok: false, error: 'Search popup did not appear within 8s', name };
-            }
-
-            // Pick the first item that mentions the name. Teams puts each
-            // result inside a role-presentation or role-option wrapper with
-            // the person's display name in innerText.
-            const lowerName = name.toLowerCase();
-            const allRows = [...popup.querySelectorAll('[role="option"], [data-tid^="search-suggestion"], [data-tid$="-result"], li, button, div[tabindex="-1"]')];
-            const seenTexts = new Set();
-            const candidates = [];
-            for (const el of allRows) {
-              const txt = (el.innerText || '').replace(/\s+/g, ' ').trim();
-              if (!txt || seenTexts.has(txt) || txt.length > 200) continue;
-              seenTexts.add(txt);
-              if (txt.toLowerCase().includes(lowerName)) candidates.push({ el, text: txt });
-              if (candidates.length >= 8) break;
-            }
-            if (candidates.length === 0) {
-              const preview = (popup.innerText || '').slice(0, 400);
-              nativeSetter.call(searchInput, ''); searchInput.dispatchEvent(new Event('input', { bubbles: true }));
-              return { ok: false, error: `Search popup had no item matching "${name}"`, popup_text_preview: preview };
-            }
-            searchPicked = candidates[0].text;
-            resolveTier = 'search';
-
-            const titleBefore = document.title;
-            try { candidates[0].el.click(); } catch {}
-            // Search popup might intercept the click — also try keyboard Enter as fallback
-            const took = await waitForChatSwitch(null, titleBefore, 12000);
-            if (took < 0) {
-              // Fallback: synthesize Enter key on the search input
-              searchInput.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));
-              const took2 = await waitForChatSwitch(null, titleBefore, 8000);
-              if (took2 < 0) {
-                return { ok: false, error: 'Clicking the search result did not open a chat', search_picked: searchPicked };
-              }
-              switchedMs = took2;
-            } else {
-              switchedMs = took;
-            }
-            switched = true;
-            // The composer takes a beat to mount on a fresh 1:1 chat
-            await new Promise(r => setTimeout(r, 1200));
-          }
-        }
-      }
-
-      // Find composer (might have just remounted after switch)
-      let composer = document.querySelector('[role="textbox"][contenteditable="true"][data-tid="ckeditor"]');
-      for (let i = 0; i < 30 && !composer; i++) {
-        await new Promise(r => setTimeout(r, 200));
-        composer = document.querySelector('[role="textbox"][contenteditable="true"][data-tid="ckeditor"]');
-      }
-      if (!composer) {
-        return { ok: false, error: 'Compose box not found after waiting.' };
-      }
-
-      const sendBtn = document.querySelector('[data-tid="sendMessageCommands-send"]');
-      if (!sendBtn) {
-        return { ok: false, error: 'Send button not found.' };
-      }
-
-      // Focus + paste-inject
-      composer.focus();
-      const dt = new DataTransfer();
-      dt.setData('text/plain', text);
-      const pasteEvent = new ClipboardEvent('paste', {
-        clipboardData: dt,
-        bubbles: true,
-        cancelable: true,
-      });
-      composer.dispatchEvent(pasteEvent);
-      await new Promise(r => setTimeout(r, 300));
-
-      const composerText = composer.innerText.trim();
-      if (!composerText.includes(text)) {
-        return {
-          ok: false,
-          error: 'Composer did not accept the input — CKEditor may have rejected the paste.',
-          composer_text: composerText.slice(0, 100),
-        };
-      }
-
-      const disabled = sendBtn.hasAttribute('disabled') || sendBtn.getAttribute('aria-disabled') === 'true';
-      if (disabled) {
-        return { ok: false, error: 'Send button is still disabled after injection.' };
-      }
-
-      const headerParticipant = document.querySelector('[data-tid^="participant-"]');
-      const chatTitle = headerParticipant
-        ? (headerParticipant.innerText || '').trim().split('\n')[0]
-        : (document.title.split('|').map(s => s.trim())[1] || '');
-
-      sendBtn.click();
-      await new Promise(r => setTimeout(r, 400));
-
-      return {
-        ok: true,
-        sent_text: text,
-        chat_title: chatTitle,
-        switched,
-        switched_in_ms: switchedMs,
-        resolve_tier: resolveTier,
-        groups_expanded: groupsExpanded,
-        search_picked: searchPicked,
-        url: location.href,
-      };