eve
Version:
Filesystem-first framework for durable backend AI agents that run anywhere.
65 lines (64 loc) • 2.82 kB
TypeScript
/**
* Runtime-owned compiled-artifact source for one resolved agent graph.
*/
export type RuntimeCompiledArtifactsSource = RuntimeBundledCompiledArtifactsSource | RuntimeDiskCompiledArtifactsSource;
/**
* Bundled compiled artifacts installed in-process beside runtime workflow
* entrypoints.
*/
export interface RuntimeBundledCompiledArtifactsSource {
readonly kind: "bundled";
}
/**
* Disk-backed compiled artifacts rooted at one authored application.
*/
export interface RuntimeDiskCompiledArtifactsSource {
readonly appRoot: string;
readonly kind: "disk";
/**
* Native filesystem path to the package-owned authored-source module map
* loader. When set, the runtime loads modules directly from authored
* source instead of the bundled-compiled module map. Omitted in deployed
* runtimes, where the module map must come from the compiled artifact
* emitted by the build.
*/
readonly moduleMapLoaderPath?: string;
/**
* Stable application root used for local sandbox template/session caches.
* In development, `appRoot` can point at an immutable runtime snapshot
* while sandbox state should remain scoped to the authored application.
*/
readonly sandboxAppRoot?: string;
/**
* How this source is recorded in durable Workflow payloads.
* `"development-generation"` stores a logical selector resolved from the
* delivery's generation context — valid only where deliveries install
* that context (the parent-owned dev World). Absent, the source is stored
* verbatim, pinning durable work to this exact path.
*/
readonly durableReference?: "development-generation";
}
/**
* Creates the bundled compiled-artifact source.
*/
export declare function createBundledRuntimeCompiledArtifactsSource(): RuntimeBundledCompiledArtifactsSource;
/**
* Creates the disk-backed compiled-artifact source for one authored app root.
*/
export declare function createDiskRuntimeCompiledArtifactsSource(appRoot: string, options?: {
readonly durableReference?: "development-generation";
readonly moduleMapLoaderPath?: string;
readonly sandboxAppRoot?: string;
}): RuntimeDiskCompiledArtifactsSource;
/**
* Returns the disk-backed app root when one exists for the artifact source.
*/
export declare function getRuntimeCompiledArtifactsAppRoot(source: RuntimeCompiledArtifactsSource): string | undefined;
/**
* Returns the stable application root to use for local sandbox cache scope.
*/
export declare function getRuntimeCompiledArtifactsSandboxAppRoot(source: RuntimeCompiledArtifactsSource): string | undefined;
/**
* Returns the stable cache key for one runtime artifact source.
*/
export declare function getRuntimeCompiledArtifactsCacheKey(source: RuntimeCompiledArtifactsSource): string;