@xynogen/pix-core 0.1.1 → 0.1.2

package/src/tool/ask/rpc.ts

@@ -0,0 +1,84 @@
+import type { Params } from "./schema.js";
+import { SENTINEL_FREEFORM } from "./schema.js";
+import type { QuestionAnswer, QuestionnaireResult } from "./types.js";
+
+// ── RPC / non-TUI fallback ─────────────────────────────────────────────
+// Used when ctx.hasUI is false (headless / JSON / print mode).
+
+export async function rpcFallback(
+	ui: { select: Function; input: Function },
+	params: Params,
+): Promise<QuestionnaireResult> {
+	const answers: QuestionAnswer[] = [];
+	let cancelled = false;
+
+	for (let i = 0; i < params.questions.length; i++) {
+		const q = params.questions[i]!;
+		const header = q.header;
+
+		if (q.multiSelect) {
+			const lines = q.options.map(
+				(o, idx) => `${idx + 1}. ${o.label} — ${o.description}`,
+			);
+			const raw = await ui.input(
+				`${header}: ${q.question}\n\n${lines.join("\n")}\n\nEnter numbers separated by commas:`,
+				"e.g. 1,3",
+			);
+			if (raw == null) {
+				cancelled = true;
+				break;
+			}
+			const indices = String(raw)
+				.split(",")
+				.map((s) => Number(s.trim()))
+				.filter((n) => n >= 1 && n <= q.options.length);
+			const selected = indices.map((n) => q.options[n - 1]?.label);
+			if (selected.length > 0) {
+				answers.push({
+					questionIndex: i,
+					question: q.question,
+					kind: "multi",
+					answer: null,
+					selected,
+				});
+			} else {
+				cancelled = true;
+				break;
+			}
+		} else {
+			const items = q.options.map((o) => `${o.label} — ${o.description}`);
+			items.push(SENTINEL_FREEFORM);
+			const chosen = await ui.select(`${header}: ${q.question}`, items);
+			if (chosen == null) {
+				cancelled = true;
+				break;
+			}
+			if (chosen === SENTINEL_FREEFORM) {
+				const text = await ui.input(q.question, "Type your answer...");
+				if (text == null) {
+					cancelled = true;
+					break;
+				}
+				answers.push({
+					questionIndex: i,
+					question: q.question,
+					kind: "custom",
+					answer: String(text),
+				});
+			} else {
+				const opt = q.options.find(
+					(o) =>
+						chosen === o.label || `${o.label} — ${o.description}` === chosen,
+				)!;
+				answers.push({
+					questionIndex: i,
+					question: q.question,
+					kind: "option",
+					answer: opt?.label ?? String(chosen),
+				});
+			}
+		}
+	}
+
+	return { answers, cancelled };
+}

package/src/tool/ask/schema.ts

@@ -0,0 +1,69 @@
+import { type Static, Type } from "typebox";
+
+// ── Constants ──────────────────────────────────────────────────────────
+
+export const MAX_QUESTIONS = 4;
+export const MIN_OPTIONS = 2;
+export const MAX_OPTIONS = 4;
+export const MAX_HEADER_LENGTH = 16;
+export const MAX_LABEL_LENGTH = 60;
+
+export const SENTINEL_FREEFORM = "Type something.";
+export const SENTINEL_CHAT = "Chat about this";
+export const SENTINEL_NEXT = "Next";
+
+export const SPLIT_PANE_MIN_WIDTH = 84;
+export const SEPARATOR = " │ ";
+
+// ── Schemas ────────────────────────────────────────────────────────────
+
+export const OptionSchema = Type.Object({
+	label: Type.String({
+		maxLength: MAX_LABEL_LENGTH,
+		description: `MAX ${MAX_LABEL_LENGTH} CHARACTERS. Display text for this option. Concise (1-5 words).`,
+	}),
+	description: Type.String({
+		description: "Explanation of what this option means or trade-offs.",
+	}),
+	preview: Type.Optional(
+		Type.String({
+			description:
+				"Optional markdown preview for side-by-side layout (single-select only).",
+		}),
+	),
+});
+
+export const QuestionSchema = Type.Object({
+	question: Type.String({
+		description: "Clear, specific question ending with ?",
+	}),
+	header: Type.String({
+		maxLength: MAX_HEADER_LENGTH,
+		description: `MAX ${MAX_HEADER_LENGTH} CHARS — short chip/tag. E.g. "Auth method", "Approach".`,
+	}),
+	options: Type.Array(OptionSchema, {
+		minItems: MIN_OPTIONS,
+		maxItems: MAX_OPTIONS,
+		description:
+			"2-4 options. 'Type something.' and 'Chat about this' are auto-appended.",
+	}),
+	multiSelect: Type.Optional(
+		Type.Boolean({
+			default: false,
+			description:
+				"Allow multiple selections. Suppresses 'Type something.' row.",
+		}),
+	),
+});
+
+export const QuestionsSchema = Type.Array(QuestionSchema, {
+	minItems: 1,
+	maxItems: MAX_QUESTIONS,
+	description: "1-4 questions",
+});
+
+export const ParamsSchema = Type.Object({ questions: QuestionsSchema });
+
+export type OptionData = Static<typeof OptionSchema>;
+export type QuestionData = Static<typeof QuestionSchema>;
+export type Params = Static<typeof ParamsSchema>;

