opc-agent 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -1,51 +1,51 @@
-# Changelog
-
-All notable changes to OPC Agent will be documented in this file.
-
-## [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
+
+All notable changes to OPC Agent will be documented in this file.
+
+## [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

package/CONTRIBUTING.md

@@ -1,75 +1,75 @@
-# 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 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.