node-red-contrib-vectorprime 0.1.40 → 0.1.42

package/README.md

@@ -1,70 +1,57 @@
 # node-red-contrib-vectorprime
+### VectorPrime — Decision Ranking for Node-RED
 
-**VectorPrime Rank** — automatically rank tasks, alerts, or decisions using the VectorPrime Decision Kernel (**Contract v1**).
+**node-red-contrib-vectorprime** lets you rank tasks, alerts, or actions inside Node-RED when multiple options compete.
 
-This node helps you pick the **best next action** when you have multiple choices — **without faking certainty**.
-
-✅ Prioritize tasks  
-✅ Rank alerts by urgency  
-✅ Choose the best option from multiple choices  
-✅ Turn “too many choices” into a safe automation decision state  
-✅ Works inside Node-RED flows with 1 click  
-
----
-
-## What it does (in 1 sentence)
-
-**Send a list of options → get them ranked best-to-worst with probabilities + metadata you can branch on.**
+Instead of hard-coding rules, VectorPrime helps flows choose the **safest, most urgent, or most rational next step** automatically.
 
 ---
 
-## Why developers install this
+## 🧠 What this node does (plain English)
 
-Most automation flows break down when you have **multiple possible actions** and don’t know which one to run.
+You send VectorPrime a list of options (tasks, actions, alerts). Each option can include simple metadata like urgency, impact, deadline, or effort.
 
-VectorPrime solves that by turning this:
+VectorPrime returns:
+- A ranked list (best → worst)
+- Probabilities / confidence signals (when provided)
+- Metadata about the ranking
 
-- “Which alert should fire first?”
-- “Which ticket should I do next?”
-- “Which customer should get priority?”
-- “Which action gives the best outcome with least risk?”
-- “Which fix should I deploy first?”
-
-Into:
-
-✅ A **ranked result** when the input supports a winner  
-✅ Or a **tie / no-dominant outcome** (so your flow can branch safely)
+This turns Node-RED into a **decision-aware automation engine**, not just `if/else`.
 
 ---
 
-## Nodes Included
+## 📦 Nodes included
 
 - **VectorPrime Config**  
-  Stores your VectorPrime Base URL + API Key.
+  Stores Base URL + API key securely using Node-RED credentials (not exported with flows).
 
-- **VectorPrime Rank**  
-  Sends options to VectorPrime (`/v1/kernel/rank`) and returns the ranked result.
+- **Rank Decision (VectorPrime)**  
+  Sends options to the VectorPrime Rank API and returns ranked results.
 
 ---
 
-## Install
+## ⚡ Quick start (5 minutes)
 
-### Option A: Install from the Node-RED palette (recommended)
-1) Open Node-RED in your browser  
-2) Click the menu (top-right) ☰  
-3) Click **Manage palette**  
-4) Click the **Install** tab  
-5) Search: `node-red-contrib-vectorprime`  
-6) Click **Install**
+1. Open Node-RED
+2. Menu ☰ → **Manage Palette** → **Install**
+3. Search for: **node-red-contrib-vectorprime**
+4. Install
+5. Drag **Rank Decision (VectorPrime)** into a flow
+6. Create/select a **VectorPrime Config** and click **Get Free Key**
+7. Inject one of the examples below into `msg.payload`
 
-### Option B: Install from terminal (Node-RED user directory)
-
-Open your Node-RED user directory:
+---
 
-- **Windows:** `C:\Users\<you>\.node-red`
-- **macOS/Linux:** `~/.node-red`
+## ✅ Input format (simple) — `items[]` (recommended)
 
-Then run:
+The node will automatically convert `items[]` into the backend’s required `options[]` format.
 
