opc-agent 1.3.2 → 1.4.0

package/src/cli.ts

@@ -27,9 +27,9 @@ import { WorkflowEngine } from './core/workflow';
 import { VersionManager } from './core/versioning';
 import { createProvider } from './providers';
 import { KnowledgeBase } from './core/knowledge';
-import { publishAgent, installAgent } from './marketplace';
 
 import { PluginManager, createLoggingPlugin, createAnalyticsPlugin, createRateLimitPlugin } from './plugins';
+import type { Span } from './traces';
 
 const program = new Command();
 
@@ -94,7 +94,7 @@ async function select(question: string, options: { value: string; label: string
 program
   .name('opc')
   .description('OPC Agent - Open Agent Framework for business workstations')
-  .version('1.0.0');
+  .version('1.4.0');
 
 // ── Init command ─────────────────────────────────────────────
 
@@ -119,6 +119,8 @@ program
     }
 
     fs.mkdirSync(dir, { recursive: true });
+    fs.mkdirSync(path.join(dir, 'src', 'skills'), { recursive: true });
+
     const factory = TEMPLATES[template]?.factory ?? createCustomerServiceConfig;
     const config = factory();
     config.metadata.name = name;
@@ -130,6 +132,113 @@ program
 
     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
+    fs.writeFileSync(
+      path.join(dir, 'src', 'index.ts'),
+      `import { AgentRuntime } from 'opc-agent';
+import { EchoSkill } from './skills/echo';
+
+async function main() {
+  const runtime = new AgentRuntime();
+
+  // Load OAD config
+  await runtime.loadConfig('./agent.yaml');
+
+  // Initialize agent with channels, memory, etc.
+  const agent = await runtime.initialize();
+
+  // Register custom skills
+  runtime.registerSkill(new EchoSkill());
+
+  // Start serving
+  await runtime.start();
+
+  console.log('🤖 Agent is running!');
+  console.log('   Web UI: http://localhost:3000');
+  console.log('   Press Ctrl+C to stop');
+}
+
+main().catch(console.error);
+`,
+    );
+
+    // 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';
+
+export class EchoSkill extends BaseSkill {
+  name = 'echo';
+  description = 'Echo back the message (test skill)';
+
+  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
+    if (message.content.toLowerCase().startsWith('/echo ')) {
+      const text = message.content.slice(6);
+      return this.match(\`🔊 Echo: \${text}\`);
+    }
+    return this.noMatch();
+  }
+}
+`,
+    );
+
+    // tsconfig.json
+    fs.writeFileSync(
+      path.join(dir, 'tsconfig.json'),
+      JSON.stringify(
+        {
+          compilerOptions: {
+            target: 'ES2022',
+            module: 'commonjs',
+            lib: ['ES2022'],
+            outDir: 'dist',
+            rootDir: 'src',
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            resolveJsonModule: true,
+            declaration: true,
+            sourceMap: true,
+          },
+          include: ['src/**/*'],
+          exclude: ['node_modules', 'dist'],
+        },
+        null,
+        2,
+      ),
+    );
+
     // .env.example
     fs.writeFileSync(
       path.join(dir, '.env.example'),
@@ -142,9 +251,9 @@ OPC_LLM_MODEL=gpt-4o-mini
 # OPC_LLM_BASE_URL=https://api.deepseek.com/v1
 # OPC_LLM_MODEL=deepseek-chat
 
-# For local Ollama:
+# For local Ollama (default in agent.yaml):
 # OPC_LLM_BASE_URL=http://localhost:11434/v1
-# OPC_LLM_MODEL=llama3
+# OPC_LLM_MODEL=qwen2.5
 `,
     );
 
@@ -167,10 +276,16 @@ OPC_LLM_MODEL=gpt-4o-mini
           private: true,
           scripts: {
             start: 'opc run',
+            dev: 'opc dev',
             chat: 'opc chat',
+            build: 'tsc',
           },
           dependencies: {
-            'opc-agent': '^0.5.0',
+            'opc-agent': '^1.3.0',
+          },
+          devDependencies: {
+            typescript: '^5.5.0',
+            tsx: '^4.0.0',
           },
         },
         null,
@@ -179,7 +294,7 @@ OPC_LLM_MODEL=gpt-4o-mini
     );
 
     // .gitignore
-    fs.writeFileSync(path.join(dir, '.gitignore'), 'node_modules\n.env\n.opc-knowledge.json\ndata/\n');
+    fs.writeFileSync(path.join(dir, '.gitignore'), 'node_modules\ndist\n.env\n.opc-knowledge.json\ndata/\n');
 
     // Dockerfile
     fs.writeFileSync(
@@ -188,7 +303,8 @@ 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 .env* ./
+COPY oad.yaml agent.yaml .env* ./
+COPY src/ ./src/
 COPY prompts/ ./prompts/ 2>/dev/null || true
 EXPOSE 3000
 CMD ["npx", "opc", "run"]
@@ -207,7 +323,7 @@ services:
     env_file:
       - .env
     volumes:
-      - ./oad.yaml:/app/oad.yaml:ro
+      - ./agent.yaml:/app/agent.yaml:ro
     restart: unless-stopped
 `,
     );
@@ -221,53 +337,69 @@ Created with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the \`${
 
 ## Quick Start
 
-1. **Set your API key:**
+1. **Install dependencies:**
    \`\`\`bash
-   # Edit .env and add your API key
-   cp .env.example .env
-   # Then edit .env with your actual key
+   npm install
    \`\`\`
 
-2. **Install dependencies:**
+2. **Run with Ollama (default):**
    \`\`\`bash
-   npm install
+   # Make sure Ollama is running with qwen2.5 model
+   ollama pull qwen2.5
+   npx tsx src/index.ts
    \`\`\`
 
-3. **Start the web server:**
+3. **Or use OpenAI/other providers:**
    \`\`\`bash
+   # Edit .env and set your API key
    npx opc run
    \`\`\`
 
 4. **Open browser:** [http://localhost:3000](http://localhost:3000)
 
-## CLI Chat
+## Development
 
 \`\`\`bash
-npx opc chat
+npx opc dev    # Hot-reload mode
+npx opc chat   # CLI chat
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${name}/
+├── agent.yaml          # OAD agent config (used by src/index.ts)
+├── oad.yaml            # OAD config (used by opc CLI)
+├── src/
+│   ├── index.ts        # Entry point
+│   └── skills/
+│       └── echo.ts     # Example skill
+├── package.json
+└── tsconfig.json
 \`\`\`
 
 ## Configuration
 
-Edit \`oad.yaml\` to customize your agent's personality, skills, and behavior.
+Edit \`agent.yaml\` to customize your agent's personality, skills, and behavior.
 `,
     );
 
     console.log(`\n${icon.success} Created agent project: ${color.bold(name + '/')}`);
-    console.log(`   ${icon.file} oad.yaml      - Agent definition`);
-    console.log(`   ${icon.file} package.json  - Dependencies`);
-    console.log(`   ${icon.file} .env.example  - Environment template`);
-    console.log(`   ${icon.file} .env          - Environment config (edit this!)`);
+    console.log(`   ${icon.file} agent.yaml       - Agent definition (OAD)`);
+    console.log(`   ${icon.file} src/index.ts     - Entry point`);
+    console.log(`   ${icon.file} src/skills/echo.ts - Example skill`);
+    console.log(`   ${icon.file} package.json     - Dependencies`);
+    console.log(`   ${icon.file} tsconfig.json    - TypeScript config`);
+    console.log(`   ${icon.file} .env.example     - Environment template`);
     console.log(`   ${icon.file} .gitignore`);
     console.log(`   ${icon.file} Dockerfile`);
-    console.log(`   ${icon.file} docker-compose.yml`);
     console.log(`   ${icon.file} README.md`);
     console.log(`\n   Template: ${color.cyan(template)}`);
     console.log(`\n${color.bold('Next steps:')}`);
     console.log(`   1. cd ${name}`);
-    console.log(`   2. Edit .env — set your OPC_LLM_API_KEY`);
-    console.log(`   3. npm install`);
-    console.log(`   4. npx opc run`);
-    console.log(`   5. Open http://localhost:3000\n`);
+    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`);
   });
 
 // ── Chat command ─────────────────────────────────────────────
@@ -721,7 +853,7 @@ kbCmd.command('clear').action(() => {
   console.log(`${icon.success} Knowledge base cleared.`);
 });
 
-// 📦 Marketplace commands ───────────────────────────────────
+// 📦 Package commands ───────────────────────────────────
 
 program
   .command('publish')
@@ -729,23 +861,8 @@ program
   .option('-f, --file <file>', 'OAD file', 'oad.yaml')
   .option('-o, --output <dir>', 'Output directory', '.')
   .option('--include-kb', 'Include knowledge base')
-  .action(async (opts: { file: string; output: string; includeKb?: boolean }) => {
-    try {
-      console.log(`\n${icon.package} Packaging agent...\n`);
-      const result = await publishAgent({
-        oadPath: opts.file,
-        outputDir: opts.output,
-        includeKnowledge: opts.includeKb,
-      });
-      console.log(`${icon.success} Published: ${color.bold(result.archivePath)}`);
-      console.log(`   Name:    ${result.manifest.name}`);
-      console.log(`   Version: ${result.manifest.version}`);
-      console.log(`   Files:   ${result.manifest.files.length}`);
-      console.log();
-    } catch (err) {
-      console.error(`${icon.error} Publish failed:`, err instanceof Error ? err.message : err);
-      process.exit(1);
-    }
+  .action(async () => {
+    console.log(`\n${icon.package} Agent packaging coming soon.\n`);
   });
 
 program
@@ -753,19 +870,8 @@ program
   .description('Install agent from package')
   .argument('<source>', 'Package file path or URL')
   .option('-d, --dir <dir>', 'Install directory')
-  .action(async (source: string, opts: { dir?: string }) => {
-    try {
-      console.log(`\n${icon.package} Installing agent from ${color.bold(source)}...\n`);
-      const result = await installAgent({ source, targetDir: opts.dir });
-      console.log(`${icon.success} Installed: ${color.bold(result.manifest.name)} v${result.manifest.version}`);
-      console.log(`   Directory: ${result.dir}`);
-      console.log(`\n${color.bold('Next steps:')}`);
-      console.log(`   cd ${result.dir}`);
-      console.log(`   opc run\n`);
-    } catch (err) {
-      console.error(`${icon.error} Install failed:`, err instanceof Error ? err.message : err);
-      process.exit(1);
-    }
+  .action(async () => {
+    console.log(`\n${icon.package} Agent install coming soon.\n`);
   });
 
 // 🔌 Plugin commands ────────────────────────────────────────
@@ -873,4 +979,122 @@ program
     }
   });
 
+// ── Brain command ────────────────────────────────────────────
+
+program
+  .command('brain')
+  .description('Show agent memory/brain status from DeepBrain')
+  .option('--url <url>', 'DeepBrain server URL', 'http://localhost:3333')
+  .action(async (opts: { url: string }) => {
+    console.log(`\n${icon.gear} ${color.bold('DeepBrain Status')} — ${color.dim(opts.url)}\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()) as Record<string, any>;
+      const rows: [string, string][] = [
+        ['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}`);
+      }
+      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`);
+      }
+    }
+  });
+
+// ── Logs command ─────────────────────────────────────────────
+
+program
+  .command('logs')
+  .description('Show recent agent traces')
+  .option('-n, --limit <n>', 'Number of spans to show', '20')
+  .option('-f, --follow', 'Keep watching for new spans')
+  .action(async (opts: { limit: string; follow?: boolean }) => {
+    const { TraceCollector } = await import('./traces');
+    const collector = new TraceCollector();
+    const limit = parseInt(opts.limit) || 20;
+
+    const printSpans = (spans: readonly Span[]) => {
+      const slice = spans.slice(-limit);
+      if (slice.length === 0) {
+        console.log(`  ${icon.info} No traces yet. Interact with the agent to generate traces.`);
+        return;
+      }
+      for (const span of slice) {
+        const duration = span.endTime
+          ? `${span.endTime.getTime() - span.startTime.getTime()}ms`
+          : 'ongoing';
+        const statusIcon = span.status === 'ok' ? icon.success : span.status === 'error' ? icon.error : color.dim('○');
+        const time = span.startTime.toLocaleTimeString();
+        console.log(`  ${statusIcon} ${color.dim(time)} ${color.bold(span.name)} ${color.dim(duration)}`);
+      }
+    };
+
+    console.log(`\n${icon.gear} ${color.bold('Agent Traces')}\n`);
+    const spans = collector.getBufferedSpans();
+    printSpans(spans);
+
+    if (opts.follow) {
+      console.log(`\n  ${color.dim('Watching for new traces... (Ctrl+C to stop)')}\n`);
+      let lastCount = spans.length;
+      const interval = setInterval(() => {
+        const current = collector.getBufferedSpans();
+        if (current.length > lastCount) {
+          const newSpans = current.slice(lastCount);
+          printSpans(newSpans);
+          lastCount = current.length;
+        }
+      }, 1000);
+      process.on('SIGINT', () => { clearInterval(interval); process.exit(0); });
+    } else {
+      console.log();
+    }
+  });
+
+// ── Score command ────────────────────────────────────────────
+
+program
+  .command('score')
+  .description('Show agent performance score')
+  .action(async () => {
+    console.log(`\n${icon.gear} ${color.bold('Agent Performance Score')}\n`);
+    try {
+      const engine = new AnalyticsEngine('.');
+      const stats = engine.getStats();
+      if (!stats || stats.totalMessages === 0) {
+        console.log(`  ${icon.info} No score data yet. Run the agent first.\n`);
+        return;
+      }
+      const errorRate = stats.totalMessages > 0 ? (stats.totalErrors / stats.totalMessages) : 0;
+      const rows: [string, string][] = [
+        ['Total Messages', String(stats.totalMessages)],
+        ['Total LLM Calls', String(stats.totalLLMCalls)],
+        ['Total Tool Uses', String(stats.totalToolUses)],
+        ['Avg Response Time', `${stats.avgResponseTimeMs}ms`],
+        ['Error Rate', `${(errorRate * 100).toFixed(1)}%`],
+        ['Token Usage', `${stats.totalTokens.total} tokens (in: ${stats.totalTokens.input}, out: ${stats.totalTokens.output})`],
+      ];
+      const maxKey = Math.max(...rows.map(([k]) => k.length));
+      for (const [key, val] of rows) {
+        console.log(`  ${color.cyan(key.padEnd(maxKey))}  ${val}`);
+      }
+      console.log();
+    } catch {
+      console.log(`  ${icon.info} No score data yet. Run the agent first.\n`);
+    }
+  });
+
 program.parse();
+