jev-web 0.7.2 → 0.9.0

package/src/questions.mjs

@@ -1,39 +1,46 @@
-// jev-web — question normalization for typed-decision models.
-//
-// The model answers three question kinds:
-//   choice — pick one of 2..255 options
-//   score  — ordered levels (2..10); the answer is the expected level index
-//   noul   — yes/no; the answer is p(yes)
-
-export const QUESTION_TYPES = new Set(["choice", "score", "noul"]);
-export const NOUL_OPTIONS = ["no", "yes"];
-
-export function normalizeQuestions(questions) {
-  if (!Array.isArray(questions) || questions.length === 0) {
-    throw new TypeError("questions must be a non-empty array");
-  }
-  return questions.map((q, i) => {
-    const type = q?.type;
-    if (!QUESTION_TYPES.has(type)) {
-      throw new TypeError(`questions[${i}].type must be one of ${[...QUESTION_TYPES].join("|")}`);
-    }
-    const instructions = String(q?.instructions ?? "").trim();
-    if (!instructions) throw new TypeError(`questions[${i}].instructions is required`);
-
-    let options;
-    if (type === "noul") {
-      options = Array.isArray(q.options) && q.options.length ? q.options.map(String) : [...NOUL_OPTIONS];
-      if (options.length !== 2) throw new TypeError(`questions[${i}]: noul takes exactly 2 options`);
-    } else if (type === "choice") {
-      options = (q.options ?? []).map(String);
-      if (options.length < 2) throw new TypeError(`questions[${i}]: choice needs at least 2 options`);
-      if (options.length > 255) throw new TypeError(`questions[${i}]: choice supports at most 255 options`);
-    } else {
-      options = (q.options ?? []).map(String);
-      if (options.length < 2 || options.length > 10) {
-        throw new TypeError(`questions[${i}]: score needs 2-10 ordered levels`);
-      }
-    }
-    return { type, instructions, options, ...(q?.criteria !== undefined ? { criteria: q.criteria } : {}) };
-  });
-}
+// jev-web — question normalization for typed-decision models.
+//
+// The model answers three question kinds:
+//   choice — pick one of 2..255 options
+//   score  — ordered levels (2..10); the answer is the expected level index
+//   noul   — yes/no; the answer is p(yes)
+
+export const QUESTION_TYPES = new Set(["choice", "score", "noul"]);
+export const NOUL_OPTIONS = ["no", "yes"];
+
+export function normalizeQuestions(questions) {
+  if (!Array.isArray(questions) || questions.length === 0) {
+    throw new TypeError("questions must be a non-empty array");
+  }
+  return questions.map((q, i) => {
+    const type = q?.type;
+    if (!QUESTION_TYPES.has(type)) {
+      throw new TypeError(`questions[${i}].type must be one of ${[...QUESTION_TYPES].join("|")}`);
+    }
+    const instructions = String(q?.instructions ?? "").trim();
+    if (!instructions) throw new TypeError(`questions[${i}].instructions is required`);
+
+    let options;
+    if (type === "noul") {
+      options = Array.isArray(q.options) && q.options.length ? q.options.map(String) : [...NOUL_OPTIONS];
+      if (options.length !== 2) throw new TypeError(`questions[${i}]: noul takes exactly 2 options`);
+    } else if (type === "choice") {
+      options = (q.options ?? []).map(String);
+      if (options.length < 2) throw new TypeError(`questions[${i}]: choice needs at least 2 options`);
+      if (options.length > 255) throw new TypeError(`questions[${i}]: choice supports at most 255 options`);
+    } else {
+      options = (q.options ?? []).map(String);
+      if (options.length < 2 || options.length > 10) {
+        throw new TypeError(`questions[${i}]: score needs 2-10 ordered levels`);
+      }
+    }
+    return {
+      type,
+      instructions,
+      options,
+      ...(q?.criteria !== undefined ? { criteria: q.criteria } : {}),
+      // clef renders each field's ID into the record; other families ignore it.
+      ...(q?.id !== undefined ? { id: String(q.id) } : {}),
+    };
+  });
+}

package/src/registry.mjs

