@absolutejs/rag 0.0.12 → 0.0.14

package/dist/types/adapters.d.ts

@@ -0,0 +1,37 @@
+import type { Database } from "bun:sqlite";
+export type InMemoryRAGStoreOptions = {
+    dimensions?: number;
+    mockEmbedding?: (text: string) => Promise<number[]>;
+};
+export type PostgresRAGStoreOptions = {
+    connectionString?: string;
+    sql?: InstanceType<typeof Bun.SQL>;
+    dimensions?: number;
+    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;
+};

package/dist/types/client.d.ts

@@ -0,0 +1,33 @@
+import type { RAGBackendMaintenanceRecommendation, RAGBackendMaintenanceSummary, RAGMutationResponse, RAGOperationsResponse, RAGSearchResponse, RAGSource, RAGStatusResponse } from "@absolutejs/ai";
+export type RAGClientOptions = {
+    path: string;
+    fetch?: typeof fetch;
+};
+export type RAGDetailedSearchResponse = {
+    results: RAGSource[];
+    trace?: RAGSearchResponse["trace"];
+};
+export type RAGMaintenancePayload = Pick<RAGMutationResponse, "maintenance" | "admin" | "workflowStatus"> | Pick<RAGOperationsResponse, "maintenance" | "admin" | "status"> | Pick<RAGStatusResponse, "maintenance" | "admin" | "status"> | null | undefined;
+export type RAGMaintenanceActionDescriptor = {
+    kind: "analyze_backend" | "rebuild_native_index";
+    label: string;
+    available: boolean;
+    recommended: boolean;
+    reason?: string;
+};
+export type RAGMaintenanceOverview = {
+    activeJobCount: number;
+    actions: RAGMaintenanceActionDescriptor[];
+    availableActions: RAGMaintenanceActionDescriptor[];
+    backend?: RAGBackendMaintenanceSummary["backend"];
+    blockingRecommendations: RAGBackendMaintenanceRecommendation[];
+    criticalCount: number;
+    hasBlockingIssue: boolean;
+    infoCount: number;
+    primaryRecommendation?: RAGBackendMaintenanceRecommendation;
+    recentlyCompletedActions: NonNullable<RAGBackendMaintenanceSummary>["recentActions"];
+    recommendationCount: number;
+    recommendations: RAGBackendMaintenanceRecommendation[];
+    recommendedNow: RAGBackendMaintenanceRecommendation[];
+    warningCount: number;
+};

package/dist/types/core.d.ts

@@ -0,0 +1,7 @@
+import type { RAGDocumentChunk, RAGQueryInput, RAGUpsertInput } from "@absolutejs/ai";
+export type InternalRAGStoredChunk = RAGDocumentChunk & {
+    vector: number[];
+    sourceId: string;
+};
+export type RAGDocumentBatch = RAGUpsertInput;
+export type RAGQueryParams = RAGQueryInput;

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export type * from "@absolutejs/ai";
+export type * from "./adapters";
+export type * from "./client";
+export type * from "./core";
+export type * from "./presentation";
+export type * from "./providers";
+export type * from "./quality";
+export type * from "./retrieval";
+export type * from "./sync";

package/dist/types/presentation.d.ts

@@ -0,0 +1,24 @@
+import type { AIMessage, RAGHTMXWorkflowRenderConfig, RAGStreamStage } from "@absolutejs/ai";
+export type RAGStreamProgress = {
+    stage: RAGStreamStage;
+    conversationId?: string;
+    messageId?: string;
+    retrievalStartedAt?: number;
+    retrievedAt?: number;
+    retrievalDurationMs?: number;
+    hasContent: boolean;
+    hasRetrieved: boolean;
+    hasSources: boolean;
+    hasThinking: boolean;
+    hasToolCalls: boolean;
+    isComplete: boolean;
+    isError: boolean;
+    isIdle: boolean;
+    isRetrieving: boolean;
+    isRetrieved: boolean;
+    isStreaming: boolean;
+    isSubmitting: boolean;
+    sourceCount: number;
+    latestMessage: AIMessage | undefined;
+};
+export type ResolvedRAGWorkflowRenderers = Required<RAGHTMXWorkflowRenderConfig>;

package/dist/types/providers.d.ts

