obsidian-mcp-server 2.0.6 → 3.0.0

package/dist/services/obsidianRestAPI/methods/patchMethods.js

@@ -1,94 +0,0 @@
-/**
- * @module PatchMethods
- * @description
- * Methods for performing granular PATCH operations within notes via the Obsidian REST API.
- */
-import { encodeVaultPath } from "../../../utils/obsidian/obsidianApiUtils.js";
-/**
- * Helper to construct headers for PATCH requests.
- */
-function buildPatchHeaders(options) {
-    const headers = {
-        Operation: options.operation,
-        "Target-Type": options.targetType,
-        // Spec requires URL encoding for non-ASCII characters in Target header
-        Target: encodeURIComponent(options.target),
-    };
-    if (options.targetDelimiter) {
-        headers["Target-Delimiter"] = options.targetDelimiter;
-    }
-    if (options.trimTargetWhitespace !== undefined) {
-        headers["Trim-Target-Whitespace"] = String(options.trimTargetWhitespace);
-    }
-    // Add Create-Target-If-Missing header if provided in options
-    if (options.createTargetIfMissing !== undefined) {
-        headers["Create-Target-If-Missing"] = String(options.createTargetIfMissing);
-    }
-    if (options.contentType) {
-        headers["Content-Type"] = options.contentType;
-    }
-    else {
-        // Default to markdown if not specified, especially for non-JSON content
-        headers["Content-Type"] = "text/markdown";
-    }
-    return headers;
-}
-/**
- * Patches a specific file in the vault.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param content - The content to insert/replace (string or JSON for tables/frontmatter).
- * @param options - Patch operation details (operation, targetType, target, etc.).
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (200 OK).
- */
-export async function patchFile(_request, filePath, content, // Allow object for JSON content type
-options, context) {
-    const headers = buildPatchHeaders(options);
-    const requestData = typeof content === "object" ? JSON.stringify(content) : content;
-    const encodedPath = encodeVaultPath(filePath);
-    // PATCH returns 200 OK according to spec
-    await _request({
-        method: "PATCH",
-        url: `/vault${encodedPath}`, // Use the encoded path
-        headers: headers,
-        data: requestData,
-    }, context, "patchFile");
-}
-/**
- * Patches the currently active file in Obsidian.
- * @param _request - The internal request function from the service instance.
- * @param content - The content to insert/replace.
- * @param options - Patch operation details.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (200 OK).
- */
-export async function patchActiveFile(_request, content, options, context) {
-    const headers = buildPatchHeaders(options);
-    const requestData = typeof content === "object" ? JSON.stringify(content) : content;
-    await _request({
-        method: "PATCH",
-        url: `/active/`,
-        headers: headers,
-        data: requestData,
-    }, context, "patchActiveFile");
-}
-/**
- * Patches a periodic note.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type ('daily', 'weekly', etc.).
- * @param content - The content to insert/replace.
- * @param options - Patch operation details.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (200 OK).
- */
-export async function patchPeriodicNote(_request, period, content, options, context) {
-    const headers = buildPatchHeaders(options);
-    const requestData = typeof content === "object" ? JSON.stringify(content) : content;
-    await _request({
-        method: "PATCH",
-        url: `/periodic/${period}/`,
-        headers: headers,
-        data: requestData,
-    }, context, "patchPeriodicNote");
-}

package/dist/services/obsidianRestAPI/methods/periodicNoteMethods.d.ts

