agentweaver 0.1.15 → 0.1.16

package/dist/interactive-ui.js

@@ -3,21 +3,18 @@ import blessed from "neo-blessed";
 import { renderMarkdownToTerminal } from "./markdown.js";
 import { setOutputAdapter, stripAnsi } from "./tui.js";
 import { FlowInterruptedError, TaskRunnerError } from "./errors.js";
-import { buildInitialUserInputValues, validateUserInputValues, } from "./user-input.js";
+import { buildProgressViewModel } from "./interactive/progress.js";
+import { selectHeaderLabel } from "./interactive/selectors.js";
+import { buildFlowTree, computeVisibleFlowItems, makeFlowKey, makeFolderKey } from "./interactive/tree.js";
+import { buildInitialUserInputValues, normalizeUserInputFieldValue, resolveFieldDefinition, validateUserInputValues, } from "./user-input.js";
 const CONFIRM_MIN_WIDTH = 44;
 const CONFIRM_MIN_HEIGHT = 8;
-function compareTreeNames(left, right) {
-    return left.localeCompare(right, "ru");
-}
-function makeFolderKey(pathSegments) {
-    return `folder:${pathSegments.join("/")}`;
-}
-function makeFlowKey(flowId) {
-    return `flow:${flowId}`;
-}
 function escapeBlessedTags(text) {
     return text.replace(/[{}]/g, (ch) => (ch === "{" ? "{open}" : "{close}"));
 }