@@ -1,156 +1,200 @@
-/**
- * registry.mjs — multi-family runtime for JEV-style typed-decision models.
- *
- * jev-web ships three families today — open-jev (fused DeBERTa graph), Laya
- * (ModernBERT encoder + typed head), Strands Decider 2B (Qwen torso + pointer
- * head), Bekko System One v0 (cross-encoder), and Decision 2.0 (Qwen3 +
- * candidate head) — and any third party can add its own without touching
- * core:
- *
- *   registerDecisionFamily("my-model", {
- *     defaults: { model: "org/my-typed-decision-ONNX", revision: "main" },
- *     create: async (opts) => ({ info, decide(state, questions), dispose? }),
- *   });
- *
- *   const runtime = await createDecisionRuntime({ family: "my-model" });
- *
- * `createDecisionRuntime` tries the requested family, then any `fallback`
- * families in order, reporting each failure through `onFallback`. The returned
- * object always exposes the shared contract:
- *   { info: { family, ... }, decide(state, questions) -> DecideResult, dispose? }
- * where DecideResult is `{ answers, truncated, length, prompts?, timings? }`.
- */
-
-import { createDecider } from "./session.mjs";
-import { DEFAULT_MODEL, DEFAULT_REVISION } from "./config.mjs";
-import {
-  createLayaDecider,
-  LAYA_DEFAULT_MODEL,
-  LAYA_DEFAULT_REVISION,
-  LAYA_DEFAULT_SUBFOLDER,
-} from "./laya.mjs";
-import {
-  createStrandsDecider,
-  STRANDS_DEFAULT_MODEL,
-  STRANDS_DEFAULT_REVISION,
-} from "./strands.mjs";
-import {
-  createBekkoDecider,
-  BEKKO_DEFAULT_MODEL,
-  BEKKO_DEFAULT_REVISION,
-} from "./bekko.mjs";
-import {
-  createDecision2Decider,
-  DECISION2_DEFAULT_MODEL,
-  DECISION2_DEFAULT_REVISION,
-} from "./decision2.mjs";
-import {
-  createKevDecider,
-  KEV_DEFAULT_MODEL,
-  KEV_DEFAULT_REVISION,
-} from "./kev.mjs";
-
-const families = new Map();
-
-/**
- * Register (or replace) a decision family.
- * @param {string} id short stable identifier, e.g. "open-jev"
- * @param {{create:(opts:object)=>Promise<object>, defaults?:object}} descriptor
- */
-export function registerDecisionFamily(id, descriptor) {
-  if (!id || typeof id !== "string") throw new TypeError("registerDecisionFamily: id is required");
-  if (!descriptor || typeof descriptor.create !== "function") {
-    throw new TypeError(`registerDecisionFamily(${id}): descriptor.create is required`);
-  }
-  families.set(id, { defaults: {}, ...descriptor });
-  return id;
-}
-
-/** @returns {string[]} registered family ids in registration order. */
-export function listDecisionFamilies() {
-  return [...families.keys()];
-}
-
-export function getDecisionFamily(id) {
-  return families.get(id) ?? null;
-}
-
-registerDecisionFamily("open-jev", {
-  defaults: { model: DEFAULT_MODEL, revision: DEFAULT_REVISION },
-  create: createDecider,
-});
-
-registerDecisionFamily("laya", {
-  defaults: {
-    model: LAYA_DEFAULT_MODEL,
-    revision: LAYA_DEFAULT_REVISION,
-    subfolder: LAYA_DEFAULT_SUBFOLDER,
-  },
-  create: createLayaDecider,
-});
-
-registerDecisionFamily("strands-decider", {
-  defaults: {
-    model: STRANDS_DEFAULT_MODEL,
-    revision: STRANDS_DEFAULT_REVISION,
-  },
-  create: createStrandsDecider,
-});
-
-registerDecisionFamily("bekko", {
-  defaults: {
-    model: BEKKO_DEFAULT_MODEL,
-    revision: BEKKO_DEFAULT_REVISION,
-  },
-  create: createBekkoDecider,
-});
-
-registerDecisionFamily("decision2", {
-  defaults: {
-    model: DECISION2_DEFAULT_MODEL,
-    revision: DECISION2_DEFAULT_REVISION,
-  },
-  create: createDecision2Decider,
-});
-
-registerDecisionFamily("kev", {
-  defaults: {
-    model: KEV_DEFAULT_MODEL,
-    revision: KEV_DEFAULT_REVISION,
-  },
-  create: createKevDecider,
-});
-
-/**
- * Create a decision runtime, preferring `family` and falling back in order.
- * @param {{family?:string, fallback?:string[], onFallback?:Function}} [opts]
- * @returns {Promise<{info:object, decide:Function, dispose?:Function}>}
- */
-export async function createDecisionRuntime({
-  family = "laya",
-  fallback = [],
-  onFallback = null,
-  ...opts
-} = {}) {
-  const order = [family, ...(Array.isArray(fallback) ? fallback : [])].filter(Boolean);
-  let lastError = null;
-  for (const id of order) {
-    const descriptor = families.get(id);
-    if (!descriptor) {
-      lastError = new Error(`unknown decision family "${id}"`);
-      onFallback?.({ family: id, error: lastError });
-      continue;
-    }
-    try {
-      const runtime = await descriptor.create({ ...descriptor.defaults, ...opts });
-      return {
-        ...runtime,
-        info: { family: id, ...(runtime?.info ?? {}) },
-      };
-    } catch (error) {
-      lastError = error;
-      onFallback?.({ family: id, error });
-    }
-  }
-  throw lastError ?? new Error("createDecisionRuntime: no family could be created");
+/**
+ * registry.mjs — multi-family runtime for JEV-style typed-decision models.
+ *
+ * jev-web ships nine families today — open-jev (fused DeBERTa graph), Laya
+ * (ModernBERT encoder + typed head), Strands Decider 2B (Qwen torso + pointer
+ * head), Bekko System One v0 (cross-encoder), Decision 2.0 (Qwen3 + candidate
+ * head), Kev (Qwen3 + pointer head), Vega 0.8B (frozen Qwen3.5 torso + latent
+ * physics engine), clef (Qwen3 + joint schema head), and Decision 3.0 (d3
+ * code readout) — and any third party can add its own without touching
+ * core:
+ *
+ *   registerDecisionFamily("my-model", {
+ *     defaults: { model: "org/my-typed-decision-ONNX", revision: "main" },
+ *     create: async (opts) => ({ info, decide(state, questions), dispose? }),
+ *   });
+ *
+ *   const runtime = await createDecisionRuntime({ family: "my-model" });
+ *
+ * `createDecisionRuntime` tries the requested family, then any `fallback`
+ * families in order, reporting each failure through `onFallback`. The returned
+ * object always exposes the shared contract:
+ *   { info: { family, ... }, decide(state, questions) -> DecideResult, dispose? }
+ * where DecideResult is `{ answers, truncated, length, prompts?, timings? }`.
+ */
+
+import { createDecider } from "./session.mjs";
+import { DEFAULT_MODEL, DEFAULT_REVISION } from "./config.mjs";
+import {
+  createLayaDecider,
+  LAYA_DEFAULT_MODEL,
+  LAYA_DEFAULT_REVISION,
+  LAYA_DEFAULT_SUBFOLDER,
+} from "./laya.mjs";
+import {
+  createStrandsDecider,
+  STRANDS_DEFAULT_MODEL,
+  STRANDS_DEFAULT_REVISION,
+} from "./strands.mjs";
+import {
+  createBekkoDecider,
+  BEKKO_DEFAULT_MODEL,
+  BEKKO_DEFAULT_REVISION,
+} from "./bekko.mjs";
+import {
+  createDecision2Decider,
+  DECISION2_DEFAULT_MODEL,
+  DECISION2_DEFAULT_REVISION,
+} from "./decision2.mjs";
+import {
+  createKevDecider,
+  KEV_DEFAULT_MODEL,
+  KEV_DEFAULT_REVISION,
+} from "./kev.mjs";
+
+import {
+  createVegaDecider,
+  VEGA_DEFAULT_MODEL,
+  VEGA_DEFAULT_REVISION,
+} from "./vega.mjs";
+
+import {
+  createClefDecider,
+  CLEF_DEFAULT_MODEL,
+  CLEF_DEFAULT_REVISION,
+} from "./clef.mjs";
+
+import {
+  createDecision3Decider,
+  DECISION3_DEFAULT_MODEL,
+  DECISION3_DEFAULT_REVISION,
+} from "./decision3.mjs";
+
+const families = new Map();
+
+/**
+ * Register (or replace) a decision family.
+ * @param {string} id short stable identifier, e.g. "open-jev"
+ * @param {{create:(opts:object)=>Promise<object>, defaults?:object}} descriptor
+ */
+export function registerDecisionFamily(id, descriptor) {
+  if (!id || typeof id !== "string") throw new TypeError("registerDecisionFamily: id is required");
+  if (!descriptor || typeof descriptor.create !== "function") {
+    throw new TypeError(`registerDecisionFamily(${id}): descriptor.create is required`);
+  }
+  families.set(id, { defaults: {}, ...descriptor });
+  return id;
+}
+
+/** @returns {string[]} registered family ids in registration order. */
+export function listDecisionFamilies() {
+  return [...families.keys()];
+}
+
+export function getDecisionFamily(id) {
+  return families.get(id) ?? null;
+}
+
+registerDecisionFamily("open-jev", {
+  defaults: { model: DEFAULT_MODEL, revision: DEFAULT_REVISION },
+  create: createDecider,
+});
+
+registerDecisionFamily("laya", {
+  defaults: {
+    model: LAYA_DEFAULT_MODEL,
+    revision: LAYA_DEFAULT_REVISION,
+    subfolder: LAYA_DEFAULT_SUBFOLDER,
+  },
+  create: createLayaDecider,
+});
+
+registerDecisionFamily("strands-decider", {
+  defaults: {
+    model: STRANDS_DEFAULT_MODEL,
+    revision: STRANDS_DEFAULT_REVISION,
+  },
+  create: createStrandsDecider,
+});
+
+registerDecisionFamily("bekko", {
+  defaults: {
+    model: BEKKO_DEFAULT_MODEL,
+    revision: BEKKO_DEFAULT_REVISION,
+  },
+  create: createBekkoDecider,
+});
+
+registerDecisionFamily("decision2", {
+  defaults: {
+    model: DECISION2_DEFAULT_MODEL,
+    revision: DECISION2_DEFAULT_REVISION,
+  },
+  create: createDecision2Decider,
+});
+
+registerDecisionFamily("kev", {
+  defaults: {
+    model: KEV_DEFAULT_MODEL,
+    revision: KEV_DEFAULT_REVISION,
+  },
+  create: createKevDecider,
+});
+
+registerDecisionFamily("vega", {
+  defaults: {
+    model: VEGA_DEFAULT_MODEL,
+    revision: VEGA_DEFAULT_REVISION,
+  },
+  create: createVegaDecider,
+});
+
+registerDecisionFamily("clef", {
+  defaults: {
+    model: CLEF_DEFAULT_MODEL,
+    revision: CLEF_DEFAULT_REVISION,
+  },
+  create: createClefDecider,
+});
+
+registerDecisionFamily("decision3", {
+  defaults: {
+    model: DECISION3_DEFAULT_MODEL,
+    revision: DECISION3_DEFAULT_REVISION,
+  },
+  create: createDecision3Decider,
+});
+
+/**
+ * Create a decision runtime, preferring `family` and falling back in order.
+ * @param {{family?:string, fallback?:string[], onFallback?:Function}} [opts]
+ * @returns {Promise<{info:object, decide:Function, dispose?:Function}>}
+ */
+export async function createDecisionRuntime({
+  family = "laya",
+  fallback = [],
+  onFallback = null,
+  ...opts
+} = {}) {
+  const order = [family, ...(Array.isArray(fallback) ? fallback : [])].filter(Boolean);
+  let lastError = null;
+  for (const id of order) {
+    const descriptor = families.get(id);
+    if (!descriptor) {
+      lastError = new Error(`unknown decision family "${id}"`);
+      onFallback?.({ family: id, error: lastError });
+      continue;
+    }
+    try {
+      const runtime = await descriptor.create({ ...descriptor.defaults, ...opts });
+      return {
+        ...runtime,
+        info: { family: id, ...(runtime?.info ?? {}) },
+      };
+    } catch (error) {
+      lastError = error;
+      onFallback?.({ family: id, error });
+    }
+  }
+  throw lastError ?? new Error("createDecisionRuntime: no family could be created");
 }