eve/dist/src/compiler/artifacts.d.ts

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

import { z } from "#compiled/zod/index.js";
import { type DiscoverDiagnostic, type DiscoverDiagnosticsSummary } from "#discover/diagnostics.js";
import type { AgentSourceManifest } from "#discover/manifest.js";
import type { CompiledAgentManifest } from "#compiler/manifest.js";
import { type CompilerDiagnostic } from "#compiler/diagnostics.js";
/**
 * Stable diagnostics artifact kind emitted by the compiler.
 */
export declare const COMPILER_DIAGNOSTICS_ARTIFACT_KIND = "eve-compiler-diagnostics";
/**
 * Current diagnostics artifact schema version.
 */
export declare const COMPILER_DIAGNOSTICS_ARTIFACT_VERSION = 2;
/**
 * Stable compile metadata artifact kind emitted by the compiler.
 */
export declare const COMPILE_METADATA_KIND = "eve-compile-metadata";
/**
 * Current compile metadata schema version.
 */
export declare const COMPILE_METADATA_VERSION = 6;
/**
 * Structured paths for compiler-owned artifacts under `.eve/`.
 */
export interface CompilerArtifactPaths {
    appRoot: string;
    compiledManifestPath: string;
    compileDirectoryPath: string;
    compileMetadataPath: string;
    diagnosticsPath: string;
    discoveryManifestPath: string;
    discoveryDirectoryPath: string;
    moduleMapPath: string;
}
/**
 * Machine-readable compiler diagnostics artifact written by the compiler.
 */
export interface CompilerDiagnosticsArtifact {
    diagnostics: CompilerDiagnostic[];
    kind: typeof COMPILER_DIAGNOSTICS_ARTIFACT_KIND;
    summary: DiscoverDiagnosticsSummary;
    version: typeof COMPILER_DIAGNOSTICS_ARTIFACT_VERSION;
}
export declare const compilerDiagnosticsArtifactSchema: z.ZodObject<{
    diagnostics: z.ZodArray<z.ZodObject<{
        code: z.ZodString;
        message: z.ZodString;
        severity: z.ZodEnum<{
            error: "error";
            warning: "warning";
        }>;
        sources: z.ZodReadonly<z.ZodArray<z.ZodObject<{
            logicalPath: z.ZodOptional<z.ZodString>;
            nodeId: z.ZodString;
            sourceId: z.ZodOptional<z.ZodString>;
            sourcePath: z.ZodOptional<z.ZodString>;
        }, z.core.$strict>>>;
    }, z.core.$strict>>;
    kind: z.ZodLiteral<"eve-compiler-diagnostics">;
    summary: z.ZodObject<{
        errors: z.ZodNumber;
        warnings: z.ZodNumber;
    }, z.core.$strict>;
    version: z.ZodLiteral<2>;
}, z.core.$strict>;
/**
 * One artifact digest recorded in compile metadata.
 */
interface CompileArtifactDigest {
    path: string;
    sha256: string;
}
/**
 * Minimal compiler metadata artifact with versioning and hashes.
 */
export interface CompileMetadata {
    compile: {
        manifest: CompileArtifactDigest;
        moduleMap: CompileArtifactDigest;
    };
    discovery: {
        diagnostics: CompileArtifactDigest;
        manifest: CompileArtifactDigest;
        sourceGraphHash: string;
        summary: DiscoverDiagnosticsSummary;
    };
    generator: {
        name: string;
        version: string;
    };
    kind: typeof COMPILE_METADATA_KIND;
    status: "failed" | "ready";
    version: typeof COMPILE_METADATA_VERSION;
}
export interface CompilerArtifactLocations {
    readonly publishedRoot: string;
    readonly writeRoot: string;
}
/**
 * Input for writing compiler-owned source and diagnostic artifacts.
 */
interface WriteCompilerArtifactsInput {
    appRoot: string;
    artifactLocations: CompilerArtifactLocations;
    diagnostics: readonly DiscoverDiagnostic[];
    manifest: AgentSourceManifest;
}
/**
 * Result of writing compiler-owned artifacts.
 */
interface WriteCompilerArtifactsResult {
    compiledManifest: CompiledAgentManifest;
    diagnosticsArtifact: CompilerDiagnosticsArtifact;
    metadata: CompileMetadata;
    moduleMapSource: string;
    paths: CompilerArtifactPaths;
}
/** Resolves stable compiler-owned artifact paths for one application root. */
export declare function resolveCompilerArtifactPaths(appRoot: string): CompilerArtifactPaths;
/**
 * Creates deterministic compile metadata from already-serialized artifact
 * payloads.
 */
export declare function createCompileMetadata(input: {
    appRoot: string;
    compiledManifestJson: string;
    diagnosticsArtifactJson: string;
    diagnosticsSummary: DiscoverDiagnosticsSummary;
    discoveryManifestJson: string;
    moduleMapSource: string;
    paths: CompilerArtifactPaths;
}): CompileMetadata;
/** Writes compiler-owned artifacts and records their stable published locations. */
export declare function writeCompilerArtifacts(input: WriteCompilerArtifactsInput): Promise<WriteCompilerArtifactsResult>;
export {};