opc-agent 1.3.1 → 1.4.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,20 @@
+---
+name: Bug Report
+about: Report a bug
+labels: bug
+---
+
+**Describe the bug**
+A clear description of the bug.
+
+**To Reproduce**
+Steps to reproduce:
+1. ...
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS: 
+- Node.js: 
+- Package version: 

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature Request
+about: Suggest a new feature
+labels: enhancement
+---
+
+**Problem**
+What problem does this solve?
+
+**Proposed Solution**
+How should it work?
+
+**Alternatives Considered**
+Any other approaches?

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## What
+Brief description of changes.
+
+## Why
+Why is this change needed?
+
+## How
+How was this implemented?
+
+## Checklist
+- [ ] Tests pass
+- [ ] Documentation updated (if needed)
+- [ ] No breaking changes (or documented)

package/CHANGELOG.md

@@ -1,57 +1,23 @@
-# Changelog
-
-All notable changes to OPC Agent will be documented in this file.
-
-## [1.2.0] - 2026-04-17
-
-### Added
-- **Tool Gateway**: Managed tool gateway (`ToolGateway`) that wraps multiple tool providers (web-search, image-gen, tts, browser) behind a single authenticated endpoint — no separate API keys needed. Auto-discovers available tools from gateway, falls back to defaults. Gateway tools implement `MCPTool` interface for seamless registry integration. (`src/tools/gateway.ts`)
-- **Streaming Support**: SSE-based streaming for real-time agent responses. `StreamingManager` with `createStream()` / `writeChunk()` / `endStream()`. `StreamableResponse` with backpressure handling, event emission, and SSE pipe utility for Express-style HTTP responses. Channels can opt in via `supportsStreaming: true`. (`src/core/streaming.ts`)
-
-## [1.1.0] - 2026-04-16
-
-### Added
-- **Feishu/Lark Channel**: Full Feishu bot integration with event subscription webhook, tenant access token caching, text & interactive card messaging, group + P2P support. Also works with Lark international via `apiBase` config. (`src/channels/feishu.ts`)
-- **Discord Channel**: Discord bot via Gateway WebSocket with auto-reconnect, heartbeat, message content intent, and 2000-char message splitting. (`src/channels/discord.ts`)
-- **ProcessWatcher**: Background process output monitoring with regex pattern matching — watch stdout/stderr for specific patterns (errors, "server ready", build completion) and get instant callbacks without polling. Supports `once` patterns, match history, and dynamic pattern add/remove. Inspired by Hermes Agent's `watch_patterns`. (`src/core/watch.ts`)
-
-## [0.2.0] - 2026-04-15
-
-### Added
-- **DeepBrain Integration**: Optional long-term memory backend with semantic search. Config via `memory.longTerm.provider: deepbrain`. Falls back to in-memory if not installed.
-- **Telegram Channel**: Basic webhook handler for Telegram Bot API (`src/channels/telegram.ts`).
-- **WebSocket Channel**: Real-time bidirectional communication with broadcast (`src/channels/websocket.ts`).
-- **Sales Assistant Template**: Product Q&A, lead capture, appointment booking.
-- **Knowledge Base Template**: RAG with DeepBrain for answering from company docs.
-- **Code Reviewer Template**: Bug detection, style checking, severity ratings.
-- **Skill Marketplace Stub**: `opc publish` validates OAD and generates manifest. `opc search` placeholder.
-- **OAD Marketplace Fields**: `pricing` (free/freemium/paid/enterprise) and `tags` in marketplace config.
-- **Context Size Guard**: Auto-truncate tool outputs exceeding 5000 characters.
-- **Conversation History Limit**: Configurable limit (default 50 messages).
-- **Graceful Shutdown**: Handles SIGINT/SIGTERM with cleanup.
-- **Structured Logging**: Logger with debug/info/warn/error levels.
-- **Interactive CLI Init**: `opc init` with prompts and template selection.
-- **Dev Mode**: `opc dev` watches files and hot-reloads agent on changes.
-- **Agent Info Command**: `opc info` displays agent details from OAD.
-- **Colorful CLI Output**: Status indicators and colored text throughout CLI.
-- **CONTRIBUTING.md**: Contribution guidelines.
-- **CHANGELOG.md**: This file.
-
-### Changed
-- OAD `memory.longTerm` now accepts boolean or object with provider config.
-- OAD `channels.type` now includes `telegram`.
-- CLI version bumped to 0.2.0.
-
-## [0.1.0] - 2026-04-14
-
-### Added
-- Initial release
-- BaseAgent with lifecycle management
-- AgentRuntime for config-driven setup
-- OAD Schema v1 with Zod validation
-- Web channel (Express)
-- InMemoryStore
-- Skill system (BaseSkill, SkillRegistry)
-- DTV framework (Trust, Value, Data)
-- Customer Service template
-- CLI: init, create, build, test, run, publish
+# Changelog
+
+## 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
+- feat: enhanced /health endpoint with agent name, version, uptime, memory type, skills, channels
+- feat: Slack channel — real Events API webhook server + chat.postMessage via fetch
+- feat: WebChannel metadata setters (version, memory type, skills, channels, analytics provider)
+- feat: AgentRuntime.getAnalytics() and getConfig() accessors
+
+## 1.3.1 (2026-04-17)
+- fix: remove residual DTV/marketplace references
+- fix: duplicate WatchPattern export
+
+## 1.3.0 (2026-04-17)
+- feat: Traces collection (OpenTelemetry-style)
+- feat: DeepBrain exporter
+- feat: brain/logs/score CLI commands
+
+## 1.2.0
+- Initial public release
+- 11 channels, plugins, analytics
+- Declarative OAD configuration

