pi-ask-questions 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-10-15
+
+### Fixed
+
+- A background questionnaire (`noWait: true`) that fails to open now reports the failure to the user with an error notification instead of failing silently. The background slot is still released so later calls can open a new questionnaire.
+
+### Documentation
+
+- Documented the `pending` shape of `structuredContent`: while a background questionnaire is open, each `answers[]` entry is a stub with an empty `answers` array, so consumers must branch on `pending` before reading answers.
+
 ## [0.2.0] - 2026-10-15
 
 ### Changed

package/README.md

@@ -132,6 +132,12 @@ Notes: (skipped)
 | `questions[].otherLabel` | string | Custom label for the typed-answer entry. |
 | `noWait` | boolean | Show the questionnaire in the background and return immediately (interactive TUI only). The answers arrive as a follow-up message. Only one background questionnaire can be open at a time. |
 
+### Structured results
+
+`structuredContent` mirrors the answers for codemode scripts: `cancelled`, an optional `pending`, and `answers[]` with `{ id, question, skipped, answers: [{ value, label, custom }] }`.
+
+While a background questionnaire is open, `pending` is `true` and each `answers[]` entry is a stub with an empty `answers` array. Branch on `pending` before reading them; the real answers arrive as a follow-up message.
+
 ### Keyboard reference
 
 | Keys | Action |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-ask-questions",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"description": "Interactive questionnaires for Pi: tabs, multi-select, free-form typing, validation, and structured answers.",
 	"keywords": [
 		"pi-package",

package/src/extension.ts

@@ -175,8 +175,19 @@ export default function askQuestionsExtension(pi: ExtensionAPI): void {
 							{ triggerTurn: true, deliverAs: "followUp" },
 						);
 					})
-					.catch(() => {
-						// The questionnaire could not be shown; there is nothing to deliver.
+					.catch((error: unknown) => {
+						// The questionnaire could not be shown. The tool result already told
+						// the model it was pending, so surface the failure to the user
+						// instead of leaving everyone waiting for answers that never come.
+						const reason = error instanceof Error ? error.message : String(error);
+						try {
+							ctx.ui.notify(
+								`ask_user could not show the background questionnaire: ${reason}`,
+								"error",
+							);
+						} catch {
+							// Reporting is best-effort; the background slot still clears.
+						}
 					})
 					.finally(() => {
 						if (backgroundController === controller) {