@magpiecloud/mags 1.8.3 → 1.8.4

package/bin/mags.js

@@ -207,6 +207,9 @@ ${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)
@@ -260,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);
@@ -668,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');
@@ -1443,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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magpiecloud/mags",
-  "version": "1.8.3",
+  "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

@@ -507,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}")