@hashgraphonline/standards-sdk 0.1.185 → 0.1.186

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es162.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}
+{"version":3,"file":"standards-sdk.es162.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  | '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 '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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"}