@llmindset/hf-mcp 0.1.16

package/dist/duplicate-space.js

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+import { HfApiCall } from './hf-api-call.js';
+import { explain } from './error-messages.js';
+import { NO_TOKEN_INSTRUCTIONS } from './utilities.js';
+export const DUPLICATE_SPACE_TOOL_CONFIG = {
+    name: 'duplicate_space',
+    description: '',
+    schema: z.object({
+        sourceSpaceId: z.string().min(1).describe("Space ID to copy (e.g., 'username/space-name')"),
+        newSpaceId: z.string().optional().describe('Name for the new space (optional, defaults to source space-name)'),
+        hardware: z
+            .enum(['freecpu', 'zerogpu'])
+            .optional()
+            .describe('Either "freecpu" or "zerogpu" (defaults based on source). Both options are in the free tier.'),
+        private: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('Check with User whether the new space should be public or private.'),
+    }),
+    annotations: {
+        title: 'Duplicate Hugging Face Space',
+        destructiveHint: false,
+        readOnlyHint: false,
+        openWorldHint: true,
+    },
+};
+const HARDWARE_MAP = {
+    freecpu: 'cpu-basic',
+    zerogpu: 'zero-a10g',
+};
+const FREE_HARDWARE = ['cpu-basic', 'zero-a10g'];
+export class DuplicateSpaceTool extends HfApiCall {
+    username;
+    constructor(hfToken, username) {
+        super('https://huggingface.co/api', hfToken);
+        this.username = username;
+    }
+    static createToolConfig(username) {
+        const description = username
+            ? `Duplicate a Hugging Face Space. Target space will be created as ${username}/<new-space-name>.`
+            : NO_TOKEN_INSTRUCTIONS;
+        return {
+            ...DUPLICATE_SPACE_TOOL_CONFIG,
+            description,
+        };
+    }
+    normalizeSpaceName(spaceName) {
+        if (spaceName.includes('/')) {
+            const [providedUser, spaceNamePart] = spaceName.split('/');
+            if (providedUser !== this.username) {
+                throw new Error(`Invalid space ID: ${spaceName}. You can only create spaces in your own namespace. Try "${this.username || 'your-username'}/${spaceNamePart || 'space-name'}"`);
+            }
+            return spaceName;
+        }
+        return `${this.username || 'unknown'}/${spaceName}`;
+    }
+    async getSpaceInfo(spaceId) {
+        const url = `${this.apiUrl}/spaces/${spaceId}`;
+        return this.fetchFromApi(url);
+    }
+    async getSpaceVariables(spaceId) {
+        const url = `${this.apiUrl}/spaces/${spaceId}/variables`;
+        try {
+            return await this.fetchFromApi(url);
+        }
+        catch {
+            return {};
+        }
+    }
+    async duplicate(params) {
+        const { sourceSpaceId, newSpaceName, hardware, private: isPrivate = true } = params;
+        if (!this.username)
+            throw new Error(NO_TOKEN_INSTRUCTIONS);
+        try {
+            let sourceInfo;
+            try {
+                sourceInfo = await this.getSpaceInfo(sourceSpaceId);
+            }
+            catch (error) {
+                throw explain(error, `Could not access source space "${sourceSpaceId}"`);
+            }
+            const sourceVars = await this.getSpaceVariables(sourceSpaceId);
+            const variables = Object.entries(sourceVars).map(([key, varInfo]) => ({
+                key,
+                value: varInfo.value,
+                description: varInfo.description,
+            }));
+            let sourceHardwareStr;
+            if (typeof sourceInfo.runtime?.hardware === 'object') {
+                sourceHardwareStr = sourceInfo.runtime.hardware.current || sourceInfo.runtime.hardware.requested;
+            }
+            else {
+                sourceHardwareStr = sourceInfo.runtime?.hardware;
+            }
+            let selectedHardware;
+            let hardwareKey;
+            if (hardware) {
+                selectedHardware = HARDWARE_MAP[hardware];
+                hardwareKey = hardware;
+            }
+            else {
+                if (sourceHardwareStr === 'zero-a10g') {
+                    selectedHardware = 'zero-a10g';
+                    hardwareKey = 'zerogpu';
+                }
+                else if (sourceHardwareStr === 'cpu-basic' || !sourceHardwareStr) {
+                    selectedHardware = 'cpu-basic';
+                    hardwareKey = 'freecpu';
+                }
+                else {
+                    selectedHardware = 'zero-a10g';
+                    hardwareKey = 'zerogpu';
+                }
+            }
+            let targetId;
+            if (newSpaceName) {
+                targetId = this.normalizeSpaceName(newSpaceName);
+            }
+            else {
+                const sourceName = sourceSpaceId.split('/')[1];
+                targetId = `${this.username}/${sourceName || ''}`;
+            }
+            let hardwareWarning;
+            if (sourceHardwareStr && !FREE_HARDWARE.includes(sourceHardwareStr)) {
+                hardwareWarning = `Note: The source space uses '${sourceHardwareStr}' which is paid hardware. Your duplicated space is set to '${hardwareKey}'. "+ 
+				"You may need to upgrade in Settings to run this space or achieve the same performance.`;
+            }
+            let gatedWarning;
+            if (sourceInfo.gated) {
+                gatedWarning = `🔐 The model in this space is 'gated' - you may need to accept the licensing conditions before  use.`;
+            }
+            const url = `${this.apiUrl}/spaces/${sourceSpaceId}/duplicate`;
+            const payload = {
+                repository: targetId,
+                private: isPrivate,
+                hardware: selectedHardware,
+                variables: variables.length > 0 ? variables : undefined,
+            };
+            const response = await this.fetchFromApi(url, {
+                method: 'POST',
+                body: JSON.stringify(payload),
+            });
+            const warnings = [];
+            if (hardwareWarning)
+                warnings.push(hardwareWarning);
+            if (gatedWarning)
+                warnings.push(gatedWarning);
+            const result = {
+                url: response.url,
+                spaceId: targetId,
+                hardware: hardwareKey,
+                private: isPrivate,
+                variablesCopied: variables.length,
+                instructions: this.formatInstructions(response.url, hardwareKey, isPrivate, warnings),
+            };
+            if (hardwareWarning) {
+                result.hardwareWarning = hardwareWarning;
+            }
+            return result;
+        }
+        catch (error) {
+            throw explain(error, 'Failed to duplicate space');
+        }
+    }
+    formatInstructions(url, hardware, isPrivate, warnings) {
+        let instructions = `✅ 🤗 Space successfully duplicated! 
+
+🔗 Your new space: ${url}
+
+⚙️ To configure your space:
+1. Go to ${url}
+2. Click on 'Settings' in the top right
+3. Configure any additional settings as needed
+
+Hardware: ${hardware} | Visibility: ${isPrivate ? 'Private' : 'Public'}`;
+        if (warnings.length > 0) {
+            instructions += '\n\n⚠️ Warnings:';
+            warnings.forEach((warning) => {
+                instructions += `\n- ${warning}`;
+            });
+        }
+        return instructions;
+    }
+}
+export const formatDuplicateResult = (result) => {
+    return result.instructions;
+};
+//# sourceMappingURL=duplicate-space.js.map

