obsidian-mcp-server 3.6.1 → 3.7.1

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,9 +297,21 @@ 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<{
+    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;
@@ -311,39 +328,52 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
         }>;
         date: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>], "type">;
-    content: import("zod").ZodString;
-    section: import("zod").ZodOptional<import("zod").ZodObject<{
-        type: import("zod").ZodEnum<{
-            block: "block";
-            frontmatter: "frontmatter";
-            heading: "heading";
-        }>;
-        target: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
-    contentType: import("zod").ZodDefault<import("zod").ZodEnum<{
-        json: "json";
-        markdown: "markdown";
-    }>>;
-    createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    key: import("zod").ZodString;
+    value: import("zod").ZodOptional<import("zod").ZodUnknown>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    path: import("zod").ZodString;
-    sectionTargeted: import("zod").ZodBoolean;
-    sectionTarget: import("zod").ZodOptional<import("zod").ZodString>;
-    created: import("zod").ZodBoolean;
-    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";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Section append targets a path that does not resolve to an existing note (PATCH requires the file to exist).";
-    readonly recovery: "Verify the path with obsidian_list_notes, or omit `section` to fall back to whole-file append (which creates the note if missing).";
+    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";
@@ -368,36 +398,6 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "section_target_missing";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "`section` was provided but the named heading/block/frontmatter field does not exist in the note.";
-    readonly recovery: "Call obsidian_get_note with format document-map to discover available targets, or pass createTargetIfMissing: true to bring it into existence.";
-}, {
-    readonly reason: "ambiguous_section";
-    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 append 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 thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Section append where the supplied content already appears at the target — rejected to keep retries idempotent (the default for the section path).";
-    readonly recovery: "Change the content to something not already present at the target, or use obsidian_patch_note with `patchOptions.applyIfContentPreexists: true` if a duplicate is intended.";
-}, {
-    readonly reason: "heading_outside_section";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "On Local REST API v5.0 and later, content appended to a heading carries a heading at or above that 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 (no `section`), or write it one level below the target section or deeper.";
-}, {
-    readonly reason: "patch_rejected";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The section 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";
@@ -427,52 +427,52 @@ 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";
+    scope: import("zod").ZodDefault<import("zod").ZodEnum<{
+        body: "body";
+        both: "both";
+        frontmatter: "frontmatter";
     }>>;
-    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>;
+    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;
-    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";
-    }>;
+    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.";
+    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: "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";
@@ -504,43 +504,13 @@ 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 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 reason: "ambiguous_section";
-    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 thrownBy: "service";
-    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: "heading_outside_section";
+    readonly reason: "path_is_directory";
     readonly thrownBy: "service";
     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: "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: "patch_rejected";
-    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 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 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.";
@@ -588,6 +558,11 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
     readonly when: "Whole-file write was attempted against an existing note and `overwrite` was not set to `true`.";
     readonly recovery: "Retry with overwrite true or use obsidian_patch_note for in-place edits.";
+}, {
+    readonly reason: "case_variant_exists";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "Whole-file write to a path that differs from an existing note only in letter case, on a case-insensitive filesystem (macOS, Windows) where both name one file. `existingPath` names that note when the parent folder listing shows exactly one case match; it is omitted when several match, and when a file Obsidian does not index, such as a dot-file, already sits at the path.";
+    readonly recovery: "Retry with the path in `existingPath` on the error data, which names the same file. Without `existingPath`, list the folder with obsidian_list_notes and use the spelling it shows, or choose another path.";
 }, {
     readonly reason: "path_forbidden";
     readonly thrownBy: "service";
@@ -677,58 +652,45 @@ 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";
-    }>>;
-    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>;
+    content: import("zod").ZodString;
+    section: import("zod").ZodOptional<import("zod").ZodObject<{
+        type: import("zod").ZodEnum<{
+            block: "block";
+            frontmatter: "frontmatter";
+            heading: "heading";
+        }>;
+        target: import("zod").ZodString;
     }, import("zod/v4/core").$strip>>;
+    contentType: import("zod").ZodDefault<import("zod").ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, 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>>;
+    sectionTargeted: import("zod").ZodBoolean;
+    sectionTarget: import("zod").ZodOptional<import("zod").ZodString>;
+    created: import("zod").ZodBoolean;
     previousSizeInBytes: import("zod").ZodNumber;
     currentSizeInBytes: import("zod").ZodNumber;
 }, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "case_variant_exists";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "Whole-file append to a path that differs from an existing note only in letter case, on a case-insensitive filesystem (macOS, Windows) where both name one file. `existingPath` names that note when the parent folder listing shows exactly one case match; it is omitted when several match, and when a file Obsidian does not index, such as a dot-file, already sits at the path.";
+    readonly recovery: "Retry with the path in `existingPath` on the error data, which names the same file. Without `existingPath`, list the folder with obsidian_list_notes and use the spelling it shows, or choose another path.";
+}, {
     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";
     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: "Section append targets a path that does not resolve to an existing note (PATCH requires the file to exist).";
+    readonly recovery: "Verify the path with obsidian_list_notes, or omit `section` to fall back to whole-file append (which creates the note if missing).";
 }, {
     readonly reason: "no_active_file";
     readonly thrownBy: "service";
@@ -753,6 +715,36 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "section_target_missing";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "`section` was provided but the named heading/block/frontmatter field does not exist in the note.";
+    readonly recovery: "Call obsidian_get_note with format document-map to discover available targets, or pass createTargetIfMissing: true to bring it into existence.";
+}, {
+    readonly reason: "ambiguous_section";
+    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 append 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 thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "Section append where the supplied content already appears at the target — rejected to keep retries idempotent (the default for the section path).";
+    readonly recovery: "Change the content to something not already present at the target, or use obsidian_patch_note with `patchOptions.applyIfContentPreexists: true` if a duplicate is intended.";
+}, {
+    readonly reason: "heading_outside_section";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "On Local REST API v5.0 and later, content appended to a heading carries a heading at or above that 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 (no `section`), or write it one level below the target section or deeper.";
+}, {
+    readonly reason: "patch_rejected";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The section 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";
@@ -766,11 +758,6 @@ 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;
@@ -787,46 +774,52 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
         }>;
         date: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>], "type">;
-    key: import("zod").ZodString;
-    value: import("zod").ZodOptional<import("zod").ZodUnknown>;
+    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>>;
 }, 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">;
+    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;
 }, 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: "`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 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: "note_missing";
     readonly thrownBy: "service";
@@ -857,6 +850,36 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "section_target_missing";
+    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 reason: "ambiguous_section";
+    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 thrownBy: "service";
+    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: "heading_outside_section";
+    readonly thrownBy: "service";
+    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: "patch_rejected";
+    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 reason: "path_is_directory";
     readonly thrownBy: "service";
@@ -981,82 +1004,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<{