opc-agent 4.2.0 → 4.2.1

package/dist/cli.js

@@ -40,6 +40,7 @@ const path = __importStar(require("path"));
 const yaml = __importStar(require("js-yaml"));
 const readline = __importStar(require("readline"));
 const runtime_1 = require("./core/runtime");
+const model_recommender_1 = require("./core/model-recommender");
 const customer_service_1 = require("./templates/customer-service");
 const sales_assistant_1 = require("./templates/sales-assistant");
 const knowledge_base_1 = require("./templates/knowledge-base");
@@ -60,7 +61,6 @@ const hermes_1 = require("./deploy/hermes");
 const index_1 = require("./deploy/index");
 const workflow_1 = require("./core/workflow");
 const versioning_1 = require("./core/versioning");
-const providers_1 = require("./providers");
 const knowledge_1 = require("./core/knowledge");
 const doctor_1 = require("./doctor");
 const child_process_1 = require("child_process");
@@ -124,7 +124,7 @@ async function select(question, options) {
 program
     .name('opc')
     .description('OPC Agent - Open Agent Framework for business workstations')
-    .version('2.0.0');
+    .version(require('../package.json').version);
 // ── Init command ─────────────────────────────────────────────
 program
     .command('init')
@@ -186,7 +186,7 @@ program
         }
         const roleDisplayName = roleMeta.name || matched.role;
         const roleDescription = roleMeta.name_zh ? `${roleMeta.name} (${roleMeta.name_zh})` : (roleMeta.name || matched.role);
-        console.log(`  ${icon.info} Matched role: ${color.cyan(matched.category + '/' + matched.role)} — ${roleDisplayName}`);
+        console.log(`  ${icon.info} Matched role: ${color.cyan(matched.category + '/' + matched.role)} - ${roleDisplayName}`);
         // Create directories
         fs.mkdirSync(dir, { recursive: true });
         fs.mkdirSync(path.join(dir, 'src', 'skills'), { recursive: true });
@@ -205,9 +205,9 @@ program
         // Company-specific knowledge belongs to Desk (closed-source), not here.
         const workstationSeedFromRole = workstationMatch?.[0]?.trim() || '';
         fs.writeFileSync(path.join(dir, 'brain-seeds', 'workstation.md'), workstationSeedFromRole || `# Workstation Knowledge\n\n## Tools & Environment\n\nCommon tools and setup for this workstation role.\n\n## Workflows\n\nStandard operating procedures and workflows.\n\n## Best Practices\n\nIndustry best practices for this role.\n`);
-        // agent.yaml with role system prompt and brain seeds
+        // oad.yaml with role system prompt and brain seeds（不再生成 agent.yaml）
         const firstLine = systemPromptContent.split('\n').find((l) => l.trim() && !l.startsWith('#'))?.trim() || 'You are a helpful AI assistant.';
