@cortexkit/aft-opencode 0.58.0 → 0.58.2

package/dist/index.js

@@ -7883,17 +7883,79 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 var DEFAULT_PRIMARY_WATCH_TIMEOUT_MS = 30000;
-var WATCH_TIMEOUT_PARAM_DESCRIPTION = "Sync-only timeout in milliseconds. Default 30000 (the configured maximum for delegated sessions); max `bash.watch_sync_max_ms` (120000 by default).";
+var MAX_WATCH_TIMEOUT_MS = 1800000;
+var LONGEST_TIMER_DELAY_MS = 2147483647;
+var WATCH_SYNC_DEFAULTS_DESCRIPTION = "Sync waits default to 30s in a main session (max `bash.watch_sync_max_ms`, 120s by default); in a delegated session a sync wait without a timeout waits until the command finishes";
+var WATCH_TIMEOUT_PARAM_DESCRIPTION = "Sync-only timeout in milliseconds. In a main session: default 30000, max `bash.watch_sync_max_ms` (120000 by default). In a delegated session: omit it to wait until the command finishes; a value you pass is used as given.";
 function resolveWatchTimeoutMs(requestedMs, role, capMs) {
-  const fallback = role === "worker" ? capMs : DEFAULT_PRIMARY_WATCH_TIMEOUT_MS;
-  return Math.min(requestedMs ?? fallback, capMs);
+  if (role === "worker")
+    return requestedMs;
+  return Math.min(requestedMs ?? DEFAULT_PRIMARY_WATCH_TIMEOUT_MS, capMs);
+}
+function maxWatchTimeoutMs(role, capMs) {
+  return role === "worker" ? MAX_WATCH_TIMEOUT_MS : capMs;
+}
+function watchPollDelayMs(elapsedMs) {
+  if (elapsedMs < 5000)
+    return 100;
+  if (elapsedMs < 30000)
+    return 250;
+  if (elapsedMs < 120000)
+    return 500;
+  return 1000;
+}
+var watchClock = {
+  now: () => performance.now(),
+  sleep: abortableSleep
+};
+function abortableSleep(ms, signal) {
+  if (signal?.aborted)
+    return Promise.resolve();
+  return new Promise((resolve) => {
+    const done = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve();
+    };
+    const timer = setTimeout(done, ms);
+    signal?.addEventListener("abort", done, { once: true });
+  });
 }
