@llmindset/hf-mcp 0.2.32 → 0.2.34

package/dist/jobs/types.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+export const CPU_FLAVORS = ['cpu-basic', 'cpu-upgrade', 'cpu-performance', 'cpu-xl'];
+export const GPU_FLAVORS = [
+    'sprx8',
+    'zero-a10g',
+    't4-small',
+    't4-medium',
+    'l4x1',
+    'l4x4',
+    'l40sx1',
+    'l40sx4',
+    'l40sx8',
+    'a10g-small',
+    'a10g-large',
+    'a10g-largex2',
+    'a10g-largex4',
+    'a100-large',
+    'h100',
+    'h100x8',
+];
+export const SPECIALIZED_FLAVORS = ['inf2x6'];
+export const ALL_FLAVORS = [...CPU_FLAVORS, ...GPU_FLAVORS, ...SPECIALIZED_FLAVORS];
+const commonArgsSchema = z.object({
+    namespace: z.string().optional().describe('Target namespace (username or organization). Defaults to current user.'),
+});
+export const runArgsSchema = commonArgsSchema.extend({
+    image: z.string().describe('Docker image or HF Space URL (e.g., "python:3.12" or "hf.co/spaces/user/space")'),
+    command: z
+        .union([z.string(), z.array(z.string())])
+        .describe('Command to execute. Array format recommended (e.g., ["python", "script.py"]). ' +
+        'String format is parsed with POSIX shell semantics (quotes, escaping). ' +
+        'For multiline scripts, use array with newlines in arguments.'),
+    flavor: z
+        .enum(ALL_FLAVORS)
+        .optional()
+        .default('cpu-basic')
+        .describe(`Hardware flavor. Options: ${ALL_FLAVORS.join(', ')}`),
+    env: z.record(z.string()).optional().describe('Environment variables as key-value pairs'),
+    secrets: z.record(z.string()).optional().describe('Secret environment variables (encrypted server-side)'),
+    timeout: z
+        .string()
+        .optional()
+        .describe('Max duration (e.g., "5m", "2h", "30s"). Default: 30m')
+        .default('30m'),
+    detach: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Run in background and return immediately (default: true)'),
+});
+export const uvArgsSchema = commonArgsSchema.extend({
+    script: z
+        .string()
+        .describe('Python script: local file path, URL, or inline code. UV will handle dependencies automatically.'),
+    repo: z.string().optional().describe('Persistent repository name for script storage'),
+    with_deps: z.array(z.string()).optional().describe('Additional package dependencies'),
+    script_args: z.array(z.string()).optional().describe('Arguments to pass to the script'),
+    python: z.string().optional().describe('Python interpreter version (e.g., "3.12")'),
+    flavor: z.enum(ALL_FLAVORS).optional().default('cpu-basic').describe('Hardware flavor'),
+    env: z.record(z.string()).optional().describe('Environment variables'),
+    secrets: z.record(z.string()).optional().describe('Secret environment variables'),
+    timeout: z.string().optional().default('30m').describe('Max duration'),
+    detach: z.boolean().optional().default(true).describe('Run in background'),
+});
+export const psArgsSchema = commonArgsSchema.extend({
+    all: z.boolean().optional().default(false).describe('Show all jobs (default: only running)'),
+    status: z.string().optional().describe('Filter by status (e.g., "RUNNING", "COMPLETED")'),
+});
+export const logsArgsSchema = commonArgsSchema.extend({
+    job_id: z.string().describe('Job ID to fetch logs from'),
+    tail: z.number().optional().default(20).describe('Number of lines to return (default: 20)'),
+});
+export const inspectArgsSchema = commonArgsSchema.extend({
+    job_id: z.union([z.string(), z.array(z.string())]).describe('Job ID(s) to inspect'),
+});
+export const cancelArgsSchema = commonArgsSchema.extend({
+    job_id: z.string().describe('Job ID to cancel'),
+});
+export const scheduledRunArgsSchema = runArgsSchema.extend({
+    schedule: z
+        .string()
+        .describe('Schedule: cron expression or shorthand (@hourly, @daily, @weekly, @monthly, @yearly)'),
+    suspend: z.boolean().optional().default(false).describe('Create in suspended state'),
+});
+export const scheduledUvArgsSchema = uvArgsSchema.extend({
+    schedule: z.string().describe('Schedule: cron expression or shorthand'),
+    suspend: z.boolean().optional().default(false).describe('Create in suspended state'),
+});
+export const scheduledPsArgsSchema = commonArgsSchema.extend({
+    all: z.boolean().optional().default(false).describe('Show all scheduled jobs (default: hide suspended)'),
+});
+export const scheduledJobArgsSchema = commonArgsSchema.extend({
+    scheduled_job_id: z.string().describe('Scheduled job ID'),
+});
+//# sourceMappingURL=types.js.map

