npm - veryfront - Versions diffs - 0.1.49 → 0.1.51 - Mend

veryfront 0.1.49 → 0.1.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1571) hide show

package/src/cli/templates/manifest.js CHANGED Viewed

@@ -9,8 +9,8 @@ export default {
         "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>AI Workflows</title>\n      </Head>\n      {children}\n    </>\n  );\n}\n",
         "app/page.tsx": "'use client'\n\nimport { useState } from 'react'\nimport { useWorkflowStart, useWorkflowList } from 'veryfront/workflow'\n\nconst STATUS_STYLES: Record<string, string> = {\n  running: 'bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400',\n  completed: 'bg-emerald-100 text-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-400',\n  waiting_for_approval: 'bg-amber-100 text-amber-700 dark:bg-amber-900/30 dark:text-amber-400',\n  failed: 'bg-red-100 text-red-700 dark:bg-red-900/30 dark:text-red-400',\n  pending: 'bg-neutral-100 text-neutral-600 dark:bg-neutral-800 dark:text-neutral-400',\n}\n\nexport default function WorkflowDashboard(): JSX.Element {\n  const [topic, setTopic] = useState('')\n  const { start, isStarting } = useWorkflowStart({ workflowId: 'content-pipeline' })\n  const { runs, isLoading } = useWorkflowList()\n\n  async function handleStart(e: React.FormEvent) {\n    e.preventDefault()\n    if (!topic.trim()) return\n    await start({ topic: topic.trim() })\n    setTopic('')\n  }\n\n  return (\n    <div className=\"min-h-screen bg-neutral-50 dark:bg-neutral-950\">\n      <div className=\"max-w-2xl mx-auto px-4 py-12\">\n        <div className=\"mb-10\">\n          <h1 className=\"text-2xl font-bold text-neutral-900 dark:text-white\">Content Pipeline</h1>\n          <p className=\"mt-1 text-neutral-500 dark:text-neutral-400\">Research &rarr; Write &rarr; Review &rarr; Publish</p>\n        </div>\n\n        {/* Start new workflow */}\n        <form onSubmit={handleStart} className=\"mb-10\">\n          <div className=\"flex gap-3\">\n            <input\n              type=\"text\"\n              value={topic}\n              onChange={(e) => setTopic(e.target.value)}\n              placeholder=\"Enter a topic to research and write about...\"\n              className=\"flex-1 px-4 py-2.5 bg-white dark:bg-neutral-900 border border-neutral-200 dark:border-neutral-800 rounded-xl text-neutral-900 dark:text-white placeholder-neutral-400 focus:outline-none focus:ring-2 focus:ring-blue-500/30 focus:border-blue-500\"\n            />\n            <button\n              type=\"submit\"\n              disabled={isStarting || !topic.trim()}\n              className=\"px-5 py-2.5 bg-blue-500 text-white font-medium rounded-xl hover:bg-blue-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors\"\n            >\n              {isStarting ? 'Starting...' : 'Start'}\n            </button>\n          </div>\n        </form>\n\n        {/* Workflow runs */}\n        <div>\n          <h2 className=\"text-sm font-medium text-neutral-500 dark:text-neutral-400 uppercase tracking-wider mb-4\">Recent Runs</h2>\n\n          {isLoading ? (\n            <p className=\"text-neutral-400 text-sm py-8 text-center\">Loading...</p>\n          ) : runs.length === 0 ? (\n            <div className=\"text-center py-12 bg-white dark:bg-neutral-900 rounded-2xl border border-neutral-200 dark:border-neutral-800\">\n              <p className=\"text-neutral-500 dark:text-neutral-400\">No workflows yet. Start one above.</p>\n            </div>\n          ) : (\n            <div className=\"space-y-3\">\n              {runs.map((wf) => (\n                <a\n                  key={wf.id}\n                  href={`/workflows/${wf.id}`}\n                  className=\"block bg-white dark:bg-neutral-900 border border-neutral-200 dark:border-neutral-800 rounded-xl p-4 hover:border-neutral-300 dark:hover:border-neutral-700 transition-colors\"\n                >\n                  <div className=\"flex items-center justify-between\">\n                    <div>\n                      <p className=\"font-medium text-neutral-900 dark:text-white text-sm\">{wf.input?.topic || 'Untitled'}</p>\n                      <p className=\"text-xs text-neutral-500 mt-1\">{new Date(wf.createdAt).toLocaleString()}</p>\n                    </div>\n                    <span className={`px-2.5 py-1 rounded-full text-xs font-medium ${STATUS_STYLES[wf.status] || STATUS_STYLES.pending}`}>\n                      {wf.status.replace(/_/g, ' ')}\n                    </span>\n                  </div>\n                </a>\n              ))}\n            </div>\n          )}\n        </div>\n      </div>\n    </div>\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",
-        "agents/researcher.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"researcher\",\n  model: \"openai/gpt-4o\",\n  system:\n    \"You research topics thoroughly and return structured findings. \" +\n    \"Present results as clear bullet points with key facts, data, and sources.\",\n  maxSteps: 3,\n});\n",
-        "agents/writer.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"writer\",\n  model: \"openai/gpt-4o\",\n  system:\n    \"You transform research notes into polished, publication-ready content. \" +\n    \"Use a professional but approachable tone.\",\n  maxSteps: 3,\n});\n"
+        "agents/researcher.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"researcher\",\n  system:\n    \"You research topics thoroughly and return structured findings. \" +\n    \"Present results as clear bullet points with key facts, data, and sources.\",\n  maxSteps: 3,\n});\n",
+        "agents/writer.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"writer\",\n  system:\n    \"You transform research notes into polished, publication-ready content. \" +\n    \"Use a professional but approachable tone.\",\n  maxSteps: 3,\n});\n"
       }
     },
     "saas-starter": {
@@ -22,7 +22,7 @@ export default {
         "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>AI SaaS</title>\n      </Head>\n      <div className=\"antialiased\">\n        {children}\n      </div>\n    </>\n  );\n}\n",
         "app/page.tsx": "export default function LandingPage(): JSX.Element {\n  return (\n    <div className=\"min-h-screen bg-white dark:bg-neutral-950\">\n      {/* Nav */}\n      <nav className=\"border-b border-neutral-100 dark:border-neutral-900\">\n        <div className=\"max-w-5xl mx-auto flex items-center justify-between px-6 h-14\">\n          <span className=\"font-semibold text-neutral-900 dark:text-white\">\n            AI SaaS\n          </span>\n          <div className=\"flex items-center gap-4\">\n            <a\n              href=\"/login\"\n              className=\"text-sm text-neutral-600 dark:text-neutral-400 hover:text-neutral-900 dark:hover:text-white transition-colors\"\n            >\n              Sign in\n            </a>\n            <a\n              href=\"/login\"\n              className=\"text-sm px-4 py-1.5 bg-neutral-900 dark:bg-white text-white dark:text-neutral-900 rounded-full font-medium hover:opacity-90 transition-opacity\"\n            >\n              Get started\n            </a>\n          </div>\n        </div>\n      </nav>\n\n      {/* Hero */}\n      <main className=\"max-w-5xl mx-auto px-6\">\n        <div className=\"pt-24 pb-16 text-center\">\n          <h1 className=\"text-4xl md:text-5xl font-bold tracking-tight text-neutral-900 dark:text-white\">\n            Your AI-powered platform\n          </h1>\n          <p className=\"mt-4 text-lg text-neutral-500 dark:text-neutral-400 max-w-lg mx-auto\">\n            Built with Veryfront. Agents, tools, and memory — ready for\n            production.\n          </p>\n          <div className=\"mt-8 flex gap-3 justify-center\">\n            <a\n              href=\"/login\"\n              className=\"px-6 py-2.5 bg-neutral-900 dark:bg-white text-white dark:text-neutral-900 rounded-full font-medium hover:opacity-90 transition-opacity\"\n            >\n              Start free\n            </a>\n            <a\n              href=\"https://veryfront.com/code/guides\"\n              className=\"px-6 py-2.5 border border-neutral-200 dark:border-neutral-800 text-neutral-700 dark:text-neutral-300 rounded-full font-medium hover:bg-neutral-50 dark:hover:bg-neutral-900 transition-colors\"\n            >\n              Documentation\n            </a>\n          </div>\n        </div>\n\n        {/* Features */}\n        <div className=\"grid grid-cols-1 md:grid-cols-3 gap-6 py-16 border-t border-neutral-100 dark:border-neutral-900\">\n          {[\n            {\n              title: \"AI Agents\",\n              desc: \"Define agents with tools, memory, and streaming — auto-discovered from your project.\",\n            },\n            {\n              title: \"Per-User Memory\",\n              desc: \"Each user gets their own conversation history, persisted across sessions.\",\n            },\n            {\n              title: \"Production Ready\",\n              desc: \"Auth, rate limiting, and deploy — ship to production with one command.\",\n            },\n          ].map(({ title, desc }) => (\n            <div key={title}>\n              <h3 className=\"font-medium text-neutral-900 dark:text-white\">\n                {title}\n              </h3>\n              <p className=\"mt-1 text-sm text-neutral-500 dark:text-neutral-400\">\n                {desc}\n              </p>\n            </div>\n          ))}\n        </div>\n      </main>\n    </div>\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",
-        "agents/assistant.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"assistant\",\n  model: \"openai/gpt-4o\",\n  system: \"You are a helpful AI assistant. Be concise and direct.\",\n  tools: true,\n  memory: { type: \"conversation\", maxMessages: 50 },\n  maxSteps: 10,\n});\n",
+        "agents/assistant.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"assistant\",\n  system: \"You are a helpful AI assistant. Be concise and direct.\",\n  tools: true,\n  memory: { type: \"conversation\", maxMessages: 50 },\n  maxSteps: 10,\n});\n",
         "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"
       }
     },