-function watchTimeoutSteer(role, capMs, timeoutParam = "timeoutMs") {
+function formatWatchWaited(elapsedMs, limitMs, capMs) {
+  let limit;
+  if (limitMs === undefined)
+    limit = "no limit: waits until the command finishes";
+  else if (capMs !== undefined && limitMs >= capMs)
+    limit = `limit ${limitMs}ms, the bash.watch_sync_max_ms cap`;
+  else
+    limit = `limit ${limitMs}ms`;
+  return `Waited ${Math.round(elapsedMs)}ms (${limit})`;
+}
+function watchTimeoutSteer(role, timeoutParam = "timeoutMs") {
   if (role === "worker") {
-    return `The command is still running; this is not a failure. Watch again (${timeoutParam} up to ${capMs}) and don't report a result until it finishes.`;
+    return `The command is still running; this is not a failure. Watch again and don't report a result until it finishes; a bash_watch without ${timeoutParam} waits until the command finishes.`;
   }
   return "The command is still running; this is not a failure. Watch again, do other work, or end your turn: the completion reminder wakes you.";
 }
+var WATCH_UNAVAILABLE_GIVE_UP_MS = 120000;
+var WORKER_KEEP_WAITING = "Call bash_watch again to keep waiting; don't report a result until the command finishes.";
+function interruptedWatchTail(role, primaryTail) {
+  return role === "worker" ? `The task is still running. ${WORKER_KEEP_WAITING}` : primaryTail;
+}
+function workerBackgroundTaskNote(taskId, taskIdArg = "taskId") {
+  return `
+
+NOTE (subagent session): Continue with other work if you have it. If you don't, call bash_watch({ ${taskIdArg}: "${taskId}" }) to wait for completion before returning to the parent; without a timeout it waits until the command finishes. Subagents don't survive turn-end and won't be woken when the command finishes.`;
+}
+function runningTaskStatusHint(role) {
+  return role === "worker" ? "To wait for it, call bash_watch; don't poll." : "A completion reminder will be delivered automatically; don't poll.";
+}
+function watchUnavailableSteer(role) {
+  const unknown = "the bridge was busy, so task state is unknown.";
+  if (role === "worker")
+    return `${unknown} ${WORKER_KEEP_WAITING}`;
+  return `${unknown} Do not poll; let the task's completion notification wake the session, or use one bash_status snapshot on the next normal tool call.`;
+}
 var CONFLICT_HINT = `
 
 [Hint] Use aft_conflicts to see all conflict regions across files in a single call.`;
@@ -8274,7 +8336,7 @@ import { existsSync } from "node:fs";
 import { join as join3 } from "node:path";
 
 // ../aft-bridge/dist/child-process.js
-import { execFileSync as nodeExecFileSync, execSync as nodeExecSync, spawn as nodeSpawn, spawnSync as nodeSpawnSync } from "node:child_process";
+import { execFile as nodeExecFile, execFileSync as nodeExecFileSync, execSync as nodeExecSync, spawn as nodeSpawn, spawnSync as nodeSpawnSync } from "node:child_process";
 var HIDDEN = { windowsHide: true };
 function withWindowsHidden(args, takesArgv) {
   const out = [...args];
@@ -8296,6 +8358,7 @@ function hidden(resolve, takesArgv) {
 }
 var spawn = hidden(() => nodeSpawn, true);
 var spawnSync = hidden(() => nodeSpawnSync, true);
+var execFile = hidden(() => nodeExecFile, true);
 var execFileSync = hidden(() => nodeExecFileSync, true);
 var execSync = hidden(() => nodeExecSync, false);
 
@@ -8751,6 +8814,9 @@ function isPassiveCommand(command) {
   return PASSIVE_COMMANDS.has(command);
 }
 
+// ../aft-bridge/dist/transport.js
+var WORKER_SESSION_FIELD = "worker_session";
+
 // ../aft-bridge/dist/bridge.js
 var DEFAULT_BRIDGE_TIMEOUT_MS = 30000;
 var BRIDGE_HANG_TIMEOUT_THRESHOLD = 2;
@@ -9169,9 +9235,11 @@ class BinaryBridge {
       params.edit_slot_survives = editSlotSurvives;
       this.logHashlineRegistrationCarrier("tool_call", sessionId, editSlotSurvives);
     }
-    const { preview, ...sendOptions } = options ?? {};
+    const { preview, workerSession, ...sendOptions } = options ?? {};
     if (preview === true)
       params.preview = true;
+    if (workerSession === true)
+      params[WORKER_SESSION_FIELD] = true;
     return await this.send("tool_call", params, Object.keys(sendOptions).length > 0 ? sendOptions : undefined);
   }
   async sendWithVersionMismatchRetry(command, params, options, canRetryAfterVersionSwap) {
@@ -9240,7 +9308,7 @@ class BinaryBridge {
       if (command === "cancel_request" || Object.hasOwn(params, "command") || Object.hasOwn(params, "method")) {
         const nested = { ...params };
         const reserved = {};
-        for (const key of ["session_id", "lsp_hints"]) {
+        for (const key of ["session_id", "lsp_hints", WORKER_SESSION_FIELD]) {
           if (Object.hasOwn(nested, key)) {
             reserved[key] = nested[key];
             delete nested[key];
@@ -9622,17 +9690,30 @@ class BinaryBridge {
     }
   }
   onStderrData(data) {
-    this.stderrBuffer += data;
-    let newlineIdx;
-    while ((newlineIdx = this.stderrBuffer.indexOf(`
-`)) !== -1) {
-      const line = this.stderrBuffer.slice(0, newlineIdx).replace(/\r$/, "");
-      this.stderrBuffer = this.stderrBuffer.slice(newlineIdx + 1);
-      if (!line || !shouldSurfaceStderrLine(line))
-        continue;
-      const tagged = tagStderrLine(line);
-      this.logVia(tagged);
-      this.pushStderrLine(tagged);
+    const partialLimit = 64 * 1024;
+    let offset = 0;
+    while (offset < data.length) {
+      const newline = data.indexOf(`
+`, offset);
+      const end = newline < 0 ? data.length : newline;
+      while (offset < end) {
+        const count = Math.min(partialLimit - this.stderrBuffer.length, end - offset);
+        this.stderrBuffer += data.slice(offset, offset + count);
+        offset += count;
+        if (this.stderrBuffer.length === partialLimit) {
+          const last = this.stderrBuffer.charCodeAt(this.stderrBuffer.length - 1);
+          const carry = last >= 55296 && last <= 56319 ? this.stderrBuffer.slice(-1) : "";
+          const fragment = carry ? this.stderrBuffer.slice(0, -1) : this.stderrBuffer;
+          const tagged = tagStderrLine(`${fragment} [stderr record truncated into bounded fragments; ${Buffer.byteLength(fragment)} bytes shown, continuation follows]`);
+          this.stderrBuffer = carry;
+          this.logVia(tagged);
+          this.pushStderrLine(tagged);
+        }
+      }
+      if (newline < 0)
+        break;
+      this.flushStderrBuffer();
+      offset = newline + 1;
     }
   }
   flushStderrBuffer() {
@@ -10005,6 +10086,35 @@ function coerceJsonCollectionParam(value, field) {
   }
   throw new Error(`${field} must be ${shape} (got an invalid type)`);
 }
+function isBlankParam(value) {
+  if (typeof value === "string")
+    return value.trim().length === 0;
+  return isEmptyParam(value);
+}
+function usableZoomTargets(targets) {
+  if (isEmptyParam(targets))
+    return [];
+  const entries = Array.isArray(targets) ? targets : [targets];
+  return entries.filter((entry) => {
+    if (entry === null || entry === undefined)
+      return false;
+    if (typeof entry !== "object")
+      return true;
+    const record = entry;
+    return !(isBlankParam(record.path) && isBlankParam(record.filePath) && isBlankParam(record.symbol));
+  });
+}
+function isFindReplaceOnlyEdit(args) {
+  const absent = (value) => value === undefined || value === null || value === "";
+  const absentLine = (value) => absent(value) || value === 0;
+  const edits = args.edits;
+  return Array.isArray(edits) && edits.length > 0 && absent(args.appendContent) && absent(args.symbol) && absent(args.content) && edits.every((entry) => {
+    if (entry === null || typeof entry !== "object")
+      return false;
+    const item = entry;
+    return typeof item.oldString === "string" && (absent(item.newString) || typeof item.newString === "string") && absentLine(item.startLine) && absentLine(item.endLine) && absent(item.content);
+  });
+}
 // ../aft-bridge/dist/config-error.js
 import { homedir as homedir5 } from "node:os";
 import { isAbsolute as isAbsolute2, join as join6 } from "node:path";
@@ -10121,9 +10231,366 @@ function formatDroppedKeyWarnings(dropped) {
   }
   return dropped.map((item) => `Ignoring ${item.key} from ${item.tier} config (${item.reason})`);
 }
+// ../aft-bridge/dist/config-watch.js
+import { readFileSync as readFileSync3, statSync as statSync3, watch } from "node:fs";
+import { basename, dirname } from "node:path";
+var CONFIG_WATCH_DEBOUNCE_MS = 150;
+var CONFIG_LIVE_KEEP_NOTE = "AFT keeps using the last valid configuration until the file is fixed.";
+function pathKey(name) {
+  const segments = name.split(".");
+  return {
+    name,
+    read(config) {
+      let value = config;
+      for (const segment of segments) {
+        if (value === null || typeof value !== "object")
+          return;
+        value = value[segment];
+      }
+      return value;
+    },
+    write(config, value) {
+      const set = (target, index) => {
+        const copy = target !== null && typeof target === "object" && !Array.isArray(target) ? { ...target } : {};
+        const segment = segments[index];
+        if (index === segments.length - 1) {
+          if (value === undefined)
+            delete copy[segment];
+          else
+            copy[segment] = value;
+        } else {
+          copy[segment] = set(copy[segment], index + 1);
+        }
+        return copy;
+      };
+      return set(config, 0);
+    }
+  };
+}
+function bashKey(name, resolveBash) {
+  return {
+    name: `bash.${name}`,
+    read: (config) => resolveBash(config)[name],
+    write(config, value) {
+      const resolved = { ...resolveBash(config), [name]: value };
+      for (const key of Object.keys(resolved)) {
+        if (resolved[key] === undefined)
+          delete resolved[key];
+      }
+      return { ...config, bash: resolved };
+    }
+  };
+}
+function aftLiveConfigKeys(resolveBash) {
+  return [
+    pathKey("configure_warnings_delivery"),
+    pathKey("restrict_to_project_root"),
+    pathKey("inspect.diagnostics_timeout_ms"),
+    pathKey("inspect.tier2_idle_minutes"),
+    bashKey("foreground_wait_window_ms", resolveBash),
+    bashKey("host_fallback", resolveBash),
+    bashKey("subagent_background", resolveBash),
+    bashKey("watch_sync_max_ms", resolveBash)
+  ];
+}
+function sameValue(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+function flattenLeaves(value, prefix, out) {
+  if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+    const entries = Object.entries(value);
+    if (entries.length === 0 && prefix)
+      out.set(prefix, "{}");
+    for (const [key, child] of entries) {
+      flattenLeaves(child, prefix ? `${prefix}.${key}` : key, out);
+    }
+    return;
+  }
+  if (prefix)
+    out.set(prefix, JSON.stringify(value));
+}
+function applyLiveConfigKeys(current, next, keys, baseline = current) {
+  let config = current;
+  const applied = [];
+  for (const key of keys) {
+    const value = key.read(next);
+    if (sameValue(key.read(current), value))
+      continue;
+    config = key.write(config, value);
+    applied.push(key.name);
+  }
+  const before = new Map;
+  const after = new Map;
+  flattenLeaves(baseline, "", before);
+  flattenLeaves(next, "", after);
+  const liveNames = keys.map((key) => key.name);
+  const isLive = (leaf) => liveNames.some((name) => leaf === name || leaf.startsWith(`${name}.`));
+  const deferred = new Set;
+  for (const leaf of new Set([...before.keys(), ...after.keys()])) {
+    if (before.get(leaf) === after.get(leaf) || isLive(leaf))
+      continue;
+    deferred.add(leaf);
+  }
+  return { config, applied, deferred: [...deferred].sort() };
+}
+function readTextOrNull(path) {
+  try {
+    return readFileSync3(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+var CONFIG_WATCH_REVALIDATE_MS = 2000;
+var CONFIG_WATCH_REJECTED_RETRIES = 3;
+var CONFIG_WATCH_MAX_DELAY_MS = 1000;
+function identityOf(dir) {
+  try {
+    const stat = statSync3(dir, { bigint: true });
+    const base = `${stat.dev}:${stat.ino}`;
+    return process.platform === "win32" ? base : `${base}:${stat.birthtimeNs}`;
+  } catch {
+    return null;
+  }
+}
+function watchDirFor(file) {
+  let dir = dirname(file);
+  while (dir !== dirname(dir) && identityOf(dir) === null)
+    dir = dirname(dir);
+  return dir;
+}
+function watchAftConfigFiles(options) {
+  const debounceMs = options.debounceMs ?? CONFIG_WATCH_DEBOUNCE_MS;
+  const lastSeen = new Map;
+  for (const path of options.paths) {
+    if (options.initialTexts)
+      lastSeen.set(path, options.initialTexts[path] ?? null);
+    else
+      lastSeen.set(path, options.checkAtStart ? undefined : readTextOrNull(path));
+  }
+  let timer = null;
+  let firstPendingAt = null;
+  let stopped = false;
+  const watchers = new Map;
+  const watchImpl = options.watchImpl ?? watch;
+  let rejectedRetries = 0;
+  const check = () => {
+    timer = null;
+    firstPendingAt = null;
+    if (stopped)
+      return;
+    revalidate();
+    const seen = new Map;
+    for (const path of options.paths) {
+      const text = readTextOrNull(path);
+      if (text !== lastSeen.get(path))
+        seen.set(path, text);
+    }
+    if (seen.size === 0)
+      return;
+    const outcome = options.onChange();
+    if (outcome === false) {
+      if (rejectedRetries < CONFIG_WATCH_REJECTED_RETRIES) {
+        rejectedRetries += 1;
+        retryTimer = setTimeout(check, CONFIG_WATCH_MAX_DELAY_MS);
+        retryTimer.unref?.();
+      }
+      return;
+    }
+    rejectedRetries = 0;
+    if (outcome instanceof Map) {
+      for (const path of options.paths)
+        lastSeen.set(path, outcome.get(path) ?? null);
+    } else {
+      for (const [path, text] of seen)
+        lastSeen.set(path, text);
+    }
+  };
+  let retryTimer = null;
+  const schedule = () => {
+    if (stopped)
+      return;
+    const now = Date.now();
+    firstPendingAt ??= now;
+    if (timer)
+      clearTimeout(timer);
+    const delay = Math.max(0, Math.min(debounceMs, firstPendingAt + CONFIG_WATCH_MAX_DELAY_MS - now));
+    timer = setTimeout(check, delay);
+    timer.unref?.();
+  };
+  function revalidate() {
+    const wanted = new Set(options.paths.map(watchDirFor));
+    let moved = false;
+    for (const [dir, entry] of watchers) {
+      if (!wanted.has(dir) || entry.stale || identityOf(dir) !== entry.identity) {
+        entry.watcher.close();
+        watchers.delete(dir);
+        moved = true;
+      }
+    }
+    for (const dir of wanted) {
+      if (watchers.has(dir))
+        continue;
+      try {
+        const identity = identityOf(dir);
+        options.beforeWatchForTest?.(dir);
+        const name = basename(dir);
+        const watcher = watchImpl(dir, { persistent: false }, (event, filename) => {
+          if (event === "rename" && filename === name) {
+            const current = watchers.get(dir);
+            if (current && current.watcher === watcher)
+              current.stale = true;
+          }
+          schedule();
+        });
+        if (identityOf(dir) !== identity) {
+          watcher.close();
+          moved = true;
+          continue;
+        }
+        const entry = { watcher, identity, stale: false };
+        entry.watcher.on("error", () => {
+          entry.watcher.close();
+          if (watchers.get(dir) === entry)
+            watchers.delete(dir);
+          schedule();
+        });
+        watchers.set(dir, entry);
+        moved = true;
+      } catch {}
+    }
+    return moved;
+  }
+  revalidate();
+  if (options.checkAtStart)
+    check();
+  const revalidateTimer = setInterval(() => {
+    if (!stopped && revalidate())
+      schedule();
+  }, CONFIG_WATCH_REVALIDATE_MS);
+  revalidateTimer.unref?.();
+  return () => {
+    stopped = true;
+    if (timer)
+      clearTimeout(timer);
+    if (retryTimer)
+      clearTimeout(retryTimer);
+    clearInterval(revalidateTimer);
+    for (const entry of watchers.values())
+      entry.watcher.close();
+    watchers.clear();
+  };
+}
+function aftLiveSecurityKeys(keys) {
+  const byName = new Map(keys.map((key) => [key.name, key]));
+  const pick = (name) => {
+    const key = byName.get(name);
+    if (!key)
+      throw new Error(`unknown live config key ${name}`);
+    return key;
+  };
+  return [
+    {
+      key: pick("restrict_to_project_root"),
+      loosens: (current, next) => current === true && next !== true
+    },
+    {
+      key: pick("bash.host_fallback"),
+      loosens: (current, next) => current !== true && next === true
+    }
+  ];
+}
+function liveConfigReloadLogLine(applied, deferred) {
+  let line = "config reload";
+  if (applied.length > 0)
+    line += ` applied=[${applied.join(",")}]`;
+  if (deferred.length > 0) {
+    line += ` deferred=[${deferred.join(",")}] (deferred keys apply on next connect/restart)`;
+  }
+  return line;
+}
+function startLiveConfigReload(options) {
+  const baseline = options.getConfig();
+  let lastError = null;
+  let acceptedSources = new Set(options.initialSources);
+  let acceptedProjectText = options.initialProjectText ?? null;
+  let acceptedTexts;
+  const reload = () => {
+    let loaded = options.load();
+    if (loaded.ok) {
+      const read = new Set(loaded.sources);
+      const deleted = [...acceptedSources].find((path) => !read.has(path));
+      if (deleted !== undefined) {
+        loaded = { ok: false, message: `AFT config at ${deleted} was deleted` };
+      } else {
+        acceptedSources = read;
+      }
+    }
+    if (!loaded.ok) {
+      const message = `${loaded.message.trim().replace(/[.!?]?$/, ".")} ${CONFIG_LIVE_KEEP_NOTE}`;
+      if (message !== lastError) {
+        lastError = message;
+        options.reportError(message);
+      }
+      return null;
+    }
+    lastError = null;
+    acceptedTexts = loaded.texts;
+    const current = options.getConfig();
+    let next = loaded.config;
+    const held = [];
+    const projectText = loaded.projectText ?? null;
+    if (loaded.projectText !== undefined && projectText !== acceptedProjectText) {
+      for (const security of options.securityKeys ?? []) {
+        const now = security.key.read(current);
+        if (security.loosens(now, security.key.read(next))) {
+          next = security.key.write(next, now);
+          held.push(security.key.name);
+        }
+      }
+      if (held.length === 0)
+        acceptedProjectText = projectText;
+    }
+    const result = applyLiveConfigKeys(current, next, options.keys, baseline);
+    if (result.applied.length > 0)
+      options.setConfig(result.config);
+    if (result.applied.length > 0 || result.deferred.length > 0 || held.length > 0) {
+      let line = liveConfigReloadLogLine(result.applied, result.deferred);
+      if (held.length > 0) {
+        line += ` held=[${held.join(",")}] (not loosened while the project file differs from the one the published values came from; the next restart applies them)`;
+      }
+      options.log(line);
+    }
+    return { ...result, held };
+  };
+  const safeReload = () => {
+    try {
+      acceptedTexts = undefined;
+      if (reload() === null)
+        return false;
+      const texts = acceptedTexts;
+      if (!texts)
+        return true;
+      return new Map(options.paths.map((path) => [path, texts[path] ?? null]));
+    } catch (err) {
+      options.reportError(`AFT config reload failed: ${err instanceof Error ? err.message : String(err)}`);
+      return false;
+    }
+  };
+  if (options.watch === false) {
+    return { reload, stop: () => {} };
+  }
+  const stop = watchAftConfigFiles({
+    paths: options.paths,
+    debounceMs: options.debounceMs,
+    onChange: safeReload,
+    initialTexts: options.initialTexts,
+    checkAtStart: true
+  });
+  return { reload, stop };
+}
 // ../aft-bridge/dist/downloader.js
 import { createHash as createHash2, randomUUID } from "node:crypto";
-import { chmodSync, closeSync, copyFileSync, createWriteStream, existsSync as existsSync3, mkdirSync, openSync, readdirSync, readFileSync as readFileSync3, renameSync as renameSync2, rmSync, statSync as statSync3, unlinkSync as unlinkSync2, writeSync } from "node:fs";
+import { chmodSync, closeSync, copyFileSync, createWriteStream, existsSync as existsSync3, mkdirSync, openSync, readdirSync, readFileSync as readFileSync4, renameSync as renameSync2, rmSync, statSync as statSync4, unlinkSync as unlinkSync2, writeSync } from "node:fs";
 import { hostname } from "node:os";
 import { join as join7 } from "node:path";
 import { Readable } from "node:stream";
@@ -10475,7 +10942,7 @@ function isReclaimableDownloadLock(owner, ageMs, staleMs) {
 }
 function reclaimDownloadLock(lockPath, expectedOwner) {
   try {
-    if (readFileSync3(lockPath, "utf-8") !== expectedOwner)
+    if (readFileSync4(lockPath, "utf-8") !== expectedOwner)
       return false;
     rmSync(lockPath, { force: true });
     return true;
@@ -10493,7 +10960,7 @@ function sweepStaleDownloadTemps(versionedCacheDir, binaryName) {
         continue;
       }
       const tempPath = join7(versionedCacheDir, entry.name);
-      const ageMs = Date.now() - statSync3(tempPath).mtimeMs;
+      const ageMs = Date.now() - statSync4(tempPath).mtimeMs;
       if (Math.abs(ageMs) > DOWNLOAD_LOCK_STALE_MS)
         unlinkSync2(tempPath);
     }
@@ -10515,7 +10982,7 @@ async function acquireDownloadLock(lockPath, timing = {}) {
       }
       return () => {
         try {
-          if (readFileSync3(lockPath, "utf-8") === owner) {
+          if (readFileSync4(lockPath, "utf-8") === owner) {
             rmSync(lockPath, { force: true });
           }
         } catch {}
@@ -10527,8 +10994,8 @@ async function acquireDownloadLock(lockPath, timing = {}) {
       let existingOwner;
       let ageMs;
       try {
-        existingOwner = readFileSync3(lockPath, "utf-8");
-        ageMs = Date.now() - statSync3(lockPath).mtimeMs;
+        existingOwner = readFileSync4(lockPath, "utf-8");
+        ageMs = Date.now() - statSync4(lockPath).mtimeMs;
       } catch (readErr) {
         if (readErr.code === "ENOENT")
           continue;
@@ -10578,7 +11045,7 @@ async function fetchLatestTag() {
 }
 // ../aft-bridge/dist/durable-log.js
 import { appendFile, chmod, mkdir, rename, rm, stat } from "node:fs/promises";
-import { dirname } from "node:path";
+import { dirname as dirname2 } from "node:path";
 var DEFAULT_LOG_BYTES = 32 * 1024 * 1024;
 var DEFAULT_LOG_GENERATIONS = 1;
 var LOG_DIR_MODE = 448;
@@ -10591,6 +11058,10 @@ class RotatingLogSink {
   queue = Promise.resolve();
   disabled = false;
   failureReported = false;
+  queuedBytes = 0;
+  queuedRecords = 0;
+  droppedBytes = 0;
+  overflowQueued = false;
   constructor(path, options = {}) {
     this.path = path;
     this.maxBytes = options.maxBytes ?? DEFAULT_LOG_BYTES;
@@ -10599,7 +11070,34 @@ class RotatingLogSink {
   append(data) {
     if (this.disabled || data.length === 0)
       return;
-    this.queue = this.queue.then(() => this.write(data)).catch((error) => {
+    const bytes = Buffer.byteLength(data);
+    const overflow = this.queuedBytes + bytes > 1024 * 1024 || this.queuedRecords >= 4096;
+    if (overflow) {
+      this.droppedBytes += bytes;
+      if (this.overflowQueued)
+        return;
+      this.overflowQueued = true;
+      data = "";
+    } else {
+      this.queuedBytes += bytes;
+      this.queuedRecords += 1;
+    }
+    this.queue = this.queue.then(async () => {
+      if (overflow) {
+        const dropped = this.droppedBytes;
+        this.droppedBytes = 0;
+        this.overflowQueued = false;
+        await this.write(`[aft-plugin] durable log queue overflow: dropped ${dropped} bytes (1MiB/4096-record pending limit); reduce diagnostic volume.
+`);
+      } else {
+        try {
+          await this.write(data);
+        } finally {
+          this.queuedBytes -= bytes;
+          this.queuedRecords -= 1;
+        }
+      }
+    }).catch((error) => {
       this.disabled = true;
       if (!this.failureReported) {
         this.failureReported = true;
@@ -10614,8 +11112,8 @@ class RotatingLogSink {
     await this.queue;
   }
   async write(data) {
-    const dir = dirname(this.path);
-    await mkdir(dirname(dir), { recursive: true });
+    const dir = dirname2(this.path);
+    await mkdir(dirname2(dir), { recursive: true });
     try {
       await mkdir(dir, { mode: LOG_DIR_MODE });
     } catch (error) {
@@ -12403,7 +12901,7 @@ function reverseRequestMethod(body) {
   }
 }
 // ../aft-bridge/dist/subc-transport.js
-import { existsSync as existsSync4, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync4, statSync as statSync5 } from "node:fs";
 
 // ../aft-bridge/dist/lifecycle-registry.js
 import { lstat } from "node:fs/promises";
@@ -12879,6 +13377,13 @@ class SubcTransportShuttingDownError extends SubcCallError {
     this.name = "SubcTransportShuttingDownError";
   }
 }
+
+class ReconnectKeyChangedError extends Error {
+  constructor() {
+    super("the subc daemon restarted and its connection key changed; the reconnect did not complete within the deadline, retry");
+    this.name = "ReconnectKeyChangedError";
+  }
+}
 function isSubcClientClosedError(error) {
   return error instanceof SubcError && error.message === "client closed";
 }
@@ -12930,6 +13435,7 @@ var RECONNECT_RETRY_FLOOR_MS = 100;
 var RECONNECT_RETRY_CAP_MS = 2000;
 var SUBC_DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 var ROUTE_OPEN_RELOAD_WAIT_CEILING_MS = 45000;
+var CALL_DEADLINE_EXPIRED = Symbol("call deadline expired");
 function reloadWaitExhaustedSuffix(callDeadlineMs) {
   if (callDeadlineMs > ROUTE_OPEN_RELOAD_WAIT_CEILING_MS) {
     const ceilingSeconds = ROUTE_OPEN_RELOAD_WAIT_CEILING_MS / 1000;
@@ -13282,7 +13788,16 @@ function absentRootError(root) {
   return new SubcError(`invalid route project root: project root does not exist: ${root}`, "config_divergence");
 }
 function reloadWindowExhaustedError(error, callDeadlineMs) {
-  const suffix = reloadWaitExhaustedSuffix(callDeadlineMs);
+  return withDeadlineSuffix(error, reloadWaitExhaustedSuffix(callDeadlineMs));
+}
+function callDeadlinePassedError(lastError, callDeadlineMs) {
+  const seconds = Math.round(callDeadlineMs / 100) / 10;
+  const suffix = ` The AFT daemon module did not return within this call's ${seconds}s deadline.`;
+  if (lastError !== undefined)
+    return withDeadlineSuffix(lastError, suffix);
+  return new SubcError(`route to module '${AFT_MODULE_ID}' was not ready before the call ran out of time.${suffix}`, REQUEST_DEADLINE_CODE);
+}
+function withDeadlineSuffix(error, suffix) {
   if (error instanceof Error) {
     try {
       error.message += suffix;
@@ -13371,6 +13886,8 @@ class SubcTransport {
       body.edit_slot_survives = editSlotSurvives;
     if (preview === true)
       body.preview = true;
+    if (options?.workerSession === true)
+      body[WORKER_SESSION_FIELD] = true;
     const reply = await this.pool.routeRequest(this.identityFor(sessionId), body, timeoutMs, onProgress, this.generation, abortSignal);
     return reliftReply(reply);
   }
@@ -13381,7 +13898,10 @@ class SubcTransport {
     }
     const { timeoutMs, onProgress, abortSignal } = this.splitOptions(options);
     const session = typeof params.session_id === "string" ? params.session_id : undefined;
-    const body = { name: command, arguments: params };
+    const { [WORKER_SESSION_FIELD]: workerSession, ...args } = params;
+    const body = { name: command, arguments: args };
+    if (workerSession === true)
+      body[WORKER_SESSION_FIELD] = true;
     const editSlotSurvives = this.pool.getEditSlotSurvives();
     if (editSlotSurvives !== undefined)
       body.edit_slot_survives = editSlotSurvives;
@@ -13418,6 +13938,7 @@ class SubcTransportPool {
   lifecycleRegistration = null;
   outerFacadeEvictor;
   client = null;
+  hadWorkingClient = false;
   connecting = null;
   routeReopenRetryDelayMs = RECONNECT_RETRY_FLOOR_MS;
   routeReopenRetry = null;
@@ -13521,7 +14042,7 @@ class SubcTransportPool {
   rootCanAttach(root) {
     let directoryExists = false;
     try {
-      directoryExists = statSync4(root).isDirectory();
+      directoryExists = statSync5(root).isDirectory();
     } catch {}
     if (directoryExists) {
       this.dormantRoots.delete(root);
@@ -13861,6 +14382,11 @@ class SubcTransportPool {
     return this.rootReapedError(record);
   }
   async routeRequest(identity, body, timeoutMs, onProgress, expectedGeneration, abortSignal) {
+    const callStartedAt = performance.now();
+    const callDeadlineMs = timeoutMs ?? SUBC_DEFAULT_REQUEST_TIMEOUT_MS;
+    let scheduledDelayMs = 0;
+    const spentMs = () => Math.max(performance.now() - callStartedAt, scheduledDelayMs);
+    const remainingMs = () => callDeadlineMs - spentMs();
     const root = asCanonicalRootPath(identity.project_root);
     let generation = expectedGeneration;
     if (this.lifecycleEnabled()) {
@@ -13876,7 +14402,49 @@ class SubcTransportPool {
     try {
       let client;
       try {
-        client = await this.ensureClient();
+        let keyChanged;
+        while (true) {
+          const remaining = remainingMs();
+          if (remaining <= 0)
+            throw keyChanged ?? callDeadlinePassedError(undefined, callDeadlineMs);
+          let timer;
+          try {
+            const acquired = await Promise.race([
+              this.ensureClient(),
+              new Promise((resolve) => {
+                timer = setTimeout(() => resolve(CALL_DEADLINE_EXPIRED), remaining);
+              })
+            ]);
+            if (acquired === CALL_DEADLINE_EXPIRED) {
+              throw keyChanged ?? callDeadlinePassedError(undefined, callDeadlineMs);
+            }
+            client = acquired;
+            break;
+          } catch (error) {
+            if (!(error instanceof ReconnectKeyChangedError))
+              throw error;
+            keyChanged = error;
+            if (spentMs() + this.nextRouteReopenDelayMs() >= callDeadlineMs)
+              throw error;
+          } finally {
+            clearTimeout(timer);
+          }
+          const { delayMs, wait } = this.waitForRouteReopenBackoff();
+          scheduledDelayMs = spentMs() + delayMs;
+          let retryTimer;
+          try {
+            const waited = await Promise.race([
+              wait,
+              new Promise((resolve) => {
+                retryTimer = setTimeout(() => resolve(CALL_DEADLINE_EXPIRED), callDeadlineMs - (performance.now() - callStartedAt));
+              })
+            ]);
+            if (waited === CALL_DEADLINE_EXPIRED)
+              throw keyChanged;
+          } finally {
+            clearTimeout(retryTimer);
+          }
+        }
         this.assertRecordLive(record);
       } catch (error) {
         throw this.annotateReapError(error, record);
@@ -13911,21 +14479,39 @@ class SubcTransportPool {
           throw error;
         }
       };
-      const callDeadlineMs = timeoutMs ?? SUBC_DEFAULT_REQUEST_TIMEOUT_MS;
       const reloadWaitBudgetMs = Math.min(callDeadlineMs, ROUTE_OPEN_RELOAD_WAIT_CEILING_MS);
-      let reloadWaitedMs = 0;
+      let lastRefusal;
+      const openRouteWithinDeadline = async () => {
+        const remaining = remainingMs();
+        if (remaining <= 0)
+          throw callDeadlinePassedError(lastRefusal, callDeadlineMs);
+        let timer;
+        const expired = new Promise((resolve) => {
+          timer = setTimeout(() => resolve(CALL_DEADLINE_EXPIRED), remaining);
+        });
+        try {
+          const opened = await Promise.race([openRoute(), expired]);
+          if (opened === CALL_DEADLINE_EXPIRED) {
+            throw callDeadlinePassedError(lastRefusal, callDeadlineMs);
+          }
+          return opened;
+        } finally {
+          clearTimeout(timer);
+        }
+      };
       const openRouteAfterReloadWindow = async () => {
         while (true) {
           try {
-            return await openRoute();
+            return await openRouteWithinDeadline();
           } catch (error) {
             if (!isRouteOpenReloadWindowError(error))
               throw error;
-            if (reloadWaitedMs + this.nextRouteReopenDelayMs() >= reloadWaitBudgetMs) {
+            lastRefusal = error;
+            if (spentMs() + this.nextRouteReopenDelayMs() >= reloadWaitBudgetMs) {
               throw reloadWindowExhaustedError(error, callDeadlineMs);
             }
             const { delayMs, wait } = this.waitForRouteReopenBackoff();
-            reloadWaitedMs += delayMs;
+            scheduledDelayMs = spentMs() + delayMs;
             await wait;
           }
         }
@@ -13961,7 +14547,7 @@ class SubcTransportPool {
           route: routeLabel(entry.handle)
         });
       };
-      const requestOnRoute = async (route, entry) => {
+      const requestOnRoute = async (route, entry, requestTimeoutMs) => {
         this.assertRecordLive(record);
         if (abortSignal?.aborted) {
           clearRouteEntry(entry);
@@ -13977,8 +14563,10 @@ class SubcTransportPool {
         };
         abortSignal?.addEventListener("abort", onAbort, { once: true });
         try {
-          const requestTimeoutMs = reloadWaitedMs > 0 ? callDeadlineMs - reloadWaitedMs : timeoutMs;
-          const request = client.request(route, body, { timeoutMs: requestTimeoutMs, onProgress });
+          const request = client.request(route, body, {
+            timeoutMs: Math.ceil(requestTimeoutMs),
+            onProgress
+          });
           const reply = abortSignal ? await Promise.race([request, aborted]) : await request;
           if (!this.isCurrentSession(key, record)) {
             if (this.isReapInduced(record))
@@ -13999,8 +14587,11 @@ class SubcTransportPool {
       let reopened = false;
       let retriedAbsentRoute = false;
       while (true) {
+        const requestTimeoutMs = remainingMs();
+        if (requestTimeoutMs <= 0)
+          throw callDeadlinePassedError(lastRefusal, callDeadlineMs);
         try {
-          const reply = await requestOnRoute(routeAndEntry.route, routeAndEntry.entry);
+          const reply = await requestOnRoute(routeAndEntry.route, routeAndEntry.entry, requestTimeoutMs);
           if (reopened)
             this.resetRouteReopenBackoff();
           return reply;
@@ -14010,11 +14601,12 @@ class SubcTransportPool {
           const ownsRoute = this.isCurrentSession(key, record) && this.client === client;
           if (ownsRoute && isRouteRequestReloadRefusal(error)) {
             clearRouteEntry(routeAndEntry.entry);
-            if (reloadWaitedMs + this.nextRouteReopenDelayMs() >= reloadWaitBudgetMs) {
+            lastRefusal = error;
+            if (spentMs() + this.nextRouteReopenDelayMs() >= reloadWaitBudgetMs) {
               throw reloadWindowExhaustedError(error, callDeadlineMs);
             }
             const { delayMs, wait } = this.waitForRouteReopenBackoff();
-            reloadWaitedMs += delayMs;
+            scheduledDelayMs = spentMs() + delayMs;
             await wait;
             routeAndEntry = await openRouteAfterReloadWindow();
             reopened = true;
@@ -14023,7 +14615,12 @@ class SubcTransportPool {
           if (ownsRoute && !retriedAbsentRoute && isRouteProvenAbsentError(error)) {
             retriedAbsentRoute = true;
             clearRouteEntry(routeAndEntry.entry);
-            await this.waitForRouteReopenBackoff().wait;
+            if (spentMs() + this.nextRouteReopenDelayMs() >= callDeadlineMs) {
+              throw callDeadlinePassedError(error, callDeadlineMs);
+            }
+            const { delayMs, wait } = this.waitForRouteReopenBackoff();
+            scheduledDelayMs = spentMs() + delayMs;
+            await wait;
             routeAndEntry = await openRouteAfterReloadWindow();
             reopened = true;
             continue;
@@ -14086,10 +14683,14 @@ class SubcTransportPool {
         throw new SubcTransportShuttingDownError;
       }
       this.client = client;
+      this.hadWorkingClient = true;
       this.transportFailures = 0;
       return client;
     }).catch((error) => {
       this.connecting = null;
+      if (this.hadWorkingClient && error instanceof AuthError) {
+        throw new ReconnectKeyChangedError;
+      }
       throw error;
     });
     return this.connecting;
@@ -15781,6 +16382,7 @@ async function acquireBridge(locationDirectory, options, dependencies = {}) {
       let owner = state.standalone;
       if (!owner) {
         const configByRoot = new Map;
+        const versionMismatchHandlers = new Map;
         const configuredLoader = options.poolOptions.projectConfigLoader;
         const pool = await createPool({
           ...options,
@@ -15790,21 +16392,29 @@ async function acquireBridge(locationDirectory, options, dependencies = {}) {
             projectConfigLoader: (projectRoot) => ({
               ...configuredLoader?.(projectRoot) ?? {},
               ...configByRoot.get(canonicalizeProjectRoot(projectRoot)) ?? {}
-            })
+            }),
+            onVersionMismatch: (binaryVersion, minVersion) => [...versionMismatchHandlers.values()].at(-1)?.(binaryVersion, minVersion) ?? null
           }
         });
-        owner = { pool, configByRoot, referencesByRoot: new Map, references: 0 };
+        owner = {
+          pool,
+          configByRoot,
+          versionMismatchHandlers,
+          referencesByRoot: new Map,
+          references: 0
+        };
         state.standalone = owner;
       }
       owner.references += 1;
       owner.referencesByRoot.set(directory, (owner.referencesByRoot.get(directory) ?? 0) + 1);
       owner.configByRoot.set(directory, { ...options.configOverrides });
       const acquiredOwner = owner;
-      return new LocationBridgeLease(directory, mode, owner.pool, async () => {
+      const lease = new LocationBridgeLease(directory, mode, owner.pool, async () => {
         await withLock(directory, () => withLock(OWNER_LOCK, async () => {
           const current = lifecycleState().standalone;
           if (current !== acquiredOwner)
             return;
+          current.versionMismatchHandlers?.delete(lease);
           current.references -= 1;
           const rootReferences = (current.referencesByRoot.get(directory) ?? 1) - 1;
           if (rootReferences > 0)
@@ -15819,6 +16429,10 @@ async function acquireBridge(locationDirectory, options, dependencies = {}) {
           await current.pool.shutdown();
         }));
       });
+      const onVersionMismatch = options.poolOptions.onVersionMismatch;
+      if (onVersionMismatch)
+        owner.versionMismatchHandlers?.set(lease, onVersionMismatch);
+      return lease;
     });
   });
 }
@@ -15839,6 +16453,14 @@ var STANDALONE_DETACH_KEYWORDS_PATTERN = new RegExp(STANDALONE_DETACH_KEYWORD_SO
 function containsStandaloneDetachKeyword(messageText) {
   return STANDALONE_DETACH_KEYWORD_PATTERN.test(messageText);
 }
+function standaloneDetachKeywordRanges(messageText) {
+  const ranges = [];
+  for (const match of messageText.matchAll(STANDALONE_DETACH_KEYWORDS_PATTERN)) {
+    const start = (match.index ?? 0) + (match[1]?.length ?? 0);
+    ranges.push([start, start + BASH_WAIT_DETACH_MAGIC_KEYWORD.length]);
+  }
+  return ranges;
+}
 function stripStandaloneDetachKeywords(messageText) {
   return messageText.replace(STANDALONE_DETACH_KEYWORDS_PATTERN, "$1");
 }
@@ -15846,14 +16468,14 @@ function shouldInterruptWaitsForMessage(detachOnUserMessage, operatorText) {
   return detachOnUserMessage || containsStandaloneDetachKeyword(operatorText);
 }
 // ../aft-bridge/dist/migration.js
-import { closeSync as closeSync3, existsSync as existsSync8, mkdirSync as mkdirSync3, openSync as openSync3, readFileSync as readFileSync6, renameSync as renameSync4, rmSync as rmSync2, statSync as statSync5, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { closeSync as closeSync3, existsSync as existsSync8, mkdirSync as mkdirSync3, openSync as openSync3, readFileSync as readFileSync7, renameSync as renameSync4, rmSync as rmSync2, statSync as statSync6, unlinkSync as unlinkSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir8, tmpdir as tmpdir2 } from "node:os";
-import { basename, dirname as dirname4, join as join10, resolve as resolve6 } from "node:path";
+import { basename as basename2, dirname as dirname5, join as join10, resolve as resolve6 } from "node:path";
 
 // ../aft-bridge/dist/paths.js
-import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync4, renameSync as renameSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync5, renameSync as renameSync3, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
-import { dirname as dirname2, isAbsolute as isAbsolute3, join as join8, resolve as resolve5 } from "node:path";
+import { dirname as dirname3, isAbsolute as isAbsolute3, join as join8, resolve as resolve5 } from "node:path";
 function homeDir3() {
   if (process.platform === "win32")
     return process.env.USERPROFILE || process.env.HOME || homedir6();
@@ -15913,7 +16535,7 @@ function repairRootScopedStorageFile(storageRoot, harness, fileName) {
   if (existsSync6(harnessPath) || !existsSync6(rootPath))
     return harnessPath;
   try {
-    mkdirSync2(dirname2(harnessPath), { recursive: true });
+    mkdirSync2(dirname3(harnessPath), { recursive: true });
     renameSync3(rootPath, harnessPath);
   } catch {}
   return harnessPath;
@@ -15925,7 +16547,7 @@ function shouldShowAnnouncement(storageRoot, harness, currentVersion) {
   let lastVersion = "";
   try {
     if (existsSync6(versionFile)) {
-      lastVersion = readFileSync4(versionFile, "utf-8").trim();
+      lastVersion = readFileSync5(versionFile, "utf-8").trim();
     }
   } catch {
     return false;
@@ -15934,7 +16556,7 @@ function shouldShowAnnouncement(storageRoot, harness, currentVersion) {
     return false;
   if (!lastVersion) {
     try {
-      mkdirSync2(dirname2(versionFile), { recursive: true });
+      mkdirSync2(dirname3(versionFile), { recursive: true });
       writeFileSync2(versionFile, currentVersion);
     } catch {}
     return false;
@@ -15946,7 +16568,7 @@ function markAnnouncementSeen(storageRoot, harness, currentVersion) {
     return;
   const versionFile = repairRootScopedStorageFile(storageRoot, harness, "last_announced_version");
   try {
-    mkdirSync2(dirname2(versionFile), { recursive: true });
+    mkdirSync2(dirname3(versionFile), { recursive: true });
     writeFileSync2(versionFile, currentVersion);
   } catch {}
 }
@@ -15995,10 +16617,10 @@ function decodeFileUrl(target) {
 }
 
 // ../aft-bridge/dist/resolver.js
-import { closeSync as closeSync2, existsSync as existsSync7, promises as fsPromises, openSync as openSync2, readFileSync as readFileSync5, readSync } from "node:fs";
+import { closeSync as closeSync2, existsSync as existsSync7, promises as fsPromises, openSync as openSync2, readFileSync as readFileSync6, readSync } from "node:fs";
 import { createRequire } from "node:module";
 import { homedir as homedir7 } from "node:os";
-import { delimiter, dirname as dirname3, isAbsolute as isAbsolute4, join as join9 } from "node:path";
+import { delimiter, dirname as dirname4, isAbsolute as isAbsolute4, join as join9 } from "node:path";
 var ensureBinaryForResolver = ensureBinary;
 var npmPlatformPackageReader = null;
 var cacheCopiesInFlight = new Map;
@@ -16151,8 +16773,8 @@ function npmPlatformPackage(ext) {
   try {
     const req = createRequire(import.meta.url);
     const manifestPath = req.resolve(`@cortexkit/aft-${platformKey()}/package.json`);
-    const manifest = JSON.parse(readFileSync5(manifestPath, "utf8"));
-    const binaryPath = join9(dirname3(manifestPath), "bin", `aft${ext}`);
+    const manifest = JSON.parse(readFileSync6(manifestPath, "utf8"));
+    const binaryPath = join9(dirname4(manifestPath), "bin", `aft${ext}`);
     if (typeof manifest.version !== "string" || !existsSync7(binaryPath))
       return null;
     return { binaryPath, version: normalizeBareVersion(manifest.version) };
@@ -16406,7 +17028,7 @@ function acquireConfigMigrationLock(lockDir) {
       if (code !== "EEXIST")
         throw err;
       try {
-        const ageMs = Date.now() - statSync5(lockDir).mtimeMs;
+        const ageMs = Date.now() - statSync6(lockDir).mtimeMs;
         if (ageMs > 60000) {
           rmSync2(lockDir, { recursive: true, force: true });
           continue;
@@ -16420,12 +17042,12 @@ function acquireConfigMigrationLock(lockDir) {
   }
 }
 function atomicCopyConfigFile(sourcePath, targetPath) {
-  mkdirSync3(dirname4(targetPath), { recursive: true });
-  const tmpPath = join10(dirname4(targetPath), `.${basename(targetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`);
+  mkdirSync3(dirname5(targetPath), { recursive: true });
+  const tmpPath = join10(dirname5(targetPath), `.${basename2(targetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`);
   let fd = null;
   try {
     fd = openSync3(tmpPath, "wx", 384);
-    writeFileSync3(fd, readFileSync6(sourcePath));
+    writeFileSync3(fd, readFileSync7(sourcePath));
     closeSync3(fd);
     fd = null;
     renameSync4(tmpPath, targetPath);
@@ -16442,8 +17064,8 @@ function atomicCopyConfigFile(sourcePath, targetPath) {
   }
 }
 function atomicWriteConfigFile(targetPath, content) {
-  mkdirSync3(dirname4(targetPath), { recursive: true });
-  const tmpPath = join10(dirname4(targetPath), `.${basename(targetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`);
+  mkdirSync3(dirname5(targetPath), { recursive: true });
+  const tmpPath = join10(dirname5(targetPath), `.${basename2(targetPath)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`);
   let fd = null;
   try {
     fd = openSync3(tmpPath, "wx", 384);
@@ -16504,11 +17126,11 @@ function markLegacySourcesMovedAside(sources, targetPath, logger) {
     const desiredMarkerPath = `${source.path}${MOVED_MARKER_SUFFIX}`;
     const markerPath = nonClobberingSidecarPath(desiredMarkerPath);
     try {
-      const original = readFileSync6(source.path, "utf-8");
+      const original = readFileSync7(source.path, "utf-8");
       if (markerPath !== desiredMarkerPath) {
         logger?.warn?.(`Preserving existing legacy AFT marker ${desiredMarkerPath}; writing new marker to ${markerPath}`);
       }
-      atomicWriteConfigFile(markerPath, movedMarkerContent(targetPath, basename(source.path), original));
+      atomicWriteConfigFile(markerPath, movedMarkerContent(targetPath, basename2(source.path), original));
       unlinkSync3(source.path);
       info?.(`Moved legacy AFT config ${source.path} aside to ${markerPath}; AFT now reads ${targetPath}`);
     } catch (err) {
@@ -16568,15 +17190,15 @@ function migrateAftConfigFile(opts) {
   if (existingSources.length === 0) {
     return { migrated: false, conflict: false, targetPath: opts.targetPath, warnings };
   }
-  mkdirSync3(dirname4(opts.targetPath), { recursive: true });
+  mkdirSync3(dirname5(opts.targetPath), { recursive: true });
   const release = acquireConfigMigrationLock(`${opts.targetPath}.lock`);
   try {
     const sources = existingSources.map((source) => ({
       ...source,
-      content: readFileSync6(source.path, "utf-8")
+      content: readFileSync7(source.path, "utf-8")
     }));
     if (existsSync8(opts.targetPath)) {
-      const targetContent = readFileSync6(opts.targetPath, "utf-8");
+      const targetContent = readFileSync7(opts.targetPath, "utf-8");
       for (const source of sources) {
         if (fileSemanticsMatch(source.content, targetContent))
           continue;
@@ -16627,11 +17249,11 @@ function spawnErrorLabel(error) {
 function migrationLogPath(newRoot, harness, logger) {
   const desired = join10(newRoot, "logs", "migration", `${harness}-${Date.now()}.jsonl`);
   try {
-    mkdirSync3(dirname4(desired), { recursive: true });
+    mkdirSync3(dirname5(desired), { recursive: true });
     return desired;
   } catch (err) {
     const fallback = join10(tmpdir2(), `aft-migration-${harness}-${Date.now()}.jsonl`);
-    logger?.warn?.(`Failed to create AFT migration log directory ${dirname4(desired)}: ${err instanceof Error ? err.message : String(err)}. ` + `Using fallback log path ${fallback}.`);
+    logger?.warn?.(`Failed to create AFT migration log directory ${dirname5(desired)}: ${err instanceof Error ? err.message : String(err)}. ` + `Using fallback log path ${fallback}.`);
     return fallback;
   }
 }
@@ -16692,9 +17314,9 @@ async function ensureStorageMigrated(opts) {
   throw new Error(`AFT storage migration failed (${detail}). ` + `Harness: ${opts.harness}. Legacy: ${legacyRoot}. Target: ${newRoot}. ` + `See log: ${logPath}. ` + `Plugin load aborted to prevent legacy/new state divergence.` + (stderrTail ? ` Stderr tail: ${stderrTail}` : "") + (stdoutTail ? ` Stdout tail: ${stdoutTail}` : ""));
 }
 // ../aft-bridge/dist/migration-notices.js
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync7, renameSync as renameSync5, rmdirSync, statSync as statSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync8, renameSync as renameSync5, rmdirSync, statSync as statSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
-import { dirname as dirname5, join as join11, resolve as resolve7 } from "node:path";
+import { dirname as dirname6, join as join11, resolve as resolve7 } from "node:path";
 function migrationNoticeStorePath(env = process.env) {
   const stateHome = env.XDG_STATE_HOME && env.XDG_STATE_HOME.length > 0 ? env.XDG_STATE_HOME : join11(homedir9(), ".local", "state");
   return join11(stateHome, "cortexkit", "aft", "migration-notices.json");
@@ -16704,7 +17326,7 @@ function noticeKey(configPath, digest) {
 }
 function readRecords(storePath) {
   try {
-    const parsed = JSON.parse(readFileSync7(storePath, "utf8"));
+    const parsed = JSON.parse(readFileSync8(storePath, "utf8"));
     return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
   } catch {
     return {};
@@ -16713,7 +17335,7 @@ function readRecords(storePath) {
 var LOCK_STALE_MS = 1e4;
 function withStoreLock(storePath, action) {
   const lockPath = `${storePath}.lock`;
-  mkdirSync4(dirname5(storePath), { recursive: true });
+  mkdirSync4(dirname6(storePath), { recursive: true });
   const deadline = Date.now() + 2000;
   for (;; ) {
     try {
@@ -16723,7 +17345,7 @@ function withStoreLock(storePath, action) {
       if (error.code !== "EEXIST")
         throw error;
       try {
-        if (Date.now() - statSync6(lockPath).mtimeMs > LOCK_STALE_MS)
+        if (Date.now() - statSync7(lockPath).mtimeMs > LOCK_STALE_MS)
           rmdirSync(lockPath);
       } catch {}
       if (Date.now() > deadline)
@@ -16764,9 +17386,9 @@ function deliverMigrationNoticeOnce(options) {
   }
 }
 // ../aft-bridge/dist/npm-resolver.js
-import { readdirSync as readdirSync2, statSync as statSync7 } from "node:fs";
+import { readdirSync as readdirSync2, statSync as statSync8 } from "node:fs";
 import { homedir as homedir10 } from "node:os";
-import { dirname as dirname6, isAbsolute as isAbsolute5, join as join12 } from "node:path";
+import { dirname as dirname7, isAbsolute as isAbsolute5, join as join12 } from "node:path";
 function defaultDeps() {
   return {
     platform: process.platform,
@@ -16780,7 +17402,7 @@ function npmBinaryName(platform) {
 }
 function isFile(p) {
   try {
-    return statSync7(p).isFile();
+    return statSync8(p).isFile();
   } catch {
     return false;
   }
@@ -16801,7 +17423,7 @@ function npmFromPath(deps) {
   return null;
 }
 function npmAdjacentToNode(deps) {
-  const dir = dirname6(deps.execPath);
+  const dir = dirname7(deps.execPath);
   return isFile(join12(dir, npmBinaryName(deps.platform))) ? dir : null;
 }
 function highestVersionedNodeBin(installsDir, name) {
@@ -17189,8 +17811,8 @@ function probeOnnxRuntimeLoadable(libPath, arch = process.arch) {
 }
 // ../aft-bridge/dist/onnx-runtime.js
 import { createHash as createHash5, randomBytes as randomBytes2 } from "node:crypto";
-import { chmodSync as chmodSync2, closeSync as closeSync5, copyFileSync as copyFileSync2, createWriteStream as createWriteStream2, existsSync as existsSync11, lstatSync, mkdirSync as mkdirSync5, openSync as openSync5, readdirSync as readdirSync3, readFileSync as readFileSync8, readlinkSync, realpathSync as realpathSync3, renameSync as renameSync6, rmSync as rmSync3, statSync as statSync8, symlinkSync, unlinkSync as unlinkSync4, writeFileSync as writeFileSync5 } from "node:fs";
-import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute6, join as join14, relative as relative2, resolve as resolve8, win32 } from "node:path";
+import { chmodSync as chmodSync2, closeSync as closeSync5, copyFileSync as copyFileSync2, createWriteStream as createWriteStream2, existsSync as existsSync11, lstatSync, mkdirSync as mkdirSync5, openSync as openSync5, readdirSync as readdirSync3, readFileSync as readFileSync9, readlinkSync, realpathSync as realpathSync3, renameSync as renameSync6, rmSync as rmSync3, statSync as statSync9, symlinkSync, unlinkSync as unlinkSync4, writeFileSync as writeFileSync5 } from "node:fs";
+import { basename as basename3, dirname as dirname8, isAbsolute as isAbsolute6, join as join14, relative as relative2, resolve as resolve8, win32 } from "node:path";
 import { Readable as Readable2 } from "node:stream";
 import { pipeline as pipeline2 } from "node:stream/promises";
 
@@ -17230,31 +17852,36 @@ var ORT_PLATFORM_MAP = {
     arm64: {
       assetName: `onnxruntime-osx-arm64-${ORT_VERSION}`,
       libName: "libonnxruntime.dylib",
-      archiveType: "tgz"
+      archiveType: "tgz",
+      librarySha256: "872533f130f1839a5bc01788ddb4f75c83a189763441ba1178788ed965449289"
     }
   },
   linux: {
     x64: {
       assetName: `onnxruntime-linux-x64-${ORT_VERSION}`,
       libName: "libonnxruntime.so",
-      archiveType: "tgz"
+      archiveType: "tgz",
+      librarySha256: "d132535d051344ff5c64c9c200004150559049a81ed330eb4422c1962fb6b7e4"
     },
     arm64: {
       assetName: `onnxruntime-linux-aarch64-${ORT_VERSION}`,
       libName: "libonnxruntime.so",
-      archiveType: "tgz"
+      archiveType: "tgz",
+      librarySha256: "52b2a0e75e79468404284fec38ad5ee1a7a996232274f5e1b84f3e793fb07554"
     }
   },
   win32: {
     x64: {
       assetName: `onnxruntime-win-x64-${ORT_VERSION}`,
       libName: "onnxruntime.dll",
-      archiveType: "zip"
+      archiveType: "zip",
+      librarySha256: "b95efb2113b603bbbf3f191061c5516a871ed546893c820e4f3b7b6c358dbf2a"
     },
     arm64: {
       assetName: `onnxruntime-win-arm64-${ORT_VERSION}`,
       libName: "onnxruntime.dll",
-      archiveType: "zip"
+      archiveType: "zip",
+      librarySha256: "724d81ac50b11bfaa01ab3ce01b99fb6734a4b762259a8be4395ca662ce99fe6"
     }
   }
 };
@@ -17397,7 +18024,7 @@ function cleanupAbandonedStagingDirs(onnxBaseDir) {
             abandoned = true;
           } else {
             try {
-              const ageMs = Date.now() - statSync8(stagingDir).mtimeMs;
+              const ageMs = Date.now() - statSync9(stagingDir).mtimeMs;
               abandoned = ageMs > STALE_LOCK_MS;
             } catch {
               abandoned = true;
@@ -17434,7 +18061,7 @@ var REQUIRED_ORT_MAJOR = 1;
 var REQUIRED_ORT_MIN_MINOR = 20;
 var INVALID_ORT_VERSION = "<invalid>";
 function parseOnnxVersionFromPath(value) {
-  const name = basename2(value);
+  const name = basename3(value);
   const semverish = name.match(/(?:^|[._-])(\d+\.\d+\.\d+(?:[-+][A-Za-z0-9.-]+)?)(?:\.(?:dylib|dll))?$/);
   if (semverish)
     return semverish[1].split(/[-+]/, 1)[0];
@@ -17639,7 +18266,7 @@ async function downloadFileWithCap(url, destPath) {
     if (Number.isFinite(advertised) && advertised > MAX_DOWNLOAD_BYTES2) {
       throw new Error(`Content-Length ${advertised} exceeds max ${MAX_DOWNLOAD_BYTES2}`);
     }
-    mkdirSync5(dirname7(destPath), { recursive: true });
+    mkdirSync5(dirname8(destPath), { recursive: true });
     let bytesWritten = 0;
     const guard = new TransformStream({
       transform(chunk, transformController) {
@@ -17673,7 +18300,7 @@ function validateExtractedTree(stagingRoot) {
       const lst = lstatSync(fullPath);
       if (lst.isSymbolicLink()) {
         const linkTarget = readlinkSync(fullPath);
-        const resolvedTarget = resolve8(dirname7(fullPath), linkTarget);
+        const resolvedTarget = resolve8(dirname8(fullPath), linkTarget);
         const rel = relative2(realRoot, resolvedTarget);
         if (rel.startsWith("..") || isAbsolute6(rel) || win32.isAbsolute(rel)) {
           throw new Error(`extracted symlink ${fullPath} points outside staging root: ${linkTarget}`);
@@ -17744,6 +18371,9 @@ async function downloadOnnxRuntime(info, targetDir) {
     copyOnnxLibraries(info, extractedDir, stagedInstallDir, realFiles, symlinks);
     const libPath = join14(stagedInstallDir, info.libName);
     const libHash = sha256File2(libPath);
+    if (libHash !== info.librarySha256) {
+      throw new Error(`onnx runtime library hash mismatch at ${libPath}: sha256 ${libHash}, ` + `expected the pinned ${info.librarySha256} for ${info.assetName}`);
+    }
     writeOnnxInstalledMeta(stagedInstallDir, ORT_VERSION, libHash, archiveSha256);
     publishOnnxRuntime(stagedInstallDir, targetDir);
     rmSync3(tmpDir, { recursive: true, force: true });
@@ -17809,7 +18439,7 @@ function copyOnnxLibraries(info, extractedDir, targetDir, realFiles, symlinks, c
       unlinkSync4(dst);
     } catch {}
     const dstForContainment = join14(targetRoot, link.name);
-    const resolvedTarget = resolve8(dirname7(dstForContainment), link.target);
+    const resolvedTarget = resolve8(dirname8(dstForContainment), link.target);
     if (!isPathInsideRoot(targetRoot, resolvedTarget)) {
       const message = `ONNX Runtime symlink ${link.name} points outside install dir: ${link.target}`;
       if (requiredLibs.has(link.name)) {
@@ -17861,9 +18491,9 @@ function writeOnnxInstalledMeta(installDir, version, sha256, archiveSha256) {
 function readOnnxInstalledMeta(installDir) {
   const path = join14(installDir, ONNX_INSTALLED_META_FILE);
   try {
-    if (!statSync8(path).isFile())
+    if (!statSync9(path).isFile())
       return null;
-    const raw = readFileSync8(path, "utf8");
+    const raw = readFileSync9(path, "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.version !== "string" || parsed.version.length === 0)
       return null;
@@ -17879,7 +18509,7 @@ function readOnnxInstalledMeta(installDir) {
 }
 function sha256File2(path) {
   const hash = createHash5("sha256");
-  hash.update(readFileSync8(path));
+  hash.update(readFileSync9(path));
   return hash.digest("hex");
 }
 function acquireLock(lockPath) {
@@ -17907,12 +18537,12 @@ ${new Date().toISOString()}
   let owningPid = null;
   let lockMtimeMs = 0;
   try {
-    const raw = readFileSync8(lockPath, "utf8");
+    const raw = readFileSync9(lockPath, "utf8");
     const firstLine = raw.split(/\r?\n/, 1)[0]?.trim() ?? "";
     const parsed = Number.parseInt(firstLine, 10);
     if (Number.isFinite(parsed) && parsed > 0)
       owningPid = parsed;
-    lockMtimeMs = statSync8(lockPath).mtimeMs;
+    lockMtimeMs = statSync9(lockPath).mtimeMs;
   } catch {
     return tryClaim();
   }
@@ -17932,7 +18562,7 @@ function releaseLock(lockPath) {
   try {
     let owningPid = null;
     try {
-      const raw = readFileSync8(lockPath, "utf8");
+      const raw = readFileSync9(lockPath, "utf8");
       const firstLine = raw.split(/\r?\n/, 1)[0]?.trim() ?? "";
       const parsed = Number.parseInt(firstLine, 10);
       if (Number.isFinite(parsed) && parsed > 0)
@@ -18086,12 +18716,13 @@ function normalizeZoomTargets(record) {
       throw new InvalidRequestError(`'targets[${index}].path' must be a non-empty string`);
     }
     const source = target;
-    const emptyTarget = source.symbol === "" && (hasOwn(source, "path") && source.path === "" || hasOwn(source, "filePath") && source.filePath === "");
+    const blank = (value) => value === undefined || value === null || typeof value === "string" && !value.trim();
+    const emptyTarget = blank(source.symbol) && blank(source.path) && blank(source.filePath);
     if (emptyTarget)
       return { ...source };
     const normalized = { ...source };
     try {
-      normalizeAliasPair(normalized, "path", "filePath", true);
+      normalizeAliasPair(normalized, "path", "filePath", false);
     } catch (error) {
       if (error instanceof InvalidRequestError) {
         throw new InvalidRequestError(error.message.replace("'filePath'", `'targets[${index}].filePath'`).replace("'path'", `'targets[${index}].path'`));
@@ -18623,7 +19254,7 @@ function formatSemanticIndexStatus(status, stage, error, backend) {
   return status;
 }
 // src/config.ts
-import { existsSync as existsSync12, readFileSync as readFileSync9, renameSync as renameSync7, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync12, readFileSync as readFileSync10, renameSync as renameSync7, unlinkSync as unlinkSync5, writeFileSync as writeFileSync6 } from "node:fs";
 import { homedir as homedir11 } from "node:os";
 import { isAbsolute as isAbsolute7, parse as parsePath, resolve as resolvePath } from "node:path";
 var import_comment_json = __toESM(require_src2(), 1);
@@ -23466,6 +24097,17 @@ var SemanticConfigSchema = object({
   max_input_tokens: number2().int().positive().optional(),
   max_files: number2().int().positive().optional()
 });
+var RerankConfigSchema = object({
+  backend: _enum(["off", "onnx", "remote", "synapse"]).optional(),
+  model: string2().trim().min(1).optional(),
+  endpoint: string2().trim().min(1).optional(),
+  api_key_env: string2().trim().min(1).optional(),
+  top_n: number2().int().positive().optional(),
+  timeout_ms: number2().int().positive().optional()
+});
+var SearchConfigSchema = object({
+  rerank: RerankConfigSchema.optional()
+});
 var LspExtensionSchema = string2().trim().min(1).refine((value) => value.replace(/^\.+/, "").length > 0, {
   message: "Extension must include characters other than leading dots"
 });
@@ -23526,6 +24168,10 @@ var SubcConfigSchema = object({
   connection_file: string2().optional(),
   client_reaper: boolean2().optional()
 });
+var OpenCodeHostConfigSchema = object({
+  server_url: string2().optional(),
+  server_password_env: string2().optional()
+});
 var GhShimConfigSchema = object({
   binary_path: string2().trim().refine(isAbsolute7, "gh_shim.binary_path must be absolute").optional()
 });
@@ -23611,9 +24257,11 @@ var AftConfigFieldsSchema = object({
   lsp: LspConfigSchema.optional(),
   url_fetch_allow_private: boolean2().optional(),
   semantic: SemanticConfigSchema.optional(),
+  search: SearchConfigSchema.optional(),
   auto_update: boolean2().optional(),
   bridge: BridgeConfigSchema.optional(),
   subc: SubcConfigSchema.optional(),
+  opencode: OpenCodeHostConfigSchema.optional(),
   github: GithubConfigSchema.optional(),
   gh_shim: GhShimConfigSchema.optional(),
   git: GitConfigSchema.optional(),
@@ -23855,7 +24503,7 @@ function migrateAftConfigFile2(configPath, logger = { log: log2, warn: warn2 })
   let tmpPath = null;
   let oldKeys = [];
   try {
-    const content = readFileSync9(configPath, "utf-8");
+    const content = readFileSync10(configPath, "utf-8");
     const rawConfig = import_comment_json.parse(content);
     if (!rawConfig || typeof rawConfig !== "object" || Array.isArray(rawConfig)) {
       return { migrated: false, oldKeys: [] };
@@ -23922,6 +24570,18 @@ function parseConfigPartially(rawConfig) {
   return partialConfig;
 }
 var configLoadErrors = [];
+var configValidationErrors = [];
+var configLoadSources = [];
+var configLoadTexts = new Map;
+function getConfigLoadSources() {
+  return configLoadSources;
+}
+function getConfigLoadTexts() {
+  return configLoadTexts;
+}
+function getConfigValidationErrors() {
+  return configValidationErrors;
+}
 function getConfigLoadErrors() {
   return configLoadErrors;
 }
@@ -23954,7 +24614,9 @@ function loadConfigFromPath(configPath, tier) {
     if (!existsSync12(configPath)) {
       return null;
     }
-    const content = readFileSync9(configPath, "utf-8");
+    const content = readFileSync10(configPath, "utf-8");
+    configLoadSources.push(configPath);
+    configLoadTexts.set(configPath, content);
     const rawConfig = import_comment_json.parse(content);
     migrateRawConfig(rawConfig, configPath, { log: log2, warn: warn2 });
     cleanConfig = stripJsoncSymbols(rawConfig);
@@ -23999,6 +24661,7 @@ function loadConfigFromPath(configPath, tier) {
   } else {
     const errorMsg = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join(", ");
     warn2(`Config validation error in ${configPath}: ${errorMsg}`);
+    configValidationErrors.push({ path: configPath, message: errorMsg });
     parsed = parseConfigPartially(cleanConfig);
   }
   if (!parsed)
@@ -24188,6 +24851,8 @@ function getStrippedTopLevelKeys(override) {
     stripped.push("sandbox.write_allow");
   if (override.subc !== undefined)
     stripped.push("subc");
+  if (override.opencode !== undefined)
+    stripped.push("opencode");
   if (override.github !== undefined)
     stripped.push("github");
   if (override.gh_shim !== undefined)
@@ -24195,14 +24860,33 @@ function getStrippedTopLevelKeys(override) {
   for (const tool of partitionProjectDisables(override.disabled_tools).ignored) {
     stripped.push(`disabled_tools.${tool}`);
   }
+  stripped.push(...projectRerankStrippedKeys(override.search?.rerank));
+  return stripped;
+}
+function projectRerankStrippedKeys(rerank) {
+  if (rerank === undefined)
+    return [];
+  const stripped = [];
+  if (rerank.backend !== undefined && rerank.backend !== "off")
+    stripped.push("search.rerank.backend");
+  for (const key of ["model", "endpoint", "api_key_env", "top_n", "timeout_ms"]) {
+    if (rerank[key] !== undefined)
+      stripped.push(`search.rerank.${key}`);
+  }
   return stripped;
 }
+function mergeProjectSearchConfig(base, project) {
+  if (project?.rerank?.backend !== "off")
+    return base;
+  return { ...base, rerank: { ...base?.rerank, backend: "off" } };
+}
 function mergeConfigs(base, override) {
   const disabledTools = unionDisabledTools(base.disabled_tools, partitionProjectDisables(override.disabled_tools).accepted);
   const indexes = mergeIndexes(base.indexes, override.indexes, true);
   const formatter = { ...base.formatter, ...override.formatter };
   const checker = { ...base.checker, ...override.checker };
   const semantic = mergeSemanticConfig(base.semantic, override.semantic);
+  const search = mergeProjectSearchConfig(base.search, override.search);
   const lsp = mergeLspConfig(base.lsp, override.lsp);
   const experimental = mergeExperimentalConfig(base.experimental, override.experimental);
   const bash = mergeBashConfig(base.bash, override.bash);
@@ -24232,6 +24916,7 @@ function mergeConfigs(base, override) {
     ...pi !== undefined ? { pi } : {},
     experimental,
     semantic,
+    search,
     ...bridge !== undefined ? { bridge } : {},
     ...indexes !== undefined ? { indexes } : {},
     ...disabledTools !== undefined ? { disabled_tools: disabledTools } : {}
@@ -24296,6 +24981,9 @@ function buildConfigTierConfigureParams(projectDirectory, processState = {}) {
 }
 function loadAftConfig(projectDirectory) {
   configLoadErrors = [];
+  configValidationErrors = [];
+  configLoadSources = [];
+  configLoadTexts = new Map;
   configLoadNotices = [];
   semanticInputSupplied = false;
   const { userConfigPath, projectConfigPath } = resolveAftConfigPaths(projectDirectory);
@@ -38024,6 +38712,14 @@ function formatDuration(completion) {
 }
 
 // src/shared/session-directory.ts
+import { Effect } from "effect";
+function isV2PluginContext(client) {
+  if (!client || typeof client !== "object")
+    return false;
+  const candidate = client;
+  return typeof candidate.location?.directory === "string" && typeof candidate.session?.get === "function";
+}
+var V2_SESSION_LOOKUP_TIMEOUT_MS = 3000;
 var CACHE_MAX_ENTRIES = 200;
 var cache = new Map;
 async function getSessionDirectory(client, sessionId, fallbackDirectory) {
@@ -38035,6 +38731,8 @@ async function getSessionDirectory(client, sessionId, fallbackDirectory) {
     cache.set(sessionId, cached);
     return cached.directory;
   }
+  if (isV2PluginContext(client))
+    return lookupV2SessionDirectory(client, sessionId);
   const c = client;
   const sessionApi = c?.session;
   if (!sessionApi || typeof sessionApi.get !== "function") {
@@ -38055,6 +38753,25 @@ async function getSessionDirectory(client, sessionId, fallbackDirectory) {
   setCache(sessionId, dir);
   return dir;
 }
+async function lookupV2SessionDirectory(context, sessionId) {
+  let dir = null;
+  let failure;
+  try {
+    const session = await Effect.runPromise(Effect.timeout(context.session.get({ sessionID: sessionId }), V2_SESSION_LOOKUP_TIMEOUT_MS));
+    const directory = session?.location?.directory;
+    if (typeof directory === "string" && directory.length > 0)
+      dir = directory;
+    else
+      failure = "the session record has no location.directory";
+  } catch (err) {
+    failure = err instanceof Error ? err.message || err.name : String(err);
+  }
+  if (failure !== undefined) {
+    sessionWarn(sessionId, `[aft-plugin] OpenCode 2 session lookup failed (${failure}); tool paths and bash use the Location directory ${context.location.directory} for this session`);
+  }
+  setCache(sessionId, dir);
+  return dir;
+}
 function setCache(sessionId, directory) {
   if (cache.has(sessionId))
     cache.delete(sessionId);
@@ -38113,6 +38830,108 @@ async function verifySessionDirectory(client, sessionId) {
   return dir;
 }
 
+// src/shared/subagent-detect.ts
+import { Effect as Effect2 } from "effect";
+var CACHE_MAX_ENTRIES2 = 200;
+var LOOKUP_TIMEOUT_MS = 1000;
+var FAILED_LOOKUP_RETRY_MS = 30000;
+var cache2 = new Map;
+var inflight = new Map;
+var now = () => Date.now();
+async function resolveIsSubagent(client, sessionId, _fallbackDirectory) {
+  if (!sessionId) {
+    sessionLog(undefined, "[subagent-detect] no sessionId provided → primary");
+    return false;
+  }
+  const cached = cache2.get(sessionId);
+  if (cached && (cached.retryAfter === undefined || now() < cached.retryAfter)) {
+    cache2.delete(sessionId);
+    cache2.set(sessionId, cached);
+    return cached.isSubagent;
+  }
+  const pending = inflight.get(sessionId);
+  if (pending)
+    return pending;
+  const lookup = boundedLookup(client, sessionId).finally(() => {
+    inflight.delete(sessionId);
+  });
+  inflight.set(sessionId, lookup);
+  return lookup;
+}
+async function boundedLookup(client, sessionId) {
+  let timer;
+  const timedOut = new Promise((resolve) => {
+    timer = setTimeout(() => resolve("timeout"), LOOKUP_TIMEOUT_MS);
+  });
+  let answer;
+  try {
+    answer = await Promise.race([lookupSession(client, sessionId), timedOut]);
+  } finally {
+    clearTimeout(timer);
+  }
+  if (typeof answer === "boolean") {
+    setCache2(sessionId, answer);
+    return answer;
+  }
+  if (answer === "timeout") {
+    sessionWarn(sessionId, `[subagent-detect] session lookup did not answer within ${LOOKUP_TIMEOUT_MS}ms → primary for now`);
+  }
+  setCache2(sessionId, false, now() + FAILED_LOOKUP_RETRY_MS);
+  return false;
+}
+async function lookupSession(client, sessionId) {
+  if (isV2PluginContext2(client))
+    return resolveV2(client, sessionId);
+  const c = client;
+  const sessionApi = c?.session;
+  if (!sessionApi || typeof sessionApi.get !== "function") {
+    sessionLog(sessionId, `[subagent-detect] client.session.get unavailable (client=${typeof client}, session=${typeof sessionApi}, get=${typeof sessionApi?.get}) → caching as primary`);
+    return false;
+  }
+  sessionLog(sessionId, `[subagent-detect] cache miss, calling client.session.get(id=${sessionId})`);
+  try {
+    const result = await sessionApi.get({
+      path: { id: sessionId }
+    });
+    const session = result?.data ?? result;
+    const parentIdRaw = session?.parentID;
+    const isSubagent = session !== undefined && typeof session.parentID === "string" && session.parentID.length > 0;
+    sessionLog(sessionId, `[subagent-detect] SDK returned session=${session !== undefined ? "present" : "undefined"}, parentID=${JSON.stringify(parentIdRaw)} → isSubagent=${isSubagent}`);
+    return isSubagent;
+  } catch (err) {
+    sessionWarn(sessionId, `[subagent-detect] SDK lookup failed: ${err instanceof Error ? err.message : String(err)}`);
+    return "failed";
+  }
+}
+function isV2PluginContext2(client) {
+  if (!client || typeof client !== "object")
+    return false;
+  const candidate = client;
+  return typeof candidate.location?.directory === "string" && typeof candidate.session?.get === "function";
+}
+async function resolveV2(context, sessionId) {
+  let session;
+  try {
+    session = await Effect2.runPromise(context.session.get({ sessionID: sessionId }));
+  } catch (err) {
+    sessionWarn(sessionId, `[subagent-detect] OpenCode 2 session lookup failed: ${err instanceof Error ? err.message : String(err)}`);
+    return "failed";
+  }
+  const isSubagent = typeof session?.parentID === "string" && session.parentID.length > 0;
+  sessionLog(sessionId, `[subagent-detect] OpenCode 2 session parentID=${JSON.stringify(session?.parentID)} → isSubagent=${isSubagent}`);
+  return isSubagent;
+}
+function setCache2(sessionId, isSubagent, retryAfter) {
+  if (cache2.has(sessionId))
+    cache2.delete(sessionId);
+  cache2.set(sessionId, retryAfter === undefined ? { isSubagent } : { isSubagent, retryAfter });
+  if (cache2.size > CACHE_MAX_ENTRIES2) {
+    const oldest = cache2.keys().next().value;
+    if (oldest !== undefined)
+      cache2.delete(oldest);
+  }
+}
+
 // src/tool-perf.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 var perfStore = new AsyncLocalStorage;
@@ -38128,16 +38947,29 @@ function markBridgeEnd() {
     slot.bridgeEnd = performance.now();
   }
 }
+async function measurePreStage(stage, operation) {
+  const start = performance.now();
+  try {
+    return await operation();
+  } finally {
+    const slot = perfStore.getStore();
+    if (slot) {
+      slot.stages ??= {};
+      slot.stages[stage] = (slot.stages[stage] ?? 0) + performance.now() - start;
+    }
+  }
+}
 function emit(slot) {
+  const stages = slot.stages ? ` directory=${Math.round(slot.stages.directory ?? 0)}ms permission=${Math.round(slot.stages.permission ?? 0)}ms capability=${Math.round(slot.stages.capability ?? 0)}ms` : "";
   const t3 = performance.now();
   const total = Math.round(t3 - slot.t0);
   if (slot.bridgeStart !== undefined && slot.bridgeEnd !== undefined) {
     const pre = Math.round(slot.bridgeStart - slot.t0);
     const bridge = Math.round(slot.bridgeEnd - slot.bridgeStart);
     const post = Math.round(t3 - slot.bridgeEnd);
-    sessionLog(slot.sessionID, `perf tool=${slot.tool} total=${total}ms pre=${pre}ms bridge=${bridge}ms post=${post}ms`);
+    sessionLog(slot.sessionID, `perf tool=${slot.tool} total=${total}ms pre=${pre}ms bridge=${bridge}ms post=${post}ms${stages}`);
   } else {
-    sessionLog(slot.sessionID, `perf tool=${slot.tool} total=${total}ms (no bridge call)`);
+    sessionLog(slot.sessionID, `perf tool=${slot.tool} total=${total}ms (no bridge call)${stages}`);
   }
 }
 function instrumentToolMap(tools) {
@@ -38175,7 +39007,7 @@ function projectRootFor(runtime) {
   if (typeof cached === "string" && cached.length > 0) {
     return canonicalizeDirectory(cached);
   }
-  const raw = runtime.worktree ?? runtime.directory;
+  const raw = runtime.directoryIsSessionRoot ? runtime.directory : runtime.worktree ?? runtime.directory;
   return canonicalizeDirectory(raw);
 }
 async function resolveProjectRoot(ctx, runtime) {
@@ -38211,6 +39043,11 @@ function bridgeFor(ctx, runtime) {
   }
   return ctx.pool.getBridge(projectRoot);
 }
+async function isWorkerRuntime(ctx, runtime) {
+  if (!runtime.sessionID)
+    return false;
+  return resolveIsSubagent(ctx.client, runtime.sessionID, runtime.directory);
+}
 async function callBridge(ctx, runtime, command, params = {}, options) {
   if (runtime.sessionID && getSessionDirectoryCached(runtime.sessionID) === undefined) {
     await getSessionDirectory(ctx.client, runtime.sessionID, runtime.directory);
@@ -38219,6 +39056,9 @@ async function callBridge(ctx, runtime, command, params = {}, options) {
   if (runtime.sessionID) {
     merged.session_id = runtime.sessionID;
   }
+  if (await isWorkerRuntime(ctx, runtime)) {
+    merged[WORKER_SESSION_FIELD] = true;
+  }
   const timeoutMs = timeoutForCommand(command);
   const sendOptions = {
     ...timeoutMs !== undefined ? { timeoutMs } : {},
@@ -38245,10 +39085,12 @@ async function callToolCall(ctx, runtime, name, rawArgs = {}, options) {
     await getSessionDirectory(ctx.client, runtime.sessionID, runtime.directory);
   }
   const timeoutMs = timeoutForCommand(name);
+  const workerSession = await isWorkerRuntime(ctx, runtime);
   const sendOptions = {
     ...timeoutMs !== undefined ? { timeoutMs } : {},
     configureWarningClient: ctx.client,
     ...runtime.effectAbort ? { abortSignal: runtime.effectAbort } : {},
+    ...workerSession ? { workerSession: true } : {},
     ...options
   };
   markBridgeStart();
@@ -38367,10 +39209,10 @@ import {
   createReadStream as createReadStream2,
   existsSync as existsSync15,
   mkdirSync as mkdirSync7,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   renameSync as renameSync9,
   rmSync as rmSync5,
-  statSync as statSync10,
+  statSync as statSync11,
   writeFileSync as writeFileSync8
 } from "node:fs";
 import { join as join17 } from "node:path";
@@ -38381,10 +39223,10 @@ import {
   closeSync as closeSync6,
   mkdirSync as mkdirSync6,
   openSync as openSync6,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   renameSync as renameSync8,
   rmSync as rmSync4,
-  statSync as statSync9,
+  statSync as statSync10,
   unlinkSync as unlinkSync6,
   writeFileSync as writeFileSync7
 } from "node:fs";
@@ -38407,7 +39249,7 @@ function lspBinDir(npmPackage) {
 function isInstalled(npmPackage, binary) {
   for (const candidate of lspBinaryCandidates(binary)) {
     try {
-      if (statSync9(join15(lspBinDir(npmPackage), candidate)).isFile())
+      if (statSync10(join15(lspBinDir(npmPackage), candidate)).isFile())
         return true;
     } catch {}
   }
@@ -38435,9 +39277,9 @@ function writeInstalledMetaIn(installDir, version, sha256) {
 function readInstalledMetaIn(installDir) {
   const path = join15(installDir, INSTALLED_META_FILE);
   try {
-    if (!statSync9(path).isFile())
+    if (!statSync10(path).isFile())
       return null;
-    const raw = readFileSync10(path, "utf8");
+    const raw = readFileSync11(path, "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.version !== "string" || parsed.version.length === 0)
       return null;
@@ -38506,12 +39348,12 @@ ${token}
   let owningPid = null;
   let lockMtimeMs = 0;
   try {
-    const raw = readFileSync10(lock, "utf8");
+    const raw = readFileSync11(lock, "utf8");
     const firstLine = raw.split(/\r?\n/, 1)[0]?.trim() ?? "";
     const parsed = Number.parseInt(firstLine, 10);
     if (Number.isFinite(parsed) && parsed > 0)
       owningPid = parsed;
-    lockMtimeMs = statSync9(lock).mtimeMs;
+    lockMtimeMs = statSync10(lock).mtimeMs;
   } catch {
     return tryClaim();
   }
@@ -38545,7 +39387,7 @@ function releaseInstallLock(lockKey, acquisitionToken) {
     let owningPid = null;
     let owningToken = "";
     try {
-      const raw = readFileSync10(lock, "utf8");
+      const raw = readFileSync11(lock, "utf8");
       const lines = raw.split(/\r?\n/);
       const parsed = Number.parseInt(lines[0]?.trim() ?? "", 10);
       if (Number.isFinite(parsed) && parsed > 0)
@@ -38592,7 +39434,7 @@ function autoInstallStampPath() {
 }
 function hasRecentAutoInstallStamp(path) {
   try {
-    const parsed = JSON.parse(readFileSync10(path, "utf8"));
+    const parsed = JSON.parse(readFileSync11(path, "utf8"));
     return typeof parsed.lastRunMs === "number" && Number.isFinite(parsed.lastRunMs) && Math.abs(Date.now() - parsed.lastRunMs) < AUTO_INSTALL_WINDOW_MS;
   } catch {
     return false;
@@ -38600,7 +39442,7 @@ function hasRecentAutoInstallStamp(path) {
 }
 function readAutoInstallLockOwner(path) {
   try {
-    const parsed = JSON.parse(readFileSync10(path, "utf8"));
+    const parsed = JSON.parse(readFileSync11(path, "utf8"));
     if (typeof parsed.pid !== "number" || typeof parsed.startedMs !== "number" || typeof parsed.token !== "string") {
       return null;
     }
@@ -38613,7 +39455,7 @@ function autoInstallLockIsStale(path) {
   const owner = readAutoInstallLockOwner(path);
   let age = Number.POSITIVE_INFINITY;
   try {
-    age = Math.abs(Date.now() - statSync9(path).mtimeMs);
+    age = Math.abs(Date.now() - statSync10(path).mtimeMs);
   } catch {
     return true;
   }
@@ -38691,7 +39533,7 @@ var VERSION_CHECK_FILE = ".aft-version-check";
 function readVersionCheck(npmPackage) {
   const file = join15(lspPackageDir(npmPackage), VERSION_CHECK_FILE);
   try {
-    const raw = readFileSync10(file, "utf8");
+    const raw = readFileSync11(file, "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.last_checked === "string") {
       return {
@@ -38794,6 +39636,14 @@ var NPM_LSP_TABLE = [
     extensions: ["ts", "tsx", "js", "jsx", "mjs", "cjs", "mts", "cts"],
     rootMarkers: ["tsconfig.json", "jsconfig.json", "package.json"]
   },
+  {
+    id: "typescript-sdk",
+    npm: "typescript",
+    binary: "tsserver",
+    extensions: ["ts", "tsx", "js", "jsx", "mjs", "cjs", "mts", "cts"],
+    rootMarkers: ["tsconfig.json", "jsconfig.json", "package.json"],
+    supportedMajor: 5
+  },
   {
     id: "python",
     npm: "pyright",
@@ -38866,9 +39716,18 @@ var NPM_LSP_TABLE = [
     rootMarkers: ["biome.json", "biome.jsonc"]
   }
 ];
+function majorVersionOf(version) {
+  const match = /^v?(\d+)(?:\.|$)/.exec(version.trim());
+  return match ? Number(match[1]) : null;
+}
+function isVersionSupported(spec, version) {
+  if (spec.supportedMajor === undefined)
+    return true;
+  return majorVersionOf(version) === spec.supportedMajor;
+}
 
 // src/lsp-project-relevance.ts
-import { existsSync as existsSync14, readdirSync as readdirSync4, readFileSync as readFileSync11 } from "node:fs";
+import { existsSync as existsSync14, readdirSync as readdirSync4, readFileSync as readFileSync12 } from "node:fs";
 import { join as join16 } from "node:path";
 var MAX_WALK_DIRS = 200;
 var MAX_WALK_DEPTH = 4;
@@ -38910,7 +39769,7 @@ function hasPackageJsonDep(projectRoot, depNames) {
 }
 function readPackageJson(projectRoot) {
   try {
-    const raw = readFileSync11(join16(projectRoot, "package.json"), "utf8");
+    const raw = readFileSync12(join16(projectRoot, "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null)
       return null;
@@ -38962,10 +39821,11 @@ function extensionOf(fileName) {
 
 // src/lsp-registry-probe.ts
 var NPM_REGISTRY_BASE = "https://registry.npmjs.org";
-function pickEligibleVersion(response, graceDays, now = Date.now()) {
+function pickEligibleVersion(response, graceDays, now = Date.now(), accept = () => true) {
   const times = response.time || {};
   const cutoff = now - graceDays * 24 * 60 * 60 * 1000;
   const candidates = [];
+  let releaseCount = 0;
   for (const [version, publishedAt] of Object.entries(times)) {
     if (version === "created" || version === "modified")
       continue;
@@ -38976,6 +39836,9 @@ function pickEligibleVersion(response, graceDays, now = Date.now()) {
     const ts = Date.parse(publishedAt);
     if (Number.isNaN(ts))
       continue;
+    releaseCount += 1;
+    if (!accept(version))
+      continue;
     candidates.push({ version, publishedAt, ts });
   }
   candidates.sort((a, b) => b.ts - a.ts);
@@ -38984,10 +39847,11 @@ function pickEligibleVersion(response, graceDays, now = Date.now()) {
   return {
     version: eligible[0]?.version ?? null,
     blockedByGrace,
+    outsideSupportedRange: releaseCount > 0 && candidates.length === 0,
     eligible: eligible.map(({ version, publishedAt }) => ({ version, publishedAt }))
   };
 }
-async function probeRegistry(npmPackage, graceDays, fetchImpl = fetch) {
+async function probeRegistry(npmPackage, graceDays, fetchImpl = fetch, accept) {
   const encoded = encodeURIComponent(npmPackage).replace(/^%40/, "@");
   const url = `${NPM_REGISTRY_BASE}/${encoded}`;
   try {
@@ -39000,7 +39864,7 @@ async function probeRegistry(npmPackage, graceDays, fetchImpl = fetch) {
       return null;
     }
     const json = await res.json();
-    return pickEligibleVersion(json, graceDays);
+    return pickEligibleVersion(json, graceDays, Date.now(), accept);
   } catch (err) {
     warn2(`[lsp] registry probe failed for ${npmPackage}: ${err}`);
     return null;
@@ -39051,11 +39915,11 @@ async function resolveTargetVersion(spec, config, fetchImpl = fetch) {
   }
   const cached = readVersionCheck(spec.npm);
   const weeklyMs = config.graceDays * 24 * 60 * 60 * 1000;
-  const cachedSafe = isSafeVersion(cached?.latest_eligible ?? null);
+  const cachedSafe = isSafeVersion(cached?.latest_eligible ?? null) && isVersionSupported(spec, cached?.latest_eligible);
   if (cached && !shouldRecheckVersion(cached, weeklyMs) && cachedSafe) {
     return { version: cached.latest_eligible, pinned: false, probe: null };
   }
-  const probe = await probeRegistry(spec.npm, config.graceDays, fetchImpl);
+  const probe = await probeRegistry(spec.npm, config.graceDays, fetchImpl, (candidate) => isVersionSupported(spec, candidate));
   if (!probe) {
     return {
       version: cachedSafe ? cached?.latest_eligible ?? null : null,
@@ -39190,11 +40054,16 @@ async function ensureServerInstalled(spec, config, fetchImpl, signal) {
     const { version, probe } = await resolveTargetVersion(spec, config, fetchImpl);
     if (!version) {
       const installed = isInstalled(spec.npm, spec.binary);
-      if (installed) {
+      if (installed && installedVersionAllowed(spec, config)) {
         warn2(`[lsp] no eligible version of ${spec.npm} (grace=${config.graceDays}d); keeping existing install`);
         return { started: false, reason: "kept existing install" };
       }
-      const blocked = probe?.blockedByGrace ? `all versions are within ${config.graceDays}-day grace window` : "registry probe failed";
+      const blocked = probe?.blockedByGrace ? `all versions are within ${config.graceDays}-day grace window` : probe?.outsideSupportedRange ? `no ${spec.supportedMajor}.x release on the registry` : "registry probe failed";
+      if (installed) {
+        const reason = `cached ${spec.npm} ${readInstalledMeta(spec.npm)?.version ?? "(unknown version)"} is outside the supported ${spec.supportedMajor}.x line and no replacement is available: ${blocked}`;
+        warn2(`[lsp] ${reason}`);
+        return { started: false, reason };
+      }
       warn2(`[lsp] skipping ${spec.npm}: ${blocked}`);
       return { started: false, reason: blocked };
     }
@@ -39258,7 +40127,7 @@ function hashInstalledBinary(spec) {
     let pathToHash = null;
     for (const p of candidates) {
       try {
-        if (statSync10(p).isFile()) {
+        if (statSync11(p).isFile()) {
           pathToHash = p;
           break;
         }
@@ -39284,14 +40153,14 @@ function installedBinaryPath(spec) {
   ] : [lspBinaryPath(spec.npm, spec.binary)];
   for (const candidate of candidates) {
     try {
-      if (statSync10(candidate).isFile())
+      if (statSync11(candidate).isFile())
         return candidate;
     } catch {}
   }
   return null;
 }
 function sha256OfFileSync(path) {
-  return createHash7("sha256").update(readFileSync12(path)).digest("hex");
+  return createHash7("sha256").update(readFileSync13(path)).digest("hex");
 }
 function quarantineCachedNpmInstall(spec, reason) {
   const packageDir = lspPackageDir(spec.npm);
@@ -39319,6 +40188,15 @@ function validateCachedNpmInstall(spec) {
   }
   return true;
 }
+function installedVersionAllowed(spec, config) {
+  const installed = readInstalledMeta(spec.npm)?.version;
+  if (!installed)
+    return spec.supportedMajor === undefined;
+  return isVersionSupported(spec, installed) || config.versions[spec.npm] === installed;
+}
+function cachedInstallUsable(spec, config) {
+  return isInstalled(spec.npm, spec.binary) && validateCachedNpmInstall(spec) && installedVersionAllowed(spec, config);
+}
 function runAutoInstall(projectRoot, config, fetchImpl = fetch) {
   const cachedBinDirs = [];
   const skipped = [];
@@ -39331,10 +40209,10 @@ function runAutoInstall(projectRoot, config, fetchImpl = fetch) {
     return projectExtensions;
   };
   for (const spec of NPM_LSP_TABLE) {
-    if (isInstalled(spec.npm, spec.binary) && validateCachedNpmInstall(spec)) {
+    if (cachedInstallUsable(spec, config)) {
       cachedBinDirs.push(lspBinDir(spec.npm));
     }
-    if (config.disabled.has(spec.id)) {
+    if (config.disabled.has(spec.id) || spec.id === "typescript-sdk" && config.disabled.has("typescript")) {
       skipped.push({ id: spec.id, reason: "disabled by config" });
       continue;
     }
@@ -39371,7 +40249,7 @@ function runAutoInstall(projectRoot, config, fetchImpl = fetch) {
     },
     skipped,
     installsComplete: Promise.all(installPromises).then(() => {}),
-    getCachedBinDirs: () => NPM_LSP_TABLE.filter((spec) => isInstalled(spec.npm, spec.binary) && validateCachedNpmInstall(spec)).map((spec) => lspBinDir(spec.npm))
+    getCachedBinDirs: () => NPM_LSP_TABLE.filter((spec) => cachedInstallUsable(spec, config)).map((spec) => lspBinDir(spec.npm))
   };
 }
 async function pushLspPathsAfterAutoInstall(pool, projectRoot, cachedBinDirs) {
@@ -39390,16 +40268,16 @@ import {
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync5,
-  readFileSync as readFileSync13,
+  readFileSync as readFileSync14,
   readlinkSync as readlinkSync2,
   realpathSync as realpathSync4,
   renameSync as renameSync10,
   rmSync as rmSync6,
-  statSync as statSync11,
+  statSync as statSync12,
   unlinkSync as unlinkSync7,
   writeFileSync as writeFileSync9
 } from "node:fs";
-import { dirname as dirname8, join as join18, relative as relative3, resolve as resolve10 } from "node:path";
+import { dirname as dirname9, join as join18, relative as relative3, resolve as resolve10 } from "node:path";
 import { Readable as Readable3 } from "node:stream";
 import { pipeline as pipeline3 } from "node:stream/promises";
 
@@ -39508,7 +40386,7 @@ function installFailureMarkerPath(spec) {
 }
 function readInstallFailureMarker(spec) {
   try {
-    const marker = JSON.parse(readFileSync13(installFailureMarkerPath(spec), "utf8"));
+    const marker = JSON.parse(readFileSync14(installFailureMarkerPath(spec), "utf8"));
     if (typeof marker.release !== "string" || typeof marker.sha256 !== "string" || typeof marker.error !== "string" || typeof marker.at !== "string" || !Number.isFinite(Date.parse(marker.at))) {
       return null;
     }
@@ -39522,7 +40400,7 @@ function writeInstallFailureMarker(spec, release, sha256, installError) {
   const markerError = installError.replace(/\s+/g, " ").trim();
   const tempPath = `${path}.tmp-${process.pid}-${randomBytes4(6).toString("hex")}`;
   try {
-    mkdirSync8(dirname8(path), { recursive: true });
+    mkdirSync8(dirname9(path), { recursive: true });
     writeFileSync9(tempPath, `${JSON.stringify({ release, sha256, error: markerError, at: new Date().toISOString() })}
 `, { encoding: "utf8", mode: 384 });
     renameSync10(tempPath, path);
@@ -39551,7 +40429,7 @@ function ghBinaryPath(spec, platform) {
 function isGithubInstalled(spec, platform) {
   for (const candidate of ghBinaryCandidates(spec, platform)) {
     try {
-      if (statSync11(join18(ghBinDir(spec), candidate)).isFile())
+      if (statSync12(join18(ghBinDir(spec), candidate)).isFile())
         return true;
     } catch {}
   }
@@ -39565,9 +40443,9 @@ function ghBinaryCandidates(spec, platform) {
 function readGithubInstalledMetaIn(installDir) {
   try {
     const path = join18(installDir, INSTALLED_META_FILE2);
-    if (!statSync11(path).isFile())
+    if (!statSync12(path).isFile())
       return null;
-    const parsed = JSON.parse(readFileSync13(path, "utf8"));
+    const parsed = JSON.parse(readFileSync14(path, "utf8"));
     if (typeof parsed.version !== "string" || parsed.version.length === 0)
       return null;
     return {
@@ -39608,7 +40486,7 @@ function sha256OfFile(path) {
   });
 }
 function sha256OfFileSync2(path) {
-  return createHash8("sha256").update(readFileSync13(path)).digest("hex");
+  return createHash8("sha256").update(readFileSync14(path)).digest("hex");
 }
 async function fetchReleaseByTag(githubRepo, tag, fetchImpl, signal) {
   const candidates = [];
@@ -39784,7 +40662,7 @@ async function downloadFile(url, destPath, fetchImpl, assetSize, signal) {
     if (Number.isFinite(advertised) && advertised > MAX_DOWNLOAD_BYTES3) {
       throw new Error(`Content-Length ${advertised} exceeds max ${MAX_DOWNLOAD_BYTES3}`);
     }
-    mkdirSync8(dirname8(destPath), { recursive: true });
+    mkdirSync8(dirname9(destPath), { recursive: true });
     let bytesWritten = 0;
     const guard = new TransformStream({
       transform(chunk, controller) {
@@ -39954,7 +40832,7 @@ function quarantineCachedGithubInstall(spec, reason) {
   const dest = join18(ghCacheRoot(), ".quarantine", encodeURIComponent(spec.id), `${Date.now()}`);
   warn2(`[lsp] tofu_mismatch ${spec.id}: ${reason}; quarantining ${packageDir} -> ${dest}`);
   try {
-    mkdirSync8(dirname8(dest), { recursive: true });
+    mkdirSync8(dirname9(dest), { recursive: true });
     rmSync6(dest, { recursive: true, force: true });
     renameSync10(packageDir, dest);
   } catch (err) {
@@ -39966,7 +40844,7 @@ function validateCachedGithubInstall(spec, platform) {
   const meta = readGithubInstalledMetaIn(packageDir);
   const binaryPath = ghBinaryCandidates(spec, platform).map((candidate) => join18(ghBinDir(spec), candidate)).find((candidate) => {
     try {
-      return statSync11(candidate).isFile();
+      return statSync12(candidate).isFile();
     } catch {
       return false;
     }
@@ -40084,7 +40962,7 @@ async function downloadAndInstall(spec, tag, assets, platform, arch, fetchImpl,
     return { ok: false, sha256: archiveSha256, error: message };
   }
   const targetBinary = ghBinaryPath(spec, platform);
-  mkdirSync8(dirname8(targetBinary), { recursive: true });
+  mkdirSync8(dirname9(targetBinary), { recursive: true });
   try {
     copyFileSync3(innerBinaryPath, targetBinary);
     if (platform !== "win32") {
@@ -40613,14 +41491,16 @@ async function assertExternalDirectoryPermission(ctx, context, target, options)
   const directory = root ? normalizePath(root) : root;
   const rawWorktree = context.worktree;
   const worktree = rawWorktree && rawWorktree !== "/" ? normalizePath(rawWorktree) : rawWorktree;
+  const restrictToProjectRoot = ctx.config.restrict_to_project_root === true;
   if (directory && containsPath(directory, absoluteTarget))
     return;
-  if (worktree && worktree !== "/" && worktree !== directory && containsPath(worktree, absoluteTarget)) {
+  if (!restrictToProjectRoot && worktree && worktree !== "/" && worktree !== directory && containsPath(worktree, absoluteTarget)) {
     return;
   }
-  if (ctx.config.restrict_to_project_root === true) {
-    if (options?.serverValidatedRead === true)
+  if (restrictToProjectRoot) {
+    if (options?.serverValidatedRead === true && await isSessionOwnedBashArtifact(ctx, context, absoluteTarget)) {
       return;
+    }
     notifyRestrictBlocked(ctx, context, absoluteTarget);
     return restrictDenialMessage(absoluteTarget);
   }
@@ -40920,312 +41800,8 @@ function astTools(ctx) {
   };
 }
 
-// src/tools/conflicts.ts
-var z3 = tool.schema;
-function conflictTools(ctx) {
-  return {
-    aft_conflicts: {
-      description: "Show all git merge conflicts across the repository — returns line-numbered conflict regions with context for every conflicted file in a single call. Conflicts are discovered from the git repository's top level. By default it inspects the session's project repository; pass `path` to inspect a different repository or git worktree (e.g. where a rebase/merge is running).",
-      args: {
-        path: z3.string().describe("Optional path inside the git repository or worktree to inspect (absolute or relative to project root). Conflicts are discovered from that repository's top level. Defaults to the session project root.").optional()
-      },
-      execute: async (args, context) => {
-        const rawArgs = {};
-        if (!isEmptyParam(args?.path)) {
-          const expanded = expandTilde2(String(args.path));
-          const projectRoot = await resolveProjectRoot(ctx, context);
-          const resolved = resolvePathFromProjectRoot(projectRoot, expanded);
-          const denied = await assertExternalDirectoryPermission(ctx, context, resolved, {
-            kind: "directory"
-          });
-          if (denied)
-            return permissionDeniedResponse(denied);
-          rawArgs.path = resolved;
-        }
-        const response = await callToolCall(ctx, context, "conflicts", rawArgs);
-        if (response.success === false) {
-          throw new Error(response.message || "git_conflicts failed");
-        }
-        return response.text;
-      }
-    }
-  };
-}
-
-// src/tools/definitions/v2.ts
-import { Effect } from "effect";
-var V2_TOOL_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
-var V2_PATH_HEADER_TOOLS = new Set(["read", "write", "edit"]);
-var V2_BASH_TOOLS = new Set(["bash"]);
-var V2_SHELL_PERMISSION = "shell";
-var ROOT_COMBINATORS = ["anyOf", "oneOf", "allOf"];
-function failure(error) {
-  if (error instanceof Error)
-    return error;
-  const detail = (() => {
-    try {
-      return JSON.stringify(error) ?? String(error);
-    } catch {
-      return String(error);
-    }
-  })();
-  return new Error(`V2 tool execution rejected with a non-Error value: ${detail}`);
-}
-function isPlainObject3(value) {
-  if (typeof value !== "object" || value === null)
-    return false;
-  const prototype = Object.getPrototypeOf(value);
-  return prototype === Object.prototype || prototype === null;
-}
-function jsonSafeMetadata(value) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => entry === undefined ? null : jsonSafeMetadata(entry));
-  }
-  if (!isPlainObject3(value))
-    return value;
-  const cleaned = {};
-  for (const [key, entry] of Object.entries(value)) {
-    if (entry === undefined)
-      continue;
-    cleaned[key] = jsonSafeMetadata(entry);
-  }
-  return cleaned;
-}
-function resultContent(result) {
-  if (typeof result === "string")
-    return { content: result };
-  const attachments = (result.attachments ?? []).map((attachment) => ({
-    type: "file",
-    uri: attachment.url,
-    mime: attachment.mime,
-    ...attachment.filename ? { name: attachment.filename } : {}
-  }));
-  const content = attachments.length ? [{ type: "text", text: result.output }, ...attachments] : result.output;
-  const metadata = jsonSafeMetadata({
-    ...result.metadata ?? {},
-    ...result.title ? { title: result.title } : {}
-  });
-  return {
-    content,
-    ...Object.keys(metadata).length ? { metadata } : {}
-  };
-}
-function failureEnvelopeMessage(result) {
-  const output = typeof result === "string" ? result : result.output;
-  if (typeof output !== "string")
-    return;
-  const trimmed = output.trim();
-  if (!trimmed.startsWith("{") || !trimmed.includes('"success"'))
-    return;
-  let parsed;
-  try {
-    parsed = JSON.parse(trimmed);
-  } catch {
-    return;
-  }
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-    return;
-  const envelope = parsed;
-  if (envelope.success !== false)
-    return;
-  for (const field of [envelope.message, envelope.error, envelope.code]) {
-    if (typeof field === "string" && field.length > 0)
-      return field;
-  }
-  return "The tool call failed.";
-}
-function bareToolName3(name) {
-  return name.startsWith("aft_") ? name.slice(4) : name;
-}
-function projectArguments(name, definition) {
-  if (!V2_PATH_HEADER_TOOLS.has(bareToolName3(name)) || !("filePath" in definition.args)) {
-    return { ...definition.args };
-  }
-  const { filePath, ...rest } = definition.args;
-  return { path: filePath, ...rest };
-}
-function executionArguments(name, input) {
-  if (!V2_PATH_HEADER_TOOLS.has(bareToolName3(name)) || !("path" in input))
-    return input;
-  const { path, ...rest } = input;
-  return { filePath: path, ...rest };
-}
-function hostPermission(name) {
-  const bare = bareToolName3(name);
-  if (new Set(["read", "glob", "grep"]).has(bare))
-    return bare;
-  if (V2_BASH_TOOLS.has(name))
-    return V2_SHELL_PERMISSION;
-  if (new Set([
-    "write",
-    "edit",
-    "apply_patch",
-    "delete",
-    "move",
-    "ast_grep_replace",
-    "import",
-    "safety"
-  ]).has(bare)) {
-    return "edit";
-  }
-  return;
-}
-function assertV2Contract(name, input) {
-  if (!V2_TOOL_NAME.test(name)) {
-    throw new Error(`Invalid V2 tool name ${JSON.stringify(name)}; expected ${V2_TOOL_NAME.source}`);
-  }
-  const schema = tool.schema.toJSONSchema(input, { io: "input" });
-  if (schema.type !== "object") {
-    throw new Error(`V2 tool ${name} must have an object-rooted input schema`);
-  }
-  for (const keyword of ROOT_COMBINATORS) {
-    if (keyword in schema) {
-      throw new Error(`V2 tool ${name} input schema cannot use root ${keyword}`);
-    }
-  }
-}
-function v2PermissionRequest(name, request) {
-  if (!V2_BASH_TOOLS.has(name) || request.permission !== "bash")
-    return request;
-  return { ...request, permission: V2_SHELL_PERMISSION };
-}
-function runtimeFor(name, location, context, signal, consumers) {
-  const directory = location.directory;
-  const worktree = location.project?.canonical ?? location.project?.directory ?? directory;
-  return {
-    sessionID: context.sessionID,
-    messageID: context.messageID,
-    agent: context.agent,
-    directory,
-    worktree,
-    abort: signal,
-    effectAbort: signal,
-    metadata: (update) => {
-      Effect.runPromise(context.progress(jsonSafeMetadata({
-        ...update.metadata ?? {},
-        ...update.title ? { title: update.title } : {}
-      })));
-    },
-    ask: (asked) => {
-      const request = v2PermissionRequest(name, asked);
-      if (consumers.requestPermission)
-        return consumers.requestPermission(request, context);
-      return Promise.reject(new Error(`The "${request.permission}" operation was refused because this AFT runtime has no permission evaluator bound, so the host's permission rules for it could not be consulted.`));
-    },
-    progress: context.progress
-  };
-}
-function projectV2Tool(name, definition, location, consumers = {}) {
-  const input = tool.schema.object(projectArguments(name, definition));
-  assertV2Contract(name, input);
-  const sharedOptions = definition.options;
-  const permission = hostPermission(name);
-  return {
-    name,
-    description: definition.description,
-    input,
-    options: {
-      ...sharedOptions,
-      ...permission ? { permission } : {},
-      codemode: false
-    },
-    execute: (rawInput, context) => Effect.tryPromise({
-      try: async (signal) => {
-        const runtime = runtimeFor(name, location, context, signal, consumers);
-        const input = executionArguments(name, rawInput);
-        const result = consumers.executeBash && V2_BASH_TOOLS.has(name) ? await consumers.executeBash({
-          name,
-          input,
-          context: runtime,
-          definition
-        }) : await definition.execute(input, runtime);
-        const refusal = failureEnvelopeMessage(result);
-        if (refusal)
-          throw new Error(refusal);
-        return resultContent(result);
-      },
-      catch: failure
-    })
-  };
-}
-
-// src/tools/hoisted.ts
-import * as path4 from "node:path";
-
-// src/shared/subagent-detect.ts
-import { Effect as Effect2 } from "effect";
-var CACHE_MAX_ENTRIES2 = 200;
-var cache2 = new Map;
-async function resolveIsSubagent(client, sessionId, _fallbackDirectory) {
-  if (!sessionId) {
-    sessionLog(undefined, "[subagent-detect] no sessionId provided → primary");
-    return false;
-  }
-  const cached = cache2.get(sessionId);
-  if (cached) {
-    cache2.delete(sessionId);
-    cache2.set(sessionId, cached);
-    return cached.isSubagent;
-  }
-  if (isV2PluginContext(client))
-    return resolveV2(client, sessionId);
-  const c = client;
-  const sessionApi = c?.session;
-  if (!sessionApi || typeof sessionApi.get !== "function") {
-    sessionLog(sessionId, `[subagent-detect] client.session.get unavailable (client=${typeof client}, session=${typeof sessionApi}, get=${typeof sessionApi?.get}) → caching as primary`);
-    setCache2(sessionId, false);
-    return false;
-  }
-  sessionLog(sessionId, `[subagent-detect] cache miss, calling client.session.get(id=${sessionId})`);
-  let isSubagent = false;
-  let parentIdRaw;
-  try {
-    const result = await sessionApi.get({
-      path: { id: sessionId }
-    });
-    const session = result?.data ?? result;
-    parentIdRaw = session?.parentID;
-    isSubagent = session !== undefined && typeof session.parentID === "string" && session.parentID.length > 0;
-    sessionLog(sessionId, `[subagent-detect] SDK returned session=${session !== undefined ? "present" : "undefined"}, parentID=${JSON.stringify(parentIdRaw)} → isSubagent=${isSubagent}`);
-  } catch (err) {
-    sessionWarn(sessionId, `[subagent-detect] SDK lookup failed: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-  setCache2(sessionId, isSubagent);
-  return isSubagent;
-}
-function isV2PluginContext(client) {
-  if (!client || typeof client !== "object")
-    return false;
-  const candidate = client;
-  return typeof candidate.location?.directory === "string" && typeof candidate.session?.get === "function";
-}
-async function resolveV2(context, sessionId) {
-  let session;
-  try {
-    session = await Effect2.runPromise(context.session.get({ sessionID: sessionId }));
-  } catch (err) {
-    sessionWarn(sessionId, `[subagent-detect] OpenCode 2 session lookup failed: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-  const isSubagent = typeof session?.parentID === "string" && session.parentID.length > 0;
-  sessionLog(sessionId, `[subagent-detect] OpenCode 2 session parentID=${JSON.stringify(session?.parentID)} → isSubagent=${isSubagent}`);
-  setCache2(sessionId, isSubagent);
-  return isSubagent;
-}
-function setCache2(sessionId, isSubagent) {
-  if (cache2.has(sessionId))
-    cache2.delete(sessionId);
-  cache2.set(sessionId, { isSubagent, recordedAt: Date.now() });
-  if (cache2.size > CACHE_MAX_ENTRIES2) {
-    const oldest = cache2.keys().next().value;
-    if (oldest !== undefined)
-      cache2.delete(oldest);
-  }
-}
-
 // src/tools/bash.ts
-var z4 = tool.schema;
+var z3 = tool.schema;
 var METADATA_PREVIEW_LIMIT = 30 * 1024;
 var DEFAULT_HARD_TIMEOUT_MS = 30 * 60 * 1000;
 var BASH_TRANSPORT_MARGIN_MS = 1e4;
@@ -41241,7 +41817,9 @@ function resolveForegroundWaitMs(configured) {
   }
   return configured;
 }
-function orchestratedTransportTimeoutMs(blockToCompletion, wait, effectiveTimeout, foregroundWaitMs) {
+function orchestratedTransportTimeoutMs(blockToCompletion, wait, effectiveTimeout, foregroundWaitMs, noHardKill = false) {
+  if (noHardKill)
+    return LONGEST_TIMER_DELAY_MS;
   const waitBudget = blockToCompletion || wait ? effectiveTimeout ?? DEFAULT_HARD_TIMEOUT_MS : foregroundWaitMs;
   return waitBudget + BASH_TRANSPORT_MARGIN_MS;
 }
@@ -41318,13 +41896,38 @@ function listenForForegroundAbort(ctx, runtime, enabled) {
 function userMessageDetachDescription(detachOnUserMessage) {
   return detachOnUserMessage ? "Any new message detaches this wait. Set `bash.detach_on_user_message: false` to keep it blocking; even then, a message containing the literal `&detach` forces detachment, and the token is stripped before delivery and the rest of the message is preserved; a token-only message becomes `(requested background detach)`." : "Because `bash.detach_on_user_message` is false, a new message leaves this wait blocking; include the literal `&detach` anywhere to force detachment, and the token is stripped before delivery and the rest of the message is preserved; a token-only message becomes `(requested background detach)`.";
 }
-function backgroundWaitDescription(watchToolRegistered) {
-  return watchToolRegistered ? "then bash_watch handles only a short remaining wait (default 30s, max bash.watch_sync_max_ms, 120s by default); for anything longer end the turn and let the completion reminder wake you, or use bash({wait:true}) when the result is needed before anything else — never background a command and immediately bash_watch it (that wastes a turn for what foreground returns in one), and never loop bash_status to wait." : "the task keeps running after the call returns, a completion reminder arrives when it exits, and bash_status reports its state and output. Use bash({wait:true}) instead when the result is needed before anything else.";
+function bashCompanionRegistered(config, companion) {
+  return resolveBashConfig(config).background && toolEnabled(config, companion);
 }
-function bashToolDescription(aftSearchRegistered, compressionOn, backgroundOn, detachOnUserMessage = true, zoomEnabled = true, watchToolRegistered = true) {
-  const searchSteer = aftSearchRegistered ? `use aft_search (concepts, identifiers, regex, literals), read, aft_outline${zoomEnabled ? ", or aft_zoom" : ""} instead` : `use the grep tool, read, aft_outline${zoomEnabled ? ", or aft_zoom" : ""} instead`;
+function backgroundWaitDescription(watchToolRegistered, statusRegistered) {
+  if (watchToolRegistered) {
+    const noPolling = statusRegistered ? ", and never loop bash_status to wait" : "";
+    return `then bash_watch handles only a short remaining wait (in a main session a watch defaults to 30s, max bash.watch_sync_max_ms, 120s by default; in a delegated session a watch without a timeout waits until the command finishes); for anything longer end the turn and let the completion reminder wake you, or use bash({wait:true}) when the result is needed before anything else — never background a command and immediately bash_watch it (that wastes a turn for what foreground returns in one)${noPolling}.`;
+  }
+  return statusRegistered ? "the task keeps running after the call returns, a completion reminder arrives when it exits, and bash_status reports its state and output. Use bash({wait:true}) instead when the result is needed before anything else." : "the task keeps running after the call returns and a completion reminder arrives when it exits. Use bash({wait:true}) instead when the result is needed before anything else.";
+}
+function ptyDriveClause(statusRegistered, writeRegistered) {
+  if (statusRegistered && writeRegistered) {
+    return ', and is driven with bash_status({ outputMode: "screen" }) plus bash_write';
+  }
+  if (statusRegistered)
+    return ', and its screen is read with bash_status({ outputMode: "screen" })';
+  if (writeRegistered)
+    return ", and is driven with bash_write";
+  return "";
+}
+function bashToolDescription(aftSearchRegistered, compressionOn, backgroundOn, detachOnUserMessage = true, zoomEnabled = true, watchToolRegistered = true, surface = {}) {
+  const outline = surface.outline !== false;
+  const status = surface.status !== false;
+  const write = surface.write !== false;
+  const steerTools = [
+    aftSearchRegistered ? "aft_search (concepts, identifiers, regex, literals)" : "the grep tool",
+    "read",
+    ...outline ? ["aft_outline"] : []
+  ].join(", ");
+  const searchSteer = `use ${steerTools}${zoomEnabled ? ", or aft_zoom" : ""} instead`;
   const compression = compressionOn ? " Output is compressed by default; pass compressed: false for raw output. Piped commands run verbatim and show the pipeline's output; for AFT's test/build summary, run the runner without | head, | tail, or | grep. Pipeline-failure notes cover single top-level pipelines only; multi-statement commands (`a; b | c; d`) are not instrumented, so masked failures inside them still need explicit exit-code checks." : "";
-  const tasks = backgroundOn ? ` Commands run in the foreground and return inline; wait: true blocks until a long command finishes instead of auto-promoting; ${userMessageDetachDescription(detachOnUserMessage)} Use it when you need the result before doing anything else; keep it off otherwise so auto-promote can remind you while you work. Use background: true yourself ONLY when you have other useful work to do while it runs; ${backgroundWaitDescription(watchToolRegistered)} A \`nohup … &\` launch still holds the call if the child keeps stdout/stderr; redirect both or use background:true. pty: true runs interactive programs (REPLs, TUIs), implies background, and is driven with bash_status({ outputMode: "screen" }) plus bash_write.` : " Commands run in the foreground to completion; timeout is the hard kill cap (default 30 minutes).";
+  const tasks = backgroundOn ? ` Commands run in the foreground and return inline; wait: true blocks until a long command finishes instead of auto-promoting; ${userMessageDetachDescription(detachOnUserMessage)} Use it when you need the result before doing anything else; keep it off otherwise so auto-promote can remind you while you work. Use background: true yourself ONLY when you have other useful work to do while it runs; ${backgroundWaitDescription(watchToolRegistered, status)} A \`nohup … &\` launch still holds the call if the child keeps stdout/stderr; redirect both or use background:true. pty: true runs interactive programs (REPLs, TUIs), implies background${ptyDriveClause(status, write)}.` : " Commands run in the foreground to completion; timeout is the hard kill cap (default 30 minutes).";
   return `Execute shell commands.${compression}${tasks}
 
 DO NOT use bash for code search or code exploration. If you are about to run grep, rg, sed, awk, find, or cat through bash to locate or read code: STOP — ${searchSteer}. When a list is cut, the reply ends with \`shown N of M <unit> (<reason>) · narrow: <knobs>\`; absence of that line means the list is complete.`;
@@ -41401,30 +42004,63 @@ async function withPermissionLoop(ctx, runtime, params, bridgeCall, options) {
   }
   throw new Error("bash permission retry failed: too many rounds");
 }
+function ptyDriveParamSentence(statusRegistered, writeRegistered) {
+  const writeInput = 'its input accepts either a string OR an array like [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ] for atomic text+key sequences.';
+  if (statusRegistered && writeRegistered) {
+    return ` Inspect with bash_status({ taskId, outputMode: "screen" }) and drive interactively with bash_write — ${writeInput}`;
+  }
+  if (statusRegistered)
+    return ' Inspect with bash_status({ taskId, outputMode: "screen" }).';
+  if (writeRegistered)
+    return ` Drive interactively with bash_write — ${writeInput}`;
+  return "";
+}
+function nativeSandboxEnabled(config) {
+  return config.sandbox?.enabled === true;
+}
 function createBashTool(ctx, aftSearchRegisteredOverride) {
   const initialBashCfg = resolveBashConfig(ctx.config);
+  const statusRegistered = bashCompanionRegistered(ctx.config, "bash_status");
+  const writeRegistered = bashCompanionRegistered(ctx.config, "bash_write");
+  const taskControls = [
+    ...statusRegistered ? ["bash_status"] : [],
+    ...bashCompanionRegistered(ctx.config, "bash_kill") ? ["bash_kill"] : []
+  ];
+  const waitArg = initialBashCfg.background ? {
+    wait: z3.boolean().optional().describe(`When true, run in the foreground without auto-promoting and wait until the command finishes or reaches its timeout; ${userMessageDetachDescription(initialBashCfg.detach_on_user_message)} Use only when you know the result is required before doing anything else.`)
+  } : {};
+  const sandboxArg = nativeSandboxEnabled(ctx.config) ? {
+    sandbox: z3.literal("host").optional().describe("Request one-command approval to run unsandboxed on the host; use only when native sandboxing blocks required work, and note that it is a no-op when sandboxing is disabled.")
+  } : {};
+  const compressedArg = initialBashCfg.compress ? {
+    compressed: z3.boolean().optional().describe("When true or omitted, return compressed output with noisy terminal control sequences reduced. Set to false for raw output.")
+  } : {};
   const backgroundFlagArg = initialBashCfg.background ? {
-    background: z4.boolean().optional().describe("When true, spawn the command in the background and return a taskId for bash_status/bash_kill instead of waiting for completion. Defaults to false.")
+    background: z3.boolean().optional().describe(`When true, spawn the command in the background and return a taskId${taskControls.length > 0 ? ` for ${taskControls.join("/")}` : ""} instead of waiting for completion. Defaults to false.`)
   } : {};
   const ptyArgs = initialBashCfg.background ? {
-    pty: z4.boolean().optional().describe('When true, spawn the command in a real PTY for interactive programs (python/node/bash REPLs, vim). Implies background: true automatically. Unavailable in subagent sessions. Inspect with bash_status({ taskId, outputMode: "screen" }) and drive interactively with bash_write — its input accepts either a string OR an array like [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ] for atomic text+key sequences.'),
+    pty: z3.boolean().optional().describe(`When true, spawn the command in a real PTY for interactive programs (python/node/bash REPLs, vim). Implies background: true automatically.${initialBashCfg.subagent_background ? "" : " Unavailable in subagent sessions because bash.subagent_background is false."}${ptyDriveParamSentence(statusRegistered, writeRegistered)}`),
     ptyRows: optionalInt(1, 60).describe("PTY terminal height in rows — ignored when pty is false. Defaults to 24 when pty: true. Minimum 1, maximum 60."),
     ptyCols: optionalInt(1, 140).describe("PTY terminal width in columns — ignored when pty is false. Defaults to 80 when pty: true. Minimum 1, maximum 140.")
   } : {};
   const args = {
-    command: z4.string().describe("Shell command to execute. Supports pipes, redirection, and normal shell syntax."),
+    command: z3.string().describe("Shell command to execute. Supports pipes, redirection, and normal shell syntax."),
     timeout: optionalInt(1, Number.MAX_SAFE_INTEGER).describe(initialBashCfg.background ? "Hard kill cap in milliseconds (positive integer). In the default foreground mode when wait is false, a command that exceeds the configured wait window is promoted to background and gets a completion reminder when it exits; wait:true disables promotion and remains inline until completion or timeout." : "Hard kill cap in milliseconds (positive integer). When omitted, the foreground command can run up to 30 minutes and returns inline when it finishes."),
-    workdir: z4.string().optional().describe("Working directory for command execution. Relative paths resolve through the bridge; defaults to the current tool context/project root when omitted."),
-    description: z4.string().optional().describe("Short 5-10 word human-readable summary shown in OpenCode UI metadata instead of raw shell syntax."),
-    wait: z4.boolean().optional().describe(`When true, run in the foreground without auto-promoting and wait until the command finishes or reaches its timeout; ${userMessageDetachDescription(initialBashCfg.detach_on_user_message)} Use only when you know the result is required before doing anything else.`),
-    sandbox: z4.literal("host").optional().describe("Request one-command approval to run unsandboxed on the host; use only when native sandboxing blocks required work, and note that it is a no-op when sandboxing is disabled."),
+    workdir: z3.string().optional().describe("Working directory for command execution. Relative paths resolve through the bridge; defaults to the current tool context/project root when omitted."),
+    description: z3.string().optional().describe("Short 5-10 word human-readable summary shown in OpenCode UI metadata instead of raw shell syntax."),
+    ...waitArg,
+    ...sandboxArg,
     ...backgroundFlagArg,
-    compressed: z4.boolean().optional().describe("When true or omitted, return compressed output with noisy terminal control sequences reduced. Set to false for raw output."),
+    ...compressedArg,
     ...ptyArgs
   };
   let hostFallbackActive = false;
   return {
-    description: bashToolDescription(false, initialBashCfg.compress, initialBashCfg.background, true, toolEnabled(ctx.config, "aft_zoom")),
+    description: bashToolDescription(false, initialBashCfg.compress, initialBashCfg.background, true, toolEnabled(ctx.config, "aft_zoom"), bashCompanionRegistered(ctx.config, "bash_watch"), {
+      outline: toolEnabled(ctx.config, "aft_outline"),
+      status: statusRegistered,
+      write: writeRegistered
+    }),
     args,
     execute: async (args, context) => {
       const bashCfg = resolveBashConfig(ctx.config);
@@ -41438,7 +42074,7 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
       const cwd = args.workdir ?? context.directory;
       const isSubagent = await resolveIsSubagent(ctx.client, context.sessionID, context.directory);
       const backgroundDisabled = !bashCfg.background;
-      const requestedWait = coerceBoolean(args.wait);
+      const requestedWait = !backgroundDisabled && coerceBoolean(args.wait);
       const rawRequestedPty = coerceBoolean(args.pty);
       const rawRequestedBackground = coerceBoolean(args.background);
       if (requestedWait && rawRequestedPty) {
@@ -41449,14 +42085,15 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
       }
       const requestedPty = !backgroundDisabled && rawRequestedPty;
       const requestedBackground = !backgroundDisabled && (rawRequestedBackground || requestedPty);
-      if (requestedPty && isSubagent) {
-        throw new Error("PTY mode is not available in subagent sessions; subagents cannot drive interactive terminals.");
-      }
       const allowSubagentBg = bashCfg.subagent_background;
       const subagentForcedForeground = isSubagent && !allowSubagentBg;
+      if (requestedPty && subagentForcedForeground) {
+        throw new Error("pty:true is unavailable in this subagent session because bash.subagent_background is false; run the command without pty.");
+      }
       const blockToCompletion = subagentForcedForeground || backgroundDisabled || requestedWait;
       const effectiveBackground = blockToCompletion ? false : requestedBackground;
       const rawTimeout = coerceOptionalInt(args.timeout, "timeout", 1, Number.MAX_SAFE_INTEGER);
+      const workerUnboundedWait = isSubagent && requestedWait && rawTimeout === undefined;
       const ptyRows = coerceOptionalInt(args.ptyRows, "ptyRows", 1, 60);
       const ptyCols = coerceOptionalInt(args.ptyCols, "ptyCols", 1, 140);
       const compressed = coerceBoolean(args.compressed, true);
@@ -41487,7 +42124,7 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
           wait: requestedWait,
           sandbox: args.sandbox
         }, callBashBridge, {
-          transportTimeoutMs: orchestratedTransportTimeoutMs(blockToCompletion, requestedWait, rawTimeout, foregroundWaitMs),
+          transportTimeoutMs: orchestratedTransportTimeoutMs(blockToCompletion, requestedWait, rawTimeout, foregroundWaitMs, workerUnboundedWait),
           onProgress: ({ text }) => {
             accumulatedOutput = preview(accumulatedOutput + text);
             metadata?.({ output: accumulatedOutput, description });
@@ -41497,10 +42134,10 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
         const fallbackCause = classifyBashHostFallbackError(error);
         if (!bashCfg.host_fallback || fallbackCause === undefined)
           throw error;
-        if (rawRequestedBackground) {
+        if (!backgroundDisabled && rawRequestedBackground) {
           throw new Error(`${BASH_HOST_FALLBACK_REFUSAL}; background:true is unsupported.`);
         }
-        if (rawRequestedPty) {
+        if (requestedPty) {
           throw new Error(`${BASH_HOST_FALLBACK_REFUSAL}; pty:true is unsupported.`);
         }
         const projectRoot = projectRootFor(context);
@@ -41534,7 +42171,7 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
         trackBgTask(context.sessionID, taskId);
         let rendered = data.output ?? "";
         if (isSubagent && allowSubagentBg) {
-          rendered += subagentGuidance(taskId, bashCfg.watch_sync_max_ms);
+          rendered += workerBackgroundTaskNote(taskId);
         }
         const metadataPayload = { description, output: rendered, status: "running", taskId };
         metadata?.(metadataPayload);
@@ -41553,17 +42190,19 @@ function createBashTool(ctx, aftSearchRegisteredOverride) {
   };
 }
 function createBashStatusTool(ctx) {
+  const waitSteer = bashCompanionRegistered(ctx.config, "bash_watch") ? " To wait, use bash_watch." : "";
   return {
-    description: "Read-only snapshot of a background or PTY bash task's current state and output. Returns immediately. Never waits. One look to check on a task is fine — never loop it to wait for completion. To wait, use bash_watch.",
+    description: `Read-only snapshot of a background or PTY bash task's current state and output. Returns immediately. Never waits. One look to check on a task is fine — never loop it to wait for completion.${waitSteer}`,
     args: {
-      taskId: z4.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047a1c39ded."),
-      outputMode: z4.enum(["screen", "raw", "both"]).optional().describe("PTY output rendering mode. Defaults to screen for PTY tasks and preserves existing behavior for piped tasks when omitted.")
+      taskId: z3.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047a1c39ded."),
+      outputMode: z3.enum(["screen", "raw", "both"]).optional().describe("PTY output rendering mode. Defaults to screen for PTY tasks and preserves existing behavior for piped tasks when omitted.")
     },
     execute: async (args, context) => {
       const taskId = args.taskId;
       const outputMode = args.outputMode;
       const data = await bashStatusSnapshot(ctx, context, taskId, outputMode);
-      return await formatBashStatusText(context, taskId, data, outputMode);
+      const isSubagent = await resolveIsSubagent(ctx.client, context.sessionID, context.directory);
+      return await formatBashStatusText(context, taskId, data, outputMode, isSubagent ? "worker" : "primary");
     }
   };
 }
@@ -41571,7 +42210,7 @@ function createBashKillTool(ctx) {
   return {
     description: "Terminate a running background bash task spawned with bash({ background: true }). Returns confirmation of kill or an error if the task already finished.",
     args: {
-      taskId: z4.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047a1c39ded.")
+      taskId: z3.string().describe("Background task ID returned by bash({ background: true }), e.g. bash-6b454047a1c39ded.")
     },
     execute: async (args, context) => {
       const data = await callBashBridge(ctx, context, "bash_kill", {
@@ -41594,7 +42233,7 @@ async function bashStatusSnapshot(ctx, runtime, taskId, outputMode, options) {
   }
   return data;
 }
-async function formatBashStatusText(runtime, taskId, data, requestedOutputMode) {
+async function formatBashStatusText(runtime, taskId, data, requestedOutputMode, role) {
   const status = data.status;
   const exit = typeof data.exit_code === "number" ? ` (exit ${data.exit_code})` : "";
   const dur = typeof data.duration_ms === "number" ? ` ${Math.round(data.duration_ms / 1000)}s` : "";
@@ -41612,7 +42251,7 @@ ${preview}`;
     }
     if (status === "running") {
       text += `
-A completion reminder will be delivered automatically; don't poll.`;
+${runningTaskStatusHint(role)}`;
     }
   }
   return text;
@@ -41641,11 +42280,6 @@ PTY task is still running. Use bash_status({ taskId: "${taskId}", outputMode: "s
 function preview(output) {
   return output.length <= METADATA_PREVIEW_LIMIT ? output : output.slice(-METADATA_PREVIEW_LIMIT);
 }
-function subagentGuidance(taskId, watchSyncMaxMs) {
-  return `
-
-NOTE (subagent session): Continue with other work if you have it. If you don't, call bash_watch({ taskId: "${taskId}" }) to wait for completion before returning to the parent; without timeoutMs it waits up to ${watchSyncMaxMs} ms, the maximum. Subagents don't survive turn-end and won't receive the completion reminder.`;
-}
 function foregroundMetadata(description, data, rendered) {
   const outputPath = data.output_path;
   const truncated = typeof data.truncated === "boolean" ? data.truncated : data.output_truncated;
@@ -41666,24 +42300,355 @@ function shortenCommand(command) {
   return collapsed.length <= 80 ? collapsed : `${collapsed.slice(0, 77)}...`;
 }
 
+// src/tools/conflicts.ts
+var z4 = tool.schema;
+function conflictTools(ctx) {
+  return {
+    aft_conflicts: {
+      description: "Show all git merge conflicts across the repository — returns line-numbered conflict regions with context for every conflicted file in a single call. Conflicts are discovered from the git repository's top level. By default it inspects the session's project repository; pass `path` to inspect a different repository or git worktree (e.g. where a rebase/merge is running).",
+      args: {
+        path: z4.string().describe("Optional path inside the git repository or worktree to inspect (absolute or relative to project root). Conflicts are discovered from that repository's top level. Defaults to the session project root.").optional()
+      },
+      execute: async (args, context) => {
+        const rawArgs = {};
+        if (!isEmptyParam(args?.path)) {
+          const expanded = expandTilde2(String(args.path));
+          const projectRoot = await resolveProjectRoot(ctx, context);
+          const resolved = resolvePathFromProjectRoot(projectRoot, expanded);
+          const denied = await assertExternalDirectoryPermission(ctx, context, resolved, {
+            kind: "directory"
+          });
+          if (denied)
+            return permissionDeniedResponse(denied);
+          rawArgs.path = resolved;
+        }
+        const response = await callToolCall(ctx, context, "conflicts", rawArgs);
+        if (response.success === false) {
+          throw new Error(response.message || "git_conflicts failed");
+        }
+        return response.text;
+      }
+    }
+  };
+}
+
+// src/tools/definitions/v2.ts
+import { Effect as Effect3 } from "effect";
+var V2_TOOL_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+var V2_PATH_HEADER_TOOLS = new Set(["read", "write", "edit"]);
+var V2_BASH_TOOLS = new Set(["bash"]);
+var V2_SHELL_PERMISSION = "shell";
+var ROOT_COMBINATORS = ["anyOf", "oneOf", "allOf"];
+function failure(error) {
+  if (error instanceof Error)
+    return error;
+  const detail = (() => {
+    try {
+      return JSON.stringify(error) ?? String(error);
+    } catch {
+      return String(error);
+    }
+  })();
+  return new Error(`V2 tool execution rejected with a non-Error value: ${detail}`);
+}
+function isPlainObject3(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function jsonSafeMetadata(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => entry === undefined ? null : jsonSafeMetadata(entry));
+  }
+  if (!isPlainObject3(value))
+    return value;
+  const cleaned = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (entry === undefined)
+      continue;
+    cleaned[key] = jsonSafeMetadata(entry);
+  }
+  return cleaned;
+}
+function resultContent(result) {
+  if (typeof result === "string")
+    return { content: result };
+  const attachments = (result.attachments ?? []).map((attachment) => ({
+    type: "file",
+    uri: attachment.url,
+    mime: attachment.mime,
+    ...attachment.filename ? { name: attachment.filename } : {}
+  }));
+  const content = attachments.length ? [{ type: "text", text: result.output }, ...attachments] : result.output;
+  const metadata = jsonSafeMetadata({
+    ...result.metadata ?? {},
+    ...result.title ? { title: result.title } : {}
+  });
+  return {
+    content,
+    ...Object.keys(metadata).length ? { metadata } : {}
+  };
+}
+function failureEnvelopeMessage(result) {
+  const output = typeof result === "string" ? result : result.output;
+  if (typeof output !== "string")
+    return;
+  const trimmed = output.trim();
+  if (!trimmed.startsWith("{") || !trimmed.includes('"success"'))
+    return;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return;
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+    return;
+  const envelope = parsed;
+  if (envelope.success !== false)
+    return;
+  for (const field of [envelope.message, envelope.error, envelope.code]) {
+    if (typeof field === "string" && field.length > 0)
+      return field;
+  }
+  return "The tool call failed.";
+}
+function bareToolName3(name) {
+  return name.startsWith("aft_") ? name.slice(4) : name;
+}
+function projectArguments(name, definition) {
+  if (!V2_PATH_HEADER_TOOLS.has(bareToolName3(name)) || !("filePath" in definition.args)) {
+    return { ...definition.args };
+  }
+  const { filePath, ...rest } = definition.args;
+  return { path: filePath, ...rest };
+}
+function executionArguments(name, input) {
+  if (!V2_PATH_HEADER_TOOLS.has(bareToolName3(name)) || !("path" in input))
+    return input;
+  const { path, ...rest } = input;
+  return { filePath: path, ...rest };
+}
+function hostPermission(name) {
+  const bare = bareToolName3(name);
+  if (new Set(["read", "glob", "grep"]).has(bare))
+    return bare;
+  if (V2_BASH_TOOLS.has(name))
+    return V2_SHELL_PERMISSION;
+  if (new Set([
+    "write",
+    "edit",
+    "apply_patch",
+    "delete",
+    "move",
+    "ast_grep_replace",
+    "import",
+    "safety"
+  ]).has(bare)) {
+    return "edit";
+  }
+  return;
+}
+function assertV2Contract(name, input) {
+  if (!V2_TOOL_NAME.test(name)) {
+    throw new Error(`Invalid V2 tool name ${JSON.stringify(name)}; expected ${V2_TOOL_NAME.source}`);
+  }
+  const schema = tool.schema.toJSONSchema(input, { io: "input" });
+  if (schema.type !== "object") {
+    throw new Error(`V2 tool ${name} must have an object-rooted input schema`);
+  }
+  for (const keyword of ROOT_COMBINATORS) {
+    if (keyword in schema) {
+      throw new Error(`V2 tool ${name} input schema cannot use root ${keyword}`);
+    }
+  }
+}
+function v2PermissionRequest(name, request) {
+  if (!V2_BASH_TOOLS.has(name) || request.permission !== "bash")
+    return request;
+  return { ...request, permission: V2_SHELL_PERMISSION };
+}
+function runtimeFor(name, location, context, signal, consumers) {
+  const directory = location.directory;
+  const worktree = location.project?.canonical ?? location.project?.directory ?? directory;
+  return {
+    sessionID: context.sessionID,
+    messageID: context.messageID,
+    agent: context.agent,
+    directory,
+    directoryIsSessionRoot: true,
+    worktree,
+    abort: signal,
+    effectAbort: signal,
+    metadata: (update) => {
+      Effect3.runPromise(context.progress(jsonSafeMetadata({
+        ...update.metadata ?? {},
+        ...update.title ? { title: update.title } : {}
+      })));
+    },
+    ask: (asked) => {
+      const request = v2PermissionRequest(name, asked);
+      if (consumers.requestPermission)
+        return consumers.requestPermission(request, context);
+      return Promise.reject(new Error(`The "${request.permission}" operation was refused because this AFT runtime has no permission evaluator bound, so the host's permission rules for it could not be consulted.`));
+    },
+    progress: context.progress
+  };
+}
+function projectV2Tool(name, definition, location, consumers = {}) {
+  const input = tool.schema.object(projectArguments(name, definition));
+  assertV2Contract(name, input);
+  const sharedOptions = definition.options;
+  const permission = hostPermission(name);
+  return {
+    name,
+    description: definition.description,
+    input,
+    options: {
+      ...sharedOptions,
+      ...permission ? { permission } : {},
+      codemode: false
+    },
+    execute: (rawInput, context) => Effect3.tryPromise({
+      try: async (signal) => {
+        const runtime = runtimeFor(name, location, context, signal, consumers);
+        const input = executionArguments(name, rawInput);
+        const result = consumers.executeBash && V2_BASH_TOOLS.has(name) ? await consumers.executeBash({
+          name,
+          input,
+          context: runtime,
+          definition
+        }) : await definition.execute(input, runtime);
+        const refusal = failureEnvelopeMessage(result);
+        if (refusal)
+          throw new Error(refusal);
+        return resultContent(result);
+      },
+      catch: failure
+    })
+  };
+}
+
+// src/tools/hoisted.ts
+import { stat as stat2 } from "node:fs/promises";
+import * as path4 from "node:path";
+
+// src/hashline-tag-sources.ts
+function hashlineTagSourceSentence(bashRewritesMintTags, isRegistered = () => true) {
+  const rewrites = bashRewritesMintTags ? " (and accepted AFT `cat`/`head`/`tail` rewrites)" : "";
+  const lookAlikes = [
+    ...["aft_zoom", "aft_outline"].filter(isRegistered),
+    "grep",
+    ...isRegistered("aft_search") ? ["aft_search"] : []
+  ].map((name) => `\`${name}\``);
+  lookAlikes.push("conflict snippets");
+  return `Only \`read\`${rewrites} mint hashline tags. ${joinList(lookAlikes)} do not. After navigation, call \`read\` on every file and range the patch addresses.`;
+}
+function joinList(items) {
+  if (items.length <= 2)
+    return items.join(" and ");
+  return `${items.slice(0, -1).join(", ")}, and ${items[items.length - 1]}`;
+}
+
+// src/shared/read-vision.ts
+var VISION_HOST_TIMEOUT_MS = 1500;
+var states = new WeakMap;
+function stateFor2(client) {
+  let state = states.get(client);
+  if (!state) {
+    state = { models: new Map, history: new Map, capabilities: new Map };
+    states.set(client, state);
+  }
+  return state;
+}
+function rememberReadModel(client, sessionID, model) {
+  stateFor2(client).models.set(sessionID, model);
+}
+async function bounded(call) {
+  let timer;
+  try {
+    return await Promise.race([
+      Promise.resolve().then(call),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(undefined), VISION_HOST_TIMEOUT_MS);
+      })
+    ]);
+  } catch {
+    return;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function record3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
+}
+async function currentSessionVisionCapability(client, sessionID) {
+  if (!sessionID)
+    return;
+  const state = stateFor2(client);
+  let model = state.models.get(sessionID);
+  if (!model) {
+    let pending = state.history.get(sessionID);
+    if (!pending) {
+      pending = bounded(() => resolvePromptContext(client, sessionID)).then((context) => context?.model);
+      state.history.set(sessionID, pending);
+      pending.finally(() => state.history.delete(sessionID));
+    }
+    const historical = await pending;
+    model = state.models.get(sessionID) ?? historical;
+  }
+  if (!model)
+    return;
+  const currentModel = model;
+  const key = JSON.stringify([model.providerID, model.modelID]);
+  let capability = state.capabilities.get(key);
+  if (!capability) {
+    capability = (async () => {
+      const api = client.provider;
+      if (!api?.list)
+        return;
+      const list = api.list.bind(api);
+      const listed = record3(await bounded(list));
+      const catalog = record3(listed?.data) ?? listed;
+      const providers = catalog?.all ?? catalog?.providers;
+      if (!Array.isArray(providers))
+        return;
+      const provider = providers.map(record3).find((entry) => entry?.id === currentModel.providerID);
+      const models = provider?.models;
+      const entry = record3(Array.isArray(models) ? models.find((entry) => record3(entry)?.id === currentModel.modelID) : record3(models)?.[currentModel.modelID]);
+      const inputs = record3(entry?.modalities)?.input;
+      return Array.isArray(inputs) ? inputs.includes("image") : typeof entry?.attachment === "boolean" ? entry.attachment : undefined;
+    })();
+    state.capabilities.set(key, capability);
+    capability.then((value) => {
+      if (value === undefined)
+        state.capabilities.delete(key);
+    });
+  }
+  return capability;
+}
+
 // src/tools/bash_watch.ts
 var z5 = tool.schema;
-var BASH_WAIT_POLL_INTERVAL_MS = 100;
 var REGEX_WAIT_SCAN_WINDOW_BYTES = 64 * 1024;
 function unavailableSnapshot() {
   return { status: "unknown" };
 }
-function coerceConfiguredWatchTimeout(value, cap) {
+function coerceConfiguredWatchTimeout(value, role, cap) {
   try {
-    return coerceOptionalInt(value, "timeoutMs", 1, cap);
+    return coerceOptionalInt(value, "timeoutMs", 1, maxWatchTimeoutMs(role, cap));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
+    if (role === "worker")
+      throw error;
     throw new Error(`${message} (bash.watch_sync_max_ms)`);
   }
 }
 function createBashWatchTool(ctx) {
+  const noPolling = bashCompanionRegistered(ctx.config, "bash_status") ? " Never loop bash_status to wait." : "";
   return {
-    description: "Watch a background bash task. Sync waits are for a short remaining wait on a task (default 30s, max `bash.watch_sync_max_ms`, 120s by default); for anything longer end the turn on `bash({background:true})` and let the completion reminder wake you, or use `bash({wait:true})` when the result is needed before anything else. The user can interrupt anytime; the wait auto-converts to an async notification. Async (background:true, requires pattern) registers a non-blocking notification and returns immediately — use when you have parallel work or want to end your turn. Never loop bash_status to wait.",
+    description: `Watch a background bash task. ${WATCH_SYNC_DEFAULTS_DESCRIPTION}. In a main session sync waits are for a short remaining wait on a task; for anything longer end the turn on \`bash({background:true})\` and let the completion reminder wake you, or use \`bash({wait:true})\` when the result is needed before anything else. The user can interrupt anytime; the wait auto-converts to an async notification. Async (background:true, requires pattern) registers a non-blocking notification and returns immediately — use when you have parallel work or want to end your turn.${noPolling}`,
     args: {
       taskId: z5.string().describe("Background task ID returned by bash({ background: true })."),
       pattern: z5.union([z5.string(), z5.object({ regex: z5.string() })]).optional().describe("Substring or regex pattern. Optional in sync mode; required with background:true. Sync substring watches keep only the overlap tail needed for boundary matches; sync regex watches use a 64 KB rolling output window."),
@@ -41734,11 +42699,11 @@ A notification will fire when the pattern matches or the task exits.`;
       }
       const syncWaitCap = bashCfg.watch_sync_max_ms;
       const role = isSubagent ? "worker" : "primary";
-      const effectiveWaitMs = subagentForcedSync ? syncWaitCap : resolveWatchTimeoutMs(coerceConfiguredWatchTimeout(args.timeoutMs, syncWaitCap), role, syncWaitCap);
+      const effectiveWaitMs = subagentForcedSync ? undefined : resolveWatchTimeoutMs(coerceConfiguredWatchTimeout(args.timeoutMs, role, syncWaitCap), role, syncWaitCap);
       const data = await waitForBashStatus(ctx, context, taskId, undefined, waitFor, effectiveWaitMs);
       const waited = data.waited;
       if (waited?.reason === "user_message") {
-        const convertedText = await convertToAsyncWatchOnAbort(ctx, context, taskId, waitFor, coerceBoolean(args.once, true));
+        const convertedText = await convertToAsyncWatchOnAbort(ctx, context, taskId, waitFor, coerceBoolean(args.once, true), waited.elapsed_ms, role);
         const metadata = context.metadata;
         metadata?.({ taskId, status: data.status, waited, convertedToAsync: true });
         return convertedText;
@@ -41750,9 +42715,11 @@ A notification will fire when the pattern matches or the task exits.`;
     }
   };
 }
-async function convertToAsyncWatchOnAbort(ctx, context, taskId, waitFor, once) {
+async function convertToAsyncWatchOnAbort(ctx, context, taskId, waitFor, once, elapsedMs, role) {
+  const interrupted = `Sync watch for task ${taskId} was interrupted because you sent a message after ${elapsedMs}ms of waiting. `;
+  const reminderFallback = interruptedWatchTail(role, `The task is still running in the background. A completion reminder will be ` + `delivered automatically when the task exits.`);
   if (!waitFor) {
-    return `Sync watch for task ${taskId} was interrupted because you sent a message. ` + `The task is still running in the background. A completion reminder will be ` + `delivered automatically when the task exits; don't poll bash_status.`;
+    return interrupted + interruptedWatchTail(role, `The task is still running in the background. A completion reminder will be ` + `delivered automatically when the task exits; don't poll bash_status.`);
   }
   const notifyParams = {
     task_id: taskId,
@@ -41767,12 +42734,12 @@ async function convertToAsyncWatchOnAbort(ctx, context, taskId, waitFor, once) {
     const registered = await callBashBridge(ctx, context, "bash_notify", notifyParams);
     if (registered.success === false) {
       unmarkExplicitControl(context.sessionID, taskId);
-      return `Sync watch for task ${taskId} was interrupted because you sent a message. ` + `Auto-registering an async watch failed (${String(registered.message ?? "unknown error")}). ` + `The task is still running in the background. A completion reminder will be ` + `delivered automatically when the task exits.`;
+      return interrupted + `Auto-registering an async watch failed (${String(registered.message ?? "unknown error")}). ` + reminderFallback;
     }
-    return `Sync watch for task ${taskId} was interrupted because you sent a message. ` + `The wait has been converted to an async watch (${registered.watch_id}). ` + `A notification will fire when the pattern matches or the task exits.`;
+    return interrupted + `The wait has been converted to an async watch (${registered.watch_id}). ` + interruptedWatchTail(role, `A notification will fire when the pattern matches or the task exits.`);
   } catch (err) {
     unmarkExplicitControl(context.sessionID, taskId);
-    return `Sync watch for task ${taskId} was interrupted because you sent a message. ` + `Auto-registering an async watch failed (${err instanceof Error ? err.message : String(err)}). ` + `The task is still running in the background. A completion reminder will be ` + `delivered automatically when the task exits.`;
+    return interrupted + `Auto-registering an async watch failed (${err instanceof Error ? err.message : String(err)}). ` + reminderFallback;
   }
 }
 function formatWatchResultText(taskId, data, waited, role, syncWaitCap) {
@@ -41781,21 +42748,25 @@ function formatWatchResultText(taskId, data, waited, role, syncWaitCap) {
   const dur = typeof data.duration_ms === "number" ? ` ${Math.round(data.duration_ms / 1000)}s` : "";
   let text = `Task ${taskId}: ${status}${exit}${dur}`;
   if (waited) {
+    const waitedText = formatWatchWaited(waited.elapsed_ms, waited.limit_ms, role === "primary" ? syncWaitCap : undefined);
     if (waited.reason === "matched") {
       const stream = waited.match_stream ? ` in ${waited.match_stream}` : "";
       text += `
-Waited ${waited.elapsed_ms}ms; matched ${JSON.stringify(waited.match ?? "")}${stream} at offset ${waited.match_offset ?? 0}.`;
+${waitedText}; matched ${JSON.stringify(waited.match ?? "")}${stream} at offset ${waited.match_offset ?? 0}.`;
     } else if (waited.reason === "timeout") {
       text += `
-Waited ${waited.elapsed_ms}ms; timeout reached without match. ${watchTimeoutSteer(role, syncWaitCap)}`;
+${waitedText}; timeout reached without match. ${watchTimeoutSteer(role)}`;
     } else if (waited.reason === "unavailable") {
       text += `
-Waited ${waited.elapsed_ms}ms; the bridge was busy, so task state is unknown. Do not poll; let the task's completion notification wake the session, or use one bash_status snapshot on the next normal tool call.`;
+${waitedText}; ${watchUnavailableSteer(role)}`;
+    } else if (waited.reason === "aborted") {
+      text += `
+${waitedText}; the watch was cancelled. The task keeps running.`;
     } else {
       const stat = String(data.status ?? "unknown");
       const e = typeof data.exit_code === "number" ? `, exit ${data.exit_code}` : "";
       text += `
-Waited ${waited.elapsed_ms}ms; task exited (${stat}${e}).`;
+${waitedText}; task exited (${stat}${e}).`;
     }
   }
   const preview = data.output_preview;
@@ -41817,8 +42788,17 @@ async function bashStatusSnapshot2(ctx, runtime, taskId, outputMode, cursor, opt
   return data;
 }
 async function waitForBashStatus(ctx, runtime, taskId, outputMode, waitFor, effectiveWaitMs) {
-  const startedAt = Date.now();
-  const deadline = startedAt + effectiveWaitMs;
+  const startedAt = watchClock.now();
+  const deadline = effectiveWaitMs === undefined ? Number.POSITIVE_INFINITY : startedAt + effectiveWaitMs;
+  const elapsedMs = () => Math.round(watchClock.now() - startedAt);
+  const abortSignal = runtime.abort;
+  const pause = () => watchClock.sleep(Math.min(watchPollDelayMs(elapsedMs()), Math.max(0, deadline - watchClock.now())), abortSignal);
+  const waited = (reason, extra = {}) => ({
+    reason,
+    elapsed_ms: elapsedMs(),
+    ...effectiveWaitMs === undefined ? {} : { limit_ms: effectiveWaitMs },
+    ...extra
+  });
   let spillCursor = { output: 0, stderr: 0 };
   const scanState = {
     output: { text: "", baseOffset: 0 },
@@ -41832,29 +42812,29 @@ async function waitForBashStatus(ctx, runtime, taskId, outputMode, waitFor, effe
   markTaskWaiting(runtime.sessionID, taskId);
   let sawTerminal = false;
   let lastData;
+  let busySince;
   try {
     while (true) {
+      if (abortSignal?.aborted) {
+        return withWaited(lastData ?? unavailableSnapshot(), waited("aborted"));
+      }
       let data;
       try {
         data = await bashStatusSnapshot2(ctx, runtime, taskId, outputMode, waitFor ? spillCursor : undefined, bridgeOptions);
       } catch (err) {
         if (!isBridgeTransportTimeout(err))
           throw err;
+        busySince ??= watchClock.now();
         if (isSyncWatchAborted(runtime.sessionID)) {
-          return withWaited(lastData ?? unavailableSnapshot(), {
-            reason: "user_message",
-            elapsed_ms: Date.now() - startedAt
-          });
+          return withWaited(lastData ?? unavailableSnapshot(), waited("user_message"));
         }
-        if (Date.now() >= deadline) {
-          return withWaited(lastData ?? unavailableSnapshot(), {
-            reason: "unavailable",
-            elapsed_ms: Date.now() - startedAt
-          });
+        if (watchClock.now() >= deadline || watchClock.now() - busySince >= WATCH_UNAVAILABLE_GIVE_UP_MS) {
+          return withWaited(lastData ?? unavailableSnapshot(), waited("unavailable"));
         }
-        await sleep(Math.min(BASH_WAIT_POLL_INTERVAL_MS, Math.max(0, deadline - Date.now())));
+        await pause();
         continue;
       }
+      busySince = undefined;
       lastData = data;
       const terminal = isTerminalStatus(data.status);
       if (waitFor) {
@@ -41879,13 +42859,11 @@ async function waitForBashStatus(ctx, runtime, taskId, outputMode, waitFor, effe
                 await markBgCompletionDelivered({ ctx, directory: projectRootFor(runtime), sessionID: runtime.sessionID }, taskId);
               }
               const matchStream = data.mode === "pty" ? undefined : chunk.stream === "output" ? "stdout" : "stderr";
-              return withWaited(data, {
-                reason: "matched",
-                elapsed_ms: Date.now() - startedAt,
+              return withWaited(data, waited("matched", {
                 match: match.text,
                 match_offset: state.baseOffset + match.byteOffset,
                 match_stream: matchStream
-              });
+              }));
             }
             if (waitFor.kind === "substring") {
               const trimmed = trimWaitScanBuffer(state.text, state.baseOffset, waitFor);
@@ -41899,15 +42877,15 @@ async function waitForBashStatus(ctx, runtime, taskId, outputMode, waitFor, effe
         sawTerminal = true;
         consumeBgCompletion(runtime.sessionID, taskId);
         await markBgCompletionDelivered({ ctx, directory: projectRootFor(runtime), sessionID: runtime.sessionID }, taskId);
-        return withWaited(data, { reason: "exited", elapsed_ms: Date.now() - startedAt });
+        return withWaited(data, waited("exited"));
       }
       if (isSyncWatchAborted(runtime.sessionID)) {
-        return withWaited(data, { reason: "user_message", elapsed_ms: Date.now() - startedAt });
+        return withWaited(data, waited("user_message"));
       }
-      if (Date.now() >= deadline) {
-        return withWaited(data, { reason: "timeout", elapsed_ms: Date.now() - startedAt });
+      if (watchClock.now() >= deadline) {
+        return withWaited(data, waited("timeout"));
       }
-      await sleep(Math.min(BASH_WAIT_POLL_INTERVAL_MS, Math.max(0, deadline - Date.now())));
+      await pause();
     }
   } finally {
     if (!sawTerminal)
@@ -42017,8 +42995,9 @@ function withWaited(data, waited) {
 // src/tools/bash_write.ts
 var z6 = tool.schema;
 function createBashWriteTool(ctx) {
+  const modeCheck = bashCompanionRegistered(ctx.config, "bash_status") ? '; check bash_status reports mode: "pty" first.' : ".";
   return {
-    description: 'Write input bytes to a running PTY bash task. PTY-only; check bash_status reports mode: "pty" first. ' + 'Input is either a string (verbatim bytes) or an array mixing strings and { key: "esc" | "enter" | "up" | "ctrl-c" | ... } objects ' + 'for atomic text+key sequences such as [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ]. ' + "Named keys cover enter/return/tab/space/backspace/esc/escape, arrows, home/end/page-up/page-down/delete/insert, f1..f12, and ctrl-a..ctrl-z. " + "Maximum 1 MiB per call (post-expansion).",
+    description: `Write input bytes to a running PTY bash task. PTY-only${modeCheck} ` + 'Input is either a string (verbatim bytes) or an array mixing strings and { key: "esc" | "enter" | "up" | "ctrl-c" | ... } objects ' + 'for atomic text+key sequences such as [ "iHello", { key: "esc" }, ":wq", { key: "enter" } ]. ' + "Named keys cover enter/return/tab/space/backspace/esc/escape, arrows, home/end/page-up/page-down/delete/insert, f1..f12, and ctrl-a..ctrl-z. " + "Maximum 1 MiB per call (post-expansion).",
     args: {
       taskId: z6.string().describe("Background PTY task ID returned by bash({ pty: true, background: true })."),
       input: z6.union([
@@ -42055,47 +43034,6 @@ var ISSUE_AND_PR_READ_DESCRIPTION = "GitHub issues and pull requests can be read
 function whenGhReadEnabled(enabled, description) {
   return enabled ? description : "";
 }
-function asRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
-}
-function visionCapabilityForOpenCodeModel(model) {
-  const entry = model;
-  if (Array.isArray(entry?.modalities?.input)) {
-    return entry.modalities.input.includes("image");
-  }
-  return typeof entry?.attachment === "boolean" ? entry.attachment : undefined;
-}
-function modelFromOpenCodeProvider(provider, modelID) {
-  const models = provider.models;
-  if (Array.isArray(models)) {
-    return models.find((model) => asRecord(model)?.id === modelID);
-  }
-  return asRecord(models)?.[modelID];
-}
-async function currentSessionVisionCapability(client, sessionID) {
-  if (!sessionID)
-    return;
-  const promptContext = await resolvePromptContext(client, sessionID);
-  const currentModel = promptContext?.model;
-  if (!currentModel)
-    return;
-  const providerApi = client.provider;
-  if (typeof providerApi?.list !== "function")
-    return;
-  let listed;
-  try {
-    listed = await providerApi.list();
-  } catch {
-    return;
-  }
-  const result = asRecord(listed);
-  const catalog = asRecord(result?.data) ?? result;
-  const providers = Array.isArray(catalog?.all) ? catalog.all : Array.isArray(catalog?.providers) ? catalog.providers : [];
-  const provider = providers.map(asRecord).find((entry) => entry?.id === currentModel.providerID);
-  if (!provider)
-    return;
-  return visionCapabilityForOpenCodeModel(modelFromOpenCodeProvider(provider, currentModel.modelID));
-}
 function persistFilePathAlias(args, context) {
   if (typeof args.path === "string" && !Object.hasOwn(args, "filePath")) {
     args.filePath = args.path;
@@ -42267,7 +43205,7 @@ function inferBeforeStart(ops, from, beforeLen) {
 var z7 = tool.schema;
 var READ_DESCRIPTION = `Read file contents or list directory entries.
 
-Use either startLine/endLine OR offset/limit to read a section of a file.
+Use either startLine/endLine OR offset/limit to read a section of a file or sorted directory listing.
 
 Behavior:
 - Returns line-numbered content (e.g., "1: const x = 1")
@@ -42275,7 +43213,7 @@ Behavior:
 - Output capped at 50KB
 - Binary files are auto-detected and return a size-only message
 - Supported images (PNG, JPEG, GIF, WebP) and PDFs are returned as tool attachments; range arguments are ignored for media
-- Directories return sorted entries with trailing / for subdirectories
+- Directories return sorted entries with trailing / for subdirectories; offset is 1-based, limit defaults to and is capped at 1000 entries. Enumeration stops at 10,000 entries; partial listings carry a shown/total trailer.
 
 Examples:
   Read full file: { "path": "src/app.ts" }
@@ -42299,54 +43237,49 @@ function createReadTool(ctx) {
       description: readDescription(resolveGithubConfig(ctx.config).read),
       args: {
         filePath: z7.string().describe("Path to file or directory (absolute or relative to project root)"),
-        startLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line to start reading from"),
-        endLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line to stop reading at (inclusive)"),
-        limit: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Max lines to return (default: 2000)"),
-        offset: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line number to start reading from (use with limit). Ignored if startLine is provided")
+        startLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line or directory entry to start reading from"),
+        endLine: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line or directory entry to stop reading at (inclusive)"),
+        limit: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Max lines (default: 2000) or directory entries (default and cap: 1000) to return"),
+        offset: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("1-based line or directory entry to start reading from (use with limit). Ignored if startLine is provided")
       },
       execute: async (args, context) => {
         const file = args.path;
-        const projectRoot = await resolveProjectRoot(ctx, context);
+        const projectRoot = await measurePreStage("directory", () => resolveProjectRoot(ctx, context));
         const filePath = resolvePathFromProjectRoot(projectRoot, file);
         persistFilePathAlias(args, context);
         {
-          const denial = await assertExternalDirectoryPermission(ctx, context, filePath, {
+          const denial = await measurePreStage("permission", () => assertExternalDirectoryPermission(ctx, context, filePath, {
             serverValidatedRead: true
-          });
+          }));
           if (denial)
             return permissionDeniedResponse(denial);
         }
         try {
-          await runAsk(context.ask({
+          await measurePreStage("permission", () => runAsk(context.ask({
             permission: "read",
             patterns: [permissionPath(context, filePath)],
             always: ["*"],
             metadata: {}
-          }));
+          })));
         } catch (error) {
           const failure = classifyPermissionError(error);
           return permissionDeniedResponse(failure.kind === "rule_denied" ? permissionRuleDenial("read") : failure.message);
         }
-        const rawStartLine = coerceOptionalInt(args.startLine, "startLine", 1, Number.MAX_SAFE_INTEGER);
-        const rawEndLine = coerceOptionalInt(args.endLine, "endLine", 1, Number.MAX_SAFE_INTEGER);
-        const rawLimit = coerceOptionalInt(args.limit, "limit", 1, Number.MAX_SAFE_INTEGER);
-        const rawOffset = coerceOptionalInt(args.offset, "offset", 1, Number.MAX_SAFE_INTEGER);
-        let startLine = rawStartLine;
-        let endLine = rawEndLine;
-        if (startLine === undefined && rawOffset !== undefined) {
-          startLine = rawOffset;
-          if (rawLimit !== undefined) {
-            endLine = rawOffset + rawLimit - 1;
-          }
-        }
+        const startLine = coerceOptionalInt(args.startLine, "startLine", 1, Number.MAX_SAFE_INTEGER);
+        const endLine = coerceOptionalInt(args.endLine, "endLine", 1, Number.MAX_SAFE_INTEGER);
+        const limit = coerceOptionalInt(args.limit, "limit", 1, Number.MAX_SAFE_INTEGER);
+        const offset = coerceOptionalInt(args.offset, "offset", 1, Number.MAX_SAFE_INTEGER);
         const rawArgs = { filePath: file };
         if (startLine !== undefined)
           rawArgs.startLine = startLine;
         if (endLine !== undefined)
           rawArgs.endLine = endLine;
-        if (rawLimit !== undefined && rawOffset === undefined)
-          rawArgs.limit = rawLimit;
-        const visionCapability = await currentSessionVisionCapability(ctx.client, context.sessionID);
+        if (offset !== undefined)
+          rawArgs.offset = offset;
+        if (limit !== undefined)
+          rawArgs.limit = limit;
+        const mediaCandidate = isGithubResourcePath(file) || /\.(png|jpe?g|gif|webp|pdf)$/i.test(filePath) && await stat2(filePath).then((info) => info.isFile(), () => false);
+        const visionCapability = mediaCandidate ? await measurePreStage("capability", () => currentSessionVisionCapability(ctx.client, context.sessionID)) : undefined;
         if (visionCapability !== undefined)
           rawArgs.vision_capability = visionCapability;
         const response = await callToolCall(ctx, context, "read", rawArgs);
@@ -42400,7 +43333,7 @@ function createWriteTool(ctx, editToolName = "edit") {
     description: getWriteDescription(ctx, editToolName),
     args: {
       filePath: z7.string().describe("Path to the file to write (absolute or relative to project root)"),
-      content: z7.string().describe("The full content to write to the file")
+      content: z7.string().describe("The full content to write to the file; for issue://N / pr://N, the comment body to post")
     },
     execute: async (args, context) => {
       const argsRecord = args;
@@ -42517,7 +43450,7 @@ ${backupBehavior}
 - Symbol replace includes decorators, attributes, and doc comments in range
 - Response is a compact server-rendered summary; before/after diff details are attached as UI metadata when available.`;
 }
-var HASHLINE_EDIT_DESCRIPTION = [
+var HASHLINE_EDIT_GRAMMAR = [
   "Apply a hashline patch. Arguments are exactly `{patch}` where `patch` is a non-empty string. Server-owned preview control is outside this schema.",
   "",
   "Quick reference:",
@@ -42525,13 +43458,18 @@ var HASHLINE_EDIT_DESCRIPTION = [
   "- Same canonical path: multiple sections compose in patch order against pre-request coordinates.",
   "- Addresses: `0` (BOF), `N` (one line), `N.=M` (range; `N..=M`/`N..M` also work), `<N`/`>N` (gap before/after), `N*`/`<N*`/`>N*` (block), and `$`/`$-K` (EOF-relative). A plain `N` PUT replaces; use `<N` or `>N` to insert.",
   "- PUT text: `PUT <address>:` followed by one or more `+` body rows (`+` alone is blank). A final patch newline is allowed. PUT without `:` copies `@name` (or the anonymous register) and takes no body; names use `@` plus ASCII letters, digits, `_`, or `-`.",
-  "- CUT: `CUT <address> [@name]`. REM: bare `REM` only, removing the whole file. MV: `MV <destination>` (one whitespace-free path, optional matching quotes), once and after any line operations. `*** Begin Patch`/`*** End Patch` is an optional envelope.",
-  "- Only `read` (and accepted AFT `cat`/`head`/`tail` rewrites) mint hashline tags. `aft_zoom`, `aft_outline`, `grep`, `aft_search`, and conflict snippets do not. After navigation, call `read` on every file and range the patch addresses."
+  "- CUT: `CUT <address> [@name]`. REM: bare `REM` only, removing the whole file. MV: `MV <destination>` (one whitespace-free path, optional matching quotes), once and after any line operations. `*** Begin Patch`/`*** End Patch` is an optional envelope."
 ].join(`
 `);
+function hashlineEditDescription(config) {
+  const bashRewrites = toolEnabled(config, "bash") && resolveBashConfig(config).rewrite;
+  const tagSources = hashlineTagSourceSentence(bashRewrites, (name) => toolEnabled(config, name));
+  return `${HASHLINE_EDIT_GRAMMAR}
+- ${tagSources}`;
+}
 function createHashlineEditTool(ctx) {
   return {
-    description: HASHLINE_EDIT_DESCRIPTION,
+    description: hashlineEditDescription(ctx.config),
     args: {
       patch: z7.string().min(1).describe("Hashline patch text with one or more [path#TAG] sections and PUT/CUT/REM/MV operations")
     },
@@ -42606,8 +43544,7 @@ function createEditTool(ctx, writeToolName = "write") {
         throw new Error("'path' parameter is required");
       if (isGithubResourcePath(file)) {
         const edits = argsRecord.edits;
-        const onlyFindReplace = Array.isArray(edits) && edits.length > 0 && argsRecord.appendContent === undefined && argsRecord.symbol === undefined && argsRecord.content === undefined && edits.every((entry) => entry !== null && typeof entry === "object" && typeof entry.oldString === "string" && (entry.newString === undefined || typeof entry.newString === "string") && entry.startLine === undefined && entry.endLine === undefined && entry.content === undefined);
-        if (!onlyFindReplace) {
+        if (!isFindReplaceOnlyEdit(argsRecord)) {
           throw new Error("edit: GitHub resources support only edits[] find/replace entries with oldString and optional newString");
         }
         const rawArgs = { path: file, edits };
@@ -42790,7 +43727,7 @@ function createApplyPatchTool(ctx) {
   };
 }
 function deleteDescription(ctx) {
-  const backupText = ctx.config.backup?.enabled === false ? "Backup capture is disabled by user config, so this tool does not create undo snapshots. " : "Each file is backed up before deletion — use aft_safety undo to recover any of them. For directories, every file inside is individually backed up before the tree is removed. The deleted file's contents stay in the undo store until its retention expires. A recursive delete whose backup would copy more than 2,000 files or 100 MiB in one call is refused before anything is deleted; delete such a tree in smaller pieces, or use bash `rm -rf` when no undo is needed. ";
+  const backupText = ctx.config.backup?.enabled === false ? "Backup capture is disabled by user config, so this tool does not create undo snapshots. A directory tree containing a mount point of another filesystem is still refused. " : "Each file is backed up before deletion — use aft_safety undo to recover any of them. A recursive delete backs up the whole tree: directories (empty ones too, with their permissions), file contents, hard links (relinked by undo) and symlinks (the link itself, never its target; restored exactly, even when dangling). Sockets are deleted but undo does not restore them, and a file hard-linked to paths outside the tree comes back as an independent copy; both are reported as warnings. Refused before anything is deleted: mount points of another filesystem, named pipes, device nodes, and symlinks undo cannot recreate exactly (non-UTF-8 target, or on Windows). Paths under the system temp directory are never backed up, so only mount points are refused there. The deleted file's contents stay in the undo store until its retention expires. A recursive delete whose backup would record more than 2,000 entries (files, directories and links) or copy 100 MiB in one call is refused before anything is deleted; delete such a tree in smaller pieces, or use bash `rm -rf` when no undo is needed. ";
   return `Delete one or more files (or directories).
 
 ` + backupText + `Directory deletion requires recursive: true. Without it, passing a directory returns an error.
@@ -42894,6 +43831,12 @@ function createMoveTool(ctx) {
   };
 }
 function hoistedTools(ctx) {
+  const backgroundCompanions = resolveBashConfig(ctx.config).background ? {
+    bash_status: createBashStatusTool(ctx),
+    bash_write: createBashWriteTool(ctx),
+    bash_watch: createBashWatchTool(ctx),
+    bash_kill: createBashKillTool(ctx)
+  } : {};
   const tools = {
     read: createReadTool(ctx),
     write: createWriteTool(ctx, "edit"),
@@ -42902,10 +43845,7 @@ function hoistedTools(ctx) {
     aft_delete: createDeleteTool(ctx),
     aft_move: createMoveTool(ctx),
     bash: createBashTool(ctx),
-    bash_status: createBashStatusTool(ctx),
-    bash_write: createBashWriteTool(ctx),
-    bash_watch: createBashWatchTool(ctx),
-    bash_kill: createBashKillTool(ctx)
+    ...backgroundCompanions
   };
   return prepareToolMap(tools, { hashlineEffective: ctx.hashlineEffective });
 }
@@ -43006,7 +43946,7 @@ async function resolveAndGateScope(ctx, context, scope) {
   }
   return { scope: Array.isArray(scope) ? resolved : resolved[0] };
 }
-function asRecord2(value) {
+function asRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 }
 function asString(value) {
@@ -43014,7 +43954,7 @@ function asString(value) {
 }
 function firstRecord(...values) {
   for (const value of values) {
-    const record = asRecord2(value);
+    const record = asRecord(value);
     if (record)
       return record;
   }
@@ -43049,7 +43989,7 @@ function parseInspectPhaseEntries(value) {
   if (!Array.isArray(value))
     return [];
   return value.flatMap((candidate) => {
-    const entry = asRecord2(candidate);
+    const entry = asRecord(candidate);
     const id = asString(entry?.id);
     if (!id)
       return [];
@@ -43065,7 +44005,7 @@ function parseInspectPhaseEntries(value) {
   });
 }
 function parseInspectTerminal(payload) {
-  const response = asRecord2(payload);
+  const response = asRecord(payload);
   if (!response)
     return;
   const kind = terminalKind(response);
@@ -43080,7 +44020,7 @@ function parseInspectTerminal(payload) {
       waitStampText: kind === "FRESH" ? firstString(waitStamp?.text, waitStamp?.human_text) : undefined
     };
   }
-  const failedPhaseRecord = asRecord2(response.failed_phase);
+  const failedPhaseRecord = asRecord(response.failed_phase);
   const failedPhaseId = firstString(failedPhaseRecord?.id, response.failed_phase);
   const failedPhase = failedPhaseId ? parseInspectPhaseEntries([
     {
@@ -43301,6 +44241,9 @@ function navigationTools(ctx) {
 
 // src/tools/reading.ts
 var z11 = tool.schema;
+function isGithubPathArg(value) {
+  return typeof value === "string" && (value.startsWith("issue://") || value.startsWith("pr://"));
+}
 function buildZoomTitle(args) {
   const targets = args.targets;
   if (!isEmptyParam(targets)) {
@@ -43324,6 +44267,13 @@ function buildZoomTitle(args) {
   }
   return path || "(no target)";
 }
+function outlineFocusSteer(config) {
+  const zoomEnabled = toolEnabled(config, "aft_zoom");
+  const reader = zoomEnabled ? "aft_zoom" : "read";
+  const locate = toolEnabled(config, "aft_search") ? `aft_search + ${reader}` : reader;
+  const callgraph = zoomEnabled ? toolEnabled(config, "aft_callgraph") ? " aft_zoom with `callgraph:true` gives one-level forward calls-out; use aft_callgraph only for reverse callers or multi-level traces." : " aft_zoom with `callgraph:true` gives one-level forward calls-out." : "";
+  return `For understanding a specific feature, prefer ${locate} on named symbols; use aft_outline on a whole directory only for high-level structure mapping.${callgraph}`;
+}
 function readingTools(ctx) {
   const zoomEnabled = toolEnabled(ctx.config, "aft_zoom");
   const ghReadEnabled = resolveGithubConfig(ctx.config).read;
@@ -43331,9 +44281,9 @@ function readingTools(ctx) {
   const githubZoomDescription = whenGhReadEnabled(ghReadEnabled, "GitHub issue and pull-request discussion ordinals can be zoomed with `path: issue://…` or `path: pr://…` and `symbols`.");
   const tools = prepareToolMap({
     aft_outline: {
-      description: "Structural outline of source code, documentation files, or remote URLs. For code, returns symbols (functions, classes, types) with line ranges. For Markdown and HTML, returns heading hierarchy. Use this to explore structure before reading specific sections with " + (zoomEnabled ? "aft_zoom" : "read") + ". With `files: true`, the outline is breadth-first with directory rollups; drill in by outlining a subdirectory. Rows show language, symbol count, and line count.\n\n" + (zoomEnabled ? "For understanding a specific feature, prefer aft_search + aft_zoom on named symbols; use aft_outline on a whole directory only for high-level structure mapping. aft_zoom with `callgraph:true` gives one-level forward calls-out; use aft_callgraph only for reverse callers or multi-level traces.\n\n" : `For understanding a specific feature, prefer aft_search + read on named symbols; use aft_outline on a whole directory only for high-level structure mapping.
+      description: "Structural outline of source code, documentation files, or remote URLs. For code, returns symbols (functions, classes, types) with line ranges. For Markdown and HTML, returns heading hierarchy. Use this to explore structure before reading specific sections with " + (zoomEnabled ? "aft_zoom" : "read") + ". With `files: true`, the outline is breadth-first with directory rollups; drill in by outlining a subdirectory. Rows show language, symbol count, and line count.\n\n" + outlineFocusSteer(ctx.config) + `
 
-`) + "Pass a single `target`:\n" + `  • file path → outline that file (with signatures)
+` + "Pass a single `target`:\n" + `  • file path → outline that file (with signatures)
 ` + `  • directory path → outline source files under it
 ` + `  • URL (http:// or https://) → fetch and outline a remote HTML/Markdown document
 ` + "  • array of paths → outline multiple files in one call; with files:true, every path must be a directory" + (githubOutlineDescription ? `
@@ -43382,7 +44332,7 @@ ${githubOutlineDescription}` : "") + "\n\nWhen a list is cut, the reply ends wit
       }
     },
     aft_zoom: {
-      description: "Inspect code symbols or documentation sections. For code, returns the full source of a symbol. Pass `callgraph: true` to also include call-graph annotations (calls-out / called-by within the same file). For Markdown and HTML, returns the section content under the given heading.\n\nUse exactly ONE mode: `{ path, symbols }`, `{ url, symbols }`, or `{ targets }`. `symbols` can be a string or array (one or many lookups in the same file/URL). Use `targets` for cross-file batches: `{ path, symbol }` or an array of them." + (githubZoomDescription ? `
+      description: "Inspect code symbols or documentation sections. For code, returns the full source of a symbol. Pass `callgraph: true` to also include call-graph annotations (calls-out / called-by within the same file). For Markdown and HTML, returns the section content under the given heading.\n\nUse `{ path, symbols }` or `{ url, symbols }` for one file/URL. `symbols` can be a string or array (one or many lookups in the same file/URL). Use `targets` for cross-file batches: `{ path, symbol }` or an array of them. Sending both merges them into one batch; a lookup that fails reports its own error line." + (githubZoomDescription ? `
 
 ${githubZoomDescription}` : ""),
       args: {
@@ -43398,37 +44348,22 @@ ${githubZoomDescription}` : ""),
             path: z11.string().describe("Path to file (absolute or relative to project root)"),
             symbol: z11.string().describe("Symbol name in that file")
           }))
-        ]).optional().describe("Cross-file batch: `{ path, symbol }` or an array of them. Mutually exclusive with path/url/symbols."),
+        ]).optional().describe("Cross-file batch: `{ path, symbol }` or an array of them. May be combined with path/url + symbols; all lookups are answered in one batch."),
         contextLines: optionalInt(1, Number.MAX_SAFE_INTEGER).describe("Lines of context before/after the symbol (default: 3)"),
         callgraph: z11.boolean().optional().describe("Include call-graph annotations (calls-out / called-by within the same file). Default false; off keeps zoom output minimal.")
       },
       execute: async (args, context) => {
-        const hasTargetsProvided = (t) => {
-          if (isEmptyParam(t))
-            return false;
-          const entryEmpty = (entry) => {
-            if (!entry || typeof entry !== "object")
-              return true;
-            const fp = entry.path;
-            const sym = entry.symbol;
-            const fpEmpty = typeof fp !== "string" || fp.length === 0;
-            const symEmpty = typeof sym !== "string" || sym.length === 0;
-            return fpEmpty && symEmpty;
-          };
-          if (Array.isArray(t))
-            return !t.every(entryEmpty);
-          return !entryEmpty(t);
-        };
         const targetsInput = coerceJsonCollectionParam(args.targets, "targets");
-        const hasFilePath = !isEmptyParam(args.path);
-        const hasUrl = !isEmptyParam(args.url);
-        const hasTargets = hasTargetsProvided(targetsInput);
-        const hasSymbols = !isEmptyParam(args.symbols);
+        const targetEntries = usableZoomTargets(targetsInput);
+        const hasFilePath = !isBlankParam(args.path);
+        const hasUrl = !isBlankParam(args.url);
+        const hasTargets = targetEntries.length > 0;
+        const hasSymbols = !isBlankParam(args.symbols);
         const wantCallgraph = coerceBoolean(args.callgraph);
         const contextLines = coerceOptionalInt(args.contextLines, "contextLines", 1, Number.MAX_SAFE_INTEGER);
         const zoomTitle = buildZoomTitle({
           ...args,
-          targets: targetsInput
+          targets: hasTargets ? targetEntries : undefined
         });
         const zoomDisplay = { title: zoomTitle };
         if (hasFilePath)
@@ -43439,7 +44374,7 @@ ${githubZoomDescription}` : ""),
           zoomDisplay.symbols = typeof args.symbols === "string" ? args.symbols : JSON.stringify(args.symbols);
         }
         if (hasTargets)
-          zoomDisplay.targets = JSON.stringify(targetsInput);
+          zoomDisplay.targets = JSON.stringify(targetEntries);
         if (contextLines !== undefined)
           zoomDisplay.contextLines = contextLines;
         if (wantCallgraph)
@@ -43450,23 +44385,24 @@ ${githubZoomDescription}` : ""),
           metadata: zoomDisplay
         });
         if (hasTargets) {
-          if (hasFilePath || hasUrl || hasSymbols) {
-            throw new Error("'targets' is mutually exclusive with 'path', 'url', and 'symbols'");
+          if (hasFilePath && hasUrl) {
+            throw new Error("Provide exactly ONE of 'path' or 'url' — not both");
           }
-          const targets = Array.isArray(targetsInput) ? targetsInput : [targetsInput];
-          if (targets.length === 0) {
-            throw new Error("'targets' must be a non-empty object or array");
-          }
-          for (const [i, entry] of targets.entries()) {
-            const targetPath = entry?.path;
-            if (typeof targetPath !== "string" || targetPath.length === 0) {
+          const targets = targetEntries.map((entry, i) => {
+            if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
               throw new Error(`targets[${i}].path must be a non-empty string`);
             }
-            if (typeof entry.symbol !== "string" || entry.symbol.length === 0) {
-              throw new Error(`targets[${i}].symbol must be a non-empty string`);
-            }
-          }
-          const resolvedTargets = await Promise.all(targets.map((t) => resolvePathArg(ctx, context, t.path)));
+            const record = entry;
+            const targetPath = isBlankParam(record.path) ? record.filePath : record.path;
+            return {
+              path: typeof targetPath === "string" ? targetPath : "",
+              symbol: typeof record.symbol === "string" ? record.symbol : ""
+            };
+          });
+          const localPaths = targets.map((target) => target.path).filter((path) => path.trim().length > 0 && !isGithubPathArg(path));
+          if (hasFilePath && !isGithubPathArg(args.path))
+            localPaths.push(args.path);
+          const resolvedTargets = await Promise.all(localPaths.map((path) => resolvePathArg(ctx, context, path)));
           const permissionDenied = await assertPathExternalPermissions(ctx, context, resolvedTargets);
           if (permissionDenied)
             return permissionDeniedResponse(permissionDenied);
@@ -43476,6 +44412,12 @@ ${githubZoomDescription}` : ""),
               symbol: target.symbol
             }))
           };
+          if (hasFilePath)
+            rawArgs.filePath = args.path;
+          else if (hasUrl)
+            rawArgs.url = args.url;
+          if (hasSymbols)
+            rawArgs.symbols = args.symbols;
           if (contextLines !== undefined)
             rawArgs.contextLines = contextLines;
           if (wantCallgraph)
@@ -43492,7 +44434,7 @@ ${githubZoomDescription}` : ""),
         if (hasFilePath && hasUrl) {
           throw new Error("Provide exactly ONE of 'path' or 'url' — not both");
         }
-        const githubPath = hasFilePath && (String(args.path).startsWith("issue://") || String(args.path).startsWith("pr://")) || hasUrl && (String(args.url).startsWith("issue://") || String(args.url).startsWith("pr://"));
+        const githubPath = hasFilePath && isGithubPathArg(args.path) || hasUrl && isGithubPathArg(args.url);
         if (!hasUrl && !githubPath) {
           const file = await resolvePathArg(ctx, context, args.path);
           const permissionDenied = await assertPathExternalPermissions(ctx, context, file);
@@ -43583,7 +44525,7 @@ function safetyTools(ctx) {
 ` + "Use checkpoint before risky multi-file changes. Use undo for quick single-file rollback.",
       args: {
         op: z12.enum(["undo", "history", "checkpoint", "restore", "list"]).describe("Safety operation"),
-        path: z12.string().optional().describe("File path (required for history, optional for undo, optional for restore — restores only that file). Absolute or relative to project root"),
+        path: z12.string().optional().describe("File path (required for history, optional for undo, optional for checkpoint — snapshots only that file when files is omitted, optional for restore — restores only that file). Absolute or relative to project root"),
         name: z12.string().optional().describe("Checkpoint name (required for checkpoint, restore)"),
         files: z12.array(z12.string()).optional().describe("Specific files to include in checkpoint, or to restore from a checkpoint (optional; restore without path/files restores the whole checkpoint; explicit checkpoint files may be untracked or gitignored)")
       },
@@ -43853,7 +44795,7 @@ function hasMeaningfulProjectSearchFallback(query, pathArg, externalRoot) {
   return trimmedQuery.length > 0 && trimmedQuery !== pathArg && trimmedQuery !== externalRoot;
 }
 var GENERATION_CHANGED_DISCLOSURE = "index changed - order re-derived";
-function asRecord3(value) {
+function asRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : undefined;
 }
 function normalizeContinuityQuery(query) {
@@ -43868,14 +44810,14 @@ function continuityKey(projectRoot, query, includeTests, topK) {
   ]);
 }
 function responseGeneration(response) {
-  const envelope = asRecord3(response);
-  const structured = asRecord3(envelope?.structuredContent) ?? asRecord3(envelope?.structured_content);
-  const plan = asRecord3(envelope?.plan) ?? asRecord3(structured?.plan);
+  const envelope = asRecord2(response);
+  const structured = asRecord2(envelope?.structuredContent) ?? asRecord2(envelope?.structured_content);
+  const plan = asRecord2(envelope?.plan) ?? asRecord2(structured?.plan);
   const generation = plan?.snapshot_generation ?? envelope?.snapshot_generation;
   return typeof generation === "string" ? generation : undefined;
 }
 function surfaceSearchText(response, continuity, sessionId, key) {
-  const envelope = asRecord3(response);
+  const envelope = asRecord2(response);
   const text = typeof envelope?.text === "string" ? envelope.text : "";
   const generation = responseGeneration(response);
   if (generation === undefined)
@@ -44019,8 +44961,20 @@ function buildAftToolDefinitions(ctx, config, onUnknownDisabled) {
   const unknown = unknownDisabledTools(disabled);
   if (unknown.length > 0)
     onUnknownDisabled?.(unknown);
+  describeBashForRegisteredSurface(allTools, config);
   return allTools;
 }
+function describeBashForRegisteredSurface(allTools, config) {
+  const bash = allTools.bash;
+  if (!bash)
+    return;
+  const bashCfg = resolveBashConfig(config);
+  bash.description = bashToolDescription("aft_search" in allTools, bashCfg.compress, bashCfg.background, bashCfg.detach_on_user_message, "aft_zoom" in allTools, "bash_watch" in allTools, {
+    outline: "aft_outline" in allTools,
+    status: "bash_status" in allTools,
+    write: "bash_write" in allTools
+  });
+}
 function registerAftTools(context, location, definitions, consumers = {}) {
   const projected = Object.entries(definitions).map(([name, definition]) => projectV2Tool(name, definition, location, consumers));
   return context.tool.transform((editor) => {
@@ -44153,6 +45107,8 @@ var defaultBridgeBootstrapDependencies = {
   loadConfig: loadAftConfig,
   deliverLoadNotices: (notify) => deliverConfigLoadNotices(notify, getConfigLoadNotices()),
   configLoadErrors: getConfigLoadErrors,
+  configLoadSources: getConfigLoadSources,
+  configLoadTexts: getConfigLoadTexts,
   subcConnectionFileError,
   migrateConfigLocations: (directory) => migrateAftConfigLocations(directory, bridgeLogger).flatMap((result) => result.warnings),
   resolveBinary: resolveBinaryWithWarmup,
@@ -44194,8 +45150,12 @@ function loadBootstrapConfig(directory, notify, dependencies = defaultBridgeBoot
     const failure = parseFailure(dependencies);
     if (failure)
       return configErrorState(failure, notify);
+    const provenance = dependencies.configLoadSources ? {
+      sources: [...dependencies.configLoadSources()],
+      sourceTexts: Object.fromEntries(dependencies.configLoadTexts?.() ?? [])
+    } : {};
     dependencies.deliverLoadNotices?.(notify);
-    return { ok: true, config };
+    return { ok: true, config, ...provenance };
   } catch (err) {
     return configErrorState(err instanceof Error ? err.message : String(err), notify);
   }
@@ -44387,8 +45347,60 @@ function buildConfigErrorToolMap(config, message, client, buildToolMap = buildAf
   return failEveryToolCall(buildToolMap(ctx, config), message);
 }
 
+// src/config-live-reload.ts
+var OPENCODE_LIVE_CONFIG_KEYS = aftLiveConfigKeys((config) => resolveBashConfig(config));
+function projectTextOf(directory) {
+  const { projectConfigPath } = resolveCortexKitConfigPaths(directory);
+  return getConfigLoadTexts().get(projectConfigPath) ?? null;
+}
+function loadOpenCodeConfigForLiveReload(directory) {
+  try {
+    const config = loadAftConfig(directory);
+    const [failure] = getConfigLoadErrors();
+    if (failure) {
+      return { ok: false, message: formatConfigParseErrorMessage(failure.path, failure.message) };
+    }
+    const [invalid] = getConfigValidationErrors();
+    if (invalid) {
+      return {
+        ok: false,
+        message: `AFT config at ${invalid.path} has an invalid setting: ${invalid.message}`
+      };
+    }
+    return {
+      ok: true,
+      config,
+      sources: [...getConfigLoadSources()],
+      projectText: projectTextOf(directory),
+      texts: Object.fromEntries(getConfigLoadTexts())
+    };
+  } catch (err) {
+    return { ok: false, message: err instanceof Error ? err.message : String(err) };
+  }
+}
+function startOpenCodeLiveConfigReload(options) {
+  const { userConfigPath, projectConfigPath } = resolveCortexKitConfigPaths(options.directory);
+  return startLiveConfigReload({
+    paths: [userConfigPath, projectConfigPath],
+    load: () => loadOpenCodeConfigForLiveReload(options.directory),
+    initialSources: options.initialSources,
+    initialProjectText: options.initialSourceTexts?.[projectConfigPath] ?? null,
+    initialTexts: options.initialSourceTexts,
+    securityKeys: aftLiveSecurityKeys(OPENCODE_LIVE_CONFIG_KEYS),
+    keys: OPENCODE_LIVE_CONFIG_KEYS,
+    getConfig: options.getConfig,
+    setConfig: options.setConfig,
+    log: (message) => log2(`${message} (${options.directory})`),
+    reportError: (message) => {
+      error2(message);
+      options.notify(message);
+    },
+    watch: options.watch
+  });
+}
+
 // src/notifications.ts
-import { existsSync as existsSync18, readFileSync as readFileSync14 } from "node:fs";
+import { existsSync as existsSync18, readFileSync as readFileSync15 } from "node:fs";
 import { homedir as homedir13, platform } from "node:os";
 import { join as join20 } from "node:path";
 function isTuiMode() {
@@ -44430,7 +45442,7 @@ function readDesktopState() {
     return { serverUrl: null };
   }
   try {
-    const raw = readFileSync14(statePath, "utf-8");
+    const raw = readFileSync15(statePath, "utf-8");
     const state = JSON.parse(raw);
     let serverUrl = null;
     const serverStr = state.server;
@@ -44929,23 +45941,25 @@ import {
   existsSync as existsSync21,
   mkdirSync as mkdirSync9,
   openSync as openSync7,
-  readFileSync as readFileSync17,
+  readFileSync as readFileSync18,
   renameSync as renameSync11,
   rmSync as rmSync8,
-  statSync as statSync14,
+  statSync as statSync15,
   writeFileSync as writeFileSync12
 } from "node:fs";
-import { dirname as dirname14 } from "node:path";
+import { dirname as dirname15 } from "node:path";
 
 // src/hooks/auto-update-checker/cache.ts
-import { cpSync, existsSync as existsSync20, mkdtempSync, readFileSync as readFileSync16, rmSync as rmSync7, writeFileSync as writeFileSync11 } from "node:fs";
+import { cpSync, existsSync as existsSync20, mkdtempSync, readFileSync as readFileSync17, rmSync as rmSync7, writeFileSync as writeFileSync11 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename as basename5, dirname as dirname13, join as join23 } from "node:path";
+import { basename as basename6, dirname as dirname14, join as join23 } from "node:path";
 var import_comment_json3 = __toESM(require_src2(), 1);
 
 // src/hooks/auto-update-checker/checker.ts
-import { existsSync as existsSync19, readFileSync as readFileSync15, statSync as statSync13, writeFileSync as writeFileSync10 } from "node:fs";
-import { dirname as dirname12, isAbsolute as isAbsolute11, join as join22, resolve as resolve13 } from "node:path";
+import { existsSync as existsSync19, readFileSync as readFileSync16, statSync as statSync14, writeFileSync as writeFileSync10 } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { homedir as homedir14 } from "node:os";
+import { dirname as dirname13, isAbsolute as isAbsolute11, join as join22, resolve as resolve13 } from "node:path";
 import { fileURLToPath } from "node:url";
 var import_comment_json2 = __toESM(require_src2(), 1);
 
@@ -45036,14 +46050,14 @@ function resolvePathPluginSpec(spec, configPath) {
   }
   if (isAbsolute11(spec) || /^[A-Za-z]:[\\/]/.test(spec))
     return spec;
-  return resolve13(dirname12(configPath), spec);
+  return resolve13(dirname13(configPath), spec);
 }
 function getLocalDevPath(directory) {
   for (const configPath of getConfigPaths(directory)) {
     try {
       if (!existsSync19(configPath))
         continue;
-      const rawConfig = parseJsonConfig(readFileSync15(configPath, "utf-8"));
+      const rawConfig = parseJsonConfig(readFileSync16(configPath, "utf-8"));
       const plugins = getPluginEntries(rawConfig);
       for (const entry of plugins) {
         if (entry === PACKAGE_NAME || entry.startsWith(`${PACKAGE_NAME}@`))
@@ -45053,7 +46067,7 @@ function getLocalDevPath(directory) {
           const pkgPath = findPackageJsonUp(localPath);
           if (!pkgPath)
             continue;
-          const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync15(pkgPath, "utf-8")));
+          const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync16(pkgPath, "utf-8")));
           if (pkg.success && pkg.data.name === PACKAGE_NAME)
             return localPath;
         }
@@ -45064,18 +46078,18 @@ function getLocalDevPath(directory) {
 }
 function findPackageJsonUp(startPath) {
   try {
-    const stat = statSync13(startPath);
-    let dir = stat.isDirectory() ? startPath : dirname12(startPath);
+    const stat = statSync14(startPath);
+    let dir = stat.isDirectory() ? startPath : dirname13(startPath);
     for (let i = 0;i < 10; i++) {
       const pkgPath = join22(dir, "package.json");
       if (existsSync19(pkgPath)) {
         try {
-          const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync15(pkgPath, "utf-8")));
+          const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync16(pkgPath, "utf-8")));
           if (pkg.success && pkg.data.name === PACKAGE_NAME)
             return pkgPath;
         } catch {}
       }
-      const parent = dirname12(dir);
+      const parent = dirname13(dir);
       if (parent === dir)
         break;
       dir = parent;
@@ -45091,7 +46105,7 @@ function getLocalDevVersion(directory) {
     const pkgPath = findPackageJsonUp(localPath);
     if (!pkgPath)
       return null;
-    const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync15(pkgPath, "utf-8")));
+    const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync16(pkgPath, "utf-8")));
     return pkg.success ? pkg.data.version ?? null : null;
   } catch {
     return null;
@@ -45099,7 +46113,7 @@ function getLocalDevVersion(directory) {
 }
 function getCurrentRuntimePackageJsonPath(currentModuleUrl = import.meta.url) {
   try {
-    return findPackageJsonUp(dirname12(fileURLToPath(currentModuleUrl)));
+    return findPackageJsonUp(dirname13(fileURLToPath(currentModuleUrl)));
   } catch (err) {
     warn2(`[auto-update-checker] Failed to resolve runtime package path: ${String(err)}`);
     return null;
@@ -45110,7 +46124,7 @@ function findPluginEntry(directory) {
     try {
       if (!existsSync19(configPath))
         continue;
-      const rawConfig = parseJsonConfig(readFileSync15(configPath, "utf-8"));
+      const rawConfig = parseJsonConfig(readFileSync16(configPath, "utf-8"));
       const plugins = getPluginEntries(rawConfig);
       for (const entry of plugins) {
         if (entry === PACKAGE_NAME) {
@@ -45143,7 +46157,7 @@ function getCachedVersion(spec) {
     try {
       if (!existsSync19(packageJsonPath))
         continue;
-      const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync15(packageJsonPath, "utf-8")));
+      const pkg = PackageJsonSchema.safeParse(JSON.parse(readFileSync16(packageJsonPath, "utf-8")));
       if (pkg.success && pkg.data.version) {
         if (!spec)
           cachedPackageVersion = pkg.data.version;
@@ -45153,6 +46167,117 @@ function getCachedVersion(spec) {
   }
   return null;
 }
+var registryCache = new Map;
+function npmConfigGet(key, directory) {
+  return new Promise((resolve, reject) => {
+    execFile(process.platform === "win32" ? "npm.cmd" : "npm", ["config", "get", key], {
+      cwd: directory,
+      timeout: NPM_FETCH_TIMEOUT,
+      windowsHide: true,
+      shell: process.platform === "win32"
+    }, (error, stdout) => {
+      if (error)
+        reject(error);
+      else
+        resolve(stdout.trim());
+    });
+  });
+}
+function configuredRegistry(value) {
+  return value && value !== "undefined" && value !== "null" ? value : undefined;
+}
+async function readRegistrySettings(path, required = false) {
+  let text;
+  try {
+    text = await readFile(path, "utf8");
+  } catch (error) {
+    if (!required && error.code === "ENOENT")
+      return {};
+    throw error;
+  }
+  const settings = {};
+  for (const line of text.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith(";"))
+      continue;
+    const separator = trimmed.indexOf("=");
+    if (separator < 0)
+      continue;
+    const key = trimmed.slice(0, separator).trim();
+    if (key === "registry" || key === "@cortexkit:registry") {
+      settings[key] = configuredRegistry(trimmed.slice(separator + 1).trim());
+    }
+  }
+  return settings;
+}
+function registryEnvironment(key) {
+  const variable = `npm_config_${key}`;
+  const value = process.env[variable] ?? Object.entries(process.env).find(([name]) => name.toLowerCase() === variable)?.[1];
+  return configuredRegistry(value ?? "");
+}
+async function registryWithoutNpm(directory) {
+  let scoped = registryEnvironment("@cortexkit:registry");
+  let registry = registryEnvironment("registry");
+  const visited = new Set;
+  for (let current = directory;; current = dirname13(current)) {
+    if (scoped)
+      break;
+    const path = join22(current, ".npmrc");
+    visited.add(path);
+    const settings = await readRegistrySettings(path);
+    scoped ??= settings["@cortexkit:registry"];
+    registry ??= settings.registry;
+    if (dirname13(current) === current)
+      break;
+  }
+  const explicitUserConfig = process.env.npm_config_userconfig ?? process.env.NPM_CONFIG_USERCONFIG;
+  const home = (process.platform === "win32" ? process.env.USERPROFILE : process.env.HOME) ?? homedir14();
+  const userConfig = explicitUserConfig ?? join22(home, ".npmrc");
+  if (!scoped && !visited.has(userConfig)) {
+    const settings = await readRegistrySettings(userConfig, explicitUserConfig !== undefined);
+    scoped = settings["@cortexkit:registry"];
+    registry ??= settings.registry;
+  }
+  const selected = scoped ?? registry ?? NPM_REGISTRY_URL;
+  return selected.replace(/\$\{([^}]+)\}/g, (_match, name) => {
+    const value = process.env[name];
+    if (value === undefined)
+      throw new Error("Unresolved registry environment variable");
+    return value;
+  });
+}
+function validateRegistry(registry) {
+  const url = new URL(registry);
+  if (url.protocol !== "https:" && url.protocol !== "http:")
+    throw new Error("Unsupported registry protocol");
+  return registry;
+}
+var reportedRegistryFailures = new Set;
+function reportRegistryFailure(directory) {
+  const key = resolve13(directory);
+  if (reportedRegistryFailures.has(key))
+    return;
+  reportedRegistryFailures.add(key);
+  debug2("[auto-update-checker] Configured npm registry could not be resolved or used; skipping update check.");
+}
+function resolveRegistry(directory) {
+  const key = resolve13(directory);
+  let pending = registryCache.get(key);
+  if (!pending) {
+    pending = (async () => {
+      let registry;
+      try {
+        const scoped = configuredRegistry(await npmConfigGet("@cortexkit:registry", key));
+        registry = scoped ?? configuredRegistry(await npmConfigGet("registry", key)) ?? NPM_REGISTRY_URL;
+      } catch {
+        registry = await registryWithoutNpm(key);
+      }
+      return validateRegistry(registry);
+    })();
+    registryCache.set(key, pending);
+  }
+  return pending;
+}
 function buildRegistryUrl(registryUrl) {
   return `${registryUrl.replace(/\/+$/, "")}/${encodeURIComponent(PACKAGE_NAME).replace("%2F", "/")}`;
 }
@@ -45164,17 +46289,24 @@ async function getLatestVersion(channel = "latest", options = {}) {
   try {
     if (options.signal?.aborted)
       return null;
-    const response = await fetch(buildRegistryUrl(options.registryUrl ?? NPM_REGISTRY_URL), {
+    const registry = validateRegistry(options.registryUrl ?? await resolveRegistry(options.directory ?? process.cwd()));
+    if (controller.signal.aborted)
+      return null;
+    const response = await fetch(buildRegistryUrl(registry), {
       signal: controller.signal,
       headers: { Accept: "application/json" }
     });
-    if (!response.ok)
+    if (!response.ok) {
+      reportRegistryFailure(options.directory ?? process.cwd());
       return null;
+    }
     const data = NpmPackageEnvelopeSchema.safeParse(await response.json());
     if (!data.success)
       return null;
     return data.data["dist-tags"][channel] ?? data.data["dist-tags"].latest ?? null;
   } catch {
+    if (!controller.signal.aborted)
+      reportRegistryFailure(options.directory ?? process.cwd());
     return null;
   } finally {
     options.signal?.removeEventListener("abort", abortHandler);
@@ -45194,9 +46326,9 @@ function createAutoUpdateSnapshot(installDir, packageJsonPath, packageName) {
     cpSync(packageDir, stagedPackageDir, { recursive: true });
   return {
     packageJsonPath,
-    packageJson: existsSync20(packageJsonPath) ? readFileSync16(packageJsonPath, "utf-8") : null,
+    packageJson: existsSync20(packageJsonPath) ? readFileSync17(packageJsonPath, "utf-8") : null,
     lockfilePath,
-    lockfile: existsSync20(lockfilePath) ? readFileSync16(lockfilePath, "utf-8") : null,
+    lockfile: existsSync20(lockfilePath) ? readFileSync17(lockfilePath, "utf-8") : null,
     packageDir,
     stagedPackageDir,
     tempDir
@@ -45223,9 +46355,9 @@ function restoreAutoUpdateSnapshot(snapshot) {
 function stripPackageNameFromPath(pathValue, packageName) {
   let current = pathValue;
   for (const segment of [...packageName.split("/")].reverse()) {
-    if (basename5(current) !== segment)
+    if (basename6(current) !== segment)
       return null;
-    current = dirname13(current);
+    current = dirname14(current);
   }
   return current;
 }
@@ -45234,7 +46366,7 @@ function removeFromPackageLock(installDir, packageName) {
   if (!existsSync20(lockPath))
     return false;
   try {
-    const lock = import_comment_json3.parse(readFileSync16(lockPath, "utf-8"));
+    const lock = import_comment_json3.parse(readFileSync17(lockPath, "utf-8"));
     let modified = false;
     if (lock.packages) {
       const key = `node_modules/${packageName}`;
@@ -45260,7 +46392,7 @@ function ensureDependencyVersion(packageJsonPath, packageName, version) {
   if (!existsSync20(packageJsonPath))
     return false;
   try {
-    const raw = import_comment_json3.parse(readFileSync16(packageJsonPath, "utf-8"));
+    const raw = import_comment_json3.parse(readFileSync17(packageJsonPath, "utf-8"));
     const pkgJson = PackageJsonSchema.safeParse(raw);
     if (!pkgJson.success)
       return false;
@@ -45295,17 +46427,17 @@ function removeInstalledPackage(installDir, packageName) {
 }
 function resolveInstallContext(runtimePackageJsonPath = getCurrentRuntimePackageJsonPath()) {
   if (runtimePackageJsonPath) {
-    const packageDir = dirname13(runtimePackageJsonPath);
+    const packageDir = dirname14(runtimePackageJsonPath);
     const nodeModulesDir = stripPackageNameFromPath(packageDir, PACKAGE_NAME);
-    if (nodeModulesDir && basename5(nodeModulesDir) === "node_modules") {
-      const installDir = dirname13(nodeModulesDir);
+    if (nodeModulesDir && basename6(nodeModulesDir) === "node_modules") {
+      const installDir = dirname14(nodeModulesDir);
       const packageJsonPath = join23(installDir, "package.json");
       if (existsSync20(packageJsonPath))
         return { installDir, packageJsonPath };
     }
     return null;
   }
-  const cacheRoot = dirname13(cacheDir());
+  const cacheRoot = dirname14(cacheDir());
   const legacyPackageJsonPath = join23(cacheRoot, "package.json");
   if (existsSync20(legacyPackageJsonPath)) {
     return { installDir: cacheRoot, packageJsonPath: legacyPackageJsonPath };
@@ -45508,7 +46640,7 @@ function claimCheckSlot(storageDir, intervalMs) {
   try {
     if (hasRecentCheckTimestamp(file, intervalMs))
       return null;
-    mkdirSync9(dirname14(file), { recursive: true });
+    mkdirSync9(dirname15(file), { recursive: true });
     const lockPath = `${file}.lock`;
     const owner = { pid: process.pid, startedMs: Date.now() };
     let lockFd = null;
@@ -45579,9 +46711,9 @@ function isOrphanedCheckLock(lockPath) {
   }
 }
 function readCheckLockState(lockPath) {
-  const fallbackStartedMs = statSync14(lockPath).mtimeMs;
+  const fallbackStartedMs = statSync15(lockPath).mtimeMs;
   try {
-    const parsed = JSON.parse(readFileSync17(lockPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync18(lockPath, "utf-8"));
     const pid = Number.isSafeInteger(parsed.pid) && (parsed.pid ?? 0) > 0 ? parsed.pid ?? null : null;
     const startedMs = typeof parsed.startedMs === "number" && Number.isFinite(parsed.startedMs) ? parsed.startedMs : fallbackStartedMs;
     return { pid, startedMs };
@@ -45591,7 +46723,7 @@ function readCheckLockState(lockPath) {
 }
 function checkLockIsOwnedBy(lockPath, owner) {
   try {
-    const parsed = JSON.parse(readFileSync17(lockPath, "utf-8"));
+    const parsed = JSON.parse(readFileSync18(lockPath, "utf-8"));
     return parsed.pid === owner.pid && parsed.startedMs === owner.startedMs;
   } catch {
     return false;
@@ -45601,7 +46733,7 @@ function hasRecentCheckTimestamp(file, intervalMs) {
   if (!existsSync21(file))
     return false;
   try {
-    const raw = JSON.parse(readFileSync17(file, "utf-8"));
+    const raw = JSON.parse(readFileSync18(file, "utf-8"));
     const last = typeof raw.lastCheckedMs === "number" ? raw.lastCheckedMs : 0;
     return Number.isFinite(last) && Date.now() - last < intervalMs;
   } catch {
@@ -45657,6 +46789,7 @@ async function runBackgroundUpdateCheck(ctx, options) {
   const channel = extractChannel(pluginInfo.pinnedVersion ?? currentVersion);
   const latestVersion = await getLatestVersion(channel, {
     registryUrl: options.npmRegistryUrl,
+    directory: ctx.directory,
     timeoutMs: options.fetchTimeoutMs,
     signal: options.signal
   });
@@ -45797,13 +46930,13 @@ import {
   existsSync as existsSync22,
   mkdirSync as mkdirSync10,
   readdirSync as readdirSync6,
-  readFileSync as readFileSync18,
+  readFileSync as readFileSync19,
   renameSync as renameSync12,
   unlinkSync as unlinkSync8,
   writeFileSync as writeFileSync13
 } from "node:fs";
 import { createServer } from "node:http";
-import { dirname as dirname15, join as join25 } from "node:path";
+import { dirname as dirname16, join as join25 } from "node:path";
 
 // src/shared/rpc-utils.ts
 import { join as join24 } from "node:path";
@@ -45953,7 +47086,7 @@ class AftRpcServer {
     }
   }
   writePortFile() {
-    const dir = dirname15(this.portFilePath);
+    const dir = dirname16(this.portFilePath);
     mkdirSync10(dir, { recursive: true, mode: 448 });
     const tmpPath = `${this.portFilePath}.tmp`;
     writeFileSync13(tmpPath, JSON.stringify({
@@ -45978,7 +47111,7 @@ class AftRpcServer {
       if (filePath === this.portFilePath)
         continue;
       try {
-        const record = parseRpcPortRecord(readFileSync18(filePath, "utf-8"));
+        const record = parseRpcPortRecord(readFileSync19(filePath, "utf-8"));
         if (record === null) {
           unlinkSync8(filePath);
           continue;
@@ -46193,7 +47326,7 @@ function formatSemanticIndexLabel(semantic) {
     backendUrl: semantic.backend_url
   });
 }
-function asRecord4(value) {
+function asRecord3(value) {
   return typeof value === "object" && value !== null ? value : {};
 }
 function readString(value, fallback = "") {
@@ -46212,7 +47345,7 @@ function readOptionalNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 function readCompressionAggregate(value) {
-  const aggregate = asRecord4(value);
+  const aggregate = asRecord3(value);
   return {
     events: readNumber(aggregate.events),
     original_tokens: readNumber(aggregate.original_tokens),
@@ -46223,7 +47356,7 @@ function readCompressionAggregate(value) {
 function readCompression(value) {
   if (typeof value !== "object" || value === null)
     return;
-  const compression = asRecord4(value);
+  const compression = asRecord3(value);
   return {
     project: readCompressionAggregate(compression.project),
     session: readCompressionAggregate(compression.session)
@@ -46232,7 +47365,7 @@ function readCompression(value) {
 function readStatusBar(value) {
   if (typeof value !== "object" || value === null)
     return;
-  const bar = asRecord4(value);
+  const bar = asRecord3(value);
   const errors = readOptionalNumber(bar.errors);
   const warnings = readOptionalNumber(bar.warnings);
   const deadCode = readOptionalNumber(bar.dead_code);
@@ -46290,17 +47423,17 @@ function formatBytes(bytes) {
   return `${value.toFixed(decimals)} ${units[unitIndex]}`;
 }
 function coerceAftStatus(response) {
-  const features = asRecord4(response.features);
-  const searchIndex = asRecord4(response.search_index);
-  const semanticIndex = asRecord4(response.semantic_index);
+  const features = asRecord3(response.features);
+  const searchIndex = asRecord3(response.search_index);
+  const semanticIndex = asRecord3(response.semantic_index);
   const semanticConfig = {
-    ...asRecord4(response.semantic),
-    ...asRecord4(response.semantic_config)
+    ...asRecord3(response.semantic),
+    ...asRecord3(response.semantic_config)
   };
-  const disk = asRecord4(response.disk);
-  const symbolCache = asRecord4(response.symbol_cache);
-  const runtime = asRecord4(response.runtime);
-  const session = asRecord4(response.session);
+  const disk = asRecord3(response.disk);
+  const symbolCache = asRecord3(response.symbol_cache);
+  const runtime = asRecord3(response.runtime);
+  const session = asRecord3(response.session);
   return {
     version: readString(response.version, "unknown"),
     project_root: readNullableString(response.project_root),
@@ -46552,7 +47685,10 @@ function registerShutdownCleanup(fn) {
 
 // src/workflow-hints.ts
 var HEADING = "## IMPORTANT NOTICE about your tools";
-var HASHLINE_TAG_SOURCE_HINT = "**Hashline edit tags**: Only `read` (and accepted AFT `cat`/`head`/`tail` rewrites) mint hashline tags. `aft_zoom`, `aft_outline`, `grep`, `aft_search`, and conflict snippets do not. After navigation, call `read` on every file and range the patch addresses.";
+function hashlineTagSourceHint(bashRewritesMintTags, isRegistered = () => true) {
+  return `**Hashline edit tags**: ${hashlineTagSourceSentence(bashRewritesMintTags, isRegistered)}`;
+}
+var HASHLINE_TAG_SOURCE_HINT = hashlineTagSourceHint(true);
 function buildWorkflowHints(opts) {
   const sections = [];
   const grepName = "grep";
@@ -46569,6 +47705,8 @@ function buildWorkflowHints(opts) {
   const hasInspect = !opts.disabledTools.has("aft_inspect");
   const hasBash = !opts.disabledTools.has(bashName);
   const hasBgBash = hasBash && opts.bashBackgroundEnabled && !opts.disabledTools.has(bashStatusName);
+  const hasWatch = !opts.disabledTools.has("bash_watch");
+  const hasWrite = !opts.disabledTools.has(bashWriteName);
   if (hasBash && opts.bashCompressionEnabled) {
     sections.push([
       "**Test/build output**: bash output is auto-compressed for non-piped commands. Piped commands run verbatim and show the pipeline's output. For AFT's test/build summary, run the runner without filters:",
@@ -46610,17 +47748,19 @@ function buildWorkflowHints(opts) {
     ].join(`
 `));
   }
-  if (hasBash && hasBgBash) {
+  if (hasBgBash && hasWatch) {
     sections.push([
       `**Long-running commands** (builds, installs, full test suites): run them in the FOREGROUND — use \`${bashName}({ command, wait: true })\` when you know it is long and need the result before anything else; if you send a new message, the wait detaches to background; otherwise omit \`wait\` so auto-promote can hand you a reminder while you work.`,
       "- `background: true` is ONLY for when you have OTHER useful work to do while it runs: start it, do the other work, and the completion reminder delivers the result (or spawn a subagent for the side work). Do NOT background a command and then immediately `bash_watch` it — that spends a whole extra turn waiting for something foreground returns in one.",
       "- `bash_watch` is for blocking on an ALREADY-backgrounded task once you've run out of parallel work (sync — the user can interrupt), or reacting to a specific early output line (async: background:true + pattern). Never loop `bash_status` to wait — it's a one-shot inspector."
     ].join(`
 `));
+  }
+  if (hasBgBash && hasWrite) {
     sections.push(`**PTY / interactive commands**: PTY mode is for interactive REPLs and terminal apps (python, node, bash itself, vim). Start with \`${bashName}({ command: "python", pty: true, background: true })\`, read the screen with \`${bashStatusName}({ taskId, outputMode: "screen" })\`, and send input with \`${bashWriteName}({ taskId, input: "..." })\`.`);
   }
   if (opts.hashlineEffective === true) {
-    sections.push(HASHLINE_TAG_SOURCE_HINT);
+    sections.push(hashlineTagSourceHint(hasBash && opts.bashRewriteEnabled !== false, (name) => !opts.disabledTools.has(name)));
   }
   if (sections.length === 0) {
     return null;
@@ -46635,13 +47775,32 @@ ${sections.join(`
 `)}`;
 }
 function buildHintsFromConfig(config, disabledTools, hashlineEffective = false) {
+  const bashCfg = resolveBashConfig(config);
   return buildWorkflowHints({
-    bashBackgroundEnabled: resolveBashConfig(config).background,
-    bashCompressionEnabled: resolveBashConfig(config).compress,
+    bashBackgroundEnabled: bashCfg.background,
+    bashCompressionEnabled: bashCfg.compress,
+    bashRewriteEnabled: bashCfg.rewrite,
     disabledTools,
     hashlineEffective
   });
 }
+var WORKFLOW_HINT_TOOL_NAMES = [
+  "aft_outline",
+  "aft_zoom",
+  "aft_search",
+  "aft_callgraph",
+  "aft_inspect",
+  "grep",
+  "read",
+  "bash",
+  "bash_status",
+  "bash_watch",
+  "bash_write"
+];
+function buildHintsForRegisteredTools(config, registeredTools, hashlineEffective = false) {
+  const absent = new Set(WORKFLOW_HINT_TOOL_NAMES.filter((name) => !registeredTools.has(name)));
+  return buildHintsFromConfig(config, absent, hashlineEffective);
+}
 function appendHintsToSystem(system, hintsBlock) {
   if (!hintsBlock)
     return;
@@ -46841,6 +48000,16 @@ async function initializePluginForDirectory(input) {
     storageDir: configOverrides.storage_dir,
     isProjectEnabled
   };
+  const liveConfigReload = startOpenCodeLiveConfigReload({
+    directory: registrationRoot,
+    initialSources: bootstrap.sources ?? [],
+    initialSourceTexts: bootstrap.sourceTexts,
+    getConfig: () => ctx.config,
+    setConfig: (config) => {
+      ctx.config = config;
+    },
+    notify: (message) => deliverConfigMigrationWarnings(registrationRoot, [message])
+  });
   const statusSubscribedBridges = new WeakSet;
   const statusUnsubscribes = new Set;
   const subscribeBridgeStatus = (bridge) => {
@@ -46878,6 +48047,7 @@ async function initializePluginForDirectory(input) {
   let clearInspectTier2Idle = () => {};
   const shutdownCleanup = registerShutdownCleanup(async (reason) => {
     autoUpdateAbort.abort();
+    liveConfigReload.stop();
     clearInspectTier2Idle();
     for (const unsubscribe of statusUnsubscribes) {
       try {
@@ -47001,42 +48171,19 @@ Install: ${getManualInstallHint()}`);
     signal: autoUpdateAbort.signal,
     storageDir: ctx.storageDir
   });
-  const HINTS_TOOL_NAMES = [
-    "aft_outline",
-    "aft_zoom",
-    "aft_search",
-    "aft_callgraph",
-    "aft_inspect",
-    "grep",
-    "read",
-    "bash",
-    "bash_status"
-  ];
   const registeredTools = new Set(Object.keys(allTools));
   const { hashlineEditRegistered, aftSearchRegistered } = applyToolSurfaceOverrides(pool, aftConfig, registeredTools);
   ctx.hashlineEffective = hashlineEditRegistered;
   const hashlineDowngrade = reportHashlineDowngrade(aftConfig, registeredTools, (message) => deliverConfigMigrationWarnings(registrationRoot, [message]));
   log2(`hashline activation decision requested=${aftConfig.edit_mode === "hashline"} ` + `edit_slot_survives=${hashlineEditRegistered} effective=${ctx.hashlineEffective}` + (hashlineDowngrade ? ` downgraded=${hashlineDowngrade.code}` : ""));
   ctx.aftSearchRegistered = aftSearchRegistered;
-  for (const name of ["bash"]) {
-    const def = allTools[name];
-    if (def) {
-      const bashCfg = resolveBashConfig(aftConfig);
-      def.description = bashToolDescription(aftSearchRegistered, bashCfg.compress, bashCfg.background, bashCfg.detach_on_user_message);
-    }
-  }
-  const hintsAbsentTools = new Set;
-  for (const name of HINTS_TOOL_NAMES) {
-    if (!registeredTools.has(name))
-      hintsAbsentTools.add(name);
-  }
-  const hintsBlock = buildHintsFromConfig(aftConfig, hintsAbsentTools, hashlineEditRegistered);
+  const hintsBlock = buildHintsForRegisteredTools(aftConfig, registeredTools, hashlineEditRegistered);
   if (hintsBlock) {
     log2(`Workflow hints injected (${hintsBlock.length} chars)`);
   }
   const inspectTier2Idle = createInspectTier2IdleScheduler({
     isEnabled: () => registeredTools.has("aft_inspect"),
-    idleMinutes: () => aftConfig.inspect?.tier2_idle_minutes,
+    idleMinutes: () => ctx.config.inspect?.tier2_idle_minutes,
     warn: warn2,
     run: async (sessionID) => {
       const sessionDir = await getSessionDirectory(input.client, sessionID, input.directory) ?? input.directory;
@@ -47094,11 +48241,17 @@ Install: ${getManualInstallHint()}`);
           storageDir: configOverrides.storage_dir,
           pluginVersion: PLUGIN_VERSION,
           serverUrl: input.serverUrl?.toString(),
-          delivery: aftConfig.configure_warnings_delivery ?? "toast"
+          delivery: ctx.config.configure_warnings_delivery ?? "toast"
         });
       }
       await flushConfigureWarningsOnIdle(sessionID);
     },
+    "chat.params": async (params) => {
+      rememberReadModel(input.client, params.sessionID, {
+        providerID: params.model.providerID,
+        modelID: params.model.id
+      });
+    },
     "chat.message": async (messageInput, messageOutput) => {
       const sid = messageInput.sessionID ?? messageInput.sessionId ?? messageInput.id;
       warmSessionDirectory(input.client, sid, input.directory);