@sealant/mend 0.19.0 → 0.20.0

package/dist/clipboard.js

@@ -0,0 +1,73 @@
+import { execFile } from "node:child_process";
+const IMAGE_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+/** The first image type this reader accepts from a clipboard's offered list. */
+export const pickImageType = (offered) => {
+    const types = offered.split(/\s+/).map((type) => type.trim().toLowerCase());
+    for (const type of IMAGE_TYPES)
+        if (types.includes(type))
+            return type;
+    return null;
+};
+/**
+ * AppleScript's `«data PNGf…»` literal: the PNG bytes as hex, from
+ * `the clipboard as «class PNGf»`. Null when the clipboard held no image.
+ */
+export const parsePngfHex = (output) => {
+    const match = /«data PNGf([0-9A-Fa-f]+)»/.exec(output.trim());
+    if (match?.[1] === undefined || match[1].length === 0)
+        return null;
+    return Buffer.from(match[1], "hex");
+};
+const MAX_BYTES = 32 * 1024 * 1024;
+/** One clipboard tool call; null when the tool is missing, fails, or times out. */
+const run = (command, args) => new Promise((resolve) => {
+    execFile(command, [...args], { encoding: "buffer", maxBuffer: MAX_BYTES, timeout: 3000 }, (error, stdout) => {
+        resolve(error === null ? stdout : null);
+    });
+});
+const fromWayland = async () => {
+    const offered = await run("wl-paste", ["--list-types"]);
+    if (offered === null)
+        return null;
+    const mediaType = pickImageType(offered.toString("utf8"));
+    if (mediaType === null)
+        return null;
+    const bytes = await run("wl-paste", ["--no-newline", "--type", mediaType]);
+    return bytes === null || bytes.length === 0 ? null : { bytes, mediaType };
+};
+const fromX11 = async () => {
+    const offered = await run("xclip", ["-selection", "clipboard", "-t", "TARGETS", "-o"]);
+    if (offered === null)
+        return null;
+    const mediaType = pickImageType(offered.toString("utf8"));
+    if (mediaType === null)
+        return null;
+    const bytes = await run("xclip", ["-selection", "clipboard", "-t", mediaType, "-o"]);
+    return bytes === null || bytes.length === 0 ? null : { bytes, mediaType };
+};
+const fromMac = async () => {
+    const output = await run("osascript", ["-e", "the clipboard as «class PNGf»"]);
+    if (output === null)
+        return null;
+    const bytes = parsePngfHex(output.toString("utf8"));
+    return bytes === null ? null : { bytes, mediaType: "image/png" };
+};
+/**
+ * Read an image off the clipboard: wl-paste on Wayland, xclip on X11,
+ * osascript on macOS. Null when there is no image or no way to ask — the
+ * caller then forwards the keystroke as it was.
+ */
+export const readClipboardImage = async (platform = process.platform, env = process.env) => {
+    if (platform === "darwin")
+        return fromMac();
+    if (platform !== "linux" && platform !== "freebsd" && platform !== "openbsd")
+        return null;
+    if (env["WAYLAND_DISPLAY"] !== undefined && env["WAYLAND_DISPLAY"] !== "") {
+        const image = await fromWayland();
+        if (image !== null)
+            return image;
+    }
+    if (env["DISPLAY"] !== undefined && env["DISPLAY"] !== "")
+        return fromX11();
+    return null;
+};

package/dist/dashboard-model.js

@@ -160,15 +160,10 @@ export const pseudoGroup = (session, item) => ({
     live: LIVE_STATUSES.has(session.status) ? 1 : 0,
     annotation: item(session).annotation,
 });
