@absolutejs/absolute 0.19.0-beta.643 → 0.19.0-beta.645

package/dist/types/ai.d.ts

@@ -1,3 +1,4 @@
+import type { SessionStore } from './session';
 export type AIUsage = {
     inputTokens: number;
     outputTokens: number;
@@ -141,6 +142,7 @@ export type RAGSectionRetrievalDiagnostic = {
     queryTransformProvider?: string;
     queryTransformLabel?: string;
     queryTransformReason?: string;
+    evidenceReconcileApplied?: boolean;
     rerankApplied?: boolean;
     sourceBalanceApplied?: boolean;
     scoreThresholdApplied?: boolean;
@@ -603,6 +605,11 @@ export type RAGHybridSearchOptions = {
     fusionConstant?: number;
     lexicalWeight?: number;
     vectorWeight?: number;
+    nativeQueryProfile?: RAGNativeQueryProfile;
+    nativeCandidateLimit?: number;
+    nativeMaxBackfills?: number;
+    nativeMinResults?: number;
+    nativeFillPolicy?: 'strict_topk' | 'satisfy_min_results';
 };
 export type RAGUpsertInput = {
     chunks: RAGDocumentChunk[];
@@ -931,7 +938,7 @@ export type RAGCollectionSearchParams = {
     model?: string;
     signal?: AbortSignal;
 };
-export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'routing' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'diversity' | 'source_balance' | 'score_filter' | 'finalize';
+export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'routing' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'diversity' | 'source_balance' | 'evidence_reconcile' | 'score_filter' | 'finalize';
 export type RAGRetrievalTraceStep = {
     stage: RAGRetrievalTraceStage;
     label: string;
@@ -2296,6 +2303,8 @@ export type RAGEvaluationRunDiff = {
         averageLexicalCount: number;
         averageCandidateTopK: number;
         averageLexicalTopK: number;
+        officeEvidenceReconcileCasesDelta: number;
+        pdfEvidenceReconcileCasesDelta: number;
         stageCounts: Partial<Record<RAGRetrievalTraceStage, number>>;
     };
 };
@@ -2571,6 +2580,58 @@ export type RAGEvaluationSuiteSnapshotHistoryPresentation = {
     rows: RAGLabelValueRow[];
     snapshots: RAGEvaluationSuiteSnapshotPresentation[];
 };
+export type RAGAdaptiveNativePlannerBenchmarkRuntime = {
+    suiteId: string;
+    suiteLabel: string;
+    groupKey?: string;
+    corpusGroupKey?: string;
+    latestFixtureVariant?: string;
+    fixtureVariants?: string[];
+    recommendedGroupKey?: string;
+    recommendedTags?: string[];
+    latestRun?: RAGRetrievalComparisonRun;
+    recentRuns?: RAGRetrievalComparisonRun[];
+    historyPresentation?: RAGRetrievalReleaseGroupHistoryPresentation;
+    snapshotHistory?: RAGEvaluationSuiteSnapshotHistory;
+    snapshotHistoryPresentation?: RAGEvaluationSuiteSnapshotHistoryPresentation;
+};
+export type RAGNativeBackendComparisonBenchmarkRuntime = RAGAdaptiveNativePlannerBenchmarkRuntime;
+export type RAGAdaptiveNativePlannerBenchmarkResponse = {
+    ok: boolean;
+    suite?: RAGEvaluationSuite;
+    comparison?: RAGRetrievalComparison;
+    groupKey?: string;
+    corpusGroupKey?: string;
+    latestFixtureVariant?: string;
+    fixtureVariants?: string[];
+    latestRun?: RAGRetrievalComparisonRun;
+    recentRuns?: RAGRetrievalComparisonRun[];
+    historyPresentation?: RAGRetrievalReleaseGroupHistoryPresentation;
+    snapshotHistory?: RAGEvaluationSuiteSnapshotHistory;
+    snapshotHistoryPresentation?: RAGEvaluationSuiteSnapshotHistoryPresentation;
+    error?: string;
+};
+export type RAGNativeBackendComparisonBenchmarkResponse = RAGAdaptiveNativePlannerBenchmarkResponse;
+export type RAGAdaptiveNativePlannerBenchmarkSnapshotResponse = {
+    ok: boolean;
+    suite?: RAGEvaluationSuite;
+    snapshot?: RAGEvaluationSuiteSnapshot;
+    snapshotHistory?: RAGEvaluationSuiteSnapshotHistory;
+    snapshotHistoryPresentation?: RAGEvaluationSuiteSnapshotHistoryPresentation;
+    error?: string;
+};
+export type RAGNativeBackendComparisonBenchmarkSnapshotResponse = RAGAdaptiveNativePlannerBenchmarkSnapshotResponse;
+export type RAGRetrievalReleaseHistoryRunPresentation = {
+    runId: string;
+    label: string;
+    summary: string;
+    rows: RAGLabelValueRow[];
+};
+export type RAGRetrievalReleaseGroupHistoryPresentation = {
+    summary: string;
+    rows: RAGLabelValueRow[];
+    recentRuns: RAGRetrievalReleaseHistoryRunPresentation[];
+};
 export type RAGAnswerGroundingHistoryPresentation = {
     summary: string;
     rows: RAGLabelValueRow[];
@@ -2686,6 +2747,10 @@ export type RAGRetrievalTraceComparisonSummary = {
     multiVectorVectorHitCases: number;
     multiVectorLexicalHitCases: number;
     multiVectorCollapsedCases: number;
+    officeEvidenceReconcileCases: number;
+    pdfEvidenceReconcileCases: number;
+    runtimeCandidateBudgetExhaustedCases: number;
+    runtimeUnderfilledTopKCases: number;
     averageFinalCount: number;
     averageVectorCount: number;
     averageLexicalCount: number;
@@ -2891,6 +2956,10 @@ export type RAGRetrievalTraceComparisonSummaryDiff = {
     multiVectorVectorHitCasesDelta: number;
     multiVectorLexicalHitCasesDelta: number;
     multiVectorCollapsedCasesDelta: number;
+    officeEvidenceReconcileCasesDelta: number;
+    pdfEvidenceReconcileCasesDelta: number;
+    runtimeCandidateBudgetExhaustedCasesDelta: number;
+    runtimeUnderfilledTopKCasesDelta: number;
     modeDelta: RAGTraceSummaryListDelta<RAGHybridRetrievalMode>;
     sourceBalanceStrategyDelta: RAGTraceSummaryListDelta<RAGSourceBalanceStrategy>;
     stageCountsDelta: Partial<Record<RAGRetrievalTraceStage, RAGTraceSummaryStageCountsDelta>>;
@@ -2937,6 +3006,9 @@ export type RAGRetrievalComparisonSummary = {
     bestByMultivectorCollapsedCases?: string;
     bestByMultivectorLexicalHitCases?: string;
     bestByMultivectorVectorHitCases?: string;
+    bestByEvidenceReconcileCases?: string;
+    bestByLowestRuntimeCandidateBudgetExhaustedCases?: string;
+    bestByLowestRuntimeUnderfilledTopKCases?: string;
 };
 export type RAGRetrievalComparison = {
     suiteId: string;
@@ -2954,6 +3026,7 @@ export type RAGRetrievalComparisonCandidateInput = {
 };
 export type RAGRetrievalComparisonRequest = RAGEvaluationInput & {
     retrievals: RAGRetrievalComparisonCandidateInput[];
+    suiteId?: string;
     label?: string;
     persistRun?: boolean;
     baselineRetrievalId?: string;
@@ -2990,6 +3063,9 @@ export type RAGRetrievalComparisonDecisionDelta = {
     multiVectorCollapsedCasesDelta?: number;
     multiVectorLexicalHitCasesDelta?: number;
     multiVectorVectorHitCasesDelta?: number;
+    evidenceReconcileCasesDelta?: number;
+    runtimeCandidateBudgetExhaustedCasesDelta?: number;
+    runtimeUnderfilledTopKCasesDelta?: number;
 };
 export type RAGRetrievalBaselineGatePolicy = {
     minPassingRateDelta?: number;
@@ -2998,6 +3074,9 @@ export type RAGRetrievalBaselineGatePolicy = {
     minMultiVectorCollapsedCasesDelta?: number;
     minMultiVectorLexicalHitCasesDelta?: number;
     minMultiVectorVectorHitCasesDelta?: number;
+    minEvidenceReconcileCasesDelta?: number;
+    maxRuntimeCandidateBudgetExhaustedCasesDelta?: number;
+    maxRuntimeUnderfilledTopKCasesDelta?: number;
     severity?: 'warn' | 'fail';
 };
 export type RAGRetrievalComparisonGateResult = {
@@ -3023,6 +3102,9 @@ export type RAGRetrievalComparisonDecisionSummary = {
     winnerByMultivectorCollapsedCases?: string;
     winnerByMultivectorLexicalHitCases?: string;
     winnerByMultivectorVectorHitCases?: string;
+    winnerByEvidenceReconcileCases?: string;
+    winnerByLowestRuntimeCandidateBudgetExhaustedCases?: string;
+    winnerByLowestRuntimeUnderfilledTopKCases?: string;
     baseline?: {
         retrievalId: string;
         label: string;
@@ -3032,6 +3114,9 @@ export type RAGRetrievalComparisonDecisionSummary = {
         multiVectorCollapsedCases?: number;
         multiVectorLexicalHitCases?: number;
         multiVectorVectorHitCases?: number;
+        evidenceReconcileCases?: number;
+        runtimeCandidateBudgetExhaustedCases?: number;
+        runtimeUnderfilledTopKCases?: number;
     };
     candidate?: {
         retrievalId: string;
@@ -3042,6 +3127,9 @@ export type RAGRetrievalComparisonDecisionSummary = {
         multiVectorCollapsedCases?: number;
         multiVectorLexicalHitCases?: number;
         multiVectorVectorHitCases?: number;
+        evidenceReconcileCases?: number;
+        runtimeCandidateBudgetExhaustedCases?: number;
+        runtimeUnderfilledTopKCases?: number;
     };
     delta?: RAGRetrievalComparisonDecisionDelta;
     gate?: RAGRetrievalComparisonGateResult;
@@ -3422,7 +3510,7 @@ export type RAGRetrievalIncidentRemediationBulkExecutionResponse = {
 export type RAGRetrievalReleaseGroupSummary = {
     corpusGroupKey?: string;
     groupKey: string;
-    classification?: 'general' | 'multivector';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     escalationSeverity: 'none' | 'info' | 'warning' | 'critical';
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
     recommendedActionReasons: string[];
@@ -3550,7 +3638,7 @@ export type RAGRetrievalReleaseLaneAuditSummary = {
 export type RAGRetrievalReleaseLaneRecommendationSummary = {
     corpusGroupKey?: string;
     groupKey: string;
-    classification?: 'general' | 'multivector';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
     recommendedActionReasons: string[];
@@ -3590,7 +3678,7 @@ export type RAGRetrievalReleaseLaneHandoffSummary = {
 };
 export type RAGRetrievalLanePromotionStateSummary = {
     groupKey: string;
-    classification?: 'general' | 'multivector';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     baselineRetrievalId?: string;
     candidateRetrievalId?: string;
@@ -3624,7 +3712,7 @@ export type RAGRetrievalReleaseIncidentRecord = {
     acknowledgedBy?: string;
     acknowledgementNotes?: string;
     notes?: string;
-    classification?: 'general' | 'multivector';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
 };
 export type RAGRetrievalLaneHandoffIncidentRecord = Omit<RAGRetrievalReleaseIncidentRecord, 'kind'> & {
     corpusGroupKey?: string;
@@ -3805,10 +3893,16 @@ export type RAGRetrievalIncidentRemediationStatusResponse = {
 export type RAGRetrievalIncidentClassificationSummary = {
     totalGeneralCount: number;
     totalMultiVectorCount: number;
+    totalRuntimeCount: number;
+    totalEvidenceCount: number;
     openGeneralCount: number;
     openMultiVectorCount: number;
+    openRuntimeCount: number;
+    openEvidenceCount: number;
     resolvedGeneralCount: number;
     resolvedMultiVectorCount: number;
+    resolvedRuntimeCount: number;
+    resolvedEvidenceCount: number;
 };
 export type RAGRetrievalReleaseEvent = {
     kind: 'incident_opened' | 'incident_resolved';
@@ -3913,6 +4007,9 @@ export type RAGRetrievalReleaseGroupHistoryResponse = {
     baselines?: RAGRetrievalBaselineRecord[];
     runs?: RAGRetrievalComparisonRun[];
     timeline?: RAGRetrievalReleaseTimelineSummary;
+    presentation?: RAGRetrievalReleaseGroupHistoryPresentation;
+    adaptiveNativePlannerBenchmark?: RAGAdaptiveNativePlannerBenchmarkRuntime;
+    nativeBackendComparisonBenchmark?: RAGNativeBackendComparisonBenchmarkRuntime;
     error?: string;
 };
 export type RAGRetrievalPromotionCandidateListResponse = {
@@ -3936,6 +4033,9 @@ export type RAGRetrievalComparisonLatestSummary = {
     bestByMultivectorCollapsedCases?: string;
     bestByMultivectorLexicalHitCases?: string;
     bestByMultivectorVectorHitCases?: string;
+    bestByEvidenceReconcileCases?: string;
+    bestByLowestRuntimeCandidateBudgetExhaustedCases?: string;
+    bestByLowestRuntimeUnderfilledTopKCases?: string;
     decisionSummary?: RAGRetrievalComparisonDecisionSummary;
     releaseVerdict?: RAGRetrievalReleaseVerdict;
 };
@@ -3957,12 +4057,14 @@ export type RAGRetrievalComparisonAlert = {
     candidateRetrievalId?: string;
     delta?: RAGRetrievalComparisonDecisionDelta;
     gate?: RAGRetrievalComparisonGateResult;
-    classification?: 'general' | 'multivector';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
 };
 export type RAGRetrievalComparisonRuntime = {
     configured: boolean;
     recentRuns?: RAGRetrievalComparisonRun[];
     latest?: RAGRetrievalComparisonLatestSummary;
+    adaptiveNativePlannerBenchmark?: RAGAdaptiveNativePlannerBenchmarkRuntime;
+    nativeBackendComparisonBenchmark?: RAGNativeBackendComparisonBenchmarkRuntime;
     stableWinnerByPassingRate?: RAGRetrievalComparisonWinnerTrend;
     alerts?: RAGRetrievalComparisonAlert[];
     activeBaselines?: RAGRetrievalBaselineRecord[];
@@ -4356,13 +4458,7 @@ export type AIWebSocket = {
     send(data: string): void;
     readyState: number;
 };
-export type AIConversationStore = {
-    get: (id: string) => Promise<AIConversation | undefined>;
-    getOrCreate: (id: string) => Promise<AIConversation>;
-    set: (id: string, conversation: AIConversation) => Promise<void>;
-    list: () => Promise<AIConversationSummary[]>;
-    remove: (id: string) => Promise<void>;
-};
+export type AIConversationStore = SessionStore<AIConversation, AIConversationSummary>;
 export type AIHTMXRenderConfig = {
     messageStart?: (input: {
         conversationId: string;
@@ -4428,6 +4524,10 @@ export type RAGHTMXWorkflowRenderConfig = {
         cases: RAGEvaluationCaseResult[];
         summary: RAGEvaluationSummary;
     }) => string;
+    adaptiveNativePlannerBenchmark?: (input: RAGAdaptiveNativePlannerBenchmarkResponse) => string;
+    nativeBackendComparisonBenchmark?: (input: RAGNativeBackendComparisonBenchmarkResponse) => string;
+    adaptiveNativePlannerBenchmarkSnapshot?: (input: RAGAdaptiveNativePlannerBenchmarkSnapshotResponse) => string;
+    nativeBackendComparisonBenchmarkSnapshot?: (input: RAGNativeBackendComparisonBenchmarkSnapshotResponse) => string;
     mutationResult?: (input: RAGMutationResponse) => string;
     emptyState?: (kind: 'documents' | 'searchResults' | 'chunkPreview' | 'status' | 'evaluation') => string;
     error?: (message: string) => string;
@@ -4468,6 +4568,7 @@ export type RAGChatPluginConfig = AIChatPluginConfig & {
     ragStore?: RAGVectorStore;
     collection?: RAGCollection;
     jobStateStore?: RAGJobStateStore;
+    evaluationSuiteSnapshotHistoryStore?: RAGEvaluationSuiteSnapshotHistoryStore;
     authorizeRAGAction?: RAGAuthorizationProvider;
     resolveRAGAccessScope?: RAGAccessScopeProvider;
     jobHistoryRetention?: RAGJobHistoryRetention;
@@ -4493,6 +4594,7 @@ export type RAGChatPluginConfig = AIChatPluginConfig & {
     retrievalReleasePoliciesByRolloutLabel?: Partial<Record<Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>, RAGRetrievalReleasePolicy>>;
     retrievalReleasePoliciesByGroupAndRolloutLabel?: Record<string, Partial<Record<Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>, RAGRetrievalReleasePolicy>>>;
     retrievalBaselineGatePoliciesByRolloutLabel?: Partial<Record<Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>, RAGRetrievalBaselineGatePolicy>>;
+    retrievalBaselineGatePoliciesByGroup?: Record<string, RAGRetrievalBaselineGatePolicy>;
     retrievalBaselineGatePoliciesByGroupAndRolloutLabel?: Record<string, Partial<Record<Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>, RAGRetrievalBaselineGatePolicy>>>;
     onRetrievalReleaseEvent?: (event: RAGRetrievalReleaseEvent) => void | Promise<void>;
     extractors?: RAGFileExtractor[];

package/dist/types/index.d.ts

@@ -14,5 +14,6 @@ export * from './tool';
 export * from './typeGuards';
 export * from './jsonLd';
 export * from './metadata';
+export * from './session';
 export * from './sitemap';
 export * from './websocket';

package/dist/types/session.d.ts

@@ -0,0 +1,16 @@
+export type SessionStore<TSession extends {
+    id: string;
+    createdAt: number;
+}, TSummary extends {
+    id: string;
+    createdAt: number;
+} = {
+    id: string;
+    createdAt: number;
+}> = {
+    get: (id: string) => Promise<TSession | undefined>;
+    getOrCreate: (id: string) => Promise<TSession>;
+    set: (id: string, value: TSession) => Promise<void>;
+    list: () => Promise<TSummary[]>;
+    remove: (id: string) => Promise<void>;
+};