@absolutejs/absolute 0.19.0-beta.615 → 0.19.0-beta.617

package/dist/types/ai.d.ts

@@ -11,6 +11,7 @@ export type RAGExcerptSelection = {
 export type RAGExcerptModeCounts = Record<RAGExcerptMode, number>;
 export type RAGSource = {
     chunkId: string;
+    corpusKey?: string;
     score: number;
     text: string;
     title?: string;
@@ -268,6 +269,7 @@ export type RAGAnswerWorkflowState = {
 export type RAGStreamStage = 'idle' | 'submitting' | 'retrieving' | 'retrieved' | 'streaming' | 'complete' | 'error';
 export type RAGDocumentChunk = {
     chunkId: string;
+    corpusKey?: string;
     text: string;
     title?: string;
     source?: string;
@@ -298,6 +300,7 @@ export type RAGFileExtractionInput = {
     contentType?: string;
     metadata?: Record<string, unknown>;
     chunking?: RAGChunkingOptions;
+    extractorRegistry?: RAGFileExtractorRegistryLike;
 };
 export type RAGExtractedFileDocument = RAGIngestDocument & {
     contentType?: string;
@@ -308,6 +311,27 @@ export type RAGFileExtractor = {
     supports: (input: RAGFileExtractionInput) => boolean | Promise<boolean>;
     extract: (input: RAGFileExtractionInput) => RAGExtractedFileDocument | RAGExtractedFileDocument[] | Promise<RAGExtractedFileDocument | RAGExtractedFileDocument[]>;
 };
+export type RAGFileExtractorRegistryInput = RAGFileExtractionInput & {
+    inferredContentType?: string | null;
+    inferredExtension?: string | null;
+    inferredFormat?: RAGContentFormat;
+};
+export type RAGFileExtractorRegistration = {
+    extractor: RAGFileExtractor;
+    name?: string;
+    priority?: number;
+    contentTypes?: string[];
+    extensions?: string[];
+    formats?: RAGContentFormat[];
+    names?: string[];
+    match?: (input: RAGFileExtractorRegistryInput) => boolean | Promise<boolean>;
+};
+export type RAGFileExtractorRegistry = {
+    registrations: RAGFileExtractorRegistration[];
+    includeDefaults?: boolean;
+    defaultOrder?: 'registry_first' | 'defaults_first';
+};
+export type RAGFileExtractorRegistryLike = RAGFileExtractorRegistry | RAGFileExtractorRegistration[];
 export type RAGMediaTranscriptSegment = {
     text: string;
     startMs?: number;
@@ -371,8 +395,36 @@ export type RAGChunkingOptions = {
     minChunkLength?: number;
     strategy?: RAGChunkingStrategy;
 };
+export type RAGChunkingProfileInput = {
+    document: RAGIngestDocument;
+    format: RAGContentFormat;
+    normalizedText: string;
+    metadata: Record<string, unknown>;
+    sourceNativeKind?: string;
+    defaults?: RAGChunkingOptions;
+};
+export type RAGChunkingProfile = {
+    name: string;
+    resolve: (input: RAGChunkingProfileInput) => Partial<RAGChunkingOptions> | undefined;
+};
+export type RAGChunkingProfileRegistration = {
+    name?: string;
+    documentIds?: string[];
+    formats?: RAGContentFormat[];
+    priority?: number;
+    profile: Partial<RAGChunkingOptions> | {
+        options?: Partial<RAGChunkingOptions>;
+    };
+    sourceNativeKinds?: string[];
+    sources?: string[];
+};
+export type RAGChunkingRegistry = {
+    profiles: Array<RAGChunkingProfile | RAGChunkingProfileRegistration>;
+};
+export type RAGChunkingRegistryLike = RAGChunkingRegistry | Array<RAGChunkingProfile | RAGChunkingProfileRegistration>;
 export type RAGIngestDocument = {
     text: string;
+    corpusKey?: string;
     id?: string;
     title?: string;
     source?: string;
@@ -389,14 +441,18 @@ export type RAGDocumentUrlInput = {
     metadata?: Record<string, unknown>;
     chunking?: RAGChunkingOptions;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
 };
 export type RAGDocumentUrlIngestInput = {
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     urls: RAGDocumentUrlInput[];
 };
 export type RAGPreparedDocument = {
+    corpusKey?: string;
     documentId: string;
     title: string;
     source: string;
@@ -409,6 +465,7 @@ export type RAGDocumentFileInput = Omit<RAGIngestDocument, 'text'> & {
     path: string;
     contentType?: string;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
 };
 export type RAGDirectoryIngestInput = {
     directory: string;
@@ -416,7 +473,9 @@ export type RAGDirectoryIngestInput = {
     includeExtensions?: string[];
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
 };
 export type RAGQueryInput = {
     queryVector: number[];
@@ -531,6 +590,7 @@ export type RAGUpsertInput = {
 export type RAGDocumentIngestInput = {
     documents: RAGIngestDocument[];
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
 };
 export type RAGDocumentUploadInput = {
     name: string;
@@ -546,10 +606,13 @@ export type RAGDocumentUploadInput = {
 export type RAGDocumentUploadIngestInput = {
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     uploads: RAGDocumentUploadInput[];
 };
 export type RAGIndexedDocument = {
+    corpusKey?: string;
     id: string;
     title: string;
     source: string;
@@ -876,21 +939,30 @@ export type RAGCorpusHealth = {
     staleDocuments: string[];
     averageChunksPerDocument: number;
     inspection?: {
+        corpusKeys: Record<string, number>;
         sourceNativeKinds: Record<string, number>;
+        extractorRegistryMatches: Record<string, number>;
+        chunkingProfiles: Record<string, number>;
         documentsWithSourceLabels: number;
         chunksWithSourceLabels: number;
         sampleDocuments: Array<{
+            corpusKey?: string;
             id: string;
             title: string;
             source: string;
             sourceNativeKind?: string;
+            extractorRegistryMatch?: string;
+            chunkingProfile?: string;
             labels?: RAGSourceLabels;
         }>;
         sampleChunks: Array<{
             chunkId: string;
+            corpusKey?: string;
             documentId?: string;
             source?: string;
             sourceNativeKind?: string;
+            extractorRegistryMatch?: string;
+            chunkingProfile?: string;
             labels?: RAGSourceLabels;
         }>;
     };
@@ -917,6 +989,22 @@ export type RAGAdminJobRecord = {
     target?: string;
     error?: string;
 };
+export type RAGJobState = {
+    adminActions: RAGAdminActionRecord[];
+    ingestJobs: RAGIngestJobRecord[];
+    adminJobs: RAGAdminJobRecord[];
+    syncJobs: RAGAdminJobRecord[];
+};
+export type RAGJobStateStore = {
+    load: () => Promise<Partial<RAGJobState> | undefined> | Partial<RAGJobState> | undefined;
+    save: (state: RAGJobState) => Promise<void> | void;
+};
+export type RAGJobHistoryRetention = {
+    maxAdminActions?: number;
+    maxAdminJobs?: number;
+    maxIngestJobs?: number;
+    maxSyncJobs?: number;
+};
 export type RAGAdminCapabilities = {
     canClearIndex: boolean;
     canCreateDocument: boolean;
@@ -931,6 +1019,47 @@ export type RAGAdminCapabilities = {
     canSyncAllSources: boolean;
     canSyncSource: boolean;
 };
+export type RAGAuthorizedAction = 'clear_index' | 'create_document' | 'delete_document' | 'ingest' | 'list_sync_sources' | 'manage_retrieval_admin' | 'manage_retrieval_baselines' | 'prune_search_traces' | 'reindex_document' | 'reindex_source' | 'reseed' | 'reset' | 'sync_all_sources' | 'sync_source';
+export type RAGAuthorizationResource = {
+    documentId?: string;
+    path?: string;
+    source?: string;
+    sourceId?: string;
+};
+export type RAGAuthorizationDecision = boolean | {
+    allowed: boolean;
+    reason?: string;
+};
+export type RAGAuthorizationContext = {
+    action: RAGAuthorizedAction;
+    request: Request;
+    resource?: RAGAuthorizationResource;
+};
+export type RAGAuthorizationProvider = (context: RAGAuthorizationContext) => Promise<RAGAuthorizationDecision> | RAGAuthorizationDecision;
+export type RAGAccessScope = {
+    allowedComparisonGroupKeys?: string[];
+    allowedCorpusGroupKeys?: string[];
+    allowedCorpusKeys?: string[];
+    allowedDocumentIds?: string[];
+    allowedSourcePrefixes?: string[];
+    allowedSources?: string[];
+    allowedSyncSourceIds?: string[];
+    requiredMetadata?: Record<string, unknown>;
+};
+export type RAGAccessScopeProvider = (request: Request) => Promise<RAGAccessScope | undefined> | RAGAccessScope | undefined;
+export type RAGAccessControlContextResolver<TContext = unknown> = (request: Request) => Promise<TContext | undefined> | TContext | undefined;
+export type RAGAccessControlAuthorizeResolver<TContext = unknown> = (input: RAGAuthorizationContext & {
+    context: TContext | undefined;
+}) => Promise<RAGAuthorizationDecision> | RAGAuthorizationDecision;
+export type RAGAccessControlScopeResolver<TContext = unknown> = (input: {
+    context: TContext | undefined;
+    request: Request;
+}) => Promise<RAGAccessScope | undefined> | RAGAccessScope | undefined;
+export type CreateRAGAccessControlOptions<TContext = unknown> = {
+    resolveContext: RAGAccessControlContextResolver<TContext>;
+    authorize?: RAGAccessControlAuthorizeResolver<TContext>;
+    resolveScope?: RAGAccessControlScopeResolver<TContext>;
+};
 export type RAGSyncSourceStatus = 'idle' | 'running' | 'completed' | 'failed' | 'disabled';
 export type RAGSyncSourceRecord = {
     id: string;
@@ -1007,7 +1136,9 @@ export type RAGDirectorySyncSourceOptions = {
     description?: string;
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     includeExtensions?: string[];
     metadata?: Record<string, unknown>;
     recursive?: boolean;
@@ -1021,7 +1152,9 @@ export type RAGUrlSyncSourceOptions = {
     description?: string;
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     metadata?: Record<string, unknown>;
     retryAttempts?: number;
     retryDelayMs?: number;
@@ -1036,7 +1169,9 @@ export type RAGStorageSyncSourceOptions = {
     maxKeys?: number;
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     metadata?: Record<string, unknown>;
     retryAttempts?: number;
     retryDelayMs?: number;
@@ -1086,7 +1221,9 @@ export type RAGEmailSyncSourceOptions = {
     maxResults?: number;
     baseMetadata?: Record<string, unknown>;
     defaultChunking?: RAGChunkingOptions;
+    chunkingRegistry?: RAGChunkingRegistryLike;
     extractors?: RAGFileExtractor[];
+    extractorRegistry?: RAGFileExtractorRegistryLike;
     metadata?: Record<string, unknown>;
     retryAttempts?: number;
     retryDelayMs?: number;
@@ -1306,6 +1443,7 @@ export type RAGMutationResponse = {
 export type RAGEvaluationCase = {
     id: string;
     query: string;
+    corpusKey?: string;
     topK?: number;
     model?: string;
     scoreThreshold?: number;
@@ -1569,6 +1707,7 @@ export type RAGEvaluationInput = {
 };
 export type RAGEvaluationCaseResult = {
     caseId: string;
+    corpusKey?: string;
     query: string;
     label?: string;
     status: 'pass' | 'partial' | 'fail';
@@ -1599,6 +1738,7 @@ export type RAGEvaluationSummary = {
 };
 export type RAGEvaluationResponse = {
     ok: true;
+    corpusKeys?: string[];
     cases: RAGEvaluationCaseResult[];
     summary: RAGEvaluationSummary;
     elapsedMs: number;
@@ -1684,6 +1824,7 @@ export type RAGEvaluationRunDiff = {
 };
 export type RAGEvaluationCaseTraceSnapshot = {
     caseId: string;
+    corpusKey?: string;
     label?: string;
     query: string;
     status: RAGEvaluationCaseResult['status'];
@@ -1922,6 +2063,7 @@ export type RAGRetrievalTraceTrend = {
 };
 export type RAGSearchTraceResultSnapshot = {
     chunkId: string;
+    corpusKey?: string;
     score: number;
     source?: string;
     title?: string;
@@ -2111,6 +2253,8 @@ export type RAGRetrievalComparisonSummary = {
 export type RAGRetrievalComparison = {
     suiteId: string;
     suiteLabel: string;
+    corpusGroupKey?: string;
+    corpusKeys?: string[];
     entries: RAGRetrievalComparisonEntry[];
     summary: RAGRetrievalComparisonSummary;
     leaderboard: RAGEvaluationLeaderboardEntry[];
@@ -2126,6 +2270,7 @@ export type RAGRetrievalComparisonRequest = RAGEvaluationInput & {
     persistRun?: boolean;
     baselineRetrievalId?: string;
     candidateRetrievalId?: string;
+    corpusGroupKey?: string;
     groupKey?: string;
     tags?: string[];
 };
@@ -2139,6 +2284,8 @@ export type RAGRetrievalComparisonRun = {
     label: string;
     suiteId: string;
     suiteLabel: string;
+    corpusGroupKey?: string;
+    corpusKeys?: string[];
     groupKey?: string;
     tags?: string[];
     startedAt: number;
@@ -2203,6 +2350,7 @@ export type RAGRetrievalComparisonHistoryStore = {
         suiteId?: string;
         label?: string;
         winnerId?: string;
+        corpusGroupKey?: string;
         groupKey?: string;
         tag?: string;
     }) => Promise<RAGRetrievalComparisonRun[]> | RAGRetrievalComparisonRun[];
@@ -2214,6 +2362,7 @@ export type RAGRetrievalComparisonHistoryResponse = {
 };
 export type RAGRetrievalBaselineRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey: string;
     version: number;
     status: 'active' | 'superseded';
@@ -2234,6 +2383,7 @@ export type RAGRetrievalBaselineRecord = {
 export type RAGRetrievalBaselineStore = {
     saveBaseline: (record: RAGRetrievalBaselineRecord) => Promise<void> | void;
     listBaselines: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         tag?: string;
         limit?: number;
@@ -2242,6 +2392,7 @@ export type RAGRetrievalBaselineStore = {
     getBaseline?: (groupKey: string) => Promise<RAGRetrievalBaselineRecord | null | undefined> | RAGRetrievalBaselineRecord | null | undefined;
 };
 export type RAGRetrievalBaselinePromotionRequest = {
+    corpusGroupKey?: string;
     groupKey: string;
     retrievalId: string;
     rolloutLabel?: 'canary' | 'stable' | 'rollback_target';
@@ -2257,6 +2408,7 @@ export type RAGRetrievalBaselinePromotionRequest = {
     metadata?: Record<string, unknown>;
 };
 export type RAGRetrievalBaselinePromotionFromRunRequest = {
+    corpusGroupKey?: string;
     groupKey: string;
     sourceRunId: string;
     retrievalId?: string;
@@ -2270,6 +2422,7 @@ export type RAGRetrievalBaselinePromotionFromRunRequest = {
     metadata?: Record<string, unknown>;
 };
 export type RAGRetrievalBaselineRevertRequest = {
+    corpusGroupKey?: string;
     groupKey: string;
     version?: number;
     baselineId?: string;
@@ -2292,6 +2445,7 @@ export type RAGRetrievalBaselineListResponse = {
 export type RAGRetrievalReleaseDecisionRecord = {
     id: string;
     kind: 'approve' | 'promote' | 'reject' | 'revert';
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel?: RAGRetrievalBaselineRecord['rolloutLabel'];
     baselineId?: string;
@@ -2364,6 +2518,7 @@ export type RAGRetrievalReleaseLanePolicySummary = RAGRetrievalReleasePolicy & {
 };
 export type RAGRetrievalReleaseLanePolicyHistoryRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey?: string;
     rolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     scope: 'rollout_label' | 'group_rollout_label';
@@ -2377,6 +2532,7 @@ export type RAGRetrievalReleaseLanePolicyHistoryRecord = {
 export type RAGRetrievalReleaseLanePolicyHistoryStore = {
     saveRecord: (record: RAGRetrievalReleaseLanePolicyHistoryRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         rolloutLabel?: RAGRetrievalReleaseLanePolicyHistoryRecord['rolloutLabel'];
@@ -2396,6 +2552,7 @@ export type RAGRetrievalBaselineGatePolicySummary = {
 };
 export type RAGRetrievalBaselineGatePolicyHistoryRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey?: string;
     rolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     scope: 'rollout_label' | 'group_rollout_label';
@@ -2407,6 +2564,7 @@ export type RAGRetrievalBaselineGatePolicyHistoryRecord = {
 export type RAGRetrievalBaselineGatePolicyHistoryStore = {
     saveRecord: (record: RAGRetrievalBaselineGatePolicyHistoryRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         rolloutLabel?: RAGRetrievalBaselineGatePolicyHistoryRecord['rolloutLabel'];
@@ -2451,6 +2609,7 @@ export type RAGRetrievalIncidentRemediationDecisionRequest = {
 export type RAGRetrievalIncidentRemediationDecisionStore = {
     saveRecord: (record: RAGRetrievalIncidentRemediationDecisionRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         incidentId?: string;
         limit?: number;
@@ -2558,6 +2717,7 @@ export type RAGRetrievalIncidentRemediationBulkExecutionResponse = {
     error?: string;
 };
 export type RAGRetrievalReleaseGroupSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     escalationSeverity: 'none' | 'info' | 'warning' | 'critical';
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
@@ -2580,6 +2740,7 @@ export type RAGRetrievalReleaseGroupSummary = {
     activeBaselineGatePolicy?: RAGRetrievalBaselineGatePolicy;
 };
 export type RAGRetrievalReleaseTimelineSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     lastApprovedAt?: number;
     lastPromotedAt?: number;
@@ -2590,6 +2751,7 @@ export type RAGRetrievalReleaseTimelineSummary = {
     latestDecisionFreshnessStatus?: RAGRetrievalReleaseDecisionRecord['freshnessStatus'];
 };
 export type RAGRetrievalReleaseLaneTimelineSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     lastApprovedAt?: number;
@@ -2601,6 +2763,7 @@ export type RAGRetrievalReleaseLaneTimelineSummary = {
     latestDecisionFreshnessStatus?: RAGRetrievalReleaseDecisionRecord['freshnessStatus'];
 };
 export type RAGRetrievalReleaseLaneDecisionSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     decisionCount: number;
@@ -2613,6 +2776,7 @@ export type RAGRetrievalReleaseLaneDecisionSummary = {
     latestDecisionBy?: string;
 };
 export type RAGRetrievalReleaseApprovalScopeSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     status: 'approved' | 'rejected' | 'none';
@@ -2624,6 +2788,7 @@ export type RAGRetrievalReleaseApprovalScopeSummary = {
     latestRejectedBy?: string;
 };
 export type RAGRetrievalReleaseLaneEscalationPolicySummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     openIncidentSeverity: RAGRetrievalReleaseIncidentRecord['severity'];
@@ -2633,6 +2798,7 @@ export type RAGRetrievalReleaseLaneEscalationPolicySummary = {
 };
 export type RAGRetrievalReleaseLaneEscalationPolicyHistoryRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     openIncidentSeverity: RAGRetrievalReleaseIncidentRecord['severity'];
@@ -2649,6 +2815,7 @@ export type RAGRetrievalReleaseLaneEscalationPolicyHistoryRecord = {
 export type RAGRetrievalReleaseLaneEscalationPolicyHistoryStore = {
     saveRecord: (record: RAGRetrievalReleaseLaneEscalationPolicyHistoryRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         targetRolloutLabel?: RAGRetrievalReleaseLaneEscalationPolicyHistoryRecord['targetRolloutLabel'];
@@ -2660,6 +2827,7 @@ export type RAGRetrievalReleaseLaneEscalationPolicyHistoryResponse = {
     error?: string;
 };
 export type RAGRetrievalReleaseLaneAuditSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     activeBaselineRetrievalId?: string;
@@ -2676,6 +2844,7 @@ export type RAGRetrievalReleaseLaneAuditSummary = {
     lastRevertedBy?: string;
 };
 export type RAGRetrievalReleaseLaneRecommendationSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     recommendedAction: 'promote_candidate' | 'renew_approval' | 'await_approval' | 'investigate_regression' | 'monitor';
@@ -2694,6 +2863,7 @@ export type RAGRetrievalReleaseLaneRecommendationSummary = {
     remediationSteps?: RAGRemediationStep[];
 };
 export type RAGRetrievalReleaseLaneHandoffSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     sourceRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
@@ -2749,10 +2919,12 @@ export type RAGRetrievalReleaseIncidentRecord = {
     notes?: string;
 };
 export type RAGRetrievalLaneHandoffIncidentRecord = Omit<RAGRetrievalReleaseIncidentRecord, 'kind'> & {
+    corpusGroupKey?: string;
     kind: 'handoff_stale';
     sourceRolloutLabel?: RAGRetrievalLaneHandoffDecisionRecord['sourceRolloutLabel'];
 };
 export type RAGRetrievalReleaseLaneIncidentSummary = {
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     openCount: number;
@@ -2782,6 +2954,7 @@ export type RAGRetrievalReleaseIncidentResolveRequest = {
 export type RAGRetrievalReleaseIncidentStore = {
     saveIncident: (record: RAGRetrievalReleaseIncidentRecord) => Promise<void> | void;
     listIncidents: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         targetRolloutLabel?: RAGRetrievalReleaseIncidentRecord['targetRolloutLabel'];
@@ -2792,6 +2965,7 @@ export type RAGRetrievalReleaseIncidentStore = {
 export type RAGRetrievalLaneHandoffIncidentStore = {
     saveIncident: (record: RAGRetrievalLaneHandoffIncidentRecord) => Promise<void> | void;
     listIncidents: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         targetRolloutLabel?: RAGRetrievalLaneHandoffIncidentRecord['targetRolloutLabel'];
@@ -2807,6 +2981,7 @@ export type RAGRetrievalLaneHandoffIncidentListResponse = {
 export type RAGRetrievalLaneHandoffIncidentHistoryRecord = {
     id: string;
     incidentId: string;
+    corpusGroupKey?: string;
     groupKey: string;
     kind: 'handoff_stale';
     targetRolloutLabel?: RAGRetrievalLaneHandoffIncidentRecord['targetRolloutLabel'];
@@ -2821,6 +2996,7 @@ export type RAGRetrievalLaneHandoffIncidentHistoryRecord = {
 export type RAGRetrievalLaneHandoffIncidentHistoryStore = {
     saveRecord: (record: RAGRetrievalLaneHandoffIncidentHistoryRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         incidentId?: string;
         limit?: number;
@@ -2846,6 +3022,7 @@ export type RAGRetrievalLaneHandoffAutoCompletePolicySummary = {
 };
 export type RAGRetrievalLaneHandoffAutoCompletePolicyHistoryRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey: string;
     targetRolloutLabel: Exclude<RAGRetrievalLaneHandoffDecisionRecord['targetRolloutLabel'], undefined>;
     enabled: boolean;
@@ -2858,6 +3035,7 @@ export type RAGRetrievalLaneHandoffAutoCompletePolicyHistoryRecord = {
 export type RAGRetrievalLaneHandoffAutoCompletePolicyHistoryStore = {
     saveRecord: (record: RAGRetrievalLaneHandoffAutoCompletePolicyHistoryRecord) => Promise<void> | void;
     listRecords: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         targetRolloutLabel?: RAGRetrievalLaneHandoffAutoCompletePolicyHistoryRecord['targetRolloutLabel'];
@@ -2925,12 +3103,14 @@ export type RAGRetrievalReleasePolicySummary = RAGRetrievalReleasePolicy & {
 export type RAGRetrievalReleaseDecisionStore = {
     saveDecision: (record: RAGRetrievalReleaseDecisionRecord) => Promise<void> | void;
     listDecisions: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         limit?: number;
         kind?: RAGRetrievalReleaseDecisionRecord['kind'];
     }) => Promise<RAGRetrievalReleaseDecisionRecord[]> | RAGRetrievalReleaseDecisionRecord[];
 };
 export type RAGRetrievalReleaseDecisionActionRequest = {
+    corpusGroupKey?: string;
     groupKey: string;
     sourceRunId: string;
     targetRolloutLabel?: RAGRetrievalBaselineRecord['rolloutLabel'];
@@ -2953,6 +3133,7 @@ export type RAGRetrievalReleaseDecisionListResponse = {
 };
 export type RAGRetrievalLaneHandoffDecisionRecord = {
     id: string;
+    corpusGroupKey?: string;
     groupKey: string;
     sourceRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
@@ -2968,6 +3149,7 @@ export type RAGRetrievalLaneHandoffDecisionRecord = {
 export type RAGRetrievalLaneHandoffDecisionStore = {
     saveDecision: (record: RAGRetrievalLaneHandoffDecisionRecord) => Promise<void> | void;
     listDecisions: (input?: {
+        corpusGroupKey?: string;
         groupKey?: string;
         sourceRolloutLabel?: RAGRetrievalLaneHandoffDecisionRecord['sourceRolloutLabel'];
         targetRolloutLabel?: RAGRetrievalLaneHandoffDecisionRecord['targetRolloutLabel'];
@@ -2976,6 +3158,7 @@ export type RAGRetrievalLaneHandoffDecisionStore = {
     }) => Promise<RAGRetrievalLaneHandoffDecisionRecord[]> | RAGRetrievalLaneHandoffDecisionRecord[];
 };
 export type RAGRetrievalLaneHandoffDecisionRequest = {
+    corpusGroupKey?: string;
     groupKey: string;
     sourceRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
     targetRolloutLabel: Exclude<RAGRetrievalBaselineRecord['rolloutLabel'], undefined>;
@@ -3006,6 +3189,7 @@ export type RAGRetrievalLaneHandoffListResponse = {
 };
 export type RAGRetrievalReleaseGroupHistoryResponse = {
     ok: boolean;
+    corpusGroupKey?: string;
     groupKey?: string;
     decisions?: RAGRetrievalReleaseDecisionRecord[];
     baselines?: RAGRetrievalBaselineRecord[];
@@ -3023,6 +3207,7 @@ export type RAGRetrievalComparisonLatestSummary = {
     label: string;
     suiteId: string;
     suiteLabel: string;
+    corpusGroupKey?: string;
     groupKey?: string;
     tags?: string[];
     finishedAt: number;
@@ -3044,6 +3229,7 @@ export type RAGRetrievalComparisonAlert = {
     message: string;
     latestRunId: string;
     retrievalId?: string;
+    corpusGroupKey?: string;
     groupKey?: string;
     tag?: string;
     baselineRetrievalId?: string;
@@ -3545,6 +3731,10 @@ export type RAGChatPluginConfig = AIChatPluginConfig & {
     path?: string;
     ragStore?: RAGVectorStore;
     collection?: RAGCollection;
+    jobStateStore?: RAGJobStateStore;
+    authorizeRAGAction?: RAGAuthorizationProvider;
+    resolveRAGAccessScope?: RAGAccessScopeProvider;
+    jobHistoryRetention?: RAGJobHistoryRetention;
     searchTraceStore?: RAGSearchTraceStore;
     searchTraceRetention?: RAGSearchTracePruneInput;
     searchTraceRetentionSchedule?: RAGSearchTraceRetentionSchedule;