@@ -1,42 +0,0 @@
-/**
- * @module PeriodicNoteMethods
- * @description
- * Methods for interacting with periodic notes (daily, weekly, etc.) via the Obsidian REST API.
- */
-import { RequestContext } from "../../../utils/index.js";
-import { NoteJson, Period, RequestFunction } from "../types.js";
-/**
- * Gets the content of a periodic note (daily, weekly, etc.).
- * @param _request - The internal request function from the service instance.
- * @param period - The period type ('daily', 'weekly', 'monthly', 'quarterly', 'yearly').
- * @param format - 'markdown' or 'json'.
- * @param context - Request context.
- * @returns The note content or NoteJson.
- */
-export declare function getPeriodicNote(_request: RequestFunction, period: Period, format: "markdown" | "json" | undefined, context: RequestContext): Promise<string | NoteJson>;
-/**
- * Updates (overwrites) the content of a periodic note. Creates if needed.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param content - The new content.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function updatePeriodicNote(_request: RequestFunction, period: Period, content: string, context: RequestContext): Promise<void>;
-/**
- * Appends content to a periodic note. Creates if needed.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param content - The content to append.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function appendPeriodicNote(_request: RequestFunction, period: Period, content: string, context: RequestContext): Promise<void>;
-/**
- * Deletes a periodic note.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function deletePeriodicNote(_request: RequestFunction, period: Period, context: RequestContext): Promise<void>;

package/dist/services/obsidianRestAPI/methods/periodicNoteMethods.js

@@ -1,66 +0,0 @@
-/**
- * @module PeriodicNoteMethods
- * @description
- * Methods for interacting with periodic notes (daily, weekly, etc.) via the Obsidian REST API.
- */
-/**
- * Gets the content of a periodic note (daily, weekly, etc.).
- * @param _request - The internal request function from the service instance.
- * @param period - The period type ('daily', 'weekly', 'monthly', 'quarterly', 'yearly').
- * @param format - 'markdown' or 'json'.
- * @param context - Request context.
- * @returns The note content or NoteJson.
- */
-export async function getPeriodicNote(_request, period, format = "markdown", context) {
-    const acceptHeader = format === "json" ? "application/vnd.olrapi.note+json" : "text/markdown";
-    return _request({
-        method: "GET",
-        url: `/periodic/${period}/`,
-        headers: { Accept: acceptHeader },
-    }, context, "getPeriodicNote");
-}
-/**
- * Updates (overwrites) the content of a periodic note. Creates if needed.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param content - The new content.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function updatePeriodicNote(_request, period, content, context) {
-    await _request({
-        method: "PUT",
-        url: `/periodic/${period}/`,
-        headers: { "Content-Type": "text/markdown" },
-        data: content,
-    }, context, "updatePeriodicNote");
-}
-/**
- * Appends content to a periodic note. Creates if needed.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param content - The content to append.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function appendPeriodicNote(_request, period, content, context) {
-    await _request({
-        method: "POST",
-        url: `/periodic/${period}/`,
-        headers: { "Content-Type": "text/markdown" },
-        data: content,
-    }, context, "appendPeriodicNote");
-}
-/**
- * Deletes a periodic note.
- * @param _request - The internal request function from the service instance.
- * @param period - The period type.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function deletePeriodicNote(_request, period, context) {
-    await _request({
-        method: "DELETE",
-        url: `/periodic/${period}/`,
-    }, context, "deletePeriodicNote");
-}

package/dist/services/obsidianRestAPI/methods/searchMethods.d.ts

@@ -1,25 +0,0 @@
-/**
- * @module SearchMethods
- * @description
- * Methods for performing searches via the Obsidian REST API.
- */
-import { RequestContext } from "../../../utils/index.js";
-import { SimpleSearchResult, ComplexSearchResult, RequestFunction } from "../types.js";
-/**
- * Performs a simple text search across the vault.
- * @param _request - The internal request function from the service instance.
- * @param query - The text query string.
- * @param contextLength - Number of characters surrounding each match (default 100).
- * @param context - Request context.
- * @returns An array of search results.
- */
-export declare function searchSimple(_request: RequestFunction, query: string, contextLength: number | undefined, context: RequestContext): Promise<SimpleSearchResult[]>;
-/**
- * Performs a complex search using Dataview DQL or JsonLogic.
- * @param _request - The internal request function from the service instance.
- * @param query - The query string (DQL) or JSON object (JsonLogic).
- * @param contentType - The content type header indicating the query format.
- * @param context - Request context.
- * @returns An array of search results.
- */
-export declare function searchComplex(_request: RequestFunction, query: string | object, contentType: "application/vnd.olrapi.dataview.dql+txt" | "application/vnd.olrapi.jsonlogic+json", context: RequestContext): Promise<ComplexSearchResult[]>;

