veryfront 0.1.46 → 0.1.48

package/esm/cli/app/shell.js

@@ -48,7 +48,7 @@ export function createApp(config) {
     }
     state = setTemplates([
         { id: "ai-agent", name: "AI Chatbot", description: "Agent + chat UI + streaming" },
-        { id: "chat-with-your-docs", name: "Chat with Docs", description: "RAG with source citations" },
+        { id: "docs-agent", name: "Docs Agent", description: "Document Q&A with source citations" },
         {
             id: "multi-agent-system",
             name: "Multi-Agent",

package/esm/cli/commands/build/handler.d.ts

@@ -31,8 +31,8 @@ export declare const BuildArgsSchema: z.ZodObject<{
     split?: boolean | undefined;
     output?: string | undefined;
     prefetch?: boolean | undefined;
-    dryRun?: boolean | undefined;
     preset?: string | undefined;
+    dryRun?: boolean | undefined;
     compress?: boolean | undefined;
     ssg?: boolean | undefined;
     noSsg?: boolean | undefined;

package/esm/cli/commands/init/catalog.js

@@ -6,9 +6,9 @@ export const TEMPLATES = [
     { id: "minimal", label: "Minimal", description: "Blank canvas, no extras" },
     { id: "ai-agent", label: "AI Agent", description: "Agent + chat UI + streaming" },
     {
-        id: "chat-with-your-docs",
-        label: "Chat with Your Docs",
-        description: "RAG with source citations",
+        id: "docs-agent",
+        label: "Docs Agent",
+        description: "Document Q&A with source citations",
     },
     {
         id: "agentic-workflow",

package/esm/cli/commands/init/command-help.js

@@ -5,7 +5,7 @@ export const initHelp = {
     options: [
         {
             flag: "-t, --template <name>",
-            description: "Project template (minimal | ai-agent | chat-with-your-docs | agentic-workflow | multi-agent-system | coding-agent | saas-starter)",
+            description: "Project template (minimal | ai-agent | docs-agent | agentic-workflow | multi-agent-system | coding-agent | saas-starter)",
         },
         {
             flag: "--integrations <list>",
@@ -36,7 +36,7 @@ export const initHelp = {
         "veryfront init                              # Interactive wizard",
         "veryfront init my-app",
         "veryfront init my-app --template ai-agent",
-        "veryfront init my-rag --template chat-with-your-docs",
+        "veryfront init my-rag --template docs-agent",
         "veryfront init my-pipeline --template agentic-workflow",
         "veryfront init my-app --deploy              # Create and deploy",
         "veryfront init --config project.json        # From config file",

package/esm/cli/commands/init/config-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/config-generator.ts"],"names":[],"mappings":"AAOA,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/config-generator.ts"],"names":[],"mappings":"AAOA,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/esm/cli/commands/init/config-generator.js

@@ -5,6 +5,13 @@ import { createFileSystem } from "../../../src/platform/index.js";
 const DEFAULT_INIT_REACT_VERSION = "19.1.1";
 export async function createPackageJson(projectDir, projectName) {
     const fs = createFileSystem();
+    // Read any existing package.json (e.g. from template) to merge dependencies
+    let templateDeps = {};
+    const pkgPath = join(projectDir, "package.json");
+    if (await fs.exists(pkgPath)) {
+        const existing = JSON.parse(await fs.readTextFile(pkgPath));
+        templateDeps = existing.dependencies ?? {};
+    }
     const dirName = projectDir.split(/[/\\]/).pop();
     const packageJson = {
         name: projectName ?? dirName ?? "veryfront-project",
@@ -19,6 +26,7 @@ export async function createPackageJson(projectDir, projectName) {
             onlyBuiltDependencies: ["esbuild", "veryfront"],
         },
         dependencies: {
+            ...templateDeps,
             react: `^${DEFAULT_INIT_REACT_VERSION}`,
             "react-dom": `^${DEFAULT_INIT_REACT_VERSION}`,
             veryfront: `^${VERSION}`,

package/esm/cli/commands/init/types.d.ts

@@ -1,5 +1,5 @@
 import type { FeatureName, IntegrationName } from "../../templates/types.js";
-export type InitTemplate = "ai-agent" | "chat-with-your-docs" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | "minimal";
+export type InitTemplate = "ai-agent" | "docs-agent" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | "minimal";
 export type EnvValues = Record<string, string>;
 export interface InitOptions {
     name?: string;

package/esm/cli/commands/init/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE7E,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE7E,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/esm/cli/commands/merge/command.d.ts

@@ -24,8 +24,8 @@ export declare const MergeArgsSchema: z.ZodObject<{
 }, {
     branch: string;
     force?: boolean | undefined;
-    dryRun?: boolean | undefined;
     into?: string | undefined;
+    dryRun?: boolean | undefined;
 }>;
 /**
  * Merge command options (inferred from schema)

package/esm/cli/help/tips.js

@@ -14,7 +14,7 @@ export function getBuildTips() {
 export function getInitTemplates() {
     return `${yellow("Available Templates:")}\n` +
         `  • ${green("ai-agent")}              - AI chatbot with tools and streaming\n` +
-        `  • ${green("chat-with-your-docs")} - Chat with your docs (RAG + citations)\n` +
+        `  • ${green("docs-agent")}         - Document Q&A with source citations\n` +
         `  • ${green("multi-agent-system")}  - Agents that delegate to each other\n` +
         `  • ${green("agentic-workflow")}    - AI pipeline with approvals\n` +
         `  • ${green("coding-agent")}        - AI code assistant with file tools\n` +

package/esm/cli/mcp/remote-file-tools.js

@@ -364,7 +364,7 @@ export const vfRemoteDeleteBranch = {
 // ============================================================================
 const remoteCreateProjectInput = z.object({
     slug: z.string().describe("Project slug (lowercase letters, numbers, hyphens only). A random suffix is appended if the slug is already taken."),
-    templateSlug: z.string().optional().describe("Template project slug to fork from (e.g., 'blank', 'ai-agent', 'chat-with-your-docs')"),
+    templateSlug: z.string().optional().describe("Template project slug to fork from (e.g., 'blank', 'ai-agent', 'docs-agent')"),
     is_public: z.boolean().optional().describe("Whether the project is public (default: false)"),
 });
 export const vfRemoteCreateProject = {

package/esm/cli/mcp/tools/catalog-tools.d.ts

@@ -52,18 +52,18 @@ type ListUsecasesInput = z.infer<typeof listUsecasesInput>;
 export declare const vfListUsecases: MCPTool<ListUsecasesInput, UsecaseInfo[]>;
 declare const createProjectInput: z.ZodObject<{
     name: z.ZodString;
-    template: z.ZodDefault<z.ZodOptional<z.ZodEnum<["ai-agent", "chat-with-your-docs", "multi-agent-system", "agentic-workflow", "coding-agent", "saas-starter", "minimal"]>>>;
+    template: z.ZodDefault<z.ZodOptional<z.ZodEnum<["ai-agent", "docs-agent", "multi-agent-system", "agentic-workflow", "coding-agent", "saas-starter", "minimal"]>>>;
     integrations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     directory: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    template: "minimal" | "ai-agent" | "chat-with-your-docs" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter";
+    template: "minimal" | "ai-agent" | "docs-agent" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter";
     integrations?: string[] | undefined;
     directory?: string | undefined;
 }, {
     name: string;
     integrations?: string[] | undefined;
-    template?: "minimal" | "ai-agent" | "chat-with-your-docs" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | undefined;
+    template?: "minimal" | "ai-agent" | "docs-agent" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | undefined;
     directory?: string | undefined;
 }>;
 type CreateProjectInput = z.infer<typeof createProjectInput>;

package/esm/cli/mcp/tools/catalog-tools.js

@@ -34,7 +34,7 @@ const EXAMPLES = [
     {
         name: "data-analyst",
         description: "RAG-powered data analyst with Sheets and Snowflake",
-        template: "chat-with-your-docs",
+        template: "docs-agent",
         integrations: ["sheets", "snowflake", "notion"],
         features: ["Document search", "Chart generation", "Reports"],
         difficulty: "advanced",
@@ -64,7 +64,7 @@ const TEMPLATES = [
         recommended: true,
     },
     {
-        name: "chat-with-your-docs",
+        name: "docs-agent",
         description: "Chat with your docs using retrieval-augmented generation",
         features: ["Document search", "Source citations", "File-based knowledge"],
     },
@@ -339,7 +339,7 @@ const createProjectInput = z.object({
     template: z
         .enum([
         "ai-agent",
-        "chat-with-your-docs",
+        "docs-agent",
         "multi-agent-system",
         "agentic-workflow",
         "coding-agent",

package/esm/cli/templates/index.js

@@ -17,7 +17,7 @@ const OPENAI_KEY_CONFIG = {
 };
 export const templateConfigs = {
     "ai-agent": { envVars: [OPENAI_KEY_CONFIG] },
-    "chat-with-your-docs": { envVars: [OPENAI_KEY_CONFIG] },
+    "docs-agent": { envVars: [OPENAI_KEY_CONFIG] },
     "multi-agent-system": { envVars: [OPENAI_KEY_CONFIG] },
     "agentic-workflow": { envVars: [OPENAI_KEY_CONFIG] },
     "coding-agent": { envVars: [OPENAI_KEY_CONFIG] },
@@ -25,7 +25,7 @@ export const templateConfigs = {
 };
 const DIRECTORY_BASED_TEMPLATES = [
     "ai-agent",
-    "chat-with-your-docs",
+    "docs-agent",
     "multi-agent-system",
     "agentic-workflow",
     "coding-agent",

package/esm/cli/templates/manifest.d.ts

@@ -26,28 +26,30 @@ declare namespace _default {
                 "tools/search.ts": string;
             };
         };
-        "chat-with-your-docs": {
+        "ai-agent": {
             files: {
                 "README.md": string;
                 "app/api/chat/route.ts": string;
                 "app/layout.tsx": string;
                 "app/page.tsx": string;
                 "tsconfig.json": string;
-                "agents/qa.ts": string;
-                "content/getting-started.md": string;
-                "content/architecture.md": string;
-                "tools/search-docs.ts": string;
+                "agents/assistant.ts": string;
+                "tools/calculator.ts": string;
             };
         };
-        "ai-agent": {
+        "docs-agent": {
             files: {
                 "README.md": string;
+                "app/api/uploads/route.ts": string;
+                "app/api/uploads/[id]/route.ts": string;
                 "app/api/chat/route.ts": string;
                 "app/layout.tsx": string;
                 "app/page.tsx": string;
                 "tsconfig.json": string;
-                "agents/assistant.ts": string;
-                "tools/calculator.ts": string;
+                "store.ts": string;
+                "agents/rag.ts": string;
+                "content/getting-started.md": string;
+                "content/architecture.md": string;
             };
         };
         minimal: {

package/esm/cli/templates/manifest.js

@@ -26,19 +26,6 @@ export default {
                 "tools/search.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\n\nexport default tool({\n  id: \"search\",\n  description: \"Search your knowledge base\",\n  inputSchema: z.object({\n    query: z.string().describe(\"Search query\"),\n  }),\n  execute: async ({ query }) => {\n    // Replace with your domain-specific search logic\n    return {\n      results: [],\n      query,\n      message: \"Connect your data source for real results.\",\n    };\n  },\n});\n"
             }
         },
-        "chat-with-your-docs": {
-            "files": {
-                "README.md": "# Chat with Your Docs\n\nA chatbot that answers questions from your own documents.\n\n## What's included\n\n- Q&A agent with source citation\n- Keyword-based document search over markdown files\n- Sample content in `/content` directory\n\n## Structure\n\n```\nagents/qa.ts           Q&A agent with citation instructions\ntools/search-docs.ts   Searches markdown files by relevance\ncontent/\n  getting-started.md   Sample document\n  architecture.md      Sample document\napp/\n  api/chat/route.ts    Chat API endpoint\n  page.tsx             Chat interface\n```\n\nAdd your own `.md`, `.mdx`, or `.txt` files to `content/` to expand the knowledge base.\n\nThis is a starter template to give you a good starting point — not a production-ready setup.\n",
-                "app/api/chat/route.ts": "import { createChatHandler } from \"veryfront/agent\";\n\nexport const POST = createChatHandler(\"qa\");\n",
-                "app/layout.tsx": "import { Head } from \"veryfront/head\";\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}): React.ReactNode {\n  return (\n    <>\n      <Head>\n        <title>Chat with Your Docs</title>\n      </Head>\n      <div className=\"flex flex-col h-screen bg-white dark:bg-neutral-950\">\n        <header className=\"flex-shrink-0 border-b border-neutral-200 dark:border-neutral-800\">\n          <div className=\"max-w-3xl mx-auto flex items-center gap-3 px-4 py-3\">\n            <div className=\"w-8 h-8 rounded-lg bg-emerald-500/10 flex items-center justify-center\">\n              <svg className=\"w-4 h-4 text-emerald-500\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" strokeWidth={2}>\n                <path strokeLinecap=\"round\" strokeLinejoin=\"round\" d=\"M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m5.231 13.481L15 17.25m-4.5-15H5.625c-.621 0-1.125.504-1.125 1.125v16.5c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9zm3.75 11.625a2.625 2.625 0 11-5.25 0 2.625 2.625 0 015.25 0z\" />\n              </svg>\n            </div>\n            <div>\n              <h1 className=\"font-medium text-neutral-900 dark:text-white text-sm\">Docs Q&A</h1>\n              <p className=\"text-xs text-neutral-500 dark:text-neutral-400\">Ask questions about your documents</p>\n            </div>\n          </div>\n        </header>\n        {children}\n      </div>\n    </>\n  );\n}\n",
-                "app/page.tsx": "'use client'\n\nimport { Chat, useChat } from 'veryfront/chat'\n\nexport default function DocsChat(): JSX.Element {\n  const chat = useChat({ api: '/api/chat' })\n\n  return <Chat {...chat} className=\"flex-1 min-h-0\" placeholder=\"Ask a question about your docs...\" />\n}\n",
-                "tsconfig.json": "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"bundler\",\n    \"strict\": true,\n    \"jsx\": \"react-jsx\",\n    \"skipLibCheck\": true,\n    \"esModuleInterop\": true,\n    \"paths\": {\n      \"@/*\": [\"./*\"]\n    }\n  },\n  \"include\": [\"**/*.ts\", \"**/*.tsx\"],\n  \"exclude\": [\"node_modules\"]\n}\n",
-                "agents/qa.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"qa\",\n  model: \"openai/gpt-4o\",\n  system: `You answer questions using the provided documents. Always cite your sources by referencing the document title. If the documents don't contain the answer, say so honestly.`,\n  tools: true,\n  maxSteps: 5,\n});\n",
-                "content/getting-started.md": "# Getting Started\n\nWelcome to Acme Platform. This guide covers initial setup and core concepts.\n\n## Installation\n\nInstall the CLI globally:\n\n```bash\nnpm install -g @acme/cli\n```\n\n## Creating a Project\n\nRun the init command to scaffold a new project:\n\n```bash\nacme init my-project\ncd my-project\n```\n\n## Project Structure\n\n- `src/` — Application source code\n- `config/` — Configuration files\n- `tests/` — Test suite\n- `docs/` — Documentation\n\n## Configuration\n\nCreate an `acme.config.ts` file in your project root:\n\n```ts\nexport default {\n  name: \"my-project\",\n  region: \"us-east-1\",\n  features: [\"auth\", \"storage\"],\n};\n```\n\n## Next Steps\n\n- Read the [Architecture Guide](./architecture) to understand the system design\n- Check [API Reference](./api-reference) for available endpoints\n- Join our Discord community for support\n",
-                "content/architecture.md": "# Architecture\n\nAcme Platform uses a modular, event-driven architecture.\n\n## Core Components\n\n### API Gateway\nRoutes incoming requests to the appropriate microservice. Handles authentication, rate limiting, and request validation.\n\n### Event Bus\nAsynchronous message broker connecting all services. Supports pub/sub and point-to-point messaging patterns.\n\n### Data Layer\nMulti-tenant data storage with automatic sharding. Supports PostgreSQL for relational data and Redis for caching.\n\n## Request Flow\n\n1. Client sends request to API Gateway\n2. Gateway validates authentication token\n3. Request is routed to the target service\n4. Service processes request and publishes events\n5. Response is returned through the gateway\n\n## Scaling\n\nEach component scales independently. The API Gateway uses horizontal scaling with load balancing. Services auto-scale based on queue depth and CPU utilization.\n\n## Security\n\n- All inter-service communication uses mTLS\n- API tokens are rotated every 24 hours\n- Data at rest is encrypted with AES-256\n- Audit logs are retained for 90 days\n",
-                "tools/search-docs.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\nimport { readTextFile, readDir, join, extname } from \"veryfront/fs\";\n\nconst CONTENT_DIR = \"content\";\nconst ALLOWED_EXTENSIONS = new Set([\".md\", \".mdx\", \".txt\"]);\n\nasync function listContentFiles(dir: string): Promise<string[]> {\n  const files: string[] = [];\n\n  for await (const entry of readDir(dir)) {\n    const fullPath = join(dir, entry.name);\n\n    if (entry.isDirectory) {\n      files.push(...(await listContentFiles(fullPath)));\n    } else if (entry.isFile && ALLOWED_EXTENSIONS.has(extname(entry.name))) {\n      files.push(fullPath);\n    }\n  }\n\n  return files;\n}\n\nexport default tool({\n  id: \"search-docs\",\n  description: \"Search documents in the knowledge base for relevant content\",\n  inputSchema: z.object({\n    query: z.string().describe(\"Search query\"),\n  }),\n  execute: async ({ query }) => {\n    const files = await listContentFiles(CONTENT_DIR);\n    const results: Array<{ title: string; content: string; relevance: number }> = [];\n    const queryTerms = query.toLowerCase().split(/\\s+/);\n\n    for (const file of files) {\n      const content = await readTextFile(file);\n      if (!content) continue;\n\n      const lower = content.toLowerCase();\n      const relevance = queryTerms.filter((term) => lower.includes(term)).length / queryTerms.length;\n\n      if (relevance > 0) {\n        const title = file.replace(/^content\\//, \"\").replace(/\\.(md|mdx|txt)$/, \"\");\n        results.push({ title, content: content.slice(0, 2000), relevance });\n      }\n    }\n\n    results.sort((a, b) => b.relevance - a.relevance);\n    return { documents: results.slice(0, 3) };\n  },\n});\n"
-            }
-        },
         "ai-agent": {
             "files": {
                 "README.md": "# AI Agent\n\nA simple conversational AI with tool support.\n\n## What's included\n\n- Single assistant agent with streaming chat UI\n- Example calculator tool\n- `useChat` hook for real-time responses\n\n## Structure\n\n```\nagents/assistant.ts    Agent definition\ntools/calculator.ts    Example tool\napp/\n  api/chat/route.ts    Chat API endpoint\n  page.tsx             Chat interface\n```\n\nThis is a starter template to give you a good starting point — not a production-ready setup.\n",
@@ -50,6 +37,21 @@ export default {
                 "tools/calculator.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\n\nexport default tool({\n  id: \"calculator\",\n  description: \"Perform basic arithmetic operations\",\n  inputSchema: z.object({\n    operation: z.enum([\"add\", \"subtract\", \"multiply\", \"divide\"]),\n    a: z.number(),\n    b: z.number(),\n  }),\n  execute: async ({ operation, a, b }) => {\n    if (operation === \"divide\" && b === 0) {\n      throw new Error(\"Cannot divide by zero\");\n    }\n\n    if (operation === \"add\") return { result: a + b };\n    if (operation === \"subtract\") return { result: a - b };\n    if (operation === \"multiply\") return { result: a * b };\n    return { result: a / b };\n  },\n});\n"
             }
         },
+        "docs-agent": {
+            "files": {
+                "README.md": "# Docs Agent\n\nA chatbot that answers questions from your own documents using Retrieval-Augmented Generation (RAG).\n\n## What's included\n\n- Q&A agent with source citation\n- Embedding-based semantic search (OpenAI text-embedding-3-small)\n- Document upload supporting PDF, DOCX, XLSX, PPTX, CSV, HTML, RTF, EPUB, TXT, and Markdown\n- JSON-based vector store — no external database required\n- Sample content in `/content` directory auto-indexed on first search\n\n## Getting started\n\n1. Set your OpenAI API key:\n\n   ```bash\n   export OPENAI_API_KEY=sk-...\n   ```\n\n2. Start the dev server:\n\n   ```bash\n   npx veryfront dev\n   ```\n\n3. Open the app and upload a document or ask a question — the sample docs in `content/` are indexed automatically.\n\n## Architecture\n\nRAG grounds LLM responses in your documents through three pipelines — **Ingestion**, **Query**, and **RAG** — orchestrated around a shared vector store.\n\n```mermaid\nflowchart LR\n    ChatUI_L[\"Chat UI\"]\n\n    subgraph IngestionFlow[\"Ingestion Pipeline\"]\n        D[\"Documents\"] --> EXT[\"Extraction\"] --> DC[\"Chunking\"] --> DE[\"Document\\nEmbedding\"] --> ING[\"Storage\"]\n    end\n\n    subgraph QueryFlow[\"Query Pipeline\"]\n        Q[\"Query\"] --> QE[\"Query\\nEmbedding\"] --> SS[\"Similarity\\nSearch\"]\n    end\n\n    subgraph RAGFlow[\"RAG Pipeline\"]\n        BF[\"beforeStream\\nHook\"] --> RET[\"Retrieval\"] --> AUG[\"Augmentation\"] --> AG[\"Agent\"] --> GEN[\"Generation\"]\n    end\n\n    EMB((\"Embedding\\nModel\"))\n    GEN_LLM((\"Generative\\nModel\"))\n    VS[(\"Vector\\nStore\")]\n    ChatUI_R[\"Chat UI\"]\n\n    ChatUI_L --> D\n    ChatUI_L --> Q\n\n    QE -.- EMB\n    DE -.- EMB\n\n    SS --> VS\n    ING --> VS\n\n    Q --> BF\n    VS --> RET\n    AG -.- GEN_LLM\n    GEN -.- GEN_LLM\n    GEN --> ChatUI_R\n```\n\n### Pipelines\n\n**Ingestion** — Documents are parsed into plain text via the built-in kreuzberg extraction engine (supporting PDF, DOCX, XLSX, PPTX, HTML, RTF, EPUB, and 76+ formats), split into overlapping chunks (~1000 chars, 200 char overlap), and stored with their embeddings in `data/index.json`. Embeddings are generated lazily on first search to keep uploads fast.\n\n**Query** — The user's query is embedded into the same vector space as the documents, then compared against all stored chunks using cosine similarity to find the top-*k* most relevant results.\n\n**RAG** — The `beforeStream` hook in the chat route intercepts each message before it reaches the agent. It searches the document store for relevant chunks, assembles them into context, and prepends them as a system message. The agent then generates a cited response streamed back to the user.\n\n## Structure\n\n```\nstore.ts                        Upload store config (embedding model, storage path)\nagents/rag.ts                   Q&A agent with citation instructions\ncontent/\n  getting-started.md            Sample document\n  architecture.md               Sample document\napp/\n  api/chat/route.ts             Chat API endpoint\n  api/uploads/route.ts           Upload (POST) and list (GET) uploads\n  api/uploads/[id]/route.ts     Delete upload\n  page.tsx                      Chat UI with document upload panel\n  layout.tsx                    Root layout with header\n```\n\n## Framework usage\n\n| What | Framework | Template code |\n|------|-----------|---------------|\n| Chat UI + streaming | `Chat`, `useChat` | `page.tsx` |\n| Upload management | `useUploads` hook | `page.tsx` |\n| Source display | `showSources` prop on `Chat` | `page.tsx` |\n| Upload API routes | `createUploadHandler` | 1-line per route file |\n| Chat API route | `createChatHandler` | 1 line in `route.ts` |\n| Agent definition | `agent()` | Config object in `agents/rag.ts` |\n| RAG retrieval | `beforeStream` hook | Context injection in `api/chat/route.ts` |\n| Vector store | `uploadStore()` | Config in `store.ts` |\n\n## Adding documents\n\n- Drop files into `content/` — they're indexed automatically on first search\n- Or use the upload panel in the UI for PDF, DOCX, XLSX, PPTX, CSV, HTML, RTF, EPUB, TXT, and MD files\n\n## Production notes\n\nThis is a starter template — not a production-ready setup. For production, consider:\n\n- **Vector store** — Replace the JSON store with pgvector, Pinecone, or Qdrant for datasets beyond ~10k chunks\n- **Reranking** — Add a cross-encoder reranker (e.g. Cohere Rerank) after retrieval to improve precision\n- **Hybrid search** — Combine dense vectors with BM25 keyword matching for better recall\n",
+                "app/api/uploads/route.ts": "import { createUploadHandler } from \"veryfront/embedding\";\nimport { store } from \"../../../store.ts\";\n\nexport const { POST, GET } = createUploadHandler(store);\n",
+                "app/api/uploads/[id]/route.ts": "import { createUploadHandler } from \"veryfront/embedding\";\nimport { store } from \"../../../../store.ts\";\n\nexport const { DELETE } = createUploadHandler(store);\n",
+                "app/api/chat/route.ts": "import { createChatHandler } from \"veryfront/agent\";\nimport { store } from \"../../../store.ts\";\n\nexport const POST = createChatHandler(\"rag\", {\n  beforeStream: async ({ lastUserText }) => {\n    const query = lastUserText.trim();\n    if (!query) return;\n\n    try {\n      await store.indexContentDir();\n      const results = await store.search(query, { topK: 5 });\n      if (results.length === 0) return;\n\n      const contextBlock = results\n        .map(\n          (result) =>\n            `[${result.title}] (score: ${\n              result.score.toFixed(2)\n            })\\n${result.text}`,\n        )\n        .join(\"\\n\\n---\\n\\n\");\n\n      return {\n        prepend: [\n          {\n            role: \"system\",\n            parts: [\n              {\n                type: \"text\",\n                text:\n                  `Here are relevant documents retrieved for the user's question:\\n\\n${contextBlock}\\n\\n` +\n                  \"Use these documents to answer. Cite the document title when referencing information.\",\n              },\n            ],\n          },\n        ],\n      };\n    } catch (e) {\n      console.error(\"[RAG] Retrieval failed:\", e);\n      return;\n    }\n  },\n});\n",
+                "app/layout.tsx": "import { Head } from \"veryfront/head\";\n\nexport default function RootLayout({ children }: { children: React.ReactNode }): React.ReactNode {\n  return (\n    <>\n      <Head><title>Docs Agent</title></Head>\n      <div className=\"flex flex-col h-screen\">\n        {children}\n      </div>\n    </>\n  );\n}\n",
+                "app/page.tsx": "'use client'\n\nimport { useState, useEffect, useCallback, useMemo } from 'react'\nimport { ChatWithSidebar, useChat, type QuickAction } from 'veryfront/chat'\n\nconst UPLOAD_API = '/api/uploads'\nconst ACCEPT = '.pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx,.csv,.txt,.md,.mdx,.html,.rtf,.epub,.json,.xml'\n\nconst QUICK_ACTIONS: QuickAction[] = [\n  { id: 'ask-question', label: 'Ask Question', prompt: 'I have a question about this document: ' },\n  { id: 'extract-insights', label: 'Extract Insights', prompt: 'Extract the key insights from the uploaded documents.' },\n  { id: 'find-sources', label: 'Find Sources', prompt: 'Find relevant sources and references in the documents for: ' },\n]\n\ninterface Doc { id: string; title: string; source: string }\n\nfunction useUploads(api: string) {\n  const [docs, setDocs] = useState<Doc[]>([])\n  const [uploading, setUploading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  const refresh = useCallback(async () => {\n    try {\n      const res = await fetch(api)\n      if (res.ok) {\n        const data = await res.json()\n        setDocs(Array.isArray(data) ? data : data.uploads ?? [])\n      }\n    } catch { /* ignore */ }\n  }, [api])\n\n  useEffect(() => { refresh() }, [refresh])\n\n  const upload = useCallback(async (file: File) => {\n    setUploading(true)\n    setError(null)\n    try {\n      const form = new FormData()\n      form.append('file', file)\n      const res = await fetch(api, { method: 'POST', body: form })\n      if (!res.ok) throw new Error(await res.text())\n      await refresh()\n    } catch (e) {\n      setError(e instanceof Error ? e.message : 'Upload failed')\n    } finally {\n      setUploading(false)\n    }\n  }, [api, refresh])\n\n  const remove = useCallback(async (id: string) => {\n    await fetch(`${api}/${id}`, { method: 'DELETE' })\n    await refresh()\n  }, [api, refresh])\n\n  const uploads = useMemo(\n    () => docs.filter((d) => d.source.startsWith('upload:')),\n    [docs],\n  )\n\n  return { uploads, uploading, error, upload, remove }\n}\n\nexport default function DocsChat() {\n  const chat = useChat({ api: '/api/chat' })\n  const docs = useUploads(UPLOAD_API)\n\n  const attachmentItems = useMemo(() => {\n    const items = docs.uploads.map((d) => ({\n      id: d.id,\n      name: d.title,\n      status: 'ready' as const,\n    }))\n    if (docs.uploading) {\n      items.push({ id: '__uploading', name: 'Uploading...', status: 'uploading' as const })\n    }\n    return items\n  }, [docs.uploads, docs.uploading])\n\n  const uploadFiles = useMemo(\n    () => docs.uploads.map((d) => ({ id: d.id, name: d.title })),\n    [docs.uploads],\n  )\n\n  const handleAttach = useCallback((files: FileList) => {\n    for (const file of Array.from(files)) {\n      docs.upload(file)\n    }\n  }, [docs.upload])\n\n  const handleQuickAction = useCallback((action: QuickAction) => {\n    if (action.prompt) chat.setInput(action.prompt)\n  }, [chat.setInput])\n\n  return (\n    <ChatWithSidebar\n      chat={chat}\n      sidebar={{ storageKey: 'rag-threads' }}\n      features={{ steps: true, tabs: true, sources: true, export: true }}\n      models={{\n        options: [\n          { value: 'anthropic/claude-sonnet-4-20250514', label: 'Claude Sonnet 4', provider: 'Anthropic' },\n          { value: 'openai/gpt-4o', label: 'GPT-4o', provider: 'OpenAI' },\n          { value: 'openai/gpt-4o-mini', label: 'GPT-4o Mini', provider: 'OpenAI', badge: 'Fast' },\n        ],\n      }}\n      attachments={{\n        uploads: uploadFiles,\n        onRemoveUpload: docs.remove,\n        onAttach: handleAttach,\n        accept: ACCEPT,\n        items: attachmentItems,\n        onRemoveItem: docs.remove,\n      }}\n      quickActions={{\n        actions: QUICK_ACTIONS,\n        onAction: handleQuickAction,\n      }}\n      message={{\n        renderTool: () => null,\n      }}\n      className=\"flex-1 min-h-0\"\n      placeholder=\"Ask anything about your documents...\"\n      emptyState={{ title: 'Docs Agent', description: 'Upload files and ask questions' }}\n    />\n  )\n}\n",
+                "tsconfig.json": "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"bundler\",\n    \"strict\": true,\n    \"jsx\": \"react-jsx\",\n    \"skipLibCheck\": true,\n    \"esModuleInterop\": true,\n    \"paths\": {\n      \"@/*\": [\"./*\"]\n    }\n  },\n  \"include\": [\"**/*.ts\", \"**/*.tsx\"],\n  \"exclude\": [\"node_modules\"]\n}\n",
+                "store.ts": "import { uploadStore } from \"veryfront/embedding\";\n\nexport const store = uploadStore({\n  model: \"openai/text-embedding-3-small\",\n  storagePath: \"data/index.json\",\n  contentDir: \"content\",\n});\n",
+                "agents/rag.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"rag\",\n  model: \"local/qwen3-1.7b\",\n  system:\n    `You answer questions using the provided documents. ` +\n    `Always cite your sources by referencing the document title. ` +\n    `If the search results don't contain a clear answer, say so honestly.`,\n});\n",
+                "content/getting-started.md": "# Getting Started\n\nWelcome to Acme Platform. This guide covers initial setup and core concepts.\n\n## Installation\n\nInstall the CLI globally:\n\n```bash\nnpm install -g @acme/cli\n```\n\n## Creating a Project\n\nRun the init command to scaffold a new project:\n\n```bash\nacme init my-project\ncd my-project\n```\n\n## Project Structure\n\n- `src/` — Application source code\n- `config/` — Configuration files\n- `tests/` — Test suite\n- `docs/` — Documentation\n\n## Configuration\n\nCreate an `acme.config.ts` file in your project root:\n\n```ts\nexport default {\n  name: \"my-project\",\n  region: \"us-east-1\",\n  features: [\"auth\", \"storage\"],\n};\n```\n\n## Next Steps\n\n- Read the [Architecture Guide](./architecture) to understand the system design\n- Check [API Reference](./api-reference) for available endpoints\n- Join our Discord community for support\n",
+                "content/architecture.md": "# Architecture\n\nAcme Platform uses a modular, event-driven architecture.\n\n## Core Components\n\n### API Gateway\nRoutes incoming requests to the appropriate microservice. Handles authentication, rate limiting, and request validation.\n\n### Event Bus\nAsynchronous message broker connecting all services. Supports pub/sub and point-to-point messaging patterns.\n\n### Data Layer\nMulti-tenant data storage with automatic sharding. Supports PostgreSQL for relational data and Redis for caching.\n\n## Request Flow\n\n1. Client sends request to API Gateway\n2. Gateway validates authentication token\n3. Request is routed to the target service\n4. Service processes request and publishes events\n5. Response is returned through the gateway\n\n## Scaling\n\nEach component scales independently. The API Gateway uses horizontal scaling with load balancing. Services auto-scale based on queue depth and CPU utilization.\n\n## Security\n\n- All inter-service communication uses mTLS\n- API tokens are rotated every 24 hours\n- Data at rest is encrypted with AES-256\n- Audit logs are retained for 90 days\n"
+            }
+        },
         "minimal": {
             "files": {
                 "README.md": "# Minimal\n\nA barebones starter with just pages and routing — no agents, no tools.\n\n## What's included\n\n- Home page with welcome message\n- About page using MDX\n- Tailwind CSS styling with dark mode\n\n## Structure\n\n```\napp/\n  layout.tsx        Root layout\n  page.tsx          Home page\n  about/page.mdx    Markdown content page\n```\n\nThis is a starter template to give you a good starting point — not a production-ready setup.\n",

package/esm/cli/templates/types.d.ts

@@ -7,7 +7,7 @@ export interface TemplateFile {
 export interface TemplateConfig {
     envVars?: EnvVarConfig[];
 }
-export type TemplateName = "ai-agent" | "chat-with-your-docs" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | "minimal" | "pages-router" | "app-router";
+export type TemplateName = "ai-agent" | "docs-agent" | "multi-agent-system" | "agentic-workflow" | "coding-agent" | "saas-starter" | "minimal" | "pages-router" | "app-router";
 export type FeatureName = "ai" | "auth" | "workflows" | "mdx" | "redis" | "blob";
 export interface FeatureConfig {
     name: FeatureName;

package/esm/cli/templates/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,SAAS,GACT,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,SAAS,GACT,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/esm/deno.d.ts

@@ -29,6 +29,7 @@ declare namespace _default {
         "./fs": string;
         "./integrations": string;
         "./sandbox": string;
+        "./embedding": string;
         "./cli": string;
     };
     let imports: {
@@ -48,6 +49,7 @@ declare namespace _default {
         "veryfront/react/components/ai": string;
         "veryfront/components/ai": string;
         "veryfront/sandbox": string;
+        "veryfront/embedding": string;
         "veryfront/agent/react": string;
         "veryfront/agent/testing": string;
         "veryfront/agent/middleware": string;
@@ -229,7 +231,6 @@ declare namespace _default {
         "@ai-sdk/openai": string;
         "@ai-sdk/anthropic": string;
         "@ai-sdk/google": string;
-        "@anthropic-ai/claude-agent-sdk": string;
         tailwindcss: string;
         "tailwindcss/plugin": string;
         "tailwindcss/defaultTheme": string;
@@ -247,7 +248,10 @@ declare namespace _default {
         "@babel/traverse": string;
         "@babel/generator": string;
         "@babel/types": string;
-        "@huggingface/transformers": string;
+        "class-variance-authority": string;
+        clsx: string;
+        "tailwind-merge": string;
+        "@kreuzberg/wasm": string;
     };
     namespace compilerOptions {
         let jsx: string;
@@ -265,6 +269,7 @@ declare namespace _default {
         proxy: string;
         dev: string;
         production: string;
+        "build:prepare": string;
         build: string;
         "build:npm": string;
         release: string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.46",
+    "version": "0.1.48",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [
@@ -39,6 +39,7 @@ export default {
         "./fs": "./src/fs/index.ts",
         "./integrations": "./src/integrations/index.ts",
         "./sandbox": "./src/sandbox/index.ts",
+        "./embedding": "./src/embedding/index.ts",
         "./cli": "./cli/main.ts"
     },
     "imports": {
@@ -58,6 +59,7 @@ export default {
         "veryfront/react/components/ai": "./src/react/components/ai/index.ts",
         "veryfront/components/ai": "./src/react/components/ai/index.ts",
         "veryfront/sandbox": "./src/sandbox/index.ts",
+        "veryfront/embedding": "./src/embedding/index.ts",
         "veryfront/agent/react": "./src/agent/react/index.ts",
         "veryfront/agent/testing": "./src/agent/testing/index.ts",
         "veryfront/agent/middleware": "./src/agent/middleware/index.ts",
@@ -239,7 +241,6 @@ export default {
         "@ai-sdk/openai": "npm:@ai-sdk/openai@3.0.28",
         "@ai-sdk/anthropic": "npm:@ai-sdk/anthropic@3.0.43",
         "@ai-sdk/google": "npm:@ai-sdk/google@3.0.29",
-        "@anthropic-ai/claude-agent-sdk": "npm:@anthropic-ai/claude-agent-sdk@0.2.37",
         "tailwindcss": "https://esm.sh/tailwindcss@4.1.8",
         "tailwindcss/plugin": "https://esm.sh/tailwindcss@4.1.8/plugin",
         "tailwindcss/defaultTheme": "https://esm.sh/tailwindcss@4.1.8/defaultTheme",
@@ -257,7 +258,10 @@ export default {
         "@babel/traverse": "npm:@babel/traverse@7.26.3",
         "@babel/generator": "npm:@babel/generator@7.26.3",
         "@babel/types": "npm:@babel/types@7.26.3",
-        "@huggingface/transformers": "npm:@huggingface/transformers@3.4.2"
+        "class-variance-authority": "npm:class-variance-authority@0.7.1",
+        "clsx": "npm:clsx@2.1.1",
+        "tailwind-merge": "npm:tailwind-merge@2.6.0",
+        "@kreuzberg/wasm": "npm:@kreuzberg/wasm@4.4.2"
     },
     "compilerOptions": {
         "jsx": "react-jsx",
@@ -278,12 +282,13 @@ export default {
     },
     "tasks": {
         "setup": "deno run --allow-all scripts/setup.ts",
-        "start": "deno run --allow-all cli/main.ts",
+        "start": "deno run -A scripts/build/generate-templates-manifest.ts && deno run --allow-all cli/main.ts",
         "start:headless": "deno run --allow-all cli/main.ts --headless",
         "proxy": "deno run --allow-all cli/main.ts serve --mode=proxy",
-        "dev": "deno run --allow-all cli/main.ts dev",
+        "dev": "deno run -A scripts/build/generate-templates-manifest.ts && deno run --allow-all cli/main.ts dev",
         "production": "deno run --allow-all cli/main.ts serve --mode=production",
-        "build": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prepare-framework-sources.ts && deno run -A scripts/build/prebundle-client-scripts.ts && deno run -A scripts/build/prebundle-bridge.ts && deno compile --allow-all --include src/platform/polyfills --include src/proxy/main.ts --include dist/framework-src --output ./bin/veryfront cli/main.ts",
+        "build:prepare": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/generate-templates-manifest.ts && deno run -A scripts/build/generate-dev-ui-manifest.ts && deno run -A scripts/build/prepare-framework-sources.ts && deno run -A scripts/build/prebundle-client-scripts.ts && deno run -A scripts/build/prebundle-bridge.ts",
+        "build": "deno task build:prepare && deno compile --allow-all --include src/platform/polyfills --include src/proxy/main.ts --include dist/framework-src --output ./bin/veryfront cli/main.ts",
         "build:npm": "deno run -A scripts/build/generate-integrations-module.ts && deno run -A scripts/build/build-npm-dnt.ts",
         "release": "deno run -A scripts/release.ts",
         "test": "VF_DISABLE_LRU_INTERVAL=1 SSR_TRANSFORM_PER_PROJECT_LIMIT=0 REVALIDATION_PER_PROJECT_LIMIT=0 NODE_ENV=production LOG_FORMAT=text deno test --no-check --parallel --allow-all '--ignore=tests/e2e,tests/integration/compiled-binary-e2e.test.ts' --unstable-worker-options --unstable-net",
@@ -391,7 +396,7 @@ export default {
     "allowScripts": {
         "allow": [
             "npm:sharp@0.33.5",
-            "npm:onnxruntime-node@1.20.1"
+            "npm:onnxruntime-node@1.21.0"
         ],
         "deny": [
             "npm:esbuild@0.20.2",

package/esm/src/agent/chat-handler.d.ts

@@ -1,8 +1,30 @@
 import * as dntShim from "../../_dnt.shims.js";
+import type { Message } from "./types.js";
+export type ChatHandlerMessageInput = Omit<Message, "id"> & {
+    id?: string;
+};
+export interface ChatHandlerBeforeStreamContext {
+    request: dntShim.Request;
+    messages: Message[];
+    context: Record<string, unknown>;
+    lastUserText: string;
+}
+export interface ChatHandlerBeforeStreamResult {
+    prepend?: ChatHandlerMessageInput[];
+    append?: ChatHandlerMessageInput[];
+    replaceMessages?: ChatHandlerMessageInput[];
+    context?: Record<string, unknown>;
+}
+export type ChatHandlerBeforeStream = (input: ChatHandlerBeforeStreamContext) => void | dntShim.Response | ChatHandlerBeforeStreamResult | Promise<void | dntShim.Response | ChatHandlerBeforeStreamResult>;
 /** Options for `createChatHandler` — customize the context passed to the agent. */
 export interface ChatHandlerOptions {
     /** Override context passed to agent.stream(). Default: `{ userId: "current-user" }` */
     context?: Record<string, unknown> | ((request: dntShim.Request) => Record<string, unknown> | Promise<Record<string, unknown>>);
+    /**
+     * Hook to customize validated messages/context right before `agent.stream()`.
+     * Return `Response` to short-circuit (e.g. auth/rate limit).
+     */
+    beforeStream?: ChatHandlerBeforeStream;
 }
 /**
  * Create a POST handler for a chat API route.

package/esm/src/agent/chat-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AA4H/C,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpE;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,IAGD,cAAc,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA0EzE"}
+{"version":3,"file":"chat-handler.d.ts","sourceRoot":"","sources":["../../../src/src/agent/chat-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAG/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAuK1C,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,8BAA8B,KAEnC,IAAI,GACJ,OAAO,CAAC,QAAQ,GAChB,6BAA6B,GAC7B,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,6BAA6B,CAAC,CAAC;AAiCrE,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,CACD,OAAO,EAAE,OAAO,CAAC,OAAO,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE;;;OAGG;IACH,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,IAGD,cAAc,GAAG,KAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CA6FzE"}