obsidian-mcp-server 2.0.4 → 2.0.6

package/dist/mcp-server/tools/{obsidianListFilesTool → obsidianListNotesTool}/logic.js

@@ -1,8 +1,8 @@
 /**
- * @fileoverview Core logic for the 'obsidian_list_files' tool.
+ * @fileoverview Core logic for the 'obsidian_list_notes' tool.
  * This module defines the input schema, response types, and processing logic for
  * recursively listing files and directories in an Obsidian vault with filtering.
- * @module src/mcp-server/tools/obsidianListFilesTool/logic
+ * @module src/mcp-server/tools/obsidianListNotesTool/logic
  */
 import path from "node:path";
 import { z } from "zod";
@@ -12,9 +12,9 @@ import { logger, retryWithDelay, } from "../../../utils/index.js";
 // Schema Definitions for Input Validation
 // ====================================================================================
 /**
- * Zod schema for validating the input parameters of the 'obsidian_list_files' tool.
+ * Zod schema for validating the input parameters of the 'obsidian_list_notes' tool.
  */
-export const ObsidianListFilesInputSchema = z
+export const ObsidianListNotesInputSchema = z
     .object({
     /**
      * The vault-relative path to the directory whose contents should be listed.
@@ -84,7 +84,7 @@ function formatTree(nodes, indent = "") {
  *
  * @param {string} dirPath - The path of the directory to process.
  * @param {number} currentDepth - The current recursion depth.
- * @param {ObsidianListFilesInput} params - The original validated input parameters, including filters and max depth.
+ * @param {ObsidianListNotesInput} params - The original validated input parameters, including filters and max depth.
  * @param {RequestContext} context - The request context for logging.
  * @param {ObsidianRestApiService} obsidianService - The Obsidian API service instance.
  * @returns {Promise<FileTreeNode[]>} A promise that resolves to an array of file tree nodes.
@@ -118,9 +118,7 @@ async function buildFileTree(dirPath, currentDepth, params, context, obsidianSer
         if (regex && !regex.test(cleanName)) {
             continue;
         }
-        if (!isDirectory &&
-            fileExtensionFilter &&
-            fileExtensionFilter.length > 0) {
+        if (!isDirectory && fileExtensionFilter && fileExtensionFilter.length > 0) {
             const extension = path.posix.extname(name);
             if (!fileExtensionFilter.includes(extension)) {
                 continue;
@@ -153,20 +151,23 @@ async function buildFileTree(dirPath, currentDepth, params, context, obsidianSer
 /**
  * Processes the core logic for listing files and directories recursively within the Obsidian vault.
  *
- * @param {ObsidianListFilesInput} params - The validated input parameters.
+ * @param {ObsidianListNotesInput} params - The validated input parameters.
  * @param {RequestContext} context - The request context for logging and correlation.
  * @param {ObsidianRestApiService} obsidianService - An instance of the Obsidian REST API service.
- * @returns {Promise<ObsidianListFilesResponse>} A promise resolving to the structured success response.
+ * @returns {Promise<ObsidianListNotesResponse>} A promise resolving to the structured success response.
  * @throws {McpError} Throws an McpError if the initial directory is not found or another error occurs.
  */
-export const processObsidianListFiles = async (params, context, obsidianService) => {
+export const processObsidianListNotes = async (params, context, obsidianService) => {
     const { dirPath } = params;
     const dirPathForLog = dirPath === "" || dirPath === "/" ? "/" : dirPath;
-    logger.debug(`Processing obsidian_list_files request for path: ${dirPathForLog}`, { ...context, params });
+    logger.debug(`Processing obsidian_list_notes request for path: ${dirPathForLog}`, { ...context, params });
     try {
         const effectiveDirPath = dirPath === "" ? "/" : dirPath;
         // --- Step 1: Build the file tree recursively with retry for the initial call ---
-        const buildTreeContext = { ...context, operation: "buildFileTreeWithRetry" };
+        const buildTreeContext = {
+            ...context,
+            operation: "buildFileTreeWithRetry",
+        };
         const shouldRetryNotFound = (err) => err instanceof McpError && err.code === BaseErrorCode.NOT_FOUND;
         const fileTree = await retryWithDelay(() => buildFileTree(effectiveDirPath, 0, // Start at depth 0
         params, buildTreeContext, obsidianService), {

package/dist/mcp-server/tools/{obsidianListFilesTool → obsidianListNotesTool}/registration.d.ts

@@ -1,13 +1,13 @@
 /**
- * @fileoverview Registers the 'obsidian_list_files' tool with the MCP server.
+ * @fileoverview Registers the 'obsidian_list_notes' tool with the MCP server.
  * This file defines the tool's metadata and sets up the handler that links
  * the tool call to its core processing logic.
- * @module src/mcp-server/tools/obsidianListFilesTool/registration
+ * @module src/mcp-server/tools/obsidianListNotesTool/registration
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ObsidianRestApiService } from "../../../services/obsidianRestAPI/index.js";
 /**
- * Registers the 'obsidian_list_files' tool with the MCP server.
+ * Registers the 'obsidian_list_notes' tool with the MCP server.
  *
  * This tool lists the files and subdirectories within a specified directory
  * in the user's Obsidian vault. It supports optional filtering by file extension,
@@ -20,4 +20,4 @@ import { ObsidianRestApiService } from "../../../services/obsidianRestAPI/index.
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export declare const registerObsidianListFilesTool: (server: McpServer, obsidianService: ObsidianRestApiService) => Promise<void>;
+export declare const registerObsidianListNotesTool: (server: McpServer, obsidianService: ObsidianRestApiService) => Promise<void>;

package/dist/mcp-server/tools/{obsidianListFilesTool → obsidianListNotesTool}/registration.js

@@ -1,14 +1,14 @@
 /**
- * @fileoverview Registers the 'obsidian_list_files' tool with the MCP server.
+ * @fileoverview Registers the 'obsidian_list_notes' tool with the MCP server.
  * This file defines the tool's metadata and sets up the handler that links
  * the tool call to its core processing logic.
- * @module src/mcp-server/tools/obsidianListFilesTool/registration
+ * @module src/mcp-server/tools/obsidianListNotesTool/registration
  */
 import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
 import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
-import { ObsidianListFilesInputSchema, processObsidianListFiles, } from "./logic.js";
+import { ObsidianListNotesInputSchema, processObsidianListNotes, } from "./logic.js";
 /**
- * Registers the 'obsidian_list_files' tool with the MCP server.
+ * Registers the 'obsidian_list_notes' tool with the MCP server.
  *
  * This tool lists the files and subdirectories within a specified directory
  * in the user's Obsidian vault. It supports optional filtering by file extension,
@@ -21,25 +21,25 @@ import { ObsidianListFilesInputSchema, processObsidianListFiles, } from "./logic
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export const registerObsidianListFilesTool = async (server, obsidianService) => {
-    const toolName = "obsidian_list_files";
+export const registerObsidianListNotesTool = async (server, obsidianService) => {
+    const toolName = "obsidian_list_notes";
     const toolDescription = "Lists files and subdirectories within a specified Obsidian vault folder. Supports optional filtering by extension or name regex, and recursive listing to a specified depth (-1 for infinite). Returns an object containing the listed directory path, a formatted tree string of its contents, and the total entry count. Use an empty string or '/' for dirPath to list the vault root.";
     // Create a context specifically for the registration process.
     const registrationContext = requestContextService.createRequestContext({
-        operation: "RegisterObsidianListFilesTool",
+        operation: "RegisterObsidianListNotesTool",
         toolName: toolName,
-        module: "ObsidianListFilesRegistration", // Identify the module
+        module: "ObsidianListNotesRegistration", // Identify the module
     });
     logger.info(`Attempting to register tool: ${toolName}`, registrationContext);
     // Wrap the registration logic in a tryCatch block for robust error handling during server setup.
     await ErrorHandler.tryCatch(async () => {
         // Use the high-level SDK method `server.tool` for registration.
-        server.tool(toolName, toolDescription, ObsidianListFilesInputSchema.shape, // Provide the Zod schema shape for input definition.
+        server.tool(toolName, toolDescription, ObsidianListNotesInputSchema.shape, // Provide the Zod schema shape for input definition.
         /**
-         * The handler function executed when the 'obsidian_list_files' tool is called by the client.
+         * The handler function executed when the 'obsidian_list_notes' tool is called by the client.
          *
-         * @param {ObsidianListFilesInput} params - The input parameters received from the client,
-         *   validated against the ObsidianListFilesInputSchema shape.
+         * @param {ObsidianListNotesInput} params - The input parameters received from the client,
+         *   validated against the ObsidianListNotesInputSchema shape.
          * @returns {Promise<CallToolResult>} A promise resolving to the structured result for the MCP client,
          *   containing either the successful response data (serialized JSON) or an error indication.
          */
@@ -48,7 +48,7 @@ export const registerObsidianListFilesTool = async (server, obsidianService) =>
             // Create a specific context for this handler invocation.
             const handlerContext = requestContextService.createRequestContext({
                 parentContext: registrationContext, // Link to registration context
-                operation: "HandleObsidianListFilesRequest",
+                operation: "HandleObsidianListNotesRequest",
                 toolName: toolName,
                 params: {
                     // Log all relevant parameters for debugging
@@ -62,7 +62,7 @@ export const registerObsidianListFilesTool = async (server, obsidianService) =>
             // Wrap the core logic execution in a tryCatch block.
             return await ErrorHandler.tryCatch(async () => {
                 // Delegate the actual file listing and filtering logic to the processing function.
-                const response = await processObsidianListFiles(params, handlerContext, obsidianService);
+                const response = await processObsidianListNotes(params, handlerContext, obsidianService);
                 logger.debug(`'${toolName}' processed successfully`, handlerContext);
                 // Format the successful response object from the logic function into the required MCP CallToolResult structure.
                 return {

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_read_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_read_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_read_file tool module.
- * It re-exports the primary registration function (`registerObsidianReadFileTool`)
+ * This file serves as the public entry point for the obsidian_read_note tool module.
+ * It re-exports the primary registration function (`registerObsidianReadNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianReadFileTool } from "./registration.js";
+export { registerObsidianReadNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/index.js

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_read_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_read_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_read_file tool module.
- * It re-exports the primary registration function (`registerObsidianReadFileTool`)
+ * This file serves as the public entry point for the obsidian_read_note tool module.
+ * It re-exports the primary registration function (`registerObsidianReadNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianReadFileTool } from "./registration.js";
+export { registerObsidianReadNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/logic.d.ts

@@ -2,9 +2,9 @@ import { z } from "zod";
 import { NoteJson, ObsidianRestApiService } from "../../../services/obsidianRestAPI/index.js";
 import { RequestContext } from "../../../utils/index.js";
 /**
- * Zod schema for validating the input parameters of the 'obsidian_read_file' tool.
+ * Zod schema for validating the input parameters of the 'obsidian_read_note' tool.
  */
-export declare const ObsidianReadFileInputSchema: z.ZodObject<{
+export declare const ObsidianReadNoteInputSchema: z.ZodObject<{
     /**
      * The vault-relative path to the target file (e.g., "Folder/My Note.md").
      * Must include the file extension. The tool first attempts a case-sensitive match.
@@ -34,10 +34,10 @@ export declare const ObsidianReadFileInputSchema: z.ZodObject<{
     includeStat?: boolean | undefined;
 }>;
 /**
- * TypeScript type inferred from the input schema (`ObsidianReadFileInputSchema`).
+ * TypeScript type inferred from the input schema (`ObsidianReadNoteInputSchema`).
  * Represents the validated input parameters used within the core processing logic.
  */
-export type ObsidianReadFileInput = z.infer<typeof ObsidianReadFileInputSchema>;
+export type ObsidianReadNoteInput = z.infer<typeof ObsidianReadNoteInputSchema>;
 /**
  * Represents the structure of file statistics after formatting, including
  * human-readable timestamps and an estimated token count.
@@ -51,10 +51,10 @@ type FormattedStat = {
     tokenCountEstimate: number;
 };
 /**
- * Defines the structure of the successful response returned by the `processObsidianReadFile` function.
+ * Defines the structure of the successful response returned by the `processObsidianReadNote` function.
  * This object is typically serialized to JSON and sent back to the client.
  */
-export interface ObsidianReadFileResponse {
+export interface ObsidianReadNoteResponse {
     /**
      * The content of the file in the requested format.
      * If format='markdown', this is a string.
@@ -75,13 +75,13 @@ export interface ObsidianReadFileResponse {
  * internally to access file statistics. Finally, it formats the response
  * according to the requested format ('markdown' or 'json') and the 'includeStat' flag.
  *
- * @param {ObsidianReadFileInput} params - The validated input parameters.
+ * @param {ObsidianReadNoteInput} params - The validated input parameters.
  * @param {RequestContext} context - The request context for logging and correlation.
  * @param {ObsidianRestApiService} obsidianService - An instance of the Obsidian REST API service.
- * @returns {Promise<ObsidianReadFileResponse>} A promise resolving to the structured success response
+ * @returns {Promise<ObsidianReadNoteResponse>} A promise resolving to the structured success response
  *   containing the file content and optionally formatted statistics.
  * @throws {McpError} Throws an McpError if the file cannot be found (even with fallback),
  *   if there's an ambiguous fallback match, or if any other API interaction fails.
  */
-export declare const processObsidianReadFile: (params: ObsidianReadFileInput, context: RequestContext, obsidianService: ObsidianRestApiService) => Promise<ObsidianReadFileResponse>;
+export declare const processObsidianReadNote: (params: ObsidianReadNoteInput, context: RequestContext, obsidianService: ObsidianRestApiService) => Promise<ObsidianReadNoteResponse>;
 export {};

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/logic.js

@@ -10,14 +10,14 @@ import { createFormattedStatWithTokenCount, logger, retryWithDelay, } from "../.
  * - 'markdown': Returns the raw Markdown content as a string.
  * - 'json': Returns a structured NoteJson object including content, frontmatter, tags, and stats.
  */
-const ReadFileFormatSchema = z
+const ReadNoteFormatSchema = z
     .enum(["markdown", "json"])
     .default("markdown")
     .describe("Specifies the format for the returned content ('markdown' or 'json'). Defaults to 'markdown'.");
 /**
- * Zod schema for validating the input parameters of the 'obsidian_read_file' tool.
+ * Zod schema for validating the input parameters of the 'obsidian_read_note' tool.
  */
-export const ObsidianReadFileInputSchema = z
+export const ObsidianReadNoteInputSchema = z
     .object({
     /**
      * The vault-relative path to the target file (e.g., "Folder/My Note.md").
@@ -34,7 +34,7 @@ export const ObsidianReadFileInputSchema = z
      * 'json' returns a structured NoteJson object containing content, parsed frontmatter, tags, and file metadata (stat).
      * Defaults to 'markdown'.
      */
-    format: ReadFileFormatSchema.optional() // Optional, defaults to 'markdown' via ReadFileFormatSchema
+    format: ReadNoteFormatSchema.optional() // Optional, defaults to 'markdown' via ReadNoteFormatSchema
         .describe("Format for the returned content ('markdown' or 'json'). Defaults to 'markdown'."),
     /**
      * If true and the requested format is 'markdown', includes formatted file statistics
@@ -59,18 +59,18 @@ export const ObsidianReadFileInputSchema = z
  * internally to access file statistics. Finally, it formats the response
  * according to the requested format ('markdown' or 'json') and the 'includeStat' flag.
  *
- * @param {ObsidianReadFileInput} params - The validated input parameters.
+ * @param {ObsidianReadNoteInput} params - The validated input parameters.
  * @param {RequestContext} context - The request context for logging and correlation.
  * @param {ObsidianRestApiService} obsidianService - An instance of the Obsidian REST API service.
- * @returns {Promise<ObsidianReadFileResponse>} A promise resolving to the structured success response
+ * @returns {Promise<ObsidianReadNoteResponse>} A promise resolving to the structured success response
  *   containing the file content and optionally formatted statistics.
  * @throws {McpError} Throws an McpError if the file cannot be found (even with fallback),
  *   if there's an ambiguous fallback match, or if any other API interaction fails.
  */
-export const processObsidianReadFile = async (params, context, obsidianService) => {
+export const processObsidianReadNote = async (params, context, obsidianService) => {
     const { filePath: originalFilePath, format: requestedFormat, includeStat, } = params;
     let effectiveFilePath = originalFilePath; // Track the actual path used (might change during fallback)
-    logger.debug(`Processing obsidian_read_file request for path: ${originalFilePath}`, { ...context, format: requestedFormat, includeStat });
+    logger.debug(`Processing obsidian_read_note request for path: ${originalFilePath}`, { ...context, format: requestedFormat, includeStat });
     const shouldRetryNotFound = (err) => err instanceof McpError && err.code === BaseErrorCode.NOT_FOUND;
     try {
         let noteJson;

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/registration.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ObsidianRestApiService } from "../../../services/obsidianRestAPI/index.js";
 /**
- * Registers the 'obsidian_read_file' tool with the MCP server.
+ * Registers the 'obsidian_read_note' tool with the MCP server.
  *
  * This tool retrieves the content and optionally metadata of a specified file
  * within the user's Obsidian vault. It supports specifying the output format
@@ -17,4 +17,4 @@ import { ObsidianRestApiService } from "../../../services/obsidianRestAPI/index.
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export declare const registerObsidianReadFileTool: (server: McpServer, obsidianService: ObsidianRestApiService) => Promise<void>;
+export declare const registerObsidianReadNoteTool: (server: McpServer, obsidianService: ObsidianRestApiService) => Promise<void>;

package/dist/mcp-server/tools/{obsidianReadFileTool → obsidianReadNoteTool}/registration.js

@@ -1,8 +1,8 @@
 import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
 import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
-import { ObsidianReadFileInputSchema, processObsidianReadFile, } from "./logic.js";
+import { ObsidianReadNoteInputSchema, processObsidianReadNote, } from "./logic.js";
 /**
- * Registers the 'obsidian_read_file' tool with the MCP server.
+ * Registers the 'obsidian_read_note' tool with the MCP server.
  *
  * This tool retrieves the content and optionally metadata of a specified file
  * within the user's Obsidian vault. It supports specifying the output format
@@ -18,26 +18,26 @@ import { ObsidianReadFileInputSchema, processObsidianReadFile, } from "./logic.j
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export const registerObsidianReadFileTool = async (server, obsidianService) => {
-    const toolName = "obsidian_read_file";
+export const registerObsidianReadNoteTool = async (server, obsidianService) => {
+    const toolName = "obsidian_read_note";
     const toolDescription = "Retrieves the content and metadata of a specified file within the Obsidian vault. Tries the exact path first, then attempts a case-insensitive fallback. Returns an object containing the content (markdown string or full NoteJson object based on 'format'), and optionally formatted file stats ('stats' object with creationTime, modifiedTime, tokenCountEstimate). Use 'includeStat: true' with 'format: markdown' to include stats; stats are always included with 'format: json'.";
     // Create a context specifically for the registration process.
     const registrationContext = requestContextService.createRequestContext({
-        operation: "RegisterObsidianReadFileTool",
+        operation: "RegisterObsidianReadNoteTool",
         toolName: toolName,
-        module: "ObsidianReadFileRegistration", // Identify the module
+        module: "ObsidianReadNoteRegistration", // Identify the module
     });
     logger.info(`Attempting to register tool: ${toolName}`, registrationContext);
     // Wrap the registration logic in a tryCatch block for robust error handling during server setup.
     await ErrorHandler.tryCatch(async () => {
         // Use the high-level SDK method `server.tool` for registration.
         // It handles schema generation from the shape, basic validation, and routing.
-        server.tool(toolName, toolDescription, ObsidianReadFileInputSchema.shape, // Provide the Zod schema shape for input definition.
+        server.tool(toolName, toolDescription, ObsidianReadNoteInputSchema.shape, // Provide the Zod schema shape for input definition.
         /**
-         * The handler function executed when the 'obsidian_read_file' tool is called by the client.
+         * The handler function executed when the 'obsidian_read_note' tool is called by the client.
          *
-         * @param {ObsidianReadFileInput} params - The input parameters received from the client,
-         *   validated against the ObsidianReadFileInputSchema shape. Note: The handler receives the raw input;
+         * @param {ObsidianReadNoteInput} params - The input parameters received from the client,
+         *   validated against the ObsidianReadNoteInputSchema shape. Note: The handler receives the raw input;
          *   stricter validation against the full schema should happen inside if needed, though in this case,
          *   the shape and the full schema are identical.
          * @returns {Promise<CallToolResult>} A promise resolving to the structured result for the MCP client,
@@ -48,7 +48,7 @@ export const registerObsidianReadFileTool = async (server, obsidianService) => {
             // Create a specific context for this handler invocation.
             const handlerContext = requestContextService.createRequestContext({
                 parentContext: registrationContext, // Link to registration context
-                operation: "HandleObsidianReadFileRequest",
+                operation: "HandleObsidianReadNoteRequest",
                 toolName: toolName,
                 params: {
                     // Log key parameters for debugging
@@ -63,7 +63,7 @@ export const registerObsidianReadFileTool = async (server, obsidianService) => {
                 // Delegate the actual file reading logic to the dedicated processing function.
                 // Pass the (already shape-validated) parameters, context, and the Obsidian service.
                 // The process function handles the refined validation internally if needed, but here shape = refined.
-                const response = await processObsidianReadFile(params, // Pass params directly as shape matches refined schema
+                const response = await processObsidianReadNote(params, // Pass params directly as shape matches refined schema
                 handlerContext, obsidianService);
                 logger.debug(`'${toolName}' processed successfully`, handlerContext);
                 // Format the successful response object from the logic function into the required MCP CallToolResult structure.

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/index.d.ts

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_update_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_update_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_update_file tool module.
- * It re-exports the primary registration function (`registerObsidianUpdateFileTool`)
+ * This file serves as the public entry point for the obsidian_update_note tool module.
+ * It re-exports the primary registration function (`registerObsidianUpdateNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianUpdateFileTool } from "./registration.js";
+export { registerObsidianUpdateNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/index.js

@@ -1,12 +1,12 @@
 /**
- * @fileoverview Barrel file for the 'obsidian_update_file' MCP tool.
+ * @fileoverview Barrel file for the 'obsidian_update_note' MCP tool.
  *
- * This file serves as the public entry point for the obsidian_update_file tool module.
- * It re-exports the primary registration function (`registerObsidianUpdateFileTool`)
+ * This file serves as the public entry point for the obsidian_update_note tool module.
+ * It re-exports the primary registration function (`registerObsidianUpdateNoteTool`)
  * from the './registration.js' module. This pattern simplifies imports for consumers
  * of the tool, allowing them to import necessary components from a single location.
  *
  * Consumers (like the main server setup) should import the registration function
  * from this file to integrate the tool into the MCP server instance.
  */
-export { registerObsidianUpdateFileTool } from "./registration.js";
+export { registerObsidianUpdateNoteTool } from "./registration.js";

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/logic.d.ts

@@ -8,7 +8,7 @@ import { RequestContext } from "../../../utils/index.js";
  * relying on the refined schema (`ObsidianUpdateFileInputSchema`) for stricter validation
  * within the handler logic.
  */
-declare const ObsidianUpdateFileRegistrationSchema: z.ZodObject<{
+declare const ObsidianUpdateNoteRegistrationSchema: z.ZodObject<{
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content for the modification. Must be a string for whole-file operations. */
@@ -48,7 +48,7 @@ declare const ObsidianUpdateFileRegistrationSchema: z.ZodObject<{
  * The shape of the registration schema, used by `server.tool` for basic validation.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export declare const ObsidianUpdateFileInputSchemaShape: {
+export declare const ObsidianUpdateNoteInputSchemaShape: {
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content for the modification. Must be a string for whole-file operations. */
@@ -71,13 +71,13 @@ export declare const ObsidianUpdateFileInputSchemaShape: {
  * received by the tool handler *before* refinement.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export type ObsidianUpdateFileRegistrationInput = z.infer<typeof ObsidianUpdateFileRegistrationSchema>;
+export type ObsidianUpdateNoteRegistrationInput = z.infer<typeof ObsidianUpdateNoteRegistrationSchema>;
 /**
  * Refined Zod schema used internally within the tool's logic for strict validation.
  * It builds upon `WholeFileUpdateSchema` and adds cross-field validation rules using `.refine()`.
  * This ensures that `targetIdentifier` is provided and valid when required by `targetType`.
  */
-export declare const ObsidianUpdateFileInputSchema: z.ZodEffects<z.ZodObject<{
+export declare const ObsidianUpdateNoteInputSchema: z.ZodEffects<z.ZodObject<{
     /** Specifies the type of target note. */
     targetType: z.ZodEnum<["filePath", "activeFile", "periodicNote"]>;
     /** The content to use for the modification. Must be a string for whole-file operations. */
@@ -140,7 +140,7 @@ export declare const ObsidianUpdateFileInputSchema: z.ZodEffects<z.ZodObject<{
  * TypeScript type inferred from the *refined* input schema (`ObsidianUpdateFileInputSchema`).
  * This type represents the validated and structured input used within the core processing logic.
  */
-export type ObsidianUpdateFileInput = z.infer<typeof ObsidianUpdateFileInputSchema>;
+export type ObsidianUpdateNoteInput = z.infer<typeof ObsidianUpdateNoteInputSchema>;
 /**
  * Represents the structure of file statistics after formatting, including
  * human-readable timestamps and an estimated token count.
@@ -157,7 +157,7 @@ type FormattedStat = {
  * Defines the structure of the successful response returned by the `processObsidianUpdateFile` function.
  * This object is typically serialized to JSON and sent back to the client.
  */
-export interface ObsidianUpdateFileResponse {
+export interface ObsidianUpdateNoteResponse {
     /** Indicates whether the operation was successful. */
     success: boolean;
     /** A human-readable message describing the outcome of the operation. */
@@ -178,6 +178,6 @@ export interface ObsidianUpdateFileResponse {
  * @returns {Promise<ObsidianUpdateFileResponse>} A promise resolving to the structured success response.
  * @throws {McpError} Throws an McpError if validation fails or the API interaction results in an error.
  */
-export declare const processObsidianUpdateFile: (params: ObsidianUpdateFileInput, // Use the refined, validated type
-context: RequestContext, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<ObsidianUpdateFileResponse>;
+export declare const processObsidianUpdateNote: (params: ObsidianUpdateNoteInput, // Use the refined, validated type
+context: RequestContext, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<ObsidianUpdateNoteResponse>;
 export {};

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/logic.js

@@ -79,7 +79,7 @@ const WholeFileUpdateSchema = BaseUpdateSchema.extend({
  * relying on the refined schema (`ObsidianUpdateFileInputSchema`) for stricter validation
  * within the handler logic.
  */
-const ObsidianUpdateFileRegistrationSchema = z
+const ObsidianUpdateNoteRegistrationSchema = z
     .object({
     /** Specifies the target note: 'filePath' (requires targetIdentifier), 'activeFile' (currently open file), or 'periodicNote' (requires targetIdentifier with period like 'daily'). */
     targetType: TargetTypeSchema,
@@ -122,7 +122,7 @@ const ObsidianUpdateFileRegistrationSchema = z
  * The shape of the registration schema, used by `server.tool` for basic validation.
  * @see ObsidianUpdateFileRegistrationSchema
  */
-export const ObsidianUpdateFileInputSchemaShape = ObsidianUpdateFileRegistrationSchema.shape;
+export const ObsidianUpdateNoteInputSchemaShape = ObsidianUpdateNoteRegistrationSchema.shape;
 // ====================================================================================
 // Refined Schema for Internal Logic and Strict Validation
 // ====================================================================================
@@ -131,7 +131,7 @@ export const ObsidianUpdateFileInputSchemaShape = ObsidianUpdateFileRegistration
  * It builds upon `WholeFileUpdateSchema` and adds cross-field validation rules using `.refine()`.
  * This ensures that `targetIdentifier` is provided and valid when required by `targetType`.
  */
-export const ObsidianUpdateFileInputSchema = WholeFileUpdateSchema.refine((data) => {
+export const ObsidianUpdateNoteInputSchema = WholeFileUpdateSchema.refine((data) => {
     // Rule 1: If targetType is 'filePath' or 'periodicNote', targetIdentifier must be provided.
     if ((data.targetType === "filePath" || data.targetType === "periodicNote") &&
         !data.targetIdentifier) {
@@ -207,9 +207,9 @@ async function getFinalState(targetType, targetIdentifier, period, obsidianServi
  * @returns {Promise<ObsidianUpdateFileResponse>} A promise resolving to the structured success response.
  * @throws {McpError} Throws an McpError if validation fails or the API interaction results in an error.
  */
-export const processObsidianUpdateFile = async (params, // Use the refined, validated type
+export const processObsidianUpdateNote = async (params, // Use the refined, validated type
 context, obsidianService, vaultCacheService) => {
-    logger.debug(`Processing obsidian_update_file request (wholeFile mode)`, {
+    logger.debug(`Processing obsidian_update_note request (wholeFile mode)`, {
         ...context,
         targetType: params.targetType,
         wholeFileMode: params.wholeFileMode,
@@ -251,7 +251,7 @@ context, obsidianService, vaultCacheService) => {
                 existsBefore = true;
                 logger.debug(`Target exists before operation.`, checkContext);
             }, {
-                operationName: "existenceCheckObsidianUpdateFile",
+                operationName: "existenceCheckObsidianUpdateNote",
                 context: checkContext,
                 maxRetries: 3, // Total attempts: 1 initial + 2 retries
                 delayMs: 250,
@@ -263,7 +263,7 @@ context, obsidianService, vaultCacheService) => {
                         params.createIfNeeded;
                     if (error instanceof McpError &&
                         error.code === BaseErrorCode.NOT_FOUND) {
-                        logger.debug(`existenceCheckObsidianUpdateFile: shouldRetry=${should} for NOT_FOUND (createIfNeeded: ${params.createIfNeeded})`, checkContext);
+                        logger.debug(`existenceCheckObsidianUpdateNote: shouldRetry=${should} for NOT_FOUND (createIfNeeded: ${params.createIfNeeded})`, checkContext);
                     }
                     return should;
                 },

package/dist/mcp-server/tools/{obsidianUpdateFileTool → obsidianUpdateNoteTool}/registration.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ObsidianRestApiService, VaultCacheService } from "../../../services/obsidianRestAPI/index.js";
 /**
- * Registers the 'obsidian_update_file' tool with the MCP server.
+ * Registers the 'obsidian_update_note' tool with the MCP server.
  *
  * This tool allows modification of Obsidian notes (specified by file path,
  * the active file, or a periodic note) using whole-file operations:
@@ -18,4 +18,4 @@ import { ObsidianRestApiService, VaultCacheService } from "../../../services/obs
  * @returns {Promise<void>} A promise that resolves when the tool registration is complete or rejects on error.
  * @throws {McpError} Throws an McpError if registration fails critically.
  */
-export declare const registerObsidianUpdateFileTool: (server: McpServer, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<void>;
+export declare const registerObsidianUpdateNoteTool: (server: McpServer, obsidianService: ObsidianRestApiService, vaultCacheService: VaultCacheService | undefined) => Promise<void>;