-export const deriveRows = (groups) => groups.flatMap((group) => {
-    const only = group.sessions.length === 1 ? group.sessions[0] : undefined;
-    if (only !== undefined)
-        return [{ kind: "session", group, item: only }];
-    return [
-        { kind: "worktree", group },
-        ...group.sessions.map((item) => ({ kind: "session", group, item })),
-    ];
-});
+export const deriveRows = (groups) => groups.flatMap((group) => [
+    { kind: "worktree", group },
+    ...group.sessions.map((item) => ({ kind: "session", group, item })),
+]);
 export const rowKeyOf = (row) => row.kind === "worktree" ? `wt:${row.group.key}` : `s:${row.item.session.id}`;
 /** The picker's rows: resume offers the same harness first, then the crossings. */
 export const deriveHarnesses = (resuming) => {

package/dist/dashboard.js

@@ -3,7 +3,7 @@ import { CliRenderEvents, createCliRenderer } from "@opentui/core";
 import { createRoot, useKeyboard, useRenderer, useTerminalDimensions } from "@opentui/react";
 import { QueryClient, QueryClientProvider, useMutation, useQuery, useQueryClient, } from "@tanstack/react-query";
 import { useEffect, useRef, useState } from "react";
-import { deriveHarnesses, deriveProjects, advanceFromBase, deriveRows, deriveWorktrees, filterBranches, foldGroupStatus, labelIsIdentity, rowKeyOf, worktreeDisplayName, fetchWorkbench, liveProtocolOf, liveShellOf, mapWorkbenchSessions, markSessionStopped, removeWorktreeGroup, prependSession, removeSession, replaceSession, WORKBENCH_KEY, } from "./dashboard-model.js";
+import { deriveHarnesses, deriveProjects, advanceFromBase, deriveRows, deriveWorktrees, filterBranches, foldGroupStatus, rowKeyOf, worktreeDisplayName, fetchWorkbench, liveProtocolOf, liveShellOf, mapWorkbenchSessions, markSessionStopped, removeWorktreeGroup, prependSession, removeSession, replaceSession, WORKBENCH_KEY, } from "./dashboard-model.js";
 import { reviewTargetForSession } from "./review-workflow.js";
 import { ReviewScreen } from "./review.js";
 import { cwdFacts, HARNESS_COMMANDS, isPendingId, LIVE_STATUSES, matchProjectByCwd, normalizeProjectName, pendingId, } from "./shared.js";
@@ -58,26 +58,15 @@ const ProcessLines = ({ processes, services, indent, }) => (_jsxs(_Fragment, { c
                                 : process.kind === "agent-external"
                                     ? " · external"
                                     : "", ` ${process.status}`] })] }) }, process.id))), services.map((service) => (_jsx("box", { height: 1, flexShrink: 0, backgroundColor: "transparent", children: _jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: FAINT, children: indent }), _jsx("span", { fg: service.status === "reachable" ? INK_2 : MUTED, children: `${service.label ?? service.id.slice(0, 6)} :${service.workspacePort ?? "?"}${service.protocol === "udp" ? "u" : ""}→${service.hostPort ?? "?"}` }), _jsx("span", { fg: FAINT, children: ` ${service.status}` })] }) }, service.id)))] }));
-/**
- * A lone-session worktree, combined into one row (today's density): the
- * worktree name leads, everything live inside hangs underneath as facts.
- */
-const CombinedRow = ({ group, item, selected, }) => {
-    const { session, annotation, services, processes } = item;
-    const color = STATUS_COLOR[session.status] ?? MUTED;
-    const age = timeAgo(session.createdAt).replace(" ago", "");
-    const trailingLabel = labelIsIdentity(session) ? "" : (session.label ?? "");
-    return (_jsxs("box", { flexShrink: 0, flexDirection: "column", backgroundColor: "transparent", children: [_jsx("box", { height: 1, flexShrink: 0, backgroundColor: selected ? WASH : "transparent", children: _jsxs("text", { height: 1, bg: "transparent", children: [_jsx(Gutter, { selected: selected }), _jsx("span", { fg: INK, children: group.name.slice(0, 30).padEnd(31) }), _jsx("span", { fg: color, children: session.status.padEnd(10) }), _jsx("span", { fg: FAINT, children: age.padEnd(9) }), _jsx("span", { fg: MUTED, children: session.harness.padEnd(10) }), annotation !== undefined && annotation.openComments > 0 ? (_jsx("span", { fg: MUTED, children: `${annotation.openComments} open  ` })) : null, _jsx("span", { fg: FAINT, children: trailingLabel.slice(0, 40) })] }) }), _jsx(ProcessLines, { processes: processes, services: services, indent: "     └ " })] }));
-};
-/** A shared worktree's header: the place, its folded status, its member facts. */
+/** A worktree's header: the place, its folded status, its member facts. */
 const WorktreeHeaderRow = ({ group, selected, }) => {
     const folded = foldGroupStatus(group);
     const color = group.live > 0 ? (STATUS_COLOR[folded] ?? MUTED) : FAINT;
     const age = timeAgo(group.sessions.at(-1)?.session.createdAt ?? group.createdAt).replace(" ago", "");
     const open = group.annotation?.openComments ?? 0;
-    return (_jsx("box", { height: 1, flexShrink: 0, backgroundColor: selected ? WASH : "transparent", children: _jsxs("text", { height: 1, bg: "transparent", children: [_jsx(Gutter, { selected: selected }), _jsx("span", { fg: INK, children: group.name.slice(0, 30).padEnd(31) }), _jsx("span", { fg: color, children: (group.live > 0 ? folded : "settled").padEnd(10) }), _jsx("span", { fg: FAINT, children: age.padEnd(9) }), _jsx("span", { fg: MUTED, children: `${group.sessions.length} sessions` }), open > 0 ? _jsx("span", { fg: MUTED, children: ` · ${open} open` }) : null] }) }));
+    return (_jsx("box", { height: 1, flexShrink: 0, backgroundColor: selected ? WASH : "transparent", children: _jsxs("text", { height: 1, bg: "transparent", children: [_jsx(Gutter, { selected: selected }), _jsx("span", { fg: INK, children: group.name.slice(0, 30).padEnd(31) }), _jsx("span", { fg: color, children: (group.live > 0 ? folded : "settled").padEnd(10) }), _jsx("span", { fg: FAINT, children: age.padEnd(9) }), _jsx("span", { fg: MUTED, children: `${group.sessions.length} session${group.sessions.length === 1 ? "" : "s"}` }), open > 0 ? _jsx("span", { fg: MUTED, children: ` · ${open} open` }) : null] }) }));
 };
