opc-agent 1.3.1 → 1.4.0

package/src/channels/slack.ts

@@ -86,9 +86,57 @@ export class SlackChannel extends BaseChannel {
 
   /** Start Events API HTTP server */
   private async startEventsAPI(): Promise<void> {
-    // TODO: Implement with express or http
-    // const port = this.config.port ?? 3001;
-    // Listen for POST /slack/events and /slack/commands
+    const http = await import('http');
+    const port = this.config.port ?? 3001;
+
+    const server = http.createServer(async (req, res) => {
+      if (req.method !== 'POST') {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+
+      const chunks: Buffer[] = [];
+      for await (const chunk of req) chunks.push(chunk as Buffer);
+      const body = JSON.parse(Buffer.concat(chunks).toString());
+
+      // URL verification challenge
+      if (body.type === 'url_verification') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ challenge: body.challenge }));
+        return;
+      }
+
+      // Event callback
+      if (body.type === 'event_callback' && body.event) {
+        const event = body.event as SlackMessageEvent;
+        if (event.type === 'message' || event.type === 'app_mention') {
+          // Don't block the HTTP response
+          this.handleMessage(event).catch(() => {});
+        }
+      }
+
+      // Slash commands (form-urlencoded, but we handle JSON for simplicity)
+      if (req.url === '/slack/commands' && body.command) {
+        const reply = await this.handleSlashCommand({
+          command: body.command,
+          text: body.text ?? '',
+          userId: body.user_id,
+          channelId: body.channel_id,
+          triggerId: body.trigger_id,
+        });
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ response_type: 'ephemeral', text: reply }));
+        return;
+      }
+
+      res.writeHead(200);
+      res.end('ok');
+    });
+
+    server.listen(port, () => {
+      console.log(`[SlackChannel] Events API listening on port ${port}`);
+    });
   }
 
   /** Handle incoming Slack message */
@@ -149,12 +197,21 @@ export class SlackChannel extends BaseChannel {
 
   /** Send a message to a Slack channel */
   async sendMessage(channel: string, text: string, threadTs?: string): Promise<void> {
-    // TODO: Implement with @slack/web-api
-    // const { WebClient } = await import('@slack/web-api');
-    // const client = new WebClient(this.config.botToken);
-    // await client.chat.postMessage({ channel, text, thread_ts: threadTs });
-    void channel;
-    void text;
-    void threadTs;
+    const body: Record<string, string> = { channel, text };
+    if (threadTs) body.thread_ts = threadTs;
+
+    const res = await fetch('https://slack.com/api/chat.postMessage', {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${this.config.botToken}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(body),
+    });
+
+    const data = await res.json() as { ok: boolean; error?: string };
+    if (!data.ok) {
+      console.error(`[SlackChannel] chat.postMessage failed: ${data.error}`);
+    }
   }
 }

package/src/channels/web.ts

@@ -288,6 +288,11 @@ export class WebChannel extends BaseChannel {
   private port: number;
   private streamHandler: ((msg: Message, res: Response) => Promise<void>) | null = null;
   private agentName: string = 'OPC Agent';
+  private agentVersion: string = '1.0.0';
+  private memoryType: string = 'in-memory';
+  private skillNames: string[] = [];
+  private channelNames: string[] = ['web'];
+  private analyticsProvider: (() => any) | null = null;
   private currentProvider: string = 'openai';
   private stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now(), errors: 0 };
   private eventHandlers: Map<string, Function[]> = new Map();
@@ -335,6 +340,26 @@ export class WebChannel extends BaseChannel {
     this.agentName = name;
   }
 
+  setAgentVersion(version: string): void {
+    this.agentVersion = version;
+  }
+
+  setMemoryType(type: string): void {
+    this.memoryType = type;
+  }
+
+  setSkillNames(names: string[]): void {
+    this.skillNames = names;
+  }
+
+  setChannelNames(names: string[]): void {
+    this.channelNames = names;
+  }
+
+  setAnalyticsProvider(fn: () => any): void {
+    this.analyticsProvider = fn;
+  }
+
   onStreamMessage(handler: (msg: Message, res: Response) => Promise<void>): void {
     this.streamHandler = handler;
   }
