poe-code 3.0.201 → 3.0.203

package/packages/superintendent/dist/commands/run.d.ts

@@ -9,6 +9,11 @@ export type RunCommandOptions = {
     homeDir: string;
     docPath?: string;
     builderAgent?: string;
+    runtime?: "host" | "docker" | "e2b";
+    runtimeImage?: string;
+    runtimeTemplate?: string;
+    detach?: boolean;
+    mountPoeCode?: boolean;
     configuredDefaultAgent?: string | null;
     planDirectory?: string;
     assumeYes?: boolean;
@@ -46,11 +51,21 @@ export declare const runCommand: import("toolcraft").Command<{
 }, import("toolcraft-schema").ObjectSchema<{
     readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
     readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+    readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
 }>, undefined, SuperintendentRunCommandResult> & {
     readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, SuperintendentRunCommandResult, ("cli" | "sdk")[], undefined>;
 };
@@ -62,11 +77,21 @@ export declare function createRunMcpCommand(runners?: RunMcpCommandRunners): imp
 }, import("toolcraft-schema").ObjectSchema<{
     readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
     readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+    readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
 }>, undefined, SuperintendentRunCommandResult> & {
     readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, SuperintendentRunCommandResult, "mcp"[], undefined>;
 };
@@ -75,11 +100,21 @@ export declare const runMcpCommand: import("toolcraft").Command<{
 }, import("toolcraft-schema").ObjectSchema<{
     readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
     readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+    readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+    readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+    readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
 }>, undefined, SuperintendentRunCommandResult> & {
     readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, SuperintendentRunCommandResult, "mcp"[], undefined>;
 };

package/packages/superintendent/dist/commands/run.js