-```bash
-npm install node-red-contrib-vectorprime
+```json
+{
+  "items": [
+    { "id": "payroll", "label": "Fix payroll outage", "urgency": 10, "impact": 10, "effort": 3 },
+    { "id": "email", "label": "Reply to customer email", "urgency": 4, "impact": 5, "effort": 2 },
+    { "id": "deploy", "label": "Ship small hotfix", "urgency": 7, "impact": 7, "effort": 4 }
+  ],
+  "prompt": "Rank the best next action."
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "node-red-contrib-vectorprime",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "Rank tasks, alerts, or actions inside Node-RED when multiple options compete. Choose the safest next step automatically instead of hard-coded rules.",
   "license": "MIT",
   "author": "Faisal Khan",
   "homepage": "https://gitlab.com/faisalkhan3000/vectorprime-node-red-node",
   "repository": {
     "type": "git",
-    "url": "https://gitlab.com/faisalkhan3000/vectorprime-node-red-node.git"
+    "url": "git+https://gitlab.com/faisalkhan3000/vectorprime-node-red-node.git"
   },
   "bugs": {
     "url": "https://gitlab.com/faisalkhan3000/vectorprime-node-red-node/-/issues"

package/vectorprime.html

@@ -1,5 +1,6 @@
 <!-- =========================
    VectorPrime Config Template
+   WEBSITE-ONLY KEYS (no minting inside Node-RED)
 ========================= -->
 <script type="text/x-red" data-template-name="vectorprime-config">
   <div class="form-row">
@@ -9,26 +10,19 @@
     <input type="text" id="node-config-input-baseUrl" placeholder="https://vectorprime-kernel-backend.onrender.com">
   </div>
 
-  <!-- ✅ REQUIRED: email for /v1/billing/signup -->
-  <div class="form-row">
-    <label for="node-config-input-email">
-      <i class="fa fa-envelope"></i> Email
-    </label>
-    <input type="text" id="node-config-input-email" placeholder="you@example.com">
-  </div>
-
   <div class="form-row">
     <label for="node-config-input-apiKey">
       <i class="fa fa-key"></i> API Key
     </label>
-    <input type="password" id="node-config-input-apiKey" placeholder="vp_free_...">
+    <input type="password" id="node-config-input-apiKey" placeholder="vp_live_...">
   </div>
 
   <div class="form-row">
-    <button id="vp-get-free-key" class="red-ui-button">
-      Get Free Key
-    </button>
-    <span id="vp-key-status" style="margin-left:10px; font-size:12px;"></span>
+    <div style="font-size:12px; color:#666; line-height:1.4;">
+      Get your API key from
+      <a href="https://vectorprime.tech" target="_blank" rel="noopener noreferrer">vectorprime.tech</a>,
+      then paste it above.
+    </div>
   </div>
 
   <div class="form-row">
@@ -50,8 +44,7 @@
     RED.nodes.registerType("vectorprime-config", {
       category: "config",
       defaults: {
-        baseUrl: { value: "https://vectorprime-kernel-backend.onrender.com", required: true },
-        email: { value: "", required: true }
+        baseUrl: { value: "https://vectorprime-kernel-backend.onrender.com", required: true }
       },
       credentials: {
         apiKey: { type: "password" }
@@ -60,65 +53,16 @@
         return "VectorPrime Config";
       },
       oneditprepare: function () {
-        const statusEl = document.getElementById("vp-key-status");
-        const btn = document.getElementById("vp-get-free-key");
-
-        btn.onclick = async function (e) {
-          e.preventDefault();
-          statusEl.textContent = "Requesting free key...";
-          statusEl.style.color = "#444";
-
-          try {
-            const baseUrlInput = document.getElementById("node-config-input-baseUrl");
-            const emailInput = document.getElementById("node-config-input-email");
-            const apiKeyInput = document.getElementById("node-config-input-apiKey");
-
-            const baseUrl = normalizeBaseUrl(baseUrlInput.value);
-            const email = ((emailInput && emailInput.value) ? emailInput.value : "").trim();
-
-            if (!baseUrl.startsWith("http")) {
-              statusEl.textContent = "❌ Base URL missing/invalid";
-              statusEl.style.color = "red";
-              return;
-            }
-
-            if (!email || !email.includes("@")) {
-              statusEl.textContent = "❌ Enter a valid email";
-              statusEl.style.color = "red";
-              return;
-            }
-
-            // ✅ Call REAL backend endpoint that exists
-            const resp = await fetch(`${baseUrl}/v1/billing/signup`, {
-              method: "POST",
-              headers: { "Content-Type": "application/json" },
-              body: JSON.stringify({ email: email })
-            });
-
-            const text = await resp.text();
-            let data;
-            try { data = JSON.parse(text); } catch { data = { raw: text }; }
-
-            if (!resp.ok) {
-              statusEl.textContent = `❌ Failed (${resp.status}): ${data.message || data.error || data.detail || "unknown"}`;
-              statusEl.style.color = "red";
-              return;
-            }
-
-            if (!data.api_key) {
-              statusEl.textContent = "❌ Backend did not return api_key";
-              statusEl.style.color = "red";
-              return;
-            }
-
-            apiKeyInput.value = data.api_key;
-            statusEl.textContent = "✅ Free key generated + saved";
-            statusEl.style.color = "green";
-          } catch (err) {
-            statusEl.textContent = `❌ Error: ${err.message}`;
-            statusEl.style.color = "red";
-          }
-        };
+        const baseUrlInput = document.getElementById("node-config-input-baseUrl");
+        if (baseUrlInput && baseUrlInput.value) {
+          baseUrlInput.value = normalizeBaseUrl(baseUrlInput.value);
+        }
+      },
+      oneditsave: function () {
+        const baseUrlInput = document.getElementById("node-config-input-baseUrl");
+        if (baseUrlInput && baseUrlInput.value) {
+          baseUrlInput.value = normalizeBaseUrl(baseUrlInput.value);
+        }
       }
     });
   })();