-/** One conversation inside a shared worktree — the label is its identity. */
+/** One conversation inside a worktree — the label is its identity. */
 const SessionChildRow = ({ item, selected, }) => {
     const { session, services, processes } = item;
     const color = STATUS_COLOR[session.status] ?? MUTED;
@@ -1062,7 +1051,7 @@ const App = ({ ctx, onQuit }) => {
                 refetch();
             }, onQuit: onQuit }));
     }
-    return (_jsxs("box", { flexGrow: 1, flexDirection: "column", backgroundColor: "transparent", children: [_jsxs("box", { height: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: INK, children: " mend" }), _jsxs("span", { fg: MUTED, children: ["  ", projectItems.length, " project", projectItems.length === 1 ? "" : "s"] }), _jsx("span", { fg: FAINT, children: " \u00B7 " }), _jsxs("span", { fg: liveTotal > 0 ? MUTED : FAINT, children: [liveTotal, " live"] })] }), _jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: `${ctx.config.url}  ` })] }), _jsxs("box", { flexGrow: 1, flexShrink: 1, minHeight: 0, flexDirection: "row", children: [showProjectsPane ? (_jsx(Pane, { title: "projects", focused: focus === "projects", width: PROJECTS_PANE_WIDTH, children: _jsxs("scrollbox", { ref: projectScrollRef, flexGrow: 1, flexShrink: 1, minHeight: 0, style: paneScrollStyle, children: [projectItems.map((item, index) => (_jsx(ProjectRow, { item: item, selected: index === projectIndex, nameWidth: nameWidth }, item.project.id))), data !== undefined && projectItems.length === 0 ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: "  none adopted yet" })) : null] }) })) : null, _jsx(Pane, { title: sessionsTitle, focused: focus === "sessions", grow: true, children: _jsxs("scrollbox", { ref: sessionScrollRef, flexGrow: 1, flexShrink: 1, minHeight: 0, style: paneScrollStyle, children: [rows.map((row, index) => row.kind === "worktree" ? (_jsx(WorktreeHeaderRow, { group: row.group, selected: index === rowIndex }, rowKeyOf(row))) : row.group.sessions.length === 1 ? (_jsx(CombinedRow, { group: row.group, item: row.item, selected: index === rowIndex }, rowKeyOf(row))) : (_jsx(SessionChildRow, { item: row.item, selected: index === rowIndex }, rowKeyOf(row)))), data !== undefined && rows.length === 0 ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: "  no sessions yet — n starts one" })) : null, loadFailure !== null ? (_jsx("text", { height: 1, fg: INK_2, bg: "transparent", children: `  ${loadFailure} — retrying` })) : null] }) })] }), picker !== null ? (_jsx(Pane, { title: pickerTitle, focused: true, height: 2 + pickerItems.length, children: pickerItems.map((item, index) => (_jsx(HarnessRow, { item: item, selected: index === pickerIndex }, String(item.harness)))) })) : editing !== null ? (_jsx("box", { border: true, borderStyle: "rounded", borderColor: COBALT, title: ` label — ${editing.harness} ${editing.id.slice(0, 8)} `, titleAlignment: "left", backgroundColor: "transparent", height: 3, flexShrink: 0, children: _jsx("input", { focused: true, value: editing.label ?? "", placeholder: "a few words for what this session is doing (empty clears)", backgroundColor: "transparent", focusedBackgroundColor: "transparent", textColor: INK, focusedTextColor: INK, placeholderColor: FAINT, cursorColor: INK, flexGrow: 1, onSubmit: (value) => {
+    return (_jsxs("box", { flexGrow: 1, flexDirection: "column", backgroundColor: "transparent", children: [_jsxs("box", { height: 1, flexDirection: "row", justifyContent: "space-between", children: [_jsxs("text", { height: 1, bg: "transparent", children: [_jsx("span", { fg: INK, children: " mend" }), _jsxs("span", { fg: MUTED, children: ["  ", projectItems.length, " project", projectItems.length === 1 ? "" : "s"] }), _jsx("span", { fg: FAINT, children: " \u00B7 " }), _jsxs("span", { fg: liveTotal > 0 ? MUTED : FAINT, children: [liveTotal, " live"] })] }), _jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: `${ctx.config.url}  ` })] }), _jsxs("box", { flexGrow: 1, flexShrink: 1, minHeight: 0, flexDirection: "row", children: [showProjectsPane ? (_jsx(Pane, { title: "projects", focused: focus === "projects", width: PROJECTS_PANE_WIDTH, children: _jsxs("scrollbox", { ref: projectScrollRef, flexGrow: 1, flexShrink: 1, minHeight: 0, style: paneScrollStyle, children: [projectItems.map((item, index) => (_jsx(ProjectRow, { item: item, selected: index === projectIndex, nameWidth: nameWidth }, item.project.id))), data !== undefined && projectItems.length === 0 ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: "  none adopted yet" })) : null] }) })) : null, _jsx(Pane, { title: sessionsTitle, focused: focus === "sessions", grow: true, children: _jsxs("scrollbox", { ref: sessionScrollRef, flexGrow: 1, flexShrink: 1, minHeight: 0, style: paneScrollStyle, children: [rows.map((row, index) => row.kind === "worktree" ? (_jsx(WorktreeHeaderRow, { group: row.group, selected: index === rowIndex }, rowKeyOf(row))) : (_jsx(SessionChildRow, { item: row.item, selected: index === rowIndex }, rowKeyOf(row)))), data !== undefined && rows.length === 0 ? (_jsx("text", { height: 1, fg: FAINT, bg: "transparent", children: "  no sessions yet — n starts one" })) : null, loadFailure !== null ? (_jsx("text", { height: 1, fg: INK_2, bg: "transparent", children: `  ${loadFailure} — retrying` })) : null] }) })] }), picker !== null ? (_jsx(Pane, { title: pickerTitle, focused: true, height: 2 + pickerItems.length, children: pickerItems.map((item, index) => (_jsx(HarnessRow, { item: item, selected: index === pickerIndex }, String(item.harness)))) })) : editing !== null ? (_jsx("box", { border: true, borderStyle: "rounded", borderColor: COBALT, title: ` label — ${editing.harness} ${editing.id.slice(0, 8)} `, titleAlignment: "left", backgroundColor: "transparent", height: 3, flexShrink: 0, children: _jsx("input", { focused: true, value: editing.label ?? "", placeholder: "a few words for what this session is doing (empty clears)", backgroundColor: "transparent", focusedBackgroundColor: "transparent", textColor: INK, focusedTextColor: INK, placeholderColor: FAINT, cursorColor: INK, flexGrow: 1, onSubmit: (value) => {
                         if (typeof value === "string")
                             submitRename(editing, value);
                     } }) })) : showDetail ? (_jsx(Pane, { title: detailTitle, focused: false, height: 6, children: _jsx(SessionDetail, { item: selectedSession }) })) : null, adoptOffer !== null ? (_jsxs("box", { position: "absolute", zIndex: 11, left: Math.max(1, Math.floor((terminalCols - Math.min(70, terminalCols - 4)) / 2)), top: Math.max(1, Math.floor((terminalRows - 7) / 2)), width: Math.min(70, terminalCols - 4), height: 7, border: true, borderStyle: "rounded", borderColor: COBALT, title: " adopt this repository? ", titleAlignment: "left", backgroundColor: SURFACE, flexDirection: "column", children: [_jsxs("text", { height: 1, bg: SURFACE, children: [_jsx("span", { children: "  " }), _jsx("span", { fg: INK, children: adoptOffer.name }), _jsx("span", { fg: FAINT, children: " · not in the store yet" })] }), _jsx("text", { height: 1, bg: SURFACE, fg: MUTED, children: `  ${adoptOffer.source}` }), _jsxs("text", { height: 1, bg: SURFACE, children: [_jsx("span", { fg: FAINT, children: "  auth  " }), ADOPT_AUTH_MODES.map((candidate, index) => (_jsxs("span", { children: [index > 0 ? _jsx("span", { fg: FAINT, children: " · " }) : null, _jsx("span", { fg: index === adoptOffer.modeIndex ? COBALT : FAINT, children: index === adoptOffer.modeIndex ? `▸ ${candidate.label}` : candidate.label })] }, candidate.mode)))] }), _jsx("text", { height: 1, bg: SURFACE, fg: FAINT, children: `        ${ADOPT_AUTH_MODES[adoptOffer.modeIndex]?.hint ?? ""}` }), _jsx("text", { height: 1, bg: SURFACE, fg: FAINT, children: adoptOffer.source === adoptOffer.root

package/dist/help.js

@@ -87,6 +87,7 @@ export const COMMANDS = [
             "mend codex, mend claude, and mend opencode are the same command with a different harness. The session runs in a workspace on the platform, in its own git worktree, and everything it does is recorded. This terminal attaches to it.",
             "The worktree's name is asked first. --name skips the ask; an existing name joins that worktree as a new session. --worktree joins only and fails if the name is unknown. A quoted prompt becomes the first message.",
             "Detach with Ctrl+] and the session keeps running. Reattach from any terminal with mend attach, or from the phone.",
+            "Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl-paste on Wayland, xclip on X11, nothing extra on macOS.",
         ],
         options: [
             { flag: "--name <worktree>", text: "name the worktree; an existing name joins it" },
@@ -156,6 +157,7 @@ export const COMMANDS = [
         description: [
             sessionArg,
             "A session that was picked up on the phone is taken back into this terminal: the phone's agent ends and the same conversation continues here.",
+            "Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl-paste on Wayland, xclip on X11, nothing extra on macOS.",
         ],
         see: ["stop", "rejoin", "shell"],
     },

package/dist/main.js

@@ -5,6 +5,7 @@ import { createRequire } from "node:module";
 import * as net from "node:net";
 import * as os from "node:os";
 import * as path from "node:path";
+import { readClipboardImage } from "./clipboard.js";
 import { doctorCommand } from "./doctor.js";
 import { readSyncFiles, scanDotfileCandidates } from "./dotfiles.js";
 import { formatLoadReport } from "./env.js";
@@ -12,7 +13,7 @@ import { findCommand, manFileName, renderCommand, renderGroup, renderIndex, rend
 import { loginCommand } from "./login.js";
 import { pairCommand, qrCommand } from "./pair.js";
 import { isComposeFile, proposeFromCompose, proposeFromPackageJson, proposeFromWorkspacePackage, renderMendToml, workspaceGlobs, } from "./service-init.js";
-import { agentIsLive, agentOutcome, cwdFacts, gitTopLevel, HARNESS_COMMANDS, isDetachChunk, LIVE_STATUSES, sessionDisplayName, matchProjectByCwd, normalizeProjectName, gitCurrentBranch, parseLaunchArgs, } from "./shared.js";
+import { agentIsLive, agentOutcome, cwdFacts, gitTopLevel, HARNESS_COMMANDS, isDetachChunk, isPasteChunk, LIVE_STATUSES, pasteBytes, trackBracketedPaste, sessionDisplayName, matchProjectByCwd, normalizeProjectName, gitCurrentBranch, parseLaunchArgs, } from "./shared.js";
 import { DEFAULT_SKILLS_DIR, scanSkillLibrary } from "./skills.js";
 import { sshCommand } from "./ssh-setup.js";
 import { cliVersion, fetchServerVersion, versionLines } from "./version.js";
@@ -452,9 +453,12 @@ const attachTty = async (config, sessionId, harness, from, processId, options) =
         finishAttachment?.();
     };
     const signals = ["SIGHUP", "SIGINT", "SIGTERM"];
+    let bracketedPaste = false;
     const onTtyFrame = (event) => {
         if (typeof event.data !== "string") {
-            process.stdout.write(Buffer.from(event.data));
+            const bytes = Buffer.from(event.data);
+            bracketedPaste = trackBracketedPaste(bytes, bracketedPaste);
+            process.stdout.write(bytes);
             return;
         }
         try {
@@ -484,9 +488,36 @@ const attachTty = async (config, sessionId, harness, from, processId, options) =
         }
         if (ws.readyState !== WebSocket.OPEN)
             return;
+        if (isPasteChunk(data)) {
+            // Ctrl+V — the agent's own clipboard is empty (the workspace has no
+            // display), so an image on THIS machine's clipboard goes up to Mend and
+            // its workspace path is pasted instead; codex and claude read the path.
+            // No image, or no way to ask: the keystroke goes through untouched.
+            void pasteClipboardImage(data);
+            return;
+        }
         // Copy into a plain ArrayBuffer (WebSocket.send rejects pooled Buffer views).
         ws.send(new Uint8Array(data).buffer);
     };
+    const forward = (bytes) => {
+        if (ws.readyState === WebSocket.OPEN)
+            ws.send(new Uint8Array(bytes).buffer);
+    };
+    const pasteClipboardImage = async (keystroke) => {
+        const image = await readClipboardImage();
+        if (image === null) {
+            forward(keystroke);
+            return;
+        }
+        try {
+            const stored = await request(config, "POST", `/sessions/${sessionId}/images`, { contentsBase64: image.bytes.toString("base64") });
+            forward(pasteBytes(stored.path, bracketedPaste));
+        }
+        catch {
+            // The TUI owns the screen; a bell is the only honest signal left.
+            process.stdout.write("\x07");
+        }
+    };
     try {
         sendResize();
         process.stdout.on("resize", onWinch);

package/dist/shared.js

@@ -293,3 +293,29 @@ export const normalizeProjectName = (raw) => {
         .replace(/-+$/, "");
     return slug === "" ? "project" : slug.slice(0, 64);
 };
+/**
+ * Whether one stdin chunk is exactly Ctrl+V — the raw 0x16 byte, or the
+ * kitty CSI-u form `ESC [ 118 ; 5 u` (`v` is code 118) on press or repeat.
+ * Exact, not contained: a paste that happens to carry 0x16 is not a request.
+ */
+export const isPasteChunk = (data) => {
+    if (data.length === 1 && data[0] === 0x16)
+        return true;
+    const text = data.toString("latin1");
+    return text === "\u001b[118;5u" || text === "\u001b[118;5:1u" || text === "\u001b[118;5:2u";
+};
+/**
+ * Follow the remote app's bracketed-paste mode through the bytes it writes:
+ * the last `ESC [ ? 2004 h|l` in a chunk wins; a chunk with neither keeps the
+ * current state. A pasted image path is wrapped only when the app asked.
+ */
+export const trackBracketedPaste = (output, current) => {
+    const text = output.toString("latin1");
+    const on = text.lastIndexOf("\u001b[?2004h");
+    const off = text.lastIndexOf("\u001b[?2004l");
+    if (on === -1 && off === -1)
+        return current;
+    return on > off;
+};
+/** The bytes that paste `text` into the remote app, bracketed when it asked. */
+export const pasteBytes = (text, bracketed) => Buffer.from(bracketed ? `\u001b[200~${text}\u001b[201~` : text, "utf8");

package/man/mend-accounts.1

@@ -1,4 +1,4 @@
-.TH MEND-ACCOUNTS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ACCOUNTS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-accounts \- your connected accounts on the platform
 .SH SYNOPSIS

package/man/mend-adopt.1

@@ -1,4 +1,4 @@
-.TH MEND-ADOPT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ADOPT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-adopt \- adopt a repository into the store
 .SH SYNOPSIS

package/man/mend-attach.1

@@ -1,4 +1,4 @@
-.TH MEND-ATTACH 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ATTACH 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-attach \- reattach this terminal to a running session
 .SH SYNOPSIS
@@ -9,5 +9,7 @@ mend\-attach \- reattach this terminal to a running session
 With no id, the one live session is taken; with several, a picker opens. A prefix of the id is enough.
 .PP
 A session that was picked up on the phone is taken back into this terminal: the phone's agent ends and the same conversation continues here.
+.PP
+Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl\-paste on Wayland, xclip on X11, nothing extra on macOS.
 .SH SEE ALSO
 mend(1), mend\-stop(1), mend\-rejoin(1), mend\-shell(1)

package/man/mend-codex.1

@@ -1,4 +1,4 @@
-.TH MEND-CODEX 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-CODEX 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-codex \- launch codex, claude, or opencode in a recorded worktree
 .SH SYNOPSIS
@@ -12,6 +12,8 @@ mend codex, mend claude, and mend opencode are the same command with a different
 The worktree's name is asked first. \-\-name skips the ask; an existing name joins that worktree as a new session. \-\-worktree joins only and fails if the name is unknown. A quoted prompt becomes the first message.
 .PP
 Detach with Ctrl+] and the session keeps running. Reattach from any terminal with mend attach, or from the phone.
+.PP
+Ctrl+V with an image on this machine's clipboard sends the image to the session and pastes its path; codex and claude read it. Needs wl\-paste on Wayland, xclip on X11, nothing extra on macOS.
 .SH OPTIONS
 .TP
 .B \-\-name <worktree>

package/man/mend-completions.1

@@ -1,4 +1,4 @@
-.TH MEND-COMPLETIONS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-COMPLETIONS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-completions \- print the TAB\-completion hook
 .SH SYNOPSIS

package/man/mend-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-CONNECT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-CONNECT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-connect \- send this machine's provider credential to the platform
 .SH SYNOPSIS

package/man/mend-continue.1

@@ -1,4 +1,4 @@
-.TH MEND-CONTINUE 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-CONTINUE 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-continue \- resume a session with its pending review follow\-up
 .SH SYNOPSIS

package/man/mend-doctor.1

@@ -1,4 +1,4 @@
-.TH MEND-DOCTOR 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-DOCTOR 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-doctor \- check this machine's setup
 .SH SYNOPSIS

package/man/mend-dotfiles-sync.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES-SYNC 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-DOTFILES-SYNC 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-dotfiles\-sync \- capture config files from this machine into your store
 .SH SYNOPSIS

package/man/mend-dotfiles.1

@@ -1,4 +1,4 @@
-.TH MEND-DOTFILES 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-DOTFILES 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-dotfiles \- your dotfiles on the server: repo and synced files
 .SH SYNOPSIS

package/man/mend-env-cluster.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-CLUSTER 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ENV-CLUSTER 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-env\-cluster \- bind Kubernetes secrets and configmaps to the workspaces
 .SH SYNOPSIS

package/man/mend-env-load.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-LOAD 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ENV-LOAD 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-env\-load \- load a .env into the project
 .SH SYNOPSIS

package/man/mend-env-show.1

@@ -1,4 +1,4 @@
-.TH MEND-ENV-SHOW 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-ENV-SHOW 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-env\-show \- what the project store holds: names only, never values
 .SH SYNOPSIS

package/man/mend-help.1

@@ -1,4 +1,4 @@
-.TH MEND-HELP 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-HELP 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-help \- this index, or one command's page
 .SH SYNOPSIS

package/man/mend-keys-init.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-INIT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-KEYS-INIT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-keys\-init \- generate this machine's Mend deploy key (ed25519)
 .SH SYNOPSIS

package/man/mend-keys-share.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHARE 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-KEYS-SHARE 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-keys\-share \- relay this machine's ssh\-agent to the server
 .SH SYNOPSIS

package/man/mend-keys-show.1

@@ -1,4 +1,4 @@
-.TH MEND-KEYS-SHOW 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-KEYS-SHOW 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-keys\-show \- print the public key
 .SH SYNOPSIS

package/man/mend-login.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGIN 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-LOGIN 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-login \- sign this terminal in through the browser
 .SH SYNOPSIS

package/man/mend-logout.1

@@ -1,4 +1,4 @@
-.TH MEND-LOGOUT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-LOGOUT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-logout \- revoke this terminal's device token and forget it
 .SH SYNOPSIS

package/man/mend-man.1

@@ -1,4 +1,4 @@
-.TH MEND-MAN 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-MAN 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-man \- one command's page, or the whole manual, in man
 .SH SYNOPSIS

package/man/mend-pair.1

@@ -1,4 +1,4 @@
-.TH MEND-PAIR 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-PAIR 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-pair \- pair a phone or a second machine
 .SH SYNOPSIS

package/man/mend-projects.1

@@ -1,4 +1,4 @@
-.TH MEND-PROJECTS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-PROJECTS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-projects \- adopted projects and their live sessions
 .SH SYNOPSIS

package/man/mend-refresh.1

@@ -1,4 +1,4 @@
-.TH MEND-REFRESH 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-REFRESH 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-refresh \- fetch origin's branches into the store
 .SH SYNOPSIS

package/man/mend-rejoin.1

@@ -1,4 +1,4 @@
-.TH MEND-REJOIN 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-REJOIN 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-rejoin \- attach if live, otherwise resume
 .SH SYNOPSIS

package/man/mend-resume.1

@@ -1,4 +1,4 @@
-.TH MEND-RESUME 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-RESUME 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-resume \- rejoin a settled session with its state restored
 .SH SYNOPSIS

package/man/mend-run.1

@@ -1,4 +1,4 @@
-.TH MEND-RUN 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-RUN 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-run \- run any command as a session
 .SH SYNOPSIS

package/man/mend-service-add.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-ADD 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-ADD 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-add \- adopt a port something in the workspace already listens on
 .SH SYNOPSIS

package/man/mend-service-connect.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-CONNECT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-CONNECT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-connect \- bring live Services to this machine's loopback
 .SH SYNOPSIS

package/man/mend-service-init.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-INIT 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-INIT 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-init \- scaffold mend.toml from package.json and compose ports
 .SH SYNOPSIS

package/man/mend-service-list.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-LIST 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-LIST 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-list \- every live service and its observed state
 .SH SYNOPSIS

package/man/mend-service-logs.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-LOGS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-LOGS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-logs \- follow a supervised service's output
 .SH SYNOPSIS

package/man/mend-service-restart.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-RESTART 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-RESTART 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-restart \- re\-run a service's recorded command, same URL
 .SH SYNOPSIS

package/man/mend-service-run.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-RUN 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-RUN 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-run \- start and supervise a server in the session's workspace
 .SH SYNOPSIS

package/man/mend-service-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-SERVICE-STOP 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SERVICE-STOP 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-service\-stop \- stop a service and close its host port
 .SH SYNOPSIS

package/man/mend-sessions.1

@@ -1,4 +1,4 @@
-.TH MEND-SESSIONS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SESSIONS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-sessions \- sessions with their review facts
 .SH SYNOPSIS

package/man/mend-shell.1

@@ -1,4 +1,4 @@
-.TH MEND-SHELL 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SHELL 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-shell \- open a shell in a live session's workspace
 .SH SYNOPSIS

package/man/mend-skills-push.1

@@ -1,4 +1,4 @@
-.TH MEND-SKILLS-PUSH 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SKILLS-PUSH 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-skills\-push \- upload ~/.agents/skills into the library
 .SH SYNOPSIS

package/man/mend-skills.1

@@ -1,4 +1,4 @@
-.TH MEND-SKILLS 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SKILLS 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-skills \- your skill library on the server, or a project's
 .SH SYNOPSIS

package/man/mend-ssh-setup.1

@@ -1,4 +1,4 @@
-.TH MEND-SSH-SETUP 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SSH-SETUP 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-ssh\-setup \- make this machine ready to ssh into workspaces, once
 .SH SYNOPSIS

package/man/mend-ssh.1

@@ -1,4 +1,4 @@
-.TH MEND-SSH 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-SSH 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-ssh \- workspace SSH status: gateway, registered keys, ssh config
 .SH SYNOPSIS

package/man/mend-stop.1

@@ -1,4 +1,4 @@
-.TH MEND-STOP 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-STOP 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-stop \- stop the agent; the record and the review remain
 .SH SYNOPSIS

package/man/mend-ui.1

@@ -1,4 +1,4 @@
-.TH MEND-UI 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-UI 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-ui \- the dashboard: every project and session, live
 .SH SYNOPSIS

package/man/mend-version.1

@@ -1,4 +1,4 @@
-.TH MEND-VERSION 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-VERSION 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-version \- this CLI's version, and the server's when it answers
 .SH SYNOPSIS

package/man/mend-worktrees.1

@@ -1,4 +1,4 @@
-.TH MEND-WORKTREES 1 "" "mend 0.19.0" "mend manual"
+.TH MEND-WORKTREES 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend\-worktrees \- every worktree and the sessions inside it
 .SH SYNOPSIS

package/man/mend.1

@@ -1,4 +1,4 @@
-.TH MEND 1 "" "mend 0.19.0" "mend manual"
+.TH MEND 1 "" "mend 0.20.0" "mend manual"
 .SH NAME
 mend \- the agent workbench
 .SH SYNOPSIS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sealant/mend",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "The mend CLI: adopt a repository into Mend's store, launch your coding agent in a recorded session worktree, detach and reattach from any terminal",
   "keywords": [
     "claude-code",