import { type ArtifactPin, type DecisionBinding, type DecisionDefinition, type DecisionResult, type DecisionRuleset, type DecisionUsage, type RulesetResult } from './types.js'; import { type DecisionLifecyclePolicy, type DecisionLifecycleReference, type DecisionLifecycleReferenceState, type DecisionLifecycleStore } from './lifecycle.js'; import { type QualificationIntegrityMetadata, type QualificationReleaseRecord } from './qualification/release.js'; export declare const DECISION_FEATURE_EXPORT_VERSION: "decision-feature-export/v1"; export declare const DECISION_FEATURE_SET_KIND: "DecisionFeatureSet"; export declare const DECISION_FEATURE_OBSERVATION_KIND: "DecisionFeatureObservation"; export declare const DECISION_FEATURE_EXPORT_MANIFEST_KIND: "DecisionFeatureExportManifest"; export type DecisionFeatureValueType = 'number' | 'string' | 'boolean'; export type DecisionFeaturePrimitive = 'choice' | 'ordinal-score' | 'truth-probability' | 'ruleset'; export type DecisionFeatureProvenanceKind = 'provider-native' | 'model-self-report' | 'adapter-one-hot' | 'derived' | 'calibrated' | 'missing'; export type DecisionFeatureMissingReason = 'not-applicable' | 'unsupported-old-field' | 'missing-evidence' | 'incompatible-primitive' | 'calibration-unavailable'; export type DecisionFeatureObservationState = 'present' | 'missing'; export type DecisionFeatureExportOperation = 'create' | 'list' | 'read' | 'export' | 'delete' | 'share'; export type DecisionFeatureExportFormat = 'jsonl' | 'csv'; export interface DecisionFeatureExportIdentity { tenantId: string; projectId: string; actorId: string; recipient: string; purpose: string; datasetPolicyId: string; accessScope: string; } export interface DecisionFeatureExportPolicy extends DecisionFeatureExportIdentity { operations: DecisionFeatureExportOperation[]; allowExternalDelivery: boolean; allowRawState: false; allowOutcomeLabels: false; reidentificationCanary?: string; } export interface DecisionFeatureSourcePins { ruleset: ArtifactPin; binding: ArtifactPin; definitions: Record; adapters: Record; calibration: Record; } export interface DecisionFeatureColumn { name: string; alias: string; primitive: DecisionFeaturePrimitive; valueType: DecisionFeatureValueType; nullable: boolean; order: number; domain?: string[]; source: DecisionFeatureProvenanceKind; uncertaintyProfile: string | null; calibrationRef: string | null; derivation: { algorithm: string; version: string; } | null; description: string; } export interface DecisionFeatureSet { schemaVersion: typeof DECISION_FEATURE_EXPORT_VERSION; kind: typeof DECISION_FEATURE_SET_KIND; metadata: { id: string; version: string; description: string; digest: `sha256:${string}`; }; spec: { pins: DecisionFeatureSourcePins; compatibleServedModels: Record; missingValuePolicy: { numeric: 'null'; categorical: 'null'; missingStateColumn: true; missingNeverZero: true; }; ordering: 'definition-pins-declared-order'; privacy: { classification: 'internal' | 'confidential' | 'restricted'; retentionMs: number; accessScope: string; exportPolicyId: string; deletion: 'erase' | 'tombstone'; lifecycleSurface: 'export'; }; columns: DecisionFeatureColumn[]; }; } export interface DecisionFeatureCell { value: number | string | boolean | null; state: DecisionFeatureObservationState; source: DecisionFeatureProvenanceKind; missingReason: DecisionFeatureMissingReason | null; calibrationRef: string | null; derivation: { algorithm: string; version: string; } | null; evidencePath: string; } export interface DecisionFeatureBatchOwnerReference { ownerId: string; runId: string; invocationId: string; groupId: string | null; ordinal: number | null; requestId: string | null; questionIds: string[]; usageDigest: `sha256:${string}` | null; } export interface DecisionFeatureBatchAccounting { scope: 'none' | 'ruleset-batch-request' | 'durable-batch-receipt'; reference: string | null; authoritativeUsage: null; owners: DecisionFeatureBatchOwnerReference[]; allocation: { kind: 'none' | 'estimated'; algorithm: string | null; algorithmVersion: string | null; usage: DecisionUsage | null; }; } export interface DecisionFeatureObservation { schemaVersion: typeof DECISION_FEATURE_EXPORT_VERSION; kind: typeof DECISION_FEATURE_OBSERVATION_KIND; featureSet: { id: string; version: string; digest: `sha256:${string}`; }; observationId: string; subjectId: string; eventTime: string; exportTime: string; sourceReceipt: { kind: 'DecisionResult' | 'RulesetResult'; runId: string; invocationId: string; alias: string | null; }; authorization: DecisionFeatureExportIdentity; lifecycle: { surface: 'export'; reference: string; tombstone: boolean; legalHold: boolean; expiresAtEpochMs: number; revokedAtEpochMs: number | null; deletedAtEpochMs: number | null; }; lineage: { ruleset: ArtifactPin; binding: ArtifactPin; decision: ArtifactPin | null; definition: ArtifactPin | null; }; trainServe: { featureSetDigest: `sha256:${string}`; servedModels: Record; calibrationRefs: Record; }; batchAccounting: DecisionFeatureBatchAccounting; features: Record; } export interface DecisionFeatureExportManifest { schemaVersion: typeof DECISION_FEATURE_EXPORT_VERSION; kind: typeof DECISION_FEATURE_EXPORT_MANIFEST_KIND; featureSet: { id: string; version: string; digest: `sha256:${string}`; }; format: DecisionFeatureExportFormat; rowCount: number; columnOrder: string[]; semanticContentDigest: `sha256:${string}`; payloadDigest: `sha256:${string}`; generatedAt: string; authorization: DecisionFeatureExportIdentity; lifecycle: { surface: 'export'; references: string[]; }; batchAccounting: DecisionFeatureManifestBatchAccounting[]; split?: { train: string[]; validation: string[]; test: string[]; seed: number; algorithm: string; }; evalIntegrity?: DecisionFeatureEvalIntegrity; } export type DecisionFeatureIntegrityDisposition = QualificationIntegrityMetadata['release_gate']['decision']; export interface DecisionFeatureEvalIntegrity { schemaVersion: 'decision-feature-eval-integrity/v1'; /** The #2037/#2048 qualification release record, carried unchanged. */ qualificationRelease: QualificationReleaseRecord; upstreamDisposition: DecisionFeatureIntegrityDisposition; disposition: DecisionFeatureIntegrityDisposition; reportRef: string; digest: `sha256:${string}`; } export interface GenerateDecisionFeatureSetInput { id: string; version: string; description: string; ruleset: DecisionRuleset; binding: DecisionBinding; definitions: Record; privacy: DecisionFeatureSet['spec']['privacy']; compatibleServedModels?: Record; calibration?: DecisionFeatureSourcePins['calibration']; } export interface DecisionFeatureObservationInput { featureSet: DecisionFeatureSet; result: DecisionResult | RulesetResult; definitions: Record; subjectId: string; eventTime: string; exportTime: string; authorization: DecisionFeatureExportPolicy; lifecycle?: { reference?: string; tombstone?: boolean; legalHold?: boolean; expiresAtEpochMs?: number; revokedAtEpochMs?: number | null; deletedAtEpochMs?: number | null; }; } export interface DecisionFeatureManifestBatchAccounting { scope: 'ruleset-batch-request' | 'durable-batch-receipt'; ownerId: string; reference: string; groupId: string | null; ordinal: number | null; requestId: string | null; questionIds: string[]; authoritativeUsage: DecisionUsage; rowAllocations: Array<{ observationId: string; kind: 'estimated' | 'none'; algorithm: string | null; algorithmVersion: string | null; usage: DecisionUsage | null; }>; } export interface DecisionFeatureBatchReceiptEvidence extends DecisionFeatureBatchOwnerReference { authoritativeUsage: DecisionUsage; } export interface DecisionFeatureExportSerializeOptions { generatedAt: string; evalIntegrity?: DecisionFeatureEvalIntegrity; batchAccountingEvidence?: DecisionFeatureBatchReceiptEvidence[]; } export interface DecisionFeatureSourceLifecycleStore extends DecisionLifecycleStore { register?: (subject: string, reference: { surface: 'export'; opaqueId: string; }) => Promise; resolveReference?: (reference: DecisionLifecycleReference) => Promise; } export interface DecisionFeatureExportStore { create(observation: DecisionFeatureObservation): Promise; read(identity: DecisionFeatureExportIdentity, observationId: string): Promise; list(identity: DecisionFeatureExportIdentity): Promise; updateLifecycle(identity: DecisionFeatureExportIdentity, observationId: string, patch: Partial): Promise; } export interface DecisionFeatureTrainServeContract { featureSet: { id: string; version: string; digest: `sha256:${string}`; }; columns: Array<{ name: string; valueType: DecisionFeatureValueType; nullable: boolean; domain?: string[]; }>; compatibleServedModels: Record; calibration: DecisionFeatureSourcePins['calibration']; } export declare class DecisionFeatureExportError extends Error { constructor(message: string); } export declare class MemoryDecisionFeatureExportStore implements DecisionFeatureExportStore { private readonly records; create(observation: DecisionFeatureObservation): Promise; read(identity: DecisionFeatureExportIdentity, observationId: string): Promise; list(identity: DecisionFeatureExportIdentity): Promise; updateLifecycle(identity: DecisionFeatureExportIdentity, observationId: string, patch: Partial): Promise; } export declare class DecisionFeatureExportService { private readonly featureSet; private readonly store; private readonly lifecyclePolicy?; private readonly lifecycleStore?; constructor(featureSet: DecisionFeatureSet, store: DecisionFeatureExportStore, lifecyclePolicy?: DecisionLifecyclePolicy | undefined, lifecycleStore?: DecisionFeatureSourceLifecycleStore | undefined); create(input: DecisionFeatureObservationInput): Promise; read(policy: DecisionFeatureExportPolicy, observationId: string, nowEpochMs: number): Promise; list(policy: DecisionFeatureExportPolicy, nowEpochMs: number): Promise; delete(policy: DecisionFeatureExportPolicy, observationId: string, nowEpochMs: number): Promise; revoke(policy: DecisionFeatureExportPolicy, observationId: string, nowEpochMs: number): Promise; share(policy: DecisionFeatureExportPolicy, observationId: string, nowEpochMs: number): Promise; exportJsonl(policy: DecisionFeatureExportPolicy, generatedAt: string, nowEpochMs: number, evalIntegrity?: DecisionFeatureEvalIntegrity): Promise<{ payload: string; manifest: DecisionFeatureExportManifest; }>; exportCsv(policy: DecisionFeatureExportPolicy, generatedAt: string, nowEpochMs: number, evalIntegrity?: DecisionFeatureEvalIntegrity): Promise<{ payload: string; manifest: DecisionFeatureExportManifest; }>; private assertHostLifecycleActive; private assertDeletionAllowed; } export declare function validateDecisionFeatureExportAuthorization(policy: DecisionFeatureExportPolicy, operation: DecisionFeatureExportOperation, lifecycle?: DecisionLifecyclePolicy): void; export declare function registerDecisionFeatureExportLifecycle(observation: DecisionFeatureObservation, store: DecisionFeatureSourceLifecycleStore): Promise; export declare function generateDecisionFeatureSet(input: GenerateDecisionFeatureSetInput): DecisionFeatureSet; export declare function decisionFeatureTrainServeContract(featureSet: DecisionFeatureSet): DecisionFeatureTrainServeContract; export declare function createDecisionFeatureObservation(input: DecisionFeatureObservationInput): DecisionFeatureObservation; export declare function validateDecisionFeatureObservation(featureSet: DecisionFeatureSet, observation: DecisionFeatureObservation): void; export declare function validateDecisionFeatureTrainServe(featureSet: DecisionFeatureSet, contract: DecisionFeatureTrainServeContract, observation: DecisionFeatureObservation, nowEpochMs: number): void; export declare function serializeDecisionFeatureJsonl(featureSet: DecisionFeatureSet, observations: readonly DecisionFeatureObservation[], authorization: DecisionFeatureExportPolicy, options: DecisionFeatureExportSerializeOptions | string): { payload: string; manifest: DecisionFeatureExportManifest; }; export declare function serializeDecisionFeatureCsv(featureSet: DecisionFeatureSet, observations: readonly DecisionFeatureObservation[], authorization: DecisionFeatureExportPolicy, options: DecisionFeatureExportSerializeOptions | string): { payload: string; manifest: DecisionFeatureExportManifest; }; export declare function loadDecisionFeatureCsv(featureSet: DecisionFeatureSet, payload: string): DecisionFeatureObservation[]; export declare function semanticFeatureContentDigest(observations: readonly DecisionFeatureObservation[]): `sha256:${string}`; export declare function deterministicFeatureSplit(observations: readonly DecisionFeatureObservation[], seed: number): { train: string[]; validation: string[]; test: string[]; seed: number; algorithm: string; }; export declare function buildDecisionFeatureEvalIntegrity(input: { qualificationRelease: QualificationReleaseRecord; reportRef: string; disposition?: DecisionFeatureIntegrityDisposition; }): DecisionFeatureEvalIntegrity; //# sourceMappingURL=feature-export.d.ts.map