opc-agent 1.4.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [2.0.0] - 2026-04-18
+
+### Major Features
+- **Interactive CLI** (`opc chat`) — Full TUI with streaming, slash commands, history
+- **Daemon Mode** (`opc start/stop/status`) — Run agents as background processes
+- **Cron Scheduler** — Built-in job scheduling with cron expressions
+- **Autonomous Skill Learning** — Agents create and improve skills from experience
+- **Sub-Agent System** — Spawn parallel sub-agents for task delegation
+- **Built-in Tools** — File operations, web fetch, shell exec, datetime
+- **MCP Client** — Connect to external MCP servers via JSON-RPC
+- **Telegram Channel** — Dual-mode (polling + webhook) with Markdown support
+- **Discord Channel** — Gateway WebSocket with auto-reconnect
+- **Slack Channel** — Real Events API + chat.postMessage
+- **SOUL.md + CONTEXT.md** — Agent personality and project context files
+- **Analytics** — Wired into runtime for message tracking, skill usage, errors
+
+### Enhanced
+- `/health` endpoint returns comprehensive agent info
+- `opc init` generates SOUL.md, CONTEXT.md, and richer project templates
+- OAD config supports scheduler, learning, and tools sections
+- 204 tests passing
+
+### CLI Commands
+init, chat, run, dev, start, stop, status, jobs, skills, info, build, test, analytics, brain, logs, score, search, deploy, publish, install, plugin, tool, workflow, migrate
+
 ## 1.4.0 (2026-04-18)
 - feat: wire Analytics into AgentRuntime (message timing, skill usage, error tracking)
 - feat: expose analytics snapshot on /health and /api/dashboard endpoints

package/README.md

