@po.dev/pi-ask-me 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# pi-ask-me
+
+Pi extension that lets the agent ask you a question and **block the turn** until you answer. Also reports that blocked state to [herdr](https://github.com/lukilev/herdr).
+
+## Install
+
+```bash
+pi install npm:@po.dev/pi-ask-me
+```
+
+Or load locally:
+
+```bash
+pi -e ./pi-ask-me/index.ts
+```
+
+## Features
+
+- `ask_me` tool — the agent asks, the turn parks on an `await` until you answer
+- Bridges Pi 0.84.4+ `ui_prompt_start` / `ui_prompt_end` → `herdr:blocked` event
+- Tool call and result render blank; the overlay already shows both
+
+## ask_me
+
+```
+question   string    the question to ask
+options    string[]  optional choices (renders a select instead of an input)
+```
+
+`executionMode: "sequential"` so the model can't batch `ask_me` with `bash`/`write` and have those side effects run before you see the prompt.
+
+## How blocking works
+
+Only these calls fire `ui_prompt_start`:
+
+```
+ctx.ui.select()  ctx.ui.confirm()  ctx.ui.input()  ctx.ui.editor()  ctx.ui.custom()
+```
+
+A plain-text agent reply does **not** block — the turn has already ended, so Pi emits no signal. "Blocked" means the code is actually parked, not that a human hasn't replied yet.
+
+## Requirements
+
+- Pi >= 0.84.4 (for the `ui_prompt_*` events)
+- herdr, only if you want the blocked state displayed somewhere

package/index.ts

@@ -0,0 +1,40 @@
+/**
+ * pi-ask-me
+ *
+ * 1. Bridges Pi 0.84.4+ ui_prompt_start/end events → herdr:blocked.
+ *    Fires when ctx.ui.select / confirm / input / editor / custom opens.
+ * 2. Registers ask_me, a tool the agent can call to block on purpose.
+ *
+ * Plain-text agent replies do NOT block — there is no Pi signal for that.
+ */
+import { Type } from "typebox";
+import { Text } from "@earendil-works/pi-tui";
+
+const blank = () => new Text("", 0, 0);
+
+export default function (pi: any) {
+	pi.on("ui_prompt_start", () => pi.events.emit("herdr:blocked", { active: true }));
+	pi.on("ui_prompt_end", () => pi.events.emit("herdr:blocked", { active: false }));
+
+	pi.registerTool({
+		name: "ask_me",
+		label: "Ask Me",
+		description: "Ask the user a question and wait for the answer. Blocks the turn until answered.",
+		promptSnippet: "Ask the user a question and block until they answer",
+		executionMode: "sequential",
+		parameters: Type.Object({
+			question: Type.String({ description: "The question to ask" }),
+			options: Type.Optional(Type.Array(Type.String(), { description: "Choices to pick from" })),
+		}),
+		async execute(_id: string, params: any, _signal: any, _onUpdate: any, ctx: any) {
+			if (!ctx.hasUI) return { content: [{ type: "text", text: "No UI available." }] };
+			const answer = params.options?.length
+				? await ctx.ui.select(params.question, params.options)
+				: await ctx.ui.input(params.question, "");
+			return { content: [{ type: "text", text: answer ?? "(cancelled)" }] };
+		},
+		// The overlay already showed the question and answer — don't log it twice.
+		renderCall: blank,
+		renderResult: blank,
+	});
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@po.dev/pi-ask-me",
+  "version": "0.1.0",
+  "description": "Report blocked state to herdr, plus an ask_me tool that blocks the turn",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "herdr",
+    "blocked",
+    "ask"
+  ],
+  "license": "MIT",
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}