@phenx-inc/ctlsurf 0.13.1 → 0.13.5

package/out/renderer/assets/{javascript-XyDWi6dC.js → javascript-8RyFDDdk.js}

@@ -1,5 +1,5 @@
-import { conf as conf$1, language as language$1 } from "./typescript-CB71AtAT.js";
-import "./index-MqgBcJzy.js";
+import { conf as conf$1, language as language$1 } from "./typescript-BrdIiKZf.js";
+import "./index-CMb4AqkZ.js";
 const conf = conf$1;
 const language = {
   // Set defaultToken to invalid to see what you do not tokenize yet

package/out/renderer/assets/{jsonMode-DZT5gBVW.js → jsonMode-CqspkWCb.js}

@@ -1,6 +1,6 @@
-import { c as createWebWorker, l as languages, e as editor } from "./index-MqgBcJzy.js";
-import { f as DocumentFormattingEditProvider, g as DocumentRangeFormattingEditProvider, C as CompletionAdapter, H as HoverAdapter, b as DocumentSymbolAdapter, d as DocumentColorAdapter, F as FoldingRangeAdapter, S as SelectionRangeAdapter, e as DiagnosticsAdapter } from "./lspLanguageFeatures-BYkg2Yc-.js";
-import { a, D, h, R, c, i, j, t, k } from "./lspLanguageFeatures-BYkg2Yc-.js";
+import { c as createWebWorker, l as languages, e as editor } from "./index-CMb4AqkZ.js";
+import { f as DocumentFormattingEditProvider, g as DocumentRangeFormattingEditProvider, C as CompletionAdapter, H as HoverAdapter, b as DocumentSymbolAdapter, d as DocumentColorAdapter, F as FoldingRangeAdapter, S as SelectionRangeAdapter, e as DiagnosticsAdapter } from "./lspLanguageFeatures-Czkp5sZb.js";
+import { a, D, h, R, c, i, j, t, k } from "./lspLanguageFeatures-Czkp5sZb.js";
 const STOP_WHEN_IDLE_FOR = 2 * 60 * 1e3;
 class WorkerManager {
   constructor(defaults) {

package/out/renderer/assets/{liquid-BuajCNJ9.js → liquid-DaEnAsYY.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const EMPTY_ELEMENTS = [
   "area",
   "base",

package/out/renderer/assets/{lspLanguageFeatures-BYkg2Yc-.js → lspLanguageFeatures-Czkp5sZb.js}

@@ -1,4 +1,4 @@
-import { R as Range$1, l as languages, e as editor, U as Uri, M as MarkerSeverity } from "./index-MqgBcJzy.js";
+import { R as Range$1, l as languages, e as editor, U as Uri, M as MarkerSeverity } from "./index-CMb4AqkZ.js";
 var DocumentUri;
 (function(DocumentUri2) {
   function is(value) {

package/out/renderer/assets/{mdx-D0Qx2GMS.js → mdx-Q-qSZsFg.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const conf = {
   comments: {
     blockComment: ["{/*", "*/}"]

package/out/renderer/assets/{python-ChncNy6S.js → python-Sw0S0BJV.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const conf = {
   comments: {
     lineComment: "#",

package/out/renderer/assets/{razor-C6MUtfaS.js → razor-C7zQmabz.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const EMPTY_ELEMENTS = [
   "area",
   "base",

package/out/renderer/assets/{tsMode-C2aMdzdU.js → tsMode-BWdOxk6v.js}

@@ -1,4 +1,4 @@
-import { c as createWebWorker, e as editor, U as Uri, a as MarkerTag, M as MarkerSeverity, l as languages, t as typescriptDefaults, R as Range } from "./index-MqgBcJzy.js";
+import { c as createWebWorker, e as editor, U as Uri, a as MarkerTag, M as MarkerSeverity, l as languages, t as typescriptDefaults, R as Range } from "./index-CMb4AqkZ.js";
 class WorkerManager {
   constructor(_modeId, _defaults) {
     this._modeId = _modeId;

package/out/renderer/assets/{typescript-CB71AtAT.js → typescript-BrdIiKZf.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const conf = {
   wordPattern: /(-?\d*\.\d\w*)|([^\`\~\!\@\#\%\^\&\*\(\)\-\=\+\[\{\]\}\\\|\;\:\'\"\,\.\<\>\/\?\s]+)/g,
   comments: {

package/out/renderer/assets/{xml-tHS1Ec9w.js → xml-DbKLNPOq.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const conf = {
   comments: {
     blockComment: ["<!--", "-->"]

package/out/renderer/assets/{yaml-CZcp5ueF.js → yaml-ehupJBsZ.js}

@@ -1,4 +1,4 @@
-import { l as languages } from "./index-MqgBcJzy.js";
+import { l as languages } from "./index-CMb4AqkZ.js";
 const conf = {
   comments: {
     lineComment: "#"

package/out/renderer/index.html

@@ -49,8 +49,8 @@
       color: #565f89;
     }
   </style>
-  <script type="module" crossorigin src="./assets/index-MqgBcJzy.js"></script>
-  <link rel="stylesheet" crossorigin href="./assets/index-Bi_MjBqs.css">
+  <script type="module" crossorigin src="./assets/index-CMb4AqkZ.js"></script>
+  <link rel="stylesheet" crossorigin href="./assets/index-BEekQe3-.css">
 </head>
 <body>
   <div id="boot-splash">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenx-inc/ctlsurf",
-  "version": "0.13.1",
+  "version": "0.13.5",
   "description": "Agent-agnostic terminal and desktop app for ctlsurf — run Claude Code, Codex, or any coding agent with live session logging and remote control",
   "main": "out/main/index.js",
   "bin": {
@@ -38,7 +38,7 @@
     "node-pty",
     "xterm"
   ],
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "engines": {
     "node": ">=18"
   },

package/src/main/bridge.ts

@@ -1,6 +1,7 @@
 import { WorkerWsClient } from './workerWs'
 import { Terminal as HeadlessTerminal } from '@xterm/headless/lib-headless/xterm-headless.js'
 import { SerializeAddon } from '@xterm/addon-serialize'
+import { log } from './logger'
 
 /**
  * Conversation Bridge
@@ -36,7 +37,7 @@ export class ConversationBridge {
     this.inputBuffer = ''
     this.terminalCapture.reset()
     this.sessionActive = true
-    console.log('[bridge] Session started')
+    log('[bridge] Session started')
   }
 
   feedOutput(data: string): void {
@@ -137,7 +138,7 @@ export class ConversationBridge {
     this.sessionActive = false
     this.inputBuffer = ''
     this.outputBuffer = ''
-    console.log('[bridge] Session ended')
+    log('[bridge] Session ended')
   }
 }
 

package/src/main/headless.ts

@@ -184,13 +184,15 @@ async function main() {
     }, 1000)
   }
 
-  // Pipe stdin to PTY, with Ctrl+\ as the exit key
-  // SGR mouse wheel: \x1b[<64;col;rowM = scroll up, \x1b[<65;col;rowM = scroll down
-  const SCROLL_UP_RE = /\x1b\[<64;\d+;\d+M/
-  const SCROLL_DOWN_RE = /\x1b\[<65;\d+;\d+M/
-  // Use mouse wheel events directly — forward as SGR mouse to the PTY
-  // so the inner app can handle them natively
-
+  // Pipe stdin to PTY, with Ctrl+\ as the exit key.
+  // The inner agent enables mouse tracking on startup, and that enable
+  // sequence is passed through to the host terminal — so the terminal forwards
+  // every wheel tick to us as an SGR mouse event (\x1b[<64;col;rowM up,
+  // \x1b[<65;col;rowM down) instead of scrolling its own scrollback. Forward
+  // those (and all other mouse input) to the PTY so the agent that asked for
+  // them can scroll its transcript natively. Dropping them severed scrolling
+  // entirely: the terminal won't scroll (it thinks the app owns the mouse) and
+  // the app never received the events.
   if (process.stdin.isTTY) {
     process.stdin.setRawMode(true)
     process.stdin.resume()
@@ -201,12 +203,6 @@ async function main() {
         shutdown()
         return
       }
-      // Drop mouse wheel events — Claude Code doesn't support mouse scrolling.
-      // Scrolling is handled by the terminal emulator natively when not in
-      // alternate screen, or not at all in alternate screen (Claude Code's TUI).
-      if (SCROLL_UP_RE.test(str) || SCROLL_DOWN_RE.test(str)) {
-        return
-      }
       orchestrator.writePty(HEADLESS_TAB, str)
     })
   }

package/src/main/index.ts

@@ -289,6 +289,12 @@ ipcMain.handle('clipboard:writeTable', (_event, html: string, text: string) => {
   return { ok: true }
 })
 
+// Plain-text clipboard write, for the terminal right-click "Copy" item.
+ipcMain.handle('clipboard:writeText', (_event, text: string) => {
+  clipboard.writeText(text)
+  return { ok: true }
+})
+
 ipcMain.handle('pty:spawn', async (_event, tabId: string, agent: AgentConfig, cwd: string) => {
   await orchestrator.spawnAgent(tabId, agent, cwd)
   return { ok: true }

package/src/main/pty.ts

@@ -1,5 +1,6 @@
 import { createRequire } from 'module'
 import { AgentConfig } from './agents'
+import { log } from './logger'
 
 // Use createRequire to load native module at runtime, bypassing bundler
 const require = createRequire(import.meta.url)
@@ -14,11 +15,7 @@ export class PtyManager {
     const shell = agent.command
     const args = agent.args || []
 
-    try {
-      console.log(`[pty] Spawning: ${shell} ${args.join(' ')} in ${cwd}`)
-    } catch {
-      // Ignore EPIPE errors when stdout is closed
-    }
+    log(`[pty] Spawning: ${shell} ${args.join(' ')} in ${cwd}`)
 
     this.process = pty.spawn(shell, args, {
       name: 'xterm-256color',

package/src/main/ticketStore.ts

@@ -1,4 +1,5 @@
 import type { CtlsurfApi } from './ctlsurfApi'
+import { log as baseLog } from './logger'
 
 const DATASTORE_TITLE = 'Tickets'
 const AGENT_DATASTORE_PAGE_TITLE = 'Agent Datastore'
@@ -47,7 +48,7 @@ export interface Ticket {
 }
 
 function log(...args: unknown[]): void {
-  try { console.log('[ticket-store]', ...args) } catch { /* EPIPE safe */ }
+  baseLog('[ticket-store]', ...args)
 }
 
 function findPageByTitle(pages: any[], title: string): any | null {

package/src/main/timeTracker.ts

@@ -1,6 +1,7 @@
 import os from 'os'
 import { randomUUID } from 'crypto'
 import type { CtlsurfApi } from './ctlsurfApi'
+import { log as baseLog } from './logger'
 
 const DATASTORE_TITLE = 'Time Tracking'
 const AGENT_DATASTORE_PAGE_TITLE = 'Agent Datastore'
@@ -56,7 +57,9 @@ function isSameLocalDay(a: number, b: number): boolean {
 }
 
 function log(...args: unknown[]): void {
-  try { console.log('[time-tracker]', ...args) } catch { /* EPIPE safe */ }
+  // Route through the shared logger so terminal/TUI mode (setSilent) suppresses
+  // these — they'd otherwise corrupt the PTY display the agent owns.
+  baseLog('[time-tracker]', ...args)
 }
 
 function findPageByTitle(pages: any[], title: string): any | null {

package/src/main/transcripts.ts

@@ -1,6 +1,7 @@
 import fs from 'fs'
 import path from 'path'
 import os from 'os'
+import { log } from './logger'
 
 /**
  * Transcript Tailer
@@ -80,7 +81,7 @@ export class TranscriptTailer {
     this.sinceMs = Date.now()
     this.files.clear()
     this.pollTimer = setInterval(() => this.poll(), POLL_INTERVAL_MS)
-    console.log(`[transcripts] Tailing ${this.agentId} transcripts for ${this.cwd}`)
+    log(`[transcripts] Tailing ${this.agentId} transcripts for ${this.cwd}`)
   }
 
   stop(): void {
@@ -90,7 +91,7 @@ export class TranscriptTailer {
     // Final drain so messages written just before exit aren't lost.
     this.poll()
     this.files.clear()
-    console.log('[transcripts] Stopped')
+    log('[transcripts] Stopped')
   }
 
   private poll(): void {

package/src/preload/index.ts

@@ -83,6 +83,8 @@ const api = {
   // Clipboard — write a rich-HTML table (+ plain-text fallback) for email paste.
   copyEmailTable: (html: string, text: string): Promise<{ ok: boolean }> =>
     ipcRenderer.invoke('clipboard:writeTable', html, text),
+  copyText: (text: string): Promise<{ ok: boolean }> =>
+    ipcRenderer.invoke('clipboard:writeText', text),
   getVersion: (): Promise<string> =>
     ipcRenderer.invoke('app:getVersion'),
   getUpdateInfo: (): Promise<{ current: string; latest: string | null; hasUpdate: boolean; checkedAt: number | null }> =>

package/src/renderer/App.tsx

@@ -88,6 +88,7 @@ declare global {
       getUpdateInfo: () => Promise<UpdateInfo>
       onUpdateInfo: (callback: (info: UpdateInfo) => void) => () => void
       copyEmailTable: (html: string, text: string) => Promise<{ ok: boolean }>
+      copyText: (text: string) => Promise<{ ok: boolean }>
     }
   }
 }

package/src/renderer/components/SettingsDialog.tsx

@@ -33,6 +33,7 @@ export function SettingsDialog({ open, onClose }: SettingsDialogProps) {
   const [trackTime, setTrackTime] = useState(false)
   const [idleTimeoutMin, setIdleTimeoutMin] = useState(15)
   const [saved, setSaved] = useState(false)
+  const [version, setVersion] = useState('')
 
   const loadProfiles = async () => {
     const data = await window.worker.listProfiles() as ProfileListResponse
@@ -45,6 +46,7 @@ export function SettingsDialog({ open, onClose }: SettingsDialogProps) {
       loadProfiles()
       setEditingId(null)
       setSaved(false)
+      window.worker.getVersion().then(setVersion).catch(() => { /* ignore */ })
     }
   }, [open])
 
@@ -235,6 +237,17 @@ export function SettingsDialog({ open, onClose }: SettingsDialogProps) {
             </div>
           </div>
         )}
+
+        <div className="settings-section settings-about">
+          <h4>About</h4>
+          <div className="about-name">ctlsurf{version ? ` · v${version}` : ''}</div>
+          <p className="about-copyright">© 2026 Phenx, Inc. All rights reserved.</p>
+          <p className="settings-hint">
+            Proprietary and confidential. No license to use, copy, modify, or
+            distribute is granted except under a separate written agreement with
+            Phenx, Inc.
+          </p>
+        </div>
       </div>
     </div>
   )

package/src/renderer/components/SpeakControls.tsx

@@ -40,6 +40,11 @@ export function SpeakControls({ remote = false }: { remote?: boolean }) {
     return () => { alive = false }
   }, [])
 
+  // Neural is the default engine; preload its model in the background on launch
+  // so the first spoken text isn't stalled by the one-time download. No-op when
+  // the user has explicitly switched to the system voice.
+  useEffect(() => { speech.warmup() }, [])
+
   // Speak replies as they arrive. Main only forwards when the setting is on, so
   // this is a no-op while disabled.
   useEffect(() => {

package/src/renderer/components/TerminalPanel.tsx

@@ -4,22 +4,58 @@ import { FitAddon } from '@xterm/addon-fit'
 import { WebLinksAddon } from '@xterm/addon-web-links'
 import '@xterm/xterm/css/xterm.css'
 import { convertToEmailTable } from '../lib/tableToHtml'
+import { speech } from '../lib/speech'
 
-// Convert the terminal's current selection into a rich HTML table on the
-// clipboard. Broadcasts an `email-table-result` event so the active panel can
-// show a toast. Reused by both the hotkey and the right-click menu.
-function copySelectionAsEmailTable(terminal: Terminal): void {
-  const result = convertToEmailTable(terminal.getSelection())
+// Show a transient toast in the active terminal panel. Broadcast as a window
+// event so module-level helpers (which have no component scope) can trigger it.
+function showTerminalToast(message: string): void {
+  window.dispatchEvent(new CustomEvent('terminal-toast', { detail: { message } }))
+}
+
+// ─── Text actions — operate on a plain string, which may be an xterm
+// selection (menu/shortcuts) or a DOM selection from the snapshot panel ───
+
+function copyTextValue(text: string): void {
+  if (!text) return
+  void window.worker.copyText(text)
+  showTerminalToast('Copied to clipboard')
+}
+
+function convertTextToTable(text: string): void {
+  const result = convertToEmailTable(text)
   if (result) {
     window.worker.copyEmailTable(result.html, result.text)
+    showTerminalToast(`Copied ${result.rows}×${result.cols} table to clipboard`)
+  } else {
+    showTerminalToast('No table found in selection')
   }
-  window.dispatchEvent(
-    new CustomEvent('email-table-result', {
-      detail: result
-        ? { ok: true, message: `Copied ${result.rows}×${result.cols} table to clipboard` }
-        : { ok: false, message: 'No table found in selection' },
-    })
-  )
+}
+
+// unlock() is called from the triggering gesture so the neural voice isn't
+// autoplay-blocked.
+function speakTextValue(text: string): void {
+  if (!text.trim()) return
+  speech.unlock()
+  speech.enqueue(text)
+}
+
+// xterm-selection wrappers for the right-click menu and keyboard shortcuts.
+function copySelectionPlain(terminal: Terminal): void { copyTextValue(terminal.getSelection()) }
+function copySelectionAsEmailTable(terminal: Terminal): void { convertTextToTable(terminal.getSelection()) }
+function speakSelection(terminal: Terminal): void { speakTextValue(terminal.getSelection()) }
+
+// Snapshot the visible screen as plain text. xterm selections don't survive a
+// repainting TUI (Claude Code), so the snapshot panel freezes this text into a
+// static, normally-selectable surface instead.
+function captureVisibleText(terminal: Terminal): string {
+  const buf = terminal.buffer.active
+  const lines: string[] = []
+  for (let i = 0; i < terminal.rows; i++) {
+    const line = buf.getLine(buf.viewportY + i)
+    lines.push(line ? line.translateToString(true) : '')
+  }
+  while (lines.length && lines[lines.length - 1].trim() === '') lines.pop()
+  return lines.join('\n')
 }
 
 // Custom handler for links clicked in the terminal. Every clicked URL is routed
@@ -163,20 +199,33 @@ function getOrCreateTerminal(tabId: string, onExit: (tabId: string) => void): {
   terminal.loadAddon(fitAddon)
   terminal.loadAddon(new WebLinksAddon(handleTerminalLink))
 
-  // ⌘/Ctrl+Shift+E → convert the current selection to an email table. Handled
-  // here (not as a DOM listener) so it works even while a mouse-tracking TUI
-  // is running, where right-click is forwarded to the program instead.
+  // Selection actions via ⌘/Ctrl+Shift+[C|E|S] → copy / convert-to-table /
+  // read-aloud. Handled here (not as DOM listeners) so they work even while a
+  // mouse-tracking TUI is running, where right-click and mouse selection are
+  // forwarded to the program instead.
   terminal.attachCustomKeyEventHandler((e) => {
     if (e.type !== 'keydown') return true
     // Buffer-scroll keys count as a user gesture (see onScroll).
     if (e.key === 'PageUp' || e.key === 'PageDown' || e.key === 'Home' || e.key === 'End') {
       markGesture(tabId)
     }
-    const isCombo = (e.metaKey || e.ctrlKey) && e.shiftKey && e.code === 'KeyE'
-    if (!isCombo) return true
-    e.preventDefault()
-    copySelectionAsEmailTable(terminal)
-    return false // consume — don't forward to the pty
+    const mod = (e.metaKey || e.ctrlKey) && e.shiftKey
+    if (mod && e.code === 'KeyE') {
+      e.preventDefault()
+      copySelectionAsEmailTable(terminal)
+      return false // consume — don't forward to the pty
+    }
+    if (mod && e.code === 'KeyC' && terminal.hasSelection()) {
+      e.preventDefault()
+      copySelectionPlain(terminal)
+      return false
+    }
+    if (mod && e.code === 'KeyS' && terminal.getSelection().trim()) {
+      e.preventDefault()
+      speakSelection(terminal)
+      return false
+    }
+    return true
   })
 
   const state: TermState = {
@@ -261,6 +310,11 @@ export function destroyTerminal(tabId: string): void {
 export function TerminalPanel({ tabId, agent, onSpawn, onExit, isActive }: TerminalPanelProps) {
   const containerRef = useRef<HTMLDivElement>(null)
   const [menu, setMenu] = useState<{ x: number; y: number } | null>(null)
+  // Snapshot panel: the ⋮ button freezes the visible screen text into a static,
+  // selectable overlay where Copy/Table/Speak work even over a repainting TUI
+  // (which wipes live xterm selections). snapTextRef holds the frozen text.
+  const [snapOpen, setSnapOpen] = useState(false)
+  const snapTextRef = useRef('')
   const [toast, setToast] = useState<string | null>(null)
   // Mirrors the terminal's follow-mode; drives the "jump to latest" overlay,
   // which only shows while the user has scrolled up.
@@ -274,29 +328,60 @@ export function TerminalPanel({ tabId, agent, onSpawn, onExit, isActive }: Termi
     s.terminal.focus()
   }
 
-  // Right-click → offer "Copy as email table", but only when the current
-  // selection actually parses as a table; otherwise fall through to default.
+  // Right-click on a non-empty selection → show Copy / Convert to table /
+  // Read it. With nothing selected we let the native menu through.
   const handleContextMenu = (e: React.MouseEvent) => {
     const sel = _terminals.get(tabId)?.terminal.getSelection() ?? ''
-    if (!convertToEmailTable(sel)) return
+    if (!sel.trim()) return
     e.preventDefault()
     setMenu({ x: e.clientX, y: e.clientY })
   }
 
+  // Right-click menu actions (act on the live xterm selection — only reliable
+  // over static output / a plain shell, not a repainting TUI).
+  const runCopy = () => {
+    const term = _terminals.get(tabId)?.terminal
+    if (term) copySelectionPlain(term)
+    setMenu(null)
+  }
+
   const runConvert = () => {
     const term = _terminals.get(tabId)?.terminal
     if (term) copySelectionAsEmailTable(term)
     setMenu(null)
   }
 
-  // Show a transient toast when a conversion happens (hotkey or menu).
+  const runSpeak = () => {
+    const term = _terminals.get(tabId)?.terminal
+    if (term) speakSelection(term)
+    setMenu(null)
+  }
+
+  // Snapshot panel: freeze the visible screen, then act on the user's DOM
+  // selection within it (or the whole snapshot if nothing is selected).
+  const openSnapshot = () => {
+    const term = _terminals.get(tabId)?.terminal
+    snapTextRef.current = term ? captureVisibleText(term) : ''
+    setSnapOpen(true)
+  }
+
+  const snapAction = (kind: 'copy' | 'table' | 'speak') => {
+    const domSel = window.getSelection()?.toString() ?? ''
+    const text = domSel.trim() ? domSel : snapTextRef.current
+    if (kind === 'copy') copyTextValue(text)
+    else if (kind === 'table') convertTextToTable(text)
+    else speakTextValue(text)
+  }
+
+  // Show a transient toast on a terminal action (copy / table), fired by the
+  // module-level helpers as a window event.
   useEffect(() => {
-    const onResult = (e: Event) => {
-      const detail = (e as CustomEvent).detail as { ok: boolean; message: string } | null
-      if (detail) setToast(detail.message)
+    const onToast = (e: Event) => {
+      const detail = (e as CustomEvent).detail as { message?: string } | null
+      if (detail?.message) setToast(detail.message)
     }
-    window.addEventListener('email-table-result', onResult)
-    return () => window.removeEventListener('email-table-result', onResult)
+    window.addEventListener('terminal-toast', onToast)
+    return () => window.removeEventListener('terminal-toast', onToast)
   }, [])
 
   useEffect(() => {
@@ -445,11 +530,47 @@ export function TerminalPanel({ tabId, agent, onSpawn, onExit, isActive }: Termi
             ↓ Latest
           </button>
         )}
+        <button
+          type="button"
+          className="term-util-btn"
+          onMouseDown={(e) => { e.preventDefault(); openSnapshot() }}
+          title="Snapshot screen → copy / convert to table / read aloud"
+        >
+          ⋮
+        </button>
+        {snapOpen && (
+          <div className="term-snapshot">
+            <div className="term-snapshot-head">
+              <span>Select text below (or select nothing to use everything), then pick an action.</span>
+              <button
+                type="button"
+                className="term-snapshot-x"
+                onMouseDown={(e) => { e.preventDefault(); setSnapOpen(false) }}
+                title="Close"
+              >
+                ✕
+              </button>
+            </div>
+            <pre className="term-snapshot-text">{snapTextRef.current}</pre>
+            <div className="term-snapshot-actions">
+              <button type="button" onMouseDown={(e) => { e.preventDefault(); snapAction('copy') }}>⧉ Copy</button>
+              <button type="button" onMouseDown={(e) => { e.preventDefault(); snapAction('table') }}>▦ Convert to table</button>
+              <button type="button" onMouseDown={(e) => { e.preventDefault(); snapAction('speak') }}>🔊 Read aloud</button>
+              <button type="button" className="term-snapshot-done" onMouseDown={(e) => { e.preventDefault(); setSnapOpen(false) }}>Close</button>
+            </div>
+          </div>
+        )}
       </div>
       {menu && (
         <div className="term-context-menu" style={{ position: 'fixed', left: menu.x, top: menu.y }}>
+          <button type="button" onMouseDown={(e) => { e.preventDefault(); runCopy() }}>
+            Copy
+          </button>
           <button type="button" onMouseDown={(e) => { e.preventDefault(); runConvert() }}>
-            Copy as email table
+            Convert to table
+          </button>
+          <button type="button" onMouseDown={(e) => { e.preventDefault(); runSpeak() }}>
+            Read it
           </button>
         </div>
       )}

package/src/renderer/lib/speech.ts

@@ -78,7 +78,8 @@ function splitIntoChunks(text: string): string[] {
 // ─── Preferences ─────────────────────────────────────
 
 export function getEngine(): TtsEngineId {
-  try { return localStorage.getItem(ENGINE_KEY) === 'neural' ? 'neural' : 'web' } catch { return 'web' }
+  // Default to the neural voice; only an explicit 'web' choice opts back out.
+  try { return localStorage.getItem(ENGINE_KEY) === 'web' ? 'web' : 'neural' } catch { return 'neural' }
 }
 export function setEngine(id: TtsEngineId): void {
   try { localStorage.setItem(ENGINE_KEY, id) } catch { /* ignore */ }