opc-agent 1.3.2 → 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/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm run build --if-present
+      - run: npx vitest run --reporter=verbose
+        env:
+          CI: true

package/CHANGELOG.md

@@ -1,63 +1,23 @@
-# Changelog
-
-All notable changes to OPC Agent will be documented in this file.
-
-## [1.3.0] - 2026-04-18
-
-### Added
-- **Local Web Dashboard**: Lightweight Express-based web dashboard (`Dashboard`) for monitoring agent state locally. Provides REST API endpoints (`/api/health`, `/api/state`, `/api/sessions`, `/api/tools`, `/api/channels`) and a built-in HTML UI with real-time polling. Track sessions, tool invocations, and channel stats. Binds to `127.0.0.1:4100` by default for security. (`src/core/dashboard.ts`)
-- **Priority/Fast Mode**: Provider-aware priority routing (`PriorityRouter`) for OpenAI, Anthropic, and Google. Toggle between `standard`, `fast`, and `batch` tiers at runtime. Automatically injects provider-specific priority headers (e.g., `X-OpenAI-Processing-Priority`) for eligible models. Supports per-provider endpoint overrides and model pattern matching. (`src/core/priority.ts`)
-
-## [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,74 +1,35 @@
-# Contributing to OPC Agent
+# Contributing
 
-Thank you for your interest in contributing to OPC Agent! 🎉
+Thanks for your interest in contributing!
 
 ## Getting Started
 
-1. Fork the repository
-2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/opc-agent.git`
+1. Fork the repo
+2. Clone your fork
 3. Install dependencies: `npm install`
-4. Create a branch: `git checkout -b feature/my-feature`
+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
 
-## Development
+## Commit Convention
 
-```bash
-# Build
-npm run build
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation
+- `test:` Tests
+- `refactor:` Refactoring
+- `chore:` Build/tooling
 
-# Run tests
-npm test
+## Code Style
 
-# Type check
-npm run lint
+- TypeScript
+- Run `npm run lint` before committing (if available)
 
-# Watch mode
-npm run dev
-```
+## Questions?
 
-## 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
+Open a Discussion or Issue.
 
 ## License