@ssk_dev/rpiv-ask-user-question-lean 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kunkun9527
+
+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,59 @@
+# @ssk_dev/rpiv-ask-user-question-lean
+
+> **Lean Pi ask-user-question plugin, same functionality — 215 initialization tokens, 83% fewer than the original.**
+> [See my full setup for Pi](https://github.com/kunkun9527/my-lean-pi-setup)
+
+[简体中文](README.zh-CN.md)
+
+A token-lean Pi wrapper around [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question). It preserves structured clarification while reducing model-facing metadata.
+
+## What it keeps
+
+- The questionnaire UI and RPC fallback.
+- Input validation, events, and lifecycle behavior.
+- Single-select and multi-select questions, recommendation ordering, and useful previews.
+
+## Why it is lean
+
+The wrapper keeps the upstream `ask_user_question` runtime but shortens its tool description and prompt guidance and removes repeated schema descriptions. The complete questionnaire behavior still comes from the pinned upstream package.
+
+## Install
+
+```bash
+pi install npm:@ssk_dev/rpiv-ask-user-question-lean
+```
+
+Do not load it together with another `rpiv-ask-user-question` wrapper, or the tool may be registered twice.
+
+## Use
+
+The model sees one tool:
+
+```text
+ask_user_question
+```
+
+Use it when a required user decision is unclear. Each call can ask 1–4 structured questions with 2–4 explicit options per question.
+
+## Measured initialization footprint
+
+With only this extension enabled, the lean `ask_user_question` tool contributes an estimated **215 tokens** of recurring model-facing initialization context. The pinned upstream `@juicesharp/rpiv-ask-user-question@2.4.0` tool contributes **1,258 tokens** under the same conditions. That is **1,043 fewer tokens (82.9%)**.
+
+The measurement used Pi 0.84.4 and `pi-context-view@0.4.3` in a fresh isolated session, excluding Pi built-in tools, skills, context files, messages, and unrelated extensions. Context View estimates text as `ceil(characters / 4)`, so these are reproducible context-footprint estimates rather than exact GPT tokenizer counts. Runtime-only UI and slash commands are not included because they are not sent to the model.
+
+## Versions
+
+The upstream runtime is pinned to `@juicesharp/rpiv-ask-user-question@2.4.0`.
+
+## Development
+
+```bash
+npm ci
+npm run check
+```
+
+The test suite uses a local harness and does not open the real questionnaire UI.
+
+## License and upstream
+
+MIT. This project wraps the MIT-licensed [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question).

package/README.zh-CN.md

@@ -0,0 +1,59 @@
+# @ssk_dev/rpiv-ask-user-question-lean
+
+> **Lean Pi ask-user-question 插件，功能相同：215 个初始化 tokens，较原插件减少 83%。**
+> **整套配置：** [查看 Pi Lean Setup](https://github.com/kunkun9527/my-lean-pi-setup)
+
+[English](README.md)
+
+[`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question) 的 token 精简版 Pi 包装层。它保留结构化需求确认能力，同时减少模型可见元数据。
+
+## 保留的能力
+
+- 问卷 UI 和 RPC fallback。
+- 输入验证、事件和生命周期行为。
+- 单选、多选、推荐项排序和有用的预览。
+
+## 为什么更精简
+
+包装层保留上游 `ask_user_question` 运行时，但缩短工具描述和提示指引，并删除重复的 schema 描述。完整问卷行为仍由固定版本的上游包提供。
+
+## 安装
+
+```bash
+pi install npm:@ssk_dev/rpiv-ask-user-question-lean
+```
+
+不要同时加载另一个 `rpiv-ask-user-question` 包装层，否则工具可能被重复注册。
+
+## 使用
+
+模型只看到一个工具：
+
+```text
+ask_user_question
+```
+
+当必要的用户决策不明确时使用它。每次调用可以询问 1–4 个结构化问题，每个问题提供 2–4 个明确选项。
+
+## 实测初始化上下文占用
+
+仅启用本扩展时，lean `ask_user_question` 工具会贡献约 **215 tokens** 的持续模型可见初始化上下文。相同条件下，固定版本的上游 `@juicesharp/rpiv-ask-user-question@2.4.0` 工具贡献 **1,258 tokens**，即减少 **1,043 tokens（82.9%）**。
+
+测量使用 Pi 0.84.4 和 `pi-context-view@0.4.3`，在全新隔离会话中只启用目标扩展，并排除 Pi 内置工具、skills、context files、消息及无关扩展。Context View 按 `ceil(字符数 / 4)` 估算，因此这些是可复现的上下文占用估值，不是 GPT tokenizer 的精确计数。未计入不会发送给模型的纯运行时 UI 和 slash commands。
+
+## 版本
+
+上游运行时固定为 `@juicesharp/rpiv-ask-user-question@2.4.0`。
+
+## 开发
+
+```bash
+npm ci
+npm run check
+```
+
+测试套件使用本地 harness，不会打开真实问卷 UI。
+
+## 许可证与上游
+
+MIT。本项目包装了采用 MIT 许可证的 [`@juicesharp/rpiv-ask-user-question`](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question)。

package/index.ts

@@ -0,0 +1,54 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import askUserQuestion from "@juicesharp/rpiv-ask-user-question";
+
+const TOOL_DESCRIPTION =
+	"Ask 1-4 structured questions when a required user decision is unclear.";
+
+const PROMPT_SNIPPET = "";
+
+const PROMPT_GUIDELINES = [
+	"Each question needs 2-4 options. Put recommendations first with (Recommended); never add Other or Type something. Use multiSelect only for nonexclusive choices and preview only for useful single-select visual comparisons.",
+];
+
+function removeSchemaDescriptions(value: unknown, seen = new Set<object>()): void {
+	if (value === null || typeof value !== "object" || seen.has(value)) return;
+	seen.add(value);
+
+	const record = value as Record<string, unknown>;
+	delete record.description;
+	for (const [key, child] of Object.entries(record)) {
+		if (key === "properties" && child !== null && typeof child === "object") {
+			for (const propertySchema of Object.values(child as Record<string, unknown>)) {
+				removeSchemaDescriptions(propertySchema, seen);
+			}
+			continue;
+		}
+		removeSchemaDescriptions(child, seen);
+	}
+}
+
+export default function (pi: ExtensionAPI): void {
+	const leanPi = new Proxy(pi, {
+		get(target, property) {
+			if (property === "registerTool") {
+				return (tool: Parameters<ExtensionAPI["registerTool"]>[0]) => {
+					if (tool.name === "ask_user_question") {
+						removeSchemaDescriptions(tool.parameters);
+						return target.registerTool({
+							...tool,
+							description: TOOL_DESCRIPTION,
+							promptSnippet: PROMPT_SNIPPET,
+							promptGuidelines: PROMPT_GUIDELINES,
+						});
+					}
+					return target.registerTool(tool);
+				};
+			}
+
+			const member = Reflect.get(target, property, target);
+			return typeof member === "function" ? member.bind(target) : member;
+		},
+	});
+
+	askUserQuestion(leanPi);
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ssk_dev/rpiv-ask-user-question-lean",
+  "version": "2.4.0",
+  "type": "module",
+  "description": "Lean Pi ask-user-question plugin, same functionality — 215 initialization tokens, 83% fewer than the original.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "kunkun9527",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kunkun9527/rpiv-ask-user-question-lean.git"
+  },
+  "homepage": "https://github.com/kunkun9527/rpiv-ask-user-question-lean#readme",
+  "bugs": {
+    "url": "https://github.com/kunkun9527/rpiv-ask-user-question-lean/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "rpiv",
+    "ask-user-question",
+    "token-efficient"
+  ],
+  "files": [
+    "index.ts",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "typecheck": "tsc -p tsconfig.json",
+    "check": "npm run typecheck && npm test"
+  },
+  "dependencies": {
+    "@juicesharp/rpiv-ask-user-question": "2.4.0",
+    "@juicesharp/rpiv-i18n": "2.7.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.84.1 <1.0.0",
+    "@earendil-works/pi-tui": ">=0.84.1 <1.0.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.3",
+    "@earendil-works/pi-tui": "0.84.3",
+    "jiti": "2.7.0",
+    "typescript": "5.9.3"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}