@askdb/rag 0.2.0-beta.30 → 0.2.0-beta.32

package/README.md

@@ -1,6 +1,6 @@
 # @askdb/rag
 
-Deterministic retrieval over AskDB Schema v2 artifacts. `@askdb/rag` chunks the describable schema, indexes chunks with your embedder and vector store, and returns a retriever you can pass to `@askdb/core` `ask({ retriever })`.
+Deterministic retrieval over AskDB schema artifacts. `@askdb/rag` chunks the describable schema, indexes chunks with your embedder and vector store, and returns a retriever you can pass to `@askdb/core` `ask({ retriever })`.
 
 > Status: pre-1.0. Phase 8 ships BYO embeddings and BYO stores with in-memory, file-backed, and pgvector adapters.
 
@@ -10,7 +10,7 @@ Deterministic retrieval over AskDB Schema v2 artifacts. `@askdb/rag` chunks the
 pnpm add @askdb/rag @askdb/core ai
 # only if you use the pgvector adapter:
 pnpm add pg
-# only if you use the OpenAI embedder helper:
+# only if you build OpenAI embedding models with the AI SDK yourself:
 pnpm add @ai-sdk/openai
 ```
 
@@ -68,7 +68,7 @@ All exports are available from the root `@askdb/rag` import. Sub-path imports ar
 
 ### Core
 
-- `chunkSchema`, `chunkSchemaDir`, `chunkSchemaBundle` — deterministic Schema v2 chunking.
+- `chunkSchema`, `chunkSchemaDir`, `chunkSchemaBundle` — deterministic schema artifact chunking.
 - `buildSchemaIndex` — chunk, embed, upsert, write `schema.lock.json`, and return a retriever.
 - `createRetriever` — bind an existing store and embedder without indexing.
 
@@ -87,7 +87,6 @@ All exports are available from the root `@askdb/rag` import. Sub-path imports ar
 | `createAiSdkEmbedder` | `@askdb/rag/embedders/ai-sdk` | Generic AI SDK `EmbeddingModel` adapter. Requires `ai`. |
 | `detectEmbeddingDimensions` | — | Learns an embedder's vector width by embedding one short text. Use it for a new pgvector table instead of hard-coding a width. |
 | `aiSdkEmbedderId` | `@askdb/rag/embedders/ai-sdk` | The `embedderId` Studio and `askdb rag` record for an `ai.embedding` model (`ai-sdk:<provider>:<model>:<dimensions or default>`), so an index built by one is accepted by the other. |
-| `createOpenAiEmbedder` | `@askdb/rag/embedders/openai` | **Deprecated.** OpenAI convenience helper. Use `createAiSdkEmbedder` with an AI SDK embedding model (e.g. from `@ai-sdk/openai`) or one built by the `@askdb/ai` registry instead. Removed in 1.0. |
 
 ### Import examples
 
@@ -105,8 +104,7 @@ import { createMemoryStore } from "@askdb/rag/stores/memory";
 import { createFileStore } from "@askdb/rag/stores/file";
 import { createPgvectorStore } from "@askdb/rag/stores/pgvector";
 import { createAiSdkEmbedder } from "@askdb/rag/embedders/ai-sdk";
-// Recommended: bring your own embedding model (e.g. @ai-sdk/openai, or @askdb/ai's registry) + createAiSdkEmbedder
-// import { createOpenAiEmbedder } from "@askdb/rag/embedders/openai"; // deprecated, removed in 1.0
+// Bring your own embedding model (e.g. from @ai-sdk/openai, or @askdb/ai's createEmbeddingModelFromSection) + createAiSdkEmbedder
 ```
 
 ## Sensitive Fields

package/dist/index.d.ts

@@ -7,6 +7,5 @@ export { createMemoryStore, type MemoryStore } from "./stores/memory.js";
 export { createFileStore, type FileStore, type FileStoreOptions } from "./stores/file.js";
 export { createPgvectorStore, PgvectorDimensionMismatchError, type PgvectorStore, type PgClient, type PgvectorIndexStrategy, type CreatePgvectorStoreOptions, } from "./stores/pgvector.js";
 export { aiSdkEmbedderId, createAiSdkEmbedder, type AiSdkEmbedderIdOptions, type AiSdkProviderOptions, type CreateAiSdkEmbedderOptions, type AiSdkEmbedderUsage, } from "./embedders/ai-sdk.js";
-export { createOpenAiEmbedder, type CreateOpenAiEmbedderOptions } from "./embedders/openai.js";
 export { detectEmbeddingDimensions } from "./embedders/dimensions.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -17,6 +17,5 @@ export { createFileStore } from "./stores/file.js";
 export { createPgvectorStore, PgvectorDimensionMismatchError, } from "./stores/pgvector.js";
 // Embedders
 export { aiSdkEmbedderId, createAiSdkEmbedder, } from "./embedders/ai-sdk.js";
-export { createOpenAiEmbedder } from "./embedders/openai.js";
 export { detectEmbeddingDimensions } from "./embedders/dimensions.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAe5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,GAKxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,GAMpB,MAAM,oBAAoB,CAAC;AAE5B,2EAA2E;AAC3E,4EAA4E;AAC5E,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAA6B,MAAM,iBAAiB,CAAC;AAE9E,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAyC,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAK/B,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,eAAe,EACf,mBAAmB,GAKpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAoC,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAe5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,GAKxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,mBAAmB,GAMpB,MAAM,oBAAoB,CAAC;AAE5B,2EAA2E;AAC3E,4EAA4E;AAC5E,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAA6B,MAAM,iBAAiB,CAAC;AAE9E,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAyC,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAK/B,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,eAAe,EACf,mBAAmB,GAKpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@askdb/rag",
