@iseoane/agent-depot 0.6.13 → 0.6.15

package/dist/src/tui/catalog-panel.js

@@ -1,12 +1,13 @@
 import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { Box, Text } from "ink";
-import { describeSkills, HOST_CHOICES, SCOPE_CHOICES } from "./catalog-actions.js";
+import { Box } from "ink";
+import { Text } from "./safe-text.js";
+import { describeSkills, HOST_CHOICES, installPreview, SCOPE_CHOICES } from "./catalog-actions.js";
 import { packageOwnedSkillNotice, packageOwnerBadge } from "./catalog-ownership.js";
-import { skillKey } from "./catalog-tree.js";
 import { hasUnmanagedCopy } from "./catalog-installs.js";
-import { describeRow, truncateDescription, UNMANAGED_MARKER } from "./catalog-tree.js";
+import { describeRow, singleLine, truncateDescription, UNMANAGED_MARKER } from "./catalog-tree.js";
 import { isPackageMode, PackagePanel } from "./package-actions.js";
-import { BorderPanel, DecisionPrompt, HostChecklist, PreviewLines, Working } from "./panel-parts.js";
+import { BorderPanel, DecisionPrompt, HostChecklist, PagedPreview, Working } from "./panel-parts.js";
+import { usePreviewGeometry } from "./preview-window.js";
 import { rowStyle } from "./theme.js";
 import { theme } from "./theme.js";
 /** Scope and counts, the filter line, and why the list may be empty. */
@@ -19,7 +20,7 @@ export function CatalogRowLine({ row, selected, marked, installed }) {
     const isGroup = data.kind === "source" || data.kind === "group";
     const ownedBy = data.kind === "skill" ? data.ownedBy : undefined;
     return (_jsxs(Text, { ...rowStyle(selected), color: isGroup ? theme.group : undefined, wrap: "truncate-end", children: [selected ? "> " : "  ", "  ".repeat(row.depth), data.kind === "skill" ? marked ? "[x] " : "[ ] " : "", data.kind === "skill" && ownedBy !== undefined
-                ? _jsxs(_Fragment, { children: [data.skill.name, _jsxs(Text, { color: theme.marker, children: ["  ", "[", packageOwnerBadge(ownedBy), "]"] }), "  ", truncateDescription(data.skill.description), data.variant === true ? `  (${data.skill.path})` : ""] })
+                ? _jsxs(_Fragment, { children: [singleLine(data.skill.name), _jsxs(Text, { color: theme.marker, children: ["  ", "[", packageOwnerBadge(ownedBy), "]"] }), "  ", truncateDescription(data.skill.description), data.variant === true ? `  (${data.skill.path})` : ""] })
                 : data.kind === "app" ? `App ${data.row.entry.recipe?.name ?? data.row.entry.file}` : describeRow(row), data.kind === "app" ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.legend, children: "  " }), _jsx(Text, { color: data.row.inspection.status === "not installed" ? theme.warning : theme.value, children: data.row.inspection.status })] })) : null, data.kind === "skill" && hasUnmanagedCopy(data.skill, installed)
                 ? _jsxs(Text, { color: theme.marker, children: ["  ", UNMANAGED_MARKER] })
                 : null] }));
@@ -29,6 +30,11 @@ export function CatalogSelectionHelp({ row, height }) {
     const owner = row?.node.data.kind === "skill" ? row.node.data.ownedBy : undefined;
     return (_jsx(Box, { flexDirection: "column", minHeight: height, children: owner === undefined ? null : _jsx(Text, { color: theme.marker, children: packageOwnedSkillNotice(owner) }) }));
 }
+/** The install confirmation with the shared footer; the view shows it alone so no tree rows count against its height. */
+export function InstallConfirmPanel({ mode }) {
+    const { lines, chrome } = installPreview(mode.items);
+    return _jsx(PagedPreview, { lines: lines, viewport: usePreviewGeometry()(lines, mode.cursor, chrome) });
+}
 /** The prompt of the install flow; browsing shows nothing. */
 export function ActionPanel({ mode }) {
     if (isPackageMode(mode))
@@ -44,17 +50,13 @@ export function ActionPanel({ mode }) {
             return _jsx(BorderPanel, { title: "Skill version policy", children: _jsx(Text, { children: "1 latest  2 fixed  (Esc cancel)" }) });
         case "fixed":
             return _jsx(BorderPanel, { title: "Fixed Skill version", children: _jsxs(Text, { children: [mode.value, "_  (Enter confirm, Esc cancel)"] }) });
-        case "confirm-install": {
-            const ready = mode.items.filter((item) => item.prepared !== undefined);
-            const single = mode.items.length === 1;
-            const projectTarget = ready[0]?.prepared?.projectTarget ?? [];
-            return (_jsxs(BorderPanel, { title: `Skill install preview · ${ready.length} ready`, children: [projectTarget.length === 0 ? null : _jsx(PreviewLines, { lines: projectTarget }), mode.items.map(({ skill, prepared, error }) => prepared === undefined ? (_jsxs(Text, { color: theme.error, children: ["Cannot install ", skill.name, ": ", error] }, skillKey(skill))) : (_jsxs(Box, { flexDirection: "column", children: [single ? null : _jsx(Text, { color: theme.group, children: skill.name }), _jsx(PreviewLines, { lines: prepared.preview })] }, skillKey(skill)))), ready.some((item) => item.prepared?.runsExternalCommand) ? _jsx(Text, { color: theme.warning, children: "This install runs an external command (see above)." }) : null, _jsxs(DecisionPrompt, { children: ["Install ", describeSkills(ready.map((item) => item.skill)), "?"] })] }));
-        }
+        case "confirm-install":
+            return _jsx(InstallConfirmPanel, { mode: mode });
         case "confirm-exposure": {
             const names = mode.items.filter((item) => item.prepared?.additionalHostExposure).map((item) => item.skill.name);
             return (_jsx(BorderPanel, { title: `Skill Host exposure · ${names.length} confirmation`, children: _jsxs(Text, { color: theme.warning, children: [names.length === 1 ? `An identical ${names[0]} already exists` : `Identical copies of ${names.join(", ")} already exist`, "; adding the missing Host location needs separate confirmation. ", _jsx(DecisionPrompt, { children: "Confirm?" })] }) }));
         }
         case "busy":
-            return _jsx(BorderPanel, { title: "Skill install", children: _jsx(Working, { label: mode.label, since: mode.startedAt }) });
+            return (_jsxs(BorderPanel, { title: "Skill install", children: [_jsx(Working, { label: mode.label, since: mode.startedAt }), (mode.done ?? []).length > 0 ? _jsxs(Text, { color: theme.muted, children: [mode.done.length, " finished"] }) : null] }));
     }
 }

