@absolutejs/rag 0.0.19 → 0.0.21

package/dist/src/adapter-kit/index.d.ts

@@ -0,0 +1,8 @@
+export { createRAGVector, normalizeVector, querySimilarity } from "../adapters/utils";
+export { matchesMetadataFilterRecord } from "../adapters/filtering";
+export { planNativeCandidateSearchBackfillK, planNativeCandidateSearchK, resolveAdaptiveNativeCandidateLimit, summarizeSQLiteCandidateCoverage, } from "../adapters/queryPlanning";
+export { rankRAGLexicalMatches } from "../retrieval/lexical";
+export { createRAGCollection } from "../retrieval/collection";
+export { ragChat, ragChat as ragPlugin } from "../chat/chat";
+export { RAG_NATIVE_QUERY_CANDIDATE_LIMIT, RAG_VECTOR_DIMENSIONS_DEFAULT, } from "../constants";
+export type { RAGBackendCapabilities, RAGCollection, RAGEmbeddingInput, RAGLexicalQueryInput, RAGPostgresNativeDiagnostics, RAGQueryInput, RAGQueryResult, RAGSQLiteNativeDiagnostics, RAGUpsertInput, RAGVectorCountInput, RAGVectorDeleteInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution, } from "@absolutejs/ai";

package/dist/src/adapters/sync.d.ts

@@ -0,0 +1,21 @@
+import type { SyncEngine } from "@absolutejs/sync/engine";
+import type { RAGVectorStore } from "@absolutejs/ai";
+import type { SyncRAGStoreOptions } from "../../types/adapters";
+/**
+ * A {@link RAGVectorStore} backed by the @absolutejs/sync engine: a drop-in for
+ * `createInMemoryRAGStore`, but retrieval is also **live**. Ingested chunks flow
+ * through the engine's change feed, so a registered search collection re-ranks as
+ * the corpus changes — subscribe to `store.retrievalCollection` over
+ * `store.engine`'s `syncSocket` and a query's results update with no refetch.
+ *
+ * Built on sync's `createVectorIndex` (one-shot semantic `query`) + a shared
+ * `createTextIndex` (one-shot `queryLexical` AND the live lexical collection). The
+ * vector stays in a server-side map keyed by chunk id, so emitted rows are light.
+ */
+export type SyncRAGStore = RAGVectorStore & {
+    /** The engine to mount with `syncSocket` for live retrieval. */
+    engine: SyncEngine;
+    /** Collection name to subscribe to (params = the query string) for live retrieval. */
+    retrievalCollection: string;
+};
+export declare const createSyncRAGStore: (options?: SyncRAGStoreOptions) => SyncRAGStore;

package/dist/src/index.d.ts

