@absolutejs/absolute 0.19.0-beta.466 → 0.19.0-beta.467

package/dist/src/ai/index.d.ts

@@ -1,13 +1,13 @@
 export { aiChat } from '../plugins/aiChat';
 export { streamAI } from './streamAI';
 export { ragChat } from './rag';
-export { buildRAGCitations, buildRAGCitationReferenceMap, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, createRAGCollection, createRAGEmbeddingProvider, createRAGHTMXConfig, createRAGHTMXWorkflowRenderConfig, alibabaEmbeddings, deepseekEmbeddings, geminiEmbeddings, getLatestAssistantMessage, getLatestRAGSources, buildRAGStreamProgress, googleEmbeddings, ingestDocuments, ingestRAGDocuments, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentFromURL, loadRAGDocumentsFromURLs, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, openaiCompatibleEmbeddings, openaiEmbeddings, prepareRAGDirectoryDocuments, buildRAGUpsertInputFromUploads, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, ragPlugin, resolveRAGEmbeddingProvider, resolveRAGStreamStage, searchDocuments, validateRAGEmbeddingDimensions, xaiEmbeddings } from './rag';
+export { buildRAGCitations, buildRAGCitationReferenceMap, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, createRAGCollection, createRAGEmbeddingProvider, createHeuristicRAGReranker, createRAGHTMXConfig, createRAGReranker, createRAGHTMXWorkflowRenderConfig, alibabaEmbeddings, deepseekEmbeddings, geminiEmbeddings, getLatestAssistantMessage, getLatestRAGSources, buildRAGStreamProgress, googleEmbeddings, ingestDocuments, ingestRAGDocuments, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentFromURL, loadRAGDocumentsFromURLs, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, openaiCompatibleEmbeddings, openaiEmbeddings, prepareRAGDirectoryDocuments, buildRAGUpsertInputFromUploads, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments, ragPlugin, resolveRAGEmbeddingProvider, resolveRAGReranker, resolveRAGStreamStage, searchDocuments, applyRAGReranking, validateRAGEmbeddingDimensions, xaiEmbeddings } from './rag';
 export { createInMemoryRAGStore } from './rag/adapters/inMemory';
 export { createSQLiteRAGStore } from './rag/adapters/sqlite';
 export { resolveAbsoluteSQLiteVec, resolveAbsoluteSQLiteVecExtensionPath } from './rag/resolveAbsoluteSQLiteVec';
 export { createRAGVector, normalizeVector, querySimilarity } from './rag/adapters/utils';
 export type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig, NativeSQLiteRAGStoreOptions, SQLiteRAGStoreOptions } from './rag';
-export type { AIHTMXRenderConfig, RAGSource, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGChunkingOptions, RAGChunkingStrategy, RAGDocumentChunk, RAGDocumentChunkPreview, RAGDirectoryIngestInput, RAGDocumentFileInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGReranker, RAGRerankerInput, RAGHTMXConfig, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGDocumentUrlIngestInput, RAGDocumentUrlInput, RAGIndexedDocument, RAGQueryInput, RAGQueryResult, RAGIngestResponse, RAGPostgresNativeDiagnostics, RAGPreparedDocument, RAGSearchRequest, RAGSourceGroup, RAGSourceSummary, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGStreamStage, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSummary, RAGMutationResponse, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution, RAGChatPluginConfig } from '../../types/ai';
+export type { AIHTMXRenderConfig, RAGSource, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGChunkingOptions, RAGChunkingStrategy, RAGDocumentChunk, RAGDocumentChunkPreview, RAGDirectoryIngestInput, RAGDocumentFileInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGReranker, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike, RAGHTMXConfig, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGDocumentUrlIngestInput, RAGDocumentUrlInput, RAGIndexedDocument, RAGQueryInput, RAGQueryResult, RAGIngestResponse, RAGPostgresNativeDiagnostics, RAGPreparedDocument, RAGSearchRequest, RAGSourceGroup, RAGSourceSummary, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGStreamStage, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSummary, RAGMutationResponse, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution, RAGChatPluginConfig } from '../../types/ai';
 export type { RAGStreamProgress, RAGStreamProgressState } from './rag';
 export { createConversationManager } from './conversationManager';
 export { createMemoryStore } from './memoryStore';

