Initial commit: LibreChat Analytics Dashboard

Express.js + Chart.js dashboard for LibreChat usage analytics. Queries MongoDB transactions collection for model/agent usage, costs, and top users. Dark theme with Montserrat font, black/gold (#FFC407) color scheme. Docker-ready with API key authentication. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 16:48:40 -04:00 · 2026-03-11 16:48:40 -04:00 · 65824fc3b3
commit 65824fc3b3
14 changed files with 2456 additions and 0 deletions
--- a/.dockerignore
+++ b/.dockerignore
@ -0,0 +1,3 @@
+node_modules
+.git
+.env
--- a/.env.example
+++ b/.env.example
@ -0,0 +1,8 @@
+# MongoDB connection string (use container name when on same Docker network)
+MONGO_URI=mongodb://mongodb:27017/LibreChat
+
+# API key required to access the dashboard (change this!)
+DASHBOARD_API_KEY=changeme
+
+# Server port (default 3001)
+PORT=3001
--- a/.gitignore
+++ b/.gitignore
@ -0,0 +1,2 @@
+node_modules/
+.env
--- a/7
+++ b/7
@ -0,0 +1,7 @@
+FROM node:20-alpine
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm ci --production
+COPY . .
+EXPOSE 3001
+CMD ["node", "server.js"]
--- a/config/pricing.js
+++ b/config/pricing.js
@ -0,0 +1,90 @@
+/**
+ * Token pricing (USD per 1M tokens)
+ * Copied from LibreChat api/models/tx.js
+ */
+const tokenValues = {
+  '8k': { prompt: 30, completion: 60 },
+  '32k': { prompt: 60, completion: 120 },
+  '4k': { prompt: 1.5, completion: 2 },
+  '16k': { prompt: 3, completion: 4 },
+  'claude-': { prompt: 0.8, completion: 2.4 },
+  deepseek: { prompt: 0.28, completion: 0.42 },
+  command: { prompt: 0.38, completion: 0.38 },
+  gemini: { prompt: 0.5, completion: 1.5 },
+  'gpt-3.5-turbo-1106': { prompt: 1, completion: 2 },
+  'gpt-3.5-turbo-0125': { prompt: 0.5, completion: 1.5 },
+  'gpt-4-1106': { prompt: 10, completion: 30 },
+  'gpt-4.1': { prompt: 2, completion: 8 },
+  'gpt-4.1-nano': { prompt: 0.1, completion: 0.4 },
+  'gpt-4.1-mini': { prompt: 0.4, completion: 1.6 },
+  'gpt-4.5': { prompt: 75, completion: 150 },
+  'gpt-4o': { prompt: 2.5, completion: 10 },
+  'gpt-4o-2024-05-13': { prompt: 5, completion: 15 },
+  'gpt-4o-mini': { prompt: 0.15, completion: 0.6 },
+  'gpt-5': { prompt: 1.25, completion: 10 },
+  'gpt-5-mini': { prompt: 0.25, completion: 2 },
+  'gpt-5-nano': { prompt: 0.05, completion: 0.4 },
+  o1: { prompt: 15, completion: 60 },
+  'o1-mini': { prompt: 1.1, completion: 4.4 },
+  'o1-preview': { prompt: 15, completion: 60 },
+  o3: { prompt: 2, completion: 8 },
+  'o3-mini': { prompt: 1.1, completion: 4.4 },
+  'o4-mini': { prompt: 1.1, completion: 4.4 },
+  'claude-instant': { prompt: 0.8, completion: 2.4 },
+  'claude-2': { prompt: 8, completion: 24 },
+  'claude-2.1': { prompt: 8, completion: 24 },
+  'claude-3-haiku': { prompt: 0.25, completion: 1.25 },
+  'claude-3-sonnet': { prompt: 3, completion: 15 },
+  'claude-3-opus': { prompt: 15, completion: 75 },
+  'claude-3-5-haiku': { prompt: 0.8, completion: 4 },
+  'claude-3.5-haiku': { prompt: 0.8, completion: 4 },
+  'claude-3-5-sonnet': { prompt: 3, completion: 15 },
+  'claude-3.5-sonnet': { prompt: 3, completion: 15 },
+  'claude-3-7-sonnet': { prompt: 3, completion: 15 },
+  'claude-3.7-sonnet': { prompt: 3, completion: 15 },
+  'claude-haiku-4-5': { prompt: 1, completion: 5 },
+  'claude-opus-4': { prompt: 15, completion: 75 },
+  'claude-opus-4-5': { prompt: 5, completion: 25 },
+  'claude-opus-4-6': { prompt: 5, completion: 25 },
+  'claude-sonnet-4': { prompt: 3, completion: 15 },
+  'claude-sonnet-4-6': { prompt: 3, completion: 15 },
+  'command-r': { prompt: 0.5, completion: 1.5 },
+  'command-r-plus': { prompt: 3, completion: 15 },
+  'deepseek-chat': { prompt: 0.28, completion: 0.42 },
+  'deepseek-reasoner': { prompt: 0.28, completion: 0.42 },
+  'deepseek-r1': { prompt: 0.4, completion: 2.0 },
+  'deepseek-v3': { prompt: 0.2, completion: 0.8 },
+  'gemini-1.5': { prompt: 2.5, completion: 10 },
+  'gemini-1.5-flash': { prompt: 0.15, completion: 0.6 },
+  'gemini-2.0-flash': { prompt: 0.1, completion: 0.4 },
+  'gemini-2.5-flash': { prompt: 0.3, completion: 2.5 },
+  'gemini-2.5-pro': { prompt: 1.25, completion: 10 },
+  'grok-2': { prompt: 2.0, completion: 10.0 },
+  'grok-3': { prompt: 3.0, completion: 15.0 },
+  'grok-3-mini': { prompt: 0.3, completion: 0.5 },
+  'mistral-large': { prompt: 2.0, completion: 6.0 },
+  'mistral-nemo': { prompt: 0.15, completion: 0.15 },
+};
+
+const defaultRate = 6;
+
+/**
+ * Find pricing for a model name using longest-match strategy (same as LibreChat)
+ */
+function getModelPricing(modelName) {
+  if (!modelName) return { prompt: defaultRate, completion: defaultRate };
+
+  let bestMatch = null;
+  let bestLength = 0;
+
+  for (const key of Object.keys(tokenValues)) {
+    if (modelName.includes(key) && key.length > bestLength) {
+      bestMatch = key;
+      bestLength = key.length;
+    }
+  }
+
+  return bestMatch ? tokenValues[bestMatch] : { prompt: defaultRate, completion: defaultRate };
+}
+
+module.exports = { tokenValues, getModelPricing, defaultRate };
--- a/docker-compose.yml
+++ b/docker-compose.yml
@ -0,0 +1,11 @@
+services:
+  analytics:
+    build: .
+    container_name: librechat-analytics
+    restart: unless-stopped
+    ports:
+      - "127.0.0.1:3001:3001"
+    env_file:
+      - .env
+    environment:
+      - PORT=3001
--- a/package-lock.json
+++ b/package-lock.json
@ -0,0 +1,988 @@
+{
+  "name": "librechat-analytics",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "librechat-analytics",
+      "version": "1.0.0",
+      "dependencies": {
+        "dotenv": "^16.4.7",
+        "express": "^4.21.2",
+        "mongodb": "^6.12.0"
+      }
+    },
+    "node_modules/@mongodb-js/saslprep": {
+      "version": "1.4.6",
+      "resolved": "https://registry.npmjs.org/@mongodb-js/saslprep/-/saslprep-1.4.6.tgz",
+      "integrity": "sha512-y+x3H1xBZd38n10NZF/rEBlvDOOMQ6LKUTHqr8R9VkJ+mmQOYtJFxIlkkK8fZrtOiL6VixbOBWMbZGBdal3Z1g==",
+      "license": "MIT",
+      "dependencies": {
+        "sparse-bitfield": "^3.0.3"
+      }
+    },
+    "node_modules/@types/webidl-conversions": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/@types/webidl-conversions/-/webidl-conversions-7.0.3.tgz",
+      "integrity": "sha512-CiJJvcRtIgzadHCYXw7dqEnMNRjhGZlYK05Mj9OyktqV8uVT8fD2BFOB7S1uwBE3Kj2Z+4UyPmFw/Ixgw/LAlA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/whatwg-url": {
+      "version": "11.0.5",
+      "resolved": "https://registry.npmjs.org/@types/whatwg-url/-/whatwg-url-11.0.5.tgz",
+      "integrity": "sha512-coYR071JRaHa+xoEvvYqvnIHaVqaYrLPbsufM9BF63HkwI5Lgmy2QR8Q5K/lYDYo5AK82wOvSOS0UsLTpTG7uQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/webidl-conversions": "*"
+      }
+    },
+    "node_modules/accepts": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+      "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "~2.1.34",
+        "negotiator": "0.6.3"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/array-flatten": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
+      "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
+      "license": "MIT"
+    },
+    "node_modules/body-parser": {
+      "version": "1.20.4",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz",
+      "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "content-type": "~1.0.5",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "~1.2.0",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "on-finished": "~2.4.1",
+        "qs": "~6.14.0",
+        "raw-body": "~2.5.3",
+        "type-is": "~1.6.18",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/bson": {
+      "version": "6.10.4",
+      "resolved": "https://registry.npmjs.org/bson/-/bson-6.10.4.tgz",
+      "integrity": "sha512-WIsKqkSC0ABoBJuT1LEX+2HEvNmNKKgnTAyd0fL8qzK4SH2i9NXg+t08YtdZp/V9IZ33cxe3iV4yM0qg8lMQng==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=16.20.1"
+      }
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/content-disposition": {
+      "version": "0.5.4",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
+      "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
+      "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
+      "license": "MIT"
+    },
+    "node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/destroy": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
+      "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/express": {
+      "version": "4.22.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz",
+      "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "~1.3.8",
+        "array-flatten": "1.1.1",
+        "body-parser": "~1.20.3",
+        "content-disposition": "~0.5.4",
+        "content-type": "~1.0.4",
+        "cookie": "~0.7.1",
+        "cookie-signature": "~1.0.6",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "finalhandler": "~1.3.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.0",
+        "merge-descriptors": "1.0.3",
+        "methods": "~1.1.2",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "path-to-regexp": "~0.1.12",
+        "proxy-addr": "~2.0.7",
+        "qs": "~6.14.0",
+        "range-parser": "~1.2.1",
+        "safe-buffer": "5.2.1",
+        "send": "~0.19.0",
+        "serve-static": "~1.16.2",
+        "setprototypeof": "1.2.0",
+        "statuses": "~2.0.1",
+        "type-is": "~1.6.18",
+        "utils-merge": "1.0.1",
+        "vary": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/finalhandler": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
+      "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "statuses": "~2.0.2",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
+      "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/memory-pager": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/memory-pager/-/memory-pager-1.5.0.tgz",
+      "integrity": "sha512-ZS4Bp4r/Zoeq6+NLJpP+0Zzm0pR8whtGPf1XExKLJBAczGMnSi3It14OiNCStjQjM6NU1okjQGSxgEZN8eBYKg==",
+      "license": "MIT"
+    },
+    "node_modules/merge-descriptors": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+      "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/methods": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
+      "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
+      "license": "MIT",
+      "bin": {
+        "mime": "cli.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mongodb": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/mongodb/-/mongodb-6.21.0.tgz",
+      "integrity": "sha512-URyb/VXMjJ4da46OeSXg+puO39XH9DeQpWCslifrRn9JWugy0D+DvvBvkm2WxmHe61O/H19JM66p1z7RHVkZ6A==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@mongodb-js/saslprep": "^1.3.0",
+        "bson": "^6.10.4",
+        "mongodb-connection-string-url": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=16.20.1"
+      },
+      "peerDependencies": {
+        "@aws-sdk/credential-providers": "^3.188.0",
+        "@mongodb-js/zstd": "^1.1.0 || ^2.0.0",
+        "gcp-metadata": "^5.2.0",
+        "kerberos": "^2.0.1",
+        "mongodb-client-encryption": ">=6.0.0 <7",
+        "snappy": "^7.3.2",
+        "socks": "^2.7.1"
+      },
+      "peerDependenciesMeta": {
+        "@aws-sdk/credential-providers": {
+          "optional": true
+        },
+        "@mongodb-js/zstd": {
+          "optional": true
+        },
+        "gcp-metadata": {
+          "optional": true
+        },
+        "kerberos": {
+          "optional": true
+        },
+        "mongodb-client-encryption": {
+          "optional": true
+        },
+        "snappy": {
+          "optional": true
+        },
+        "socks": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/mongodb-connection-string-url": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mongodb-connection-string-url/-/mongodb-connection-string-url-3.0.2.tgz",
+      "integrity": "sha512-rMO7CGo/9BFwyZABcKAWL8UJwH/Kc2x0g72uhDWzG48URRax5TCIcJ7Rc3RZqffZzO/Gwff/jyKwCU9TN8gehA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@types/whatwg-url": "^11.0.2",
+        "whatwg-url": "^14.1.0 || ^13.0.0"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/negotiator": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+      "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-to-regexp": {
+      "version": "0.1.12",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz",
+      "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==",
+      "license": "MIT"
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/qs": {
+      "version": "6.14.2",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz",
+      "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "2.5.3",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
+      "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
+    "node_modules/send": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
+      "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "1.2.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.1",
+        "mime": "1.6.0",
+        "ms": "2.1.3",
+        "on-finished": "~2.4.1",
+        "range-parser": "~1.2.1",
+        "statuses": "~2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/send/node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/serve-static": {
+      "version": "1.16.3",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
+      "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "parseurl": "~1.3.3",
+        "send": "~0.19.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/sparse-bitfield": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/sparse-bitfield/-/sparse-bitfield-3.0.3.tgz",
+      "integrity": "sha512-kvzhi7vqKTfkh0PZU+2D2PIllw2ymqJKujUcyPMd9Y75Nv4nPbGJZXNhxsgdQab2BmlDct1YnfQCguEvHr7VsQ==",
+      "license": "MIT",
+      "dependencies": {
+        "memory-pager": "^1.0.2"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
+      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
+      "license": "MIT",
+      "dependencies": {
+        "punycode": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/utils-merge": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
+      "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4.0"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
+      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/whatwg-url": {
+      "version": "14.2.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
+      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "^5.1.0",
+        "webidl-conversions": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    }
+  }
+}
--- a/package.json
+++ b/package.json
@ -0,0 +1,14 @@
+{
+  "name": "librechat-analytics",
+  "version": "1.0.0",
+  "description": "Usage analytics dashboard for LibreChat",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "mongodb": "^6.12.0"
+  }
+}
--- a/public/css/style.css
+++ b/public/css/style.css
@ -0,0 +1,413 @@
+:root {
+  --bg-dark: #000000;
+  --sidebar-bg: #0a0a0a;
+  --card-bg: rgba(20, 20, 20, 0.6);
+  --text-main: #f8fafc;
+  --text-muted: #94a3b8;
+  --accent-primary: #FFC407;
+  --accent-green: #4ade80;
+  --accent-purple: #c084fc;
+  --accent-red: #f87171;
+  --accent-amber: #FFC407;
+  --border-color: rgba(255, 196, 7, 0.12);
+  --sidebar-width: 260px;
+  --glass-blur: blur(12px);
+  --grad-primary: linear-gradient(135deg, #FFC407 0%, #CC9D06 100%);
+  --shadow-premium: 0 10px 25px -5px rgba(0, 0, 0, 0.5), 0 8px 10px -6px rgba(0, 0, 0, 0.4);
+}
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+  font-family: "Montserrat", system-ui, -apple-system, sans-serif;
+}
+
+body {
+  background-color: var(--bg-dark);
+  color: var(--text-main);
+  overflow-x: hidden;
+}
+
+#app {
+  display: flex;
+  min-height: 100vh;
+}
+
+/* Sidebar */
+.sidebar {
+  width: var(--sidebar-width);
+  background-color: var(--sidebar-bg);
+  border-right: 1px solid var(--border-color);
+  display: flex;
+  flex-direction: column;
+  position: fixed;
+  height: 100vh;
+  box-shadow: 10px 0 30px rgba(0, 0, 0, 0.2);
+  z-index: 100;
+}
+
+.sidebar-header {
+  padding: 2.5rem 2rem;
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}
+
+.logo-icon {
+  color: var(--accent-primary);
+  width: 28px;
+  height: 28px;
+  filter: drop-shadow(0 0 8px rgba(255, 196, 7, 0.4));
+}
+
+.logo-text {
+  font-size: 1.2rem;
+  font-weight: 800;
+  letter-spacing: -0.025em;
+  background: var(--grad-primary);
+  -webkit-background-clip: text;
+  background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+
+.nav-links {
+  list-style: none;
+  padding: 1rem 0.75rem;
+  flex-grow: 1;
+}
+
+.nav-links li {
+  padding: 0.875rem 1.25rem;
+  margin-bottom: 0.5rem;
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  border-radius: 0.75rem;
+  cursor: pointer;
+  color: var(--text-muted);
+  transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+  font-size: 0.9375rem;
+  font-weight: 500;
+}
+
+.nav-links li:hover {
+  background: rgba(255, 255, 255, 0.05);
+  color: var(--text-main);
+}
+
+.nav-links li.active {
+  background: rgba(255, 196, 7, 0.1);
+  color: var(--accent-primary);
+  box-shadow: inset 0 0 0 1px rgba(255, 196, 7, 0.2);
+}
+
+.sidebar-footer {
+  padding: 1.5rem;
+  border-top: 1px solid var(--border-color);
+  background: rgba(0, 0, 0, 0.1);
+  font-size: 0.8rem;
+  color: var(--text-muted);
+}
+
+/* Content Area */
+.content {
+  margin-left: var(--sidebar-width);
+  flex-grow: 1;
+  padding: 2.5rem 3rem;
+  background:
+    radial-gradient(circle at top right, rgba(255, 196, 7, 0.03), transparent 40%),
+    radial-gradient(circle at bottom left, rgba(255, 196, 7, 0.02), transparent 40%);
+}
+
+.top-bar {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 2rem;
+}
+
+.top-bar h1 {
+  font-size: 1.75rem;
+  font-weight: 800;
+  letter-spacing: -0.025em;
+}
+
+/* Filter Bar */
+.filter-bar {
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  margin-bottom: 1.5rem;
+  padding: 1rem 1.5rem;
+  background: var(--card-bg);
+  backdrop-filter: var(--glass-blur);
+  border: 1px solid var(--border-color);
+  border-radius: 1rem;
+  flex-wrap: wrap;
+}
+
+.period-selector {
+  display: flex;
+  gap: 0.25rem;
+  background: rgba(0, 0, 0, 0.2);
+  padding: 0.25rem;
+  border-radius: 0.5rem;
+}
+
+.period-btn {
+  padding: 0.5rem 1rem;
+  border: none;
+  background: transparent;
+  color: var(--text-muted);
+  border-radius: 0.375rem;
+  cursor: pointer;
+  font-size: 0.875rem;
+  font-weight: 600;
+  transition: all 0.2s;
+}
+
+.period-btn:hover {
+  color: var(--text-main);
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.period-btn.active {
+  background: var(--accent-primary);
+  color: #000000;
+}
+
+.date-range-picker {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.date-range-picker input[type="date"] {
+  width: 150px;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.875rem;
+  background: #0f172a;
+  border: 1px solid var(--border-color);
+  border-radius: 0.5rem;
+  color: var(--text-main);
+  outline: none;
+}
+
+.date-range-picker input[type="date"]:focus {
+  border-color: var(--accent-primary);
+}
+
+.date-separator {
+  color: var(--text-muted);
+  font-size: 0.875rem;
+}
+
+.refresh-info {
+  margin-left: auto;
+  font-size: 0.8rem;
+  color: var(--text-muted);
+}
+
+/* Tabs */
+.tab-content {
+  display: none;
+}
+
+.tab-content.active {
+  display: block;
+  animation: slideUp 0.4s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+@keyframes slideUp {
+  from { opacity: 0; transform: translateY(20px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+/* Stat Cards */
+.stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+  gap: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.stat-card {
+  background: var(--card-bg);
+  backdrop-filter: var(--glass-blur);
+  border: 1px solid var(--border-color);
+  padding: 1.75rem;
+  border-radius: 1.25rem;
+  display: flex;
+  align-items: center;
+  gap: 1.25rem;
+  box-shadow: var(--shadow-premium);
+  transition: transform 0.3s ease, border-color 0.3s ease;
+}
+
+.stat-card:hover {
+  transform: translateY(-4px);
+  border-color: rgba(255, 196, 7, 0.3);
+}
+
+.stat-icon {
+  width: 56px;
+  height: 56px;
+  border-radius: 1rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.stat-icon svg {
+  width: 24px;
+  height: 24px;
+}
+
+.stat-icon.cost { background: rgba(255, 196, 7, 0.1); color: var(--accent-primary); }
+.stat-icon.tokens { background: rgba(255, 196, 7, 0.08); color: #FFD54F; }
+.stat-icon.users { background: rgba(192, 132, 252, 0.1); color: var(--accent-purple); }
+.stat-icon.convos { background: rgba(255, 196, 7, 0.06); color: #FFAB00; }
+
+.stat-label {
+  display: block;
+  font-size: 0.875rem;
+  color: var(--text-muted);
+  margin-bottom: 0.25rem;
+}
+
+.stat-value {
+  font-size: 1.5rem;
+  font-weight: 700;
+}
+
+/* Charts */
+.charts-grid {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 1.5rem;
+  margin-bottom: 2rem;
+}
+
+.chart-wide {
+  grid-column: span 2;
+}
+
+.chart-container {
+  background: var(--card-bg);
+  backdrop-filter: var(--glass-blur);
+  border: 1px solid var(--border-color);
+  padding: 1.5rem;
+  border-radius: 1.25rem;
+  box-shadow: var(--shadow-premium);
+  position: relative;
+}
+
+.chart-container h3 {
+  margin-bottom: 1rem;
+  font-size: 1rem;
+  font-weight: 600;
+  color: var(--text-muted);
+}
+
+.chart-container canvas {
+  width: 100% !important;
+  max-height: 350px;
+}
+
+/* Tables */
+.table-container {
+  background: var(--card-bg);
+  backdrop-filter: var(--glass-blur);
+  border: 1px solid var(--border-color);
+  border-radius: 1.25rem;
+  overflow: hidden;
+  box-shadow: var(--shadow-premium);
+  margin-bottom: 2rem;
+}
+
+.table-header {
+  padding: 1.5rem 2rem;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.table-header h3 {
+  font-size: 1.125rem;
+  font-weight: 700;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+th {
+  background: rgba(15, 23, 42, 0.4);
+  padding: 1rem 1.5rem;
+  font-weight: 600;
+  font-size: 0.8125rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-muted);
+  text-align: left;
+}
+
+th.text-right, td.text-right {
+  text-align: right;
+}
+
+td {
+  padding: 1rem 1.5rem;
+  border-bottom: 1px solid var(--border-color);
+  font-size: 0.9375rem;
+}
+
+tr:hover td {
+  background: rgba(255, 255, 255, 0.02);
+}
+
+.cost-value {
+  color: var(--accent-primary);
+  font-weight: 600;
+}
+
+.token-value {
+  color: #FFD54F;
+  font-weight: 500;
+}
+
+/* Loading */
+.loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 3rem;
+  color: var(--text-muted);
+}
+
+.spinner {
+  width: 24px;
+  height: 24px;
+  border: 3px solid var(--border-color);
+  border-top-color: var(--accent-primary);
+  border-radius: 50%;
+  animation: spin 0.8s linear infinite;
+  margin-right: 1rem;
+}
+
+@keyframes spin {
+  to { transform: rotate(360deg); }
+}
+
+/* Responsive */
+@media (max-width: 1200px) {
+  .charts-grid { grid-template-columns: 1fr; }
+  .chart-wide { grid-column: span 1; }
+}
+
+@media (max-width: 768px) {
+  .sidebar { display: none; }
+  .content { margin-left: 0; padding: 1.5rem; }
+  .filter-bar { flex-direction: column; align-items: stretch; }
+  .stats-grid { grid-template-columns: 1fr 1fr; }
+}
--- a/public/index.html
+++ b/public/index.html
@ -0,0 +1,178 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>LibreChat Analytics</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="css/style.css">
+  <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.7/dist/chart.umd.min.js"></script>
+  <script src="https://unpkg.com/lucide@latest"></script>
+</head>
+<body>
+  <div id="app">
+    <!-- Sidebar -->
+    <nav class="sidebar">
+      <div class="sidebar-header">
+        <svg class="logo-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M21 12V7H5a2 2 0 0 1 0-4h14v4"/>
+          <path d="M3 5v14a2 2 0 0 0 2 2h16v-5"/>
+          <path d="M18 12a2 2 0 0 0 0 4h4v-4Z"/>
+        </svg>
+        <span class="logo-text">Analytics</span>
+      </div>
+      <ul class="nav-links">
+        <li class="active" data-tab="overview">
+          <i data-lucide="bar-chart-3" style="width:20px;height:20px"></i>
+          Overview
+        </li>
+        <li data-tab="users">
+          <i data-lucide="users" style="width:20px;height:20px"></i>
+          Users
+        </li>
+        <li data-tab="models">
+          <i data-lucide="cpu" style="width:20px;height:20px"></i>
+          Models
+        </li>
+        <li data-tab="agents">
+          <i data-lucide="bot" style="width:20px;height:20px"></i>
+          Agents
+        </li>
+      </ul>
+      <div class="sidebar-footer">
+        Auto-refresh: 60s
+      </div>
+    </nav>
+
+    <!-- Main Content -->
+    <main class="content">
+      <div class="top-bar">
+        <h1>LibreChat Analytics</h1>
+      </div>
+
+      <!-- Filter Bar -->
+      <div class="filter-bar">
+        <div class="period-selector">
+          <button class="period-btn active" data-period="24h">24H</button>
+          <button class="period-btn" data-period="7d">7D</button>
+          <button class="period-btn" data-period="30d">30D</button>
+          <button class="period-btn" data-period="custom">Custom</button>
+        </div>
+        <div class="date-range-picker" id="dateRangePicker" style="display:none">
+          <input type="date" id="startDate">
+          <span class="date-separator">to</span>
+          <input type="date" id="endDate">
+        </div>
+        <span class="refresh-info" id="lastRefresh"></span>
+      </div>
+
+      <!-- Overview Tab -->
+      <div class="tab-content active" id="tab-overview">
+        <div class="stats-grid" id="summaryCards">
+          <div class="stat-card">
+            <div class="stat-icon cost"><i data-lucide="dollar-sign"></i></div>
+            <div><span class="stat-label">Total Cost</span><span class="stat-value" id="totalCost">--</span></div>
+          </div>
+          <div class="stat-card">
+            <div class="stat-icon tokens"><i data-lucide="zap"></i></div>
+            <div><span class="stat-label">Total Tokens</span><span class="stat-value" id="totalTokens">--</span></div>
+          </div>
+          <div class="stat-card">
+            <div class="stat-icon users"><i data-lucide="users"></i></div>
+            <div><span class="stat-label">Active Users</span><span class="stat-value" id="activeUsers">--</span></div>
+          </div>
+          <div class="stat-card">
+            <div class="stat-icon convos"><i data-lucide="message-square"></i></div>
+            <div><span class="stat-label">Conversations</span><span class="stat-value" id="conversations">--</span></div>
+          </div>
+        </div>
+        <div class="charts-grid">
+          <div class="chart-container chart-wide">
+            <h3>Usage Over Time</h3>
+            <canvas id="usageChart"></canvas>
+          </div>
+          <div class="chart-container">
+            <h3>Cost by Model</h3>
+            <canvas id="costByModelChart"></canvas>
+          </div>
+          <div class="chart-container">
+            <h3>Cost Breakdown (Input vs Output)</h3>
+            <canvas id="costBreakdownChart"></canvas>
+          </div>
+        </div>
+      </div>
+
+      <!-- Users Tab -->
+      <div class="tab-content" id="tab-users">
+        <div class="table-container">
+          <div class="table-header"><h3>Top Users by Cost</h3></div>
+          <table>
+            <thead>
+              <tr>
+                <th>#</th>
+                <th>Name</th>
+                <th>Email</th>
+                <th class="text-right">Tokens</th>
+                <th class="text-right">Cost</th>
+                <th class="text-right">Conversations</th>
+              </tr>
+            </thead>
+            <tbody id="usersTableBody"></tbody>
+          </table>
+        </div>
+      </div>
+
+      <!-- Models Tab -->
+      <div class="tab-content" id="tab-models">
+        <div class="table-container">
+          <div class="table-header"><h3>Top Models by Cost</h3></div>
+          <table>
+            <thead>
+              <tr>
+                <th>#</th>
+                <th>Model</th>
+                <th class="text-right">Prompt Tokens</th>
+                <th class="text-right">Completion Tokens</th>
+                <th class="text-right">Prompt Cost</th>
+                <th class="text-right">Completion Cost</th>
+                <th class="text-right">Total Cost</th>
+              </tr>
+            </thead>
+            <tbody id="modelsTableBody"></tbody>
+          </table>
+        </div>
+        <div class="charts-grid">
+          <div class="chart-container chart-wide">
+            <h3>Model Cost Comparison (Input vs Output)</h3>
+            <canvas id="modelCostChart"></canvas>
+          </div>
+        </div>
+      </div>
+
+      <!-- Agents Tab -->
+      <div class="tab-content" id="tab-agents">
+        <div class="table-container">
+          <div class="table-header"><h3>Top Agents by Cost</h3></div>
+          <table>
+            <thead>
+              <tr>
+                <th>#</th>
+                <th>Agent Name</th>
+                <th>Underlying Model</th>
+                <th>Provider</th>
+                <th class="text-right">Tokens</th>
+                <th class="text-right">Cost</th>
+                <th class="text-right">Conversations</th>
+              </tr>
+            </thead>
+            <tbody id="agentsTableBody"></tbody>
+          </table>
+        </div>
+      </div>
+    </main>
+  </div>
+
+  <script src="js/app.js"></script>
+</body>
+</html>
--- a/public/js/app.js
+++ b/public/js/app.js
@ -0,0 +1,328 @@
+// --- Config ---
+const API_KEY = localStorage.getItem('analyticsApiKey') || '';
+const REFRESH_INTERVAL = 60000;
+
+let currentPeriod = '24h';
+let charts = {};
+
+// --- API Helpers ---
+function apiHeaders() {
+  const h = { 'Content-Type': 'application/json' };
+  if (API_KEY) h['x-api-key'] = API_KEY;
+  return h;
+}
+
+function queryParams() {
+  const params = new URLSearchParams({ period: currentPeriod });
+  if (currentPeriod === 'custom') {
+    params.set('start', document.getElementById('startDate').value);
+    params.set('end', document.getElementById('endDate').value);
+  }
+  return params.toString();
+}
+
+async function fetchAPI(endpoint) {
+  const sep = endpoint.includes('?') ? '&' : '?';
+  const res = await fetch(`/api/${endpoint}${sep}${queryParams()}`, { headers: apiHeaders() });
+  if (!res.ok) throw new Error(`API error: ${res.status}`);
+  return res.json();
+}
+
+// --- Formatters ---
+function fmtCost(v) {
+  if (v == null) return '--';
+  return '$' + v.toFixed(2);
+}
+
+function fmtTokens(v) {
+  if (v == null) return '--';
+  if (v >= 1_000_000) return (v / 1_000_000).toFixed(1) + 'M';
+  if (v >= 1_000) return (v / 1_000).toFixed(1) + 'K';
+  return v.toLocaleString();
+}
+
+function fmtNum(v) {
+  if (v == null) return '--';
+  return v.toLocaleString();
+}
+
+// --- Chart defaults ---
+Chart.defaults.color = '#94a3b8';
+Chart.defaults.borderColor = 'rgba(255,255,255,0.06)';
+Chart.defaults.font.family = 'Montserrat, system-ui, sans-serif';
+
+const CHART_COLORS = [
+  '#FFC407', '#FFD54F', '#FFAB00', '#c084fc', '#f87171',
+  '#a78bfa', '#4ade80', '#fb923c', '#e879f9', '#22d3ee',
+];
+
+// --- Tab Navigation ---
+document.querySelectorAll('.nav-links li').forEach(li => {
+  li.addEventListener('click', () => {
+    document.querySelectorAll('.nav-links li').forEach(l => l.classList.remove('active'));
+    document.querySelectorAll('.tab-content').forEach(t => t.classList.remove('active'));
+    li.classList.add('active');
+    document.getElementById('tab-' + li.dataset.tab).classList.add('active');
+  });
+});
+
+// --- Period Selector ---
+document.querySelectorAll('.period-btn').forEach(btn => {
+  btn.addEventListener('click', () => {
+    document.querySelectorAll('.period-btn').forEach(b => b.classList.remove('active'));
+    btn.classList.add('active');
+    currentPeriod = btn.dataset.period;
+    document.getElementById('dateRangePicker').style.display =
+      currentPeriod === 'custom' ? 'flex' : 'none';
+    if (currentPeriod !== 'custom') refreshAll();
+  });
+});
+
+// Custom date range change
+document.getElementById('startDate').addEventListener('change', refreshAll);
+document.getElementById('endDate').addEventListener('change', refreshAll);
+
+// --- Data Loading ---
+async function loadSummary() {
+  try {
+    const d = await fetchAPI('summary');
+    document.getElementById('totalCost').textContent = fmtCost(d.totalCost);
+    document.getElementById('totalTokens').textContent = fmtTokens(d.totalTokens);
+    document.getElementById('activeUsers').textContent = fmtNum(d.activeUsers);
+    document.getElementById('conversations').textContent = fmtNum(d.conversations);
+  } catch (e) { console.error('Summary:', e); }
+}
+
+async function loadUsageOverTime() {
+  try {
+    const d = await fetchAPI('usage-over-time');
+    const labels = d.data.map(p => {
+      if (d.bucketType === 'hour') {
+        const dt = new Date(p.time);
+        return dt.toLocaleString([], { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' });
+      }
+      return new Date(p.time).toLocaleDateString([], { month: 'short', day: 'numeric' });
+    });
+    const costData = d.data.map(p => p.cost);
+    const tokenData = d.data.map(p => p.tokens);
+
+    if (charts.usage) charts.usage.destroy();
+    charts.usage = new Chart(document.getElementById('usageChart'), {
+      type: 'line',
+      data: {
+        labels,
+        datasets: [
+          {
+            label: 'Cost ($)',
+            data: costData,
+            borderColor: '#FFC407',
+            backgroundColor: 'rgba(255,196,7,0.1)',
+            fill: true,
+            tension: 0.3,
+            yAxisID: 'y',
+          },
+          {
+            label: 'Tokens',
+            data: tokenData,
+            borderColor: '#FFD54F',
+            backgroundColor: 'rgba(255,213,79,0.1)',
+            fill: true,
+            tension: 0.3,
+            yAxisID: 'y1',
+          }
+        ]
+      },
+      options: {
+        responsive: true,
+        interaction: { mode: 'index', intersect: false },
+        scales: {
+          y: { type: 'linear', position: 'left', title: { display: true, text: 'Cost ($)' } },
+          y1: { type: 'linear', position: 'right', grid: { drawOnChartArea: false }, title: { display: true, text: 'Tokens' } },
+        },
+        plugins: { legend: { position: 'top' } }
+      }
+    });
+  } catch (e) { console.error('Usage chart:', e); }
+}
+
+async function loadCostByModel() {
+  try {
+    const d = await fetchAPI('cost-breakdown');
+    const top = d.slice(0, 8);
+    const labels = top.map(m => m.model);
+    const costs = top.map(m => m.totalCost);
+
+    if (charts.costByModel) charts.costByModel.destroy();
+    charts.costByModel = new Chart(document.getElementById('costByModelChart'), {
+      type: 'doughnut',
+      data: {
+        labels,
+        datasets: [{
+          data: costs,
+          backgroundColor: CHART_COLORS.slice(0, top.length),
+          borderWidth: 0,
+        }]
+      },
+      options: {
+        responsive: true,
+        plugins: {
+          legend: { position: 'right', labels: { padding: 12, usePointStyle: true } },
+          tooltip: { callbacks: { label: ctx => `${ctx.label}: $${ctx.parsed.toFixed(2)}` } }
+        }
+      }
+    });
+  } catch (e) { console.error('Cost by model:', e); }
+}
+
+async function loadCostBreakdown() {
+  try {
+    const d = await fetchAPI('cost-breakdown');
+    const top = d.slice(0, 10);
+    const labels = top.map(m => m.model);
+
+    if (charts.costBreakdown) charts.costBreakdown.destroy();
+    charts.costBreakdown = new Chart(document.getElementById('costBreakdownChart'), {
+      type: 'bar',
+      data: {
+        labels,
+        datasets: [
+          { label: 'Input Cost', data: top.map(m => m.inputCost), backgroundColor: '#FFC407' },
+          { label: 'Output Cost', data: top.map(m => m.outputCost), backgroundColor: '#FFAB00' },
+        ]
+      },
+      options: {
+        responsive: true,
+        scales: {
+          x: { stacked: true, ticks: { maxRotation: 45 } },
+          y: { stacked: true, title: { display: true, text: 'Cost ($)' } },
+        },
+        plugins: {
+          tooltip: { callbacks: { label: ctx => `${ctx.dataset.label}: $${ctx.parsed.y.toFixed(4)}` } }
+        }
+      }
+    });
+  } catch (e) { console.error('Cost breakdown:', e); }
+}
+
+async function loadTopUsers() {
+  try {
+    const d = await fetchAPI('top-users?limit=20');
+    const tbody = document.getElementById('usersTableBody');
+    tbody.innerHTML = d.map((u, i) => `
+      <tr>
+        <td>${i + 1}</td>
+        <td>${escHtml(u.name)}</td>
+        <td>${escHtml(u.email)}</td>
+        <td class="text-right token-value">${fmtTokens(u.totalTokens)}</td>
+        <td class="text-right cost-value">${fmtCost(u.totalCost)}</td>
+        <td class="text-right">${fmtNum(u.conversationCount)}</td>
+      </tr>
+    `).join('');
+  } catch (e) { console.error('Top users:', e); }
+}
+
+async function loadTopModels() {
+  try {
+    const d = await fetchAPI('top-models?limit=20');
+    const tbody = document.getElementById('modelsTableBody');
+    tbody.innerHTML = d.map((m, i) => `
+      <tr>
+        <td>${i + 1}</td>
+        <td>${escHtml(m.model)}</td>
+        <td class="text-right token-value">${fmtTokens(m.promptTokens)}</td>
+        <td class="text-right token-value">${fmtTokens(m.completionTokens)}</td>
+        <td class="text-right cost-value">${fmtCost(m.promptCost)}</td>
+        <td class="text-right cost-value">${fmtCost(m.completionCost)}</td>
+        <td class="text-right cost-value">${fmtCost(m.totalCost)}</td>
+      </tr>
+    `).join('');
+
+    // Models chart
+    const top = d.slice(0, 8);
+    if (charts.modelCost) charts.modelCost.destroy();
+    charts.modelCost = new Chart(document.getElementById('modelCostChart'), {
+      type: 'bar',
+      data: {
+        labels: top.map(m => m.model),
+        datasets: [
+          { label: 'Prompt Cost', data: top.map(m => m.promptCost), backgroundColor: '#FFC407' },
+          { label: 'Completion Cost', data: top.map(m => m.completionCost), backgroundColor: '#FFAB00' },
+        ]
+      },
+      options: {
+        responsive: true,
+        indexAxis: 'y',
+        scales: {
+          x: { stacked: true, title: { display: true, text: 'Cost ($)' } },
+          y: { stacked: true },
+        },
+        plugins: {
+          tooltip: { callbacks: { label: ctx => `${ctx.dataset.label}: $${ctx.parsed.x.toFixed(4)}` } }
+        }
+      }
+    });
+  } catch (e) { console.error('Top models:', e); }
+}
+
+async function loadTopAgents() {
+  try {
+    const d = await fetchAPI('top-agents?limit=20');
+    const tbody = document.getElementById('agentsTableBody');
+    if (d.length === 0) {
+      tbody.innerHTML = '<tr><td colspan="7" style="text-align:center;color:var(--text-muted)">No agent usage found in this period</td></tr>';
+      return;
+    }
+    tbody.innerHTML = d.map((a, i) => `
+      <tr>
+        <td>${i + 1}</td>
+        <td>${escHtml(a.agentName)}</td>
+        <td>${escHtml(a.underlyingModel)}</td>
+        <td>${escHtml(a.provider)}</td>
+        <td class="text-right token-value">${fmtTokens(a.totalTokens)}</td>
+        <td class="text-right cost-value">${fmtCost(a.totalCost)}</td>
+        <td class="text-right">${fmtNum(a.conversationCount)}</td>
+      </tr>
+    `).join('');
+  } catch (e) { console.error('Top agents:', e); }
+}
+
+function escHtml(s) {
+  if (!s) return '';
+  const div = document.createElement('div');
+  div.textContent = s;
+  return div.innerHTML;
+}
+
+// --- Refresh All ---
+async function refreshAll() {
+  document.getElementById('lastRefresh').textContent =
+    'Last refresh: ' + new Date().toLocaleTimeString();
+
+  await Promise.allSettled([
+    loadSummary(),
+    loadUsageOverTime(),
+    loadCostByModel(),
+    loadCostBreakdown(),
+    loadTopUsers(),
+    loadTopModels(),
+    loadTopAgents(),
+  ]);
+}
+
+// --- Init ---
+lucide.createIcons();
+refreshAll();
+setInterval(refreshAll, REFRESH_INTERVAL);
+
+// --- API Key Setup (prompt if needed) ---
+(function checkAuth() {
+  fetch('/api/summary', { headers: apiHeaders() }).then(res => {
+    if (res.status === 401) {
+      const key = prompt('Enter Dashboard API Key:');
+      if (key) {
+        localStorage.setItem('analyticsApiKey', key);
+        location.reload();
+      }
+    }
+  });
+})();
--- a/routes/api.js
+++ b/routes/api.js
@ -0,0 +1,68 @@
+const express = require('express');
+const router = express.Router();
+const analytics = require('../services/analytics');
+
+router.get('/summary', async (req, res) => {
+  try {
+    const data = await analytics.getSummary(req.db, req.query);
+    res.json(data);
+  } catch (err) {
+    console.error('Summary error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+router.get('/top-users', async (req, res) => {
+  try {
+    const limit = parseInt(req.query.limit) || 10;
+    const data = await analytics.getTopUsers(req.db, req.query, limit);
+    res.json(data);
+  } catch (err) {
+    console.error('Top users error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+router.get('/top-models', async (req, res) => {
+  try {
+    const limit = parseInt(req.query.limit) || 10;
+    const data = await analytics.getTopModels(req.db, req.query, limit);
+    res.json(data);
+  } catch (err) {
+    console.error('Top models error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+router.get('/top-agents', async (req, res) => {
+  try {
+    const limit = parseInt(req.query.limit) || 10;
+    const data = await analytics.getTopAgents(req.db, req.query, limit);
+    res.json(data);
+  } catch (err) {
+    console.error('Top agents error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+router.get('/cost-breakdown', async (req, res) => {
+  try {
+    const data = await analytics.getCostBreakdown(req.db, req.query);
+    res.json(data);
+  } catch (err) {
+    console.error('Cost breakdown error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+router.get('/usage-over-time', async (req, res) => {
+  try {
+    const data = await analytics.getUsageOverTime(req.db, req.query);
+    res.json(data);
+  } catch (err) {
+    console.error('Usage over time error:', err);
+    res.status(500).json({ error: err.message });
+  }
+});
+
+module.exports = router;
--- a/server.js
+++ b/server.js
@ -0,0 +1,61 @@
+require('dotenv').config();
+const express = require('express');
+const path = require('path');
+const { MongoClient } = require('mongodb');
+const apiRoutes = require('./routes/api');
+
+const app = express();
+const PORT = process.env.PORT || 3001;
+const MONGO_URI = process.env.MONGO_URI || 'mongodb://localhost:27017/LibreChat';
+
+let db;
+
+async function connectDB() {
+  const client = new MongoClient(MONGO_URI);
+  await client.connect();
+  db = client.db();
+  console.log('Connected to MongoDB');
+  return db;
+}
+
+// Health check (no auth)
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', uptime: process.uptime() });
+});
+
+// API key auth middleware — protects both API and dashboard
+function authMiddleware(req, res, next) {
+  const apiKey = req.headers['x-api-key'] || req.query.key;
+  const expected = process.env.DASHBOARD_API_KEY;
+  if (!expected || expected === 'changeme') {
+    console.warn('WARNING: DASHBOARD_API_KEY not set — dashboard is unprotected!');
+    return next();
+  }
+  if (apiKey !== expected) {
+    return res.status(401).json({ error: 'Unauthorized' });
+  }
+  next();
+}
+
+// Static files
+app.use(express.static(path.join(__dirname, 'public')));
+
+// API routes
+app.use('/api', authMiddleware, (req, res, next) => {
+  req.db = db;
+  next();
+}, apiRoutes);
+
+// SPA fallback
+app.get('*', (req, res) => {
+  res.sendFile(path.join(__dirname, 'public', 'index.html'));
+});
+
+connectDB().then(() => {
+  app.listen(PORT, () => {
+    console.log(`Analytics dashboard running on port ${PORT}`);
+  });
+}).catch(err => {
+  console.error('Failed to connect to MongoDB:', err);
+  process.exit(1);
+});
--- a/services/analytics.js
+++ b/services/analytics.js
@ -0,0 +1,285 @@
+const { getModelPricing } = require('../config/pricing');
+
+// Cache agents collection in memory, refresh every 5 min
+let agentsCache = new Map();
+let agentsCacheTime = 0;
+const CACHE_TTL = 5 * 60 * 1000;
+
+async function refreshAgentsCache(db) {
+  if (Date.now() - agentsCacheTime < CACHE_TTL && agentsCache.size > 0) return;
+  try {
+    const agents = await db.collection('agents').find({}).toArray();
+    agentsCache = new Map();
+    for (const a of agents) {
+      agentsCache.set(a.id, { name: a.name, model: a.model, provider: a.provider });
+    }
+    agentsCacheTime = Date.now();
+  } catch (e) {
+    console.error('Failed to refresh agents cache:', e.message);
+  }
+}
+
+function resolveModel(model) {
+  if (model && model.startsWith('agent_')) {
+    const agent = agentsCache.get(model);
+    return agent ? agent.model : model;
+  }
+  return model;
+}
+
+function getDateRange(query) {
+  const { period, start, end } = query;
+  const now = new Date();
+  let startDate, endDate;
+
+  if (period === 'custom' && start && end) {
+    startDate = new Date(start);
+    endDate = new Date(end);
+    endDate.setHours(23, 59, 59, 999);
+  } else {
+    endDate = now;
+    switch (period) {
+      case '7d': startDate = new Date(now - 7 * 86400000); break;
+      case '30d': startDate = new Date(now - 30 * 86400000); break;
+      case '24h':
+      default: startDate = new Date(now - 24 * 3600000); break;
+    }
+  }
+  return { startDate, endDate };
+}
+
+async function getSummary(db, query) {
+  await refreshAgentsCache(db);
+  const { startDate, endDate } = getDateRange(query);
+
+  const [tokenResult, userCount, convCount] = await Promise.all([
+    db.collection('transactions').aggregate([
+      { $match: { createdAt: { $gte: startDate, $lte: endDate } } },
+      {
+        $group: {
+          _id: null,
+          totalTokens: { $sum: { $abs: '$rawAmount' } },
+          totalCost: { $sum: { $abs: '$tokenValue' } },
+        }
+      }
+    ]).toArray(),
+    db.collection('transactions').distinct('user', {
+      createdAt: { $gte: startDate, $lte: endDate }
+    }),
+    db.collection('transactions').distinct('conversationId', {
+      createdAt: { $gte: startDate, $lte: endDate }
+    }),
+  ]);
+
+  const t = tokenResult[0] || { totalTokens: 0, totalCost: 0 };
+  return {
+    totalTokens: t.totalTokens,
+    totalCost: t.totalCost / 1_000_000,
+    activeUsers: userCount.length,
+    conversations: convCount.length,
+  };
+}
+
+async function getTopUsers(db, query, limit = 10) {
+  const { startDate, endDate } = getDateRange(query);
+
+  const results = await db.collection('transactions').aggregate([
+    { $match: { createdAt: { $gte: startDate, $lte: endDate } } },
+    {
+      $group: {
+        _id: '$user',
+        totalTokens: { $sum: { $abs: '$rawAmount' } },
+        totalCost: { $sum: { $abs: '$tokenValue' } },
+        conversations: { $addToSet: '$conversationId' },
+      }
+    },
+    { $sort: { totalCost: -1 } },
+    { $limit: limit },
+    {
+      $lookup: {
+        from: 'users',
+        localField: '_id',
+        foreignField: '_id',
+        as: 'userInfo'
+      }
+    },
+    { $unwind: { path: '$userInfo', preserveNullAndEmptyArrays: true } },
+    {
+      $project: {
+        name: { $ifNull: ['$userInfo.name', 'Unknown'] },
+        email: { $ifNull: ['$userInfo.email', ''] },
+        totalTokens: 1,
+        totalCost: { $divide: ['$totalCost', 1_000_000] },
+        conversationCount: { $size: '$conversations' },
+      }
+    }
+  ]).toArray();
+
+  return results;
+}
+
+async function getTopModels(db, query, limit = 10) {
+  await refreshAgentsCache(db);
+  const { startDate, endDate } = getDateRange(query);
+
+  const raw = await db.collection('transactions').aggregate([
+    { $match: { createdAt: { $gte: startDate, $lte: endDate } } },
+    {
+      $group: {
+        _id: { model: '$model', tokenType: '$tokenType' },
+        totalTokens: { $sum: { $abs: '$rawAmount' } },
+        totalCost: { $sum: { $abs: '$tokenValue' } },
+      }
+    }
+  ]).toArray();
+
+  // Resolve agents to underlying LLM and re-aggregate
+  const modelMap = new Map();
+  for (const r of raw) {
+    const resolvedModel = resolveModel(r._id.model);
+    const key = `${resolvedModel}::${r._id.tokenType}`;
+    if (!modelMap.has(key)) {
+      modelMap.set(key, { model: resolvedModel, tokenType: r._id.tokenType, totalTokens: 0, totalCost: 0 });
+    }
+    const entry = modelMap.get(key);
+    entry.totalTokens += r.totalTokens;
+    entry.totalCost += r.totalCost;
+  }
+
+  // Pivot into per-model summary
+  const models = new Map();
+  for (const entry of modelMap.values()) {
+    if (!models.has(entry.model)) {
+      models.set(entry.model, { model: entry.model, promptTokens: 0, completionTokens: 0, promptCost: 0, completionCost: 0, totalCost: 0 });
+    }
+    const m = models.get(entry.model);
+    if (entry.tokenType === 'prompt') {
+      m.promptTokens += entry.totalTokens;
+      m.promptCost += entry.totalCost / 1_000_000;
+    } else {
+      m.completionTokens += entry.totalTokens;
+      m.completionCost += entry.totalCost / 1_000_000;
+    }
+    m.totalCost = m.promptCost + m.completionCost;
+  }
+
+  return Array.from(models.values())
+    .sort((a, b) => b.totalCost - a.totalCost)
+    .slice(0, limit);
+}
+
+async function getTopAgents(db, query, limit = 10) {
+  await refreshAgentsCache(db);
+  const { startDate, endDate } = getDateRange(query);
+
+  const results = await db.collection('transactions').aggregate([
+    { $match: { createdAt: { $gte: startDate, $lte: endDate }, model: { $regex: /^agent_/ } } },
+    {
+      $group: {
+        _id: '$model',
+        totalTokens: { $sum: { $abs: '$rawAmount' } },
+        totalCost: { $sum: { $abs: '$tokenValue' } },
+        conversations: { $addToSet: '$conversationId' },
+      }
+    },
+    { $sort: { totalCost: -1 } },
+    { $limit: limit },
+    {
+      $project: {
+        agentId: '$_id',
+        totalTokens: 1,
+        totalCost: { $divide: ['$totalCost', 1_000_000] },
+        conversationCount: { $size: '$conversations' },
+      }
+    }
+  ]).toArray();
+
+  return results.map(r => {
+    const agent = agentsCache.get(r.agentId);
+    return {
+      ...r,
+      agentName: agent ? agent.name : r.agentId,
+      underlyingModel: agent ? agent.model : 'Unknown',
+      provider: agent ? agent.provider : 'Unknown',
+    };
+  });
+}
+
+async function getCostBreakdown(db, query) {
+  await refreshAgentsCache(db);
+  const { startDate, endDate } = getDateRange(query);
+
+  const raw = await db.collection('transactions').aggregate([
+    { $match: { createdAt: { $gte: startDate, $lte: endDate } } },
+    {
+      $group: {
+        _id: { model: '$model', tokenType: '$tokenType' },
+        totalCost: { $sum: { $abs: '$tokenValue' } },
+      }
+    }
+  ]).toArray();
+
+  const models = new Map();
+  for (const r of raw) {
+    const resolved = resolveModel(r._id.model);
+    if (!models.has(resolved)) {
+      models.set(resolved, { model: resolved, inputCost: 0, outputCost: 0 });
+    }
+    const m = models.get(resolved);
+    if (r._id.tokenType === 'prompt') {
+      m.inputCost += r.totalCost / 1_000_000;
+    } else {
+      m.outputCost += r.totalCost / 1_000_000;
+    }
+  }
+
+  return Array.from(models.values())
+    .map(m => ({ ...m, totalCost: m.inputCost + m.outputCost }))
+    .sort((a, b) => b.totalCost - a.totalCost);
+}
+
+async function getUsageOverTime(db, query) {
+  const { startDate, endDate } = getDateRange(query);
+  const diffMs = endDate - startDate;
+  const diffHours = diffMs / 3600000;
+
+  // Use hourly buckets for <=48h, daily for longer
+  let dateFormat, bucketLabel;
+  if (diffHours <= 48) {
+    dateFormat = { $dateToString: { format: '%Y-%m-%dT%H:00', date: '$createdAt' } };
+    bucketLabel = 'hour';
+  } else {
+    dateFormat = { $dateToString: { format: '%Y-%m-%d', date: '$createdAt' } };
+    bucketLabel = 'day';
+  }
+
+  const results = await db.collection('transactions').aggregate([
+    { $match: { createdAt: { $gte: startDate, $lte: endDate } } },
+    {
+      $group: {
+        _id: dateFormat,
+        totalTokens: { $sum: { $abs: '$rawAmount' } },
+        totalCost: { $sum: { $abs: '$tokenValue' } },
+      }
+    },
+    { $sort: { _id: 1 } },
+  ]).toArray();
+
+  return {
+    bucketType: bucketLabel,
+    data: results.map(r => ({
+      time: r._id,
+      tokens: r.totalTokens,
+      cost: r.totalCost / 1_000_000,
+    })),
+  };
+}
+
+module.exports = {
+  getSummary,
+  getTopUsers,
+  getTopModels,
+  getTopAgents,
+  getCostBreakdown,
+  getUsageOverTime,
+};