@cortexkit/aft 0.50.2 → 0.51.0

package/dist/index.js

@@ -515,6 +515,122 @@ var CONFLICT_HINT = `
 [Hint] Use aft_conflicts to see all conflict regions across files in a single call.`, GREP_SEARCH_AFT_SEARCH_HINT = "DO NOT search code by running grep/rg in bash — it is unindexed, unranked, and serial. Use the `aft_search` tool instead (it auto-routes concepts, identifiers, regex, and literals).", GREP_SEARCH_GREP_HINT = "DO NOT search code by running grep/rg in bash — it is unindexed, unranked, and serial. Use the `grep` tool instead (indexed and ranked).", GREP_SEARCH_HINT_PREFIX = "DO NOT search code by running grep/rg in bash —", GREP_SEARCH_FRESHNESS_WINDOW_MS = 60000;
 var init_bash_hints = () => {};
 
+// ../aft-bridge/dist/bash-host-fallback.js
+import { spawn } from "node:child_process";
+function bashHostFallbackAskPattern(command, cwd) {
+  return `AFT UNAVAILABLE - host fallback execution:
+
+Exact command:
+${command}
+
+Working directory:
+${cwd}`;
+}
+function appendTail(chunks, chunk) {
+  const combined = Buffer.concat([...chunks, chunk]);
+  if (combined.byteLength <= BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES) {
+    return { chunks: [combined], truncated: false };
+  }
+  return {
+    chunks: [combined.subarray(combined.byteLength - BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES)],
+    truncated: true
+  };
+}
+function renderOutput(output, exitCode) {
+  const body = output.toString("utf8");
+  const separator = body.length === 0 || body.endsWith(`
+`) ? "" : `
+`;
+  return `${BASH_HOST_FALLBACK_BANNER}
+${body}${separator}[exit code: ${exitCode}]`;
+}
+async function runBashHostFallback(options) {
+  const timeoutMs = Math.min(Math.max(1, options.timeoutMs ?? BASH_HOST_FALLBACK_MAX_TIMEOUT_MS), BASH_HOST_FALLBACK_MAX_TIMEOUT_MS);
+  if (options.signal?.aborted) {
+    throw new DOMException("The host fallback command was aborted", "AbortError");
+  }
+  return await new Promise((resolve2, reject) => {
+    const child = spawn(options.command, {
+      cwd: options.projectRoot,
+      shell: true,
+      env: { ...process.env, ...options.env },
+      stdio: ["ignore", "pipe", "pipe"],
+      detached: process.platform !== "win32",
+      windowsHide: true
+    });
+    let chunks = [];
+    let truncated = false;
+    let timedOut = false;
+    let aborted = false;
+    let settled = false;
+    let abortForceTimer;
+    const capture = (chunk) => {
+      const next = appendTail(chunks, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      chunks = next.chunks;
+      truncated ||= next.truncated;
+    };
+    child.stdout?.on("data", capture);
+    child.stderr?.on("data", capture);
+    const kill = (signal) => {
+      if (child.exitCode !== null || child.signalCode !== null)
+        return;
+      if (process.platform !== "win32" && child.pid !== undefined) {
+        try {
+          process.kill(-child.pid, signal);
+          return;
+        } catch {}
+      }
+      child.kill(signal);
+    };
+    const onAbort = () => {
+      aborted = true;
+      kill("SIGTERM");
+      abortForceTimer = setTimeout(() => kill("SIGKILL"), 250);
+      abortForceTimer.unref?.();
+    };
+    options.signal?.addEventListener("abort", onAbort, { once: true });
+    const timer = setTimeout(() => {
+      timedOut = true;
+      kill("SIGKILL");
+    }, timeoutMs);
+    const cleanup = () => {
+      clearTimeout(timer);
+      if (abortForceTimer !== undefined)
+        clearTimeout(abortForceTimer);
+      options.signal?.removeEventListener("abort", onAbort);
+    };
+    child.once("error", (error2) => {
+      if (settled)
+        return;
+      settled = true;
+      cleanup();
+      reject(error2);
+    });
+    child.once("close", (code) => {
+      if (settled)
+        return;
+      settled = true;
+      cleanup();
+      if (aborted) {
+        reject(new DOMException("The host fallback command was aborted", "AbortError"));
+        return;
+      }
+      const exitCode = timedOut ? 124 : code ?? 1;
+      resolve2({
+        success: true,
+        output: renderOutput(Buffer.concat(chunks), exitCode),
+        exit_code: exitCode,
+        truncated
+      });
+    });
+  });
+}
+var BASH_HOST_FALLBACK_BANNER = "[AFT host fallback - module transport down; no rewrites/compression/background]", BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES, BASH_HOST_FALLBACK_MAX_TIMEOUT_MS, BASH_HOST_FALLBACK_REFUSAL = "AFT transport is down; only foreground execution is available in host fallback";
+var init_bash_host_fallback = __esm(() => {
+  BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES = 100 * 1024;
+  BASH_HOST_FALLBACK_MAX_TIMEOUT_MS = 10 * 60 * 1000;
+});
+
 // ../aft-bridge/dist/bash-timeout.js
 function resolveBashKillTimeout(modelTimeout, foregroundWaitMs) {
   if (modelTimeout !== undefined && modelTimeout >= foregroundWaitMs) {
@@ -548,58 +664,8 @@ var init_command_timeouts = __esm(() => {
   PASSIVE_COMMANDS = new Set(["status"]);
 });
 
-// ../aft-bridge/dist/status-bar.js
-function createStatusBarEmitState() {
-  return { callsSinceEmit: 0 };
-}
-function parseStatusBarCounts(value) {
-  if (!value || typeof value !== "object")
-    return;
-  const record = value;
-  const num = (key) => {
-    const raw = record[key];
-    return typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
-  };
-  return {
-    errors: num("errors"),
-    warnings: num("warnings"),
-    dead_code: num("dead_code"),
-    unused_exports: num("unused_exports"),
-    duplicates: num("duplicates"),
-    todos: num("todos"),
-    tier2_stale: record.tier2_stale === true,
-    ...typeof record.line === "string" ? { line: record.line } : {}
-  };
-}
-function countsEqual(a, b) {
-  return a.errors === b.errors && a.warnings === b.warnings && a.dead_code === b.dead_code && a.unused_exports === b.unused_exports && a.duplicates === b.duplicates && a.todos === b.todos && a.tier2_stale === b.tier2_stale && a.line === b.line;
-}
-function shouldEmitStatusBar(state, next) {
-  const changed = state.last === undefined || !countsEqual(state.last, next);
-  state.callsSinceEmit += 1;
-  const heartbeat = state.callsSinceEmit >= STATUS_BAR_HEARTBEAT_CALLS;
-  if (changed || heartbeat) {
-    state.last = next;
-    state.callsSinceEmit = 0;
-    return true;
-  }
-  return false;
-}
-function formatStatusBar(counts) {
-  if (counts.line !== undefined)
-    return counts.line;
-  const staleMark = counts.tier2_stale ? "~" : "";
-  return `[AFT E${counts.errors} W${counts.warnings} | ` + `${staleMark}D${counts.dead_code} U${counts.unused_exports} C${counts.duplicates} | ` + `T${counts.todos}]`;
-}
-function statusBarLine(counts) {
-  return `
-
-${formatStatusBar(counts)}`;
-}
-var STATUS_BAR_HEARTBEAT_CALLS = 15;
-
 // ../aft-bridge/dist/bridge.js
-import { spawn } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 import { createHash } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { homedir as homedir2 } from "node:os";
@@ -698,7 +764,7 @@ function coerceConfigureDroppedKeys(value) {
 function isBridgeTransportTimeout(err) {
   return err instanceof Error && err.code === "transport_timeout";
 }
-var DEFAULT_BRIDGE_TIMEOUT_MS = 30000, BRIDGE_HANG_TIMEOUT_THRESHOLD = 2, MAX_STDOUT_BUFFER, STDOUT_BUFFER_COMPACT_THRESHOLD, HASHLINE_REGISTRATION_LOG_INTERVAL_MS = 60000, HASHLINE_REGISTRATION_LOG_STATE_LIMIT = 256, TERMINAL_BASH_STATUSES, binaryFingerprintReader, BENIGN_CPUINFO_PROC_CPUINFO_PARSE_FAILURE = "failed to parse processor information from /proc/cpuinfo", BridgeReplacedDuringVersionCheck, BridgeTransportTimeoutError, BinaryBridge;
+var DEFAULT_BRIDGE_TIMEOUT_MS = 30000, BRIDGE_HANG_TIMEOUT_THRESHOLD = 2, MAX_STDOUT_BUFFER, STDOUT_BUFFER_COMPACT_THRESHOLD, HASHLINE_REGISTRATION_LOG_INTERVAL_MS = 60000, HASHLINE_REGISTRATION_LOG_STATE_LIMIT = 256, TERMINAL_BASH_STATUSES, binaryFingerprintReader, BENIGN_CPUINFO_PROC_CPUINFO_PARSE_FAILURE = "failed to parse processor information from /proc/cpuinfo", BridgeReplacedDuringVersionCheck, BridgeTransportTimeoutError, BridgeTransportUnavailableError, BinaryBridge;
 var init_bridge = __esm(() => {
   init_active_logger();
   init_command_timeouts();
@@ -732,6 +798,13 @@ var init_bridge = __esm(() => {
       this.name = "BridgeTransportTimeoutError";
     }
   };
+  BridgeTransportUnavailableError = class BridgeTransportUnavailableError extends Error {
+    code = "bridge_transport_unavailable";
+    constructor(message, options) {
+      super(message, options);
+      this.name = "BridgeTransportUnavailableError";
+    }
+  };
   BinaryBridge = class BinaryBridge {
     static RESTART_RESET_MS = 5 * 60 * 1000;
     static STDERR_TAIL_MAX = 20;
@@ -770,7 +843,6 @@ var init_bridge = __esm(() => {
     configureWarningClients = new Map;
     restartResetTimer = null;
     lastChildActivityAt = 0;
-    lastStatusBar;
     consecutiveRequestTimeouts = 0;
     errorPrefix;
     logger;
@@ -971,7 +1043,7 @@ var init_bridge = __esm(() => {
           throw new Error(`${this.errorPrefix} Bridge is retiring after the on-disk binary changed; retry to respawn on the updated binary`);
         }
         if (this._shuttingDown) {
-          throw new Error(`${this.errorPrefix} Bridge is shutting down, cannot send "${command}"`);
+          throw new BridgeTransportUnavailableError(`${this.errorPrefix} Bridge is shutting down, cannot send "${command}"`);
         }
         if (Object.hasOwn(params, "id")) {
           throw new Error("params cannot contain reserved key 'id'");
@@ -1005,7 +1077,7 @@ var init_bridge = __esm(() => {
                   await this.deliverConfigureWarnings(configResult, params, options);
                   await this.checkVersion(implicitTransportOptions);
                   if (!this.isAlive()) {
-                    throw new Error(`${this.errorPrefix} Bridge died during version check. Check logs: ${this.getLogFilePathVia()}`);
+                    throw new BridgeTransportUnavailableError(`${this.errorPrefix} Bridge died during version check. Check logs: ${this.getLogFilePathVia()}`);
                   }
                   this.configured = true;
                 } finally {
@@ -1074,7 +1146,7 @@ var init_bridge = __esm(() => {
           if (!this.process?.stdin?.writable) {
             this.pending.delete(id);
             clearTimeout(timer);
-            reject(new Error(`${this.errorPrefix} stdin not writable for command "${command}"`));
+            reject(new BridgeTransportUnavailableError(`${this.errorPrefix} stdin not writable for command "${command}"`));
             return;
           }
           requestSentAt = Date.now();
@@ -1084,7 +1156,7 @@ var init_bridge = __esm(() => {
               if (entry) {
                 this.pending.delete(id);
                 clearTimeout(entry.timer);
-                entry.reject(new Error(`${this.errorPrefix} Failed to write to stdin: ${err.message}`));
+                entry.reject(new BridgeTransportUnavailableError(`${this.errorPrefix} Failed to write to stdin: ${err.message}`, { cause: err }));
               }
             }
           });
@@ -1251,7 +1323,6 @@ var init_bridge = __esm(() => {
     }
     spawnProcess(triggeringSessionId) {
       this._retiringDueToBinaryChange = false;
-      this.lastStatusBar = undefined;
       if (triggeringSessionId) {
         this.sessionLogVia(triggeringSessionId, `Spawning binary: ${this.binaryPath} (cwd: ${this.cwd})`);
       } else {
@@ -1292,7 +1363,7 @@ var init_bridge = __esm(() => {
           }
         }
       }
-      const child = spawn(this.binaryPath, [], {
+      const child = spawn2(this.binaryPath, [], {
         cwd: this.cwd,
         stdio: ["pipe", "pipe", "pipe"],
         env
@@ -1322,7 +1393,7 @@ var init_bridge = __esm(() => {
         if (this.process !== currentChild)
           return;
         this.errorVia(`Process error: ${err.message}${this.formatStderrTail()}`);
-        this.handleCrash();
+        this.handleCrash(err);
       });
       child.on("exit", (code, signal) => {
         if (this.process !== currentChild)
@@ -1335,7 +1406,7 @@ var init_bridge = __esm(() => {
           this.process = null;
           this.configured = false;
           this.clearRestartResetTimer();
-          this.rejectAllPending(new Error(`${this.errorPrefix} Binary killed by ${signal}`));
+          this.rejectAllPending(new BridgeTransportUnavailableError(`${this.errorPrefix} Binary killed by ${signal}`));
           return;
         }
         this.handleCrash();
@@ -1490,7 +1561,6 @@ var init_bridge = __esm(() => {
           this.consecutiveRequestTimeouts = 0;
           this.scheduleRestartCountReset();
           this.accountForBashTaskResponse(entry.command, response);
-          this.captureStatusBar(response);
           entry.resolve(response);
         } else if (typeof response.type === "string") {
           this.logVia(`Ignoring unknown stdout push frame type: ${response.type}`);
@@ -1511,14 +1581,6 @@ var init_bridge = __esm(() => {
         this.outstandingBackgroundTaskIds.add(taskId);
       }
     }
-    captureStatusBar(response) {
-      const parsed = parseStatusBarCounts(response.status_bar);
-      if (parsed)
-        this.lastStatusBar = parsed;
-    }
-    getStatusBar() {
-      return this.lastStatusBar;
-    }
     handleTimeout(triggeringSessionId) {
       this.consecutiveRequestTimeouts = 0;
       this.spawnedBinaryFingerprint = null;
@@ -1559,7 +1621,7 @@ var init_bridge = __esm(() => {
       if (tail) {
         this.errorVia(`Binary crashed (restarts: ${this._restartCount})${cause ? `: ${cause.message}` : ""}.${tail}`);
       }
-      this.rejectAllPending(new Error(`${this.errorPrefix} Binary crashed (restarts: ${this._restartCount})${cause ? `: ${cause.message}` : ""} (see ${this.getLogFilePathVia()})`));
+      this.rejectAllPending(new BridgeTransportUnavailableError(`${this.errorPrefix} Binary crashed (restarts: ${this._restartCount})${cause ? `: ${cause.message}` : ""} (see ${this.getLogFilePathVia()})`, { cause }));
       if (this._retiringDueToBinaryChange) {
         this.logVia("Binary exited while retiring after an on-disk update; skipping auto-restart");
         return;
@@ -5542,7 +5604,6 @@ class SubcTransport {
   pool;
   projectRoot;
   generation;
-  lastStatusBar;
   cachedStatus = null;
   constructor(pool, projectRoot, generation) {
     this.pool = pool;
@@ -5558,20 +5619,12 @@ class SubcTransport {
   getConcretePoolId() {
     return this.pool.getConcretePoolId();
   }
-  getStatusBar() {
-    return this.lastStatusBar;
-  }
   getCachedStatus() {
     return this.cachedStatus;
   }
   cacheStatusSnapshot(snapshot) {
     this.cachedStatus = snapshot;
   }
-  captureStatusBar(response) {
-    const parsed = parseStatusBarCounts(response.status_bar);
-    if (parsed)
-      this.lastStatusBar = parsed;
-  }
   identityFor(session) {
     return {
       project_root: this.projectRoot,
@@ -5592,9 +5645,7 @@ class SubcTransport {
     if (preview === true)
       body.preview = true;
     const reply = await this.pool.routeRequest(this.identityFor(sessionId), body, timeoutMs, onProgress, this.generation);
-    const result = reliftReply(reply);
-    this.captureStatusBar(result);
-    return result;
+    return reliftReply(reply);
   }
   async send(command, params = {}, options) {
     this.assertCurrent();
@@ -5608,9 +5659,7 @@ class SubcTransport {
     if (editSlotSurvives !== undefined)
       body.edit_slot_survives = editSlotSurvives;
     const reply = await this.pool.routeRequest(this.identityFor(session), body, timeoutMs, onProgress, this.generation);
-    const response = reliftReply(reply);
-    this.captureStatusBar(response);
-    return response;
+    return reliftReply(reply);
   }
   splitOptions(options) {
     if (!options)
@@ -5881,7 +5930,7 @@ class SubcTransportPool {
   getBridge(projectRoot) {
     const root = this.canonicalRoot(projectRoot);
     if (this.shuttingDown && this.lifecycleEnabled()) {
-      throw new SubcCallError("terminal", "subc transport is shutting down");
+      throw new SubcTransportShuttingDownError;
     }
     if (!this.lifecycleEnabled())
       return this.makeFacade(root);
@@ -6181,7 +6230,7 @@ class SubcTransportPool {
   }
   async ensureClient() {
     if (this.shuttingDown)
-      throw new SubcCallError("terminal", "subc transport is shutting down");
+      throw new SubcTransportShuttingDownError;
     if (this.client)
       return this.client;
     if (this.connecting)
@@ -6195,7 +6244,7 @@ class SubcTransportPool {
         try {
           client.close();
         } catch {}
-        throw new SubcCallError("terminal", "subc transport is shutting down");
+        throw new SubcTransportShuttingDownError;
       }
       this.client = client;
       this.transportFailures = 0;
@@ -6432,12 +6481,18 @@ function resolveBridgeForNudge(pool, ref) {
     currentConcretePoolId: candidate.getConcretePoolId?.()
   });
 }
-var AFT_MODULE_ID = "aft", MAX_CONSECUTIVE_TRANSPORT_FAILURES = 3, BG_STABLE_MS = 5000, BG_LIFECYCLE_LOG_INTERVAL_MS = 60000, BG_DISPATCH_PROBE_INTERVAL_MS = 60000, DEFAULT_SESSION_ID = "__default__", LOCALLY_SATISFIED_COMMANDS, SubcRootReapedError, SubcRootGenerationExpiredError, SubcRootDemandRequiredError, RouteTornDownError;
+var SubcTransportShuttingDownError, AFT_MODULE_ID = "aft", MAX_CONSECUTIVE_TRANSPORT_FAILURES = 3, BG_STABLE_MS = 5000, BG_LIFECYCLE_LOG_INTERVAL_MS = 60000, BG_DISPATCH_PROBE_INTERVAL_MS = 60000, DEFAULT_SESSION_ID = "__default__", LOCALLY_SATISFIED_COMMANDS, SubcRootReapedError, SubcRootGenerationExpiredError, SubcRootDemandRequiredError, RouteTornDownError;
 var init_subc_transport = __esm(() => {
   init_dist();
   init_active_logger();
   init_lifecycle_registry();
   init_project_identity();
+  SubcTransportShuttingDownError = class SubcTransportShuttingDownError extends SubcCallError {
+    constructor() {
+      super("terminal", "subc transport is shutting down", "transport_shutting_down");
+      this.name = "SubcTransportShuttingDownError";
+    }
+  };
   LOCALLY_SATISFIED_COMMANDS = new Set(["configure"]);
   SubcRootReapedError = class SubcRootReapedError extends Error {
     code = "root_reaped";
@@ -6500,8 +6555,24 @@ function isRouteGoodbyeError(error2) {
   }
   return error2.code === "route_closed" && error2.message.includes("route closed by subc");
 }
+function hasEngineResponse(error2) {
+  const response = error2.response;
+  if (response !== null && typeof response === "object")
+    return true;
+  const cause = error2.cause;
+  if (cause === null || typeof cause !== "object")
+    return false;
+  const causeResponse = cause.response;
+  return causeResponse !== null && typeof causeResponse === "object";
+}
+function isBashTransportDeadError(error2) {
+  if (!(error2 instanceof Error) || hasEngineResponse(error2) || isRouteGoodbyeError(error2)) {
+    return false;
+  }
+  return error2 instanceof BridgeTransportUnavailableError || error2 instanceof SubcTransportShuttingDownError || isConsumerReconnectTransient(error2) || error2 instanceof StaleRouteHandleError || error2 instanceof SubcRootGenerationExpiredError || error2 instanceof SubcRootReapedError;
+}
 function isTransportClassError(error2) {
-  return isBridgeTransportTimeout(error2) || isConsumerReconnectTransient(error2) || error2 instanceof StaleRouteHandleError || error2 instanceof SubcRootGenerationExpiredError || error2 instanceof SubcRootReapedError;
+  return isBridgeTransportTimeout(error2) || isBashTransportDeadError(error2);
 }
 function adaptToolError(command, error2) {
   if (!(error2 instanceof Error))
@@ -9212,9 +9283,6 @@ class RevivableProjectTransport {
   getCwd() {
     return this.projectRoot;
   }
-  getStatusBar() {
-    return this.owner.currentBridge(this.projectRoot)?.getStatusBar();
-  }
   getCachedStatus() {
     return this.owner.currentBridge(this.projectRoot)?.getCachedStatus() ?? null;
   }
@@ -9560,11 +9628,10 @@ __export(exports_dist, {
   tagStderrLine: () => tagStderrLine,
   stripJsoncSymbols: () => stripJsoncSymbols,
   stripHarnessSpecificConfigKeys: () => stripHarnessSpecificConfigKeys,
-  statusBarLine: () => statusBarLine,
   sleep: () => sleep,
   shouldShowAnnouncement: () => shouldShowAnnouncement,
-  shouldEmitStatusBar: () => shouldEmitStatusBar,
   setActiveLogger: () => setActiveLogger,
+  runBashHostFallback: () => runBashHostFallback,
   resolveNpm: () => resolveNpm,
   resolveLegacyStorageRoot: () => resolveLegacyStorageRoot,
   resolveLegacyAftConfigSources: () => resolveLegacyAftConfigSources,
@@ -9584,7 +9651,6 @@ __export(exports_dist, {
   prepareCanonicalPathArguments: () => prepareCanonicalPathArguments,
   prepareCanonicalEditArguments: () => prepareCanonicalEditArguments,
   platformKey: () => platformKey,
-  parseStatusBarCounts: () => parseStatusBarCounts,
   npmSpawnEnv: () => npmSpawnEnv,
   migrateAftConfigFile: () => migrateAftConfigFile,
   maybeAppendGrepSearchHint: () => maybeAppendGrepSearchHint,
@@ -9599,6 +9665,7 @@ __export(exports_dist, {
   isHomeDirectoryRoot: () => isHomeDirectoryRoot,
   isEmptyParam: () => isEmptyParam,
   isBridgeTransportTimeout: () => isBridgeTransportTimeout,
+  isBashTransportDeadError: () => isBashTransportDeadError,
   inlineUserConfigTier: () => inlineUserConfigTier,
   getMigrationStatus: () => getMigrationStatus,
   getManualInstallHint: () => getManualInstallHint,
@@ -9612,7 +9679,6 @@ __export(exports_dist, {
   formatZoomText: () => formatZoomText,
   formatZoomMultiTargetResult: () => formatZoomMultiTargetResult,
   formatTokenCount: () => formatTokenCount,
-  formatStatusBar: () => formatStatusBar,
   formatSeconds: () => formatSeconds,
   formatReadFooter: () => formatReadFooter,
   formatForegroundResult: () => formatForegroundResult,
@@ -9627,7 +9693,6 @@ __export(exports_dist, {
   ensureBinary: () => ensureBinary,
   downloadBinary: () => downloadBinary,
   decodeFileUrl: () => decodeFileUrl,
-  createStatusBarEmitState: () => createStatusBarEmitState,
   createAftTransportPool: () => createAftTransportPool,
   compressionSavingsPercent: () => compressionSavingsPercent,
   compareSemver: () => compareSemver,
@@ -9639,10 +9704,11 @@ __export(exports_dist, {
   coerceAliasedStringParam: () => coerceAliasedStringParam,
   cleanupOnnxRuntime: () => cleanupOnnxRuntime,
   canonicalizeProjectRoot: () => canonicalizeProjectRoot,
+  bashHostFallbackAskPattern: () => bashHostFallbackAskPattern,
   adaptToolError: () => adaptToolError,
   __onnxTest__: () => __test__,
+  SubcTransportShuttingDownError: () => SubcTransportShuttingDownError,
   SubcTransportPool: () => SubcTransportPool,
-  STATUS_BAR_HEARTBEAT_CALLS: () => STATUS_BAR_HEARTBEAT_CALLS,
   RotatingLogSink: () => RotatingLogSink,
   RevivableTransportPool: () => RevivableTransportPool,
   PLATFORM_ASSET_MAP: () => PLATFORM_ASSET_MAP,
@@ -9655,15 +9721,21 @@ __export(exports_dist, {
   HomeProjectRootError: () => HomeProjectRootError,
   DEFAULT_LOG_GENERATIONS: () => DEFAULT_LOG_GENERATIONS,
   DEFAULT_LOG_BYTES: () => DEFAULT_LOG_BYTES,
+  BridgeTransportUnavailableError: () => BridgeTransportUnavailableError,
   BridgeTransportTimeoutError: () => BridgeTransportTimeoutError,
   BridgePool: () => BridgePool,
   BinaryBridge: () => BinaryBridge,
   BASH_TRANSPORT_DISPOSITION: () => BASH_TRANSPORT_DISPOSITION,
+  BASH_HOST_FALLBACK_REFUSAL: () => BASH_HOST_FALLBACK_REFUSAL,
+  BASH_HOST_FALLBACK_MAX_TIMEOUT_MS: () => BASH_HOST_FALLBACK_MAX_TIMEOUT_MS,
+  BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES: () => BASH_HOST_FALLBACK_MAX_OUTPUT_BYTES,
+  BASH_HOST_FALLBACK_BANNER: () => BASH_HOST_FALLBACK_BANNER,
   AftToolError: () => AftToolError
 });
 var init_dist2 = __esm(() => {
   init_active_logger();
   init_bash_hints();
+  init_bash_host_fallback();
   init_bridge();
   init_cache_paths();
   init_callgraph_format();
@@ -20197,7 +20269,7 @@ var init_setup = __esm(() => {
 });
 
 // src/lib/aft-bridge.ts
-import { spawn as spawn2 } from "node:child_process";
+import { spawn as spawn3 } from "node:child_process";
 function isResponseForRequest(parsed, expectedIds) {
   if (!parsed || typeof parsed !== "object")
     return false;
@@ -20209,7 +20281,7 @@ function isResponseForRequest(parsed, expectedIds) {
 }
 async function sendAftRequests(binaryPath, requests) {
   return new Promise((resolve8, reject) => {
-    const child = spawn2(binaryPath, [], {
+    const child = spawn3(binaryPath, [], {
       stdio: ["pipe", "pipe", "pipe"]
     });
     const responses = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft",
-  "version": "0.50.2",
+  "version": "0.51.0",
   "type": "module",
   "description": "Unified CLI for Agent File Tools (AFT) — setup, doctor, and diagnostics across supported agent harnesses (OpenCode, Pi)",
   "license": "MIT",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.6.0",
-    "@cortexkit/aft-bridge": "0.50.2",
+    "@cortexkit/aft-bridge": "0.51.0",
     "comment-json": "^4.6.2"
   },
   "devDependencies": {