package/dist/src/tui/catalog-tree.js

@@ -8,8 +8,13 @@ export const UNMANAGED_MARKER = "on disk, unmanaged · adopt it from Installatio
 export const skillKey = (skill) => `skill:${skill.sourceId}:${skill.path}`;
 /** Keyed on the full selection, so two plugins of one marketplace root stay distinct nodes. */
 export const bundleKey = (entry) => `bundle:${entry.sourceId}:${selectionKey(entry.selection)}`;
+/** A Skill's name or description on one row; a line break from a remote SKILL.md would add rows to the list window. */
+export function singleLine(text) {
+    return text.replace(/[\r\n]+/gu, " ");
+}
 export function truncateDescription(text) {
-    return text.length > DESCRIPTION_LIMIT ? `${text.slice(0, DESCRIPTION_LIMIT - 3)}...` : text;
+    const line = singleLine(text);
+    return line.length > DESCRIPTION_LIMIT ? `${line.slice(0, DESCRIPTION_LIMIT - 3)}...` : line;
 }
 /** A repository name, with directory and ref for scoped GitHub Sources. */
 export function sourceLabel(source) {
@@ -107,7 +112,7 @@ export function describeRow(row) {
     }
     if (data.kind === "app")
         return `App ${data.row.entry.recipe?.name ?? data.row.entry.file}  ${data.row.inspection.status}`;
-    return `${data.skill.name}  ${truncateDescription(data.skill.description)}${data.variant === true ? `  (${data.skill.path})` : ""}`;
+    return `${singleLine(data.skill.name)}  ${truncateDescription(data.skill.description)}${data.variant === true ? `  (${data.skill.path})` : ""}`;
 }
 /** Skill nodes inside a Source's Skills group, directly or within one of its variant groups. */
 function skillNodesOf(roots) {

package/dist/src/tui/catalog-view.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text, useWindowSize } from "ink";
+import { Box, useWindowSize } from "ink";
+import { Text } from "./safe-text.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { createAppOperations } from "../app-flow.js";
 import { BROWSE } from "./catalog-actions.js";
@@ -8,7 +9,7 @@ import { filterSkills } from "./catalog-filter.js";
 import { handleCatalogActionKey } from "./catalog-flow.js";
 import { isInstalled } from "./catalog-installs.js";
 import { AppPanel, handleAppKey, startAppAction } from "./app-actions.js";
-import { ActionPanel, CatalogHeader, CatalogRowLine, CatalogSelectionHelp } from "./catalog-panel.js";
+import { ActionPanel, CatalogHeader, InstallConfirmPanel, CatalogRowLine, CatalogSelectionHelp } from "./catalog-panel.js";
 import { packageOwnedSkillNotice } from "./catalog-ownership.js";
 import { packageOperationsOf } from "./environment.js";
 import { handlePackageKey, isPackageMode, PackagePanel, startPackageAction } from "./package-actions.js";
