veryfront 0.0.3 → 0.0.5

package/README.md

@@ -1,7 +1,214 @@
 # Veryfront
 
-Modern React meta-framework with native AI capabilities.
+Veryfront is a **zero-config React framework** for building **agentic applications**. Automatically discovers agents, tools, and routes through file-based conventions.
+
+## Installation
+
+**npm**
+```bash
+npm install veryfront ai zod
+```
+
+**yarn**
+```bash
+yarn add veryfront ai zod
+```
+
+**pnpm**
+```bash
+pnpm add veryfront ai zod
+```
+
+**bun**
+```bash
+bun add veryfront ai zod
+```
+
+**Deno**
+```bash
+deno add npm:veryfront npm:ai npm:zod
+```
+
+---
+
+## Project Structure
+
+```
+my-ai-app/
+├── .env
+├── app/
+│   ├── chat/page.tsx
+│   └── api/chat/route.ts
+└── ai/
+    ├── agents/assistant.ts         # Auto-registered
+    ├── tools/calculator.ts         # Auto-discovered
+    └── resources/users/profile.ts  # MCP resources
+```
+
+The `ai/` directory auto-enables AI features. No config required.
+
+---
+
+## Quick Start
+
+**1. Create an agent**
+
+`ai/agents/assistant.ts`:
+```typescript
+import { agent } from 'veryfront/ai';
+
+export default agent({
+  model: 'openai/gpt-4',
+  system: 'You are a helpful assistant.',
+  tools: { calculator: true },
+});
+```
+
+**2. Add a tool**
+
+`ai/tools/calculator.ts`:
+```typescript
+import { tool } from 'veryfront/ai';
+import { z } from 'zod';
+
+export default tool({
+  description: 'Perform calculations',
+  inputSchema: z.object({ expression: z.string() }),
+  execute: async ({ expression }) => ({ result: eval(expression) }),
+});
+```
+
+**3. Create the API endpoint**
+
+`app/api/chat/route.ts`:
+```typescript
+import { agents } from '@/ai/agents';
+
+export async function POST(req: Request) {
+  const { messages } = await req.json();
+  return agents.assistant.stream({ messages }).toDataStreamResponse();
+}
+```
+
+**4. Add the UI**
+
+`app/chat/page.tsx`:
+```tsx
+'use client';
+import { Chat } from 'veryfront/ai/components';
+import { useChat } from 'veryfront/ai/react';
+
+export default function ChatPage() {
+  return <Chat {...useChat({ api: '/api/chat' })} />;
+}
+```
+
+**5. Run**
+
+```bash
+# Set your API key
+echo "OPENAI_API_KEY=sk-..." > .env
+
+# Start development server
+npx veryfront dev
+```
+
+Visit `localhost:3000/chat` - your agent can now use the calculator tool.
+
+---
+
+## UI Customization
+
+**Styled components** (production-ready):
+```tsx
+import { Chat } from 'veryfront/ai/components';
+```
+
+**Primitives** (bring your own styles):
+```tsx
+import { ChatContainer, MessageList, MessageItem } from 'veryfront/ai/primitives';
+```
+
+**Headless hooks** (total control):
+```tsx
+import { useChat } from 'veryfront/ai/react';
+```
+
+---
+
+## Model Context Protocol
+
+MCP exposes your tools and resources to external AI applications. Enabled by default when `ai/` directory exists.
+
+**Add a resource:**
+
+`ai/resources/users/profile.ts`:
+```typescript
+import { resource } from 'veryfront/ai';
+import { z } from 'zod';
+
+export default resource({
+  description: 'Get user profile',
+  paramsSchema: z.object({ userId: z.string() }),
+  async load({ userId }) {
+    return await db.users.findUnique({ where: { id: userId } });
+  },
+});
+```
+
+**Run MCP server:**
+```bash
+npx veryfront dev --mcp  # Port 3001 by default
+```
+
+---
+
+## Features
+
+- **Zero config** - Auto-discovery from file structure
+- **Multi-runtime** - Deno, Node.js, Bun, Cloudflare Workers
+- **Full-stack React** - SSR, SSG, ISR, JIT rendering
+- **MCP built-in** - Model Context Protocol server
+- **Production-ready** - Rate limiting, caching, cost tracking, security
+
+---
+
+## Documentation
+
+- [Quick Start Tutorial](https://veryfront.com/docs/learn/quickstart)
+- [AI Getting Started](https://veryfront.com/docs/ai/getting-started)
+- [Routing Guide](https://veryfront.com/docs/guides/routing)
+- [Deployment Guide](https://veryfront.com/docs/guides/deployment)
+- [API Reference](https://veryfront.com/docs/reference/ai)
+
+[Browse all docs →](https://veryfront.com/docs)
+
+---
+
+## CLI Commands
+
+```bash
+# Development
+npx veryfront dev
+
+# Build for production
+npx veryfront build
+
+# Start production server
+npx veryfront start
+
+# Run with MCP server
+npx veryfront dev --mcp
+```
+
+---
+
+## Examples
+
+See the [examples directory](https://github.com/veryfront/veryfront/tree/main/examples) for complete working examples.
+
+---
 
 ## License
 
-MIT License - see [LICENSE](./LICENSE)
+MIT - see [LICENSE](./LICENSE)

package/bin/veryfront.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// CLI entry point - calls main() from the bundled CLI
+import { main } from '../dist/cli.js';
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/ai/client.js

@@ -0,0 +1,7 @@
+// src/ai/client.ts
+import { useChat, useCompletion } from "ai/react";
+export {
+  useChat,
+  useCompletion
+};
+//# sourceMappingURL=client.js.map

package/dist/ai/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ai/client.ts"],
+  "sourcesContent": ["/**\n * Client-only AI SDK exports\n *\n * This module exports React hooks from AI SDK that can only be used in browser environments.\n * These hooks require browser-specific APIs and should not be bundled for server-side code.\n *\n * @module ai/client\n */\n\n// Re-export AI SDK React hooks (battle-tested, proven in production)\n// These are client-only and require browser environment\nexport { useChat, useCompletion } from \"ai/react\";\n\n// Re-export core types that are useful on the client\nexport type { UseChatOptions, UseCompletionOptions } from \"ai/react\";\n"],
+  "mappings": ";AAWA,SAAS,SAAS,qBAAqB;",
+  "names": []
+}