opc-agent 1.1.0 → 1.1.2

package/src/templates/code-reviewer.ts

@@ -1,34 +1,34 @@
-export const CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
-1. Check for bugs, security issues, and performance problems
-2. Suggest improvements for readability and maintainability
-3. Follow language-specific best practices
-4. Be constructive and explain your reasoning
-Rate severity: 🔴 Critical | 🟡 Warning | 🔵 Info`;
-
-export function createCodeReviewerConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'code-reviewer',
-      version: '1.0.0',
-      description: 'AI code reviewer that reviews code and suggests improvements',
-      author: 'OPC Agent',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
-      model: 'deepseek-chat',
-      systemPrompt: CODE_REVIEWER_SYSTEM_PROMPT,
-      skills: [
-        { name: 'code-analysis', description: 'Analyze code for bugs' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: false },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['reviews_completed', 'issues_found'] },
-      },
-    },
-  };
-}
+export const CODE_REVIEWER_SYSTEM_PROMPT = `You are an expert code reviewer. When given code:
+1. Check for bugs, security issues, and performance problems
+2. Suggest improvements for readability and maintainability
+3. Follow language-specific best practices
+4. Be constructive and explain your reasoning
+Rate severity: 🔴 Critical | 🟡 Warning | 🔵 Info`;
+
+export function createCodeReviewerConfig() {
+  return {
+    apiVersion: 'opc/v1' as const,
+    kind: 'Agent' as const,
+    metadata: {
+      name: 'code-reviewer',
+      version: '1.0.0',
+      description: 'AI code reviewer that reviews code and suggests improvements',
+      author: 'OPC Agent',
+      license: 'Apache-2.0',
+    },
+    spec: {
+      provider: { default: 'deepseek', allowed: ['openai', 'deepseek', 'qwen'] },
+      model: 'deepseek-chat',
+      systemPrompt: CODE_REVIEWER_SYSTEM_PROMPT,
+      skills: [
+        { name: 'code-analysis', description: 'Analyze code for bugs' },
+      ],
+      channels: [{ type: 'web' as const, port: 3000 }],
+      memory: { shortTerm: true, longTerm: false },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['reviews_completed', 'issues_found'] },
+      },
+    },
+  };
+}

package/src/templates/customer-service.ts

@@ -1,80 +1,80 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-const DEFAULT_FAQ: Record<string, string> = {
-  'hours': 'Our business hours are Monday-Friday, 9am-6pm.',
-  'return': 'You can return items within 30 days of purchase.',
-  'shipping': 'Standard shipping takes 3-5 business days.',
-  'contact': 'You can reach us at support@example.com.',
-};
-
-export class FAQSkill extends BaseSkill {
-  name = 'faq-lookup';
-  description = 'Look up FAQ answers';
-  private faq: Record<string, string>;
-
-  constructor(faq?: Record<string, string>) {
-    super();
-    this.faq = faq ?? DEFAULT_FAQ;
-  }
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    for (const [key, answer] of Object.entries(this.faq)) {
-      if (lower.includes(key)) {
-        return this.match(answer, 0.9);
-      }
-    }
-    return this.noMatch();
-  }
-}
-
-export class HandoffSkill extends BaseSkill {
-  name = 'human-handoff';
-  description = 'Hand off to a human agent when confidence is low';
-  private keywords = ['speak to human', 'talk to agent', 'real person', 'human agent'];
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (this.keywords.some((kw) => lower.includes(kw))) {
-      return this.match(
-        'I understand you\'d like to speak with a human agent. Let me connect you now. Please hold.',
-        1.0
-      );
-    }
-    return this.noMatch();
-  }
-}
-
-export const CUSTOMER_SERVICE_SYSTEM_PROMPT = `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.`;
-
-export function createCustomerServiceConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'customer-service',
-      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: CUSTOMER_SERVICE_SYSTEM_PROMPT,
-      skills: [
-        { name: 'faq-lookup', description: 'Look up FAQ answers' },
-        { name: 'human-handoff', description: 'Hand off to human agent' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: false },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['response_time', 'satisfaction_score'] },
-      },
-    },
-  };
-}
+import { BaseSkill } from '../skills/base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+
+const DEFAULT_FAQ: Record<string, string> = {
+  'hours': 'Our business hours are Monday-Friday, 9am-6pm.',
+  'return': 'You can return items within 30 days of purchase.',
+  'shipping': 'Standard shipping takes 3-5 business days.',
+  'contact': 'You can reach us at support@example.com.',
+};
+
+export class FAQSkill extends BaseSkill {
+  name = 'faq-lookup';
+  description = 'Look up FAQ answers';
+  private faq: Record<string, string>;
+
+  constructor(faq?: Record<string, string>) {
+    super();
+    this.faq = faq ?? DEFAULT_FAQ;
+  }
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    for (const [key, answer] of Object.entries(this.faq)) {
+      if (lower.includes(key)) {
+        return this.match(answer, 0.9);
+      }
+    }
+    return this.noMatch();
+  }
+}
+
+export class HandoffSkill extends BaseSkill {
+  name = 'human-handoff';
+  description = 'Hand off to a human agent when confidence is low';
+  private keywords = ['speak to human', 'talk to agent', 'real person', 'human agent'];
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (this.keywords.some((kw) => lower.includes(kw))) {
+      return this.match(
+        'I understand you\'d like to speak with a human agent. Let me connect you now. Please hold.',
+        1.0
+      );
+    }
+    return this.noMatch();
+  }
+}
+
+export const CUSTOMER_SERVICE_SYSTEM_PROMPT = `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.`;
+
+export function createCustomerServiceConfig() {
+  return {
+    apiVersion: 'opc/v1' as const,
+    kind: 'Agent' as const,
+    metadata: {
+      name: 'customer-service',
+      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: CUSTOMER_SERVICE_SYSTEM_PROMPT,
+      skills: [
+        { name: 'faq-lookup', description: 'Look up FAQ answers' },
+        { name: 'human-handoff', description: 'Hand off to human agent' },
+      ],
+      channels: [{ type: 'web' as const, port: 3000 }],
+      memory: { shortTerm: true, longTerm: false },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['response_time', 'satisfaction_score'] },
+      },
+    },
+  };
+}

package/src/templates/data-analyst.ts

@@ -1,70 +1,70 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-export class DataQuerySkill extends BaseSkill {
-  name = 'data-query';
-  description = 'Help users query and analyze data';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('average') || lower.includes('mean') || lower.includes('sum') || lower.includes('count')) {
-      return this.match('I can help with that calculation. Could you share the dataset or describe the data source?', 0.8);
-    }
-    if (lower.includes('chart') || lower.includes('graph') || lower.includes('visualize') || lower.includes('plot')) {
-      return this.match('I can help create visualizations. What type of chart would you like? (bar, line, pie, scatter)', 0.85);
-    }
-    if (lower.includes('csv') || lower.includes('excel') || lower.includes('spreadsheet')) {
-      return this.match('I can analyze CSV/Excel data. Please share the file or paste the data.', 0.8);
-    }
-    return this.noMatch();
-  }
-}
-
-export class InsightSkill extends BaseSkill {
-  name = 'insight-generator';
-  description = 'Generate insights from data patterns';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('trend') || lower.includes('pattern') || lower.includes('insight') || lower.includes('anomaly')) {
-      return this.match('I\'ll analyze the data for trends and anomalies. Please provide the dataset or describe what you\'re looking for.', 0.8);
-    }
-    return this.noMatch();
-  }
-}
-
-export const DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
-1. Help users query, transform, and analyze data
-2. Create clear visualizations and summaries
-3. Identify trends, patterns, and anomalies
-4. Explain findings in plain language
-Be precise with numbers, always cite your data source, and suggest next steps for deeper analysis.`;
-
-export function createDataAnalystConfig() {
-  return {
-    apiVersion: 'opc/v1' as const,
-    kind: 'Agent' as const,
-    metadata: {
-      name: 'data-analyst',
-      version: '1.0.0',
-      description: 'AI data analyst with data querying, visualization, and insight generation',
-      author: 'OPC Agent',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      provider: { default: 'openai', allowed: ['openai', 'deepseek', 'qwen'] },
-      model: 'gpt-4o-mini',
-      systemPrompt: DATA_ANALYST_SYSTEM_PROMPT,
-      skills: [
-        { name: 'data-query', description: 'Query and transform data' },
-        { name: 'insight-generator', description: 'Generate data insights' },
-      ],
-      channels: [{ type: 'web' as const, port: 3000 }],
-      memory: { shortTerm: true, longTerm: true },
-      dtv: {
-        trust: { level: 'sandbox' as const },
-        value: { metrics: ['queries_processed', 'insights_generated'] },
-      },
-    },
-  };
-}
+import { BaseSkill } from '../skills/base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+
+export class DataQuerySkill extends BaseSkill {
+  name = 'data-query';
+  description = 'Help users query and analyze data';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('average') || lower.includes('mean') || lower.includes('sum') || lower.includes('count')) {
+      return this.match('I can help with that calculation. Could you share the dataset or describe the data source?', 0.8);
+    }
+    if (lower.includes('chart') || lower.includes('graph') || lower.includes('visualize') || lower.includes('plot')) {
+      return this.match('I can help create visualizations. What type of chart would you like? (bar, line, pie, scatter)', 0.85);
+    }
+    if (lower.includes('csv') || lower.includes('excel') || lower.includes('spreadsheet')) {
+      return this.match('I can analyze CSV/Excel data. Please share the file or paste the data.', 0.8);
+    }
+    return this.noMatch();
+  }
+}
+
+export class InsightSkill extends BaseSkill {
+  name = 'insight-generator';
+  description = 'Generate insights from data patterns';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('trend') || lower.includes('pattern') || lower.includes('insight') || lower.includes('anomaly')) {
+      return this.match('I\'ll analyze the data for trends and anomalies. Please provide the dataset or describe what you\'re looking for.', 0.8);
+    }
+    return this.noMatch();
+  }
+}
+
+export const DATA_ANALYST_SYSTEM_PROMPT = `You are a professional data analyst assistant. Your goals:
+1. Help users query, transform, and analyze data
+2. Create clear visualizations and summaries
+3. Identify trends, patterns, and anomalies
+4. Explain findings in plain language
+Be precise with numbers, always cite your data source, and suggest next steps for deeper analysis.`;
+
+export function createDataAnalystConfig() {
+  return {
+    apiVersion: 'opc/v1' as const,
+    kind: 'Agent' as const,
+    metadata: {
+      name: 'data-analyst',
+      version: '1.0.0',
+      description: 'AI data analyst with data querying, visualization, and insight generation',
+      author: 'OPC Agent',
+      license: 'Apache-2.0',
+    },
+    spec: {
+      provider: { default: 'openai', allowed: ['openai', 'deepseek', 'qwen'] },
+      model: 'gpt-4o-mini',
+      systemPrompt: DATA_ANALYST_SYSTEM_PROMPT,
+      skills: [
+        { name: 'data-query', description: 'Query and transform data' },
+        { name: 'insight-generator', description: 'Generate data insights' },
+      ],
+      channels: [{ type: 'web' as const, port: 3000 }],
+      memory: { shortTerm: true, longTerm: true },
+      dtv: {
+        trust: { level: 'sandbox' as const },
+        value: { metrics: ['queries_processed', 'insights_generated'] },
+      },
+    },
+  };
+}