@@ -6,8 +6,9 @@
 
 [![npm](https://img.shields.io/npm/v/opc-agent)](https://www.npmjs.com/package/opc-agent)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/Tests-163_passing-green)]()
+[![Tests](https://img.shields.io/badge/Tests-204_passing-green)]()
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![Version](https://img.shields.io/badge/version-2.0.0-brightgreen)]()
 
 [快速开始](#快速开始) · [CLI 命令](#cli-命令) · [渠道](#11-个渠道) · [English](#english)
 
@@ -20,38 +21,76 @@
 > **不只是 Harness，是比 Harness 高一维的 Agent OS。**
 > 从创建到运行到监控，一个工具搞定 Agent 全生命周期。
 
-## 🎯 和 Harness 框架的区别
-
-| | LangChain | CrewAI | AutoGen | **OPC Agent** |
-|---|---|---|---|---|
-| 创建 | 写代码 | 写代码 | 写代码 | **`opc init` 一键** |
-| 配置 | Python/代码 | Python | Python | **YAML 声明式** |
-| 测试 | 自己搭 | 无 | 无 | **内置测试框架** |
-| 渠道 | 自己接 | 无 | 无 | **11 渠道开箱即用** |
-| 监控 | 自己搭 | 无 | 无 | **Traces + Score** |
-| 记忆 | 自己管 | 简单 | 简单 | **DeepBrain 集成** |
+## 🎯 和竞品的区别
+
+| | LangChain | CrewAI | AutoGen | Hermes Agent | **OPC Agent** |
+|---|---|---|---|---|---|
+| 创建 | 写代码 | 写代码 | 写代码 | CLI | **`opc init` 一键** |
+| 配置 | Python/代码 | Python | Python | YAML | **YAML 声明式** |
+| 测试 | 自己搭 | 无 | 无 | 基础 | **内置测试框架** |
+| 渠道 | 自己接 | 无 | 无 | 有限 | **11 渠道开箱即用** |
+| 监控 | 自己搭 | 无 | 无 | 基础 | **Traces + Score** |
+| 记忆 | 自己管 | 简单 | 简单 | 无 | **DeepBrain 集成** |
+| 守护进程 | 无 | 无 | 无 | 无 | **`opc start/stop/status`** |
+| 定时任务 | 无 | 无 | 无 | 无 | **内置 Cron 调度** |
+| 技能学习 | 无 | 无 | 无 | 无 | **自主技能习得** |
+| 子 Agent | 无 | 有 | 有 | 无 | **并行子 Agent 系统** |
+| MCP | 无 | 无 | 无 | 无 | **MCP Client 集成** |
 
 **框架管"怎么跑"，Agent OS 管"全过程"。**
 
 ## 快速开始
 
 ```bash
-npm install -g opc-agent
+# 最快方式（无需全局安装）
+npx opc-agent init my-agent
+cd my-agent
+npm install
+opc chat
 
-# 创建
+# 或全局安装
+npm install -g opc-agent
 opc init my-agent
 cd my-agent
-
-# 开发
 opc dev
+```
+
+## 🆕 v2.0.0 新特性
 
-# 测试
-opc test
+### 🖥️ 交互式 CLI (`opc chat`)
+全功能 TUI：流式输出、斜杠命令、历史记录，直接在终端和 Agent 对话。
 
-# 运行
-opc run
+### 🔄 守护进程模式
+```bash
+opc start          # 后台启动 Agent
+opc status         # 查看运行状态
+opc stop           # 停止 Agent
+```
+
+### ⏰ Cron 调度器
+OAD 配置中声明定时任务，Agent 自动按计划执行：
+```yaml
+scheduler:
+  jobs:
+    - cron: "0 9 * * *"
+      task: daily-report
 ```
 
+### 🧠 自主技能学习
+Agent 从经验中自动创建和改进技能，越用越强。
+
+### 🤖 子 Agent 系统
+并行派生子 Agent 处理复杂任务，支持任务委派和结果汇总。
+
+### 🔧 内置工具
+文件操作、Web 抓取、Shell 执行、日期时间 — 开箱即用，无需额外配置。
+
+### 🔌 MCP Client
+通过 JSON-RPC 连接外部 MCP 服务器，扩展 Agent 能力边界。
+
+### 📄 SOUL.md + CONTEXT.md
+用 Markdown 定义 Agent 人格和项目上下文，人性化配置。
+
 ## OAD 声明式配置
 
 不用写代码，用 YAML 定义 Agent：
@@ -87,12 +126,29 @@ memory:
 
 ```bash
 opc init <name>           # 创建新 Agent
+opc chat                  # 交互式对话（TUI）
 opc dev                   # 开发模式（热重载）
-opc test                  # 运行测试
 opc run                   # 生产运行
-opc logs [-f]             # 查看 Traces 日志
+opc start                 # 守护进程启动
+opc stop                  # 停止守护进程
+opc status                # 查看运行状态
+opc jobs                  # 查看定时任务
+opc skills                # 查看已学技能
+opc info                  # Agent 信息
+opc build                 # 构建
+opc test                  # 运行测试
+opc analytics             # 数据分析
 opc brain [--url ...]     # 查看记忆状态
+opc logs [-f]             # 查看 Traces 日志
 opc score                 # 查看性能评分
+opc search <query>        # 搜索
+opc deploy                # 部署
+opc publish               # 发布
+opc install <skill>       # 安装技能
+opc plugin <name>         # 管理插件
+opc tool <name>           # 管理工具
+opc workflow <name>       # 工作流
+opc migrate               # 迁移
 ```
 
 ## 11 个渠道
@@ -184,20 +240,17 @@ Apache-2.0
 ## Quick Start
 
 ```bash
-npm install -g opc-agent
+# Fastest way (no global install)
+npx opc-agent init my-agent
+cd my-agent
+npm install
+opc chat
 
-# Create
+# Or install globally
+npm install -g opc-agent
 opc init my-agent
 cd my-agent
-
-# Develop
 opc dev
-
-# Test
-opc test
-
-# Run
-opc run
 ```
 
 ## OAD Declarative Configuration
@@ -267,7 +320,7 @@ One codebase, deploy to any channel:
 |----------|----------|
 | 📋 **Configuration** | OAD declarative definition, YAML config |
 | 📡 **Channels** | 11 channels, unified access |
-| 🧪 **Testing** | Built-in test framework, 163 tests |
+| 🧪 **Testing** | Built-in test framework, 204 tests |
 | 🔌 **Plugins** | Extensible skills and tools system |
 | 📊 **Monitoring** | Traces behavior collection, Score rating |
 | 🧠 **Memory** | DeepBrain integration, auto-learning |
@@ -304,3 +357,9 @@ One codebase, deploy to any channel:
 ## License
 
 Apache-2.0
+thub.com/Deepleaper/agentkits) | OpenRouter with Memory | Model call layer |
+| [agent-workstation](https://github.com/Deepleaper/agent-workstation) | Virtual Role Templates | `opc init --template` |
+
+## License
+
+Apache-2.0

package/dist/channels/telegram.d.ts

@@ -1,21 +1,42 @@
 import { BaseChannel } from './index';
 /**
- * Telegram channel — basic webhook handler for Telegram Bot API.
- * Set TELEGRAM_BOT_TOKEN env var or pass in config.
+ * Telegram channel — supports both long-polling and webhook modes.
+ *
+ * Config:
+ *   token: bot token (or TELEGRAM_BOT_TOKEN env var)
+ *   mode: 'polling' | 'webhook' (default: 'polling')
+ *   webhookUrl: required for webhook mode
+ *   port: webhook server port (default: 3001)
+ *
+ * Polling mode requires no public URL — ideal for dev/local.
+ * Webhook mode is more efficient for production.
  */
+export interface TelegramChannelConfig {
+    token?: string;
+    mode?: 'polling' | 'webhook';
+    webhookUrl?: string;
+    port?: number;
+}
 export declare class TelegramChannel extends BaseChannel {
     readonly type = "telegram";
     private token;
+    private mode;
     private webhookUrl?;
-    private server;
     private port;
-    constructor(options?: {
-        token?: string;
-        webhookUrl?: string;
-        port?: number;
-    });
+    private offset;
+    private polling;
+    private server;
+    constructor(config?: TelegramChannelConfig);
     start(): Promise<void>;
     stop(): Promise<void>;
-    private sendMessage;
+    private startPolling;
+    private poll;
+    private getUpdates;
+    private startWebhook;
+    private stopWebhook;
+    private processUpdate;
+    sendMessage(chatId: number | string, text: string): Promise<void>;
+    private apiCall;
+    private splitText;
 }
 //# sourceMappingURL=telegram.d.ts.map

package/dist/channels/telegram.js

@@ -35,58 +35,105 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TelegramChannel = void 0;
 const index_1 = require("./index");
-/**
- * Telegram channel — basic webhook handler for Telegram Bot API.
- * Set TELEGRAM_BOT_TOKEN env var or pass in config.
- */
 class TelegramChannel extends index_1.BaseChannel {
     type = 'telegram';
     token;
+    mode;
     webhookUrl;
-    server = null;
     port;
-    constructor(options = {}) {
+    // Polling state
+    offset = 0;
+    polling = false;
+    // Webhook state
+    server = null;
+    constructor(config = {}) {
         super();
-        this.token = options.token ?? process.env.TELEGRAM_BOT_TOKEN ?? '';
-        this.webhookUrl = options.webhookUrl;
-        this.port = options.port ?? 3001;
+        this.token = config.token ?? process.env.TELEGRAM_BOT_TOKEN ?? '';
+        this.mode = config.mode ?? 'polling';
+        this.webhookUrl = config.webhookUrl;
+        this.port = config.port ?? 3001;
     }
     async start() {
         if (!this.token) {
             console.warn('[TelegramChannel] No bot token provided. Set TELEGRAM_BOT_TOKEN or pass token in config.');
             return;
         }
+        if (this.mode === 'webhook') {
+            await this.startWebhook();
+        }
+        else {
+            await this.startPolling();
+        }
+    }
+    async stop() {
+        if (this.mode === 'webhook') {
+            await this.stopWebhook();
+        }
+        else {
+            this.polling = false;
+        }
+    }
+    // ─── Polling Mode ────────────────────────────────────────
+    async startPolling() {
+        // Delete any existing webhook so polling works
+        await this.apiCall('deleteWebhook');
+        console.log(`[TelegramChannel] Started long-polling mode`);
+        this.polling = true;
+        this.poll();
+    }
+    async poll() {
+        while (this.polling) {
+            try {
+                const updates = await this.getUpdates();
+                for (const update of updates) {
+                    await this.processUpdate(update);
+                }
+            }
+            catch (err) {
+                console.error('[TelegramChannel] Polling error:', err);
+                // Back off on error
+                if (this.polling) {
+                    await new Promise((r) => setTimeout(r, 5000));
+                }
+            }
+        }
+    }
+    async getUpdates() {
+        const url = `https://api.telegram.org/bot${this.token}/getUpdates?offset=${this.offset}&timeout=30&allowed_updates=["message"]`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 40000); // 30s long-poll + 10s buffer
+        try {
+            const res = await fetch(url, { signal: controller.signal });
+            const data = (await res.json());
+            if (data.ok && data.result.length > 0) {
+                this.offset = data.result[data.result.length - 1].update_id + 1;
+            }
+            return data.result || [];
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    // ─── Webhook Mode ────────────────────────────────────────
+    async startWebhook() {
+        if (this.webhookUrl) {
+            await this.apiCall('setWebhook', { url: `${this.webhookUrl}/webhook/${this.token}` });
+        }
         const express = (await Promise.resolve().then(() => __importStar(require('express')))).default;
         const app = express();
         app.use(express.json());
         app.post(`/webhook/${this.token}`, async (req, res) => {
             try {
-                const update = req.body;
-                if (update.message?.text && this.handler) {
-                    const msg = {
-                        id: `tg_${update.message.message_id}`,
-                        role: 'user',
-                        content: update.message.text,
-                        timestamp: update.message.date * 1000,
-                        metadata: {
-                            sessionId: `tg_${update.message.chat.id}`,
-                            chatId: update.message.chat.id,
-                            userId: update.message.from?.id,
-                            platform: 'telegram',
-                        },
-                    };
-                    const response = await this.handler(msg);
-                    await this.sendMessage(update.message.chat.id, response.content);
-                }
+                await this.processUpdate(req.body);
                 res.json({ ok: true });
             }
             catch (err) {
-                console.error('[TelegramChannel] Error handling update:', err);
+                console.error('[TelegramChannel] Webhook error:', err);
                 res.status(500).json({ error: 'Internal error' });
             }
         });
         app.get('/health', (_req, res) => {
-            res.json({ status: 'ok', channel: 'telegram' });
+            res.json({ status: 'ok', channel: 'telegram', mode: 'webhook' });
         });
         return new Promise((resolve) => {
             this.server = app.listen(this.port, () => {
@@ -95,25 +142,70 @@ class TelegramChannel extends index_1.BaseChannel {
             });
         });
     }
-    async stop() {
+    async stopWebhook() {
         return new Promise((resolve, reject) => {
             if (!this.server)
                 return resolve();
             this.server.close((err) => (err ? reject(err) : resolve()));
         });
     }
+    // ─── Shared ──────────────────────────────────────────────
+    async processUpdate(update) {
+        const message = update.message || update.edited_message;
+        if (!message?.text || !this.handler)
+            return;
+        const msg = {
+            id: `tg_${message.message_id}`,
+            role: 'user',
+            content: message.text,
+            timestamp: message.date * 1000,
+            metadata: {
+                sessionId: `tg_${message.chat.id}`,
+                chatId: message.chat.id,
+                userId: message.from?.id,
+                username: message.from?.username,
+                firstName: message.from?.first_name,
+                platform: 'telegram',
+                chatType: message.chat.type,
+            },
+        };
+        const response = await this.handler(msg);
+        await this.sendMessage(message.chat.id, response.content);
+    }
     async sendMessage(chatId, text) {
-        const url = `https://api.telegram.org/bot${this.token}/sendMessage`;
+        // Telegram max message length is 4096
+        const chunks = this.splitText(text, 4096);
+        for (const chunk of chunks) {
+            await this.apiCall('sendMessage', {
+                chat_id: chatId,
+                text: chunk,
+                parse_mode: 'Markdown',
+            });
+        }
+    }
+    async apiCall(method, body) {
+        const url = `https://api.telegram.org/bot${this.token}/${method}`;
         try {
-            await fetch(url, {
+            const res = await fetch(url, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ chat_id: chatId, text, parse_mode: 'Markdown' }),
+                body: body ? JSON.stringify(body) : undefined,
             });
+            return await res.json();
         }
         catch (err) {
-            console.error('[TelegramChannel] Failed to send message:', err);
+            console.error(`[TelegramChannel] API call ${method} failed:`, err);
+            throw err;
+        }
+    }
+    splitText(text, maxLen) {
+        if (text.length <= maxLen)
+            return [text];
+        const parts = [];
+        for (let i = 0; i < text.length; i += maxLen) {
+            parts.push(text.slice(i, i + maxLen));
         }
+        return parts;
     }
 }
 exports.TelegramChannel = TelegramChannel;