obsidian-mcp-server 3.7.2 → 3.9.0

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

@@ -5,20 +5,22 @@
  * separately so the entry point wraps it with `disabledTool()` when either
  * `OBSIDIAN_ENABLE_COMMANDS=false` or `OBSIDIAN_READ_ONLY=true` — keeping this
  * 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.
+ * factory (`buildSearchNotesTool`) because its mode enum follows
+ * `omnisearchAvailability`, which the entry point decides at startup: the
+ * `omnisearch` mode is withheld under a read scope and otherwise offered only
+ * when the startup probe reaches the plugin.
  * `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';
+export { buildSearchNotesTool, type OmnisearchAvailability, omnisearchAvailability, } from './obsidian-search-notes.tool.js';
 /**
  * Tools that don't depend on runtime probes — always registered, even with
  * `OBSIDIAN_READ_ONLY=true`. `obsidian_search_notes` is constructed separately
  * in the entry point via `buildSearchNotesTool` so its mode enum can reflect
- * Omnisearch reachability.
+ * Omnisearch availability.
  *
  * `obsidian_open_in_ui` stays here rather than in the write bucket so that
  * opening a note that already exists keeps working on a read-only vault, which
@@ -113,8 +115,8 @@ 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 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 when: "The target path is outside OBSIDIAN_READ_PATHS (and OBSIDIAN_WRITE_PATHS, since write paths imply read access), or inside OBSIDIAN_DENY_PATHS.";
+    readonly recovery: "Use a path inside the configured read scope. The error data echoes the active scope; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -171,6 +173,35 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
 }], {
     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>;
@@ -215,8 +246,8 @@ 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 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 when: "The supplied `path` is outside OBSIDIAN_READ_PATHS and is not a folder on the way to it, or is inside OBSIDIAN_DENY_PATHS. 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; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "directory_missing";
     readonly thrownBy: "service";
@@ -231,35 +262,6 @@ 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>;
@@ -272,8 +274,8 @@ 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 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.";
+    readonly when: "The path is outside OBSIDIAN_READ_PATHS or inside OBSIDIAN_DENY_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; `op` on the error data names whether read or write access was the one denied. The error data echoes the active scope; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "note_missing";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
@@ -307,11 +309,6 @@ export declare const readToolDefinitions: (import("@cyanheads/mcp-ts-core").Tool
  * `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;
@@ -328,46 +325,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 inside OBSIDIAN_DENY_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; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -399,110 +402,41 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
     readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
