@iseoane/agent-depot 0.6.4 → 0.6.6

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

@@ -3,6 +3,7 @@ import { runInstall } from "./catalog-installs.js";
 import { errorText } from "./batch.js";
 import { defaultAdoptionHosts, findAdoptionCandidates, prepareAdoption } from "./installations.js";
 import { answerYesNo, applyChecklistOutcome, hostChecklistKey, moveCursor, versionInputKey } from "./mode-keys.js";
+import { busy } from "./working-model.js";
 function cancel(context) {
     context.setMessage({ kind: "ok", text: "Adoption cancelled" });
     context.browse();
@@ -22,7 +23,7 @@ export async function startAdoption(context, group) {
         return;
     }
     context.setMessage(undefined);
-    context.setMode({ kind: "busy", label: `Looking for a Source Skill named ${entry.name}...` });
+    context.setMode(busy(`Looking for a Source Skill named ${entry.name}…`));
     try {
         const candidates = await findAdoptionCandidates(context.operations, entry);
         if (!context.isMounted())
@@ -43,7 +44,7 @@ export async function startAdoption(context, group) {
     }
 }
 async function prepare(context, mode, version) {
-    context.setMode({ kind: "busy", label: `Refreshing source and checking that ${mode.entry.name} matches...` });
+    context.setMode(busy(`Refreshing source and checking that ${mode.entry.name} matches…`));
     try {
         const adoption = await prepareAdoption(context.operations, context.env, mode.entry, mode.skill, { hosts: mode.hosts, version });
         if (!context.isMounted())
@@ -55,7 +56,7 @@ async function prepare(context, mode, version) {
     }
 }
 async function confirm(context, mode, exposure) {
-    context.setMode({ kind: "busy", label: `Adopting ${mode.entry.name}...` });
+    context.setMode(busy(`Adopting ${mode.entry.name}…`));
     let result;
     try {
         result = { kind: "ok", text: (await runInstall(mode.adoption.prepared, context.operations, exposure)).join(" ") };

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

@@ -3,8 +3,9 @@ import { Text, useWindowSize } from "ink";
 import { PROJECT_HOSTS } from "../project-manifest.js";
 import { errorText, runBatch } from "./batch.js";
 import { hostChecklistKey, movePreviewCursor } from "./mode-keys.js";
-import { BorderPanel, HostChecklist, PreviewConfirm } from "./panel-parts.js";
+import { BorderPanel, HostChecklist, PreviewConfirm, Working } from "./panel-parts.js";
 import { previewViewport } from "./preview-window.js";
+import { operationStart } from "./working-model.js";
 export const APP_KINDS = ["app-busy", "app-approve", "app-hosts", "app-confirm", "app-manual"];
 /** Narrows the view's mode without asserting a partial mode is an App mode. */
 export function isAppMode(mode) {
@@ -59,9 +60,14 @@ function appPreviewLines(mode) {
         ...appStepLines(mode.plan),
     ];
 }
-async function prepareNext(context, requests, results = [], failures = 0) {
+/** The busy mode of an App step; `previous` is the busy mode this step continues, so the clock keeps running. */
+function appBusy(label, previous) {
+    return { kind: "app-busy", label, startedAt: operationStart(previous) };
+}
+async function prepareNext(context, requests, results = [], failures = 0, previous) {
     const { manage, apps } = context;
-    manage.setMode({ kind: "app-busy", label: "Preparing App step..." });
+    const running = appBusy("Preparing App step…", previous);
+    manage.setMode(running);
     // Independent planning failures never stop the remaining marked Apps.
     const [request, ...remaining] = requests;
     if (!request) {
@@ -79,7 +85,7 @@ async function prepareNext(context, requests, results = [], failures = 0) {
     }
     catch (error) {
         if (manage.isMounted()) {
-            await prepareNext(context, remaining, [...results, `${appName(request.entry)}: failed: ${errorText(error)}`], failures + 1);
+            await prepareNext(context, remaining, [...results, `${appName(request.entry)}: failed: ${errorText(error)}`], failures + 1, running);
         }
     }
 }
@@ -92,7 +98,7 @@ export async function startAppAction(context, entries, input) {
             const entry = entries[0];
             if (!entry)
                 throw new Error("No App selected");
-            manage.setMode({ kind: "app-busy", label: "Preparing recipe approval..." });
+            manage.setMode(appBusy("Preparing recipe approval…"));
             const [steps, approval] = await Promise.all([apps.preview(entry), apps.approvalStatus(entry)]);
             if (manage.isMounted()) {
                 manage.setMode({ kind: "app-approve", entry, lines: appRecipePreviewLines(entry, approval.status, steps), cursor: 0 });
@@ -118,7 +124,8 @@ export async function startAppAction(context, entries, input) {
 }
 async function execute(context, mode) {
     const { manage, apps } = context;
-    manage.setMode({ kind: "app-busy", label: "Running App step..." });
+    const running = appBusy("Running App step…");
+    manage.setMode(running);
     let manualRequired = false;
     const [outcome] = await runBatch([mode.plan], async (plan) => {
         const result = mode.kind === "app-manual"
@@ -136,7 +143,7 @@ async function execute(context, mode) {
         return `${appName(plan.entry)}: ${result.status}${result.installedVersion ? ` ${result.installedVersion}` : ""}`;
     }, (plan, error) => `${appName(plan.entry)}: failed: ${errorText(error)}`);
     if (manage.isMounted() && outcome && !manualRequired) {
-        await prepareNext(context, mode.remaining, [...mode.results, outcome.line], mode.failures + (outcome.ok ? 0 : 1));
+        await prepareNext(context, mode.remaining, [...mode.results, outcome.line], mode.failures + (outcome.ok ? 0 : 1), running);
     }
 }
 /** Applies checklist and y/n keys, continuing independent batch steps after cancellation or failure. */
@@ -187,7 +194,7 @@ export function handleAppKey(context, mode, input, key) {
             void execute(context, mode);
             return;
         }
-        manage.setMode({ kind: "app-busy", label: "Approving recipe..." });
+        manage.setMode(appBusy("Approving recipe…"));
         void apps.approve(mode.entry).then(() => manage.finish({ kind: "ok", text: `Approved ${appName(mode.entry)}` }), error => manage.finish({ kind: "error", text: errorText(error) }));
     }
 }
@@ -195,7 +202,7 @@ export function handleAppKey(context, mode, input, key) {
 export function AppPanel({ mode }) {
     const { rows, columns } = useWindowSize();
     if (mode.kind === "app-busy")
-        return _jsx(BorderPanel, { title: "App lifecycle", children: _jsx(Text, { children: mode.label }) });
+        return _jsx(BorderPanel, { title: "App lifecycle", children: _jsx(Working, { label: mode.label, since: mode.startedAt }) });
     if (mode.kind === "app-hosts") {
         return (_jsxs(BorderPanel, { title: "App Host steps", children: [_jsx(Text, { children: "Checked = setup. Unchecked = teardown. Wiring is not tracked." }), _jsxs(Text, { children: ["Space/1-", mode.choices.length, " toggle \u00B7 j/k move \u00B7 Enter continue \u00B7 Esc cancel"] }), _jsx(HostChecklist, { choices: mode.choices, cursor: mode.cursor, selected: mode.selected })] }));
     }

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

@@ -5,6 +5,7 @@ import { missingHosts, prepareHostAddition, prepareUninstall, runHostAddition, r
 import { answerYesNo, applyChecklistOutcome, hostChecklistKey } from "./mode-keys.js";
 import { skillOf, sourceIdOf } from "./installations.js";
 import { prepareUnmanagedRemoval, runUnmanagedRemoval } from "./unmanaged-actions.js";
+import { busy } from "./working-model.js";
 export const BULK_KINDS = ["bulk-hosts", "confirm-bulk-uninstall", "confirm-bulk-hosts", "confirm-bulk-exposure"];
 const count = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
 function skip(target, label, reason) {
@@ -161,7 +162,7 @@ function cancel(context, text) {
 }
 /** Runs a prepare step in the busy mode; a plan with items goes to its confirmation, otherwise the reasons are reported. */
 async function preparePlan(context, label, prepare, confirmation) {
-    context.setMode({ kind: "busy", label });
+    context.setMode(busy(label));
     try {
         const plan = await prepare();
         if (!context.isMounted())
@@ -182,7 +183,7 @@ async function preparePlan(context, label, prepare, confirmation) {
 }
 /** `u` with marks: prepares every marked leaf, then asks once. */
 export function startBulkUninstall(context, targets) {
-    return preparePlan(context, `Preparing uninstall of ${count(targets.length, "item")}...`, () => prepareBulkUninstall(context, targets), (plan) => ({ kind: "confirm-bulk-uninstall", plan }));
+    return preparePlan(context, `Preparing uninstall of ${count(targets.length, "item")}…`, () => prepareBulkUninstall(context, targets), (plan) => ({ kind: "confirm-bulk-uninstall", plan }));
 }
 /** `h` with marks: asks the hosts once, for the union of what the eligible items lack. */
 export function startBulkHostAddition(context, targets) {
@@ -196,10 +197,10 @@ export function startBulkHostAddition(context, targets) {
     context.setMode({ kind: "bulk-hosts", targets: ready, skipped, choices, cursor: 0, selected: [] });
 }
 function prepareHosts(context, mode) {
-    return preparePlan(context, `Preparing host change of ${count(mode.targets.length, "item")}...`, () => prepareBulkHostAddition(context, mode.targets, mode.skipped, mode.selected), (plan) => ({ kind: "confirm-bulk-hosts", plan }));
+    return preparePlan(context, `Preparing host change of ${count(mode.targets.length, "item")}…`, () => prepareBulkHostAddition(context, mode.targets, mode.skipped, mode.selected), (plan) => ({ kind: "confirm-bulk-hosts", plan }));
 }
 async function apply(context, label, action) {
-    context.setMode({ kind: "busy", label });
+    context.setMode(busy(label));
     let result;
     try {
         result = await action();
@@ -226,7 +227,7 @@ export function handleBulkKey(context, mode, input, key) {
         }
         case "confirm-bulk-uninstall":
             answerYesNo(input, key, () => {
-                void apply(context, `Removing ${count(current.plan.items.length, "item")}...`, () => runBulkUninstall(current.plan, operations, env));
+                void apply(context, `Removing ${count(current.plan.items.length, "item")}…`, () => runBulkUninstall(current.plan, operations, env));
             }, () => cancel(context, "Uninstall cancelled"));
             return true;
         case "confirm-bulk-hosts":
@@ -234,7 +235,7 @@ export function handleBulkKey(context, mode, input, key) {
             return true;
         case "confirm-bulk-exposure":
             answerYesNo(input, key, () => {
-                void apply(context, `Changing hosts of ${count(current.plan.items.length, "item")}...`, () => runBulkHostAddition(current.plan, operations, env));
+                void apply(context, `Changing hosts of ${count(current.plan.items.length, "item")}…`, () => runBulkHostAddition(current.plan, operations, env));
             }, () => cancel(context, "Add hosts cancelled"));
             return true;
         default:

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

@@ -3,12 +3,13 @@ import { prepareInstall, runInstall } from "./catalog-installs.js";
 import { skillKey } from "./catalog-tree.js";
 import { errorText, runBatch } from "./batch.js";
 import { answerYesNo, applyChecklistOutcome, hostChecklistKey, versionInputKey } from "./mode-keys.js";
+import { busy } from "./working-model.js";
 function cancel(context) {
     context.setMessage({ kind: "ok", text: "Install cancelled" });
     context.setAction(BROWSE);
 }
 async function startInstall(context, skills, choice) {
-    context.setAction({ kind: "busy", label: `Refreshing source and preparing install of ${describeSkills(skills)}...` });
+    context.setAction(busy(`Refreshing source and preparing install of ${describeSkills(skills)}…`));
     const items = [];
     for (const skill of skills) {
         try {
@@ -30,7 +31,7 @@ async function startInstall(context, skills, choice) {
 }
 /** Applies the prepared items one by one; a failure is reported for that item and the rest still run. */
 async function confirmInstall(context, items, exposure) {
-    context.setAction({ kind: "busy", label: `Installing ${describeSkills(items.map((item) => item.skill))}...` });
+    context.setAction(busy(`Installing ${describeSkills(items.map((item) => item.skill))}…`));
     const outcomes = await runBatch(items, async ({ prepared, error }) => {
         if (prepared === undefined)
             throw new Error(error);

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

@@ -6,7 +6,7 @@ import { skillKey } from "./catalog-tree.js";
 import { hasUnmanagedCopy } from "./catalog-installs.js";
 import { describeRow, truncateDescription, UNMANAGED_MARKER } from "./catalog-tree.js";
 import { isPackageMode, PackagePanel } from "./package-actions.js";
-import { BorderPanel, DecisionPrompt, HostChecklist, PreviewLines } from "./panel-parts.js";
+import { BorderPanel, DecisionPrompt, HostChecklist, PreviewLines, Working } from "./panel-parts.js";
 import { rowStyle } from "./theme.js";
 import { theme } from "./theme.js";
 /** Scope and counts, the filter line, and why the list may be empty. */
@@ -54,6 +54,6 @@ export function ActionPanel({ mode }) {
             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(Text, { children: mode.label }) });
+            return _jsx(BorderPanel, { title: "Skill install", children: _jsx(Working, { label: mode.label, since: mode.startedAt }) });
     }
 }

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

@@ -11,13 +11,13 @@ import { AppPanel, handleAppKey, startAppAction } from "./app-actions.js";
 import { ActionPanel, CatalogHeader, CatalogRowLine, CatalogSelectionHelp } from "./catalog-panel.js";
 import { packageOwnedSkillNotice } from "./catalog-ownership.js";
 import { packageOperationsOf } from "./environment.js";
-import { handlePackageKey, isPackageMode, startPackageAction } from "./package-actions.js";
-import { ListFooter } from "./panel-parts.js";
+import { handlePackageKey, isPackageMode, PackagePanel, startPackageAction } from "./package-actions.js";
+import { ListFooter, Working } from "./panel-parts.js";
 import { useCatalogApps, useCatalogFilter, useCatalogSkills, useInstalledSkills } from "./catalog-state.js";
 import { buildTree, leavesOf, openByDefault, skillKey } from "./catalog-tree.js";
 import { theme } from "./theme.js";
 import { useTreeNavigation } from "./tree-navigation.js";
-import { useMarks, useMounted } from "./view-state.js";
+import { useLoadingSince, useMarks, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
 const NO_ENVIRONMENT = {};
@@ -89,6 +89,21 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
         ? Math.max(1, ...state.activeBundles.map((owner) => wrappedLineCount(packageOwnedSkillNotice(owner), Math.max(columns, 1))))
         : 1;
     const height = useListHeight(listHeight, 6 + helpLines);
+    // A reload that ends an action continues that action's clock.
+    const runningSince = appMode?.kind === "app-busy" ? appMode.startedAt : action.kind === "busy" ? action.startedAt : undefined;
+    const loading = state.status === "loading" || appCatalog.status === "loading" || (state.status === "ready" && !installedReady);
+    // A Package action reloads after its mode has ended, so its clock is kept until that reload is done.
+    const [resumedSince, setResumedSince] = useState();
+    const wasLoading = useRef(false);
+    useEffect(() => {
+        if (loading)
+            wasLoading.current = true;
+        else if (wasLoading.current) {
+            wasLoading.current = false;
+            setResumedSince(undefined);
+        }
+    }, [loading]);
+    const loadingSince = useLoadingSince(loading, runningSince ?? resumedSince);
     const flow = {
         operations,
         env,
@@ -130,12 +145,14 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
             await reloadInstalled();
             if (!mounted.current)
                 return;
+            const running = actionRef.current;
+            setResumedSince(running.kind === "busy" ? running.startedAt : undefined);
             setReloadKey((value) => value + 1);
             setMessage(result);
             setAction(BROWSE);
         },
     };
-    const packageContext = { packages, manage: packageHost };
+    const packageContext = { packages, manage: packageHost, terminalRows: terminalRows || 24, terminalColumns: columns || 80 };
     const browse = {
         navigation,
         height,
@@ -166,13 +183,16 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
         }
     });
     const scope = all || sourceId === undefined ? "all sources" : sourceId;
-    if (state.status === "loading" || appCatalog.status === "loading" || (state.status === "ready" && !installedReady))
-        return _jsx(Text, { children: "Loading catalog..." });
+    if (loading)
+        return _jsx(Working, { label: "Loading catalog\u2026", since: loadingSince });
     if (state.status === "error")
         return _jsxs(Text, { color: theme.error, children: ["Error: ", state.message] });
     const window = computeWindow(rows.length, index, height);
     const selectedCount = leavesOf(roots).filter((skill) => marks.marked.has(skillKey(skill))).length;
     if (appMode !== undefined)
         return _jsx(AppPanel, { mode: appMode });
+    // 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 });
     return (_jsxs(Box, { flexDirection: "column", children: [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

@@ -4,9 +4,9 @@ import { Text, useWindowSize } from "ink";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { pickerEntries, readDirectoryListing, PROFILE_EXTENSION } from "./file-picker-model.js";
 import { useKeys } from "./keys.js";
-import { moveCursor } from "./mode-keys.js";
-import { BorderPanel } from "./panel-parts.js";
-import { clipText, wrapText } from "./text-wrap.js";
+import { moveCursor, movePreviewCursor } from "./mode-keys.js";
+import { BorderPanel, Working } from "./panel-parts.js";
+import { clipText, fitLines, wrapText } from "./text-wrap.js";
 import { theme } from "./theme.js";
 import { useMirrored, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
@@ -23,18 +23,22 @@ function settle(action) {
  * request generation, so a slow listing never overwrites a newer directory or an unmount.
  */
 export function FilePicker({ purpose, startDirectory, notice, onCancel, onChoose, listHeight, readDirectory = readDirectoryListing }) {
-    const [state, setState] = useState({ status: "loading", directory: startDirectory });
+    const [state, setState] = useState(() => ({ status: "loading", directory: startDirectory, startedAt: Date.now() }));
     const [cursor, cursorRef, cursorTo] = useMirrored(0);
     const [showAllFiles, showAllFilesRef, setShowAllFiles] = useMirrored(false);
-    const [showFullPath, setShowFullPath] = useState(false);
+    const [showFullPath, showFullPathRef, setShowFullPath] = useMirrored(false);
+    const [pathCursor, pathCursorRef, pathCursorTo] = useMirrored(0);
+    // The page size of the full path view, which the key handler needs before the render computes it.
+    const pathPageRef = useRef(1);
     const requestId = useRef(0);
+    const pathLineCount = useRef(1);
     const mounted = useMounted();
     const { columns } = useWindowSize();
     const panelWidth = Math.max((columns || 80) - 4, 1);
     const navigate = useCallback((directory) => {
         const id = ++requestId.current;
         cursorTo(0);
-        setState({ status: "loading", directory });
+        setState({ status: "loading", directory, startedAt: Date.now() });
         void readDirectory(directory).then(listing => {
             if (!mounted.current || requestId.current !== id)
                 return;
@@ -76,9 +80,14 @@ export function FilePicker({ purpose, startDirectory, notice, onCancel, onChoose
             settle(onCancel);
             return;
         }
-        if (showFullPath) {
+        if (showFullPathRef.current) {
             if (input === "p")
                 setShowFullPath(false);
+            else {
+                const next = movePreviewCursor(pathCursorRef.current, pathLineCount.current, input, key, pathPageRef.current);
+                if (next !== undefined)
+                    pathCursorTo(next);
+            }
             return;
         }
         if (state.status !== "ready") {
@@ -98,6 +107,7 @@ export function FilePicker({ purpose, startDirectory, notice, onCancel, onChoose
             return;
         }
         if (input === "p") {
+            pathCursorTo(0);
             setShowFullPath(true);
             return;
         }
@@ -111,32 +121,54 @@ export function FilePicker({ purpose, startDirectory, notice, onCancel, onChoose
     });
     const directory = state.directory;
     const wrappedDirectory = wrapText(`Directory: ${directory}`, panelWidth);
-    const directoryLines = showFullPath || wrappedDirectory.length <= 3
-        ? wrappedDirectory
-        : [wrappedDirectory[0], ...wrapText(`… ${wrappedDirectory.length - 2} lines · press p for full path`, panelWidth), wrappedDirectory.at(-1)];
-    const ordinaryFooterLines = (purpose === "directory"
+    const ordinaryFooter = purpose === "directory"
         ? ["j/k move · Enter open/use · ←", "parent · p full path · Esc back"]
-        : ["j/k move · Enter open · ← parent", `f ${showAllFiles ? "json only" : "all files"} · p full path · Esc back`])
-        .flatMap(line => wrapText(line, panelWidth));
+        : ["j/k move · Enter open · ← parent", `f ${showAllFiles ? "json only" : "all files"} · p full path · Esc back`];
     const noticeLines = notice === undefined ? [] : wrapText(notice, panelWidth);
-    const filterNoteLines = !showFullPath && purpose === "file" && state.status === "ready" && !showAllFiles
-        ? wrapText(`Showing ${PROFILE_EXTENSION} only · f shows all files`, panelWidth)
-        : [];
     const statusLineCount = !showFullPath && (state.status === "loading" || state.status === "error" || (state.status === "ready" && rows.length === 0)) ? 1 : 0;
-    const visibleNoticeLines = showFullPath ? [] : noticeLines;
-    const footerLines = showFullPath ? wrapText("p hide path · Esc back", panelWidth) : ordinaryFooterLines;
+    const listRowsNeeded = rows.length > 0 ? 1 : 0;
+    // The roomy layout collapses a long path to three rows and wraps the key hints; the compact one keeps a
+    // folder list on screen when that roomy chrome alone would fill a short terminal.
+    const roomyDirectoryLines = wrappedDirectory.length <= 3
+        ? wrappedDirectory
+        : [wrappedDirectory[0], ...wrapText(`… ${wrappedDirectory.length - 2} lines · press p for full path`, panelWidth), wrappedDirectory.at(-1)];
+    const roomyFooterLines = ordinaryFooter.flatMap(line => wrapText(line, panelWidth));
+    const filterNote = purpose === "file" && state.status === "ready" && !showAllFiles
+        ? `Showing ${PROFILE_EXTENSION} only · f shows all files`
+        : undefined;
+    const roomyFilterNoteLines = filterNote === undefined ? [] : wrapText(filterNote, panelWidth);
+    // The compact legend keeps the keys a user would not guess (the filter, the full path, going up).
+    const compactFooter = purpose === "directory" ? "← parent · p full path · Esc back"
+        : `f ${showAllFiles ? "json only" : "all files"} · p full path · Esc back`;
+    const roomyReserved = 3 + roomyDirectoryLines.length + statusLineCount + roomyFilterNoteLines.length + noticeLines.length
+        + roomyFooterLines.length + (rows.length > 0 && listHeight === undefined ? 1 : 0);
+    const roomyHeight = useListHeight(listHeight, roomyReserved, 0);
+    const compact = !showFullPath && listHeight === undefined && roomyHeight < listRowsNeeded;
+    const directoryLines = compact ? [clipText(`Directory: ${directory}`, panelWidth)] : roomyDirectoryLines;
+    const footerLines = showFullPath ? wrapText("j/k scroll · p hide path · Esc back", panelWidth)
+        : compact ? [clipText(compactFooter, panelWidth)] : roomyFooterLines;
+    const filterNoteLines = showFullPath ? [] : compact ? (filterNote === undefined ? [] : [clipText(filterNote, panelWidth)]) : roomyFilterNoteLines;
+    const visibleNoticeLines = showFullPath ? [] : compact ? fitLines(noticeLines, 2, panelWidth) : noticeLines;
     const reservesWindowIndicator = !showFullPath && rows.length > 0 && listHeight === undefined ? 1 : 0;
     const reserved = 3 + directoryLines.length + statusLineCount + filterNoteLines.length + visibleNoticeLines.length + footerLines.length + reservesWindowIndicator;
     const available = useListHeight(listHeight, reserved, 1);
     const height = rows.length > available && listHeight !== undefined ? Math.max(available - 1, 1) : available;
     const window = computeWindow(rows.length, cursor, height);
     const listedRows = showFullPath ? [] : rows.slice(window.start, window.end);
-    return (_jsxs(BorderPanel, { title: purpose === "directory" ? "Choose export folder" : "Choose import file", children: [directoryLines.map((line, index) => _jsx(Text, { color: theme.value, children: line }, index)), !showFullPath && state.status === "loading" ? _jsx(Text, { color: theme.muted, children: "Loading\u2026" }) : null, !showFullPath && state.status === "error" ? _jsxs(Text, { color: theme.error, children: ["Error: ", clipText(state.message, panelWidth)] }) : null, !showFullPath && state.status === "ready" && rows.length === 0 ? _jsx(Text, { color: theme.muted, children: "Empty folder" }) : null, filterNoteLines.map((line, index) => _jsx(Text, { color: theme.muted, children: line }, `filter-${index}`)), listedRows.map((row, position) => {
+    // The full path view pages the wrapped path, so a path longer than the terminal is still readable.
+    const pathAvailable = useListHeight(listHeight, 3 + footerLines.length, 1);
+    const pathHeight = wrappedDirectory.length > pathAvailable ? Math.max(pathAvailable - 1, 1) : pathAvailable;
+    const pathWindow = computeWindow(wrappedDirectory.length, pathCursor, pathHeight);
+    pathLineCount.current = wrappedDirectory.length;
+    pathPageRef.current = pathHeight;
+    const shownDirectoryLines = showFullPath ? wrappedDirectory.slice(pathWindow.start, pathWindow.end) : directoryLines;
+    return (_jsxs(BorderPanel, { title: purpose === "directory" ? "Choose export folder" : "Choose import file", children: [shownDirectoryLines.map((line, index) => _jsx(Text, { color: theme.value, children: line }, index)), !showFullPath && state.status === "loading" ? _jsx(Working, { label: "Loading folder\u2026", since: state.startedAt }) : null, !showFullPath && state.status === "error" ? _jsxs(Text, { color: theme.error, children: ["Error: ", clipText(state.message, panelWidth)] }) : null, !showFullPath && state.status === "ready" && rows.length === 0 ? _jsx(Text, { color: theme.muted, children: "Empty folder" }) : null, filterNoteLines.map((line, index) => _jsx(Text, { color: theme.muted, children: line }, `filter-${index}`)), listedRows.map((row, position) => {
                 const index = window.start + position;
                 const marker = index === cursor ? "> " : "  ";
                 const label = row.kind === "use-folder" ? `Use this folder: ${directory}`
                     : row.kind === "parent" ? ".. (parent folder)"
                         : row.entry.kind === "directory" ? `${row.entry.name}/` : row.entry.name;
                 return _jsxs(Text, { children: [_jsx(Text, { color: theme.field, children: marker }), _jsx(Text, { color: theme.value, children: clipText(label, Math.max(panelWidth - 2, 1)) })] }, index);
-            }), visibleNoticeLines.map((line, index) => _jsx(Text, { color: theme.warning, children: line }, `notice-${index}`)), footerLines.map((line, index) => _jsx(Text, { color: theme.legend, children: line }, `footer-${index}`)), !showFullPath && window.indicator ? _jsx(Text, { color: theme.muted, children: window.indicator }) : null] }));
+            }), visibleNoticeLines.map((line, index) => _jsx(Text, { color: theme.warning, children: line }, `notice-${index}`)), footerLines.map((line, index) => _jsx(Text, { color: theme.legend, children: line }, `footer-${index}`)), showFullPath ? (pathWindow.indicator ? _jsx(Text, { color: theme.muted, children: pathWindow.indicator }) : null)
+                : window.indicator ? _jsx(Text, { color: theme.muted, children: window.indicator }) : null] }));
 }

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

@@ -3,7 +3,7 @@ import { Box, Text, useWindowSize } from "ink";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createAppOperations } from "../app-flow.js";
 import { AppPanel, handleAppKey, isAppMode, startAppAction } from "./app-actions.js";
-import { handlePackageKey, isPackageMode } from "./package-actions.js";
+import { handlePackageKey, isPackageMode, PackagePanel } from "./package-actions.js";
 import { packageOperationsOf } from "./environment.js";
 import { loadInstallations } from "./installations.js";
 import { BROWSE } from "./installations-mode.js";
@@ -14,11 +14,12 @@ import { handleManageKey } from "./manage-actions.js";
 import { ModePanel } from "./installations-panel.js";
 import { TreeRowLine } from "./installations-rows.js";
 import { buildTree, leavesOf, markersOf } from "./installations-tree.js";
-import { ListFooter } from "./panel-parts.js";
+import { ListFooter, Working } from "./panel-parts.js";
 import { useTreeNavigation } from "./tree-navigation.js";
 import { defaultExpanded } from "./tree.js";
 import { theme } from "./theme.js";
-import { useMarks, useMounted } from "./view-state.js";
+import { busy } from "./working-model.js";
+import { useLoadingSince, useMarks, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
 const NO_ENVIRONMENT = {};
@@ -41,9 +42,16 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         onCapturingChange?.(next.kind !== "browse");
         setModeState(next);
     };
+    // Reloads and App checks can overlap, so counts decide when each indicator ends.
+    const [refreshingSince, setRefreshingSince] = useState();
+    const reloads = useRef(0);
+    const [checkingSince, setCheckingSince] = useState();
+    const checks = useRef(0);
     const loadGeneration = useRef(0);
     const reload = useCallback(async () => {
         const generation = ++loadGeneration.current;
+        if (reloads.current++ === 0 && mounted.current)
+            setRefreshingSince(Date.now());
         try {
             const data = await loadInstallations(operations, env, apps, packages);
             if (mounted.current && generation === loadGeneration.current)
@@ -53,6 +61,10 @@ export function InstallationsView({ operations, environment, onCapturingChange,
             if (mounted.current && generation === loadGeneration.current)
                 setState({ status: "error", message: errorText(error) });
         }
+        finally {
+            if (--reloads.current === 0 && mounted.current)
+                setRefreshingSince(undefined);
+        }
     }, [operations, env, apps, packages, mounted]);
     useEffect(() => {
         void reload();
@@ -63,15 +75,20 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     const { rows, index } = navigation;
     const checked = useRef(new Set());
     const highlighted = rows[index]?.node.data;
+    // The entry is kept when the tree is rebuilt with a check's result, and replaced only by a reload,
+    // so the effect below does not re-run for the node objects `buildTree` makes anew.
+    const highlightedEntry = highlighted?.kind === "app" ? highlighted.row.entry : undefined;
     useEffect(() => {
-        if (highlighted?.kind !== "app")
+        if (highlightedEntry === undefined)
             return;
-        const { entry } = highlighted.row;
+        const entry = highlightedEntry;
         const identity = `${entry.file}:${entry.hash}`;
         if (checked.current.has(identity))
             return;
         checked.current.add(identity);
         const generation = loadGeneration.current;
+        if (checks.current++ === 0)
+            setCheckingSince(Date.now());
         void apps.approvalStatus(entry).then(approval => {
             if (approval.status !== "approved")
                 return undefined;
@@ -79,6 +96,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         }).then(inspection => {
             if (!inspection || !mounted.current || generation !== loadGeneration.current)
                 return;
+            // An unknown result is asked again only when focus returns to the App, never by the rebuilt tree.
             if (inspection.status === "unknown")
                 checked.current.delete(identity);
             setState(previous => previous.status !== "ready" ? previous : {
@@ -94,14 +112,25 @@ export function InstallationsView({ operations, environment, onCapturingChange,
                 return;
             checked.current.delete(identity);
             setMessage({ kind: "error", text: errorText(error) });
+        }).finally(() => {
+            if (--checks.current === 0 && mounted.current)
+                setCheckingSince(undefined);
         });
-    }, [highlighted, apps, mounted]);
+    }, [highlightedEntry, apps, mounted]);
     const installed = useMemo(() => ({
         global: (data?.global ?? []).map((row) => row.selection),
         project: (data?.project ?? []).map((row) => row.selection),
         sources: data?.sources ?? [],
         unmanagedNames: new Set(),
     }), [data]);
+    const loadingSince = useLoadingSince(state.status === "loading");
+    /** Reloads after an action: the busy panel, which keeps the action's clock, says what is now running. */
+    const refresh = async () => {
+        const current = modeRef.current;
+        if ("startedAt" in current && mounted.current)
+            setMode(busy("Refreshing installations…", current));
+        await reload();
+    };
     const manage = {
         operations,
         env,
@@ -113,7 +142,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         unmark: (ids) => marks.setMarked(new Set([...marks.markedRef.current].filter((id) => !ids.includes(id)))),
         finish: async (result) => {
             checked.current.clear();
-            await reload();
+            await refresh();
             if (!mounted.current)
                 return;
             setMessage(result);
@@ -127,7 +156,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         browse: manage.browse,
         setMessage,
         isMounted: manage.isMounted,
-        reload,
+        reload: refresh,
     };
     const browse = {
         navigation,
@@ -145,18 +174,21 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         if (current.kind === "browse")
             handleBrowseKey(browse, input, key);
         else if (isPackageMode(current))
-            handlePackageKey({ packages, manage }, current, input, key);
+            handlePackageKey({ packages, manage, terminalRows: terminalRows || 24, terminalColumns: terminalColumns || 80 }, current, input, key);
         else if (isAppMode(current))
             handleAppKey({ apps, manage, terminalRows: terminalRows || 24, terminalColumns: terminalColumns || 80 }, current, input, key);
         else if (!handleManageKey(manage, current, input, key))
             handleAdoptionKey(adoption, current, input, key);
     });
     if (state.status === "loading")
-        return _jsx(Text, { children: "Loading installations..." });
+        return _jsx(Working, { label: "Loading installations\u2026", since: loadingSince });
     if (state.status === "error")
         return _jsxs(Text, { color: theme.error, children: ["Error: ", state.message] });
     if (isAppMode(mode))
         return _jsx(AppPanel, { mode: mode });
+    // 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 });
     const ready = state.data;
     const window = computeWindow(rows.length, index, height);
     const listed = rows.slice(window.start, window.end);
@@ -165,5 +197,6 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     const markedApps = markedLeaves.filter(node => node.data.kind === "app").length;
     // The legend explains the markers, so it shows only while a rendered row carries one.
     const legendNeeded = listed.some((row) => row.node.data.kind === "installation" && markersOf(row.node.data.row) !== "");
-    return (_jsxs(Box, { flexDirection: "column", children: [ready.global === undefined ? _jsx(Text, { children: "User-global installations are not supported by the configured operations" }) : null, ready.projectError === undefined ? null : _jsxs(Text, { color: theme.error, children: ["Error: ", ready.projectError] }), listed.map((row, offset) => (_jsx(TreeRowLine, { row: row, selected: window.start + offset === index, marked: marks.marked.has(row.node.id) }, row.node.id))), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), markedApps > 0 ? _jsxs(Text, { color: theme.muted, children: [markedApps, " Apps marked"] }) : null, legendNeeded ? _jsx(Text, { color: theme.muted, children: LEGEND }) : null, _jsx(ModePanel, { mode: mode })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [refreshingSince !== undefined && mode.kind === "browse" ? _jsx(Working, { label: "Refreshing installations\u2026", since: refreshingSince }) : null, ready.global === undefined ? _jsx(Text, { children: "User-global installations are not supported by the configured operations" }) : null, ready.projectError === undefined ? null : _jsxs(Text, { color: theme.error, children: ["Error: ", ready.projectError] }), listed.map((row, offset) => (_jsx(TreeRowLine, { row: row, selected: window.start + offset === index, marked: marks.marked.has(row.node.id) }, row.node.id))), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), markedApps > 0 ? _jsxs(Text, { color: theme.muted, children: [markedApps, " Apps marked"] }) : null, legendNeeded ? _jsx(Text, { color: theme.muted, children: LEGEND }) : null, checkingSince !== undefined && refreshingSince === undefined && mode.kind === "browse"
+                ? _jsx(Working, { label: "Checking App status\u2026", since: checkingSince }) : null, _jsx(ModePanel, { mode: mode })] }));
 }