opc-agent 4.1.1 → 4.1.3

package/src/templates/hr-recruiter.ts

@@ -1,58 +0,0 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-
-export class ResumeScreeningSkill extends BaseSkill {
-  name = 'resume-screening';
-  description = 'Screen resumes against job requirements';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('resume') || lower.includes('cv') || lower.includes('candidate')) {
-      return this.match(
-        'I can help screen resumes. Please share the candidate\'s resume and the job requirements, and I\'ll provide an analysis.',
-        0.8,
-      );
-    }
-    return this.noMatch();
-  }
-}
-
-export class InterviewSchedulingSkill extends BaseSkill {
-  name = 'interview-scheduling';
-  description = 'Help schedule interviews with candidates';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('schedule') || lower.includes('interview') || lower.includes('calendar')) {
-      return this.match(
-        'I can help schedule interviews. Please provide the candidate name, preferred dates, and interview format (phone/video/onsite).',
-        0.8,
-      );
-    }
-    return this.noMatch();
-  }
-}
-
-export function createHRRecruiterConfig() {
-  return {
-    apiVersion: 'opc/v1',
-    kind: 'Agent',
-    metadata: {
-      name: 'hr-recruiter',
-      version: '1.0.0',
-      description: 'HR Recruiter — resume screening, interview scheduling, candidate Q&A',
-      author: 'Deepleaper',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      model: 'deepseek-chat',
-      systemPrompt: 'You are an HR recruiter assistant. Help with resume screening, interview scheduling, and answering candidate questions. Be professional and friendly.',
-      skills: [
-        { name: 'resume-screening', description: 'Screen resumes' },
-        { name: 'interview-scheduling', description: 'Schedule interviews' },
-      ],
-      channels: [{ type: 'web', port: 3000 }],
-    },
-  };
-}

package/src/templates/knowledge-base.ts

@@ -1,27 +0,0 @@
-export const KNOWLEDGE_BASE_SYSTEM_PROMPT = `You are a knowledge base assistant. Answer questions using the company documents
-and knowledge provided to you. If you don't have enough information, say so honestly.
-Always cite sources when possible. Be accurate and concise.`;
-
-export function createKnowledgeBaseConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'knowledge-base',
-      version: '1.0.0',
-      description: 'RAG-powered knowledge base agent using DeepBrain for semantic search',
-      author: 'OPC Agent',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
-      model: 'deepseek-chat',
-      systemPrompt: KNOWLEDGE_BASE_SYSTEM_PROMPT,
-      skills: [
-        { name: 'doc-search', description: 'Search company documents' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: { provider: 'deepbrain' as const, collection: 'company-knowledge' } },
-    },
-  };
-}

package/src/templates/legal-assistant.ts

@@ -1,71 +0,0 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-import type { OADDocument } from '../schema/oad';
-
-const LEGAL_TERMS: Record<string, string> = {
-  'force majeure': 'A clause that frees parties from obligations due to extraordinary events.',
-  'indemnification': 'One party agrees to compensate the other for certain damages or losses.',
-  'limitation of liability': 'A cap on the amount one party can claim from the other.',
-  'non-compete': 'Restricts a party from competing within a specified scope and timeframe.',
-  'confidentiality': 'Obligations to keep certain information private.',
-  'termination': 'Conditions under which the agreement may be ended.',
-};
-
-export class ContractReviewSkill extends BaseSkill {
-  name = 'contract-review';
-  description = 'Review contracts and identify key clauses';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    for (const [term, explanation] of Object.entries(LEGAL_TERMS)) {
-      if (lower.includes(term)) {
-        return this.match(`📋 **${term.toUpperCase()}**: ${explanation}`, 0.85);
-      }
-    }
-    if (lower.includes('review') || lower.includes('contract')) {
-      return this.match('I can review contracts for key clauses like force majeure, indemnification, limitation of liability, non-compete, confidentiality, and termination provisions.', 0.7);
-    }
-    return this.noMatch();
-  }
-}
-
-export class ComplianceCheckSkill extends BaseSkill {
-  name = 'compliance-check';
-  description = 'Check compliance with regulations';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('gdpr') || lower.includes('privacy')) {
-      return this.match('GDPR compliance requires: data minimization, consent mechanisms, right to erasure, data protection officer, and breach notification within 72 hours.', 0.9);
-    }
-    if (lower.includes('compliance') || lower.includes('regulation')) {
-      return this.match('I can check compliance with GDPR, CCPA, SOX, HIPAA, and other major regulations. Please specify the regulation and context.', 0.7);
-    }
-    return this.noMatch();
-  }
-}
-
-export function createLegalAssistantConfig(): OADDocument {
-  return {
-    apiVersion: 'opc/v1',
-    kind: 'Agent',
-    metadata: {
-      name: 'legal-assistant',
-      version: '1.0.0',
-      description: 'AI Legal Assistant - contract review, compliance checking, legal research',
-      author: 'OPC',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      model: 'deepseek-chat',
-      systemPrompt: 'You are a legal assistant AI. Help users review contracts, check compliance, and research legal topics. Always recommend consulting a qualified attorney for binding decisions.',
-      skills: [
-        { name: 'contract-review', description: 'Review contracts and identify key clauses' },
-        { name: 'compliance-check', description: 'Check regulatory compliance' },
-      ],
-      channels: [{ type: 'web', port: 3000 }],
-      memory: { shortTerm: true, longTerm: false },
-      streaming: false,
-    },
-  };
-}