package/dist/services/obsidianRestAPI/methods/searchMethods.js

@@ -1,36 +0,0 @@
-/**
- * @module SearchMethods
- * @description
- * Methods for performing searches via the Obsidian REST API.
- */
-/**
- * Performs a simple text search across the vault.
- * @param _request - The internal request function from the service instance.
- * @param query - The text query string.
- * @param contextLength - Number of characters surrounding each match (default 100).
- * @param context - Request context.
- * @returns An array of search results.
- */
-export async function searchSimple(_request, query, contextLength = 100, context) {
-    return _request({
-        method: "POST",
-        url: "/search/simple/",
-        params: { query, contextLength }, // Send as query parameters
-    }, context, "searchSimple");
-}
-/**
- * Performs a complex search using Dataview DQL or JsonLogic.
- * @param _request - The internal request function from the service instance.
- * @param query - The query string (DQL) or JSON object (JsonLogic).
- * @param contentType - The content type header indicating the query format.
- * @param context - Request context.
- * @returns An array of search results.
- */
-export async function searchComplex(_request, query, contentType, context) {
-    return _request({
-        method: "POST",
-        url: "/search/",
-        headers: { "Content-Type": contentType },
-        data: query,
-    }, context, "searchComplex");
-}

package/dist/services/obsidianRestAPI/methods/vaultMethods.d.ts

@@ -1,58 +0,0 @@
-/**
- * @module VaultMethods
- * @description
- * Methods for interacting with vault files and directories via the Obsidian REST API.
- */
-import { RequestContext } from "../../../utils/index.js";
-import { NoteJson, NoteStat, RequestFunction } from "../types.js";
-/**
- * Gets the content of a specific file in the vault.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param format - 'markdown' or 'json' (for NoteJson).
- * @param context - Request context.
- * @returns The file content (string) or NoteJson object.
- */
-export declare function getFileContent(_request: RequestFunction, filePath: string, format: "markdown" | "json" | undefined, context: RequestContext): Promise<string | NoteJson>;
-/**
- * Updates (overwrites) the content of a file or creates it if it doesn't exist.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param content - The new content for the file.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function updateFileContent(_request: RequestFunction, filePath: string, content: string, context: RequestContext): Promise<void>;
-/**
- * Appends content to the end of a file. Creates the file if it doesn't exist.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param content - The content to append.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function appendFileContent(_request: RequestFunction, filePath: string, content: string, context: RequestContext): Promise<void>;
-/**
- * Deletes a specific file in the vault.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export declare function deleteFile(_request: RequestFunction, filePath: string, context: RequestContext): Promise<void>;
-/**
- * Lists files within a specified directory in the vault.
- * @param _request - The internal request function from the service instance.
- * @param dirPath - Vault-relative path to the directory. Use empty string "" or "/" for the root.
- * @param context - Request context.
- * @returns A list of file and directory names.
- */
-export declare function listFiles(_request: RequestFunction, dirPath: string, context: RequestContext): Promise<string[]>;
-/**
- * Gets the metadata (stat) of a specific file using a lightweight HEAD request.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param context - Request context.
- * @returns The file's metadata.
- */
-export declare function getFileMetadata(_request: RequestFunction, filePath: string, context: RequestContext): Promise<NoteStat | null>;

package/dist/services/obsidianRestAPI/methods/vaultMethods.js

