gitlab-docs-mcp 1.0.0

package/dist/tools/registry.js

@@ -0,0 +1,64 @@
+import { DEFAULT_MAX_RESULTS } from '../utils/constants.js';
+/**
+ * MCP Tool registry - single source of truth for tool definitions
+ */
+export const TOOL_DEFINITIONS = [
+    {
+        name: 'searchGitLabDocs',
+        description: 'Search GitLab documentation for CI/CD pipelines, runners, API, administration, deployment, security, container registry, Kubernetes integration, and all GitLab features. Covers 2,494 pages including tutorials, configuration guides, troubleshooting, and best practices.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query',
+                },
+                maxResults: {
+                    type: 'number',
+                    description: 'Maximum results to return (default: 10)',
+                    default: DEFAULT_MAX_RESULTS,
+                },
+                section: {
+                    type: 'string',
+                    description: 'Filter by documentation section (optional)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'getDocPage',
+        description: 'Get the complete content of any GitLab documentation page including detailed configuration examples, code snippets, and step-by-step guides for GitLab features',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Document path (e.g., "ci/README.md")',
+                },
+            },
+            required: ['path'],
+        },
+    },
+    {
+        name: 'listDocSections',
+        description: 'Browse GitLab documentation structure including sections for CI/CD, API, administration, user guides, development, security, operations, and integrations',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/**
+ * Get tool definition by name
+ */
+export function getToolDefinition(name) {
+    return TOOL_DEFINITIONS.find((tool) => tool.name === name);
+}
+/**
+ * Validate tool name exists
+ */
+export function isValidToolName(name) {
+    return TOOL_DEFINITIONS.some((tool) => tool.name === name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAW;IACtC;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,8QAA8Q;QAC3R,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,cAAc;iBAC5B;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;oBACtD,OAAO,EAAE,mBAAmB;iBAC7B;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iKAAiK;QAC9K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,2JAA2J;QACxK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/tools/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/tools/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/tools/registry.test.ts"],"names":[],"mappings":""}

package/dist/tools/registry.test.js

@@ -0,0 +1,45 @@
+import { describe, it, expect } from 'vitest';
+import { TOOL_DEFINITIONS, getToolDefinition, isValidToolName } from './registry.js';
+describe('Tool Registry', () => {
+    it('should have all tool definitions', () => {
+        expect(TOOL_DEFINITIONS).toHaveLength(3);
+        const toolNames = TOOL_DEFINITIONS.map((t) => t.name);
+        expect(toolNames).toContain('searchGitLabDocs');
+        expect(toolNames).toContain('getDocPage');
+        expect(toolNames).toContain('listDocSections');
+    });
+    it('should get tool definition by name', () => {
+        const searchTool = getToolDefinition('searchGitLabDocs');
+        expect(searchTool).toBeDefined();
+        expect(searchTool?.name).toBe('searchGitLabDocs');
+        expect(searchTool?.description).toContain('Search GitLab documentation');
+        const getPageTool = getToolDefinition('getDocPage');
+        expect(getPageTool).toBeDefined();
+        expect(getPageTool?.name).toBe('getDocPage');
+        const listSectionsTool = getToolDefinition('listDocSections');
+        expect(listSectionsTool).toBeDefined();
+        expect(listSectionsTool?.name).toBe('listDocSections');
+    });
+    it('should return undefined for unknown tool', () => {
+        const unknownTool = getToolDefinition('unknownTool');
+        expect(unknownTool).toBeUndefined();
+    });
+    it('should validate tool names', () => {
+        expect(isValidToolName('searchGitLabDocs')).toBe(true);
+        expect(isValidToolName('getDocPage')).toBe(true);
+        expect(isValidToolName('listDocSections')).toBe(true);
+        expect(isValidToolName('unknownTool')).toBe(false);
+    });
+    it('should have valid input schemas', () => {
+        const searchTool = getToolDefinition('searchGitLabDocs');
+        expect(searchTool?.inputSchema).toBeDefined();
+        expect(searchTool?.inputSchema.type).toBe('object');
+        expect(searchTool?.inputSchema.properties).toBeDefined();
+        expect(searchTool?.inputSchema.required).toContain('query');
+        const getPageTool = getToolDefinition('getDocPage');
+        expect(getPageTool?.inputSchema.required).toContain('path');
+        const listSectionsTool = getToolDefinition('listDocSections');
+        expect(listSectionsTool?.inputSchema.properties).toBeDefined();
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/tools/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../src/tools/registry.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/searchGitLabDocs.d.ts

@@ -0,0 +1,19 @@
+import type { SearchEngine } from '../search/engine.js';
+import type { DocumentTree } from '../search/document.js';
+import type { MarkdownParser } from '../content/parser.js';
+import type { ContentCache } from '../content/cache.js';
+import type { Config } from '../config.js';
+export interface ToolContext {
+    searchEngine: SearchEngine;
+    docTree: DocumentTree;
+    parser: MarkdownParser;
+    cache: ContentCache;
+    config: Config;
+}
+export declare function searchGitLabDocsTool(args: unknown, context: ToolContext): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=searchGitLabDocs.d.ts.map

package/dist/tools/searchGitLabDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchGitLabDocs.d.ts","sourceRoot":"","sources":["../../src/tools/searchGitLabDocs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW;;;;;EAuBvE"}

package/dist/tools/searchGitLabDocs.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { SearchResponseSchema } from '../types/models.js';
+import { DEFAULT_MAX_RESULTS, MAX_ALLOWED_RESULTS } from '../utils/constants.js';
+const SearchArgsSchema = z.object({
+    query: z.string().min(1),
+    maxResults: z.number().int().min(1).max(MAX_ALLOWED_RESULTS).default(DEFAULT_MAX_RESULTS),
+    section: z.string().optional(),
+});
+export function searchGitLabDocsTool(args, context) {
+    // Validate arguments
+    const { query, maxResults, section } = SearchArgsSchema.parse(args);
+    // Perform search
+    const { results, total } = context.searchEngine.search(query, maxResults, section, context.config.search.minScore);
+    // Validate response
+    const response = SearchResponseSchema.parse({ results, total });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=searchGitLabDocs.js.map

package/dist/tools/searchGitLabDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchGitLabDocs.js","sourceRoot":"","sources":["../../src/tools/searchGitLabDocs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAUjF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,IAAa,EAAE,OAAoB;IACtE,qBAAqB;IACrB,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEpE,iBAAiB;IACjB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CACpD,KAAK,EACL,UAAU,EACV,OAAO,EACP,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAC/B,CAAC;IAEF,oBAAoB;IACpB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAEhE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;aACxC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './models.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from './models.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/types/models.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+export declare const DocumentSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    title: z.ZodString;
+    section: z.ZodString;
+    content: z.ZodString;
+    version: z.ZodString;
+    lastUpdated: z.ZodDate;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const SearchResultSchema: z.ZodObject<{
+    title: z.ZodString;
+    path: z.ZodString;
+    url: z.ZodString;
+    excerpt: z.ZodString;
+    score: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SearchResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        path: z.ZodString;
+        url: z.ZodString;
+        excerpt: z.ZodString;
+        score: z.ZodNumber;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DocPageResponseSchema: z.ZodObject<{
+    title: z.ZodString;
+    path: z.ZodString;
+    url: z.ZodString;
+    content: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const DocSectionSchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    pageCount: z.ZodNumber;
+    subsections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ListSectionsResponseSchema: z.ZodObject<{
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        pageCount: z.ZodNumber;
+        subsections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type Document = z.infer<typeof DocumentSchema>;
+export type SearchResult = z.infer<typeof SearchResultSchema>;
+export type SearchResponse = z.infer<typeof SearchResponseSchema>;
+export type DocPageResponse = z.infer<typeof DocPageResponseSchema>;
+export type DocSection = z.infer<typeof DocSectionSchema>;
+export type ListSectionsResponse = z.infer<typeof ListSectionsResponseSchema>;
+//# sourceMappingURL=models.d.ts.map

package/dist/types/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;;iBASzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;iBAGrC,CAAC;AAGH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/types/models.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+// Zod schemas for runtime validation
+export const DocumentSchema = z.object({
+    id: z.string(),
+    path: z.string(),
+    title: z.string(),
+    section: z.string(),
+    content: z.string(),
+    version: z.string(),
+    lastUpdated: z.date(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const SearchResultSchema = z.object({
+    title: z.string(),
+    path: z.string(),
+    url: z.string(),
+    excerpt: z.string(),
+    score: z.number(),
+});
+export const SearchResponseSchema = z.object({
+    results: z.array(SearchResultSchema),
+    total: z.number(),
+});
+export const DocPageResponseSchema = z.object({
+    title: z.string(),
+    path: z.string(),
+    url: z.string(),
+    content: z.string(),
+    metadata: z.record(z.string(), z.unknown()),
+});
+export const DocSectionSchema = z.object({
+    name: z.string(),
+    path: z.string(),
+    pageCount: z.number(),
+    subsections: z.array(z.string()).optional(),
+});
+export const ListSectionsResponseSchema = z.object({
+    sections: z.array(DocSectionSchema),
+    total: z.number(),
+});
+//# sourceMappingURL=models.js.map

package/dist/types/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/types/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC"}

package/dist/utils/constants.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Application constants
+ */
+export declare const SERVER_VERSION = "1.0.0";
+export declare const SERVER_NAME = "gitlab-docs-mcp";
+export declare const DEFAULT_MAX_RESULTS = 10;
+export declare const MAX_ALLOWED_RESULTS = 50;
+export declare const MIN_SEARCH_SCORE = 0;
+export declare const DEFAULT_EXCERPT_LENGTH = 200;
+export declare const EXCERPT_CONTEXT_BEFORE = 50;
+export declare const EXCERPT_CONTEXT_AFTER = 150;
+export declare const SCORE_TITLE_MATCH = 3;
+export declare const SCORE_SECTION_MATCH = 1.5;
+export declare const SCORE_CONTENT_MATCH = 0.5;
+export declare const SCORE_MAX_CONTENT = 5;
+export declare const SCORE_MAX = 10;
+export declare const DEFAULT_CACHE_SIZE_MB = 50;
+export declare const DEFAULT_CACHE_ENTRIES = 100;
+export declare const DEFAULT_CACHE_TTL_MINUTES = 60;
+export declare const INDEX_VERSION = "1.0.0";
+export declare const GITLAB_DOCS_URL = "https://docs.gitlab.com/";
+export declare const GITLAB_DOCS_REPO = "https://gitlab.com/gitlab-org/gitlab-docs";
+export declare const DEFAULT_INDEX_PATH = "data/gitlab-docs";
+export declare const INDEX_META_FILE = "index_meta.json";
+export declare const INDEX_DOCS_FILE = "documents.json";
+export declare const DOCS_REPO_PATH = "data/gitlab-docs-repo/doc";
+export declare const FLEXSEARCH_TOKENIZE = "forward";
+export declare const FLEXSEARCH_RESOLUTION = 9;
+export declare const FLEXSEARCH_MIN_LENGTH = 2;
+export declare const FLEXSEARCH_CACHE_SIZE = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAG7C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAM,CAAC;AACpC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAGzC,eAAO,MAAM,iBAAiB,IAAM,CAAC;AACrC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,IAAM,CAAC;AACrC,eAAO,MAAM,SAAS,KAAO,CAAC;AAG9B,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAG5C,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,eAAO,MAAM,gBAAgB,8CAA8C,CAAC;AAG5E,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,cAAc,8BAA8B,CAAC;AAG1D,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,MAAM,CAAC"}

package/dist/utils/constants.js

@@ -0,0 +1,38 @@
+/**
+ * Application constants
+ */
+// Server configuration
+export const SERVER_VERSION = '1.0.0';
+export const SERVER_NAME = 'gitlab-docs-mcp';
+// Search configuration
+export const DEFAULT_MAX_RESULTS = 10;
+export const MAX_ALLOWED_RESULTS = 50;
+export const MIN_SEARCH_SCORE = 0.0;
+export const DEFAULT_EXCERPT_LENGTH = 200;
+export const EXCERPT_CONTEXT_BEFORE = 50;
+export const EXCERPT_CONTEXT_AFTER = 150;
+// Scoring weights
+export const SCORE_TITLE_MATCH = 3.0;
+export const SCORE_SECTION_MATCH = 1.5;
+export const SCORE_CONTENT_MATCH = 0.5;
+export const SCORE_MAX_CONTENT = 5.0;
+export const SCORE_MAX = 10.0;
+// Cache configuration defaults
+export const DEFAULT_CACHE_SIZE_MB = 50;
+export const DEFAULT_CACHE_ENTRIES = 100;
+export const DEFAULT_CACHE_TTL_MINUTES = 60;
+// Index configuration
+export const INDEX_VERSION = '1.0.0';
+export const GITLAB_DOCS_URL = 'https://docs.gitlab.com/';
+export const GITLAB_DOCS_REPO = 'https://gitlab.com/gitlab-org/gitlab-docs';
+// File paths
+export const DEFAULT_INDEX_PATH = 'data/gitlab-docs';
+export const INDEX_META_FILE = 'index_meta.json';
+export const INDEX_DOCS_FILE = 'documents.json';
+export const DOCS_REPO_PATH = 'data/gitlab-docs-repo/doc';
+// Flexsearch configuration
+export const FLEXSEARCH_TOKENIZE = 'forward';
+export const FLEXSEARCH_RESOLUTION = 9;
+export const FLEXSEARCH_MIN_LENGTH = 2;
+export const FLEXSEARCH_CACHE_SIZE = 100;
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uBAAuB;AACvB,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE7C,uBAAuB;AACvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,kBAAkB;AAClB,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAE9B,+BAA+B;AAC/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,sBAAsB;AACtB,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,2CAA2C,CAAC;AAE5E,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC"}

package/dist/utils/constants.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=constants.test.d.ts.map

package/dist/utils/constants.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.test.d.ts","sourceRoot":"","sources":["../../src/utils/constants.test.ts"],"names":[],"mappings":""}

package/dist/utils/constants.test.js

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'vitest';
+import { SERVER_VERSION, DEFAULT_MAX_RESULTS, SCORE_TITLE_MATCH, SCORE_SECTION_MATCH, SCORE_MAX, } from '../utils/constants.js';
+describe('Constants', () => {
+    it('should have valid server configuration', () => {
+        expect(SERVER_VERSION).toMatch(/^\d+\.\d+\.\d+$/);
+        expect(typeof DEFAULT_MAX_RESULTS).toBe('number');
+        expect(DEFAULT_MAX_RESULTS).toBeGreaterThan(0);
+    });
+    it('should have valid score weights', () => {
+        expect(SCORE_TITLE_MATCH).toBeGreaterThan(0);
+        expect(SCORE_SECTION_MATCH).toBeGreaterThan(0);
+        expect(SCORE_TITLE_MATCH).toBeGreaterThan(SCORE_SECTION_MATCH);
+        expect(SCORE_MAX).toBeGreaterThan(SCORE_TITLE_MATCH);
+    });
+});
+//# sourceMappingURL=constants.test.js.map

package/dist/utils/constants.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.test.js","sourceRoot":"","sources":["../../src/utils/constants.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,SAAS,GACV,MAAM,uBAAuB,CAAC;AAE/B,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,CAAC,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,mBAAmB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Custom error types for better error handling
+ */
+export declare class GitLabDocsError extends Error {
+    constructor(message: string);
+}
+export declare class IndexNotFoundError extends GitLabDocsError {
+    constructor(indexPath: string);
+}
+export declare class DocumentNotFoundError extends GitLabDocsError {
+    constructor(path: string);
+}
+export declare class InvalidSearchQueryError extends GitLabDocsError {
+    constructor(reason: string);
+}
+export declare class IndexLoadError extends GitLabDocsError {
+    constructor(message: string, cause?: Error);
+}
+export declare class ToolExecutionError extends GitLabDocsError {
+    constructor(toolName: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,MAAM,EAAE,MAAM;CAI3B;AAED,qBAAa,cAAe,SAAQ,eAAe;gBACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI9C"}

package/dist/utils/errors.js

@@ -0,0 +1,43 @@
+/**
+ * Custom error types for better error handling
+ */
+export class GitLabDocsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GitLabDocsError';
+    }
+}
+export class IndexNotFoundError extends GitLabDocsError {
+    constructor(indexPath) {
+        super(`Index not found at ${indexPath}. Run 'npm run build-index' to create it.`);
+        this.name = 'IndexNotFoundError';
+    }
+}
+export class DocumentNotFoundError extends GitLabDocsError {
+    constructor(path) {
+        super(`Document not found: ${path}`);
+        this.name = 'DocumentNotFoundError';
+    }
+}
+export class InvalidSearchQueryError extends GitLabDocsError {
+    constructor(reason) {
+        super(`Invalid search query: ${reason}`);
+        this.name = 'InvalidSearchQueryError';
+    }
+}
+export class IndexLoadError extends GitLabDocsError {
+    constructor(message, cause) {
+        super(`Failed to load index: ${message}`);
+        this.name = 'IndexLoadError';
+        if (cause) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+}
+export class ToolExecutionError extends GitLabDocsError {
+    constructor(toolName, message) {
+        super(`Tool '${toolName}' execution failed: ${message}`);
+        this.name = 'ToolExecutionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,SAAiB;QAC3B,KAAK,CAAC,sBAAsB,SAAS,2CAA2C,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,YAAY,IAAY;QACtB,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IAC1D,YAAY,MAAc;QACxB,KAAK,CAAC,yBAAyB,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,QAAgB,EAAE,OAAe;QAC3C,KAAK,CAAC,SAAS,QAAQ,uBAAuB,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/utils/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/utils/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/utils/errors.test.ts"],"names":[],"mappings":""}

package/dist/utils/errors.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest';
+import { GitLabDocsError, IndexNotFoundError, DocumentNotFoundError, InvalidSearchQueryError, IndexLoadError, ToolExecutionError, } from '../utils/errors.js';
+describe('Custom Errors', () => {
+    describe('GitLabDocsError', () => {
+        it('should create error with message', () => {
+            const error = new GitLabDocsError('Test error');
+            expect(error.message).toBe('Test error');
+            expect(error.name).toBe('GitLabDocsError');
+            expect(error).toBeInstanceOf(Error);
+        });
+    });
+    describe('IndexNotFoundError', () => {
+        it('should format error message with path', () => {
+            const error = new IndexNotFoundError('/test/path');
+            expect(error.message).toContain('/test/path');
+            expect(error.message).toContain('npm run build-index');
+            expect(error.name).toBe('IndexNotFoundError');
+        });
+    });
+    describe('DocumentNotFoundError', () => {
+        it('should format error message with document path', () => {
+            const error = new DocumentNotFoundError('ci/README.md');
+            expect(error.message).toBe('Document not found: ci/README.md');
+            expect(error.name).toBe('DocumentNotFoundError');
+        });
+    });
+    describe('InvalidSearchQueryError', () => {
+        it('should format error message with reason', () => {
+            const error = new InvalidSearchQueryError('query too short');
+            expect(error.message).toBe('Invalid search query: query too short');
+            expect(error.name).toBe('InvalidSearchQueryError');
+        });
+    });
+    describe('IndexLoadError', () => {
+        it('should create error with message', () => {
+            const error = new IndexLoadError('Failed to parse JSON');
+            expect(error.message).toContain('Failed to load index');
+            expect(error.message).toContain('Failed to parse JSON');
+            expect(error.name).toBe('IndexLoadError');
+        });
+        it('should include cause stack trace', () => {
+            const cause = new Error('Original error');
+            const error = new IndexLoadError('Failed', cause);
+            expect(error.stack).toContain('Caused by:');
+        });
+    });
+    describe('ToolExecutionError', () => {
+        it('should format error message with tool name', () => {
+            const error = new ToolExecutionError('searchGitLabDocs', 'Invalid arguments');
+            expect(error.message).toBe("Tool 'searchGitLabDocs' execution failed: Invalid arguments");
+            expect(error.name).toBe('ToolExecutionError');
+        });
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/utils/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/utils/errors.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './logger.js';
+export * from './constants.js';
+export * from './errors.js';
+export * from './performance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+export * from './logger.js';
+export * from './constants.js';
+export * from './errors.js';
+export * from './performance.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Logging utility for MCP server
+ * Provides structured logging with levels
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACX;AAED,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;gBAEZ,KAAK,GAAE,QAAwB;IAI3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKjD;AAGD,eAAO,MAAM,MAAM,QAElB,CAAC"}