@upcrawl/sdk 1.3.0 → 1.3.1

package/README.md

@@ -148,6 +148,41 @@ const result = await Upcrawl.generatePdfFromUrl({
 console.log(result.url); // Download URL for the PDF
 ```
 
+### Execute Code
+
+Run code in an isolated sandbox environment:
+
+```typescript
+const result = await Upcrawl.executeCode({
+  code: 'print("Hello, World!")',
+  language: 'python'
+});
+
+console.log(result.stdout);          // "Hello, World!\n"
+console.log(result.exitCode);        // 0
+console.log(result.executionTimeMs); // 95.23
+console.log(result.memoryUsageMb);   // 8.45
+```
+
+Each execution runs in its own isolated subprocess inside a Kata micro-VM with no network access. Code is cleaned up immediately after execution.
+
+```typescript
+// Multi-line code with imports
+const result = await Upcrawl.executeCode({
+  code: `
+import json
+data = {"name": "Upcrawl", "version": 1}
+print(json.dumps(data, indent=2))
+  `
+});
+
+console.log(result.stdout);
+// {
+//   "name": "Upcrawl",
+//   "version": 1
+// }
+```
+
 ### Domain Filtering
 
 Filter search results by domain:
@@ -249,7 +284,9 @@ import Upcrawl, {
   BatchScrapeOptions,
   BatchScrapeResponse,
   GeneratePdfOptions,
-  PdfResponse
+  PdfResponse,
+  ExecuteCodeOptions,
+  ExecuteCodeResponse
 } from '@upcrawl/sdk';
 
 const options: ScrapeOptions = {
@@ -275,6 +312,7 @@ const result: ScrapeResponse = await Upcrawl.scrape(options);
 | `Upcrawl.search(options)` | Search the web |
 | `Upcrawl.generatePdf(options)` | Generate PDF from HTML |
 | `Upcrawl.generatePdfFromUrl(options)` | Generate PDF from a URL |
+| `Upcrawl.executeCode(options)` | Execute code in an isolated sandbox |
 
 ### Scrape Options
 
@@ -323,6 +361,25 @@ const result: ScrapeResponse = await Upcrawl.scrape(options);
 | `printBackground` | `boolean` | Print background graphics |
 | `timeoutMs` | `number` | Timeout (5000-120000) |
 
+### Execute Code Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `code` | `string` | Code to execute (required) |
+| `language` | `'python'` | Language runtime (default: python) |
+
+### Execute Code Response
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `stdout` | `string` | Standard output |
+| `stderr` | `string` | Standard error |
+| `exitCode` | `number` | Exit code (0 = success, 124 = timeout) |
+| `executionTimeMs` | `number` | Execution time in milliseconds |
+| `timedOut` | `boolean` | Whether execution timed out |
+| `memoryUsageMb` | `number` | Peak memory usage in MB |
+| `cost` | `number` | Cost in USD |
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upcrawl/sdk",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "publishConfig": {
     "access": "public"
   },