import { type NolArtifactRef, type NolRuntimeBinding } from "../../schemas/nol.js"; import { type NolArtifactStore } from "./artifacts.js"; declare const SCHEMA: "omnius.nol.conditional-distribution.v1"; declare const RESULT: "omnius.nol.conditional-distribution-comparison.v1"; export declare const NOL_RAW_DISTRIBUTION_PROCESSING_DIGEST: string; /** The native producer must establish these facts. Parsing/hashing this record * establishes immutable metadata and artifact identity, never native authority. */ export interface NolConditionalDistribution { schema: typeof SCHEMA; observationDigest: string; coverage: "full_vocabulary"; values: "logits" | "log_probabilities" | "probabilities"; stage: "raw_model" | "processed_sampling"; processingDigest: string; vocabularySize: number; conditioning: { mode: "teacher_forced"; attentionMask: "causal_unpadded"; tokenizerDigest: string; vocabularyDigest: string; chatTemplateDigest: string; inputIds: NolArtifactRef; positionIds: NolArtifactRef; tokenEncoding: "u32_le"; inputTokenCount: number; promptTokenCount: number; /** Row r predicts the next token after exactly this many input IDs. * Its native computation position is prefixTokenCounts[r] - 1. */ prefixTokenCounts: number[]; }; source: { binding: NolRuntimeBinding; variantDigest: string; recipeDigest: string | null; computeDtype: "float16" | "bfloat16" | "float32" | "float64"; }; tensor: { artifact: NolArtifactRef; shape: [ number, number ]; dtype: "f32" | "f64"; encoding: "ieee754_le"; }; receipts: { source: NolArtifactRef; native: NolArtifactRef; hardware: NolArtifactRef; }; } export interface NolDistributionLimits { maxRows: number; maxVocabularySize: number; maxReadBytes: number; maxWorkingBytes: number; /** Scalar visits, including each normalization and metric pass. */ maxWorkUnits: number; maxDurationMs: number; /** Allowed absolute row mass/log-mass error before explicit renormalization. */ normalizationTolerance: number; maxAbsLogValue: number; } export type NolDistributionMeasure = { status: "finite"; value: number; } | { status: "positive_infinity"; reason: "candidate_zero_on_baseline_support"; }; export interface NolConditionalDistributionComparison { schema: typeof RESULT; comparisonDigest: string; scope: "same_runtime_intervention"; direction: "baseline_to_candidate"; units: "nats"; normalization: "validated_then_float64_row_renormalization"; numericPolicy: { arithmetic: "ieee754_float64"; probabilityUnderflow: "finite_log_support_preserved_small_mass_terms_rounded"; negativeRoundoffClamp: 1e-10; }; acceptanceAuthority: "none"; nativeObservationAuthorityVerified: false; baseline: NolConditionalDistribution; candidate: NolConditionalDistribution; conditioningDigest: string; limits: NolDistributionLimits; rows: Array<{ prefixTokenCount: number; computationPosition: number; positionId: number; baselineEntropy: NolDistributionMeasure; candidateEntropy: NolDistributionMeasure; crossEntropy: NolDistributionMeasure; kl: NolDistributionMeasure; baselineSupportSize: number; candidateSupportSize: number; }>; mean: { baselineEntropy: NolDistributionMeasure; candidateEntropy: NolDistributionMeasure; crossEntropy: NolDistributionMeasure; kl: NolDistributionMeasure; }; accounting: { verifiedArtifactBytes: number; peakWorkingBytesBound: number; scalarVisits: number; rowsCompared: number; completeVocabularyElementsPerRow: number; }; } export declare function sealNolConditionalDistribution(value: Omit): NolConditionalDistribution; export declare function parseNolConditionalDistribution(value: unknown): NolConditionalDistribution; /** Compares complete conditional distributions on identical forced prefixes. * Uses public rehashing CAS reads. All artifact bytes and worst-case collected * buffers/row workspaces are admitted before I/O. Rows are evaluated in bounded * incremental passes with cooperative cancellation; no tensor publication, * native observation receipt or scientific acceptance authority is created. */ export declare function compareNolConditionalDistributions(input: { baseline: NolConditionalDistribution; candidate: NolConditionalDistribution; artifacts: Pick; limits: NolDistributionLimits; signal?: AbortSignal; }): Promise; export {};