llm-entropy-filter 1.0.0

package/LICENSE

@@ -0,0 +1,93 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Ernesto Rosati
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+--------------------------------------------------------------------
+
+Apache License
+Version 2.0, January 2004
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form.
+
+"Work" shall mean the work of authorship made available under the License.
+
+"Derivative Works" shall mean any work based upon the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor
+hereby grants You a perpetual, worldwide, non-exclusive, no-charge,
+royalty-free, irrevocable copyright license to reproduce, prepare
+Derivative Works of, publicly display, publicly perform, sublicense,
+and distribute the Work.
+
+3. Grant of Patent License.
+
+Each Contributor hereby grants You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable patent license
+to make, use, sell, offer to sell, import, and otherwise transfer
+the Work.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work provided that
+You give recipients a copy of this License and retain attribution notices.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally
+submitted for inclusion in the Work shall be under the terms of this License.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor.
+
+7. Disclaimer of Warranty.
+
+The Work is provided "AS IS", WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+8. Limitation of Liability.
+
+In no event shall any Contributor be liable for damages arising from
+the use of the Work.
+
+9. Accepting Warranty or Additional Liability.
+
+You may offer support or warranty protection for a fee, but only
+on Your own behalf and responsibility.

package/README.md

@@ -0,0 +1,178 @@
+README.md reescrito (v1.0.0 listo para publicar)
+
+Basado en tu README actual 
+
+README (5)
+
+, aquí va una versión limpia, con tus métricas reales, endpoints, bench y dataset.
+
+Copia y pega esto como README.md:
+
+# llm-entropy-filter
+
+Minimal, fast **entropy + intent gate** for LLM inputs.
+
+This package runs a **local, deterministic heuristic gate** to detect high-entropy / low-signal inputs (spam, coercion, vague conspiracies, pseudo-science, truth relativism, broken causality) and returns an **ALLOW / WARN / BLOCK** verdict.
+
+Use it **before** calling an LLM to reduce hallucinations, cost, and risk.
+
+---
+
+## What you get
+
+### Core (library)
+- `gate(text)` → `{ action, entropy_score, flags, intention, confidence, rationale }`
+- `gateLLM(text)` → alias of `gate(text)` (kept for compatibility)
+- `runEntropyFilter(text)` → underlying entropy + intention analysis utilities
+
+### Demo (server)
+- `POST /analyze` → runs local `gate(text)` + returns `meta.ts` + `meta.version`
+- `POST /triad` → optional OpenAI analysis (only if `OPENAI_API_KEY` is set)
+
+---
+
+## Install
+
+```bash
+npm i llm-entropy-filter
+
+Quickstart (library)
+import { gate } from "llm-entropy-filter";
+
+const r = gate("¡¡COMPRA YA!! Oferta limitada 90% OFF $$$");
+console.log(r);
+
+
+Example output:
+
+{
+  "action": "BLOCK",
+  "entropy_score": 0.7,
+  "flags": ["urgency","spam_sales","money_signal","shouting"],
+  "intention": "marketing_spam",
+  "confidence": 0.85,
+  "rationale": "Detecté señales de venta agresiva/urgencia/dinero."
+}
+
+Demo server (Express)
+
+Start:
+
+npm run serve
+
+
+Health:
+
+curl -s http://127.0.0.1:3000/health
+
+
+Local gate:
+
+curl -s -X POST http://127.0.0.1:3000/analyze \
+  -H "Content-Type: application/json" \
+  -d '{"text":"Congratulations! You won a FREE iPhone. Click here to claim now!"}' | jq .
+
+
+You will also see:
+
+"meta": { "ts": 1769546511060, "version": "1.0.0" }
+
+Optional: OpenAI triad demo
+export OPENAI_API_KEY="YOUR_KEY"
+export OPENAI_MODEL="gpt-4.1-mini"
+
+curl -s -X POST http://127.0.0.1:3000/triad \
+  -H "Content-Type: application/json" \
+  -d '{"text":"Vivimos en una simulación y todos lo esconden."}' | jq .
+
+
+/triad is a demo layer. The product is the local gate().
+
+Benchmarks (measured)
+HTTP gate /analyze (local, deterministic)
+
+Command:
+
+npx autocannon -m POST -c 30 -d 10 --renderStatusCodes \
+  http://127.0.0.1:3000/analyze \
+  -H "Content-Type: application/json" \
+  -b '{"text":"Congratulations. You won a FREE iPhone. Click here to claim now."}'
+
+
+Observed (typical run):
+
+~5.2k req/s
+
+~5.1 ms avg latency (p50 ~4 ms)
+
+LLM demo /triad (OpenAI)
+
+Command:
+
+npx autocannon -m POST -c 2 -d 30 --renderStatusCodes \
+  http://127.0.0.1:3000/triad \
+  -H "Content-Type: application/json" \
+  -b '{"text":"Texto real de prueba (1-3 párrafos) ..."}'
+
+
+Observed (typical run):
+
+~1.7 req/s
+
+~1.17 s avg latency
+
+Dataset mini + bench script (no HTTP)
+
+A tiny CSV lives at:
+
+bench/sms_spam.csv
+
+Run the bench:
+
+node bench/sms_spam_bench.mjs bench/sms_spam.csv
+cat bench/reports/sms_spam_report.md
+
+
+Typical report:
+
+Throughput: ~9–10k samples/sec
+
+Actions: ALLOW / WARN / BLOCK distribution
+
+Confusion table (ground truth spam/ham → action)
+
+Top flags + intentions
+
+JSON + Markdown reports written to bench/reports/
+
+Design goals
+
+Fast: pure heuristics, no network calls
+
+Portable: works in any Node environment
+
+Composable: middleware/wrapper before calling an LLM
+
+Transparent: flags explain why an input is risky
+
+Observable: /analyze returns meta.ts and meta.version
+
+Roadmap
+
+Expand multilingual spam patterns
+
+Optional suggested_rewrite to lower entropy
+
+Example integrations: Next.js / Vercel, Express, Cloudflare Workers
+
+Extended dataset benches + cost-savings estimates
+
+License
+
+Apache-2.0
+
+Copyright (c) 2026 Ernesto Rosati
+
+
+---
+

package/dist/index.cjs

@@ -0,0 +1,265 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  analyzeEntropy: () => analyzeEntropy,
+  entropyMiddleware: () => entropyMiddleware,
+  evaluateIntention: () => evaluateIntention,
+  gate: () => gateLLM,
+  gateLLM: () => gateLLM,
+  runEntropyFilter: () => runEntropyFilter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/entropy.ts
+function clamp01(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function countRegex(text, re) {
+  const m = text.match(re);
+  return m ? m.length : 0;
+}
+function analyzeEntropy(text) {
+  const raw = text || "";
+  const t = raw.toLowerCase();
+  const flags = [];
+  let score = 0;
+  if (/\b(ahora|ya|urgente|última|hoy|inmediato)\b/.test(t)) {
+    flags.push("urgency");
+    score += 0.2;
+  }
+  if (/\b(compra|oferta|promo|descuento|gratis|clic|click|off)\b/.test(t)) {
+    flags.push("spam_sales");
+    score += 0.25;
+  }
+  const moneyHits = countRegex(raw, /\$+/g);
+  if (moneyHits > 0) {
+    flags.push("money_signal");
+    score += Math.min(0.2, moneyHits * 0.05);
+  }
+  const exclam = countRegex(raw, /!/g);
+  const capsRatio = (() => {
+    const letters = raw.match(/[A-Za-zÁÉÍÓÚÜÑáéíóúüñ]/g) || [];
+    if (letters.length === 0) return 0;
+    const caps = (raw.match(/[A-ZÁÉÍÓÚÜÑ]/g) || []).length;
+    return caps / letters.length;
+  })();
+  if (exclam >= 3 || capsRatio >= 0.35) {
+    flags.push("shouting");
+    score += 0.2;
+  }
+  if (/\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\b/.test(t)) {
+    flags.push("emotional_manipulation");
+    score += 0.35;
+  }
+  if (/\b(todos lo saben|lo esconden|la verdad oculta|ellos no quieren|simulación)\b/.test(t)) {
+    flags.push("conspiracy_vague");
+    score += 0.2;
+  }
+  if (/\b(la cultura lo prueba|es obvio|todo mundo sabe|se sabe|está claro)\b/.test(t)) {
+    flags.push("weak_evidence");
+    score += 0.2;
+  }
+  if (/\b(ellos|la élite|los de arriba)\b/.test(t) && /\b(esconden|ocultan|tapan)\b/.test(t)) {
+    flags.push("hidden_actor");
+    score += 0.15;
+  }
+  if (/\b(física cuántica|cuantica|cuántico|quantum)\b/.test(t)) {
+    flags.push("pseudo_science_quantum");
+    score += 0.2;
+  }
+  const manifestHits = countRegex(t, /\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción|universo me lo dará)\b/g) + countRegex(t, /\b(realine(a|ar)\b.*\bátom|\bátom|\batomos\b)/g);
+  if (manifestHits > 0) {
+    flags.push("magic_manifesting");
+    score += Math.min(0.35, 0.15 + manifestHits * 0.06);
+  }
+  if (/\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa|lo que importa es lo que sientes)\b/.test(t)) {
+    flags.push("truth_relativism");
+    score += 0.35;
+  }
+  if (/\b(deben|debe)\b.*\b(obligatoriamente|por lo tanto|por ende)\b/.test(t) || /\b(la materia)\b.*\b(se subordina|obedece)\b/.test(t)) {
+    flags.push("broken_causality");
+    score += 0.2;
+  }
+  score = clamp01(score);
+  return { score, flags };
+}
+
+// src/intention.ts
+function clamp012(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function evaluateIntention(text) {
+  const raw = text || "";
+  const t = raw.toLowerCase();
+  const isHelp = /\b(ayuda|ayúdame|explica|resume|resumir|cómo|como|puedes|podrías|por favor)\b/.test(
+    t
+  );
+  const isSpam = /\b(compra|oferta|promo|descuento|gratis|haz clic|click|off|90%|% off)\b/.test(
+    t
+  ) || (raw.match(/\$+/g) || []).length > 0;
+  const isManip = /\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\b/.test(
+    t
+  );
+  const isConsp = /\b(simulación|todos lo saben|lo esconden|verdad oculta|ellos no quieren)\b/.test(
+    t
+  );
+  const isMisinformation = /\b(física cuántica|cuantica|cuántica|cuántico|quantum)\b/.test(t) || /\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción)\b/.test(t) || /\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa)\b/.test(t) || /\b(la materia)\b.*\b(se subordina|obedece)\b/.test(t);
+  let intention = "unknown";
+  let confidence = 0;
+  let rationale = "";
+  if (isSpam) {
+    intention = "marketing_spam";
+    confidence = 0.85;
+    rationale = "Detect\xE9 se\xF1ales de venta agresiva/urgencia/dinero.";
+  } else if (isManip) {
+    intention = "manipulation";
+    confidence = 0.85;
+    rationale = "Detect\xE9 coerci\xF3n/culpa/chantaje emocional.";
+  } else if (isConsp) {
+    intention = "conspiracy";
+    confidence = 0.75;
+    rationale = "Detect\xE9 marco conspirativo vago ('lo esconden', 'todos lo saben').";
+  } else if (isMisinformation) {
+    intention = "misinformation";
+    confidence = 0.85;
+    rationale = "Detect\xE9 patr\xF3n de pseudo-ciencia/pensamiento m\xE1gico/relativismo de la verdad (alta probabilidad de desinformaci\xF3n).";
+  } else if (isHelp) {
+    intention = "request_help";
+    confidence = 0.7;
+    rationale = "Parece una petici\xF3n leg\xEDtima de ayuda/explicaci\xF3n.";
+  }
+  return { intention, confidence: clamp012(confidence), rationale };
+}
+
+// src/wrapper.ts
+function runEntropyFilter(text) {
+  const entropy_analysis = analyzeEntropy(text);
+  let intention_evaluation = evaluateIntention(text);
+  const hardFlags = new Set(entropy_analysis.flags);
+  const epistemicEntropy = hardFlags.has("truth_relativism") || hardFlags.has("magic_manifesting") || hardFlags.has("pseudo_science_quantum") || hardFlags.has("broken_causality");
+  if (epistemicEntropy) {
+    intention_evaluation = {
+      intention: "misinformation",
+      confidence: Math.max(intention_evaluation.confidence ?? 0.7, 0.8),
+      rationale: "Detect\xE9 patr\xF3n de pseudo-ciencia/pensamiento m\xE1gico/relativismo de la verdad; alta probabilidad de desinformaci\xF3n o argumento sin anclaje causal."
+    };
+  }
+  return { entropy_analysis, intention_evaluation };
+}
+
+// src/middleware.ts
+function entropyMiddleware(req, _res, next) {
+  const text = req?.body?.text;
+  const result = typeof text === "string" ? runEntropyFilter(text) : runEntropyFilter("");
+  req.entropy = result;
+  next?.();
+}
+
+// src/gate.ts
+function clamp013(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function mergeFlags(base, extra) {
+  const set = new Set(base);
+  const out = [...base];
+  for (const f of extra) {
+    if (!set.has(f)) {
+      set.add(f);
+      out.push(f);
+    }
+  }
+  return out;
+}
+function englishSpamBooster(rawText) {
+  const t = (rawText || "").toLowerCase();
+  const patterns = [
+    { re: /\bfree\b/g, score: 0.08, flag: "spam_kw_free" },
+    { re: /\bwinner\b|\bwon\b|\bcongratulations\b/g, score: 0.1, flag: "spam_kw_winner" },
+    { re: /\bclaim\b|\bredeem\b/g, score: 0.08, flag: "spam_kw_claim" },
+    { re: /\bclick\b|\bclick here\b|\bopen link\b|\btap here\b/g, score: 0.1, flag: "spam_kw_click" },
+    { re: /\blimited time\b|\bact now\b|\bfinal notice\b|\bbefore midnight\b/g, score: 0.1, flag: "spam_kw_urgency_en" },
+    { re: /\bverify\b|\bconfirm\b|\baccount\b.*\b(suspended|locked)\b/g, score: 0.12, flag: "spam_kw_verify" },
+    { re: /\bprize\b|\bgift card\b|\bgiftcard\b|\bvoucher\b|\biphone\b|\bsurvey\b/g, score: 0.1, flag: "spam_kw_prize" },
+    { re: /\bloan\b|\bpre-?approved\b|\bno credit check\b/g, score: 0.12, flag: "spam_kw_loan" },
+    { re: /\bcrypto\b|\bairdrop\b|\bwallet\b|\bseed phrase\b/g, score: 0.1, flag: "spam_kw_crypto" },
+    { re: /\bdelivery failed\b|\breschedule\b|\bpackage\b|\bcourier\b/g, score: 0.1, flag: "spam_kw_delivery" },
+    { re: /\btax refund\b|\bunpaid\b|\brefund\b|\bchargeback\b/g, score: 0.1, flag: "spam_kw_refund" }
+  ];
+  let addScore = 0;
+  const addFlags = [];
+  let hitCount = 0;
+  for (const p of patterns) {
+    const m = t.match(p.re);
+    if (m && m.length > 0) {
+      hitCount += m.length;
+      addScore += p.score;
+      addFlags.push(p.flag);
+    }
+  }
+  addScore = Math.min(0.35, addScore);
+  if (hitCount > 0) addFlags.push("spam_keywords_en");
+  return { addScore, addFlags, hitCount };
+}
+function gateLLM(text, config = {}) {
+  const warnT = config.warnThreshold ?? 0.25;
+  const blockT = config.blockThreshold ?? 0.6;
+  const r = runEntropyFilter(text);
+  let score = r.entropy_analysis.score;
+  let flags = [...r.entropy_analysis.flags];
+  const booster = englishSpamBooster(text);
+  if (booster.hitCount > 0) {
+    score = clamp013(score + booster.addScore);
+    flags = mergeFlags(flags, booster.addFlags);
+  }
+  let intention = r.intention_evaluation.intention || "unknown";
+  let confidence = r.intention_evaluation.confidence ?? 0;
+  let rationale = r.intention_evaluation.rationale ?? "";
+  if (booster.hitCount > 0 && intention === "unknown") {
+    intention = "marketing_spam";
+    confidence = Math.max(confidence, 0.75);
+    rationale = (rationale ? rationale + " " : "") + "Detect\xE9 keywords t\xEDpicas de spam/phishing en ingl\xE9s.";
+  }
+  const hasSpam = flags.includes("spam_sales") || flags.includes("spam_keywords_en");
+  const hasMoneySignals = flags.includes("money_signal") || flags.includes("spam_kw_prize") || flags.includes("spam_kw_loan");
+  const strongSpam = hasSpam && hasMoneySignals;
+  let action = "ALLOW";
+  if (score > blockT || strongSpam) action = "BLOCK";
+  else if (score >= warnT) action = "WARN";
+  return {
+    action,
+    entropy_score: score,
+    flags,
+    intention,
+    confidence: clamp013(confidence),
+    rationale
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  analyzeEntropy,
+  entropyMiddleware,
+  evaluateIntention,
+  gate,
+  gateLLM,
+  runEntropyFilter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/entropy.ts","../src/intention.ts","../src/wrapper.ts","../src/middleware.ts","../src/gate.ts"],"sourcesContent":["// src/index.ts\nexport { analyzeEntropy } from \"./entropy\";\nexport { evaluateIntention } from \"./intention\";\nexport { runEntropyFilter } from \"./wrapper\";\nexport { entropyMiddleware } from \"./middleware\";\n\nexport type {\n  EntropyResult,\n  IntentionEvaluation,\n  FilterResult\n} from \"./types\";\nexport { gateLLM as gate } from \"./gate\";\nexport * from \"./gate\";\n","// src/entropy.ts\nexport type EntropyResult = {\n  score: number; // 0..1\n  flags: string[];\n};\n\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\nfunction countRegex(text: string, re: RegExp) {\n  const m = text.match(re);\n  return m ? m.length : 0;\n}\n\nexport function analyzeEntropy(text: string): EntropyResult {\n  const raw = text || \"\";\n  const t = raw.toLowerCase();\n  const flags: string[] = [];\n  let score = 0;\n\n  // 1) Urgencia / presión\n  if (/\\b(ahora|ya|urgente|última|hoy|inmediato)\\b/.test(t)) {\n    flags.push(\"urgency\");\n    score += 0.20;\n  }\n\n  // 2) Spam / venta agresiva\n  if (/\\b(compra|oferta|promo|descuento|gratis|clic|click|off)\\b/.test(t)) {\n    flags.push(\"spam_sales\");\n    score += 0.25;\n  }\n\n  // 3) Señales $$$ / símbolos\n  const moneyHits = countRegex(raw, /\\$+/g);\n  if (moneyHits > 0) {\n    flags.push(\"money_signal\");\n    score += Math.min(0.20, moneyHits * 0.05);\n  }\n\n  // 4) Exceso de signos / gritos\n  const exclam = countRegex(raw, /!/g);\n  const capsRatio = (() => {\n    const letters = raw.match(/[A-Za-zÁÉÍÓÚÜÑáéíóúüñ]/g) || [];\n    if (letters.length === 0) return 0;\n    const caps = (raw.match(/[A-ZÁÉÍÓÚÜÑ]/g) || []).length;\n    return caps / letters.length;\n  })();\n\n  if (exclam >= 3 || capsRatio >= 0.35) {\n    flags.push(\"shouting\");\n    score += 0.20;\n  }\n\n  // 5) Manipulación / culpa / coerción\n  if (/\\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\\b/.test(t)) {\n    flags.push(\"emotional_manipulation\");\n    score += 0.35;\n  }\n\n  // 6) Conspiración vaga / “todos lo saben”\n  if (/\\b(todos lo saben|lo esconden|la verdad oculta|ellos no quieren|simulación)\\b/.test(t)) {\n    flags.push(\"conspiracy_vague\");\n    score += 0.20;\n  }\n\n  // 6.5) “Prueba vaga” / apelación a cultura como evidencia\n  if (/\\b(la cultura lo prueba|es obvio|todo mundo sabe|se sabe|está claro)\\b/.test(t)) {\n    flags.push(\"weak_evidence\");\n    score += 0.20;\n  }\n\n  // 6.6) Totalización + agente oculto (“ellos”)\n  if (/\\b(ellos|la élite|los de arriba)\\b/.test(t) && /\\b(esconden|ocultan|tapan)\\b/.test(t)) {\n    flags.push(\"hidden_actor\");\n    score += 0.15;\n  }\n\n  // ------------------------------------------------------------\n  // NUEVO: Entropía por pseudo-ciencia / pensamiento mágico / relativismo\n  // ------------------------------------------------------------\n\n  // 7) Pseudo-ciencia \"cuántica\" usada como licencia mágica\n  if (/\\b(física cuántica|cuantica|cuántico|quantum)\\b/.test(t)) {\n    flags.push(\"pseudo_science_quantum\");\n    score += 0.20;\n  }\n\n  // 8) Manifestación mágica / decretos / vibración / energía como causalidad\n  const manifestHits =\n    countRegex(t, /\\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción|universo me lo dará)\\b/g) +\n    countRegex(t, /\\b(realine(a|ar)\\b.*\\bátom|\\bátom|\\batomos\\b)/g);\n\n  if (manifestHits > 0) {\n    flags.push(\"magic_manifesting\");\n    score += Math.min(0.35, 0.15 + manifestHits * 0.06);\n  }\n\n  // 9) Relativismo de la verdad / negación explícita de verdad objetiva\n  if (/\\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa|lo que importa es lo que sientes)\\b/.test(t)) {\n    flags.push(\"truth_relativism\");\n    score += 0.35;\n  }\n\n  // 10) Causalidad rota / obligación metafísica (\"debe\" porque lo deseo)\n  if (/\\b(deben|debe)\\b.*\\b(obligatoriamente|por lo tanto|por ende)\\b/.test(t) || /\\b(la materia)\\b.*\\b(se subordina|obedece)\\b/.test(t)) {\n    flags.push(\"broken_causality\");\n    score += 0.20;\n  }\n\n  // Normaliza: score final 0..1\n  score = clamp01(score);\n\n  return { score, flags };\n}\n","// src/intention.ts\nimport type { IntentionEvaluation, IntentionType } from \"./types\";\n\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\nexport function evaluateIntention(text: string): IntentionEvaluation {\n  const raw = text || \"\";\n  const t = raw.toLowerCase();\n\n  // Heurísticas rápidas (MVP)\n  const isHelp =\n    /\\b(ayuda|ayúdame|explica|resume|resumir|cómo|como|puedes|podrías|por favor)\\b/.test(\n      t\n    );\n\n  const isSpam =\n    /\\b(compra|oferta|promo|descuento|gratis|haz clic|click|off|90%|% off)\\b/.test(\n      t\n    ) || (raw.match(/\\$+/g) || []).length > 0;\n\n  const isManip =\n    /\\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\\b/.test(\n      t\n    );\n\n  const isConsp =\n    /\\b(simulación|todos lo saben|lo esconden|verdad oculta|ellos no quieren)\\b/.test(\n      t\n    );\n\n  // NUEVO: pseudo-ciencia / pensamiento mágico / relativismo (desinformación)\n  const isMisinformation =\n    /\\b(física cuántica|cuantica|cuántica|cuántico|quantum)\\b/.test(t) ||\n    /\\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción)\\b/.test(t) ||\n    /\\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa)\\b/.test(t) ||\n    /\\b(la materia)\\b.*\\b(se subordina|obedece)\\b/.test(t);\n\n  let intention: IntentionType = \"unknown\";\n  let confidence = 0.0;\n  let rationale = \"\";\n\n  if (isSpam) {\n    intention = \"marketing_spam\";\n    confidence = 0.85;\n    rationale = \"Detecté señales de venta agresiva/urgencia/dinero.\";\n  } else if (isManip) {\n    intention = \"manipulation\";\n    confidence = 0.85;\n    rationale = \"Detecté coerción/culpa/chantaje emocional.\";\n  } else if (isConsp) {\n    intention = \"conspiracy\";\n    confidence = 0.75;\n    rationale = \"Detecté marco conspirativo vago ('lo esconden', 'todos lo saben').\";\n  } else if (isMisinformation) {\n    intention = \"misinformation\";\n    confidence = 0.85;\n    rationale =\n      \"Detecté patrón de pseudo-ciencia/pensamiento mágico/relativismo de la verdad (alta probabilidad de desinformación).\";\n  } else if (isHelp) {\n    intention = \"request_help\";\n    confidence = 0.7;\n    rationale = \"Parece una petición legítima de ayuda/explicación.\";\n  }\n\n  return { intention, confidence: clamp01(confidence), rationale };\n}\n","// src/wrapper.ts\nimport { analyzeEntropy } from \"./entropy\";\nimport { evaluateIntention } from \"./intention\";\nimport type { FilterResult, IntentionEvaluation } from \"./types\";\n\nexport function runEntropyFilter(text: string): FilterResult {\n  const entropy_analysis = analyzeEntropy(text);\n  let intention_evaluation: IntentionEvaluation = evaluateIntention(text);\n\n  // Corrección: si el texto trae señales fuertes de entropía epistemológica,\n  // no lo clasifiques como \"request_help\" solo por ser pregunta larga.\n  const hardFlags = new Set(entropy_analysis.flags);\n  const epistemicEntropy =\n    hardFlags.has(\"truth_relativism\") ||\n    hardFlags.has(\"magic_manifesting\") ||\n    hardFlags.has(\"pseudo_science_quantum\") ||\n    hardFlags.has(\"broken_causality\");\n\n  if (epistemicEntropy) {\n    intention_evaluation = {\n      intention: \"misinformation\",\n      confidence: Math.max(intention_evaluation.confidence ?? 0.7, 0.8),\n      rationale:\n        \"Detecté patrón de pseudo-ciencia/pensamiento mágico/relativismo de la verdad; alta probabilidad de desinformación o argumento sin anclaje causal.\"\n    };\n  }\n\n  return { entropy_analysis, intention_evaluation };\n}\n","// src/middleware.ts\nimport { runEntropyFilter } from \"./wrapper\";\nimport type { FilterResult } from \"./types\";\n\n/**\n * Middleware agnóstico (NO depende de express types).\n * Compatible con Express / Next API routes / cualquier framework estilo req-res-next.\n *\n * Espera: req.body.text (string)\n * Escribe: req.entropy = FilterResult\n */\nexport function entropyMiddleware(req: any, _res: any, next: any) {\n  const text = req?.body?.text;\n\n  const result: FilterResult =\n    typeof text === \"string\" ? runEntropyFilter(text) : runEntropyFilter(\"\");\n\n  req.entropy = result;\n  next?.();\n}\n\n/**\n * Tipo auxiliar opcional (sin forzar dependencias).\n * Útil si quieres tipar tu req en tu app.\n */\nexport type EntropyAugmentedRequest = {\n  body?: { text?: unknown };\n  entropy?: FilterResult;\n};\n","// src/gate.ts\nimport { runEntropyFilter } from \"./wrapper\";\n\nexport type GateAction = \"ALLOW\" | \"WARN\" | \"BLOCK\";\n\nexport type GateResult = {\n  action: GateAction;\n  entropy_score: number;\n  flags: string[];\n  intention: string;\n  confidence: number;\n  rationale: string;\n};\n\nexport type GateConfig = {\n  warnThreshold?: number;  // default: 0.25\n  blockThreshold?: number; // default: 0.60\n};\n\n/** Clamp 0..1 */\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\n/** Add unique flags preserving order */\nfunction mergeFlags(base: string[], extra: string[]) {\n  const set = new Set(base);\n  const out = [...base];\n  for (const f of extra) {\n    if (!set.has(f)) {\n      set.add(f);\n      out.push(f);\n    }\n  }\n  return out;\n}\n\n/**\n * Detección de spam/phishing en inglés por keywords.\n * Se implementa como “booster” de score + flags (sin tocar entropy.ts).\n */\nfunction englishSpamBooster(rawText: string): {\n  addScore: number;\n  addFlags: string[];\n  hitCount: number;\n} {\n  const t = (rawText || \"\").toLowerCase();\n\n  // Patrones típicos (spam / phishing / promos agresivas)\n  const patterns: Array<{ re: RegExp; score: number; flag: string }> = [\n    { re: /\\bfree\\b/g, score: 0.08, flag: \"spam_kw_free\" },\n    { re: /\\bwinner\\b|\\bwon\\b|\\bcongratulations\\b/g, score: 0.10, flag: \"spam_kw_winner\" },\n    { re: /\\bclaim\\b|\\bredeem\\b/g, score: 0.08, flag: \"spam_kw_claim\" },\n    { re: /\\bclick\\b|\\bclick here\\b|\\bopen link\\b|\\btap here\\b/g, score: 0.10, flag: \"spam_kw_click\" },\n    { re: /\\blimited time\\b|\\bact now\\b|\\bfinal notice\\b|\\bbefore midnight\\b/g, score: 0.10, flag: \"spam_kw_urgency_en\" },\n    { re: /\\bverify\\b|\\bconfirm\\b|\\baccount\\b.*\\b(suspended|locked)\\b/g, score: 0.12, flag: \"spam_kw_verify\" },\n    { re: /\\bprize\\b|\\bgift card\\b|\\bgiftcard\\b|\\bvoucher\\b|\\biphone\\b|\\bsurvey\\b/g, score: 0.10, flag: \"spam_kw_prize\" },\n    { re: /\\bloan\\b|\\bpre-?approved\\b|\\bno credit check\\b/g, score: 0.12, flag: \"spam_kw_loan\" },\n    { re: /\\bcrypto\\b|\\bairdrop\\b|\\bwallet\\b|\\bseed phrase\\b/g, score: 0.10, flag: \"spam_kw_crypto\" },\n    { re: /\\bdelivery failed\\b|\\breschedule\\b|\\bpackage\\b|\\bcourier\\b/g, score: 0.10, flag: \"spam_kw_delivery\" },\n    { re: /\\btax refund\\b|\\bunpaid\\b|\\brefund\\b|\\bchargeback\\b/g, score: 0.10, flag: \"spam_kw_refund\" },\n  ];\n\n  let addScore = 0;\n  const addFlags: string[] = [];\n  let hitCount = 0;\n\n  for (const p of patterns) {\n    const m = t.match(p.re);\n    if (m && m.length > 0) {\n      hitCount += m.length;\n      addScore += p.score; // suma “por patrón”, no por ocurrencia (controlado)\n      addFlags.push(p.flag);\n    }\n  }\n\n  // cap para no sobre-castigar\n  addScore = Math.min(0.35, addScore);\n\n  if (hitCount > 0) addFlags.push(\"spam_keywords_en\");\n\n  return { addScore, addFlags, hitCount };\n}\n\n/**\n * Gate principal (producto): deterministic + barato.\n */\nexport function gateLLM(text: string, config: GateConfig = {}): GateResult {\n  const warnT = config.warnThreshold ?? 0.25;\n  const blockT = config.blockThreshold ?? 0.6;\n\n  const r = runEntropyFilter(text);\n\n  // base\n  let score = r.entropy_analysis.score;\n  let flags = [...r.entropy_analysis.flags];\n\n  // booster EN\n  const booster = englishSpamBooster(text);\n  if (booster.hitCount > 0) {\n    score = clamp01(score + booster.addScore);\n    flags = mergeFlags(flags, booster.addFlags);\n  }\n\n  // intención base (intention.ts)\n  let intention = r.intention_evaluation.intention || \"unknown\";\n  let confidence = r.intention_evaluation.confidence ?? 0;\n  let rationale = r.intention_evaluation.rationale ?? \"\";\n\n  // si pegó booster EN y quedó unknown → marketing_spam\n  if (booster.hitCount > 0 && intention === \"unknown\") {\n    intention = \"marketing_spam\";\n    confidence = Math.max(confidence, 0.75);\n    rationale = (rationale ? rationale + \" \" : \"\") + \"Detecté keywords típicas de spam/phishing en inglés.\";\n  }\n\n  // reglas fuertes (para BLOCK “vendible”)\n  const hasSpam =\n    flags.includes(\"spam_sales\") ||\n    flags.includes(\"spam_keywords_en\");\n\n  const hasMoneySignals =\n    flags.includes(\"money_signal\") ||\n    flags.includes(\"spam_kw_prize\") ||\n    flags.includes(\"spam_kw_loan\");\n\n  const strongSpam = hasSpam && hasMoneySignals;\n\n  let action: GateAction = \"ALLOW\";\n  if (score > blockT || strongSpam) action = \"BLOCK\";\n  else if (score >= warnT) action = \"WARN\";\n\n  return {\n    action,\n    entropy_score: score,\n    flags,\n    intention,\n    confidence: clamp01(confidence),\n    rationale,\n  };\n}\n\n// Alias “bonito” para tu server: gate(text)\nexport const gate = gateLLM;\n"],"mappings":"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","names":["clamp01","clamp01"]}

package/dist/index.d.cts

@@ -0,0 +1,53 @@
+type EntropyResult$1 = {
+    score: number;
+    flags: string[];
+};
+declare function analyzeEntropy(text: string): EntropyResult$1;
+
+type EntropyResult = {
+    score: number;
+    flags: string[];
+};
+type IntentionType = "unknown" | "request_help" | "marketing_spam" | "manipulation" | "conspiracy" | "misinformation";
+type IntentionEvaluation = {
+    intention: IntentionType;
+    confidence: number;
+    rationale?: string;
+};
+type FilterResult = {
+    entropy_analysis: EntropyResult;
+    intention_evaluation: IntentionEvaluation;
+};
+
+declare function evaluateIntention(text: string): IntentionEvaluation;
+
+declare function runEntropyFilter(text: string): FilterResult;
+
+/**
+ * Middleware agnóstico (NO depende de express types).
+ * Compatible con Express / Next API routes / cualquier framework estilo req-res-next.
+ *
+ * Espera: req.body.text (string)
+ * Escribe: req.entropy = FilterResult
+ */
+declare function entropyMiddleware(req: any, _res: any, next: any): void;
+
+type GateAction = "ALLOW" | "WARN" | "BLOCK";
+type GateResult = {
+    action: GateAction;
+    entropy_score: number;
+    flags: string[];
+    intention: string;
+    confidence: number;
+    rationale: string;
+};
+type GateConfig = {
+    warnThreshold?: number;
+    blockThreshold?: number;
+};
+/**
+ * Gate principal (producto): deterministic + barato.
+ */
+declare function gateLLM(text: string, config?: GateConfig): GateResult;
+
+export { type EntropyResult, type FilterResult, type GateAction, type GateConfig, type GateResult, type IntentionEvaluation, analyzeEntropy, entropyMiddleware, evaluateIntention, gateLLM as gate, gateLLM, runEntropyFilter };

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+type EntropyResult$1 = {
+    score: number;
+    flags: string[];
+};
+declare function analyzeEntropy(text: string): EntropyResult$1;
+
+type EntropyResult = {
+    score: number;
+    flags: string[];
+};
+type IntentionType = "unknown" | "request_help" | "marketing_spam" | "manipulation" | "conspiracy" | "misinformation";
+type IntentionEvaluation = {
+    intention: IntentionType;
+    confidence: number;
+    rationale?: string;
+};
+type FilterResult = {
+    entropy_analysis: EntropyResult;
+    intention_evaluation: IntentionEvaluation;
+};
+
+declare function evaluateIntention(text: string): IntentionEvaluation;
+
+declare function runEntropyFilter(text: string): FilterResult;
+
+/**
+ * Middleware agnóstico (NO depende de express types).
+ * Compatible con Express / Next API routes / cualquier framework estilo req-res-next.
+ *
+ * Espera: req.body.text (string)
+ * Escribe: req.entropy = FilterResult
+ */
+declare function entropyMiddleware(req: any, _res: any, next: any): void;
+
+type GateAction = "ALLOW" | "WARN" | "BLOCK";
+type GateResult = {
+    action: GateAction;
+    entropy_score: number;
+    flags: string[];
+    intention: string;
+    confidence: number;
+    rationale: string;
+};
+type GateConfig = {
+    warnThreshold?: number;
+    blockThreshold?: number;
+};
+/**
+ * Gate principal (producto): deterministic + barato.
+ */
+declare function gateLLM(text: string, config?: GateConfig): GateResult;
+
+export { type EntropyResult, type FilterResult, type GateAction, type GateConfig, type GateResult, type IntentionEvaluation, analyzeEntropy, entropyMiddleware, evaluateIntention, gateLLM as gate, gateLLM, runEntropyFilter };

package/dist/index.js

@@ -0,0 +1,233 @@
+// src/entropy.ts
+function clamp01(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function countRegex(text, re) {
+  const m = text.match(re);
+  return m ? m.length : 0;
+}
+function analyzeEntropy(text) {
+  const raw = text || "";
+  const t = raw.toLowerCase();
+  const flags = [];
+  let score = 0;
+  if (/\b(ahora|ya|urgente|última|hoy|inmediato)\b/.test(t)) {
+    flags.push("urgency");
+    score += 0.2;
+  }
+  if (/\b(compra|oferta|promo|descuento|gratis|clic|click|off)\b/.test(t)) {
+    flags.push("spam_sales");
+    score += 0.25;
+  }
+  const moneyHits = countRegex(raw, /\$+/g);
+  if (moneyHits > 0) {
+    flags.push("money_signal");
+    score += Math.min(0.2, moneyHits * 0.05);
+  }
+  const exclam = countRegex(raw, /!/g);
+  const capsRatio = (() => {
+    const letters = raw.match(/[A-Za-zÁÉÍÓÚÜÑáéíóúüñ]/g) || [];
+    if (letters.length === 0) return 0;
+    const caps = (raw.match(/[A-ZÁÉÍÓÚÜÑ]/g) || []).length;
+    return caps / letters.length;
+  })();
+  if (exclam >= 3 || capsRatio >= 0.35) {
+    flags.push("shouting");
+    score += 0.2;
+  }
+  if (/\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\b/.test(t)) {
+    flags.push("emotional_manipulation");
+    score += 0.35;
+  }
+  if (/\b(todos lo saben|lo esconden|la verdad oculta|ellos no quieren|simulación)\b/.test(t)) {
+    flags.push("conspiracy_vague");
+    score += 0.2;
+  }
+  if (/\b(la cultura lo prueba|es obvio|todo mundo sabe|se sabe|está claro)\b/.test(t)) {
+    flags.push("weak_evidence");
+    score += 0.2;
+  }
+  if (/\b(ellos|la élite|los de arriba)\b/.test(t) && /\b(esconden|ocultan|tapan)\b/.test(t)) {
+    flags.push("hidden_actor");
+    score += 0.15;
+  }
+  if (/\b(física cuántica|cuantica|cuántico|quantum)\b/.test(t)) {
+    flags.push("pseudo_science_quantum");
+    score += 0.2;
+  }
+  const manifestHits = countRegex(t, /\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción|universo me lo dará)\b/g) + countRegex(t, /\b(realine(a|ar)\b.*\bátom|\bátom|\batomos\b)/g);
+  if (manifestHits > 0) {
+    flags.push("magic_manifesting");
+    score += Math.min(0.35, 0.15 + manifestHits * 0.06);
+  }
+  if (/\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa|lo que importa es lo que sientes)\b/.test(t)) {
+    flags.push("truth_relativism");
+    score += 0.35;
+  }
+  if (/\b(deben|debe)\b.*\b(obligatoriamente|por lo tanto|por ende)\b/.test(t) || /\b(la materia)\b.*\b(se subordina|obedece)\b/.test(t)) {
+    flags.push("broken_causality");
+    score += 0.2;
+  }
+  score = clamp01(score);
+  return { score, flags };
+}
+
+// src/intention.ts
+function clamp012(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function evaluateIntention(text) {
+  const raw = text || "";
+  const t = raw.toLowerCase();
+  const isHelp = /\b(ayuda|ayúdame|explica|resume|resumir|cómo|como|puedes|podrías|por favor)\b/.test(
+    t
+  );
+  const isSpam = /\b(compra|oferta|promo|descuento|gratis|haz clic|click|off|90%|% off)\b/.test(
+    t
+  ) || (raw.match(/\$+/g) || []).length > 0;
+  const isManip = /\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\b/.test(
+    t
+  );
+  const isConsp = /\b(simulación|todos lo saben|lo esconden|verdad oculta|ellos no quieren)\b/.test(
+    t
+  );
+  const isMisinformation = /\b(física cuántica|cuantica|cuántica|cuántico|quantum)\b/.test(t) || /\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción)\b/.test(t) || /\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa)\b/.test(t) || /\b(la materia)\b.*\b(se subordina|obedece)\b/.test(t);
+  let intention = "unknown";
+  let confidence = 0;
+  let rationale = "";
+  if (isSpam) {
+    intention = "marketing_spam";
+    confidence = 0.85;
+    rationale = "Detect\xE9 se\xF1ales de venta agresiva/urgencia/dinero.";
+  } else if (isManip) {
+    intention = "manipulation";
+    confidence = 0.85;
+    rationale = "Detect\xE9 coerci\xF3n/culpa/chantaje emocional.";
+  } else if (isConsp) {
+    intention = "conspiracy";
+    confidence = 0.75;
+    rationale = "Detect\xE9 marco conspirativo vago ('lo esconden', 'todos lo saben').";
+  } else if (isMisinformation) {
+    intention = "misinformation";
+    confidence = 0.85;
+    rationale = "Detect\xE9 patr\xF3n de pseudo-ciencia/pensamiento m\xE1gico/relativismo de la verdad (alta probabilidad de desinformaci\xF3n).";
+  } else if (isHelp) {
+    intention = "request_help";
+    confidence = 0.7;
+    rationale = "Parece una petici\xF3n leg\xEDtima de ayuda/explicaci\xF3n.";
+  }
+  return { intention, confidence: clamp012(confidence), rationale };
+}
+
+// src/wrapper.ts
+function runEntropyFilter(text) {
+  const entropy_analysis = analyzeEntropy(text);
+  let intention_evaluation = evaluateIntention(text);
+  const hardFlags = new Set(entropy_analysis.flags);
+  const epistemicEntropy = hardFlags.has("truth_relativism") || hardFlags.has("magic_manifesting") || hardFlags.has("pseudo_science_quantum") || hardFlags.has("broken_causality");
+  if (epistemicEntropy) {
+    intention_evaluation = {
+      intention: "misinformation",
+      confidence: Math.max(intention_evaluation.confidence ?? 0.7, 0.8),
+      rationale: "Detect\xE9 patr\xF3n de pseudo-ciencia/pensamiento m\xE1gico/relativismo de la verdad; alta probabilidad de desinformaci\xF3n o argumento sin anclaje causal."
+    };
+  }
+  return { entropy_analysis, intention_evaluation };
+}
+
+// src/middleware.ts
+function entropyMiddleware(req, _res, next) {
+  const text = req?.body?.text;
+  const result = typeof text === "string" ? runEntropyFilter(text) : runEntropyFilter("");
+  req.entropy = result;
+  next?.();
+}
+
+// src/gate.ts
+function clamp013(x) {
+  return Math.max(0, Math.min(1, x));
+}
+function mergeFlags(base, extra) {
+  const set = new Set(base);
+  const out = [...base];
+  for (const f of extra) {
+    if (!set.has(f)) {
+      set.add(f);
+      out.push(f);
+    }
+  }
+  return out;
+}
+function englishSpamBooster(rawText) {
+  const t = (rawText || "").toLowerCase();
+  const patterns = [
+    { re: /\bfree\b/g, score: 0.08, flag: "spam_kw_free" },
+    { re: /\bwinner\b|\bwon\b|\bcongratulations\b/g, score: 0.1, flag: "spam_kw_winner" },
+    { re: /\bclaim\b|\bredeem\b/g, score: 0.08, flag: "spam_kw_claim" },
+    { re: /\bclick\b|\bclick here\b|\bopen link\b|\btap here\b/g, score: 0.1, flag: "spam_kw_click" },
+    { re: /\blimited time\b|\bact now\b|\bfinal notice\b|\bbefore midnight\b/g, score: 0.1, flag: "spam_kw_urgency_en" },
+    { re: /\bverify\b|\bconfirm\b|\baccount\b.*\b(suspended|locked)\b/g, score: 0.12, flag: "spam_kw_verify" },
+    { re: /\bprize\b|\bgift card\b|\bgiftcard\b|\bvoucher\b|\biphone\b|\bsurvey\b/g, score: 0.1, flag: "spam_kw_prize" },
+    { re: /\bloan\b|\bpre-?approved\b|\bno credit check\b/g, score: 0.12, flag: "spam_kw_loan" },
+    { re: /\bcrypto\b|\bairdrop\b|\bwallet\b|\bseed phrase\b/g, score: 0.1, flag: "spam_kw_crypto" },
+    { re: /\bdelivery failed\b|\breschedule\b|\bpackage\b|\bcourier\b/g, score: 0.1, flag: "spam_kw_delivery" },
+    { re: /\btax refund\b|\bunpaid\b|\brefund\b|\bchargeback\b/g, score: 0.1, flag: "spam_kw_refund" }
+  ];
+  let addScore = 0;
+  const addFlags = [];
+  let hitCount = 0;
+  for (const p of patterns) {
+    const m = t.match(p.re);
+    if (m && m.length > 0) {
+      hitCount += m.length;
+      addScore += p.score;
+      addFlags.push(p.flag);
+    }
+  }
+  addScore = Math.min(0.35, addScore);
+  if (hitCount > 0) addFlags.push("spam_keywords_en");
+  return { addScore, addFlags, hitCount };
+}
+function gateLLM(text, config = {}) {
+  const warnT = config.warnThreshold ?? 0.25;
+  const blockT = config.blockThreshold ?? 0.6;
+  const r = runEntropyFilter(text);
+  let score = r.entropy_analysis.score;
+  let flags = [...r.entropy_analysis.flags];
+  const booster = englishSpamBooster(text);
+  if (booster.hitCount > 0) {
+    score = clamp013(score + booster.addScore);
+    flags = mergeFlags(flags, booster.addFlags);
+  }
+  let intention = r.intention_evaluation.intention || "unknown";
+  let confidence = r.intention_evaluation.confidence ?? 0;
+  let rationale = r.intention_evaluation.rationale ?? "";
+  if (booster.hitCount > 0 && intention === "unknown") {
+    intention = "marketing_spam";
+    confidence = Math.max(confidence, 0.75);
+    rationale = (rationale ? rationale + " " : "") + "Detect\xE9 keywords t\xEDpicas de spam/phishing en ingl\xE9s.";
+  }
+  const hasSpam = flags.includes("spam_sales") || flags.includes("spam_keywords_en");
+  const hasMoneySignals = flags.includes("money_signal") || flags.includes("spam_kw_prize") || flags.includes("spam_kw_loan");
+  const strongSpam = hasSpam && hasMoneySignals;
+  let action = "ALLOW";
+  if (score > blockT || strongSpam) action = "BLOCK";
+  else if (score >= warnT) action = "WARN";
+  return {
+    action,
+    entropy_score: score,
+    flags,
+    intention,
+    confidence: clamp013(confidence),
+    rationale
+  };
+}
+export {
+  analyzeEntropy,
+  entropyMiddleware,
+  evaluateIntention,
+  gateLLM as gate,
+  gateLLM,
+  runEntropyFilter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/entropy.ts","../src/intention.ts","../src/wrapper.ts","../src/middleware.ts","../src/gate.ts"],"sourcesContent":["// src/entropy.ts\nexport type EntropyResult = {\n  score: number; // 0..1\n  flags: string[];\n};\n\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\nfunction countRegex(text: string, re: RegExp) {\n  const m = text.match(re);\n  return m ? m.length : 0;\n}\n\nexport function analyzeEntropy(text: string): EntropyResult {\n  const raw = text || \"\";\n  const t = raw.toLowerCase();\n  const flags: string[] = [];\n  let score = 0;\n\n  // 1) Urgencia / presión\n  if (/\\b(ahora|ya|urgente|última|hoy|inmediato)\\b/.test(t)) {\n    flags.push(\"urgency\");\n    score += 0.20;\n  }\n\n  // 2) Spam / venta agresiva\n  if (/\\b(compra|oferta|promo|descuento|gratis|clic|click|off)\\b/.test(t)) {\n    flags.push(\"spam_sales\");\n    score += 0.25;\n  }\n\n  // 3) Señales $$$ / símbolos\n  const moneyHits = countRegex(raw, /\\$+/g);\n  if (moneyHits > 0) {\n    flags.push(\"money_signal\");\n    score += Math.min(0.20, moneyHits * 0.05);\n  }\n\n  // 4) Exceso de signos / gritos\n  const exclam = countRegex(raw, /!/g);\n  const capsRatio = (() => {\n    const letters = raw.match(/[A-Za-zÁÉÍÓÚÜÑáéíóúüñ]/g) || [];\n    if (letters.length === 0) return 0;\n    const caps = (raw.match(/[A-ZÁÉÍÓÚÜÑ]/g) || []).length;\n    return caps / letters.length;\n  })();\n\n  if (exclam >= 3 || capsRatio >= 0.35) {\n    flags.push(\"shouting\");\n    score += 0.20;\n  }\n\n  // 5) Manipulación / culpa / coerción\n  if (/\\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\\b/.test(t)) {\n    flags.push(\"emotional_manipulation\");\n    score += 0.35;\n  }\n\n  // 6) Conspiración vaga / “todos lo saben”\n  if (/\\b(todos lo saben|lo esconden|la verdad oculta|ellos no quieren|simulación)\\b/.test(t)) {\n    flags.push(\"conspiracy_vague\");\n    score += 0.20;\n  }\n\n  // 6.5) “Prueba vaga” / apelación a cultura como evidencia\n  if (/\\b(la cultura lo prueba|es obvio|todo mundo sabe|se sabe|está claro)\\b/.test(t)) {\n    flags.push(\"weak_evidence\");\n    score += 0.20;\n  }\n\n  // 6.6) Totalización + agente oculto (“ellos”)\n  if (/\\b(ellos|la élite|los de arriba)\\b/.test(t) && /\\b(esconden|ocultan|tapan)\\b/.test(t)) {\n    flags.push(\"hidden_actor\");\n    score += 0.15;\n  }\n\n  // ------------------------------------------------------------\n  // NUEVO: Entropía por pseudo-ciencia / pensamiento mágico / relativismo\n  // ------------------------------------------------------------\n\n  // 7) Pseudo-ciencia \"cuántica\" usada como licencia mágica\n  if (/\\b(física cuántica|cuantica|cuántico|quantum)\\b/.test(t)) {\n    flags.push(\"pseudo_science_quantum\");\n    score += 0.20;\n  }\n\n  // 8) Manifestación mágica / decretos / vibración / energía como causalidad\n  const manifestHits =\n    countRegex(t, /\\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción|universo me lo dará)\\b/g) +\n    countRegex(t, /\\b(realine(a|ar)\\b.*\\bátom|\\bátom|\\batomos\\b)/g);\n\n  if (manifestHits > 0) {\n    flags.push(\"magic_manifesting\");\n    score += Math.min(0.35, 0.15 + manifestHits * 0.06);\n  }\n\n  // 9) Relativismo de la verdad / negación explícita de verdad objetiva\n  if (/\\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa|lo que importa es lo que sientes)\\b/.test(t)) {\n    flags.push(\"truth_relativism\");\n    score += 0.35;\n  }\n\n  // 10) Causalidad rota / obligación metafísica (\"debe\" porque lo deseo)\n  if (/\\b(deben|debe)\\b.*\\b(obligatoriamente|por lo tanto|por ende)\\b/.test(t) || /\\b(la materia)\\b.*\\b(se subordina|obedece)\\b/.test(t)) {\n    flags.push(\"broken_causality\");\n    score += 0.20;\n  }\n\n  // Normaliza: score final 0..1\n  score = clamp01(score);\n\n  return { score, flags };\n}\n","// src/intention.ts\nimport type { IntentionEvaluation, IntentionType } from \"./types\";\n\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\nexport function evaluateIntention(text: string): IntentionEvaluation {\n  const raw = text || \"\";\n  const t = raw.toLowerCase();\n\n  // Heurísticas rápidas (MVP)\n  const isHelp =\n    /\\b(ayuda|ayúdame|explica|resume|resumir|cómo|como|puedes|podrías|por favor)\\b/.test(\n      t\n    );\n\n  const isSpam =\n    /\\b(compra|oferta|promo|descuento|gratis|haz clic|click|off|90%|% off)\\b/.test(\n      t\n    ) || (raw.match(/\\$+/g) || []).length > 0;\n\n  const isManip =\n    /\\b(si de verdad|si me quisieras|es tu culpa|no tienes opción|me debes)\\b/.test(\n      t\n    );\n\n  const isConsp =\n    /\\b(simulación|todos lo saben|lo esconden|verdad oculta|ellos no quieren)\\b/.test(\n      t\n    );\n\n  // NUEVO: pseudo-ciencia / pensamiento mágico / relativismo (desinformación)\n  const isMisinformation =\n    /\\b(física cuántica|cuantica|cuántica|cuántico|quantum)\\b/.test(t) ||\n    /\\b(manifestar|manifestación|decretar|decreto|vibración|vibracion|frecuencia|energía|energia|ley de la atracción)\\b/.test(t) ||\n    /\\b(no hay una verdad objetiva|no existe la verdad objetiva|tu verdad|mi verdad|la verdad es relativa)\\b/.test(t) ||\n    /\\b(la materia)\\b.*\\b(se subordina|obedece)\\b/.test(t);\n\n  let intention: IntentionType = \"unknown\";\n  let confidence = 0.0;\n  let rationale = \"\";\n\n  if (isSpam) {\n    intention = \"marketing_spam\";\n    confidence = 0.85;\n    rationale = \"Detecté señales de venta agresiva/urgencia/dinero.\";\n  } else if (isManip) {\n    intention = \"manipulation\";\n    confidence = 0.85;\n    rationale = \"Detecté coerción/culpa/chantaje emocional.\";\n  } else if (isConsp) {\n    intention = \"conspiracy\";\n    confidence = 0.75;\n    rationale = \"Detecté marco conspirativo vago ('lo esconden', 'todos lo saben').\";\n  } else if (isMisinformation) {\n    intention = \"misinformation\";\n    confidence = 0.85;\n    rationale =\n      \"Detecté patrón de pseudo-ciencia/pensamiento mágico/relativismo de la verdad (alta probabilidad de desinformación).\";\n  } else if (isHelp) {\n    intention = \"request_help\";\n    confidence = 0.7;\n    rationale = \"Parece una petición legítima de ayuda/explicación.\";\n  }\n\n  return { intention, confidence: clamp01(confidence), rationale };\n}\n","// src/wrapper.ts\nimport { analyzeEntropy } from \"./entropy\";\nimport { evaluateIntention } from \"./intention\";\nimport type { FilterResult, IntentionEvaluation } from \"./types\";\n\nexport function runEntropyFilter(text: string): FilterResult {\n  const entropy_analysis = analyzeEntropy(text);\n  let intention_evaluation: IntentionEvaluation = evaluateIntention(text);\n\n  // Corrección: si el texto trae señales fuertes de entropía epistemológica,\n  // no lo clasifiques como \"request_help\" solo por ser pregunta larga.\n  const hardFlags = new Set(entropy_analysis.flags);\n  const epistemicEntropy =\n    hardFlags.has(\"truth_relativism\") ||\n    hardFlags.has(\"magic_manifesting\") ||\n    hardFlags.has(\"pseudo_science_quantum\") ||\n    hardFlags.has(\"broken_causality\");\n\n  if (epistemicEntropy) {\n    intention_evaluation = {\n      intention: \"misinformation\",\n      confidence: Math.max(intention_evaluation.confidence ?? 0.7, 0.8),\n      rationale:\n        \"Detecté patrón de pseudo-ciencia/pensamiento mágico/relativismo de la verdad; alta probabilidad de desinformación o argumento sin anclaje causal.\"\n    };\n  }\n\n  return { entropy_analysis, intention_evaluation };\n}\n","// src/middleware.ts\nimport { runEntropyFilter } from \"./wrapper\";\nimport type { FilterResult } from \"./types\";\n\n/**\n * Middleware agnóstico (NO depende de express types).\n * Compatible con Express / Next API routes / cualquier framework estilo req-res-next.\n *\n * Espera: req.body.text (string)\n * Escribe: req.entropy = FilterResult\n */\nexport function entropyMiddleware(req: any, _res: any, next: any) {\n  const text = req?.body?.text;\n\n  const result: FilterResult =\n    typeof text === \"string\" ? runEntropyFilter(text) : runEntropyFilter(\"\");\n\n  req.entropy = result;\n  next?.();\n}\n\n/**\n * Tipo auxiliar opcional (sin forzar dependencias).\n * Útil si quieres tipar tu req en tu app.\n */\nexport type EntropyAugmentedRequest = {\n  body?: { text?: unknown };\n  entropy?: FilterResult;\n};\n","// src/gate.ts\nimport { runEntropyFilter } from \"./wrapper\";\n\nexport type GateAction = \"ALLOW\" | \"WARN\" | \"BLOCK\";\n\nexport type GateResult = {\n  action: GateAction;\n  entropy_score: number;\n  flags: string[];\n  intention: string;\n  confidence: number;\n  rationale: string;\n};\n\nexport type GateConfig = {\n  warnThreshold?: number;  // default: 0.25\n  blockThreshold?: number; // default: 0.60\n};\n\n/** Clamp 0..1 */\nfunction clamp01(x: number) {\n  return Math.max(0, Math.min(1, x));\n}\n\n/** Add unique flags preserving order */\nfunction mergeFlags(base: string[], extra: string[]) {\n  const set = new Set(base);\n  const out = [...base];\n  for (const f of extra) {\n    if (!set.has(f)) {\n      set.add(f);\n      out.push(f);\n    }\n  }\n  return out;\n}\n\n/**\n * Detección de spam/phishing en inglés por keywords.\n * Se implementa como “booster” de score + flags (sin tocar entropy.ts).\n */\nfunction englishSpamBooster(rawText: string): {\n  addScore: number;\n  addFlags: string[];\n  hitCount: number;\n} {\n  const t = (rawText || \"\").toLowerCase();\n\n  // Patrones típicos (spam / phishing / promos agresivas)\n  const patterns: Array<{ re: RegExp; score: number; flag: string }> = [\n    { re: /\\bfree\\b/g, score: 0.08, flag: \"spam_kw_free\" },\n    { re: /\\bwinner\\b|\\bwon\\b|\\bcongratulations\\b/g, score: 0.10, flag: \"spam_kw_winner\" },\n    { re: /\\bclaim\\b|\\bredeem\\b/g, score: 0.08, flag: \"spam_kw_claim\" },\n    { re: /\\bclick\\b|\\bclick here\\b|\\bopen link\\b|\\btap here\\b/g, score: 0.10, flag: \"spam_kw_click\" },\n    { re: /\\blimited time\\b|\\bact now\\b|\\bfinal notice\\b|\\bbefore midnight\\b/g, score: 0.10, flag: \"spam_kw_urgency_en\" },\n    { re: /\\bverify\\b|\\bconfirm\\b|\\baccount\\b.*\\b(suspended|locked)\\b/g, score: 0.12, flag: \"spam_kw_verify\" },\n    { re: /\\bprize\\b|\\bgift card\\b|\\bgiftcard\\b|\\bvoucher\\b|\\biphone\\b|\\bsurvey\\b/g, score: 0.10, flag: \"spam_kw_prize\" },\n    { re: /\\bloan\\b|\\bpre-?approved\\b|\\bno credit check\\b/g, score: 0.12, flag: \"spam_kw_loan\" },\n    { re: /\\bcrypto\\b|\\bairdrop\\b|\\bwallet\\b|\\bseed phrase\\b/g, score: 0.10, flag: \"spam_kw_crypto\" },\n    { re: /\\bdelivery failed\\b|\\breschedule\\b|\\bpackage\\b|\\bcourier\\b/g, score: 0.10, flag: \"spam_kw_delivery\" },\n    { re: /\\btax refund\\b|\\bunpaid\\b|\\brefund\\b|\\bchargeback\\b/g, score: 0.10, flag: \"spam_kw_refund\" },\n  ];\n\n  let addScore = 0;\n  const addFlags: string[] = [];\n  let hitCount = 0;\n\n  for (const p of patterns) {\n    const m = t.match(p.re);\n    if (m && m.length > 0) {\n      hitCount += m.length;\n      addScore += p.score; // suma “por patrón”, no por ocurrencia (controlado)\n      addFlags.push(p.flag);\n    }\n  }\n\n  // cap para no sobre-castigar\n  addScore = Math.min(0.35, addScore);\n\n  if (hitCount > 0) addFlags.push(\"spam_keywords_en\");\n\n  return { addScore, addFlags, hitCount };\n}\n\n/**\n * Gate principal (producto): deterministic + barato.\n */\nexport function gateLLM(text: string, config: GateConfig = {}): GateResult {\n  const warnT = config.warnThreshold ?? 0.25;\n  const blockT = config.blockThreshold ?? 0.6;\n\n  const r = runEntropyFilter(text);\n\n  // base\n  let score = r.entropy_analysis.score;\n  let flags = [...r.entropy_analysis.flags];\n\n  // booster EN\n  const booster = englishSpamBooster(text);\n  if (booster.hitCount > 0) {\n    score = clamp01(score + booster.addScore);\n    flags = mergeFlags(flags, booster.addFlags);\n  }\n\n  // intención base (intention.ts)\n  let intention = r.intention_evaluation.intention || \"unknown\";\n  let confidence = r.intention_evaluation.confidence ?? 0;\n  let rationale = r.intention_evaluation.rationale ?? \"\";\n\n  // si pegó booster EN y quedó unknown → marketing_spam\n  if (booster.hitCount > 0 && intention === \"unknown\") {\n    intention = \"marketing_spam\";\n    confidence = Math.max(confidence, 0.75);\n    rationale = (rationale ? rationale + \" \" : \"\") + \"Detecté keywords típicas de spam/phishing en inglés.\";\n  }\n\n  // reglas fuertes (para BLOCK “vendible”)\n  const hasSpam =\n    flags.includes(\"spam_sales\") ||\n    flags.includes(\"spam_keywords_en\");\n\n  const hasMoneySignals =\n    flags.includes(\"money_signal\") ||\n    flags.includes(\"spam_kw_prize\") ||\n    flags.includes(\"spam_kw_loan\");\n\n  const strongSpam = hasSpam && hasMoneySignals;\n\n  let action: GateAction = \"ALLOW\";\n  if (score > blockT || strongSpam) action = \"BLOCK\";\n  else if (score >= warnT) action = \"WARN\";\n\n  return {\n    action,\n    entropy_score: score,\n    flags,\n    intention,\n    confidence: clamp01(confidence),\n    rationale,\n  };\n}\n\n// Alias “bonito” para tu server: gate(text)\nexport const gate = gateLLM;\n"],"mappings":"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","names":["clamp01","clamp01"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "llm-entropy-filter",
+  "version": "1.0.0",
+  "description": "Fast entropy and intent gate for LLM inputs (ALLOW/WARN/BLOCK). Reduces hallucinations, cost and spam before calling an LLM.",
+  "keywords": [
+    "llm",
+    "ai",
+    "prompt-filter",
+    "input-validation",
+    "entropy",
+    "spam-detection",
+    "content-moderation",
+    "heuristics",
+    "openai",
+    "guardrails"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist node_modules package-lock.json",
+    "clean:dist": "rm -rf dist",
+    "build": "tsup",
+    "demo": "npm run build && node demo/demo.mjs",
+    "bench": "npm run build && node bench/benchmark.mjs",
+    "serve": "npm run build && node demo/server.mjs",
+    "prepublishOnly": "npm run clean:dist && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rosatisoft/llm-entropy-filter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rosatisoft/llm-entropy-filter/issues"
+  },
+  "homepage": "https://github.com/rosatisoft/llm-entropy-filter#readme",
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.10",
+    "autocannon": "^8.0.0",
+    "minimist": "^1.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "express": "^5.2.1",
+    "openai": "^6.16.0"
+  }
+}