veryfront 0.1.933 → 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.933",
+    "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/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.933";
+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.933";
+export const VERSION = "0.1.934";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.933",
+  "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"