@evermore.work/adapter-utils 2026.509.0-canary.0

package/dist/execution-target-sandbox.test.js

@@ -0,0 +1,392 @@
+import { createServer } from "node:http";
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { adapterExecutionTargetSessionIdentity, adapterExecutionTargetToRemoteSpec, adapterExecutionTargetUsesEvermoreBridge, runAdapterExecutionTargetProcess, runAdapterExecutionTargetShellCommand, startAdapterExecutionTargetEvermoreBridge, } from "./execution-target.js";
+import { runChildProcess } from "./server-utils.js";
+describe("sandbox adapter execution targets", () => {
+    const cleanupDirs = [];
+    afterEach(async () => {
+        vi.unstubAllEnvs();
+        while (cleanupDirs.length > 0) {
+            const dir = cleanupDirs.pop();
+            if (!dir)
+                continue;
+            await rm(dir, { recursive: true, force: true }).catch(() => undefined);
+        }
+    });
+    function createLocalSandboxRunner() {
+        let counter = 0;
+        return {
+            execute: async (input) => {
+                counter += 1;
+                const command = input.command === "bash" ? "/bin/bash" : input.command;
+                return runChildProcess(`sandbox-run-${counter}`, command, input.args ?? [], {
+                    cwd: input.cwd ?? process.cwd(),
+                    env: input.env ?? {},
+                    stdin: input.stdin,
+                    timeoutSec: Math.max(1, Math.ceil((input.timeoutMs ?? 30_000) / 1000)),
+                    graceSec: 5,
+                    onLog: input.onLog ?? (async () => { }),
+                    onSpawn: input.onSpawn
+                        ? async (meta) => input.onSpawn?.({ pid: meta.pid, startedAt: meta.startedAt })
+                        : undefined,
+                });
+            },
+        };
+    }
+    it("executes through the provider-neutral runner without a remote spec", async () => {
+        const runner = {
+            execute: vi.fn(async () => ({
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: "ok\n",
+                stderr: "",
+                pid: null,
+                startedAt: new Date().toISOString(),
+            })),
+        };
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "acme-sandbox",
+            environmentId: "env-1",
+            leaseId: "lease-1",
+            remoteCwd: "/workspace",
+            timeoutMs: 30_000,
+            runner,
+        };
+        expect(adapterExecutionTargetToRemoteSpec(target)).toBeNull();
+        const result = await runAdapterExecutionTargetProcess("run-1", target, "agent-cli", ["--json"], {
+            cwd: "/local/workspace",
+            env: { TOKEN: "token" },
+            stdin: "prompt",
+            timeoutSec: 5,
+            graceSec: 1,
+            onLog: async () => { },
+        });
+        expect(result.stdout).toBe("ok\n");
+        expect(runner.execute).toHaveBeenCalledWith(expect.objectContaining({
+            command: "agent-cli",
+            args: ["--json"],
+            cwd: "/workspace",
+            env: { TOKEN: "token" },
+            stdin: "prompt",
+            timeoutMs: 5000,
+        }));
+        expect(adapterExecutionTargetSessionIdentity(target)).toEqual({
+            transport: "sandbox",
+            providerKey: "acme-sandbox",
+            environmentId: "env-1",
+            leaseId: "lease-1",
+            remoteCwd: "/workspace",
+        });
+    });
+    it("runs shell commands through the same runner", async () => {
+        const runner = {
+            execute: vi.fn(async () => ({
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: "/home/sandbox",
+                stderr: "",
+                pid: null,
+                startedAt: new Date().toISOString(),
+            })),
+        };
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            remoteCwd: "/workspace",
+            runner,
+        };
+        await runAdapterExecutionTargetShellCommand("run-2", target, 'printf %s "$HOME"', {
+            cwd: "/local/workspace",
+            env: {},
+            timeoutSec: 7,
+        });
+        expect(runner.execute).toHaveBeenCalledWith(expect.objectContaining({
+            command: "sh",
+            args: ["-lc", 'printf %s "$HOME"'],
+            cwd: "/workspace",
+            timeoutMs: 7000,
+        }));
+    });
+    it("strips inherited host identity env before sandbox execution", async () => {
+        vi.stubEnv("PATH", "/host/bin:/usr/bin");
+        vi.stubEnv("HOME", "/Users/local");
+        vi.stubEnv("TMPDIR", "/var/folders/local/T");
+        const runner = {
+            execute: vi.fn(async () => ({
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: "ok\n",
+                stderr: "",
+                pid: null,
+                startedAt: new Date().toISOString(),
+            })),
+        };
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            remoteCwd: "/workspace",
+            runner,
+        };
+        await runAdapterExecutionTargetProcess("run-1b", target, "agent-cli", ["--json"], {
+            cwd: "/local/workspace",
+            env: {
+                PATH: "/host/bin:/usr/bin",
+                HOME: "/Users/local",
+                TMPDIR: "/var/folders/local/T",
+                SAFE_VALUE: "visible",
+            },
+            timeoutSec: 5,
+            graceSec: 1,
+            onLog: async () => { },
+        });
+        expect(runner.execute).toHaveBeenCalledWith(expect.objectContaining({
+            env: {
+                SAFE_VALUE: "visible",
+            },
+        }));
+    });
+    it("preserves explicit remote identity env overrides for sandbox execution", async () => {
+        vi.stubEnv("PATH", "/host/bin:/usr/bin");
+        vi.stubEnv("HOME", "/Users/local");
+        const runner = {
+            execute: vi.fn(async () => ({
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: "ok\n",
+                stderr: "",
+                pid: null,
+                startedAt: new Date().toISOString(),
+            })),
+        };
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            remoteCwd: "/workspace",
+            runner,
+        };
+        await runAdapterExecutionTargetProcess("run-1c", target, "agent-cli", ["--json"], {
+            cwd: "/local/workspace",
+            env: {
+                PATH: "/custom/remote/bin:/usr/bin",
+                HOME: "/home/sandbox",
+                SAFE_VALUE: "visible",
+            },
+            timeoutSec: 5,
+            graceSec: 1,
+            onLog: async () => { },
+        });
+        expect(runner.execute).toHaveBeenCalledWith(expect.objectContaining({
+            env: {
+                PATH: "/custom/remote/bin:/usr/bin",
+                HOME: "/home/sandbox",
+                SAFE_VALUE: "visible",
+            },
+        }));
+    });
+    it("treats SSH targets as bridge-only", () => {
+        const target = {
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/workspace",
+            spec: {
+                host: "ssh.example.test",
+                port: 22,
+                username: "evermore",
+                remoteWorkspacePath: "/workspace",
+                remoteCwd: "/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        };
+        expect(adapterExecutionTargetUsesEvermoreBridge(target)).toBe(true);
+        expect(adapterExecutionTargetSessionIdentity(target)).toEqual({
+            transport: "ssh",
+            host: "ssh.example.test",
+            port: 22,
+            username: "evermore",
+            remoteCwd: "/workspace",
+        });
+    });
+    it("uses the provider-declared shell for sandbox helper commands", async () => {
+        const runner = {
+            execute: vi.fn(async () => ({
+                exitCode: 0,
+                signal: null,
+                timedOut: false,
+                stdout: "/home/sandbox",
+                stderr: "",
+                pid: null,
+                startedAt: new Date().toISOString(),
+            })),
+        };
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "custom-provider",
+            shellCommand: "bash",
+            remoteCwd: "/workspace",
+            runner,
+        };
+        await runAdapterExecutionTargetShellCommand("run-2b", target, 'printf %s "$HOME"', {
+            cwd: "/local/workspace",
+            env: {},
+            timeoutSec: 7,
+        });
+        expect(runner.execute).toHaveBeenCalledWith(expect.objectContaining({
+            command: "bash",
+            args: ["-lc", 'printf %s "$HOME"'],
+            cwd: "/workspace",
+            timeoutMs: 7000,
+        }));
+    });
+    it("starts a localhost Evermore bridge for sandbox targets in bridge mode", async () => {
+        const rootDir = await mkdtemp(path.join(os.tmpdir(), "evermore-execution-target-bridge-"));
+        cleanupDirs.push(rootDir);
+        const remoteCwd = path.join(rootDir, "workspace");
+        const runtimeRootDir = path.join(remoteCwd, ".evermore-runtime", "codex");
+        await mkdir(runtimeRootDir, { recursive: true });
+        const requests = [];
+        const apiServer = createServer((req, res) => {
+            requests.push({
+                method: req.method ?? "GET",
+                url: req.url ?? "/",
+                auth: req.headers.authorization ?? null,
+                runId: typeof req.headers["x-evermore-run-id"] === "string" ? req.headers["x-evermore-run-id"] : null,
+            });
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(JSON.stringify({ ok: true }));
+        });
+        await new Promise((resolve, reject) => {
+            apiServer.once("error", reject);
+            apiServer.listen(0, "127.0.0.1", () => resolve());
+        });
+        const address = apiServer.address();
+        if (!address || typeof address === "string") {
+            throw new Error("Expected the bridge test API server to listen on a TCP port.");
+        }
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "e2b",
+            environmentId: "env-1",
+            leaseId: "lease-1",
+            remoteCwd,
+            runner: createLocalSandboxRunner(),
+            timeoutMs: 30_000,
+        };
+        const bridge = await startAdapterExecutionTargetEvermoreBridge({
+            runId: "run-bridge",
+            target,
+            runtimeRootDir,
+            adapterKey: "codex",
+            hostApiToken: "real-run-jwt",
+            hostApiUrl: `http://127.0.0.1:${address.port}`,
+        });
+        try {
+            expect(bridge).not.toBeNull();
+            expect(bridge?.env.EVERMORE_API_URL).toMatch(/^http:\/\/127\.0\.0\.1:\d+$/);
+            expect(bridge?.env.EVERMORE_API_KEY).not.toBe("real-run-jwt");
+            expect(bridge?.env.EVERMORE_API_BRIDGE_MODE).toBe("queue_v1");
+            const response = await fetch(`${bridge.env.EVERMORE_API_URL}/api/agents/me`, {
+                headers: {
+                    authorization: `Bearer ${bridge.env.EVERMORE_API_KEY}`,
+                    accept: "application/json",
+                },
+            });
+            expect(response.status).toBe(200);
+            expect(await response.json()).toEqual({ ok: true });
+            expect(requests).toEqual([{
+                    method: "GET",
+                    url: "/api/agents/me",
+                    auth: "Bearer real-run-jwt",
+                    runId: "run-bridge",
+                }]);
+        }
+        finally {
+            await bridge?.stop();
+            await new Promise((resolve) => apiServer.close(() => resolve()));
+        }
+    });
+    it("fails oversized host responses with a 502 before returning them to the sandbox client", async () => {
+        const rootDir = await mkdtemp(path.join(os.tmpdir(), "evermore-execution-target-bridge-limit-"));
+        cleanupDirs.push(rootDir);
+        const remoteCwd = path.join(rootDir, "workspace");
+        const runtimeRootDir = path.join(remoteCwd, ".evermore-runtime", "codex");
+        await mkdir(runtimeRootDir, { recursive: true });
+        const requests = [];
+        const largeBody = "x".repeat(64);
+        const apiServer = createServer((req, res) => {
+            requests.push({
+                method: req.method ?? "GET",
+                url: req.url ?? "/",
+                auth: req.headers.authorization ?? null,
+                runId: typeof req.headers["x-evermore-run-id"] === "string" ? req.headers["x-evermore-run-id"] : null,
+            });
+            res.writeHead(200, {
+                "content-type": "application/json",
+                "content-length": String(Buffer.byteLength(largeBody, "utf8")),
+            });
+            res.end(largeBody);
+        });
+        await new Promise((resolve, reject) => {
+            apiServer.once("error", reject);
+            apiServer.listen(0, "127.0.0.1", () => resolve());
+        });
+        const address = apiServer.address();
+        if (!address || typeof address === "string") {
+            throw new Error("Expected the bridge test API server to listen on a TCP port.");
+        }
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "e2b",
+            environmentId: "env-1",
+            leaseId: "lease-1",
+            remoteCwd,
+            runner: createLocalSandboxRunner(),
+            timeoutMs: 30_000,
+        };
+        const bridge = await startAdapterExecutionTargetEvermoreBridge({
+            runId: "run-bridge-limit",
+            target,
+            runtimeRootDir,
+            adapterKey: "codex",
+            hostApiToken: "real-run-jwt",
+            hostApiUrl: `http://127.0.0.1:${address.port}`,
+            maxBodyBytes: 32,
+        });
+        try {
+            const response = await fetch(`${bridge.env.EVERMORE_API_URL}/api/agents/me`, {
+                headers: {
+                    authorization: `Bearer ${bridge.env.EVERMORE_API_KEY}`,
+                    accept: "application/json",
+                },
+            });
+            expect(response.status).toBe(502);
+            await expect(response.json()).resolves.toEqual({
+                error: "Bridge response body exceeded the configured size limit of 32 bytes.",
+            });
+            expect(requests).toEqual([{
+                    method: "GET",
+                    url: "/api/agents/me",
+                    auth: "Bearer real-run-jwt",
+                    runId: "run-bridge-limit",
+                }]);
+        }
+        finally {
+            await bridge?.stop();
+            await new Promise((resolve) => apiServer.close(() => resolve()));
+        }
+    });
+});
+//# sourceMappingURL=execution-target-sandbox.test.js.map

