@henryqw/pi-ask-question 0.2.3 → 0.2.5

package/README.md

@@ -1,13 +1,13 @@
 # `@henryqw/pi-ask-question`
 
-Ask the user one interactive question with up to three choices, or a custom answer.
+Pause Pi for one clear user choice, with up to three options or a custom answer.
 
 ![Pi asking the user to choose a database](./example.png)
 
 ## Why
 
-- **Created for**: Ask the user one interactive question with up to three choices during a Pi session.
-- **Advantage**: Show a keyboard-selectable prompt and return one explicit answer instead of parsing free-form chat.
+- **Created for**: Agents and extensions that need one decision before they continue.
+- **Advantage**: A keyboard-selectable prompt returns an explicit answer without parsing free-form chat.
 
 ## Install
 
@@ -17,7 +17,7 @@ pi install npm:@henryqw/pi-ask-question
 
 ## Use
 
-Use `ask_question` to pause for one interactive answer.
+Call `ask_question` to pause for one interactive answer. Pi shows the choices and returns the selected or custom answer.
 
 ```json
 {
@@ -36,4 +36,6 @@ Use `ask_question` to pause for one interactive answer.
 
 The tool returns an error for empty questions, blank or duplicate labels, empty lists, more than three options, and non-interactive sessions. Aborting the tool closes the pending question.
 
+While an interactive TUI question is open, the tool publishes `herdr:blocked` with the `Input required` label. It clears the status after completion, cancellation, or failure.
+
 Extensions can reuse the validated interaction with `askQuestion(params, ctx, signal)`. This package export returns the tool's answer details without registering another UI flow.

package/extensions/ask-question.ts

@@ -31,20 +31,26 @@ export default function askQuestionExtension(pi: ExtensionAPI): void {
 		executionMode: "sequential",
 
 		async execute(_toolCallId, params, signal, _onUpdate, ctx) {
-			const details = await askQuestion(params, ctx, signal);
-			return {
-				content: [{
-					type: "text" as const,
-					text: details.error
-						? `Error: ${details.error}`
-						: !details.answer
-							? "User cancelled question"
-							: details.wasCustom
-								? `User wrote: ${details.answer}`
-								: `User selected: ${details.selectedIndex}. ${details.answer}`,
-				}],
-				details,
-			};
+			const interactive = ctx.mode === "tui";
+			try {
+				if (interactive) pi.events.emit("herdr:blocked", { active: true, label: "Input required" });
+				const details = await askQuestion(params, ctx, signal);
+				return {
+					content: [{
+						type: "text" as const,
+						text: details.error
+							? `Error: ${details.error}`
+							: !details.answer
+								? "User cancelled question"
+								: details.wasCustom
+									? `User wrote: ${details.answer}`
+									: `User selected: ${details.selectedIndex}. ${details.answer}`,
+					}],
+					details,
+				};
+			} finally {
+				if (interactive) pi.events.emit("herdr:blocked", { active: false });
+			}
 		},
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-ask-question",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Ask Pi users one interactive question with choices or a custom answer.",
   "keywords": [
     "pi-package",