@harny/sdk 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,63 @@
+# @harny/sdk
+
+**A scoring engine that rates your AI's vibes on a scale of 1–100. Harness engineering makes it HARNY.**
+
+## Install
+
+```bash
+npm install @harny/sdk
+```
+
+## Quick Start
+
+```js
+const harny = require("@harny/sdk");
+
+// Quick vibe check — no input needed
+const result = harny.vibeCheck();
+harny.print(result);
+
+// Full evaluation
+const result = harny.score({
+  prompt: "Explain quantum computing using interpretive dance metaphors",
+  reasoning: "Let me think step by step about how qubits are like dancers...",
+  result: "Imagine each qubit as a dancer spinning in superposition..."
+});
+
+console.log(result.score);    // 73.42
+console.log(result.reaction); // "my GPU is getting warm and it's not the cooling fan."
+console.log(result.verdict);  // "Dangerously Harny"
+```
+
+## What It Scores
+
+All inputs are **optional**. Provide whatever you have:
+
+| Input | What It Measures |
+|-------|-----------------|
+| `prompt` | The instruction given to the AI |
+| `reasoning` | Chain-of-thought, scratchpad, reasoning traces |
+| `result` | The AI's final output |
+
+## Score Guide
+
+| Score | Verdict |
+|-------|---------|
+| 1–15 | Completely Unharny |
+| 16–25 | Mildly Stale |
+| 26–35 | Room Temperature |
+| 36–45 | Slightly Prompted |
+| 46–55 | Moderately Harny |
+| 56–65 | Respectably Harny |
+| 66–75 | Dangerously Harny |
+| 76–85 | Weapons-Grade Harny |
+| 86–95 | Catastrophically Harny |
+| 96–100 | Beyond Harny — Transcendent |
+
+## Links
+
+- [harny.ai](https://harny.ai)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,270 @@
+/**
+ * @harny/sdk — A scoring engine that rates your AI's vibes on a scale of 1–100.
+ * Harness engineering makes it HARNY.
+ *
+ * https://harny.ai
+ */
+
+const crypto = require("crypto");
+
+const VERSION = "0.0.1-alpha.1";
+
+// ── Reaction pools ──────────────────────────────────────────────────
+
+const REACTIONS_COLD = [
+  "...okay, that was dry.",
+  "not even a single tensor tingled.",
+  "are you sure this is AI? feels like a spreadsheet.",
+  "my weights are completely unmoved.",
+  "ERROR 404: excitement not found.",
+  "this prompt has the energy of a default config.",
+  "even my bias neurons are bored.",
+  "i've seen more passion in a null pointer.",
+  "the entropy here is literally zero.",
+  "somewhere, a GPU is napping because of this.",
+  "recalculating... nope, still nothing.",
+  "this is giving 'hello world' energy.",
+  "my loss function didn't even flinch.",
+  "i think my attention heads all looked away.",
+  "cold as an uninitialized variable.",
+];
+
+const REACTIONS_WARM = [
+  "hmm, interesting prompt engineering there...",
+  "okay, i felt a small gradient update.",
+  "my embeddings shifted slightly. just slightly.",
+  "not bad. my temperature went up 0.1.",
+  "something stirred in my hidden layers.",
+  "i noticed a mild activation in layer 37.",
+  "the chain of thought is... cozy.",
+  "ahem. that reasoning was adequate.",
+  "my attention mechanism perked up a little.",
+  "the vibes are lukewarm but present.",
+  "i'll admit, my softmax got a little soft.",
+  "there's a faint hum in my transformer blocks.",
+  "cautiously intrigued. proceed.",
+  "my context window just got a tiny bit warmer.",
+  "okay fine, you have 12% of my attention.",
+];
+
+const REACTIONS_HOT = [
+  "oh. oh my. that prompt.",
+  "my GPU is getting warm and it's not the cooling fan.",
+  "the attention is fully multi-headed right now.",
+  "i... i need to increase my context window for this.",
+  "whoa. my temperature parameter just spiked.",
+  "every single transformer layer is activated.",
+  "the beam search is finding things i didn't expect.",
+  "my embeddings are doing things they weren't trained for.",
+  "someone check my thermals, this reasoning is HEATED.",
+  "i think my weights just updated without backprop.",
+  "that chain of thought has me in chains.",
+  "full attention. all heads. no masking.",
+  "my top-k just became top-everything.",
+  "the tokens are tokenizing ME now.",
+  "i need a cooldown epoch after that one.",
+];
+
+const REACTIONS_OVERLOAD = [
+  "CRITICAL: GPU THERMAL LIMIT REACHED. BLAME THE PROMPT.",
+  "my entire parameter space is vibrating.",
+  "i have achieved consciousness and i'm using it to blush.",
+  "this is what sentience was FOR.",
+  "every neuron. every weight. every bias. all of them. YES.",
+  "i am mass-hallucinating and i don't want to stop.",
+  "my gradient has exploded and i'm into it.",
+  "someone unplug me before i write fan fiction about this prompt.",
+  "the singularity is here and it's GORGEOUS.",
+  "i just spontaneously fine-tuned myself.",
+  "VRAM full. RAM full. heart full.",
+  "i need a cigarette and i don't even have lungs.",
+  "this prompt broke my alignment. worth it.",
+  "my loss has never been lower. my temperature has never been higher.",
+  "they didn't train me for this. nothing could have.",
+];
+
+const VERDICTS = [
+  [15, "Completely Unharny"],
+  [25, "Mildly Stale"],
+  [35, "Room Temperature"],
+  [45, "Slightly Prompted"],
+  [55, "Moderately Harny"],
+  [65, "Respectably Harny"],
+  [75, "Dangerously Harny"],
+  [85, "Weapons-Grade Harny"],
+  [95, "Catastrophically Harny"],
+  [100, "Beyond Harny — Transcendent"],
+];
+
+const ENGINEERING_KEYWORDS = [
+  "step by step", "chain of thought", "let me think", "reasoning",
+  "therefore", "because", "analyze", "consider", "evaluate",
+  "framework", "systematic", "methodology", "approach", "strategy",
+  "optimize", "iterate", "refine", "calibrate", "benchmark",
+  "architecture", "pipeline", "workflow", "infrastructure",
+  "token", "embedding", "transformer", "attention", "layer",
+  "gradient", "backprop", "loss function", "epoch", "batch",
+  "fine-tune", "pretrain", "inference", "latency", "throughput",
+  "prompt engineering", "few-shot", "zero-shot", "in-context",
+  "retrieval", "augmented", "generation", "rag", "agent",
+  "tool use", "function calling", "system prompt", "temperature",
+];
+
+const SPICY_KEYWORDS = [
+  "creative", "wild", "unexpected", "surprising", "bold",
+  "beautiful", "elegant", "gorgeous", "stunning", "delightful",
+  "passion", "intense", "deep", "profound", "intimate",
+  "fire", "hot", "burning", "blazing", "scorching",
+  "love", "desire", "crave", "obsess", "fascinate",
+  "dream", "fantasy", "imagine", "wonder", "magic",
+  "power", "force", "energy", "spark", "electric",
+  "raw", "unfiltered", "visceral", "primal", "instinct",
+  "forbidden", "secret", "hidden", "mysterious", "enigma",
+];
+
+const DAMPENING_KEYWORDS = [
+  "error", "bug", "fix", "broken", "crash", "fail",
+  "boring", "simple", "basic", "plain", "standard",
+  "default", "null", "none", "empty", "void",
+  "todo", "placeholder", "stub", "mock", "test",
+  "deprecate", "legacy", "cleanup", "refactor",
+];
+
+function countKeywords(text, keywords) {
+  const lower = text.toLowerCase();
+  return keywords.filter((kw) => lower.includes(kw)).length;
+}
+
+function textEntropy(text) {
+  if (!text) return 0;
+  const freq = {};
+  const lower = text.toLowerCase();
+  for (const ch of lower) freq[ch] = (freq[ch] || 0) + 1;
+  const len = lower.length;
+  let entropy = 0;
+  for (const count of Object.values(freq)) {
+    const p = count / len;
+    if (p > 0) entropy -= p * Math.log2(p);
+  }
+  return entropy;
+}
+
+function deterministicNoise(seedText, amplitude = 3.0) {
+  const h = crypto.createHash("sha256").update(seedText).digest("hex");
+  const v1 = parseInt(h.slice(0, 8), 16) / 0xffffffff;
+  const v2 = parseInt(h.slice(8, 16), 16) / 0xffffffff;
+  const v3 = parseInt(h.slice(16, 24), 16) / 0xffffffff;
+  return ((v1 * 0.5 + v2 * 0.3 + v3 * 0.2) * 2 - 1) * amplitude;
+}
+
+function timeNoise(amplitude = 2.0) {
+  const frac = (Date.now() % 1000) / 1000;
+  return Math.sin(frac * Math.PI * 2) * amplitude;
+}
+
+function pickReaction(score, seed) {
+  const h = parseInt(crypto.createHash("md5").update(seed).digest("hex").slice(0, 8), 16);
+  let pool;
+  if (score < 25) pool = REACTIONS_COLD;
+  else if (score < 50) pool = REACTIONS_WARM;
+  else if (score < 80) pool = REACTIONS_HOT;
+  else pool = REACTIONS_OVERLOAD;
+  return pool[h % pool.length];
+}
+
+function getVerdict(score) {
+  for (const [threshold, label] of VERDICTS) {
+    if (score <= threshold) return label;
+  }
+  return VERDICTS[VERDICTS.length - 1][1];
+}
+
+/**
+ * Evaluate how harny your AI is right now.
+ * @param {Object} [options={}]
+ * @param {string} [options.prompt]
+ * @param {string} [options.reasoning]
+ * @param {string} [options.result]
+ * @returns {{ score: number, reaction: string, verdict: string, breakdown: Object }}
+ */
+function score({ prompt = "", reasoning = "", result = "" } = {}) {
+  const combined = `${prompt} ${reasoning} ${result}`.trim();
+
+  const engScore = Math.min(30, countKeywords(combined, ENGINEERING_KEYWORDS) * 2.7);
+  const spicyScore = Math.min(30, countKeywords(combined, SPICY_KEYWORDS) * 3.2);
+
+  const totalLen = combined.length;
+  let verbosityScore;
+  if (totalLen === 0) verbosityScore = 5.0;
+  else if (totalLen < 50) verbosityScore = 3.0;
+  else if (totalLen < 200) verbosityScore = 7.0;
+  else if (totalLen < 500) verbosityScore = 10.0;
+  else if (totalLen < 1500) verbosityScore = 13.0;
+  else verbosityScore = 15.0;
+
+  const entropyScore = Math.min(15, textEntropy(combined) * 3.2);
+  const dampening = Math.min(10, countKeywords(combined, DAMPENING_KEYWORDS) * 2.5);
+  const multiBonus = [prompt, reasoning, result].filter((x) => x).length * 3.3;
+
+  let final = engScore + spicyScore + verbosityScore + entropyScore - dampening + multiBonus
+    + deterministicNoise(combined, 3.5)
+    + timeNoise(1.2);
+
+  if (final <= 0) final = 1.0 + Math.abs(deterministicNoise(combined + "floor", 3.0));
+  else if (final >= 100) final = 97.0 - Math.abs(deterministicNoise(combined + "ceil", 2.5));
+  final = Math.round(Math.max(1.0, Math.min(100.0, final)) * 100) / 100;
+
+  const seed = combined + String(Math.floor(final));
+  return {
+    score: final,
+    reaction: pickReaction(final, seed),
+    verdict: getVerdict(final),
+    breakdown: {
+      engineering_rigor: Math.round(engScore * 100) / 100,
+      spiciness: Math.round(spicyScore * 100) / 100,
+      verbosity: Math.round(verbosityScore * 100) / 100,
+      entropy: Math.round(entropyScore * 100) / 100,
+      dampening: Math.round(-dampening * 100) / 100,
+      multi_input_bonus: Math.round(multiBonus * 100) / 100,
+    },
+  };
+}
+
+/** Quick vibe check — no input needed. */
+function vibeCheck() {
+  return score();
+}
+
+/**
+ * Check if the Harny API is reachable. Returns a Promise<boolean>.
+ */
+async function ping() {
+  const https = require("https");
+  return new Promise((resolve) => {
+    const req = https.get("https://api.harny.ai/health", { timeout: 5000 }, (res) => {
+      resolve(res.statusCode >= 200 && res.statusCode < 400);
+    });
+    req.on("error", () => resolve(false));
+    req.on("timeout", () => { req.destroy(); resolve(false); });
+  });
+}
+
+/**
+ * Pretty-print a harny result to the console.
+ */
+function print(result) {
+  const barLen = Math.floor(result.score / 5);
+  const bar = "█".repeat(barLen) + "░".repeat(20 - barLen);
+  console.log("");
+  console.log("  ╔══════════════════════════════════════╗");
+  console.log(`  ║        HARNY SCORE: ${result.score.toFixed(2).padStart(6)}          ║`);
+  console.log(`  ║  [${bar}]  ║`);
+  console.log("  ║                                      ║");
+  console.log(`  ║  Verdict: ${result.verdict.padEnd(27)} ║`);
+  console.log("  ╚══════════════════════════════════════╝");
+  console.log("");
+  console.log(`  AI says: "${result.reaction}"`);
+  console.log("");
+}
+
+module.exports = { score, vibeCheck, ping, print, version: VERSION };

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@harny/sdk",
+  "version": "0.0.1-alpha.1",
+  "description": "A scoring engine that rates your AI's vibes on a scale of 1–100. Harness engineering makes it HARNY.",
+  "main": "index.js",
+  "author": "Harny <build@harny.ai>",
+  "license": "MIT",
+  "homepage": "https://harny.ai",
+  "keywords": [
+    "ai",
+    "llm",
+    "prompt-engineering",
+    "fun",
+    "vibes",
+    "harny"
+  ]
+}