package/dist/src/ai/rag/collection.d.ts

@@ -1,10 +1,10 @@
-import type { RAGCollection, RAGCollectionSearchParams, RAGReranker, RAGDocumentIngestInput, RAGEmbeddingProviderLike, RAGUpsertInput, RAGVectorStore } from '../../../types/ai';
+import type { RAGCollection, RAGCollectionSearchParams, RAGRerankerProviderLike, RAGDocumentIngestInput, RAGEmbeddingProviderLike, RAGUpsertInput, RAGVectorStore } from '../../../types/ai';
 export type CreateRAGCollectionOptions = {
     store: RAGVectorStore;
     embedding?: RAGEmbeddingProviderLike;
     defaultTopK?: number;
     defaultModel?: string;
-    rerank?: RAGReranker;
+    rerank?: RAGRerankerProviderLike;
 };
 export declare const createRAGCollection: (options: CreateRAGCollectionOptions) => RAGCollection;
 export declare const ingestDocuments: (collection: RAGCollection, input: RAGUpsertInput) => Promise<void>;

package/dist/src/ai/rag/index.d.ts

@@ -1,6 +1,7 @@
 export { ragChat, ragChat as ragPlugin } from './chat';
 export { createRAGHTMXConfig, createRAGHTMXWorkflowRenderConfig } from './htmxConfig';
 export { createRAGEmbeddingProvider, resolveRAGEmbeddingProvider, validateRAGEmbeddingDimensions } from './embedding';
+export { applyRAGReranking, createHeuristicRAGReranker, createRAGReranker, resolveRAGReranker } from './reranking';
 export { alibabaEmbeddings, deepseekEmbeddings, geminiEmbeddings, googleEmbeddings, metaEmbeddings, mistralaiEmbeddings, moonshotEmbeddings, ollamaEmbeddings, openaiCompatibleEmbeddings, openaiEmbeddings, xaiEmbeddings } from './embeddingProviders';
 export { buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, buildRAGUpsertInputFromUploads, loadRAGDocumentFromURL, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentsFromURLs, prepareRAGDirectoryDocuments, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments } from './ingestion';
 export { buildRAGCitations, buildRAGCitationReferenceMap, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGStreamProgress, getLatestAssistantMessage, getLatestRAGSources, resolveRAGStreamStage } from './presentation';
@@ -12,5 +13,5 @@ export { resolveAbsoluteSQLiteVec, resolveAbsoluteSQLiteVecExtensionPath } from
 export { createRAGVector, normalizeVector, querySimilarity } from './adapters/utils';
 export type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig } from './embeddingProviders';
 export type { NativeSQLiteRAGStoreOptions, SQLiteRAGStoreOptions } from './adapters/sqlite';
-export type { AIHTMXRenderConfig, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGChunkingOptions, RAGChunkingStrategy, RAGDocumentChunk, RAGDocumentChunkPreview, RAGDocumentFileInput, RAGDirectoryIngestInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGDocumentUrlIngestInput, RAGDocumentUrlInput, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSummary, RAGHTMXConfig, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGIngestResponse, RAGIndexedDocument, RAGMutationResponse, RAGQueryInput, RAGQueryResult, RAGPreparedDocument, RAGReranker, RAGRerankerInput, RAGSearchRequest, RAGSource, RAGSourceGroup, RAGSourceSummary, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution } from './types';
+export type { AIHTMXRenderConfig, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGChunkingOptions, RAGChunkingStrategy, RAGDocumentChunk, RAGDocumentChunkPreview, RAGDocumentFileInput, RAGDirectoryIngestInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGDocumentUrlIngestInput, RAGDocumentUrlInput, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSummary, RAGHTMXConfig, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGIngestResponse, RAGIndexedDocument, RAGMutationResponse, RAGQueryInput, RAGQueryResult, RAGPreparedDocument, RAGReranker, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike, RAGSearchRequest, RAGSource, RAGSourceGroup, RAGSourceSummary, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution } from './types';
 export type { RAGPostgresNativeDiagnostics } from '../../../types/ai';

package/dist/src/ai/rag/reranking.d.ts