-        fs.writeFileSync(path.join(dir, 'agent.yaml'), `apiVersion: opc/v1
+        fs.writeFileSync(path.join(dir, 'oad.yaml'), `apiVersion: opc/v1
 kind: Agent
 metadata:
   name: ${name}
@@ -251,14 +251,14 @@ spec:
         if (roleData.files['oad.yaml']) {
             fs.writeFileSync(path.join(dir, 'oad.yaml'), roleData.files['oad.yaml']);
         }
-        // src/index.ts — entry point (same as generic)
+        // src/index.ts - entry point (same as generic)
         fs.writeFileSync(path.join(dir, 'src', 'index.ts'), `import { AgentRuntime } from 'opc-agent';
 import { EchoSkill } from './skills/echo';
 import { readFileSync, existsSync } from 'fs';
 
 async function main() {
   const runtime = new AgentRuntime();
-  const config = await runtime.loadConfig('./agent.yaml');
+  const config = await runtime.loadConfig('./oad.yaml');
 
   const soul = existsSync('./SOUL.md') ? readFileSync('./SOUL.md', 'utf-8') : '';
   const context = existsSync('./CONTEXT.md') ? readFileSync('./CONTEXT.md', 'utf-8') : '';
@@ -305,15 +305,15 @@ export class EchoSkill extends BaseSkill {
         fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ name, version: '1.0.0', private: true, scripts: { start: 'opc run', dev: 'opc dev', chat: 'opc chat', build: 'tsc' }, dependencies: { 'opc-agent': '^1.3.0' }, devDependencies: { typescript: '^5.5.0', tsx: '^4.0.0' } }, null, 2));
         // .gitignore, .env.example, .env
         fs.writeFileSync(path.join(dir, '.gitignore'), 'node_modules\ndist\n.env\n.opc-knowledge.json\ndata/\n');
-        fs.writeFileSync(path.join(dir, '.env.example'), `# LLM API Configuration\nOPC_LLM_API_KEY=your-api-key-here\nOPC_LLM_BASE_URL=https://api.openai.com/v1\nOPC_LLM_MODEL=gpt-4o-mini\n`);
-        fs.writeFileSync(path.join(dir, '.env'), `OPC_LLM_API_KEY=your-api-key-here\nOPC_LLM_BASE_URL=https://api.openai.com/v1\nOPC_LLM_MODEL=gpt-4o-mini\n`);
+        fs.writeFileSync(path.join(dir, '.env.example'), `# LLM API Configuration\n# Ollama (免费本地，默认，无需 API key):\nOPC_LLM_BASE_URL=http://localhost:11434/v1\nOPC_LLM_MODEL=qwen2.5\n\n# 如需使用商业模型，取消以下注释:\n# OPC_LLM_API_KEY=your-api-key-here\n# OPC_LLM_BASE_URL=https://api.deepseek.com/v1\n# OPC_LLM_MODEL=deepseek-chat\n`);
+        fs.writeFileSync(path.join(dir, '.env'), `# Ollama (免费本地) - 无需 API key\nOPC_LLM_BASE_URL=http://localhost:11434/v1\nOPC_LLM_MODEL=qwen2.5\n`);
         // README.md
         fs.writeFileSync(path.join(dir, 'README.md'), `# ${name}\n\nCreated with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the \`${matched.category}/${matched.role}\` workstation role.\n\n## Quick Start\n\n\`\`\`bash\nnpm install\nollama pull qwen2.5\nnpx tsx src/index.ts\n\`\`\`\n\nOpen [http://localhost:3000](http://localhost:3000)\n`);
         // Dockerfile + docker-compose
-        fs.writeFileSync(path.join(dir, 'Dockerfile'), `FROM node:22-alpine\nWORKDIR /app\nCOPY package.json package-lock.json* ./\nRUN npm ci --production 2>/dev/null || npm install --production\nCOPY oad.yaml agent.yaml .env* ./\nCOPY src/ ./src/\nCOPY prompts/ ./prompts/ 2>/dev/null || true\nEXPOSE 3000\nCMD ["npx", "opc", "run"]\n`);
-        fs.writeFileSync(path.join(dir, 'docker-compose.yml'), `version: '3.8'\nservices:\n  agent:\n    build: .\n    ports:\n      - "3000:3000"\n    env_file:\n      - .env\n    volumes:\n      - ./agent.yaml:/app/agent.yaml:ro\n    restart: unless-stopped\n`);
+        fs.writeFileSync(path.join(dir, 'Dockerfile'), `FROM node:22-alpine\nWORKDIR /app\nCOPY package.json package-lock.json* ./\nRUN npm ci --production 2>/dev/null || npm install --production\nCOPY oad.yaml .env* ./\nCOPY src/ ./src/\nCOPY prompts/ ./prompts/ 2>/dev/null || true\nEXPOSE 3000\nCMD ["npx", "opc", "run"]\n`);
+        fs.writeFileSync(path.join(dir, 'docker-compose.yml'), `version: '3.8'\nservices:\n  agent:\n    build: .\n    ports:\n      - "3000:3000"\n    env_file:\n      - .env\n    volumes:\n      - ./oad.yaml:/app/oad.yaml:ro\n    restart: unless-stopped\n`);
         console.log(`\n${icon.success} Created agent project: ${color.bold(name + '/')} from role ${color.cyan(matched.category + '/' + matched.role)}`);
-        console.log(`   ${icon.file} agent.yaml       - Agent definition with role system prompt`);
+        console.log(`   ${icon.file} oad.yaml         - Agent definition with role system prompt`);
         console.log(`   ${icon.file} SOUL.md          - Role personality (${systemPromptContent.split('\n').length} lines)`);
         console.log(`   ${icon.file} CONTEXT.md       - Role context & documentation`);
         console.log(`   ${icon.file} brain-seeds/     - 3-tier brain seed knowledge`);
@@ -344,7 +344,7 @@ export class EchoSkill extends BaseSkill {
         }
     }
     catch {
-        // Hub unreachable — fall back to bundled templates
+        // Hub unreachable - fall back to bundled templates
     }
     let template;
     let selectedHubTemplate;
@@ -364,6 +364,156 @@ export class EchoSkill extends BaseSkill {
     else {
         template = await select('Select a template:', Object.entries(TEMPLATES).map(([value, { label }]) => ({ value, label })));
     }
+    // ── 硬件检测 + 智能模型推荐 ──
+    // ── 硬件检测 + 远程模型推荐 ──
+    const sys = (0, model_recommender_1.detectSystem)();
+    const allModels = await (0, model_recommender_1.fetchModelList)();
+    // ── LLM Provider 选择（Ollama-first）──
+    let llmProvider = 'ollama';
+    let llmModel = 'qwen2.5';
+    let llmBaseUrl = 'http://localhost:11434/v1';
+    let llmApiKey = '';
+    let ollamaRunning = false;
+    let modelNames = [];
+    // 无论 --yes 还是交互式，都先检测 Ollama
+    try {
+        const controller = new AbortController();
+        const ollamaTimeout = setTimeout(() => controller.abort(), 3000);
+        const ollamaRes = await fetch('http://localhost:11434/api/tags', { signal: controller.signal });
+        clearTimeout(ollamaTimeout);
+        const ollamaData = await ollamaRes.json();
+        modelNames = (ollamaData.models || []).map((m) => m.name || m.model);
+        ollamaRunning = true;
+        if (opts.yes && modelNames.length > 0) {
+            const rec = (0, model_recommender_1.recommendModels)(allModels, sys, modelNames);
+            // --yes: prefer best installed recommended model
+            const bestInstalled = rec.installed.length > 0 ? rec.installed[rec.installed.length - 1] : null;
+            // Filter out embedding-only models (can't chat)
+            const chatModels = modelNames.filter(m => !m.includes('embed'));
+            llmModel = bestInstalled ? bestInstalled.name : (chatModels[0] || 'qwen2.5:7b');
+        }
+    }
+    catch {
+        ollamaRunning = false;
+    }
+    // Compute recommendation (used by both interactive branches)
+    const rec = (0, model_recommender_1.recommendModels)(allModels, sys, modelNames);
+    if (!opts.yes) {
+        if (ollamaRunning) {
+            console.log(`\n  ${icon.info} ${color.dim('正在检测 Ollama...')}`);
+            console.log(`  ${icon.success} Ollama 已运行，发现 ${modelNames.length} 个模型`);
+            console.log(`  ${icon.info} 系统: ${sys.totalRAM}GB RAM (${sys.freeRAM}GB 可用), ${sys.cpuCount} CPU cores`);
+            console.log(`  ${icon.info} 推荐模型: ${color.cyan(rec.best.name)} (${rec.best.size}) - ${rec.best.desc}`);
+            // 选择 provider
+            llmProvider = await select('选择 LLM 引擎:', [
+                { value: 'ollama', label: '🟢 Ollama (免费本地，推荐) - 已检测到运行中' },
+                { value: 'deepseek', label: '🔵 DeepSeek - 高性价比国产模型' },
+                { value: 'openai', label: '⚪ OpenAI (GPT-4o)' },
+                { value: 'anthropic', label: '🟣 Anthropic (Claude)' },
+                { value: 'custom', label: '⚙️  自定义 (手动输入 Base URL)' },
+            ]);
+            if (llmProvider === 'ollama') {
+                // 已有模型 + 推荐未下载的模型
+                const modelOptions = [
+                    ...rec.installed.map((m) => {
+                        const isBest = m.name === rec.best.name ? ' ⭐推荐' : '';
+                        return { value: m.name, label: `${m.name} (${m.size}, ${m.desc})${isBest} [已安装]` };
+                    }),
+                    // Also show installed models not in recommendation list
+                    ...modelNames.filter(n => !rec.installed.find(m => m.name === n)).map(n => ({ value: n, label: `${n} [已安装]` })),
+                    ...rec.toDownload.map((m) => ({
+                        value: `pull:${m.name}`,
+                        label: `${m.name} (${m.size}, ${m.desc}) [需下载]`,
+                    })),
+                ];
+                if (modelOptions.length > 0) {
+                    const chosen = await select('选择 Ollama 模型:', modelOptions);
+                    if (chosen.startsWith('pull:')) {
+                        const pullModel = chosen.slice(5);
+                        console.log(`\n  ${icon.info} 正在下载 ${color.cyan(pullModel)}...`);
+                        console.log(`     运行 ${color.cyan(`ollama pull ${pullModel}`)} 下载`);
+                        console.log(`     下载完成后运行 ${color.cyan('opc run')} 启动\n`);
+                        llmModel = pullModel;
+                    }
+                    else {
+                        llmModel = chosen;
+                    }
+                }
+                else {
+                    // 没有本地模型，推荐下载
+                    console.log(`  ${color.yellow('⚠️')}  没有发现已下载的模型`);
+                    console.log(`  ${icon.info} 根据你的硬件 (${sys.freeRAM}GB 可用)，推荐下载:`);
+                    for (const m of rec.suitable.slice(-3)) {
+                        console.log(`     ${color.cyan(`ollama pull ${m.name}`)}  (${m.size}, ${m.desc})`);
+                    }
+                    llmModel = rec.best.name;
+                }
+            }
+        }
+        else {
+            // Ollama not running
+            console.log(`\n  ${icon.info} ${color.dim('正在检测 Ollama...')}`);
+            console.log(`  ${color.yellow('⚠️')}  Ollama 未运行或未安装`);
+            llmProvider = await select('选择 LLM 引擎:', [
+                { value: 'ollama', label: '🟢 Ollama (免费本地，推荐) - 需先安装: https://ollama.ai' },
+                { value: 'deepseek', label: '🔵 DeepSeek - 高性价比国产模型' },
+                { value: 'openai', label: '⚪ OpenAI (GPT-4o)' },
+                { value: 'anthropic', label: '🟣 Anthropic (Claude)' },
+                { value: 'custom', label: '⚙️  自定义 (手动输入 Base URL)' },
+            ]);
+            if (llmProvider === 'ollama') {
+                console.log(`\n  ${icon.info} Ollama 安装指南:`);
+                console.log(`     1. 访问 ${color.cyan('https://ollama.ai')} 下载并安装`);
+                console.log(`  ${icon.info} 根据你的硬件 (${sys.totalRAM}GB RAM, ${sys.freeRAM}GB 可用)，推荐:`);
+                for (const m of rec.suitable.slice(-3)) {
+                    console.log(`     ${color.cyan(`ollama pull ${m.name}`)}  (${m.size}, ${m.desc})`);
+                }
+                console.log(`     3. 然后 ${color.cyan('opc run')} 即可开始对话\n`);
+                llmModel = rec.best.name;
+            }
+        }
+        // 商业模型需要 API key
+        if (llmProvider === 'deepseek') {
+            llmBaseUrl = 'https://api.deepseek.com/v1';
+            llmModel = 'deepseek-chat';
+            llmApiKey = await promptUser('输入 DeepSeek API Key (可稍后在 .env 中配置，直接回车跳过)');
+            if (!llmApiKey) {
+                console.log(`  ${icon.info} 稍后在 ${color.cyan('.env')} 文件中设置 ${color.bold('OPC_LLM_API_KEY')}`);
+            }
+        }
+        else if (llmProvider === 'openai') {
+            llmBaseUrl = 'https://api.openai.com/v1';
+            llmModel = 'gpt-4o-mini';
+            llmApiKey = await promptUser('输入 OpenAI API Key (可稍后在 .env 中配置，直接回车跳过)');
+            if (!llmApiKey) {
+                console.log(`  ${icon.info} 稍后在 ${color.cyan('.env')} 文件中设置 ${color.bold('OPC_LLM_API_KEY')}`);
+            }
+        }
+        else if (llmProvider === 'anthropic') {
+            llmBaseUrl = 'https://api.anthropic.com/v1';
+            llmModel = 'claude-sonnet-4-20250514';
+            llmApiKey = await promptUser('输入 Anthropic API Key (可稍后在 .env 中配置，直接回车跳过)');
+            if (!llmApiKey) {
+                console.log(`  ${icon.info} 稍后在 ${color.cyan('.env')} 文件中设置 ${color.bold('OPC_LLM_API_KEY')}`);
+            }
+        }
+        else if (llmProvider === 'custom') {
+            llmBaseUrl = await promptUser('输入 Base URL', 'http://localhost:11434/v1');
+            llmModel = await promptUser('输入模型名称', 'qwen2.5');
+            llmApiKey = await promptUser('输入 API Key (可选，直接回车跳过)');
+            // 尝试推断 provider
+            if (llmBaseUrl.includes('deepseek.com'))
+                llmProvider = 'deepseek';
+            else if (llmBaseUrl.includes('openai.com'))
+                llmProvider = 'openai';
+            else if (llmBaseUrl.includes('anthropic.com'))
+                llmProvider = 'anthropic';
+            else if (llmBaseUrl.includes('localhost:11434'))
+                llmProvider = 'ollama';
+            else
+                llmProvider = 'openai'; // OpenAI-compatible fallback
+        }
+    }
     const dir = path.resolve(name);
     if (fs.existsSync(dir)) {
         console.error(`\n${icon.error} Directory ${color.bold(name)} already exists.`);
@@ -374,37 +524,16 @@ export class EchoSkill extends BaseSkill {
     const factory = TEMPLATES[template]?.factory ?? customer_service_1.createCustomerServiceConfig;
     const config = factory();
     config.metadata.name = name;
+    // 用用户选择的 provider 和 model 覆盖模板默认值
+    config.spec.model = llmModel;
+    config.spec.provider = { default: llmProvider };
     // Ensure web channel exists
     if (!config.spec.channels.some((c) => c.type === 'web')) {
         config.spec.channels.push({ type: 'web', port: 3000 });
     }
+    // 只生成 oad.yaml，不生成 agent.yaml
     fs.writeFileSync(path.join(dir, 'oad.yaml'), yaml.dump(config, { lineWidth: 120 }));
-    // agent.yaml — standalone OAD config for runtime usage
-    fs.writeFileSync(path.join(dir, 'agent.yaml'), `apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: ${name}
-  version: 1.0.0
-  description: My AI Agent
-spec:
-  model: qwen2.5
-  provider:
-    default: ollama
-  systemPrompt: |
-    You are a helpful AI assistant named ${name}.
-    Be concise, helpful, and friendly.
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm:
-      provider: deepbrain
-  skills:
-    - name: echo
-      description: Echo test skill
-`);
-    // src/index.ts — entry point
+    // src/index.ts - entry point
     fs.writeFileSync(path.join(dir, 'src', 'index.ts'), `import { AgentRuntime } from 'opc-agent';
 import { EchoSkill } from './skills/echo';
 import { readFileSync, existsSync } from 'fs';
@@ -413,7 +542,7 @@ async function main() {
   const runtime = new AgentRuntime();
 
   // Load OAD config
-  const config = await runtime.loadConfig('./agent.yaml');
+  const config = await runtime.loadConfig('./oad.yaml');
 
   // Load personality and context files
   const soul = existsSync('./SOUL.md') ? readFileSync('./SOUL.md', 'utf-8') : '';
@@ -439,7 +568,7 @@ async function main() {
 
 main().catch(console.error);
 `);
-    // src/skills/echo.ts — example skill
+    // src/skills/echo.ts - example skill
     fs.writeFileSync(path.join(dir, 'src', 'skills', 'echo.ts'), `import { BaseSkill } from 'opc-agent';
 import type { AgentContext, Message, SkillResult } from 'opc-agent';
 
@@ -477,23 +606,39 @@ export class EchoSkill extends BaseSkill {
     }, null, 2));
     // .env.example
     fs.writeFileSync(path.join(dir, '.env.example'), `# LLM API Configuration
-OPC_LLM_API_KEY=your-api-key-here
-OPC_LLM_BASE_URL=https://api.openai.com/v1
-OPC_LLM_MODEL=gpt-4o-mini
+# Ollama (免费本地，默认):
+# OPC_LLM_BASE_URL=http://localhost:11434/v1
+# OPC_LLM_MODEL=qwen2.5
+# (Ollama 无需 API key)
 
-# For DeepSeek:
+# DeepSeek:
+# OPC_LLM_API_KEY=your-deepseek-key
 # OPC_LLM_BASE_URL=https://api.deepseek.com/v1
 # OPC_LLM_MODEL=deepseek-chat
 
-# For local Ollama (default in agent.yaml):
-# OPC_LLM_BASE_URL=http://localhost:11434/v1
-# OPC_LLM_MODEL=qwen2.5
-`);
-    // .env (copy of example)
-    fs.writeFileSync(path.join(dir, '.env'), `OPC_LLM_API_KEY=your-api-key-here
-OPC_LLM_BASE_URL=https://api.openai.com/v1
-OPC_LLM_MODEL=gpt-4o-mini
+# OpenAI:
+# OPC_LLM_API_KEY=your-openai-key
+# OPC_LLM_BASE_URL=https://api.openai.com/v1
+# OPC_LLM_MODEL=gpt-4o-mini
+
+# Anthropic:
+# OPC_LLM_API_KEY=your-anthropic-key
+# OPC_LLM_BASE_URL=https://api.anthropic.com/v1
+# OPC_LLM_MODEL=claude-sonnet-4-20250514
 `);
+    // .env - 根据用户选择生成正确的配置
+    const envLines = [];
+    if (llmProvider === 'ollama') {
+        envLines.push('# Ollama (免费本地) - 无需 API key');
+        envLines.push(`OPC_LLM_BASE_URL=${llmBaseUrl}`);
+        envLines.push(`OPC_LLM_MODEL=${llmModel}`);
+    }
+    else {
+        envLines.push(`OPC_LLM_API_KEY=${llmApiKey || 'your-api-key-here'}`);
+        envLines.push(`OPC_LLM_BASE_URL=${llmBaseUrl}`);
+        envLines.push(`OPC_LLM_MODEL=${llmModel}`);
+    }
+    fs.writeFileSync(path.join(dir, '.env'), envLines.join('\n') + '\n');
     // package.json
     fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({
         name,
@@ -520,7 +665,7 @@ OPC_LLM_MODEL=gpt-4o-mini
 WORKDIR /app
 COPY package.json package-lock.json* ./
 RUN npm ci --production 2>/dev/null || npm install --production
-COPY oad.yaml agent.yaml .env* ./
+COPY oad.yaml .env* ./
 COPY src/ ./src/
 COPY prompts/ ./prompts/ 2>/dev/null || true
 EXPOSE 3000
@@ -536,7 +681,7 @@ services:
     env_file:
       - .env
     volumes:
-      - ./agent.yaml:/app/agent.yaml:ro
+      - ./oad.yaml:/app/oad.yaml:ro
     restart: unless-stopped
 `);
     // README.md
@@ -577,8 +722,7 @@ npx opc chat   # CLI chat
 
 \`\`\`
 ${name}/
-├── agent.yaml          # OAD agent config (used by src/index.ts)
-├── oad.yaml            # OAD config (used by opc CLI)
+├── oad.yaml            # Agent 配置 (唯一配置文件)
 ├── src/
 │   ├── index.ts        # Entry point
 │   └── skills/
@@ -589,9 +733,9 @@ ${name}/
 
 ## Configuration
 
-Edit \`agent.yaml\` to customize your agent's personality, skills, and behavior.
+Edit \`oad.yaml\` to customize your agent's personality, skills, and behavior.
 `);
-    // SOUL.md — agent personality
+    // SOUL.md - agent personality
     const createdDate = new Date().toISOString().split('T')[0];
     fs.writeFileSync(path.join(dir, 'SOUL.md'), `# ${name} Personality
 
@@ -607,7 +751,7 @@ Edit \`agent.yaml\` to customize your agent's personality, skills, and behavior.
 
 ## Communication Style
 - Use clear, simple language
-- Be direct — answer the question first, then explain
+- Be direct - answer the question first, then explain
 - Use markdown formatting when helpful
 
 ## Rules
@@ -615,7 +759,7 @@ Edit \`agent.yaml\` to customize your agent's personality, skills, and behavior.
 - Ask for clarification when the request is ambiguous
 - Never make up information
 `);
-    // CONTEXT.md — project context
+    // CONTEXT.md - project context
     fs.writeFileSync(path.join(dir, 'CONTEXT.md'), `# Project Context
 
 ## About This Agent
@@ -631,7 +775,8 @@ on startup to understand the project context.
 - Add company policies here
 `);
     console.log(`\n${icon.success} Created agent project: ${color.bold(name + '/')}`);
-    console.log(`   ${icon.file} agent.yaml       - Agent definition (OAD)`);
+    console.log(`   ${icon.file} oad.yaml         - Agent 配置 (${llmProvider}/${llmModel})`);
+    console.log(`   ${icon.file} .env             - 环境变量${llmProvider === 'ollama' ? '' : ' (API Key)'}`);
     console.log(`   ${icon.file} src/index.ts     - Entry point`);
     console.log(`   ${icon.file} src/skills/echo.ts - Example skill`);
     console.log(`   ${icon.file} SOUL.md          - Agent personality`);
@@ -656,178 +801,37 @@ on startup to understand the project context.
             }
         }
         catch {
-            // Brain-seed download failed — non-fatal, project still usable
+            // Brain-seed download failed - non-fatal, project still usable
         }
     }
     console.log(`\n${color.bold('Next steps:')}`);
     console.log(`   1. cd ${name}`);
     console.log(`   2. npm install`);
