import type { CodaliStorageDatasetKind, CodaliStorageObjectPrivacyFlags } from "../storage/CodaliStorageContracts.js";
import type { DatasetEligibilityGateRejectedExample } from "./DatasetEligibilityGate.js";
import type { DatasetExportManifestReaderResult } from "./DatasetExportManifestReader.js";
export declare const CODALI_PATCH_CANDIDATE_SCHEMA_VERSION: "codali.improvement.patch_candidate.v1";
export declare const CODALI_PATCH_PROPOSAL_ARTIFACTS: readonly ["prompt", "schema", "tool-metadata"];
export type CodaliPatchProposalArtifact = (typeof CODALI_PATCH_PROPOSAL_ARTIFACTS)[number];
export type CodaliPatchCandidateKind = "prompt" | "schema" | "tool_metadata";
export type CodaliPatchOperationType = "add_prompt_failure_guardrail" | "tighten_schema_contract" | "update_tool_metadata_contract";
export interface CodaliPatchObjectRefSummary {
    refId: string;
    kind: string;
    contentHash: string;
    byteSize: number;
    mimeType: string;
    deletionGroupId: string;
    privacyFlags: CodaliStorageObjectPrivacyFlags;
    uri?: string;
    mediaType?: string;
    metadataKeys: string[];
}
export interface CodaliPatchSourceExample {
    recordId: string;
    sourceGatewayRecordId?: string;
    datasetKind?: CodaliStorageDatasetKind;
    artifactTypes: string[];
    failureClasses: string[];
    failureReasonCodes: string[];
    preferenceSignals: string[];
    priorityScore: number;
    lineageKey: {
        runIds: string[];
        deletionGroupIds: string[];
        promptHash?: string;
        schemaHash?: string;
        toolContractHash?: string;
        expectedTargetHash?: string;
    };
    objectRefs: {
        inputRef?: CodaliPatchObjectRefSummary;
        outputRef?: CodaliPatchObjectRefSummary;
        evidenceRefs: CodaliPatchObjectRefSummary[];
    };
    metadataShape: {
        keys: string[];
        failureEvidenceKeys: string[];
        contractKeys: string[];
    };
}
export interface CodaliPatchFailureEvidence {
    source: "source_example" | "curation_rejection";
    recordId?: string;
    targetType?: DatasetEligibilityGateRejectedExample["targetType"];
    failureClasses: string[];
    reasonCodes: string[];
    paths: string[];
}
export interface CodaliPatchPlanOperation {
    operationId: string;
    operationType: CodaliPatchOperationType;
    productNeutral: true;
    contractDriven: true;
    sourceRecordIds: string[];
    failureClasses: string[];
    requiredEvidence: Array<"source_examples" | "failure_classes">;
    writesRuntimeCode: false;
    target: {
        artifact: CodaliPatchProposalArtifact;
        candidateKind: CodaliPatchCandidateKind;
        promptHashes: string[];
        schemaHashes: string[];
        toolContractHashes: string[];
        expectedTargetHashes: string[];
    };
}
export interface CodaliPatchPlan {
    planId: string;
    artifact: CodaliPatchProposalArtifact;
    candidateKind: CodaliPatchCandidateKind;
    deterministic: true;
    patchArtifactType: "prompt_patch" | "schema_patch" | "tool_metadata_patch";
    sourceExampleCount: number;
    failureClasses: string[];
    operations: CodaliPatchPlanOperation[];
    blockedReasons: string[];
}
export interface CodaliPromptRegressionEvalCandidate {
    suiteId: string;
    sourceExportId: string;
    wouldFailBeforeChange: true;
    cases: Array<{
        caseId: string;
        sourceRecordId: string;
        failureClasses: string[];
        preChangeExpectedStatus: "fail";
        postChangeExpectedStatus: "pass";
        assertions: string[];
        objectRefs: CodaliPatchSourceExample["objectRefs"];
    }>;
}
export interface CodaliPatchImprovementCandidateSummary {
    candidateId: string;
    candidateKind: CodaliPatchCandidateKind;
    status: "proposed" | "blocked";
    patchPlanId: string;
    sourceExportIds: string[];
    sourceRecordIds: string[];
    artifactIds: string[];
    exampleCount: number;
    objectBytes: number;
    failureClasses: string[];
    blockedReasons: string[];
}
export interface CodaliPatchCandidateBundle {
    schemaVersion: typeof CODALI_PATCH_CANDIDATE_SCHEMA_VERSION;
    artifact: CodaliPatchProposalArtifact;
    source: {
        exportId: string;
        manifestId: string;
        manifestPath: string;
        exportKind: string;
        checksum: string;
        recordCount: number;
        primaryArtifactRef: CodaliPatchObjectRefSummary;
    };
    generationPolicy: {
        deterministic: true;
        modifiesRuntimePrompts: false;
        modifiesRuntimeCode: false;
        bodyPolicy: "object_refs_only";
        failureEvidenceRequired: true;
        sourceExamplesRequired: true;
    };
    expectedShape: {
        schemaVersion: typeof CODALI_PATCH_CANDIDATE_SCHEMA_VERSION;
        artifact: CodaliPatchProposalArtifact;
        requiredFields: string[];
        sourceExampleRequiredFields: string[];
        patchPlanRequiredFields: string[];
    };
    sourceExamples: CodaliPatchSourceExample[];
    failureEvidence: CodaliPatchFailureEvidence[];
    failureClasses: string[];
    patchPlan: CodaliPatchPlan;
    promptEval?: CodaliPromptRegressionEvalCandidate;
    candidates: CodaliPatchImprovementCandidateSummary[];
}
export interface BuildCodaliPatchCandidateBundleInput {
    inspection: DatasetExportManifestReaderResult;
    artifact: CodaliPatchProposalArtifact;
}
export declare const buildCodaliPatchCandidateBundle: (input: BuildCodaliPatchCandidateBundleInput) => CodaliPatchCandidateBundle;
//# sourceMappingURL=PromptSchemaToolMetadataCandidateBuilder.d.ts.map