@gitscrum-studio/mcp-server 1.0.0

package/dist/tools/notes.js

@@ -0,0 +1,201 @@
+import { executeAction, success, required, normalizeColor } from "./shared/actionHandler.js";
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerNoteTools() {
+    return [
+        {
+            name: "note",
+            description: [
+                "Notes. Actions: list, get, create, update, share, revisions.",
+                "",
+                "company_slug is optional (auto-inferred from user).",
+                "'get'/'update'/'share'/'revisions' require uuid (from 'list' response).",
+            ].join("\n"),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        enum: ["list", "get", "create", "update", "share", "revisions"],
+                        description: "Which operation to perform"
+                    },
+                    company_slug: {
+                        type: "string",
+                        description: "Workspace identifier (optional - auto-detected from user if not provided)"
+                    },
+                    uuid: {
+                        type: "string",
+                        description: "⚠️ ONLY for existing notes! This is the note's database ID. NEVER use for action=create. Use ONLY for: get, update, share, revisions."
+                    },
+                    title: {
+                        type: "string",
+                        description: "Note title/heading text. Required for action=create."
+                    },
+                    content: {
+                        type: "string",
+                        description: "The note body text you want to save (Markdown). This is where you put the actual content! Required for action=create."
+                    },
+                    folder_uuid: {
+                        type: "string",
+                        description: "Folder ID to organize note into (optional)"
+                    },
+                    color: {
+                        type: "string",
+                        description: "Color code: gray, blue, red, green, yellow, purple, coral, amber, sky, lime (or hex without #)"
+                    },
+                    search: {
+                        type: "string",
+                        description: "Search term to filter notes (only for list action)"
+                    },
+                },
+                required: ["action"],
+            },
+            annotations: { title: "Notes", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        },
+        {
+            name: "note_folder",
+            description: [
+                "Note folders. Actions: list, create, update, move.",
+                "",
+                "'move' requires note_uuid (from 'note' tool 'list') and folder_uuid (from 'list' response).",
+            ].join("\n"),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        enum: ["list", "create", "update", "move"],
+                        description: "Which operation to perform"
+                    },
+                    company_slug: {
+                        type: "string",
+                        description: "Workspace identifier (always required)"
+                    },
+                    uuid: {
+                        type: "string",
+                        description: "Existing folder's unique ID. Only for update action."
+                    },
+                    name: {
+                        type: "string",
+                        description: "Folder name text. Required for create and update."
+                    },
+                    note_uuid: {
+                        type: "string",
+                        description: "Note ID to move. Required for move action."
+                    },
+                    folder_uuid: {
+                        type: "string",
+                        description: "Target folder ID to move note into. Omit to unfile note."
+                    },
+                },
+                required: ["action", "company_slug"],
+            },
+            annotations: { title: "Note Folders", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        },
+    ];
+}
+// ============================================================================
+// Note Action Handlers
+// ============================================================================
+const noteHandlers = {
+    list: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        const notes = await client.getNotes(args.company_slug, {
+            folder_uuid: args.folder_uuid,
+            color: args.color,
+            search: args.search,
+        });
+        return success(JSON.stringify(notes, null, 2));
+    },
+    get: async (client, args) => {
+        if (!args.uuid)
+            return required("uuid");
+        const note = await client.getNote(args.uuid, args.company_slug);
+        return success(JSON.stringify(note, null, 2));
+    },
+    create: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        const note = await client.createNote({
+            title: args.title,
+            content: args.content,
+            company_slug: args.company_slug,
+            folder_uuid: args.folder_uuid,
+            color: args.color ? normalizeColor(args.color) : undefined,
+        });
+        return success(JSON.stringify({ created: true, note }, null, 2));
+    },
+    update: async (client, args) => {
+        if (!args.uuid)
+            return required("uuid");
+        const updateData = {};
+        if (args.title)
+            updateData.title = args.title;
+        if (args.content)
+            updateData.content = args.content;
+        if (args.folder_uuid)
+            updateData.folder_uuid = args.folder_uuid;
+        if (args.color)
+            updateData.color = normalizeColor(args.color);
+        await client.updateNote(args.uuid, updateData);
+        return success(JSON.stringify({ updated: true, uuid: args.uuid }, null, 2));
+    },
+    share: async (client, args) => {
+        if (!args.uuid)
+            return required("uuid");
+        const note = await client.toggleNoteShare(args.uuid);
+        return success(JSON.stringify(note, null, 2));
+    },
+    revisions: async (client, args) => {
+        if (!args.uuid)
+            return required("uuid");
+        if (!args.company_slug)
+            return required("company_slug");
+        const revisions = await client.getNoteRevisions(args.uuid, args.company_slug);
+        return success(JSON.stringify(revisions, null, 2));
+    },
+};
+// ============================================================================
+// Folder Action Handlers
+// ============================================================================
+const folderHandlers = {
+    list: async (client, args) => {
+        const folders = await client.getNoteFolders(args.company_slug);
+        return success(JSON.stringify(folders, null, 2));
+    },
+    create: async (client, args) => {
+        if (!args.name)
+            return required("name");
+        const folder = await client.createNoteFolder({ name: args.name, company_slug: args.company_slug });
+        return success(JSON.stringify({ created: true, folder }, null, 2));
+    },
+    update: async (client, args) => {
+        if (!args.uuid || !args.name)
+            return required("uuid and name");
+        await client.updateNoteFolder(args.uuid, { name: args.name });
+        return success(JSON.stringify({ updated: true, uuid: args.uuid }, null, 2));
+    },
+    move: async (client, args) => {
+        if (!args.note_uuid)
+            return required("note_uuid");
+        await client.moveNoteToFolder(args.note_uuid, args.folder_uuid || null);
+        return success(JSON.stringify({ moved: true, note_uuid: args.note_uuid, folder_uuid: args.folder_uuid || null }, null, 2));
+    },
+};
+// ============================================================================
+// Main Handler
+// ============================================================================
+export async function handleNoteTool(client, name, args = {}) {
+    const action = args.action;
+    // note_folder always requires company_slug
+    if (name === "note_folder") {
+        if (!args.company_slug)
+            return required("company_slug");
+        return executeAction(folderHandlers, action, client, args);
+    }
+    // note: validation is done per-action (get only needs uuid)
+    return executeAction(noteHandlers, action, client, args);
+}
+//# sourceMappingURL=notes.js.map

