maka-agent 0.2.0-dev.3.20260830 → 0.2.0-dev.30.20260912

package/dist/pi-transcript.js

@@ -17,14 +17,16 @@
  * under the License.
  */
 import { Markdown, visibleWidth } from '@earendil-works/pi-tui';
-import { deriveTurnRecords, STEP_LIMIT_NOTICE_TEXT, } from '@maka/core/session';
+import { deriveTurnRecords, isRuntimeSystemNoteKind, STEP_LIMIT_NOTICE_TEXT, } from '@maka/core/session';
 import { providerRetryDisplaySeconds } from '@maka/core/provider-retry-countdown';
+import { defineUiMessageCatalog, resolveUiMessageCatalog, } from '@maka/core/ui-locale';
+import { TUI_COPY_RESOURCES } from './tui-copy-catalog.js';
 import { isActiveShellRunStatus } from '@maka/core/shell-run';
 import { mergeShellRunStateWithDiagnostics } from '@maka/core/shell-run-result';
 import { projectToolActivityArgs } from '@maka/core/tool-activity-args';
 import { toolResultActivityStatus, unfinishedToolActivityStatus, } from '@maka/core/tool-result-status';
 import { homedir } from 'node:os';
-import { basename } from 'node:path';
+import { basename, isAbsolute, relative, sep } from 'node:path';
 import { BoundedChunkBuffer } from './bounded-chunk-buffer.js';
 import { ansi } from './tui-ansi.js';
 import { collapseToSingleLine, fitLine, formatTokenCount, limitText, markdownTheme, renderIndented, } from './pi-transcript-format.js';