@@ -345,7 +370,17 @@ export class WebChannel extends BaseChannel {
     });
 
     this.app.get('/health', (_req: Request, res: Response) => {
-      res.json({ status: 'ok', timestamp: Date.now() });
+      res.json({
+        status: 'ok',
+        agent: this.agentName,
+        version: this.agentVersion,
+        uptime: Date.now() - this.stats.startedAt,
+        memory: this.memoryType,
+        skills: this.skillNames,
+        channels: this.channelNames,
+        analytics: this.analyticsProvider ? this.analyticsProvider() : null,
+        timestamp: Date.now(),
+      });
     });
 
     this.app.get('/api/info', (_req: Request, res: Response) => {
@@ -426,7 +461,8 @@ export class WebChannel extends BaseChannel {
     });
 
     this.app.get('/api/dashboard', (_req: Request, res: Response) => {
-      res.json(this.stats);
+      const analytics = this.analyticsProvider ? this.analyticsProvider() : null;
+      res.json({ ...this.stats, analytics });
     });
 
     // --- Knowledge Base Upload ---

package/src/cli.ts

@@ -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 ─────────────────────────────────────────────

package/src/core/runtime.ts

@@ -5,6 +5,7 @@ import { WebChannel } from '../channels/web';
 import { TelegramChannel } from '../channels/telegram';
 import { WebSocketChannel } from '../channels/websocket';
 import { DeepBrainMemoryStore } from '../memory/deepbrain';
+import { Analytics } from '../analytics';
 import type { OADDocument } from '../schema/oad';
 import type { ISkill, MemoryStore, Message } from './types';
 import type { Response } from 'express';
@@ -25,6 +26,7 @@ export class AgentRuntime {
   private historyLimit: number = DEFAULT_HISTORY_LIMIT;
   private shutdownHandlers: (() => Promise<void>)[] = [];
   private isShuttingDown = false;
+  private analytics: Analytics = new Analytics();
 
   async loadConfig(filePath: string): Promise<OADDocument> {
     this.config = loadOAD(filePath);
@@ -64,6 +66,12 @@ export class AgentRuntime {
         const port = ch.port ?? 3000;
         const webChannel = new WebChannel(port);
         webChannel.setAgentName(cfg.metadata.name);
+        webChannel.setAgentVersion(cfg.metadata.version);
+        webChannel.setAnalyticsProvider(() => this.analytics.getSnapshot());
+        webChannel.setChannelNames(cfg.spec.channels.map((c: any) => c.type));
+        webChannel.setSkillNames(cfg.spec.skills.map((s: any) => s.name));
+        const memType = memCfg && typeof memCfg.longTerm === 'object' && memCfg.longTerm.provider === 'deepbrain' ? 'deepbrain' : 'in-memory';
+        webChannel.setMemoryType(memType);
         // Wire streaming
         webChannel.onStreamMessage(async (msg: Message, res: Response) => {
           res.writeHead(200, {
@@ -72,14 +80,17 @@ export class AgentRuntime {
             Connection: 'keep-alive',
             'Access-Control-Allow-Origin': '*',
           });
+          const startTime = Date.now();
           try {
             for await (const chunk of this.agent!.handleMessageStream(msg)) {
               res.write(`data: ${JSON.stringify({ content: chunk })}\n\n`);
             }
             res.write('data: [DONE]\n\n');
+            this.analytics.recordMessage(Date.now() - startTime);
           } catch (err) {
             const errMsg = err instanceof Error ? err.message : String(err);
             res.write(`data: ${JSON.stringify({ error: errMsg })}\n\n`);
+            this.analytics.recordError();
           }
           res.end();
         });
@@ -98,6 +109,18 @@ export class AgentRuntime {
     }
 
     await this.agent.init();
+
+    // Wire analytics to agent events
+    this.agent.on('message:out', () => {
+      // responseTime is approximated; real timing is done via skill/llm events
+    });
+    this.agent.on('skill:execute', (skillName: string) => {
+      this.analytics.recordSkillUsage(skillName);
+    });
+    this.agent.on('error', () => {
+      this.analytics.recordError();
+    });
+
     this.logger.info('Agent initialized', { name: cfg.metadata.name });
     return this.agent;
   }
@@ -149,4 +172,12 @@ export class AgentRuntime {
   getAgent(): BaseAgent | null {
     return this.agent;
   }
+
+  getAnalytics(): Analytics {
+    return this.analytics;
+  }
+
+  getConfig(): OADDocument | null {
+    return this.config;
+  }
 }

package/src/providers/index.ts

@@ -309,6 +309,14 @@ function isGeminiNative(): boolean {
 
 export function createProvider(name: string = 'openai', model?: string, baseUrl?: string, apiKey?: string): LLMProvider {
   const finalModel = model || process.env.OPC_LLM_MODEL || 'gpt-4o-mini';
+
+  // Auto-detect ollama: use localhost:11434/v1 and dummy apiKey
+  if (name === 'ollama') {
+    const ollamaBase = baseUrl || process.env.OPC_LLM_BASE_URL || 'http://localhost:11434/v1';
+    const ollamaKey = apiKey || process.env.OPC_LLM_API_KEY || 'ollama';
+    return new OpenAICompatibleProvider('ollama', finalModel, ollamaBase, ollamaKey);
+  }
+
   const finalKey = apiKey || getApiKey();
   const finalBaseUrl = baseUrl || getBaseUrl();
 
@@ -328,4 +336,4 @@ export function createProvider(name: string = 'openai', model?: string, baseUrl?
   return new OpenAICompatibleProvider(resolvedName, finalModel, baseUrl, apiKey);
 }
 
-export const SUPPORTED_PROVIDERS = ['openai', 'deepseek', 'qwen', 'gemini', 'dashscope', 'zhipu', 'moonshot'] as const;
+export const SUPPORTED_PROVIDERS = ['openai', 'ollama', 'deepseek', 'qwen', 'gemini', 'dashscope', 'zhipu', 'moonshot'] as const;

package/test-agent/Dockerfile

@@ -0,0 +1,9 @@
+FROM node:22-alpine
+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 src/ ./src/
+COPY prompts/ ./prompts/ 2>/dev/null || true
+EXPOSE 3000
+CMD ["npx", "opc", "run"]

package/test-agent/README.md

@@ -0,0 +1,50 @@
+# test-agent
+
+Created with [OPC Agent](https://github.com/Deepleaper/opc-agent) using the `customer-service` template.
+
+## Quick Start
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Run with Ollama (default):**
+   ```bash
+   # Make sure Ollama is running with qwen2.5 model
+   ollama pull qwen2.5
+   npx tsx src/index.ts
+   ```
+
+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)
+
+## Development
+
+```bash
+npx opc dev    # Hot-reload mode
+npx opc chat   # CLI chat
+```
+
+## Project Structure
+
+```
+test-agent/
+├── 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 `agent.yaml` to customize your agent's personality, skills, and behavior.

package/test-agent/agent.yaml

@@ -0,0 +1,23 @@
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: test-agent
+  version: 1.0.0
+  description: My AI Agent
+spec:
+  model: qwen2.5
+  provider:
+    default: ollama
+  systemPrompt: |
+    You are a helpful AI assistant named test-agent.
+    Be concise, helpful, and friendly.
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm:
+      provider: deepbrain
+  skills:
+    - name: echo
+      description: Echo test skill

package/test-agent/docker-compose.yml

@@ -0,0 +1,11 @@
+version: '3.8'
+services:
+  agent:
+    build: .
+    ports:
+      - "3000:3000"
+    env_file:
+      - .env
+    volumes:
+      - ./agent.yaml:/app/agent.yaml:ro
+    restart: unless-stopped

package/test-agent/oad.yaml

@@ -0,0 +1,31 @@
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: test-agent
+  version: 1.0.0
+  description: Customer service agent with FAQ and human handoff
+  author: OPC Agent
+  license: Apache-2.0
+spec:
+  provider:
+    default: deepseek
+    allowed:
+      - openai
+      - deepseek
+      - qwen
+  model: deepseek-chat
+  systemPrompt: |-
+    You are a friendly and professional customer service agent. 
+    You help customers with their questions about products, orders, shipping, and returns.
+    Be concise, helpful, and empathetic. If you're unsure, offer to connect them with a human agent.
+  skills:
+    - name: faq-lookup
+      description: Look up FAQ answers
+    - name: human-handoff
+      description: Hand off to human agent
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: false