obsidian-mcp-server 2.0.7 → 3.1.0

package/dist/mcp-server/tools/definitions/obsidian-manage-frontmatter.tool.js

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview obsidian_manage_frontmatter — atomic get/set/delete on a single
+ * frontmatter key. `set` PATCHes the field; `delete` reads-modifies-writes the
+ * file because PATCH has no `delete` operation.
+ * @module mcp-server/tools/definitions/obsidian-manage-frontmatter.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { deleteFrontmatterKey } from '../../../services/obsidian/frontmatter-ops.js';
+import { getObsidianService } from '../../../services/obsidian/obsidian-service.js';
+import { TargetSchema } from './_shared/schemas.js';
+export const obsidianManageFrontmatter = tool('obsidian_manage_frontmatter', {
+    description: 'Atomic `get` / `set` / `delete` on a single frontmatter key. `set` requires `value` (any JSON-typed value: string, number, boolean, array, or object).',
+    annotations: { destructiveHint: true },
+    input: z.object({
+        operation: z
+            .enum(['get', 'set', 'delete'])
+            .describe('Which mutation/read to perform on the key.'),
+        target: TargetSchema.describe('Where the note lives.'),
+        key: z.string().min(1).describe('Frontmatter field name.'),
+        value: z
+            .unknown()
+            .optional()
+            .describe('Required when `operation` is `"set"`. JSON-typed value to write — strings, numbers, booleans, arrays, and objects all accepted.'),
+    }),
+    output: z.object({
+        result: z
+            .discriminatedUnion('operation', [
+            z
+                .object({
+                operation: z.literal('get').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                key: z.string().describe('Echoed frontmatter key.'),
+                exists: z.boolean().describe('True when the key was present in the frontmatter.'),
+                value: z.unknown().describe('Current value, or `null` when the key is absent.'),
+            })
+                .describe('Result for `get`.'),
+            z
+                .object({
+                operation: z.literal('set').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                key: z.string().describe('Echoed frontmatter key.'),
+                frontmatter: z
+                    .record(z.string(), z.unknown())
+                    .describe('Full frontmatter after the change.'),
+            })
+                .describe('Result for `set`.'),
+            z
+                .object({
+                operation: z.literal('delete').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                key: z.string().describe('Echoed frontmatter key.'),
+                frontmatter: z
+                    .record(z.string(), z.unknown())
+                    .describe('Full frontmatter after the change.'),
+            })
+                .describe('Result for `delete`.'),
+        ])
+            .describe('Operation-discriminated result payload.'),
+    }),
+    auth: ['tool:obsidian_manage_frontmatter:write'],
+    errors: [
+        {
+            reason: 'value_required',
+            code: JsonRpcErrorCode.ValidationError,
+            when: '`operation` is "set" but no `value` was supplied.',
+        },
+        {
+            reason: 'note_missing',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The vault path does not resolve to an existing note.',
+        },
+        {
+            reason: 'no_active_file',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Target was `active` but no file is currently open in Obsidian.',
+        },
+        {
+            reason: 'periodic_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Target was `periodic` but no matching periodic note exists.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        const { target } = input;
+        if (input.operation === 'get') {
+            const note = await svc.getNoteJson(ctx, target);
+            const exists = input.key in note.frontmatter;
+            return {
+                result: {
+                    operation: 'get',
+                    path: note.path,
+                    key: input.key,
+                    exists,
+                    value: exists ? note.frontmatter[input.key] : null,
+                },
+            };
+        }
+        if (input.operation === 'set') {
+            if (input.value === undefined) {
+                throw ctx.fail('value_required', '`value` is required when operation is "set".', {
+                    operation: input.operation,
+                });
+            }
+            await svc.patchNote(ctx, target, JSON.stringify(input.value), {
+                operation: 'replace',
+                targetType: 'frontmatter',
+                target: input.key,
+                contentType: 'json',
+                createTargetIfMissing: true,
+            });
+            const note = await svc.getNoteJson(ctx, target);
+            return {
+                result: {
+                    operation: 'set',
+                    path: note.path,
+                    key: input.key,
+                    frontmatter: note.frontmatter,
+                },
+            };
+        }
+        const note = await svc.getNoteJson(ctx, target);
+        const newContent = deleteFrontmatterKey(note.content, input.key);
+        if (newContent !== note.content) {
+            await svc.writeNote(ctx, target, newContent, 'markdown');
+        }
+        const projected = { ...note.frontmatter };
+        delete projected[input.key];
+        return {
+            result: {
+                operation: 'delete',
+                path: note.path,
+                key: input.key,
+                frontmatter: projected,
+            },
+        };
+    },
+    format: ({ result }) => {
+        if (result.operation === 'get') {
+            const valueStr = result.exists ? formatValue(result.value) : '_(absent)_';
+            return [
+                {
+                    type: 'text',
+                    text: [
+                        `**Frontmatter ${result.operation} \`${result.key}\` in ${result.path}**`,
+                        `*Exists:* ${result.exists}`,
+                        '*Value:*',
+                        valueStr,
+                    ].join('\n'),
+                },
+            ];
+        }
+        const fmKeys = Object.keys(result.frontmatter);
+        const lines = [
+            `**Frontmatter ${result.operation} \`${result.key}\` in ${result.path}**`,
+            '',
+            `**Frontmatter (${fmKeys.length} keys after change)**`,
+        ];
+        if (fmKeys.length === 0) {
+            lines.push('_(empty)_');
+        }
+        else {
+            for (const k of fmKeys) {
+                lines.push(`- \`${k}\`: ${formatValue(result.frontmatter[k])}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function formatValue(v) {
+    if (v === null || v === undefined)
+        return '`null`';
+    if (typeof v === 'string')
+        return v;
+    return `\`${JSON.stringify(v)}\``;
+}
+//# sourceMappingURL=obsidian-manage-frontmatter.tool.js.map

package/dist/mcp-server/tools/definitions/obsidian-manage-frontmatter.tool.js.map

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

package/dist/mcp-server/tools/definitions/obsidian-manage-tags.tool.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview obsidian_manage_tags — add/remove/list tags across both
+ * frontmatter (`tags:` array) and inline (`#tag`) syntax. The service layer
+ * reconciles both representations; inline matches inside fenced code blocks
+ * are left alone.
+ * @module mcp-server/tools/definitions/obsidian-manage-tags.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const obsidianManageTags: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"active">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"periodic">;
+        period: z.ZodEnum<{
+            daily: "daily";
+            weekly: "weekly";
+            monthly: "monthly";
+            quarterly: "quarterly";
+            yearly: "yearly";
+        }>;
+        date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+    operation: z.ZodEnum<{
+        list: "list";
+        add: "add";
+        remove: "remove";
+    }>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    location: z.ZodDefault<z.ZodEnum<{
+        frontmatter: "frontmatter";
+        inline: "inline";
+        both: "both";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        operation: z.ZodLiteral<"list">;
+        path: z.ZodString;
+        tags: z.ZodObject<{
+            frontmatter: z.ZodArray<z.ZodString>;
+            inline: z.ZodArray<z.ZodString>;
+            all: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        operation: z.ZodLiteral<"add">;
+        path: z.ZodString;
+        applied: z.ZodArray<z.ZodString>;
+        skipped: z.ZodArray<z.ZodString>;
+        tags: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        operation: z.ZodLiteral<"remove">;
+        path: z.ZodString;
+        applied: z.ZodArray<z.ZodString>;
+        skipped: z.ZodArray<z.ZodString>;
+        tags: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>], "operation">;
+}, z.core.$strip>, readonly [{
+    readonly reason: "tags_required";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`operation` is \"add\" or \"remove\" but `tags` was empty or omitted.";
+}, {
+    readonly reason: "note_missing";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The vault path does not resolve to an existing note.";
+}, {
+    readonly reason: "no_active_file";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `active` but no file is currently open in Obsidian.";
+}, {
+    readonly reason: "periodic_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Target was `periodic` but no matching periodic note exists.";
+}]>;
+//# sourceMappingURL=obsidian-manage-tags.tool.d.ts.map

package/dist/mcp-server/tools/definitions/obsidian-manage-tags.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-manage-tags.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-manage-tags.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiK7B,CAAC"}

package/dist/mcp-server/tools/definitions/obsidian-manage-tags.tool.js

@@ -0,0 +1,172 @@
+/**
+ * @fileoverview obsidian_manage_tags — add/remove/list tags across both
+ * frontmatter (`tags:` array) and inline (`#tag`) syntax. The service layer
+ * reconciles both representations; inline matches inside fenced code blocks
+ * are left alone.
+ * @module mcp-server/tools/definitions/obsidian-manage-tags.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { listTagsFromContent, reconcileTags } from '../../../services/obsidian/frontmatter-ops.js';
+import { getObsidianService } from '../../../services/obsidian/obsidian-service.js';
+import { TargetSchema } from './_shared/schemas.js';
+const LocationSchema = z
+    .enum(['frontmatter', 'inline', 'both'])
+    .default('both')
+    .describe('Where to apply the change. Default `both` reconciles both representations.');
+export const obsidianManageTags = tool('obsidian_manage_tags', {
+    description: "Add, remove, or list a note's tags. The server reconciles both representations — frontmatter `tags:` array and inline `#tag` syntax — so an `add` ensures the tag is present in the requested location(s), and a `remove` strips it. Inline `#tag` occurrences inside fenced code blocks are intentionally left alone. Inline-location additions append the new tag at the end of the file. `list` ignores the `tags` field.",
+    annotations: { destructiveHint: true },
+    input: z.object({
+        target: TargetSchema.describe('Where the note lives.'),
+        operation: z
+            .enum(['add', 'remove', 'list'])
+            .describe('`add` and `remove` mutate the note; `list` reads the current tag set.'),
+        tags: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Tags to add or remove. Omit the leading `#`. Required for add/remove.'),
+        location: LocationSchema,
+    }),
+    output: z.object({
+        result: z
+            .discriminatedUnion('operation', [
+            z
+                .object({
+                operation: z.literal('list').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                tags: z
+                    .object({
+                    frontmatter: z.array(z.string()).describe('Tags from frontmatter `tags:` array.'),
+                    inline: z.array(z.string()).describe('Tags found in inline `#tag` syntax.'),
+                    all: z
+                        .array(z.string())
+                        .describe('Deduplicated union of frontmatter and inline tags.'),
+                })
+                    .describe('Tags split by location plus the deduplicated union.'),
+            })
+                .describe('Result for `list`.'),
+            z
+                .object({
+                operation: z.literal('add').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                applied: z.array(z.string()).describe('Tags actually changed by this call.'),
+                skipped: z
+                    .array(z.string())
+                    .describe('Tags already present at the targeted location(s).'),
+                tags: z.array(z.string()).describe('All tags on the note after the change.'),
+            })
+                .describe('Result for `add`.'),
+            z
+                .object({
+                operation: z.literal('remove').describe('Echoed operation.'),
+                path: z.string().describe('Resolved vault-relative path.'),
+                applied: z.array(z.string()).describe('Tags actually changed by this call.'),
+                skipped: z.array(z.string()).describe('Tags absent from the targeted location(s).'),
+                tags: z.array(z.string()).describe('All tags on the note after the change.'),
+            })
+                .describe('Result for `remove`.'),
+        ])
+            .describe('Operation-discriminated result payload.'),
+    }),
+    auth: ['tool:obsidian_manage_tags:write'],
+    errors: [
+        {
+            reason: 'tags_required',
+            code: JsonRpcErrorCode.ValidationError,
+            when: '`operation` is "add" or "remove" but `tags` was empty or omitted.',
+        },
+        {
+            reason: 'note_missing',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The vault path does not resolve to an existing note.',
+        },
+        {
+            reason: 'no_active_file',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Target was `active` but no file is currently open in Obsidian.',
+        },
+        {
+            reason: 'periodic_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Target was `periodic` but no matching periodic note exists.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        const { target } = input;
+        const note = await svc.getNoteJson(ctx, target);
+        if (input.operation === 'list') {
+            const split = listTagsFromContent(note.content, note.frontmatter);
+            const all = Array.from(new Set([...split.frontmatter, ...split.inline]));
+            return {
+                result: {
+                    operation: 'list',
+                    path: note.path,
+                    tags: { frontmatter: split.frontmatter, inline: split.inline, all },
+                },
+            };
+        }
+        if (!input.tags || input.tags.length === 0) {
+            throw ctx.fail('tags_required', '`tags` is required and must be non-empty for add/remove operations.', { operation: input.operation });
+        }
+        const reconciled = reconcileTags(note.content, input.tags, input.operation, input.location);
+        if (reconciled.applied.length === 0) {
+            return {
+                result: {
+                    operation: input.operation,
+                    path: note.path,
+                    applied: reconciled.applied,
+                    skipped: reconciled.skipped,
+                    tags: note.tags,
+                },
+            };
+        }
+        await svc.writeNote(ctx, target, reconciled.content, 'markdown');
+        const after = await svc.getNoteJson(ctx, target);
+        if (input.operation === 'add') {
+            return {
+                result: {
+                    operation: 'add',
+                    path: after.path,
+                    applied: reconciled.applied,
+                    skipped: reconciled.skipped,
+                    tags: after.tags,
+                },
+            };
+        }
+        return {
+            result: {
+                operation: 'remove',
+                path: after.path,
+                applied: reconciled.applied,
+                skipped: reconciled.skipped,
+                tags: after.tags,
+            },
+        };
+    },
+    format: ({ result }) => {
+        if (result.operation === 'list') {
+            const lines = [
+                `**Tags (operation: ${result.operation}) in ${result.path}**`,
+                `*Frontmatter (${result.tags.frontmatter.length}):* ${formatTags(result.tags.frontmatter)}`,
+                `*Inline (${result.tags.inline.length}):* ${formatTags(result.tags.inline)}`,
+                `*All (${result.tags.all.length}):* ${formatTags(result.tags.all)}`,
+            ];
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        const lines = [
+            `**${result.operation === 'add' ? 'Added tags to' : 'Removed tags from'} ${result.path}** (operation: ${result.operation})`,
+            `*Applied (${result.applied.length}):* ${formatTags(result.applied)}`,
+            `*Skipped (${result.skipped.length}):* ${formatTags(result.skipped)}`,
+            `*All tags now (${result.tags.length}):* ${formatTags(result.tags)}`,
+        ];
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function formatTags(tags) {
+    if (tags.length === 0)
+        return '_(none)_';
+    return tags.map((t) => `\`#${t}\``).join(' ');
+}
+//# sourceMappingURL=obsidian-manage-tags.tool.js.map

package/dist/mcp-server/tools/definitions/obsidian-manage-tags.tool.js.map

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

package/dist/mcp-server/tools/definitions/obsidian-open-in-ui.tool.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview obsidian_open_in_ui — open a file in the Obsidian app UI.
+ * Defaults to `failIfMissing: true` because Obsidian silently creates files on
+ * open otherwise; opt out for an "open or create" flow.
+ * @module mcp-server/tools/definitions/obsidian-open-in-ui.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const obsidianOpenInUi: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    path: z.ZodString;
+    failIfMissing: z.ZodDefault<z.ZodBoolean>;
+    newLeaf: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    opened: z.ZodBoolean;
+    createdIfMissing: z.ZodBoolean;
+}, z.core.$strip>, readonly [{
+    readonly reason: "note_missing";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "`failIfMissing: true` (default) and the path does not exist in the vault. Pass `failIfMissing: false` to allow Obsidian to create the file on open.";
+}]>;
+//# sourceMappingURL=obsidian-open-in-ui.tool.d.ts.map

package/dist/mcp-server/tools/definitions/obsidian-open-in-ui.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-open-in-ui.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-open-in-ui.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAK3E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GA2F3B,CAAC"}

package/dist/mcp-server/tools/definitions/obsidian-open-in-ui.tool.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview obsidian_open_in_ui — open a file in the Obsidian app UI.
+ * Defaults to `failIfMissing: true` because Obsidian silently creates files on
+ * open otherwise; opt out for an "open or create" flow.
+ * @module mcp-server/tools/definitions/obsidian-open-in-ui.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getObsidianService } from '../../../services/obsidian/obsidian-service.js';
+import { withCaseFallback } from './_shared/suggest-paths.js';
+export const obsidianOpenInUi = tool('obsidian_open_in_ui', {
+    description: 'Open a file in the Obsidian app UI. By default fails when the path does not exist; the `failIfMissing` flag controls the open-or-create behavior.',
+    annotations: { openWorldHint: true },
+    input: z.object({
+        path: z.string().min(1).describe('Vault-relative path of the file to open.'),
+        failIfMissing: z
+            .boolean()
+            .default(true)
+            .describe('When true (default), fails if the file does not exist. When false, allows Obsidian to create the file on open.'),
+        newLeaf: z
+            .boolean()
+            .default(false)
+            .describe('Open in a new leaf (split pane) instead of the active one.'),
+    }),
+    output: z.object({
+        path: z.string().describe('Resolved vault-relative path that was opened.'),
+        opened: z.boolean().describe('True when the open call succeeded.'),
+        createdIfMissing: z
+            .boolean()
+            .describe('True when the file did not exist before the call and was created by Obsidian.'),
+    }),
+    auth: ['tool:obsidian_open_in_ui:write'],
+    errors: [
+        {
+            reason: 'note_missing',
+            code: JsonRpcErrorCode.NotFound,
+            when: '`failIfMissing: true` (default) and the path does not exist in the vault. Pass `failIfMissing: false` to allow Obsidian to create the file on open.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        const target = { type: 'path', path: input.path };
+        if (!input.failIfMissing) {
+            // Caller opted into "open or create" — skip the existence probe and let
+            // Obsidian create the file on open.
+            await svc.openInUi(ctx, input.path, { newLeaf: input.newLeaf });
+            return { path: input.path, opened: true, createdIfMissing: true };
+        }
+        let resolvedPath = input.path;
+        try {
+            const { resolvedPath: rp } = await withCaseFallback(ctx, svc, target, (t) => svc.getNoteJson(ctx, t));
+            resolvedPath = rp ?? input.path;
+        }
+        catch (err) {
+            // Match on `data.reason` rather than the JSON-RPC code so the handler text
+            // doesn't trip `error-contract-prefer-fail` on a comparison literal. The
+            // service tags path 404s with `reason: 'note_missing'` in its error data.
+            const reason = err instanceof McpError ? err.data?.reason : undefined;
+            if (reason !== 'note_missing')
+                throw err;
+            const suggestions = (err instanceof McpError && err.data?.suggestions) || [];
+            const hint = suggestions.length > 0
+                ? ` Did you mean: ${suggestions.map((s) => `"${s}"`).join(', ')}?`
+                : '';
+            throw ctx.fail('note_missing', `Cannot open '${input.path}' — file does not exist.${hint} Pass failIfMissing: false to create on open.`, {
+                path: input.path,
+                ...(suggestions.length > 0 ? { suggestions } : {}),
+            }, { cause: err });
+        }
+        await svc.openInUi(ctx, resolvedPath, { newLeaf: input.newLeaf });
+        return {
+            path: resolvedPath,
+            opened: true,
+            createdIfMissing: false,
+        };
+    },
+    format: (result) => [
+        {
+            type: 'text',
+            text: [
+                `**Opened ${result.path}**`,
+                `*Opened:* ${result.opened}`,
+                `*Created if missing:* ${result.createdIfMissing}`,
+            ].join('\n'),
+        },
+    ],
+});
+//# sourceMappingURL=obsidian-open-in-ui.tool.js.map

package/dist/mcp-server/tools/definitions/obsidian-open-in-ui.tool.js.map

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