@leg3ndy/otto-bridge 0.5.8 → 0.5.12

package/dist/executors/native_macos.js

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import process from "node:process";
 import { JobCancelledError } from "./shared.js";
+import { loadManagedBridgeExtensionState, saveManagedBridgeExtensionState, } from "../extensions.js";
 import { postDeviceJson, uploadDeviceJobArtifact } from "../http.js";
 const KNOWN_APPS = [
     { canonical: "Safari", patterns: [/\bsafari\b/i] },
@@ -30,6 +31,8 @@ const KNOWN_SITES = [
     { label: "WhatsApp Web", url: "https://web.whatsapp.com", patterns: [/\bwhatsapp\b/i] },
     { label: "X", url: "https://x.com", patterns: [/\bx\.com\b/i, /\btwitter\b/i, /\bxis\b/i] },
 ];
+const WHATSAPP_WEB_EXTENSION_SLUG = "whatsappweb";
+const WHATSAPP_WEB_URL = "https://web.whatsapp.com";
 const GENERIC_VISUAL_STOP_WORDS = new Set([
     "o",
     "a",
@@ -129,6 +132,102 @@ function extractMeaningfulDescriptionTokens(value) {
         .map((token) => token.trim())
         .filter((token) => token.length >= 3 && !GENERIC_VISUAL_STOP_WORDS.has(token))));
 }
+const MEDIA_QUERY_STOP_WORDS = new Set([
+    "youtube",
+    "music",
+    "spotify",
+    "apple",
+    "player",
+    "play",
+    "pause",
+    "pausa",
+    "pausar",
+    "tocar",
+    "toque",
+    "reproduzir",
+    "reproducao",
+    "retomar",
+    "retoma",
+    "continuar",
+    "continue",
+    "resumir",
+    "resume",
+    "next",
+    "skip",
+    "proxima",
+    "proximo",
+    "anterior",
+    "previous",
+    "voltar",
+    "volta",
+    "melhor",
+    "tocavel",
+    "relacionado",
+    "diretamente",
+    "navegador",
+    "fila",
+    "playerbar",
+]);
+function extractMediaQueryTokens(value) {
+    return extractMeaningfulDescriptionTokens(value).filter((token) => !MEDIA_QUERY_STOP_WORDS.has(token));
+}
+function countMatchingTokens(text, tokens) {
+    const normalizedText = normalizeText(text || "");
+    if (!normalizedText || !tokens.length) {
+        return 0;
+    }
+    return tokens.reduce((total, token) => total + (normalizedText.includes(token) ? 1 : 0), 0);
+}
+function typedTextLooksApplied(actual, expected) {
+    const normalizedActual = normalizeText(actual || "").replace(/\s+/g, " ").trim();
+    const normalizedExpected = normalizeText(expected || "").replace(/\s+/g, " ").trim();
+    if (!normalizedActual || !normalizedExpected) {
+        return false;
+    }
+    if (normalizedActual === normalizedExpected
+        || normalizedActual.includes(normalizedExpected)
+        || normalizedExpected.includes(normalizedActual)) {
+        return true;
+    }
+    const expectedTokens = normalizedExpected.split(/[^a-z0-9]+/).filter((token) => token.length >= 3);
+    if (!expectedTokens.length) {
+        return false;
+    }
+    const matches = expectedTokens.filter((token) => normalizedActual.includes(token)).length;
+    return matches >= Math.max(2, Math.ceil(expectedTokens.length * 0.6));
+}
+function descriptionWantsNext(description) {
+    return /\b(proxim[ao]?|next|skip|pular|avanca|avanç[ae])\b/.test(normalizeText(description || ""));
+}
+function descriptionWantsPrevious(description) {
+    return /\b(anterior|previous|volta[ar]?|back|retorna[ar]?)\b/.test(normalizeText(description || ""));
+}
+function descriptionWantsPause(description) {
+    return /\b(pausa|pause|pausar)\b/.test(normalizeText(description || ""));
+}
+function descriptionWantsResume(description) {
+    return /\b(retoma|retomar|resume|continu[ae]r|despausa|play)\b/.test(normalizeText(description || ""));
+}
+function extractNativeMediaTransportCommand(description) {
+    const normalizedDescription = normalizeText(description || "");
+    if (!normalizedDescription
+        || /\b(resultado|tocavel|relacionado|faixa|search|busca|pesquisa)\b/.test(normalizedDescription)) {
+        return null;
+    }
+    if (!/\b(player|controle|fila|music|spotify|youtube|deezer|apple)\b/.test(normalizedDescription)) {
+        return null;
+    }
+    if (descriptionWantsNext(description)) {
+        return "next";
+    }
+    if (descriptionWantsPrevious(description)) {
+        return "previous";
+    }
+    if (descriptionWantsPause(description) || descriptionWantsResume(description)) {
+        return "play_pause";
+    }
+    return null;
+}
 function descriptionLikelyHasTextAnchor(description) {
     return extractQuotedPhrases(description).length > 0 || extractMeaningfulDescriptionTokens(description).length > 0;
 }
@@ -832,6 +931,8 @@ export class NativeMacOSJobExecutor {
     cancelledJobs = new Set();
     activeChild = null;
     lastActiveApp = null;
+    lastVisualTargetDescription = null;
+    lastVisualTargetApp = null;
     constructor(bridgeConfig) {
         this.bridgeConfig = bridgeConfig;
     }
@@ -882,6 +983,17 @@ export class NativeMacOSJobExecutor {
                 if (action.type === "press_shortcut") {
                     await reporter.progress(progressPercent, `Enviando atalho ${action.shortcut}`);
                     await this.pressShortcut(action.shortcut);
+                    if (action.shortcut.startsWith("media_")) {
+                        const mediaSummaryMap = {
+                            media_next: "Acionei o comando de próxima mídia no macOS.",
+                            media_previous: "Acionei o comando de mídia anterior no macOS.",
+                            media_pause: "Acionei o comando de pausar mídia no macOS.",
+                            media_resume: "Acionei o comando de retomar mídia no macOS.",
+                            media_play: "Acionei o comando de reproduzir mídia no macOS.",
+                            media_play_pause: "Acionei o comando de play/pause de mídia no macOS.",
+                        };
+                        completionNotes.push(mediaSummaryMap[action.shortcut] || `Acionei ${action.shortcut} no macOS.`);
+                    }
                     continue;
                 }
                 if (action.type === "create_note") {
@@ -891,8 +1003,24 @@ export class NativeMacOSJobExecutor {
                     continue;
                 }
                 if (action.type === "type_text") {
-                    await reporter.progress(progressPercent, "Digitando texto no app ativo");
-                    await this.typeText(action.text);
+                    const typingApp = this.lastActiveApp || await this.getFrontmostAppName();
+                    await reporter.progress(progressPercent, `Digitando texto em ${typingApp || "app ativo"}`);
+                    const typed = await this.guidedTypeText(action.text, typingApp || undefined);
+                    if (!typed.ok) {
+                        throw new Error(typed.reason || "Nao consegui digitar o texto no app ativo.");
+                    }
+                    resultPayload.last_typed = {
+                        strategy: typed.strategy,
+                        verified: typed.verified,
+                        app: typed.app,
+                        attempts: typed.attempts,
+                        text_preview: clipText(action.text, 180),
+                    };
+                    this.lastVisualTargetDescription = null;
+                    this.lastVisualTargetApp = null;
+                    completionNotes.push(typed.verified
+                        ? `Digitei e confirmei o texto no ${typed.app || "app ativo"}.`
+                        : `Digitei o texto no ${typed.app || "app ativo"}.`);
                     continue;
                 }
                 if (action.type === "take_screenshot") {
@@ -1009,17 +1137,13 @@ export class NativeMacOSJobExecutor {
                 }
                 if (action.type === "whatsapp_send_message") {
                     await reporter.progress(progressPercent, `Abrindo a conversa do WhatsApp com ${action.contact}`);
-                    await this.focusApp("Safari");
                     await this.ensureWhatsAppWebReady();
                     const selected = await this.selectWhatsAppConversation(action.contact);
                     if (!selected) {
                         throw new Error(`Nao consegui localizar a conversa do WhatsApp com ${action.contact}.`);
                     }
-                    await reporter.progress(progressPercent, `Digitando a mensagem para ${action.contact} no WhatsApp`);
-                    await this.focusWhatsAppComposer();
-                    await this.typeText(action.text);
-                    await delay(250);
-                    await this.pressShortcut("return");
+                    await reporter.progress(progressPercent, `Enviando a mensagem para ${action.contact} no WhatsApp`);
+                    await this.sendWhatsAppMessage(action.text);
                     await delay(900);
                     const verification = await this.verifyWhatsAppLastMessage(action.text);
                     if (!verification.ok) {
@@ -1035,7 +1159,6 @@ export class NativeMacOSJobExecutor {
                 }
                 if (action.type === "whatsapp_read_chat") {
                     await reporter.progress(progressPercent, `Abrindo a conversa do WhatsApp com ${action.contact}`);
-                    await this.focusApp("Safari");
                     await this.ensureWhatsAppWebReady();
                     const selected = await this.selectWhatsAppConversation(action.contact);
                     if (!selected) {
@@ -1069,6 +1192,42 @@ export class NativeMacOSJobExecutor {
                         const initialBrowserState = browserApp
                             ? await this.captureBrowserPageState(browserApp).catch(() => null)
                             : null;
+                        const nativeMediaTransport = extractNativeMediaTransportCommand(targetDescription);
+                        if (nativeMediaTransport) {
+                            await reporter.progress(progressPercent, `Tentando controle de mídia nativo do macOS para ${targetDescription}`);
+                            try {
+                                await this.triggerMacOSMediaTransport(nativeMediaTransport);
+                                let validated = false;
+                                let validationReason = "";
+                                if (action.verification_prompt) {
+                                    const verification = await this.validateVisualClickWithVision(job.job_id, targetDescription, action.verification_prompt, progressPercent, reporter, artifacts, "native_media_transport_result");
+                                    validated = verification.ok;
+                                    validationReason = verification.reason;
+                                }
+                                else if (browserApp) {
+                                    const browserValidation = await this.confirmBrowserClick(browserApp, initialBrowserState, targetDescription, null);
+                                    validated = browserValidation.ok;
+                                    validationReason = browserValidation.reason;
+                                }
+                                else {
+                                    validated = true;
+                                }
+                                if (validated) {
+                                    resultPayload.last_click = {
+                                        strategy: "native_media_transport",
+                                        matched_text: targetDescription,
+                                    };
+                                    completionNotes.push(`Acionei ${targetDescription} usando o controle de mídia nativo do macOS.`);
+                                    clickSucceeded = true;
+                                    break;
+                                }
+                                lastFailureReason = validationReason || `O controle de mídia nativo do macOS nao confirmou ${targetDescription}.`;
+                                await reporter.progress(progressPercent, "O controle de mídia nativo nao foi suficiente; vou tentar DOM/OCR");
+                            }
+                            catch (error) {
+                                lastFailureReason = error instanceof Error ? error.message : String(error);
+                            }
+                        }
                         if (browserApp === "Safari") {
                             await reporter.progress(progressPercent, `Tentando localizar ${targetDescription} diretamente no Safari`);
                             const domClick = await this.trySafariDomClick(targetDescription);
@@ -1086,6 +1245,8 @@ export class NativeMacOSJobExecutor {
                                     validationReason = browserValidation.reason;
                                 }
                                 if (validated) {
+                                    this.lastVisualTargetDescription = targetDescription;
+                                    this.lastVisualTargetApp = browserApp || action.app || this.lastActiveApp;
                                     resultPayload.last_click = {
                                         strategy: domClick.strategy || "safari_dom",
                                         matched_text: domClick.matchedText || null,
@@ -1127,6 +1288,8 @@ export class NativeMacOSJobExecutor {
                             }
                             if (validated) {
                                 const region = ocrClick.region || null;
+                                this.lastVisualTargetDescription = targetDescription;
+                                this.lastVisualTargetApp = browserApp || action.app || this.lastActiveApp;
                                 resultPayload.last_click = {
                                     strategy: ocrClick.strategy || "local_ocr",
                                     score: ocrClick.score || null,
@@ -1202,6 +1365,8 @@ export class NativeMacOSJobExecutor {
                             }
                         }
                         completionNotes.push(`Localizei e cliquei em ${targetDescription}.`);
+                        this.lastVisualTargetDescription = targetDescription;
+                        this.lastVisualTargetApp = browserApp || action.app || this.lastActiveApp;
                         clickSucceeded = true;
                         break;
                     }
@@ -1387,7 +1552,26 @@ end tell
         const beforePlayerState = normalizeText(before?.playerState || "");
         const afterPlayerState = normalizeText(after.playerState || "");
         const playerLooksActive = afterPlayerState.includes("pause") || afterPlayerState.includes("pausar");
+        const playerLooksPaused = !playerLooksActive && /play|tocar|reproduzir|continuar|retomar|resume/.test(afterPlayerState);
+        const wantsNext = descriptionWantsNext(targetDescription);
+        const wantsPrevious = descriptionWantsPrevious(targetDescription);
+        const wantsPause = descriptionWantsPause(targetDescription);
+        const wantsResume = descriptionWantsResume(targetDescription);
+        const mediaQueryTokens = extractMediaQueryTokens(targetDescription);
+        const mediaMatchCount = countMatchingTokens(after.playerTitle || "", mediaQueryTokens);
         if (afterUrl.includes("music.youtube.com")) {
+            if (wantsPause && beforePlayerState && beforePlayerState !== afterPlayerState && playerLooksPaused) {
+                return true;
+            }
+            if (wantsResume && playerLooksActive && beforePlayerState !== afterPlayerState) {
+                return true;
+            }
+            if ((wantsNext || wantsPrevious) && beforePlayerTitle && afterPlayerTitle && beforePlayerTitle !== afterPlayerTitle) {
+                return true;
+            }
+            if (mediaQueryTokens.length >= 2 && mediaMatchCount >= Math.max(2, Math.ceil(mediaQueryTokens.length * 0.5)) && playerLooksActive) {
+                return true;
+            }
             if (beforePlayerState && afterPlayerState && beforePlayerState !== afterPlayerState && playerLooksActive) {
                 return true;
             }
@@ -1440,6 +1624,23 @@ end tell
         if (!key) {
             throw new Error(`Invalid shortcut: ${shortcut}`);
         }
+        const normalizedShortcut = normalizeText(shortcut).replace(/[\s+-]+/g, "_");
+        const mediaCommandMap = {
+            media_play: "play_pause",
+            media_pause: "play_pause",
+            media_play_pause: "play_pause",
+            media_resume: "play_pause",
+            media_next: "next",
+            media_proxima: "next",
+            media_previous: "previous",
+            media_prev: "previous",
+            media_anterior: "previous",
+        };
+        const mediaCommand = mediaCommandMap[normalizedShortcut];
+        if (mediaCommand) {
+            await this.triggerMacOSMediaTransport(mediaCommand);
+            return;
+        }
         const namedKeyCodes = {
             return: 36,
             enter: 36,
@@ -1465,6 +1666,45 @@ end tell
             `tell application "System Events" to keystroke "${escapeAppleScript(key)}"${usingClause}`,
         ]);
     }
+    async triggerMacOSMediaTransport(command) {
+        const keyTypeMap = {
+            play_pause: 16,
+            next: 17,
+            previous: 18,
+        };
+        const keyType = keyTypeMap[command];
+        const swiftScript = `
+import AppKit
+import Foundation
+
+let keyType = ${keyType}
+
+func postMediaKey(_ keyType: Int32, down: Bool) {
+  let eventFlags = NSEvent.ModifierFlags(rawValue: 0xA00)
+  let state = down ? 0xA : 0xB
+  let data1 = Int((keyType << 16) | (Int32(state) << 8))
+  guard let event = NSEvent.otherEvent(
+    with: .systemDefined,
+    location: .zero,
+    modifierFlags: eventFlags,
+    timestamp: 0,
+    windowNumber: 0,
+    context: nil,
+    subtype: 8,
+    data1: data1,
+    data2: -1
+  ) else {
+    return
+  }
+  event.cgEvent?.post(tap: .cghidEventTap)
+}
+
+postMediaKey(Int32(keyType), down: true)
+usleep(90000)
+postMediaKey(Int32(keyType), down: false)
+`;
+        await this.runCommand("swift", ["-e", swiftScript]);
+    }
     async typeText(text) {
         const previousClipboard = await this.readClipboardText();
         try {
@@ -1477,6 +1717,227 @@ end tell
             }
         }
     }
+    resolveLikelySearchShortcut(app) {
+        const normalizedHint = normalizeText(this.lastVisualTargetDescription || "");
+        const looksLikeSearchTarget = /\b(busca|pesquisa|search|campo|caixa|icone|ícone)\b/.test(normalizedHint);
+        if (!looksLikeSearchTarget || !app) {
+            return null;
+        }
+        if (app === "Spotify") {
+            return "cmd+l";
+        }
+        if (app === "Music") {
+            return "cmd+f";
+        }
+        return null;
+    }
+    async guidedTypeText(text, preferredApp) {
+        const app = preferredApp || this.lastActiveApp || await this.getFrontmostAppName();
+        if (app === "Safari") {
+            const safariResult = await this.trySafariGuidedType(text);
+            if (safariResult.ok) {
+                return {
+                    ...safariResult,
+                    app,
+                };
+            }
+        }
+        const searchShortcut = this.resolveLikelySearchShortcut(app);
+        if (searchShortcut) {
+            await this.pressShortcut(searchShortcut).catch(() => undefined);
+            await delay(180);
+        }
+        await this.typeText(text);
+        return {
+            ok: true,
+            verified: false,
+            strategy: searchShortcut ? `clipboard_paste_after_${searchShortcut}` : "clipboard_paste",
+            app: app || null,
+            attempts: 1,
+        };
+    }
+    async trySafariGuidedType(text) {
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            try {
+                const result = await this.runSafariJsonScript(`
+const inputText = String(__input?.text || "");
+function isVisible(element) {
+  if (!(element instanceof HTMLElement)) return false;
+  const rect = element.getBoundingClientRect();
+  if (rect.width < 4 || rect.height < 4) return false;
+  const style = window.getComputedStyle(element);
+  if (style.visibility === "hidden" || style.display === "none" || Number(style.opacity || "1") === 0) return false;
+  return rect.bottom >= 0 && rect.right >= 0 && rect.top <= window.innerHeight && rect.left <= window.innerWidth;
+}
+function isEditable(element) {
+  return element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || (element instanceof HTMLElement && element.isContentEditable);
+}
+function readEditableValue(element) {
+  if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+    return String(element.value || "").trim();
+  }
+  if (element instanceof HTMLElement && element.isContentEditable) {
+    return String(element.innerText || element.textContent || "").trim();
+  }
+  return "";
+}
+function clearAndFill(element, value) {
+  if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+    element.focus();
+    element.select?.();
+    element.value = "";
+    element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "deleteContentBackward", data: null }));
+    element.value = value;
+    element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: value }));
+    element.dispatchEvent(new Event("change", { bubbles: true }));
+    return;
+  }
+  if (element instanceof HTMLElement && element.isContentEditable) {
+    element.focus();
+    const selection = window.getSelection();
+    const range = document.createRange();
+    range.selectNodeContents(element);
+    selection?.removeAllRanges();
+    selection?.addRange(range);
+    document.execCommand("selectAll", false);
+    document.execCommand("delete", false);
+    document.execCommand("insertText", false, value);
+    element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: value }));
+  }
+}
+const selectors = location.hostname.includes("music.youtube.com")
+  ? [
+      "ytmusic-search-box input#input",
+      "ytmusic-search-box input",
+      "input[placeholder*='Search']",
+      "input[placeholder*='Pesquisar']",
+      "[role='searchbox'] input"
+    ]
+  : location.hostname.includes("open.spotify.com")
+  ? [
+      "input[data-testid='search-input']",
+      "[role='searchbox'] input",
+      "input[placeholder*='Search']"
+    ]
+  : location.hostname.includes("deezer.com")
+  ? [
+      "input[type='search']",
+      "input[placeholder*='Search']",
+      "input[placeholder*='Pesquisar']",
+      "form input[type='text']"
+    ]
+  : location.hostname.includes("soundcloud.com")
+  ? [
+      "input[type='search']",
+      "input[placeholder*='Search']",
+      "form input[type='search']",
+      "form input[type='text']"
+    ]
+  : location.hostname.includes("music.amazon.com")
+  ? [
+      "input[type='search']",
+      "input[aria-label*='Search']",
+      "input[placeholder*='Search']",
+      "[role='searchbox'] input"
+    ]
+  : [
+      "textarea",
+      "input[type='search']",
+      "input[type='text']",
+      "input:not([type])",
+      "[contenteditable='true'][role='textbox']",
+      "[contenteditable='true']"
+    ];
+const active = document.activeElement;
+let target = null;
+if (active instanceof HTMLElement && isVisible(active) && isEditable(active)) {
+  target = active;
+}
+if (!target) {
+  const candidates = selectors
+    .flatMap((selector) => Array.from(document.querySelectorAll(selector)))
+    .filter((node) => node instanceof HTMLElement)
+    .filter((node) => isVisible(node))
+    .map((node, index) => {
+      const label = String(
+        node.getAttribute("aria-label")
+        || node.getAttribute("placeholder")
+        || node.getAttribute("title")
+        || node.textContent
+        || ""
+      ).toLowerCase();
+      let score = 0;
+      if (label.includes("search") || label.includes("pesquis")) score += 80;
+      if (node === document.activeElement) score += 30;
+      score += Math.max(0, 12 - index);
+      return { node, score };
+    })
+    .sort((left, right) => right.score - left.score);
+  target = candidates[0]?.node || null;
+}
+if (!(target instanceof HTMLElement) || !isEditable(target)) {
+  return { ok: false, reason: "Nao achei um campo editavel confiavel no Safari.", strategy: "safari_guided_type_no_field" };
+}
+target.scrollIntoView({ block: "center", inline: "center", behavior: "auto" });
+clearAndFill(target, inputText);
+return {
+  ok: true,
+  actualText: readEditableValue(target),
+  strategy: target === active ? "safari_guided_type_active_field" : "safari_guided_type_search_field",
+};
+          `, { text });
+                if (result?.ok && typedTextLooksApplied(result.actualText || "", text)) {
+                    return {
+                        ok: true,
+                        verified: true,
+                        strategy: result.strategy || "safari_guided_type",
+                        attempts: attempt + 1,
+                    };
+                }
+                await delay(180);
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                if (detail.toLowerCase().includes("allow javascript from apple events")) {
+                    break;
+                }
+            }
+        }
+        await this.typeText(text);
+        await delay(180);
+        try {
+            const verification = await this.runSafariJsonScript(`
+function readEditableValue(element) {
+  if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+    return String(element.value || "").trim();
+  }
+  if (element instanceof HTMLElement && element.isContentEditable) {
+    return String(element.innerText || element.textContent || "").trim();
+  }
+  return "";
+}
+const active = document.activeElement;
+return { actualText: active ? readEditableValue(active) : "" };
+        `, {});
+            if (typedTextLooksApplied(verification.actualText || "", text)) {
+                return {
+                    ok: true,
+                    verified: true,
+                    strategy: "safari_clipboard_retry",
+                    attempts: 4,
+                };
+            }
+        }
+        catch {
+            // ignore and fall back to unverified success below
+        }
+        return {
+            ok: true,
+            verified: false,
+            strategy: "clipboard_paste",
+            attempts: 1,
+        };
+    }
     async scrollView(direction, amount = "medium", steps = 1) {
         const clampedSteps = Math.max(1, Math.min(Math.round(steps || 1), 6));
         const lineDelta = {
@@ -1526,11 +1987,114 @@ end repeat
 `;
         await this.runCommand("osascript", ["-e", script]);
     }
+    hasInstalledBridgeExtension(slug) {
+        return Array.isArray(this.bridgeConfig?.installedExtensions)
+            ? this.bridgeConfig?.installedExtensions.includes(slug)
+            : false;
+    }
+    getWhatsAppWebScriptOptions(activate = false) {
+        return {
+            targetUrlIncludes: "web.whatsapp.com",
+            activate,
+        };
+    }
+    async syncWhatsAppExtensionState(status, notes) {
+        const current = await loadManagedBridgeExtensionState(WHATSAPP_WEB_EXTENSION_SLUG).catch(() => null);
+        if (!current) {
+            return;
+        }
+        await saveManagedBridgeExtensionState(WHATSAPP_WEB_EXTENSION_SLUG, {
+            ...current,
+            status,
+            notes,
+            lastStatusCheckAt: new Date().toISOString(),
+        }).catch(() => undefined);
+    }
+    async readWhatsAppWebSessionState() {
+        return this.runSafariJsonScript(`
+function isVisible(element) {
+  if (!(element instanceof HTMLElement)) return false;
+  const rect = element.getBoundingClientRect();
+  if (rect.width < 4 || rect.height < 4) return false;
+  const style = window.getComputedStyle(element);
+  if (style.visibility === "hidden" || style.display === "none" || Number(style.opacity || "1") === 0) return false;
+  return rect.bottom >= 0 && rect.right >= 0 && rect.top <= window.innerHeight && rect.left <= window.innerWidth;
+}
+
+return {
+  title: document.title || "",
+  url: location.href || "",
+  qrVisible: Array.from(document.querySelectorAll('[data-testid="qrcode"], canvas[aria-label*="Scan"], canvas[aria-label*="scan"], div[data-ref] canvas'))
+    .some((node) => node instanceof HTMLElement ? isVisible(node) : true),
+  paneVisible: Array.from(document.querySelectorAll('#pane-side, [data-testid="chat-list"]'))
+    .some((node) => node instanceof HTMLElement && isVisible(node)),
+  searchVisible: Array.from(document.querySelectorAll('[data-testid="chat-list-search"] [contenteditable="true"], div[contenteditable="true"][role="textbox"]'))
+    .some((node) => node instanceof HTMLElement && isVisible(node)),
+  composerVisible: Array.from(document.querySelectorAll('footer [contenteditable="true"], [data-testid="conversation-compose-box-input"]'))
+    .some((node) => node instanceof HTMLElement && isVisible(node)),
+};
+      `, {}, this.getWhatsAppWebScriptOptions(false)).then((result) => ({
+            title: asString(result.title) || "",
+            url: asString(result.url) || "",
+            qrVisible: result.qrVisible === true,
+            paneVisible: result.paneVisible === true,
+            searchVisible: result.searchVisible === true,
+            composerVisible: result.composerVisible === true,
+        }));
+    }
     async ensureWhatsAppWebReady() {
-        const page = await this.readFrontmostPage("Safari");
-        if (!normalizeComparableUrl(page.url || "").includes("web.whatsapp.com")) {
-            throw new Error("O Safari nao esta aberto no WhatsApp Web.");
+        if (!this.hasInstalledBridgeExtension(WHATSAPP_WEB_EXTENSION_SLUG)) {
+            throw new Error("WhatsApp Web nao esta instalado neste Otto Bridge. Rode `otto-bridge extensions --install whatsappweb` e depois `otto-bridge extensions --setup whatsappweb`.");
+        }
+        const currentState = await loadManagedBridgeExtensionState(WHATSAPP_WEB_EXTENSION_SLUG).catch(() => null);
+        if (!currentState || currentState.status === "installed_needs_setup") {
+            throw new Error("WhatsApp Web ainda nao foi configurado neste Otto Bridge. Rode `otto-bridge extensions --setup whatsappweb` para abrir o QR code.");
+        }
+        let sessionState = null;
+        try {
+            sessionState = await this.readWhatsAppWebSessionState();
         }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            if (detail.toLowerCase().includes("aba correspondente")) {
+                await this.openUrl(WHATSAPP_WEB_URL, "Safari");
+                await delay(1400);
+                try {
+                    sessionState = await this.readWhatsAppWebSessionState();
+                }
+                catch {
+                    sessionState = null;
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+        if (!sessionState) {
+            const disconnectedStatus = currentState.status === "connected" || currentState.status === "session_expired"
+                ? "session_expired"
+                : "not_open";
+            await this.syncWhatsAppExtensionState(disconnectedStatus, disconnectedStatus === "session_expired"
+                ? "A sessao do WhatsApp Web expirou ou foi fechada. Rode `otto-bridge extensions --setup whatsappweb` para abrir o login novamente."
+                : "Nao consegui localizar uma aba do WhatsApp Web no Safari.");
+            throw new Error("Nao consegui localizar uma aba do WhatsApp Web no Safari. Rode `otto-bridge extensions --setup whatsappweb` se precisar reabrir a sessao.");
+        }
+        const loggedIn = sessionState.paneVisible || sessionState.searchVisible || sessionState.composerVisible;
+        if (!loggedIn) {
+            const disconnectedStatus = currentState.status === "connected" || currentState.status === "session_expired"
+                ? "session_expired"
+                : "waiting_login";
+            await this.syncWhatsAppExtensionState(disconnectedStatus, disconnectedStatus === "session_expired"
+                ? "A sessao do WhatsApp Web expirou. Rode `otto-bridge extensions --setup whatsappweb` para abrir o QR code novamente."
+                : sessionState.qrVisible
+                    ? "QR code visivel. Escaneie com o celular para concluir o login."
+                    : "Sessao do WhatsApp Web aberta, mas ainda sem chat disponivel.");
+            if (disconnectedStatus === "session_expired") {
+                throw new Error("A sessao do WhatsApp Web expirou nesta maquina. Rode `otto-bridge extensions --setup whatsappweb` para fazer login de novo e depois `otto-bridge extensions --status whatsappweb`.");
+            }
+            throw new Error("WhatsApp Web ainda nao esta conectado nesta maquina. Rode `otto-bridge extensions --setup whatsappweb`, escaneie o QR code e depois `otto-bridge extensions --status whatsappweb`.");
+        }
+        await this.syncWhatsAppExtensionState("connected", "Sessao local do WhatsApp Web pronta para uso.");
     }
     async selectWhatsAppConversation(contact) {
         const prepared = await this.runSafariJsonScript(`
@@ -1582,7 +2146,7 @@ if (!candidates.length) {
 
 focusAndReplaceContent(candidates[0].element, query);
 return { ok: true };
-      `, { contact });
+      `, { contact }, this.getWhatsAppWebScriptOptions(false));
         if (!prepared?.ok) {
             return false;
         }
@@ -1631,11 +2195,12 @@ if (typeof target.click === "function") {
   target.click();
 }
 return { clicked: true };
-      `, { contact });
+      `, { contact }, this.getWhatsAppWebScriptOptions(false));
         return Boolean(result?.clicked);
     }
-    async focusWhatsAppComposer() {
+    async sendWhatsAppMessage(text) {
         const result = await this.runSafariJsonScript(`
+const value = String(__input?.text || "");
 function isVisible(element) {
   if (!(element instanceof HTMLElement)) return false;
   const rect = element.getBoundingClientRect();
@@ -1645,22 +2210,66 @@ function isVisible(element) {
   return rect.bottom >= 0 && rect.right >= 0 && rect.top <= window.innerHeight && rect.left <= window.innerWidth;
 }
 
-const candidates = Array.from(document.querySelectorAll('footer div[contenteditable="true"], [data-testid="conversation-compose-box-input"], main footer [contenteditable="true"]'))
+function clearAndFillComposer(element, nextValue) {
+  element.focus();
+  if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
+    element.value = "";
+    element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "deleteContentBackward", data: null }));
+    element.value = nextValue;
+    element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: nextValue }));
+    return;
+  }
+  const selection = window.getSelection();
+  const range = document.createRange();
+  range.selectNodeContents(element);
+  selection?.removeAllRanges();
+  selection?.addRange(range);
+  document.execCommand("selectAll", false);
+  document.execCommand("delete", false);
+  document.execCommand("insertText", false, nextValue);
+  if ((element.innerText || "").trim() !== nextValue.trim()) {
+    element.textContent = nextValue;
+  }
+  element.dispatchEvent(new InputEvent("input", { bubbles: true, inputType: "insertText", data: nextValue }));
+}
+
+const candidates = Array.from(document.querySelectorAll('footer div[contenteditable="true"], [data-testid="conversation-compose-box-input"], main footer [contenteditable="true"], footer textarea'))
   .filter((node) => node instanceof HTMLElement)
   .filter((node) => isVisible(node))
   .sort((left, right) => right.getBoundingClientRect().top - left.getBoundingClientRect().top);
 
 if (!candidates.length) {
-  return { focused: false, reason: "Nao achei o campo de mensagem do WhatsApp Web." };
+  return { sent: false, reason: "Nao achei o campo de mensagem do WhatsApp Web." };
 }
 
 const composer = candidates[0];
-composer.focus();
+clearAndFillComposer(composer, value);
 composer.click();
-return { focused: true };
-      `);
-        if (!result?.focused) {
-            throw new Error(result?.reason || "Nao consegui focar o campo de mensagem do WhatsApp Web.");
+
+const sendCandidates = Array.from(document.querySelectorAll('[data-testid="compose-btn-send"], button[aria-label*="Send"], button[aria-label*="Enviar"], span[data-icon="send"], div[role="button"][aria-label*="Send"], div[role="button"][aria-label*="Enviar"]'))
+  .map((node) => node instanceof HTMLElement ? (node.closest('button, div[role="button"]') || node) : null)
+  .filter((node) => node instanceof HTMLElement)
+  .filter((node) => isVisible(node));
+
+const sendButton = sendCandidates[0];
+if (sendButton instanceof HTMLElement) {
+  sendButton.scrollIntoView({ block: "center", inline: "center", behavior: "auto" });
+  sendButton.dispatchEvent(new MouseEvent("mousedown", { bubbles: true, cancelable: true, view: window }));
+  sendButton.dispatchEvent(new MouseEvent("mouseup", { bubbles: true, cancelable: true, view: window }));
+  sendButton.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true, view: window }));
+  if (typeof sendButton.click === "function") {
+    sendButton.click();
+  }
+  return { sent: true };
+}
+
+composer.dispatchEvent(new KeyboardEvent("keydown", { key: "Enter", code: "Enter", keyCode: 13, which: 13, bubbles: true }));
+composer.dispatchEvent(new KeyboardEvent("keypress", { key: "Enter", code: "Enter", keyCode: 13, which: 13, bubbles: true }));
+composer.dispatchEvent(new KeyboardEvent("keyup", { key: "Enter", code: "Enter", keyCode: 13, which: 13, bubbles: true }));
+return { sent: true };
+      `, { text }, this.getWhatsAppWebScriptOptions(false));
+        if (!result?.sent) {
+            throw new Error(result?.reason || "Nao consegui enviar a mensagem no WhatsApp Web.");
         }
     }
     async readWhatsAppVisibleConversation(contact, limit) {
@@ -1690,7 +2299,7 @@ const messages = containers.map((node) => {
 }).filter((item) => item.text);
 
 return { messages: messages.slice(-maxMessages) };
-      `, { contact, limit });
+      `, { contact, limit }, this.getWhatsAppWebScriptOptions(false));
         const messages = Array.isArray(result?.messages)
             ? result.messages
                 .map((item) => ({
@@ -1804,7 +2413,7 @@ return { messages: messages.slice(-maxMessages) };
             reason: verificationAnswer,
         };
     }
-    async runSafariJsonScript(scriptBody, input) {
+    async runSafariJsonScript(scriptBody, input, options) {
         const wrappedScript = `
 (function(){
   const __input = ${JSON.stringify(input || null)};
@@ -1821,12 +2430,42 @@ ${scriptBody}
   }
 })()
 `;
+        const targetUrlIncludes = String(options?.targetUrlIncludes || "").trim();
+        const shouldActivate = options?.activate !== false;
         const script = `
+set targetUrlIncludes to "${escapeAppleScript(targetUrlIncludes)}"
+set shouldActivate to ${shouldActivate ? "true" : "false"}
 tell application "Safari"
-  activate
   if (count of windows) = 0 then error "Safari nao possui janelas abertas."
+  if shouldActivate then activate
+  set targetWindow to missing value
+  set targetTab to missing value
+  if targetUrlIncludes is not "" then
+    repeat with safariWindow in windows
+      repeat with safariTab in tabs of safariWindow
+        set tabUrl to ""
+        try
+          set tabUrl to URL of safariTab
+        end try
+        if tabUrl contains targetUrlIncludes then
+          set targetWindow to safariWindow
+          set targetTab to safariTab
+          exit repeat
+        end if
+      end repeat
+      if targetTab is not missing value then exit repeat
+    end repeat
+    if targetTab is missing value then error "Safari nao possui aba correspondente a " & targetUrlIncludes
+  else
+    set targetWindow to front window
+    set targetTab to current tab of front window
+  end if
+  if shouldActivate and targetWindow is not missing value then
+    set current tab of targetWindow to targetTab
+    set index of targetWindow to 1
+  end if
   delay 0.2
-  set scriptResult to do JavaScript "${escapeAppleScript(wrappedScript)}" in current tab of front window
+  set scriptResult to do JavaScript "${escapeAppleScript(wrappedScript)}" in targetTab
 end tell
 return scriptResult
 `;
@@ -1849,11 +2488,17 @@ const normalizedDescription = normalize(rawDescription);
 const isYouTubeMusic = location.hostname.includes("music.youtube.com");
 const wantsFirst = /\\b(primeir[ao]?|first)\\b/.test(normalizedDescription);
 const wantsVideo = /\\b(video|videos|musica|faixa|youtube|resultado|watch)\\b/.test(normalizedDescription) || location.hostname.includes("youtube");
+const wantsNext = /\\b(proxim[ao]?|next|skip|pular|avanca|avancar)\\b/.test(normalizedDescription);
+const wantsPrevious = /\\b(anterior|previous|volta[ar]?|back|retorna[ar]?)\\b/.test(normalizedDescription);
+const wantsPause = /\\b(pausa|pause|pausar)\\b/.test(normalizedDescription);
+const wantsResume = /\\b(retoma|retomar|resume|continu[ae]r|despausa|play)\\b/.test(normalizedDescription);
 const stopWords = new Set([
   "o", "a", "os", "as", "um", "uma", "uns", "umas", "de", "da", "do", "das", "dos",
   "em", "no", "na", "nos", "nas", "para", "por", "com", "que", "visivel", "visiveis",
   "visivel", "tela", "pagina", "page", "site", "link", "botao", "botao", "clicar",
-  "clique", "seleciona", "selecionar", "resultado", "resultados"
+  "clique", "seleciona", "selecionar", "resultado", "resultados", "youtube", "music",
+  "melhor", "tocavel", "relacionado", "diretamente", "navegador", "player", "fila",
+  "play", "pause", "pausa", "proxima", "proximo", "anterior"
 ]);
 const quotedPhrases = Array.from(rawDescription.matchAll(/["'“”‘’]([^"'“”‘’]{2,80})["'“”‘’]/g))
   .map((match) => normalize(match[1]));
@@ -1928,6 +2573,173 @@ function deriveText(element) {
   return "";
 }
 
+function clickElement(element, strategy, matchedText, matchedHref, score, totalCandidates) {
+  if (!(element instanceof HTMLElement || element instanceof HTMLAnchorElement)) {
+    return null;
+  }
+  element.scrollIntoView({ block: "center", inline: "center", behavior: "auto" });
+  const rect = element.getBoundingClientRect();
+  for (const eventName of ["mouseover", "mousedown", "mouseup", "click"]) {
+    element.dispatchEvent(new MouseEvent(eventName, {
+      bubbles: true,
+      cancelable: true,
+      view: window,
+      clientX: rect.left + (rect.width / 2),
+      clientY: rect.top + (rect.height / 2),
+    }));
+  }
+  if (typeof element.click === "function") {
+    element.click();
+  }
+  return {
+    clicked: true,
+    matchedText: String(matchedText || "").slice(0, 180),
+    matchedHref: String(matchedHref || ""),
+    score,
+    totalCandidates,
+    strategy,
+  };
+}
+
+function attemptYouTubeMusicTransportClick() {
+  if (!isYouTubeMusic || !(wantsNext || wantsPrevious || wantsPause || wantsResume)) {
+    return null;
+  }
+
+  const playerButtons = Array.from(document.querySelectorAll(
+    "ytmusic-player-bar button, ytmusic-player-bar [role='button'], ytmusic-player-bar tp-yt-paper-icon-button"
+  ))
+    .filter((node) => node instanceof HTMLElement)
+    .filter((node) => isVisible(node));
+
+  const ranked = playerButtons
+    .map((node, index) => {
+      const label = normalize([
+        deriveText(node),
+        node.getAttribute("aria-label"),
+        node.getAttribute("title"),
+        node.id,
+      ].filter(Boolean).join(" "));
+      let score = 0;
+      if (wantsNext && /proxim|next|skip/.test(label)) score += 140;
+      if (wantsPrevious && /anterior|previous|back|volta/.test(label)) score += 140;
+      if (wantsPause && /pause|pausa|pausar/.test(label)) score += 140;
+      if (wantsResume && /play|tocar|reproduzir|resume|retomar|continuar/.test(label)) score += 140;
+      if (label.includes("player")) score += 12;
+      score += Math.max(0, 12 - index);
+      return score > 0 ? { node, label, score } : null;
+    })
+    .filter(Boolean)
+    .sort((left, right) => right.score - left.score);
+
+  if (!ranked.length) {
+    return null;
+  }
+
+  const winner = ranked[0];
+  return clickElement(winner.node, "safari_dom_ytmusic_transport", winner.label, "", winner.score, ranked.length);
+}
+
+function attemptYouTubeMusicSearchResultClick() {
+  if (!isYouTubeMusic || wantsNext || wantsPrevious || wantsPause) {
+    return null;
+  }
+  if (!quotedPhrases.length && !tokens.length) {
+    return null;
+  }
+
+  const rows = Array.from(document.querySelectorAll("ytmusic-responsive-list-item-renderer"))
+    .filter((node) => node instanceof HTMLElement)
+    .filter((node) => isVisible(node));
+
+  const rankedRows = rows
+    .map((row, index) => {
+      const titleNode = row.querySelector("#title, .title, yt-formatted-string.title");
+      const subtitleNode = row.querySelector(".subtitle, .byline, .secondary-flex-columns");
+      const titleText = String((titleNode && titleNode.textContent) || "").trim();
+      const subtitleText = String((subtitleNode && subtitleNode.textContent) || "").trim();
+      const rowText = deriveText(row);
+      const normalizedTitle = normalize(titleText);
+      const normalizedSubtitle = normalize(subtitleText);
+      const normalizedRow = normalize(rowText);
+      let score = 0;
+
+      for (const phrase of quotedPhrases) {
+        if (!phrase) continue;
+        if (normalizedTitle.includes(phrase)) score += 160;
+        else if (normalizedRow.includes(phrase)) score += 110;
+      }
+
+      for (const token of tokens) {
+        if (normalizedTitle.includes(token)) score += 28;
+        else if (normalizedSubtitle.includes(token)) score += 16;
+        else if (normalizedRow.includes(token)) score += 10;
+      }
+
+      if (tokens.length > 1) {
+        const titleMatches = tokens.filter((token) => normalizedTitle.includes(token)).length;
+        const rowMatches = tokens.filter((token) => normalizedRow.includes(token)).length;
+        if (titleMatches >= Math.max(2, Math.ceil(tokens.length * 0.5))) score += 80;
+        if (rowMatches === tokens.length) score += 40;
+      }
+
+      score += Math.max(0, 10 - index);
+
+      const clickableCandidates = Array.from(row.querySelectorAll(
+        "ytmusic-item-thumbnail-overlay-renderer button, button[aria-label], tp-yt-paper-icon-button, a[href*='watch?v=']"
+      ))
+        .filter((candidate) => candidate instanceof HTMLElement || candidate instanceof HTMLAnchorElement)
+        .filter((candidate) => isVisible(candidate))
+        .map((candidate) => {
+          const label = normalize([
+            deriveText(candidate),
+            candidate.getAttribute("aria-label"),
+            candidate.getAttribute("title"),
+          ].filter(Boolean).join(" "));
+          let candidateScore = 0;
+          if (/play|tocar|reproduzir|assistir/.test(label)) candidateScore += 30;
+          if (candidate instanceof HTMLAnchorElement && normalize(candidate.href).includes("watch?v=")) candidateScore += 18;
+          if (candidate.closest("ytmusic-item-thumbnail-overlay-renderer")) candidateScore += 14;
+          return { candidate, label, candidateScore };
+        })
+        .sort((left, right) => right.candidateScore - left.candidateScore);
+
+      return score > 0 ? {
+        row,
+        titleText,
+        href: clickableCandidates[0]?.candidate instanceof HTMLAnchorElement ? clickableCandidates[0].candidate.href : "",
+        score: score + (clickableCandidates[0]?.candidateScore || 0),
+        target: clickableCandidates[0]?.candidate || row,
+      } : null;
+    })
+    .filter(Boolean)
+    .sort((left, right) => right.score - left.score);
+
+  if (!rankedRows.length) {
+    return null;
+  }
+
+  const winner = rankedRows[0];
+  return clickElement(
+    winner.target,
+    "safari_dom_ytmusic_result",
+    winner.titleText || deriveText(winner.row),
+    winner.href || "",
+    winner.score,
+    rankedRows.length,
+  );
+}
+
+const ytmTransport = attemptYouTubeMusicTransportClick();
+if (ytmTransport) {
+  return ytmTransport;
+}
+
+const ytmResult = attemptYouTubeMusicSearchResultClick();
+if (ytmResult) {
+  return ytmResult;
+}
+
 function scoreCandidate(element, rank) {
   const text = deriveText(element);
   const href = element instanceof HTMLAnchorElement
@@ -2048,7 +2860,8 @@ tell application "Safari"
   activate
   if (count of windows) = 0 then error "Safari nao possui janelas abertas."
   delay 1
-  set pageJson to do JavaScript "(function(){const title=document.title||''; const url=location.href||''; const text=((document.body&&document.body.innerText)||'').trim().slice(0, 12000); const playerButton=document.querySelector('ytmusic-player-bar #play-pause-button, ytmusic-player-bar tp-yt-paper-icon-button#play-pause-button, ytmusic-player-bar tp-yt-paper-icon-button.play-pause-button'); const playerTitle=(Array.from(document.querySelectorAll('ytmusic-player-bar .title, ytmusic-player-bar .content-info-wrapper .title, ytmusic-player-bar [slot=\"title\"]')).map((node)=>((node&&node.textContent)||'').trim()).find(Boolean))||''; const playerState=(playerButton&&((playerButton.getAttribute('title')||playerButton.getAttribute('aria-label')||playerButton.textContent)||'').trim())||''; return JSON.stringify({title:title,url:url,text:text,playerTitle:playerTitle,playerState:playerState});})();" in current tab of front window
+  set jsCode to "(function(){const title=document.title||'';const url=location.href||'';const text=((document.body&&document.body.innerText)||'').trim().slice(0,12000);const playerButton=document.querySelector('ytmusic-player-bar #play-pause-button, ytmusic-player-bar tp-yt-paper-icon-button#play-pause-button, ytmusic-player-bar tp-yt-paper-icon-button.play-pause-button');const playerTitle=(Array.from(document.querySelectorAll('ytmusic-player-bar .title, ytmusic-player-bar .content-info-wrapper .title, ytmusic-player-bar [slot=title]')).map((node)=>((node&&node.textContent)||'').trim()).find(Boolean))||'';const playerState=(playerButton&&((playerButton.getAttribute('title')||playerButton.getAttribute('aria-label')||playerButton.textContent)||'').trim())||'';return JSON.stringify({title,url,text,playerTitle,playerState});})();"
+  set pageJson to do JavaScript jsCode in current tab of front window
 end tell
 return pageJson
 `;
@@ -2549,7 +3362,15 @@ if let output = String(data: data, encoding: .utf8) {
             return `${action.app} ficou em foco no macOS`;
         }
         if (action.type === "press_shortcut") {
-            return `Atalho ${action.shortcut} executado no macOS`;
+            const mediaSummaryMap = {
+                media_next: "Comando de próxima mídia executado no macOS",
+                media_previous: "Comando de mídia anterior executado no macOS",
+                media_pause: "Comando de pausar mídia executado no macOS",
+                media_resume: "Comando de retomar mídia executado no macOS",
+                media_play: "Comando de reproduzir mídia executado no macOS",
+                media_play_pause: "Comando de play/pause de mídia executado no macOS",
+            };
+            return mediaSummaryMap[action.shortcut] || `Atalho ${action.shortcut} executado no macOS`;
         }
         if (action.type === "create_note") {
             return `Nota criada no Notes: ${action.title || deriveNoteTitle(action.text)}`;