@narumitw/pi-plan-mode 0.50.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,23 @@
1
- import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
1
+ import { stripVTControlCharacters } from "node:util";
2
+ import type { ExtensionContext, KeybindingsManager, Theme } from "@earendil-works/pi-coding-agent";
3
+ import {
4
+ type Component,
5
+ Editor,
6
+ type EditorTheme,
7
+ type Focusable,
8
+ Key,
9
+ matchesKey,
10
+ sliceByColumn,
11
+ type TUI,
12
+ truncateToWidth,
13
+ visibleWidth,
14
+ } from "@earendil-works/pi-tui";
2
15
 
3
16
  export const PLAN_MODE_QUESTION_TOOL_NAME = "plan_mode_question";
17
+ export const MAX_PLAN_MODE_RESPONSE_LENGTH = 4_000;
18
+
19
+ const BRACKETED_PASTE_START = "\u001b[200~";
20
+ const BRACKETED_PASTE_END = "\u001b[201~";
4
21
 
5
22
  export type PlanModeQuestionOption = {
6
23
  label: string;
@@ -14,13 +31,14 @@ export type PlanModeQuestion = {
14
31
  options: PlanModeQuestionOption[];
15
32
  };
16
33
 
17
- type PlanModeQuestionAnswer = {
34
+ export type PlanModeQuestionAnswer = {
18
35
  id: string;
19
36
  header: string;
20
37
  question: string;
21
38
  answer: string;
22
39
  wasCustom: boolean;
23
40
  optionIndex?: number;
41
+ note?: string;
24
42
  };
25
43
 
26
44
  type PlanModeQuestionReason =
@@ -186,6 +204,29 @@ export async function askPlanModeQuestions(
186
204
  questions: PlanModeQuestion[],
187
205
  ctx: ExtensionContext,
188
206
  shouldContinue: () => boolean = () => true,
207
+ ): Promise<PlanModeQuestionAnswer[] | undefined> {
208
+ if (ctx.mode === "tui") {
209
+ const answers = await ctx.ui.custom<PlanModeQuestionAnswer[] | undefined>(
210
+ (tui, theme, keybindings, done) =>
211
+ new PlanModeQuestionnaire({
212
+ questions,
213
+ tui,
214
+ theme,
215
+ keybindings,
216
+ shouldContinue,
217
+ signal: ctx.signal,
218
+ onDone: done,
219
+ }),
220
+ );
221
+ return shouldContinue() ? answers : undefined;
222
+ }
223
+ return askPlanModeQuestionsSequentially(questions, ctx, shouldContinue);
224
+ }
225
+
226
+ async function askPlanModeQuestionsSequentially(
227
+ questions: PlanModeQuestion[],
228
+ ctx: ExtensionContext,
229
+ shouldContinue: () => boolean,
189
230
  ): Promise<PlanModeQuestionAnswer[] | undefined> {
190
231
  const answers: PlanModeQuestionAnswer[] = [];
191
232
  for (const question of questions) {
@@ -197,30 +238,597 @@ export async function askPlanModeQuestions(
197
238
  ]);
198
239
  if (!shouldContinue() || !choice) return undefined;
199
240
  if (choice === otherChoice) {
200
- const customAnswer = (await ctx.ui.editor(question.question, ""))?.trim();
201
- if (!shouldContinue() || !customAnswer) return undefined;
202
- answers.push({
203
- id: question.id,
204
- header: question.header,
205
- question: question.question,
206
- answer: customAnswer,
207
- wasCustom: true,
208
- });
241
+ const customAnswer = await askCustomAnswer(question, ctx, shouldContinue);
242
+ if (customAnswer === undefined) return undefined;
243
+ answers.push(answerFor(question, customAnswer, { wasCustom: true }));
209
244
  continue;
210
245
  }
211
246
  const optionIndex = choices.indexOf(choice);
212
247
  const option = question.options[optionIndex];
213
248
  if (!option) return undefined;
214
- answers.push({
215
- id: question.id,
216
- header: question.header,
217
- question: question.question,
218
- answer: option.label,
249
+ answers.push(
250
+ answerFor(question, option.label, { wasCustom: false, optionIndex: optionIndex + 1 }),
251
+ );
252
+ }
253
+ return answers;
254
+ }
255
+
256
+ async function askCustomAnswer(
257
+ question: PlanModeQuestion,
258
+ ctx: ExtensionContext,
259
+ shouldContinue: () => boolean,
260
+ ): Promise<string | undefined> {
261
+ let draft = "";
262
+ for (;;) {
263
+ const customAnswer = await ctx.ui.editor(question.question, draft);
264
+ if (!shouldContinue() || !customAnswer?.trim()) return undefined;
265
+ if (customAnswer.length <= MAX_PLAN_MODE_RESPONSE_LENGTH) return customAnswer;
266
+ draft = customAnswer;
267
+ ctx.ui.notify("Custom answer must be 4,000 characters or fewer.", "warning");
268
+ }
269
+ }
270
+
271
+ interface QuestionnaireOptions {
272
+ questions: PlanModeQuestion[];
273
+ tui: TUI;
274
+ theme: Theme;
275
+ keybindings: KeybindingsManager;
276
+ shouldContinue(): boolean;
277
+ signal?: AbortSignal;
278
+ onDone(answers: PlanModeQuestionAnswer[] | undefined): void;
279
+ }
280
+
281
+ export class PlanModeQuestionnaire implements Component, Focusable {
282
+ private readonly options: QuestionnaireOptions;
283
+ private readonly editor: RawPreservingEditor;
284
+ private readonly answers: Array<PlanModeQuestionAnswer | undefined>;
285
+ private readonly selectedOptions: number[];
286
+ private page = 0;
287
+ private editorKind: "answer" | "note" | undefined;
288
+ private message: string | undefined;
289
+ private finished = false;
290
+ private removeAbort = () => {};
291
+ private _focused = false;
292
+
293
+ constructor(options: QuestionnaireOptions) {
294
+ this.options = options;
295
+ this.answers = options.questions.map(() => undefined);
296
+ this.selectedOptions = options.questions.map(() => 0);
297
+ const editorTheme: EditorTheme = {
298
+ borderColor: (text) => options.theme.fg("accent", text),
299
+ selectList: {
300
+ selectedPrefix: (text) => options.theme.fg("accent", text),
301
+ selectedText: (text) => options.theme.fg("accent", text),
302
+ description: (text) => options.theme.fg("muted", text),
303
+ scrollInfo: (text) => options.theme.fg("dim", text),
304
+ noMatch: (text) => options.theme.fg("warning", text),
305
+ },
306
+ };
307
+ this.editor = new RawPreservingEditor(options.tui, editorTheme);
308
+ this.editor.onChange = () => {
309
+ this.message = undefined;
310
+ };
311
+ this.editor.onSubmit = (text) => this.submitEditor(text);
312
+ if (options.signal) {
313
+ const abort = () => this.finish(undefined);
314
+ options.signal.addEventListener("abort", abort, { once: true });
315
+ this.removeAbort = () => options.signal?.removeEventListener("abort", abort);
316
+ if (options.signal.aborted) abort();
317
+ }
318
+ }
319
+
320
+ get focused(): boolean {
321
+ return this._focused;
322
+ }
323
+
324
+ set focused(value: boolean) {
325
+ this._focused = value;
326
+ this.editor.focused = value && this.editorKind !== undefined;
327
+ }
328
+
329
+ render(width: number): string[] {
330
+ const safeWidth = Math.max(1, width);
331
+ const padding = safeWidth > 1 ? " " : "";
332
+ const contentWidth = Math.max(1, safeWidth - visibleWidth(padding));
333
+ const border = this.options.theme.fg("border", "─".repeat(safeWidth));
334
+ const lines = [border, "", ...this.renderTabs(contentWidth), ""];
335
+ if (this.page === this.options.questions.length) lines.push(...this.renderReview(contentWidth));
336
+ else lines.push(...this.renderQuestion(contentWidth));
337
+ if (this.message)
338
+ lines.push(...hardWrap(this.options.theme.fg("warning", this.message), contentWidth));
339
+ lines.push("");
340
+ lines.push(truncateToWidth(this.renderHints(), contentWidth), "", border);
341
+ return lines.map((line) => {
342
+ if (!line || line === border) return line;
343
+ return `${padding}${truncateToWidth(line, contentWidth)}`;
344
+ });
345
+ }
346
+
347
+ handleInput(data: string): void {
348
+ if (this.finished) return;
349
+ if (!this.options.shouldContinue() || this.isCancel(data)) {
350
+ this.finish(undefined);
351
+ return;
352
+ }
353
+ if (this.editorKind) this.handleEditorInput(data);
354
+ else this.handlePageInput(data);
355
+ this.options.tui.requestRender();
356
+ }
357
+
358
+ invalidate(): void {
359
+ this.editor.invalidate();
360
+ }
361
+
362
+ dispose(): void {
363
+ this.finish(undefined);
364
+ }
365
+
366
+ private isCancel(data: string): boolean {
367
+ return (
368
+ matchesKey(data, Key.ctrl("c")) || this.options.keybindings.matches(data, "tui.select.cancel")
369
+ );
370
+ }
371
+
372
+ private handleEditorInput(data: string): void {
373
+ const keybindings = this.options.keybindings;
374
+ if (keybindings.matches(data, "tui.input.newLine")) {
375
+ this.editor.handleInput(data);
376
+ } else if (keybindings.matches(data, "tui.input.submit")) {
377
+ this.submitEditor(this.editor.getExpandedText());
378
+ } else {
379
+ this.editor.handleInput(data);
380
+ }
381
+ }
382
+
383
+ private handlePageInput(data: string): void {
384
+ const keybindings = this.options.keybindings;
385
+ const review = this.page === this.options.questions.length;
386
+ if (keybindings.matches(data, "tui.select.up") || data === "k") {
387
+ if (!review) this.moveSelection(-1);
388
+ return;
389
+ }
390
+ if (keybindings.matches(data, "tui.select.down") || data === "j") {
391
+ if (!review) this.moveSelection(1);
392
+ return;
393
+ }
394
+ if (keybindings.matches(data, "tui.select.confirm")) {
395
+ this.submitPage();
396
+ return;
397
+ }
398
+ if (keybindings.matches(data, "tui.input.tab") || matchesKey(data, Key.right)) {
399
+ this.movePage(1);
400
+ return;
401
+ }
402
+ if (matchesKey(data, Key.shift("tab")) || matchesKey(data, Key.left)) {
403
+ this.movePage(-1);
404
+ return;
405
+ }
406
+ if (data.toLowerCase() === "n") {
407
+ if (review) this.message = "Return to a question to add or edit its note.";
408
+ else this.editNote();
409
+ }
410
+ }
411
+
412
+ private renderHints(): string {
413
+ const { keybindings, theme } = this.options;
414
+ const cancel = cancelHint(theme, keybindings);
415
+ if (this.editorKind) {
416
+ return [
417
+ keybindingHint(theme, keybindings, "tui.input.submit", "save"),
418
+ keybindingHint(theme, keybindings, "tui.input.newLine", "newline"),
419
+ cancel,
420
+ ].join(" ");
421
+ }
422
+ const questions = rawKeyHint(theme, questionNavigationKeys(keybindings), "questions");
423
+ if (this.page === this.options.questions.length) {
424
+ return [
425
+ keybindingHint(theme, keybindings, "tui.select.confirm", "submit"),
426
+ cancel,
427
+ questions,
428
+ ].join(" ");
429
+ }
430
+ return [
431
+ rawKeyHint(theme, selectionNavigationKeys(keybindings), "navigate"),
432
+ keybindingHint(theme, keybindings, "tui.select.confirm", "select"),
433
+ cancel,
434
+ questions,
435
+ rawKeyHint(theme, "n", "note"),
436
+ ].join(" ");
437
+ }
438
+
439
+ private movePage(delta: number): void {
440
+ const pageCount = this.options.questions.length + 1;
441
+ this.page = (this.page + delta + pageCount) % pageCount;
442
+ const answer = this.answers[this.page];
443
+ const question = this.options.questions[this.page];
444
+ if (answer?.wasCustom && question) {
445
+ this.selectedOptions[this.page] = question.options.length;
446
+ } else if (answer?.optionIndex !== undefined) {
447
+ this.selectedOptions[this.page] = answer.optionIndex - 1;
448
+ }
449
+ this.message = undefined;
450
+ }
451
+
452
+ private renderTabs(width: number): string[] {
453
+ const tabs = [
454
+ ...this.options.questions.map((question, index) => {
455
+ const label = sanitizeTerminalText(question.header) || `Question ${index + 1}`;
456
+ const answered = this.answers[index] ? "✓ " : "";
457
+ return this.page === index ? `[${answered}${label}]` : `${answered}${label}`;
458
+ }),
459
+ this.page === this.options.questions.length ? "[Review]" : "Review",
460
+ ];
461
+ const lines: string[] = [];
462
+ let line = "";
463
+ for (const tab of tabs) {
464
+ const boundedTab = truncateToWidth(tab, width, "…");
465
+ const candidate = line ? `${line} ${boundedTab}` : boundedTab;
466
+ if (line && visibleWidth(candidate) > width) {
467
+ lines.push(this.options.theme.fg("accent", line));
468
+ line = boundedTab;
469
+ } else {
470
+ line = candidate;
471
+ }
472
+ }
473
+ if (line) lines.push(this.options.theme.fg("accent", line));
474
+ return lines;
475
+ }
476
+
477
+ private renderQuestion(width: number): string[] {
478
+ const question = this.options.questions[this.page];
479
+ if (!question) return [];
480
+ const lines = hardWrap(
481
+ this.options.theme.fg(
482
+ "accent",
483
+ this.options.theme.bold(sanitizeTerminalText(question.question)),
484
+ ),
485
+ width,
486
+ );
487
+ lines.push("");
488
+ question.options.forEach((option, index) => {
489
+ const selected = this.selectedOptions[this.page] === index;
490
+ const cursor = selected ? "→" : " ";
491
+ const label = `${cursor} ${index + 1}. ${sanitizeTerminalText(option.label)}`;
492
+ const chosen = this.answers[this.page]?.optionIndex === index + 1;
493
+ const description = option.description
494
+ ? ` — ${sanitizeTerminalText(option.description)}`
495
+ : "";
496
+ const line = selected
497
+ ? this.options.theme.fg("accent", `${label}${chosen ? " ✓" : ""}${description}`)
498
+ : `${this.options.theme.fg("text", label)}${
499
+ chosen ? this.options.theme.fg("success", " ✓") : ""
500
+ }${description ? this.options.theme.fg("muted", description) : ""}`;
501
+ lines.push(...hardWrapWithIndent(line, width, visibleWidth(`${cursor} ${index + 1}. `)));
502
+ });
503
+ const otherIndex = question.options.length;
504
+ const otherSelected = this.selectedOptions[this.page] === otherIndex;
505
+ const otherCursor = otherSelected ? "→" : " ";
506
+ const otherLabel = `${otherCursor} ${otherIndex + 1}. Other (free-form)`;
507
+ const otherChosen = this.answers[this.page]?.wasCustom === true;
508
+ lines.push(
509
+ otherSelected
510
+ ? this.options.theme.fg("accent", `${otherLabel}${otherChosen ? " ✓" : ""}`)
511
+ : `${this.options.theme.fg("text", otherLabel)}${
512
+ otherChosen ? this.options.theme.fg("success", " ✓") : ""
513
+ }`,
514
+ );
515
+ const answer = this.answers[this.page];
516
+ if (answer?.wasCustom)
517
+ lines.push(...labeledRaw("Answer", answer.answer, width, this.options.theme));
518
+ if (answer?.note) lines.push(...labeledRaw("Note", answer.note, width, this.options.theme));
519
+ if (this.editorKind) {
520
+ lines.push("");
521
+ lines.push(
522
+ this.options.theme.fg(
523
+ "accent",
524
+ this.editorKind === "answer" ? "Custom answer" : "Optional note",
525
+ ),
526
+ );
527
+ lines.push(...this.editor.render(width));
528
+ }
529
+ return lines;
530
+ }
531
+
532
+ private renderReview(width: number): string[] {
533
+ const lines = [this.options.theme.fg("accent", this.options.theme.bold("Review answers")), ""];
534
+ this.options.questions.forEach((question, index) => {
535
+ const answer = this.answers[index];
536
+ const header = sanitizeTerminalText(question.header) || `Question ${index + 1}`;
537
+ const label = `${index + 1}. ${header}`;
538
+ const summary = ` — ${inlineSummary(answer?.answer ?? "Unanswered")}${
539
+ answer?.note ? ` · Note: ${inlineSummary(answer.note)}` : ""
540
+ }`;
541
+ const line = `${this.options.theme.fg("text", label)}${this.options.theme.fg("muted", summary)}`;
542
+ lines.push(...hardWrapWithIndent(line, width, visibleWidth(`${index + 1}. `)));
543
+ });
544
+ return lines;
545
+ }
546
+
547
+ private moveSelection(delta: number): void {
548
+ const optionCount = (this.options.questions[this.page]?.options.length ?? 0) + 1;
549
+ this.selectedOptions[this.page] =
550
+ ((this.selectedOptions[this.page] ?? 0) + delta + optionCount) % optionCount;
551
+ }
552
+
553
+ private submitPage(): void {
554
+ if (this.page === this.options.questions.length) {
555
+ const firstMissing = this.answers.findIndex((answer) => !answer);
556
+ if (firstMissing >= 0) {
557
+ this.message = "Answer every question before submitting.";
558
+ return;
559
+ }
560
+ this.finish(
561
+ this.answers.filter((answer): answer is PlanModeQuestionAnswer => answer !== undefined),
562
+ );
563
+ return;
564
+ }
565
+ const question = this.options.questions[this.page];
566
+ if (!question) return;
567
+ const selected = this.selectedOptions[this.page] ?? 0;
568
+ if (selected === question.options.length) {
569
+ this.beginEditor(
570
+ "answer",
571
+ this.answers[this.page]?.wasCustom ? this.answers[this.page]?.answer : "",
572
+ );
573
+ return;
574
+ }
575
+ const option = question.options[selected];
576
+ if (!option) return;
577
+ const previous = this.answers[this.page];
578
+ this.answers[this.page] = answerFor(question, option.label, {
219
579
  wasCustom: false,
220
- optionIndex: optionIndex + 1,
580
+ optionIndex: selected + 1,
581
+ note: previous?.optionIndex === selected + 1 ? previous.note : undefined,
221
582
  });
583
+ this.advance();
584
+ }
585
+
586
+ private editNote(): void {
587
+ const index = this.page;
588
+ let answer = this.answers[index];
589
+ const question = this.options.questions[index];
590
+ const selected = this.selectedOptions[index] ?? 0;
591
+ if (question && selected === question.options.length && !answer?.wasCustom) {
592
+ this.beginEditor("answer", "");
593
+ return;
594
+ }
595
+ if (question && selected < question.options.length && answer?.optionIndex !== selected + 1) {
596
+ const option = question.options[selected];
597
+ if (option) {
598
+ answer = answerFor(question, option.label, {
599
+ wasCustom: false,
600
+ optionIndex: selected + 1,
601
+ });
602
+ this.answers[index] = answer;
603
+ }
604
+ }
605
+ if (!answer) {
606
+ this.message = "Select an answer before adding a note.";
607
+ return;
608
+ }
609
+ this.beginEditor("note", answer.note ?? "");
610
+ }
611
+
612
+ private beginEditor(kind: "answer" | "note", value: string | undefined): void {
613
+ this.editorKind = kind;
614
+ this.editor.setText(value ?? "");
615
+ this.editor.focused = this._focused;
616
+ this.message = undefined;
617
+ }
618
+
619
+ private submitEditor(value: string): void {
620
+ if (value.length > MAX_PLAN_MODE_RESPONSE_LENGTH) {
621
+ this.editor.setText(value);
622
+ this.message = `${this.editorKind === "answer" ? "Answer" : "Note"} must be 4,000 characters or fewer.`;
623
+ this.options.tui.requestRender();
624
+ return;
625
+ }
626
+ const index = this.page;
627
+ if (this.editorKind === "answer") {
628
+ if (!value.trim()) {
629
+ this.editor.setText(value);
630
+ this.message = "Custom answer cannot be empty.";
631
+ this.options.tui.requestRender();
632
+ return;
633
+ }
634
+ const question = this.options.questions[index];
635
+ if (!question) return;
636
+ const previous = this.answers[index];
637
+ this.answers[index] = answerFor(question, value, {
638
+ wasCustom: true,
639
+ note: previous?.wasCustom ? previous.note : undefined,
640
+ });
641
+ this.editor.setText("");
642
+ this.editorKind = undefined;
643
+ this.editor.focused = false;
644
+ this.advance();
645
+ return;
646
+ }
647
+ const answer = this.answers[index];
648
+ if (answer) answer.note = value.trim() ? value : undefined;
649
+ this.editor.setText("");
650
+ this.editorKind = undefined;
651
+ this.editor.focused = false;
652
+ this.message = value.trim() ? "Note saved." : "Note cleared.";
653
+ this.options.tui.requestRender();
654
+ }
655
+
656
+ private advance(): void {
657
+ this.page = Math.min(this.page + 1, this.options.questions.length);
658
+ this.message = undefined;
659
+ }
660
+
661
+ private finish(answers: PlanModeQuestionAnswer[] | undefined): void {
662
+ if (this.finished) return;
663
+ this.finished = true;
664
+ this.removeAbort();
665
+ this.removeAbort = () => {};
666
+ this.editor.focused = false;
667
+ this.options.onDone(answers);
668
+ }
669
+ }
670
+
671
+ class RawPreservingEditor implements Focusable {
672
+ private readonly editor: Editor;
673
+ private readonly rawByMarker = new Map<string, string>();
674
+ private markerCodePoint = 0xe000;
675
+ private pasteBuffer: string | undefined;
676
+
677
+ constructor(tui: TUI, theme: EditorTheme) {
678
+ this.editor = new Editor(tui, theme, { paddingX: 0 });
679
+ }
680
+
681
+ get focused(): boolean {
682
+ return this.editor.focused;
683
+ }
684
+
685
+ set focused(value: boolean) {
686
+ this.editor.focused = value;
687
+ }
688
+
689
+ set onChange(handler: ((value: string) => void) | undefined) {
690
+ this.editor.onChange = handler ? () => handler(this.getExpandedText()) : undefined;
691
+ }
692
+
693
+ set onSubmit(handler: ((value: string) => void) | undefined) {
694
+ this.editor.onSubmit = handler ? (value) => handler(this.decode(value)) : undefined;
695
+ }
696
+
697
+ handleInput(data: string): void {
698
+ if (this.pasteBuffer !== undefined) {
699
+ this.pasteBuffer += data;
700
+ this.flushPasteBuffer();
701
+ return;
702
+ }
703
+ if (matchesKey(data, Key.backspace)) {
704
+ this.editor.handleInput(data);
705
+ return;
706
+ }
707
+ const pasteStart = data.indexOf(BRACKETED_PASTE_START);
708
+ if (pasteStart >= 0) {
709
+ if (pasteStart > 0) this.editor.handleInput(data.slice(0, pasteStart));
710
+ this.pasteBuffer = data.slice(pasteStart + BRACKETED_PASTE_START.length);
711
+ this.flushPasteBuffer();
712
+ return;
713
+ }
714
+ if (
715
+ [...data].some(
716
+ (character) => isUnsafeDirectEditorCharacter(character) || this.rawByMarker.has(character),
717
+ )
718
+ ) {
719
+ this.editor.handleInput(this.encode(data));
720
+ return;
721
+ }
722
+ this.editor.handleInput(data);
723
+ }
724
+
725
+ render(width: number): string[] {
726
+ return this.editor
727
+ .render(width)
728
+ .map((line) =>
729
+ [...line].map((character) => (this.rawByMarker.has(character) ? " " : character)).join(""),
730
+ );
731
+ }
732
+
733
+ invalidate(): void {
734
+ this.editor.invalidate();
735
+ }
736
+
737
+ setText(value: string): void {
738
+ this.rawByMarker.clear();
739
+ this.markerCodePoint = 0xe000;
740
+ this.pasteBuffer = undefined;
741
+ this.editor.setText(this.encode(value));
742
+ }
743
+
744
+ getExpandedText(): string {
745
+ return this.decode(this.editor.getExpandedText());
746
+ }
747
+
748
+ private flushPasteBuffer(): void {
749
+ if (this.pasteBuffer === undefined) return;
750
+ const pasteEnd = this.pasteBuffer.indexOf(BRACKETED_PASTE_END);
751
+ if (pasteEnd < 0) return;
752
+ const raw = this.pasteBuffer.slice(0, pasteEnd);
753
+ const remaining = this.pasteBuffer.slice(pasteEnd + BRACKETED_PASTE_END.length);
754
+ this.pasteBuffer = undefined;
755
+ this.editor.handleInput(`${BRACKETED_PASTE_START}${this.encode(raw)}${BRACKETED_PASTE_END}`);
756
+ if (remaining) this.handleInput(remaining);
757
+ }
758
+
759
+ private encode(value: string): string {
760
+ const forbidden = new Set([
761
+ ...value,
762
+ ...this.editor.getExpandedText(),
763
+ ...this.rawByMarker.keys(),
764
+ ]);
765
+ return [...value]
766
+ .map((character) => {
767
+ if (!isUnsafeEditorCharacter(character) && !this.rawByMarker.has(character)) {
768
+ return character;
769
+ }
770
+ const marker = this.nextMarker(forbidden);
771
+ this.rawByMarker.set(marker, character);
772
+ forbidden.add(marker);
773
+ return marker;
774
+ })
775
+ .join("");
776
+ }
777
+
778
+ private decode(value: string): string {
779
+ return [...value].map((character) => this.rawByMarker.get(character) ?? character).join("");
780
+ }
781
+
782
+ private nextMarker(forbidden: ReadonlySet<string>): string {
783
+ for (;;) {
784
+ if (this.markerCodePoint === 0xf900) this.markerCodePoint = 0xf0000;
785
+ if (this.markerCodePoint === 0xffffe) this.markerCodePoint = 0x100000;
786
+ if (this.markerCodePoint > 0x10fffd) {
787
+ throw new Error("Plan-mode editor exhausted its safe input markers.");
788
+ }
789
+ const marker = String.fromCodePoint(this.markerCodePoint++);
790
+ if (!forbidden.has(marker)) return marker;
791
+ }
222
792
  }
223
- return answers;
793
+ }
794
+
795
+ function isUnsafeDirectEditorCharacter(character: string): boolean {
796
+ const codePoint = character.codePointAt(0) ?? 0;
797
+ return (
798
+ (codePoint >= 0x7f && codePoint <= 0x9f) ||
799
+ codePoint === 0x2028 ||
800
+ codePoint === 0x2029 ||
801
+ isBidiControl(codePoint)
802
+ );
803
+ }
804
+
805
+ function isUnsafeEditorCharacter(character: string): boolean {
806
+ const codePoint = character.codePointAt(0) ?? 0;
807
+ return (
808
+ character !== "\n" &&
809
+ (codePoint <= 0x1f ||
810
+ (codePoint >= 0x7f && codePoint <= 0x9f) ||
811
+ codePoint === 0x2028 ||
812
+ codePoint === 0x2029 ||
813
+ isBidiControl(codePoint))
814
+ );
815
+ }
816
+
817
+ function answerFor(
818
+ question: PlanModeQuestion,
819
+ answer: string,
820
+ options: { wasCustom: boolean; optionIndex?: number; note?: string },
821
+ ): PlanModeQuestionAnswer {
822
+ const result: PlanModeQuestionAnswer = {
823
+ id: question.id,
824
+ header: question.header,
825
+ question: question.question,
826
+ answer,
827
+ wasCustom: options.wasCustom,
828
+ };
829
+ if (options.optionIndex !== undefined) result.optionIndex = options.optionIndex;
830
+ if (options.note !== undefined) result.note = options.note;
831
+ return result;
224
832
  }
225
833
 
226
834
  function formatPlanModeQuestionChoice(option: PlanModeQuestionOption, index: number) {
@@ -264,6 +872,126 @@ function formatPlanModeQuestionPayload(payload: {
264
872
  return JSON.stringify(payload, null, 2);
265
873
  }
266
874
 
875
+ export function sanitizeTerminalText(value: string): string {
876
+ return [...stripVTControlCharacters(value)]
877
+ .map((character) => {
878
+ const codePoint = character.codePointAt(0) ?? 0;
879
+ return codePoint <= 0x1f ||
880
+ (codePoint >= 0x7f && codePoint <= 0x9f) ||
881
+ codePoint === 0x2028 ||
882
+ codePoint === 0x2029 ||
883
+ isBidiControl(codePoint)
884
+ ? " "
885
+ : character;
886
+ })
887
+ .join("");
888
+ }
889
+
890
+ function isBidiControl(codePoint: number): boolean {
891
+ return (
892
+ codePoint === 0x061c ||
893
+ codePoint === 0x200e ||
894
+ codePoint === 0x200f ||
895
+ (codePoint >= 0x202a && codePoint <= 0x202e) ||
896
+ (codePoint >= 0x2066 && codePoint <= 0x2069)
897
+ );
898
+ }
899
+
900
+ type QuestionnaireKeybinding = Parameters<KeybindingsManager["getKeys"]>[0];
901
+
902
+ function keybindingHint(
903
+ theme: Theme,
904
+ keybindings: KeybindingsManager,
905
+ keybinding: QuestionnaireKeybinding,
906
+ description: string,
907
+ ): string {
908
+ return rawKeyHint(theme, formatHintKeys(keybindings.getKeys(keybinding)), description);
909
+ }
910
+
911
+ function rawKeyHint(theme: Theme, keys: string, description: string): string {
912
+ return `${theme.fg("dim", keys)}${theme.fg("muted", ` ${description}`)}`;
913
+ }
914
+
915
+ function cancelHint(theme: Theme, keybindings: KeybindingsManager): string {
916
+ return rawKeyHint(
917
+ theme,
918
+ formatHintKeys([...keybindings.getKeys("tui.select.cancel"), "ctrl+c"]),
919
+ "cancel",
920
+ );
921
+ }
922
+
923
+ function selectionNavigationKeys(keybindings: KeybindingsManager): string {
924
+ const up = keybindings.getKeys("tui.select.up");
925
+ const down = keybindings.getKeys("tui.select.down");
926
+ if (up.includes("up") && down.includes("down")) {
927
+ return formatHintKeys([
928
+ "↑↓",
929
+ ...up.filter((key) => key !== "up"),
930
+ ...down.filter((key) => key !== "down"),
931
+ ]);
932
+ }
933
+ return formatHintKeys([...up, ...down]);
934
+ }
935
+
936
+ function questionNavigationKeys(keybindings: KeybindingsManager): string {
937
+ return formatHintKeys([...keybindings.getKeys("tui.input.tab"), "shift+tab", "←→"]);
938
+ }
939
+
940
+ function formatHintKeys(keys: readonly string[]): string {
941
+ return [...new Set(keys)].map(formatHintKey).join("/");
942
+ }
943
+
944
+ function formatHintKey(key: string): string {
945
+ return key
946
+ .split("+")
947
+ .map((part) =>
948
+ process.platform === "darwin" && part.toLowerCase() === "alt" ? "option" : part,
949
+ )
950
+ .join("+");
951
+ }
952
+
953
+ function inlineSummary(value: string): string {
954
+ return value.split("\n").map(sanitizeTerminalText).join(" ↵ ");
955
+ }
956
+
957
+ function labeledRaw(label: string, value: string, width: number, theme: Theme): string[] {
958
+ const prefix = `${label}: `;
959
+ const safe = sanitizeTerminalText(value);
960
+ const lines = hardWrap(safe, Math.max(1, width - visibleWidth(prefix)));
961
+ return lines.map((line, index) =>
962
+ index === 0 ? `${theme.fg("muted", prefix)}${line}` : `${" ".repeat(prefix.length)}${line}`,
963
+ );
964
+ }
965
+
966
+ function hardWrapWithIndent(value: string, width: number, indent: number): string[] {
967
+ const safeWidth = Math.max(1, width);
968
+ const safeIndent = Math.min(Math.max(0, indent), Math.max(0, safeWidth - 1));
969
+ const continuationWidth = Math.max(1, safeWidth - safeIndent);
970
+ const columns = visibleWidth(value);
971
+ if (columns <= safeWidth) return [value];
972
+ const output = [sliceByColumn(value, 0, safeWidth)];
973
+ for (let column = safeWidth; column < columns; column += continuationWidth) {
974
+ output.push(`${" ".repeat(safeIndent)}${sliceByColumn(value, column, continuationWidth)}`);
975
+ }
976
+ return output;
977
+ }
978
+
979
+ function hardWrap(value: string, width: number): string[] {
980
+ const safeWidth = Math.max(1, width);
981
+ if (!value) return [""];
982
+ const output: string[] = [];
983
+ for (const sourceLine of value.split("\n")) {
984
+ const columns = visibleWidth(sourceLine);
985
+ if (columns === 0) output.push("");
986
+ else {
987
+ for (let column = 0; column < columns; column += safeWidth) {
988
+ output.push(sliceByColumn(sourceLine, column, safeWidth));
989
+ }
990
+ }
991
+ }
992
+ return output;
993
+ }
994
+
267
995
  function isRecord(value: unknown): value is Record<string, unknown> {
268
996
  return typeof value === "object" && value !== null;
269
997
  }