obsidian-mcp-server 3.6.1 → 3.7.0

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -7,8 +7,12 @@
  * module free of eager config reads. `obsidian_search_notes` is exposed as a
  * factory (`buildSearchNotesTool`) because its mode enum is conditional on
  * Omnisearch reachability, which is only known after the startup probe runs.
+ * `obsidian_delete_note` is exposed as a factory (`buildDeleteNoteTool`)
+ * because its description and confirmation round follow
+ * `OBSIDIAN_DELETE_ELICITATION`, which the entry point reads.
  * @module mcp-server/tools/definitions/index
  */
+export { buildDeleteNoteTool } from './obsidian-delete-note.tool.js';
 export { buildSearchNotesTool } from './obsidian-search-notes.tool.js';
 /**
  * Tools that don't depend on runtime probes — always registered, even with
@@ -165,36 +169,8 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
     readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
 }], {
+    readonly requestedPath: import("zod").ZodOptional<import("zod").ZodString>;
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    nameRegex: import("zod").ZodOptional<import("zod").ZodString>;
-    minCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    tags: import("zod").ZodArray<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        count: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>>;
-    appliedFilters: import("zod").ZodObject<{
-        nameRegex: import("zod").ZodOptional<import("zod").ZodString>;
-        minCount: import("zod").ZodOptional<import("zod").ZodNumber>;
-        limit: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "regex_invalid";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied `nameRegex` is not a valid ECMAScript regex.";
-    readonly recovery: "Use a valid ECMAScript regex (e.g. `^mcp/.*`), or omit nameRegex to disable filtering.";
-}, {
-    readonly reason: "regex_unsafe";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied `nameRegex` is well-formed but exceeds the 256-character limit or contains nested quantifiers known to cause catastrophic backtracking.";
-    readonly recovery: "Avoid nested quantifiers like `(a+)+` or `(.*)*`. Use a simpler pattern (e.g. `^mcp/.*`), or omit nameRegex to disable filtering.";
-}], {
-    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
-    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
-    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
-    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     path: import("zod").ZodOptional<import("zod").ZodString>;
     extension: import("zod").ZodOptional<import("zod").ZodString>;
@@ -239,7 +215,7 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly reason: "path_forbidden";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "The supplied `path` is outside OBSIDIAN_READ_PATHS (root listings always pass; specific subdirectories must be readable).";
+    readonly when: "The supplied `path` is outside OBSIDIAN_READ_PATHS and is not a folder on the way to it. The vault root and the folders leading to a scoped path always list, showing only in-scope entries.";
     readonly recovery: "List a directory inside the configured read scope, or omit `path` to list from the vault root. The error data echoes the active scope.";
 }, {
     readonly reason: "directory_missing";
@@ -255,6 +231,35 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly recovery: "Read the file with obsidian_get_note instead, or list its parent directory to browse alongside it.";
 }], {
     readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    nameRegex: import("zod").ZodOptional<import("zod").ZodString>;
+    minCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    tags: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        count: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    appliedFilters: import("zod").ZodObject<{
+        nameRegex: import("zod").ZodOptional<import("zod").ZodString>;
+        minCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+        limit: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "regex_invalid";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The supplied `nameRegex` is not a valid ECMAScript regex.";
+    readonly recovery: "Use a valid ECMAScript regex (e.g. `^mcp/.*`), or omit nameRegex to disable filtering.";
+}, {
+    readonly reason: "regex_unsafe";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The supplied `nameRegex` is well-formed but exceeds the 256-character limit or contains nested quantifiers known to cause catastrophic backtracking.";
+    readonly recovery: "Avoid nested quantifiers like `(a+)+` or `(.*)*`. Use a simpler pattern (e.g. `^mcp/.*`), or omit nameRegex to disable filtering.";
+}], {
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
+    readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
 }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     path: import("zod").ZodString;
     failIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
@@ -292,8 +297,15 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
     readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
-}], undefined>)[];
-/** Write tools — wrapped with `disabledTool()` when `OBSIDIAN_READ_ONLY=true`. */
+}], {
+    readonly requestedPath: import("zod").ZodOptional<import("zod").ZodString>;
+    readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
+}>)[];
+/**
+ * Write tools — wrapped with `disabledTool()` when `OBSIDIAN_READ_ONLY=true`.
+ * `obsidian_delete_note` joins this set in the entry point, built via
+ * `buildDeleteNoteTool`.
+ */
 export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
     target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
         type: import("zod").ZodLiteral<"path">;
