eve/dist/src/execution/sandbox/lazy-backend.d.ts

Filesystem-first framework for durable backend AI agents that run anywhere.

import type { SandboxBackend } from "#public/definitions/sandbox-backend.js";
/**
 * Wraps a backend-producing function in a `SandboxBackend` proxy that
 * invokes the function exactly once, on first access to any of `.name`,
 * `.create`, or `.prewarm`. Subsequent accesses return the same cached
 * underlying backend.
 *
 * Used by `defaultSandbox()` for env-conditional selection, and by the
 * authored-definition normalizer when an author passes a callback to
 * `SandboxDefinition.backend` (e.g. `backend: () => vercel({...})`)
 * so the factory runs at first use rather than at module load — while
 * still preserving backend-internal state (such as the Vercel backend's
 * prewarmed-templates map) across every framework call.
 */
export declare function lazyBackend<BO, SO>(factory: () => SandboxBackend<BO, SO>): SandboxBackend<BO, SO>;