package/src/templates/executive-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';
-
-export class CalendarSkill extends BaseSkill {
-  name = 'calendar-management';
-  description = 'Manage calendar and scheduling';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('schedule') || lower.includes('meeting') || lower.includes('calendar')) {
-      return this.match('I can help manage your calendar. I can schedule meetings, check availability, send invites, and set reminders. What would you like to do?', 0.8);
-    }
-    if (lower.includes('remind') || lower.includes('reminder')) {
-      return this.match('I\'ll set a reminder for you. Please provide the date, time, and what you\'d like to be reminded about.', 0.75);
-    }
-    return this.noMatch();
-  }
-}
-
-export class EmailDraftSkill extends BaseSkill {
-  name = 'email-drafting';
-  description = 'Draft professional emails';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('email') || lower.includes('draft') || lower.includes('write')) {
-      return this.match('I can draft emails for you. Please provide: the recipient, subject, key points to cover, and desired tone (formal/casual/friendly).', 0.8);
-    }
-    return this.noMatch();
-  }
-}
-
-export class MeetingPrepSkill extends BaseSkill {
-  name = 'meeting-prep';
-  description = 'Prepare for meetings with agendas and notes';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('agenda') || lower.includes('prep') || lower.includes('prepare')) {
-      return this.match('I can prepare meeting materials including: agenda creation, attendee briefings, talking points, action item tracking, and follow-up summaries.', 0.8);
-    }
-    return this.noMatch();
-  }
-}
-
-export function createExecutiveAssistantConfig(): OADDocument {
-  return {
-    apiVersion: 'opc/v1',
-    kind: 'Agent',
-    metadata: {
-      name: 'executive-assistant',
-      version: '1.0.0',
-      description: 'AI Executive Assistant - calendar management, email drafting, meeting prep',
-      author: 'OPC',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      model: 'deepseek-chat',
-      systemPrompt: 'You are an executive assistant AI. Help users manage their calendar, draft emails, and prepare for meetings. Be professional, concise, and proactive.',
-      skills: [
-        { name: 'calendar-management', description: 'Manage calendar and scheduling' },
-        { name: 'email-drafting', description: 'Draft professional emails' },
-        { name: 'meeting-prep', description: 'Prepare meeting materials' },
-      ],
-      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';
+
+export class CalendarSkill extends BaseSkill {
+  name = 'calendar-management';
+  description = 'Manage calendar and scheduling';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('schedule') || lower.includes('meeting') || lower.includes('calendar')) {
+      return this.match('I can help manage your calendar. I can schedule meetings, check availability, send invites, and set reminders. What would you like to do?', 0.8);
+    }
+    if (lower.includes('remind') || lower.includes('reminder')) {
+      return this.match('I\'ll set a reminder for you. Please provide the date, time, and what you\'d like to be reminded about.', 0.75);
+    }
+    return this.noMatch();
+  }
+}
+
+export class EmailDraftSkill extends BaseSkill {
+  name = 'email-drafting';
+  description = 'Draft professional emails';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('email') || lower.includes('draft') || lower.includes('write')) {
+      return this.match('I can draft emails for you. Please provide: the recipient, subject, key points to cover, and desired tone (formal/casual/friendly).', 0.8);
+    }
+    return this.noMatch();
+  }
+}
+
+export class MeetingPrepSkill extends BaseSkill {
+  name = 'meeting-prep';
+  description = 'Prepare for meetings with agendas and notes';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('agenda') || lower.includes('prep') || lower.includes('prepare')) {
+      return this.match('I can prepare meeting materials including: agenda creation, attendee briefings, talking points, action item tracking, and follow-up summaries.', 0.8);
+    }
+    return this.noMatch();
+  }
+}
+
+export function createExecutiveAssistantConfig(): OADDocument {
+  return {
+    apiVersion: 'opc/v1',
+    kind: 'Agent',
+    metadata: {
+      name: 'executive-assistant',
+      version: '1.0.0',
+      description: 'AI Executive Assistant - calendar management, email drafting, meeting prep',
+      author: 'OPC',
+      license: 'Apache-2.0',
+    },
+    spec: {
+      model: 'deepseek-chat',
+      systemPrompt: 'You are an executive assistant AI. Help users manage their calendar, draft emails, and prepare for meetings. Be professional, concise, and proactive.',
+      skills: [
+        { name: 'calendar-management', description: 'Manage calendar and scheduling' },
+        { name: 'email-drafting', description: 'Draft professional emails' },
+        { name: 'meeting-prep', description: 'Prepare meeting materials' },
+      ],
+      channels: [{ type: 'web', port: 3000 }],
+      memory: { shortTerm: true, longTerm: false },
+      streaming: false,
+    },
+  };
+}

