npm - @magpiecloud/mags - Versions diffs - 1.8.13 → 1.8.15 - Mend

@magpiecloud/mags 1.8.13 → 1.8.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

package/README.md +95 -378
package/bin/mags.js +196 -104
package/index.js +6 -52
package/package.json +22 -4
package/API.md +0 -388
package/Mags-API.postman_collection.json +0 -374
package/QUICKSTART.md +0 -295
package/deploy-page.sh +0 -171
package/mags +0 -0
package/mags.sh +0 -270
package/nodejs/README.md +0 -197
package/nodejs/bin/mags.js +0 -1146
package/nodejs/index.js +0 -642
package/nodejs/package.json +0 -42
package/python/INTEGRATION.md +0 -800
package/python/README.md +0 -161
package/python/dist/magpie_mags-1.3.5-py3-none-any.whl +0 -0
package/python/dist/magpie_mags-1.3.5.tar.gz +0 -0
package/python/examples/demo.py +0 -181
package/python/pyproject.toml +0 -39
package/python/src/magpie_mags.egg-info/PKG-INFO +0 -182
package/python/src/magpie_mags.egg-info/SOURCES.txt +0 -9
package/python/src/magpie_mags.egg-info/dependency_links.txt +0 -1
package/python/src/magpie_mags.egg-info/requires.txt +0 -1
package/python/src/magpie_mags.egg-info/top_level.txt +0 -1
package/python/src/mags/__init__.py +0 -6
package/python/src/mags/client.py +0 -573
package/python/test_sdk.py +0 -78
package/skill.md +0 -153
package/website/api.html +0 -1095
package/website/claude-skill.html +0 -481
package/website/cookbook/hn-marketing.html +0 -410
package/website/cookbook/hn-marketing.sh +0 -42
package/website/cookbook.html +0 -282
package/website/env.js +0 -4
package/website/index.html +0 -801
package/website/llms.txt +0 -334
package/website/login.html +0 -108
package/website/mags.md +0 -210
package/website/script.js +0 -453
package/website/styles.css +0 -908
package/website/tokens.html +0 -169
package/website/usage.html +0 -185

package/website/api.html DELETED Viewed