@@ -1,144 +0,0 @@
-/**
- * @module VaultMethods
- * @description
- * Methods for interacting with vault files and directories via the Obsidian REST API.
- */
-import { encodeVaultPath } from "../../../utils/obsidian/obsidianApiUtils.js";
-/**
- * Gets the content of a specific file in the vault.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param format - 'markdown' or 'json' (for NoteJson).
- * @param context - Request context.
- * @returns The file content (string) or NoteJson object.
- */
-export async function getFileContent(_request, filePath, format = "markdown", context) {
-    const acceptHeader = format === "json" ? "application/vnd.olrapi.note+json" : "text/markdown";
-    const encodedPath = encodeVaultPath(filePath); // Use the new encoding function
-    return _request({
-        method: "GET",
-        url: `/vault${encodedPath}`,
-        headers: { Accept: acceptHeader },
-    }, context, "getFileContent");
-}
-/**
- * Updates (overwrites) the content of a file or creates it if it doesn't exist.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param content - The new content for the file.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function updateFileContent(_request, filePath, content, context) {
-    const encodedPath = encodeVaultPath(filePath); // Use the new encoding function
-    // PUT returns 204 No Content, so the expected type is void
-    await _request({
-        method: "PUT",
-        url: `/vault${encodedPath}`, // Construct URL correctly
-        headers: { "Content-Type": "text/markdown" },
-        data: content,
-    }, context, "updateFileContent");
-}
-/**
- * Appends content to the end of a file. Creates the file if it doesn't exist.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param content - The content to append.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function appendFileContent(_request, filePath, content, context) {
-    const encodedPath = encodeVaultPath(filePath); // Use the new encoding function
-    await _request({
-        method: "POST",
-        url: `/vault${encodedPath}`, // Construct URL correctly
-        headers: { "Content-Type": "text/markdown" },
-        data: content,
-    }, context, "appendFileContent");
-}
-/**
- * Deletes a specific file in the vault.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param context - Request context.
- * @returns {Promise<void>} Resolves on success (204 No Content).
- */
-export async function deleteFile(_request, filePath, context) {
-    const encodedPath = encodeVaultPath(filePath); // Use the new encoding function
-    await _request({
-        method: "DELETE",
-        url: `/vault${encodedPath}`, // Construct URL correctly
-    }, context, "deleteFile");
-}
-/**
- * Lists files within a specified directory in the vault.
- * @param _request - The internal request function from the service instance.
- * @param dirPath - Vault-relative path to the directory. Use empty string "" or "/" for the root.
- * @param context - Request context.
- * @returns A list of file and directory names.
- */
-export async function listFiles(_request, dirPath, context) {
-    // Normalize path: remove leading/trailing slashes for consistency, except for root
-    let pathSegment = dirPath.trim();
-    // Explicitly handle root path variations ('', '/') by setting pathSegment to empty.
-    // This ensures that the final URL constructed later will be '/vault/', which the API
-    // uses to list the root directory contents.
-    if (pathSegment === "" || pathSegment === "/") {
-        pathSegment = ""; // Use empty string to signify root for URL construction
-    }
-    else {
-        // For non-root paths:
-        // 1. Remove any leading/trailing slashes to prevent issues like '/vault//path/' or '/vault/path//'.
-        // 2. URI-encode *each component* of the remaining path segment to handle special characters safely.
-        pathSegment = pathSegment
-            .replace(/^\/+|\/+$/g, "")
-            .split("/")
-            .map(encodeURIComponent)
-            .join("/");
-    }
-    // Construct the final URL for the API request:
-    // - If pathSegment is not empty (i.e., it's a specific directory), format as '/vault/{encoded_path}/'.
-    // - If pathSegment IS empty (signifying the root), format as '/vault/'.
-    // The trailing slash is important for directory listing endpoints in this API.
-    const url = pathSegment ? `/vault/${pathSegment}/` : "/vault/";
-    const response = await _request({
-        method: "GET",
-        url: url, // Use the correctly constructed URL
-    }, context, "listFiles");
-    return response.files;
-}
-/**
- * Gets the metadata (stat) of a specific file using a lightweight HEAD request.
- * @param _request - The internal request function from the service instance.
- * @param filePath - Vault-relative path to the file.
- * @param context - Request context.
- * @returns The file's metadata.
- */
-export async function getFileMetadata(_request, filePath, context) {
-    const encodedPath = encodeVaultPath(filePath);
-    try {
-        const response = await _request({
-            method: "HEAD",
-            url: `/vault${encodedPath}`,
-        }, context, "getFileMetadata");
-        if (response && response.headers) {
-            const headers = response.headers;
-            return {
-                mtime: headers["x-obsidian-mtime"]
-                    ? parseFloat(headers["x-obsidian-mtime"]) * 1000
-                    : 0,
-                ctime: headers["x-obsidian-ctime"]
-                    ? parseFloat(headers["x-obsidian-ctime"]) * 1000
-                    : 0,
-                size: headers["content-length"]
-                    ? parseInt(headers["content-length"], 10)
-                    : 0,
-            };
-        }
-        return null;
-    }
-    catch (error) {
-        // Errors are already logged by the _request function, so we can just return null
-        return null;
-    }
-}