@@ -33,21 +33,21 @@ export default {
         "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>AI Chat</title>\n      </Head>\n      <div className=\"flex flex-col h-screen bg-white dark:bg-neutral-900\">\n        {children}\n      </div>\n    </>\n  );\n}\n",
         "app/page.tsx": "'use client'\n\nimport { Chat, useChat } from 'veryfront/chat'\n\nexport default function ChatPage(): JSX.Element {\n  const chat = useChat({ api: '/api/chat' })\n\n  return <Chat {...chat} className=\"flex-1 min-h-0\" placeholder=\"Message\" />\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/assistant.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"assistant\",\n  model: \"openai/gpt-4o\",\n  system: \"You are a helpful assistant. Answer questions clearly and concisely.\",\n  tools: true,\n  maxSteps: 10,\n});\n",
+        "agents/assistant.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"assistant\",\n  system: \"You are a helpful assistant. Answer questions clearly and concisely.\",\n  tools: true,\n  maxSteps: 10,\n});\n",
         "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",
+        "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 with convention-based model selection\n- Document upload supporting PDF, DOCX, XLSX, PPTX, CSV, HTML, RTF, EPUB, TXT, and Markdown\n- `ragStore()` with local JSON storage by default, and Veryfront Cloud RAG when bootstrap is present\n- Original uploaded files stored in Veryfront Cloud project uploads when cloud bootstrap is present\n- Sample content in `/content` directory auto-indexed on first search\n\n## Getting started\n\n1. Set your Veryfront Cloud bootstrap vars:\n\n   ```bash\n   export VERYFRONT_API_TOKEN=vf_...\n   export VERYFRONT_PROJECT_SLUG=my-project\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\nIf you are using a self-hosted Veryfront API, also set `VERYFRONT_API_URL`.\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 in the default `ragStore()`. In local mode that means `data/index.json`; with Veryfront Cloud bootstrap it upgrades to the cloud RAG backend automatically. The original uploaded binary is also stored in the project's Veryfront Cloud uploads store so remote projects retain the source file, not just the extracted text. 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                        RAG store config\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 | `ragStore()` | 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 default 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",
+        "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; url?: 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, url: d.url })),\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          {\n            value: 'veryfront-cloud/anthropic/claude-sonnet-4-6',\n            label: 'Claude Sonnet',\n            provider: 'Veryfront Cloud',\n          },\n          {\n            value: 'veryfront-cloud/openai/gpt-5.2',\n            label: 'GPT-5.2',\n            provider: 'Veryfront Cloud',\n          },\n          {\n            value: 'veryfront-cloud/google/gemini-2.5-flash',\n            label: 'Gemini 2.5 Flash',\n            provider: 'Veryfront Cloud',\n            badge: 'Fast',\n          },\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",
+        "store.ts": "import { ragStore } from \"veryfront/embedding\";\n\nexport const store = ragStore({\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  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"
       }
