obsidian-mcp-server 2.0.7 → 3.0.0

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

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview obsidian_patch_note — surgical edit (`append` / `prepend` /
+ * `replace`) of a heading, block reference, or frontmatter field. Uses the
+ * upstream Local REST API v3 PATCH protocol.
+ * @module mcp-server/tools/definitions/obsidian-patch-note.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const obsidianPatchNote: 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">;
+    section: z.ZodObject<{
+        type: z.ZodEnum<{
+            heading: "heading";
+            block: "block";
+            frontmatter: "frontmatter";
+        }>;
+        target: z.ZodString;
+    }, z.core.$strip>;
+    operation: z.ZodEnum<{
+        append: "append";
+        prepend: "prepend";
+        replace: "replace";
+    }>;
+    content: z.ZodString;
+    contentType: z.ZodDefault<z.ZodEnum<{
+        markdown: "markdown";
+        json: "json";
+    }>>;
+    patchOptions: z.ZodOptional<z.ZodObject<{
+        createTargetIfMissing: z.ZodDefault<z.ZodBoolean>;
+        applyIfContentPreexists: z.ZodDefault<z.ZodBoolean>;
+        trimTargetWhitespace: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    section: z.ZodObject<{
+        type: z.ZodEnum<{
+            heading: "heading";
+            block: "block";
+            frontmatter: "frontmatter";
+        }>;
+        target: z.ZodString;
+    }, z.core.$strip>;
+    operation: z.ZodEnum<{
+        append: "append";
+        prepend: "prepend";
+        replace: "replace";
+    }>;
+}, z.core.$strip>, readonly [{
+    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.";
+}, {
+    readonly reason: "section_target_missing";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The named heading/block/frontmatter field does not exist in the note. Use `obsidian_get_note` with `format: \"document-map\"` to discover available targets.";
+}]>;
+//# sourceMappingURL=obsidian-patch-note.tool.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8E5B,CAAC"}

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

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview obsidian_patch_note — surgical edit (`append` / `prepend` /
+ * `replace`) of a heading, block reference, or frontmatter field. Uses the
+ * upstream Local REST API v3 PATCH protocol.
+ * @module mcp-server/tools/definitions/obsidian-patch-note.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';
+import { ContentTypeSchema, PatchOptionsSchema, SectionSchema, TargetSchema, } from './_shared/schemas.js';
+export const obsidianPatchNote = tool('obsidian_patch_note', {
+    description: 'Surgical edit of a heading, block reference, or frontmatter field. Choose `operation: "append"` to add after the section, `"prepend"` to add before, or `"replace"` to swap it out. Use `obsidian_get_note` with `format: "document-map"` to discover available headings, blocks, and frontmatter fields. Nested headings need `Parent::Child` syntax.',
+    annotations: { destructiveHint: true },
+    input: z.object({
+        target: TargetSchema.describe('Where the note lives.'),
+        section: SectionSchema.describe('Which heading/block/frontmatter field to edit.'),
+        operation: z
+            .enum(['append', 'prepend', 'replace'])
+            .describe('How to apply the content relative to the section.'),
+        content: z
+            .string()
+            .describe('Body to insert/replace. Markdown unless `contentType` is `json`.'),
+        contentType: ContentTypeSchema,
+        patchOptions: PatchOptionsSchema.describe('Optional flags: createTargetIfMissing, applyIfContentPreexists, trimTargetWhitespace.'),
+    }),
+    output: z.object({
+        path: z.string().describe('Resolved vault-relative path of the note.'),
+        section: SectionSchema.describe('Echoed section locator.'),
+        operation: z
+            .enum(['append', 'prepend', 'replace'])
+            .describe('Echoed operation that was applied.'),
+    }),
+    auth: ['tool:obsidian_patch_note:write'],
+    errors: [
+        {
+            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.',
+        },
+        {
+            reason: 'section_target_missing',
+            code: JsonRpcErrorCode.ValidationError,
+            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.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getObsidianService();
+        const { target } = input;
+        await svc.patchNote(ctx, target, input.content, {
+            operation: input.operation,
+            targetType: input.section.type,
+            target: input.section.target,
+            targetDelimiter: input.section.type === 'heading' ? '::' : undefined,
+            createTargetIfMissing: input.patchOptions?.createTargetIfMissing,
+            applyIfContentPreexists: input.patchOptions?.applyIfContentPreexists,
+            trimTargetWhitespace: input.patchOptions?.trimTargetWhitespace,
+            contentType: input.contentType,
+        });
+        const path = await svc.resolvePath(ctx, target);
+        return { path, section: input.section, operation: input.operation };
+    },
+    format: (result) => [
+        {
+            type: 'text',
+            text: [
+                `**Patched ${result.path}**`,
+                `*Operation:* ${result.operation}`,
+                `*Section:* ${result.section.type} → ${result.section.target}`,
+            ].join('\n'),
+        },
+    ],
+});
+//# sourceMappingURL=obsidian-patch-note.tool.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview obsidian_replace_in_note — string/regex search-replace inside a
+ * single note. Composed read → mutate → write at the service layer; replacements
+ * are applied sequentially over the evolving body.
+ * @module mcp-server/tools/definitions/obsidian-replace-in-note.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const obsidianReplaceInNote: 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">;
+    replacements: z.ZodArray<z.ZodObject<{
+        search: z.ZodString;
+        replace: z.ZodString;
+        useRegex: z.ZodDefault<z.ZodBoolean>;
+        caseSensitive: z.ZodDefault<z.ZodBoolean>;
+        wholeWord: z.ZodDefault<z.ZodBoolean>;
+        flexibleWhitespace: z.ZodDefault<z.ZodBoolean>;
+        replaceAll: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    totalReplacements: z.ZodNumber;
+    perReplacement: z.ZodArray<z.ZodObject<{
+        search: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "regex_invalid";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "A `useRegex: true` replacement supplied a `search` pattern that is not a valid ECMAScript regex.";
+}, {
+    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-replace-in-note.tool.d.ts.map

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

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

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

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview obsidian_replace_in_note — string/regex search-replace inside a
+ * single note. Composed read → mutate → write at the service layer; replacements
+ * are applied sequentially over the evolving body.
+ * @module mcp-server/tools/definitions/obsidian-replace-in-note.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';
+import { TargetSchema } from './_shared/schemas.js';
+const ReplacementSchema = z
+    .object({
+    search: z.string().min(1).describe('Substring or regex pattern to match.'),
+    replace: z.string().describe('Replacement text. Empty string deletes matches.'),
+    useRegex: z.boolean().default(false).describe('Treat `search` as an ECMAScript regex pattern.'),
+    caseSensitive: z.boolean().default(true).describe('When false, match case-insensitively.'),
+    wholeWord: z
+        .boolean()
+        .default(false)
+        .describe('Match only at word boundaries. Applies in both literal and regex modes — the search pattern is wrapped with `\\b…\\b`.'),
+    flexibleWhitespace: z
+        .boolean()
+        .default(false)
+        .describe('Treat any run of whitespace in `search` as matching any whitespace in the body. Literal mode only — has no effect when `useRegex: true` (express it directly with `\\s+`).'),
+    replaceAll: z.boolean().default(true).describe('When false, only the first match is replaced.'),
+})
+    .describe('A single search/replace operation.');
+export const obsidianReplaceInNote = tool('obsidian_replace_in_note', {
+    description: "String or regex search-replace inside a single note. The note is fetched, replacements are applied sequentially (each sees the previous one's output), and the result is written back. Use for edits that don't fit `obsidian_patch_note`'s structural targets — e.g., body-wide find-and-replace.",
+    annotations: { destructiveHint: true },
+    input: z.object({
+        target: TargetSchema.describe('Where the note lives.'),
+        replacements: z
+            .array(ReplacementSchema)
+            .min(1)
+            .describe('Replacements to apply in array order over the evolving content.'),
+    }),
+    output: z.object({
+        path: z.string().describe('Resolved vault-relative path of the note.'),
+        totalReplacements: z
+            .number()
+            .describe('Total number of substitutions applied across all replacement entries.'),
+        perReplacement: z
+            .array(z
+            .object({
+            search: z.string().describe('The search term/pattern that ran.'),
+            count: z.number().describe('Number of matches replaced for this entry.'),
+        })
+            .describe('Counts for one replacement entry.'))
+            .describe('Per-entry counts in the order replacements were applied.'),
+    }),
+    auth: ['tool:obsidian_replace_in_note:write'],
+    errors: [
+        {
+            reason: 'regex_invalid',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'A `useRegex: true` replacement supplied a `search` pattern that is not a valid ECMAScript regex.',
+        },
+        {
+            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);
+        let body = note.content;
+        const perReplacement = [];
+        let totalReplacements = 0;
+        for (const r of input.replacements) {
+            let count = 0;
+            if (r.useRegex) {
+                const pattern = r.wholeWord ? `\\b(?:${r.search})\\b` : r.search;
+                let re;
+                try {
+                    re = new RegExp(pattern, `${r.replaceAll ? 'g' : ''}${r.caseSensitive ? '' : 'i'}`);
+                }
+                catch (err) {
+                    throw ctx.fail('regex_invalid', `Invalid regex '${r.search}': ${err.message}`, { search: r.search }, { cause: err });
+                }
+                // Count separately, then apply with the string overload so $1/$2/$&
+                // capture-group references in `r.replace` are honored.
+                const matches = body.match(re);
+                count = matches ? (re.global ? matches.length : 1) : 0;
+                body = body.replace(re, r.replace);
+            }
+            else if (r.wholeWord || r.flexibleWhitespace) {
+                // Literal-with-transformations: build a regex from the escaped needle.
+                // Use the callback overload so `$1`/`$&` in `r.replace` stay literal.
+                let escaped = r.search.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+                if (r.flexibleWhitespace)
+                    escaped = escaped.replace(/\s+/g, '\\s+');
+                if (r.wholeWord)
+                    escaped = `\\b${escaped}\\b`;
+                const re = new RegExp(escaped, `${r.replaceAll ? 'g' : ''}${r.caseSensitive ? '' : 'i'}`);
+                body = body.replace(re, () => {
+                    count++;
+                    return r.replace;
+                });
+            }
+            else if (r.caseSensitive) {
+                body = replaceLiteral(body, r.search, r.replace, r.replaceAll, () => {
+                    count++;
+                });
+            }
+            else {
+                body = replaceLiteralCaseInsensitive(body, r.search, r.replace, r.replaceAll, () => {
+                    count++;
+                });
+            }
+            perReplacement.push({ search: r.search, count });
+            totalReplacements += count;
+        }
+        if (totalReplacements > 0) {
+            await svc.writeNote(ctx, target, body, 'markdown');
+        }
+        return { path: note.path, totalReplacements, perReplacement };
+    },
+    format: (result) => {
+        const lines = [
+            `**Replaced in ${result.path}**`,
+            `*Total replacements:* ${result.totalReplacements}`,
+            '',
+            '**Per replacement**',
+        ];
+        for (const r of result.perReplacement) {
+            lines.push(`- \`${r.search}\` → ${r.count} match${r.count === 1 ? '' : 'es'}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+function replaceLiteral(haystack, needle, replacement, all, onMatch) {
+    if (!all) {
+        const idx = haystack.indexOf(needle);
+        if (idx === -1)
+            return haystack;
+        onMatch();
+        return haystack.slice(0, idx) + replacement + haystack.slice(idx + needle.length);
+    }
+    const parts = haystack.split(needle);
+    if (parts.length <= 1)
+        return haystack;
+    for (let i = 0; i < parts.length - 1; i++)
+        onMatch();
+    return parts.join(replacement);
+}
+function replaceLiteralCaseInsensitive(haystack, needle, replacement, all, onMatch) {
+    const escaped = needle.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+    const re = new RegExp(escaped, all ? 'gi' : 'i');
+    return haystack.replace(re, () => {
+        onMatch();
+        return replacement;
+    });
+}
+//# sourceMappingURL=obsidian-replace-in-note.tool.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * @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 { 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<{
+    mode: z.ZodEnum<{
+        text: "text";
+        dataview: "dataview";
+        jsonlogic: "jsonlogic";
+    }>;
+    query: z.ZodOptional<z.ZodString>;
+    logic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    contextLength: z.ZodOptional<z.ZodNumber>;
+    pathPrefix: z.ZodOptional<z.ZodString>;
+    maxMatchesPerHit: z.ZodOptional<z.ZodNumber>;
+}, 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<{
+                    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>>;
+        excluded: z.ZodOptional<z.ZodObject<{
+            count: z.ZodNumber;
+            hint: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"dataview">;
+        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;
+        }, z.core.$strip>>;
+    }, 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;
+        }, z.core.$strip>>;
+    }, 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 reason: "query_required";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`query` is missing for `text` or `dataview` mode (required for both).";
+}, {
+    readonly reason: "logic_required";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "`logic` is missing for `jsonlogic` mode.";
+}]>;
+//# sourceMappingURL=obsidian-search-notes.tool.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0K9B,CAAC"}