@@ -21,6 +22,7 @@ import { invalidateRetention } from "./view-retention.js";
 import { useLoadingSince, useMarks, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
+import { usePreviewGeometry } from "./preview-window.js";
 const NO_ENVIRONMENT = {};
 function wrappedLineCount(text, columns) {
     let lines = 1;
@@ -41,7 +43,8 @@ function wrappedLineCount(text, columns) {
     return lines;
 }
 export function CatalogView({ operations, sourceId, onCapturingChange, environment, listHeight, retention }) {
-    const { columns, rows: terminalRows } = useWindowSize();
+    const { columns } = useWindowSize();
+    const previewGeometry = usePreviewGeometry();
     const env = environment ?? NO_ENVIRONMENT;
     const [all, setAll] = useState(sourceId === undefined);
     const mounted = useMounted();
@@ -110,6 +113,7 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
     const flow = {
         operations,
         env,
+        previewGeometry,
         setAction,
         setMessage,
         isMounted: () => mounted.current,
@@ -158,7 +162,7 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
             setAction(BROWSE);
         },
     };
-    const packageContext = { packages, manage: packageHost, terminalRows: terminalRows || 24, terminalColumns: columns || 80 };
+    const packageContext = { packages, manage: packageHost, previewGeometry };
     const browse = {
         navigation,
         height,
@@ -168,14 +172,14 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
         ready: state.status === "ready" && appCatalog.status === "ready",
         toggleAll: () => setAll((value) => !value),
         startPackage: (target) => void startPackageAction(packageContext, target, "i"),
-        startApp: (entry) => void startAppAction({ apps, manage: appManage, terminalRows: terminalRows || 24, terminalColumns: columns || 80 }, [entry], "i"),
+        startApp: (entry) => void startAppAction({ apps, manage: appManage, previewGeometry }, [entry], "i"),
         setMessage,
         setAction,
     };
     useKeys((input, key) => {
         const runningAppMode = appModeRef.current;
         if (runningAppMode !== undefined)
-            handleAppKey({ apps, manage: appManage, terminalRows: terminalRows || 24, terminalColumns: columns || 80 }, runningAppMode, input, key);
+            handleAppKey({ apps, manage: appManage, previewGeometry }, runningAppMode, input, key);
         else {
             const mode = actionRef.current;
             if (isPackageMode(mode))
@@ -200,5 +204,7 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
     // A paged declaration owns the view: rows of the tree above it would not be counted in its height.
     if (isPackageMode(action))
         return _jsx(PackagePanel, { mode: action });
+    if (action.kind === "confirm-install")
+        return _jsx(InstallConfirmPanel, { mode: action });
     return (_jsxs(Box, { flexDirection: "column", children: [refreshing ? _jsx(Working, { label: "Refreshing catalog (last data shown)\u2026", since: refreshingSince }) : null, state.warnings.map((warning) => _jsx(Text, { color: theme.warning, children: warning }, warning)), appCatalog.status === "ready" && appCatalog.error ? _jsxs(Text, { color: theme.error, children: ["Apps unavailable: ", appCatalog.error] }) : null, _jsx(CatalogHeader, { scope: scope, listed: visible.length, installable: installable.length, total: skills.length, appCount: visibleApps.length, filter: filter.filter }), rows.slice(window.start, window.end).map((row, offset) => (_jsx(CatalogRowLine, { row: row, selected: window.start + offset === index, marked: marks.marked.has(row.node.id), installed: installed }, row.node.id))), _jsx(CatalogSelectionHelp, { row: rows[index], height: helpLines }), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), appMode ? _jsx(AppPanel, { mode: appMode }) : _jsx(ActionPanel, { mode: action })] }));
 }

package/dist/src/tui/file-picker.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import path from "node:path";
-import { Text, useWindowSize } from "ink";
+import { useWindowSize } from "ink";
+import { Text } from "./safe-text.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { pickerEntries, readDirectoryListing, PROFILE_EXTENSION } from "./file-picker-model.js";
 import { useKeys } from "./keys.js";

package/dist/src/tui/installations-browse.js

@@ -107,7 +107,7 @@ function actOnRow(context, snapshot, row, input, key) {
     else if (item.kind === "app") {
         if (input === "A")
             context.setMessage({ kind: "error", text: "Adoption applies to unmanaged Skills, not Apps" });
-        else if (key.return && item.row.inspection.status !== "needs approval") {
+        else if (key.return && item.row.inspection.status !== "needs approval" && !item.row.inspection.needsApproval) {
             const { entry, inspection } = item.row;
             const approved = inspection.status === "installed" || inspection.status === "not installed";
             context.setMessage({

package/dist/src/tui/installations-panel.js

@@ -1,9 +1,17 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { Box, Text } from "ink";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box } from "ink";
+import { Text } from "./safe-text.js";
+import { adoptionPreview } from "./adoption-actions.js";
 import { HOST_CHOICES } from "./catalog-actions.js";
 import { ManagePanel } from "./manage-panel.js";
-import { DecisionPrompt, HostChecklist, PreviewLines } from "./panel-parts.js";
+import { DecisionPrompt, HostChecklist, PagedPreview } from "./panel-parts.js";
+import { usePreviewGeometry } from "./preview-window.js";
 import { theme } from "./theme.js";
+/** An adoptable preview with the shared footer; the view shows it alone so no tree rows count against its height. */
+export function AdoptionConfirmPanel({ mode }) {
+    const { lines, chrome } = adoptionPreview(mode);
+    return _jsx(PagedPreview, { lines: lines, viewport: usePreviewGeometry()(lines, mode.cursor, chrome) });
+}
 /** The prompt of the adoption and manage modes; browsing shows nothing. */
 export function ModePanel({ mode }) {
     switch (mode.kind) {
@@ -18,7 +26,7 @@ export function ModePanel({ mode }) {
         case "fixed":
             return _jsxs(Text, { children: ["Fixed version: ", mode.value, "_  (Enter confirm, Esc cancel)"] });
         case "confirm":
-            return mode.adoption.verdict.adoptable ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(PreviewLines, { lines: mode.adoption.prepared.preview }), mode.adoption.prepared.runsExternalCommand ? _jsx(Text, { color: theme.warning, children: "This install runs an external command (see above)." }) : null, _jsxs(DecisionPrompt, { children: ["Adopt ", mode.entry.name, "?"] })] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.error, children: mode.adoption.verdict.reason }), _jsx(Text, { children: "Enter/Esc to go back" })] }));
+            return mode.adoption.verdict.adoptable ? (_jsx(AdoptionConfirmPanel, { mode: mode })) : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.error, children: mode.adoption.verdict.reason }), _jsx(Text, { children: "Enter/Esc to go back" })] }));
         case "confirm-exposure":
             return (_jsxs(Text, { color: theme.warning, children: ["Adopting ", mode.entry.name, " adds the missing Host location and exposes it to more hosts; this needs separate confirmation (CLI: --confirm-additional-host). ", _jsx(DecisionPrompt, { children: "Confirm?" })] }));
         default:

package/dist/src/tui/installations-rows.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Text } from "ink";
+import { Text } from "./safe-text.js";
 import { describeLinks, describeNode, markersOf } from "./installations-tree.js";
 import { rowStyle, theme } from "./theme.js";
 function AppDetails({ row }) {
     const version = row.inspection.installedVersion;
     const statusColor = row.inspection.status === "invalid" ? theme.error : theme.warning;
     const invalid = row.inspection.status === "invalid" ? ` · invalid recipe: ${row.inspection.reason ?? "unknown error"}` : "";
-    return (_jsxs(Text, { children: [_jsx(Text, { color: theme.legend, children: "  " }), _jsx(Text, { color: version === undefined ? statusColor : theme.version, children: version ?? row.inspection.status }), row.inspection.evidence === "recorded" ? _jsx(Text, { color: theme.value, children: " (recorded)" }) : null, invalid === "" ? null : _jsx(Text, { color: theme.error, children: invalid })] }));
+    return (_jsxs(Text, { children: [_jsx(Text, { color: theme.legend, children: "  " }), _jsx(Text, { color: version === undefined ? statusColor : theme.version, children: version ?? row.inspection.status }), row.inspection.evidence === "recorded" ? _jsx(Text, { color: theme.value, children: " (recorded)" }) : null, row.inspection.needsApproval ? _jsx(Text, { color: theme.warning, children: " \u00B7 needs approval" }) : null, invalid === "" ? null : _jsx(Text, { color: theme.error, children: invalid })] }));
 }
 function PackageDetails({ row }) {
     const version = row.installedVersion;

package/dist/src/tui/installations-tree.js

@@ -79,7 +79,7 @@ export function describeNode(row) {
             return `${name}  invalid recipe: ${inspection.reason}`;
         const version = inspection.installedVersion ?? inspection.status;
         const invalid = inspection.status === "invalid" ? ` · invalid recipe: ${inspection.reason}` : "";
-        return `${name}  ${version}${inspection.evidence === "recorded" ? " (recorded)" : ""}${invalid}`;
+        return `${name}  ${version}${inspection.evidence === "recorded" ? " (recorded)" : ""}${inspection.needsApproval ? " · needs approval" : ""}${invalid}`;
     }
     return `${data.group.name} [${data.group.hosts.join(", ")}]`;
 }

package/dist/src/tui/installations-view.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text, useWindowSize } from "ink";
+import { Box } from "ink";
+import { Text } from "./safe-text.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createAppOperations } from "../app-flow.js";
 import { AppPanel, handleAppKey, isAppMode, startAppAction } from "./app-actions.js";
@@ -10,8 +11,9 @@ import { BROWSE } from "./installations-mode.js";
 import { errorText } from "./batch.js";
 import { handleAdoptionKey, startAdoption } from "./adoption-actions.js";
 import { handleBrowseKey } from "./installations-browse.js";
-import { handleManageKey } from "./manage-actions.js";
-import { ModePanel } from "./installations-panel.js";
+import { handleManageKey, isPagedConfirmMode } from "./manage-actions.js";
+import { PagedConfirmPanel } from "./manage-panel.js";
+import { AdoptionConfirmPanel, ModePanel } from "./installations-panel.js";
 import { TreeRowLine } from "./installations-rows.js";
 import { buildTree, leavesOf, markersOf } from "./installations-tree.js";
 import { ListFooter, Working } from "./panel-parts.js";