@@ -0,0 +1,108 @@
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit | BunFetchRequestInit) => Promise<Response>;
+export type OpenAIEmbeddingsConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    dimensions?: number;
+    fetch?: FetchLike;
+};
+export type OpenAICompatibleEmbeddingsConfig = OpenAIEmbeddingsConfig & {
+    baseUrl: string;
+};
+export type GeminiEmbeddingsConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    dimensions?: number;
+    fetch?: FetchLike;
+};
+export type OllamaEmbeddingsConfig = {
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+};
+export type CrossEncoderRerankerConfig = {
+    apiKey: string;
+    defaultModel?: string;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    /** Extra headers (e.g. API version) merged into the request. */
+    headers?: Record<string, string>;
+};
+export type OpenAITranscriptionConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    language?: string;
+    prompt?: string;
+};
+export type OpenAICompatibleTranscriptionConfig = OpenAITranscriptionConfig & {
+    baseUrl: string;
+};
+export type OpenAIOCRConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    prompt?: string;
+};
+export type OpenAICompatibleOCRConfig = OpenAIOCRConfig & {
+    baseUrl: string;
+};
+export type GeminiOCRConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    prompt?: string;
+};
+export type OllamaOCRConfig = {
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    prompt?: string;
+};
+export type OllamaTranscriptionConfig = {
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    prompt?: string;
+};
+export type AnthropicOCRConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    fetch?: FetchLike;
+    prompt?: string;
+};
+export type GmailEmailSyncConfig = {
+    accessToken: string;
+    userId?: string;
+    query?: string;
+    labelIds?: string[];
+    includeSpamTrash?: boolean;
+    maxResults?: number;
+    fetch?: typeof fetch;
+};
+export type GraphEmailSyncConfig = {
+    accessToken: string;
+    baseUrl?: string;
+    userId?: string;
+    folderId?: string;
+    filter?: string;
+    search?: string;
+    top?: number;
+    fetch?: typeof fetch;
+};
+export type IMAPEmailSyncConfig = {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    username: string;
+    password: string;
+    mailbox?: string;
+    search?: string[];
+    maxResults?: number;
+};
+export {};

package/dist/types/quality.d.ts

@@ -0,0 +1,41 @@
+import type { Database } from "bun:sqlite";
+type SQLiteStoreOptionsBase = {
+    db?: Database;
+    path?: string;
+    tableName?: string;
+};
+export type SQLiteRAGSearchTraceStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGEvaluationHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGEvaluationSuiteSnapshotHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGAnswerGroundingEvaluationHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGSearchTracePruneHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalComparisonHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalReleaseDecisionStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalBaselineStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalReleaseIncidentStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalLaneHandoffDecisionStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalLaneHandoffIncidentStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalLaneHandoffIncidentHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalIncidentRemediationDecisionStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalIncidentRemediationExecutionHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalLaneHandoffAutoCompletePolicyHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalReleaseLanePolicyHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalBaselineGatePolicyHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGRetrievalReleaseLaneEscalationPolicyHistoryStoreOptions = SQLiteStoreOptionsBase;
+export type SQLiteRAGGovernanceStoreBundleOptions = {
+    db?: Database;
+    path?: string;
+    tablePrefix?: string;
+};
+export type SQLiteRAGStoreMigrationOptions = {
+    db?: Database;
+    path?: string;
+    descriptors?: Array<{
+        tableName: string;
+        columns: Array<{
+            name: string;
+            definition: string;
+        }>;
+    }>;
+};
+export {};

package/dist/types/retrieval.d.ts

@@ -0,0 +1,38 @@
+import type { RAGEmbeddingFunction, RAGEmbeddingProviderLike, RAGQueryTransformer, RAGQueryTransformProviderLike, RAGReranker, RAGRerankerProviderLike, RAGRetrievalStrategyProviderLike, RAGVectorStore } from "@absolutejs/ai";
+export type CreateRAGCollectionOptions = {
+    store: RAGVectorStore;
+    embedding?: RAGEmbeddingProviderLike;
+    defaultTopK?: number;
+    defaultCandidateMultiplier?: number;
+    defaultModel?: string;
+    queryTransform?: RAGQueryTransformProviderLike;
+    retrievalStrategy?: RAGRetrievalStrategyProviderLike;
+    rerank?: RAGRerankerProviderLike;
+};
+export type CreateRAGRerankerOptions = {
+    rerank: RAGReranker;
+    defaultModel?: string;
+    providerName?: string;
+};
+export type HeuristicRAGRerankerOptions = {
+    defaultModel?: string;
+    providerName?: string;
+};
+export type CreateRAGQueryTransformOptions = {
+    transform: RAGQueryTransformer;
+    defaultModel?: string;
+    providerName?: string;
+};
+export type HeuristicRAGQueryTransformOptions = {
+    defaultModel?: string;
+    providerName?: string;
+};
+export type HeuristicRAGRetrievalStrategyOptions = {
+    providerName?: string;
+    defaultLabel?: string;
+};
+export type CreateRAGEmbeddingProviderOptions = {
+    embed: RAGEmbeddingFunction;
+    dimensions?: number;
+    defaultModel?: string;
+};

