@north-light/crouter 0.3.317 → 0.3.319

package/dist/clients/attach/config.js

@@ -1,274 +1 @@
-// config.ts — load the user's pi keybindings + theme for `crtr surface attach` (M8).
-//
-// These loaders are CLI-layer: pi does the *resolution* (the KeybindingsManager
-// matcher, `initTheme`) but the FILE reads are not reusable from pi, so we own
-// them. We read pi's own config locations so an attach viewer honors the same
-// `~/.pi/agent/keybindings.json` + theme the user already configured for pi.
-//
-// THE KEYBINDINGS MANAGER. pi's app-level KeybindingsManager (`core/keybindings`,
-// with `.create()` + the `app.*` definition table `KEYBINDINGS`) is NOT exported
-// — only its TYPE is re-exported, and the `KEYBINDINGS` const not at all. So we
-// construct pi-tui's KeybindingsManager (the base class CustomEditor actually
-// matches against) over the merged definition set: pi-tui's `TUI_KEYBINDINGS`
-// (editor/cursor/select bindings) + a VENDORED copy of pi's `app.*` editor
-// bindings below (required — CustomEditor.handleInput gates onEscape/onPasteImage/
-// onAction on `keybindings.matches(data, "app.*")`, so without the app defs those
-// never fire). We also register it globally via `setKeybindings` so the reused
-// pi-tui components (SelectList autocomplete, the dialog editor) honor overrides.
-import { readFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { KeybindingsManager, TUI_KEYBINDINGS, setKeybindings, } from '@earendil-works/pi-tui';
-import { initTheme, getMarkdownTheme, getSelectListTheme } from '@earendil-works/pi-coding-agent';
-import { surfaceBgAnsi } from '../../core/runtime/surface-bg.js';
-/** pi's user config dir: `~/.pi/agent/`. */
-export function defaultAgentDir() {
-    return join(homedir(), '.pi', 'agent');
-}
-/**
- * pi's `app.*` editor keybindings — VENDORED from pi `core/keybindings.ts`
- * `KEYBINDINGS` (the const is not exported). This is the subset CustomEditor's
- * main editor consults; the selector-internal bindings (`app.tree.*`,
- * `app.models.*`, session delete/rename) are omitted because the attach viewer
- * does not open those selectors. Re-sync on each SDK
- * bump against `core/keybindings.js`.
- */
-const APP_KEYBINDINGS = {
-    'app.interrupt': { defaultKeys: 'escape', description: 'Cancel or abort' },
-    'app.clear': { defaultKeys: 'ctrl+c', description: 'Clear editor' },
-    'app.exit': { defaultKeys: 'ctrl+d', description: 'Exit when editor is empty' },
-    'app.suspend': { defaultKeys: 'ctrl+z', description: 'Suspend to background' },
-    'app.thinking.cycle': { defaultKeys: 'shift+tab', description: 'Cycle thinking level' },
-    'app.model.cycleForward': { defaultKeys: 'ctrl+p', description: 'Cycle to next model' },
-    'app.model.cycleBackward': { defaultKeys: 'shift+ctrl+p', description: 'Cycle to previous model' },
-    'app.model.select': { defaultKeys: 'ctrl+l', description: 'Open model selector' },
-    'app.tools.expand': { defaultKeys: 'ctrl+o', description: 'Toggle tool output' },
-    'app.thinking.toggle': { defaultKeys: 'ctrl+t', description: 'Toggle thinking blocks' },
-    'app.editor.external': { defaultKeys: 'ctrl+g', description: 'Open external editor' },
-    // Alt+Enter inserts a newline in the attach editor (shift+enter is unreliable
-    // across terminals), so the follow-up-queue action drops its alt+enter default
-    // to free the chord — see ATTACH_KEYBINDING_OVERRIDES below.
-    'app.message.followUp': { defaultKeys: [], description: 'Queue follow-up message' },
-    'app.message.dequeue': { defaultKeys: 'alt+up', description: 'Restore queued messages' },
-    'app.clipboard.pasteImage': { defaultKeys: ['alt+v', 'ctrl+v'], description: 'Paste image from clipboard' },
-    'app.session.new': { defaultKeys: [], description: 'Start a new session' },
-    'app.session.tree': { defaultKeys: [], description: 'Open session tree' },
-    'app.session.fork': { defaultKeys: [], description: 'Fork current session' },
-    'app.session.resume': { defaultKeys: [], description: 'Resume a session' },
-};
-/**
- * Read `~/.pi/agent/keybindings.json` (if present) and return the user's binding
- * overrides. Tolerates a flat `{action: keys}` map or a `{keybindings: {...}}`
- * wrapper; a missing/malformed file → `undefined` (fall back to defaults).
- */
-export function loadUserKeybindings(agentDir = defaultAgentDir()) {
-    try {
-        const raw = JSON.parse(readFileSync(join(agentDir, 'keybindings.json'), 'utf8'));
-        const obj = raw && typeof raw === 'object' && 'keybindings' in raw
-            ? raw.keybindings
-            : raw;
-        if (!obj || typeof obj !== 'object')
-            return undefined;
-        return obj;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Build the KeybindingsManager the attach viewer drives input with: TUI defaults
- * + vendored `app.*` defs, with the user's overrides applied, registered as the
- * global pi-tui keybindings so reused components pick up the same bindings.
- * (`as unknown as` bridges the readonly `TUI_KEYBINDINGS`/string-literal defs to
- * the mutable `KeybindingDefinitions` param — vendoring cast, no behavior change.)
- */
-/**
- * Attach-specific default overrides applied OVER pi's TUI defaults. Alt+Enter
- * inserts a newline here (the follow-up-queue action gives up its alt+enter
- * default above), because shift+enter — pi's stock newline chord — does not
- * transmit a distinct sequence in many terminals. User `keybindings.json` still
- * wins on top of these (applied as the manager's override config).
- */
-const ATTACH_KEYBINDING_OVERRIDES = {
-    'tui.input.newLine': { defaultKeys: ['shift+enter', 'alt+enter'], description: 'Insert new line' },
-};
-export function createKeybindingsManager(agentDir = defaultAgentDir()) {
-    const definitions = {
-        ...TUI_KEYBINDINGS,
-        ...APP_KEYBINDINGS,
-        ...ATTACH_KEYBINDING_OVERRIDES,
-    };
-    const km = new KeybindingsManager(definitions, loadUserKeybindings(agentDir));
-    setKeybindings(km);
-    return km;
-}
-/**
- * pi-coding-agent's `CustomEditor` resolves `@earendil-works/pi-tui` from its OWN
- * `node_modules`, which can be a SEPARATE module instance from the one this file
- * imports (a non-deduped install leaves a nested copy). The editor's newline /
- * submit handling reads keybindings AND the kitty-protocol flag from THAT
- * instance's module-globals via `getKeybindings()` / `isKittyProtocolActive()`,
- * so state we set only on our copy is invisible to it — the user's `alt+enter`
- * newline binding never applies and Enter falls through to submit. We mirror our
- * state onto the editor's instance too. When the install IS deduped both resolve
- * to one module and the mirror is a harmless re-set. Best-effort: a resolution /
- * import failure leaves the editor on our copy's state (the deduped case).
- */
-let editorPiTuiPromise;
-function editorPiTui() {
-    if (!editorPiTuiPromise) {
-        editorPiTuiPromise = (async () => {
-            try {
-                const pcaEntry = import.meta.resolve('@earendil-works/pi-coding-agent');
-                const piTuiPath = createRequire(pcaEntry).resolve('@earendil-works/pi-tui');
-                return (await import(pathToFileURL(piTuiPath).href));
-            }
-            catch {
-                return undefined;
-            }
-        })();
-    }
-    return editorPiTuiPromise;
-}
-/** Register the manager on the editor's pi-tui instance too (see `editorPiTui`),
- *  so the editor's newline/submit handling honors the same (user-overridden)
- *  bindings as the rest of the viewer. Call once, after `createKeybindingsManager`. */
-export async function mirrorKeybindingsToEditor(km) {
-    (await editorPiTui())?.setKeybindings(km);
-}
-/** Mirror the negotiated kitty-keyboard-protocol flag onto the editor's pi-tui
- *  instance (ProcessTerminal sets it only on OUR copy). Call after the terminal
- *  has negotiated, i.e. after `tui.start()`. */
-export async function mirrorKittyProtocolToEditor(active) {
-    (await editorPiTui())?.setKittyProtocolActive(active);
-}
-/**
- * Resolve the `fd` binary path the @-mention file picker needs. pi-tui's
- * `CombinedAutocompleteProvider` only returns file suggestions when handed an
- * `fdPath` (its third ctor arg) — without it, typing `@` triggers the picker but
- * `getFuzzyFileSuggestions` returns `[]`, so the picker never appears.
- * pi's own interactive mode resolves this via `ensureTool('fd')` from its
- * internal `utils/tools-manager` (checks pi's managed bin dir + system PATH,
- * downloading the binary if missing). That module is NOT on pi-coding-agent's
- * `.`-only export map, so we reach it the same way we reach the editor's pi-tui
- * instance: resolve the package entry, then import the sibling file by URL
- * (file URLs bypass the bare-specifier exports gate). Best-effort: any
- * resolution/import failure (or no fd available) → `null`, and the picker stays
- * file-less rather than crashing.
- */
-let fdPathPromise;
-export function resolveFdPath() {
-    if (!fdPathPromise) {
-        fdPathPromise = (async () => {
-            try {
-                const pcaEntry = import.meta.resolve('@earendil-works/pi-coding-agent');
-                const toolsManagerUrl = new URL('./utils/tools-manager.js', pcaEntry).href;
-                const toolsManager = (await import(toolsManagerUrl));
-                return (await toolsManager.ensureTool('fd', true)) ?? null;
-            }
-            catch {
-                return null;
-            }
-        })();
-    }
-    return fdPathPromise;
-}
-/**
- * The user's theme name from pi settings — project (`<cwd>/.pi/settings.json`)
- * overrides global (`~/.pi/agent/settings.json`). `undefined` → pi's default.
- */
-export function loadThemeName(opts) {
-    const files = [
-        join(opts?.cwd ?? process.cwd(), '.pi', 'settings.json'),
-        join(opts?.agentDir ?? defaultAgentDir(), 'settings.json'),
-    ];
-    for (const file of files) {
-        try {
-            const raw = JSON.parse(readFileSync(file, 'utf8'));
-            if (raw && typeof raw === 'object' && typeof raw.theme === 'string') {
-                return raw.theme;
-            }
-        }
-        catch {
-            /* missing/malformed — try the next location */
-        }
-    }
-    return undefined;
-}
-/** Resolve + activate the user's theme so the reused pi components (markdown,
- *  editor, select-list themes) render at parity with the user's pi. */
-export function applyTheme(opts) {
-    initTheme(loadThemeName(opts));
-}
-const FAINT = (s) => `\x1b[2m${s}\x1b[22m`;
-const RED = (s) => `\x1b[31m${s}\x1b[39m`;
-const YELLOW = (s) => `\x1b[33m${s}\x1b[39m`;
-const GREEN = (s) => `\x1b[32m${s}\x1b[39m`;
-const BRIGHT_GREEN = (s) => `\x1b[92m${s}\x1b[39m`;
-const DIFF_REMOVED = (s) => `\x1b[91m${s}\x1b[39m`;
-// Terminals do not support alpha. This neutral charcoal is the dark-theme
-// equivalent of a low-opacity gray overlay, without borrowing the purple
-// selection surface used by interactive chrome.
-const CODE_BLOCK_BACKGROUND = '\x1b[48;2;36;36;36m';
-/** Paint a code-block fragment and keep its background active through the
- *  renderer's trailing spaces, so the surface reaches the transcript's edge.
- *  TUI applies a full reset after every rendered line. */
-function codeSurfaceFragment(render, text) {
-    return `${CODE_BLOCK_BACKGROUND}${render(text).replace(/\x1b\[0m/g, `\x1b[0m${CODE_BLOCK_BACKGROUND}`)}`;
-}
-/** Markdown theme for the attach transcript. Fenced code keeps pi's native
- *  shape and syntax, but its content is painted on a distinct theme surface. */
-export function attachMarkdownTheme() {
-    const base = getMarkdownTheme();
-    const paint = (render, text) => codeSurfaceFragment(render, text);
-    return {
-        ...base,
-        // `Markdown` emits this before each body line; leave the surface on until
-        // the following code fragment closes it.
-        codeBlockIndent: `${CODE_BLOCK_BACKGROUND}${base.codeBlockIndent ?? '  '}`,
-        codeBlock: (text) => paint(base.codeBlock, text),
-        codeBlockBorder: (text) => paint(base.codeBlockBorder, text),
-        highlightCode: base.highlightCode
-            ? (code, language) => base.highlightCode(code, language).map((line) => paint((value) => value, line))
-            : undefined,
-    };
-}
-/**
- * Build the attach chrome's color palette from the LIVE theme. Call AFTER
- * `applyTheme()` — the colors are pulled from pi's `getMarkdownTheme()` /
- * `getSelectListTheme()`, which read the active theme singleton at call time.
- *
- * pi does not re-export the raw `Theme` instance (its `.` export map omits the
- * `theme` const and `getEditorTheme`/`getTheme`), so the accent/border/muted hues
- * are sourced from the markdown + select-list theme colorizers, which ARE
- * re-exported and are themselves backed by `theme.fg(...)`. The two semantic
- * colors pi never exposes through that surface — `error`/`warning` — fall back to
- * standard ANSI red/yellow.
- */
-export function attachPalette() {
-    const md = getMarkdownTheme();
-    const sel = getSelectListTheme();
-    // The distinct-surface bg-on SGR, captured once. Re-asserted after every
-    // embedded `\x1b[0m` (full reset) inside a line so a coloured cell can't drop
-    // back to the default background mid-row; the line ends with `\x1b[49m` (reset
-    // background only) so the surface never bleeds onto the next line.
-    const bgOn = surfaceBgAnsi();
-    return {
-        accent: md.heading,
-        active: md.code,
-        info: md.link,
-        muted: sel.description,
-        faint: FAINT,
-        border: md.hr,
-        bold: md.bold,
-        error: RED,
-        warning: YELLOW,
-        diffAdded: GREEN,
-        diffRemoved: DIFF_REMOVED,
-        bashMode: GREEN,
-        bashModeAlt: BRIGHT_GREEN,
-        surface: (line) => `${bgOn}${line.replace(/\x1b\[0m/g, `\x1b[0m${bgOn}`)}\x1b[49m`,
-    };
-}
+var y=Object.defineProperty;var t=(e,o)=>y(e,"name",{value:o,configurable:!0});import{readFileSync as p}from"node:fs";import{createRequire as b}from"node:module";import{homedir as h}from"node:os";import{join as i}from"node:path";import{pathToFileURL as x}from"node:url";import{KeybindingsManager as K,TUI_KEYBINDINGS as w,setKeybindings as k}from"@earendil-works/pi-tui";import{initTheme as T,getMarkdownTheme as l,getSelectListTheme as E}from"@earendil-works/pi-coding-agent";import{surfaceBgAnsi as B}from"../../core/runtime/surface-bg.js";function s(){return i(h(),".pi","agent")}t(s,"defaultAgentDir");const I={"app.interrupt":{defaultKeys:"escape",description:"Cancel or abort"},"app.clear":{defaultKeys:"ctrl+c",description:"Clear editor"},"app.exit":{defaultKeys:"ctrl+d",description:"Exit when editor is empty"},"app.suspend":{defaultKeys:"ctrl+z",description:"Suspend to background"},"app.thinking.cycle":{defaultKeys:"shift+tab",description:"Cycle thinking level"},"app.model.cycleForward":{defaultKeys:"ctrl+p",description:"Cycle to next model"},"app.model.cycleBackward":{defaultKeys:"shift+ctrl+p",description:"Cycle to previous model"},"app.model.select":{defaultKeys:"ctrl+l",description:"Open model selector"},"app.tools.expand":{defaultKeys:"ctrl+o",description:"Toggle tool output"},"app.thinking.toggle":{defaultKeys:"ctrl+t",description:"Toggle thinking blocks"},"app.editor.external":{defaultKeys:"ctrl+g",description:"Open external editor"},"app.message.followUp":{defaultKeys:[],description:"Queue follow-up message"},"app.message.dequeue":{defaultKeys:"alt+up",description:"Restore queued messages"},"app.clipboard.pasteImage":{defaultKeys:["alt+v","ctrl+v"],description:"Paste image from clipboard"},"app.session.new":{defaultKeys:[],description:"Start a new session"},"app.session.tree":{defaultKeys:[],description:"Open session tree"},"app.session.fork":{defaultKeys:[],description:"Fork current session"},"app.session.resume":{defaultKeys:[],description:"Resume a session"}};function R(e=s()){try{const o=JSON.parse(p(i(e,"keybindings.json"),"utf8")),n=o&&typeof o=="object"&&"keybindings"in o?o.keybindings:o;return!n||typeof n!="object"?void 0:n}catch{return}}t(R,"loadUserKeybindings");const $={"tui.input.newLine":{defaultKeys:["shift+enter","alt+enter"],description:"Insert new line"}};function q(e=s()){const o={...w,...I,...$},n=new K(o,R(e));return k(n),n}t(q,"createKeybindingsManager");let a;function u(){return a||(a=(async()=>{try{const e=import.meta.resolve("@earendil-works/pi-coding-agent"),o=b(e).resolve("@earendil-works/pi-tui");return await import(x(o).href)}catch{return}})()),a}t(u,"editorPiTui");async function H(e){(await u())?.setKeybindings(e)}t(H,"mirrorKeybindingsToEditor");async function J(e){(await u())?.setKittyProtocolActive(e)}t(J,"mirrorKittyProtocolToEditor");let c;function V(){return c||(c=(async()=>{try{const e=import.meta.resolve("@earendil-works/pi-coding-agent");return await(await import(new URL("./utils/tools-manager.js",e).href)).ensureTool("fd",!0)??null}catch{return null}})()),c}t(V,"resolveFdPath");function N(e){const o=[i(e?.cwd??process.cwd(),".pi","settings.json"),i(e?.agentDir??s(),"settings.json")];for(const n of o)try{const r=JSON.parse(p(n,"utf8"));if(r&&typeof r=="object"&&typeof r.theme=="string")return r.theme}catch{}}t(N,"loadThemeName");function z(e){T(N(e))}t(z,"applyTheme");const P=t(e=>`\x1B[2m${e}\x1B[22m`,"FAINT"),C=t(e=>`\x1B[31m${e}\x1B[39m`,"RED"),O=t(e=>`\x1B[33m${e}\x1B[39m`,"YELLOW"),f=t(e=>`\x1B[32m${e}\x1B[39m`,"GREEN"),v=t(e=>`\x1B[92m${e}\x1B[39m`,"BRIGHT_GREEN"),D=t(e=>`\x1B[91m${e}\x1B[39m`,"DIFF_REMOVED"),d="\x1B[48;2;36;36;36m";function M(e,o){return`${d}${e(o).replace(/\x1b\[0m/g,`\x1B[0m${d}`)}`}t(M,"codeSurfaceFragment");function Q(){const e=l(),o=t((n,r)=>M(n,r),"paint");return{...e,codeBlockIndent:`${d}${e.codeBlockIndent??"  "}`,codeBlock:t(n=>o(e.codeBlock,n),"codeBlock"),codeBlockBorder:t(n=>o(e.codeBlockBorder,n),"codeBlockBorder"),highlightCode:e.highlightCode?(n,r)=>e.highlightCode(n,r).map(m=>o(g=>g,m)):void 0}}t(Q,"attachMarkdownTheme");function W(){const e=l(),o=E(),n=B();return{accent:e.heading,active:e.code,info:e.link,muted:o.description,faint:P,border:e.hr,bold:e.bold,error:C,warning:O,diffAdded:f,diffRemoved:D,bashMode:f,bashModeAlt:v,surface:t(r=>`${n}${r.replace(/\x1b\[0m/g,`\x1B[0m${n}`)}\x1B[49m`,"surface")}}t(W,"attachPalette");export{z as applyTheme,Q as attachMarkdownTheme,W as attachPalette,q as createKeybindingsManager,s as defaultAgentDir,N as loadThemeName,R as loadUserKeybindings,H as mirrorKeybindingsToEditor,J as mirrorKittyProtocolToEditor,V as resolveFdPath};

package/dist/clients/attach/input/capabilities.js

@@ -1,104 +1 @@
-/** Build the one authority for a viewer session. Remote viewers are observers
- * even when a caller supplied a controller role; keep that invariant local to
- * this construction boundary. */
-export function createViewerCapabilities(input) {
-    const remote = input.remote;
-    const role = remote ? 'observer' : input.role;
-    const permittedOperations = new Set();
-    // Viewer-local reads and inspection remain available to a local observer.
-    if (!remote) {
-        permittedOperations.add('local-canvas-inspect');
-        permittedOperations.add('canvas-inbox');
-    }
-    if (role === 'controller') {
-        permittedOperations.add('engine-drive');
-        permittedOperations.add('dequeue');
-        permittedOperations.add('wake-dormant');
-        permittedOperations.add('auth');
-        permittedOperations.add('canvas-resume');
-    }
-    return {
-        role,
-        remote,
-        nodeId: input.nodeId,
-        profileId: input.profileId,
-        permittedOperations,
-        permits: (operation) => permittedOperations.has(operation),
-        refusal: (operation, command) => {
-            const prefix = command === undefined ? '' : `/${command} `;
-            if (input.isBrokerOffline?.() === true
-                && (operation === 'engine-drive' || operation === 'dequeue' || operation === 'auth')) {
-                return `${prefix}needs a live broker; this node is parked — submit a message to wake it`;
-            }
-            if (permittedOperations.has(operation))
-                return undefined;
-            if (remote && (operation === 'canvas-resume' || operation === 'local-canvas-inspect' || operation === 'canvas-inbox')) {
-                return `${prefix}Read-only remote attach — not available with --canvas because it acts on this machine's local canvas`;
-            }
-            if (remote)
-                return `${prefix}Read-only remote attach — not available with --canvas (view-only)`;
-            return `${prefix}is not available to a read-only observer attach (--observer) — it would drive this node`;
-        },
-    };
-}
-/** The slash dispatcher asks the capability model for a command's operation;
- * commands with no returned operation are viewer-local/read-only. */
-export function viewerOperationForFrame(frame) {
-    switch (frame.type) {
-        case 'prompt':
-        case 'steer':
-        case 'follow_up':
-        case 'abort':
-        case 'bash':
-        case 'set_model':
-        case 'cycle_model':
-        case 'cycle_ladder':
-        case 'cycle_thinking':
-        case 'set_thinking_level':
-        case 'set_auto_retry':
-        case 'set_auto_compaction':
-        case 'compact':
-        case 'new_session':
-        case 'switch_session':
-        case 'fork':
-        case 'set_session_name':
-        case 'navigate_tree':
-        case 'reload':
-        case 'export':
-        case 'clone':
-        case 'share':
-        case 'reload_auth': return 'engine-drive';
-        default: return undefined;
-    }
-}
-export function viewerOperationForSlash(name, builtin, canvas) {
-    if (canvas) {
-        switch (name) {
-            case 'resume': return 'canvas-resume';
-            case 'context':
-            case 'node-metadata': return 'local-canvas-inspect';
-            // `/plugins` configures the local machine, not this node; observers and
-            // remote attaches can open its local popup.
-            case 'plugins': return undefined;
-            case 'inbox': return 'canvas-inbox';
-            case 'clear':
-            case 'promote':
-            case 'rename':
-            case 'resume-session':
-            case 'mcp': return 'engine-drive';
-            default: return undefined;
-        }
-    }
-    if (!builtin)
-        return undefined;
-    switch (name) {
-        case 'copy':
-        case 'session':
-        case 'changelog':
-        case 'hotkeys':
-        case 'quit': return undefined;
-        case 'login':
-        case 'logout': return 'auth';
-        default: return 'engine-drive';
-    }
-}
+var o=Object.defineProperty;var r=(e,s)=>o(e,"name",{value:s,configurable:!0});function l(e){const s=e.remote,t=s?"observer":e.role,a=new Set;return s||(a.add("local-canvas-inspect"),a.add("canvas-inbox")),t==="controller"&&(a.add("engine-drive"),a.add("dequeue"),a.add("wake-dormant"),a.add("auth"),a.add("canvas-resume")),{role:t,remote:s,nodeId:e.nodeId,profileId:e.profileId,permittedOperations:a,permits:r(n=>a.has(n),"permits"),refusal:r((n,i)=>{const c=i===void 0?"":`/${i} `;if(e.isBrokerOffline?.()===!0&&(n==="engine-drive"||n==="dequeue"||n==="auth"))return`${c}needs a live broker; this node is parked \u2014 submit a message to wake it`;if(!a.has(n))return s&&(n==="canvas-resume"||n==="local-canvas-inspect"||n==="canvas-inbox")?`${c}Read-only remote attach \u2014 not available with --canvas because it acts on this machine's local canvas`:s?`${c}Read-only remote attach \u2014 not available with --canvas (view-only)`:`${c}is not available to a read-only observer attach (--observer) \u2014 it would drive this node`},"refusal")}}r(l,"createViewerCapabilities");function u(e){switch(e.type){case"prompt":case"steer":case"follow_up":case"abort":case"bash":case"set_model":case"cycle_model":case"cycle_ladder":case"cycle_thinking":case"set_thinking_level":case"set_auto_retry":case"set_auto_compaction":case"compact":case"new_session":case"switch_session":case"fork":case"set_session_name":case"navigate_tree":case"reload":case"export":case"clone":case"share":case"reload_auth":return"engine-drive";default:return}}r(u,"viewerOperationForFrame");function v(e,s,t){if(t)switch(e){case"resume":return"canvas-resume";case"context":case"node-metadata":return"local-canvas-inspect";case"plugins":return;case"inbox":return"canvas-inbox";case"clear":case"promote":case"rename":case"resume-session":case"mcp":return"engine-drive";default:return}if(s)switch(e){case"copy":case"session":case"changelog":case"hotkeys":case"quit":return;case"login":case"logout":return"auth";default:return"engine-drive"}}r(v,"viewerOperationForSlash");export{l as createViewerCapabilities,u as viewerOperationForFrame,v as viewerOperationForSlash};

package/dist/clients/attach/input/clipboard-image.js

@@ -1,164 +1,7 @@
-// input/clipboard-image.ts — read the clipboard image for `crtr surface attach`.
-//
-// pi's `readClipboardImage` is NOT re-exported (it lives behind a native
-// clipboard binding + Photon worker the package gates off `.`-only exports), so
-// we reimplement the READ by shelling out to the platform clipboard tool. macOS:
-// `pngpaste` is a faster path IF present, but it is NOT a built-in (`brew install
-// pngpaste`), so the authoritative read is the dependency-free `osascript` path
-// (`the clipboard as «class PNGf»` → temp PNG), which works on a stock Mac.
-// Linux: `wl-paste` on Wayland, `xclip` on X11. The reader DISTINGUISHES three
-// outcomes — got bytes, clipboard genuinely empty, or no clipboard tool / read
-// failure — so the caller's notice is accurate ("No image in the clipboard" vs a
-// precise "install xclip" / "osascript failed") instead of collapsing every
-// miss to "no image".
-//
-// The bytes are then resized AGGRESSIVELY through pi's exported `resizeImage`
-// (which is reusable, unlike the reader) so the base64 stays well within the
-// broker's client-read line cap (`BROKER_READ_CAPS.maxLineBytes` = 24 MiB).
-// `resizeImage`'s `maxBytes` is the BASE64-PAYLOAD ceiling (it compares the
-// encoded size, not raw bytes — see image-resize-core), so MAX_BYTES (3 MiB)
-// bounds the base64 itself, far under 24 MiB. `resizeImage` already tries PNG and
-// JPEG and picks the smaller, so it doubles as format normalization;
-// `convertToPng` is the fallback when the Photon resizer is unavailable. The
-// fallbacks (convertToPng / raw bytes) are NOT size-bounded by `resizeImage`, so
-// each is gated on the SAME MAX_BYTES base64 ceiling: over it → the
-// image is DROPPED with a user-visible note rather than shipped as an over-cap
-// frame that would overflow BROKER_READ_CAPS.maxLineBytes (24 MiB) and destroy
-// the viewer socket. The result is an `ImageContent` (pi-ai) ready to drop
-// straight into a `prompt`/`steer`/`follow_up` frame's `images?` array (or, when
-// dropped, a `note`-only result and no image).
-import { spawnSync } from 'node:child_process';
-import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { convertToPng, formatDimensionNote, resizeImage, } from '@earendil-works/pi-coding-agent';
-/** Longest edge (px) the pasted image is resized to — aggressive, matches the
- *  ~1568px long-edge guidance vision models use. */
-const MAX_EDGE = 1568;
-/** Largest BASE64 payload per image — the ceiling for BOTH paths: passed as
- *  `resizeImage`'s `maxBytes` (which bounds the encoded base64, not raw bytes)
- *  on the primary path, and compared against the fallbacks' base64 length. 3 MiB
- *  base64, far under BROKER_READ_CAPS.maxLineBytes (24 MiB). */
-const MAX_BYTES = 3 * 1024 * 1024;
-/** Bound the shell read so a giant/garbage clipboard can't blow up memory. */
-const SPAWN_MAX_BUFFER = 64 * 1024 * 1024;
-const SPAWN_TIMEOUT_MS = 3000;
-/** Persist a (already-resized) clipboard image to a stable temp file and return
- *  its absolute path, so the attach editor can drop the PATH inline into the
- *  prompt instead of inlining base64 the agent can't see. The broker runs on the
- *  same host, so a tmpdir path is readable by the engine. */
-export function writeClipboardImageToFile(image) {
-    const dir = join(tmpdir(), 'crtr-clip-images');
-    mkdirSync(dir, { recursive: true });
-    const ext = image.mimeType === 'image/jpeg' ? 'jpg' : 'png';
-    const path = join(dir, `paste-${Date.now()}-${process.pid}.${ext}`);
-    writeFileSync(path, Buffer.from(image.data, 'base64'));
-    return path;
-}
-/** Read + resize the current clipboard image. Returns `null` ONLY when the
- *  clipboard genuinely holds no image; a `note`-only result means there is a
- *  precise reason to surface (no clipboard tool, read failure, or an over-cap
- *  drop). All best-effort — the caller shows a brief notice and carries on. */
-export async function readClipboardImage() {
-    const outcome = readRawClipboardImage();
-    const raw = outcome.image;
-    if (!raw) {
-        // No bytes. A `note` means a precise reason worth surfacing (no clipboard
-        // tool, or a read failure) — return it so the caller shows it instead of the
-        // generic "No image in the clipboard". No note → the clipboard is genuinely
-        // empty → null (caller shows the generic notice).
-        return outcome.note ? { note: outcome.note } : null;
-    }
-    // Primary path: resize aggressively. Handles format (PNG/JPEG) + size bound.
-    const resized = await resizeImage(new Uint8Array(raw.bytes), raw.mimeType, {
-        maxWidth: MAX_EDGE,
-        maxHeight: MAX_EDGE,
-        maxBytes: MAX_BYTES,
-    });
-    if (resized) {
-        return {
-            image: { type: 'image', data: resized.data, mimeType: resized.mimeType },
-            note: resized.wasResized ? formatDimensionNote(resized) : undefined,
-        };
-    }
-    // Fallback: the Photon resizer is unavailable — at least normalize to PNG so
-    // the engine gets a format it accepts. Capped at MAX_BYTES (base64).
-    const png = await convertToPng(raw.bytes.toString('base64'), raw.mimeType);
-    if (png)
-        return capped({ type: 'image', data: png.data, mimeType: png.mimeType });
-    // Last resort: ship the raw bytes — also capped, never an over-cap frame.
-    return capped({ type: 'image', data: raw.bytes.toString('base64'), mimeType: raw.mimeType });
-}
-/** Gate a FALLBACK image on the per-image base64 ceiling (MAX_BYTES): under it →
- *  attach; over → DROP with a user-visible note rather than ship a frame that
- *  would overflow the broker's 24 MiB read cap and destroy the viewer socket.
- *  base64 is ASCII, so its byte length equals the bytes the frame puts on the
- *  wire. */
-function capped(image) {
-    const encodedBytes = Buffer.byteLength(image.data);
-    if (encodedBytes <= MAX_BYTES)
-        return { image };
-    const mib = (n) => Math.round(n / (1024 * 1024));
-    return {
-        note: `Image not attached: ${mib(encodedBytes)} MiB exceeds the ${mib(MAX_BYTES)} MiB attach limit (clipboard resizer unavailable)`,
-    };
-}
-/** Shell out to the platform clipboard tool for raw image bytes. */
-function readRawClipboardImage() {
-    if (process.platform === 'darwin') {
-        return selectMacOutcome(run, readMacClipboardViaOsascript);
-    }
-    return selectLinuxOutcome(run, isWayland());
-}
-/** Pure macOS dispatch (the regression-test seam): try `pngpaste` if present,
- *  else fall through to the native osascript read — a missing `pngpaste` must
- *  NOT collapse to "no image", which was the stock-Mac bug. */
-export function selectMacOutcome(runTool, readNative) {
-    const fast = runTool('pngpaste', ['-']);
-    if (fast.bytes)
-        return { image: { bytes: fast.bytes, mimeType: 'image/png' } };
-    // pngpaste missing OR clipboard empty → osascript is authoritative.
-    return readNative();
-}
-/** Pure Linux dispatch (the regression-test seam): Wayland (`wl-paste`) first,
- *  then X11 (`xclip`), PNG then JPEG. If NO tool binary was found, surface a
- *  precise "install …" note; if a tool ran but found no image, report empty. */
-export function selectLinuxOutcome(runTool, wayland) {
-    let anyToolPresent = false;
-    if (wayland) {
-        const out = runTool('wl-paste', ['--type', 'image/png', '--no-newline']);
-        if (out.bytes)
-            return { image: { bytes: out.bytes, mimeType: 'image/png' } };
-        if (!out.missing)
-            anyToolPresent = true;
-    }
-    for (const mimeType of ['image/png', 'image/jpeg']) {
-        const out = runTool('xclip', ['-selection', 'clipboard', '-t', mimeType, '-o']);
-        if (out.bytes)
-            return { image: { bytes: out.bytes, mimeType } };
-        if (!out.missing)
-            anyToolPresent = true;
-    }
-    if (!anyToolPresent) {
-        return {
-            note: wayland
-                ? 'No clipboard tool found — install wl-clipboard (wl-paste) to paste images'
-                : 'No clipboard tool found — install xclip to paste images',
-        };
-    }
-    return {}; // a tool ran but the clipboard holds no image
-}
-/** AppleScript that writes the clipboard's PNG representation to the temp path
- *  in `argv`. `the clipboard as «class PNGf»` THROWS when the clipboard has no
- *  PNG-convertible image — caught → "NO_IMAGE" (a clean empty signal, distinct
- *  from a failure). A write failure (after `set eof` already truncated the file)
- *  closes the handle and returns "WRITE_FAILED" rather than swallowing the error
- *  and reporting a false "OK" over a 0-byte/partial file — so "OK" reliably means
- *  the full bytes are in the temp file, preserving the empty-vs-failure split. */
-const MAC_PNG_SCRIPT = `on run argv
+var g=Object.defineProperty;var o=(n,e)=>g(n,"name",{value:e,configurable:!0});import{spawnSync as c}from"node:child_process";import{mkdirSync as y,readFileSync as b,unlinkSync as h,writeFileSync as T}from"node:fs";import{tmpdir as m}from"node:os";import{join as a}from"node:path";import{convertToPng as w,formatDimensionNote as S,resizeImage as x}from"@earendil-works/pi-coding-agent";const p=1568,s=3*1024*1024,u=64*1024*1024,f=3e3;function F(n){const e=a(m(),"crtr-clip-images");y(e,{recursive:!0});const t=n.mimeType==="image/jpeg"?"jpg":"png",r=a(e,`paste-${Date.now()}-${process.pid}.${t}`);return T(r,Buffer.from(n.data,"base64")),r}o(F,"writeClipboardImageToFile");async function $(){const n=B(),e=n.image;if(!e)return n.note?{note:n.note}:null;const t=await x(new Uint8Array(e.bytes),e.mimeType,{maxWidth:p,maxHeight:p,maxBytes:s});if(t)return{image:{type:"image",data:t.data,mimeType:t.mimeType},note:t.wasResized?S(t):void 0};const r=await w(e.bytes.toString("base64"),e.mimeType);return l(r?{type:"image",data:r.data,mimeType:r.mimeType}:{type:"image",data:e.bytes.toString("base64"),mimeType:e.mimeType})}o($,"readClipboardImage");function l(n){const e=Buffer.byteLength(n.data);if(e<=s)return{image:n};const t=o(r=>Math.round(r/(1024*1024)),"mib");return{note:`Image not attached: ${t(e)} MiB exceeds the ${t(s)} MiB attach limit (clipboard resizer unavailable)`}}o(l,"capped");function B(){return process.platform==="darwin"?I(d,E):_(d,M())}o(B,"readRawClipboardImage");function I(n,e){const t=n("pngpaste",["-"]);return t.bytes?{image:{bytes:t.bytes,mimeType:"image/png"}}:e()}o(I,"selectMacOutcome");function _(n,e){let t=!1;if(e){const r=n("wl-paste",["--type","image/png","--no-newline"]);if(r.bytes)return{image:{bytes:r.bytes,mimeType:"image/png"}};r.missing||(t=!0)}for(const r of["image/png","image/jpeg"]){const i=n("xclip",["-selection","clipboard","-t",r,"-o"]);if(i.bytes)return{image:{bytes:i.bytes,mimeType:r}};i.missing||(t=!0)}return t?{}:{note:e?"No clipboard tool found \u2014 install wl-clipboard (wl-paste) to paste images":"No clipboard tool found \u2014 install xclip to paste images"}}o(_,"selectLinuxOutcome");const A=`on run argv
   set outPath to item 1 of argv
   try
-    set pngData to (the clipboard as «class PNGf»)
+    set pngData to (the clipboard as \xABclass PNGf\xBB)
   on error
     return "NO_IMAGE"
   end try
@@ -174,64 +17,4 @@ const MAC_PNG_SCRIPT = `on run argv
     return "WRITE_FAILED"
   end try
   return "OK"
-end run`;
-/** Native, dependency-free macOS read: osascript (always present) writes the
- *  clipboard PNG to a temp file we then read. Distinguishes empty ("NO_IMAGE")
- *  from a genuine read failure so the caller's notice is accurate. */
-function readMacClipboardViaOsascript() {
-    const tmpFile = join(tmpdir(), `crtr-clip-${process.pid}-${Date.now()}.png`);
-    try {
-        const result = spawnSync('osascript', ['-e', MAC_PNG_SCRIPT, tmpFile], {
-            timeout: SPAWN_TIMEOUT_MS,
-            maxBuffer: SPAWN_MAX_BUFFER,
-            encoding: 'utf-8',
-        });
-        if (result.error || result.status !== 0) {
-            return { note: 'Could not read the clipboard (osascript failed)' };
-        }
-        const signal = (result.stdout ?? '').trim();
-        if (signal === 'NO_IMAGE')
-            return {}; // clipboard genuinely holds no image
-        if (signal !== 'OK')
-            return { note: 'Could not read the clipboard image' };
-        let bytes;
-        try {
-            bytes = readFileSync(tmpFile);
-        }
-        catch {
-            return { note: 'Could not read the clipboard image' };
-        }
-        return bytes.length > 0 ? { image: { bytes, mimeType: 'image/png' } } : {};
-    }
-    finally {
-        try {
-            unlinkSync(tmpFile);
-        }
-        catch {
-            /* ignore temp-file cleanup errors (NO_IMAGE never created it) */
-        }
-    }
-}
-function isWayland() {
-    return Boolean(process.env.WAYLAND_DISPLAY) || process.env.XDG_SESSION_TYPE === 'wayland';
-}
-/** Run a clipboard tool; return its stdout bytes, or a `missing` flag when the
- *  binary isn't on PATH (so the caller can distinguish "no tool" from "no
- *  image"). Any other failure (non-zero exit, timeout, empty output) → an empty
- *  result ({}), i.e. the tool ran but yielded no image. */
-function run(command, args) {
-    const result = spawnSync(command, args, {
-        timeout: SPAWN_TIMEOUT_MS,
-        maxBuffer: SPAWN_MAX_BUFFER,
-    });
-    if (result.error) {
-        const missing = result.error.code === 'ENOENT';
-        return { missing };
-    }
-    if (result.status !== 0)
-        return {};
-    const stdout = result.stdout;
-    if (!stdout || stdout.length === 0)
-        return {};
-    return { bytes: Buffer.isBuffer(stdout) ? stdout : Buffer.from(stdout) };
-}
+end run`;function E(){const n=a(m(),`crtr-clip-${process.pid}-${Date.now()}.png`);try{const e=c("osascript",["-e",A,n],{timeout:f,maxBuffer:u,encoding:"utf-8"});if(e.error||e.status!==0)return{note:"Could not read the clipboard (osascript failed)"};const t=(e.stdout??"").trim();if(t==="NO_IMAGE")return{};if(t!=="OK")return{note:"Could not read the clipboard image"};let r;try{r=b(n)}catch{return{note:"Could not read the clipboard image"}}return r.length>0?{image:{bytes:r,mimeType:"image/png"}}:{}}finally{try{h(n)}catch{}}}o(E,"readMacClipboardViaOsascript");function M(){return!!process.env.WAYLAND_DISPLAY||process.env.XDG_SESSION_TYPE==="wayland"}o(M,"isWayland");function d(n,e){const t=c(n,e,{timeout:f,maxBuffer:u});if(t.error)return{missing:t.error.code==="ENOENT"};if(t.status!==0)return{};const r=t.stdout;return!r||r.length===0?{}:{bytes:Buffer.isBuffer(r)?r:Buffer.from(r)}}o(d,"run");export{$ as readClipboardImage,_ as selectLinuxOutcome,I as selectMacOutcome,F as writeClipboardImageToFile};