package/dist/execution-target-sandbox.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target-sandbox.test.js","sourceRoot":"","sources":["../src/execution-target-sandbox.test.ts"],"names":[],"mappings":"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"}

package/dist/execution-target.d.ts

@@ -0,0 +1,150 @@
+import type { SshRemoteExecutionSpec } from "./ssh.js";
+import { type CommandManagedRuntimeRunner } from "./command-managed-runtime.js";
+import { type RemoteManagedRuntimeAsset } from "./remote-managed-runtime.js";
+import { type RunProcessResult, type TerminalResultCleanupOptions } from "./server-utils.js";
+export interface AdapterLocalExecutionTarget {
+    kind: "local";
+    environmentId?: string | null;
+    leaseId?: string | null;
+}
+export interface AdapterSshExecutionTarget {
+    kind: "remote";
+    transport: "ssh";
+    environmentId?: string | null;
+    leaseId?: string | null;
+    remoteCwd: string;
+    spec: SshRemoteExecutionSpec;
+}
+export interface AdapterSandboxExecutionTarget {
+    kind: "remote";
+    transport: "sandbox";
+    providerKey?: string | null;
+    shellCommand?: "bash" | "sh" | null;
+    environmentId?: string | null;
+    leaseId?: string | null;
+    remoteCwd: string;
+    timeoutMs?: number | null;
+    runner?: CommandManagedRuntimeRunner;
+}
+export type AdapterExecutionTarget = AdapterLocalExecutionTarget | AdapterSshExecutionTarget | AdapterSandboxExecutionTarget;
+export type AdapterRemoteExecutionSpec = SshRemoteExecutionSpec;
+export type AdapterManagedRuntimeAsset = RemoteManagedRuntimeAsset;
+export interface PreparedAdapterExecutionTargetRuntime {
+    target: AdapterExecutionTarget;
+    runtimeRootDir: string | null;
+    assetDirs: Record<string, string>;
+    restoreWorkspace(): Promise<void>;
+}
+export interface AdapterExecutionTargetProcessOptions {
+    cwd: string;
+    env: Record<string, string>;
+    stdin?: string;
+    timeoutSec: number;
+    graceSec: number;
+    onLog: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    onSpawn?: (meta: {
+        pid: number;
+        processGroupId: number | null;
+        startedAt: string;
+    }) => Promise<void>;
+    terminalResultCleanup?: TerminalResultCleanupOptions;
+}
+export interface AdapterExecutionTargetShellOptions {
+    cwd: string;
+    env: Record<string, string>;
+    timeoutSec?: number;
+    graceSec?: number;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+}
+export interface AdapterExecutionTargetEvermoreBridgeHandle {
+    env: Record<string, string>;
+    stop(): Promise<void>;
+}
+export { sanitizeRemoteExecutionEnv } from "./remote-execution-env.js";
+export declare function adapterExecutionTargetToRemoteSpec(target: AdapterExecutionTarget | null | undefined): AdapterRemoteExecutionSpec | null;
+export declare function adapterExecutionTargetIsRemote(target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function adapterExecutionTargetUsesManagedHome(target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function adapterExecutionTargetRemoteCwd(target: AdapterExecutionTarget | null | undefined, localCwd: string): string;
+export declare function resolveAdapterExecutionTargetCwd(target: AdapterExecutionTarget | null | undefined, configuredCwd: string | null | undefined, localFallbackCwd: string): string;
+export declare function adapterExecutionTargetUsesEvermoreBridge(target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function describeAdapterExecutionTarget(target: AdapterExecutionTarget | null | undefined): string;
+export declare function ensureAdapterExecutionTargetCommandResolvable(command: string, target: AdapterExecutionTarget | null | undefined, cwd: string, env: NodeJS.ProcessEnv, options?: {
+    installCommand?: string | null;
+}): Promise<void>;
+export declare function resolveAdapterExecutionTargetCommandForLogs(command: string, target: AdapterExecutionTarget | null | undefined, cwd: string, env: NodeJS.ProcessEnv): Promise<string>;
+export declare function runAdapterExecutionTargetProcess(runId: string, target: AdapterExecutionTarget | null | undefined, command: string, args: string[], options: AdapterExecutionTargetProcessOptions): Promise<RunProcessResult>;
+export declare function runAdapterExecutionTargetShellCommand(runId: string, target: AdapterExecutionTarget | null | undefined, command: string, options: AdapterExecutionTargetShellOptions): Promise<RunProcessResult>;
+export interface AdapterSandboxInstallCommandCheck {
+    code: string;
+    level: "info" | "warn" | "error";
+    message: string;
+    detail?: string;
+    hint?: string;
+}
+export declare function maybeRunSandboxInstallCommand(input: {
+    runId: string;
+    target: AdapterExecutionTarget | null | undefined;
+    adapterKey: string;
+    installCommand: string;
+    /** When provided, skip the install if `command -v <detectCommand>` succeeds. */
+    detectCommand?: string | null;
+    env?: Record<string, string>;
+    timeoutSec?: number;
+}): Promise<AdapterSandboxInstallCommandCheck | null>;
+export declare function readAdapterExecutionTargetHomeDir(runId: string, target: AdapterExecutionTarget | null | undefined, options: AdapterExecutionTargetShellOptions): Promise<string | null>;
+export declare function ensureAdapterExecutionTargetRuntimeCommandInstalled(input: {
+    runId: string;
+    target: AdapterExecutionTarget | null | undefined;
+    installCommand?: string | null;
+    detectCommand?: string | null;
+    cwd: string;
+    env: Record<string, string>;
+    timeoutSec?: number;
+    graceSec?: number;
+    onLog?: AdapterExecutionTargetShellOptions["onLog"];
+}): Promise<void>;
+export declare function ensureAdapterExecutionTargetFile(runId: string, target: AdapterExecutionTarget | null | undefined, filePath: string, options: AdapterExecutionTargetShellOptions): Promise<void>;
+/**
+ * Ensure a working directory exists (and is a directory) on the execution target.
+ *
+ * For local targets this delegates to the local `ensureAbsoluteDirectory` helper
+ * (Node fs). For remote (SSH/sandbox) targets it shells out and runs
+ * `mkdir -p` (when allowed) followed by a `[ -d ]` check so the result reflects
+ * the directory state inside the environment, not on the Evermore host.
+ *
+ * Throws an Error with a human-readable message on failure.
+ */
+export declare function ensureAdapterExecutionTargetDirectory(runId: string, target: AdapterExecutionTarget | null | undefined, cwd: string, options: AdapterExecutionTargetShellOptions & {
+    createIfMissing?: boolean;
+}): Promise<void>;
+export declare function adapterExecutionTargetSessionIdentity(target: AdapterExecutionTarget | null | undefined): Record<string, unknown> | null;
+export declare function adapterExecutionTargetSessionMatches(saved: unknown, target: AdapterExecutionTarget | null | undefined): boolean;
+export declare function parseAdapterExecutionTarget(value: unknown): AdapterExecutionTarget | null;
+export declare function adapterExecutionTargetFromRemoteExecution(remoteExecution: unknown, metadata?: Pick<AdapterLocalExecutionTarget, "environmentId" | "leaseId">): AdapterExecutionTarget | null;
+export declare function readAdapterExecutionTarget(input: {
+    executionTarget?: unknown;
+    legacyRemoteExecution?: unknown;
+}): AdapterExecutionTarget | null;
+export declare function prepareAdapterExecutionTargetRuntime(input: {
+    target: AdapterExecutionTarget | null | undefined;
+    adapterKey: string;
+    workspaceLocalDir: string;
+    workspaceExclude?: string[];
+    preserveAbsentOnRestore?: string[];
+    assets?: AdapterManagedRuntimeAsset[];
+    installCommand?: string | null;
+    /** When provided alongside `installCommand`, skip the install if the binary is already on PATH. */
+    detectCommand?: string | null;
+}): Promise<PreparedAdapterExecutionTargetRuntime>;
+export declare function runtimeAssetDir(prepared: Pick<PreparedAdapterExecutionTargetRuntime, "assetDirs">, key: string, fallbackRemoteCwd: string): string;
+export declare function startAdapterExecutionTargetEvermoreBridge(input: {
+    runId: string;
+    target: AdapterExecutionTarget | null | undefined;
+    runtimeRootDir: string | null | undefined;
+    adapterKey: string;
+    hostApiToken: string | null | undefined;
+    hostApiUrl?: string | null;
+    onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    maxBodyBytes?: number | null;
+}): Promise<AdapterExecutionTargetEvermoreBridgeHandle | null>;
+//# sourceMappingURL=execution-target.d.ts.map

package/dist/execution-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target.d.ts","sourceRoot":"","sources":["../src/execution-target.ts"],"names":[],"mappings":"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"}