@lesgo/memory-mcp 1.0.0

package/README.md

@@ -0,0 +1,128 @@
+# memory-mcp
+
+Personal External Brain MCP Server - A stateless MCP server for syncing templates, standards, and knowledge via GitHub.
+
+## Features
+
+- **Zero-latency reads**: In-memory cache for instant access to templates and standards
+- **Non-blocking writes**: Async GitHub sync with local queue for resilience  
+- **Auto-categorization**: Files organized by category (templates, standards, knowledge, etc.)
+- **Full-text search**: Search across file paths and content
+
+## Installation
+
+### VS Code / Copilot
+
+Add to your `~/.vscode/mcp.json` or VS Code settings:
+
+```json
+{
+  "servers": {
+    "memory-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "memory-mcp"],
+      "env": {
+        "MEMORY_MCP_REPO": "your-username/memory-mcp-storage",
+        "MEMORY_MCP_TOKEN": "ghp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "memory-mcp": {
+      "command": "npx",
+      "args": ["-y", "memory-mcp"],
+      "env": {
+        "MEMORY_MCP_REPO": "your-username/memory-mcp-storage",
+        "MEMORY_MCP_TOKEN": "ghp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MEMORY_MCP_REPO` | Yes | GitHub repository in `owner/repo` format |
+| `MEMORY_MCP_TOKEN` | Yes | GitHub Personal Access Token with `repo` scope |
+
+## Tools
+
+### `list_knowledge`
+List all available memory files organized by category.
+
+### `read_memory`
+Read the content of a specific memory file.
+```json
+{ "path": "templates/user-story.md" }
+```
+
+### `save_memory`
+Create or update a memory file. Category folders are auto-created.
+```json
+{ "category": "templates", "name": "user-story.md", "content": "..." }
+```
+
+### `delete_memory`
+Delete a memory file.
+```json
+{ "path": "templates/old-template.md" }
+```
+
+### `search_memory`
+Search across all memory files by keyword.
+```json
+{ "query": "graphql error" }
+```
+
+## Storage Repository Structure
+
+Create a private GitHub repository (e.g., `memory-mcp-storage`) with this structure:
+
+```
+/
+├── index.json             # Auto-generated manifest
+├── templates/             # Markdown templates
+│   ├── user-story.md
+│   └── pull-request.md
+├── standards/             # Technical rules (YAML/JSON)
+│   ├── typescript.yaml
+│   └── graphql.yaml
+└── knowledge/             # Long-form context
+    └── architecture.md
+```
+
+## How It Works
+
+1. **Startup**: Fetches all files from GitHub, populates in-memory cache
+2. **Reads**: Cache-first (instant), falls back to GitHub API on miss
+3. **Writes**: Updates cache immediately, returns to agent, syncs GitHub async
+4. **Failures**: Failed writes queue to `~/.memory-mcp-queue.json` and retry on next operation
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+MIT

package/dist/cache.d.ts

