poe-code 3.0.201 → 3.0.202

package/dist/providers/poe-agent.js

@@ -609,8 +609,8 @@ function resourceNotFound(resource) {
     `Resource not found: ${resource}`
   );
 }
-function assertAbsolutePath(path30) {
-  if (!isAbsolute(path30)) {
+function assertAbsolutePath(path33) {
+  if (!isAbsolute(path33)) {
     throw invalidParams('"path" must be an absolute path');
   }
 }
@@ -2917,7 +2917,7 @@ var init_acp_core = __esm({
 });
 
 // packages/poe-agent/src/plugins/plugin-args.ts
-import path7 from "node:path";
+import path10 from "node:path";
 function isObjectRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -2987,13 +2987,13 @@ function getOptionalNonNegativeInteger(args, key2) {
   return value;
 }
 function resolveAllowedPath(cwd, allowedPaths, inputPath) {
-  const resolvedPath = path7.resolve(cwd, inputPath);
+  const resolvedPath = path10.resolve(cwd, inputPath);
   const isAllowed = allowedPaths.some((allowedPath) => {
     if (allowedPath === resolvedPath) {
       return true;
     }
-    const rel = path7.relative(allowedPath, resolvedPath);
-    return rel.length > 0 && !rel.startsWith("..") && !path7.isAbsolute(rel);
+    const rel = path10.relative(allowedPath, resolvedPath);
+    return rel.length > 0 && !rel.startsWith("..") && !path10.isAbsolute(rel);
   });
   if (!isAllowed) {
     throw new Error(`Path is outside allowed paths: ${inputPath}`);
@@ -3008,8 +3008,8 @@ var init_plugin_args = __esm({
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-files.ts
 import { execFile as execFileCallback } from "node:child_process";
-import fsPromises2 from "node:fs/promises";
-import path8 from "node:path";
+import fsPromises3 from "node:fs/promises";
+import path11 from "node:path";
 import { promisify } from "node:util";
 import fastGlob from "fast-glob";
 async function fileExists(fs4, filePath) {
@@ -3050,7 +3050,7 @@ function getOptionalGrepOutputMode(args, key2) {
   );
 }
 function formatDisplayPath(cwd, filePath) {
-  return path8.relative(cwd, filePath) || path8.basename(filePath);
+  return path11.relative(cwd, filePath) || path11.basename(filePath);
 }
 async function sortPathsByModifiedTime(matches2, fs4) {
   const entries = await Promise.all(
@@ -3069,8 +3069,8 @@ async function sortPathsByModifiedTime(matches2, fs4) {
 }
 async function defaultSearchContent(options, fs4) {
   const targetStat = await fs4.stat(options.path);
-  const searchCwd = targetStat.isDirectory() ? options.path : path8.dirname(options.path);
-  const searchTarget = targetStat.isDirectory() ? "." : path8.basename(options.path);
+  const searchCwd = targetStat.isDirectory() ? options.path : path11.dirname(options.path);
+  const searchTarget = targetStat.isDirectory() ? "." : path11.basename(options.path);
   const args = ["--color", "never"];
   if (options.outputMode === "content") {
     args.push("--with-filename");
@@ -3166,7 +3166,7 @@ function sliceLines(content, offset, limit) {
   return content.slice(lineStart, lineEnd);
 }
 function detectImageMimeType(filePath) {
-  const extension = path8.extname(filePath).toLowerCase();
+  const extension = path11.extname(filePath).toLowerCase();
   if (extension === ".png") {
     return "image/png";
   }
@@ -3195,11 +3195,11 @@ var init_poe_agent_plugin_files = __esm({
     init_plugin_args();
     execFile = promisify(execFileCallback);
     filesPlugin = (options = {}) => {
-      const cwd = path8.resolve(options.cwd ?? process.cwd());
+      const cwd = path11.resolve(options.cwd ?? process.cwd());
       const allowedPaths = (options.allowedPaths ?? [cwd]).map(
-        (allowedPath) => path8.resolve(cwd, allowedPath)
+        (allowedPath) => path11.resolve(cwd, allowedPath)
       );
-      const fs4 = options.fs ?? fsPromises2;
+      const fs4 = options.fs ?? fsPromises3;
       const searchContent = options.searchContent ?? ((searchOptions) => defaultSearchContent(searchOptions, fs4));
       const globFiles = options.globFiles ?? defaultGlobFiles;
       const readFileTool = {
@@ -3317,13 +3317,13 @@ var init_poe_agent_plugin_files = __esm({
             if (await fileExists(fs4, filePath)) {
               throw new Error("File already exists \u2014 use str_replace to edit");
             }
-            await fs4.mkdir(path8.dirname(filePath), { recursive: true });
+            await fs4.mkdir(path11.dirname(filePath), { recursive: true });
             await fs4.writeFile(filePath, fileText, "utf8");
             return `Created file: ${displayedPath}`;
           }
           if (command === "overwrite") {
             const fileText = getRequiredString(args, "file_text", true);
-            await fs4.mkdir(path8.dirname(filePath), { recursive: true });
+            await fs4.mkdir(path11.dirname(filePath), { recursive: true });
             await fs4.writeFile(filePath, fileText, "utf8");
             return `Overwrote file: ${displayedPath}`;
           }
@@ -3507,11 +3507,11 @@ var init_provider_metadata = __esm({
 // packages/auth-store/src/encrypted-file-store.ts
 import { createCipheriv, createDecipheriv, randomBytes, scrypt } from "node:crypto";
 import { promises as fs } from "node:fs";
-import { homedir as homedir2, hostname, userInfo } from "node:os";
-import path9 from "node:path";
+import { homedir as homedir2, hostname as hostname2, userInfo } from "node:os";
+import path12 from "node:path";
 function defaultMachineIdentity() {
   return {
-    hostname: hostname(),
+    hostname: hostname2(),
     username: userInfo().username
   };
 }
@@ -3560,7 +3560,7 @@ function parseEncryptedDocument(raw) {
 function isRecord2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isNotFoundError(error2) {
+function isNotFoundError2(error2) {
   return Boolean(
     error2 && typeof error2 === "object" && "code" in error2 && error2.code === "ENOENT"
   );
@@ -3586,7 +3586,7 @@ var init_encrypted_file_store = __esm({
       constructor(input) {
         this.fs = input.fs ?? fs;
         this.salt = input.salt;
-        this.filePath = input.filePath ?? path9.join(
+        this.filePath = input.filePath ?? path12.join(
           (input.getHomeDirectory ?? homedir2)(),
           input.defaultDirectory ?? ".auth-store",
           input.defaultFileName ?? "credentials.enc"
@@ -3599,7 +3599,7 @@ var init_encrypted_file_store = __esm({
         try {
           rawDocument = await this.fs.readFile(this.filePath, "utf8");
         } catch (error2) {
-          if (isNotFoundError(error2)) {
+          if (isNotFoundError2(error2)) {
             return null;
           }
           throw error2;
@@ -3639,7 +3639,7 @@ var init_encrypted_file_store = __esm({
           authTag: authTag.toString("base64"),
           ciphertext: ciphertext.toString("base64")
         };
-        await this.fs.mkdir(path9.dirname(this.filePath), { recursive: true });
+        await this.fs.mkdir(path12.dirname(this.filePath), { recursive: true });
         await this.fs.writeFile(this.filePath, JSON.stringify(document), {
           encoding: "utf8"
         });
@@ -3649,7 +3649,7 @@ var init_encrypted_file_store = __esm({
         try {
           await this.fs.unlink(this.filePath);
         } catch (error2) {
-          if (!isNotFoundError(error2)) {
+          if (!isNotFoundError2(error2)) {
             throw error2;
           }
         }
@@ -4858,7 +4858,7 @@ var init_poe_agent_plugin_openai_responses = __esm({
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-shell.ts
 import { spawn as spawn2 } from "node:child_process";
-import path10 from "node:path";
+import path13 from "node:path";
 import { parse as parseShellCommand } from "shell-quote";
 function parseTimeoutMs(args) {
   const timeoutSeconds = getOptionalNumber(args, "timeout") ?? defaultTimeoutSeconds;
@@ -5425,9 +5425,9 @@ var init_poe_agent_plugin_shell = __esm({
     maxTimeoutSeconds = 600;
     terminateGracePeriodMs = 1e3;
     shellPlugin = (options = {}) => {
-      const cwd = path10.resolve(options.cwd ?? process.cwd());
+      const cwd = path13.resolve(options.cwd ?? process.cwd());
       const allowedPaths = (options.allowedPaths ?? [cwd]).map(
-        (allowedPath) => path10.resolve(cwd, allowedPath)
+        (allowedPath) => path13.resolve(cwd, allowedPath)
       );
       const runCommand3 = options.runCommand ?? defaultRunCommand;
       const backgroundCommands = /* @__PURE__ */ new Map();
@@ -5579,7 +5579,7 @@ var init_poe_agent_plugin_shell = __esm({
 
 // packages/poe-agent/src/system-prompt.ts
 import { readFileSync } from "node:fs";
-import { readFile } from "node:fs/promises";
+import { readFile as readFile2 } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 function loadSystemPromptSync() {
   return readFileSync(SYSTEM_PROMPT_PATH, "utf8");
@@ -5973,9 +5973,9 @@ var init_poe_agent_plugin_compaction = __esm({
 });
 
 // packages/poe-agent/src/plugins/poe-agent-plugin-memory.ts
-import fsPromises3 from "node:fs/promises";
-import os from "node:os";
-import path11 from "node:path";
+import fsPromises4 from "node:fs/promises";
+import os3 from "node:os";
+import path14 from "node:path";
 async function loadMemory(options) {
   const sections = [];
   const projectMemoryPath = await findNearestAgentsFile(options.cwd, options.fs);
@@ -5986,7 +5986,7 @@ async function loadMemory(options) {
     }
   }
   const userMemory = await loadOptionalMemoryFile(
-    path11.join(options.homeDir, USER_MEMORY_DIRECTORY, AGENTS_FILE),
+    path14.join(options.homeDir, USER_MEMORY_DIRECTORY, AGENTS_FILE),
     options.fs
   );
   if (userMemory) {
@@ -6000,11 +6000,11 @@ async function loadMemory(options) {
 async function findNearestAgentsFile(cwd, fs4) {
   let currentDirectory = cwd;
   while (true) {
-    const filePath = path11.join(currentDirectory, AGENTS_FILE);
+    const filePath = path14.join(currentDirectory, AGENTS_FILE);
     if (await readOptionalFile(filePath, fs4) !== void 0) {
       return filePath;
     }
-    const parentDirectory = path11.dirname(currentDirectory);
+    const parentDirectory = path14.dirname(currentDirectory);
     if (parentDirectory === currentDirectory) {
       return void 0;
     }
@@ -6024,7 +6024,7 @@ async function loadOptionalMemoryFile(filePath, fs4) {
   });
 }
 async function expandImports(options) {
-  const normalizedPath = path11.resolve(options.filePath);
+  const normalizedPath = path14.resolve(options.filePath);
   if (options.loading.has(normalizedPath)) {
     throw new Error(`Circular AGENTS.md import detected: ${normalizedPath}`);
   }
@@ -6037,7 +6037,7 @@ async function expandImports(options) {
         expandedLines.push(line);
         continue;
       }
-      const importedFilePath = path11.resolve(path11.dirname(normalizedPath), importPath);
+      const importedFilePath = path14.resolve(path14.dirname(normalizedPath), importPath);
       const importedContent = await readRequiredFile(importedFilePath, options.fs);
       const expandedImport = await expandImports({
         filePath: importedFilePath,
@@ -6099,11 +6099,11 @@ var init_poe_agent_plugin_memory = __esm({
     "use strict";
     init_parse_options();
     AGENTS_FILE = "AGENTS.md";
-    USER_MEMORY_DIRECTORY = path11.join(".config", "poe-code");
+    USER_MEMORY_DIRECTORY = path14.join(".config", "poe-code");
     memoryPlugin = (options = {}) => {
-      const cwd = path11.resolve(options.cwd ?? process.cwd());
-      const homeDir = path11.resolve(options.homeDir ?? os.homedir());
-      const fs4 = options.fs ?? fsPromises3;
+      const cwd = path14.resolve(options.cwd ?? process.cwd());
+      const homeDir = path14.resolve(options.homeDir ?? os3.homedir());
+      const fs4 = options.fs ?? fsPromises4;
       let memoryPromise;
       return {
         name: "poe-agent-plugin-memory",
@@ -7267,7 +7267,7 @@ var init_resource_indicator = __esm({
 
 // packages/mcp-oauth/dist/client/auth-store-session-store.js
 import crypto from "node:crypto";
-import path12 from "node:path";
+import path15 from "node:path";
 var init_auth_store_session_store = __esm({
   "packages/mcp-oauth/dist/client/auth-store-session-store.js"() {
     "use strict";
@@ -8595,7 +8595,7 @@ var init_resolve_provider = __esm({
 });
 
 // packages/poe-agent/src/runtime/transcript.ts
-import path13 from "node:path";
+import path16 from "node:path";
 function mapAcpEventToSessionUpdates(event) {
   if (event.type === "message.delta") {
     if (event.content.length === 0) return [];
@@ -8656,11 +8656,11 @@ function mapAcpEventToSessionUpdates(event) {
   return [];
 }
 function createTranscriptWriter(options) {
-  const join2 = options.pathJoin ?? path13.join;
+  const join2 = options.pathJoin ?? path16.join;
   const filePath = resolveTranscriptFilePath(options, join2);
   let dirEnsured;
   let disabled = false;
-  const logDir = path13.dirname(filePath);
+  const logDir = path16.dirname(filePath);
   const ensureDir = () => {
     if (!dirEnsured) {
       dirEnsured = options.fs.mkdir(logDir, { recursive: true });
@@ -8702,7 +8702,7 @@ var init_transcript = __esm({
 });
 
 // packages/poe-agent/src/agent.ts
-import * as fsPromises4 from "node:fs/promises";
+import * as fsPromises5 from "node:fs/promises";
 function agent() {
   return new ImmutableAgentBuilder();
 }
@@ -9101,8 +9101,8 @@ var init_agent = __esm({
       }
     };
     defaultTranscriptFs = {
-      mkdir: (dir, options) => fsPromises4.mkdir(dir, options).then(() => void 0),
-      appendFile: (filePath, contents) => fsPromises4.appendFile(filePath, contents, "utf8")
+      mkdir: (dir, options) => fsPromises5.mkdir(dir, options).then(() => void 0),
+      appendFile: (filePath, contents) => fsPromises5.appendFile(filePath, contents, "utf8")
     };
     CallerAcpHost = class {
       #runContext;
@@ -9903,8 +9903,8 @@ var init_model_utils = __esm({
 // packages/agent-spawn/src/spawn.ts
 import { spawn as spawnChildProcess2 } from "node:child_process";
 import { mkdirSync, openSync, writeSync, closeSync } from "node:fs";
-import path14 from "node:path";
-function createAbortError() {
+import path17 from "node:path";
+function createAbortError2() {
   const error2 = new Error("Agent spawn aborted");
   error2.name = "AbortError";
   return error2;
@@ -9985,7 +9985,7 @@ function buildCliArgs(config, options, stdinMode) {
 }
 async function spawn5(agentId, options, context) {
   if (options.signal?.aborted) {
-    throw createAbortError();
+    throw createAbortError2();
   }
   const { agentId: resolvedId, binaryName, spawnConfig } = resolveCliConfig(agentId);
   const stdinMode = options.useStdin && spawnConfig.stdinMode ? spawnConfig.stdinMode : void 0;
@@ -10056,7 +10056,7 @@ async function spawn5(agentId, options, context) {
       cleanup();
       closeSpawnLog(logFd);
       if (aborted) {
-        reject(createAbortError());
+        reject(createAbortError2());
         return;
       }
       reject(error2);
@@ -10065,7 +10065,7 @@ async function spawn5(agentId, options, context) {
       cleanup();
       closeSpawnLog(logFd);
       if (aborted) {
-        reject(createAbortError());
+        reject(createAbortError2());
         return;
       }
       if (timedOut) {
@@ -10088,11 +10088,11 @@ function resolveSpawnLogPath(options) {
   if (!options.logDir || !options.logFileName) {
     return void 0;
   }
-  return path14.join(options.logDir, options.logFileName);
+  return path17.join(options.logDir, options.logFileName);
 }
 function openSpawnLog(filePath) {
   try {
-    mkdirSync(path14.dirname(filePath), { recursive: true });
+    mkdirSync(path17.dirname(filePath), { recursive: true });
     return openSync(filePath, "a");
   } catch {
     return void 0;
@@ -16706,9 +16706,9 @@ var init_autonomous = __esm({
 });
 
 // packages/agent-spawn/src/acp/replay.ts
-import path15 from "node:path";
+import path18 from "node:path";
 import { homedir as homedir3 } from "node:os";
-import { open, readdir } from "node:fs/promises";
+import { open as open2, readdir } from "node:fs/promises";
 import { createInterface } from "node:readline";
 var init_replay = __esm({
   "packages/agent-spawn/src/acp/replay.ts"() {
@@ -16826,21 +16826,21 @@ async function* adaptClaude(lines) {
         if (blockType !== "tool_result") continue;
         const kind = toolKindsById.get(item.tool_use_id);
         toolKindsById.delete(item.tool_use_id);
-        let path30;
+        let path33;
         if (typeof item.content === "string") {
-          path30 = item.content;
+          path33 = item.content;
         } else {
           try {
-            path30 = JSON.stringify(item.content);
+            path33 = JSON.stringify(item.content);
           } catch {
-            path30 = String(item.content);
+            path33 = String(item.content);
           }
         }
         yield {
           event: "tool_complete",
           id: item.tool_use_id,
           kind,
-          path: path30
+          path: path33
         };
       }
     }
@@ -16963,10 +16963,10 @@ async function* adaptCodex(lines) {
         const kindFromStart = toolKindById.get(item.id);
         const kind = kindFromStart ?? (itemType === "command_execution" ? "exec" : itemType === "file_edit" ? "edit" : "other");
         const titleFromEvent = isNonEmptyString(item.path) ? item.path : itemType === "mcp_tool_call" ? `${isNonEmptyString(item.server) ? item.server : "unknown"}.${isNonEmptyString(item.tool) ? item.tool : "unknown"}` : void 0;
-        const path30 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
+        const path33 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
         toolTitleById.delete(item.id);
         toolKindById.delete(item.id);
-        yield { event: "tool_complete", id: item.id, kind, path: path30 };
+        yield { event: "tool_complete", id: item.id, kind, path: path33 };
       }
     }
   }
@@ -17241,7 +17241,7 @@ var init_line_reader = __esm({
 
 // packages/agent-spawn/src/acp/spawn.ts
 import { spawn as spawnChildProcess4 } from "node:child_process";
-function createAbortError2() {
+function createAbortError3() {
   const error2 = new Error("Agent spawn aborted");
   error2.name = "AbortError";
   return error2;
@@ -17267,7 +17267,7 @@ function getMcpArgsPosition2(config) {
 }
 function spawnStreaming(options) {
   if (options.signal?.aborted) {
-    throw createAbortError2();
+    throw createAbortError3();
   }
   const { agentId, binaryName, spawnConfig } = resolveConfig(options.agentId);
   if (spawnConfig === void 0) {
@@ -17363,7 +17363,7 @@ function spawnStreaming(options) {
       options.signal?.removeEventListener("abort", onAbort);
       if (activityTimer) clearTimeout(activityTimer);
       if (aborted) {
-        reject(createAbortError2());
+        reject(createAbortError3());
         return;
       }
       reject(error2);
@@ -17372,7 +17372,7 @@ function spawnStreaming(options) {
       options.signal?.removeEventListener("abort", onAbort);
       if (activityTimer) clearTimeout(activityTimer);
       if (aborted) {
-        reject(createAbortError2());
+        reject(createAbortError3());
         return;
       }
       if (timedOut) {
@@ -17490,7 +17490,7 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   }
   const id = readString(event.id);
   const kind = readString(event.kind);
-  const path30 = readString(event.path);
+  const path33 = readString(event.path);
   let toolCall = id ? toolCallsById.get(id) : void 0;
   if (!toolCall) {
     toolCall = {};
@@ -17505,8 +17505,8 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   if (kind) {
     toolCall.kind = kind;
   }
-  if (path30) {
-    toolCall.path = path30;
+  if (path33) {
+    toolCall.path = path33;
   }
 }
 var sessionCapture;
@@ -17592,9 +17592,9 @@ var init_usage_capture = __esm({
 });
 
 // packages/agent-spawn/src/acp/middlewares/spawn-log.ts
-import path16 from "node:path";
+import path19 from "node:path";
 import { homedir as homedir4 } from "node:os";
-import { mkdir as mkdir2, open as open2 } from "node:fs/promises";
+import { mkdir as mkdir2, open as open3 } from "node:fs/promises";
 function pad(value, width) {
   return String(value).padStart(width, "0");
 }
@@ -17629,14 +17629,14 @@ function resolveLogFilePath(ctx) {
   if (ctx.logPath) {
     return ctx.logPath;
   }
-  const baseDir = ctx.logDir ?? path16.join(homedir4(), ".poe-code", "spawn-logs");
+  const baseDir = ctx.logDir ?? path19.join(homedir4(), ".poe-code", "spawn-logs");
   if (ctx.logFileName) {
-    return path16.join(baseDir, ctx.logFileName);
+    return path19.join(baseDir, ctx.logFileName);
   }
   const startedAt = resolveStartedAt(ctx.startedAt);
   const { day, time, milliseconds } = formatTimestamp(startedAt);
   const fileName = `${day}-${time}-${milliseconds}-${normalizeAgent(ctx.agent)}.jsonl`;
-  return path16.join(baseDir, fileName);
+  return path19.join(baseDir, fileName);
 }
 async function writePreloadedEvents(writer, events) {
   for (const event of events) {
@@ -17654,7 +17654,7 @@ var init_spawn_log = __esm({
       logDirPath;
       constructor(ctx) {
         this.filePath = resolveLogFilePath(ctx);
-        this.logDirPath = path16.dirname(this.filePath);
+        this.logDirPath = path19.dirname(this.filePath);
       }
       async writeEvent(event) {
         if (this.isDisabled) {
@@ -17691,7 +17691,7 @@ var init_spawn_log = __esm({
         }
         try {
           await mkdir2(this.logDirPath, { recursive: true });
-          this.fileHandle = await open2(this.filePath, "a");
+          this.fileHandle = await open3(this.filePath, "a");
         } catch {
           this.isDisabled = true;
         }
@@ -18022,7 +18022,7 @@ var init_src7 = __esm({
 
 // src/providers/poe-agent.ts
 import fsPromises8 from "node:fs/promises";
-import os4 from "node:os";
+import os5 from "node:os";
 
 // src/cli/constants.ts
 var DEFAULT_FRONTIER_MODEL = "anthropic/claude-opus-4.7";
@@ -18055,6 +18055,255 @@ var DEFAULT_KIMI_MODEL = KIMI_MODELS[0];
 // src/providers/poe-agent.ts
 init_src();
 
+// packages/poe-code-config/src/runtime.ts
+import { existsSync } from "node:fs";
+import path from "node:path";
+var defaultWorkspaceExclude = [
+  ".git",
+  "node_modules",
+  "dist",
+  ".turbo",
+  ".next",
+  ".poe-code/state.json"
+];
+var runtimeConfigScope = {
+  scope: "runtime",
+  schema: {
+    type: {
+      type: "string",
+      default: "host",
+      doc: "Runtime backend: host, docker, or e2b"
+    },
+    build_args: {
+      type: "json",
+      default: {},
+      parse: parseBuildArgs,
+      doc: "Build arguments passed to the runtime image build"
+    },
+    mounts: {
+      type: "json",
+      default: [],
+      parse: parseMounts,
+      doc: "Additional runtime mounts"
+    },
+    runner: {
+      type: "json",
+      default: createDefaultRunnerScope(),
+      parse: parseRunner,
+      doc: "Runner process and workspace transfer settings"
+    },
+    link: {
+      type: "string",
+      default: "",
+      doc: "Informational link for the runtime definition"
+    },
+    image: {
+      type: "string",
+      default: "",
+      doc: "Prebuilt Docker image"
+    },
+    dockerfile: {
+      type: "string",
+      default: "",
+      doc: "Path to the Dockerfile used for docker or e2b builds"
+    },
+    build_context: {
+      type: "string",
+      default: "",
+      doc: "Path to the Docker build context"
+    },
+    engine: {
+      type: "string",
+      default: "",
+      doc: "Container engine for Docker runtime"
+    },
+    network: {
+      type: "string",
+      default: "",
+      doc: "Docker network"
+    },
+    extra_args: {
+      type: "json",
+      default: void 0,
+      parse: parseOptionalStringArray,
+      doc: "Extra Docker runtime arguments"
+    },
+    template_id: {
+      type: "string",
+      default: "",
+      doc: "Prebuilt E2B template id"
+    },
+    cpu: {
+      type: "json",
+      default: void 0,
+      parse: parseOptionalNumber,
+      doc: "E2B CPU count"
+    },
+    memory_mb: {
+      type: "json",
+      default: void 0,
+      parse: parseOptionalNumber,
+      doc: "E2B memory in megabytes"
+    },
+    timeout_minutes: {
+      type: "json",
+      default: void 0,
+      parse: parseOptionalNumber,
+      doc: "E2B timeout in minutes"
+    },
+    preserve_after_exit_hours: {
+      type: "json",
+      default: void 0,
+      parse: parseOptionalNumber,
+      doc: "Hours to keep an E2B sandbox alive after job exit"
+    },
+    api_key_env: {
+      type: "string",
+      default: "",
+      doc: "Environment variable name containing the E2B API key"
+    }
+  }
+};
+function parseRunner(raw) {
+  if (raw === void 0) {
+    return createDefaultRunnerScope();
+  }
+  const record = asRecord(raw);
+  if (record === void 0) {
+    throw new Error("runner: expected an object.");
+  }
+  const uploadMaxFileMb = parseOptionalNumber(record.upload_max_file_mb, "runner.upload_max_file_mb") ?? 100;
+  if (uploadMaxFileMb <= 0) {
+    throw new Error("runner.upload_max_file_mb: expected a positive finite number.");
+  }
+  return omitUndefined({
+    detach: parseOptionalBoolean(record.detach, "runner.detach") ?? false,
+    upload_max_file_mb: uploadMaxFileMb,
+    download_conflict: parseDownloadConflict(record.download_conflict),
+    workspace: parseRunnerWorkspace(record.workspace)
+  });
+}
+function createDefaultRunnerScope() {
+  return {
+    detach: false,
+    upload_max_file_mb: 100,
+    download_conflict: "refuse",
+    workspace: {
+      exclude: [...defaultWorkspaceExclude]
+    }
+  };
+}
+function parseRunnerWorkspace(value) {
+  if (value === void 0) {
+    return {
+      exclude: [...defaultWorkspaceExclude]
+    };
+  }
+  const record = asRecord(value);
+  if (record === void 0) {
+    throw new Error("runner.workspace: expected an object.");
+  }
+  return {
+    exclude: parseOptionalStringArray(record.exclude, "runner.workspace.exclude") ?? [
+      ...defaultWorkspaceExclude
+    ]
+  };
+}
+function parseDownloadConflict(value) {
+  if (value === void 0) {
+    return "refuse";
+  }
+  if (value === "refuse" || value === "overwrite") {
+    return value;
+  }
+  throw new Error('runner.download_conflict: expected "refuse" or "overwrite".');
+}
+function parseBuildArgs(value) {
+  if (value === void 0) {
+    return {};
+  }
+  const record = asRecord(value);
+  if (record === void 0) {
+    throw new Error("build_args: expected an object.");
+  }
+  const parsed = {};
+  for (const [key2, entry] of Object.entries(record)) {
+    if (typeof entry !== "string") {
+      throw new Error(`build_args.${key2}: expected a string.`);
+    }
+    parsed[key2] = entry;
+  }
+  return parsed;
+}
+function parseMounts(value) {
+  if (value === void 0) {
+    return [];
+  }
+  if (!Array.isArray(value)) {
+    throw new Error("mounts: expected an array.");
+  }
+  return value.map((entry, index) => {
+    const record = asRecord(entry);
+    if (record === void 0) {
+      throw new Error(`mounts[${index}]: expected an object.`);
+    }
+    const source = record.source;
+    const target = record.target;
+    if (typeof source !== "string") {
+      throw new Error(`mounts[${index}].source: expected a string.`);
+    }
+    if (typeof target !== "string") {
+      throw new Error(`mounts[${index}].target: expected a string.`);
+    }
+    return omitUndefined({
+      source,
+      target,
+      readonly: parseOptionalBoolean(record.readonly, `mounts[${index}].readonly`)
+    });
+  });
+}
+function parseOptionalStringArray(value, key2 = "") {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!Array.isArray(value)) {
+    throw new Error(`${key2 ? `${key2}: ` : ""}expected an array.`);
+  }
+  return value.map((entry, index) => {
+    if (typeof entry !== "string") {
+      throw new Error(`${key2}[${index}]: expected a string.`);
+    }
+    return entry;
+  });
+}
+function parseOptionalNumber(value, key2 = "") {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`${key2 ? `${key2}: ` : ""}expected a finite number.`);
+  }
+  return value;
+}
+function parseOptionalBoolean(value, key2) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "boolean") {
+    throw new Error(`${key2}: expected a boolean.`);
+  }
+  return value;
+}
+function asRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function omitUndefined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
+}
+
 // packages/poe-code-config/src/schema.ts
 function defineScope(scope, schema) {
   return {
@@ -18074,15 +18323,15 @@ var planConfigScope = defineScope("plan", {
 });
 
 // packages/poe-code-config/src/store.ts
-import path5 from "node:path";
+import path6 from "node:path";
 
 // packages/config-extends/src/discover.ts
-import path from "node:path";
+import path2 from "node:path";
 async function findBase(name, bases, fs4) {
   const checkedPaths = [];
   for (const basePath of bases) {
     for (const extension of [".md", ".yaml", ".yml", ".json"]) {
-      const filePath = path.join(basePath, `${name}${extension}`);
+      const filePath = path2.join(basePath, `${name}${extension}`);
       checkedPaths.push(filePath);
       try {
         return {
@@ -18106,7 +18355,7 @@ function hasCode(error2, code) {
 }
 
 // packages/config-extends/src/parse.ts
-import path2 from "node:path";
+import path3 from "node:path";
 import matter from "gray-matter";
 import { parse as parseYaml } from "yaml";
 function parseDocument(content, filePath) {
@@ -18124,7 +18373,7 @@ function parseDocument(content, filePath) {
   };
 }
 function detectFormat(content, filePath) {
-  const extension = path2.extname(filePath).toLowerCase();
+  const extension = path3.extname(filePath).toLowerCase();
   if (extension === ".md") {
     return "markdown";
   }
@@ -18166,11 +18415,11 @@ function stripBom(content) {
 function mergeLayers(layers) {
   return mergeObjectLayers(layers, []);
 }
-function mergeObjectLayers(layers, path30) {
+function mergeObjectLayers(layers, path33) {
   const data = {};
   const sources = {};
   for (const key2 of collectKeys(layers)) {
-    const resolved = resolveKey(layers, key2, path30);
+    const resolved = resolveKey(layers, key2, path33);
     if (resolved === void 0) {
       continue;
     }
@@ -18188,7 +18437,7 @@ function collectKeys(layers) {
   }
   return [...keys];
 }
-function resolveKey(layers, key2, path30) {
+function resolveKey(layers, key2, path33) {
   let winningSource;
   let winningValue;
   const objectLayers = [];
@@ -18218,9 +18467,9 @@ function resolveKey(layers, key2, path30) {
   if (winningSource === void 0) {
     return void 0;
   }
-  const fullPath = buildPath(path30, key2);
+  const fullPath = buildPath(path33, key2);
   if (isPlainObject(winningValue)) {
-    const merged = mergeObjectLayers(objectLayers, [...path30, key2]);
+    const merged = mergeObjectLayers(objectLayers, [...path33, key2]);
     return {
       value: merged.data,
       sources: {
@@ -18245,8 +18494,8 @@ function isWinningCandidate(key2, value) {
   }
   return true;
 }
-function buildPath(path30, key2) {
-  return [...path30, key2].join(".");
+function buildPath(path33, key2) {
+  return [...path33, key2].join(".");
 }
 function isPlainObject(value) {
   if (value === null || Array.isArray(value) || typeof value !== "object") {
@@ -18270,7 +18519,7 @@ function cloneValue(value) {
 }
 
 // packages/config-extends/src/resolve.ts
-import path3 from "node:path";
+import path4 from "node:path";
 var MAX_EXTENDS_DEPTH = 5;
 var YIELD_TOKEN = "{{yield}}";
 async function resolve(chain, options) {
@@ -18368,7 +18617,7 @@ Visited files:
     );
   }
   const matchedBaseIndex = baseLayers.findIndex(
-    (layer) => layer.path === path3.dirname(discoveredBase.filePath)
+    (layer) => layer.path === path4.dirname(discoveredBase.filePath)
   );
   if (matchedBaseIndex === -1) {
     throw new Error(`Resolved base is outside configured base paths: ${discoveredBase.filePath}`);
@@ -18482,7 +18731,7 @@ function stripResolvedBasePrompts(layers, consumedBaseIndexes) {
   });
 }
 function getBaseName(filePath) {
-  return path3.basename(filePath, path3.extname(filePath));
+  return path4.basename(filePath, path4.extname(filePath));
 }
 function shouldResolveBase(parsedDocument, autoExtend) {
   return parsedDocument.extends || autoExtend === true && !parsedDocument.hasExtendsField;
@@ -18844,20 +19093,20 @@ function getConfigFormat(pathOrFormat) {
   }
   return formatRegistry[formatName];
 }
-function detectFormat2(path30) {
-  const ext = getExtension(path30);
+function detectFormat2(path33) {
+  const ext = getExtension(path33);
   return extensionMap[ext];
 }
-function getExtension(path30) {
-  const lastDot = path30.lastIndexOf(".");
+function getExtension(path33) {
+  const lastDot = path33.lastIndexOf(".");
   if (lastDot === -1) {
     return "";
   }
-  return path30.slice(lastDot).toLowerCase();
+  return path33.slice(lastDot).toLowerCase();
 }
 
 // packages/config-mutations/src/execution/path-utils.ts
-import path4 from "node:path";
+import path5 from "node:path";
 function expandHome(targetPath, homeDir) {
   if (!targetPath?.startsWith("~")) {
     return targetPath;
@@ -18874,7 +19123,7 @@ function expandHome(targetPath, homeDir) {
       remainder = remainder.slice(1);
     }
   }
-  return remainder.length === 0 ? homeDir : path4.join(homeDir, remainder);
+  return remainder.length === 0 ? homeDir : path5.join(homeDir, remainder);
 }
 function validateHomePath(targetPath) {
   if (typeof targetPath !== "string" || targetPath.length === 0) {
@@ -18892,12 +19141,12 @@ function resolvePath(rawPath, homeDir, pathMapper) {
   if (!pathMapper) {
     return expanded;
   }
-  const rawDirectory = path4.dirname(expanded);
+  const rawDirectory = path5.dirname(expanded);
   const mappedDirectory = pathMapper.mapTargetDirectory({
     targetDirectory: rawDirectory
   });
-  const filename = path4.basename(expanded);
-  return filename.length === 0 ? mappedDirectory : path4.join(mappedDirectory, filename);
+  const filename = path5.basename(expanded);
+  return filename.length === 0 ? mappedDirectory : path5.join(mappedDirectory, filename);
 }
 
 // packages/config-mutations/src/fs-utils.ts
@@ -19533,7 +19782,7 @@ async function readMergedDocument(fs4, globalPath, projectPath) {
       },
       {
         source: "base",
-        path: path5.dirname(globalPath)
+        path: path6.dirname(globalPath)
       }
     ],
     {
@@ -19610,31 +19859,31 @@ function createResolvedConfigFs(fs4, globalPath, globalContent) {
   };
 }
 async function writeDocument(fs4, filePath, document) {
-  await fs4.mkdir(path5.dirname(filePath), { recursive: true });
+  await fs4.mkdir(path6.dirname(filePath), { recursive: true });
   await fs4.writeFile(filePath, `${JSON.stringify(document, null, 2)}
 `, {
     encoding: "utf8"
   });
 }
 async function recoverInvalidDocument(fs4, filePath, content) {
-  await fs4.mkdir(path5.dirname(filePath), { recursive: true });
+  await fs4.mkdir(path6.dirname(filePath), { recursive: true });
   const backupPath = createInvalidBackupPath(filePath);
   await fs4.writeFile(backupPath, content, { encoding: "utf8" });
   await fs4.writeFile(filePath, EMPTY_DOCUMENT, { encoding: "utf8" });
 }
 function createInvalidBackupPath(filePath) {
-  const directory = path5.dirname(filePath);
-  const baseName = path5.basename(filePath);
-  return path5.join(directory, `${baseName}.invalid-${createTimestamp()}.json`);
+  const directory = path6.dirname(filePath);
+  const baseName = path6.basename(filePath);
+  return path6.join(directory, `${baseName}.invalid-${createTimestamp()}.json`);
 }
 function isRecord(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function resolveConfigPath(homeDir) {
-  return path5.join(homeDir, ".poe-code", "config.json");
+  return path6.join(homeDir, ".poe-code", "config.json");
 }
 function resolveProjectConfigPath(cwd) {
-  return path5.join(cwd, ".poe-code", "config.json");
+  return path6.join(cwd, ".poe-code", "config.json");
 }
 var EMPTY_DOCUMENT = `${JSON.stringify({}, null, 2)}
 `;
@@ -19751,75 +20000,284 @@ async function resolveScopedValues(options, definition, env) {
 }
 
 // packages/poe-code-config/src/inspect.ts
-import path6 from "node:path";
+import path7 from "node:path";
 var EMPTY_DOCUMENT2 = `${JSON.stringify({}, null, 2)}
 `;
 
-// src/services/service-install.ts
-async function runServiceInstall(definition, context) {
-  const checkContext = {
-    isDryRun: context.isDryRun,
-    runCommand: context.runCommand
-  };
-  let needsInstall = false;
-  try {
-    await definition.check.run(checkContext);
-    context.logger(`${definition.summary} already installed.`);
-  } catch (error2) {
-    const detail = error2 instanceof Error ? error2.message : String(error2);
-    context.logger(`${definition.summary} not detected: ${detail}`);
-    needsInstall = true;
-  }
-  if (!needsInstall) {
-    return false;
+// packages/poe-code-config/src/state/index.ts
+import os2 from "node:os";
+
+// packages/poe-code-config/src/state/jobs.ts
+import path8 from "node:path";
+
+// packages/file-lock/src/lock.ts
+import * as fsPromises2 from "node:fs/promises";
+import * as os from "node:os";
+var LockTimeoutError = class extends Error {
+  constructor(message2) {
+    super(message2);
+    this.name = "LockTimeoutError";
   }
-  if (context.isDryRun) {
-    logInstallDryRun(definition, context);
-    return true;
+};
+function createAbortError() {
+  const error2 = new Error("The operation was aborted.");
+  error2.name = "AbortError";
+  return error2;
+}
+function throwIfAborted(signal) {
+  if (signal?.aborted) {
+    throw createAbortError();
   }
-  const platformSteps = filterStepsByPlatform(definition.steps, context.platform);
-  for (const step of platformSteps) {
-    await runInstallStep(step, context);
+}
+function sleep(ms, signal) {
+  if (!signal) {
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
   }
-  await definition.check.run(checkContext);
-  if (definition.postChecks) {
-    for (const postCheck of definition.postChecks) {
-      await postCheck.run(checkContext);
-    }
+  if (signal.aborted) {
+    return Promise.reject(createAbortError());
   }
-  context.logger(
-    definition.successMessage ?? `${definition.summary} installed.`
-  );
-  return true;
-}
-function describeInstallCommand(step) {
-  return `[${step.id}] ${formatCommand(step.command, step.args)}`;
+  return new Promise((resolve2, reject) => {
+    const timeoutId = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve2();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timeoutId);
+      signal.removeEventListener("abort", onAbort);
+      reject(createAbortError());
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
 }
-function formatCommand(command, args) {
-  return [command, ...args.map(quoteIfNeeded)].join(" ");
+function backoff(attempt, minTimeout, maxTimeout) {
+  const delay = Math.min(maxTimeout, minTimeout * 2 ** attempt);
+  return delay + Math.random() * delay * 0.1;
 }
-function quoteIfNeeded(value) {
-  if (value.length === 0) {
-    return '""';
-  }
-  if (value.includes(" ") || value.includes("	") || value.includes("\n")) {
-    return `"${value.replaceAll('"', '\\"')}"`;
-  }
-  return value;
+function hasErrorCode(error2, code) {
+  return !!error2 && typeof error2 === "object" && "code" in error2 && error2.code === code;
 }
-function filterStepsByPlatform(steps, platform) {
-  return steps.filter(
-    (step) => !step.platforms || step.platforms.includes(platform)
-  );
+function hasAnyErrorCode(error2, codes) {
+  return codes.some((code) => hasErrorCode(error2, code));
 }
-function logInstallDryRun(definition, context) {
-  context.logger(`Dry run: would install ${definition.summary}.`);
-  const platformSteps = filterStepsByPlatform(definition.steps, context.platform);
-  for (const step of platformSteps) {
-    context.logger(`Dry run: ${describeInstallCommand(step)}`);
+function isPidRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error2) {
+    return !hasErrorCode(error2, "ESRCH");
   }
 }
-async function runInstallStep(step, context) {
+function createDefaultFs() {
+  return {
+    open: (path33, flags) => fsPromises2.open(path33, flags),
+    readFile: (path33, encoding) => fsPromises2.readFile(path33, encoding),
+    stat: fsPromises2.stat,
+    unlink: fsPromises2.unlink
+  };
+}
+async function removeLockFile(fs4, lockPath, signal) {
+  for (let attempt = 0; attempt <= 4; attempt += 1) {
+    throwIfAborted(signal);
+    try {
+      await fs4.unlink(lockPath);
+      return;
+    } catch (error2) {
+      if (hasErrorCode(error2, "ENOENT")) {
+        return;
+      }
+      if (!hasAnyErrorCode(error2, ["EPERM", "EBUSY"]) || attempt === 4) {
+        throw error2;
+      }
+    }
+    await sleep(25 * 2 ** attempt, signal);
+  }
+}
+function parseLockMetadata(content) {
+  try {
+    const parsed = JSON.parse(content);
+    if (!parsed || typeof parsed !== "object" || !("host" in parsed) || !("pid" in parsed)) {
+      return void 0;
+    }
+    const { host, pid } = parsed;
+    if (typeof host === "string" && typeof pid === "number" && Number.isSafeInteger(pid) && pid > 0) {
+      return {
+        host,
+        pid
+      };
+    }
+  } catch (ignoredError) {
+    void ignoredError;
+  }
+  return void 0;
+}
+async function readLockMetadata(fs4, lockPath) {
+  if (!fs4.readFile) {
+    return void 0;
+  }
+  try {
+    return parseLockMetadata(await fs4.readFile(lockPath, "utf8"));
+  } catch (error2) {
+    if (hasErrorCode(error2, "ENOENT")) {
+      return null;
+    }
+    return void 0;
+  }
+}
+async function shouldReclaimLock(options) {
+  const metadata = await readLockMetadata(options.fs, options.lockPath);
+  if (metadata === null) {
+    return "missing";
+  }
+  if (metadata?.host === os.hostname()) {
+    return !options.isPidRunning(metadata.pid);
+  }
+  return Date.now() - options.stat.mtimeMs > options.staleMs;
+}
+async function writeLockMetadata(handle) {
+  try {
+    await handle.writeFile(
+      JSON.stringify({ pid: process.pid, host: os.hostname(), acquiredAt: (/* @__PURE__ */ new Date()).toISOString() }),
+      { encoding: "utf8" }
+    );
+  } catch (ignoredError) {
+    void ignoredError;
+  }
+  try {
+    await handle.close();
+  } catch (ignoredError) {
+    void ignoredError;
+  }
+}
+async function acquireFileLock(filePath, options = {}) {
+  const fs4 = options.fs ?? createDefaultFs();
+  const retries = options.retries ?? 20;
+  const minTimeout = options.minTimeout ?? 25;
+  const maxTimeout = options.maxTimeout ?? 250;
+  const staleMs = options.staleMs ?? 1e3;
+  const pidIsRunning = options.isPidRunning ?? isPidRunning;
+  const lockPath = `${filePath}.lock`;
+  let attempt = 0;
+  while (attempt <= retries) {
+    throwIfAborted(options.signal);
+    try {
+      const handle = await fs4.open(lockPath, "wx");
+      await writeLockMetadata(handle);
+      let released = false;
+      return async () => {
+        if (released) {
+          return;
+        }
+        released = true;
+        await removeLockFile(fs4, lockPath, options.signal);
+      };
+    } catch (error2) {
+      if (!hasErrorCode(error2, "EEXIST")) {
+        throw error2;
+      }
+    }
+    let stat7;
+    try {
+      stat7 = await fs4.stat(lockPath);
+    } catch (statError) {
+      if (hasErrorCode(statError, "ENOENT")) {
+        continue;
+      }
+      throw statError;
+    }
+    const reclaimLock = await shouldReclaimLock({
+      fs: fs4,
+      isPidRunning: pidIsRunning,
+      lockPath,
+      staleMs,
+      stat: stat7
+    });
+    if (reclaimLock === "missing") {
+      continue;
+    }
+    if (reclaimLock) {
+      await removeLockFile(fs4, lockPath, options.signal);
+      continue;
+    }
+    if (attempt >= retries) {
+      break;
+    }
+    await sleep(backoff(attempt, minTimeout, maxTimeout), options.signal);
+    attempt += 1;
+  }
+  throw new LockTimeoutError(`Failed to acquire lock on "${filePath}".`);
+}
+
+// packages/poe-code-config/src/state/fs.ts
+import * as nodeFs from "node:fs/promises";
+
+// packages/poe-code-config/src/state/templates.ts
+import path9 from "node:path";
+
+// src/services/service-install.ts
+async function runServiceInstall(definition, context) {
+  const checkContext = {
+    isDryRun: context.isDryRun,
+    runCommand: context.runCommand
+  };
+  let needsInstall = false;
+  try {
+    await definition.check.run(checkContext);
+    context.logger(`${definition.summary} already installed.`);
+  } catch (error2) {
+    const detail = error2 instanceof Error ? error2.message : String(error2);
+    context.logger(`${definition.summary} not detected: ${detail}`);
+    needsInstall = true;
+  }
+  if (!needsInstall) {
+    return false;
+  }
+  if (context.isDryRun) {
+    logInstallDryRun(definition, context);
+    return true;
+  }
+  const platformSteps = filterStepsByPlatform(definition.steps, context.platform);
+  for (const step of platformSteps) {
+    await runInstallStep(step, context);
+  }
+  await definition.check.run(checkContext);
+  if (definition.postChecks) {
+    for (const postCheck of definition.postChecks) {
+      await postCheck.run(checkContext);
+    }
+  }
+  context.logger(
+    definition.successMessage ?? `${definition.summary} installed.`
+  );
+  return true;
+}
+function describeInstallCommand(step) {
+  return `[${step.id}] ${formatCommand(step.command, step.args)}`;
+}
+function formatCommand(command, args) {
+  return [command, ...args.map(quoteIfNeeded)].join(" ");
+}
+function quoteIfNeeded(value) {
+  if (value.length === 0) {
+    return '""';
+  }
+  if (value.includes(" ") || value.includes("	") || value.includes("\n")) {
+    return `"${value.replaceAll('"', '\\"')}"`;
+  }
+  return value;
+}
+function filterStepsByPlatform(steps, platform) {
+  return steps.filter(
+    (step) => !step.platforms || step.platforms.includes(platform)
+  );
+}
+function logInstallDryRun(definition, context) {
+  context.logger(`Dry run: would install ${definition.summary}.`);
+  const platformSteps = filterStepsByPlatform(definition.steps, context.platform);
+  for (const step of platformSteps) {
+    context.logger(`Dry run: ${describeInstallCommand(step)}`);
+  }
+}
+async function runInstallStep(step, context) {
   context.logger(`Running ${describeInstallCommand(step)}`);
   const result = await context.runCommand(step.command, step.args);
   if (result.exitCode !== 0) {
@@ -19910,16 +20368,16 @@ function createInstallRunner(definition) {
 }
 
 // src/services/config.ts
-import path29 from "node:path";
+import path32 from "node:path";
 init_src7();
 
 // packages/superintendent/src/document/parse.ts
-import path17 from "node:path";
+import path20 from "node:path";
 import { parseDocument as parseDocument2 } from "yaml";
 var superintendentDocumentSchemaId = "https://poe-platform.github.io/poe-code/schemas/plans/superintendent.schema.json";
 var validStatusStates = /* @__PURE__ */ new Set(["in_progress", "review", "completed"]);
 function parseSuperintendentDoc(filePath, content) {
-  const resolvedFilePath = path17.resolve(filePath);
+  const resolvedFilePath = path20.resolve(filePath);
   const { frontmatterText, body } = splitFrontmatter(resolvedFilePath, content);
   const parsedFrontmatter = parseYamlFrontmatter(resolvedFilePath, frontmatterText);
   return {
@@ -19929,7 +20387,7 @@ function parseSuperintendentDoc(filePath, content) {
   };
 }
 function readExplicitBuilderAgent(filePath, content) {
-  const resolvedFilePath = path17.resolve(filePath);
+  const resolvedFilePath = path20.resolve(filePath);
   const { frontmatterText } = splitFrontmatter(resolvedFilePath, content);
   const parsedFrontmatter = parseYamlFrontmatter(resolvedFilePath, frontmatterText);
   const frontmatter = expectRecord(parsedFrontmatter, "frontmatter", resolvedFilePath);
@@ -20120,7 +20578,7 @@ function isRecord3(value) {
 }
 
 // packages/superintendent/src/document/write.ts
-import path18 from "node:path";
+import path21 from "node:path";
 import { isMap, parseDocument as parseDocument3 } from "yaml";
 function updateStatus(filePath, content, status) {
   return updateFrontmatter(filePath, content, (frontmatterDocument) => {
@@ -20141,7 +20599,7 @@ function setStatusReason(filePath, content, reason) {
   });
 }
 function updateFrontmatter(filePath, content, mutate) {
-  const resolvedFilePath = path18.resolve(filePath);
+  const resolvedFilePath = path21.resolve(filePath);
   const parts = splitDocument(resolvedFilePath, content);
   const frontmatterDocument = parseDocument3(parts.frontmatterText);
   if (frontmatterDocument.errors.length > 0) {
@@ -20366,19 +20824,19 @@ function extractText(node) {
 }
 
 // packages/superintendent/src/runtime/loop.ts
-import path22 from "node:path";
+import path25 from "node:path";
 import * as fsPromises6 from "node:fs/promises";
 
 // packages/agent-harness-tools/src/paths.ts
-import path19 from "node:path";
+import path22 from "node:path";
 function resolveWorkflowPath(inputPath, cwd, homeDir) {
   if (inputPath.startsWith("~/")) {
-    return path19.join(homeDir, inputPath.slice(2));
+    return path22.join(homeDir, inputPath.slice(2));
   }
   if (inputPath === "~") {
     return homeDir;
   }
-  return path19.isAbsolute(inputPath) ? inputPath : path19.resolve(cwd, inputPath);
+  return path22.isAbsolute(inputPath) ? inputPath : path22.resolve(cwd, inputPath);
 }
 
 // packages/agent-harness-tools/src/participant.ts
@@ -20430,211 +20888,14 @@ async function resolveLoopAgent(input) {
   return resolveSelectedAgent(selectedAgent);
 }
 
-// packages/file-lock/src/lock.ts
-import * as fsPromises5 from "node:fs/promises";
-import * as os2 from "node:os";
-var LockTimeoutError = class extends Error {
-  constructor(message2) {
-    super(message2);
-    this.name = "LockTimeoutError";
-  }
-};
-function createAbortError3() {
-  const error2 = new Error("The operation was aborted.");
-  error2.name = "AbortError";
-  return error2;
-}
-function throwIfAborted(signal) {
-  if (signal?.aborted) {
-    throw createAbortError3();
-  }
-}
-function sleep(ms, signal) {
-  if (!signal) {
-    return new Promise((resolve2) => setTimeout(resolve2, ms));
-  }
-  if (signal.aborted) {
-    return Promise.reject(createAbortError3());
-  }
-  return new Promise((resolve2, reject) => {
-    const timeoutId = setTimeout(() => {
-      signal.removeEventListener("abort", onAbort);
-      resolve2();
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(timeoutId);
-      signal.removeEventListener("abort", onAbort);
-      reject(createAbortError3());
-    };
-    signal.addEventListener("abort", onAbort, { once: true });
-  });
-}
-function backoff(attempt, minTimeout, maxTimeout) {
-  const delay = Math.min(maxTimeout, minTimeout * 2 ** attempt);
-  return delay + Math.random() * delay * 0.1;
-}
-function hasErrorCode(error2, code) {
-  return !!error2 && typeof error2 === "object" && "code" in error2 && error2.code === code;
-}
-function hasAnyErrorCode(error2, codes) {
-  return codes.some((code) => hasErrorCode(error2, code));
-}
-function isPidRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error2) {
-    return !hasErrorCode(error2, "ESRCH");
-  }
-}
-function createDefaultFs() {
-  return {
-    open: (path30, flags) => fsPromises5.open(path30, flags),
-    readFile: (path30, encoding) => fsPromises5.readFile(path30, encoding),
-    stat: fsPromises5.stat,
-    unlink: fsPromises5.unlink
-  };
-}
-async function removeLockFile(fs4, lockPath, signal) {
-  for (let attempt = 0; attempt <= 4; attempt += 1) {
-    throwIfAborted(signal);
-    try {
-      await fs4.unlink(lockPath);
-      return;
-    } catch (error2) {
-      if (hasErrorCode(error2, "ENOENT")) {
-        return;
-      }
-      if (!hasAnyErrorCode(error2, ["EPERM", "EBUSY"]) || attempt === 4) {
-        throw error2;
-      }
-    }
-    await sleep(25 * 2 ** attempt, signal);
-  }
-}
-function parseLockMetadata(content) {
-  try {
-    const parsed = JSON.parse(content);
-    if (!parsed || typeof parsed !== "object" || !("host" in parsed) || !("pid" in parsed)) {
-      return void 0;
-    }
-    const { host, pid } = parsed;
-    if (typeof host === "string" && typeof pid === "number" && Number.isSafeInteger(pid) && pid > 0) {
-      return {
-        host,
-        pid
-      };
-    }
-  } catch (ignoredError) {
-    void ignoredError;
-  }
-  return void 0;
-}
-async function readLockMetadata(fs4, lockPath) {
-  if (!fs4.readFile) {
-    return void 0;
-  }
-  try {
-    return parseLockMetadata(await fs4.readFile(lockPath, "utf8"));
-  } catch (error2) {
-    if (hasErrorCode(error2, "ENOENT")) {
-      return null;
-    }
-    return void 0;
-  }
-}
-async function shouldReclaimLock(options) {
-  const metadata = await readLockMetadata(options.fs, options.lockPath);
-  if (metadata === null) {
-    return "missing";
-  }
-  if (metadata?.host === os2.hostname()) {
-    return !options.isPidRunning(metadata.pid);
-  }
-  return Date.now() - options.stat.mtimeMs > options.staleMs;
-}
-async function writeLockMetadata(handle) {
-  try {
-    await handle.writeFile(
-      JSON.stringify({ pid: process.pid, host: os2.hostname(), acquiredAt: (/* @__PURE__ */ new Date()).toISOString() }),
-      { encoding: "utf8" }
-    );
-  } catch (ignoredError) {
-    void ignoredError;
-  }
-  try {
-    await handle.close();
-  } catch (ignoredError) {
-    void ignoredError;
-  }
-}
-async function acquireFileLock(filePath, options = {}) {
-  const fs4 = options.fs ?? createDefaultFs();
-  const retries = options.retries ?? 20;
-  const minTimeout = options.minTimeout ?? 25;
-  const maxTimeout = options.maxTimeout ?? 250;
-  const staleMs = options.staleMs ?? 1e3;
-  const pidIsRunning = options.isPidRunning ?? isPidRunning;
-  const lockPath = `${filePath}.lock`;
-  let attempt = 0;
-  while (attempt <= retries) {
-    throwIfAborted(options.signal);
-    try {
-      const handle = await fs4.open(lockPath, "wx");
-      await writeLockMetadata(handle);
-      let released = false;
-      return async () => {
-        if (released) {
-          return;
-        }
-        released = true;
-        await removeLockFile(fs4, lockPath, options.signal);
-      };
-    } catch (error2) {
-      if (!hasErrorCode(error2, "EEXIST")) {
-        throw error2;
-      }
-    }
-    let stat7;
-    try {
-      stat7 = await fs4.stat(lockPath);
-    } catch (statError) {
-      if (hasErrorCode(statError, "ENOENT")) {
-        continue;
-      }
-      throw statError;
-    }
-    const reclaimLock = await shouldReclaimLock({
-      fs: fs4,
-      isPidRunning: pidIsRunning,
-      lockPath,
-      staleMs,
-      stat: stat7
-    });
-    if (reclaimLock === "missing") {
-      continue;
-    }
-    if (reclaimLock) {
-      await removeLockFile(fs4, lockPath, options.signal);
-      continue;
-    }
-    if (attempt >= retries) {
-      break;
-    }
-    await sleep(backoff(attempt, minTimeout, maxTimeout), options.signal);
-    attempt += 1;
-  }
-  throw new LockTimeoutError(`Failed to acquire lock on "${filePath}".`);
-}
-
 // packages/agent-harness-tools/src/run-logs.ts
-import path20 from "node:path";
+import path23 from "node:path";
 function resolveRunLogDir(options) {
   const slug = slugifyPlanPath(options.planPath);
-  return path20.join(options.homeDir, ".poe-code", "logs", options.runner, slug);
+  return path23.join(options.homeDir, ".poe-code", "logs", options.runner, slug);
 }
 function slugifyPlanPath(planPath) {
-  const base = path20.basename(planPath);
+  const base = path23.basename(planPath);
   const dot = base.lastIndexOf(".");
   const stem = dot > 0 ? base.slice(0, dot) : base;
   return slugifyLabel(stem);
@@ -20714,15 +20975,15 @@ function createLoopState(doc) {
 init_src6();
 
 // packages/superintendent/src/runtime/resolve-cwd.ts
-import path21 from "node:path";
+import path24 from "node:path";
 function resolveRoleCwd(role, docPath, defaultCwd) {
   if (role.cwd === void 0) {
     return defaultCwd;
   }
-  if (path21.isAbsolute(role.cwd)) {
+  if (path24.isAbsolute(role.cwd)) {
     return role.cwd;
   }
-  return path21.resolve(path21.dirname(docPath), role.cwd);
+  return path24.resolve(path24.dirname(docPath), role.cwd);
 }
 
 // packages/superintendent/src/runtime/templates.ts
@@ -21869,7 +22130,7 @@ async function executeSuperintendent(options, context) {
 function buildRoleOptions(options, role) {
   return {
     defaultCwd: options.cwd,
-    ...options.logDir ? { logPath: path22.join(options.logDir, makeRunLogFileName(role)) } : {}
+    ...options.logDir ? { logPath: path25.join(options.logDir, makeRunLogFileName(role)) } : {}
   };
 }
 function shouldContinueReview(doc) {
@@ -22122,8 +22383,8 @@ var S = {
 };
 
 // packages/toolcraft/src/package-metadata.ts
-import { existsSync, readFileSync as readFileSync2, statSync } from "node:fs";
-import path23 from "node:path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "node:fs";
+import path26 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // packages/toolcraft/src/index.ts
@@ -22540,14 +22801,14 @@ function hasCode2(error2, code) {
 }
 
 // packages/superintendent/src/commands/install.ts
-import path26 from "node:path";
+import path29 from "node:path";
 import { readFile as readFile5, stat as stat4, mkdir as mkdir4, writeFile as writeFile2, unlink as unlink3, readdir as readdir3, chmod as chmod2 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // packages/agent-skill-config/src/configs.ts
 init_src4();
-import os3 from "node:os";
-import path24 from "node:path";
+import os4 from "node:os";
+import path27 from "node:path";
 var agentSkillConfigs = {
   "claude-code": {
     globalSkillDir: "~/.claude/skills",
@@ -22581,7 +22842,7 @@ function resolveAgentSupport(input, registry = agentSkillConfigs) {
 
 // packages/agent-skill-config/src/templates.ts
 import { readFile as readFile4, stat as stat3 } from "node:fs/promises";
-import path25 from "node:path";
+import path28 from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 
 // packages/agent-skill-config/src/apply.ts
@@ -22735,9 +22996,9 @@ async function resolvePlanDirectory(cwd, homeDir, env) {
 }
 function resolveAbsoluteDirectory(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path26.join(homeDir, dir.slice(2));
+    return path29.join(homeDir, dir.slice(2));
   }
-  return path26.isAbsolute(dir) ? dir : path26.resolve(cwd, dir);
+  return path29.isAbsolute(dir) ? dir : path29.resolve(cwd, dir);
 }
 async function pathExists2(targetPath) {
   try {
@@ -22757,15 +23018,15 @@ async function loadSkillTemplate() {
   }
   const packageRoot = await findPackageRoot(fileURLToPath5(import.meta.url));
   const templateRoots = [
-    path26.join(packageRoot, "src", "templates"),
-    path26.join(packageRoot, "dist", "templates")
+    path29.join(packageRoot, "src", "templates"),
+    path29.join(packageRoot, "dist", "templates")
   ];
   for (const templateRoot of templateRoots) {
     if (!await pathExists2(templateRoot)) {
       continue;
     }
     skillTemplateCache = await readFile5(
-      path26.join(templateRoot, "SKILL_superintendent.md"),
+      path29.join(templateRoot, "SKILL_superintendent.md"),
       "utf8"
     );
     return skillTemplateCache;
@@ -22773,12 +23034,12 @@ async function loadSkillTemplate() {
   throw new Error("Unable to locate Superintendent skill template.");
 }
 async function findPackageRoot(entryFilePath) {
-  let currentPath = path26.dirname(entryFilePath);
+  let currentPath = path29.dirname(entryFilePath);
   while (true) {
-    if (await pathExists2(path26.join(currentPath, "package.json"))) {
+    if (await pathExists2(path29.join(currentPath, "package.json"))) {
       return currentPath;
     }
-    const parentPath = path26.dirname(currentPath);
+    const parentPath = path29.dirname(currentPath);
     if (parentPath === currentPath) {
       throw new Error("Unable to locate package root for Superintendent templates.");
     }
@@ -22976,7 +23237,7 @@ function hasCode4(error2, code) {
 }
 
 // packages/superintendent/src/commands/plan-path.ts
-import path27 from "node:path";
+import path30 from "node:path";
 import { readFile as readFile6, writeFile as writeFile3, mkdir as mkdir5, unlink as unlink4, stat as stat5, readdir as readdir4 } from "node:fs/promises";
 var fs3 = {
   readFile: (p, encoding) => readFile6(p, encoding),
@@ -23011,13 +23272,13 @@ var planPathCommand = defineCommand({
 });
 function resolveAbsoluteDirectory2(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path27.join(homeDir, dir.slice(2));
+    return path30.join(homeDir, dir.slice(2));
   }
-  return path27.isAbsolute(dir) ? dir : path27.resolve(cwd, dir);
+  return path30.isAbsolute(dir) ? dir : path30.resolve(cwd, dir);
 }
 
 // packages/superintendent/src/commands/run.ts
-import path28 from "node:path";
+import path31 from "node:path";
 import * as fsPromises7 from "node:fs/promises";
 import { spawn as nodeSpawn, spawnSync as nodeSpawnSync } from "node:child_process";
 init_src6();
@@ -23528,7 +23789,7 @@ async function runSuperintendentCommand(options) {
         session.pauseRequested = true;
       }
       editPlan(session.dashboard, session.latestLogFile, env, options.openInEditor);
-      appendEvent("info", `Log opened: ${path28.basename(session.latestLogFile)}`);
+      appendEvent("info", `Log opened: ${path31.basename(session.latestLogFile)}`);
       syncStats();
     }
   };
@@ -23677,13 +23938,13 @@ async function listPlanDirectoryDocs(fs4, planDirectory, cwd, homeDir) {
     }
     throw error2;
   }
-  return entries.filter((entry) => entry.toLowerCase().endsWith(".md")).map((entry) => path28.join(absoluteDir, entry)).sort((left, right) => left.localeCompare(right));
+  return entries.filter((entry) => entry.toLowerCase().endsWith(".md")).map((entry) => path31.join(absoluteDir, entry)).sort((left, right) => left.localeCompare(right));
 }
 function resolveAbsolutePlanDirectory(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path28.join(homeDir, dir.slice(2));
+    return path31.join(homeDir, dir.slice(2));
   }
-  return path28.isAbsolute(dir) ? dir : path28.resolve(cwd, dir);
+  return path31.isAbsolute(dir) ? dir : path31.resolve(cwd, dir);
 }
 function normalizeAgentSelection(value) {
   if (typeof value !== "string") {
@@ -23920,7 +24181,7 @@ function resolveEditor(env) {
   const parts = raw.split(/\s+/);
   const command = parts[0] ?? "vi";
   const args = parts.slice(1);
-  const binary = path28.basename(command);
+  const binary = path31.basename(command);
   const mode = GUI_EDITOR_BINARIES.has(binary) ? "gui" : "tty";
   return { command, args, mode };
 }
@@ -23947,11 +24208,11 @@ function stripStopReason(result) {
   };
 }
 function displayPath(filePath, cwd, homeDir) {
-  if (filePath.startsWith(`${cwd}${path28.sep}`)) {
-    return path28.relative(cwd, filePath);
+  if (filePath.startsWith(`${cwd}${path31.sep}`)) {
+    return path31.relative(cwd, filePath);
   }
-  if (filePath.startsWith(`${homeDir}${path28.sep}`)) {
-    return `~/${path28.relative(homeDir, filePath)}`;
+  if (filePath.startsWith(`${homeDir}${path31.sep}`)) {
+    return `~/${path31.relative(homeDir, filePath)}`;
   }
   return filePath;
 }
@@ -24574,7 +24835,7 @@ function emitEvent(callback, event) {
 }
 async function loadConfiguredPlugins(options) {
   const fs4 = createConfigFileSystem(options.fs);
-  const homeDir = options.homeDir ?? os4.homedir();
+  const homeDir = options.homeDir ?? os5.homedir();
   const store = createConfigStore({
     fs: fs4,
     filePath: options.configPath ?? resolveConfigPath(homeDir),