opc-agent 4.2.13 → 5.0.0-rc.1

package/dist/cli.js

@@ -244,6 +244,10 @@ spec:
         // CONTEXT.md
         const readmeContent = roleData.files['README.md'] || '';
         fs.writeFileSync(path.join(dir, 'CONTEXT.md'), `# Project Context\n\n## Role: ${roleDisplayName}\n\n${readmeContent}\n`);
+        // .opc/ directory — runtime state
+        fs.mkdirSync(path.join(dir, '.opc'), { recursive: true });
+        // DEEPBRAIN.md — long-term memory seed
+        fs.writeFileSync(path.join(dir, 'DEEPBRAIN.md'), `# DeepBrain Memory\n\nThis file seeds the agent's long-term knowledge store.\n`);
         // data/brain-seed.md if available
         if (roleData.files['brain-seed.md']) {
             fs.writeFileSync(path.join(dir, 'data', 'brain-seed.md'), roleData.files['brain-seed.md']);
@@ -385,13 +389,30 @@ export class EchoSkill extends BaseSkill {
         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)
+        if (opts.yes) {
+            const yesRec = (0, model_recommender_1.recommendModels)(allModels, sys, modelNames);
+            const bestInstalled = yesRec.installed.length > 0 ? yesRec.installed[yesRec.installed.length - 1] : null;
             const chatModels = modelNames.filter(m => !m.includes('embed'));
-            llmModel = bestInstalled ? bestInstalled.name : (chatModels[0] || 'qwen2.5:7b');
+            if (bestInstalled) {
+                llmModel = bestInstalled.name;
+            }
+            else if (chatModels.length > 0) {
+                llmModel = chatModels[0];
+            }
+            else {
+                // No suitable model installed — auto-pull the recommended one
+                console.log(`\n  ${icon.info} 系统: ${sys.totalRAM}GB RAM, ${sys.cpuCount} 核 CPU`);
+                console.log(`  ${icon.info} 推荐模型未安装，正在下载 ${color.cyan(yesRec.best.name)} (${yesRec.best.size})...`);
+                await new Promise((resolve) => {
+                    const child = (0, child_process_1.spawn)('ollama', ['pull', yesRec.best.name], { stdio: 'inherit' });
+                    child.on('close', () => resolve());
+                    child.on('error', () => {
+                        console.log(`  ${color.yellow('⚠️')}  下载失败，稍后手动运行: ollama pull ${yesRec.best.name}`);
+                        resolve();
+                    });
+                });
+                llmModel = yesRec.best.name;
+            }
         }
     }
     catch {
@@ -432,8 +453,14 @@ export class EchoSkill extends BaseSkill {
                     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`);
+                        await new Promise((resolve) => {
+                            const child = (0, child_process_1.spawn)('ollama', ['pull', pullModel], { stdio: 'inherit' });
+                            child.on('close', () => resolve());
+                            child.on('error', () => {
+                                console.log(`  ${color.yellow('⚠️')}  下载失败，稍后手动运行: ollama pull ${pullModel}`);
+                                resolve();
+                            });
+                        });
                         llmModel = pullModel;
                     }
                     else {
@@ -774,6 +801,18 @@ on startup to understand the project context.
 - Add domain knowledge here
 - Add FAQ items here
 - Add company policies here
+`);
+    // .opc/ directory — runtime state (brain DB, cache, etc.)
+    fs.mkdirSync(path.join(dir, '.opc'), { recursive: true });
+    // DEEPBRAIN.md — long-term memory seed (compat with MEMORY.md)
+    fs.writeFileSync(path.join(dir, 'DEEPBRAIN.md'), `# DeepBrain Memory
+
+This file seeds the agent's long-term knowledge store (DeepBrain).
+Add knowledge entries below — they will be loaded on first run.
+
+## Core Knowledge
+
+<!-- Add domain knowledge, FAQs, policies, etc. here -->
 `);
     console.log(`\n${icon.success} Created agent project: ${color.bold(name + '/')}`);
     console.log(`   ${icon.file} oad.yaml         - Agent 配置 (${llmProvider}/${llmModel})`);
@@ -782,6 +821,8 @@ on startup to understand the project context.
     console.log(`   ${icon.file} src/skills/echo.ts - Example skill`);
     console.log(`   ${icon.file} SOUL.md          - Agent personality`);
     console.log(`   ${icon.file} CONTEXT.md       - Project context`);
+    console.log(`   ${icon.file} DEEPBRAIN.md     - Long-term memory seed`);
+    console.log(`   ${icon.file} .opc/            - Runtime state directory`);
     console.log(`   ${icon.file} package.json     - Dependencies`);
     console.log(`   ${icon.file} tsconfig.json    - TypeScript config`);
     console.log(`   ${icon.file} .env.example     - Environment template`);
@@ -840,6 +881,7 @@ program
     .description('Start agent with web server')
     .option('-f, --file <file>', 'OAD file', 'oad.yaml')
     .option('-p, --port <port>', 'Port override')
+    .option('-c, --channel <channel>', 'Extra channel to activate (e.g. telegram)')
     .action(async (opts) => {
     loadDotEnv();
     const runtime = new runtime_1.AgentRuntime();
@@ -847,6 +889,25 @@ program
     await runtime.initialize();
     await runtime.start();
     const agent = runtime.getAgent();
+    // Start extra channel requested via --channel flag
+    if (opts.channel === 'telegram') {
+        const cfg = runtime.getConfig();
+        const tgInConfig = cfg?.spec?.channels?.find((c) => c.type === 'telegram');
+        // Only start manually if NOT already handled by runtime (i.e. not in oad.yaml channels list)
+        if (!tgInConfig) {
+            const token = process.env.TELEGRAM_BOT_TOKEN ?? '';
+            if (!token) {
+                console.warn('[telegram] No token found. Set TELEGRAM_BOT_TOKEN or add telegram to oad.yaml channels. Skipping.');
+            }
+            else {
+                const { TelegramChannel } = require('./channels/telegram');
+                const tg = new TelegramChannel({ token });
+                tg.onMessage((msg) => agent.handleMessage(msg));
+                await tg.start();
+                console.log(`   ${color.dim('Telegram:')} bot polling started`);
+            }
+        }
+    }
     // Auto-start Studio on port 4000
     let studioUrl = '';
     try {
@@ -1532,65 +1593,89 @@ protocolCmd.command('disable')
 // 🔄 Migrate command ────────────────────────────────────────
 program
     .command('migrate')
-    .description('Migrate OAD to latest schema version')
+    .description('Migrate project: MEMORY.md → DEEPBRAIN.md and OAD to latest schema')
     .option('-f, --file <file>', 'OAD file', 'oad.yaml')
     .option('--dry-run', 'Show changes without writing')
+    .option('--schema-only', 'Only migrate OAD schema (skip MEMORY.md → DEEPBRAIN.md)')
     .action(async (opts) => {
+    // Step 1: MEMORY.md → DEEPBRAIN.md migration
+    if (!opts.schemaOnly) {
+        console.log(`\n${icon.gear} ${color.bold('DeepBrain Migration')} (MEMORY.md → DEEPBRAIN.md)\n`);
+        try {
+            if (opts.dryRun) {
+                const memExists = fs.existsSync(path.join(process.cwd(), 'MEMORY.md'));
+                const soulExists = fs.existsSync(path.join(process.cwd(), 'SOUL.md'));
+                const dbExists = fs.existsSync(path.join(process.cwd(), '.opc', 'brain.db'));
+                console.log(`  MEMORY.md:    ${memExists ? color.cyan('found — would migrate to DEEPBRAIN.md') : color.dim('not found')}`);
+                console.log(`  SOUL.md:      ${soulExists ? color.cyan('found — would migrate to EGO.md') : color.dim('not found')}`);
+                console.log(`  .opc/brain.db:${dbExists ? color.dim(' already exists') : color.cyan(' would create')}`);
+                console.log(`\n  ${icon.info} Dry run — no changes.\n`);
+            }
+            else {
+                const { migrate: deepbrainMigrate } = require('./deepbrain/migrate');
+                await deepbrainMigrate(process.cwd());
+                console.log(`  ${icon.success} MEMORY.md → DEEPBRAIN.md migration complete.`);
+                console.log(`  ${icon.success} SOUL.md → EGO.md migration complete.`);
+                console.log(`  ${icon.success} Knowledge seeded into .opc/brain.db.\n`);
+            }
+        }
+        catch (e) {
+            console.log(`  ${icon.warn} DeepBrain migration: ${e.message}\n`);
+        }
+    }
+    // Step 2: OAD schema migration
+    console.log(`${icon.gear} ${color.bold('OAD Schema Migration')}\n`);
     try {
         const raw = fs.readFileSync(opts.file, 'utf-8');
         const config = yaml.load(raw);
         let changed = false;
-        // Migration: add apiVersion if missing
         if (!config.apiVersion) {
             config.apiVersion = 'opc/v1';
             changed = true;
         }
-        // Migration: add kind if missing
         if (!config.kind) {
             config.kind = 'Agent';
             changed = true;
         }
-        // Migration: ensure metadata.version
         if (!config.metadata?.version) {
             if (!config.metadata)
                 config.metadata = {};
             config.metadata.version = '1.0.0';
             changed = true;
         }
-        // Migration: ensure spec.channels is array
         if (config.spec?.channels && !Array.isArray(config.spec.channels)) {
             config.spec.channels = [config.spec.channels];
             changed = true;
         }
-        // Migration: ensure spec.skills is array
         if (config.spec?.skills && !Array.isArray(config.spec.skills)) {
             config.spec.skills = [config.spec.skills];
             changed = true;
         }
-        // Migration: old model format
         if (config.spec?.llm?.model && !config.spec?.model) {
             config.spec.model = config.spec.llm.model;
             delete config.spec.llm;
             changed = true;
         }
         if (!changed) {
-            console.log(`${icon.success} OAD is already up to date.`);
-            return;
+            console.log(`  ${icon.success} OAD is already up to date.\n`);
         }
-        if (opts.dryRun) {
-            console.log(`\n${icon.info} Would migrate:\n`);
+        else if (opts.dryRun) {
+            console.log(`  ${icon.info} Would migrate:\n`);
             console.log(yaml.dump(config, { lineWidth: 120 }));
         }
         else {
-            // Backup
             fs.writeFileSync(opts.file + '.bak', raw);
             fs.writeFileSync(opts.file, yaml.dump(config, { lineWidth: 120 }));
-            console.log(`${icon.success} Migrated ${color.bold(opts.file)} (backup: ${opts.file}.bak)`);
+            console.log(`  ${icon.success} Migrated ${color.bold(opts.file)} (backup: ${opts.file}.bak)\n`);
         }
     }
     catch (err) {
-        console.error(`${icon.error} Migration failed:`, err instanceof Error ? err.message : err);
-        process.exit(1);
+        if (err.code !== 'ENOENT') {
+            console.error(`  ${icon.error} OAD migration failed:`, err instanceof Error ? err.message : err);
+        }
+        else {
+            console.log(`  ${color.dim(`No OAD file found (${opts.file}) — skipping schema migration.`)}\n`);
+        }
     }
 });
 // ── Brain command ────────────────────────────────────────────
@@ -1701,6 +1786,58 @@ brainCmd
     }
     console.log();
 });
+brainCmd
+    .command('recall')
+    .argument('<query>', 'Search query')
+    .description('Query DeepBrain knowledge base')
+    .option('--top-k <n>', 'Number of results', '5')
+    .option('--layer <layer>', 'Filter by layer (l1/l2/l3/l4/workstation/job/industry)')
+    .action(async (query, opts) => {
+    console.log(`\n${icon.search} ${color.bold('DeepBrain Recall')} — ${color.cyan(query)}\n`);
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const result = await brain.recall({ query, topK: parseInt(opts.topK) || 5, layer: opts.layer });
+        if (result.entries.length === 0) {
+            console.log(`  ${icon.info} No results found.\n`);
+            return;
+        }
+        for (const entry of result.entries) {
+            console.log(`  ${color.cyan(`[${entry.layer}]`)} ${color.dim(entry.source)} — maturity: ${entry.maturityScore.toFixed(2)}`);
+            const preview = entry.content.length > 200 ? entry.content.slice(0, 200) + '…' : entry.content;
+            console.log(`  ${preview}`);
+            console.log();
+        }
+        console.log(`  ${color.dim(`${result.entries.length} result(s) in ${result.elapsedMs}ms`)}\n`);
+    }
+    catch (e) {
+        console.log(`  ${icon.warn} ${e.message}\n`);
+    }
+});
+brainCmd
+    .command('stats')
+    .description('Show DeepBrain knowledge base statistics')
+    .action(async () => {
+    console.log(`\n${icon.gear} ${color.bold('DeepBrain Stats')}\n`);
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const stats = await brain.getStats();
+        console.log(`  ${color.cyan('Total Entries'.padEnd(18))}  ${stats.totalEntries}`);
+        const layers = stats.entriesByLayer;
+        for (const [layer, count] of Object.entries(layers)) {
+            console.log(`  ${color.cyan(layer.padEnd(18))}  ${count}`);
+        }
+        console.log(`  ${color.cyan('Avg Maturity'.padEnd(18))}  ${(stats.avgMaturityScore ?? 0).toFixed(3)}`);
+        console.log(`  ${color.cyan('Last Evolution'.padEnd(18))}  ${stats.lastEvolution ?? 'never'}`);
+        console.log();
+    }
+    catch (e) {
+        console.log(`  ${icon.warn} ${e.message}\n`);
+    }
+});
 // ── Logs command ─────────────────────────────────────────────
 program
     .command('logs')