package/dist/types/sync.d.ts

@@ -0,0 +1,23 @@
+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;
+};

package/dist/vue/{ai/index.js → index.js}

@@ -68,10 +68,10 @@ var __decorateElement = (array, flags, name, decorators, target, extra) => {
   return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
 };
 
-// src/vue/ai/useRAGChunkPreview.ts
+// src/vue/useRAGChunkPreview.ts
 import { computed, ref } from "vue";
 
-// src/ai/client/ragClient.ts
+// src/client/ragClient.ts
 var UNFOUND_INDEX = -1;
 var jsonHeaders = {
   "Content-Type": "application/json"
@@ -1343,7 +1343,7 @@ var createRAGClient = (options) => {
   };
 };
 
-// src/ai/rag/grounding.ts
+// src/retrieval/grounding.ts
 var getContextString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
 var getContextNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getAttachmentName = (source, title) => {
@@ -2037,10 +2037,10 @@ var buildRAGGroundingReferences = (sources) => {
   });
 };
 
-// src/ai/rag/quality.ts
+// src/quality/quality.ts
 var {mkdir, readFile} = (() => ({}));
 
-// src/ai/rag/atomicWrite.ts
+// src/internal/atomicWrite.ts
 var {open, rename, unlink} = (() => ({}));
 
 // node:path
@@ -2363,7 +2363,7 @@ var sep = "/";
 var delimiter = ":";
 var posix = ((p) => (p.posix = p, p))({ resolve, normalize, isAbsolute, join, relative, _makeLong, dirname, basename, extname, format, parse, sep, delimiter, win32: null, posix: null });
 
