@magpiecloud/mags 1.8.2 → 1.8.4

package/bin/mags.js

@@ -207,7 +207,11 @@ ${colors.bold}Commands:${colors.reset}
   logs <name|id>                  Get job logs
   list                            List recent jobs
   url <name|id> [port]            Enable URL access for a job
+  url alias <sub> <workspace>    Create a stable URL alias for a workspace
+  url alias list                 List your URL aliases
+  url alias remove <subdomain>   Delete a URL alias
   stop <name|id>                  Stop a running job
+  resize <workspace> --disk <GB>  Resize a workspace's disk (restarts VM)
   sync <workspace|id>             Sync workspace to S3 (without stopping)
   workspace list                  List persistent workspaces
   workspace delete <id>           Delete a workspace and its S3 data
@@ -259,6 +263,10 @@ ${colors.bold}Examples:${colors.reset}
   mags status myvm
   mags logs myvm
   mags url myvm 8080
+  mags url alias my-api myvm          # Stable URL: my-api.apps.magpiecloud.com
+  mags url alias my-api myvm --lfg    # Stable URL: my-api.app.lfg.run
+  mags url alias list                 # List all aliases
+  mags url alias remove my-api        # Remove alias
   mags setup-claude                 # Install Claude Code skill
 `);
   process.exit(1);
@@ -667,6 +675,98 @@ async function enableUrlAccess(nameOrId, port = 8080) {
   }
 }
 
+async function urlAliasCommand(args) {
+  if (args.length === 0) {
+    log('red', 'Error: URL alias subcommand required');
+    console.log('\nUsage:');
+    console.log('  mags url alias <subdomain> <workspace> [--lfg]');
+    console.log('  mags url alias list');
+    console.log('  mags url alias remove <subdomain>');
+    process.exit(1);
+  }
+
+  const subcommand = args[0];
+
+  switch (subcommand) {
+    case 'list':
+    case 'ls':
+      await urlAliasList();
+      break;
+    case 'remove':
+    case 'rm':
+    case 'delete':
+      if (!args[1]) {
+        log('red', 'Error: Subdomain required');
+        console.log('\nUsage: mags url alias remove <subdomain>');
+        process.exit(1);
+      }
+      await urlAliasRemove(args[1]);
+      break;
+    default:
+      // mags url alias <subdomain> <workspace> [--lfg]
+      const subdomain = args[0];
+      const workspace = args[1];
+      if (!workspace) {
+        log('red', 'Error: Workspace required');
+        console.log('\nUsage: mags url alias <subdomain> <workspace> [--lfg]');
+        process.exit(1);
+      }
+      const useLfg = args.includes('--lfg');
+      await urlAliasCreate(subdomain, workspace, useLfg);
+      break;
+  }
+}
+
+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', {
+    subdomain,
+    workspace_id: workspaceId,
+    domain,
+  });
+
+  if (resp.error) {
+    log('red', `Error: ${resp.error}`);
+    process.exit(1);
+  }
+
+  if (resp.url) {
+    log('green', `URL alias created: ${resp.url}`);
+  } else {
+    log('green', `URL alias created: https://${subdomain}.${domain}`);
+  }
+}
+
+async function urlAliasList() {
+  const resp = await request('GET', '/api/v1/mags-url-aliases');
+  const aliases = resp.aliases || [];
+
+  if (aliases.length > 0) {
+    log('cyan', 'URL Aliases:\n');
+    aliases.forEach(a => {
+      console.log(`  ${colors.bold}${a.subdomain}${colors.reset}`);
+      console.log(`    URL: ${colors.green}${a.url}${colors.reset}`);
+      console.log(`    Workspace: ${a.workspace_id}  Domain: ${a.domain}`);
+      console.log('');
+    });
+    log('gray', `Total: ${aliases.length} alias(es)`);
+  } else {
+    log('yellow', 'No URL aliases found');
+  }
+}
+
+async function urlAliasRemove(subdomain) {
+  log('blue', `Removing URL alias '${subdomain}'...`);
+  const resp = await request('DELETE', `/api/v1/mags-url-aliases/${subdomain}`);
+  if (resp.error) {
+    log('red', `Error: ${resp.error}`);
+    process.exit(1);
+  }
+  log('green', resp.message || `URL alias '${subdomain}' removed`);
+}
+
 async function getStatus(nameOrId) {
   if (!nameOrId) {
     log('red', 'Error: Job name or ID required');
@@ -730,6 +830,61 @@ async function stopJob(nameOrId) {
   }
 }
 
+async function resizeVM(args) {
+  let name = null;
+  let diskGB = 0;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--disk' && args[i + 1]) {
+      diskGB = parseInt(args[++i]) || 0;
+    } else if (!name) {
+      name = args[i];
+    }
+  }
+
+  if (!name || !diskGB) {
+    log('red', 'Error: Workspace name and --disk <GB> required');
+    console.log('\nUsage: mags resize <workspace> --disk <GB>\n');
+    process.exit(1);
+  }
+
+  // Find existing job for this workspace
+  const existingJob = await findWorkspaceJob(name);
+  if (existingJob) {
+    // 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`);
+    }
+    log('blue', `Stopping existing VM...`);
+    await request('POST', `/api/v1/mags-jobs/${existingJob.request_id}/stop`);
+    // Brief wait for the stop to complete
+    await new Promise(r => setTimeout(r, 1000));
+  }
+
+  // Create new VM with the same workspace name and new disk size
+  log('blue', `Creating new VM with ${diskGB}GB disk...`);
+  const payload = {
+    script: 'sleep infinity',
+    type: 'inline',
+    persistent: true,
+    name: name,
+    workspace_id: name,
+    startup_command: 'sleep infinity',
+    disk_gb: diskGB,
+  };
+
+  const response = await request('POST', '/api/v1/mags-jobs', payload);
+  if (!response.request_id) {
+    log('red', 'Failed to create VM:');
+    console.log(JSON.stringify(response, null, 2));
+    process.exit(1);
+  }
+
+  log('green', `Resized '${name}' to ${diskGB}GB disk`);
+  log('gray', `Job: ${response.request_id}`);
+}
+
 async function syncWorkspace(nameOrId) {
   if (!nameOrId) {
     log('red', 'Error: Workspace name or job ID required');
@@ -1366,7 +1521,7 @@ async function main() {
         break;
       case '--version':
       case '-v':
-        console.log('mags v1.8.2');
+        console.log('mags v1.8.3');
         process.exit(0);
         break;
       case 'new':
@@ -1387,7 +1542,11 @@ async function main() {
         break;
       case 'url':
         await requireAuth();
-        await enableUrlAccess(args[1], parseInt(args[2]) || 8080);
+        if (args[1] === 'alias') {
+          await urlAliasCommand(args.slice(2));
+        } else {
+          await enableUrlAccess(args[1], parseInt(args[2]) || 8080);
+        }
         break;
       case 'status':
         await requireAuth();
@@ -1405,6 +1564,10 @@ async function main() {
         await requireAuth();
         await stopJob(args[1]);
         break;
+      case 'resize':
+        await requireAuth();
+        await resizeVM(args.slice(1));
+        break;
       case 'sync':
         await requireAuth();
         await syncWorkspace(args[1]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magpiecloud/mags",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "Mags CLI - Execute scripts on Magpie's instant VM infrastructure",
   "main": "index.js",
   "bin": {

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magpie-mags"
-version = "1.3.0"
+version = "1.3.1"
 description = "Mags SDK - Execute scripts on Magpie's instant VM infrastructure"
 readme = "README.md"
 license = {text = "MIT"}

package/python/src/mags/client.py

@@ -211,6 +211,30 @@ class Mags:
         request_id = self._resolve_job_id(name_or_id)
         return self._request("POST", f"/mags-jobs/{request_id}/stop")
 
+    def resize(
+        self,
+        workspace: str,
+        disk_gb: int,
+        *,
+        timeout: float = 30.0,
+        poll_interval: float = 1.0,
+    ) -> dict:
+        """Resize a workspace's disk. Stops the existing VM, then creates a new one.
+
+        Workspace files are preserved in S3.
+        Returns ``{"request_id": ..., "status": "running"}``.
+        """
+        existing = self.find_job(workspace)
+        if existing and existing.get("status") == "running":
+            self._request("POST", f"/mags-jobs/{existing['request_id']}/sync")
+            self._request("POST", f"/mags-jobs/{existing['request_id']}/stop")
+            time.sleep(1)
+        elif existing and existing.get("status") == "sleeping":
+            self._request("POST", f"/mags-jobs/{existing['request_id']}/stop")
+            time.sleep(1)
+
+        return self.new(workspace, disk_gb=disk_gb, timeout=timeout, poll_interval=poll_interval)
+
     def new(
         self,
         name: str,
@@ -483,3 +507,36 @@ class Mags:
     def cron_delete(self, cron_id: str) -> dict:
         """Delete a cron job."""
         return self._request("DELETE", f"/mags-cron/{cron_id}")
+
+    # ── URL aliases ──────────────────────────────────────────────────
+
+    def url_alias_create(
+        self,
+        subdomain: str,
+        workspace_id: str,
+        domain: str = "apps.magpiecloud.com",
+    ) -> dict:
+        """Create a stable URL alias for a workspace.
+
+        The alias maps ``subdomain.<domain>`` to the active job in the workspace.
+        Use ``domain="app.lfg.run"`` for the LFG domain.
+
+        Returns ``{"id": ..., "subdomain": ..., "url": ...}``.
+        """
+        return self._request(
+            "POST",
+            "/mags-url-aliases",
+            json={
+                "subdomain": subdomain,
+                "workspace_id": workspace_id,
+                "domain": domain,
+            },
+        )
+
+    def url_alias_list(self) -> dict:
+        """List all URL aliases. Returns ``{"aliases": [...], "total": N}``."""
+        return self._request("GET", "/mags-url-aliases")
+
+    def url_alias_delete(self, subdomain: str) -> dict:
+        """Delete a URL alias by subdomain."""
+        return self._request("DELETE", f"/mags-url-aliases/{subdomain}")