eve/dist/src/internal/nitro/host/optional-engine-dependency-plugin.d.ts

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

/**
 * Optional sandbox engine packages eve's runtime references through
 * lazy dynamic imports. Bundlers follow literal dynamic imports like
 * static imports — so without intervention mere *resolvability* (for
 * example eve's own workspace devDependencies) would pull them into
 * every hosted build. The source of truth for whether an application
 * opted in is its compiled sandbox config: the backend names captured
 * into the manifest at compile time.
 */
export declare const OPTIONAL_ENGINE_PACKAGES_BY_BACKEND_NAME: Readonly<Record<string, string>>;
interface BundlerPluginShape {
    readonly name: string;
    resolveId?(source: string, importer: string | undefined): {
        external: true;
        id: string;
    } | null | undefined;
}
/**
 * Creates the bundler plugin that pins unconfigured optional engine
 * packages as plain externals — never inlined and never traced — so a
 * resolvable-but-unrequested install adds nothing to hosted output.
 * The lazy runtime import then fails only at first use, with an
 * actionable install error. Packages whose backend the app configured
 * are excluded here and take Nitro's externalize-and-trace path
 * instead, keeping their hosted output self-contained.
 */
export declare function createOptionalEngineDependencyPlugin(unconfiguredPackages: readonly string[]): BundlerPluginShape | null;
export {};