@bitbonsai/mcpvault 0.12.2 → 0.12.4

package/dist/src/createServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../../src/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAoZzF"}
+{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../../src/createServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA0azF"}

package/dist/src/createServer.js

@@ -4,6 +4,7 @@ import { FileSystemService } from "./filesystem.js";
 import { FrontmatterHandler, parseFrontmatter } from "./frontmatter.js";
 import { PathFilter } from "./pathfilter.js";
 import { SearchService } from "./search.js";
+import { handleWikiLinkTool } from "./wikilink/index.js";
 import { resolve } from "path";
 export function createServer(vaultPath, options = {}) {
     const { name = "mcpvault", version = "0.0.0", pathFilter = new PathFilter(), frontmatterHandler = new FrontmatterHandler(), } = options;
@@ -210,6 +211,25 @@ export function createServer(vaultPath, options = {}) {
                             prettyPrint: { type: "boolean", description: "Format JSON response with indentation (default: false)", default: false }
                         }
                     }
+                },
+                {
+                    name: "wiki_link",
+                    description: "Read an Obsidian wiki link. Accepts the same syntax as Obsidian: [[Document Name]] or [[Document Name|Display Text]], including table-authored escapes like [[Document Name\\|Display]] and path-qualified links like [[folder/Document Name]]. A #fragment suffix in the input is ignored. Searches the vault for an exact basename match (or exact vault-relative path match when the name contains '/') and returns the file's content. When multiple files share the basename, picks the first (vault root first, then alphabetical by path) and lists the other paths in structuredContent.alternatives. Content is returned bare — ready for direct use in context.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            document: {
+                                type: "string",
+                                description: "The document name — what goes inside [[ ]]. e.g. 'My-Document'. Brackets and display text (|...) are stripped if present. The .md extension is always appended (never include it)."
+                            },
+                            prettyPrint: {
+                                type: "boolean",
+                                description: "Format JSON response with indentation (default: false)",
+                                default: false
+                            }
+                        },
+                        required: ["document"]
+                    }
                 }
             ]
         };
@@ -372,6 +392,8 @@ export function createServer(vaultPath, options = {}) {
                         content: [{ type: "text", text: JSON.stringify(tags, null, indent) }]
                     };
                 }
+                case "wiki_link":
+                    return await handleWikiLinkTool(fileSystem, trimmedArgs);
                 default:
                     throw new Error(`Unknown tool: ${toolName}`);
             }

package/dist/src/filesystem.d.ts

