@opennodes/registry 0.1.10 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennodes/registry",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "OpenNodes (ONP) reference registry: node registration with proof-of-resource qualification (Stage A/B/C), transparent ranking, enforceable estimates, catalog importers (OpenRouter, Hugging Face, models.dev, Ollama), MCP surface, and the web app (catalog, chat, advisor, Node Builder)",
   "license": "Apache-2.0",
   "type": "module",

package/src/feed.js

@@ -0,0 +1,42 @@
+// Feed shaping: a node that keeps dropping offline and coming back would otherwise fill
+// the public feed with suspended/reinstated pairs. Consecutive liveness transitions of
+// one node collapse into a single availability event; everything else passes through.
+
+const isLiveness = (e) => /^(liveness:|reinstated:)/.test(e.reason ?? '');
+
+/** events: newest first. Returns newest first, with liveness runs (2+ events) collapsed. */
+export function collapseFlaps(events) {
+  const out = [];
+  const open = new Map();   // node_id -> collapsed entry still accepting older liveness events
+  for (const e of events) {
+    if (!isLiveness(e)) {
+      open.delete(e.node_id);
+      out.push(e);
+      continue;
+    }
+    const run = open.get(e.node_id);
+    if (run) {
+      run.events.push(e);
+      continue;
+    }
+    const entry = { ...e, events: [e] };
+    open.set(e.node_id, entry);
+    out.push(entry);
+  }
+  return out.map((entry) => {
+    if (!entry.events) return entry;
+    const { events: run, ...newest } = entry;
+    if (run.length === 1) return newest;
+    const oldest = run[run.length - 1];
+    const outages = run.filter((e) => e.to === 'suspended').length;
+    const now = newest.to === 'suspended' ? 'suspended now' : `${newest.to} again`;
+    return {
+      ...newest,
+      from: oldest.from,
+      kind: 'availability',
+      collapsed: run.length,
+      since: oldest.at,
+      reason: `availability: ${outages} outage${outages === 1 ? '' : 's'} since ${oldest.at.slice(0, 10)}, ${now}`,
+    };
+  });
+}

package/src/server.js

@@ -19,6 +19,7 @@ import { searchOfferings, searchOfferingsPaged, collectOfferings, RANK_COMPONENT
 import { mcpRoutes } from './mcp.js';
 import { hostControlsNamespace, isPrivateHost, makeRateLimiter } from './namespace.js';
 import { exportRoutes } from './export.js';
+import { collapseFlaps } from './feed.js';
 import {
   importModelsDev, importHuggingFace, importOpenRouter,
   importOllamaLibrary, parseOllamaLibrary,
@@ -321,13 +322,16 @@ export async function startRegistry({
 
     // Freshness feed: recent listing events (registrations, tier changes, suspensions),
     // newest first, each linked to its provenance reason.
+    // Liveness flaps (suspended/reinstated runs) collapse into one availability event;
+    // ?raw=1 returns every transition.
     ['GET', '/v0/feed', async (req, res, { query }) => {
       const limit = Math.min(Number(query.get('limit') ?? 50), 200);
-      const events = (await store.recentTransitions(limit)).map((t) => ({
+      const raw = query.get('raw') === '1';
+      const events = (await store.recentTransitions(raw ? limit : Math.min(limit * 10, 2000))).map((t) => ({
         at: t.at, node_id: t.node_id, from: t.from_state, to: t.to_state,
         reason: t.reason, source: t.source ?? 'registration',
       }));
-      sendJson(res, 200, { events });
+      sendJson(res, 200, { events: raw ? events : collapseFlaps(events).slice(0, limit) });
     }],
 
     ['GET', '/v0/nodes/:id', async (req, res, { params }) => {
@@ -399,6 +403,27 @@ export async function startRegistry({
       sendJson(res, 200, recommend(all, features, body.policy ?? {}));
     }],
 
+    // Delist (admin): operator opt-out of an imported listing, or retiring a node. Search,
+    // the directory and Stage C skip delisted nodes, and re-imports never revive them.
+    // Body {reason}. A registered node returns by registering again; relist re-opens imports.
+    ['POST', '/v0/admin/nodes/:id/delist', async (req, res, { params }) => {
+      if (!adminOk(req, res)) return;
+      const node = await store.getNode(params.id);
+      if (!node) return problem(res, 404, 'unknown-node', params.id);
+      const { reason } = await readJson(req);
+      if (node.state !== 'delisted') await store.setState(node.id, 'delisted', `delisted: ${reason || 'by registry admin'}`);
+      sendJson(res, 200, { id: node.id, state: 'delisted' });
+    }],
+    ['POST', '/v0/admin/nodes/:id/relist', async (req, res, { params }) => {
+      if (!adminOk(req, res)) return;
+      const node = await store.getNode(params.id);
+      if (!node) return problem(res, 404, 'unknown-node', params.id);
+      if (node.state !== 'delisted') return problem(res, 409, 'not-delisted', `${node.id} is ${node.state}`);
+      if (node.source !== 'import') return problem(res, 409, 'register-again', 'a registered node returns by registering again (POST /v0/nodes)');
+      await store.setState(node.id, 'indexed', 'relisted by registry admin');
+      sendJson(res, 200, { id: node.id, state: 'indexed' });
+    }],
+
     // Seed importer (admin): body {catalog} in models.dev shape, or {url} to fetch it.
     ['POST', '/v0/import/models-dev', async (req, res) => {
       if (!adminOk(req, res)) return;

package/src/web/index.html

@@ -317,7 +317,7 @@
 <!-- ================= NEW (feed) ================= -->
 <div id="view-feed" hidden>
   <h1>New</h1>
-  <p class="sub">Dated listing events, newest first — registrations, tier changes, suspensions — each with its provenance. Also available as <a id="feed-json" href="/v0/feed">JSON</a> for agents.</p>
+  <p class="sub">Dated listing events, newest first — registrations, tier changes, suspensions — each with its provenance. A node that keeps dropping offline and coming back shows as one availability line. Also available as <a id="feed-json" href="/v0/feed">JSON</a> for agents (<a href="/v0/feed?raw=1">every transition</a>).</p>
   <div class="panel pad" id="feed-list"></div>
 </div>
 
@@ -1729,7 +1729,7 @@ async function loadFeed() {
     $('#feed-list').innerHTML = events.length ? events.map((e) => `<div class="feeditem">
       <span class="prov">${esc((e.at || '').replace('T', ' ').slice(0, 16))}</span>
       <span><a href="#/node/${encodeURIComponent(e.node_id)}" class="mono" style="font-size:0.78rem">${esc(e.node_id)}</a>
-        → ${tierChip(e.to)} ${e.reason ? '<span style="color:var(--muted)">— ' + esc(e.reason) + '</span>' : ''}</span>
+        → ${tierChip(e.to)} ${e.reason ? '<span style="color:var(--muted)">— ' + esc(e.reason) + (e.collapsed ? ' (' + e.collapsed + ' events)' : '') + '</span>' : ''}</span>
     </div>`).join('') : '<p class="sub">No events yet.</p>';
   } catch (e) { $('#feed-list').innerHTML = '<p class="err">' + esc(e.message) + '</p>'; }
 }