-    console.log(`   3. npx tsx src/index.ts   ${color.dim('# or: npx opc run')}`);
-    console.log(`   4. Open http://localhost:3000\n`);
+    if (llmProvider === 'ollama' && !ollamaRunning) {
+        console.log(`   3. ollama pull ${llmModel}   ${color.dim('# 下载模型')}`);
+        console.log(`   4. npx opc run              ${color.dim('# 启动 Agent')}`);
+    }
+    else if (llmProvider !== 'ollama' && !llmApiKey) {
+        console.log(`   3. 编辑 .env 设置 OPC_LLM_API_KEY`);
+        console.log(`   4. npx opc run`);
+    }
+    else {
+        console.log(`   3. npx opc run              ${color.dim('# 启动 Agent')}`);
+    }
+    console.log(`   Open http://localhost:3000\n`);
     console.log(`${color.dim('💡 Tip: Use --role to start from a workstation template:')}`);
     console.log(`${color.dim('   opc init my-agent --role customer-service')}`);
     console.log(`${color.dim('   opc init --list-roles  (see all roles)')}\n`);
 });
 // ── Chat command ─────────────────────────────────────────────
+const chat_1 = require("./cli/chat");
 program
     .command('chat')
-    .description('Interactive CLI chat with the agent')
+    .description('Interactive TUI chat with the agent')
     .option('-f, --file <file>', 'OAD file', 'oad.yaml')
     .action(async (opts) => {
-    // Load .env if present
     loadDotEnv();
-    let systemPrompt = 'You are a helpful AI agent.';
-    let model;
-    let agentName = 'Agent';
-    let agentVersion = '1.0.0';
-    let providerName = 'auto';
-    let skillNames = [];
-    // Try loading SOUL.md and CONTEXT.md for enriched system prompt
-    const soulPath = path.resolve('SOUL.md');
-    const contextPath = path.resolve('CONTEXT.md');
-    const soulContent = fs.existsSync(soulPath) ? fs.readFileSync(soulPath, 'utf-8') : '';
-    const contextContent = fs.existsSync(contextPath) ? fs.readFileSync(contextPath, 'utf-8') : '';
-    try {
-        const raw = fs.readFileSync(opts.file, 'utf-8');
-        const config = yaml.load(raw);
-        if (config?.spec?.systemPrompt)
-            systemPrompt = config.spec.systemPrompt;
-        if (config?.spec?.model)
-            model = config.spec.model;
-        if (config?.metadata?.name)
-            agentName = config.metadata.name;
-        if (config?.metadata?.version)
-            agentVersion = config.metadata.version;
-        if (config?.spec?.provider?.default)
-            providerName = config.spec.provider.default;
-        if (config?.spec?.skills)
-            skillNames = config.spec.skills.map((s) => s.name);
-    }
-    catch {
-        // No config file, use defaults
-    }
-    // Prepend SOUL.md and CONTEXT.md to system prompt
-    systemPrompt = [soulContent, contextContent, systemPrompt].filter(Boolean).join('\n\n');
-    const provider = (0, providers_1.createProvider)(providerName, model);
-    const history = [];
-    // Print startup banner
-    const bannerLines = [
-        '╔══════════════════════════════════════╗',
-        '║  🤖 OPC Agent — Interactive Chat     ║',
-        `║  Agent: ${(agentName + ' v' + agentVersion).padEnd(27)}║`,
-        `║  Model: ${((providerName + '/' + (model ?? 'default')).slice(0, 27)).padEnd(27)}║`,
-        `║  Skills: ${(String(skillNames.length) + ' loaded').padEnd(26)}║`,
-        '║  Type /help for commands             ║',
-        '╚══════════════════════════════════════╝',
-    ];
-    console.log('\n' + color.cyan(bannerLines.join('\n')) + '\n');
-    if (soulContent)
-        console.log(`  ${icon.info} Loaded SOUL.md`);
-    if (contextContent)
-        console.log(`  ${icon.info} Loaded CONTEXT.md`);
-    if (soulContent || contextContent)
-        console.log();
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        historySize: 100,
-    });
-    const handleSlashCommand = (cmd) => {
-        const lower = cmd.toLowerCase().trim();
-        if (lower === '/quit' || lower === '/exit') {
-            console.log(`\n${color.dim('Goodbye! 👋')}`);
-            process.exit(0);
-        }
-        if (lower === '/help') {
-            console.log(`\n  ${color.bold('Available commands:')}`);
-            console.log(`  ${color.cyan('/help')}    — Show this help`);
-            console.log(`  ${color.cyan('/quit')}    — Exit chat (/exit also works)`);
-            console.log(`  ${color.cyan('/clear')}   — Clear conversation history`);
-            console.log(`  ${color.cyan('/skills')}  — List registered skills`);
-            console.log(`  ${color.cyan('/memory')}  — Show memory stats`);
-            console.log(`  ${color.cyan('/info')}    — Show agent info\n`);
-            return true;
-        }
-        if (lower === '/clear') {
-            history.length = 0;
-            console.log(`\n  ${icon.success} Conversation history cleared.\n`);
-            return true;
-        }
-        if (lower === '/skills') {
-            if (skillNames.length === 0) {
-                console.log(`\n  ${icon.info} No skills registered.\n`);
-            }
-            else {
-                console.log(`\n  ${color.bold('Registered skills:')}`);
-                skillNames.forEach((s) => console.log(`  • ${color.cyan(s)}`));
-                console.log();
-            }
-            return true;
-        }
-        if (lower === '/memory') {
-            console.log(`\n  ${color.bold('Memory stats:')}`);
-            console.log(`  Messages in history: ${color.cyan(String(history.length))}`);
-            console.log(`  Characters: ${color.cyan(String(history.reduce((a, m) => a + m.content.length, 0)))}\n`);
-            return true;
-        }
-        if (lower === '/info') {
-            console.log(`\n  ${color.bold('Agent Info:')}`);
-            console.log(`  Name:     ${color.cyan(agentName)}`);
-            console.log(`  Version:  ${color.cyan(agentVersion)}`);
-            console.log(`  Provider: ${color.cyan(providerName)}`);
-            console.log(`  Model:    ${color.cyan(model ?? 'default')}`);
-            console.log(`  Skills:   ${color.cyan(String(skillNames.length))}\n`);
-            return true;
-        }
-        return false;
-    };
-    const ask = () => {
-        rl.question(color.cyan('You: '), async (input) => {
-            const text = input.trim();
-            if (!text) {
-                ask();
-                return;
-            }
-            // Handle slash commands
-            if (text.startsWith('/') && handleSlashCommand(text)) {
-                ask();
-                return;
-            }
-            history.push({ role: 'user', content: text });
-            // Build messages for provider
-            const messages = history.map((m) => ({
-                id: 'x',
-                role: m.role,
-                content: m.content,
-                timestamp: Date.now(),
-            }));
-            process.stdout.write(color.green('Agent: '));
-            let full = '';
-            try {
-                for await (const chunk of provider.chatStream(messages, systemPrompt)) {
-                    process.stdout.write(chunk);
-                    full += chunk;
-                }
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                process.stdout.write(color.red(`\n[Error: ${msg}]`));
-                full = `[Error: ${msg}]`;
-            }
-            console.log('\n');
-            history.push({ role: 'assistant', content: full });
-            // Trim history if too long (keep last 40 messages)
-            if (history.length > 40) {
-                history.splice(0, history.length - 40);
-            }
-            ask();
-        });
-    };
-    rl.on('close', () => {
-        console.log(`\n${color.dim('Goodbye! 👋')}`);
-        process.exit(0);
-    });
-    ask();
+    await (0, chat_1.runChat)({ file: opts.file });
 });
 // ── Run command ──────────────────────────────────────────────
 program
