@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/extensions/ask-user-question/answer-text.d.ts

@@ -0,0 +1,4 @@
+import type { AnsweredQuestion } from './answer.js';
+export declare function answeredText(answers: readonly AnsweredQuestion[]): string;
+export declare const DECLINED_TEXT = "The developer declined to answer your questions. Continue without their input, and state the assumptions you make.";
+export declare const HEADLESS_TEXT = "No developer is available to answer questions in this session. Proceed on stated assumptions, and say what you assumed.";

package/dist/extensions/ask-user-question/answer-text.js

@@ -0,0 +1,19 @@
+const ANSWERED_PREFIX = 'User has answered your questions: ';
+const ANSWERED_SUFFIX = ". You can now continue with the user's answers in mind.";
+const PAIR_SEPARATOR = ', ';
+const LABEL_SEPARATOR = ', ';
+export function answeredText(answers) {
+    const pairs = answers.map(({ question, answer }) => `"${question}"="${givenText(answer)}"`);
+    return `${ANSWERED_PREFIX}${pairs.join(PAIR_SEPARATOR)}${ANSWERED_SUFFIX}`;
+}
+export const DECLINED_TEXT = 'The developer declined to answer your questions. Continue without their input, and state the assumptions you make.';
+export const HEADLESS_TEXT = 'No developer is available to answer questions in this session. Proceed on stated assumptions, and say what you assumed.';
+function givenText(answer) {
+    switch (answer.kind) {
+        case 'chosen':
+            return answer.labels.join(LABEL_SEPARATOR);
+        case 'free-text':
+            return answer.text;
+    }
+}
+//# sourceMappingURL=answer-text.js.map

package/dist/extensions/ask-user-question/answer-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-text.js","sourceRoot":"","sources":["../../../src/extensions/ask-user-question/answer-text.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,oCAAoC,CAAC;AAC7D,MAAM,eAAe,GAAG,yDAAyD,CAAC;AAClF,MAAM,cAAc,GAAG,IAAI,CAAC;AAC5B,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,YAAY,CAAC,OAAoC;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,QAAQ,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5F,OAAO,GAAG,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,eAAe,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GACxB,oHAAoH,CAAC;AAEvH,MAAM,CAAC,MAAM,aAAa,GACxB,yHAAyH,CAAC;AAE5H,SAAS,SAAS,CAAC,MAAmB;IACpC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7C,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/extensions/ask-user-question/answer.d.ts

@@ -0,0 +1,25 @@
+interface ChosenAnswer {
+    readonly kind: 'chosen';
+    readonly labels: readonly string[];
+}
+interface FreeTextAnswer {
+    readonly kind: 'free-text';
+    readonly text: string;
+}
+interface DeclinedAnswer {
+    readonly kind: 'declined';
+}
+export type GivenAnswer = ChosenAnswer | FreeTextAnswer;
+export type Answer = GivenAnswer | DeclinedAnswer;
+export interface AnsweredQuestion {
+    readonly question: string;
+    readonly answer: GivenAnswer;
+}
+export type Questionnaire = {
+    readonly kind: 'answered';
+    readonly answers: readonly AnsweredQuestion[];
+} | DeclinedAnswer;
+export declare const chosenAnswer: (...labels: string[]) => ChosenAnswer;
+export declare const freeTextAnswer: (text: string) => FreeTextAnswer;
+export declare const DECLINED: DeclinedAnswer;
+export {};

package/dist/extensions/ask-user-question/answer.js

@@ -0,0 +1,4 @@
+export const chosenAnswer = (...labels) => ({ kind: 'chosen', labels });
+export const freeTextAnswer = (text) => ({ kind: 'free-text', text });
+export const DECLINED = { kind: 'declined' };
+//# sourceMappingURL=answer.js.map

package/dist/extensions/ask-user-question/answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.js","sourceRoot":"","sources":["../../../src/extensions/ask-user-question/answer.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAG,MAAgB,EAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,QAAQ,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}

package/dist/extensions/ask-user-question/dialog/key-routing.d.ts