@@ -23,10 +25,11 @@ import { useLoadingSince, useMarks, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
 import { invalidateRetention } from "./view-retention.js";
+import { usePreviewGeometry } from "./preview-window.js";
 const NO_ENVIRONMENT = {};
 const LEGEND = "adopted: tracked in place · modified: changed on disk";
 export function InstallationsView({ operations, environment, onCapturingChange, listHeight, retention }) {
-    const { rows: terminalRows, columns: terminalColumns } = useWindowSize();
+    const previewGeometry = usePreviewGeometry();
     const height = useListHeight(listHeight, 7);
     const env = environment ?? NO_ENVIRONMENT;
     const apps = useMemo(() => createAppOperations({ homeDirectory: env.homeDirectory, ...env.appEnvironment }), [env]);
@@ -148,6 +151,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         operations,
         env,
         installed,
+        previewGeometry,
         setMode,
         browse: () => setMode(BROWSE),
         setMessage,
@@ -165,6 +169,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     const adoption = {
         operations,
         env,
+        previewGeometry,
         setMode,
         browse: manage.browse,
         setMessage,
@@ -180,16 +185,16 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         packages,
         startAdoption: (group) => void startAdoption(adoption, group),
         setMessage,
-        startApps: (entries, input) => void startAppAction({ apps, manage, terminalRows: terminalRows || 24, terminalColumns: terminalColumns || 80 }, entries, input),
+        startApps: (entries, input) => void startAppAction({ apps, manage, previewGeometry }, entries, input),
     };
     useKeys((input, key) => {
         const current = modeRef.current;
         if (current.kind === "browse")
             handleBrowseKey(browse, input, key);
         else if (isPackageMode(current))
-            handlePackageKey({ packages, manage, terminalRows: terminalRows || 24, terminalColumns: terminalColumns || 80 }, current, input, key);
+            handlePackageKey({ packages, manage, previewGeometry }, current, input, key);
         else if (isAppMode(current))
-            handleAppKey({ apps, manage, terminalRows: terminalRows || 24, terminalColumns: terminalColumns || 80 }, current, input, key);
+            handleAppKey({ apps, manage, previewGeometry }, current, input, key);
         else if (!handleManageKey(manage, current, input, key))
             handleAdoptionKey(adoption, current, input, key);
     });
@@ -202,6 +207,10 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     // A paged declaration owns the view: rows of the tree above it would not be counted in its height.
     if (isPackageMode(mode))
         return _jsx(PackagePanel, { mode: mode });
+    if (isPagedConfirmMode(mode))
+        return _jsx(PagedConfirmPanel, { mode: mode });
+    if (mode.kind === "confirm" && mode.adoption.verdict.adoptable)
+        return _jsx(AdoptionConfirmPanel, { mode: mode });
     const ready = state.data;
     const window = computeWindow(rows.length, index, height);
     const listed = rows.slice(window.start, window.end);

package/dist/src/tui/keys.js

@@ -1,4 +1,5 @@
 import { useInput } from "ink";
+import { useRef } from "react";
 /** Plain printable characters only: control characters and escape sequences are never split. */
 const PRINTABLE = /^[^\p{Cc}]+$/u;
 /**
@@ -10,22 +11,52 @@ const PRINTABLE = /^[^\p{Cc}]+$/u;
  */
 const ESCAPE_REMNANT = /^(?:\[[\d;<:?]*[A-DFHIMOPQRSZm~]|O[A-DFHPQRS])$/;
 const PASTE_MARKERS = new Set(["[200~", "[201~"]);
+/** Keys that did not arrive alone: split off a multi-character block, or read after another key in the same turn. */
+const groupedKeys = new WeakSet();
+/**
+ * Whether this key press is a `y` that answers a confirmation. A `y` that arrived together with other
+ * keys never does: they may have opened the question or moved the cursor to its end before it was drawn.
+ * Text fields read `input` directly, so pasted text still reaches them.
+ */
+export function isYes(input, key) {
+    return input === "y" && !groupedKeys.has(key);
+}
+function grouped(key) {
+    const copy = { ...key };
+    groupedKeys.add(copy);
+    return copy;
+}
+/**
+ * The most events any hook has read this turn. A hook that mounts mid-read starts its own count at 0, but the hooks that were already
+ * listening have counted the keys it missed, so this tells it that it is not at the start of the turn.
+ */
+let eventsInTurn = 0;
 /**
  * `useInput` that treats several plain characters delivered in one write (fast
- * typing, a paste) as the separate key presses they are, in order.
+ * typing, a paste) as the separate key presses they are, in order. Ink also hands
+ * the escape sequences of one read over as separate events within one turn; every key
+ * after the first of a turn counts as grouped, in any hook, as do all characters of a split block.
  */
 export function useKeys(handler) {
+    const eventsThisTurn = useRef(0);
     useInput((input, key) => {
+        if (eventsInTurn === 0)
+            queueMicrotask(() => { eventsInTurn = 0; });
+        if (eventsThisTurn.current++ === 0)
+            queueMicrotask(() => { eventsThisTurn.current = 0; });
+        eventsInTurn = Math.max(eventsInTurn, eventsThisTurn.current);
+        const later = eventsThisTurn.current > 1 || eventsInTurn > 1;
         if (ESCAPE_REMNANT.test(input)) {
             if (!PASTE_MARKERS.has(input))
-                handler(input, key);
+                handler(input, later ? grouped(key) : key);
             return;
         }
         if (input.length > 1 && !key.ctrl && !key.meta && !key.escape && PRINTABLE.test(input)) {
+            const blockKey = grouped(key);
             for (const character of input)
-                handler(character, key);
+                handler(character, blockKey);
             return;
         }
-        handler(input, key);
+        handler(input, later ? grouped(key) : key);
     });
 }

package/dist/src/tui/manage-actions.js

@@ -2,9 +2,9 @@ import { APP_KINDS } from "./app-actions.js";
 import { PACKAGE_KINDS } from "./package-actions.js";
 import { globalRecord, missingHosts, prepareHostAddition, prepareHostRemoval, prepareUninstall, runHostAddition, runHostRemoval, runUninstall, UNINSTALL_REFUSALS, } from "./catalog-installs.js";
 import { errorText } from "./batch.js";
-import { BULK_KINDS, handleBulkKey } from "./bulk-actions.js";
-import { answerYesNo, applyChecklistOutcome, hostChecklistKey } from "./mode-keys.js";
-import { handleUnmanagedKey, UNMANAGED_KINDS } from "./unmanaged-actions.js";
+import { BULK_KINDS, bulkConfirmPreview, handleBulkKey } from "./bulk-actions.js";
+import { answerYesNo, applyChecklistOutcome, hostChecklistKey, movePreviewCursor } from "./mode-keys.js";
+import { handleUnmanagedKey, UNMANAGED_KINDS, unmanagedConfirmPreview } from "./unmanaged-actions.js";
 import { busy } from "./working-model.js";
 const MANAGE_KINDS = new Set([
     "remove-scope",
@@ -43,7 +43,7 @@ async function startFullUninstall(context, skill) {
         if (!context.isMounted())
             return;
         if (prepared.kind === "ready") {
-            context.setMode({ kind: "confirm-uninstall", skill, prepared });
+            context.setMode({ kind: "confirm-uninstall", skill, prepared, cursor: 0 });
             return;
         }
         context.setMessage({ kind: "error", text: UNINSTALL_REFUSALS[prepared.kind] });
@@ -73,13 +73,13 @@ async function startHostChange(context, mode) {
             const prepared = await prepareHostAddition(operations, env, mode.skill, installed, mode.selected);
             if (!context.isMounted())
                 return;
-            context.setMode({ kind: "confirm-host-add", skill: mode.skill, prepared });
+            context.setMode({ kind: "confirm-host-add", skill: mode.skill, prepared, cursor: 0 });
         }
         else {
             const prepared = await prepareHostRemoval(operations, env, mode.skill, installed, mode.selected);
             if (!context.isMounted())
                 return;
-            context.setMode({ kind: "confirm-host-remove", skill: mode.skill, prepared });
+            context.setMode({ kind: "confirm-host-remove", skill: mode.skill, prepared, cursor: 0 });
         }
     }
     catch (error) {
@@ -117,35 +117,61 @@ function handleRemoveScopeKey(context, mode, input, key) {
     else if (input === "2")
         context.setMode({ kind: "hosts-remove", skill: mode.skill, choices: mode.hosts, cursor: 0, selected: [] });
 }
-/** Keys of the confirmation modes: `y` runs the step (or asks for exposure consent first), `n`/Esc cancels. */
-function handleConfirmKey(context, mode, input, key) {
-    const { operations, env } = context;
-    const cancelWith = (text) => () => cancel(context, text);
+/** What a paged confirmation shows, so the key handler and the panel page the same rows. */
+export function pagedConfirmPreview(mode) {
+    if (mode.kind === "confirm-unmanaged")
+        return unmanagedConfirmPreview(mode);
+    if (mode.kind === "confirm-bulk-uninstall" || mode.kind === "confirm-bulk-hosts")
+        return bulkConfirmPreview(mode);
+    const name = mode.skill.name;
     switch (mode.kind) {
         case "confirm-host-add":
-            answerYesNo(input, key, () => context.setMode({ ...mode, kind: "confirm-host-exposure" }), cancelWith("Install cancelled"));
-            return;
-        case "confirm-host-exposure":
-            answerYesNo(input, key, () => {
-                void execute(context, `Changing hosts of ${mode.skill.name}…`, () => runHostAddition(mode.prepared, operations, env));
-            }, cancelWith("Install cancelled"));
-            return;
+            return { lines: mode.prepared.preview, chrome: { title: "Add hosts", action: `Add hosts to ${name}`, consequence: `Add hosts to ${name}? y/n` } };
         case "confirm-host-remove":
-            answerYesNo(input, key, () => {
-                void execute(context, `Changing hosts of ${mode.skill.name}…`, () => runHostRemoval(mode.prepared, operations, env, mode.skill));
-            }, cancelWith("Uninstall cancelled"));
-            return;
+            return { lines: mode.prepared.preview, chrome: { title: "Remove hosts", action: `Remove hosts from ${name}`, consequence: `Remove hosts from ${name}? y/n` } };
         case "confirm-uninstall":
-            answerYesNo(input, key, () => {
+            return { lines: mode.prepared.plan.preview, chrome: { title: "Uninstall", action: `Uninstall ${name}`, consequence: `Uninstall ${name}? y/n` } };
+    }
+}
+export function isPagedConfirmMode(mode) {
+    return ["confirm-host-add", "confirm-host-remove", "confirm-uninstall", "confirm-unmanaged", "confirm-bulk-uninstall", "confirm-bulk-hosts"].includes(mode.kind);
+}
+/** Pages the preview like the other footer confirmations: `y` answers only once it has all been displayed. */
+function handlePagedConfirmKey(context, mode, input, key) {
+    const { operations, env } = context;
+    const { lines, chrome } = pagedConfirmPreview(mode);
+    const viewport = context.previewGeometry(lines, mode.cursor, chrome);
+    const cursor = movePreviewCursor(mode.cursor, viewport.total, input, key, viewport.height);
+    if (cursor !== undefined) {
+        context.setMode({ ...mode, cursor });
+        return;
+    }
+    answerYesNo(input, key, () => {
+        if (!viewport.reachedEnd)
+            return;
+        switch (mode.kind) {
+            case "confirm-host-add":
+                context.setMode({ kind: "confirm-host-exposure", skill: mode.skill, prepared: mode.prepared });
+                return;
+            case "confirm-host-remove":
+                void execute(context, `Changing hosts of ${mode.skill.name}…`, () => runHostRemoval(mode.prepared, operations, env, mode.skill));
+                return;
+            case "confirm-uninstall":
                 void execute(context, `Removing ${mode.skill.name}…`, async () => {
                     await runUninstall(mode.prepared, operations, env);
                     return mode.prepared.plan.inspections.every((inspection) => inspection.recordOnly)
                         ? `Forgot missing installation record for ${mode.skill.path}; no files were removed`
                         : `Removed ${mode.skill.name} (${mode.skill.path})`;
                 });
-            }, cancelWith("Uninstall cancelled"));
-            return;
-    }
+                return;
+        }
+    }, () => cancel(context, mode.kind === "confirm-host-add" ? "Install cancelled" : "Uninstall cancelled"));
+}
+/** The exposure question has no preview: `y` adds the hosts, `n`/Esc cancels. */
+function handleExposureKey(context, mode, input, key) {
+    answerYesNo(input, key, () => {
+        void execute(context, `Changing hosts of ${mode.skill.name}…`, () => runHostAddition(mode.prepared, context.operations, context.env));
+    }, () => cancel(context, "Install cancelled"));
 }
 /**
  * Handles a key in one of the manage modes. Returns false when the mode is not
@@ -167,10 +193,12 @@ export function handleManageKey(context, mode, input, key) {
             handleHostChecklistKey(context, mode, input, key);
             break;
         case "confirm-host-add":
-        case "confirm-host-exposure":
         case "confirm-host-remove":
         case "confirm-uninstall":
-            handleConfirmKey(context, mode, input, key);
+            handlePagedConfirmKey(context, mode, input, key);
+            break;
+        case "confirm-host-exposure":
+            handleExposureKey(context, mode, input, key);
             break;
         default:
             break;

package/dist/src/tui/manage-panel.js

@@ -1,29 +1,20 @@
 import { jsxs as _jsxs, Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { Box, Text } from "ink";
+import { Box } from "ink";
+import { Text } from "./safe-text.js";
 import { AppPanel } from "./app-actions.js";
 import { PackagePanel } from "./package-actions.js";
-import { ChecklistLines, DecisionPrompt, HostChecklist, PreviewConfirm, PreviewLines, Working } from "./panel-parts.js";
+import { pagedConfirmPreview } from "./manage-actions.js";
+import { ChecklistLines, DecisionPrompt, HostChecklist, PagedPreview, Working } from "./panel-parts.js";
+import { usePreviewGeometry } from "./preview-window.js";
 import { theme } from "./theme.js";
 const plural = (n) => `${n} ${n === 1 ? "item" : "items"}`;
 function SkippedLines({ skipped }) {
     return (_jsx(_Fragment, { children: skipped.map(({ id, label, reason }) => _jsxs(Text, { color: theme.warning, children: ["Skipped ", label, ": ", reason] }, id)) }));
 }
-/** One block per planned item, the skipped ones, then the y/n question. */
-function PlanPreview({ entries, skipped, question }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [entries.map((entry) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.group, children: entry.label }), _jsx(PreviewLines, { lines: entry.lines, warnFirst: entry.warnFirst })] }, entry.id))), _jsx(SkippedLines, { skipped: skipped }), _jsx(DecisionPrompt, { children: question })] }));
-}
-function UninstallPreview({ plan }) {
-    const entries = plan.items.map((item) => ({
-        id: item.id,
-        label: item.label,
-        lines: item.kind === "managed" ? item.prepared.plan.preview : item.prepared.preview,
-        warnFirst: item.kind === "unmanaged",
-    }));
-    return _jsx(PlanPreview, { entries: entries, skipped: plan.skipped, question: `Uninstall ${plural(plan.items.length)}?` });
-}
-function HostsPreview({ plan }) {
-    const entries = plan.items.map((item) => ({ id: item.id, label: item.label, lines: item.prepared.preview, warnFirst: false }));
-    return _jsx(PlanPreview, { entries: entries, skipped: plan.skipped, question: `Add hosts to ${plural(plan.items.length)}?` });
+/** A Skill confirmation with the shared footer; the view shows it alone so no tree rows count against its height. */
+export function PagedConfirmPanel({ mode }) {
+    const { lines, styled, chrome } = pagedConfirmPreview(mode);
+    return _jsx(PagedPreview, { lines: lines, styled: styled, viewport: usePreviewGeometry()(lines, mode.cursor, chrome) });
 }
 /** Renders the prompt of a manage mode: host lists, previews and confirmations. */
 export function ManagePanel({ mode }) {
@@ -44,25 +35,20 @@ export function ManagePanel({ mode }) {
         case "hosts-remove":
             return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [mode.kind === "hosts-add" ? "Add hosts to" : "Remove hosts from", " ", mode.skill.name, ". Host (space/1-", mode.choices.length, " toggle, j/k move, Enter continue, Esc cancel):"] }), _jsx(HostChecklist, { choices: mode.choices, cursor: mode.cursor, selected: mode.selected })] }));
         case "confirm-host-add":