package/CONTRIBUTING.md

@@ -1,75 +1,36 @@
-# Contributing to OPC Agent
-
-Thank you for your interest in contributing to OPC Agent! 🎉
-
-## Getting Started
-
-1. Fork the repository
-2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/opc-agent.git`
-3. Install dependencies: `npm install`
-4. Create a branch: `git checkout -b feature/my-feature`
-
-## Development
-
-```bash
-# Build
-npm run build
-
-# Run tests
-npm test
-
-# Type check
-npm run lint
-
-# Watch mode
-npm run dev
-```
-
-## Project Structure
-
-```
-src/
-├── core/          # Agent, Runtime, Config, Logger, Types
-├── channels/      # Web, WebSocket, Telegram channels
-├── memory/        # InMemoryStore, DeepBrainMemoryStore
-├── providers/     # LLM provider abstraction
-├── schema/        # OAD schema (Zod)
-├── skills/        # BaseSkill, SkillRegistry
-├── templates/     # Agent templates
-├── dtv/           # Data, Trust, Value framework
-├── cli.ts         # CLI entry point
-└── index.ts       # Public API exports
-```
-
-## Guidelines
-
-- **TypeScript**: All code must be TypeScript with strict mode
-- **Tests**: Add tests for new features in `tests/`
-- **Commits**: Use conventional commits (`feat:`, `fix:`, `docs:`, etc.)
-- **OAD Compatibility**: Changes to OAD schema must be backward-compatible
-- **No Breaking Changes** without major version bump
-
-## Adding a Template
-
-1. Create `src/templates/my-template.ts` with config factory function
-2. Create `templates/my-template/oad.yaml` and `README.md`
-3. Register in `src/cli.ts` TEMPLATES map
-4. Add tests
-
-## Adding a Channel
-
-1. Create `src/channels/my-channel.ts` extending `BaseChannel`
-2. Add channel type to OAD schema in `src/schema/oad.ts`
-3. Wire up in `src/core/runtime.ts`
-4. Export from `src/index.ts`
-
-## Pull Requests
-
-1. Ensure all tests pass: `npm test`
-2. Ensure types check: `npm run lint`
-3. Write a clear PR description
-4. Reference any related issues
-
-## License
-
-By contributing, you agree that your contributions will be licensed under Apache-2.0.
+# Contributing
+
+Thanks for your interest in contributing!
+
+## Getting Started
+
+1. Fork the repo
+2. Clone your fork
+3. Install dependencies: `npm install`
+4. Create a branch: `git checkout -b feat/my-feature`
+5. Make your changes
+6. Run tests: `npm test`
+7. Commit: `git commit -m "feat: description"`
+8. Push and open a PR
+
+## Commit Convention
+
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation
+- `test:` Tests
+- `refactor:` Refactoring
+- `chore:` Build/tooling
+
+## Code Style
+
+- TypeScript
+- Run `npm run lint` before committing (if available)
+
+## Questions?
+
+Open a Discussion or Issue.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under Apache-2.0.

package/dist/channels/slack.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SlackChannel = void 0;
 const index_1 = require("./index");
@@ -37,9 +70,51 @@ class SlackChannel extends index_1.BaseChannel {
     }
     /** Start Events API HTTP server */
     async startEventsAPI() {
-        // TODO: Implement with express or http
-        // const port = this.config.port ?? 3001;
-        // Listen for POST /slack/events and /slack/commands
+        const http = await Promise.resolve().then(() => __importStar(require('http')));
+        const port = this.config.port ?? 3001;
+        const server = http.createServer(async (req, res) => {
+            if (req.method !== 'POST') {
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            const chunks = [];
+            for await (const chunk of req)
+                chunks.push(chunk);
+            const body = JSON.parse(Buffer.concat(chunks).toString());
+            // URL verification challenge
+            if (body.type === 'url_verification') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ challenge: body.challenge }));
+                return;
+            }
+            // Event callback
+            if (body.type === 'event_callback' && body.event) {
+                const event = body.event;
+                if (event.type === 'message' || event.type === 'app_mention') {
+                    // Don't block the HTTP response
+                    this.handleMessage(event).catch(() => { });
+                }
+            }
+            // Slash commands (form-urlencoded, but we handle JSON for simplicity)
+            if (req.url === '/slack/commands' && body.command) {
+                const reply = await this.handleSlashCommand({
+                    command: body.command,
+                    text: body.text ?? '',
+                    userId: body.user_id,
+                    channelId: body.channel_id,
+                    triggerId: body.trigger_id,
+                });
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ response_type: 'ephemeral', text: reply }));
+                return;
+            }
+            res.writeHead(200);
+            res.end('ok');
+        });
+        server.listen(port, () => {
+            console.log(`[SlackChannel] Events API listening on port ${port}`);
+        });
     }
     /** Handle incoming Slack message */
     async handleMessage(event) {
@@ -94,13 +169,21 @@ class SlackChannel extends index_1.BaseChannel {
     }
     /** Send a message to a Slack channel */
     async sendMessage(channel, text, threadTs) {
-        // TODO: Implement with @slack/web-api
-        // const { WebClient } = await import('@slack/web-api');
-        // const client = new WebClient(this.config.botToken);
-        // await client.chat.postMessage({ channel, text, thread_ts: threadTs });
-        void channel;
-        void text;
-        void threadTs;
+        const body = { channel, text };
+        if (threadTs)
+            body.thread_ts = threadTs;
+        const res = await fetch('https://slack.com/api/chat.postMessage', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.config.botToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        const data = await res.json();
+        if (!data.ok) {
+            console.error(`[SlackChannel] chat.postMessage failed: ${data.error}`);
+        }
     }
 }
 exports.SlackChannel = SlackChannel;

package/dist/channels/web.d.ts

@@ -9,6 +9,11 @@ export declare class WebChannel extends BaseChannel {
     private port;
     private streamHandler;
     private agentName;
+    private agentVersion;
+    private memoryType;
+    private skillNames;
+    private channelNames;
+    private analyticsProvider;
     private currentProvider;
     private stats;
     private eventHandlers;
@@ -23,6 +28,11 @@ export declare class WebChannel extends BaseChannel {
     trackSession(): void;
     constructor(port?: number, authConfig?: AuthConfig);
     setAgentName(name: string): void;
+    setAgentVersion(version: string): void;
+    setMemoryType(type: string): void;
+    setSkillNames(names: string[]): void;
+    setChannelNames(names: string[]): void;
+    setAnalyticsProvider(fn: () => any): void;
     onStreamMessage(handler: (msg: Message, res: Response) => Promise<void>): void;
     private setupRoutes;
     start(): Promise<void>;

package/dist/channels/web.js

@@ -286,6 +286,11 @@ class WebChannel extends index_1.BaseChannel {
     port;
     streamHandler = null;
     agentName = 'OPC Agent';
+    agentVersion = '1.0.0';
+    memoryType = 'in-memory';
+    skillNames = [];
+    channelNames = ['web'];
+    analyticsProvider = null;
     currentProvider = 'openai';
     stats = { sessions: 0, messages: 0, totalResponseMs: 0, tokenUsage: 0, knowledgeFiles: 0, startedAt: Date.now(), errors: 0 };
     eventHandlers = new Map();
@@ -326,6 +331,21 @@ class WebChannel extends index_1.BaseChannel {
     setAgentName(name) {
         this.agentName = name;
     }
+    setAgentVersion(version) {
+        this.agentVersion = version;
+    }
+    setMemoryType(type) {
+        this.memoryType = type;
+    }
+    setSkillNames(names) {
+        this.skillNames = names;
+    }
+    setChannelNames(names) {
+        this.channelNames = names;
+    }
+    setAnalyticsProvider(fn) {
+        this.analyticsProvider = fn;
+    }
     onStreamMessage(handler) {
         this.streamHandler = handler;
     }
@@ -334,7 +354,17 @@ class WebChannel extends index_1.BaseChannel {
             res.type('html').send(CHAT_HTML);
         });
         this.app.get('/health', (_req, res) => {
-            res.json({ status: 'ok', timestamp: Date.now() });
+            res.json({
+                status: 'ok',
+                agent: this.agentName,
+                version: this.agentVersion,
+                uptime: Date.now() - this.stats.startedAt,
+                memory: this.memoryType,
+                skills: this.skillNames,
+                channels: this.channelNames,
+                analytics: this.analyticsProvider ? this.analyticsProvider() : null,
+                timestamp: Date.now(),
+            });
         });
         this.app.get('/api/info', (_req, res) => {
             res.json({ name: this.agentName });
@@ -408,7 +438,8 @@ class WebChannel extends index_1.BaseChannel {
             res.type('html').send(DASHBOARD_HTML);
         });
         this.app.get('/api/dashboard', (_req, res) => {
-            res.json(this.stats);
+            const analytics = this.analyticsProvider ? this.analyticsProvider() : null;
+            res.json({ ...this.stats, analytics });
         });
         // --- Knowledge Base Upload ---
         this.app.post('/api/kb/upload', async (req, res) => {