@@ -0,0 +1,19 @@
+export interface DialogState {
+    readonly optionCount: number;
+    readonly multiSelect: boolean;
+    readonly focus: number;
+    readonly ticked: readonly boolean[];
+    readonly typing: boolean;
+}
+export type KeyRoute = {
+    readonly kind: 'stay';
+    readonly state: DialogState;
+    readonly editorInput?: string;
+} | {
+    readonly kind: 'confirm';
+    readonly state: DialogState;
+} | {
+    readonly kind: 'decline';
+};
+export declare const startingState: (optionCount: number, multiSelect: boolean) => DialogState;
+export declare function routeKey(state: DialogState, data: string): KeyRoute;

package/dist/extensions/ask-user-question/dialog/key-routing.js

@@ -0,0 +1,46 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/question.ts.
+import { Key, matchesKey } from '@earendil-works/pi-tui';
+import { PASTE_START } from '../../../kernel/terminal-rows/bracketed-paste.js';
+const FIRST_PRINTABLE_CODE = 0x20;
+const DELETE_CODE = 0x7f;
+export const startingState = (optionCount, multiSelect) => ({
+    optionCount,
+    multiSelect,
+    focus: 0,
+    ticked: Array.from({ length: optionCount }, () => false),
+    typing: false,
+});
+const isOnTypeRow = (state) => state.focus === state.optionCount;
+export function routeKey(state, data) {
+    return state.typing ? routeWhileTyping(state, data) : routeWhileChoosing(state, data);
+}
+function routeWhileTyping(state, data) {
+    if (matchesKey(data, Key.escape)) {
+        return stay({ ...state, typing: false });
+    }
+    return { kind: 'stay', state, editorInput: data };
+}
+function routeWhileChoosing(state, data) {
+    const binding = CHOOSING_KEYS.find(({ key }) => matchesKey(data, key));
+    if (binding !== undefined) {
+        return binding.route(state);
+    }
+    return isOnTypeRow(state) && (isPrintable(data) || data.startsWith(PASTE_START)) ? { kind: 'stay', state: { ...state, typing: true }, editorInput: data } : stay(state);
+}
+const CHOOSING_KEYS = [
+    { key: Key.up, route: (state) => stay({ ...state, focus: Math.max(0, state.focus - 1) }) },
+    { key: Key.down, route: (state) => stay({ ...state, focus: Math.min(state.optionCount, state.focus + 1) }) },
+    { key: Key.space, route: (state) => stay(state.multiSelect && !isOnTypeRow(state) ? tickFocused(state) : state) },
+    { key: Key.enter, route: (state) => (isOnTypeRow(state) ? stay({ ...state, typing: true }) : { kind: 'confirm', state }) },
+    { key: Key.escape, route: () => ({ kind: 'decline' }) },
+];
+function isPrintable(data) {
+    const first = data.codePointAt(0) ?? 0;
+    return first >= FIRST_PRINTABLE_CODE && first !== DELETE_CODE;
+}
+const stay = (state) => ({ kind: 'stay', state });
+const tickFocused = (state) => ({
+    ...state,
+    ticked: state.ticked.map((isTicked, index) => (index === state.focus ? !isTicked : isTicked)),
+});
+//# sourceMappingURL=key-routing.js.map

package/dist/extensions/ask-user-question/dialog/key-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-routing.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/dialog/key-routing.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,OAAO,EAAE,GAAG,EAAE,UAAU,EAAc,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAe/E,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,WAAW,GAAG,IAAI,CAAC;AAOzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAmB,EAAE,WAAoB,EAAe,EAAE,CAAC,CAAC;IACxF,WAAW;IACX,WAAW;IACX,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;IACxD,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAW,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,WAAW,CAAC;AAEvF,MAAM,UAAU,QAAQ,CAAC,KAAkB,EAAE,IAAY;IACvD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAkB,EAAE,IAAY;IACxD,IAAI,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAkB,EAAE,IAAY;IAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1K,CAAC;AAED,MAAM,aAAa,GAA2B;IAC5C,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE;IAC1F,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE;IAC5G,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;IACjH,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE;IAC1H,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;CACxD,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,IAAI,oBAAoB,IAAI,KAAK,KAAK,WAAW,CAAC;AAChE,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,KAAkB,EAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAEzE,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAe,EAAE,CAAC,CAAC;IACxD,GAAG,KAAK;IACR,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC9F,CAAC,CAAC"}