@@ -131,8 +75,8 @@
   <h3>Quick Setup</h3>
   <ol>
     <li>Set <b>Base URL</b> (default is already correct)</li>
-    <li>Enter your <b>Email</b></li>
-    <li>Click <b>Get Free Key</b></li>
+    <li>Get your API key from <b>vectorprime.tech</b></li>
+    <li>Paste the key into <b>API Key</b></li>
     <li>Click <b>Done</b></li>
   </ol>
 
@@ -142,11 +86,6 @@
 
   <h3>Recommended Base URL</h3>
   <pre>https://vectorprime-kernel-backend.onrender.com</pre>
-
-  <h3>Tip</h3>
-  <p>
-    You can also paste your own paid key here if you want higher limits.
-  </p>
 </script>
 
 <hr />

package/vectorprime.js

@@ -25,10 +25,6 @@ module.exports = function (RED) {
         return Number.isFinite(n) ? n : null;
     }
 
-    function almostEqual(a, b, eps = 1e-9) {
-        return Math.abs(a - b) <= eps;
-    }
-
     function isFlatProbabilities(probObj) {
         if (!probObj || typeof probObj !== "object") return false;
         const keys = Object.keys(probObj);
@@ -87,6 +83,7 @@ module.exports = function (RED) {
 
     // -----------------------------
     // Config Node (stores Base URL + API Key)
+    // WEBSITE-ONLY KEYS: no email, no "Get Free Key" minting
     // -----------------------------
     function VectorPrimeConfigNode(n) {
         RED.nodes.createNode(this, n);
@@ -95,9 +92,8 @@ module.exports = function (RED) {
             (n.baseUrl && String(n.baseUrl).trim()) ||
             "https://vectorprime-kernel-backend.onrender.com";
 
-        // NOTE: email is stored as a normal config property (not credentials).
-        // Runtime node doesn't need it; editor uses it to request keys.
-        this.email = (n.email && String(n.email).trim()) || "";
+        // NOTE: apiKey is stored in credentials only.
+        // No email stored here anymore (website-only keys).
     }
 
     RED.nodes.registerType("vectorprime-config", VectorPrimeConfigNode, {
@@ -145,7 +141,7 @@ module.exports = function (RED) {
                 if (!storedKey) {
                     node.status({ fill: "red", shape: "ring", text: "missing api key" });
                     throw new Error(
-                        "No API key. Open VectorPrime Config and click 'Get Free Key' or paste your paid key."
+                        "No API key. Get your key from vectorprime.tech and paste it into the VectorPrime Config."
                     );
                 }
 
@@ -214,15 +210,13 @@ module.exports = function (RED) {
                 }
 
                 // -----------------------------
-                // ✅ FIX: If backend returns a tie/flat result, do deterministic local ranking
-                // This prevents users from seeing "random" / "input-order" ranking.
+                // ✅ If backend returns a tie/flat result, do deterministic local ranking
                 // -----------------------------
                 const tieBreak =
                     data && data.meta && typeof data.meta === "object"
                         ? data.meta.tie_break
                         : null;
 
-                const hasRanking = Array.isArray(data && data.ranking);
                 const hasProb = data && data.probabilities;
 
                 const looksTied =
@@ -269,4 +263,4 @@ module.exports = function (RED) {
     }
 
     RED.nodes.registerType("vectorprime-rank", VectorPrimeRankNode);
-};
+};