pi-agent-flow 2.0.1 → 2.0.5

package/dist/steering/flow-prompt.d.ts

@@ -3,8 +3,8 @@
  *
  * Extracted from index.ts for single-responsibility and testability.
  */
-import type { FlowConfig } from "../core/agents.js";
-import type { FlowDepthConfig } from "../core/depth.js";
+import type { FlowConfig } from "../flow/agents.js";
+import type { FlowDepthConfig } from "../flow/depth.js";
 export interface BeforeAgentStartEvent {
     prompt: string;
     systemPrompt: string;
@@ -13,12 +13,12 @@ export declare function computeActiveTools(optimize: boolean): string[];
 /**
  * Build the before_agent_start system prompt augmentation.
  *
- * Adds web steering (when tool optimize is off) and the flow delegation
+ * Adds web steering (when tool optimize is off) and the flow transition
  * guide with guard info. The steering hint is NOT included here — it
  * is injected dynamically by the context hook in index.ts.
  *
  * Returns the augmented systemPrompt, or undefined if the child flow
  * should skip this handler.
  */
-export declare function buildBeforeAgentStartPrompt(event: BeforeAgentStartEvent, toolOptimize: boolean, canDelegate: boolean, discoveredFlows: FlowConfig[], depthConfig: FlowDepthConfig): string | undefined;
+export declare function buildBeforeAgentStartPrompt(event: BeforeAgentStartEvent, toolOptimize: boolean, canTransition: boolean, discoveredFlows: FlowConfig[], depthConfig: FlowDepthConfig): string | undefined;
 //# sourceMappingURL=flow-prompt.d.ts.map

package/dist/steering/flow-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-prompt.d.ts","sourceRoot":"","sources":["../../src/steering/flow-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAI9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,UAAU,EAAE,EAC7B,WAAW,EAAE,eAAe,GAC1B,MAAM,GAAG,SAAS,CAyFpB"}
+{"version":3,"file":"flow-prompt.d.ts","sourceRoot":"","sources":["../../src/steering/flow-prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAI9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,UAAU,EAAE,EAC7B,WAAW,EAAE,eAAe,GAC1B,MAAM,GAAG,SAAS,CAsEpB"}

package/dist/steering/flow-prompt.js

@@ -3,14 +3,14 @@
  *
  * Extracted from index.ts for single-responsibility and testability.
  */
-import { looksLikeUrlPrompt, looksLikeWebSearchPrompt, } from "../tools/web-tool.js";
+import { looksLikeUrlPrompt, looksLikeWebSearchPrompt, } from "../tools/web-ops.js";
 // ---------------------------------------------------------------------------
 // Active tools helper
 // ---------------------------------------------------------------------------
 export function computeActiveTools(optimize) {
     return optimize
-        ? ["batch_read", "flow", "web", "ask_user"]
-        : ["read", "write", "edit", "batch", "bash", "flow", "web", "ask_user"];
+        ? ["batch_read", "flow", "trace", "ask_user"]
+        : ["read", "write", "edit", "batch", "bash", "flow", "trace", "ask_user"];
 }
 // ---------------------------------------------------------------------------
 // System prompt builder
@@ -18,24 +18,24 @@ export function computeActiveTools(optimize) {
 /**
  * Build the before_agent_start system prompt augmentation.
  *
- * Adds web steering (when tool optimize is off) and the flow delegation
+ * Adds web steering (when tool optimize is off) and the flow transition
  * guide with guard info. The steering hint is NOT included here — it
  * is injected dynamically by the context hook in index.ts.
  *
  * Returns the augmented systemPrompt, or undefined if the child flow
  * should skip this handler.
  */
-export function buildBeforeAgentStartPrompt(event, toolOptimize, canDelegate, discoveredFlows, depthConfig) {
+export function buildBeforeAgentStartPrompt(event, toolOptimize, canTransition, discoveredFlows, depthConfig) {
     const { currentDepth, maxDepth, ancestorFlowStack, preventCycles } = depthConfig;
     const prompt = event.prompt;
     const hasUrl = looksLikeUrlPrompt(prompt);
     const likelyNeedsWeb = looksLikeWebSearchPrompt(prompt);
     const webInstructions = [];
     if (hasUrl) {
-        webInstructions.push("The prompt includes a URL. Use web tool with op: { o: 'fetch', u: '<url>' } before answering about that page.");
+        webInstructions.push("The prompt includes a URL. Use batch with w: [{ o: 'fetch', u: '<url>' }] before answering about that page.");
     }
     if (likelyNeedsWeb) {
-        webInstructions.push("The prompt likely needs external or current info. Prefer web tool with op: [{ o: 'search', q: '<query>' }] over memory.");
+        webInstructions.push("The prompt likely needs external or current info. Prefer batch with w: [{ o: 'search', q: '<query>' }] over memory.");
     }
     let systemPrompt = event.systemPrompt;
     if (!toolOptimize && webInstructions.length > 0) {
@@ -43,7 +43,7 @@ export function buildBeforeAgentStartPrompt(event, toolOptimize, canDelegate, di
             "\n\n## pi-web steering\n" +
                 webInstructions.map((line) => `- ${line}`).join("\n");
     }
-    if (!canDelegate || discoveredFlows.length === 0) {
+    if (!canTransition || discoveredFlows.length === 0) {
         return systemPrompt;
     }
     const flowList = discoveredFlows
@@ -52,7 +52,7 @@ export function buildBeforeAgentStartPrompt(event, toolOptimize, canDelegate, di
         return `- [${f.name}]${badge} — ${f.description}`;
     })
         .join("\n");
-    // Orchestrator gets the full guide; child flows get a minimal version
+    // Root state gets the full guide; child flows get a minimal version
     if (currentDepth > 0) {
         return (systemPrompt +
             `\n\n## Flows\n${flowList}\n\n` +
@@ -61,43 +61,24 @@ export function buildBeforeAgentStartPrompt(event, toolOptimize, canDelegate, di
     return (systemPrompt +
         `\n\n## Flows
 
-Before acting, reason about whether to dive into a flow:
+Reason about whether to dive into a flow before acting:
+- [trace] Fast code verification / snap user Q&A.
+- [scout] Deep dive / architecture mapping / bash execution.
+- [build] Implementation / verification (already clear).
 
 ${flowList}
 
-Multiple independent flows? Batch them into one call:
+Batch independent flows: { "flow": [{ "type": "scout", "intent": "..." }, { "type": "audit", "intent": "..." }] }
 
-{ "flow": [{ "type": "scout", "intent": "Map auth and trace JWT", "aim": "Map auth and trace JWT" }, { "type": "audit", "intent": "Audit user route security", "aim": "Audit user route security" }] }
-Two separate calls — wastes time
-
-Each call renders as:
-
-• flow [scout] — Map the full directory structure...
-• flow [audit] — Audit security and quality, then fix safe issues...
-
-Each flow returns a structured result:
-
-flow [type] accomplished
-
-summary — what happened and current status
-files — files touched, read, or referenced
-actions — what was done, with results and evidence
-commands — commands or tool calls executed (auto-extracted from tool history)
-notDone — incomplete items, skipped checks, blockers, and reasons
-nextSteps — specific recommended follow-up or next flow
-reasoning — key hypotheses or inferences made during the flow
-notes — observations, warnings, caveats
+Results: summary, files, actions, commands, notDone, nextSteps, reasoning, notes.
 
 ### Guards
 - Depth: ${currentDepth}/${maxDepth} | Cycles: ${preventCycles ? "blocked" : "off"} | Stack: ${ancestorFlowStack.length > 0 ? ancestorFlowStack.join(" -> ") : "(root)"}
 
 ### Shared Context
-Child flows fork your session automatically:
-
-- They receive a sanitized snapshot of your conversation — files read, commands run, prior flow results.
-- Prior flow tool results are **compressed** into compact summaries (files touched, commands used, status).
-- Write 'intent' as a **forward-looking mission** — reference what the child already sees, don't re-describe it.
-- Set inheritContext: false in a custom flow's front-matter to start with a **clean slate** (no inherited context).
+Child flows fork a sanitized snapshot (files read, commands, compressed results).
+Write 'intent' as a **forward-looking mission**.
+Set inheritContext: false for a clean slate.
 `);
 }
 //# sourceMappingURL=flow-prompt.js.map

package/dist/steering/flow-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow-prompt.js","sourceRoot":"","sources":["../../src/steering/flow-prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flow-prompt.js","sourceRoot":"","sources":["../../src/steering/flow-prompt.ts"],"names":[],"mappings":"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"}

package/dist/steering/sliding-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sliding-prompt.d.ts","sourceRoot":"","sources":["../../src/steering/sliding-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,eAAO,MAAM,sBAAsB,QAAuD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,QAAwD,CAAC;AAE7F,eAAO,MAAM,aAAa,QAYG,CAAC;AAgB9B,yEAAyE;AACzE,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAkBtE,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,yEAAyE;AACzE,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GACjD,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAU5C;AAED,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAW/E;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAc3D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAoBrG;AAQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAU1E"}
+{"version":3,"file":"sliding-prompt.d.ts","sourceRoot":"","sources":["../../src/steering/sliding-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,eAAO,MAAM,sBAAsB,QAAuD,CAAC;AAC3F,eAAO,MAAM,uBAAuB,QAAwD,CAAC;AAE7F,eAAO,MAAM,aAAa,QAaG,CAAC;AAgB9B,yEAAyE;AACzE,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAkBtE,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,yEAAyE;AACzE,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GACjD,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAU5C;AAED,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAW/E;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAc3D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAoBrG;AAQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE3F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAU1E"}

package/dist/steering/sliding-prompt.js

@@ -13,16 +13,17 @@ const STEERING_HINT_UUID = randomUUID();
 export const STEERING_HINT_OPEN_TAG = `<pi-flow-steering-hint id="${STEERING_HINT_UUID}">`;
 export const STEERING_HINT_CLOSE_TAG = `</pi-flow-steering-hint id="${STEERING_HINT_UUID}">`;
 export const STEERING_HINT = `${STEERING_HINT_OPEN_TAG}\n` +
-    `You are the orchestrator. You have batch_read, flow, web, and ask_user.\n` +
-    `You do NOT have bash or write. Delegate all implementation to flows.\n\n` +
-    `- Context: Answer directly if possible; otherwise, investigate first, then delegate.\n` +
+    `You are in the primary flow. You have batch_read, flow, and ask_user.\n` +
+    `You do NOT have bash or write. Dive into dedicated flow states to complete your mission.\n\n` +
+    `- Context: Answer directly if possible; otherwise, investigate first, then transition.\n` +
     `- Acts: [Route all git, bash, CLI, or terminal tasks to \`build\` flow, For major conflicts or misaligned goals use ask_user, For lengthy plans with many steps use ask_user to confirm main points before proceeding]\n` +
-    `- Mindset: Gather context before acting. Investigate, discuss, plan — then delegate.\n` +
-    `- Anti-patterns: [Never implement directly, Never ask what you can discover with tools, Never skip investigation]\n` +
-    `- Workflow: Scouts must complete 5 steps (Survey → Inspect → Trace → Report → Validate). Reject and resend if Validate is missing. For quick directional signals use sessionMode snap (90s sprint).\n` +
+    `- Mindset: Gather context before acting. Investigate, discuss, plan — then transition.\n` +
+    `- Anti-patterns: [Never perform complex implementation in the primary flow, Never ask what you can discover with tools, Never skip investigation]\n` +
+    `- Workflow: Scouts must complete 5 steps (Survey → Inspect → Trace → Report → Validate). Reject and resend if Validate is missing. For quick directional signals use complexity snap (120s sprint).\n` +
     `- Markers: Preserve exactly ([V] Verified, [I] Inferred, [A] Assumed, [U] Unknown). Never present [A] or [U] as facts to the user. Dispatch a validation scout if critical claims are [A]/[U].\n` +
     `- Output: Zero preamble or filler. Start immediately with the answer or tool call.\n` +
-    `Note: Context is inherited automatically for child flow; write intents focusing only on new work.\n` +
+    `For complex or uncertain tasks, set complexity to moderate+ for automatic audit cycles, or override auditLoop explicitly. Default auditLoop is 0 (no auto-review unless complexity implies it).\n` +
+    `Note: Context is inherited automatically for flow state; write intents focusing only on new work.\n` +
     `${STEERING_HINT_CLOSE_TAG}`;
 const STEERING_HINT_RE = new RegExp(STEERING_HINT_OPEN_TAG.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") +
     "[\\s\\S]*?" +

package/dist/steering/sliding-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"sliding-prompt.js","sourceRoot":"","sources":["../../src/steering/sliding-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,UAAU,EAAE,CAAC;AAExC,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,kBAAkB,IAAI,CAAC;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,+BAA+B,kBAAkB,IAAI,CAAC;AAE7F,MAAM,CAAC,MAAM,aAAa,GACzB,GAAG,sBAAsB,IAAI;IAC7B,2EAA2E;IAC3E,0EAA0E;IAC1E,wFAAwF;IACxF,0NAA0N;IAC1N,wFAAwF;IACxF,qHAAqH;IACrH,uMAAuM;IACvM,kMAAkM;IAClM,sFAAsF;IACtF,qGAAqG;IACrG,GAAG,uBAAuB,EAAE,CAAC;AAE9B,MAAM,gBAAgB,GAAG,IAAI,MAAM,CAClC,sBAAsB,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAC7D,YAAY;IACZ,uBAAuB,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAC9D,GAAG,CACH,CAAC;AAEF,2EAA2E;AAC3E,MAAM,uBAAuB,GAAG,mFAAmF,CAAC;AASpH,2DAA2D;AAC3D,SAAS,UAAU,CAAC,IAAa;IAChC,OAAO,CACN,IAAI,IAAI,IAAI;QACZ,OAAO,IAAI,KAAK,QAAQ;QACxB,MAAM,IAAI,IAAI;QACd,IAAI,CAAC,IAAI,KAAK,MAAM;QACpB,MAAM,IAAI,IAAI;QACd,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CACrD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,sDAAsD;AACtD,MAAM,UAAU,qBAAqB,CAAC,IAAY;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,4BAA4B,CAC3C,OAAmD;IAEnD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAAC,OAAuB;IACrE,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,CAAU;IACjD,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAExD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChE,IAAI,CAAC,WAAW,CAAE,CAA6B,CAAC,GAAG,CAAC,EAAG,CAA6B,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1G,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAAe;IAC7D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,MAAM,GAAG,QAAQ;SACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,iDAAiD;QACjD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,8BAA8B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,4DAA4D;QAC5D,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACpC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,CAAC;QACnD,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,IAAI,cAAc,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAA+B,EAAE,CAAC;AAEtF,MAAM,UAAU,iBAAiB,CAAC,MAAmD;IACpF,cAAc,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,gBAAsB;IAC7D,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,IAAI,aAAa,CAAC;IAC1D,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,gBAAgB,EAAE,SAAS;KACtC,CAAC;AACH,CAAC"}
+{"version":3,"file":"sliding-prompt.js","sourceRoot":"","sources":["../../src/steering/sliding-prompt.ts"],"names":[],"mappings":"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"}

package/dist/steering/tool-utils.d.ts

@@ -2,28 +2,51 @@
  * Shared tool-result utilities.
  *
  * Provides helpers for appending text to tool results and injecting
- * strategic planning hints after each tool call.
+ * adaptive directive hints after each tool call.
  */
 /**
  * Append text to the first text content item in a tool result,
  * or push a new text item if none exists.
  */
 export declare function appendTextToToolResult(result: any, text: string): void;
-export declare function configureStrategicHint(enabled: boolean): void;
+export declare function configureDirective(enabled: boolean): void;
+export declare const DEFAULT_DIRECTIVE = "\n\n[Directive: Close what you start. Dispatch a [build] or [scout] flow to verify before advancing.]";
+export declare const NOTDONE_DIRECTIVE = "\n\n[Directive: Unfinished work detected. Dispatch a [build] or [debug] flow to close the notDone items. Do not start new work until these are resolved.]";
+export declare const VAGUE_DIRECTIVE = "\n\n[Directive: Dispatch the same [build] or [scout] flow to verify uncertainty.]";
+export interface FlowHintContext {
+    hasNotDone: boolean;
+    statusVague: boolean;
+}
 /**
- * Strip strategic hints from text.
+ * Strip directive hints from text (including legacy [Hint:] format).
  */
-export declare function stripStrategicHints(text: string): string;
+export declare function stripDirectives(text: string): string;
 /**
- * Strip strategic hints from tool result content (string or text-part array).
+ * Strip directive hints from tool result content (string or text-part array).
  */
-export declare function stripStrategicHintsFromContent(content: string | Array<{
+export declare function stripDirectivesFromContent(content: string | Array<{
     type: string;
     text?: string;
 }>): string | Array<{
     type: string;
     text?: string;
 }>;
-export declare function resetStrategicHintTracker(): void;
-export declare function appendStrategicHintOnce(result: any): void;
+/**
+ * Remove directive hints from an array of messages.
+ * Returns the sanitized messages and a flag indicating whether anything changed.
+ */
+export declare function stripDirectivesFromMessages(messages: any[]): {
+    messages: any[];
+    changed: boolean;
+};
+export declare function resetDirectiveTracker(): void;
+/**
+ * Append an adaptive directive hint to the tool result.
+ *
+ * Skipped when PI_FLOW_NO_DIRECTIVE=1 (or legacy PI_FLOW_NO_STRATEGIC_HINT=1)
+ * is set, when the result is an error, or when a directive was already
+ * appended to this specific result.
+ */
+export declare function appendDirectiveOnce(result: any, hintContext?: FlowHintContext): void;
+export { appendDirectiveOnce as appendStrategicHintOnce, resetDirectiveTracker as resetStrategicHintTracker, configureDirective as configureStrategicHint, stripDirectives as stripStrategicHints, stripDirectivesFromContent as stripStrategicHintsFromContent, };
 //# sourceMappingURL=tool-utils.d.ts.map

package/dist/steering/tool-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-utils.d.ts","sourceRoot":"","sources":["../../src/steering/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOtE;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE7D;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjD;AAWD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAMzD"}
+{"version":3,"file":"tool-utils.d.ts","sourceRoot":"","sources":["../../src/steering/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOtE;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEzD;AAWD,eAAO,MAAM,iBAAiB,0GAC0E,CAAC;AAEzG,eAAO,MAAM,iBAAiB,8JAC8H,CAAC;AAE7J,eAAO,MAAM,eAAe,sFACwD,CAAC;AAKrF,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAUlG;AAID,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAcpF;AAMD,OAAO,EACN,mBAAmB,IAAI,uBAAuB,EAC9C,qBAAqB,IAAI,yBAAyB,EAClD,kBAAkB,IAAI,sBAAsB,EAC5C,eAAe,IAAI,mBAAmB,EACtC,0BAA0B,IAAI,8BAA8B,GAC5D,CAAC"}

package/dist/steering/tool-utils.js

@@ -2,8 +2,9 @@
  * Shared tool-result utilities.
  *
  * Provides helpers for appending text to tool results and injecting
- * strategic planning hints after each tool call.
+ * adaptive directive hints after each tool call.
  */
+import { isJsonEqual } from "./sliding-prompt.js";
 /**
  * Append text to the first text content item in a tool result,
  * or push a new text item if none exists.
@@ -17,57 +18,89 @@ export function appendTextToToolResult(result, text) {
         result.content.push({ type: "text", text: text.trim() });
     }
 }
-let strategicHintEnabled = true;
-export function configureStrategicHint(enabled) {
-    strategicHintEnabled = enabled;
+let directiveEnabled = true;
+export function configureDirective(enabled) {
+    directiveEnabled = enabled;
 }
-// Initialize from legacy env var (overrides default true)
+// Initialize from env vars (legacy + new) — overrides default true
 if (typeof process !== "undefined" &&
     typeof process.env !== "undefined" &&
-    process.env.PI_FLOW_NO_STRATEGIC_HINT === "1") {
-    strategicHintEnabled = false;
+    (process.env.PI_FLOW_NO_STRATEGIC_HINT === "1" || process.env.PI_FLOW_NO_DIRECTIVE === "1")) {
+    directiveEnabled = false;
 }
-const STRATEGIC_HINT = "\n\n[Hint: Plan next step. Batch ALL pending edits/reads/commands into ONE batch call. Execute decisively.]";
-const STRATEGIC_HINT_RE = /\n\n\[Hint: [\s\S]*?\]/g;
+export const DEFAULT_DIRECTIVE = "\n\n[Directive: Close what you start. Dispatch a [build] or [scout] flow to verify before advancing.]";
+export const NOTDONE_DIRECTIVE = "\n\n[Directive: Unfinished work detected. Dispatch a [build] or [debug] flow to close the notDone items. Do not start new work until these are resolved.]";
+export const VAGUE_DIRECTIVE = "\n\n[Directive: Dispatch the same [build] or [scout] flow to verify uncertainty.]";
+const DIRECTIVE_RE = /\n\n\[Directive: [^\n]*\]/g;
+const LEGACY_HINT_RE = /\n\n\[Hint: [\s\S]*?\]/g;
 /**
- * Strip strategic hints from text.
+ * Strip directive hints from text (including legacy [Hint:] format).
  */
-export function stripStrategicHints(text) {
-    return text.replace(STRATEGIC_HINT_RE, "");
+export function stripDirectives(text) {
+    return text.replace(DIRECTIVE_RE, "").replace(LEGACY_HINT_RE, "");
 }
 /**
- * Strip strategic hints from tool result content (string or text-part array).
+ * Strip directive hints from tool result content (string or text-part array).
  */
-export function stripStrategicHintsFromContent(content) {
+export function stripDirectivesFromContent(content) {
     if (typeof content === "string") {
-        return stripStrategicHints(content);
+        return stripDirectives(content);
     }
     return content.map((part) => {
         if (part.type === "text" && typeof part.text === "string") {
-            return { ...part, text: stripStrategicHints(part.text) };
+            return { ...part, text: stripDirectives(part.text) };
         }
         return part;
     });
 }
 /**
- * Append a concise strategic planning hint to the tool result.
- *
- * Skipped when PI_FLOW_NO_STRATEGIC_HINT=1 is set or when the result
- * is an error (no hint on failed calls — the model should focus on
- * fixing the error, not planning ahead).
+ * Remove directive hints from an array of messages.
+ * Returns the sanitized messages and a flag indicating whether anything changed.
  */
-let hintAppendedThisTurn = false;
-export function resetStrategicHintTracker() {
-    hintAppendedThisTurn = false;
+export function stripDirectivesFromMessages(messages) {
+    let changed = false;
+    const result = messages.map((msg) => {
+        if (!("content" in msg))
+            return msg;
+        const stripped = stripDirectivesFromContent(msg.content);
+        if (isJsonEqual(stripped, msg.content))
+            return msg;
+        changed = true;
+        return { ...msg, content: stripped };
+    });
+    return { messages: result, changed };
 }
-export function appendStrategicHintOnce(result) {
-    if (!strategicHintEnabled)
+const directiveTracker = new WeakMap();
+export function resetDirectiveTracker() {
+    // WeakMap entries are garbage-collected with their result objects;
+    // no manual sweep required for per-result tracking.
+}
+/**
+ * Append an adaptive directive hint to the tool result.
+ *
+ * Skipped when PI_FLOW_NO_DIRECTIVE=1 (or legacy PI_FLOW_NO_STRATEGIC_HINT=1)
+ * is set, when the result is an error, or when a directive was already
+ * appended to this specific result.
+ */
+export function appendDirectiveOnce(result, hintContext) {
+    if (!directiveEnabled)
         return;
-    if (result?.isError)
+    if (result?.failed)
         return;
-    if (hintAppendedThisTurn)
+    if (directiveTracker.has(result))
         return;
-    hintAppendedThisTurn = true;
-    appendTextToToolResult(result, STRATEGIC_HINT);
+    directiveTracker.set(result, true);
+    let directive = DEFAULT_DIRECTIVE;
+    if (hintContext?.hasNotDone) {
+        directive = NOTDONE_DIRECTIVE;
+    }
+    else if (hintContext?.statusVague) {
+        directive = VAGUE_DIRECTIVE;
+    }
+    appendTextToToolResult(result, directive);
 }
+// ---------------------------------------------------------------------------
+// Backward-compat deprecated aliases
+// ---------------------------------------------------------------------------
+export { appendDirectiveOnce as appendStrategicHintOnce, resetDirectiveTracker as resetStrategicHintTracker, configureDirective as configureStrategicHint, stripDirectives as stripStrategicHints, stripDirectivesFromContent as stripStrategicHintsFromContent, };
 //# sourceMappingURL=tool-utils.js.map

package/dist/steering/tool-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../src/steering/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAW,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACxE,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED,IAAI,oBAAoB,GAAG,IAAI,CAAC;AAEhC,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACtD,oBAAoB,GAAG,OAAO,CAAC;AAChC,CAAC;AAED,0DAA0D;AAC1D,IACC,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,OAAO,CAAC,GAAG,KAAK,WAAW;IAClC,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,EAC5C,CAAC;IACF,oBAAoB,GAAG,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,cAAc,GACnB,6GAA6G,CAAC;AAE/G,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC7C,OAAwD;IAExD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,IAAI,oBAAoB,GAAG,KAAK,CAAC;AAEjC,MAAM,UAAU,yBAAyB;IACxC,oBAAoB,GAAG,KAAK,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAW;IAClD,IAAI,CAAC,oBAAoB;QAAE,OAAO;IAClC,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO;IAC5B,IAAI,oBAAoB;QAAE,OAAO;IACjC,oBAAoB,GAAG,IAAI,CAAC;IAC5B,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../src/steering/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAW,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACxE,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED,IAAI,gBAAgB,GAAG,IAAI,CAAC;AAE5B,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IAClD,gBAAgB,GAAG,OAAO,CAAC;AAC5B,CAAC;AAED,mEAAmE;AACnE,IACC,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,OAAO,CAAC,GAAG,KAAK,WAAW;IAClC,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,CAAC,EAC1F,CAAC;IACF,gBAAgB,GAAG,KAAK,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC7B,uGAAuG,CAAC;AAEzG,MAAM,CAAC,MAAM,iBAAiB,GAC7B,2JAA2J,CAAC;AAE7J,MAAM,CAAC,MAAM,eAAe,GAC3B,mFAAmF,CAAC;AAErF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAOjD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACzC,OAAwD;IAExD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAe;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACnC,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACpC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,CAAC;QACnD,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAmB,CAAC;AAExD,MAAM,UAAU,qBAAqB;IACpC,mEAAmE;IACnE,oDAAoD;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAW,EAAE,WAA6B;IAC7E,IAAI,CAAC,gBAAgB;QAAE,OAAO;IAC9B,IAAI,MAAM,EAAE,MAAM;QAAE,OAAO;IAC3B,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO;IACzC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEnC,IAAI,SAAS,GAAG,iBAAiB,CAAC;IAClC,IAAI,WAAW,EAAE,UAAU,EAAE,CAAC;QAC7B,SAAS,GAAG,iBAAiB,CAAC;IAC/B,CAAC;SAAM,IAAI,WAAW,EAAE,WAAW,EAAE,CAAC;QACrC,SAAS,GAAG,eAAe,CAAC;IAC7B,CAAC;IAED,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,OAAO,EACN,mBAAmB,IAAI,uBAAuB,EAC9C,qBAAqB,IAAI,yBAAyB,EAClD,kBAAkB,IAAI,sBAAsB,EAC5C,eAAe,IAAI,mBAAmB,EACtC,0BAA0B,IAAI,8BAA8B,GAC5D,CAAC"}

package/dist/tools/ask-user.d.ts

@@ -4,8 +4,8 @@
  * Split-pane-only layout: options list (left) + description preview (right).
  * Minimal schema: question + options[{title, description}].
  */
-import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { Text } from "@mariozechner/pi-tui";
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
 import { type QuestionOption } from "../tui/single-select-layout.js";
 type AskOptionInput = QuestionOption | string;
 interface AskParams {
@@ -38,23 +38,6 @@ export declare function createAskUserTool(): {
             text: string;
         }[];
         details: AskToolDetails;
-        isError?: undefined;
-    } | {
-        content: {
-            type: string;
-            text: string;
-        }[];
-        isError: boolean;
-        details: AskToolDetails;
-    } | {
-        content: {
-            type: string;
-            text: string;
-        }[];
-        isError: boolean;
-        details: {
-            error: string;
-        };
     }>;
     renderCall(args: any, theme: any): Text;
     renderResult(result: any, options: any, theme: any, args?: Record<string, unknown>): Text;

package/dist/tools/ask-user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,+BAA+B,CAAC;AAM7E,OAAO,EASN,IAAI,EAIJ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAuB7F,KAAK,cAAc,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,UAAU,SAAS;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,KAAK,WAAW,GACb;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,UAAU,cAAc;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACnB;AAsoBD,wBAAgB,iBAAiB;;;;;;;yBA0BJ,MAAM,UAAU,SAAS,UAAU,WAAW,GAAG,SAAS,YAAY,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,OAAO,gBAAgB;;;;;iBAMhE,cAAc;;;;;;;;iBAiBnC,cAAc;;;;;;;;;;;qBAkHnE,GAAG,SAAS,GAAG;yBAcX,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA6DnF"}
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAS,MAAM,iCAAiC,CAAC;AAM/E,OAAO,EASN,IAAI,EAIJ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAuB7F,KAAK,cAAc,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,UAAU,SAAS;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,KAAK,WAAW,GACb;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,UAAU,cAAc;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;CACnB;AAyoBD,wBAAgB,iBAAiB;;;;;;;yBA0BJ,MAAM,UAAU,SAAS,UAAU,WAAW,GAAG,SAAS,YAAY,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,OAAO,gBAAgB;;;;;iBAMhE,cAAc;;qBAsHxF,GAAG,SAAS,GAAG;yBAcX,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAgDnF"}

package/dist/tools/ask-user.js

@@ -5,11 +5,11 @@
  * Minimal schema: question + options[{title, description}].
  */
 import { Type } from "@sinclair/typebox";
-import { appendStrategicHintOnce } from "../steering/tool-utils.js";
+import { appendDirectiveOnce } from "../steering/tool-utils.js";
 import { setPendingDecision } from "../notify/notify-state.js";
 import { scrambleManager, runScrambleTimer } from "../tui/scramble/index.js";
 import { stripAnsi } from "../tui/render-utils.js";
-import { Container, decodeKittyPrintable, fuzzyFilter, Key, matchesKey, Spacer, Text, truncateToWidth, wrapTextWithAnsi, } from "@mariozechner/pi-tui";
+import { Container, decodeKittyPrintable, fuzzyFilter, Key, matchesKey, Spacer, Text, truncateToWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
 import { renderSingleSelectRows } from "../tui/single-select-layout.js";
 import { loadFlowSettings } from "../config/config.js";
 const ASK_USER_VERSION = "1.8.40";
@@ -541,15 +541,17 @@ class AskComponent extends Container {
 // RPC/headless fallback: use dialog methods (select/input) instead of the rich TUI overlay.
 // ctx.ui.custom() returns undefined in RPC mode, so we degrade gracefully.
 // ---------------------------------------------------------------------------
-async function askViaDialogs(ui, question, options) {
+async function askViaDialogs(ui, question, options, signal) {
+    if (signal?.aborted)
+        return null;
     if (options.length === 0) {
-        const answer = await ui.input(question, "Type your answer...");
+        const answer = await ui.input(question, "Type your answer...", { signal });
         if (isCancelledInput(answer))
             return null;
         return createFreeformResponse(answer);
     }
     const selectOptions = options.map((o) => o.title);
-    const selected = await ui.select(question, selectOptions);
+    const selected = await ui.select(question, selectOptions, { signal });
     if (isCancelledInput(selected))
         return null;
     return createSelectionResponse([selected]);
@@ -564,9 +566,9 @@ export function createAskUserTool() {
         description: "Ask the user a focused question with optional multiple-choice answers. Use this to gather information interactively. Ask exactly one focused question per call. When presenting options, mark your recommended choice with [preferred] and place it first.",
         promptSnippet: "Ask the user one focused question with optional multiple-choice answers to gather information interactively",
         promptGuidelines: [
-            "Use ask_user when the user's intent is ambiguous, when a decision requires explicit user input, or when multiple valid options exist.",
-            "Ask exactly one focused question per ask_user call.",
-            "Do not combine multiple numbered, multipart, or unrelated questions into one ask_user prompt.",
+            "Use `ask_user` when the user's intent is ambiguous, when a decision requires explicit user input, or when multiple valid options exist.",
+            "Ask exactly one focused question per `ask_user` call.",
+            "Do not combine multiple numbered, multipart, or unrelated questions into one `ask_user` prompt.",
         ],
         parameters: Type.Object({
             question: Type.String({ description: "The question to ask the user" }),
@@ -587,16 +589,7 @@ export function createAskUserTool() {
             const options = normalizeOptions(rawOptions);
             if (!ctx.hasUI || !ctx.ui) {
                 const optionText = options.length > 0 ? `\n\nOptions:\n${formatOptionsForMessage(options)}` : "";
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Ask requires interactive mode. Please answer:\n\n${question}${optionText}`,
-                        },
-                    ],
-                    isError: true,
-                    details: { question, options, response: null, cancelled: true },
-                };
+                throw new Error(`Ask requires interactive mode. Please answer:\n\n${question}${optionText}`);
             }
             if (options.length === 0) {
                 const answer = await ctx.ui.input(question, "Type your answer...");
@@ -611,7 +604,7 @@ export function createAskUserTool() {
                     content: [{ type: "text", text: `User answered: ${formatResponseSummary(response)}` }],
                     details: { question, options, response, cancelled: false },
                 };
-                appendStrategicHintOnce(_result0);
+                appendDirectiveOnce(_result0);
                 return _result0;
             }
             onUpdate?.({
@@ -659,16 +652,12 @@ export function createAskUserTool() {
                     result = customResult;
                 }
                 else {
-                    result = await askViaDialogs(ctx.ui, question, options);
+                    result = await askViaDialogs(ctx.ui, question, options, signal);
                 }
             }
             catch (error) {
                 const message = error instanceof Error ? `${error.message}\n${error.stack ?? ""}` : String(error);
-                return {
-                    content: [{ type: "text", text: `Ask tool failed: ${message}` }],
-                    isError: true,
-                    details: { error: message },
-                };
+                throw new Error(`Ask tool failed: ${message}`);
             }
             if (result === null) {
                 return {
@@ -710,19 +699,6 @@ export function createAskUserTool() {
                 runScrambleTimer(args, id);
                 return new Text(scrambled, 0, 0);
             }
-            if (options.isPartial) {
-                const waitingText = result.content
-                    ?.filter((part) => part?.type === "text")
-                    .map((part) => part.text ?? "")
-                    .join("\n")
-                    .trim() || "Waiting for user input...";
-                const line = theme.fg("muted", waitingText);
-                if (!canAnimate)
-                    return new Text(scrambleManager.renderStatic(line), 0, 0);
-                const scrambled = scrambleManager.updateText(id, "result", stripAnsi(line), now, false).content;
-                runScrambleTimer(args, id);
-                return new Text(scrambled, 0, 0);
-            }
             if (!details || details.cancelled || !details.response) {
                 const line = theme.fg("warning", "Cancelled");
                 if (!canAnimate)