@rockclaver/sandcastle 0.7.0

package/dist/index.js

@@ -0,0 +1,2393 @@
+import { createRequire } from 'node:module';
+import { NodeContext_exports, NodeFileSystem_exports, formatErrorMessage } from './chunk-QCLZLPJ7.js';
+export { AGENT_DEFAULT_MODELS, agent, claudeCode, claudeHostSessionPath, claudeSandboxSessionPath, codex, copilot, cursor, encodeProjectPath, findClaudeSessionOnHost, findCodexSessionOnHost, opencode, pi, transferClaudeSession, transferCodexSession } from './chunk-QCLZLPJ7.js';
+import { Context_exports, CwdError, Effect_exports, resolveCwd, getCurrentBranch, generateTempBranchName, Layer_exports, FileDisplay, ClackDisplay, WorktreeDockerSandboxFactory, SandboxConfig, Display, pruneStale, create, copyToWorktree, runHostHooks, startSandbox, resolveGitMounts, SANDBOX_REPO_DIR, remove, makeSandboxFromHandle, syncOut, withSandboxLifecycle, hasUncommittedChanges, patchGitMountsForWindows, registerShutdown, SandboxFactory, PromptError, FileSystem_exports, SessionCaptureError, Clock_exports, Duration_exports, Option_exports, PromptExpansionTimeoutError, Deferred_exports, AgentError, Ref_exports, SilentDisplay, AgentIdleTimeoutError, Fiber_exports } from './chunk-VAKEM3U2.js';
+export { createBindMountSandboxProvider, createIsolatedSandboxProvider } from './chunk-BIWNFKGV.js';
+import { noSandbox } from './chunk-72UVAC7B.js';
+import './chunk-NGBM7T3E.js';
+import path, { join } from 'path';
+import { styleText } from 'util';
+import * as clack from '@clack/prompts';
+
+createRequire(import.meta.url);
+
+// src/resumePrecheck.ts
+var assertResumeSessionExists = async (params) => {
+  const { provider, sandboxTag, hostRepoDir, resumeSession } = params;
+  if (!provider.sessionStorage) {
+    throw new Error(`${provider.name} does not support resumeSession`);
+  }
+  if (sandboxTag === "none") {
+    const found = await provider.sessionStorage.findByIdOnHost(resumeSession);
+    if (!found.path) {
+      throw new Error(
+        `resumeSession "${resumeSession}" not found under ${found.searchedRoot}`
+      );
+    }
+    return;
+  }
+  const exists = await provider.sessionStorage.existsOnHost(
+    hostRepoDir,
+    resumeSession
+  );
+  if (!exists) {
+    const sessionPath = provider.sessionStorage.hostSessionFilePath(
+      hostRepoDir,
+      resumeSession
+    );
+    throw new Error(
+      sessionPath ? `resumeSession "${resumeSession}" not found: expected session file at ${sessionPath}` : `resumeSession "${resumeSession}" not found`
+    );
+  }
+};
+
+// src/AgentStreamEmitter.ts
+var AgentStreamEmitter = class extends Context_exports.Tag("AgentStreamEmitter")() {
+};
+var agentStreamEmitterLayer = (onEvent) => Layer_exports.succeed(AgentStreamEmitter, {
+  emit: onEvent ? (event) => Effect_exports.sync(() => {
+    try {
+      onEvent(event);
+    } catch {
+    }
+  }) : () => Effect_exports.void
+});
+
+// src/PromptPreprocessor.ts
+var PROMPT_EXPANSION_TIMEOUT_MS = 3e4;
+var SHELL_BLOCK_MARKER = "
";
+var MARKED_SHELL_BLOCK_PATTERN = new RegExp(
+  `!${SHELL_BLOCK_MARKER}\`([^\`]+)\``,
+  "g"
+);
+var preprocessPrompt = (prompt, sandbox, cwd) => {
+  const matches = [...prompt.matchAll(MARKED_SHELL_BLOCK_PATTERN)];
+  if (matches.length === 0) {
+    return Effect_exports.succeed(prompt.replaceAll(SHELL_BLOCK_MARKER, ""));
+  }
+  return Effect_exports.gen(function* () {
+    const display = yield* Display;
+    return yield* display.taskLog(
+      "Expanding shell expressions",
+      (message) => Effect_exports.gen(function* () {
+        const results = yield* Effect_exports.all(
+          matches.map((match) => {
+            const command = match[1];
+            return Effect_exports.gen(function* () {
+              const start = yield* Clock_exports.currentTimeMillis;
+              const maybeResult = yield* sandbox.exec(command, { cwd }).pipe(
+                Effect_exports.timeoutOption(
+                  Duration_exports.millis(PROMPT_EXPANSION_TIMEOUT_MS)
+                )
+              );
+              if (Option_exports.isNone(maybeResult)) {
+                const elapsedMs = (yield* Clock_exports.currentTimeMillis) - start;
+                return yield* Effect_exports.fail(
+                  new PromptExpansionTimeoutError({
+                    message: `Shell expression \`${command}\` timed out after ${elapsedMs}ms`,
+                    timeoutMs: PROMPT_EXPANSION_TIMEOUT_MS,
+                    expression: command,
+                    elapsedMs
+                  })
+                );
+              }
+              const execResult = maybeResult.value;
+              if (execResult.exitCode !== 0) {
+                return yield* Effect_exports.fail(
+                  new PromptError({
+                    message: `Command \`${command}\` exited with code ${execResult.exitCode}: ${execResult.stderr}`,
+                    exitCode: execResult.exitCode
+                  })
+                );
+              }
+              return execResult.stdout.trimEnd();
+            });
+          }),
+          { concurrency: "unbounded" }
+        );
+        for (let i = 0; i < matches.length; i++) {
+          const command = matches[i][1];
+          const tokens = Math.ceil(results[i].length / 4);
+          message(`${command} \u2192 ~${tokens} tokens`);
+        }
+        let result = prompt;
+        for (let i = matches.length - 1; i >= 0; i--) {
+          const match = matches[i];
+          const index = match.index;
+          result = result.slice(0, index) + results[i] + result.slice(index + match[0].length);
+        }
+        return result.replaceAll(SHELL_BLOCK_MARKER, "");
+      })
+    );
+  });
+};
+
+// src/TextDeltaBuffer.ts
+var LENGTH_THRESHOLD = 80;
+var DEBOUNCE_MS = 50;
+var SENTENCE_BOUNDARY_RE = /[.!?] $/;
+var TextDeltaBuffer = class {
+  buffer = "";
+  timer = null;
+  onFlush;
+  constructor(onFlush) {
+    this.onFlush = onFlush;
+  }
+  write(text2) {
+    if (text2.length === 0) return;
+    this.buffer += text2;
+    this.clearTimer();
+    if (this.shouldFlush()) {
+      this.doFlush();
+      return;
+    }
+    this.timer = setTimeout(() => {
+      this.doFlush();
+    }, DEBOUNCE_MS);
+  }
+  /** Force-flush any buffered text. */
+  flush() {
+    this.clearTimer();
+    this.doFlush();
+  }
+  /** Flush remaining buffer and clean up. */
+  dispose() {
+    this.flush();
+  }
+  shouldFlush() {
+    if (this.buffer.includes("\n")) return true;
+    if (SENTENCE_BOUNDARY_RE.test(this.buffer)) return true;
+    if (this.buffer.length >= LENGTH_THRESHOLD) return true;
+    return false;
+  }
+  doFlush() {
+    if (this.buffer.length === 0) return;
+    const text2 = this.buffer;
+    this.buffer = "";
+    this.onFlush(text2);
+  }
+  clearTimer() {
+    if (this.timer !== null) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+};
+
+// src/Orchestrator.ts
+var IDLE_WARNING_INTERVAL_MS = 6e4;
+var invokeAgent = (sandbox, sandboxRepoDir, prompt, provider, idleTimeoutMs, completionTimeoutMs, completionSignals, onText, onToolCall, onIdleWarning, onCompletionTimeout, idleWarningIntervalMs = IDLE_WARNING_INTERVAL_MS, resumeSession, forkSession, signal) => Effect_exports.gen(function* () {
+  let resultText = "";
+  let sessionId;
+  let usage;
+  let accumulatedOutput = "";
+  const timeoutSignal = yield* Deferred_exports.make();
+  const completionTimeoutDeferred = yield* Deferred_exports.make();
+  let timeoutFiber = null;
+  let completionDetected = false;
+  let warningFiber = null;
+  let idleMinuteCounter = 0;
+  const interruptFiber = (fiber) => {
+    if (fiber !== null) Effect_exports.runFork(Fiber_exports.interrupt(fiber));
+  };
+  const startWarningInterval = () => {
+    interruptFiber(warningFiber);
+    idleMinuteCounter = 0;
+    warningFiber = Effect_exports.runFork(
+      Effect_exports.gen(function* () {
+        while (true) {
+          yield* Effect_exports.sleep(Duration_exports.millis(idleWarningIntervalMs));
+          idleMinuteCounter++;
+          onIdleWarning(idleMinuteCounter);
+        }
+      })
+    );
+  };
+  const resetTimer = () => {
+    interruptFiber(timeoutFiber);
+    if (completionDetected) {
+      timeoutFiber = Effect_exports.runFork(
+        Effect_exports.gen(function* () {
+          yield* Effect_exports.sleep(Duration_exports.millis(completionTimeoutMs));
+          onCompletionTimeout(completionTimeoutMs);
+          yield* Deferred_exports.succeed(completionTimeoutDeferred, {
+            result: resultText || accumulatedOutput,
+            sessionId,
+            usage
+          });
+        })
+      );
+    } else {
+      timeoutFiber = Effect_exports.runFork(
+        Effect_exports.gen(function* () {
+          yield* Effect_exports.sleep(Duration_exports.millis(idleTimeoutMs));
+          yield* Deferred_exports.fail(
+            timeoutSignal,
+            new AgentIdleTimeoutError({
+              message: `Agent idle for ${idleTimeoutMs / 1e3} seconds \u2014 no output received. Consider increasing the idle timeout with --idle-timeout.`,
+              timeoutMs: idleTimeoutMs
+            })
+          );
+        })
+      );
+      startWarningInterval();
+    }
+  };
+  const abortDeferred = yield* Deferred_exports.make();
+  let abortCleanup = null;
+  if (signal) {
+    if (signal.aborted) {
+      return yield* Effect_exports.die(signal.reason);
+    }
+    const onAbort = () => {
+      Effect_exports.runFork(Deferred_exports.die(abortDeferred, signal.reason));
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    abortCleanup = () => signal.removeEventListener("abort", onAbort);
+  }
+  resetTimer();
+  const execEffect = Effect_exports.gen(function* () {
+    const printCmd = provider.buildPrintCommand({
+      prompt,
+      dangerouslySkipPermissions: true,
+      resumeSession,
+      forkSession
+    });
+    const execResult = yield* sandbox.exec(printCmd.command, {
+      onLine: (line) => {
+        for (const parsed of provider.parseStreamLine(line)) {
+          if (parsed.type === "text") {
+            onText(parsed.text);
+            accumulatedOutput += parsed.text;
+          } else if (parsed.type === "result") {
+            resultText = parsed.result;
+            accumulatedOutput += parsed.result;
+          } else if (parsed.type === "tool_call") {
+            onToolCall(parsed.name, parsed.args);
+          } else if (parsed.type === "session_id") {
+            sessionId = parsed.sessionId;
+          } else if (parsed.type === "usage") {
+            usage = parsed.usage;
+          }
+        }
+        if (!completionDetected && completionSignals.some((sig) => accumulatedOutput.includes(sig))) {
+          completionDetected = true;
+          interruptFiber(warningFiber);
+          warningFiber = null;
+        }
+        resetTimer();
+      },
+      cwd: sandboxRepoDir,
+      stdin: printCmd.stdin
+    });
+    if (execResult.exitCode !== 0) {
+      let errorDetail = execResult.stderr;
+      if (!errorDetail.trim()) {
+        errorDetail = resultText;
+      }
+      if (!errorDetail.trim()) {
+        const lines = execResult.stdout.split("\n").filter((l) => l.trim());
+        errorDetail = lines.slice(-20).join("\n");
+      }
+      return yield* Effect_exports.fail(
+        new AgentError({
+          message: `${provider.name} exited with code ${execResult.exitCode}:
+${errorDetail}`
+        })
+      );
+    }
+    return { result: resultText || execResult.stdout, sessionId, usage };
+  }).pipe(
+    Effect_exports.ensuring(
+      Effect_exports.sync(() => {
+        interruptFiber(timeoutFiber);
+        timeoutFiber = null;
+        interruptFiber(warningFiber);
+        warningFiber = null;
+      })
+    )
+  );
+  let raced = Effect_exports.raceFirst(execEffect, Deferred_exports.await(timeoutSignal));
+  raced = Effect_exports.raceFirst(raced, Deferred_exports.await(completionTimeoutDeferred));
+  if (signal) {
+    raced = Effect_exports.raceFirst(
+      raced,
+      Deferred_exports.await(abortDeferred)
+    );
+  }
+  return yield* raced.pipe(
+    Effect_exports.ensuring(
+      Effect_exports.sync(() => {
+        abortCleanup?.();
+        interruptFiber(timeoutFiber);
+        timeoutFiber = null;
+        interruptFiber(warningFiber);
+        warningFiber = null;
+      })
+    )
+  );
+});
+var DEFAULT_COMPLETION_SIGNAL = "<promise>COMPLETE</promise>";
+var DEFAULT_IDLE_TIMEOUT_SECONDS = 10 * 60;
+var DEFAULT_COMPLETION_TIMEOUT_SECONDS = 60;
+var orchestrate = (options) => {
+  const idleTimeoutMs = (options.idleTimeoutSeconds ?? DEFAULT_IDLE_TIMEOUT_SECONDS) * 1e3;
+  const completionTimeoutMs = (options.completionTimeoutSeconds ?? DEFAULT_COMPLETION_TIMEOUT_SECONDS) * 1e3;
+  return Effect_exports.gen(function* () {
+    const factory = yield* SandboxFactory;
+    const display = yield* Display;
+    const streamEmitter = yield* AgentStreamEmitter;
+    const { hostRepoDir, iterations, hooks, prompt, branch, provider } = options;
+    let completionSignals;
+    if (options.completionSignal === void 0) {
+      completionSignals = [DEFAULT_COMPLETION_SIGNAL];
+    } else if (Array.isArray(options.completionSignal)) {
+      completionSignals = options.completionSignal;
+    } else {
+      completionSignals = [options.completionSignal];
+    }
+    const label = (msg) => options.name ? `[${options.name}] ${msg}` : msg;
+    const allCommits = [];
+    const allIterations = [];
+    let allStdout = "";
+    let resolvedBranch = "";
+    let iterationPreservedPath;
+    const checkAbort = () => options.signal?.aborted ? Effect_exports.die(options.signal.reason) : Effect_exports.void;
+    for (let i = 1; i <= iterations; i++) {
+      yield* checkAbort();
+      yield* display.status(label(`Iteration ${i}/${iterations}`), "info");
+      const sandboxResult = yield* factory.withSandbox(
+        ({ hostWorktreePath, sandboxRepoPath, applyToHost, bindMountHandle }, sandbox) => withSandboxLifecycle(
+          {
+            hostRepoDir,
+            sandboxRepoDir: sandboxRepoPath,
+            hooks,
+            branch,
+            hostWorktreePath,
+            applyToHost,
+            signal: options.signal,
+            timeouts: options.timeouts
+          },
+          sandbox,
+          (ctx) => Effect_exports.gen(function* () {
+            const iterationResumeSession = i === 1 ? options.resumeSession : void 0;
+            const iterationForkSession = i === 1 ? options.forkSession : void 0;
+            if (iterationResumeSession && bindMountHandle && provider.sessionStorage) {
+              yield* display.status(label("Resuming session"), "info");
+              yield* Effect_exports.tryPromise({
+                try: () => provider.sessionStorage.resumeIntoSandbox({
+                  hostCwd: hostRepoDir,
+                  sandboxCwd: ctx.sandboxRepoDir,
+                  sessionId: iterationResumeSession,
+                  handle: bindMountHandle
+                }),
+                catch: (e) => new SessionCaptureError({
+                  message: `Session resume failed: ${e instanceof Error ? e.message : String(e)}`,
+                  sessionId: iterationResumeSession
+                })
+              });
+            }
+            const fullPrompt = options.skipPromptExpansion ? prompt : yield* preprocessPrompt(
+              prompt,
+              ctx.sandbox,
+              ctx.sandboxRepoDir
+            );
+            yield* display.status(label("Agent started"), "success");
+            const textBuffer = new TextDeltaBuffer((chunk) => {
+              Effect_exports.runPromise(display.text(chunk));
+              Effect_exports.runPromise(
+                streamEmitter.emit({
+                  type: "text",
+                  message: chunk,
+                  iteration: i,
+                  timestamp: /* @__PURE__ */ new Date()
+                })
+              );
+            });
+            const onText = (text2) => {
+              textBuffer.write(text2);
+            };
+            const onToolCall = (name, formattedArgs) => {
+              textBuffer.flush();
+              Effect_exports.runPromise(display.toolCall(name, formattedArgs));
+              Effect_exports.runPromise(
+                streamEmitter.emit({
+                  type: "toolCall",
+                  name,
+                  formattedArgs,
+                  iteration: i,
+                  timestamp: /* @__PURE__ */ new Date()
+                })
+              );
+            };
+            const onIdleWarning = (minutes) => {
+              const msg = minutes === 1 ? "Agent idle for 1 minute" : `Agent idle for ${minutes} minutes`;
+              Effect_exports.runPromise(display.status(label(msg), "warn"));
+            };
+            const onCompletionTimeout = (timeoutMs) => {
+              Effect_exports.runPromise(
+                display.status(
+                  label(
+                    `Completion signal seen but agent process is hanging \u2014 force-completing after ${timeoutMs / 1e3}s grace window.`
+                  ),
+                  "warn"
+                )
+              );
+            };
+            const {
+              result: agentOutput,
+              sessionId,
+              usage: streamUsage
+            } = yield* invokeAgent(
+              ctx.sandbox,
+              ctx.sandboxRepoDir,
+              fullPrompt,
+              provider,
+              idleTimeoutMs,
+              completionTimeoutMs,
+              completionSignals,
+              onText,
+              onToolCall,
+              onIdleWarning,
+              onCompletionTimeout,
+              options._idleWarningIntervalMs,
+              iterationResumeSession,
+              iterationForkSession,
+              options.signal
+            );
+            textBuffer.dispose();
+            yield* display.status(label("Agent stopped"), "info");
+            let sessionFilePath;
+            let usage = streamUsage;
+            if (provider.captureSessions && provider.sessionStorage && sessionId && bindMountHandle) {
+              yield* display.status(label("Capturing session"), "info");
+              yield* Effect_exports.tryPromise({
+                try: () => provider.sessionStorage.captureToHost({
+                  hostCwd: hostRepoDir,
+                  sandboxCwd: ctx.sandboxRepoDir,
+                  sessionId,
+                  handle: bindMountHandle
+                }),
+                catch: (e) => new SessionCaptureError({
+                  message: `Session capture failed: ${e instanceof Error ? e.message : String(e)}`,
+                  sessionId
+                })
+              });
+              sessionFilePath = provider.sessionStorage.hostSessionFilePath(
+                hostRepoDir,
+                sessionId
+              );
+              if (provider.parseSessionUsage) {
+                const content = yield* Effect_exports.promise(
+                  () => provider.sessionStorage.readHostSession(hostRepoDir, sessionId).catch(() => void 0)
+                );
+                if (content) {
+                  const parsedUsage = provider.parseSessionUsage(content);
+                  if (parsedUsage) usage = parsedUsage;
+                }
+              }
+            }
+            const matchedSignal = completionSignals.find(
+              (sig) => agentOutput.includes(sig)
+            );
+            return {
+              completionSignal: matchedSignal,
+              stdout: agentOutput,
+              sessionId,
+              sessionFilePath,
+              usage
+            };
+          })
+        )
+      );
+      const lifecycleResult = sandboxResult.value;
+      iterationPreservedPath = sandboxResult.preservedWorktreePath;
+      allCommits.push(...lifecycleResult.commits);
+      allStdout += lifecycleResult.result.stdout;
+      resolvedBranch = lifecycleResult.branch;
+      allIterations.push({
+        sessionId: lifecycleResult.result.sessionId,
+        sessionFilePath: lifecycleResult.result.sessionFilePath,
+        usage: lifecycleResult.result.usage
+      });
+      if (lifecycleResult.result.completionSignal !== void 0) {
+        yield* display.status(
+          label(`Agent signaled completion after ${i} iteration(s).`),
+          "success"
+        );
+        return {
+          iterations: allIterations,
+          completionSignal: lifecycleResult.result.completionSignal,
+          stdout: allStdout,
+          commits: allCommits,
+          branch: resolvedBranch,
+          preservedWorktreePath: iterationPreservedPath
+        };
+      }
+    }
+    yield* display.status(
+      label(`Reached max iterations (${iterations}).`),
+      "info"
+    );
+    return {
+      iterations: allIterations,
+      completionSignal: void 0,
+      stdout: allStdout,
+      commits: allCommits,
+      branch: resolvedBranch,
+      preservedWorktreePath: iterationPreservedPath
+    };
+  });
+};
+
+// src/PromptResolver.ts
+var resolvePrompt = (options) => {
+  const { prompt, promptFile } = options;
+  if (prompt !== void 0 && promptFile !== void 0) {
+    return Effect_exports.fail(
+      new PromptError({
+        message: "Cannot provide both --prompt and --prompt-file"
+      })
+    );
+  }
+  if (prompt !== void 0) {
+    return Effect_exports.succeed({ text: prompt, source: "inline" });
+  }
+  if (promptFile === void 0) {
+    return Effect_exports.fail(
+      new PromptError({
+        message: "Must provide either prompt or promptFile. Pass prompt: '...' or promptFile: './.sandcastle/prompt.md' to run()."
+      })
+    );
+  }
+  return Effect_exports.gen(function* () {
+    const fs = yield* FileSystem_exports.FileSystem;
+    const text2 = yield* fs.readFileString(promptFile).pipe(
+      Effect_exports.catchAll(
+        (e) => Effect_exports.fail(
+          new PromptError({
+            message: `Failed to read prompt from ${promptFile}: ${e}`
+          })
+        )
+      )
+    );
+    return { text: text2, source: "template" };
+  });
+};
+var parseEnvFile = (filePath) => Effect_exports.gen(function* () {
+  const fs = yield* FileSystem_exports.FileSystem;
+  const content = yield* fs.readFileString(filePath).pipe(Effect_exports.catchAll(() => Effect_exports.succeed(null)));
+  if (content === null) return {};
+  const vars = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    let value = trimmed.slice(eqIndex + 1).trim();
+    const isDoubleQuoted = value.length >= 2 && value[0] === '"' && value[value.length - 1] === '"';
+    const isSingleQuoted = value.length >= 2 && value[0] === "'" && value[value.length - 1] === "'";
+    if (isDoubleQuoted || isSingleQuoted) {
+      value = value.slice(1, -1);
+    }
+    if (isDoubleQuoted) {
+      value = value.replace(/\\([nrt\\])/g, (_, ch) => {
+        const escapes = {
+          n: "\n",
+          r: "\r",
+          t: "	",
+          "\\": "\\"
+        };
+        return escapes[ch] ?? ch;
+      });
+    }
+    vars[key] = value;
+  }
+  return vars;
+});
+var resolveEnv = (repoDir) => Effect_exports.gen(function* () {
+  const sandcastleEnv = yield* parseEnvFile(
+    join(repoDir, ".sandcastle", ".env")
+  );
+  const result = {};
+  for (const key of Object.keys(sandcastleEnv)) {
+    const value = sandcastleEnv[key] || process.env[key];
+    if (value) {
+      result[key] = value;
+    }
+  }
+  return result;
+});
+
+// src/mergeProviderEnv.ts
+var mergeProviderEnv = (options) => {
+  const { resolvedEnv, agentProviderEnv, sandboxProviderEnv } = options;
+  const agentKeys = Object.keys(agentProviderEnv);
+  const sandboxKeys = new Set(Object.keys(sandboxProviderEnv));
+  const overlapping = agentKeys.filter((k) => sandboxKeys.has(k));
+  if (overlapping.length > 0) {
+    throw new Error(
+      `Overlapping env keys between agent provider and sandbox provider: ${overlapping.join(", ")}`
+    );
+  }
+  return {
+    ...resolvedEnv,
+    ...sandboxProviderEnv,
+    ...agentProviderEnv
+  };
+};
+
+// src/PromptArgumentSubstitution.ts
+var SHELL_BLOCK_PATTERN = /!`([^`]+)`/g;
+var BUILT_IN_PROMPT_ARG_KEYS = [
+  "SOURCE_BRANCH",
+  "TARGET_BRANCH"
+];
+var PLACEHOLDER_PATTERN = /\{\{\s*([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+var validateNoArgsWithInlinePrompt = (args) => {
+  if (Object.keys(args).length === 0) return Effect_exports.void;
+  return Effect_exports.fail(
+    new PromptError({
+      message: 'promptArgs is only supported with promptFile. Inline prompts (prompt: "...") are passed to the agent as-is \u2014 interpolate values directly in JavaScript, or switch to promptFile to use {{KEY}} substitution.'
+    })
+  );
+};
+var validateNoBuiltInArgOverride = (args) => {
+  for (const key of BUILT_IN_PROMPT_ARG_KEYS) {
+    if (key in args) {
+      return Effect_exports.fail(
+        new PromptError({
+          message: `"${key}" is a built-in prompt argument and cannot be overridden via promptArgs`
+        })
+      );
+    }
+  }
+  return Effect_exports.void;
+};
+var findMissingPromptArgKeys = (prompt, providedArgs) => {
+  const matches = [...prompt.matchAll(PLACEHOLDER_PATTERN)];
+  const builtInSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+  const seen = /* @__PURE__ */ new Set();
+  const missing = [];
+  for (const m of matches) {
+    const key = m[1];
+    if (seen.has(key)) continue;
+    seen.add(key);
+    if (builtInSet.has(key)) continue;
+    if (key in providedArgs) continue;
+    missing.push(key);
+  }
+  return missing;
+};
+var substitutePromptArgs = (prompt, args, silentKeys) => {
+  const markedPrompt = prompt.replaceAll(SHELL_BLOCK_MARKER, "").replace(SHELL_BLOCK_PATTERN, `!${SHELL_BLOCK_MARKER}\`$1\``);
+  const sanitizedArgs = Object.fromEntries(
+    Object.entries(args).map(([key, value]) => [
+      key,
+      typeof value === "string" ? value.replaceAll(SHELL_BLOCK_MARKER, "") : value
+    ])
+  );
+  const matches = [...markedPrompt.matchAll(PLACEHOLDER_PATTERN)];
+  if (matches.length === 0 && Object.keys(sanitizedArgs).length === 0) {
+    return Effect_exports.succeed(markedPrompt);
+  }
+  return Effect_exports.gen(function* () {
+    const display = yield* Display;
+    const referencedKeys = new Set(matches.map((m) => m[1]));
+    for (const key of referencedKeys) {
+      if (!(key in sanitizedArgs)) {
+        return yield* Effect_exports.fail(
+          new PromptError({
+            message: `Prompt argument "{{${key}}}" has no matching value in promptArgs`
+          })
+        );
+      }
+    }
+    for (const key of Object.keys(sanitizedArgs)) {
+      if (!referencedKeys.has(key) && !silentKeys?.has(key)) {
+        yield* display.status(
+          `Prompt argument "${key}" was provided but not referenced in the prompt`,
+          "warn"
+        );
+      }
+    }
+    const result = markedPrompt.replace(
+      PLACEHOLDER_PATTERN,
+      (_match, key) => sanitizedArgs[key].toString()
+    );
+    return result;
+  });
+};
+
+// src/Output.ts
+var Output = {
+  /**
+   * Declare an object-typed structured output extracted from an XML tag in
+   * the agent's stdout. The tag contents are JSON-parsed (with fence-aware
+   * unwrapping) and validated against the provided Standard Schema validator.
+   */
+  object: (opts) => ({
+    _tag: "object",
+    tag: opts.tag,
+    schema: opts.schema
+  }),
+  /**
+   * Declare a string-typed structured output extracted from an XML tag in
+   * the agent's stdout. The tag contents are whitespace-trimmed and returned
+   * as a plain string — no JSON parsing, no schema validation.
+   */
+  string: (opts) => ({
+    _tag: "string",
+    tag: opts.tag
+  })
+};
+var StructuredOutputError = class extends Error {
+  tag;
+  rawMatched;
+  cause;
+  commits;
+  branch;
+  preservedWorktreePath;
+  /** Session ID of the iteration that produced the bad output, when available. */
+  sessionId;
+  /** Host path to the captured session JSONL, when the session was captured. */
+  sessionFilePath;
+  constructor(message, options) {
+    super(message);
+    this.name = "StructuredOutputError";
+    this.tag = options.tag;
+    this.rawMatched = options.rawMatched;
+    this.cause = options.cause;
+    this.commits = options.commits;
+    this.branch = options.branch;
+    this.preservedWorktreePath = options.preservedWorktreePath;
+    this.sessionId = options.sessionId;
+    this.sessionFilePath = options.sessionFilePath;
+  }
+};
+
+// src/extractStructuredOutput.ts
+var extractStructuredOutput = async (stdout, definition, context) => {
+  if (definition._tag === "object") {
+    return extractObject(
+      stdout,
+      definition,
+      context
+    );
+  }
+  return extractString(stdout, definition, context);
+};
+var extractObject = async (stdout, definition, context) => {
+  const raw = findLastTagContent(stdout, definition.tag);
+  if (raw === void 0) {
+    throw new StructuredOutputError(
+      `Structured output tag <${definition.tag}> not found in agent output`,
+      { tag: definition.tag, rawMatched: void 0, ...context }
+    );
+  }
+  const unwrapped = unwrapFences(raw.trim());
+  let parsed;
+  try {
+    parsed = JSON.parse(unwrapped);
+  } catch (cause) {
+    throw new StructuredOutputError(
+      `Structured output tag <${definition.tag}> contains invalid JSON`,
+      { tag: definition.tag, rawMatched: raw, cause, ...context }
+    );
+  }
+  const result = await definition.schema["~standard"].validate(parsed);
+  if (result.issues) {
+    throw new StructuredOutputError(
+      `Structured output tag <${definition.tag}> failed schema validation`,
+      {
+        tag: definition.tag,
+        rawMatched: raw,
+        cause: result.issues,
+        ...context
+      }
+    );
+  }
+  return result.value;
+};
+var extractString = (stdout, definition, context) => {
+  const raw = findLastTagContent(stdout, definition.tag);
+  if (raw === void 0) {
+    throw new StructuredOutputError(
+      `Structured output tag <${definition.tag}> not found in agent output`,
+      { tag: definition.tag, rawMatched: void 0, ...context }
+    );
+  }
+  return raw.trim();
+};
+var findLastTagContent = (text2, tag) => {
+  const openTag = `<${tag}>`;
+  const closeTag = `</${tag}>`;
+  let lastContent;
+  let searchFrom = 0;
+  while (true) {
+    const openIdx = text2.indexOf(openTag, searchFrom);
+    if (openIdx === -1) break;
+    const contentStart = openIdx + openTag.length;
+    const closeIdx = text2.indexOf(closeTag, contentStart);
+    if (closeIdx === -1) break;
+    lastContent = text2.slice(contentStart, closeIdx);
+    searchFrom = closeIdx + closeTag.length;
+  }
+  return lastContent;
+};
+var unwrapFences = (text2) => {
+  const fenceMatch = text2.match(/^```(?:json)?\s*\n([\s\S]*?)\n\s*```\s*$/);
+  if (fenceMatch) {
+    return fenceMatch[1].trim();
+  }
+  return text2;
+};
+
+// src/run.ts
+var DEFAULT_MAX_ITERATIONS = 1;
+var sanitizeBranchForFilename = (branch) => branch.replace(/[/\\:*?"<>|]/g, "-");
+var printFileDisplayStartup = (options) => {
+  const name = options.agentName ?? "Agent";
+  const label = styleText("bold", `[${name}]`);
+  const branchPart = options.branch ? ` on branch ${options.branch}` : "";
+  const hostRepoDir = options.hostRepoDir ?? process.cwd();
+  const displayLogPath = hostRepoDir === process.cwd() ? path.relative(process.cwd(), options.logPath) : options.logPath;
+  console.log(`${label} Started${branchPart}`);
+  console.log(styleText("dim", `  tail -f ${displayLogPath}`));
+};
+var buildLogFilename = (resolvedBranch, targetBranch, name) => {
+  const sanitized = sanitizeBranchForFilename(resolvedBranch);
+  const nameSuffix = name ? `-${name.toLowerCase().replace(/[^a-z0-9_.-]/g, "-")}` : "";
+  if (targetBranch) {
+    return `${sanitizeBranchForFilename(targetBranch)}-${sanitized}${nameSuffix}.log`;
+  }
+  return `${sanitized}${nameSuffix}.log`;
+};
+var buildRunSummaryRows = (options) => ({
+  Agent: options.name ?? options.agentName,
+  Sandbox: options.sandboxName,
+  "Max iterations": String(options.maxIterations),
+  Branch: options.branch
+});
+var buildCompletionMessage = (completionSignal, iterationsRun) => {
+  if (completionSignal !== void 0) {
+    return {
+      message: `Run complete: agent finished after ${iterationsRun} iteration(s).`,
+      severity: "success"
+    };
+  }
+  return {
+    message: `Run complete: reached ${iterationsRun} iteration(s) without completion signal.`,
+    severity: "warn"
+  };
+};
+var formatContextWindowSize = (usage) => {
+  const total = usage.inputTokens + usage.cacheCreationInputTokens + usage.cacheReadInputTokens;
+  return `${Math.ceil(total / 1e3)}k`;
+};
+var buildContextWindowLines = (iterations) => iterations.filter((it) => it.usage !== void 0).map((it) => `Context window: ${formatContextWindowSize(it.usage)}`);
+async function run(options) {
+  options.signal?.throwIfAborted();
+  const {
+    prompt,
+    promptFile,
+    maxIterations = DEFAULT_MAX_ITERATIONS,
+    hooks,
+    agent: provider
+  } = options;
+  const branchStrategy = options.branchStrategy ?? (options.sandbox.tag === "isolated" ? { type: "merge-to-head" } : { type: "head" });
+  const effectiveBranchType = branchStrategy.type;
+  if (effectiveBranchType === "head" && options.sandbox.tag === "isolated") {
+    throw new Error(
+      "head branch strategy is not supported with isolated providers"
+    );
+  }
+  if (effectiveBranchType === "head" && options.copyToWorktree && options.copyToWorktree.length > 0) {
+    throw new Error(
+      "copyToWorktree is not supported with head branch strategy. In head mode the host working directory is bind-mounted directly."
+    );
+  }
+  if (options.resumeSession && maxIterations > 1) {
+    throw new Error(
+      "resumeSession cannot be combined with maxIterations > 1. Resume applies to iteration 1 only; multi-iteration resume semantics are not supported."
+    );
+  }
+  if (options.forkSession && !options.resumeSession) {
+    throw new Error(
+      "forkSession requires resumeSession. Use RunResult.fork(prompt) to fork the last captured session."
+    );
+  }
+  if (options.output && maxIterations !== 1) {
+    throw new Error(
+      "output requires maxIterations to be 1. Structured output is only supported for single-iteration runs."
+    );
+  }
+  const branch = branchStrategy.type === "branch" ? branchStrategy.branch : void 0;
+  const hostRepoDir = await Effect_exports.runPromise(
+    resolveCwd(options.cwd).pipe(Effect_exports.provide(NodeContext_exports.layer))
+  );
+  if (options.resumeSession) {
+    await assertResumeSessionExists({
+      provider,
+      sandboxTag: options.sandbox.tag,
+      hostRepoDir,
+      resumeSession: options.resumeSession
+    });
+  }
+  const resolved = await Effect_exports.runPromise(
+    resolvePrompt({ prompt, promptFile }).pipe(
+      Effect_exports.provide(NodeContext_exports.layer)
+    )
+  );
+  const rawPrompt = resolved.text;
+  const isInlinePrompt = resolved.source === "inline";
+  if (options.output) {
+    const openTag = `<${options.output.tag}>`;
+    if (!rawPrompt.includes(openTag)) {
+      throw new Error(
+        `output tag <${options.output.tag}> not found in the resolved prompt. The caller must instruct the agent to emit the configured tag.`
+      );
+    }
+  }
+  const agentName = provider.name;
+  const resolvedEnv = await Effect_exports.runPromise(
+    resolveEnv(hostRepoDir).pipe(Effect_exports.provide(NodeContext_exports.layer))
+  );
+  const env = mergeProviderEnv({
+    resolvedEnv,
+    agentProviderEnv: provider.env,
+    sandboxProviderEnv: options.sandbox.env
+  });
+  const currentHostBranch = await Effect_exports.runPromise(
+    getCurrentBranch(hostRepoDir)
+  );
+  const resolvedBranch = effectiveBranchType === "head" ? currentHostBranch : branch ?? generateTempBranchName(options.name);
+  const targetBranch = effectiveBranchType === "merge-to-head" ? currentHostBranch : void 0;
+  const resolvedLogging = options.logging ?? {
+    type: "file",
+    path: join(
+      hostRepoDir,
+      ".sandcastle",
+      "logs",
+      buildLogFilename(resolvedBranch, targetBranch, options.name)
+    )
+  };
+  const displayLayer = resolvedLogging.type === "file" ? (() => {
+    printFileDisplayStartup({
+      logPath: resolvedLogging.path,
+      agentName: options.name,
+      branch: resolvedBranch,
+      hostRepoDir
+    });
+    return Layer_exports.provide(
+      FileDisplay.layer(resolvedLogging.path),
+      NodeFileSystem_exports.layer
+    );
+  })() : ClackDisplay.layer;
+  const factoryLayer = Layer_exports.provide(
+    WorktreeDockerSandboxFactory.layer,
+    Layer_exports.mergeAll(
+      Layer_exports.succeed(SandboxConfig, {
+        env,
+        hostRepoDir,
+        copyToWorktree: options.copyToWorktree,
+        name: options.name,
+        sandboxProvider: options.sandbox,
+        branchStrategy,
+        hooks,
+        signal: options.signal,
+        timeouts: options.timeouts
+      }),
+      NodeFileSystem_exports.layer,
+      displayLayer
+    )
+  );
+  const streamEmitterLayer = agentStreamEmitterLayer(
+    resolvedLogging.type === "file" ? resolvedLogging.onAgentStreamEvent : void 0
+  );
+  const runLayer = Layer_exports.mergeAll(
+    factoryLayer,
+    displayLayer,
+    streamEmitterLayer
+  );
+  const baseEffect = Effect_exports.gen(function* () {
+    const d = yield* Display;
+    yield* d.intro(options.name ?? "sandcastle");
+    const rows = buildRunSummaryRows({
+      name: options.name,
+      agentName,
+      sandboxName: options.sandbox.name,
+      maxIterations,
+      branch: resolvedBranch
+    });
+    yield* d.summary("Sandcastle Run", rows);
+    const userArgs = options.promptArgs ?? {};
+    let resolvedPrompt;
+    if (isInlinePrompt) {
+      yield* validateNoArgsWithInlinePrompt(userArgs);
+      resolvedPrompt = rawPrompt;
+    } else {
+      yield* validateNoBuiltInArgOverride(userArgs);
+      const effectiveArgs = {
+        SOURCE_BRANCH: resolvedBranch,
+        TARGET_BRANCH: currentHostBranch,
+        ...userArgs
+      };
+      const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+      resolvedPrompt = yield* substitutePromptArgs(
+        rawPrompt,
+        effectiveArgs,
+        builtInArgKeysSet
+      );
+    }
+    const orchestrateBranch = effectiveBranchType === "head" ? currentHostBranch : branch;
+    const orchestrateResult = yield* orchestrate({
+      hostRepoDir,
+      iterations: maxIterations,
+      hooks,
+      prompt: resolvedPrompt,
+      branch: orchestrateBranch,
+      provider,
+      completionSignal: options.completionSignal,
+      idleTimeoutSeconds: options.idleTimeoutSeconds,
+      completionTimeoutSeconds: options.completionTimeoutSeconds,
+      name: options.name,
+      resumeSession: options.resumeSession,
+      forkSession: options.forkSession,
+      signal: options.signal,
+      skipPromptExpansion: isInlinePrompt,
+      timeouts: options.timeouts
+    });
+    const completion = buildCompletionMessage(
+      orchestrateResult.completionSignal,
+      orchestrateResult.iterations.length
+    );
+    yield* d.status(completion.message, completion.severity);
+    for (const line of buildContextWindowLines(orchestrateResult.iterations)) {
+      yield* d.text(line);
+    }
+    return orchestrateResult;
+  });
+  const withErrorLog = resolvedLogging.type === "file" ? baseEffect.pipe(
+    Effect_exports.tapError(
+      (error) => Effect_exports.gen(function* () {
+        const d = yield* Display;
+        yield* d.status(
+          formatErrorMessage(error),
+          "error"
+        );
+      })
+    )
+  ) : baseEffect;
+  let result;
+  try {
+    result = await Effect_exports.runPromise(
+      withErrorLog.pipe(Effect_exports.provide(runLayer))
+    );
+  } catch (error) {
+    options.signal?.throwIfAborted();
+    throw error;
+  }
+  const baseResult = {
+    ...result,
+    logFilePath: resolvedLogging.type === "file" ? resolvedLogging.path : void 0,
+    resume: async (prompt2, resumeOptions) => {
+      const lastIteration = result.iterations.at(-1);
+      if (!lastIteration?.sessionId) {
+        throw new Error("Cannot resume: no sessionId was captured");
+      }
+      return run({
+        ...options,
+        ...resumeOptions,
+        prompt: prompt2,
+        promptFile: void 0,
+        maxIterations: 1,
+        resumeSession: lastIteration.sessionId
+      });
+    },
+    fork: async (prompt2, forkOptions) => {
+      const lastIteration = result.iterations.at(-1);
+      if (!lastIteration?.sessionId) {
+        throw new Error("Cannot fork: no sessionId was captured");
+      }
+      return run({
+        ...options,
+        ...forkOptions,
+        prompt: prompt2,
+        promptFile: void 0,
+        maxIterations: 1,
+        resumeSession: lastIteration.sessionId,
+        forkSession: true
+      });
+    }
+  };
+  if (options.output) {
+    const lastIteration = baseResult.iterations.at(-1);
+    const output = await extractStructuredOutput(
+      baseResult.stdout,
+      options.output,
+      {
+        commits: baseResult.commits,
+        branch: baseResult.branch,
+        preservedWorktreePath: baseResult.preservedWorktreePath,
+        sessionId: lastIteration?.sessionId,
+        sessionFilePath: lastIteration?.sessionFilePath
+      }
+    );
+    return { ...baseResult, output };
+  }
+  return baseResult;
+}
+
+// src/raceAbortSignal.ts
+var raceAbortSignal = (effect, signal) => {
+  if (!signal) return effect;
+  return Effect_exports.gen(function* () {
+    if (signal.aborted) {
+      return yield* Effect_exports.die(signal.reason);
+    }
+    const abortDeferred = yield* Deferred_exports.make();
+    const onAbort = () => {
+      Effect_exports.runPromise(Deferred_exports.die(abortDeferred, signal.reason)).catch(
+        () => {
+        }
+      );
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    return yield* Effect_exports.raceFirst(
+      effect,
+      Deferred_exports.await(abortDeferred)
+    ).pipe(
+      Effect_exports.ensuring(
+        Effect_exports.sync(() => signal.removeEventListener("abort", onAbort))
+      )
+    );
+  });
+};
+
+// src/interactive.ts
+var interactive = async (options) => {
+  options.signal?.throwIfAborted();
+  const { prompt, promptFile, hooks, agent: provider } = options;
+  const resolvedSandbox = options.sandbox ?? noSandbox();
+  const branchStrategy = options.branchStrategy ?? (resolvedSandbox.tag === "isolated" ? { type: "merge-to-head" } : { type: "head" });
+  if (branchStrategy.type === "head" && resolvedSandbox.tag === "isolated") {
+    throw new Error(
+      "head branch strategy is not supported with isolated providers"
+    );
+  }
+  if (branchStrategy.type === "head" && options.copyToWorktree && options.copyToWorktree.length > 0) {
+    throw new Error(
+      "copyToWorktree is not supported with head branch strategy. In head mode the host working directory is bind-mounted directly."
+    );
+  }
+  if (!provider.buildInteractiveArgs) {
+    throw new Error(
+      `Agent provider "${provider.name}" does not support buildInteractiveArgs, required for interactive sessions.`
+    );
+  }
+  const branch = branchStrategy.type === "branch" ? branchStrategy.branch : void 0;
+  const isHeadMode = branchStrategy.type === "head";
+  const sandboxProvider = resolvedSandbox;
+  const inner = Effect_exports.gen(function* () {
+    const hostRepoDir = yield* resolveCwd(options.cwd);
+    const d = yield* Display;
+    const hasPromptSource = prompt !== void 0 || promptFile !== void 0;
+    const resolved = hasPromptSource ? yield* resolvePrompt({ prompt, promptFile }) : void 0;
+    const rawPrompt = resolved?.text ?? "";
+    const isInlinePrompt = resolved?.source === "inline";
+    const resolvedEnv = yield* resolveEnv(hostRepoDir);
+    const env = mergeProviderEnv({
+      resolvedEnv,
+      agentProviderEnv: provider.env,
+      sandboxProviderEnv: sandboxProvider.env
+    });
+    const effectiveEnv = { ...env, ...options.env ?? {} };
+    const currentHostBranch = yield* getCurrentBranch(hostRepoDir);
+    const resolvedBranch = branchStrategy.type === "head" ? currentHostBranch : branch ?? generateTempBranchName(options.name);
+    let substitutedPrompt = rawPrompt;
+    if (hasPromptSource && !isInlinePrompt) {
+      const userArgs = options.promptArgs ?? {};
+      yield* validateNoBuiltInArgOverride(userArgs);
+      const missingKeys = findMissingPromptArgKeys(rawPrompt, userArgs);
+      const collectedArgs = {};
+      for (const key of missingKeys) {
+        const value = yield* Effect_exports.promise(
+          () => clack.text({
+            message: `Enter value for {{${key}}}`,
+            validate: (v) => {
+              if (!v) return `A value is required for {{${key}}}`;
+            }
+          })
+        );
+        if (clack.isCancel(value)) {
+          clack.cancel("Prompt arg collection cancelled.");
+          return yield* Effect_exports.fail(
+            new Error("User cancelled prompt arg collection")
+          );
+        }
+        collectedArgs[key] = value;
+      }
+      const mergedUserArgs = { ...userArgs, ...collectedArgs };
+      const effectiveArgs = {
+        SOURCE_BRANCH: resolvedBranch,
+        TARGET_BRANCH: currentHostBranch,
+        ...mergedUserArgs
+      };
+      const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+      substitutedPrompt = yield* substitutePromptArgs(
+        rawPrompt,
+        effectiveArgs,
+        builtInArgKeysSet
+      );
+    } else if (isInlinePrompt) {
+      const userArgs = options.promptArgs ?? {};
+      yield* validateNoArgsWithInlinePrompt(userArgs);
+    }
+    const lifecycleBranch = isHeadMode ? currentHostBranch : branch;
+    yield* d.intro(options.name ?? "sandcastle interactive");
+    yield* d.summary("Interactive Session", {
+      Agent: options.name ?? provider.name,
+      Sandbox: sandboxProvider.name,
+      Branch: resolvedBranch
+    });
+    let worktreeInfo;
+    if (!isHeadMode) {
+      worktreeInfo = yield* d.taskLog(
+        "Creating worktree",
+        () => pruneStale(hostRepoDir).pipe(
+          Effect_exports.catchAll(() => Effect_exports.void),
+          Effect_exports.andThen(
+            branch ? create(hostRepoDir, { branch }) : create(hostRepoDir, { name: options.name })
+          )
+        )
+      );
+    }
+    const handle = yield* Effect_exports.gen(function* () {
+      if (!isHeadMode) {
+        if ((sandboxProvider.tag === "bind-mount" || sandboxProvider.tag === "none") && options.copyToWorktree && options.copyToWorktree.length > 0) {
+          yield* d.taskLog(
+            "Copying files to worktree",
+            () => copyToWorktree(
+              options.copyToWorktree,
+              hostRepoDir,
+              worktreeInfo.path,
+              options.timeouts?.copyToWorktreeMs
+            )
+          );
+        }
+        if (hooks?.host?.onWorktreeReady?.length) {
+          yield* runHostHooks(hooks.host.onWorktreeReady, worktreeInfo.path);
+        }
+      } else if (hooks?.host?.onWorktreeReady?.length) {
+        yield* runHostHooks(hooks.host.onWorktreeReady, hostRepoDir);
+      }
+      if (sandboxProvider.tag === "none") {
+        const worktreePath = isHeadMode ? hostRepoDir : worktreeInfo.path;
+        return yield* Effect_exports.promise(
+          () => sandboxProvider.create({
+            worktreePath,
+            env: effectiveEnv
+          })
+        );
+      } else if (sandboxProvider.tag === "isolated") {
+        const startResult = yield* d.taskLog(
+          "Starting sandbox",
+          () => startSandbox({
+            provider: sandboxProvider,
+            hostRepoDir: worktreeInfo.path,
+            env: effectiveEnv,
+            copyPaths: options.copyToWorktree
+          })
+        );
+        return startResult.handle;
+      } else {
+        const gitPath = join(hostRepoDir, ".git");
+        const gitMounts = yield* resolveGitMounts(gitPath);
+        const startResult = yield* d.taskLog(
+          "Starting sandbox",
+          () => startSandbox({
+            provider: sandboxProvider,
+            hostRepoDir,
+            env: effectiveEnv,
+            worktreeOrRepoPath: isHeadMode ? hostRepoDir : worktreeInfo.path,
+            gitMounts,
+            repoDir: SANDBOX_REPO_DIR
+          })
+        );
+        return startResult.handle;
+      }
+    }).pipe(
+      Effect_exports.tapError(
+        () => worktreeInfo ? remove(worktreeInfo.path).pipe(
+          Effect_exports.catchAll(() => Effect_exports.void)
+        ) : Effect_exports.void
+      )
+    );
+    return yield* Effect_exports.gen(function* () {
+      if (!handle.interactiveExec) {
+        throw new Error(
+          `Sandbox provider does not support interactiveExec. The provider must implement the optional interactiveExec method to use interactive().`
+        );
+      }
+      const interactiveExecFn = handle.interactiveExec.bind(handle);
+      const sandbox = makeSandboxFromHandle(handle);
+      const worktreePath = handle.worktreePath;
+      const applyToHost = sandboxProvider.tag === "isolated" && worktreeInfo ? () => syncOut(worktreeInfo.path, handle) : () => Effect_exports.void;
+      const lifecycleEffect = withSandboxLifecycle(
+        {
+          hostRepoDir,
+          sandboxRepoDir: worktreePath,
+          hooks,
+          branch: lifecycleBranch,
+          hostWorktreePath: isHeadMode ? hostRepoDir : worktreeInfo?.path,
+          applyToHost,
+          timeouts: options.timeouts
+        },
+        sandbox,
+        (ctx) => Effect_exports.gen(function* () {
+          const fullPrompt = !hasPromptSource || isInlinePrompt ? substitutedPrompt : yield* preprocessPrompt(
+            substitutedPrompt,
+            ctx.sandbox,
+            ctx.sandboxRepoDir
+          );
+          const interactiveArgs = provider.buildInteractiveArgs({
+            prompt: fullPrompt,
+            dangerouslySkipPermissions: sandboxProvider.tag !== "none"
+          });
+          const result2 = yield* raceAbortSignal(
+            Effect_exports.promise(
+              () => interactiveExecFn(interactiveArgs, {
+                stdin: process.stdin,
+                stdout: process.stdout,
+                stderr: process.stderr,
+                cwd: worktreePath
+              })
+            ),
+            options.signal
+          );
+          return result2.exitCode;
+        })
+      );
+      const lifecycleResult = yield* lifecycleEffect;
+      const exitCode = lifecycleResult.result;
+      let preservedWorktreePath;
+      if (worktreeInfo) {
+        const hasUncommitted = yield* hasUncommittedChanges(
+          worktreeInfo.path
+        ).pipe(Effect_exports.catchAll(() => Effect_exports.succeed(false)));
+        if (hasUncommitted) {
+          preservedWorktreePath = worktreeInfo.path;
+        }
+      }
+      if (worktreeInfo && !preservedWorktreePath) {
+        yield* remove(worktreeInfo.path).pipe(
+          Effect_exports.catchAll(() => Effect_exports.void)
+        );
+      }
+      yield* d.summary("Session Complete", {
+        Commits: String(lifecycleResult.commits.length),
+        Branch: lifecycleResult.branch,
+        "Exit code": String(exitCode),
+        ...preservedWorktreePath ? { "Preserved worktree": preservedWorktreePath } : {}
+      });
+      return {
+        commits: lifecycleResult.commits,
+        branch: lifecycleResult.branch,
+        preservedWorktreePath,
+        exitCode
+      };
+    }).pipe(
+      // On error, always clean up worktree (on success, handled above with preserve check)
+      Effect_exports.tapError(
+        () => worktreeInfo ? remove(worktreeInfo.path).pipe(
+          Effect_exports.catchAll(() => Effect_exports.void)
+        ) : Effect_exports.void
+      ),
+      // Always close sandbox handle
+      Effect_exports.ensuring(Effect_exports.promise(() => handle.close().catch(() => {
+      })))
+    );
+  });
+  let result;
+  try {
+    result = await Effect_exports.runPromise(
+      inner.pipe(
+        Effect_exports.provide(ClackDisplay.layer),
+        Effect_exports.provide(NodeContext_exports.layer),
+        Effect_exports.provide(NodeFileSystem_exports.layer)
+      )
+    );
+  } catch (error) {
+    options.signal?.throwIfAborted();
+    throw error;
+  }
+  return result;
+};
+var buildSandboxHandle = (ctx, close) => {
+  const {
+    branch,
+    worktreePath,
+    hostRepoDir,
+    sandboxRepoDir,
+    sandbox,
+    providerHandle,
+    applyToHost,
+    timeouts
+  } = ctx;
+  const sandboxHandle = {
+    branch,
+    worktreePath,
+    run: async (runOptions) => {
+      runOptions.signal?.throwIfAborted();
+      const {
+        agent: provider,
+        prompt,
+        promptFile,
+        maxIterations = 1
+      } = runOptions;
+      const resolved = await Effect_exports.runPromise(
+        resolvePrompt({ prompt, promptFile }).pipe(
+          Effect_exports.provide(NodeContext_exports.layer)
+        )
+      );
+      const rawPrompt = resolved.text;
+      const isInlinePrompt = resolved.source === "inline";
+      const userArgs = runOptions.promptArgs ?? {};
+      const currentHostBranch = await Effect_exports.runPromise(
+        getCurrentBranch(hostRepoDir)
+      );
+      const displayRef = Ref_exports.unsafeMake([]);
+      const silentDisplayLayer = SilentDisplay.layer(displayRef);
+      const resolvedPrompt = await Effect_exports.runPromise(
+        Effect_exports.gen(function* () {
+          if (isInlinePrompt) {
+            yield* validateNoArgsWithInlinePrompt(userArgs);
+            return rawPrompt;
+          }
+          yield* validateNoBuiltInArgOverride(userArgs);
+          const effectiveArgs = {
+            SOURCE_BRANCH: branch,
+            TARGET_BRANCH: currentHostBranch,
+            ...userArgs
+          };
+          const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+          return yield* substitutePromptArgs(
+            rawPrompt,
+            effectiveArgs,
+            builtInArgKeysSet
+          );
+        }).pipe(Effect_exports.provide(silentDisplayLayer))
+      );
+      const resolvedLogging = runOptions.logging ?? {
+        type: "file",
+        path: join(
+          hostRepoDir,
+          ".sandcastle",
+          "logs",
+          buildLogFilename(branch, void 0, runOptions.name)
+        )
+      };
+      const runDisplayLayer = resolvedLogging.type === "file" ? (() => {
+        printFileDisplayStartup({
+          logPath: resolvedLogging.path,
+          agentName: runOptions.name,
+          branch
+        });
+        return Layer_exports.provide(
+          FileDisplay.layer(resolvedLogging.path),
+          NodeFileSystem_exports.layer
+        );
+      })() : silentDisplayLayer;
+      const reuseFactoryLayer = Layer_exports.succeed(SandboxFactory, {
+        withSandbox: (makeEffect) => makeEffect(
+          {
+            hostWorktreePath: worktreePath,
+            sandboxRepoPath: sandboxRepoDir,
+            applyToHost
+          },
+          sandbox
+        ).pipe(
+          Effect_exports.map((value) => ({
+            value,
+            preservedWorktreePath: void 0
+          }))
+        )
+      });
+      const streamEmitterLayer = agentStreamEmitterLayer(
+        resolvedLogging.type === "file" ? resolvedLogging.onAgentStreamEvent : void 0
+      );
+      const runLayer = Layer_exports.mergeAll(
+        reuseFactoryLayer,
+        runDisplayLayer,
+        streamEmitterLayer
+      );
+      let result;
+      try {
+        result = await Effect_exports.runPromise(
+          Effect_exports.gen(function* () {
+            const display = yield* Display;
+            yield* display.intro(runOptions.name ?? "sandcastle");
+            const orchestrateResult = yield* orchestrate({
+              hostRepoDir,
+              iterations: maxIterations,
+              prompt: resolvedPrompt,
+              branch,
+              provider,
+              completionSignal: runOptions.completionSignal,
+              idleTimeoutSeconds: runOptions.idleTimeoutSeconds,
+              completionTimeoutSeconds: runOptions.completionTimeoutSeconds,
+              name: runOptions.name,
+              signal: runOptions.signal,
+              skipPromptExpansion: isInlinePrompt,
+              timeouts
+            });
+            const completion = buildCompletionMessage(
+              orchestrateResult.completionSignal,
+              orchestrateResult.iterations.length
+            );
+            yield* display.status(completion.message, completion.severity);
+            for (const line of buildContextWindowLines(
+              orchestrateResult.iterations
+            )) {
+              yield* display.text(line);
+            }
+            return orchestrateResult;
+          }).pipe(Effect_exports.provide(runLayer))
+        );
+      } catch (error) {
+        runOptions.signal?.throwIfAborted();
+        throw error;
+      }
+      return {
+        iterations: result.iterations,
+        completionSignal: result.completionSignal,
+        stdout: result.stdout,
+        commits: result.commits,
+        logFilePath: resolvedLogging.type === "file" ? resolvedLogging.path : void 0
+      };
+    },
+    interactive: async (interactiveOptions) => {
+      interactiveOptions.signal?.throwIfAborted();
+      const { agent: provider, prompt, promptFile } = interactiveOptions;
+      if (!provider.buildInteractiveArgs) {
+        throw new Error(
+          `Agent provider "${provider.name}" does not support buildInteractiveArgs, required for interactive sessions.`
+        );
+      }
+      if (!providerHandle?.interactiveExec) {
+        throw new Error(
+          `Sandbox provider does not support interactiveExec. The provider must implement the optional interactiveExec method to use interactive().`
+        );
+      }
+      const interactiveExecFn = providerHandle.interactiveExec.bind(providerHandle);
+      let lifecycleResult;
+      try {
+        lifecycleResult = await Effect_exports.runPromise(
+          Effect_exports.gen(function* () {
+            const resolved = yield* resolvePrompt({ prompt, promptFile });
+            const rawPrompt = resolved.text;
+            const isInlinePrompt = resolved.source === "inline";
+            const userArgs = interactiveOptions.promptArgs ?? {};
+            const currentHostBranch = yield* getCurrentBranch(hostRepoDir);
+            let resolvedPrompt;
+            if (isInlinePrompt) {
+              yield* validateNoArgsWithInlinePrompt(userArgs);
+              resolvedPrompt = rawPrompt;
+            } else {
+              yield* validateNoBuiltInArgOverride(userArgs);
+              const effectiveArgs = {
+                SOURCE_BRANCH: branch,
+                TARGET_BRANCH: currentHostBranch,
+                ...userArgs
+              };
+              const builtInArgKeysSet = new Set(
+                BUILT_IN_PROMPT_ARG_KEYS
+              );
+              resolvedPrompt = yield* substitutePromptArgs(
+                rawPrompt,
+                effectiveArgs,
+                builtInArgKeysSet
+              );
+            }
+            return yield* withSandboxLifecycle(
+              {
+                hostRepoDir,
+                sandboxRepoDir,
+                branch,
+                hostWorktreePath: worktreePath,
+                applyToHost,
+                timeouts
+              },
+              sandbox,
+              (ctx2) => Effect_exports.gen(function* () {
+                const fullPrompt = isInlinePrompt ? resolvedPrompt : yield* preprocessPrompt(
+                  resolvedPrompt,
+                  ctx2.sandbox,
+                  ctx2.sandboxRepoDir
+                );
+                const interactiveArgs = provider.buildInteractiveArgs({
+                  prompt: fullPrompt,
+                  dangerouslySkipPermissions: true
+                });
+                const execPromise = interactiveExecFn(interactiveArgs, {
+                  stdin: process.stdin,
+                  stdout: process.stdout,
+                  stderr: process.stderr,
+                  cwd: sandboxRepoDir
+                });
+                const signal = interactiveOptions.signal;
+                const result = yield* Effect_exports.promise(() => {
+                  if (!signal) return execPromise;
+                  if (signal.aborted) return Promise.reject(signal.reason);
+                  return new Promise(
+                    (resolve, reject) => {
+                      const onAbort = () => reject(signal.reason);
+                      signal.addEventListener("abort", onAbort, {
+                        once: true
+                      });
+                      execPromise.then(
+                        (r) => {
+                          signal.removeEventListener("abort", onAbort);
+                          resolve(r);
+                        },
+                        (e) => {
+                          signal.removeEventListener("abort", onAbort);
+                          reject(e);
+                        }
+                      );
+                    }
+                  );
+                });
+                return result.exitCode;
+              })
+            );
+          }).pipe(
+            Effect_exports.provide(ClackDisplay.layer),
+            Effect_exports.provide(NodeContext_exports.layer)
+          )
+        );
+      } catch (error) {
+        interactiveOptions.signal?.throwIfAborted();
+        throw error;
+      }
+      return {
+        commits: lifecycleResult.commits,
+        exitCode: lifecycleResult.result
+      };
+    },
+    close: async () => close(),
+    [Symbol.asyncDispose]: async () => {
+      await sandboxHandle.close();
+    }
+  };
+  return sandboxHandle;
+};
+var createSandboxFromWorktree = async (options) => {
+  const { branch, worktreePath, hostRepoDir } = options;
+  const isTestMode = !!options._test?.buildSandbox;
+  if (options.copyToWorktree && options.copyToWorktree.length > 0 && options.sandbox.tag !== "isolated") {
+    await Effect_exports.runPromise(
+      copyToWorktree(
+        options.copyToWorktree,
+        hostRepoDir,
+        worktreePath,
+        options.timeouts?.copyToWorktreeMs
+      )
+    );
+  }
+  let providerHandle;
+  let sandbox;
+  let sandboxRepoDir;
+  const isIsolated = options.sandbox.tag === "isolated";
+  if (isTestMode) {
+    sandbox = options._test.buildSandbox(worktreePath);
+    sandboxRepoDir = worktreePath;
+  } else {
+    const resolvedEnv = await Effect_exports.runPromise(
+      resolveEnv(hostRepoDir).pipe(Effect_exports.provide(NodeContext_exports.layer))
+    );
+    const env = mergeProviderEnv({
+      resolvedEnv,
+      agentProviderEnv: {},
+      sandboxProviderEnv: options.sandbox.env
+    });
+    const provider = options.sandbox;
+    let startEffect;
+    if (provider.tag === "isolated") {
+      startEffect = startSandbox({
+        provider,
+        hostRepoDir: worktreePath,
+        env,
+        copyPaths: options.copyToWorktree
+      });
+    } else if (provider.tag === "none") {
+      startEffect = startSandbox({
+        provider,
+        hostRepoDir,
+        env,
+        worktreeOrRepoPath: worktreePath
+      });
+    } else {
+      startEffect = resolveGitMounts(join(hostRepoDir, ".git")).pipe(
+        Effect_exports.provide(NodeFileSystem_exports.layer),
+        Effect_exports.catchAll(() => Effect_exports.succeed([])),
+        // Patch git mounts for Windows worktree compatibility (ADR-0006)
+        Effect_exports.flatMap(
+          (gitMounts) => Effect_exports.tryPromise({
+            try: () => patchGitMountsForWindows(
+              gitMounts,
+              worktreePath,
+              SANDBOX_REPO_DIR
+            ),
+            catch: (e) => new Error(
+              `Failed to patch git mounts: ${e instanceof Error ? e.message : String(e)}`
+            )
+          })
+        ),
+        Effect_exports.flatMap(
+          (gitMounts) => startSandbox({
+            provider,
+            hostRepoDir,
+            env,
+            worktreeOrRepoPath: worktreePath,
+            gitMounts,
+            repoDir: SANDBOX_REPO_DIR
+          })
+        )
+      );
+    }
+    const startResult = await Effect_exports.runPromise(startEffect);
+    providerHandle = startResult.handle;
+    sandbox = startResult.sandbox;
+    sandboxRepoDir = startResult.worktreePath;
+  }
+  const sandboxOnReady = options.hooks?.sandbox?.onSandboxReady;
+  const hostOnReady = options.hooks?.host?.onSandboxReady;
+  if (sandboxOnReady?.length || hostOnReady?.length) {
+    await Effect_exports.runPromise(
+      Effect_exports.gen(function* () {
+        yield* sandbox.exec(
+          `git config --global --add safe.directory "${sandboxRepoDir}"`
+        );
+        const sandboxEffects = (sandboxOnReady ?? []).map(
+          (hook) => sandbox.exec(hook.command, {
+            cwd: sandboxRepoDir,
+            sudo: hook.sudo
+          })
+        );
+        const allEffects = [...sandboxEffects];
+        if (hostOnReady?.length) {
+          allEffects.push(runHostHooks(hostOnReady, worktreePath));
+        }
+        yield* Effect_exports.all(allEffects, {
+          concurrency: "unbounded"
+        });
+      })
+    );
+  }
+  const applyToHost = isIsolated && providerHandle ? () => syncOut(worktreePath, providerHandle) : () => Effect_exports.void;
+  let closed = false;
+  return buildSandboxHandle(
+    {
+      branch,
+      worktreePath,
+      hostRepoDir,
+      sandboxRepoDir,
+      sandbox,
+      providerHandle,
+      applyToHost,
+      timeouts: options.timeouts
+    },
+    async () => {
+      if (closed) return { preservedWorktreePath: void 0 };
+      closed = true;
+      if (providerHandle) await providerHandle.close();
+      return { preservedWorktreePath: void 0 };
+    }
+  );
+};
+var createSandbox = async (options) => {
+  const { branch } = options;
+  const isTestMode = !!options._test?.buildSandbox;
+  const isIsolated = options.sandbox.tag === "isolated";
+  const { hostRepoDir, worktreePath, providerHandle, sandbox, sandboxRepoDir } = await Effect_exports.runPromise(
+    Effect_exports.gen(function* () {
+      const hostRepoDir2 = yield* resolveCwd(options.cwd);
+      yield* pruneStale(hostRepoDir2).pipe(
+        Effect_exports.catchAll(() => Effect_exports.void)
+      );
+      const { path: worktreePath2 } = yield* create(
+        hostRepoDir2,
+        { branch, baseBranch: options.baseBranch }
+      );
+      const prepared = yield* Effect_exports.gen(function* () {
+        if (options.copyToWorktree && options.copyToWorktree.length > 0 && options.sandbox.tag !== "isolated") {
+          yield* copyToWorktree(
+            options.copyToWorktree,
+            hostRepoDir2,
+            worktreePath2,
+            options.timeouts?.copyToWorktreeMs
+          );
+        }
+        if (options.hooks?.host?.onWorktreeReady?.length) {
+          yield* runHostHooks(
+            options.hooks.host.onWorktreeReady,
+            worktreePath2
+          );
+        }
+        let providerHandle2;
+        let sandbox2;
+        let sandboxRepoDir2;
+        if (isTestMode) {
+          sandbox2 = options._test.buildSandbox(worktreePath2);
+          sandboxRepoDir2 = worktreePath2;
+        } else {
+          const resolvedEnv = yield* resolveEnv(hostRepoDir2);
+          const env = mergeProviderEnv({
+            resolvedEnv,
+            agentProviderEnv: {},
+            sandboxProviderEnv: options.sandbox.env
+          });
+          const provider = options.sandbox;
+          const startResult = yield* provider.tag === "isolated" ? startSandbox({
+            provider,
+            hostRepoDir: worktreePath2,
+            env,
+            copyPaths: options.copyToWorktree
+          }) : provider.tag === "none" ? startSandbox({
+            provider,
+            hostRepoDir: hostRepoDir2,
+            env,
+            worktreeOrRepoPath: worktreePath2
+          }) : resolveGitMounts(join(hostRepoDir2, ".git")).pipe(
+            Effect_exports.provide(NodeFileSystem_exports.layer),
+            Effect_exports.catchAll(() => Effect_exports.succeed([])),
+            // Patch git mounts for Windows worktree compatibility (ADR-0006)
+            Effect_exports.flatMap(
+              (gitMounts) => Effect_exports.tryPromise({
+                try: () => patchGitMountsForWindows(
+                  gitMounts,
+                  worktreePath2,
+                  SANDBOX_REPO_DIR
+                ),
+                catch: (e) => new Error(
+                  `Failed to patch git mounts: ${e instanceof Error ? e.message : String(e)}`
+                )
+              })
+            ),
+            Effect_exports.flatMap(
+              (gitMounts) => startSandbox({
+                provider,
+                hostRepoDir: hostRepoDir2,
+                env,
+                worktreeOrRepoPath: worktreePath2,
+                gitMounts,
+                repoDir: SANDBOX_REPO_DIR
+              })
+            )
+          );
+          providerHandle2 = startResult.handle;
+          sandbox2 = startResult.sandbox;
+          sandboxRepoDir2 = startResult.worktreePath;
+        }
+        const sandboxOnReady = options.hooks?.sandbox?.onSandboxReady;
+        const hostOnReady = options.hooks?.host?.onSandboxReady;
+        if (sandboxOnReady?.length || hostOnReady?.length) {
+          yield* Effect_exports.gen(function* () {
+            yield* sandbox2.exec(
+              `git config --global --add safe.directory "${sandboxRepoDir2}"`
+            );
+            const sandboxEffects = (sandboxOnReady ?? []).map(
+              (hook) => sandbox2.exec(hook.command, {
+                cwd: sandboxRepoDir2,
+                sudo: hook.sudo
+              })
+            );
+            const allEffects = [...sandboxEffects];
+            if (hostOnReady?.length) {
+              allEffects.push(runHostHooks(hostOnReady, worktreePath2));
+            }
+            yield* Effect_exports.all(allEffects, { concurrency: "unbounded" });
+          }).pipe(
+            Effect_exports.onError(
+              () => providerHandle2 ? Effect_exports.promise(
+                () => providerHandle2.close().catch(() => {
+                })
+              ) : Effect_exports.void
+            )
+          );
+        }
+        return { providerHandle: providerHandle2, sandbox: sandbox2, sandboxRepoDir: sandboxRepoDir2 };
+      }).pipe(
+        Effect_exports.onError(
+          () => remove(worktreePath2).pipe(
+            Effect_exports.catchAll(() => Effect_exports.void)
+          )
+        )
+      );
+      return { hostRepoDir: hostRepoDir2, worktreePath: worktreePath2, ...prepared };
+    }).pipe(Effect_exports.provide(NodeContext_exports.layer))
+  );
+  const applyToHost = isIsolated && providerHandle ? () => syncOut(worktreePath, providerHandle) : () => Effect_exports.void;
+  let closed = false;
+  const forceCleanup = () => {
+    console.error(`
+Worktree preserved at ${worktreePath}`);
+    console.error(`  To review: cd ${worktreePath}`);
+    console.error(`  To clean up: git worktree remove --force ${worktreePath}`);
+  };
+  const unregisterShutdown = registerShutdown(forceCleanup);
+  const doClose = async () => {
+    if (closed) return { preservedWorktreePath: void 0 };
+    closed = true;
+    return Effect_exports.runPromise(
+      Effect_exports.gen(function* () {
+        if (providerHandle) {
+          yield* Effect_exports.promise(() => providerHandle.close());
+        }
+        const isDirty = yield* hasUncommittedChanges(
+          worktreePath
+        ).pipe(Effect_exports.catchAll(() => Effect_exports.succeed(false)));
+        if (isDirty) {
+          return { preservedWorktreePath: worktreePath };
+        }
+        yield* remove(worktreePath).pipe(
+          Effect_exports.catchAll(() => Effect_exports.void)
+        );
+        return { preservedWorktreePath: void 0 };
+      })
+    );
+  };
+  return buildSandboxHandle(
+    {
+      branch,
+      worktreePath,
+      hostRepoDir,
+      sandboxRepoDir,
+      sandbox,
+      providerHandle,
+      applyToHost,
+      timeouts: options.timeouts
+    },
+    async () => {
+      unregisterShutdown();
+      return doClose();
+    }
+  );
+};
+var createWorktree = async (options) => {
+  const branch = options.branchStrategy.type === "branch" ? options.branchStrategy.branch : void 0;
+  const baseBranch = options.branchStrategy.type === "branch" ? options.branchStrategy.baseBranch : void 0;
+  const { hostRepoDir, worktreeInfo } = await Effect_exports.gen(function* () {
+    const hostRepoDir2 = yield* resolveCwd(options.cwd);
+    yield* pruneStale(hostRepoDir2).pipe(
+      Effect_exports.catchAll(() => Effect_exports.void)
+    );
+    const info = yield* create(hostRepoDir2, {
+      branch,
+      baseBranch
+    });
+    if (options.copyToWorktree && options.copyToWorktree.length > 0) {
+      yield* copyToWorktree(
+        options.copyToWorktree,
+        hostRepoDir2,
+        info.path,
+        options.timeouts?.copyToWorktreeMs
+      );
+    }
+    if (options.hooks?.host?.onWorktreeReady?.length) {
+      yield* runHostHooks(options.hooks.host.onWorktreeReady, info.path);
+    }
+    return { hostRepoDir: hostRepoDir2, worktreeInfo: info };
+  }).pipe(Effect_exports.provide(NodeContext_exports.layer), Effect_exports.runPromise);
+  let closed = false;
+  const close = async () => {
+    if (closed) return { preservedWorktreePath: void 0 };
+    closed = true;
+    return Effect_exports.gen(function* () {
+      const isDirty = yield* hasUncommittedChanges(
+        worktreeInfo.path
+      ).pipe(Effect_exports.catchAll(() => Effect_exports.succeed(false)));
+      if (isDirty) {
+        return { preservedWorktreePath: worktreeInfo.path };
+      }
+      yield* remove(worktreeInfo.path).pipe(
+        Effect_exports.catchAll(() => Effect_exports.void)
+      );
+      return { preservedWorktreePath: void 0 };
+    }).pipe(Effect_exports.runPromise);
+  };
+  const worktreeInteractive = async (opts) => {
+    opts.signal?.throwIfAborted();
+    const { prompt, promptFile, hooks, agent: provider } = opts;
+    const resolvedSandbox = opts.sandbox ?? noSandbox();
+    if (!provider.buildInteractiveArgs) {
+      throw new Error(
+        `Agent provider "${provider.name}" does not support buildInteractiveArgs, required for interactive sessions.`
+      );
+    }
+    const inner = Effect_exports.gen(function* () {
+      const d = yield* Display;
+      const hasPromptSource = prompt !== void 0 || promptFile !== void 0;
+      const resolved = hasPromptSource ? yield* resolvePrompt({ prompt, promptFile }) : void 0;
+      const rawPrompt = resolved?.text ?? "";
+      const isInlinePrompt = resolved?.source === "inline";
+      const resolvedEnv = yield* resolveEnv(hostRepoDir);
+      const env = mergeProviderEnv({
+        resolvedEnv,
+        agentProviderEnv: provider.env,
+        sandboxProviderEnv: resolvedSandbox.env
+      });
+      const effectiveEnv = { ...env, ...opts.env ?? {} };
+      let substitutedPrompt = rawPrompt;
+      if (hasPromptSource && !isInlinePrompt) {
+        const userArgs = opts.promptArgs ?? {};
+        yield* validateNoBuiltInArgOverride(userArgs);
+        const effectiveArgs = {
+          SOURCE_BRANCH: worktreeInfo.branch,
+          TARGET_BRANCH: worktreeInfo.branch,
+          ...userArgs
+        };
+        const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+        substitutedPrompt = yield* substitutePromptArgs(
+          rawPrompt,
+          effectiveArgs,
+          builtInArgKeysSet
+        );
+      } else if (isInlinePrompt) {
+        yield* validateNoArgsWithInlinePrompt(opts.promptArgs ?? {});
+      }
+      yield* d.intro(opts.name ?? "sandcastle interactive");
+      yield* d.summary("Interactive Session", {
+        Agent: opts.name ?? provider.name,
+        Sandbox: resolvedSandbox.name,
+        Branch: worktreeInfo.branch
+      });
+      let handle;
+      if (resolvedSandbox.tag === "none") {
+        handle = yield* Effect_exports.promise(
+          () => resolvedSandbox.create({
+            worktreePath: worktreeInfo.path,
+            env: effectiveEnv
+          })
+        );
+      } else if (resolvedSandbox.tag === "isolated") {
+        const startResult = yield* d.taskLog(
+          "Starting sandbox",
+          () => startSandbox({
+            provider: resolvedSandbox,
+            hostRepoDir: worktreeInfo.path,
+            env: effectiveEnv
+          })
+        );
+        handle = startResult.handle;
+      } else {
+        const gitPath = join(hostRepoDir, ".git");
+        const gitMounts = yield* resolveGitMounts(gitPath);
+        const startResult = yield* d.taskLog(
+          "Starting sandbox",
+          () => startSandbox({
+            provider: resolvedSandbox,
+            hostRepoDir,
+            env: effectiveEnv,
+            worktreeOrRepoPath: worktreeInfo.path,
+            gitMounts,
+            repoDir: SANDBOX_REPO_DIR
+          })
+        );
+        handle = startResult.handle;
+      }
+      return yield* Effect_exports.gen(function* () {
+        if (!handle.interactiveExec) {
+          throw new Error(
+            `Sandbox provider does not support interactiveExec. The provider must implement the optional interactiveExec method to use interactive().`
+          );
+        }
+        const interactiveExecFn = handle.interactiveExec.bind(handle);
+        const sandbox = makeSandboxFromHandle(handle);
+        const worktreePath = handle.worktreePath;
+        const applyToHost = resolvedSandbox.tag === "isolated" ? () => syncOut(worktreeInfo.path, handle) : () => Effect_exports.void;
+        const lifecycleEffect = withSandboxLifecycle(
+          {
+            hostRepoDir,
+            sandboxRepoDir: worktreePath,
+            hooks,
+            branch: worktreeInfo.branch,
+            hostWorktreePath: worktreeInfo.path,
+            applyToHost,
+            timeouts: options.timeouts
+          },
+          sandbox,
+          (ctx) => Effect_exports.gen(function* () {
+            const fullPrompt = !hasPromptSource || isInlinePrompt ? substitutedPrompt : yield* preprocessPrompt(
+              substitutedPrompt,
+              ctx.sandbox,
+              ctx.sandboxRepoDir
+            );
+            const interactiveArgs = provider.buildInteractiveArgs({
+              prompt: fullPrompt,
+              dangerouslySkipPermissions: resolvedSandbox.tag !== "none"
+            });
+            const result = yield* raceAbortSignal(
+              Effect_exports.promise(
+                () => interactiveExecFn(interactiveArgs, {
+                  stdin: process.stdin,
+                  stdout: process.stdout,
+                  stderr: process.stderr,
+                  cwd: worktreePath
+                })
+              ),
+              opts.signal
+            );
+            return result.exitCode;
+          })
+        );
+        const lifecycleResult = yield* lifecycleEffect;
+        const exitCode = lifecycleResult.result;
+        yield* d.summary("Session Complete", {
+          Commits: String(lifecycleResult.commits.length),
+          Branch: lifecycleResult.branch,
+          "Exit code": String(exitCode)
+        });
+        return {
+          commits: lifecycleResult.commits,
+          branch: lifecycleResult.branch,
+          preservedWorktreePath: void 0,
+          exitCode
+        };
+      }).pipe(
+        // Always close sandbox handle
+        Effect_exports.ensuring(Effect_exports.promise(() => handle.close().catch(() => {
+        })))
+      );
+    });
+    try {
+      return await Effect_exports.runPromise(
+        inner.pipe(
+          Effect_exports.provide(ClackDisplay.layer),
+          Effect_exports.provide(NodeContext_exports.layer),
+          Effect_exports.provide(NodeFileSystem_exports.layer)
+        )
+      );
+    } catch (error) {
+      opts.signal?.throwIfAborted();
+      throw error;
+    }
+  };
+  const worktreeRun = async (opts) => {
+    opts.signal?.throwIfAborted();
+    const { prompt, promptFile, hooks, agent: provider } = opts;
+    const sandboxProvider = opts.sandbox;
+    const maxIterations = opts.maxIterations ?? 1;
+    if (opts.resumeSession && maxIterations > 1) {
+      throw new Error(
+        "resumeSession cannot be combined with maxIterations > 1. Resume applies to iteration 1 only; multi-iteration resume semantics are not supported."
+      );
+    }
+    if (opts.resumeSession) {
+      await assertResumeSessionExists({
+        provider,
+        sandboxTag: sandboxProvider.tag,
+        hostRepoDir,
+        resumeSession: opts.resumeSession
+      });
+    }
+    const inner = Effect_exports.gen(function* () {
+      const resolved = yield* resolvePrompt({ prompt, promptFile });
+      const rawPrompt = resolved.text;
+      const isInlinePrompt = resolved.source === "inline";
+      const resolvedEnv = yield* resolveEnv(hostRepoDir);
+      const env = mergeProviderEnv({
+        resolvedEnv,
+        agentProviderEnv: provider.env,
+        sandboxProviderEnv: sandboxProvider.env
+      });
+      const effectiveEnv = { ...env, ...opts.env ?? {} };
+      const userArgs = opts.promptArgs ?? {};
+      let resolvedPrompt;
+      if (isInlinePrompt) {
+        yield* validateNoArgsWithInlinePrompt(userArgs);
+        resolvedPrompt = rawPrompt;
+      } else {
+        yield* validateNoBuiltInArgOverride(userArgs);
+        const effectiveArgs = {
+          SOURCE_BRANCH: worktreeInfo.branch,
+          TARGET_BRANCH: worktreeInfo.branch,
+          ...userArgs
+        };
+        const builtInArgKeysSet = new Set(BUILT_IN_PROMPT_ARG_KEYS);
+        resolvedPrompt = yield* substitutePromptArgs(
+          rawPrompt,
+          effectiveArgs,
+          builtInArgKeysSet
+        );
+      }
+      let handle;
+      let sandboxRepoDir;
+      if (sandboxProvider.tag === "isolated") {
+        const startResult = yield* startSandbox({
+          provider: sandboxProvider,
+          hostRepoDir: worktreeInfo.path,
+          env: effectiveEnv
+        });
+        handle = startResult.handle;
+        sandboxRepoDir = startResult.worktreePath;
+      } else if (sandboxProvider.tag === "none") {
+        const startResult = yield* startSandbox({
+          provider: sandboxProvider,
+          hostRepoDir,
+          env: effectiveEnv,
+          worktreeOrRepoPath: worktreeInfo.path
+        });
+        handle = startResult.handle;
+        sandboxRepoDir = startResult.worktreePath;
+      } else {
+        const gitPath = join(hostRepoDir, ".git");
+        const gitMounts = yield* resolveGitMounts(gitPath);
+        const startResult = yield* startSandbox({
+          provider: sandboxProvider,
+          hostRepoDir,
+          env: effectiveEnv,
+          worktreeOrRepoPath: worktreeInfo.path,
+          gitMounts,
+          repoDir: SANDBOX_REPO_DIR
+        });
+        handle = startResult.handle;
+        sandboxRepoDir = startResult.worktreePath;
+      }
+      const sandbox = makeSandboxFromHandle(handle);
+      const applyToHost = sandboxProvider.tag === "isolated" ? () => syncOut(worktreeInfo.path, handle) : () => Effect_exports.void;
+      const resolvedLogging = opts.logging ?? {
+        type: "file",
+        path: join(
+          hostRepoDir,
+          ".sandcastle",
+          "logs",
+          buildLogFilename(worktreeInfo.branch, void 0, opts.name)
+        )
+      };
+      const runDisplayLayer = resolvedLogging.type === "file" ? (() => {
+        printFileDisplayStartup({
+          logPath: resolvedLogging.path,
+          agentName: opts.name,
+          branch: worktreeInfo.branch
+        });
+        return Layer_exports.provide(
+          FileDisplay.layer(resolvedLogging.path),
+          NodeFileSystem_exports.layer
+        );
+      })() : ClackDisplay.layer;
+      const reuseFactoryLayer = Layer_exports.succeed(SandboxFactory, {
+        withSandbox: (makeEffect) => makeEffect(
+          {
+            hostWorktreePath: worktreeInfo.path,
+            sandboxRepoPath: sandboxRepoDir,
+            applyToHost
+          },
+          sandbox
+        ).pipe(
+          Effect_exports.map((value) => ({
+            value,
+            preservedWorktreePath: void 0
+          }))
+        )
+      });
+      const streamEmitterLayer = agentStreamEmitterLayer(
+        resolvedLogging.type === "file" ? resolvedLogging.onAgentStreamEvent : void 0
+      );
+      const runLayer = Layer_exports.mergeAll(
+        reuseFactoryLayer,
+        runDisplayLayer,
+        streamEmitterLayer
+      );
+      const result = yield* Effect_exports.gen(function* () {
+        const display = yield* Display;
+        yield* display.intro(opts.name ?? "sandcastle");
+        const orchestrateResult = yield* orchestrate({
+          hostRepoDir,
+          iterations: maxIterations,
+          hooks,
+          prompt: resolvedPrompt,
+          branch: worktreeInfo.branch,
+          provider,
+          completionSignal: opts.completionSignal,
+          idleTimeoutSeconds: opts.idleTimeoutSeconds,
+          completionTimeoutSeconds: opts.completionTimeoutSeconds,
+          name: opts.name,
+          resumeSession: opts.resumeSession,
+          signal: opts.signal,
+          skipPromptExpansion: isInlinePrompt,
+          timeouts: options.timeouts
+        });
+        const completion = buildCompletionMessage(
+          orchestrateResult.completionSignal,
+          orchestrateResult.iterations.length
+        );
+        yield* display.status(completion.message, completion.severity);
+        for (const line of buildContextWindowLines(
+          orchestrateResult.iterations
+        )) {
+          yield* display.text(line);
+        }
+        return orchestrateResult;
+      }).pipe(
+        Effect_exports.provide(runLayer),
+        // Always close sandbox handle
+        Effect_exports.ensuring(Effect_exports.promise(() => handle.close().catch(() => {
+        })))
+      );
+      return {
+        iterations: result.iterations,
+        completionSignal: result.completionSignal,
+        stdout: result.stdout,
+        commits: result.commits,
+        branch: result.branch,
+        logFilePath: resolvedLogging.type === "file" ? resolvedLogging.path : void 0
+      };
+    });
+    try {
+      return await Effect_exports.runPromise(
+        inner.pipe(
+          Effect_exports.provide(ClackDisplay.layer),
+          Effect_exports.provide(NodeContext_exports.layer),
+          Effect_exports.provide(NodeFileSystem_exports.layer)
+        )
+      );
+    } catch (error) {
+      opts.signal?.throwIfAborted();
+      throw error;
+    }
+  };
+  const worktreeCreateSandbox = async (opts) => {
+    return createSandboxFromWorktree({
+      branch: worktreeInfo.branch,
+      worktreePath: worktreeInfo.path,
+      hostRepoDir,
+      sandbox: opts.sandbox,
+      hooks: opts.hooks,
+      copyToWorktree: opts.copyToWorktree,
+      timeouts: opts.timeouts,
+      _test: opts._test
+    });
+  };
+  return {
+    branch: worktreeInfo.branch,
+    worktreePath: worktreeInfo.path,
+    run: worktreeRun,
+    interactive: worktreeInteractive,
+    createSandbox: worktreeCreateSandbox,
+    close,
+    async [Symbol.asyncDispose]() {
+      await close();
+    }
+  };
+};
+
+// src/CwdError.ts
+var CwdError2 = CwdError;
+
+export { CwdError2 as CwdError, Output, StructuredOutputError, createSandbox, createWorktree, interactive, run };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map