obsidian-mcp-server 1.5.8 → 2.0.2

package/dist/tools/search/simple.js

@@ -1,127 +0,0 @@
-import { createLogger } from "../../utils/logging.js";
-import { BaseToolHandler } from "../base.js";
-// Create a logger for search operations
-const logger = createLogger('SimpleSearchTools');
-/**
- * Tool name for simple search
- */
-export const SIMPLE_SEARCH_TOOL_NAME = "obsidian_find_in_file";
-/**
- * Tool handler for simple text search across files
- */
-export class FindInFileToolHandler extends BaseToolHandler {
-    constructor(client) {
-        super(SIMPLE_SEARCH_TOOL_NAME, client);
-    }
-    getToolDescription() {
-        return {
-            name: this.name,
-            description: "Performs a full-text search across all files in your Obsidian vault. Returns matching files with context around each match. If more than 5 files match, only filenames and match counts are returned to avoid excessive output. Ideal for locating specific text, tags, or patterns.",
-            examples: [
-                {
-                    description: "Search for a specific term with custom context length",
-                    args: {
-                        query: "neural networks",
-                        contextLength: 20
-                    }
-                },
-                {
-                    description: "Search with default context",
-                    args: {
-                        query: "#todo"
-                    },
-                    response: {
-                        "message": "Found 1 file with matches:",
-                        "results": [
-                            {
-                                "filename": "Projects/AI.md",
-                                "matches": [
-                                    {
-                                        "context": "Research needed:\n#todo Implement transformer architecture\nDeadline: Next week",
-                                        "match": { "start": 15, "end": 45 }
-                                    }
-                                ]
-                            }
-                        ]
-                    }
-                },
-                {
-                    description: "Example response with many matches (file-only format)",
-                    args: {
-                        query: "API"
-                    },
-                    response: {
-                        "message": "Found 92 files with matches. Showing file names only:",
-                        "results": [
-                            {
-                                "filename": "Developer/Documentation/API.md",
-                                "matchCount": 43
-                            },
-                            {
-                                "filename": "Projects/API_Design.md",
-                                "matchCount": 34
-                            }
-                        ]
-                    }
-                }
-            ],
-            inputSchema: {
-                type: "object",
-                properties: {
-                    query: {
-                        type: "string",
-                        description: "Text pattern to search for. Can include tags, keywords, or phrases."
-                    },
-                    contextLength: {
-                        type: "integer",
-                        description: "Number of characters surrounding each match to provide context (default: 10).",
-                        default: 10
-                    }
-                },
-                required: ["query"]
-            }
-        };
-    }
-    async runTool(args) {
-        try {
-            logger.debug(`Searching for "${args.query}" with context length: ${args.contextLength || 10}`); // Align debug log default
-            const results = await this.client.search(args.query, args.contextLength ?? 10); // Align implemented default
-            // If more than 5 results, only return filenames and match counts to prevent overwhelming responses
-            if (results.length > 5) {
-                const fileOnlyResults = results.map(result => ({
-                    filename: result.filename,
-                    matchCount: result.matches.length
-                }));
-                logger.debug(`Found ${results.length} files with matches, returning file-only format`);
-                return this.createResponse({
-                    message: `Found ${results.length} files with matches. Showing file names only:`,
-                    results: fileOnlyResults
-                });
-            }
-            // Otherwise return full context as before
-            const formattedResults = results.map(result => ({
-                filename: result.filename,
-                matches: result.matches.map(match => ({
-                    context: match.context,
-                    match: {
-                        text: match.context.substring(match.match.start, match.match.end),
-                        position: {
-                            start: match.match.start,
-                            end: match.match.end
-                        }
-                    }
-                })),
-                score: result.score
-            }));
-            logger.debug(`Found ${results.length} files with matches, returning with context`);
-            return this.createResponse({
-                message: `Found ${results.length} file(s) with matches:`,
-                results: formattedResults
-            });
-        }
-        catch (error) {
-            return this.handleError(error);
-        }
-    }
-}
-//# sourceMappingURL=simple.js.map

package/dist/tools/search/simple.js.map

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

package/dist/utils/errors.d.ts