@@ -25,6 +25,15 @@ const runParams = S.Object({
     agent: S.Optional(S.String({
         description: "Override the builder agent for this run. Precedence: --agent > plan frontmatter builder.agent."
     })),
+    runtime: S.Optional(S.Enum(["host", "docker", "e2b"], {
+        description: "Override runtime backend: host, docker, or e2b"
+    })),
+    runtimeImage: S.Optional(S.String({ description: "Override Docker runtime image" })),
+    runtimeTemplate: S.Optional(S.String({ description: "Override E2B runtime template id" })),
+    detach: S.Optional(S.Boolean({ description: "Run as a detached runtime job" })),
+    mountPoeCode: S.Optional(S.Boolean({
+        description: "Mount the local poe-code checkout into the runtime"
+    })),
     tui: S.Optional(S.Boolean({ description: "Show a live dashboard while Superintendent is running" }))
 });
 export const runCommand = defineCommand({
@@ -43,6 +52,11 @@ export const runCommand = defineCommand({
             homeDir,
             docPath: params.doc,
             ...(params.agent ? { builderAgent: params.agent } : {}),
+            ...(params.runtime ? { runtime: params.runtime } : {}),
+            ...(params.runtimeImage ? { runtimeImage: params.runtimeImage } : {}),
+            ...(params.runtimeTemplate ? { runtimeTemplate: params.runtimeTemplate } : {}),
+            ...(params.detach ? { detach: params.detach } : {}),
+            ...(params.mountPoeCode ? { mountPoeCode: params.mountPoeCode } : {}),
             configuredDefaultAgent: commandConfig.configuredDefaultAgent,
             assumeYes: process.argv.includes("--yes"),
             interactive: Boolean(process.stdin.isTTY),
@@ -95,6 +109,11 @@ export function createRunMcpCommand(runners) {
                 homeDir,
                 docPath: params.doc,
                 ...(params.agent ? { builderAgent: params.agent } : {}),
+                ...(params.runtime ? { runtime: params.runtime } : {}),
+                ...(params.runtimeImage ? { runtimeImage: params.runtimeImage } : {}),
+                ...(params.runtimeTemplate ? { runtimeTemplate: params.runtimeTemplate } : {}),
+                ...(params.detach ? { detach: params.detach } : {}),
+                ...(params.mountPoeCode ? { mountPoeCode: params.mountPoeCode } : {}),
                 configuredDefaultAgent: commandConfig.configuredDefaultAgent,
                 assumeYes: true,
                 interactive: false,
@@ -261,6 +280,13 @@ export async function runSuperintendentCommand(options) {
                     session: undefined,
                     executeAgent: options.executeAgent,
                     selectedBuilderAgent,
+                    runtime: {
+                        runtime: options.runtime,
+                        runtimeImage: options.runtimeImage,
+                        runtimeTemplate: options.runtimeTemplate,
+                        detach: options.detach,
+                        mountPoeCode: options.mountPoeCode
+                    },
                     activeStage: () => activeStage,
                     now,
                     stderr
@@ -506,6 +532,13 @@ export async function runSuperintendentCommand(options) {
                     session,
                     executeAgent: options.executeAgent,
                     selectedBuilderAgent,
+                    runtime: {
+                        runtime: options.runtime,
+                        runtimeImage: options.runtimeImage,
+                        runtimeTemplate: options.runtimeTemplate,
+                        detach: options.detach,
+                        mountPoeCode: options.mountPoeCode
+                    },
                     activeStage: () => session.activeStage,
                     now,
                     stderr
@@ -672,7 +705,12 @@ function createAgentRunner(options) {
         const onStdout = (chunk) => stdoutBuffer.push(chunk);
         const onStderr = (chunk) => stderrBuffer.push(chunk);
         try {
-            const result = await executeAgent(agent, { ...input, onStdout, onStderr });
+            const result = await executeAgent(agent, {
+                ...input,
+                ...options.runtime,
+                onStdout,
+                onStderr
+            });
             if (options.session && result.usage) {
                 options.session.tokensIn += result.usage.inputTokens;
                 options.session.tokensOut += result.usage.outputTokens;
@@ -738,6 +776,11 @@ async function executeSpawnAgent(agent, input) {
         ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
         ...(input.signal ? { signal: input.signal } : {}),
         ...(input.logPath ? { logPath: input.logPath } : {}),
+        ...(input.runtime ? { runtime: input.runtime } : {}),
+        ...(input.runtimeImage ? { runtimeImage: input.runtimeImage } : {}),
+        ...(input.runtimeTemplate ? { runtimeTemplate: input.runtimeTemplate } : {}),
+        ...(input.detach ? { detach: input.detach } : {}),
+        ...(input.mountPoeCode ? { mountPoeCode: input.mountPoeCode } : {}),
         ...(tee ? { tee } : {})
     });
     return {
@@ -764,6 +807,11 @@ async function executeSpawnAgentStreaming(agent, input) {
         ...(input.mode ? { mode: input.mode } : {}),
         ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
         ...(input.signal ? { signal: input.signal } : {}),
+        ...(input.runtime ? { runtime: input.runtime } : {}),
+        ...(input.runtimeImage ? { runtimeImage: input.runtimeImage } : {}),
+        ...(input.runtimeTemplate ? { runtimeTemplate: input.runtimeTemplate } : {}),
+        ...(input.detach ? { detach: input.detach } : {}),
+        ...(input.mountPoeCode ? { mountPoeCode: input.mountPoeCode } : {}),
         ...(input.onStderr ? { tee: { stderr: { write: input.onStderr } } } : {})
     });
     const middlewareContext = {

package/packages/superintendent/dist/commands/superintendent-group.d.ts

@@ -122,11 +122,21 @@ export declare const superintendentGroup: import("toolcraft").Group<{
     }, import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
         readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
             readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
             readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+            readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+            readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
             readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         }>, import("./run.js").SuperintendentRunCommandResult, ("cli" | "sdk")[], undefined>;
     }) | (import("toolcraft").Command<{
@@ -214,11 +224,21 @@ export declare function createSuperintendentMcpGroup(runners?: SuperintendentMcp
     }, import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
         readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
             readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
             readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+            readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+            readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
             readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         }>, import("./run.js").SuperintendentRunCommandResult, "mcp"[], undefined>;
     }) | (import("toolcraft").Command<{
@@ -305,11 +325,21 @@ export declare const superintendentMcpGroup: import("toolcraft").Group<{
     }, import("toolcraft-schema").ObjectSchema<{
         readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
         readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+        readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+        readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+        readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
     }>, undefined, import("./run.js").SuperintendentRunCommandResult> & {
         readonly __agentKitCommandTypeInfo: import("toolcraft").CommandTypeInfo<"run", import("toolcraft-schema").ObjectSchema<{
             readonly doc: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
             readonly agent: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtime: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").EnumSchema<readonly ["host", "docker", "e2b"]>>;
+            readonly runtimeImage: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly runtimeTemplate: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").StringSchema>;
+            readonly detach: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
+            readonly mountPoeCode: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
             readonly tui: import("toolcraft-schema").OptionalSchema<import("toolcraft-schema").BooleanSchema>;
         }>, import("./run.js").SuperintendentRunCommandResult, "mcp"[], undefined>;
     }) | (import("toolcraft").Command<{

package/packages/superintendent/dist/runtime/agent-runner.d.ts

@@ -0,0 +1,30 @@
+import "@poe-code/agent-spawn/register-factories";
+import { type RuntimeOverrideOptions } from "@poe-code/agent-harness-tools";
+import { type McpSpawnConfig, type SpawnMode } from "@poe-code/agent-spawn";
+export type { McpSpawnConfig, SpawnMode };
+export type AutonomousInput = {
+    agent: string;
+    mode?: string;
+    prompt: string;
+    cwd?: string;
+    mcpServers?: McpSpawnConfig;
+    logPath?: string;
+    runtime?: RuntimeOverrideOptions["runtime"];
+    runtimeImage?: string;
+    runtimeTemplate?: string;
+    detach?: boolean;
+    mountPoeCode?: boolean;
+};
+export type AutonomousOutput = string | {
+    summary?: unknown;
+    log?: unknown;
+    output?: unknown;
+    stdout?: unknown;
+    text?: unknown;
+    toolCalls?: unknown;
+    sessionResult?: unknown;
+    logFile?: unknown;
+};
+type AutonomousRunner = (agent: string, options: Omit<AutonomousInput, "agent">) => Promise<AutonomousOutput>;
+export declare function withAutonomousAgentRunner<T>(runner: AutonomousRunner, operation: () => Promise<T>): Promise<T>;
+export declare function runAutonomousAgent(input: AutonomousInput): Promise<AutonomousOutput>;

package/packages/superintendent/dist/runtime/agent-runner.js

@@ -0,0 +1,119 @@
+import "@poe-code/agent-spawn/register-factories";
+import { mkdirSync, openSync, writeSync, closeSync } from "node:fs";
+import path from "node:path";
+import { resolvePoeCommandExecution, runPoeCommand } from "@poe-code/agent-harness-tools";
+import { buildSpawnArgs } from "@poe-code/agent-spawn";
+let injectedRunner;
+export async function withAutonomousAgentRunner(runner, operation) {
+    const previous = injectedRunner;
+    injectedRunner = runner;
+    try {
+        return await operation();
+    }
+    finally {
+        injectedRunner = previous;
+    }
+}
+export async function runAutonomousAgent(input) {
+    if (injectedRunner) {
+        return injectedRunner(input.agent, {
+            cwd: input.cwd,
+            prompt: input.prompt,
+            mode: input.mode,
+            ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
+            ...(input.logPath ? { logPath: input.logPath } : {}),
+            ...(input.runtime ? { runtime: input.runtime } : {}),
+            ...(input.runtimeImage ? { runtimeImage: input.runtimeImage } : {}),
+            ...(input.runtimeTemplate ? { runtimeTemplate: input.runtimeTemplate } : {}),
+            ...(input.detach ? { detach: input.detach } : {}),
+            ...(input.mountPoeCode ? { mountPoeCode: input.mountPoeCode } : {})
+        });
+    }
+    const spawnArgs = buildSpawnArgs(input.agent, {
+        prompt: input.prompt,
+        mode: input.mode,
+        ...(input.mcpServers ? { mcpServers: input.mcpServers } : {})
+    });
+    const processEnv = spawnArgs.env ? { ...process.env, ...spawnArgs.env } : undefined;
+    const argv = [spawnArgs.binaryName, ...spawnArgs.args];
+    const logFd = input.logPath ? openSpawnLog(input.logPath) : undefined;
+    const execution = resolvePoeCommandExecution({
+        cwd: input.cwd ?? process.cwd(),
+        env: (processEnv ?? process.env),
+        argv,
+        tool: input.agent,
+        runtime: {
+            runtime: input.runtime,
+            runtimeImage: input.runtimeImage,
+            runtimeTemplate: input.runtimeTemplate,
+            detach: input.detach,
+            mountPoeCode: input.mountPoeCode
+        },
+        openSpec: {
+            execution: {
+                wrapForLogTee: false,
+                stdin: "inherit",
+                stdout: "pipe",
+                stderr: "pipe",
+                env: processEnv,
+                captureOutput: true,
+                onStdout(chunk) {
+                    appendSpawnLog(logFd, chunk);
+                },
+                onStderr(chunk) {
+                    appendSpawnLog(logFd, chunk);
+                }
+            }
+        }
+    });
+    try {
+        const result = await runPoeCommand({
+            factory: execution.factory,
+            openSpec: execution.openSpec,
+            detach: execution.detach,
+            state: execution.state
+        });
+        if (result.kind === "detached") {
+            return {
+                stdout: "",
+                ...(input.logPath ? { logFile: input.logPath } : {})
+            };
+        }
+        return {
+            stdout: result.stdout ?? "",
+            ...(input.logPath ? { logFile: input.logPath } : {})
+        };
+    }
+    finally {
+        closeSpawnLog(logFd);
+    }
+}
+function openSpawnLog(filePath) {
+    try {
+        mkdirSync(path.dirname(filePath), { recursive: true });
+        return openSync(filePath, "a");
+    }
+    catch {
+        return undefined;
+    }
+}
+function appendSpawnLog(fd, chunk) {
+    if (fd === undefined)
+        return;
+    try {
+        writeSync(fd, chunk);
+    }
+    catch {
+        // logging is best-effort
+    }
+}
+function closeSpawnLog(fd) {
+    if (fd === undefined)
+        return;
+    try {
+        closeSync(fd);
+    }
+    catch {
+        // logging is best-effort
+    }
+}

package/packages/superintendent/dist/runtime/loop.d.ts

@@ -1,5 +1,5 @@
-import { type McpSpawnConfig } from "@poe-code/agent-spawn";
 import { type LoopState } from "../state/machine.js";
+import { type McpSpawnConfig } from "./agent-runner.js";
 import { runBuilder, type BuilderResult } from "./run-builder.js";
 import { runInspector, type InspectorResult } from "./run-inspector.js";
 import { runOwnerReview, type OwnerResult } from "./run-owner-review.js";
@@ -32,6 +32,11 @@ export interface AgentRunInput {
     cwd: string;
     mode?: string;
     mcpServers?: McpSpawnConfig;
+    runtime?: "host" | "docker" | "e2b";
+    runtimeImage?: string;
+    runtimeTemplate?: string;
+    detach?: boolean;
+    mountPoeCode?: boolean;
     signal?: AbortSignal;
     logPath?: string;
     onStdout?: (chunk: string) => void;

package/packages/superintendent/dist/runtime/loop.js

@@ -1,11 +1,11 @@
 import path from "node:path";
 import * as fsPromises from "node:fs/promises";
 import { lockWorkflow, makeRunLogFileName, resolveWorkflowPath } from "@poe-code/agent-harness-tools";
-import { spawn } from "@poe-code/agent-spawn";
 import { parseSuperintendentDoc } from "../document/parse.js";
 import { parseTaskBoard } from "../document/tasks.js";
 import { updateStatus } from "../document/write.js";
 import { createLoopState } from "../state/machine.js";
+import { withAutonomousAgentRunner } from "./agent-runner.js";
 import { runBuilder } from "./run-builder.js";
 import { runInspector } from "./run-inspector.js";
 import { runOwnerReview } from "./run-owner-review.js";
@@ -417,9 +417,7 @@ async function withInjectedAgentRunner(options, operation) {
     if (!options.runAgent) {
         return operation();
     }
-    const spawnApi = spawn;
-    const originalAutonomous = spawnApi.autonomous;
-    spawnApi.autonomous = async (agent, input) => {
+    return withAutonomousAgentRunner(async (agent, input) => {
         const result = await options.runAgent?.({
             agent,
             prompt: input.prompt,
@@ -436,11 +434,5 @@ async function withInjectedAgentRunner(options, operation) {
             throw new Error(result.stderr || result.stdout || `Agent \`${agent}\` failed with exit code ${result.exitCode}`);
         }
         return result;
-    };
-    try {
-        return await operation();
-    }
-    finally {
-        spawnApi.autonomous = originalAutonomous;
-    }
+    }, operation);
 }

package/packages/superintendent/dist/runtime/run-builder.d.ts

@@ -1,3 +1,4 @@
+import "@poe-code/agent-spawn/register-factories";
 import type { SuperintendentDoc } from "../document/parse.js";
 import { type TemplateContext } from "./templates.js";
 export type BuilderResult = {

package/packages/superintendent/dist/runtime/run-builder.js

@@ -1,10 +1,11 @@
-import { spawn } from "@poe-code/agent-spawn";
+import "@poe-code/agent-spawn/register-factories";
+import { runAutonomousAgent } from "./agent-runner.js";
 import { resolveRoleCwd } from "./resolve-cwd.js";
 import { resolveTemplate } from "./templates.js";
 export async function runBuilder(doc, context, options) {
     const prompt = options.promptOverride ??
         resolveTemplate(doc.frontmatter.builder.prompt, buildTemplateContext(doc, context));
-    const result = await runAutonomous({
+    const result = await runAutonomousAgent({
         agent: doc.frontmatter.builder.agent,
         mode: doc.frontmatter.builder.mode,
         prompt,
@@ -46,29 +47,6 @@ function buildTemplateContext(doc, context) {
         }
     };
 }
-async function runAutonomous(input) {
-    const spawnApi = spawn;
-    if (typeof spawnApi.autonomous === "function") {
-        return spawnApi.autonomous(input.agent, {
-            cwd: input.cwd,
-            prompt: input.prompt,
-            mode: input.mode,
-            ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-            ...(input.logPath ? { logPath: input.logPath } : {})
-        });
-    }
-    const result = await spawn(input.agent, {
-        cwd: input.cwd,
-        prompt: input.prompt,
-        mode: input.mode,
-        ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-        ...(input.logPath ? { logPath: input.logPath } : {})
-    });
-    return {
-        stdout: result.stdout,
-        ...(result.logFile ? { logFile: result.logFile } : {})
-    };
-}
 function extractLog(result) {
     if (typeof result === "string") {
         return result;

package/packages/superintendent/dist/runtime/run-inspector.d.ts

@@ -1,3 +1,4 @@
+import "@poe-code/agent-spawn/register-factories";
 import type { AgentRoleConfig, SuperintendentDoc } from "../document/parse.js";
 import { type TemplateContext } from "./templates.js";
 export type InspectorResult = {

package/packages/superintendent/dist/runtime/run-inspector.js

@@ -1,4 +1,5 @@
-import { spawn } from "@poe-code/agent-spawn";
+import "@poe-code/agent-spawn/register-factories";
+import { runAutonomousAgent } from "./agent-runner.js";
 import { resolveRoleCwd } from "./resolve-cwd.js";
 import { buildInspectorSystemPrompt, prependSystemPrompt } from "./system-prompt.js";
 import { resolveTemplate } from "./templates.js";
@@ -17,7 +18,7 @@ export async function runInspector(name, config, doc, context, options) {
             : {})
     });
     const prompt = prependSystemPrompt(systemPrompt, userPrompt);
-    const output = await runAutonomous({
+    const output = await runAutonomousAgent({
         agent: config.agent,
         mode: config.mode,
         prompt,
@@ -76,29 +77,6 @@ function buildTemplateContext(doc, context) {
         }
     };
 }
-async function runAutonomous(input) {
-    const spawnApi = spawn;
-    if (typeof spawnApi.autonomous === "function") {
-        return spawnApi.autonomous(input.agent, {
-            cwd: input.cwd,
-            prompt: input.prompt,
-            mode: input.mode,
-            ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-            ...(input.logPath ? { logPath: input.logPath } : {})
-        });
-    }
-    const result = await spawn(input.agent, {
-        cwd: input.cwd,
-        prompt: input.prompt,
-        mode: input.mode,
-        ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-        ...(input.logPath ? { logPath: input.logPath } : {})
-    });
-    return {
-        stdout: result.stdout,
-        ...(result.logFile ? { logFile: result.logFile } : {})
-    };
-}
 function extractLogPath(result) {
     if (typeof result === "string")
         return undefined;

package/packages/superintendent/dist/runtime/run-owner-review.d.ts

@@ -1,3 +1,4 @@
+import "@poe-code/agent-spawn/register-factories";
 import type { SuperintendentDoc } from "../document/parse.js";
 import { type TemplateContext } from "./templates.js";
 import { type WorkflowTransition } from "./workflow-tool.js";

package/packages/superintendent/dist/runtime/run-owner-review.js

@@ -1,4 +1,5 @@
-import { spawn } from "@poe-code/agent-spawn";
+import "@poe-code/agent-spawn/register-factories";
+import { runAutonomousAgent } from "./agent-runner.js";
 import { resolveRoleCwd } from "./resolve-cwd.js";
 import { buildOwnerSystemPrompt, prependSystemPrompt } from "./system-prompt.js";
 import { resolveTemplate } from "./templates.js";
@@ -10,7 +11,7 @@ const WORKFLOW_SERVER_TIMEOUT_SECONDS = 7200;
 export async function runOwnerReview(doc, context, options) {
     const userPrompt = resolveTemplate(doc.frontmatter.owner.prompt, buildTemplateContext(doc, context));
     const prompt = prependSystemPrompt(buildOwnerSystemPrompt(), userPrompt);
-    const result = await runAutonomous({
+    const result = await runAutonomousAgent({
         agent: doc.frontmatter.owner.agent,
         mode: doc.frontmatter.owner.mode,
         prompt,
@@ -55,29 +56,6 @@ function toSpawnMcpServer(config) {
         ...(config.timeout !== undefined ? { timeout: config.timeout } : {})
     };
 }
-async function runAutonomous(input) {
-    const spawnApi = spawn;
-    if (typeof spawnApi.autonomous === "function") {
-        return spawnApi.autonomous(input.agent, {
-            cwd: input.cwd,
-            prompt: input.prompt,
-            mode: input.mode,
-            ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-            ...(input.logPath ? { logPath: input.logPath } : {})
-        });
-    }
-    const result = await spawn(input.agent, {
-        cwd: input.cwd,
-        prompt: input.prompt,
-        mode: input.mode,
-        ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
-        ...(input.logPath ? { logPath: input.logPath } : {})
-    });
-    return {
-        stdout: result.stdout,
-        ...(result.logFile ? { logFile: result.logFile } : {})
-    };
-}
 function extractLogPath(result) {
     if (typeof result === "string")
         return undefined;

package/packages/superintendent/dist/runtime/run-superintendent.d.ts

@@ -1,3 +1,4 @@
+import "@poe-code/agent-spawn/register-factories";
 import type { SuperintendentDoc } from "../document/parse.js";
 import { type TemplateContext } from "./templates.js";
 import { type WorkflowTransition } from "./workflow-tool.js";