@absolutejs/absolute 0.19.0-beta.644 → 0.19.0-beta.646

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>>;
     };
 };
@@ -2574,18 +2583,35 @@ export type RAGEvaluationSuiteSnapshotHistoryPresentation = {
 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;
@@ -2594,6 +2620,7 @@ export type RAGAdaptiveNativePlannerBenchmarkSnapshotResponse = {
     snapshotHistoryPresentation?: RAGEvaluationSuiteSnapshotHistoryPresentation;
     error?: string;
 };
+export type RAGNativeBackendComparisonBenchmarkSnapshotResponse = RAGAdaptiveNativePlannerBenchmarkSnapshotResponse;
 export type RAGRetrievalReleaseHistoryRunPresentation = {
     runId: string;
     label: string;
@@ -2720,6 +2747,8 @@ export type RAGRetrievalTraceComparisonSummary = {
     multiVectorVectorHitCases: number;
     multiVectorLexicalHitCases: number;
     multiVectorCollapsedCases: number;
+    officeEvidenceReconcileCases: number;
+    pdfEvidenceReconcileCases: number;
     runtimeCandidateBudgetExhaustedCases: number;
     runtimeUnderfilledTopKCases: number;
     averageFinalCount: number;
@@ -2927,6 +2956,8 @@ export type RAGRetrievalTraceComparisonSummaryDiff = {
     multiVectorVectorHitCasesDelta: number;
     multiVectorLexicalHitCasesDelta: number;
     multiVectorCollapsedCasesDelta: number;
+    officeEvidenceReconcileCasesDelta: number;
+    pdfEvidenceReconcileCasesDelta: number;
     runtimeCandidateBudgetExhaustedCasesDelta: number;
     runtimeUnderfilledTopKCasesDelta: number;
     modeDelta: RAGTraceSummaryListDelta<RAGHybridRetrievalMode>;
@@ -2975,6 +3006,7 @@ export type RAGRetrievalComparisonSummary = {
     bestByMultivectorCollapsedCases?: string;
     bestByMultivectorLexicalHitCases?: string;
     bestByMultivectorVectorHitCases?: string;
+    bestByEvidenceReconcileCases?: string;
     bestByLowestRuntimeCandidateBudgetExhaustedCases?: string;
     bestByLowestRuntimeUnderfilledTopKCases?: string;
 };
@@ -2994,6 +3026,7 @@ export type RAGRetrievalComparisonCandidateInput = {
 };
 export type RAGRetrievalComparisonRequest = RAGEvaluationInput & {
     retrievals: RAGRetrievalComparisonCandidateInput[];
+    suiteId?: string;
     label?: string;
     persistRun?: boolean;
     baselineRetrievalId?: string;
@@ -3030,6 +3063,7 @@ export type RAGRetrievalComparisonDecisionDelta = {
     multiVectorCollapsedCasesDelta?: number;
     multiVectorLexicalHitCasesDelta?: number;
     multiVectorVectorHitCasesDelta?: number;
+    evidenceReconcileCasesDelta?: number;
     runtimeCandidateBudgetExhaustedCasesDelta?: number;
     runtimeUnderfilledTopKCasesDelta?: number;
 };
@@ -3040,6 +3074,7 @@ export type RAGRetrievalBaselineGatePolicy = {
     minMultiVectorCollapsedCasesDelta?: number;
     minMultiVectorLexicalHitCasesDelta?: number;
     minMultiVectorVectorHitCasesDelta?: number;
+    minEvidenceReconcileCasesDelta?: number;
     maxRuntimeCandidateBudgetExhaustedCasesDelta?: number;
     maxRuntimeUnderfilledTopKCasesDelta?: number;
     severity?: 'warn' | 'fail';
@@ -3067,6 +3102,7 @@ export type RAGRetrievalComparisonDecisionSummary = {
     winnerByMultivectorCollapsedCases?: string;
     winnerByMultivectorLexicalHitCases?: string;
     winnerByMultivectorVectorHitCases?: string;
+    winnerByEvidenceReconcileCases?: string;
     winnerByLowestRuntimeCandidateBudgetExhaustedCases?: string;
     winnerByLowestRuntimeUnderfilledTopKCases?: string;
     baseline?: {
@@ -3078,6 +3114,7 @@ export type RAGRetrievalComparisonDecisionSummary = {
         multiVectorCollapsedCases?: number;
         multiVectorLexicalHitCases?: number;
         multiVectorVectorHitCases?: number;
+        evidenceReconcileCases?: number;
         runtimeCandidateBudgetExhaustedCases?: number;
         runtimeUnderfilledTopKCases?: number;
     };
@@ -3090,6 +3127,7 @@ export type RAGRetrievalComparisonDecisionSummary = {
         multiVectorCollapsedCases?: number;
         multiVectorLexicalHitCases?: number;
         multiVectorVectorHitCases?: number;
+        evidenceReconcileCases?: number;
         runtimeCandidateBudgetExhaustedCases?: number;
         runtimeUnderfilledTopKCases?: number;
     };
@@ -3472,7 +3510,7 @@ export type RAGRetrievalIncidentRemediationBulkExecutionResponse = {
 export type RAGRetrievalReleaseGroupSummary = {
     corpusGroupKey?: string;
     groupKey: string;
-    classification?: 'general' | 'multivector' | 'runtime';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     escalationSeverity: 'none' | 'info' | 'warning' | 'critical';
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
     recommendedActionReasons: string[];
@@ -3600,7 +3638,7 @@ export type RAGRetrievalReleaseLaneAuditSummary = {
 export type RAGRetrievalReleaseLaneRecommendationSummary = {
     corpusGroupKey?: string;
     groupKey: string;
-    classification?: 'general' | 'multivector' | 'runtime';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
     recommendedActionReasons: string[];
@@ -3640,7 +3678,7 @@ export type RAGRetrievalReleaseLaneHandoffSummary = {
 };
 export type RAGRetrievalLanePromotionStateSummary = {
     groupKey: string;
-    classification?: 'general' | 'multivector' | 'runtime';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     baselineRetrievalId?: string;
     candidateRetrievalId?: string;
@@ -3674,7 +3712,7 @@ export type RAGRetrievalReleaseIncidentRecord = {
     acknowledgedBy?: string;
     acknowledgementNotes?: string;
     notes?: string;
-    classification?: 'general' | 'multivector' | 'runtime';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
 };
 export type RAGRetrievalLaneHandoffIncidentRecord = Omit<RAGRetrievalReleaseIncidentRecord, 'kind'> & {
     corpusGroupKey?: string;
@@ -3856,12 +3894,15 @@ 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';
@@ -3968,6 +4009,7 @@ export type RAGRetrievalReleaseGroupHistoryResponse = {
     timeline?: RAGRetrievalReleaseTimelineSummary;
     presentation?: RAGRetrievalReleaseGroupHistoryPresentation;
     adaptiveNativePlannerBenchmark?: RAGAdaptiveNativePlannerBenchmarkRuntime;
+    nativeBackendComparisonBenchmark?: RAGNativeBackendComparisonBenchmarkRuntime;
     error?: string;
 };
 export type RAGRetrievalPromotionCandidateListResponse = {
@@ -3991,6 +4033,7 @@ export type RAGRetrievalComparisonLatestSummary = {
     bestByMultivectorCollapsedCases?: string;
     bestByMultivectorLexicalHitCases?: string;
     bestByMultivectorVectorHitCases?: string;
+    bestByEvidenceReconcileCases?: string;
     bestByLowestRuntimeCandidateBudgetExhaustedCases?: string;
     bestByLowestRuntimeUnderfilledTopKCases?: string;
     decisionSummary?: RAGRetrievalComparisonDecisionSummary;
@@ -4014,13 +4057,14 @@ export type RAGRetrievalComparisonAlert = {
     candidateRetrievalId?: string;
     delta?: RAGRetrievalComparisonDecisionDelta;
     gate?: RAGRetrievalComparisonGateResult;
-    classification?: 'general' | 'multivector' | 'runtime';
+    classification?: 'general' | 'multivector' | 'runtime' | 'evidence';
 };
 export type RAGRetrievalComparisonRuntime = {
     configured: boolean;
     recentRuns?: RAGRetrievalComparisonRun[];
     latest?: RAGRetrievalComparisonLatestSummary;
     adaptiveNativePlannerBenchmark?: RAGAdaptiveNativePlannerBenchmarkRuntime;
+    nativeBackendComparisonBenchmark?: RAGNativeBackendComparisonBenchmarkRuntime;
     stableWinnerByPassingRate?: RAGRetrievalComparisonWinnerTrend;
     alerts?: RAGRetrievalComparisonAlert[];
     activeBaselines?: RAGRetrievalBaselineRecord[];
@@ -4414,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;
@@ -4486,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;
@@ -4552,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>;
+};