@@ -858,6 +862,8 @@ program
         console.log(`   ${color.dim('Studio:')}  ${studioUrl}`);
     console.log(`   ${color.dim('API:')}     POST http://localhost:3000/api/chat`);
     console.log(`\n   ${color.dim('Press Ctrl+C to stop.')}\n`);
+    // Keep the process alive — HTTP server refs may not suffice with Commander
+    await new Promise(() => { });
 });
 // ── Serve command (OpenAI-compatible API) ────────────────────
 program
@@ -894,6 +900,8 @@ program
     console.log(`     GET  /health`);
     console.log(`     GET  /v1/agent/status`);
     console.log(`\n   ${color.dim('Press Ctrl+C to stop.')}\n`);
+    // Keep the process alive
+    await new Promise(() => { });
 });
 // ── Info command ─────────────────────────────────────────────
 program
@@ -1460,7 +1468,7 @@ protocolCmd.command('list')
     const protocols = config?.spec?.protocols || {};
     const items = [
         { name: 'a2a', description: 'Agent-to-Agent protocol', enabled: !!protocols.a2a?.enabled, detail: protocols.a2a?.port ? `port ${protocols.a2a.port}` : '' },
-        { name: 'agui', description: 'AG-UI — Agent-User Interaction (SSE)', enabled: !!protocols.agui?.enabled, detail: protocols.agui?.path || '/agui' },
+        { name: 'agui', description: 'AG-UI - Agent-User Interaction (SSE)', enabled: !!protocols.agui?.enabled, detail: protocols.agui?.path || '/agui' },
     ];
     console.log(`\n${icon.gear} ${color.bold('Protocols')}\n`);
     for (const p of items) {
@@ -1590,43 +1598,29 @@ const brainCmd = program
     .description('Manage agent brain (memory, seeds, evolve)');
 brainCmd
     .command('status')
-    .description('Show brain stats (pages, tiers, last evolve)')
-    .option('--url <url>', 'DeepBrain server URL', 'http://localhost:3333')
-    .action(async (opts) => {
-    console.log(`\n${icon.gear} ${color.bold('DeepBrain Status')} — ${color.dim(opts.url)}\n`);
+    .description('Show brain stats (knowledge tiers, evolve history)')
+    .action(async () => {
+    console.log(`\n${icon.gear} ${color.bold('Knowledge Brain Status')}\n`);
     try {
-        const res = await fetch(`${opts.url}/api/stats`);
-        if (!res.ok)
-            throw new Error(`HTTP ${res.status} ${res.statusText}`);
-        const stats = (await res.json());
-        const rows = [
-            ['Total Pages', String(stats.totalPages ?? stats.pages ?? '-')],
-            ['Total Chunks', String(stats.totalChunks ?? stats.chunks ?? '-')],
-            ['Memory Tiers', String(stats.memoryTiers ?? stats.tiers ?? '-')],
-            ['Index Size', stats.indexSize ?? '-'],
-            ['Last Updated', stats.lastUpdated ?? stats.updatedAt ?? '-'],
-        ];
-        const maxKey = Math.max(...rows.map(([k]) => k.length));
-        for (const [key, val] of rows) {
-            console.log(`  ${color.cyan(key.padEnd(maxKey))}  ${val}`);
-        }
+        const { KnowledgeEvolveEngine } = require('./memory/evolve-engine');
+        const engine = new KnowledgeEvolveEngine(process.cwd());
+        const model = await engine.detectLocalModel();
+        const stats = engine.getStats();
+        console.log(`  ${color.cyan('Evolve Model'.padEnd(16))}  ${model} (local, free)`);
+        console.log(`  ${color.cyan('Workstation'.padEnd(16))}  ${stats.workstation} pages`);
+        console.log(`  ${color.cyan('Job'.padEnd(16))}  ${stats.job} pages`);
+        console.log(`  ${color.cyan('Industry'.padEnd(16))}  ${stats.industry} pages`);
+        console.log(`  ${color.cyan('Last Evolve'.padEnd(16))}  ${stats.lastEvolve || 'never'}`);
         console.log();
     }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (msg.includes('ECONNREFUSED') || msg.includes('fetch failed')) {
-            console.log(`  ${icon.warn} Cannot connect to DeepBrain at ${opts.url}`);
-            console.log(`  ${color.dim('Is the server running? Start with: deepbrain serve')}\n`);
-        }
-        else {
-            console.error(`  ${icon.error} ${msg}\n`);
-        }
+    catch (e) {
+        console.log(`  ${icon.warn} ${e.message}\n`);
     }
 });
 brainCmd
     .command('seed')
     .description('Import brain seed files into memory')
-    .option('-f, --file <file>', 'OAD file', 'agent.yaml')
+    .option('-f, --file <file>', 'OAD file', 'oad.yaml')
     .option('--status', 'Check if seeds have been imported')
     .option('--reset', 'Re-import seeds (clear marker and re-seed)')
     .action(async (opts) => {
@@ -1679,29 +1673,32 @@ brainCmd
 });
 brainCmd
     .command('evolve')
-    .description('Trigger manual knowledge evolution cycle')
-    .option('--dry-run', 'Show what would be promoted without doing it')
+    .description('Trigger manual knowledge evolution cycle (uses local Ollama model)')
+    .option('--dry-run', 'Show stats without evolving')
     .action(async (opts) => {
-    const { KnowledgeEvolver } = require('./memory/seed-loader');
-    const evolver = new KnowledgeEvolver();
-    console.log(`\n${icon.gear} ${color.bold('Knowledge Evolution')}\n`);
-    console.log(`  ${icon.info} Checking for promotion candidates...`);
-    // Would connect to real brain in production
-    const result = await evolver.checkPromotion(null);
-    if (result.candidates.length === 0) {
-        console.log(`  ${icon.info} No knowledge ready for promotion yet.\n`);
+    const { KnowledgeEvolveEngine } = require('./memory/evolve-engine');
+    const engine = new KnowledgeEvolveEngine(process.cwd());
+    console.log(`\n${icon.gear} ${color.bold('Knowledge Evolution')} ${color.dim('(local Ollama model, zero cost)')}\n`);
+    const model = await engine.detectLocalModel();
+    console.log(`  Model: ${color.cyan(model)}`);
+    const stats = engine.getStats();
+    console.log(`  Knowledge pages: workstation=${stats.workstation} job=${stats.job} industry=${stats.industry}`);
+    if (stats.lastEvolve)
+        console.log(`  Last evolve: ${stats.lastEvolve}`);
+    if (opts.dryRun) {
+        console.log(`\n  ${icon.info} Dry run — no changes.\n`);
+        return;
     }
-    else {
-        for (const c of result.candidates) {
-            console.log(`  ${color.cyan(c.slug)} → ${c.fromTier} → ${c.toTier} (confidence: ${(c.confidence * 100).toFixed(0)}%)`);
-        }
-        if (opts.dryRun) {
-            console.log(`\n  ${icon.info} Dry run — no changes made.\n`);
-        }
-        else {
-            console.log(`\n  ${icon.success} Promoted ${result.promoted} knowledge entries.\n`);
-        }
+    console.log(`\n  ${icon.info} Running evolve cycle...`);
+    const result = await engine.evolve();
+    console.log(`  ${icon.success} Extracted: ${result.extracted}, Deduplicated: ${result.deduplicated}, Promoted: ${result.promoted}`);
+    if (result.compacted)
+        console.log(`  ${icon.success} Memory compacted (refined & written back)`);
+    if (result.errors.length > 0) {
+        for (const e of result.errors)
+            console.log(`  ${icon.warn} ${e}`);
     }
+    console.log();
 });
 // ── Logs command ─────────────────────────────────────────────
 program
@@ -2145,7 +2142,7 @@ program
         return;
     }
     // Create a minimal mock agent for eval (real usage would load from OAD)
-    const oadPath = path.resolve('agent.yaml');
+    const oadPath = path.resolve(fs.existsSync('oad.yaml') ? 'oad.yaml' : 'agent.yaml');
     let agent;
     if (fs.existsSync(oadPath)) {
         const runtime = new runtime_1.AgentRuntime();
@@ -2154,7 +2151,7 @@ program
         agent = runtime.agent;
     }
     if (!agent) {
-        console.log(`${icon.warn} No agent.yaml found — running with dry-run mock agent.`);
+        console.log(`${icon.warn} No oad.yaml or agent.yaml found - running with dry-run mock agent.`);
         agent = { chat: async (input) => `[mock response to: ${input}]` };
     }
     const evaluator = new eval_1.AgentEvaluator(agent);
@@ -2214,7 +2211,7 @@ guardrailsCmd
     console.log();
     const result = await manager.checkInput(message);
     if (result.passed) {
-        console.log(color.green('✓ PASSED — no violations'));
+        console.log(color.green('✓ PASSED - no violations'));
     }
     else {
         if (result.blocked)
@@ -2243,7 +2240,7 @@ program
     .action(async (opts) => {
     console.log(color.bold('🎤 Voice Conversation Mode'));
     console.log(`  STT: ${opts.stt} | TTS: ${opts.tts} | Voice: ${opts.voice ?? 'default'} | Language: ${opts.language}`);
-    console.log(color.dim('  (Voice conversation requires audio input integration — use as library)'));
+    console.log(color.dim('  (Voice conversation requires audio input integration - use as library)'));
     console.log();
     console.log('To use voice in your agent:');
     console.log(color.cyan(`
@@ -2260,7 +2257,101 @@ program
   await voice.start();
 `));
 });
-program.parse();
+// ── Models command ──────────────────────────────────────────────
+program
+    .command('models')
+    .description('Show recommended Ollama models for your system')
+    .option('--refresh', 'Force refresh model list from remote')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    if (opts.refresh) {
+        (0, model_recommender_1.clearModelCache)();
+        console.log(`${icon.success} 模型推荐缓存已清除`);
+    }
+    const sys = (0, model_recommender_1.detectSystem)();
+    const models = await (0, model_recommender_1.fetchModelList)();
+    const cache = (0, model_recommender_1.cacheInfo)();
+    // Detect Ollama
+    let installedModels = [];
+    try {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 3000);
+        const res = await fetch('http://localhost:11434/api/tags', { signal: ctrl.signal });
+        clearTimeout(t);
+        const data = await res.json();
+        installedModels = (data.models || []).map((m) => m.name || m.model);
+    }
+    catch { /* Ollama not running */ }
+    const rec = (0, model_recommender_1.recommendModels)(models, sys, installedModels);
+    if (opts.json) {
+        console.log(JSON.stringify({ system: sys, cache, recommendation: rec }, null, 2));
+        return;
+    }
+    console.log(`\n${icon.rocket} ${color.bold('OPC 模型推荐')}\n`);
+    console.log(`  系统: ${sys.totalRAM}GB RAM (${sys.freeRAM}GB 可用), ${sys.cpuCount} cores, ${sys.platform}/${sys.arch}`);
+    if (cache.exists) {
+        console.log(`  推荐列表: v${cache.version} (${cache.age})`);
+    }
+    else {
+        console.log(`  推荐列表: 内置 (运行 ${color.cyan('opc models --refresh')} 获取最新)`);
+    }
+    console.log(`  Ollama: ${installedModels.length > 0 ? color.green(`运行中, ${installedModels.length} 个模型`) : color.yellow('未运行')}`);
+    console.log(`\n  ${color.bold('⭐ 推荐:')} ${color.cyan(rec.best.name)} (${rec.best.size}) - ${rec.best.desc}\n`);
+    // Table
+    console.log(`  ${'模型'.padEnd(28)} ${'大小'.padEnd(8)} ${'最低RAM'.padEnd(8)} ${'状态'.padEnd(10)} 说明`);
+    console.log(`  ${'─'.repeat(28)} ${'─'.repeat(8)} ${'─'.repeat(8)} ${'─'.repeat(10)} ${'─'.repeat(20)}`);
+    for (const m of rec.suitable) {
+        const installed = installedModels.includes(m.name);
+        const isBest = m.name === rec.best.name;
+        const status = installed ? color.green('已安装') : color.dim('未安装');
+        const star = isBest ? ' ⭐' : (m.recommended ? ' 💎' : '');
+        console.log(`  ${(m.name + star).padEnd(28)} ${m.size.padEnd(8)} ${(m.minRAM + 'GB').padEnd(8)} ${status.padEnd(10)} ${m.desc}`);
+    }
+    if (rec.toDownload.length > 0) {
+        console.log(`\n  ${color.bold('推荐下载:')}`);
+        for (const m of rec.toDownload) {
+            console.log(`  ${color.cyan(`ollama pull ${m.name}`)}  (${m.size}, ${m.desc})`);
+        }
+    }
+    console.log();
+});
+// ── Search command ──────────────────────────────────────────
+program
+    .command('memory-search <query>')
+    .description('Search conversation history (requires SQLite memory)')
+    .option('-n, --limit <n>', 'Max results', '10')
+    .option('--json', 'Output as JSON')
+    .action(async (query, opts) => {
+    try {
+        const { SQLiteStore } = await Promise.resolve().then(() => __importStar(require('./memory/sqlite-store')));
+        const store = new SQLiteStore();
+        const results = await store.search(query, parseInt(opts.limit, 10));
+        const stats = await store.stats();
+        if (opts.json) {
+            console.log(JSON.stringify({ query, results, stats }, null, 2));
+            await store.close();
+            return;
+        }
+        console.log(`\n🔍 搜索: "${query}" (${results.length} 条结果, 共 ${stats.totalMessages} 条消息)\n`);
+        if (results.length === 0) {
+            console.log('  未找到匹配结果。\n');
+            await store.close();
+            return;
+        }
+        for (const msg of results) {
+            const time = new Date(msg.timestamp).toLocaleString();
+            const role = msg.role === 'user' ? '👤' : '🤖';
+            const preview = msg.content.length > 120 ? msg.content.slice(0, 120) + '...' : msg.content;
+            console.log(`  ${role} [${time}] ${preview}`);
+        }
+        console.log(`\n  💾 数据库: ${stats.dbSizeKB}KB, ${stats.sessions} 个会话\n`);
+        await store.close();
+    }
+    catch (err) {
+        console.error(`${icon.error} 搜索失败: ${err instanceof Error ? err.message : err}`);
+        console.log('  提示: 需要 sql.js 支持。运行: npm install sql.js');
+    }
+});
 // ── Keys command ──────────────────────────────────────────────
 const keys_1 = require("./security/keys");
 const approval_1 = require("./security/approval");
@@ -2307,7 +2398,7 @@ keysCmd
 });
 // ── Approve command ───────────────────────────────────────────
 const approveCmd = program.command('approve').description('Manage command approvals');