@@ -1,24 +0,0 @@
-/**
- * Error handling utilities for the Obsidian MCP Server
- */
-/**
- * Standard error interface for API responses
- */
-export interface ApiError {
-    errorCode: number;
-    message: string;
-}
-/**
- * Error class for Obsidian MCP Server specific errors
- */
-export declare class ObsidianError extends Error implements ApiError {
-    readonly details?: unknown | undefined;
-    readonly errorCode: number;
-    constructor(message: string, errorCode?: number, // Default server error code
-    details?: unknown | undefined);
-    toApiError(): ApiError;
-}
-/**
- * Maps HTTP status codes to internal error codes
- */
-export declare function getErrorCodeFromStatus(status: number): number;

package/dist/utils/errors.js

@@ -1,59 +0,0 @@
-/**
- * Error handling utilities for the Obsidian MCP Server
- */
-/**
- * Error class for Obsidian MCP Server specific errors
- */
-export class ObsidianError extends Error {
-    details;
-    errorCode;
-    constructor(message, errorCode = 50000, // Default server error code
-    details) {
-        super(message);
-        this.details = details;
-        this.name = "ObsidianError";
-        // Ensure 5-digit error code
-        if (errorCode < 10000 || errorCode > 99999) {
-            // Convert HTTP status codes to 5-digit codes
-            // 4xx -> 4xxxx
-            // 5xx -> 5xxxx
-            this.errorCode = errorCode < 1000 ? errorCode * 100 : 50000;
-        }
-        else {
-            this.errorCode = errorCode;
-        }
-    }
-    // Convert to API error format
-    toApiError() {
-        return {
-            errorCode: this.errorCode,
-            message: this.message
-        };
-    }
-}
-/**
- * Maps HTTP status codes to internal error codes
- */
-export function getErrorCodeFromStatus(status) {
-    switch (status) {
-        case 400: return 40000; // Bad request
-        case 401: return 40100; // Unauthorized
-        case 403: return 40300; // Forbidden
-        case 404: return 40400; // Not found
-        case 405: return 40500; // Method not allowed
-        case 409: return 40900; // Conflict
-        case 429: return 42900; // Too many requests
-        case 500: return 50000; // Internal server error
-        case 501: return 50100; // Not implemented
-        case 502: return 50200; // Bad gateway
-        case 503: return 50300; // Service unavailable
-        case 504: return 50400; // Gateway timeout
-        default:
-            if (status >= 400 && status < 500)
-                return 40000 + (status - 400) * 100;
-            if (status >= 500 && status < 600)
-                return 50000 + (status - 500) * 100;
-            return 50000;
-    }
-}
-//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAMpB;IALF,SAAS,CAAS;IAElC,YACE,OAAe,EACf,YAAoB,KAAK,EAAE,4BAA4B;IACvC,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAE5B,4BAA4B;QAC5B,IAAI,SAAS,GAAG,KAAK,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;YAC3C,6CAA6C;YAC7C,eAAe;YACf,eAAe;YACf,IAAI,CAAC,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,UAAU;QACR,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,cAAc;QACtC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,eAAe;QACvC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,YAAY;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,YAAY;QACpC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,qBAAqB;QAC7C,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,oBAAoB;QAC5C,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,wBAAwB;QAChD,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,kBAAkB;QAC1C,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,cAAc;QACtC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,sBAAsB;QAC9C,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,kBAAkB;QAC1C;YACE,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;gBAAE,OAAO,KAAK,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YACvE,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;gBAAE,OAAO,KAAK,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YACvE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/utils/idGenerator.d.ts

@@ -1,15 +0,0 @@
-/**
- * Generates a unique, URL-friendly, 6-character alphanumeric ID.
- * Uses nanoid's default alphabet (A-Za-z0-9_-).
- *
- * @returns A 6-character string ID.
- */
-export declare function generateShortId(): string;
-/**
- * Generates a unique ID with a specified prefix and length.
- *
- * @param prefix - The prefix for the ID (e.g., 'prj', 'tsk', 'knw').
- * @param length - The desired length of the random part of the ID (default: 10).
- * @returns A prefixed ID string (e.g., 'prj_aBcDeFgHiJ').
- */
-export declare function generatePrefixedId(prefix: string, length?: number): string;

package/dist/utils/idGenerator.js

