pi-ask-popup 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 juicesharp
+Copyright (c) 2026 derangga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# pi-ask-popup
+
+Let the model ask you instead of guessing. This Pi extension registers one tool,
+`ask_user_question`, that opens a terminal dialog of up to four questions with
+written-out options, and hands your choices back as structured data.
+
+## Install
+
+```sh
+pi install npm:pi-ask-popup
+```
+
+## What it does
+
+- **Typed options, not a wall of prose.** Each question carries 2-4 authored
+  choices, and every choice explains what it means or what it costs you.
+- **You can always answer in your own words.** A `Type something.` row is
+  appended to every question and widens to the full pane while you type.
+- **Compare artifacts, not labels.** An option can carry a markdown `preview`
+  that renders in a bordered box beside the option list.
+- **One interruption, not five.** Up to four questions arrive in a single tabbed
+  dialog, and a Submit tab names anything still blank before you commit.
+- **Notes on any answer, or on all of them.** `n` opens a note editor on any
+  question tab, and on the Submit tab it writes one note covering everything.
+  A written note stays on its tab, dimmed, and the tab bar marks which tabs
+  carry one. A note on a question you never answer still reaches the model.
+- **Read the transcript behind it.** `Ctrl+]` collapses the dialog and brings it
+  back with your answers intact.
+- **A timeout that is not a decline.** Auto-dismiss returns a distinct
+  `timed_out` result, so the model never mistakes a clock for a refusal.
+- **Works outside the terminal.** RPC and ACP hosts such as Zed or the VS Code
+  pendant walk the host's native dialogs instead.
+
+## Requirements
+
+- Node.js 22 or newer
+- Pi Agent 0.80 or newer, with an interactive terminal or an RPC/ACP host
+- A terminal at least 100 columns wide for side-by-side previews
+
+No runtime dependencies, no build step, no API keys. The extension makes no
+model calls of its own.
+
+## Credits
+
+Derived from [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question)
+by juicesharp, MIT licensed. This fork strips the `rpiv-config` and `rpiv-i18n`
+dependencies, targets Pi 0.80+, and adds a timeout.
+
+If you want something smaller, [`pi-ask-user`](https://www.npmjs.com/package/pi-ask-user)
+by Enzo Lucchesi does a comparable job in a fraction of the code, with a
+searchable split-pane selector instead of tabs and previews. Pick whichever fits.
+
+## License
+
+MIT. See [LICENSE](LICENSE) for both copyright holders.

package/docs/adr/0001-fork-rpiv-ask-user-question-as-zero-dep-pi-ask-popup.md

@@ -0,0 +1,90 @@
+# 0001 Fork rpiv-ask-user-question as the zero-dependency pi-ask-popup
+
+Pi had no Claude-Code-style questionnaire dialog, and the closest existing
+package, `pi-ask-user`, takes a different shape (a searchable split-pane
+selector, no tabs, no previews). We fork juicesharp's
+`@juicesharp/rpiv-ask-user-question`, strip it to zero runtime dependencies,
+and publish it as `pi-ask-popup` 0.1.0. These decisions were settled before any
+code was ported, so the notes below record the evidence behind them.
+
+## Identity
+
+- npm `pi-ask-popup`, unscoped, starting at 0.1.0. The name was verified free
+  on npm; `pi-ask-user` is taken by the similar package noted above.
+- The package lives at `packages/pi-ask-popup/` in this workspaces monorepo.
+  Shared tooling (tsconfig base, oxlint, oxfmt, vitest config) sits at the
+  root, and root scripts are scoped to `packages/` so the vendored reference
+  clones never get linted, formatted or tested. Pi peer dependencies are also
+  root devDependencies pinned at one exact version, so every package
+  typechecks against the same Pi while peering the wider range.
+- Author `derangga <derangga1011@gmail.com>`. The LICENSE is MIT carrying
+  juicesharp's original copyright line plus derangga's, as the MIT terms
+  require of a fork.
+- Ships raw TypeScript. Pi resolves `"pi": { "extensions": ["./src/index.ts"] }`
+  and loads it through jiti. No build step, no `dist/`. Layout is `src/` plus
+  `test/`.
+
+## Dependencies
+
+Zero runtime dependencies. Peers only: `@earendil-works/pi-coding-agent
+>=0.80`,`@earendil-works/pi-tui >=0.80`,`typebox *`.
+
+The peer is `typebox`, never `@sinclair/typebox`. Pi 0.84.4 depends on
+`typebox@1.3.7`; the old name is a different package that Pi never loads, so
+peering it would silently resolve to something unused.
+
+## Considered options
+
+**Effect, rejected.** `effect@3.22.1` is 27 MB unpacked, larger than Pi's own
+coding agent, against a zero-dep goal and a 114 kB competitor. Effect v4,
+which the house style targets, is still a release candidate with no stable
+release. The ported code has three async edges in total, so failure is
+modeled as tagged unions instead: Effect-shaped, no import.
+
+**rpiv-config and rpiv-i18n, dropped.** The fork drops both dependencies, the
+i18n bridge, all nine locale files, and their tests. The 2-second prewarm
+timer goes with them.
+
+**Kept.** The pure reducer and key router, the tabbed multi-question dialog,
+the Submit review tab, side-by-side markdown previews, multi-select with the
+`Next` row, the appended `Type something.` row, per-question and global
+notes, collapse mode on `Ctrl+]`, the RPC/ACP dialog walker, the `no_ui`,
+`no_custom_ui`, `session_load_failed` and `stale_module_cache` envelopes, and
+every test covering a surviving feature.
+
+## Pi compatibility
+
+Verified by diffing the published `.d.ts` of Pi 0.80.6 and 0.84.4:
+
+- `ui.select`, `ui.input`, `ui.custom`, `ui.onTerminalInput`, `ctx.mode` and
+  `ctx.hasUI` are identical in both versions.
+- `OverlayHandle` (hide/setHidden/isHidden/focus/unfocus) is byte-identical at
+  the same line numbers in pi-tui 0.80.6 and 0.84.4, so collapse mode ports
+  untouched.
+- 137 lines changed elsewhere in `core/extensions/types.d.ts` between the
+  versions; none are in the surface this package uses. The `>=0.80` peer
+  range is therefore safe.
+- `ExtensionUIDialogOptions` already carries `timeout?: number`, documented
+  as auto-dismissing with a live countdown display, in both versions. The RPC
+  path passes timeout through; only the TUI overlay needs a hand-built clock.
+
+## Added
+
+`timeout`, with a distinct `timed_out` result that is never folded into
+`cancelled`. The reasoning matches why `no_custom_ui` is its own envelope: a
+timeout is not a decline, and the model must not read it as one.
+
+## Consequences
+
+The two load-failure envelopes stay even though the prewarm timer goes. jiti
+is pinned at 2.7.0 in both Pi versions, so the cache-poisoning bug they guard
+against is still live: a failed import stays registered in the module graph
+cache and poisons every later import for the process lifetime.
+
+Out of scope: no searchable option filter (the schema caps options at four),
+no cross-session answer memory, no CI, no changesets, no built `dist/`, and
+no raised caps on questions or options.
+
+One question is deliberately deferred. The `"Other"` label stays in the
+reserved-label list purely because Claude Code conditions models to reach for
+it. It is worth keeping only as long as tool-name parity is the goal.

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "pi-ask-popup",
+  "version": "0.1.0",
+  "description": "Pi extension. A tabbed terminal questionnaire the model can put to you when it would otherwise guess, with typed options, markdown previews and notes instead of free-form replies.",
+  "type": "module",
+  "license": "MIT",
+  "author": "derangga <derangga1011@gmail.com>",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "pi-coding-agent",
+    "ask",
+    "ask-user-question",
+    "questionnaire",
+    "dialog",
+    "tui"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./events": "./src/events.ts"
+  },
+  "files": [
+    "src/",
+    "docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.80",
+    "@earendil-works/pi-tui": ">=0.80",
+    "typebox": "*"
+  }
+}