@nixxie-cms/ai-rag 1.0.0

package/dist/declarations/src/providers/index.d.ts

@@ -0,0 +1,14 @@
+import type { RagEmbeddingConfig, RagGenerationConfig } from "../types.js";
+import { AnthropicRagProvider } from "./AnthropicRagProvider.js";
+import { GeminiRagProvider } from "./GeminiRagProvider.js";
+import { OllamaRagProvider } from "./OllamaRagProvider.js";
+import { OpenAiRagProvider } from "./OpenAiRagProvider.js";
+import { ServiceRagProvider } from "./ServiceRagProvider.js";
+import type { EmbeddingProvider, GenerationProvider } from "./types.js";
+/** Build the generation provider from config (default provider: anthropic). */
+export declare function resolveGenerationProvider(config?: RagGenerationConfig): GenerationProvider;
+/** Build the embedding provider from config (default provider: openai). */
+export declare function resolveEmbeddingProvider(config?: RagEmbeddingConfig): EmbeddingProvider;
+export { AnthropicRagProvider, OpenAiRagProvider, GeminiRagProvider, OllamaRagProvider, ServiceRagProvider, };
+export type { GenerationProvider, EmbeddingProvider, RagMessage, RagGenerateOptions, RagGenerateResult, RagStreamChunk, RagUsage, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../../src/providers","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAmB,oBAAgB;AACxF,OAAO,EAAE,oBAAoB,EAAE,kCAA8B;AAC7D,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AACvD,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AACvD,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AACvD,OAAO,EAAE,kBAAkB,EAAE,gCAA4B;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAe;AAEpE,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,kBAAkB,CAiB9F;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,kBAAuB,GAAG,iBAAiB,CAoB3F;AAED,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,CAAA;AACD,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,QAAQ,GACT,mBAAe"}

package/dist/declarations/src/providers/types.d.ts

@@ -0,0 +1,45 @@
+/** A single chat turn handed to a provider. */
+export type RagMessage = {
+    role: 'user' | 'assistant';
+    content: string;
+};
+export type RagGenerateOptions = {
+    model?: string;
+    system?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    /** Provider-specific extras merged into the request body. */
+    extra?: Record<string, unknown>;
+};
+export type RagUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+};
+export type RagGenerateResult = {
+    text: string;
+    model: string;
+    usage?: RagUsage;
+};
+/** One streamed delta. The final chunk carries `done: true` and any usage. */
+export type RagStreamChunk = {
+    delta?: string;
+    done?: boolean;
+    usage?: RagUsage;
+    model?: string;
+};
+/** A provider that can answer (and ideally stream) a chat. */
+export interface GenerationProvider {
+    readonly name: string;
+    readonly defaultModel: string;
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    /** Optional native streaming. When absent, the service emulates it from `generate`. */
+    stream?(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+}
+/** A provider that can turn text into embedding vectors. */
+export interface EmbeddingProvider {
+    readonly name: string;
+    readonly defaultModel: string;
+    embed(texts: string[], model?: string): Promise<number[][]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/declarations/src/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"../../../../src/providers","sources":["types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,QAAQ,CAAA;CACjB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1F,uFAAuF;IACvF,MAAM,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;CAC7F;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;CAC5D"}

package/dist/declarations/src/similarity.d.ts

@@ -0,0 +1,12 @@
+/** Dot product of two equal-length vectors. */
+export declare function dot(a: number[], b: number[]): number;
+/** Euclidean norm of a vector. */
+export declare function norm(a: number[]): number;
+/**
+ * Cosine similarity mapped from [-1, 1] into [0, 1] so it can be used as a relevance
+ * score and compared against a `minScore` threshold. Returns 0 for a zero vector.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/** Pre-normalise a vector to unit length (lets retrieval use a plain dot product). */
+export declare function normalize(a: number[]): number[];
+//# sourceMappingURL=similarity.d.ts.map

package/dist/declarations/src/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"../../../src","sources":["similarity.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAKpD;AAED,kCAAkC;AAClC,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAMjE;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI/C"}

package/dist/declarations/src/types.d.ts

@@ -0,0 +1,319 @@
+import type { NixxieAiService, NixxieRagChunk, NixxieRagCitation } from '@nixxie-cms/core';
+export type { NixxieAiRagService, NixxieRagDocument, NixxieRagDocumentInput, NixxieRagDocumentQuery, NixxieRagChunk, NixxieRagCitation, NixxieRagAnswer, NixxieRagAskOptions, NixxieRagRetrieveOptions, NixxieRagStreamEvent, NixxieRagIndexStats, } from '@nixxie-cms/core';
+/** Supported model providers for generation and/or embeddings. */
+export type RagProviderName = 'anthropic' | 'openai' | 'gemini' | 'ollama';
+/**
+ * How to talk to a model provider. Either point at an existing `NixxieAiService`
+ * (e.g. the one configured as `context.services.ai`) via `service`, or give the
+ * provider + credentials and let ai-rag build the client.
+ */
+export type RagProviderConfig = {
+    /** Provider to use. Defaults to 'anthropic' for generation, 'openai' for embeddings. */
+    provider?: RagProviderName;
+    /** API key. Not required for `ollama` (local server) or when `service` is given. */
+    apiKey?: string;
+    /** Model id. Sensible per-provider defaults are used when omitted. */
+    model?: string;
+    /**
+     * Override the API base URL. Required for `ollama` if it is not on
+     * http://localhost:11434. Also used for gateways/proxies/Azure.
+     */
+    baseUrl?: string;
+    /**
+     * Reuse an already-constructed service instead of building a client. Handy for
+     * sharing `context.services.ai`. When set, other fields are ignored for that role.
+     */
+    service?: NixxieAiService;
+    /** Extra provider-specific options merged into each request body. */
+    extra?: Record<string, unknown>;
+};
+/** Generation (answering) model configuration. */
+export type RagGenerationConfig = RagProviderConfig & {
+    /**
+     * Sampling temperature. Lower is more grounded/deterministic.
+     * @default 0.2
+     */
+    temperature?: number;
+    /**
+     * Maximum output tokens per answer.
+     * @default 1024
+     */
+    maxTokens?: number;
+    /** Nucleus sampling cutoff, passed through when the provider supports it. */
+    topP?: number;
+    /**
+     * Base system prompt. The retrieved context and grounding rules are appended to it.
+     * @default a strict, citation-first assistant prompt
+     */
+    systemPrompt?: string;
+    /**
+     * Fully override how the final prompt is assembled from the question + retrieved
+     * chunks. Return the messages sent to the model. When omitted, a built-in template
+     * is used that injects numbered sources and citation instructions.
+     */
+    buildPrompt?: (args: PromptBuildArgs) => PromptBuildResult;
+};
+/** Embedding model configuration (often a different — even local — provider). */
+export type RagEmbeddingConfig = RagProviderConfig & {
+    /**
+     * Expected embedding dimensionality. Used to validate stored vectors and to detect
+     * a model change that requires a full reindex. Optional — inferred on first embed.
+     */
+    dimensions?: number;
+    /**
+     * How many chunks to embed per provider call.
+     * @default 64
+     */
+    batchSize?: number;
+};
+/** Where embeddings live and how retrieval searches them. */
+export type RagRetrievalConfig = {
+    /**
+     * Number of chunks fed to the model as context.
+     * @default 5
+     */
+    topK?: number;
+    /**
+     * Minimum cosine similarity (0–1) for a chunk to be considered relevant. Chunks below
+     * this are dropped; if nothing clears the bar the guard can refuse.
+     * @default 0.2
+     */
+    minScore?: number;
+    /**
+     * Cap the total characters of retrieved context injected into the prompt.
+     * @default 6000
+     */
+    maxContextChars?: number;
+    /**
+     * Pluggable vector store. Defaults to a SQL-backed store over the chunk collection
+     * (works on any database) doing cosine similarity in Node. Swap for pgvector or an
+     * external vector DB by implementing `VectorStore`.
+     */
+    vectorStore?: VectorStore;
+    /**
+     * Optional second-pass reranker over the candidate chunks (e.g. a cross-encoder).
+     * Receives the query and the top candidates; returns them re-scored/re-ordered.
+     */
+    rerank?: (query: string, chunks: NixxieRagChunk[]) => Promise<NixxieRagChunk[]>;
+    /**
+     * Over-fetch this multiple of `topK` before reranking/scoring.
+     * @default 4
+     */
+    candidateMultiplier?: number;
+};
+export type RagChunkingStrategy = 'recursive' | 'sentence' | 'fixed';
+/** How documents are split into chunks before embedding. */
+export type RagChunkingConfig = {
+    /**
+     * Splitting strategy. 'recursive' splits on paragraph→line→sentence→word boundaries
+     * to keep chunks coherent; 'sentence' groups whole sentences; 'fixed' is a hard window.
+     * @default 'recursive'
+     */
+    strategy?: RagChunkingStrategy;
+    /**
+     * Target chunk size in characters.
+     * @default 1200
+     */
+    chunkSize?: number;
+    /**
+     * Overlap in characters between consecutive chunks (preserves context across cuts).
+     * @default 200
+     */
+    chunkOverlap?: number;
+};
+/** Indexing behaviour and scheduling. */
+export type RagIndexingConfig = {
+    /**
+     * Re-embed a document automatically when its KB row is created/updated and remove its
+     * chunks when the row is deleted (wired by `ragPlugin()` via collection hooks).
+     * @default true
+     */
+    auto?: boolean;
+    /**
+     * Run a full reindex on a schedule. Cron expression or interval in milliseconds.
+     * Requires the jobs service (`context.services.jobs`); the plugin registers the job.
+     * @example '0 3 * * *'  // 3am daily
+     */
+    schedule?: string | number;
+    /**
+     * Index any pending/changed documents once, right after the database connects.
+     * @default true
+     */
+    onConnect?: boolean;
+    /**
+     * How many documents to index concurrently.
+     * @default 4
+     */
+    concurrency?: number;
+};
+/** Hallucination guarding — keep answers grounded in the knowledge base. */
+export type RagGuardConfig = {
+    /**
+     * Master switch for all guarding below.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Refuse to answer (returning `refusal`) when the best retrieved chunk scores below
+     * `minScore`, i.e. the KB has nothing relevant.
+     * @default true
+     */
+    refuseWhenNoContext?: boolean;
+    /**
+     * Message returned when the assistant refuses for lack of grounding.
+     * @default "I don't have enough information in my knowledge base to answer that."
+     */
+    refusal?: string;
+    /**
+     * Instruct the model to cite sources inline as [n] and only use provided context.
+     * @default true
+     */
+    requireCitations?: boolean;
+    /**
+     * Run a second, cheap model pass that checks the drafted answer is supported by the
+     * retrieved context and strips/flags unsupported claims. Costs an extra call.
+     * @default false
+     */
+    groundingCheck?: boolean;
+    /** Model id for the grounding check. Defaults to the generation model. */
+    groundingModel?: string;
+    /**
+     * If the grounding check finds the answer is not supported, replace it with `refusal`
+     * instead of returning the ungrounded text.
+     * @default true
+     */
+    refuseWhenUngrounded?: boolean;
+    /**
+     * Allow the model to fall back to its own world knowledge when no context is found
+     * (sets a softer prompt). Off by default for a strictly grounded assistant.
+     * @default false
+     */
+    allowModelKnowledge?: boolean;
+};
+/** Conversation handling. */
+export type RagChatConfig = {
+    /**
+     * Maximum prior turns kept when building the prompt (excludes the system prompt).
+     * @default 10
+     */
+    historyLimit?: number;
+    /**
+     * Default to streaming responses where supported (the HTTP route always can stream).
+     * @default true
+     */
+    streaming?: boolean;
+};
+/** Hard limits and safety rails. */
+export type RagLimitsConfig = {
+    /**
+     * Reject queries longer than this many characters before doing any work.
+     * @default 8000
+     */
+    maxQueryChars?: number;
+    /**
+     * Maximum concurrent in-flight generations. Excess calls wait.
+     * @default 8
+     */
+    maxConcurrentChats?: number;
+};
+/** Names of the collections ai-rag reads/writes. The plugin can create them for you. */
+export type RagCollectionsConfig = {
+    /**
+     * Collection holding source documents (the KB rows users add).
+     * @default 'KnowledgeBase'
+     */
+    documents?: string;
+    /**
+     * Collection holding indexed chunks + embeddings.
+     * @default 'KnowledgeChunk'
+     */
+    chunks?: string;
+};
+/** The full, flexible configuration for `createAiRag()`. */
+export type AiRagConfig = {
+    /** Collection names backing the knowledge base. */
+    collections?: RagCollectionsConfig;
+    /** Generation (answering) model. Defaults to Anthropic Claude. */
+    generation?: RagGenerationConfig;
+    /** Embedding model. Defaults to OpenAI text-embedding-3-small. */
+    embedding?: RagEmbeddingConfig;
+    /** Retrieval + vector store settings. */
+    retrieval?: RagRetrievalConfig;
+    /** Document chunking settings. */
+    chunking?: RagChunkingConfig;
+    /** Indexing behaviour and scheduling. */
+    indexing?: RagIndexingConfig;
+    /** Hallucination guarding. */
+    guard?: RagGuardConfig;
+    /** Conversation handling. */
+    chat?: RagChatConfig;
+    /** Hard limits and safety rails. */
+    limits?: RagLimitsConfig;
+};
+export type PromptBuildArgs = {
+    /** The user's latest question. */
+    question: string;
+    /** Prior conversation turns (already trimmed to `chat.historyLimit`). */
+    history: {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+    /** The retrieved, scored chunks chosen as context. */
+    context: NixxieRagChunk[];
+    /** The resolved base system prompt. */
+    systemPrompt: string;
+    /** Whether citations are required by the guard. */
+    requireCitations: boolean;
+};
+export type PromptBuildResult = {
+    system: string;
+    messages: {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+};
+/** A stored chunk + its embedding, as persisted by a `VectorStore`. */
+export type VectorRecord = {
+    id: string;
+    documentId: string;
+    content: string;
+    embedding: number[];
+    title?: string;
+    source?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+};
+export type VectorQuery = {
+    /** The query embedding. */
+    embedding: number[];
+    /** Max results. */
+    topK: number;
+    /** Only match chunks whose document carries ALL of these tags. */
+    tags?: string[];
+    /** Minimum score to return. */
+    minScore?: number;
+};
+/**
+ * Pluggable similarity store. The default `SqlVectorStore` keeps vectors in the chunk
+ * collection and scores them in Node; implement this interface to back retrieval with
+ * pgvector, Qdrant, Pinecone, etc.
+ */
+export type VectorStore = {
+    /** Called once after the database connects, with a sudo context. */
+    init?(context: import('@nixxie-cms/core').NixxieContext): Promise<void> | void;
+    /** Insert or replace all chunks for a document (replacing any previous chunks). */
+    upsert(documentId: string, records: VectorRecord[]): Promise<void>;
+    /** Delete every chunk belonging to a document. */
+    deleteByDocument(documentId: string): Promise<void>;
+    /** Return the closest chunks to the query embedding, scored in [0,1]. */
+    query(query: VectorQuery): Promise<Array<VectorRecord & {
+        score: number;
+    }>>;
+    /** Total number of indexed chunks (optional; used for stats). */
+    count?(): Promise<number>;
+    /** Remove everything (used by a forced full reindex). */
+    clear?(): Promise<void>;
+};
+/** Internal: the fully-resolved configuration with all defaults applied. */
+export type ResolvedRagCitation = NixxieRagCitation;
+//# sourceMappingURL=types.d.ts.map

package/dist/declarations/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"../../../src","sources":["types.ts"],"names":[],"mappings":"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"}

package/dist/declarations/src/vector-store.d.ts

@@ -0,0 +1,34 @@
+import type { NixxieContext } from '@nixxie-cms/core';
+import type { VectorQuery, VectorRecord, VectorStore } from "./types.js";
+/**
+ * Default vector store: persists embeddings in the chunk collection in the host app's own
+ * database (any provider) and scores candidates with cosine similarity in Node. Simple and
+ * portable; for very large knowledge bases swap in a pgvector / external store via
+ * `retrieval.vectorStore`.
+ */
+export declare class SqlVectorStore implements VectorStore {
+    private collection;
+    private model;
+    constructor(collection: string);
+    init(context: NixxieContext): void;
+    private requireModel;
+    upsert(documentId: string, records: VectorRecord[]): Promise<void>;
+    deleteByDocument(documentId: string): Promise<void>;
+    query(query: VectorQuery): Promise<Array<VectorRecord & {
+        score: number;
+    }>>;
+    count(): Promise<number>;
+    clear(): Promise<void>;
+}
+/** Ephemeral in-process vector store. Useful for tests and small/transient knowledge bases. */
+export declare class InMemoryVectorStore implements VectorStore {
+    private byDocument;
+    upsert(documentId: string, records: VectorRecord[]): Promise<void>;
+    deleteByDocument(documentId: string): Promise<void>;
+    query(query: VectorQuery): Promise<Array<VectorRecord & {
+        score: number;
+    }>>;
+    count(): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/declarations/src/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"../../../src","sources":["vector-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAe;AA6BrE;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,WAAW;IAGpC,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,KAAK,CAAmB;gBAEZ,UAAU,EAAE,MAAM;IAEtC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIlC,OAAO,CAAC,YAAY;IASd,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAM3E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAeD,+FAA+F;AAC/F,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,UAAU,CAAoC;IAEhD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAM3E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAMxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/nixxie-cms-ai-rag.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibml4eGllLWNtcy1haS1yYWcuY2pzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuL2RlY2xhcmF0aW9ucy9zcmMvaW5kZXguZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSJ9