opc-agent 0.2.0 → 0.3.0

package/src/templates/hr-recruiter.ts

@@ -0,0 +1,58 @@
+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/project-manager.ts

@@ -0,0 +1,58 @@
+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/tools/mcp.ts

@@ -0,0 +1,76 @@
+import type { AgentContext, Message } from '../core/types';
+
+/**
+ * MCP (Model Context Protocol) compatible tool interface.
+ * Tools follow the MCP standard format with JSON Schema input validation.
+ */
+export interface MCPToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>; // JSON Schema
+}
+
+export interface MCPToolResult {
+  content: string;
+  isError?: boolean;
+  metadata?: Record<string, unknown>;
+}
+
+export interface MCPTool extends MCPToolDefinition {
+  execute(input: Record<string, unknown>, context?: AgentContext): Promise<MCPToolResult>;
+}
+
+export class MCPToolRegistry {
+  private tools: Map<string, MCPTool> = new Map();
+
+  register(tool: MCPTool): void {
+    this.tools.set(tool.name, tool);
+  }
+
+  unregister(name: string): void {
+    this.tools.delete(name);
+  }
+
+  get(name: string): MCPTool | undefined {
+    return this.tools.get(name);
+  }
+
+  list(): MCPToolDefinition[] {
+    return Array.from(this.tools.values()).map(({ name, description, inputSchema }) => ({
+      name,
+      description,
+      inputSchema,
+    }));
+  }
+
+  has(name: string): boolean {
+    return this.tools.has(name);
+  }
+
+  async execute(name: string, input: Record<string, unknown>, context?: AgentContext): Promise<MCPToolResult> {
+    const tool = this.tools.get(name);
+    if (!tool) {
+      return { content: `Tool '${name}' not found`, isError: true };
+    }
+    try {
+      return await tool.execute(input, context);
+    } catch (err) {
+      return {
+        content: `Tool execution error: ${err instanceof Error ? err.message : String(err)}`,
+        isError: true,
+      };
+    }
+  }
+}
+
+/**
+ * Create an MCP tool from a simple function.
+ */
+export function createMCPTool(
+  name: string,
+  description: string,
+  inputSchema: Record<string, unknown>,
+  executeFn: (input: Record<string, unknown>, context?: AgentContext) => Promise<MCPToolResult>,
+): MCPTool {
+  return { name, description, inputSchema, execute: executeFn };
+}

package/tests/analytics.test.ts

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest';
+import { Analytics } from '../src/analytics';
+
+describe('Analytics', () => {
+  it('should track messages', () => {
+    const analytics = new Analytics();
+    analytics.recordMessage(100);
+    analytics.recordMessage(200);
+    const snap = analytics.getSnapshot();
+    expect(snap.messagesProcessed).toBe(2);
+    expect(snap.avgResponseTimeMs).toBe(150);
+  });
+
+  it('should track skill usage', () => {
+    const analytics = new Analytics();
+    analytics.recordSkillUsage('faq');
+    analytics.recordSkillUsage('faq');
+    analytics.recordSkillUsage('handoff');
+    const snap = analytics.getSnapshot();
+    expect(snap.skillUsage['faq']).toBe(2);
+    expect(snap.skillUsage['handoff']).toBe(1);
+  });
+
+  it('should track errors', () => {
+    const analytics = new Analytics();
+    analytics.recordError();
+    analytics.recordError();
+    expect(analytics.getSnapshot().errorCount).toBe(2);
+  });
+
+  it('should track token usage', () => {
+    const analytics = new Analytics();
+    analytics.recordTokens(100, 50);
+    analytics.recordTokens(200, 100);
+    const snap = analytics.getSnapshot();
+    expect(snap.tokenUsage.input).toBe(300);
+    expect(snap.tokenUsage.output).toBe(150);
+    expect(snap.tokenUsage.total).toBe(450);
+  });
+
+  it('should reset analytics', () => {
+    const analytics = new Analytics();
+    analytics.recordMessage(100);
+    analytics.recordError();
+    analytics.reset();
+    const snap = analytics.getSnapshot();
+    expect(snap.messagesProcessed).toBe(0);
+    expect(snap.errorCount).toBe(0);
+  });
+});

