@infilectai/aira 0.0.0-stage → 0.1.0

package/native/NativeMeetingScraper.swift

@@ -0,0 +1,1277 @@
+import Foundation
+import AppKit
+import ApplicationServices
+import CoreGraphics
+import JavaScriptCore
+
+/// Native macOS Accessibility & AppleScript scraper for Zoom, Google Meet, and Microsoft Teams.
+/// Incorporates the multi-locale AX rules, JavaScriptCore rule engine, and mouse-idle backpressure patterns
+/// from Recall's desktop SDK alongside Aira's Google Meet DOM/AX probes.
+public final class NativeMeetingScraper: @unchecked Sendable {
+    public static let shared = NativeMeetingScraper()
+
+    public struct ScrapeSnapshot: Sendable {
+        public let participants: [Participant]
+        public let activeSpeakerId: String?
+        public let activeSpeakerName: String?
+        public let localUserName: String?
+        public let meetingTitle: String?
+        public let meetingUrl: String?
+    }
+
+    // 17-locale Zoom strings from Recall's JSUIScrapingService
+    private static let zoomMeetingMenuTitles: Set<String> = [
+        "Meeting", "Reunión", "Réunion", "Meeting-Steuerung", "Reunião",
+        "ミーティング", "회의", "会议", "會議", "Встреча", "Riunione",
+        " Spotkanie", "Spotkanie", "Vergadering", "Toplantı", "Cuộc họp",
+        "Rapat", "Конференция", "Möte"
+    ]
+
+    private static let zoomVideoRenderRoleDescriptions: Set<String> = [
+        "Video render", "Renderização de vídeo", "Renderizado de video",
+        "Rendu vidéo", "Videorendering", "ビデオレンダリング", "비디오 렌더링",
+        "视频渲染", "視訊轉譯", "Видео рендеринг", "Rendering video",
+        "Renderowanie wideo", "Video weergeven", "Video oluşturma", "Kết xuất video",
+        "Video rendern", "Representación de vídeo", "Render video", "ビデオ レンダリング",
+        "videorender", "Обработка видео", "Videoåtergivning", "視訊轉換"
+    ]
+
+    private static let zoomAudioStatusKeywords: [String] = [
+        "unmuted", "muted", "audio", "stummgeschaltet", "stumm", "muet",
+        "silenciado", "silêncio", "ミュート", "음소거", "静音", "靜音", "звук"
+    ]
+
+    private static let browserBundleIds: Set<String> = [
+        "com.google.Chrome",
+        "company.thebrowser.Browser", // Arc
+        "com.brave.Browser",
+        "com.microsoft.edgemac",
+        "com.vivaldi.Vivaldi",
+        "com.apple.Safari",
+        "ai.perplexity.comet",
+        "company.thebrowser.dia"
+    ]
+
+    private let meetCodeRegex = try! NSRegularExpression(
+        pattern: #"meet\.google\.com/([a-z]{3}-[a-z]{4}-[a-z]{3})"#,
+        options: [.caseInsensitive]
+    )
+
+    private let jsLock = NSLock()
+    private let jsContext: JSContext
+    private var lastAppleScriptPollTime: Double = 0
+    private var appleScriptBackoffUntil: Double = 0
+    private var cachedAppleScriptSnapshot: ScrapeSnapshot?
+    private let axLock = NSLock()
+    private var enabledAccessibilityPIDs: [pid_t: Double] = [:]
+
+    private init() {
+        self.jsContext = JSContext()!
+        setupZoomJSRuleEngine()
+    }
+
+    private func setupZoomJSRuleEngine() {
+        let script = """
+        var ZoomScraperRules = {
+          isStatusLabelTitle: function(title) {
+            var trimmed = String(title || "").trim();
+            return /Participant ID:\\s*\\d+/i.test(trimmed)
+              || /^Meeting\\s+\\d+-minutes$/i.test(trimmed)
+              || trimmed.toLowerCase() === "meeting info";
+          },
+          parseDescription: function(description) {
+            var parts = String(description || "").split(',').map(function(p) { return p.trim(); });
+            var audioKeywords = ["muted", "unmuted", "audio", "stummgeschaltet", "stumm", "muet", "silenciado", "ミュート", "음소거", "静音", "靜音", "звук"];
+            var audioPartIdx = -1;
+            for (var i = 1; i < parts.length; i++) {
+              var lower = parts[i].toLowerCase();
+              var words = lower.split(/\\s+/);
+              for (var k = 0; k < audioKeywords.length; k++) {
+                var kw = audioKeywords[k];
+                if (words.indexOf(kw) !== -1 || (kw.length > 5 && lower.indexOf(kw) !== -1)) {
+                  audioPartIdx = i;
+                  break;
+                }
+              }
+              if (audioPartIdx !== -1) break;
+            }
+            var rawName = "";
+            var isActiveSpeaker = false;
+            if (parts.length >= 2 && audioPartIdx === 1) {
+              rawName = parts[0];
+              isActiveSpeaker = parts.slice(2).some(function(p) { return p.toLowerCase().indexOf("active speaker") !== -1; });
+            } else if (audioPartIdx === -1) {
+              rawName = parts[0] || "";
+              isActiveSpeaker = parts.slice(1).some(function(p) { return p.toLowerCase().indexOf("active speaker") !== -1; });
+            } else {
+              rawName = parts.slice(0, audioPartIdx).join(", ");
+              isActiveSpeaker = parts.slice(audioPartIdx + 1).some(function(p) { return p.toLowerCase().indexOf("active speaker") !== -1; });
+            }
+            var isLocalUser = /\\((You|Me)\\)/i.test(rawName);
+            return {
+              name: rawName.replace(/\\s*\\((Host|Co-host|You|Me)\\)\\s*/ig, "").trim(),
+              isActiveSpeaker: !!isActiveSpeaker,
+              isLocalUser: !!isLocalUser,
+              hasAudioStatus: audioPartIdx !== -1
+            };
+          }
+        };
+        """
+        jsContext.evaluateScript(script)
+    }
+
+    /// Enables `AXEnhancedUserInterface` (and `AXManualAccessibility` for Chromium/Electron apps)
+    /// on the target application's `AXUIElement`, matching Recall's `setAccessibilityForChromium`,
+    /// `setAccessibilityForTeams`, and `setAccessibilityForZoom`. Without this, Chromium and Electron
+    /// do not expose `AXWebArea` or DOM children unless VoiceOver is active.
+    public func ensureAccessibilityEnabled(for pid: pid_t, bundleId: String? = nil) {
+        let now = ProcessInfo.processInfo.systemUptime
+        axLock.lock()
+        if let last = enabledAccessibilityPIDs[pid], (now - last) < 15.0 {
+            axLock.unlock()
+            return
+        }
+        enabledAccessibilityPIDs[pid] = now
+        axLock.unlock()
+
+        let axApp = AXUIElementCreateApplication(pid)
+        _ = AXUIElementSetAttributeValue(axApp, "AXEnhancedUserInterface" as CFString, kCFBooleanTrue)
+        if bundleId != "us.zoom.xos" {
+            _ = AXUIElementSetAttributeValue(axApp, "AXManualAccessibility" as CFString, kCFBooleanTrue)
+        }
+    }
+
+    // MARK: - Mouse Activity Backpressure (PollerWithMouseDetection)
+
+    /// Returns true if the user is actively dragging or moving the mouse right now,
+    /// allowing callers to skip deep AX traversals and prevent UI hitches.
+    public func isUserActivelyDraggingMouse() -> Bool {
+        let dragIdle = CGEventSource.secondsSinceLastEventType(.combinedSessionState, eventType: .leftMouseDragged)
+        return dragIdle < 0.12
+    }
+
+    // MARK: - Active Meeting Target Discovery
+
+    /// Inspects a running application via AX to verify if it hosts an active Zoom, Meet, or Teams call.
+    public func detectMeetings(in app: NSRunningApplication) -> [MeetingTarget] {
+        guard let bundleId = app.bundleIdentifier else { return [] }
+        let pid = app.processIdentifier
+        ensureAccessibilityEnabled(for: pid, bundleId: bundleId)
+        let axApp = AXUIElementCreateApplication(pid)
+        let appName = app.localizedName ?? bundleId
+
+        if bundleId == "us.zoom.xos" {
+            if let target = detectZoomMeeting(axApp: axApp, pid: pid) {
+                return [target]
+            }
+            return []
+        }
+
+        if bundleId == "com.microsoft.teams" || bundleId == "com.microsoft.teams2" {
+            if let target = detectTeamsMeeting(axApp: axApp, pid: pid, appName: appName) {
+                return [target]
+            }
+            return []
+        }
+
+        if Self.browserBundleIds.contains(bundleId) {
+            return detectBrowserMeetings(axApp: axApp, pid: pid, bundleId: bundleId, appName: appName)
+        }
+
+        return []
+    }
+
+    // MARK: - Live Speaker & Roster Scraping
+
+    /// Scrapes the current participant roster and active speaker for a target meeting.
+    public func scrape(target: MeetingTarget) -> ScrapeSnapshot? {
+        if isUserActivelyDraggingMouse() {
+            return nil
+        }
+
+        ensureAccessibilityEnabled(for: target.pid)
+        let axApp = AXUIElementCreateApplication(target.pid)
+        switch target.platform {
+        case "zoom":
+            return scrapeZoom(axApp: axApp)
+        case "teams":
+            return scrapeTeams(axApp: axApp)
+        case "google-meet":
+            return scrapeGoogleMeet(axApp: axApp, target: target)
+        default:
+            return scrapeGoogleMeet(axApp: axApp, target: target)
+        }
+    }
+
+    // MARK: - 1. Zoom Native AX Scraper
+
+    private static let zoomSignOutTitles: Set<String> = [
+        "Abmelden", "Sign out", "Cerrar sesión", "Déconnexion", "Keluar",
+        "Disconnetti", "サインアウト", "로그아웃", "Afmelden", "Wyloguj się",
+        "Sair", "Выход", "Logga ut", "Çıkış Yap", "Đăng xuất", "退出登录", "登出"
+    ]
+
+    private func detectZoomMeeting(axApp: AXUIElement, pid: pid_t) -> MeetingTarget? {
+        let hasMeetingMenu = checkZoomHasMeetingMenu(axApp: axApp)
+        guard let windows = getAXWindows(axApp) else {
+            if hasMeetingMenu {
+                return MeetingTarget(pid: pid, browser: "Zoom", platform: "zoom", url: "zoom://meeting/\(pid)", title: "Zoom Meeting")
+            }
+            return nil
+        }
+
+        var meetingTitle: String?
+        var foundActiveCallWindow = false
+
+        for win in windows {
+            let winTitle = getStringAttr(win, kAXTitleAttribute as String) ?? ""
+            if winTitle.contains("Zoom Meeting") || winTitle.contains("Zoom Webinar") || winTitle.hasPrefix("Talking:") {
+                foundActiveCallWindow = true
+                if meetingTitle == nil && !winTitle.hasPrefix("Talking:") {
+                    meetingTitle = winTitle
+                }
+            }
+            if let infoBtn = findElement(in: win, maxDepth: 10, maxNodes: 800, where: {
+                getStringAttr($0, kAXIdentifierAttribute as String) == "MeetingTopBarInfoButton"
+            }) {
+                foundActiveCallWindow = true
+                if let desc = getStringAttr(infoBtn, kAXDescriptionAttribute as String),
+                   !desc.isEmpty,
+                   !isZoomStatusLabelTitle(desc) {
+                    meetingTitle = desc
+                }
+            }
+        }
+
+        guard hasMeetingMenu || foundActiveCallWindow else { return nil }
+        let finalTitle = meetingTitle ?? "Zoom Meeting"
+        return MeetingTarget(
+            pid: pid,
+            browser: "Zoom",
+            platform: "zoom",
+            url: "zoom://meeting/\(pid)",
+            title: finalTitle
+        )
+    }
+
+    private func isZoomStatusLabelTitle(_ title: String) -> Bool {
+        let trimmed = title.trimmingCharacters(in: .whitespacesAndNewlines)
+        let lower = trimmed.lowercased()
+        if lower == "meeting info" || lower.contains("participant id:") {
+            return true
+        }
+        if trimmed.range(of: #"^Meeting\s+\d+-minutes$"#, options: [.regularExpression, .caseInsensitive]) != nil {
+            return true
+        }
+        return false
+    }
+
+    private func checkZoomHasMeetingMenu(axApp: AXUIElement) -> Bool {
+        var val: AnyObject?
+        guard AXUIElementCopyAttributeValue(axApp, kAXMenuBarAttribute as CFString, &val) == .success,
+              let menuBar = val else { return false }
+        let menuBarEl = menuBar as! AXUIElement
+        guard let items = getAXChildren(menuBarEl) else { return false }
+        for item in items {
+            if let title = getStringAttr(item, kAXTitleAttribute as String),
+               Self.zoomMeetingMenuTitles.contains(title) {
+                return true
+            }
+        }
+        return false
+    }
+
+    /// Scrapes the local Zoom user's display name from `"Zoom Workplace" -> "Sign out" -> "✓ <Name> (<email>)"`
+    /// matching `ZoomScraperScripts.scrapeSignOutButton` in Recall's `6.5.9.61929.js`.
+    private func scrapeZoomSignOutUsername(axApp: AXUIElement) -> String? {
+        var val: AnyObject?
+        guard AXUIElementCopyAttributeValue(axApp, kAXMenuBarAttribute as CFString, &val) == .success,
+              let menuBar = val else { return nil }
+        let menuBarEl = menuBar as! AXUIElement
+        guard let barItems = getAXChildren(menuBarEl) else { return nil }
+        for barItem in barItems {
+            guard getStringAttr(barItem, kAXTitleAttribute as String) == "Zoom Workplace" else { continue }
+            if let signOutItem = findElement(in: barItem, maxDepth: 4, maxNodes: 120, where: { el in
+                if let t = getStringAttr(el, kAXTitleAttribute as String) {
+                    return Self.zoomSignOutTitles.contains(t)
+                }
+                return false
+            }) {
+                if let checkedItem = findElement(in: signOutItem, maxDepth: 4, maxNodes: 80, where: { el in
+                    getStringAttr(el, "AXMenuItemMarkChar") == "✓"
+                }) {
+                    if let full = getStringAttr(checkedItem, kAXTitleAttribute as String) {
+                        let name = full.components(separatedBy: "(").first?.trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
+                        if !name.isEmpty { return name }
+                    }
+                }
+            }
+        }
+        return nil
+    }
+
+    private func scrapeZoom(axApp: AXUIElement) -> ScrapeSnapshot? {
+        guard let windows = getAXWindows(axApp) else { return nil }
+
+        var participantsById: [String: Participant] = [:]
+        var activeSpeakerName: String?
+        var localUserName: String? = scrapeZoomSignOutUsername(axApp: axApp)
+        var meetingTitle: String?
+        var foundVideoRenderTiles = false
+        var immersiveCandidates: [(name: String, isSpeaking: Bool, isLocal: Bool)] = []
+        var bannerSpeakers: [String] = []
+
+        for win in windows {
+            let winTitle = getStringAttr(win, kAXTitleAttribute as String) ?? ""
+
+            // Check minimized / floating PIP "Talking: <Name>" indicator
+            if let idx = winTitle.range(of: "Talking:") {
+                let raw = String(winTitle[idx.upperBound...])
+                let names = raw.split(separator: ",").map { $0.trimmingCharacters(in: .whitespacesAndNewlines) }.filter { !$0.isEmpty }
+                for speaker in names {
+                    bannerSpeakers.append(speaker)
+                }
+            }
+
+            // Walk window up to depth 14 for Video render tiles, immersive AXUnknown tiles, and Talking banners
+            walkElements(in: win, maxDepth: 14, maxNodes: 1500) { el in
+                let role = getStringAttr(el, kAXRoleAttribute as String) ?? ""
+                let roleDesc = getStringAttr(el, kAXRoleDescriptionAttribute as String) ?? ""
+                let ident = getStringAttr(el, kAXIdentifierAttribute as String) ?? ""
+                let desc = getStringAttr(el, kAXDescriptionAttribute as String) ?? ""
+                let val = getStringAttr(el, kAXValueAttribute as String) ?? ""
+
+                if ident == "MeetingTopBarInfoButton", !desc.isEmpty, !isZoomStatusLabelTitle(desc) {
+                    meetingTitle = desc
+                }
+
+                // Check "Talking: <Name>" text elements in floating thumbnail bar (may list comma-separated speakers)
+                for textCandidate in [val, desc] {
+                    if let idx = textCandidate.range(of: "Talking:") {
+                        let raw = String(textCandidate[idx.upperBound...])
+                        let names = raw.split(separator: ",").map { $0.trimmingCharacters(in: .whitespacesAndNewlines) }.filter { !$0.isEmpty }
+                        for name in names {
+                            bannerSpeakers.append(name)
+                        }
+                    }
+                }
+
+                if Self.zoomVideoRenderRoleDescriptions.contains(roleDesc) {
+                    if let parsed = parseZoomVideoTileDescription(desc) {
+                        foundVideoRenderTiles = true
+                        participantsById[parsed.name] = Participant(id: parsed.name, name: parsed.name)
+                        if parsed.isSpeaking {
+                            activeSpeakerName = parsed.name
+                        }
+                        if parsed.isLocal && localUserName == nil {
+                            localUserName = parsed.name
+                        }
+                    }
+                } else if role == "AXUnknown", !desc.isEmpty {
+                    if let parsed = parseZoomVideoTileDescription(desc), parsed.hasAudioStatus {
+                        immersiveCandidates.append((parsed.name, parsed.isSpeaking, parsed.isLocal))
+                    }
+                }
+            }
+        }
+
+        // Fallbacks for layouts with no Video-render tiles (immersive, hide-thumbnail PIP), matching 6.5.9.61929.js
+        if !foundVideoRenderTiles {
+            for item in immersiveCandidates {
+                participantsById[item.name] = Participant(id: item.name, name: item.name)
+                if item.isSpeaking { activeSpeakerName = item.name }
+                if item.isLocal && localUserName == nil { localUserName = item.name }
+            }
+            for speaker in bannerSpeakers {
+                participantsById[speaker] = Participant(id: speaker, name: speaker)
+                activeSpeakerName = speaker
+            }
+        } else if activeSpeakerName == nil, let firstBanner = bannerSpeakers.first {
+            participantsById[firstBanner] = Participant(id: firstBanner, name: firstBanner)
+            activeSpeakerName = firstBanner
+        }
+
+        let roster = Array(participantsById.values).sorted { $0.name < $1.name }
+        if roster.isEmpty && activeSpeakerName == nil && meetingTitle == nil {
+            return nil
+        }
+
+        return ScrapeSnapshot(
+            participants: roster,
+            activeSpeakerId: activeSpeakerName,
+            activeSpeakerName: activeSpeakerName,
+            localUserName: localUserName,
+            meetingTitle: meetingTitle,
+            meetingUrl: nil
+        )
+    }
+
+    /// Parses Zoom's `"<Name>, unmuted, active speaker"` or `"<Last, First>, muted, video on"`
+    /// by anchoring on the audio status token (`muted` / `unmuted` / `audio`), matching Recall's `6.5.9.61929.js`.
+    private func parseZoomVideoTileDescription(_ desc: String) -> (name: String, isSpeaking: Bool, isLocal: Bool, hasAudioStatus: Bool)? {
+        let trimmed = desc.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !trimmed.isEmpty else { return nil }
+
+        // Evaluate via Recall-style JavaScriptCore rule engine first
+        jsLock.lock()
+        let jsParsed: [String: Any]? = {
+            guard let rules = jsContext.objectForKeyedSubscript("ZoomScraperRules"),
+                  let val = rules.invokeMethod("parseDescription", withArguments: [trimmed]),
+                  val.isObject else { return nil }
+            return val.toDictionary() as? [String: Any]
+        }()
+        jsLock.unlock()
+
+        if let dict = jsParsed,
+           let name = dict["name"] as? String,
+           !name.isEmpty,
+           name.count < 80 {
+            let speaking = (dict["isActiveSpeaker"] as? Bool) ?? false
+            let isLocal = (dict["isLocalUser"] as? Bool) ?? false
+            let hasAudio = (dict["hasAudioStatus"] as? Bool) ?? false
+            return (name, speaking, isLocal, hasAudio)
+        }
+
+        let parts = trimmed.split(separator: ",").map { $0.trimmingCharacters(in: .whitespaces) }
+        guard !parts.isEmpty else { return nil }
+
+        var statusIndex: Int?
+        for (idx, part) in parts.enumerated() where idx > 0 {
+            let lower = part.lowercased()
+            if Self.zoomAudioStatusKeywords.contains(where: { lower.contains($0) }) ||
+               lower.contains("video") || lower.contains("active speaker") || lower.contains("host") || lower.contains("co-host") {
+                statusIndex = idx
+                break
+            }
+        }
+
+        let rawName: String
+        if let idx = statusIndex {
+            rawName = parts[0..<idx].joined(separator: ", ")
+        } else {
+            rawName = parts[0]
+        }
+
+        let isLocal = rawName.range(of: #"\((You|Me)\)"#, options: [.regularExpression, .caseInsensitive]) != nil
+        let cleanName = rawName
+            .replacingOccurrences(of: #"\s*\((Host|Co-host|You|Me)\)\s*"#, with: "", options: [.regularExpression, .caseInsensitive])
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+
+        guard !cleanName.isEmpty, cleanName.count < 80 else { return nil }
+
+        let lowerDesc = trimmed.lowercased()
+        let isSpeaking = lowerDesc.contains("active speaker") || lowerDesc.contains("speaking")
+        return (cleanName, isSpeaking, isLocal, statusIndex != nil)
+    }
+
+    // MARK: - 2. Google Meet Scraper (Recall AXDOMClassList + AppleScript DOM Probe)
+
+    private func detectBrowserMeetings(axApp: AXUIElement, pid: pid_t, bundleId: String, appName: String) -> [MeetingTarget] {
+        guard let windows = getAXWindows(axApp) else { return [] }
+        var targets: [MeetingTarget] = []
+        let browserSlug = normalizeBrowserName(bundleId: bundleId, appName: appName)
+
+        for win in windows {
+            let winTitle = getStringAttr(win, kAXTitleAttribute as String) ?? ""
+            let docUrl = getStringAttr(win, "AXDocument") ?? ""
+
+            // Ignore tiny floating sharing notification bars that aren't actual Meet windows
+            if (winTitle.contains("is sharing your screen") || winTitle.contains(" is sharing a window")) &&
+               !winTitle.lowercased().contains("meet") && docUrl.isEmpty {
+                continue
+            }
+
+            // 1. Check active WebArea or AXDocument for a real Meet URL (`https://meet.google.com/abc-defg-hij`)
+            let webArea = findWebArea(in: win, maxDepth: 12)
+            let waUrl = (webArea.flatMap { getStringAttr($0, kAXURLAttribute as String) }) ?? docUrl
+            let waTitle = (webArea.flatMap { getStringAttr($0, kAXTitleAttribute as String) }) ?? winTitle
+
+            if let code = extractMeetCode(from: waUrl) ?? extractMeetCode(from: waTitle) ?? extractMeetCode(from: docUrl) {
+                let normalizedUrl = "https://meet.google.com/\(code)"
+                let cleanTitle = sanitizeMeetingTitle(waTitle.isEmpty ? winTitle : waTitle, fallbackCode: code)
+                if !targets.contains(where: { $0.url == normalizedUrl && $0.pid == pid }) {
+                    targets.append(MeetingTarget(pid: pid, browser: browserSlug, platform: "google-meet", url: normalizedUrl, title: cleanTitle))
+                }
+                continue
+            }
+
+            // 2. Check Omnibox URL field (`OmniboxViewViews`) or tab titles (`Meet - abc-defg-hij` or active call title)
+            let candidateTitles = [winTitle] + findTabTitles(in: win, maxDepth: 10)
+            for t in candidateTitles {
+                if let code = extractMeetCode(from: t) {
+                    let normalizedUrl = "https://meet.google.com/\(code)"
+                    let cleanTitle = sanitizeMeetingTitle(t, fallbackCode: code)
+                    if !targets.contains(where: { $0.url == normalizedUrl && $0.pid == pid }) {
+                        targets.append(MeetingTarget(pid: pid, browser: browserSlug, platform: "google-meet", url: normalizedUrl, title: cleanTitle))
+                    }
+                } else if t.hasPrefix("Meet - ") || t.hasPrefix("Meet – ") {
+                    let cleanTitle = sanitizeMeetingTitle(t, fallbackCode: nil)
+                    let suffix = cleanTitle.replacingOccurrences(of: #"^Meet\s*[-–]\s*"#, with: "", options: .regularExpression)
+                    if !suffix.isEmpty && !suffix.lowercased().hasPrefix("google meet") {
+                        let slug = suffix.lowercased().replacingOccurrences(of: #"[^a-z0-9]+"#, with: "-", options: .regularExpression)
+                            .trimmingCharacters(in: CharacterSet(charactersIn: "-"))
+                        if !slug.isEmpty {
+                            let url = "https://meet.google.com/\(slug)"
+                            if !targets.contains(where: { $0.url == url && $0.pid == pid }) {
+                                targets.append(MeetingTarget(pid: pid, browser: browserSlug, platform: "google-meet", url: url, title: cleanTitle))
+                            }
+                        }
+                    }
+                }
+            }
+        }
+
+        return targets
+    }
+
+    public func sanitizeMeetingTitle(_ rawTitle: String, fallbackCode: String?) -> String {
+        var cleaned = rawTitle
+            .replacingOccurrences(of: #"\s*-\s*(Microphone recording|Camera and microphone recording|Camera recording|Tab content shared|Audio playing|Memory usage.*)"#, with: "", options: [.regularExpression, .caseInsensitive])
+            .replacingOccurrences(of: #"\s*-\s*(Google Chrome|Brave|Microsoft Edge|Arc|Vivaldi|Safari)$"#, with: "", options: [.regularExpression, .caseInsensitive])
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+        if cleaned.isEmpty, let code = fallbackCode {
+            cleaned = "Meet - \(code)"
+        }
+        return cleaned
+    }
+
+    private func scrapeGoogleMeet(axApp: AXUIElement, target: MeetingTarget) -> ScrapeSnapshot? {
+        // Strategy A: Pure macOS Accessibility traversal using Recall's `GoogleMeetScraper` DOM class rules
+        // (`AXLandmarkMain`, `dkjMxf`, `oZRSLe`, `kssMZb`, `fdKMD`, `FTMc0c`, `tWDL4c`, `eQJ1qd`, `AXStaticText`).
+        // Works without any Chrome extension or AppleScript permission.
+        if let axSnap = scrapeGoogleMeetViaAX(axApp: axApp, target: target),
+           (!axSnap.participants.isEmpty || axSnap.activeSpeakerName != nil) {
+            return axSnap
+        }
+
+        // Strategy B: AppleScript DOM inspection fallback (when Chrome has "Allow JavaScript from Apple Events" enabled)
+        let now = ProcessInfo.processInfo.systemUptime
+        if now >= appleScriptBackoffUntil {
+            if (now - lastAppleScriptPollTime) >= 0.35 {
+                lastAppleScriptPollTime = now
+                if let domSnap = scrapeGoogleMeetViaAppleScript(browserName: target.browser) {
+                    cachedAppleScriptSnapshot = domSnap
+                    return domSnap
+                } else {
+                    cachedAppleScriptSnapshot = nil
+                }
+            } else if let cached = cachedAppleScriptSnapshot {
+                return cached
+            }
+        }
+
+        return nil
+    }
+
+    /// Implements Recall's `GoogleMeetScraper` (`0x100077dc4`) and `GoogleMeetParticipantName.scrape` (`0x100084998`)
+    /// directly against Chromium's `AXDOMClassList`, `AXSubrole`, and `AXStaticText` nodes.
+    public func scrapeGoogleMeetViaAX(axApp: AXUIElement, target: MeetingTarget) -> ScrapeSnapshot? {
+        guard let windows = getAXWindows(axApp) else { return nil }
+
+        var participantsById: [String: Participant] = [:]
+        var activeSpeakerId: String?
+        var activeSpeakerName: String?
+        var localUserName: String?
+
+        for win in windows {
+            // Find the Google Meet WebArea (or search from the window if WebArea isn't directly matched)
+            let webArea = findWebArea(in: win, maxDepth: 12)
+            let searchRoot = webArea ?? win
+            if let wa = webArea {
+                let url = getStringAttr(wa, kAXURLAttribute as String) ?? getStringAttr(win, "AXDocument") ?? ""
+                let title = getStringAttr(wa, kAXTitleAttribute as String) ?? ""
+                if !url.isEmpty && !url.contains("meet.google.com") && !title.lowercased().contains("meet") {
+                    continue
+                }
+            }
+
+            // 1. Check Chrome's AvatarToolbarButton on the window for local user first name hint
+            if localUserName == nil,
+               let avatarBtn = findElement(in: win, maxDepth: 10, maxNodes: 400, where: { el in
+                   getDOMClassList(el).contains("AvatarToolbarButton")
+               }),
+               let avatarDesc = getStringAttr(avatarBtn, kAXDescriptionAttribute as String),
+               isValidParticipantName(avatarDesc) {
+                localUserName = avatarDesc.trimmingCharacters(in: .whitespacesAndNewlines)
+            }
+
+            // 2. Check Sidepanel (`AXLandmarkComplementary`) for participant list items (`cxdMu` / `KV1GEc` or `" (You)"`)
+            let sidepanels = findElements(in: searchRoot, maxDepth: 14, maxNodes: 1500) { el in
+                getStringAttr(el, kAXSubroleAttribute as String) == "AXLandmarkComplementary"
+            }
+            for panel in sidepanels {
+                let listTiles = findElements(in: panel, maxDepth: 12, maxNodes: 800) { el in
+                    let cls = getDOMClassList(el)
+                    return cls.contains("cxdMu") || cls.contains("KV1GEc")
+                }
+                for item in listTiles {
+                    if let name = scrapeGoogleMeetParticipantName(in: item, maxDepth: 10) {
+                        let isYou = name.range(of: #"\s*\(You\)\s*$"#, options: [.regularExpression, .caseInsensitive]) != nil
+                        let clean = name.replacingOccurrences(of: #"\s*\(You\)\s*$"#, with: "", options: [.regularExpression, .caseInsensitive])
+                            .trimmingCharacters(in: .whitespacesAndNewlines)
+                        if isValidParticipantName(clean) {
+                            participantsById[clean] = Participant(id: clean, name: clean)
+                            if isYou { localUserName = clean }
+                        }
+                    }
+                }
+            }
+
+            // 3. Locate `AXLandmarkMain` (`GoogleMeetScraper - main`)
+            let mainLandmark = findElement(in: searchRoot, maxDepth: 16, maxNodes: 1500) { el in
+                getStringAttr(el, kAXSubroleAttribute as String) == "AXLandmarkMain"
+            }
+
+            if let main = mainLandmark {
+                // Find all tile slots (`dkjMxf`) inside `AXLandmarkMain`
+                // In Google Meet, `dkjMxf` carries `kssMZb` in `AXDOMClassList` when that slot's participant is speaking!
+                let tileSlots = findElements(in: main, maxDepth: 4, maxNodes: 300) { el in
+                    getDOMClassList(el).contains("dkjMxf")
+                }
+
+                // Also find any standalone `oZRSLe` tiles (e.g., floating self-view `Gv1mTb-PVLJEc` / `aGWPv`)
+                let videoRenders = findElements(in: main, maxDepth: 6, maxNodes: 500) { el in
+                    getDOMClassList(el).contains("oZRSLe")
+                }
+
+                let tilesToInspect: [(slot: AXUIElement, render: AXUIElement)] = {
+                    if !tileSlots.isEmpty {
+                        var pairs: [(AXUIElement, AXUIElement)] = []
+                        for slot in tileSlots {
+                            let render = findElement(in: slot, maxDepth: 4, maxNodes: 60) {
+                                getDOMClassList($0).contains("oZRSLe")
+                            } ?? slot
+                            pairs.append((slot, render))
+                        }
+                        for vr in videoRenders {
+                            let vrClasses = getDOMClassList(vr)
+                            if vrClasses.contains("Gv1mTb-PVLJEc") || vrClasses.contains("aGWPv") {
+                                pairs.append((vr, vr))
+                            }
+                        }
+                        return pairs
+                    }
+                    return videoRenders.map { ($0, $0) }
+                }()
+
+                for (slot, render) in tilesToInspect {
+                    let slotClasses = Set(getDOMClassList(slot))
+                    let renderClasses = Set(getDOMClassList(render))
+
+                    // Skip screen-share presentation tile (`Wkyg5e`)
+                    let isPresentation = findElement(in: render, maxDepth: 10, maxNodes: 250) {
+                        getDOMClassList($0).contains("Wkyg5e")
+                    } != nil
+                    if isPresentation { continue }
+
+                    guard let rawName = scrapeGoogleMeetParticipantName(in: render, maxDepth: 14) else {
+                        continue
+                    }
+
+                    let hasYouSuffix = rawName.range(of: #"\s*\(You\)\s*$"#, options: [.regularExpression, .caseInsensitive]) != nil
+                    let cleanName = rawName
+                        .replacingOccurrences(of: #"\s*\(You\)\s*$"#, with: "", options: [.regularExpression, .caseInsensitive])
+                        .trimmingCharacters(in: .whitespacesAndNewlines)
+
+                    guard isValidParticipantName(cleanName) else { continue }
+
+                    participantsById[cleanName] = Participant(id: cleanName, name: cleanName)
+
+                    // Check if this tile is the local user (`tWDL4c`, `eQJ1qd`, `Gv1mTb-PVLJEc`, `aGWPv`, or `(You)`)
+                    let isHostTile = hasYouSuffix ||
+                        slotClasses.contains("Gv1mTb-PVLJEc") || slotClasses.contains("aGWPv") ||
+                        renderClasses.contains("Gv1mTb-PVLJEc") || renderClasses.contains("aGWPv") ||
+                        findElement(in: render, maxDepth: 12, maxNodes: 300) { el in
+                            let c = getDOMClassList(el)
+                            return c.contains("tWDL4c") || c.contains("eQJ1qd")
+                        } != nil
+                    if isHostTile {
+                        localUserName = cleanName
+                    }
+
+                    // Check if muted (`FTMc0c`)
+                    let isMuted = findElement(in: render, maxDepth: 12, maxNodes: 300) { el in
+                        getDOMClassList(el).contains("FTMc0c")
+                    } != nil
+
+                    // Check if active speaker (`kssMZb` on slot/ancestor or `fdKMD` indicator inside tile)
+                    let hasActiveSpeakerClass = slotClasses.contains("kssMZb") || renderClasses.contains("kssMZb") ||
+                        findElement(in: slot, maxDepth: 12, maxNodes: 300) { el in
+                            let c = getDOMClassList(el)
+                            return c.contains("kssMZb") || c.contains("fdKMD")
+                        } != nil
+
+                    if hasActiveSpeakerClass && !isMuted {
+                        activeSpeakerName = cleanName
+                        activeSpeakerId = cleanName
+                    }
+                }
+            }
+
+            // 4. Also scan for ARIA live-region announcements or tile descriptions ("<Name> is speaking")
+            walkElements(in: searchRoot, maxDepth: 16, maxNodes: 1000) { el in
+                let desc = getStringAttr(el, kAXDescriptionAttribute as String) ?? ""
+                let elTitle = getStringAttr(el, kAXTitleAttribute as String) ?? ""
+                let val = getStringAttr(el, kAXValueAttribute as String) ?? ""
+
+                for text in [desc, elTitle, val] where !text.isEmpty {
+                    if let range = text.range(of: " is speaking", options: [.caseInsensitive]) {
+                        let speaker = String(text[..<range.lowerBound]).trimmingCharacters(in: .whitespacesAndNewlines)
+                        if isValidParticipantName(speaker) {
+                            activeSpeakerName = speaker
+                            activeSpeakerId = speaker
+                            participantsById[speaker] = Participant(id: speaker, name: speaker)
+                        }
+                    } else if let range = text.range(of: " has their microphone muted", options: [.caseInsensitive]) {
+                        let name = String(text[..<range.lowerBound]).trimmingCharacters(in: .whitespacesAndNewlines)
+                        if isValidParticipantName(name) {
+                            participantsById[name] = Participant(id: name, name: name)
+                        }
+                    }
+                }
+            }
+        }
+
+        // Upgrade single-token localUserName (e.g. "Abhi" from Chrome AvatarToolbarButton) to full roster name ("Abhi Jain")
+        if let local = localUserName, !participantsById.keys.contains(local) {
+            if let match = participantsById.values.first(where: {
+                $0.name.lowercased().hasPrefix(local.lowercased() + " ") || $0.name.lowercased() == local.lowercased()
+            }) {
+                localUserName = match.name
+            }
+        }
+
+        let roster = Array(participantsById.values).sorted { $0.name < $1.name }
+        if roster.isEmpty && activeSpeakerName == nil {
+            return nil
+        }
+
+        return ScrapeSnapshot(
+            participants: roster,
+            activeSpeakerId: activeSpeakerId,
+            activeSpeakerName: activeSpeakerName,
+            localUserName: localUserName,
+            meetingTitle: target.title,
+            meetingUrl: target.url
+        )
+    }
+
+    /// Extracts a participant's display name from a Google Meet tile (`oZRSLe` or `cxdMu`),
+    /// matching Recall's `GoogleMeetParticipantName.scrape` (`0x100084998`):
+    /// finds `AXStaticText` nodes while excluding `AXUserInterfaceTooltip` and overlay classes (`QTxFAf`, `uGwDxe`).
+    private func scrapeGoogleMeetParticipantName(in root: AXUIElement, maxDepth: Int) -> String? {
+        var candidates: [String] = []
+
+        func walk(_ el: AXUIElement, depth: Int, insideExcludedAncestor: Bool) {
+            guard depth <= maxDepth, candidates.count < 8 else { return }
+            let subrole = getStringAttr(el, kAXSubroleAttribute as String) ?? ""
+            let classes = getDOMClassList(el)
+            let excluded = insideExcludedAncestor ||
+                subrole == "AXUserInterfaceTooltip" ||
+                classes.contains("QTxFAf") ||
+                classes.contains("uGwDxe")
+            if excluded { return }
+
+            let role = getStringAttr(el, kAXRoleAttribute as String) ?? ""
+            if role == "AXStaticText" {
+                let raw = getStringAttr(el, kAXValueAttribute as String)
+                    ?? getStringAttr(el, kAXTitleAttribute as String)
+                    ?? getStringAttr(el, kAXDescriptionAttribute as String)
+                    ?? ""
+                let trimmed = raw.trimmingCharacters(in: .whitespacesAndNewlines)
+                if isUsableGoogleMeetNameCandidate(trimmed) {
+                    candidates.append(trimmed)
+                }
+            } else if depth <= 3 {
+                // Also check clean aria-label / AXDescription on container groups
+                if let desc = getStringAttr(el, kAXDescriptionAttribute as String), !desc.isEmpty {
+                    let clean = desc
+                        .replacingOccurrences(of: #"( is speaking| has their microphone muted|'s screen| is pinned).*"#, with: "", options: [.regularExpression, .caseInsensitive])
+                        .trimmingCharacters(in: .whitespacesAndNewlines)
+                    if clean != desc && isUsableGoogleMeetNameCandidate(clean) {
+                        candidates.append(clean)
+                    }
+                }
+            }
+
+            guard depth < maxDepth, let children = getAXChildren(el) else { return }
+            for child in children {
+                walk(child, depth: depth + 1, insideExcludedAncestor: excluded)
+            }
+        }
+
+        walk(root, depth: 0, insideExcludedAncestor: false)
+        return candidates.first
+    }
+
+    private func isUsableGoogleMeetNameCandidate(_ text: String) -> Bool {
+        let trimmed = text.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard trimmed.count >= 2 && trimmed.count <= 60 else { return false }
+        // Reject collapsed participant counters ("+3", "12")
+        if let first = trimmed.first, first == "+" || first.isNumber {
+            return false
+        }
+        let lower = trimmed.lowercased()
+        if lower.contains("others might still see your full video") ||
+           lower.contains("microphone is off") ||
+           lower.contains("microphone is on") ||
+           lower.contains("are you talking") {
+            return false
+        }
+        return isValidParticipantName(trimmed)
+    }
+
+    /// Executes a lightweight DOM inspection in Google Meet tabs (matching `access/watch_meet_speaker.py` +
+    /// Recall's `.kssMZb` / `.fdKMD` + multi-signal outline/animation detection) when Chrome has
+    /// "Allow JavaScript from Apple Events" enabled.
+    private func scrapeGoogleMeetViaAppleScript(browserName: String) -> ScrapeSnapshot? {
+        let appName: String
+        switch browserName.lowercased() {
+        case "chrome", "google chrome": appName = "Google Chrome"
+        case "brave", "brave browser": appName = "Brave Browser"
+        case "edge", "microsoft edge": appName = "Microsoft Edge"
+        case "arc": appName = "Arc"
+        default: appName = "Google Chrome"
+        }
+
+        let js = #"""
+        (function() {
+          var nameMap = {};
+          var selfEl = document.querySelector('[data-self-name]');
+          var selfName = selfEl ? selfEl.getAttribute('data-self-name') : null;
+
+          document.querySelectorAll('[data-participant-id]').forEach(function(el) {
+            var pid = el.getAttribute('data-participant-id');
+            var label = el.getAttribute('aria-label');
+            if (pid && label && label.length < 90) {
+              var clean = label.replace(/( is speaking| has their microphone muted|'s screen| is pinned).*/i, '').trim();
+              if (clean && !/^(pin|unpin|mute|unmute|remove|more options|you)$/i.test(clean)) {
+                nameMap[pid] = clean;
+              }
+            }
+          });
+
+          var participants = [];
+          var activePid = null;
+          var bestScore = 0;
+
+          document.querySelectorAll('[data-participant-id]').forEach(function(tile) {
+            var pid = tile.getAttribute('data-participant-id');
+            if (!pid) return;
+            if (!tile.classList.contains('oZRSLe') && !tile.hasAttribute('data-requested-participant-id')) return;
+
+            if (!nameMap[pid]) {
+              var lines = (tile.innerText || '').split('\n').map(function(s){return s.trim();}).filter(Boolean);
+              for (var i = 0; i < lines.length; i++) {
+                if (!/^(You|mic_off|pin|unpin|presenting|More options|Reframe|Backgrounds|visual_effects)$/i.test(lines[i]) && lines[i].length > 1 && lines[i].length < 60) {
+                  nameMap[pid] = lines[i];
+                  break;
+                }
+              }
+            }
+
+            var isHostTile = tile.querySelector('.tWDL4c, .eQJ1qd') !== null || /Reframe|Backgrounds|visual_effects/i.test(tile.textContent || '');
+            var name = nameMap[pid] || (selfName && isHostTile ? selfName : null);
+            if (!name) return;
+            nameMap[pid] = name;
+            if (isHostTile && !selfName) selfName = name;
+
+            var muted = (tile.textContent || '').indexOf('mic_off') !== -1 || tile.querySelector('[data-is-muted="true"], .FTMc0c') !== null;
+            participants.push({ id: pid, name: name, muted: muted });
+
+            var score = 0;
+            var slot = tile.closest('.dkjMxf') || tile.parentElement;
+            if ((slot && slot.classList && slot.classList.contains('kssMZb')) || tile.classList.contains('kssMZb') || tile.querySelector('.kssMZb, .fdKMD')) {
+              if (!muted) score += 12;
+            }
+            if (tile.querySelector('[data-is-speaking="true"],[data-active-speaker="true"],[data-speaking="true"]')) {
+              score += 10;
+            }
+
+            var els = tile.querySelectorAll('div, span');
+            for (var j = 0; j < els.length && j < 140; j++) {
+              var el = els[j];
+              if (el.classList && (el.classList.contains('BlxGDf') || el.classList.contains('gN1Xbe') || el.classList.contains('IisKdb') || el.classList.contains('aGJE1b'))) {
+                score += 5;
+              }
+              var cs = window.getComputedStyle(el);
+              var w = parseFloat(cs.outlineWidth) || 0;
+              if (w > 0 && cs.outlineStyle === 'solid' && cs.outlineColor !== 'rgba(0, 0, 0, 0)' && cs.outlineColor !== 'transparent') {
+                score += 6 + w;
+                break;
+              }
+              if (cs.transform && cs.transform !== 'none' && cs.transform.indexOf('matrix') !== -1) {
+                var m = cs.transform.match(/matrix\(([^)]+)\)/);
+                if (m) {
+                  var parts = m[1].split(',').map(Number);
+                  if (parts.length >= 4 && parts[3] > 0.28 && !muted) score += 3;
+                }
+              }
+            }
+
+            if (typeof tile.getAnimations === 'function') {
+              var anims = tile.getAnimations({ subtree: true });
+              var running = 0;
+              for (var k = 0; k < anims.length; k++) {
+                if (anims[k].playState === 'running') running++;
+              }
+              if (running >= 2 && !muted) score += 4;
+            }
+
+            if (score > bestScore) {
+              bestScore = score;
+              activePid = pid;
+            }
+          });
+
+          return JSON.stringify({
+            participants: participants,
+            activePid: activePid,
+            activeName: activePid ? (nameMap[activePid] || null) : null,
+            selfName: selfName,
+            url: window.location.href,
+            title: document.title
+          });
+        })()
+        """#
+
+        let escaped = js
+            .replacingOccurrences(of: "\\", with: "\\\\")
+            .replacingOccurrences(of: "\"", with: "\\\"")
+            .replacingOccurrences(of: "\n", with: " ")
+
+        let script = """
+        tell application "\(appName)"
+            repeat with w in windows
+                repeat with t in tabs of w
+                    if URL of t contains "meet.google.com/" then
+                        return execute t javascript "\(escaped)"
+                    end if
+                end repeat
+            end repeat
+        end tell
+        """
+
+        var errorDict: NSDictionary?
+        guard let appleScript = NSAppleScript(source: script) else { return nil }
+        let descriptor = appleScript.executeAndReturnError(&errorDict)
+        if errorDict != nil {
+            // Back off AppleScript polling for 10s when Chrome has AppleEvents JS turned off or permission is denied
+            appleScriptBackoffUntil = ProcessInfo.processInfo.systemUptime + 10.0
+            return nil
+        }
+        guard let raw = descriptor.stringValue, !raw.isEmpty,
+              let data = raw.data(using: .utf8),
+              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+            return nil
+        }
+
+        var roster: [Participant] = []
+        if let rawParticipants = json["participants"] as? [[String: Any]] {
+            var seen = Set<String>()
+            for p in rawParticipants {
+                if let id = p["id"] as? String, let name = p["name"] as? String, !seen.contains(id) {
+                    seen.insert(id)
+                    roster.append(Participant(id: id, name: name))
+                }
+            }
+        }
+
+        let activePid = json["activePid"] as? String
+        let activeName = json["activeName"] as? String
+        let selfName = json["selfName"] as? String
+        let url = json["url"] as? String
+        let title = json["title"] as? String
+
+        return ScrapeSnapshot(
+            participants: roster,
+            activeSpeakerId: activePid,
+            activeSpeakerName: activeName,
+            localUserName: selfName,
+            meetingTitle: title,
+            meetingUrl: url
+        )
+    }
+
+    // MARK: - 3. Microsoft Teams Native AX Scraper
+
+    private func detectTeamsMeeting(axApp: AXUIElement, pid: pid_t, appName: String) -> MeetingTarget? {
+        guard let windows = getAXWindows(axApp) else { return nil }
+
+        for win in windows {
+            let winTitle = getStringAttr(win, kAXTitleAttribute as String) ?? ""
+            if winTitle.isEmpty { continue }
+            let subrole = getStringAttr(win, kAXSubroleAttribute as String) ?? ""
+            if subrole == "AXDialog" || subrole == "AXSystemDialog" { continue }
+
+            let lowerTitle = winTitle.lowercased()
+            let isMainChatView = lowerTitle.hasPrefix("chat |") || lowerTitle.hasPrefix("activity |") || lowerTitle.hasPrefix("calendar |") || lowerTitle.hasPrefix("teams |")
+            if isMainChatView { continue }
+
+            // Look for Recall's `hangup-button` (`AXDOMIdentifier` or `AXIdentifier`), excluding `prejoin-join-button` and `resume-button`
+            var hasPrejoinOrResume = false
+            var hasHangupButton = false
+            walkElements(in: win, maxDepth: 20, maxNodes: 1200) { el in
+                let domId = (getStringAttr(el, "AXDOMIdentifier") ?? "").lowercased()
+                let axId = (getStringAttr(el, kAXIdentifierAttribute as String) ?? "").lowercased()
+                let desc = (getStringAttr(el, kAXDescriptionAttribute as String) ?? "").lowercased()
+                let title = (getStringAttr(el, kAXTitleAttribute as String) ?? "").lowercased()
+
+                if domId == "prejoin-join-button" || domId == "resume-button" || axId == "prejoin-join-button" || axId == "resume-button" {
+                    hasPrejoinOrResume = true
+                }
+                if domId == "hangup-button" || axId.contains("hangup-button") || axId.contains("call-hangup") ||
+                   desc == "leave" || desc == "leave call" || title == "leave" {
+                    hasHangupButton = true
+                }
+            }
+
+            if hasPrejoinOrResume { continue }
+            let looksLikeCallTitle = lowerTitle.contains("meeting") || lowerTitle.contains("call with")
+
+            if hasHangupButton || looksLikeCallTitle {
+                return MeetingTarget(
+                    pid: pid,
+                    browser: appName,
+                    platform: "teams",
+                    url: "teams://meeting/\(pid)",
+                    title: winTitle
+                )
+            }
+        }
+        return nil
+    }
+
+    private func scrapeTeams(axApp: AXUIElement) -> ScrapeSnapshot? {
+        guard let windows = getAXWindows(axApp) else { return nil }
+        var participantsById: [String: Participant] = [:]
+        var activeSpeakerName: String?
+
+        for win in windows {
+            walkElements(in: win, maxDepth: 20, maxNodes: 1500) { el in
+                let role = getStringAttr(el, kAXRoleAttribute as String) ?? ""
+                let desc = getStringAttr(el, kAXDescriptionAttribute as String) ?? ""
+                let title = getStringAttr(el, kAXTitleAttribute as String) ?? ""
+                let domClasses = getDOMClassList(el)
+
+                // 1. Recall Teams `isSpeakingSelector`: AXGroup with AXDescription containing "is speaking" (excluding "Nobody")
+                for text in [desc, title] where !text.isEmpty {
+                    let lower = text.lowercased()
+                    if !lower.hasPrefix("nobody") && (lower.contains("active speaker") || lower.contains("is speaking")) {
+                        let name = text
+                            .replacingOccurrences(of: #"(,?\s*(is speaking|active speaker|speaking|camera on|camera off|muted|unmuted|has context menu).*)"#, with: "", options: [.regularExpression, .caseInsensitive])
+                            .trimmingCharacters(in: .whitespacesAndNewlines)
+                        if isValidParticipantName(name) {
+                            activeSpeakerName = name
+                            participantsById[name] = Participant(id: name, name: name)
+                        }
+                    }
+                }
+
+                // 2. Recall Teams `participantTileSelector`: AXMenuItem or Griffel tile classes (`___1504r6c`, `___33svd6f`)
+                let isTeamsTile = (role == "AXMenuItem" && (domClasses.contains("___1504r6c") || domClasses.contains("___33svd6f"))) ||
+                    desc.lowercased().contains("has context menu")
+                if isTeamsTile {
+                    let tileText: String = {
+                        if let st = findElement(in: el, maxDepth: 6, maxNodes: 50, where: { getStringAttr($0, kAXRoleAttribute as String) == "AXStaticText" }),
+                           let val = getStringAttr(st, kAXValueAttribute as String) ?? getStringAttr(st, kAXTitleAttribute as String),
+                           !val.isEmpty {
+                            return val
+                        }
+                        return desc.isEmpty ? title : desc
+                    }()
+                    let clean = tileText
+                        .replacingOccurrences(of: #"(,?\s*(is speaking|active speaker|camera on|camera off|muted|unmuted|has context menu|your own video).*)"#, with: "", options: [.regularExpression, .caseInsensitive])
+                        .trimmingCharacters(in: .whitespacesAndNewlines)
+                    if isValidParticipantName(clean) {
+                        participantsById[clean] = Participant(id: clean, name: clean)
+                        // Check Recall's Teams speaker overlay (`vdi-frame-occlusion` + `___1vvhwqj` or `___lrjjj0w`)
+                        let hasOverlay = findElement(in: el, maxDepth: 8, maxNodes: 80) { child in
+                            let c = getDOMClassList(child)
+                            return c.contains("vdi-frame-occlusion") && (c.contains("___1vvhwqj") || c.contains("___lrjjj0w"))
+                        } != nil
+                        if hasOverlay {
+                            activeSpeakerName = clean
+                        }
+                    }
+                }
+            }
+        }
+
+        let roster = Array(participantsById.values).sorted { $0.name < $1.name }
+        if roster.isEmpty && activeSpeakerName == nil {
+            return nil
+        }
+
+        return ScrapeSnapshot(
+            participants: roster,
+            activeSpeakerId: activeSpeakerName,
+            activeSpeakerName: activeSpeakerName,
+            localUserName: nil,
+            meetingTitle: nil,
+            meetingUrl: nil
+        )
+    }
+
+    // MARK: - AX Traversal Helpers
+
+    private func getAXWindows(_ axApp: AXUIElement) -> [AXUIElement]? {
+        var val: AnyObject?
+        guard AXUIElementCopyAttributeValue(axApp, kAXWindowsAttribute as CFString, &val) == .success,
+              let windows = val as? [AXUIElement] else {
+            return nil
+        }
+        return windows
+    }
+
+    private func getAXChildren(_ el: AXUIElement) -> [AXUIElement]? {
+        var val: AnyObject?
+        if AXUIElementCopyAttributeValue(el, kAXChildrenAttribute as CFString, &val) == .success,
+           let ch = val as? [AXUIElement], !ch.isEmpty {
+            return ch
+        }
+        if AXUIElementCopyAttributeValue(el, "AXChildrenInNavigationOrder" as CFString, &val) == .success,
+           let ch = val as? [AXUIElement], !ch.isEmpty {
+            return ch
+        }
+        return nil
+    }
+
+    private func getDOMClassList(_ el: AXUIElement) -> [String] {
+        var val: AnyObject?
+        guard AXUIElementCopyAttributeValue(el, "AXDOMClassList" as CFString, &val) == .success,
+              let arr = val as? [String] else {
+            return []
+        }
+        return arr
+    }
+
+    private func getStringAttr(_ el: AXUIElement, _ attr: String) -> String? {
+        var val: AnyObject?
+        guard AXUIElementCopyAttributeValue(el, attr as CFString, &val) == .success,
+              let obj = val else { return nil }
+        if let str = obj as? String { return str }
+        if let url = obj as? NSURL { return url.absoluteString }
+        if let attrStr = obj as? NSAttributedString { return attrStr.string }
+        return nil
+    }
+
+    private func findWebArea(in root: AXUIElement, maxDepth: Int) -> AXUIElement? {
+        return findElement(in: root, maxDepth: maxDepth, maxNodes: 800) { el in
+            getStringAttr(el, kAXRoleAttribute as String) == "AXWebArea"
+        }
+    }
+
+    private func findElement(in root: AXUIElement, maxDepth: Int, maxNodes: Int = 800, where predicate: (AXUIElement) -> Bool) -> AXUIElement? {
+        var queue: [(el: AXUIElement, depth: Int)] = [(root, 0)]
+        var qIdx = 0
+        var visited = 0
+        while qIdx < queue.count && visited < maxNodes {
+            let current = queue[qIdx]
+            qIdx += 1
+            visited += 1
+            if predicate(current.el) {
+                return current.el
+            }
+            guard current.depth < maxDepth, let children = getAXChildren(current.el) else { continue }
+            for child in children {
+                queue.append((child, current.depth + 1))
+            }
+        }
+        return nil
+    }
+
+    private func findElements(in root: AXUIElement, maxDepth: Int, maxNodes: Int = 1200, where predicate: (AXUIElement) -> Bool) -> [AXUIElement] {
+        var matches: [AXUIElement] = []
+        var queue: [(el: AXUIElement, depth: Int)] = [(root, 0)]
+        var qIdx = 0
+        var visited = 0
+        while qIdx < queue.count && visited < maxNodes {
+            let current = queue[qIdx]
+            qIdx += 1
+            visited += 1
+            if predicate(current.el) {
+                matches.append(current.el)
+            }
+            guard current.depth < maxDepth, let children = getAXChildren(current.el) else { continue }
+            for child in children {
+                queue.append((child, current.depth + 1))
+            }
+        }
+        return matches
+    }
+
+    private func walkElements(in root: AXUIElement, maxDepth: Int, maxNodes: Int = 1000, visitor: (AXUIElement) -> Void) {
+        var queue: [(el: AXUIElement, depth: Int)] = [(root, 0)]
+        var qIdx = 0
+        var visited = 0
+        while qIdx < queue.count && visited < maxNodes {
+            let current = queue[qIdx]
+            qIdx += 1
+            visited += 1
+            visitor(current.el)
+            guard current.depth < maxDepth, let children = getAXChildren(current.el) else { continue }
+            for child in children {
+                queue.append((child, current.depth + 1))
+            }
+        }
+    }
+
+    private func findTabTitles(in window: AXUIElement, maxDepth: Int) -> [String] {
+        var titles: [String] = []
+        walkElements(in: window, maxDepth: maxDepth, maxNodes: 600) { el in
+            let role = getStringAttr(el, kAXRoleAttribute as String) ?? ""
+            if role == "AXTabButton" || role == "AXRadioButton" {
+                if let t = getStringAttr(el, kAXTitleAttribute as String) ?? getStringAttr(el, kAXDescriptionAttribute as String),
+                   !t.isEmpty {
+                    titles.append(t)
+                }
+            }
+        }
+        return titles
+    }
+
+    private func extractMeetCode(from text: String) -> String? {
+        let range = NSRange(text.startIndex..<text.endIndex, in: text)
+        if let match = meetCodeRegex.firstMatch(in: text, options: [], range: range),
+           let codeRange = Range(match.range(at: 1), in: text) {
+            return String(text[codeRange]).lowercased()
+        }
+        // Also check `Meet - abc-defg-hij` in window/tab titles
+        let titlePattern = #"Meet\s*[-–]\s*([a-z]{3}-[a-z]{4}-[a-z]{3})"#
+        if let regex = try? NSRegularExpression(pattern: titlePattern, options: [.caseInsensitive]),
+           let match = regex.firstMatch(in: text, options: [], range: range),
+           let codeRange = Range(match.range(at: 1), in: text) {
+            return String(text[codeRange]).lowercased()
+        }
+        return nil
+    }
+
+    public func normalizeBrowserName(bundleId: String, appName: String) -> String {
+        switch bundleId {
+        case "com.google.Chrome": return "chrome"
+        case "company.thebrowser.Browser": return "arc"
+        case "com.brave.Browser": return "brave"
+        case "com.microsoft.edgemac": return "edge"
+        case "com.vivaldi.Vivaldi": return "vivaldi"
+        case "com.apple.Safari": return "safari"
+        default: return appName.lowercased()
+        }
+    }
+
+    private func isValidParticipantName(_ name: String) -> Bool {
+        let trimmed = name.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard trimmed.count >= 2 && trimmed.count <= 60 else { return false }
+        let lower = trimmed.lowercased()
+        let blacklist: Set<String> = [
+            "you", "nobody", "mute", "unmute", "pin", "unpin", "more options",
+            "your microphone is off.", "your microphone is on.",
+            "turn off microphone", "turn on microphone",
+            "turn off camera", "turn on camera", "leave call",
+            "google meet", "zoom meeting", "microsoft teams",
+            "reframe", "backgrounds and effects", "visual_effects", "mic_off",
+            "raise hand", "share screen", "present now", "call controls"
+        ]
+        return !blacklist.contains(lower)
+    }
+}