-    readonly reason: "path_is_directory";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The supplied path names a folder rather than a note file.";
-    readonly recovery: "Call obsidian_list_notes with this path to list the folder, then retry with the full path of one of the files it returns.";
-}, {
-    readonly reason: "path_traversal";
-    readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
-    readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
-}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
-    target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"path">;
-        path: import("zod").ZodString;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"active">;
-    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"periodic">;
-        period: import("zod").ZodEnum<{
-            daily: "daily";
-            monthly: "monthly";
-            quarterly: "quarterly";
-            weekly: "weekly";
-            yearly: "yearly";
-        }>;
-        date: import("zod").ZodOptional<import("zod").ZodString>;
-    }, import("zod/v4/core").$strip>], "type">;
-    scope: import("zod").ZodDefault<import("zod").ZodEnum<{
-        body: "body";
-        both: "both";
-        frontmatter: "frontmatter";
-    }>>;
-    replacements: import("zod").ZodArray<import("zod").ZodObject<{
-        search: import("zod").ZodString;
-        replace: import("zod").ZodString;
-        useRegex: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        caseSensitive: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        wholeWord: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        flexibleWhitespace: import("zod").ZodDefault<import("zod").ZodBoolean>;
-        replaceAll: import("zod").ZodDefault<import("zod").ZodBoolean>;
-    }, import("zod/v4/core").$strip>>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-    path: import("zod").ZodString;
-    totalReplacements: import("zod").ZodNumber;
-    perReplacement: import("zod").ZodArray<import("zod").ZodObject<{
-        search: import("zod").ZodString;
-        count: import("zod").ZodNumber;
-        bodyCount: import("zod").ZodNumber;
-        frontmatterCount: import("zod").ZodNumber;
-    }, import("zod/v4/core").$strip>>;
-    previousSizeInBytes: import("zod").ZodNumber;
-    currentSizeInBytes: import("zod").ZodNumber;
-}, import("zod/v4/core").$strip>, readonly [{
-    readonly reason: "path_forbidden";
+    readonly reason: "section_target_missing";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
-    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS, or OBSIDIAN_READ_ONLY=true denies all writes. The pre-read also requires the path to be readable.";
-    readonly recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
-}, {
-    readonly reason: "regex_invalid";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "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 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: "note_missing";
+    readonly reason: "ambiguous_section";
     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 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: "no_active_file";
+    readonly reason: "content_preexists";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `active` but no file is currently open in Obsidian.";
-    readonly recovery: "Call obsidian_open_in_ui to focus a file, or pass an explicit path target instead.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The supplied content already appears at the target — the patch was rejected to keep retries idempotent (the default).";
+    readonly recovery: "Pass `patchOptions.applyIfContentPreexists: true` to force-apply over preexisting content, or change the content to something not already present.";
 }, {
-    readonly reason: "periodic_unsupported";
+    readonly reason: "heading_outside_section";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic` and this vault runs Local REST API v5.0.2 or later without the companion periodic-notes extension, so the `/periodic/` routes are not served at all.";
-    readonly recovery: "Install the periodic-notes extension from https://github.com/coddingtonbear/obsidian-local-rest-api-periodic-notes, or address the note by an explicit vault path.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "On Local REST API v5.0 and later, the content of a heading write carries a heading at or above the target section’s own level, which would have to sit outside the section.";
+    readonly recovery: "Append the heading at the parent section or at the end of the note with obsidian_append_to_note, or write it one level below the target section or deeper.";
 }, {
-    readonly reason: "periodic_not_found";
+    readonly reason: "repeated_link_definition";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
-    readonly when: "Target was `periodic`, the `/periodic/` routes are served on this vault, and no note exists for the requested period.";
-    readonly recovery: "Create the periodic note first or pass an explicit path target.";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "A link reference definition that repeats a label defined earlier in the note sits above where the target heading’s section ends (for the last section, above its heading); the Local REST API’s markdown parser drops it and misplaces every heading below it, so the write would land outside the section.";
+    readonly recovery: "Use obsidian_replace_in_note to place the content directly, or to remove or rename the repeated definition at `line`, then retry the section write.";
 }, {
-    readonly reason: "periodic_disabled";
+    readonly reason: "patch_rejected";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
-    readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
+    readonly when: "The target exists but the plugin refused the content for it — table rows for a block that is not a table, a row with the wrong cell count, a frontmatter value that cannot merge, or content of the wrong shape.";
+    readonly recovery: "Read the target with obsidian_get_note format section, then send content that fits it — rows matching the table columns, or a value of the field’s own type.";
 }, {
     readonly reason: "path_is_directory";
     readonly thrownBy: "service";
@@ -567,8 +501,8 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "The target path is outside OBSIDIAN_WRITE_PATHS or inside OBSIDIAN_DENY_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; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -617,6 +551,12 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
     readonly when: "On Local REST API v5.0 and later, the new body of a heading section 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 with obsidian_append_to_note, or write it one level below the target section or deeper.";
+}, {
+    readonly reason: "repeated_link_definition";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "A link reference definition that repeats a label defined earlier in the note sits above where the target heading’s section ends (for the last section, above its heading); the Local REST API’s markdown parser drops it and misplaces every heading below it, so the replacement would land outside the section.";
+    readonly recovery: "Use obsidian_replace_in_note to place the new body directly, or to remove or rename the repeated definition at `line`, then retry the section write.";
 }, {
     readonly reason: "patch_rejected";
     readonly thrownBy: "service";
@@ -683,8 +623,8 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "The target path is outside OBSIDIAN_WRITE_PATHS or inside OBSIDIAN_DENY_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; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "note_missing";
     readonly thrownBy: "service";
@@ -739,6 +679,12 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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: "repeated_link_definition";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "A link reference definition that repeats a label defined earlier in the note sits above where the target heading’s section ends (for the last section, above its heading); the Local REST API’s markdown parser drops it and misplaces every heading below it, so the append would land outside the section.";
+    readonly recovery: "Use obsidian_replace_in_note to place the content directly, or to remove or rename the repeated definition at `line`, then retry the section append.";
 }, {
     readonly reason: "patch_rejected";
     readonly thrownBy: "service";
@@ -774,52 +720,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 recovery: "Use a path inside the configured write scope. The error data echoes the active scope.";
+    readonly when: "The target path is outside OBSIDIAN_WRITE_PATHS or inside OBSIDIAN_DENY_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; a `denied_path` denial carries none, since the operator withholds that path.";
+}, {
+    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";
@@ -851,35 +797,109 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
     readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
-    readonly reason: "section_target_missing";
+    readonly reason: "path_is_directory";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The named heading/block/frontmatter field does not exist in the note. Use `obsidian_get_note` with `format: \"document-map\"` to discover available targets.";
-    readonly recovery: "Call obsidian_get_note with format document-map to discover the available targets.";
+    readonly when: "The supplied path names a folder rather than a note file.";
+    readonly recovery: "Call obsidian_list_notes with this path to list the folder, then retry with the full path of one of the files it returns.";
 }, {
-    readonly reason: "ambiguous_section";
+    readonly reason: "path_traversal";
     readonly thrownBy: "service";
-    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
-    readonly when: "A bare heading leaf name matches more than one heading in the note, or the resolved full heading path occurs more than once, so the write target is undetermined.";
-    readonly recovery: "Retry with a distinct full Parent::Child heading path from `candidates` on the error data; when every candidate is the same path, rename the repeated headings first.";
-}, {
-    readonly reason: "content_preexists";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
+    readonly when: "The path contains a `.` or `..` segment, which is rejected to prevent vault escape.";
+    readonly recovery: "Supply a vault-relative path with no `.` or `..` segments, e.g. \"Projects/Note.md\". Use obsidian_list_notes to browse the vault.";
+}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    operation: import("zod").ZodEnum<{
+        delete: "delete";
+        get: "get";
+        set: "set";
+    }>;
+    target: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"path">;
+        path: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"active">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"periodic">;
+        period: import("zod").ZodEnum<{
+            daily: "daily";
+            monthly: "monthly";
+            quarterly: "quarterly";
+            weekly: "weekly";
+            yearly: "yearly";
+        }>;
+        date: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>], "type">;
+    key: import("zod").ZodString;
+    value: import("zod").ZodOptional<import("zod").ZodUnknown>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    result: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"get">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        exists: import("zod").ZodBoolean;
+        value: import("zod").ZodUnknown;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"set">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        previousSizeInBytes: import("zod").ZodNumber;
+        currentSizeInBytes: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        operation: import("zod").ZodLiteral<"delete">;
+        path: import("zod").ZodString;
+        key: import("zod").ZodString;
+        frontmatter: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+        previousSizeInBytes: import("zod").ZodNumber;
+        currentSizeInBytes: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>], "operation">;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "path_forbidden";
     readonly 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. A path inside OBSIDIAN_DENY_PATHS is neither.";