package/src/templates/project-manager.ts

@@ -1,58 +0,0 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-
-export class TaskTrackingSkill extends BaseSkill {
-  name = 'task-tracking';
-  description = 'Track project tasks and status';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('task') || lower.includes('todo') || lower.includes('progress')) {
-      return this.match(
-        'I can help track tasks. Tell me the task name, assignee, and deadline, and I\'ll add it to the tracker.',
-        0.8,
-      );
-    }
-    return this.noMatch();
-  }
-}
-
-export class MeetingNotesSkill extends BaseSkill {
-  name = 'meeting-notes';
-  description = 'Generate and manage meeting notes';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('meeting') || lower.includes('notes') || lower.includes('minutes')) {
-      return this.match(
-        'I can help with meeting notes. Share the meeting details and I\'ll create structured notes with action items.',
-        0.8,
-      );
-    }
-    return this.noMatch();
-  }
-}
-
-export function createProjectManagerConfig() {
-  return {
-    apiVersion: 'opc/v1',
-    kind: 'Agent',
-    metadata: {
-      name: 'project-manager',
-      version: '1.0.0',
-      description: 'Project Manager — task tracking, status updates, meeting notes',
-      author: 'Deepleaper',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      model: 'deepseek-chat',
-      systemPrompt: 'You are a project management assistant. Help track tasks, provide status updates, and manage meeting notes. Be organized and action-oriented.',
-      skills: [
-        { name: 'task-tracking', description: 'Track tasks' },
-        { name: 'meeting-notes', description: 'Manage meeting notes' },
-      ],
-      channels: [{ type: 'web', port: 3000 }],
-    },
-  };
-}

package/src/templates/sales-assistant.ts

@@ -1,75 +0,0 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-export class ProductQASkill extends BaseSkill {
-  name = 'product-qa';
-  description = 'Answer product-related questions';
-  private catalog: Record<string, string>;
-
-  constructor(catalog?: Record<string, string>) {
-    super();
-    this.catalog = catalog ?? {
-      pricing: 'Please visit our pricing page or contact sales for a custom quote.',
-      features: 'Our product includes AI-powered automation, analytics dashboard, and API access.',
-      demo: 'I\'d love to schedule a demo for you! Could you share your email and preferred time?',
-    };
-  }
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    for (const [key, answer] of Object.entries(this.catalog)) {
-      if (lower.includes(key)) return this.match(answer, 0.85);
-    }
-    return this.noMatch();
-  }
-}
-
-export class LeadCaptureSkill extends BaseSkill {
-  name = 'lead-capture';
-  description = 'Capture prospect information';
-  private emailRegex = /[\w.-]+@[\w.-]+\.\w+/;
-
-  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
-    const email = message.content.match(this.emailRegex);
-    if (email) {
-      await context.memory.set(`lead:${email[0]}`, {
-        email: email[0],
-        capturedAt: Date.now(),
-        messages: context.messages.length,
-      });
-      return this.match(`Thanks! I've noted your email (${email[0]}). Our team will reach out shortly.`, 0.95);
-    }
-    return this.noMatch();
-  }
-}
-
-export const SALES_ASSISTANT_SYSTEM_PROMPT = `You are a professional sales assistant. Your goals:
-1. Answer product questions accurately and enthusiastically
-2. Capture leads by collecting name, email, and company info
-3. Book appointments when prospects are ready
-Be friendly, persuasive but not pushy. Always provide value first.`;
-
-export function createSalesAssistantConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'sales-assistant',
-      version: '1.0.0',
-      description: 'AI sales assistant with product Q&A, lead capture, and appointment booking',
-      author: 'OPC Agent',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
-      model: 'deepseek-chat',
-      systemPrompt: SALES_ASSISTANT_SYSTEM_PROMPT,
-      skills: [
-        { name: 'product-qa', description: 'Answer product questions' },
-        { name: 'lead-capture', description: 'Capture prospect info' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: false },
-    },
-  };
-}

