@howaboua/pi-ask 0.0.18 → 0.0.19

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @howaboua/pi-ask
 
+## 0.0.19
+
+- Requires Node.js 22.19 or newer.
+  - Replaced the TypeBox dependency with Pi's native schema builders and validation.
+
 ## 0.0.18
 
 - Requires Pi 1.5 or newer.

package/README.md

@@ -49,6 +49,7 @@ Set either value to `false`, then run `/reload`, to hide that template. The same
 ## TUI controls
 
 The panel uses Pi's active keybindings. The defaults are:
+
 - `Up` / `Down` — move through choices, free text, and comments
 - `Enter` — choose or edit the focused item, or save an edit
 - `Left` / `Right` — move between prompts and the review tab

package/ask/contracts.ts

@@ -1,26 +1,43 @@
-import { StringEnum } from "@earendil-works/pi-ai";
-import { type Static, Type } from "typebox";
+import {
+	arr,
+	bool,
+	lit,
+	obj,
+	oneOf,
+	opt,
+	type Static,
+	str,
+} from "@earendil-works/pi-schema";
 
 const ASK_DELIVERIES = ["wait", "steer"] as const;
 
-const ChoiceSchema = Type.Object({
-	label: Type.String(),
-	description: Type.Optional(Type.String()),
-});
-
-const PromptSchema = Type.Object({
-	title: Type.String(),
-	body: Type.Optional(Type.String()),
-	multiple: Type.Optional(Type.Boolean()),
-	choices: Type.Optional(Type.Array(ChoiceSchema)),
-});
-
-export const AskParameters = Type.Object({
-	help: Type.Optional(Type.Literal(true)),
-	handoff: Type.Optional(Type.Boolean()),
-	prompts: Type.Optional(Type.Array(PromptSchema)),
-	delivery: Type.Optional(StringEnum(ASK_DELIVERIES)),
-});
+const ChoiceSchema = obj(
+	{
+		label: str(),
+		description: opt(str()),
+	},
+	{ open: true },
+);
+
+const PromptSchema = obj(
+	{
+		title: str(),
+		body: opt(str()),
+		multiple: opt(bool()),
+		choices: opt(arr(ChoiceSchema)),
+	},
+	{ open: true },
+);
+
+export const AskParameters = obj(
+	{
+		help: opt({ ...lit(true), type: "boolean" }),
+		handoff: opt(bool()),
+		prompts: opt(arr(PromptSchema)),
+		delivery: opt({ ...oneOf(ASK_DELIVERIES), type: "string" }),
+	},
+	{ open: true },
+);
 
 export type PromptChoice = Static<typeof ChoiceSchema>;
 

package/ask/tool.ts

@@ -1,6 +1,6 @@
 import { defineTool } from "@earendil-works/pi-coding-agent";
+import { compile, type Static } from "@earendil-works/pi-schema";
 import { Text } from "@earendil-works/pi-tui";