package/dist/extensions/ask-user-question/dialog/option-rows.d.ts

@@ -0,0 +1,5 @@
+import type { Theme } from '@earendil-works/pi-coding-agent';
+import type { Question } from '../question-schema.js';
+import type { DialogState } from './key-routing.js';
+export declare const TYPE_SOMETHING_LABEL = "Type something.";
+export declare function optionRows(question: Question, state: DialogState, theme: Theme): string[];

package/dist/extensions/ask-user-question/dialog/option-rows.js

@@ -0,0 +1,17 @@
+import { singleLine } from '../../../kernel/terminal-rows/single-line.js';
+export const TYPE_SOMETHING_LABEL = 'Type something.';
+const DETAIL_SEPARATOR = ' — ';
+const TYPING_MARK = ' ✎';
+export function optionRows(question, state, theme) {
+    const optionTexts = question.options.map((option, index) => optionText(option, index, state));
+    const typeText = `${String(question.options.length + 1)}. ${TYPE_SOMETHING_LABEL}${state.typing ? TYPING_MARK : ''}`;
+    return [...optionTexts, typeText].map((text, index) => rowAt(text, index === state.focus, theme));
+}
+function optionText({ label, description, preview }, index, state) {
+    const checkbox = state.multiSelect ? `${checkboxFor(state.ticked[index] === true)} ` : '';
+    const details = [description, preview ?? ''].map(singleLine).filter((text) => text !== '');
+    return [`${String(index + 1)}. ${checkbox}${singleLine(label)}`, ...details].join(DETAIL_SEPARATOR);
+}
+const checkboxFor = (isTicked) => (isTicked ? '[x]' : '[ ]');
+const rowAt = (text, isFocused, theme) => isFocused ? `${theme.fg('accent', '> ')}${theme.fg('accent', text)}` : `  ${theme.fg('text', text)}`;
+//# sourceMappingURL=option-rows.js.map

package/dist/extensions/ask-user-question/dialog/option-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-rows.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/dialog/option-rows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAI1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,MAAM,UAAU,UAAU,CAAC,QAAkB,EAAE,KAAkB,EAAE,KAAY;IAC7E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACrH,OAAO,CAAC,GAAG,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAkB,EAAE,KAAa,EAAE,KAAkB;IACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,QAAiB,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAE9E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,SAAkB,EAAE,KAAY,EAAU,EAAE,CACvE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC"}

package/dist/extensions/ask-user-question/dialog/question-dialog.d.ts

@@ -0,0 +1,17 @@
+import type { Theme } from '@earendil-works/pi-coding-agent';
+import { type TUI } from '@earendil-works/pi-tui';
+import { type Answer } from '../answer.js';
+import type { Question } from '../question-schema.js';
+export type DialogStep = {
+    readonly kind: 'continue';
+} | {
+    readonly kind: 'answered';
+    readonly answer: Answer;
+} | {
+    readonly kind: 'declined';
+};
+export interface QuestionDialog {
+    render(width: number): string[];
+    handleInput(data: string): DialogStep;
+}
+export declare function createQuestionDialog(question: Question, tui: TUI, theme: Theme): QuestionDialog;

package/dist/extensions/ask-user-question/dialog/question-dialog.js

