import { z } from 'zod'; import { type WriterProfile } from './writer-profile.js'; export declare const exemplarDescriptorSchema: z.ZodObject<{ sampleId: z.ZodString; profileId: z.ZodString; genre: z.ZodString; topicTags: z.ZodArray; styleTags: z.ZodArray; }, z.core.$strict>; declare const partitionSchema: z.ZodObject<{ version: z.ZodString; purpose: z.ZodEnum<{ development: "development"; "final-author": "final-author"; }>; developmentAuthorIds: z.ZodArray; finalAuthorIds: z.ZodArray; holdouts: z.ZodArray>; nearDuplicateThreshold: z.ZodNumber; duplicateMetric: z.ZodLiteral<"normalized-word-trigram-jaccard-v1">; }, z.core.$strict>; export type ExemplarDescriptor = z.infer; export type ExemplarPartition = z.infer; export declare const EXEMPLAR_STRATEGIES: readonly ["random", "style-varied", "length-matched", "topic-matched"]; export type ExemplarStrategy = typeof EXEMPLAR_STRATEGIES[number]; export interface ExemplarExclusion { sampleId: string; reason: 'cross-author' | 'unusable' | 'holdout' | 'near-holdout' | 'duplicate-enrollment' | 'stale-profile' | 'budget' | 'sample-limit'; } export interface ExemplarStore { schemaVersion: 1; profileId: string; profileFingerprint: string; fingerprint: string; descriptors: ExemplarDescriptor[]; partition: ExemplarPartition; enrollmentExclusions: ExemplarExclusion[]; } export interface ExemplarTokenizer { id: string; version: string; unit: 'tokens' | 'utf8-bytes'; measurement: 'exact' | 'upper-bound'; count(serializedData: string): number; } /** Byte budget, not an exact model token count. Transport/prompt overhead is outside this payload. */ export declare const UTF8_BYTE_BUDGET: ExemplarTokenizer; export interface ExemplarSelectionOptions { strategy: ExemplarStrategy; seed: string; maxSamples: number; budget: number; target?: { length: number; topicTags: string[]; }; tokenizer?: ExemplarTokenizer; } export interface SelectedExemplar { kind: 'example-data'; sampleId: string; sha256: string; text: string; } export interface ExemplarReceipt { schemaVersion: 1; strategy: ExemplarStrategy; strategyVersion: '1'; seed: string; profileId: string; profileVersion: string; profileRevision: number; cacheEpoch: number; storeFingerprint: string; partitionFingerprint: string; cacheKey: string; selections: Array<{ sampleId: string; sha256: string; reason: string; }>; exclusions: ExemplarExclusion[]; budget: { limit: number; used: number; unit: ExemplarTokenizer['unit']; measurement: ExemplarTokenizer['measurement']; tokenizerId: string; tokenizerVersion: string; }; requestedSamples: number; selectedSamples: number; fallback: boolean; diagnostics: string[]; qualityEvaluation: 'not-performed'; } export interface ExemplarSelection { examples: SelectedExemplar[]; serializedData: string; receipt: ExemplarReceipt; } /** A data-only store; enrollment never trains descriptors or reads another author's profile. */ export declare function createExemplarStore(input: WriterProfile, descriptorInput: ExemplarDescriptor[], partitionInput: ExemplarPartition): ExemplarStore; export declare function selectExemplars(input: WriterProfile, store: ExemplarStore, options: ExemplarSelectionOptions): ExemplarSelection; /** All strategies receive identical limits/counts/seed/target/tokenizer; no winner is inferred. */ export declare function runExemplarAblation(profile: WriterProfile, store: ExemplarStore, options: Omit & { sampleCounts: number[]; }): ExemplarReceipt[]; /** Declaration only: no learned retrieval loader/runner is enabled by this module. */ export interface LearnedExemplarPluginProposal { id: string; version: string; enabled: false; evidenceReview: string; costComparison: string; trainingPartition: 'development-only'; } export {}; //# sourceMappingURL=exemplar-selection.d.ts.map