-// src/ai/rag/quality.ts
+// src/quality/quality.ts
 import { generateId } from "@absolutejs/ai";
 var buildRAGEvaluationLeaderboard = (runs) => {
   const sorted = [...runs].sort((left, right) => {
@@ -2413,7 +2413,7 @@ var runRAGEvaluationSuite = async ({
   };
 };
 
-// src/ai/rag/presentation.ts
+// src/presentation/presentation.ts
 var buildSourceGroupKey = (source) => source.source ?? source.title ?? source.chunkId;
 var buildSourceLabel2 = (source) => source.source ?? source.title ?? source.chunkId;
 var getContextNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
@@ -4042,7 +4042,7 @@ var resolveRAGStreamStage = ({
   }
   return "streaming";
 };
-// src/vue/ai/useRAGChunkPreview.ts
+// src/vue/useRAGChunkPreview.ts
 var useRAGChunkPreview = (path) => {
   const client = createRAGClient({ path });
   const preview = ref(null);
@@ -4128,10 +4128,10 @@ var useRAGChunkPreview = (path) => {
     selectSiblingSection
   };
 };
-// src/vue/ai/useRAG.ts
+// src/vue/useRAG.ts
 import { computed as computed9 } from "vue";
 
-// src/vue/ai/useRAGCitations.ts
+// src/vue/useRAGCitations.ts
 import { computed as computed2 } from "vue";
 var useRAGCitations = (sources) => {
   const citations = computed2(() => buildRAGCitations(sources.value));
@@ -4148,7 +4148,7 @@ var useRAGCitations = (sources) => {
   };
 };
 
-// src/vue/ai/useRAGDocuments.ts
+// src/vue/useRAGDocuments.ts
 import { ref as ref2 } from "vue";
 var useRAGDocuments = (path) => {
   const client = createRAGClient({ path });
@@ -4187,7 +4187,7 @@ var useRAGDocuments = (path) => {
   };
 };
 
-// src/vue/ai/useRAGEvaluate.ts
+// src/vue/useRAGEvaluate.ts
 import { computed as computed3, ref as ref3 } from "vue";
 var useRAGEvaluate = (path) => {
   const client = createRAGClient({ path });
@@ -4269,7 +4269,7 @@ var useRAGEvaluate = (path) => {
   };
 };
 
-// src/vue/ai/useRAGGrounding.ts
+// src/vue/useRAGGrounding.ts
 import { computed as computed4 } from "vue";
 var useRAGGrounding = (content, sources) => {
   const groundedAnswer = computed4(() => buildRAGGroundedAnswer(content.value, sources.value));
@@ -4288,7 +4288,7 @@ var useRAGGrounding = (content, sources) => {
   };
 };
 
-// src/vue/ai/useRAGIngest.ts
+// src/vue/useRAGIngest.ts
 import { ref as ref4 } from "vue";
 var useRAGIngest = (path) => {
   const client = createRAGClient({ path });
@@ -4408,7 +4408,7 @@ var useRAGIngest = (path) => {
   };
 };
 
-// src/vue/ai/useRAGIndexAdmin.ts
+// src/vue/useRAGIndexAdmin.ts
 import { ref as ref5 } from "vue";
 var useRAGIndexAdmin = (path) => {
   const client = createRAGClient({ path });
@@ -4555,7 +4555,7 @@ var useRAGIndexAdmin = (path) => {
   };
 };
 
-// src/vue/ai/useRAGOps.ts
+// src/vue/useRAGOps.ts
 import { onMounted, ref as ref6 } from "vue";
 var useRAGOps = (path, autoLoad = true) => {
   const client = createRAGClient({ path });
@@ -4641,7 +4641,7 @@ var useRAGOps = (path, autoLoad = true) => {
   };
 };
 
-// src/vue/ai/useRAGSearch.ts
+// src/vue/useRAGSearch.ts
 import { ref as ref7 } from "vue";
 var useRAGSearch = (path) => {
   const client = createRAGClient({ path });
@@ -4709,7 +4709,7 @@ var useRAGSearch = (path) => {
   };
 };
 
-// src/vue/ai/useRAGSources.ts
+// src/vue/useRAGSources.ts
 import { computed as computed5 } from "vue";
 var useRAGSources = (messages) => {
   const latestAssistantMessage = computed5(() => getLatestAssistantMessage(messages.value));
@@ -4734,7 +4734,7 @@ var useRAGSources = (messages) => {
   };
 };
 
-// src/vue/ai/useRAGStatus.ts
+// src/vue/useRAGStatus.ts
 import { onMounted as onMounted2, ref as ref8 } from "vue";
 var useRAGStatus = (path, autoLoad = true) => {
   const client = createRAGClient({ path });
@@ -4780,14 +4780,14 @@ var useRAGStatus = (path, autoLoad = true) => {
   };
 };
 
-// src/vue/ai/useRAGWorkflow.ts
+// src/vue/useRAGWorkflow.ts
 import { computed as computed8 } from "vue";
 
-// src/vue/ai/useRAGStream.ts
+// src/vue/useRAGStream.ts
 import { computed as computed7 } from "vue";
 import { useAIStream } from "@absolutejs/ai/vue";
 
-// src/vue/ai/useRAGStreamProgress.ts
+// src/vue/useRAGStreamProgress.ts
 import { computed as computed6 } from "vue";
 var useRAGStreamProgress = (params) => computed6(() => buildRAGStreamProgress({
   error: params.error.value,
@@ -4795,7 +4795,7 @@ var useRAGStreamProgress = (params) => computed6(() => buildRAGStreamProgress({
   messages: params.messages.value
 }));
 
-// src/vue/ai/useRAGStream.ts
+// src/vue/useRAGStream.ts
 var useRAGStream = (path, conversationId) => {
   const stream = useAIStream(path, conversationId);
   const workflow = computed7(() => buildRAGAnswerWorkflowState({
@@ -4846,7 +4846,7 @@ var useRAGStream = (path, conversationId) => {
   };
 };
 
-// src/vue/ai/useRAGWorkflow.ts
+// src/vue/useRAGWorkflow.ts
 var useRAGWorkflow = (path, conversationId) => {
   const stream = useRAGStream(path, conversationId);
   const state = computed8(() => stream.workflow.value);
@@ -4856,7 +4856,7 @@ var useRAGWorkflow = (path, conversationId) => {
   };
 };
 
-// src/vue/ai/useRAG.ts
+// src/vue/useRAG.ts
 var useRAG = (path, options = {}) => {
   const search = useRAGSearch(path);
   const ingest = useRAGIngest(path);
@@ -4904,5 +4904,5 @@ export {
   useRAG
 };
 
-//# debugId=BB4A2AD75E5F3C6864756E2164756E21
+//# debugId=1CD9CC83D4D9177164756E2164756E21
 //# sourceMappingURL=index.js.map