-            return _jsx(PreviewConfirm, { lines: mode.prepared.preview, question: `Add hosts to ${mode.skill.name}? y/n` });
-        case "confirm-host-exposure":
-            return (_jsxs(Text, { color: theme.warning, children: ["Adding hosts exposes the installed ", mode.skill.name, " to more hosts and needs separate confirmation (CLI: --confirm-additional-host). ", _jsx(DecisionPrompt, { children: "Confirm?" })] }));
         case "confirm-host-remove":
-            return _jsx(PreviewConfirm, { lines: mode.prepared.preview, question: `Remove hosts from ${mode.skill.name}? y/n` });
         case "confirm-uninstall":
-            return _jsx(PreviewConfirm, { lines: mode.prepared.plan.preview, question: `Uninstall ${mode.skill.name}? y/n` });
+        case "confirm-unmanaged":
+        case "confirm-bulk-uninstall":
+        case "confirm-bulk-hosts":
+            return _jsx(PagedConfirmPanel, { mode: mode });
+        case "confirm-host-exposure":
+            return (_jsxs(Text, { color: theme.warning, children: ["Adding hosts exposes the installed ", mode.skill.name, " to more hosts and needs separate confirmation (CLI: --confirm-additional-host). ", _jsx(DecisionPrompt, { children: "Confirm?" })] }));
         case "unmanaged-scope":
             return _jsxs(Text, { children: ["Remove ", mode.group.name, " (", mode.group.locations.length, " locations): 1 all locations  2 choose locations  (Esc cancel)"] });
         case "unmanaged-pick":
             return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Remove locations of ", mode.group.name, ". Location (space/1-", mode.group.locations.length, " toggle, j/k move, Enter continue, Esc cancel):"] }), _jsx(ChecklistLines, { choices: mode.group.locations, cursor: mode.cursor, isSelected: (location) => mode.selected.includes(location.path), keyOf: (location) => location.path, label: (location) => `${location.path}${location.linkTarget === undefined ? "" : `  symlink → ${location.linkTarget}`}` })] }));
