import type { AIDescription, Asset, DescriptionSource } from '../core/types';
/** Filenames inside the hand-off directory. */
export declare const HANDOFF_FILES: {
    readonly prompt: 'PROMPT.md';
    readonly assets: 'assets.json';
    readonly answers: 'descriptions.json';
};
/** Just the fields an agent fills in; the rest of {@link AIDescription} is derived. */
export type AnswerDescription = Omit<AIDescription, 'dependencies' | 'source'>;
export interface HandoffPaths {
    dir: string;
    prompt: string;
    assets: string;
    answers: string;
}
/** Write `PROMPT.md` + `assets.json` into `dir`, returning the packet paths. */
export declare function writeHandoff(dir: string, assets: Asset[], agentLabel: string): HandoffPaths;
/** Parse `descriptions.json` into an id → answer map (tolerant of array form). */
export declare function readAnswers(file: string): Record<string, Partial<AnswerDescription>>;
/**
 * Merge agent answers onto assets in place. An asset's existing (heuristic)
 * description is used to backfill any field the agent left blank, so the result
 * is always complete. Returns how many assets the agent actually described.
 */
export declare function applyAnswers(assets: Asset[], answers: Record<string, Partial<AnswerDescription>>, source: DescriptionSource): number;