Parallelize clipboard file-path and text reads in doPaste

Now that the standalone reads clipboard text natively, the file-first
ordering no longer protects against the WKWebView paste prompt and can
run alongside the text read. Image stays sequential since it allocates
a temp file.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: nedtwigg

lib/src/lib/clipboard.test.ts

@@ -31,14 +31,13 @@ describe('doPaste three-tier fallthrough', () => {
     });
   });
 
-  it('uses file refs when present and never reads text or image', async () => {
+  it('prefers file refs over text and skips the image read', async () => {
     mocks.readClipboardFilePaths.mockResolvedValue(['/tmp/a.png', '/tmp/b file.png']);
-    mocks.readText.mockResolvedValue('should not be read');
+    mocks.readText.mockResolvedValue('coexisting text payload');
     mocks.readClipboardImageAsFilePath.mockResolvedValue('/tmp/img.png');
 
     await doPaste('t1');
 
-    expect(mocks.readText).not.toHaveBeenCalled();
     expect(mocks.readClipboardImageAsFilePath).not.toHaveBeenCalled();
     expect(mocks.writePty).toHaveBeenCalledTimes(1);
     expect(mocks.writePty).toHaveBeenCalledWith('t1', '/tmp/a.png /tmp/b\\ file.png ');

lib/src/lib/clipboard.ts

@@ -84,24 +84,24 @@ async function readTextFromClipboard(): Promise<string> {
 
 /**
  * Read the clipboard and write its contents to the PTY, honoring the inside
- * program's bracketed-paste mode when enabled (spec §8.5). Falls through from
- * file references → plain text → raw image (saved to a temp file) so a
- * Cmd+V of a Finder file or a screenshot both type a usable path.
+ * program's bracketed-paste mode when enabled (spec §8.5). Prefers file
+ * references over plain text (a Finder Cmd+V types the path, not "Document.pdf"
+ * as a name string), with raw images saved to a temp file as a last resort.
  *
- * Files are checked before text so that a file-ref clipboard never reaches
- * `navigator.clipboard.readText()` — on macOS WKWebView that call can trigger
- * a native paste-permission popup when the clipboard came from another app.
+ * File-path and text reads run in parallel since they're independent IPC
+ * roundtrips; the image read is sequential because it allocates a temp file.
  */
 export async function doPaste(terminalId: string): Promise<void> {
   const platform = getPlatform();
 
-  const paths = await platform.readClipboardFilePaths().catch(() => null);
+  const [paths, text] = await Promise.all([
+    platform.readClipboardFilePaths().catch(() => null),
+    readTextFromClipboard(),
+  ]);
   if (paths && paths.length > 0) {
     pasteFilePaths(terminalId, paths);
     return;
   }
-
-  const text = await readTextFromClipboard();
   if (text) {
     writePasteToPty(terminalId, text);
     return;