@buildautomaton/cli 0.1.80 → 0.1.82

package/dist/cli.js

@@ -973,8 +973,8 @@ var require_command = __commonJS({
   "../../node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/command.js"(exports) {
     var EventEmitter2 = __require("node:events").EventEmitter;
     var childProcess2 = __require("node:child_process");
-    var path86 = __require("node:path");
-    var fs65 = __require("node:fs");
+    var path88 = __require("node:path");
+    var fs67 = __require("node:fs");
     var process8 = __require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1906,11 +1906,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path86.resolve(baseDir, baseName);
-          if (fs65.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path86.extname(baseName))) return void 0;
+          const localBin = path88.resolve(baseDir, baseName);
+          if (fs67.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path88.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs65.existsSync(`${localBin}${ext}`)
+            (ext) => fs67.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1922,21 +1922,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs65.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs67.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path86.resolve(
-            path86.dirname(resolvedScriptPath),
+          executableDir = path88.resolve(
+            path88.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path86.basename(
+            const legacyName = path88.basename(
               this._scriptPath,
-              path86.extname(this._scriptPath)
+              path88.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1947,7 +1947,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path86.extname(executableFile));
+        launchWithNode = sourceExt.includes(path88.extname(executableFile));
         let proc;
         if (process8.platform !== "win32") {
           if (launchWithNode) {
@@ -2787,7 +2787,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path86.basename(filename, path86.extname(filename));
+        this._name = path88.basename(filename, path88.extname(filename));
         return this;
       }
       /**
@@ -2801,9 +2801,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path87) {
-        if (path87 === void 0) return this._executableDir;
-        this._executableDir = path87;
+      executableDir(path89) {
+        if (path89 === void 0) return this._executableDir;
+        this._executableDir = path89;
         return this;
       }
       /**
@@ -7004,7 +7004,7 @@ var init_activity_tracker = __esm({
 
 // src/runtime/yield-to-event-loop.ts
 function yieldToEventLoop() {
-  return new Promise((resolve37) => setImmediate(resolve37));
+  return new Promise((resolve38) => setImmediate(resolve38));
 }
 var init_yield_to_event_loop = __esm({
   "src/runtime/yield-to-event-loop.ts"() {
@@ -7045,7 +7045,7 @@ async function yieldUntilFileBrowserReadsIdle(pollMs = 5) {
   while (getFileBrowserInFlightReadCount() > 0) {
     await yieldToEventLoop();
     if (getFileBrowserInFlightReadCount() > 0) {
-      await new Promise((resolve37) => setTimeout(resolve37, pollMs));
+      await new Promise((resolve38) => setTimeout(resolve38, pollMs));
     }
   }
 }
@@ -7055,7 +7055,7 @@ async function yieldUntilFileBrowserBrowseIdle(pollMs = 5) {
     const browseCooldownDone = lastActivityAt === 0 || Date.now() - lastActivityAt >= BROWSE_INDEX_COOLDOWN_MS;
     if (inFlightRequests2 === 0 && browseCooldownDone) return;
     await yieldToEventLoop();
-    await new Promise((resolve37) => setTimeout(resolve37, pollMs));
+    await new Promise((resolve38) => setTimeout(resolve38, pollMs));
   }
 }
 async function yieldUntilFileBrowserIdle(pollMs = 5) {
@@ -7232,8 +7232,8 @@ function createRequestId(prefix) {
 }
 function waitForWorkerReady() {
   if (workerReady) return Promise.resolve();
-  return new Promise((resolve37) => {
-    workerReadyWaiters.push(resolve37);
+  return new Promise((resolve38) => {
+    workerReadyWaiters.push(resolve38);
   });
 }
 function registerWorkerReadyListener(listener) {
@@ -7245,7 +7245,7 @@ function registerWorkerReadyListener(listener) {
 }
 function markWorkerReady() {
   workerReady = true;
-  for (const resolve37 of workerReadyWaiters) resolve37();
+  for (const resolve38 of workerReadyWaiters) resolve38();
   workerReadyWaiters = [];
   workerReadyListener?.();
 }
@@ -7392,7 +7392,7 @@ async function waitForOuterCodeNavCacheAccessAsync() {
     if (isCliImmediateShutdownRequested() || isSymbolIndexWorkerShutdownRequested()) {
       throw new CliSqliteInterrupted();
     }
-    await new Promise((resolve37) => setTimeout(resolve37, 5));
+    await new Promise((resolve38) => setTimeout(resolve38, 5));
     await yieldToEventLoop();
   }
 }
@@ -7729,7 +7729,7 @@ function readMigrationSql(filename, ...searchSubdirs) {
     join3(moduleDir, "..", sub, filename),
     join3(moduleDir, "..", "..", "dist", sub, filename)
   ]);
-  const resolved = candidates.find((path86) => existsSync(path86));
+  const resolved = candidates.find((path88) => existsSync(path88));
   if (!resolved) {
     throw new Error(`Missing SQLite migration SQL: ${filename} (searched ${searchSubdirs.join(", ")})`);
   }
@@ -8807,7 +8807,7 @@ var require_ignore = __commonJS({
       //   path matching.
       // - check `string` either `MODE_IGNORE` or `MODE_CHECK_IGNORE`
       // @returns {TestResult} true if a file is ignored
-      test(path86, checkUnignored, mode) {
+      test(path88, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -8816,7 +8816,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path86);
+          const matched = rule[mode].test(path88);
           if (!matched) {
             return;
           }
@@ -8837,17 +8837,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path86, originalPath, doThrow) => {
-      if (!isString(path86)) {
+    var checkPath = (path88, originalPath, doThrow) => {
+      if (!isString(path88)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path86) {
+      if (!path88) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path86)) {
+      if (checkPath.isNotRelative(path88)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -8856,7 +8856,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path86) => REGEX_TEST_INVALID_PATH.test(path86);
+    var isNotRelative = (path88) => REGEX_TEST_INVALID_PATH.test(path88);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore = class {
@@ -8886,19 +8886,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache2, checkUnignored, slices) {
-        const path86 = originalPath && checkPath.convert(originalPath);
+        const path88 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path86,
+          path88,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path86, cache2, checkUnignored, slices);
+        return this._t(path88, cache2, checkUnignored, slices);
       }
-      checkIgnore(path86) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path86)) {
-          return this.test(path86);
+      checkIgnore(path88) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path88)) {
+          return this.test(path88);
         }
-        const slices = path86.split(SLASH).filter(Boolean);
+        const slices = path88.split(SLASH).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -8911,18 +8911,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path86, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path88, false, MODE_CHECK_IGNORE);
       }
-      _t(path86, cache2, checkUnignored, slices) {
-        if (path86 in cache2) {
-          return cache2[path86];
+      _t(path88, cache2, checkUnignored, slices) {
+        if (path88 in cache2) {
+          return cache2[path88];
         }
         if (!slices) {
-          slices = path86.split(SLASH).filter(Boolean);
+          slices = path88.split(SLASH).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache2[path86] = this._rules.test(path86, checkUnignored, MODE_IGNORE);
+          return cache2[path88] = this._rules.test(path88, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH) + SLASH,
@@ -8930,29 +8930,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache2[path86] = parent.ignored ? parent : this._rules.test(path86, checkUnignored, MODE_IGNORE);
+        return cache2[path88] = parent.ignored ? parent : this._rules.test(path88, checkUnignored, MODE_IGNORE);
       }
-      ignores(path86) {
-        return this._test(path86, this._ignoreCache, false).ignored;
+      ignores(path88) {
+        return this._test(path88, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path86) => !this.ignores(path86);
+        return (path88) => !this.ignores(path88);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path86) {
-        return this._test(path86, this._testCache, true);
+      test(path88) {
+        return this._test(path88, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore(options);
-    var isPathValid = (path86) => checkPath(path86 && checkPath.convert(path86), path86, RETURN_FALSE);
+    var isPathValid = (path88) => checkPath(path88 && checkPath.convert(path88), path88, RETURN_FALSE);
     var setupWindows = () => {
       const makePosix = (str) => /^\\\\\?\\/.test(str) || /["<>|\u0000-\u001F]+/u.test(str) ? str : str.replace(/\\/g, "/");
       checkPath.convert = makePosix;
       const REGEX_TEST_WINDOWS_PATH_ABSOLUTE = /^[a-z]:\//i;
-      checkPath.isNotRelative = (path86) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path86) || isNotRelative(path86);
+      checkPath.isNotRelative = (path88) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path88) || isNotRelative(path88);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -12143,7 +12143,7 @@ var init_setup_handlers = __esm({
 // src/code-nav/symbol-index/worker/handle-message.ts
 async function waitForActiveWorkerHandlersIdle(pollMs = 10) {
   while (activeWorkerHandlers > 0) {
-    await new Promise((resolve37) => setTimeout(resolve37, pollMs));
+    await new Promise((resolve38) => setTimeout(resolve38, pollMs));
   }
 }
 async function handleRequestMessage(port, msg) {
@@ -12386,9 +12386,9 @@ async function requestWorker(message) {
   }
   ensureWorkerStarted();
   await ensureWorkerReadyForRequests();
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     pendingRequests.set(message.requestId, {
-      resolve: (value) => resolve37(value),
+      resolve: (value) => resolve38(value),
       reject
     });
     postToWorker(message);
@@ -12414,37 +12414,37 @@ async function shutdownWorkerThread() {
   if (activeWorker != null) {
     setWorker(null);
     await Promise.race([
-      new Promise((resolve37) => {
+      new Promise((resolve38) => {
         const onMessage = (message) => {
           if (message.type !== "shutdownComplete") return;
           activeWorker.off("message", onMessage);
-          resolve37();
+          resolve38();
         };
         activeWorker.on("message", onMessage);
         try {
           activeWorker.postMessage({ type: "shutdown" });
         } catch {
           activeWorker.off("message", onMessage);
-          resolve37();
+          resolve38();
         }
       }),
-      new Promise((resolve37) => setTimeout(resolve37, WORKER_SHUTDOWN_GRACE_MS))
+      new Promise((resolve38) => setTimeout(resolve38, WORKER_SHUTDOWN_GRACE_MS))
     ]);
     await activeWorker.terminate();
   } else {
     const inProcess = getInProcessBridge();
     if (inProcess != null) {
       await Promise.race([
-        new Promise((resolve37) => {
+        new Promise((resolve38) => {
           const onMessage = (message) => {
             if (message.type !== "shutdownComplete") return;
             inProcess.off("message", onMessage);
-            resolve37();
+            resolve38();
           };
           inProcess.on("message", onMessage);
           inProcess.postMessage({ type: "shutdown" });
         }),
-        new Promise((resolve37) => setTimeout(resolve37, WORKER_SHUTDOWN_GRACE_MS))
+        new Promise((resolve38) => setTimeout(resolve38, WORKER_SHUTDOWN_GRACE_MS))
       ]);
     }
   }
@@ -12968,8 +12968,8 @@ var init_parseUtil = __esm({
     init_errors();
     init_en();
     makeIssue = (params) => {
-      const { data, path: path86, errorMaps, issueData } = params;
-      const fullPath = [...path86, ...issueData.path || []];
+      const { data, path: path88, errorMaps, issueData } = params;
+      const fullPath = [...path88, ...issueData.path || []];
       const fullIssue = {
         ...issueData,
         path: fullPath
@@ -13277,11 +13277,11 @@ var init_types2 = __esm({
     init_parseUtil();
     init_util();
     ParseInputLazyPath = class {
-      constructor(parent, value, path86, key) {
+      constructor(parent, value, path88, key) {
         this._cachedPath = [];
         this.parent = parent;
         this.data = value;
-        this._path = path86;
+        this._path = path88;
         this._key = key;
       }
       get path() {
@@ -17006,10 +17006,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path86) {
-  if (!path86)
+function getElementAtPath(obj, path88) {
+  if (!path88)
     return obj;
-  return path86.reduce((acc, key) => acc?.[key], obj);
+  return path88.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -17258,11 +17258,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path86, issues) {
+function prefixIssues(path88, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path86);
+    iss.path.unshift(path88);
     return iss;
   });
 }
@@ -17451,7 +17451,7 @@ function treeifyError(error40, _mapper) {
     return issue2.message;
   };
   const result = { errors: [] };
-  const processError = (error41, path86 = []) => {
+  const processError = (error41, path88 = []) => {
     var _a2, _b;
     for (const issue2 of error41.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -17461,7 +17461,7 @@ function treeifyError(error40, _mapper) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path86, ...issue2.path];
+        const fullpath = [...path88, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -17491,9 +17491,9 @@ function treeifyError(error40, _mapper) {
   processError(error40);
   return result;
 }
-function toDotPath(path86) {
+function toDotPath(path88) {
   const segs = [];
-  for (const seg of path86) {
+  for (const seg of path88) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -29956,8 +29956,8 @@ var init_acp = __esm({
         this.#requestHandler = requestHandler;
         this.#notificationHandler = notificationHandler;
         this.#stream = stream;
-        this.#closedPromise = new Promise((resolve37) => {
-          this.#abortController.signal.addEventListener("abort", () => resolve37());
+        this.#closedPromise = new Promise((resolve38) => {
+          this.#abortController.signal.addEventListener("abort", () => resolve38());
         });
         this.#receive();
       }
@@ -30106,8 +30106,8 @@ var init_acp = __esm({
       }
       async sendRequest(method, params) {
         const id = this.#nextRequestId++;
-        const responsePromise = new Promise((resolve37, reject) => {
-          this.#pendingResponses.set(id, { resolve: resolve37, reject });
+        const responsePromise = new Promise((resolve38, reject) => {
+          this.#pendingResponses.set(id, { resolve: resolve38, reject });
         });
         await this.#sendMessage({ jsonrpc: "2.0", id, method, params });
         return responsePromise;
@@ -30976,10 +30976,10 @@ var require_src2 = __commonJS({
     var fs_1 = __require("fs");
     var debug_1 = __importDefault(require_src());
     var log2 = debug_1.default("@kwsites/file-exists");
-    function check2(path86, isFile, isDirectory) {
-      log2(`checking %s`, path86);
+    function check2(path88, isFile, isDirectory) {
+      log2(`checking %s`, path88);
       try {
-        const stat3 = fs_1.statSync(path86);
+        const stat3 = fs_1.statSync(path88);
         if (stat3.isFile() && isFile) {
           log2(`[OK] path represents a file`);
           return true;
@@ -30999,8 +30999,8 @@ var require_src2 = __commonJS({
         throw e;
       }
     }
-    function exists2(path86, type = exports.READABLE) {
-      return check2(path86, (type & exports.FILE) > 0, (type & exports.FOLDER) > 0);
+    function exists2(path88, type = exports.READABLE) {
+      return check2(path88, (type & exports.FILE) > 0, (type & exports.FOLDER) > 0);
     }
     exports.exists = exists2;
     exports.FILE = 1;
@@ -31081,7 +31081,7 @@ var {
 } = import_index.default;
 
 // src/cli-version.ts
-var CLI_VERSION = "0.1.80".length > 0 ? "0.1.80" : "0.0.0-dev";
+var CLI_VERSION = "0.1.82".length > 0 ? "0.1.82" : "0.0.0-dev";
 
 // src/cli/defaults.ts
 var DEFAULT_API_URL = process.env.BUILDAUTOMATON_API_URL ?? "https://api.buildautomaton.com";
@@ -31089,8 +31089,8 @@ var DEFAULT_FIREHOSE_URL = "https://buildautomaton-firehose.fly.dev";
 
 // src/cli/run-cli-action.ts
 init_cli_log_level();
-import * as fs64 from "node:fs";
-import * as path85 from "node:path";
+import * as fs66 from "node:fs";
+import * as path87 from "node:path";
 
 // src/config.ts
 import fs from "node:fs";
@@ -31979,14 +31979,14 @@ var baseOpen = async (options) => {
   }
   const subprocess = childProcess.spawn(command, cliArguments, childProcessOptions);
   if (options.wait) {
-    return new Promise((resolve37, reject) => {
+    return new Promise((resolve38, reject) => {
       subprocess.once("error", reject);
       subprocess.once("close", (exitCode) => {
         if (!options.allowNonzeroExitCode && exitCode > 0) {
           reject(new Error(`Exited with code ${exitCode}`));
           return;
         }
-        resolve37(subprocess);
+        resolve38(subprocess);
       });
     });
   }
@@ -32748,8 +32748,8 @@ function createPendingAuthOnClose(params) {
 // src/auth/pending/pending-auth-session.ts
 function createPendingAuthSession() {
   let resolveAuth;
-  const authPromise = new Promise((resolve37) => {
-    resolveAuth = resolve37;
+  const authPromise = new Promise((resolve38) => {
+    resolveAuth = resolve38;
   });
   return {
     ws: null,
@@ -35153,21 +35153,45 @@ async function execProbeShutdownAware(file2, args, timeoutMs) {
   }
 }
 
+// src/agents/acp/clients/format-stderr-for-terminal.ts
+var STDERR_TERMINAL_CHUNK_MAX = 400;
+function formatStderrForTerminal(text, maxChars = STDERR_TERMINAL_CHUNK_MAX) {
+  if (!text) return text;
+  const bodyIdx = text.indexOf("; body:");
+  if (bodyIdx >= 0) {
+    const s = `${text.slice(0, bodyIdx)}; body: [omitted]`;
+    return s.length <= maxChars ? `${s}
+` : `${s.slice(0, maxChars)}\u2026 [stderr truncated]
+`;
+  }
+  const trimmed2 = text.trimStart();
+  if (text.length > maxChars && (trimmed2.startsWith("{") || trimmed2.startsWith('"') || trimmed2.startsWith("["))) {
+    return "";
+  }
+  if (text.length <= maxChars) return text;
+  return `${text.slice(0, maxChars)}\u2026 [stderr truncated]
+`;
+}
+
 // src/agents/acp/clients/agent-stderr-capture.ts
-var STDERR_CAPTURE_MAX = 48e3;
-function createStderrCapture(child) {
+var STDERR_CAPTURE_MAX = 4e3;
+function createStderrCapture(_child) {
   const chunks = [];
   let total = 0;
   return {
     append(chunk) {
-      try {
-        process.stderr.write(chunk);
-      } catch {
+      const forTerminal = formatStderrForTerminal(chunk.toString("utf8"));
+      if (forTerminal) {
+        try {
+          process.stderr.write(forTerminal);
+        } catch {
+        }
       }
-      if (total >= STDERR_CAPTURE_MAX) return;
-      const n = Math.min(chunk.length, STDERR_CAPTURE_MAX - total);
+      if (!forTerminal || total >= STDERR_CAPTURE_MAX) return;
+      const buf = Buffer.from(forTerminal, "utf8");
+      const n = Math.min(buf.length, STDERR_CAPTURE_MAX - total);
       if (n <= 0) return;
-      chunks.push(n === chunk.length ? chunk : chunk.subarray(0, n));
+      chunks.push(n === buf.length ? buf : buf.subarray(0, n));
       total += n;
     },
     getText() {
@@ -35246,10 +35270,10 @@ async function killChildProcessTreeGracefully(child, graceMs = ACP_PROCESS_TREE_
   }
   await killProcessTree(pid, "SIGTERM");
   if (graceMs <= 0) return;
-  const exited = new Promise((resolve37) => {
-    child.once("exit", () => resolve37());
+  const exited = new Promise((resolve38) => {
+    child.once("exit", () => resolve38());
   });
-  await Promise.race([exited, new Promise((resolve37) => setTimeout(resolve37, graceMs))]);
+  await Promise.race([exited, new Promise((resolve38) => setTimeout(resolve38, graceMs))]);
   if (child.exitCode == null && child.signalCode == null) {
     await killProcessTree(pid, "SIGKILL");
   }
@@ -35266,8 +35290,8 @@ async function gracefulAcpSubprocessDisconnect(params) {
       await transport.closeSession?.(sessionId);
     } catch {
     }
-    await new Promise((resolve37) => {
-      const timer = setTimeout(resolve37, ACP_GRACEFUL_SESSION_CLOSE_WAIT_MS);
+    await new Promise((resolve38) => {
+      const timer = setTimeout(resolve38, ACP_GRACEFUL_SESSION_CLOSE_WAIT_MS);
       timer.unref?.();
     });
   }
@@ -35542,11 +35566,11 @@ function createSdkStdioExtNotificationHandler(options) {
 // src/agents/acp/clients/sdk/sdk-stdio-permission-request-handshake.ts
 function awaitSdkStdioPermissionRequestHandshake(params) {
   const { requestId, paramsRecord, pending: pending2, onRequest } = params;
-  return new Promise((resolve37) => {
-    pending2.set(requestId, { resolve: resolve37, params: paramsRecord });
+  return new Promise((resolve38) => {
+    pending2.set(requestId, { resolve: resolve38, params: paramsRecord });
     if (onRequest == null) {
       pending2.delete(requestId);
-      resolve37({ outcome: { outcome: "denied" } });
+      resolve38({ outcome: { outcome: "denied" } });
       return;
     }
     try {
@@ -36058,10 +36082,10 @@ function createSdkStdioInitSettle(child) {
       forceAcpSubprocessDisconnect(child);
       reject(err);
     },
-    settleResolve(resolve37, handle) {
+    settleResolve(resolve38, handle) {
       if (initSettled) return;
       initSettled = true;
-      resolve37(handle);
+      resolve38(handle);
     }
   };
 }
@@ -36150,7 +36174,7 @@ async function createSdkStdioAcpClient(options) {
     onFileChange,
     stderrCapture
   });
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     const init = createSdkStdioInitSettle(child);
     child.on("error", (err) => {
       init.settleReject(reject, new Error(formatSpawnError(err, command[0])));
@@ -36175,7 +36199,7 @@ async function createSdkStdioAcpClient(options) {
           protocolVersion: PROTOCOL_VERSION2
         });
         init.settleResolve(
-          resolve37,
+          resolve38,
           createSdkStdioHandle({
             child,
             sessionId: established.sessionId,
@@ -36756,7 +36780,7 @@ async function createCursorAcpClient(options) {
     onFileChange,
     stderrCapture
   });
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     child.on("error", (err) => {
       killChildProcessTree(child, "SIGKILL");
       reject(new Error(formatSpawnError(err, command[0])));
@@ -36769,7 +36793,7 @@ async function createCursorAcpClient(options) {
           skipBrowserAuthenticate,
           incomingDeps: { dbgFs, sessionCtx, onSessionUpdate, onRequest }
         });
-        resolve37(
+        resolve38(
           createCursorAcpHandle({
             child,
             sessionId: established.sessionId,
@@ -38208,8 +38232,8 @@ async function runGitTask(fn) {
 }
 async function yieldToEventLoop2() {
   throwIfGitShutdownRequested();
-  await new Promise((resolve37) => {
-    setImmediate(resolve37);
+  await new Promise((resolve38) => {
+    setImmediate(resolve38);
   });
   throwIfGitShutdownRequested();
 }
@@ -38246,8 +38270,8 @@ async function execGitFile(args, options) {
 }
 
 // src/git/changes/parse/normalize-git-diff-path.ts
-function normalizeGitDiffPath(path86) {
-  return path86.replace(/\\/g, "/").replace(/\/ +/g, "/").trim();
+function normalizeGitDiffPath(path88) {
+  return path88.replace(/\\/g, "/").replace(/\/ +/g, "/").trim();
 }
 
 // src/git/changes/parse/parse-name-status-entries.ts
@@ -39565,11 +39589,11 @@ function isServerNotRunningError(err) {
 }
 function closeHttpServer(server) {
   if (!server) return Promise.resolve();
-  return new Promise((resolve37) => {
+  return new Promise((resolve38) => {
     server.close((err) => {
       if (err && !isServerNotRunningError(err)) {
       }
-      resolve37();
+      resolve38();
     });
   });
 }
@@ -39582,7 +39606,7 @@ var RequestBodyTooLargeError = class extends Error {
   }
 };
 function readJsonBody(req) {
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     const chunks = [];
     let total = 0;
     let tooLarge = false;
@@ -39602,11 +39626,11 @@ function readJsonBody(req) {
       try {
         const raw = Buffer.concat(chunks).toString("utf8").trim();
         if (!raw) {
-          resolve37({});
+          resolve38({});
           return;
         }
         const parsed = JSON.parse(raw);
-        resolve37(parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {});
+        resolve38(parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {});
       } catch (e) {
         reject(e);
       }
@@ -39664,7 +39688,7 @@ function createBridgeAccessRequestHandler(registry2) {
 // src/mcp/bridge-access/start-server.ts
 function startBridgeAccessServer(registry2) {
   const server = http.createServer(createBridgeAccessRequestHandler(registry2));
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     server.once("error", reject);
     server.listen(0, "127.0.0.1", () => {
       const addr = server.address();
@@ -39672,7 +39696,7 @@ function startBridgeAccessServer(registry2) {
         reject(new Error("Bridge access server did not bind"));
         return;
       }
-      resolve37({
+      resolve38({
         port: addr.port,
         close: () => closeHttpServer(server)
       });
@@ -41311,19 +41335,19 @@ function buildLocalHttpRequestOptions(built) {
 }
 function runLocalHttpRequestOnce(mod, built) {
   const opts = buildLocalHttpRequestOptions(built);
-  return new Promise((resolve37) => {
+  return new Promise((resolve38) => {
     const req = mod.request(opts, (res) => {
       const chunks = [];
       res.on("data", (chunk) => chunks.push(chunk));
       res.on("end", () => {
-        resolve37({
+        resolve38({
           statusCode: res.statusCode ?? 0,
           headers: incomingMessageHeaders(res),
           body: Buffer.concat(chunks)
         });
       });
       res.on("error", (err) => {
-        resolve37({
+        resolve38({
           statusCode: 0,
           headers: {},
           body: Buffer.alloc(0),
@@ -41335,7 +41359,7 @@ function runLocalHttpRequestOnce(mod, built) {
       req.destroy(new Error(`Local preview request timed out after ${LOCAL_PROXY_REQUEST_TIMEOUT_MS}ms`));
     });
     req.on("error", (err) => {
-      resolve37({
+      resolve38({
         statusCode: 0,
         headers: {},
         body: Buffer.alloc(0),
@@ -41359,14 +41383,14 @@ async function proxyToLocalStreaming(request, callbacks) {
   const isHttps = request.url.startsWith("https:");
   const mod = await loadHttpModule(isHttps);
   const opts = buildLocalHttpRequestOptions(built);
-  await new Promise((resolve37) => {
+  await new Promise((resolve38) => {
     const req = mod.request(opts, (res) => {
       try {
         callbacks.onStart(res.statusCode ?? 0, incomingMessageHeaders(res));
       } catch (err) {
         req.destroy();
         callbacks.onError(err instanceof Error ? err.message : String(err));
-        resolve37();
+        resolve38();
         return;
       }
       res.on("data", (chunk) => {
@@ -41379,11 +41403,11 @@ async function proxyToLocalStreaming(request, callbacks) {
       });
       res.on("end", () => {
         callbacks.onEnd();
-        resolve37();
+        resolve38();
       });
       res.on("error", (err) => {
         callbacks.onError(err.message);
-        resolve37();
+        resolve38();
       });
     });
     req.setTimeout(LOCAL_PROXY_REQUEST_TIMEOUT_MS, () => {
@@ -41391,7 +41415,7 @@ async function proxyToLocalStreaming(request, callbacks) {
     });
     req.on("error", (err) => {
       callbacks.onError(err.message);
-      resolve37();
+      resolve38();
     });
     if (built.sendingBody && built.body != null) {
       req.write(built.body);
@@ -42515,8 +42539,8 @@ function pathspec(...paths) {
   cache.set(key, paths);
   return key;
 }
-function isPathSpec(path86) {
-  return path86 instanceof String && cache.has(path86);
+function isPathSpec(path88) {
+  return path88 instanceof String && cache.has(path88);
 }
 function toPaths(pathSpec) {
   return cache.get(pathSpec) || [];
@@ -42605,8 +42629,8 @@ function toLinesWithContent(input = "", trimmed2 = true, separator = "\n") {
 function forEachLineWithContent(input, callback) {
   return toLinesWithContent(input, true).map((line) => callback(line));
 }
-function folderExists(path86) {
-  return (0, import_file_exists.exists)(path86, import_file_exists.FOLDER);
+function folderExists(path88) {
+  return (0, import_file_exists.exists)(path88, import_file_exists.FOLDER);
 }
 function append(target, item) {
   if (Array.isArray(target)) {
@@ -43010,8 +43034,8 @@ function checkIsRepoRootTask() {
     commands,
     format: "utf-8",
     onError,
-    parser(path86) {
-      return /^\.(git)?$/.test(path86.trim());
+    parser(path88) {
+      return /^\.(git)?$/.test(path88.trim());
     }
   };
 }
@@ -43445,11 +43469,11 @@ function parseGrep(grep) {
   const paths = /* @__PURE__ */ new Set();
   const results = {};
   forEachLineWithContent(grep, (input) => {
-    const [path86, line, preview] = input.split(NULL);
-    paths.add(path86);
-    (results[path86] = results[path86] || []).push({
+    const [path88, line, preview] = input.split(NULL);
+    paths.add(path88);
+    (results[path88] = results[path88] || []).push({
       line: asNumber(line),
-      path: path86,
+      path: path88,
       preview
     });
   });
@@ -44214,14 +44238,14 @@ var init_hash_object = __esm2({
     init_task();
   }
 });
-function parseInit(bare, path86, text) {
+function parseInit(bare, path88, text) {
   const response = String(text).trim();
   let result;
   if (result = initResponseRegex.exec(response)) {
-    return new InitSummary(bare, path86, false, result[1]);
+    return new InitSummary(bare, path88, false, result[1]);
   }
   if (result = reInitResponseRegex.exec(response)) {
-    return new InitSummary(bare, path86, true, result[1]);
+    return new InitSummary(bare, path88, true, result[1]);
   }
   let gitDir = "";
   const tokens = response.split(" ");
@@ -44232,7 +44256,7 @@ function parseInit(bare, path86, text) {
       break;
     }
   }
-  return new InitSummary(bare, path86, /^re/i.test(response), gitDir);
+  return new InitSummary(bare, path88, /^re/i.test(response), gitDir);
 }
 var InitSummary;
 var initResponseRegex;
@@ -44241,9 +44265,9 @@ var init_InitSummary = __esm2({
   "src/lib/responses/InitSummary.ts"() {
     "use strict";
     InitSummary = class {
-      constructor(bare, path86, existing, gitDir) {
+      constructor(bare, path88, existing, gitDir) {
         this.bare = bare;
-        this.path = path86;
+        this.path = path88;
         this.existing = existing;
         this.gitDir = gitDir;
       }
@@ -44255,7 +44279,7 @@ var init_InitSummary = __esm2({
 function hasBareCommand(command) {
   return command.includes(bareCommand);
 }
-function initTask(bare = false, path86, customArgs) {
+function initTask(bare = false, path88, customArgs) {
   const commands = ["init", ...customArgs];
   if (bare && !hasBareCommand(commands)) {
     commands.splice(1, 0, bareCommand);
@@ -44264,7 +44288,7 @@ function initTask(bare = false, path86, customArgs) {
     commands,
     format: "utf-8",
     parser(text) {
-      return parseInit(commands.includes("--bare"), path86, text);
+      return parseInit(commands.includes("--bare"), path88, text);
     }
   };
 }
@@ -45080,12 +45104,12 @@ var init_FileStatusSummary = __esm2({
     "use strict";
     fromPathRegex = /^(.+)\0(.+)$/;
     FileStatusSummary = class {
-      constructor(path86, index, working_dir) {
-        this.path = path86;
+      constructor(path88, index, working_dir) {
+        this.path = path88;
         this.index = index;
         this.working_dir = working_dir;
         if (index === "R" || working_dir === "R") {
-          const detail = fromPathRegex.exec(path86) || [null, path86, path86];
+          const detail = fromPathRegex.exec(path88) || [null, path88, path88];
           this.from = detail[2] || "";
           this.path = detail[1] || "";
         }
@@ -45116,14 +45140,14 @@ function splitLine(result, lineStr) {
     default:
       return;
   }
-  function data(index, workingDir, path86) {
+  function data(index, workingDir, path88) {
     const raw = `${index}${workingDir}`;
     const handler = parsers6.get(raw);
     if (handler) {
-      handler(result, path86);
+      handler(result, path88);
     }
     if (raw !== "##" && raw !== "!!") {
-      result.files.push(new FileStatusSummary(path86, index, workingDir));
+      result.files.push(new FileStatusSummary(path88, index, workingDir));
     }
   }
 }
@@ -45432,9 +45456,9 @@ var init_simple_git_api = __esm2({
           next
         );
       }
-      hashObject(path86, write) {
+      hashObject(path88, write) {
         return this._runTask(
-          hashObjectTask(path86, write === true),
+          hashObjectTask(path88, write === true),
           trailingFunctionArgument(arguments)
         );
       }
@@ -45787,8 +45811,8 @@ var init_branch = __esm2({
   }
 });
 function toPath(input) {
-  const path86 = input.trim().replace(/^["']|["']$/g, "");
-  return path86 && normalize3(path86);
+  const path88 = input.trim().replace(/^["']|["']$/g, "");
+  return path88 && normalize3(path88);
 }
 var parseCheckIgnore;
 var init_CheckIgnore = __esm2({
@@ -46102,8 +46126,8 @@ __export2(sub_module_exports, {
   subModuleTask: () => subModuleTask,
   updateSubModuleTask: () => updateSubModuleTask
 });
-function addSubModuleTask(repo, path86) {
-  return subModuleTask(["add", repo, path86]);
+function addSubModuleTask(repo, path88) {
+  return subModuleTask(["add", repo, path88]);
 }
 function initSubModuleTask(customArgs) {
   return subModuleTask(["init", ...customArgs]);
@@ -46436,8 +46460,8 @@ var require_git = __commonJS2({
       }
       return this._runTask(straightThroughStringTask2(command, this._trimmed), next);
     };
-    Git2.prototype.submoduleAdd = function(repo, path86, then) {
-      return this._runTask(addSubModuleTask2(repo, path86), trailingFunctionArgument2(arguments));
+    Git2.prototype.submoduleAdd = function(repo, path88, then) {
+      return this._runTask(addSubModuleTask2(repo, path88), trailingFunctionArgument2(arguments));
     };
     Git2.prototype.submoduleUpdate = function(args, then) {
       return this._runTask(
@@ -47176,8 +47200,8 @@ function parseNumstatEntries(lines) {
 }
 function parseNumstat(lines) {
   const m = /* @__PURE__ */ new Map();
-  for (const [path86, entry] of parseNumstatEntries(lines)) {
-    m.set(path86, { additions: entry.additions, deletions: entry.deletions });
+  for (const [path88, entry] of parseNumstatEntries(lines)) {
+    m.set(path88, { additions: entry.additions, deletions: entry.deletions });
   }
   return m;
 }
@@ -51265,7 +51289,7 @@ init_symbol_index_file_ready();
 var CODE_NAV_INDEX_READY_WAIT_MS = 75;
 var CODE_NAV_INDEX_READY_POLL_MS = 15;
 function delay2(ms) {
-  return new Promise((resolve37) => setTimeout(resolve37, ms));
+  return new Promise((resolve38) => setTimeout(resolve38, ms));
 }
 async function waitForSymbolIndexReady(sessionParentPath, reqPath, maxWaitMs = CODE_NAV_INDEX_READY_WAIT_MS) {
   const deadline = Date.now() + maxWaitMs;
@@ -51397,12 +51421,12 @@ function parseOptionalInt2(raw) {
   return Number.isInteger(parsed) ? parsed : void 0;
 }
 function parseCodeNavParams(url2) {
-  const path86 = url2.searchParams.get("path") ?? "";
+  const path88 = url2.searchParams.get("path") ?? "";
   const opRaw = url2.searchParams.get("op")?.trim();
   const op = opRaw === "references" ? "references" : opRaw === "symbols" ? "symbols" : opRaw === "definitions" ? "definitions" : "definition";
   const line = parseOptionalInt2(url2.searchParams.get("line")) ?? 1;
   const column = parseOptionalInt2(url2.searchParams.get("column")) ?? 0;
-  return { path: path86, op, line, column };
+  return { path: path88, op, line, column };
 }
 function parseCodeNavPath(url2) {
   const raw = url2.searchParams.get("path")?.trim();
@@ -51578,7 +51602,7 @@ function createLocalShortcutRequestHandler(ctx) {
 var RESTART_DELAY_MS = 250;
 var MAX_RESTART_ATTEMPTS = 5;
 function listenOnPort(server, port) {
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     server.once("error", reject);
     server.listen(port, "127.0.0.1", () => {
       const addr = server.address();
@@ -51586,12 +51610,12 @@ function listenOnPort(server, port) {
         reject(new Error("Local shortcut server did not bind"));
         return;
       }
-      resolve37(addr.port);
+      resolve38(addr.port);
     });
   });
 }
 function delay3(ms) {
-  return new Promise((resolve37) => setTimeout(resolve37, ms));
+  return new Promise((resolve38) => setTimeout(resolve38, ms));
 }
 function startLocalShortcutServer(ctx) {
   let closed = false;
@@ -51791,7 +51815,8 @@ var API_TO_BRIDGE_MESSAGE_TYPES = [
   "install_agent",
   "refresh_local_skills",
   "bridge_git_context_request",
-  "list_repo_branches_request"
+  "list_repo_branches_request",
+  "bridge_git_checkout_request"
 ];
 var API_TO_BRIDGE_TYPE_SET = new Set(API_TO_BRIDGE_MESSAGE_TYPES);
 function parseApiToBridgeMessage(data, log2) {
@@ -52484,10 +52509,10 @@ async function awaitGitStatePreparation(options) {
   try {
     return await Promise.race([
       work,
-      new Promise((resolve37) => {
+      new Promise((resolve38) => {
         timer = setTimeout(() => {
           log2(`[Agent] ${label} exceeded ${timeoutMs}ms; continuing without it.`);
-          resolve37(fallback);
+          resolve38(fallback);
         }, timeoutMs);
         timer.unref?.();
       })
@@ -53050,8 +53075,8 @@ function randomSecret() {
   }
   return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
 }
-async function requestPreviewApi(port, secret, method, path86, body) {
-  const url2 = `http://127.0.0.1:${port}${path86}`;
+async function requestPreviewApi(port, secret, method, path88, body) {
+  const url2 = `http://127.0.0.1:${port}${path88}`;
   const headers = {
     [PREVIEW_SECRET_HEADER]: secret,
     "Content-Type": "application/json"
@@ -53063,7 +53088,7 @@ async function requestPreviewApi(port, secret, method, path86, body) {
   });
   const data = await res.json().catch(() => ({}));
   if (!res.ok) {
-    throw new Error(data?.error ?? `Preview API ${method} ${path86}: ${res.status}`);
+    throw new Error(data?.error ?? `Preview API ${method} ${path88}: ${res.status}`);
   }
   return data;
 }
@@ -53320,7 +53345,7 @@ var handleInstallSkillsMessage = (msg, deps) => {
 import { spawn as spawn11 } from "node:child_process";
 import * as readline3 from "node:readline";
 function runStreamingCommand(command, args, options) {
-  return new Promise((resolve37, reject) => {
+  return new Promise((resolve38, reject) => {
     const child = spawn11(command, args, {
       env: options.env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -53353,7 +53378,7 @@ function runStreamingCommand(command, args, options) {
       if (timer) clearTimeout(timer);
       if (!settled) {
         settled = true;
-        resolve37({ code, signal });
+        resolve38({ code, signal });
       }
     });
   });
@@ -53792,6 +53817,23 @@ async function listRepoBranchRefs(repoPath) {
   }
 }
 
+// src/git/checkout/pending-checkouts.ts
+var pendingByRelPath = /* @__PURE__ */ new Map();
+function beginPendingCheckout(row) {
+  const relPath = row.relPath.trim() || ".";
+  pendingByRelPath.set(relPath, {
+    relPath,
+    folderName: row.folderName.trim() || (relPath === "." ? "repo" : relPath),
+    remoteUrl: row.remoteUrl
+  });
+}
+function endPendingCheckout(relPath) {
+  pendingByRelPath.delete(relPath.trim() || ".");
+}
+function listPendingCheckouts() {
+  return [...pendingByRelPath.values()];
+}
+
 // src/git/bridge-git-context.ts
 function folderNameForRelPath(relPath, bridgeRoot) {
   if (relPath === "." || relPath === "") {
@@ -53828,7 +53870,23 @@ async function getBridgeGitContext(bridgeRoot = getBridgeRoot()) {
       relPath,
       folderName: folderNameForRelPath(relPath, bridgeResolved),
       currentBranch,
-      remoteUrl
+      remoteUrl,
+      cloning: false
+    });
+  }
+  const seen = new Set(rows.map((r) => r.relPath));
+  for (const pending2 of listPendingCheckouts()) {
+    if (seen.has(pending2.relPath)) {
+      const row = rows.find((r) => r.relPath === pending2.relPath);
+      if (row) row.cloning = true;
+      continue;
+    }
+    rows.push({
+      relPath: pending2.relPath,
+      folderName: pending2.folderName,
+      currentBranch: null,
+      remoteUrl: pending2.remoteUrl,
+      cloning: true
     });
   }
   rows.sort((a, b) => a.relPath.localeCompare(b.relPath));
@@ -53888,6 +53946,143 @@ function handleListRepoBranchesRequestMessage(msg, getWs) {
   })();
 }
 
+// src/git/checkout/bridge-git-checkout.ts
+import * as fs65 from "node:fs/promises";
+import * as path86 from "node:path";
+
+// src/git/checkout/normalize-clone-url.ts
+function normalizeCloneUrl(url2) {
+  const u = url2.trim();
+  if (!u.startsWith("http://") && !u.startsWith("https://")) {
+    throw new Error("Only http(s) git remote URLs are supported");
+  }
+  return u.endsWith(".git") ? u : `${u}.git`;
+}
+function cloneUrlWithHttpsAuth(url2, auth) {
+  const normalized = normalizeCloneUrl(url2);
+  if (!auth) return normalized;
+  const parsed = new URL(normalized);
+  parsed.username = auth.username;
+  parsed.password = auth.password;
+  return parsed.toString();
+}
+
+// src/git/checkout/resolve-checkout-target.ts
+import * as fs64 from "node:fs/promises";
+import * as path85 from "node:path";
+var FOLDER_NAME_RE = /^[A-Za-z0-9._-]+$/;
+async function pathExists(p) {
+  try {
+    await fs64.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function resolveCheckoutTarget(opts) {
+  const bridgeRoot = getBridgeRoot();
+  if (opts.layout === "monorepo") {
+    if (await isGitRepoDirectory(bridgeRoot)) {
+      throw new Error("Bridge root is already a git repository");
+    }
+    const entries = await fs64.readdir(bridgeRoot).catch(() => []);
+    if (entries.length > 0) {
+      throw new Error("Bridge root must be empty to initialize a monorepo checkout");
+    }
+    return { targetDir: bridgeRoot, relPath: "." };
+  }
+  const folder = (opts.folderName ?? "").trim();
+  if (!folder || folder === "." || folder === ".." || !FOLDER_NAME_RE.test(folder)) {
+    throw new Error("folderName must be a single path segment (letters, numbers, . _ -)");
+  }
+  if (await isGitRepoDirectory(bridgeRoot)) {
+    throw new Error("Cannot add a nested repo while the bridge root is itself a git repository");
+  }
+  const targetDir = path85.resolve(bridgeRoot, folder);
+  if (!targetDir.startsWith(bridgeRoot + path85.sep)) {
+    throw new Error("Invalid folderName");
+  }
+  if (await pathExists(targetDir)) {
+    throw new Error(`Folder already exists: ${folder}`);
+  }
+  return { targetDir, relPath: folder };
+}
+
+// src/git/checkout/bridge-git-checkout.ts
+async function bridgeGitCheckout(params) {
+  const cloneUrl = (params.cloneUrl ?? "").trim();
+  if (!cloneUrl) throw new Error("cloneUrl required");
+  const { targetDir, relPath } = await resolveCheckoutTarget({
+    layout: params.layout,
+    folderName: params.folderName
+  });
+  const folderName = relPath === "." ? "repo" : relPath;
+  beginPendingCheckout({ relPath, folderName, remoteUrl: cloneUrl });
+  const parent = path86.dirname(targetDir);
+  await fs65.mkdir(parent, { recursive: true });
+  if (relPath !== ".") {
+    await fs65.mkdir(targetDir, { recursive: true });
+  }
+  const url2 = cloneUrlWithHttpsAuth(cloneUrl, params.auth ?? null);
+  try {
+    await execGitFile(["clone", "--", url2, targetDir], {
+      cwd: parent,
+      env: { ...process.env, GIT_TERMINAL_PROMPT: "0" }
+    });
+    return { relPath, folderName };
+  } catch (e) {
+    if (relPath !== ".") {
+      await fs65.rm(targetDir, { recursive: true, force: true }).catch(() => void 0);
+    }
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(
+      msg.includes("Authentication") || msg.includes("403") || msg.includes("401") ? `Clone failed (auth?): ${msg}` : `Clone failed: ${msg}`
+    );
+  } finally {
+    endPendingCheckout(relPath);
+  }
+}
+
+// src/routing/handlers/bridge-git-checkout-messages.ts
+function handleBridgeGitCheckoutRequestMessage(msg, getWs) {
+  void (async () => {
+    const socket = getWs();
+    if (!socket) return;
+    const layout = msg.layout === "multi_repo" ? "multi_repo" : msg.layout === "monorepo" ? "monorepo" : null;
+    if (!layout) {
+      sendWsMessage(socket, {
+        type: "bridge_git_checkout_response",
+        id: msg.id,
+        error: "layout must be monorepo or multi_repo"
+      });
+      return;
+    }
+    try {
+      const user = typeof msg.authUsername === "string" ? msg.authUsername : "";
+      const pass = typeof msg.authPassword === "string" ? msg.authPassword : "";
+      const result = await bridgeGitCheckout({
+        layout,
+        folderName: msg.folderName,
+        cloneUrl: msg.cloneUrl ?? "",
+        auth: user && pass ? { username: user, password: pass } : null
+      });
+      sendWsMessage(socket, {
+        type: "bridge_git_checkout_response",
+        id: msg.id,
+        ok: true,
+        relPath: result.relPath,
+        folderName: result.folderName
+      });
+    } catch (e) {
+      sendWsMessage(socket, {
+        type: "bridge_git_checkout_response",
+        id: msg.id,
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
+  })();
+}
+
 // src/routing/dispatch/file-browser.ts
 function dispatchBridgeFileBrowserMessage(msg, deps) {
   switch (msg.type) {
@@ -53906,6 +54101,9 @@ function dispatchBridgeFileBrowserMessage(msg, deps) {
     case "list_repo_branches_request":
       handleListRepoBranchesRequestMessage(msg, deps.getWs);
       break;
+    case "bridge_git_checkout_request":
+      handleBridgeGitCheckoutRequestMessage(msg, deps.getWs);
+      break;
   }
 }
 
@@ -53946,6 +54144,7 @@ function dispatchBridgeMessage(msg, deps) {
     case "code_nav":
     case "bridge_git_context_request":
     case "list_repo_branches_request":
+    case "bridge_git_checkout_request":
       dispatchBridgeFileBrowserMessage(msg, deps);
       break;
   }
@@ -54411,12 +54610,12 @@ async function runConnectedBridge(options, restartWithoutAuth) {
   let cleanupKeyCommand;
   let bridgeClose = null;
   let endConnectedSession;
-  const sessionDone = new Promise((resolve37) => {
-    endConnectedSession = resolve37;
+  const sessionDone = new Promise((resolve38) => {
+    endConnectedSession = resolve38;
   });
   let resolveHandleReady;
-  const handleReady = new Promise((resolve37) => {
-    resolveHandleReady = resolve37;
+  const handleReady = new Promise((resolve38) => {
+    resolveHandleReady = resolve38;
   });
   const handleRef = { current: null };
   const signals = installConnectedBridgeSignals({
@@ -54567,9 +54766,9 @@ async function runCliAction(program2, opts) {
   const firehoseServerUrl = opts.firehoseUrl ?? opts.proxyUrl ?? process.env.BUILDAUTOMATON_FIREHOSE_URL ?? process.env.BUILDAUTOMATON_PROXY_URL ?? DEFAULT_FIREHOSE_URL;
   const bridgeRootOpt = (opts.bridgeRoot && typeof opts.bridgeRoot === "string" && opts.bridgeRoot.trim() ? opts.bridgeRoot.trim() : null) ?? (opts.cwd && typeof opts.cwd === "string" && opts.cwd.trim() ? opts.cwd.trim() : null);
   if (bridgeRootOpt) {
-    const resolvedBridgeRoot = path85.resolve(process.cwd(), bridgeRootOpt);
+    const resolvedBridgeRoot = path87.resolve(process.cwd(), bridgeRootOpt);
     try {
-      const st = fs64.statSync(resolvedBridgeRoot);
+      const st = fs66.statSync(resolvedBridgeRoot);
       if (!st.isDirectory()) {
         console.error(`Bridge root is not a directory: ${resolvedBridgeRoot}`);
         process.exit(1);
@@ -54589,7 +54788,7 @@ async function runCliAction(program2, opts) {
   );
   let worktreesRootPath;
   if (opts.worktreesRoot && opts.worktreesRoot.trim()) {
-    worktreesRootPath = path85.resolve(opts.worktreesRoot.trim());
+    worktreesRootPath = path87.resolve(opts.worktreesRoot.trim());
   }
   const e2eCertificates = opts.e2eeCertificatesDir?.trim() ? await loadOrCreateE2eCertificates(opts.e2eeCertificatesDir.trim()) : void 0;
   if (e2eCertificates) {