import type { EchoKernelTransport } from "../ports/echo-kernel-transport.js";
import { type CborValue } from "./canonical-cbor.js";
import { type RecordGitWarpImportBatchVars } from "../generated/graft-structural-history.codec.generated.js";
export interface EchoContractObstruction {
    readonly code: string;
    readonly message: string;
    readonly recovery?: string;
}
export declare class EchoSubstrateObstructionError extends Error {
    readonly code: string;
    readonly recovery: string | undefined;
    constructor(obstruction: EchoContractObstruction);
}
export interface EchoIntentReceipt {
    readonly submissionId: string;
    readonly operationName: string;
}
export type EchoIntentOutcome = {
    readonly kind: "applied";
    readonly receipt: EchoIntentReceipt;
} | {
    readonly kind: "rejected";
    readonly reason: string;
    readonly receipt: EchoIntentReceipt;
} | {
    readonly kind: "pending";
} | {
    readonly kind: "unknown";
} | {
    readonly kind: "obstructed";
    readonly obstruction: EchoContractObstruction;
};
export interface EchoIntentSubmissionHandle {
    readonly submissionId: string;
}
export interface EchoStructuralReadingRecord {
    readonly readingId: string;
    readonly readingKind: string;
    readonly basisId: string;
    readonly payloadJson: CborValue;
    readonly evidence: {
        readonly family: string;
        readonly readingId: string;
        readonly basis: Readonly<Record<string, CborValue>>;
    };
}
export interface EchoStructuralReadingsObservation {
    readonly readings: readonly EchoStructuralReadingRecord[];
    readonly obstruction?: EchoContractObstruction;
}
export interface EchoStructuralReadingsRequest {
    readonly basisId: string;
    readonly readingKind?: string;
}
export interface EchoRetainedEvidenceRequest {
    readonly basisId: string;
}
export interface EchoRetainedEvidenceResult {
    readonly posture: "retained" | "missing" | "obstructed";
}
export interface EchoStructuralHistoryClient {
    recordGitWarpImportBatch(vars: RecordGitWarpImportBatchVars): Promise<EchoIntentSubmissionHandle>;
    observeIntentOutcome(submissionId: string): Promise<EchoIntentOutcome>;
    observeStructuralReadings(request: EchoStructuralReadingsRequest): Promise<EchoStructuralReadingsObservation>;
    inspectRetainedEvidence(request: EchoRetainedEvidenceRequest): Promise<EchoRetainedEvidenceResult>;
}
export declare function createEchoStructuralHistoryClient(transport: EchoKernelTransport): EchoStructuralHistoryClient;
//# sourceMappingURL=structural-history-client.d.ts.map