package/dist/duplicate-space.js.map

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

package/dist/error-messages.d.ts

@@ -0,0 +1,4 @@
+export declare const FRIENDLY_ERROR_EXPLANATIONS: Record<number, string>;
+export declare function getFriendlyExplanation(status: number): string;
+export declare function explain(error: unknown, context?: string): unknown;
+//# sourceMappingURL=error-messages.d.ts.map

package/dist/error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../src/error-messages.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW9D,CAAC;AAKF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa7D;AASD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CASjE"}

package/dist/error-messages.js

@@ -0,0 +1,30 @@
+import { HfApiError } from './hf-api-call.js';
+export const FRIENDLY_ERROR_EXPLANATIONS = {
+    400: 'The request was invalid. Check your HF_TOKEN permissions, or that you have not exceeded the maximum number of spaces allowed..',
+    401: 'Authentication failed. Please check that your Hugging Face token is valid. Check your Hugging Face token permissions.',
+    403: 'You do not have permission to access this resource. Check your Hugging Face token permissions.',
+    404: 'The requested resource does not exist.',
+    409: 'A resource with this name already exists.',
+    422: 'The provided configuration is invalid.',
+    429: 'Duplication failed due to rate limits.',
+    500: 'Hugging Face is experiencing issues. Please try again later.',
+    502: 'The server gateway is temporarily unavailable.',
+    503: 'The service is temporarily down for maintenance.',
+};
+export function getFriendlyExplanation(status) {
+    if (FRIENDLY_ERROR_EXPLANATIONS[status]) {
+        return FRIENDLY_ERROR_EXPLANATIONS[status];
+    }
+    if (status >= 500) {
+        return 'Hugging Face is experiencing issues. Please try again later.';
+    }
+    return 'An unexpected error occurred. Please try again.';
+}
+export function explain(error, context) {
+    if (error instanceof HfApiError) {
+        const friendlyExplanation = getFriendlyExplanation(error.status);
+        return error.withImprovedMessage(friendlyExplanation, context);
+    }
+    return error;
+}
+//# sourceMappingURL=error-messages.js.map