+function stripBlessedTags(text) {
+    return text.replace(/\{[^}]+\}/g, "");
+}
 function textIndexToLineColumn(value, index) {
     const boundedIndex = Math.max(0, Math.min(value.length, index));
     const beforeCursor = value.slice(0, boundedIndex);
@@ -37,91 +34,6 @@ function textLineColumnToIndex(value, line, column) {
     const targetLine = lines[boundedLine] ?? "";
     return index + Math.max(0, Math.min(targetLine.length, column));
 }
-function buildFlowTree(flows) {
-    const roots = new Map();
-    const ensureFolder = (pathSegments) => {
-        const firstSegment = pathSegments[0];
-        if (!firstSegment) {
-            throw new Error("Flow tree folder path cannot be empty.");
-        }
-        const rootFolder = roots.get(firstSegment);
-        let currentFolder;
-        if (rootFolder) {
-            currentFolder = rootFolder;
-        }
-        else {
-            currentFolder = {
-                kind: "folder",
-                key: makeFolderKey([firstSegment]),
-                name: firstSegment,
-                pathSegments: [firstSegment],
-                children: [],
-            };
-            roots.set(firstSegment, currentFolder);
-        }
-        for (let index = 1; index < pathSegments.length; index += 1) {
-            const segment = pathSegments[index] ?? "";
-            const folderPath = pathSegments.slice(0, index + 1);
-            let nextFolder = currentFolder.children.find((child) => child.kind === "folder" && child.name === segment);
-            if (!nextFolder) {
-                nextFolder = {
-                    kind: "folder",
-                    key: makeFolderKey(folderPath),
-                    name: segment,
-                    pathSegments: folderPath,
-                    children: [],
-                };
-                currentFolder.children.push(nextFolder);
-            }
-            currentFolder = nextFolder;
-        }
-        return currentFolder;
-    };
-    for (const flow of flows) {
-        if (flow.treePath.length === 0) {
-            continue;
-        }
-        const folderPath = flow.treePath.slice(0, -1);
-        const leafName = flow.treePath[flow.treePath.length - 1] ?? flow.id;
-        const parent = ensureFolder(folderPath);
-        parent.children.push({
-            kind: "flow",
-            key: makeFlowKey(flow.id),
-            name: leafName,
-            pathSegments: [...flow.treePath],
-            flow,
-        });
-    }
-    const sortNodes = (nodes) => [...nodes]
-        .sort((left, right) => {
-        if (left.kind !== right.kind) {
-            return left.kind === "folder" ? -1 : 1;
-        }
-        return compareTreeNames(left.name, right.name);
-    })
-        .map((node) => node.kind === "folder"
-        ? {
-            ...node,
-            children: sortNodes(node.children),
-        }
-        : node);
-    const orderedRootNames = ["custom", "default"];
-    const sortedRoots = [...roots.values()].sort((left, right) => {
-        const leftIndex = orderedRootNames.indexOf(left.name);
-        const rightIndex = orderedRootNames.indexOf(right.name);
-        if (leftIndex !== -1 || rightIndex !== -1) {
-            if (leftIndex === -1) {
-                return 1;
-            }
-            if (rightIndex === -1) {
-                return -1;
-            }
-            return leftIndex - rightIndex;
-        }
-        return compareTreeNames(left.name, right.name);
-    });
-    return sortNodes(sortedRoots);
-}
 export class InteractiveUi {
     options;
     screen;
@@ -136,6 +48,7 @@ export class InteractiveUi {
     help;
     confirm;
     formModal;
+    formPreviewBox;
     formLineInput;
     formTextInput;
     formBooleanInput;
@@ -324,6 +237,29 @@ export class InteractiveUi {
                 fg: "white",
             },
         });
+        this.formPreviewBox = blessed.box({
+            parent: this.formModal,
+            top: 0,
+            left: 0,
+            width: "100%-2",
+            height: 8,
+            hidden: true,
+            tags: true,
+            mouse: true,
+            keys: true,
+            vi: true,
+            scrollable: true,
+            alwaysScroll: true,
+            border: "line",
+            scrollbar: {
+                ch: " ",
+                inverse: true,
+            },
+            style: {
+                border: { fg: "cyan" },
+                fg: "white",
+            },
+        });
         this.formTextInput = blessed.box({
             parent: this.formModal,
             top: 0,
@@ -854,7 +790,12 @@ export class InteractiveUi {
         if (!this.activeFormSession) {
             return null;
         }
-        return this.activeFormSession.form.fields[this.activeFormSession.currentFieldIndex] ?? null;
+        const field = this.activeFormSession.form.fields[this.activeFormSession.currentFieldIndex] ?? null;
+        if (!field) {
+            return null;
+        }
+        normalizeUserInputFieldValue(field, this.activeFormSession.values);
+        return resolveFieldDefinition(field, this.activeFormSession.values);
     }
     formModalInnerHeight() {
         const rawHeight = typeof this.formModal.height === "number" ? this.formModal.height : this.formModal?.lpos?.yi
@@ -872,9 +813,17 @@ export class InteractiveUi {
         const paddingRight = Number(this.formModal.padding?.right ?? 0);
         return Math.max(24, rawWidth - 2 - paddingLeft - paddingRight);
     }
+    renderedFormLineCount(lines) {
+        const width = Math.max(1, this.formModalInnerWidth() - 2);
+        return lines.reduce((total, line) => {
+            const visible = stripAnsi(stripBlessedTags(line));
+            return total + Math.max(1, Math.ceil(visible.length / width));
+        }, 0);
+    }
     renderActiveForm() {
         if (!this.activeFormSession) {
             this.formModal.hide();
+            this.hideFormPreviewBox();
             this.hideFormLineInput();
             this.hideFormTextInput();
             this.hideFormBooleanInput();
@@ -907,6 +856,7 @@ export class InteractiveUi {
         let footerHint = ` Form: Enter ${isLastField ? "submit" : "confirm"} | Tab next | Shift+Tab prev | Esc cancel `;
         let hintLines = [];
         if (field.type === "boolean") {
+            this.hideFormPreviewBox();
             this.hideFormLineInput();
             this.hideFormTextInput();
             this.hideFormSelectInput();
@@ -927,6 +877,7 @@ export class InteractiveUi {
             footerHint = ` Form: Space toggle | Enter ${isLastField ? "submit" : "next"} | Tab switch | Esc cancel `;
         }
         else if (field.type === "text") {
+            this.hideFormPreviewBox();
             this.hideFormBooleanInput();
             this.hideFormSelectInput();
             helperLines.push("{cyan-fg}Use the standard editor below.{/cyan-fg}");
@@ -958,8 +909,31 @@ export class InteractiveUi {
             this.hideFormLineInput();
             this.hideFormTextInput();
             this.hideFormBooleanInput();
-            helperLines.push("{cyan-fg}Use the list below.{/cyan-fg}");
-            this.ensureFormSelectInputVisible(headerLines.length + helperLines.length, 0);
+            const previewContent = session.form.preview?.trim() ?? "";
+            let previewScrollable = false;
+            if (previewContent.length > 0) {
+                this.hideFormPreviewBox();
+                helperLines.push("{cyan-fg}Review the content above, then choose an action below.{/cyan-fg}");
+                lines.push(...helperLines);
+                const previewLines = previewContent.split("\n");
+                const viewportHeight = this.formPreviewViewportHeight(this.renderedFormLineCount(lines), 0);
+                const maxOffset = Math.max(0, previewLines.length - viewportHeight);
+                session.previewScrollOffset = Math.max(0, Math.min(session.previewScrollOffset, maxOffset));
+                const visibleLines = previewLines.slice(session.previewScrollOffset, session.previewScrollOffset + viewportHeight);
+                lines.push("", ...visibleLines);
+                previewScrollable = maxOffset > 0;
+                if (previewScrollable) {
+                    const firstVisibleLine = session.previewScrollOffset + 1;
+                    const lastVisibleLine = session.previewScrollOffset + visibleLines.length;
+                    lines.push("", `{gray-fg}Preview ${firstVisibleLine}-${lastVisibleLine} of ${previewLines.length}. Use PageUp/PageDown to scroll.{/gray-fg}`);
+                }
+            }
+            else {
+                this.hideFormPreviewBox();
+                helperLines.push("{cyan-fg}Use the list below.{/cyan-fg}");
+                lines.push(...helperLines);
+            }
+            this.ensureFormSelectInputVisible(this.renderedFormLineCount(lines), 0);
             const preferredOptionIndex = field.type === "single-select"
                 ? this.selectedOptionIndexForField(field)
                 : session.currentOptionIndex;
@@ -977,11 +951,17 @@ export class InteractiveUi {
             this.formSelectInput.select(currentOptionIndex);
             hintLines = [
                 `Up/Down: move | Space: ${field.type === "single-select" ? "pick" : "toggle"} | Enter: ${isLastField ? "submit" : "confirm and next"}`,
-                "Tab/Shift+Tab: switch field | Esc: cancel",
+                previewScrollable
+                    ? "PageUp/PageDown: scroll preview | Tab/Shift+Tab: switch field | Esc: cancel"
+                    : "Tab/Shift+Tab: switch field | Esc: cancel",
             ];
-            footerHint = ` Form: Up/Down move | Enter ${isLastField ? "submit" : "next"} | Tab switch | Esc cancel `;
+            footerHint = previewScrollable
+                ? ` Form: Up/Down move | PageUp/PageDown preview | Enter ${isLastField ? "submit" : "next"} | Tab switch | Esc cancel `
+                : ` Form: Up/Down move | Enter ${isLastField ? "submit" : "next"} | Tab switch | Esc cancel `;
+        }
+        if (field.type !== "single-select" && field.type !== "multi-select") {
+            lines.push(...helperLines);
         }
-        lines.push(...helperLines);
         this.formModal.setContent(lines.join("\n"));
         this.formModal.setScroll(0);
         this.formModal.show();
@@ -1018,14 +998,17 @@ export class InteractiveUi {
             const current = String(this.activeFormSession.values[nextField.id] ?? "");
             this.activeFormSession.currentTextCursorIndex = current.length;
             this.activeFormSession.currentOptionIndex = 0;
+            this.activeFormSession.previewScrollOffset = 0;
         }
         else if (nextField?.type === "single-select" || nextField?.type === "multi-select") {
             this.activeFormSession.currentTextCursorIndex = 0;
             this.activeFormSession.currentOptionIndex = this.selectedOptionIndexForField(nextField);
+            this.activeFormSession.previewScrollOffset = 0;
         }
         else {
             this.activeFormSession.currentTextCursorIndex = 0;
             this.activeFormSession.currentOptionIndex = 0;
+            this.activeFormSession.previewScrollOffset = 0;
         }
         this.renderActiveForm();
     }
@@ -1145,17 +1128,39 @@ export class InteractiveUi {
         this.positionFormHint(this.formBooleanInput.top + this.formBooleanInput.height);
     }
     ensureFormSelectInputVisible(headerLineCount, footerLineCount) {
-        const reservedTop = Math.max(1, headerLineCount + 2);
+        const previewVisible = this.formPreviewBox.visible;
+        const reservedTop = previewVisible
+            ? Number(this.formPreviewBox.top ?? 1) + Number(this.formPreviewBox.height ?? 6) + 1
+            : Math.max(1, headerLineCount + 2);
         const availableHeight = Math.max(6, this.formModalInnerHeight() - reservedTop - footerLineCount - 2);
         this.formSelectInput.top = reservedTop;
         this.formSelectInput.left = 1;
         this.formSelectInput.width = Math.max(24, this.formModalInnerWidth() - 4);
-        this.formSelectInput.height = Math.max(4, availableHeight - 2);
+        this.formSelectInput.height = previewVisible
+            ? Math.max(5, availableHeight - 1)
+            : Math.max(4, availableHeight - 2);
         this.formSelectInput.show();
         this.formSelectInput.setFront();
         this.formSelectInput.focus();
         this.positionFormHint(this.formSelectInput.top + this.formSelectInput.height);
     }
+    ensureFormPreviewBoxVisible(headerLineCount, footerLineCount) {
+        const reservedTop = Math.max(1, headerLineCount + 2);
+        const hintHeight = 2;
+        const selectHeight = Math.max(5, Math.min(10, Math.floor(this.formModalInnerHeight() * 0.32)));
+        const availableHeight = Math.max(6, this.formModalInnerHeight() - reservedTop - footerLineCount - selectHeight - hintHeight - 3);
+        this.formPreviewBox.top = reservedTop;
+        this.formPreviewBox.left = 1;
+        this.formPreviewBox.width = Math.max(24, this.formModalInnerWidth() - 4);
+        this.formPreviewBox.height = Math.max(6, Math.min(12, availableHeight));
+    }
+    formPreviewViewportHeight(headerLineCount, footerLineCount) {
+        const reservedTop = Math.max(1, headerLineCount + 2);
+        const hintHeight = 2;
+        const selectHeight = Math.max(5, Math.min(10, Math.floor(this.formModalInnerHeight() * 0.32)));
+        const availableHeight = Math.max(4, this.formModalInnerHeight() - reservedTop - footerLineCount - selectHeight - hintHeight - 1);
+        return Math.max(4, Math.min(10, availableHeight));
+    }
     positionFormHint(top) {
         this.formHint.top = top;
         this.formHint.left = 1;
@@ -1179,6 +1184,12 @@ export class InteractiveUi {
             this.formTextInput.blur();
         }
     }
+    hideFormPreviewBox() {
+        this.formPreviewBox.hide();
+        if (typeof this.formPreviewBox.blur === "function") {
+            this.formPreviewBox.blur();
+        }
+    }
     hideFormBooleanInput() {
         this.formBooleanInput.hide();
         if (typeof this.formBooleanInput.blur === "function") {
@@ -1269,10 +1280,12 @@ export class InteractiveUi {
             };
             this.activeFormSession = null;
             this.formModal.hide();
+            this.hideFormPreviewBox();
             this.hideFormLineInput();
             this.hideFormTextInput();
             this.hideFormBooleanInput();
             this.hideFormSelectInput();
+            this.hideFormHint();
             this.focusPane("flows");
             session.resolve(result);
             this.renderActiveForm();
@@ -1289,10 +1302,12 @@ export class InteractiveUi {
         const session = this.activeFormSession;
         this.activeFormSession = null;
         this.formModal.hide();
+        this.hideFormPreviewBox();
         this.hideFormLineInput();
         this.hideFormTextInput();
         this.hideFormBooleanInput();
         this.hideFormSelectInput();
+        this.hideFormHint();
         this.focusPane("flows");
         session.reject(new TaskRunnerError(`User cancelled form '${session.form.formId}'.`));
         this.renderActiveForm();
@@ -1304,10 +1319,12 @@ export class InteractiveUi {
         const session = this.activeFormSession;
         this.activeFormSession = null;
         this.formModal.hide();
+        this.hideFormPreviewBox();
         this.hideFormLineInput();
         this.hideFormTextInput();
         this.hideFormBooleanInput();
         this.hideFormSelectInput();
+        this.hideFormHint();
         this.focusPane("flows");
         session.reject(new FlowInterruptedError(message));
         this.renderActiveForm();
@@ -1503,6 +1520,32 @@ export class InteractiveUi {
             this.requestRender();
             return;
         }
+        if (key.name === "pageup" || key.name === "pagedown") {
+            const session = this.activeFormSession;
+            const previewContent = session?.form.preview?.trim() ?? "";
+            if (session && previewContent.length > 0) {
+                const previewLines = previewContent.split("\n");
+                const headerLines = [`{bold}${session.form.title}{/bold}`];
+                if (session.form.description?.trim()) {
+                    headerLines.push("");
+                    headerLines.push(session.form.description.trim());
+                }
+                headerLines.push("");
+                headerLines.push(`Field ${session.currentFieldIndex + 1}/${session.form.fields.length}`);
+                headerLines.push(`{yellow-fg}${field.label}{/yellow-fg}`);
+                if (field.help?.trim()) {
+                    headerLines.push(field.help.trim());
+                }
+                headerLines.push("");
+                headerLines.push("{cyan-fg}Review the content above, then choose an action below.{/cyan-fg}");
+                const viewportHeight = this.formPreviewViewportHeight(this.renderedFormLineCount(headerLines), 0);
+                if (previewLines.length > viewportHeight) {
+                    session.previewScrollOffset = Math.max(0, Math.min(previewLines.length - viewportHeight, session.previewScrollOffset + (key.name === "pageup" ? -viewportHeight : viewportHeight)));
+                    this.renderActiveForm();
+                    return;
+                }
+            }
+        }
         if (key.name === "space") {
             this.syncActiveSelectFieldValue();
             this.toggleActiveFormValue();
@@ -1587,70 +1630,22 @@ export class InteractiveUi {
             : this.currentFlowId === flow.id
                 ? this.flowState.executionState
                 : null;
+        const progressViewModel = buildProgressViewModel(flow, flowState);
         const lines = [`{bold}${flow.label}{/bold}`, ""];
-        let anchorLine = null;
-        let sawExecutedItem = false;
-        const rememberAnchor = (status) => {
-            if (status === "running") {
-                anchorLine = lines.length;
-                sawExecutedItem = true;
-                return;
-            }
-            if (status === "done" || status === "skipped") {
-                sawExecutedItem = true;
-                return;
-            }
-            if (status === "pending" && sawExecutedItem && anchorLine === null) {
-                anchorLine = lines.length;
-            }
-        };
-        for (const item of this.visiblePhaseItems(flow, flowState)) {
-            if (item.kind === "group") {
-                const visiblePhases = item.phases.filter((phase) => this.shouldDisplayPhase(flow, flowState, phase));
-                if (visiblePhases.length === 0) {
-                    continue;
-                }
-                const groupStatus = this.statusForGroup(flow, visiblePhases, flowState);
-                rememberAnchor(groupStatus);
-                lines.push(`${this.symbolForGroup(flow.id, flow, visiblePhases, flowState)} ${this.colorizeProgressLabel(item.label, groupStatus)}`);
-                for (const phase of visiblePhases) {
-                    const phaseState = flowState?.phases.find((candidate) => candidate.id === phase.id);
-                    const phaseStatus = this.displayStatusForPhase(flowState, flow, phase, phaseState?.status ?? null);
-                    rememberAnchor(phaseStatus);
-                    lines.push(`  ${this.symbolForStatus(flow.id, phaseStatus)} ${this.colorizeProgressLabel(this.displayPhaseId(phase), phaseStatus)}`);
-                    for (const step of phase.steps) {
-                        const stepState = phaseState?.steps.find((candidate) => candidate.id === step.id);
-                        const stepStatus = this.displayStatusForStep(flowState, flow, phase, stepState?.status ?? null);
-                        rememberAnchor(stepStatus);
-                        lines.push(`    ${this.symbolForStatus(flow.id, stepStatus)} ${this.colorizeProgressLabel(step.id, stepStatus)}`);
-                    }
-                }
-                lines.push("");
-                continue;
-            }
-            const phase = item.phase;
-            if (!this.shouldDisplayPhase(flow, flowState, phase)) {
+        for (const item of progressViewModel.items) {
+            if (item.kind === "termination") {
+                const symbol = item.status === "done" ? "{green-fg}✓{/green-fg}" : "{yellow-fg}■{/yellow-fg}";
+                lines.push(`${symbol} ${this.colorizeProgressLabel(item.label, item.status)}`);
+                lines.push(`{gray-fg}${item.detail}{/gray-fg}`);
                 continue;
             }
-            const phaseState = flowState?.phases.find((candidate) => candidate.id === phase.id);
-            const phaseStatus = this.displayStatusForPhase(flowState, flow, phase, phaseState?.status ?? null);
-            rememberAnchor(phaseStatus);
-            lines.push(`${this.symbolForStatus(flow.id, phaseStatus)} ${this.colorizeProgressLabel(this.displayPhaseId(phase), phaseStatus)}`);
-            for (const step of phase.steps) {
-                const stepState = phaseState?.steps.find((candidate) => candidate.id === step.id);
-                const stepStatus = this.displayStatusForStep(flowState, flow, phase, stepState?.status ?? null);
-                rememberAnchor(stepStatus);
-                lines.push(`  ${this.symbolForStatus(flow.id, stepStatus)} ${this.colorizeProgressLabel(step.id, stepStatus)}`);
-            }
-            lines.push("");
-        }
-        if (flowState?.terminated) {
-            lines.push(`{green-fg}✓{/green-fg} {green-fg}Flow completed successfully{/green-fg}`);
-            lines.push(`{gray-fg}Reason: ${flowState.terminationReason ?? "flow terminated"}{/gray-fg}`);
+            const indent = "  ".repeat(item.depth);
+            lines.push(`${indent}${this.symbolForStatus(flow.id, item.status)} ${this.colorizeProgressLabel(item.label, item.status)}`);
         }
         this.progress.setContent(lines.join("\n").trimEnd());
-        if (this.busy && this.activeFlowId() === flow.id && anchorLine !== null) {
+        if (this.busy && this.activeFlowId() === flow.id && progressViewModel.anchorIndex !== null) {
             const viewportHeight = Math.max(1, Number(this.progress.height) - 2);
+            const anchorLine = progressViewModel.anchorIndex + 2;
             const targetScroll = Math.max(0, anchorLine - Math.floor(viewportHeight / 2));
             this.progress.setScroll(targetScroll);
         }
@@ -1969,6 +1964,7 @@ export class InteractiveUi {
                 currentFieldIndex: 0,
                 currentOptionIndex: initialOptionIndex,
                 currentTextCursorIndex: initialCursorIndex,
+                previewScrollOffset: 0,
                 resolve,
                 reject,
             };
@@ -2083,44 +2079,13 @@ export class InteractiveUi {
         this.requestRender();
     }
     computeVisibleFlowItems() {
-        const items = [];
-        const walk = (nodes, depth) => {
-            for (const node of nodes) {
-                if (node.kind === "folder") {
-                    items.push({
-                        kind: "folder",
-                        key: node.key,
-                        name: node.name,
-                        depth,
-                        pathSegments: [...node.pathSegments],
-                    });
-                    if (this.expandedFlowFolders.has(node.key)) {
-                        walk(node.children, depth + 1);
-                    }
-                    continue;
-                }
-                items.push({
-                    kind: "flow",
-                    key: node.key,
-                    name: node.name,
-                    depth,
-                    pathSegments: [...node.pathSegments],
-                    flow: node.flow,
-                });
-            }
-        };
-        walk(this.flowTree, 0);
-        return items;
+        return computeVisibleFlowItems(this.flowTree, this.expandedFlowFolders);
     }
     selectedFlowTreeItem() {
         return this.visibleFlowItems.find((item) => item.key === this.selectedFlowItemKey);
     }
     selectedHeaderLabel() {
-        const selectedItem = this.selectedFlowTreeItem();
-        if (!selectedItem) {
-            return this.selectedFlowId;
-        }
-        return selectedItem.kind === "folder" ? selectedItem.pathSegments.join("/") : selectedItem.flow.label;
+        return selectHeaderLabel(this.selectedFlowTreeItem(), this.selectedFlowId);
     }
     refreshVisibleFlowItems() {
         this.visibleFlowItems = this.computeVisibleFlowItems();

package/dist/pipeline/context.js

@@ -17,5 +17,6 @@ export function createPipelineContext(input) {
         nodes: createNodeRegistry(),
         ...(input.setSummary ? { setSummary: input.setSummary } : {}),
         ...(input.requestUserInput ? { requestUserInput: input.requestUserInput } : {}),
+        ...(input.executionRouting ? { executionRouting: input.executionRouting } : {}),
     };
 }