@leg3ndy/otto-bridge 0.9.1 → 0.9.2

package/README.md

@@ -15,7 +15,7 @@ Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap
 
 Para o corte de arquitetura do `0.9.0`, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md).
 
-Para o patch atual `0.9.1`, com hotfixes de stream/renderizacao e completude das filesystem tools, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_1_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_1_PATCH.md).
+Para o patch atual `0.9.2`, com confirmacao bloqueante correta e exclusao segura via Lixeira, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_2_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_2_PATCH.md).
 
 ## Distribuicao
 
@@ -37,14 +37,14 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-0.9.1.tgz
+npm install -g ./leg3ndy-otto-bridge-0.9.2.tgz
 ```
 
-Na linha `0.9.1`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
+Na linha `0.9.2`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
 
-No macOS, a linha `0.9.1` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
+No macOS, a linha `0.9.2` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
 
-No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `0.9.1` consolida esse caminho com hotfixes de stream visivel, planner LLM-first e leitura/listagem local sem truncamento silencioso.
+No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `0.9.2` consolida esse caminho com confirmacao bloqueante correta, exclusao segura via Lixeira, planner LLM-first e leitura/listagem local sem truncamento silencioso.
 
 ## Publicacao
 
@@ -114,7 +114,7 @@ otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `0.9.1`:
+Fluxo recomendado na linha `0.9.2`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -124,13 +124,13 @@ otto-bridge extensions --status whatsappweb
 
 O setup agora abre o login do WhatsApp Web no helper/background browser do proprio bridge. Depois do QR code, o Otto usa a sessao local em background, sem depender de aba visivel no Safari.
 
-Contrato da linha `0.9.1`:
+Contrato da linha `0.9.2`:
 
 - `otto-bridge extensions --setup whatsappweb`: autentica a sessao uma vez
 - `otto-bridge run`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime estiver ativo, sem depender de uma aba aberta no Safari
 - ao parar o `otto-bridge run`: o browser em background e desligado, mas a sessao local fica lembrada para o proximo boot
 
-## Handoff rapido da linha 0.9.1
+## Handoff rapido da linha 0.9.2
 
 Ja fechado no codigo:
 

package/dist/executors/native_macos.js

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { mkdir, readFile, readdir, stat } from "node:fs/promises";
+import { mkdir, readFile, readdir, rename, stat, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import process from "node:process";
@@ -702,6 +702,17 @@ function clipTextPreview(value, maxLength) {
     }
     return `${value.slice(0, maxLength)}\n\n[conteudo truncado: mostrando ${maxLength} de ${value.length} caracteres. Peca um trecho mais especifico se quiser continuar.]`;
 }
+function sanitizeFileName(value, fallback = "otto-note.txt") {
+    const normalized = String(value || "")
+        .normalize("NFD")
+        .replace(/\p{Diacritic}/gu, "")
+        .replace(/[\/\\?%*:|"<>]/g, "-")
+        .replace(/\s+/g, " ")
+        .trim();
+    const collapsed = normalized.replace(/\.+/g, ".").replace(/^\.+/, "").replace(/\.+$/, "");
+    const candidate = collapsed || fallback;
+    return path.extname(candidate) ? candidate : `${candidate}.txt`;
+}
 function chunkTextForTransport(value, chunkSize) {
     const normalized = String(value || "");
     if (!normalized) {
@@ -1009,6 +1020,30 @@ function parseStructuredActions(job) {
             }
             continue;
         }
+        if (type === "write_text_file" || type === "write_file" || type === "save_text_file" || type === "save_file") {
+            const targetPath = asString(action.path)
+                || asString(action.destination)
+                || asString(action.file_path)
+                || asString(action.target)
+                || asString(action.directory)
+                || asString(action.folder)
+                || (asString(action.filename) ? "~/Desktop" : "");
+            const text = asString(action.text) || asString(action.content) || asString(action.body) || asString(action.value);
+            const source = asString(action.source) || asString(action.input_source);
+            if (targetPath && (text || source)) {
+                actions.push({
+                    type: "write_text_file",
+                    path: targetPath,
+                    text: text || undefined,
+                    content: asString(action.content) || undefined,
+                    body: asString(action.body) || undefined,
+                    source: source || undefined,
+                    filename: asString(action.filename) || asString(action.file_name) || asString(action.name) || asString(action.title) || undefined,
+                    append: action.append === true,
+                });
+            }
+            continue;
+        }
         if (type === "list_files" || type === "ls") {
             const filePath = asString(action.path) || "~";
             const limit = typeof action.limit === "number" ? Math.max(1, Math.min(5_000, action.limit)) : undefined;
@@ -1221,6 +1256,7 @@ export class NativeMacOSJobExecutor {
     lastActiveApp = null;
     lastVisualTargetDescription = null;
     lastVisualTargetApp = null;
+    lastReadFrontmostPage = null;
     lastSatisfiedSpotifyDescription = null;
     lastSatisfiedSpotifyConfirmedPlaying = false;
     lastSatisfiedSpotifyAt = 0;
@@ -1359,6 +1395,10 @@ export class NativeMacOSJobExecutor {
                 if (action.type === "read_frontmost_page") {
                     await reporter.progress(progressPercent, `Lendo a pagina ativa em ${action.app || "Safari"}`);
                     const page = await this.readFrontmostPage(action.app || "Safari");
+                    this.lastReadFrontmostPage = {
+                        app: action.app || "Safari",
+                        ...page,
+                    };
                     if (!page.text && this.bridgeConfig?.apiBaseUrl && this.bridgeConfig?.deviceToken) {
                         await reporter.progress(progressPercent, "Safari bloqueou leitura direta; vou analisar a pagina pela tela");
                         const screenshotPath = await this.takeScreenshot();
@@ -1424,6 +1464,27 @@ export class NativeMacOSJobExecutor {
                     completionNotes.push(fileContent.summary);
                     continue;
                 }
+                if (action.type === "trash_path") {
+                    await reporter.progress(progressPercent, `Movendo ${action.path} para a Lixeira`);
+                    const trashed = await this.movePathToTrashSnapshot(action.path);
+                    resultPayload.trash_path = trashed;
+                    resultPayload.summary = trashed.summary;
+                    completionNotes.push(trashed.summary);
+                    continue;
+                }
+                if (action.type === "write_text_file") {
+                    const targetLabel = action.filename ? `${action.path}/${action.filename}` : action.path;
+                    await reporter.progress(progressPercent, `Escrevendo arquivo de texto em ${targetLabel}`);
+                    const resolvedContent = this.resolveWriteTextFileContent(action);
+                    if (!resolvedContent) {
+                        throw new Error("Nenhum texto foi informado para gravar no arquivo local.");
+                    }
+                    const written = await this.writeTextFileSnapshot(action.path, resolvedContent.content, action.filename, action.append === true, resolvedContent.source);
+                    resultPayload.write_text_file = written;
+                    resultPayload.summary = written.summary;
+                    completionNotes.push(written.summary);
+                    continue;
+                }
                 if (action.type === "list_files") {
                     await reporter.progress(progressPercent, `Listando arquivos em ${action.path}`);
                     const listing = await this.listLocalFilesSnapshot(action.path, action.limit);
@@ -4606,25 +4667,68 @@ return {
         if (targetApp !== "Safari") {
             throw new Error("Leitura de pagina frontmost esta disponivel apenas para Safari no momento.");
         }
-        const script = `
-tell application "Safari"
-  activate
-  if (count of windows) = 0 then error "Safari nao possui janelas abertas."
-  delay 1
-  set jsCode to "(function(){const title=document.title||'';const url=location.href||'';const text=((document.body&&document.body.innerText)||'').trim().slice(0,12000);const isYouTubeMusic=location.hostname.includes('music.youtube.com');const isSpotify=location.hostname.includes('open.spotify.com');let playerButton=null;let playerTitle='';let playerState='';if(isYouTubeMusic){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');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))||'';playerState=(playerButton&&((playerButton.getAttribute('title')||playerButton.getAttribute('aria-label')||playerButton.textContent)||'').trim())||'';}else if(isSpotify){const visible=(node)=>{if(!(node instanceof Element))return false;const rect=node.getBoundingClientRect();if(rect.width<4||rect.height<4)return false;const style=window.getComputedStyle(node);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;};const spotifyTitleCandidates=Array.from(document.querySelectorAll(\"[data-testid='nowplaying-track-link'], footer a[href*='/track/'], [data-testid='now-playing-widget'] a[href*='/track/'], a[href*='/track/']\")).filter((node)=>visible(node)).map((node)=>({node,text:((node&&node.textContent)||'').trim(),rect:node.getBoundingClientRect()})).filter((entry)=>entry.text).sort((left,right)=>{const leftBottomBias=(left.rect.top>=window.innerHeight*0.72?200:0)+(left.rect.left<=window.innerWidth*0.45?120:0)+left.rect.top;const rightBottomBias=(right.rect.top>=window.innerHeight*0.72?200:0)+(right.rect.left<=window.innerWidth*0.45?120:0)+right.rect.top;return rightBottomBias-leftBottomBias;});playerTitle=(spotifyTitleCandidates[0]&&spotifyTitleCandidates[0].text)||'';playerButton=Array.from(document.querySelectorAll(\"footer button, [data-testid='control-button-playpause'], button[aria-label], button[title]\")).filter((node)=>visible(node)).map((node)=>({node,label:((node.getAttribute('aria-label')||node.getAttribute('title')||node.textContent)||'').trim(),rect:node.getBoundingClientRect()})).filter((entry)=>/play|pause|tocar|pausar|reproduzir/i.test(entry.label)).sort((left,right)=>{const leftScore=(left.rect.top>=window.innerHeight*0.72?200:0)+Math.max(0,200-Math.abs((left.rect.left+left.rect.width/2)-(window.innerWidth/2)));const rightScore=(right.rect.top>=window.innerHeight*0.72?200:0)+Math.max(0,200-Math.abs((right.rect.left+right.rect.width/2)-(window.innerWidth/2)));return rightScore-leftScore;})[0]?.node||null;playerState=(playerButton&&((playerButton.getAttribute('aria-label')||playerButton.getAttribute('title')||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
-`;
         try {
-            const { stdout } = await this.runCommandCapture("osascript", ["-e", script]);
-            const parsed = JSON.parse(stdout.trim() || "{}");
+            const page = await this.runSafariJsonScript(`
+const title = document.title || "";
+const url = location.href || "";
+const text = ((document.body && document.body.innerText) || "").trim().slice(0, 12000);
+const isYouTubeMusic = location.hostname.includes("music.youtube.com");
+const isSpotify = location.hostname.includes("open.spotify.com");
+let playerButton = null;
+let playerTitle = "";
+let playerState = "";
+
+if (isYouTubeMusic) {
+  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");
+  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)) || "";
+  playerState = (playerButton && ((playerButton.getAttribute("title") || playerButton.getAttribute("aria-label") || playerButton.textContent) || "").trim()) || "";
+} else if (isSpotify) {
+  const visible = (node) => {
+    if (!(node instanceof Element)) return false;
+    const rect = node.getBoundingClientRect();
+    if (rect.width < 4 || rect.height < 4) return false;
+    const style = window.getComputedStyle(node);
+    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;
+  };
+  const spotifyTitleCandidates = Array.from(document.querySelectorAll("[data-testid='nowplaying-track-link'], footer a[href*='/track/'], [data-testid='now-playing-widget'] a[href*='/track/'], a[href*='/track/']"))
+    .filter((node) => visible(node))
+    .map((node) => ({ node, text: ((node && node.textContent) || "").trim(), rect: node.getBoundingClientRect() }))
+    .filter((entry) => entry.text)
+    .sort((left, right) => {
+      const leftBottomBias = (left.rect.top >= window.innerHeight * 0.72 ? 200 : 0) + (left.rect.left <= window.innerWidth * 0.45 ? 120 : 0) + left.rect.top;
+      const rightBottomBias = (right.rect.top >= window.innerHeight * 0.72 ? 200 : 0) + (right.rect.left <= window.innerWidth * 0.45 ? 120 : 0) + right.rect.top;
+      return rightBottomBias - leftBottomBias;
+    });
+  playerTitle = (spotifyTitleCandidates[0] && spotifyTitleCandidates[0].text) || "";
+  playerButton = Array.from(document.querySelectorAll("footer button, [data-testid='control-button-playpause'], button[aria-label], button[title]"))
+    .filter((node) => visible(node))
+    .map((node) => ({ node, label: ((node.getAttribute("aria-label") || node.getAttribute("title") || node.textContent) || "").trim(), rect: node.getBoundingClientRect() }))
+    .filter((entry) => /play|pause|tocar|pausar|reproduzir/i.test(entry.label))
+    .sort((left, right) => {
+      const leftScore = (left.rect.top >= window.innerHeight * 0.72 ? 200 : 0) + Math.max(0, 200 - Math.abs((left.rect.left + left.rect.width / 2) - (window.innerWidth / 2)));
+      const rightScore = (right.rect.top >= window.innerHeight * 0.72 ? 200 : 0) + Math.max(0, 200 - Math.abs((right.rect.left + right.rect.width / 2) - (window.innerWidth / 2)));
+      return rightScore - leftScore;
+    })[0]?.node || null;
+  playerState = (playerButton && ((playerButton.getAttribute("aria-label") || playerButton.getAttribute("title") || playerButton.textContent) || "").trim()) || "";
+}
+
+return {
+  title,
+  url,
+  text,
+  playerTitle,
+  playerState,
+};
+        `, {}, { activate: true });
             return {
-                title: asString(parsed.title) || "",
-                url: asString(parsed.url) || "",
-                text: asString(parsed.text) || "",
-                playerTitle: asString(parsed.playerTitle) || "",
-                playerState: asString(parsed.playerState) || "",
+                title: page.title || "",
+                url: page.url || "",
+                text: page.text || "",
+                playerTitle: page.playerTitle || "",
+                playerState: page.playerState || "",
             };
         }
         catch (error) {
@@ -5075,6 +5179,193 @@ if let output = String(data: data, encoding: .utf8) {
             summary: `Li ${filePath} por completo (${content.length} caracteres em ${chunks.length} bloco${chunks.length === 1 ? "" : "s"}).`,
         };
     }
+    async resolveTrashTargetPath(targetPath) {
+        const resolved = expandUserPath(targetPath);
+        try {
+            await stat(resolved);
+            return resolved;
+        }
+        catch {
+            // Continue into heuristic search below.
+        }
+        const targetName = path.basename(resolved).trim();
+        if (!targetName || targetName === "." || targetName === path.sep) {
+            return resolved;
+        }
+        const homeDir = os.homedir();
+        const requestedDir = path.dirname(resolved);
+        const preferredRoots = uniqueStrings([
+            requestedDir && requestedDir !== homeDir ? requestedDir : null,
+            path.join(homeDir, "Downloads"),
+            path.join(homeDir, "Desktop"),
+            path.join(homeDir, "Documents"),
+            homeDir,
+        ]);
+        const found = await this.findPathByName(targetName, preferredRoots);
+        return found || resolved;
+    }
+    async findPathByName(targetName, roots) {
+        const normalizedTarget = normalizeText(targetName).replace(/\s+/g, " ").trim();
+        if (!normalizedTarget) {
+            return null;
+        }
+        for (const root of roots) {
+            let rootStat;
+            try {
+                rootStat = await stat(root);
+            }
+            catch {
+                continue;
+            }
+            if (!rootStat.isDirectory()) {
+                continue;
+            }
+            const queue = [root];
+            while (queue.length > 0) {
+                const current = queue.shift();
+                if (!current)
+                    continue;
+                let entries;
+                try {
+                    entries = await readdir(current, { withFileTypes: true });
+                }
+                catch {
+                    continue;
+                }
+                for (const entry of entries) {
+                    const entryPath = path.join(current, entry.name);
+                    const normalizedEntryName = normalizeText(entry.name).replace(/\s+/g, " ").trim();
+                    if (normalizedEntryName === normalizedTarget) {
+                        return entryPath;
+                    }
+                    if (entry.isDirectory()) {
+                        if (!FILE_SEARCH_SKIP_DIRS.has(entry.name)) {
+                            queue.push(entryPath);
+                        }
+                        continue;
+                    }
+                    if (entry.isFile() && entry.name.toLowerCase() === targetName.toLowerCase()) {
+                        return entryPath;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    async resolveUniqueTrashDestination(targetPath) {
+        const ext = path.extname(targetPath);
+        const stem = ext ? targetPath.slice(0, -ext.length) : targetPath;
+        let attempt = 0;
+        let candidate = targetPath;
+        while (true) {
+            try {
+                await stat(candidate);
+                attempt += 1;
+                candidate = `${stem} ${attempt + 1}${ext}`;
+            }
+            catch {
+                return candidate;
+            }
+        }
+    }
+    async movePathToTrashSnapshot(targetPath) {
+        const resolved = await this.resolveTrashTargetPath(targetPath);
+        const entryStat = await stat(resolved);
+        const trashDir = path.join(os.homedir(), ".Trash");
+        await mkdir(trashDir, { recursive: true });
+        const name = path.basename(resolved) || resolved;
+        const trashedPath = await this.resolveUniqueTrashDestination(path.join(trashDir, name));
+        await rename(resolved, trashedPath);
+        const kind = entryStat.isDirectory()
+            ? "directory"
+            : entryStat.isFile()
+                ? "file"
+                : "other";
+        return {
+            captured_at: new Date().toISOString(),
+            path: targetPath,
+            resolved_path: resolved,
+            trashed_path: trashedPath,
+            name,
+            kind,
+            size_bytes: entryStat.size,
+            modified_at: entryStat.mtime.toISOString(),
+            summary: `${kind === "directory" ? "Mandei a pasta" : kind === "file" ? "Mandei o arquivo" : "Mandei o item"} ${name} para a Lixeira.`,
+        };
+    }
+    async resolveWritableTextFilePath(targetPath, filename) {
+        const expanded = expandUserPath(targetPath);
+        const requestedFilename = filename ? sanitizeFileName(filename) : null;
+        if (requestedFilename) {
+            try {
+                const existingStat = await stat(expanded);
+                if (existingStat.isDirectory()) {
+                    return path.join(expanded, requestedFilename);
+                }
+            }
+            catch {
+                // Continue below and treat the target as a direct file path.
+            }
+            if (String(targetPath || "").trimEnd().endsWith(path.sep)) {
+                return path.join(expanded, requestedFilename);
+            }
+        }
+        try {
+            const existingStat = await stat(expanded);
+            if (existingStat.isDirectory()) {
+                return path.join(expanded, sanitizeFileName("otto-note.txt"));
+            }
+        }
+        catch {
+            // Continue below and treat the target as a direct file path.
+        }
+        if (String(targetPath || "").trimEnd().endsWith(path.sep)) {
+            return path.join(expanded, sanitizeFileName("otto-note.txt"));
+        }
+        return expanded;
+    }
+    async writeTextFileSnapshot(targetPath, text, filename, append = false, source) {
+        const resolved = await this.resolveWritableTextFilePath(targetPath, filename);
+        const parentDir = path.dirname(resolved);
+        await mkdir(parentDir, { recursive: true });
+        await writeFile(resolved, text, {
+            encoding: "utf8",
+            flag: append ? "a" : "w",
+        });
+        const entryStat = await stat(resolved);
+        const name = path.basename(resolved) || resolved;
+        const preview = clipTextPreview(String(text || "") || "(arquivo vazio)", 240);
+        return {
+            captured_at: new Date().toISOString(),
+            path: targetPath,
+            resolved_path: resolved,
+            name,
+            mime_type: "text/plain; charset=utf-8",
+            size_bytes: entryStat.size,
+            modified_at: entryStat.mtime.toISOString(),
+            append,
+            content_char_count: String(text || "").length,
+            content_preview: preview,
+            source: source || undefined,
+            summary: `${append ? "Atualizei" : "Escrevi"} ${String(text || "").length} caractere${String(text || "").length === 1 ? "" : "s"} em ${resolved}.`,
+        };
+    }
+    resolveWriteTextFileContent(action) {
+        const explicitText = [action.text, action.content, action.body]
+            .map((value) => String(value || "").trim())
+            .find(Boolean);
+        if (explicitText) {
+            return { content: explicitText };
+        }
+        const source = String(action.source || "").trim().toLowerCase();
+        if (source === "last_page_text" || source === "last_page_summary") {
+            const pageText = String(this.lastReadFrontmostPage?.text || "").trim();
+            if (pageText) {
+                return { content: pageText, source };
+            }
+        }
+        return null;
+    }
     async resolveReadableFilePath(filePath) {
         const resolved = expandUserPath(filePath);
         try {
@@ -5535,6 +5826,12 @@ if let output = String(data: data, encoding: .utf8) {
         if (action.type === "read_file") {
             return `${action.path} foi lido no macOS`;
         }
+        if (action.type === "trash_path") {
+            return `${action.path} foi movido para a Lixeira`;
+        }
+        if (action.type === "write_text_file") {
+            return `Arquivo de texto escrito em ${action.filename ? `${action.path}/${action.filename}` : action.path}`;
+        }
         if (action.type === "list_files") {
             return `Arquivos listados em ${action.path}`;
         }

package/dist/tool_catalog.js

@@ -65,6 +65,23 @@ const NATIVE_MACOS_BASE_TOOLS = [
         mode: "observe",
         action_types: ["read_file"],
     },
+    {
+        id: "filesystem.write",
+        title: "Escrita de arquivo de texto",
+        description: "Cria ou atualiza arquivos .txt em caminhos locais, incluindo Desktop e outras pastas do usuario.",
+        category: "filesystem",
+        mode: "write",
+        action_types: ["write_text_file"],
+    },
+    {
+        id: "filesystem.trash",
+        title: "Mover item para a Lixeira",
+        description: "Move arquivos e pastas locais para a Lixeira do macOS com confirmação.",
+        category: "filesystem",
+        mode: "write",
+        action_types: ["trash_path"],
+        requires_confirmation: true,
+    },
     {
         id: "system.health",
         title: "Status do Mac",

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "0.9.1";
+export const BRIDGE_VERSION = "0.9.2";
 export const BRIDGE_PACKAGE_NAME = "@leg3ndy/otto-bridge";
 export const DEFAULT_API_BASE_URL = "http://localhost:8000";
 export const DEFAULT_POLL_INTERVAL_MS = 3000;
@@ -10,4 +10,4 @@ export const DEFAULT_RECONNECT_MAX_DELAY_MS = 15000;
 export const DEFAULT_EXECUTOR_TYPE = "mock";
 export const DEFAULT_CLAWD_CURSOR_BASE_URL = "http://127.0.0.1:3847";
 export const DEFAULT_CLAWD_CURSOR_POLL_INTERVAL_MS = 1500;
-export const BRIDGE_LOCAL_TOOLS_VERSION = 1;
+export const BRIDGE_LOCAL_TOOLS_VERSION = 2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leg3ndy/otto-bridge",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "private": false,
   "type": "module",
   "description": "Local companion for Otto Bridge device pairing and WebSocket runtime.",