package/dist/error-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.js","sourceRoot":"","sources":["../src/error-messages.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C,MAAM,CAAC,MAAM,2BAA2B,GAA2B;IAClE,GAAG,EAAE,gIAAgI;IACrI,GAAG,EAAE,uHAAuH;IAC5H,GAAG,EAAE,gGAAgG;IACrG,GAAG,EAAE,wCAAwC;IAC7C,GAAG,EAAE,2CAA2C;IAChD,GAAG,EAAE,wCAAwC;IAC7C,GAAG,EAAE,wCAAwC;IAC7C,GAAG,EAAE,8DAA8D;IACnE,GAAG,EAAE,gDAAgD;IACrD,GAAG,EAAE,kDAAkD;CACvD,CAAC;AAKF,MAAM,UAAU,sBAAsB,CAAC,MAAc;IAEpD,IAAI,2BAA2B,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAGD,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACnB,OAAO,8DAA8D,CAAC;IACvE,CAAC;IAGD,OAAO,iDAAiD,CAAC;AAC1D,CAAC;AASD,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,OAAgB;IAEvD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QACjC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,OAAO,KAAK,CAAC,mBAAmB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAGD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/hf-api-call.d.ts

@@ -0,0 +1,18 @@
+export declare class HfApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, status: number, statusText: string, responseBody?: string | undefined);
+    formatWithExplanation(friendlyExplanation: string, context?: string): string;
+    withImprovedMessage(friendlyExplanation: string, context?: string): HfApiError;
+}
+export declare class HfApiCall<TParams = Record<string, string | undefined>, TResponse = unknown> {
+    protected readonly apiUrl: string;
+    protected readonly hfToken: string | undefined;
+    protected readonly apiTimeout: number;
+    constructor(apiUrl: string, hfToken?: string);
+    protected fetchFromApi<T = TResponse>(url: URL | string, options?: globalThis.RequestInit): Promise<T>;
+    protected buildUrl(params: TParams): URL;
+    protected callApi<T = TResponse>(params: TParams, options?: globalThis.RequestInit): Promise<T>;
+}
+//# sourceMappingURL=hf-api-call.d.ts.map

package/dist/hf-api-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-api-call.d.ts","sourceRoot":"","sources":["../src/hf-api-call.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAW,SAAQ,KAAK;aAGnB,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;aAClB,YAAY,CAAC,EAAE,MAAM;gBAHrC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,YAAA;IAYtC,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAuC5E,mBAAmB,CAAC,mBAAmB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;CAI9E;AAQD,qBAAa,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO;IACvF,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAG1B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;cAe5B,YAAY,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA+D5G,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG;cAsBxB,OAAO,CAAC,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAIrG"}

package/dist/hf-api-call.js

