@llmindset/hf-mcp 0.1.16

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hugging Face
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/dataset-detail.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const DATASET_DETAIL_TOOL_CONFIG: {
+    readonly name: "dataset_details";
+    readonly description: "Get detailed information about a specific dataset on Hugging Face Hub.";
+    readonly schema: z.ZodObject<{
+        dataset_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        dataset_id: string;
+    }, {
+        dataset_id: string;
+    }>;
+    readonly annotations: {
+        readonly title: "Dataset Details";
+        readonly destructiveHint: false;
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+};
+export type DatasetDetailParams = z.infer<typeof DATASET_DETAIL_TOOL_CONFIG.schema>;
+export declare class DatasetDetailTool {
+    private readonly hubUrl?;
+    private readonly accessToken?;
+    constructor(hfToken?: string, hubUrl?: string);
+    getDetails(datasetId: string): Promise<string>;
+}
+//# sourceMappingURL=dataset-detail.d.ts.map

package/dist/dataset-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-detail.d.ts","sourceRoot":"","sources":["../src/dataset-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;CAe7B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAyCpF,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAO1B,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAWvC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0EpD"}

package/dist/dataset-detail.js

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { datasetInfo } from '@huggingface/hub';
+import { formatDate, formatNumber } from './utilities.js';
+export const DATASET_DETAIL_TOOL_CONFIG = {
+    name: 'dataset_details',
+    description: 'Get detailed information about a specific dataset on Hugging Face Hub.',
+    schema: z.object({
+        dataset_id: z
+            .string()
+            .min(5, 'Dataset ID is required')
+            .describe('Dataset ID (e.g. institutional/institutional-books-1.0, Anthropic/hh-rlhf etc.)'),
+    }),
+    annotations: {
+        title: 'Dataset Details',
+        destructiveHint: false,
+        readOnlyHint: true,
+        openWorldHint: false,
+    },
+};
+export class DatasetDetailTool {
+    hubUrl;
+    accessToken;
+    constructor(hfToken, hubUrl) {
+        this.accessToken = hfToken;
+        this.hubUrl = hubUrl;
+    }
+    async getDetails(datasetId) {
+        try {
+            const additionalFields = ['author', 'downloadsAllTime', 'tags', 'description', 'cardData'];
+            const datasetData = await datasetInfo({
+                name: datasetId,
+                additionalFields: Array.from(additionalFields),
+                ...(this.accessToken && { credentials: { accessToken: this.accessToken } }),
+                ...(this.hubUrl && { hubUrl: this.hubUrl }),
+            });
+            const datasetDetails = {
+                id: datasetId,
+                name: datasetData.name,
+                downloads: datasetData.downloads,
+                likes: datasetData.likes,
+                private: datasetData.private,
+                gated: datasetData.gated,
+                updatedAt: datasetData.updatedAt,
+                extended: {
+                    author: datasetData.author,
+                    downloadsAllTime: datasetData.downloadsAllTime,
+                    tags: datasetData.tags,
+                    description: datasetData.description,
+                },
+            };
+            if (datasetData.cardData) {
+                const metadata = {};
+                const cardData = datasetData.cardData;
+                if ('language' in cardData) {
+                    metadata.language = cardData.language;
+                }
+                if ('license' in cardData) {
+                    metadata.license = cardData.license;
+                }
+                if ('task_categories' in cardData) {
+                    metadata.task_categories = cardData.task_categories;
+                }
+                if ('size_categories' in cardData) {
+                    metadata.size_categories = cardData.size_categories;
+                }
+                if ('dataset_info' in cardData) {
+                    metadata.dataset_info = cardData.dataset_info;
+                }
+                if (Object.keys(metadata).length > 0) {
+                    datasetDetails.metadata = metadata;
+                }
+            }
+            return formatDatasetDetails(datasetDetails);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to get dataset details: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}
+function formatDatasetDetails(dataset) {
+    const r = [];
+    const [authorFromName] = dataset.name.includes('/') ? dataset.name.split('/') : ['', dataset.name];
+    r.push(`# ${dataset.name}`);
+    r.push('');
+    if (dataset.extended?.description) {
+        r.push('## Description');
+        r.push(dataset.extended.description);
+        r.push('');
+    }
+    r.push('## Overview');
+    if (dataset.extended?.author || authorFromName) {
+        r.push(`- **Author:** ${dataset.extended?.author || authorFromName || ''}`);
+    }
+    const stats = [];
+    if (dataset.extended?.downloadsAllTime) {
+        stats.push(`**Downloads:** ${formatNumber(dataset.extended.downloadsAllTime)}`);
+    }
+    if (dataset.likes) {
+        stats.push(`**Likes:** ${dataset.likes.toString()}`);
+    }
+    if (stats.length > 0) {
+        r.push(`- ${stats.join(' | ')}`);
+    }
+    r.push(`- **Updated:** ${formatDate(dataset.updatedAt)}`);
+    const status = [];
+    if (dataset.gated)
+        status.push('🔒 Gated');
+    if (dataset.private)
+        status.push('🔐 Private');
+    if (status.length > 0) {
+        r.push(`- **Status:** ${status.join(' | ')}`);
+    }
+    r.push('');
+    if (dataset.extended?.tags && dataset.extended.tags.length > 0) {
+        r.push('## Tags');
+        r.push(dataset.extended.tags.map((tag) => `\`${tag}\``).join(' '));
+        r.push('');
+    }
+    if (dataset.metadata) {
+        const metadata = [];
+        if (dataset.metadata.language) {
+            const languages = Array.isArray(dataset.metadata.language)
+                ? dataset.metadata.language.join(', ')
+                : dataset.metadata.language;
+            metadata.push(`- **Language:** ${languages}`);
+        }
+        if (dataset.metadata.license) {
+            const license = Array.isArray(dataset.metadata.license)
+                ? dataset.metadata.license.join(', ')
+                : dataset.metadata.license;
+            metadata.push(`- **License:** ${license}`);
+        }
+        if (dataset.metadata.task_categories) {
+            const tasks = Array.isArray(dataset.metadata.task_categories)
+                ? dataset.metadata.task_categories.join(', ')
+                : dataset.metadata.task_categories;
+            metadata.push(`- **Task Categories:** ${tasks}`);
+        }
+        if (dataset.metadata.size_categories) {
+            const size = Array.isArray(dataset.metadata.size_categories)
+                ? dataset.metadata.size_categories.join(', ')
+                : dataset.metadata.size_categories;
+            metadata.push(`- **Size Category:** ${size}`);
+        }
+        if (metadata.length > 0) {
+            r.push('## Metadata');
+            r.push(...metadata);
+            r.push('');
+        }
+    }
+    r.push(`**Link:** [https://hf.co/datasets/${dataset.name}](https://hf.co/datasets/${dataset.name})`);
+    return r.join('\n');
+}
+//# sourceMappingURL=dataset-detail.js.map

package/dist/dataset-detail.js.map

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

package/dist/dataset-search.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { HfApiCall } from './hf-api-call.js';
+export declare const DATASET_SEARCH_TOOL_CONFIG: {
+    readonly name: "dataset_search";
+    readonly description: string;
+    readonly schema: z.ZodObject<{
+        query: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        sort: z.ZodOptional<z.ZodEnum<["trendingScore", "downloads", "likes", "createdAt", "lastModified"]>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        sort?: "createdAt" | "downloads" | "lastModified" | "likes" | "trendingScore" | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+        query?: string | undefined;
+    }, {
+        sort?: "createdAt" | "downloads" | "lastModified" | "likes" | "trendingScore" | undefined;
+        author?: string | undefined;
+        tags?: string[] | undefined;
+        query?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    readonly annotations: {
+        readonly title: "Dataset Search";
+        readonly destructiveHint: false;
+        readonly readOnlyHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export type DatasetSearchParams = z.infer<typeof DATASET_SEARCH_TOOL_CONFIG.schema>;
+interface DatasetApiParams {
+    search?: string;
+    author?: string;
+    filter?: string;
+    sort?: string;
+    direction?: string;
+    limit?: string;
+}
+interface DatasetApiResult {
+    _id: string;
+    id: string;
+    author: string;
+    likes: number;
+    downloads: number;
+    trendingScore?: number;
+    private: boolean;
+    gated: boolean;
+    tags: string[];
+    createdAt: string;
+    lastModified: string;
+    description?: string;
+    sha: string;
+}
+export declare class DatasetSearchTool extends HfApiCall<DatasetApiParams, DatasetApiResult[]> {
+    constructor(hfToken?: string);
+    searchWithParams(params: Partial<DatasetSearchParams>): Promise<string>;
+    searchWithFilter(filter: string, limit?: number): Promise<string>;
+}
+export {};
+//# sourceMappingURL=dataset-search.d.ts.map

package/dist/dataset-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-search.d.ts","sourceRoot":"","sources":["../src/dataset-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC7B,CAAC;AAGX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAGpF,UAAU,gBAAgB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,UAAU,gBAAgB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACZ;AAID,qBAAa,iBAAkB,SAAQ,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;gBAIzE,OAAO,CAAC,EAAE,MAAM;IAOtB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkDvE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAwB3E"}

package/dist/dataset-search.js

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+import { HfApiCall } from './hf-api-call.js';
+import { formatDate, formatNumber } from './utilities.js';
+const TAGS_TO_RETURN = 20;
+export const DATASET_SEARCH_TOOL_CONFIG = {
+    name: 'dataset_search',
+    description: 'Find Datasets hosted on the Hugging Face hub. ' +
+        'Returns comprehensive information about matching datasets including downloads, likes, tags, and direct links. ' +
+        'Include links to the datasets in your response',
+    schema: z.object({
+        query: z
+            .string()
+            .optional()
+            .describe('Search term. Leave blank and specify "sort" and "limit" to get e.g. "Top 20 trending datasets", "Top 10 most recent datasets" etc" '),
+        author: z
+            .string()
+            .optional()
+            .describe("Organization or user who created the dataset (e.g., 'google', 'facebook', 'allenai')"),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("Tags to filter datasets (e.g., ['language:en', 'size_categories:1M<n<10M', 'task_categories:text-classification'])"),
+        sort: z
+            .enum(['trendingScore', 'downloads', 'likes', 'createdAt', 'lastModified'])
+            .optional()
+            .describe('Sort order: trendingScore, downloads, likes, createdAt, lastModified'),
+        limit: z.number().min(1).max(100).optional().default(20).describe('Maximum number of results to return'),
+    }),
+    annotations: {
+        title: 'Dataset Search',
+        destructiveHint: false,
+        readOnlyHint: true,
+        openWorldHint: true,
+    },
+};
+export class DatasetSearchTool extends HfApiCall {
+    constructor(hfToken) {
+        super('https://huggingface.co/api/datasets', hfToken);
+    }
+    async searchWithParams(params) {
+        try {
+            const apiParams = {};
+            if (params.query) {
+                apiParams.search = params.query;
+            }
+            if (params.author) {
+                apiParams.author = params.author;
+            }
+            if (params.tags && params.tags.length > 0) {
+                apiParams.filter = params.tags.join(',');
+            }
+            if (params.sort) {
+                apiParams.sort = params.sort;
+                apiParams.direction = '-1';
+            }
+            if (params.limit) {
+                apiParams.limit = params.limit.toString();
+            }
+            const datasets = await this.callApi(apiParams);
+            if (datasets.length === 0) {
+                return `No datasets found for the given criteria.`;
+            }
+            return formatSearchResults(datasets, params);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to search for datasets: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    async searchWithFilter(filter, limit = 10) {
+        try {
+            const apiParams = {
+                filter: filter,
+                limit: limit.toString(),
+                sort: 'downloads',
+                direction: '-1',
+            };
+            const datasets = await this.callApi(apiParams);
+            if (datasets.length === 0) {
+                return `No datasets found referencing ${filter}.`;
+            }
+            return formatSearchResults(datasets, { limit });
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to search for datasets: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}
+function formatSearchResults(datasets, params) {
+    const r = [];
+    const searchTerms = [];
+    if (params.query)
+        searchTerms.push(`query "${params.query}"`);
+    if (params.author)
+        searchTerms.push(`author "${params.author}"`);
+    if (params.tags && params.tags.length > 0)
+        searchTerms.push(`tags [${params.tags.join(', ')}]`);
+    if (params.sort)
+        searchTerms.push(`sorted by ${params.sort} (descending)`);
+    const searchDesc = searchTerms.length > 0 ? ` matching ${searchTerms.join(', ')}` : '';
+    const resultText = datasets.length === params.limit
+        ? `Showing first ${datasets.length.toString()} datasets${searchDesc}:`
+        : `Found ${datasets.length.toString()} datasets${searchDesc}:`;
+    r.push(resultText);
+    r.push('');
+    for (const dataset of datasets) {
+        r.push(`## ${dataset.id}`);
+        r.push('');
+        if (dataset.description) {
+            r.push(`${dataset.description.substring(0, 200)}${dataset.description.length > 200 ? '...' : ''}`);
+            r.push('');
+        }
+        const info = [];
+        if (dataset.downloads)
+            info.push(`**Downloads:** ${formatNumber(dataset.downloads)}`);
+        if (dataset.likes)
+            info.push(`**Likes:** ${dataset.likes.toString()}`);
+        if (dataset.trendingScore)
+            info.push(`**Trending Score:** ${dataset.trendingScore.toString()}`);
+        if (info.length > 0) {
+            r.push(info.join(' | '));
+            r.push('');
+        }
+        if (dataset.tags && dataset.tags.length > 0) {
+            r.push(`**Tags:** ${dataset.tags.slice(0, TAGS_TO_RETURN).join(', ')}`);
+            if (dataset.tags.length > TAGS_TO_RETURN) {
+                r.push(`*and ${(dataset.tags.length - TAGS_TO_RETURN).toString()} more...*`);
+            }
+            r.push('');
+        }
+        const status = [];
+        if (dataset.gated)
+            status.push('🔒 Gated');
+        if (dataset.private)
+            status.push('🔐 Private');
+        if (status.length > 0) {
+            r.push(status.join(' | '));
+            r.push('');
+        }
+        if (dataset.createdAt) {
+            r.push(`**Created:** ${formatDate(dataset.createdAt)}`);
+        }
+        if (dataset.lastModified && dataset.lastModified !== dataset.createdAt) {
+            r.push(`**Last Modified:** ${formatDate(dataset.lastModified)}`);
+        }
+        r.push(`**Link:** [https://hf.co/datasets/${dataset.id}](https://hf.co/datasets/${dataset.id})`);
+        r.push('');
+        r.push('---');
+        r.push('');
+    }
+    return r.join('\n');
+}
+//# sourceMappingURL=dataset-search.js.map

package/dist/dataset-search.js.map

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

package/dist/duplicate-space.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { HfApiCall } from './hf-api-call.js';
+export interface SpaceInfo {
+    runtime?: {
+        hardware?: {
+            current?: string;
+            requested?: string;
+        } | string;
+    };
+    gated?: boolean;
+    models?: string[];
+}
+export interface SpaceVariable {
+    key: string;
+    value: string;
+    description?: string;
+}
+export interface DuplicateSpaceParams {
+    sourceSpaceId: string;
+    newSpaceName?: string;
+    hardware?: 'freecpu' | 'zerogpu';
+    private?: boolean;
+}
+export interface DuplicateSpaceResult {
+    url: string;
+    spaceId: string;
+    hardware: string;
+    private: boolean;
+    variablesCopied: number;
+    instructions: string;
+    hardwareWarning?: string;
+}
+export declare const DUPLICATE_SPACE_TOOL_CONFIG: {
+    readonly name: "duplicate_space";
+    readonly description: "";
+    readonly schema: z.ZodObject<{
+        sourceSpaceId: z.ZodString;
+        newSpaceId: z.ZodOptional<z.ZodString>;
+        hardware: z.ZodOptional<z.ZodEnum<["freecpu", "zerogpu"]>>;
+        private: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        private: boolean;
+        sourceSpaceId: string;
+        newSpaceId?: string | undefined;
+        hardware?: "freecpu" | "zerogpu" | undefined;
+    }, {
+        sourceSpaceId: string;
+        private?: boolean | undefined;
+        newSpaceId?: string | undefined;
+        hardware?: "freecpu" | "zerogpu" | undefined;
+    }>;
+    readonly annotations: {
+        readonly title: "Duplicate Hugging Face Space";
+        readonly destructiveHint: false;
+        readonly readOnlyHint: false;
+        readonly openWorldHint: true;
+    };
+};
+export declare class DuplicateSpaceTool extends HfApiCall<DuplicateSpaceParams, DuplicateSpaceResult> {
+    private username?;
+    constructor(hfToken?: string, username?: string);
+    static createToolConfig(username?: string): Omit<typeof DUPLICATE_SPACE_TOOL_CONFIG, 'description'> & {
+        description: string;
+    };
+    normalizeSpaceName(spaceName: string): string;
+    getSpaceInfo(spaceId: string): Promise<SpaceInfo>;
+    getSpaceVariables(spaceId: string): Promise<Record<string, {
+        value: string;
+        description?: string;
+    }>>;
+    duplicate(params: DuplicateSpaceParams): Promise<DuplicateSpaceResult>;
+    private formatInstructions;
+}
+export declare const formatDuplicateResult: (result: DuplicateSpaceResult) => string;
+//# sourceMappingURL=duplicate-space.d.ts.map

package/dist/duplicate-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-space.d.ts","sourceRoot":"","sources":["../src/duplicate-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,WAAW,SAAS;IACzB,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,EACN;YACA,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;SAClB,GACD,MAAM,CAAC;KACV,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;CAsB9B,CAAC;AAUX,qBAAa,kBAAmB,SAAQ,SAAS,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IAC5F,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK/C,MAAM,CAAC,gBAAgB,CACtB,QAAQ,CAAC,EAAE,MAAM,GACf,IAAI,CAAC,OAAO,2BAA2B,EAAE,aAAa,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAUpF,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAevC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAKjD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAUpG,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkH5E,OAAO,CAAC,kBAAkB;CAqB1B;AAED,eAAO,MAAM,qBAAqB,GAAI,QAAQ,oBAAoB,KAAG,MAEpE,CAAC"}