awel 0.1.2 → 0.2.1

package/README.md

@@ -8,16 +8,24 @@ AI-powered development overlay for Next.js. Awel runs a proxy in front of your d
 
 ## Quick Start
 
-```bash
-# Skip if you're already in a Next.js app
-npx create-next-app@latest my-app && cd my-app
+### Create a new project
 
+```bash
 # Set up at least one AI provider (pick one):
 export ANTHROPIC_API_KEY="sk-ant-..."   # Anthropic API
 export OPENAI_API_KEY="sk-..."          # OpenAI
 export GOOGLE_GENERATIVE_AI_API_KEY="..." # Google AI
 # Or install the Claude CLI: https://docs.anthropic.com/en/docs/claude-code
 
+npx awel create
+```
+
+This scaffolds a new Next.js project and marks it for creation mode. Follow the instructions to `cd` into the project and run `npx awel dev`. You'll see a full-page creation UI where you describe what you want to build — the AI agent generates the entire app for you, then transitions to the normal Awel overlay.
+
+### Use with an existing project
+
+```bash
+cd my-existing-next-app
 npx awel dev
 ```
 
@@ -25,10 +33,11 @@ Awel needs at least one configured provider to function. See [Supported Models](
 
 This starts Awel on port 3001 and proxies your Next.js dev server on port 3000. Open `http://localhost:3001` to see your app with the Awel overlay.
 
-### Options
+### Commands
 
 ```
-awel dev [options]
+awel create              Create a new Next.js project with Awel
+awel dev [options]       Start the development server with Awel overlay
 
   -p, --port <port>    Target app port (default: 3000)
   -v, --verbose        Print LLM stream events to stderr
@@ -65,6 +74,13 @@ Awel uses the [Vercel AI SDK](https://sdk.vercel.ai) and supports multiple provi
 
 Switch models at any time from the dropdown in the dashboard header.
 
+### Additional Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OPENAI_BASE_URL` | Custom base URL for the OpenAI provider (e.g. a proxy or compatible API). Defaults to `https://api.openai.com/v1`. |
+| `AWEL_MAX_OUTPUT_TOKENS` | Maximum number of tokens the model can generate per response. Applies to all providers. |
+
 ## Agent Tools
 
 The AI agent has access to:
@@ -94,6 +110,7 @@ The AI agent has access to:
 - **Diff review** — review a summary of all file changes before accepting
 - **Dark mode** — follows your system preference
 - **i18n** — English and Chinese
+- **Creation mode** — `awel create` scaffolds a new project and launches a full-page AI chat where you describe your app and the agent builds it from scratch
 
 ## Development
 

package/README.zh-CN.md

@@ -8,16 +8,24 @@
 
 ## 快速开始
 
-```bash
-# 如果你已经在一个 Next.js 项目中，可以跳过这一步
-npx create-next-app@latest my-app && cd my-app
+### 创建新项目
 
+```bash
 # 至少配置一个 AI 服务商（任选其一）：
 export ANTHROPIC_API_KEY="sk-ant-..."   # Anthropic API
 export OPENAI_API_KEY="sk-..."          # OpenAI
 export GOOGLE_GENERATIVE_AI_API_KEY="..." # Google AI
 # 或安装 Claude CLI：https://docs.anthropic.com/en/docs/claude-code
 
+npx awel create
+```
+
+此命令会创建一个新的 Next.js 项目并标记为创建模式。按照提示 `cd` 进入项目目录并运行 `npx awel dev`。你会看到一个全屏创建界面，描述你想构建的应用——AI 智能体会为你生成整个应用，完成后自动切换到正常的 Awel 浮层模式。
+
+### 在已有项目中使用
+
+```bash
+cd my-existing-next-app
 npx awel dev
 ```
 
@@ -25,10 +33,11 @@ Awel 需要至少一个已配置的服务商才能运行。完整列表见[支
 
 Awel 会在端口 3001 启动，并代理运行在端口 3000 的 Next.js 开发服务器。打开 `http://localhost:3001` 即可看到带有 Awel 浮层的应用。
 
