opc-agent 4.0.44 → 4.1.1

package/examples/README.md

@@ -1,22 +1,22 @@
-# OPC Agent Examples
-
-## Run Examples
-
-```bash
-# Basic agent with skills
-npx tsx examples/basic-agent.ts
-
-# Multi-channel setup (Web + Telegram)
-npx tsx examples/multi-channel.ts
-
-# DeepBrain memory integration
-npx tsx examples/brain-integration.ts
-```
-
-## What Each Example Shows
-
-| Example | Concepts |
-|---------|----------|
-| `basic-agent.ts` | `BaseAgent`, `AgentRuntime`, `BaseSkill`, message handling |
-| `multi-channel.ts` | `WebChannel`, `TelegramChannel`, multi-channel config |
-| `brain-integration.ts` | `DeepBrainMemoryStore`, `InMemoryStore`, memory backends |
+# OPC Agent Examples
+
+## Run Examples
+
+```bash
+# Basic agent with skills
+npx tsx examples/basic-agent.ts
+
+# Multi-channel setup (Web + Telegram)
+npx tsx examples/multi-channel.ts
+
+# DeepBrain memory integration
+npx tsx examples/brain-integration.ts
+```
+
+## What Each Example Shows
+
+| Example | Concepts |
+|---------|----------|
+| `basic-agent.ts` | `BaseAgent`, `AgentRuntime`, `BaseSkill`, message handling |
+| `multi-channel.ts` | `WebChannel`, `TelegramChannel`, multi-channel config |
+| `brain-integration.ts` | `DeepBrainMemoryStore`, `InMemoryStore`, memory backends |

package/examples/basic-agent.ts

