memorandum-mcp 0.1.0

package/dist/embedder.js

@@ -0,0 +1,152 @@
+import { existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Manages loading and running a HuggingFace feature-extraction model
+ * to produce vector embeddings from text.
+ */
+export class Embedder {
+    static MAX_INPUT_CHARS = 2000;
+    modelId;
+    dtype;
+    logger;
+    pipeline = null;
+    loading = null;
+    unavailable = false;
+    failureReason = null;
+    /**
+     * @param modelId - HuggingFace model identifier (e.g. "intfloat/multilingual-e5-small").
+     * @param dtype - Data type for the model weights (e.g. "fp32", "q8").
+     * @param logger - Pino logger instance.
+     */
+    constructor(modelId, dtype, logger) {
+        this.modelId = modelId;
+        this.dtype = dtype;
+        this.logger = logger;
+    }
+    /** Whether the embedding pipeline has been successfully loaded. */
+    get isLoaded() { return this.pipeline != null; }
+    /** Whether the embedding pipeline is currently being loaded. */
+    get isLoading() { return this.loading != null; }
+    /** Whether the model failed to load and is permanently unavailable. */
+    get isUnavailable() { return this.unavailable; }
+    /** The error message explaining why the model is unavailable, or null. */
+    get unavailableReason() { return this.failureReason; }
+    /**
+     * Resets internal state, loads the pipeline, and retries after clearing
+     * the model cache if a corrupted-cache error is detected.
+     */
+    async repairAndLoad() {
+        this.pipeline = null;
+        this.loading = null;
+        this.unavailable = false;
+        this.failureReason = null;
+        try {
+            await this.getPipeline();
+        }
+        catch (err) {
+            if (!this.isCorruptedCacheError(err))
+                throw err;
+            this.logger.warn({ model: this.modelId, error: err instanceof Error ? err.message : String(err) }, 'Corrupted model cache detected, deleting cache and retrying');
+            await this.deleteModelCache();
+            this.pipeline = null;
+            this.loading = null;
+            this.unavailable = false;
+            this.failureReason = null;
+            await this.getPipeline();
+        }
+    }
+    /**
+     * Embeds a search query, applying E5 "query:" prefix when applicable.
+     * @param text - The query text to embed.
+     * @returns The embedding vector.
+     */
+    async embedQuery(text) {
+        return this.embed(this.formatQuery(text));
+    }
+    /**
+     * Embeds a passage of text, applying E5 "passage:" prefix when applicable.
+     * @param text - The passage text to embed.
+     * @returns The embedding vector.
+     */
+    async embedPassage(text) {
+        return this.embed(this.formatPassage(text));
+    }
+    get isE5Model() {
+        return this.modelId.toLowerCase().includes('e5');
+    }
+    formatQuery(text) {
+        return this.isE5Model ? `query: ${text}` : text;
+    }
+    formatPassage(text) {
+        return this.isE5Model ? `passage: ${text}` : text;
+    }
+    truncateText(text) {
+        if (text.length <= Embedder.MAX_INPUT_CHARS)
+            return text;
+        return text.slice(0, Embedder.MAX_INPUT_CHARS);
+    }
+    async embed(text) {
+        const pipe = await this.getPipeline();
+        const truncated = this.truncateText(text);
+        const output = await pipe(truncated, { pooling: 'mean', normalize: true });
+        return output.tolist()[0];
+    }
+    async getPipeline() {
+        if (this.pipeline)
+            return this.pipeline;
+        if (this.unavailable)
+            throw new Error('Embedding model is unavailable');
+        if (this.loading)
+            return this.loading;
+        this.loading = this.initPipeline();
+        try {
+            this.pipeline = await this.loading;
+            return this.pipeline;
+        }
+        catch (err) {
+            this.failureReason = err instanceof Error ? err.message : String(err);
+            this.unavailable = true;
+            this.logger.error({ model: this.modelId, error: this.failureReason }, 'Embedding model failed to load');
+            throw err;
+        }
+        finally {
+            this.loading = null;
+        }
+    }
+    isCorruptedCacheError(err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return msg.includes('Protobuf parsing failed') || msg.includes('invalid model');
+    }
+    async deleteModelCache() {
+        try {
+            const { env } = await import('@huggingface/transformers');
+            const cacheBase = String(env.cacheDir || '');
+            if (!cacheBase)
+                return;
+            const modelCacheDir = join(cacheBase, this.modelId);
+            if (existsSync(modelCacheDir)) {
+                rmSync(modelCacheDir, { recursive: true, force: true });
+                this.logger.info({ path: modelCacheDir }, 'Deleted corrupted model cache');
+            }
+        }
+        catch (deleteErr) {
+            this.logger.warn({ error: deleteErr instanceof Error ? deleteErr.message : String(deleteErr) }, 'Failed to delete model cache');
+        }
+    }
+    async initPipeline() {
+        const { pipeline, env } = await import('@huggingface/transformers');
+        env.allowRemoteModels = true;
+        const extractor = await pipeline('feature-extraction', this.modelId, {
+            dtype: this.dtype,
+            device: 'cpu',
+            progress_callback: (progress) => {
+                if (progress.status === 'downloading' && progress.file) {
+                    this.logger.info({ file: progress.file, progress: progress.progress?.toFixed(1) }, 'Downloading embedding model');
+                }
+            },
+        });
+        this.logger.info({ model: this.modelId, dtype: this.dtype }, 'Embedding model loaded');
+        return extractor;
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

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

package/dist/embedding-queue.d.ts

@@ -0,0 +1,66 @@
+import type { Logger } from 'pino';
+import type { Embedder } from './embedder.js';
+import type { VectorStore } from './vector-store.js';
+import type { EmbeddingQueueItem } from './semantic-types.js';
+/** Configuration options for the embedding queue. */
+export interface EmbeddingQueueConfig {
+    /** Delay in milliseconds before processing a batch after the last enqueue. */
+    debounceMs: number;
+    /** Maximum number of pending items before a batch is triggered immediately. */
+    maxQueueSize: number;
+    /** Maximum retry attempts before marking an embedding as permanently failed. */
+    maxRetries: number;
+}
+/** Summary of a completed embedding batch. */
+export interface BatchResult {
+    /** Number of items successfully embedded and stored. */
+    succeeded: number;
+    /** Number of items that failed during embedding. */
+    failed: number;
+    /** Number of items skipped (discarded or permanently failed). */
+    skipped: number;
+    /** Wall-clock time of the batch in milliseconds. */
+    durationMs: number;
+}
+/**
+ * Debounced queue that batches embedding requests and processes them
+ * sequentially through the Embedder, persisting results to the VectorStore.
+ */
+export declare class EmbeddingQueue {
+    private readonly embedder;
+    private readonly vectorStore;
+    private readonly logger;
+    private readonly config;
+    private pending;
+    private processingIds;
+    private discardedIds;
+    private timer;
+    private processing;
+    private processingPromise;
+    constructor(embedder: Embedder, vectorStore: VectorStore, logger: Logger, config: EmbeddingQueueConfig);
+    /**
+     * Adds an item to the queue. Triggers an immediate batch if the queue
+     * reaches maxQueueSize, otherwise resets the debounce timer.
+     * @param item - The item to enqueue for embedding.
+     */
+    enqueue(item: EmbeddingQueueItem): void;
+    /**
+     * Removes an item from the pending queue. If the item is currently being
+     * processed, marks it as discarded so its result will be ignored.
+     * @param id - The identifier of the item to remove.
+     */
+    dequeue(id: string): void;
+    /**
+     * Processes all pending items immediately, waiting for any in-flight
+     * batch to complete first.
+     * @returns The result of the flushed batch.
+     */
+    flush(): Promise<BatchResult>;
+    /** Cancels any pending timer and clears the queue. */
+    dispose(): void;
+    private resetTimer;
+    private cancelTimer;
+    private triggerBatch;
+    private waitForProcessing;
+    private processBatch;
+}

package/dist/embedding-queue.js

@@ -0,0 +1,152 @@
+/**
+ * Debounced queue that batches embedding requests and processes them
+ * sequentially through the Embedder, persisting results to the VectorStore.
+ */
+export class EmbeddingQueue {
+    embedder;
+    vectorStore;
+    logger;
+    config;
+    pending = new Map();
+    processingIds = new Set();
+    discardedIds = new Set();
+    timer = null;
+    processing = false;
+    processingPromise = null;
+    constructor(embedder, vectorStore, logger, config) {
+        this.embedder = embedder;
+        this.vectorStore = vectorStore;
+        this.logger = logger;
+        this.config = config;
+    }
+    /**
+     * Adds an item to the queue. Triggers an immediate batch if the queue
+     * reaches maxQueueSize, otherwise resets the debounce timer.
+     * @param item - The item to enqueue for embedding.
+     */
+    enqueue(item) {
+        this.pending.set(item.id, item);
+        this.vectorStore.clearFailure(item.id);
+        if (this.pending.size >= this.config.maxQueueSize) {
+            this.cancelTimer();
+            this.triggerBatch();
+            return;
+        }
+        this.resetTimer();
+    }
+    /**
+     * Removes an item from the pending queue. If the item is currently being
+     * processed, marks it as discarded so its result will be ignored.
+     * @param id - The identifier of the item to remove.
+     */
+    dequeue(id) {
+        this.pending.delete(id);
+        if (this.processingIds.has(id))
+            this.discardedIds.add(id);
+        this.vectorStore.clearFailure(id);
+    }
+    /**
+     * Processes all pending items immediately, waiting for any in-flight
+     * batch to complete first.
+     * @returns The result of the flushed batch.
+     */
+    async flush() {
+        this.cancelTimer();
+        if (this.pending.size === 0 && !this.processing) {
+            return { succeeded: 0, failed: 0, skipped: 0, durationMs: 0 };
+        }
+        if (this.processing)
+            await this.waitForProcessing();
+        if (this.pending.size === 0) {
+            return { succeeded: 0, failed: 0, skipped: 0, durationMs: 0 };
+        }
+        return this.processBatch();
+    }
+    /** Cancels any pending timer and clears the queue. */
+    dispose() {
+        this.cancelTimer();
+        this.pending.clear();
+    }
+    resetTimer() {
+        this.cancelTimer();
+        const delay = this.config.debounceMs === 0 ? 0 : this.config.debounceMs;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.triggerBatch();
+        }, delay);
+        this.timer.unref();
+    }
+    cancelTimer() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    triggerBatch() {
+        if (this.processing || this.pending.size === 0)
+            return;
+        this.processBatch().catch((err) => {
+            this.logger.error({ error: err instanceof Error ? err.message : String(err) }, 'Batch processing failed');
+        });
+    }
+    async waitForProcessing() {
+        if (this.processingPromise)
+            await this.processingPromise;
+    }
+    async processBatch() {
+        const start = Date.now();
+        this.processing = true;
+        const batch = new Map(this.pending);
+        this.pending.clear();
+        this.processingIds = new Set(batch.keys());
+        this.discardedIds.clear();
+        let succeeded = 0, failed = 0, skipped = 0;
+        const processPromise = (async () => {
+            for (const [id, item] of batch) {
+                const failureRecord = this.vectorStore.getFailedEmbeddings()[id];
+                if (failureRecord && failureRecord.status === 'failed') {
+                    skipped++;
+                    continue;
+                }
+                try {
+                    const vector = await this.embedder.embedPassage(item.textToEmbed);
+                    if (this.discardedIds.has(id)) {
+                        skipped++;
+                        continue;
+                    }
+                    const entry = {
+                        id, vector, source: item.source,
+                        metadata: item.metadata, indexedAt: Date.now(),
+                    };
+                    this.vectorStore.upsert(entry);
+                    this.vectorStore.clearFailure(id);
+                    succeeded++;
+                }
+                catch (err) {
+                    const errorMsg = err instanceof Error ? err.message : String(err);
+                    this.vectorStore.recordFailure(id, errorMsg, this.config.maxRetries);
+                    failed++;
+                    this.logger.warn({ id, error: errorMsg }, 'Embedding failed for item');
+                }
+            }
+            if (succeeded > 0 || failed > 0)
+                await this.vectorStore.save();
+        })();
+        this.processingPromise = processPromise;
+        try {
+            await processPromise;
+        }
+        finally {
+            this.processing = false;
+            this.processingIds.clear();
+            this.discardedIds.clear();
+            this.processingPromise = null;
+        }
+        const durationMs = Date.now() - start;
+        this.logger.info({ succeeded, failed, skipped, durationMs, remaining: this.pending.size }, 'Embedding batch completed');
+        if (this.pending.size > 0)
+            this.resetTimer();
+        return { succeeded, failed, skipped, durationMs };
+    }
+}
+//# sourceMappingURL=embedding-queue.js.map

package/dist/embedding-queue.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Custom error types for Memorandum MCP server.
+ */
+/** Base error class for all Memorandum domain errors. */
+export declare class MemorandumError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    /**
+     * @param code - Machine-readable error code (e.g. "not_found").
+     * @param message - Human-readable error description.
+     * @param details - Optional structured metadata about the error.
+     */
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+    /** Serialize this error into an MCP-compatible plain object. */
+    toMcpError(): Record<string, unknown>;
+}
+/**
+ * Convert an error to an MCP-compatible error response.
+ */
+export declare function toMcpErrorResponse(error: unknown): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};