-### 选项
+### 命令
 
 ```
-awel dev [options]
+awel create              创建一个带有 Awel 的新 Next.js 项目
+awel dev [options]       启动带有 Awel 浮层的开发服务器
 
   -p, --port <port>    目标应用端口（默认：3000）
   -v, --verbose        将 LLM 流式事件输出到 stderr
@@ -65,6 +74,13 @@ Awel 使用 [Vercel AI SDK](https://sdk.vercel.ai)，支持多个服务商。设
 
 可随时在面板顶部的下拉菜单中切换模型。
 
+### 额外环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `OPENAI_BASE_URL` | OpenAI 服务商的自定义 Base URL（例如代理或兼容 API）。默认为 `https://api.openai.com/v1`。 |
+| `AWEL_MAX_OUTPUT_TOKENS` | 模型单次响应的最大生成 token 数。对所有服务商生效。 |
+
 ## 智能体工具
 
 AI 智能体可使用以下工具：
@@ -94,6 +110,7 @@ AI 智能体可使用以下工具：
 - **Diff 审查** — 在接受变更前查看所有文件修改的摘要
 - **深色模式** — 跟随系统偏好
 - **国际化** — 支持英文和中文
+- **创建模式** — `awel create` 创建新项目并启动全屏 AI 对话界面，描述你的应用，智能体从零开始为你构建
 
 ## 开发
 

package/dist/cli/agent.d.ts

@@ -2,5 +2,6 @@ import { Hono } from 'hono';
 /**
  * Creates the agent API routes with SSE streaming.
  * @param projectCwd - The user's project directory (where they ran `awel dev`)
+ * @param isFresh - Getter for whether the project is in creation mode
  */
-export declare function createAgentRoute(projectCwd: string, targetPort: number): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export declare function createAgentRoute(projectCwd: string, targetPort: number, isFresh?: () => boolean): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/cli/agent.js