@@ -2049,65 +2186,16 @@ program
     .option('--port <port>', 'Port to listen on', '4000')
     .option('--no-open', 'Do not open browser automatically')
     .action(async (opts) => {
+    process.on('uncaughtException', (err) => {
+        console.error('[Studio] Uncaught exception:', err.message);
+    });
+    process.on('unhandledRejection', (err) => {
+        console.error('[Studio] Unhandled rejection:', err?.message || err);
+    });
     const { StudioServer } = require('./studio/server');
-    const net = require('net');
     const port = parseInt(opts.port, 10);
-    const checkPort = (p) => new Promise((resolve) => {
-        const sock = new net.Socket();
-        sock.setTimeout(400);
-        sock.once('connect', () => { sock.destroy(); resolve(true); });
-        sock.once('error', () => { sock.destroy(); resolve(false); });
-        sock.once('timeout', () => { sock.destroy(); resolve(false); });
-        sock.connect(p, 'localhost');
-    });
-    const server = new StudioServer({ port, agentDir: process.cwd() });
+    const server = new StudioServer({ port, agentDir: process.cwd(), openBrowser: opts.open !== false });
     await server.start();
-    // Try to start sub-module UI servers with graceful fallback
-    const subModules = [
-        { name: 'DeepBrain', icon: '🧠', pkg: 'deepbrain', port: 4001, serveMethod: 'serveUI' },
-        { name: 'AgentKits', icon: '📊', pkg: 'agentkits', port: 4002, serveMethod: 'serveUI' },
-        { name: 'Workstation', icon: '👤', pkg: 'agent-workstation', port: 4003, serveMethod: 'serveUI' },
-    ];
-    const moduleStatuses = [];
-    for (const mod of subModules) {
-        try {
-            const already = await checkPort(mod.port);
-            if (already) {
-                moduleStatuses.push(`  ${icon.success} ${mod.icon} ${mod.name} already running on :${mod.port}`);
-                continue;
-            }
-            const modExports = await dynamicImport(mod.pkg);
-            if (typeof modExports[mod.serveMethod] === 'function') {
-                modExports[mod.serveMethod]({ port: mod.port });
-                await new Promise(r => setTimeout(r, 600));
-                const started = await checkPort(mod.port);
-                moduleStatuses.push(started
-                    ? `  ${icon.success} ${mod.icon} ${mod.name} started on :${mod.port}`
-                    : `  ${icon.warn} ${mod.icon} ${mod.name} failed to start`);
-            }
-            else {
-                moduleStatuses.push(`  ${icon.success} ${mod.icon} ${mod.name} installed`);
-            }
-        }
-        catch {
-            moduleStatuses.push(`  ${color.dim('○')} ${mod.icon} ${mod.name} not installed (npm i ${mod.pkg})`);
-        }
-    }
-    if (moduleStatuses.length > 0) {
-        console.log('\nModules:');
-        moduleStatuses.forEach(s => console.log(s));
-    }
-    const url = `http://localhost:${port}`;
-    console.log(`\n${icon.success} OPC Studio ready → ${color.cyan(url)}`);
-    if (opts.open !== false) {
-        try {
-            const { exec } = require('child_process');
-            const openCmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start ""' : 'xdg-open';
-            exec(`${openCmd} ${url}`);
-        }
-        catch { }
-    }
-    console.log(color.dim('Press Ctrl+C to stop'));
 });
 program
     .command('doctor')
