@cloudgrid-io/mcp 0.6.0 → 0.7.0

package/README.md

@@ -54,8 +54,11 @@ It speaks MCP over stdio. Point any MCP client at the `cloudgrid-mcp` command.
 
 | Tool | Wraps | Notes |
 |---|---|---|
-| `cloudgrid_drop` | `POST /api/v2/drop/auto` | Artifact drop. Anonymous, or owned if signed in. Direct API. |
-| `cloudgrid_claim` | `POST /api/v2/anon-claim` | Claim an anonymous drop into the signed-in account. Direct API. |
+| `gridctl_plug` | `POST /api/v2/plug` | The unified create/re-plug verb: create a new entity, or update the SAME entity in place with `target_entity_id` (same URL). Source via local `path` (local edition) or inline `artifact_files` (both). |
+| `gridctl_drop` | `POST /api/v2/plug` | Artifact drop. Anonymous, or owned if signed in. Re-drops in a session update the same drop in place; anonymous drops return an `entity_id` + `owner_token` re-plug/claim handle. |
+| `gridctl_claim` | `POST /api/v2/entities/:id/pickup` | Claim an anonymous drop into the signed-in account (the claim token IS the drop's owner token). Direct API. |
+| `gridctl_fork` | `POST /api/v2/runtimes/:id/fork` | Start a new entity from an existing runtime (lineage recorded). Needs sign-in. |
+| `gridctl_download` | `GET /api/v2/runtimes/:id/source` | Signed 15-minute source-bundle URLs. Needs sign-in. |
 | `cloudgrid_login` | `GET /auth/login` | Start a CLI-free sign-in; returns a URL to open. Direct API. |
 | `cloudgrid_login_status` | `GET /auth/status` | Finish the sign-in; saves the token to the shared CLI credentials. |
 | `cloudgrid_visibility` | `PATCH /api/v2/inspirations/<id>` | Change who can see a drop (private, space, authenticated, org, link). Needs sign-in. Direct API; also in the web edition. |
@@ -70,7 +73,6 @@ also work in the web edition where no CLI exists. `cloudgrid_login` writes the s
 | Tool | Wraps | Notes |
 |---|---|---|
 | `cloudgrid_init` | `cloudgrid init` | Register an app or agent; optionally seed a web service. |
-| `cloudgrid_plug` | `cloudgrid plug` | Deploy a directory or URL. |
 | `cloudgrid_logs` | `cloudgrid logs` | Snapshot of recent logs. Does not stream. Read-only. |
 | `cloudgrid_share` | `cloudgrid visibility set` | Set visibility, default link. |
 | `cloudgrid_feedback` | `cloudgrid feedback list` | Read the org feedback feed. Read-only. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudgrid-io/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for CloudGrid. Three editions: a local stdio server (full toolset), a hosted web server (light, CLI-free toolset), and a public docs server (search_cloudgrid_documentation) over MCP Streamable HTTP.",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "start": "node src/index.js",
     "start:web": "node src/web.js",
     "smoke": "node test/smoke.mjs",
+    "test:plug-wire": "node test/plug-wire.test.mjs",
     "test:drift-guard": "node test/drift-guard.mjs",
     "smoke:drop": "node test/smoke-drop.mjs",
     "smoke:login": "node test/smoke-login.mjs",

package/src/corpus/cookbook.md

@@ -71,10 +71,28 @@ curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
   -F "artifact=@./index.html;type=text/html"
 ```
 
-The response includes `slug` (the live link is `https://guest.cloudgrid.io/<slug>`)
-and `claim_url` (sign in within 7 days to keep it). This is what the `cloudgrid-drop`
-skill and the `cloudgrid_drop` MCP tool do for you. It is anonymous and serves
-inspirations only; a full app needs the signed-in `plug` flow above.
+The response includes `url` (the live link — use it verbatim), `entity_id`,
+`owner_token` (keep both to update the drop later), and `claim_url` (sign in
+before it expires to keep it). This is what the `cloudgrid-drop` skill and the
+`cloudgrid_drop` MCP tool do for you. It is anonymous and serves inspirations
+only; a full app needs the signed-in `plug` flow above.
+
+## Update your drop in place
+
+Re-plugging with `target_entity_id` updates the SAME entity — same slug, same URL,
+new content. Iterate on one link instead of minting a new one per revision:
+
+```
+curl -sS -X POST https://api.cloudgrid.io/api/v2/plug \
+  -F "target_entity_id=$ENTITY_ID" \
+  -F "owner_token=$OWNER_TOKEN" \
+  -F "artifact=@./index.html;type=text/html"
+```
+
+Signed in, drop the `owner_token` field and send your auth headers instead. Each
+anonymous edit returns a refreshed `owner_token` (store the new one) and resets
+the drop's expiry. Editing an archived or expired drop returns 409
+`EDIT_REJECTED`; omit `target_entity_id` when you actually want a fresh link.
 
 ## Shorter chains
 

package/src/corpus/examples/dashboard/index.html

@@ -0,0 +1,121 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Service Health Dashboard</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --good: #46d19e;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    padding: clamp(1.25rem, 4vw, 2.5rem);
+  }
+  header { margin-bottom: 1.75rem; }
+  h1 { font-size: clamp(1.6rem, 4vw, 2.3rem); letter-spacing: -0.02em; }
+  .status { color: var(--muted); margin-top: 0.35rem; }
+  .grid { display: grid; gap: 1.1rem; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }
+  .card {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 14px; padding: 1.25rem 1.4rem;
+  }
+  .card .label { color: var(--muted); font-size: 0.85rem; }
+  .card .value { font-size: 2rem; font-weight: 600; margin: 0.35rem 0; font-variant-numeric: tabular-nums; }
+  .card .trend { font-size: 0.85rem; color: var(--good); }
+  .charts { display: grid; gap: 1.1rem; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); margin-top: 1.1rem; }
+  .chart-card { background: var(--panel); border: 1px solid var(--border); border-radius: 14px; padding: 1.25rem 1.4rem; }
+  .chart-card h2 { font-size: 1rem; color: var(--muted); font-weight: 600; margin-bottom: 0.9rem; }
+  svg { width: 100%; height: auto; display: block; }
+</style>
+</head>
+<body>
+  <header>
+    <h1>Service Health Dashboard</h1>
+    <div class="status">All systems operational — updated a moment ago</div>
+  </header>
+
+  <section class="grid">
+    <div class="card">
+      <div class="label">Requests / min</div>
+      <div class="value">18.4k</div>
+      <div class="trend">+6.2% vs last hour</div>
+    </div>
+    <div class="card">
+      <div class="label">p95 latency</div>
+      <div class="value">142ms</div>
+      <div class="trend">-11ms vs last hour</div>
+    </div>
+    <div class="card">
+      <div class="label">Error rate</div>
+      <div class="value">0.08%</div>
+      <div class="trend">within target</div>
+    </div>
+    <div class="card">
+      <div class="label">Uptime (30d)</div>
+      <div class="value">99.98%</div>
+      <div class="trend">no incidents</div>
+    </div>
+  </section>
+
+  <section class="charts">
+    <div class="chart-card">
+      <h2>Requests by region</h2>
+      <svg id="bar" viewBox="0 0 320 160" role="img" aria-label="Bar chart of requests by region"></svg>
+    </div>
+    <div class="chart-card">
+      <h2>Latency over the last 12 hours</h2>
+      <svg id="line" viewBox="0 0 320 160" role="img" aria-label="Line chart of latency over time"></svg>
+    </div>
+  </section>
+
+  <script>
+    var barData = [42, 58, 31, 49, 66, 38];
+    var lineData = [160, 154, 148, 151, 139, 142, 137, 144, 140, 135, 142, 138];
+
+    var NS = "http://www.w3.org/2000/svg";
+    function el(name, attrs) {
+      var n = document.createElementNS(NS, name);
+      for (var k in attrs) n.setAttribute(k, attrs[k]);
+      return n;
+    }
+
+    (function drawBars() {
+      var svg = document.getElementById("bar");
+      var W = 320, H = 160, pad = 20;
+      var max = Math.max.apply(null, barData.concat([1]));
+      var bw = (W - pad * 2) / barData.length;
+      barData.forEach(function (v, i) {
+        var h = (v / max) * (H - pad * 2);
+        svg.appendChild(el("rect", {
+          x: pad + i * bw + bw * 0.15, y: H - pad - h,
+          width: bw * 0.7, height: h, rx: 3, fill: "var(--accent)"
+        }));
+      });
+      svg.appendChild(el("line", { x1: pad, y1: H - pad, x2: W - pad, y2: H - pad, stroke: "var(--border)" }));
+    })();
+
+    (function drawLine() {
+      var svg = document.getElementById("line");
+      var W = 320, H = 160, pad = 20;
+      var max = Math.max.apply(null, lineData.concat([1]));
+      var step = (W - pad * 2) / Math.max(1, lineData.length - 1);
+      var pts = lineData.map(function (v, i) {
+        return (pad + i * step) + "," + (H - pad - (v / max) * (H - pad * 2));
+      }).join(" ");
+      svg.appendChild(el("polyline", { points: pts, fill: "none", stroke: "var(--good)", "stroke-width": 2.5 }));
+      svg.appendChild(el("line", { x1: pad, y1: H - pad, x2: W - pad, y2: H - pad, stroke: "var(--border)" }));
+    })();
+  </script>
+</body>
+</html>