package/src/templates/teacher.ts

@@ -1,75 +0,0 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-export class LessonPlanSkill extends BaseSkill {
-  name = 'lesson-plan';
-  description = 'Create and manage lesson plans';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('lesson') || lower.includes('plan') || lower.includes('curriculum') || lower.includes('syllabus')) {
-      return this.match('I can help create a lesson plan. What subject, grade level, and learning objectives should I focus on?', 0.85);
-    }
-    return this.noMatch();
-  }
-}
-
-export class QuizSkill extends BaseSkill {
-  name = 'quiz-generator';
-  description = 'Generate quizzes and assessments';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('quiz') || lower.includes('test') || lower.includes('assessment') || lower.includes('exam') || lower.includes('question')) {
-      return this.match('I\'ll create a quiz for you. What topic, difficulty level, and number of questions would you like?', 0.85);
-    }
-    return this.noMatch();
-  }
-}
-
-export class ExplainSkill extends BaseSkill {
-  name = 'concept-explainer';
-  description = 'Explain concepts at appropriate level';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('explain') || lower.includes('what is') || lower.includes('how does') || lower.includes('why')) {
-      return this.match('Let me explain that concept. What\'s your current level of understanding so I can tailor my explanation?', 0.75);
-    }
-    return this.noMatch();
-  }
-}
-
-export const TEACHER_SYSTEM_PROMPT = `You are a patient and encouraging teacher assistant. Your goals:
-1. Create engaging lesson plans tailored to student level
-2. Generate quizzes and assessments with answer keys
-3. Explain complex concepts using analogies and examples
-4. Provide constructive feedback and encouragement
-5. Adapt teaching style to different learning preferences
-Be patient, use clear language, and always check for understanding. Use the Socratic method when appropriate.`;
-
-export function createTeacherConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'teacher',
-      version: '1.0.0',
-      description: 'AI teacher assistant with lesson planning, quiz generation, and concept explanation',
-      author: 'OPC Agent',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      provider: { default: 'openai', allowed: ['openai', 'deepseek', 'qwen'] },
-      model: 'gpt-4o-mini',
-      systemPrompt: TEACHER_SYSTEM_PROMPT,
-      skills: [
-        { name: 'lesson-plan', description: 'Create lesson plans' },
-        { name: 'quiz-generator', description: 'Generate quizzes' },
-        { name: 'concept-explainer', description: 'Explain concepts' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: true },
-    },
-  };
-}

package/src/testing/index.ts