@@ -1,1095 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Mags API Reference</title>
-    <meta
-      name="description"
-      content="Full API reference for the Mags REST API, Python SDK, and Node.js SDK. Submit jobs, manage workspaces, upload files, and enable URL/SSH access."
-    />
-    <meta name="api-base" content="https://api.magpiecloud.com" />
-    <meta name="auth-base" content="https://api.magpiecloud.com" />
-    <link rel="stylesheet" href="styles.css?v=7" />
-    <script src="env.js"></script>
-    <style>
-      .endpoint { margin-bottom: 2.5rem; }
-      .endpoint h3 { margin-bottom: 0.3rem; }
-      .method-url {
-        display: inline-flex;
-        align-items: center;
-        gap: 0.5rem;
-        margin-bottom: 1rem;
-      }
-      .method {
-        display: inline-block;
-        padding: 0.2rem 0.6rem;
-        border-radius: 6px;
-        font-family: var(--mono);
-        font-size: 0.8rem;
-        font-weight: 600;
-        text-transform: uppercase;
-      }
-      .method.post { background: rgba(47, 143, 99, 0.15); color: #237c52; }
-      .method.get { background: rgba(59, 130, 246, 0.15); color: #2563eb; }
-      .method.patch { background: rgba(245, 158, 11, 0.15); color: #b45309; }
-      .method.delete { background: rgba(239, 68, 68, 0.15); color: #dc2626; }
-      .url-path {
-        font-family: var(--mono);
-        font-size: 0.95rem;
-        color: var(--text);
-      }
-      .field-table {
-        width: 100%;
-        border-collapse: collapse;
-        font-size: 0.9rem;
-        margin: 1rem 0;
-      }
-      .field-table th {
-        text-align: left;
-        padding: 0.6rem 0.8rem;
-        background: var(--surface-muted);
-        border: 1px solid var(--border);
-        font-size: 0.78rem;
-        text-transform: uppercase;
-        letter-spacing: 0.06em;
-        color: var(--text-muted);
-      }
-      .field-table td {
-        padding: 0.6rem 0.8rem;
-        border: 1px solid var(--border);
-        vertical-align: top;
-      }
-      .field-table code {
-        font-size: 0.85rem;
-        white-space: nowrap;
-      }
-      .field-table .required {
-        color: #dc2626;
-        font-size: 0.75rem;
-        font-weight: 600;
-      }
-      .response-label {
-        font-size: 0.8rem;
-        font-weight: 600;
-        color: var(--text-muted);
-        text-transform: uppercase;
-        letter-spacing: 0.06em;
-        margin: 1rem 0 0.4rem;
-      }
-      .toc {
-        display: flex;
-        flex-wrap: wrap;
-        gap: 0.5rem;
-        margin-bottom: 1.5rem;
-      }
-      .toc a {
-        display: inline-block;
-        padding: 0.35rem 0.8rem;
-        border-radius: 8px;
-        font-size: 0.85rem;
-        background: var(--surface-muted);
-        border: 1px solid var(--border);
-        transition: background 0.15s;
-      }
-      .toc a:hover {
-        background: rgba(47, 143, 99, 0.1);
-        border-color: rgba(47, 143, 99, 0.3);
-      }
-    </style>
-  </head>
-  <body>
-    <div class="backdrop"></div>
-    <header class="site-header">
-      <div class="container nav">
-        <div class="brand">
-          <span class="logo">Mags</span>
-          <span class="tag">API Reference</span>
-        </div>
-        <nav class="nav-links">
-          <a href="index.html">Home</a>
-          <a href="index.html#quickstart">Docs</a>
-          <a href="cookbook.html">Cookbook</a>
-          <a href="claude-skill.html">Claude Skill</a>
-          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
-          <a href="login.html">Login</a>
-        </nav>
-        <div class="nav-cta">
-          <a class="button ghost" href="tokens.html">Get API token</a>
-        </div>
-      </div>
-    </header>
-    <main>
-      <section class="hero">
-        <div class="container hero-grid">
-          <div class="hero-copy">
-            <span class="pill">REST API + SDKs</span>
-            <h1>Full API reference for Mags.</h1>
-            <p class="lead">
-              Submit jobs, poll for status, stream logs, manage workspaces, upload files, and enable URL or SSH access. Every endpoint includes curl, Python, and Node.js examples.
-            </p>
-            <div class="hero-actions">
-              <a class="button" href="#endpoints">Endpoints</a>
-              <a class="button ghost" href="#workflow">Workflow</a>
-            </div>
-          </div>
-          <div class="hero-card tab-group">
-            <div class="tab-bar">
-              <button class="tab active" data-tab="hero-curl">curl</button>
-              <button class="tab" data-tab="hero-py">Python</button>
-              <button class="tab" data-tab="hero-js">Node.js</button>
-            </div>
-            <div class="tab-content active" data-tab="hero-curl">
-              <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "script": "echo hello world",
-    "type": "inline"
-  }'</code></pre>
-            </div>
-            <div class="tab-content" data-tab="hero-py">
-              <pre><code>from mags import Mags
-m = Mags()
-result = m.run_and_wait("echo hello world")
-print(result["status"])</code></pre>
-            </div>
-            <div class="tab-content" data-tab="hero-js">
-              <pre><code>const Mags = require('@magpiecloud/mags');
-const mags = new Mags();
-const result = await mags.runAndWait('echo hello world');
-console.log(result.status);</code></pre>
-            </div>
-            <p class="card-note">Submit a job and get a request_id back in ~50ms.</p>
-          </div>
-        </div>
-      </section>
-      <!-- Authentication -->
-      <section class="section" id="auth">
-        <div class="container">
-          <div class="section-title">
-            <p>Authentication</p>
-            <h2>All requests require a Bearer token.</h2>
-          </div>
-          <div class="card wide" data-reveal>
-            <h3>Authorization header</h3>
-            <pre><code>Authorization: Bearer &lt;your-api-token&gt;</code></pre>
-            <p>Generate tokens at <a href="tokens.html" class="text-link">mags.run/tokens</a> or via <code>mags login</code>.</p>
-            <div class="code-tabs tab-group">
-              <div class="tab-bar">
-                <button class="tab active" data-tab="auth-py">Python</button>
-                <button class="tab" data-tab="auth-js">Node.js</button>
-                <button class="tab" data-tab="auth-env">Env var</button>
-              </div>
-              <div class="tab-content active" data-tab="auth-py">
-                <pre><code>from mags import Mags
-m = Mags(api_token="your-token")
-# or: export MAGS_API_TOKEN="your-token"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="auth-js">
-                <pre><code>const mags = new Mags({ apiToken: 'your-token' });
-// or: export MAGS_API_TOKEN="your-token"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="auth-env">
-                <pre><code>export MAGS_API_TOKEN="your-token"
-# Works with CLI, Python SDK, and Node.js SDK</code></pre>
-              </div>
-            </div>
-          </div>
-        </div>
-      </section>
-      <!-- Workflow -->
-      <section class="section" id="workflow">
-        <div class="container">
-          <div class="section-title">
-            <p>Workflow</p>
-            <h2>Base image + ephemeral workers.</h2>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>1. Create a base workspace</h3>
-              <p>Install dependencies once and save the workspace. This becomes your reusable base image.</p>
-              <pre><code>POST /api/v1/mags-jobs
-{
-  "script": "apk add python3 py3-pip nodejs npm && pip install requests flask",
-  "type": "inline",
-  "workspace_id": "python-base"
-}</code></pre>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>2. Spawn ephemeral workers</h3>
-              <p>Use the base as a read-only starting point. Workers run in parallel, base is never modified.</p>
-              <pre><code>POST /api/v1/mags-jobs
-{
-  "script": "python3 run.py",
-  "type": "inline",
-  "base_workspace_id": "python-base"
-}</code></pre>
-            </article>
-          </div>
-          <div class="card wide" data-reveal>
-            <h3>Workspace modes</h3>
-            <table class="field-table">
-              <thead>
-                <tr>
-                  <th>workspace_id</th>
-                  <th>base_workspace_id</th>
-                  <th>Behavior</th>
-                </tr>
-              </thead>
-              <tbody>
-                <tr>
-                  <td><em>omit</em></td>
-                  <td><em>omit</em></td>
-                  <td>Fully ephemeral. No S3 sync. Fastest.</td>
-                </tr>
-                <tr>
-                  <td><code>"my-ws"</code></td>
-                  <td><em>omit</em></td>
-                  <td>Local workspace. Data stays on the VM only (not synced to S3). Add <code>persistent: true</code> to sync to S3.</td>
-                </tr>
-                <tr>
-                  <td><em>omit</em></td>
-                  <td><code>"my-base"</code></td>
-                  <td>Base mounted read-only. Changes discarded after run.</td>
-                </tr>
-                <tr>
-                  <td><code>"fork-1"</code></td>
-                  <td><code>"my-base"</code></td>
-                  <td>Fork: starts from base, saves changes to <code>fork-1</code>.</td>
-                </tr>
-              </tbody>
-            </table>
-          </div>
-        </div>
-      </section>
-      <!-- Endpoints -->
-      <section class="section" id="endpoints">
-        <div class="container">
-          <div class="section-title">
-            <p>Endpoints</p>
-            <h2>Base URL: <code>https://api.magpiecloud.com/api/v1</code></h2>
-          </div>
-          <div class="toc">
-            <a href="#submit-job">Submit Job</a>
-            <a href="#get-status">Get Status</a>
-            <a href="#get-logs">Get Logs</a>
-            <a href="#list-jobs">List Jobs</a>
-            <a href="#stop-job">Stop Job</a>
-            <a href="#enable-access">Enable Access</a>
-            <a href="#update-job">Update Job</a>
-            <a href="#sync-workspace">Sync Workspace</a>
-            <a href="#upload-file">Upload File</a>
-            <a href="#list-workspaces">List Workspaces</a>
-            <a href="#delete-workspace">Delete Workspace</a>
-            <a href="#url-aliases">URL Aliases</a>
-            <a href="#cron-endpoints">Cron Jobs</a>
-          </div>
-          <!-- Submit Job -->
-          <div class="endpoint card wide" id="submit-job" data-reveal>
-            <h3>Submit Job</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-jobs</span>
-            </div>
-            <p>Creates a VM, runs a script, and returns. The VM boots in ~300ms from a pool.</p>
-            <p class="response-label">Request body</p>
-            <table class="field-table">
-              <thead>
-                <tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr>
-              </thead>
-              <tbody>
-                <tr>
-                  <td><code>script</code></td>
-                  <td>string</td>
-                  <td><span class="required">YES</span></td>
-                  <td>Shell script to execute inside the VM.</td>
-                </tr>
-                <tr>
-                  <td><code>type</code></td>
-                  <td>string</td>
-                  <td><span class="required">YES</span></td>
-                  <td>Always <code>"inline"</code>.</td>
-                </tr>
-                <tr>
-                  <td><code>workspace_id</code></td>
-                  <td>string</td>
-                  <td>no</td>
-                  <td>Workspace name. With <code>persistent: false</code>, data stays local to the VM only. With <code>persistent: true</code>, filesystem changes are synced to S3 and restored on next run. Omit for ephemeral.</td>
-                </tr>
-                <tr>
-                  <td><code>base_workspace_id</code></td>
-                  <td>string</td>
-                  <td>no</td>
-                  <td>Mount an existing workspace <strong>read-only</strong> as the starting filesystem.</td>
-                </tr>
-                <tr>
-                  <td><code>persistent</code></td>
-                  <td>bool</td>
-                  <td>no</td>
-                  <td>If <code>true</code>, VM stays alive after script finishes and workspace is synced to S3. Required for cloud persistence.</td>
-                </tr>
-                <tr>
-                  <td><code>no_sleep</code></td>
-                  <td>bool</td>
-                  <td>no</td>
-                  <td>If <code>true</code>, VM will never be auto-slept by the idle timeout. Requires <code>persistent: true</code>.</td>
-                </tr>
-                <tr>
-                  <td><code>startup_command</code></td>
-                  <td>string</td>
-                  <td>no</td>
-                  <td>Command to run when a sleeping persistent VM wakes up.</td>
-                </tr>
-                <tr>
-                  <td><code>environment</code></td>
-                  <td>object</td>
-                  <td>no</td>
-                  <td>Key-value env vars injected into the VM.</td>
-                </tr>
-                <tr>
-                  <td><code>file_ids</code></td>
-                  <td>string[]</td>
-                  <td>no</td>
-                  <td>File IDs from the upload endpoint. Files are downloaded into <code>/root/</code> before script runs.</td>
-                </tr>
-                <tr>
-                  <td><code>disk_gb</code></td>
-                  <td>int</td>
-                  <td>no</td>
-                  <td>Custom disk size in GB. Default is 2GB. The rootfs is resized on-the-fly after VM boot.</td>
-                </tr>
-              </tbody>
-            </table>
-            <p class="response-label">Response (202)</p>
-            <pre><code>{
-  "request_id": "eab1e214-39c8-4ecc-b941-75551976e0fa",
-  "status": "accepted",
-  "message": "Mags job submitted successfully"
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="sj-curl">curl</button>
-                <button class="tab" data-tab="sj-py">Python</button>
-                <button class="tab" data-tab="sj-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="sj-curl">
-                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "script": "echo hello",
-    "type": "inline",
-    "workspace_id": "myproject"
-  }'</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sj-py">
-                <pre><code>job = m.run("echo hello", workspace_id="myproject")
-print(job["request_id"])
-# Or run and wait for completion:
-result = m.run_and_wait("echo hello", workspace_id="myproject")
-print(result["status"])  # "completed"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sj-js">
-                <pre><code>const job = await mags.run('echo hello', { workspaceId: 'myproject' });
-console.log(job.requestId);
-// Or run and wait:
-const result = await mags.runAndWait('echo hello', { workspaceId: 'myproject' });
-console.log(result.status); // "completed"</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Get Status -->
-          <div class="endpoint card wide" id="get-status" data-reveal>
-            <h3>Get Job Status</h3>
-            <div class="method-url">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-jobs/:id/status</span>
-            </div>
-            <p>Poll this endpoint to wait for job completion.</p>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{
-  "request_id": "eab1e214-...",
-  "status": "running",
-  "vm_id": "a488ceef",
-  "persistent": true,
-  "subdomain": "28dfed70c32e",
-  "url": "https://28dfed70c32e.apps.magpiecloud.com",
-  "sleeping": false,
-  "exit_code": 0,
-  "script_duration_ms": 1200
-}</code></pre>
-            <p class="response-label">Status values</p>
-            <table class="field-table">
-              <thead>
-                <tr><th>Status</th><th>Description</th></tr>
-              </thead>
-              <tbody>
-                <tr><td><code>pending</code></td><td>Job queued, waiting for VM.</td></tr>
-                <tr><td><code>running</code></td><td>Script is executing.</td></tr>
-                <tr><td><code>completed</code></td><td>Script finished successfully.</td></tr>
-                <tr><td><code>error</code></td><td>Script failed or VM error.</td></tr>
-                <tr><td><code>sleeping</code></td><td>Persistent VM is idle. Auto-wakes on next request.</td></tr>
-              </tbody>
-            </table>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="gs-curl">curl</button>
-                <button class="tab" data-tab="gs-py">Python</button>
-                <button class="tab" data-tab="gs-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="gs-curl">
-                <pre><code>curl https://api.magpiecloud.com/api/v1/mags-jobs/$ID/status \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="gs-py">
-                <pre><code>status = m.status("eab1e214-...")
-print(status["status"])  # "running"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="gs-js">
-                <pre><code>const status = await mags.status('eab1e214-...');
-console.log(status.status); // "running"</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Get Logs -->
-          <div class="endpoint card wide" id="get-logs" data-reveal>
-            <h3>Get Job Logs</h3>
-            <div class="method-url">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-jobs/:id/logs</span>
-            </div>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{
-  "logs": [
-    { "timestamp": "...", "level": "info", "message": "hello world", "source": "stdout" },
-    { "timestamp": "...", "level": "error", "message": "warning: ...", "source": "stderr" }
-  ]
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="gl-curl">curl</button>
-                <button class="tab" data-tab="gl-py">Python</button>
-                <button class="tab" data-tab="gl-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="gl-curl">
-                <pre><code>curl https://api.magpiecloud.com/api/v1/mags-jobs/$ID/logs \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="gl-py">
-                <pre><code>logs = m.logs("eab1e214-...")
-for log in logs["logs"]:
-    print(f"[{log['source']}] {log['message']}")</code></pre>
-              </div>
-              <div class="tab-content" data-tab="gl-js">
-                <pre><code>const logs = await mags.logs('eab1e214-...');
-logs.logs.forEach(l => console.log(`[${l.source}] ${l.message}`));</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- List Jobs -->
-          <div class="endpoint card wide" id="list-jobs" data-reveal>
-            <h3>List Jobs</h3>
-            <div class="method-url">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-jobs?page=1&amp;page_size=20</span>
-            </div>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{
-  "jobs": [{ "request_id": "...", "status": "completed", "workspace_id": "my-project", ... }],
-  "total": 42,
-  "page": 1,
-  "page_size": 20
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="lj-curl">curl</button>
-                <button class="tab" data-tab="lj-py">Python</button>
-                <button class="tab" data-tab="lj-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="lj-curl">
-                <pre><code>curl "https://api.magpiecloud.com/api/v1/mags-jobs?page=1&page_size=10" \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="lj-py">
-                <pre><code>resp = m.list_jobs(page=1, page_size=10)
-for job in resp["jobs"]:
-    print(job["request_id"], job["status"])</code></pre>
-              </div>
-              <div class="tab-content" data-tab="lj-js">
-                <pre><code>const resp = await mags.list({ page: 1, pageSize: 10 });
-resp.jobs.forEach(j => console.log(j.requestId, j.status));</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Stop Job -->
-          <div class="endpoint card wide" id="stop-job" data-reveal>
-            <h3>Stop Job</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-jobs/:id/stop</span>
-            </div>
-            <p>Stop a running or sleeping job. The VM is terminated and the workspace is synced to S3 if persistent.</p>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{ "success": true, "message": "Job stopped" }</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="sj2-curl">curl</button>
-                <button class="tab" data-tab="sj2-py">Python</button>
-                <button class="tab" data-tab="sj2-js">Node.js</button>
-                <button class="tab" data-tab="sj2-cli">CLI</button>
-              </div>
-              <div class="tab-content active" data-tab="sj2-curl">
-                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs/$ID/stop \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sj2-py">
-                <pre><code>m.stop("myproject")  # accepts name, workspace ID, or request ID</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sj2-js">
-                <pre><code>await mags.stop('myproject'); // accepts name, workspace ID, or request ID</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sj2-cli">
-                <pre><code>mags stop myproject</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Enable Access -->
-          <div class="endpoint card wide" id="enable-access" data-reveal>
-            <h3>Enable Access (SSH or HTTP)</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-jobs/:id/access</span>
-            </div>
-            <p>Enables external access to a running VM. Use <code>port: 22</code> for SSH, any other port for HTTP proxy.</p>
-            <p class="response-label">Request body</p>
-            <pre><code>{ "port": 22 }</code></pre>
-            <p class="response-label">Response &mdash; SSH (port 22)</p>
-            <pre><code>{
-  "success": true,
-  "ssh_host": "api.magpiecloud.com",
-  "ssh_port": 40000,
-  "ssh_private_key": "-----BEGIN OPENSSH PRIVATE KEY-----\n...",
-  "access_type": "ssh_proxy"
-}</code></pre>
-            <p class="response-label">Response &mdash; HTTP (other ports)</p>
-            <pre><code>{
-  "success": true,
-  "ipv6_address": "2a01:4f9:...",
-  "port": 8080,
-  "access_type": "http_proxy"
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="ea-curl">curl</button>
-                <button class="tab" data-tab="ea-py">Python</button>
-                <button class="tab" data-tab="ea-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="ea-curl">
-                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-jobs/$ID/access \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{ "port": 22 }'</code></pre>
-              </div>
-              <div class="tab-content" data-tab="ea-py">
-                <pre><code># SSH access
-ssh = m.enable_access(request_id, port=22)
-print(f"ssh root@{ssh['ssh_host']} -p {ssh['ssh_port']}")
-# HTTP access
-access = m.enable_access(request_id, port=8080)
-print(access.get("url"))</code></pre>
-              </div>
-              <div class="tab-content" data-tab="ea-js">
-                <pre><code>// SSH access
-const ssh = await mags.enableAccess(requestId, 22);
-console.log(`ssh root@${ssh.sshHost} -p ${ssh.sshPort}`);
-// HTTP access
-const access = await mags.enableAccess(requestId, 8080);</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Update Job -->
-          <div class="endpoint card wide" id="update-job" data-reveal>
-            <h3>Update Job</h3>
-            <div class="method-url">
-              <span class="method patch">PATCH</span>
-              <span class="url-path">/api/v1/mags-jobs/:id</span>
-            </div>
-            <p>Update a job's settings. All fields are optional &mdash; only include the ones you want to change.</p>
-            <p class="response-label">Request body</p>
-            <div class="ref-table-wrap">
-              <table class="ref-table">
-                <thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead>
-                <tbody>
-                  <tr><td><code>startup_command</code></td><td>string</td><td>Command to run when VM wakes from sleep</td></tr>
-                  <tr><td><code>no_sleep</code></td><td>bool</td><td>If <code>true</code>, VM never auto-sleeps. If <code>false</code>, re-enables auto-sleep. Requires persistent VM.</td></tr>
-                </tbody>
-              </table>
-            </div>
-            <pre><code>{ "no_sleep": true }</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="uj-curl">curl</button>
-                <button class="tab" data-tab="uj-cli">CLI</button>
-                <button class="tab" data-tab="uj-py">Python</button>
-                <button class="tab" data-tab="uj-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="uj-curl">
-                <pre><code># Enable no-sleep
-curl -X PATCH https://api.magpiecloud.com/api/v1/mags-jobs/$ID \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{ "no_sleep": true }'
-# Set startup command
-curl -X PATCH https://api.magpiecloud.com/api/v1/mags-jobs/$ID \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{ "startup_command": "python3 -m http.server 8080" }'</code></pre>
-              </div>
-              <div class="tab-content" data-tab="uj-cli">
-                <pre><code># Enable no-sleep on an existing VM
-mags set myvm --no-sleep
-# Re-enable auto-sleep
-mags set myvm --sleep</code></pre>
-              </div>
-              <div class="tab-content" data-tab="uj-py">
-                <pre><code># Enable no-sleep
-m.update_job(request_id, no_sleep=True)
-# Set startup command
-m.update_job(request_id, startup_command="python3 -m http.server 8080")</code></pre>
-              </div>
-              <div class="tab-content" data-tab="uj-js">
-                <pre><code>await mags.updateJob(requestId, { noSleep: true });</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Upload File -->
-          <div class="endpoint card wide" id="upload-file" data-reveal>
-            <h3>Upload File</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-files</span>
-            </div>
-            <p>Upload a file (max 100MB) that can be attached to jobs via <code>file_ids</code>.</p>
-            <p class="response-label">Request</p>
-            <pre><code>Content-Type: multipart/form-data
-Field name: file</code></pre>
-            <p class="response-label">Response (201)</p>
-            <pre><code>{
-  "file_id": "a1b2c3d4-...",
-  "file_name": "script.py",
-  "size": 4096
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="uf-curl">curl</button>
-                <button class="tab" data-tab="uf-py">Python</button>
-                <button class="tab" data-tab="uf-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="uf-curl">
-                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-files \
-  -H "Authorization: Bearer $TOKEN" \
-  -F "file=@script.py"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="uf-py">
-                <pre><code>file_id = m.upload_file("script.py")
-file_ids = m.upload_files(["script.py", "data.csv"])</code></pre>
-              </div>
-              <div class="tab-content" data-tab="uf-js">
-                <pre><code>const fileId = await mags.uploadFile('script.py');</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Sync Workspace -->
-          <div class="endpoint card wide" id="sync-workspace" data-reveal>
-            <h3>Sync Workspace</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-jobs/:id/sync</span>
-            </div>
-            <p>Trigger an immediate workspace sync to S3 without stopping the VM.</p>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{ "success": true, "message": "Sync initiated" }</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="sw-py">Python</button>
-                <button class="tab" data-tab="sw-js">Node.js</button>
-                <button class="tab" data-tab="sw-cli">CLI</button>
-              </div>
-              <div class="tab-content active" data-tab="sw-py">
-                <pre><code>m.sync(request_id)</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sw-js">
-                <pre><code>await mags.sync(requestId);</code></pre>
-              </div>
-              <div class="tab-content" data-tab="sw-cli">
-                <pre><code>mags sync myproject</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- List Workspaces -->
-          <div class="endpoint card wide" id="list-workspaces" data-reveal>
-            <h3>List Workspaces</h3>
-            <div class="method-url">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-workspaces</span>
-            </div>
-            <p>List all persistent workspaces for the authenticated user.</p>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{
-  "workspaces": [
-    { "workspace_id": "myproject", "job_count": 12, "last_used": "2026-02-04T...", "has_active": false }
-  ],
-  "total": 3
-}</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="lw-curl">curl</button>
-                <button class="tab" data-tab="lw-py">Python</button>
-                <button class="tab" data-tab="lw-js">Node.js</button>
-                <button class="tab" data-tab="lw-cli">CLI</button>
-              </div>
-              <div class="tab-content active" data-tab="lw-curl">
-                <pre><code>curl https://api.magpiecloud.com/api/v1/mags-workspaces \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-              <div class="tab-content" data-tab="lw-py">
-                <pre><code>ws = m.list_workspaces()
-for w in ws["workspaces"]:
-    print(w["workspace_id"], w["job_count"])</code></pre>
-              </div>
-              <div class="tab-content" data-tab="lw-js">
-                <pre><code>const ws = await mags.listWorkspaces();
-ws.workspaces.forEach(w => console.log(w.workspaceId));</code></pre>
-              </div>
-              <div class="tab-content" data-tab="lw-cli">
-                <pre><code>mags workspace list</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Delete Workspace -->
-          <div class="endpoint card wide" id="delete-workspace" data-reveal>
-            <h3>Delete Workspace</h3>
-            <div class="method-url">
-              <span class="method delete">DELETE</span>
-              <span class="url-path">/api/v1/mags-workspaces/:id</span>
-            </div>
-            <p>Permanently delete a workspace and all its S3 data. Active jobs using this workspace must be stopped first.</p>
-            <p class="response-label">Response (200)</p>
-            <pre><code>{ "success": true, "message": "Workspace 'myproject' deleted" }</code></pre>
-            <p class="response-label">Error (409 Conflict)</p>
-            <pre><code>{ "error": "workspace 'myproject' has 1 active job(s); stop them first" }</code></pre>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="dw-py">Python</button>
-                <button class="tab" data-tab="dw-cli">CLI</button>
-                <button class="tab" data-tab="dw-curl">curl</button>
-              </div>
-              <div class="tab-content active" data-tab="dw-py">
-                <pre><code>m.delete_workspace("myproject")</code></pre>
-              </div>
-              <div class="tab-content" data-tab="dw-cli">
-                <pre><code>mags workspace delete myproject
-mags workspace delete myproject --force  # skip confirmation</code></pre>
-              </div>
-              <div class="tab-content" data-tab="dw-curl">
-                <pre><code>curl -X DELETE https://api.magpiecloud.com/api/v1/mags-workspaces/myproject \
-  -H "Authorization: Bearer $TOKEN"</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- URL Aliases -->
-          <div class="endpoint card wide" id="url-aliases" data-reveal>
-            <h3>URL Aliases</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-url-aliases</span>
-            </div>
-            <div class="method-url" style="margin-left:0.5rem">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-url-aliases</span>
-            </div>
-            <div class="method-url" style="margin-left:0.5rem">
-              <span class="method delete">DELETE</span>
-              <span class="url-path">/api/v1/mags-url-aliases/:subdomain</span>
-            </div>
-            <p>Create stable, human-readable URL aliases for your sandboxes. Aliases point to a workspace and automatically follow the active VM.</p>
-            <p class="response-label">Create request body</p>
-            <table class="field-table">
-              <thead>
-                <tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr>
-              </thead>
-              <tbody>
-                <tr><td><code>subdomain</code></td><td>string</td><td><span class="required">YES</span></td><td>Subdomain for the alias (e.g. <code>my-api</code>).</td></tr>
-                <tr><td><code>workspace_id</code></td><td>string</td><td><span class="required">YES</span></td><td>Workspace to point the alias at.</td></tr>
-                <tr><td><code>domain</code></td><td>string</td><td>no</td><td>Custom domain (default: <code>apps.magpiecloud.com</code>).</td></tr>
-              </tbody>
-            </table>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="ua-cli">CLI</button>
-                <button class="tab" data-tab="ua-py">Python</button>
-                <button class="tab" data-tab="ua-js">Node.js</button>
-              </div>
-              <div class="tab-content active" data-tab="ua-cli">
-                <pre><code># Create alias
-mags url alias my-api myproject
-# List aliases
-mags url alias list
-# Delete alias
-mags url alias remove my-api</code></pre>
-              </div>
-              <div class="tab-content" data-tab="ua-py">
-                <pre><code>m.url_alias_create("my-api", "myproject")
-aliases = m.url_alias_list()
-m.url_alias_delete("my-api")</code></pre>
-              </div>
-              <div class="tab-content" data-tab="ua-js">
-                <pre><code>await mags.urlAliasCreate('my-api', 'myproject');
-const aliases = await mags.urlAliasList();
-await mags.urlAliasDelete('my-api');</code></pre>
-              </div>
-            </div>
-          </div>
-          <!-- Cron Endpoints -->
-          <div class="endpoint card wide" id="cron-endpoints" data-reveal>
-            <h3>Cron Jobs</h3>
-            <div class="method-url">
-              <span class="method post">POST</span>
-              <span class="url-path">/api/v1/mags-cron</span>
-            </div>
-            <div class="method-url" style="margin-left:0.5rem">
-              <span class="method get">GET</span>
-              <span class="url-path">/api/v1/mags-cron</span>
-            </div>
-            <div class="method-url" style="margin-left:0.5rem">
-              <span class="method patch">PATCH</span>
-              <span class="url-path">/api/v1/mags-cron/:id</span>
-            </div>
-            <div class="method-url" style="margin-left:0.5rem">
-              <span class="method delete">DELETE</span>
-              <span class="url-path">/api/v1/mags-cron/:id</span>
-            </div>
-            <p>Create, list, update, and delete scheduled cron jobs.</p>
-            <p class="response-label">Create request body</p>
-            <table class="field-table">
-              <thead>
-                <tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr>
-              </thead>
-              <tbody>
-                <tr><td><code>name</code></td><td>string</td><td><span class="required">YES</span></td><td>Name for the cron job.</td></tr>
-                <tr><td><code>cron_expression</code></td><td>string</td><td><span class="required">YES</span></td><td>Standard cron expression (e.g. <code>0 * * * *</code>).</td></tr>
-                <tr><td><code>script</code></td><td>string</td><td><span class="required">YES</span></td><td>Script to run on each trigger.</td></tr>
-                <tr><td><code>workspace_id</code></td><td>string</td><td>no</td><td>Workspace to use.</td></tr>
-                <tr><td><code>persistent</code></td><td>bool</td><td>no</td><td>Keep VM alive after script.</td></tr>
-              </tbody>
-            </table>
-            <div class="code-tabs tab-group">
-              <p class="response-label">SDK examples</p>
-              <div class="tab-bar">
-                <button class="tab active" data-tab="cr-curl">curl</button>
-                <button class="tab" data-tab="cr-py">Python</button>
-                <button class="tab" data-tab="cr-js">Node.js</button>
-                <button class="tab" data-tab="cr-cli">CLI</button>
-              </div>
-              <div class="tab-content active" data-tab="cr-curl">
-                <pre><code>curl -X POST https://api.magpiecloud.com/api/v1/mags-cron \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "name": "nightly-backup",
-    "cron_expression": "0 0 * * *",
-    "script": "tar czf backup.tar.gz /data",
-    "workspace_id": "backups"
-  }'</code></pre>
-              </div>
-              <div class="tab-content" data-tab="cr-py">
-                <pre><code>cron = m.cron_create(
-    name="nightly-backup",
-    cron_expression="0 0 * * *",
-    script="tar czf backup.tar.gz /data",
-    workspace_id="backups",
-)
-jobs = m.cron_list()
-m.cron_update(cron["id"], enabled=False)
-m.cron_delete(cron["id"])</code></pre>
-              </div>
-              <div class="tab-content" data-tab="cr-js">
-                <pre><code>const cron = await mags.cronCreate({
-  name: 'nightly-backup',
-  cronExpression: '0 0 * * *',
-  script: 'tar czf backup.tar.gz /data',
-  workspaceId: 'backups',
-});
-await mags.cronDelete(cron.id);</code></pre>
-              </div>
-              <div class="tab-content" data-tab="cr-cli">
-                <pre><code>mags cron add --name "nightly-backup" --schedule "0 0 * * *" -w backups \
-  'tar czf backup.tar.gz /data'
-mags cron list
-mags cron remove &lt;id&gt;</code></pre>
-              </div>
-            </div>
-          </div>
-        </div>
-      </section>
-      <!-- Errors -->
-      <section class="section" id="errors">
-        <div class="container">
-          <div class="section-title">
-            <p>Errors</p>
-            <h2>Error responses.</h2>
-          </div>
-          <div class="card wide" data-reveal>
-            <p>All errors return:</p>
-            <pre><code>{ "error": "description of what went wrong" }</code></pre>
-            <table class="field-table">
-              <thead>
-                <tr><th>Status</th><th>Meaning</th></tr>
-              </thead>
-              <tbody>
-                <tr><td><code>400</code></td><td>Invalid request (missing fields, bad JSON).</td></tr>
-                <tr><td><code>401</code></td><td>Missing or invalid auth token.</td></tr>
-                <tr><td><code>404</code></td><td>Job or workspace not found.</td></tr>
-                <tr><td><code>409</code></td><td>Workspace has active jobs (delete conflict).</td></tr>
-                <tr><td><code>500</code></td><td>Server error.</td></tr>
-              </tbody>
-            </table>
-          </div>
-        </div>
-      </section>
-      <!-- VM Environment -->
-      <section class="section" id="vm-env">
-        <div class="container">
-          <div class="section-title">
-            <p>VM Environment</p>
-            <h2>What runs inside the VM.</h2>
-          </div>
-          <div class="grid split">
-            <article class="panel" data-reveal>
-              <h3>System</h3>
-              <table class="field-table">
-                <tbody>
-                  <tr><td><strong>OS</strong></td><td>Alpine Linux (~50MB rootfs)</td></tr>
-                  <tr><td><strong>Shell</strong></td><td><code>/bin/sh</code> (ash)</td></tr>
-                  <tr><td><strong>Package manager</strong></td><td><code>apk add &lt;package&gt;</code></td></tr>
-                  <tr><td><strong>User</strong></td><td><code>root</code></td></tr>
-                  <tr><td><strong>Working directory</strong></td><td><code>/root</code></td></tr>
-                </tbody>
-              </table>
-            </article>
-            <article class="panel" data-reveal>
-              <h3>Performance</h3>
-              <table class="field-table">
-                <tbody>
-                  <tr><td><strong>Boot time</strong></td><td>~300ms from pool</td></tr>
-                  <tr><td><strong>Default timeout</strong></td><td>300 seconds</td></tr>
-                  <tr><td><strong>Filesystem</strong></td><td>OverlayFS on base rootfs</td></tr>
-                  <tr><td><strong>Workspace sync</strong></td><td>S3-backed persistence</td></tr>
-                </tbody>
-              </table>
-            </article>
-          </div>
-        </div>
-      </section>
-    </main>
-    <footer class="site-footer">
-      <div class="container footer-grid">
-        <div>
-          <div class="brand">
-            <span class="logo">Mags</span>
-            <span class="tag">Instant sandboxes and runtime environments</span>
-          </div>
-          <p>Build, test, and run from clean microVMs whenever you need them.</p>
-        </div>
-        <div class="footer-links">
-          <a href="index.html">Home</a>
-          <a href="cookbook.html">Cookbook</a>
-          <a href="https://pypi.org/project/magpie-mags/" rel="noreferrer">Python SDK</a>
-          <a href="https://www.npmjs.com/package/@magpiecloud/mags" rel="noreferrer">Node.js SDK</a>
-          <a href="https://discord.gg/3avpC2nS" target="_blank" rel="noreferrer">Discord</a>
-          <a href="login.html">Login</a>
-        </div>
-      </div>
-    </footer>
-    <script src="script.js?v=8"></script>
-  </body>
-</html>