mage-remote-run 0.15.0 → 0.16.0

package/README.md

@@ -11,6 +11,8 @@ This tool is in an early stage and not yet stable. Expect breaking changes as th
 - **Connection Management**: Easily switch between multiple Magento instances (SaaS/PaaS).
 - **Interactive Prompts**: User-friendly wizard for configuration and command inputs.
 - **Rich Output**: Formatted tables and structured data display.
+- **Interactive Console (REPL)**: Run CLI commands or JavaScript in a live session.
+- **MCP Server**: Expose commands as MCP tools over stdio or HTTP (SSE).
 - **Comprehensive API Support**:
     - **Stores**: Manage websites, stores, and store views.
     - **Customers**: List, search, show, and delete customers.
@@ -83,6 +85,27 @@ The CLI supports multiple profiles. You can configure them interactively.
   node bin/mage-remote-run.js order show <increment_id>
   ```
 
+### Interactive Console (REPL)
+
+```bash
+node bin/mage-remote-run.js console
+# or
+node bin/mage-remote-run.js repl
+```
+
+Inside the console, you can run commands directly (for example, `website list`) or evaluate JavaScript with top-level `await`.
+
+### MCP Server
+
+Expose the CLI as an MCP server:
+
+```bash
+node bin/mage-remote-run.js mcp --transport stdio
+node bin/mage-remote-run.js mcp --transport http --host 127.0.0.1 --port 18098
+```
+
+Commands are registered as tools (for example, `website list` becomes `website_list`), and tool inputs map to the same CLI arguments and options.
+
 ## Development
 
 ### Testing

package/lib/commands/console.js

@@ -178,6 +178,13 @@ export function registerConsoleCommand(program) {
                         }
 
                         const firstWord = expandedArgs[0];
+                        const blockedCommands = new Set(['console', 'mcp']);
+                        if (blockedCommands.has(firstWord)) {
+                            const blockedLabel = firstWord === 'console' ? 'console/repl' : firstWord;
+                            console.error(chalk.red(`Command "${blockedLabel}" is not available inside the console.`));
+                            callback(null);
+                            return;
+                        }
                         const knownCommands = localProgram.commands.map(c => c.name());
 
                         if (knownCommands.includes(firstWord)) {

package/lib/commands/customers.js

@@ -73,6 +73,39 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+    //-------------------------------------------------------
+    // "customer create" Command
+    //-------------------------------------------------------
+    customers.command('create')
+        .description('Create a new customer')
+        .addHelpText('after', `
+Examples:
+  $ mage-remote-run customer create
+`)
+        .action(async () => {
+            try {
+                const client = await createClient();
+                const answers = await inquirer.prompt([
+                    { name: 'firstname', message: 'First Name:' },
+                    { name: 'lastname', message: 'Last Name:' },
+                    { name: 'email', message: 'Email:' },
+                    { name: 'password', message: 'Password:', type: 'password' }
+                ]);
+
+                const payload = {
+                    customer: {
+                        email: answers.email,
+                        firstname: answers.firstname,
+                        lastname: answers.lastname
+                    },
+                    password: answers.password
+                };
+
+                const data = await client.post('V1/customers', payload);
+                console.log(chalk.green(`✅ Customer created with ID: ${data.id}`));
+            } catch (e) { handleError(e); }
+        });
+
 
     //-------------------------------------------------------
     // "customer edit" Command
@@ -241,12 +274,8 @@ Examples:
                     websiteId = answers.websiteId;
                 }
 
-                if (!customerId && !options.redirectUrl) {
-                    const { redirectUrl } = await inquirer.prompt([
-                        { name: 'redirectUrl', message: 'Redirect URL (optional):' }
-                    ]);
-                    options.redirectUrl = redirectUrl;
-                }
+                // Redirect URL is optional and only used if provided via flag
+                // User requested to remove usage of interactive prompt for it.
 
                 const payload = {
                     email: email,

package/lib/commands/orders.js

@@ -105,6 +105,57 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+    //-------------------------------------------------------
+    // "order cancel" Command
+    //-------------------------------------------------------
+    orders.command('cancel <id>')
+        .description('Cancel an order')
+        .addHelpText('after', `
+Examples:
+  $ mage-remote-run order cancel 123
+`)
+        .action(async (id) => {
+            try {
+                const client = await createClient();
+                await client.post(`V1/orders/${id}/cancel`);
+                console.log(chalk.green(`Order ${id} cancelled.`));
+            } catch (e) { handleError(e); }
+        });
+
+    //-------------------------------------------------------
+    // "order hold" Command
+    //-------------------------------------------------------
+    orders.command('hold <id>')
+        .description('Hold an order')
+        .addHelpText('after', `
+Examples:
+  $ mage-remote-run order hold 123
+`)
+        .action(async (id) => {
+            try {
+                const client = await createClient();
+                await client.post(`V1/orders/${id}/hold`);
+                console.log(chalk.green(`Order ${id} put on hold.`));
+            } catch (e) { handleError(e); }
+        });
+
+    //-------------------------------------------------------
+    // "order unhold" Command
+    //-------------------------------------------------------
+    orders.command('unhold <id>')
+        .description('Unhold an order')
+        .addHelpText('after', `
+Examples:
+  $ mage-remote-run order unhold 123
+`)
+        .action(async (id) => {
+            try {
+                const client = await createClient();
+                await client.post(`V1/orders/${id}/unhold`);
+                console.log(chalk.green(`Order ${id} released from hold.`));
+            } catch (e) { handleError(e); }
+        });
+
     //-------------------------------------------------------
     // "order show" Command
     //-------------------------------------------------------

package/lib/commands/products.js

@@ -171,6 +171,32 @@ Examples:
             } catch (e) { handleError(e); }
         });
 
+    const media = products.command('media').description('Manage product media');
+
+    //-------------------------------------------------------
+    // "product media list" Command
+    //-------------------------------------------------------
+    media.command('list <sku>')
+        .description('List media for a product')
+        .addHelpText('after', `
+Examples:
+  $ mage-remote-run product media list SKU123
+`)
+        .action(async (sku) => {
+            try {
+                const client = await createClient();
+                const data = await client.get(`V1/products/${encodeURIComponent(sku)}/media`);
+
+                if (!data || data.length === 0) {
+                    console.log('No media found.');
+                    return;
+                }
+
+                const rows = data.map(m => [m.id, m.media_type, m.file, m.label || '', m.position, m.disabled ? 'Yes' : 'No']);
+                printTable(['ID', 'Type', 'File', 'Label', 'Pos', 'Disabled'], rows);
+            } catch (e) { handleError(e); }
+        });
+
     const types = products.command('type').description('Manage product types');
 
 

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "mage-remote-run",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "The remote swiss army knife for Magento Open Source, Mage-OS, Adobe Commerce",
   "main": "index.js",
   "scripts": {
     "test": "NODE_OPTIONS=\"--experimental-vm-modules --localstorage-file=./.localstorage\" jest",
     "start": "node bin/mage-remote-run.js",
+    "dev:api-discover": "node scripts/parse_swagger.cjs",
     "release": "release-it"
   },
   "keywords": [],