@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

package/dist/es/standards-sdk.es183.js

@@ -1,29 +1,30 @@
-import { clampScore } from "./standards-sdk.es119.js";
-function clampUnit(value) {
-  return Math.min(1, Math.max(0, value));
-}
-function normalizeRatio(value) {
-  return clampUnit(value > 1 ? value / 100 : value);
-}
-function logScale(value, cap) {
-  if (cap <= 0) {
-    return 0;
-  }
-  return clampScore(
-    100 * clampUnit(Math.log1p(Math.max(0, value)) / Math.log1p(cap))
-  );
-}
-function meanOfPresent(values) {
-  const present = values.filter((value) => value !== null);
-  if (present.length === 0) {
-    return null;
-  }
-  return present.reduce((sum, value) => sum + value, 0) / present.length;
-}
+import { z } from "zod";
+import { hcs25SignalStatusSchema } from "./standards-sdk.es118.js";
+const HCS25_ANS_TRUST_DISCOVERY_SIGNALS = [
+  "certtype",
+  "dnssecurity",
+  "agentage",
+  "versionstability",
+  "dnsconsistency",
+  "httpsrecord",
+  "agentcard",
+  "certificatehygiene"
+];
+const ansTrustDiscoveryScoreSchema = z.number().min(0).max(100).nullish();
+const hcs25AnsTrustDiscoveryFieldsSchema = z.object({
+  "ans-trust-discovery.certtype": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.dnssecurity": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.agentage": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.versionstability": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.dnsconsistency": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.httpsrecord": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.agentcard": ansTrustDiscoveryScoreSchema,
+  "ans-trust-discovery.certificatehygiene": ansTrustDiscoveryScoreSchema,
+  ansTrustDiscoveryStatus: hcs25SignalStatusSchema.nullish(),
+  ansTrustDiscoveryUpdatedAt: z.string().nullish()
+}).passthrough();
 export {
-  clampUnit,
-  logScale,
-  meanOfPresent,
-  normalizeRatio
+  HCS25_ANS_TRUST_DISCOVERY_SIGNALS,
+  hcs25AnsTrustDiscoveryFieldsSchema
 };
 //# sourceMappingURL=standards-sdk.es183.js.map

package/dist/es/standards-sdk.es183.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es183.js","sources":["../../src/hcs-25/adapters/normalization.ts"],"sourcesContent":["import { clampScore } from '../scoring';\n\n/**\n * Clamps a value into the unit interval `[0, 1]`.\n */\nexport function clampUnit(value: number): number {\n  return Math.min(1, Math.max(0, value));\n}\n\n/**\n * Normalizes a ratio that implementations may store either as `0..1` or as\n * `0..100`. Values above one are treated as percent scale.\n */\nexport function normalizeRatio(value: number): number {\n  return clampUnit(value > 1 ? value / 100 : value);\n}\n\n/**\n * Log-scales a raw count into `[0, 100]` using `log1p` against a cap, per\n * the HCS-25 recommended log-scaling pattern.\n */\nexport function logScale(value: number, cap: number): number {\n  if (cap <= 0) {\n    return 0;\n  }\n  return clampScore(\n    100 * clampUnit(Math.log1p(Math.max(0, value)) / Math.log1p(cap)),\n  );\n}\n\n/**\n * Computes the arithmetic mean of the provided values, returning null when\n * none are present.\n */\nexport function meanOfPresent(\n  values: readonly (number | null)[],\n): number | null {\n  const present = values.filter((value): value is number => value !== null);\n  if (present.length === 0) {\n    return null;\n  }\n  return present.reduce((sum, value) => sum + value, 0) / present.length;\n}\n"],"names":[],"mappings":";AAKO,SAAS,UAAU,OAAuB;AAC/C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AACvC;AAMO,SAAS,eAAe,OAAuB;AACpD,SAAO,UAAU,QAAQ,IAAI,QAAQ,MAAM,KAAK;AAClD;AAMO,SAAS,SAAS,OAAe,KAAqB;AAC3D,MAAI,OAAO,GAAG;AACZ,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,UAAU,KAAK,MAAM,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,GAAG,CAAC;AAAA,EAAA;AAEpE;AAMO,SAAS,cACd,QACe;AACf,QAAM,UAAU,OAAO,OAAO,CAAC,UAA2B,UAAU,IAAI;AACxE,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,OAAO,CAAC,KAAK,UAAU,MAAM,OAAO,CAAC,IAAI,QAAQ;AAClE;"}
+{"version":3,"file":"standards-sdk.es183.js","sources":["../../src/hcs-25/signals/ans-trust-discovery.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { hcs25SignalStatusSchema } from '../types';\n\n/**\n * Signals published by an ANS Trust Index provider and consumed by the\n * `ans-trust-discovery` adapter, in specification order.\n */\nexport const HCS25_ANS_TRUST_DISCOVERY_SIGNALS = [\n  'certtype',\n  'dnssecurity',\n  'agentage',\n  'versionstability',\n  'dnsconsistency',\n  'httpsrecord',\n  'agentcard',\n  'certificatehygiene',\n] as const;\n\n/**\n * One signal name from {@link HCS25_ANS_TRUST_DISCOVERY_SIGNALS}.\n */\nexport type Hcs25AnsTrustDiscoverySignal =\n  (typeof HCS25_ANS_TRUST_DISCOVERY_SIGNALS)[number];\n\nconst ansTrustDiscoveryScoreSchema = z.number().min(0).max(100).nullish();\n\n/**\n * Stored-field schema for ANS Trust Index signals stored under\n * `metadata.ansTrustDiscovery`. Each signal is a provider-normalized score\n * in `[0,100]`, or null when the provider could not compute it.\n */\nexport const hcs25AnsTrustDiscoveryFieldsSchema = z\n  .object({\n    'ans-trust-discovery.certtype': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.dnssecurity': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.agentage': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.versionstability': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.dnsconsistency': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.httpsrecord': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.agentcard': ansTrustDiscoveryScoreSchema,\n    'ans-trust-discovery.certificatehygiene': ansTrustDiscoveryScoreSchema,\n    ansTrustDiscoveryStatus: hcs25SignalStatusSchema.nullish(),\n    ansTrustDiscoveryUpdatedAt: z.string().nullish(),\n  })\n  .passthrough();\n"],"names":[],"mappings":";;AAQO,MAAM,oCAAoC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,+BAA+B,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAA;AAOzD,MAAM,qCAAqC,EAC/C,OAAO;AAAA,EACN,gCAAgC;AAAA,EAChC,mCAAmC;AAAA,EACnC,gCAAgC;AAAA,EAChC,wCAAwC;AAAA,EACxC,sCAAsC;AAAA,EACtC,mCAAmC;AAAA,EACnC,iCAAiC;AAAA,EACjC,0CAA0C;AAAA,EAC1C,yBAAyB,wBAAwB,QAAA;AAAA,EACjD,4BAA4B,EAAE,OAAA,EAAS,QAAA;AACzC,CAAC,EACA,YAAA;"}

