@howaboua/pi-ask 0.0.1 → 0.0.3

package/README.md

@@ -20,6 +20,8 @@ The agent can present several independently decidable prompts in one tabbed pane
 
 For work only you can complete—sign-in, authorization, hardware access, or another manual step—the agent can open a handoff and wait until you mark it done or unable to complete.
 
+When Pi runs inside Herdr with its Pi integration installed, an open ask panel marks the pane as blocked until you submit, dismiss, or abort it.
+
 `Other/rephrase` is always available. Submit it blank when the prompt needs to be rephrased, split, or followed up instead of answered as written.
 
 ## Prompt commands

package/ask/tool.ts

@@ -15,10 +15,19 @@ type AskInComposer = (
 	signal: AbortSignal | undefined,
 ) => Promise<unknown>;
 
+interface BlockedState {
+	active: boolean;
+	label: string;
+}
+
+type OnBlockedChange = (state: BlockedState) => void;
+
 export function createAskTool({
 	askInComposer,
+	onBlockedChange,
 }: {
 	askInComposer?: AskInComposer;
+	onBlockedChange?: OnBlockedChange;
 } = {}) {
 	return defineTool({
 		name: "ask",
@@ -26,7 +35,7 @@ export function createAskTool({
 		description:
 			"Request user input or action and return the response. Requires interactive UI.",
 		parameters: AskParameters,
-		promptSnippet: "ask: Request human input or action.",
+		promptSnippet: "Request human input or action.",
 		promptGuidelines: [
 			"ask: Use for needed user decisions or input; set handoff true for a user-only action and state its completion signal.",
 			"ask: For reviews, make each finding a prompt with disposition choices; do not report first.",
@@ -43,17 +52,27 @@ export function createAskTool({
 			if (!askInComposer && !ctx.hasUI)
 				throw new Error("ask requires an interactive UI.");
 
-			const rawResponses = askInComposer
-				? await askInComposer(prompts, signal)
-				: ctx.mode === "tui"
-					? await askInTui(ctx, prompts, {
-							handoff,
-							...(signal ? { signal } : {}),
-						})
-					: await askWithPiUi(ctx, prompts, {
-							handoff,
-							...(signal ? { signal } : {}),
-						});
+			const blockedState = {
+				active: true,
+				label: handoff ? "Human action needed" : "Waiting for input",
+			};
+			onBlockedChange?.(blockedState);
+			let rawResponses: unknown;
+			try {
+				rawResponses = askInComposer
+					? await askInComposer(prompts, signal)
+					: ctx.mode === "tui"
+						? await askInTui(ctx, prompts, {
+								handoff,
+								...(signal ? { signal } : {}),
+							})
+						: await askWithPiUi(ctx, prompts, {
+								handoff,
+								...(signal ? { signal } : {}),
+							});
+			} finally {
+				onBlockedChange?.({ ...blockedState, active: false });
+			}
 			const responses = normalizeResponses(prompts, rawResponses);
 			if (!responses) {
 				return {

package/index.ts

@@ -9,7 +9,11 @@ export { createAskTool } from "./ask/tool.js";
 const PROMPTS_DIR = join(dirname(fileURLToPath(import.meta.url)), "prompts");
 
 export default function humanInTheLoop(pi: ExtensionAPI): void {
-	pi.registerTool(createAskTool());
+	pi.registerTool(
+		createAskTool({
+			onBlockedChange: (state) => pi.events.emit("herdr:blocked", state),
+		}),
+	);
 	pi.on("resources_discover", () => {
 		const config = loadAskConfig();
 		return {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howaboua/pi-ask",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "Interactive decisions, review triage, and human handoffs for Pi.",
 	"type": "module",
 	"license": "MIT",