package/dist/services/obsidianRestAPI/service.d.ts

@@ -1,195 +0,0 @@
-/**
- * @module ObsidianRestApiService
- * @description
- * This module provides the core implementation for the Obsidian REST API service.
- * It encapsulates the logic for making authenticated requests to the API endpoints.
- */
-import { RequestContext } from "../../utils/index.js";
-import { ApiStatusResponse, // Import PatchOptions type
-ComplexSearchResult, NoteJson, NoteStat, ObsidianCommand, PatchOptions, Period, SimpleSearchResult } from "./types.js";
-export declare class ObsidianRestApiService {
-    private axiosInstance;
-    private apiKey;
-    constructor();
-    /**
-     * Private helper to make requests and handle common errors.
-     * @param config - Axios request configuration.
-     * @param context - Request context for logging.
-     * @param operationName - Name of the operation for logging context.
-     * @returns The response data.
-     * @throws {McpError} If the request fails.
-     */
-    private _request;
-    /**
-     * Checks the status and authentication of the Obsidian Local REST API.
-     * @param context - The request context for logging and correlation.
-     * @returns {Promise<ApiStatusResponse>} - The status object from the API.
-     */
-    checkStatus(context: RequestContext): Promise<ApiStatusResponse>;
-    /**
-     * Gets the content of a specific file in the vault.
-     * @param filePath - Vault-relative path to the file.
-     * @param format - 'markdown' or 'json' (for NoteJson).
-     * @param context - Request context.
-     * @returns The file content (string) or NoteJson object.
-     */
-    getFileContent(filePath: string, format: "markdown" | "json" | undefined, context: RequestContext): Promise<string | NoteJson>;
-    /**
-     * Updates (overwrites) the content of a file or creates it if it doesn't exist.
-     * @param filePath - Vault-relative path to the file.
-     * @param content - The new content for the file.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    updateFileContent(filePath: string, content: string, context: RequestContext): Promise<void>;
-    /**
-     * Appends content to the end of a file. Creates the file if it doesn't exist.
-     * @param filePath - Vault-relative path to the file.
-     * @param content - The content to append.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    appendFileContent(filePath: string, content: string, context: RequestContext): Promise<void>;
-    /**
-     * Deletes a specific file in the vault.
-     * @param filePath - Vault-relative path to the file.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    deleteFile(filePath: string, context: RequestContext): Promise<void>;
-    /**
-     * Lists files within a specified directory in the vault.
-     * @param dirPath - Vault-relative path to the directory. Use empty string "" or "/" for the root.
-     * @param context - Request context.
-     * @returns A list of file and directory names.
-     */
-    listFiles(dirPath: string, context: RequestContext): Promise<string[]>;
-    /**
-     * Gets the metadata (stat) of a specific file using a lightweight HEAD request.
-     * @param filePath - Vault-relative path to the file.
-     * @param context - Request context.
-     * @returns The file's metadata.
-     */
-    getFileMetadata(filePath: string, context: RequestContext): Promise<NoteStat | null>;
-    /**
-     * Performs a simple text search across the vault.
-     * @param query - The text query string.
-     * @param contextLength - Number of characters surrounding each match (default 100).
-     * @param context - Request context.
-     * @returns An array of search results.
-     */
-    searchSimple(query: string, contextLength: number | undefined, context: RequestContext): Promise<SimpleSearchResult[]>;
-    /**
-     * Performs a complex search using Dataview DQL or JsonLogic.
-     * @param query - The query string (DQL) or JSON object (JsonLogic).
-     * @param contentType - The content type header indicating the query format.
-     * @param context - Request context.
-     * @returns An array of search results.
-     */
-    searchComplex(query: string | object, contentType: "application/vnd.olrapi.dataview.dql+txt" | "application/vnd.olrapi.jsonlogic+json", context: RequestContext): Promise<ComplexSearchResult[]>;
-    /**
-     * Executes a registered Obsidian command by its ID.
-     * @param commandId - The ID of the command (e.g., "app:go-back").
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    executeCommand(commandId: string, context: RequestContext): Promise<void>;
-    /**
-     * Lists all available Obsidian commands.
-     * @param context - Request context.
-     * @returns A list of available commands.
-     */
-    listCommands(context: RequestContext): Promise<ObsidianCommand[]>;
-    /**
-     * Opens a specific file in Obsidian. Creates the file if it doesn't exist.
-     * @param filePath - Vault-relative path to the file.
-     * @param newLeaf - Whether to open the file in a new editor tab (leaf).
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (200 OK, but no body expected).
-     */
-    openFile(filePath: string, newLeaf: boolean | undefined, context: RequestContext): Promise<void>;
-    /**
-     * Gets the content of the currently active file in Obsidian.
-     * @param format - 'markdown' or 'json' (for NoteJson).
-     * @param context - Request context.
-     * @returns The file content (string) or NoteJson object.
-     */
-    getActiveFile(format: "markdown" | "json" | undefined, context: RequestContext): Promise<string | NoteJson>;
-    /**
-     * Updates (overwrites) the content of the currently active file.
-     * @param content - The new content.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    updateActiveFile(content: string, context: RequestContext): Promise<void>;
-    /**
-     * Appends content to the end of the currently active file.
-     * @param content - The content to append.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    appendActiveFile(content: string, context: RequestContext): Promise<void>;
-    /**
-     * Deletes the currently active file.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    deleteActiveFile(context: RequestContext): Promise<void>;
-    /**
-     * Gets the content of a periodic note (daily, weekly, etc.).
-     * @param period - The period type ('daily', 'weekly', 'monthly', 'quarterly', 'yearly').
-     * @param format - 'markdown' or 'json'.
-     * @param context - Request context.
-     * @returns The note content or NoteJson.
-     */
-    getPeriodicNote(period: Period, format: "markdown" | "json" | undefined, context: RequestContext): Promise<string | NoteJson>;
-    /**
-     * Updates (overwrites) the content of a periodic note. Creates if needed.
-     * @param period - The period type.
-     * @param content - The new content.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    updatePeriodicNote(period: Period, content: string, context: RequestContext): Promise<void>;
-    /**
-     * Appends content to a periodic note. Creates if needed.
-     * @param period - The period type.
-     * @param content - The content to append.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    appendPeriodicNote(period: Period, content: string, context: RequestContext): Promise<void>;
-    /**
-     * Deletes a periodic note.
-     * @param period - The period type.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (204 No Content).
-     */
-    deletePeriodicNote(period: Period, context: RequestContext): Promise<void>;
-    /**
-     * Patches a specific file in the vault using granular controls.
-     * @param filePath - Vault-relative path to the file.
-     * @param content - The content to insert/replace (string or JSON for tables/frontmatter).
-     * @param options - Patch operation details (operation, targetType, target, etc.).
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (200 OK).
-     */
-    patchFile(filePath: string, content: string | object, options: PatchOptions, context: RequestContext): Promise<void>;
-    /**
-     * Patches the currently active file in Obsidian using granular controls.
-     * @param content - The content to insert/replace.
-     * @param options - Patch operation details.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (200 OK).
-     */
-    patchActiveFile(content: string | object, options: PatchOptions, context: RequestContext): Promise<void>;
-    /**
-     * Patches a periodic note using granular controls.
-     * @param period - The period type ('daily', 'weekly', etc.).
-     * @param content - The content to insert/replace.
-     * @param options - Patch operation details.
-     * @param context - Request context.
-     * @returns {Promise<void>} Resolves on success (200 OK).
-     */
-    patchPeriodicNote(period: Period, content: string | object, options: PatchOptions, context: RequestContext): Promise<void>;
-}