@@ -2316,43 +2404,6 @@ program
     }
     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");
@@ -2661,6 +2712,40 @@ mcpCmd
         await server.serveStdio();
     }
 });
+// ── Memory Search command ────────────────────────────────────
+program
+    .command('memory-search')
+    .argument('<query>', 'Search query')
+    .description('Search agent memory (DeepBrain knowledge base)')
+    .option('--top-k <n>', 'Number of results', '5')
+    .option('--json', 'Output as JSON')
+    .action(async (query, opts) => {
+    try {
+        const { DeepBrain } = require('./deepbrain/provider');
+        const brain = new DeepBrain({ dbPath: path.join(process.cwd(), '.opc', 'brain.db'), embeddingProvider: 'none' });
+        await brain.init();
+        const result = await brain.recall({ query, topK: parseInt(opts.topK) || 5 });
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`\n${icon.search} ${color.bold('Memory Search')} — ${color.cyan(query)}\n`);
+        if (result.entries.length === 0) {
+            console.log(`  ${icon.info} No results found.\n`);
+            return;
+        }
+        for (const entry of result.entries) {
+            console.log(`  ${color.cyan(`[${entry.layer}]`)} ${color.dim(entry.source)}`);
+            const preview = entry.content.length > 200 ? entry.content.slice(0, 200) + '…' : entry.content;
+            console.log(`  ${preview}\n`);
+        }
+        console.log(`  ${color.dim(`${result.entries.length} result(s) in ${result.elapsedMs}ms`)}\n`);
+    }
+    catch (e) {
+        console.error(`${icon.error} Memory search failed: ${e.message}`);
+        process.exit(1);
+    }
+});
 // ── Parse CLI ────────────────────────────────────────────────
 program.parse();
 //# sourceMappingURL=cli.js.map