opc-agent 1.2.0 → 1.2.1

package/src/skills/scheduler.ts

@@ -1,80 +1,80 @@
-import { BaseSkill } from './base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-export interface ScheduledTask {
-  id: string;
-  name: string;
-  cronExpr: string;
-  action: string;
-  enabled: boolean;
-  lastRun?: number;
-  nextRun?: number;
-}
-
-export class SchedulerSkill extends BaseSkill {
-  name = 'scheduler';
-  description = 'Schedule recurring tasks. Usage: schedule list | schedule add <name> <cron> <action> | schedule remove <id>';
-  private tasks: Map<string, ScheduledTask> = new Map();
-  private timers: Map<string, NodeJS.Timeout> = new Map();
-
-  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
-    const text = message.content.trim();
-
-    if (/^schedule\s+list$/i.test(text)) {
-      if (this.tasks.size === 0) return this.match('No scheduled tasks.');
-      const lines = Array.from(this.tasks.values()).map(t =>
-        `• ${t.name} (${t.id}) — ${t.cronExpr} — ${t.enabled ? '✅' : '❌'} — Last: ${t.lastRun ? new Date(t.lastRun).toISOString() : 'never'}`
-      );
-      return this.match(`Scheduled tasks:\n${lines.join('\n')}`);
-    }
-
-    const addMatch = text.match(/^schedule\s+add\s+(\S+)\s+(".*?"|\S+)\s+(.+)$/i);
-    if (addMatch) {
-      const [, name, cronExpr, action] = addMatch;
-      const id = `task_${Date.now().toString(36)}`;
-      const task: ScheduledTask = {
-        id, name, cronExpr: cronExpr.replace(/"/g, ''), action, enabled: true,
-      };
-      this.tasks.set(id, task);
-      // Simple interval-based scheduling (parse cron for interval in minutes)
-      const intervalMs = this.parseCronToInterval(task.cronExpr);
-      if (intervalMs > 0) {
-        const timer = setInterval(() => {
-          task.lastRun = Date.now();
-        }, intervalMs);
-        this.timers.set(id, timer);
-      }
-      return this.match(`Task scheduled: ${name} (${id}) — ${task.cronExpr} → "${action}"`);
-    }
-
-    const rmMatch = text.match(/^schedule\s+remove\s+(\S+)$/i);
-    if (rmMatch) {
-      const id = rmMatch[1];
-      const timer = this.timers.get(id);
-      if (timer) clearInterval(timer);
-      this.timers.delete(id);
-      const removed = this.tasks.delete(id);
-      return this.match(removed ? `Task ${id} removed.` : `Task ${id} not found.`);
-    }
-
-    return this.noMatch();
-  }
-
-  private parseCronToInterval(expr: string): number {
-    // Simple: support "every Xm" or "every Xh" or basic intervals
-    const m = expr.match(/every\s+(\d+)\s*(m|min|h|hr|s|sec)/i);
-    if (m) {
-      const val = parseInt(m[1]);
-      const unit = m[2].toLowerCase();
-      if (unit.startsWith('h')) return val * 3600_000;
-      if (unit.startsWith('m')) return val * 60_000;
-      if (unit.startsWith('s')) return val * 1000;
-    }
-    return 0; // Unknown cron format, no auto-schedule
-  }
-
-  destroy(): void {
-    for (const timer of this.timers.values()) clearInterval(timer);
-    this.timers.clear();
-  }
-}
+import { BaseSkill } from './base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+
+export interface ScheduledTask {
+  id: string;
+  name: string;
+  cronExpr: string;
+  action: string;
+  enabled: boolean;
+  lastRun?: number;
+  nextRun?: number;
+}
+
+export class SchedulerSkill extends BaseSkill {
+  name = 'scheduler';
+  description = 'Schedule recurring tasks. Usage: schedule list | schedule add <name> <cron> <action> | schedule remove <id>';
+  private tasks: Map<string, ScheduledTask> = new Map();
+  private timers: Map<string, NodeJS.Timeout> = new Map();
+
+  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
+    const text = message.content.trim();
+
+    if (/^schedule\s+list$/i.test(text)) {
+      if (this.tasks.size === 0) return this.match('No scheduled tasks.');
+      const lines = Array.from(this.tasks.values()).map(t =>
+        `• ${t.name} (${t.id}) — ${t.cronExpr} — ${t.enabled ? '✅' : '❌'} — Last: ${t.lastRun ? new Date(t.lastRun).toISOString() : 'never'}`
+      );
+      return this.match(`Scheduled tasks:\n${lines.join('\n')}`);
+    }
+
+    const addMatch = text.match(/^schedule\s+add\s+(\S+)\s+(".*?"|\S+)\s+(.+)$/i);
+    if (addMatch) {
+      const [, name, cronExpr, action] = addMatch;
+      const id = `task_${Date.now().toString(36)}`;
+      const task: ScheduledTask = {
+        id, name, cronExpr: cronExpr.replace(/"/g, ''), action, enabled: true,
+      };
+      this.tasks.set(id, task);
+      // Simple interval-based scheduling (parse cron for interval in minutes)
+      const intervalMs = this.parseCronToInterval(task.cronExpr);
+      if (intervalMs > 0) {
+        const timer = setInterval(() => {
+          task.lastRun = Date.now();
+        }, intervalMs);
+        this.timers.set(id, timer);
+      }
+      return this.match(`Task scheduled: ${name} (${id}) — ${task.cronExpr} → "${action}"`);
+    }
+
+    const rmMatch = text.match(/^schedule\s+remove\s+(\S+)$/i);
+    if (rmMatch) {
+      const id = rmMatch[1];
+      const timer = this.timers.get(id);
+      if (timer) clearInterval(timer);
+      this.timers.delete(id);
+      const removed = this.tasks.delete(id);
+      return this.match(removed ? `Task ${id} removed.` : `Task ${id} not found.`);
+    }
+
+    return this.noMatch();
+  }
+
+  private parseCronToInterval(expr: string): number {
+    // Simple: support "every Xm" or "every Xh" or basic intervals
+    const m = expr.match(/every\s+(\d+)\s*(m|min|h|hr|s|sec)/i);
+    if (m) {
+      const val = parseInt(m[1]);
+      const unit = m[2].toLowerCase();
+      if (unit.startsWith('h')) return val * 3600_000;
+      if (unit.startsWith('m')) return val * 60_000;
+      if (unit.startsWith('s')) return val * 1000;
+    }
+    return 0; // Unknown cron format, no auto-schedule
+  }
+
+  destroy(): void {
+    for (const timer of this.timers.values()) clearInterval(timer);
+    this.timers.clear();
+  }
+}