@@ -0,0 +1,94 @@
+import { Editor, truncateToWidth } from '@earendil-works/pi-tui';
+import { singleLine } from '../../../kernel/terminal-rows/single-line.js';
+import { chosenAnswer, freeTextAnswer } from '../answer.js';
+import { routeKey, startingState } from './key-routing.js';
+import { optionRows } from './option-rows.js';
+import { selectedLabels } from './selected-labels.js';
+const CONTINUE = { kind: 'continue' };
+const DECLINED_STEP = { kind: 'declined' };
+const hintFor = ({ typing, multiSelect }) => {
+    if (typing) {
+        return ' Enter to submit • Esc to go back';
+    }
+    return multiSelect
+        ? ' ↑↓ navigate • Space to tick • Enter to confirm • type on "Type something." to add your own • Esc to cancel'
+        : ' ↑↓ navigate • Enter to select • type on "Type something." to answer • Esc to cancel';
+};
+export function createQuestionDialog(question, tui, theme) {
+    return new TerminalQuestionDialog(question, tui, theme);
+}
+class TerminalQuestionDialog {
+    state;
+    submitted;
+    question;
+    theme;
+    editor;
+    constructor(question, tui, theme) {
+        this.question = question;
+        this.theme = theme;
+        this.state = startingState(question.options.length, question.multiSelect);
+        this.editor = new Editor(tui, editorThemeOf(theme));
+        this.editor.onSubmit = (text) => {
+            this.submitted = text.trim();
+        };
+    }
+    render(width) {
+        const { theme, question, state } = this;
+        const rule = theme.fg('accent', '─'.repeat(width));
+        const rows = [rule, theme.fg('muted', ` [${singleLine(question.header)}]`), theme.fg('text', ` ${singleLine(question.question)}`), '', ...optionRows(question, state, theme)];
+        const box = state.typing ? ['', theme.fg('muted', ' Your answer:'), ...this.editor.render(width - 2).map((line) => ` ${line}`)] : [];
+        return [...rows, ...box, '', theme.fg('dim', hintFor(state)), rule].map((row) => truncateToWidth(row, width));
+    }
+    handleInput(data) {
+        const route = routeKey(this.state, data);
+        if (route.kind === 'decline') {
+            return DECLINED_STEP;
+        }
+        if (route.kind === 'confirm') {
+            return this.confirm(route.state);
+        }
+        this.adopt(route.state);
+        return route.editorInput === undefined ? CONTINUE : this.typeInto(route.editorInput);
+    }
+    confirm(state) {
+        const labels = selectedLabels(this.question, state);
+        return labels.length === 0 ? CONTINUE : { kind: 'answered', answer: chosenAnswer(...labels) };
+    }
+    adopt(next) {
+        if (this.state.typing && !next.typing) {
+            this.editor.setText('');
+        }
+        this.state = next;
+    }
+    typeInto(data) {
+        this.editor.handleInput(data);
+        const submission = this.takeSubmission();
+        return submission === undefined ? CONTINUE : this.submit(submission);
+    }
+    takeSubmission() {
+        const text = this.submitted;
+        this.submitted = undefined;
+        return text;
+    }
+    submit(text) {
+        if (text === '') {
+            this.adopt({ ...this.state, typing: false });
+            return CONTINUE;
+        }
+        return { kind: 'answered', answer: this.typedAnswer(text) };
+    }
+    typedAnswer(text) {
+        return this.state.multiSelect ? chosenAnswer(...selectedLabels(this.question, this.state), text) : freeTextAnswer(text);
+    }
+}
+const editorThemeOf = (theme) => ({
+    borderColor: (text) => theme.fg('accent', text),
+    selectList: {
+        selectedPrefix: (text) => theme.fg('accent', text),
+        selectedText: (text) => theme.fg('accent', text),
+        description: (text) => theme.fg('muted', text),
+        scrollInfo: (text) => theme.fg('dim', text),
+        noMatch: (text) => theme.fg('warning', text),
+    },
+});
+//# sourceMappingURL=question-dialog.js.map

package/dist/extensions/ask-user-question/dialog/question-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-dialog.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/dialog/question-dialog.ts"],"names":[],"mappings":"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"}

package/dist/extensions/ask-user-question/dialog/selected-labels.d.ts

@@ -0,0 +1,3 @@
+import type { Question } from '../question-schema.js';
+import type { DialogState } from './key-routing.js';
+export declare const selectedLabels: (question: Question, state: DialogState) => string[];

package/dist/extensions/ask-user-question/dialog/selected-labels.js

@@ -0,0 +1,2 @@
+export const selectedLabels = (question, state) => question.options.filter((_, index) => (state.multiSelect ? state.ticked[index] === true : index === state.focus)).map(({ label }) => label);
+//# sourceMappingURL=selected-labels.js.map

package/dist/extensions/ask-user-question/dialog/selected-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selected-labels.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/dialog/selected-labels.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAE,KAAkB,EAAY,EAAE,CACjF,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC"}