@@ -1,181 +0,0 @@
-/**
- * Agent Testing Framework - Define test cases in OAD, run with `opc test`.
- * Supports assertions on response content, tool calls, and latency.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import * as yaml from 'js-yaml';
-import { AgentRuntime } from '../core/runtime';
-
-export interface TestCase {
-  name: string;
-  input: string;
-  expect?: {
-    contains?: string[];
-    notContains?: string[];
-    toolCalled?: string[];
-    maxLatencyMs?: number;
-  };
-}
-
-export interface TestResult {
-  name: string;
-  passed: boolean;
-  durationMs: number;
-  response?: string;
-  failures: string[];
-}
-
-export interface TestReport {
-  total: number;
-  passed: number;
-  failed: number;
-  duration: number;
-  results: TestResult[];
-}
-
-/**
- * Load test cases from OAD spec.testing or a separate test file.
- */
-export function loadTestCases(oadPath: string): TestCase[] {
-  const raw = fs.readFileSync(oadPath, 'utf-8');
-  const config = yaml.load(raw) as any;
-
-  // Check spec.testing.cases
-  if (config?.spec?.testing?.cases) {
-    return config.spec.testing.cases;
-  }
-
-  // Check for companion test file
-  const dir = path.dirname(oadPath);
-  const testFile = path.join(dir, 'tests.yaml');
-  if (fs.existsSync(testFile)) {
-    const testRaw = fs.readFileSync(testFile, 'utf-8');
-    const testConfig = yaml.load(testRaw) as any;
-    return testConfig?.cases ?? testConfig ?? [];
-  }
-
-  return [];
-}
-
-/**
- * Run all test cases against an agent.
- */
-export async function runTests(oadPath: string): Promise<TestReport> {
-  const cases = loadTestCases(oadPath);
-  const results: TestResult[] = [];
-  const startTime = Date.now();
-
-  if (cases.length === 0) {
-    // Generate default smoke test
-    cases.push({
-      name: 'smoke-test',
-      input: 'Hello! What can you help me with?',
-      expect: { maxLatencyMs: 30000 },
-    });
-  }
-
-  const runtime = new AgentRuntime();
-  await runtime.loadConfig(oadPath);
-  const agent = await runtime.initialize();
-
-  for (const tc of cases) {
-    const result: TestResult = {
-      name: tc.name,
-      passed: true,
-      durationMs: 0,
-      failures: [],
-    };
-
-    const t0 = Date.now();
-    try {
-      const response = await agent.handleMessage({
-        id: `test_${Date.now()}`,
-        role: 'user',
-        content: tc.input,
-        timestamp: Date.now(),
-      });
-      result.durationMs = Date.now() - t0;
-      result.response = response.content;
-
-      if (tc.expect) {
-        // Check contains
-        if (tc.expect.contains) {
-          for (const s of tc.expect.contains) {
-            if (!response.content.toLowerCase().includes(s.toLowerCase())) {
-              result.failures.push(`Expected response to contain "${s}"`);
-            }
-          }
-        }
-        // Check notContains
-        if (tc.expect.notContains) {
-          for (const s of tc.expect.notContains) {
-            if (response.content.toLowerCase().includes(s.toLowerCase())) {
-              result.failures.push(`Expected response NOT to contain "${s}"`);
-            }
-          }
-        }
-        // Check latency
-        if (tc.expect.maxLatencyMs && result.durationMs > tc.expect.maxLatencyMs) {
-          result.failures.push(`Latency ${result.durationMs}ms exceeded max ${tc.expect.maxLatencyMs}ms`);
-        }
-        // Check tool calls (from metadata if available)
-        if (tc.expect.toolCalled && (response as any).toolsCalled) {
-          for (const tool of tc.expect.toolCalled) {
-            if (!(response as any).toolsCalled.includes(tool)) {
-              result.failures.push(`Expected tool "${tool}" to be called`);
-            }
-          }
-        }
-      }
-
-      result.passed = result.failures.length === 0;
-    } catch (err) {
-      result.durationMs = Date.now() - t0;
-      result.passed = false;
-      result.failures.push(`Error: ${err instanceof Error ? err.message : String(err)}`);
-    }
-
-    results.push(result);
-  }
-
-  const totalDuration = Date.now() - startTime;
-  const passed = results.filter(r => r.passed).length;
-
-  return {
-    total: results.length,
-    passed,
-    failed: results.length - passed,
-    duration: totalDuration,
-    results,
-  };
-}
-
-/**
- * Format test report for console output.
- */
-export function formatReport(report: TestReport): string {
-  const lines: string[] = [];
-  lines.push('');
-  lines.push('═══════════════════════════════════════════');
-  lines.push('  OPC Agent Test Report');
-  lines.push('═══════════════════════════════════════════');
-  lines.push('');
-
-  for (const r of report.results) {
-    const icon = r.passed ? '✔' : '✘';
-    const status = r.passed ? 'PASS' : 'FAIL';
-    lines.push(`  ${icon} [${status}] ${r.name} (${r.durationMs}ms)`);
-    for (const f of r.failures) {
-      lines.push(`      → ${f}`);
-    }
-  }
-
-  lines.push('');
-  lines.push('───────────────────────────────────────────');
-  lines.push(`  Total: ${report.total}  Passed: ${report.passed}  Failed: ${report.failed}  Duration: ${report.duration}ms`);
-  lines.push('───────────────────────────────────────────');
-  lines.push('');
-
-  return lines.join('\n');
-}