import type { DiscoverDiagnostic } from "#discover/diagnostics.js";
import type { ResolvedDiscoveryProject } from "#discover/project.js";
import { type ProjectSource } from "#discover/project-source.js";
import { type CompileMetadata, type CompilerArtifactPaths } from "#compiler/artifacts.js";
import type { CompiledAgentManifest } from "#compiler/manifest.js";
/**
 * Input for compiling the current authored agent into framework-owned
 * discovery artifacts.
 */
export interface CompileAgentInput {
    /**
     * Optional {@link ProjectSource} used for discovery reads. Defaults to a
     * disk-backed source so production callers keep their current behaviour.
     */
    source?: ProjectSource;
    startPath?: string;
}
/**
 * Result of compiling the current authored agent into framework-owned
 * artifacts.
 */
export interface CompileAgentResult {
    diagnostics: DiscoverDiagnostic[];
    manifest: CompiledAgentManifest;
    metadata: CompileMetadata;
    paths: CompilerArtifactPaths;
    project: ResolvedDiscoveryProject;
}
/**
 * Error raised when discovery artifacts were written but discovery still
 * contained errors.
 */
export declare class CompileAgentError extends Error {
    readonly result: CompileAgentResult;
    constructor(result: CompileAgentResult);
}
/**
 * Runs discovery, writes compiler-owned artifacts, and throws when discovery
 * produced errors.
 */
export declare function compileAgent(input?: CompileAgentInput): Promise<CompileAgentResult>;