@llmindset/hf-mcp 0.2.33 → 0.2.35

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmindset/hf-mcp",
-  "version": "0.2.33",
+  "version": "0.2.35",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,14 +23,16 @@
     }
   },
   "dependencies": {
-    "@huggingface/hub": "^2.1.0",
+    "@huggingface/hub": "^2.6.12",
     "@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,7 +10,7 @@ import type { ToolResult } from '../types/tool-result.js';
 export const DOCS_SEMANTIC_SEARCH_CONFIG = {
 	name: 'hf_doc_search',
 	description:
-		'Search and Discover Hugging Face Product and Library documentation. Use an empty query to discover structure and navigation hints and tips. ' +
+		'Search and Discover Hugging Face Product and Library documentation. Send an empty query to discover structure and navigation instructions. ' +
 		'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

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,187 @@
+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)
+
+		const result = await this.fetchFromApi<JobInfo>(url, {
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/json',
+			},
+			body: JSON.stringify(jobSpec),
+		});
+		return result;
+	}
+
+	/**
+	 * 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',
+		});
+	}
+}

package/src/jobs/commands/inspect.ts

@@ -0,0 +1,38 @@
+import type { InspectArgs, CancelArgs } from '../types.js';
+import type { JobsApiClient } from '../api-client.js';
+import { formatJobDetails } from '../formatters.js';
+
+/**
+ * Execute the 'inspect' command
+ * Gets detailed information about one or more jobs
+ */
+export async function inspectCommand(args: InspectArgs, client: JobsApiClient): Promise<string> {
+	const jobIds = Array.isArray(args.job_id) ? args.job_id : [args.job_id];
+
+	// Fetch all jobs
+	const jobs = await Promise.all(
+		jobIds.map(async (id) => {
+			try {
+				return await client.getJob(id, args.namespace);
+			} catch (error) {
+				throw new Error(`Failed to fetch job ${id}: ${(error as Error).message}`);
+			}
+		})
+	);
+
+	const formattedDetails = formatJobDetails(jobs);
+
+	return `**Job Details** (${jobs.length} job${jobs.length > 1 ? 's' : ''}):\n\n${formattedDetails}`;
+}
+
+/**
+ * Execute the 'cancel' command
+ * Cancels a running job
+ */
+export async function cancelCommand(args: CancelArgs, client: JobsApiClient): Promise<string> {
+	await client.cancelJob(args.job_id, args.namespace);
+
+	return `✓ Job ${args.job_id} has been cancelled.
+
+To verify: \`hf_jobs("inspect", {"job_id": "${args.job_id}"})\``;
+}

package/src/jobs/commands/logs.ts

@@ -0,0 +1,36 @@
+import type { LogsArgs } from '../types.js';
+import type { JobsApiClient } from '../api-client.js';
+import { fetchJobLogs } from '../sse-handler.js';
+
+/**
+ * Execute the 'logs' command
+ * Fetches logs from a job via SSE
+ */
+export async function logsCommand(args: LogsArgs, client: JobsApiClient, token?: string): Promise<string> {
+	// Get namespace for the logs URL
+	const namespace = await client.getNamespace(args.namespace);
+	const logsUrl = client.getLogsUrl(args.job_id, namespace);
+
+	// Fetch logs with timeout and line limit
+	const result = await fetchJobLogs(logsUrl, {
+		token,
+		maxDuration: 10000,
+		maxLines: args.tail,
+	});
+
+	if (result.logs.length === 0) {
+		return `No logs available for job ${args.job_id}`;
+	}
+
+	let response = `**Logs for job ${args.job_id}** (last ${args.tail} lines):\n\n${'```'}\n`;
+	response += result.logs.join('\n');
+	response += `\n${'```'}`;
+
+	if (result.finished) {
+		response += '\n\n✓ Job finished.';
+	} else if (result.truncated) {
+		response += '\n\n⚠ Log collection stopped after 10 seconds. Job may still be running.';
+	}
+
+	return response;
+}

package/src/jobs/commands/ps.ts

@@ -0,0 +1,40 @@
+import type { PsArgs } from '../types.js';
+import type { JobsApiClient } from '../api-client.js';
+import { formatJobsTable } from '../formatters.js';
+
+/**
+ * Execute the 'ps' command
+ * Lists jobs with optional filtering
+ */
+export async function psCommand(args: PsArgs, client: JobsApiClient): Promise<string> {
+	// Fetch all jobs from API
+	const allJobs = await client.listJobs(args.namespace);
+
+	// Filter jobs
+	let jobs = allJobs;
+
+	// Default: show only running jobs unless --all is specified
+	if (!args.all) {
+		jobs = jobs.filter((job) => job.status.stage === 'RUNNING');
+	}
+
+	// Apply status filter if specified
+	if (args.status) {
+		const statusFilter = args.status.toUpperCase();
+		jobs = jobs.filter((job) => job.status.stage.toUpperCase().includes(statusFilter));
+	}
+
+	// Format as markdown table
+	const table = formatJobsTable(jobs);
+
+	if (jobs.length === 0) {
+		if (args.all) {
+			return 'No jobs found.';
+		}
+		return 'No running jobs found. Use `{"all": true}` to show all jobs.';
+	}
+
+	return `**Jobs (${jobs.length} of ${allJobs.length} total):**
+
+${table}`;
+}