@@ -37,6 +37,22 @@ export declare class FileSystemService {
     getNotesInfo(paths: string[]): Promise<NoteInfo[]>;
     manageTags(params: TagManagementParams): Promise<TagManagementResult>;
     getVaultPath(): string;
+    /**
+     * Resolve an Obsidian wiki link name to its vault-relative paths.
+     * Scans the vault for exact filename matches (name + .md).
+     *
+     * A name containing `/` is path-qualified (Obsidian emits these when a
+     * basename is ambiguous, e.g. [[folder/Note]]): it must match the full
+     * vault-relative path instead of just the basename.
+     *
+     * Returns all matches sorted root-first (by path depth ascending), with
+     * alphabetical tiebreak at equal depth. Empty array on zero matches.
+     * The caller decides how to handle zero/single/multi — this function does
+     * not throw on lookup outcomes.
+     *
+     * Throws only on caller misuse (empty name).
+     */
+    findPathForWikiLink(wikiLinkName: string): Promise<string[]>;
     getVaultStats(recentCount?: number): Promise<VaultStats>;
     listAllTags(): Promise<Array<{
         tag: string;

package/dist/src/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystem.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzT;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAiBtE;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,UAAU,CAAa;gBAGrB,SAAS,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAazC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,WAAW;IAkDb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC3C,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4EjD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA8F5D,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8D3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB3C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2G3D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAsFrD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAiIrD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDpE,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCjE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4ClD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuG3E,YAAY,IAAI,MAAM;IAIhB,aAAa,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAyD3D,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkDpE"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/filesystem.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzT;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAiBtE;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,SAAS;IAJnB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,UAAU,CAAa;gBAGrB,SAAS,EAAE,MAAM,EACzB,UAAU,CAAC,EAAE,UAAU,EACvB,kBAAkB,CAAC,EAAE,kBAAkB;IAazC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,WAAW;IAkDb,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC3C,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4EjD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA8F5D,aAAa,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8D3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB3C,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2G3D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAsFrD,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAiIrD,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDpE,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCjE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4ClD,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuG3E,YAAY,IAAI,MAAM;IAItB;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiD5D,aAAa,CAAC,WAAW,GAAE,MAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAyD3D,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkDpE"}

package/dist/src/filesystem.js

@@ -891,6 +891,61 @@ export class FileSystemService {
     getVaultPath() {
         return this.vaultPath;
     }
+    /**
+     * Resolve an Obsidian wiki link name to its vault-relative paths.
+     * Scans the vault for exact filename matches (name + .md).
+     *
+     * A name containing `/` is path-qualified (Obsidian emits these when a
+     * basename is ambiguous, e.g. [[folder/Note]]): it must match the full
+     * vault-relative path instead of just the basename.
+     *
+     * Returns all matches sorted root-first (by path depth ascending), with
+     * alphabetical tiebreak at equal depth. Empty array on zero matches.
+     * The caller decides how to handle zero/single/multi — this function does
+     * not throw on lookup outcomes.
+     *
+     * Throws only on caller misuse (empty name).
+     */
+    async findPathForWikiLink(wikiLinkName) {
+        if (!wikiLinkName.trim()) {
+            throw new Error('Empty wiki link — provide a document name inside [[ ]].');
+        }
+        const normalizedName = `${wikiLinkName}.md`;
+        const isPathQualified = wikiLinkName.includes('/');
+        const matches = [];
+        const scan = async (dirPath, relativePath = '') => {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const entryRelativePath = relativePath
+                    ? `${relativePath}/${entry.name}`
+                    : entry.name;
+                if (!this.pathFilter.isAllowed(entryRelativePath)) {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    if (!this.pathFilter.isAllowed(`${entryRelativePath}/test.md`)) {
+                        continue;
+                    }
+                    await scan(join(dirPath, entry.name), entryRelativePath);
+                }
+                else if (entry.isFile() &&
+                    (isPathQualified
+                        ? entryRelativePath === normalizedName
+                        : entry.name === normalizedName)) {
+                    matches.push(entryRelativePath);
+                }
+            }
+        };
+        await scan(this.vaultPath);
+        // Depth-ascending (root-first), alphabetical tiebreak at equal depth.
+        // No current-folder context exists for a standalone MCP tool.
+        matches.sort((a, b) => {
+            const da = a.split('/').length;
+            const db = b.split('/').length;
+            return da !== db ? da - db : a.localeCompare(b);
+        });
+        return matches;
+    }
     async getVaultStats(recentCount = 5) {
         let totalNotes = 0;
         let totalFolders = 0;

package/dist/src/pathfilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pathfilter.d.ts","sourceRoot":"","sources":["../../src/pathfilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,UAAU;IAOrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAMxC;IAEH,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAuB9C,OAAO,CAAC,eAAe;IAoBvB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAQ5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY1C,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,MAAM;IA0Bd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGvC"}
+{"version":3,"file":"pathfilter.d.ts","sourceRoot":"","sources":["../../src/pathfilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,UAAU;IAOrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAMxC;IAEH,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,iBAAiB,CAAW;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAyB9C,OAAO,CAAC,eAAe;IAoBvB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAQ5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAyBhC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY1C,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,MAAM;IA0Bd,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAGvC"}

package/dist/src/pathfilter.js

@@ -20,6 +20,8 @@ export class PathFilter {
             '.obsidian/**',
             '.git',
             '.git/**',
+            '.trash',
+            '.trash/**',
             'node_modules',
             'node_modules/**',
             '.DS_Store',

package/dist/src/wikilink/index.d.ts

@@ -0,0 +1,5 @@
+export { parseWikiLink } from './resolveWikiLink.js';
+export { handleWikiLinkTool } from './wikiLinkTool.js';
+export type { ParsedWikiLink } from './resolveWikiLink.js';
+export type { WikiLinkToolArgs } from './wikiLinkTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/wikilink/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wikilink/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/wikilink/index.js

@@ -0,0 +1,2 @@
+export { parseWikiLink } from './resolveWikiLink.js';
+export { handleWikiLinkTool } from './wikiLinkTool.js';

package/dist/src/wikilink/resolveWikiLink.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The parsed components of an Obsidian wiki link.
+ *
+ * @example
+ * parseWikiLink('[[Doc Name#Heading|Display]]')
+ * // { document: 'Doc Name' }
+ */
+export interface ParsedWikiLink {
+    /**
+     * The document name as it appears inside [[ ]] — without brackets,
+     * without display text, without any `#fragment` suffix.
+     * Append `.md` to get the filesystem filename.
+     */
+    document: string;
+}
+/**
+ * Parse an Obsidian wiki link string into its components.
+ *
+ * Handles all wiki link forms:
+ * - `[[Document Name]]`
+ * - `[[Document Name|Display Text]]`
+ * - `[[Document Name\|Display]]` — table-authored escape; `\|` unescapes to `|`
+ * - Bare names without brackets (backslashes preserved as-is)
+ *
+ * A `#Heading` or `#^block-id` suffix is accepted but ignored: the fragment
+ * is stripped and only the document name is returned.
+ *
+ * Throws on malformed input: if the parsed `document` still contains a
+ * literal `\` after processing, the input is rejected rather than
+ * heuristically interpreted.
+ *
+ * @param wikiLinkText - The raw wiki link string, with or without brackets
+ * @returns The parsed basename
+ * @throws Error when parsed components contain an unexpected backslash
+ *
+ * @see {@link ParsedWikiLink}
+ */
+export declare const parseWikiLink: (wikiLinkText: string) => ParsedWikiLink;
+//# sourceMappingURL=resolveWikiLink.d.ts.map

package/dist/src/wikilink/resolveWikiLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWikiLink.d.ts","sourceRoot":"","sources":["../../../src/wikilink/resolveWikiLink.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,GACxB,cAAc,MAAM,KACnB,cAmCF,CAAC"}

package/dist/src/wikilink/resolveWikiLink.js

@@ -0,0 +1,50 @@
+/**
+ * Parse an Obsidian wiki link string into its components.
+ *
+ * Handles all wiki link forms:
+ * - `[[Document Name]]`
+ * - `[[Document Name|Display Text]]`
+ * - `[[Document Name\|Display]]` — table-authored escape; `\|` unescapes to `|`
+ * - Bare names without brackets (backslashes preserved as-is)
+ *
+ * A `#Heading` or `#^block-id` suffix is accepted but ignored: the fragment
+ * is stripped and only the document name is returned.
+ *
+ * Throws on malformed input: if the parsed `document` still contains a
+ * literal `\` after processing, the input is rejected rather than
+ * heuristically interpreted.
+ *
+ * @param wikiLinkText - The raw wiki link string, with or without brackets
+ * @returns The parsed basename
+ * @throws Error when parsed components contain an unexpected backslash
+ *
+ * @see {@link ParsedWikiLink}
+ */
+export const parseWikiLink = (wikiLinkText) => {
+    let text = wikiLinkText.trim();
+    const wasBracketed = text.startsWith('[[');
+    if (wasBracketed) {
+        text = text.slice(2);
+    }
+    if (text.endsWith(']]')) {
+        text = text.slice(0, -2);
+    }
+    // Inside [[ ]] only: unescape Obsidian's table-authoring artifact `\|` → `|`.
+    // Pipe is a reserved grammar character, so `\|` is unambiguous there.
+    if (wasBracketed) {
+        text = text.replace(/\\\|/g, '|');
+    }
+    // Strip |display text if present
+    const pipeIndex = text.indexOf('|');
+    if (pipeIndex !== -1) {
+        text = text.slice(0, pipeIndex);
+    }
+    // Strip and ignore any #fragment suffix
+    const hashIndex = text.indexOf('#');
+    const rest = hashIndex !== -1 ? text.slice(hashIndex + 1) : '';
+    const document = (hashIndex !== -1 ? text.slice(0, hashIndex) : text).trim();
+    if (document.includes('\\') || rest.includes('\\')) {
+        throw new Error(`Invalid wiki-link syntax: unexpected backslash in [[${wikiLinkText}]]. Only \\| inside [[ ]] is a recognized escape.`);
+    }
+    return { document };
+};

package/dist/src/wikilink/wikiLinkTool.d.ts

@@ -0,0 +1,21 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FileSystemService } from '../filesystem.js';
+export interface WikiLinkToolArgs {
+    document: string;
+    prettyPrint?: boolean;
+}
+/**
+ * Handle the `wiki_link` MCP tool call.
+ *
+ * Resolves an Obsidian wiki-link reference against the vault and returns the
+ * matching note. Designed to keep the MCP server request handler slim — all
+ * wiki-link specific concerns live here.
+ *
+ * Response channels per MCP spec 2025-11-25:
+ * - Invalid syntax or no match → `isError: true` with an actionable message.
+ * - One or more matches → success; `structuredContent` carries `document`,
+ *   `path` (the resolved pick), and `alternatives` (the other matched paths,
+ *   present only when more than one file shares the basename).
+ */
+export declare function handleWikiLinkTool(fileSystem: FileSystemService, args: WikiLinkToolArgs): Promise<CallToolResult>;
+//# sourceMappingURL=wikiLinkTool.d.ts.map

package/dist/src/wikilink/wikiLinkTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikiLinkTool.d.ts","sourceRoot":"","sources":["../../../src/wikilink/wikiLinkTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,cAAc,CAAC,CAiDzB"}

package/dist/src/wikilink/wikiLinkTool.js

@@ -0,0 +1,60 @@
+import { parseWikiLink } from './resolveWikiLink.js';
+/**
+ * Handle the `wiki_link` MCP tool call.
+ *
+ * Resolves an Obsidian wiki-link reference against the vault and returns the
+ * matching note. Designed to keep the MCP server request handler slim — all
+ * wiki-link specific concerns live here.
+ *
+ * Response channels per MCP spec 2025-11-25:
+ * - Invalid syntax or no match → `isError: true` with an actionable message.
+ * - One or more matches → success; `structuredContent` carries `document`,
+ *   `path` (the resolved pick), and `alternatives` (the other matched paths,
+ *   present only when more than one file shares the basename).
+ */
+export async function handleWikiLinkTool(fileSystem, args) {
+    const indent = args.prettyPrint ? 2 : undefined;
+    let parsed;
+    try {
+        parsed = parseWikiLink(args.document);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Invalid wiki-link syntax';
+        return {
+            content: [{ type: 'text', text: message }],
+            structuredContent: { rawInput: args.document },
+            isError: true,
+        };
+    }
+    const paths = await fileSystem.findPathForWikiLink(parsed.document);
+    if (paths.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No file found for [[${parsed.document}]]. Use search_notes or list_directory to find the correct name.`,
+                }],
+            structuredContent: {
+                document: parsed.document,
+            },
+            isError: true,
+        };
+    }
+    const resolvedPath = paths[0];
+    const alternatives = paths.slice(1);
+    const note = await fileSystem.readNote(resolvedPath);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    path: resolvedPath,
+                    fm: note.frontmatter,
+                    content: note.content,
+                }, null, indent),
+            }],
+        structuredContent: {
+            document: parsed.document,
+            path: resolvedPath,
+            ...(alternatives.length > 0 && { alternatives }),
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbonsai/mcpvault",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "description": "Universal AI bridge for Obsidian vaults - connect any MCP-compatible assistant",
   "homepage": "https://mcpvault.org",
   "author": "bitbonsai",