@pi-unipi/ask-user 2.19.3 → 2.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.19.3",
+  "version": "2.20.0",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.19.3"
+    "@pi-unipi/core": "2.20.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/tools.ts

@@ -19,6 +19,14 @@ import { renderLauncherUI } from "./launcher-ui.js";
 import { getAskUserSettings } from "./config.js";
 import { queueCompactHandoff, queueDirectHandoff } from "./handoff.js";
 
+/**
+ * Whether this process is a subagent child (subagents package or fusion sidekick).
+ * Subagent children never talk to the user directly — their lead owns ambiguity.
+ */
+export function isSubagentChild(env: Record<string, string | undefined> = process.env): boolean {
+  return env.UNIPI_SUBAGENT_CHILD === "1";
+}
+
 /**
  * Register ask-user tools.
  */
@@ -130,6 +138,28 @@ export function registerAskUserTools(pi: ExtensionAPI): void {
         timeout?: number;
       };
 
+      // Subagent children have no user to talk to. Refuse loudly so the
+      // subagent surfaces the question to its lead instead of guessing.
+      if (isSubagentChild()) {
+        return {
+          content: [
+            {
+              type: "text",
+              text:
+                "ask_user is not available inside a subagent. You cannot talk to the user directly — only your lead can. Do not guess or assume an answer. Stop and state the question, the options you considered, and your recommendation in your report so your lead can decide.",
+            },
+          ],
+          isError: true,
+          details: {
+            question,
+            response: {
+              kind: "cancelled",
+              comment: "ask_user is not available inside a subagent",
+            } as AskUserResponse,
+          },
+        };
+      }
+
       // Check settings
       const settings = getAskUserSettings();
       if (!settings.enabled) {