npm - opc-agent - Versions diffs - 0.6.0 → 0.8.0 - Mend

opc-agent 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/dist/channels/email.d.ts +69 -0
package/dist/channels/email.js +118 -0
package/dist/channels/slack.d.ts +62 -0
package/dist/channels/slack.js +107 -0
package/dist/channels/web.d.ts +7 -1
package/dist/channels/web.js +165 -4
package/dist/channels/wechat.d.ts +62 -0
package/dist/channels/wechat.js +104 -0
package/dist/core/auth.d.ts +13 -0
package/dist/core/auth.js +41 -0
package/dist/core/compose.d.ts +35 -0
package/dist/core/compose.js +49 -0
package/dist/core/orchestrator.d.ts +68 -0
package/dist/core/orchestrator.js +145 -0
package/dist/index.d.ts +23 -0
package/dist/index.js +34 -1
package/dist/schema/oad.d.ts +69 -0
package/dist/schema/oad.js +7 -1
package/dist/skills/document.d.ts +27 -0
package/dist/skills/document.js +80 -0
package/dist/skills/http.d.ts +8 -0
package/dist/skills/http.js +34 -0
package/dist/skills/scheduler.d.ts +21 -0
package/dist/skills/scheduler.js +70 -0
package/dist/skills/webhook-trigger.d.ts +17 -0
package/dist/skills/webhook-trigger.js +49 -0
package/dist/tools/calculator.d.ts +7 -0
package/dist/tools/calculator.js +70 -0
package/dist/tools/datetime.d.ts +7 -0
package/dist/tools/datetime.js +159 -0
package/dist/tools/json-transform.d.ts +7 -0
package/dist/tools/json-transform.js +184 -0
package/dist/tools/text-analysis.d.ts +8 -0
package/dist/tools/text-analysis.js +113 -0
package/package.json +1 -1
package/src/channels/email.ts +177 -0
package/src/channels/slack.ts +160 -0
package/src/channels/web.ts +175 -4
package/src/channels/wechat.ts +149 -0
package/src/core/auth.ts +57 -0
package/src/core/compose.ts +77 -0
package/src/core/orchestrator.ts +215 -0
package/src/index.ts +27 -0
package/src/schema/oad.ts +7 -0
package/src/skills/document.ts +100 -0
package/src/skills/http.ts +35 -0
package/src/skills/scheduler.ts +80 -0
package/src/skills/webhook-trigger.ts +59 -0
package/src/tools/calculator.ts +73 -0
package/src/tools/datetime.ts +149 -0
package/src/tools/json-transform.ts +187 -0
package/src/tools/text-analysis.ts +116 -0
package/tests/v070.test.ts +76 -0

package/src/channels/web.ts CHANGED Viewed

@@ -4,6 +4,59 @@ import type { Message } from '../core/types';
 import { BaseChannel } from './index';
 import { KnowledgeBase } from '../core/knowledge';
 import { createProvider, type LLMProvider } from '../providers';