@@ -1,21 +0,0 @@
-import { nanoid } from 'nanoid';
-/**
- * Generates a unique, URL-friendly, 6-character alphanumeric ID.
- * Uses nanoid's default alphabet (A-Za-z0-9_-).
- *
- * @returns A 6-character string ID.
- */
-export function generateShortId() {
-    return nanoid(6);
-}
-/**
- * Generates a unique ID with a specified prefix and length.
- *
- * @param prefix - The prefix for the ID (e.g., 'prj', 'tsk', 'knw').
- * @param length - The desired length of the random part of the ID (default: 10).
- * @returns A prefixed ID string (e.g., 'prj_aBcDeFgHiJ').
- */
-export function generatePrefixedId(prefix, length = 10) {
-    return `${prefix}_${nanoid(length)}`;
-}
-//# sourceMappingURL=idGenerator.js.map

package/dist/utils/idGenerator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"idGenerator.js","sourceRoot":"","sources":["../../src/utils/idGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,SAAiB,EAAE;IACpE,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACvC,CAAC"}

package/dist/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/utils/logging.d.ts

@@ -1,245 +0,0 @@
-/**
- * Standardized Logging System for the Obsidian MCP Server
- *
- * This module provides structured logging capabilities aligned with MCP best practices.
- * It supports categorized errors, severity levels, context tracking, performance
- * monitoring, and secure logging patterns.
- *
- * @module utils/logging
- */
-/**
- * Error categories following MCP standards
- */
-export declare enum ErrorCategoryType {
-    CATEGORY_VALIDATION = "VALIDATION",
-    CATEGORY_AUTHENTICATION = "AUTHENTICATION",
-    CATEGORY_AUTHORIZATION = "AUTHORIZATION",
-    CATEGORY_BUSINESS_LOGIC = "BUSINESS_LOGIC",
-    CATEGORY_DATA_ACCESS = "DATA_ACCESS",
-    CATEGORY_EXTERNAL_SERVICE = "EXTERNAL_SERVICE",
-    CATEGORY_SYSTEM = "SYSTEM",
-    CATEGORY_UNKNOWN = "UNKNOWN"
-}
-/**
- * Log levels aligned with MCP's ErrorSeverityLevel
- */
-export declare enum LogLevel {
-    /** Critical errors that require immediate attention */
-    ERROR = 0,
-    /** Potentially harmful situations that should be reviewed */
-    WARN = 1,
-    /** General informational messages about system operation */
-    INFO = 2,
-    /** Detailed information for debugging purposes */
-    DEBUG = 3,
-    /** Highly detailed tracing information */
-    TRACE = 4
-}
-/**
- * Maps LogLevel to MCP severity level for integration with MCP error handling
- */
-export declare const logLevelToMcpSeverity: {
-    0: number;
-    1: number;
-    2: number;
-    3: number;
-    4: number;
-};
-/**
- * Structured log entry interface that follows MCP standards
- */
-export interface StructuredLogEntry {
-    /** Timestamp when the log was created */
-    timestamp: string;
-    /** Log message */
-    message: string;
-    /** Component that generated the log */
-    component: string;
-    /** Log level */
-    level: LogLevel;
-    /** Optional context data for the log entry */
-    context?: Record<string, unknown>;
-    /** Optional error information */
-    error?: StandardizedErrorObject;
-    /** Optional processing time in milliseconds */
-    processingTimeMs?: number;
-}
-/**
- * Standardized error object following MCP conventions
- */
-export interface StandardizedErrorObject {
-    /** Human-readable error message */
-    errorMessage: string;
-    /** Machine-readable error code */
-    errorCode: string;
-    /** System area affected by the error */
-    errorCategory: ErrorCategoryType;
-    /** How critical the error is */
-    errorSeverity: LogLevel;
-    /** When the error occurred */
-    errorTimestamp: string;
-    /** Additional relevant data */
-    errorContext?: Record<string, unknown>;
-    /** Stack trace if available */
-    errorStack?: string;
-}
-/**
- * Logger configuration
- */
-export interface LoggerConfig {
-    /** Minimum log level to display */
-    level: LogLevel;
-    /** Whether to include timestamps in log output */
-    includeTimestamps: boolean;
-    /** Whether to include level in log output */
-    includeLevel: boolean;
-    /** Whether to mask sensitive data in logs */
-    maskSensitiveData: boolean;
-    /** List of field names to consider sensitive */
-    sensitiveFields: string[];
-    /** Directory for log files */
-    logDir?: string;
-    /** Whether to log to files */
-    files?: boolean;
-    /** Custom file names for log files */
-    fileNames?: {
-        combined?: string;
-        error?: string;
-        warn?: string;
-        info?: string;
-        debug?: string;
-    };
-}
-/**
- * Enhanced logger for MCP server operations with structured logging support
- * Implements file-based logging with zero console output
- */
-export declare class Logger {
-    private name;
-    private config;
-    private timers;
-    private logger;
-    /**
-     * Creates a new logger instance
-     *
-     * @param name - Component name for this logger
-     * @param config - Optional configuration overrides
-     */
-    constructor(name: string, config?: Partial<LoggerConfig>);
-    /**
-     * Initialize or reinitialize the Winston logger
-     */
-    private initializeLogger;
-    /**
-     * Maps internal LogLevel to Winston log level
-     */
-    private levelToWinstonLevel;
-    /**
-     * Creates a standardized error object for MCP compatibility
-     *
-     * @param message - Human-readable error description
-     * @param code - Machine-readable error identifier
-     * @param category - Type of error
-     * @param context - Additional error context
-     * @returns Standardized error object
-     */
-    createStandardizedError(message: string, code: string, category?: ErrorCategoryType, context?: Record<string, unknown>): StandardizedErrorObject;
-    /**
-     * Wraps an exception as a standardized error
-     *
-     * @param error - Original error object
-     * @param message - Optional override message
-     * @param category - Error category
-     * @returns Standardized error object
-     */
-    wrapExceptionAsStandardizedError(error: unknown, message?: string, category?: ErrorCategoryType): StandardizedErrorObject;
-    /**
-     * Masks sensitive data in objects before logging
-     *
-     * @param data - Data object to process
-     * @returns Processed data with sensitive fields masked
-     */
-    private processSensitiveData;
-    /**
-     * Internal method to log a message using Winston
-     *
-     * @param level - Log level
-     * @param message - Log message
-     * @param context - Optional context data
-     */
-    private log;
-    /**
-     * Log an error message with optional error object and context
-     *
-     * @param message - Error message
-     * @param errorOrContext - Error object or context
-     * @param context - Additional context
-     */
-    error(message: string, errorOrContext?: Error | Record<string, unknown>, context?: Record<string, unknown>): void;
-    /**
-     * Log a warning message
-     *
-     * @param message - Warning message
-     * @param context - Optional context data
-     */
-    warn(message: string, context?: Record<string, unknown>): void;
-    /**
-     * Log an info message
-     *
-     * @param message - Info message
-     * @param context - Optional context data
-     */
-    info(message: string, context?: Record<string, unknown>): void;
-    /**
-     * Log a debug message
-     *
-     * @param message - Debug message
-     * @param context - Optional context data
-     */
-    debug(message: string, context?: Record<string, unknown>): void;
-    /**
-     * Log a trace message
-     *
-     * @param message - Trace message
-     * @param context - Optional context data
-     */
-    trace(message: string, context?: Record<string, unknown>): void;
-    /**
-     * Set the log level
-     *
-     * @param level - New log level
-     */
-    setLevel(level: LogLevel): void;
-    /**
-     * Start a timer for performance tracking
-     *
-     * @param id - Timer identifier
-     */
-    startTimer(id: string): void;
-    /**
-     * End a timer and log the elapsed time
-     *
-     * @param id - Timer identifier
-     * @param message - Log message prefix
-     * @param level - Log level for the timing message
-     */
-    endTimer(id: string, message?: string, level?: LogLevel): number;
-    /**
-     * Log the result of an operation with timing information
-     *
-     * @param success - Whether the operation was successful
-     * @param operation - Operation name
-     * @param elapsedMs - Processing time in milliseconds
-     * @param context - Optional operation context
-     */
-    logOperationResult(success: boolean, operation: string, elapsedMs: number, context?: Record<string, unknown>): void;
-}
-/**
- * Create and return a namespaced logger
- *
- * @param name - Component name for the logger
- * @param config - Optional configuration overrides
- * @returns Configured logger instance
- */
-export declare function createLogger(name: string, config?: Partial<LoggerConfig>): Logger;
-export declare const rootLogger: Logger;