@@ -612,6 +614,9 @@ export function applyMakaSessionEventToTranscript(state, event) {
         case 'user_question_request':
             enqueuePendingInteraction(state, event);
             break;
+        case 'form_request':
+            enqueuePendingInteraction(state, event);
+            break;
         case 'sandbox_boundary_decision_ack':
             {
                 const request = findPendingInteraction(state, event.requestId);
@@ -628,6 +633,9 @@ export function applyMakaSessionEventToTranscript(state, event) {
         case 'user_question_answer_ack':
             completePendingInteraction(state, event.requestId);
             break;
+        case 'form_answer_ack':
+            completePendingInteraction(state, event.requestId);
+            break;
         case 'plan_submitted':
             state.entries.push({
                 kind: 'notice',
@@ -923,24 +931,56 @@ function tokenDelta(before, after) {
     return Math.max(0, before - after);
 }
 function systemNoteText(message) {
+    // Retired kinds are still decoded off legacy transcript rows, and none of
+    // them ever had a line here worth reading.
+    if (!isRuntimeSystemNoteKind(message.kind))
+        return undefined;
     switch (message.kind) {
-        case 'session_start':
-        case 'session_resume':
-            return undefined;
-        case 'mode_change':
-            return 'Permission mode changed.';
-        case 'model_change':
-            return 'Model changed.';
         case 'context_compacted':
             return 'Context compacted to keep this task within the model window.';
         case 'context_compaction_failed_open':
             return 'Context summary failed; the session continued without a new summary.';
+        case 'context_provider_dropping': {
+            const data = message.data;
+            const used = typeof data?.inputTokens === 'number' ? data.inputTokens : undefined;
+            const prior = typeof data?.priorInputTokens === 'number' ? data.priorInputTokens : undefined;
+            if (used === undefined || prior === undefined) {
+                return 'The provider is dropping or rewriting context: content was appended but its reported usage did not grow. Declare a context window for this model so Maka compacts first.';
+            }
+            return `The provider is dropping or rewriting context: content was appended, and it counted ${used} input tokens against ${prior} before, which is no growth. Declare a context window for this model so Maka compacts first.`;
+        }
+        case 'context_overflow_after_compaction':
+            return 'History was compacted and the provider still called this request too large. What remains also carries the system prompt, the tool schemas, the summary and the recent tail; shortening this message is the part you control.';
+        case 'context_reported_window_exceeded': {
+            const data = message.data;
+            const used = typeof data?.usedTokens === 'number' ? data.usedTokens : undefined;
+            const reported = typeof data?.reportedContextWindow === 'number' ? data.reportedContextWindow : undefined;
+            if (used === undefined || reported === undefined) {
+                return 'This exchange ran past the context window this model reports, and the provider accepted it anyway.';
+            }
+            return `This exchange used about ${used} tokens, past the ${reported} this model reports, and the provider accepted it without complaint. Nothing is declared, so Maka does not compact on its own; declare a context window to have it compact first.`;
+        }
+        case 'context_window_overrun': {
+            const data = message.data;
+            const used = typeof data?.usedTokens === 'number' ? data.usedTokens : undefined;
+            const declared = typeof data?.declaredContextWindow === 'number' ? data.declaredContextWindow : undefined;
+            if (used === undefined || declared === undefined) {
+                return 'This exchange ran past the context window declared for this model.';
+            }
+            return `This exchange used about ${used} tokens against the declared window of ${declared}: the reply needed more room than was left. Maka compacts before the next request; raise the window if the replies should stay whole.`;
+        }
+        case 'context_window_suggestion': {
+            const data = message.data;
+            const tokens = typeof data?.suggestedContextWindow === 'number' ? data.suggestedContextWindow : undefined;
+            const declared = typeof data?.declaredContextWindow === 'number' ? data.declaredContextWindow : undefined;
+            if (tokens === undefined)
+                return 'The provider rejected this request as too large.';
+            return declared === undefined
+                ? `The provider rejected this request. No context window is declared for this model; the last accepted request was about ${tokens} tokens — declare that as the window so Maka compacts first.`
+                : `The provider rejected this request at about ${tokens} tokens, below the declared window of ${declared}. The declaration is likely larger than the provider's window; consider lowering it to ${tokens}.`;
+        }
         case 'step_limit':
             return STEP_LIMIT_NOTICE_TEXT;
-        case 'error':
-            return 'Session recorded an error.';
-        case 'abort':
-            return 'Session was stopped.';
     }
 }
 export function renderMakaPiTranscript(state, metadata, width) {
@@ -1013,6 +1053,9 @@ export function activeUserQuestionRequest(state) {
         ? state.pendingInteraction
         : undefined;
 }
+export function activeFormRequest(state) {
+    return state.pendingInteraction?.type === 'form_request' ? state.pendingInteraction : undefined;
+}
 function enqueuePendingInteraction(state, request) {
     if (findPendingInteraction(state, request.requestId))
         return;
@@ -1380,28 +1423,23 @@ function formatElapsedDuration(elapsedMs) {
         parts.push(`${remainingSeconds}s`);
     return parts.join(' ');
 }
-/**
- * Pending-queue bar shown above the editor while messages are queued. Each
- * steering message reads `Steering: <text>` (injected into the running turn at
- * the next step boundary); each followup reads `Queued: <text>` (opens the next
- * turn). A trailing hint reminds the user that alt+↑ takes them back to edit.
- * Renders nothing when both queues are empty.
- */
-export function renderMakaPiPendingQueue(state, width, platform = process.platform) {
+const TUI_PENDING_QUEUE_COPY = resolveUiMessageCatalog(defineUiMessageCatalog()(TUI_COPY_RESOURCES['pending-queue']));
+export function renderMakaPiPendingQueue(state, width, platform, locale) {
     if (state.steering.length === 0 && state.followup.length === 0) {
         return [];
     }
+    const copy = TUI_PENDING_QUEUE_COPY[locale];
     const safeWidth = Math.max(1, width);
     const steering = state.steering;
     const followup = state.followup;
     const lines = [];
     for (const text of steering) {
-        lines.push(fitLine(`${ansi.accent('Steering:')} ${ansi.dim(firstLinePreview(text))}`, safeWidth));
+        lines.push(fitLine(`${ansi.accent(copy.steeringLabel)} ${ansi.dim(firstLinePreview(text))}`, safeWidth));
     }
     for (const text of followup) {
-        lines.push(fitLine(`${ansi.dim('Queued:')} ${ansi.dim(firstLinePreview(text))}`, safeWidth));
+        lines.push(fitLine(`${ansi.dim(copy.queuedLabel)} ${ansi.dim(firstLinePreview(text))}`, safeWidth));
     }
-    lines.push(fitLine(ansi.dim(renderTuiShortcutCopy('Alt+↑ 取回队列以重新编辑', platform)), safeWidth));
+    lines.push(fitLine(ansi.dim(renderTuiShortcutCopy(copy.requeueHint, platform)), safeWidth));
     return lines;
 }
 /**
@@ -1426,14 +1464,21 @@ function firstLinePreview(text) {
  * Shorten an absolute path to a `~`-relative form for the statusline.
  * `/Users/alice/workspace/project` → `~/workspace/project`.
  * Falls back to the original path if it is not under the home directory.
+ * Comparison runs through `path.relative`, so Windows profile paths and
+ * case-only differences shorten as well; the remainder keeps its native
+ * separators (`~/Videos\Clips` on Windows).
  */
-function shortenCwd(cwd, homeDir) {
+export function shortenCwd(cwd, homeDir) {
     const home = homeDir ?? homedir();
-    if (home && cwd.startsWith(home + '/'))
-        return `~${cwd.slice(home.length)}`;
-    if (home && cwd === home)
+    if (!home)
+        return cwd;
+    const rel = relative(home, cwd);
+    if (rel === '')
         return '~';
-    return cwd;
+    if (isAbsolute(rel) || rel === '..' || rel.startsWith(`..${sep}`)) {
+        return cwd;
+    }
+    return `~/${rel}`;
 }
 function formatCost(costUsd) {
     if (costUsd < 0.01)

package/dist/pi-tui-form-interaction.js

@@ -0,0 +1,497 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { Editor, Key, isKeyRepeat, matchesKey, truncateToWidth, visibleWidth, } from '@earendil-works/pi-tui';
+import { isInteractionFormFieldValueValid, } from '@maka/core/interaction';
+import { sanitizeUnicodeText } from '@maka/core/text-sanitize';
+import { defineUiMessageCatalog, formatUiMessage, resolveUiMessageCatalog, } from '@maka/core/ui-locale';
+import { ansi, editorTheme, stripAnsi } from './tui-ansi.js';
+import { TUI_COPY_RESOURCES } from './tui-copy-catalog.js';
+const FORM_COPY = resolveUiMessageCatalog(defineUiMessageCatalog()(TUI_COPY_RESOURCES['form-interaction']));
+const FORM_REVIEW_MAX_VISIBLE_FIELDS = 8;
+const FORM_CHOICE_MAX_VISIBLE_OPTIONS = 10;
+export function createTuiFormDrafts(fields) {
+    return fields.map((field) => {
+        const included = field.required || field.default !== undefined;
+        if (field.kind === 'boolean')
+            return { included, value: field.default ?? false };
+        if (field.kind === 'multi_select')
+            return { included, value: [...(field.default ?? [])] };
+        if (field.kind === 'number' || field.kind === 'integer') {
+            return { included, value: field.default === undefined ? '' : String(field.default) };
+        }
+        return { included, value: field.default ?? '' };
+    });
+}
+export function buildTuiFormResponse(request, drafts) {
+    if (drafts.length !== request.fields.length)
+        return null;
+    const entries = [];
+    for (const [index, field] of request.fields.entries()) {
+        const draft = drafts[index];
+        if (!draft)
+            return null;
+        if (!draft.included) {
+            if (field.required)
+                return null;
+            continue;
+        }
+        const value = draftValue(field, draft);
+        if (!isInteractionFormFieldValueValid(field, value))
+            return null;
+        entries.push([field.name, value]);
+    }
+    return {
+        requestId: request.requestId,
+        action: 'accept',
+        values: Object.fromEntries(entries),
+    };
+}
+export class FormInteractionOverlay {
+    input;
+    #copy;
+    #editor;
+    #drafts;
+    #activeIndex = 0;
+    #mode = { kind: 'review' };
+    #invalid = new Set();
+    #submitting = false;
+    constructor(tui, input) {
+        this.input = input;
+        this.#copy = FORM_COPY[input.locale];
+        this.#drafts =
+            input.initialDrafts?.length === input.request.fields.length
+                ? cloneTuiFormDrafts(input.initialDrafts)
+                : createTuiFormDrafts(input.request.fields);
+        this.#editor = new Editor(tui, editorTheme(), { paddingX: 0 });
+        this.#editor.onChange = (value) => {
+            if (this.#mode.kind !== 'text')
+                return;
+            this.#replaceDraft(this.#mode.index, { value });
+        };
+    }
+    invalidate() {
+        this.#editor.invalidate();
+    }
+    setSubmissionFailed() {
+        this.#submitting = false;
+    }
+    snapshotDrafts() {
+        return cloneTuiFormDrafts(this.#drafts);
+    }
+    handleInput(data) {
+        if (this.#submitting)
+            return;
+        if (this.#mode.kind === 'review') {
+            this.#handleReviewInput(data);
+        }
+        else if (this.#mode.kind === 'text') {
+            if (matchesKey(data, Key.escape)) {
+                this.#mode = { kind: 'review' };
+            }
+            else if ((matchesKey(data, Key.enter) || matchesKey(data, Key.return)) &&
+                !isKeyRepeat(data)) {
+                this.#replaceDraft(this.#mode.index, { value: this.#editor.getText() });
+                this.#mode = { kind: 'review' };
+            }
+            else {
+                this.#editor.handleInput(data);
+            }
+        }
+        else if (this.#mode.kind === 'choice') {
+            this.#handleChoiceInput(data, this.#mode);
+        }
+        else {
+            this.#handleMultiInput(data, this.#mode);
+        }
+    }
+    render(width) {
+        const safeWidth = Math.max(1, width);
+        const lines = this.#renderHeader(safeWidth);
+        if (this.#mode.kind === 'review')
+            lines.push(...this.#renderReview(safeWidth));
+        else if (this.#mode.kind === 'text')
+            lines.push(...this.#renderTextEditor(this.#mode.index, safeWidth));
+        else if (this.#mode.kind === 'choice')
+            lines.push(...this.#renderChoice(this.#mode, safeWidth));
+        else
+            lines.push(...this.#renderMulti(this.#mode, safeWidth));
+        lines.push(padLine(ansi.accent('-'.repeat(safeWidth)), safeWidth));
+        return lines;
+    }
+    #handleReviewInput(data) {
+        const fields = this.input.request.fields;
+        if (matchesKey(data, Key.escape)) {
+            this.#respond({ requestId: this.input.request.requestId, action: 'cancel' });
+            return;
+        }
+        if (data === 'd' || data === 'D') {
+            this.#respond({ requestId: this.input.request.requestId, action: 'decline' });
+            return;
+        }
+        if (data === 's' || data === 'S') {
+            this.#submit();
+            return;
+        }
+        if (fields.length === 0)
+            return;
+        if (matchesKey(data, Key.up)) {
+            this.#activeIndex = this.#activeIndex === 0 ? fields.length - 1 : this.#activeIndex - 1;
+            return;
+        }
+        if (matchesKey(data, Key.down)) {
+            this.#activeIndex = this.#activeIndex === fields.length - 1 ? 0 : this.#activeIndex + 1;
+            return;
+        }
+        const field = fields[this.#activeIndex];
+        const draft = this.#drafts[this.#activeIndex];
+        if (!field || !draft)
+            return;
+        if (matchesKey(data, Key.space) && !field.required) {
+            this.#replaceDraft(this.#activeIndex, { included: !draft.included });
+            return;
+        }
+        if ((matchesKey(data, Key.enter) || matchesKey(data, Key.return)) && !isKeyRepeat(data)) {
+            if (!draft.included)
+                this.#replaceDraft(this.#activeIndex, { included: true });
+            this.#openEditor(field, this.#activeIndex);
+        }
+    }
+    #handleChoiceInput(data, mode) {
+        if (matchesKey(data, Key.escape)) {
+            this.#mode = { kind: 'review' };
+            return;
+        }
+        const field = this.input.request.fields[mode.index];
+        if (!field || (field.kind !== 'boolean' && field.kind !== 'single_select'))
+            return;
+        const count = field.kind === 'boolean' ? 2 : field.options.length;
+        if (count === 0)
+            return;
+        if (matchesKey(data, Key.up))
+            mode.optionIndex = mode.optionIndex === 0 ? count - 1 : mode.optionIndex - 1;
+        else if (matchesKey(data, Key.down))
+            mode.optionIndex = mode.optionIndex === count - 1 ? 0 : mode.optionIndex + 1;
+        else if ((matchesKey(data, Key.enter) || matchesKey(data, Key.return)) && !isKeyRepeat(data)) {
+            const value = field.kind === 'boolean' ? mode.optionIndex === 0 : field.options[mode.optionIndex]?.value;
+            if (value !== undefined)
+                this.#replaceDraft(mode.index, { included: true, value });
+            this.#mode = { kind: 'review' };
+        }
+    }
+    #handleMultiInput(data, mode) {
+        if (matchesKey(data, Key.escape) ||
+            matchesKey(data, Key.enter) ||
+            matchesKey(data, Key.return)) {
+            if (!isKeyRepeat(data))
+                this.#mode = { kind: 'review' };
+            return;
+        }
+        const field = this.input.request.fields[mode.index];
+        const draft = this.#drafts[mode.index];
+        if (!field || field.kind !== 'multi_select' || !draft || !Array.isArray(draft.value))
+            return;
+        if (field.options.length === 0)
+            return;
+        if (matchesKey(data, Key.up))
+            mode.optionIndex = mode.optionIndex === 0 ? field.options.length - 1 : mode.optionIndex - 1;
+        else if (matchesKey(data, Key.down))
+            mode.optionIndex = mode.optionIndex === field.options.length - 1 ? 0 : mode.optionIndex + 1;
+        else if (matchesKey(data, Key.space)) {
+            const value = field.options[mode.optionIndex]?.value;
+            if (value === undefined)
+                return;
+            const selected = draft.value.includes(value)
+                ? draft.value.filter((candidate) => candidate !== value)
+                : [...draft.value, value];
+            this.#replaceDraft(mode.index, { included: true, value: selected });
+        }
+    }
+    #openEditor(field, index) {
+        const draft = this.#drafts[index];
+        if (!draft)
+            return;
+        if (field.kind === 'boolean') {
+            this.#mode = { kind: 'choice', index, optionIndex: draft.value === true ? 0 : 1 };
+        }
+        else if (field.kind === 'single_select') {
+            this.#mode = {
+                kind: 'choice',
+                index,
+                optionIndex: Math.max(0, field.options.findIndex((option) => option.value === draft.value)),
+            };
+        }
+        else if (field.kind === 'multi_select') {
+            this.#mode = { kind: 'multi', index, optionIndex: 0 };
+        }
+        else {
+            this.#editor.setText(typeof draft.value === 'string' ? draft.value : '');
+            this.#mode = { kind: 'text', index };
+        }
+    }
+    #submit() {
+        const response = buildTuiFormResponse(this.input.request, this.#drafts);
+        if (response) {
+            this.#respond(response);
+            return;
+        }
+        this.#invalid = new Set(this.input.request.fields.flatMap((field, index) => {
+            const draft = this.#drafts[index];
+            if (!draft || (!draft.included && field.required))
+                return [index];
+            if (!draft.included)
+                return [];
+            return isInteractionFormFieldValueValid(field, draftValue(field, draft)) ? [] : [index];
+        }));
+        const first = this.#invalid.values().next().value;
+        if (typeof first === 'number')
+            this.#activeIndex = first;
+    }
+    #respond(response) {
+        this.#submitting = true;
+        this.input.onRespond(response);
+    }
+    #replaceDraft(index, patch) {
+        const current = this.#drafts[index];
+        if (!current)
+            return;
+        this.#drafts = this.#drafts.map((draft, candidate) => candidate === index ? { ...current, ...patch } : draft);
+        this.#invalid.delete(index);
+    }
+    #renderHeader(width) {
+        const requester = this.input.request.requester;
+        const detail = requester.source
+            ? `${safeDisplay(requester.name)} · ${safeDisplay(requester.source)}`
+            : safeDisplay(requester.name);
+        const provenance = formatUiMessage(this.#copy.requestedBy, { detail }, this.input.locale);
+        return [
+            padLine(ansi.bold(safeDisplay(this.input.request.message)), width),
+            padLine(ansi.dim(provenance), width),
+            padLine(ansi.red(this.#copy.sensitiveWarning), width),
+            padLine('', width),
+        ];
+    }
+    #renderReview(width) {
+        const lines = [];
+        const window = visibleWindow(this.input.request.fields.length, this.#activeIndex, FORM_REVIEW_MAX_VISIBLE_FIELDS);
+        if (window.start > 0)
+            lines.push(padLine(ansi.dim(`  … ↑ ${window.start}`), width));
+        this.input.request.fields.slice(window.start, window.end).forEach((field, offset) => {
+            const index = window.start + offset;
+            const draft = this.#drafts[index];
+            if (!draft)
+                return;
+            const requirement = field.required ? this.#copy.required : this.#copy.optional;
+            const prefix = index === this.#activeIndex ? '→ ' : '  ';
+            const summary = this.#summary(field, draft);
+            const invalid = this.#invalid.has(index);
+            const row = `${prefix}${safeDisplay(field.label)} (${requirement}): ${summary}${invalid ? ` · ${this.#copy.invalid}` : ''}`;
+            lines.push(formatReviewRow(invalid ? ansi.red(row) : row, index === this.#activeIndex, width));
+            if (index === this.#activeIndex && field.description) {
+                lines.push(padLine(`  ${ansi.dim(safeDisplay(field.description))}`, width));
+            }
+            if (index === this.#activeIndex) {
+                const constraint = this.#constraint(field);
+                if (constraint)
+                    lines.push(padLine(`  ${ansi.dim(constraint)}`, width));
+            }
+        });
+        if (window.end < this.input.request.fields.length) {
+            lines.push(padLine(ansi.dim(`  … ↓ ${this.input.request.fields.length - window.end}`), width));
+        }
+        if (this.input.request.fields.length === 0)
+            lines.push(padLine(ansi.dim('(no fields)'), width));
+        lines.push(padLine('', width));
+        lines.push(padLine(ansi.dim(this.#copy.reviewHint), width));
+        return lines;
+    }
+    #renderTextEditor(index, width) {
+        const field = this.input.request.fields[index];
+        if (!field)
+            return [];
+        this.#editor.focused = true;
+        return [
+            padLine(`${safeDisplay(field.label)} (${field.required ? this.#copy.required : this.#copy.optional})`, width),
+            ...this.#fieldDetails(field, width),
+            ...this.#editor.render(width),
+            padLine(ansi.dim(this.#copy.textHint), width),
+        ];
+    }
+    #renderChoice(mode, width) {
+        const field = this.input.request.fields[mode.index];
+        if (!field || (field.kind !== 'boolean' && field.kind !== 'single_select'))
+            return [];
+        const options = field.kind === 'boolean'
+            ? [this.#copy.trueValue, this.#copy.falseValue]
+            : field.options.map((option) => safeDisplay(option.label));
+        const window = visibleWindow(options.length, mode.optionIndex, FORM_CHOICE_MAX_VISIBLE_OPTIONS);
+        return [
+            padLine(safeDisplay(field.label), width),
+            ...this.#fieldDetails(field, width),
+            ...(window.start > 0 ? [padLine(ansi.dim(`  … ↑ ${window.start}`), width)] : []),
+            ...options.slice(window.start, window.end).map((label, offset) => {
+                const index = window.start + offset;
+                return formatReviewRow(`${index === mode.optionIndex ? '→ ' : '  '}${label}`, index === mode.optionIndex, width);
+            }),
+            ...(window.end < options.length
+                ? [padLine(ansi.dim(`  … ↓ ${options.length - window.end}`), width)]
+                : []),
+            padLine(ansi.dim(this.#copy.choiceHint), width),
+        ];
+    }
+    #renderMulti(mode, width) {
+        const field = this.input.request.fields[mode.index];
+        const draft = this.#drafts[mode.index];
+        if (!field || field.kind !== 'multi_select' || !draft || !Array.isArray(draft.value))
+            return [];
+        const selected = draft.value;
+        const window = visibleWindow(field.options.length, mode.optionIndex, FORM_CHOICE_MAX_VISIBLE_OPTIONS);
+        return [
+            padLine(safeDisplay(field.label), width),
+            ...this.#fieldDetails(field, width),
+            ...(window.start > 0 ? [padLine(ansi.dim(`  … ↑ ${window.start}`), width)] : []),
+            ...field.options.slice(window.start, window.end).map((option, offset) => {
+                const index = window.start + offset;
+                const row = `${index === mode.optionIndex ? '→ ' : '  '}[${selected.includes(option.value) ? 'x' : ' '}] ${safeDisplay(option.label)}`;
+                return formatReviewRow(row, index === mode.optionIndex, width);
+            }),
+            ...(window.end < field.options.length
+                ? [padLine(ansi.dim(`  … ↓ ${field.options.length - window.end}`), width)]
+                : []),
+            padLine(ansi.dim(this.#copy.multiHint), width),
+        ];
+    }
+    #summary(field, draft) {
+        if (!draft.included)
+            return ansi.dim(this.#copy.omitted);
+        if (field.kind === 'boolean')
+            return draft.value === true ? this.#copy.trueValue : this.#copy.falseValue;
+        if (field.kind === 'single_select') {
+            const option = field.options.find((candidate) => candidate.value === draft.value);
+            return option ? safeDisplay(option.label) : ansi.dim(this.#copy.empty);
+        }
+        if (field.kind === 'multi_select' && Array.isArray(draft.value)) {
+            return formatUiMessage(this.#copy.selectedCount, { count: draft.value.length }, this.input.locale);
+        }
+        return typeof draft.value === 'string' && draft.value.length > 0
+            ? safeDisplay(draft.value)
+            : ansi.dim(this.#copy.empty);
+    }
+    #fieldDetails(field, width) {
+        const details = field.description ? [safeDisplay(field.description)] : [];
+        const constraint = this.#constraint(field);
+        if (constraint)
+            details.push(constraint);
+        return details.map((detail) => padLine(ansi.dim(detail), width));
+    }
+    #constraint(field) {
+        const constraints = [];
+        if (field.kind === 'string') {
+            if (field.minLength !== undefined && field.maxLength !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.lengthRange, {
+                    minimum: field.minLength,
+                    maximum: field.maxLength,
+                }, this.input.locale));
+            }
+            else if (field.minLength !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.minimumLength, {
+                    minimum: field.minLength,
+                }, this.input.locale));
+            }
+            else if (field.maxLength !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.maximumLength, {
+                    maximum: field.maxLength,
+                }, this.input.locale));
+            }
+            if (field.format !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.format, {
+                    format: field.format,
+                }, this.input.locale));
+            }
+        }
+        else if (field.kind === 'number' || field.kind === 'integer') {
+            if (field.minimum !== undefined && field.maximum !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.valueRange, {
+                    minimum: field.minimum,
+                    maximum: field.maximum,
+                }, this.input.locale));
+            }
+            else if (field.minimum !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.minimumValue, {
+                    minimum: field.minimum,
+                }, this.input.locale));
+            }
+            else if (field.maximum !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.maximumValue, {
+                    maximum: field.maximum,
+                }, this.input.locale));
+            }
+        }
+        else if (field.kind === 'multi_select') {
+            if (field.minItems !== undefined && field.maxItems !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.itemRange, {
+                    minimum: field.minItems,
+                    maximum: field.maxItems,
+                }, this.input.locale));
+            }
+            else if (field.minItems !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.minimumItems, {
+                    minimum: field.minItems,
+                }, this.input.locale));
+            }
+            else if (field.maxItems !== undefined) {
+                constraints.push(formatUiMessage(this.#copy.maximumItems, {
+                    maximum: field.maxItems,
+                }, this.input.locale));
+            }
+        }
+        return constraints.length === 0 ? undefined : constraints.join(' · ');
+    }
+}
+function cloneTuiFormDrafts(drafts) {
+    return drafts.map((draft) => ({
+        included: draft.included,
+        value: Array.isArray(draft.value) ? [...draft.value] : draft.value,
+    }));
+}
+function draftValue(field, draft) {
+    if (field.kind === 'number' || field.kind === 'integer') {
+        return typeof draft.value === 'string' && draft.value.trim() !== ''
+            ? Number(draft.value)
+            : Number.NaN;
+    }
+    return draft.value;
+}
+function safeDisplay(value) {
+    return sanitizeUnicodeText(stripAnsi(value), { maxCodePoints: 1_024 });
+}
+function formatReviewRow(text, active, width) {
+    const padded = padLine(text, width);
+    return active ? ansi.reverse(padded) : padded;
+}
+function padLine(text, width) {
+    const safeWidth = Math.max(1, width);
+    const trimmed = visibleWidth(text) > safeWidth ? truncateToWidth(text, safeWidth, '') : text;
+    return `${trimmed}${' '.repeat(Math.max(0, safeWidth - visibleWidth(trimmed)))}`;
+}
+function visibleWindow(length, activeIndex, limit) {
+    if (length <= limit)
+        return { start: 0, end: length };
+    const start = Math.min(Math.max(0, activeIndex - Math.floor(limit / 2)), Math.max(0, length - limit));
+    return { start, end: Math.min(length, start + limit) };
+}