From 550a83b0bd927d53a38db5fd7dd2bbcd2c5259d0 Mon Sep 17 00:00:00 2001
From: Lexus2016 <Lexus2016@users.noreply.github.com>
Date: Tue, 10 Nov 2026 18:19:42 +0000
Subject: [PATCH] file viewer: a Copy action for the previewed file (#137)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The preview toolbar offered Download, Open and Share but no way to take the file's
content, so copying meant opening the file elsewhere or dragging through the pane by
hand. The Copy button appears only once the viewer has actually loaded text, and copies
exactly the string that was fetched — the pane itself is escaped HTML.

It also works for a remote project: the text is already in memory, so it never reaches
/api/files/raw or /api/files/download, which is what issue #57 refuses and why Download
and Share stay hidden there.

Strings are added for all five languages the SPA ships.
---
 package.json                   |   2 +-
 public/index.html              |  51 ++++++++---
 test/file-preview-copy.test.js | 149 +++++++++++++++++++++++++++++++++
 3 files changed, 189 insertions(+), 13 deletions(-)
 create mode 100644 test/file-preview-copy.test.js

diff --git a/package.json b/package.json
index 4fd7ecd..bfc9068 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
   "scripts": {
     "start": "node server.js",
     "dev": "node --watch server.js",
-    "test": "node --test test/render/*.test.mjs && node test/overload-detector.test.js && node test/usage-limit.test.js && node test/auth-errors.test.js && node test/env-load-order.test.js && node test/multi-agent-result.test.js && node test/terminal-session.test.js && node test/terminal-schema.test.js && node test/bots.test.js && node test/bot-inbox.test.js && node test/bots-api.test.js && node test/running-sessions.test.js && node test/session-liveness.test.js && node test/terminal-bridge.integration.test.js && node test/tmux-composite.test.js && node test/engine-spawn-cmd.test.js && node test/claude-firstrun.test.js && node test/telegram-format.test.js && node test/telegram-behaviour.test.js && node test/ask-user-question.test.js && node test/delegate-terminal.test.js && node test/agent-catalog.test.js && node test/update-flow.test.js && node test/kanban-schedule.test.js && node test/kanban-run-badges.test.js && node test/task-backlog.test.js && node test/i18n-completeness.test.js && node test/config-resolve.test.js && node test/chat-defaults.test.js && node test/chat-defaults-api.test.js && node test/run-continuation.test.js && node test/worktree-manager.test.js && node test/session-expiry.test.js && node test/setup-gate.test.js && node test/path-guard.test.js && node test/subscribe-nocatchup.test.js && node test/cli-import-remote.test.js && node test/remote-list-parse.test.js && node test/config-migrate.test.js && node test/engine-pane.test.js && node test/global-workspace.test.js && node test/ssh-secret.test.js && node test/agent-dag.test.js && node test/ssh-parser.test.js && node test/ssh-termination.test.js && node test/session-restart.test.js && node test/remote-env.test.js && node test/remote-files.test.js && node test/remote-files-api.test.js && node test/auth-token.test.js && node test/cmd-model.test.js && node test/origin-guard.test.js && node test/interrupted-recovery.test.js && node test/queue-persistence.test.js && node test/interrupt-idle-config.test.js && node test/agents-md.test.js && node test/editor-links.test.js && node test/editor-open-api.test.js && node test/interrupt-delivery.test.js && node test/terminal-pane-guard.integration.test.js && node test/composer-terminal.test.js && node test/claude-cli-status.test.js && node test/asar-helpers.test.js && node test/mac-signing.test.js && node test/release-mac.test.js && node test/task-workers.test.js && node test/git-clone.test.js && node test/responsive-ui.test.js && node test/kanban-delegation.test.js && node test/kanban-group-button.test.js && node test/terminal-keys.test.js && node test/electron-navigation.test.js && node test/cli-runtime.test.js && node test/worktree-safety.test.js && node test/auth-boundary.test.js && node test/cli-process-tree.test.js && node test/schedule-actions.test.js && node test/install-hooks.test.js && node test/frontend-recovery.test.js && node test/db-revisions.test.js && node test/frontend-refresh-races.test.js && node test/release-gate.test.js && node test/focused-workspace.test.js && node test/secondary-navigation.test.js && node test/section-controls-ux.test.js && node test/settings-ux.test.js && node test/team-forms-ux.test.js && node test/page-forms-ux.test.js && node test/sidebar-ux.test.js && node test/task-text-limit.test.js && node test/terminal-clipboard.test.js && node test/terminal-addons.test.js && node test/telegram-lang.test.js",
+    "test": "node --test test/render/*.test.mjs && node test/overload-detector.test.js && node test/usage-limit.test.js && node test/auth-errors.test.js && node test/env-load-order.test.js && node test/multi-agent-result.test.js && node test/terminal-session.test.js && node test/terminal-schema.test.js && node test/bots.test.js && node test/bot-inbox.test.js && node test/bots-api.test.js && node test/running-sessions.test.js && node test/session-liveness.test.js && node test/terminal-bridge.integration.test.js && node test/tmux-composite.test.js && node test/engine-spawn-cmd.test.js && node test/claude-firstrun.test.js && node test/telegram-format.test.js && node test/telegram-behaviour.test.js && node test/ask-user-question.test.js && node test/delegate-terminal.test.js && node test/agent-catalog.test.js && node test/update-flow.test.js && node test/kanban-schedule.test.js && node test/kanban-run-badges.test.js && node test/task-backlog.test.js && node test/i18n-completeness.test.js && node test/config-resolve.test.js && node test/chat-defaults.test.js && node test/chat-defaults-api.test.js && node test/run-continuation.test.js && node test/worktree-manager.test.js && node test/session-expiry.test.js && node test/setup-gate.test.js && node test/path-guard.test.js && node test/subscribe-nocatchup.test.js && node test/cli-import-remote.test.js && node test/remote-list-parse.test.js && node test/config-migrate.test.js && node test/engine-pane.test.js && node test/global-workspace.test.js && node test/ssh-secret.test.js && node test/agent-dag.test.js && node test/ssh-parser.test.js && node test/ssh-termination.test.js && node test/session-restart.test.js && node test/remote-env.test.js && node test/remote-files.test.js && node test/remote-files-api.test.js && node test/auth-token.test.js && node test/cmd-model.test.js && node test/origin-guard.test.js && node test/interrupted-recovery.test.js && node test/queue-persistence.test.js && node test/interrupt-idle-config.test.js && node test/agents-md.test.js && node test/editor-links.test.js && node test/editor-open-api.test.js && node test/interrupt-delivery.test.js && node test/terminal-pane-guard.integration.test.js && node test/composer-terminal.test.js && node test/claude-cli-status.test.js && node test/asar-helpers.test.js && node test/mac-signing.test.js && node test/release-mac.test.js && node test/task-workers.test.js && node test/git-clone.test.js && node test/responsive-ui.test.js && node test/kanban-delegation.test.js && node test/kanban-group-button.test.js && node test/terminal-keys.test.js && node test/electron-navigation.test.js && node test/cli-runtime.test.js && node test/worktree-safety.test.js && node test/auth-boundary.test.js && node test/cli-process-tree.test.js && node test/schedule-actions.test.js && node test/install-hooks.test.js && node test/frontend-recovery.test.js && node test/db-revisions.test.js && node test/frontend-refresh-races.test.js && node test/release-gate.test.js && node test/focused-workspace.test.js && node test/secondary-navigation.test.js && node test/section-controls-ux.test.js && node test/settings-ux.test.js && node test/team-forms-ux.test.js && node test/page-forms-ux.test.js && node test/sidebar-ux.test.js && node test/task-text-limit.test.js && node test/terminal-clipboard.test.js && node test/terminal-addons.test.js && node test/file-preview-copy.test.js && node test/telegram-lang.test.js",
     "postinstall": "node scripts/install-hooks.js",
     "release": "node scripts/release.js",
     "release:mac": "node scripts/release-mac.js",
diff --git a/public/index.html b/public/index.html
index 9d1ce3e..638be38 100644
--- a/public/index.html
+++ b/public/index.html
@@ -4175,6 +4175,10 @@ <h2 id="fpvTitle" style="font-size:14px;font-weight:600;overflow:hidden;text-ove
         <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>
         <span data-i18n="fpv.copy_img">Copy</span>
       </button>
+      <button class="fpv-btn" id="fpvCopyBtn" onclick="fpvCopyText()" style="display:none" data-i18n-title="fpv.copy.title" title="Copy file contents">
+        <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>
+        <span data-i18n="fpv.copy">Copy</span>
+      </button>
       <button class="fpv-btn" id="fpvDownloadBtn" onclick="fpvDownload()" data-i18n-title="fpv.download.title" title="Download file">
         <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
         <span data-i18n="fpv.download">Download</span>
@@ -5306,8 +5310,8 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
     'auto.title.on':'⚡ Auto-Skills: увімкнено — клік для вимкнення',
     'auto.title.off':'⚡ Auto-Skills: вимкнено — клік для увімкнення',
     'status.connected':'Підключено','status.generating':'Генерація…','status.thinking':'Обдумування...','status.processing':'Обробка...','status.classifying':'⚡ Визначення спеціалістів...','status.reconnecting':'Перепідключення…','status.stopped':'Зупинено','status.error':'Помилка',
-    'fpv.download':'Завантажити','fpv.download.title':'Завантажити файл','fpv.copy_img':'Копіювати','fpv.copy_img.title':'Скопіювати зображення в буфер','fpv.share':'Поділитись','fpv.share.title':'Поділитись / Скопіювати посилання','fpv.binary':'Бінарний файл — перегляд недоступний','fpv.img_error':'Помилка завантаження зображення','fpv.load_error':'Помилка завантаження файлу',
-    'toast.no_connection':'Немає з\'єднання','toast.sess_not_found':'Сесію не знайдено','toast.cfg_load_err':'Помилка завантаження конфігурації','toast.skill_uploaded':'✓ Скіл завантажено','toast.link_copied':'✓ Посилання скопійовано','toast.img_copied':'✓ Зображення скопійовано','toast.select_dir':'Виберіть директорію','toast.link_prompt':'Скопіюйте посилання:',
+    'fpv.download':'Завантажити','fpv.download.title':'Завантажити файл','fpv.copy_img':'Копіювати','fpv.copy_img.title':'Скопіювати зображення в буфер','fpv.copy':'Копіювати','fpv.copy.title':'Скопіювати вміст файлу','fpv.share':'Поділитись','fpv.share.title':'Поділитись / Скопіювати посилання','fpv.binary':'Бінарний файл — перегляд недоступний','fpv.img_error':'Помилка завантаження зображення','fpv.load_error':'Помилка завантаження файлу',
+    'toast.no_connection':'Немає з\'єднання','toast.sess_not_found':'Сесію не знайдено','toast.cfg_load_err':'Помилка завантаження конфігурації','toast.skill_uploaded':'✓ Скіл завантажено','toast.link_copied':'✓ Посилання скопійовано','toast.img_copied':'✓ Зображення скопійовано','toast.text_copied':'✓ Скопійовано в буфер','toast.select_dir':'Виберіть директорію','toast.link_prompt':'Скопіюйте посилання:',
     'at.no_project':'Оберіть проект, щоб шукати файли','at.searching':'Пошук...','at.search_err':'Помилка пошуку','at.no_files':'Файлів не знайдено','ssh.search':'Пошук SSH-сервера...','ssh.no_hosts':'SSH-сервери не налаштовано',
     'dir.this_dir':'. (ця директорія)','dir.no_subdirs':'Немає підпапок','dir.drives':'💻 Всі диски',
     'dir.path.ph':'Введіть шлях, напр. /Users/you/projects','dir.path.go':'Перейти','dir.filter.ph':'Фільтрувати папки...',
@@ -5764,8 +5768,8 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
     'auto.title.on':'⚡ Auto-Skills: enabled — click to disable',
     'auto.title.off':'⚡ Auto-Skills: disabled — click to enable',
     'status.connected':'Connected','status.generating':'Generating…','status.thinking':'Thinking...','status.processing':'Processing...','status.classifying':'⚡ Classifying specialists...','status.reconnecting':'Reconnecting…','status.stopped':'Stopped','status.error':'Error',
-    'fpv.download':'Download','fpv.download.title':'Download file','fpv.copy_img':'Copy','fpv.copy_img.title':'Copy image to clipboard','fpv.share':'Share','fpv.share.title':'Share / Copy link','fpv.binary':'Binary file — preview not available','fpv.img_error':'Image load error','fpv.load_error':'File load error',
-    'toast.no_connection':'No connection','toast.sess_not_found':'Session not found','toast.cfg_load_err':'Config load error','toast.skill_uploaded':'✓ Skill uploaded','toast.link_copied':'✓ Link copied','toast.img_copied':'✓ Image copied','toast.select_dir':'Select a directory','toast.link_prompt':'Copy link:',
+    'fpv.download':'Download','fpv.download.title':'Download file','fpv.copy_img':'Copy','fpv.copy_img.title':'Copy image to clipboard','fpv.copy':'Copy','fpv.copy.title':'Copy file contents','fpv.share':'Share','fpv.share.title':'Share / Copy link','fpv.binary':'Binary file — preview not available','fpv.img_error':'Image load error','fpv.load_error':'File load error',
+    'toast.no_connection':'No connection','toast.sess_not_found':'Session not found','toast.cfg_load_err':'Config load error','toast.skill_uploaded':'✓ Skill uploaded','toast.link_copied':'✓ Link copied','toast.img_copied':'✓ Image copied','toast.text_copied':'✓ Copied to clipboard','toast.select_dir':'Select a directory','toast.link_prompt':'Copy link:',
     'at.no_project':'Select a project to search files','at.searching':'Searching...','at.search_err':'Search error','at.no_files':'No files found','ssh.search':'Search SSH server...','ssh.no_hosts':'No SSH servers configured',
     'dir.this_dir':'. (this directory)','dir.no_subdirs':'No subdirectories','dir.drives':'💻 All Drives',
     'dir.path.ph':'Enter path, e.g. /Users/you/projects','dir.path.go':'Go','dir.filter.ph':'Filter folders...',
@@ -6222,8 +6226,8 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
     'auto.title.on':'⚡ Auto-Skills: включено — клик для отключения',
     'auto.title.off':'⚡ Auto-Skills: отключено — клик для включения',
     'status.connected':'Подключено','status.generating':'Генерация…','status.thinking':'Обдумывание...','status.processing':'Обработка...','status.classifying':'⚡ Определение специалистов...','status.reconnecting':'Переподключение…','status.stopped':'Остановлено','status.error':'Ошибка',
-    'fpv.download':'Скачать','fpv.download.title':'Скачать файл','fpv.copy_img':'Копировать','fpv.copy_img.title':'Скопировать изображение в буфер','fpv.share':'Поделиться','fpv.share.title':'Поделиться / Скопировать ссылку','fpv.binary':'Бинарный файл — предпросмотр недоступен','fpv.img_error':'Ошибка загрузки изображения','fpv.load_error':'Ошибка загрузки файла',
-    'toast.no_connection':'Нет соединения','toast.sess_not_found':'Сессия не найдена','toast.cfg_load_err':'Ошибка загрузки конфигурации','toast.skill_uploaded':'✓ Навык загружен','toast.link_copied':'✓ Ссылка скопирована','toast.img_copied':'✓ Изображение скопировано','toast.select_dir':'Выберите директорию','toast.link_prompt':'Скопируйте ссылку:',
+    'fpv.download':'Скачать','fpv.download.title':'Скачать файл','fpv.copy_img':'Копировать','fpv.copy_img.title':'Скопировать изображение в буфер','fpv.copy':'Копировать','fpv.copy.title':'Скопировать содержимое файла','fpv.share':'Поделиться','fpv.share.title':'Поделиться / Скопировать ссылку','fpv.binary':'Бинарный файл — предпросмотр недоступен','fpv.img_error':'Ошибка загрузки изображения','fpv.load_error':'Ошибка загрузки файла',
+    'toast.no_connection':'Нет соединения','toast.sess_not_found':'Сессия не найдена','toast.cfg_load_err':'Ошибка загрузки конфигурации','toast.skill_uploaded':'✓ Навык загружен','toast.link_copied':'✓ Ссылка скопирована','toast.img_copied':'✓ Изображение скопировано','toast.text_copied':'✓ Скопировано в буфер','toast.select_dir':'Выберите директорию','toast.link_prompt':'Скопируйте ссылку:',
     'at.no_project':'Выберите проект для поиска файлов','at.searching':'Поиск...','at.search_err':'Ошибка поиска','at.no_files':'Файлов не найдено','ssh.search':'Поиск SSH-сервера...','ssh.no_hosts':'SSH-серверы не настроены',
     'dir.this_dir':'. (эта директория)','dir.no_subdirs':'Нет подпапок','dir.drives':'💻 Все диски',
     'dir.path.ph':'Введите путь, напр. /Users/you/projects','dir.path.go':'Перейти','dir.filter.ph':'Фильтровать папки...',
@@ -6641,10 +6645,10 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
     "skills.auto_hint":"⚡ Les compétences sont sélectionnées automatiquement selon le texte de la tâche","auto.title.on":"⚡ Compétences auto : activées — cliquez pour désactiver",
     "auto.title.off":"⚡ Compétences auto : désactivées — cliquez pour activer","status.connected":"Connecté","status.generating":"Génération…","status.thinking":"Réflexion...",
     "status.processing":"Traitement...","status.classifying":"⚡ Classification des spécialistes...","status.reconnecting":"Reconnexion…","status.stopped":"Arrêté","status.error":"Erreur",
-    "fpv.download":"Télécharger","fpv.download.title":"Télécharger le fichier","fpv.copy_img":"Copier","fpv.copy_img.title":"Copier l'image dans le presse-papiers","fpv.share":"Partager",
+    "fpv.download":"Télécharger","fpv.download.title":"Télécharger le fichier","fpv.copy_img":"Copier","fpv.copy_img.title":"Copier l'image dans le presse-papiers","fpv.copy":"Copier","fpv.copy.title":"Copier le contenu du fichier","fpv.share":"Partager",
     "fpv.share.title":"Partager / Copier le lien","fpv.binary":"Fichier binaire — aperçu non disponible","fpv.img_error":"Erreur de chargement de l'image",
     "fpv.load_error":"Erreur de chargement du fichier","toast.no_connection":"Aucune connexion","toast.sess_not_found":"Session introuvable",
-    "toast.cfg_load_err":"Erreur de chargement de la configuration","toast.skill_uploaded":"✓ Compétence importée","toast.link_copied":"✓ Lien copié","toast.img_copied":"✓ Image copiée",
+    "toast.cfg_load_err":"Erreur de chargement de la configuration","toast.skill_uploaded":"✓ Compétence importée","toast.link_copied":"✓ Lien copié","toast.img_copied":"✓ Image copiée","toast.text_copied":"✓ Copié dans le presse-papiers",
     "toast.select_dir":"Sélectionnez un répertoire","toast.link_prompt":"Copier le lien :","at.no_project":"Sélectionnez un projet pour rechercher des fichiers","at.searching":"Recherche...",
     "at.search_err":"Erreur de recherche","at.no_files":"Aucun fichier trouvé","ssh.search":"Rechercher un serveur SSH...","ssh.no_hosts":"Aucun hôte SSH configuré","dir.this_dir":". (ce répertoire)",
     "dir.no_subdirs":"Aucun sous-répertoire","dir.drives":"💻 Tous les disques","dir.path.ph":"Saisissez un chemin, ex. /Users/you/projects","dir.path.go":"Aller",
@@ -6994,9 +6998,9 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
     "skill.active":"● ב-system prompt","skill.inactive":"○ לא פעיל","skill.del.title":"הסרת skill","skill.name_prompt":"שם ה-skill:","skills.auto_hint":"⚡ Skills נבחרים אוטומטית לפי טקסט המשימה",
     "auto.title.on":"⚡ Auto-Skills: פעיל — לחצו לכיבוי","auto.title.off":"⚡ Auto-Skills: כבוי — לחצו להפעלה","status.connected":"מחובר","status.generating":"יוצר…","status.thinking":"חושב...",
     "status.processing":"מעבד...","status.classifying":"⚡ מסווג מומחים...","status.reconnecting":"מתחבר מחדש…","status.stopped":"נעצר","status.error":"שגיאה","fpv.download":"הורדה",
-    "fpv.download.title":"הורדת קובץ","fpv.copy_img":"העתקה","fpv.copy_img.title":"העתקת תמונה ללוח","fpv.share":"שיתוף","fpv.share.title":"שיתוף / העתקת קישור",
+    "fpv.download.title":"הורדת קובץ","fpv.copy_img":"העתקה","fpv.copy_img.title":"העתקת תמונה ללוח","fpv.copy":"העתק","fpv.copy.title":"העתקת תוכן הקובץ","fpv.share":"שיתוף","fpv.share.title":"שיתוף / העתקת קישור",
     "fpv.binary":"קובץ בינארי — תצוגה מקדימה לא זמינה","fpv.img_error":"שגיאה בטעינת התמונה","fpv.load_error":"שגיאה בטעינת הקובץ","toast.no_connection":"אין חיבור","toast.sess_not_found":"הסשן לא נמצא",
-    "toast.cfg_load_err":"שגיאה בטעינת ההגדרות","toast.skill_uploaded":"✓ ה-skill הועלה","toast.link_copied":"✓ הקישור הועתק","toast.img_copied":"✓ התמונה הועתקה","toast.select_dir":"בחרו תיקייה",
+    "toast.cfg_load_err":"שגיאה בטעינת ההגדרות","toast.skill_uploaded":"✓ ה-skill הועלה","toast.link_copied":"✓ הקישור הועתק","toast.img_copied":"✓ התמונה הועתקה","toast.text_copied":"✓ הועתק ללוח","toast.select_dir":"בחרו תיקייה",
     "toast.link_prompt":"העתיקו קישור:","at.no_project":"בחרו פרויקט כדי לחפש קבצים","at.searching":"מחפש...","at.search_err":"שגיאת חיפוש","at.no_files":"לא נמצאו קבצים","ssh.search":"חיפוש שרת SSH...",
     "ssh.no_hosts":"לא הוגדרו hosts של SSH","dir.this_dir":". (התיקייה הזו)","dir.no_subdirs":"אין תת-תיקיות","dir.drives":"💻 כל הכוננים","dir.path.ph":"הזינו נתיב, לדוגמה /Users/you/projects",
     "dir.path.go":"מעבר","dir.filter.ph":"סינון תיקיות...","toast.read_err":"קריאה נכשלה: ","toast.err_prefix":"שגיאה: ","dir.proj_name":"שם הפרויקט (אוטומטי אם ריק)",
@@ -15993,14 +15997,18 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
 }
 
 let _fpvPath = '', _fpvName = '', _fpvIsImg = false;
+// What the last text/markdown preview fetched (issue #137). The viewer renders escaped
+// text, so a Copy action needs the raw string kept alongside it.
+let _fpvText = '';
 let _filePreviewSeq = 0;
 
 function closeFpv() {
   ++_filePreviewSeq;
   closeModalOverlay('filePreviewModal');
   $i('fpvBody').innerHTML = '';
-  _fpvPath = ''; _fpvName = ''; _fpvIsImg = false;
+  _fpvPath = ''; _fpvName = ''; _fpvIsImg = false; _fpvText = '';
   $i('fpvCopyImgBtn').style.display = 'none';
+  $i('fpvCopyBtn').style.display = 'none';
   // Restore what a remote file hid, or the next LOCAL file opens with no download.
   $i('fpvDownloadBtn').style.display = '';
   $i('fpvShareBtn').style.display = '';
@@ -16009,7 +16017,8 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
 
 async function openFilePreview(relPath, name) {
   const seq = ++_filePreviewSeq, gen = _switchGen;
-  _fpvPath = relPath;
+  _fpvPath = relPath; _fpvText = '';
+  $i('fpvCopyBtn').style.display = 'none';
   _fpvName = name || relPath.split('/').pop();
   const ext = (_fpvName.lastIndexOf('.') > 0 ? _fpvName.slice(_fpvName.lastIndexOf('.')).toLowerCase() : '');
   $i('fpvTitle').textContent = _fpvName;
@@ -16074,6 +16083,10 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
       body.innerHTML = `<div class="fpv-binary"><div style="font-size:40px">📦</div><div>${t(remote ? 'fpv.remote_binary' : 'fpv.binary')}</div><button class="fpv-btn" style="${remote ? 'display:none' : ''}" onclick="fpvDownload()"><svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2"><path d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg> ${t('fpv.download')}</button></div>`;
       return;
     }
+    // Only the text and markdown paths reach this point with content worth copying: a
+    // binary, image or PDF preview returned above with the button still hidden.
+    _fpvText = d.content || '';
+    $i('fpvCopyBtn').style.display = _fpvText ? '' : 'none';
     if (mdExts.includes(ext)) {
       body.innerHTML = `<div class="fpv-md msg">${renderMd(d.content || '')}</div>`;
     } else {
@@ -16099,6 +16112,20 @@ <h2 id="dlgModalTitle" data-i18n="dlg.title">Delegate to Agent</h2>
   if (_fpvPath && !_filesRemote) downloadFile(_fpvPath);
 }
 
+// Copy the text the viewer already loaded (issue #137). Works for a remote project too:
+// the text is in memory, so neither /api/files/raw nor /api/files/download is involved —
+// those are what issue #57 refuses, and why Download and Share are hidden for remote.
+async function fpvCopyText() {
+  if (!_fpvPath || !_fpvText) return;
+  try {
+    await copyText(_fpvText);
+    toast(t('toast.text_copied'));
+  } catch (e) {
+    console.error('Failed to copy file contents:', e);
+    toast(t('toast.err_prefix') + ' ' + t('fpv.copy'));
+  }
+}
+
 async function fpvShare() {
   if (!_fpvPath || _filesRemote) return;
   const url = location.origin + `/api/files/raw?${_filesQS(_fpvPath)}`;
diff --git a/test/file-preview-copy.test.js b/test/file-preview-copy.test.js
new file mode 100644
index 0000000..1ab3d10
--- /dev/null
+++ b/test/file-preview-copy.test.js
@@ -0,0 +1,149 @@
+'use strict';
+// Issue #137 — a Copy action in the file preview viewer.
+//
+// The viewer's functions are RUN, not regex-matched: the file-preview block is cut out of
+// public/index.html and evaluated in a vm with a stubbed fetch, $i and clipboard. What must
+// hold:
+//   - the toolbar carries a Copy button that is hidden until there is text to copy;
+//   - a text or markdown preview shows it and copies exactly the content that was fetched,
+//     not the escaped DOM;
+//   - a binary, image or PDF preview leaves it hidden, and an empty file has nothing to copy;
+//   - closing the viewer hides it and clears the stored text, so a stale path cannot be copied;
+//   - the copy path is the shared copyText(), which also works over plain http.
+//
+// Run: node test/file-preview-copy.test.js
+const assert = require('assert');
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+
+let pass = 0, fail = 0;
+function check(label, actual, expected) {
+  try { assert.deepStrictEqual(actual, expected); pass++; console.log(`  ok   ${label}`); }
+  catch { fail++; console.error(`  FAIL ${label} — expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`); }
+}
+
+const html = fs.readFileSync(path.join(__dirname, '..', 'public', 'index.html'), 'utf8');
+
+console.log('toolbar:');
+{
+  const btn = html.match(/<button class="fpv-btn" id="fpvCopyBtn"[^>]*>/);
+  check('the copy button exists', !!btn, true);
+  check('it starts hidden', btn ? /style="display:none"/.test(btn[0]) : null, true);
+  check('it calls fpvCopyText()', btn ? /onclick="fpvCopyText\(\)"/.test(btn[0]) : null, true);
+  check('its label is translated', /data-i18n="fpv\.copy"/.test(html), true);
+  check('it sits in the preview toolbar, before Download',
+    html.indexOf('id="fpvCopyBtn"') < html.indexOf('id="fpvDownloadBtn"'), true);
+}
+
+const start = html.indexOf("let _fpvPath = '', _fpvName = '', _fpvIsImg = false;");
+const end = html.indexOf('async function copyImageToClipboard(', start);
+assert.ok(start > 0 && end > start, 'file-preview block not found in public/index.html');
+const BLOCK = html.slice(start, end);
+
+function makeViewer(respond) {
+  const els = new Map();
+  const copied = [], toasts = [];
+  const $i = id => {
+    if (!els.has(id)) els.set(id, { style: {}, textContent: '', innerHTML: '' });
+    return els.get(id);
+  };
+  const sandbox = {
+    console,
+    fetch: async () => ({ json: async () => respond() }),
+    $i,
+    t: k => k,
+    escH: s => String(s),
+    renderMd: s => s,
+    _filesQS: () => 'path=x',
+    _filesRemote: false,
+    _switchGen: 0,
+    openModalOverlay() {},
+    closeModalOverlay() {},
+    toast: m => toasts.push(m),
+    copyText: async text => { copied.push(text); },
+    __els: els, __copied: copied, __toasts: toasts,
+  };
+  vm.createContext(sandbox);
+  vm.runInContext(BLOCK + '\nthis.__api = { openFilePreview, fpvCopyText, closeFpv };', sandbox);
+  return sandbox;
+}
+
+const shown = ctx => ctx.__els.get('fpvCopyBtn').style.display;
+
+(async () => {
+  console.log('\nbehaviour:');
+  {
+    const text = makeViewer(() => ({ content: 'line one\nline two\n' }));
+    await text.__api.openFilePreview('notes.txt', 'notes.txt');
+    check('a text file shows the button', shown(text), '');
+    await text.__api.fpvCopyText();
+    check('copying hands over the fetched content', text.__copied, ['line one\nline two\n']);
+    check('and reports it', text.__toasts, ['toast.text_copied']);
+  }
+
+  {
+    const md = makeViewer(() => ({ content: '# Title\n\nbody' }));
+    await md.__api.openFilePreview('README.md', 'README.md');
+    check('a markdown preview shows the button', shown(md), '');
+    await md.__api.fpvCopyText();
+    check('markdown is copied as source, not rendered HTML', md.__copied, ['# Title\n\nbody']);
+  }
+
+  {
+    const empty = makeViewer(() => ({ content: '' }));
+    await empty.__api.openFilePreview('empty.txt', 'empty.txt');
+    check('an empty file hides it (there is nothing to copy)', shown(empty), 'none');
+    await empty.__api.fpvCopyText();
+    check('and copying is a no-op', empty.__copied, []);
+  }
+
+  {
+    const binary = makeViewer(() => ({ content: '[Binary]' }));
+    await binary.__api.openFilePreview('app.exe', 'app.exe');
+    check('a binary preview stays hidden', shown(binary), 'none');
+  }
+
+  {
+    const img = makeViewer(() => ({ content: '' }));
+    await img.__api.openFilePreview('photo.png', 'photo.png');
+    check('an image preview stays hidden', shown(img), 'none');
+  }
+
+  {
+    const pdf = makeViewer(() => ({ content: '' }));
+    await pdf.__api.openFilePreview('doc.pdf', 'doc.pdf');
+    check('a PDF preview stays hidden', shown(pdf), 'none');
+  }
+
+  {
+    const refused = makeViewer(() => ({ error: 'Path outside the project' }));
+    await refused.__api.openFilePreview('x.txt', 'x.txt');
+    check('a refused read leaves it hidden', shown(refused), 'none');
+  }
+
+  {
+    const reuse = makeViewer(() => ({ content: 'kept' }));
+    await reuse.__api.openFilePreview('a.txt', 'a.txt');
+    check('opening a text file shows the button', shown(reuse), '');
+    reuse.__api.closeFpv();
+    check('closing hides the button', shown(reuse), 'none');
+    await reuse.__api.fpvCopyText();
+    check('a closed viewer copies nothing', reuse.__copied, []);
+  }
+
+  {
+    // The handler reads the text out of the viewer state, so a path that points somewhere
+    // else after a failed copy attempt must not resurrect the previous file's text.
+    const stale = makeViewer(() => ({ content: 'first' }));
+    await stale.__api.openFilePreview('one.txt', 'one.txt');
+    stale.fetch = async () => ({ json: async () => ({ error: 'gone' }) });
+    await stale.__api.openFilePreview('two.txt', 'two.txt');
+    check('reopening a file that fails to load hides the button', shown(stale), 'none');
+    await stale.__api.fpvCopyText();
+    check('and the previous file is not copied in its place', stale.__copied, []);
+  }
+
+  console.log(`\n${pass} passed, ${fail} failed`);
+  process.exit(fail ? 1 : 0);
+})();