package/dist/extensions/ask-user-question/index.d.ts

@@ -0,0 +1,2 @@
+import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function askUserQuestionExtension(pi: ExtensionAPI): void;

package/dist/extensions/ask-user-question/index.js

@@ -0,0 +1,33 @@
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { textResult } from '../../kernel/tool-results/tool-result.js';
+import { answeredText, DECLINED_TEXT, HEADLESS_TEXT } from './answer-text.js';
+import { choosePrompter } from './prompters/choose-prompter.js';
+import { QuestionAsker } from './question-asker.js';
+import { AskUserQuestionParams } from './question-schema.js';
+const ASK_USER_QUESTION_DESCRIPTION = [
+    'Asks the developer 1-4 multiple-choice questions to gather preferences, clarify an ambiguous request or choose between approaches.',
+    'Each question has 2-4 options, each with a short label and a description.',
+    'The developer can always answer with their own text, so never add an "Other" option yourself.',
+    'Set multiSelect to true when several options can apply together.',
+    'If you recommend an option, list it first and end its label with "(Recommended)".',
+    'An option may carry a preview, which is shown with its description.',
+].join(' ');
+const askUserQuestionTool = defineTool({
+    name: 'AskUserQuestion',
+    label: 'AskUserQuestion',
+    description: ASK_USER_QUESTION_DESCRIPTION,
+    parameters: AskUserQuestionParams,
+    executionMode: 'sequential',
+    execute: async (_toolCallId, { questions }, signal, _onUpdate, ctx) => {
+        const choice = choosePrompter(ctx);
+        if (choice.kind === 'headless') {
+            return textResult(HEADLESS_TEXT);
+        }
+        const questionnaire = await new QuestionAsker(choice.prompter).askAll(questions, signal);
+        return textResult(questionnaire.kind === 'answered' ? answeredText(questionnaire.answers) : DECLINED_TEXT);
+    },
+});
+export default function askUserQuestionExtension(pi) {
+    pi.registerTool(askUserQuestionTool);
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/ask-user-question/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/ask-user-question/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,6BAA6B,GAAG;IACpC,oIAAoI;IACpI,2EAA2E;IAC3E,+FAA+F;IAC/F,kEAAkE;IAClE,mFAAmF;IACnF,qEAAqE;CACtE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,mBAAmB,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE,qBAAqB;IACjC,aAAa,EAAE,YAAY;IAC3B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;QACpE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACzF,OAAO,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC7G,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAAgB;IAC/D,EAAE,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;AACvC,CAAC"}

package/dist/extensions/ask-user-question/prompters/choose-prompter.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { QuestionPrompter } from './question-prompter.js';
+export type PrompterChoice = {
+    readonly kind: 'headless';
+} | {
+    readonly kind: 'asking';
+    readonly prompter: QuestionPrompter;
+};
+export declare function choosePrompter({ hasUI, mode, ui }: ExtensionContext): PrompterChoice;

package/dist/extensions/ask-user-question/prompters/choose-prompter.js

@@ -0,0 +1,9 @@
+import { DialogQuestionPrompter } from './dialog-question-prompter.js';
+import { TerminalQuestionPrompter } from './terminal-question-prompter.js';
+export function choosePrompter({ hasUI, mode, ui }) {
+    if (!hasUI) {
+        return { kind: 'headless' };
+    }
+    return { kind: 'asking', prompter: mode === 'tui' ? new TerminalQuestionPrompter(ui) : new DialogQuestionPrompter(ui) };
+}
+//# sourceMappingURL=choose-prompter.js.map

package/dist/extensions/ask-user-question/prompters/choose-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choose-prompter.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/prompters/choose-prompter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAI3E,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAoB;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,sBAAsB,CAAC,EAAE,CAAC,EAAE,CAAC;AAC1H,CAAC"}

package/dist/extensions/ask-user-question/prompters/dialog-question-prompter.d.ts

@@ -0,0 +1,13 @@
+import type { ExtensionUIContext } from '@earendil-works/pi-coding-agent';
+import { type Answer } from '../answer.js';
+import type { Question } from '../question-schema.js';
+import type { QuestionPrompter } from './question-prompter.js';
+type DialogUi = Pick<ExtensionUIContext, 'select' | 'input'>;
+export declare class DialogQuestionPrompter implements QuestionPrompter {
+    private readonly ui;
+    constructor(ui: DialogUi);
+    ask(question: Question, signal: AbortSignal | undefined): Promise<Answer>;
+    private askTyped;
+    private withOtherText;
+}
+export {};

package/dist/extensions/ask-user-question/prompters/dialog-question-prompter.js

@@ -0,0 +1,32 @@
+import { chosenAnswer, DECLINED, freeTextAnswer } from '../answer.js';
+import { TYPE_SOMETHING_LABEL } from '../dialog/option-rows.js';
+const OTHER_PLACEHOLDER = 'Your own answer, or leave empty to skip';
+const TYPED_PLACEHOLDER = 'Your answer';
+const dialogOptions = (signal) => (signal === undefined ? undefined : { signal });
+export class DialogQuestionPrompter {
+    ui;
+    constructor(ui) {
+        this.ui = ui;
+    }
+    async ask(question, signal) {
+        const labels = [...question.options.map(({ label }) => label), TYPE_SOMETHING_LABEL].map((label, index) => `${String(index + 1)}. ${label}`);
+        const choice = await this.ui.select(`[${question.header}] ${question.question}`, labels, dialogOptions(signal));
+        if (choice === undefined) {
+            return DECLINED;
+        }
+        const picked = question.options[labels.indexOf(choice)];
+        return picked === undefined ? this.askTyped(question, signal) : this.withOtherText(picked.label, question, signal);
+    }
+    async askTyped({ question }, signal) {
+        const typed = (await this.ui.input(question, TYPED_PLACEHOLDER, dialogOptions(signal)))?.trim() ?? '';
+        return typed === '' ? DECLINED : freeTextAnswer(typed);
+    }
+    async withOtherText(label, { question, multiSelect }, signal) {
+        if (!multiSelect) {
+            return chosenAnswer(label);
+        }
+        const typed = (await this.ui.input(`Other: ${question}`, OTHER_PLACEHOLDER, dialogOptions(signal)))?.trim() ?? '';
+        return typed === '' ? chosenAnswer(label) : chosenAnswer(label, typed);
+    }
+}
+//# sourceMappingURL=dialog-question-prompter.js.map

package/dist/extensions/ask-user-question/prompters/dialog-question-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-question-prompter.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/prompters/dialog-question-prompter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAe,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMhE,MAAM,iBAAiB,GAAG,yCAAyC,CAAC;AACpE,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAExC,MAAM,aAAa,GAAG,CAAC,MAA+B,EAAuC,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhJ,MAAM,OAAO,sBAAsB;IAChB,EAAE,CAAW;IAE9B,YAAY,EAAY;QACtB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAkB,EAAE,MAA+B;QAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QAC7I,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAChH,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAY,EAAE,MAA+B;QAC5E,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtG,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAY,EAAE,MAA+B;QAC7G,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,QAAQ,EAAE,EAAE,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAClH,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/extensions/ask-user-question/prompters/question-prompter.d.ts

@@ -0,0 +1,5 @@
+import type { Answer } from '../answer.js';
+import type { Question } from '../question-schema.js';
+export interface QuestionPrompter {
+    ask(question: Question, signal: AbortSignal | undefined): Promise<Answer>;
+}

package/dist/extensions/ask-user-question/prompters/question-prompter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=question-prompter.js.map

package/dist/extensions/ask-user-question/prompters/question-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-prompter.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/prompters/question-prompter.ts"],"names":[],"mappings":""}

package/dist/extensions/ask-user-question/prompters/terminal-question-prompter.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionUIContext } from '@earendil-works/pi-coding-agent';
+import { type Answer } from '../answer.js';
+import type { Question } from '../question-schema.js';
+import type { QuestionPrompter } from './question-prompter.js';
+export declare class TerminalQuestionPrompter implements QuestionPrompter {
+    private readonly ui;
+    constructor(ui: Pick<ExtensionUIContext, 'custom'>);
+    ask(question: Question, signal: AbortSignal | undefined): Promise<Answer>;
+}