package/src/corpus/examples/landing-page/index.html

@@ -0,0 +1,98 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Cadence</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.5;
+  }
+  header, section, footer { padding: clamp(2rem, 6vw, 5rem) clamp(1.25rem, 6vw, 6rem); }
+  nav {
+    display: flex; align-items: center; justify-content: space-between;
+    padding: 1.1rem clamp(1.25rem, 6vw, 6rem);
+    border-bottom: 1px solid var(--border);
+  }
+  nav .brand { font-weight: 600; letter-spacing: -0.01em; }
+  nav a { color: var(--muted); text-decoration: none; }
+  .hero { text-align: center; display: grid; gap: 1.25rem; place-items: center; }
+  .hero h1 {
+    font-size: clamp(2.4rem, 6vw, 4.5rem);
+    line-height: 1.05; letter-spacing: -0.02em; max-width: 20ch;
+  }
+  .hero p { font-size: clamp(1.05rem, 2.4vw, 1.5rem); color: var(--muted); max-width: 48ch; }
+  .cta {
+    display: inline-block; margin-top: 0.5rem;
+    background: var(--accent); color: #fff; text-decoration: none;
+    padding: 0.85rem 1.6rem; border-radius: 10px; font-weight: 600;
+  }
+  .cta:hover { filter: brightness(1.08); }
+  .features {
+    display: grid; gap: 1.25rem;
+    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+    border-top: 1px solid var(--border);
+  }
+  .feature {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 14px; padding: 1.5rem;
+  }
+  .feature h3 { font-size: 1.15rem; margin-bottom: 0.5rem; letter-spacing: -0.01em; }
+  .feature p { color: var(--muted); }
+  .closing { text-align: center; border-top: 1px solid var(--border); display: grid; gap: 1.25rem; place-items: center; }
+  .closing h2 { font-size: clamp(1.8rem, 4.5vw, 3rem); letter-spacing: -0.01em; max-width: 24ch; }
+  footer { border-top: 1px solid var(--border); color: var(--muted); font-size: 0.9rem; text-align: center; }
+</style>
+</head>
+<body>
+  <nav>
+    <span class="brand">Cadence</span>
+    <a class="cta" href="#start">Start free</a>
+  </nav>
+
+  <header class="hero">
+    <h1>Ship your week in a single view</h1>
+    <p>Cadence turns scattered tasks, notes, and deadlines into one calm weekly plan your whole team can trust.</p>
+    <a class="cta" href="#start">Start free</a>
+  </header>
+
+  <section class="features">
+    <div class="feature">
+      <h3>One weekly board</h3>
+      <p>Every task, meeting, and milestone lands on a single board that resets each Monday so nothing slips.</p>
+    </div>
+    <div class="feature">
+      <h3>Automatic rollover</h3>
+      <p>Unfinished work carries forward with its context intact, so you never rebuild a plan from scratch.</p>
+    </div>
+    <div class="feature">
+      <h3>Quiet by design</h3>
+      <p>Notifications batch into two calm digests a day, keeping focus time genuinely free of interruptions.</p>
+    </div>
+    <div class="feature">
+      <h3>Shared without noise</h3>
+      <p>Teammates see the same board and status without a stream of pings, comments, or status meetings.</p>
+    </div>
+  </section>
+
+  <section class="closing" id="start">
+    <h2>Plan less, finish more this week</h2>
+    <a class="cta" href="#start">Start free</a>
+  </section>
+
+  <footer>Cadence — a sample landing page built on CloudGrid.</footer>
+</body>
+</html>

