@computesdk/hopx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 computesdk
+
+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/index.d.mts

@@ -0,0 +1,32 @@
+import * as _computesdk_provider from '@computesdk/provider';
+import { Sandbox } from '@hopx-ai/sdk';
+export { Sandbox as HopxSandbox } from '@hopx-ai/sdk';
+import { Runtime } from 'computesdk';
+
+/**
+ * HopX-specific configuration options
+ */
+interface HopxConfig {
+    /** HopX API key - if not provided, will fallback to HOPX_API_KEY environment variable */
+    apiKey?: string;
+    /** Default runtime environment */
+    runtime?: Runtime;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** Template name for sandbox creation (e.g., 'code-interpreter') */
+    template?: string;
+    /** Base API URL for custom/staging environments */
+    baseURL?: string;
+}
+/**
+ * Create a HopX provider instance using the factory pattern
+ *
+ * HopX provides isolated cloud sandboxes with:
+ * - Full root access to the VM
+ * - Pre-installed language runtimes (Python, Node.js, etc.)
+ * - Persistent filesystem during session
+ * - Automatic cleanup after timeout
+ */
+declare const hopx: (config: HopxConfig) => _computesdk_provider.Provider<Sandbox, any, any>;
+
+export { type HopxConfig, hopx };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import * as _computesdk_provider from '@computesdk/provider';
+import { Sandbox } from '@hopx-ai/sdk';
+export { Sandbox as HopxSandbox } from '@hopx-ai/sdk';
+import { Runtime } from 'computesdk';
+
+/**
+ * HopX-specific configuration options
+ */
+interface HopxConfig {
+    /** HopX API key - if not provided, will fallback to HOPX_API_KEY environment variable */
+    apiKey?: string;
+    /** Default runtime environment */
+    runtime?: Runtime;
+    /** Execution timeout in milliseconds */
+    timeout?: number;
+    /** Template name for sandbox creation (e.g., 'code-interpreter') */
+    template?: string;
+    /** Base API URL for custom/staging environments */
+    baseURL?: string;
+}
+/**
+ * Create a HopX provider instance using the factory pattern
+ *
+ * HopX provides isolated cloud sandboxes with:
+ * - Full root access to the VM
+ * - Pre-installed language runtimes (Python, Node.js, etc.)
+ * - Persistent filesystem during session
+ * - Automatic cleanup after timeout
+ */
+declare const hopx: (config: HopxConfig) => _computesdk_provider.Provider<Sandbox, any, any>;
+
+export { type HopxConfig, hopx };

package/dist/index.js