package/dist/jobs/types.js.map

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

package/dist/tool-ids.d.ts

@@ -15,14 +15,15 @@ export declare const USER_SUMMARY_PROMPT_ID: "User Summary";
 export declare const PAPER_SUMMARY_PROMPT_ID: "Paper Summary";
 export declare const MODEL_DETAIL_PROMPT_ID: string;
 export declare const DATASET_DETAIL_PROMPT_ID: string;
-export declare const ALL_BUILTIN_TOOL_IDS: readonly ["space_search", "model_search", "model_details", "paper_search", "dataset_search", "dataset_details", "hub_repo_details", "duplicate_space", "space_info", "space_files", "hf_doc_search", "hf_doc_fetch", "use_space"];
+export declare const HF_JOBS_TOOL_ID: "hf_jobs";
+export declare const ALL_BUILTIN_TOOL_IDS: readonly ["space_search", "model_search", "model_details", "paper_search", "dataset_search", "dataset_details", "hub_repo_details", "duplicate_space", "space_info", "space_files", "hf_doc_search", "hf_doc_fetch", "use_space", "hf_jobs"];
 export declare const TOOL_ID_GROUPS: {
     readonly search: readonly ["space_search", "model_search", "dataset_search", "paper_search", "hf_doc_search"];
     readonly spaces: readonly ["space_search", "duplicate_space", "space_info", "space_files", "use_space"];
     readonly detail: readonly ["model_details", "dataset_details", "hub_repo_details"];
     readonly docs: readonly ["hf_doc_search", "hf_doc_fetch"];
     readonly hf_api: readonly ["space_search", "model_search", "dataset_search", "paper_search", "hub_repo_details", "hf_doc_search"];
-    readonly all: readonly ["space_search", "model_search", "model_details", "paper_search", "dataset_search", "dataset_details", "hub_repo_details", "duplicate_space", "space_info", "space_files", "hf_doc_search", "hf_doc_fetch", "use_space"];
+    readonly all: readonly ["space_search", "model_search", "model_details", "paper_search", "dataset_search", "dataset_details", "hub_repo_details", "duplicate_space", "space_info", "space_files", "hf_doc_search", "hf_doc_fetch", "use_space", "hf_jobs"];
 };
 export type BuiltinToolId = (typeof ALL_BUILTIN_TOOL_IDS)[number];
 export declare function isValidBuiltinToolId(toolId: string): toolId is BuiltinToolId;

