obsidian-mcp-server 2.0.6 → 3.0.0

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

@@ -0,0 +1,244 @@
+/**
+ * @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`.
+ * @module mcp-server/tools/definitions/obsidian-search-notes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getObsidianService } from '../../../services/obsidian/obsidian-service.js';
+const HIT_CAP = 100;
+const DEFAULT_MATCHES_PER_HIT = 10;
+const EXCLUSION_HINT = 'Narrow your query (add filters or more specific terms) to surface the rest.';
+const TextHitSchema = z
+    .object({
+    filename: z.string().describe('Vault-relative path of the matching note.'),
+    score: z.number().optional().describe('Relevance score from the search index, when available.'),
+    matches: z
+        .array(z
+        .object({
+        context: z.string().describe('Surrounding text around the match.'),
+        match: z
+            .object({
+            start: z.number().describe('Match start offset in the surrounding context.'),
+            end: z.number().describe('Match end offset in the surrounding context.'),
+        })
+            .describe('Match offsets within the context window.'),
+    })
+        .describe('A single match within a file.'))
+        .describe('Per-match context windows. Capped per file by `maxMatchesPerHit`.'),
+    totalMatches: z
+        .number()
+        .optional()
+        .describe('Total matches in this file. Present only when `matches` was clipped to `maxMatchesPerHit`.'),
+    truncated: z
+        .boolean()
+        .optional()
+        .describe('True when `matches` was clipped to `maxMatchesPerHit`. Use `obsidian_get_note` to read the full file when more context is needed.'),
+})
+    .describe('A file with one or more text-search matches.');
+const StructuredHitSchema = z
+    .object({
+    filename: z.string().describe('Vault-relative path of the matching note.'),
+    result: z.unknown().describe('The query result for this file — shape determined by the query.'),
+})
+    .describe('A file with a structured (Dataview/JSONLogic) result value.');
+const ExcludedSchema = z
+    .object({
+    count: z.number().describe('Number of additional hits the upstream returned beyond the cap.'),
+    hint: z.string().describe('Suggestion for narrowing the query.'),
+})
+    .optional();
+export const obsidianSearchNotes = tool('obsidian_search_notes', {
+    description: `Search the vault. Modes:
+- \`text\`: substring match with context windows. Pass \`query\` as a string and optionally \`pathPrefix\` to filter the returned filenames.
+- \`dataview\`: a Dataview DQL query (\`TABLE …\`). Pass \`query\` as the DQL string. Use this for path/date/metadata filters; \`file.mtime\`, \`file.path\`, etc. are queryable.
+- \`jsonlogic\`: a JSONLogic tree evaluated over each note's NoteJson. Pass \`logic\` as a JSON object. Available \`var\` paths: \`path\` (string), \`content\` (string), \`frontmatter.<key>\` (any), \`tags\` (string[]), \`stat.ctime\` / \`stat.mtime\` / \`stat.size\` (number). Custom operators include \`glob\` and \`regexp\`.
+
+Results are capped at ${HIT_CAP} hits; an \`excluded\` indicator reports the overflow. Text-mode hits are additionally clipped to \`maxMatchesPerHit\` matches per file (default ${DEFAULT_MATCHES_PER_HIT}); when clipped, the hit carries \`truncated: true\` and \`totalMatches\`.`,
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        mode: z
+            .enum(['text', 'dataview', 'jsonlogic'])
+            .describe('Search algorithm and request body shape.'),
+        query: z
+            .string()
+            .optional()
+            .describe('For `text` mode: substring to match. For `dataview` mode: the DQL query string. Required for those modes.'),
+        logic: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('JSONLogic tree. Required and only used when `mode` is `"jsonlogic"`.'),
+        contextLength: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe('Characters of context on each side of the match (text mode only). Default 100.'),
+        pathPrefix: z
+            .string()
+            .optional()
+            .describe('Filter returned filenames by prefix (text mode only, applied client-side).'),
+        maxMatchesPerHit: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe(`Cap on match contexts returned per file in text mode. When clipped, the hit carries \`truncated: true\` and \`totalMatches\`. Default ${DEFAULT_MATCHES_PER_HIT}.`),
+    }),
+    output: z.object({
+        result: z
+            .discriminatedUnion('mode', [
+            z
+                .object({
+                mode: z.literal('text').describe('Echoed mode.'),
+                hits: z.array(TextHitSchema).describe('Matching files with per-match context.'),
+                excluded: ExcludedSchema.describe('Present when results were truncated to the cap.'),
+            })
+                .describe('Text-search results.'),
+            z
+                .object({
+                mode: z.literal('dataview').describe('Echoed mode.'),
+                hits: z
+                    .array(StructuredHitSchema)
+                    .describe('Matching files with the query result per file.'),
+                excluded: ExcludedSchema.describe('Present when results were truncated to the cap.'),
+            })
+                .describe('Dataview DQL results.'),
+            z
+                .object({
+                mode: z.literal('jsonlogic').describe('Echoed mode.'),
+                hits: z
+                    .array(StructuredHitSchema)
+                    .describe('Matching files with the JSONLogic result per file.'),
+                excluded: ExcludedSchema.describe('Present when results were truncated to the cap.'),
+            })
+                .describe('JSONLogic results.'),
+        ])
+            .describe('Mode-discriminated search payload.'),
+    }),
+    auth: ['tool:obsidian_search_notes:read'],
+    errors: [
+        {
+            reason: 'path_prefix_invalid_mode',
+            code: JsonRpcErrorCode.ValidationError,
+            when: '`pathPrefix` was provided in a non-text mode (only `text` supports prefix filtering).',
+        },
+        {
+            reason: 'query_required',
+            code: JsonRpcErrorCode.ValidationError,
+            when: '`query` is missing for `text` or `dataview` mode (required for both).',
+        },
+        {
+            reason: 'logic_required',
+            code: JsonRpcErrorCode.ValidationError,
+            when: '`logic` is missing for `jsonlogic` mode.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        if (input.pathPrefix && input.mode !== 'text') {
+            throw ctx.fail('path_prefix_invalid_mode', '`pathPrefix` is only valid in text mode.', {
+                mode: input.mode,
+            });
+        }
+        if (input.mode === 'text') {
+            if (!input.query) {
+                throw ctx.fail('query_required', '`query` is required for text mode.', {
+                    mode: input.mode,
+                });
+            }
+            const all = await svc.searchText(ctx, input.query, input.contextLength);
+            const prefix = input.pathPrefix;
+            const filtered = prefix ? all.filter((h) => h.filename.startsWith(prefix)) : all;
+            const matchCap = input.maxMatchesPerHit ?? DEFAULT_MATCHES_PER_HIT;
+            const clipped = filtered.map((h) => clipMatches(h, matchCap));
+            const capped = applyCap(clipped);
+            return { result: { mode: 'text', ...capped } };
+        }
+        if (input.mode === 'dataview') {
+            if (!input.query) {
+                throw ctx.fail('query_required', '`query` (DQL string) is required for dataview mode.', {
+                    mode: input.mode,
+                });
+            }
+            const all = await svc.searchDataview(ctx, input.query);
+            const capped = applyCap(all);
+            return { result: { mode: 'dataview', ...capped } };
+        }
+        if (!input.logic) {
+            throw ctx.fail('logic_required', '`logic` (JSONLogic tree) is required for jsonlogic mode.', {
+                mode: input.mode,
+            });
+        }
+        const all = await svc.searchJsonLogic(ctx, input.logic);
+        const capped = applyCap(all);
+        return { result: { mode: 'jsonlogic', ...capped } };
+    },
+    format: ({ result }) => {
+        const lines = [`**Search (${result.mode}) — ${result.hits.length} hits**`];
+        if (result.excluded) {
+            lines.push(`_Excluded ${result.excluded.count} additional hits — ${result.excluded.hint}_`);
+        }
+        if (result.hits.length === 0) {
+            lines.push('', '_No matches. Try broader terms, a different mode, or check that the path/filter is correct._');
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        lines.push('');
+        if (result.mode === 'text') {
+            for (const h of result.hits) {
+                const score = h.score !== undefined ? ` (score: ${h.score})` : '';
+                const trunc = h.truncated
+                    ? ` — truncated, showing first ${h.matches.length} of ${h.totalMatches} matches`
+                    : '';
+                lines.push(`### ${h.filename}${score}${trunc}`);
+                for (const m of h.matches) {
+                    lines.push(`- match[${m.match.start}–${m.match.end}]: ${truncate(m.context, 240)}`);
+                }
+            }
+        }
+        else {
+            for (const h of result.hits) {
+                lines.push(`### ${h.filename}`);
+                lines.push('```json');
+                lines.push(safeJsonStringify(h.result));
+                lines.push('```');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function applyCap(all) {
+    if (all.length <= HIT_CAP)
+        return { hits: all, excluded: undefined };
+    return {
+        hits: all.slice(0, HIT_CAP),
+        excluded: { count: all.length - HIT_CAP, hint: EXCLUSION_HINT },
+    };
+}
+function clipMatches(hit, cap) {
+    if (hit.matches.length <= cap)
+        return hit;
+    return {
+        ...hit,
+        matches: hit.matches.slice(0, cap),
+        truncated: true,
+        totalMatches: hit.matches.length,
+    };
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return `${s.slice(0, n)}…`;
+}
+function safeJsonStringify(v) {
+    try {
+        return JSON.stringify(v, null, 2);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=obsidian-search-notes.tool.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview obsidian_write_note — create or overwrite a note (whole file)
+ * or replace a single section in place via PATCH-with-replace. Idempotent.
+ * @module mcp-server/tools/definitions/obsidian-write-note.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const obsidianWriteNote: 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">;
+    content: z.ZodString;
+    section: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<{
+            heading: "heading";
+            block: "block";
+            frontmatter: "frontmatter";
+        }>;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+    contentType: z.ZodDefault<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    sectionTargeted: z.ZodBoolean;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=obsidian-write-note.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-write-note.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/obsidian-write-note.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA0D5B,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview obsidian_write_note — create or overwrite a note (whole file)
+ * or replace a single section in place via PATCH-with-replace. Idempotent.
+ * @module mcp-server/tools/definitions/obsidian-write-note.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getObsidianService } from '../../../services/obsidian/obsidian-service.js';
+import { ContentTypeSchema, SectionSchema, TargetSchema } from './_shared/schemas.js';
+export const obsidianWriteNote = tool('obsidian_write_note', {
+    description: 'Create or overwrite a note. With `section` provided, replaces just that heading/block/frontmatter section in place; otherwise overwrites the whole file (creating it if missing). Idempotent — repeated calls with the same input converge on the same result. For heading sections, `content` is the new body; the heading line itself is preserved automatically and a leading duplicate heading is stripped.',
+    annotations: { idempotentHint: true, destructiveHint: true },
+    input: z.object({
+        target: TargetSchema.describe('Where the note lives.'),
+        content: z
+            .string()
+            .describe('Body to write. For heading sections, the new section body — do not repeat the heading line (it stays in place). Markdown unless `contentType` is `json`.'),
+        section: SectionSchema.optional().describe('Optional sub-document target. When set, only this section is replaced; rest of the note is untouched.'),
+        contentType: ContentTypeSchema,
+    }),
+    output: z.object({
+        path: z.string().describe('Resolved vault-relative path of the note that was written.'),
+        sectionTargeted: z
+            .boolean()
+            .describe('True when only a section was replaced; false for full-file writes.'),
+    }),
+    auth: ['tool:obsidian_write_note:write'],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        const { target } = input;
+        if (input.section) {
+            const body = input.section.type === 'heading'
+                ? stripLeadingHeading(input.content, input.section.target)
+                : input.content;
+            await svc.patchNote(ctx, target, body, {
+                operation: 'replace',
+                targetType: input.section.type,
+                target: input.section.target,
+                targetDelimiter: input.section.type === 'heading' ? '::' : undefined,
+                contentType: input.contentType,
+                applyIfContentPreexists: true,
+            });
+            const path = await svc.resolvePath(ctx, target);
+            return { path, sectionTargeted: true };
+        }
+        await svc.writeNote(ctx, target, input.content, input.contentType);
+        const path = await svc.resolvePath(ctx, target);
+        return { path, sectionTargeted: false };
+    },
+    format: (result) => [
+        {
+            type: 'text',
+            text: [`**Wrote ${result.path}**`, `*Section targeted:* ${result.sectionTargeted}`].join('\n'),
+        },
+    ],
+});
+/**
+ * If `content` opens with a markdown heading whose text matches the leaf of
+ * `headingTarget` (delimited by `::`), drop that heading line plus a single
+ * blank line. Upstream PATCH-replace operates on the section *body*, so a
+ * caller-supplied heading line would otherwise be embedded as a duplicate.
+ */
+function stripLeadingHeading(content, headingTarget) {
+    const leaf = headingTarget.split('::').pop()?.trim();
+    if (!leaf)
+        return content;
+    const lines = content.split('\n');
+    const first = lines[0]?.trimEnd() ?? '';
+    const m = /^(#{1,6})\s+(.+)$/.exec(first);
+    if (!m || m[2]?.trim() !== leaf)
+        return content;
+    lines.shift();
+    if (lines[0]?.trim() === '')
+        lines.shift();
+    return lines.join('\n');
+}
+//# sourceMappingURL=obsidian-write-note.tool.js.map

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

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

package/dist/services/obsidian/frontmatter-ops.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Read-modify-write helpers for the YAML frontmatter block of a
+ * note's raw content. Used by the composed manage-frontmatter / manage-tags
+ * tools when the upstream Local REST API has no single-call equivalent.
+ * @module services/obsidian/frontmatter-ops
+ */
+/**
+ * Returns the full file content with `key` removed from the frontmatter.
+ * If the file has no frontmatter or the key isn't present, returns content
+ * unchanged.
+ */
+export declare function deleteFrontmatterKey(content: string, key: string): string;
+export interface TagReconcileResult {
+    /** Tags actually changed (added/removed) at one or more locations. */
+    applied: string[];
+    /** Updated content with the requested tag mutations applied. */
+    content: string;
+    /** Tags that were already in the desired state at the targeted location(s). */
+    skipped: string[];
+}
+export type TagOperation = 'add' | 'remove';
+export type TagLocation = 'frontmatter' | 'inline' | 'both';
+/**
+ * Add or remove tags across frontmatter (`tags:` array) and inline `#tag`
+ * syntax. Inline occurrences inside fenced code blocks are left alone — they
+ * are code, not tags.
+ */
+export declare function reconcileTags(content: string, tags: string[], operation: TagOperation, location: TagLocation): TagReconcileResult;
+/** Read-only helpers for `obsidian_manage_tags list`. */
+export declare function listTagsFromContent(content: string, frontmatter: Record<string, unknown>): {
+    frontmatter: string[];
+    inline: string[];
+};
+//# sourceMappingURL=frontmatter-ops.d.ts.map

package/dist/services/obsidian/frontmatter-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-ops.d.ts","sourceRoot":"","sources":["../../../src/services/obsidian/frontmatter-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqCH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC5C,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,WAAW,GACpB,kBAAkB,CAqBpB;AA6JD,yDAAyD;AACzD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC;IACD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAkBA"}

package/dist/services/obsidian/frontmatter-ops.js

@@ -0,0 +1,230 @@
+/**
+ * @fileoverview Read-modify-write helpers for the YAML frontmatter block of a
+ * note's raw content. Used by the composed manage-frontmatter / manage-tags
+ * tools when the upstream Local REST API has no single-call equivalent.
+ * @module services/obsidian/frontmatter-ops
+ */
+import { dump as yamlDump, load as yamlLoad } from 'js-yaml';
+const FM_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function splice(content) {
+    const m = FM_RE.exec(content);
+    if (!m)
+        return { hasFrontmatter: false, yamlText: '', body: content };
+    return {
+        hasFrontmatter: true,
+        yamlText: m[1] ?? '',
+        body: content.slice(m[0].length),
+    };
+}
+function loadFrontmatter(yamlText) {
+    const loaded = yamlLoad(yamlText);
+    return loaded && typeof loaded === 'object' ? loaded : {};
+}
+function emit(frontmatter, body) {
+    const keys = Object.keys(frontmatter);
+    if (keys.length === 0) {
+        return body.replace(/^\s+/, '');
+    }
+    const yamlText = yamlDump(frontmatter, { lineWidth: 1000, noRefs: true });
+    return `---\n${yamlText.trimEnd()}\n---\n${body.startsWith('\n') ? body.slice(1) : body}`;
+}
+/**
+ * Returns the full file content with `key` removed from the frontmatter.
+ * If the file has no frontmatter or the key isn't present, returns content
+ * unchanged.
+ */
+export function deleteFrontmatterKey(content, key) {
+    const { hasFrontmatter, yamlText, body } = splice(content);
+    if (!hasFrontmatter)
+        return content;
+    const fm = loadFrontmatter(yamlText);
+    if (!(key in fm))
+        return content;
+    delete fm[key];
+    return emit(fm, body);
+}
+/**
+ * Add or remove tags across frontmatter (`tags:` array) and inline `#tag`
+ * syntax. Inline occurrences inside fenced code blocks are left alone — they
+ * are code, not tags.
+ */
+export function reconcileTags(content, tags, operation, location) {
+    const norm = (t) => t.replace(/^#+/, '').trim();
+    const wanted = tags.map(norm).filter((t) => t.length > 0);
+    const applied = new Set();
+    const skipped = new Set();
+    let updated = content;
+    if (location === 'frontmatter' || location === 'both') {
+        updated = mutateFrontmatterTags(updated, wanted, operation, applied, skipped);
+    }
+    if (location === 'inline' || location === 'both') {
+        updated = mutateInlineTags(updated, wanted, operation, applied, skipped);
+    }
+    // For location='both', a tag that was already-in-frontmatter may have been
+    // missing inline (or vice versa). If applied is non-empty for the tag, drop
+    // it from skipped.
+    for (const t of applied)
+        skipped.delete(t);
+    return { content: updated, applied: [...applied], skipped: [...skipped] };
+}
+function mutateFrontmatterTags(content, tags, operation, applied, skipped) {
+    const { hasFrontmatter, yamlText, body } = splice(content);
+    const fm = hasFrontmatter ? { ...loadFrontmatter(yamlText) } : {};
+    const existing = normalizeTagList(fm.tags);
+    const set = new Set(existing);
+    let changed = false;
+    for (const tag of tags) {
+        if (operation === 'add') {
+            if (set.has(tag))
+                skipped.add(tag);
+            else {
+                set.add(tag);
+                applied.add(tag);
+                changed = true;
+            }
+        }
+        else {
+            if (set.has(tag)) {
+                set.delete(tag);
+                applied.add(tag);
+                changed = true;
+            }
+            else {
+                skipped.add(tag);
+            }
+        }
+    }
+    if (!changed)
+        return content;
+    const ordered = [...set];
+    if (ordered.length === 0) {
+        delete fm.tags;
+    }
+    else {
+        fm.tags = ordered;
+    }
+    if (Object.keys(fm).length === 0) {
+        return body.replace(/^\s+/, '');
+    }
+    return emit(fm, body);
+}
+function normalizeTagList(value) {
+    if (Array.isArray(value)) {
+        return value
+            .filter((v) => typeof v === 'string')
+            .map((v) => v.replace(/^#+/, '').trim())
+            .filter((v) => v.length > 0);
+    }
+    if (typeof value === 'string') {
+        return value
+            .split(/[\s,]+/)
+            .map((v) => v.replace(/^#+/, '').trim())
+            .filter((v) => v.length > 0);
+    }
+    return [];
+}
+const FENCED_CODE_BLOCK = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
+const INLINE_CODE = /(`[^`\n]+`)/g;
+function mutateInlineTags(content, tags, operation, applied, skipped) {
+    const segments = splitProtectedSegments(content);
+    let updatedNonCode = false;
+    if (operation === 'add') {
+        for (const tag of tags) {
+            const re = makeInlineTagRegex(tag);
+            const present = segments.some((s) => !s.protected && re.test(s.text));
+            if (present) {
+                skipped.add(tag);
+            }
+            else {
+                applied.add(tag);
+            }
+        }
+        const additions = tags
+            .filter((t) => applied.has(t))
+            .map((t) => `#${t}`)
+            .join(' ');
+        if (additions.length > 0) {
+            const trailing = segments.length > 0 ? (segments[segments.length - 1] ?? null) : null;
+            if (trailing && !trailing.protected) {
+                const sep = trailing.text.endsWith('\n') ? '' : '\n';
+                trailing.text = `${trailing.text}${sep}${additions}\n`;
+                updatedNonCode = true;
+            }
+            else {
+                segments.push({ protected: false, text: `\n${additions}\n` });
+                updatedNonCode = true;
+            }
+        }
+    }
+    else {
+        for (const tag of tags) {
+            const re = makeInlineTagRegex(tag);
+            let found = false;
+            for (const s of segments) {
+                if (s.protected)
+                    continue;
+                if (re.test(s.text)) {
+                    s.text = s.text.replace(re, (_full, leading) => leading);
+                    // collapse double spaces left behind
+                    s.text = s.text.replace(/[ \t]{2,}/g, ' ').replace(/ \n/g, '\n');
+                    found = true;
+                    updatedNonCode = true;
+                }
+            }
+            if (found)
+                applied.add(tag);
+            else
+                skipped.add(tag);
+        }
+    }
+    if (!updatedNonCode)
+        return content;
+    return segments.map((s) => s.text).join('');
+}
+function splitProtectedSegments(content) {
+    const segments = [];
+    let cursor = 0;
+    const re = new RegExp(`${FENCED_CODE_BLOCK.source}|${INLINE_CODE.source}`, 'g');
+    for (;;) {
+        const m = re.exec(content);
+        if (!m)
+            break;
+        const matched = m[0] ?? '';
+        if (m.index > cursor) {
+            segments.push({ protected: false, text: content.slice(cursor, m.index) });
+        }
+        segments.push({ protected: true, text: matched });
+        cursor = m.index + matched.length;
+    }
+    if (cursor < content.length) {
+        segments.push({ protected: false, text: content.slice(cursor) });
+    }
+    return segments;
+}
+function makeInlineTagRegex(tag) {
+    const escaped = tag.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+    return new RegExp(`(^|[^\\w/])#${escaped}(?![\\w/-])`, 'g');
+}
+/** Read-only helpers for `obsidian_manage_tags list`. */
+export function listTagsFromContent(content, frontmatter) {
+    const fmTags = normalizeTagList(frontmatter.tags);
+    const inline = [];
+    const seen = new Set();
+    for (const seg of splitProtectedSegments(content)) {
+        if (seg.protected)
+            continue;
+        const re = /(^|[^\w/])#([a-zA-Z][\w/-]*)/g;
+        for (;;) {
+            const m = re.exec(seg.text);
+            if (!m)
+                break;
+            const t = m[2];
+            if (t && !seen.has(t)) {
+                seen.add(t);
+                inline.push(t);
+            }
+        }
+    }
+    return { frontmatter: fmTags, inline };
+}
+//# sourceMappingURL=frontmatter-ops.js.map