experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/resolve-agent.js

@@ -0,0 +1,169 @@
+import { ROOT_COMPILED_AGENT_NODE_ID } from "../compiler/manifest.js";
+import { expectFunction, expectObjectRecord, getAuthoredModuleExport, materializeAuthoredModuleExport, } from "../internal/authored-module.js";
+import { createHarnessWorkspaceSpec } from "./harness/workspace/spec.js";
+/**
+ * Error raised when compiled artifacts cannot be hydrated into a runtime-owned
+ * authored agent model.
+ */
+export class ResolveAgentError extends Error {
+    logicalPath;
+    sourceId;
+    constructor(message, input = {}) {
+        super(message);
+        this.name = "ResolveAgentError";
+        if (input.logicalPath !== undefined) {
+            this.logicalPath = input.logicalPath;
+        }
+        if (input.sourceId !== undefined) {
+            this.sourceId = input.sourceId;
+        }
+    }
+}
+/**
+ * Resolves the core authored agent path from compiled artifacts.
+ */
+export async function resolveAgent(input) {
+    const resolvedSkills = input.manifest.skills.map((skill) => ({
+        ...skill,
+        metadata: skill.metadata === undefined
+            ? undefined
+            : {
+                ...skill.metadata,
+            },
+    }));
+    const resolvedTools = await Promise.all(input.manifest.tools.map((toolDefinition) => resolveToolDefinition(toolDefinition, input.moduleMap, input.nodeId)));
+    const resolvedSandboxes = await Promise.all(input.manifest.sandboxes.map((sandboxDefinition) => resolveSandboxDefinition(sandboxDefinition, input.moduleMap, input.nodeId)));
+    const promptLayers = input.manifest.promptLayers.map((promptLayer) => ({
+        id: promptLayer.id,
+        kind: promptLayer.kind,
+        logicalPath: promptLayer.logicalPath,
+        markdown: promptLayer.markdown,
+        sourceId: promptLayer.sourceId,
+        sourceKind: promptLayer.sourceKind,
+    }));
+    return {
+        config: createResolvedAgentConfig(input.manifest),
+        context: [...(input.contextDocuments ?? [])],
+        id: input.manifest.config.id ?? input.manifest.agentId,
+        metadata: {
+            agentRoot: input.manifest.agentRoot,
+            appRoot: input.manifest.appRoot,
+            diagnosticsSummary: input.manifest.diagnosticsSummary,
+        },
+        promptLayers,
+        sandboxes: resolvedSandboxes,
+        skills: resolvedSkills,
+        tools: resolvedTools,
+        workspaceFiles: [...(input.workspaceFiles ?? [])],
+        workspaceSpec: createHarnessWorkspaceSpec({
+            contextDocuments: input.contextDocuments,
+            skills: resolvedSkills,
+            workspaceFiles: input.workspaceFiles,
+        }),
+    };
+}
+function createResolvedAgentConfig(manifest) {
+    const config = {
+        metadata: { ...manifest.config.metadata },
+        model: manifest.config.model.source === undefined
+            ? {
+                id: manifest.config.model.id,
+            }
+            : {
+                id: manifest.config.model.id,
+                source: {
+                    exportName: manifest.config.model.source.exportName,
+                    kind: "module",
+                    logicalPath: manifest.config.model.source.logicalPath,
+                    sourceId: manifest.config.model.source.sourceId,
+                },
+            },
+    };
+    if (manifest.config.source !== undefined) {
+        config.source = createResolvedModuleSourceMetadata(manifest.config.source);
+    }
+    return config;
+}
+function createResolvedModuleSourceMetadata(sourceRef) {
+    return {
+        exportName: sourceRef.exportName,
+        logicalPath: sourceRef.logicalPath,
+        sourceId: sourceRef.sourceId,
+        sourceKind: "module",
+    };
+}
+async function resolveSandboxDefinition(definition, moduleMap, nodeId) {
+    const resolvedNodeId = nodeId ?? ROOT_COMPILED_AGENT_NODE_ID;
+    const moduleNamespace = moduleMap.nodes[resolvedNodeId]?.modules[definition.sourceId];
+    if (moduleNamespace === undefined) {
+        throw new ResolveAgentError(`Missing compiled module namespace for sandbox source "${definition.sourceId}" in node "${resolvedNodeId}".`, {
+            logicalPath: definition.logicalPath,
+            sourceId: definition.sourceId,
+        });
+    }
+    const moduleRecord = expectObjectRecord(moduleNamespace, `Missing compiled module namespace for sandbox source "${definition.sourceId}" in node "${resolvedNodeId}".`);
+    const exportValue = getAuthoredModuleExport(moduleRecord, {
+        exportName: definition.exportName,
+        logicalPath: definition.logicalPath,
+    });
+    try {
+        const resolvedExportValue = await materializeAuthoredModuleExport(exportValue);
+        const resolvedRecord = expectObjectRecord(resolvedExportValue, `Expected the sandbox export "${definition.exportName ?? "default"}" from "${definition.logicalPath}" to return an object.`);
+        const sandboxDefinition = resolvedRecord;
+        return {
+            bootstrap: sandboxDefinition.bootstrap,
+            description: definition.description,
+            exportName: definition.exportName,
+            logicalPath: definition.logicalPath,
+            name: definition.name,
+            onSession: sandboxDefinition.onSession,
+            sourceId: definition.sourceId,
+            sourceKind: "module",
+        };
+    }
+    catch (error) {
+        throw new ResolveAgentError(`Failed to attach the sandbox lifecycle handlers from "${definition.logicalPath}": ${formatUnknownError(error)}`, {
+            logicalPath: definition.logicalPath,
+            sourceId: definition.sourceId,
+        });
+    }
+}
+async function resolveToolDefinition(definition, moduleMap, nodeId) {
+    const resolvedNodeId = nodeId ?? ROOT_COMPILED_AGENT_NODE_ID;
+    const moduleNamespace = moduleMap.nodes[resolvedNodeId]?.modules[definition.sourceId];
+    if (moduleNamespace === undefined) {
+        throw new ResolveAgentError(`Missing compiled module namespace for tool source "${definition.sourceId}" in node "${resolvedNodeId}".`, {
+            logicalPath: definition.logicalPath,
+            sourceId: definition.sourceId,
+        });
+    }
+    const moduleRecord = expectObjectRecord(moduleNamespace, `Missing compiled module namespace for tool source "${definition.sourceId}" in node "${resolvedNodeId}".`);
+    const exportValue = getAuthoredModuleExport(moduleRecord, {
+        exportName: definition.exportName,
+        logicalPath: definition.logicalPath,
+    });
+    try {
+        const resolvedExportValue = await materializeAuthoredModuleExport(exportValue);
+        const resolvedRecord = expectObjectRecord(resolvedExportValue, `Expected the tool export "${definition.exportName ?? "default"}" from "${definition.logicalPath}" to return an object.`);
+        return {
+            description: definition.description,
+            execute: expectFunction(resolvedRecord.execute, `Expected the tool export "${definition.exportName ?? "default"}" from "${definition.logicalPath}" to provide an execute function.`),
+            exportName: definition.exportName,
+            inputSchema: definition.inputSchema,
+            logicalPath: definition.logicalPath,
+            name: definition.name,
+            sourceId: definition.sourceId,
+            sourceKind: "module",
+        };
+    }
+    catch (error) {
+        throw new ResolveAgentError(`Failed to attach the tool execute function from "${definition.logicalPath}": ${formatUnknownError(error)}`, {
+            logicalPath: definition.logicalPath,
+            sourceId: definition.sourceId,
+        });
+    }
+}
+function formatUnknownError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=resolve-agent.js.map

