@absolutejs/rag 0.0.12 → 0.0.14

package/dist/src/{ai/rag → providers}/embeddingProviders.d.ts

@@ -1,27 +1,5 @@
 import type { RAGEmbeddingProvider } from "@absolutejs/ai";
-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;
-};
+import type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig } from "../../types/providers";
 export declare const alibabaEmbeddings: (config: {
     apiKey: string;
 }) => RAGEmbeddingProvider;
@@ -47,4 +25,3 @@ export declare const openaiEmbeddings: (config: OpenAIEmbeddingsConfig) => RAGEm
 export declare const xaiEmbeddings: (config: {
     apiKey: string;
 }) => RAGEmbeddingProvider;
-export {};

package/dist/src/providers/extractorProviders.d.ts

@@ -0,0 +1,10 @@
+import type { RAGMediaTranscriber, RAGOCRProvider } from "@absolutejs/ai";
+import type { AnthropicOCRConfig, GeminiOCRConfig, OllamaOCRConfig, OllamaTranscriptionConfig, OpenAICompatibleOCRConfig, OpenAICompatibleTranscriptionConfig, OpenAIOCRConfig, OpenAITranscriptionConfig } from "../../types/providers";
+export declare const anthropicOCR: (config: AnthropicOCRConfig) => RAGOCRProvider;
+export declare const geminiOCR: (config: GeminiOCRConfig) => RAGOCRProvider;
+export declare const ollamaOCR: (config?: OllamaOCRConfig) => RAGOCRProvider;
+export declare const ollamaTranscriber: (config?: OllamaTranscriptionConfig) => RAGMediaTranscriber;
+export declare const openaiCompatibleOCR: (config: OpenAICompatibleOCRConfig) => RAGOCRProvider;
+export declare const openaiCompatibleTranscriber: (config: OpenAICompatibleTranscriptionConfig) => RAGMediaTranscriber;
+export declare const openaiOCR: (config: OpenAIOCRConfig) => RAGOCRProvider;
+export declare const openaiTranscriber: (config: OpenAITranscriptionConfig) => RAGMediaTranscriber;

package/dist/src/{ai/rag → providers}/rerankerProviders.d.ts

@@ -1,14 +1,5 @@
 import type { RAGRerankerProvider } from "@absolutejs/ai";
-type FetchLike = (input: RequestInfo | URL, init?: RequestInit | BunFetchRequestInit) => Promise<Response>;
-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>;
-};
+import type { CrossEncoderRerankerConfig } from "../../types/providers";
 export declare const createCohereRAGReranker: (config: CrossEncoderRerankerConfig) => RAGRerankerProvider;
 export declare const createVoyageRAGReranker: (config: CrossEncoderRerankerConfig) => RAGRerankerProvider;
 export declare const createJinaRAGReranker: (config: CrossEncoderRerankerConfig) => RAGRerankerProvider;
-export {};

package/dist/src/{ai/rag → quality}/quality.d.ts

