poe-code 3.0.202 → 3.0.204

package/packages/memory/dist/index.js

@@ -94,6 +94,11 @@ var runtimeConfigScope = {
       default: "",
       doc: "Path to the Docker build context"
     },
+    workspace_dir: {
+      type: "string",
+      default: "/workspace",
+      doc: "Sandbox-local workspace directory for E2B runtime upload, execution, and download"
+    },
     engine: {
       type: "string",
       default: "",
@@ -115,6 +120,11 @@ var runtimeConfigScope = {
       default: "",
       doc: "Prebuilt E2B template id"
     },
+    from_template: {
+      type: "string",
+      default: "",
+      doc: "Existing E2B template alias to extend instead of using the Dockerfile FROM image"
+    },
     cpu: {
       type: "json",
       default: void 0,
@@ -138,11 +148,6 @@ var runtimeConfigScope = {
       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"
     }
   }
 };
@@ -162,14 +167,158 @@ function parseRunner(raw) {
     detach: parseOptionalBoolean(record.detach, "runner.detach") ?? false,
     upload_max_file_mb: uploadMaxFileMb,
     download_conflict: parseDownloadConflict(record.download_conflict),
+    sync: parseRunnerSync(record.sync),
     workspace: parseRunnerWorkspace(record.workspace)
   });
 }
+function parseRuntime(raw) {
+  if (raw === void 0) {
+    return {
+      type: "host",
+      build_args: {},
+      mounts: []
+    };
+  }
+  const record = asRecord(raw);
+  if (record === void 0) {
+    throw new Error("runtime: expected an object.");
+  }
+  const type = parseRuntimeType(record.type);
+  const shared = parseSharedRuntimeFields(record);
+  if (type === "docker") {
+    return omitUndefined({
+      ...shared,
+      type,
+      image: parseOptionalString(record.image),
+      dockerfile: parseOptionalString(record.dockerfile),
+      build_context: parseOptionalString(record.build_context),
+      engine: parseEngine(record.engine),
+      network: parseOptionalString(record.network),
+      extra_args: parseOptionalStringArray(record.extra_args)
+    });
+  }
+  if (type === "e2b") {
+    const preserveAfterExitHours = parseOptionalNumber(record.preserve_after_exit_hours) ?? 24;
+    if (preserveAfterExitHours < 0 || preserveAfterExitHours > 168) {
+      throw new Error("preserve_after_exit_hours: expected a number from 0 to 168.");
+    }
+    return omitUndefined({
+      ...shared,
+      type,
+      template_id: parseOptionalString(record.template_id),
+      from_template: parseOptionalString(record.from_template),
+      dockerfile: parseOptionalString(record.dockerfile),
+      build_context: parseOptionalString(record.build_context),
+      workspace_dir: parseWorkspaceDir(record.workspace_dir),
+      cpu: parseOptionalNumber(record.cpu),
+      memory_mb: parseOptionalNumber(record.memory_mb),
+      timeout_minutes: parseOptionalNumber(record.timeout_minutes),
+      preserve_after_exit_hours: preserveAfterExitHours
+    });
+  }
+  return {
+    ...shared,
+    type
+  };
+}
+function resolveRuntime({
+  cwd,
+  config
+}) {
+  const runtime = config.runtime;
+  return runtimeResolvers[runtime.type]({ cwd, runtime });
+}
+var runtimeResolvers = {
+  host({ runtime }) {
+    return {
+      runtime,
+      runner: "host",
+      dockerfilePath: null,
+      buildContext: null
+    };
+  },
+  docker({ cwd, runtime }) {
+    const dockerRuntime = runtime;
+    const { dockerfilePath, buildContext } = resolveRuntimeBuildPaths(cwd, dockerRuntime);
+    if (dockerRuntime.image !== void 0) {
+      return {
+        runtime: dockerRuntime,
+        runner: "docker",
+        dockerfilePath: null,
+        buildContext: null
+      };
+    }
+    if (!existsSync(dockerfilePath)) {
+      throw new Error(`Docker runtime requires image or a Dockerfile at ${dockerfilePath}.`);
+    }
+    return {
+      runtime: dockerRuntime,
+      runner: "docker",
+      dockerfilePath,
+      buildContext
+    };
+  },
+  e2b({ cwd, runtime }) {
+    const e2bRuntime = runtime;
+    const { dockerfilePath, buildContext } = resolveRuntimeBuildPaths(cwd, e2bRuntime);
+    if (e2bRuntime.template_id !== void 0) {
+      return {
+        runtime: e2bRuntime,
+        runner: "e2b",
+        dockerfilePath: null,
+        buildContext: null
+      };
+    }
+    if (!existsSync(dockerfilePath)) {
+      throw new Error(`E2B runtime requires template_id or a Dockerfile at ${dockerfilePath}.`);
+    }
+    return {
+      runtime: e2bRuntime,
+      runner: "e2b",
+      dockerfilePath,
+      buildContext
+    };
+  }
+};
+function resolveRuntimeBuildPaths(cwd, runtime) {
+  return {
+    dockerfilePath: path2.resolve(cwd, runtime.dockerfile ?? path2.join(".poe-code", "Dockerfile")),
+    buildContext: path2.resolve(cwd, runtime.build_context ?? ".")
+  };
+}
+function parseSharedRuntimeFields(record) {
+  return omitUndefined({
+    build_args: parseBuildArgs(record.build_args),
+    mounts: parseMounts(record.mounts),
+    link: parseOptionalString(record.link)
+  });
+}
+function parseRuntimeType(value) {
+  if (value === void 0) {
+    return "host";
+  }
+  if (value === "host" || value === "docker" || value === "e2b") {
+    return value;
+  }
+  throw new Error('type: expected "host", "docker", or "e2b".');
+}
+function parseWorkspaceDir(value) {
+  const workspaceDir = parseOptionalString(value) ?? "/workspace";
+  if (!path2.posix.isAbsolute(workspaceDir)) {
+    throw new Error("workspace_dir: expected an absolute sandbox path.");
+  }
+  let normalized = path2.posix.normalize(workspaceDir);
+  while (normalized.length > 1 && normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
 function createDefaultRunnerScope() {
   return {
     detach: false,
     upload_max_file_mb: 100,
     download_conflict: "refuse",
+    sync: "both",
     workspace: {
       exclude: [...defaultWorkspaceExclude]
     }
@@ -200,6 +349,15 @@ function parseDownloadConflict(value) {
   }
   throw new Error('runner.download_conflict: expected "refuse" or "overwrite".');
 }
+function parseRunnerSync(value) {
+  if (value === void 0) {
+    return "both";
+  }
+  if (value === "both" || value === "upload" || value === "none") {
+    return value;
+  }
+  throw new Error('runner.sync: expected "both", "upload", or "none".');
+}
 function parseBuildArgs(value) {
   if (value === void 0) {
     return {};
@@ -244,6 +402,18 @@ function parseMounts(value) {
     });
   });
 }
+function parseOptionalString(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new Error("expected a string.");
+  }
+  if (value.length === 0) {
+    return void 0;
+  }
+  return value;
+}
 function parseOptionalStringArray(value, key = "") {
   if (value === void 0) {
     return void 0;
@@ -258,6 +428,13 @@ function parseOptionalStringArray(value, key = "") {
     return entry;
   });
 }
