import type { ObservationCache } from "./observation-cache.js";
/** The structured handoff payload. */
export interface HandoffPayload {
    readonly sessionId: string;
    readonly filesRead: readonly string[];
    readonly symbolsInspected: readonly string[];
    readonly observations: number;
    readonly budgetConsumed: string;
}
/** Options for building a handoff. */
export interface HandoffOptions {
    readonly cache: ObservationCache;
    readonly sessionId: string;
    readonly budgetTotal?: number;
    readonly budgetConsumed?: number;
}
/**
 * Build a structured handoff payload from the current session state.
 *
 * Projects the observation cache into a portable JSON payload that
 * a receiving agent can use to understand what the departing agent
 * knew and where it left off.
 */
export declare function buildHandoff(options: HandoffOptions): HandoffPayload;
//# sourceMappingURL=agent-handoff.d.ts.map