package/dist/src/runtime/resolve-agent.js.map

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

package/dist/src/runtime/sandboxes/bindings/local.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeSandboxBinding } from "../types.js";
+/**
+ * Creates the local just-bash-backed sandbox binding.
+ */
+export declare function createLocalRuntimeSandboxBinding(input: {
+    readonly cacheDirectory: string;
+}): RuntimeSandboxBinding;
+//# sourceMappingURL=local.d.ts.map

package/dist/src/runtime/sandboxes/bindings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/sandboxes/bindings/local.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AAwBrB;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,qBAAqB,CA2DxB"}

package/dist/src/runtime/sandboxes/bindings/local.js

@@ -0,0 +1,209 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const LOCAL_SANDBOX_CWD = "/workspace";
+const LOCAL_SANDBOX_SNAPSHOT_VERSION = 1;
+/**
+ * Creates the local just-bash-backed sandbox binding.
+ */
+export function createLocalRuntimeSandboxBinding(input) {
+    return {
+        type: "local",
+        async upsertTemplate(templateInput) {
+            const snapshotPath = resolveTemplateSnapshotPath(input.cacheDirectory, templateInput.templateKey);
+            if (await doesPathExist(snapshotPath)) {
+                return createTemplateRecord(templateInput.templateKey, snapshotPath);
+            }
+            const sandbox = await createLocalLiveSandbox({
+                sessionKey: templateInput.templateKey,
+                snapshotPath,
+            });
+            if (templateInput.bootstrap !== undefined) {
+                await templateInput.bootstrap(sandbox);
+            }
+            const capturedState = await sandbox.captureState?.();
+            if (capturedState === undefined) {
+                throw new Error(`Failed to capture local sandbox template state for "${templateInput.templateKey}".`);
+            }
+            return createTemplateRecord(templateInput.templateKey, snapshotPath);
+        },
+        async upsertSession(sessionInput) {
+            const snapshotPath = getLocalSnapshotPath(sessionInput.existingMetadata) ??
+                resolveSessionSnapshotPath(input.cacheDirectory, sessionInput.sessionKey);
+            const hadExistingSnapshot = await doesPathExist(snapshotPath);
+            if (!hadExistingSnapshot) {
+                const templateSnapshotPath = getLocalSnapshotPath(sessionInput.template.metadata);
+                if (templateSnapshotPath !== undefined && (await doesPathExist(templateSnapshotPath))) {
+                    const templateSnapshot = await readLocalSnapshot(templateSnapshotPath);
+                    if (templateSnapshot !== null) {
+                        await writeLocalSnapshot(snapshotPath, templateSnapshot);
+                    }
+                }
+            }
+            return {
+                liveSandbox: await createLocalLiveSandbox({
+                    sessionKey: sessionInput.sessionKey,
+                    snapshotPath,
+                }),
+                status: hadExistingSnapshot ? "restored" : "initialized",
+            };
+        },
+    };
+}
+function createTemplateRecord(templateKey, snapshotPath) {
+    return {
+        adapter: "local",
+        metadata: {
+            snapshotPath,
+        },
+        templateKey,
+    };
+}
+async function createLocalLiveSandbox(input) {
+    const { Bash, InMemoryFs } = await import("just-bash");
+    const snapshot = await readLocalSnapshot(input.snapshotPath);
+    const filesystem = new InMemoryFs(createInitialFiles(snapshot));
+    await ensureLocalSandboxDirectories(filesystem);
+    await restoreLocalSandboxDirectories(filesystem, snapshot?.entries ?? []);
+    const bash = new Bash({
+        cwd: LOCAL_SANDBOX_CWD,
+        env: snapshot?.env,
+        fs: filesystem,
+        network: {
+            dangerouslyAllowFullInternetAccess: true,
+        },
+    });
+    return {
+        adapter: "local",
+        async captureState() {
+            const nextSnapshot = await captureLocalSnapshot({
+                filesystem,
+                sandbox: bash,
+            });
+            await writeLocalSnapshot(input.snapshotPath, nextSnapshot);
+            return {
+                snapshotPath: input.snapshotPath,
+            };
+        },
+        cwd: LOCAL_SANDBOX_CWD,
+        async dispose() {
+            const disposableBash = bash;
+            await disposableBash.dispose?.();
+        },
+        async executeCommand(command) {
+            const result = await bash.exec(command);
+            return {
+                exitCode: result.exitCode,
+                stderr: result.stderr,
+                stdout: result.stdout,
+            };
+        },
+        async readFile(path) {
+            return await bash.fs.readFile(path);
+        },
+        sessionKey: input.sessionKey,
+        async writeFiles(files) {
+            for (const file of files) {
+                const content = typeof file.content === "string" ? file.content : file.content.toString("utf8");
+                await bash.fs.writeFile(file.path, content);
+            }
+        },
+    };
+}
+function resolveTemplateSnapshotPath(cacheDirectory, templateKey) {
+    return join(cacheDirectory, "local", "templates", `${templateKey}.json`);
+}
+function resolveSessionSnapshotPath(cacheDirectory, sessionKey) {
+    return join(cacheDirectory, "local", "sessions", `${sessionKey}.json`);
+}
+function createInitialFiles(snapshot) {
+    const files = {};
+    for (const entry of snapshot?.entries ?? []) {
+        if (entry.kind !== "file") {
+            continue;
+        }
+        files[entry.path] = Buffer.from(entry.contentBase64, "base64");
+    }
+    return files;
+}
+async function ensureLocalSandboxDirectories(filesystem) {
+    await filesystem.mkdir(LOCAL_SANDBOX_CWD, {
+        recursive: true,
+    });
+}
+async function restoreLocalSandboxDirectories(filesystem, entries) {
+    const directoryPaths = entries
+        .filter((entry) => entry.kind === "directory")
+        .map((entry) => entry.path)
+        .sort((left, right) => left.localeCompare(right));
+    for (const directoryPath of directoryPaths) {
+        if (directoryPath === LOCAL_SANDBOX_CWD) {
+            continue;
+        }
+        await filesystem.mkdir(directoryPath, {
+            recursive: true,
+        });
+    }
+}
+async function captureLocalSnapshot(input) {
+    const entries = [];
+    const paths = input.filesystem.getAllPaths().sort((left, right) => left.localeCompare(right));
+    for (const path of paths) {
+        const stat = await input.filesystem.stat(path);
+        if (stat.isSymbolicLink) {
+            continue;
+        }
+        if (stat.isDirectory) {
+            entries.push({
+                kind: "directory",
+                path,
+            });
+            continue;
+        }
+        if (!stat.isFile) {
+            continue;
+        }
+        const content = await input.filesystem.readFileBuffer(path);
+        entries.push({
+            contentBase64: Buffer.from(content).toString("base64"),
+            kind: "file",
+            path,
+        });
+    }
+    return {
+        entries,
+        env: {
+            ...input.sandbox.getEnv(),
+        },
+        version: LOCAL_SANDBOX_SNAPSHOT_VERSION,
+    };
+}
+async function readLocalSnapshot(snapshotPath) {
+    if (!(await doesPathExist(snapshotPath))) {
+        return null;
+    }
+    const snapshotJson = JSON.parse(await readFile(snapshotPath, "utf8"));
+    if (snapshotJson.version !== LOCAL_SANDBOX_SNAPSHOT_VERSION) {
+        return null;
+    }
+    return snapshotJson;
+}
+async function writeLocalSnapshot(snapshotPath, snapshot) {
+    await mkdir(dirname(snapshotPath), {
+        recursive: true,
+    });
+    await writeFile(snapshotPath, `${JSON.stringify(snapshot, null, 2)}\n`);
+}
+async function doesPathExist(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getLocalSnapshotPath(metadata) {
+    const snapshotPath = metadata?.snapshotPath;
+    return typeof snapshotPath === "string" ? snapshotPath : undefined;
+}
+//# sourceMappingURL=local.js.map

package/dist/src/runtime/sandboxes/bindings/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../src/runtime/sandboxes/bindings/local.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/sandboxes/bindings/vercel.d.ts

@@ -0,0 +1,11 @@
+import type * as VercelSandboxSdk from "@vercel/sandbox";
+import type { RuntimeSandboxBinding } from "../types.js";
+type VercelSandboxModule = typeof VercelSandboxSdk;
+/**
+ * Creates the Vercel-backed sandbox binding.
+ */
+export declare function createVercelRuntimeSandboxBinding(input?: {
+    readonly loadSandboxModule?: () => Promise<VercelSandboxModule>;
+}): RuntimeSandboxBinding;
+export {};
+//# sourceMappingURL=vercel.d.ts.map

package/dist/src/runtime/sandboxes/bindings/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/sandboxes/bindings/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,gBAAgB,MAAM,iBAAiB,CAAC;AAIzD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,aAAa,CAAC;AAGrB,KAAK,mBAAmB,GAAG,OAAO,gBAAgB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,GAAE;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAAO,GAC9E,qBAAqB,CAmEvB"}

package/dist/src/runtime/sandboxes/bindings/vercel.js

@@ -0,0 +1,147 @@
+const VERCEL_SANDBOX_CWD = "/vercel/sandbox/workspace";
+/**
+ * Creates the Vercel-backed sandbox binding.
+ */
+export function createVercelRuntimeSandboxBinding(input = {}) {
+    const loadSandboxModule = input.loadSandboxModule ?? (async () => await import("@vercel/sandbox"));
+    return {
+        type: "vercel",
+        async upsertTemplate(templateInput) {
+            const sandboxModule = await loadSandboxModule();
+            let sandbox = await getNamedSandbox(sandboxModule, templateInput.templateKey);
+            if (sandbox === null) {
+                sandbox = await sandboxModule.Sandbox.create({
+                    name: templateInput.templateKey,
+                    persistent: false,
+                });
+            }
+            if (typeof sandbox.currentSnapshotId === "string" && sandbox.currentSnapshotId.length > 0) {
+                return createTemplateRecord(templateInput.templateKey, sandbox.name, sandbox.currentSnapshotId);
+            }
+            const liveSandbox = await createVercelLiveSession(sandbox, templateInput.templateKey);
+            if (templateInput.bootstrap !== undefined) {
+                await templateInput.bootstrap(liveSandbox);
+            }
+            const snapshot = await sandbox.snapshot();
+            return createTemplateRecord(templateInput.templateKey, sandbox.name, snapshot.snapshotId);
+        },
+        async upsertSession(sessionInput) {
+            const sandboxModule = await loadSandboxModule();
+            const sandboxName = getVercelSandboxName(sessionInput.existingMetadata) ?? sessionInput.sessionKey;
+            let sandbox = await getNamedSandbox(sandboxModule, sandboxName);
+            const status = sandbox === null ? "initialized" : "restored";
+            if (sandbox === null) {
+                const snapshotId = getVercelSnapshotId(sessionInput.template.metadata);
+                if (snapshotId === undefined) {
+                    throw new Error(`Missing Vercel sandbox snapshot id for template "${sessionInput.template.templateKey}".`);
+                }
+                sandbox = await sandboxModule.Sandbox.create({
+                    name: sandboxName,
+                    persistent: true,
+                    source: {
+                        snapshotId,
+                        type: "snapshot",
+                    },
+                });
+            }
+            return {
+                liveSandbox: await createVercelLiveSession(sandbox, sessionInput.sessionKey),
+                status,
+            };
+        },
+    };
+}
+function createTemplateRecord(templateKey, sandboxName, snapshotId) {
+    return {
+        adapter: "vercel",
+        metadata: {
+            sandboxName,
+            snapshotId,
+        },
+        templateKey,
+    };
+}
+async function createVercelLiveSession(sandbox, sessionKey) {
+    await ensureSandboxWorkingDirectory(sandbox);
+    return {
+        adapter: "vercel",
+        async captureState() {
+            return {
+                sandboxName: sandbox.name,
+            };
+        },
+        cwd: VERCEL_SANDBOX_CWD,
+        async executeCommand(command) {
+            const result = await sandbox.runCommand({
+                args: ["-lc", command],
+                cmd: "bash",
+                cwd: VERCEL_SANDBOX_CWD,
+            });
+            const [stdout, stderr] = await Promise.all([result.stdout(), result.stderr()]);
+            return {
+                exitCode: result.exitCode,
+                stderr,
+                stdout,
+            };
+        },
+        async readFile(path) {
+            const buffer = await sandbox.readFileToBuffer({
+                cwd: VERCEL_SANDBOX_CWD,
+                path,
+            });
+            if (buffer === null) {
+                throw new Error(`Sandbox file "${path}" was not found.`);
+            }
+            return buffer.toString("utf8");
+        },
+        sessionKey,
+        async writeFiles(files) {
+            await sandbox.writeFiles(files.map((file) => ({
+                content: typeof file.content === "string"
+                    ? Buffer.from(file.content)
+                    : Buffer.from(file.content),
+                path: file.path.startsWith("/") ? file.path : `${VERCEL_SANDBOX_CWD}/${file.path}`,
+            })));
+        },
+    };
+}
+async function ensureSandboxWorkingDirectory(sandbox) {
+    const result = await sandbox.runCommand({
+        args: ["-p", VERCEL_SANDBOX_CWD],
+        cmd: "mkdir",
+    });
+    if (result.exitCode !== 0) {
+        const stderr = await result.stderr();
+        throw new Error(`Failed to initialize Vercel sandbox working directory. ${stderr}`);
+    }
+}
+async function getNamedSandbox(sandboxModule, sandboxName) {
+    try {
+        return await sandboxModule.Sandbox.get({
+            name: sandboxName,
+        });
+    }
+    catch (error) {
+        if (isSandboxMissingError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+function isSandboxMissingError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const status = error.response?.status ??
+        error.cause?.response?.status;
+    return status === 404;
+}
+function getVercelSandboxName(metadata) {
+    const sandboxName = metadata?.sandboxName;
+    return typeof sandboxName === "string" ? sandboxName : undefined;
+}
+function getVercelSnapshotId(metadata) {
+    const snapshotId = metadata?.snapshotId;
+    return typeof snapshotId === "string" ? snapshotId : undefined;
+}
+//# sourceMappingURL=vercel.js.map

package/dist/src/runtime/sandboxes/bindings/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../../../../src/runtime/sandboxes/bindings/vercel.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/sandboxes/ensure.d.ts

@@ -0,0 +1,36 @@
+import { type RuntimeCompiledArtifactsSource } from "../compiled-artifacts-source.js";
+import type { RuntimeSandboxRegistry } from "./registry.js";
+import type { RuntimeHarnessSandboxTool, RuntimeSandboxEventSink, RuntimeSandboxObservedEvent, RuntimeSandboxState } from "./types.js";
+/**
+ * Internal environment override used to force a runtime sandbox backend.
+ */
+export declare const ASH_SANDBOX_BACKEND_ENV = "ASH_SANDBOX_BACKEND";
+/**
+ * One managed collection of live sandboxes prepared for the current turn.
+ */
+export interface ManagedRuntimeSandboxes {
+    captureState(): Promise<RuntimeSandboxState>;
+    dispose(): Promise<void>;
+    readEvents(): readonly RuntimeSandboxObservedEvent[];
+    readonly sandboxes: readonly RuntimeHarnessSandboxTool[];
+}
+/**
+ * Input for creating or reattaching the live runtime sandboxes needed for one
+ * harness turn.
+ */
+export interface EnsureRuntimeSandboxesInput {
+    readonly compiledArtifactsSource: RuntimeCompiledArtifactsSource;
+    readonly eventSink?: RuntimeSandboxEventSink;
+    readonly registry?: RuntimeSandboxRegistry;
+    readonly sessionId: string;
+    readonly state: RuntimeSandboxState | null;
+}
+/**
+ * Creates or reattaches the live runtime sandboxes for one harness turn.
+ */
+export declare function ensureRuntimeSandboxes(input: EnsureRuntimeSandboxesInput): Promise<ManagedRuntimeSandboxes>;
+/**
+ * Clears every cached live runtime sandbox retained in process memory.
+ */
+export declare function clearRuntimeSandboxCache(): void;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/src/runtime/sandboxes/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../../../src/runtime/sandboxes/ensure.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,iCAAiC,CAAC;AAKzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAEV,yBAAyB,EAIzB,uBAAuB,EAEvB,2BAA2B,EAE3B,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAKpB;;GAEG;AACH,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,SAAS,2BAA2B,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC1D;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,uBAAuB,CAAC,CA4FlC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C"}