@cortexkit/aft-pi 0.18.2 → 0.18.4

package/dist/bg-notifications.d.ts

@@ -7,6 +7,10 @@ export interface BgCompletion {
     duration_ms?: number;
     runtime_ms?: number;
     runtime?: number;
+    /** Tail of stdout+stderr captured at completion (≤300 bytes from Rust). */
+    output_preview?: string;
+    /** True when the captured tail is shorter than the actual output. */
+    output_truncated?: boolean;
 }
 type SessionBgState = {
     outstandingTaskIds: Set<string>;
@@ -16,6 +20,11 @@ type SessionBgState = {
     firstCompletionAt: number | null;
     scheduledFireAt: number | null;
     scheduledCompletionCount: number;
+    retryDelayMs: number | null;
+    unknownCompletions: Array<{
+        completion: BgCompletion;
+        receivedAt: number;
+    }>;
     lastSeenAt: number;
 };
 type TextContent = {
@@ -30,7 +39,9 @@ type ImageContent = {
 };
 type ContentBlock = TextContent | ImageContent;
 type SendUserMessageRuntime = {
-    sendUserMessage: (content: string) => void;
+    sendUserMessage: (content: string, options?: {
+        deliverAs?: "steer" | "followUp";
+    }) => void;
 };
 export declare const sessionBgStates: Map<string, SessionBgState>;
 export declare const SESSION_BG_STATE_IDLE_TTL_MS: number;
@@ -38,9 +49,13 @@ interface DrainContext {
     ctx: PluginContext;
     directory: string;
     sessionID?: string;
+    isActive?: () => boolean;
 }
 export declare function trackBgTask(sessionID: string | undefined, taskId: string): void;
 export declare function ingestBgCompletions(sessionID: string | undefined, completions: unknown): BgCompletion[];
+export declare function handlePushedBgCompletion(drainContext: DrainContext & {
+    runtime: SendUserMessageRuntime;
+}, completion: unknown): Promise<void>;
 export declare function appendToolResultBgCompletions(drainContext: DrainContext, content: ContentBlock[]): Promise<ContentBlock[] | undefined>;
 export declare function handleTurnEndBgCompletions(drainContext: DrainContext & {
     runtime: SendUserMessageRuntime;

package/dist/bg-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bg-notifications.d.ts","sourceRoot":"","sources":["../src/bg-notifications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,cAAc,GAAG;IACpB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1E,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,KAAK,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAC/C,KAAK,sBAAsB,GAAG;IAAE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC;AAE7E,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAa,CAAC;AAGtE,eAAO,MAAM,4BAA4B,QAAiB,CAAC;AAM3D,UAAU,YAAY;IACpB,GAAG,EAAE,aAAa,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,OAAO,GACnB,YAAY,EAAE,CAiBhB;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,YAAY,EAAE,GAAG,SAAS,CAAC,CAarC;AAED,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAGjF;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAKzD;AA2ED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAmB,GAAG,IAAI,CAQvE"}
+{"version":3,"file":"bg-notifications.d.ts","sourceRoot":"","sources":["../src/bg-notifications.ts"],"names":[],"mappings":"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"}

package/dist/bridge.d.ts

@@ -1,3 +1,4 @@
+import type { BgCompletion } from "./bg-notifications.js";
 /**
  * Compare two semver version strings (major.minor.patch plus pre-release).
  * Returns: negative if a < b, 0 if equal, positive if a > b.
@@ -20,6 +21,12 @@ export interface BridgeOptions {
     onVersionMismatch?: (binaryVersion: string, minVersion: string) => void;
     /** Called after the first successful configure returns user-visible warnings. */
     onConfigureWarnings?: (context: ConfigureWarningsContext) => void | Promise<void>;
+    /** Called for server-pushed background bash completions. */
+    onBashCompletion?: (completion: BashCompletedPayload, bridge: BinaryBridge) => void | Promise<void>;
+}
+export interface BashCompletedPayload extends BgCompletion {
+    type: "bash_completed";
+    session_id: string;
 }
 export interface BridgeRequestOptions {
     onProgress?: (chunk: {
@@ -28,6 +35,22 @@ export interface BridgeRequestOptions {
     }) => void;
     /** Per-call transport timeout in milliseconds. Defaults to the bridge-wide timeout. */
     transportTimeoutMs?: number;
+    /**
+     * Skip the "kill the child process on timeout" behavior for this request.
+     *
+     * The default (false) treats a transport-level timeout as evidence the bridge
+     * is wedged — Rust normally responds well within the budget, so silence past
+     * the deadline almost always means a stuck child. Killing forces a clean
+     * respawn on the next call.
+     *
+     * Some commands enforce their own timeouts on the Rust side (notably `bash`,
+     * which uses a watchdog thread to terminate the child shell and return a
+     * timeout response). For those, a transport timeout means the response was
+     * lost or queued behind something else — the bridge itself is still healthy
+     * and should keep its warm state. Pass `keepBridgeOnTimeout: true` to
+     * reject the request without tearing down the bridge.
+     */
+    keepBridgeOnTimeout?: boolean;
 }
 interface SendOptions extends BridgeRequestOptions {
     timeoutMs?: number;
@@ -60,12 +83,14 @@ export declare class BinaryBridge {
     private minVersion;
     private onVersionMismatch;
     private onConfigureWarnings;
+    private onBashCompletion;
     private restartResetTimer;
     constructor(binaryPath: string, cwd: string, options?: BridgeOptions, configOverrides?: Record<string, unknown>);
     /** Number of times the binary has been restarted after a crash. */
     get restartCount(): number;
     /** Whether the child process is currently alive. */
     isAlive(): boolean;
+    hasPendingRequests(): boolean;
     /**
      * Send a command to the binary and return the parsed response.
      * Lazy-spawns the binary on first call.

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiB1D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkC1D;AA6CD,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,CACjB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,YAAY,KACjB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,WAAY,SAAQ,oBAAoB;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAiB;IACzD,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAM;IAE7C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,YAAY,CAAM;IAC1B,sEAAsE;IACtE,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,iBAAiB,CAAoE;IAC7F,OAAO,CAAC,mBAAmB,CAEb;IACd,OAAO,CAAC,gBAAgB,CAEV;IACd,OAAO,CAAC,iBAAiB,CAA8C;gBAGrE,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,EACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAa3C,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oDAAoD;IACpD,OAAO,IAAI,OAAO;IAIlB,kBAAkB,IAAI,OAAO;IAI7B;;;OAGG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAyIrB,wBAAwB;IAuBtC,8DAA8D;IACxD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B/B,gGAAgG;YAClF,YAAY;IAoB1B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IA6GpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,WAAW;IAoDnB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,sBAAsB;CAM/B"}

package/dist/config.d.ts

@@ -50,6 +50,8 @@ export interface ConfigureExperimentalOverrides {
 export type ToolSurface = "minimal" | "recommended" | "all";
 export interface AftConfig {
     format_on_edit?: boolean;
+    /** Maximum formatter subprocess wallclock seconds. Bounded 1..=600. Default 10. */
+    formatter_timeout_secs?: number;
     validate_on_edit?: "syntax" | "full";
     formatter?: Record<string, Formatter>;
     checker?: Record<string, Checker>;
@@ -81,6 +83,7 @@ export declare const LspServerSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const AftConfigSchema: z.ZodObject<{
     format_on_edit: z.ZodOptional<z.ZodBoolean>;
+    formatter_timeout_secs: z.ZodOptional<z.ZodNumber>;
     validate_on_edit: z.ZodOptional<z.ZodEnum<{
         syntax: "syntax";
         full: "full";

package/dist/config.d.ts.map

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

package/dist/index.d.ts

@@ -30,10 +30,45 @@
  *   - /aft-status    Status dialog (index states, LSP servers, storage dir)
  */
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { loadAftConfig } from "./config.js";
+/**
+ * Tool surface mirrors opencode-plugin: navigate/delete/move/transform/refactor
+ * are all-only. recommended exposes hoisted + read/safety/import/ast/lsp/conflicts
+ * + experimental search/semantic when enabled.
+ *
+ * Returns the set of AFT tool names that should be registered given the
+ * configured surface + disabled_tools filter. Pi's built-in tools are always
+ * present; registering an AFT tool with the same name replaces them.
+ */
+declare function resolveToolSurface(config: ReturnType<typeof loadAftConfig>): {
+    hoistBash: boolean;
+    hoistRead: boolean;
+    hoistWrite: boolean;
+    hoistEdit: boolean;
+    hoistGrep: boolean;
+    outline: boolean;
+    zoom: boolean;
+    semantic: boolean;
+    navigate: boolean;
+    conflicts: boolean;
+    importTool: boolean;
+    safety: boolean;
+    delete: boolean;
+    move: boolean;
+    astSearch: boolean;
+    astReplace: boolean;
+    lspDiagnostics: boolean;
+    structure: boolean;
+    refactor: boolean;
+};
 /**
  * Pi extension default export.
  *
  * Called once per session. Registers tools, commands, and session shutdown hooks.
  */
 export default function (pi: ExtensionAPI): Promise<void>;
+export declare const __test__: {
+    resolveToolSurface: typeof resolveToolSurface;
+};
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAyLlE;;;;GAIG;AACH,yBAA+B,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyS9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQlE,OAAO,EACL,aAAa,EAGd,MAAM,aAAa,CAAC;AAkFrB;;;;;;;;GAQG;AACH,iBAAS,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GAAG;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAiEA;AAED;;;;GAIG;AACH,yBAA+B,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6T9D;AAED,eAAO,MAAM,QAAQ;;CAAyB,CAAC"}

package/dist/index.js

@@ -7893,7 +7893,8 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 var TAG = "[aft-pi]";
-var logFile = path.join(os.tmpdir(), "aft-pi.log");
+var isTestEnv = process.env.BUN_TEST === "1" || false;
+var logFile = path.join(os.tmpdir(), isTestEnv ? "aft-pi-test.log" : "aft-pi.log");
 var useStderr = process.env.AFT_LOG_STDERR === "1";
 var buffer = [];
 var flushTimer = null;
@@ -7951,6 +7952,9 @@ function warn(message, data) {
 function error(message, data) {
   write("ERROR", message, data);
 }
+function sessionLog(sessionId, message, data) {
+  write("INFO", message, data, sessionId);
+}
 function sessionWarn(sessionId, message, data) {
   write("WARN", message, data, sessionId);
 }
@@ -7963,10 +7967,24 @@ var sessionBgStates = new Map;
 var SESSION_BG_STATE_IDLE_TTL_MS = 60 * 60 * 1000;
 var DEBOUNCE_STEP_MS = 200;
 var DEBOUNCE_CAP_MS = 1000;
+var UNKNOWN_COMPLETION_TTL_MS = 5000;
+var UNKNOWN_COMPLETION_CAP = 32;
 var DEFAULT_SESSION_ID = "__default__";
 var LOG_PREFIX = "[aft-pi] bg-notifications:";
 function trackBgTask(sessionID, taskId) {
-  stateFor(sessionID).outstandingTaskIds.add(taskId);
+  const state = stateFor(sessionID);
+  pruneUnknownCompletions(state, Date.now());
+  const buffered = state.unknownCompletions.filter((entry) => entry.completion.task_id === taskId);
+  state.unknownCompletions = state.unknownCompletions.filter((entry) => entry.completion.task_id !== taskId);
+  if (buffered.length > 0) {
+    for (const entry of buffered) {
+      if (!state.pendingCompletions.some((pending) => pending.task_id === taskId)) {
+        state.pendingCompletions.push(entry.completion);
+      }
+    }
+    return;
+  }
+  state.outstandingTaskIds.add(taskId);
 }
 function ingestBgCompletions(sessionID, completions) {
   if (!Array.isArray(completions) || completions.length === 0)
@@ -7976,8 +7994,10 @@ function ingestBgCompletions(sessionID, completions) {
   for (const completion of completions) {
     if (!isBgCompletion(completion))
       continue;
-    if (!state.outstandingTaskIds.has(completion.task_id))
+    if (!state.outstandingTaskIds.has(completion.task_id)) {
+      bufferUnknownCompletion(state, completion);
       continue;
+    }
     state.outstandingTaskIds.delete(completion.task_id);
     if (!state.pendingCompletions.some((pending) => pending.task_id === completion.task_id) && !accepted.some((pending) => pending.task_id === completion.task_id)) {
       accepted.push(completion);
@@ -7986,6 +8006,10 @@ function ingestBgCompletions(sessionID, completions) {
   state.pendingCompletions.push(...accepted);
   return accepted;
 }
+async function handlePushedBgCompletion(drainContext, completion) {
+  ingestBgCompletions(drainContext.sessionID, [completion]);
+  await triggerWakeIfPending(drainContext, true);
+}
 async function appendToolResultBgCompletions(drainContext, content) {
   const state = stateFor(drainContext.sessionID);
   if (state.outstandingTaskIds.size === 0 && state.pendingCompletions.length === 0)
@@ -8000,50 +8024,56 @@ async function appendToolResultBgCompletions(drainContext, content) {
   return [...content, { type: "text", text: reminder }];
 }
 async function handleTurnEndBgCompletions(drainContext) {
+  await triggerWakeIfPending(drainContext, false);
+}
+async function triggerWakeIfPending(drainContext, skipDrain) {
   const state = stateFor(drainContext.sessionID);
   if (state.wakeFiredThisIdle)
     return;
-  if (state.outstandingTaskIds.size > 0) {
+  if (drainContext.isActive?.())
+    return;
+  if (!skipDrain && state.outstandingTaskIds.size > 0) {
     await drainCompletions(drainContext);
   }
   if (state.pendingCompletions.length === 0)
     return;
   scheduleWake(state, async (reminder) => {
-    try {
-      drainContext.runtime.sendUserMessage(reminder);
-    } catch (err) {
-      warn(`${LOG_PREFIX} wake send failed: ${err instanceof Error ? err.message : String(err)}`);
-    }
+    drainContext.runtime.sendUserMessage(reminder, { deliverAs: "followUp" });
+  }, (err) => {
+    sessionWarn(drainContext.sessionID ?? "", `${LOG_PREFIX} wake send failed: ${err instanceof Error ? err.message : String(err)}`);
   });
 }
 function resetBgWake(sessionID) {
   stateFor(sessionID).wakeFiredThisIdle = false;
 }
 function formatSystemReminder(completions) {
-  const bullets = completions.map((completion) => `- ${formatCompletion(completion)}`).join(`
+  const bullets = completions.map((completion) => formatCompletion(completion)).join(`
 `);
+  const anyTruncated = completions.some((c) => c.output_truncated === true);
+  const tail = anyTruncated ? `
+
+For truncated tasks, use bash_status({ task_id: "..." }) to retrieve full output.` : "";
   return `<system-reminder>
 [BACKGROUND BASH COMPLETED]
-${bullets}
-
-Use bash_status({ task_id: "..." }) to retrieve full output.
+${bullets}${tail}
 </system-reminder>`;
 }
 async function drainCompletions({ ctx, directory, sessionID }) {
   try {
     const bridge = ctx.pool.getAnyActiveBridge(directory) ?? ctx.pool.getBridge(directory);
-    const params = sessionID ? { session_id: sessionID } : {};
-    const response = await bridge.send("bash_drain_completions", params);
+    if (!sessionID)
+      return;
+    const response = await bridge.send("bash_drain_completions", { session_id: sessionID });
     if (response.success === false) {
-      warn(`${LOG_PREFIX} drain failed: ${String(response.message ?? "unknown error")}`);
+      sessionWarn(sessionID ?? "", `${LOG_PREFIX} drain failed: ${String(response.message ?? "unknown error")}`);
       return;
     }
     ingestBgCompletions(sessionID, response.bg_completions);
   } catch (err) {
-    warn(`${LOG_PREFIX} drain failed: ${err instanceof Error ? err.message : String(err)}`);
+    sessionWarn(sessionID ?? "", `${LOG_PREFIX} drain failed: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
-function scheduleWake(state, sendWake) {
+function scheduleWake(state, sendWake, onSendFailure) {
   const now = Date.now();
   if (state.debounceTimer && state.pendingCompletions.length <= state.scheduledCompletionCount) {
     return;
@@ -8058,16 +8088,24 @@ function scheduleWake(state, sendWake) {
   state.scheduledCompletionCount = state.pendingCompletions.length;
   if (state.debounceTimer)
     clearTimeout(state.debounceTimer);
-  const delay = Math.max(0, (state.scheduledFireAt ?? now) - now);
+  const delay = state.retryDelayMs ?? Math.max(0, (state.scheduledFireAt ?? now) - now);
   state.debounceTimer = setTimeout(() => {
-    const reminder = formatSystemReminder(state.pendingCompletions);
+    const pending = state.pendingCompletions;
+    const reminder = formatSystemReminder(pending);
     state.pendingCompletions = [];
     state.debounceTimer = null;
-    state.wakeFiredThisIdle = true;
     state.firstCompletionAt = null;
     state.scheduledFireAt = null;
     state.scheduledCompletionCount = 0;
-    sendWake(reminder);
+    sendWake(reminder).then(() => {
+      state.retryDelayMs = null;
+      state.wakeFiredThisIdle = true;
+    }).catch((err) => {
+      state.pendingCompletions = [...pending, ...state.pendingCompletions];
+      state.retryDelayMs = Math.min((delay || DEBOUNCE_STEP_MS) * 2, DEBOUNCE_CAP_MS);
+      onSendFailure(err);
+      scheduleWake(state, sendWake, onSendFailure);
+    });
   }, delay);
   state.debounceTimer.unref?.();
 }
@@ -8085,6 +8123,8 @@ function stateFor(sessionID) {
       firstCompletionAt: null,
       scheduledFireAt: null,
       scheduledCompletionCount: 0,
+      retryDelayMs: null,
+      unknownCompletions: [],
       lastSeenAt: now
     };
     sessionBgStates.set(key, state);
@@ -8105,6 +8145,18 @@ function cleanupIdleSessionStates(now = Date.now()) {
     sessionBgStates.delete(sessionID);
   }
 }
+function bufferUnknownCompletion(state, completion) {
+  const now = Date.now();
+  pruneUnknownCompletions(state, now);
+  state.unknownCompletions = state.unknownCompletions.filter((entry) => entry.completion.task_id !== completion.task_id);
+  state.unknownCompletions.push({ completion, receivedAt: now });
+  if (state.unknownCompletions.length > UNKNOWN_COMPLETION_CAP) {
+    state.unknownCompletions.splice(0, state.unknownCompletions.length - UNKNOWN_COMPLETION_CAP);
+  }
+}
+function pruneUnknownCompletions(state, now) {
+  state.unknownCompletions = state.unknownCompletions.filter((entry) => now - entry.receivedAt <= UNKNOWN_COMPLETION_TTL_MS);
+}
 function isBgCompletion(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return false;
@@ -8114,10 +8166,26 @@ function isBgCompletion(value) {
 function formatCompletion(completion) {
   const status = formatStatus(completion);
   const duration = formatDuration(completion);
-  return `task ${completion.task_id} (${status}${duration ? `, ${duration}` : ""}): ${completion.command}`;
+  const header = `- task ${completion.task_id} (${status}${duration ? `, ${duration}` : ""})`;
+  const previewBlock = formatOutputPreview(completion);
+  return previewBlock ? `${header}
+${previewBlock}` : header;
+}
+function formatOutputPreview(completion) {
+  const ansiRegex = /\x1b\[[0-9;]*[a-zA-Z]/g;
+  const raw = (completion.output_preview ?? "").replace(ansiRegex, "");
+  if (!raw.trim())
+    return "";
+  const trimmed = raw.replace(/\n+$/, "");
+  const ellipsis = completion.output_truncated ? "…" : "";
+  const indented = trimmed.split(`
+`).map((line) => `    ${line}`).join(`
+`);
+  return ellipsis ? `    ${ellipsis}
+${indented}` : indented;
 }
 function formatStatus(completion) {
-  if (completion.status === "timeout")
+  if (completion.status === "timed_out" || completion.status === "timeout")
     return "timed out";
   if (completion.status === "killed")
     return "killed";
@@ -21949,6 +22017,7 @@ var ExperimentalConfigSchema = exports_external.object({
 });
 var AftConfigSchema = exports_external.object({
   format_on_edit: exports_external.boolean().optional(),
+  formatter_timeout_secs: exports_external.number().int().min(1).max(600).optional(),
   validate_on_edit: exports_external.enum(["syntax", "full"]).optional(),
   formatter: exports_external.record(exports_external.string(), FormatterEnum).optional(),
   checker: exports_external.record(exports_external.string(), CheckerEnum).optional(),
@@ -22038,6 +22107,18 @@ function isWritableMigrationError(errorValue) {
   const code = errorValue?.code;
   return code === "EROFS" || code === "EACCES" || code === "EPERM";
 }
+function extractCommentsForPreservation(content) {
+  const comments = [];
+  const linePattern = /\/\/[^\n]*/g;
+  for (const match of content.match(linePattern) ?? []) {
+    comments.push(match.trim());
+  }
+  const blockPattern = /\/\*[\s\S]*?\*\//g;
+  for (const match of content.match(blockPattern) ?? []) {
+    comments.push(match.replace(/\s+/g, " ").trim());
+  }
+  return comments;
+}
 function ensureRecordAtPath(root, path2) {
   let current = root;
   for (const segment of path2) {
@@ -22096,10 +22177,9 @@ function migrateAftConfigFile(configPath, logger = { log, warn }) {
     if (oldKeys.length === 0) {
       return { migrated: false, oldKeys: [] };
     }
-    const comments = content.match(/^\s*\/\/.*$/gm) ?? [];
     const serialized = `${import_comment_json.stringify(rawConfig, null, 2)}
 `;
-    const preservedComments = comments.filter((comment) => !serialized.includes(comment.trim()));
+    const preservedComments = extractCommentsForPreservation(content).filter((comment) => !serialized.includes(comment.trim()));
     const nextContent = preservedComments.length > 0 ? `${preservedComments.join(`
 `)}
 ${serialized}` : serialized;
@@ -23738,7 +23818,7 @@ import { join as join6 } from "node:path";
 var WARNING_MARKER = "\uD83D\uDD27 AFT: ⚠️";
 var FEATURE_MARKER = "\uD83D\uDD27 AFT: ✨";
 var WARNED_TOOLS_FILE = "warned_tools.json";
-function sendIgnoredMessage(client, _sessionId, text) {
+function sendIgnoredMessage(client, sessionId, text) {
   const typedClient = client;
   if (typeof typedClient.ui?.notify !== "function")
     return false;
@@ -23746,7 +23826,7 @@ function sendIgnoredMessage(client, _sessionId, text) {
     typedClient.ui.notify(text, "warning");
     return true;
   } catch (err) {
-    log(`[aft-pi] notification send failed: ${err instanceof Error ? err.message : String(err)}`);
+    sessionLog(sessionId, `[aft-pi] notification send failed: ${err instanceof Error ? err.message : String(err)}`);
     return false;
   }
 }
@@ -24387,6 +24467,7 @@ class BinaryBridge {
   minVersion;
   onVersionMismatch;
   onConfigureWarnings;
+  onBashCompletion;
   restartResetTimer = null;
   constructor(binaryPath, cwd, options, configOverrides) {
     this.binaryPath = binaryPath;
@@ -24397,6 +24478,7 @@ class BinaryBridge {
     this.minVersion = options?.minVersion;
     this.onVersionMismatch = options?.onVersionMismatch;
     this.onConfigureWarnings = options?.onConfigureWarnings;
+    this.onBashCompletion = options?.onBashCompletion;
   }
   get restartCount() {
     return this._restartCount;
@@ -24404,6 +24486,9 @@ class BinaryBridge {
   isAlive() {
     return this.process !== null && this.process.exitCode === null && !this.process.killed;
   }
+  hasPendingRequests() {
+    return this.pending.size > 0;
+  }
   async send(command, params = {}, options) {
     if (this._shuttingDown) {
       throw new Error(`[aft-pi] Bridge is shutting down, cannot send "${command}"`);
@@ -24457,17 +24542,21 @@ class BinaryBridge {
 `;
     const effectiveTimeoutMs = options?.transportTimeoutMs ?? options?.timeoutMs ?? this.timeoutMs;
     const requestSessionId = typeof params.session_id === "string" && params.session_id.length > 0 ? params.session_id : undefined;
+    const keepBridgeOnTimeout = options?.keepBridgeOnTimeout === true;
     return new Promise((resolve3, reject) => {
       const timer = setTimeout(() => {
         this.pending.delete(id);
-        const timeoutMsg = `Request "${command}" (id=${id}) timed out after ${effectiveTimeoutMs}ms — restarting bridge`;
+        const restartSuffix = keepBridgeOnTimeout ? "" : " — restarting bridge";
+        const timeoutMsg = `Request "${command}" (id=${id}) timed out after ${effectiveTimeoutMs}ms${restartSuffix}`;
         if (requestSessionId) {
           sessionWarn(requestSessionId, timeoutMsg);
         } else {
           warn(timeoutMsg);
         }
         reject(new Error(`[aft-pi] Request "${command}" (id=${id}) timed out after ${effectiveTimeoutMs}ms`));
-        this.handleTimeout();
+        if (!keepBridgeOnTimeout) {
+          this.handleTimeout();
+        }
       }, effectiveTimeoutMs);
       this.pending.set(id, { resolve: resolve3, reject, timer, onProgress: options?.onProgress });
       if (!this.process?.stdin?.writable) {
@@ -24672,6 +24761,10 @@ class BinaryBridge {
           }
           continue;
         }
+        if (response.type === "bash_completed") {
+          this.onBashCompletion?.(response, this);
+          continue;
+        }
         const id = response.id;
         if (id && this.pending.has(id)) {
           const entry = this.pending.get(id);
@@ -24681,6 +24774,8 @@ class BinaryBridge {
           clearTimeout(entry.timer);
           this.scheduleRestartCountReset();
           entry.resolve(response);
+        } else if (typeof response.type === "string") {
+          log(`Ignoring unknown stdout push frame type: ${response.type}`);
         }
       } catch (_err) {
         warn(`Failed to parse stdout line: ${line}`);
@@ -24778,7 +24873,8 @@ class BridgePool {
       maxRestarts: options.maxRestarts,
       minVersion: options.minVersion,
       onVersionMismatch: options.onVersionMismatch,
-      onConfigureWarnings: options.onConfigureWarnings
+      onConfigureWarnings: options.onConfigureWarnings,
+      onBashCompletion: options.onBashCompletion
     };
     this.configOverrides = configOverrides;
     if (Number.isFinite(this.idleTimeoutMs)) {
@@ -24801,6 +24897,14 @@ class BridgePool {
     }
     return null;
   }
+  getActiveBridgeForRoot(directory) {
+    const key = canonicalKey(directory);
+    const entry = this.bridges.get(key);
+    if (!entry?.bridge.isAlive())
+      return null;
+    entry.lastUsed = Date.now();
+    return entry.bridge;
+  }
   getBridge(directory) {
     const key = canonicalKey(directory);
     const existing = this.bridges.get(key);
@@ -25674,6 +25778,7 @@ function registerBashTool(pi, ctx) {
         compressed: params.compressed
       }, extCtx, {
         transportTimeoutMs: bashTransportTimeoutMs(params.timeout),
+        keepBridgeOnTimeout: true,
         onProgress: ({ text }) => {
           streamed += text;
           const displayText = truncateToVisualLines(streamed, 100);
@@ -25748,7 +25853,7 @@ function createBashKillTool(ctx) {
         throw new Error(data.message ?? "bash_kill failed");
       }
       const details = data;
-      return bashKillResult(`Task ${params.task_id}: killed`, details);
+      return bashKillResult(`Task ${params.task_id}: ${details.status}`, details);
     }
   };
 }
@@ -25779,10 +25884,11 @@ function bashKillResult(output, details) {
 }
 function formatBashStatus(taskId, details) {
   const exit = typeof details.exit_code === "number" ? ` (exit ${details.exit_code})` : "";
-  let text = `Task ${taskId}: ${details.status}${exit}`;
+  const dur = typeof details.duration_ms === "number" ? ` ${Math.round(details.duration_ms / 1000)}s` : "";
+  let text = `Task ${taskId}: ${details.status}${exit}${dur}`;
   if (isTerminalStatus(details.status) && details.output_preview) {
     text += `
-${details.output_preview.slice(0, 200)}`;
+${details.output_preview.slice(0, 2000)}`;
   }
   return text;
 }
@@ -25810,6 +25916,17 @@ ${theme.fg("error", errorText || "bash failed")}`);
   const container = reuseContainer2(context.lastComponent);
   container.clear();
   container.addChild(new Spacer2(1));
+  const rawOutput = result.content.filter((c) => c.type === "text").map((c) => c.text ?? "").join(`
+`).trim();
+  if (rawOutput) {
+    const lines = rawOutput.split(`
+`);
+    const preview = lines.length > 25 ? `... (${lines.length - 25} lines omitted)
+${lines.slice(-25).join(`
+`)}` : rawOutput;
+    container.addChild(new Text2(preview, 1, 0));
+    container.addChild(new Spacer2(1));
+  }
   if (exitCode !== undefined) {
     const exitColor = exitCode === 0 ? "success" : "error";
     const exitText = theme.fg(exitColor, `exit ${exitCode}`);
@@ -26248,12 +26365,15 @@ function buildMutationResult(filePath, response) {
   const replacements = response.replacements;
   const diagnostics = response.lsp_diagnostics;
   const truncated = diffObj?.truncated === true;
+  const formatted = response.formatted;
+  const formatSkippedReason = response.format_skipped_reason;
+  const globFormatSkipReasons = response.format_skip_reasons;
   let diffText;
   let firstChangedLine;
   if (diffObj && !truncated && typeof diffObj.before === "string" && typeof diffObj.after === "string") {
-    const formatted = formatDiffForPi(diffObj.before, diffObj.after);
-    diffText = formatted.diff;
-    firstChangedLine = formatted.firstChangedLine;
+    const piDiff = formatDiffForPi(diffObj.before, diffObj.after);
+    diffText = piDiff.diff;
+    firstChangedLine = piDiff.firstChangedLine;
   }
   const summaryHeader = replacements !== undefined ? `Edited ${filePath} (+${additions}/-${deletions}, ${replacements} replacement${replacements === 1 ? "" : "s"})` : `Wrote ${filePath} (+${additions}/-${deletions})`;
   let text = summaryHeader;
@@ -26266,6 +26386,16 @@ ${diffText}`;
 
 (diff truncated — file too large to include before/after content)`;
   }
+  const skipNote = formatSkipReasonNote(formatSkippedReason);
+  if (skipNote)
+    text += `
+
+${skipNote}`;
+  const globSkipNote = formatGlobSkipReasonsNote(globFormatSkipReasons);
+  if (globSkipNote)
+    text += `
+
+${globSkipNote}`;
   if (diagnostics && diagnostics.length > 0) {
     text += `
 
@@ -26281,10 +26411,34 @@ ${formatDiagnosticsText(diagnostics)}`;
       deletions,
       replacements,
       diagnostics,
-      truncated: truncated || undefined
+      truncated: truncated || undefined,
+      formatted,
+      formatSkippedReason
     }
   };
 }
+function formatGlobSkipReasonsNote(reasons) {
+  if (!Array.isArray(reasons))
+    return;
+  const actionable = reasons.filter((reason) => typeof reason === "string").filter((reason) => ["formatter_not_installed", "formatter_excluded_path", "timeout", "error"].includes(reason));
+  if (actionable.length === 0)
+    return;
+  return `Note: formatter skipped some glob edit result file(s): ${[...new Set(actionable)].sort().join(", ")}. See per-file format_skipped_reason values for details.`;
+}
+function formatSkipReasonNote(reason) {
+  switch (reason) {
+    case "formatter_not_installed":
+      return "Note: formatter binary not installed; file written unformatted.";
+    case "timeout":
+      return "Note: formatter timed out; file written unformatted. Raise formatter_timeout_secs or check the formatter for hangs.";
+    case "formatter_excluded_path":
+      return "Note: formatter is configured to ignore this path (e.g. biome.json files.includes, .prettierignore). File written unformatted.";
+    case "error":
+      return "Note: formatter exited with an unrecognized error; file written unformatted.";
+    default:
+      return;
+  }
+}
 function formatDiagnosticsText(diagnostics) {
   try {
     return diagnostics.map((d) => {
@@ -26856,6 +27010,29 @@ function buildOutlineSections(text, theme) {
 `)];
 }
 function buildZoomSections(args, payload, theme) {
+  const batch = asRecord2(payload);
+  if (Array.isArray(batch?.symbols)) {
+    const header = batch.complete === false ? [theme.fg("warning", "Incomplete zoom results")] : [];
+    const items2 = batch.symbols;
+    return [
+      ...header,
+      ...items2.map((item) => {
+        const record2 = asRecord2(item);
+        if (!record2)
+          return theme.fg("muted", "No zoom result available.");
+        const name = asString(record2.name) ?? "(unknown symbol)";
+        if (record2.success === false) {
+          return theme.fg("error", `Symbol "${name}" not found: ${asString(record2.error) ?? "zoom failed"}`);
+        }
+        const content = asString(record2.content);
+        return [
+          `${theme.fg("accent", name)} ${theme.fg("muted", shortenPath(args.filePath))}`,
+          content
+        ].filter(Boolean).join(`
+`);
+      })
+    ];
+  }
   const items = Array.isArray(payload) ? payload : payload ? [payload] : [];
   if (items.length === 0)
     return [theme.fg("muted", "No zoom result available.")];
@@ -26974,9 +27151,13 @@ function registerReadingTools(pi, ctx, surface) {
             const req2 = { file: params.filePath, symbol: sym };
             if (params.contextLines !== undefined)
               req2.context_lines = params.contextLines;
-            return callBridge(bridge, "zoom", req2, extCtx);
+            return callBridge(bridge, "zoom", req2, extCtx).catch((err) => ({
+              success: false,
+              message: err instanceof Error ? err.message : String(err)
+            }));
           }));
-          return textResult(JSON.stringify(results, null, 2));
+          const batch = formatZoomBatchResult(params.symbols, results);
+          return textResult(batch.text, batch);
         }
         const req = { file: params.filePath };
         if (params.symbol)
@@ -26995,6 +27176,40 @@ function registerReadingTools(pi, ctx, surface) {
     });
   }
 }
+function formatZoomBatchResult(symbols, responses) {
+  const entries = symbols.map((name, index) => {
+    const response = responses[index] ?? { success: false, message: "missing zoom response" };
+    if (response.success === false) {
+      const message = typeof response.message === "string" && response.message.length > 0 ? response.message : "zoom failed";
+      return { name, success: false, error: message };
+    }
+    return { name, success: true, content: zoomResponseContent(response) };
+  });
+  const complete = entries.every((entry) => entry.success);
+  const lines = [];
+  if (!complete) {
+    lines.push("Incomplete zoom results: one or more symbols failed.");
+  }
+  for (const entry of entries) {
+    if (entry.success) {
+      lines.push(`Symbol "${entry.name}":
+${entry.content ?? ""}`.trimEnd());
+    } else {
+      lines.push(`Symbol "${entry.name}" not found: ${entry.error ?? "zoom failed"}`);
+    }
+  }
+  return { complete, symbols: entries, text: lines.join(`
+
+`) };
+}
+function zoomResponseContent(response) {
+  if (typeof response.content === "string")
+    return response.content;
+  if (typeof response.text === "string")
+    return response.text;
+  const { success: _success2, ...rest } = response;
+  return JSON.stringify(rest, null, 2);
+}
 function formatOutlineText(response) {
   const text = response.text ?? "";
   const skipped = response.skipped_files;
@@ -27486,6 +27701,83 @@ function validateTransformParams(params) {
   }
 }
 
+// src/workflow-hints.ts
+var HEADING = "## Prefer AFT tools for token efficiency";
+function buildWorkflowHints(opts) {
+  const sections = [];
+  const grepName = opts.hoistBuiltins ? "grep" : "aft_grep";
+  const bashName = opts.hoistBuiltins ? "bash" : "aft_bash";
+  const hasOutline = !opts.absentTools.has("aft_outline");
+  const hasZoom = !opts.absentTools.has("aft_zoom");
+  const hasGrep = opts.toolSurface !== "minimal" && !opts.absentTools.has(grepName);
+  const hasSearch = opts.toolSurface !== "minimal" && opts.semanticEnabled && !opts.absentTools.has("aft_search");
+  const hasNavigate = opts.toolSurface === "all" && !opts.absentTools.has("aft_navigate");
+  const hasBgBash = opts.bashBackgroundEnabled && !opts.absentTools.has(bashName) && !opts.absentTools.has("bash_status");
+  if (hasOutline && hasZoom) {
+    sections.push(`**Web/URL access**: \`aft_outline({ url })\` first for structure, then \`aft_zoom({ url, symbol: "<heading>" })\` for the specific section.`);
+  }
+  if (hasOutline && hasZoom && (hasGrep || hasSearch)) {
+    const locator = hasGrep && hasSearch ? `\`${grepName}\` or \`aft_search\`` : hasGrep ? `\`${grepName}\`` : "`aft_search`";
+    sections.push(`**Code exploration**: ${locator} to locate → \`aft_outline\` for structure → \`aft_zoom\` for symbol(s).`);
+  }
+  if (hasNavigate) {
+    sections.push([
+      "Use `aft_navigate` instead of grep + read chains for relationship questions:",
+      "- `callers` — find all call sites before changing a function signature",
+      "- `impact` — blast radius (which functions/files will need updates)",
+      "- `trace_to` — how execution reaches this code from entry points (routes, exports, main)",
+      "- `trace_data` — follow a value through assignments and parameters across files"
+    ].join(`
+`));
+  }
+  if (hasBgBash) {
+    sections.push(`**Long-running commands** (builds, installs, full test suites): \`${bashName}({ background: true })\` returns immediately with a \`taskId\`. Check progress with \`bash_status({ taskId })\`.`);
+  }
+  if (sections.length === 0) {
+    return null;
+  }
+  return `${HEADING}
+
+${sections.join(`
+
+`)}`;
+}
+function buildHintsFromConfig(config2, absentTools, hoistBuiltins) {
+  return buildWorkflowHints({
+    toolSurface: config2.tool_surface ?? "recommended",
+    hoistBuiltins,
+    semanticEnabled: config2.semantic_search === true,
+    bashBackgroundEnabled: config2.experimental?.bash?.background === true,
+    absentTools
+  });
+}
+function registerWorkflowHints(pi, config2, surface) {
+  const absent = new Set;
+  if (!surface.outline)
+    absent.add("aft_outline");
+  if (!surface.zoom)
+    absent.add("aft_zoom");
+  if (!surface.semantic)
+    absent.add("aft_search");
+  if (!surface.navigate)
+    absent.add("aft_navigate");
+  if (!surface.hoistGrep)
+    absent.add("grep");
+  if (!surface.hoistBash) {
+    absent.add("bash");
+    absent.add("bash_status");
+  }
+  const hintsBlock = buildHintsFromConfig(config2, absent, true);
+  if (!hintsBlock)
+    return;
+  log(`Workflow hints injected (${hintsBlock.length} chars)`);
+  pi.on("before_agent_start", (event) => {
+    return { systemPrompt: `${event.systemPrompt}
+
+${hintsBlock}` };
+  });
+}
+
 // src/index.ts
 var PLUGIN_VERSION = (() => {
   try {
@@ -27531,6 +27823,7 @@ function resolveToolSurface(config2) {
   const allOnly = (name) => ALL_ONLY_TOOLS.has(name) && ok(name);
   if (surface === "minimal") {
     return {
+      hoistBash: ok("bash"),
       hoistRead: false,
       hoistWrite: false,
       hoistEdit: false,
@@ -27552,6 +27845,7 @@ function resolveToolSurface(config2) {
     };
   }
   const base = {
+    hoistBash: ok("bash"),
     hoistRead: ok("read"),
     hoistWrite: ok("write"),
     hoistEdit: ok("edit"),
@@ -27608,6 +27902,8 @@ async function src_default(pi) {
   const configOverrides = {};
   if (config2.format_on_edit !== undefined)
     configOverrides.format_on_edit = config2.format_on_edit;
+  if (config2.formatter_timeout_secs !== undefined)
+    configOverrides.formatter_timeout_secs = config2.formatter_timeout_secs;
   if (config2.validate_on_edit !== undefined)
     configOverrides.validate_on_edit = config2.validate_on_edit;
   if (config2.formatter !== undefined)
@@ -27709,6 +28005,15 @@ ${lines}
         pluginVersion: PLUGIN_VERSION,
         projectRoot
       }, validWarnings);
+    },
+    onBashCompletion: (completion, bridge) => {
+      handlePushedBgCompletion({
+        ctx,
+        directory: process.cwd(),
+        sessionID: completion.session_id,
+        runtime: pi,
+        isActive: () => bridge.hasPendingRequests()
+      }, completion);
     }
   }, configOverrides);
   const ctx = { pool, config: config2, storageDir };
@@ -27716,7 +28021,7 @@ ${lines}
     sendFeatureAnnouncement(ANNOUNCEMENT_VERSION, ANNOUNCEMENT_FEATURES, storageDir);
   }
   const surface = resolveToolSurface(config2);
-  if (surface.hoistRead) {
+  if (surface.hoistBash) {
     registerBashTool(pi, ctx);
   }
   registerHoistedTools(pi, ctx, surface);
@@ -27753,6 +28058,7 @@ ${lines}
   if (surface.refactor) {
     registerRefactorTool(pi, ctx);
   }
+  registerWorkflowHints(pi, config2, surface);
   registerStatusCommand(pi, ctx);
   pi.on("tool_result", async (event, extCtx) => {
     const content = await appendToolResultBgCompletions({ ctx, directory: extCtx.cwd, sessionID: resolveSessionId(extCtx) }, event.content);
@@ -27791,6 +28097,8 @@ ${lines}
   });
   log(`AFT extension ready (surface=${config2.tool_surface ?? "recommended"})`);
 }
+var __test__ = { resolveToolSurface };
 export {
-  src_default as default
+  src_default as default,
+  __test__
 };

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAiEA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEnF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAErF;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAmEA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEnF;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAEpF;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAErF;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2FD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAqBN"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8FD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAqBN"}

package/dist/pool.d.ts

@@ -22,6 +22,8 @@ export declare class BridgePool {
     constructor(binaryPath: string, options?: PoolOptions, configOverrides?: Record<string, unknown>);
     /** Get any existing alive bridge, preferring the given directory. */
     getAnyActiveBridge(directory: string): BinaryBridge | null;
+    /** Get an alive bridge only when it belongs to the requested directory. */
+    getActiveBridgeForRoot(directory: string): BinaryBridge | null;
     /** Get or create a bridge for the given directory. */
     getBridge(directory: string): BinaryBridge;
     private cleanup;

package/dist/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAY/D,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,YAAY,CAA+C;gBAGjE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,EACzB,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAmB/C,qEAAqE;IACrE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAgB1D,sDAAsD;IACtD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAiB1C,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,QAAQ;IAgBV,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAY/D,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,YAAY,CAA+C;gBAGjE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,WAAgB,EACzB,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAoB/C,qEAAqE;IACrE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAgB1D,2EAA2E;IAC3E,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAQ9D,sDAAsD;IACtD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAiB1C,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,QAAQ;IAgBV,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/tools/bash.d.ts

@@ -8,6 +8,7 @@ interface BashStatusDetails {
     success: boolean;
     status: string;
     exit_code?: number;
+    duration_ms?: number;
     output_preview?: string;
     command?: string;
 }

package/dist/tools/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2DjD,QAAA,MAAM,cAAc;;EAIlB,CAAC;AAWH,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAqG3E;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa;;;;;;;;yBASpC,MAAM,UACX,MAAM,CAAC,OAAO,cAAc,CAAC,WAC5B,WAAW,GAAG,SAAS,aACrB,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,UACrE,gBAAgB;EAW7B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa;;;;;;;;yBASlC,MAAM,UACX,MAAM,CAAC,OAAO,cAAc,CAAC,WAC5B,WAAW,GAAG,SAAS,aACrB,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,UACnE,gBAAgB;EAW7B"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2DjD,QAAA,MAAM,cAAc;;EAIlB,CAAC;AAWH,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA2G3E;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa;;;;;;;;yBASpC,MAAM,UACX,MAAM,CAAC,OAAO,cAAc,CAAC,WAC5B,WAAW,GAAG,SAAS,aACrB,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,UACrE,gBAAgB;EAW7B;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa;;;;;;;;yBASlC,MAAM,UACX,MAAM,CAAC,OAAO,cAAc,CAAC,WAC5B,WAAW,GAAG,SAAS,aACrB,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,UACnE,gBAAgB;EAW7B"}

package/dist/tools/hoisted.d.ts

@@ -39,6 +39,22 @@ interface FileMutationDetails {
      * surface this explicitly rather than silently showing a summary.
      */
     truncated?: boolean;
+    /**
+     * Whether AFT's auto-formatter ran on the post-write content. Mirrors the
+     * `data.formatted` field from the Rust write/edit response. When true,
+     * the file content on disk is what the formatter produced; when false,
+     * `formatSkippedReason` explains why.
+     */
+    formatted?: boolean;
+    /**
+     * Reason the formatter was skipped, when `formatted=false`. One of the
+     * documented values from `crates/aft/src/format.rs::auto_format`:
+     * `"unsupported_language"`, `"no_formatter_configured"`,
+     * `"formatter_not_installed"`, `"formatter_excluded_path"`, `"timeout"`,
+     * `"error"`. Pi agents read this to decide whether to retry, fix config,
+     * or accept the unformatted result.
+     */
+    formatSkippedReason?: string;
 }
 export declare function registerHoistedTools(pi: ExtensionAPI, ctx: PluginContext, surface: ToolSurfaceFlags): void;
 /**

package/dist/tools/hoisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAGlB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2DjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAmLN;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAAC,mBAAmB,CAAC,CA6DtC;AAwHD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,OAAO,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAgBR"}
+{"version":3,"file":"hoisted.d.ts","sourceRoot":"","sources":["../../src/tools/hoisted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAGlB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2DjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAmLN;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe,CAAC,mBAAmB,CAAC,CAiFtC;AAwJD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,OAAO,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAgBR"}

package/dist/tools/reading.d.ts

@@ -21,6 +21,17 @@ export interface ReadingSurface {
     outline: boolean;
     zoom: boolean;
 }
+interface ZoomBatchSymbolResult {
+    name: string;
+    success: boolean;
+    content?: string;
+    error?: string;
+}
+interface ZoomBatchResult {
+    complete: boolean;
+    symbols: ZoomBatchSymbolResult[];
+    text: string;
+}
 /** Exported for renderer unit tests. */
 export declare function buildOutlineSections(text: string, theme: Theme): string[];
 /** Exported for renderer unit tests. */
@@ -34,5 +45,7 @@ export declare function renderZoomCall(args: Static<typeof ZoomParams>, theme: T
 /** Exported for renderer unit tests. */
 export declare function renderZoomResult(result: AgentToolResult<unknown>, args: Static<typeof ZoomParams>, theme: Theme, context: RenderContextLike): import("@mariozechner/pi-tui").Text | import("@mariozechner/pi-tui").Container;
 export declare function registerReadingTools(pi: ExtensionAPI, ctx: PluginContext, surface: ReadingSurface): void;
+/** Exported for regression tests. */
+export declare function formatZoomBatchResult(symbols: string[], responses: Record<string, unknown>[]): ZoomBatchResult;
 export {};
 //# sourceMappingURL=reading.d.ts.map

package/dist/tools/reading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,aAAa;;;;EAYjB,CAAC;AAEH,QAAA,MAAM,UAAU;;;;;EAWd,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAOzE;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CA4DV;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,uCAU3B;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,kFAI3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,uCAQ3B;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,kFAI3B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,GACtB,IAAI,CAkHN"}
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tools/reading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAOL,KAAK,iBAAiB,EAKvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,aAAa;;;;EAYjB,CAAC;AAEH,QAAA,MAAM,UAAU;;;;;EAWd,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAOzE;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAuFV;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,uCAU3B;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,kFAI3B;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,uCAQ3B;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,EAChC,IAAI,EAAE,MAAM,CAAC,OAAO,UAAU,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,kFAI3B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,GACtB,IAAI,CAsHN;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACnC,eAAe,CA0BjB"}

package/dist/workflow-hints.d.ts

@@ -0,0 +1,31 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { AftConfig } from "./config.js";
+export interface WorkflowHintsOpts {
+    toolSurface: "minimal" | "recommended" | "all";
+    hoistBuiltins: boolean;
+    semanticEnabled: boolean;
+    bashBackgroundEnabled: boolean;
+    /** Set of tool names KNOWN-ABSENT from the registered surface. */
+    absentTools: Set<string>;
+}
+export declare function buildWorkflowHints(opts: WorkflowHintsOpts): string | null;
+export declare function buildHintsFromConfig(config: AftConfig, absentTools: Set<string>, hoistBuiltins: boolean): string | null;
+interface ToolSurfaceFlags {
+    outline: boolean;
+    zoom: boolean;
+    semantic: boolean;
+    navigate: boolean;
+    hoistGrep: boolean;
+    hoistBash: boolean;
+}
+/**
+ * Register the workflow-hints extension on Pi via `before_agent_start`.
+ *
+ * Pi assembles a fresh system prompt for every turn, then fires
+ * `before_agent_start` with the assembled prompt. Our handler appends the
+ * AFT workflow hints block to that prompt. If multiple extensions return a
+ * `systemPrompt`, Pi chains them — so we always append (never replace).
+ */
+export declare function registerWorkflowHints(pi: ExtensionAPI, config: AftConfig, surface: ToolSurfaceFlags): void;
+export {};
+//# sourceMappingURL=workflow-hints.d.ts.map

package/dist/workflow-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../src/workflow-hints.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CA8DzE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,IAAI,CAQf;AAMD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CA8BN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-pi",
-  "version": "0.18.2",
+  "version": "0.18.4",
   "type": "module",
   "description": "Pi coding agent extension for Agent File Tools (AFT) — tree-sitter and LSP-powered code analysis",
   "main": "dist/index.js",
@@ -18,6 +18,7 @@
     "build": "bun build src/index.ts --outdir dist --target node --format esm --external @mariozechner/pi-coding-agent --external @mariozechner/pi-ai --external @mariozechner/pi-tui --external @sinclair/typebox --external diff && tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "test": "bun test src/__tests__/",
+    "lint": "biome check src",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
@@ -27,11 +28,11 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.18.2",
-    "@cortexkit/aft-darwin-x64": "0.18.2",
-    "@cortexkit/aft-linux-arm64": "0.18.2",
-    "@cortexkit/aft-linux-x64": "0.18.2",
-    "@cortexkit/aft-win32-x64": "0.18.2"
+    "@cortexkit/aft-darwin-arm64": "0.18.4",
+    "@cortexkit/aft-darwin-x64": "0.18.4",
+    "@cortexkit/aft-linux-arm64": "0.18.4",
+    "@cortexkit/aft-linux-x64": "0.18.4",
+    "@cortexkit/aft-win32-x64": "0.18.4"
   },
   "devDependencies": {
     "@mariozechner/pi-coding-agent": "*",