package/dist/tools/notes.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Project/Workspace MCP Tools (Consolidated)
+ *
+ * Uses Action Handler pattern for clean, extensible code.
+ * STATELESS - each call must provide all required parameters.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { GitScrumClient } from "../client/GitScrumClient.js";
+import { type ToolResponse } from "./shared/actionHandler.js";
+export declare function registerProjectTools(): Tool[];
+export declare function handleProjectTool(client: GitScrumClient, name: string, args?: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,2BAA2B,CAAC;AAMnC,wBAAgB,oBAAoB,IAAI,IAAI,EAAE,CAuF7C;AA2MD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,YAAY,CAAC,CAcvB"}

package/dist/tools/projects.js

@@ -0,0 +1,272 @@
+import { executeAction, success, required, resolveProjectContext } from "./shared/actionHandler.js";
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerProjectTools() {
+    return [
+        {
+            name: "workspace",
+            description: [
+                "Workspace management. Actions: list, find (by name), get, stats.",
+                "",
+                "This is the starting point. Use 'list' to get all workspaces and their company_slug.",
+                "company_slug is needed by most other tools.",
+            ].join("\n"),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        enum: ["list", "find", "get", "stats"],
+                        description: "Which operation to perform"
+                    },
+                    name: {
+                        type: "string",
+                        description: "Workspace name to search for. Required for: find"
+                    },
+                    company_slug: {
+                        type: "string",
+                        description: "Workspace identifier. Required for: get, stats"
+                    },
+                },
+                required: ["action"],
+            },
+            annotations: { title: "Workspaces", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        },
+        {
+            name: "project",
+            description: [
+                "Project management. Actions: create, find (by name), list, get, stats, tasks, workflows, types, efforts, labels, members.",
+                "",
+                "Workflow:",
+                "- 'list': requires company_slug (from 'workspace' tool). Returns projects with their project_slug.",
+                "- 'find': search by name, returns project_slug + company_slug",
+                "- 'workflows'/'types'/'efforts'/'labels': returns IDs used by 'task' tool for create/update",
+                "- 'members': returns project assignees (name, username, avatar). Use to know who can be assigned tasks",
+                "- 'create': requires company_slug + name",
+            ].join("\n"),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        enum: ["create", "find", "list", "get", "stats", "tasks", "workflows", "types", "efforts", "labels", "members"],
+                        description: "Which operation to perform"
+                    },
+                    name: {
+                        type: "string",
+                        description: "Project name. Required for: create, find"
+                    },
+                    company_slug: {
+                        type: "string",
+                        description: "Workspace identifier. Required for: create, list, get, stats, tasks, etc. Optional for: find"
+                    },
+                    project_slug: {
+                        type: "string",
+                        description: "Project identifier. Required for: get, stats, tasks, workflows, types, efforts, labels, members"
+                    },
+                    status: {
+                        type: "string",
+                        enum: ["in_progress", "completed", "archived"],
+                        description: "Filter projects by status. Optional for: list"
+                    },
+                    description: {
+                        type: "string",
+                        description: "Project description. Optional for: create"
+                    },
+                    visibility: {
+                        type: "string",
+                        enum: ["public", "private"],
+                        description: "Project visibility (default: public). Optional for: create"
+                    },
+                    client_uuid: {
+                        type: "string",
+                        description: "Client UUID to associate project with. Optional for: create"
+                    },
+                },
+                required: ["action"],
+            },
+            annotations: { title: "Projects", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        },
+    ];
+}
+// ============================================================================
+// Workspace Action Handlers
+// ============================================================================
+const workspaceHandlers = {
+    list: async (client) => {
+        const response = await client.getWorkspaces();
+        return success(JSON.stringify(response, null, 2));
+    },
+    find: async (client, args) => {
+        if (!args.name)
+            return required("name");
+        const workspace = await client.findWorkspaceByName(args.name);
+        if (!workspace) {
+            return success(JSON.stringify({ found: false, query: args.name }, null, 2));
+        }
+        const ctx = { company_slug: workspace.slug };
+        return success(JSON.stringify({ found: true, workspace }, null, 2), ctx);
+    },
+    get: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        const ws = await client.getWorkspace(args.company_slug);
+        const ctx = { company_slug: args.company_slug };
+        return success(JSON.stringify(ws, null, 2), ctx);
+    },
+    stats: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        const stats = await client.getWorkspaceStats(args.company_slug);
+        const ctx = { company_slug: args.company_slug };
+        return success(JSON.stringify(stats, null, 2), ctx);
+    },
+};
+// ============================================================================
+// Project Action Handlers
+// ============================================================================
+const projectHandlers = {
+    create: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        if (!args.name)
+            return required("name");
+        // Permission check is handled by the API
+        const result = await client.createProject(args.company_slug, {
+            name: args.name,
+            description: args.description,
+            visibility: args.visibility,
+            client_uuid: args.client_uuid,
+        });
+        const ctx = {
+            company_slug: args.company_slug,
+            project_slug: result.project_slug
+        };
+        return success(JSON.stringify({ created: true, project: result }, null, 2), ctx);
+    },
+    find: async (client, args) => {
+        if (!args.name)
+            return required("name");
+        const project = await client.findProjectByName(args.name, args.company_slug);
+        if (!project) {
+            return success(JSON.stringify({ found: false, query: args.name }, null, 2));
+        }
+        const ctx = { company_slug: project.company_slug, project_slug: project.project_slug };
+        return success(JSON.stringify({ found: true, project }, null, 2), ctx);
+    },
+    list: async (client, args) => {
+        if (!args.company_slug)
+            return required("company_slug");
+        const response = await client.getProjects(args.company_slug, { status: args.status });
+        const ctx = { company_slug: args.company_slug };
+        return success(JSON.stringify(response, null, 2), ctx);
+    },
+    get: async (client, args) => {
+        // Auto-resolve project context
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const project = await client.getProject(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(project, null, 2), ctx);
+    },
+    stats: async (client, args) => {
+        // Auto-resolve project context
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const stats = await client.getProjectStats(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(stats, null, 2), ctx);
+    },
+    tasks: async (client, args) => {
+        // Auto-resolve project context
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const tasks = await client.getProjectTasks(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(tasks, null, 2), ctx);
+    },
+    workflows: async (client, args) => {
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const workflows = await client.getProjectWorkflows(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(workflows, null, 2), ctx);
+    },
+    types: async (client, args) => {
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const types = await client.getProjectTypes(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(types, null, 2), ctx);
+    },
+    efforts: async (client, args) => {
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const efforts = await client.getProjectEfforts(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(efforts, null, 2), ctx);
+    },
+    labels: async (client, args) => {
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const labels = await client.getProjectLabels(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(labels, null, 2), ctx);
+    },
+    members: async (client, args) => {
+        const resolved = await resolveProjectContext(client, {
+            company_slug: args.company_slug,
+            project_slug: args.project_slug
+        });
+        if (!resolved)
+            return required("project_slug (or company_slug + project_slug)");
+        const members = await client.getProjectMembers(resolved.project_slug, resolved.company_slug);
+        const ctx = { company_slug: resolved.company_slug, project_slug: resolved.project_slug };
+        return success(JSON.stringify(members, null, 2), ctx);
+    },
+};
+// ============================================================================
+// Main Handler
+// ============================================================================
+export async function handleProjectTool(client, name, args = {}) {
+    const action = args.action;
+    switch (name) {
+        case "workspace":
+            return executeAction(workspaceHandlers, action, client, args);
+        case "project":
+            // Handlers now use auto-resolution for missing company_slug
+            return executeAction(projectHandlers, action, client, args);
+        default:
+            return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+    }
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Search Tools
+ *
+ * MCP tools for searching across GitScrum entities
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { GitScrumClient } from "../client/GitScrumClient.js";
+import { type ToolResponse } from "./shared/actionHandler.js";
+/**
+ * Register search tools
+ */
+export declare function registerSearchTools(): Tool[];
+/**
+ * Handle search tool calls
+ */
+export declare function handleSearchTool(client: GitScrumClient, _name: string, args?: Record<string, unknown>): Promise<ToolResponse>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,EAAE,CA+B5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,YAAY,CAAC,CAavB"}

package/dist/tools/search.js

@@ -0,0 +1,56 @@
+/**
+ * Search Tools
+ *
+ * MCP tools for searching across GitScrum entities
+ */
+import { success, required } from "./shared/actionHandler.js";
+/**
+ * Register search tools
+ */
+export function registerSearchTools() {
+    return [
+        {
+            name: "search",
+            description: [
+                "Search across workspaces, projects, tasks, sprints, wiki, notes by name.",
+                "",
+                "Use to discover slugs and UUIDs needed by other tools.",
+                "Results include entity type, name, and identifiers.",
+            ].join("\n"),
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Search text (min 2 chars)",
+                    },
+                    categories: {
+                        type: "string",
+                        description: "Filter: workspaces, tasks, projects, user_stories, sprints, wiki, notes",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Results per category (default: 5)",
+                    },
+                },
+                required: ["query"],
+            },
+            annotations: { title: "Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        },
+    ];
+}
+/**
+ * Handle search tool calls
+ */
+export async function handleSearchTool(client, _name, args = {}) {
+    const query = args.query;
+    if (!query || query.length < 2) {
+        return required("query (min 2 chars)");
+    }
+    const results = await client.search(query, {
+        categories: args.categories,
+        limit: args.limit,
+    });
+    return success(JSON.stringify(results, null, 2));
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,OAAO,EACP,QAAQ,EAET,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE;gBACX,0EAA0E;gBAC1E,EAAE;gBACF,wDAAwD;gBACxD,qDAAqD;aACtD,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2BAA2B;qBACzC;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yEAAyE;qBACvF;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mCAAmC;qBACjD;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SACzH;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,KAAa,EACb,OAAgC,EAAE;IAElC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;IAEnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QACzC,UAAU,EAAE,IAAI,CAAC,UAAgC;QACjD,KAAK,EAAE,IAAI,CAAC,KAA2B;KACxC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}