-        case "confirm-unmanaged":
-            return _jsx(PreviewConfirm, { lines: mode.prepared.preview, question: `Remove ${mode.group.name}? y/n`, warnFirst: true });
         case "bulk-hosts":
             return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Add hosts to ", plural(mode.targets.length), ". Host (space/1-", mode.choices.length, " toggle, j/k move, Enter continue, Esc cancel):"] }), _jsx(HostChecklist, { choices: mode.choices, cursor: mode.cursor, selected: mode.selected }), _jsx(SkippedLines, { skipped: mode.skipped })] }));
-        case "confirm-bulk-uninstall":
-            return _jsx(UninstallPreview, { plan: mode.plan });
-        case "confirm-bulk-hosts":
-            return _jsx(HostsPreview, { plan: mode.plan });
         case "confirm-bulk-exposure":
             return (_jsxs(Text, { color: theme.warning, children: ["Adding hosts exposes the installed ", mode.plan.items.map((item) => item.label).join(", "), " to more hosts and needs separate confirmation (CLI: --confirm-additional-host). ", _jsx(DecisionPrompt, { children: "Confirm?" })] }));
         case "busy":

package/dist/src/tui/mode-keys.js

@@ -1,4 +1,5 @@
 import { isValidFixedVersion } from "../skill-install.js";
+import { isYes } from "./keys.js";
 /** The cursor after a down/up key (arrows or j/k), or undefined when the key does not move it. */
 export function moveCursor(cursor, length, input, key) {
     if (key.downArrow || input === "j")
@@ -51,11 +52,20 @@ export function applyChecklistOutcome(outcome, handlers) {
 }
 /** The y/n confirmation keys: `y` confirms, `n` or Esc declines, anything else is ignored. */
 export function answerYesNo(input, key, onYes, onNo) {
-    if (input === "y")
+    if (isYes(input, key))
         onYes();
     else if (input === "n" || key.escape)
         onNo();
 }
+/** A paged preview answers `y` only once `viewport` has been read to the end; paging keys move the cursor. */
+export function answerPaged(viewport, cursor, input, key, outcome) {
+    const moved = movePreviewCursor(cursor, viewport.total, input, key, viewport.height);
+    if (moved !== undefined)
+        outcome.moveTo(moved);
+    else
+        answerYesNo(input, key, () => { if (viewport.reachedEnd)
+            outcome.yes(); }, outcome.no);
+}
 /** Esc cancels, Enter submits a valid version, backspace deletes, any other plain key is typed. */
 export function versionInputKey(value, input, key) {
     if (key.escape)