+import { createAuthMiddleware, type AuthConfig } from '../core/auth';
+const AGENT_TEMPLATES = [
+  { id: 'customer-service', name: 'Customer Service', description: 'Handle support tickets, FAQs, and customer inquiries', icon: '🎧', category: 'Business' },
+  { id: 'code-reviewer', name: 'Code Reviewer', description: 'Review PRs, suggest improvements, check for bugs', icon: '🔍', category: 'Engineering' },
+  { id: 'content-writer', name: 'Content Writer', description: 'Write blogs, social media posts, and marketing copy', icon: '✍️', category: 'Marketing' },
+  { id: 'executive-assistant', name: 'Executive Assistant', description: 'Schedule management, email drafting, meeting prep', icon: '📋', category: 'Business' },
+  { id: 'knowledge-base', name: 'Knowledge Base', description: 'RAG-powered Q&A over your documents', icon: '📚', category: 'Knowledge' },
+  { id: 'project-manager', name: 'Project Manager', description: 'Track tasks, milestones, and team coordination', icon: '📊', category: 'Business' },
+  { id: 'sales-assistant', name: 'Sales Assistant', description: 'Lead qualification, outreach drafting, CRM updates', icon: '💼', category: 'Sales' },
+  { id: 'financial-advisor', name: 'Financial Advisor', description: 'Budget analysis, financial planning, cost optimization', icon: '💰', category: 'Finance' },
+  { id: 'hr-recruiter', name: 'HR Recruiter', description: 'Resume screening, interview scheduling, candidate comms', icon: '👥', category: 'HR' },
+  { id: 'legal-assistant', name: 'Legal Assistant', description: 'Contract review, compliance checks, legal research', icon: '⚖️', category: 'Legal' },
+];
+const TEMPLATES_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>Agent Templates</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{background:#0a0a0f;color:#e0e0e0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;padding:24px}
+h1{font-size:28px;margin-bottom:8px;color:#fff}
+.sub{color:#888;margin-bottom:32px;font-size:14px}
+nav{margin-bottom:24px}
+nav a{color:#818cf8;text-decoration:none;margin-right:16px;font-size:14px}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:16px}
+.card{background:#12121a;border:1px solid #1e1e2e;border-radius:12px;padding:24px;cursor:pointer;transition:all .2s}
+.card:hover{border-color:#818cf8;transform:translateY(-2px)}
+.card .icon{font-size:32px;margin-bottom:12px}
+.card h3{font-size:16px;color:#fff;margin-bottom:8px}
+.card p{font-size:13px;color:#888;line-height:1.5}
+.card .cat{font-size:11px;color:#818cf8;text-transform:uppercase;letter-spacing:1px;margin-top:12px}
+.btn{display:inline-block;background:#2563eb;color:#fff;border:none;border-radius:8px;padding:8px 16px;font-size:13px;cursor:pointer;margin-top:12px}
+.btn:hover{background:#1d4ed8}
+</style>
+</head>
+<body>
+<nav><a href="/">← Chat</a><a href="/dashboard">Dashboard</a><a href="/templates">Templates</a></nav>
+<h1>🧩 Agent Templates</h1>
+<p class="sub">Create a new agent from a pre-built template in one click.</p>
+<div class="grid" id="grid"></div>
+<script>
+fetch('/api/templates').then(r=>r.json()).then(d=>{
+  const g=document.getElementById('grid');
+  d.templates.forEach(t=>{
+    g.innerHTML+=\`<div class="card"><div class="icon">\${t.icon}</div><h3>\${t.name}</h3><p>\${t.description}</p><div class="cat">\${t.category}</div><button class="btn" onclick="alert('Creating agent from template: '+'\${t.id}'+'\\\\nRun: opc init --template \${t.id}')">Use Template</button></div>\`;
+  });
+});
+</script>
+</body>
+</html>`;
 const CHAT_HTML = `<!DOCTYPE html>
 <html lang="en">
@@ -157,8 +210,12 @@ export class WebChannel extends BaseChannel {
   private streamHandler: ((msg: Message, res: Response) => Promise<void>) | null = null;
   private agentName: string = 'OPC Agent';
   private currentProvider: string = 'openai';
-  private stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now() };
+  private stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now(), errors: 0 };
   private eventHandlers: Map<string, Function[]> = new Map();
+  private conversations: Map<string, Message[]> = new Map();
+  private requestCount = 0;
+  private llmLatencySum = 0;
+  private llmCalls = 0;
   private emit(event: string, data: any): void {
     const handlers = this.eventHandlers.get(event) ?? [];
@@ -175,15 +232,23 @@ export class WebChannel extends BaseChannel {
     this.stats.messages++;
     this.stats.totalResponseMs += responseMs;
     this.stats.tokenUsage += tokens;
+    this.requestCount++;
+    this.llmLatencySum += responseMs;
+    this.llmCalls++;
   }
+  trackError(): void { this.stats.errors++; }
   trackSession(): void { this.stats.sessions++; }
-  constructor(port: number = 3000) {
+  constructor(port: number = 3000, authConfig?: AuthConfig) {
     super();
     this.port = port;
     this.app = express();
-    this.app.use(express.json());
+    this.app.use(express.json({ limit: '10mb' }));
+    if (authConfig && authConfig.apiKeys.length > 0) {
+      this.app.use(createAuthMiddleware(authConfig));
+    }
     this.setupRoutes();
   }
@@ -211,6 +276,7 @@ export class WebChannel extends BaseChannel {
     // Streaming chat endpoint
     this.app.post('/api/chat', async (req: Request, res: Response) => {
       const { message, sessionId } = req.body;
+      const sid = sessionId ?? 'default';
       if (!message) {
         res.status(400).json({ error: 'message is required' });
         return;
@@ -221,9 +287,13 @@ export class WebChannel extends BaseChannel {
         role: 'user',
         content: message,
         timestamp: Date.now(),
-        metadata: { sessionId: sessionId ?? 'default' },
+        metadata: { sessionId: sid },
       };
+      // Track conversation
+      if (!this.conversations.has(sid)) this.conversations.set(sid, []);
+      this.conversations.get(sid)!.push(msg);
       if (this.streamHandler) {
         try {
           await this.streamHandler(msg, res);
@@ -301,6 +371,107 @@ export class WebChannel extends BaseChannel {
       } catch { res.json({ totalEntries: 0, sources: [] }); }
     });
+    // --- Health Check (detailed) ---
+    this.app.get('/api/health', (_req: Request, res: Response) => {
+      const uptimeMs = Date.now() - this.stats.startedAt;
+      res.json({
+        status: 'ok',
+        timestamp: Date.now(),
+        uptime: uptimeMs,
+        uptimeHuman: `${Math.floor(uptimeMs / 3600000)}h ${Math.floor((uptimeMs % 3600000) / 60000)}m`,
+        version: '0.7.0',
+        agent: this.agentName,
+        stats: {
+          sessions: this.stats.sessions,
+          messages: this.stats.messages,
+          errors: this.stats.errors,
+          avgResponseMs: this.stats.messages > 0 ? Math.round(this.stats.totalResponseMs / this.stats.messages) : 0,
+        },
+        memory: {
+          rss: process.memoryUsage().rss,
+          heapUsed: process.memoryUsage().heapUsed,
+        },
+      });
+    });
+    // --- Prometheus Metrics ---
+    this.app.get('/api/metrics', (_req: Request, res: Response) => {
+      const uptimeMs = Date.now() - this.stats.startedAt;
+      const avgLatency = this.llmCalls > 0 ? this.llmLatencySum / this.llmCalls : 0;
+      const mem = process.memoryUsage();
+      res.type('text/plain').send(
+        `# HELP opc_uptime_seconds Agent uptime in seconds\n` +
+        `# TYPE opc_uptime_seconds gauge\n` +
+        `opc_uptime_seconds ${(uptimeMs / 1000).toFixed(1)}\n` +
+        `# HELP opc_requests_total Total requests\n` +
+        `# TYPE opc_requests_total counter\n` +
+        `opc_requests_total ${this.requestCount}\n` +
+        `# HELP opc_messages_total Total messages processed\n` +
+        `# TYPE opc_messages_total counter\n` +
+        `opc_messages_total ${this.stats.messages}\n` +
+        `# HELP opc_errors_total Total errors\n` +
+        `# TYPE opc_errors_total counter\n` +
+        `opc_errors_total ${this.stats.errors}\n` +
+        `# HELP opc_llm_latency_avg_ms Average LLM response latency\n` +
+        `# TYPE opc_llm_latency_avg_ms gauge\n` +
+        `opc_llm_latency_avg_ms ${avgLatency.toFixed(1)}\n` +
+        `# HELP opc_sessions_total Total sessions\n` +
+        `# TYPE opc_sessions_total counter\n` +
+        `opc_sessions_total ${this.stats.sessions}\n` +
+        `# HELP opc_token_usage_total Total token usage\n` +
+        `# TYPE opc_token_usage_total counter\n` +
+        `opc_token_usage_total ${this.stats.tokenUsage}\n` +
+        `# HELP process_resident_memory_bytes Resident memory size\n` +
+        `# TYPE process_resident_memory_bytes gauge\n` +
+        `process_resident_memory_bytes ${mem.rss}\n`
+      );
+    });
+    // --- Conversation tracking & export ---
+    this.app.get('/api/conversations/export', (req: Request, res: Response) => {
+      const sessionId = req.query.sessionId as string;
+      const format = (req.query.format as string) ?? 'json';
+      const messages = sessionId ? (this.conversations.get(sessionId) ?? []) : Array.from(this.conversations.values()).flat();
+      if (format === 'markdown') {
+        const md = messages.map(m => `**${m.role}** (${new Date(m.timestamp).toISOString()}):\n${m.content}`).join('\n\n---\n\n');
+        res.type('text/markdown').send(md);
+      } else if (format === 'csv') {
+        const header = 'id,role,content,timestamp\n';
+        const rows = messages.map(m => `"${m.id}","${m.role}","${m.content.replace(/"/g, '""')}",${m.timestamp}`).join('\n');
+        res.type('text/csv').send(header + rows);
+      } else {
+        res.json({ sessionId: sessionId ?? 'all', messages, count: messages.length });
+      }
+    });
+    // --- Document Upload ---
+    this.app.post('/api/documents/upload', async (req: Request, res: Response) => {
+      try {
+        const { content, filename, mimeType } = req.body;
+        if (!content || !filename) {
+          res.status(400).json({ error: 'content and filename are required' });
+          return;
+        }
+        const kb = new KnowledgeBase('.');
+        const result = await kb.addText(content, filename);
+        this.stats.knowledgeFiles++;
+        res.json({ ok: true, filename, chunks: result.chunks, chars: content.length });
+      } catch (err) {
+        res.status(500).json({ error: err instanceof Error ? err.message : 'Upload failed' });
+      }
+    });
+    // --- Agent Templates Gallery ---
+    this.app.get('/api/templates', (_req: Request, res: Response) => {
+      res.json({ templates: AGENT_TEMPLATES });
+    });
+    this.app.get('/templates', (_req: Request, res: Response) => {
+      res.type('html').send(TEMPLATES_HTML);
+    });
     // Legacy endpoint
     this.app.post('/chat', async (req: Request, res: Response) => {
       if (!this.handler) {

package/src/channels/wechat.ts ADDED Viewed

@@ -0,0 +1,149 @@
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+/**
+ * WeChat Channel (Stub) — v0.8.0
+ * WeChat Official Account message handling, template messages, QR code login.
+ */
+export interface WeChatChannelConfig {
+  /** WeChat Official Account AppID */
+  appId: string;
+  /** WeChat Official Account AppSecret */
+  appSecret: string;
+  /** Verification token for message validation */
+  token: string;
+  /** AES encoding key for encrypted messages */
+  encodingAESKey?: string;
+  /** HTTP server port (default: 3002) */
+  port?: number;
+}
+export interface WeChatMessage {
+  toUserName: string;
+  fromUserName: string;
+  createTime: number;
+  msgType: 'text' | 'image' | 'voice' | 'video' | 'event';
+  content?: string;
+  msgId?: string;
+  event?: string;
+  eventKey?: string;
+}
+export interface TemplateMessageData {
+  toUser: string;
+  templateId: string;
+  url?: string;
+  data: Record<string, { value: string; color?: string }>;
+}
+export class WeChatChannel extends BaseChannel {
+  type = 'wechat';
+  private config: WeChatChannelConfig;
+  private accessToken: string | null = null;
+  private tokenExpiry = 0;
+  constructor(config: WeChatChannelConfig) {
+    super();
+    this.config = config;
+  }
+  async start(): Promise<void> {
+    // TODO: Start HTTP server to receive WeChat push messages
+    // 1. Verify signature on GET requests
+    // 2. Parse XML messages on POST requests
+    // 3. Route to handler and reply with XML
+  }
+  async stop(): Promise<void> {
+    // TODO: Stop HTTP server
+  }
+  /** Get or refresh access token */
+  async getAccessToken(): Promise<string> {
+    if (this.accessToken && Date.now() < this.tokenExpiry) {
+      return this.accessToken;
+    }
+    // TODO: Implement token refresh
+    // const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${this.config.appId}&secret=${this.config.appSecret}`;
+    // const res = await fetch(url);
+    // const data = await res.json();
+    // this.accessToken = data.access_token;
+    // this.tokenExpiry = Date.now() + (data.expires_in - 300) * 1000;
+    return this.accessToken ?? '';
+  }
+  /** Handle incoming WeChat message */
+  async handleMessage(wxMsg: WeChatMessage): Promise<string> {
+    if (wxMsg.msgType === 'event') {
+      return this.handleEvent(wxMsg);
+    }
+    const message = this.wechatToMessage(wxMsg);
+    if (this.handler) {
+      const reply = await this.handler(message);
+      return reply.content;
+    }
+    return '';
+  }
+  /** Handle WeChat events (subscribe, scan, etc.) */
+  private handleEvent(wxMsg: WeChatMessage): string {
+    switch (wxMsg.event) {
+      case 'subscribe':
+        return 'Welcome! How can I help you?';
+      case 'SCAN':
+        return `QR code scanned: ${wxMsg.eventKey}`;
+      default:
+        return '';
+    }
+  }
+  /** Convert WeChat message to internal Message */
+  private wechatToMessage(wxMsg: WeChatMessage): Message {
+    return {
+      id: wxMsg.msgId ?? `wx-${wxMsg.createTime}`,
+      role: 'user',
+      content: wxMsg.content ?? '',
+      timestamp: wxMsg.createTime * 1000,
+      metadata: {
+        channel: 'wechat',
+        fromUser: wxMsg.fromUserName,
+        toUser: wxMsg.toUserName,
+        msgType: wxMsg.msgType,
+      },
+    };
+  }
+  /** Send template message */
+  async sendTemplateMessage(data: TemplateMessageData): Promise<boolean> {
+    // TODO: Implement
+    // const token = await this.getAccessToken();
+    // const url = `https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=${token}`;
+    // const res = await fetch(url, {
+    //   method: 'POST',
+    //   body: JSON.stringify({
+    //     touser: data.toUser,
+    //     template_id: data.templateId,
+    //     url: data.url,
+    //     data: data.data,
+    //   }),
+    // });
+    void data;
+    return true;
+  }
+  /** Generate QR code for login (stub) */
+  async generateLoginQR(): Promise<{ ticket: string; url: string; expireSeconds: number }> {
+    // TODO: Implement with WeChat QR code API
+    // const token = await this.getAccessToken();
+    // POST to https://api.weixin.qq.com/cgi-bin/qrcode/create
+    return {
+      ticket: 'stub-ticket',
+      url: 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=stub-ticket',
+      expireSeconds: 300,
+    };
+  }
+}

package/src/core/auth.ts ADDED Viewed

@@ -0,0 +1,57 @@
+import type { Request, Response, NextFunction } from 'express';
+export interface AuthConfig {
+  apiKeys: string[];
+  sessionIsolation?: boolean;
+}
+export interface AuthSession {
+  apiKey: string;
+  userId: string;
+  createdAt: number;
+}
+const sessions = new Map<string, AuthSession>();
+export function createAuthMiddleware(config: AuthConfig) {
+  return (req: Request, res: Response, next: NextFunction): void => {
+    // Skip auth for non-API routes and health/metrics
+    if (!req.path.startsWith('/api/') || req.path === '/api/health' || req.path === '/api/metrics') {
+      next();
+      return;
+    }
+    const apiKey = req.headers['x-api-key'] as string
+      ?? req.headers['authorization']?.replace(/^Bearer\s+/i, '')
+      ?? (req.query as any).apiKey;
+    if (!apiKey || !config.apiKeys.includes(apiKey)) {
+      res.status(401).json({ error: 'Unauthorized. Provide a valid API key via X-API-Key header, Bearer token, or ?apiKey query.' });
+      return;
+    }
+    // Derive userId from API key for session isolation
+    const userId = `user_${hashKey(apiKey)}`;
+    if (!sessions.has(apiKey)) {
+      sessions.set(apiKey, { apiKey, userId, createdAt: Date.now() });
+    }
+    // Attach user info to request
+    (req as any).userId = userId;
+    (req as any).sessionPrefix = config.sessionIsolation ? `${userId}:` : '';
+    next();
+  };
+}
+function hashKey(key: string): string {
+  let h = 0;
+  for (let i = 0; i < key.length; i++) {
+    h = ((h << 5) - h + key.charCodeAt(i)) | 0;
+  }
+  return Math.abs(h).toString(36);
+}
+export function getActiveSessions(): AuthSession[] {
+  return Array.from(sessions.values());
+}

package/src/core/compose.ts ADDED Viewed

@@ -0,0 +1,77 @@
+import type { AgentContext, Message } from './types';
+/**
+ * Agent Composition — v0.8.0
+ * Combine multiple agents into a pipeline: Agent A output → Agent B input.
+ * Configurable in OAD: `compose: [agent-a, agent-b]`
+ */
+export type AgentHandler = (context: AgentContext, message: Message) => Promise<Message>;
+export interface ComposableAgent {
+  id: string;
+  name: string;
+  handler: AgentHandler;
+}
+export interface ComposeOptions {
+  /** Stop pipeline if any agent returns empty content */
+  stopOnEmpty?: boolean;
+  /** Transform output between agents */
+  transform?: (output: Message, nextAgentId: string) => Message;
+  /** Timeout per agent in ms */
+  timeoutMs?: number;
+}
+export class AgentPipeline {
+  private agents: ComposableAgent[] = [];
+  private options: ComposeOptions;
+  constructor(agents: ComposableAgent[], options: ComposeOptions = {}) {
+    this.agents = agents;
+    this.options = options;
+  }
+  /** Run the pipeline sequentially: each agent's output becomes the next agent's input */
+  async execute(context: AgentContext, initialMessage: Message): Promise<Message> {
+    let currentMessage = initialMessage;
+    for (const agent of this.agents) {
+      if (this.options.stopOnEmpty && !currentMessage.content.trim()) {
+        break;
+      }
+      // Apply transform if provided
+      if (this.options.transform) {
+        currentMessage = this.options.transform(currentMessage, agent.id);
+      }
+      if (this.options.timeoutMs) {
+        const result = await Promise.race([
+          agent.handler(context, currentMessage),
+          new Promise<never>((_, reject) =>
+            setTimeout(() => reject(new Error(`Agent ${agent.id} timed out`)), this.options.timeoutMs)
+          ),
+        ]);
+        currentMessage = result;
+      } else {
+        currentMessage = await agent.handler(context, currentMessage);
+      }
+    }
+    return currentMessage;
+  }
+  /** Get the pipeline agent IDs in order */
+  getAgentIds(): string[] {
+    return this.agents.map((a) => a.id);
+  }
+}
+/**
+ * Create a pipeline from an array of composable agents.
+ * Usage in OAD: `compose: [agent-a, agent-b, agent-c]`
+ */
+export function compose(agents: ComposableAgent[], options?: ComposeOptions): AgentPipeline {
+  return new AgentPipeline(agents, options);
+}