+function parseEngine(value) {
+  const engine = parseOptionalString(value);
+  if (engine === void 0 || engine === "docker" || engine === "podman") {
+    return engine;
+  }
+  throw new Error('engine: expected "docker" or "podman".');
+}
 function parseOptionalNumber(value, key = "") {
   if (value === void 0) {
     return void 0;
@@ -293,6 +470,43 @@ function defineScope(scope, schema) {
     schema
   };
 }
+var integrationsConfigScope = defineScope("integrations", {
+  braintrust: {
+    type: "json",
+    default: {
+      enabled: false
+    },
+    parse: parseBraintrustIntegrationConfig,
+    doc: "Braintrust integration configuration"
+  }
+});
+function parseBraintrustIntegrationConfig(value) {
+  if (!isRecord(value)) {
+    throw new Error("expected an object");
+  }
+  const enabled = value.enabled === void 0 ? false : value.enabled;
+  if (typeof enabled !== "boolean") {
+    throw new Error("enabled must be a boolean");
+  }
+  return {
+    enabled,
+    ...optionalStringEntry("apiKey", value.apiKey),
+    ...optionalStringEntry("apiUrl", value.apiUrl),
+    ...optionalStringEntry("project", value.project)
+  };
+}
+function optionalStringEntry(key, value) {
+  if (value === void 0) {
+    return {};
+  }
+  if (typeof value !== "string") {
+    throw new Error(`${key} must be a string`);
+  }
+  return { [key]: value };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // packages/poe-code-config/src/plan-scope.ts
 var planConfigScope = defineScope("plan", {
@@ -397,11 +611,11 @@ function stripBom(content) {
 function mergeLayers(layers) {
   return mergeObjectLayers(layers, []);
 }
-function mergeObjectLayers(layers, path33) {
+function mergeObjectLayers(layers, path42) {
   const data = {};
   const sources = {};
   for (const key of collectKeys(layers)) {
-    const resolved = resolveKey(layers, key, path33);
+    const resolved = resolveKey(layers, key, path42);
     if (resolved === void 0) {
       continue;
     }
@@ -419,7 +633,7 @@ function collectKeys(layers) {
   }
   return [...keys];
 }
-function resolveKey(layers, key, path33) {
+function resolveKey(layers, key, path42) {
   let winningSource;
   let winningValue;
   const objectLayers = [];
@@ -449,9 +663,9 @@ function resolveKey(layers, key, path33) {
   if (winningSource === void 0) {
     return void 0;
   }
-  const fullPath = buildPath(path33, key);
+  const fullPath = buildPath(path42, key);
   if (isPlainObject(winningValue)) {
-    const merged = mergeObjectLayers(objectLayers, [...path33, key]);
+    const merged = mergeObjectLayers(objectLayers, [...path42, key]);
     return {
       value: merged.data,
       sources: {
@@ -476,8 +690,8 @@ function isWinningCandidate(key, value) {
   }
   return true;
 }
-function buildPath(path33, key) {
-  return [...path33, key].join(".");
+function buildPath(path42, key) {
+  return [...path42, key].join(".");
 }
 function isPlainObject(value) {
   if (value === null || Array.isArray(value) || typeof value !== "object") {
@@ -1111,16 +1325,16 @@ function getConfigFormat(pathOrFormat) {
   }
   return formatRegistry[formatName];
 }
-function detectFormat2(path33) {
-  const ext = getExtension(path33);
+function detectFormat2(path42) {
+  const ext = getExtension(path42);
   return extensionMap[ext];
 }
-function getExtension(path33) {
-  const lastDot = path33.lastIndexOf(".");
+function getExtension(path42) {
+  const lastDot = path42.lastIndexOf(".");
   if (lastDot === -1) {
     return "";
   }
-  return path33.slice(lastDot).toLowerCase();
+  return path42.slice(lastDot).toLowerCase();
 }
 
 // packages/config-mutations/src/execution/path-utils.ts
@@ -1828,7 +2042,7 @@ async function parseStoredDocument(fs14, filePath, raw) {
   }
 }
 function normalizeDocument(value) {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return {};
   }
   const document = {};
@@ -1841,7 +2055,7 @@ function normalizeDocument(value) {
   return document;
 }
 function normalizeScopeValues(value) {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return {};
   }
   const normalized = {};
@@ -1873,12 +2087,154 @@ function createInvalidBackupPath(filePath) {
   const baseName = path7.basename(filePath);
   return path7.join(directory, `${baseName}.invalid-${createTimestamp()}.json`);
 }
-function isRecord(value) {
+function isRecord2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
+function resolveConfigPath(homeDir) {
+  return path7.join(homeDir, ".poe-code", "config.json");
+}
+function resolveProjectConfigPath(cwd) {
+  return path7.join(cwd, ".poe-code", "config.json");
+}
 var EMPTY_DOCUMENT = `${JSON.stringify({}, null, 2)}
 `;
 
+// packages/poe-code-config/src/resolve.ts
+function resolveScope(schema, fileValues, env = {}) {
+  const resolved = {};
+  for (const key of Object.keys(schema)) {
+    const field = schema[key];
+    const envValue = resolveEnvValue(field, env, key);
+    const fileValue = resolveFileValue(field, fileValues?.[key], key);
+    resolved[key] = envValue ?? fileValue ?? field.default;
+  }
+  return resolved;
+}
+function resolveEnvValue(field, env, key) {
+  if (!field.env) {
+    return void 0;
+  }
+  const raw = env[field.env];
+  if (raw === void 0) {
+    return void 0;
+  }
+  return coerceValue(field, raw, key);
+}
+function resolveFileValue(field, value, key) {
+  return coerceValue(field, value, key);
+}
+function coerceValue(field, value, key) {
+  switch (field.type) {
+    case "string":
+      return typeof value === "string" ? value : void 0;
+    case "number":
+      return coerceNumber(value);
+    case "boolean":
+      return coerceBoolean(value);
+    case "json":
+      return coerceJson(field, value, key);
+  }
+}
+function coerceNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  const parsed = Number(value);
+  return Number.isNaN(parsed) ? void 0 : parsed;
+}
+function coerceBoolean(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (value === "true" || value === "1") {
+    return true;
+  }
+  if (value === "false" || value === "0") {
+    return false;
+  }
+  return void 0;
+}
+function coerceJson(field, value, key) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const parsedValue = parseJsonValue(value, key);
+  try {
+    return field.parse(parsedValue);
+  } catch (error2) {
+    const message2 = error2 instanceof Error ? error2.message : "Invalid JSON value.";
+    throw new Error(`Invalid config value for "${key}": ${message2}`);
+  }
+}
+function parseJsonValue(value, key) {
+  if (typeof value !== "string") {
+    return value;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error(`Invalid config value for "${key}": expected valid JSON.`);
+  }
+}
+
+// packages/poe-code-config/src/merge.ts
+function deepMergeDocuments(base, override) {
+  const merged = {};
+  const scopes = /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(override)]);
+  for (const scope of scopes) {
+    const baseScope = base[scope] ?? {};
+    const overrideScope = override[scope] ?? {};
+    const nextScope = mergeScope(scope, baseScope, overrideScope);
+    if (Object.keys(nextScope).length > 0) {
+      merged[scope] = nextScope;
+    }
+  }
+  return merged;
+}
+function mergeScope(scope, baseScope, overrideScope) {
+  if (scope === "runtime") {
+    return mergeRuntimeScope(baseScope, overrideScope);
+  }
+  const scopeEntries = Object.entries(overrideScope).filter(([, value]) => value !== void 0);
+  return {
+    ...baseScope,
+    ...Object.fromEntries(scopeEntries)
+  };
+}
+function mergeRuntimeScope(baseScope, overrideScope, path42 = []) {
+  const merged = {};
+  const keys = /* @__PURE__ */ new Set([...Object.keys(baseScope), ...Object.keys(overrideScope)]);
+  for (const key of keys) {
+    const baseValue = baseScope[key];
+    const overrideValue = overrideScope[key];
+    if (overrideValue === void 0) {
+      if (baseValue !== void 0) {
+        merged[key] = baseValue;
+      }
+      continue;
+    }
+    if (isRuntimeConcatenativeArray([...path42, key]) && Array.isArray(baseValue) && Array.isArray(overrideValue)) {
+      merged[key] = [...baseValue, ...overrideValue];
+      continue;
+    }
+    if (isRecord3(baseValue) && isRecord3(overrideValue)) {
+      merged[key] = mergeRuntimeScope(baseValue, overrideValue, [...path42, key]);
+      continue;
+    }
+    merged[key] = overrideValue;
+  }
+  return merged;
+}
+function isRuntimeConcatenativeArray(path42) {
+  return path42.join(".") === "mounts" || path42.join(".") === "runner.workspace.exclude";
+}
+function isRecord3(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
 // packages/poe-code-config/src/memory.ts
 async function configuredMemoryRoot(options) {
   return (await resolveMemoryConfig(options)).root;
@@ -1938,93 +2294,545 @@ import path9 from "node:path";
 // packages/file-lock/src/lock.ts
 import * as fsPromises from "node:fs/promises";
 import * as os from "node:os";
-
-// packages/poe-code-config/src/state/fs.ts
-import * as nodeFs from "node:fs/promises";
-
-// packages/poe-code-config/src/state/templates.ts
-import path10 from "node:path";
-
-// packages/memory/src/resolve-root.ts
-var MEMORY_ROOT_ENV_VAR = "POE_CODE_MEMORY_ROOT";
-async function resolveConfiguredMemoryRoot(options) {
-  const envOverride = options.env[MEMORY_ROOT_ENV_VAR]?.trim();
-  if (envOverride && envOverride.length > 0) {
-    return resolveAgainstCwd(options.cwd, envOverride);
+var LockTimeoutError = class extends Error {
+  constructor(message2) {
+    super(message2);
+    this.name = "LockTimeoutError";
   }
-  const configOverride = (await configuredMemoryRoot({
-    fs: options.fs,
-    filePath: options.configPath,
-    projectFilePath: options.projectConfigPath
-  }))?.trim();
-  if (configOverride && configOverride.length > 0) {
-    return resolveAgainstCwd(options.cwd, configOverride);
+};
+function createAbortError() {
+  const error2 = new Error("The operation was aborted.");
+  error2.name = "AbortError";
+  return error2;
+}
+function throwIfAborted(signal) {
+  if (signal?.aborted) {
+    throw createAbortError();
   }
-  return resolveMemoryRoot(options.cwd);
 }
-function resolveAgainstCwd(cwd, value) {
-  return path11.isAbsolute(value) ? value : path11.resolve(cwd, value);
+function sleep(ms, signal) {
+  if (!signal) {
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
+  }
+  if (signal.aborted) {
+    return Promise.reject(createAbortError());
+  }
+  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 });
+  });
 }
-
-// packages/memory/src/init.ts
-import * as fs from "node:fs/promises";
-import path12 from "node:path";
-async function initMemory(root) {
-  await fs.mkdir(path12.join(root, MEMORY_PAGES_DIR_RELPATH), { recursive: true });
-  await writeFileIfMissing(path12.join(root, MEMORY_INDEX_RELPATH), "# Memory index\n");
-  await writeFileIfMissing(path12.join(root, MEMORY_LOG_RELPATH), "");
+function backoff(attempt, minTimeout, maxTimeout) {
+  const delay = Math.min(maxTimeout, minTimeout * 2 ** attempt);
+  return delay + Math.random() * delay * 0.1;
 }
-async function writeFileIfMissing(filePath, content) {
+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 {
-    await fs.writeFile(filePath, content, { encoding: "utf8", flag: "wx" });
+    process.kill(pid, 0);
+    return true;
   } catch (error2) {
-    if (!hasErrorCode(error2, "EEXIST")) {
-      throw error2;
-    }
+    return !hasErrorCode(error2, "ESRCH");
   }
 }
-function hasErrorCode(error2, code) {
-  return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === code;
-}
-
-// packages/memory/src/pages.ts
-import * as fs2 from "node:fs/promises";
-import path13 from "node:path";
-
-// packages/memory/src/frontmatter.ts
-import { parse as parse5, stringify } from "yaml";
-function parseFrontmatter(markdown) {
-  const content = markdown.startsWith("\uFEFF") ? markdown.slice(1) : markdown;
-  const openingLineBreak = readOpeningLineBreak(content);
-  if (openingLineBreak === void 0) {
-    return {
-      frontmatter: {},
-      body: markdown
-    };
-  }
-  const frontmatterStart = 3 + openingLineBreak.length;
-  const closingFenceIndex = findClosingFence(content, frontmatterStart);
-  const yamlBlock = content.slice(frontmatterStart, closingFenceIndex);
-  const bodyStart = closingFenceIndex + 4;
+function createDefaultFs() {
   return {
-    frontmatter: parsePageFrontmatter(parseYamlFrontmatter(yamlBlock)),
-    body: readBody(content, bodyStart)
+    open: (path42, flags) => fsPromises.open(path42, flags),
+    readFile: (path42, encoding) => fsPromises.readFile(path42, encoding),
+    stat: fsPromises.stat,
+    unlink: fsPromises.unlink
   };
 }
-function serializeFrontmatter(frontmatter, body) {
-  const serialized = {
-    ...frontmatter.name === void 0 ? {} : { name: frontmatter.name },
-    ...frontmatter.description === void 0 ? {} : { description: frontmatter.description },
-    ...frontmatter.lastTouchedAt === void 0 ? {} : { last_touched_at: frontmatter.lastTouchedAt },
-    ...frontmatter.sources === void 0 || frontmatter.sources.length === 0 ? {} : { sources: frontmatter.sources.map((source) => serializeSourceRef(source)) }
-  };
-  if (Object.keys(serialized).length === 0) {
-    return body;
-  }
-  return `---
-${stringify(serialized).trimEnd()}
----
-${body}`;
+async function removeLockFile(fs14, lockPath, signal) {
+  for (let attempt = 0; attempt <= 4; attempt += 1) {
+    throwIfAborted(signal);
+    try {
+      await fs14.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(fs14, lockPath) {
+  if (!fs14.readFile) {
+    return void 0;
+  }
+  try {
+    return parseLockMetadata(await fs14.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 fs14 = 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 fs14.open(lockPath, "wx");
+      await writeLockMetadata(handle);
+      let released = false;
+      return async () => {
+        if (released) {
+          return;
+        }
+        released = true;
+        await removeLockFile(fs14, lockPath, options.signal);
+      };
+    } catch (error2) {
+      if (!hasErrorCode(error2, "EEXIST")) {
+        throw error2;
+      }
+    }
+    let stat7;
+    try {
+      stat7 = await fs14.stat(lockPath);
+    } catch (statError) {
+      if (hasErrorCode(statError, "ENOENT")) {
+        continue;
+      }
+      throw statError;
+    }
+    const reclaimLock = await shouldReclaimLock({
+      fs: fs14,
+      isPidRunning: pidIsRunning,
+      lockPath,
+      staleMs,
+      stat: stat7
+    });
+    if (reclaimLock === "missing") {
+      continue;
+    }
+    if (reclaimLock) {
+      await removeLockFile(fs14, 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";
+var defaultStateFs = nodeFs;
+function isNotFoundError(error2) {
+  return error2 instanceof Error && "code" in error2 && error2.code === "ENOENT";
+}
+
+// packages/poe-code-config/src/state/jobs.ts
+function createJobRegistry(homeDir, fs14 = defaultStateFs) {
+  const jobsDir = path9.join(homeDir, ".poe-code", "state", "jobs");
+  function jobPath(id) {
+    assertSafeJobId(id);
+    return path9.join(jobsDir, `${id}.json`);
+  }
+  async function get(id) {
+    try {
+      return parseJobEntry(await fs14.readFile(jobPath(id), "utf8"));
+    } catch (error2) {
+      if (isNotFoundError(error2)) {
+        return null;
+      }
+      throw error2;
+    }
+  }
+  async function put(entry) {
+    assertJobEntry(entry);
+    const filePath = jobPath(entry.id);
+    await fs14.mkdir(jobsDir, { recursive: true });
+    const release = await acquireFileLock(filePath, { fs: fs14 });
+    try {
+      await writeJobAtomically(filePath, entry);
+    } finally {
+      await release();
+    }
+  }
+  async function update(id, patch) {
+    const filePath = jobPath(id);
+    await fs14.mkdir(jobsDir, { recursive: true });
+    const release = await acquireFileLock(filePath, { fs: fs14 });
+    try {
+      const current = await get(id);
+      if (current === null) {
+        return null;
+      }
+      const updated = {
+        ...current,
+        ...patch,
+        id: current.id
+      };
+      assertJobEntry(updated);
+      await writeJobAtomically(filePath, updated);
+      return updated;
+    } finally {
+      await release();
+    }
+  }
+  async function list(filter = {}) {
+    let entries;
+    try {
+      entries = await fs14.readdir(jobsDir);
+    } catch (error2) {
+      if (isNotFoundError(error2)) {
+        return [];
+      }
+      throw error2;
+    }
+    const jobs = [];
+    for (const entry of entries.sort()) {
+      if (!entry.endsWith(".json")) {
+        continue;
+      }
+      const filePath = path9.join(jobsDir, entry);
+      const stat7 = await fs14.stat(filePath);
+      if (!stat7.isFile()) {
+        continue;
+      }
+      const job = parseJobEntry(await fs14.readFile(filePath, "utf8"));
+      if (matchesFilter(job, filter)) {
+        jobs.push(job);
+      }
+    }
+    return jobs;
+  }
+  async function remove2(id) {
+    const filePath = jobPath(id);
+    try {
+      await fs14.stat(jobsDir);
+    } catch (error2) {
+      if (isNotFoundError(error2)) {
+        return;
+      }
+      throw error2;
+    }
+    const release = await acquireFileLock(filePath, { fs: fs14 });
+    try {
+      await fs14.unlink(filePath);
+    } catch (error2) {
+      if (!isNotFoundError(error2)) {
+        throw error2;
+      }
+    } finally {
+      await release();
+    }
+  }
+  async function writeJobAtomically(filePath, entry) {
+    await fs14.mkdir(path9.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+    try {
+      await fs14.writeFile(tempPath, `${JSON.stringify(entry, null, 2)}
+`, {
+        encoding: "utf8"
+      });
+      await fs14.rename(tempPath, filePath);
+    } catch (error2) {
+      await removeTempFile(tempPath);
+      throw error2;
+    }
+  }
+  async function removeTempFile(tempPath) {
+    try {
+      await fs14.unlink(tempPath);
+    } catch (error2) {
+      if (!isNotFoundError(error2)) {
+        throw error2;
+      }
+    }
+  }
+  return {
+    get,
+    put,
+    update,
+    list,
+    remove: remove2
+  };
+}
+function assertSafeJobId(id) {
+  if (id.length === 0 || id === "." || id === ".." || path9.isAbsolute(id) || id.includes("/") || id.includes("\\") || id.includes("\0")) {
+    throw new Error("Invalid job id.");
+  }
+}
+function assertJobEntry(entry) {
+  if (!isJobEntry(entry)) {
+    throw new Error("Invalid job entry.");
+  }
+}
+function matchesFilter(job, filter) {
+  return (filter.env_id === void 0 || job.env_id === filter.env_id) && (filter.env_kind === void 0 || job.env_kind === filter.env_kind) && (filter.tool === void 0 || job.tool === filter.tool) && (filter.status === void 0 || job.status === filter.status);
+}
+function parseJobEntry(content) {
+  const parsed = JSON.parse(content);
+  if (!isJobEntry(parsed)) {
+    throw new Error("Invalid job state file.");
+  }
+  return parsed;
+}
+function isJobEntry(value) {
+  return isRecord4(value) && typeof value.id === "string" && typeof value.env_id === "string" && typeof value.env_kind === "string" && typeof value.tool === "string" && Array.isArray(value.argv) && value.argv.every((arg) => typeof arg === "string") && typeof value.cwd === "string" && typeof value.started_at === "string" && isJobStatus(value.status) && (value.exit_code === void 0 || typeof value.exit_code === "number") && (value.exited_at === void 0 || typeof value.exited_at === "string") && (value.log_file === void 0 || typeof value.log_file === "string");
+}
+function isJobStatus(value) {
+  return value === "pending" || value === "running" || value === "exited" || value === "killed" || value === "lost";
+}
+function isRecord4(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+// packages/poe-code-config/src/state/templates.ts
+import path10 from "node:path";
+function createTemplateRegistry(homeDir, fs14 = defaultStateFs) {
+  const filePath = path10.join(homeDir, ".poe-code", "state", "templates.json");
+  async function readState() {
+    try {
+      const raw = await fs14.readFile(filePath, "utf8");
+      return normalizeTemplateState(JSON.parse(raw));
+    } catch (error2) {
+      if (isNotFoundError(error2)) {
+        return createEmptyState();
+      }
+      throw error2;
+    }
+  }
+  async function writeState(state) {
+    await fs14.writeFile(filePath, `${JSON.stringify(state, null, 2)}
+`, {
+      encoding: "utf8"
+    });
+  }
+  async function updateState(mutator) {
+    await fs14.mkdir(path10.dirname(filePath), { recursive: true });
+    const release = await acquireFileLock(filePath, { fs: fs14 });
+    try {
+      const state = await readState();
+      mutator(state);
+      await writeState(state);
+    } finally {
+      await release();
+    }
+  }
+  async function get(backend, hash) {
+    const state = await readState();
+    return state[backend][hash] ?? null;
+  }
+  async function put(backend, entry) {
+    await updateState((state) => {
+      state[backend][entry.hash] = entry;
+    });
+  }
+  async function remove2(backend, hash) {
+    await updateState((state) => {
+      delete state[backend][hash];
+    });
+  }
+  async function list(backend) {
+    const state = await readState();
+    const entries = backend === void 0 ? [...Object.values(state.docker), ...Object.values(state.e2b)] : Object.values(state[backend]);
+    return entries.sort((left, right) => left.hash.localeCompare(right.hash));
+  }
+  return {
+    get,
+    put,
+    remove: remove2,
+    list
+  };
+}
+function createEmptyState() {
+  return {
+    docker: {},
+    e2b: {}
+  };
+}
+function normalizeTemplateState(value) {
+  if (!isRecord5(value)) {
+    return createEmptyState();
+  }
+  return {
+    docker: normalizeTemplateEntries(value.docker),
+    e2b: normalizeTemplateEntries(value.e2b)
+  };
+}
+function normalizeTemplateEntries(value) {
+  if (!isRecord5(value)) {
+    return {};
+  }
+  const entries = {};
+  for (const [hash, entry] of Object.entries(value)) {
+    if (isTemplateEntry(entry) && entry.hash === hash) {
+      entries[hash] = entry;
+    }
+  }
+  return entries;
+}
+function isTemplateEntry(value) {
+  return isRecord5(value) && typeof value.hash === "string" && typeof value.runtime_type === "string" && typeof value.dockerfile_path === "string" && typeof value.built_at === "string" && (value.template_id === void 0 || typeof value.template_id === "string") && (value.image === void 0 || typeof value.image === "string");
+}
+function isRecord5(value) {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+
+// packages/poe-code-config/src/state/index.ts
+function createStateManager(homeDir, fs14) {
+  return {
+    templates: createTemplateRegistry(homeDir, fs14),
+    jobs: createJobRegistry(homeDir, fs14)
+  };
+}
+
+// packages/memory/src/resolve-root.ts
+var MEMORY_ROOT_ENV_VAR = "POE_CODE_MEMORY_ROOT";
+async function resolveConfiguredMemoryRoot(options) {
+  const envOverride = options.env[MEMORY_ROOT_ENV_VAR]?.trim();
+  if (envOverride && envOverride.length > 0) {
+    return resolveAgainstCwd(options.cwd, envOverride);
+  }
+  const configOverride = (await configuredMemoryRoot({
+    fs: options.fs,
+    filePath: options.configPath,
+    projectFilePath: options.projectConfigPath
+  }))?.trim();
+  if (configOverride && configOverride.length > 0) {
+    return resolveAgainstCwd(options.cwd, configOverride);
+  }
+  return resolveMemoryRoot(options.cwd);
+}
+function resolveAgainstCwd(cwd, value) {
+  return path11.isAbsolute(value) ? value : path11.resolve(cwd, value);
+}
+
+// packages/memory/src/init.ts
+import * as fs from "node:fs/promises";
+import path12 from "node:path";
+async function initMemory(root) {
+  await fs.mkdir(path12.join(root, MEMORY_PAGES_DIR_RELPATH), { recursive: true });
+  await writeFileIfMissing(path12.join(root, MEMORY_INDEX_RELPATH), "# Memory index\n");
+  await writeFileIfMissing(path12.join(root, MEMORY_LOG_RELPATH), "");
+}
+async function writeFileIfMissing(filePath, content) {
+  try {
+    await fs.writeFile(filePath, content, { encoding: "utf8", flag: "wx" });
+  } catch (error2) {
+    if (!hasErrorCode2(error2, "EEXIST")) {
+      throw error2;
+    }
+  }
+}
+function hasErrorCode2(error2, code) {
+  return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === code;
+}
+
+// packages/memory/src/pages.ts
+import * as fs2 from "node:fs/promises";
+import path13 from "node:path";
+
+// packages/memory/src/frontmatter.ts
+import { parse as parse5, stringify } from "yaml";
+function parseFrontmatter(markdown) {
+  const content = markdown.startsWith("\uFEFF") ? markdown.slice(1) : markdown;
+  const openingLineBreak = readOpeningLineBreak(content);
+  if (openingLineBreak === void 0) {
+    return {
+      frontmatter: {},
+      body: markdown
+    };
+  }
+  const frontmatterStart = 3 + openingLineBreak.length;
+  const closingFenceIndex = findClosingFence(content, frontmatterStart);
+  const yamlBlock = content.slice(frontmatterStart, closingFenceIndex);
+  const bodyStart = closingFenceIndex + 4;
+  return {
+    frontmatter: parsePageFrontmatter(parseYamlFrontmatter(yamlBlock)),
+    body: readBody(content, bodyStart)
+  };
+}
+function serializeFrontmatter(frontmatter, body) {
+  const serialized = {
+    ...frontmatter.name === void 0 ? {} : { name: frontmatter.name },
+    ...frontmatter.description === void 0 ? {} : { description: frontmatter.description },
+    ...frontmatter.lastTouchedAt === void 0 ? {} : { last_touched_at: frontmatter.lastTouchedAt },
+    ...frontmatter.sources === void 0 || frontmatter.sources.length === 0 ? {} : { sources: frontmatter.sources.map((source) => serializeSourceRef(source)) }
+  };
+  if (Object.keys(serialized).length === 0) {
+    return body;
+  }
+  return `---
+${stringify(serialized).trimEnd()}
+---
+${body}`;
 }
 function parseSourceRef(serialized) {
   const [rawPath, rawAnchor] = serialized.split("#", 2);
@@ -2135,7 +2943,7 @@ function parseYamlFrontmatter(yamlBlock) {
   if (parsed === null) {
     return {};
   }
-  if (!isRecord2(parsed)) {
+  if (!isRecord6(parsed)) {
     throw new Error("YAML frontmatter must parse to an object.");
   }
   return parsed;
@@ -2166,13 +2974,13 @@ function parseSources(value) {
     if (typeof item === "string") {
       return parseSourceRef(item);
     }
-    if (!isRecord2(item)) {
+    if (!isRecord6(item)) {
       throw new Error('Invalid "sources" frontmatter. Expected each source to be a string or object.');
     }
-    const path33 = readRequiredString(item.path, "sources[].path");
+    const path42 = readRequiredString(item.path, "sources[].path");
     const startLine = readOptionalPositiveInteger(item.startLine, "sources[].startLine");
     const endLine = readOptionalPositiveInteger(item.endLine, "sources[].endLine");
-    return parseSourceRef(serializeSourceRef({ path: path33, ...startLine === void 0 ? {} : { startLine }, ...endLine === void 0 ? {} : { endLine } }));
+    return parseSourceRef(serializeSourceRef({ path: path42, ...startLine === void 0 ? {} : { startLine }, ...endLine === void 0 ? {} : { endLine } }));
   });
 }
 function readOptionalString(value, field) {
@@ -2205,7 +3013,7 @@ function assertValidLineNumber(line, value) {
     throw new Error(`Invalid source ref "${value}": line numbers must be positive integers.`);
   }
 }
-function isRecord2(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -2377,17 +3185,17 @@ import path18 from "node:path";
 // packages/memory/src/lock.ts
 import * as fsPromises2 from "node:fs/promises";
 import path16 from "node:path";
-function createDefaultFs() {
+function createDefaultFs2() {
   return {
     readFile: (filePath, encoding) => fsPromises2.readFile(filePath, encoding),
     unlink: fsPromises2.unlink,
     writeFile: (filePath, data, options) => fsPromises2.writeFile(filePath, data, options)
   };
 }
-function sleep(ms) {
+function sleep2(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
-function hasErrorCode2(error2, code) {
+function hasErrorCode3(error2, code) {
   return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === code;
 }
 function lockDelay(attempt, minTimeoutMs, maxTimeoutMs) {
@@ -2406,19 +3214,19 @@ function parsePid(input) {
   const pid = Number.parseInt(value, 10);
   return Number.isSafeInteger(pid) && pid > 0 ? pid : void 0;
 }
-function isPidRunning(pid) {
+function isPidRunning2(pid) {
   try {
     process.kill(pid, 0);
     return true;
   } catch (error2) {
-    return !hasErrorCode2(error2, "ESRCH");
+    return !hasErrorCode3(error2, "ESRCH");
   }
 }
-async function removeLockFile(fs14, lockPath) {
+async function removeLockFile2(fs14, lockPath) {
   try {
     await fs14.unlink(lockPath);
   } catch (error2) {
-    if (!hasErrorCode2(error2, "ENOENT")) {
+    if (!hasErrorCode3(error2, "ENOENT")) {
       throw error2;
     }
   }
@@ -2427,20 +3235,20 @@ async function readLockPid(fs14, lockPath) {
   try {
     return parsePid(await fs14.readFile(lockPath, "utf8"));
   } catch (error2) {
-    if (hasErrorCode2(error2, "ENOENT")) {
+    if (hasErrorCode3(error2, "ENOENT")) {
       return null;
     }
     throw error2;
   }
 }
 async function withLock(root, run, options = {}) {
-  const fs14 = options.fs ?? createDefaultFs();
+  const fs14 = options.fs ?? createDefaultFs2();
   const lockPath = path16.join(root, MEMORY_LOCK_RELPATH);
   const pid = options.pid ?? process.pid;
   const retries = options.retries ?? 20;
   const minTimeoutMs = options.minTimeoutMs ?? 25;
   const maxTimeoutMs = options.maxTimeoutMs ?? 250;
-  const pidIsRunning = options.isPidRunning ?? isPidRunning;
+  const pidIsRunning = options.isPidRunning ?? isPidRunning2;
   for (let attempt = 0; attempt <= retries; attempt += 1) {
     try {
       await fs14.writeFile(lockPath, `${pid}
@@ -2448,10 +3256,10 @@ async function withLock(root, run, options = {}) {
       try {
         return await run();
       } finally {
-        await removeLockFile(fs14, lockPath);
+        await removeLockFile2(fs14, lockPath);
       }
     } catch (error2) {
-      if (!hasErrorCode2(error2, "EEXIST")) {
+      if (!hasErrorCode3(error2, "EEXIST")) {
         throw error2;
       }
     }
@@ -2460,11 +3268,11 @@ async function withLock(root, run, options = {}) {
       continue;
     }
     if (existingPid === void 0 || !pidIsRunning(existingPid)) {
-      await removeLockFile(fs14, lockPath);
+      await removeLockFile2(fs14, lockPath);
       continue;
     }
     if (attempt < retries) {
-      await sleep(lockDelay(attempt, minTimeoutMs, maxTimeoutMs));
+      await sleep2(lockDelay(attempt, minTimeoutMs, maxTimeoutMs));
     }
   }
   throw new Error(`Failed to acquire memory lock at "${lockPath}".`);
@@ -3225,162 +4033,2405 @@ function parseOlderThan(value) {
   }
   return duration;
 }
-
-// packages/memory/src/ingest.ts
-import * as fs11 from "node:fs/promises";
-import path26 from "node:path";
-
-// packages/agent-spawn/src/run-command.ts
-import { spawn } from "node:child_process";
-
-// packages/agent-spawn/src/types.ts
-function resolveModeConfig(modeConfig) {
-  if (Array.isArray(modeConfig)) {
-    return { args: modeConfig };
+
+// packages/memory/src/ingest.ts
+import * as fs11 from "node:fs/promises";
+import path35 from "node:path";
+
+// packages/agent-spawn/src/register-factories.ts
+import { spawn as spawnChildProcess2 } from "node:child_process";
+
+// packages/agent-harness-tools/src/paths.ts
+import path22 from "node:path";
+
+// packages/agent-defs/src/agents/claude-code.ts
+var claudeCodeAgent = {
+  id: "claude-code",
+  name: "claude-code",
+  label: "Claude Code",
+  summary: "Configure Claude Code to route through Poe.",
+  aliases: ["claude"],
+  binaryName: "claude",
+  configPath: "~/.claude/settings.json",
+  branding: {
+    colors: {
+      dark: "#C15F3C",
+      light: "#C15F3C"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/claude-desktop.ts
+var claudeDesktopAgent = {
+  id: "claude-desktop",
+  name: "claude-desktop",
+  label: "Claude Desktop",
+  summary: "Anthropic's official desktop application for Claude",
+  configPath: "~/.claude/settings.json",
+  branding: {
+    colors: {
+      dark: "#D97757",
+      light: "#D97757"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/codex.ts
+var codexAgent = {
+  id: "codex",
+  name: "codex",
+  label: "Codex",
+  summary: "Configure Codex to use Poe as the model provider.",
+  binaryName: "codex",
+  configPath: "~/.codex/config.toml",
+  branding: {
+    colors: {
+      dark: "#D5D9DF",
+      light: "#7A7F86"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/opencode.ts
+var openCodeAgent = {
+  id: "opencode",
+  name: "opencode",
+  label: "OpenCode CLI",
+  summary: "Configure OpenCode CLI to use the Poe API.",
+  binaryName: "opencode",
+  configPath: "~/.config/opencode/config.json",
+  branding: {
+    colors: {
+      dark: "#4A4F55",
+      light: "#2F3338"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/kimi.ts
+var kimiAgent = {
+  id: "kimi",
+  name: "kimi",
+  label: "Kimi",
+  summary: "Configure Kimi CLI to use Poe API",
+  aliases: ["kimi-cli"],
+  binaryName: "kimi",
+  configPath: "~/.kimi/config.toml",
+  branding: {
+    colors: {
+      dark: "#7B68EE",
+      light: "#6A5ACD"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/goose.ts
+var gooseAgent = {
+  id: "goose",
+  name: "goose",
+  label: "Goose",
+  summary: "Block's open-source AI agent with ACP support.",
+  binaryName: "goose",
+  configPath: "~/.config/goose/config.yaml",
+  branding: {
+    colors: {
+      dark: "#FF6B35",
+      light: "#E85D26"
+    }
+  }
+};
+
+// packages/agent-defs/src/agents/poe-agent.ts
+var poeAgentAgent = {
+  id: "poe-agent",
+  name: "poe-agent",
+  label: "Poe Agent",
+  summary: "Run one-shot prompts with the built-in Poe agent runtime.",
+  configPath: "~/.poe-code/config.json",
+  branding: {
+    colors: {
+      dark: "#A465F7",
+      light: "#7A3FD3"
+    }
+  }
+};
+
+// packages/agent-defs/src/registry.ts
+var allAgents = [
+  claudeCodeAgent,
+  claudeDesktopAgent,
+  codexAgent,
+  openCodeAgent,
+  kimiAgent,
+  gooseAgent,
+  poeAgentAgent
+];
+var lookup = /* @__PURE__ */ new Map();
+for (const agent of allAgents) {
+  const values = [agent.id, agent.name, ...agent.aliases ?? []];
+  for (const value of values) {
+    const normalized = value.toLowerCase();
+    if (!lookup.has(normalized)) {
+      lookup.set(normalized, agent.id);
+    }
+  }
+}
+function resolveAgentId(input) {
+  if (!input) {
+    return void 0;
+  }
+  return lookup.get(input.toLowerCase());
+}
+
+// packages/agent-harness-tools/src/select-agent.ts
+var loopAgents = allAgents.filter(
+  (agent) => agent.binaryName !== void 0 || agent.id === "poe-agent"
+);
+var supportedAgents = loopAgents.map((agent) => agent.id).join(", ");
+
+// packages/agent-harness-tools/src/run-logs.ts
+import path23 from "node:path";
+
+// packages/agent-harness-tools/src/log-stream.ts
+import nodeFs2 from "node:fs";
+var JOB_DIR = "/tmp/poe-jobs";
+var POLL_INTERVAL_MS = 250;
+function wrapForLogTee(argv, jobId) {
+  if (argv.length === 0) {
+    throw new Error("wrapForLogTee requires argv to contain at least one argument");
+  }
+  const command = argv.map(shellQuote).join(" ");
+  const logFile = shellQuote(jobLogPath(jobId));
+  const exitFile = shellQuote(jobExitPath(jobId));
+  const exitTmpFile = shellQuote(`${jobExitPath(jobId)}.tmp`);
+  const script = [
+    `mkdir -p ${shellQuote(JOB_DIR)}`,
+    `({ (${command}); echo $? > ${exitTmpFile}; } 2>&1 | tee ${logFile}; mv ${exitTmpFile} ${exitFile})`
+  ].join(" && ");
+  return ["sh", "-c", script];
+}
+async function* streamLogFile(env, jobId, opts) {
+  const fs14 = env.fs ?? nodeFs2;
+  const file = jobLogPath(jobId);
+  let byteOffset = opts.sinceByte ?? 0;
+  while (true) {
+    if (opts.since !== void 0 && !await wasModifiedSince(fs14, file, opts.since)) {
+      await waitForLogChange(fs14, file);
+      continue;
+    }
+    const result = await readLogChunk(fs14, file, byteOffset);
+    if (result !== null) {
+      byteOffset = result.nextByteOffset;
+      yield result.chunk;
+      continue;
+    }
+    await waitForLogChange(fs14, file);
+  }
+}
+async function wasModifiedSince(fs14, file, since) {
+  if (fs14.promises.stat === void 0) {
+    return true;
+  }
+  try {
+    const stat7 = await fs14.promises.stat(file);
+    return stat7.mtimeMs >= since.getTime();
+  } catch (error2) {
+    if (isNodeError(error2) && error2.code === "ENOENT") {
+      return false;
+    }
+    throw error2;
+  }
+}
+async function waitForExit(env, jobId, opts = {}) {
+  const fs14 = env.fs ?? nodeFs2;
+  const file = jobExitPath(jobId);
+  while (true) {
+    throwIfAborted2(opts.signal);
+    const contents = await readTextFileIfExists(fs14, file);
+    if (contents !== null) {
+      const text4 = contents.trim();
+      const exitCode = Number(text4);
+      if (text4.length === 0 || !Number.isInteger(exitCode)) {
+        throw new Error(`Invalid exit code in ${file}: ${contents}`);
+      }
+      return { exitCode };
+    }
+    await sleep3(POLL_INTERVAL_MS, opts.signal);
+  }
+}
+function jobLogPath(jobId) {
+  return `${JOB_DIR}/${jobId}.log`;
+}
+function jobExitPath(jobId) {
+  return `${JOB_DIR}/${jobId}.exit`;
+}
+async function readLogChunk(fs14, file, byteOffset) {
+  const contents = await readFileIfExists2(fs14, file);
+  if (contents === null || byteOffset >= contents.byteLength) {
+    return null;
+  }
+  return {
+    chunk: {
+      byteOffset,
+      data: contents.subarray(byteOffset).toString("utf8")
+    },
+    nextByteOffset: contents.byteLength
+  };
+}
+async function readTextFileIfExists(fs14, file) {
+  const contents = await readFileIfExists2(fs14, file);
+  return contents?.toString("utf8") ?? null;
+}
+async function readFileIfExists2(fs14, file) {
+  try {
+    const contents = await fs14.promises.readFile(file);
+    return Buffer.isBuffer(contents) ? contents : Buffer.from(contents);
+  } catch (error2) {
+    if (isNodeError(error2) && error2.code === "ENOENT") {
+      return null;
+    }
+    throw error2;
+  }
+}
+async function waitForLogChange(fs14, file) {
+  const watch = fs14.watch;
+  if (typeof watch !== "function") {
+    await sleep3(POLL_INTERVAL_MS);
+    return;
+  }
+  await new Promise((resolve2) => {
+    let watcher = null;
+    const timer = setTimeout(done, POLL_INTERVAL_MS);
+    function done() {
+      clearTimeout(timer);
+      watcher?.close();
+      resolve2();
+    }
+    try {
+      watcher = watch(file, done);
+    } catch {
+      done();
+    }
+  });
+}
+function sleep3(ms, signal) {
+  return new Promise((resolve2, reject) => {
+    let timer = null;
+    const abort = () => {
+      if (timer !== null) {
+        clearTimeout(timer);
+      }
+      reject(new Error("waitForExit aborted."));
+    };
+    if (signal?.aborted) {
+      abort();
+      return;
+    }
+    timer = setTimeout(() => {
+      signal?.removeEventListener("abort", abort);
+      resolve2();
+    }, ms);
+    signal?.addEventListener("abort", abort, { once: true });
+  });
+}
+function throwIfAborted2(signal) {
+  if (signal?.aborted) {
+    throw new Error("waitForExit aborted.");
+  }
+}
+function shellQuote(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function isNodeError(error2) {
+  return error2 instanceof Error && "code" in error2;
+}
+
+// packages/agent-harness-tools/src/run-poe-command.ts
+import { randomBytes } from "node:crypto";
+
+// packages/agent-harness-tools/src/binary-exists.ts
+function createBinaryExistsDetectors(binaryName) {
+  const commonPaths = [
+    `/usr/local/bin/${binaryName}`,
+    `/usr/bin/${binaryName}`,
+    `$HOME/.local/bin/${binaryName}`,
+    `$HOME/.claude/local/bin/${binaryName}`
+  ];
+  return [
+    {
+      command: "which",
+      args: [binaryName],
+      validate: (result) => result.exitCode === 0
+    },
+    {
+      command: "where",
+      args: [binaryName],
+      validate: (result) => result.exitCode === 0 && result.stdout.trim().length > 0
+    },
+    {
+      command: "sh",
+      args: ["-c", commonPaths.map((p) => `test -f "${p}"`).join(" || ")],
+      validate: (result) => result.exitCode === 0
+    }
+  ];
+}
+
+// packages/agent-harness-tools/src/run-poe-command.ts
+var ULID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+async function runPoeCommand(opts) {
+  const jobId = createUlid();
+  const execution = opts.openSpec.execution;
+  const wrapCommand = execution?.wrapForLogTee !== false;
+  const pendingJob = opts.state.jobs.put({
+    id: jobId,
+    env_id: "",
+    env_kind: opts.factory.type,
+    tool: opts.openSpec.jobLabel.tool,
+    argv: opts.openSpec.jobLabel.argv,
+    cwd: opts.openSpec.cwd,
+    started_at: "",
+    status: "pending"
+  });
+  const opened = opts.factory.open(opts.openSpec);
+  const env = isPromiseLike(opened) ? await opened : opened;
+  let shouldClose = true;
+  try {
+    const upload = env.uploadWorkspace();
+    await Promise.all([pendingJob, upload]);
+    await configureE2bSpawnAgentIfAvailable({
+      env,
+      openSpec: opts.openSpec,
+      factoryType: opts.factory.type
+    });
+    const argv = wrapCommand ? wrapForLogTee(opts.openSpec.jobLabel.argv, jobId) : opts.openSpec.jobLabel.argv;
+    const handle = execution?.tty ? env.shell() : env.exec({
+      command: argv[0],
+      args: argv.slice(1),
+      cwd: opts.openSpec.cwd,
+      env: resolveExecutionEnv(opts.openSpec),
+      stdin: execution?.stdin ?? "inherit",
+      stdout: execution?.stdout ?? "pipe",
+      stderr: execution?.stderr ?? "pipe",
+      signal: opts.signal
+    });
+    if (execution?.input !== void 0) {
+      handle.stdin?.setDefaultEncoding("utf8");
+      handle.stdin?.end(execution.input);
+    }
+    const runningJob = opts.state.jobs.update(jobId, {
+      status: "running",
+      env_id: env.id,
+      started_at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    if (opts.detach) {
+      await runningJob;
+      setDetachedJobContext(env, {
+        id: jobId,
+        tool: opts.openSpec.jobLabel.tool,
+        argv: opts.openSpec.jobLabel.argv
+      });
+      await env.detach();
+      shouldClose = false;
+      return { kind: "detached", jobId, envId: env.id };
+    }
+    const result = await runSync({
+      env,
+      handle,
+      jobId,
+      openSpec: opts.openSpec,
+      signal: opts.signal,
+      wrapCommand
+    });
+    await runningJob;
+    shouldClose = false;
+    await opts.state.jobs.update(jobId, {
+      status: "exited",
+      exit_code: result.exitCode,
+      exited_at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    return {
+      kind: "sync",
+      exitCode: result.exitCode,
+      download: result.download,
+      ...result.stdout !== void 0 ? { stdout: result.stdout } : {},
+      ...result.stderr !== void 0 ? { stderr: result.stderr } : {}
+    };
+  } finally {
+    if (shouldClose) {
+      await env.close();
+    }
+  }
+}
+async function configureE2bSpawnAgentIfAvailable(opts) {
+  if (opts.factoryType !== "e2b") {
+    return;
+  }
+  const agentId = resolveAgentId(opts.openSpec.jobLabel.tool);
+  const agent = allAgents.find((candidate) => candidate.id === agentId);
+  const binaryName = agent?.binaryName;
+  if (!agentId || !binaryName) {
+    return;
+  }
+  const commandEnv = resolveExecutionEnv(opts.openSpec);
+  const exists = await binaryExists(opts.env, {
+    binaryName,
+    cwd: opts.openSpec.cwd,
+    env: commandEnv
+  });
+  if (!exists) {
+    return;
+  }
+  const result = await runProbeCommand(opts.env, {
+    command: "poe-code",
+    args: ["configure", "--yes", "--provider", "poe", agentId],
+    cwd: opts.openSpec.cwd,
+    env: commandEnv
+  });
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `Failed to configure ${agentId} for Poe inside E2B sandbox.
+${formatProbeResult(result)}`
+    );
+  }
+}
+async function binaryExists(env, opts) {
+  for (const detector of createBinaryExistsDetectors(opts.binaryName)) {
+    const result = await runProbeCommand(env, {
+      ...detector,
+      cwd: opts.cwd,
+      env: opts.env
+    });
+    if (detector.validate(result)) {
+      return true;
+    }
+  }
+  return false;
+}
+function resolveExecutionEnv(openSpec) {
+  const execution = openSpec.execution;
+  return execution?.env ?? openSpec.env;
+}
+async function runProbeCommand(env, spec) {
+  const handle = env.exec({
+    command: spec.command,
+    args: spec.args,
+    cwd: spec.cwd,
+    env: spec.env,
+    stdin: "ignore",
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+  const stdout = readStream(handle.stdout);
+  const stderr = readStream(handle.stderr);
+  const result = await handle.result;
+  return {
+    exitCode: result.exitCode,
+    stdout: await stdout,
+    stderr: await stderr
+  };
+}
+function readStream(stream) {
+  if (!stream) {
+    return Promise.resolve("");
+  }
+  return new Promise((resolve2, reject) => {
+    let output = "";
+    stream.setEncoding("utf8");
+    stream.on("data", (chunk) => {
+      output += chunk.toString();
+    });
+    stream.on("error", reject);
+    stream.on("end", () => resolve2(output));
+  });
+}
+function formatProbeResult(result) {
+  return [
+    `Exit code: ${result.exitCode}`,
+    result.stdout.trim() ? `stdout:
+${result.stdout.trim()}` : "",
+    result.stderr.trim() ? `stderr:
+${result.stderr.trim()}` : ""
+  ].filter(Boolean).join("\n");
+}
+async function runSync(opts) {
+  const execution = opts.openSpec.execution;
+  const capture = execution?.captureOutput === true;
+  const abort = createAbortSync(opts.signal, opts.handle, execution?.activityTimeoutMs);
+  const streamState = capture ? captureRunStreams(opts.handle, execution, abort.resetActivityTimer) : pipeRunStreams(opts.handle);
+  abort.resetActivityTimer();
+  try {
+    const { exitCode } = opts.wrapCommand ? await abort.waitForExit(opts.env, opts.jobId) : await abort.waitForHandle();
+    const download = await opts.env.downloadWorkspace({
+      conflictPolicy: opts.openSpec.runner?.download_conflict ?? "refuse"
+    });
+    if (opts.closeAfterDownload !== false) {
+      await opts.env.close();
+    }
+    return {
+      exitCode,
+      download,
+      ...capture ? { stdout: streamState.stdout(), stderr: streamState.stderr() } : {}
+    };
+  } finally {
+    abort.dispose();
+    streamState.dispose();
+  }
+}
+function pipeRunStreams(handle) {
+  handle.stdout?.pipe(process.stdout, { end: false });
+  handle.stderr?.pipe(process.stderr, { end: false });
+  return {
+    stdout: () => "",
+    stderr: () => "",
+    dispose() {
+      handle.stdout?.unpipe(process.stdout);
+      handle.stderr?.unpipe(process.stderr);
+    }
+  };
+}
+function captureRunStreams(handle, execution, onActivity) {
+  let stdout = "";
+  let stderr = "";
+  const listeners = [];
+  const bind = (stream, onChunk) => {
+    if (!stream) return;
+    stream.setEncoding("utf8");
+    const listener = (chunk) => {
+      onActivity();
+      onChunk(chunk.toString());
+    };
+    stream.on("data", listener);
+    listeners.push(() => {
+      stream.off("data", listener);
+    });
+  };
+  bind(handle.stdout, (chunk) => {
+    stdout += chunk;
+    execution?.onStdout?.(chunk);
+  });
+  bind(handle.stderr, (chunk) => {
+    stderr += chunk;
+    execution?.onStderr?.(chunk);
+  });
+  return {
+    stdout: () => stdout,
+    stderr: () => stderr,
+    dispose() {
+      for (const remove2 of listeners) {
+        remove2();
+      }
+    }
+  };
+}
+function createAbortSync(signal, handle, activityTimeoutMs) {
+  let activityTimer;
+  let timedOut = false;
+  const resetActivityTimer = activityTimeoutMs ? () => {
+    if (activityTimer) clearTimeout(activityTimer);
+    activityTimer = setTimeout(() => {
+      timedOut = true;
+      handle.kill("SIGTERM");
+      notifyAbort?.();
+    }, activityTimeoutMs);
+  } : () => {
+  };
+  let notifyAbort;
+  if (signal === void 0) {
+    return {
+      waitForExit: (env, jobId) => waitForExit(toLogStreamEnv(env), jobId),
+      waitForHandle: async () => {
+        const result = await handle.result;
+        if (timedOut) {
+          throw createActivityTimeoutError(activityTimeoutMs);
+        }
+        return result;
+      },
+      resetActivityTimer,
+      dispose() {
+        if (activityTimer) clearTimeout(activityTimer);
+      }
+    };
+  }
+  const exitWaitController = new AbortController();
+  let aborted = signal.aborted;
+  const abortedPromise = new Promise((resolve2) => {
+    notifyAbort = resolve2;
+  });
+  const kill = () => {
+    aborted = true;
+    handle.kill("SIGTERM");
+    notifyAbort?.();
+  };
+  if (signal.aborted) {
+    kill();
+  } else {
+    signal.addEventListener("abort", kill, { once: true });
+  }
+  return {
+    async waitForExit(env, jobId) {
+      if (aborted) {
+        return handle.result;
+      }
+      const exit = waitForExit(toLogStreamEnv(env), jobId, {
+        signal: exitWaitController.signal
+      }).then(
+        (value) => ({ kind: "exit", value }),
+        (error2) => ({ kind: "error", error: error2 })
+      );
+      const result = await Promise.race([
+        exit,
+        abortedPromise.then(() => ({ kind: "abort" }))
+      ]);
+      if (result.kind === "exit") {
+        return result.value;
+      }
+      if (result.kind === "error") {
+        throw result.error;
+      }
+      exitWaitController.abort();
+      return handle.result;
+    },
+    async waitForHandle() {
+      const result = await Promise.race([
+        handle.result.then((value) => ({ kind: "exit", value })),
+        abortedPromise.then(() => ({ kind: "abort" }))
+      ]);
+      if (result.kind === "exit") {
+        if (aborted) {
+          throw createAbortError2();
+        }
+        if (timedOut) {
+          throw createActivityTimeoutError(activityTimeoutMs);
+        }
+        return result.value;
+      }
+      if (timedOut) {
+        throw createActivityTimeoutError(activityTimeoutMs);
+      }
+      throw createAbortError2();
+    },
+    resetActivityTimer,
+    dispose() {
+      if (activityTimer) clearTimeout(activityTimer);
+      exitWaitController.abort();
+      signal.removeEventListener("abort", kill);
+    }
+  };
+}
+function toLogStreamEnv(env) {
+  const candidate = env;
+  return candidate.fs === void 0 ? {} : { fs: candidate.fs };
+}
+function setDetachedJobContext(env, context) {
+  const candidate = env;
+  candidate.setDetachedJobContext?.(context);
+}
+function isPromiseLike(value) {
+  return typeof value.then === "function";
+}
+function createAbortError2() {
+  const error2 = new Error("Agent spawn aborted");
+  error2.name = "AbortError";
+  return error2;
+}
+function createActivityTimeoutError(timeoutMs) {
+  const error2 = new Error(`Agent spawn timed out after ${timeoutMs / 1e3}s of inactivity`);
+  error2.name = "ActivityTimeoutError";
+  return error2;
+}
+function createUlid() {
+  const time = BigInt(Date.now());
+  const random = randomBytes(10);
+  let randomValue = 0n;
+  for (const byte of random) {
+    randomValue = randomValue << 8n | BigInt(byte);
+  }
+  return encodeBase32(time, 10) + encodeBase32(randomValue, 16);
+}
+function encodeBase32(value, length) {
+  const chars = Array.from({ length }, () => "0");
+  let remaining = value;
+  for (let index = length - 1; index >= 0; index -= 1) {
+    chars[index] = ULID_ALPHABET[Number(remaining & 31n)];
+    remaining >>= 5n;
+  }
+  return chars.join("");
+}
+
+// packages/agent-harness-tools/src/poe-command-execution.ts
+import { existsSync as existsSync2, readFileSync } from "node:fs";
+import os3 from "node:os";
+
+// packages/agent-harness-tools/src/execution-env.ts
+var executionEnvFactories = /* @__PURE__ */ new Map();
+function registerExecutionEnvFactory(factory) {
+  executionEnvFactories.set(factory.type, factory);
+}
+function selectExecutionEnv(runtime) {
+  return selectExecutionEnvFactory(runtime.type);
+}
+function selectExecutionEnvFactory(type) {
+  const factory = executionEnvFactories.get(type);
+  if (factory === void 0) {
+    throw new Error(
+      `No execution environment factory registered for runtime type "${type}".`
+    );
+  }
+  return factory;
+}
+
+// packages/agent-harness-tools/src/poe-command-execution.ts
+function resolvePoeCommandExecution(input) {
+  const homeDir = input.context?.homeDir ?? os3.homedir();
+  const runtimeConfigCwd = input.runtimeConfigCwd ?? input.cwd;
+  const loaded = loadRuntimeConfig(runtimeConfigCwd, homeDir);
+  const config = applyRuntimeOverrides(loaded, input.runtime, runtimeConfigCwd);
+  const resolved = resolveRuntime({ cwd: runtimeConfigCwd, config });
+  const factory = selectExecutionEnv(resolved.runtime);
+  const state = input.context?.state ?? loadState(homeDir);
+  return {
+    factory,
+    detach: factory.supportsDetach === true && config.runner.detach,
+    state,
+    openSpec: {
+      cwd: input.cwd,
+      runtimeCwd: runtimeConfigCwd,
+      runtime: resolved.runtime,
+      runner: config.runner,
+      state,
+      env: input.env,
+      uploadIgnoreFiles: config.runner.workspace?.exclude ?? [],
+      jobLabel: {
+        tool: input.tool,
+        argv: input.argv
+      },
+      ...input.openSpec
+    }
+  };
+}
+function applyRuntimeOverrides(config, overrides, cwd = process.cwd()) {
+  if (!overrides) {
+    return { runtime: config.runtime, runner: config.runner };
+  }
+  const base = "rawScope" in config && config.rawScope ? { ...config.rawScope } : { ...config.runtime };
+  const runtime = parseRuntime({
+    ...base,
+    ...overrides.runtime !== void 0 ? { type: overrides.runtime } : {},
+    ...overrides.runtimeImage !== void 0 ? { image: overrides.runtimeImage } : {},
+    ...overrides.runtimeTemplate !== void 0 ? { template_id: overrides.runtimeTemplate } : {},
+    ...overrides.mountPoeCode === true ? { mounts: [...config.runtime.mounts, createPoeCodeMount(cwd)] } : {}
+  });
+  return {
+    runtime,
+    runner: {
+      ...config.runner,
+      ...overrides.detach === true ? { detach: true } : {},
+      ...overrides.runnerSync !== void 0 ? { sync: overrides.runnerSync } : {}
+    }
+  };
+}
+function createPoeCodeMount(cwd) {
+  return {
+    source: cwd,
+    target: "/usr/local/lib/poe-code",
+    readonly: true
+  };
+}
+function loadRuntimeConfig(cwd, homeDir) {
+  const document = deepMergeDocuments(
+    readConfigDocument(resolveConfigPath(homeDir)),
+    readConfigDocument(resolveProjectConfigPath(cwd))
+  );
+  const runtimeScope = resolveScope(runtimeConfigScope.schema, document.runtime, process.env);
+  return {
+    rawScope: { ...runtimeScope },
+    runtime: parseRuntime(runtimeScope),
+    runner: runtimeScope.runner
+  };
+}
+function readConfigDocument(filePath) {
+  if (!existsSync2(filePath)) {
+    return {};
+  }
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function loadState(homeDir) {
+  if (process.env.VITEST === "true") {
+    return createMemoryStateManager();
+  }
+  return createStateManager(homeDir);
+}
+function createMemoryStateManager() {
+  const jobs = /* @__PURE__ */ new Map();
+  return {
+    templates: {
+      async get() {
+        return null;
+      },
+      async put() {
+      },
+      async remove() {
+      },
+      async list() {
+        return [];
+      }
+    },
+    jobs: {
+      async get(id) {
+        return jobs.get(id) ?? null;
+      },
+      async put(entry) {
+        jobs.set(entry.id, entry);
+      },
+      async update(id, patch) {
+        const current = jobs.get(id);
+        if (!current) {
+          return null;
+        }
+        const updated = { ...current, ...patch, id };
+        jobs.set(id, updated);
+        return updated;
+      },
+      async list(filter) {
+        const entries = Array.from(jobs.values());
+        if (!filter) {
+          return entries;
+        }
+        return entries.filter(
+          (entry) => Object.entries(filter).every(([key, value]) => entry[key] === value)
+        );
+      },
+      async remove(id) {
+        jobs.delete(id);
+      }
+    }
+  };
+}
+
+// packages/agent-harness-tools/src/workspace-transfer.ts
+import { createHash as createHash3 } from "node:crypto";
+import { promises as nodeFs3 } from "node:fs";
+import path24 from "node:path";
+
+// packages/process-runner/src/docker/context.ts
+import { execSync } from "node:child_process";
+function detectContext() {
+  try {
+    const output = execSync("colima list --json", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "ignore"]
+    });
+    const lines = output.trim().split("\n").filter(Boolean);
+    for (const line of lines) {
+      const profile = JSON.parse(line);
+      if (profile.status === "Running" && profile.runtime === "docker") {
+        const name = profile.name ?? profile.profile;
+        if (!name) {
+          continue;
+        }
+        return name === "default" ? "colima" : `colima-${name}`;
+      }
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+function buildContextArgs(engine, context) {
+  if (engine === "docker" && context) {
+    return ["--context", context];
+  }
+  return [];
+}
+
+// packages/process-runner/src/docker/engine.ts
+import { execSync as execSync2 } from "node:child_process";
+function detectEngine() {
+  if (isEngineAvailable("docker")) {
+    return "docker";
+  }
+  if (isEngineAvailable("podman")) {
+    return "podman";
+  }
+  throw new Error(
+    "No container engine found. Please install Docker or Podman:\n  - Docker Desktop: https://www.docker.com/products/docker-desktop\n  - Colima (macOS): brew install colima && colima start\n  - Podman: https://podman.io/docs/installation"
+  );
+}
+function isEngineAvailable(engine) {
+  try {
+    execSync2(`${engine} --version`, {
+      stdio: "ignore"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// packages/process-runner/src/docker/docker-runner.ts
+import * as childProcess from "node:child_process";
+import { randomBytes as randomBytes2 } from "node:crypto";
+
+// packages/process-runner/src/docker/args.ts
+import path25 from "node:path";
+function buildDockerRunArgs(input) {
+  const args = [input.engine];
+  if (input.engine === "docker" && input.context) {
+    args.push("--context", input.context);
+  }
+  args.push("run");
+  if (input.rm) {
+    args.push("--rm");
+  }
+  if (input.detached) {
+    args.push("-d");
+  }
+  if (input.interactive) {
+    args.push("-i");
+  }
+  if (input.tty) {
+    args.push("-t");
+  }
+  args.push("--name", input.containerName);
+  if (input.cwd !== void 0) {
+    args.push("-w", input.cwd);
+  }
+  for (const [key, value] of Object.entries(input.env ?? {})) {
+    args.push("-e", `${key}=${value}`);
+  }
+  for (const mount of input.mounts) {
+    const volume = `${path25.resolve(mount.source)}:${mount.target}${mount.readonly ? ":ro" : ""}`;
+    args.push("-v", volume);
+  }
+  for (const port of input.ports) {
+    const mapping = `${port.host}:${port.container}${port.protocol === void 0 || port.protocol === "tcp" ? "" : `/${port.protocol}`}`;
+    args.push("-p", mapping);
+  }
+  if (input.network !== void 0) {
+    args.push("--network", input.network);
+  }
+  args.push(...input.extraArgs, input.image, input.command, ...input.args);
+  return args;
+}
+
+// packages/process-runner/src/docker/docker-execution-env.ts
+import { createHash as createHash4, randomBytes as randomBytes3 } from "node:crypto";
+import { mkdtempSync, rmSync } from "node:fs";
+import { readFile as readFile10 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path26 from "node:path";
+
+// packages/process-runner/src/host/host-runner.ts
+import { spawn as spawnChildProcess } from "node:child_process";
+function createHostRunner(options = {}) {
+  const detached = options.detached === true;
+  return {
+    name: "host",
+    exec(spec) {
+      const stdinMode = spec.stdin ?? "ignore";
+      const stdoutMode = spec.stdout ?? "pipe";
+      const stderrMode = spec.stderr ?? "pipe";
+      const stdio = stdinMode === "inherit" && stdoutMode === "inherit" && stderrMode === "inherit" ? "inherit" : [stdinMode, stdoutMode, stderrMode];
+      const child = spawnChildProcess(spec.command, spec.args ?? [], {
+        cwd: spec.cwd,
+        env: spec.env,
+        stdio,
+        ...detached ? { detached: true } : {}
+      });
+      if (detached) {
+        child.unref();
+      }
+      const kill = (signal) => {
+        if (detached && process.platform !== "win32" && child.pid !== void 0) {
+          process.kill(-child.pid, signal);
+          return;
+        }
+        child.kill(signal);
+      };
+      let settled = false;
+      let resolveResult = null;
+      const result = new Promise((resolve2) => {
+        resolveResult = resolve2;
+      });
+      const cleanupAbort = bindAbortSignal(spec.signal, () => {
+        kill("SIGTERM");
+      });
+      child.once("close", (code) => {
+        if (settled) return;
+        settled = true;
+        cleanupAbort();
+        resolveResult?.({ exitCode: code ?? 1 });
+      });
+      child.once("error", () => {
+        if (settled) return;
+        settled = true;
+        cleanupAbort();
+        resolveResult?.({ exitCode: 1 });
+      });
+      return {
+        pid: child.pid ?? null,
+        stdin: child.stdin,
+        stdout: child.stdout,
+        stderr: child.stderr,
+        result,
+        kill
+      };
+    }
+  };
+}
+function bindAbortSignal(signal, onAbort) {
+  if (signal === void 0) {
+    return () => {
+    };
+  }
+  if (signal.aborted) {
+    onAbort();
+    return () => {
+    };
+  }
+  signal.addEventListener("abort", onAbort, { once: true });
+  return () => {
+    signal.removeEventListener("abort", onAbort);
+  };
+}
+
+// packages/process-runner/src/docker/docker-execution-env.ts
+var containerCommand = ["sh", "-c", "while :; do sleep 3600; done"];
+var dockerExecutionEnvFactory = {
+  type: "docker",
+  supportsDetach: true,
+  async open(spec) {
+    const runtime = parseDockerRuntime(spec.runtime);
+    const runner = spec.hostRunner ?? createHostRunner();
+    const engine = runtime.engine ?? detectEngine();
+    const context = detectContext();
+    const image = await resolveImage({
+      spec,
+      runtime,
+      runner,
+      engine,
+      context
+    });
+    const containerName = createContainerName();
+    const runArgs = buildDockerRunArgs({
+      engine,
+      context,
+      image,
+      command: containerCommand[0],
+      args: containerCommand.slice(1),
+      cwd: void 0,
+      env: void 0,
+      mounts: runtime.mounts ?? [],
+      ports: [],
+      network: runtime.network,
+      containerName,
+      detached: true,
+      interactive: true,
+      tty: false,
+      rm: false,
+      extraArgs: runtime.extra_args ?? []
+    });
+    const [command, ...args] = runArgs;
+    const id = (await runAndRead(runner, { command, args, stdout: "pipe", stderr: "pipe" })).trim();
+    return createDockerEnv({
+      id,
+      spec,
+      runner,
+      engine,
+      context
+    });
+  },
+  async attach(envId, context) {
+    const engine = detectEngine();
+    return createDockerEnv({
+      id: envId,
+      spec: createAttachedSpec(context?.cwd),
+      runner: createHostRunner(),
+      engine,
+      context: detectContext(),
+      attachedJobId: context?.jobId
+    });
+  }
+};
+function createDockerEnv(input) {
+  const containerRef = input.id;
+  return {
+    id: containerRef,
+    job: input.attachedJobId === void 0 ? null : createContainerJob(containerRef, input.runner, input.engine, input.context, input.attachedJobId),
+    async uploadWorkspace() {
+      const tempDir = mkdtempSync(path26.join(tmpdir(), "poe-docker-upload-"));
+      const archivePath = path26.join(tempDir, "workspace.tar");
+      try {
+        const excludeArgs = input.spec.uploadIgnoreFiles.flatMap((ignored) => [
+          "--exclude",
+          ignored
+        ]);
+        const tarArgs = [...excludeArgs, "-cf", archivePath, "-C", input.spec.cwd, "."];
+        await runOrThrow(input.runner, {
+          command: "tar",
+          args: tarArgs,
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        await runOrThrow(input.runner, {
+          command: input.engine,
+          args: [
+            ...buildContextArgs(input.engine, input.context),
+            "cp",
+            archivePath,
+            `${containerRef}:/tmp/poe-workspace-upload.tar`
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        await runOrThrow(input.runner, {
+          command: input.engine,
+          args: [
+            ...buildContextArgs(input.engine, input.context),
+            "exec",
+            containerRef,
+            "sh",
+            "-c",
+            `mkdir -p ${shellQuote2(input.spec.cwd)} && tar -xf /tmp/poe-workspace-upload.tar -C ${shellQuote2(input.spec.cwd)}`
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        return { files: 0, bytes: 0, skipped: [] };
+      } finally {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+    },
+    async downloadWorkspace(opts) {
+      const tempDir = mkdtempSync(path26.join(tmpdir(), "poe-docker-download-"));
+      const archivePath = path26.join(tempDir, "workspace.tar");
+      try {
+        await runOrThrow(input.runner, {
+          command: input.engine,
+          args: [
+            ...buildContextArgs(input.engine, input.context),
+            "exec",
+            containerRef,
+            "sh",
+            "-c",
+            `tar -cf /tmp/poe-workspace-download.tar -C ${shellQuote2(input.spec.cwd)} .`
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        await runOrThrow(input.runner, {
+          command: input.engine,
+          args: [
+            ...buildContextArgs(input.engine, input.context),
+            "cp",
+            `${containerRef}:/tmp/poe-workspace-download.tar`,
+            archivePath
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        const extractMode = opts.conflictPolicy === "refuse" ? "-xkf" : "-xf";
+        await runOrThrow(input.runner, {
+          command: "tar",
+          args: [extractMode, archivePath, "-C", input.spec.cwd],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        return { files: 0, bytes: 0, conflicts: [] };
+      } finally {
+        rmSync(tempDir, { recursive: true, force: true });
+      }
+    },
+    exec(spec) {
+      return input.runner.exec({
+        command: input.engine,
+        args: [
+          ...buildContextArgs(input.engine, input.context),
+          "exec",
+          ...spec.stdin === "pipe" || spec.stdin === "inherit" ? ["-i"] : [],
+          ...spec.tty === true ? ["-t"] : [],
+          ...spec.cwd !== void 0 ? ["-w", spec.cwd] : [],
+          ...buildEnvArgs(spec.env),
+          containerRef,
+          spec.command,
+          ...spec.args ?? []
+        ],
+        stdin: spec.stdin,
+        stdout: spec.stdout,
+        stderr: spec.stderr,
+        tty: spec.tty
+      });
+    },
+    async detach() {
+      return createContainerJob(containerRef, input.runner, input.engine, input.context);
+    },
+    shell() {
+      const shellSpec = input.spec.shellSpec;
+      return this.exec({
+        command: shellSpec?.command ?? input.spec.env.SHELL ?? "sh",
+        ...shellSpec?.args ? { args: shellSpec.args } : {},
+        cwd: input.spec.cwd,
+        env: shellSpec && "env" in shellSpec ? shellSpec.env : input.spec.env,
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+        tty: true
+      });
+    },
+    async close() {
+      await runOrThrow(input.runner, {
+        command: input.engine,
+        args: [...buildContextArgs(input.engine, input.context), "rm", "-f", containerRef],
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+    }
+  };
+}
+async function resolveImage(input) {
+  if (input.runtime.image !== void 0) {
+    return input.runtime.image;
+  }
+  const result = await buildDockerRuntimeTemplate({
+    cwd: input.spec.cwd,
+    runtime: input.runtime,
+    state: input.spec.state,
+    runner: input.runner
+  });
+  return result.image;
+}
+async function buildDockerRuntimeTemplate(input) {
+  const runner = input.runner ?? createHostRunner();
+  const engine = input.runtime.engine ?? detectEngine();
+  const context = detectContext();
+  const dockerfilePath = path26.resolve(
+    input.cwd,
+    input.runtime.dockerfile ?? path26.join(".poe-code", "Dockerfile")
+  );
+  const buildContext = path26.resolve(input.cwd, input.runtime.build_context ?? ".");
+  const dockerfileBytes = await readFile10(dockerfilePath);
+  const hash = hashDockerTemplate(dockerfileBytes, input.runtime.build_args ?? {});
+  const cached2 = input.force ? null : await input.state?.templates.get("docker", hash);
+  if (cached2?.image !== void 0) {
+    return {
+      backend: "docker",
+      hash,
+      image: cached2.image,
+      cached: true
+    };
+  }
+  const image = `poe-code/local:${hash}`;
+  await buildImage({
+    runner,
+    engine,
+    context,
+    image,
+    dockerfilePath,
+    buildContext,
+    buildArgs: input.runtime.build_args ?? {}
+  });
+  await input.state?.templates.put("docker", {
+    hash,
+    image,
+    runtime_type: "docker",
+    dockerfile_path: dockerfilePath,
+    built_at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  return {
+    backend: "docker",
+    hash,
+    image,
+    cached: false
+  };
+}
+function hashDockerTemplate(dockerfileBytes, buildArgs) {
+  const hash = createHash4("sha256");
+  hash.update(dockerfileBytes);
+  hash.update("\0");
+  for (const [key, value] of sortedBuildArgs(buildArgs)) {
+    hash.update(key);
+    hash.update("=");
+    hash.update(value);
+    hash.update("\0");
+  }
+  return hash.digest("hex");
+}
+async function buildImage(input) {
+  await runOrThrow(input.runner, {
+    command: input.engine,
+    args: [
+      ...buildContextArgs(input.engine, input.context),
+      "build",
+      "--tag",
+      input.image,
+      "-f",
+      input.dockerfilePath,
+      ...sortedBuildArgs(input.buildArgs).flatMap(([key, value]) => [
+        "--build-arg",
+        `${key}=${value}`
+      ]),
+      input.buildContext
+    ],
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+}
+function parseDockerRuntime(runtime) {
+  if (!runtime || typeof runtime !== "object" || Array.isArray(runtime)) {
+    throw new Error("docker runtime must be an object");
+  }
+  const record = runtime;
+  if (record.type !== "docker") {
+    throw new Error('docker runtime type must be "docker"');
+  }
+  return record;
+}
+async function runAndRead(runner, spec) {
+  const handle = runner.exec(spec);
+  const stdout = readStream2(handle.stdout);
+  const stderr = readStream2(handle.stderr);
+  const result = await handle.result;
+  const output = await stdout;
+  if (result.exitCode !== 0) {
+    const errorOutput = await stderr;
+    throw new Error(
+      `Command failed with exit code ${result.exitCode}: ${spec.command} ${(spec.args ?? []).join(" ")}${errorOutput ? `
+${errorOutput}` : ""}`
+    );
+  }
+  return output;
+}
+async function runOrThrow(runner, spec) {
+  await runAndRead(runner, spec);
+}
+async function readStream2(stream) {
+  if (stream === null) {
+    return "";
+  }
+  stream.setEncoding("utf8");
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(String(chunk));
+  }
+  return chunks.join("");
+}
+function sortedBuildArgs(buildArgs) {
+  return Object.entries(buildArgs).sort(([left], [right]) => left.localeCompare(right));
+}
+function buildEnvArgs(env) {
+  if (env === void 0) {
+    return [];
+  }
+  return Object.entries(env).flatMap(([key, value]) => ["-e", `${key}=${value}`]);
+}
+function createContainerName() {
+  return `poe-env-${randomBytes3(6).toString("hex")}`;
+}
+function createContainerJob(containerId, runner, engine, context, jobId = containerId) {
+  return {
+    id: jobId,
+    envId: containerId,
+    tool: "docker",
+    argv: ["attach", containerId],
+    async status() {
+      const handle = runner.exec({
+        command: engine,
+        args: [
+          ...buildContextArgs(engine, context),
+          "inspect",
+          "-f",
+          "{{.State.Status}}",
+          containerId
+        ],
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+      const stdout = await readStream2(handle.stdout);
+      const result = await handle.result;
+      if (result.exitCode !== 0) {
+        return "lost";
+      }
+      return stdout.trim() === "running" ? "running" : "exited";
+    },
+    async *stream(opts) {
+      const handle = runner.exec({
+        command: engine,
+        args: [
+          ...buildContextArgs(engine, context),
+          "exec",
+          containerId,
+          "sh",
+          "-c",
+          `test -f ${shellQuote2(`/tmp/poe-jobs/${jobId}.log`)} && tail -c +${(opts?.sinceByte ?? 0) + 1} ${shellQuote2(`/tmp/poe-jobs/${jobId}.log`)} || true`
+        ],
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+      const stdout = await readStream2(handle.stdout);
+      await handle.result;
+      if (stdout.length > 0) {
+        yield { byteOffset: opts?.sinceByte ?? 0, data: stdout };
+      }
+    },
+    async wait() {
+      const handle = runner.exec({
+        command: engine,
+        args: [...buildContextArgs(engine, context), "wait", containerId],
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+      const stdout = await readStream2(handle.stdout);
+      const result = await handle.result;
+      return { exitCode: Number.parseInt(stdout.trim(), 10) || result.exitCode };
+    },
+    async kill(signal) {
+      const args = signal === void 0 || signal === "SIGTERM" ? ["stop", containerId] : ["kill", ...signal === "SIGKILL" ? [] : [`--signal=${signal}`], containerId];
+      await runOrThrow(runner, {
+        command: engine,
+        args: [...buildContextArgs(engine, context), ...args],
+        stdout: "pipe",
+        stderr: "pipe"
+      });
+    }
+  };
+}
+function createAttachedSpec(cwd = "/workspace") {
+  return {
+    cwd,
+    runtime: {
+      type: "docker",
+      image: "attached",
+      build_args: {},
+      mounts: []
+    },
+    env: {},
+    uploadIgnoreFiles: [],
+    jobLabel: {
+      tool: "docker",
+      argv: []
+    }
+  };
+}
+function shellQuote2(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+
+// packages/process-runner/src/host/host-execution-env.ts
+var hostExecutionEnvFactory = {
+  type: "host",
+  supportsDetach: false,
+  async open(openSpec) {
+    return {
+      id: "host",
+      job: null,
+      async uploadWorkspace() {
+        return {
+          files: 0,
+          bytes: 0,
+          skipped: []
+        };
+      },
+      async downloadWorkspace() {
+        return {
+          files: 0,
+          bytes: 0,
+          conflicts: []
+        };
+      },
+      exec(spec) {
+        return createHostRunner().exec(spec);
+      },
+      async detach() {
+        throw new Error("host runtime does not support detach because host has no addressable env");
+      },
+      shell() {
+        const shellSpec = openSpec.shellSpec;
+        return createHostRunner().exec({
+          command: shellSpec?.command ?? openSpec.env.SHELL ?? process.env.SHELL ?? "sh",
+          ...shellSpec?.args ? { args: shellSpec.args } : {},
+          cwd: openSpec.cwd,
+          env: shellSpec && "env" in shellSpec ? shellSpec.env : openSpec.env,
+          stdin: "inherit",
+          stdout: "inherit",
+          stderr: "inherit",
+          tty: true
+        });
+      },
+      async close() {
+      }
+    };
+  },
+  async attach() {
+    throw new Error("host runtime does not support reattach");
+  }
+};
+
+// packages/process-runner/src/testing/mock-runner.ts
+import { Readable, Writable } from "node:stream";
+
+// packages/runner-e2b/src/factory.ts
+import path30 from "node:path";
+
+// packages/runner-e2b/src/sdk.ts
+import { Template, Sandbox } from "e2b";
+async function createSandbox(opts) {
+  return Sandbox.create(opts.templateId, {
+    apiKey: opts.apiKey,
+    envs: opts.env,
+    ...opts.timeoutMinutes === void 0 ? {} : { timeoutMs: opts.timeoutMinutes * 6e4 }
+  });
+}
+async function connectSandbox(id, apiKey) {
+  return Sandbox.connect(id, apiKey === void 0 ? void 0 : { apiKey });
+}
+async function buildTemplate(opts) {
+  const template = Template({ fileContextPath: opts.buildContext }).fromDockerfile(
+    opts.dockerfilePath
+  );
+  if (opts.fromTemplate !== void 0 && opts.fromTemplate.length > 0) {
+    template.fromTemplate(opts.fromTemplate);
+  }
+  const result = await Template.build(template, opts.name, {
+    apiKey: opts.apiKey,
+    ...opts.cpu === void 0 ? {} : { cpuCount: opts.cpu },
+    ...opts.memoryMb === void 0 ? {} : { memoryMB: opts.memoryMb },
+    ...opts.onLog ? { onBuildLogs: opts.onLog } : {}
+  });
+  return { templateId: result.templateId };
+}
+function toArrayBuffer(buffer) {
+  const output = new ArrayBuffer(buffer.byteLength);
+  new Uint8Array(output).set(buffer);
+  return output;
+}
+async function readableToString(stream) {
+  if (stream === null) {
+    return "";
+  }
+  stream.setEncoding("utf8");
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(String(chunk));
+  }
+  return chunks.join("");
+}
+
+// packages/runner-e2b/src/template-build.ts
+import { createHash as createHash5 } from "node:crypto";
+import { readdir as readdir4, readFile as readFile11 } from "node:fs/promises";
+import path27 from "node:path";
+var BUILD_LOG_TAIL_SIZE = 30;
+async function buildE2bRuntimeTemplate(input) {
+  const dockerfileBytes = await readFile11(input.dockerfilePath);
+  const buildContextFiles = await readBuildContextFiles(input.buildContext);
+  const hash = hashTemplate(dockerfileBytes, buildContextFiles, input.runtime.build_args);
+  const cached2 = input.force === true ? null : await input.state?.templates.get("e2b", hash);
+  if (cached2?.template_id !== void 0) {
+    return { backend: "e2b", hash, templateId: cached2.template_id, cached: true };
+  }
+  const tail = [];
+  const onLog = (entry) => {
+    tail.push(entry.message);
+    if (tail.length > BUILD_LOG_TAIL_SIZE) {
+      tail.shift();
+    }
+    input.onLog?.(entry);
+  };
+  let built;
+  try {
+    built = await buildTemplate({
+      apiKey: input.apiKey,
+      name: `poe-code-${hash.slice(0, 32)}`,
+      dockerfilePath: input.dockerfilePath,
+      buildContext: input.buildContext,
+      cpu: input.runtime.cpu,
+      memoryMb: input.runtime.memory_mb,
+      fromTemplate: input.runtime.from_template,
+      onLog
+    });
+  } catch (error2) {
+    throw decorateBuildError(error2, tail);
+  }
+  await input.state?.templates.put("e2b", {
+    hash,
+    template_id: built.templateId,
+    runtime_type: "e2b",
+    dockerfile_path: input.dockerfilePath,
+    built_at: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  return { backend: "e2b", hash, templateId: built.templateId, cached: false };
+}
+function decorateBuildError(error2, tail) {
+  const original = error2 instanceof Error ? error2 : new Error(String(error2));
+  if (tail.length === 0) {
+    return original;
+  }
+  const decorated = new Error(`${original.message}
+
+Last build output:
+${tail.join("\n")}`);
+  decorated.stack = original.stack;
+  decorated.cause = original;
+  return decorated;
+}
+function hashTemplate(dockerfileBytes, buildContextFiles, buildArgs) {
+  const hash = createHash5("sha256");
+  hash.update(dockerfileBytes);
+  hash.update("\0");
+  for (const file of buildContextFiles) {
+    hash.update(file.relativePath);
+    hash.update("\0");
+    hash.update(file.bytes);
+    hash.update("\0");
+  }
+  for (const [key, value] of Object.entries(buildArgs).sort(
+    ([left], [right]) => left.localeCompare(right)
+  )) {
+    hash.update(key);
+    hash.update("=");
+    hash.update(value);
+    hash.update("\0");
+  }
+  return hash.digest("hex");
+}
+async function readBuildContextFiles(buildContext) {
+  const files = [];
+  await collectBuildContextFiles(buildContext, "", files);
+  return files.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
+}
+async function collectBuildContextFiles(buildContext, relativeDir, files) {
+  const absoluteDir = path27.join(buildContext, relativeDir);
+  const entries = await readdir4(absoluteDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const relativePath = path27.join(relativeDir, entry.name);
+    if (entry.isDirectory()) {
+      await collectBuildContextFiles(buildContext, relativePath, files);
+      continue;
+    }
+    if (!entry.isFile()) {
+      continue;
+    }
+    files.push({
+      relativePath: relativePath.split(path27.sep).join("/"),
+      bytes: await readFile11(path27.join(buildContext, relativePath))
+    });
+  }
+}
+
+// packages/runner-e2b/src/opened-env.ts
+import { mkdtempSync as mkdtempSync2, rmSync as rmSync2 } from "node:fs";
+import { readFile as readFile12, writeFile as writeFile7 } from "node:fs/promises";
+import { tmpdir as tmpdir2 } from "node:os";
+import path29 from "node:path";
+import { PassThrough, Writable as Writable2 } from "node:stream";
+
+// packages/runner-e2b/src/job-handle.ts
+import path28 from "node:path";
+var JOB_DIR2 = "/tmp/poe-jobs";
+function createE2bJobHandle(input) {
+  const fs14 = createE2bLogStreamFs(input.sandbox);
+  return {
+    id: input.jobId,
+    envId: input.envId,
+    tool: input.tool,
+    argv: input.argv,
+    async status() {
+      const exit = await readExitCode(input.sandbox, input.jobId);
+      if (exit !== null) {
+        return "exited";
+      }
+      const processes = await input.sandbox.commands.list();
+      const isRunning = input.pid === void 0 ? processes.some((process2) => processMentionsJob(process2, input.jobId)) : processes.some((process2) => process2.pid === input.pid);
+      return isRunning ? "running" : "lost";
+    },
+    stream(opts = {}) {
+      return streamLogFile({ fs: fs14 }, input.jobId, opts);
+    },
+    async wait() {
+      const result = await waitForExit({ fs: fs14 }, input.jobId);
+      const preserveMs = input.preserveAfterExitHours * 60 * 60 * 1e3;
+      if (preserveMs > 0) {
+        await input.sandbox.setTimeout(preserveMs);
+      }
+      return result;
+    },
+    async kill() {
+      const pids = input.pid === void 0 ? (await input.sandbox.commands.list()).filter((process2) => processMentionsJob(process2, input.jobId)).map((process2) => process2.pid) : [input.pid];
+      await Promise.all(pids.map((pid) => input.sandbox.commands.kill(pid)));
+    }
+  };
+}
+function createE2bLogStreamFs(sandbox) {
+  return {
+    promises: {
+      async readFile(filePath) {
+        return Buffer.from(await sandbox.files.read(filePath, { format: "bytes" }));
+      },
+      async stat(filePath) {
+        const result = await sandbox.commands.run(
+          `stat -c %Y ${shellQuote3(filePath)} 2>/dev/null || stat -f %m ${shellQuote3(filePath)}`
+        );
+        if (!("stdout" in result)) {
+          throw new Error(`Unable to stat ${filePath}`);
+        }
+        const seconds = Number(result.stdout?.trim());
+        if (!Number.isFinite(seconds)) {
+          throw new Error(`Unable to stat ${filePath}`);
+        }
+        return { mtimeMs: seconds * 1e3 };
+      }
+    },
+    watch(filePath, listener) {
+      let closed = false;
+      let stop = null;
+      void sandbox.files.watchDir(path28.dirname(filePath), listener, { recursive: false }).then((handle) => {
+        if (closed) {
+          void handle.stop();
+          return;
+        }
+        stop = () => {
+          void handle.stop();
+        };
+      });
+      return {
+        close() {
+          closed = true;
+          stop?.();
+        }
+      };
+    }
+  };
+}
+function processMentionsJob(process2, jobId) {
+  const needle = `/tmp/poe-jobs/${jobId}`;
+  return process2.cmd.includes(needle) || process2.args.some((arg) => arg.includes(needle));
+}
+function shellQuote3(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+async function readExitCode(sandbox, jobId) {
+  try {
+    const contents = await sandbox.files.read(`${JOB_DIR2}/${jobId}.exit`);
+    const exitCode = Number(contents.trim());
+    return Number.isInteger(exitCode) ? exitCode : null;
+  } catch {
+    return null;
+  }
+}
+
+// packages/runner-e2b/src/opened-env.ts
+var REMOTE_COMMAND_STDERR_TAIL_SIZE = 30;
+function createOpenedE2bEnv(input) {
+  const hostRunner = input.spec.hostRunner ?? createHostRunner();
+  const hostWorkspaceDir = path29.resolve(input.spec.cwd);
+  const sandboxWorkspaceDir = normalizeSandboxWorkspaceDir(input.runtime.workspace_dir);
+  let lastProcess = null;
+  let detachedJobContext = null;
+  const mapWorkspaceCwd = (cwd) => {
+    if (cwd === void 0) {
+      return void 0;
+    }
+    if (path29.isAbsolute(cwd) && path29.resolve(cwd) === hostWorkspaceDir) {
+      return sandboxWorkspaceDir;
+    }
+    return cwd;
+  };
+  const attachedJobId = input.spec.detachedJobId;
+  const env = {
+    id: input.sandbox.sandboxId,
+    job: attachedJobId ? createE2bJobHandle({
+      sandbox: input.sandbox,
+      envId: input.sandbox.sandboxId,
+      jobId: attachedJobId,
+      tool: input.spec.jobLabel.tool,
+      argv: input.spec.jobLabel.argv,
+      preserveAfterExitHours: input.runtime.preserve_after_exit_hours ?? 24
+    }) : null,
+    fs: createE2bLogStreamFs(input.sandbox),
+    setDetachedJobContext(context) {
+      detachedJobContext = context;
+    },
+    async uploadWorkspace() {
+      if (input.spec.runner?.sync === "none") {
+        return { files: 0, bytes: 0, skipped: [] };
+      }
+      const tempDir = mkdtempSync2(path29.join(tmpdir2(), "poe-e2b-upload-"));
+      const archivePath = path29.join(tempDir, "workspace.tar");
+      try {
+        await runOrThrow2(hostRunner, {
+          command: "tar",
+          args: [
+            ...input.spec.uploadIgnoreFiles.flatMap((ignored) => ["--exclude", ignored]),
+            "-cf",
+            archivePath,
+            "-C",
+            input.spec.cwd,
+            "."
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        await input.sandbox.files.write(
+          "/tmp/poe-workspace-upload.tar",
+          toArrayBuffer(await readFile12(archivePath))
+        );
+        await runRemoteOrThrow(
+          input.sandbox,
+          createUploadWorkspaceCommand(sandboxWorkspaceDir)
+        );
+        return { files: 0, bytes: 0, skipped: [] };
+      } finally {
+        rmSync2(tempDir, { recursive: true, force: true });
+      }
+    },
+    async downloadWorkspace(opts) {
+      if (input.spec.runner?.sync === "upload" || input.spec.runner?.sync === "none") {
+        return { files: 0, bytes: 0, conflicts: [] };
+      }
+      const tempDir = mkdtempSync2(path29.join(tmpdir2(), "poe-e2b-download-"));
+      const archivePath = path29.join(tempDir, "workspace.tar");
+      try {
+        await runRemoteOrThrow(
+          input.sandbox,
+          `tar -cf /tmp/poe-workspace-download.tar -C ${shellQuote4(sandboxWorkspaceDir)} .`
+        );
+        const archive = await input.sandbox.files.read("/tmp/poe-workspace-download.tar", {
+          format: "bytes"
+        });
+        await writeFile7(archivePath, Buffer.from(archive));
+        await runOrThrow2(hostRunner, {
+          command: "tar",
+          args: [
+            opts.conflictPolicy === "refuse" ? "-xkf" : "-xf",
+            archivePath,
+            "-C",
+            input.spec.cwd
+          ],
+          stdout: "pipe",
+          stderr: "pipe"
+        });
+        return { files: 0, bytes: archive.byteLength, conflicts: [] };
+      } finally {
+        rmSync2(tempDir, { recursive: true, force: true });
+      }
+    },
+    exec(spec) {
+      const handle = runE2bCommand(input.sandbox, {
+        ...spec,
+        cwd: mapWorkspaceCwd(spec.cwd),
+        env: resolveSandboxCommandEnv(spec.env)
+      });
+      lastProcess = { started: handle.started };
+      return handle;
+    },
+    async detach() {
+      if (detachedJobContext === null) {
+        throw new Error("Cannot detach E2B environment before a job context is registered.");
+      }
+      if (lastProcess === null) {
+        throw new Error("Cannot detach E2B environment before a command is running.");
+      }
+      const command = await lastProcess.started;
+      const preserveAfterExitHours = input.runtime.preserve_after_exit_hours ?? 24;
+      const preserveMs = preserveAfterExitHours * 60 * 60 * 1e3;
+      if (preserveMs > 0) {
+        await input.sandbox.setTimeout(preserveMs);
+      }
+      return createE2bJobHandle({
+        sandbox: input.sandbox,
+        envId: input.sandbox.sandboxId,
+        jobId: detachedJobContext.id,
+        tool: detachedJobContext.tool,
+        argv: detachedJobContext.argv,
+        pid: command.pid,
+        preserveAfterExitHours
+      });
+    },
+    shell() {
+      const shellSpec = input.spec.shellSpec;
+      const command = shellSpec?.command ?? input.spec.env.SHELL ?? "sh";
+      return runE2bPty(input.sandbox, {
+        command,
+        ...shellSpec?.args ? { args: shellSpec.args } : {},
+        cwd: mapWorkspaceCwd(shellSpec?.cwd ?? input.spec.cwd),
+        env: resolveSandboxCommandEnv(
+          shellSpec && "env" in shellSpec ? shellSpec.env : input.spec.env
+        ),
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+        tty: true
+      });
+    },
+    async close() {
+      await input.sandbox.kill();
+    }
+  };
+  return env;
+}
+function runE2bCommand(sandbox, spec) {
+  const stdout = spec.stdout === "inherit" ? null : new PassThrough();
+  const stderr = spec.stderr === "inherit" ? null : new PassThrough();
+  let e2bHandle = null;
+  const command = shellCommand([spec.command, ...spec.args ?? []]);
+  const started = sandbox.commands.run(command, {
+    background: true,
+    cwd: spec.cwd,
+    envs: spec.env,
+    stdin: spec.stdin === "pipe",
+    onStdout(data) {
+      stdout?.write(data);
+      if (spec.stdout === "inherit") {
+        process.stdout.write(data);
+      }
+    },
+    onStderr(data) {
+      stderr?.write(data);
+      if (spec.stderr === "inherit") {
+        process.stderr.write(data);
+      }
+    }
+  });
+  const stdin = spec.stdin === "pipe" ? new Writable2({
+    write(chunk, _encoding, callback) {
+      started.then(
+        (handle) => sandbox.commands.sendStdin(
+          handle.pid,
+          Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk))
+        )
+      ).then(() => callback(), callback);
+    },
+    final(callback) {
+      if (sandbox.commands.closeStdin === void 0) {
+        callback();
+        return;
+      }
+      started.then((handle) => sandbox.commands.closeStdin(handle.pid)).then(() => callback(), callback);
+    }
+  }) : null;
+  const result = started.then((handle) => {
+    e2bHandle = handle;
+    return handle.wait();
+  }).then(
+    (result2) => {
+      stdout?.end();
+      stderr?.end();
+      return { exitCode: result2.exitCode ?? 0 };
+    },
+    (error2) => {
+      stdout?.end();
+      stderr?.end();
+      if (isExitError(error2)) {
+        return { exitCode: error2.exitCode };
+      }
+      return { exitCode: 1 };
+    }
+  );
+  return {
+    get pid() {
+      return e2bHandle?.pid ?? null;
+    },
+    stdin,
+    stdout,
+    stderr,
+    result,
+    kill() {
+      void e2bHandle?.kill();
+    },
+    get e2bHandle() {
+      return e2bHandle;
+    },
+    started
+  };
+}
+function runE2bPty(sandbox, spec) {
+  const stdout = new PassThrough();
+  let handleRef = null;
+  const stdin = new Writable2({
+    write(chunk, _encoding, callback) {
+      if (handleRef === null) {
+        callback(new Error("E2B PTY stdin is not ready."));
+        return;
+      }
+      sandbox.pty.sendInput(handleRef.pid, Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk))).then(() => callback(), callback);
+    }
+  });
+  const started = sandbox.pty.create({
+    cols: process.stdout.columns || 80,
+    rows: process.stdout.rows || 24,
+    cwd: spec.cwd,
+    envs: spec.env,
+    onData(data) {
+      stdout.write(Buffer.from(data));
+      if (spec.stdout === "inherit") {
+        process.stdout.write(Buffer.from(data));
+      }
+    }
+  });
+  const result = started.then((handle) => {
+    handleRef = handle;
+    return handle.wait();
+  }).then(
+    (result2) => {
+      stdout.end();
+      return { exitCode: result2.exitCode ?? 0 };
+    },
+    () => {
+      stdout.end();
+      return { exitCode: 1 };
+    }
+  );
+  return {
+    get pid() {
+      return handleRef?.pid ?? null;
+    },
+    stdin: spec.stdin === "inherit" ? process.stdin : stdin,
+    stdout: spec.stdout === "inherit" ? null : stdout,
+    stderr: null,
+    result,
+    kill() {
+      void (handleRef === null ? void 0 : sandbox.pty.kill(handleRef.pid));
+    }
+  };
+}
+async function runRemoteOrThrow(sandbox, command) {
+  const stdoutTail = createLineTail(REMOTE_COMMAND_STDERR_TAIL_SIZE);
+  const stderrTail = createLineTail(REMOTE_COMMAND_STDERR_TAIL_SIZE);
+  let result;
+  try {
+    result = await sandbox.commands.run(command, {
+      onStdout(data) {
+        stdoutTail.push(data);
+      },
+      onStderr(data) {
+        stderrTail.push(data);
+      }
+    });
+  } catch (error2) {
+    appendRemoteCommandOutput(error2, stdoutTail, stderrTail);
+    if (isCommandExitError(error2)) {
+      throw decorateRemoteCommandError(error2, command, stderrTail.values());
+    }
+    throw error2;
+  }
+  appendRemoteCommandOutput(result, stdoutTail, stderrTail);
+  if ("exitCode" in result && result.exitCode !== 0) {
+    throw decorateRemoteCommandError(
+      new Error(`E2B command failed with exit code ${result.exitCode}`),
+      command,
+      stderrTail.values()
+    );
+  }
+}
+function appendRemoteCommandOutput(source, stdoutTail, stderrTail) {
+  if (!source || typeof source !== "object") {
+    return;
+  }
+  const output = source;
+  if (typeof output.stdout === "string") {
+    stdoutTail.push(output.stdout);
+  }
+  if (typeof output.stderr === "string") {
+    stderrTail.push(output.stderr);
+  }
+}
+function decorateRemoteCommandError(error2, command, stderrTail) {
+  const original = error2 instanceof Error ? error2 : new Error(String(error2));
+  const tail = stderrTail.length === 0 ? "" : `
+
+Last stderr output:
+${stderrTail.join("\n")}`;
+  const decorated = new Error(`E2B command failed: ${command}
+${original.message}${tail}`);
+  decorated.stack = original.stack;
+  decorated.cause = original;
+  return decorated;
+}
+function createLineTail(maxLines) {
+  const lines = [];
+  let pending = "";
+  const appendLine = (line) => {
+    lines.push(trimTrailingCarriageReturn(line));
+    while (lines.length > maxLines) {
+      lines.shift();
+    }
+  };
+  return {
+    push(chunk) {
+      pending += chunk;
+      const parts = pending.split("\n");
+      pending = parts.pop() ?? "";
+      for (const line of parts) {
+        appendLine(line);
+      }
+    },
+    values() {
+      const output = [...lines];
+      if (pending.length > 0) {
+        output.push(trimTrailingCarriageReturn(pending));
+      }
+      return output.slice(-maxLines);
+    }
+  };
+}
+function trimTrailingCarriageReturn(value) {
+  return value.endsWith("\r") ? value.slice(0, -1) : value;
+}
+async function runOrThrow2(runner, spec) {
+  const handle = runner.exec(spec);
+  const stderr = readableToString(handle.stderr);
+  const result = await handle.result;
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `Command failed with exit code ${result.exitCode}: ${spec.command} ${(spec.args ?? []).join(" ")}
+${await stderr}`
+    );
+  }
+}
+function shellCommand(argv) {
+  return argv.map(shellQuote4).join(" ");
+}
+function shellQuote4(value) {
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function createUploadWorkspaceCommand(sandboxWorkspaceDir) {
+  const quotedWorkspaceDir = shellQuote4(sandboxWorkspaceDir);
+  return [
+    `mkdir -p ${quotedWorkspaceDir} || { command -v sudo >/dev/null 2>&1 && sudo mkdir -p ${quotedWorkspaceDir} && sudo chown "$(id -u):$(id -g)" ${quotedWorkspaceDir}; }`,
+    `test -w ${quotedWorkspaceDir} && tar -xf /tmp/poe-workspace-upload.tar -C ${quotedWorkspaceDir}`
+  ].join("\n");
+}
+function resolveSandboxCommandEnv(env) {
+  if (env === void 0) {
+    return void 0;
   }
   return {
-    args: modeConfig.args ?? [],
-    env: modeConfig.env && Object.keys(modeConfig.env).length > 0 ? modeConfig.env : void 0
+    ...env,
+    HOME: "/home/user"
   };
 }
-
-// packages/agent-defs/src/agents/claude-code.ts
-var claudeCodeAgent = {
-  id: "claude-code",
-  name: "claude-code",
-  label: "Claude Code",
-  summary: "Configure Claude Code to route through Poe.",
-  aliases: ["claude"],
-  binaryName: "claude",
-  configPath: "~/.claude/settings.json",
-  branding: {
-    colors: {
-      dark: "#C15F3C",
-      light: "#C15F3C"
-    }
+function normalizeSandboxWorkspaceDir(workspaceDir) {
+  const resolvedWorkspaceDir = workspaceDir ?? "/workspace";
+  if (!path29.posix.isAbsolute(resolvedWorkspaceDir)) {
+    throw new Error("E2B runtime workspace_dir must be an absolute sandbox path.");
   }
-};
-
-// packages/agent-defs/src/agents/claude-desktop.ts
-var claudeDesktopAgent = {
-  id: "claude-desktop",
-  name: "claude-desktop",
-  label: "Claude Desktop",
-  summary: "Anthropic's official desktop application for Claude",
-  configPath: "~/.claude/settings.json",
-  branding: {
-    colors: {
-      dark: "#D97757",
-      light: "#D97757"
-    }
+  let normalized = path29.posix.normalize(resolvedWorkspaceDir);
+  while (normalized.length > 1 && normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
   }
-};
+  return normalized;
+}
+function isExitError(error2) {
+  return Boolean(
+    error2 && typeof error2 === "object" && typeof error2.exitCode === "number"
+  );
+}
+function isCommandExitError(error2) {
+  return isExitError(error2) || Boolean(
+    error2 && typeof error2 === "object" && error2.name === "CommandExitError"
+  );
+}
 
-// packages/agent-defs/src/agents/codex.ts
-var codexAgent = {
-  id: "codex",
-  name: "codex",
-  label: "Codex",
-  summary: "Configure Codex to use Poe as the model provider.",
-  binaryName: "codex",
-  configPath: "~/.codex/config.toml",
-  branding: {
-    colors: {
-      dark: "#D5D9DF",
-      light: "#7A7F86"
-    }
+// packages/runner-e2b/src/auth-scope.ts
+import os4 from "node:os";
+import { promises as nodeFs4 } from "node:fs";
+var e2bAuthScope = defineScope("e2b", {
+  api_key: {
+    type: "string",
+    default: "",
+    doc: "E2B API key",
+    env: "E2B_API_KEY"
   }
-};
-
-// packages/agent-defs/src/agents/opencode.ts
-var openCodeAgent = {
-  id: "opencode",
-  name: "opencode",
-  label: "OpenCode CLI",
-  summary: "Configure OpenCode CLI to use the Poe API.",
-  binaryName: "opencode",
-  configPath: "~/.config/opencode/config.json",
-  branding: {
-    colors: {
-      dark: "#4A4F55",
-      light: "#2F3338"
-    }
+});
+async function resolveE2bApiKey(input) {
+  const homeDir = input.homeDir ?? os4.homedir();
+  const fs14 = input.fs ?? nodeFs4;
+  const env = input.env ?? process.env;
+  const document = await readMergedDocument(
+    fs14,
+    resolveConfigPath(homeDir),
+    resolveProjectConfigPath(input.cwd)
+  );
+  const resolved = resolveScope(e2bAuthScope.schema, document.e2b, env);
+  if (resolved.api_key.length === 0) {
+    throw new Error(
+      "No E2B API key. Set E2B_API_KEY or e2b.api_key in ~/.poe-code/config.json."
+    );
   }
-};
-
-// packages/agent-defs/src/agents/kimi.ts
-var kimiAgent = {
-  id: "kimi",
-  name: "kimi",
-  label: "Kimi",
-  summary: "Configure Kimi CLI to use Poe API",
-  aliases: ["kimi-cli"],
-  binaryName: "kimi",
-  configPath: "~/.kimi/config.toml",
-  branding: {
-    colors: {
-      dark: "#7B68EE",
-      light: "#6A5ACD"
-    }
+  return resolved.api_key;
+}
+
+// packages/runner-e2b/src/factory.ts
+var e2bExecutionEnvFactory = {
+  type: "e2b",
+  supportsDetach: true,
+  async open(spec) {
+    const runtime = parseE2bRuntime(spec.runtime);
+    const runtimeCwd = spec.runtimeCwd ?? spec.cwd;
+    const apiKey = await resolveE2bApiKey({ cwd: runtimeCwd });
+    const templateId = runtime.template_id ?? (await buildE2bRuntimeTemplate({
+      runtime,
+      dockerfilePath: path30.resolve(
+        runtimeCwd,
+        runtime.dockerfile ?? path30.join(".poe-code", "Dockerfile")
+      ),
+      buildContext: path30.resolve(runtimeCwd, runtime.build_context ?? "."),
+      state: spec.state,
+      apiKey
+    })).templateId;
+    const sandbox = await createSandbox({
+      apiKey,
+      templateId,
+      env: spec.env,
+      timeoutMinutes: runtime.timeout_minutes
+    });
+    return createOpenedE2bEnv({ sandbox, spec, runtime });
+  },
+  async attach(envId, context) {
+    const cwd = context?.cwd ?? process.cwd();
+    const apiKey = await resolveE2bApiKey({ cwd });
+    const sandbox = await connectSandbox(envId, apiKey);
+    return createOpenedE2bEnv({
+      sandbox,
+      spec: {
+        cwd: context?.cwd ?? "/workspace",
+        runtime: {
+          type: "e2b",
+          build_args: {},
+          mounts: [],
+          workspace_dir: "/workspace",
+          preserve_after_exit_hours: 24
+        },
+        env: {},
+        uploadIgnoreFiles: [],
+        jobLabel: { tool: context?.tool ?? "e2b", argv: context?.argv ?? [] },
+        ...context?.jobId ? { detachedJobId: context.jobId } : {}
+      },
+      runtime: {
+        type: "e2b",
+        build_args: {},
+        mounts: [],
+        workspace_dir: "/workspace",
+        preserve_after_exit_hours: 24
+      }
+    });
   }
 };
-
-// packages/agent-defs/src/agents/goose.ts
-var gooseAgent = {
-  id: "goose",
-  name: "goose",
-  label: "Goose",
-  summary: "Block's open-source AI agent with ACP support.",
-  binaryName: "goose",
-  configPath: "~/.config/goose/config.yaml",
-  branding: {
-    colors: {
-      dark: "#FF6B35",
-      light: "#E85D26"
-    }
+function parseE2bRuntime(runtime) {
+  if (!runtime || typeof runtime !== "object" || Array.isArray(runtime)) {
+    throw new Error("e2b runtime must be an object");
   }
-};
-
-// packages/agent-defs/src/agents/poe-agent.ts
-var poeAgentAgent = {
-  id: "poe-agent",
-  name: "poe-agent",
-  label: "Poe Agent",
-  summary: "Run one-shot prompts with the built-in Poe agent runtime.",
-  configPath: "~/.poe-code/config.json",
-  branding: {
-    colors: {
-      dark: "#A465F7",
-      light: "#7A3FD3"
-    }
+  const record = runtime;
+  if (record.type !== "e2b") {
+    throw new Error('e2b runtime type must be "e2b"');
   }
-};
+  return record;
+}
 
-// packages/agent-defs/src/registry.ts
-var allAgents = [
-  claudeCodeAgent,
-  claudeDesktopAgent,
-  codexAgent,
-  openCodeAgent,
-  kimiAgent,
-  gooseAgent,
-  poeAgentAgent
-];
-var lookup = /* @__PURE__ */ new Map();
-for (const agent of allAgents) {
-  const values = [agent.id, agent.name, ...agent.aliases ?? []];
-  for (const value of values) {
-    const normalized = value.toLowerCase();
-    if (!lookup.has(normalized)) {
-      lookup.set(normalized, agent.id);
+// packages/runner-e2b/src/index.ts
+var e2bExecutionEnvFactory2 = e2bExecutionEnvFactory;
+
+// packages/agent-spawn/src/register-factories.ts
+registerExecutionEnvFactory(hostExecutionEnvFactory);
+registerExecutionEnvFactory(dockerExecutionEnvFactory);
+registerExecutionEnvFactory(e2bExecutionEnvFactory2);
+if (isVitest()) {
+  registerExecutionEnvFactory(createTestHostExecutionEnvFactory());
+}
+function isVitest() {
+  return process.env.VITEST !== void 0 || process.env.VITEST_POOL_ID !== void 0;
+}
+function createTestHostExecutionEnvFactory() {
+  return {
+    type: "host",
+    supportsDetach: false,
+    open: ((openSpec) => {
+      return {
+        id: "host",
+        job: null,
+        async uploadWorkspace() {
+          return { files: 0, bytes: 0, skipped: [] };
+        },
+        async downloadWorkspace() {
+          return { files: 0, bytes: 0, conflicts: [] };
+        },
+        exec(spec) {
+          return runHost(spawnChildProcess2, spec);
+        },
+        async detach() {
+          throw new Error(
+            "host runtime does not support detach because host has no addressable env"
+          );
+        },
+        shell() {
+          return runHost(spawnChildProcess2, {
+            command: openSpec.shellSpec?.command ?? openSpec.env.SHELL ?? process.env.SHELL ?? "sh",
+            args: openSpec.shellSpec?.args,
+            cwd: openSpec.cwd,
+            env: openSpec.shellSpec && "env" in openSpec.shellSpec ? openSpec.shellSpec.env : openSpec.env,
+            stdin: "inherit",
+            stdout: "inherit",
+            stderr: "inherit",
+            tty: true
+          });
+        },
+        async close() {
+        }
+      };
+    }),
+    async attach() {
+      throw new Error("host runtime does not support reattach");
     }
+  };
+}
+function runHost(spawnProcess, spec) {
+  const stdin = spec.stdin ?? "ignore";
+  const stdout = spec.stdout ?? "pipe";
+  const stderr = spec.stderr ?? "pipe";
+  const stdio = stdin === "inherit" && stdout === "inherit" && stderr === "inherit" ? "inherit" : [stdin, stdout, stderr];
+  const child = spawnProcess(spec.command, spec.args ?? [], {
+    cwd: spec.cwd,
+    env: spec.env,
+    stdio
+  });
+  const result = new Promise((resolve2) => {
+    child.once("close", (code) => {
+      resolve2({ exitCode: code ?? 1 });
+    });
+    child.once("error", () => {
+      resolve2({ exitCode: 1 });
+    });
+  });
+  const kill = (signal) => {
+    child.kill(signal);
+  };
+  if (spec.signal?.aborted) {
+    kill("SIGTERM");
+  } else {
+    spec.signal?.addEventListener("abort", () => kill("SIGTERM"), { once: true });
   }
+  return {
+    pid: child.pid ?? null,
+    stdin: child.stdin,
+    stdout: child.stdout,
+    stderr: child.stderr,
+    result,
+    kill
+  };
 }
-function resolveAgentId(input) {
-  if (!input) {
-    return void 0;
+
+// packages/agent-spawn/src/run-command.ts
+import { spawn as spawn2 } from "node:child_process";
+
+// packages/agent-spawn/src/types.ts
+function resolveModeConfig(modeConfig) {
+  if (Array.isArray(modeConfig)) {
+    return { args: modeConfig };
   }
-  return lookup.get(input.toLowerCase());
+  return {
+    args: modeConfig.args ?? [],
+    env: modeConfig.env && Object.keys(modeConfig.env).length > 0 ? modeConfig.env : void 0
+  };
 }
 
 // packages/agent-spawn/src/configs/mcp.ts
@@ -3650,9 +6701,8 @@ function listMcpSupportedAgents() {
 }
 
 // packages/agent-spawn/src/spawn.ts
-import { spawn as spawnChildProcess } from "node:child_process";
 import { mkdirSync, openSync, writeSync, closeSync } from "node:fs";
-import path22 from "node:path";
+import path31 from "node:path";
 
 // packages/agent-spawn/src/configs/resolve-config.ts
 function resolveConfig(agentId) {
@@ -3702,18 +6752,11 @@ function stripModelNamespace(model) {
 }
 
 // packages/agent-spawn/src/spawn.ts
-function createAbortError() {
+function createAbortError3() {
   const error2 = new Error("Agent spawn aborted");
   error2.name = "AbortError";
   return error2;
 }
-function createActivityTimeoutError(timeoutMs) {
-  const error2 = new Error(
-    `Agent spawn timed out after ${timeoutMs / 1e3}s of inactivity`
-  );
-  error2.name = "ActivityTimeoutError";
-  return error2;
-}
 function resolveCliConfig(agentId) {
   const resolved = resolveConfig(agentId);
   if (!resolved.spawnConfig) {
@@ -3781,9 +6824,9 @@ function buildCliArgs(config, options, stdinMode) {
   }
   return { args, env: mode.env };
 }
-async function spawn2(agentId, options, context) {
+async function spawn3(agentId, options, context) {
   if (options.signal?.aborted) {
-    throw createAbortError();
+    throw createAbortError3();
   }
   const { agentId: resolvedId, binaryName, spawnConfig } = resolveCliConfig(agentId);
   const stdinMode = options.useStdin && spawnConfig.stdinMode ? spawnConfig.stdinMode : void 0;
@@ -3795,89 +6838,71 @@ async function spawn2(agentId, options, context) {
   }
   const logFilePath = resolveSpawnLogPath(options);
   const logFd = logFilePath ? openSpawnLog(logFilePath) : void 0;
-  const child = spawnChildProcess(binaryName, spawnArgs, {
-    cwd: options.cwd,
-    stdio: [stdinMode ? "pipe" : "inherit", "pipe", "pipe"],
-    ...modeEnv ? { env: { ...process.env, ...modeEnv } } : {}
-  });
-  if (!child.stdout || !child.stderr) {
-    throw new Error(`Failed to spawn "${resolvedId}": missing stdio pipes.`);
-  }
-  const stdoutStream = child.stdout;
-  const stderrStream = child.stderr;
-  if (stdinMode) {
-    if (!child.stdin) {
-      throw new Error(`Failed to spawn "${resolvedId}": missing stdin pipe.`);
-    }
-    child.stdin.setDefaultEncoding("utf8");
-    child.stdin.write(options.prompt);
-    child.stdin.end();
-  }
-  return new Promise((resolve2, reject) => {
-    let stdout = "";
-    let stderr = "";
-    let aborted = false;
-    let timedOut = false;
-    const onAbort = () => {
-      aborted = true;
-      child.kill("SIGTERM");
-    };
-    options.signal?.addEventListener("abort", onAbort, { once: true });
-    let activityTimer;
-    const resetActivityTimer = options.activityTimeoutMs ? () => {
-      if (activityTimer) clearTimeout(activityTimer);
-      activityTimer = setTimeout(() => {
-        timedOut = true;
-        child.kill("SIGTERM");
-      }, options.activityTimeoutMs);
-    } : void 0;
-    resetActivityTimer?.();
-    const cleanup = () => {
-      options.signal?.removeEventListener("abort", onAbort);
-      if (activityTimer) clearTimeout(activityTimer);
-    };
-    stdoutStream.setEncoding("utf8");
-    stdoutStream.on("data", (chunk) => {
-      stdout += chunk;
-      resetActivityTimer?.();
-      if (options.tee?.stdout) options.tee.stdout.write(chunk);
-      appendSpawnLog(logFd, chunk);
-    });
-    stderrStream.setEncoding("utf8");
-    stderrStream.on("data", (chunk) => {
-      stderr += chunk;
-      resetActivityTimer?.();
-      if (options.tee?.stderr) options.tee.stderr.write(chunk);
-      appendSpawnLog(logFd, chunk);
-    });
-    child.on("error", (error2) => {
-      cleanup();
-      closeSpawnLog(logFd);
-      if (aborted) {
-        reject(createAbortError());
-        return;
+  const processEnv = modeEnv ? { ...process.env, ...modeEnv } : void 0;
+  const argv = [binaryName, ...spawnArgs];
+  const execution = resolvePoeCommandExecution({
+    cwd: options.cwd ?? process.cwd(),
+    runtimeConfigCwd: options.runtimeConfigCwd,
+    env: processEnv ?? process.env,
+    argv,
+    tool: resolvedId,
+    runtime: {
+      runtime: options.runtime,
+      runtimeImage: options.runtimeImage,
+      runtimeTemplate: options.runtimeTemplate,
+      detach: options.detach,
+      mountPoeCode: options.mountPoeCode,
+      runnerSync: options.runnerSync
+    },
+    context,
+    openSpec: {
+      execution: {
+        wrapForLogTee: false,
+        stdin: stdinMode ? "pipe" : "inherit",
+        stdout: "pipe",
+        stderr: "pipe",
+        env: processEnv,
+        input: stdinMode ? options.prompt : void 0,
+        captureOutput: true,
+        activityTimeoutMs: options.activityTimeoutMs,
+        onStdout(chunk) {
+          options.tee?.stdout?.write(chunk);
+          appendSpawnLog(logFd, chunk);
+        },
+        onStderr(chunk) {
+          options.tee?.stderr?.write(chunk);
+          appendSpawnLog(logFd, chunk);
+        }
       }
-      reject(error2);
+    }
+  });
+  try {
+    const result = await runPoeCommand({
+      factory: execution.factory,
+      openSpec: execution.openSpec,
+      detach: execution.detach,
+      state: execution.state,
+      signal: options.signal
     });
-    child.on("close", (code) => {
-      cleanup();
-      closeSpawnLog(logFd);
-      if (aborted) {
-        reject(createAbortError());
-        return;
-      }
-      if (timedOut) {
-        reject(createActivityTimeoutError(options.activityTimeoutMs));
-        return;
-      }
-      resolve2({
-        stdout,
-        stderr,
-        exitCode: code ?? 1,
+    if (result.kind === "detached") {
+      return {
+        stdout: "",
+        stderr: "",
+        exitCode: 0,
+        detached: { jobId: result.jobId, envId: result.envId },
         ...logFilePath ? { logFile: logFilePath } : {}
-      });
-    });
-  });
+      };
+    }
+    const captured = result;
+    return {
+      stdout: captured.stdout ?? "",
+      stderr: captured.stderr ?? "",
+      exitCode: result.exitCode,
+      ...logFilePath ? { logFile: logFilePath } : {}
+    };
+  } finally {
+    closeSpawnLog(logFd);
+  }
 }
 function resolveSpawnLogPath(options) {
   if (options.logPath) {
@@ -3886,11 +6911,11 @@ function resolveSpawnLogPath(options) {
   if (!options.logDir || !options.logFileName) {
     return void 0;
   }
-  return path22.join(options.logDir, options.logFileName);
+  return path31.join(options.logDir, options.logFileName);
 }
 function openSpawnLog(filePath) {
   try {
-    mkdirSync(path22.dirname(filePath), { recursive: true });
+    mkdirSync(path31.dirname(filePath), { recursive: true });
     return openSync(filePath, "a");
   } catch {
     return void 0;
@@ -3911,9 +6936,6 @@ function closeSpawnLog(fd) {
   }
 }
 
-// packages/agent-spawn/src/spawn-interactive.ts
-import { spawn as spawnChildProcess2 } from "node:child_process";
-
 // packages/design-system/src/tokens/colors.ts
 import chalk from "chalk";
 var dark = {
@@ -4289,7 +7311,7 @@ import chalk8 from "chalk";
 
 // packages/design-system/src/dashboard/terminal.ts
 import readline from "node:readline";
-import { PassThrough } from "node:stream";
+import { PassThrough as PassThrough2 } from "node:stream";
 
 // packages/design-system/src/prompts/index.ts
 import chalk15 from "chalk";
@@ -4321,9 +7343,9 @@ import chalk16 from "chalk";
 var DEFAULT_ACTIVITY_TIMEOUT_MS = 10 * 60 * 1e3;
 
 // packages/agent-spawn/src/acp/replay.ts
-import path23 from "node:path";
+import path32 from "node:path";
 import { homedir as homedir2 } from "node:os";
-import { open as open2, readdir as readdir4 } from "node:fs/promises";
+import { open as open2, readdir as readdir5 } from "node:fs/promises";
 import { createInterface } from "node:readline";
 
 // packages/poe-acp-client/src/acp-client.ts
@@ -4339,17 +7361,14 @@ import * as fsPromises3 from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-// packages/agent-spawn/src/acp/spawn.ts
-import { spawn as spawnChildProcess4 } from "node:child_process";
-
 // packages/agent-spawn/src/acp/middlewares/spawn-log.ts
-import path24 from "node:path";
+import path33 from "node:path";
 import { homedir as homedir3 } from "node:os";
 import { mkdir as mkdir5, open as open3 } from "node:fs/promises";
 
 // packages/memory/src/tokens.ts
 import * as fs10 from "node:fs/promises";
-import path25 from "node:path";
+import path34 from "node:path";
 
 // packages/tokenfill/dist/tokenizer.js
 import { get_encoding } from "tiktoken";
@@ -4390,7 +7409,7 @@ function countTokens(text4) {
 }
 
 // packages/tokenfill/dist/corpus.js
-import { readdirSync, readFileSync } from "node:fs";
+import { readdirSync, readFileSync as readFileSync2 } from "node:fs";
 import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 var CORPUS_ARTICLE_SEPARATOR = "\n\n";
@@ -4403,7 +7422,7 @@ function loadBuiltInCorpusArticles() {
   if (corpusFileNames.length === 0) {
     throw new Error(`No built-in corpus markdown files found in ${corpusDirectoryPath}`);
   }
-  return corpusFileNames.map((fileName) => readFileSync(join2(corpusDirectoryPath, fileName), "utf8").trim());
+  return corpusFileNames.map((fileName) => readFileSync2(join2(corpusDirectoryPath, fileName), "utf8").trim());
 }
 var BUILT_IN_CORPUS_ARTICLES = loadBuiltInCorpusArticles();
 
@@ -4433,11 +7452,11 @@ async function computeTokenStats(root) {
       }
     }
   }
-  const repoRoot = path25.resolve(root, "..", "..");
+  const repoRoot = path34.resolve(root, "..", "..");
   let sourceTokens = 0;
   const missingSources = [];
   for (const sourcePath of sourcePaths) {
-    const absPath = path25.isAbsolute(sourcePath) ? sourcePath : path25.resolve(repoRoot, sourcePath);
+    const absPath = path34.isAbsolute(sourcePath) ? sourcePath : path34.resolve(repoRoot, sourcePath);
     try {
       const content = await fs10.readFile(absPath, "utf8");
       sourceTokens += countTokens(content);
@@ -4488,10 +7507,10 @@ function resolveRunners(overrides) {
 async function ingest(root, opts, runners) {
   const resolved = resolveRunners(runners);
   const source = await materializeSource(opts.source);
-  const indexMdBytes = await fs11.readFile(path26.join(root, MEMORY_INDEX_RELPATH));
+  const indexMdBytes = await fs11.readFile(path35.join(root, MEMORY_INDEX_RELPATH));
   const configOptions = {
     fs: fs11,
-    filePath: path26.join(inferRepoRoot(root), "poe-code.json")
+    filePath: path35.join(inferRepoRoot(root), "poe-code.json")
   };
   const agentId = await resolveAgent(configOptions, opts.agent ?? null) ?? opts.agent ?? "claude-code";
   const key = resolved.computeIngestKey({
@@ -4529,7 +7548,7 @@ async function ingest(root, opts, runners) {
   let timeoutError;
   try {
     const result = await runWithTimeout(
-      spawn2(agentId, { prompt }),
+      spawn3(agentId, { prompt }),
       opts.timeoutMs ?? await configuredTimeout(configOptions)
     );
     exitCode = result.exitCode;
@@ -4581,7 +7600,7 @@ async function materializeSource(source) {
   throw new Error("URL ingest not implemented yet.");
 }
 function inferRepoRoot(root) {
-  return path26.resolve(root, "..", "..");
+  return path35.resolve(root, "..", "..");
 }
 async function runWithTimeout(promise, timeoutMs) {
   return await new Promise((resolve2, reject) => {
@@ -5339,8 +8358,8 @@ function printMcpConfig() {
 }
 
 // packages/agent-skill-config/src/configs.ts
-import os3 from "node:os";
-import path27 from "node:path";
+import os5 from "node:os";
+import path36 from "node:path";
 var agentSkillConfigs = {
   "claude-code": {
     globalSkillDir: "~/.claude/skills",
@@ -5359,7 +8378,7 @@ var agentSkillConfigs = {
     localSkillDir: ".agents/skills"
   }
 };
-var supportedAgents = Object.keys(agentSkillConfigs);
+var supportedAgents2 = Object.keys(agentSkillConfigs);
 function resolveAgentSupport(input, registry = agentSkillConfigs) {
   const resolvedId = resolveAgentId(input);
   if (!resolvedId) {
@@ -5373,8 +8392,8 @@ function resolveAgentSupport(input, registry = agentSkillConfigs) {
 }
 
 // packages/agent-skill-config/src/templates.ts
-import { readFile as readFile12, stat as stat6 } from "node:fs/promises";
-import path28 from "node:path";
+import { readFile as readFile15, stat as stat6 } from "node:fs/promises";
+import path37 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // packages/agent-skill-config/src/apply.ts
@@ -5480,7 +8499,7 @@ var agentMcpConfigs = {
     shape: "goose"
   }
 };
-var supportedAgents2 = Object.keys(agentMcpConfigs);
+var supportedAgents3 = Object.keys(agentMcpConfigs);
 function resolveAgentSupport2(input, registry = agentMcpConfigs) {
   const resolvedId = resolveAgentId(input);
   if (!resolvedId) {
@@ -5507,7 +8526,7 @@ function resolveConfigPath2(config, platform) {
 }
 
 // packages/agent-mcp-config/src/apply.ts
-import path29 from "node:path";
+import path38 from "node:path";
 import { parse as parseYaml3, stringify as stringifyYaml2 } from "yaml";
 
 // packages/agent-mcp-config/src/shapes.ts
@@ -5599,7 +8618,7 @@ function getShapeTransformer(shape) {
 
 // packages/agent-mcp-config/src/apply.ts
 function getConfigDirectory(configPath) {
-  return path29.dirname(configPath);
+  return path38.dirname(configPath);
 }
 var UnsupportedAgentError2 = class extends Error {
   constructor(agentId) {
@@ -5625,9 +8644,9 @@ function expandHomePath(configPath, homeDir) {
     return homeDir;
   }
   if (configPath.startsWith("~/")) {
-    return path29.join(homeDir, configPath.slice(2));
+    return path38.join(homeDir, configPath.slice(2));
   }
-  return path29.join(homeDir, configPath.slice(1));
+  return path38.join(homeDir, configPath.slice(1));
 }
 function parseYamlDocument(content) {
   if (content.trim() === "") {
@@ -5660,7 +8679,7 @@ async function writeYamlConfig(configPath, document, options) {
     return;
   }
   const absolutePath = expandHomePath(configPath, options.homeDir);
-  const configDir = path29.dirname(absolutePath);
+  const configDir = path38.dirname(absolutePath);
   await options.fs.mkdir(configDir, { recursive: true });
   await options.fs.writeFile(absolutePath, serializeYamlDocument(document), {
     encoding: "utf8"
@@ -5838,7 +8857,7 @@ async function installMemory(options) {
 
 // packages/memory/src/query.ts
 import * as fs12 from "node:fs/promises";
-import path30 from "node:path";
+import path39 from "node:path";
 async function queryMemory(root, options) {
   const pages = await listPages(root);
   if (pages.length === 0) {
@@ -5852,11 +8871,11 @@ async function queryMemory(root, options) {
   }
   const configOptions = {
     fs: fs12,
-    filePath: path30.join(inferRepoRoot2(root), "poe-code.json")
+    filePath: path39.join(inferRepoRoot2(root), "poe-code.json")
   };
   const agentId = await resolveAgent(configOptions, options.agent ?? null) ?? options.agent ?? "claude-code";
   const context = await selectQueryContext(root, options.question, options.budget);
-  const result = await spawn2(agentId, { prompt: context.prompt });
+  const result = await spawn3(agentId, { prompt: context.prompt });
   return {
     answer: result.answer,
     citations: result.citations,
@@ -5867,7 +8886,7 @@ async function queryMemory(root, options) {
 }
 async function selectQueryContext(root, question, budget) {
   const [indexText, pages] = await Promise.all([
-    fs12.readFile(path30.join(root, MEMORY_INDEX_RELPATH), "utf8"),
+    fs12.readFile(path39.join(root, MEMORY_INDEX_RELPATH), "utf8"),
     listPages(root)
   ]);
   const indexTokens = countTokens(indexText);
@@ -5946,12 +8965,12 @@ function tokenize(text4) {
   return text4.toLowerCase().split(/[^a-z0-9]+/).filter((token) => token.length > 0);
 }
 function inferRepoRoot2(root) {
-  return path30.resolve(root, "..", "..");
+  return path39.resolve(root, "..", "..");
 }
 
 // packages/memory/src/explain.ts
 import * as fs13 from "node:fs/promises";
-import path31 from "node:path";
+import path40 from "node:path";
 async function explainPage(root, options) {
   const targetPage = await readPageIfPresent(root, options.relPath);
   if (targetPage === void 0) {
@@ -5974,10 +8993,10 @@ async function explainPage(root, options) {
   }
   const configOptions = {
     fs: fs13,
-    filePath: path31.join(inferRepoRoot3(root), "poe-code.json")
+    filePath: path40.join(inferRepoRoot3(root), "poe-code.json")
   };
   const agentId = await resolveAgent(configOptions, options.agent ?? null) ?? options.agent ?? "claude-code";
-  const response = await spawn2(agentId, { prompt });
+  const response = await spawn3(agentId, { prompt });
   return {
     answer: response.answer,
     citations: response.citations,
@@ -6023,7 +9042,7 @@ async function readPageIfPresent(root, relPath) {
   }
 }
 function inferRepoRoot3(root) {
-  return path31.resolve(root, "..", "..");
+  return path40.resolve(root, "..", "..");
 }
 
 // packages/memory/src/explain.cli.ts
@@ -6036,9 +9055,9 @@ async function runMemoryExplain(input) {
 }
 
 // packages/memory/src/handle.ts
-import path32 from "node:path";
+import path41 from "node:path";
 function openMemory(opts) {
-  if (!path32.isAbsolute(opts.root)) {
+  if (!path41.isAbsolute(opts.root)) {
     throw new Error(`openMemory: root must be absolute, got ${opts.root}`);
   }
   const root = opts.root;