package/dist/tool-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ids.d.ts","sourceRoot":"","sources":["../src/tool-ids.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,oBAAoB,gBAAmC,CAAC;AACrE,eAAO,MAAM,oBAAoB,gBAAgC,CAAC;AAClE,eAAO,MAAM,oBAAoB,iBAAgC,CAAC;AAClE,eAAO,MAAM,oBAAoB,gBAAgC,CAAC;AAClE,eAAO,MAAM,sBAAsB,kBAAkC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mBAAkC,CAAC;AACtE,eAAO,MAAM,mBAAmB,oBAA+B,CAAC;AAChE,eAAO,MAAM,uBAAuB,mBAAmC,CAAC;AACxE,eAAO,MAAM,kBAAkB,cAA8B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,eAA+B,CAAC;AAChE,eAAO,MAAM,iBAAiB,aAA6B,CAAC;AAC5D,eAAO,MAAM,4BAA4B,iBAAmC,CAAC;AAC7E,eAAO,MAAM,iBAAiB,gBAAwB,CAAC;AACvD,eAAO,MAAM,sBAAsB,gBAAkC,CAAC;AACtE,eAAO,MAAM,uBAAuB,iBAAmC,CAAC;AACxE,eAAO,MAAM,sBAAsB,QAAkC,CAAC;AACtE,eAAO,MAAM,wBAAwB,QAAoC,CAAC;AAG1E,eAAO,MAAM,oBAAoB,mOAcvB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;CAoBjB,CAAC;AAGX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGlE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,aAAa,CAE5E"}
+{"version":3,"file":"tool-ids.d.ts","sourceRoot":"","sources":["../src/tool-ids.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,oBAAoB,gBAAmC,CAAC;AACrE,eAAO,MAAM,oBAAoB,gBAAgC,CAAC;AAClE,eAAO,MAAM,oBAAoB,iBAAgC,CAAC;AAClE,eAAO,MAAM,oBAAoB,gBAAgC,CAAC;AAClE,eAAO,MAAM,sBAAsB,kBAAkC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mBAAkC,CAAC;AACtE,eAAO,MAAM,mBAAmB,oBAA+B,CAAC;AAChE,eAAO,MAAM,uBAAuB,mBAAmC,CAAC;AACxE,eAAO,MAAM,kBAAkB,cAA8B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,eAA+B,CAAC;AAChE,eAAO,MAAM,iBAAiB,aAA6B,CAAC;AAC5D,eAAO,MAAM,4BAA4B,iBAAmC,CAAC;AAC7E,eAAO,MAAM,iBAAiB,gBAAwB,CAAC;AACvD,eAAO,MAAM,sBAAsB,gBAAkC,CAAC;AACtE,eAAO,MAAM,uBAAuB,iBAAmC,CAAC;AACxE,eAAO,MAAM,sBAAsB,QAAkC,CAAC;AACtE,eAAO,MAAM,wBAAwB,QAAoC,CAAC;AAC1E,eAAO,MAAM,eAAe,WAA2B,CAAC;AAGxD,eAAO,MAAM,oBAAoB,8OAevB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;CA2BjB,CAAC;AAGX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGlE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,aAAa,CAE5E"}

package/dist/tool-ids.js

@@ -1,4 +1,4 @@
-import { SEMANTIC_SEARCH_TOOL_CONFIG, MODEL_SEARCH_TOOL_CONFIG, MODEL_DETAIL_TOOL_CONFIG, MODEL_DETAIL_PROMPT_CONFIG, PAPER_SEARCH_TOOL_CONFIG, DATASET_SEARCH_TOOL_CONFIG, DATASET_DETAIL_TOOL_CONFIG, DATASET_DETAIL_PROMPT_CONFIG, HUB_INSPECT_TOOL_CONFIG, DUPLICATE_SPACE_TOOL_CONFIG, SPACE_INFO_TOOL_CONFIG, SPACE_FILES_TOOL_CONFIG, USER_SUMMARY_PROMPT_CONFIG, PAPER_SUMMARY_PROMPT_CONFIG, DOCS_SEMANTIC_SEARCH_CONFIG, DOC_FETCH_CONFIG, USE_SPACE_TOOL_CONFIG, } from './index.js';
+import { SEMANTIC_SEARCH_TOOL_CONFIG, MODEL_SEARCH_TOOL_CONFIG, MODEL_DETAIL_TOOL_CONFIG, MODEL_DETAIL_PROMPT_CONFIG, PAPER_SEARCH_TOOL_CONFIG, DATASET_SEARCH_TOOL_CONFIG, DATASET_DETAIL_TOOL_CONFIG, DATASET_DETAIL_PROMPT_CONFIG, HUB_INSPECT_TOOL_CONFIG, DUPLICATE_SPACE_TOOL_CONFIG, SPACE_INFO_TOOL_CONFIG, SPACE_FILES_TOOL_CONFIG, USER_SUMMARY_PROMPT_CONFIG, PAPER_SUMMARY_PROMPT_CONFIG, DOCS_SEMANTIC_SEARCH_CONFIG, DOC_FETCH_CONFIG, USE_SPACE_TOOL_CONFIG, HF_JOBS_TOOL_CONFIG, } from './index.js';
 export const SPACE_SEARCH_TOOL_ID = SEMANTIC_SEARCH_TOOL_CONFIG.name;
 export const MODEL_SEARCH_TOOL_ID = MODEL_SEARCH_TOOL_CONFIG.name;
 export const MODEL_DETAIL_TOOL_ID = MODEL_DETAIL_TOOL_CONFIG.name;
@@ -16,6 +16,7 @@ export const USER_SUMMARY_PROMPT_ID = USER_SUMMARY_PROMPT_CONFIG.name;
 export const PAPER_SUMMARY_PROMPT_ID = PAPER_SUMMARY_PROMPT_CONFIG.name;
 export const MODEL_DETAIL_PROMPT_ID = MODEL_DETAIL_PROMPT_CONFIG.name;
 export const DATASET_DETAIL_PROMPT_ID = DATASET_DETAIL_PROMPT_CONFIG.name;
+export const HF_JOBS_TOOL_ID = HF_JOBS_TOOL_CONFIG.name;
 export const ALL_BUILTIN_TOOL_IDS = [
     SPACE_SEARCH_TOOL_ID,
     MODEL_SEARCH_TOOL_ID,
@@ -30,6 +31,7 @@ export const ALL_BUILTIN_TOOL_IDS = [
     DOCS_SEMANTIC_SEARCH_TOOL_ID,
     DOC_FETCH_TOOL_ID,
     USE_SPACE_TOOL_ID,
+    HF_JOBS_TOOL_ID,
 ];
 export const TOOL_ID_GROUPS = {
     search: [
@@ -39,7 +41,13 @@ export const TOOL_ID_GROUPS = {
         PAPER_SEARCH_TOOL_ID,
         DOCS_SEMANTIC_SEARCH_TOOL_ID,
     ],
-    spaces: [SPACE_SEARCH_TOOL_ID, DUPLICATE_SPACE_TOOL_ID, SPACE_INFO_TOOL_ID, SPACE_FILES_TOOL_ID, USE_SPACE_TOOL_ID],
+    spaces: [
+        SPACE_SEARCH_TOOL_ID,
+        DUPLICATE_SPACE_TOOL_ID,
+        SPACE_INFO_TOOL_ID,
+        SPACE_FILES_TOOL_ID,
+        USE_SPACE_TOOL_ID,
+    ],
     detail: [MODEL_DETAIL_TOOL_ID, DATASET_DETAIL_TOOL_ID, HUB_INSPECT_TOOL_ID],
     docs: [DOCS_SEMANTIC_SEARCH_TOOL_ID, DOC_FETCH_TOOL_ID],
     hf_api: [

package/dist/tool-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ids.js","sourceRoot":"","sources":["../src/tool-ids.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,GACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,IAAI,CAAC;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,IAAI,CAAC;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,IAAI,CAAC;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,IAAI,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,IAAI,CAAC;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC,IAAI,CAAC;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,IAAI,CAAC;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,IAAI,CAAC;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,2BAA2B,CAAC,IAAI,CAAC;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC,IAAI,CAAC;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAA4B,CAAC,IAAI,CAAC;AAG1E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,uBAAuB;IACvB,kBAAkB;IAClB,mBAAmB;IACnB,4BAA4B;IAC5B,iBAAiB;IACjB,iBAAiB;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,MAAM,EAAE;QACP,oBAAoB;QACpB,oBAAoB;QACpB,sBAAsB;QACtB,oBAAoB;QACpB,4BAA4B;KACnB;IACV,MAAM,EAAE,CAAC,oBAAoB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,CAAU;IAC5H,MAAM,EAAE,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,CAAU;IACpF,IAAI,EAAE,CAAC,4BAA4B,EAAE,iBAAiB,CAAU;IAChE,MAAM,EAAE;QACP,oBAAoB;QACpB,oBAAoB;QACpB,sBAAsB;QACtB,oBAAoB;QACpB,mBAAmB;QACnB,4BAA4B;KACnB;IACV,GAAG,EAAE,CAAC,GAAG,oBAAoB,CAAU;CAC9B,CAAC;AAMX,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAClD,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"tool-ids.js","sourceRoot":"","sources":["../src/tool-ids.ts"],"names":[],"mappings":"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"}

package/dist/types/tool-result.d.ts

@@ -2,5 +2,6 @@ export interface ToolResult {
     formatted: string;
     totalResults: number;
     resultsShared: number;
+    isError?: boolean;
 }
 //# sourceMappingURL=tool-result.d.ts.map

package/dist/types/tool-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/types/tool-result.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IAI1B,SAAS,EAAE,MAAM,CAAC;IAOlB,YAAY,EAAE,MAAM,CAAC;IAQrB,aAAa,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/types/tool-result.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IAI1B,SAAS,EAAE,MAAM,CAAC;IAOlB,YAAY,EAAE,MAAM,CAAC;IAQrB,aAAa,EAAE,MAAM,CAAC;IAMtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/use-space.d.ts

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { HfApiCall } from './hf-api-call.js';
 import type { ToolResult } from './types/tool-result.js';
-import './types/mcp-ui-server-shim.js';
 interface UseSpaceResult {
     [x: string]: unknown;
     content: Array<{

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

@@ -1 +1 @@
-{"version":3,"file":"use-space.d.ts","sourceRoot":"","sources":["../src/use-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,+BAA+B,CAAC;AAGvC,UAAU,cAAc;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAErB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACrF,QAAQ,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAaxB,CAAC;AAEX,qBAAa,YAAa,SAAQ,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;gBAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IAE3B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA4D9D;AAED,eAAO,MAAM,oBAAoB,GAAU,MAAM,YAAY,EAAE,QAAQ,cAAc,KAAG,OAAO,CAAC,cAAc,CAE7G,CAAC"}
+{"version":3,"file":"use-space.d.ts","sourceRoot":"","sources":["../src/use-space.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,UAAU,cAAc;IACvB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAErB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACrF,QAAQ,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAaxB,CAAC;AAEX,qBAAa,YAAa,SAAQ,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;gBAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IAE3B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA4D9D;AAED,eAAO,MAAM,oBAAoB,GAAU,MAAM,YAAY,EAAE,QAAQ,cAAc,KAAG,OAAO,CAAC,cAAc,CAE7G,CAAC"}

package/dist/use-space.js

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { HfApiCall } from './hf-api-call.js';
 import { spaceInfo } from '@huggingface/hub';
-import './types/mcp-ui-server-shim.js';
 import { createUIResource } from '@mcp-ui/server';
 export const USE_SPACE_TOOL_CONFIG = {
     name: 'use_space',

package/dist/use-space.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmindset/hf-mcp",
-  "version": "0.2.32",
+  "version": "0.2.34",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,13 +24,15 @@
   },
   "dependencies": {
     "@huggingface/hub": "^2.1.0",
-    "@mcp-ui/server": "^5.10.0",
+    "@mcp-ui/server": "^5.12.0",
+    "shell-quote": "^1.8.3",
     "turndown": "^7.2.0",
     "zod": "^3.24.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
     "@types/node": "^22.15.18",
+    "@types/shell-quote": "^1.7.5",
     "@types/turndown": "^5.0.5",
     "eslint": "^9.25.0",
     "globals": "^16.0.0",

package/src/docs-search/docs-semantic-search.ts

@@ -10,23 +10,34 @@ import type { ToolResult } from '../types/tool-result.js';
 export const DOCS_SEMANTIC_SEARCH_CONFIG = {
 	name: 'hf_doc_search',
 	description:
-		'Search documentation about all of Hugging Face products and libraries (Transformers, Datasets, Diffusers, Gradio, Hub, and more). Use this for the most up-to-date information ' +
-		'Returns excerpts grouped by Product and Document.',
+		'Search and Discover Hugging Face Product and Library documentation. Use an empty query to discover structure and navigation hints and tips. ' +
+		'You MUST consult this tool for the most up-to-date information when using Hugging Face libraries. Combine with the Product filter to focus results.',
 	schema: z.object({
 		query: z
 			.string()
-			.min(3, 'Supply at least one search term')
 			.max(200, 'Query too long')
-			.describe('Semantic search query'),
-		product: z
-			.string()
-			.optional()
+			.superRefine((value, ctx) => {
+				const trimmed = value.trim();
+				if (trimmed.length === 0) {
+					return;
+				}
+				if (trimmed.length < 3) {
+					ctx.addIssue({
+						code: z.ZodIssueCode.too_small,
+						type: 'string',
+						minimum: 3,
+						inclusive: true,
+						message: 'Supply at least one search term',
+					});
+				}
+			})
 			.describe(
-				'Filter by Product (e.g., "hub", "dataset-viewer", "transformers"). Supply when known for focused results'
+				'Start with an empty query for structure, endpoint discovery and navigation tips. Use semantic queries for targetted searches.'
 			),
+		product: z.string().optional().describe('Filter by Product. Supply when known for focused results'),
 	}),
 	annotations: {
-		title: 'Hugging Face Documentation Library Search',
+		title: 'Hugging Face Documentation Search',
 		destructiveHint: false,
 		readOnlyHint: true,
 		openWorldHint: true,
@@ -49,9 +60,16 @@ interface DocSearchApiParams {
 	product?: string;
 }
 
+interface DocsIndexEntry {
+	id: string;
+	url: string;
+	category: string;
+}
+
 // Token budget defaults
 const DEFAULT_TOKEN_BUDGET = 12500;
 const TRUNCATE_EXCERPT_LENGTH = 400; // chars for truncated excerpts
+const DOCS_INDEX_URL = 'https://huggingface.co/api/docs';
 
 /**
  * Use the Hugging Face Semantic Document Search API
@@ -75,13 +93,13 @@ export class DocSearchTool extends HfApiCall<DocSearchApiParams, DocSearchResult
 	 */
 	async search(params: DocSearchParams): Promise<ToolResult> {
 		try {
-			if (!params.query) return {
-				formatted: 'No query provided',
-				totalResults: 0,
-				resultsShared: 0
-			};
+			const query = params.query?.trim() ?? '';
+			if (query.length === 0) {
+				const docsIndex = await this.fetchFromApi<DocsIndexEntry[]>(DOCS_INDEX_URL);
+				return formatDocsIndex(docsIndex);
+			}
 
-			const apiParams: DocSearchApiParams = { q: params.query.toLowerCase() };
+			const apiParams: DocSearchApiParams = { q: query.toLowerCase() };
 			if (params.product) {
 				apiParams.product = params.product;
 			}
@@ -91,14 +109,14 @@ export class DocSearchTool extends HfApiCall<DocSearchApiParams, DocSearchResult
 			if (results.length === 0) {
 				return {
 					formatted: params.product
-						? `No documentation found for query '${params.query}' in product '${params.product}'`
-						: `No documentation found for query '${params.query}'`,
+						? `No documentation found for query '${query}' in product '${params.product}'`
+						: `No documentation found for query '${query}'`,
 					totalResults: 0,
-					resultsShared: 0
+					resultsShared: 0,
 				};
 			}
 
-			return formatSearchResults(params.query, results, params.product, this.tokenBudget);
+			return formatSearchResults(query, results, params.product, this.tokenBudget);
 		} catch (error) {
 			if (error instanceof Error) {
 				throw new Error(`Failed to search documentation: ${error.message}`);
@@ -138,6 +156,39 @@ function groupResults(results: DocSearchResult[]): Map<string, Map<string, DocSe
 	return grouped;
 }
 
+/**
+ * Format the documentation root index response for empty queries
+ */
+function formatDocsIndex(docsIndex: DocsIndexEntry[]): ToolResult {
+	if (!docsIndex.length) {
+		return {
+			formatted:
+				'No documentation categories are currently available. Try running the search again with specific terms.',
+			totalResults: 0,
+			resultsShared: 0,
+		};
+	}
+
+	const header = '### Hugging Face Documentation Products\n';
+	const tableHeader = '| Product | Category | Documentation |\n| --- | --- | --- |\n';
+	const rows = docsIndex
+		.map((entry) => {
+			const docsUrl = `https://huggingface.co${entry.url}`;
+			return `| \`${entry.id}\` | ${escapeMarkdown(entry.category)} | ${docsUrl} |`;
+		})
+		.join('\n');
+
+	const llmsNote =
+		'\n\nEach documentation root exposes an `llms.txt` endpoint (e.g. add `/llms.txt` to the documentation URL). ' +
+		'Use semantic search when you have a specific question for faster, more targeted results.';
+
+	return {
+		formatted: `${header}${tableHeader}${rows}${llmsNote}`,
+		totalResults: docsIndex.length,
+		resultsShared: docsIndex.length,
+	};
+}
+
 /**
  * Group page results by section (heading2)
  */
@@ -323,6 +374,6 @@ function formatSearchResults(
 	return {
 		formatted: lines.join('\n'),
 		totalResults: results.length,
-		resultsShared: results.length
+		resultsShared: results.length,
 	};
 }

package/src/hf-api-call.ts

@@ -120,6 +120,12 @@ export class HfApiCall<TParams = Record<string, string | undefined>, TResponse =
 					// Ignore if we can't read the body
 				}
 
+				// Log the error for debugging
+				console.error(`[API Error] ${response.status} ${response.statusText}`);
+				if (responseBody) {
+					console.error('[API Error] Response:', responseBody);
+				}
+
 				throw new HfApiError(
 					`API request failed: ${response.status.toString()} ${response.statusText}`,
 					response.status,

package/src/index.ts

@@ -19,6 +19,7 @@ export * from './docs-search/docs-semantic-search.js';
 export * from './docs-search/doc-fetch.js';
 export * from './readme-utils.js';
 export * from './use-space.js';
+export * from './jobs/tool.js';
 
 // Export shared types
 export * from './types/tool-result.js';

package/src/jobs/api-client.ts

@@ -0,0 +1,195 @@
+import { HfApiCall } from '../hf-api-call.js';
+import type { JobInfo, JobSpec, ScheduledJobInfo, ScheduledJobSpec } from './types.js';
+
+/**
+ * Interface for whoami API response
+ */
+interface WhoAmIResponse {
+	name: string;
+	id: string;
+	type: 'user' | 'org';
+	[key: string]: unknown;
+}
+
+/**
+ * API client for HuggingFace Jobs API
+ * Handles all HTTP interactions with the Jobs API endpoints
+ */
+export class JobsApiClient extends HfApiCall {
+	private namespaceCache: string | null = null;
+
+	constructor(hfToken?: string, namespace?: string) {
+		// Base URL is the main HF API, we'll construct specific endpoints
+		super('https://huggingface.co/api', hfToken);
+		// Initialize cache with provided namespace to avoid redundant whoami calls
+		this.namespaceCache = namespace || null;
+	}
+
+	/**
+	 * Get the namespace (username or org) for the current user
+	 * Uses cached value from constructor or /api/whoami-v2 endpoint as fallback
+	 */
+	async getNamespace(namespace?: string): Promise<string> {
+		if (namespace) {
+			return namespace;
+		}
+
+		if (this.namespaceCache) {
+			return this.namespaceCache;
+		}
+
+		// Fetch from whoami endpoint only if not cached
+		const whoami = await this.fetchFromApi<WhoAmIResponse>('https://huggingface.co/api/whoami-v2');
+		this.namespaceCache = whoami.name;
+		return this.namespaceCache;
+	}
+
+	/**
+	 * Run a job
+	 * POST /api/jobs/{namespace}
+	 */
+	async runJob(jobSpec: JobSpec, namespace?: string): Promise<JobInfo> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/jobs/${ns}`;
+
+		// Debug logging (will be visible in server logs)
+		console.error('[Jobs API] POST', url);
+		console.error('[Jobs API] Payload:', JSON.stringify(jobSpec, null, 2));
+
+		try {
+			const result = await this.fetchFromApi<JobInfo>(url, {
+				method: 'POST',
+				headers: {
+					'Content-Type': 'application/json',
+				},
+				body: JSON.stringify(jobSpec),
+			});
+			console.error('[Jobs API] Success:', result.id);
+			return result;
+		} catch (error) {
+			console.error('[Jobs API] Error:', error);
+			throw error;
+		}
+	}
+
+	/**
+	 * List all jobs for a namespace
+	 * GET /api/jobs/{namespace}
+	 */
+	async listJobs(namespace?: string): Promise<JobInfo[]> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/jobs/${ns}`;
+
+		return this.fetchFromApi<JobInfo[]>(url);
+	}
+
+	/**
+	 * Get detailed information about a specific job
+	 * GET /api/jobs/{namespace}/{jobId}
+	 */
+	async getJob(jobId: string, namespace?: string): Promise<JobInfo> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/jobs/${ns}/${jobId}`;
+
+		return this.fetchFromApi<JobInfo>(url);
+	}
+
+	/**
+	 * Cancel a running job
+	 * POST /api/jobs/{namespace}/{jobId}/cancel
+	 */
+	async cancelJob(jobId: string, namespace?: string): Promise<void> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/jobs/${ns}/${jobId}/cancel`;
+
+		await this.fetchFromApi<void>(url, {
+			method: 'POST',
+		});
+	}
+
+	/**
+	 * Get logs URL for a job
+	 * Returns the URL for SSE streaming - caller handles the actual streaming
+	 */
+	getLogsUrl(jobId: string, namespace: string): string {
+		return `https://huggingface.co/api/jobs/${namespace}/${jobId}/logs`;
+	}
+
+	/**
+	 * Create a scheduled job
+	 * POST /api/scheduled-jobs/{namespace}
+	 */
+	async createScheduledJob(spec: ScheduledJobSpec, namespace?: string): Promise<ScheduledJobInfo> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}`;
+
+		return this.fetchFromApi<ScheduledJobInfo>(url, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+			},
+			body: JSON.stringify(spec),
+		});
+	}
+
+	/**
+	 * List all scheduled jobs
+	 * GET /api/scheduled-jobs/{namespace}
+	 */
+	async listScheduledJobs(namespace?: string): Promise<ScheduledJobInfo[]> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}`;
+
+		return this.fetchFromApi<ScheduledJobInfo[]>(url);
+	}
+
+	/**
+	 * Get details of a scheduled job
+	 * GET /api/scheduled-jobs/{namespace}/{scheduledJobId}
+	 */
+	async getScheduledJob(scheduledJobId: string, namespace?: string): Promise<ScheduledJobInfo> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}/${scheduledJobId}`;
+		console.error(url);
+		return this.fetchFromApi<ScheduledJobInfo>(url);
+	}
+
+	/**
+	 * Delete a scheduled job
+	 * DELETE /api/scheduled-jobs/{namespace}/{scheduledJobId}
+	 */
+	async deleteScheduledJob(scheduledJobId: string, namespace?: string): Promise<void> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}/${scheduledJobId}`;
+
+		await this.fetchFromApi<void>(url, {
+			method: 'DELETE',
+		});
+	}
+
+	/**
+	 * Suspend a scheduled job
+	 * POST /api/scheduled-jobs/{namespace}/{scheduledJobId}/suspend
+	 */
+	async suspendScheduledJob(scheduledJobId: string, namespace?: string): Promise<void> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}/${scheduledJobId}/suspend`;
+
+		await this.fetchFromApi<void>(url, {
+			method: 'POST',
+		});
+	}
+
+	/**
+	 * Resume a suspended scheduled job
+	 * POST /api/scheduled-jobs/{namespace}/{scheduledJobId}/resume
+	 */
+	async resumeScheduledJob(scheduledJobId: string, namespace?: string): Promise<void> {
+		const ns = await this.getNamespace(namespace);
+		const url = `https://huggingface.co/api/scheduled-jobs/${ns}/${scheduledJobId}/resume`;
+
+		await this.fetchFromApi<void>(url, {
+			method: 'POST',
+		});
+	}
+}