@@ -67,9 +67,9 @@ export default {
         "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>Multi-Agent System</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=\"flex -space-x-2\">\n              <div className=\"w-7 h-7 rounded-full bg-blue-500 ring-2 ring-white dark:ring-neutral-950 flex items-center justify-center text-[10px] font-bold text-white\">\n                O\n              </div>\n              <div className=\"w-7 h-7 rounded-full bg-amber-500 ring-2 ring-white dark:ring-neutral-950 flex items-center justify-center text-[10px] font-bold text-white\">\n                R\n              </div>\n              <div className=\"w-7 h-7 rounded-full bg-violet-500 ring-2 ring-white dark:ring-neutral-950 flex items-center justify-center text-[10px] font-bold text-white\">\n                W\n              </div>\n            </div>\n            <div>\n              <h1 className=\"font-medium text-neutral-900 dark:text-white text-sm\">\n                Agent Team\n              </h1>\n              <p className=\"text-xs text-neutral-500 dark:text-neutral-400\">\n                Orchestrator, Researcher, Writer\n              </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 MultiAgentChat(): JSX.Element {\n  const chat = useChat({ api: '/api/chat' })\n\n  return <Chat {...chat} className=\"flex-1 min-h-0\" placeholder=\"Give the team a task...\" />\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/researcher.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"researcher\",\n  model: \"openai/gpt-4o\",\n  system:\n    \"You are a research specialist. \" +\n    \"Gather comprehensive information on the given topic. \" +\n    \"Present findings as structured bullet points with key facts and data.\",\n  tools: true,\n  maxSteps: 5,\n});\n",
-        "agents/writer.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"writer\",\n  model: \"openai/gpt-4o\",\n  system:\n    \"You are a writing specialist. \" +\n    \"Take research notes and transform them into clear, engaging prose. \" +\n    \"Use a professional but approachable tone.\",\n  maxSteps: 3,\n});\n",
-        "agents/orchestrator.ts": "import { agent, getAgentsAsTools } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"orchestrator\",\n  model: \"openai/gpt-4o\",\n  system:\n    \"You coordinate a team of AI agents. \" +\n    \"Delegate research tasks to the researcher and writing tasks to the writer. \" +\n    \"Combine their outputs into a polished response.\",\n  tools: getAgentsAsTools([\"researcher\", \"writer\"]),\n  maxSteps: 10,\n});\n",
+        "agents/researcher.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"researcher\",\n  system:\n    \"You are a research specialist. \" +\n    \"Gather comprehensive information on the given topic. \" +\n    \"Present findings as structured bullet points with key facts and data.\",\n  tools: true,\n  maxSteps: 5,\n});\n",
+        "agents/writer.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"writer\",\n  system:\n    \"You are a writing specialist. \" +\n    \"Take research notes and transform them into clear, engaging prose. \" +\n    \"Use a professional but approachable tone.\",\n  maxSteps: 3,\n});\n",
+        "agents/orchestrator.ts": "import { agent, getAgentsAsTools } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"orchestrator\",\n  system:\n    \"You coordinate a team of AI agents. \" +\n    \"Delegate research tasks to the researcher and writing tasks to the writer. \" +\n    \"Combine their outputs into a polished response.\",\n  tools: getAgentsAsTools([\"researcher\", \"writer\"]),\n  maxSteps: 10,\n});\n",
         "tools/web-search.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\n\nexport default tool({\n  id: \"web-search\",\n  description: \"Search the web for information on a topic\",\n  inputSchema: z.object({\n    query: z.string().describe(\"Search query\"),\n  }),\n  execute: async ({ query: _query }) => {\n    // Connect a real search API to use this tool.\n    // Popular options: Tavily, SerpAPI, Brave Search\n    throw new Error(\n      \"No search API configured. \" +\n        \"See https://veryfront.com/code/guides/tools for setup instructions.\",\n    );\n  },\n});\n"
       }
     },