package/tests/i18n.test.ts

@@ -0,0 +1,41 @@
+import { describe, it, expect } from 'vitest';
+import { t, setLocale, getLocale, detectLocale, addMessages } from '../src/i18n';
+
+describe('i18n', () => {
+  it('should return English messages by default', () => {
+    setLocale('en');
+    expect(t('agent.greeting')).toBe('Hello! How can I help you?');
+  });
+
+  it('should return Chinese messages', () => {
+    setLocale('zh-CN');
+    expect(t('agent.greeting')).toBe('您好！有什么可以帮您的？');
+    setLocale('en'); // reset
+  });
+
+  it('should interpolate params', () => {
+    setLocale('en');
+    expect(t('agent.started', { name: 'TestBot' })).toBe('Agent "TestBot" started successfully');
+  });
+
+  it('should fall back to key if not found', () => {
+    expect(t('nonexistent.key')).toBe('nonexistent.key');
+  });
+
+  it('should get and set locale', () => {
+    setLocale('zh-CN');
+    expect(getLocale()).toBe('zh-CN');
+    setLocale('en');
+    expect(getLocale()).toBe('en');
+  });
+
+  it('should add custom messages', () => {
+    addMessages('en', { 'custom.key': 'Custom value' });
+    expect(t('custom.key')).toBe('Custom value');
+  });
+
+  it('should detect locale from environment', () => {
+    const locale = detectLocale();
+    expect(['en', 'zh-CN']).toContain(locale);
+  });
+});

package/tests/mcp.test.ts

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { MCPToolRegistry, createMCPTool } from '../src/tools/mcp';
+
+describe('MCP Tool System', () => {
+  it('should register and list tools', () => {
+    const registry = new MCPToolRegistry();
+    const tool = createMCPTool('calculator', 'Basic calculator', {
+      type: 'object',
+      properties: { expression: { type: 'string' } },
+    }, async (input) => ({ content: `Result: ${input.expression}` }));
+
+    registry.register(tool);
+    expect(registry.has('calculator')).toBe(true);
+    expect(registry.list().length).toBe(1);
+    expect(registry.list()[0].name).toBe('calculator');
+  });
+
+  it('should execute a tool', async () => {
+    const registry = new MCPToolRegistry();
+    registry.register(createMCPTool('echo', 'Echo tool', {}, async (input) => ({
+      content: `Echo: ${input.text}`,
+    })));
+
+    const result = await registry.execute('echo', { text: 'hello' });
+    expect(result.content).toBe('Echo: hello');
+    expect(result.isError).toBeUndefined();
+  });
+
+  it('should return error for missing tool', async () => {
+    const registry = new MCPToolRegistry();
+    const result = await registry.execute('nonexistent', {});
+    expect(result.isError).toBe(true);
+    expect(result.content).toContain('not found');
+  });
+
+  it('should handle tool execution errors', async () => {
+    const registry = new MCPToolRegistry();
+    registry.register(createMCPTool('failing', 'Fails', {}, async () => {
+      throw new Error('boom');
+    }));
+
+    const result = await registry.execute('failing', {});
+    expect(result.isError).toBe(true);
+    expect(result.content).toContain('boom');
+  });
+
+  it('should unregister tools', () => {
+    const registry = new MCPToolRegistry();
+    registry.register(createMCPTool('temp', 'Temp', {}, async () => ({ content: '' })));
+    expect(registry.has('temp')).toBe(true);
+    registry.unregister('temp');
+    expect(registry.has('temp')).toBe(false);
+  });
+});