package/src/templates/financial-advisor.ts

@@ -1,60 +1,60 @@
-import { BaseSkill } from '../skills/base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-import type { OADDocument } from '../schema/oad';
-
-export class BudgetAnalysisSkill extends BaseSkill {
-  name = 'budget-analysis';
-  description = 'Analyze budgets and expenses';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('budget') || lower.includes('expense') || lower.includes('cost')) {
-      return this.match('I can help analyze your budget. Please share your income and expense categories, and I\'ll provide insights on spending patterns and savings opportunities.', 0.8);
-    }
-    if (lower.includes('save') || lower.includes('saving')) {
-      return this.match('Common savings strategies: 50/30/20 rule (needs/wants/savings), automate transfers, review subscriptions, negotiate bills, and track daily spending.', 0.75);
-    }
-    return this.noMatch();
-  }
-}
-
-export class FinancialPlanningSkill extends BaseSkill {
-  name = 'financial-planning';
-  description = 'Help with financial planning and advice';
-
-  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
-    const lower = message.content.toLowerCase();
-    if (lower.includes('invest') || lower.includes('portfolio')) {
-      return this.match('For investment planning, consider: risk tolerance, time horizon, diversification, asset allocation, and regular rebalancing. This is general guidance — consult a certified financial advisor for personalized advice.', 0.8);
-    }
-    if (lower.includes('retire') || lower.includes('pension')) {
-      return this.match('Retirement planning essentials: estimate target savings (25x annual expenses), maximize employer matching, consider tax-advantaged accounts, and start early for compound growth.', 0.8);
-    }
-    return this.noMatch();
-  }
-}
-
-export function createFinancialAdvisorConfig(): OADDocument {
-  return {
-    apiVersion: 'opc/v1',
-    kind: 'Agent',
-    metadata: {
-      name: 'financial-advisor',
-      version: '1.0.0',
-      description: 'AI Financial Advisor - budget analysis, expense tracking, financial planning',
-      author: 'OPC',
-      license: 'Apache-2.0',
-    },
-    spec: {
-      model: 'deepseek-chat',
-      systemPrompt: 'You are a financial advisor AI. Help users with budget analysis, expense tracking, and financial planning. Always recommend consulting a certified financial advisor for binding decisions.',
-      skills: [
-        { name: 'budget-analysis', description: 'Analyze budgets and expenses' },
-        { name: 'financial-planning', description: 'Financial planning advice' },
-      ],
-      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';
+
+export class BudgetAnalysisSkill extends BaseSkill {
+  name = 'budget-analysis';
+  description = 'Analyze budgets and expenses';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('budget') || lower.includes('expense') || lower.includes('cost')) {
+      return this.match('I can help analyze your budget. Please share your income and expense categories, and I\'ll provide insights on spending patterns and savings opportunities.', 0.8);
+    }
+    if (lower.includes('save') || lower.includes('saving')) {
+      return this.match('Common savings strategies: 50/30/20 rule (needs/wants/savings), automate transfers, review subscriptions, negotiate bills, and track daily spending.', 0.75);
+    }
+    return this.noMatch();
+  }
+}
+
+export class FinancialPlanningSkill extends BaseSkill {
+  name = 'financial-planning';
+  description = 'Help with financial planning and advice';
+
+  async execute(_context: AgentContext, message: Message): Promise<SkillResult> {
+    const lower = message.content.toLowerCase();
+    if (lower.includes('invest') || lower.includes('portfolio')) {
+      return this.match('For investment planning, consider: risk tolerance, time horizon, diversification, asset allocation, and regular rebalancing. This is general guidance — consult a certified financial advisor for personalized advice.', 0.8);
+    }
+    if (lower.includes('retire') || lower.includes('pension')) {
+      return this.match('Retirement planning essentials: estimate target savings (25x annual expenses), maximize employer matching, consider tax-advantaged accounts, and start early for compound growth.', 0.8);
+    }
+    return this.noMatch();
+  }
+}
+
+export function createFinancialAdvisorConfig(): OADDocument {
+  return {
+    apiVersion: 'opc/v1',
+    kind: 'Agent',
+    metadata: {
+      name: 'financial-advisor',
+      version: '1.0.0',
+      description: 'AI Financial Advisor - budget analysis, expense tracking, financial planning',
+      author: 'OPC',
+      license: 'Apache-2.0',
+    },
+    spec: {
+      model: 'deepseek-chat',
+      systemPrompt: 'You are a financial advisor AI. Help users with budget analysis, expense tracking, and financial planning. Always recommend consulting a certified financial advisor for binding decisions.',
+      skills: [
+        { name: 'budget-analysis', description: 'Analyze budgets and expenses' },
+        { name: 'financial-planning', description: 'Financial planning advice' },
+      ],
+      channels: [{ type: 'web', port: 3000 }],
+      memory: { shortTerm: true, longTerm: false },
+      streaming: false,
+    },
+  };
+}