@xynogen/pix-ask 0.2.21 → 0.2.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +8 -2
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -4,9 +4,15 @@ Pi tool — structured questionnaire UI (`ask_user`).
4
4
 
5
5
  ## What it does
6
6
 
7
- Registers the `ask_user` tool in Pi. When the agent needs to resolve ambiguous requirements, it presents up to 4 structured multiple-choice questions in a TUI dialog. Each question requires 2–4 options with labels and descriptions; supports multi-select and markdown side-by-side previews for richer context. Single-select questions (without a preview) auto-append a "Type something." row for free-form input; multi-select questions append a "Next" row to advance. Single-select questions with a `preview` skip the free-form row to make room for the side-by-side layout. In non-interactive (RPC/JSON) mode, falls back to text-based prompts. The agent uses this tool before proceeding rather than guessing at intent.
7
+ Registers the `ask_user` tool up to 4 structured multiple-choice questions in a TUI dialog when the agent needs to resolve ambiguous requirements, instead of guessing.
8
8
 
9
- While the dialog is open, `ask_user` holds the shared **agent-state** coordinator in the `blocked` state (via `withAgentBlock` from [`@xynogen/pix-runtime`](https://www.npmjs.com/package/@xynogen/pix-runtime)). Inside a herdr pane that transition fires a "needs attention" notification, so a user away from the terminal is pinged when a question is waiting.
9
+ - Each question: 2–4 options with labels + descriptions. Supports multi-select and markdown side-by-side previews.
10
+ - **Single-select** (no preview) → appends a "Type something." free-form row.
11
+ - **Single-select with `preview`** → skips the free-form row to fit the side-by-side layout.
12
+ - **Multi-select** → appends a "Next" row to advance.
13
+ - Non-interactive (RPC/JSON) mode falls back to text prompts.
14
+
15
+ **Away notifications** — while the dialog is open, `ask_user` holds the shared **agent-state** coordinator `blocked` (via `withAgentBlock` from [`@xynogen/pix-runtime`](https://www.npmjs.com/package/@xynogen/pix-runtime)), so a herdr pane pings an away user when a question waits.
10
16
 
11
17
  ## Install
12
18
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xynogen/pix-ask",
3
- "version": "0.2.21",
3
+ "version": "0.2.23",
4
4
  "description": "Pi tool — structured questionnaire UI (ask_user)",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
@@ -36,7 +36,7 @@
36
36
  },
37
37
  "dependencies": {
38
38
  "@xynogen/pix-pretty": "^1.11.2",
39
- "@xynogen/pix-runtime": "^0.7.0",
39
+ "@xynogen/pix-runtime": "^0.8.0",
40
40
  "typebox": "^1.1.38"
41
41
  },
42
42
  "peerDependencies": {