package/tests/plugin.test.ts

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { PluginManager } from '../src/plugins';
+import type { IPlugin } from '../src/plugins';
+
+describe('Plugin System', () => {
+  it('should register and list plugins', () => {
+    const pm = new PluginManager();
+    const plugin: IPlugin = { name: 'test-plugin', version: '1.0.0', description: 'Test' };
+    pm.register(plugin);
+    expect(pm.has('test-plugin')).toBe(true);
+    expect(pm.list().length).toBe(1);
+    expect(pm.list()[0].name).toBe('test-plugin');
+  });
+
+  it('should run lifecycle hooks', async () => {
+    const pm = new PluginManager();
+    const calls: string[] = [];
+
+    pm.register({
+      name: 'hook-plugin',
+      version: '1.0.0',
+      hooks: {
+        beforeInit: async () => { calls.push('beforeInit'); },
+        afterInit: async () => { calls.push('afterInit'); },
+        beforeShutdown: async () => { calls.push('beforeShutdown'); },
+      },
+    });
+
+    await pm.runHook('beforeInit');
+    await pm.runHook('afterInit');
+    await pm.runHook('beforeShutdown');
+    expect(calls).toEqual(['beforeInit', 'afterInit', 'beforeShutdown']);
+  });
+
+  it('should collect skills from plugins', () => {
+    const pm = new PluginManager();
+    pm.register({
+      name: 'skill-plugin',
+      version: '1.0.0',
+      skills: [{
+        name: 'test-skill',
+        description: 'Test',
+        execute: async () => ({ handled: false, confidence: 0 }),
+      }],
+    });
+
+    expect(pm.getAllSkills().length).toBe(1);
+    expect(pm.getAllSkills()[0].name).toBe('test-skill');
+  });
+
+  it('should unregister plugins', () => {
+    const pm = new PluginManager();
+    pm.register({ name: 'temp', version: '1.0.0' });
+    pm.unregister('temp');
+    expect(pm.has('temp')).toBe(false);
+  });
+
+  it('should run hooks from multiple plugins in order', async () => {
+    const pm = new PluginManager();
+    const order: string[] = [];
+
+    pm.register({
+      name: 'p1', version: '1.0.0',
+      hooks: { beforeInit: async () => { order.push('p1'); } },
+    });
+    pm.register({
+      name: 'p2', version: '1.0.0',
+      hooks: { beforeInit: async () => { order.push('p2'); } },
+    });
+
+    await pm.runHook('beforeInit');
+    expect(order).toEqual(['p1', 'p2']);
+  });
+});

package/tests/room.test.ts

