@agentuity/cli 2.0.11 → 3.0.0-alpha.1

package/src/cmd/project/auth/shared.ts

@@ -514,67 +514,42 @@ export function printIntegrationExamples(): void {
 	tui.newline();
 
 	console.log(tui.muted('━'.repeat(60)));
-	console.log(tui.bold(' 1. Set up your API routes (e.g., src/api/index.ts):'));
+	console.log(tui.bold(' 1. Set up your API routes:'));
 	console.log(tui.muted('━'.repeat(60)));
 	console.log(`
-import { createRouter } from '@agentuity/runtime';
+import { Hono } from 'hono';
 import { mountAuthRoutes } from '@agentuity/auth';
-import { auth, authMiddleware } from '../auth';
+import { auth, authMiddleware } from './auth';
 
-const api = createRouter();
+const app = new Hono();
 
 // Mount auth routes (sign-in, sign-up, sign-out, session, etc.)
-// Must match the basePath configured in createAuth (default: /api/auth)
-api.on(['GET', 'POST'], '/api/auth/*', mountAuthRoutes(auth));
+app.on(['GET', 'POST'], '/api/auth/*', mountAuthRoutes(auth));
 
 // Protect your API routes with auth middleware
-api.use('/api/*', authMiddleware);
+app.use('/api/*', authMiddleware);
 
-api.get('/api/me', async (c) => {
+app.get('/api/me', async (c) => {
   const user = await c.var.auth.getUser();
   return c.json({ id: user.id, email: user.email });
 });
 
-export default api;
+export default app;
 `);
 
 	console.log(tui.muted('━'.repeat(60)));
-	console.log(tui.bold(' 2. Wrap your React app with AuthProvider:'));
+	console.log(tui.bold(' 2. Use the auth client in your frontend:'));
 	console.log(tui.muted('━'.repeat(60)));
 	console.log(`
-import { AgentuityProvider } from '@agentuity/react';
-import { createAuthClient, AuthProvider } from '@agentuity/auth/react';
+import { createAuthClient } from '@agentuity/auth/client';
 
 const authClient = createAuthClient();
 
-function App() {
-  return (
-    <AgentuityProvider>
-      <AuthProvider authClient={authClient}>
-        {/* your app */}
-      </AuthProvider>
-    </AgentuityProvider>
-  );
-}
-`);
+// Sign in
+await authClient.signIn.email({ email, password });
 
-	console.log(tui.muted('━'.repeat(60)));
-	console.log(tui.bold(' 3. Access auth in agents via ctx.auth:'));
-	console.log(tui.muted('━'.repeat(60)));
-	console.log(`
-import { createAgent } from '@agentuity/runtime';
-
-export default createAgent('my-agent', {
-  schema: { input: s.object({ name: s.string() }), output: s.string() },
-  handler: async (ctx, input) => {
-    // ctx.auth is available when using auth middleware
-    if (ctx.auth) {
-      const user = await ctx.auth.getUser();
-      return \`Hello, \${user.email}!\`;
-    }
-    return 'Hello, anonymous!';
-  },
-});
+// Get session
+const session = await authClient.getSession();
 `);
 
 	tui.newline();

package/src/cmd/project/create.ts

@@ -11,7 +11,7 @@ const ProjectCreateResponseSchema = z.object({
 	path: z.string().describe('Project directory path'),
 	projectId: z.string().optional().describe('Project ID if registered'),
 	orgId: z.string().optional().describe('Organization ID if registered'),
-	template: z.string().describe('Template used'),
+	framework: z.string().describe('Framework used'),
 	installed: z.boolean().describe('Whether dependencies were installed'),
 	built: z.boolean().describe('Whether the project was built'),
 	domains: z.array(z.string()).optional().describe('Array of custom domains'),
@@ -29,33 +29,30 @@ export const createProjectSubcommand = createSubcommand({
 	examples: [
 		{ command: getCommand('project create'), description: 'Create new project' },
 		{
-			command: getCommand('project create --name my-ai-agent'),
-			description: 'Create new project',
+			command: getCommand('project create --name my-ai-app'),
+			description: 'Create named project',
 		},
 		{
-			command: getCommand('project create --name customer-service-bot --dir ~/projects/agent'),
-			description: 'Create new project',
+			command: getCommand('project create --name my-app --framework nextjs'),
+			description: 'Create with Next.js',
 		},
 		{
-			command: getCommand('project create --template basic --no-install'),
-			description: 'Use no install option',
+			command: getCommand('project create --framework hono --no-install'),
+			description: 'Scaffold without installing',
 		},
-		{ command: getCommand('project new --no-register'), description: 'Use no register option' },
+		{ command: getCommand('project new --no-register'), description: 'Skip cloud registration' },
 	],
 	schema: {
 		options: z.object({
 			name: z.string().optional().describe('Project name'),
 			dir: z.string().optional().describe('Directory to create the project in'),
 			domains: z.array(z.string()).optional().describe('Array of custom domains'),
-			template: z.string().optional().describe('Template to use'),
-			templateDir: z
+			framework: z
 				.string()
 				.optional()
-				.describe('Local template directory for testing (e.g., ./packages/templates)'),
-			templateBranch: z
-				.string()
-				.optional()
-				.describe('GitHub branch to use for templates (default: main)'),
+				.describe(
+					'Framework to use (e.g., nextjs, astro, sveltekit, remix, nuxt, hono, vite-react)'
+				),
 			install: z
 				.boolean()
 				.optional()
@@ -101,9 +98,7 @@ export const createProjectSubcommand = createSubcommand({
 			projectName: opts.name,
 			dir: opts.dir,
 			domains: opts.domains,
-			template: opts.template,
-			templateDir: opts.templateDir,
-			templateBranch: opts.templateBranch,
+			framework: opts.framework,
 			noInstall: opts.install === false,
 			noBuild: opts.build === false,
 			skipPrompts: opts.confirm === true,
@@ -130,7 +125,7 @@ export const createProjectSubcommand = createSubcommand({
 			path: result.path,
 			projectId: result.projectId,
 			orgId: result.orgId,
-			template: result.template,
+			framework: result.framework,
 			installed: result.installed,
 			built: result.built,
 			domains: result.domains,

package/src/cmd/project/frameworks-ai-examples.ts

@@ -0,0 +1,166 @@
+/**
+ * AI SDK example generators for each framework.
+ *
+ * Each function returns a map of relative file paths to file contents
+ * that demonstrate a simple AI chat endpoint using the Vercel AI SDK
+ * with the Agentuity AI Gateway.
+ */
+
+export function nextjsAiExample(): Record<string, string> {
+	return {
+		'app/api/chat/route.ts': `import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { NextResponse } from 'next/server';
+
+export async function POST(request: Request) {
+\tconst { message } = await request.json();
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn NextResponse.json({ reply: text });
+}
+`,
+	};
+}
+
+export function nuxtAiExample(): Record<string, string> {
+	return {
+		'server/api/chat.post.ts': `import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+export default defineEventHandler(async (event) => {
+\tconst { message } = await readBody(event);
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn { reply: text };
+});
+`,
+	};
+}
+
+export function remixAiExample(): Record<string, string> {
+	return {
+		'app/routes/api.chat.ts': `import { type ActionFunctionArgs, json } from '@remix-run/node';
+import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+export async function action({ request }: ActionFunctionArgs) {
+\tconst { message } = await request.json();
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn json({ reply: text });
+}
+`,
+	};
+}
+
+export function sveltekitAiExample(): Record<string, string> {
+	return {
+		'src/routes/api/chat/+server.ts': `import { json } from '@sveltejs/kit';
+import type { RequestHandler } from './$types';
+import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+export const POST: RequestHandler = async ({ request }) => {
+\tconst { message } = await request.json();
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn json({ reply: text });
+};
+`,
+	};
+}
+
+export function astroAiExample(): Record<string, string> {
+	return {
+		'src/pages/api/chat.ts': `import type { APIRoute } from 'astro';
+import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+export const POST: APIRoute = async ({ request }) => {
+\tconst { message } = await request.json();
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn new Response(
+\t\tJSON.stringify({ reply: text }),
+\t\t{ headers: { 'Content-Type': 'application/json' } }
+\t);
+};
+`,
+	};
+}
+
+export function honoAiExample(): Record<string, string> {
+	return {
+		'src/index.ts': `import { Hono } from 'hono';
+import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+const app = new Hono();
+
+app.get('/', (c) => c.text('Hello from Hono + Agentuity!'));
+
+app.post('/api/chat', async (c) => {
+\tconst { message } = await c.req.json();
+
+\tconst { text } = await generateText({
+\t\tmodel: openai('gpt-4o-mini'),
+\t\tprompt: message,
+\t});
+
+\treturn c.json({ reply: text });
+});
+
+export default app;
+`,
+	};
+}
+
+export function viteReactAiExample(): Record<string, string> {
+	return {
+		'server.ts': `import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+Bun.serve({
+\tport: process.env.PORT ?? 3000,
+\tasync fetch(request) {
+\t\tconst url = new URL(request.url);
+
+\t\tif (url.pathname === '/api/chat' && request.method === 'POST') {
+\t\t\tconst { message } = await request.json();
+
+\t\t\tconst { text } = await generateText({
+\t\t\t\tmodel: openai('gpt-4o-mini'),
+\t\t\t\tprompt: message,
+\t\t\t});
+
+\t\t\treturn Response.json({ reply: text });
+\t\t}
+
+\t\treturn new Response('Not Found', { status: 404 });
+\t},
+});
+
+console.log('Server running on http://localhost:' + (process.env.PORT ?? 3000));
+`,
+	};
+}

package/src/cmd/project/frameworks-landing-pages.ts

@@ -0,0 +1,267 @@
+/**
+ * Agentuity-branded landing page generators for each framework.
+ *
+ * Each function returns a map of relative file paths to file contents
+ * that replace the framework's default landing page with a dark-themed
+ * Agentuity welcome page matching the brand design system.
+ *
+ * Design: dark background (#09090b), cyan accent (#00FFFF), Agentuity
+ * logo, "Welcome to Agentuity" heading, and framework-specific next steps.
+ */
+
+// ─── Shared ──────────────────────────────────────────────────────────────────
+
+const AGENTUITY_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="48" height="42" viewBox="0 0 220 191" fill="none">
+	<path fill-rule="evenodd" clip-rule="evenodd" d="M220 191H0L31.427 136.5H0L8 122.5H180.5L220 191ZM47.588 136.5L24.234 177H195.766L172.412 136.5H47.588Z" fill="#00FFFF"/>
+	<path fill-rule="evenodd" clip-rule="evenodd" d="M110 0L157.448 82.5H189L197 96.5H54.5L110 0ZM78.702 82.5L110 28.081L141.298 82.5H78.702Z" fill="#00FFFF"/>
+</svg>`;
+
+const SHARED_STYLES = `
+<style>
+	* { margin: 0; padding: 0; box-sizing: border-box; }
+	body { background: #09090b; color: #a1a1aa; font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; display: flex; justify-content: center; }
+	.wrap { max-width: 48rem; width: 100%; padding: 4rem; display: flex; flex-direction: column; gap: 1rem; }
+	.header { text-align: center; margin-bottom: 2rem; }
+	.header svg { margin-bottom: 1rem; }
+	.header h1 { font-size: 3rem; font-weight: 100; color: #fff; }
+	.header p { font-size: 1.125rem; color: #71717a; }
+	.header em { font-style: italic; font-family: Georgia, serif; }
+	.card { background: #000; border: 1px solid #1c1c1e; border-radius: 0.5rem; padding: 2rem; }
+	.card h3 { color: #fff; font-size: 1.25rem; font-weight: 400; margin-bottom: 1.5rem; }
+	.step { display: flex; gap: 0.75rem; align-items: flex-start; margin-bottom: 1.25rem; }
+	.step:last-child { margin-bottom: 0; }
+	.check { width: 1rem; height: 1rem; border: 1px solid #22c55e; background: #052e16; border-radius: 0.25rem; display: flex; align-items: center; justify-content: center; flex-shrink: 0; margin-top: 0.1rem; }
+	.check svg { width: 0.625rem; height: 0.625rem; }
+	.step h4 { color: #fff; font-size: 0.875rem; font-weight: 400; margin-bottom: 0.25rem; }
+	.step p { font-size: 0.75rem; }
+	code { color: #fff; background: #1c1c1e; padding: 0.125rem 0.375rem; border-radius: 0.25rem; font-size: 0.75rem; }
+	a.badge { position: fixed; bottom: 1rem; right: 1rem; display: flex; align-items: center; gap: 0.5rem; padding: 0.5rem 0.75rem; background: #09090b; border: 1px solid #27272a; border-radius: 0.5rem; color: #a1a1aa; font-size: 0.75rem; text-decoration: none; transition: border-color 0.2s; z-index: 50; }
+	a.badge:hover { border-color: #00FFFF; }
+	a.badge svg { width: 16px; height: 14px; }
+</style>`;
+
+const CHECK_SVG =
+	'<svg fill="none" stroke="#22c55e" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24"><path d="M20 6 9 17l-5-5"/></svg>';
+
+const BADGE_SVG =
+	'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 220 191" fill="none"><path fill-rule="evenodd" clip-rule="evenodd" d="M220 191H0L31.427 136.5H0L8 122.5H180.5L220 191ZM47.588 136.5L24.234 177H195.766L172.412 136.5H47.588Z" fill="#00FFFF"/><path fill-rule="evenodd" clip-rule="evenodd" d="M110 0L157.448 82.5H189L197 96.5H54.5L110 0ZM78.702 82.5L110 28.081L141.298 82.5H78.702Z" fill="#00FFFF"/></svg>';
+
+function buildPage(frameworkLabel: string, steps: { title: string; text: string }[]): string {
+	const stepsHtml = steps
+		.map(
+			(s) => `
+			<div class="step">
+				<div class="check">${CHECK_SVG}</div>
+				<div><h4>${s.title}</h4><p>${s.text}</p></div>
+			</div>`
+		)
+		.join('');
+
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="utf-8"/>
+	<meta name="viewport" content="width=device-width, initial-scale=1"/>
+	<title>Agentuity + ${frameworkLabel}</title>
+	${SHARED_STYLES}
+</head>
+<body>
+	<div class="wrap">
+		<div class="header">
+			${AGENTUITY_LOGO_SVG}
+			<h1>Welcome to Agentuity</h1>
+			<p><em>${frameworkLabel}</em> + AI Gateway</p>
+		</div>
+		<div class="card">
+			<h3>Getting started</h3>
+			${stepsHtml}
+		</div>
+	</div>
+	<a class="badge" href="https://agentuity.dev/" target="_blank" rel="noopener noreferrer">${BADGE_SVG} Powered by Agentuity</a>
+</body>
+</html>`;
+}
+
+// ─── Framework-specific Landing Pages ────────────────────────────────────────
+
+export function nextjsLandingPage(): Record<string, string> {
+	return {
+		'src/app/page.tsx': `export default function Home() {
+	return (
+		<div
+			style={{ background: '#09090b', color: '#a1a1aa', fontFamily: 'system-ui, -apple-system, sans-serif', minHeight: '100vh', display: 'flex', justifyContent: 'center' }}
+			dangerouslySetInnerHTML={{
+				__html: \`${buildReactInnerHtml('Next.js', [
+					{
+						title: 'AI Gateway',
+						text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+					},
+					{
+						title: 'API route',
+						text: 'Edit <code>app/api/chat/route.ts</code> to customize the AI endpoint.',
+					},
+					{
+						title: 'Deploy',
+						text: 'Run <code>agentuity deploy</code> to ship to production.',
+					},
+				])}\`
+			}}
+		/>
+	);
+}
+`,
+		'src/app/globals.css': `body { margin: 0; }
+`,
+	};
+}
+
+export function nuxtLandingPage(): Record<string, string> {
+	return {
+		'app.vue': `<template>
+	<div v-html="html" />
+</template>
+
+<script setup lang="ts">
+const html = \`${buildPage('Nuxt', [
+			{
+				title: 'AI Gateway',
+				text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+			},
+			{
+				title: 'Server route',
+				text: 'Edit <code>server/api/chat.post.ts</code> to customize the AI endpoint.',
+			},
+			{ title: 'Deploy', text: 'Run <code>agentuity deploy</code> to ship to production.' },
+		])}\`;
+</script>
+`,
+	};
+}
+
+export function remixLandingPage(): Record<string, string> {
+	return {
+		'app/routes/_index.tsx': `export default function Index() {
+	return (
+		<div
+			style={{ background: '#09090b', color: '#a1a1aa', fontFamily: 'system-ui, -apple-system, sans-serif', minHeight: '100vh', display: 'flex', justifyContent: 'center' }}
+			dangerouslySetInnerHTML={{
+				__html: \`${buildReactInnerHtml('Remix', [
+					{
+						title: 'AI Gateway',
+						text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+					},
+					{
+						title: 'Action route',
+						text: 'Edit <code>app/routes/api.chat.ts</code> to customize the AI endpoint.',
+					},
+					{
+						title: 'Deploy',
+						text: 'Run <code>agentuity deploy</code> to ship to production.',
+					},
+				])}\`
+			}}
+		/>
+	);
+}
+`,
+	};
+}
+
+export function sveltekitLandingPage(): Record<string, string> {
+	return {
+		'src/routes/+page.svelte': `{@html \`${buildPage('SvelteKit', [
+			{
+				title: 'AI Gateway',
+				text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+			},
+			{
+				title: 'Server route',
+				text: 'Edit <code>src/routes/api/chat/+server.ts</code> to customize the AI endpoint.',
+			},
+			{ title: 'Deploy', text: 'Run <code>agentuity deploy</code> to ship to production.' },
+		])}\`}
+`,
+	};
+}
+
+export function astroLandingPage(): Record<string, string> {
+	return {
+		'src/pages/index.astro': `---
+---
+${buildPage('Astro', [
+	{
+		title: 'AI Gateway',
+		text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+	},
+	{
+		title: 'API route',
+		text: 'Edit <code>src/pages/api/chat.ts</code> to customize the AI endpoint.',
+	},
+	{ title: 'Deploy', text: 'Run <code>agentuity deploy</code> to ship to production.' },
+])}
+`,
+	};
+}
+
+export function viteReactLandingPage(): Record<string, string> {
+	return {
+		'src/App.tsx': `export default function App() {
+	return (
+		<div
+			style={{ background: '#09090b', color: '#a1a1aa', fontFamily: 'system-ui, -apple-system, sans-serif', minHeight: '100vh', display: 'flex', justifyContent: 'center' }}
+			dangerouslySetInnerHTML={{
+				__html: \`${buildReactInnerHtml('Vite + React', [
+					{
+						title: 'AI Gateway',
+						text: 'Run <code>agentuity dev</code> to start with AI Gateway routing.',
+					},
+					{
+						title: 'Server',
+						text: 'Edit <code>server.ts</code> to customize the AI endpoint.',
+					},
+					{
+						title: 'Deploy',
+						text: 'Run <code>agentuity deploy</code> to ship to production.',
+					},
+				])}\`
+			}}
+		/>
+	);
+}
+`,
+		'src/index.css': `body { margin: 0; }
+`,
+	};
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+/** Build inner HTML for React's dangerouslySetInnerHTML (no <html>/<body> wrapper) */
+function buildReactInnerHtml(
+	frameworkLabel: string,
+	steps: { title: string; text: string }[]
+): string {
+	const stepsHtml = steps
+		.map(
+			(s) => `
+			<div class="step">
+				<div class="check">${CHECK_SVG}</div>
+				<div><h4>${s.title}</h4><p>${s.text}</p></div>
+			</div>`
+		)
+		.join('');
+
+	return `${SHARED_STYLES}
+	<div class="wrap">
+		<div class="header">
+			${AGENTUITY_LOGO_SVG}
+			<h1>Welcome to Agentuity</h1>
+			<p><em>${frameworkLabel}</em> + AI Gateway</p>
+		</div>
+		<div class="card">
+			<h3>Getting started</h3>
+			${stepsHtml}
+		</div>
+	</div>
+	<a class="badge" href="https://agentuity.dev/" target="_blank" rel="noopener noreferrer">${BADGE_SVG} Powered by Agentuity</a>`;
+}