-  "version": "0.2.0-beta.30",
-  "description": "AskDB RAG layer: deterministic chunker over Schema v2, BYO embedder + vector store (in-memory, file-backed, pgvector), and an optional retriever wired into @askdb/core ask().",
+  "version": "0.2.0-beta.32",
+  "description": "AskDB RAG layer: deterministic chunker over the schema artifact, BYO embedder + vector store (in-memory, file-backed, pgvector), and an optional retriever wired into @askdb/core ask().",
   "keywords": [
     "askdb",
     "rag",
@@ -47,11 +47,6 @@
       "import": "./dist/stores/pgvector.js",
       "default": "./dist/stores/pgvector.js"
     },
-    "./embedders/openai": {
-      "types": "./dist/embedders/openai.d.ts",
-      "import": "./dist/embedders/openai.js",
-      "default": "./dist/embedders/openai.js"
-    },
     "./embedders/ai-sdk": {
       "types": "./dist/embedders/ai-sdk.d.ts",
       "import": "./dist/embedders/ai-sdk.js",
@@ -68,7 +63,7 @@
     "node": ">=22.23.4"
   },
   "dependencies": {
-    "@askdb/core": "1.0.0-beta.50"
+    "@askdb/core": "1.0.0-beta.52"
   },
   "peerDependencies": {
     "@ai-sdk/openai": "^3.0.0 || ^4.0.29",

package/dist/embedders/openai.d.ts

@@ -1,25 +0,0 @@
-import type { Embedder } from "../types.js";
-export type CreateOpenAiEmbedderOptions = {
-    /** Defaults to `text-embedding-3-small`. */
-    model?: string;
-    /** Optional override; otherwise the OpenAI provider reads `OPENAI_API_KEY`. */
-    apiKey?: string;
-    /** Optional OpenAI-compatible base URL, e.g. an AI gateway ending in `/v1`. */
-    baseURL?: string;
-    /** Optional dimensionality override for text-embedding-3 models. */
-    dimensions?: number;
-    /** Optional end-user id forwarded to OpenAI embedding settings. */
-    user?: string;
-};
-/**
- * Reference AI SDK embedder for OpenAI embeddings.
- *
- * `ai` and `@ai-sdk/openai` are optional peers of `@askdb/rag`; this helper
- * lazy-loads them so chunking and non-OpenAI stores remain zero-provider.
- *
- * @deprecated Construct the model yourself and use `createAiSdkEmbedder`, or use the
- * `@askdb/ai` registry (`createAiRegistry(["openai"]).createEmbeddingModelFromEnv(env)`)
- * so env-var conventions stay consistent. This helper will be removed in 1.0.
- */
-export declare function createOpenAiEmbedder(options?: CreateOpenAiEmbedderOptions): Embedder;
-//# sourceMappingURL=openai.d.ts.map

package/dist/embedders/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/embedders/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,MAAM,2BAA2B,GAAG;IACxC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,QAAQ,CAaV"}

package/dist/embedders/openai.js

@@ -1,34 +0,0 @@
-import { createAiSdkEmbedder } from "./ai-sdk.js";
-/**
- * Reference AI SDK embedder for OpenAI embeddings.
- *
- * `ai` and `@ai-sdk/openai` are optional peers of `@askdb/rag`; this helper
- * lazy-loads them so chunking and non-OpenAI stores remain zero-provider.
- *
- * @deprecated Construct the model yourself and use `createAiSdkEmbedder`, or use the
- * `@askdb/ai` registry (`createAiRegistry(["openai"]).createEmbeddingModelFromEnv(env)`)
- * so env-var conventions stay consistent. This helper will be removed in 1.0.
- */
-export function createOpenAiEmbedder(options = {}) {
-    return async (texts) => {
-        const { createOpenAI } = await import("@ai-sdk/openai");
-        const provider = createOpenAI({
-            ...(options.apiKey ? { apiKey: options.apiKey } : {}),
-            ...(options.baseURL ? { baseURL: options.baseURL } : {}),
-        });
-        const embedder = createAiSdkEmbedder({
-            model: provider.embedding(options.model ?? "text-embedding-3-small"),
-            providerOptions: openAiProviderOptions(options),
-        });
-        return embedder(texts);
-    };
-}
-function openAiProviderOptions(options) {
-    const openai = {};
-    if (options.dimensions !== undefined)
-        openai.dimensions = options.dimensions;
-    if (options.user !== undefined)
-        openai.user = options.user;
-    return Object.keys(openai).length > 0 ? { openai } : undefined;
-}
-//# sourceMappingURL=openai.js.map

package/dist/embedders/openai.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/embedders/openai.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAe7E;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EAAE;IAEzC,OAAO,KAAK,EAAE,KAAe,EAAE,EAAE;QAC/B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,YAAY,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC;YACnC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;YACpE,eAAe,EAAE,qBAAqB,CAAC,OAAO,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAoC;IACjE,MAAM,MAAM,GAAiC,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAC7E,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC"}