@@ -1,4 +1,5 @@
-import type { Database } from "bun:sqlite";
+import type { SQLiteRAGAnswerGroundingEvaluationHistoryStoreOptions, SQLiteRAGEvaluationHistoryStoreOptions, SQLiteRAGEvaluationSuiteSnapshotHistoryStoreOptions, SQLiteRAGGovernanceStoreBundleOptions, SQLiteRAGRetrievalBaselineGatePolicyHistoryStoreOptions, SQLiteRAGRetrievalBaselineStoreOptions, SQLiteRAGRetrievalComparisonHistoryStoreOptions, SQLiteRAGRetrievalIncidentRemediationDecisionStoreOptions, SQLiteRAGRetrievalIncidentRemediationExecutionHistoryStoreOptions, SQLiteRAGRetrievalLaneHandoffAutoCompletePolicyHistoryStoreOptions, SQLiteRAGRetrievalLaneHandoffDecisionStoreOptions, SQLiteRAGRetrievalLaneHandoffIncidentHistoryStoreOptions, SQLiteRAGRetrievalLaneHandoffIncidentStoreOptions, SQLiteRAGRetrievalReleaseDecisionStoreOptions, SQLiteRAGRetrievalReleaseLaneEscalationPolicyHistoryStoreOptions, SQLiteRAGRetrievalReleaseLanePolicyHistoryStoreOptions, SQLiteRAGRetrievalReleaseIncidentStoreOptions, SQLiteRAGSearchTracePruneHistoryStoreOptions, SQLiteRAGSearchTraceStoreOptions, SQLiteRAGStoreMigrationOptions } from "../../types/quality";
+export type * from "../../types/quality";
 import type { RAGAnswerGroundingCaseDifficultyHistory, RAGAnswerGroundingCaseDifficultyHistoryStore, RAGAnswerGroundingCaseDifficultyRun, RAGAnswerGroundingCaseDifficultyRunDiff, RAGAnswerGroundingEvaluationCase, RAGAnswerGroundingEvaluationCaseDifficultyEntry, RAGAnswerGroundingEvaluationCaseResult, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationLeaderboardEntry, RAGAnswerGroundingEvaluationHistoryStore, RAGAnswerGroundingEvaluationInput, RAGAnswerGroundingEvaluationResponse, RAGAnswerGroundingEvaluationRun, RAGAnswerGroundingEvaluationRunDiff, RAGCollection, RAGEvaluationCase, RAGEvaluationCaseTraceSnapshot, RAGEvaluationCaseResult, RAGEvaluationHistory, RAGEvaluationHistoryStore, RAGEvaluationInput, RAGEvaluationLeaderboardEntry, RAGEvaluationResponse, RAGEvaluationRunDiff, RAGDocumentChunk, RAGEvaluationSuite, RAGEvaluationSuiteGenerationOptions, RAGEvaluationSuiteDatasetSummary, RAGEvaluationSuiteSnapshot, RAGEvaluationSuiteSnapshotDiff, RAGEvaluationSuiteSnapshotHistory, RAGEvaluationSuiteSnapshotHistoryStore, RAGEvaluationSuiteRun, RAGEvaluationEntityQualityView, RAGAnswerGroundingEntityQualityView, RAGRetrievalTraceSummaryRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalBaselineGatePolicy, RAGRetrievalBaselineGatePolicyHistoryRecord, RAGRetrievalBaselineGatePolicyHistoryStore, RAGRetrievalComparisonDecisionSummary, RAGRetrievalReleaseVerdict, RAGRetrievalComparisonHistoryStore, RAGRetrievalBaselineRecord, RAGRetrievalBaselineStore, RAGRetrievalLaneHandoffDecisionRecord, RAGRetrievalLaneHandoffDecisionStore, RAGRetrievalLaneHandoffIncidentHistoryRecord, RAGRetrievalLaneHandoffIncidentHistoryStore, RAGRetrievalLaneHandoffAutoCompletePolicyHistoryRecord, RAGRetrievalLaneHandoffAutoCompletePolicyHistoryStore, RAGRetrievalLaneHandoffIncidentRecord, RAGRetrievalLaneHandoffIncidentStore, RAGRetrievalIncidentRemediationDecisionRecord, RAGRetrievalIncidentRemediationDecisionStore, RAGRetrievalIncidentRemediationExecutionHistoryRecord, RAGRetrievalIncidentRemediationExecutionHistoryStore, RAGRetrievalReleaseDecisionRecord, RAGRetrievalReleaseLanePolicyHistoryRecord, RAGRetrievalReleaseLanePolicyHistoryStore, RAGRetrievalReleaseLaneEscalationPolicyHistoryRecord, RAGRetrievalReleaseLaneEscalationPolicyHistoryStore, RAGRetrievalReleaseDecisionStore, RAGRetrievalReleaseIncidentRecord, RAGRetrievalReleaseIncidentStore, RAGRetrievalComparisonRun, RAGRetrievalComparisonEntry, RAGRetrievalTrace, RAGRetrievalTraceComparisonSummary, RAGRetrievalTraceComparisonSummaryDiff, RAGRetrievalComparisonSummary, RAGRerankerCandidate, RAGRerankerComparison, RAGRerankerComparisonEntry, RAGRerankerComparisonSummary, RAGRerankerProviderLike, RAGRetrievalTraceTrend, RAGSearchTraceDiff, RAGSearchTraceGroupHistory, RAGSearchTraceHistory, RAGChatPluginConfig, RAGSearchTracePruneInput, RAGSearchTracePruneHistoryStore, RAGSearchTracePruneRun, RAGSearchTracePrunePreview, RAGSearchTracePruneResult, RAGSearchTraceRecord, RAGSearchTraceStats, RAGSearchTraceStore, RAGRemediationAction, RAGSource, RAGSQLiteStoreMigrationInspection, RAGSQLiteStoreMigrationResult } from "@absolutejs/ai";
 export declare const buildRAGRetrievalReleaseVerdict: ({ groupKey, decisionSummary, }: {
     groupKey?: string;
@@ -39,116 +40,9 @@ export declare const createRAGFileRetrievalBaselineGatePolicyHistoryStore: (path
 export declare const createRAGFileRetrievalReleaseLaneEscalationPolicyHistoryStore: (path: string) => RAGRetrievalReleaseLaneEscalationPolicyHistoryStore;
 export declare const createRAGFileSearchTraceStore: (path: string) => RAGSearchTraceStore;
 export declare const createRAGFileSearchTracePruneHistoryStore: (path: string) => RAGSearchTracePruneHistoryStore;
-export type SQLiteRAGSearchTraceStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGEvaluationHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGEvaluationSuiteSnapshotHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGAnswerGroundingEvaluationHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGSearchTracePruneHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalComparisonHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalReleaseDecisionStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalBaselineStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalReleaseIncidentStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalLaneHandoffDecisionStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalLaneHandoffIncidentStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalLaneHandoffIncidentHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalIncidentRemediationDecisionStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalIncidentRemediationExecutionHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalLaneHandoffAutoCompletePolicyHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalReleaseLanePolicyHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalBaselineGatePolicyHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGRetrievalReleaseLaneEscalationPolicyHistoryStoreOptions = {
-    db?: Database;
-    path?: string;
-    tableName?: string;
-};
-export type SQLiteRAGGovernanceStoreBundleOptions = {
-    db?: Database;
-    path?: string;
-    tablePrefix?: string;
-};
 export declare const createRAGSQLiteEvaluationHistoryStore: (options: SQLiteRAGEvaluationHistoryStoreOptions) => RAGEvaluationHistoryStore;
 export declare const createRAGSQLiteEvaluationSuiteSnapshotHistoryStore: (options: SQLiteRAGEvaluationSuiteSnapshotHistoryStoreOptions) => RAGEvaluationSuiteSnapshotHistoryStore;
 export declare const createRAGSQLiteAnswerGroundingEvaluationHistoryStore: (options: SQLiteRAGAnswerGroundingEvaluationHistoryStoreOptions) => RAGAnswerGroundingEvaluationHistoryStore;
-type SQLiteStoreMigrationDescriptor = {
-    tableName: string;
-    columns: Array<{
-        name: string;
-        definition: string;
-    }>;
-};
-export type SQLiteRAGStoreMigrationOptions = {
-    db?: Database;
-    path?: string;
-    descriptors?: SQLiteStoreMigrationDescriptor[];
-};
 export declare const inspectRAGSQLiteStoreMigrations: (options?: SQLiteRAGStoreMigrationOptions) => RAGSQLiteStoreMigrationInspection;
 export declare const applyRAGSQLiteStoreMigrations: (options?: SQLiteRAGStoreMigrationOptions) => RAGSQLiteStoreMigrationResult;
 export declare const createRAGSQLiteSearchTraceStore: (options: SQLiteRAGSearchTraceStoreOptions) => RAGSearchTraceStore;
@@ -604,4 +498,3 @@ export declare const summarizeRAGEvaluationCase: ({ caseIndex, caseInput, query,
 }) => RAGEvaluationCaseResult;
 export declare const summarizeRAGRerankerComparison: (entries: RAGRerankerComparisonEntry[]) => RAGRerankerComparisonSummary;
 export declare const summarizeRAGRetrievalComparison: (entries: RAGRetrievalComparisonEntry[]) => RAGRetrievalComparisonSummary;
-export {};

package/dist/src/react/{ai/useRAG.d.ts → useRAG.d.ts}

@@ -65,7 +65,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         suites: import("@absolutejs/ai").RAGEvaluationSuite[];
     };
     grounding: {
-        coverage: "grounded" | "partial" | "ungrounded";
+        coverage: "partial" | "grounded" | "ungrounded";
         groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
         hasCitations: boolean;
         hasGrounding: boolean;
@@ -168,45 +168,45 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         reset: () => void;
         results: import("@absolutejs/ai").RAGSource[];
         search: (input: {
-            filter?: Record<string, unknown> | undefined;
             query: string;
-            candidateTopK?: number | undefined;
-            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
-            model?: string | undefined;
-            topK?: number | undefined;
-            scoreThreshold?: number | undefined;
             nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
-            nativeQueryMultiplier?: number | undefined;
             nativeCandidateLimit?: number | undefined;
             nativeMaxBackfills?: number | undefined;
             nativeMinResults?: number | undefined;
             nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            filter?: Record<string, unknown> | undefined;
             queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
-            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            candidateTopK?: number | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            nativeQueryMultiplier?: number | undefined;
             persistTrace?: boolean | undefined;
             traceGroupKey?: string | undefined;
             traceTags?: string[] | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
         }) => Promise<import("@absolutejs/ai").RAGSource[]>;
         searchWithTrace: (input: {
-            filter?: Record<string, unknown> | undefined;
             query: string;
-            candidateTopK?: number | undefined;
-            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
-            model?: string | undefined;
-            topK?: number | undefined;
-            scoreThreshold?: number | undefined;
             nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
-            nativeQueryMultiplier?: number | undefined;
             nativeCandidateLimit?: number | undefined;
             nativeMaxBackfills?: number | undefined;
             nativeMinResults?: number | undefined;
             nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            filter?: Record<string, unknown> | undefined;
             queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
-            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            candidateTopK?: number | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            nativeQueryMultiplier?: number | undefined;
             persistTrace?: boolean | undefined;
             traceGroupKey?: string | undefined;
             traceTags?: string[] | undefined;
-        }) => Promise<import("../../ai/client").RAGDetailedSearchResponse>;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+        }) => Promise<import("../client").RAGDetailedSearchResponse>;
         setResults: import("react").Dispatch<import("react").SetStateAction<import("@absolutejs/ai").RAGSource[]>>;
         trace: import("@absolutejs/ai").RAGRetrievalTrace | undefined;
     };