@@ -80,7 +80,7 @@ export default {
         "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>Code Agent</title>\n      </Head>\n      <div className=\"dark\">\n        <div className=\"flex flex-col h-screen bg-neutral-950\">\n          <header className=\"flex-shrink-0 border-b border-neutral-800\">\n            <div className=\"max-w-4xl 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\n                  className=\"w-4 h-4 text-emerald-400\"\n                  fill=\"none\"\n                  viewBox=\"0 0 24 24\"\n                  stroke=\"currentColor\"\n                  strokeWidth={2}\n                >\n                  <path\n                    strokeLinecap=\"round\"\n                    strokeLinejoin=\"round\"\n                    d=\"M17.25 6.75L22.5 12l-5.25 5.25m-10.5 0L1.5 12l5.25-5.25m7.5-3l-4.5 16.5\"\n                  />\n                </svg>\n              </div>\n              <div>\n                <h1 className=\"font-medium text-white text-sm font-mono\">\n                  code-agent\n                </h1>\n                <p className=\"text-xs text-neutral-500\">\n                  read, search, edit project files\n                </p>\n              </div>\n              <div className=\"ml-auto flex items-center gap-1.5\">\n                <span className=\"w-2 h-2 rounded-full bg-emerald-400 animate-pulse\" />\n                <span className=\"text-xs text-neutral-500 font-mono\">ready</span>\n              </div>\n            </div>\n          </header>\n          {children}\n        </div>\n      </div>\n    </>\n  );\n}\n",
         "app/page.tsx": "'use client'\n\nimport { Chat, useChat } from 'veryfront/chat'\n\nexport default function CodeAgent(): JSX.Element {\n  const chat = useChat({ api: '/api/chat' })\n\n  return (\n    <Chat\n      {...chat}\n      className=\"flex-1 min-h-0\"\n      placeholder=\"Describe what you want to build or fix...\"\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",
-        "agents/coder.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"coder\",\n  model: \"openai/gpt-4o\",\n  system: `You are an expert coding assistant. You can read, search, and modify code files in the project.\n\nWhen asked to make changes:\n1. First read the relevant files to understand the codebase\n2. Explain what you'll change and why\n3. Make the changes\n4. Verify the result\n\nAlways explain your reasoning before making edits.`,\n  tools: true,\n  maxSteps: 15,\n});\n",
+        "agents/coder.ts": "import { agent } from \"veryfront/agent\";\n\nexport default agent({\n  id: \"coder\",\n  system: `You are an expert coding assistant. You can read, search, and modify code files in the project.\n\nWhen asked to make changes:\n1. First read the relevant files to understand the codebase\n2. Explain what you'll change and why\n3. Make the changes\n4. Verify the result\n\nAlways explain your reasoning before making edits.`,\n  tools: true,\n  maxSteps: 15,\n});\n",
         "tools/list-files.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\nimport { readDir, resolve, cwd } from \"veryfront/fs\";\n\nexport default tool({\n  id: \"list-files\",\n  description: \"List files in a project directory\",\n  inputSchema: z.object({\n    directory: z\n      .string()\n      .default(\".\")\n      .describe(\"Directory path relative to project root\"),\n    extensions: z\n      .array(z.string())\n      .optional()\n      .describe(\"Filter by file extensions (e.g. ['.ts', '.tsx'])\"),\n  }),\n  execute: async ({ directory, extensions }) => {\n    const absolute = resolve(cwd(), directory);\n    const entries = await readDir(absolute);\n\n    let files = entries\n      .filter((e) => e.isFile)\n      .map((e) => e.name);\n\n    if (extensions?.length) {\n      files = files.filter((f) =>\n        extensions.some((ext) => f.endsWith(ext))\n      );\n    }\n\n    return { directory, files, count: files.length };\n  },\n});\n",
         "tools/edit-file.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\nimport { readTextFile, writeTextFile, resolve, cwd } from \"veryfront/fs\";\n\nexport default tool({\n  id: \"edit-file\",\n  description: \"Edit a file by replacing a specific string with new content\",\n  inputSchema: z.object({\n    path: z.string().describe(\"File path relative to the project root\"),\n    search: z.string().describe(\"Exact string to find in the file\"),\n    replace: z.string().describe(\"String to replace it with\"),\n  }),\n  execute: async ({ path, search, replace }) => {\n    const absolute = resolve(cwd(), path);\n\n    let content: string;\n    try {\n      content = await readTextFile(absolute);\n    } catch {\n      return { error: `File not found: ${path}` };\n    }\n\n    if (!content.includes(search)) {\n      return { error: \"Search string not found in file\" };\n    }\n\n    const updated = content.replace(search, replace);\n    await writeTextFile(absolute, updated);\n    return { path, success: true };\n  },\n});\n",
         "tools/read-file.ts": "import { tool } from \"veryfront/tool\";\nimport { z } from \"zod\";\nimport { readTextFile, resolve, cwd } from \"veryfront/fs\";\n\nexport default tool({\n  id: \"read-file\",\n  description: \"Read the contents of a file in the project\",\n  inputSchema: z.object({\n    path: z.string().describe(\"File path relative to the project root\"),\n  }),\n  execute: async ({ path }) => {\n    try {\n      const absolute = resolve(cwd(), path);\n      const content = await readTextFile(absolute);\n      return { path, content };\n    } catch {\n      return { error: `File not found: ${path}` };\n    }\n  },\n});\n"

package/src/cli/ui/ansi.ts CHANGED Viewed

@@ -77,7 +77,7 @@ export function bg16(color: number): string {
   return `${CSI}${40 + color}m`;
 }
-// deno-lint-ignore no-control-regex
+// deno-lint-ignore no-control-regex -- intentional: matches ANSI escape sequences for terminal color stripping
 export const ANSI_REGEX = /\x1b\[[0-9;]*m/g;
 export function stripAnsi(text: string): string {

package/src/deno.js CHANGED Viewed

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/agent/ai-defaults.ts CHANGED Viewed

@@ -1,72 +1,12 @@
 export const AGENT_DEFAULTS = {
-  maxTokens: 4096,
+  maxTokens: 4_096,
   temperature: 0.7,
   maxSteps: 20,
   memoryType: "conversation",
-  memoryMaxTokens: 4000,
+  memoryMaxTokens: 4_000,
 } as const;
 export const STREAMING_DEFAULTS = {
-  maxBufferSize: 1024 * 1024,
-  chunkSize: 16384,
-} as const;
-export const MEMORY_DEFAULTS = {
-  bufferSize: 10,
-  summaryThreshold: 20,
-  redisTtl: 86400,
-  redisKeyPrefix: "veryfront:agent:memory:",
-} as const;
-export const RATE_LIMIT_DEFAULTS = {
-  requestsPerMinute: 60,
-  tokensPerMinute: 100000,
-  windowMs: 60000,
-} as const;
-export const COST_TRACKING_DEFAULTS = {
-  dailyBudget: 100,
-  monthlyBudget: 1000,
-  warningThreshold: 0.8,
-} as const;
-export const RETRY_DEFAULTS = {
-  maxAttempts: 3,
-  initialDelayMs: 1000,
-  maxDelayMs: 30000,
-  backoffMultiplier: 2,
-} as const;
-export const WORKFLOW_DEFAULTS = {
-  timeoutMs: 300000,
-  maxParallel: 10,
-  checkpointIntervalMs: 5000,
-  approvalTimeoutMs: 86400000,
-} as const;
-export const PROVIDER_DEFAULTS = {
-  models: {
-    openai: "gpt-4o",
-    anthropic: "claude-sonnet-4-20250514",
-    google: "gemini-1.5-pro",
-  },
-  requestTimeoutMs: 120000,
-} as const;
-export const SECURITY_DEFAULTS = {
-  maxInputLength: 100000,
-  maxOutputLength: 100000,
-  redactPii: false,
-} as const;
-export const AI_DEFAULTS = {
-  agent: AGENT_DEFAULTS,
-  streaming: STREAMING_DEFAULTS,
-  memory: MEMORY_DEFAULTS,
-  rateLimit: RATE_LIMIT_DEFAULTS,
-  costTracking: COST_TRACKING_DEFAULTS,
-  retry: RETRY_DEFAULTS,
-  workflow: WORKFLOW_DEFAULTS,
-  provider: PROVIDER_DEFAULTS,
-  security: SECURITY_DEFAULTS,
+  maxBufferSize: 1_024 * 1_024, // 1 MB
+  chunkSize: 16_384,
 } as const;

package/src/src/agent/chat-handler.ts CHANGED Viewed

@@ -3,7 +3,14 @@ import { z } from "zod";
 import { getAgent } from "./composition/index.js";
 import type { Message } from "./types.js";
 import { fromError } from "../errors/veryfront-error.js";
+import { INVALID_ARGUMENT } from "../errors/index.js";
 import { DEFAULT_LOCAL_MODEL } from "../provider/local/model-catalog.js";
+import { agentLogger } from "../utils/logger/logger.js";
+/** Maximum character length for a single text part */
+const MAX_TEXT_PART_LENGTH = 10_000;
+/** Maximum number of messages in a single chat request */
+const MAX_MESSAGES_PER_REQUEST = 100;
 // ---------------------------------------------------------------------------
 // Zod schemas for validating AI SDK v5 chat UI messages
@@ -11,7 +18,7 @@ import { DEFAULT_LOCAL_MODEL } from "../provider/local/model-catalog.js";
 const textPartSchema = z.object({
   type: z.literal("text"),
-  text: z.string().max(10000),
+  text: z.string().max(MAX_TEXT_PART_LENGTH),
   state: z.string().optional(),
 });
@@ -66,7 +73,7 @@ const messageSchema = z.object({
 });
 const chatRequestSchema = z.object({
-  messages: z.array(messageSchema).min(1).max(100),
+  messages: z.array(messageSchema).min(1).max(MAX_MESSAGES_PER_REQUEST),
   model: z.string().optional(),
 });
@@ -87,13 +94,10 @@ type ToolPartWithOutput = {
 function isToolPartWithOutput(part: unknown): part is ToolPartWithOutput {
   if (!part || typeof part !== "object") return false;
-  const p = part as Record<string, unknown>;
-  const type = p.type;
-  if (typeof type !== "string") return false;
-  if (!type.startsWith("tool-") || type === "tool-result") return false;
+  if (!("type" in part) || typeof part.type !== "string") return false;
+  if (!part.type.startsWith("tool-") || part.type === "tool-result") return false;
-  return p.output !== undefined;
+  return "output" in part && part.output !== undefined;
 }
 /**
@@ -134,7 +138,7 @@ function transformUIMessages(messages: ParsedMessage[]): Message[] {
 }
 function isTextPart(part: unknown): part is ParsedTextPart {
-  return typeof part === "object" && part !== null && (part as { type?: string }).type === "text";
+  return typeof part === "object" && part !== null && "type" in part && part.type === "text";
 }
 function extractLastUserText(messages: ParsedMessage[]): string {
@@ -158,9 +162,12 @@ function isResponseLike(value: unknown): value is dntShim.Response {
   return (
     typeof value === "object" &&
     value !== null &&
-    typeof (value as dntShim.Response).status === "number" &&
-    typeof (value as dntShim.Response).headers === "object" &&
-    typeof (value as dntShim.Response).bodyUsed === "boolean"
+    "status" in value &&
+    typeof value.status === "number" &&
+    "headers" in value &&
+    typeof value.headers === "object" &&
+    "bodyUsed" in value &&
+    typeof value.bodyUsed === "boolean"
   );
 }
@@ -249,18 +256,29 @@ function isRequest(obj: unknown): obj is dntShim.Request {
   return (
     typeof obj === "object" &&
     obj !== null &&
-    typeof (obj as dntShim.Request).json === "function" &&
-    typeof (obj as dntShim.Request).url === "string" &&
-    typeof (obj as dntShim.Request).method === "string"
+    "json" in obj &&
+    typeof obj.json === "function" &&
+    "url" in obj &&
+    typeof obj.url === "string" &&
+    "method" in obj &&
+    typeof obj.method === "string"
   );
 }
 function extractRequest(requestOrCtx: unknown): dntShim.Request {
   if (isRequest(requestOrCtx)) return requestOrCtx;
   // Pages Router APIContext — has a .request property
-  const ctx = requestOrCtx as { request?: dntShim.Request };
-  if (isRequest(ctx.request)) return ctx.request;
-  throw new Error("Invalid handler argument: expected Request or APIContext");
+  if (
+    typeof requestOrCtx === "object" &&
+    requestOrCtx !== null &&
+    "request" in requestOrCtx
+  ) {
+    const candidate = (requestOrCtx as Record<string, unknown>).request;
+    if (isRequest(candidate)) return candidate;
+  }
+  throw INVALID_ARGUMENT.create({
+    detail: "Invalid handler argument: expected Request or APIContext",
+  });
 }
 /**
@@ -280,13 +298,13 @@ export function createChatHandler(
   agentId: string,
   options?: ChatHandlerOptions,
 ) {
-  // deno-lint-ignore no-explicit-any
-  return async function POST(requestOrCtx: any): Promise<dntShim.Response> {
+  return async function POST(requestOrCtx: unknown): Promise<dntShim.Response> {
     const request = extractRequest(requestOrCtx);
     let agent: ReturnType<typeof getAgent> | undefined;
     try {
       agent = getAgent(agentId);
-    } catch {
+    } catch (error) {
+      agentLogger.debug("getAgent lookup failed", { error });
       return dntShim.Response.json({ error: "Agent not found" }, { status: 404 });
     }
     if (!agent) {

package/src/src/agent/factory.ts CHANGED Viewed

@@ -1,5 +1,12 @@
 import * as dntShim from "../../_dnt.shims.js";
-import type { Agent, AgentConfig, AgentResponse, AgentStreamResult, Message } from "./types.js";
+import type {
+  Agent,
+  AgentConfig,
+  AgentResponse,
+  AgentStreamResult,
+  Message,
+  ResolvedAgentConfig,
+} from "./types.js";
 import { AgentRuntime } from "./runtime/index.js";
 import {
   detectPlatform,
@@ -18,6 +25,7 @@ import { agentRegistry } from "./composition/index.js";
 import { agentLogger } from "../utils/logger/logger.js";
 import { createError, toError } from "../errors/veryfront-error.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
+import { resolveConfiguredAgentModel } from "./runtime/model-resolution.js";
 const STREAMING_HEADERS: Record<string, string> = {
   "Content-Type": "text/event-stream",
@@ -56,6 +64,11 @@ export function agent(config: AgentConfig): Agent {
   const id = config.id ?? generateAgentId();
+  const publicConfig: ResolvedAgentConfig = {
+    ...config,
+    model: resolveConfiguredAgentModel(config.model),
+  };
   if (config.tools && config.tools !== true) {
     for (const [name, entry] of Object.entries(config.tools)) {
       if (!entry || typeof entry !== "object") continue;
@@ -132,14 +145,17 @@ export function agent(config: AgentConfig): Agent {
   }
   const runtime = new AgentRuntime(id, {
-    ...config,
+    ...publicConfig,
     tools: mergedToolsConfig,
     system: augmentedSystem,
   });
   const agentInstance: Agent = {
     id,
-    config,
+    config: {
+      ...publicConfig,
+      tools: mergedToolsConfig,
+    },
     generate(input): Promise<AgentResponse> {
       return withSpan(
@@ -186,12 +202,12 @@ export function agent(config: AgentConfig): Agent {
           // Validate model override against allowlist when configured
           const modelOverride = body.model;
-          if (modelOverride && config.allowedModels?.length) {
-            if (!config.allowedModels.includes(modelOverride)) {
+          if (modelOverride && publicConfig.allowedModels?.length) {
+            if (!publicConfig.allowedModels.includes(modelOverride)) {
               return new dntShim.Response(
                 JSON.stringify({
                   error: `Model "${modelOverride}" is not allowed. Allowed models: ${
-                    config.allowedModels.join(", ")
+                    publicConfig.allowedModels.join(", ")
                   }`,
                 }),
                 { status: 403, headers: { "Content-Type": "application/json" } },

package/src/src/agent/index.ts CHANGED Viewed

@@ -8,7 +8,6 @@
  * import { agent } from "veryfront/agent";
  *
  * const assistant = agent({
- *   model: "openai/gpt-4o",
  *   system: "You are a helpful assistant.",
  * });
  * ```
@@ -27,7 +26,6 @@
  * });
  *
  * const assistant = agent({
- *   model: "openai/gpt-4o",
  *   system: "You are a helpful assistant.",
  *   tools: { search: searchTool },
  *   memory: { type: "conversation", maxMessages: 50 },
@@ -39,7 +37,6 @@
  * import { agent } from "veryfront/agent";
  *
  * const assistant = agent({
- *   model: "openai/gpt-4o",
  *   system: "You are a support engineer. Use skills when relevant.",
  *   skills: ["incident-response", "repo-maintainer"], // or `true` for all discovered skills
  *   tools: {
@@ -55,7 +52,6 @@
  * import { agent } from "veryfront/agent";
  *
  * const assistant = agent({
- *   model: "openai/gpt-4o",
  *   system: "You are a helpful assistant.",
  * });
  *
@@ -70,14 +66,13 @@
  * ```ts
  * import { agent, registerAgent, getAgentsAsTools } from "veryfront/agent";
  *
- * const researcher = agent({ model: "openai/gpt-4o", system: "Research topics thoroughly." });
- * const writer = agent({ model: "openai/gpt-4o", system: "Write clear prose." });
+ * const researcher = agent({ system: "Research topics thoroughly." });
+ * const writer = agent({ system: "Write clear prose." });
  *
  * registerAgent(researcher);
  * registerAgent(writer);
  *
  * const orchestrator = agent({
- *   model: "openai/gpt-4o",
  *   system: "Coordinate research and writing.",
  *   tools: getAgentsAsTools(["researcher", "writer"]),
  * });
@@ -96,12 +91,11 @@ export type {
   AgentStreamResult,
   EdgeConfig,
   MemoryConfig,
-  /** @deprecated Use `AgentMessage` instead to avoid collision with chat `Message` component. */
-  Message,
   Message as AgentMessage,
   MessagePart,
   ModelProvider,
   ModelString,
+  ResolvedAgentConfig,
   StreamToolCall,
   ToolCall,
   ToolCallPart,

package/src/src/agent/memory/redis.ts CHANGED Viewed

@@ -37,7 +37,7 @@ export interface RedisMemoryConfig extends MemoryConfigBase {
   ttl?: number;
 }
-const DEFAULT_TTL = 86400; // 24 hours
+const DEFAULT_TTL = 86_400; // 24 hours
 const DEFAULT_KEY_PREFIX = "veryfront:agent:memory:";
 export class RedisMemory<M extends MinimalMessage = MinimalMessage> implements Memory<M> {
@@ -63,7 +63,8 @@ export class RedisMemory<M extends MinimalMessage = MinimalMessage> implements M
     if (!data) return [];
     try {
       return JSON.parse(data);
-    } catch {
+    } catch (_) {
+      /* expected: corrupted JSON in Redis, return empty message list */
       return [];
     }
   }

package/src/src/agent/react/use-agent.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useRef, useState } from "react";
-import type { AgentStatus, Message, ToolCall } from "../types.js";
+import type { AgentStatus, Message as AgentMessage, ToolCall } from "../types.js";
 import { createError, ensureError, toError } from "../../errors/veryfront-error.js";
 export interface UseAgentOptions {
@@ -19,7 +19,7 @@ export interface UseAgentOptions {
 export interface UseAgentResult {
   /** Message history */
-  messages: Message[];
+  messages: AgentMessage[];
   /** Active tool calls */
   toolCalls: ToolCall[];
@@ -44,7 +44,7 @@ export interface UseAgentResult {
 }
 export function useAgent(options: UseAgentOptions): UseAgentResult {
-  const [messages, setMessages] = useState<Message[]>([]);
+  const [messages, setMessages] = useState<AgentMessage[]>([]);
   const [toolCalls, setToolCalls] = useState<ToolCall[]>([]);
   const [status, setStatus] = useState<AgentStatus>("idle");
   const [thinking, setThinking] = useState<string | undefined>();
@@ -80,7 +80,7 @@ export function useAgent(options: UseAgentOptions): UseAgentResult {
         }
         const data = (await response.json()) as {
-          messages?: Message[];
+          messages?: AgentMessage[];
           toolCalls?: ToolCall[];
           status?: AgentStatus;
           thinking?: string;

package/src/src/agent/react/use-chat/browser-inference/browser-engine.ts CHANGED Viewed

@@ -10,7 +10,12 @@ import type { UIMessage, UIMessagePart } from "../types.js";
 import { generateClientId } from "../utils.js";
 import { BrowserInferenceClient } from "./worker-client.js";
-export interface BrowserInferenceCallbacks {
+/** Default max tokens for browser-side inference */
+const DEFAULT_BROWSER_MAX_TOKENS = 512;
+/** Default temperature for browser-side inference */
+const DEFAULT_BROWSER_TEMPERATURE = 0.7;
+interface BrowserInferenceCallbacks {
   onUpdate: (parts: UIMessagePart[], messageId: string) => void;
   onMessage: (message: UIMessage) => void;
   onStatusChange: (status: BrowserInferenceStatus) => void;
@@ -45,7 +50,11 @@ export function runBrowserInference(
   client.generate(
     messageId,
     simpleMessages,
-    { systemPrompt, maxNewTokens: 512, temperature: 0.7 },
+    {
+      systemPrompt,
+      maxNewTokens: DEFAULT_BROWSER_MAX_TOKENS,
+      temperature: DEFAULT_BROWSER_TEMPERATURE,
+    },
     {
       onStatus: (status) => callbacks.onStatusChange(status),
       onDownloadProgress: (progress) => callbacks.onDownloadProgress?.(progress),