termux-dev 1.5.0 → 1.8.0

package/assets/preview.svg

@@ -0,0 +1,94 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 940 658" width="100%" role="img" aria-label="The devx terminal interface">
+  <title>devx terminal interface</title>
+  <defs>
+    <clipPath id="clip"><rect x="8" y="8" width="924" height="642" rx="14"/></clipPath>
+  </defs>
+  <style>
+    .t { font-family: 'JetBrains Mono','Fira Code','SF Mono',ui-monospace,Menlo,Consolas,'DejaVu Sans Mono',monospace; font-size: 14px; white-space: pre; }
+    .b { font-weight: 700; }
+    .i { font-style: italic; }
+    .cur { animation: blink 1.1s steps(1) infinite; }
+    @keyframes blink { 0%,55% { opacity: 1 } 56%,100% { opacity: 0 } }
+    .spin { animation: pulse 1.6s ease-in-out infinite; }
+    @keyframes pulse { 0%,100% { opacity: 1 } 50% { opacity: .35 } }
+    @media (prefers-reduced-motion: reduce) { .cur, .spin { animation: none } }
+  </style>
+  <rect x="8" y="8" width="924" height="642" rx="14" fill="#000000"/>
+  <g clip-path="url(#clip)">
+    <rect x="8" y="8" width="924" height="34" fill="#0b0b0d"/>
+    <rect x="8" y="41" width="924" height="1" fill="#1a1a1f"/>
+  </g>
+  <rect x="8.5" y="8.5" width="923" height="641" rx="14" fill="none" stroke="#23252c"/>
+  <circle cx="30" cy="25" r="6" fill="#ff5f57"/><circle cx="50" cy="25" r="6" fill="#febc2e"/><circle cx="70" cy="25" r="6" fill="#28c840"/>
+  <text x="470.0" y="30" text-anchor="middle" class="t" fill="#6b7686" style="font-size:12.5px">devx  ~/Projects/shop</text>
+  <rect x="28.0" y="45.0" width="453.6" height="93.0" rx="7" fill="none" stroke="#3b4456" stroke-width="1.3"/>
+  <rect x="28.0" y="170.0" width="882.0" height="22.0" rx="3" fill="#101014"/>
+  <rect x="61.6" y="279.0" width="436.8" height="93.0" rx="7" fill="none" stroke="#3b4456" stroke-width="1.3"/>
+  <rect x="66.0" y="273.0" width="125.6" height="19" fill="#000000"/>
+  <rect x="28.0" y="538.0" width="882.0" height="45.0" rx="9" fill="none" stroke="#3b4456" stroke-width="1.3"/>
+  <rect x="32.4" y="530.0" width="83.6" height="19" fill="#000000"/>
+  <rect x="603.6" y="530.0" width="293.6" height="19" fill="#000000"/>
+  <rect x="32.4" y="574.0" width="150.8" height="19" fill="#000000"/>
+  <rect x="595.2" y="574.0" width="243.2" height="19" fill="#000000"/>
+  <text x="44.8" y="62.0" class="t" fill="#b794f6">▌</text>
+  <text x="61.6" y="62.0" class="t b" fill="#f4f7fb">devx</text>
+  <text x="112.0" y="62.0" class="t" fill="#5f6b7a">v1.8.0</text>
+  <text x="61.6" y="106.0" class="t" fill="#5f6b7a">model</text>
+  <text x="128.8" y="106.0" class="t" fill="#e5eaf1">deepseek-v4.1-flash · think high</text>
+  <text x="406.0" y="106.0" class="t" fill="#5f6b7a">/model</text>
+  <text x="61.6" y="128.0" class="t" fill="#5f6b7a">cwd</text>
+  <text x="128.8" y="128.0" class="t" fill="#e5eaf1">~/Projects/shop</text>
+  <text x="36.4" y="156.0" class="t b" fill="#b794f6">tip</text>
+  <text x="78.4" y="156.0" class="t" fill="#9aa6b4">/rewind goes back to one of your messages</text>
+  <text x="36.4" y="186.0" class="t b" fill="#b794f6">❯</text>
+  <text x="53.2" y="186.0" class="t" fill="#e5eaf1">add a dark mode toggle to the settings page</text>
+  <text x="44.8" y="214.0" class="t" fill="#5f6b7a">∴</text>
+  <text x="61.6" y="214.0" class="t" fill="#5f6b7a">thought for 2.1s · 148 tok · 71 tok/s</text>
+  <text x="380.8" y="214.0" class="t i" fill="#5f6b7a">(ctrl+p to expand)</text>
+  <text x="36.4" y="244.0" class="t" fill="#5ed3e0">●</text>
+  <text x="53.2" y="244.0" class="t" fill="#f4f7fb">I'll check how settings are stored, then add the toggle.</text>
+  <text x="53.2" y="274.0" class="t" fill="#b794f6">◆</text>
+  <text x="70.0" y="274.0" class="t b" fill="#f4f7fb">Update</text>
+  <text x="128.8" y="274.0" class="t" fill="#9aa6b4">Plan &amp; Tasks</text>
+  <text x="78.4" y="296.0" class="t b" fill="#5ed3e0">Plan &amp; Tasks</text>
+  <text x="448.0" y="296.0" class="t" fill="#9aa6b4">1/3</text>
+  <text x="78.4" y="318.0" class="t" fill="#4ade80">[✓]</text>
+  <text x="112.0" y="318.0" class="t" fill="#5f6b7a">read the settings module</text>
+  <text x="78.4" y="340.0" class="t b" fill="#b794f6">[•]</text>
+  <text x="112.0" y="340.0" class="t b" fill="#f4f7fb">add the toggle and persist it</text>
+  <text x="78.4" y="362.0" class="t" fill="#5f6b7a">[ ]</text>
+  <text x="112.0" y="362.0" class="t" fill="#e5eaf1">run the tests</text>
+  <text x="53.2" y="392.0" class="t" fill="#b794f6">◆</text>
+  <text x="70.0" y="392.0" class="t b" fill="#f4f7fb">Read</text>
+  <text x="120.4" y="392.0" class="t" fill="#e5eaf1">src/settings.ts</text>
+  <text x="70.0" y="414.0" class="t" fill="#5f6b7a">╰</text>
+  <text x="86.8" y="414.0" class="t" fill="#9aa6b4">84 lines</text>
+  <text x="53.2" y="436.0" class="t" fill="#b794f6">◆</text>
+  <text x="70.0" y="436.0" class="t b" fill="#f4f7fb">Run</text>
+  <text x="112.0" y="436.0" class="t" fill="#e5eaf1">npm test</text>
+  <text x="70.0" y="458.0" class="t" fill="#5f6b7a">╰</text>
+  <text x="86.8" y="458.0" class="t" fill="#9aa6b4">24 passed</text>
+  <text x="86.8" y="480.0" class="t" fill="#5f6b7a">… +3 lines (ctrl+o to expand)</text>
+  <text x="44.8" y="512.0" class="t spin" fill="#5ed3e0">⠹</text>
+  <text x="61.6" y="512.0" class="t" fill="#e5eaf1">Writing</text>
+  <text x="145.6" y="512.0" class="t" fill="#5f6b7a">(12s · ↓ 1.4k tokens · ctrl+c to stop)</text>
+  <text x="44.8" y="544.0" class="t" fill="#5ed3e0">●</text>
+  <text x="61.6" y="544.0" class="t b" fill="#5ed3e0">agent</text>
+  <text x="607.6" y="544.0" class="t" fill="#9aa6b4">deepseek-v4.1-flash · think high</text>
+  <text x="44.8" y="566.0" class="t b" fill="#b794f6">❯</text>
+  <text x="70.0" y="566.0" class="t" fill="#5f6b7a">Ask or describe a task…</text>
+  <text x="44.8" y="588.0" class="t" fill="#9aa6b4">~/Projects/shop</text>
+  <text x="607.6" y="588.0" class="t" fill="#5f6b7a">ctx</text>
+  <text x="649.6" y="588.0" class="t" fill="#5ed3e0">━━━━</text>
+  <text x="683.2" y="588.0" class="t" fill="#3b4456">────</text>
+  <text x="733.6" y="588.0" class="t" fill="#9aa6b4">4% · $0.0123</text>
+  <text x="36.4" y="610.0" class="t" fill="#e5eaf1">tab</text>
+  <text x="70.0" y="610.0" class="t" fill="#5f6b7a">plan mode</text>
+  <text x="162.4" y="610.0" class="t" fill="#e5eaf1">/</text>
+  <text x="179.2" y="610.0" class="t" fill="#5f6b7a">commands</text>
+  <text x="271.6" y="610.0" class="t" fill="#e5eaf1">@</text>
+  <text x="288.4" y="610.0" class="t" fill="#5f6b7a">files</text>
+  <text x="355.6" y="610.0" class="t" fill="#e5eaf1">ctrl+c</text>
+  <text x="414.4" y="610.0" class="t" fill="#5f6b7a">stop</text>
+  <rect class="cur" x="61.6" y="553.0" width="8.4" height="17" fill="#5ed3e0"/>
+</svg>