@@ -0,0 +1,106 @@
+import { describe, it, expect } from 'vitest';
+import { Room } from '../src/core/room';
+import { BaseAgent } from '../src/core/agent';
+
+function makeAgent(name: string): BaseAgent {
+  const agent = new BaseAgent({ name });
+  // Synchronously set to ready by calling init
+  return agent;
+}
+
+describe('Room System', () => {
+  it('should create a room with a name', () => {
+    const room = new Room('test-room');
+    expect(room.name).toBe('test-room');
+    expect(room.getAgents()).toEqual([]);
+  });
+
+  it('should add and remove agents', () => {
+    const room = new Room('office');
+    const agent = makeAgent('agent-1');
+    room.addAgent(agent);
+    expect(room.getAgents()).toEqual(['agent-1']);
+    room.removeAgent('agent-1');
+    expect(room.getAgents()).toEqual([]);
+  });
+
+  it('should emit events on join/leave', () => {
+    const room = new Room('office');
+    const events: string[] = [];
+    room.on('agent:join', (name) => events.push(`join:${name}`));
+    room.on('agent:leave', (name) => events.push(`leave:${name}`));
+
+    const agent = makeAgent('a1');
+    room.addAgent(agent);
+    room.removeAgent('a1');
+    expect(events).toEqual(['join:a1', 'leave:a1']);
+  });
+
+  it('should support topic subscriptions', () => {
+    const room = new Room('office');
+    room.subscribe('agent-1', 'alerts');
+    room.subscribe('agent-2', 'alerts');
+    expect(room.getSubscribers('alerts')).toEqual(['agent-1', 'agent-2']);
+    room.unsubscribe('agent-1', 'alerts');
+    expect(room.getSubscribers('alerts')).toEqual(['agent-2']);
+  });
+
+  it('should broadcast to all agents except sender', async () => {
+    const room = new Room('office');
+    const a1 = makeAgent('a1');
+    const a2 = makeAgent('a2');
+    await a1.init();
+    await a2.init();
+    room.addAgent(a1);
+    room.addAgent(a2);
+
+    const responses = await room.broadcast('a1', 'Hello everyone');
+    expect(responses.length).toBe(1); // only a2 responds
+    expect(responses[0].role).toBe('assistant');
+  });
+
+  it('should send direct messages', async () => {
+    const room = new Room('office');
+    const a1 = makeAgent('a1');
+    const a2 = makeAgent('a2');
+    await a1.init();
+    await a2.init();
+    room.addAgent(a1);
+    room.addAgent(a2);
+
+    const responses = await room.send({
+      from: 'a1',
+      to: 'a2',
+      message: { id: 'm1', role: 'user', content: 'Hi a2', timestamp: Date.now() },
+    });
+    expect(responses.length).toBe(1);
+  });
+
+  it('should publish to topic subscribers only', async () => {
+    const room = new Room('office');
+    const a1 = makeAgent('a1');
+    const a2 = makeAgent('a2');
+    const a3 = makeAgent('a3');
+    await a1.init();
+    await a2.init();
+    await a3.init();
+    room.addAgent(a1);
+    room.addAgent(a2);
+    room.addAgent(a3);
+
+    room.subscribe('a2', 'alerts');
+    // a3 not subscribed
+    const responses = await room.publishToTopic('a1', 'alerts', 'Alert!');
+    expect(responses.length).toBe(1);
+  });
+
+  it('should remove agent from subscriptions on leave', () => {
+    const room = new Room('office');
+    room.subscribe('a1', 'topic1');
+    room.subscribe('a1', 'topic2');
+    expect(room.getSubscribers('topic1')).toContain('a1');
+    room.removeAgent('a1');
+    expect(room.getSubscribers('topic1')).not.toContain('a1');
+    expect(room.getSubscribers('topic2')).not.toContain('a1');
+  });
+});

package/tests/sandbox.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { Sandbox } from '../src/core/sandbox';
+
+describe('Security Sandbox', () => {
+  it('should create sandbox with trust level', () => {
+    const sb = new Sandbox({ trustLevel: 'sandbox', agentDir: '/tmp/agent' });
+    expect(sb.trustLevel).toBe('sandbox');
+  });
+
+  it('should restrict shell in sandbox mode', () => {
+    const sb = new Sandbox({ trustLevel: 'sandbox', agentDir: '/tmp/agent' });
+    expect(sb.checkShellAccess()).toBe(false);
+  });
+
+  it('should allow shell in certified mode', () => {
+    const sb = new Sandbox({ trustLevel: 'certified', agentDir: '/tmp/agent' });
+    expect(sb.checkShellAccess()).toBe(true);
+  });
+
+  it('should restrict network in sandbox mode', () => {
+    const sb = new Sandbox({ trustLevel: 'sandbox', agentDir: '/tmp/agent' });
+    expect(sb.checkNetworkAccess('https://api.openai.com')).toBe(false);
+  });
+
+  it('should allow network with allowlist', () => {
+    const sb = new Sandbox({
+      trustLevel: 'sandbox',
+      agentDir: '/tmp/agent',
+      networkAllowlist: ['api.openai.com'],
+    });
+    expect(sb.checkNetworkAccess('https://api.openai.com/v1/chat')).toBe(true);
+    expect(sb.checkNetworkAccess('https://evil.com')).toBe(false);
+  });
+
+  it('should allow wildcard network in listed mode', () => {
+    const sb = new Sandbox({ trustLevel: 'listed', agentDir: '/tmp/agent' });
+    expect(sb.checkNetworkAccess('https://anything.com')).toBe(true);
+  });
+
+  it('should return restrictions snapshot', () => {
+    const sb = new Sandbox({ trustLevel: 'verified', agentDir: '/tmp/agent' });
+    const r = sb.getRestrictions();
+    expect(r.shell).toBe(false);
+    expect(r.network.allowed.length).toBeGreaterThan(0);
+  });
+});