+    readonly recovery: "Use a path inside the configured scope. The error data echoes the active scope; a `denied_path` denial carries none, since the operator withholds that path.";
+}, {
+    readonly reason: "value_required";
     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: "`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: "heading_outside_section";
-    readonly thrownBy: "service";
+    readonly reason: "frontmatter_invalid";
     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: "`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: "patch_rejected";
+    readonly reason: "note_missing";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "The vault path does not resolve to an existing note.";
+    readonly recovery: "Verify the path with obsidian_list_notes or use obsidian_search_notes to locate the note.";
+}, {
+    readonly reason: "no_active_file";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `active` but no file is currently open in Obsidian.";
+    readonly recovery: "Call obsidian_open_in_ui to focus a file, or pass an explicit path target instead.";
+}, {
+    readonly reason: "periodic_unsupported";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `periodic` and this vault runs Local REST API v5.0.2 or later without the companion periodic-notes extension, so the `/periodic/` routes are not served at all.";
+    readonly recovery: "Install the periodic-notes extension from https://github.com/coddingtonbear/obsidian-local-rest-api-periodic-notes, or address the note by an explicit vault path.";
+}, {
+    readonly reason: "periodic_not_found";
+    readonly thrownBy: "service";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `periodic`, the `/periodic/` routes are served on this vault, and no note exists for the requested period.";
+    readonly recovery: "Create the periodic note first or pass an explicit path target.";
+}, {
+    readonly reason: "periodic_disabled";
     readonly thrownBy: "service";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
-    readonly when: "The target exists but the plugin refused the content for it — table rows for a block that is not a table, a row with the wrong cell count, a frontmatter value that cannot merge, or content of the wrong shape.";
-    readonly recovery: "Read the target with obsidian_get_note format section, then send content that fits it — rows matching the table columns, or a value of the field’s own type.";
+    readonly when: "Target was `periodic` but the requested period is not enabled in Obsidian's Periodic Notes plugin settings.";
+    readonly recovery: "Pass an explicit path target — the requested period is disabled in the operator's Periodic Notes plugin.";
 }, {
     readonly reason: "path_is_directory";
     readonly thrownBy: "service";
@@ -950,8 +970,8 @@ export declare const writeToolDefinitions: (import("@cyanheads/mcp-ts-core").Too
     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.";
+    readonly when: "`list` requires the path to be readable; `add`/`remove` require it to be inside OBSIDIAN_WRITE_PATHS, with OBSIDIAN_READ_ONLY=false. A path inside OBSIDIAN_DENY_PATHS is neither.";
+    readonly recovery: "Use a path inside the configured scope. The error data echoes the active scope; a `denied_path` denial carries none, since the operator withholds that path.";
 }, {
     readonly reason: "tags_required";
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;