opc-agent 0.2.0 → 0.4.0

package/dist/tools/mcp.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPToolRegistry = void 0;
+exports.createMCPTool = createMCPTool;
+class MCPToolRegistry {
+    tools = new Map();
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    unregister(name) {
+        this.tools.delete(name);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.values()).map(({ name, description, inputSchema }) => ({
+            name,
+            description,
+            inputSchema,
+        }));
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    async execute(name, input, context) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return { content: `Tool '${name}' not found`, isError: true };
+        }
+        try {
+            return await tool.execute(input, context);
+        }
+        catch (err) {
+            return {
+                content: `Tool execution error: ${err instanceof Error ? err.message : String(err)}`,
+                isError: true,
+            };
+        }
+    }
+}
+exports.MCPToolRegistry = MCPToolRegistry;
+/**
+ * Create an MCP tool from a simple function.
+ */
+function createMCPTool(name, description, inputSchema, executeFn) {
+    return { name, description, inputSchema, execute: executeFn };
+}
+//# sourceMappingURL=mcp.js.map

package/package.json

@@ -1,46 +1,46 @@
-{
-  "name": "opc-agent",
-  "version": "0.2.0",
-  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "opc": "dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit"
-  },
-  "keywords": [
-    "agent",
-    "ai",
-    "llm",
-    "framework",
-    "typescript",
-    "agent-framework"
-  ],
-  "author": "Deepleaper",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Deepleaper/opc-agent.git"
-  },
-  "dependencies": {
-    "agentkits": "^0.1.0",
-    "commander": "^12.0.0",
-    "express": "^4.21.0",
-    "js-yaml": "^4.1.0",
-    "ws": "^8.20.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.5.0",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "opc-agent",
+  "version": "0.4.0",
+  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "opc": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "llm",
+    "framework",
+    "typescript",
+    "agent-framework"
+  ],
+  "author": "Deepleaper",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Deepleaper/opc-agent.git"
+  },
+  "dependencies": {
+    "agentkits": "^0.1.0",
+    "commander": "^12.0.0",
+    "express": "^4.21.0",
+    "js-yaml": "^4.1.0",
+    "ws": "^8.20.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/analytics/index.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent Analytics — track messages, response times, skill usage, errors, tokens.
+ */
+export interface AnalyticsSnapshot {
+  messagesProcessed: number;
+  avgResponseTimeMs: number;
+  skillUsage: Record<string, number>;
+  errorCount: number;
+  tokenUsage: { input: number; output: number; total: number };
+  uptime: number;
+  startedAt: number;
+}
+
+export class Analytics {
+  private messagesProcessed = 0;
+  private totalResponseTimeMs = 0;
+  private skillUsage: Record<string, number> = {};
+  private errorCount = 0;
+  private tokenUsage = { input: 0, output: 0 };
+  private startedAt = Date.now();
+
+  recordMessage(responseTimeMs: number): void {
+    this.messagesProcessed++;
+    this.totalResponseTimeMs += responseTimeMs;
+  }
+
+  recordSkillUsage(skillName: string): void {
+    this.skillUsage[skillName] = (this.skillUsage[skillName] ?? 0) + 1;
+  }
+
+  recordError(): void {
+    this.errorCount++;
+  }
+
+  recordTokens(input: number, output: number): void {
+    this.tokenUsage.input += input;
+    this.tokenUsage.output += output;
+  }
+
+  getSnapshot(): AnalyticsSnapshot {
+    return {
+      messagesProcessed: this.messagesProcessed,
+      avgResponseTimeMs: this.messagesProcessed > 0
+        ? Math.round(this.totalResponseTimeMs / this.messagesProcessed)
+        : 0,
+      skillUsage: { ...this.skillUsage },
+      errorCount: this.errorCount,
+      tokenUsage: {
+        input: this.tokenUsage.input,
+        output: this.tokenUsage.output,
+        total: this.tokenUsage.input + this.tokenUsage.output,
+      },
+      uptime: Date.now() - this.startedAt,
+      startedAt: this.startedAt,
+    };
+  }
+
+  reset(): void {
+    this.messagesProcessed = 0;
+    this.totalResponseTimeMs = 0;
+    this.skillUsage = {};
+    this.errorCount = 0;
+    this.tokenUsage = { input: 0, output: 0 };
+    this.startedAt = Date.now();
+  }
+}

package/src/channels/voice.ts

@@ -0,0 +1,106 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+import { Logger } from '../core/logger';
+
+// ── Voice Channel Types ─────────────────────────────────────
+
+export interface STTProvider {
+  name: string;
+  transcribe(audio: Buffer, options?: STTOptions): Promise<string>;
+}
+
+export interface TTSProvider {
+  name: string;
+  synthesize(text: string, options?: TTSOptions): Promise<Buffer>;
+}
+
+export interface STTOptions {
+  language?: string;
+  model?: string;
+}
+
+export interface TTSOptions {
+  voice?: string;
+  speed?: number;
+  language?: string;
+}
+
+export interface VoiceChannelConfig {
+  sttProvider?: STTProvider;
+  ttsProvider?: TTSProvider;
+  sampleRate?: number;
+  language?: string;
+}
+
+// ── Voice Channel ───────────────────────────────────────────
+
+export class VoiceChannel extends BaseChannel {
+  type = 'voice';
+  private config: VoiceChannelConfig;
+  private logger = new Logger('voice-channel');
+  private running = false;
+
+  constructor(config?: VoiceChannelConfig) {
+    super();
+    this.config = config ?? {};
+  }
+
+  async start(): Promise<void> {
+    this.running = true;
+    this.logger.info('Voice channel started', {
+      stt: this.config.sttProvider?.name ?? 'none',
+      tts: this.config.ttsProvider?.name ?? 'none',
+    });
+  }
+
+  async stop(): Promise<void> {
+    this.running = false;
+    this.logger.info('Voice channel stopped');
+  }
+
+  isRunning(): boolean {
+    return this.running;
+  }
+
+  /** Process audio input: STT → Agent → TTS */
+  async processAudio(audio: Buffer): Promise<{ text: string; response: string; audioResponse?: Buffer }> {
+    if (!this.handler) throw new Error('No message handler set');
+
+    // STT
+    let text: string;
+    if (this.config.sttProvider) {
+      text = await this.config.sttProvider.transcribe(audio, { language: this.config.language });
+    } else {
+      text = audio.toString('utf-8'); // Fallback: treat as text
+    }
+
+    this.logger.debug('STT result', { text });
+
+    // Create message and send to agent
+    const message: Message = {
+      id: `voice_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+      role: 'user',
+      content: text,
+      timestamp: Date.now(),
+      metadata: { channel: 'voice' },
+    };
+
+    const response = await this.handler(message);
+
+    // TTS
+    let audioResponse: Buffer | undefined;
+    if (this.config.ttsProvider) {
+      audioResponse = await this.config.ttsProvider.synthesize(response.content, { language: this.config.language });
+    }
+
+    return { text, response: response.content, audioResponse };
+  }
+
+  setSTTProvider(provider: STTProvider): void {
+    this.config.sttProvider = provider;
+  }
+
+  setTTSProvider(provider: TTSProvider): void {
+    this.config.ttsProvider = provider;
+  }
+}

package/src/channels/webhook.ts

@@ -0,0 +1,199 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+import { Logger } from '../core/logger';
+import * as http from 'http';
+import * as crypto from 'crypto';
+
+// ── Webhook Types ───────────────────────────────────────────
+
+export interface WebhookConfig {
+  port?: number;
+  path?: string;
+  secret?: string;
+  retryAttempts?: number;
+  retryDelayMs?: number;
+  outgoing?: WebhookOutgoing[];
+}
+
+export interface WebhookOutgoing {
+  name: string;
+  url: string;
+  secret?: string;
+  events: string[];
+}
+
+export interface WebhookPayload {
+  event: string;
+  data: unknown;
+  timestamp: number;
+  id: string;
+}
+
+// ── Webhook Channel ─────────────────────────────────────────
+
+export class WebhookChannel extends BaseChannel {
+  type = 'webhook';
+  private config: WebhookConfig;
+  private server: http.Server | null = null;
+  private logger = new Logger('webhook-channel');
+  private outgoing: WebhookOutgoing[] = [];
+
+  constructor(config?: WebhookConfig) {
+    super();
+    this.config = config ?? {};
+    this.outgoing = config?.outgoing ?? [];
+  }
+
+  async start(): Promise<void> {
+    const port = this.config.port ?? 3100;
+    const path = this.config.path ?? '/webhook';
+
+    this.server = http.createServer(async (req, res) => {
+      if (req.url !== path || req.method !== 'POST') {
+        res.writeHead(404);
+        res.end('Not found');
+        return;
+      }
+
+      try {
+        const body = await this.readBody(req);
+
+        // Verify signature if secret configured
+        if (this.config.secret) {
+          const signature = req.headers['x-webhook-signature'] as string;
+          if (!this.verifySignature(body, signature, this.config.secret)) {
+            res.writeHead(401);
+            res.end('Invalid signature');
+            return;
+          }
+        }
+
+        const payload: WebhookPayload = JSON.parse(body);
+        const message: Message = {
+          id: payload.id ?? `wh_${Date.now()}`,
+          role: 'user',
+          content: typeof payload.data === 'string' ? payload.data : JSON.stringify(payload.data),
+          timestamp: payload.timestamp ?? Date.now(),
+          metadata: { channel: 'webhook', event: payload.event },
+        };
+
+        if (this.handler) {
+          const response = await this.handler(message);
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ status: 'ok', response: response.content }));
+        } else {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ status: 'ok' }));
+        }
+      } catch (err) {
+        this.logger.error('Webhook error', { error: (err as Error).message });
+        res.writeHead(500);
+        res.end('Internal error');
+      }
+    });
+
+    return new Promise((resolve) => {
+      this.server!.listen(port, () => {
+        this.logger.info('Webhook channel started', { port, path });
+        resolve();
+      });
+    });
+  }
+
+  async stop(): Promise<void> {
+    return new Promise((resolve) => {
+      if (this.server) {
+        this.server.close(() => {
+          this.logger.info('Webhook channel stopped');
+          resolve();
+        });
+      } else {
+        resolve();
+      }
+    });
+  }
+
+  /** Send a webhook to outgoing endpoints */
+  async send(event: string, data: unknown): Promise<void> {
+    const targets = this.outgoing.filter(o => o.events.includes(event) || o.events.includes('*'));
+
+    for (const target of targets) {
+      const payload: WebhookPayload = {
+        event,
+        data,
+        timestamp: Date.now(),
+        id: `wh_out_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+      };
+
+      await this.sendWithRetry(target, payload);
+    }
+  }
+
+  private async sendWithRetry(target: WebhookOutgoing, payload: WebhookPayload): Promise<void> {
+    const maxRetries = this.config.retryAttempts ?? 3;
+    const retryDelay = this.config.retryDelayMs ?? 1000;
+    const body = JSON.stringify(payload);
+
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        await this.httpPost(target.url, body, target.secret);
+        return;
+      } catch (err) {
+        if (attempt === maxRetries) {
+          this.logger.error('Webhook delivery failed', { target: target.name, error: (err as Error).message });
+          throw err;
+        }
+        await new Promise(r => setTimeout(r, retryDelay * Math.pow(2, attempt)));
+      }
+    }
+  }
+
+  private httpPost(url: string, body: string, secret?: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const urlObj = new URL(url);
+      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+      if (secret) {
+        headers['x-webhook-signature'] = this.createSignature(body, secret);
+      }
+
+      const req = http.request(
+        { hostname: urlObj.hostname, port: urlObj.port, path: urlObj.pathname, method: 'POST', headers },
+        (res) => {
+          if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+            resolve();
+          } else {
+            reject(new Error(`HTTP ${res.statusCode}`));
+          }
+          res.resume();
+        },
+      );
+      req.on('error', reject);
+      req.write(body);
+      req.end();
+    });
+  }
+
+  private readBody(req: http.IncomingMessage): Promise<string> {
+    return new Promise((resolve, reject) => {
+      const chunks: Buffer[] = [];
+      req.on('data', (c: Buffer) => chunks.push(c));
+      req.on('end', () => resolve(Buffer.concat(chunks).toString()));
+      req.on('error', reject);
+    });
+  }
+
+  verifySignature(body: string, signature: string, secret: string): boolean {
+    if (!signature) return false;
+    const expected = this.createSignature(body, secret);
+    if (signature.length !== expected.length) return false;
+    return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
+  }
+
+  createSignature(body: string, secret: string): string {
+    return crypto.createHmac('sha256', secret).update(body).digest('hex');
+  }
+
+  addOutgoing(outgoing: WebhookOutgoing): void {
+    this.outgoing.push(outgoing);
+  }
+}