/**
 * Footprint recorder — observed durable changes.
 *
 * The layers that touch durable state record what they actually committed,
 * removed, or restored here; the operation resolution's footprint is these
 * observations, not planner-claimed artifact paths. Recording is a no-op when
 * no recorder is provided, so the writers stay usable outside an operation
 * boundary.
 *
 * @experimental This API is unstable and may change without notice.
 */
import * as Effect from "effect/Effect";
import * as Ref from "effect/Ref";
import * as ServiceMap from "effect/Context";
export interface FootprintObservation {
    /** Absolute path of the durable change. */
    readonly path: string;
    readonly change: "created" | "modified" | "removed" | "restored";
}
declare const FootprintRecorder_base: ServiceMap.ServiceClass<FootprintRecorder, "@agentxm/client-core/unstable/workspace/footprint-recorder/FootprintRecorder", {
    readonly ref: Ref.Ref<ReadonlyArray<FootprintObservation>>;
}>;
export declare class FootprintRecorder extends FootprintRecorder_base {
}
/** Record one observed durable change. No-op without a recorder. */
export declare const recordFootprint: (observation: FootprintObservation) => Effect.Effect<void>;
export declare const readFootprint: Effect.Effect<ReadonlyArray<FootprintObservation>>;
export declare const makeFootprintRecorder: Effect.Effect<ServiceMap.Service.Shape<typeof FootprintRecorder>>;
export {};
//# sourceMappingURL=footprint-recorder.d.ts.map