@@ -20,13 +20,11 @@ export { createRAGBunS3SyncClient, createRAGDirectorySyncSource, createRAGEmailS
 export { createRAGFileJobStateStore } from "./internal/jobState";
 export { createRAGCollection, ingestDocuments, ingestRAGDocuments, searchDocuments, } from "./retrieval/collection";
 export { createInMemoryRAGStore } from "./adapters/inMemory";
-export { createPostgresRAGStore } from "./adapters/postgres";
-export { createSQLiteRAGStore } from "./adapters/sqlite";
-export { resolveAbsoluteSQLiteVec, resolveAbsoluteSQLiteVecExtensionPath, } from "./internal/resolveAbsoluteSQLiteVec";
+export { createSyncRAGStore } from "./adapters/sync";
+export type { SyncRAGStore } from "./adapters/sync";
 export { createRAGVector, normalizeVector, querySimilarity, } from "./adapters/utils";
 export type { SQLiteRAGSearchTraceStoreOptions } from "./quality/quality";
 export type { AnthropicOCRConfig, CrossEncoderRerankerConfig, GeminiEmbeddingsConfig, GeminiOCRConfig, GmailEmailSyncConfig, GraphEmailSyncConfig, IMAPEmailSyncConfig, OllamaEmbeddingsConfig, OllamaOCRConfig, OllamaTranscriptionConfig, OpenAICompatibleEmbeddingsConfig, OpenAICompatibleOCRConfig, OpenAICompatibleTranscriptionConfig, OpenAIEmbeddingsConfig, OpenAIOCRConfig, OpenAITranscriptionConfig, } from "../types/providers";
-export type { NativeSQLiteRAGStoreOptions, SQLiteRAGStoreOptions, } from "../types/adapters";
 export type { AIHTMXRenderConfig, RAGAnswerWorkflowState, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGGroundedAnswer, RAGGroundedAnswerPart, RAGGroundingReference, RAGChunkingOptions, RAGChunkingStrategy, RAGDocumentChunk, RAGDocumentChunkPreview, RAGArchiveEntry, RAGArchiveExpander, RAGArchiveExpansionResult, RAGExtractedFileDocument, RAGFileExtractionInput, RAGFileExtractor, RAGPDFOCRExtractorOptions, RAGDocumentFileInput, RAGDirectoryIngestInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGDocumentUrlIngestInput, RAGDocumentUrlInput, RAGEmailSyncAttachment, RAGEmailSyncClient, RAGEmailSyncListInput, RAGEmailSyncListResult, RAGEmailSyncMessage, RAGEmailSyncSourceOptions, RAGLinkedConnectorSyncSourceOptions, RAGConnectorCheckpoint, RAGConnectorItem, RAGConnectorRuntime, RAGConnectorSyncInput, RAGConnectorSyncResult, RAGFeedSyncInput, RAGFeedSyncSourceOptions, RAGGitHubRepoSyncInput, RAGGitHubSyncSourceOptions, RAGSitemapSyncInput, RAGSitemapSyncSourceOptions, RAGSiteDiscoveryInput, RAGSiteDiscoverySyncSourceOptions, RAGStorageSyncClient, RAGStorageSyncFile, RAGStorageSyncListInput, RAGStorageSyncListResult, RAGStorageSyncObject, RAGStorageSyncSourceOptions, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGAnswerGroundingEvaluationCase, RAGAnswerGroundingEvaluationCaseResult, RAGAnswerGroundingEvaluationInput, RAGAnswerGroundingEvaluationResponse, RAGAnswerGroundingEvaluationSummary, RAGEvaluationCase, RAGEvaluationCaseResult, RAGEvaluationLeaderboardEntry, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationSummary, RAGEvaluationSuite, RAGEvaluationSuiteRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalComparisonSummary, RAGHTMXConfig, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGIngestResponse, RAGIndexedDocument, RAGHybridFusionMode, RAGHybridRetrievalMode, RAGHybridSearchOptions, RAGMediaTranscriber, RAGMediaTranscriptSegment, RAGMediaTranscriptionResult, RAGMutationResponse, RAGLexicalQueryInput, RAGOCRProvider, RAGOCRResult, RAGQueryInput, RAGQueryResult, RAGQueryTransformInput, RAGQueryTransformProvider, RAGQueryTransformProviderLike, RAGQueryTransformResult, RAGQueryTransformer, RAGPreparedDocument, RAGReranker, RAGRerankerCandidate, RAGRerankerComparison, RAGRerankerComparisonEntry, RAGRerankerComparisonSummary, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike, RAGSearchRequest, RAGSyncManager, RAGSyncSchedule, RAGSyncScheduler, RAGSyncResponse, RAGSyncRunOptions, RAGSyncStateStore, RAGSyncSourceContext, RAGSyncSourceDefinition, RAGSyncSourceRecord, RAGSyncSourceRunResult, RAGDirectorySyncSourceOptions, RAGUrlSyncSourceOptions, RAGSource, RAGSourceGroup, RAGSourceSummary, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution, } from "../types";
 export type { RAGJobState, RAGJobStateStore, RAGPostgresNativeDiagnostics, RAGRetrievalComparisonCandidateInput, RAGRetrievalComparisonHistoryResponse, RAGRetrievalComparisonHistoryStore, RAGRetrievalComparisonRequest, RAGRetrievalComparisonResponse, RAGRetrievalComparisonRun, RAGSearchTraceGroupHistoryResponse, RAGSearchTraceHistoryResponse, RAGSearchTracePrunePreviewResponse, RAGSearchTracePruneHistoryResponse, RAGSearchTracePruneResponse, RAGSearchTracePruneInput, RAGSearchTracePrunePreview, RAGSearchTracePruneResult, RAGSearchTracePruneHistoryStore, RAGSearchTracePruneRun, RAGSearchTraceRetentionRuntime, RAGSearchTraceRetentionSchedule, RAGSearchTraceStats, RAGSearchTraceStatsResponse, } from "@absolutejs/ai";
 export type * from "@absolutejs/ai";

package/dist/src/sync/sync.d.ts

@@ -1,6 +1,6 @@
 import { S3Client } from "bun";
 import type { CreateRAGSyncManagerOptions, RAGSyncSourceDiagnostics, RAGSyncExtractionRecoveryHandlers, RAGSyncExtractionRecoveryPreview, RAGSyncExtractionRecoveryResult, RAGSyncConflictResolutionPreview, RAGSyncConflictResolutionResult, RAGSyncConflictResolutionStrategy, RAGDirectorySyncSourceOptions, RAGStorageSyncClient, RAGStorageSyncSourceOptions, RAGEmailSyncClient, RAGEmailSyncMessage, RAGEmailSyncSourceOptions, RAGGmailLinkedEmailSyncSourceOptions, RAGFeedSyncSourceOptions, RAGGitHubSyncSourceOptions, RAGSitemapSyncSourceOptions, RAGSiteDiscoverySyncSourceOptions, RAGSyncSchedule, RAGSyncScheduler, RAGSyncStateStore, RAGSyncManager, RAGSyncSourceDefinition, RAGSyncSourceReconciliationSummary, RAGUrlSyncSourceOptions } from "@absolutejs/ai";
-import type { RAGLinkedConnectorSyncSourceOptions } from "../../types/sync";
+import type { RAGLinkedConnectorSyncSourceOptions } from "@absolutejs/ai";
 export declare const previewRAGSyncExtractionRecovery: (input: {
     diagnostics?: RAGSyncSourceDiagnostics;
 }) => RAGSyncExtractionRecoveryPreview;

package/dist/src/vue/useRAG.d.ts

@@ -1275,8 +1275,13 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 reason?: string | undefined;
                 lastSeedMs?: number | undefined;
                 status?: {
-                    backend: "in_memory" | "sqlite" | "postgres";
-                    vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                    backend: "in_memory";
+                    vectorMode: "in_memory";
+                    dimensions?: number | undefined;
+                    native?: undefined | undefined;
+                } | {
+                    backend: "sqlite";
+                    vectorMode: "json_fallback" | "native_vec0";
                     dimensions?: number | undefined;
                     native?: {
                         requested: boolean;
@@ -1337,7 +1342,12 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                             candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                             queryMode: "json_fallback" | "native_vec0";
                         } | undefined;
-                    } | {
+                    } | undefined;
+                } | {
+                    backend: "postgres";
+                    vectorMode: "native_pgvector";
+                    dimensions?: number | undefined;
+                    native?: {
                         requested: boolean;
                         available: boolean;
                         active: boolean;
@@ -1425,8 +1435,13 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 reason?: string | undefined;
                 lastSeedMs?: number | undefined;
                 status?: {
-                    backend: "in_memory" | "sqlite" | "postgres";
-                    vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                    backend: "in_memory";
+                    vectorMode: "in_memory";
+                    dimensions?: number | undefined;
+                    native?: undefined | undefined;
+                } | {
+                    backend: "sqlite";
+                    vectorMode: "json_fallback" | "native_vec0";
                     dimensions?: number | undefined;
                     native?: {
                         requested: boolean;
@@ -1487,7 +1502,12 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                             candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                             queryMode: "json_fallback" | "native_vec0";
                         } | undefined;
-                    } | {
+                    } | undefined;
+                } | {
+                    backend: "postgres";
+                    vectorMode: "native_pgvector";
+                    dimensions?: number | undefined;
+                    native?: {
                         requested: boolean;
                         available: boolean;
                         active: boolean;
@@ -1615,8 +1635,13 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 }[];
             } | undefined;
             workflowStatus?: {
-                backend: "in_memory" | "sqlite" | "postgres";
-                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                backend: "in_memory";
+                vectorMode: "in_memory";
+                dimensions?: number | undefined;
+                native?: undefined | undefined;
+            } | {
+                backend: "sqlite";
+                vectorMode: "json_fallback" | "native_vec0";
                 dimensions?: number | undefined;
                 native?: {
                     requested: boolean;
@@ -1677,7 +1702,12 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                         candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                         queryMode: "json_fallback" | "native_vec0";
                     } | undefined;
-                } | {
+                } | undefined;
+            } | {
+                backend: "postgres";
+                vectorMode: "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
                     requested: boolean;
                     available: boolean;
                     active: boolean;
@@ -1837,8 +1867,13 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 }[];
             } | undefined;
             workflowStatus?: {
-                backend: "in_memory" | "sqlite" | "postgres";
-                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                backend: "in_memory";
+                vectorMode: "in_memory";
+                dimensions?: number | undefined;
+                native?: undefined | undefined;
+            } | {
+                backend: "sqlite";
+                vectorMode: "json_fallback" | "native_vec0";
                 dimensions?: number | undefined;
                 native?: {
                     requested: boolean;
@@ -1899,7 +1934,12 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                         candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                         queryMode: "json_fallback" | "native_vec0";
                     } | undefined;
-                } | {
+                } | undefined;
+            } | {
+                backend: "postgres";
+                vectorMode: "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
                     requested: boolean;
                     available: boolean;
                     active: boolean;
@@ -2065,7 +2105,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             source: {
                 id: string;
                 label: string;
-                kind: "directory" | "url" | "storage" | "email" | "custom";
+                kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
                 status: import("@absolutejs/ai").RAGSyncSourceStatus;
                 description?: string | undefined;
                 target?: string | undefined;
@@ -2138,7 +2178,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             sources: {
                 id: string;
                 label: string;
-                kind: "directory" | "url" | "storage" | "email" | "custom";
+                kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
                 status: import("@absolutejs/ai").RAGSyncSourceStatus;
                 description?: string | undefined;
                 target?: string | undefined;
@@ -2216,7 +2256,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             source: {
                 id: string;
                 label: string;
-                kind: "directory" | "url" | "storage" | "email" | "custom";
+                kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
                 status: import("@absolutejs/ai").RAGSyncSourceStatus;
                 description?: string | undefined;
                 target?: string | undefined;
@@ -2289,7 +2329,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
             sources: {
                 id: string;
                 label: string;
-                kind: "directory" | "url" | "storage" | "email" | "custom";
+                kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
                 status: import("@absolutejs/ai").RAGSyncSourceStatus;
                 description?: string | undefined;
                 target?: string | undefined;
@@ -2471,7 +2511,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         syncSources: import("vue").Ref<{
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;
@@ -2540,7 +2580,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         }[], import("@absolutejs/ai").RAGSyncSourceRecord[] | {
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;

package/dist/src/vue/useRAGIndexAdmin.d.ts

@@ -12,8 +12,13 @@ export declare const useRAGIndexAdmin: (path: string) => {
             reason?: string | undefined;
             lastSeedMs?: number | undefined;
             status?: {
-                backend: "in_memory" | "sqlite" | "postgres";
-                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                backend: "in_memory";
+                vectorMode: "in_memory";
+                dimensions?: number | undefined;
+                native?: undefined | undefined;
+            } | {
+                backend: "sqlite";
+                vectorMode: "json_fallback" | "native_vec0";
                 dimensions?: number | undefined;
                 native?: {
                     requested: boolean;
@@ -74,7 +79,12 @@ export declare const useRAGIndexAdmin: (path: string) => {
                         candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                         queryMode: "json_fallback" | "native_vec0";
                     } | undefined;
-                } | {
+                } | undefined;
+            } | {
+                backend: "postgres";
+                vectorMode: "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
                     requested: boolean;
                     available: boolean;
                     active: boolean;
@@ -162,8 +172,13 @@ export declare const useRAGIndexAdmin: (path: string) => {
             reason?: string | undefined;
             lastSeedMs?: number | undefined;
             status?: {
-                backend: "in_memory" | "sqlite" | "postgres";
-                vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+                backend: "in_memory";
+                vectorMode: "in_memory";
+                dimensions?: number | undefined;
+                native?: undefined | undefined;
+            } | {
+                backend: "sqlite";
+                vectorMode: "json_fallback" | "native_vec0";
                 dimensions?: number | undefined;
                 native?: {
                     requested: boolean;
@@ -224,7 +239,12 @@ export declare const useRAGIndexAdmin: (path: string) => {
                         candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                         queryMode: "json_fallback" | "native_vec0";
                     } | undefined;
-                } | {
+                } | undefined;
+            } | {
+                backend: "postgres";
+                vectorMode: "native_pgvector";
+                dimensions?: number | undefined;
+                native?: {
                     requested: boolean;
                     available: boolean;
                     active: boolean;
@@ -352,8 +372,13 @@ export declare const useRAGIndexAdmin: (path: string) => {
             }[];
         } | undefined;
         workflowStatus?: {
-            backend: "in_memory" | "sqlite" | "postgres";
-            vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+            backend: "in_memory";
+            vectorMode: "in_memory";
+            dimensions?: number | undefined;
+            native?: undefined | undefined;
+        } | {
+            backend: "sqlite";
+            vectorMode: "json_fallback" | "native_vec0";
             dimensions?: number | undefined;
             native?: {
                 requested: boolean;
@@ -414,7 +439,12 @@ export declare const useRAGIndexAdmin: (path: string) => {
                     candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                     queryMode: "json_fallback" | "native_vec0";
                 } | undefined;
-            } | {
+            } | undefined;
+        } | {
+            backend: "postgres";
+            vectorMode: "native_pgvector";
+            dimensions?: number | undefined;
+            native?: {
                 requested: boolean;
                 available: boolean;
                 active: boolean;
@@ -574,8 +604,13 @@ export declare const useRAGIndexAdmin: (path: string) => {
             }[];
         } | undefined;
         workflowStatus?: {
-            backend: "in_memory" | "sqlite" | "postgres";
-            vectorMode: "in_memory" | "json_fallback" | "native_vec0" | "native_pgvector";
+            backend: "in_memory";
+            vectorMode: "in_memory";
+            dimensions?: number | undefined;
+            native?: undefined | undefined;
+        } | {
+            backend: "sqlite";
+            vectorMode: "json_fallback" | "native_vec0";
             dimensions?: number | undefined;
             native?: {
                 requested: boolean;
@@ -636,7 +671,12 @@ export declare const useRAGIndexAdmin: (path: string) => {
                     candidateCoverage?: "empty" | "under_target" | "target_sized" | "broad" | undefined;
                     queryMode: "json_fallback" | "native_vec0";
                 } | undefined;
-            } | {
+            } | undefined;
+        } | {
+            backend: "postgres";
+            vectorMode: "native_pgvector";
+            dimensions?: number | undefined;
+            native?: {
                 requested: boolean;
                 available: boolean;
                 active: boolean;
@@ -802,7 +842,7 @@ export declare const useRAGIndexAdmin: (path: string) => {
         source: {
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;
@@ -875,7 +915,7 @@ export declare const useRAGIndexAdmin: (path: string) => {
         sources: {
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;
@@ -953,7 +993,7 @@ export declare const useRAGIndexAdmin: (path: string) => {
         source: {
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;
@@ -1026,7 +1066,7 @@ export declare const useRAGIndexAdmin: (path: string) => {
         sources: {
             id: string;
             label: string;
-            kind: "directory" | "url" | "storage" | "email" | "custom";
+            kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
             status: import("@absolutejs/ai").RAGSyncSourceStatus;
             description?: string | undefined;
             target?: string | undefined;

package/dist/src/vue/useRAGOps.d.ts

@@ -80,7 +80,7 @@ export declare const useRAGOps: (path: string, autoLoad?: boolean) => {
     syncSources: import("vue").Ref<{
         id: string;
         label: string;
-        kind: "directory" | "url" | "storage" | "email" | "custom";
+        kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
         status: import("@absolutejs/ai").RAGSyncSourceStatus;
         description?: string | undefined;
         target?: string | undefined;
@@ -149,7 +149,7 @@ export declare const useRAGOps: (path: string, autoLoad?: boolean) => {
     }[], RAGSyncSourceRecord[] | {
         id: string;
         label: string;
-        kind: "directory" | "url" | "storage" | "email" | "custom";
+        kind: "directory" | "url" | "storage" | "email" | "connector" | "custom";
         status: import("@absolutejs/ai").RAGSyncSourceStatus;
         description?: string | undefined;
         target?: string | undefined;

package/dist/types/adapters.d.ts

@@ -1,37 +1,20 @@
-import type { Database } from "bun:sqlite";
+import type { RAGEmbeddingFunction } from "@absolutejs/ai";
+import type { SyncEngine } from "@absolutejs/sync/engine";
 export type InMemoryRAGStoreOptions = {
     dimensions?: number;
     mockEmbedding?: (text: string) => Promise<number[]>;
 };
-export type PostgresRAGStoreOptions = {
-    connectionString?: string;
-    sql?: InstanceType<typeof Bun.SQL>;
+export type SyncRAGStoreOptions = {
+    /** Live retrieval collection name (subscribe with the query string). Default `ragRetrieval`. */
+    collection?: string;
+    /** Embedding dimensions for the deterministic fallback. */
     dimensions?: number;
+    /** Real embedding provider (e.g. from @absolutejs/rag); falls back to a deterministic vector. */
+    embedding?: RAGEmbeddingFunction;
+    /** Engine to register on (one is created if omitted). */
+    engine?: SyncEngine;
+    /** Test/demo embedding by text. */
     mockEmbedding?: (text: string) => Promise<number[]>;
-    tableName?: string;
-    schemaName?: string;
-    distanceMetric?: "cosine" | "l2" | "inner_product";
-    queryMultiplier?: number;
-    indexType?: "none" | "hnsw" | "ivfflat";
-    indexLists?: number;
-    hnswM?: number;
-    hnswEfConstruction?: number;
-};
-export type NativeSQLiteRAGStoreOptions = {
-    mode: "vec0";
-    extensionPath?: string;
-    extensionInitSql?: string | string[];
-    distanceMetric?: "cosine" | "l2";
-    tableName?: string;
-    queryMultiplier?: number;
-    requireAvailable?: boolean;
-    resolveFromAbsolutePackages?: boolean;
-};
-export type SQLiteRAGStoreOptions = {
-    db?: Database;
-    path?: string;
-    dimensions?: number;
-    mockEmbedding?: (text: string) => Promise<number[]>;
-    tableName?: string;
-    native?: NativeSQLiteRAGStoreOptions;
+    /** Change-feed table name the live collection reads. Default `ragChunks`. */
+    table?: string;
 };

package/dist/types/index.d.ts

@@ -6,4 +6,3 @@ export type * from "./presentation";
 export type * from "./providers";
 export type * from "./quality";
 export type * from "./retrieval";
-export type * from "./sync";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/rag",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "Standalone RAG ingestion, sync, retrieval, evaluation, clients, and framework adapters extracted from AbsoluteJS",
   "license": "BSL-1.1",
   "type": "module",
@@ -15,6 +15,10 @@
       "import": "./dist/index.js",
       "types": "./dist/src/index.d.ts"
     },
+    "./adapter-kit": {
+      "import": "./dist/adapter-kit/index.js",
+      "types": "./dist/src/adapter-kit/index.d.ts"
+    },
     "./client": {
       "import": "./dist/client/index.js",
       "types": "./dist/src/client/index.d.ts"
@@ -49,8 +53,9 @@
     }
   },
   "dependencies": {
-    "@absolutejs/ai": "0.0.5",
-    "@absolutejs/linked-providers": "0.0.2"
+    "@absolutejs/ai": "^0.0.9",
+    "@absolutejs/linked-providers": "0.0.2",
+    "@absolutejs/sync": "^0.6.0"
   },
   "peerDependencies": {
     "@angular/core": "^21.0.0",
@@ -74,6 +79,7 @@
     }
   },
   "devDependencies": {
+    "@absolutejs/absolute": "^0.19.0-beta.1051",
     "@angular/core": "^21.0.0",
     "@types/bun": "1.3.9",
     "@types/react": "19.2.0",
@@ -93,6 +99,7 @@
   },
   "scripts": {
     "build": "bun run scripts/build.ts",
+    "config": "absolute config",
     "typecheck": "tsc --noEmit --project tsconfig.json",
     "lint": "eslint . --max-warnings 0",
     "format": "prettier --write .",
@@ -104,6 +111,9 @@
   },
   "typesVersions": {
     "*": {
+      "adapter-kit": [
+        "dist/src/adapter-kit/index.d.ts"
+      ],
       "client": [
         "dist/src/client/index.d.ts"
       ],

package/dist/src/adapters/postgres.d.ts

@@ -1,3 +0,0 @@
-import type { RAGVectorStore } from "@absolutejs/ai";
-import type { PostgresRAGStoreOptions } from "../../types/adapters";
-export declare const createPostgresRAGStore: (options?: PostgresRAGStoreOptions) => RAGVectorStore;

package/dist/src/adapters/sqlite.d.ts

@@ -1,3 +0,0 @@
-import type { RAGVectorStore } from "@absolutejs/ai";
-import type { SQLiteRAGStoreOptions } from "../../types/adapters";
-export declare const createSQLiteRAGStore: (options?: SQLiteRAGStoreOptions) => RAGVectorStore;

package/dist/src/internal/resolveAbsoluteSQLiteVec.d.ts

@@ -1,3 +0,0 @@
-import type { SQLiteVecResolution } from "@absolutejs/ai";
-export declare const resolveAbsoluteSQLiteVec: () => SQLiteVecResolution;
-export declare const resolveAbsoluteSQLiteVecExtensionPath: () => string | null;

package/dist/types/sync.d.ts

@@ -1,23 +0,0 @@
-import type { RAGChunkingOptions, RAGChunkingRegistryLike, RAGConnectorRuntime, RAGFileExtractor, RAGFileExtractorRegistryLike, RAGLinkedProviderCredentialResolver, RAGLinkedProviderResolutionPurpose } from "@absolutejs/ai";
-export type RAGLinkedConnectorSyncSourceOptions = {
-    id: string;
-    label: string;
-    runtime: RAGConnectorRuntime;
-    resolver: RAGLinkedProviderCredentialResolver;
-    ownerRef: string;
-    bindingId?: string;
-    externalAccountId?: string;
-    purpose?: RAGLinkedProviderResolutionPurpose;
-    requiredScopes?: string[];
-    minValidityMs?: number;
-    description?: string;
-    maxItemsPerRun?: number;
-    baseMetadata?: Record<string, unknown>;
-    defaultChunking?: RAGChunkingOptions;
-    chunkingRegistry?: RAGChunkingRegistryLike;
-    extractors?: RAGFileExtractor[];
-    extractorRegistry?: RAGFileExtractorRegistryLike;
-    metadata?: Record<string, unknown>;
-    retryAttempts?: number;
-    retryDelayMs?: number;
-};