@timurproko/a1 0.2.5-dev.698 → 0.2.5

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -161,8 +161,12 @@ export function createPiShellEditor(options) {
         const resources = commands
             .filter(command => command.name !== collapsed.collapsedCommand?.name && command.source !== "builtin" && !builtInNames.has(command.name))
             .map(command => autocompleteCommand(command));
-        const combined = new CombinedAutocompleteProvider([...builtIns, ...resources], options.cwd ?? process.cwd());
-        autocompleteProvider = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
+        const catalog = [...builtIns, ...resources];
+        const combined = new CombinedAutocompleteProvider(catalog, options.cwd ?? process.cwd());
+        const tunnelAware = tunnelSkills.length === 0 ? combined : createSkillsTunnelProvider(combined, tunnelSkills);
+        autocompleteProvider = options.keybindingProfile === "a1"
+            ? createDelimiterReadyCommandProvider(tunnelAware, catalog)
+            : tunnelAware;
         editor.setAutocompleteProvider(autocompleteProvider);
     };
     setAutocompleteCommands(options.autocompleteCommands ?? []);
@@ -345,6 +349,40 @@ export function createPiShellEditor(options) {
         cancelPendingPastes: () => editorUx?.cancelPendingPastes(),
     };
 }
+/** Bare A1 leaves an applied catalog command ready for `:`, a user-entered space, or submission. */
+function createDelimiterReadyCommandProvider(base, commands) {
+    const commandNames = new Set(commands.map(command => command.name));
+    return {
+        ...(base.triggerCharacters === undefined ? {} : { triggerCharacters: base.triggerCharacters }),
+        getSuggestions: (lines, cursorLine, cursorCol, options) => base.getSuggestions(lines, cursorLine, cursorCol, options),
+        applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+            const result = base.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
+            const currentLine = lines[cursorLine] ?? "";
+            const textBeforeCursor = currentLine.slice(0, cursorCol);
+            const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
+            const completedLine = result.lines[result.cursorLine] ?? "";
+            const spacerIndex = result.cursorCol - 1;
+            const expectedCommand = `${beforePrefix}/${item.value}`;
+            const isCatalogCommand = commandNames.has(item.value)
+                && prefix.startsWith("/")
+                && !prefix.slice(1).includes("/")
+                && !prefix.includes(" ")
+                && textBeforeCursor.trimStart() === prefix;
+            if (!isCatalogCommand
+                || result.cursorLine !== cursorLine
+                || spacerIndex < 0
+                || completedLine[spacerIndex] !== " "
+                || completedLine.slice(0, spacerIndex) !== expectedCommand)
+                return result;
+            const nextLines = [...result.lines];
+            nextLines[result.cursorLine] = completedLine.slice(0, spacerIndex) + completedLine.slice(spacerIndex + 1);
+            return { ...result, lines: nextLines, cursorCol: spacerIndex };
+        },
+        ...(base.shouldTriggerFileCompletion === undefined ? {} : {
+            shouldTriggerFileCompletion: (lines, cursorLine, cursorCol) => base.shouldTriggerFileCompletion(lines, cursorLine, cursorCol),
+        }),
+    };
+}
 function autocompleteCommand(command, addition) {
     const argumentOptions = addition?.argumentOptions ?? command.argumentOptions;
     return {

package/dist/integrations/pi/components/skills-dialog.js

@@ -27,8 +27,7 @@ class SkillRow {
     }
 }
 /**
- * The A1-owned searchable Skills dialog. Its composition is the model selector's (border, spacer,
- * search input, spacer, list, spacer, hint footer, border) built from public pi-tui components; its
+ * The A1-owned searchable Skills dialog uses the model selector's public pi-tui composition; its
  * content follows the v2 skills extension: an accent bold title, bare skill-name rows, the selected
  * skill's description cut to one line under the rows, the pinned scroll counter on overflow,
  * and the two empty states. Enter applies the selected skill with no arguments; the query is never appended.
@@ -57,6 +56,7 @@ class SkillsSelectorComponent extends Container {
         this.addChild(new Spacer(1));
         const bindings = getKeybindings();
         this.addChild(new Text(renderPiModalShortcutHints([
+            { key: "Type", action: "search" },
             { key: "↑↓", action: "navigate" },
             { key: bindings.getKeys("tui.select.confirm").join("/"), action: "select" },
             DIALOG_CLOSE_SHORTCUT_HINT,

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -5,9 +5,11 @@
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input
  * frame, transient contextual-suggestion branch, and explicit body geometry for selection and
  * above-prompt autocomplete. Bare A1 also clears a sole top-level slash-command search on Escape. Bare
- * A1 also completes a selected tunnel command with `:` and reopens the menu on its tunnel rows.
+ * A1 also completes a selected or exact completed tunnel command with `:` and reopens the menu on its
+ * tunnel rows, and synchronously retains then refreshes an exact top-level command menu after Tab
+ * applies its row.
  * Deviations: owned-shared-input-frame, above-prompt-autocomplete-placement,
- * clear-command-search-on-escape, command-tunnel-colon-completion.
+ * clear-command-search-on-escape, command-tunnel-colon-completion, keep-command-menu-open-after-tab.
  */
 import { type EditorOptions, type EditorTheme, type TUI } from "@earendil-works/pi-tui";
 import type { AppKeybinding, KeybindingsManager } from "../adjacent/core/keybindings.js";

package/dist/integrations/pi/components/upstream/components/owned-editor.js

@@ -5,9 +5,11 @@
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input
  * frame, transient contextual-suggestion branch, and explicit body geometry for selection and
  * above-prompt autocomplete. Bare A1 also clears a sole top-level slash-command search on Escape. Bare
- * A1 also completes a selected tunnel command with `:` and reopens the menu on its tunnel rows.
+ * A1 also completes a selected or exact completed tunnel command with `:` and reopens the menu on its
+ * tunnel rows, and synchronously retains then refreshes an exact top-level command menu after Tab
+ * applies its row.
  * Deviations: owned-shared-input-frame, above-prompt-autocomplete-placement,
- * clear-command-search-on-escape, command-tunnel-colon-completion.
+ * clear-command-search-on-escape, command-tunnel-colon-completion, keep-command-menu-open-after-tab.
  */
 import { CURSOR_MARKER, Editor, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
 const PROMPT_GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
@@ -78,7 +80,10 @@ export function createOwnedEditorClass(Base) {
         handleInput(data) {
             if (this.onExtensionShortcut?.(data))
                 return;
-            if (data === ":" && this.#completeSelectedCommandTunnel())
+            const tabbedCommand = this.keybindings.matches(data, "tui.input.tab") && this.isTopLevelCommandSearch()
+                ? retainedAutocomplete(this)
+                : undefined;
+            if (data === ":" && this.#completeCommandTunnel())
                 return;
             if (this.#promptSuggestion !== null
                 && !this.isShowingAutocomplete()
@@ -133,19 +138,41 @@ export function createOwnedEditorClass(Base) {
                 }
             }
             super.handleInput(data);
+            if (tabbedCommand !== undefined)
+                this.#retainCompletedCommandMenu(tabbedCommand);
+        }
+        /** Keep the current menu visible while refreshing it for the exact completed command. */
+        #retainCompletedCommandMenu(completion) {
+            const text = this.getText();
+            const cursor = this.getCursor();
+            if (text !== `/${completion.value}` || cursor.line !== 0 || cursor.col !== text.length)
+                return;
+            Reflect.set(this, "autocompleteList", completion.list);
+            Reflect.set(this, "autocompleteState", completion.state);
+            Reflect.set(this, "autocompletePrefix", text);
+            triggerAutocomplete(this);
         }
         /**
-         * Replace a sole top-level slash search whose selected row is a tunnel command with `/<command>:`
-         * and reopen the menu on the tunnel rows. The replacement goes through the public setText, which
-         * records the undo snapshot; every other colon stays ordinary text.
+         * Complete either a selected tunnel row or an exact command left by Tab to `/<command>:` and
+         * reopen the menu on the tunnel rows. Public setText records the undo snapshot; every other colon
+         * stays ordinary text.
          */
-        #completeSelectedCommandTunnel() {
-            if (!this.isTopLevelCommandSearch())
-                return false;
-            const selected = selectedAutocompleteValue(this);
-            if (selected === undefined || !this.#commandTunnels().includes(selected))
+        #completeCommandTunnel() {
+            const tunnels = this.#commandTunnels();
+            let command;
+            if (this.isTopLevelCommandSearch()) {
+                const selected = selectedAutocompleteValue(this);
+                if (selected !== undefined && tunnels.includes(selected))
+                    command = selected;
+            }
+            else if (!this.isShowingAutocomplete()) {
+                const text = this.getText();
+                const cursor = this.getCursor();
+                command = tunnels.find(candidate => text === `/${candidate}` && cursor.line === 0 && cursor.col === text.length);
+            }
+            if (command === undefined)
                 return false;
-            this.setText(`/${selected}:`);
+            this.setText(`/${command}:`);
             triggerAutocomplete(this);
             return true;
         }
@@ -200,6 +227,15 @@ export function createOwnedEditorClass(Base) {
 }
 export class OwnedEditor extends createOwnedEditorClass(Editor) {
 }
+/** Capture the active selected command list so exact Tab application can retain it synchronously. */
+function retainedAutocomplete(editor) {
+    const value = selectedAutocompleteValue(editor);
+    const list = Reflect.get(editor, "autocompleteList");
+    const state = Reflect.get(editor, "autocompleteState");
+    if (value === undefined || typeof list !== "object" || list === null || (state !== "regular" && state !== "force"))
+        return undefined;
+    return { value, list, state };
+}
 /** The value of the row the open autocomplete list highlights, read from either editor's list. */
 function selectedAutocompleteValue(editor) {
     const list = Reflect.get(editor, "autocompleteList");

package/dist/integrations/pi/components/upstream/components/session-selector.js

@@ -6,9 +6,10 @@
  * progressive partial results, cancellation, focus, and disposal while remapping public helpers, owned
  * keybindings/theme, canonical path handling, reverse-Tab scope cycling, and the shared bare-A1 modal
  * frame with standalone title, standard outer rules, stable filter/status row, progressive result
- * paging, aligned result columns, Session Tree selection roles, and bottom dynamic feedback and
- * shortcut footer. Selected session rows use the blue selection surface, success-green primary title,
- * muted metadata, and ordinary text weight.
+ * paging, aligned result columns, Session Tree selection roles, quiet in-field query syntax guidance,
+ * and one-line bottom dynamic feedback and searchable-dialog shortcut footer. Selected session rows
+ * use the blue selection surface, success-green primary title, muted metadata, and ordinary text
+ * weight.
  * Deviations: owned-modal-shortcut-hints, owned-resume-session-dialog,
  * owned-standard-dialog-selection.
  */
@@ -183,23 +184,19 @@ class SessionSelectorHeader {
             return [withCloseHint(theme.fg(color, this.statusMessage.message), width)];
         }
         const pathState = this.showPath ? "(on)" : "(off)";
-        const hint1 = renderPiModalShortcutHints([
+        const hints = [
+            { key: "Type", action: "search" },
+            { key: "↑↓", action: "navigate" },
+            shortcutHint("tui.select.confirm", "select", this.keybindings),
             shortcutHint("tui.input.tab", "scope", this.keybindings),
-            { action: "re:<pattern> regex" },
-            { action: '"phrase" exact' },
-        ]);
-        const hint2Parts = [
             shortcutHint("app.session.toggleSort", "sort", this.keybindings),
             shortcutHint("app.session.toggleNamedFilter", "named", this.keybindings),
             shortcutHint("app.session.delete", "delete", this.keybindings),
             shortcutHint("app.session.togglePath", `path ${pathState}`, this.keybindings),
         ];
         if (this.showRenameHint)
-            hint2Parts.push(shortcutHint("app.session.rename", "rename", this.keybindings));
-        return [
-            truncateToWidth(hint1, width, "…"),
-            withCloseHint(renderPiModalShortcutHints(hint2Parts), width),
-        ];
+            hints.push(shortcutHint("app.session.rename", "rename", this.keybindings));
+        return [withCloseHint(renderPiModalShortcutHints(hints), width)];
     }
 }
 class SessionSelectorFooter {
@@ -320,7 +317,10 @@ class SessionList {
     constructor(sessions, showCwd, sortMode, nameFilter, keybindings, currentSessionFilePath) {
         this.allSessions = sessions;
         this.filteredSessions = [];
-        this.searchInput = new Input();
+        this.searchInput = new Input({
+            placeholder: 're:<pattern> regex, "phrase" exact',
+            placeholderStyle: text => text === "r" ? text : `\u001b[2m${text}\u001b[22m`,
+        });
         this.showCwd = showCwd;
         this.sortMode = sortMode;
         this.nameFilter = nameFilter;

package/dist/integrations/pi/components/upstream/components/thinking-selector.d.ts

@@ -8,10 +8,11 @@
  * levels, and rendering exclusive radio-style default markers before level names, an item-adjacent
  * active checkmark, and aligned muted descriptions. Bare A1 persists defaults immediately on Space,
  * closes through the implicit Ctrl+C-capable selection-cancel action, and uses the shared compact
- * semantic shortcut row without advertising that alias. All list and border colors use the owned theme
- * and its explicit color mode. Selected rows use the shared bare-A1 blue selection surface only around
- * the rendered item span, with the existing accent arrow, normal-text level, and preserved
- * current/default/description roles. The comparison profile retains the public pinned component.
+ * semantic shortcut row with Type/search guidance without advertising that alias. All list and border
+ * colors use the owned theme and its explicit color mode. Selected rows use the shared bare-A1 blue
+ * selection surface only around the rendered item span, with the existing accent arrow, normal-text
+ * level, and preserved current/default/description roles. The comparison profile retains the public
+ * pinned component.
  * Deviations: owned-modal-shortcut-hints, owned-level-cycle-shortcut, owned-thinking-selector-heading,
  * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection.
  */

package/dist/integrations/pi/components/upstream/components/thinking-selector.js

@@ -8,10 +8,11 @@
  * levels, and rendering exclusive radio-style default markers before level names, an item-adjacent
  * active checkmark, and aligned muted descriptions. Bare A1 persists defaults immediately on Space,
  * closes through the implicit Ctrl+C-capable selection-cancel action, and uses the shared compact
- * semantic shortcut row without advertising that alias. All list and border colors use the owned theme
- * and its explicit color mode. Selected rows use the shared bare-A1 blue selection surface only around
- * the rendered item span, with the existing accent arrow, normal-text level, and preserved
- * current/default/description roles. The comparison profile retains the public pinned component.
+ * semantic shortcut row with Type/search guidance without advertising that alias. All list and border
+ * colors use the owned theme and its explicit color mode. Selected rows use the shared bare-A1 blue
+ * selection surface only around the rendered item span, with the existing accent arrow, normal-text
+ * level, and preserved current/default/description roles. The comparison profile retains the public
+ * pinned component.
  * Deviations: owned-modal-shortcut-hints, owned-level-cycle-shortcut, owned-thinking-selector-heading,
  * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection.
  */
@@ -96,6 +97,7 @@ export class OwnedThinkingSelectorComponent extends Container {
         this.addChild(this.selectListContainer);
         this.addChild(new Spacer(1));
         this.addChild(new Text(renderPiModalShortcutHints([
+            { key: "Type", action: "search" },
             { key: this.keyDisplayText("tui.select.confirm"), action: "select" },
             { key: "Space", action: "default" },
             DIALOG_CLOSE_SHORTCUT_HINT,

package/dist/integrations/pi/components/upstream/components/tree-selector.d.ts

@@ -6,11 +6,12 @@
  * Models-style filter status with Tab/Shift+Tab directional cycling and concise all-first presentation
  * excluding internal bookkeeping, standard search input, blue item-bounded menu-arrow selection that
  * preserves per-entry semantic foregrounds and has no path bullets, accent entry labels, bracketed
- * timestamps, and plain label-time status, semantic role colors with session naming for the system
- * root, standard paging/first-last/non-root containing-branch folding keys with a permanently expanded
- * system session entry even behind hidden metadata, single-character ellipses on both clipped edges
- * with bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
- * shortcut footers without a redundant select hint.
+ * timestamps, numeric result counters without duplicate label-time status, and a stateful time on/off
+ * shortcut, semantic role colors with session naming for the system root, standard
+ * paging/first-last/non-root containing-branch folding keys with a permanently expanded system session
+ * entry even behind hidden metadata, single-character ellipses on both clipped edges with
+ * bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
+ * Type/search shortcut footers without a redundant select hint.
  * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog.
  */
 import { type Component, Container, type Focusable } from "@earendil-works/pi-tui";
@@ -57,10 +58,10 @@ declare class TreeList implements Component {
     invalidate(): void;
     getSearchQuery(): string;
     getFilterMode(): FilterMode;
+    isLabelTimestampVisible(): boolean;
     getSelectedNode(): SessionTreeNode | undefined;
     copySelected(): void;
     updateNodeLabel(entryId: string, label: string | undefined, labelTimestamp?: string): void;
-    private getStatusLabels;
     render(width: number): string[];
     private getEntryDisplayText;
     private formatLabelTimestamp;

package/dist/integrations/pi/components/upstream/components/tree-selector.js

@@ -6,11 +6,12 @@
  * Models-style filter status with Tab/Shift+Tab directional cycling and concise all-first presentation
  * excluding internal bookkeeping, standard search input, blue item-bounded menu-arrow selection that
  * preserves per-entry semantic foregrounds and has no path bullets, accent entry labels, bracketed
- * timestamps, and plain label-time status, semantic role colors with session naming for the system
- * root, standard paging/first-last/non-root containing-branch folding keys with a permanently expanded
- * system session entry even behind hidden metadata, single-character ellipses on both clipped edges
- * with bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
- * shortcut footers without a redundant select hint.
+ * timestamps, numeric result counters without duplicate label-time status, and a stateful time on/off
+ * shortcut, semantic role colors with session naming for the system root, standard
+ * paging/first-last/non-root containing-branch folding keys with a permanently expanded system session
+ * entry even behind hidden metadata, single-character ellipses on both clipped edges with
+ * bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
+ * Type/search shortcut footers without a redundant select hint.
  * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog.
  */
 import { Container, Input, matchesKey, Spacer, sliceByColumn, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
@@ -528,6 +529,9 @@ class TreeList {
     getFilterMode() {
         return this.filterMode;
     }
+    isLabelTimestampVisible() {
+        return this.showLabelTimestamps;
+    }
     getSelectedNode() {
         return this.filteredNodes[this.selectedIndex]?.node;
     }
@@ -550,16 +554,10 @@ class TreeList {
             }
         }
     }
-    getStatusLabels() {
-        return this.showLabelTimestamps ? " label time" : "";
-    }
     render(width) {
         const lines = [];
         if (this.filteredNodes.length === 0) {
             lines.push(truncateToWidth(theme.fg("muted", "  No entries found"), width));
-            const status = this.getStatusLabels().trim();
-            if (status)
-                lines.push(truncateToWidth(theme.fg("muted", `  ${status}`), width));
             return lines;
         }
         const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(this.maxVisibleLines / 2), this.filteredNodes.length - this.maxVisibleLines));
@@ -632,7 +630,7 @@ class TreeList {
             renderedRows.push({ gutter, body, anchorCol, bodyWidth: visibleWidth(body), rightClipSuffix, isSelected });
         }
         lines.push(...renderHorizontalViewport(renderedRows, width));
-        lines.push(truncateToWidth(theme.fg("muted", `  (${this.selectedIndex + 1}/${this.filteredNodes.length})${this.getStatusLabels()}`), width));
+        lines.push(truncateToWidth(theme.fg("muted", `  (${this.selectedIndex + 1}/${this.filteredNodes.length})`), width));
         return lines;
     }
     getEntryDisplayText(node) {
@@ -1096,12 +1094,19 @@ class TreeFilter {
 }
 /** Component that renders tree help as semantic rows with chunk-aware wrapping */
 class TreeHelp {
+    treeList;
+    constructor(treeList) {
+        this.treeList = treeList;
+    }
     invalidate() { }
     render(width) {
         const items = [
-            ...TREE_HELP_ITEMS.map(({ keys, label, labelFirst }) => {
-                const key = formatHelpKeys(keys);
-                return renderPiModalShortcutHints([key ? { key, action: label, ...(labelFirst === undefined ? {} : { actionFirst: labelFirst }) } : { action: label }]);
+            ...TREE_HELP_ITEMS.map(({ keys, label, labelFirst, displayKey }) => {
+                const key = displayKey ?? formatHelpKeys(keys);
+                const action = keys.includes("app.tree.toggleLabelTimestamp")
+                    ? `time (${this.treeList.isLabelTimestampVisible() ? "on" : "off"})`
+                    : label;
+                return renderPiModalShortcutHints([key ? { key, action, ...(labelFirst === undefined ? {} : { actionFirst: labelFirst }) } : { action }]);
             }),
             renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]),
         ];
@@ -1131,7 +1136,7 @@ class TreeHelp {
     }
 }
 const TREE_HELP_ITEMS = [
-    { keys: [], label: "type to search" },
+    { keys: [], displayKey: "Type", label: "search" },
     { keys: ["tui.select.up", "tui.select.down"], label: "navigate" },
     { keys: ["app.tree.filter.cycleForward"], label: "filter" },
     { keys: ["tui.select.pageUp", "tui.select.pageDown"], label: "page" },
@@ -1139,7 +1144,7 @@ const TREE_HELP_ITEMS = [
     { keys: ["owned.tree.collapse", "owned.tree.expand"], label: "branch" },
     { keys: ["app.message.copy"], label: "copy" },
     { keys: ["app.tree.editLabel"], label: "label" },
-    { keys: ["app.tree.toggleLabelTimestamp"], label: "label time" },
+    { keys: ["app.tree.toggleLabelTimestamp"], label: "time" },
 ];
 function formatHelpKeys(keybindings) {
     const keys = [];
@@ -1235,7 +1240,7 @@ export class TreeSelectorComponent extends Container {
     treeContainer = new Container();
     labelInputContainer = new Container();
     footerContainer = new Container();
-    treeHelp = new TreeHelp();
+    treeHelp;
     labelInput = null;
     onLabelChangeCallback;
     onCopy;
@@ -1261,6 +1266,7 @@ export class TreeSelectorComponent extends Container {
         this.treeList.onLabelEdit = (entryId, currentLabel) => this.showLabelInput(entryId, currentLabel);
         this.searchInput = new TreeSearchInput(this.treeList);
         this.treeFilter = new TreeFilter(this.treeList);
+        this.treeHelp = new TreeHelp(this.treeList);
         this.titleText = new Text(theme.fg("accent", theme.bold("Session Tree")), 0, 0);
         this.restoreTreeContent();
         const header = addPiModalHeader(this, new DynamicBorder(), this.titleText);

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-07T10:23:29.595Z",
+  "builtAt": "2026-10-07T15:54:44.546Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "51b0b2dc1c9ae577f2586c4217066929278726c2c15308d9144eb6f538e118ff",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-07T10:23:29.449Z",
+  "builtAt": "2026-10-07T15:54:41.381Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "ef62679e83bc1fad3d38f9f21675d9256f08d20e67fd4791571032115ca1b0e9",

package/dist/native/win32-x64/manifest.json

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-07T10:24:08.534Z",
+  "builtAt": "2026-10-07T15:55:19.867Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "a59b20f3c04cf9d9cadff5ecfe7b35449646e9b51a92e0245d74ecc99e639502",
+    "sha256": "0c34b684eab04e6d34b7feb5d1f5668f036e55da0af02b3b23516470bc9a4130",
     "size": 288256
   },
   "provenance": {

package/dist/ui/components/dialog-panel.d.ts

@@ -1,3 +1,4 @@
+import { LineInput } from "./line-input.js";
 import { type ShortcutHintEntry } from "./shortcut-hints.js";
 import type { UiTheme } from "./theme.js";
 /**
@@ -7,11 +8,13 @@ import type { UiTheme } from "./theme.js";
  */
 export interface DialogRow {
     readonly label: string;
+    readonly labelSuffix?: string;
     readonly value: string;
     /** What this part does, shown while it is the one in hand. */
     readonly description?: string;
 }
 export interface DialogPanelState {
+    readonly title: string;
     readonly rows: readonly DialogRow[];
     /** The row in hand. */
     readonly index: number;
@@ -26,6 +29,16 @@ export interface DialogPanelFrame {
     /** Column the values start at, so a label stays a label. */
     readonly valueColumn: number;
 }
+export interface SteppedDialogPanelState {
+    readonly title: string;
+    readonly step: number;
+    readonly steps: number;
+    readonly description: string;
+    readonly input?: LineInput;
+    readonly rows: readonly DialogRow[];
+    readonly index: number;
+    readonly hint: readonly ShortcutHintEntry[];
+}
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export declare function dialogValueColumn(rows: readonly DialogRow[]): number;
 /**
@@ -33,5 +46,7 @@ export declare function dialogValueColumn(rows: readonly DialogRow[]): number;
  * one line below the panel's top.
  */
 export declare function renderDialogPanel(state: DialogPanelState, width: number, theme: UiTheme): readonly string[];
+/** Owned stepped-selector composition for structured settings with nested choices. */
+export declare function renderSteppedDialogPanel(state: SteppedDialogPanelState, width: number, theme: UiTheme): readonly string[];
 /** The row a pointer report lands on, or null when it is not on one. */
 export declare function dialogRowAt(frame: DialogPanelFrame, row: number, column: number, valueWidth: number): number | null;

package/dist/ui/components/dialog-panel.js

@@ -1,6 +1,8 @@
-import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
+import { LineInput, renderInputRow } from "./line-input.js";
+import { renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
 import { displayWidth, truncateToWidth } from "./text.js";
 const LABEL_COLUMN_CAP = 30;
+const STEPPED_LABEL_COLUMN_CAP = 46;
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export function dialogValueColumn(rows) {
     const widest = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...rows.map(row => displayWidth(row.label))));
@@ -35,14 +37,59 @@ export function renderDialogPanel(state, width, theme) {
     const plainHint = typeof state.hint === "string" ? state.hint : " ".repeat(displayWidth(hint));
     return [
         rule,
-        ...rows,
+        contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
+        contentRow(theme.fg("dim", description), description),
         "",
-        contentRow(theme.fg("dim", `  ${description}`), `  ${description}`),
+        ...rows,
         "",
         contentRow(hint, plainHint),
         rule,
     ];
 }
+/** Owned stepped-selector composition for structured settings with nested choices. */
+export function renderSteppedDialogPanel(state, width, theme) {
+    const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
+    const contentPadding = Math.min(1, Math.max(0, width));
+    const contentWidth = Math.max(0, width - contentPadding);
+    const inset = " ".repeat(contentPadding);
+    const contentRow = (painted, raw) => `${inset}${pad(truncateToWidth(painted, contentWidth), contentWidth, raw)}`;
+    const labelColumn = Math.min(STEPPED_LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(`${row.label}${row.labelSuffix ?? ""}`))));
+    const rows = state.rows.map((row, index) => {
+        const selected = index === state.index;
+        const completeLabel = `${row.label}${row.labelSuffix ?? ""}`;
+        const padding = " ".repeat(Math.max(0, labelColumn - displayWidth(completeLabel)));
+        const suffix = row.value.length === 0 ? "" : `  ${row.value}`;
+        const cursor = selected ? "→ " : "  ";
+        const raw = `${cursor}${completeLabel}${padding}${suffix}`;
+        const label = `${theme.fg("text", row.label)}${theme.fg("muted", row.labelSuffix ?? "")}${padding}`;
+        const content = selected
+            ? `${theme.fg("accent", cursor)}${label}${theme.fg("muted", suffix)}`
+            : `${cursor}${label}${theme.fg("muted", suffix)}`;
+        return contentRow(selected ? theme.highlight(content) : content, raw);
+    });
+    const input = state.input === undefined
+        ? []
+        : [...renderInputRow(state.input, width, { ruled: false, promptGlyph: "> ", theme }).lines, ""];
+    const step = `(step ${state.step}/${state.steps})`;
+    const title = `${state.title} ${step}`;
+    const paintedTitle = `${theme.bold(theme.fg("accent", state.title))} ${theme.fg("dim", step)}`;
+    return [
+        rule,
+        contentRow(paintedTitle, title),
+        contentRow(theme.fg("dim", state.description), state.description),
+        "",
+        ...input,
+        ...rows,
+        "",
+        renderSteppedHint(state.hint, width, theme),
+        rule,
+    ];
+}
+function renderSteppedHint(entries, width, theme) {
+    const raw = shortcutHintsText(entries, 1, " · ");
+    const painted = renderShortcutHints(entries, theme, 1, theme.fg("dim", " · "));
+    return `${truncateToWidth(painted, width)}${" ".repeat(Math.max(0, width - displayWidth(raw)))}`;
+}
 /** The row a pointer report lands on, or null when it is not on one. */
 export function dialogRowAt(frame, row, column, valueWidth) {
     const at = row - frame.firstRow;

package/dist/ui/components/index.d.ts

@@ -1,5 +1,5 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel } from "./dialog-panel.js";
-export type { DialogPanelFrame, DialogPanelState, DialogRow } from "./dialog-panel.js";
+export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
+export type { DialogPanelFrame, DialogPanelState, DialogRow, SteppedDialogPanelState } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export type { PaneRect } from "./frame.js";
 export { humanizeLabel, humanizeTitle } from "./label.js";
@@ -23,7 +23,7 @@ export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selecti
 export type { SelectionCopyPrompt, SelectionCopyRow, SelectionCopySnapshot } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export type { RailPointer, RailPosition, ScrollbarAppearance, ScrollbarGeometry, ScrollbarInput, ScrollbarPresentation, ScrollbarPresentationInput, ScrollbarSpeed, ScrollbarStyle, } from "./scrollbar.js";
-export { renderShortcutHints, renderShortcutHintsWithClose } from "./shortcut-hints.js";
+export { assertOwnedShortcutHintConventions, renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
 export type { ShortcutHintEntry } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
 export type { ShortcutConflict, ShortcutDeclaration, ShortcutRegistryResult } from "./shortcuts.js";

package/dist/ui/components/index.js

@@ -1,4 +1,4 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel } from "./dialog-panel.js";
+export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export { humanizeLabel, humanizeTitle } from "./label.js";
 export { LineInput, caretCell, handleLineInputKey, renderInputRow, wordLeft, wordRight } from "./line-input.js";
@@ -11,7 +11,7 @@ export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
-export { renderShortcutHints, renderShortcutHintsWithClose } from "./shortcut-hints.js";
+export { assertOwnedShortcutHintConventions, renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
 export { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, hyperlinkTargetAtColumn, nativeHyperlinkStyle, overlaySpan } from "./spans.js";
 export { readVisibleHyperlinks } from "./visible-hyperlinks.js";

package/dist/ui/components/line-input.d.ts

@@ -58,6 +58,8 @@ export interface InputRowOptions {
     readonly placeholder?: string;
     /** Rules above and below, in the prompt's own grey. Default true. */
     readonly ruled?: boolean;
+    /** Prompt marker including any following spacing. Defaults to the shared prompt glyph. */
+    readonly promptGlyph?: string;
     readonly theme?: Pick<UiTheme, "fg">;
 }
 export interface InputRow {