@loucompanion/forge-bridge 0.1.3-dev.09aeeb7ccadf → 0.1.3-dev.1fe428dd78ab

package/dist/sandbox/lease-watchdog.js

@@ -0,0 +1,67 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+export function createLeaseUpdate(dispatchAttemptId, fencingToken, expiresAt, controlKey) {
+    return {
+        schemaVersion: 1,
+        dispatchAttemptId,
+        fencingToken,
+        expiresAt,
+        mac: leaseMac(dispatchAttemptId, fencingToken, expiresAt, controlKey)
+    };
+}
+export class MonotonicLeaseDeadline {
+    dispatchAttemptId;
+    fencingToken;
+    controlKey;
+    expiresAtMs;
+    deadlineMs;
+    constructor(dispatchAttemptId, fencingToken, initialExpiresAt, controlKey, wallNowMs = Date.now(), monotonicNowMs = performance.now()) {
+        this.dispatchAttemptId = dispatchAttemptId;
+        this.fencingToken = fencingToken;
+        this.controlKey = controlKey;
+        this.expiresAtMs = parsedExpiry(initialExpiresAt);
+        this.deadlineMs = monotonicNowMs + Math.max(0, this.expiresAtMs - wallNowMs);
+    }
+    apply(update, wallNowMs = Date.now(), monotonicNowMs = performance.now()) {
+        if (!isSignedLeaseUpdate(update)
+            || update.dispatchAttemptId !== this.dispatchAttemptId
+            || update.fencingToken !== this.fencingToken
+            || parsedExpiry(update.expiresAt) <= this.expiresAtMs)
+            return false;
+        const expected = leaseMac(update.dispatchAttemptId, update.fencingToken, update.expiresAt, this.controlKey);
+        if (!safeEqual(expected, update.mac))
+            return false;
+        this.expiresAtMs = parsedExpiry(update.expiresAt);
+        this.deadlineMs = monotonicNowMs + Math.max(0, this.expiresAtMs - wallNowMs);
+        return true;
+    }
+    expired(monotonicNowMs = performance.now()) {
+        return monotonicNowMs >= this.deadlineMs;
+    }
+}
+function leaseMac(dispatchAttemptId, fencingToken, expiresAt, controlKey) {
+    return createHmac("sha256", controlKey)
+        .update(`${dispatchAttemptId}\n${fencingToken}\n${expiresAt}`, "utf8")
+        .digest("base64url");
+}
+function safeEqual(left, right) {
+    const leftBytes = Buffer.from(left, "utf8");
+    const rightBytes = Buffer.from(right, "utf8");
+    return leftBytes.length === rightBytes.length && timingSafeEqual(leftBytes, rightBytes);
+}
+function parsedExpiry(value) {
+    const parsed = Date.parse(value);
+    if (!Number.isFinite(parsed))
+        throw new Error("Lease expiry is invalid.");
+    return parsed;
+}
+function isSignedLeaseUpdate(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const update = value;
+    return update.schemaVersion === 1
+        && typeof update.dispatchAttemptId === "string"
+        && typeof update.fencingToken === "string"
+        && typeof update.expiresAt === "string"
+        && Number.isFinite(Date.parse(update.expiresAt))
+        && typeof update.mac === "string";
+}

package/dist/sandbox/preflight.d.ts

@@ -0,0 +1,36 @@
+import type { CommandRunner, SandboxPreflightResult } from "./sandbox.types.js";
+export interface DockerPreflightOptions {
+    readonly dockerExecutable?: string;
+    readonly dockerContext?: string;
+    readonly stateRoot?: string;
+    readonly runnerInstanceId?: string;
+    readonly maxConcurrentSandboxes?: number;
+    readonly diskHighWatermarkPercent?: number;
+    readonly diskLowWatermarkPercent?: number;
+    readonly minimumWorkspaceBytes?: number;
+    readonly requireRootless?: boolean;
+}
+export declare class DockerPreflight {
+    private readonly commands;
+    private readonly cacheMs;
+    private generation;
+    private cached;
+    private cacheAt;
+    private readonly options;
+    private readonly docker;
+    private readonly ownership;
+    private diskPressureLatched;
+    constructor(options?: DockerPreflightOptions | string, commands?: CommandRunner, cacheMs?: number);
+    current(): SandboxPreflightResult | null;
+    refresh(): Promise<SandboxPreflightResult>;
+    release(): Promise<void>;
+    run(force?: boolean): Promise<SandboxPreflightResult>;
+    private inspect;
+}
+export declare function evaluateDiskPressure(availableBytes: number, totalBytes: number, minimumAvailableBytes: number, highWatermarkPercent: number, lowWatermarkPercent: number, pressureLatched: boolean): boolean;
+export declare function storagePolicyAvailable(storageQuota: boolean, environment?: NodeJS.ProcessEnv): boolean;
+export declare class DockerContextOwnershipLock {
+    private lockPath;
+    acquire(contextName?: string): Promise<void>;
+    release(): Promise<void>;
+}