@@ -0,0 +1,17 @@
+import type { RAGQueryResult, RAGReranker, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike } from '../../../types/ai';
+export type CreateRAGRerankerOptions = {
+    rerank: RAGReranker;
+    defaultModel?: string;
+    providerName?: string;
+};
+export type HeuristicRAGRerankerOptions = {
+    defaultModel?: string;
+    providerName?: string;
+};
+export declare const createRAGReranker: (options: CreateRAGRerankerOptions) => RAGRerankerProvider;
+export declare const resolveRAGReranker: (reranker: RAGRerankerProviderLike | undefined) => RAGRerankerProvider | null;
+export declare const applyRAGReranking: ({ input, reranker }: {
+    input: RAGRerankerInput;
+    reranker?: RAGRerankerProviderLike;
+}) => Promise<RAGQueryResult[]>;
+export declare const createHeuristicRAGReranker: (options?: HeuristicRAGRerankerOptions) => RAGRerankerProvider;

package/dist/src/ai/rag/types.d.ts

@@ -7,5 +7,5 @@ export type InternalRAGStoredChunk = RAGDocumentChunk & {
 export type { RAGUpsertInput as RAGDocumentBatch };
 export type { RAGQueryInput as RAGQueryParams };
 export type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig } from './embeddingProviders';
-export type { RAGReranker, RAGRerankerInput } from '../../../types/ai';
+export type { RAGReranker, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike } from '../../../types/ai';
 export declare const buildRAGContext: (hits: RAGQueryResult[]) => string;

package/dist/types/ai.d.ts

@@ -139,6 +139,12 @@ export type RAGRerankerInput = {
     results: RAGQueryResult[];
 };
 export type RAGReranker = (input: RAGRerankerInput) => Promise<RAGQueryResult[]> | RAGQueryResult[];
+export type RAGRerankerProvider = {
+    rerank: RAGReranker;
+    defaultModel?: string;
+    providerName?: string;
+};
+export type RAGRerankerProviderLike = RAGReranker | RAGRerankerProvider;
 export type RAGQueryResult = {
     chunkId: string;
     score: number;
@@ -275,7 +281,7 @@ export type RAGCollectionSearchParams = {
     topK?: number;
     filter?: Record<string, unknown>;
     scoreThreshold?: number;
-    rerank?: RAGReranker;
+    rerank?: RAGRerankerProviderLike;
     model?: string;
     signal?: AbortSignal;
 };
@@ -819,7 +825,7 @@ export type RAGChatPluginConfig = AIChatPluginConfig & {
     collection?: RAGCollection;
     embedding?: RAGEmbeddingProviderLike;
     embeddingModel?: string;
-    rerank?: RAGReranker;
+    rerank?: RAGRerankerProviderLike;
     indexManager?: RAGIndexManager;
     topK?: number;
     scoreThreshold?: number;

package/package.json

@@ -228,12 +228,12 @@
 	"main": "./dist/index.js",
 	"name": "@absolutejs/absolute",
 	"optionalDependencies": {
-		"@absolutejs/native-darwin-arm64": "0.19.0-beta.466",
-		"@absolutejs/native-darwin-x64": "0.19.0-beta.466",
-		"@absolutejs/native-linux-arm64": "0.19.0-beta.466",
-		"@absolutejs/native-linux-x64": "0.19.0-beta.466",
-		"@absolutejs/native-windows-arm64": "0.19.0-beta.466",
-		"@absolutejs/native-windows-x64": "0.19.0-beta.466"
+		"@absolutejs/native-darwin-arm64": "0.19.0-beta.467",
+		"@absolutejs/native-darwin-x64": "0.19.0-beta.467",
+		"@absolutejs/native-linux-arm64": "0.19.0-beta.467",
+		"@absolutejs/native-linux-x64": "0.19.0-beta.467",
+		"@absolutejs/native-windows-arm64": "0.19.0-beta.467",
+		"@absolutejs/native-windows-x64": "0.19.0-beta.467"
 	},
 	"overrides": {
 		"@typescript-eslint/utils": "8.56.1"
@@ -314,5 +314,5 @@
 		"typecheck": "bun run src/cli/index.ts typecheck --config example/absolute.config.ts"
 	},
 	"types": "./dist/src/index.d.ts",
-	"version": "0.19.0-beta.466"
+	"version": "0.19.0-beta.467"
 }