jaitus 0.3.5 → 0.3.6

package/README.md

@@ -119,7 +119,9 @@ scrolls to the line you pick.
 
 **Pasting.** Right-click or `Ctrl+V` pastes the clipboard; a long paste becomes a
 `[#1 pasted 120 lines]` chip (the full text is sent). **Images:** drag an image file
-onto the terminal, paste a copied screenshot with `Alt+V`, type `/image path.png`, or
+onto the terminal, paste a copied screenshot (`Alt+V` on Windows — Windows Terminal and
+VS Code keep `Ctrl+V` for themselves; `Ctrl+V` on macOS and Linux, where `Cmd+V` /
+`Ctrl+Shift+V` belong to the terminal), type `/image path.png`, or
 mention `@screenshot.png` — each becomes an `[Image #N]` chip listed under the
 composer. Backspace over a chip removes it; only images whose chip is still in the
 message are sent. Screenshots over 3.5 MB are shrunk automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaitus",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Jaitus — a coding agent in your terminal.",
   "type": "module",
   "bin": {

package/src/tui-ink.js

@@ -373,6 +373,15 @@ function layoutTranscript(state, width, height, top) {
   return { visible, pad, screenTop };
 }
 
+/**
+ * The key that pastes an image here. Windows Terminal and VS Code keep Ctrl+V for their
+ * own text paste, so on Windows it is Alt+V; on macOS Cmd+V is the terminal's and Ctrl+V
+ * reaches the app (Option+V types "√" unless Option is set to act as Meta).
+ */
+export function imagePasteHint(platform = process.platform) {
+  return platform === 'win32' ? 'alt+v paste image' : 'ctrl+v paste image';
+}
+
 /**
  * How to select text, in words that are true for THIS terminal.
  *
@@ -704,7 +713,10 @@ function StatusBar({ state, width }) {
       : [
         ['ctrl+p palette', p.faint],
         ['shift+tab mode', p.faint],
-        ['ctrl+l clear', p.faint],
+        // How to paste a screenshot was written only in the README, and the key people
+        // try first (Ctrl+V in Windows Terminal, Cmd+V on a Mac) belongs to the terminal,
+        // which has no text to paste and sends the app nothing.
+        [imagePasteHint(), p.faint],
         ['esc esc rewind', p.faint],
         // Mouse reporting takes the terminal's own text selection away, so the way to
         // get it back has to be on screen — otherwise the first thing a new user
@@ -1280,7 +1292,9 @@ export function createTui({ slashCommands = [], fileProvider = null, meta = {},
    */
   function handlePaste(text) {
     const value = String(text ?? '').replace(/\r\n?/g, '\n');
-    if (!value) return;
+    // An empty paste is what a terminal sends for its paste key when the clipboard holds
+    // only an image — it has no text to give. The image is right there: fetch it.
+    if (!value) { void pasteFromClipboard({ imageOnly: true }); return; }
     // Dragging image files onto the terminal pastes their paths: attach them instead.
     const images = imagePathsIn(value);
     if (images) { void attachImageFiles(images); return; }
@@ -1323,7 +1337,7 @@ export function createTui({ slashCommands = [], fileProvider = null, meta = {},
         await attachImageFiles([file], { name: 'clipboard image' });
         return;
       }
-      flash(imageOnly ? 'No image on the clipboard' : 'The clipboard is empty', 'info', 1600);
+      flash(imageOnly ? 'No image on the clipboard — copy a screenshot first' : `The clipboard is empty · ${imagePasteHint()}`, 'info', 1800);
     } catch {
       flash('Could not read the clipboard', 'warn', 2000);
     } finally {