veryfront 0.1.47 → 0.1.49

package/esm/src/discovery/discovery-utils.js

@@ -29,12 +29,6 @@ const discoveredAgentPaths = new Map();
 export function trackAgentPath(id, filePath) {
     discoveredAgentPaths.set(id, filePath);
 }
-/**
- * Get all tracked agent paths
- */
-export function getTrackedAgentPaths() {
-    return discoveredAgentPaths;
-}
 /**
  * Clear tracked agent paths
  */

package/esm/src/discovery/file-discovery.d.ts

@@ -9,7 +9,9 @@ import type { FileDiscoveryContext } from "./types.js";
  */
 export declare function findTypeScriptFiles(dir: string, context: FileDiscoveryContext): Promise<string[]>;
 /**
- * Get Node.js fs and path modules (cached on context)
+ * Get Node.js fs and path modules (cached on context).
+ *
+ * Only called when no fsAdapter is present — callers must guard accordingly.
  */
 export declare function getNodeDeps(context: FileDiscoveryContext): Promise<{
     fs: typeof import("node:fs");

package/esm/src/discovery/file-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-discovery.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/file-discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2CnB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,cAAc,SAAS,CAAC,CAAC;IAAC,IAAI,EAAE,cAAc,WAAW,CAAC,CAAA;CAAE,CAAC,CAc7E"}
+{"version":3,"file":"file-discovery.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/file-discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2CnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,cAAc,SAAS,CAAC,CAAC;IAAC,IAAI,EAAE,cAAc,WAAW,CAAC,CAAA;CAAE,CAAC,CAM7E"}

package/esm/src/discovery/file-discovery.js

@@ -44,18 +44,13 @@ export async function findTypeScriptFiles(dir, context) {
     return files;
 }
 /**
- * Get Node.js fs and path modules (cached on context)
+ * Get Node.js fs and path modules (cached on context).
+ *
+ * Only called when no fsAdapter is present — callers must guard accordingly.
  */
 export async function getNodeDeps(context) {
     if (context.nodeDeps)
         return context.nodeDeps;
-    if (context.fsAdapter) {
-        context.nodeDeps = {
-            fs: {},
-            path: {},
-        };
-        return context.nodeDeps;
-    }
     const [fsModule, pathModule] = await Promise.all([import("node:fs"), import("node:path")]);
     context.nodeDeps = { fs: fsModule, path: pathModule };
     return context.nodeDeps;

package/esm/src/discovery/handlers/index.d.ts

@@ -9,4 +9,5 @@ export { resourceHandler } from "./resource-handler.js";
 export { promptHandler } from "./prompt-handler.js";
 export { workflowHandler } from "./workflow-handler.js";
 export { taskHandler } from "./task-handler.js";
+export { discoverSkills } from "./skill-handler.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/discovery/handlers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/esm/src/discovery/handlers/index.js

@@ -9,3 +9,4 @@ export { resourceHandler } from "./resource-handler.js";
 export { promptHandler } from "./prompt-handler.js";
 export { workflowHandler } from "./workflow-handler.js";
 export { taskHandler } from "./task-handler.js";
+export { discoverSkills } from "./skill-handler.js";

package/esm/src/discovery/handlers/skill-handler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Skill Discovery Handler
+ *
+ * Discovers skills from SKILL.md files in project directories.
+ * This is a parallel discovery path — it does NOT implement DiscoveryHandler<T>
+ * (which expects TypeScript import()). Instead, it operates on markdown files.
+ */
+import type { Skill } from "../../skill/index.js";
+import type { FileDiscoveryContext } from "../types.js";
+export interface SkillDiscoveryError {
+    file: string;
+    error: Error;
+}
+export interface SkillDiscoveryResult {
+    skills: Map<string, Skill>;
+    errors: SkillDiscoveryError[];
+}
+/**
+ * Discover skills from a directory.
+ *
+ * Scans for subdirectories containing SKILL.md files and parses them
+ * into Skill objects. Uses fsAdapter when available (for VFS/cloud),
+ * falling back to compat layer functions.
+ */
+export declare function discoverSkills(dir: string, context: FileDiscoveryContext, verbose?: boolean): Promise<SkillDiscoveryResult>;
+//# sourceMappingURL=skill-handler.d.ts.map

package/esm/src/discovery/handlers/skill-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/skill-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAkF/B"}

package/esm/src/discovery/handlers/skill-handler.js

@@ -0,0 +1,87 @@
+/**
+ * Skill Discovery Handler
+ *
+ * Discovers skills from SKILL.md files in project directories.
+ * This is a parallel discovery path — it does NOT implement DiscoveryHandler<T>
+ * (which expects TypeScript import()). Instead, it operates on markdown files.
+ */
+import { exists, readDir, readTextFile } from "../../platform/compat/fs.js";
+import { join } from "../../platform/compat/path/index.js";
+import { agentLogger } from "../../utils/logger/logger.js";
+import { ensureError } from "../../errors/veryfront-error.js";
+import { parseSkillFrontmatter, validateSkillMetadata } from "../../skill/parser.js";
+import { SKILL_MD_FILENAME } from "../../skill/types.js";
+const logger = agentLogger.component("skill-discovery");
+/**
+ * Discover skills from a directory.
+ *
+ * Scans for subdirectories containing SKILL.md files and parses them
+ * into Skill objects. Uses fsAdapter when available (for VFS/cloud),
+ * falling back to compat layer functions.
+ */
+export async function discoverSkills(dir, context, verbose) {
+    const skills = new Map();
+    const errors = [];
+    const { fsAdapter } = context;
+    // Check if directory exists
+    const dirExists = fsAdapter ? await fsAdapter.exists(dir) : await exists(dir);
+    if (!dirExists) {
+        if (verbose) {
+            logger.info(`Skills directory does not exist: ${dir}`);
+        }
+        return { skills, errors };
+    }
+    // Iterate subdirectories
+    const entries = fsAdapter ? fsAdapter.readDir(dir) : readDir(dir);
+    for await (const entry of entries) {
+        if (!entry.isDirectory)
+            continue;
+        const skillDir = join(dir, entry.name);
+        const skillMdPath = join(skillDir, SKILL_MD_FILENAME);
+        try {
+            // Check if SKILL.md exists
+            const mdExists = fsAdapter ? await fsAdapter.exists(skillMdPath) : await exists(skillMdPath);
+            if (!mdExists) {
+                if (verbose) {
+                    logger.info(`Skipping ${entry.name}: no ${SKILL_MD_FILENAME}`);
+                }
+                continue;
+            }
+            // Read SKILL.md content
+            const content = fsAdapter
+                ? await fsAdapter.readFile(skillMdPath)
+                : await readTextFile(skillMdPath);
+            // Parse frontmatter
+            const parsed = await parseSkillFrontmatter(content);
+            // Validate metadata (directory name as fallback for skill name)
+            const metadata = validateSkillMetadata(parsed.frontmatter, entry.name);
+            // Warn if metadata name differs from directory name, use directory name as ID
+            const skillId = entry.name;
+            if (metadata.name !== entry.name) {
+                logger.warn(`Skill "${metadata.name}" in directory "${entry.name}" — using directory name as ID`);
+            }
+            // Check for duplicate IDs (first wins)
+            if (skills.has(skillId)) {
+                logger.warn(`Duplicate skill "${skillId}" — keeping first registration`);
+                continue;
+            }
+            const skill = {
+                id: skillId,
+                metadata,
+                rootPath: skillDir,
+                ...(fsAdapter && { fsAdapter }),
+            };
+            skills.set(skillId, skill);
+            if (verbose) {
+                logger.info(`Discovered skill: ${skillId}`);
+            }
+        }
+        catch (error) {
+            errors.push({ file: skillMdPath, error: ensureError(error) });
+            if (verbose) {
+                logger.error(`Error loading skill from ${entry.name}:`, error);
+            }
+        }
+    }
+    return { skills, errors };
+}

package/esm/src/discovery/handlers/task-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/task-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,cAAc,CAcxD,CAAC"}
+{"version":3,"file":"task-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/task-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAErE,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,cAAc,CAUxD,CAAC"}

package/esm/src/discovery/handlers/task-handler.js

@@ -6,12 +6,8 @@ export const taskHandler = {
     typeName: "task",
     validate: (item) => isTaskDefinition(item),
     getId: (_task, file, dir) => {
-        // Derive ID from file path relative to tasks dir
-        let relative = file;
         const prefix = dir.endsWith("/") ? dir : `${dir}/`;
-        if (relative.startsWith(prefix)) {
-            relative = relative.slice(prefix.length);
-        }
+        const relative = file.startsWith(prefix) ? file.slice(prefix.length) : file;
         return relative.replace(/\.(ts|tsx|js|jsx)$/, "");
     },
     register: (_id, task) => task,

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;AAwHvD;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwFlB;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;AA6HvD;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwFlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/esm/src/discovery/transpiler.js

@@ -11,6 +11,10 @@ import * as pathHelper from "../platform/compat/path/index.js";
 import { getEsbuildLoader } from "../utils/path-utils.js";
 import { rewriteDiscoveryImports, rewriteForDeno } from "./import-rewriter.js";
 import { wrapWithCurrentContext } from "../platform/adapters/fs/veryfront/multi-project-adapter.js";
+// Static import ensures deno compile includes embedding in the binary.
+// Other modules (agent, tool, etc.) are statically imported elsewhere;
+// embedding is only referenced here.
+import * as embeddingMod from "../embedding/index.js";
 const transpileCache = new Map();
 // Setup veryfront modules as globals for compiled binary support
 let veryfrontGlobalsInitialized = false;
@@ -33,6 +37,7 @@ async function ensureVeryfrontGlobals() {
         "veryfront/platform": platformMod,
         "veryfront/prompt": promptMod,
         "veryfront/resource": resourceMod,
+        "veryfront/embedding": embeddingMod,
     };
     veryfrontGlobalsInitialized = true;
 }
@@ -169,8 +174,8 @@ export async function importModule(file, context) {
             sourcefile: filePath,
         },
     });
