@magpiecloud/mags 1.8.16 → 1.9.0

package/bin/mags.js

@@ -48,6 +48,21 @@ const config = loadConfig();
 const API_URL = process.env.MAGS_API_URL || config.api_url || 'https://api.magpiecloud.com';
 let API_TOKEN = process.env.MAGS_API_TOKEN || config.api_token || '';
 
+// V2 flag: --v2 switches API paths from /api/v1/ to /api/v2/
+let apiVersion = process.env.MAGS_API_VERSION || 'v1';
+{
+  const v2Index = process.argv.indexOf('--v2');
+  if (v2Index !== -1) {
+    apiVersion = 'v2';
+    process.argv.splice(v2Index, 1);
+  }
+}
+
+// Helper to build versioned API paths
+function apiPath(resource) {
+  return `/api/${apiVersion}/${resource}`;
+}
+
 // Colors
 const colors = {
   red: '\x1b[31m',
@@ -147,7 +162,7 @@ async function resolveJobId(nameOrId) {
   }
 
   // Otherwise, search by name/workspace
-  const resp = await request('GET', `/api/v1/mags-jobs?page=1&page_size=50`);
+  const resp = await request('GET', `${apiPath('mags-jobs')}?page=1&page_size=50`);
   if (resp.jobs && resp.jobs.length > 0) {
     // Try exact match on name first (prefer running/sleeping)
     let job = resp.jobs.find(j => j.name === nameOrId && (j.status === 'running' || j.status === 'sleeping'));
@@ -178,7 +193,7 @@ async function resolveJobId(nameOrId) {
 
 // Find a running or sleeping job for a workspace
 async function findWorkspaceJob(workspace) {
-  const resp = await request('GET', `/api/v1/mags-jobs?page=1&page_size=50`);
+  const resp = await request('GET', `${apiPath('mags-jobs')}?page=1&page_size=50`);
   if (resp.jobs && resp.jobs.length > 0) {
     // Prefer running, then sleeping
     let job = resp.jobs.find(j => j.workspace_id === workspace && j.status === 'running');
@@ -230,6 +245,7 @@ ${colors.bold}Run Options:${colors.reset}
   --url                           Enable public URL access (requires -p)
   --port <port>                   Port to expose for URL (default: 8080)
   --startup-command <cmd>         Command to run when VM wakes from sleep
+  -t, --type <type>               VM rootfs type: standard, claude, pi
 
 ${colors.bold}Cron Commands:${colors.reset}
   cron add [options] <script>     Create a scheduled cron job
@@ -310,7 +326,7 @@ To authenticate, you need an API token from Magpie.
   log('blue', 'Verifying token...');
 
   try {
-    const resp = await request('GET', '/api/v1/mags-jobs?page=1&page_size=1');
+    const resp = await request('GET', `${apiPath('mags-jobs')}?page=1&page_size=1`);
 
     if (resp.error === 'unauthorized' || resp.error === 'Unauthorized') {
       log('red', 'Invalid token. Please check and try again.');
@@ -364,7 +380,7 @@ async function whoami() {
   log('blue', 'Checking authentication...');
 
   try {
-    const resp = await request('GET', '/api/v1/mags-jobs?page=1&page_size=1');
+    const resp = await request('GET', `${apiPath('mags-jobs')}?page=1&page_size=1`);
 
     if (resp.error === 'unauthorized' || resp.error === 'Unauthorized') {
       log('red', 'Token is invalid or expired.');
@@ -409,6 +425,7 @@ async function newVM(args) {
   let baseWorkspace = null;
   let diskGB = 0;
   let persistent = false;
+  let rootfsType = '';
 
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '-p' || args[i] === '--persistent') {
@@ -417,6 +434,8 @@ async function newVM(args) {
       baseWorkspace = args[++i];
     } else if (args[i] === '--disk' && args[i + 1]) {
       diskGB = parseInt(args[++i]) || 0;
+    } else if ((args[i] === '--type' || args[i] === '-t') && args[i + 1]) {
+      rootfsType = args[++i];
     } else if (!name) {
       name = args[i];
     }
@@ -424,14 +443,15 @@ async function newVM(args) {
 
   if (!name) {
     log('red', 'Error: Name required');
-    console.log(`\nUsage: mags new <name> [-p] [--base <workspace>] [--disk <GB>]`);
-    console.log(`  -p, --persistent  Enable S3 data persistence\n`);
+    console.log(`\nUsage: mags new <name> [-p] [--base <workspace>] [--disk <GB>] [--type <type>]`);
+    console.log(`  -p, --persistent  Enable S3 data persistence`);
+    console.log(`  -t, --type        VM type: standard (default), claude, pi\n`);
     process.exit(1);
   }
 
   // Check if a VM with this name already exists (running or sleeping)
   try {
-    const jobs = await request('GET', '/api/v1/mags-jobs');
+    const jobs = await request('GET', apiPath('mags-jobs'));
     const existing = (jobs.jobs || []).find(j =>
       j.name === name && (j.status === 'running' || j.status === 'sleeping')
     );
@@ -452,13 +472,13 @@ async function newVM(args) {
     persistent: true,
     name: name,
     workspace_id: name,
-    startup_command: 'sleep infinity',
-    no_sync: !persistent
+    startup_command: 'sleep infinity'
   };
   if (baseWorkspace) payload.base_workspace_id = baseWorkspace;
   if (diskGB) payload.disk_gb = diskGB;
+  if (rootfsType) payload.rootfs_type = rootfsType;
 
-  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  const response = await request('POST', apiPath('mags-jobs'), payload);
 
   if (!response.request_id) {
     log('red', 'Failed to create VM:');
@@ -471,7 +491,7 @@ async function newVM(args) {
   let attempt = 0;
 
   while (attempt < maxAttempts) {
-    const status = await request('GET', `/api/v1/mags-jobs/${response.request_id}/status`);
+    const status = await request('GET', `${apiPath('mags-jobs')}/${response.request_id}/status`);
 
     if (status.status === 'running') {
       log('green', `VM '${name}' created successfully${persistent ? ' (persistent)' : ' (local disk)'}`);
@@ -506,6 +526,7 @@ async function runJob(args) {
   let startupCommand = '';
   let diskGB = 0;
   let fileArgs = [];
+  let rootfsType = '';
 
   // Parse flags
   for (let i = 0; i < args.length; i++) {
@@ -546,6 +567,10 @@ async function runJob(args) {
       case '--startup-command':
         startupCommand = args[++i];
         break;
+      case '--type':
+      case '-t':
+        rootfsType = args[++i];
+        break;
       default:
         script = args.slice(i).join(' ');
         i = args.length;
@@ -608,8 +633,9 @@ async function runJob(args) {
   if (startupCommand) payload.startup_command = startupCommand;
   if (fileIds.length > 0) payload.file_ids = fileIds;
   if (diskGB) payload.disk_gb = diskGB;
+  if (rootfsType) payload.rootfs_type = rootfsType;
 
-  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  const response = await request('POST', apiPath('mags-jobs'), payload);
 
   if (!response.request_id) {
     log('red', 'Failed to submit job:');
@@ -628,7 +654,7 @@ async function runJob(args) {
   let attempt = 0;
 
   while (attempt < maxAttempts) {
-    const status = await request('GET', `/api/v1/mags-jobs/${requestId}/status`);
+    const status = await request('GET', `${apiPath('mags-jobs')}/${requestId}/status`);
 
     if (status.status === 'completed') {
       log('green', `Completed in ${status.script_duration_ms}ms`);
@@ -646,7 +672,7 @@ async function runJob(args) {
 
       if (enableUrl && status.subdomain) {
         log('blue', `Enabling URL access on port ${port}...`);
-        const accessResp = await request('POST', `/api/v1/mags-jobs/${requestId}/access`, { port });
+        const accessResp = await request('POST', `${apiPath('mags-jobs')}/${requestId}/access`, { port });
         if (accessResp.success) {
           log('green', `URL: https://${status.subdomain}.apps.magpiecloud.com`);
         } else {
@@ -669,7 +695,7 @@ async function runJob(args) {
 
   // Get logs
   log('cyan', 'Output:');
-  const logsResp = await request('GET', `/api/v1/mags-jobs/${requestId}/logs`);
+  const logsResp = await request('GET', `${apiPath('mags-jobs')}/${requestId}/logs`);
   if (logsResp.logs) {
     logsResp.logs
       .filter(l => l.source === 'stdout' || l.source === 'stderr')
@@ -686,10 +712,10 @@ async function enableUrlAccess(nameOrId, port = 8080) {
   const requestId = await resolveJobId(nameOrId);
   log('blue', `Enabling URL access on port ${port}...`);
 
-  const accessResp = await request('POST', `/api/v1/mags-jobs/${requestId}/access`, { port });
+  const accessResp = await request('POST', `${apiPath('mags-jobs')}/${requestId}/access`, { port });
 
   if (accessResp.success) {
-    const status = await request('GET', `/api/v1/mags-jobs/${requestId}/status`);
+    const status = await request('GET', `${apiPath('mags-jobs')}/${requestId}/status`);
     if (status.subdomain) {
       log('green', `URL enabled: https://${status.subdomain}.apps.magpiecloud.com`);
     } else {
@@ -748,7 +774,7 @@ async function urlAliasCreate(subdomain, workspaceId, useLfg) {
   const domain = useLfg ? 'app.lfg.run' : 'apps.magpiecloud.com';
   log('blue', `Creating URL alias: ${subdomain}.${domain} → workspace '${workspaceId}'...`);
 
-  const resp = await request('POST', '/api/v1/mags-url-aliases', {
+  const resp = await request('POST', apiPath('mags-url-aliases'), {
     subdomain,
     workspace_id: workspaceId,
     domain,
@@ -767,7 +793,7 @@ async function urlAliasCreate(subdomain, workspaceId, useLfg) {
 }
 
 async function urlAliasList() {
-  const resp = await request('GET', '/api/v1/mags-url-aliases');
+  const resp = await request('GET', apiPath('mags-url-aliases'));
   const aliases = resp.aliases || [];
 
   if (aliases.length > 0) {
@@ -786,7 +812,7 @@ async function urlAliasList() {
 
 async function urlAliasRemove(subdomain) {
   log('blue', `Removing URL alias '${subdomain}'...`);
-  const resp = await request('DELETE', `/api/v1/mags-url-aliases/${subdomain}`);
+  const resp = await request('DELETE', `${apiPath('mags-url-aliases')}/${subdomain}`);
   if (resp.error) {
     log('red', `Error: ${resp.error}`);
     process.exit(1);
@@ -800,7 +826,7 @@ async function getStatus(nameOrId) {
     usage();
   }
   const requestId = await resolveJobId(nameOrId);
-  const status = await request('GET', `/api/v1/mags-jobs/${requestId}/status`);
+  const status = await request('GET', `${apiPath('mags-jobs')}/${requestId}/status`);
   console.log(JSON.stringify(status, null, 2));
 }
 
@@ -810,7 +836,7 @@ async function getLogs(nameOrId) {
     usage();
   }
   const requestId = await resolveJobId(nameOrId);
-  const logsResp = await request('GET', `/api/v1/mags-jobs/${requestId}/logs`);
+  const logsResp = await request('GET', `${apiPath('mags-jobs')}/${requestId}/logs`);
   if (logsResp.logs) {
     logsResp.logs.forEach(l => {
       const levelColor = l.level === 'error' ? 'red' : l.level === 'warn' ? 'yellow' : 'gray';
@@ -820,7 +846,7 @@ async function getLogs(nameOrId) {
 }
 
 async function listJobs() {
-  const resp = await request('GET', '/api/v1/mags-jobs?page=1&page_size=10');
+  const resp = await request('GET', `${apiPath('mags-jobs')}?page=1&page_size=10`);
   if (resp.jobs && resp.jobs.length > 0) {
     log('cyan', 'Recent Jobs:\n');
     resp.jobs.forEach(job => {
@@ -848,7 +874,7 @@ async function stopJob(nameOrId) {
   }
   const requestId = await resolveJobId(nameOrId);
   log('blue', `Stopping job ${requestId}...`);
-  const resp = await request('POST', `/api/v1/mags-jobs/${requestId}/stop`);
+  const resp = await request('POST', `${apiPath('mags-jobs')}/${requestId}/stop`);
   if (resp.success) {
     log('green', 'Job stopped');
   } else {
@@ -890,7 +916,7 @@ async function setJobSettings(args) {
 
   const requestId = await resolveJobId(nameOrId);
   log('blue', `Updating settings for ${requestId}...`);
-  const resp = await request('PATCH', `/api/v1/mags-jobs/${requestId}`, payload);
+  const resp = await request('PATCH', `${apiPath('mags-jobs')}/${requestId}`, payload);
   if (resp.success) {
     if (noSleep === true) log('green', 'VM set to never auto-sleep');
     if (noSleep === false) log('green', 'VM set to auto-sleep when idle');
@@ -923,10 +949,10 @@ async function resizeVM(args) {
     // Sync workspace before stopping (preserve files)
     if (existingJob.status === 'running') {
       log('blue', 'Syncing workspace before resize...');
-      await request('POST', `/api/v1/mags-jobs/${existingJob.request_id}/sync`);
+      await request('POST', `${apiPath('mags-jobs')}/${existingJob.request_id}/sync`);
     }
     log('blue', `Stopping existing VM...`);
-    await request('POST', `/api/v1/mags-jobs/${existingJob.request_id}/stop`);
+    await request('POST', `${apiPath('mags-jobs')}/${existingJob.request_id}/stop`);
     // Brief wait for the stop to complete
     await new Promise(r => setTimeout(r, 1000));
   }
@@ -943,7 +969,7 @@ async function resizeVM(args) {
     disk_gb: diskGB,
   };
 
-  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  const response = await request('POST', apiPath('mags-jobs'), payload);
   if (!response.request_id) {
     log('red', 'Failed to create VM:');
     console.log(JSON.stringify(response, null, 2));
@@ -978,7 +1004,7 @@ async function syncWorkspace(nameOrId) {
   }
 
   log('blue', `Syncing workspace...`);
-  const resp = await request('POST', `/api/v1/mags-jobs/${requestId}/sync`);
+  const resp = await request('POST', `${apiPath('mags-jobs')}/${requestId}/sync`);
   if (resp.success) {
     log('green', 'Workspace synced to S3 successfully');
   } else {
@@ -1098,7 +1124,7 @@ async function uploadFile(filePath) {
   const body = Buffer.concat([header, fileData, footer]);
 
   return new Promise((resolve, reject) => {
-    const url = new URL('/api/v1/mags-files', API_URL);
+    const url = new URL(apiPath('mags-files'), API_URL);
     const isHttps = url.protocol === 'https:';
     const lib = isHttps ? https : http;
 
@@ -1235,7 +1261,7 @@ async function cronAdd(args) {
   };
   if (workspace) payload.workspace_id = workspace;
 
-  const resp = await request('POST', '/api/v1/mags-cron', payload);
+  const resp = await request('POST', apiPath('mags-cron'), payload);
   if (resp.id) {
     log('green', `Cron job created: ${resp.id}`);
     log('blue', `Name: ${cronName}`);
@@ -1249,7 +1275,7 @@ async function cronAdd(args) {
 }
 
 async function cronList() {
-  const resp = await request('GET', '/api/v1/mags-cron');
+  const resp = await request('GET', apiPath('mags-cron'));
   if (resp.cron_jobs && resp.cron_jobs.length > 0) {
     log('cyan', 'Cron Jobs:\n');
     resp.cron_jobs.forEach(cron => {
@@ -1271,7 +1297,7 @@ async function cronList() {
 }
 
 async function cronRemove(id) {
-  const resp = await request('DELETE', `/api/v1/mags-cron/${id}`);
+  const resp = await request('DELETE', `${apiPath('mags-cron')}/${id}`);
   if (resp.success) {
     log('green', 'Cron job deleted');
   } else {
@@ -1281,7 +1307,7 @@ async function cronRemove(id) {
 }
 
 async function cronToggle(id, enabled) {
-  const resp = await request('PATCH', `/api/v1/mags-cron/${id}`, { enabled });
+  const resp = await request('PATCH', `${apiPath('mags-cron')}/${id}`, { enabled });
   if (resp.id) {
     log('green', `Cron job ${enabled ? 'enabled' : 'disabled'}`);
     if (resp.next_run_at) log('blue', `Next run: ${resp.next_run_at}`);
@@ -1328,7 +1354,7 @@ async function workspaceCommand(args) {
 }
 
 async function workspaceList() {
-  const resp = await request('GET', '/api/v1/mags-workspaces');
+  const resp = await request('GET', apiPath('mags-workspaces'));
   if (resp.workspaces && resp.workspaces.length > 0) {
     log('cyan', 'Workspaces:\n');
     resp.workspaces.forEach(ws => {
@@ -1346,7 +1372,7 @@ async function workspaceList() {
 
 async function workspaceDelete(workspaceId) {
   log('blue', `Deleting workspace '${workspaceId}'...`);
-  const resp = await request('DELETE', `/api/v1/mags-workspaces/${workspaceId}`);
+  const resp = await request('DELETE', `${apiPath('mags-workspaces')}/${workspaceId}`);
   if (resp.success) {
     log('green', resp.message || `Workspace '${workspaceId}' deleted`);
   } else {
@@ -1377,7 +1403,7 @@ async function browserSession(args) {
 
     if (existingJob && existingJob.status === 'running') {
       // Check if it's already a browser session
-      const status = await request('GET', `/api/v1/mags-jobs/${existingJob.request_id}/status`);
+      const status = await request('GET', `${apiPath('mags-jobs')}/${existingJob.request_id}/status`);
       if (status.browser_mode && status.debug_ws_url) {
         log('green', 'Found existing browser session');
         console.log('');
@@ -1405,7 +1431,7 @@ async function browserSession(args) {
   if (name) payload.name = name;
   if (!name && workspace) payload.name = `browser-${workspace}`;
 
-  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  const response = await request('POST', apiPath('mags-jobs'), payload);
 
   if (!response.request_id) {
     log('red', 'Failed to start browser session:');
@@ -1420,7 +1446,7 @@ async function browserSession(args) {
   log('blue', 'Waiting for Chromium to start...');
   let status;
   for (let i = 0; i < 90; i++) {
-    status = await request('GET', `/api/v1/mags-jobs/${requestId}/status`);
+    status = await request('GET', `${apiPath('mags-jobs')}/${requestId}/status`);
     if (status.status === 'running' && status.debug_ws_url) {
       break;
     }
@@ -1469,7 +1495,7 @@ async function browserSession(args) {
 // WebSocket tunnel proxy — pipes stdin/stdout through a WebSocket to the agent SSH proxy.
 // Used as SSH ProxyCommand: ssh -o ProxyCommand="mags proxy <jobID>" root@mags-vm
 async function proxyTunnel(jobID) {
-  const url = new URL(`/api/v1/mags-jobs/${jobID}/tunnel`, API_URL);
+  const url = new URL(`${apiPath('mags-jobs')}/${jobID}/tunnel`, API_URL);
   const wsUrl = url.toString().replace(/^http/, 'ws');
 
   // Dynamic import for WebSocket
@@ -1508,6 +1534,11 @@ async function proxyTunnel(jobID) {
 
   ws.on('open', () => {
     // Don't flush yet — wait for first message (SSH key)
+    // Send pings every 30s to keep the connection alive through proxies/CDNs
+    const pingInterval = setInterval(() => {
+      if (ws.readyState === WebSocket.OPEN) ws.ping();
+    }, 30000);
+    ws.on('close', () => clearInterval(pingInterval));
   });
 
   ws.on('message', (data, isBinary) => {
@@ -1547,7 +1578,7 @@ async function proxyTunnel(jobID) {
 // Fetch SSH key from tunnel endpoint (quick WS handshake)
 async function fetchTunnelKey(jobID) {
   const WebSocket = require('ws');
-  const url = new URL(`/api/v1/mags-jobs/${jobID}/tunnel`, API_URL);
+  const url = new URL(`${apiPath('mags-jobs')}/${jobID}/tunnel`, API_URL);
   const wsUrl = url.toString().replace(/^http/, 'ws');
 
   return new Promise((resolve, reject) => {
@@ -1607,7 +1638,7 @@ async function resolveOrCreateJob(nameOrId) {
     startup_command: 'sleep 3600'
   };
 
-  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  const response = await request('POST', apiPath('mags-jobs'), payload);
   if (!response.request_id) {
     log('red', 'Failed to start VM:');
     console.log(JSON.stringify(response, null, 2));
@@ -1619,7 +1650,7 @@ async function resolveOrCreateJob(nameOrId) {
 
   log('blue', 'Waiting for VM...');
   for (let i = 0; i < 60; i++) {
-    const status = await request('GET', `/api/v1/mags-jobs/${jobID}/status`);
+    const status = await request('GET', `${apiPath('mags-jobs')}/${jobID}/status`);
     if (status.status === 'running' && status.vm_id) break;
     if (status.status === 'error') {
       log('red', 'VM failed to start');
@@ -1634,7 +1665,7 @@ async function resolveOrCreateJob(nameOrId) {
 
 // Get SSH key for a job (calls EnableAccess to set up agent proxy and get key)
 async function getSSHKey(jobID) {
-  const accessResp = await request('POST', `/api/v1/mags-jobs/${jobID}/access`, { port: 22 });
+  const accessResp = await request('POST', `${apiPath('mags-jobs')}/${jobID}/access`, { port: 22 });
   if (!accessResp.success) {
     log('red', 'Failed to enable SSH access');
     if (accessResp.error) log('red', accessResp.error);
@@ -1672,6 +1703,8 @@ async function sshToJob(nameOrId) {
     '-o', 'StrictHostKeyChecking=no',
     '-o', 'UserKnownHostsFile=/dev/null',
     '-o', 'LogLevel=ERROR',
+    '-o', 'ServerAliveInterval=15',
+    '-o', 'ServerAliveCountMax=4',
     '-o', `ProxyCommand=${magsPath} proxy ${jobID}`,
     '-i', keyFile,
     'root@mags-vm',
@@ -1739,6 +1772,8 @@ async function execOnJob(nameOrId, command) {
     '-o', 'StrictHostKeyChecking=no',
     '-o', 'UserKnownHostsFile=/dev/null',
     '-o', 'LogLevel=ERROR',
+    '-o', 'ServerAliveInterval=15',
+    '-o', 'ServerAliveCountMax=4',
     '-o', `ProxyCommand=${magsPath} proxy ${jobID}`,
     '-i', keyFile,
   ];

package/deploy-page.sh

@@ -0,0 +1,171 @@
+#!/bin/bash
+# Deploy an HTML page to a public Mags URL
+# Usage: ./deploy-page.sh <html-file-or-content> [name]
+
+set -e
+
+MAGS_API_URL="${MAGS_API_URL:-https://api.magpiecloud.com}"
+MAGS_API_TOKEN="${MAGS_API_TOKEN:-}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Load .env if exists
+if [ -f ".env" ]; then
+    export $(grep -v '^#' .env | xargs)
+fi
+
+if [ -z "$MAGS_API_TOKEN" ]; then
+    echo -e "${RED}Error: MAGS_API_TOKEN not set${NC}"
+    echo "Set it via: export MAGS_API_TOKEN=your-token"
+    exit 1
+fi
+
+usage() {
+    echo -e "${CYAN}Deploy HTML Page to Mags${NC}"
+    echo ""
+    echo "Usage: $0 <html-file-or-content> [name]"
+    echo ""
+    echo "Arguments:"
+    echo "  html-file-or-content  Path to HTML file, or HTML content directly"
+    echo "  name                  Optional name for the deployment (default: page)"
+    echo ""
+    echo "Examples:"
+    echo "  $0 index.html"
+    echo "  $0 index.html my-site"
+    echo "  $0 '<h1>Hello World</h1>'"
+    echo ""
+    echo "Environment:"
+    echo "  MAGS_API_TOKEN   Your API token (required)"
+    echo "  MAGS_API_URL     API URL (default: https://api.magpiecloud.com)"
+    exit 1
+}
+
+[ -z "$1" ] && usage
+
+INPUT="$1"
+NAME="${2:-page}"
+
+# Check if input is a file or raw HTML
+if [ -f "$INPUT" ]; then
+    echo -e "${BLUE}Reading HTML from file: $INPUT${NC}"
+    HTML_CONTENT=$(cat "$INPUT")
+else
+    echo -e "${BLUE}Using provided HTML content${NC}"
+    HTML_CONTENT="$INPUT"
+fi
+
+# Escape the HTML for JSON
+HTML_ESCAPED=$(echo "$HTML_CONTENT" | jq -Rs .)
+
+# Create the script that will serve the HTML
+SCRIPT=$(cat << 'SCRIPT_EOF'
+#!/bin/sh
+# Create the HTML file
+cat > /tmp/index.html << 'HTML_CONTENT_MARKER'
+__HTML_PLACEHOLDER__
+HTML_CONTENT_MARKER
+
+# Start Python HTTP server on port 8080
+cd /tmp
+echo "Server running on port 8080"
+python3 -m http.server 8080
+SCRIPT_EOF
+)
+
+# Replace placeholder with actual HTML
+SCRIPT=$(echo "$SCRIPT" | sed "s|__HTML_PLACEHOLDER__|$(echo "$HTML_CONTENT" | sed 's/|/\\|/g; s/&/\\&/g')|")
+
+echo -e "${BLUE}Deploying page...${NC}"
+
+# Submit the persistent job
+RESPONSE=$(curl -s -X POST "${MAGS_API_URL}/api/v1/mags-jobs" \
+    -H "Authorization: Bearer $MAGS_API_TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "$(jq -n --arg script "$SCRIPT" --arg name "$NAME" '{
+        script: $script,
+        type: "inline",
+        name: $name,
+        persistent: true
+    }')")
+
+REQUEST_ID=$(echo "$RESPONSE" | jq -r '.request_id // empty')
+
+if [ -z "$REQUEST_ID" ]; then
+    echo -e "${RED}Failed to deploy:${NC}"
+    echo "$RESPONSE" | jq .
+    exit 1
+fi
+
+echo -e "${GREEN}Deployment started: $REQUEST_ID${NC}"
+
+# Wait for job to be running
+echo -e "${BLUE}Waiting for VM to start...${NC}"
+MAX_ATTEMPTS=30
+ATTEMPT=0
+
+while [ $ATTEMPT -lt $MAX_ATTEMPTS ]; do
+    STATUS_RESP=$(curl -s -X GET "${MAGS_API_URL}/api/v1/mags-jobs/${REQUEST_ID}/status" \
+        -H "Authorization: Bearer $MAGS_API_TOKEN")
+
+    STATUS=$(echo "$STATUS_RESP" | jq -r '.status // "unknown"')
+    SUBDOMAIN=$(echo "$STATUS_RESP" | jq -r '.subdomain // empty')
+
+    if [ "$STATUS" = "error" ]; then
+        echo -e "${RED}Deployment failed!${NC}"
+        echo "$STATUS_RESP" | jq .
+        exit 1
+    fi
+
+    if [ "$STATUS" = "running" ]; then
+        echo -e " ${GREEN}VM running${NC}"
+        break
+    fi
+
+    printf "."
+    sleep 1
+    ATTEMPT=$((ATTEMPT + 1))
+done
+
+if [ "$STATUS" != "running" ]; then
+    echo -e "${RED}Timed out waiting for VM to start${NC}"
+    exit 1
+fi
+
+# Enable URL access
+echo -e "${BLUE}Enabling URL access...${NC}"
+ACCESS_RESP=$(curl -s -X POST "${MAGS_API_URL}/api/v1/mags-jobs/${REQUEST_ID}/access" \
+    -H "Authorization: Bearer $MAGS_API_TOKEN" \
+    -H "Content-Type: application/json" \
+    -d '{"access_type": "url", "port": 8080}')
+
+URL=$(echo "$ACCESS_RESP" | jq -r '.url // empty')
+SUCCESS=$(echo "$ACCESS_RESP" | jq -r '.success // false')
+
+if [ "$SUCCESS" != "true" ] || [ -z "$URL" ]; then
+    echo -e "${YELLOW}Warning: Could not get URL from access endpoint${NC}"
+    echo "$ACCESS_RESP" | jq .
+    # Fallback: construct URL from subdomain
+    URL="https://${SUBDOMAIN}.apps.magpiecloud.com"
+fi
+
+echo ""
+echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}  Page Deployed Successfully!${NC}"
+echo -e "${GREEN}═══════════════════════════════════════════════════════════${NC}"
+echo ""
+echo -e "  ${CYAN}URL:${NC}        ${GREEN}${URL}${NC}"
+echo -e "  ${CYAN}Subdomain:${NC}  ${SUBDOMAIN}"
+echo -e "  ${CYAN}Request ID:${NC} ${REQUEST_ID}"
+echo ""
+echo -e "${YELLOW}Note: The VM will sleep after idle timeout and wake on next request.${NC}"
+echo ""
+echo "To check status:"
+echo "  curl -s -H 'Authorization: Bearer \$MAGS_API_TOKEN' \\"
+echo "    '${MAGS_API_URL}/api/v1/mags-jobs/${REQUEST_ID}/status' | jq ."
+echo ""

package/index.js

@@ -103,7 +103,6 @@ class Mags {
    * @param {object} options.environment - Environment variables
    * @param {string[]} options.fileIds - File IDs from uploadFiles()
    * @param {number} options.diskGb - Custom disk size in GB (default 2)
-   * @param {string} options.rootfsType - VM rootfs type: standard, claude, pi
    * @returns {Promise<{request_id: string, status: string}>}
    */
   async run(script, options = {}) {
@@ -132,7 +131,6 @@ class Mags {
     if (options.environment) payload.environment = options.environment;
     if (options.fileIds && options.fileIds.length > 0) payload.file_ids = options.fileIds;
     if (options.diskGb) payload.disk_gb = options.diskGb;
-    if (options.rootfsType) payload.rootfs_type = options.rootfsType;
 
     return this._request('POST', '/api/v1/mags-jobs', payload);
   }