@@ -0,0 +1,359 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  hopx: () => hopx
+});
+module.exports = __toCommonJS(index_exports);
+var import_sdk = require("@hopx-ai/sdk");
+var import_provider = require("@computesdk/provider");
+var hopx = (0, import_provider.defineProvider)({
+  name: "hopx",
+  methods: {
+    sandbox: {
+      /**
+       * Create a new HopX sandbox
+       * 
+       * Uses Sandbox.create() from @hopx-ai/sdk to provision a new sandbox.
+       * Default template is 'code-interpreter' if not specified.
+       */
+      create: async (config, options) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing HopX API key. Provide 'apiKey' in config or set HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`
+          );
+        }
+        const timeoutSeconds = config.timeout ? Math.ceil(config.timeout / 1e3) : void 0;
+        try {
+          let sandbox;
+          let sandboxId;
+          if (options?.sandboxId) {
+            sandbox = await import_sdk.Sandbox.connect(options.sandboxId, apiKey, config.baseURL);
+            sandboxId = options.sandboxId;
+          } else {
+            const createOptions = {
+              apiKey,
+              baseURL: config.baseURL,
+              timeoutSeconds
+            };
+            if (options?.templateId) {
+              createOptions.templateId = options.templateId;
+            } else {
+              createOptions.template = config.template || "code-interpreter";
+            }
+            if (options?.envs) {
+              createOptions.envVars = options.envs;
+            }
+            sandbox = await import_sdk.Sandbox.create(createOptions);
+            sandboxId = sandbox.sandboxId;
+          }
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          if (error instanceof Error) {
+            if (error.message.includes("unauthorized") || error.message.includes("API key") || error.message.includes("401")) {
+              throw new Error(
+                `HopX authentication failed. Please check your HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`
+              );
+            }
+            if (error.message.includes("quota") || error.message.includes("limit")) {
+              throw new Error(
+                `HopX quota exceeded. Please check your usage at https://hopx.ai/dashboard`
+              );
+            }
+          }
+          throw new Error(
+            `Failed to create HopX sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Connect to an existing HopX sandbox by ID
+       * 
+       * Uses Sandbox.connect() to reconnect to a running sandbox.
+       * Returns null if sandbox doesn't exist or can't be accessed.
+       */
+      getById: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return null;
+        }
+        try {
+          const sandbox = await import_sdk.Sandbox.connect(sandboxId, apiKey, config.baseURL);
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          return null;
+        }
+      },
+      /**
+       * List all active HopX sandboxes
+       * 
+       * Uses Sandbox.list() to get all sandboxes for the account.
+       */
+      list: async (config) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return [];
+        }
+        try {
+          const sandboxes = await import_sdk.Sandbox.list({
+            apiKey,
+            baseURL: config.baseURL
+          });
+          return sandboxes.map((sandbox) => ({
+            sandbox,
+            sandboxId: sandbox.sandboxId
+          }));
+        } catch (error) {
+          return [];
+        }
+      },
+      /**
+       * Destroy a HopX sandbox
+       * 
+       * Uses sandbox.kill() to terminate and clean up the sandbox.
+       */
+      destroy: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return;
+        }
+        try {
+          const sandbox = await import_sdk.Sandbox.connect(sandboxId, apiKey, config.baseURL);
+          await sandbox.kill();
+        } catch (error) {
+        }
+      },
+      /**
+       * Execute code in the sandbox
+       * 
+       * Uses sandbox.runCode() with auto-detected runtime.
+       * Maps ComputeSDK runtime ('node'/'python') to HopX language ('javascript'/'python').
+       */
+      runCode: async (sandbox, code, runtime) => {
+        try {
+          const effectiveRuntime = runtime || // Strong Python indicators
+          (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") || code.includes("raise ") ? "python" : "node");
+          const language = effectiveRuntime === "node" ? "javascript" : "python";
+          const result = await sandbox.runCode(code, { language });
+          const output = result.stderr ? `${result.stdout}${result.stdout && result.stderr ? "\n" : ""}${result.stderr}` : result.stdout;
+          const combinedOutput = `${result.stdout || ""} ${result.stderr || ""}`;
+          const hasSyntaxError = (
+            // Python syntax errors
+            combinedOutput.includes("SyntaxError") || combinedOutput.includes("invalid syntax") || combinedOutput.includes("IndentationError") || combinedOutput.includes("TabError") || combinedOutput.includes("NameError") && combinedOutput.includes("is not defined") || // JavaScript/Node.js syntax errors
+            combinedOutput.includes("Unexpected token") || combinedOutput.includes("Unexpected identifier") || // Bun parser errors (JavaScript in HopX runs via Bun)
+            combinedOutput.includes("Unexpected end of file") || combinedOutput.includes("Expected") && combinedOutput.includes("but found")
+          );
+          const isRuntimeError = combinedOutput.includes("throw ") || combinedOutput.includes("raise ") || combinedOutput.includes("Traceback (most recent call last)") || combinedOutput.includes("Error:") && !combinedOutput.includes("SyntaxError") || combinedOutput.includes("Exception:") && !combinedOutput.includes("SyntaxError");
+          if (hasSyntaxError && !isRuntimeError) {
+            throw new Error(`Syntax error: ${(result.stderr || result.stdout || "").trim()}`);
+          }
+          if (result.exit_code !== 0 && !result.stdout && !result.stderr) {
+            throw new Error(`Code execution failed with exit code ${result.exit_code}`);
+          }
+          return {
+            output,
+            exitCode: result.exit_code,
+            language: effectiveRuntime
+          };
+        } catch (error) {
+          if (error instanceof Error && error.message.includes("Syntax error")) {
+            throw error;
+          }
+          throw new Error(
+            `HopX execution failed: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Execute a shell command in the sandbox
+       * 
+       * Uses sandbox.commands.run() to execute shell commands.
+       * Arguments are properly quoted to handle special characters.
+       */
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          let fullCommand = command;
+          if (options?.env && Object.keys(options.env).length > 0) {
+            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${v.replace(/"/g, '\\"')}"`).join(" ");
+            fullCommand = `${envPrefix} ${fullCommand}`;
+          }
+          if (options?.cwd) {
+            fullCommand = `cd "${options.cwd.replace(/"/g, '\\"')}" && ${fullCommand}`;
+          }
+          if (options?.background) {
+            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;
+          }
+          const result = await sandbox.commands.run(fullCommand);
+          return {
+            stdout: result.stdout || "",
+            stderr: result.stderr || "",
+            exitCode: result.exit_code || 0,
+            // Note: HopX uses snake_case
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          const result = error?.result;
+          if (result) {
+            return {
+              stdout: result.stdout || "",
+              stderr: result.stderr || "",
+              exitCode: result.exit_code || 1,
+              durationMs: Date.now() - startTime
+            };
+          }
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      /**
+       * Get sandbox information
+       * 
+       * Uses sandbox.getInfo() to retrieve sandbox metadata.
+       */
+      getInfo: async (sandbox) => {
+        try {
+          const info = await sandbox.getInfo();
+          return {
+            id: sandbox.sandboxId,
+            provider: "hopx",
+            runtime: "python",
+            // HopX default runtime
+            status: info.status || "running",
+            createdAt: info.createdAt ? new Date(info.createdAt) : /* @__PURE__ */ new Date(),
+            timeout: info.timeoutSeconds ? info.timeoutSeconds * 1e3 : 3e5,
+            metadata: {
+              templateName: info.templateName,
+              templateId: info.templateId,
+              region: info.region,
+              publicHost: info.publicHost
+            }
+          };
+        } catch (error) {
+          return {
+            id: sandbox.sandboxId,
+            provider: "hopx",
+            runtime: "python",
+            status: "running",
+            createdAt: /* @__PURE__ */ new Date(),
+            timeout: 3e5,
+            metadata: {}
+          };
+        }
+      },
+      /**
+       * Get preview URL for a specific port
+       * 
+       * Uses sandbox.getPreviewUrl() to get the public URL for accessing
+       * services running on a specific port in the sandbox.
+       */
+      getUrl: async (sandbox, options) => {
+        try {
+          const url = await sandbox.getPreviewUrl(options.port);
+          return url;
+        } catch (error) {
+          throw new Error(
+            `Failed to get HopX URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Native filesystem operations using HopX's files API
+       * 
+       * HopX has full native filesystem support via sandbox.files.*
+       * This is Option A from the documentation (native API, not shell-based).
+       */
+      filesystem: {
+        /**
+         * Read file contents from sandbox
+         */
+        readFile: async (sandbox, path) => {
+          return await sandbox.files.read(path);
+        },
+        /**
+         * Write content to a file in the sandbox
+         */
+        writeFile: async (sandbox, path, content) => {
+          await sandbox.files.write(path, content);
+        },
+        /**
+         * Create a directory in the sandbox
+         */
+        mkdir: async (sandbox, path) => {
+          await sandbox.files.mkdir(path);
+        },
+        /**
+         * List directory contents
+         * 
+         * Maps HopX's EnhancedFileInfo to ComputeSDK's FileEntry format.
+         */
+        readdir: async (sandbox, path) => {
+          const entries = await sandbox.files.list(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            type: entry.isDir || entry.isDirectory ? "directory" : "file",
+            path: entry.path || `${path}/${entry.name}`.replace(/\/+/g, "/"),
+            isDirectory: Boolean(entry.isDir || entry.isDirectory || entry.type === "directory"),
+            size: entry.size || 0,
+            lastModified: entry.modTime ? new Date(entry.modTime) : /* @__PURE__ */ new Date()
+          }));
+        },
+        /**
+         * Check if a file or directory exists
+         */
+        exists: async (sandbox, path) => {
+          return await sandbox.files.exists(path);
+        },
+        /**
+         * Remove a file or directory
+         */
+        remove: async (sandbox, path) => {
+          await sandbox.files.remove(path);
+        }
+      },
+      /**
+       * Get the native HopX Sandbox instance for advanced usage
+       * 
+       * This allows users to access HopX-specific features not exposed
+       * through the ComputeSDK interface.
+       */
+      getInstance: (sandbox) => {
+        return sandbox;
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hopx
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * HopX Provider - Factory-based Implementation\n * \n * Full-featured provider with native filesystem support using the factory pattern.\n * HopX provides isolated cloud sandboxes (lightweight VMs) with full Linux environments.\n * \n * Features:\n * - Native filesystem API via sandbox.files.*\n * - Code execution in Python, JavaScript, Bash\n * - Shell command execution\n * - Preview URLs for accessing sandbox services\n */\n\nimport { Sandbox as HopxSandbox } from '@hopx-ai/sdk';\nimport { defineProvider } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions\n} from 'computesdk';\n\n/**\n * HopX-specific configuration options\n */\nexport interface HopxConfig {\n  /** HopX API key - if not provided, will fallback to HOPX_API_KEY environment variable */\n  apiKey?: string;\n  /** Default runtime environment */\n  runtime?: Runtime;\n  /** Execution timeout in milliseconds */\n  timeout?: number;\n  /** Template name for sandbox creation (e.g., 'code-interpreter') */\n  template?: string;\n  /** Base API URL for custom/staging environments */\n  baseURL?: string;\n}\n\n/**\n * Create a HopX provider instance using the factory pattern\n * \n * HopX provides isolated cloud sandboxes with:\n * - Full root access to the VM\n * - Pre-installed language runtimes (Python, Node.js, etc.)\n * - Persistent filesystem during session\n * - Automatic cleanup after timeout\n */\nexport const hopx = defineProvider<HopxSandbox, HopxConfig>({\n  name: 'hopx',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new HopX sandbox\n       * \n       * Uses Sandbox.create() from @hopx-ai/sdk to provision a new sandbox.\n       * Default template is 'code-interpreter' if not specified.\n       */\n      create: async (config: HopxConfig, options?: CreateSandboxOptions) => {\n        // Validate API key - fail fast with helpful error message\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing HopX API key. Provide 'apiKey' in config or set HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`\n          );\n        }\n\n        // Convert timeout from milliseconds to seconds (HopX uses seconds)\n        const timeoutSeconds = config.timeout ? Math.ceil(config.timeout / 1000) : undefined;\n\n        try {\n          let sandbox: HopxSandbox;\n          let sandboxId: string;\n\n          if (options?.sandboxId) {\n            // Reconnect to existing HopX sandbox using Sandbox.connect()\n            sandbox = await HopxSandbox.connect(options.sandboxId, apiKey, config.baseURL);\n            sandboxId = options.sandboxId;\n          } else {\n            // Create new HopX sandbox using Sandbox.create()\n            // Use templateId if provided, otherwise use template name or default to 'code-interpreter'\n            const createOptions: any = {\n              apiKey,\n              baseURL: config.baseURL,\n              timeoutSeconds,\n            };\n\n            // Handle template specification (templateId takes precedence)\n            if (options?.templateId) {\n              createOptions.templateId = options.templateId;\n            } else {\n              createOptions.template = config.template || 'code-interpreter';\n            }\n\n            // Pass environment variables if provided\n            if (options?.envs) {\n              createOptions.envVars = options.envs;\n            }\n\n            sandbox = await HopxSandbox.create(createOptions);\n            sandboxId = sandbox.sandboxId;\n          }\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Provide helpful error messages for common issues\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('API key') || error.message.includes('401')) {\n              throw new Error(\n                `HopX authentication failed. Please check your HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`\n              );\n            }\n            if (error.message.includes('quota') || error.message.includes('limit')) {\n              throw new Error(\n                `HopX quota exceeded. Please check your usage at https://hopx.ai/dashboard`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create HopX sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing HopX sandbox by ID\n       * \n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       * Returns null if sandbox doesn't exist or can't be accessed.\n       */\n      getById: async (config: HopxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return null;\n        }\n\n        try {\n          // Connect to existing sandbox using Sandbox.connect()\n          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Sandbox doesn't exist or can't be accessed\n          return null;\n        }\n      },\n\n      /**\n       * List all active HopX sandboxes\n       * \n       * Uses Sandbox.list() to get all sandboxes for the account.\n       */\n      list: async (config: HopxConfig) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return [];\n        }\n\n        try {\n          // List sandboxes using Sandbox.list()\n          const sandboxes = await HopxSandbox.list({\n            apiKey,\n            baseURL: config.baseURL,\n          });\n\n          return sandboxes.map((sandbox: HopxSandbox) => ({\n            sandbox,\n            sandboxId: sandbox.sandboxId\n          }));\n        } catch (error) {\n          // Return empty array if listing fails\n          return [];\n        }\n      },\n\n      /**\n       * Destroy a HopX sandbox\n       * \n       * Uses sandbox.kill() to terminate and clean up the sandbox.\n       */\n      destroy: async (config: HopxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return;\n        }\n\n        try {\n          // Connect to sandbox and kill it\n          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);\n          await sandbox.kill();\n        } catch (error) {\n          // Sandbox might already be destroyed or doesn't exist\n          // This is acceptable for destroy operations\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       * \n       * Uses sandbox.runCode() with auto-detected runtime.\n       * Maps ComputeSDK runtime ('node'/'python') to HopX language ('javascript'/'python').\n       */\n      runCode: async (sandbox: HopxSandbox, code: string, runtime?: Runtime): Promise<CodeResult> => {\n        try {\n          // Auto-detect runtime if not specified using Python indicators\n          const effectiveRuntime = runtime || (\n            // Strong Python indicators\n            code.includes('print(') ||\n            code.includes('import ') ||\n            code.includes('def ') ||\n            code.includes('sys.') ||\n            code.includes('json.') ||\n            code.includes('__') ||\n            code.includes('f\"') ||\n            code.includes(\"f'\") ||\n            code.includes('raise ')\n              ? 'python'\n              // Default to Node.js for all other cases (including ambiguous)\n              : 'node'\n          );\n\n          // Map ComputeSDK runtime to HopX language\n          // HopX uses 'javascript' instead of 'node'\n          const language = effectiveRuntime === 'node' ? 'javascript' : 'python';\n\n          // Execute code using sandbox.runCode()\n          const result = await sandbox.runCode(code, { language });\n\n          // Combine stdout and stderr for output (following E2B pattern)\n          const output = result.stderr\n            ? `${result.stdout}${result.stdout && result.stderr ? '\\n' : ''}${result.stderr}`\n            : result.stdout;\n\n          // Check for syntax/parse errors in stderr or output and throw them\n          // This ensures invalid code triggers an exception as expected by the test suite\n          // \n          // IMPORTANT: We distinguish between:\n          // - Syntax errors (invalid code that couldn't parse) → should THROW\n          // - Runtime errors (valid code that threw during execution) → should RETURN with non-zero exit\n          const combinedOutput = `${result.stdout || ''} ${result.stderr || ''}`;\n          \n          // Indicators of syntax/parse errors (code couldn't be executed)\n          // Covers Python, Node.js, and Bun error formats\n          const hasSyntaxError = \n            // Python syntax errors\n            combinedOutput.includes('SyntaxError') ||\n            combinedOutput.includes('invalid syntax') ||\n            combinedOutput.includes('IndentationError') ||\n            combinedOutput.includes('TabError') ||\n            (combinedOutput.includes('NameError') && combinedOutput.includes('is not defined')) ||\n            // JavaScript/Node.js syntax errors\n            combinedOutput.includes('Unexpected token') ||\n            combinedOutput.includes('Unexpected identifier') ||\n            // Bun parser errors (JavaScript in HopX runs via Bun)\n            combinedOutput.includes('Unexpected end of file') ||\n            (combinedOutput.includes('Expected') && combinedOutput.includes('but found'));\n          \n          // Indicators of runtime errors (code ran but threw - should NOT throw, return result)\n          const isRuntimeError = \n            combinedOutput.includes('throw ') ||\n            combinedOutput.includes('raise ') ||\n            combinedOutput.includes('Traceback (most recent call last)') ||\n            (combinedOutput.includes('Error:') && !combinedOutput.includes('SyntaxError')) ||\n            (combinedOutput.includes('Exception:') && !combinedOutput.includes('SyntaxError'));\n\n          // Throw for syntax errors (unless it looks like a runtime error)\n          if (hasSyntaxError && !isRuntimeError) {\n            throw new Error(`Syntax error: ${(result.stderr || result.stdout || '').trim()}`);\n          }\n\n          // For non-zero exit codes with empty output, this indicates a parse failure\n          // that couldn't produce any output - throw as a syntax error\n          // Note: HopX SDK returns exit_code (snake_case) in ExecutionResult\n          if (result.exit_code !== 0 && !result.stdout && !result.stderr) {\n            throw new Error(`Code execution failed with exit code ${result.exit_code}`);\n          }\n\n          return {\n            output,\n            exitCode: result.exit_code,\n            language: effectiveRuntime\n          };\n        } catch (error) {\n          // Re-throw syntax errors\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `HopX execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Execute a shell command in the sandbox\n       * \n       * Uses sandbox.commands.run() to execute shell commands.\n       * Arguments are properly quoted to handle special characters.\n       */\n      runCommand: async (sandbox: HopxSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          // Build command with options\n          let fullCommand = command;\n          \n          // Handle environment variables\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]) => `${k}=\"${v.replace(/\"/g, '\\\\\"')}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n          \n          // Handle working directory\n          if (options?.cwd) {\n            fullCommand = `cd \"${options.cwd.replace(/\"/g, '\\\\\"')}\" && ${fullCommand}`;\n          }\n          \n          // Handle background execution\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n      \n          // Execute command using sandbox.commands.run()\n          const result = await sandbox.commands.run(fullCommand);\n      \n          return {\n            stdout: result.stdout || '',\n            stderr: result.stderr || '',\n            exitCode: result.exit_code || 0,  // Note: HopX uses snake_case\n            durationMs: Date.now() - startTime\n          };\n        } catch (error) {\n          // Extract result from error if available (some errors include partial results)\n          const result = (error as any)?.result;\n          if (result) {\n            return {\n              stdout: result.stdout || '',\n              stderr: result.stderr || '',\n              exitCode: result.exit_code || 1,\n              durationMs: Date.now() - startTime\n            };\n          }\n          \n          // Fallback for other errors (command not found, etc.)\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       * \n       * Uses sandbox.getInfo() to retrieve sandbox metadata.\n       */\n      getInfo: async (sandbox: HopxSandbox): Promise<SandboxInfo> => {\n        try {\n          const info = await sandbox.getInfo();\n\n          return {\n            id: sandbox.sandboxId,\n            provider: 'hopx',\n            runtime: 'python', // HopX default runtime\n            status: (info.status as 'running' | 'stopped' | 'error') || 'running',\n            createdAt: info.createdAt ? new Date(info.createdAt) : new Date(),\n            timeout: info.timeoutSeconds ? info.timeoutSeconds * 1000 : 300000,\n            metadata: {\n              templateName: info.templateName,\n              templateId: info.templateId,\n              region: info.region,\n              publicHost: info.publicHost,\n            }\n          };\n        } catch (error) {\n          // Return basic info if getInfo fails\n          return {\n            id: sandbox.sandboxId,\n            provider: 'hopx',\n            runtime: 'python',\n            status: 'running',\n            createdAt: new Date(),\n            timeout: 300000,\n            metadata: {}\n          };\n        }\n      },\n\n      /**\n       * Get preview URL for a specific port\n       * \n       * Uses sandbox.getPreviewUrl() to get the public URL for accessing\n       * services running on a specific port in the sandbox.\n       */\n      getUrl: async (sandbox: HopxSandbox, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          // Use HopX's built-in getPreviewUrl method\n          const url = await sandbox.getPreviewUrl(options.port);\n          return url;\n        } catch (error) {\n          throw new Error(\n            `Failed to get HopX URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Native filesystem operations using HopX's files API\n       * \n       * HopX has full native filesystem support via sandbox.files.*\n       * This is Option A from the documentation (native API, not shell-based).\n       */\n      filesystem: {\n        /**\n         * Read file contents from sandbox\n         */\n        readFile: async (sandbox: HopxSandbox, path: string): Promise<string> => {\n          return await sandbox.files.read(path);\n        },\n\n        /**\n         * Write content to a file in the sandbox\n         */\n        writeFile: async (sandbox: HopxSandbox, path: string, content: string): Promise<void> => {\n          await sandbox.files.write(path, content);\n        },\n\n        /**\n         * Create a directory in the sandbox\n         */\n        mkdir: async (sandbox: HopxSandbox, path: string): Promise<void> => {\n          await sandbox.files.mkdir(path);\n        },\n\n        /**\n         * List directory contents\n         * \n         * Maps HopX's EnhancedFileInfo to ComputeSDK's FileEntry format.\n         */\n        readdir: async (sandbox: HopxSandbox, path: string): Promise<FileEntry[]> => {\n          const entries = await sandbox.files.list(path);\n\n          return entries.map((entry: any) => ({\n            name: entry.name,\n            type: (entry.isDir || entry.isDirectory) ? 'directory' as const : 'file' as const,\n            path: entry.path || `${path}/${entry.name}`.replace(/\\/+/g, '/'),\n            isDirectory: Boolean(entry.isDir || entry.isDirectory || entry.type === 'directory'),\n            size: entry.size || 0,\n            lastModified: entry.modTime ? new Date(entry.modTime) : new Date()\n          }));\n        },\n\n        /**\n         * Check if a file or directory exists\n         */\n        exists: async (sandbox: HopxSandbox, path: string): Promise<boolean> => {\n          return await sandbox.files.exists(path);\n        },\n\n        /**\n         * Remove a file or directory\n         */\n        remove: async (sandbox: HopxSandbox, path: string): Promise<void> => {\n          await sandbox.files.remove(path);\n        }\n      },\n\n      /**\n       * Get the native HopX Sandbox instance for advanced usage\n       * \n       * This allows users to access HopX-specific features not exposed\n       * through the ComputeSDK interface.\n       */\n      getInstance: (sandbox: HopxSandbox): HopxSandbox => {\n        return sandbox;\n      },\n    }\n  }\n});\n\n// Export HopX sandbox type for explicit typing\nexport type { Sandbox as HopxSandbox } from '@hopx-ai/sdk';\n\n"],"mappings":"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","names":["HopxSandbox"]}

package/dist/index.mjs

@@ -0,0 +1,334 @@
+// src/index.ts
+import { Sandbox as HopxSandbox } from "@hopx-ai/sdk";
+import { defineProvider } from "@computesdk/provider";
+var hopx = defineProvider({
+  name: "hopx",
+  methods: {
+    sandbox: {
+      /**
+       * Create a new HopX sandbox
+       * 
+       * Uses Sandbox.create() from @hopx-ai/sdk to provision a new sandbox.
+       * Default template is 'code-interpreter' if not specified.
+       */
+      create: async (config, options) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          throw new Error(
+            `Missing HopX API key. Provide 'apiKey' in config or set HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`
+          );
+        }
+        const timeoutSeconds = config.timeout ? Math.ceil(config.timeout / 1e3) : void 0;
+        try {
+          let sandbox;
+          let sandboxId;
+          if (options?.sandboxId) {
+            sandbox = await HopxSandbox.connect(options.sandboxId, apiKey, config.baseURL);
+            sandboxId = options.sandboxId;
+          } else {
+            const createOptions = {
+              apiKey,
+              baseURL: config.baseURL,
+              timeoutSeconds
+            };
+            if (options?.templateId) {
+              createOptions.templateId = options.templateId;
+            } else {
+              createOptions.template = config.template || "code-interpreter";
+            }
+            if (options?.envs) {
+              createOptions.envVars = options.envs;
+            }
+            sandbox = await HopxSandbox.create(createOptions);
+            sandboxId = sandbox.sandboxId;
+          }
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          if (error instanceof Error) {
+            if (error.message.includes("unauthorized") || error.message.includes("API key") || error.message.includes("401")) {
+              throw new Error(
+                `HopX authentication failed. Please check your HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`
+              );
+            }
+            if (error.message.includes("quota") || error.message.includes("limit")) {
+              throw new Error(
+                `HopX quota exceeded. Please check your usage at https://hopx.ai/dashboard`
+              );
+            }
+          }
+          throw new Error(
+            `Failed to create HopX sandbox: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Connect to an existing HopX sandbox by ID
+       * 
+       * Uses Sandbox.connect() to reconnect to a running sandbox.
+       * Returns null if sandbox doesn't exist or can't be accessed.
+       */
+      getById: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return null;
+        }
+        try {
+          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);
+          return {
+            sandbox,
+            sandboxId
+          };
+        } catch (error) {
+          return null;
+        }
+      },
+      /**
+       * List all active HopX sandboxes
+       * 
+       * Uses Sandbox.list() to get all sandboxes for the account.
+       */
+      list: async (config) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return [];
+        }
+        try {
+          const sandboxes = await HopxSandbox.list({
+            apiKey,
+            baseURL: config.baseURL
+          });
+          return sandboxes.map((sandbox) => ({
+            sandbox,
+            sandboxId: sandbox.sandboxId
+          }));
+        } catch (error) {
+          return [];
+        }
+      },
+      /**
+       * Destroy a HopX sandbox
+       * 
+       * Uses sandbox.kill() to terminate and clean up the sandbox.
+       */
+      destroy: async (config, sandboxId) => {
+        const apiKey = config.apiKey || typeof process !== "undefined" && process.env?.HOPX_API_KEY || "";
+        if (!apiKey) {
+          return;
+        }
+        try {
+          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);
+          await sandbox.kill();
+        } catch (error) {
+        }
+      },
+      /**
+       * Execute code in the sandbox
+       * 
+       * Uses sandbox.runCode() with auto-detected runtime.
+       * Maps ComputeSDK runtime ('node'/'python') to HopX language ('javascript'/'python').
+       */
+      runCode: async (sandbox, code, runtime) => {
+        try {
+          const effectiveRuntime = runtime || // Strong Python indicators
+          (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") || code.includes("raise ") ? "python" : "node");
+          const language = effectiveRuntime === "node" ? "javascript" : "python";
+          const result = await sandbox.runCode(code, { language });
+          const output = result.stderr ? `${result.stdout}${result.stdout && result.stderr ? "\n" : ""}${result.stderr}` : result.stdout;
+          const combinedOutput = `${result.stdout || ""} ${result.stderr || ""}`;
+          const hasSyntaxError = (
+            // Python syntax errors
+            combinedOutput.includes("SyntaxError") || combinedOutput.includes("invalid syntax") || combinedOutput.includes("IndentationError") || combinedOutput.includes("TabError") || combinedOutput.includes("NameError") && combinedOutput.includes("is not defined") || // JavaScript/Node.js syntax errors
+            combinedOutput.includes("Unexpected token") || combinedOutput.includes("Unexpected identifier") || // Bun parser errors (JavaScript in HopX runs via Bun)
+            combinedOutput.includes("Unexpected end of file") || combinedOutput.includes("Expected") && combinedOutput.includes("but found")
+          );
+          const isRuntimeError = combinedOutput.includes("throw ") || combinedOutput.includes("raise ") || combinedOutput.includes("Traceback (most recent call last)") || combinedOutput.includes("Error:") && !combinedOutput.includes("SyntaxError") || combinedOutput.includes("Exception:") && !combinedOutput.includes("SyntaxError");
+          if (hasSyntaxError && !isRuntimeError) {
+            throw new Error(`Syntax error: ${(result.stderr || result.stdout || "").trim()}`);
+          }
+          if (result.exit_code !== 0 && !result.stdout && !result.stderr) {
+            throw new Error(`Code execution failed with exit code ${result.exit_code}`);
+          }
+          return {
+            output,
+            exitCode: result.exit_code,
+            language: effectiveRuntime
+          };
+        } catch (error) {
+          if (error instanceof Error && error.message.includes("Syntax error")) {
+            throw error;
+          }
+          throw new Error(
+            `HopX execution failed: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Execute a shell command in the sandbox
+       * 
+       * Uses sandbox.commands.run() to execute shell commands.
+       * Arguments are properly quoted to handle special characters.
+       */
+      runCommand: async (sandbox, command, options) => {
+        const startTime = Date.now();
+        try {
+          let fullCommand = command;
+          if (options?.env && Object.keys(options.env).length > 0) {
+            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${v.replace(/"/g, '\\"')}"`).join(" ");
+            fullCommand = `${envPrefix} ${fullCommand}`;
+          }
+          if (options?.cwd) {
+            fullCommand = `cd "${options.cwd.replace(/"/g, '\\"')}" && ${fullCommand}`;
+          }
+          if (options?.background) {
+            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;
+          }
+          const result = await sandbox.commands.run(fullCommand);
+          return {
+            stdout: result.stdout || "",
+            stderr: result.stderr || "",
+            exitCode: result.exit_code || 0,
+            // Note: HopX uses snake_case
+            durationMs: Date.now() - startTime
+          };
+        } catch (error) {
+          const result = error?.result;
+          if (result) {
+            return {
+              stdout: result.stdout || "",
+              stderr: result.stderr || "",
+              exitCode: result.exit_code || 1,
+              durationMs: Date.now() - startTime
+            };
+          }
+          return {
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            exitCode: 127,
+            durationMs: Date.now() - startTime
+          };
+        }
+      },
+      /**
+       * Get sandbox information
+       * 
+       * Uses sandbox.getInfo() to retrieve sandbox metadata.
+       */
+      getInfo: async (sandbox) => {
+        try {
+          const info = await sandbox.getInfo();
+          return {
+            id: sandbox.sandboxId,
+            provider: "hopx",
+            runtime: "python",
+            // HopX default runtime
+            status: info.status || "running",
+            createdAt: info.createdAt ? new Date(info.createdAt) : /* @__PURE__ */ new Date(),
+            timeout: info.timeoutSeconds ? info.timeoutSeconds * 1e3 : 3e5,
+            metadata: {
+              templateName: info.templateName,
+              templateId: info.templateId,
+              region: info.region,
+              publicHost: info.publicHost
+            }
+          };
+        } catch (error) {
+          return {
+            id: sandbox.sandboxId,
+            provider: "hopx",
+            runtime: "python",
+            status: "running",
+            createdAt: /* @__PURE__ */ new Date(),
+            timeout: 3e5,
+            metadata: {}
+          };
+        }
+      },
+      /**
+       * Get preview URL for a specific port
+       * 
+       * Uses sandbox.getPreviewUrl() to get the public URL for accessing
+       * services running on a specific port in the sandbox.
+       */
+      getUrl: async (sandbox, options) => {
+        try {
+          const url = await sandbox.getPreviewUrl(options.port);
+          return url;
+        } catch (error) {
+          throw new Error(
+            `Failed to get HopX URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`
+          );
+        }
+      },
+      /**
+       * Native filesystem operations using HopX's files API
+       * 
+       * HopX has full native filesystem support via sandbox.files.*
+       * This is Option A from the documentation (native API, not shell-based).
+       */
+      filesystem: {
+        /**
+         * Read file contents from sandbox
+         */
+        readFile: async (sandbox, path) => {
+          return await sandbox.files.read(path);
+        },
+        /**
+         * Write content to a file in the sandbox
+         */
+        writeFile: async (sandbox, path, content) => {
+          await sandbox.files.write(path, content);
+        },
+        /**
+         * Create a directory in the sandbox
+         */
+        mkdir: async (sandbox, path) => {
+          await sandbox.files.mkdir(path);
+        },
+        /**
+         * List directory contents
+         * 
+         * Maps HopX's EnhancedFileInfo to ComputeSDK's FileEntry format.
+         */
+        readdir: async (sandbox, path) => {
+          const entries = await sandbox.files.list(path);
+          return entries.map((entry) => ({
+            name: entry.name,
+            type: entry.isDir || entry.isDirectory ? "directory" : "file",
+            path: entry.path || `${path}/${entry.name}`.replace(/\/+/g, "/"),
+            isDirectory: Boolean(entry.isDir || entry.isDirectory || entry.type === "directory"),
+            size: entry.size || 0,
+            lastModified: entry.modTime ? new Date(entry.modTime) : /* @__PURE__ */ new Date()
+          }));
+        },
+        /**
+         * Check if a file or directory exists
+         */
+        exists: async (sandbox, path) => {
+          return await sandbox.files.exists(path);
+        },
+        /**
+         * Remove a file or directory
+         */
+        remove: async (sandbox, path) => {
+          await sandbox.files.remove(path);
+        }
+      },
+      /**
+       * Get the native HopX Sandbox instance for advanced usage
+       * 
+       * This allows users to access HopX-specific features not exposed
+       * through the ComputeSDK interface.
+       */
+      getInstance: (sandbox) => {
+        return sandbox;
+      }
+    }
+  }
+});
+export {
+  hopx
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * HopX Provider - Factory-based Implementation\n * \n * Full-featured provider with native filesystem support using the factory pattern.\n * HopX provides isolated cloud sandboxes (lightweight VMs) with full Linux environments.\n * \n * Features:\n * - Native filesystem API via sandbox.files.*\n * - Code execution in Python, JavaScript, Bash\n * - Shell command execution\n * - Preview URLs for accessing sandbox services\n */\n\nimport { Sandbox as HopxSandbox } from '@hopx-ai/sdk';\nimport { defineProvider } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions\n} from 'computesdk';\n\n/**\n * HopX-specific configuration options\n */\nexport interface HopxConfig {\n  /** HopX API key - if not provided, will fallback to HOPX_API_KEY environment variable */\n  apiKey?: string;\n  /** Default runtime environment */\n  runtime?: Runtime;\n  /** Execution timeout in milliseconds */\n  timeout?: number;\n  /** Template name for sandbox creation (e.g., 'code-interpreter') */\n  template?: string;\n  /** Base API URL for custom/staging environments */\n  baseURL?: string;\n}\n\n/**\n * Create a HopX provider instance using the factory pattern\n * \n * HopX provides isolated cloud sandboxes with:\n * - Full root access to the VM\n * - Pre-installed language runtimes (Python, Node.js, etc.)\n * - Persistent filesystem during session\n * - Automatic cleanup after timeout\n */\nexport const hopx = defineProvider<HopxSandbox, HopxConfig>({\n  name: 'hopx',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new HopX sandbox\n       * \n       * Uses Sandbox.create() from @hopx-ai/sdk to provision a new sandbox.\n       * Default template is 'code-interpreter' if not specified.\n       */\n      create: async (config: HopxConfig, options?: CreateSandboxOptions) => {\n        // Validate API key - fail fast with helpful error message\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          throw new Error(\n            `Missing HopX API key. Provide 'apiKey' in config or set HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`\n          );\n        }\n\n        // Convert timeout from milliseconds to seconds (HopX uses seconds)\n        const timeoutSeconds = config.timeout ? Math.ceil(config.timeout / 1000) : undefined;\n\n        try {\n          let sandbox: HopxSandbox;\n          let sandboxId: string;\n\n          if (options?.sandboxId) {\n            // Reconnect to existing HopX sandbox using Sandbox.connect()\n            sandbox = await HopxSandbox.connect(options.sandboxId, apiKey, config.baseURL);\n            sandboxId = options.sandboxId;\n          } else {\n            // Create new HopX sandbox using Sandbox.create()\n            // Use templateId if provided, otherwise use template name or default to 'code-interpreter'\n            const createOptions: any = {\n              apiKey,\n              baseURL: config.baseURL,\n              timeoutSeconds,\n            };\n\n            // Handle template specification (templateId takes precedence)\n            if (options?.templateId) {\n              createOptions.templateId = options.templateId;\n            } else {\n              createOptions.template = config.template || 'code-interpreter';\n            }\n\n            // Pass environment variables if provided\n            if (options?.envs) {\n              createOptions.envVars = options.envs;\n            }\n\n            sandbox = await HopxSandbox.create(createOptions);\n            sandboxId = sandbox.sandboxId;\n          }\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Provide helpful error messages for common issues\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('API key') || error.message.includes('401')) {\n              throw new Error(\n                `HopX authentication failed. Please check your HOPX_API_KEY environment variable. Get your API key from https://hopx.ai/dashboard`\n              );\n            }\n            if (error.message.includes('quota') || error.message.includes('limit')) {\n              throw new Error(\n                `HopX quota exceeded. Please check your usage at https://hopx.ai/dashboard`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create HopX sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing HopX sandbox by ID\n       * \n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       * Returns null if sandbox doesn't exist or can't be accessed.\n       */\n      getById: async (config: HopxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return null;\n        }\n\n        try {\n          // Connect to existing sandbox using Sandbox.connect()\n          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);\n\n          return {\n            sandbox,\n            sandboxId\n          };\n        } catch (error) {\n          // Sandbox doesn't exist or can't be accessed\n          return null;\n        }\n      },\n\n      /**\n       * List all active HopX sandboxes\n       * \n       * Uses Sandbox.list() to get all sandboxes for the account.\n       */\n      list: async (config: HopxConfig) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return [];\n        }\n\n        try {\n          // List sandboxes using Sandbox.list()\n          const sandboxes = await HopxSandbox.list({\n            apiKey,\n            baseURL: config.baseURL,\n          });\n\n          return sandboxes.map((sandbox: HopxSandbox) => ({\n            sandbox,\n            sandboxId: sandbox.sandboxId\n          }));\n        } catch (error) {\n          // Return empty array if listing fails\n          return [];\n        }\n      },\n\n      /**\n       * Destroy a HopX sandbox\n       * \n       * Uses sandbox.kill() to terminate and clean up the sandbox.\n       */\n      destroy: async (config: HopxConfig, sandboxId: string) => {\n        const apiKey = config.apiKey || (typeof process !== 'undefined' && process.env?.HOPX_API_KEY) || '';\n\n        if (!apiKey) {\n          return;\n        }\n\n        try {\n          // Connect to sandbox and kill it\n          const sandbox = await HopxSandbox.connect(sandboxId, apiKey, config.baseURL);\n          await sandbox.kill();\n        } catch (error) {\n          // Sandbox might already be destroyed or doesn't exist\n          // This is acceptable for destroy operations\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       * \n       * Uses sandbox.runCode() with auto-detected runtime.\n       * Maps ComputeSDK runtime ('node'/'python') to HopX language ('javascript'/'python').\n       */\n      runCode: async (sandbox: HopxSandbox, code: string, runtime?: Runtime): Promise<CodeResult> => {\n        try {\n          // Auto-detect runtime if not specified using Python indicators\n          const effectiveRuntime = runtime || (\n            // Strong Python indicators\n            code.includes('print(') ||\n            code.includes('import ') ||\n            code.includes('def ') ||\n            code.includes('sys.') ||\n            code.includes('json.') ||\n            code.includes('__') ||\n            code.includes('f\"') ||\n            code.includes(\"f'\") ||\n            code.includes('raise ')\n              ? 'python'\n              // Default to Node.js for all other cases (including ambiguous)\n              : 'node'\n          );\n\n          // Map ComputeSDK runtime to HopX language\n          // HopX uses 'javascript' instead of 'node'\n          const language = effectiveRuntime === 'node' ? 'javascript' : 'python';\n\n          // Execute code using sandbox.runCode()\n          const result = await sandbox.runCode(code, { language });\n\n          // Combine stdout and stderr for output (following E2B pattern)\n          const output = result.stderr\n            ? `${result.stdout}${result.stdout && result.stderr ? '\\n' : ''}${result.stderr}`\n            : result.stdout;\n\n          // Check for syntax/parse errors in stderr or output and throw them\n          // This ensures invalid code triggers an exception as expected by the test suite\n          // \n          // IMPORTANT: We distinguish between:\n          // - Syntax errors (invalid code that couldn't parse) → should THROW\n          // - Runtime errors (valid code that threw during execution) → should RETURN with non-zero exit\n          const combinedOutput = `${result.stdout || ''} ${result.stderr || ''}`;\n          \n          // Indicators of syntax/parse errors (code couldn't be executed)\n          // Covers Python, Node.js, and Bun error formats\n          const hasSyntaxError = \n            // Python syntax errors\n            combinedOutput.includes('SyntaxError') ||\n            combinedOutput.includes('invalid syntax') ||\n            combinedOutput.includes('IndentationError') ||\n            combinedOutput.includes('TabError') ||\n            (combinedOutput.includes('NameError') && combinedOutput.includes('is not defined')) ||\n            // JavaScript/Node.js syntax errors\n            combinedOutput.includes('Unexpected token') ||\n            combinedOutput.includes('Unexpected identifier') ||\n            // Bun parser errors (JavaScript in HopX runs via Bun)\n            combinedOutput.includes('Unexpected end of file') ||\n            (combinedOutput.includes('Expected') && combinedOutput.includes('but found'));\n          \n          // Indicators of runtime errors (code ran but threw - should NOT throw, return result)\n          const isRuntimeError = \n            combinedOutput.includes('throw ') ||\n            combinedOutput.includes('raise ') ||\n            combinedOutput.includes('Traceback (most recent call last)') ||\n            (combinedOutput.includes('Error:') && !combinedOutput.includes('SyntaxError')) ||\n            (combinedOutput.includes('Exception:') && !combinedOutput.includes('SyntaxError'));\n\n          // Throw for syntax errors (unless it looks like a runtime error)\n          if (hasSyntaxError && !isRuntimeError) {\n            throw new Error(`Syntax error: ${(result.stderr || result.stdout || '').trim()}`);\n          }\n\n          // For non-zero exit codes with empty output, this indicates a parse failure\n          // that couldn't produce any output - throw as a syntax error\n          // Note: HopX SDK returns exit_code (snake_case) in ExecutionResult\n          if (result.exit_code !== 0 && !result.stdout && !result.stderr) {\n            throw new Error(`Code execution failed with exit code ${result.exit_code}`);\n          }\n\n          return {\n            output,\n            exitCode: result.exit_code,\n            language: effectiveRuntime\n          };\n        } catch (error) {\n          // Re-throw syntax errors\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `HopX execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Execute a shell command in the sandbox\n       * \n       * Uses sandbox.commands.run() to execute shell commands.\n       * Arguments are properly quoted to handle special characters.\n       */\n      runCommand: async (sandbox: HopxSandbox, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          // Build command with options\n          let fullCommand = command;\n          \n          // Handle environment variables\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]) => `${k}=\"${v.replace(/\"/g, '\\\\\"')}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n          \n          // Handle working directory\n          if (options?.cwd) {\n            fullCommand = `cd \"${options.cwd.replace(/\"/g, '\\\\\"')}\" && ${fullCommand}`;\n          }\n          \n          // Handle background execution\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n      \n          // Execute command using sandbox.commands.run()\n          const result = await sandbox.commands.run(fullCommand);\n      \n          return {\n            stdout: result.stdout || '',\n            stderr: result.stderr || '',\n            exitCode: result.exit_code || 0,  // Note: HopX uses snake_case\n            durationMs: Date.now() - startTime\n          };\n        } catch (error) {\n          // Extract result from error if available (some errors include partial results)\n          const result = (error as any)?.result;\n          if (result) {\n            return {\n              stdout: result.stdout || '',\n              stderr: result.stderr || '',\n              exitCode: result.exit_code || 1,\n              durationMs: Date.now() - startTime\n            };\n          }\n          \n          // Fallback for other errors (command not found, etc.)\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       * \n       * Uses sandbox.getInfo() to retrieve sandbox metadata.\n       */\n      getInfo: async (sandbox: HopxSandbox): Promise<SandboxInfo> => {\n        try {\n          const info = await sandbox.getInfo();\n\n          return {\n            id: sandbox.sandboxId,\n            provider: 'hopx',\n            runtime: 'python', // HopX default runtime\n            status: (info.status as 'running' | 'stopped' | 'error') || 'running',\n            createdAt: info.createdAt ? new Date(info.createdAt) : new Date(),\n            timeout: info.timeoutSeconds ? info.timeoutSeconds * 1000 : 300000,\n            metadata: {\n              templateName: info.templateName,\n              templateId: info.templateId,\n              region: info.region,\n              publicHost: info.publicHost,\n            }\n          };\n        } catch (error) {\n          // Return basic info if getInfo fails\n          return {\n            id: sandbox.sandboxId,\n            provider: 'hopx',\n            runtime: 'python',\n            status: 'running',\n            createdAt: new Date(),\n            timeout: 300000,\n            metadata: {}\n          };\n        }\n      },\n\n      /**\n       * Get preview URL for a specific port\n       * \n       * Uses sandbox.getPreviewUrl() to get the public URL for accessing\n       * services running on a specific port in the sandbox.\n       */\n      getUrl: async (sandbox: HopxSandbox, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          // Use HopX's built-in getPreviewUrl method\n          const url = await sandbox.getPreviewUrl(options.port);\n          return url;\n        } catch (error) {\n          throw new Error(\n            `Failed to get HopX URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Native filesystem operations using HopX's files API\n       * \n       * HopX has full native filesystem support via sandbox.files.*\n       * This is Option A from the documentation (native API, not shell-based).\n       */\n      filesystem: {\n        /**\n         * Read file contents from sandbox\n         */\n        readFile: async (sandbox: HopxSandbox, path: string): Promise<string> => {\n          return await sandbox.files.read(path);\n        },\n\n        /**\n         * Write content to a file in the sandbox\n         */\n        writeFile: async (sandbox: HopxSandbox, path: string, content: string): Promise<void> => {\n          await sandbox.files.write(path, content);\n        },\n\n        /**\n         * Create a directory in the sandbox\n         */\n        mkdir: async (sandbox: HopxSandbox, path: string): Promise<void> => {\n          await sandbox.files.mkdir(path);\n        },\n\n        /**\n         * List directory contents\n         * \n         * Maps HopX's EnhancedFileInfo to ComputeSDK's FileEntry format.\n         */\n        readdir: async (sandbox: HopxSandbox, path: string): Promise<FileEntry[]> => {\n          const entries = await sandbox.files.list(path);\n\n          return entries.map((entry: any) => ({\n            name: entry.name,\n            type: (entry.isDir || entry.isDirectory) ? 'directory' as const : 'file' as const,\n            path: entry.path || `${path}/${entry.name}`.replace(/\\/+/g, '/'),\n            isDirectory: Boolean(entry.isDir || entry.isDirectory || entry.type === 'directory'),\n            size: entry.size || 0,\n            lastModified: entry.modTime ? new Date(entry.modTime) : new Date()\n          }));\n        },\n\n        /**\n         * Check if a file or directory exists\n         */\n        exists: async (sandbox: HopxSandbox, path: string): Promise<boolean> => {\n          return await sandbox.files.exists(path);\n        },\n\n        /**\n         * Remove a file or directory\n         */\n        remove: async (sandbox: HopxSandbox, path: string): Promise<void> => {\n          await sandbox.files.remove(path);\n        }\n      },\n\n      /**\n       * Get the native HopX Sandbox instance for advanced usage\n       * \n       * This allows users to access HopX-specific features not exposed\n       * through the ComputeSDK interface.\n       */\n      getInstance: (sandbox: HopxSandbox): HopxSandbox => {\n        return sandbox;\n      },\n    }\n  }\n});\n\n// Export HopX sandbox type for explicit typing\nexport type { Sandbox as HopxSandbox } from '@hopx-ai/sdk';\n\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@computesdk/hopx",
+  "version": "0.1.0",
+  "description": "HopX provider for ComputeSDK - cloud sandboxes with full Linux environments, filesystem access, and microVM isolation",
+  "author": "ComputeSDK",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@hopx-ai/sdk": "^0.3.8",
+    "@computesdk/provider": "1.0.18",
+    "computesdk": "1.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^1.0.0",
+    "eslint": "^8.37.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@computesdk/test-utils": "1.5.1"
+  },
+  "keywords": [
+    "computesdk",
+    "hopx",
+    "sandbox",
+    "code-execution",
+    "python",
+    "javascript",
+    "cloud",
+    "compute",
+    "provider",
+    "containers"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/computesdk/computesdk.git",
+    "directory": "packages/hopx"
+  },
+  "homepage": "https://www.computesdk.com",
+  "bugs": {
+    "url": "https://github.com/computesdk/computesdk/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint"
+  }
+}