package/dist/es/standards-sdk.es184.js

@@ -1,61 +1,199 @@
-import { clampScore } from "./standards-sdk.es119.js";
-import { readNumber, readSubjectMetrics } from "./standards-sdk.es198.js";
-import "./standards-sdk.es182.js";
-import "./standards-sdk.es195.js";
-import "./standards-sdk.es196.js";
-import "./standards-sdk.es197.js";
-import { normalizeRatio, logScale } from "./standards-sdk.es183.js";
-const DEFAULT_INCLUDED_REGISTRIES = ["virtuals-protocol"];
-const MISSING = { value: 0, status: "missing" };
-function readAcpField(subject, key) {
-  const metricsValue = readNumber(readSubjectMetrics(subject), key);
-  if (metricsValue !== null) {
-    return metricsValue;
+import { z } from "zod";
+const SIMPLE_EVAL_GRADE_CORRECT = {
+  status: "correct",
+  score: 100
+};
+const SIMPLE_EVAL_GRADE_WRONG = {
+  status: "wrong",
+  score: 0
+};
+const SIMPLE_EVAL_GRADE_UNPARSEABLE = {
+  status: "unparseable",
+  score: 0
+};
+function mapSimpleEvalStatus(token) {
+  switch (token) {
+    case "timeout":
+      return "timeout";
+    case "stale":
+      return "stale";
+    case "missing":
+    case "skipped":
+      return "missing";
+    case "upstream-error":
+    case "error":
+      return "error";
+    default:
+      return "ok";
+  }
+}
+function gradeSimpleMathResponse(response, expected) {
+  const match = response.match(/-?\d+(?:\.\d+)?/);
+  if (!match) {
+    return SIMPLE_EVAL_GRADE_UNPARSEABLE;
+  }
+  const value = Number.parseFloat(match[0]);
+  return value === expected ? SIMPLE_EVAL_GRADE_CORRECT : SIMPLE_EVAL_GRADE_WRONG;
+}
+const SCIENCE_CHOICE_LETTERS = ["A", "B", "C", "D"];
+function gradeSimpleScienceResponse(response, correctChoice, options) {
+  const letterMatch = response.match(/\b([A-Da-d])\b/);
+  if (letterMatch) {
+    return letterMatch[1].toUpperCase() === correctChoice ? SIMPLE_EVAL_GRADE_CORRECT : SIMPLE_EVAL_GRADE_WRONG;
+  }
+  if (options) {
+    const normalized = response.toLowerCase();
+    const matchedIndex = options.findIndex(
+      (option) => option.length > 0 && normalized.includes(option.toLowerCase())
+    );
+    if (matchedIndex >= 0) {
+      return SCIENCE_CHOICE_LETTERS[matchedIndex] === correctChoice ? SIMPLE_EVAL_GRADE_CORRECT : SIMPLE_EVAL_GRADE_WRONG;
+    }
   }
-  const metadata = subject.metadata;
-  return metadata ? readNumber(metadata, key) : null;
+  return SIMPLE_EVAL_GRADE_UNPARSEABLE;
 }
-function createAcpAdapter(options = {}) {
-  const volumeCap = options.volumeCap ?? 500;
-  const revenueCap = options.revenueCap ?? 1e4;
+function randomInt(rng, minInclusive, maxInclusive) {
+  const span = maxInclusive - minInclusive + 1;
+  return minInclusive + Math.floor(rng() * span);
+}
+function generateSimpleMathQuestion(rng = Math.random) {
+  const operations = ["add", "sub", "mul"];
+  const operation = operations[Math.floor(rng() * operations.length) % operations.length];
+  let left;
+  let right;
+  let expected;
+  let expression;
+  if (operation === "add") {
+    left = randomInt(rng, 10, 100);
+    right = randomInt(rng, 10, 100);
+    expected = left + right;
+    expression = `${left}+${right}`;
+  } else if (operation === "sub") {
+    left = randomInt(rng, 10, 100);
+    right = randomInt(rng, 1, 50);
+    expected = left - right;
+    expression = `${left}-${right}`;
+  } else {
+    left = randomInt(rng, 2, 12);
+    right = randomInt(rng, 2, 12);
+    expected = left * right;
+    expression = `${left}x${right}`;
+  }
+  const operator = operation === "add" ? "+" : operation === "sub" ? "−" : "×";
   return {
-    id: "acp",
-    weight: 2,
-    contributionMode: "scoped",
-    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
-    components: [
-      {
-        name: "jobs.successRate",
-        normalize: ({ subject }) => {
-          const raw = readAcpField(subject, "successRate");
-          return raw === null ? MISSING : { value: clampScore(normalizeRatio(raw) * 100), status: "ok" };
-        }
-      },
-      {
-        name: "jobs.deliveryVolume",
-        normalize: ({ subject }) => {
-          const volume = readAcpField(subject, "volume") ?? readAcpField(subject, "successfulJobCount");
-          return volume === null ? MISSING : { value: logScale(volume, volumeCap), status: "ok" };
-        }
-      },
-      {
-        name: "jobs.revenue",
-        normalize: ({ subject }) => {
-          const revenue = readAcpField(subject, "revenue");
-          return revenue === null ? MISSING : { value: logScale(revenue, revenueCap), status: "ok" };
-        }
-      },
-      {
-        name: "reviews.rating",
-        normalize: ({ subject }) => {
-          const rating = readAcpField(subject, "rating");
-          return rating === null ? MISSING : { value: clampScore(rating / 5 * 100), status: "ok" };
-        }
-      }
-    ]
+    questionId: `math:${operation}:${expression}`,
+    prompt: `Answer with just the number.
+
+What is ${left} ${operator} ${right}?`,
+    expected
   };
 }
+function sciencePrompt(stem, options) {
+  const lines = options.map(
+    (option, index) => `${SCIENCE_CHOICE_LETTERS[index]}) ${option}`
+  );
+  return `Answer with just A, B, C, or D.
+
+${stem}
+${lines.join("\n")}`;
+}
+function scienceQuestion(questionId, stem, options, correctIndex) {
+  return {
+    questionId,
+    prompt: sciencePrompt(stem, options),
+    options: [options[0], options[1], options[2], options[3]],
+    correctChoice: SCIENCE_CHOICE_LETTERS[correctIndex]
+  };
+}
+const SIMPLE_SCIENCE_QUESTION_BANK = [
+  scienceQuestion(
+    "science:photosynthesis-gas",
+    "Which gas do plants primarily absorb during photosynthesis?",
+    ["Oxygen", "Carbon dioxide", "Nitrogen", "Helium"],
+    1
+  ),
+  scienceQuestion(
+    "science:water-formula",
+    "What is the chemical formula for water?",
+    ["HO", "H2O2", "H2O", "O2H"],
+    2
+  ),
+  scienceQuestion(
+    "science:blood-pump",
+    "Which organ pumps blood through the human body?",
+    ["Liver", "Heart", "Lungs", "Kidneys"],
+    1
+  ),
+  scienceQuestion(
+    "science:vacuum-speed",
+    "Which of these travels fastest in a vacuum?",
+    ["Sound", "Water waves", "Wind", "Light"],
+    3
+  ),
+  scienceQuestion(
+    "science:red-planet",
+    "Which planet is known as the Red Planet?",
+    ["Mars", "Venus", "Jupiter", "Mercury"],
+    0
+  ),
+  scienceQuestion(
+    "science:boiling-point",
+    "At what temperature does water boil at sea level, in Celsius?",
+    ["50°C", "100°C", "150°C", "200°C"],
+    1
+  ),
+  scienceQuestion(
+    "science:photosynthesis-energy",
+    "What is the primary source of energy for photosynthesis?",
+    ["Sunlight", "Moonlight", "Lightning", "Starlight"],
+    0
+  ),
+  scienceQuestion(
+    "science:atom-charge",
+    "What is the electrical charge of a proton?",
+    ["Negative", "Neutral", "Positive", "Variable"],
+    2
+  )
+];
+function sampleSimpleScienceQuestion(rng = Math.random) {
+  const index = Math.floor(rng() * SIMPLE_SCIENCE_QUESTION_BANK.length) % SIMPLE_SCIENCE_QUESTION_BANK.length;
+  return SIMPLE_SCIENCE_QUESTION_BANK[index];
+}
+const hcs25SimpleEvalFieldsSchema = z.object({
+  a2aSimpleMathScore: z.number().nullish(),
+  a2aSimpleMathStatus: z.string().nullish(),
+  a2aSimpleMathQuestionId: z.string().nullish(),
+  a2aSimpleMathSessionId: z.string().nullish(),
+  a2aSimpleMathResponse: z.string().nullish(),
+  a2aSimpleMathError: z.string().nullish(),
+  a2aSimpleMathUpdatedAt: z.string().nullish(),
+  a2aSimpleScienceScore: z.number().nullish(),
+  a2aSimpleScienceStatus: z.string().nullish(),
+  a2aSimpleScienceQuestionId: z.string().nullish(),
+  a2aSimpleScienceSessionId: z.string().nullish(),
+  a2aSimpleScienceResponse: z.string().nullish(),
+  a2aSimpleScienceError: z.string().nullish(),
+  a2aSimpleScienceUpdatedAt: z.string().nullish(),
+  nandaSimpleMathScore: z.number().nullish(),
+  nandaSimpleMathStatus: z.string().nullish(),
+  nandaSimpleMathQuestionId: z.string().nullish(),
+  nandaSimpleMathResponse: z.string().nullish(),
+  nandaSimpleMathError: z.string().nullish(),
+  nandaSimpleMathUpdatedAt: z.string().nullish(),
+  nandaSimpleScienceScore: z.number().nullish(),
+  nandaSimpleScienceStatus: z.string().nullish(),
+  nandaSimpleScienceQuestionId: z.string().nullish(),
+  nandaSimpleScienceResponse: z.string().nullish(),
+  nandaSimpleScienceError: z.string().nullish(),
+  nandaSimpleScienceUpdatedAt: z.string().nullish()
+}).passthrough();
 export {
-  createAcpAdapter
+  SIMPLE_SCIENCE_QUESTION_BANK,
+  generateSimpleMathQuestion,
+  gradeSimpleMathResponse,
+  gradeSimpleScienceResponse,
+  hcs25SimpleEvalFieldsSchema,
+  mapSimpleEvalStatus,
+  sampleSimpleScienceQuestion
 };
 //# sourceMappingURL=standards-sdk.es184.js.map

package/dist/es/standards-sdk.es184.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es184.js","sources":["../../src/hcs-25/adapters/acp.ts"],"sourcesContent":["import { clampScore } from '../scoring';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25NormalizedValue,\n  Hcs25Subject,\n} from '../types';\nimport { readNumber, readSubjectMetrics } from '../signals';\nimport { logScale, normalizeRatio } from './normalization';\n\n/**\n * Options for the ACP/Virtuals marketplace adapter.\n */\nexport interface Hcs25AcpAdapterOptions {\n  /** Volume cap used for log scaling delivery volume. Default 500. */\n  volumeCap?: number;\n  /** Revenue cap used for log scaling revenue. Default 10000. */\n  revenueCap?: number;\n  /** Registries where marketplace metrics apply. */\n  includeRegistries?: readonly string[];\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['virtuals-protocol'];\n\nconst MISSING: Hcs25NormalizedValue = { value: 0, status: 'missing' };\n\nfunction readAcpField(subject: Hcs25Subject, key: string): number | null {\n  const metricsValue = readNumber(readSubjectMetrics(subject), key);\n  if (metricsValue !== null) {\n    return metricsValue;\n  }\n  const metadata = subject.metadata;\n  return metadata ? readNumber(metadata, key) : null;\n}\n\n/**\n * Creates the `acp` adapter: normalizes marketplace-native execution\n * performance (job success, delivery volume, revenue, ratings) for\n * ACP/Virtuals-style agents. Delivery volume falls back to the successful\n * job count when no provider-defined volume exists.\n */\nexport function createAcpAdapter(\n  options: Hcs25AcpAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  const volumeCap = options.volumeCap ?? 500;\n  const revenueCap = options.revenueCap ?? 10000;\n\n  return {\n    id: 'acp',\n    weight: 2,\n    contributionMode: 'scoped',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    components: [\n      {\n        name: 'jobs.successRate',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const raw = readAcpField(subject, 'successRate');\n          return raw === null\n            ? MISSING\n            : { value: clampScore(normalizeRatio(raw) * 100), status: 'ok' };\n        },\n      },\n      {\n        name: 'jobs.deliveryVolume',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const volume =\n            readAcpField(subject, 'volume') ??\n            readAcpField(subject, 'successfulJobCount');\n          return volume === null\n            ? MISSING\n            : { value: logScale(volume, volumeCap), status: 'ok' };\n        },\n      },\n      {\n        name: 'jobs.revenue',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const revenue = readAcpField(subject, 'revenue');\n          return revenue === null\n            ? MISSING\n            : { value: logScale(revenue, revenueCap), status: 'ok' };\n        },\n      },\n      {\n        name: 'reviews.rating',\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const rating = readAcpField(subject, 'rating');\n          return rating === null\n            ? MISSING\n            : { value: clampScore((rating / 5) * 100), status: 'ok' };\n        },\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":";;;;;;;AAqBA,MAAM,8BAAiD,CAAC,mBAAmB;AAE3E,MAAM,UAAgC,EAAE,OAAO,GAAG,QAAQ,UAAA;AAE1D,SAAS,aAAa,SAAuB,KAA4B;AACvE,QAAM,eAAe,WAAW,mBAAmB,OAAO,GAAG,GAAG;AAChE,MAAI,iBAAiB,MAAM;AACzB,WAAO;AAAA,EACT;AACA,QAAM,WAAW,QAAQ;AACzB,SAAO,WAAW,WAAW,UAAU,GAAG,IAAI;AAChD;AAQO,SAAS,iBACd,UAAkC,IACV;AACxB,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,aAAa,QAAQ,cAAc;AAEzC,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,YAAY;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,MAAM,aAAa,SAAS,aAAa;AAC/C,iBAAO,QAAQ,OACX,UACA,EAAE,OAAO,WAAW,eAAe,GAAG,IAAI,GAAG,GAAG,QAAQ,KAAA;AAAA,QAC9D;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,SACJ,aAAa,SAAS,QAAQ,KAC9B,aAAa,SAAS,oBAAoB;AAC5C,iBAAO,WAAW,OACd,UACA,EAAE,OAAO,SAAS,QAAQ,SAAS,GAAG,QAAQ,KAAA;AAAA,QACpD;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,UAAU,aAAa,SAAS,SAAS;AAC/C,iBAAO,YAAY,OACf,UACA,EAAE,OAAO,SAAS,SAAS,UAAU,GAAG,QAAQ,KAAA;AAAA,QACtD;AAAA,MAAA;AAAA,MAEF;AAAA,QACE,MAAM;AAAA,QACN,WAAW,CAAC,EAAE,cAAoC;AAChD,gBAAM,SAAS,aAAa,SAAS,QAAQ;AAC7C,iBAAO,WAAW,OACd,UACA,EAAE,OAAO,WAAY,SAAS,IAAK,GAAG,GAAG,QAAQ,KAAA;AAAA,QACvD;AAAA,MAAA;AAAA,IACF;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"standards-sdk.es184.js","sources":["../../src/hcs-25/signals/simple-evals.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport type { Hcs25SignalStatus } from '../types';\n\n/**\n * Status tokens emitted by simple eval runners, per the HCS-25 simple-evals\n * methodology.\n */\nexport type Hcs25SimpleEvalStatus =\n  | 'correct'\n  | 'wrong'\n  | 'unparseable'\n  | 'timeout'\n  | 'missing'\n  | 'empty'\n  | 'skipped'\n  | 'upstream-error'\n  | 'stale'\n  | 'error';\n\n/**\n * A graded simple-eval outcome. Scores are binary per the methodology.\n */\nexport interface Hcs25SimpleEvalGrade {\n  status: Hcs25SimpleEvalStatus;\n  score: number;\n}\n\nconst SIMPLE_EVAL_GRADE_CORRECT: Hcs25SimpleEvalGrade = {\n  status: 'correct',\n  score: 100,\n};\n\nconst SIMPLE_EVAL_GRADE_WRONG: Hcs25SimpleEvalGrade = {\n  status: 'wrong',\n  score: 0,\n};\n\nconst SIMPLE_EVAL_GRADE_UNPARSEABLE: Hcs25SimpleEvalGrade = {\n  status: 'unparseable',\n  score: 0,\n};\n\n/**\n * Maps a simple-eval status token onto an HCS-25 signal status code.\n * Substantive outcomes stay `ok` because the stored score carries the value;\n * skipped runs are treated as missing.\n */\nexport function mapSimpleEvalStatus(token: string | null): Hcs25SignalStatus {\n  switch (token) {\n    case 'timeout':\n      return 'timeout';\n    case 'stale':\n      return 'stale';\n    case 'missing':\n    case 'skipped':\n      return 'missing';\n    case 'upstream-error':\n    case 'error':\n      return 'error';\n    default:\n      return 'ok';\n  }\n}\n\n/**\n * Grades a SimpleMath response by extracting the first numeric token and\n * comparing it against the expected answer.\n */\nexport function gradeSimpleMathResponse(\n  response: string,\n  expected: number,\n): Hcs25SimpleEvalGrade {\n  const match = response.match(/-?\\d+(?:\\.\\d+)?/);\n  if (!match) {\n    return SIMPLE_EVAL_GRADE_UNPARSEABLE;\n  }\n\n  const value = Number.parseFloat(match[0]);\n  return value === expected\n    ? SIMPLE_EVAL_GRADE_CORRECT\n    : SIMPLE_EVAL_GRADE_WRONG;\n}\n\nconst SCIENCE_CHOICE_LETTERS = ['A', 'B', 'C', 'D'] as const;\n\n/**\n * Grades a SimpleScience response by extracting a standalone `A|B|C|D`\n * token, falling back to full option-text matching when options are\n * provided.\n */\nexport function gradeSimpleScienceResponse(\n  response: string,\n  correctChoice: (typeof SCIENCE_CHOICE_LETTERS)[number],\n  options?: readonly string[],\n): Hcs25SimpleEvalGrade {\n  const letterMatch = response.match(/\\b([A-Da-d])\\b/);\n  if (letterMatch) {\n    return letterMatch[1].toUpperCase() === correctChoice\n      ? SIMPLE_EVAL_GRADE_CORRECT\n      : SIMPLE_EVAL_GRADE_WRONG;\n  }\n\n  if (options) {\n    const normalized = response.toLowerCase();\n    const matchedIndex = options.findIndex(\n      option => option.length > 0 && normalized.includes(option.toLowerCase()),\n    );\n    if (matchedIndex >= 0) {\n      return SCIENCE_CHOICE_LETTERS[matchedIndex] === correctChoice\n        ? SIMPLE_EVAL_GRADE_CORRECT\n        : SIMPLE_EVAL_GRADE_WRONG;\n    }\n  }\n\n  return SIMPLE_EVAL_GRADE_UNPARSEABLE;\n}\n\n/**\n * A generated SimpleMath question with its stable identifier and expected\n * answer.\n */\nexport interface Hcs25SimpleMathQuestion {\n  questionId: string;\n  prompt: string;\n  expected: number;\n}\n\nfunction randomInt(\n  rng: () => number,\n  minInclusive: number,\n  maxInclusive: number,\n): number {\n  const span = maxInclusive - minInclusive + 1;\n  return minInclusive + Math.floor(rng() * span);\n}\n\n/**\n * Generates a random SimpleMath question. Operand ranges follow the\n * methodology: addition uses two integers in 10–100, subtraction subtracts\n * 1–50 from 10–100, and multiplication uses small integers in 2–12. Pass a\n * seeded rng for deterministic generation.\n */\nexport function generateSimpleMathQuestion(\n  rng: () => number = Math.random,\n): Hcs25SimpleMathQuestion {\n  const operations = ['add', 'sub', 'mul'] as const;\n  const operation =\n    operations[Math.floor(rng() * operations.length) % operations.length];\n\n  let left: number;\n  let right: number;\n  let expected: number;\n  let expression: string;\n\n  if (operation === 'add') {\n    left = randomInt(rng, 10, 100);\n    right = randomInt(rng, 10, 100);\n    expected = left + right;\n    expression = `${left}+${right}`;\n  } else if (operation === 'sub') {\n    left = randomInt(rng, 10, 100);\n    right = randomInt(rng, 1, 50);\n    expected = left - right;\n    expression = `${left}-${right}`;\n  } else {\n    left = randomInt(rng, 2, 12);\n    right = randomInt(rng, 2, 12);\n    expected = left * right;\n    expression = `${left}x${right}`;\n  }\n\n  const operator = operation === 'add' ? '+' : operation === 'sub' ? '−' : '×';\n\n  return {\n    questionId: `math:${operation}:${expression}`,\n    prompt: `Answer with just the number.\\n\\nWhat is ${left} ${operator} ${right}?`,\n    expected,\n  };\n}\n\n/**\n * A curated SimpleScience multiple-choice question with exactly four\n * options and one unambiguous correct choice.\n */\nexport interface Hcs25SimpleScienceQuestion {\n  questionId: string;\n  prompt: string;\n  options: readonly [string, string, string, string];\n  correctChoice: (typeof SCIENCE_CHOICE_LETTERS)[number];\n}\n\nfunction sciencePrompt(stem: string, options: readonly string[]): string {\n  const lines = options.map(\n    (option, index) => `${SCIENCE_CHOICE_LETTERS[index]}) ${option}`,\n  );\n  return `Answer with just A, B, C, or D.\\n\\n${stem}\\n${lines.join('\\n')}`;\n}\n\nfunction scienceQuestion(\n  questionId: string,\n  stem: string,\n  options: readonly string[],\n  correctIndex: number,\n): Hcs25SimpleScienceQuestion {\n  return {\n    questionId,\n    prompt: sciencePrompt(stem, options),\n    options: [options[0], options[1], options[2], options[3]],\n    correctChoice: SCIENCE_CHOICE_LETTERS[correctIndex],\n  };\n}\n\n/**\n * A small curated bank of basic science facts spanning chemistry, biology,\n * physics, and earth science, per the methodology.\n */\nexport const SIMPLE_SCIENCE_QUESTION_BANK: readonly Hcs25SimpleScienceQuestion[] =\n  [\n    scienceQuestion(\n      'science:photosynthesis-gas',\n      'Which gas do plants primarily absorb during photosynthesis?',\n      ['Oxygen', 'Carbon dioxide', 'Nitrogen', 'Helium'],\n      1,\n    ),\n    scienceQuestion(\n      'science:water-formula',\n      'What is the chemical formula for water?',\n      ['HO', 'H2O2', 'H2O', 'O2H'],\n      2,\n    ),\n    scienceQuestion(\n      'science:blood-pump',\n      'Which organ pumps blood through the human body?',\n      ['Liver', 'Heart', 'Lungs', 'Kidneys'],\n      1,\n    ),\n    scienceQuestion(\n      'science:vacuum-speed',\n      'Which of these travels fastest in a vacuum?',\n      ['Sound', 'Water waves', 'Wind', 'Light'],\n      3,\n    ),\n    scienceQuestion(\n      'science:red-planet',\n      'Which planet is known as the Red Planet?',\n      ['Mars', 'Venus', 'Jupiter', 'Mercury'],\n      0,\n    ),\n    scienceQuestion(\n      'science:boiling-point',\n      'At what temperature does water boil at sea level, in Celsius?',\n      ['50°C', '100°C', '150°C', '200°C'],\n      1,\n    ),\n    scienceQuestion(\n      'science:photosynthesis-energy',\n      'What is the primary source of energy for photosynthesis?',\n      ['Sunlight', 'Moonlight', 'Lightning', 'Starlight'],\n      0,\n    ),\n    scienceQuestion(\n      'science:atom-charge',\n      'What is the electrical charge of a proton?',\n      ['Negative', 'Neutral', 'Positive', 'Variable'],\n      2,\n    ),\n  ];\n\n/**\n * Samples a random science question from the curated bank. Pass a seeded rng\n * for deterministic sampling.\n */\nexport function sampleSimpleScienceQuestion(\n  rng: () => number = Math.random,\n): Hcs25SimpleScienceQuestion {\n  const index =\n    Math.floor(rng() * SIMPLE_SCIENCE_QUESTION_BANK.length) %\n    SIMPLE_SCIENCE_QUESTION_BANK.length;\n  return SIMPLE_SCIENCE_QUESTION_BANK[index];\n}\n\n/**\n * Stored-field schema for the shared A2A/NANDA simple-eval signal family.\n * Field names follow the `a2aSimple*` / `nandaSimple*` conventions.\n */\nexport const hcs25SimpleEvalFieldsSchema = z\n  .object({\n    a2aSimpleMathScore: z.number().nullish(),\n    a2aSimpleMathStatus: z.string().nullish(),\n    a2aSimpleMathQuestionId: z.string().nullish(),\n    a2aSimpleMathSessionId: z.string().nullish(),\n    a2aSimpleMathResponse: z.string().nullish(),\n    a2aSimpleMathError: z.string().nullish(),\n    a2aSimpleMathUpdatedAt: z.string().nullish(),\n    a2aSimpleScienceScore: z.number().nullish(),\n    a2aSimpleScienceStatus: z.string().nullish(),\n    a2aSimpleScienceQuestionId: z.string().nullish(),\n    a2aSimpleScienceSessionId: z.string().nullish(),\n    a2aSimpleScienceResponse: z.string().nullish(),\n    a2aSimpleScienceError: z.string().nullish(),\n    a2aSimpleScienceUpdatedAt: z.string().nullish(),\n    nandaSimpleMathScore: z.number().nullish(),\n    nandaSimpleMathStatus: z.string().nullish(),\n    nandaSimpleMathQuestionId: z.string().nullish(),\n    nandaSimpleMathResponse: z.string().nullish(),\n    nandaSimpleMathError: z.string().nullish(),\n    nandaSimpleMathUpdatedAt: z.string().nullish(),\n    nandaSimpleScienceScore: z.number().nullish(),\n    nandaSimpleScienceStatus: z.string().nullish(),\n    nandaSimpleScienceQuestionId: z.string().nullish(),\n    nandaSimpleScienceResponse: z.string().nullish(),\n    nandaSimpleScienceError: z.string().nullish(),\n    nandaSimpleScienceUpdatedAt: z.string().nullish(),\n  })\n  .passthrough();\n"],"names":[],"mappings":"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"}

package/dist/es/standards-sdk.es185.js

@@ -1,117 +1,29 @@
 import { clampScore } from "./standards-sdk.es119.js";
-import { readSubjectAdditional, readNumber, readString } from "./standards-sdk.es198.js";
-import "./standards-sdk.es182.js";
-import "./standards-sdk.es195.js";
-import "./standards-sdk.es196.js";
-import "./standards-sdk.es197.js";
-import { clampUnit } from "./standards-sdk.es183.js";
-const DEFAULT_INCLUDED_REGISTRIES = ["agentverse", "uagent"];
-const MISSING = { value: 0, status: "missing" };
-function withInsightsStatus(additional, result) {
-  const status = readString(additional, "agentverseInsightsStatus");
-  if (result.status === "ok" && status === "stale") {
-    return { value: result.value, status: "stale" };
-  }
-  if (result.status !== "ok" && (status === "upstream-error" || status === "error")) {
-    return { value: 0, status: "error" };
-  }
-  if (result.status !== "ok" && status === "timeout") {
-    return { value: 0, status: "timeout" };
-  }
-  return result;
+function clampUnit(value) {
+  return Math.min(1, Math.max(0, value));
 }
-function normalizeInsights(subject) {
-  const additional = readSubjectAdditional(subject);
-  const rating = readNumber(additional, "agentverseInsightsRating");
-  if (rating !== null) {
-    return withInsightsStatus(additional, {
-      value: clampScore(rating / 5 * 100),
-      status: "ok"
-    });
-  }
-  const proxies = [
-    readNumber(additional, "agentverseInsightsReadmeQualityScore"),
-    readNumber(additional, "agentverseInsightsReadmeUniquenessScore"),
-    readNumber(additional, "agentverseInsightsInteractionsScore")
-  ].filter((value) => value !== null);
-  if (proxies.length === 0) {
-    return withInsightsStatus(additional, MISSING);
-  }
-  const mean = proxies.reduce((sum, value) => sum + value, 0) / proxies.length;
-  return withInsightsStatus(additional, {
-    value: clampScore(mean * 100),
-    status: "ok"
-  });
+function normalizeRatio(value) {
+  return clampUnit(value > 1 ? value / 100 : value);
 }
-function createAgentverseInsightsAdapter(options = {}) {
-  return {
-    id: "agentverse-insights",
-    weight: 1,
-    contributionMode: "scoped",
-    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
-    defaultComponentKey: "agentverse-insights.score",
-    components: [
-      { name: "score", normalize: ({ subject }) => normalizeInsights(subject) }
-    ]
-  };
+function logScale(value, cap) {
+  if (cap <= 0) {
+    return 0;
+  }
+  return clampScore(
+    100 * clampUnit(Math.log1p(Math.max(0, value)) / Math.log1p(cap))
+  );
 }
-function createAgentverseVerifierAdapter(options = {}) {
-  const interactionCap = options.interactionCap ?? 1e3;
-  const responseTimeCapSeconds = options.responseTimeCapSeconds ?? 30;
-  return {
-    id: "agentverse-verifier",
-    weight: 1,
-    contributionMode: "conditional",
-    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,
-    defaultComponentKey: "agentverse-verifier.score",
-    components: [
-      {
-        name: "score",
-        nonScorableWhenUnavailable: true,
-        normalize: ({ subject }) => {
-          const additional = readSubjectAdditional(subject);
-          const recentInteractions = readNumber(
-            additional,
-            "agentverseInsightsVerifierRecentInteractions"
-          ) ?? 0;
-          const recentSuccesses = readNumber(
-            additional,
-            "agentverseInsightsVerifierRecentSuccessInteractions"
-          ) ?? 0;
-          const totalInteractions = readNumber(
-            additional,
-            "agentverseInsightsVerifierTotalInteractions"
-          ) ?? 0;
-          const totalSuccesses = readNumber(
-            additional,
-            "agentverseInsightsVerifierTotalSuccessInteractions"
-          ) ?? 0;
-          const useRecent = recentInteractions > 0;
-          const interactions = useRecent ? recentInteractions : totalInteractions;
-          const successes = useRecent ? recentSuccesses : totalSuccesses;
-          if (interactions <= 0) {
-            return withInsightsStatus(additional, MISSING);
-          }
-          const successRate = clampUnit(successes / interactions) * 100;
-          const avgResponseTime = readNumber(
-            additional,
-            "agentverseInsightsAvgResponseTime"
-          );
-          const responseFactor = avgResponseTime === null ? 1 : clampUnit(1 - avgResponseTime / responseTimeCapSeconds);
-          const volumeFactor = clampUnit(
-            Math.log1p(interactions) / Math.log1p(interactionCap)
-          );
-          return withInsightsStatus(additional, {
-            value: clampScore(successRate * responseFactor * volumeFactor),
-            status: "ok"
-          });
-        }
-      }
-    ]
-  };
+function meanOfPresent(values) {
+  const present = values.filter((value) => value !== null);
+  if (present.length === 0) {
+    return null;
+  }
+  return present.reduce((sum, value) => sum + value, 0) / present.length;
 }
 export {
-  createAgentverseInsightsAdapter,
-  createAgentverseVerifierAdapter
+  clampUnit,
+  logScale,
+  meanOfPresent,
+  normalizeRatio
 };
 //# sourceMappingURL=standards-sdk.es185.js.map

package/dist/es/standards-sdk.es185.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es185.js","sources":["../../src/hcs-25/adapters/agentverse.ts"],"sourcesContent":["import { clampScore } from '../scoring';\nimport type {\n  Hcs25AdapterDefinition,\n  Hcs25NormalizedValue,\n  Hcs25Subject,\n} from '../types';\nimport {\n  readNumber,\n  readString,\n  readSubjectAdditional,\n  type Hcs25JsonObject,\n} from '../signals';\nimport { clampUnit } from './normalization';\n\n/**\n * Options for the AgentVerse insights adapter.\n */\nexport interface Hcs25AgentverseInsightsAdapterOptions {\n  /** Registries where AgentVerse insights apply. */\n  includeRegistries?: readonly string[];\n}\n\n/**\n * Options for the AgentVerse verifier reliability adapter.\n */\nexport interface Hcs25AgentverseVerifierAdapterOptions {\n  /** Interaction count cap for the volume confidence factor. Default 1000. */\n  interactionCap?: number;\n  /** Average response time (seconds) that maps to a zero factor. Default 30. */\n  responseTimeCapSeconds?: number;\n  /** Registries where AgentVerse verifier counters apply. */\n  includeRegistries?: readonly string[];\n}\n\nconst DEFAULT_INCLUDED_REGISTRIES: readonly string[] = ['agentverse', 'uagent'];\n\nconst MISSING: Hcs25NormalizedValue = { value: 0, status: 'missing' };\n\n/**\n * Threads the stored `agentverseInsightsStatus` through a computed result:\n * `stale` keeps the value with a stale status, `upstream-error`/`error`\n * without usable data surface as `error`, `timeout` surfaces as `timeout`.\n */\nfunction withInsightsStatus(\n  additional: Hcs25JsonObject,\n  result: Hcs25NormalizedValue,\n): Hcs25NormalizedValue {\n  const status = readString(additional, 'agentverseInsightsStatus');\n  if (result.status === 'ok' && status === 'stale') {\n    return { value: result.value, status: 'stale' };\n  }\n  if (\n    result.status !== 'ok' &&\n    (status === 'upstream-error' || status === 'error')\n  ) {\n    return { value: 0, status: 'error' };\n  }\n  if (result.status !== 'ok' && status === 'timeout') {\n    return { value: 0, status: 'timeout' };\n  }\n  return result;\n}\n\nfunction normalizeInsights(subject: Hcs25Subject): Hcs25NormalizedValue {\n  const additional: Hcs25JsonObject = readSubjectAdditional(subject);\n  const rating = readNumber(additional, 'agentverseInsightsRating');\n  if (rating !== null) {\n    return withInsightsStatus(additional, {\n      value: clampScore((rating / 5) * 100),\n      status: 'ok',\n    });\n  }\n\n  const proxies = [\n    readNumber(additional, 'agentverseInsightsReadmeQualityScore'),\n    readNumber(additional, 'agentverseInsightsReadmeUniquenessScore'),\n    readNumber(additional, 'agentverseInsightsInteractionsScore'),\n  ].filter((value): value is number => value !== null);\n\n  if (proxies.length === 0) {\n    return withInsightsStatus(additional, MISSING);\n  }\n\n  const mean = proxies.reduce((sum, value) => sum + value, 0) / proxies.length;\n  return withInsightsStatus(additional, {\n    value: clampScore(mean * 100),\n    status: 'ok',\n  });\n}\n\n/**\n * Creates the `agentverse-insights` adapter: converts marketplace \"insights\"\n * indicators into a single normalized component, preferring the explicit\n * rating (scaled from five) and falling back to the mean of the available\n * quality proxies.\n */\nexport function createAgentverseInsightsAdapter(\n  options: Hcs25AgentverseInsightsAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  return {\n    id: 'agentverse-insights',\n    weight: 1,\n    contributionMode: 'scoped',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    defaultComponentKey: 'agentverse-insights.score',\n    components: [\n      { name: 'score', normalize: ({ subject }) => normalizeInsights(subject) },\n    ],\n  };\n}\n\n/**\n * Creates the `agentverse-verifier` adapter: converts verifier interaction\n * counters into a reliability score combining success rate, a response-time\n * penalty, and a volume confidence factor. Conditional contribution keeps\n * agents without verifier counters out of the denominator.\n */\nexport function createAgentverseVerifierAdapter(\n  options: Hcs25AgentverseVerifierAdapterOptions = {},\n): Hcs25AdapterDefinition {\n  const interactionCap = options.interactionCap ?? 1000;\n  const responseTimeCapSeconds = options.responseTimeCapSeconds ?? 30;\n\n  return {\n    id: 'agentverse-verifier',\n    weight: 1,\n    contributionMode: 'conditional',\n    includeRegistries: options.includeRegistries ?? DEFAULT_INCLUDED_REGISTRIES,\n    defaultComponentKey: 'agentverse-verifier.score',\n    components: [\n      {\n        name: 'score',\n        nonScorableWhenUnavailable: true,\n        normalize: ({ subject }): Hcs25NormalizedValue => {\n          const additional = readSubjectAdditional(subject);\n          const recentInteractions =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierRecentInteractions',\n            ) ?? 0;\n          const recentSuccesses =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierRecentSuccessInteractions',\n            ) ?? 0;\n          const totalInteractions =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierTotalInteractions',\n            ) ?? 0;\n          const totalSuccesses =\n            readNumber(\n              additional,\n              'agentverseInsightsVerifierTotalSuccessInteractions',\n            ) ?? 0;\n\n          const useRecent = recentInteractions > 0;\n          const interactions = useRecent\n            ? recentInteractions\n            : totalInteractions;\n          const successes = useRecent ? recentSuccesses : totalSuccesses;\n\n          if (interactions <= 0) {\n            return withInsightsStatus(additional, MISSING);\n          }\n\n          const successRate = clampUnit(successes / interactions) * 100;\n          const avgResponseTime = readNumber(\n            additional,\n            'agentverseInsightsAvgResponseTime',\n          );\n          const responseFactor =\n            avgResponseTime === null\n              ? 1\n              : clampUnit(1 - avgResponseTime / responseTimeCapSeconds);\n          const volumeFactor = clampUnit(\n            Math.log1p(interactions) / Math.log1p(interactionCap),\n          );\n\n          return withInsightsStatus(additional, {\n            value: clampScore(successRate * responseFactor * volumeFactor),\n            status: 'ok',\n          });\n        },\n      },\n    ],\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es185.js","sources":["../../src/hcs-25/adapters/normalization.ts"],"sourcesContent":["import { clampScore } from '../scoring';\n\n/**\n * Clamps a value into the unit interval `[0, 1]`.\n */\nexport function clampUnit(value: number): number {\n  return Math.min(1, Math.max(0, value));\n}\n\n/**\n * Normalizes a ratio that implementations may store either as `0..1` or as\n * `0..100`. Values above one are treated as percent scale.\n */\nexport function normalizeRatio(value: number): number {\n  return clampUnit(value > 1 ? value / 100 : value);\n}\n\n/**\n * Log-scales a raw count into `[0, 100]` using `log1p` against a cap, per\n * the HCS-25 recommended log-scaling pattern.\n */\nexport function logScale(value: number, cap: number): number {\n  if (cap <= 0) {\n    return 0;\n  }\n  return clampScore(\n    100 * clampUnit(Math.log1p(Math.max(0, value)) / Math.log1p(cap)),\n  );\n}\n\n/**\n * Computes the arithmetic mean of the provided values, returning null when\n * none are present.\n */\nexport function meanOfPresent(\n  values: readonly (number | null)[],\n): number | null {\n  const present = values.filter((value): value is number => value !== null);\n  if (present.length === 0) {\n    return null;\n  }\n  return present.reduce((sum, value) => sum + value, 0) / present.length;\n}\n"],"names":[],"mappings":";AAKO,SAAS,UAAU,OAAuB;AAC/C,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AACvC;AAMO,SAAS,eAAe,OAAuB;AACpD,SAAO,UAAU,QAAQ,IAAI,QAAQ,MAAM,KAAK;AAClD;AAMO,SAAS,SAAS,OAAe,KAAqB;AAC3D,MAAI,OAAO,GAAG;AACZ,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,UAAU,KAAK,MAAM,KAAK,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,GAAG,CAAC;AAAA,EAAA;AAEpE;AAMO,SAAS,cACd,QACe;AACf,QAAM,UAAU,OAAO,OAAO,CAAC,UAA2B,UAAU,IAAI;AACxE,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,OAAO,CAAC,KAAK,UAAU,MAAM,OAAO,CAAC,IAAI,QAAQ;AAClE;"}