@@ -411,6 +423,11 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
     readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
 }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    operation: import("zod").ZodEnum<{
+        delete: "delete";
+        get: "get";
+        set: "set";
+    }>;
     target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
         type: import("zod").ZodLiteral<"path">;
         path: import("zod").ZodString;
@@ -427,52 +444,46 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
         }>;
         date: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>], "type">;
-    section: import("zod").ZodObject<{
-        type: import("zod").ZodEnum<{
-            block: "block";
-            frontmatter: "frontmatter";
-            heading: "heading";
-        }>;
-        target: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>;
-    operation: import("zod").ZodEnum<{
-        append: "append";
-        prepend: "prepend";
-        replace: "replace";
-    }>;
-    content: import("zod").ZodString;
-    contentType: import("zod").ZodDefault<import("zod").ZodEnum<{
-        json: "json";
-        markdown: "markdown";
-    }>>;
-    patchOptions: import("zod").ZodOptional<import("zod").ZodObject<{
-        createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        applyIfContentPreexists: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        trimTargetWhitespace: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    }, import("zod/v4/core").$strip>>;
+    key: import("zod").ZodString;
+    value: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    path: import("zod").ZodString;
-    section: import("zod").ZodObject<{
-        type: import("zod").ZodEnum<{
-            block: "block";
-            frontmatter: "frontmatter";
-            heading: "heading";
-        }>;
-        target: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>;
-    operation: import("zod").ZodEnum<{
-        append: "append";
-        prepend: "prepend";
-        replace: "replace";
-    }>;
-    previousSizeInBytes: import("zod").ZodNumber;
-    currentSizeInBytes: import("zod").ZodNumber;
+    result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"get">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        exists: import("zod").ZodBoolean;
+        value: import("zod").ZodUnknown;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"set">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        previousSizeInBytes: import("zod").ZodNumber;
+        currentSizeInBytes: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"delete">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        previousSizeInBytes: import("zod").ZodNumber;
+        currentSizeInBytes: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>], "operation">;
 }, import("zod/v4/core").$strip>, readonly [{
     readonly reason: "path_forbidden";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes.";
-    readonly recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
+    readonly when: "`get` requires the path to be readable; `set`/`delete` require it to be inside OBSIDIAN_WRITE_PATHS, with OBSIDIAN_READ_ONLY=false.";
+    readonly recovery: "Use a path inside the configured scope. The error data echoes the active scope.";
+}, {
+    readonly reason: "value_required";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "`operation` is \"set\" but no `value` was supplied.";
+    readonly recovery: "Pass `value` as any JSON-typed value: string, number, boolean, array, or object (e.g. `\"draft\"`, `42`, `true`, `[\"a\",\"b\"]`).";
+}, {
+    readonly reason: "frontmatter_invalid";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "`operation` is \"delete\" and the note's existing frontmatter does not parse as a mapping of properties, or removing the key would leave YAML that cannot be re-emitted (an alias whose anchor went with it). Nothing is written — the note keeps its original bytes.";
+    readonly recovery: "Read the block with obsidian_get_note (format \"content\"), repair the YAML between the `---` fences, then retry the delete.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -504,35 +515,110 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
     readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
-    readonly reason: "section_target_missing";
+    readonly reason: "path_is_directory";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The named heading/block/frontmatter field does not exist in the note. Use `obsidian_get_note` with `format: \"document-map\"` to discover available targets.";
-    readonly recovery: "Call obsidian_get_note with format document-map to discover the available targets.";
+    readonly when: "The supplied path names a folder rather than a note file.";
+    readonly recovery: "Call obsidian_list_notes with this path to list the folder, then retry with the full path of one of the files it returns.";
 }, {
-    readonly reason: "ambiguous_section";
+    readonly reason: "path_traversal";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
-    readonly when: "A bare heading leaf name matches more than one heading in the note, or the resolved full heading path occurs more than once, so the write target is undetermined.";
-    readonly recovery: "Retry with a distinct full Parent::Child heading path from `candidates` on the error data; when every candidate is the same path, rename the repeated headings first.";
-}, {
-    readonly reason: "content_preexists";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
+    readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"path">;
+        path: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"active">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"periodic">;
+        period: import("zod").ZodEnum<{
+            daily: "daily";
+            monthly: "monthly";
+            quarterly: "quarterly";
+            weekly: "weekly";
+            yearly: "yearly";
+        }>;
+        date: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>], "type">;
+    scope: import("zod").ZodDefault<import("zod").ZodEnum<{
+        body: "body";
+        both: "both";
+        frontmatter: "frontmatter";
+    }>>;
+    replacements: import("zod").ZodArray<import("zod").ZodObject<{
+        search: import("zod").ZodString;
+        replace: import("zod").ZodString;
+        useRegex: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        caseSensitive: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        wholeWord: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        flexibleWhitespace: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        replaceAll: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    path: import("zod").ZodString;
+    totalReplacements: import("zod").ZodNumber;
+    perReplacement: import("zod").ZodArray<import("zod").ZodObject<{
+        search: import("zod").ZodString;
+        count: import("zod").ZodNumber;
+        bodyCount: import("zod").ZodNumber;
+        frontmatterCount: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>>;
+    previousSizeInBytes: import("zod").ZodNumber;
+    currentSizeInBytes: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "path_forbidden";
     readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
+    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes. The pre-read also requires the path to be readable.";
+    readonly recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
+}, {
+    readonly reason: "regex_invalid";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied content already appears at the target — the patch was rejected to keep retries idempotent (the default).";
-    readonly recovery: "Pass `patchOptions.applyIfContentPreexists: true` to force-apply over preexisting content, or change the content to something not already present.";
+    readonly when: "A `useRegex: true` replacement supplied a `search` pattern that is not a valid ECMAScript regex.";
+    readonly recovery: "Use a valid ECMAScript regex, or set useRegex to false to match `search` as a literal string.";
 }, {
-    readonly reason: "heading_outside_section";
-    readonly thrownBy: "service";
+    readonly reason: "regex_unsafe";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "On Local REST API v5.0 and later, the content of a heading write carries a heading at or above the target section’s own level, which would have to sit outside the section.";
-    readonly recovery: "Append the heading at the parent section or at the end of the note with obsidian_append_to_note, or write it one level below the target section or deeper.";
+    readonly when: "A `useRegex: true` replacement supplied a `search` pattern that is well-formed but exceeds the 1024-character limit or contains nested quantifiers known to cause catastrophic backtracking against the note body.";
+    readonly recovery: "Avoid nested quantifiers like `(a+)+` or `(.*)*`. Use a simpler pattern, or set useRegex to false to match `search` as a literal string.";
 }, {
-    readonly reason: "patch_rejected";
+    readonly reason: "frontmatter_invalid";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "A `scope` of \"frontmatter\" or \"both\" produced YAML that no longer parses as a mapping of properties, or that parses but cannot be re-emitted (an alias whose anchor the replacement removed). Nothing is written — the note keeps its original bytes. The check reads the rewritten YAML only, so a replacement that renames a key or changes a scalar's type while still parsing is not caught by it.";
+    readonly recovery: "Narrow the search so it cannot match inside the YAML, or leave scope at \"body\" and edit the property with obsidian_manage_frontmatter.";
+}, {
+    readonly reason: "note_missing";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The vault path does not resolve to an existing note.";
+    readonly recovery: "Verify the path with obsidian_list_notes or use obsidian_search_notes to locate the note.";
+}, {
+    readonly reason: "no_active_file";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `active` but no file is currently open in Obsidian.";
+    readonly recovery: "Call obsidian_open_in_ui to focus a file, or pass an explicit path target instead.";
+}, {
+    readonly reason: "periodic_unsupported";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `periodic` and this vault runs Local REST API v5.0.2 or later without the companion periodic-notes extension, so the `/periodic/` routes are not served at all.";
+    readonly recovery: "Install the periodic-notes extension from https://github.com/coddingtonbear/obsidian-local-rest-api-periodic-notes, or address the note by an explicit vault path.";
+}, {
+    readonly reason: "periodic_not_found";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `periodic`, the `/periodic/` routes are served on this vault, and no note exists for the requested period.";
+    readonly recovery: "Create the periodic note first or pass an explicit path target.";
+}, {
+    readonly reason: "periodic_disabled";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The target exists but the plugin refused the content for it — table rows for a block that is not a table, a row with the wrong cell count, a frontmatter value that cannot merge, or content of the wrong shape.";
-    readonly recovery: "Read the target with obsidian_get_note format section, then send content that fits it — rows matching the table columns, or a value of the field’s own type.";
+    readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
+    readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
     readonly reason: "path_is_directory";
     readonly thrownBy: "service";
@@ -677,52 +763,52 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
         }>;
         date: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>], "type">;
-    scope: import("zod").ZodDefault<import("zod").ZodEnum<{
-        body: "body";
-        both: "both";
-        frontmatter: "frontmatter";
+    section: import("zod").ZodObject<{
+        type: import("zod").ZodEnum<{
+            block: "block";
+            frontmatter: "frontmatter";
+            heading: "heading";
+        }>;
+        target: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    operation: import("zod").ZodEnum<{
+        append: "append";
+        prepend: "prepend";
+        replace: "replace";
+    }>;
+    content: import("zod").ZodString;
+    contentType: import("zod").ZodDefault<import("zod").ZodEnum<{
+        json: "json";
+        markdown: "markdown";
     }>>;
-    replacements: import("zod").ZodArray<import("zod").ZodObject<{
-        search: import("zod").ZodString;
-        replace: import("zod").ZodString;
-        useRegex: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        caseSensitive: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        wholeWord: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        flexibleWhitespace: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        replaceAll: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    patchOptions: import("zod").ZodOptional<import("zod").ZodObject<{
+        createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        applyIfContentPreexists: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        trimTargetWhitespace: import("zod").ZodDefault<import("zod").ZodBoolean>;
     }, import("zod/v4/core").$strip>>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     path: import("zod").ZodString;
-    totalReplacements: import("zod").ZodNumber;
-    perReplacement: import("zod").ZodArray<import("zod").ZodObject<{
-        search: import("zod").ZodString;
-        count: import("zod").ZodNumber;
-        bodyCount: import("zod").ZodNumber;
-        frontmatterCount: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>>;
+    section: import("zod").ZodObject<{
+        type: import("zod").ZodEnum<{
+            block: "block";
+            frontmatter: "frontmatter";
+            heading: "heading";
+        }>;
+        target: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    operation: import("zod").ZodEnum<{
+        append: "append";
+        prepend: "prepend";
+        replace: "replace";
+    }>;
     previousSizeInBytes: import("zod").ZodNumber;
     currentSizeInBytes: import("zod").ZodNumber;
 }, import("zod/v4/core").$strip>, readonly [{
     readonly reason: "path_forbidden";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes. The pre-read also requires the path to be readable.";
+    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes.";
     readonly recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
-}, {
-    readonly reason: "regex_invalid";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "A `useRegex: true` replacement supplied a `search` pattern that is not a valid ECMAScript regex.";
-    readonly recovery: "Use a valid ECMAScript regex, or set useRegex to false to match `search` as a literal string.";
-}, {
-    readonly reason: "regex_unsafe";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "A `useRegex: true` replacement supplied a `search` pattern that is well-formed but exceeds the 1024-character limit or contains nested quantifiers known to cause catastrophic backtracking against the note body.";
-    readonly recovery: "Avoid nested quantifiers like `(a+)+` or `(.*)*`. Use a simpler pattern, or set useRegex to false to match `search` as a literal string.";
-}, {
-    readonly reason: "frontmatter_invalid";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "A `scope` of \"frontmatter\" or \"both\" produced YAML that no longer parses as a mapping of properties, or that parses but cannot be re-emitted (an alias whose anchor the replacement removed). Nothing is written — the note keeps its original bytes. The check reads the rewritten YAML only, so a replacement that renames a key or changes a scalar's type while still parsing is not caught by it.";
-    readonly recovery: "Narrow the search so it cannot match inside the YAML, or leave scope at \"body\" and edit the property with obsidian_manage_frontmatter.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -754,109 +840,35 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
     readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
-    readonly reason: "path_is_directory";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied path names a folder rather than a note file.";
-    readonly recovery: "Call obsidian_list_notes with this path to list the folder, then retry with the full path of one of the files it returns.";
-}, {
-    readonly reason: "path_traversal";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
-    readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    operation: import("zod").ZodEnum<{
-        delete: "delete";
-        get: "get";
-        set: "set";
-    }>;
-    target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"path">;
-        path: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"active">;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"periodic">;
-        period: import("zod").ZodEnum<{
-            daily: "daily";
-            monthly: "monthly";
-            quarterly: "quarterly";
-            weekly: "weekly";
-            yearly: "yearly";
-        }>;
-        date: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>], "type">;
-    key: import("zod").ZodString;
-    value: import("zod").ZodOptional<import("zod").ZodUnknown>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
-        operation: import("zod").ZodLiteral<"get">;
-        path: import("zod").ZodString;
-        key: import("zod").ZodString;
-        exists: import("zod").ZodBoolean;
-        value: import("zod").ZodUnknown;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        operation: import("zod").ZodLiteral<"set">;
-        path: import("zod").ZodString;
-        key: import("zod").ZodString;
-        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
-        previousSizeInBytes: import("zod").ZodNumber;
-        currentSizeInBytes: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        operation: import("zod").ZodLiteral<"delete">;
-        path: import("zod").ZodString;
-        key: import("zod").ZodString;
-        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
-        previousSizeInBytes: import("zod").ZodNumber;
-        currentSizeInBytes: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>], "operation">;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "path_forbidden";
+    readonly reason: "section_target_missing";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "`get` requires the path to be readable; `set`/`delete` require it to be inside OBSIDIAN_WRITE_PATHS, with OBSIDIAN_READ_ONLY=false.";
-    readonly recovery: "Use a path inside the configured scope. The error data echoes the active scope.";
-}, {
-    readonly reason: "value_required";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "`operation` is \"set\" but no `value` was supplied.";
-    readonly recovery: "Pass `value` as any JSON-typed value: string, number, boolean, array, or object (e.g. `\"draft\"`, `42`, `true`, `[\"a\",\"b\"]`).";
-}, {
-    readonly reason: "frontmatter_invalid";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "`operation` is \"delete\" and the note's existing frontmatter does not parse as a mapping of properties, or removing the key would leave YAML that cannot be re-emitted (an alias whose anchor went with it). Nothing is written — the note keeps its original bytes.";
-    readonly recovery: "Read the block with obsidian_get_note (format \"content\"), repair the YAML between the `---` fences, then retry the delete.";
-}, {
-    readonly reason: "note_missing";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The vault path does not resolve to an existing note.";
-    readonly recovery: "Verify the path with obsidian_list_notes or use obsidian_search_notes to locate the note.";
+    readonly when: "The named heading/block/frontmatter field does not exist in the note. Use `obsidian_get_note` with `format: \"document-map\"` to discover available targets.";
+    readonly recovery: "Call obsidian_get_note with format document-map to discover the available targets.";
 }, {
-    readonly reason: "no_active_file";
+    readonly reason: "ambiguous_section";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `active` but no file is currently open in Obsidian.";
-    readonly recovery: "Call obsidian_open_in_ui to focus a file, or pass an explicit path target instead.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "A bare heading leaf name matches more than one heading in the note, or the resolved full heading path occurs more than once, so the write target is undetermined.";
+    readonly recovery: "Retry with a distinct full Parent::Child heading path from `candidates` on the error data; when every candidate is the same path, rename the repeated headings first.";
 }, {
-    readonly reason: "periodic_unsupported";
+    readonly reason: "content_preexists";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic` and this vault runs Local REST API v5.0.2 or later without the companion periodic-notes extension, so the `/periodic/` routes are not served at all.";
-    readonly recovery: "Install the periodic-notes extension from https://github.com/coddingtonbear/obsidian-local-rest-api-periodic-notes, or address the note by an explicit vault path.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The supplied content already appears at the target — the patch was rejected to keep retries idempotent (the default).";
+    readonly recovery: "Pass `patchOptions.applyIfContentPreexists: true` to force-apply over preexisting content, or change the content to something not already present.";
 }, {
-    readonly reason: "periodic_not_found";
+    readonly reason: "heading_outside_section";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic`, the `/periodic/` routes are served on this vault, and no note exists for the requested period.";
-    readonly recovery: "Create the periodic note first or pass an explicit path target.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "On Local REST API v5.0 and later, the content of a heading write carries a heading at or above the target section’s own level, which would have to sit outside the section.";
+    readonly recovery: "Append the heading at the parent section or at the end of the note with obsidian_append_to_note, or write it one level below the target section or deeper.";
 }, {
-    readonly reason: "periodic_disabled";
+    readonly reason: "patch_rejected";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
-    readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
+    readonly when: "The target exists but the plugin refused the content for it — table rows for a block that is not a table, a row with the wrong cell count, a frontmatter value that cannot merge, or content of the wrong shape.";
+    readonly recovery: "Read the target with obsidian_get_note format section, then send content that fits it — rows matching the table columns, or a value of the field’s own type.";
 }, {
     readonly reason: "path_is_directory";
     readonly thrownBy: "service";
@@ -981,82 +993,6 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
     readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"path">;
-        path: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"active">;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"periodic">;
-        period: import("zod").ZodEnum<{
-            daily: "daily";
-            monthly: "monthly";
-            quarterly: "quarterly";
-            weekly: "weekly";
-            yearly: "yearly";
-        }>;
-        date: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>], "type">;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    path: import("zod").ZodString;
-    deleted: import("zod").ZodBoolean;
-    previousSizeInBytes: import("zod").ZodNumber;
-    currentSizeInBytes: import("zod").ZodNumber;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "path_forbidden";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes.";
-    readonly recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
-}, {
-    readonly reason: "cancelled";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidRequest;
-    readonly when: "User declined, cancelled, or answered false to the confirmation request.";
-    readonly severity: "notice";
-    readonly recovery: "Re-run the tool when the user is ready to confirm deletion.";
-}, {
-    readonly reason: "note_missing";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "The vault path does not resolve to an existing note.";
-    readonly recovery: "Verify the path with obsidian_list_notes or use obsidian_search_notes to locate the note.";
-}, {
-    readonly reason: "no_active_file";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `active` but no file is currently open in Obsidian.";
-    readonly recovery: "Call obsidian_open_in_ui to focus a file, or pass an explicit path target instead.";
-}, {
-    readonly reason: "periodic_unsupported";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic` and this vault runs Local REST API v5.0.2 or later without the companion periodic-notes extension, so the `/periodic/` routes are not served at all.";
-    readonly recovery: "Install the periodic-notes extension from https://github.com/coddingtonbear/obsidian-local-rest-api-periodic-notes, or address the note by an explicit vault path.";
-}, {
-    readonly reason: "periodic_not_found";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic`, the `/periodic/` routes are served on this vault, and no note exists for the requested period.";
-    readonly recovery: "Pass an explicit path target — periodic notes must already exist.";
-}, {
-    readonly reason: "periodic_disabled";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
-    readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
-}, {
-    readonly reason: "path_is_directory";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied path names a folder rather than a note file. Deleting a folder is not offered — the upstream removes it and everything inside it in one unrecoverable step.";
-    readonly recovery: "Call obsidian_list_notes with this path to list the folder, then delete files one at a time by their full paths.";
-}, {
-    readonly reason: "path_traversal";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
-    readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
 }], undefined>)[];
 /** Command-palette tools — opt-in via `OBSIDIAN_ENABLE_COMMANDS=true`; suppressed by `OBSIDIAN_READ_ONLY=true`. */
 export declare const commandToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{