@@ -233,7 +233,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         state: import("@absolutejs/ai").RAGAnswerWorkflowState;
         citationReferenceMap: import("@absolutejs/ai").RAGCitationReferenceMap;
         citations: import("@absolutejs/ai").RAGCitation[];
-        coverage: "grounded" | "partial" | "ungrounded";
+        coverage: "partial" | "grounded" | "ungrounded";
         groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
         groundingReferences: import("@absolutejs/ai").RAGGroundingReference[];
         hasGrounding: boolean;
@@ -287,7 +287,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
         state: import("@absolutejs/ai").RAGAnswerWorkflowState;
         citationReferenceMap: import("@absolutejs/ai").RAGCitationReferenceMap;
         citations: import("@absolutejs/ai").RAGCitation[];
-        coverage: "grounded" | "partial" | "ungrounded";
+        coverage: "partial" | "grounded" | "ungrounded";
         groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
         groundingReferences: import("@absolutejs/ai").RAGGroundingReference[];
         hasGrounding: boolean;

package/dist/src/react/{ai/useRAGGrounding.d.ts → useRAGGrounding.d.ts}

@@ -1,6 +1,6 @@
 import type { RAGSource } from "@absolutejs/ai";
 export declare const useRAGGrounding: (content: string, sources: RAGSource[]) => {
-    coverage: "grounded" | "partial" | "ungrounded";
+    coverage: "partial" | "grounded" | "ungrounded";
     groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
     hasCitations: boolean;
     hasGrounding: boolean;

package/dist/src/react/{ai/useRAGSearch.d.ts → useRAGSearch.d.ts}

@@ -1,5 +1,5 @@
 import type { RAGSearchRequest, RAGSource } from "@absolutejs/ai";
-import { type RAGDetailedSearchResponse } from "../../ai/client/ragClient";
+import type { RAGDetailedSearchResponse } from "../../types/client";
 type SearchRequest = Omit<RAGSearchRequest, "includeTrace">;
 export declare const useRAGSearch: (path: string) => {
     error: string | null;

package/dist/src/react/{ai/useRAGStream.d.ts → useRAGStream.d.ts}

@@ -2,7 +2,7 @@ import type { AIAttachment } from "@absolutejs/ai";
 export declare const useRAGStream: (path?: string, conversationId?: string) => {
     citationReferenceMap: import("@absolutejs/ai").RAGCitationReferenceMap;
     citations: import("@absolutejs/ai").RAGCitation[];
-    coverage: "grounded" | "partial" | "ungrounded";
+    coverage: "partial" | "grounded" | "ungrounded";
     groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
     groundingReferences: import("@absolutejs/ai").RAGGroundingReference[];
     hasGrounding: boolean;

package/dist/src/react/{ai/useRAGStreamProgress.d.ts → useRAGStreamProgress.d.ts}

@@ -1,5 +1,5 @@
 import type { AIMessage } from "@absolutejs/ai";
-import { type RAGStreamProgress } from "../../ai/rag/workflowState";
+import { type RAGStreamProgress } from "../presentation/workflowState";
 export declare const useRAGStreamProgress: (params: {
     error: string | null;
     isStreaming: boolean;

package/dist/src/react/{ai/useRAGWorkflow.d.ts → useRAGWorkflow.d.ts}

@@ -2,7 +2,7 @@ export declare const useRAGWorkflow: (path?: string, conversationId?: string) =>
     state: import("@absolutejs/ai").RAGAnswerWorkflowState;
     citationReferenceMap: import("@absolutejs/ai").RAGCitationReferenceMap;
     citations: import("@absolutejs/ai").RAGCitation[];
-    coverage: "grounded" | "partial" | "ungrounded";
+    coverage: "partial" | "grounded" | "ungrounded";
     groundedAnswer: import("@absolutejs/ai").RAGGroundedAnswer;
     groundingReferences: import("@absolutejs/ai").RAGGroundingReference[];
     hasGrounding: boolean;

package/dist/src/retrieval/collection.d.ts

@@ -0,0 +1,6 @@
+import type { RAGCollection, RAGCollectionSearchParams, RAGDocumentIngestInput, RAGQueryResult, RAGUpsertInput } from "@absolutejs/ai";
+import type { CreateRAGCollectionOptions } from "../../types/retrieval";
+export declare const createRAGCollection: (options: CreateRAGCollectionOptions) => RAGCollection;
+export declare const ingestDocuments: (collection: RAGCollection, input: RAGUpsertInput) => Promise<void>;
+export declare const ingestRAGDocuments: (collection: RAGCollection, input: RAGDocumentIngestInput) => Promise<void>;
+export declare const searchDocuments: (collection: RAGCollection, input: RAGCollectionSearchParams) => Promise<RAGQueryResult[]>;

package/dist/src/{ai/rag → retrieval}/embedding.d.ts

@@ -1,9 +1,5 @@
 import type { RAGEmbeddingFunction, RAGEmbeddingProvider, RAGEmbeddingProviderLike } from "@absolutejs/ai";
-export type CreateRAGEmbeddingProviderOptions = {
-    embed: RAGEmbeddingFunction;
-    dimensions?: number;
-    defaultModel?: string;
-};
+import type { CreateRAGEmbeddingProviderOptions } from "../../types/retrieval";
 export declare const createRAGEmbeddingProvider: (options: CreateRAGEmbeddingProviderOptions) => RAGEmbeddingProvider;
 export declare const resolveRAGEmbeddingProvider: (providerLike: RAGEmbeddingProviderLike | undefined, fallbackEmbed?: RAGEmbeddingFunction, defaultModel?: string) => RAGEmbeddingProvider;
 export declare const validateRAGEmbeddingDimensions: (vector: number[], expectedDimensions: number | undefined, context: "query" | "chunk") => void;

package/dist/src/{ai/rag → retrieval}/queryTransforms.d.ts

@@ -1,13 +1,5 @@
-import type { RAGQueryTransformInput, RAGQueryTransformProvider, RAGQueryTransformProviderLike, RAGQueryTransformResult, RAGQueryTransformer } from "@absolutejs/ai";
-export type CreateRAGQueryTransformOptions = {
-    transform: RAGQueryTransformer;
-    defaultModel?: string;
-    providerName?: string;
-};
-export type HeuristicRAGQueryTransformOptions = {
-    defaultModel?: string;
-    providerName?: string;
-};
+import type { RAGQueryTransformInput, RAGQueryTransformProvider, RAGQueryTransformProviderLike, RAGQueryTransformResult } from "@absolutejs/ai";
+import type { CreateRAGQueryTransformOptions, HeuristicRAGQueryTransformOptions } from "../../types/retrieval";
 export declare const createHeuristicRAGQueryTransform: (options?: HeuristicRAGQueryTransformOptions) => RAGQueryTransformProvider;
 export declare const createRAGQueryTransform: (options: CreateRAGQueryTransformOptions) => RAGQueryTransformProvider;
 export declare const resolveRAGQueryTransform: (queryTransform: RAGQueryTransformProviderLike | undefined) => RAGQueryTransformProvider | null;

package/dist/src/{ai/rag → retrieval}/reranking.d.ts

@@ -1,13 +1,5 @@
-import type { RAGQueryResult, RAGReranker, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike } from "@absolutejs/ai";
-export type CreateRAGRerankerOptions = {
-    rerank: RAGReranker;
-    defaultModel?: string;
-    providerName?: string;
-};
-export type HeuristicRAGRerankerOptions = {
-    defaultModel?: string;
-    providerName?: string;
-};
+import type { RAGQueryResult, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike } from "@absolutejs/ai";
+import type { CreateRAGRerankerOptions, HeuristicRAGRerankerOptions } from "../../types/retrieval";
 export declare const applyRAGReranking: ({ input, reranker, }: {
     input: RAGRerankerInput;
     reranker?: RAGRerankerProviderLike;

package/dist/src/{ai/rag → retrieval}/retrievalStrategies.d.ts

@@ -1,6 +1,3 @@
 import type { RAGRetrievalStrategyProvider } from "@absolutejs/ai";
-export type HeuristicRAGRetrievalStrategyOptions = {
-    providerName?: string;
-    defaultLabel?: string;
-};
+import type { HeuristicRAGRetrievalStrategyOptions } from "../../types/retrieval";
 export declare const createHeuristicRAGRetrievalStrategy: (options?: HeuristicRAGRetrievalStrategyOptions) => RAGRetrievalStrategyProvider;

package/dist/src/svelte/{ai/createRAG.d.ts → createRAG.d.ts}

@@ -65,7 +65,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         suites: import("svelte/store").Writable<import("@absolutejs/ai").RAGEvaluationSuite[]>;
     };
     grounding: {
-        coverage: import("svelte/store").Readable<"grounded" | "partial" | "ungrounded">;
+        coverage: import("svelte/store").Readable<"partial" | "grounded" | "ungrounded">;
         groundedAnswer: import("svelte/store").Readable<import("@absolutejs/ai").RAGGroundedAnswer>;
         hasCitations: import("svelte/store").Readable<boolean>;
         hasGrounding: import("svelte/store").Readable<boolean>;
@@ -170,45 +170,45 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         reset: () => void;
         results: import("svelte/store").Writable<import("@absolutejs/ai").RAGSource[]>;
         search: (input: {
-            filter?: Record<string, unknown> | undefined;
             query: string;
-            candidateTopK?: number | undefined;
-            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
-            model?: string | undefined;
-            topK?: number | undefined;
-            scoreThreshold?: number | undefined;
             nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
-            nativeQueryMultiplier?: number | undefined;
             nativeCandidateLimit?: number | undefined;
             nativeMaxBackfills?: number | undefined;
             nativeMinResults?: number | undefined;
             nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            filter?: Record<string, unknown> | undefined;
             queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
-            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            candidateTopK?: number | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            nativeQueryMultiplier?: number | undefined;
             persistTrace?: boolean | undefined;
             traceGroupKey?: string | undefined;
             traceTags?: string[] | undefined;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
         }) => Promise<import("@absolutejs/ai").RAGSource[]>;
         searchWithTrace: (input: {
-            filter?: Record<string, unknown> | undefined;
             query: string;
-            candidateTopK?: number | undefined;
-            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
-            model?: string | undefined;
-            topK?: number | undefined;
-            scoreThreshold?: number | undefined;
             nativeQueryProfile?: import("@absolutejs/ai").RAGNativeQueryProfile | undefined;
-            nativeQueryMultiplier?: number | undefined;
             nativeCandidateLimit?: number | undefined;
             nativeMaxBackfills?: number | undefined;
             nativeMinResults?: number | undefined;
             nativeFillPolicy?: "strict_topk" | "satisfy_min_results" | undefined;
+            filter?: Record<string, unknown> | undefined;
             queryTransform?: import("@absolutejs/ai").RAGQueryTransformProviderLike | undefined;
-            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+            candidateTopK?: number | undefined;
+            topK?: number | undefined;
+            scoreThreshold?: number | undefined;
+            retrieval?: (import("@absolutejs/ai").RAGHybridSearchOptions | import("@absolutejs/ai").RAGHybridRetrievalMode) | undefined;
+            model?: string | undefined;
+            nativeQueryMultiplier?: number | undefined;
             persistTrace?: boolean | undefined;
             traceGroupKey?: string | undefined;
             traceTags?: string[] | undefined;
-        }) => Promise<import("../../ai/client").RAGDetailedSearchResponse>;
+            retrievalStrategy?: import("@absolutejs/ai").RAGRetrievalStrategyProviderLike | undefined;
+        }) => Promise<import("../client").RAGDetailedSearchResponse>;
         trace: import("svelte/store").Writable<import("@absolutejs/ai").RAGRetrievalTrace | undefined>;
     };
     sources: {
@@ -245,7 +245,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         isStreaming: import("svelte/store").Readable<boolean>;
         latestAssistantMessage: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage | undefined>;
         messages: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage[]>;
-        progress: import("svelte/store").Readable<import("../../ai/rag/presentation").RAGStreamProgress>;
+        progress: import("svelte/store").Readable<import("../presentation/presentation").RAGStreamProgress>;
         query: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
         retrieval: import("svelte/store").Readable<import("@absolutejs/ai").RAGRetrievedState | null>;
         sourceGroups: import("svelte/store").Readable<import("@absolutejs/ai").RAGSourceGroup[]>;
@@ -274,7 +274,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
         isStreaming: import("svelte/store").Readable<boolean>;
         latestAssistantMessage: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage | undefined>;
         messages: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage[]>;
-        progress: import("svelte/store").Readable<import("../../ai/rag/presentation").RAGStreamProgress>;
+        progress: import("svelte/store").Readable<import("../presentation/presentation").RAGStreamProgress>;
         query: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
         retrieval: import("svelte/store").Readable<import("@absolutejs/ai").RAGRetrievedState | null>;
         sourceGroups: import("svelte/store").Readable<import("@absolutejs/ai").RAGSourceGroup[]>;

package/dist/src/svelte/{ai/createRAGGrounding.d.ts → createRAGGrounding.d.ts}

@@ -1,7 +1,7 @@
 import { type Readable } from "svelte/store";
 import type { RAGSource } from "@absolutejs/ai";
 export declare const createRAGGrounding: (content: Readable<string>, sources: Readable<RAGSource[]>) => {
-    coverage: Readable<"grounded" | "partial" | "ungrounded">;
+    coverage: Readable<"partial" | "grounded" | "ungrounded">;
     groundedAnswer: Readable<import("@absolutejs/ai").RAGGroundedAnswer>;
     hasCitations: Readable<boolean>;
     hasGrounding: Readable<boolean>;

package/dist/src/svelte/{ai/createRAGSearch.d.ts → createRAGSearch.d.ts}

@@ -1,5 +1,5 @@
 import type { RAGSearchRequest, RAGSource } from "@absolutejs/ai";
-import { type RAGDetailedSearchResponse } from "../../ai/client/ragClient";
+import type { RAGDetailedSearchResponse } from "../../types/client";
 type SearchRequest = Omit<RAGSearchRequest, "includeTrace">;
 export declare const createRAGSearch: (path: string) => {
     error: import("svelte/store").Writable<string | null>;

package/dist/src/svelte/{ai/createRAGStream.d.ts → createRAGStream.d.ts}

@@ -13,7 +13,7 @@ export declare const createRAGStream: (path: string, conversationId?: string) =>
     isStreaming: import("svelte/store").Readable<boolean>;
     latestAssistantMessage: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage | undefined>;
     messages: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage[]>;
-    progress: import("svelte/store").Readable<import("../../ai/rag/presentation").RAGStreamProgress>;
+    progress: import("svelte/store").Readable<import("../presentation/presentation").RAGStreamProgress>;
     query: (content: string, attachments?: AIAttachment[]) => void;
     retrieval: import("svelte/store").Readable<import("@absolutejs/ai").RAGRetrievedState | null>;
     sourceGroups: import("svelte/store").Readable<import("@absolutejs/ai").RAGSourceGroup[]>;

package/dist/src/svelte/{ai/createRAGStreamProgress.d.ts → createRAGStreamProgress.d.ts}

@@ -4,5 +4,5 @@ export declare const createRAGStreamProgress: (params: {
     error: Readable<string | null>;
     isStreaming: Readable<boolean>;
     messages: Readable<AIMessage[]>;
-}) => Readable<import("../../ai/rag/presentation").RAGStreamProgress>;
+}) => Readable<import("../presentation/presentation").RAGStreamProgress>;
 export type CreateRAGStreamProgressResult = ReturnType<typeof createRAGStreamProgress>;

package/dist/src/svelte/{ai/createRAGWorkflow.d.ts → createRAGWorkflow.d.ts}

@@ -13,7 +13,7 @@ export declare const createRAGWorkflow: (path: string, conversationId?: string)
     isStreaming: import("svelte/store").Readable<boolean>;
     latestAssistantMessage: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage | undefined>;
     messages: import("svelte/store").Readable<import("@absolutejs/ai").AIMessage[]>;
-    progress: import("svelte/store").Readable<import("../../ai/rag/presentation").RAGStreamProgress>;
+    progress: import("svelte/store").Readable<import("../presentation/presentation").RAGStreamProgress>;
     query: (content: string, attachments?: import("@absolutejs/ai").AIAttachment[]) => void;
     retrieval: import("svelte/store").Readable<import("@absolutejs/ai").RAGRetrievedState | null>;
     sourceGroups: import("svelte/store").Readable<import("@absolutejs/ai").RAGSourceGroup[]>;

package/dist/src/{ai/rag → 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";
+import type { RAGLinkedConnectorSyncSourceOptions } from "../../types/sync";
 export declare const previewRAGSyncExtractionRecovery: (input: {
     diagnostics?: RAGSyncSourceDiagnostics;
 }) => RAGSyncExtractionRecoveryPreview;

package/dist/src/{ai/rag/types.d.ts → types.d.ts}

@@ -1,33 +1,7 @@
-import type { RAGDocumentChunk, RAGQueryInput, RAGQueryResult, RAGUpsertInput, 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;
-};
+import type { RAGQueryResult } from "@absolutejs/ai";
+export type { RAGLinkedConnectorSyncSourceOptions } from "../types/sync";
 export type { AIHTMXRenderConfig, RAGAnswerWorkflowState, RAGBackendCapabilities, RAGCitation, RAGCitationReferenceMap, RAGGroundedAnswer, RAGGroundedAnswerPart, RAGGroundingReference, RAGChunkingOptions, RAGChunkingStrategy, RAGCollection, RAGCollectionSearchParams, RAGContentFormat, RAGHTMXConfig, RAGHybridFusionMode, RAGHybridRetrievalMode, RAGHybridSearchOptions, RAGDocumentChunk, RAGDocumentChunkEmbeddingVariant, RAGDocumentChunkPreview, RAGArchiveEntry, RAGArchiveExpander, RAGArchiveExpansionResult, RAGExtractedFileDocument, RAGFileExtractionInput, RAGFileExtractor, RAGPDFOCRExtractorOptions, RAGDirectoryIngestInput, RAGDirectorySyncSourceOptions, RAGDocumentFileInput, RAGDocumentIngestInput, RAGDocumentUploadIngestInput, RAGDocumentUploadInput, RAGEmbeddingFunction, RAGEmbeddingInput, RAGEmbeddingProvider, RAGEmbeddingProviderLike, RAGBackendDescriptor, RAGHTMXWorkflowRenderConfig, RAGIngestDocument, RAGIndexedDocument, RAGMediaTranscriber, RAGMediaTranscriptSegment, RAGMediaTranscriptionResult, RAGLexicalQueryInput, RAGDocumentUrlInput, RAGDocumentUrlIngestInput, RAGEmailSyncAttachment, RAGEmailSyncClient, RAGEmailSyncListInput, RAGEmailSyncListResult, RAGEmailSyncMessage, RAGEmailSyncSourceOptions, RAGConnectorCheckpoint, RAGConnectorItem, RAGConnectorRuntime, RAGConnectorSyncInput, RAGConnectorSyncResult, RAGFeedSyncInput, RAGFeedSyncSourceOptions, RAGGitHubRepoSyncInput, RAGGitHubSyncSourceOptions, RAGSitemapSyncInput, RAGSitemapSyncSourceOptions, RAGSiteDiscoveryInput, RAGSiteDiscoverySyncSourceOptions, RAGStorageSyncClient, RAGStorageSyncFile, RAGStorageSyncListInput, RAGStorageSyncListResult, RAGStorageSyncObject, RAGStorageSyncSourceOptions, RAGOCRProvider, RAGOCRResult, RAGPreparedDocument, RAGSource, RAGSourceGroup, RAGSourceSummary, RAGIngestResponse, RAGMutationResponse, RAGPostgresNativeDiagnostics, RAGQueryInput, RAGQueryResult, RAGQueryTransformInput, RAGQueryTransformProvider, RAGQueryTransformProviderLike, RAGQueryTransformResult, RAGQueryTransformer, RAGSearchRequest, RAGSyncManager, RAGSyncRunOptions, RAGSyncSchedule, RAGSyncScheduler, RAGSyncResponse, RAGSyncStateStore, RAGSyncSourceContext, RAGSyncSourceDefinition, RAGSyncSourceRecord, RAGSyncSourceRunResult, RAGUrlSyncSourceOptions, RAGSQLiteNativeDiagnostics, RAGStatusResponse, RAGStreamStage, RAGAnswerGroundingEvaluationCase, RAGAnswerGroundingEvaluationCaseDifficultyEntry, RAGAnswerGroundingCaseDifficultyDiffEntry, RAGAnswerGroundingCaseDifficultyHistory, RAGAnswerGroundingCaseDifficultyHistoryStore, RAGAnswerGroundingCaseDifficultyRun, RAGAnswerGroundingCaseDifficultyRunDiff, RAGAnswerGroundingEvaluationCaseDiff, RAGAnswerGroundingEvaluationCaseResult, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationLeaderboardEntry, RAGAnswerGroundingEvaluationHistoryStore, RAGAnswerGroundingEvaluationInput, RAGAnswerGroundingEvaluationResponse, RAGAnswerGroundingEvaluationRun, RAGAnswerGroundingEvaluationRunDiff, RAGAnswerGroundingEvaluationSummary, RAGEvaluationCase, RAGEvaluationCaseDiff, RAGEvaluationHistory, RAGEvaluationHistoryStore, RAGEvaluationCaseResult, RAGEvaluationLeaderboardEntry, RAGEvaluationInput, RAGEvaluationResponse, RAGEvaluationRunDiff, RAGEvaluationSummary, RAGEvaluationSuite, RAGEvaluationSuiteRun, RAGRetrievalCandidate, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalComparisonSummary, RAGUpsertInput, RAGVectorStore, RAGVectorStoreStatus, SQLiteVecResolution, } from "@absolutejs/ai";
-export type InternalRAGStoredChunk = RAGDocumentChunk & {
-    vector: number[];
-    sourceId: string;
-};
-export type { RAGUpsertInput as RAGDocumentBatch };
-export type { RAGQueryInput as RAGQueryParams };
-export type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig, } from "./embeddingProviders";
+export type { InternalRAGStoredChunk, RAGDocumentBatch, RAGQueryParams, } from "../types/core";
+export type { GeminiEmbeddingsConfig, OllamaEmbeddingsConfig, OpenAICompatibleEmbeddingsConfig, OpenAIEmbeddingsConfig, } from "../types/providers";
 export type { RAGReranker, RAGRerankerCandidate, RAGRerankerComparison, RAGRerankerComparisonEntry, RAGRerankerComparisonSummary, RAGRerankerInput, RAGRerankerProvider, RAGRerankerProviderLike, } from "@absolutejs/ai";
 export declare const buildRAGContext: (hits: RAGQueryResult[]) => string;