mcp-for-memos 1.0.0

package/README.md

@@ -0,0 +1,334 @@
+# memos-mcp
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that turns [Memos](https://github.com/usememos/memos) into a **multi-purpose database** for your AI assistants — notes, projects, tasks, agendas, knowledge base, and more.
+
+[中文文档](README_zh.md)
+
+## What is this?
+
+**memos-mcp** is a bridge between AI assistants and your Memos instance. Instead of context windows that forget, your AI has a **persistent memory database** it can query, create, and organize notes in.
+
+Think of it as:
+- 📝 **Personal knowledge base** — capture ideas, research, learnings
+- 📋 **Task manager** — to-dos, checklists, project tracking
+- 📅 **Agenda/planner** — schedules, meeting notes, deadlines
+- 🏗️ **Project database** — specs, decisions, retrospectives
+- 🔖 **Bookmark system** — save links, quotes, references
+
+Your AI assistant can search by date, filter by tags, create notes on the fly, and query your entire history — all through natural language.
+
+---
+
+## What can the AI do with this MCP?
+
+Once connected, your AI assistant gains **persistent memory**. Here's what it can do:
+
+### 📝 Create Notes
+- Save meeting notes, ideas, tasks, or anything
+- Use `#hashtags` for automatic tagging
+- Backdate notes to a specific time
+- Markdown support (bold, lists, code blocks, etc.)
+
+### 🔍 Search & Recall
+- "What did I do yesterday?" → searches by date
+- "Show me #project notes" → filters by tag
+- "Find notes about API design" → full-text search
+- "What's on my agenda today?" → today's memos
+- "Notes from last week" → date range search
+- "Show pinned notes" → filter by pin status
+- "Find notes with incomplete tasks" → task filter
+
+### ✏️ Update & Organize
+- Edit existing notes
+- Pin important memos
+- Archive old notes
+- Change visibility (private/public)
+
+### 🗑️ Clean Up
+- Delete notes you no longer need
+
+### 🏷️ Tag Management
+- List all tags with usage counts
+- Browse tag hierarchy (`#work/meeting`, `#project/backend`)
+- Analyze and suggest tag improvements
+
+---
+
+## Tools (6)
+
+| Tool | What it does | Key Features |
+|------|-------------|--------------|
+| `search` | Search memos by date, tags, content, visibility, pinned status | Relative dates (`today`, `yesterday`, `next_monday`), date ranges, week view, full-text search |
+| `get` | Get a single memo's full content | By ID or UID, includes attachments metadata |
+| `create` | Create a memo with markdown and #hashtags | Backdate support, visibility control. **Max 13,000 chars** |
+| `update` | Update memo content, visibility, or pin status | Partial updates (only changed fields), archive/restore |
+| `delete` | Permanently delete a memo | Cannot be undone |
+| `tags` | List all tags with usage counts | Hierarchical: top-level, children, or recursive flat list |
+
+### Search Date Examples
+
+| You say | The AI calls |
+|---------|-------------|
+| "What did I do yesterday?" | `search(date="yesterday")` |
+| "What's on my agenda today?" | `search(date="today")` |
+| "Notes from last week" | `search(date="last_week", week=true)` |
+| "Show me #project notes" | `search(tags=["project"])` |
+| "Find notes about API design" | `search(query="API design")` |
+| "What happened on June 15?" | `search(date="2025-06-15")` |
+| "March to April overview" | `search(date="2025-03-01", endDate="2025-04-30")` |
+| "Show all my memos" | `search()` |
+| "Find notes with incomplete tasks" | `search(hasIncompleteTasks=true)` |
+| "Show notes with attachments" | `search(hasAttachments=true)` |
+
+### Supported Relative Dates
+
+`today`, `yesterday`, `tomorrow`, `this_week`, `next_week`, `last_week`, `this_month`, `next_month`, `last_month`, `next_monday`, `last_friday`, `3_days_ago`, `in_7_days`, `2_weeks_ago`, `in_2_weeks`
+
+---
+
+## Prompts (4)
+
+Prompts are pre-built workflows the AI can follow:
+
+| Prompt | What it does | Workflow |
+|--------|-------------|----------|
+| `capture` | Quick-save a thought, task, or idea | Asks for content + optional tags, creates memo |
+| `review` | Review memos from a time period | Searches memos, reads each one, summarizes |
+| `on_day` | Check what happened/is planned for a date | Searches by date, presents findings |
+| `tag_overview` | Analyze your tag system | Lists tags, shows hierarchy, suggests cleanup |
+
+---
+
+## What the AI sees (Model Instructions)
+
+When the AI connects to this MCP, it receives these tool descriptions:
+
+### `create` tool instructions:
+> "Create a memo with markdown content. Use #hashtags for tags. **CRITICAL LIMIT: Each memo MUST NOT exceed 13,000 characters.** The Memos server enforces a hard limit of ~18K but to avoid errors always stay under 13K. If you need to write more, split into multiple memos with a shared tag (e.g. #project/my-post) and add part numbers."
+
+### `search` tool instructions:
+> "Search memos. Unified tool for date-based, tag-based, and content-based search. Date accepts ISO, relative dates ('today', 'yesterday', 'next_monday'), and week mode. Filters: tags, query, visibility, pinned, state, hasIncompleteTasks, hasAttachments. No date = all memos."
+
+### `tags` tool instructions:
+> "List tags with usage counts extracted from your memo content. Tags are hashtags like #project or #work/meeting. Results are cached for 60 seconds. No args = top-level tags only. parent='work' = children of 'work'. recursive=true = all tags flat."
+
+### `update` tool instructions:
+> "Update memo fields. Only provided fields are changed. CRITICAL: MUST NOT exceed 13,000 chars."
+
+### `get` tool instructions:
+> "Get a single memo by ID or UID."
+
+### `delete` tool instructions:
+> "Permanently delete a memo. Cannot be undone."
+
+---
+
+## Setup
+
+### Prerequisites
+
+- Node.js >= 18
+- A running Memos instance (v0.29+)
+- A Memos access token (Settings → Access Tokens)
+
+### Quick Start — Claude Desktop/Code
+
+Add to your MCP config (`claude_desktop_config.json` or equivalent):
+
+```json
+{
+  "mcpServers": {
+    "memos": {
+      "command": "npx",
+      "args": ["-y", "memos-mcp"],
+      "env": {
+        "MEMOS_URL": "https://your-memos-instance.com",
+        "MEMOS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+### Quick Start — OpenCode
+
+Add to `opencode.json`:
+
+```json
+"mcp": {
+  "memos": {
+    "type": "remote",
+    "enabled": true,
+    "url": "http://your-server:8444/mcp",
+    "headers": {
+      "Authorization": "Bearer your-memos-access-token"
+    }
+  }
+}
+```
+
+### Quick Start — LibreChat
+
+Add to `librechat.yaml`:
+
+```yaml
+mcpServers:
+  memos:
+    type: streamable-http
+    url: http://your-server:8444/mcp
+    headers:
+      Authorization: "Bearer your-memos-access-token"
+    timeout: 240000
+```
+
+---
+
+## Running the Server
+
+### HTTP Mode (Multi-tenant)
+
+For servers that support remote MCP (OpenCode, LibreChat, etc.):
+
+```bash
+# Start with npx
+MEMOS_URL=https://your-memos-instance.com npx -y memos-mcp --http
+
+# Or with custom port
+MEMOS_URL=https://your-memos-instance.com npx -y memos-mcp --http --port 8443
+```
+
+Each client sends its own Bearer token — no token in the server config.
+
+### Stdio Mode (Single user)
+
+For Claude Desktop/Code:
+
+```bash
+MEMOS_URL=https://your-memos-instance.com MEMOS_TOKEN=your-token npx -y memos-mcp
+```
+
+### Running from Source
+
+```bash
+# 1. Clone and install
+git clone https://github.com/CesarGuzmanLopez/memos-mcp.git
+cd memos-mcp
+pnpm install
+
+# 2. Build
+pnpm build
+
+# 3. Run in stdio mode
+MEMOS_URL=https://your-memos-instance.com MEMOS_TOKEN=your-token node dist/index.js
+
+# 4. Or run in HTTP mode
+MEMOS_URL=https://your-memos-instance.com node dist/index.js --http
+```
+
+Then add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "memos": {
+      "command": "node",
+      "args": ["/path/to/memos-mcp/dist/index.js"],
+      "env": {
+        "MEMOS_URL": "https://your-memos-instance.com",
+        "MEMOS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
+```
+
+### Docker
+
+```bash
+docker run -d --name memos-mcp \
+  -p 8444:8443 \
+  -e MEMOS_URL=https://your-memos-instance.com \
+  ghcr.io/cesarguzmanlopez/memos-mcp:latest \
+  node dist/index.js --http --port 8443
+```
+
+Or with Dockerfile:
+
+```dockerfile
+FROM node:20-alpine
+WORKDIR /app
+COPY dist/ ./
+RUN npm install --omit=dev @modelcontextprotocol/sdk express zod
+EXPOSE 8443
+ENV MEMOS_URL=https://your-memos-instance.com
+CMD ["node", "dist/index.js", "--http", "--port", "8443"]
+```
+
+### Nginx Reverse Proxy (Production)
+
+```nginx
+server {
+    listen 443 ssl;
+    server_name memos-mcp.your-domain.com;
+
+    location / {
+        proxy_pass http://127.0.0.1:8444;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header Accept "application/json, text/event-stream";
+    }
+}
+```
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MEMOS_URL` | Yes | Your Memos instance URL |
+| `MEMOS_TOKEN` | Stdio only | Access token for stdio mode |
+| `HTTP_PORT` | No | HTTP server port (default: 3000) |
+| `HTTP_HOST` | No | HTTP server host (default: 127.0.0.1) |
+| `CORS_ORIGIN` | No | Allowed CORS origins (default: *) |
+| `LOG_LEVEL` | No | Log level: debug, info, warn, error (default: info) |
+
+## API Endpoints
+
+When running in HTTP mode:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/health` | GET | Health check with uptime and memory stats |
+| `/mcp` | POST | Streamable HTTP MCP endpoint |
+| `/sse` | GET | SSE connection endpoint |
+| `/sse/messages` | POST | SSE message endpoint |
+
+## Memos Compatibility
+
+| Memos Version | Compatible | Notes |
+|---------------|------------|-------|
+| **0.29.x** | ✅ Yes | Fully supported. Tested with 0.29.1 |
+| **0.28.x** | ⚠️ Partial | API works but UIDs may not be supported |
+| **0.22.x — 0.27.x** | ❌ No | Uses v1 API but without UID support |
+| **< 0.22** | ❌ No | Old API, not compatible |
+
+**Minimum required:** Memos **v0.29+** (uses UID-based identifiers `memos/abc123` instead of numeric IDs)
+
+**Tested with:** Memos **0.29.1** (neosmemo/memos:stable Docker image)
+
+**API used:** REST v1 (`/api/v1/memos`) with CEL filter expressions for queries
+
+## Important Notes
+
+- **Content limit:** Each memo has a hard limit of ~18,000 characters (server-side). The MCP enforces a safe limit of **13,000 characters**. For longer content, split into multiple memos with a shared tag.
+- **Multi-tenant:** In HTTP mode, each client sends their own Bearer token. The server uses that token to access Memos as that specific user.
+- **Rate limiting:** 100 requests per minute per IP.
+- **Tags:** Use `#hashtags` in your memo content. The MCP extracts them automatically.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+export declare class MemosClient {
+    readonly baseUrl: string;
+    private token;
+    private _currentUser;
+    constructor(baseUrl: string, token: string);
+    validateToken(): Promise<boolean>;
+    getCurrentUser(): Promise<string>;
+    private headers;
+    private fetchWithTimeout;
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    patch<T>(path: string, body?: unknown, params?: Record<string, string>): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAiBA,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAuB;gBAE/B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAMpC,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAUjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IA0BvC,OAAO,CAAC,OAAO;YAQD,gBAAgB;IAuBxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBjE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAejD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBnF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAcpD"}

package/dist/client.js

@@ -0,0 +1,155 @@
+// Cache a nivel de módulo para el usuario actual por combinación baseUrl+token
+const userCache = new Map();
+const USER_CACHE_TTL_MS = 300_000; // 5 minutos
+// Sweep periódico del cache de usuarios
+setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of userCache) {
+        if (now - entry.timestamp > USER_CACHE_TTL_MS) {
+            userCache.delete(key);
+        }
+    }
+}, 60_000); // Cada minuto
+// Timeout para requests a Memos API (configurable via MEMOS_FETCH_TIMEOUT, default 120s)
+const FETCH_TIMEOUT_MS = parseInt(process.env.MEMOS_FETCH_TIMEOUT || "120000", 10);
+export class MemosClient {
+    baseUrl;
+    token;
+    _currentUser = null;
+    constructor(baseUrl, token) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.token = token;
+    }
+    // Validate token is working
+    async validateToken() {
+        try {
+            await this.getCurrentUser();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Obtener usuario actual con cache global
+    async getCurrentUser() {
+        if (this._currentUser)
+            return this._currentUser;
+        const cacheKey = `${this.baseUrl}:${this.token}`;
+        const cached = userCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < USER_CACHE_TTL_MS) {
+            this._currentUser = cached.user;
+            return this._currentUser;
+        }
+        const result = await this.get("/api/v1/memos", { pageSize: "1" });
+        if (result.memos && result.memos.length > 0) {
+            this._currentUser = result.memos[0].creator;
+            userCache.set(cacheKey, { user: this._currentUser, timestamp: Date.now() });
+        }
+        if (!this._currentUser) {
+            throw new Error("Could not determine current user. No memos found with this token.");
+        }
+        return this._currentUser;
+    }
+    headers() {
+        return {
+            Authorization: `Bearer ${this.token}`,
+            "Content-Type": "application/json",
+        };
+    }
+    // Helper para fetch con timeout
+    async fetchWithTimeout(url, options) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new Error(`Request to ${url} timed out after ${FETCH_TIMEOUT_MS}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async get(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const res = await this.fetchWithTimeout(url.toString(), {
+            headers: this.headers(),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`GET ${path} failed (${res.status}): ${body}`);
+        }
+        const text = await res.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    async post(path, body) {
+        const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`POST ${path} failed (${res.status}): ${text}`);
+        }
+        const text = await res.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    async patch(path, body, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const res = await this.fetchWithTimeout(url.toString(), {
+            method: "PATCH",
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`PATCH ${path} failed (${res.status}): ${text}`);
+        }
+        const text = await res.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    async delete(path) {
+        const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {
+            method: "DELETE",
+            headers: this.headers(),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`DELETE ${path} failed (${res.status}): ${text}`);
+        }
+        // Memos DELETE may return empty body
+        const text = await res.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+declare const EnvSchema: z.ZodObject<{
+    MEMOS_URL: z.ZodString;
+    HTTP_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    HTTP_HOST: z.ZodDefault<z.ZodString>;
+    CORS_ORIGIN: z.ZodDefault<z.ZodString>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof EnvSchema>;
+export declare function loadConfig(): Config;
+export declare function getCorsOrigins(config: Config): string[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,SAAS;;;;;;;;;;;iBAab,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAG/C,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD"}

package/dist/config.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+// Schema de validación para variables de entorno
+const EnvSchema = z.object({
+    // Memos connection (required)
+    MEMOS_URL: z.string().url().describe("Memos instance URL"),
+    // HTTP server options
+    HTTP_PORT: z.coerce.number().int().min(1).max(65535).default(3000).describe("HTTP server port"),
+    HTTP_HOST: z.string().default("127.0.0.1").describe("HTTP server host"),
+    // Security
+    CORS_ORIGIN: z.string().default("*").describe("CORS allowed origins (comma-separated)"),
+    // Logging
+    LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info").describe("Log level"),
+});
+// Cargar configuración desde variables de entorno
+export function loadConfig() {
+    const result = EnvSchema.safeParse(process.env);
+    if (!result.success) {
+        console.error("Configuration error:", result.error.flatten().fieldErrors);
+        process.exit(1);
+    }
+    return result.data;
+}
+// Obtener orígenes CORS como array
+export function getCorsOrigins(config) {
+    return config.CORS_ORIGIN.split(",").map((o) => o.trim());
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AACjD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,8BAA8B;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAE1D,sBAAsB;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC/F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAEvE,WAAW;IACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAEvF,UAAU;IACV,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;CAC5F,CAAC,CAAC;AAIH,kDAAkD;AAClD,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,4 @@
+import { Config } from "./config.js";
+export declare function createHttpApp(config: Config): import("express-serve-static-core").Express;
+export declare function startHttpServer(config: Config): import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAgFrD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,+CAgP3C;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,qHA4C7C"}