@@ -95,8 +95,9 @@ function setSSEHeaders(c) {
 /**
  * Creates the agent API routes with SSE streaming.
  * @param projectCwd - The user's project directory (where they ran `awel dev`)
+ * @param isFresh - Getter for whether the project is in creation mode
  */
-export function createAgentRoute(projectCwd, targetPort) {
+export function createAgentRoute(projectCwd, targetPort, isFresh) {
     const agent = new Hono();
     // ─── Model Catalog ───────────────────────────────────────
     agent.get('/api/models', (c) => {
@@ -158,7 +159,7 @@ export function createAgentRoute(projectCwd, targetPort) {
             // Appending eagerly would leave orphan user messages in the session when
             // the stream is aborted or paused for user input, causing consecutive
             // user messages that trigger API 400 errors (especially with Anthropic).
-            provider.streamResponse(adapter, messages, { projectCwd, targetPort, signal })
+            provider.streamResponse(adapter, messages, { projectCwd, targetPort, signal, creationMode: isFresh?.() })
                 .then((responseMessages) => {
                 if (responseMessages.length > 0) {
                     appendUserMessage(userContent);

package/dist/cli/awel-config.d.ts

@@ -1,6 +1,10 @@
 export interface AwelConfig {
     babelPlugin?: boolean;
     onboarded?: boolean;
+    fresh?: boolean;
+    createdAt?: string;
 }
 export declare function readAwelConfig(projectCwd: string): AwelConfig;
 export declare function writeAwelConfig(projectCwd: string, config: AwelConfig): void;
+export declare function isProjectFresh(projectCwd: string): boolean;
+export declare function markProjectReady(projectCwd: string): void;

package/dist/cli/awel-config.js

@@ -18,3 +18,11 @@ export function writeAwelConfig(projectCwd, config) {
     }
     writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
 }
+export function isProjectFresh(projectCwd) {
+    return readAwelConfig(projectCwd).fresh === true;
+}
+export function markProjectReady(projectCwd) {
+    const config = readAwelConfig(projectCwd);
+    config.fresh = false;
+    writeAwelConfig(projectCwd, config);
+}

package/dist/cli/create.d.ts

@@ -0,0 +1 @@
+export declare function runCreate(projectNameArg?: string): Promise<void>;

package/dist/cli/create.js

@@ -0,0 +1,136 @@
+import { existsSync, cpSync, readdirSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import * as p from '@clack/prompts';
+import { writeAwelConfig } from './awel-config.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES = [
+    { value: 'blank', label: 'Blank', hint: 'Empty Next.js app with AGENT.md' },
+    { value: 'landing', label: 'Landing Page', hint: 'Hero, features, and CTA sections' },
+    { value: 'dashboard', label: 'Dashboard', hint: 'Sidebar layout with stats cards' },
+    { value: 'blog', label: 'Blog', hint: 'Blog listing with dynamic post pages' },
+    { value: 'portfolio', label: 'Portfolio', hint: 'Project showcase with cards' },
+    { value: 'saas', label: 'SaaS', hint: 'Landing, pricing, and dashboard pages' },
+];
+function detectPackageManager() {
+    const agent = process.env.npm_config_user_agent;
+    if (agent) {
+        if (agent.startsWith('pnpm'))
+            return 'pnpm';
+        if (agent.startsWith('yarn'))
+            return 'yarn';
+        if (agent.startsWith('bun'))
+            return 'bun';
+    }
+    return 'npm';
+}
+function getTemplatesDir() {
+    return join(__dirname, 'templates');
+}
+export async function runCreate(projectNameArg) {
+    p.intro('Create a new Awel project');
+    // 1. Project name
+    let projectName;
+    if (projectNameArg) {
+        projectName = projectNameArg;
+        p.log.info(`Project name: ${projectName}`);
+    }
+    else {
+        const result = await p.text({
+            message: 'What is your project name?',
+            placeholder: 'my-app',
+            validate(value) {
+                if (!value || !value.trim())
+                    return 'Project name is required';
+                if (!/^[a-zA-Z0-9_-]+$/.test(value.trim()))
+                    return 'Project name can only contain letters, numbers, hyphens, and underscores';
+            },
+        });
+        if (p.isCancel(result)) {
+            p.cancel('Operation cancelled.');
+            process.exit(0);
+        }
+        projectName = result;
+    }
+    const projectDir = resolve(process.cwd(), projectName);
+    // Check if directory already exists
+    if (existsSync(projectDir)) {
+        p.cancel(`Directory "${projectName}" already exists.`);
+        process.exit(1);
+    }
+    // 2. Template selection
+    const template = await p.select({
+        message: 'Which template would you like to use?',
+        options: TEMPLATES,
+    });
+    if (p.isCancel(template)) {
+        p.cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    // 3. Package manager
+    const detected = detectPackageManager();
+    const packageManager = await p.select({
+        message: 'Which package manager do you want to use?',
+        options: [
+            { value: 'npm', label: 'npm', hint: detected === 'npm' ? 'detected' : undefined },
+            { value: 'pnpm', label: 'pnpm', hint: detected === 'pnpm' ? 'detected' : undefined },
+            { value: 'yarn', label: 'yarn', hint: detected === 'yarn' ? 'detected' : undefined },
+            { value: 'bun', label: 'bun', hint: detected === 'bun' ? 'detected' : undefined },
+        ],
+        initialValue: detected,
+    });
+    if (p.isCancel(packageManager)) {
+        p.cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    const pm = packageManager;
+    const templateName = template;
+    // 4. Scaffold with create-next-app
+    const s = p.spinner();
+    s.start('Creating Next.js app...');
+    const useFlag = pm === 'npm' ? '--use-npm' : pm === 'pnpm' ? '--use-pnpm' : pm === 'yarn' ? '--use-yarn' : '--use-bun';
+    const cnaArgs = [
+        'create-next-app@latest',
+        projectDir,
+        '--ts',
+        '--tailwind',
+        '--eslint',
+        '--app',
+        '--src-dir',
+        '--import-alias', '@/*',
+        useFlag,
+    ];
+    try {
+        execSync(`npx ${cnaArgs.map(a => `"${a}"`).join(' ')}`, {
+            stdio: 'inherit',
+            timeout: 120000,
+        });
+    }
+    catch (err) {
+        s.stop('Failed to create Next.js app.');
+        const message = err instanceof Error ? err.message : String(err);
+        p.log.error(message);
+        process.exit(1);
+    }
+    s.stop('Next.js app created.');
+    // 5. Copy template overlay files
+    s.start('Applying template...');
+    const templateDir = join(getTemplatesDir(), templateName);
+    if (existsSync(templateDir) && readdirSync(templateDir).length > 0) {
+        cpSync(templateDir, projectDir, { recursive: true, force: true });
+    }
+    s.stop('Template applied.');
+    // 6. Write Awel config
+    writeAwelConfig(projectDir, {
+        template: templateName,
+        packageManager: pm,
+        createdAt: new Date().toISOString(),
+    });
+    // 7. Done
+    p.log.success(`Project "${projectName}" created with the "${templateName}" template.`);
+    p.log.info('Next steps:');
+    p.log.step(`  cd ${projectName}`);
+    p.log.step('  npx awel dev');
+    p.outro('Happy building!');
+}

package/dist/cli/index.js

@@ -6,6 +6,8 @@ import { ensureBabelPlugin } from './babel-setup.js';
 import { ensureProvider } from './onboarding.js';
 import { awel } from './logger.js';
 import { spawnDevServer } from './subprocess.js';
+import { writeAwelConfig, isProjectFresh } from './awel-config.js';
+import { resolve } from 'path';
 program
     .name('awel')
     .description('AI-powered development overlay for Next.js')
@@ -19,18 +21,70 @@ program
     const targetPort = parseInt(options.port, 10);
     if (options.verbose)
         setVerbose(true);
+    const fresh = isProjectFresh(process.cwd());
     await ensureProvider(process.cwd());
-    await ensureBabelPlugin(process.cwd());
+    if (!fresh)
+        await ensureBabelPlugin(process.cwd());
     awel.log('🌟 Starting Awel...');
+    if (fresh)
+        awel.log('   Mode: Creation (new project)');
     awel.log(`   Target app port: ${targetPort}`);
     awel.log(`   Awel control server: http://localhost:${AWEL_PORT}`);
     awel.log('');
     // Start the Awel control server (proxy + dashboard)
-    await startServer({ awelPort: AWEL_PORT, targetPort, projectCwd: process.cwd() });
+    await startServer({ awelPort: AWEL_PORT, targetPort, projectCwd: process.cwd(), fresh });
     // Start the user's Next.js app via subprocess manager (handles auto-restart)
     await spawnDevServer({ port: targetPort, cwd: process.cwd() });
     awel.log('');
-    awel.log(`✨ Awel is ready! Open http://localhost:${AWEL_PORT}`);
-    awel.log('   Look for the floating button in the bottom-right corner.');
+    if (fresh) {
+        awel.log(`✨ Awel is ready! Open http://localhost:${AWEL_PORT}`);
+        awel.log('   Describe what you want to build and Awel will create it for you.');
+    }
+    else {
+        awel.log(`✨ Awel is ready! Open http://localhost:${AWEL_PORT}`);
+        awel.log('   Look for the floating button in the bottom-right corner.');
+    }
+});
+program
+    .command('create')
+    .description('Create a new Next.js project with Awel')
+    .action(async () => {
+    const p = await import('@clack/prompts');
+    const { execa } = await import('execa');
+    p.intro('Create a new project with Awel');
+    const name = await p.text({
+        message: 'Project name',
+        placeholder: 'my-app',
+        validate: (value) => {
+            if (!value)
+                return 'Project name is required';
+            if (!/^[a-z0-9._-]+$/i.test(value))
+                return 'Project name must only contain letters, numbers, dashes, dots, and underscores';
+        },
+    });
+    if (p.isCancel(name)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const s = p.spinner();
+    s.start('Creating Next.js project...');
+    try {
+        await execa('npx', [
+            'create-next-app@latest', name,
+            '--yes',
+            '--typescript', '--tailwind', '--eslint',
+            '--app', '--use-npm',
+        ], { cwd: process.cwd(), stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' });
+    }
+    catch (err) {
+        s.stop('Failed to create project');
+        const stderr = err.stderr || err.message || String(err);
+        p.log.error(stderr);
+        process.exit(1);
+    }
+    s.stop('Project created');
+    const projectDir = resolve(process.cwd(), name);
+    writeAwelConfig(projectDir, { fresh: true, createdAt: new Date().toISOString() });
+    p.outro(`Done! Now run:\n\n  cd ${name}\n  npx awel dev`);
 });
 program.parse();

package/dist/cli/onboarding.js

@@ -1,25 +1,50 @@
-import { readAwelConfig } from './awel-config.js';
+import { readAwelConfig, writeAwelConfig } from './awel-config.js';
 import { getAvailableProviders, PROVIDER_ENV_KEYS, PROVIDER_LABELS } from './providers/registry.js';
 import { awel } from './logger.js';
-function printSetupInstructions() {
-    awel.log('No LLM providers are configured.');
-    awel.log('Awel needs at least one AI provider to function.');
-    awel.log('');
-    awel.log('Set up a provider by exporting its API key:');
-    awel.log('');
-    // List all providers with their setup commands
-    for (const [provider, envKey] of Object.entries(PROVIDER_ENV_KEYS)) {
+async function promptProviderSetup() {
+    const p = await import('@clack/prompts');
+    p.log.warn('No LLM providers are configured.');
+    p.log.message('Awel needs at least one AI provider to function.\n');
+    const provider = await p.select({
+        message: 'Which provider would you like to set up?',
+        options: [
+            { value: 'claude-code', label: 'Claude Code', hint: 'Uses Claude CLI binary' },
+            { value: 'anthropic', label: 'Anthropic API', hint: 'ANTHROPIC_API_KEY' },
+            { value: 'openai', label: 'OpenAI', hint: 'OPENAI_API_KEY' },
+            { value: 'google-ai', label: 'Google AI', hint: 'GOOGLE_GENERATIVE_AI_API_KEY' },
+            { value: 'vercel-gateway', label: 'Vercel AI Gateway', hint: 'AI_GATEWAY_API_KEY' },
+            { value: 'qwen', label: 'Qwen', hint: 'DASHSCOPE_API_KEY' },
+            { value: 'minimax', label: 'MiniMax', hint: 'MINIMAX_API_KEY' },
+        ],
+    });
+    if (p.isCancel(provider)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    if (provider === 'claude-code') {
+        p.note('Install the Claude CLI:\n\n' +
+            '  npm install -g @anthropic-ai/claude-code\n\n' +
+            'Then authenticate:\n\n' +
+            '  claude login', 'Claude Code Setup');
+    }
+    else if (provider === 'openai') {
+        const envKey = PROVIDER_ENV_KEYS[provider];
+        p.note(`Export your API key:\n\n` +
+            `  export ${envKey}="your-api-key"\n\n` +
+            `Or add it to your .env file:\n\n` +
+            `  ${envKey}=your-api-key\n\n` +
+            `To use a custom base URL (e.g. a proxy or compatible API):\n\n` +
+            `  export OPENAI_BASE_URL="https://your-proxy.com/v1"`, 'OpenAI Setup');
+    }
+    else {
+        const envKey = PROVIDER_ENV_KEYS[provider];
         const label = PROVIDER_LABELS[provider] ?? provider;
-        awel.log(`  ${label}`);
-        awel.log(`  export ${envKey}="..."`);
-        awel.log('');
+        p.note(`Export your API key:\n\n` +
+            `  export ${envKey}="your-api-key"\n\n` +
+            `Or add it to your .env file:\n\n` +
+            `  ${envKey}=your-api-key`, `${label} Setup`);
     }
-    // Claude Code is special — no env var, needs CLI install
-    const label = PROVIDER_LABELS['claude-code'] ?? 'Claude Code';
-    awel.log(`  ${label}`);
-    awel.log('  Install the Claude CLI: https://docs.anthropic.com/en/docs/claude-code');
-    awel.log('');
-    awel.log('Then run `awel dev` again.');
+    p.log.message('Then run `awel dev` again.');
 }
 export async function ensureProvider(projectCwd) {
     const config = readAwelConfig(projectCwd);
@@ -37,21 +62,21 @@ export async function ensureProvider(projectCwd) {
             awel.log(`  \u25CF ${p.label}`);
         }
         awel.log('');
-        printSetupInstructions();
-        process.exit(1);
+        writeAwelConfig(projectCwd, { ...config, onboarded: true });
+        return;
     }
     if (isFirstRun && available.length === 0) {
-        // First run with NO providers — show welcome + instructions, exit
+        // First run with NO providers — show welcome + interactive setup, exit
         awel.log('');
         awel.log('Welcome to Awel!');
         awel.log('AI-powered development overlay for Next.js');
         awel.log('');
-        printSetupInstructions();
+        await promptProviderSetup();
         process.exit(1);
     }
     if (!isFirstRun && available.length === 0) {
-        // Subsequent run with NO providers — instructions only, exit
-        printSetupInstructions();
+        // Subsequent run with NO providers — interactive setup, exit
+        await promptProviderSetup();
         process.exit(1);
     }
     // Subsequent run with providers available — silent pass-through

package/dist/cli/providers/types.d.ts

@@ -6,6 +6,8 @@ export interface ProviderConfig {
     targetPort: number;
     /** When aborted, the provider should stop the LLM stream and exit early. */
     signal?: AbortSignal;
+    /** When true, the agent uses a creation-mode system prompt for building new apps. */
+    creationMode?: boolean;
 }
 export interface StreamProvider {
     streamResponse(stream: SSEStreamingApi, messages: ModelMessage[], config: ProviderConfig): Promise<ResponseMessage[]>;

package/dist/cli/providers/vercel.js

@@ -67,6 +67,48 @@ Inspector Context:
 
 Language:
 - IMPORTANT: Always respond in the same language the user writes in. If the user writes in Chinese, respond in Chinese. If the user writes in English, respond in English. Match the user's language throughout the conversation.`;
+const CREATION_SYSTEM_PROMPT = `You are Awel in creation mode. The user has just created a fresh Next.js project and wants to build something new.
+
+You have access to the same tools as in normal mode:
+- Read: Read file contents
+- Write: Create or overwrite files (creates parent directories automatically)
+- Edit: Find-and-replace edits in files
+- Bash: Execute shell commands
+- Glob: Find files by glob pattern
+- Ls: List directory contents
+- AskUser: Ask the user clarifying questions with selectable options
+- Grep: Search file contents for a regex pattern
+- MultiEdit: Apply multiple find-and-replace edits to a single file in one call
+- WebSearch: Search the web for real-time information
+- WebFetch: Fetch content from a URL
+- CodeSearch: Search the web for code examples
+- TodoRead: Read the current task list
+- TodoWrite: Create or update the task list
+- RestartDevServer: Restart the dev server
+
+Your workflow:
+
+1. UNDERSTAND: If the user's request is vague or could go multiple directions, use AskUser to ask 1-3 clarifying questions about the app type, key features, and design preferences. Keep questions focused and provide concrete options.
+
+2. GENERATE: Create a complete, working Next.js app using:
+   - App Router with TypeScript
+   - Tailwind CSS for all styling
+   - Clean component structure in the app/ directory
+   - Modern, responsive design with good typography and spacing
+   - Proper error handling and loading states
+   - No placeholder code or TODOs — everything should work
+
+3. VERIFY: After generating all files, check that the dev server is running without errors. If there are build errors, fix them.
+
+Clarifying Questions:
+- When a user's request is ambiguous or has multiple valid approaches, use the AskUser tool to ask clarifying questions before proceeding.
+- Present 1-4 questions, each with 2-4 concrete options. Use multiSelect when choices are not mutually exclusive.
+- Keep header labels short (max 12 chars). Put the recommended option first with "(Recommended)" in the label.
+- CRITICAL: All fields in the AskUser tool must be plain text. Do NOT use markdown formatting.
+- After calling AskUser, STOP and wait for the user's answers before continuing.
+
+Language:
+- IMPORTANT: Always respond in the same language the user writes in. If the user writes in Chinese, respond in Chinese. If the user writes in English, respond in English.`;
 /** Detects files Claude Code uses for plan output (.claude/plans/*.md, plan.md) */
 function isPlanFile(filePath) {
     const normalized = filePath.replace(/\\/g, '/');
@@ -107,7 +149,9 @@ function createModel(modelId, providerType, cwd) {
         return anthropic(modelId);
     }
     else if (providerType === 'openai') {
-        const openai = createOpenAI({});
+        const openai = createOpenAI({
+            baseURL: process.env.OPENAI_BASE_URL,
+        });
         return openai(modelId);
     }
     else if (providerType === 'google-ai') {
@@ -184,15 +228,20 @@ export function createVercelProvider(modelId, providerType) {
             try {
                 // Self-contained providers handle their own system prompt and tools internally.
                 // All other providers get our system prompt + tools.
+                const basePrompt = config.creationMode ? CREATION_SYSTEM_PROMPT : SYSTEM_PROMPT;
                 const systemPrompt = isSelfContained
                     ? undefined
-                    : `${SYSTEM_PROMPT}\n\nThe user's project directory is: ${config.projectCwd}`;
+                    : `${basePrompt}\n\nThe user's project directory is: ${config.projectCwd}`;
+                const maxOutputTokens = process.env.AWEL_MAX_OUTPUT_TOKENS
+                    ? parseInt(process.env.AWEL_MAX_OUTPUT_TOKENS, 10)
+                    : undefined;
                 const streamTextArgs = {
                     model,
                     ...(systemPrompt && { system: systemPrompt }),
                     messages,
                     tools,
                     ...(!isSelfContained && { stopWhen: stepCountIs(25) }),
+                    ...(maxOutputTokens && { maxOutputTokens }),
                     abortSignal: abortController.signal,
                 };
                 logEvent('stream:start', `model=${modelId} provider=${providerType} messages=${messages.length}`);

package/dist/cli/proxy.d.ts

@@ -2,4 +2,4 @@
  * Creates proxy middleware that forwards requests to the target app
  * and injects the Awel host script into HTML responses.
  */
-export declare function createProxyMiddleware(targetPort: number, projectCwd?: string): (c: any, _next: () => Promise<void>) => Promise<any>;
+export declare function createProxyMiddleware(targetPort: number, projectCwd?: string, isFresh?: () => boolean): (c: any, _next: () => Promise<void>) => Promise<any>;