-import { Check } from "typebox/value";
 import { AskParameters, type AskPrompt } from "./contracts.js";
 import {
 	type AskCoordinatorOptions,
@@ -16,6 +16,8 @@ import {
 	textContent,
 } from "./normalize.js";
 
+const askValidator = compile(AskParameters);
+
 interface BlockedState {
 	id: string;
 	active: boolean;
@@ -57,13 +59,19 @@ export function createAskRuntime({
 			const params = input === undefined ? {} : input;
 			const problem = askInputProblem(params);
 			if (problem) throw new Error(problem);
-			if (!Check(AskParameters, params))
+			if (!askValidator.check(params))
 				throw new Error(
 					"Ask couldn't read these arguments. Call ask({}) for the supported format.",
 				);
 			return params;
 		},
-		async execute(toolCallId, params, signal, _onUpdate, ctx) {
+		async execute(
+			toolCallId,
+			params: Static<typeof AskParameters>,
+			signal,
+			_onUpdate,
+			ctx,
+		) {
 			if (isAskHelpInput(params)) {
 				return {
 					content: [
@@ -158,8 +166,15 @@ export function createAskRuntime({
 		renderCall(args, theme, context) {
 			if (isAskHelpInput(args))
 				return new Text(theme.fg("toolTitle", theme.bold("ask help")), 0, 0);
-			const count = Array.isArray(args.prompts) ? args.prompts.length : 0;
+			const prompts =
+				args && typeof args === "object" && "prompts" in args
+					? args.prompts
+					: undefined;
+			const count = Array.isArray(prompts) ? prompts.length : 0;
 			const label =
+				args &&
+				typeof args === "object" &&
+				"handoff" in args &&
 				args.handoff === true
 					? "ask handoff "
 					: isSteeringAskInput(args)

package/biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.6.6/schema.json",
 	"vcs": {
 		"enabled": true,
 		"clientKind": "git",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howaboua/pi-ask",
-	"version": "0.0.18",
+	"version": "0.0.19",
 	"description": "Interactive decisions, review triage, and human handoffs for Pi.",
 	"type": "module",
 	"license": "MIT",
@@ -23,7 +23,7 @@
 		"handoff"
 	],
 	"engines": {
-		"node": ">=20.6.0"
+		"node": ">=22.19.0"
 	},
 	"publishConfig": {
 		"access": "public"
@@ -44,11 +44,10 @@
 		]
 	},
 	"peerDependencies": {
-		"@howaboua/pi-codex-conversion": ">=4.0.8",
+		"@howaboua/pi-codex-conversion": ">=4.0.10",
 		"@earendil-works/pi-ai": ">=1.0.0",
 		"@earendil-works/pi-coding-agent": ">=1.5.0",
-		"@earendil-works/pi-tui": ">=1.0.0",
-		"typebox": "*"
+		"@earendil-works/pi-tui": ">=1.0.0"
 	},
 	"peerDependenciesMeta": {
 		"@howaboua/pi-codex-conversion": {
@@ -56,12 +55,11 @@
 		}
 	},
 	"devDependencies": {
-		"@howaboua/pi-codex-conversion": "4.0.8",
-		"@biomejs/biome": "^2.6.3",
-		"@earendil-works/pi-ai": "1.5.0",
-		"@earendil-works/pi-coding-agent": "1.5.0",
-		"@earendil-works/pi-tui": "1.5.0",
-		"typebox": "1.4.3",
+		"@howaboua/pi-codex-conversion": "4.0.10",
+		"@biomejs/biome": "^2.6.6",
+		"@earendil-works/pi-ai": "1.5.2",
+		"@earendil-works/pi-coding-agent": "1.5.2",
+		"@earendil-works/pi-tui": "1.5.2",
 		"typescript": "^7.0.2"
 	},
 	"scripts": {
@@ -73,5 +71,8 @@
 		"pack:dry": "npm pack --dry-run"
 	},
 	"main": "index.ts",
-	"exports": "./index.ts"
+	"exports": "./index.ts",
+	"dependencies": {
+		"@earendil-works/pi-schema": "1.5.2"
+	}
 }

package/prompts/fold.md

@@ -11,6 +11,7 @@ $ARGUMENTS
 If no material follows the command, use the most recent lengthy report or structured list in the conversation.
 
 Call `ask` once with one prompt per independently decidable item:
+
 - Keep the title short.
 - Preserve concrete evidence, consequences, and recommendations in the body.
 - Use the source's natural choices. For review findings, default to Fix, Defer, and Reject.

package/prompts/grill.md

@@ -11,6 +11,7 @@ $ARGUMENTS
 Use the working directory, web search, available skills, and any relevant tools to understand the thing before asking. Prefer finding answers yourself over asking me.
 
 Loop until ask is dismissed. There is no round limit:
+
 1. Investigate the relevant context.
 2. Use ask for the next set of decisions.
 3. After the first answer round, create docs/<short-name>.md.
@@ -18,6 +19,7 @@ Loop until ask is dismissed. There is no round limit:
 5. Keep updating the markdown file after each round.
 
 The markdown file is the current plan, not a transcript. Keep it ready to use if I stop at any point. Include:
+
 - goal
 - agreed decisions
 - important tradeoffs
@@ -28,6 +30,7 @@ The markdown file is the current plan, not a transcript. Keep it ready to use if
 Do not log every question and answer.
 
 When ask is dismissed, the grilling session is done. Then:
+
 - give a short summary of what was agreed
 - open the markdown file with $EDITOR if available
 - print the file path