feat(mongodb): add requested docs and minimal usage example

.changeset/mongodb-feature-storage.md

@@ -0,0 +1,5 @@
+---
+"@voltagent/mongodb": minor
+---
+
+Initial release of MongoDB memory storage adapter

packages/mongodb/README.md

@@ -0,0 +1,67 @@
+# @voltagent/mongodb
+
+MongoDB storage adapter for VoltAgent memory.
+
+## Installation
+
+```bash
+npm install @voltagent/mongodb
+```
+
+## Minimal Usage
+
+```typescript
+import { Agent, Memory } from "@voltagent/core";
+import { MongoDBMemoryAdapter } from "@voltagent/mongodb";
+
+const agent = new Agent({
+  name: "Assistant",
+  model: "openai/gpt-4o-mini",
+  memory: new Memory({
+    storage: new MongoDBMemoryAdapter({
+      connection: process.env.MONGODB_URI!,
+      database: process.env.MONGODB_DATABASE ?? "voltagent",
+    }),
+  }),
+});
+```
+
+Example environment variables:
+
+```bash
+MONGODB_URI=mongodb://localhost:27017
+MONGODB_DATABASE=voltagent
+```
+
+Customize collection names when you need to isolate multiple apps in the same database:
+
+```typescript
+const memory = new Memory({
+  storage: new MongoDBMemoryAdapter({
+    connection: process.env.MONGODB_URI!,
+    database: process.env.MONGODB_DATABASE ?? "voltagent",
+    collectionPrefix: "support_bot",
+  }),
+});
+```
+
+## Features
+
+- **Persistent Storage**: Stores messages, conversations, conversation steps, workflow states, and working memory in MongoDB.
+- **Efficient Queries**: Indexed for fast retrieval by user, conversation, or date.
+- **Type Safe**: Fully typed implementation of the VoltAgent StorageAdapter interface.
+- **Workflow Support**: Native support for resuming suspended workflows.
+
+## Configuration
+
+| Option             | Type      | Default              | Description            |
+| ------------------ | --------- | -------------------- | ---------------------- |
+| `connection`       | `string`  | required             | MongoDB connection URI |
+| `database`         | `string`  | `"voltagent"`        | Database name          |
+| `collectionPrefix` | `string`  | `"voltagent_memory"` | Prefix for collections |
+| `debug`            | `boolean` | `false`              | Enable debug logging   |
+
+## Learn More
+
+- Memory overview: https://voltagent.dev/docs/agents/memory/overview/
+- MongoDB memory docs: https://voltagent.dev/docs/agents/memory/mongodb/

packages/mongodb/docker-compose.test.yaml

@@ -0,0 +1,18 @@
+services:
+  mongodb-test:
+    image: mongo:7.0
+    container_name: 'voltagent-mongodb-test'
+    ports:
+      - '27017:27017'
+    environment:
+      MONGO_INITDB_DATABASE: voltagent_test
+    volumes:
+      - test_mongodb_data:/data/db
+    healthcheck:
+      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
+      interval: 2s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  test_mongodb_data:

packages/mongodb/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@voltagent/mongodb",
+  "description": "VoltAgent MongoDB - MongoDB Memory provider integration for VoltAgent",
+  "version": "2.0.2",
+  "dependencies": {
+    "mongodb": "^7.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
+    "@voltagent/core": "^2.0.2",
+    "ai": "^6.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "peerDependencies": {
+    "@voltagent/core": "^2.0.0",
+    "ai": "^6.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VoltAgent/voltagent.git",
+    "directory": "packages/mongodb"
+  },
+  "scripts": {
+    "attw": "attw --pack",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "publint": "publint --strict",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "npm run test:integration:setup && vitest run --config vitest.integration.config.mts && npm run test:integration:teardown",
+    "test:integration:ci": "vitest run --config vitest.integration.config.mts",
+    "test:integration:setup": "docker compose -f docker-compose.test.yaml up -d && sleep 10",
+    "test:integration:teardown": "docker compose -f docker-compose.test.yaml down -v"
+  },
+  "types": "dist/index.d.ts"
+}