package/dist/extensions/ask-user-question/prompters/terminal-question-prompter.js

@@ -0,0 +1,43 @@
+import { DECLINED } from '../answer.js';
+import { createQuestionDialog } from '../dialog/question-dialog.js';
+export class TerminalQuestionPrompter {
+    ui;
+    constructor(ui) {
+        this.ui = ui;
+    }
+    async ask(question, signal) {
+        if (signal?.aborted === true) {
+            return DECLINED;
+        }
+        const answer = await this.ui.custom((tui, theme, _keybindings, done) => dialogComponent(question, { tui, theme, done, signal }));
+        return answer ?? DECLINED;
+    }
+}
+function dialogComponent(question, host) {
+    const { tui, theme, done, signal } = host;
+    const dialog = createQuestionDialog(question, tui, theme);
+    const decline = () => {
+        done(DECLINED);
+    };
+    signal?.addEventListener('abort', decline);
+    return {
+        render: (width) => dialog.render(width),
+        invalidate: () => undefined,
+        dispose: () => {
+            signal?.removeEventListener('abort', decline);
+        },
+        handleInput: (data) => {
+            finishOn(dialog.handleInput(data), host);
+            tui.requestRender();
+        },
+    };
+}
+function finishOn(step, { done }) {
+    if (step.kind === 'answered') {
+        done(step.answer);
+    }
+    else if (step.kind === 'declined') {
+        done(DECLINED);
+    }
+}
+//# sourceMappingURL=terminal-question-prompter.js.map

