obsidian-mcp-server 3.1.11 → 3.2.1

package/dist/mcp-server/tools/definitions/obsidian-patch-note.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"obsidian-patch-note.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-patch-note.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AASjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyH5B,CAAC"}
+{"version":3,"file":"obsidian-patch-note.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-patch-note.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AASjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgI5B,CAAC"}

package/dist/mcp-server/tools/definitions/obsidian-patch-note.tool.js

@@ -72,6 +72,12 @@ export const obsidianPatchNote = tool('obsidian_patch_note', {
             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.',
             recovery: 'Call obsidian_get_note with format document-map to discover the available targets.',
         },
+        {
+            reason: 'content_preexists',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The supplied content already appears at the target — the patch was rejected to keep retries idempotent (the default).',
+            recovery: 'Pass `patchOptions.applyIfContentPreexists: true` to force-apply over preexisting content, or change the content to something not already present.',
+        },
     ],
     async handler(input, ctx) {
         const svc = getObsidianService();

package/dist/mcp-server/tools/definitions/obsidian-patch-note.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"obsidian-patch-note.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-patch-note.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"obsidian-patch-note.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-patch-note.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/obsidian-search-notes.tool.d.ts

@@ -1,30 +1,39 @@
 /**
- * @fileoverview obsidian_search_notes — text/dataview/jsonlogic search.
- * Caps results at 100 hits and surfaces an `excluded` indicator when more
- * were returned upstream. Text-mode hits are additionally capped per file
- * via `maxMatchesPerHit` so a single match-heavy note can't blow the
- * response budget — clipped hits carry `truncated: true` and `totalMatches`.
+ * @fileoverview obsidian_search_notes — text/jsonlogic/omnisearch search with
+ * MCP-spec cursor pagination. The `omnisearch` mode is added conditionally by
+ * the entry point only when the Omnisearch plugin's HTTP server is reachable
+ * at startup. Text-mode hits additionally clip per file via `maxMatchesPerHit`
+ * so a single match-heavy note can't blow the response budget — clipped hits
+ * carry `truncated: true` and `totalMatches`.
  * @module mcp-server/tools/definitions/obsidian-search-notes.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
 import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
-export declare const obsidianSearchNotes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+/**
+ * Build the `obsidian_search_notes` tool. The `omnisearch` mode is included
+ * in the input/output schemas only when `omnisearchReachable` is true so the
+ * LLM never sees it as an option on a deployment where it can't run. Re-probe
+ * requires a server restart.
+ */
+export declare function buildSearchNotesTool({ omnisearchReachable }: {
+    omnisearchReachable: boolean;
+}): import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     mode: z.ZodEnum<{
         text: "text";
-        dataview: "dataview";
         jsonlogic: "jsonlogic";
+        omnisearch: "omnisearch";
     }>;
     query: z.ZodOptional<z.ZodString>;
     logic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     contextLength: z.ZodDefault<z.ZodNumber>;
     pathPrefix: z.ZodOptional<z.ZodString>;
     maxMatchesPerHit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     result: z.ZodDiscriminatedUnion<[z.ZodObject<{
         mode: z.ZodLiteral<"text">;
         hits: z.ZodArray<z.ZodObject<{
             filename: z.ZodString;
-            score: z.ZodOptional<z.ZodNumber>;
             matches: z.ZodArray<z.ZodObject<{
                 context: z.ZodString;
                 match: z.ZodObject<{
@@ -35,30 +44,167 @@ export declare const obsidianSearchNotes: import("@cyanheads/mcp-ts-core").ToolD
             totalMatches: z.ZodOptional<z.ZodNumber>;
             truncated: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
-        excluded: z.ZodOptional<z.ZodObject<{
-            count: z.ZodNumber;
-            hint: z.ZodString;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"jsonlogic">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            result: z.ZodUnknown;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"omnisearch">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            basename: z.ZodString;
+            score: z.ZodNumber;
+            foundWords: z.ZodArray<z.ZodString>;
+            matches: z.ZodArray<z.ZodObject<{
+                match: z.ZodString;
+                offset: z.ZodNumber;
+            }, z.core.$strip>>;
+            excerpt: z.ZodString;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>] | [z.ZodObject<{
+        mode: z.ZodLiteral<"text">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            matches: z.ZodArray<z.ZodObject<{
+                context: z.ZodString;
+                match: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            totalMatches: z.ZodOptional<z.ZodNumber>;
+            truncated: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
-        mode: z.ZodLiteral<"dataview">;
+        mode: z.ZodLiteral<"jsonlogic">;
         hits: z.ZodArray<z.ZodObject<{
             filename: z.ZodString;
             result: z.ZodUnknown;
         }, z.core.$strip>>;
-        excluded: z.ZodOptional<z.ZodObject<{
-            count: z.ZodNumber;
-            hint: z.ZodString;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "mode">;
+}, z.core.$strip>, readonly [{
+    readonly reason: "path_prefix_invalid_mode";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`pathPrefix` was provided in a non-text mode (only `text` supports prefix filtering).";
+    readonly recovery: "Drop pathPrefix or switch mode to text for prefix filtering.";
+}, {
+    readonly reason: "query_required";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`query` is missing for `text` or `omnisearch` mode (required for both).";
+    readonly recovery: "Pass `query` — substring for text mode, or BM25 query syntax (quoted phrases, `-exclusion`, `path:` / `ext:` filters) for omnisearch.";
+}, {
+    readonly reason: "logic_required";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`logic` is missing for `jsonlogic` mode.";
+    readonly recovery: "Pass a JSONLogic tree as `logic`, e.g. `{\"glob\": [{\"var\": \"path\"}, \"Projects/*.md\"]}`.";
+}, {
+    readonly reason: "omnisearch_unreachable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Omnisearch was reachable at startup but is now unreachable (Obsidian quit, plugin disabled, or mobile session).";
+    readonly retryable: true;
+    readonly recovery: "Restart Obsidian with the Omnisearch plugin enabled, then restart this MCP server so it re-probes the plugin URL.";
+}]>;
+/**
+ * Static specimen for the MCP definition linter (which duck-types tool
+ * exports out of each `.tool.ts` file) and for existing tests that import
+ * the tool directly. Defaults to `omnisearchReachable: false` — the safe
+ * baseline that doesn't assume the optional plugin is installed. The entry
+ * point (`src/index.ts`) builds the live tool via `buildSearchNotesTool`
+ * with the actual probe result; this export is not the registered tool.
+ * The omnisearch-enabled variant is exercised by tests rather than the
+ * linter (two exports under the same tool name would collide on
+ * `name-unique`).
+ */
+export declare const obsidianSearchNotes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    mode: z.ZodEnum<{
+        text: "text";
+        jsonlogic: "jsonlogic";
+        omnisearch: "omnisearch";
+    }>;
+    query: z.ZodOptional<z.ZodString>;
+    logic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    contextLength: z.ZodDefault<z.ZodNumber>;
+    pathPrefix: z.ZodOptional<z.ZodString>;
+    maxMatchesPerHit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"text">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            matches: z.ZodArray<z.ZodObject<{
+                context: z.ZodString;
+                match: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            totalMatches: z.ZodOptional<z.ZodNumber>;
+            truncated: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"jsonlogic">;
         hits: z.ZodArray<z.ZodObject<{
             filename: z.ZodString;
             result: z.ZodUnknown;
         }, z.core.$strip>>;
-        excluded: z.ZodOptional<z.ZodObject<{
-            count: z.ZodNumber;
-            hint: z.ZodString;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"omnisearch">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            basename: z.ZodString;
+            score: z.ZodNumber;
+            foundWords: z.ZodArray<z.ZodString>;
+            matches: z.ZodArray<z.ZodObject<{
+                match: z.ZodString;
+                offset: z.ZodNumber;
+            }, z.core.$strip>>;
+            excerpt: z.ZodString;
         }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>] | [z.ZodObject<{
+        mode: z.ZodLiteral<"text">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            matches: z.ZodArray<z.ZodObject<{
+                context: z.ZodString;
+                match: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            totalMatches: z.ZodOptional<z.ZodNumber>;
+            truncated: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"jsonlogic">;
+        hits: z.ZodArray<z.ZodObject<{
+            filename: z.ZodString;
+            result: z.ZodUnknown;
+        }, z.core.$strip>>;
+        totalCount: z.ZodNumber;
+        nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "mode">;
 }, z.core.$strip>, readonly [{
     readonly reason: "path_prefix_invalid_mode";
@@ -68,12 +214,18 @@ export declare const obsidianSearchNotes: import("@cyanheads/mcp-ts-core").ToolD
 }, {
     readonly reason: "query_required";
     readonly code: JsonRpcErrorCode.ValidationError;
-    readonly when: "`query` is missing for `text` or `dataview` mode (required for both).";
-    readonly recovery: "Pass `query` — search terms for text mode (e.g. \"TODO\"), or DQL like \"TABLE WHERE file.mtime > date(today)\" for dataview mode.";
+    readonly when: "`query` is missing for `text` or `omnisearch` mode (required for both).";
+    readonly recovery: "Pass `query` — substring for text mode, or BM25 query syntax (quoted phrases, `-exclusion`, `path:` / `ext:` filters) for omnisearch.";
 }, {
     readonly reason: "logic_required";
     readonly code: JsonRpcErrorCode.ValidationError;
     readonly when: "`logic` is missing for `jsonlogic` mode.";
     readonly recovery: "Pass a JSONLogic tree as `logic`, e.g. `{\"glob\": [{\"var\": \"path\"}, \"Projects/*.md\"]}`.";
+}, {
+    readonly reason: "omnisearch_unreachable";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Omnisearch was reachable at startup but is now unreachable (Obsidian quit, plugin disabled, or mobile session).";
+    readonly retryable: true;
+    readonly recovery: "Restart Obsidian with the Omnisearch plugin enabled, then restart this MCP server so it re-probes the plugin URL.";
 }]>;
 //# sourceMappingURL=obsidian-search-notes.tool.d.ts.map

package/dist/mcp-server/tools/definitions/obsidian-search-notes.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"obsidian-search-notes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-search-notes.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwDjE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2L9B,CAAC"}
+{"version":3,"file":"obsidian-search-notes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-search-notes.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsFjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,EAAE;IAAE,mBAAmB,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqR7F;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAuD,CAAC"}