-    if (result.errors?.length) {
-        throw new Error(`Failed to transpile ${filePath}: ${result.errors[0]?.text || "unknown error"}`);
+    if (result.errors.length > 0) {
+        throw new Error(`Failed to transpile ${filePath}: ${result.errors[0]?.text ?? "unknown error"}`);
     }
     const js = result.outputFiles?.[0]?.text ?? "export {}";
     const localFs = createFileSystem();

package/esm/src/discovery/types.d.ts

@@ -8,6 +8,7 @@ import type { Agent } from "../agent/index.js";
 import type { Resource } from "../resource/index.js";
 import type { Prompt } from "../prompt/index.js";
 import type { Workflow } from "../workflow/index.js";
+import type { Skill } from "../skill/index.js";
 import type { TaskDefinition } from "../task/types.js";
 import type { Platform } from "../platform/core-platform.js";
 import type { FileSystemAdapter } from "../platform/adapters/base.js";
@@ -30,6 +31,7 @@ export interface DiscoveryConfig {
     baseDir: string;
     toolDirs?: string[];
     agentDirs?: string[];
+    skillDirs?: string[];
     resourceDirs?: string[];
     promptDirs?: string[];
     workflowDirs?: string[];
@@ -43,6 +45,7 @@ export interface DiscoveryConfig {
 export interface DiscoveryResult {
     tools: Map<string, Tool>;
     agents: Map<string, Agent>;
+    skills: Map<string, Skill>;
     resources: Map<string, Resource>;
     prompts: Map<string, Prompt>;
     workflows: Map<string, Workflow>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,cAAc,SAAS,CAAC,CAAC;QAC7B,IAAI,EAAE,cAAc,WAAW,CAAC,CAAC;KAClC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IAChE,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,cAAc,SAAS,CAAC,CAAC;QAC7B,IAAI,EAAE,cAAc,WAAW,CAAC,CAAC;KAClC,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IAChE,YAAY,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3D"}

package/esm/src/embedding/chunk.d.ts

@@ -0,0 +1,18 @@
+import type { ChunkOptions } from "./types.js";
+/**
+ * Splits text into overlapping chunks for embedding.
+ *
+ * Uses a recursive character splitting strategy: tries each separator in
+ * order (paragraphs → lines → words → characters) to produce semantically
+ * coherent chunks within the size limit.
+ *
+ * Default chunk size is 2000 characters (~512 tokens), aligned with
+ * common embedding model context limits (e.g. OpenAI's 8191-token max).
+ *
+ * @example
+ * ```ts
+ * const chunks = await chunk("long document...", { maxChars: 2000, overlap: 200 });
+ * ```
+ */
+export declare function chunk(text: string, options?: ChunkOptions): Promise<string[]>;
+//# sourceMappingURL=chunk.d.ts.map

package/esm/src/embedding/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnF"}

package/esm/src/embedding/chunk.js

@@ -0,0 +1,48 @@
+/**
+ * Splits text into overlapping chunks for embedding.
+ *
+ * Uses a recursive character splitting strategy: tries each separator in
+ * order (paragraphs → lines → words → characters) to produce semantically
+ * coherent chunks within the size limit.
+ *
+ * Default chunk size is 2000 characters (~512 tokens), aligned with
+ * common embedding model context limits (e.g. OpenAI's 8191-token max).
+ *
+ * @example
+ * ```ts
+ * const chunks = await chunk("long document...", { maxChars: 2000, overlap: 200 });
+ * ```
+ */
+export async function chunk(text, options) {
+    const maxChars = options?.maxChars ?? 2000;
+    const overlap = options?.overlap ?? 200;
+    const separators = options?.separators ?? ["\n\n", "\n", " ", ""];
+    return splitRecursive(text, separators, maxChars, overlap);
+}
+function splitRecursive(text, separators, maxChars, overlap) {
+    if (text.length <= maxChars)
+        return [text];
+    const sep = separators.find((s) => text.includes(s)) ?? "";
+    const parts = sep ? text.split(sep) : [...text];
+    const chunks = [];
+    let current = "";
+    for (const part of parts) {
+        const candidate = current ? current + sep + part : part;
+        if (candidate.length > maxChars && current) {
+            chunks.push(current);
+            // Overlap: keep the tail of the current chunk
+            const tail = current.slice(-overlap);
+            current = tail ? tail + sep + part : part;
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current)
+        chunks.push(current);
+    // If any chunk still exceeds maxChars, recurse with next separator
+    const remaining = separators.slice(separators.indexOf(sep) + 1);
+    if (remaining.length === 0)
+        return chunks;
+    return chunks.flatMap((c) => c.length > maxChars ? splitRecursive(c, remaining, maxChars, overlap) : [c]);
+}

package/esm/src/embedding/embedding.d.ts

@@ -0,0 +1,23 @@
+import type { Embedding, EmbeddingConfig } from "./types.js";
+/**
+ * Creates an embedding facade.
+ *
+ * Sync factory, async methods — same pattern as `tool()` and `agent()`.
+ *
+ * - `embed()` applies `queryPrefix` (optimized for search queries)
+ * - `embedMany()` applies `documentPrefix` (optimized for document indexing)
+ * - `embedMany()` automatically batches large inputs to stay within API limits
+ *
+ * @example
+ * ```ts
+ * const embedder = embedding({
+ *   model: "openai/text-embedding-3-small",
+ *   documentPrefix: "search_document: ",  // for Nomic, E5, BGE models
+ *   queryPrefix: "search_query: ",
+ * });
+ * const vector = await embedder.embed("some query");
+ * const vectors = await embedder.embedMany(["doc1", "doc2"]);
+ * ```
+ */
+export declare function embedding(config: EmbeddingConfig): Embedding;
+//# sourceMappingURL=embedding.d.ts.map

package/esm/src/embedding/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/embedding.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAmC5D"}

package/esm/src/embedding/embedding.js

@@ -0,0 +1,54 @@
+import { embed, embedMany } from "ai";
+import { resolveEmbeddingModel } from "./resolve.js";
+const DEFAULT_BATCH_SIZE = 100;
+/**
+ * Creates an embedding facade.
+ *
+ * Sync factory, async methods — same pattern as `tool()` and `agent()`.
+ *
+ * - `embed()` applies `queryPrefix` (optimized for search queries)
+ * - `embedMany()` applies `documentPrefix` (optimized for document indexing)
+ * - `embedMany()` automatically batches large inputs to stay within API limits
+ *
+ * @example
+ * ```ts
+ * const embedder = embedding({
+ *   model: "openai/text-embedding-3-small",
+ *   documentPrefix: "search_document: ",  // for Nomic, E5, BGE models
+ *   queryPrefix: "search_query: ",
+ * });
+ * const vector = await embedder.embed("some query");
+ * const vectors = await embedder.embedMany(["doc1", "doc2"]);
+ * ```
+ */
+export function embedding(config) {
+    const model = resolveEmbeddingModel(config.model);
+    const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
+    const docPrefix = config.documentPrefix ?? "";
+    const queryPrefix = config.queryPrefix ?? "";
+    return {
+        model: config.model,
+        async embed(text) {
+            const result = await embed({ model, value: queryPrefix + text });
+            return result.embedding;
+        },
+        async embedMany(texts) {
+            if (texts.length === 0)
+                return [];
+            const prefixed = docPrefix ? texts.map((t) => docPrefix + t) : texts;
+            // Single batch — no chunking needed
+            if (prefixed.length <= batchSize) {
+                const result = await embedMany({ model, values: prefixed });
+                return result.embeddings;
+            }
+            // Chunked batches for large inputs
+            const results = [];
+            for (let i = 0; i < prefixed.length; i += batchSize) {
+                const batch = prefixed.slice(i, i + batchSize);
+                const result = await embedMany({ model, values: batch });
+                results.push(...result.embeddings);
+            }
+            return results;
+        },
+    };
+}

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

@@ -0,0 +1,29 @@
+/**
+ * Embedding — RAG primitives for chunking, embedding, and similarity search.
+ *
+ * Provides a facade over AI SDK (embeddings, similarity) and LangChain
+ * (text splitting) behind veryfront's own API.
+ *
+ * @module embedding
+ *
+ * @example
+ * ```ts
+ * import { uploadStore, createUploadHandler } from "veryfront/embedding";
+ *
+ * const store = uploadStore({ model: "openai/text-embedding-3-small" });
+ * export const { POST, GET, DELETE } = createUploadHandler(store);
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { embedding } from "./embedding.js";
+export { chunk } from "./chunk.js";
+export { cosineSimilarity as similarity } from "ai";
+export { vectorStore } from "./vector-store.js";
+export { uploadStore } from "./upload-store.js";
+export { createUploadHandler } from "./upload-handler.js";
+export { loadUpload } from "./upload-loader.js";
+export { useUploads } from "./react/use-uploads.js";
+export type { UseUploadsOptions, UseUploadsResult } from "./react/use-uploads.js";
+export { clearEmbeddingProviders, registerEmbeddingProvider, resolveEmbeddingModel, } from "./resolve.js";
+export type { ChunkOptions, Embedding, EmbeddingConfig, SearchOptions, SearchResult, StoredChunk, UploadMeta, UploadSearchOptions, UploadSearchResult, UploadStore, UploadStoreConfig, UploadStoreData, VectorStore, VectorStoreConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/esm/src/embedding/index.js

@@ -0,0 +1,26 @@
+/**
+ * Embedding — RAG primitives for chunking, embedding, and similarity search.
+ *
+ * Provides a facade over AI SDK (embeddings, similarity) and LangChain
+ * (text splitting) behind veryfront's own API.
+ *
+ * @module embedding
+ *
+ * @example
+ * ```ts
+ * import { uploadStore, createUploadHandler } from "veryfront/embedding";
+ *
+ * const store = uploadStore({ model: "openai/text-embedding-3-small" });
+ * export const { POST, GET, DELETE } = createUploadHandler(store);
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export { embedding } from "./embedding.js";
+export { chunk } from "./chunk.js";
+export { cosineSimilarity as similarity } from "ai";
+export { vectorStore } from "./vector-store.js";
+export { uploadStore } from "./upload-store.js";
+export { createUploadHandler } from "./upload-handler.js";
+export { loadUpload } from "./upload-loader.js";
+export { useUploads } from "./react/use-uploads.js";
+export { clearEmbeddingProviders, registerEmbeddingProvider, resolveEmbeddingModel, } from "./resolve.js";

package/esm/src/embedding/react/use-uploads.d.ts

@@ -0,0 +1,31 @@
+/**
+ * useUploads Hook
+ *
+ * Manages upload, deletion, and listing for RAG applications.
+ * Pairs with `createUploadHandler` on the server side.
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import type { UploadMeta } from "../types.js";
+export interface UseUploadsOptions {
+    /** API endpoint, e.g. "/api/uploads" */
+    api: string;
+}
+export interface UseUploadsResult {
+    /** All uploads from the server */
+    uploads: UploadMeta[];
+    /** True while an upload is in progress */
+    uploading: boolean;
+    /** User-facing error message, cleared on next action */
+    error: string | null;
+    /** Upload a file (multipart POST) */
+    upload: (file: dntShim.File) => Promise<void>;
+    /** Delete an upload by ID */
+    remove: (id: string) => Promise<void>;
+    /** Re-fetch the upload list */
+    refresh: () => Promise<void>;
+}
+/**
+ * useUploads hook for managing RAG upload lifecycle.
+ */
+export declare function useUploads(options: UseUploadsOptions): UseUploadsResult;
+//# sourceMappingURL=use-uploads.d.ts.map

package/esm/src/embedding/react/use-uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-uploads.d.ts","sourceRoot":"","sources":["../../../../src/src/embedding/react/use-uploads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,6BAA6B;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAiEvE"}

package/esm/src/embedding/react/use-uploads.js

@@ -0,0 +1,71 @@
+/**
+ * useUploads Hook
+ *
+ * Manages upload, deletion, and listing for RAG applications.
+ * Pairs with `createUploadHandler` on the server side.
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * useUploads hook for managing RAG upload lifecycle.
+ */
+export function useUploads(options) {
+    const [uploads, setUploads] = useState([]);
+    const [uploading, setUploading] = useState(false);
+    const [error, setError] = useState(null);
+    const abortControllerRef = useRef(null);
+    const refresh = useCallback(async () => {
+        try {
+            const res = await dntShim.fetch(options.api);
+            if (!res.ok)
+                return;
+            const data = await res.json();
+            setUploads(data.uploads ?? []);
+        }
+        catch {
+            setError("Failed to load uploads");
+        }
+    }, [options.api]);
+    useEffect(() => {
+        refresh();
+    }, [refresh]);
+    const upload = useCallback(async (file) => {
+        setError(null);
+        setUploading(true);
+        const abortController = new AbortController();
+        abortControllerRef.current = abortController;
+        try {
+            const formData = new dntShim.FormData();
+            formData.append("file", file);
+            const res = await dntShim.fetch(options.api, {
+                method: "POST",
+                body: formData,
+                signal: abortController.signal,
+            });
+            const data = await res.json();
+            if (!res.ok)
+                throw new Error(data.error ?? "Upload failed");
+            await refresh();
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === "AbortError")
+                return;
+            setError(err instanceof Error ? err.message : "Upload failed");
+        }
+        finally {
+            setUploading(false);
+            abortControllerRef.current = null;
+        }
+    }, [options.api, refresh]);
+    const remove = useCallback(async (id) => {
+        setError(null);
+        try {
+            await dntShim.fetch(`${options.api}/${id}`, { method: "DELETE" });
+            await refresh();
+        }
+        catch {
+            setError("Failed to delete upload");
+        }
+    }, [options.api, refresh]);
+    return { uploads, uploading, error, upload, remove, refresh };
+}

package/esm/src/embedding/resolve.d.ts

@@ -0,0 +1,27 @@
+import type { EmbeddingModel } from "ai";
+export type EmbeddingProviderFactory = (modelId: string) => EmbeddingModel;
+/**
+ * Register an embedding provider factory.
+ *
+ * @example
+ * ```ts
+ * registerEmbeddingProvider("openai", (id) =>
+ *   createOpenAI({ apiKey })().embedding(id)
+ * );
+ * ```
+ */
+export declare function registerEmbeddingProvider(name: string, factory: EmbeddingProviderFactory): void;
+/**
+ * Resolve a "provider/model" string to an AI SDK EmbeddingModel instance.
+ *
+ * @example
+ * ```ts
+ * const model = resolveEmbeddingModel("openai/text-embedding-3-small");
+ * ```
+ */
+export declare function resolveEmbeddingModel(modelString: string): EmbeddingModel;
+/**
+ * Clear all registered embedding providers (for testing).
+ */
+export declare function clearEmbeddingProviders(): void;
+//# sourceMappingURL=resolve.d.ts.map

package/esm/src/embedding/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAOzC,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;AAK3E;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAEN;AA2CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAuCzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}