@sam2kb/m365-mcp 1.0.0

package/dist/tools/contacts.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Contacts tools — list, search, read, create, update, delete
+ */
+import type { GraphClient } from "../graph.js";
+export declare function registerContactsTools(client: GraphClient): {
+    contacts_list(args: {
+        top?: number;
+        folderId?: string;
+    }): Promise<string>;
+    contacts_search(args: {
+        query: string;
+        top?: number;
+    }): Promise<string>;
+    contacts_read(args: {
+        contactId: string;
+    }): Promise<string>;
+    contacts_create(args: {
+        givenName?: string;
+        surname?: string;
+        email?: string;
+        company?: string;
+        jobTitle?: string;
+        mobilePhone?: string;
+        businessPhone?: string;
+        notes?: string;
+    }): Promise<string>;
+    contacts_update(args: {
+        contactId: string;
+        givenName?: string;
+        surname?: string;
+        email?: string;
+        company?: string;
+        jobTitle?: string;
+        mobilePhone?: string;
+    }): Promise<string>;
+    contacts_delete(args: {
+        contactId: string;
+    }): Promise<string>;
+};
+export declare const contactsToolSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            top: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            folderId: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            contactId?: undefined;
+            givenName?: undefined;
+            surname?: undefined;
+            email?: undefined;
+            company?: undefined;
+            jobTitle?: undefined;
+            mobilePhone?: undefined;
+            businessPhone?: undefined;
+            notes?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            top: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            folderId?: undefined;
+            contactId?: undefined;
+            givenName?: undefined;
+            surname?: undefined;
+            email?: undefined;
+            company?: undefined;
+            jobTitle?: undefined;
+            mobilePhone?: undefined;
+            businessPhone?: undefined;
+            notes?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            contactId: {
+                type: string;
+                description: string;
+            };
+            top?: undefined;
+            folderId?: undefined;
+            query?: undefined;
+            givenName?: undefined;
+            surname?: undefined;
+            email?: undefined;
+            company?: undefined;
+            jobTitle?: undefined;
+            mobilePhone?: undefined;
+            businessPhone?: undefined;
+            notes?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            givenName: {
+                type: string;
+                description: string;
+            };
+            surname: {
+                type: string;
+                description: string;
+            };
+            email: {
+                type: string;
+                description: string;
+            };
+            company: {
+                type: string;
+                description: string;
+            };
+            jobTitle: {
+                type: string;
+                description: string;
+            };
+            mobilePhone: {
+                type: string;
+                description: string;
+            };
+            businessPhone: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+            top?: undefined;
+            folderId?: undefined;
+            query?: undefined;
+            contactId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            contactId: {
+                type: string;
+                description: string;
+            };
+            givenName: {
+                type: string;
+                description?: undefined;
+            };
+            surname: {
+                type: string;
+                description?: undefined;
+            };
+            email: {
+                type: string;
+                description?: undefined;
+            };
+            company: {
+                type: string;
+                description?: undefined;
+            };
+            jobTitle: {
+                type: string;
+                description?: undefined;
+            };
+            mobilePhone: {
+                type: string;
+                description?: undefined;
+            };
+            top?: undefined;
+            folderId?: undefined;
+            query?: undefined;
+            businessPhone?: undefined;
+            notes?: undefined;
+        };
+        required: string[];
+    };
+})[];

package/dist/tools/contacts.js

@@ -0,0 +1,169 @@
+/**
+ * Contacts tools — list, search, read, create, update, delete
+ */
+export function registerContactsTools(client) {
+    const user = "/me";
+    return {
+        async contacts_list(args) {
+            const top = args.top || 50;
+            const folderPath = args.folderId
+                ? `/contactFolders/${encodeURIComponent(args.folderId)}`
+                : "";
+            const path = `${user}${folderPath}/contacts?$top=${top}&$orderby=displayName`;
+            const contacts = await client.getAll(path, 10, top);
+            return JSON.stringify(contacts.map((c) => ({
+                id: c.id,
+                name: c.displayName,
+                email: c.emailAddresses?.[0]?.address,
+                company: c.companyName,
+                jobTitle: c.jobTitle,
+                phones: c.businessPhones,
+                mobile: c.mobilePhone,
+            })), null, 2);
+        },
+        async contacts_search(args) {
+            const top = args.top || 20;
+            const path = `${user}/contacts?$search="${encodeURIComponent(args.query)}"&$top=${top}`;
+            const contacts = await client.getAll(path, 10, top);
+            return JSON.stringify(contacts.map((c) => ({
+                id: c.id,
+                name: c.displayName,
+                email: c.emailAddresses?.map((e) => e.address).join(", "),
+                company: c.companyName,
+                jobTitle: c.jobTitle,
+            })), null, 2);
+        },
+        async contacts_read(args) {
+            const contactId = encodeURIComponent(args.contactId);
+            const c = await client.get(`${user}/contacts/${contactId}`);
+            return JSON.stringify(c, null, 2);
+        },
+        async contacts_create(args) {
+            const contact = {};
+            if (args.givenName)
+                contact.givenName = args.givenName;
+            if (args.surname)
+                contact.surname = args.surname;
+            if (args.email) {
+                contact.emailAddresses = [{ address: args.email, name: `${args.givenName || ""} ${args.surname || ""}`.trim() }];
+            }
+            if (args.company)
+                contact.companyName = args.company;
+            if (args.jobTitle)
+                contact.jobTitle = args.jobTitle;
+            if (args.mobilePhone)
+                contact.mobilePhone = args.mobilePhone;
+            if (args.businessPhone)
+                contact.businessPhones = [args.businessPhone];
+            if (args.notes)
+                contact.personalNotes = args.notes;
+            const data = await client.post(`${user}/contacts`, contact);
+            return JSON.stringify({ id: data.id, displayName: data.displayName, success: true }, null, 2);
+        },
+        async contacts_update(args) {
+            const patch = {};
+            if (args.givenName)
+                patch.givenName = args.givenName;
+            if (args.surname)
+                patch.surname = args.surname;
+            if (args.email)
+                patch.emailAddresses = [{ address: args.email }];
+            if (args.company)
+                patch.companyName = args.company;
+            if (args.jobTitle)
+                patch.jobTitle = args.jobTitle;
+            if (args.mobilePhone)
+                patch.mobilePhone = args.mobilePhone;
+            const contactId = encodeURIComponent(args.contactId);
+            await client.patch(`${user}/contacts/${contactId}`, patch);
+            return JSON.stringify({ success: true, contactId: args.contactId });
+        },
+        async contacts_delete(args) {
+            const contactId = encodeURIComponent(args.contactId);
+            await client.delete(`${user}/contacts/${contactId}`);
+            return JSON.stringify({ success: true });
+        },
+    };
+}
+export const contactsToolSchemas = [
+    {
+        name: "m365_contacts_list",
+        description: "List your contacts",
+        inputSchema: {
+            type: "object",
+            properties: {
+                top: { type: "number", description: "Max results", default: 50 },
+                folderId: { type: "string", description: "Contact folder ID (optional)" },
+            },
+        },
+    },
+    {
+        name: "m365_contacts_search",
+        description: "Search your contacts by name, email, or company",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                top: { type: "number", description: "Max results", default: 20 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "m365_contacts_read",
+        description: "Read a contact's full details",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contactId: { type: "string", description: "Contact ID" },
+            },
+            required: ["contactId"],
+        },
+    },
+    {
+        name: "m365_contacts_create",
+        description: "Create a new contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                givenName: { type: "string", description: "First name" },
+                surname: { type: "string", description: "Last name" },
+                email: { type: "string", description: "Email address" },
+                company: { type: "string", description: "Company name" },
+                jobTitle: { type: "string", description: "Job title" },
+                mobilePhone: { type: "string", description: "Mobile phone" },
+                businessPhone: { type: "string", description: "Business phone" },
+                notes: { type: "string", description: "Personal notes" },
+            },
+        },
+    },
+    {
+        name: "m365_contacts_update",
+        description: "Update an existing contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contactId: { type: "string", description: "Contact ID" },
+                givenName: { type: "string" },
+                surname: { type: "string" },
+                email: { type: "string" },
+                company: { type: "string" },
+                jobTitle: { type: "string" },
+                mobilePhone: { type: "string" },
+            },
+            required: ["contactId"],
+        },
+    },
+    {
+        name: "m365_contacts_delete",
+        description: "Delete a contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contactId: { type: "string", description: "Contact ID" },
+            },
+            required: ["contactId"],
+        },
+    },
+];
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

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

package/dist/tools/files.d.ts

@@ -0,0 +1,135 @@
+/**
+ * OneDrive files tools — list, search, read, info, create folder
+ */
+import type { GraphClient } from "../graph.js";
+export declare function registerFilesTools(client: GraphClient): {
+    files_list(args: {
+        path?: string;
+        top?: number;
+    }): Promise<string>;
+    files_search(args: {
+        query: string;
+        top?: number;
+    }): Promise<string>;
+    files_read(args: {
+        itemId: string;
+        maxBytes?: number;
+    }): Promise<string>;
+    files_info(args: {
+        itemId: string;
+    }): Promise<string>;
+    files_create_folder(args: {
+        name: string;
+        parentPath?: string;
+    }): Promise<string>;
+};
+export declare const filesToolSchemas: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            path: {
+                type: string;
+                description: string;
+            };
+            top: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            query?: undefined;
+            itemId?: undefined;
+            maxBytes?: undefined;
+            name?: undefined;
+            parentPath?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            top: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            path?: undefined;
+            itemId?: undefined;
+            maxBytes?: undefined;
+            name?: undefined;
+            parentPath?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            itemId: {
+                type: string;
+                description: string;
+            };
+            maxBytes: {
+                type: string;
+                description: string;
+            };
+            path?: undefined;
+            top?: undefined;
+            query?: undefined;
+            name?: undefined;
+            parentPath?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            itemId: {
+                type: string;
+                description: string;
+            };
+            path?: undefined;
+            top?: undefined;
+            query?: undefined;
+            maxBytes?: undefined;
+            name?: undefined;
+            parentPath?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            parentPath: {
+                type: string;
+                description: string;
+            };
+            path?: undefined;
+            top?: undefined;
+            query?: undefined;
+            itemId?: undefined;
+            maxBytes?: undefined;
+        };
+        required: string[];
+    };
+})[];

package/dist/tools/files.js

@@ -0,0 +1,127 @@
+/**
+ * OneDrive files tools — list, search, read, info, create folder
+ */
+function encodeDrivePath(value) {
+    return value.split("/").filter(Boolean).map(encodeURIComponent).join("/");
+}
+export function registerFilesTools(client) {
+    const user = "/me";
+    return {
+        async files_list(args) {
+            const top = args.top || 50;
+            const folderPath = args.path ? `:/${encodeDrivePath(args.path)}:` : "";
+            const path = `${user}/drive/root${folderPath}/children?$top=${top}&$select=id,name,size,folder,file,webUrl,lastModifiedDateTime`;
+            const items = await client.getAll(path, 10, top);
+            return JSON.stringify(items.map((f) => ({
+                id: f.id,
+                name: f.name,
+                size: f.size,
+                isFolder: !!f.folder,
+                childCount: f.folder?.childCount,
+                mimeType: f.file?.mimeType,
+                modified: f.lastModifiedDateTime,
+                webUrl: f.webUrl,
+            })), null, 2);
+        },
+        async files_search(args) {
+            const top = args.top || 20;
+            const query = encodeURIComponent(args.query.replace(/'/g, "''")).replace(/'/g, "%27");
+            const path = `${user}/drive/root/search(q='${query}')?$top=${top}&$select=id,name,size,file,webUrl,parentReference`;
+            const items = await client.getAll(path, 10, top);
+            return JSON.stringify(items.map((f) => ({
+                id: f.id,
+                name: f.name,
+                size: f.size,
+                path: f.parentReference?.path,
+                webUrl: f.webUrl,
+            })), null, 2);
+        },
+        async files_read(args) {
+            // Get item metadata first to find download URL
+            const itemId = encodeURIComponent(args.itemId);
+            const meta = await client.get(`${user}/drive/items/${itemId}`);
+            const downloadUrl = meta["@microsoft.graph.downloadUrl"];
+            if (!downloadUrl) {
+                // For folders or items without direct download, return metadata
+                return JSON.stringify(meta, null, 2);
+            }
+            const content = await client.download(downloadUrl, args.maxBytes ?? 50_000);
+            return content;
+        },
+        async files_info(args) {
+            const itemId = encodeURIComponent(args.itemId);
+            const data = await client.get(`${user}/drive/items/${itemId}?$select=id,name,size,folder,file,webUrl,lastModifiedDateTime,createdDateTime,parentReference`);
+            return JSON.stringify(data, null, 2);
+        },
+        async files_create_folder(args) {
+            const parentPath = args.parentPath ? `:/${encodeDrivePath(args.parentPath)}:` : "";
+            const path = `${user}/drive/root${parentPath}/children`;
+            const data = await client.post(path, {
+                name: args.name,
+                folder: {},
+            });
+            return JSON.stringify({ id: data.id, name: data.name, webUrl: data.webUrl, success: true }, null, 2);
+        },
+    };
+}
+export const filesToolSchemas = [
+    {
+        name: "m365_files_list",
+        description: "List files and folders in your OneDrive",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "Folder path (e.g. Documents/Work)" },
+                top: { type: "number", description: "Max results", default: 50 },
+            },
+        },
+    },
+    {
+        name: "m365_files_search",
+        description: "Search for files in your OneDrive",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Search query" },
+                top: { type: "number", description: "Max results", default: 20 },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "m365_files_read",
+        description: "Read a file's content (text files only, max 50KB by default)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                itemId: { type: "string", description: "File item ID from list/search" },
+                maxBytes: { type: "number", description: "Max bytes to read (default 50000)" },
+            },
+            required: ["itemId"],
+        },
+    },
+    {
+        name: "m365_files_info",
+        description: "Get file or folder metadata",
+        inputSchema: {
+            type: "object",
+            properties: {
+                itemId: { type: "string", description: "Item ID" },
+            },
+            required: ["itemId"],
+        },
+    },
+    {
+        name: "m365_files_create_folder",
+        description: "Create a new folder in OneDrive",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Folder name" },
+                parentPath: { type: "string", description: "Parent folder path (default: root)" },
+            },
+            required: ["name"],
+        },
+    },
+];
+//# sourceMappingURL=files.js.map

package/dist/tools/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/tools/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC;IAEnB,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,IAAqC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,GAAG,IAAI,cAAc,UAAU,kBAAkB,GAAG,+DAA+D,CAAC;YACjI,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAY,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;gBACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU;gBAChC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;gBAC1B,QAAQ,EAAE,CAAC,CAAC,oBAAoB;gBAChC,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAqC;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACtF,MAAM,IAAI,GAAG,GAAG,IAAI,yBAAyB,KAAK,WAAW,GAAG,mDAAmD,CAAC;YACpH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAY,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,eAAe,EAAE,IAAI;gBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,IAA2C;YAC1D,+CAA+C;YAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,GAAG,IAAI,gBAAgB,MAAM,EAAE,CAChC,CAAC;YAEF,MAAM,WAAW,GAAG,IAAI,CAAC,8BAA8B,CAAC,CAAC;YACzD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,gEAAgE;gBAChE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,IAAwB;YACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,GAAG,IAAI,gBAAgB,MAAM,+FAA+F,CAC7H,CAAC;YACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,mBAAmB,CAAC,IAA2C;YACnE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,GAAG,GAAG,IAAI,cAAc,UAAU,WAAW,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAM,IAAI,EAAE;gBACxC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yCAAyC;QACtD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC1E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE;aACjE;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,mCAAmC;QAChD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;gBACtD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE;aACjE;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;gBACxE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAC/E;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE;aACnD;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,iCAAiC;QAC9C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;gBACpD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;aAClF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;CACF,CAAC"}