package/dist/cli/banner.js

@@ -1,13 +1,17 @@
 import pc from 'picocolors';
 import { getCurrentTheme } from './theme.js';
-export function renderBannerLines(mode = 'full', version = '1.5.0', cols = 80) {
+import { DEVX_VERSION } from '../core/types.js';
+export function renderBannerLines(mode = 'full', version = DEVX_VERSION, cols = 80) {
     if (mode === 'off') {
         return [];
     }
     const theme = getCurrentTheme();
+    if (mode === 'clean') {
+        return [pc.bold('devx') + pc.dim(`  v${version}`)];
+    }
     if (mode === 'minimal') {
         return [
-            theme.colorFn('⚡ ') + theme.boldFn('TERMUX·DEV') + ' ' + pc.dim(`v${version}`) + pc.dim(' · Type /help for commands')
+            theme.boldFn('TERMUX·DEV') + ' ' + pc.dim(`v${version}`) + pc.dim(' · Type /help for commands')
         ];
     }
     // Full ASCII Banner
@@ -29,7 +33,7 @@ export function renderBannerLines(mode = 'full', version = '1.5.0', cols = 80) {
         indent + theme.boldFn(`v${version}`)
     ];
 }
-export function drawBanner(mode = 'full', version = '1.5.0', cols = 80) {
+export function drawBanner(mode = 'full', version = DEVX_VERSION, cols = 80) {
     const lines = renderBannerLines(mode, version, cols);
     if (lines.length > 0) {
         console.log();

package/dist/cli/clipboard-write.js

@@ -0,0 +1,55 @@
+import { spawn } from 'child_process';
+import os from 'os';
+export const runWriter = (command, args, input) => new Promise((resolve) => {
+    try {
+        const child = spawn(command, args, { stdio: ['pipe', 'ignore', 'ignore'] });
+        let settled = false;
+        const done = (ok) => { if (!settled) {
+            settled = true;
+            resolve(ok);
+        } };
+        const timer = setTimeout(() => { try {
+            child.kill();
+        }
+        catch { } done(false); }, 5000);
+        child.on('error', () => { clearTimeout(timer); done(false); });
+        child.on('close', (code) => { clearTimeout(timer); done(code === 0); });
+        child.stdin.on('error', () => { });
+        child.stdin.end(input);
+    }
+    catch {
+        resolve(false);
+    }
+});
+/** The OSC 52 sequence for a text: the terminal puts it on the clipboard. */
+export function osc52Sequence(text) {
+    return `\x1b]52;c;${Buffer.from(text, 'utf8').toString('base64')}\x07`;
+}
+const OSC52_MAX_BYTES = 74000; // many terminals refuse more than ~100 KB of base64
+export async function copyToClipboard(text, ctx = {}) {
+    const platform = ctx.platform ?? os.platform();
+    const env = ctx.env ?? process.env;
+    const run = ctx.run ?? runWriter;
+    const write = ctx.write ?? ((t) => process.stdout.write(t));
+    const candidates = [];
+    if (env.TERMUX_VERSION || env.PREFIX?.includes('com.termux'))
+        candidates.push(['termux', 'termux-clipboard-set', []]);
+    if (platform === 'darwin')
+        candidates.push(['pbcopy', 'pbcopy', []]);
+    else if (platform === 'win32')
+        candidates.push(['powershell', 'powershell', ['-NoProfile', '-Command', 'Set-Clipboard -Value ([Console]::In.ReadToEnd())']]);
+    else {
+        if (env.WAYLAND_DISPLAY)
+            candidates.push(['wl-copy', 'wl-copy', []]);
+        candidates.push(['xclip', 'xclip', ['-selection', 'clipboard']], ['xsel', 'xsel', ['--clipboard', '--input']]);
+    }
+    for (const [method, command, args] of candidates) {
+        if (await run(command, args, text))
+            return method;
+    }
+    if (Buffer.byteLength(text, 'utf8') <= OSC52_MAX_BYTES) {
+        write(osc52Sequence(text));
+        return 'osc52';
+    }
+    return 'none';
+}

package/dist/cli/clipboard.js

@@ -2,8 +2,20 @@ import fs from 'fs/promises';
 import fsSync from 'fs';
 import path from 'path';
 import os from 'os';
-import { exec } from 'child_process';
-const MEDIA_DIR = path.join(process.cwd(), '.devx', 'media');
+import { execFile } from 'child_process';
+/**
+ * Images and text from the system clipboard, and image files pasted as paths.
+ *
+ * Pasted images are stored in `~/.devx/media` (not in the project folder, so nothing is left
+ * behind in the user's repository). The prompt shows them as `[Image #1 203kb]` and the
+ * message carries the file path, which is what resolveAtMentions turns into a real image part.
+ */
+export const MEDIA_DIR = path.join(os.homedir(), '.devx', 'media');
+/** Formats the image APIs accept. */
+export const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif']);
+/** The text that stands for an image in the prompt, and how to find it again. */
+export const IMAGE_TAG_SOURCE = '\\[Image #\\d+ [^\\]\\n]{1,12}\\]';
+export const imageTag = (index, sizeStr) => `[Image #${index} ${sizeStr}]`;
 export function expandHomePath(p) {
     if (!p)
         return p;
@@ -22,124 +34,188 @@ export function formatFileSize(bytes) {
     const mb = (bytes / (1024 * 1024)).toFixed(1);
     return `${mb}mb`;
 }
+/** The format of an image by its first bytes; the clipboard's own type name is not trusted. */
+export function sniffImage(buf) {
+    if (buf.length < 12)
+        return null;
+    if (buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47)
+        return { ext: 'png', mime: 'image/png' };
+    if (buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff)
+        return { ext: 'jpg', mime: 'image/jpeg' };
+    if (buf.toString('latin1', 0, 4) === 'GIF8')
+        return { ext: 'gif', mime: 'image/gif' };
+    if (buf.toString('latin1', 0, 4) === 'RIFF' && buf.toString('latin1', 8, 12) === 'WEBP')
+        return { ext: 'webp', mime: 'image/webp' };
+    return null;
+}
+/** A name that is safe in a path typed after "@" and unique across sessions. */
+function newImageName(ext, taken) {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    const stamp = `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+    let name = `image-${stamp}.${ext}`;
+    for (let i = 2; taken.has(name) || fsSync.existsSync(path.join(MEDIA_DIR, name)); i++)
+        name = `image-${stamp}-${i}.${ext}`;
+    return name;
+}
+/** Letters, digits, dot, dash and underscore only: such a name always survives an "@mention". */
+export function safeFileName(name) {
+    const cleaned = name.replace(/[^A-Za-z0-9._-]+/g, '_').replace(/^\.+/, '');
+    return cleaned || 'image.png';
+}
 export function getUniqueImageName(baseName, existingNames) {
-    if (!existingNames.has(baseName)) {
-        return baseName;
-    }
-    const ext = path.extname(baseName);
-    const nameWithoutExt = path.basename(baseName, ext);
-    let copyIndex = 1;
-    while (true) {
-        const candidate = copyIndex === 1
-            ? `${nameWithoutExt}(copy)${ext}`
-            : `${nameWithoutExt}(copy ${copyIndex})${ext}`;
-        if (!existingNames.has(candidate)) {
+    const safe = safeFileName(baseName);
+    if (!existingNames.has(safe) && !fsSync.existsSync(path.join(MEDIA_DIR, safe)))
+        return safe;
+    const ext = path.extname(safe);
+    const stem = path.basename(safe, ext);
+    for (let i = 2;; i++) {
+        const candidate = `${stem}-${i}${ext}`;
+        if (!existingNames.has(candidate) && !fsSync.existsSync(path.join(MEDIA_DIR, candidate)))
             return candidate;
-        }
-        copyIndex++;
     }
 }
-export async function saveClipboardImage(preferredName = 'image.png', existingNames) {
-    if (!fsSync.existsSync(MEDIA_DIR)) {
-        await fs.mkdir(MEDIA_DIR, { recursive: true });
+export const runTool = (command, args) => new Promise((resolve) => {
+    try {
+        execFile(command, args, { encoding: 'buffer', maxBuffer: 64 * 1024 * 1024, timeout: 8000 }, (err, stdout) => {
+            resolve(err ? null : stdout);
+        });
     }
-    const uniqueName = getUniqueImageName(preferredName, existingNames);
-    const targetPath = path.join(MEDIA_DIR, uniqueName);
-    return new Promise((resolve) => {
-        const isWindows = os.platform() === 'win32';
-        const isMac = os.platform() === 'darwin';
-        if (isWindows) {
-            const psScript = `
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-$img = [System.Windows.Forms.Clipboard]::GetImage()
-if ($img -ne $null) {
-    $img.Save('${targetPath.replace(/\\/g, '\\\\')}', [System.Drawing.Imaging.ImageFormat]::Png)
-    Write-Output "SAVED"
-} else {
-    Write-Output "NO_IMAGE"
+    catch {
+        resolve(null);
+    }
+});
+const IMAGE_PREFERENCE = ['image/png', 'image/jpeg', 'image/webp', 'image/gif'];
+function pickImageType(types) {
+    const lower = types.map((t) => t.trim().toLowerCase());
+    for (const wanted of IMAGE_PREFERENCE)
+        if (lower.includes(wanted))
+            return wanted;
+    // image/jpg, image/x-png and similar spellings
+    return lower.find((t) => /^image\/(png|jpe?g|webp|gif)/.test(t)) ?? null;
 }
-`;
-            const b64 = Buffer.from(psScript, 'utf16le').toString('base64');
-            exec(`powershell.exe -NoProfile -NonInteractive -EncodedCommand ${b64}`, (err, stdout) => {
-                if (!err && stdout.includes('SAVED') && fsSync.existsSync(targetPath)) {
-                    const stat = fsSync.statSync(targetPath);
-                    resolve({
-                        fileName: uniqueName,
-                        filePath: targetPath,
-                        size: stat.size,
-                        sizeStr: formatFileSize(stat.size)
-                    });
-                }
-                else {
-                    resolve(null);
-                }
-            });
-        }
-        else if (isMac) {
-            exec(`pngpaste "${targetPath}"`, (err) => {
-                if (!err && fsSync.existsSync(targetPath)) {
-                    const stat = fsSync.statSync(targetPath);
-                    resolve({
-                        fileName: uniqueName,
-                        filePath: targetPath,
-                        size: stat.size,
-                        sizeStr: formatFileSize(stat.size)
-                    });
-                }
-                else {
-                    resolve(null);
-                }
-            });
-        }
-        else {
-            // Linux / Termux: try xclip / wl-paste
-            exec(`xclip -selection clipboard -t image/png -o > "${targetPath}" 2>/dev/null || wl-paste -t image/png > "${targetPath}" 2>/dev/null`, () => {
-                if (fsSync.existsSync(targetPath)) {
-                    const stat = fsSync.statSync(targetPath);
-                    if (stat.size > 100) {
-                        return resolve({
-                            fileName: uniqueName,
-                            filePath: targetPath,
-                            size: stat.size,
-                            sizeStr: formatFileSize(stat.size)
-                        });
-                    }
-                    try {
-                        fsSync.unlinkSync(targetPath);
-                    }
-                    catch { }
-                }
-                resolve(null);
-            });
-        }
+/** The raw bytes of the image on the clipboard, or null when there is none (or no tool to read it). */
+export async function readClipboardImageBytes(run = runTool, ctx = { platform: os.platform(), env: process.env }) {
+    const { platform, env } = ctx;
+    if (platform === 'win32') {
+        const script = [
+            'Add-Type -AssemblyName System.Windows.Forms',
+            'Add-Type -AssemblyName System.Drawing',
+            '$img = [System.Windows.Forms.Clipboard]::GetImage()',
+            'if ($img -ne $null) { $ms = New-Object System.IO.MemoryStream; $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png); [Console]::OpenStandardOutput().Write($ms.ToArray(), 0, $ms.Length) }',
+        ].join('; ');
+        return run('powershell.exe', ['-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(script, 'utf16le').toString('base64')]);
+    }
+    if (platform === 'darwin') {
+        return run('pngpaste', ['-']);
+    }
+    // Termux has no way to read an image from the clipboard.
+    if (env.PREFIX?.includes('com.termux'))
+        return null;
+    const wayland = !!env.WAYLAND_DISPLAY;
+    const attempts = [];
+    if (wayland) {
+        attempts.push(async () => {
+            const list = await run('wl-paste', ['--list-types']);
+            const type = list ? pickImageType(list.toString('utf8').split('\n')) : null;
+            return type ? run('wl-paste', ['--no-newline', '--type', type]) : null;
+        });
+    }
+    attempts.push(async () => {
+        const list = await run('xclip', ['-selection', 'clipboard', '-t', 'TARGETS', '-o']);
+        const type = list ? pickImageType(list.toString('utf8').split('\n')) : null;
+        return type ? run('xclip', ['-selection', 'clipboard', '-t', type, '-o']) : null;
     });
+    if (!wayland) {
+        attempts.push(async () => {
+            const list = await run('wl-paste', ['--list-types']);
+            const type = list ? pickImageType(list.toString('utf8').split('\n')) : null;
+            return type ? run('wl-paste', ['--no-newline', '--type', type]) : null;
+        });
+    }
+    for (const attempt of attempts) {
+        const bytes = await attempt();
+        if (bytes && bytes.length > 0)
+            return bytes;
+    }
+    return null;
+}
+/** The text on the clipboard, or null. Used when Ctrl+V arrives as a key and the terminal did not paste. */
+export async function readClipboardText(run = runTool, ctx = { platform: os.platform(), env: process.env }) {
+    const { platform, env } = ctx;
+    let out = null;
+    if (platform === 'win32')
+        out = await run('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', 'Get-Clipboard -Raw']);
+    else if (platform === 'darwin')
+        out = await run('pbpaste', []);
+    else if (env.PREFIX?.includes('com.termux'))
+        out = await run('termux-clipboard-get', []);
+    else {
+        if (env.WAYLAND_DISPLAY)
+            out = await run('wl-paste', ['--no-newline', '--type', 'text']);
+        out ??= await run('xclip', ['-selection', 'clipboard', '-o']);
+        out ??= await run('xsel', ['--clipboard', '--output']);
+        if (!env.WAYLAND_DISPLAY)
+            out ??= await run('wl-paste', ['--no-newline', '--type', 'text']);
+    }
+    const text = out?.toString('utf8') ?? '';
+    return text.length > 0 ? text : null;
+}
+async function store(bytes, name) {
+    await fs.mkdir(MEDIA_DIR, { recursive: true, mode: 0o700 });
+    const filePath = path.join(MEDIA_DIR, name);
+    await fs.writeFile(filePath, bytes, { mode: 0o600 });
+    return { fileName: name, filePath, size: bytes.length, sizeStr: formatFileSize(bytes.length) };
 }
+/**
+ * Saves the image on the clipboard to ~/.devx/media.
+ * `_preferredName` is kept for older callers; the file is named by the time and its real format.
+ */
+export async function saveClipboardImage(_preferredName, existingNames, run = runTool, ctx) {
+    const bytes = await readClipboardImageBytes(run, ctx);
+    if (!bytes)
+        return null;
+    const kind = sniffImage(bytes);
+    if (!kind)
+        return null;
+    return store(bytes, newImageName(kind.ext, existingNames));
+}
+/** Copies an image file (a pasted or dropped path) into ~/.devx/media under a safe name. */
 export async function processPastedFilePath(rawPath, existingNames) {
     const cleanPath = expandHomePath(rawPath).trim().replace(/^['"&]+|['"]+$/g, '').trim();
     const resolved = path.resolve(process.cwd(), cleanPath);
-    const imageExts = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif', '.svg', '.bmp']);
     const ext = path.extname(resolved).toLowerCase();
-    if (imageExts.has(ext) && fsSync.existsSync(resolved)) {
-        try {
-            const stat = fsSync.statSync(resolved);
-            if (stat.isFile()) {
-                const baseName = path.basename(resolved);
-                const uniqueName = getUniqueImageName(baseName, existingNames);
-                if (!fsSync.existsSync(MEDIA_DIR)) {
-                    await fs.mkdir(MEDIA_DIR, { recursive: true });
+    if (!IMAGE_EXTENSIONS.has(ext))
+        return null;
+    try {
+        const stat = await fs.stat(resolved);
+        if (!stat.isFile())
+            return null;
+        await fs.mkdir(MEDIA_DIR, { recursive: true, mode: 0o700 });
+        const name = getUniqueImageName(path.basename(resolved), existingNames);
+        await fs.copyFile(resolved, path.join(MEDIA_DIR, name));
+        return { fileName: name, filePath: path.join(MEDIA_DIR, name), size: stat.size, sizeStr: formatFileSize(stat.size) };
+    }
+    catch {
+        return null;
+    }
+}
+/** Deletes pasted images older than `days` days. Never throws. */
+export async function pruneMedia(days = 14, now = Date.now()) {
+    let removed = 0;
+    try {
+        for (const entry of await fs.readdir(MEDIA_DIR)) {
+            const file = path.join(MEDIA_DIR, entry);
+            try {
+                const stat = await fs.stat(file);
+                if (stat.isFile() && now - stat.mtimeMs > days * 86_400_000) {
+                    await fs.unlink(file);
+                    removed++;
                 }
-                const targetPath = path.join(MEDIA_DIR, uniqueName);
-                await fs.copyFile(resolved, targetPath);
-                return {
-                    fileName: uniqueName,
-                    filePath: targetPath,
-                    size: stat.size,
-                    sizeStr: formatFileSize(stat.size)
-                };
             }
+            catch { }
         }
-        catch { }
     }
-    return null;
+    catch { }
+    return removed;
 }

package/dist/cli/colors.js

@@ -0,0 +1,67 @@
+import pc from 'picocolors';
+/**
+ * Colour helpers for themes.
+ *
+ * Themes are defined as hex values. On a truecolor terminal they are used exactly; on a
+ * 256-colour terminal (older Termux builds, ssh into a plain xterm) each colour is mapped to
+ * the closest entry of the xterm palette. With colours switched off everything is plain text.
+ */
+export function hexToRgb(hex) {
+    const h = hex.replace('#', '');
+    const full = h.length === 3 ? h.split('').map((c) => c + c).join('') : h;
+    return [parseInt(full.slice(0, 2), 16), parseInt(full.slice(2, 4), 16), parseInt(full.slice(4, 6), 16)];
+}
+const CUBE_LEVELS = [0, 95, 135, 175, 215, 255];
+const distance = (a, b) => (a[0] - b[0]) ** 2 + (a[1] - b[1]) ** 2 + (a[2] - b[2]) ** 2;
+/** Closest xterm-256 palette index for an RGB colour (colour cube or grayscale ramp). */
+export function rgbTo256(r, g, b) {
+    const nearestLevel = (v) => CUBE_LEVELS.reduce((best, level, i) => (Math.abs(level - v) < Math.abs(CUBE_LEVELS[best] - v) ? i : best), 0);
+    const ri = nearestLevel(r);
+    const gi = nearestLevel(g);
+    const bi = nearestLevel(b);
+    const cubeIndex = 16 + 36 * ri + 6 * gi + bi;
+    const cubeRgb = [CUBE_LEVELS[ri], CUBE_LEVELS[gi], CUBE_LEVELS[bi]];
+    const average = (r + g + b) / 3;
+    const grayStep = Math.max(0, Math.min(23, Math.round((average - 8) / 10)));
+    const grayValue = 8 + 10 * grayStep;
+    const grayIndex = 232 + grayStep;
+    const target = [r, g, b];
+    return distance(target, [grayValue, grayValue, grayValue]) < distance(target, cubeRgb) ? grayIndex : cubeIndex;
+}
+export function supportsTruecolor(env = process.env) {
+    const forced = (env.DEVX_COLOR || '').toLowerCase();
+    if (forced === '256')
+        return false;
+    if (forced === 'truecolor' || forced === '24bit')
+        return true;
+    const colorterm = (env.COLORTERM || '').toLowerCase();
+    return colorterm.includes('truecolor') || colorterm.includes('24bit');
+}
+function sgr(hex, base, opts) {
+    const [r, g, b] = hexToRgb(hex);
+    const truecolor = opts.truecolor ?? supportsTruecolor();
+    return truecolor ? `\x1b[${base};2;${r};${g};${b}m` : `\x1b[${base};5;${rgbTo256(r, g, b)}m`;
+}
+/** Foreground colour from a hex value. */
+export function fgHex(hex, opts = {}) {
+    return (text) => ((opts.enabled ?? pc.isColorSupported) ? `${sgr(hex, 38, opts)}${text}\x1b[39m` : text);
+}
+/** Background colour from a hex value. */
+export function bgHex(hex, opts = {}) {
+    return (text) => ((opts.enabled ?? pc.isColorSupported) ? `${sgr(hex, 48, opts)}${text}\x1b[49m` : text);
+}
+/** WCAG relative luminance of a hex colour. */
+export function relativeLuminance(hex) {
+    const channel = (v) => {
+        const c = v / 255;
+        return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+    };
+    const [r, g, b] = hexToRgb(hex);
+    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);
+}
+/** WCAG contrast ratio between two hex colours (1 to 21). */
+export function contrastRatio(a, b) {
+    const la = relativeLuminance(a);
+    const lb = relativeLuminance(b);
+    return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);
+}

package/dist/cli/confirm.js

@@ -0,0 +1,50 @@
+import { runPicker } from './picker.js';
+import { palette, renderNotice } from './ui.js';
+import { wrapWords } from './width.js';
+import { renderAnswerRow } from '../tools/questions.js';
+import { t } from '../core/i18n.js';
+/** A yes / no question in the style of the rest of devx: the question, a small card with two choices. Esc means "no". */
+export async function askConfirm(options) {
+    const cols = process.stdout.columns || 80;
+    console.log();
+    for (const line of wrapWords(options.question, Math.max(20, cols - 8)))
+        console.log('  ' + palette.bold(palette.text(line)));
+    for (const line of options.details ?? [])
+        console.log('  ' + palette.faint(line));
+    const yes = options.yes ?? t('confirm.yes');
+    const no = options.no ?? t('confirm.no');
+    const answer = await runPicker({
+        title: options.title,
+        items: [
+            { value: true, label: yes },
+            { value: false, label: no },
+        ],
+        current: options.initial === true,
+    });
+    const result = answer === true;
+    if (options.record !== false)
+        console.log(renderAnswerRow(options.question, result ? yes : no, false, cols));
+    return result;
+}
+/** A closing line such as "Goodbye": quiet, in the same style as the other notices. */
+export function printFarewell(message, kind = 'info') {
+    console.log();
+    console.log(renderNotice(kind, message));
+    console.log();
+}
+/** The plan is ready: start on it (Go) or change it. Esc means "change": nothing starts by accident. */
+export async function askPlanDecision() {
+    const cols = process.stdout.columns || 80;
+    console.log();
+    for (const line of wrapWords(t('plan.ready'), Math.max(20, cols - 8)))
+        console.log('  ' + palette.bold(palette.text(line)));
+    const answer = await runPicker({
+        title: 'plan',
+        items: [
+            { value: 'go', label: t('plan.go') },
+            { value: 'edit', label: t('plan.edit') },
+        ],
+        current: 'go',
+    });
+    return answer === 'go' ? 'go' : 'edit';
+}