@nixxie-cms/ai-rag 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Nixxie International DMCC
+Portions Copyright (c) 2023 Thinkmill Labs Pty Ltd and contributors
+(this software is derived from the KeystoneJS project, https://keystonejs.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+# @nixxie-cms/ai-rag
+
+A custom, **RAG-trained AI assistant** for Nixxie CMS. It automatically creates a
+knowledge-base collection that users fill with content, indexes that content into
+embeddings, and answers questions **grounded in your data** — with inline citations and
+hallucination guarding.
+
+- 🧠 **RAG by default** — retrieval-augmented generation over a knowledge base you control.
+- 🔌 **Pluggable models** — generation via **Anthropic, OpenAI (GPT), Google Gemini, or Ollama**
+  (local open models: Llama, Mistral, Phi, …); embeddings via OpenAI, Gemini, or Ollama. Mix and
+  match (e.g. local Ollama embeddings + Anthropic answers).
+- 🗃️ **Auto-created lists** — `KnowledgeBase` (source rows) and `KnowledgeChunk`
+  (embeddings) are added to your schema by the plugin.
+- 🧮 **Portable vector store** — a SQL-backed default works on any database; swap in
+  pgvector/Qdrant/Pinecone via the `VectorStore` interface.
+- 🛡️ **Hallucination guarding** — refuses when the KB has nothing relevant, requires
+  citations, and (optionally) runs a second-pass grounding check.
+- ⏱️ **Scheduled + incremental indexing** — re-embed on content change and on a cron.
+- 🌐 **Surfaces** — programmatic service API, HTTP chat route with **SSE streaming**,
+  GraphQL queries/mutations, and an Admin UI console.
+
+## Install
+
+```bash
+pnpm add @nixxie-cms/ai-rag
+# plus the SDK(s) for the providers you use:
+pnpm add @anthropic-ai/sdk openai
+```
+
+## Quick start
+
+```ts
+// nixxie-cms.ts
+import { config } from '@nixxie-cms/core'
+import { createJobs } from '@nixxie-cms/jobs'
+import { createAiRag, ragPlugin } from '@nixxie-cms/ai-rag'
+
+const aiRag = createAiRag({
+  // Answering model — pick any provider.
+  generation: {
+    provider: 'anthropic',
+    apiKey: process.env.ANTHROPIC_API_KEY!,
+    model: 'claude-opus-4-8',
+    temperature: 0.2,
+    maxTokens: 1024,
+  },
+  // Embedding model — can be a different (even local) provider.
+  embedding: {
+    provider: 'openai',
+    apiKey: process.env.OPENAI_API_KEY!,
+    model: 'text-embedding-3-small',
+  },
+  retrieval: { topK: 6, minScore: 0.25 },
+  chunking: { strategy: 'recursive', chunkSize: 1200, chunkOverlap: 200 },
+  guard: { enabled: true, requireCitations: true, groundingCheck: true },
+  indexing: { auto: true, onConnect: true, schedule: '0 3 * * *' },
+})
+
+export default config({
+  db: { provider: 'postgresql', url: process.env.DATABASE_URL! },
+  jobs: createJobs(),          // enables the scheduled reindex
+  collections: { /* your collections */ },
+  plugins: [ragPlugin({ service: aiRag })],
+})
+```
+
+`ragPlugin()` registers the service (`context.services.aiRag`), adds the `KnowledgeBase` +
+`KnowledgeChunk` collections with auto-indexing hooks, mounts the HTTP + GraphQL surfaces,
+and schedules re-indexing. Run a migration after adding it.
+
+## Using the service
+
+Anywhere you have `context`:
+
+```ts
+const ai = context.services.aiRag!
+
+// Add / manage knowledge-base content
+await ai.addDocument({ title: 'Refunds', content: '…', tags: ['billing'] })
+await ai.updateDocument(id, { content: '…' })
+await ai.removeDocument(id)
+const docs = await ai.listDocuments({ tags: ['billing'] })
+
+// Index (usually automatic)
+await ai.reindex({ force: true })
+
+// Retrieve + ask
+const chunks = await ai.retrieve('how do refunds work?')
+const answer = await ai.ask('How do refunds work?', { tags: ['billing'] })
+// → { text, sources: [{ title, source, score, snippet }], grounded, refused, model }
+
+// Streaming
+for await (const event of ai.stream([{ role: 'user', content: 'Explain refunds' }])) {
+  if (event.type === 'token') process.stdout.write(event.token)
+  if (event.type === 'done') console.log(event.answer.sources)
+}
+```
+
+## HTTP API
+
+Mounted by the plugin at `/api/ai-rag` (configurable):
+
+| Method & path                 | Body / query                                | Returns |
+| ----------------------------- | ------------------------------------------- | ------- |
+| `POST /api/ai-rag/chat`       | `{ messages?, question?, topK?, tags?, stream? }` | JSON answer, or **SSE** (`sources`→`token`→`done`) when `stream: true` |
+| `GET  /api/ai-rag/documents`  | `?take&skip&search`                         | `{ documents }` |
+| `POST /api/ai-rag/documents`  | `{ content, title?, source?, tags? }`       | the created document |
+| `DELETE /api/ai-rag/documents/:id` | —                                      | `{ ok: true }` |
+| `POST /api/ai-rag/reindex`    | `{ force? }`                                | index stats |
+
+## GraphQL
+
+Added to your schema: `ragAsk(question, topK, tags)`, `ragRetrieve(query, …)`,
+`ragAddDocument(...)`, `ragRemoveDocument(id)`, `ragReindex(force)`.
+
+## Admin UI page
+
+Add a chat + knowledge-base console to the dashboard:
+
+```ts
+import { ragAdminPage } from '@nixxie-cms/ai-rag'
+
+export default config({
+  ui: { getAdditionalFiles: [async () => [ragAdminPage()]] }, // served at /ai-rag
+})
+```
+
+## Configuration reference
+
+Everything in `AiRagConfig` is optional and deeply overridable:
+
+- **`generation`** — `provider`, `apiKey`, `model`, `baseUrl`, `temperature`, `maxTokens`,
+  `topP`, `systemPrompt`, and `buildPrompt` (full control of prompt assembly). Pass
+  `service` to reuse an existing `NixxieAiService` (e.g. `context.services.ai`).
+- **`embedding`** — same provider shape, plus `dimensions` and `batchSize`.
+- **`retrieval`** — `topK`, `minScore`, `maxContextChars`, `candidateMultiplier`,
+  `vectorStore`, `rerank`.
+- **`chunking`** — `strategy` (`recursive` | `sentence` | `fixed`), `chunkSize`, `chunkOverlap`.
+- **`indexing`** — `auto`, `onConnect`, `schedule` (cron/ms), `concurrency`.
+- **`guard`** — `enabled`, `refuseWhenNoContext`, `refusal`, `requireCitations`,
+  `groundingCheck`, `groundingModel`, `refuseWhenUngrounded`, `allowModelKnowledge`.
+- **`chat`** — `historyLimit`, `streaming`.
+- **`limits`** — `maxQueryChars`, `maxConcurrentChats`.
+- **`collections`** — `documents`, `chunks` (collection names).
+
+## Custom vector store
+
+```ts
+import { createAiRag, type VectorStore } from '@nixxie-cms/ai-rag'
+
+const pgvector: VectorStore = {
+  async init(context) { /* … */ },
+  async upsert(documentId, records) { /* … */ },
+  async deleteByDocument(documentId) { /* … */ },
+  async query({ embedding, topK, tags, minScore }) { /* … return scored records */ },
+}
+
+const aiRag = createAiRag({ retrieval: { vectorStore: pgvector }, /* … */ })
+```
+
+## License
+
+MIT

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

@@ -0,0 +1,50 @@
+import type { NixxieAiMessage, NixxieAiRagService, NixxieContext, NixxieRagAnswer, NixxieRagAskOptions, NixxieRagChunk, NixxieRagDocument, NixxieRagDocumentInput, NixxieRagDocumentQuery, NixxieRagIndexStats, NixxieRagRetrieveOptions, NixxieRagStreamEvent } from '@nixxie-cms/core';
+import type { AiRagConfig } from "./types.js";
+/** The main RAG assistant. Create via `createAiRag()`; register via `ragPlugin()`. */
+export declare class AiRagService implements NixxieAiRagService {
+    private documents;
+    private generation;
+    private embedder;
+    private vectorStore;
+    private rerank?;
+    private chatGate;
+    private r;
+    constructor(config?: AiRagConfig);
+    /** Names of the collections this service reads/writes (used by the plugin). */
+    get collections(): {
+        documents: string;
+        chunks: string;
+    };
+    get indexingSchedule(): string | number | undefined;
+    init(context: NixxieContext): Promise<void>;
+    private requireDelegate;
+    private requireDocuments;
+    addDocument(doc: NixxieRagDocumentInput): Promise<NixxieRagDocument>;
+    addDocuments(docs: NixxieRagDocumentInput[]): Promise<NixxieRagDocument[]>;
+    getDocument(id: string): Promise<NixxieRagDocument | undefined>;
+    listDocuments(query?: NixxieRagDocumentQuery): Promise<NixxieRagDocument[]>;
+    updateDocument(id: string, patch: Partial<NixxieRagDocumentInput>): Promise<NixxieRagDocument>;
+    removeDocument(id: string): Promise<void>;
+    /**
+     * Delete a document's indexed chunks without touching the document row. Used by the
+     * auto-index delete hook, where the KB row has already been removed by the CMS.
+     */
+    purgeChunks(documentId: string): Promise<void>;
+    index(documentId: string): Promise<void>;
+    reindex(options?: {
+        force?: boolean;
+        tags?: string[];
+    }): Promise<NixxieRagIndexStats>;
+    indexPending(): Promise<NixxieRagIndexStats>;
+    private embedBatched;
+    retrieve(query: string, options?: NixxieRagRetrieveOptions): Promise<NixxieRagChunk[]>;
+    ask(question: string, options?: NixxieRagAskOptions): Promise<NixxieRagAnswer>;
+    chat(messages: NixxieAiMessage[], options?: NixxieRagAskOptions): Promise<NixxieRagAnswer>;
+    stream(messages: NixxieAiMessage[], options?: NixxieRagAskOptions): AsyncIterable<NixxieRagStreamEvent>;
+    /** Shared retrieve → guard → prompt pipeline for chat/stream. */
+    private prepare;
+    /** Apply the grounding check and assemble the final answer with citations. */
+    private finalize;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=AiRagService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AiRagService.d.ts","sourceRoot":"../../../src","sources":["AiRagService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,cAAc,EAEd,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,kBAAkB,CAAA;AAYzB,OAAO,KAAK,EACV,WAAW,EAIZ,mBAAe;AAqChB,sFAAsF;AACtF,qBAAa,YAAa,YAAW,kBAAkB;IACrD,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAC,CAAwE;IACvF,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,CAAC,CAAU;gBAEP,MAAM,GAAE,WAAgB;IA+CpC,+EAA+E;IAC/E,IAAI,WAAW,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAEvD;IAED,IAAI,gBAAgB,IAAI,MAAM,GAAG,MAAM,GAAG,SAAS,CAElD;IAIK,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,gBAAgB;IAWlB,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKpE,YAAY,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAgC1E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAK/D,aAAa,CAAC,KAAK,GAAE,sBAA2B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAwB/E,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACrC,OAAO,CAAC,iBAAiB,CAAC;IAqBvB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDxC,OAAO,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBzF,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC;YAmBpC,YAAY;IAapB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2B1F,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlF,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB7F,MAAM,CACX,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,GAAE,mBAAwB,GAChC,aAAa,CAAC,oBAAoB,CAAC;IAoDtC,iEAAiE;YACnD,OAAO;IAgFrB,8EAA8E;YAChE,QAAQ;IA+BhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/declarations/src/admin-page.d.ts

@@ -0,0 +1,29 @@
+import type { AdminFileToWrite } from '@nixxie-cms/core/types';
+export type RagAdminPageOptions = {
+    /**
+     * Route the page is served at inside the Admin UI (also its filename under `pages/`).
+     * @default 'ai-rag'
+     */
+    route?: string;
+    /**
+     * Base path of the HTTP routes the page talks to (must match `ragPlugin({ routes })`).
+     * @default '/api/ai-rag'
+     */
+    apiPath?: string;
+    /** Heading shown at the top of the page. @default 'AI Assistant' */
+    title?: string;
+};
+/**
+ * Returns an `AdminFileToWrite` that adds a chat + knowledge-base console page to the
+ * Admin UI. Spread it into `ui.getAdditionalFiles`:
+ *
+ * @example
+ * import { ragAdminPage } from '@nixxie-cms/ai-rag'
+ * export default config({
+ *   ui: { getAdditionalFiles: [async () => [ragAdminPage()]] },
+ * })
+ *
+ * The page appears at `/<route>` (default `/ai-rag`) in the Admin UI.
+ */
+export declare function ragAdminPage(options?: RagAdminPageOptions): AdminFileToWrite;
+//# sourceMappingURL=admin-page.d.ts.map

package/dist/declarations/src/admin-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-page.d.ts","sourceRoot":"../../../src","sources":["admin-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAkGD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,CAShF"}

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

@@ -0,0 +1,8 @@
+import type { RagChunkingConfig } from "./types.js";
+/**
+ * Split text into overlapping chunks. The recursive strategy prefers to cut on the
+ * coarsest natural boundary that keeps a chunk under `chunkSize`, falling back to finer
+ * boundaries (and finally a hard slice) so no chunk overruns the budget.
+ */
+export declare function chunkText(text: string, config?: RagChunkingConfig): string[];
+//# sourceMappingURL=chunking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.d.ts","sourceRoot":"../../../src","sources":["chunking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAe;AAWhD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,iBAAsB,GAAG,MAAM,EAAE,CAiBhF"}

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

@@ -0,0 +1,18 @@
+/**
+ * The knowledge-base source list the assistant is trained on. Users add rows here; each
+ * row's `content` is chunked, embedded and made retrievable. `ragPlugin()` adds this
+ * collection automatically, but you can register it yourself for full control over access.
+ *
+ * @example
+ * config({
+ *   collections: { KnowledgeBase: knowledgeBaseCollection(), ...collections },
+ * })
+ */
+export declare function knowledgeBaseCollection(): any;
+/**
+ * The chunk/embedding list backing retrieval. Managed entirely by ai-rag — rows are written
+ * during indexing and deleted with their document. Hidden from create/delete in the Admin UI.
+ * `ragPlugin()` adds it automatically.
+ */
+export declare function knowledgeChunkCollection(): any;
+//# sourceMappingURL=collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"../../../src","sources":["collection.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAoC7C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAuB9C"}

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

@@ -0,0 +1,36 @@
+import type { NixxieAiRagService, NixxieContext } from '@nixxie-cms/core';
+export type AiRagRoutesOptions = {
+    /** The service. Defaults to `context.services.aiRag`. */
+    service?: NixxieAiRagService;
+    /**
+     * Base path the routes mount under.
+     * @default '/api/ai-rag'
+     */
+    path?: string;
+    /**
+     * Authorize a request before it reaches the assistant. Receives a request-bound context;
+     * returning false answers 401. Applied to every route.
+     * @default requires a session
+     */
+    isAuthorized?: (context: NixxieContext) => boolean | Promise<boolean>;
+    /**
+     * Require authorization for read/chat routes too (not just mutations).
+     * @default true
+     */
+    protectReads?: boolean;
+};
+/**
+ * Mount the assistant's HTTP API on an Express app:
+ *
+ * - `POST <path>/chat` — body `{ messages?, question?, topK?, tags?, stream? }`. When
+ *   `stream` is true (or `Accept: text/event-stream`), responds with SSE: `sources`,
+ *   then `token` events, then a final `done` event carrying the full answer.
+ * - `GET <path>/documents` — list knowledge-base documents.
+ * - `POST <path>/documents` — add a document `{ content, title?, source?, tags? }`.
+ * - `DELETE <path>/documents/:id` — remove a document.
+ * - `POST <path>/reindex` — `{ force? }` → index stats.
+ *
+ * Call from `server.extendExpressApp`, or use `ragPlugin()` to wire it automatically.
+ */
+export declare function installAiRagRoutes(app: any, context: NixxieContext, options?: AiRagRoutesOptions): void;
+//# sourceMappingURL=express.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"../../../src","sources":["express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAwB,MAAM,kBAAkB,CAAA;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yDAAyD;IACzD,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrE;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAkCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CA2IN"}

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

@@ -0,0 +1,23 @@
+import type { NixxieAiRagService, NixxieContext } from '@nixxie-cms/core';
+/** How the GraphQL resolvers obtain the service (defaults to `context.services.aiRag`). */
+export type RagGraphqlOptions = {
+    /** Override the service lookup. By default reads `context.services.aiRag`. */
+    getService?: (context: NixxieContext) => NixxieAiRagService | null | undefined;
+    /**
+     * Gate the mutating operations (ingest/remove/reindex). Returning false rejects the call.
+     * Reads (`ragAsk`, `ragRetrieve`) are always allowed — guard them with collection access if needed.
+     * @default requires a session
+     */
+    isAuthorized?: (context: NixxieContext) => boolean | Promise<boolean>;
+};
+/**
+ * Build the `extendGraphqlSchema` function that adds the assistant's queries and mutations:
+ *
+ * - `ragAsk(question, topK?, tags?)` → grounded answer with citations
+ * - `ragRetrieve(query, topK?, tags?)` → raw retrieved chunks
+ * - `ragAddDocument(...)` / `ragRemoveDocument(id)` / `ragReindex(force?)`
+ *
+ * `ragPlugin()` wires this automatically; use it directly only if you compose the schema yourself.
+ */
+export declare function ragGraphqlExtension(options?: RagGraphqlOptions): (schema: import("graphql").GraphQLSchema) => import("graphql").GraphQLSchema;
+//# sourceMappingURL=graphql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"../../../src","sources":["graphql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAMd,MAAM,kBAAkB,CAAA;AAEzB,2FAA2F;AAC3F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9E;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtE,CAAA;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,gFA+IlE"}

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

@@ -0,0 +1,39 @@
+import { AiRagService } from "./AiRagService.js";
+import type { AiRagConfig } from "./types.js";
+/**
+ * Create a custom, RAG-trained assistant backed by a knowledge-base collection.
+ *
+ * Register it with `ragPlugin()` so the knowledge-base collections, HTTP + GraphQL surfaces
+ * and scheduled indexing are wired automatically:
+ *
+ * @example
+ * import { createAiRag, ragPlugin } from '@nixxie-cms/ai-rag'
+ * const aiRag = createAiRag({
+ *   generation: { provider: 'anthropic', apiKey: process.env.ANTHROPIC_API_KEY! },
+ *   embedding: { provider: 'openai', apiKey: process.env.OPENAI_API_KEY! },
+ *   retrieval: { topK: 6, minScore: 0.25 },
+ *   guard: { groundingCheck: true },
+ *   indexing: { schedule: '0 3 * * *' },
+ * })
+ * export default config({ db: { ... }, plugins: [ragPlugin({ service: aiRag })] })
+ *
+ * Then anywhere you have context:
+ *   await context.services.aiRag!.addDocument({ title, content })
+ *   const answer = await context.services.aiRag!.ask('How do refunds work?')
+ */
+export declare function createAiRag(config?: AiRagConfig): AiRagService;
+export { AiRagService } from "./AiRagService.js";
+export { ragPlugin, type RagPluginOptions } from "./plugin.js";
+export { installAiRagRoutes, type AiRagRoutesOptions } from "./express.js";
+export { ragGraphqlExtension, type RagGraphqlOptions } from "./graphql.js";
+export { ragAdminPage, type RagAdminPageOptions } from "./admin-page.js";
+export { knowledgeBaseCollection, knowledgeChunkCollection } from "./collection.js";
+export { resolveGenerationProvider, resolveEmbeddingProvider, AnthropicRagProvider, OpenAiRagProvider, GeminiRagProvider, OllamaRagProvider, ServiceRagProvider, } from "./providers/index.js";
+export type { GenerationProvider, EmbeddingProvider, RagMessage, RagGenerateOptions, RagGenerateResult, RagStreamChunk, } from "./providers/index.js";
+export { SqlVectorStore, InMemoryVectorStore } from "./vector-store.js";
+export { chunkText } from "./chunking.js";
+export { cosineSimilarity, normalize } from "./similarity.js";
+export { buildRagPrompt, renderContext, DEFAULT_SYSTEM_PROMPT } from "./prompt.js";
+export type { AiRagConfig, RagProviderName, RagProviderConfig, RagGenerationConfig, RagEmbeddingConfig, RagRetrievalConfig, RagChunkingConfig, RagChunkingStrategy, RagIndexingConfig, RagGuardConfig, RagChatConfig, RagLimitsConfig, RagCollectionsConfig, VectorStore, VectorRecord, VectorQuery, PromptBuildArgs, PromptBuildResult, } from "./types.js";
+export type { NixxieAiRagService, NixxieRagDocument, NixxieRagDocumentInput, NixxieRagDocumentQuery, NixxieRagChunk, NixxieRagCitation, NixxieRagAnswer, NixxieRagAskOptions, NixxieRagRetrieveOptions, NixxieRagStreamEvent, NixxieRagIndexStats, } from '@nixxie-cms/core';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,0BAAsB;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAe;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,WAAgB,GAAG,YAAY,CAElE;AAED,OAAO,EAAE,YAAY,EAAE,0BAAsB;AAG7C,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,oBAAgB;AAC3D,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,qBAAiB;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,qBAAiB;AACvE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,wBAAoB;AAGrE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,wBAAoB;AAGhF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,6BAAmB;AACpB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,6BAAmB;AAGpB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,0BAAsB;AAGpE,OAAO,EAAE,SAAS,EAAE,sBAAkB;AACtC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,wBAAoB;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAgB;AAG/E,YAAY,EACV,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,iBAAiB,GAClB,mBAAe;AAGhB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA"}

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

@@ -0,0 +1,53 @@
+import type { NixxiePlugin } from '@nixxie-cms/core/types';
+import type { AiRagService } from "./AiRagService.js";
+import { type AiRagRoutesOptions } from "./express.js";
+import { type RagGraphqlOptions } from "./graphql.js";
+export type RagPluginOptions = {
+    /** The service created with `createAiRag()`. */
+    service: AiRagService;
+    /**
+     * Add the knowledge-base + chunk collections to the schema.
+     * Disable if you register them yourself (e.g. to customise access control).
+     * @default true
+     */
+    collections?: boolean;
+    /**
+     * Re-index a knowledge-base row whenever it's created/updated through the CMS, and drop
+     * its chunks when it's deleted. Overrides the service's `indexing.auto` for CMS writes.
+     * @default the service's `indexing.auto`
+     */
+    autoIndex?: boolean;
+    /**
+     * Mount the HTTP routes (chat + streaming + document CRUD). Pass `false` to skip, or an
+     * options object to configure the path / auth.
+     * @default true (mounted at /api/ai-rag)
+     */
+    routes?: boolean | Omit<AiRagRoutesOptions, 'service'>;
+    /**
+     * Add the GraphQL queries/mutations (ragAsk, ragRetrieve, ragAddDocument, …).
+     * Pass `false` to skip, or options to configure auth.
+     * @default true
+     */
+    graphql?: boolean | RagGraphqlOptions;
+    /** Name of the scheduled reindex job registered with the jobs service. @default 'ai-rag-reindex' */
+    jobName?: string;
+};
+/**
+ * One-call wiring for the RAG assistant. Registers the service, adds the knowledge-base
+ * collections (with auto-indexing hooks), mounts the HTTP + GraphQL surfaces and schedules
+ * re-indexing.
+ *
+ * @example
+ * import { createAiRag, ragPlugin } from '@nixxie-cms/ai-rag'
+ * const aiRag = createAiRag({
+ *   generation: { provider: 'anthropic', apiKey: process.env.ANTHROPIC_API_KEY! },
+ *   embedding: { provider: 'openai', apiKey: process.env.OPENAI_API_KEY! },
+ *   indexing: { schedule: '0 3 * * *' },
+ * })
+ * export default config({
+ *   db: { ... },
+ *   plugins: [ragPlugin({ service: aiRag })],
+ * })
+ */
+export declare function ragPlugin(options: RagPluginOptions): NixxiePlugin;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"../../../src","sources":["plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,0BAAsB;AAElD,OAAO,EAAsB,KAAK,kBAAkB,EAAE,qBAAiB;AACvE,OAAO,EAAuB,KAAK,iBAAiB,EAAE,qBAAiB;AAEvE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,OAAO,EAAE,YAAY,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAA;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;IACrC,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAkDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CA2DjE"}

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

@@ -0,0 +1,14 @@
+import type { NixxieRagChunk } from '@nixxie-cms/core';
+import type { PromptBuildArgs, PromptBuildResult } from "./types.js";
+export declare const DEFAULT_SYSTEM_PROMPT: string;
+export declare const ALLOW_KNOWLEDGE_SYSTEM_PROMPT: string;
+/** Render retrieved chunks as a numbered, citable source block. */
+export declare function renderContext(chunks: NixxieRagChunk[], maxChars: number): string;
+/**
+ * Default prompt assembly: a system prompt carrying the numbered context + citation rules,
+ * the trimmed history, and the user's question. Overridable via `generation.buildPrompt`.
+ */
+export declare function buildRagPrompt(args: PromptBuildArgs, options: {
+    maxContextChars: number;
+}): PromptBuildResult;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"../../../src","sources":["prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,mBAAe;AAEjE,eAAO,MAAM,qBAAqB,QAGE,CAAA;AAEpC,eAAO,MAAM,6BAA6B,QAGN,CAAA;AAEpC,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAahF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GACnC,iBAAiB,CAyBnB"}

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

@@ -0,0 +1,16 @@
+import type { RagProviderConfig } from "../types.js";
+import type { GenerationProvider, RagGenerateOptions, RagGenerateResult, RagMessage, RagStreamChunk } from "./types.js";
+/** Anthropic (Claude) generation provider with native streaming. */
+export declare class AnthropicRagProvider implements GenerationProvider {
+    readonly name = "anthropic";
+    readonly defaultModel = "claude-opus-4-8";
+    private client;
+    private model;
+    private maxTokens;
+    private extra;
+    constructor(config: RagProviderConfig);
+    private buildBody;
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    stream(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+}
+//# sourceMappingURL=AnthropicRagProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicRagProvider.d.ts","sourceRoot":"../../../../src/providers","sources":["AnthropicRagProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAgB;AACjD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,mBAAe;AAchB,oEAAoE;AACpE,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,QAAQ,CAAC,IAAI,eAAc;IAC3B,QAAQ,CAAC,YAAY,qBAAgB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IASrC,OAAO,CAAC,SAAS;IAaX,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAazF,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,cAAc,CAAC;CAsBjC"}

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

@@ -0,0 +1,19 @@
+import type { RagProviderConfig } from "../types.js";
+import type { EmbeddingProvider, GenerationProvider, RagGenerateOptions, RagGenerateResult, RagMessage, RagStreamChunk } from "./types.js";
+/** Google Gemini provider over the public REST API — generation, streaming and embeddings. */
+export declare class GeminiRagProvider implements GenerationProvider, EmbeddingProvider {
+    readonly name = "gemini";
+    readonly defaultModel = "gemini-2.0-flash";
+    private apiKey;
+    private model;
+    private embeddingModel;
+    private base;
+    private extra;
+    constructor(config: RagProviderConfig);
+    private buildBody;
+    private extractText;
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    stream(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+    embed(texts: string[], model?: string): Promise<number[][]>;
+}
+//# sourceMappingURL=GeminiRagProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiRagProvider.d.ts","sourceRoot":"../../../../src/providers","sources":["GeminiRagProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAgB;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,mBAAe;AAMhB,8FAA8F;AAC9F,qBAAa,iBAAkB,YAAW,kBAAkB,EAAE,iBAAiB;IAC7E,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,YAAY,sBAAgB;IACrC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IASrC,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,WAAW;IAKb,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsBzF,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,cAAc,CAAC;IA0B1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAgBlE"}

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

@@ -0,0 +1,23 @@
+import type { RagProviderConfig } from "../types.js";
+import type { EmbeddingProvider, GenerationProvider, RagGenerateOptions, RagGenerateResult, RagMessage, RagStreamChunk } from "./types.js";
+/**
+ * Ollama provider for local (or remote) open models — generation, streaming and embeddings.
+ * Runs any Ollama model family (Llama, Mistral, Phi, Gemma, Qwen, …). No API key needed for a
+ * local server; point `baseUrl` at your Ollama host if it isn't on localhost.
+ */
+export declare class OllamaRagProvider implements GenerationProvider, EmbeddingProvider {
+    readonly name = "ollama";
+    readonly defaultModel = "llama3.1";
+    private base;
+    private model;
+    private embeddingModel;
+    private apiKey?;
+    private extra;
+    constructor(config: RagProviderConfig);
+    private headers;
+    private buildBody;
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    stream(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+    embed(texts: string[], model?: string): Promise<number[][]>;
+}
+//# sourceMappingURL=OllamaRagProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaRagProvider.d.ts","sourceRoot":"../../../../src/providers","sources":["OllamaRagProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAgB;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,mBAAe;AAMhB;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB,EAAE,iBAAiB;IAC7E,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,YAAY,cAAgB;IACrC,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IAQrC,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,SAAS;IAkBX,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAezF,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,cAAc,CAAC;IAuB1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CA0BlE"}

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

@@ -0,0 +1,17 @@
+import type { RagProviderConfig } from "../types.js";
+import type { EmbeddingProvider, GenerationProvider, RagGenerateOptions, RagGenerateResult, RagMessage, RagStreamChunk } from "./types.js";
+/** OpenAI (GPT) provider — generation, streaming and embeddings. */
+export declare class OpenAiRagProvider implements GenerationProvider, EmbeddingProvider {
+    readonly name = "openai";
+    readonly defaultModel = "gpt-4o";
+    private client;
+    private model;
+    private embeddingModel;
+    private extra;
+    constructor(config: RagProviderConfig);
+    private buildMessages;
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    stream(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+    embed(texts: string[], model?: string): Promise<number[][]>;
+}
+//# sourceMappingURL=OpenAiRagProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAiRagProvider.d.ts","sourceRoot":"../../../../src/providers","sources":["OpenAiRagProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAgB;AACjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,mBAAe;AAehB,oEAAoE;AACpE,qBAAa,iBAAkB,YAAW,kBAAkB,EAAE,iBAAiB;IAC7E,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,YAAY,YAAgB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,KAAK,CAAyB;gBAE1B,MAAM,EAAE,iBAAiB;IASrC,OAAO,CAAC,aAAa;IAOf,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoBzF,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,cAAc,CAAC;IAyB1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAWlE"}

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

@@ -0,0 +1,17 @@
+import type { NixxieAiService } from '@nixxie-cms/core';
+import type { EmbeddingProvider, GenerationProvider, RagGenerateOptions, RagGenerateResult, RagMessage, RagStreamChunk } from "./types.js";
+/**
+ * Adapts an existing `NixxieAiService` (e.g. `context.services.ai` from @nixxie-cms/ai)
+ * into a RAG provider. Streaming is emulated by emitting the full answer as one delta,
+ * since `NixxieAiService` has no streaming surface.
+ */
+export declare class ServiceRagProvider implements GenerationProvider, EmbeddingProvider {
+    private service;
+    readonly name = "service";
+    readonly defaultModel = "service";
+    constructor(service: NixxieAiService);
+    generate(messages: RagMessage[], options?: RagGenerateOptions): Promise<RagGenerateResult>;
+    stream(messages: RagMessage[], options?: RagGenerateOptions): AsyncIterable<RagStreamChunk>;
+    embed(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=ServiceRagProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceRagProvider.d.ts","sourceRoot":"../../../../src/providers","sources":["ServiceRagProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,mBAAe;AAEhB;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB,EAAE,iBAAiB;IAIlE,OAAO,CAAC,OAAO;IAH3B,QAAQ,CAAC,IAAI,aAAY;IACzB,QAAQ,CAAC,YAAY,aAAY;gBAEb,OAAO,EAAE,eAAe;IAEtC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUzF,MAAM,CACX,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,cAAc,CAAC;IAM1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAGlD"}