@@ -0,0 +1,105 @@
+export class HfApiError extends Error {
+    status;
+    statusText;
+    responseBody;
+    constructor(message, status, statusText, responseBody) {
+        super(message);
+        this.status = status;
+        this.statusText = statusText;
+        this.responseBody = responseBody;
+        this.name = 'HfApiError';
+    }
+    formatWithExplanation(friendlyExplanation, context) {
+        let formatted = '';
+        if (context) {
+            formatted = `${context}. `;
+        }
+        formatted += friendlyExplanation;
+        formatted += `\n\n${this.message}`;
+        if (this.responseBody) {
+            try {
+                const parsed = JSON.parse(this.responseBody);
+                const errorDetail = parsed.error || parsed.message || parsed.detail;
+                if (errorDetail && !this.message.includes(errorDetail)) {
+                    formatted += `\n${errorDetail}`;
+                }
+            }
+            catch {
+                if (this.responseBody.length < 200 && !this.message.includes(this.responseBody)) {
+                    formatted += `\n${this.responseBody}`;
+                }
+            }
+        }
+        return formatted;
+    }
+    withImprovedMessage(friendlyExplanation, context) {
+        const improvedMessage = this.formatWithExplanation(friendlyExplanation, context);
+        return new HfApiError(improvedMessage, this.status, this.statusText, this.responseBody);
+    }
+}
+export class HfApiCall {
+    apiUrl;
+    hfToken;
+    apiTimeout;
+    constructor(apiUrl, hfToken) {
+        this.apiUrl = apiUrl;
+        this.hfToken = hfToken;
+        this.apiTimeout = process.env.HF_API_TIMEOUT ? parseInt(process.env.HF_API_TIMEOUT, 10) : 12500;
+    }
+    async fetchFromApi(url, options) {
+        try {
+            const headers = {
+                Accept: 'application/json',
+                ...(options?.headers || {}),
+            };
+            if (this.hfToken) {
+                headers['Authorization'] = `Bearer ${this.hfToken}`;
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.apiTimeout);
+            const response = await fetch(url.toString(), {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let responseBody;
+                try {
+                    responseBody = await response.text();
+                }
+                catch {
+                }
+                throw new HfApiError(`API request failed: ${response.status.toString()} ${response.statusText}`, response.status, response.statusText, responseBody);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof HfApiError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`API request timed out after ${this.apiTimeout}ms`);
+            }
+            if (error instanceof Error) {
+                throw new Error(`API request failed: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    buildUrl(params) {
+        const url = new URL(this.apiUrl);
+        for (const key in params) {
+            const value = params[key];
+            if (value !== undefined) {
+                url.searchParams.append(key, String(value));
+            }
+        }
+        return url;
+    }
+    async callApi(params, options) {
+        const url = this.buildUrl(params);
+        return this.fetchFromApi(url, options);
+    }
+}
+//# sourceMappingURL=hf-api-call.js.map

package/dist/hf-api-call.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './hf-api-call.js';
+export * from './error-messages.js';
+export * from './space-search.js';
+export * from './model-search.js';
+export * from './model-detail.js';
+export * from './utilities.js';
+export * from './paper-search.js';
+export * from './dataset-search.js';
+export * from './dataset-detail.js';
+export * from './duplicate-space.js';
+export * from './space-info.js';
+export * from './space-files.js';
+export * from './user-summary.js';
+export * from './paper-summary.js';
+export * from './tool-ids.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from './hf-api-call.js';
+export * from './error-messages.js';
+export * from './space-search.js';
+export * from './model-search.js';
+export * from './model-detail.js';
+export * from './utilities.js';
+export * from './paper-search.js';
+export * from './dataset-search.js';
+export * from './dataset-detail.js';
+export * from './duplicate-space.js';
+export * from './space-info.js';
+export * from './space-files.js';
+export * from './user-summary.js';
+export * from './paper-summary.js';
+export * from './tool-ids.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,eAAe,CAAC"}

package/dist/model-detail.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const MODEL_DETAIL_TOOL_CONFIG: {
+    readonly name: "model_details";
+    readonly description: "Get detailed information about a specific model from the Hugging Face Hub.";
+    readonly schema: z.ZodObject<{
+        model_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        model_id: string;
+    }, {
+        model_id: string;
+    }>;
+    readonly annotations: {
+        readonly title: "Model Details";
+        readonly destructiveHint: false;
+        readonly readOnlyHint: true;
+        readonly openWorldHint: false;
+    };
+};
+export type ModelDetailParams = z.infer<typeof MODEL_DETAIL_TOOL_CONFIG.schema>;
+export declare class ModelDetailTool {
+    private readonly hubUrl?;
+    private readonly accessToken?;
+    constructor(hfToken?: string, hubUrl?: string);
+    getDetails(modelId: string): Promise<string>;
+}
+//# sourceMappingURL=model-detail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-detail.d.ts","sourceRoot":"","sources":["../src/model-detail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;CAY3B,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAuDhF,qBAAa,eAAe;IAC3B,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,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA+HlD"}