opc-agent 0.1.0 → 0.3.0

package/CHANGELOG.md

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

@@ -0,0 +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.

package/README.md

@@ -1,62 +1,64 @@
 # OPC Agent
 
-**Open Agent Framework — Build, test, and run AI Agents for business workstations.**
+**Open Agent Framework** — Build, test, and run AI Agents for business workstations.
 
-[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue.svg)](https://www.typescriptlang.org/)
+[![npm version](https://img.shields.io/npm/v/opc-agent.svg)](https://www.npmjs.com/package/opc-agent)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-OPC Agent is an open-source framework for building production-ready AI agents. It provides a declarative agent definition format (OAD), pluggable skills, multi-channel support, and a progressive trust model for safe deployment.
+## Features
 
-## Architecture
-
-```
-┌─────────────────────────────────────────────────┐
-│                   OPC Agent                      │
-├─────────────┬──────────┬────────────────────────┤
-│   Channels  │  Skills  │       Memory           │
-│  ┌────────┐ │ ┌──────┐ │  ┌──────────────────┐  │
-│  │  Web   │ │ │ FAQ  │ │  │  Short-term       │  │
-│  │  WS    │ │ │Custom│ │  │  Long-term        │  │
-│  │  CLI   │ │ │ ...  │ │  └──────────────────┘  │
-│  └────────┘ │ └──────┘ │                        │
-├─────────────┴──────────┴────────────────────────┤
-│              Agent Runtime                       │
-│  ┌──────────┐ ┌────────┐ ┌────────────────────┐ │
-│  │ Lifecycle│ │ Router │ │   LLM Providers    │ │
-│  │ Manager  │ │        │ │ OpenAI/DeepSeek/   │ │
-│  │          │ │        │ │ Qwen via agentkits │ │
-│  └──────────┘ └────────┘ └────────────────────┘ │
-├─────────────────────────────────────────────────┤
-│              DTV Framework                       │
-│  Data (read-only) │ Trust (sandbox→listed) │ Value│
-└─────────────────────────────────────────────────┘
-```
+- 🤖 **Agent Framework** — BaseAgent with lifecycle management, skills, and LLM integration
+- 📋 **OAD Schema** — Declarative agent definition (YAML/JSON) with validation
+- 🧠 **Memory System** — Short-term + long-term memory with DeepBrain integration
+- 🔌 **Multi-Channel** — Web, WebSocket, and Telegram channels
+- 🛡️ **DTV Framework** — Data, Trust, and Value tracking for agents
+- 🎯 **Skill System** — Pluggable skills with registry and priority execution
+- 📦 **Templates** — Customer service, sales assistant, knowledge base, code reviewer
+- 🚀 **CLI** — Interactive project creation, dev mode, build, test, run
 
 ## Quick Start
 
 ```bash
-# Install
+# Install globally
 npm install -g opc-agent
 
-# Create a new agent project
-opc init my-agent --template customer-service
-
-# Enter the project
-cd my-agent
-
-# Validate the agent definition
-opc build
+# Create a new agent project (interactive)
+opc init my-agent
 
-# Test in sandbox
-opc test
+# Or with a specific template
+opc init my-bot --template sales-assistant
 
 # Run the agent
+cd my-agent
 opc run
 ```
 
-## OAD — Open Agent Definition
+## Templates
+
+| Template | Description |
+|----------|-------------|
+| `customer-service` | FAQ lookup + human handoff |
+| `sales-assistant` | Product Q&A + lead capture + appointment booking |
+| `knowledge-base` | RAG with DeepBrain semantic search |
+| `code-reviewer` | Bug detection + style checking |
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `opc init [name]` | Create new project (interactive) |
+| `opc create <name>` | Create agent from template |
+| `opc info` | Show agent info from OAD |
+| `opc build` | Validate OAD |
+| `opc test` | Run in sandbox mode |
+| `opc run` | Start agent with channels |
+| `opc dev` | Hot-reload development mode |
+| `opc publish` | Validate and generate manifest |
+| `opc search <query>` | Search OPC Registry (coming soon) |
+
+## OAD Schema
 
-Agents are defined using a declarative YAML format:
+OAD (Open Agent Definition) is a declarative schema for defining agents:
 
 ```yaml
 apiVersion: opc/v1
@@ -64,7 +66,11 @@ kind: Agent
 metadata:
   name: my-agent
   version: 1.0.0
-  description: "My first agent"
+  description: "My AI agent"
+  marketplace:
+    category: support
+    pricing: free
+    tags: [ai, support]
 spec:
   provider:
     default: deepseek
@@ -73,107 +79,90 @@ spec:
   systemPrompt: "You are a helpful assistant."
   skills:
     - name: faq-lookup
-      description: "Look up FAQ answers"
+      description: "Answer FAQs"
   channels:
     - type: web
       port: 3000
+    - type: telegram
+      config:
+        token: "BOT_TOKEN"
+    - type: websocket
+      port: 3002
   memory:
     shortTerm: true
-    longTerm: false
+    longTerm:
+      provider: deepbrain
+      collection: my-knowledge
   dtv:
     trust:
       level: sandbox
     value:
-      metrics: [response_time, satisfaction_score]
+      metrics: [response_time]
 ```
 
-## Programmatic Usage
-
-```typescript
-import { BaseAgent, AgentRuntime, WebChannel } from 'opc-agent';
-
-// Option 1: Use runtime with OAD file
-const runtime = new AgentRuntime();
-await runtime.loadConfig('oad.yaml');
-await runtime.initialize();
-await runtime.start();
+## Memory Providers
 
-// Option 2: Build programmatically
-const agent = new BaseAgent({
-  name: 'my-agent',
-  systemPrompt: 'You are helpful.',
-  provider: 'deepseek',
-  model: 'deepseek-chat',
-});
+### In-Memory (default)
+Simple key-value store. Data lost on restart.
 
-agent.registerSkill(myCustomSkill);
-agent.bindChannel(new WebChannel(3000));
+### DeepBrain (optional)
+Semantic search over past conversations and knowledge. Install `deepbrain` package:
 
-await agent.init();
-await agent.start();
+```bash
+npm install deepbrain
 ```
 
-## Core Concepts
-
-| Concept | Description |
-|---------|-------------|
-| **Agent** | Autonomous AI entity with lifecycle (init → ready → running → stopped) |
-| **Skill** | Modular capability (FAQ, ticket creation, etc.) |
-| **Channel** | User interface (Web HTTP, WebSocket, CLI) |
-| **Memory** | Short-term (session) and long-term (persistent) |
-| **OAD** | Declarative YAML agent definition format |
-
-## DTV Framework
+Configure in OAD:
+```yaml
+memory:
+  longTerm:
+    provider: deepbrain
+    collection: my-collection
+```
 
-**D**ata — **T**rust — **V**alue: A governance framework for agent operations.
+Falls back to in-memory if deepbrain is not installed.
 
-- **Data**: Read-only access to business data via MRGConfig reader
-- **Trust**: Progressive levels control capabilities
-  - `sandbox` → `verified` → `certified` → `listed`
-- **Value**: Metrics tracking for ROI (response time, satisfaction, resolution rate)
+## Channels
 
-## Templates
+- **Web** — Express HTTP server with `/chat` endpoint and SSE streaming
+- **WebSocket** — Real-time bidirectional communication with broadcast
+- **Telegram** — Webhook handler for Telegram Bot API
 
-| Template | Description |
-|----------|-------------|
-| `customer-service` | FAQ + human handoff, web channel |
-| More coming soon... | Sales, IT help desk, content moderation |
+## Programmatic Usage
 
-## CLI Commands
+```typescript
+import { BaseAgent, AgentRuntime } from 'opc-agent';
 
-| Command | Description |
-|---------|-------------|
-| `opc init [name]` | Initialize a new agent project |
-| `opc create <name>` | Create agent from template |
-| `opc build` | Validate OAD definition |
-| `opc test` | Run in sandbox mode |
-| `opc run` | Start agent with channels |
-| `opc publish` | Package for registry (coming soon) |
+// Quick start
+const agent = new BaseAgent({
+  name: 'my-agent',
+  systemPrompt: 'You are helpful.',
+});
+await agent.init();
 
-## Comparison
+// With skills
+agent.registerSkill({
+  name: 'greeter',
+  description: 'Greet users',
+  execute: async (ctx, msg) => {
+    if (msg.content.includes('hello')) {
+      return { handled: true, response: 'Hi!', confidence: 1.0 };
+    }
+    return { handled: false, confidence: 0 };
+  },
+});
 
-| Feature | OPC Agent | LangChain | AutoGen |
-|---------|-----------|-----------|---------|
-| Declarative config | ✅ OAD YAML | ❌ | ❌ |
-| Trust levels | ✅ 4-tier | ❌ | ❌ |
-| Built-in channels | ✅ Web, WS | ❌ | ❌ |
-| Business-focused | ✅ | ❌ General | ❌ Research |
-| Value tracking | ✅ ROI metrics | ❌ | ❌ |
-| TypeScript-first | ✅ | Python | Python |
-| Lightweight | ✅ ~5 deps | ❌ Heavy | ❌ Heavy |
+// From OAD config
+const runtime = new AgentRuntime();
+await runtime.loadConfig('oad.yaml');
+await runtime.initialize();
+await runtime.start();
+```
 
 ## Contributing
 
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/my-feature`
-3. Commit your changes: `git commit -am 'Add my feature'`
-4. Push: `git push origin feature/my-feature`
-5. Open a Pull Request
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## License
 
-[Apache-2.0](LICENSE)
-
----
-
-Built by [Deepleaper](https://github.com/Deepleaper) 🚀
+Apache-2.0 — see [LICENSE](LICENSE).

package/README.zh-CN.md

@@ -1,126 +1,88 @@
 # OPC Agent
 
-**开放 Agent 框架 — 构建、测试和运行面向企业工作站的 AI Agent。**
+**开放 Agent 框架** — 构建、测试和运行企业级 AI Agent。
 
-[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue.svg)](https://www.typescriptlang.org/)
+[![npm version](https://img.shields.io/npm/v/opc-agent.svg)](https://www.npmjs.com/package/opc-agent)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
-OPC Agent 是一个开源框架，用于构建生产级 AI Agent。提供声明式 Agent 定义格式（OAD）、可插拔技能、多通道支持，以及渐进式信任模型确保安全部署。
+## 特性
 
-## 架构
-
-```
-┌─────────────────────────────────────────────────┐
-│                   OPC Agent                      │
-├─────────────┬──────────┬────────────────────────┤
-│    通道      │   技能   │        记忆            │
-│  ┌────────┐ │ ┌──────┐ │  ┌──────────────────┐  │
-│  │  Web   │ │ │ FAQ  │ │  │  短期记忆         │  │
-│  │  WS    │ │ │ 自定义│ │  │  长期记忆         │  │
-│  │  CLI   │ │ │ ...  │ │  └──────────────────┘  │
-│  └────────┘ │ └──────┘ │                        │
-├─────────────┴──────────┴────────────────────────┤
-│              Agent 运行时                        │
-│  ┌──────────┐ ┌────────┐ ┌────────────────────┐ │
-│  │ 生命周期  │ │ 路由器 │ │   LLM 提供商       │ │
-│  │ 管理器    │ │        │ │ OpenAI/DeepSeek/   │ │
-│  │          │ │        │ │ Qwen (agentkits)   │ │
-│  └──────────┘ └────────┘ └────────────────────┘ │
-├─────────────────────────────────────────────────┤
-│              DTV 框架                            │
-│  数据（只读）│ 信任（沙箱→上架）│ 价值（指标追踪）│
-└─────────────────────────────────────────────────┘
-```
+- 🤖 **Agent 框架** — 带生命周期管理、技能和 LLM 集成的 BaseAgent
+- 📋 **OAD Schema** — 声明式 Agent 定义（YAML/JSON），内置校验
+- 🧠 **记忆系统** — 短期 + 长期记忆，支持 DeepBrain 集成
+- 🔌 **多通道** — Web、WebSocket、Telegram 通道
+- 🛡️ **DTV 框架** — 数据、信任、价值追踪
+- 🎯 **技能系统** — 可插拔技能 + 注册表 + 优先级执行
+- 📦 **模板** — 客服、销售助手、知识库、代码审查
+- 🚀 **CLI** — 交互式创建、开发模式、构建、测试、运行
 
 ## 快速开始
 
 ```bash
-# 安装
+# 全局安装
 npm install -g opc-agent
 
-# 创建新的 Agent 项目
-opc init my-agent --template customer-service
-
-# 进入项目目录
-cd my-agent
-
-# 验证 Agent 定义
-opc build
+# 创建新 Agent 项目（交互式）
+opc init my-agent
 
-# 沙箱测试
-opc test
+# 使用指定模板
+opc init my-bot --template sales-assistant
 
 # 运行 Agent
+cd my-agent
 opc run
 ```
 
-## OAD — 开放 Agent 定义
-
-Agent 使用声明式 YAML 格式定义：
+## 模板
 
-```yaml
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: my-agent
-  version: 1.0.0
-  description: "我的第一个 Agent"
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen]
-  model: deepseek-chat
-  systemPrompt: "你是一个有用的助手。"
-  skills:
-    - name: faq-lookup
-      description: "查询常见问题"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: false
-  dtv:
-    trust:
-      level: sandbox
-    value:
-      metrics: [response_time, satisfaction_score]
-```
+| 模板 | 描述 |
+|------|------|
+| `customer-service` | FAQ 查询 + 人工转接 |
+| `sales-assistant` | 产品问答 + 线索捕获 + 预约 |
+| `knowledge-base` | 基于 DeepBrain 的 RAG 语义检索 |
+| `code-reviewer` | Bug 检测 + 代码风格检查 |
 
-## 核心概念
+## CLI 命令
 
-| 概念 | 说明 |
+| 命令 | 描述 |
 |------|------|
-| **Agent** | 自治 AI 实体，具有生命周期（init → ready → running → stopped） |
-| **Skill（技能）** | 模块化能力（FAQ、工单创建等） |
-| **Channel（通道）** | 用户接口（Web HTTP、WebSocket、CLI） |
-| **Memory（记忆）** | 短期（会话内）和长期（持久化） |
-| **OAD** | 声明式 YAML Agent 定义格式 |
+| `opc init [name]` | 创建新项目（交互式） |
+| `opc create <name>` | 从模板创建 Agent |
+| `opc info` | 显示 Agent 信息 |
+| `opc build` | 校验 OAD |
+| `opc test` | 沙箱模式运行 |
+| `opc run` | 启动 Agent |
+| `opc dev` | 热重载开发模式 |
+| `opc publish` | 校验并生成清单 |
+| `opc search <query>` | 搜索 OPC 市场（即将推出） |
 
-## DTV 框架
+## 记忆提供者
 
-**D**ata（数据）— **T**rust（信任）— **V**alue（价值）：Agent 运营治理框架。
+### 内存（默认）
+简单键值存储，重启后数据丢失。
 
-- **数据**：通过 MRGConfig 只读访问业务数据
-- **信任**：渐进式级别控制 Agent 能力
-  - `sandbox`（沙箱）→ `verified`（已验证）→ `certified`（已认证）→ `listed`（已上架）
-- **价值**：ROI 指标追踪（响应时间、满意度、解决率）
+### DeepBrain（可选）
+语义搜索历史对话和知识。安装 `deepbrain` 包后配置：
 
-## CLI 命令
+```yaml
+memory:
+  longTerm:
+    provider: deepbrain
+    collection: my-collection
+```
 
-| 命令 | 说明 |
-|------|------|
-| `opc init [name]` | 初始化新的 Agent 项目 |
-| `opc create <name>` | 从模板创建 Agent |
-| `opc build` | 验证 OAD 定义 |
-| `opc test` | 沙箱模式测试 |
-| `opc run` | 启动 Agent |
-| `opc publish` | 打包到注册中心（即将推出） |
+未安装 deepbrain 时自动降级为内存存储。
 
-## 许可证
+## 通道
 
-[Apache-2.0](LICENSE)
+- **Web** — Express HTTP 服务，`/chat` 接口 + SSE 流式
+- **WebSocket** — 实时双向通信 + 广播
+- **Telegram** — Telegram Bot API Webhook 处理
 
----
+## 贡献
+
+参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+## 许可证
 
-由 [Deepleaper](https://github.com/Deepleaper) 构建 🚀
+Apache-2.0 — 见 [LICENSE](LICENSE)。

package/dist/analytics/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Agent Analytics — track messages, response times, skill usage, errors, tokens.
+ */
+export interface AnalyticsSnapshot {
+    messagesProcessed: number;
+    avgResponseTimeMs: number;
+    skillUsage: Record<string, number>;
+    errorCount: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    uptime: number;
+    startedAt: number;
+}
+export declare class Analytics {
+    private messagesProcessed;
+    private totalResponseTimeMs;
+    private skillUsage;
+    private errorCount;
+    private tokenUsage;
+    private startedAt;
+    recordMessage(responseTimeMs: number): void;
+    recordSkillUsage(skillName: string): void;
+    recordError(): void;
+    recordTokens(input: number, output: number): void;
+    getSnapshot(): AnalyticsSnapshot;
+    reset(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Analytics = void 0;
+class Analytics {
+    messagesProcessed = 0;
+    totalResponseTimeMs = 0;
+    skillUsage = {};
+    errorCount = 0;
+    tokenUsage = { input: 0, output: 0 };
+    startedAt = Date.now();
+    recordMessage(responseTimeMs) {
+        this.messagesProcessed++;
+        this.totalResponseTimeMs += responseTimeMs;
+    }
+    recordSkillUsage(skillName) {
+        this.skillUsage[skillName] = (this.skillUsage[skillName] ?? 0) + 1;
+    }
+    recordError() {
+        this.errorCount++;
+    }
+    recordTokens(input, output) {
+        this.tokenUsage.input += input;
+        this.tokenUsage.output += output;
+    }
+    getSnapshot() {
+        return {
+            messagesProcessed: this.messagesProcessed,
+            avgResponseTimeMs: this.messagesProcessed > 0
+                ? Math.round(this.totalResponseTimeMs / this.messagesProcessed)
+                : 0,
+            skillUsage: { ...this.skillUsage },
+            errorCount: this.errorCount,
+            tokenUsage: {
+                input: this.tokenUsage.input,
+                output: this.tokenUsage.output,
+                total: this.tokenUsage.input + this.tokenUsage.output,
+            },
+            uptime: Date.now() - this.startedAt,
+            startedAt: this.startedAt,
+        };
+    }
+    reset() {
+        this.messagesProcessed = 0;
+        this.totalResponseTimeMs = 0;
+        this.skillUsage = {};
+        this.errorCount = 0;
+        this.tokenUsage = { input: 0, output: 0 };
+        this.startedAt = Date.now();
+    }
+}
+exports.Analytics = Analytics;
+//# sourceMappingURL=index.js.map