opc-agent 1.1.0 → 1.1.2

package/src/templates/knowledge-base.ts

@@ -1,31 +1,31 @@
-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' } },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['queries_answered', 'docs_indexed'] },
-      },
-    },
-  };
-}
+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' } },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['queries_answered', 'docs_indexed'] },
+      },
+    },
+  };
+}

package/src/templates/legal-assistant.ts

@@ -1,71 +1,71 @@
-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,
-    },
-  };
-}
+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/sales-assistant.ts

@@ -1,79 +1,79 @@
-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 },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['leads_captured', 'appointments_booked'] },
-      },
-    },
-  };
-}
+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 },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['leads_captured', 'appointments_booked'] },
+      },
+    },
+  };
+}

package/src/templates/teacher.ts

@@ -1,79 +1,79 @@
-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 },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['lessons_created', 'quizzes_generated', 'concepts_explained'] },
-      },
-    },
-  };
-}
+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 },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['lessons_created', 'quizzes_generated', 'concepts_explained'] },
+      },
+    },
+  };
+}