package/dist/extensions/ask-user-question/prompters/terminal-question-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-question-prompter.js","sourceRoot":"","sources":["../../../../src/extensions/ask-user-question/prompters/terminal-question-prompter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAe,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAmB,MAAM,8BAA8B,CAAC;AAMrF,MAAM,OAAO,wBAAwB;IAClB,EAAE,CAAqC;IAExD,YAAY,EAAsC;QAChD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAkB,EAAE,MAA+B;QAC3D,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAqB,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,CACzF,eAAe,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CACxD,CAAC;QACF,OAAO,MAAM,IAAI,QAAQ,CAAC;IAC5B,CAAC;CACF;AASD,SAAS,eAAe,CAAC,QAAkB,EAAE,IAAgB;IAC3D,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;QAC3B,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YACpB,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YACzC,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAgB,EAAE,EAAE,IAAI,EAAc;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;SAAM,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/extensions/ask-user-question/question-asker.d.ts

@@ -0,0 +1,8 @@
+import { type Questionnaire } from './answer.js';
+import type { QuestionPrompter } from './prompters/question-prompter.js';
+import type { Question } from './question-schema.js';
+export declare class QuestionAsker {
+    private readonly prompter;
+    constructor(prompter: QuestionPrompter);
+    askAll(questions: readonly Question[], signal: AbortSignal | undefined): Promise<Questionnaire>;
+}

package/dist/extensions/ask-user-question/question-asker.js

@@ -0,0 +1,19 @@
+import { DECLINED } from './answer.js';
+export class QuestionAsker {
+    prompter;
+    constructor(prompter) {
+        this.prompter = prompter;
+    }
+    async askAll(questions, signal) {
+        const answers = [];
+        for (const question of questions) {
+            const answer = await this.prompter.ask(question, signal);
+            if (answer.kind === 'declined') {
+                return DECLINED;
+            }
+            answers.push({ question: question.question, answer });
+        }
+        return { kind: 'answered', answers };
+    }
+}
+//# sourceMappingURL=question-asker.js.map

package/dist/extensions/ask-user-question/question-asker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-asker.js","sourceRoot":"","sources":["../../../src/extensions/ask-user-question/question-asker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA6C,MAAM,aAAa,CAAC;AAIlF,MAAM,OAAO,aAAa;IACP,QAAQ,CAAmB;IAE5C,YAAY,QAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAA8B,EAAE,MAA+B;QAC1E,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/B,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;CACF"}

package/dist/extensions/ask-user-question/question-schema.d.ts

