@actuarial-ts/core 0.7.0 → 0.8.0

package/dist/customizationContracts.d.ts

@@ -0,0 +1,749 @@
+import type { JsonValue } from "./diagnosticDefinitions.js";
+export declare const HISTORICAL_DATASET_CONTRACT_VERSION: "actuarial-history/1";
+export declare const ANALYSIS_DEFINITION_CONTRACT_VERSION: "actuarial-analysis/1";
+export declare const ANALYSIS_RECIPE_CONTRACT_VERSION: "actuarial-recipe/1";
+export declare const ANALYSIS_RESULT_CONTRACT_VERSION: "actuarial-result/1";
+export declare const BOUNDED_REPLAY_CONTRACT_VERSION: "actuarial-bounded-replay/1";
+export declare const CUSTOMIZATION_CAPABILITIES: readonly ["history-snapshots", "history-changes", "irregular-periods", "exposure-earning", "typed-populations", "descriptive-statistics", "reserving-triangle-adapter", "bounded-execution", "shared-financial-terms", "recipes", "scenarios"];
+export type CustomizationCapability = (typeof CUSTOMIZATION_CAPABILITIES)[number];
+export interface CustomizationCapabilityFinding {
+    readonly code: "missing-prerequisite" | "unsupported-operation" | "incompatible-scope" | "resource-limit" | "ambiguous-attribution" | "incomplete-financial-population" | "incompatible-semantics" | "invalid-configuration";
+    readonly capability: CustomizationCapability;
+    readonly path: string;
+    readonly message: string;
+    readonly requiredFields?: readonly string[];
+}
+export type HistoricalScalar = string | number | boolean | null;
+export interface HistoricalSourceDefinition {
+    readonly namespace: string;
+    readonly artifactId: string;
+    readonly mappingVersion: string;
+}
+export interface HistoricalSourceLocation {
+    readonly artifactId: string;
+    readonly sourceFile?: string;
+    readonly sourceSheet?: string;
+    readonly sourceRow?: number;
+}
+export interface HistoricalRecordRevision {
+    readonly id: string;
+    readonly action: "upsert" | "delete";
+    readonly sequence?: number;
+    readonly correctedAt?: string;
+}
+export interface HistoricalRelationships {
+    readonly claimantIds?: readonly string[];
+    readonly occurrenceId?: string;
+    readonly policyIds?: readonly string[];
+    readonly coverageIds?: readonly string[];
+}
+export interface HistoricalObservationRecord {
+    readonly recordId: string;
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly grain: "claim-snapshot" | "claim-component-snapshot" | "transaction";
+    readonly componentId?: string;
+    readonly accidentDate?: string;
+    readonly reportDate?: string;
+    readonly evaluationDate?: string;
+    readonly effectiveDate?: string;
+    readonly measures: Readonly<Record<string, number | null>>;
+    readonly status?: string;
+    readonly dimensions?: Readonly<Record<string, HistoricalScalar | readonly HistoricalScalar[]>>;
+    readonly relationships?: HistoricalRelationships;
+    readonly completeness: "complete-snapshot" | "partial-snapshot" | "change-only";
+    readonly revision: HistoricalRecordRevision;
+    readonly source: HistoricalSourceLocation;
+}
+export interface HistoricalOpeningBalance {
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly asOfDate: string;
+    readonly measures: Readonly<Record<string, number>>;
+    readonly source: HistoricalSourceLocation;
+}
+export interface HistoricalDatasetInput {
+    readonly historyContractVersion: typeof HISTORICAL_DATASET_CONTRACT_VERSION;
+    readonly datasetId: string;
+    readonly historyMode: "full-snapshots" | "changes" | "mixed";
+    readonly revisionView: {
+        readonly kind: "as-known";
+        readonly knowledgeCutoff: string;
+    } | {
+        readonly kind: "restated";
+    };
+    readonly revisionPrecedence: "sequence" | "corrected-at";
+    readonly missingSnapshotRecord: "unknown" | "carried-forward";
+    readonly sources: readonly HistoricalSourceDefinition[];
+    readonly evaluationDates?: readonly string[];
+    readonly openingBalances?: readonly HistoricalOpeningBalance[];
+    readonly records: readonly HistoricalObservationRecord[];
+}
+export interface HistoricalRecordDisposition {
+    readonly sourceNamespace: string;
+    readonly recordId: string;
+    readonly revisionId: string;
+    readonly disposition: "selected" | "duplicate" | "superseded" | "after-knowledge-cutoff" | "deleted" | "conflict";
+}
+export interface PreparedHistoricalObservation {
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly evaluationDate: string;
+    readonly observationKind?: "observed-snapshot" | "carried-forward" | "reconstructed-from-changes";
+    readonly accidentDate: string | null;
+    readonly reportDate: string | null;
+    readonly measures: Readonly<Record<string, number | null>>;
+    readonly status: string | null;
+    readonly dimensions: Readonly<Record<string, HistoricalScalar | readonly HistoricalScalar[]>>;
+    readonly relationships: HistoricalRelationships;
+    readonly sources: readonly HistoricalSourceLocation[];
+}
+export interface PreparedHistoricalDataset {
+    readonly historyContractVersion: typeof HISTORICAL_DATASET_CONTRACT_VERSION;
+    readonly datasetId: string;
+    readonly datasetRevisionId: string;
+    /** Economic content and history-selection assumptions; excludes import locations. */
+    readonly calculationRevisionId: string;
+    /** Exact selected records, mappings, revisions, and source lineage. */
+    readonly lineageRevisionId: string;
+    readonly revisionView: HistoricalDatasetInput["revisionView"];
+    readonly observations: readonly PreparedHistoricalObservation[];
+    readonly dispositions: readonly HistoricalRecordDisposition[];
+    readonly reconciliation: {
+        readonly inputRecords: number;
+        readonly selectedRevisions: number;
+        readonly duplicateRecords: number;
+        readonly supersededRecords: number;
+        readonly deletedRecords: number;
+        readonly outputObservations: number;
+        /** Never summed across evaluations; keys are evaluation/effective dates. */
+        readonly inputMeasureTotalsByDate: Readonly<Record<string, Readonly<Record<string, number>>>>;
+        /** Never summed across evaluations. */
+        readonly outputMeasureTotalsByEvaluation: Readonly<Record<string, Readonly<Record<string, number>>>>;
+    };
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export type AnalysisPredicate = {
+    readonly op: "true";
+} | {
+    readonly op: "eq";
+    readonly dimensionId: string;
+    readonly value: HistoricalScalar;
+} | {
+    readonly op: "in";
+    readonly dimensionId: string;
+    readonly values: readonly HistoricalScalar[];
+} | {
+    readonly op: "range";
+    readonly dimensionId: string;
+    readonly minimum?: number | string;
+    readonly maximum?: number | string;
+    readonly includeMinimum: boolean;
+    readonly includeMaximum: boolean;
+} | {
+    readonly op: "missing";
+    readonly dimensionId: string;
+    readonly isMissing: boolean;
+} | {
+    readonly op: "and" | "or";
+    readonly terms: readonly AnalysisPredicate[];
+} | {
+    readonly op: "not";
+    readonly term: AnalysisPredicate;
+};
+export interface AnalysisScopeDefinition {
+    readonly id: string;
+    readonly subject: "claim" | "claimant" | "occurrence" | "policy" | "coverage";
+    readonly predicate: AnalysisPredicate;
+    readonly classification: {
+        readonly kind: "as-observed";
+    } | {
+        readonly kind: "latest-as-of-analysis";
+        readonly asOfDate: string;
+    } | {
+        readonly kind: "frozen-cohort";
+        readonly asOfDate: string;
+    };
+}
+export type AnalysisPredicateOutcome = "match" | "no-match" | "unknown";
+export interface AnalysisPopulationMembership {
+    readonly scopeId: string;
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly evaluationDate: string;
+    readonly outcome: AnalysisPredicateOutcome;
+    readonly classificationDate: string;
+    readonly finding: CustomizationCapabilityFinding | null;
+}
+export interface ExposureScopeDefinition {
+    readonly id: string;
+    readonly populationKeys: readonly string[];
+    readonly timeBasis: "interval" | "point-in-time" | "already-earned";
+    readonly reportingFilterEffect: "none" | "matching-exposure-dimensions";
+    /** Defaults to origin-static for backward-compatible authored definitions. */
+    readonly valuationSelection?: "origin-static" | "exact" | "latest-on-or-before";
+}
+export interface PolicyCoveragePeriod {
+    readonly id: string;
+    readonly label: string;
+    readonly scope: Readonly<Record<string, HistoricalScalar>>;
+    /** Start-inclusive Gregorian date. */
+    readonly startDate: string;
+    /** End-exclusive Gregorian date. */
+    readonly endDate: string;
+    readonly revisionId: string;
+}
+export type AnalysisOriginBasis = "accident" | "report" | "policy";
+export type AnalysisComparisonClock = "common-evaluation-date" | "since-period-start" | "since-period-end" | "matched-accident-cohorts";
+export interface AnalysisPeriodDefinition {
+    readonly originBasis: AnalysisOriginBasis;
+    readonly grouping: {
+        readonly kind: "calendar";
+        readonly cadence: "month" | "quarter" | "year";
+    } | {
+        readonly kind: "fiscal";
+        readonly cadence: "quarter" | "year";
+        readonly startMonth: number;
+    } | {
+        readonly kind: "policy-schedule";
+        readonly periodIds: readonly string[];
+    };
+    readonly comparisonClock: AnalysisComparisonClock;
+    readonly ageConvention: "exact-days" | "calendar-months";
+    readonly observationSelection: "exact" | "latest-on-or-before";
+}
+export interface PolicyPeriodAssignment {
+    readonly status: "assigned" | "unavailable" | "ambiguous";
+    readonly period: PolicyCoveragePeriod | null;
+    readonly candidates: readonly string[];
+    readonly finding: CustomizationCapabilityFinding | null;
+}
+export interface AnalysisOriginAssignment {
+    readonly status: "assigned" | "unavailable" | "ambiguous";
+    readonly originId: string | null;
+    readonly label: string | null;
+    readonly period: PolicyCoveragePeriod | null;
+    readonly finding: CustomizationCapabilityFinding | null;
+}
+export interface AnalysisComparisonCoordinate {
+    readonly status: "available" | "unavailable";
+    readonly clock: AnalysisComparisonClock;
+    readonly evaluationDate: string;
+    readonly age: number | null;
+    readonly ageUnit: "day" | "month" | null;
+    readonly finding: CustomizationCapabilityFinding | null;
+}
+export interface MatchedAccidentCohort {
+    readonly periodId: string;
+    readonly startOffsetDays: number;
+    readonly endOffsetDays: number;
+    readonly observationKeys: readonly string[];
+}
+export interface ExposureMeasureDefinitionV1 {
+    readonly id: string;
+    readonly unit: string;
+    readonly sourceMeaning: "already-earned" | "written-over-interval" | "flow-over-interval" | "point-in-time";
+    readonly earning: {
+        readonly kind: "supplied";
+    } | {
+        readonly kind: "uniform-daily";
+        readonly dayCount: "actual-days";
+    } | {
+        readonly kind: "weighted";
+        readonly scheduleId: string;
+    };
+    readonly allocation: {
+        readonly kind: "exact-match";
+    } | {
+        readonly kind: "time-overlap";
+    } | {
+        readonly kind: "supplied-weights";
+        readonly weightMeasureId: string;
+    };
+    readonly scopeId: string;
+}
+export interface CustomizationExposureObservation {
+    readonly id: string;
+    readonly measureId: string;
+    readonly value: number | null;
+    readonly startDate?: string;
+    readonly endDate?: string;
+    readonly pointDate?: string;
+    readonly evaluationDate?: string;
+    readonly dimensions: Readonly<Record<string, HistoricalScalar>>;
+    readonly revisionId: string;
+    /** Optional revision ordering metadata. Omitted metadata denotes one immutable revision. */
+    readonly revision?: {
+        readonly action: "upsert" | "delete";
+        readonly sequence?: number;
+        readonly correctedAt?: string;
+    };
+    readonly source: HistoricalSourceLocation;
+}
+export interface ExposureLevelSchedule {
+    readonly id: string;
+    readonly measureId: string;
+    readonly startDate: string;
+    readonly endDate: string;
+    /** Additive flow level per civil day at inception. */
+    readonly initialDailyLevel: number;
+    readonly movements: readonly ({
+        readonly id: string;
+        readonly effectiveDate: string;
+        readonly kind: "set-daily-level";
+        readonly dailyLevel: number;
+    } | {
+        readonly id: string;
+        readonly effectiveDate: string;
+        readonly kind: "cancel";
+    })[];
+    readonly dimensions: Readonly<Record<string, HistoricalScalar>>;
+    readonly evaluationDate?: string;
+    readonly revisionId: string;
+    readonly source: HistoricalSourceLocation;
+}
+export interface ExposureLevelScheduleResult {
+    readonly status: "available" | "unavailable";
+    readonly observations: readonly CustomizationExposureObservation[];
+    readonly totalValue: number | null;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface ExposureRevisionSelection {
+    readonly revisionView: {
+        readonly kind: "as-known";
+        readonly knowledgeCutoff: string;
+    } | {
+        readonly kind: "restated";
+    };
+    readonly revisionPrecedence: "sequence" | "corrected-at";
+}
+export interface ExposureRevisionDisposition {
+    readonly observationId: string;
+    readonly evaluationDate?: string;
+    readonly revisionId: string;
+    readonly disposition: "selected" | "duplicate" | "superseded" | "after-knowledge-cutoff" | "deleted" | "conflict";
+}
+export interface ExposureValuationSelection {
+    readonly observations: readonly CustomizationExposureObservation[];
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface SelectedExposureRevisions {
+    readonly observations: readonly CustomizationExposureObservation[];
+    readonly dispositions: readonly ExposureRevisionDisposition[];
+    readonly calculationRevisionId: string;
+    readonly lineageRevisionId: string;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface ExposureAllocationTarget {
+    readonly id: string;
+    readonly startDate: string;
+    readonly endDate: string;
+    readonly dimensions: Readonly<Record<string, HistoricalScalar>>;
+    readonly weights?: Readonly<Record<string, number>>;
+}
+export interface EarnedExposureAllocation {
+    readonly sourceObservationId: string;
+    readonly targetId: string;
+    readonly value: number;
+    readonly method: "exact-match" | "uniform-daily" | "weighted-schedule" | "time-overlap" | "supplied-weights";
+    readonly overlapDays: number | null;
+}
+export interface ExposureAllocationResult {
+    readonly measureId: string;
+    readonly sourceValue: number | null;
+    readonly allocations: readonly EarnedExposureAllocation[];
+    readonly allocatedValue: number;
+    readonly unallocatedValue: number | null;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export type AnalysisStatisticDefinition = {
+    readonly kind: "sum";
+    readonly measureId: string;
+} | {
+    readonly kind: "ratio";
+    readonly numeratorMeasureId: string;
+    readonly denominatorMeasureId: string;
+    readonly scale: number;
+    readonly denominatorRule: "positive" | "nonzero";
+} | {
+    readonly kind: "distinct-count";
+    readonly entity: "claim" | "claimant" | "occurrence" | "policy" | "coverage";
+} | {
+    readonly kind: "weighted-mean";
+    readonly measureId: string;
+    readonly weightMeasureId: string;
+} | {
+    readonly kind: "minimum" | "maximum";
+    readonly measureId: string;
+} | {
+    readonly kind: "quantile";
+    readonly measureId: string;
+    readonly probability: number;
+    readonly method: "hf-type-7";
+} | {
+    readonly kind: "duration";
+    readonly start: "accident-date" | "report-date";
+    readonly end: "report-date" | "closed-date" | "evaluation-date";
+    readonly unit: "days";
+    readonly population: "all-with-observed-endpoint" | "closed-only";
+} | {
+    /** Censoring-adjusted duration quantile using the Kaplan-Meier product-limit estimator. */
+    readonly kind: "survival-quantile";
+    readonly start: "accident-date" | "report-date";
+    readonly event: "closed-date";
+    readonly censor: "evaluation-date";
+    readonly unit: "days";
+    readonly probability: number;
+    readonly method: "kaplan-meier-product-limit";
+};
+export interface AnalysisMeasureDefinitionV1 {
+    readonly id: string;
+    readonly unit: string;
+    readonly developmentSemantics: "cumulative" | "incremental" | "point-in-time";
+    readonly statistic: AnalysisStatisticDefinition;
+    readonly populationScopeId: string;
+    readonly condition?: AnalysisPredicate;
+}
+export type AnalysisObservationSelection = {
+    readonly kind: "evaluation-date";
+    readonly evaluationDate: string;
+    readonly observationSelection: "exact" | "latest-on-or-before";
+} | {
+    readonly kind: "all-observations";
+};
+export interface AnalysisStatisticResult {
+    readonly measureId: string;
+    readonly unit: string;
+    readonly value: number | null;
+    readonly status: "available" | "unavailable";
+    readonly contributingObservations: number;
+    readonly excludedObservations: number;
+    readonly exact: true;
+    readonly numerator: number | null;
+    readonly denominator: number | null;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export type FinancialTermDefinition = {
+    readonly kind: "claim-layer" | "occurrence-layer";
+    readonly id: string;
+    readonly measureId: string;
+    readonly attachment: number;
+    readonly limit: number | null;
+    readonly allocation: "proportional";
+} | {
+    readonly kind: "policy-aggregate";
+    readonly id: string;
+    readonly measureId: string;
+    readonly deductible: number;
+    readonly limit: number | null;
+    readonly allocation: "proportional" | "chronological";
+};
+export interface FinancialTermScheduleEntry {
+    readonly id: string;
+    readonly termIds: readonly string[];
+    readonly effectiveStart: string;
+    readonly effectiveEnd: string;
+    readonly policyIds?: readonly string[];
+    readonly coverageIds?: readonly string[];
+    readonly priority: number;
+}
+export interface FinancialTermScheduleResolution {
+    readonly status: "resolved" | "unavailable" | "ambiguous";
+    readonly entryId: string | null;
+    readonly termIds: readonly string[];
+    readonly finding: CustomizationCapabilityFinding | null;
+}
+export interface FinancialClaimStageResult {
+    readonly termId: string;
+    readonly groupId: string;
+    readonly inputAmount: number;
+    readonly outputAmount: number;
+    readonly removedAmount: number;
+}
+export interface FinancialClaimAllocationResult {
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly reported: boolean;
+    readonly inputAmount: number;
+    readonly outputAmount: number;
+    readonly stages: readonly FinancialClaimStageResult[];
+}
+export interface FinancialTermApplicationResult {
+    readonly status: "available" | "unavailable";
+    readonly calculationIdentity: string;
+    readonly inputTotal: number | null;
+    readonly outputTotal: number | null;
+    readonly claims: readonly FinancialClaimAllocationResult[];
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export type FinancialAmountAdjustment = {
+    readonly kind: "scale";
+    readonly id: string;
+    readonly purpose: "trend" | "index";
+    readonly factor: number;
+} | {
+    readonly kind: "currency";
+    readonly id: string;
+    readonly fromUnit: string;
+    readonly toUnit: string;
+    readonly rate: number;
+    readonly rateDate: string;
+} | {
+    readonly kind: "include-expense" | "exclude-expense";
+    readonly id: string;
+    readonly expenseMeasureId: string;
+} | {
+    readonly kind: "net-recovery";
+    readonly id: string;
+    readonly recoveryMeasureId: string;
+};
+export type FinancialPipelineStage = {
+    readonly kind: "adjustment";
+    readonly adjustment: FinancialAmountAdjustment;
+} | {
+    readonly kind: "terms";
+    readonly id: string;
+    readonly terms: readonly FinancialTermDefinition[];
+};
+export interface FinancialPipelineClaimStage {
+    readonly stageId: string;
+    readonly stageKind: "adjustment" | "terms";
+    readonly inputAmount: number;
+    readonly outputAmount: number;
+}
+export interface FinancialPipelineClaimResult {
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly inputAmount: number;
+    readonly outputAmount: number;
+    readonly stages: readonly FinancialPipelineClaimStage[];
+}
+export interface FinancialPipelineResult {
+    readonly status: "available" | "unavailable";
+    readonly inputUnit: string;
+    readonly outputUnit: string;
+    readonly calculationIdentity: string;
+    readonly claims: readonly FinancialPipelineClaimResult[];
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface AnalysisDefinition {
+    readonly analysisContractVersion: typeof ANALYSIS_DEFINITION_CONTRACT_VERSION;
+    readonly id: string;
+    readonly version: string;
+    readonly dimensions: readonly AnalysisDimensionDefinition[];
+    readonly scopes: {
+        readonly financial: AnalysisScopeDefinition;
+        readonly reporting: AnalysisScopeDefinition;
+        readonly exposure: readonly ExposureScopeDefinition[];
+    };
+    readonly policySchedule: readonly PolicyCoveragePeriod[];
+    readonly period: AnalysisPeriodDefinition;
+    readonly exposures: readonly ExposureMeasureDefinitionV1[];
+    readonly measures: readonly AnalysisMeasureDefinitionV1[];
+    readonly financialTerms: readonly FinancialTermDefinition[];
+    readonly financialAdjustments?: readonly FinancialAmountAdjustment[];
+}
+export interface AnalysisDimensionDefinition {
+    readonly id: string;
+    readonly type: "string" | "number" | "boolean" | "date" | "entity-reference";
+    readonly multiple: boolean;
+}
+export type AnalysisClassificationDefinition = {
+    readonly kind: "numeric-bands";
+    readonly id: string;
+    readonly dimensionId: string;
+    readonly groups: readonly {
+        readonly id: string;
+        readonly minimum?: number;
+        readonly maximum?: number;
+        readonly includeMinimum: boolean;
+        readonly includeMaximum: boolean;
+    }[];
+    readonly overlapPolicy: "reject" | "allow";
+    readonly gapPolicy: "unclassified" | "reject";
+} | {
+    readonly kind: "lookup";
+    readonly id: string;
+    readonly dimensionId: string;
+    readonly entries: readonly {
+        readonly value: HistoricalScalar;
+        readonly groupId: string;
+    }[];
+    readonly unmappedPolicy: "unclassified" | "reject";
+} | {
+    readonly kind: "hierarchy";
+    readonly id: string;
+    readonly dimensionId: string;
+    readonly entries: readonly {
+        readonly value: HistoricalScalar;
+        readonly groupIds: readonly string[];
+    }[];
+    readonly unmappedPolicy: "unclassified" | "reject";
+} | {
+    readonly kind: "rules";
+    readonly id: string;
+    readonly groups: readonly {
+        readonly id: string;
+        readonly predicate: AnalysisPredicate;
+    }[];
+    readonly overlapPolicy: "reject" | "allow";
+    readonly gapPolicy: "unclassified" | "reject";
+};
+export interface AnalysisClassificationResult {
+    readonly classificationId: string;
+    readonly groupIds: readonly string[];
+    readonly status: "classified" | "unclassified" | "unavailable";
+    readonly overlapping: boolean;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface AnalysisClassifiedStatisticResult {
+    readonly classificationId: string;
+    readonly groups: readonly {
+        readonly groupId: string;
+        readonly result: AnalysisStatisticResult;
+    }[];
+    /** Computed once from the underlying selected population, never from group results. */
+    readonly portfolio: AnalysisStatisticResult;
+    readonly overlapDetected: boolean;
+    readonly additiveGroupSumValid: boolean;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface ClaimStatusTransition {
+    readonly sourceNamespace: string;
+    readonly claimId: string;
+    readonly fromStatus: string | null;
+    readonly toStatus: string | null;
+    readonly observedAt: string;
+    readonly kind: "opened" | "closed" | "reopened" | "other";
+    /** Snapshot input proves only that the transition occurred between observations. */
+    readonly observationPrecision: "between-snapshots";
+}
+export type AnalysisRecipeStep = {
+    readonly kind: "prepare-history";
+    readonly historyContractId: string;
+} | {
+    readonly kind: "assign-periods";
+    readonly analysisDefinitionId: string;
+} | {
+    readonly kind: "earn-exposure";
+    readonly exposureMeasureIds: readonly string[];
+} | {
+    readonly kind: "apply-financial-terms";
+    readonly termIds: readonly string[];
+} | {
+    readonly kind: "apply-financial-pipeline";
+    readonly amountMeasureId: string;
+    readonly stageIds: readonly string[];
+} | {
+    readonly kind: "calculate";
+    readonly measureIds: readonly string[];
+} | {
+    readonly kind: "adapt-diagnostics";
+    readonly diagnosticDefinitionId: string;
+};
+export interface AnalysisRecipe {
+    readonly recipeContractVersion: typeof ANALYSIS_RECIPE_CONTRACT_VERSION;
+    readonly id: string;
+    readonly version: string;
+    readonly analysisDefinitionId: string;
+    readonly steps: readonly AnalysisRecipeStep[];
+    readonly requiredCapabilities: readonly CustomizationCapability[];
+    readonly parameters: Readonly<Record<string, JsonValue>>;
+}
+export interface AnalysisResultValue {
+    readonly measureId: string;
+    readonly unit: string;
+    readonly coordinates: Readonly<Record<string, HistoricalScalar>>;
+    readonly value: number | null;
+    readonly status: "available" | "unavailable";
+    readonly contributingObservations: number;
+    readonly excludedObservations: number;
+    readonly exact: true;
+    readonly numerator: number | null;
+    readonly denominator: number | null;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export interface AnalysisResult {
+    readonly resultContractVersion: typeof ANALYSIS_RESULT_CONTRACT_VERSION;
+    readonly datasetRevisionId: string;
+    readonly analysisDefinitionId: string;
+    readonly recipeId: string;
+    readonly calculationIdentity: string;
+    readonly lineageIdentity: string;
+    readonly values: readonly AnalysisResultValue[];
+}
+export interface AnalysisTriangleAdapterResult {
+    readonly status: "available" | "unavailable";
+    readonly triangle: import("./types.js").Triangle | null;
+    readonly findings: readonly CustomizationCapabilityFinding[];
+}
+export type AnalysisScenarioChange = {
+    readonly kind: "financial-term-limit";
+    readonly termId: string;
+    readonly limit: number | null;
+} | {
+    readonly kind: "financial-term-attachment";
+    readonly termId: string;
+    readonly amount: number;
+} | {
+    readonly kind: "reporting-predicate";
+    readonly predicate: AnalysisPredicate;
+};
+export interface AnalysisScenario {
+    readonly id: string;
+    readonly changes: readonly AnalysisScenarioChange[];
+}
+export interface AnalysisScenarioGridOption {
+    readonly id: string;
+    /** Null represents the baseline value for this axis. */
+    readonly change: AnalysisScenarioChange | null;
+}
+export interface AnalysisScenarioGridAxis {
+    readonly id: string;
+    readonly options: readonly AnalysisScenarioGridOption[];
+}
+export interface AnalysisScenarioGrid {
+    readonly id: string;
+    readonly axes: readonly AnalysisScenarioGridAxis[];
+}
+export interface AnalysisScenarioDifference {
+    readonly measureId: string;
+    readonly unit: string;
+    readonly coordinates: Readonly<Record<string, HistoricalScalar>>;
+    readonly baselineValue: number | null;
+    readonly scenarioValue: number | null;
+    readonly absoluteDifference: number | null;
+    readonly percentageDifference: number | null;
+}
+export interface AnalysisScenarioRun {
+    readonly scenarioId: string;
+    readonly result: AnalysisResult;
+    readonly differences: readonly AnalysisScenarioDifference[];
+}
+export interface AnalysisRollForward {
+    readonly kind: "roll-forward";
+    readonly priorEvaluationDate: string;
+    readonly currentEvaluationDate: string;
+    readonly priorResult: AnalysisResult;
+    readonly currentResult: AnalysisResult;
+    readonly differences: readonly AnalysisScenarioDifference[];
+}
+export interface AnalysisScenarioBridgeStep {
+    readonly scenarioId: string;
+    readonly fromCalculationIdentity: string;
+    readonly result: AnalysisResult;
+    readonly differences: readonly AnalysisScenarioDifference[];
+}
+export interface AnalysisResultCache {
+    get(dependencyIdentity: string): AnalysisResult | undefined;
+    set(dependencyIdentity: string, result: AnalysisResult): void;
+}
+export interface CustomizationResourceLimits {
+    readonly maximumInputRecords: number;
+    readonly maximumInMemoryBytes: number;
+    readonly maximumRecordBytes: number;
+    readonly maximumPartitionRecords: number;
+    readonly maximumOutputValues: number;
+    readonly maximumActiveScenarios: number;
+}
+//# sourceMappingURL=customizationContracts.d.ts.map