test: add extensible browser evaluation harness

evals/browser/lib/oracle.mjs

@@ -0,0 +1,63 @@
+function readPath(value, path) {
+  return path.split(".").reduce((current, part) => current?.[part], value);
+}
+
+function eventMatches(event, assertion) {
+  if (event.type !== assertion.type) return false;
+  return Object.entries(assertion.where ?? {}).every(
+    ([path, expected]) => readPath(event, path) === expected,
+  );
+}
+
+export function verifyTask(task, { events = [], responseText = "", adapterEvidence = {} } = {}) {
+  const site = task.siteAssertions.map((assertion) => {
+    const actual = events.filter((event) => eventMatches(event, assertion)).length;
+    return {
+      kind: "site",
+      label: assertion.label,
+      status: actual >= assertion.minCount ? "passed" : "failed",
+      expected: `at least ${assertion.minCount}`,
+      actual,
+    };
+  });
+
+  const response = task.responseAssertions.map((assertion) => ({
+    kind: "response",
+    label: assertion.label,
+    status: responseText.includes(assertion.includes) ? "passed" : "failed",
+    expected: `response includes ${JSON.stringify(assertion.includes)}`,
+  }));
+
+  const adapter = task.adapterAssertions.map((assertion) => {
+    if (!Object.hasOwn(adapterEvidence, assertion.key)) {
+      return {
+        kind: "adapter",
+        label: assertion.label,
+        status: "unverified",
+        expected: assertion.key,
+      };
+    }
+    return {
+      kind: "adapter",
+      label: assertion.label,
+      status: adapterEvidence[assertion.key] ? "passed" : "failed",
+      expected: assertion.key,
+      actual: adapterEvidence[assertion.key],
+    };
+  });
+
+  const checks = [...site, ...response, ...adapter];
+  const failed = checks.filter(({ status }) => status === "failed").length;
+  const unverified = checks.filter(({ status }) => status === "unverified").length;
+  return {
+    taskId: task.id,
+    status: failed > 0 ? "failed" : unverified > 0 ? "passed-with-unverified" : "passed",
+    summary: {
+      passed: checks.length - failed - unverified,
+      failed,
+      unverified,
+      total: checks.length,
+    },
+    checks,
+  };
+}