obsidian-mcp-server 3.5.3 → 3.5.5

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

@@ -107,36 +107,43 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly recovery: "Pass `section: { type, target }` (e.g. `{ type: \"heading\", target: \"Intro\" }`), or use `format: \"full\"` / `\"document-map\"` instead.";
 }, {
     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_READ_PATHS (and OBSIDIAN_WRITE_PATHS, since write paths imply read access).";
     readonly recovery: "Use a path inside the configured read scope. The error data echoes the active scope.";
 }, {
     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: "ambiguous_path";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
     readonly when: "The parent directory contains multiple files whose names differ only in case (case-sensitive filesystems only).";
     readonly recovery: "Retry with one of the exact paths listed in `matches` on the error data.";
 }, {
     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: "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.";
@@ -147,11 +154,13 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly recovery: "Call obsidian_get_note with format \"document-map\" to list available headings, blocks, and frontmatter fields, then retry with one of those locators.";
 }, {
     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.";
@@ -228,16 +237,19 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly recovery: "Avoid nested quantifiers like `(a+)+` or `(.*)*`. Use a simpler pattern (e.g. `^Project.*\\.md$`), or omit nameRegex to disable filtering.";
 }, {
     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 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";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly when: "No listable directory at the supplied `path` — either it does not exist, or it exists and currently holds no files. Sub-directories that disappear mid-walk are silently skipped, so only the root path surfaces this error.";
     readonly recovery: "List the parent directory to check the spelling and casing. A folder that exists but holds no files reports the same way, since the Local REST API omits empty folders from its listings — add a file to it, or confirm from the parent that the folder is there.";
 }, {
     readonly reason: "path_is_file";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "The supplied `path` names a file rather than a directory.";
     readonly recovery: "Read the file with obsidian_get_note instead, or list its parent directory to browse alongside it.";
@@ -253,6 +265,7 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     createdIfMissing: import("zod").ZodBoolean;
 }, 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 path is outside OBSIDIAN_READ_PATHS, or — when the file does not exist and `failIfMissing: false` would have Obsidian create it — outside OBSIDIAN_WRITE_PATHS or blocked by OBSIDIAN_READ_ONLY=true.";
     readonly recovery: "Open a path inside the configured scope. The error data echoes the active scope and whether read or write access was the one denied.";
@@ -263,16 +276,19 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
     readonly recovery: "Verify the path with obsidian_list_notes or obsidian_search_notes first — a typo would otherwise materialize as an empty file. If creation is intended, retry with failIfMissing: false.";
 }, {
     readonly reason: "ambiguous_path";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
     readonly when: "The parent directory contains multiple files whose names differ only in case (case-sensitive filesystems only).";
     readonly recovery: "Retry with one of the exact paths listed in `matches` on the error data.";
 }, {
     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 file.";
     readonly recovery: "Call obsidian_list_notes with this path to list the folder, then open 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.";
@@ -295,98 +311,90 @@ 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<{
+    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>;
-    operation: import("zod").ZodEnum<{
-        append: "append";
-        prepend: "prepend";
-        replace: "replace";
-    }>;
-    content: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
     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>>;
+    createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, 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";
-    }>;
+    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: "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: "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";
     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: "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 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, so the write target is undetermined.";
-    readonly recovery: "Retry with one of the full Parent::Child heading paths listed in `candidates` on the error data.";
+    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: "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: "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: "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.";
@@ -407,79 +415,109 @@ 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<{
+    section: import("zod").ZodObject<{
         type: import("zod").ZodEnum<{
             block: "block";
             frontmatter: "frontmatter";
             heading: "heading";
         }>;
         target: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>>;
+    }, 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";
     }>>;
-    overwrite: 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;
-    sectionTargeted: import("zod").ZodBoolean;
-    sectionTarget: import("zod").ZodOptional<import("zod").ZodString>;
-    created: import("zod").ZodBoolean;
+    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: "file_exists";
-    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: "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: "note_missing";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Section replace 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 write (which creates the note when it is absent).";
+    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: "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.";
+    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, so the replacement target is undetermined.";
-    readonly recovery: "Retry with one of the full Parent::Child heading paths listed in `candidates` on the error data.";
+    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: "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.";
@@ -513,7 +551,7 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
         json: "json";
         markdown: "markdown";
     }>>;
-    createTargetIfMissing: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    overwrite: import("zod").ZodDefault<import("zod").ZodBoolean>;
 }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
     path: import("zod").ZodString;
     sectionTargeted: import("zod").ZodBoolean;
@@ -522,57 +560,67 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     previousSizeInBytes: import("zod").ZodNumber;
     currentSizeInBytes: import("zod").ZodNumber;
 }, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "file_exists";
+    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: "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: "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: "Section replace 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 write (which creates the note when it is absent).";
 }, {
     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: "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 recovery: "Call obsidian_get_note with format document-map to discover 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, so the append target is undetermined.";
-    readonly recovery: "Retry with one of the full Parent::Child heading paths listed in `candidates` on the error data.";
-}, {
-    readonly reason: "content_preexists";
-    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 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 replacement 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: "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.";
@@ -620,8 +668,9 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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. 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";
@@ -636,40 +685,47 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
 }, {
     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. 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 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: "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.";
@@ -721,6 +777,7 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     }, 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: "`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.";
@@ -729,38 +786,50 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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 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: "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.";
@@ -820,6 +889,7 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     }, 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: "`list` requires the path to be readable; `add`/`remove` 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.";
@@ -828,38 +898,50 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "`operation` is \"add\" or \"remove\" but `tags` was empty or omitted.";
     readonly recovery: "Pass a non-empty `tags` array (without `#`), e.g. `[\"draft\", \"wip\"]`.";
+}, {
+    readonly reason: "frontmatter_invalid";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "`location` reaches the frontmatter and the note's existing block does not parse as a mapping of properties, or the tag change would leave YAML that cannot be re-emitted. Nothing is written — the note keeps its original bytes, and under `location: \"both\"` the inline half is skipped too rather than applied on its own.";
+    readonly recovery: "Use `location: \"inline\"` to tag the body without touching the block, or repair the YAML between the `---` fences and retry.";
 }, {
     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: "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.";
@@ -887,6 +969,7 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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.";
@@ -894,39 +977,47 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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.";
@@ -959,6 +1050,7 @@ export declare const commandToolDefinitions: (import("@cyanheads/mcp-ts-core").T
     executed: import("zod").ZodBoolean;
 }, import("zod/v4/core").$strip>, readonly [{
     readonly reason: "command_unknown";
+    readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly when: "The supplied `commandId` is not registered in Obsidian. Use `obsidian_list_commands` to discover valid IDs.";
     readonly recovery: "Call obsidian_list_commands to discover the registered command IDs.";