package/dist/sandbox/preflight.js

@@ -0,0 +1,239 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { BoundedCommandRunner } from "./command-runner.js";
+const minimumWorkspaceBytes = 10 * 1024 * 1024 * 1024;
+export class DockerPreflight {
+    commands;
+    cacheMs;
+    generation = 0;
+    cached = null;
+    cacheAt = 0;
+    options;
+    docker;
+    ownership = new DockerContextOwnershipLock();
+    diskPressureLatched = false;
+    constructor(options = {}, commands = new BoundedCommandRunner(), cacheMs = 30_000) {
+        this.commands = commands;
+        this.cacheMs = cacheMs;
+        this.options = typeof options === "string" ? { dockerExecutable: options } : options;
+        this.docker = this.options.dockerExecutable ?? process.env.FORGE_DOCKER_EXECUTABLE ?? "docker";
+    }
+    current() {
+        return this.cached;
+    }
+    async refresh() {
+        await fs.mkdir(this.options.stateRoot ?? path.join(os.homedir(), ".forge", "bridge", "sandboxes"), { recursive: true, mode: 0o700 });
+        const result = await this.run(true);
+        if (result.healthy || result.unavailableCode === "docker_disk_low") {
+            await this.ownership.acquire(this.options.dockerContext);
+        }
+        return result;
+    }
+    async release() {
+        await this.ownership.release();
+    }
+    async run(force = false) {
+        if (!force && this.cached && Date.now() - this.cacheAt < this.cacheMs)
+            return this.cached;
+        this.generation += 1;
+        const result = await this.inspect().catch((error) => unavailable(this.generation, "docker_unreachable", error instanceof Error ? error.message : String(error)));
+        this.cached = result;
+        this.cacheAt = Date.now();
+        return result;
+    }
+    async inspect() {
+        if (!new Set(["linux", "darwin", "win32"]).has(process.platform)) {
+            return unavailable(this.generation, "platform_unsupported", `Docker sandboxes are not supported on ${process.platform}.`);
+        }
+        const dockerArgs = this.options.dockerContext ? ["--context", this.options.dockerContext] : [];
+        const infoResult = await this.commands.run(this.docker, [...dockerArgs, "info", "--format", "{{json .}}"], { timeoutMs: 10_000, maxOutputBytes: 512 * 1024 });
+        if (infoResult.exitCode !== 0)
+            return unavailable(this.generation, "docker_unreachable", singleLine(infoResult.stderr || infoResult.stdout || "Docker daemon is unreachable."));
+        const info = parseInfo(infoResult.stdout);
+        if (String(info.OSType ?? "").toLowerCase() !== "linux")
+            return unavailable(this.generation, "docker_linux_required", "Forge sandbox images require a Linux Docker daemon.");
+        const securityOptions = strings(info.SecurityOptions).map((value) => value.toLowerCase());
+        const rootless = securityOptions.some((value) => value.includes("rootless"));
+        const userNamespaces = rootless || securityOptions.some((value) => value.includes("userns"));
+        const cgroupV2 = String(info.CgroupVersion ?? "") === "2";
+        const seccomp = securityOptions.some((value) => value.includes("seccomp"));
+        const lsm = securityOptions.some((value) => value.includes("apparmor") || value.includes("selinux"));
+        const storageDriver = String(info.Driver ?? "").toLowerCase();
+        const storageQuota = storageDriver === "overlay2" && Boolean(info.DriverStatus?.some?.((entry) => JSON.stringify(entry).toLowerCase().includes("project quota")));
+        const desktopDeveloperMode = process.platform !== "linux" && process.env.FORGE_ALLOW_DOCKER_DESKTOP_SANDBOX === "true";
+        const requireRootless = this.options.requireRootless ?? process.env.FORGE_SANDBOX_REQUIRE_ROOTLESS !== "false";
+        if (!rootless && !desktopDeveloperMode && requireRootless) {
+            return unavailable(this.generation, "docker_rootless_required", "Docker daemon is reachable but is not running rootless.", {
+                rootless, userNamespaces, cgroupV2, seccomp, lsm, storageQuota, storagePolicy: false, compose: false, internalNetwork: true, buildkit: false, imagePolicy: false, securityProfile: false, egressProxy: false
+            });
+        }
+        const composeResult = await this.commands.run(this.docker, [...dockerArgs, "compose", "version", "--short"], { timeoutMs: 5_000, maxOutputBytes: 16 * 1024 }).catch(() => null);
+        const compose = composeResult?.exitCode === 0;
+        const buildxResult = await this.commands.run(this.docker, [...dockerArgs, "buildx", "version"], { timeoutMs: 5_000, maxOutputBytes: 16 * 1024 }).catch(() => null);
+        const buildxHelp = await this.commands.run(this.docker, [...dockerArgs, "buildx", "build", "--help"], { timeoutMs: 5_000, maxOutputBytes: 256 * 1024 }).catch(() => null);
+        const buildxPruneHelp = await this.commands.run(this.docker, [...dockerArgs, "buildx", "prune", "--help"], { timeoutMs: 5_000, maxOutputBytes: 256 * 1024 }).catch(() => null);
+        const containerUpdateHelp = await this.commands.run(this.docker, [...dockerArgs, "container", "update", "--help"], { timeoutMs: 5_000, maxOutputBytes: 256 * 1024 }).catch(() => null);
+        const buildkit = buildxResult?.exitCode === 0
+            && buildxHelp?.exitCode === 0
+            && ["--resource", "--ulimit", "--shm-size"].every(flag => buildxHelp.stdout.includes(flag))
+            && buildxPruneHelp?.exitCode === 0
+            && ["--max-used-space", "--min-free-space", "--reserved-space"].every(flag => buildxPruneHelp.stdout.includes(flag))
+            && containerUpdateHelp?.exitCode === 0
+            && containerUpdateHelp.stdout.includes("--pids-limit");
+        const imagePolicy = process.env.FORGE_SANDBOX_IMAGE_POLICY_ENFORCED === "true"
+            && Boolean(process.env.FORGE_SANDBOX_SBOM_EXECUTABLE?.trim())
+            && Boolean(process.env.FORGE_SANDBOX_VULNERABILITY_EXECUTABLE?.trim())
+            && Boolean(process.env.FORGE_SANDBOX_PROVENANCE_SIGNING_KEY?.trim())
+            && Boolean(process.env.FORGE_SANDBOX_SIGNATURE_EXECUTABLE?.trim())
+            && Boolean(process.env.FORGE_SANDBOX_SIGNATURE_PUBLIC_KEY?.trim())
+            && process.env.FORGE_SANDBOX_BUILD_EGRESS_ENFORCED === "true";
+        const securityProfile = Boolean(process.env.FORGE_SANDBOX_SECCOMP_PROFILE?.trim())
+            && Boolean(process.env.FORGE_SANDBOX_LSM_SECURITY_OPT?.trim())
+            && seccomp && lsm;
+        const egressProxy = process.env.FORGE_SANDBOX_EGRESS_ENFORCED === "true"
+            && /@sha256:[0-9a-f]{64}$/iu.test(process.env.FORGE_SANDBOX_EGRESS_PROXY_IMAGE?.trim() ?? "");
+        const storagePolicy = storagePolicyAvailable(storageQuota);
+        const configuredStateRoot = this.options.stateRoot ?? path.join(os.homedir(), ".forge", "bridge", "sandboxes");
+        const dockerRoot = process.platform === "linux" && typeof info.DockerRootDir === "string" && path.isAbsolute(info.DockerRootDir)
+            ? info.DockerRootDir
+            : configuredStateRoot;
+        const disk = await diskSpace(dockerRoot);
+        const requiredWorkspaceBytes = this.options.minimumWorkspaceBytes ?? minimumWorkspaceBytes;
+        const highWatermark = Math.min(99, Math.max(1, this.options.diskHighWatermarkPercent ?? 90));
+        const lowWatermark = Math.min(highWatermark - 1, Math.max(0, this.options.diskLowWatermarkPercent ?? highWatermark - 10));
+        const diskLow = evaluateDiskPressure(disk.available, disk.total, requiredWorkspaceBytes, highWatermark, lowWatermark, this.diskPressureLatched);
+        this.diskPressureLatched = diskLow;
+        const availableMemoryBytes = os.freemem();
+        const cpuCount = Math.max(1, os.availableParallelism?.() ?? os.cpus().length);
+        const availableCpuMillis = Math.max(0, (cpuCount - 1) * 1000);
+        const memorySlots = Math.max(0, Math.floor((availableMemoryBytes - 2 * 1024 ** 3) / (4 * 1024 ** 3)));
+        const cpuSlots = Math.max(0, Math.floor((cpuCount - 1) / 2));
+        const configuredMax = this.options.maxConcurrentSandboxes ?? positiveInteger(process.env.FORGE_MAX_CONCURRENT_SANDBOXES, 4);
+        const maxConcurrentSandboxes = diskLow ? 0 : Math.max(1, Math.min(4, configuredMax, Math.max(1, cpuSlots), Math.max(1, memorySlots)));
+        const features = { rootless, userNamespaces, cgroupV2, seccomp, lsm, storageQuota, storagePolicy, compose, internalNetwork: true, buildkit, imagePolicy, securityProfile, egressProxy };
+        return {
+            available: !diskLow,
+            healthy: !diskLow,
+            generation: this.generation,
+            runtimeVersion: `docker/${String(info.ServerVersion ?? "unknown")}${rootless ? "-rootless" : "-desktop"}`,
+            maxConcurrentSandboxes,
+            availableMemoryBytes,
+            availableCpuMillis,
+            availableWorkspaceBytes: disk.available,
+            diskLow,
+            unavailableCode: diskLow ? "docker_disk_low" : null,
+            unavailableReason: diskLow ? `Docker workspace has only ${disk.available} bytes available.` : null,
+            features,
+        };
+    }
+}
+export function evaluateDiskPressure(availableBytes, totalBytes, minimumAvailableBytes, highWatermarkPercent, lowWatermarkPercent, pressureLatched) {
+    if (availableBytes < minimumAvailableBytes)
+        return true;
+    if (!(totalBytes > 0))
+        return true;
+    const usedPercent = (1 - availableBytes / totalBytes) * 100;
+    if (usedPercent >= highWatermarkPercent)
+        return true;
+    return pressureLatched && usedPercent > lowWatermarkPercent;
+}
+export function storagePolicyAvailable(storageQuota, environment = process.env) {
+    return storageQuota || environment.FORGE_SANDBOX_DEDICATED_DISK === "true";
+}
+export class DockerContextOwnershipLock {
+    lockPath = null;
+    async acquire(contextName) {
+        if (this.lockPath)
+            return;
+        contextName = contextName?.trim() || process.env.DOCKER_CONTEXT?.trim() || process.env.DOCKER_HOST?.trim() || "default";
+        const key = createHash("sha256").update(contextName).digest("hex").slice(0, 24);
+        const lockPath = path.join(os.tmpdir(), `forge-docker-context-${key}.lock`);
+        await fs.mkdir(path.dirname(lockPath), { recursive: true });
+        try {
+            const handle = await fs.open(lockPath, "wx", 0o600);
+            await handle.writeFile(JSON.stringify({ pid: process.pid, contextName, acquiredAt: new Date().toISOString() }));
+            await handle.sync();
+            await handle.close();
+        }
+        catch (error) {
+            const owner = await readLock(lockPath);
+            if (owner?.pid && !processExists(owner.pid)) {
+                await fs.rm(lockPath, { force: true });
+                return await this.acquire(contextName);
+            }
+            throw new Error(`docker_context_owned: Docker context '${contextName}' is already owned by Forge runner pid ${owner?.pid ?? "unknown"}.`, { cause: error });
+        }
+        this.lockPath = lockPath;
+    }
+    async release() {
+        if (!this.lockPath)
+            return;
+        await fs.rm(this.lockPath, { force: true });
+        this.lockPath = null;
+    }
+}
+function parseInfo(stdout) {
+    try {
+        const value = JSON.parse(stdout.trim());
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            throw new Error("not an object");
+        return value;
+    }
+    catch (error) {
+        throw new Error("Docker returned an invalid info document.", { cause: error });
+    }
+}
+function unavailable(generation, code, reason, features = {
+    rootless: false, userNamespaces: false, cgroupV2: false, seccomp: false, lsm: false, storageQuota: false, storagePolicy: false, compose: false, internalNetwork: false, buildkit: false, imagePolicy: false, securityProfile: false, egressProxy: false
+}) {
+    return {
+        available: false,
+        healthy: false,
+        generation,
+        runtimeVersion: null,
+        maxConcurrentSandboxes: 0,
+        availableMemoryBytes: os.freemem(),
+        availableCpuMillis: Math.max(0, (os.availableParallelism?.() ?? os.cpus().length) * 1000),
+        availableWorkspaceBytes: 0,
+        diskLow: code === "docker_disk_low",
+        unavailableCode: code,
+        unavailableReason: singleLine(reason),
+        features,
+    };
+}
+async function diskSpace(inputPath) {
+    const stats = await fs.statfs(inputPath, { bigint: true }).catch(() => null);
+    if (!stats)
+        return { available: 0, total: 0 };
+    return {
+        available: safeNumber(stats.bavail * stats.bsize),
+        total: safeNumber(stats.blocks * stats.bsize),
+    };
+}
+function safeNumber(value) {
+    return Number(value > BigInt(Number.MAX_SAFE_INTEGER) ? BigInt(Number.MAX_SAFE_INTEGER) : value);
+}
+function strings(value) {
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function positiveInteger(value, fallback) {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+}
+function singleLine(value) {
+    return value.replace(/[\r\n\t]+/gu, " ").trim().slice(0, 1000);
+}
+async function readLock(lockPath) {
+    return await fs.readFile(lockPath, "utf8").then((value) => JSON.parse(value)).catch(() => null);
+}
+function processExists(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/sandbox/process.d.ts

@@ -0,0 +1,20 @@
+export interface SandboxProcessRequest {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd?: string;
+    readonly input?: string | Buffer;
+    readonly timeoutMs?: number;
+    readonly maxOutputBytes?: number;
+    readonly signal?: AbortSignal;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly onStdoutLine?: (line: string) => void | Promise<void>;
+    readonly terminateOnOutputLimit?: boolean;
+}
+export interface SandboxProcessResult {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly truncated: boolean;
+}
+export declare function runSandboxProcess(request: SandboxProcessRequest): Promise<SandboxProcessResult>;
+export declare function requireSandboxProcess(request: SandboxProcessRequest): Promise<SandboxProcessResult>;

package/dist/sandbox/process.js

@@ -0,0 +1,124 @@
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+export async function runSandboxProcess(request) {
+    const limit = Math.max(1024, request.maxOutputBytes ?? 1024 * 1024);
+    return await new Promise((resolve, reject) => {
+        const child = spawn(request.command, [...request.args], {
+            cwd: request.cwd,
+            env: request.env,
+            shell: false,
+            windowsHide: true,
+            stdio: [request.input === undefined ? "ignore" : "pipe", "pipe", "pipe"]
+        });
+        let stdout = Buffer.alloc(0);
+        let stderr = Buffer.alloc(0);
+        let truncated = false;
+        let settled = false;
+        let stdoutText = "";
+        const stdoutDecoder = new StringDecoder("utf8");
+        let stdoutLineChain = Promise.resolve();
+        let stdoutLineError = null;
+        const append = (current, chunk) => {
+            if (current.length >= limit) {
+                truncated = true;
+                return current;
+            }
+            const remaining = limit - current.length;
+            if (chunk.length > remaining) {
+                truncated = true;
+                if (request.terminateOnOutputLimit)
+                    terminate(`sandbox_log_limit: process output exceeded ${limit} bytes`);
+            }
+            return Buffer.concat([current, chunk.subarray(0, remaining)]);
+        };
+        child.stdout.on("data", (chunk) => {
+            stdout = append(stdout, chunk);
+            if (!request.onStdoutLine)
+                return;
+            stdoutText += stdoutDecoder.write(chunk);
+            if (Buffer.byteLength(stdoutText, "utf8") > 1024 * 1024 && !stdoutText.includes("\n")) {
+                stdoutLineError = new Error("sandbox process emitted an oversized stdout line");
+                terminate("oversized stdout line");
+                return;
+            }
+            const lines = stdoutText.split(/\r?\n/u);
+            stdoutText = lines.pop() ?? "";
+            if (lines.length === 0)
+                return;
+            child.stdout.pause();
+            for (const line of lines) {
+                stdoutLineChain = stdoutLineChain.then(async () => {
+                    if (Buffer.byteLength(line, "utf8") > 1024 * 1024)
+                        throw new Error("sandbox process emitted an oversized stdout line");
+                    await request.onStdoutLine(line);
+                });
+            }
+            stdoutLineChain = stdoutLineChain
+                .catch(error => {
+                stdoutLineError = error;
+                terminate("stdout event handler failed");
+            })
+                .finally(() => {
+                if (!settled)
+                    child.stdout.resume();
+            });
+        });
+        child.stderr.on("data", (chunk) => { stderr = append(stderr, chunk); });
+        child.on("error", (error) => {
+            if (!settled) {
+                settled = true;
+                reject(error);
+            }
+        });
+        const terminate = (reason) => {
+            if (child.exitCode !== null)
+                return;
+            child.kill("SIGTERM");
+            setTimeout(() => child.kill("SIGKILL"), 5_000).unref?.();
+            if (!settled) {
+                // Completion is still resolved by close so stderr remains available.
+                stderr = append(stderr, Buffer.from(`\n${reason}\n`));
+            }
+        };
+        const timeout = request.timeoutMs
+            ? setTimeout(() => terminate(`process timeout after ${request.timeoutMs}ms`), request.timeoutMs)
+            : null;
+        timeout?.unref?.();
+        const abort = () => terminate(String(request.signal?.reason ?? "process aborted"));
+        request.signal?.addEventListener("abort", abort, { once: true });
+        if (request.input !== undefined) {
+            child.stdin.end(request.input);
+        }
+        child.on("close", async (code) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            request.signal?.removeEventListener("abort", abort);
+            if (request.onStdoutLine)
+                stdoutText += stdoutDecoder.end();
+            if (request.onStdoutLine && stdoutText) {
+                stdoutLineChain = stdoutLineChain.then(() => request.onStdoutLine(stdoutText));
+            }
+            await stdoutLineChain.catch(error => { stdoutLineError ??= error; });
+            if (stdoutLineError) {
+                reject(stdoutLineError);
+                return;
+            }
+            resolve({
+                exitCode: code ?? 1,
+                stdout: stdout.toString("utf8"),
+                stderr: stderr.toString("utf8"),
+                truncated
+            });
+        });
+    });
+}
+export async function requireSandboxProcess(request) {
+    const result = await runSandboxProcess(request);
+    if (result.exitCode !== 0) {
+        throw new Error(`${request.command} ${request.args[0] ?? ""} failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.exitCode}`}`);
+    }
+    return result;
+}

package/dist/sandbox/provider-auth/codex.d.ts

@@ -0,0 +1,26 @@
+export interface SandboxAuthDoctorResult {
+    readonly available: boolean;
+    readonly code: "ok" | "sandbox_auth_unavailable";
+    readonly message: string;
+    readonly authPath?: string;
+}
+export interface SandboxProviderCredentialFile {
+    readonly name: string;
+    readonly contentBase64: string;
+}
+export interface SandboxPreparedProviderAuth {
+    readonly files: readonly SandboxProviderCredentialFile[];
+    readonly containerMountPath: string;
+    readonly writable: boolean;
+}
+export interface SandboxProviderAuthAdapter {
+    readonly provider: "codex";
+    readonly authKind: "bridge_cli";
+    readonly containerMountPath: string;
+    readonly writable: boolean;
+    doctor(environment?: NodeJS.ProcessEnv): SandboxAuthDoctorResult;
+    prepareAttemptAuth(environment?: NodeJS.ProcessEnv): Promise<SandboxPreparedProviderAuth>;
+}
+export declare const codexSandboxProviderAuthAdapter: SandboxProviderAuthAdapter;
+export declare function sandboxProviderAuthAdapterFor(provider: string, authKind: string): SandboxProviderAuthAdapter | null;
+export declare function sandboxProviderAuthUnavailableMessage(provider: string, authKind: string): string | null;