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/cookbook/hn-marketing.html DELETED Viewed

@@ -1,410 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>HN Marketing Digest - Mags Cookbook</title>
-    <meta
-      name="description"
-      content="Auto-updated marketing news from Hacker News, powered by a Mags cron job."
-    />
-    <meta name="api-base" content="https://api.magpiecloud.com" />
-    <meta name="auth-base" content="https://api.magpiecloud.com" />
-    <link rel="stylesheet" href="../styles.css" />
-    <script src="../env.js"></script>
-    <style>
-      .hn-feed {
-        display: grid;
-        gap: 1rem;
-      }
-      .hn-story {
-        background: var(--surface);
-        border: 1px solid var(--border);
-        border-radius: var(--radius-sm);
-        padding: 1.2rem 1.4rem;
-        box-shadow: var(--shadow);
-        transition: transform 0.2s ease, box-shadow 0.2s ease;
-      }
-      .hn-story:hover {
-        transform: translateY(-2px);
-      }
-      .hn-story h4 {
-        margin: 0 0 0.5rem;
-        font-size: 1rem;
-        line-height: 1.4;
-      }
-      .hn-story h4 a {
-        color: var(--text);
-      }
-      .hn-story h4 a:hover {
-        color: var(--accent-strong);
-      }
-      .hn-meta {
-        display: flex;
-        gap: 1.2rem;
-        font-size: 0.85rem;
-        color: var(--text-muted);
-        flex-wrap: wrap;
-      }
-      .hn-meta a {
-        color: var(--accent-strong);
-        font-weight: 600;
-      }
-      .hn-status-bar {
-        display: flex;
-        align-items: center;
-        justify-content: space-between;
-        gap: 1rem;
-        margin-bottom: 1.4rem;
-        flex-wrap: wrap;
-      }
-      .hn-status-bar .last-checked {
-        font-size: 0.85rem;
-        color: var(--text-muted);
-      }
-      .refresh-btn {
-        display: inline-flex;
-        align-items: center;
-        gap: 0.4rem;
-        padding: 0.5rem 1rem;
-        border-radius: 999px;
-        border: 1px solid var(--border);
-        background: #ffffff;
-        color: var(--text-muted);
-        font-size: 0.85rem;
-        font-family: var(--sans);
-        cursor: pointer;
-        transition: border-color 0.2s ease, color 0.2s ease, transform 0.2s ease;
-      }
-      .refresh-btn:hover {
-        border-color: var(--accent);
-        color: var(--accent-strong);
-        transform: translateY(-1px);
-      }
-      .refresh-btn:disabled {
-        opacity: 0.5;
-        cursor: not-allowed;
-        transform: none;
-      }
-      .hn-empty {
-        text-align: center;
-        padding: 2.5rem 1rem;
-        color: var(--text-muted);
-        background: var(--surface-muted);
-        border-radius: var(--radius-sm);
-        border: 1px solid var(--border);
-      }
-      .hn-loading {
-        text-align: center;
-        padding: 2.5rem 1rem;
-        color: var(--text-muted);
-      }
-      .step-number {
-        display: inline-flex;
-        align-items: center;
-        justify-content: center;
-        width: 1.6rem;
-        height: 1.6rem;
-        border-radius: 50%;
-        background: var(--accent);
-        color: #fff;
-        font-size: 0.75rem;
-        font-weight: 700;
-        margin-right: 0.5rem;
-        flex-shrink: 0;
-      }
-      .step-item {
-        margin-bottom: 1.8rem;
-      }
-      .step-item h3 {
-        display: flex;
-        align-items: center;
-        margin: 0 0 0.6rem;
-        font-size: 1.05rem;
-      }
-    </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">HN Marketing Digest</span>
-        </div>
-        <nav class="nav-links">
-          <a href="../index.html">Home</a>
-          <a href="../index.html#quickstart">Quickstart</a>
-          <a href="../index.html#cli">CLI</a>
-          <a href="../index.html#api">API</a>
-          <a href="../login.html">Login</a>
-          <a href="../usage.html">Usage</a>
-          <a href="../tokens.html">Tokens</a>
-          <a href="../cookbook.html">Cookbook</a>
-        </nav>
-        <div class="nav-cta">
-          <a class="button ghost" href="../cookbook.html">Back to Cookbook</a>
-        </div>
-      </div>
-    </header>
-    <main>
-      <section class="hero">
-        <div class="container hero-grid">
-          <div class="hero-copy">
-            <span class="pill">Cron</span>
-            <h1>HN Marketing Digest</h1>
-            <p class="lead">
-              Automatically fetch and filter Hacker News for marketing-related stories.
-              Run it as a cron job in a Mags sandbox, or check the live feed below.
-            </p>
-            <div class="hero-actions">
-              <a class="button" href="#recipe">Setup recipe</a>
-              <a class="button ghost" href="#live-feed">Live feed</a>
-            </div>
-          </div>
-          <div class="hero-card">
-            <div class="card-header">
-              <span>Preview</span>
-              <span class="chip">Shell</span>
-            </div>
-            <pre><code>$ sh hn-marketing.sh
-=== HN Marketing Digest ===
-Fetching top stories from Hacker News...
-[1] Why SEO is dead in 2025
-    Score: 342 | Link: https://...
-    HN: https://news.ycombinator.com/...
-Found 3 marketing-related stories.</code></pre>
-            <p class="card-note">Runs with just <code>curl</code> and <code>jq</code> on Alpine.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section" id="recipe">
-        <div class="container">
-          <div class="section-title">
-            <p>Recipe</p>
-            <h2>Set up the cron job in 3 steps.</h2>
-          </div>
-          <div class="step-item" data-reveal>
-            <h3><span class="step-number">1</span> Upload script and install dependencies</h3>
-            <p class="label">Upload the shell script to a persistent workspace and install <code>curl</code> + <code>jq</code>.</p>
-            <pre><code>mags run -f cookbook/hn-marketing.sh -w hn-digest \
-  'cp hn-marketing.sh /root/ && chmod +x /root/hn-marketing.sh && apk add -q curl jq && echo "Setup complete"'</code></pre>
-          </div>
-          <div class="step-item" data-reveal>
-            <h3><span class="step-number">2</span> Test run it manually</h3>
-            <p class="label">Verify the script works before scheduling.</p>
-            <pre><code>mags run -w hn-digest 'sh /root/hn-marketing.sh'</code></pre>
-          </div>
-          <div class="step-item" data-reveal>
-            <h3><span class="step-number">3</span> Activate the cron job</h3>
-            <p class="label">Schedule the digest to run every 2 hours.</p>
-            <pre><code>mags cron add --name "hn-marketing" --schedule "0 */2 * * *" -w hn-digest \
-  'sh /root/hn-marketing.sh'</code></pre>
-          </div>
-          <div class="callout" data-reveal>
-            <p>Check cron status any time with <code>mags cron list</code>.</p>
-          </div>
-        </div>
-      </section>
-      <section class="section">
-        <div class="container">
-          <div class="section-title">
-            <p>Script</p>
-            <h2>The full shell script.</h2>
-          </div>
-          <article class="panel" data-reveal>
-            <h3>hn-marketing.sh</h3>
-            <pre><code>#!/bin/sh
-# hn-marketing.sh — Fetch top HN stories and filter for marketing-related content
-# Dependencies: curl, jq (install with: apk add -q curl jq)
-set -e
-KEYWORDS='marketing|growth hack|SEO|advertising|branding|brand strategy|content strategy|content marketing|acquisition|retention|funnel|conversion|GTM|go-to-market|product.led|newsletter|copywriting|social media|influencer|public relations|DTC|B2B marketing|B2C|demand gen|lead gen|campaign'
-echo "=== HN Marketing Digest ==="
-echo "Fetching top stories from Hacker News..."
-echo ""
-IDS=$(curl -sf "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[0:100] | .[]')
-if [ -z "$IDS" ]; then
-  echo "Error: could not fetch story IDs"
-  exit 1
-fi
-COUNT=0
-for ID in $IDS; do
-  ITEM=$(curl -sf "https://hacker-news.firebaseio.com/v0/item/${ID}.json")
-  TITLE=$(echo "$ITEM" | jq -r '.title // empty')
-  if [ -z "$TITLE" ]; then
-    continue
-  fi
-  MATCH=$(echo "$TITLE" | grep -iE "$KEYWORDS" || true)
-  if [ -n "$MATCH" ]; then
-    URL=$(echo "$ITEM" | jq -r '.url // "https://news.ycombinator.com/item?id='"$ID"'"')
-    SCORE=$(echo "$ITEM" | jq -r '.score // 0')
-    TIME=$(echo "$ITEM" | jq -r '.time // 0')
-    COUNT=$((COUNT + 1))
-    echo "[$COUNT] $TITLE"
-    echo "    Score: $SCORE | Link: $URL"
-    echo "    HN: https://news.ycombinator.com/item?id=$ID"
-    echo ""
-  fi
-done
-if [ "$COUNT" -eq 0 ]; then
-  echo "No marketing-related stories found in the current top 100."
-else
-  echo "---"
-  echo "Found $COUNT marketing-related stories."
-fi</code></pre>
-          </article>
-        </div>
-      </section>
-      <section class="section" id="live-feed">
-        <div class="container">
-          <div class="section-title">
-            <p>Live feed</p>
-            <h2>Marketing stories on HN right now.</h2>
-          </div>
-          <div class="hn-status-bar">
-            <span class="last-checked" id="hn-last-checked">Loading...</span>
-            <button class="refresh-btn" id="hn-refresh" type="button">Refresh</button>
-          </div>
-          <div class="hn-feed" id="hn-feed">
-            <div class="hn-loading">Fetching stories from Hacker News...</div>
-          </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="../login.html">Login</a>
-          <a href="../usage.html">Usage</a>
-          <a href="../tokens.html">Tokens</a>
-          <a href="../cookbook.html">Cookbook</a>
-          <a href="../claude-skill.html">Claude Skill</a>
-          <a href="https://magpiecloud.com/docs/mags" rel="noreferrer">Documentation</a>
-        </div>
-      </div>
-    </footer>
-    <script src="../script.js"></script>
-    <script>
-    (function () {
-      var HN_API = 'https://hacker-news.firebaseio.com/v0';
-      var KEYWORDS = /marketing|growth hack|seo|advertising|branding|brand strategy|content strategy|content marketing|acquisition|retention|funnel|conversion|gtm|go-to-market|product.led|newsletter|copywriting|social media|influencer|public relations|dtc|b2b marketing|b2c|demand gen|lead gen|campaign/i;
-      var feedEl = document.getElementById('hn-feed');
-      var lastCheckedEl = document.getElementById('hn-last-checked');
-      var refreshBtn = document.getElementById('hn-refresh');
-      function timeAgo(unixSeconds) {
-        var diff = Math.floor(Date.now() / 1000) - unixSeconds;
-        if (diff < 60) return diff + 's ago';
-        if (diff < 3600) return Math.floor(diff / 60) + 'm ago';
-        if (diff < 86400) return Math.floor(diff / 3600) + 'h ago';
-        return Math.floor(diff / 86400) + 'd ago';
-      }
-      function renderStories(stories) {
-        feedEl.innerHTML = '';
-        if (!stories.length) {
-          feedEl.innerHTML = '<div class="hn-empty"><p>No marketing-related stories in the current top 100.</p><p>Check back later — the feed updates with every refresh.</p></div>';
-          return;
-        }
-        stories.forEach(function (story) {
-          var card = document.createElement('div');
-          card.className = 'hn-story';
-          var link = story.url || ('https://news.ycombinator.com/item?id=' + story.id);
-          var hnLink = 'https://news.ycombinator.com/item?id=' + story.id;
-          var age = story.time ? timeAgo(story.time) : '';
-          card.innerHTML =
-            '<h4><a href="' + link + '" target="_blank" rel="noreferrer">' + escapeHtml(story.title) + '</a></h4>' +
-            '<div class="hn-meta">' +
-              '<span>' + (story.score || 0) + ' points</span>' +
-              '<span>' + age + '</span>' +
-              '<a href="' + hnLink + '" target="_blank" rel="noreferrer">Comments</a>' +
-            '</div>';
-          feedEl.appendChild(card);
-        });
-      }
-      function escapeHtml(text) {
-        var el = document.createElement('span');
-        el.textContent = text;
-        return el.innerHTML;
-      }
-      function fetchFeed() {
-        refreshBtn.disabled = true;
-        refreshBtn.textContent = 'Loading...';
-        feedEl.innerHTML = '<div class="hn-loading">Fetching stories from Hacker News...</div>';
-        fetch(HN_API + '/topstories.json')
-          .then(function (res) { return res.json(); })
-          .then(function (ids) {
-            var first100 = ids.slice(0, 100);
-            var fetches = first100.map(function (id) {
-              return fetch(HN_API + '/item/' + id + '.json').then(function (r) { return r.json(); });
-            });
-            return Promise.all(fetches);
-          })
-          .then(function (items) {
-            var matches = items.filter(function (item) {
-              return item && item.title && KEYWORDS.test(item.title);
-            });
-            matches.sort(function (a, b) { return (b.score || 0) - (a.score || 0); });
-            renderStories(matches);
-            lastCheckedEl.textContent = 'Last checked: ' + new Date().toLocaleTimeString();
-          })
-          .catch(function (err) {
-            feedEl.innerHTML = '<div class="hn-empty"><p>Failed to fetch stories. Check your connection and try again.</p></div>';
-            lastCheckedEl.textContent = 'Error loading feed';
-          })
-          .finally(function () {
-            refreshBtn.disabled = false;
-            refreshBtn.textContent = 'Refresh';
-          });
-      }
-      refreshBtn.addEventListener('click', fetchFeed);
-      fetchFeed();
-    })();
-    </script>
-  </body>
-</html>

package/website/cookbook/hn-marketing.sh DELETED Viewed

@@ -1,42 +0,0 @@
-#!/bin/sh
-# hn-marketing.sh — Fetch top 10 HN stories and save to CSV
-# Dependencies: curl, jq (install with: apk add -q curl jq)
-set -e
-CSV="${HN_CSV:-./hn-top10.csv}"
-TIMESTAMP=$(date -u +"%Y-%m-%d %H:%M:%S UTC")
-# Write CSV header if file doesn't exist
-if [ ! -f "$CSV" ]; then
-  echo "timestamp,rank,score,title,url,hn_link" > "$CSV"
-fi
-echo "=== HN Top 10 ==="
-echo "Fetched at: $TIMESTAMP"
-echo ""
-# Get top 10 story IDs
-IDS=$(curl -sf "https://hacker-news.firebaseio.com/v0/topstories.json" | jq -r '.[0:10] | .[]')
-RANK=0
-for ID in $IDS; do
-  RANK=$((RANK + 1))
-  ITEM=$(curl -sf "https://hacker-news.firebaseio.com/v0/item/${ID}.json")
-  TITLE=$(echo "$ITEM" | jq -r '.title // "untitled"' | tr -d '\n\r' | sed 's/,/;/g')
-  URL=$(echo "$ITEM" | jq -r '.url // ""' | tr -d '\n\r')
-  SCORE=$(echo "$ITEM" | jq -r '.score // 0')
-  HN_LINK="https://news.ycombinator.com/item?id=$ID"
-  [ -z "$URL" ] && URL="$HN_LINK"
-  echo "[$RANK] $TITLE"
-  echo "    Score: $SCORE | $URL"
-  echo ""
-  echo "$TIMESTAMP,$RANK,$SCORE,$TITLE,$URL,$HN_LINK" >> "$CSV"
-done
-echo "---"
-echo "Saved to $CSV"