@opennodes/registry 0.1.25 → 0.1.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennodes/registry",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "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/importers.js

@@ -71,6 +71,14 @@ export const KNOWN_PROVIDER_COUNTRY = Object.freeze({
   mistral: 'FR', stackit: 'DE', hetzner: 'DE', infomaniak: 'CH',
 });
 
+/** Providers whose models are included in a subscription plan rather than priced per token. */
+export const SUBSCRIPTION_PROVIDERS = /token-plan|^gitlab$/;
+
+function perTokenPriced(providerId, model) {
+  if (SUBSCRIPTION_PROVIDERS.test(providerId)) return false;
+  return model?.cost?.input != null || model?.cost?.output != null;
+}
+
 /**
  * Import a models.dev-shaped catalog: { providerId: { id, name, api?, doc?, models: { key: model } } }.
  * Each provider becomes a synthetic node `import.modelsdev.{provider}`; each model an offering.
@@ -102,10 +110,14 @@ export async function importModelsDev(store, catalog) {
           ...(model?.tool_call ? { supports: ['tool_calls'] } : {}),
         },
         binding: { profile: 'onp.openai.chat/v1', model_id: model?.id ?? modelKey },
+        // A missing cost is "not published", never "free"; subscription plans (token plans,
+        // GitLab Duo) list 0 because usage is included in the plan, not because it is free.
         pricing: {
           currency: 'USD',
-          input_per_mtok: Number(model?.cost?.input ?? 0),
-          output_per_mtok: Number(model?.cost?.output ?? 0),
+          ...(perTokenPriced(providerId, model) ? {
+            input_per_mtok: Number(model.cost.input ?? 0),
+            output_per_mtok: Number(model.cost.output ?? 0),
+          } : {}),
           schemes: ['prepaid'],
         },
       });

package/src/mcp.js

@@ -3,7 +3,7 @@
 // MCP host gets ONP discovery (recommend, search_offerings, get_offering, get_node, estimate) for free.
 import { readFileSync } from 'node:fs';
 import { readJson, sendJson, problem, estimateBounds, round6, extractFeatures, recommend, MCP_TOOLS, MCP_INSTRUCTIONS, summarizeNode } from '@opennodes/core';
-import { searchOfferingsPaged, searchOfferings, collectOfferings } from './search.js';
+import { searchOfferingsPaged, searchOfferings, collectOfferings, pricePublished } from './search.js';
 
 const PROTOCOL_VERSION = '2025-06-18';
 const { version: VERSION } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
@@ -61,7 +61,7 @@ async function runTool(store, name, args = {}) {
     case 'estimate': {
       const all = await collectOfferings(store);
       const steps = [];
-      let min = 0, max = 0, currency = 'USD';
+      let min = 0, max = 0, currency = 'USD', incomplete = false;
       for (const step of args.steps ?? []) {
         let offering;
         if (step.offering) {
@@ -79,13 +79,15 @@ async function runTool(store, name, args = {}) {
         const bounds = estimateBounds(offering.pricing, step.est_input_tokens ?? 0, step.est_output_tokens ?? 0);
         currency = offering.pricing.currency;
         min += bounds.min; max += bounds.max;
+        const unpriced = !pricePublished(offering.pricing);   // unknown cost, not zero
+        incomplete ||= unpriced;
         steps.push({
           offering: `${offering.node_id}/${offering.offering_id}`,
           card_revision: offering.card_revision,
-          cost: { currency, ...bounds },
+          cost: { currency, ...bounds, ...(unpriced ? { price_published: false } : {}) },
         });
       }
-      return { total: { currency, min: round6(min), max: round6(max) }, steps };
+      return { total: { currency, min: round6(min), max: round6(max), ...(incomplete ? { incomplete: true } : {}) }, steps };
     }
     default:
       throw new Error(`unknown tool: ${name}`);

package/src/search.js

@@ -119,6 +119,9 @@ async function buildOfferings(store) {
   return out;
 }
 
+/** Whether an offering publishes a per-token price (imports with no known price leave it out). */
+export const pricePublished = (pricing) => pricing?.input_per_mtok != null || pricing?.output_per_mtok != null;
+
 /** Search returning the page plus the total number of matches (before `limit`). */
 export async function searchOfferingsPaged(store, query) {
   let items = await collectOfferings(store);

package/src/server.js

@@ -15,7 +15,7 @@ import { runStageB, captureFingerprints } from './stageb.js';
 import { startStageC } from './stagec.js';
 import { startReimport } from './reimport.js';
 import { makeSafeFetch } from './safefetch.js';
-import { searchOfferings, searchOfferingsPaged, collectOfferings, watchStoreWrites, RANK_COMPONENTS } from './search.js';
+import { searchOfferings, searchOfferingsPaged, collectOfferings, watchStoreWrites, RANK_COMPONENTS, pricePublished } from './search.js';
 import { mcpRoutes } from './mcp.js';
 import { hostControlsNamespace, isPrivateHost, makeRateLimiter } from './namespace.js';
 import { exportRoutes } from './export.js';
@@ -366,7 +366,7 @@ export async function startRegistry({
       if (!Array.isArray(steps) || steps.length === 0) return problem(res, 400, 'missing-steps', 'body must be {"steps": [...]}');
       const all = await collectOfferings(store);
       const out = [];
-      let min = 0, max = 0;
+      let min = 0, max = 0, incomplete = false;
       let currency = 'USD';
       for (const step of steps) {
         let offering;
@@ -385,13 +385,16 @@ export async function startRegistry({
         const bounds = estimateBounds(offering.pricing, step.est_input_tokens ?? 0, step.est_output_tokens ?? 0);
         currency = offering.pricing.currency;
         min += bounds.min; max += bounds.max;
+        // No published per-token price: the step's cost is unknown, not zero.
+        const unpriced = !pricePublished(offering.pricing);
+        incomplete ||= unpriced;
         out.push({
           offering: `${offering.node_id}/${offering.offering_id}`,
           card_revision: offering.card_revision,
-          cost: { currency: offering.pricing.currency, ...bounds },
+          cost: { currency: offering.pricing.currency, ...bounds, ...(unpriced ? { price_published: false } : {}) },
         });
       }
-      sendJson(res, 200, { total: { currency, min: round6(min), max: round6(max) }, steps: out });
+      sendJson(res, 200, { total: { currency, min: round6(min), max: round6(max), ...(incomplete ? { incomplete: true } : {}) }, steps: out });
     }],
 
     // ONP-3 §5b: task → ranked offerings with estimate + explanation. Accepts either a

package/src/web/index.html

@@ -47,6 +47,13 @@
   .mitem .t .nm { font-weight: 600; font-size: 0.86rem; flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
   .mitem .b { display: flex; gap: 0.8rem; margin-top: 0.25rem; font-size: 0.7rem; color: var(--muted); font-variant-numeric: tabular-nums; flex-wrap: wrap; }
   .mdetail { min-height: 30rem; }
+  .scorebox { margin: 0.4rem 0 0.8rem; border: 1px solid var(--line); border-radius: 6px; background: var(--panel); padding: 0.5rem 0.75rem; font-size: 0.8rem; }
+  .scorebox summary { cursor: pointer; }
+  .scorebox table { width: 100%; border-collapse: collapse; margin-top: 0.4rem; }
+  .scorebox td { padding: 0.2rem 0.5rem 0.2rem 0; border-top: 1px solid var(--line-2); vertical-align: top; }
+  .scorebox td.num { text-align: right; white-space: nowrap; }
+  .scorebox td.sub { font-size: 0.74rem; }
+  .scorebox tr.tot td { border-top: 1px solid var(--line); }
   .pager { display: flex; align-items: center; justify-content: center; gap: 0.3rem; margin-top: 0.5rem; font-size: 0.78rem; color: var(--muted); flex-wrap: wrap; }
   .pager:empty { display: none; }
   .pgbtn { font: inherit; min-width: 2rem; padding: 0.25rem 0.5rem; border-radius: 6px; border: 1px solid var(--line); background: var(--panel); color: var(--accent); cursor: pointer; }
@@ -267,6 +274,7 @@
   </div>
   <p class="desc" id="md-desc" hidden></p>
   <div class="statstrip" id="md-stats"></div>
+  <div id="md-score"></div>
   <div class="secnav" id="md-nav"></div>
   <h2 id="sec-offerings">Offerings <span class="counts" id="md-count"></span></h2>
   <div class="panel tablewrap" id="md-offerings"></div>
@@ -526,7 +534,10 @@ const ago = (iso) => {
   return Math.round(s / 86400) + 'd ago';
 };
 const tierChip = (t) => `<span class="chip t-${esc(t)}">${esc(String(t).toUpperCase())}</span>`;
-const priceStr = (p) => {
+const SUBSCRIPTION_NODE = /token-plan|\.gitlab$/;
+const pricePublished = (p) => p && (p.input_per_mtok != null || p.output_per_mtok != null);
+const priceStr = (p, nodeId = '') => {
+  if (!pricePublished(p)) return SUBSCRIPTION_NODE.test(nodeId) ? 'in a subscription plan' : 'price not published';
   const i = p.input_per_mtok ?? 0, o = p.output_per_mtok ?? 0;
   return (i === 0 && o === 0) ? 'free' : `$${fmt(i)} / $${fmt(o)} per MTok`;
 };
@@ -726,8 +737,10 @@ function renderAdvice(r) {
   });
 }
 
+let listedOffering = null;   // the list entry the detail was opened from: its score is explained there
 function selectModel(el) {
   document.querySelectorAll('.mitem').forEach((x) => x.classList.toggle('sel', x === el));
+  listedOffering = lastResults.find((o) => `${o.node_id}/${o.offering_id}` === el.dataset.key) ?? null;
   const host = $('#m-detail');
   if (!host.contains($('#model-card'))) { host.innerHTML = ''; host.appendChild($('#model-card')); }
   loadModel(el.dataset.artifact);
@@ -736,14 +749,14 @@ function selectModel(el) {
 let lastResults = [];
 function renderItem(o) {
   const obs = o.observed || {};
-  return `<div class="mitem" data-artifact="${esc(o.model.artifact)}">
+  return `<div class="mitem" data-artifact="${esc(o.model.artifact)}" data-key="${esc(o.node_id + '/' + o.offering_id)}">
     <div class="t">
       <span class="nm">${esc(o.model.name)}</span>
       ${tierChip(o.tier)}
       ${o.local ? '<span class="chip loc">LOCAL</span>' : (o.source === 'import' ? '<span class="chip imp">IMP</span>' : '')}
     </div>
     <div class="b">
-      <span><b style="color:var(--ink)">${priceStr(o.pricing)}</b></span>
+      <span><b style="color:var(--ink)">${priceStr(o.pricing, o.node_id)}</b></span>
       ${o.serving?.context_window ? `<span>ctx ${fmtInt(o.serving.context_window)}${o.serving.context_capped_from ? ' <span class="micro m-warn">▼</span>' : ''}</span>` : (o.serving?.context_capped_from ? '<span>ctx <span class="micro m-warn">unverified</span></span>' : '')}
       ${obs.ttft_ms?.p50 != null ? `<span>${obs.ttft_ms.p50}ms <span class="micro m-measured">●</span></span>` : ''}
       <span class="mono">${fmt(o.rank)}</span>
@@ -804,7 +817,7 @@ window.toggleRow = async function (el, idx) {
       ? others.slice(0, 5).map((x) => `<div class="alsorow">
           <a href="#/node/${encodeURIComponent(x.node_id)}" class="mono" style="font-size:0.72rem">${esc(x.node_id)}</a>
           ${tierChip(x.tier)}
-          <span class="num" style="color:var(--muted)">${priceStr(x.pricing)}</span>
+          <span class="num" style="color:var(--muted)">${priceStr(x.pricing, x.node_id)}</span>
           ${x.observed?.ttft_ms?.p50 != null ? `<span class="num" style="color:var(--muted)">${x.observed.ttft_ms.p50}ms <span class="micro m-measured">●</span></span>` : ''}
         </div>`).join('') + (others.length > 5 ? `<div class="alsorow"><a href="#/model/${encodeURIComponent(o.model.artifact)}">+${others.length - 5} more on the model page</a></div>` : '')
       : 'no other nodes serve this exact artifact';
@@ -828,7 +841,7 @@ function renderRow(o, idx) {
       </span>
     </div>
     <div class="l2 num">
-      <span><b>${priceStr(o.pricing)}</b></span>
+      <span><b>${priceStr(o.pricing, o.node_id)}</b></span>
       ${ctxBit(o)}
       ${measuredBits(o).join('')}
       ${(o.serving?.supports || []).filter((s) => s !== 'streaming').map((s) => `<span class="chip">${esc(s)}</span>`).join('')}
@@ -839,6 +852,35 @@ function renderRow(o, idx) {
 }
 
 /* ---------- model detail ---------- */
+// How the list's ranking score for the selected entry was computed: weight × component per part.
+function renderScore(artifact) {
+  const host = $('#md-score');
+  const o = listedOffering;
+  if (!o?.rank_explanation || o.model.artifact !== artifact) { host.innerHTML = ''; return; }
+  const { weights, components } = o.rank_explanation;
+  const obs = o.observed || {};
+  const why = {
+    price: o.pricing?.input_per_mtok == null ? `${priceStr(o.pricing, o.node_id)} — no price points`
+      : `${o.pricing.input_per_mtok === 0 ? 'free' : '$' + fmt(o.pricing.input_per_mtok) + '/MTok in'} — position among the listed results (cheapest 1.00, dearest 0.00)`,
+    tier: {
+      verified: 'verified: passed identity, context and capacity checks',
+      community: 'community: passed the registration checks',
+      attested: 'attested by a third party',
+    }[o.tier] ?? (o.source === 'import' ? 'unverified: imported from a public catalog, not checked by this registry' : 'unverified: not checked yet'),
+    probe_success: obs.probes > 0 ? `${Math.round((obs.probe_success ?? 0) * obs.probes)} of the last ${obs.probes} checks passed` : 'no checks yet',
+  };
+  const label = { price: 'Price', tier: 'Trust tier', probe_success: 'Check pass rate' };
+  const rows = Object.keys(weights).map((k) => `<tr>
+      <td>${label[k] ?? esc(k)}</td>
+      <td class="num mono">${fmt(components[k] ?? 0)} × ${fmt(weights[k])}</td>
+      <td class="num mono"><b>${fmt((components[k] ?? 0) * weights[k])}</b></td>
+      <td class="sub">${esc(why[k] ?? '')}</td></tr>`).join('');
+  host.innerHTML = `<details class="scorebox" open>
+    <summary>Ranking score <b class="mono">${fmt(o.rank)}</b> <span class="sub">for ${esc(o.node_id)} in the current list</span></summary>
+    <table>${rows}<tr class="tot"><td>Total</td><td></td><td class="num mono"><b>${fmt(o.rank)}</b></td><td class="sub">weighted sum; measured values, never paid placement</td></tr></table>
+  </details>`;
+}
+
 async function loadModel(artifact) {
   $('#model-card').dataset.artifact = artifact;
   $('#md-crumb').innerHTML = '<a href="#/">Models</a> / ' + esc(artifact);
@@ -850,7 +892,7 @@ async function loadModel(artifact) {
     const list = offerings.filter((o) => o.model.artifact === artifact);
     if (!list.length) { $('#md-title').textContent = 'Not found'; return; }
     const tierOrder = { verified: 3, community: 2, unverified: 1 };
-    list.sort((a, b) => (tierOrder[b.tier] ?? 0) - (tierOrder[a.tier] ?? 0) || (a.pricing.input_per_mtok ?? 0) - (b.pricing.input_per_mtok ?? 0));
+    list.sort((a, b) => (tierOrder[b.tier] ?? 0) - (tierOrder[a.tier] ?? 0) || (a.pricing.input_per_mtok ?? Infinity) - (b.pricing.input_per_mtok ?? Infinity));
     const first = list[0];
     $('#md-title').textContent = first.model.name;
     // the artifact chip links to its authoritative home: Hugging Face for hf: artifacts
@@ -878,27 +920,29 @@ async function loadModel(artifact) {
     if (desc) $('#md-desc').textContent = desc;
 
     // stats strip: aggregate honestly across serving nodes
-    const prices = list.map((o) => o.pricing.input_per_mtok ?? 0);
+    const prices = list.filter((o) => pricePublished(o.pricing)).map((o) => o.pricing.input_per_mtok ?? 0);
     const minP = Math.min(...prices), maxP = Math.max(...prices);
     const ctxMax = Math.max(...list.map((o) => o.serving?.context_window ?? 0), 0);
     const verified = list.filter((o) => o.tier === 'verified').length;
     const released = list.map((o) => o.model.released).find(Boolean);
     const stat = (v, l) => `<span class="stat"><span class="sv">${v}</span><span class="sl">${l}</span></span>`;
     $('#md-stats').innerHTML = [
-      stat(minP === 0 && maxP === 0 ? 'free' : (minP === maxP ? '$' + fmt(minP) : '$' + fmt(minP) + '–' + fmt(maxP)), '$/MTOK IN ACROSS NODES'),
+      stat(!prices.length ? priceStr(first.pricing, first.node_id) : minP === 0 && maxP === 0 ? 'free' : (minP === maxP ? '$' + fmt(minP) : '$' + fmt(minP) + '–' + fmt(maxP)), '$/MTOK IN ACROSS NODES'),
       ctxMax ? stat(fmtInt(ctxMax), 'MAX CONTEXT') : '',
       stat(`${verified}/${list.length}`, 'VERIFIED NODES'),
       released ? stat(esc(released), 'RELEASED') : '',
       first.modalities ? stat(esc((first.modalities.input || []).join('+')) + ' → ' + esc((first.modalities.output || []).join('+')), 'MODALITIES') : '',
     ].filter(Boolean).join('');
 
+    renderScore(artifact);
+
     // section nav (anchors appear only for sections that render)
     const navBits = [['#sec-offerings', 'OFFERINGS'], ['#sec-play', 'PLAYGROUND']];
 
     // playground targets: this page's offerings + a custom endpoint (e.g. local Ollama)
     pgOfferings = list.filter(invocable);
     $('#pg-target').innerHTML = pgOfferings.map((o, i) =>
-      `<option value="${i}">${esc(o.node_id)} — ${priceStr(o.pricing)} [${esc(o.tier)}]</option>`).join('')
+      `<option value="${i}">${esc(o.node_id)} — ${priceStr(o.pricing, o.node_id)} [${esc(o.tier)}]</option>`).join('')
       + '<option value="custom">custom endpoint (your local Ollama / any OpenAI-compatible server)</option>';
     $('#pg-customrow').hidden = pgOfferings.length > 0;   // listing-only offerings leave just the custom endpoint
     $('#pg-out').textContent = '';
@@ -921,7 +965,7 @@ async function loadModel(artifact) {
           <a href="#/node/${encodeURIComponent(o.node_id)}" style="font-weight:600">${esc(o.node_id)}</a>
           <span style="display:flex; gap:0.3rem">${tierChip(o.tier)}${o.institutional ? '<span class="chip inst">institutional</span>' : ''}${o.source === 'import' ? '<span class="chip imp">IMPORTED</span>' : ''}</span>
         </div></td>
-        <td><b>${priceStr(o.pricing)}</b></td>
+        <td><b>${priceStr(o.pricing, o.node_id)}</b></td>
         <td>${hwStr(o) || '<span style="color:var(--faint)" title="Vendor has not disclosed the hardware behind this offering">undisclosed</span>'}</td>
         <td>${ctx}</td>
         <td>${ttft}</td>
@@ -962,7 +1006,7 @@ async function loadModel(artifact) {
           $('#md-relsec').innerHTML = `<h2 id="sec-related">More from ${esc(first.model.family)}</h2><div class="relcards">` +
             cards.map((r) => `<a class="relcard" href="#/model/${encodeURIComponent(r.model.artifact)}">
               <span class="rn">${esc(r.model.name)}</span>
-              <span class="rm">${esc(r.modality)} · ${priceStr(r.pricing)}</span></a>`).join('') + '</div>';
+              <span class="rm">${esc(r.modality)} · ${priceStr(r.pricing, r.node_id)}</span></a>`).join('') + '</div>';
           navBits.push(['#sec-related', 'RELATED']);
         }
       } catch { /* related is optional */ }
@@ -1064,7 +1108,7 @@ async function loadChatTargets() {
       const local = rest.filter((o) => o.local);            // Ollama library: runs on the visitor's own machine
       const imports = rest.filter((o) => !o.local);
       chat.offerings = [...ready, ...local, ...imports];
-      const opt = (o, i) => `<option value="${i}">${esc(o.model.name)} — ${esc(o.node_id)} — ${priceStr(o.pricing)}</option>`;
+      const opt = (o, i) => `<option value="${i}">${esc(o.model.name)} — ${esc(o.node_id)} — ${priceStr(o.pricing, o.node_id)}</option>`;
       $('#ch-add').innerHTML = '<option value="">+ Add a model…</option>'
         + (ready.length ? `<optgroup label="Ready to use — no key needed (${ready.length})">${ready.map((o, i) => opt(o, i)).join('')}</optgroup>` : '')
         + (local.length ? `<optgroup label="On your machine — needs a local Ollama with this model pulled">${local.map((o, i) => opt(o, ready.length + i)).join('')}</optgroup>` : '')
@@ -1864,7 +1908,7 @@ async function loadNode(id) {
     const offerRows = offers.slice(0, 50).map((o) => `<tr>
       <td><a href="#/model/${encodeURIComponent(o.model?.artifact ?? '')}" style="font-weight:600">${esc(o.model?.name ?? o.offering_id)}</a></td>
       <td><span class="chip">${esc(o.modality)}</span></td>
-      <td class="num"><b>${priceStr(o.pricing || {})}</b></td>
+      <td class="num"><b>${priceStr(o.pricing || {}, o.node_id)}</b></td>
       <td>${hwStr({ hardware: o.hardware ?? card.hardware }) || '<span style="color:var(--faint)">undisclosed</span>'}</td>
       <td class="num">${o.serving?.context_window ? fmtInt(o.serving.context_window) : '—'}</td>
       <td>${(o.serving?.supports || []).filter((s) => s !== 'streaming').map((s) => `<span class="chip">${esc(s)}</span>`).join(' ') || '—'}</td>