package/src/tool/ask/types.ts

@@ -0,0 +1,17 @@
+// ── Answer & result types ──────────────────────────────────────────────
+
+export type AnswerKind = "option" | "custom" | "chat" | "multi";
+
+export interface QuestionAnswer {
+	questionIndex: number;
+	question: string;
+	kind: AnswerKind;
+	answer: string | null;
+	selected?: string[];
+	preview?: string;
+}
+
+export interface QuestionnaireResult {
+	answers: QuestionAnswer[];
+	cancelled: boolean;
+}

package/src/tool/toolbox/toolbox.ts

@@ -18,6 +18,7 @@ import { dirname, join } from "node:path";
 import type {
 	ExtensionAPI,
 	ExtensionContext,
+	Theme,
 	ToolInfo,
 } from "@earendil-works/pi-coding-agent";
 import { DynamicBorder, getAgentDir } from "@earendil-works/pi-coding-agent";
@@ -27,10 +28,12 @@ import {
 	fuzzyFilter,
 	Input,
 	Key,
+	type KeybindingsManager,
 	matchesKey,
 	type SelectItem,
 	SelectList,
 	Text,
+	type TUI,
 	visibleWidth,
 } from "@earendil-works/pi-tui";
 
@@ -339,7 +342,12 @@ export default function registerToolbox(pi: ExtensionAPI): void {
 		};
 	}): Promise<void> {
 		await ctx.ui.custom<null>(
-			(tui: any, theme: any, _kb: unknown, done: (r: null) => void) => {
+			(
+				tui: TUI,
+				theme: Theme,
+				_kb: KeybindingsManager,
+				done: (r: null) => void,
+			) => {
 				const accent = "accent";
 				const mute = (s: string) => theme.fg("muted", s);
 				const container = new Container();

package/src/ui/diagnostics.ts

@@ -9,7 +9,7 @@
  * Registers widget with id "pi-lens" to override external pi-lens widget.
  */
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 
 // ─── Types ────────────────────────────────────────────────────────────────────
@@ -65,10 +65,7 @@ function recordFileTouched(filePath: string): void {
 
 // ─── Render ───────────────────────────────────────────────────────────────────
 
-function renderWidget(
-	width: number,
-	theme: { fg: (color: string, s: string) => string },
-): string[] {
+function renderWidget(width: number, theme: Theme): string[] {
 	const w = Math.max(1, width || 80);
 
 	const cyan = (s: string) => theme.fg("accent", s);
@@ -117,7 +114,7 @@ export default function (pi: ExtensionAPI) {
 		if (!ctx.ui.setWidget) return;
 		ctx.ui.setWidget(
 			"pi-lens",
-			(tui: { requestRender(): void }, theme: any) => {
+			(tui, theme: Theme) => {
 				requestRenderFn = () => tui.requestRender();
 				return {
 					render: (width: number) => renderWidget(width, theme),

package/src/ui/welcome.ts

@@ -27,7 +27,10 @@
  *   ✓ Ignore  up to date
  */
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
 
 // ─── Theme shim (same pattern as footer.ts) ───────────────────────────────────
 
@@ -283,7 +286,7 @@ export default function (pi: ExtensionAPI) {
 	let dismissed = false;
 	let requestRender: (() => void) | null = null;
 
-	const dismiss = (ctx: any) => {
+	const dismiss = (ctx: ExtensionContext) => {
 		if (dismissed) return;
 		dismissed = true;
 		requestRender = null;