@@ -0,0 +1,31 @@
+import { Type, type Static } from 'typebox';
+declare const QuestionOptionSchema: Type.TObject<{
+    label: Type.TString;
+    description: Type.TString;
+    preview: Type.TOptional<Type.TString>;
+}>;
+declare const QuestionSchema: Type.TObject<{
+    question: Type.TString;
+    header: Type.TString;
+    options: Type.TArray<Type.TObject<{
+        label: Type.TString;
+        description: Type.TString;
+        preview: Type.TOptional<Type.TString>;
+    }>>;
+    multiSelect: Type.TBoolean;
+}>;
+export declare const AskUserQuestionParams: Type.TObject<{
+    questions: Type.TArray<Type.TObject<{
+        question: Type.TString;
+        header: Type.TString;
+        options: Type.TArray<Type.TObject<{
+            label: Type.TString;
+            description: Type.TString;
+            preview: Type.TOptional<Type.TString>;
+        }>>;
+        multiSelect: Type.TBoolean;
+    }>>;
+}>;
+export type Question = Static<typeof QuestionSchema>;
+export type QuestionOption = Static<typeof QuestionOptionSchema>;
+export {};

package/dist/extensions/ask-user-question/question-schema.js

@@ -0,0 +1,31 @@
+import { Type } from 'typebox';
+const MAX_QUESTIONS = 4;
+const MIN_OPTIONS = 2;
+const MAX_OPTIONS = 4;
+const MAX_HEADER_LENGTH = 12;
+const QuestionOptionSchema = Type.Object({
+    label: Type.String({ description: 'The text of this choice, 1-5 words.' }),
+    description: Type.String({ description: 'What this choice means, or what happens if it is chosen.' }),
+    preview: Type.Optional(Type.String({ description: 'Optional text shown with the description of this choice, for example a code snippet.' })),
+});
+const QuestionSchema = Type.Object({
+    question: Type.String({ description: 'The complete question to ask. It should be specific and end with a question mark.' }),
+    header: Type.String({
+        maxLength: MAX_HEADER_LENGTH,
+        description: `A very short label shown above the question, at most ${String(MAX_HEADER_LENGTH)} characters, for example "Database".`,
+    }),
+    options: Type.Array(QuestionOptionSchema, {
+        minItems: MIN_OPTIONS,
+        maxItems: MAX_OPTIONS,
+        description: `The choices, ${String(MIN_OPTIONS)}-${String(MAX_OPTIONS)} of them. The developer can always type their own answer instead.`,
+    }),
+    multiSelect: Type.Boolean({ description: 'true when the developer may choose several options; false when exactly one fits.' }),
+});
+export const AskUserQuestionParams = Type.Object({
+    questions: Type.Array(QuestionSchema, {
+        minItems: 1,
+        maxItems: MAX_QUESTIONS,
+        description: `The questions to ask, 1-${String(MAX_QUESTIONS)}. They are asked one after another.`,
+    }),
+});
+//# sourceMappingURL=question-schema.js.map

package/dist/extensions/ask-user-question/question-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-schema.js","sourceRoot":"","sources":["../../../src/extensions/ask-user-question/question-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;IAC1E,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC;IACrG,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sFAAsF,EAAE,CAAC,CAAC;CAC7I,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mFAAmF,EAAE,CAAC;IAC3H,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,iBAAiB;QAC5B,WAAW,EAAE,wDAAwD,MAAM,CAAC,iBAAiB,CAAC,sCAAsC;KACrI,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE;QACxC,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,gBAAgB,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,mEAAmE;KAC3I,CAAC;IACF,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,kFAAkF,EAAE,CAAC;CAC/H,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;QACpC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,2BAA2B,MAAM,CAAC,aAAa,CAAC,qCAAqC;KACnG,CAAC;CACH,CAAC,CAAC"}

package/dist/extensions/commands/command-autocomplete.d.ts

@@ -0,0 +1,3 @@
+import { type AutocompleteProvider } from '@earendil-works/pi-tui';
+import type { CommandInvocable } from '../../kernel/prompt-catalog/invocable.js';
+export declare function commandAutocompleteProvider(current: AutocompleteProvider, commands: readonly CommandInvocable[]): AutocompleteProvider;