veryfront 0.1.932 → 0.1.934

package/esm/deno.d.ts

@@ -53,6 +53,7 @@ declare namespace _default {
         "./integrations": string;
         "./sandbox": string;
         "./embedding": string;
+        "./knowledge": string;
         "./extensions": string;
         "./extensions/llm": string;
         "./extensions/auth": string;
@@ -94,6 +95,7 @@ declare namespace _default {
         "veryfront/components/chat": string;
         "veryfront/sandbox": string;
         "veryfront/embedding": string;
+        "veryfront/knowledge": string;
         "veryfront/runs": string;
         "veryfront/eval": string;
         "veryfront/metrics": string;
@@ -179,6 +181,7 @@ declare namespace _default {
         "#veryfront/discovery": string;
         "#veryfront/data": string;
         "#veryfront/errors": string;
+        "#veryfront/knowledge": string;
         "#veryfront/eval": string;
         "#veryfront/eval/agent-service": string;
         "#veryfront/metrics": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.932",
+    "version": "0.1.934",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {
@@ -109,6 +109,7 @@ export default {
         "./integrations": "./src/integrations/index.ts",
         "./sandbox": "./src/sandbox/index.ts",
         "./embedding": "./src/embedding/index.ts",
+        "./knowledge": "./src/knowledge/index.ts",
         "./extensions": "./src/extensions/index.ts",
         "./extensions/llm": "./src/extensions/llm/index.ts",
         "./extensions/auth": "./src/extensions/auth/index.ts",
@@ -150,6 +151,7 @@ export default {
         "veryfront/components/chat": "./src/react/components/chat/index.ts",
         "veryfront/sandbox": "./src/sandbox/index.ts",
         "veryfront/embedding": "./src/embedding/index.ts",
+        "veryfront/knowledge": "./src/knowledge/index.ts",
         "veryfront/runs": "./src/runs/index.ts",
         "veryfront/eval": "./src/eval/index.ts",
         "veryfront/metrics": "./src/metrics/index.ts",
@@ -235,6 +237,7 @@ export default {
         "#veryfront/discovery": "./src/discovery/index.ts",
         "#veryfront/data": "./src/data/index.ts",
         "#veryfront/errors": "./src/errors/index.ts",
+        "#veryfront/knowledge": "./src/knowledge/index.ts",
         "#veryfront/eval": "./src/eval/index.ts",
         "#veryfront/eval/agent-service": "./src/eval/agent-service.ts",
         "#veryfront/metrics": "./src/metrics/index.ts",

package/esm/src/discovery/import-rewriter.d.ts

@@ -5,7 +5,7 @@
  * (Deno, Node.js) and handles veryfront package resolution.
  */
 import { createFileSystem } from "../platform/compat/fs.js";
-export declare const DISCOVERY_GLOBAL_VERYFRONT_MODULES: readonly ["veryfront/agent", "veryfront/tool", "veryfront/platform", "veryfront/prompt", "veryfront/resource", "veryfront/embedding", "veryfront/workflow", "veryfront/work", "veryfront/eval", "veryfront/metrics", "veryfront/schemas"];
+export declare const DISCOVERY_GLOBAL_VERYFRONT_MODULES: readonly ["veryfront/agent", "veryfront/tool", "veryfront/platform", "veryfront/prompt", "veryfront/resource", "veryfront/embedding", "veryfront/knowledge", "veryfront/workflow", "veryfront/work", "veryfront/eval", "veryfront/metrics", "veryfront/schemas"];
 interface DenoRewriteOptions {
     compiled?: boolean;
     resolveSpecifier?: (specifier: string) => string;

package/esm/src/discovery/import-rewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/import-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,eAAO,MAAM,kCAAkC,2OAYrC,CAAC;AAEX,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAkHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA2BR;AAqFD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA2PjB"}
+{"version":3,"file":"import-rewriter.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/import-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,eAAO,MAAM,kCAAkC,kQAarC,CAAC;AAEX,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAkHD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA2BR;AAqFD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CA2PjB"}

package/esm/src/discovery/import-rewriter.js

@@ -14,6 +14,7 @@ export const DISCOVERY_GLOBAL_VERYFRONT_MODULES = [
     "veryfront/prompt",
     "veryfront/resource",
     "veryfront/embedding",
+    "veryfront/knowledge",
     "veryfront/workflow",
     "veryfront/work",
     "veryfront/eval",

package/esm/src/discovery/transpiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transpiler.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/transpiler.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAyIvD;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkGlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}
+{"version":3,"file":"transpiler.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/transpiler.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA2IvD;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAkGlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/esm/src/discovery/transpiler.js

@@ -19,6 +19,7 @@ import * as platformMod from "../platform/index.js";
 import * as promptMod from "../prompt/index.js";
 import * as resourceMod from "../resource/index.js";
 import * as embeddingMod from "../embedding/index.js";
+import * as knowledgeMod from "../knowledge/index.js";
 import * as workflowMod from "../workflow/index.js";
 import * as workMod from "../work/index.js";
 import * as evalMod from "../eval/index.js";
@@ -40,6 +41,7 @@ async function ensureVeryfrontGlobals() {
         "veryfront/prompt": promptMod,
         "veryfront/resource": resourceMod,
         "veryfront/embedding": embeddingMod,
+        "veryfront/knowledge": knowledgeMod,
         "veryfront/workflow": workflowMod,
         "veryfront/work": workMod,
         "veryfront/eval": evalMod,

package/esm/src/embedding/veryfront-cloud/rag-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rag-store.d.ts","sourceRoot":"","sources":["../../../../src/src/embedding/veryfront-cloud/rag-store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAIV,QAAQ,EACR,cAAc,EACf,MAAM,aAAa,CAAC;AAyErB,KAAK,2BAA2B,GAAG,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAsYtE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,2BAA2B,GAAG,QAAQ,CA2H1F"}
+{"version":3,"file":"rag-store.d.ts","sourceRoot":"","sources":["../../../../src/src/embedding/veryfront-cloud/rag-store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAIV,QAAQ,EACR,cAAc,EACf,MAAM,aAAa,CAAC;AA4ErB,KAAK,2BAA2B,GAAG,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA6gBtE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,2BAA2B,GAAG,QAAQ,CA6H1F"}

package/esm/src/embedding/veryfront-cloud/rag-store.js

@@ -102,6 +102,7 @@ async function requestJson(context, path, init, options) {
 }
 function getCloudStoreContext(config) {
     const bootstrap = requireVeryfrontCloudBootstrap();
+    const requestContext = getCurrentRequestContext();
     if (!bootstrap.projectSlug) {
         throw INVALID_ARGUMENT.create({
             detail: "VERYFRONT_PROJECT_SLUG not set. Set the environment variable or runtime projectSlug before using the veryfront-cloud RAG store.",
@@ -111,7 +112,10 @@ function getCloudStoreContext(config) {
         apiBaseUrl: bootstrap.apiBaseUrl,
         fetch: createVeryfrontCloudFetch(bootstrap.apiToken),
         projectSlug: bootstrap.projectSlug,
-        branch: config.branch ?? getCurrentRequestContext()?.branch ?? "main",
+        branch: config.branch ?? requestContext?.branch ?? "main",
+        environmentName: requestContext?.environmentName ?? null,
+        hasRequestContext: requestContext !== null,
+        releaseId: requestContext?.releaseId ?? null,
     };
 }
 function getFileChunksPath(context, filePath) {
@@ -258,7 +262,7 @@ async function listContentFiles(contentDir, contentExtensions) {
                 files.push(...(await listContentFiles(fullPath, contentExtensions)));
             }
             else if (entry.isFile && contentExtensions.has(extname(entry.name))) {
-                files.push(fullPath);
+                files.push({ path: fullPath });
             }
         }
     }
@@ -267,6 +271,67 @@ async function listContentFiles(contentDir, contentExtensions) {
     }
     return files;
 }
+function buildContentDirPattern(contentDir) {
+    return `${contentDir.replace(/\/+$/, "")}/**`;
+}
+function buildContentFilesQuery(context, contentDir, cursor) {
+    const params = new URLSearchParams({
+        include_server_functions: "true",
+        limit: "100",
+        pattern: buildContentDirPattern(contentDir),
+    });
+    if (!context.releaseId && !context.environmentName) {
+        params.set("branch", context.branch);
+    }
+    if (cursor) {
+        params.set("cursor", cursor);
+    }
+    return params.toString();
+}
+function getPublishedFileListPath(context, contentDir, cursor) {
+    const query = buildContentFilesQuery(context, contentDir, cursor);
+    const projectRef = encodeURIComponent(context.projectSlug);
+    if (context.releaseId) {
+        return `/projects/${projectRef}/releases/${encodeURIComponent(context.releaseId)}/files?${query}`;
+    }
+    if (context.environmentName) {
+        return `/projects/${projectRef}/environments/${encodeURIComponent(context.environmentName)}/files?${query}`;
+    }
+    return `/projects/${projectRef}/files?${query}`;
+}
+function getPublishedFileDetailPath(context, path) {
+    const query = new URLSearchParams({ include_server_functions: "true" });
+    const projectRef = encodeURIComponent(context.projectSlug);
+    const encodedPath = encodeURIComponent(path);
+    if (context.releaseId) {
+        return `/projects/${projectRef}/releases/${encodeURIComponent(context.releaseId)}/files/${encodedPath}?${query}`;
+    }
+    if (context.environmentName) {
+        return `/projects/${projectRef}/environments/${encodeURIComponent(context.environmentName)}/files/${encodedPath}?${query}`;
+    }
+    query.set("branch", context.branch);
+    return `/projects/${projectRef}/files/${encodedPath}?${query}`;
+}
+async function listPublishedContentFiles(context, contentDir, contentExtensions) {
+    const files = [];
+    let cursor;
+    do {
+        const response = await requestJson(context, getPublishedFileListPath(context, contentDir, cursor));
+        files.push(...(response?.data ?? [])
+            .filter((file) => contentExtensions.has(extname(file.path)))
+            .map((file) => ({ path: file.path, content: file.content })));
+        cursor = response?.page_info?.next ?? null;
+    } while (cursor);
+    return files;
+}
+async function readContentFile(context, file) {
+    if (file.content !== undefined)
+        return file.content;
+    if (!context.hasRequestContext)
+        return readTextFile(file.path);
+    const response = await requestJson(context, getPublishedFileDetailPath(context, file.path));
+    return response?.content ?? "";
+}
 export function createVeryfrontCloudRagStore(config) {
     const contentDir = config.contentDir;
     const contentExtensions = new Set(config.contentExtensions ?? [".md", ".mdx", ".txt"]);
@@ -341,22 +406,24 @@ export function createVeryfrontCloudRagStore(config) {
             const context = getCloudStoreContext(config);
             const existingDocuments = await listRagDocuments(context);
             const indexedSources = new Set(existingDocuments.map((doc) => doc.source));
-            const files = await listContentFiles(contentDir, contentExtensions);
-            const newFiles = files.filter((file) => !indexedSources.has(file));
+            const files = context.hasRequestContext
+                ? await listPublishedContentFiles(context, contentDir, contentExtensions)
+                : await listContentFiles(contentDir, contentExtensions);
+            const newFiles = files.filter((file) => !indexedSources.has(file.path));
             for (const file of newFiles) {
-                const content = await readTextFile(file);
+                const content = await readContentFile(context, file);
                 if (!content?.trim())
                     continue;
                 if (content.length > MAX_TEXT_LENGTH) {
-                    serverLogger.warn(`[rag-store/cloud] Skipping ${file}: exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB text limit`);
+                    serverLogger.warn(`[rag-store/cloud] Skipping ${file.path}: exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB text limit`);
                     continue;
                 }
-                const title = file.startsWith(contentDir + "/")
-                    ? file.slice(contentDir.length + 1).replace(/\.[^.]+$/, "")
-                    : file.replace(/\.[^.]+$/, "");
-                const type = extname(file).slice(1);
+                const title = file.path.startsWith(contentDir + "/")
+                    ? file.path.slice(contentDir.length + 1).replace(/\.[^.]+$/, "")
+                    : file.path.replace(/\.[^.]+$/, "");
+                const type = extname(file.path).slice(1);
                 await ingestDocument(context, config, title, content, {
-                    source: file,
+                    source: file.path,
                     type,
                 });
             }

package/esm/src/knowledge/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Project knowledge retrieval helpers.
+ *
+ * @module knowledge
+ *
+ * @example
+ * ```ts
+ * import { projectKnowledge } from "veryfront/knowledge";
+ *
+ * const knowledge = projectKnowledge();
+ * await knowledge.index();
+ * const result = await knowledge.retrieve("SSO login failure");
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+import type { RagSearchOptions, RagSearchResult, RagStoreBackend } from "../embedding/index.js";
+/** Configuration for project knowledge indexing and retrieval. */
+export interface ProjectKnowledgeConfig {
+    /**
+     * Project root used to resolve relative local paths.
+     *
+     * Hosted Veryfront Cloud request contexts ignore this for release-backed
+     * content lookup, but local development uses it to find `knowledge/` and
+     * `data/knowledge-index.json`.
+     */
+    projectDir?: string;
+    /**
+     * Directory containing source-controlled knowledge files.
+     *
+     * Defaults to `knowledge`.
+     */
+    contentDir?: string;
+    /**
+     * Local JSON index path.
+     *
+     * Defaults to `data/knowledge-index.json`.
+     */
+    storagePath?: string;
+    contentExtensions?: string[];
+    model?: string;
+    backend?: RagStoreBackend;
+    branch?: string;
+    topK?: number;
+    threshold?: number;
+    maxQueryChars?: number;
+}
+/** Per-call options for project knowledge retrieval. */
+export interface ProjectKnowledgeRetrieveOptions extends RagSearchOptions {
+    maxQueryChars?: number;
+}
+/** Result returned from project knowledge retrieval. */
+export interface ProjectKnowledgeResult {
+    query: string;
+    matches: RagSearchResult[];
+    context: string;
+}
+/** Helper for indexing and retrieving project knowledge. */
+export interface ProjectKnowledge {
+    /**
+     * Index configured project knowledge explicitly.
+     *
+     * Keep this out of the chat request path. Use it during setup, deploy,
+     * ingestion, or another controlled lifecycle step.
+     */
+    index(): Promise<void>;
+    retrieve(query: string, options?: ProjectKnowledgeRetrieveOptions): Promise<ProjectKnowledgeResult>;
+    search(query: string, options?: RagSearchOptions): Promise<RagSearchResult[]>;
+}
+/** Normalize a knowledge query before retrieval. */
+export declare function normalizeKnowledgeQuery(query: string, maxChars?: number): string;
+/** Format search results into a deterministic prompt context block. */
+export declare function formatKnowledgeContext(results: RagSearchResult[]): string;
+/** Create a project knowledge helper backed by the configured RAG store. */
+export declare function projectKnowledge(config?: ProjectKnowledgeConfig): ProjectKnowledge;
+//# sourceMappingURL=index.d.ts.map

package/esm/src/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/knowledge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAQ/B,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,+BAAgC,SAAQ,gBAAgB;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC/E;AAOD,oDAAoD;AACpD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAgC,GACzC,MAAM,CAER;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAIzE;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,sBAA2B,GAAG,gBAAgB,CAmDtF"}

package/esm/src/knowledge/index.js

@@ -0,0 +1,77 @@
+/**
+ * Project knowledge retrieval helpers.
+ *
+ * @module knowledge
+ *
+ * @example
+ * ```ts
+ * import { projectKnowledge } from "veryfront/knowledge";
+ *
+ * const knowledge = projectKnowledge();
+ * await knowledge.index();
+ * const result = await knowledge.retrieve("SSO login failure");
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+import { ragStore } from "../embedding/index.js";
+import { isAbsolute, join } from "../platform/compat/path/index.js";
+const DEFAULT_CONTENT_DIR = "knowledge";
+const DEFAULT_STORAGE_PATH = "data/knowledge-index.json";
+const DEFAULT_TOP_K = 3;
+const DEFAULT_QUERY_MAX_CHARS = 500;
+function resolveProjectPath(projectDir, path) {
+    if (!projectDir || isAbsolute(path))
+        return path;
+    return join(projectDir, path);
+}
+/** Normalize a knowledge query before retrieval. */
+export function normalizeKnowledgeQuery(query, maxChars = DEFAULT_QUERY_MAX_CHARS) {
+    return query.replace(/\s+/g, " ").trim().slice(0, maxChars);
+}
+/** Format search results into a deterministic prompt context block. */
+export function formatKnowledgeContext(results) {
+    return results
+        .map((result) => `[${result.title}] (score: ${result.score.toFixed(2)})\n${result.text}`)
+        .join("\n\n---\n\n");
+}
+/** Create a project knowledge helper backed by the configured RAG store. */
+export function projectKnowledge(config = {}) {
+    const store = ragStore({
+        model: config.model,
+        backend: config.backend,
+        branch: config.branch,
+        contentDir: resolveProjectPath(config.projectDir, config.contentDir ?? DEFAULT_CONTENT_DIR),
+        storagePath: resolveProjectPath(config.projectDir, config.storagePath ?? DEFAULT_STORAGE_PATH),
+        contentExtensions: config.contentExtensions,
+    });
+    async function index() {
+        await store.indexContentDir();
+    }
+    async function search(query, options) {
+        const normalizedQuery = normalizeKnowledgeQuery(query, config.maxQueryChars);
+        if (!normalizedQuery)
+            return [];
+        return store.search(normalizedQuery, {
+            topK: options?.topK ?? config.topK ?? DEFAULT_TOP_K,
+            threshold: options?.threshold ?? config.threshold,
+        });
+    }
+    return {
+        index,
+        async retrieve(query, options) {
+            const normalizedQuery = normalizeKnowledgeQuery(query, options?.maxQueryChars ?? config.maxQueryChars);
+            if (!normalizedQuery)
+                return { query: "", matches: [], context: "" };
+            const matches = await store.search(normalizedQuery, {
+                topK: options?.topK ?? config.topK ?? DEFAULT_TOP_K,
+                threshold: options?.threshold ?? config.threshold,
+            });
+            return {
+                query: normalizedQuery,
+                matches,
+                context: formatKnowledgeContext(matches),
+            };
+        },
+        search,
+    };
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.932";
+export declare const VERSION = "0.1.934";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.932";
+export const VERSION = "0.1.934";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.932",
+  "version": "0.1.934",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -193,6 +193,10 @@
       "import": "./esm/src/embedding/index.js",
       "types": "./esm/src/embedding/index.d.ts"
     },
+    "./knowledge": {
+      "import": "./esm/src/knowledge/index.js",
+      "types": "./esm/src/knowledge/index.d.ts"
+    },
     "./extensions": {
       "import": "./esm/src/extensions/index.js",
       "types": "./esm/src/extensions/index.d.ts"