package/src/corpus/examples/report/index.html

@@ -0,0 +1,112 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Q2 Support Operations Review</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.6;
+  }
+  .page {
+    max-width: 820px; margin: 0 auto;
+    padding: clamp(2rem, 6vw, 4.5rem) clamp(1.25rem, 5vw, 3.5rem);
+  }
+  header { border-bottom: 1px solid var(--border); padding-bottom: 1.5rem; margin-bottom: 2rem; }
+  .accent-bar { width: 64px; height: 5px; border-radius: 99px; background: var(--accent); margin-bottom: 1.1rem; }
+  h1 { font-size: clamp(1.9rem, 4.5vw, 2.8rem); line-height: 1.1; letter-spacing: -0.02em; }
+  .subtitle { color: var(--muted); font-size: 1.1rem; margin-top: 0.5rem; }
+  .meta { color: var(--muted); font-size: 0.9rem; margin-top: 0.75rem; }
+  .summary {
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 12px; padding: 1.25rem 1.4rem; margin-bottom: 2rem; color: var(--muted);
+  }
+  section { margin-bottom: 2rem; }
+  section h2 { font-size: 1.35rem; letter-spacing: -0.01em; margin-bottom: 0.6rem; }
+  section p { color: var(--muted); }
+  table { width: 100%; border-collapse: collapse; margin-top: 0.5rem; }
+  th, td { text-align: left; padding: 0.6rem 0.75rem; border-bottom: 1px solid var(--border); }
+  th { color: var(--muted); font-size: 0.85rem; font-weight: 600; }
+  td { font-variant-numeric: tabular-nums; }
+  footer { border-top: 1px solid var(--border); padding-top: 1.25rem; color: var(--muted); font-size: 0.85rem; }
+  @media print {
+    :root { --bg: #ffffff; --panel: #f4f6fa; --fg: #10151f; --muted: #4a5568; --border: #d5dbe6; }
+    body { background: #fff; }
+    .page { padding: 0; }
+  }
+</style>
+</head>
+<body>
+  <div class="page">
+    <header>
+      <div class="accent-bar"></div>
+      <h1>Q2 Support Operations Review</h1>
+      <div class="subtitle">Ticket volume, response times, and satisfaction</div>
+      <div class="meta">Prepared by the Support team, quarter ending June 30</div>
+    </header>
+
+    <div class="summary">
+      Support handled 12% more tickets than Q1 while cutting median first-response
+      time by nearly a third. Satisfaction held steady at 94%. The main risk into
+      Q3 is billing-related volume, which grew faster than headcount.
+    </div>
+
+    <section>
+      <h2>Volume and staffing</h2>
+      <p>
+        The team resolved 8,420 tickets across the quarter, up from 7,510 in Q1.
+        Two agents joined in May, bringing the desk to nine. Even so, the
+        tickets-per-agent load rose slightly, absorbed mostly by faster tooling
+        rather than longer hours.
+      </p>
+    </section>
+
+    <section>
+      <h2>Response and resolution</h2>
+      <p>
+        Median first-response time fell from 4.6 hours to 3.1 hours after the
+        canned-reply library was rebuilt. Full resolution time was flat, since the
+        slowest tickets are billing disputes that depend on the finance team.
+      </p>
+    </section>
+
+    <section>
+      <h2>Outlook</h2>
+      <p>
+        Billing questions are the fastest-growing category and the least
+        self-serviceable. The recommendation for Q3 is a dedicated billing macro
+        set plus a short help-center article, before adding more headcount.
+      </p>
+    </section>
+
+    <section>
+      <h2>Key metrics</h2>
+      <table>
+        <thead>
+          <tr><th>Metric</th><th>Q1</th><th>Q2</th></tr>
+        </thead>
+        <tbody>
+          <tr><td>Tickets resolved</td><td>7,510</td><td>8,420</td></tr>
+          <tr><td>Median first response</td><td>4.6h</td><td>3.1h</td></tr>
+          <tr><td>Satisfaction</td><td>93%</td><td>94%</td></tr>
+        </tbody>
+      </table>
+    </section>
+
+    <footer>A sample report built on CloudGrid. Figures are illustrative.</footer>
+  </div>
+</body>
+</html>

package/src/corpus/examples/web-app/index.html

@@ -0,0 +1,125 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Tip Splitter</title>
+<style>
+  :root {
+    --bg: #0b0f17;
+    --panel: #121826;
+    --fg: #e8edf5;
+    --muted: #9aa7bd;
+    --accent: #5b8cff;
+    --border: #223049;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: var(--bg);
+    color: var(--fg);
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    min-height: 100vh;
+    display: grid; place-items: center;
+    padding: 1.5rem;
+  }
+  .app {
+    width: 100%; max-width: 420px;
+    background: var(--panel); border: 1px solid var(--border);
+    border-radius: 16px; padding: 1.75rem;
+  }
+  h1 { font-size: 1.5rem; letter-spacing: -0.01em; margin-bottom: 0.35rem; }
+  .subtitle { color: var(--muted); font-size: 0.95rem; margin-bottom: 1.4rem; }
+  label { display: block; font-size: 0.85rem; color: var(--muted); margin: 0.9rem 0 0.35rem; }
+  input {
+    width: 100%; font: inherit; color: var(--fg);
+    background: var(--bg); border: 1px solid var(--border);
+    border-radius: 10px; padding: 0.65rem 0.75rem;
+  }
+  input:focus { outline: none; border-color: var(--accent); }
+  .row { display: flex; gap: 0.75rem; }
+  .row > * { flex: 1; }
+  .tips { display: flex; gap: 0.5rem; margin-top: 0.35rem; }
+  .tips button {
+    flex: 1; font: inherit; cursor: pointer;
+    background: var(--bg); color: var(--fg);
+    border: 1px solid var(--border); border-radius: 10px; padding: 0.55rem 0;
+  }
+  .tips button.active { border-color: var(--accent); color: var(--accent); }
+  .result {
+    margin-top: 1.5rem; padding: 1.1rem 1.25rem;
+    background: var(--bg); border: 1px solid var(--border); border-radius: 12px;
+    display: grid; gap: 0.6rem;
+  }
+  .result .line { display: flex; align-items: baseline; justify-content: space-between; }
+  .result .label { color: var(--muted); font-size: 0.85rem; }
+  .result .value { font-size: 1.15rem; font-weight: 600; font-variant-numeric: tabular-nums; }
+  .result .line.total .value { font-size: 1.7rem; color: var(--accent); }
+</style>
+</head>
+<body>
+  <main class="app">
+    <h1>Tip Splitter</h1>
+    <p class="subtitle">Split a bill and tip evenly across the table.</p>
+
+    <label for="bill">Bill amount</label>
+    <input id="bill" type="number" min="0" step="0.01" value="86.40" inputmode="decimal" />
+
+    <label>Tip percentage</label>
+    <div class="tips" id="tips">
+      <button data-tip="10">10%</button>
+      <button data-tip="15" class="active">15%</button>
+      <button data-tip="18">18%</button>
+      <button data-tip="20">20%</button>
+    </div>
+
+    <label for="people">Number of people</label>
+    <input id="people" type="number" min="1" step="1" value="4" inputmode="numeric" />
+
+    <div class="result">
+      <div class="line">
+        <span class="label">Tip amount</span>
+        <span class="value" id="tipOut">0.00</span>
+      </div>
+      <div class="line total">
+        <span class="label">Each person pays</span>
+        <span class="value" id="perOut">0.00</span>
+      </div>
+    </div>
+  </main>
+
+  <script>
+    (function () {
+      var bill = document.getElementById("bill");
+      var people = document.getElementById("people");
+      var tips = document.getElementById("tips");
+      var tipOut = document.getElementById("tipOut");
+      var perOut = document.getElementById("perOut");
+      var tipPct = 15;
+
+      function render() {
+        var amount = parseFloat(bill.value) || 0;
+        var n = Math.max(1, parseInt(people.value, 10) || 1);
+        var tip = amount * (tipPct / 100);
+        var perPerson = (amount + tip) / n;
+        tipOut.textContent = tip.toFixed(2);
+        perOut.textContent = perPerson.toFixed(2);
+      }
+
+      tips.addEventListener("click", function (e) {
+        var btn = e.target.closest("button");
+        if (!btn) return;
+        tipPct = parseFloat(btn.getAttribute("data-tip"));
+        Array.prototype.forEach.call(tips.children, function (b) {
+          b.classList.toggle("active", b === btn);
+        });
+        render();
+      });
+
+      bill.addEventListener("input", render);
+      people.addEventListener("input", render);
+      render();
+    })();
+  </script>
+</body>
+</html>

package/src/corpus/install.md

@@ -34,9 +34,13 @@ npx skills add cloudgrid-io/skills
 
 ```
 /plugin marketplace add cloudgrid-io/skills
+/plugin install cloudgrid@cloudgrid-skills
 ```
 
-The marketplace manifest lives in `.claude-plugin/`.
+The marketplace manifest lives in `.claude-plugin/` (marketplace name:
+`cloudgrid-skills`, plugin name: `cloudgrid`). Installing the plugin bundles the
+skills, the SessionStart orientation hook, and the CloudGrid MCP server — the MCP
+auto-starts when the plugin is enabled, so no separate `claude mcp add` is needed.
 
 ### Codex
 

package/src/corpus/skill-claim.md

@@ -14,7 +14,7 @@ allowed-tools: Bash
 
 Turn an anonymous drop into an owned one. After an anonymous drop, the user has a
 `claim_url` (or token) plus the drop's `entity_id`. Once they sign in, claiming
-transfers ownership to them and extends the expiry from 7 days to 30. Claiming
+transfers ownership to them and resets the expiry window. Claiming
 re-homes the drop into the user's grid, so its public URL changes from
 `guest.cloudgrid.io/<slug>` to `<grid>.cloudgrid.io/<slug>` — share the new link.
 
@@ -26,11 +26,17 @@ skill (or `cloudgrid login` with the CLI) first.
 ## What you need
 
 Two things: the **entity id** of the anonymous drop (the `entity_id` field the drop
-returned), and the **claim token** — the `token` query parameter inside the
-`claim_url` the drop returned, e.g. `https://console.cloudgrid.io/claim?token=<TOKEN>`.
+returned), and the **claim token**. The claim token is the drop's `owner_token` —
+the same JWT used for anonymous re-plugs. It also appears as the `token` query
+parameter inside the `claim_url` the drop returned, e.g.
+`https://console.cloudgrid.io/claim?token=<TOKEN>`.
 A browser that still holds the `cg_anon_session` cookie from the drop can claim
 without a token instead.
 
+Note: every anonymous re-plug (edit) of the drop refreshes the `owner_token` and
+resets the drop's expiry. Always claim with the token from the LATEST drop or
+edit response — an older token may have been superseded.
+
 ## How to run it
 
 Claiming is now a "pickup" of the entity into your grid. The entity id goes in the