package/src/skills/webhook-trigger.ts

@@ -1,59 +1,59 @@
-import { BaseSkill } from './base';
-import type { AgentContext, Message, SkillResult } from '../core/types';
-
-export interface WebhookTarget {
-  name: string;
-  url: string;
-  method?: string;
-  headers?: Record<string, string>;
-  secret?: string;
-}
-
-export class WebhookTriggerSkill extends BaseSkill {
-  name = 'webhook-trigger';
-  description = 'Trigger external webhooks. Usage: webhook <name> [payload JSON]';
-  private targets: Map<string, WebhookTarget> = new Map();
-
-  registerTarget(target: WebhookTarget): void {
-    this.targets.set(target.name, target);
-  }
-
-  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
-    const match = message.content.trim().match(/^webhook\s+(\S+)(?:\s+(.+))?$/is);
-    if (!match) return this.noMatch();
-
-    const [, name, payloadStr] = match;
-    const target = this.targets.get(name);
-    if (!target) {
-      const available = Array.from(this.targets.keys()).join(', ') || 'none';
-      return this.match(`Unknown webhook "${name}". Available: ${available}`);
-    }
-
-    try {
-      const headers: Record<string, string> = {
-        'Content-Type': 'application/json',
-        'User-Agent': 'OPC-Agent/0.7.0',
-        ...target.headers,
-      };
-      if (target.secret) {
-        headers['X-Webhook-Secret'] = target.secret;
-      }
-
-      const body = payloadStr ?? JSON.stringify({
-        agent: context.agentName,
-        timestamp: Date.now(),
-        trigger: 'manual',
-      });
-
-      const res = await fetch(target.url, {
-        method: target.method ?? 'POST',
-        headers,
-        body,
-      });
-
-      return this.match(`Webhook "${name}" triggered → ${res.status} ${res.statusText}`);
-    } catch (err) {
-      return this.match(`Webhook error: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-}
+import { BaseSkill } from './base';
+import type { AgentContext, Message, SkillResult } from '../core/types';
+
+export interface WebhookTarget {
+  name: string;
+  url: string;
+  method?: string;
+  headers?: Record<string, string>;
+  secret?: string;
+}
+
+export class WebhookTriggerSkill extends BaseSkill {
+  name = 'webhook-trigger';
+  description = 'Trigger external webhooks. Usage: webhook <name> [payload JSON]';
+  private targets: Map<string, WebhookTarget> = new Map();
+
+  registerTarget(target: WebhookTarget): void {
+    this.targets.set(target.name, target);
+  }
+
+  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
+    const match = message.content.trim().match(/^webhook\s+(\S+)(?:\s+(.+))?$/is);
+    if (!match) return this.noMatch();
+
+    const [, name, payloadStr] = match;
+    const target = this.targets.get(name);
+    if (!target) {
+      const available = Array.from(this.targets.keys()).join(', ') || 'none';
+      return this.match(`Unknown webhook "${name}". Available: ${available}`);
+    }
+
+    try {
+      const headers: Record<string, string> = {
+        'Content-Type': 'application/json',
+        'User-Agent': 'OPC-Agent/0.7.0',
+        ...target.headers,
+      };
+      if (target.secret) {
+        headers['X-Webhook-Secret'] = target.secret;
+      }
+
+      const body = payloadStr ?? JSON.stringify({
+        agent: context.agentName,
+        timestamp: Date.now(),
+        trigger: 'manual',
+      });
+
+      const res = await fetch(target.url, {
+        method: target.method ?? 'POST',
+        headers,
+        body,
+      });
+
+      return this.match(`Webhook "${name}" triggered → ${res.status} ${res.statusText}`);
+    } catch (err) {
+      return this.match(`Webhook error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+}

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'] },
+      },
+    },
+  };
+}