@@ -0,0 +1,62 @@
+export interface CacheEntry {
+    content: string;
+    sha: string;
+}
+export interface SearchResult {
+    path: string;
+    snippet: string;
+}
+/**
+ * In-memory cache for fast reads
+ * Cache is populated on startup and updated optimistically on writes
+ */
+export declare class MemoryCache {
+    private cache;
+    /**
+     * Get a cached entry
+     */
+    get(path: string): CacheEntry | undefined;
+    /**
+     * Set a cache entry
+     */
+    set(path: string, content: string, sha: string): void;
+    /**
+     * Delete a cache entry
+     */
+    delete(path: string): boolean;
+    /**
+     * Check if path exists in cache
+     */
+    has(path: string): boolean;
+    /**
+     * Get all cached paths
+     */
+    keys(): string[];
+    /**
+     * Get all entries
+     */
+    entries(): Array<[string, CacheEntry]>;
+    /**
+     * Get unique categories (top-level folders)
+     */
+    categories(): string[];
+    /**
+     * Search across paths and content
+     * Returns matching paths with content snippets
+     */
+    search(query: string): SearchResult[];
+    /**
+     * Extract a snippet around the match
+     */
+    private extractSnippet;
+    /**
+     * Clear the entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+}
+export declare const cache: MemoryCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAsC;IAEnD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAUzC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKrD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ7B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAItC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAWtB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IA6BrC;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAGD,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/cache.js

@@ -0,0 +1,141 @@
+import { log } from './logger.js';
+/**
+ * In-memory cache for fast reads
+ * Cache is populated on startup and updated optimistically on writes
+ */
+export class MemoryCache {
+    cache = new Map();
+    /**
+     * Get a cached entry
+     */
+    get(path) {
+        const entry = this.cache.get(path);
+        if (entry) {
+            log('cache', `HIT: ${path}`);
+        }
+        else {
+            log('cache', `MISS: ${path}`);
+        }
+        return entry;
+    }
+    /**
+     * Set a cache entry
+     */
+    set(path, content, sha) {
+        this.cache.set(path, { content, sha });
+        log('cache', `SET: ${path}`);
+    }
+    /**
+     * Delete a cache entry
+     */
+    delete(path) {
+        const deleted = this.cache.delete(path);
+        if (deleted) {
+            log('cache', `DELETE: ${path}`);
+        }
+        return deleted;
+    }
+    /**
+     * Check if path exists in cache
+     */
+    has(path) {
+        return this.cache.has(path);
+    }
+    /**
+     * Get all cached paths
+     */
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+    /**
+     * Get all entries
+     */
+    entries() {
+        return Array.from(this.cache.entries());
+    }
+    /**
+     * Get unique categories (top-level folders)
+     */
+    categories() {
+        const categories = new Set();
+        for (const path of this.cache.keys()) {
+            const parts = path.split('/');
+            if (parts.length > 1) {
+                categories.add(parts[0]);
+            }
+        }
+        return Array.from(categories).sort();
+    }
+    /**
+     * Search across paths and content
+     * Returns matching paths with content snippets
+     */
+    search(query) {
+        const results = [];
+        const queryLower = query.toLowerCase();
+        for (const [path, entry] of this.cache.entries()) {
+            // Check path match
+            if (path.toLowerCase().includes(queryLower)) {
+                results.push({
+                    path,
+                    snippet: this.extractSnippet(entry.content, query),
+                });
+                continue;
+            }
+            // Check content match
+            const contentLower = entry.content.toLowerCase();
+            const matchIndex = contentLower.indexOf(queryLower);
+            if (matchIndex !== -1) {
+                results.push({
+                    path,
+                    snippet: this.extractSnippet(entry.content, query, matchIndex),
+                });
+            }
+        }
+        log('cache', `SEARCH: "${query}" found ${results.length} results`);
+        return results;
+    }
+    /**
+     * Extract a snippet around the match
+     */
+    extractSnippet(content, query, matchIndex) {
+        const maxLength = 150;
+        if (content.length <= maxLength) {
+            return content;
+        }
+        if (matchIndex === undefined) {
+            const contentLower = content.toLowerCase();
+            matchIndex = contentLower.indexOf(query.toLowerCase());
+        }
+        if (matchIndex === -1) {
+            return content.slice(0, maxLength) + '...';
+        }
+        // Calculate start and end positions centered around the match
+        const snippetStart = Math.max(0, matchIndex - 50);
+        const snippetEnd = Math.min(content.length, matchIndex + query.length + 100);
+        let snippet = content.slice(snippetStart, snippetEnd);
+        if (snippetStart > 0) {
+            snippet = '...' + snippet;
+        }
+        if (snippetEnd < content.length) {
+            snippet = snippet + '...';
+        }
+        return snippet;
+    }
+    /**
+     * Clear the entire cache
+     */
+    clear() {
+        this.cache.clear();
+        log('cache', 'CLEARED');
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+}
+// Global cache instance
+export const cache = new MemoryCache();
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,39 @@
+export interface GitHubFile {
+    path: string;
+    content: string;
+    sha: string;
+}
+export interface GitHubConfig {
+    token: string;
+    repo: string;
+}
+export declare class GitHubClient {
+    private octokit;
+    private owner;
+    private repo;
+    constructor(config: GitHubConfig);
+    /**
+     * List all files in the repository
+     */
+    listTree(): Promise<Array<{
+        path: string;
+        sha: string;
+    }>>;
+    /**
+     * Get file content by path
+     */
+    getFile(path: string): Promise<GitHubFile | null>;
+    /**
+     * Create or update a file
+     */
+    putFile(path: string, content: string, sha?: string): Promise<string>;
+    /**
+     * Delete a file
+     */
+    deleteFile(path: string, sha: string): Promise<void>;
+    /**
+     * Check if repository exists and is accessible
+     */
+    validateAccess(): Promise<boolean>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;gBAET,MAAM,EAAE,YAAY;IAUhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAgC/D;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA4BvD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3E;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAWzC"}

package/dist/github.js

@@ -0,0 +1,120 @@
+import { Octokit } from '@octokit/rest';
+import { log } from './logger.js';
+export class GitHubClient {
+    octokit;
+    owner;
+    repo;
+    constructor(config) {
+        const [owner, repo] = config.repo.split('/');
+        if (!owner || !repo) {
+            throw new Error(`Invalid repo format: "${config.repo}". Expected "owner/repo".`);
+        }
+        this.owner = owner;
+        this.repo = repo;
+        this.octokit = new Octokit({ auth: config.token });
+    }
+    /**
+     * List all files in the repository
+     */
+    async listTree() {
+        log('github', `Fetching tree for ${this.owner}/${this.repo}`);
+        try {
+            // Get the default branch
+            const { data: repoData } = await this.octokit.repos.get({
+                owner: this.owner,
+                repo: this.repo,
+            });
+            const defaultBranch = repoData.default_branch;
+            // Get the tree recursively
+            const { data: treeData } = await this.octokit.git.getTree({
+                owner: this.owner,
+                repo: this.repo,
+                tree_sha: defaultBranch,
+                recursive: 'true',
+            });
+            return treeData.tree
+                .filter((item) => item.type === 'blob' && item.path && item.sha)
+                .map((item) => ({ path: item.path, sha: item.sha }));
+        }
+        catch (error) {
+            if (error instanceof Error && 'status' in error && (error.status === 404 || error.status === 409)) {
+                log('github', 'Repository is empty or not found, returning empty tree');
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get file content by path
+     */
+    async getFile(path) {
+        log('github', `Fetching file: ${path}`);
+        try {
+            const { data } = await this.octokit.repos.getContent({
+                owner: this.owner,
+                repo: this.repo,
+                path,
+            });
+            if (Array.isArray(data) || data.type !== 'file') {
+                return null;
+            }
+            const content = Buffer.from(data.content, 'base64').toString('utf-8');
+            return {
+                path,
+                content,
+                sha: data.sha,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && 'status' in error && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Create or update a file
+     */
+    async putFile(path, content, sha) {
+        log('github', `${sha ? 'Updating' : 'Creating'} file: ${path}`);
+        const message = sha ? `Update ${path}` : `Create ${path}`;
+        const { data } = await this.octokit.repos.createOrUpdateFileContents({
+            owner: this.owner,
+            repo: this.repo,
+            path,
+            message,
+            content: Buffer.from(content).toString('base64'),
+            sha,
+        });
+        return data.content?.sha ?? '';
+    }
+    /**
+     * Delete a file
+     */
+    async deleteFile(path, sha) {
+        log('github', `Deleting file: ${path}`);
+        await this.octokit.repos.deleteFile({
+            owner: this.owner,
+            repo: this.repo,
+            path,
+            message: `Delete ${path}`,
+            sha,
+        });
+    }
+    /**
+     * Check if repository exists and is accessible
+     */
+    async validateAccess() {
+        try {
+            await this.octokit.repos.get({
+                owner: this.owner,
+                repo: this.repo,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

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

package/dist/index-gen.d.ts

@@ -0,0 +1,19 @@
+import { GitHubClient } from './github.js';
+import { MemoryCache } from './cache.js';
+export interface IndexFile {
+    categories: string[];
+    files: Array<{
+        path: string;
+        category: string;
+    }>;
+    lastUpdated: string;
+}
+/**
+ * Generate and update index.json based on cache contents
+ */
+export declare function updateIndex(github: GitHubClient, cache: MemoryCache): Promise<void>;
+/**
+ * Parse index.json content
+ */
+export declare function parseIndex(content: string): IndexFile;
+//# sourceMappingURL=index-gen.d.ts.map

package/dist/index-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-gen.d.ts","sourceRoot":"","sources":["../src/index-gen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCzF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAErD"}

package/dist/index-gen.js

@@ -0,0 +1,41 @@
+import { log } from './logger.js';
+const INDEX_PATH = 'index.json';
+/**
+ * Generate and update index.json based on cache contents
+ */
+export async function updateIndex(github, cache) {
+    log('writer', 'Regenerating index.json');
+    const files = cache.keys()
+        .filter((path) => path !== INDEX_PATH)
+        .map((path) => {
+        const parts = path.split('/');
+        const category = parts.length > 1 ? parts[0] : 'root';
+        return { path, category };
+    })
+        .sort((a, b) => a.path.localeCompare(b.path));
+    const categories = [...new Set(files.map((f) => f.category))].sort();
+    const index = {
+        categories,
+        files,
+        lastUpdated: new Date().toISOString(),
+    };
+    const content = JSON.stringify(index, null, 2);
+    // Get existing SHA for index.json
+    const existingIndex = cache.get(INDEX_PATH);
+    try {
+        const newSha = await github.putFile(INDEX_PATH, content, existingIndex?.sha);
+        cache.set(INDEX_PATH, content, newSha);
+        log('writer', `Index updated with ${files.length} files in ${categories.length} categories`);
+    }
+    catch (error) {
+        log('writer', `Failed to update index: ${error}`);
+        throw error;
+    }
+}
+/**
+ * Parse index.json content
+ */
+export function parseIndex(content) {
+    return JSON.parse(content);
+}
+//# sourceMappingURL=index-gen.js.map

package/dist/index-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-gen.js","sourceRoot":"","sources":["../src/index-gen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAQlC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB,EAAE,KAAkB;IACxE,GAAG,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE;SACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAErE,MAAM,KAAK,GAAc;QACvB,UAAU;QACV,KAAK;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/C,kCAAkC;IAClC,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAC7E,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,GAAG,CAAC,QAAQ,EAAE,sBAAsB,KAAK,CAAC,MAAM,aAAa,UAAU,CAAC,MAAM,aAAa,CAAC,CAAC;IAC/F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,QAAQ,EAAE,2BAA2B,KAAK,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;AAC1C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}