-// Singleton for CLI — in real usage this would be loaded from daemon state
+// Singleton for CLI - in real usage this would be loaded from daemon state
 const approvalManager = new approval_1.ApprovalManager();
 approveCmd
     .command('list')
@@ -2439,7 +2530,7 @@ a2aCmd
     const { oadToAgentCard } = require('./protocols/a2a');
     const oad = loadOADFile();
     if (!oad) {
-        console.log(`${icon.error} No agent.yaml found`);
+        console.log(`${icon.error} No oad.yaml or agent.yaml found`);
         return;
     }
     const card = oadToAgentCard(oad, 'http://localhost:3001');
@@ -2479,7 +2570,7 @@ a2aCmd
 function loadOADFile() {
     const fs = require('fs');
     const yaml = require('js-yaml');
-    for (const name of ['agent.yaml', 'agent.yml']) {
+    for (const name of ['oad.yaml', 'agent.yaml', 'agent.yml']) {
         if (fs.existsSync(name)) {
             return yaml.load(fs.readFileSync(name, 'utf-8'));
         }
@@ -2487,7 +2578,7 @@ function loadOADFile() {
     return null;
 }
 // ── MCP Server Commands ────────────────────────────────────
-const mcpCmd = program.command('mcp').description('MCP server commands — expose agent as MCP tools');
+const mcpCmd = program.command('mcp').description('MCP server commands - expose agent as MCP tools');
 mcpCmd
     .command('serve')
     .option('--http <port>', 'Start HTTP+SSE mode on given port')
@@ -2516,7 +2607,7 @@ mcpCmd
         console.log(`${icon.info} Tools: ${server.getToolCount()}`);
     }
     else {
-        console.error(`${icon.success} MCP server (stdio) started — ${server.getToolCount()} tools`);
+        console.error(`${icon.success} MCP server (stdio) started - ${server.getToolCount()} tools`);
         await server.serveStdio();
     }
 });
@@ -2565,8 +2656,10 @@ mcpCmd
         console.log(`${icon.info} Tools: ${server.getToolCount()}`);
     }
     else {
-        console.error(`${icon.success} MCP server ${color.cyan(name)} (stdio) — ${server.getToolCount()} tools`);
+        console.error(`${icon.success} MCP server ${color.cyan(name)} (stdio) - ${server.getToolCount()} tools`);
         await server.serveStdio();
     }
 });
+// ── Parse CLI ────────────────────────────────────────────────
+program.parse();
 //# sourceMappingURL=cli.js.map