Merge pull request #2609 from Ayush7614/feat/docs-firefox-upload-file-parity

docs: correct Firefox upload_file parity in tool matrix and TODOs

Author: webbrain-one

CONTRIBUTING.md

@@ -177,12 +177,12 @@ the FAQ on the main page. If you've benchmarked a model that should be on
 that list (or shouldn't, for a stated reason), open an issue with the
 benchmark setup, the trace, and the comparison data.
 
-### Code: prompt tier system, Firefox parity, recorder fixes
+### Code: prompt tier system and Firefox parity
 
 See [`TODOs.md`](TODOs.md) for engineering items we know we want to do but
-haven't gotten to. Some of those (e.g. small-tier ACT prompt, `upload_file`
-in Firefox, missing step numbers on tool events in traces) are well-scoped
-and a good first PR if you want a code task.
+haven't gotten to. Some of those (e.g. the small-tier ACT prompt and
+`full_page_screenshot` in Firefox) are well-scoped and a good first PR if you
+want a code task.
 
 ---
 

TODOs.md

@@ -73,11 +73,11 @@ Per-model-class prompt selection wired through `_getActPrompt()`. Tier inferred
 
 The Firefox build is meaningfully weaker than Chrome (already noted in the README's "Known Issues"). Some gaps are platform-real (no CDP, no Manifest V3 service worker), but several are just unported features. Worth ticking off one at a time:
 
-- **`upload_file`** — not yet in Firefox. The dispatcher path exists for downloads but not for uploads. Likely a few hours of work; webextensions has the same `<input type="file">` mechanics.
 - **`full_page_screenshot`** — Chrome uses CDP `captureBeyondViewport`; Firefox would need `tabs.captureFullPage` or a scroll-and-stitch fallback. Lower priority.
 - **`shadow_dom_query`** — CDP-dependent. Hardest port; may not be worth it until a concrete user case emerges.
 
 Recently closed Firefox parity items:
+- **`upload_file`** — Firefox now supports `downloadId` re-fetch and a sidepanel user file picker (no arbitrary local `filePath` without CDP). Shipped via the Firefox upload_file port.
 - Firefox now has `downloads` permission and `download_files`; the old singular `download_file` TODO is obsolete because the tool surface was consolidated on plural `download_files`.
 - Firefox Ask mode can access the accessibility tree again (10.0.2).
 

docs/agent-tools.md

@@ -72,7 +72,7 @@ Legend: **Yes** = available · **-** = not available · **C** = Chrome only ·
 | `read_downloaded_file` | No | No | Yes | Yes | - |
 | `download_files` | No | No | Yes | Yes | - |
 | `download_resource_from_page` | No | No | Yes | Yes | - |
-| `upload_file` | No | No | C | C | - |
+| `upload_file` | No | No | Yes | Yes | - |
 | `verify_form` | No | No | Yes | Yes | - |
 | `hover` | No | No | No | Yes | - |
 | `drag_drop` | No | No | No | Yes | - |

docs/claude-chrome-comparison.md

@@ -97,7 +97,7 @@ core surface, including Dev-only `execute_js`, is shared.
 | Reading/extraction | `read_page`, `read_pdf`, `read_page_source`, `extract_data`, `inspect_element_styles`, `get_selection` |
 | Dev editing and diagnostics | `inject_css`, `remove_injected_css`, `patch_element`, `revert_patch`, `execute_js`, `read_console`, `inspect_network_requests`, `inspect_event_listeners`, `highlight_element` |
 | Shadow DOM and frames | `get_shadow_dom`, `shadow_dom_query` on Chrome, `get_frames`, `iframe_read`, `iframe_click`, `iframe_type` |
-| Network and files | `fetch_url`, `research_url`, `list_downloads`, `read_downloaded_file`, `download_resource_from_page`, `download_files`, `upload_file` on Chrome |
+| Network and files | `fetch_url`, `research_url`, `list_downloads`, `read_downloaded_file`, `download_resource_from_page`, `download_files`, `upload_file` |
 | Long-running work | `schedule_resume`, `schedule_task`, `scratchpad_write`, `progress_update`, `progress_read` |
 | Safety/workflow | `verify_form`, `clarify`, `done`, `solve_captcha` |
 | Media | `download_social_media`, plus dynamic skill tools when enabled |
@@ -194,7 +194,7 @@ fresh screenshot.
 | Console/network inspection | No dedicated console log reader in the core WebBrain tool list. Network shortcuts exist for API observation, but not a model-facing request-log reader in the same way. | Dedicated `read_console_messages` and `read_network_requests`. |
 | Downloads | Several browser download/file tools plus dynamic download-job skill tools. | `downloads` permission exists and `gif_creator` can download exports, but no general download manager equivalent was recovered. |
 | Media download | `download_public_media` skill first; `download_social_media` browser fallback. | No public-media download equivalent recovered. |
-| File upload | Chrome has `upload_file` by downloadId/path-oriented flow; Firefox lacks it. | `file_upload` directly sets local absolute paths on a file input; `upload_image` uploads captured/user images by ref or coordinate. |
+| File upload | Both browsers have `upload_file`. Chrome supports `downloadId` and absolute `filePath`; Firefox supports `downloadId` re-fetch and a sidepanel user file picker (no arbitrary local paths without CDP). | `file_upload` directly sets local absolute paths on a file input; `upload_image` uploads captured/user images by ref or coordinate. |
 | Scheduler | `schedule_resume` and `schedule_task`. | Scheduled task UI/prompt strings exist, but no equivalent model-callable scheduler schema was recovered in the visible tool list. |
 | CAPTCHA | `solve_captcha` when CapSolver is configured. | Explicit security prompt says respect CAPTCHAs and never bypass; no solver tool recovered. |
 | Persistent agent memory | `scratchpad_write`, `progress_update`, `progress_read`. | Conversation compaction exists; no equivalent scratchpad/progress tools recovered. |

docs/fr/agent-tools.md

@@ -72,7 +72,7 @@ uniquement · **Dev** = module Dev (fournisseurs Mid/Full ; pas Compact).
 | `read_downloaded_file` | Non | Non | Oui | Oui | - |
 | `download_files` | Non | Non | Oui | Oui | - |
 | `download_resource_from_page` | Non | Non | Oui | Oui | - |
-| `upload_file` | Non | Non | C | C | - |
+| `upload_file` | Non | Non | Oui | Oui | - |
 | `verify_form` | Non | Non | Oui | Oui | - |
 | `hover` | Non | Non | Non | Oui | - |
 | `drag_drop` | Non | Non | Non | Oui | - |

docs/fr/claude-chrome-comparison.md

@@ -99,7 +99,7 @@ de la surface de base, y compris `execute_js` réservé au mode Dev, est partag
 | Lecture/extraction | `read_page`, `read_pdf`, `read_page_source`, `extract_data`, `inspect_element_styles`, `get_selection` |
 | Édition et diagnostic Dev | `inject_css`, `remove_injected_css`, `patch_element`, `revert_patch`, `execute_js`, `read_console`, `inspect_network_requests`, `inspect_event_listeners`, `highlight_element` |
 | Shadow DOM et cadres | `get_shadow_dom`, `shadow_dom_query` sur Chrome, `get_frames`, `iframe_read`, `iframe_click`, `iframe_type` |
-| Réseau et fichiers | `fetch_url`, `research_url`, `list_downloads`, `read_downloaded_file`, `download_resource_from_page`, `download_files`, `upload_file` sur Chrome |
+| Réseau et fichiers | `fetch_url`, `research_url`, `list_downloads`, `read_downloaded_file`, `download_resource_from_page`, `download_files`, `upload_file` |
 | Travail longue durée | `schedule_resume`, `schedule_task`, `scratchpad_write`, `progress_update`, `progress_read` |
 | Sécurité/flux de travail | `verify_form`, `clarify`, `done`, `solve_captcha` |
 | Média | `download_social_media`, plus les outils de compétences dynamiques lorsqu'ils sont activés |
@@ -198,7 +198,7 @@ synthétiques avec une nouvelle capture d'écran.
 | Inspection console/réseau | Pas de lecteur de logs console dédié dans la liste des outils de base WebBrain. Des raccourcis réseau existent pour l'observation d'API, mais pas un lecteur de logs de requêtes orienté modèle. | `read_console_messages` et `read_network_requests` dédiés. |
 | Téléchargements | Plusieurs outils de téléchargement/fichier navigateur plus des outils de compétences de tâche de téléchargement dynamiques. | La permission `downloads` existe et `gif_creator` peut télécharger des exports, mais aucun gestionnaire de téléchargement général équivalent n'a été trouvé. |
 | Téléchargement média | Compétence `download_public_media` d'abord ; `download_social_media` en repli navigateur. | Aucun équivalent de téléchargement de média public trouvé. |
-| Téléchargement de fichier | Chrome dispose de `upload_file` par flux orienté downloadId/chemin ; Firefox ne l'a pas. | `file_upload` définit directement des chemins absolus locaux sur une entrée fichier ; `upload_image` télécharge des images capturées/utilisateur par référence ou coordonnée. |
+| Téléchargement de fichier | Les deux navigateurs ont `upload_file`. Chrome accepte `downloadId` et un `filePath` absolu ; Firefox accepte le re-fetch par `downloadId` et un sélecteur de fichier dans le panneau latéral (pas de chemins locaux arbitraires sans CDP). | `file_upload` définit directement des chemins absolus locaux sur une entrée fichier ; `upload_image` télécharge des images capturées/utilisateur par référence ou coordonnée. |
 | Planificateur | `schedule_resume` et `schedule_task`. | L'interface utilisateur/les chaînes d'invite de tâches planifiées existent, mais aucun schéma de planificateur appelable par le modèle équivalent n'a été trouvé dans la liste d'outils visible. |
 | CAPTCHA | `solve_captcha` lorsque CapSolver est configuré. | L'invite de sécurité explicite demande de respecter les CAPTCHA et de ne jamais les contourner ; aucun outil de résolution trouvé. |
 | Mémoire persistante de l'agent | `scratchpad_write`, `progress_update`, `progress_read`. | La compaction de conversation existe ; aucun outil équivalent de bloc-notes/progression trouvé. |

docs/webbrain-mode-tier-tool-chart.xlsx

@@ -71,7 +71,7 @@ WebBrain 将**模型层级**与**对话模式**分开。
 | `read_downloaded_file` | 否 | 否 | 是 | 是 | - |
 | `download_files` | 否 | 否 | 是 | 是 | - |
 | `download_resource_from_page` | 否 | 否 | 是 | 是 | - |
-| `upload_file` | 否 | 否 | C | C | - |
+| `upload_file` | 否 | 否 | 是 | 是 | - |
 | `verify_form` | 否 | 否 | 是 | 是 | - |
 | `hover` | 否 | 否 | 否 | 是 | - |
 | `drag_drop` | 否 | 否 | 否 | 是 | - |

docs/webbrain-tool-tiers.xlsx

@@ -92,7 +92,7 @@ Firefox 不包含 Chrome 独有的 Dev 工具和 `shadow_dom_query`；其余核
 | 读取/提取 | `read_page`、`read_pdf`、`read_page_source`、`extract_data`、`inspect_element_styles`、`get_selection` |
 | Dev 编辑与诊断 | `inject_css`、`remove_injected_css`、`patch_element`、`revert_patch`、`execute_js`、`read_console`、`inspect_network_requests`、`inspect_event_listeners`、`highlight_element` |
 | Shadow DOM 和框架 | `get_shadow_dom`、`shadow_dom_query`（Chrome）、`get_frames`、`iframe_read`、`iframe_click`、`iframe_type` |
-| 网络和文件 | `fetch_url`、`research_url`、`list_downloads`、`read_downloaded_file`、`download_resource_from_page`、`download_files`、`upload_file`（Chrome） |
+| 网络和文件 | `fetch_url`、`research_url`、`list_downloads`、`read_downloaded_file`、`download_resource_from_page`、`download_files`、`upload_file` |
 | 长时间运行的工作 | `schedule_resume`、`schedule_task`、`scratchpad_write`、`progress_update`、`progress_read` |
 | 安全/工作流 | `verify_form`、`clarify`、`done`、`solve_captcha` |
 | 媒体 | `download_social_media`，以及启用时的动态技能工具 |
@@ -182,7 +182,7 @@ W               等待页面稳定
 | 控制台/网络检查 | WebBrain 核心工具列表中没有专用的控制台日志读取器。存在用于 API 观察的网络快捷方式，但没有面向模型的请求日志读取器。 | 专用的 `read_console_messages` 和 `read_network_requests`。 |
 | 下载 | 多个浏览器下载/文件工具加上动态下载作业技能工具。 | `downloads` 权限存在，`gif_creator` 可以下载导出内容，但未找到通用的下载管理器等效功能。 |
 | 媒体下载 | 首选 `download_public_media` 技能；浏览器回退 `download_social_media`。 | 未找到公共媒体下载等效功能。 |
-| 文件上传 | Chrome 有基于 downloadId/路径的 `upload_file` 流程；Firefox 没有。 | `file_upload` 直接在文件输入上设置本地绝对路径；`upload_image` 通过引用或坐标上传捕获/用户图像。 |
+| 文件上传 | 两个浏览器都有 `upload_file`。Chrome 支持 `downloadId` 与绝对 `filePath`；Firefox 支持 `downloadId` 重新拉取以及侧栏用户文件选择器（无 CDP，因此不能设置任意本地路径）。 | `file_upload` 直接在文件输入上设置本地绝对路径；`upload_image` 通过引用或坐标上传捕获/用户图像。 |
 | 调度器 | `schedule_resume` 和 `schedule_task`。 | 存在定时任务 UI/提示字符串，但在可见工具列表中未恢复模型可调用的调度器模式。 |
 | 验证码 | 配置 CapSolver 后的 `solve_captcha`。 | 明确的安全提示要求尊重验证码，绝不绕过；未恢复求解工具。 |
 | 持久代理记忆 | `scratchpad_write`、`progress_update`、`progress_read`。 | 存在对话压缩；未恢复等效的草稿板/进度工具。 |