package/dist/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Custom error types for Memorandum MCP server.
+ */
+/** Base error class for all Memorandum domain errors. */
+export class MemorandumError extends Error {
+    code;
+    details;
+    /**
+     * @param code - Machine-readable error code (e.g. "not_found").
+     * @param message - Human-readable error description.
+     * @param details - Optional structured metadata about the error.
+     */
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'MemorandumError';
+        this.code = code;
+        this.details = details;
+    }
+    /** Serialize this error into an MCP-compatible plain object. */
+    toMcpError() {
+        return {
+            error: this.code,
+            message: this.message,
+            ...(this.details ? { details: this.details } : {}),
+        };
+    }
+}
+/**
+ * Convert an error to an MCP-compatible error response.
+ */
+export function toMcpErrorResponse(error) {
+    if (error instanceof MemorandumError) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify(error.toMcpError()) }],
+            isError: true,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: 'internal_error', message: error.message }) }],
+            isError: true,
+        };
+    }
+    throw error;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C;;;;OAIG;IACH,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiC;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,gEAAgE;IAChE,UAAU;QACR,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAI/C,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC/G,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Memorandum — MCP server with persistent memory.
+ *
+ * Two memory types:
+ * - Facts: short key-value records with LRU expiration
+ * - Documents: structured storage with metadata and semantic search
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * Memorandum — MCP server with persistent memory.
+ *
+ * Two memory types:
+ * - Facts: short key-value records with LRU expiration
+ * - Documents: structured storage with metadata and semantic search
+ */
+import { createRequire } from 'node:module';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config.js';
+import { createLogger } from './logger.js';
+import { MemoryStore } from './store.js';
+import { DocumentStore } from './document-store.js';
+import { VectorStore } from './vector-store.js';
+import { Embedder } from './embedder.js';
+import { SemanticIndex } from './semantic-index.js';
+import { EmbeddingQueue } from './embedding-queue.js';
+import { registerMemoryTools } from './tools.js';
+import { registerDocumentTools } from './document-tools.js';
+import { registerSemanticTools } from './semantic-tools.js';
+const _require = createRequire(import.meta.url);
+const { version } = _require('../package.json');
+/**
+ * Ensure .memorandum/.gitignore exists with cache/ exclusion.
+ */
+function ensureGitignore(storageDir) {
+    const gitignorePath = join(storageDir, '.gitignore');
+    const cacheEntry = 'cache/';
+    if (!existsSync(storageDir)) {
+        mkdirSync(storageDir, { recursive: true });
+    }
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, `${cacheEntry}\n`, 'utf-8');
+        return;
+    }
+    const content = readFileSync(gitignorePath, 'utf-8');
+    if (!content.includes(cacheEntry)) {
+        writeFileSync(gitignorePath, `${content.trimEnd()}\n${cacheEntry}\n`, 'utf-8');
+    }
+}
+async function main() {
+    const storageDir = process.env.MEMORANDUM_STORAGE_DIR || '.memorandum';
+    const logLevel = process.env.MEMORANDUM_LOG_LEVEL || 'info';
+    const logger = createLogger(logLevel);
+    const { config, paths } = loadConfig(storageDir);
+    logger.info({ version, storageDir: paths.storageDir }, 'Memorandum starting');
+    // Ensure storage directories
+    if (!existsSync(paths.storageDir))
+        mkdirSync(paths.storageDir, { recursive: true });
+    const factsDir = dirname(paths.factsPath);
+    if (!existsSync(factsDir))
+        mkdirSync(factsDir, { recursive: true });
+    // Initialize MCP server
+    const server = new McpServer({
+        name: 'memorandum',
+        version,
+    });
+    // Initialize stores
+    const store = new MemoryStore(config, paths, logger);
+    await store.load();
+    const documentStore = new DocumentStore(config, paths, logger);
+    documentStore.loadIndex();
+    // Component references for teardown
+    let vectorStore;
+    let semanticIndex;
+    let embeddingQueue;
+    // Sync callback
+    const syncFn = async () => {
+        const savedStores = [];
+        let flushedEmbeddings = 0;
+        if (embeddingQueue) {
+            const result = await embeddingQueue.flush();
+            flushedEmbeddings = result.succeeded;
+        }
+        if (vectorStore) {
+            const written = await vectorStore.save();
+            if (written)
+                savedStores.push('vectors');
+        }
+        const docsWritten = documentStore.saveIndex();
+        if (docsWritten)
+            savedStores.push('documents');
+        const factsWritten = await store.save();
+        if (factsWritten)
+            savedStores.push('facts');
+        return { flushed_embeddings: flushedEmbeddings, saved_stores: savedStores };
+    };
+    // Register fact tools
+    registerMemoryTools(server, store, logger, syncFn);
+    // Register document tools
+    registerDocumentTools(server, documentStore, logger);
+    // Semantic search initialization
+    if (config.semantic_enabled) {
+        const embedder = new Embedder(config.semantic_model, config.semantic_model_dtype, logger);
+        const indexPath = join(paths.cachePath, 'vector-index.json');
+        const dimensions = 384; // e5-small default
+        vectorStore = new VectorStore(indexPath, config.semantic_model, dimensions, logger);
+        semanticIndex = new SemanticIndex(embedder, vectorStore, logger);
+        await semanticIndex.initialize();
+        semanticIndex.setMemoryStore(store);
+        semanticIndex.setDocumentStore(documentStore);
+        await semanticIndex.pruneOrphans();
+        embeddingQueue = new EmbeddingQueue(embedder, vectorStore, logger, {
+            debounceMs: config.semantic_debounce_seconds * 1000,
+            maxQueueSize: config.semantic_max_queue_size,
+            maxRetries: config.semantic_max_retries,
+        });
+        semanticIndex.setEmbeddingQueue(embeddingQueue);
+        semanticIndex.enqueueMissing();
+        documentStore.setSemanticIndex(semanticIndex);
+        store.setSemanticIndex(semanticIndex);
+        registerSemanticTools(server, semanticIndex, logger);
+        ensureGitignore(paths.storageDir);
+    }
+    // Start autosave
+    const intervalMs = config.autosave_interval_seconds * 1000;
+    store.startAutosave(intervalMs);
+    // Graceful shutdown
+    const teardown = async () => {
+        logger.info('Shutting down...');
+        if (embeddingQueue) {
+            await embeddingQueue.flush();
+            embeddingQueue.dispose();
+        }
+        if (vectorStore)
+            await vectorStore.save();
+        documentStore.saveIndex();
+        store.stopAutosave();
+        await store.save();
+        logger.info('Shutdown complete');
+    };
+    process.on('SIGINT', () => { teardown().then(() => process.exit(0)); });
+    process.on('SIGTERM', () => { teardown().then(() => process.exit(0)); });
+    // Start MCP transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info({ tools: 10, semantic: config.semantic_enabled }, 'Memorandum ready');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Logger setup for Memorandum MCP server.
+ *
+ * Uses pino with stderr transport (stdout is reserved for MCP protocol).
+ */
+import pino from 'pino';
+/**
+ * Create a pino logger that writes to stderr.
+ * @param level - Log level (default: "info").
+ * @returns Configured pino logger instance.
+ */
+export declare function createLogger(level?: string): pino.Logger;