toolcraft 0.0.69 → 0.0.71

package/node_modules/toolcraft-design/dist/explorer/layout.js

@@ -40,13 +40,15 @@ export function computeExplorerLayout(opts) {
             footer
         };
     }
-    const listWidth = mode === "wide" ? Math.floor((cols * 5) / 12) : Math.floor((cols * 2) / 5);
-    const detailWidth = cols - listWidth;
+    const gutterWidth = 1;
+    const availableWidth = Math.max(0, cols - gutterWidth);
+    const listWidth = mode === "wide" ? Math.floor((availableWidth * 5) / 12) : Math.floor((availableWidth * 2) / 5);
+    const detailWidth = availableWidth - listWidth;
     return {
         mode,
         header,
         list: { x: 0, y: contentY, width: listWidth, height: contentHeight },
-        detail: { x: listWidth, y: contentY, width: detailWidth, height: contentHeight },
+        detail: { x: listWidth + gutterWidth, y: contentY, width: detailWidth, height: contentHeight },
         footer
     };
 }

package/node_modules/toolcraft-design/dist/explorer/reducer.js

@@ -238,7 +238,9 @@ function detailLoaded(state, rowId, token, items) {
     };
 }
 function detailItemRendered(state, rowId, token, itemIndex, content) {
-    if (state.detail.rowId !== rowId || state.detail.token !== token || state.detail.items?.[itemIndex] === undefined) {
+    if (state.detail.rowId !== rowId ||
+        state.detail.token !== token ||
+        state.detail.items?.[itemIndex] === undefined) {
         return mark(state, 0);
     }
     const items = state.detail.items.map((item, index) => index === itemIndex ? { ...item, renderedContent: content } : item);
@@ -354,7 +356,14 @@ function updateFilter(state, filter) {
         matchPositions,
         cursor,
         detail,
-        actionState: recomputeActionState({ ...state, filter, filtered, matchPositions, cursor, detail }),
+        actionState: recomputeActionState({
+            ...state,
+            filter,
+            filtered,
+            matchPositions,
+            cursor,
+            detail
+        }),
         dirty: REGION_HEADER | REGION_LIST | REGION_DETAIL | REGION_FOOTER
     };
     const effect = detailEffect(next);
@@ -385,7 +394,11 @@ function escape(state, runtimeHandles) {
     if (state.filterFocused || state.filter.length > 0) {
         const cleared = updateFilter({ ...state, filterFocused: false }, "");
         return {
-            state: { ...cleared.state, filterFocused: false, dirty: cleared.state.dirty | REGION_HEADER | REGION_FOOTER },
+            state: {
+                ...cleared.state,
+                filterFocused: false,
+                dirty: cleared.state.dirty | REGION_HEADER | REGION_FOOTER
+            },
             effects: cleared.effects
         };
     }
@@ -500,9 +513,9 @@ function detailBodyHeight(state) {
     if (state.layout === "narrow-vertical") {
         const listHeight = Math.ceil(contentHeight / 2);
         const detailHeight = contentHeight - listHeight;
-        return Math.max(0, detailHeight - 1);
+        return Math.max(0, detailHeight - 2);
     }
-    return contentHeight;
+    return Math.max(0, contentHeight - 2);
 }
 function extendSelection(state, delta) {
     if (!state.multiSelect) {
@@ -557,7 +570,10 @@ function reorder(state, delta) {
         actionState: recomputeActionState({ ...state, rows, filtered, matchPositions, cursor }),
         dirty: REGION_LIST | REGION_FOOTER
     };
-    return { state: next, effects: [{ type: "persistOrder", orderedIds: rows.map((row) => row.id) }] };
+    return {
+        state: next,
+        effects: [{ type: "persistOrder", orderedIds: rows.map((row) => row.id) }]
+    };
 }
 function paletteInput(state, key) {
     if (state.modal?.kind !== "palette") {

package/node_modules/toolcraft-design/dist/explorer/render/detail.js

@@ -1,4 +1,7 @@
+import { stripAnsi } from "../../internal/strip-ansi.js";
+import { renderMarkdown } from "../../terminal-markdown/index.js";
 import { getExplorerStyles } from "../theme.js";
+import { drawPaneFrame, paneBodyRect } from "./pane.js";
 import { fitToWidth } from "./text.js";
 export function renderDetail(state, screen, layout) {
     const rect = layout.detail;
@@ -9,16 +12,19 @@ export function renderDetail(state, screen, layout) {
     }
     const row = state.rows.find((r) => r.id === state.detail.rowId) ?? null;
     if (layout.mode === "narrow-vertical") {
-        screen.put(rect.x, rect.y, `├─ Detail ${"─".repeat(Math.max(0, rect.width - 11))}┤`, styles.border);
-        renderDetailBody(state, screen, { ...rect, y: rect.y + 1, height: rect.height - 1 }, row);
+        drawPaneFrame(screen, rect, "Preview", state.focused === "detail" ? styles.borderFocused : styles.border);
+        renderDetailBody(state, screen, paneBodyRect(rect), row);
         return;
     }
-    screen.put(rect.x, rect.y, "│", styles.border);
-    renderDetailBody(state, screen, { ...rect, x: rect.x + 1, width: rect.width - 1 }, row);
+    drawPaneFrame(screen, rect, "Preview", state.focused === "detail" ? styles.borderFocused : styles.border);
+    renderDetailBody(state, screen, paneBodyRect(rect), row);
 }
 function renderDetailBody(state, screen, rect, row) {
     const styles = getExplorerStyles();
     const items = state.detail.items;
+    if (rect.width <= 0 || rect.height <= 0) {
+        return;
+    }
     if (items === null) {
         writeLine(screen, rect, 0, state.detail.loading ? "Loading detail..." : state.emptyHint, styles.muted);
         return;
@@ -28,7 +34,7 @@ function renderDetailBody(state, screen, rect, row) {
         return;
     }
     if (items.length === 1 && items[0]?.title === undefined) {
-        renderBlob(screen, rect, renderItem(items[0], rect, row), state.detail.scroll);
+        renderBlob(screen, rect, renderItemMarkdown(items[0], rect, row), state.detail.scroll);
         return;
     }
     renderListMode(state, screen, rect, items, row);
@@ -49,7 +55,7 @@ function renderListMode(state, screen, rect, items, row) {
             writeLine(screen, rect, y, `  ${item.subtitle}`, styles.muted);
             y += 1;
         }
-        for (const line of renderItem(item, rect, row).split("\n")) {
+        for (const line of renderItemMarkdown(item, rect, row).split("\n")) {
             if (y >= rect.height) {
                 break;
             }
@@ -69,6 +75,13 @@ function renderBlob(screen, rect, text, scroll) {
         writeLine(screen, rect, row, lines[row] ?? "");
     }
 }
+function renderItemMarkdown(item, rect, row) {
+    const content = renderItem(item, rect, row);
+    if (content.trim().length === 0) {
+        return "";
+    }
+    return stripAnsi(renderMarkdown(content, { width: Math.max(1, rect.width) }).trimEnd());
+}
 function renderItem(item, rect, row) {
     if (item.renderedContent !== undefined) {
         return item.renderedContent;

package/node_modules/toolcraft-design/dist/explorer/render/list.js

@@ -1,4 +1,5 @@
 import { getExplorerStyles } from "../theme.js";
+import { drawPaneFrame, paneBodyRect } from "./pane.js";
 import { cellWidth, centerCells, fitToWidth, splitGraphemeCells, stripAnsi } from "./text.js";
 const listLineCache = new WeakMap();
 export function renderList(state, screen, layout) {
@@ -12,36 +13,41 @@ export function renderList(state, screen, layout) {
         writeLine(screen, rect, 0, "Terminal too narrow", styles.muted);
         return;
     }
-    const rectKey = `${rect.x}:${rect.y}:${rect.width}:${rect.height}`;
+    drawPaneFrame(screen, rect, "Plans", state.focused === "list" ? styles.borderFocused : styles.border);
+    const bodyRect = paneBodyRect(rect);
+    if (bodyRect.width <= 0 || bodyRect.height <= 0) {
+        return;
+    }
+    const rectKey = `${bodyRect.x}:${bodyRect.y}:${bodyRect.width}:${bodyRect.height}`;
     const cached = listLineCache.get(screen);
     const cache = cached?.rectKey === rectKey ? cached.lines : new Map();
     listLineCache.set(screen, { rectKey, lines: cache });
     if (state.filtered.length === 0) {
         const hint = state.emptyHint;
-        writeLine(screen, rect, Math.floor(rect.height / 2), centerCells(hint, rect.width, rect.x), styles.muted);
+        writeLine(screen, bodyRect, Math.floor(bodyRect.height / 2), centerCells(hint, bodyRect.width, bodyRect.x), styles.muted);
         cache.clear();
         return;
     }
     let lastGroup;
     let y = 0;
     for (const rowIndex of state.filtered) {
-        if (y >= rect.height) {
+        if (y >= bodyRect.height) {
             break;
         }
         const row = state.rows[rowIndex];
         if (!row) {
             continue;
         }
-        if (row.group && row.group !== lastGroup && y < rect.height) {
+        if (row.group && row.group !== lastGroup && y < bodyRect.height) {
             const hash = `group:${row.group}`;
             if (cache.get(y) !== hash) {
-                writeLine(screen, rect, y, row.group, styles.muted);
+                writeLine(screen, bodyRect, y, row.group, styles.muted);
                 cache.set(y, hash);
             }
             y += 1;
             lastGroup = row.group;
         }
-        if (y >= rect.height) {
+        if (y >= bodyRect.height) {
             break;
         }
         const selected = state.multiSelect && state.selected.has(row.id);
@@ -49,14 +55,19 @@ export function renderList(state, screen, layout) {
         const positions = state.matchPositions.get(rowIndex) ?? [];
         const hash = lineHash(row, selected, cursor, positions);
         if (cache.get(y) !== hash) {
-            renderRow(screen, rect, y, row, { selected, cursor, focused: state.focused === "list", positions });
+            renderRow(screen, bodyRect, y, row, {
+                selected,
+                cursor,
+                focused: state.focused === "list",
+                positions
+            });
             cache.set(y, hash);
         }
         y += 1;
-        if (row.subtitle && y < rect.height) {
+        if (row.subtitle && y < bodyRect.height) {
             const subtitleHash = `${hash}:subtitle:${row.subtitle}`;
             if (cache.get(y) !== subtitleHash) {
-                writeLine(screen, rect, y, `  ${row.subtitle}`, styles.muted);
+                writeLine(screen, bodyRect, y, `  ${row.subtitle}`, styles.muted);
                 cache.set(y, subtitleHash);
             }
             y += 1;

package/node_modules/toolcraft-design/dist/explorer/render/pane.d.ts

@@ -0,0 +1,5 @@
+import { ScreenBuffer } from "../../dashboard/buffer.js";
+import type { CellStyle } from "../../dashboard/types.js";
+import type { Rect } from "../layout.js";
+export declare function drawPaneFrame(screen: ScreenBuffer, rect: Rect, title: string, style?: CellStyle): void;
+export declare function paneBodyRect(rect: Rect): Rect;

package/node_modules/toolcraft-design/dist/explorer/render/pane.js

@@ -0,0 +1,30 @@
+import { fitToWidth, padEndCells } from "./text.js";
+export function drawPaneFrame(screen, rect, title, style = {}) {
+    if (rect.width <= 0 || rect.height <= 0) {
+        return;
+    }
+    if (rect.width === 1) {
+        for (let y = 0; y < rect.height; y += 1) {
+            screen.put(rect.x, rect.y + y, "│", style);
+        }
+        return;
+    }
+    const innerWidth = Math.max(0, rect.width - 2);
+    const titleSegment = padEndCells(fitToWidth(`─ ${title} `, innerWidth, rect.x + 1), innerWidth, "─", rect.x + 1);
+    screen.put(rect.x, rect.y, `┌${titleSegment}┐`, style);
+    for (let y = 1; y < rect.height - 1; y += 1) {
+        screen.put(rect.x, rect.y + y, "│", style);
+        screen.put(rect.x + rect.width - 1, rect.y + y, "│", style);
+    }
+    if (rect.height > 1) {
+        screen.put(rect.x, rect.y + rect.height - 1, `└${"─".repeat(innerWidth)}┘`, style);
+    }
+}
+export function paneBodyRect(rect) {
+    return {
+        x: rect.x + 2,
+        y: rect.y + 1,
+        width: Math.max(0, rect.width - 4),
+        height: Math.max(0, rect.height - 2)
+    };
+}

package/node_modules/toolcraft-design/dist/explorer/two-pane.d.ts

@@ -37,6 +37,11 @@ export interface TwoPaneExplorerConfig<R> {
     panes: [TwoPaneDefinition, TwoPaneDefinition];
     actions: TwoPaneAction<R>[];
     refresh?: () => void | Promise<void>;
+    trace?: (record: TwoPaneTraceRecord) => void | Promise<void>;
+}
+export interface TwoPaneTraceRecord {
+    event: string;
+    [key: string]: unknown;
 }
 export interface TwoPanePaneState {
     id: string;
@@ -75,6 +80,8 @@ export declare class TwoPaneExplorerRuntime<R> {
     constructor(config: TwoPaneExplorerConfig<R>, driver: TerminalDriver);
     run(): Promise<R | null>;
     private startTerminal;
+    private subscribeKeypress;
+    private pauseKeypress;
     private loadRows;
     private refresh;
     private dispatchKey;
@@ -90,5 +97,6 @@ export declare class TwoPaneExplorerRuntime<R> {
     private render;
     private exit;
     private fail;
+    private trace;
 }
 export declare function renderTwoPaneExplorer<R>(state: TwoPaneExplorerState, actions: TwoPaneAction<R>[], screen: ScreenBuffer): void;

package/node_modules/toolcraft-design/dist/explorer/two-pane.js

@@ -51,14 +51,21 @@ export class TwoPaneExplorerRuntime {
         this.driver.enterAltScreen();
         this.driver.disableLineWrap();
         this.driver.hideCursor();
-        this.unsubscribeKeypress = this.driver.onKeypress((key) => {
-            this.dispatchKey(key);
-        });
+        this.subscribeKeypress();
         this.unsubscribeResize = this.driver.onResize(() => {
             this.state = { ...this.state, size: normalizeSize(this.driver.getSize()) };
             this.render();
         });
     }
+    subscribeKeypress() {
+        this.unsubscribeKeypress = this.driver.onKeypress((key) => {
+            this.dispatchKey(key);
+        });
+    }
+    pauseKeypress() {
+        this.unsubscribeKeypress?.();
+        this.unsubscribeKeypress = undefined;
+    }
     async loadRows(requestToken = ++this.rowsRequestToken) {
         const [leftRows, rightRows] = await Promise.all([
             this.config.panes[0].rows(),
@@ -84,6 +91,14 @@ export class TwoPaneExplorerRuntime {
         if (this.stopped) {
             return;
         }
+        this.trace("key", {
+            key: traceKey(key),
+            filterFocused: this.state.filterFocused,
+            pane: this.activePane().id,
+            cursor: this.activePane().cursor,
+            selected: this.activePane().selected.size,
+            filter: this.activePane().filter
+        });
         if (this.state.filterFocused) {
             this.dispatchFilterKey(key);
             return;
@@ -92,7 +107,7 @@ export class TwoPaneExplorerRuntime {
             this.exit(null);
             return;
         }
-        if (key.name === "tab") {
+        if (isTabKey(key)) {
             this.state = {
                 ...this.state,
                 activePaneIndex: this.state.activePaneIndex === 0 ? 1 : 0
@@ -112,7 +127,7 @@ export class TwoPaneExplorerRuntime {
             this.setCursor(filteredRows(this.activePane()).length - 1);
             return;
         }
-        if (key.ch === " ") {
+        if (key.ch === " " || key.name === "space") {
             this.toggleSelection();
             return;
         }
@@ -131,8 +146,14 @@ export class TwoPaneExplorerRuntime {
         }
     }
     dispatchFilterKey(key) {
-        if (key.name === "escape" || key.name === "return") {
+        if (key.name === "escape" || key.name === "return" || key.name === "enter") {
             this.state = { ...this.state, filterFocused: false };
+            this.trace("filter.submit", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
             return;
         }
@@ -145,6 +166,12 @@ export class TwoPaneExplorerRuntime {
                     cursor: 0
                 }))
             };
+            this.trace("filter.update", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
             return;
         }
@@ -157,6 +184,12 @@ export class TwoPaneExplorerRuntime {
                     cursor: 0
                 }))
             };
+            this.trace("filter.update", {
+                key: traceKey(key),
+                pane: this.activePane().id,
+                filter: this.activePane().filter,
+                rows: filteredRows(this.activePane()).length
+            });
             this.render();
         }
     }
@@ -195,6 +228,14 @@ export class TwoPaneExplorerRuntime {
             ...this.state,
             panes: updateActivePane(this.state, (candidate) => ({ ...candidate, selected }))
         };
+        this.trace("selection.toggle", {
+            pane: pane.id,
+            row: row.id,
+            selected: selected.size,
+            checked: selected.has(row.id),
+            filter: pane.filter,
+            cursor: pane.cursor
+        });
         this.render();
     }
     runAction(action) {
@@ -223,6 +264,7 @@ export class TwoPaneExplorerRuntime {
         });
     }
     async suspendAnd(fn) {
+        this.pauseKeypress();
         this.driver.exitAltScreen();
         this.driver.enableLineWrap();
         this.driver.showCursor();
@@ -236,6 +278,7 @@ export class TwoPaneExplorerRuntime {
                 this.driver.enterAltScreen();
                 this.driver.disableLineWrap();
                 this.driver.hideCursor();
+                this.subscribeKeypress();
                 this.state = { ...this.state, size: normalizeSize(this.driver.getSize()) };
                 this.render();
             }
@@ -290,6 +333,15 @@ export class TwoPaneExplorerRuntime {
         }
         this.settle?.reject(error);
     }
+    trace(event, fields = {}) {
+        const trace = this.config.trace;
+        if (trace === undefined) {
+            return;
+        }
+        void Promise.resolve(trace({ event, ...fields })).catch(() => {
+            // Diagnostic tracing must not interfere with TUI input handling.
+        });
+    }
 }
 export function renderTwoPaneExplorer(state, actions, screen) {
     screen.clear();
@@ -402,9 +454,21 @@ function actionMatchesKey(action, key) {
     const keys = Array.isArray(action.key) ? action.key : [action.key];
     return keys.some((candidate) => key.ch === candidate || key.name === candidate);
 }
+function isTabKey(key) {
+    return key.name === "tab" || key.ch === "\t" || (key.name === "i" && key.ctrl);
+}
 function firstKey(key) {
     return Array.isArray(key) ? key[0] ?? "" : key;
 }
+function traceKey(key) {
+    return {
+        name: key.name,
+        ch: key.ch,
+        ctrl: key.ctrl,
+        meta: key.meta,
+        shift: key.shift
+    };
+}
 function isQuitKey(key) {
     return key.ch === "q" || (key.name === "c" && key.ctrl);
 }

package/node_modules/toolcraft-design/dist/prompts/interactive/glyphs.d.ts

@@ -10,9 +10,9 @@ export declare const GLYPHS: {
     readonly barEnd: string;
     readonly radioActive: string;
     readonly radioInactive: string;
-    readonly checkboxActive: string;
-    readonly checkboxSelected: string;
-    readonly checkboxInactive: string;
+    readonly checkboxActive: "[ ]";
+    readonly checkboxSelected: "[x]";
+    readonly checkboxInactive: "[ ]";
     readonly passwordMask: string;
     readonly ellipsis: "...";
 };

package/node_modules/toolcraft-design/dist/prompts/interactive/glyphs.js

@@ -27,9 +27,9 @@ export const GLYPHS = {
     barEnd: glyph("└", "-"),
     radioActive: glyph("●", ">"),
     radioInactive: glyph("○", " "),
-    checkboxActive: glyph("◻", "[ ]"),
-    checkboxSelected: glyph("◼", "[+]"),
-    checkboxInactive: glyph("◻", "[ ]"),
+    checkboxActive: "[ ]",
+    checkboxSelected: "[x]",
+    checkboxInactive: "[ ]",
     passwordMask: glyph("•", "*"),
     ellipsis: "..."
 };

package/node_modules/toolcraft-design/dist/prompts/interactive/keys.js

@@ -21,6 +21,9 @@ export function mapKey(name, char) {
     if (char === " ") {
         return "space";
     }
+    if (char !== undefined && aliases[char] !== undefined) {
+        return aliases[char];
+    }
     if (!name) {
         return undefined;
     }

package/node_modules/toolcraft-design/dist/prompts/interactive/multiselect.js

@@ -102,10 +102,14 @@ function renderOption(option, values, active, submitted, cancelled) {
 }
 function renderMultiselectPrompt(prompt, opts) {
     if (prompt.state === "submit" || prompt.state === "cancel") {
-        const labels = prompt.visibleOptions
-            .filter((option) => hasValue(prompt.value, option.value))
-            .map((option) => prompt.state === "submit" ? color.dim(option.label) : color.dim.strikethrough(option.label))
-            .join(", ");
+        const selectedOptions = prompt.visibleOptions.filter((option) => hasValue(prompt.value, option.value));
+        const labels = selectedOptions.length > 3
+            ? prompt.state === "submit"
+                ? color.dim(`${selectedOptions.length} selected`)
+                : color.dim.strikethrough(`${selectedOptions.length} selected`)
+            : selectedOptions
+                .map((option) => prompt.state === "submit" ? color.dim(option.label) : color.dim.strikethrough(option.label))
+                .join(", ");
         const end = prompt.state === "submit" ? color.green(GLYPHS.barEnd) : color.red(GLYPHS.barEnd);
         return `${color.gray(GLYPHS.barStart)} ${symbol(prompt.state)} ${opts.message}\n${color.gray(GLYPHS.bar)}  ${labels}\n${end}`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.69",
+  "version": "0.0.71",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,8 +47,8 @@
     "postpack": "node ../../scripts/manage-bundled-workspace-deps.mjs cleanup . toolcraft-design @poe-code/frontmatter @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store"
   },
   "dependencies": {
-    "toolcraft-schema": "0.0.69",
-    "commander": "^14.0.3",
+    "toolcraft-schema": "0.0.71",
+    "commander": "^13.1.0",
     "fast-string-width": "^3.0.2",
     "fast-wrap-ansi": "^0.2.0",
     "ignore": "^5.3.2",
@@ -63,7 +63,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=18.18"
   },
   "repository": {
     "type": "git",