@@ -1,90 +1,90 @@
-/**
- * OPC Agent Example: Basic Agent
- *
- * Create a simple agent with OAD config, register a skill, handle a message.
- *
- * Run: npx tsx examples/basic-agent.ts
- */
-
-import {
-  BaseAgent,
-  AgentRuntime,
-  BaseSkill,
-  InMemoryStore,
-  type Message,
-  type AgentContext,
-  type SkillResult,
-} from 'opc-agent';
-
-// Define a custom skill
-class GreeterSkill extends BaseSkill {
-  name = 'greeter';
-  description = 'Responds to greetings';
-
-  canHandle(message: Message): boolean {
-    const text = message.content.toLowerCase();
-    return text.includes('hello') || text.includes('hi') || text.includes('hey');
-  }
-
-  async execute(message: Message, context: AgentContext): Promise<SkillResult> {
-    return {
-      content: `Hello! I'm ${context.agent?.name || 'Agent'}. How can I help you today?`,
-      confidence: 1.0,
-    };
-  }
-}
-
-async function main() {
-  console.log('🤖 OPC Agent — Basic Agent Demo\n');
-
-  try {
-    // Create agent with OAD-style config
-    const agent = new BaseAgent({
-      name: 'demo-agent',
-      description: 'A simple demo agent',
-      version: '1.0.0',
-    });
-
-    // Set up memory store
-    const memory = new InMemoryStore();
-
-    // Create runtime
-    const runtime = new AgentRuntime(agent, {
-      memory,
-    });
-
-    // Register skill
-    const greeter = new GreeterSkill();
-    runtime.registerSkill(greeter);
-
-    console.log(`✅ Agent "${agent.name}" created with ${1} skill\n`);
-
-    // Simulate messages
-    const testMessages: Message[] = [
-      { role: 'user', content: 'Hello there!' },
-      { role: 'user', content: 'What can you do?' },
-      { role: 'user', content: 'Hey, nice to meet you' },
-    ];
-
-    for (const msg of testMessages) {
-      console.log(`📨 User: ${msg.content}`);
-      const response = await runtime.handleMessage(msg);
-      console.log(`🤖 Agent: ${response?.content || '(no response)'}\n`);
-    }
-
-    console.log('✅ Done! OPC Agent supports:');
-    console.log('  • OAD config (YAML/JSON agent definition)');
-    console.log('  • Skill registration & routing');
-    console.log('  • Multi-channel (Web, Telegram, Slack, etc.)');
-    console.log('  • Memory stores (InMemory, DeepBrain)\n');
-    console.log('Next: npx tsx examples/multi-channel.ts');
-  } catch (e: any) {
-    console.error(`❌ Error: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-main().catch(e => {
-  console.error(`\n❌ Error: ${e.message}\n`);
-  process.exit(1);
-});
+/**
+ * OPC Agent Example: Basic Agent
+ *
+ * Create a simple agent with OAD config, register a skill, handle a message.
+ *
+ * Run: npx tsx examples/basic-agent.ts
+ */
+
+import {
+  BaseAgent,
+  AgentRuntime,
+  BaseSkill,
+  InMemoryStore,
+  type Message,
+  type AgentContext,
+  type SkillResult,
+} from 'opc-agent';
+
+// Define a custom skill
+class GreeterSkill extends BaseSkill {
+  name = 'greeter';
+  description = 'Responds to greetings';
+
+  canHandle(message: Message): boolean {
+    const text = message.content.toLowerCase();
+    return text.includes('hello') || text.includes('hi') || text.includes('hey');
+  }
+
+  async execute(message: Message, context: AgentContext): Promise<SkillResult> {
+    return {
+      content: `Hello! I'm ${context.agent?.name || 'Agent'}. How can I help you today?`,
+      confidence: 1.0,
+    };
+  }
+}
+
+async function main() {
+  console.log('🤖 OPC Agent — Basic Agent Demo\n');
+
+  try {
+    // Create agent with OAD-style config
+    const agent = new BaseAgent({
+      name: 'demo-agent',
+      description: 'A simple demo agent',
+      version: '1.0.0',
+    });
+
+    // Set up memory store
+    const memory = new InMemoryStore();
+
+    // Create runtime
+    const runtime = new AgentRuntime(agent, {
+      memory,
+    });
+
+    // Register skill
+    const greeter = new GreeterSkill();
+    runtime.registerSkill(greeter);
+
+    console.log(`✅ Agent "${agent.name}" created with ${1} skill\n`);
+
+    // Simulate messages
+    const testMessages: Message[] = [
+      { role: 'user', content: 'Hello there!' },
+      { role: 'user', content: 'What can you do?' },
+      { role: 'user', content: 'Hey, nice to meet you' },
+    ];
+
+    for (const msg of testMessages) {
+      console.log(`📨 User: ${msg.content}`);
+      const response = await runtime.handleMessage(msg);
+      console.log(`🤖 Agent: ${response?.content || '(no response)'}\n`);
+    }
+
+    console.log('✅ Done! OPC Agent supports:');
+    console.log('  • OAD config (YAML/JSON agent definition)');
+    console.log('  • Skill registration & routing');
+    console.log('  • Multi-channel (Web, Telegram, Slack, etc.)');
+    console.log('  • Memory stores (InMemory, DeepBrain)\n');
+    console.log('Next: npx tsx examples/multi-channel.ts');
+  } catch (e: any) {
+    console.error(`❌ Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main().catch(e => {
+  console.error(`\n❌ Error: ${e.message}\n`);
+  process.exit(1);
+});

package/examples/brain-integration.ts

@@ -1,71 +1,71 @@
-/**
- * OPC Agent Example: DeepBrain Memory Integration
- *
- * Shows how to use DeepBrainMemoryStore for persistent agent memory.
- * Requires a running DeepBrain instance (or falls back to InMemory).
- *
- * Run: npx tsx examples/brain-integration.ts
- */
-
-import {
-  BaseAgent,
-  AgentRuntime,
-  InMemoryStore,
-  DeepBrainMemoryStore,
-} from 'opc-agent';
-
-async function main() {
-  console.log('🧠 OPC Agent — DeepBrain Memory Integration\n');
-
-  try {
-    const agent = new BaseAgent({
-      name: 'brain-agent',
-      description: 'Agent with DeepBrain-powered memory',
-      version: '1.0.0',
-    });
-
-    // Try DeepBrain first, fall back to InMemory
-    let memory;
-    let memoryType: string;
-
-    try {
-      memory = new DeepBrainMemoryStore({
-        brainUrl: process.env.DEEPBRAIN_URL || 'http://localhost:3333',
-        agentId: 'brain-agent',
-      });
-      memoryType = 'DeepBrain';
-      console.log('✅ Using DeepBrain memory store');
-    } catch {
-      memory = new InMemoryStore();
-      memoryType = 'InMemory';
-      console.log('⚠️  DeepBrain unavailable, using InMemory fallback');
-    }
-
-    const runtime = new AgentRuntime(agent, { memory });
-
-    console.log(`\n📦 Memory store: ${memoryType}`);
-    console.log('\nDeepBrain vs InMemory:');
-    console.log('  ┌─────────────────┬────────────┬──────────────┐');
-    console.log('  │ Feature         │ InMemory   │ DeepBrain    │');
-    console.log('  ├─────────────────┼────────────┼──────────────┤');
-    console.log('  │ Persistence     │ ❌ (RAM)   │ ✅ (SQLite)  │');
-    console.log('  │ Semantic search │ ❌         │ ✅           │');
-    console.log('  │ Evolve          │ ❌         │ ✅           │');
-    console.log('  │ Multi-agent     │ ❌         │ ✅           │');
-    console.log('  │ Zero config     │ ✅         │ ✅           │');
-    console.log('  └─────────────────┴────────────┴──────────────┘\n');
-
-    console.log('✅ Done! To use DeepBrain:');
-    console.log('  npm install deepbrain');
-    console.log('  deepbrain serve  # starts on :3333');
-    console.log('  DEEPBRAIN_URL=http://localhost:3333 npx tsx examples/brain-integration.ts\n');
-  } catch (e: any) {
-    console.error(`❌ Error: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-main().catch(e => {
-  console.error(`\n❌ Error: ${e.message}\n`);
-  process.exit(1);
-});
+/**
+ * OPC Agent Example: DeepBrain Memory Integration
+ *
+ * Shows how to use DeepBrainMemoryStore for persistent agent memory.
+ * Requires a running DeepBrain instance (or falls back to InMemory).
+ *
+ * Run: npx tsx examples/brain-integration.ts
+ */
+
+import {
+  BaseAgent,
+  AgentRuntime,
+  InMemoryStore,
+  DeepBrainMemoryStore,
+} from 'opc-agent';
+
+async function main() {
+  console.log('🧠 OPC Agent — DeepBrain Memory Integration\n');
+
+  try {
+    const agent = new BaseAgent({
+      name: 'brain-agent',
+      description: 'Agent with DeepBrain-powered memory',
+      version: '1.0.0',
+    });
+
+    // Try DeepBrain first, fall back to InMemory
+    let memory;
+    let memoryType: string;
+
+    try {
+      memory = new DeepBrainMemoryStore({
+        brainUrl: process.env.DEEPBRAIN_URL || 'http://localhost:3333',
+        agentId: 'brain-agent',
+      });
+      memoryType = 'DeepBrain';
+      console.log('✅ Using DeepBrain memory store');
+    } catch {
+      memory = new InMemoryStore();
+      memoryType = 'InMemory';
+      console.log('⚠️  DeepBrain unavailable, using InMemory fallback');
+    }
+
+    const runtime = new AgentRuntime(agent, { memory });
+
+    console.log(`\n📦 Memory store: ${memoryType}`);
+    console.log('\nDeepBrain vs InMemory:');
+    console.log('  ┌─────────────────┬────────────┬──────────────┐');
+    console.log('  │ Feature         │ InMemory   │ DeepBrain    │');
+    console.log('  ├─────────────────┼────────────┼──────────────┤');
+    console.log('  │ Persistence     │ ❌ (RAM)   │ ✅ (SQLite)  │');
+    console.log('  │ Semantic search │ ❌         │ ✅           │');
+    console.log('  │ Evolve          │ ❌         │ ✅           │');
+    console.log('  │ Multi-agent     │ ❌         │ ✅           │');
+    console.log('  │ Zero config     │ ✅         │ ✅           │');
+    console.log('  └─────────────────┴────────────┴──────────────┘\n');
+
+    console.log('✅ Done! To use DeepBrain:');
+    console.log('  npm install deepbrain');
+    console.log('  deepbrain serve  # starts on :3333');
+    console.log('  DEEPBRAIN_URL=http://localhost:3333 npx tsx examples/brain-integration.ts\n');
+  } catch (e: any) {
+    console.error(`❌ Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main().catch(e => {
+  console.error(`\n❌ Error: ${e.message}\n`);
+  process.exit(1);
+});

package/examples/multi-channel.ts

@@ -1,74 +1,74 @@
-/**
- * OPC Agent Example: Multi-Channel Setup
- *
- * Shows how to configure Web + Telegram channels for an agent.
- * Note: This is a configuration demo — actual channel connections
- * require valid tokens/endpoints.
- *
- * Run: npx tsx examples/multi-channel.ts
- */
-
-import {
-  BaseAgent,
-  AgentRuntime,
-  WebChannel,
-  TelegramChannel,
-  InMemoryStore,
-} from 'opc-agent';
-
-async function main() {
-  console.log('🌐 OPC Agent — Multi-Channel Demo\n');
-
-  try {
-    const agent = new BaseAgent({
-      name: 'multi-channel-agent',
-      description: 'Agent that works across multiple channels',
-      version: '1.0.0',
-    });
-
-    const memory = new InMemoryStore();
-    const runtime = new AgentRuntime(agent, { memory });
-
-    // Channel 1: Web (HTTP endpoint)
-    const webChannel = new WebChannel({
-      port: 3000,
-      path: '/chat',
-    });
-    console.log('📡 Web channel configured: http://localhost:3000/chat');
-
-    // Channel 2: Telegram (requires BOT_TOKEN)
-    const telegramToken = process.env.TELEGRAM_BOT_TOKEN;
-    if (telegramToken) {
-      const telegramChannel = new TelegramChannel({
-        token: telegramToken,
-      });
-      runtime.addChannel(telegramChannel);
-      console.log('📱 Telegram channel configured');
-    } else {
-      console.log('📱 Telegram: skipped (set TELEGRAM_BOT_TOKEN to enable)');
-    }
-
-    // Register web channel
-    runtime.addChannel(webChannel);
-
-    console.log('\n✅ Agent configured with channels:');
-    console.log('  • Web:      HTTP REST endpoint');
-    console.log('  • Telegram: Bot API (optional)');
-    console.log('\nAvailable channels in OPC Agent:');
-    console.log('  WebChannel, TelegramChannel, WebSocketChannel,');
-    console.log('  SlackChannel, DiscordChannel, FeishuChannel,');
-    console.log('  EmailChannel, WeChatChannel, VoiceChannel,');
-    console.log('  WebhookChannel\n');
-
-    // In production you would call: await runtime.start();
-    console.log('💡 To start: await runtime.start()');
-  } catch (e: any) {
-    console.error(`❌ Error: ${e.message}`);
-    process.exit(1);
-  }
-}
-
-main().catch(e => {
-  console.error(`\n❌ Error: ${e.message}\n`);
-  process.exit(1);
-});
+/**
+ * OPC Agent Example: Multi-Channel Setup
+ *
+ * Shows how to configure Web + Telegram channels for an agent.
+ * Note: This is a configuration demo — actual channel connections
+ * require valid tokens/endpoints.
+ *
+ * Run: npx tsx examples/multi-channel.ts
+ */
+
+import {
+  BaseAgent,
+  AgentRuntime,
+  WebChannel,
+  TelegramChannel,
+  InMemoryStore,
+} from 'opc-agent';
+
+async function main() {
+  console.log('🌐 OPC Agent — Multi-Channel Demo\n');
+
+  try {
+    const agent = new BaseAgent({
+      name: 'multi-channel-agent',
+      description: 'Agent that works across multiple channels',
+      version: '1.0.0',
+    });
+
+    const memory = new InMemoryStore();
+    const runtime = new AgentRuntime(agent, { memory });
+
+    // Channel 1: Web (HTTP endpoint)
+    const webChannel = new WebChannel({
+      port: 3000,
+      path: '/chat',
+    });
+    console.log('📡 Web channel configured: http://localhost:3000/chat');
+
+    // Channel 2: Telegram (requires BOT_TOKEN)
+    const telegramToken = process.env.TELEGRAM_BOT_TOKEN;
+    if (telegramToken) {
+      const telegramChannel = new TelegramChannel({
+        token: telegramToken,
+      });
+      runtime.addChannel(telegramChannel);
+      console.log('📱 Telegram channel configured');
+    } else {
+      console.log('📱 Telegram: skipped (set TELEGRAM_BOT_TOKEN to enable)');
+    }
+
+    // Register web channel
+    runtime.addChannel(webChannel);
+
+    console.log('\n✅ Agent configured with channels:');
+    console.log('  • Web:      HTTP REST endpoint');
+    console.log('  • Telegram: Bot API (optional)');
+    console.log('\nAvailable channels in OPC Agent:');
+    console.log('  WebChannel, TelegramChannel, WebSocketChannel,');
+    console.log('  SlackChannel, DiscordChannel, FeishuChannel,');
+    console.log('  EmailChannel, WeChatChannel, VoiceChannel,');
+    console.log('  WebhookChannel\n');
+
+    // In production you would call: await runtime.start();
+    console.log('💡 To start: await runtime.start()');
+  } catch (e: any) {
+    console.error(`❌ Error: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main().catch(e => {
+  console.error(`\n❌ Error: ${e.message}\n`);
+  process.exit(1);
+});