@simulatte/doppler 0.1.6 → 0.1.8

package/src/inference/browser-harness.js

@@ -1,13 +1,8 @@
 
-import { initializeInference, parseRuntimeOverridesFromURL } from './test-harness.js';
+import { initializeInference } from './test-harness.js';
 import { saveReport } from '../storage/reports.js';
 import { getRuntimeConfig, setRuntimeConfig } from '../config/runtime.js';
-import { initDevice, getKernelCapabilities, getDevice } from '../gpu/device.js';
-import { createPipeline } from './pipelines/text.js';
-import { parseModelConfigFromManifest } from './pipelines/text/config.js';
-import { resolveKernelPathState, activateKernelPathState } from './pipelines/text/model-load.js';
-import { openModelStore, loadManifestFromStore } from '../storage/shard-manager.js';
-import { parseManifest } from '../formats/rdrr/index.js';
+import { clearLogHistory, getDebugSnapshot } from '../debug/history.js';
 import { computeSampleStats } from '../debug/stats.js';
 import {
   setActiveKernelPath,
@@ -15,19 +10,54 @@ import {
   getActiveKernelPathSource,
   getActiveKernelPathPolicy,
 } from '../config/kernel-path-loader.js';
-import {
-  getInferenceLayerPatternContractArtifact,
-  selectRuleValue,
-} from '../rules/rule-registry.js';
-import { mergeRuntimeValues } from '../config/runtime-merge.js';
-import { isPlainObject } from '../utils/plain-object.js';
-import { validateBrowserSuiteMetrics } from '../config/schema/browser-suite-metrics.schema.js';
 import { validateTrainingMetricsReport } from '../config/schema/training-metrics.schema.js';
-import { buildExecutionContractArtifact } from '../config/execution-contract-check.js';
-import { buildManifestRequiredInferenceFieldsArtifact } from '../config/required-inference-fields-contract-check.js';
+import {
+  resolveReportTimestamp,
+  resolveRuntime,
+  cloneRuntimeConfig,
+  runWithRuntimeIsolationForSuite,
+  sanitizeReportOutput,
+  loadRuntimeConfigFromUrl,
+  applyRuntimeConfigFromUrl,
+  loadRuntimePreset,
+  applyRuntimePreset,
+  applyRuntimeForRun,
+  normalizeManifest,
+  mergeRunDefaults,
+  summarizeManifestRuns,
+} from './browser-harness-runtime-helpers.js';
+import {
+  buildSuiteSummary,
+  normalizeCacheMode,
+  normalizeLoadMode,
+  normalizeWorkloadType,
+  assertDiffusionPerformanceArtifact,
+  toTimingNumber,
+  safeToFixed,
+  sampleTimingNumber,
+  buildCanonicalTiming,
+  buildTimingDiagnostics,
+} from './browser-harness-suite-helpers.js';
+import {
+  resolveDeviceInfo,
+  resolveKernelPathForModel,
+  initializeSuiteModel,
+} from './browser-harness-model-helpers.js';
+import {
+  resolveBenchmarkRunSettings,
+  runEmbeddingSemanticChecks,
+  isCoherentOutput,
+  runGeneration,
+  runEmbedding,
+} from './browser-harness-text-helpers.js';
+import { buildSuiteContractMetrics } from './browser-harness-contract-helpers.js';
+import {
+  runDiffusionSuite,
+  runEnergySuite,
+} from './browser-harness-diffusion-energy-suites.js';
+import { collectTrainingArtifactsFromSuiteResult } from './browser-harness-report-helpers.js';
 
 const TRAINING_SUITE_MODULE_PATH = '../training/suite.js';
-const NODE_SOURCE_RUNTIME_MODULE_PATH = '../tooling/node-source-runtime.js';
 let trainingSuiteModulePromise = null;
 
 async function loadTrainingSuiteModule() {
@@ -42,346 +72,20 @@ export async function runTrainingSuite(options = {}) {
   return module.runTrainingSuite(options);
 }
 
+export {
+  loadRuntimeConfigFromUrl,
+  applyRuntimeConfigFromUrl,
+  loadRuntimePreset,
+  applyRuntimePreset,
+  applyRuntimeForRun,
+  buildSuiteSummary,
+};
+
 async function runTrainingBenchSuite(options = {}) {
   const module = await loadTrainingSuiteModule();
   return module.runTrainingBenchSuite(options);
 }
 
-function buildSuiteContractMetrics(suite, baseMetrics, manifest) {
-  const executionContractArtifact = buildExecutionContractArtifact(manifest);
-  const executionV0GraphContractArtifact = executionContractArtifact?.executionV0?.graph ?? null;
-  const layerPatternContractArtifact = getInferenceLayerPatternContractArtifact();
-  const requiredInferenceFieldsArtifact = manifest?.modelType === 'transformer'
-    && isPlainObject(manifest?.inference?.attention)
-    ? buildManifestRequiredInferenceFieldsArtifact(
-      manifest?.inference ?? null,
-      `${manifest?.modelId ?? 'unknown'}.inference`
-    )
-    : null;
-  return validateBrowserSuiteMetrics({
-    ...baseMetrics,
-    schemaVersion: 1,
-    source: 'doppler',
-    suite,
-    ...(executionContractArtifact ? { executionContractArtifact } : {}),
-    executionV0GraphContractArtifact,
-    layerPatternContractArtifact,
-    requiredInferenceFieldsArtifact,
-  });
-}
-
-function parseReportTimestamp(rawTimestamp, label = 'timestamp') {
-  if (rawTimestamp == null) {
-    return null;
-  }
-
-  if (rawTimestamp instanceof Date) {
-    const timestamp = rawTimestamp.getTime();
-    if (!Number.isFinite(timestamp)) {
-      throw new Error(`Invalid ${label}: not a valid Date.`);
-    }
-    return rawTimestamp.toISOString();
-  }
-
-  if (typeof rawTimestamp === 'number') {
-    if (!Number.isFinite(rawTimestamp)) {
-      throw new Error(`Invalid ${label}: must be a finite epoch timestamp.`);
-    }
-    return new Date(rawTimestamp).toISOString();
-  }
-
-  if (typeof rawTimestamp === 'string') {
-    const trimmed = rawTimestamp.trim();
-    if (trimmed.length === 0) {
-      return null;
-    }
-    const numericCandidate = Number(trimmed);
-    if (Number.isFinite(numericCandidate)) {
-      return new Date(numericCandidate).toISOString();
-    }
-    const parsed = new Date(trimmed);
-    if (Number.isNaN(parsed.getTime())) {
-      throw new Error(`Invalid ${label}: expected ISO-8601 string or epoch milliseconds.`);
-    }
-    return parsed.toISOString();
-  }
-
-  throw new Error(`Invalid ${label}: expected Date, ISO-8601 string, epoch milliseconds, or nullish.`);
-}
-
-function resolveReportTimestamp(rawTimestamp, label, fallbackTimestamp = null) {
-  const parsed = parseReportTimestamp(rawTimestamp, label);
-  return parsed ?? (fallbackTimestamp == null ? new Date().toISOString() : String(fallbackTimestamp));
-}
-
-function resolveRuntime(options) {
-  if (options.runtime) return options.runtime;
-  if (options.searchParams) return parseRuntimeOverridesFromURL(options.searchParams);
-  if (typeof globalThis.location === 'undefined') return parseRuntimeOverridesFromURL(new URLSearchParams());
-  return parseRuntimeOverridesFromURL();
-}
-
-function normalizePresetPath(value) {
-  const trimmed = String(value || '').replace(/^[./]+/, '');
-  if (!trimmed) return null;
-  return trimmed.endsWith('.json') ? trimmed : `${trimmed}.json`;
-}
-
-function resolvePresetBaseUrl() {
-  try {
-    return new URL('../config/presets/runtime/', import.meta.url).toString().replace(/\/$/, '');
-  } catch {
-    if (typeof globalThis.location !== 'undefined' && globalThis.location?.href) {
-      return new URL('/src/config/presets/runtime/', globalThis.location.href).toString().replace(/\/$/, '');
-    }
-    return '/src/config/presets/runtime';
-  }
-}
-
-function cloneRuntimeConfig(runtimeConfig) {
-  if (!runtimeConfig) return null;
-  if (typeof structuredClone === 'function') {
-    return structuredClone(runtimeConfig);
-  }
-  return JSON.parse(JSON.stringify(runtimeConfig));
-}
-
-function snapshotRuntimeState() {
-  return {
-    runtimeConfig: cloneRuntimeConfig(getRuntimeConfig()),
-    activeKernelPath: getActiveKernelPath(),
-    activeKernelPathSource: getActiveKernelPathSource(),
-    activeKernelPathPolicy: getActiveKernelPathPolicy(),
-  };
-}
-
-function restoreRuntimeState(snapshot) {
-  if (!snapshot) {
-    return;
-  }
-  setRuntimeConfig(snapshot.runtimeConfig);
-  setActiveKernelPath(
-    snapshot.activeKernelPath,
-    snapshot.activeKernelPathSource || 'none',
-    snapshot.activeKernelPathPolicy ?? null
-  );
-}
-
-async function runWithRuntimeIsolationForSuite(run) {
-  const snapshot = snapshotRuntimeState();
-  try {
-    return await run();
-  } finally {
-    restoreRuntimeState(snapshot);
-  }
-}
-
-function resolveRuntimeFromConfig(config) {
-  if (!config || typeof config !== 'object') return null;
-  if (config.runtime && typeof config.runtime === 'object') return config.runtime;
-  if (config.shared || config.loading || config.inference || config.emulation) return config;
-  return null;
-}
-
-function sanitizeReportOutput(output) {
-  if (output == null) return null;
-  if (typeof output !== 'object') return output;
-  if (ArrayBuffer.isView(output)) {
-    return {
-      type: output.constructor?.name || 'TypedArray',
-      length: Number.isFinite(output.length) ? output.length : null,
-    };
-  }
-  if (
-    Number.isFinite(output?.width)
-    && Number.isFinite(output?.height)
-    && ArrayBuffer.isView(output?.pixels)
-  ) {
-    const { pixels, ...rest } = output;
-    return {
-      ...rest,
-      width: output.width,
-      height: output.height,
-      pixels: {
-        type: pixels.constructor?.name || 'TypedArray',
-        length: Number.isFinite(pixels.length) ? pixels.length : null,
-      },
-    };
-  }
-  return output;
-}
-
-function normalizeExtends(value) {
-  if (Array.isArray(value)) {
-    return value.map((entry) => String(entry || '').trim()).filter(Boolean);
-  }
-  if (typeof value === 'string') {
-    const trimmed = value.trim();
-    return trimmed ? [trimmed] : [];
-  }
-  return [];
-}
-
-function normalizeExtendsPath(value) {
-  const trimmed = String(value || '').trim();
-  if (!trimmed) return null;
-  return trimmed.endsWith('.json') ? trimmed : `${trimmed}.json`;
-}
-
-function resolveAbsoluteUrl(target, base) {
-  try {
-    if (base) {
-      return new URL(target, base).toString();
-    }
-    if (typeof globalThis.location !== 'undefined' && globalThis.location?.href) {
-      return new URL(target, globalThis.location.href).toString();
-    }
-    return new URL(target, import.meta.url).toString();
-  } catch {
-    return target;
-  }
-}
-
-function isAbsoluteUrl(value) {
-  return /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(value);
-}
-
-function joinUrl(base, path) {
-  if (!base) return path;
-  if (isAbsoluteUrl(base)) {
-    return new URL(path, base.endsWith('/') ? base : `${base}/`).toString();
-  }
-  const normalizedBase = base.replace(/\/$/, '');
-  const normalizedPath = path.replace(/^\//, '');
-  return `${normalizedBase}/${normalizedPath}`;
-}
-
-function resolveExtendCandidates(ref, context) {
-  const normalized = normalizeExtendsPath(ref);
-  if (!normalized) return [];
-  if (isAbsoluteUrl(normalized) || normalized.startsWith('/')) {
-    return [normalized];
-  }
-  if (normalized.startsWith('./') || normalized.startsWith('../')) {
-    return [resolveAbsoluteUrl(normalized, context.sourceUrl)];
-  }
-  if (normalized.includes('/')) {
-    return [joinUrl(context.presetBaseUrl, normalized)];
-  }
-  const candidates = [];
-  if (context.presetBaseUrl) {
-    candidates.push(joinUrl(context.presetBaseUrl, normalized));
-    candidates.push(joinUrl(context.presetBaseUrl, `modes/${normalized}`));
-  }
-  if (context.sourceUrl) {
-    const sourceDir = resolveAbsoluteUrl('./', context.sourceUrl);
-    candidates.push(resolveAbsoluteUrl(normalized, sourceDir));
-  }
-  return [...new Set(candidates)];
-}
-
-async function fetchRuntimeConfig(url, options = {}) {
-  const response = await fetch(url, { signal: options.signal });
-  if (!response.ok) {
-    const error = new Error(`Failed to load runtime config: ${response.status}`);
-    error.code = response.status === 404 ? 'runtime_config_not_found' : 'runtime_config_fetch_failed';
-    throw error;
-  }
-  return response.json();
-}
-
-async function resolveRuntimeConfigExtends(config, context) {
-  const runtime = resolveRuntimeFromConfig(config);
-  if (!runtime) {
-    throw new Error('Runtime config is missing runtime fields');
-  }
-
-  const extendsRefs = normalizeExtends(config.extends);
-  let mergedRuntime = null;
-  let mergedConfig = null;
-
-  for (const ref of extendsRefs) {
-    const base = await loadRuntimeConfigFromRef(ref, context);
-    mergedRuntime = mergedRuntime ? mergeRuntimeValues(mergedRuntime, base.runtime) : base.runtime;
-    mergedConfig = mergedConfig ? mergeRuntimeValues(mergedConfig, base.config) : base.config;
-  }
-
-  const combinedRuntime = mergedRuntime ? mergeRuntimeValues(mergedRuntime, runtime) : runtime;
-  const combinedConfig = mergedConfig ? mergeRuntimeValues(mergedConfig, config) : { ...config };
-  const resolved = { ...combinedConfig, runtime: combinedRuntime };
-  if (resolved.extends !== undefined) {
-    delete resolved.extends;
-  }
-  return { config: resolved, runtime: combinedRuntime };
-}
-
-async function loadRuntimeConfigChain(url, options = {}, stack = []) {
-  const presetBaseUrl = options.presetBaseUrl || options.baseUrl || resolvePresetBaseUrl();
-  const resolvedUrl = resolveAbsoluteUrl(url);
-  if (stack.includes(resolvedUrl)) {
-    throw new Error(`Runtime config extends cycle: ${[...stack, resolvedUrl].join(' -> ')}`);
-  }
-  const config = await fetchRuntimeConfig(resolvedUrl, options);
-  return resolveRuntimeConfigExtends(config, {
-    ...options,
-    sourceUrl: resolvedUrl,
-    presetBaseUrl,
-    stack: [...stack, resolvedUrl],
-  });
-}
-
-async function loadRuntimeConfigFromRef(ref, context) {
-  const candidates = resolveExtendCandidates(ref, context);
-  if (!candidates.length) {
-    throw new Error(`Runtime config extends is invalid: ${ref}`);
-  }
-  let lastError = null;
-  for (const candidate of candidates) {
-    try {
-      return await loadRuntimeConfigChain(candidate, context, context.stack ?? []);
-    } catch (error) {
-      if (error?.code === 'runtime_config_not_found') {
-        lastError = error;
-        continue;
-      }
-      throw error;
-    }
-  }
-  if (lastError) {
-    throw lastError;
-  }
-  throw new Error(`Runtime config extends not found: ${ref}`);
-}
-
-export async function loadRuntimeConfigFromUrl(url, options = {}) {
-  if (!url) {
-    throw new Error('runtime config url is required');
-  }
-  return loadRuntimeConfigChain(url, options);
-}
-
-export async function applyRuntimeConfigFromUrl(url, options = {}) {
-  const { runtime } = await loadRuntimeConfigFromUrl(url, options);
-  setRuntimeConfig(runtime);
-  return runtime;
-}
-
-export async function loadRuntimePreset(presetId, options = {}) {
-  const baseUrl = options.baseUrl || resolvePresetBaseUrl();
-  const normalized = normalizePresetPath(presetId);
-  if (!normalized) {
-    throw new Error('runtime preset id is required');
-  }
-  const url = `${baseUrl.replace(/\/$/, '')}/${normalized}`;
-  return loadRuntimeConfigFromUrl(url, { ...options, presetBaseUrl: baseUrl });
-}
-
-export async function applyRuntimePreset(presetId, options = {}) {
-  const { runtime } = await loadRuntimePreset(presetId, options);
-  setRuntimeConfig(runtime);
-  return runtime;
-}
-
 export async function initializeBrowserHarness(options = {}) {
   const { modelUrl, onProgress, log } = options;
   if (!modelUrl) {
@@ -426,1309 +130,102 @@ export async function runBrowserHarness(options = {}) {
 
 const BROWSER_SUITE_SET = Object.freeze([
   'kernels',
-  'inference',
-  'training',
-  'bench',
-  'debug',
-  'diffusion',
-  'energy',
-]);
-
-const BROWSER_SUITE_DISPATCH_MAP = Object.freeze({
-  kernels: 'runKernelSuite',
-  inference: 'runInferenceSuite',
-  training: 'runTrainingSuite',
-  bench: 'runBenchSuite',
-  debug: 'runInferenceSuite(debug)',
-  diffusion: 'runDiffusionSuite',
-  energy: 'runEnergySuite',
-});
-
-export function getBrowserSupportedSuites() {
-  return [...BROWSER_SUITE_SET];
-}
-
-export function getBrowserSuiteDispatchMap() {
-  return { ...BROWSER_SUITE_DISPATCH_MAP };
-}
-
-function createUnsupportedSuiteError(requestedSuite, context = {}) {
-  const command = typeof context.command === 'string' && context.command.trim()
-    ? context.command.trim()
-    : 'run-browser-suite';
-  const surface = typeof context.surface === 'string' && context.surface.trim()
-    ? context.surface.trim()
-    : 'browser';
-  const allowedSuites = [...BROWSER_SUITE_SET];
-  const error = new Error(
-    `Unsupported suite "${requestedSuite}". Allowed suites: ${allowedSuites.join(', ')}. ` +
-    `command="${command}" surface="${surface}".`
-  );
-  error.code = 'unsupported_suite';
-  error.requestedSuite = requestedSuite;
-  error.allowedSuites = allowedSuites;
-  error.command = command;
-  error.surface = surface;
-  error.details = {
-    requestedSuite,
-    allowedSuites,
-    command,
-    surface,
-  };
-  return error;
-}
-
-function resolveSuiteContext(options = {}) {
-  const command = typeof options.command === 'string' ? options.command : null;
-  const surface = typeof options.surface === 'string' ? options.surface : null;
-  return {
-    command: command ?? 'run-browser-suite',
-    surface: surface ?? 'browser',
-  };
-}
-
-function normalizeSuite(value, context = {}) {
-  const suite = String(value || '').trim().toLowerCase();
-  if (!suite) {
-    throw createUnsupportedSuiteError(suite, context);
-  }
-  const normalized = suite === 'benchmark' ? 'bench' : suite;
-  if (!BROWSER_SUITE_SET.includes(normalized)) {
-    throw createUnsupportedSuiteError(normalized, context);
-  }
-  return normalized;
-}
-
-export function buildSuiteSummary(suiteName, results, startTimeMs) {
-  let passed = 0;
-  let failed = 0;
-  let skipped = 0;
-  const safeResults = Array.isArray(results) ? results : [];
-  for (const result of safeResults) {
-    if (result.skipped) {
-      skipped++;
-    } else if (result.passed) {
-      passed++;
-    } else {
-      failed++;
-    }
-  }
-  const duration = Math.max(0, performance.now() - (Number.isFinite(startTimeMs) ? startTimeMs : performance.now()));
-  return { suite: suiteName, passed, failed, skipped, duration, results: safeResults };
-}
-
-function normalizeCacheMode(value) {
-  return value === 'cold' || value === 'warm' ? value : 'warm';
-}
-
-function normalizeLoadMode(value, hasModelUrl) {
-  if (value === 'opfs' || value === 'http' || value === 'memory') {
-    return value;
-  }
-  return hasModelUrl ? 'http' : 'opfs';
-}
-
-function isNodeRuntime() {
-  return typeof process !== 'undefined' && !!process.versions?.node;
-}
-
-function normalizeWorkloadType(value) {
-  const normalized = String(value || '').trim().toLowerCase();
-  return normalized || null;
-}
-
-function safeStatsValue(value) {
-  return Number.isFinite(value) ? Number(value) : 0;
-}
-
-function calculateRatePerSecond(count, durationMs) {
-  const safeCount = safeStatsValue(count);
-  const safeDurationMs = safeStatsValue(durationMs);
-  if (safeCount <= 0 || safeDurationMs <= 0) return 0;
-  return Number(((safeCount * 1000) / safeDurationMs).toFixed(2));
-}
-
-function buildDiffusionPerformanceArtifact({
-  warmupRuns,
-  timedRuns,
-  width,
-  height,
-  steps,
-  guidanceScale,
-  avgPrefillTokens,
-  avgDecodeTokens,
-  cpuStats,
-  gpuStats,
-}) {
-  const cpuPrefillMs = safeStatsValue(cpuStats?.prefillMs?.median);
-  const cpuDenoiseMs = safeStatsValue(cpuStats?.denoiseMs?.median);
-  const cpuVaeMs = safeStatsValue(cpuStats?.vaeMs?.median);
-  const cpuTotalMs = safeStatsValue(cpuStats?.totalMs?.median);
-  const gpuPrefillMs = safeStatsValue(gpuStats?.prefillMs?.median);
-  const gpuDenoiseMs = safeStatsValue(gpuStats?.denoiseMs?.median);
-  const gpuVaeMs = safeStatsValue(gpuStats?.vaeMs?.median);
-  const gpuTotalMs = safeStatsValue(gpuStats?.totalMs?.median);
-  const decodeStepsPerSec = calculateRatePerSecond(steps, cpuDenoiseMs);
-  const decodeTokensPerSec = calculateRatePerSecond(avgDecodeTokens, cpuDenoiseMs);
-  const prefillTokensPerSec = calculateRatePerSecond(avgPrefillTokens, cpuPrefillMs);
-
-  return {
-    schemaVersion: 1,
-    warmupRuns,
-    timedRuns,
-    shape: {
-      width,
-      height,
-    },
-    scheduler: {
-      steps,
-      guidanceScale,
-    },
-    cpu: {
-      totalMs: cpuTotalMs,
-      prefillMs: cpuPrefillMs,
-      denoiseMs: cpuDenoiseMs,
-      vaeMs: cpuVaeMs,
-    },
-    gpu: {
-      available: gpuStats?.available === true,
-      totalMs: gpuStats?.available === true ? gpuTotalMs : null,
-      prefillMs: gpuStats?.available === true ? gpuPrefillMs : null,
-      denoiseMs: gpuStats?.available === true ? gpuDenoiseMs : null,
-      vaeMs: gpuStats?.available === true ? gpuVaeMs : null,
-    },
-    throughput: {
-      prefillTokensPerSec,
-      decodeTokensPerSec,
-      decodeStepsPerSec,
-    },
-    tokens: {
-      avgPrefillTokens: safeStatsValue(avgPrefillTokens),
-      avgDecodeTokens: safeStatsValue(avgDecodeTokens),
-    },
-  };
-}
-
-function assertDiffusionPerformanceArtifact(metrics, contextLabel = 'diffusion') {
-  const artifact = metrics?.performanceArtifact;
-  if (!artifact || typeof artifact !== 'object') {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact is required.`);
-  }
-  if (artifact.schemaVersion !== 1) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.schemaVersion must be 1.`);
-  }
-  if (!Number.isInteger(artifact.warmupRuns) || artifact.warmupRuns < 0) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.warmupRuns must be a non-negative integer.`);
-  }
-  if (!Number.isInteger(artifact.timedRuns) || artifact.timedRuns < 1) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.timedRuns must be a positive integer.`);
-  }
-  if (!Number.isFinite(artifact?.cpu?.prefillMs)) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.cpu.prefillMs must be finite.`);
-  }
-  if (!Number.isFinite(artifact?.cpu?.denoiseMs)) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.cpu.denoiseMs must be finite.`);
-  }
-  if (!Number.isFinite(artifact?.cpu?.vaeMs)) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.cpu.vaeMs must be finite.`);
-  }
-  if (!Number.isFinite(artifact?.cpu?.totalMs)) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.cpu.totalMs must be finite.`);
-  }
-  if (!Number.isFinite(artifact?.throughput?.decodeStepsPerSec)) {
-    throw new Error(`${contextLabel}: metrics.performanceArtifact.throughput.decodeStepsPerSec must be finite.`);
-  }
-}
-
-function toTimingNumber(value, fallback = 0) {
-  return formatMetricNumber(value, fallback, 2);
-}
-
-function safeToFixed(value, fallback = 0, digits = 2) {
-  return formatMetricNumber(value, fallback, digits);
-}
-
-function sampleTimingNumber(stats, key, fallback = 0) {
-  return formatMetricNumber(stats?.[key], fallback, 2);
-}
-
-function formatMetricNumber(value, fallback = 0, digits = 2) {
-  const numericValue = Number(value);
-  if (!Number.isFinite(numericValue)) return fallback;
-  return Number(numericValue.toFixed(digits));
-}
-
-function buildCanonicalTiming(overrides = {}) {
-  const cacheMode = normalizeCacheMode(overrides.cacheMode);
-  const modelLoadMs = toTimingNumber(overrides.modelLoadMs, 0);
-  const prefillMs = toTimingNumber(overrides.prefillMs, 0);
-  const decodeMs = toTimingNumber(overrides.decodeMs, 0);
-  const decodeMsPerTokenP50 = Number.isFinite(overrides.decodeMsPerTokenP50)
-    ? toTimingNumber(overrides.decodeMsPerTokenP50)
-    : null;
-  const decodeMsPerTokenP95 = Number.isFinite(overrides.decodeMsPerTokenP95)
-    ? toTimingNumber(overrides.decodeMsPerTokenP95)
-    : null;
-  const decodeMsPerTokenP99 = Number.isFinite(overrides.decodeMsPerTokenP99)
-    ? toTimingNumber(overrides.decodeMsPerTokenP99)
-    : null;
-  const decodeTokensPerSec = Number.isFinite(overrides.decodeTokensPerSec)
-    ? toTimingNumber(overrides.decodeTokensPerSec)
-    : null;
-  const prefillTokensPerSec = Number.isFinite(overrides.prefillTokensPerSec)
-    ? toTimingNumber(overrides.prefillTokensPerSec)
-    : null;
-  const totalRunMs = toTimingNumber(
-    overrides.totalRunMs,
-    toTimingNumber(prefillMs + decodeMs)
-  );
-  const firstTokenMs = Number.isFinite(overrides.firstTokenMs)
-    ? toTimingNumber(overrides.firstTokenMs)
-    : null;
-  const firstResponseMs = Number.isFinite(overrides.firstResponseMs)
-    ? toTimingNumber(overrides.firstResponseMs)
-    : toTimingNumber(modelLoadMs + totalRunMs);
-
-  return {
-    modelLoadMs,
-    firstTokenMs,
-    firstResponseMs,
-    prefillMs,
-    decodeMs,
-    decodeMsPerTokenP50,
-    decodeMsPerTokenP95,
-    decodeMsPerTokenP99,
-    decodeTokensPerSec,
-    prefillTokensPerSec,
-    totalRunMs,
-    cacheMode,
-    loadMode: overrides.loadMode,
-  };
-}
-
-function buildTimingDiagnostics(timing = {}, options = {}) {
-  const prefillSemantics = String(options.prefillSemantics || 'internal_prefill_phase');
-  const source = String(options.source || 'doppler');
-  const modelLoadMs = Number.isFinite(timing.modelLoadMs) ? toTimingNumber(timing.modelLoadMs) : null;
-  const firstTokenMs = Number.isFinite(timing.firstTokenMs) ? toTimingNumber(timing.firstTokenMs) : null;
-  const firstResponseMs = Number.isFinite(timing.firstResponseMs) ? toTimingNumber(timing.firstResponseMs) : null;
-  const prefillMs = Number.isFinite(timing.prefillMs) ? toTimingNumber(timing.prefillMs) : null;
-  const decodeMs = Number.isFinite(timing.decodeMs) ? toTimingNumber(timing.decodeMs) : null;
-  const totalRunMs = Number.isFinite(timing.totalRunMs) ? toTimingNumber(timing.totalRunMs) : null;
-
-  const firstResponseFromLoadAndFirstTokenMs = (
-    Number.isFinite(modelLoadMs) && Number.isFinite(firstTokenMs)
-  )
-    ? toTimingNumber(modelLoadMs + firstTokenMs)
-    : null;
-  const runFromPrefillAndDecodeMs = (
-    Number.isFinite(prefillMs) && Number.isFinite(decodeMs)
-  )
-    ? toTimingNumber(prefillMs + decodeMs)
-    : null;
-
-  const firstResponseResidualMs = (
-    Number.isFinite(firstResponseMs) && Number.isFinite(firstResponseFromLoadAndFirstTokenMs)
-  )
-    ? toTimingNumber(firstResponseMs - firstResponseFromLoadAndFirstTokenMs)
-    : null;
-  const runResidualMs = (
-    Number.isFinite(totalRunMs) && Number.isFinite(runFromPrefillAndDecodeMs)
-  )
-    ? toTimingNumber(totalRunMs - runFromPrefillAndDecodeMs)
-    : null;
-
-  return {
-    schemaVersion: 1,
-    source,
-    semantics: {
-      modelLoadMs: 'model initialization/load before generation',
-      firstTokenMs: 'ttft from generation start',
-      firstResponseMs: 'modelLoadMs + firstTokenMs',
-      prefillMs: prefillSemantics,
-      decodeMs: 'time after first token',
-      totalRunMs: 'prefillMs + decodeMs',
-    },
-    componentsMs: {
-      modelLoadMs,
-      firstTokenMs,
-      firstResponseMs,
-      prefillMs,
-      decodeMs,
-      totalRunMs,
-    },
-    sumsMs: {
-      firstResponseFromLoadAndFirstTokenMs,
-      runFromPrefillAndDecodeMs,
-    },
-    residualsMs: {
-      firstResponseResidualMs,
-      runResidualMs,
-    },
-    consistent: {
-      firstResponse: Number.isFinite(firstResponseResidualMs) ? Math.abs(firstResponseResidualMs) <= 2 : null,
-      totalRun: Number.isFinite(runResidualMs) ? Math.abs(runResidualMs) <= 2 : null,
-    },
-  };
-}
-
-function resolveDeviceInfo() {
-  try {
-    return getKernelCapabilities();
-  } catch {
-    return null;
-  }
-}
-
-async function resolveKernelPathForModel(options = {}) {
-  const runtimeConfig = options.runtime?.runtimeConfig ?? getRuntimeConfig();
-  let manifest = null;
-  let manifestModelId = options.modelId || null;
-
-  if (options.modelId) {
-    await openModelStore(options.modelId);
-    const manifestText = await loadManifestFromStore();
-    if (manifestText) {
-      manifest = parseManifest(manifestText);
-      manifestModelId = manifest.modelId ?? options.modelId;
-    }
-  }
-
-  if (!manifest) return null;
-
-  const modelConfig = parseModelConfigFromManifest(manifest, runtimeConfig);
-  const kernelPathState = resolveKernelPathState({
-    manifest,
-    runtimeConfig,
-    modelConfig,
-  });
-  activateKernelPathState(kernelPathState);
-  return {
-    modelId: manifestModelId,
-    kernelPath: kernelPathState.resolvedKernelPath,
-    source: kernelPathState.kernelPathSource,
-  };
-}
-
-async function initializeInferenceFromStorage(modelId, options = {}) {
-  const { onProgress } = options;
-  if (!modelId) {
-    throw new Error('modelId is required');
-  }
-
-  if (options.runtime?.runtimeConfig) {
-    setRuntimeConfig(options.runtime.runtimeConfig);
-  }
-
-  onProgress?.('storage', 0.05, 'Opening model store...');
-  await openModelStore(modelId);
-
-  onProgress?.('manifest', 0.1, 'Loading manifest...');
-  const manifestText = await loadManifestFromStore();
-  if (!manifestText) {
-    throw new Error('Manifest not found in storage');
-  }
-  const manifest = parseManifest(manifestText);
-
-  onProgress?.('gpu', 0.2, 'Initializing WebGPU...');
-  await initDevice();
-  const device = getDevice();
-  const capabilities = getKernelCapabilities();
-
-  onProgress?.('pipeline', 0.3, 'Creating pipeline...');
-  const pipeline = await createPipeline(manifest, {
-    gpu: { device },
-    runtime: options.runtime,
-    onProgress,
-  });
-
-  return { pipeline, manifest, capabilities };
-}
-
-async function initializeInferenceFromSourcePath(sourcePath, options = {}) {
-  const { onProgress } = options;
-  if (!sourcePath || typeof sourcePath !== 'string') {
-    throw new Error('modelUrl is required for loadMode=memory.');
-  }
-  if (!isNodeRuntime()) {
-    throw new Error('loadMode=memory source runtime is currently supported on Node only.');
-  }
-  if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(sourcePath)) {
-    throw new Error(
-      'loadMode=memory expects a local filesystem path (Safetensors directory or .gguf file), not an URL.'
-    );
-  }
-
-  if (options.runtime?.runtimeConfig) {
-    setRuntimeConfig(options.runtime.runtimeConfig);
-  }
-
-  onProgress?.('source', 0.05, 'Preparing source runtime bundle...');
-  const { resolveNodeSourceRuntimeBundle } = await import(NODE_SOURCE_RUNTIME_MODULE_PATH);
-  const sourceBundle = await resolveNodeSourceRuntimeBundle({
-    inputPath: sourcePath,
-    modelId: options.modelId || null,
-  });
-  if (!sourceBundle) {
-    throw new Error(
-      `No source-runtime model detected at "${sourcePath}". ` +
-      'Expected a Safetensors directory or a .gguf file path.'
-    );
-  }
-
-  onProgress?.('gpu', 0.2, 'Initializing WebGPU...');
-  await initDevice();
-  const device = getDevice();
-  const capabilities = getKernelCapabilities();
-
-  onProgress?.('pipeline', 0.3, 'Creating pipeline...');
-  const pipeline = await createPipeline(sourceBundle.manifest, {
-    gpu: { device },
-    runtime: options.runtime,
-    storage: sourceBundle.storageContext,
-    onProgress,
-  });
-
-  return {
-    pipeline,
-    manifest: sourceBundle.manifest,
-    capabilities,
-  };
-}
-
-async function resolveHarnessOverride(options = {}) {
-  const input = typeof options.harnessOverride === 'function'
-    ? await options.harnessOverride(options)
-    : options.harnessOverride;
-
-  if (!input || typeof input !== 'object') {
-    throw new Error('harnessOverride must resolve to an object.');
-  }
-
-  if (!input.pipeline || typeof input.pipeline.generate !== 'function') {
-    throw new Error('harnessOverride.pipeline.generate(request) is required.');
-  }
-
-  const manifest = input.manifest && typeof input.manifest === 'object'
-    ? input.manifest
-    : {
-      modelId: options.modelId || 'diffusion-harness-override',
-      modelType: 'diffusion',
-    };
-
-  const modelLoadMs = Number.isFinite(input.modelLoadMs)
-    ? Math.max(0, input.modelLoadMs)
-    : 0;
-
-  return {
-    ...input,
-    manifest,
-    modelLoadMs,
-  };
-}
-
-async function initializeSuiteModel(options = {}) {
-  if (options.harnessOverride) {
-    if (options.runtime?.runtimeConfig) {
-      setRuntimeConfig(options.runtime.runtimeConfig);
-    }
-    return resolveHarnessOverride(options);
-  }
-  const loadStart = performance.now();
-  const runtime = resolveRuntime(options);
-  const loadMode = normalizeLoadMode(options.loadMode, !options.modelUrl);
-  let harness;
-  if (loadMode === 'memory') {
-    if (!options.modelUrl) {
-      throw new Error('loadMode=memory requires modelUrl to be a local model path.');
-    }
-    harness = await initializeInferenceFromSourcePath(options.modelUrl, { ...options, runtime });
-  } else if (options.modelId && !options.modelUrl) {
-    harness = await initializeInferenceFromStorage(options.modelId, { ...options, runtime });
-  } else {
-    if (!options.modelUrl) {
-      throw new Error('modelUrl is required for this suite');
-    }
-    harness = await initializeInference(options.modelUrl, {
-      runtime,
-      onProgress: options.onProgress,
-      log: options.log,
-    });
-  }
-  const modelLoadMs = Math.max(0, performance.now() - loadStart);
-  return { ...harness, modelLoadMs };
-}
-
-async function runKernelSuite(options = {}) {
-  const startTime = performance.now();
-  const { testHarness, initGPU } = await import('../../tests/kernels/browser/test-page.js');
-  const { runKernelSuite: runAllKernelTests } = await import('../../tests/kernels/browser/kernel-suite.js');
-  await initGPU();
-
-  const previousKernelPath = getActiveKernelPath();
-  const previousKernelSource = getActiveKernelPathSource();
-  const previousKernelPathPolicy = getActiveKernelPathPolicy();
-  if (options.modelId) {
-    await resolveKernelPathForModel(options);
-  }
-  let results = [];
-  try {
-    results = await runAllKernelTests(testHarness);
-  } finally {
-    setActiveKernelPath(previousKernelPath, previousKernelSource, previousKernelPathPolicy);
-  }
-
-  const summary = buildSuiteSummary('kernels', results, startTime);
-  return {
-    ...summary,
-    deviceInfo: resolveDeviceInfo(),
-  };
-}
-
-
-
-
-
-const DEFAULT_HARNESS_PROMPT = 'Summarize this input in one sentence.';
-const DEFAULT_RUNTIME_PLACEHOLDER_PROMPT = 'Hello from Doppler.';
-const DEFAULT_QWEN_PROMPT = Object.freeze({
-  messages: Object.freeze([
-    Object.freeze({
-      role: 'user',
-      content: 'Answer in one short sentence: What color is the sky on a clear day?',
-    }),
-  ]),
-});
-const DEFAULT_TRANSLATEGEMMA_PROMPT = Object.freeze({
-  messages: Object.freeze([
-    Object.freeze({
-      role: 'user',
-      content: Object.freeze([
-        Object.freeze({
-          type: 'text',
-          source_lang_code: 'en',
-          target_lang_code: 'fr',
-          text: 'Hello world.',
-        }),
-      ]),
-    }),
-  ]),
-});
-const DEFAULT_HARNESS_MAX_TOKENS = 32;
-const EMBEDDING_PREVIEW_LENGTH = 16;
-const EMBEDDING_SEMANTIC_MIN_RETRIEVAL_TOP1 = 0.67;
-const EMBEDDING_SEMANTIC_MIN_PAIR_ACC = 0.67;
-const EMBEDDING_SEMANTIC_PAIR_MARGIN = 0.01;
-
-const EMBEDDING_SEMANTIC_RETRIEVAL_CASES = Object.freeze([
-  Object.freeze({
-    id: 'library_search',
-    query: 'Where can I borrow books and study quietly?',
-    docs: Object.freeze([
-      'The city library lends books, provides study rooms, and offers free Wi-Fi.',
-      'The cafe serves coffee, pastries, and sandwiches all day.',
-      'The bike repair shop fixes flat tires and broken chains.',
-    ]),
-    expectedDoc: 0,
-  }),
-  Object.freeze({
-    id: 'password_reset',
-    query: 'How do I reset my account password?',
-    docs: Object.freeze([
-      'To reset your password, open account settings and choose the forgot-password flow.',
-      'Our shipping policy explains delivery timelines and tracking updates.',
-      'The recipe combines tomatoes, basil, and olive oil.',
-    ]),
-    expectedDoc: 0,
-  }),
-  Object.freeze({
-    id: 'damaged_package',
-    query: 'What should I do if my package arrives damaged?',
-    docs: Object.freeze([
-      'Contact support within seven days with photos to request a replacement for damaged items.',
-      'The concert starts at 8 PM at the downtown arena.',
-      'Plant roses in spring and water them twice a week.',
-    ]),
-    expectedDoc: 0,
-  }),
-  Object.freeze({
-    id: 'flight_change_policy',
-    query: 'Can I change my flight after booking?',
-    docs: Object.freeze([
-      'The museum opens daily at 10 AM and offers guided tours on weekends.',
-      'You can change your flight in Manage Booking up to 24 hours before departure, with any fare difference applied.',
-      'Our gym membership includes group classes and access to the pool.',
-    ]),
-    expectedDoc: 1,
-  }),
-  Object.freeze({
-    id: 'wifi_troubleshoot',
-    query: 'Why does my home Wi-Fi keep disconnecting?',
-    docs: Object.freeze([
-      'The dessert menu includes cheesecake, brownies, and fruit tart.',
-      'You can review your recent orders in your account purchase history.',
-      'Frequent Wi-Fi drops can be fixed by restarting the router, updating firmware, and changing the wireless channel.',
-    ]),
-    expectedDoc: 2,
-  }),
-  Object.freeze({
-    id: 'refund_deadline',
-    query: 'How long do I have to request a refund?',
-    docs: Object.freeze([
-      'Refund requests are accepted within 30 days of purchase when the item is in original condition.',
-      'The conference keynote starts at 9 AM in the main hall.',
-      'Use a medium grind when brewing coffee with a drip machine.',
-    ]),
-    expectedDoc: 0,
-  }),
-  Object.freeze({
-    id: 'passport_renewal_docs',
-    query: 'What documents do I need to renew a passport?',
-    docs: Object.freeze([
-      'To care for houseplants, water only when the top soil is dry.',
-      'Passport renewal usually requires the application form, current passport, compliant photo, and payment.',
-      'The train to downtown runs every 20 minutes during peak hours.',
-    ]),
-    expectedDoc: 1,
-  }),
-]);
-
-const EMBEDDING_SEMANTIC_PAIR_CASES = Object.freeze([
-  Object.freeze({
-    id: 'bike_paraphrase',
-    anchor: 'The child is riding a bicycle through the park.',
-    positive: 'A kid bikes along a path in the park.',
-    negative: 'The stock market closed lower after interest-rate news.',
-  }),
-  Object.freeze({
-    id: 'cancel_subscription',
-    anchor: 'Please cancel my subscription before renewal.',
-    positive: 'I want to stop the plan so it does not renew.',
-    negative: 'The mountain trail is closed after heavy snow.',
-  }),
-  Object.freeze({
-    id: 'battery_drain',
-    anchor: 'The laptop battery drains very quickly.',
-    positive: 'My notebook loses charge fast.',
-    negative: 'This pasta sauce tastes sweet and spicy.',
-  }),
-  Object.freeze({
-    id: 'order_tracking',
-    anchor: 'I need to track where my order is.',
-    positive: 'How can I check my package delivery status?',
-    negative: 'The violin concerto was composed in the 1800s.',
-  }),
-  Object.freeze({
-    id: 'account_lockout',
-    anchor: 'My account is locked after too many login attempts.',
-    positive: 'I cannot sign in because the system temporarily blocked my account.',
-    negative: 'Bake the cake at 350 degrees for thirty minutes.',
-  }),
-  Object.freeze({
-    id: 'invoice_request',
-    anchor: 'Please send me the invoice for last month.',
-    positive: 'Can you provide the billing statement for the previous month?',
-    negative: 'The hiking trail follows the river for five miles.',
-  }),
-  Object.freeze({
-    id: 'slow_internet',
-    anchor: 'The internet speed is much slower tonight.',
-    positive: 'My connection is unusually slow this evening.',
-    negative: 'The novel explores themes of memory and loss.',
-  }),
-]);
-
-function asText(value) {
-  if (typeof value !== 'string') return null;
-  const trimmed = value.trim();
-  return trimmed || null;
-}
-
-function normalizeRetrievalFixtures(cases) {
-  if (!Array.isArray(cases)) return null;
-  const normalized = [];
-  for (let i = 0; i < cases.length; i++) {
-    const entry = cases[i];
-    if (!entry || typeof entry !== 'object') continue;
-
-    const query = asText(entry.query);
-    const docs = Array.isArray(entry.docs) ? entry.docs.map(asText).filter(Boolean) : [];
-    if (!query || docs.length === 0 || !Number.isFinite(entry.expectedDoc)) {
-      continue;
-    }
-    const expectedDoc = Math.floor(entry.expectedDoc);
-    normalized.push({
-      id: asText(entry.id) ?? `case-${i + 1}`,
-      query,
-      docs,
-      expectedDoc: Math.max(0, Math.min(expectedDoc, docs.length - 1)),
-    });
-  }
-  return normalized.length > 0 ? normalized : null;
-}
-
-function normalizePairFixtures(cases) {
-  if (!Array.isArray(cases)) return null;
-  const normalized = [];
-  for (let i = 0; i < cases.length; i++) {
-    const entry = cases[i];
-    if (!entry || typeof entry !== 'object') continue;
-
-    const anchor = asText(entry.anchor);
-    const positive = asText(entry.positive);
-    const negative = asText(entry.negative);
-    if (!anchor || !positive || !negative) {
-      continue;
-    }
-    normalized.push({
-      id: asText(entry.id) ?? `pair-${i + 1}`,
-      anchor,
-      positive,
-      negative,
-    });
-  }
-  return normalized.length > 0 ? normalized : null;
-}
-
-function resolveEmbeddingSemanticFixtures(runtimeConfig, options = null) {
-  const overrides = isPlainObject(options?.embeddingSemantic)
-    ? options.embeddingSemantic
-    : null;
-  const runtimeOverrides = runtimeConfig?.shared?.benchmark?.run?.embeddingSemantic;
-  const source = overrides ?? (isPlainObject(runtimeOverrides) ? runtimeOverrides : null);
-
-  const retrievalCases = normalizeRetrievalFixtures(source?.retrievalCases)
-    ?? EMBEDDING_SEMANTIC_RETRIEVAL_CASES;
-  const pairCases = normalizePairFixtures(source?.pairCases)
-    ?? EMBEDDING_SEMANTIC_PAIR_CASES;
-  const minRetrievalTop1Acc = Number.isFinite(source?.minRetrievalTop1Acc)
-    ? Math.max(0, Math.min(1, Number(source.minRetrievalTop1Acc)))
-    : EMBEDDING_SEMANTIC_MIN_RETRIEVAL_TOP1;
-  const minPairAcc = Number.isFinite(source?.minPairAcc)
-    ? Math.max(0, Math.min(1, Number(source.minPairAcc)))
-    : EMBEDDING_SEMANTIC_MIN_PAIR_ACC;
-  const pairMargin = Number.isFinite(source?.pairMargin)
-    ? Number(source.pairMargin)
-    : EMBEDDING_SEMANTIC_PAIR_MARGIN;
-
-  return {
-    retrievalCases,
-    pairCases,
-    minRetrievalTop1Acc,
-    minPairAcc,
-    pairMargin,
-  };
-}
-
-function resolveEmbeddingSemanticStyle(pipeline) {
-  const manifest = pipeline?.manifest ?? null;
-  const style = selectRuleValue('inference', 'config', 'embeddingSemanticStyle', {
-    modelId: String(manifest?.modelId ?? '').toLowerCase(),
-    presetId: String(manifest?.inference?.presetId ?? '').toLowerCase(),
-    manifestModelType: String(
-      manifest?.config?.model_type
-      ?? manifest?.config?.text_config?.model_type
-      ?? ''
-    ).toLowerCase(),
-  });
-  if (typeof style === 'string' && style.length > 0) {
-    return style;
-  }
-  return 'default';
-}
-
-function formatEmbeddingSemanticText(text, kind, style) {
-  if (style === 'embeddinggemma') {
-    if (kind === 'query') {
-      return `task: search result | query: ${text}`;
-    }
-    if (kind === 'document') {
-      return `title: None | text: ${text}`;
-    }
-  }
-  return text;
-}
-
-function resolvePrompt(runtimeConfig) {
-  const runtimePrompt = runtimeConfig?.inference?.prompt;
-  if (typeof runtimePrompt === 'string' && runtimePrompt.trim()) {
-    return runtimePrompt.trim();
-  }
-  return DEFAULT_HARNESS_PROMPT;
-}
-
-function isStructuredPromptInput(value) {
-  return Array.isArray(value) || (value != null && typeof value === 'object');
-}
-
-function clonePromptInput(promptInput) {
-  if (!isStructuredPromptInput(promptInput)) {
-    return promptInput;
-  }
-  if (typeof structuredClone === 'function') {
-    return structuredClone(promptInput);
-  }
-  return JSON.parse(JSON.stringify(promptInput));
-}
-
-function resolvePromptTemplateType(source) {
-  const sourceTemplateType = asText(source?.chatTemplateType);
-  if (sourceTemplateType) {
-    return sourceTemplateType;
-  }
-  const modelConfigTemplateType = asText(source?.modelConfig?.chatTemplateType);
-  if (modelConfigTemplateType) {
-    return modelConfigTemplateType;
-  }
-  return asText(source?.manifest?.inference?.chatTemplate?.type);
-}
-
-function buildDefaultGenerationPrompt(templateType) {
-  if (templateType === 'qwen') {
-    return clonePromptInput(DEFAULT_QWEN_PROMPT);
-  }
-  if (templateType === 'translategemma') {
-    return clonePromptInput(DEFAULT_TRANSLATEGEMMA_PROMPT);
-  }
-  return DEFAULT_HARNESS_PROMPT;
-}
-
-function shouldPreferModelDefaultPrompt(runtimePrompt, templateType) {
-  if (templateType !== 'translategemma' && templateType !== 'qwen') {
-    return false;
-  }
-  if (typeof runtimePrompt !== 'string') {
-    return false;
-  }
-  return runtimePrompt.trim() === DEFAULT_RUNTIME_PLACEHOLDER_PROMPT;
-}
-
-function assertPromptContract(runtimePrompt, templateType, source = 'runtime.inference.prompt') {
-  if (templateType !== 'translategemma') {
-    return;
-  }
-  if (runtimePrompt === undefined || runtimePrompt === null) {
-    return;
-  }
-  if (typeof runtimePrompt === 'string') {
-    const trimmed = runtimePrompt.trim();
-    if (!trimmed || trimmed === DEFAULT_RUNTIME_PLACEHOLDER_PROMPT) {
-      return;
-    }
-    throw new Error(
-      `TranslateGemma harness prompt contract violation: ${source} must be ` +
-      '{ messages: [...] } with source_lang_code/target_lang_code blocks, not a plain string.'
-    );
-  }
-  if (!isStructuredPromptInput(runtimePrompt)) {
-    throw new Error(
-      `TranslateGemma harness prompt contract violation: ${source} must be ` +
-      '{ messages: [...] } with source_lang_code/target_lang_code blocks.'
-    );
-  }
-}
-
-function describePromptInput(promptInput) {
-  if (typeof promptInput === 'string') {
-    return promptInput.trim() || DEFAULT_HARNESS_PROMPT;
-  }
-  const firstMessage = Array.isArray(promptInput?.messages)
-    ? promptInput.messages[0]
-    : null;
-  const firstContent = Array.isArray(firstMessage?.content)
-    ? firstMessage.content[0]
-    : null;
-  const sourceLang = asText(firstContent?.source_lang_code);
-  const targetLang = asText(firstContent?.target_lang_code);
-  const text = asText(firstContent?.text);
-  if (sourceLang && targetLang) {
-    return `${sourceLang} -> ${targetLang}: ${text || '[non-text request]'}`;
-  }
-  const stringContent = asText(firstMessage?.content);
-  if (stringContent) {
-    const role = asText(firstMessage?.role) || 'user';
-    return `${role}: ${stringContent}`;
-  }
-  try {
-    return JSON.stringify(promptInput);
-  } catch {
-    return '[structured prompt]';
-  }
-}
-
-function resolveGenerationPromptInput(runtimeConfig, runOverrides = null, source = null) {
-  const templateType = resolvePromptTemplateType(source);
-  const overridePrompt = runOverrides?.prompt;
-  assertPromptContract(overridePrompt, templateType, 'runOverrides.prompt');
-  if (typeof overridePrompt === 'string' && overridePrompt.trim()) {
-    return overridePrompt.trim();
-  }
-  if (isStructuredPromptInput(overridePrompt)) {
-    return clonePromptInput(overridePrompt);
-  }
+  'inference',
+  'training',
+  'bench',
+  'debug',
+  'diffusion',
+  'energy',
+]);
 
-  const runtimePrompt = runtimeConfig?.inference?.prompt;
-  assertPromptContract(runtimePrompt, templateType, 'runtimeConfig.inference.prompt');
-  if (shouldPreferModelDefaultPrompt(runtimePrompt, templateType)) {
-    return buildDefaultGenerationPrompt(templateType);
-  }
-  if (typeof runtimePrompt === 'string' && runtimePrompt.trim()) {
-    return runtimePrompt.trim();
-  }
-  if (isStructuredPromptInput(runtimePrompt)) {
-    return clonePromptInput(runtimePrompt);
-  }
+const BROWSER_SUITE_DISPATCH_MAP = Object.freeze({
+  kernels: 'runKernelSuite',
+  inference: 'runInferenceSuite',
+  training: 'runTrainingSuite',
+  bench: 'runBenchSuite',
+  debug: 'runInferenceSuite(debug)',
+  diffusion: 'runDiffusionSuite',
+  energy: 'runEnergySuite',
+});
 
-  return buildDefaultGenerationPrompt(templateType);
+export function getBrowserSupportedSuites() {
+  return [...BROWSER_SUITE_SET];
 }
 
-function resolveMaxTokens(runtimeConfig) {
-  const runtimeMax = runtimeConfig?.inference?.batching?.maxTokens;
-  if (Number.isFinite(runtimeMax)) {
-    return Math.max(1, Math.floor(runtimeMax));
-  }
-  return DEFAULT_HARNESS_MAX_TOKENS;
+export function getBrowserSuiteDispatchMap() {
+  return { ...BROWSER_SUITE_DISPATCH_MAP };
 }
 
-function resolveBenchmarkRunSettings(runtimeConfig, source = null) {
-  const benchConfig = runtimeConfig?.shared?.benchmark?.run || {};
-  const runtimeSampling = isPlainObject(runtimeConfig?.inference?.sampling)
-    ? runtimeConfig.inference.sampling
-    : {};
-  const benchSampling = isPlainObject(benchConfig?.sampling)
-    ? benchConfig.sampling
-    : {};
-  const promptInput = typeof benchConfig.customPrompt === 'string' && benchConfig.customPrompt.trim()
-    ? benchConfig.customPrompt.trim()
-    : resolveGenerationPromptInput(runtimeConfig, null, source);
-  const maxTokens = Number.isFinite(benchConfig.maxNewTokens)
-    ? Math.max(1, Math.floor(benchConfig.maxNewTokens))
-    : resolveMaxTokens(runtimeConfig);
-
-  return {
-    warmupRuns: Math.max(0, Math.floor(benchConfig.warmupRuns ?? 0)),
-    timedRuns: Math.max(1, Math.floor(benchConfig.timedRuns ?? 1)),
-    prompt: promptInput,
-    promptLabel: describePromptInput(promptInput),
-    maxTokens,
-    sampling: {
-      ...runtimeSampling,
-      ...benchSampling,
-    },
+function createUnsupportedSuiteError(requestedSuite, context = {}) {
+  const command = typeof context.command === 'string' && context.command.trim()
+    ? context.command.trim()
+    : 'run-browser-suite';
+  const surface = typeof context.surface === 'string' && context.surface.trim()
+    ? context.surface.trim()
+    : 'browser';
+  const allowedSuites = [...BROWSER_SUITE_SET];
+  const error = new Error(
+    `Unsupported suite "${requestedSuite}". Allowed suites: ${allowedSuites.join(', ')}. ` +
+    `command="${command}" surface="${surface}".`
+  );
+  error.code = 'unsupported_suite';
+  error.requestedSuite = requestedSuite;
+  error.allowedSuites = allowedSuites;
+  error.command = command;
+  error.surface = surface;
+  error.details = {
+    requestedSuite,
+    allowedSuites,
+    command,
+    surface,
   };
+  return error;
 }
 
-function summarizeEmbeddingValues(embedding) {
-  const values = ArrayBuffer.isView(embedding) || Array.isArray(embedding) ? embedding : null;
-  const embeddingDim = Number.isFinite(values?.length) ? values.length : 0;
-  const preview = [];
-
-  let nonFiniteCount = 0;
-  let finiteCount = 0;
-  let min = Infinity;
-  let max = -Infinity;
-  let maxAbs = 0;
-  let sum = 0;
-  let sumSq = 0;
-
-  for (let i = 0; i < embeddingDim; i++) {
-    const value = Number(values[i]);
-    if (preview.length < EMBEDDING_PREVIEW_LENGTH) {
-      preview.push(Number.isFinite(value) ? Number(value.toFixed(6)) : null);
-    }
-    if (!Number.isFinite(value)) {
-      nonFiniteCount++;
-      continue;
-    }
-    finiteCount++;
-    if (value < min) min = value;
-    if (value > max) max = value;
-    const abs = Math.abs(value);
-    if (abs > maxAbs) maxAbs = abs;
-    sum += value;
-    sumSq += value * value;
-  }
-
-  const mean = finiteCount > 0 ? (sum / finiteCount) : null;
-  const variance = finiteCount > 0 ? Math.max(0, (sumSq / finiteCount) - ((mean || 0) * (mean || 0))) : null;
-  const stdDev = variance == null ? null : Math.sqrt(variance);
-  const l2Norm = finiteCount > 0 ? Math.sqrt(sumSq) : null;
-  const finiteRatio = embeddingDim > 0 ? finiteCount / embeddingDim : 0;
-
+function resolveSuiteContext(options = {}) {
+  const command = typeof options.command === 'string' ? options.command : null;
+  const surface = typeof options.surface === 'string' ? options.surface : null;
   return {
-    embeddingDim,
-    nonFiniteCount,
-    finiteCount,
-    finiteRatio,
-    min: finiteCount > 0 ? min : null,
-    max: finiteCount > 0 ? max : null,
-    maxAbs: finiteCount > 0 ? maxAbs : null,
-    mean,
-    stdDev,
-    l2Norm,
-    preview,
+    command: command ?? 'run-browser-suite',
+    surface: surface ?? 'browser',
   };
 }
 
-function cosineSimilarity(a, b) {
-  if (!a || !b || !Number.isFinite(a.length) || !Number.isFinite(b.length)) return NaN;
-  if (a.length !== b.length || a.length === 0) return NaN;
-  let dot = 0;
-  let normA = 0;
-  let normB = 0;
-  for (let i = 0; i < a.length; i++) {
-    const av = Number(a[i]);
-    const bv = Number(b[i]);
-    if (!Number.isFinite(av) || !Number.isFinite(bv)) return NaN;
-    dot += av * bv;
-    normA += av * av;
-    normB += bv * bv;
-  }
-  if (normA <= 0 || normB <= 0) return NaN;
-  return dot / Math.sqrt(normA * normB);
-}
-
-function top1Index(values) {
-  let best = -1;
-  let bestValue = -Infinity;
-  for (let i = 0; i < values.length; i++) {
-    const value = Number(values[i]);
-    if (!Number.isFinite(value)) continue;
-    if (value > bestValue) {
-      bestValue = value;
-      best = i;
-    }
+function normalizeSuite(value, context = {}) {
+  const suite = String(value || '').trim().toLowerCase();
+  if (!suite) {
+    throw createUnsupportedSuiteError(suite, context);
   }
-  return best;
-}
-
-async function embedStandaloneText(pipeline, text) {
-  pipeline.reset?.();
-  const result = await pipeline.embed(text);
-  const embedding = result?.embedding;
-  if (!embedding || !Number.isFinite(embedding.length) || embedding.length <= 0) {
-    throw new Error('Semantic check embedding is missing.');
+  const normalized = suite === 'benchmark' ? 'bench' : suite;
+  if (!BROWSER_SUITE_SET.includes(normalized)) {
+    throw createUnsupportedSuiteError(normalized, context);
   }
-  return embedding;
+  return normalized;
 }
 
-async function runEmbeddingSemanticChecks(pipeline, options = null) {
-  const config = resolveEmbeddingSemanticFixtures(
-    pipeline?.runtimeConfig ?? {},
-    options
-  );
-  const start = performance.now();
-  const semanticStyle = resolveEmbeddingSemanticStyle(pipeline);
-  const retrieval = [];
-  let retrievalPassed = 0;
-
-  for (const testCase of config.retrievalCases) {
-    const queryEmbedding = await embedStandaloneText(
-      pipeline,
-      formatEmbeddingSemanticText(testCase.query, 'query', semanticStyle)
-    );
-    const docEmbeddings = [];
-    for (const doc of testCase.docs) {
-      docEmbeddings.push(await embedStandaloneText(
-        pipeline,
-        formatEmbeddingSemanticText(doc, 'document', semanticStyle)
-      ));
-    }
-    const sims = docEmbeddings.map((docEmbedding) => cosineSimilarity(queryEmbedding, docEmbedding));
-    const topDoc = top1Index(sims);
-    const passed = topDoc === testCase.expectedDoc;
-    if (passed) retrievalPassed++;
-    retrieval.push({
-      id: testCase.id,
-      passed,
-      expectedDoc: testCase.expectedDoc,
-      topDoc,
-      sims: sims.map((v) => (Number.isFinite(v) ? Number(v.toFixed(6)) : null)),
-    });
-  }
+async function runKernelSuite(options = {}) {
+  const startTime = performance.now();
+  const { testHarness, initGPU } = await import('../../tests/kernels/browser/test-page.js');
+  const { runKernelSuite: runAllKernelTests } = await import('../../tests/kernels/browser/kernel-suite.js');
+  await initGPU();
 
-  const pairs = [];
-  let pairPassed = 0;
-  for (const testCase of config.pairCases) {
-    const anchor = await embedStandaloneText(
-      pipeline,
-      formatEmbeddingSemanticText(testCase.anchor, 'query', semanticStyle)
-    );
-    const positive = await embedStandaloneText(
-      pipeline,
-      formatEmbeddingSemanticText(testCase.positive, 'query', semanticStyle)
-    );
-    const negative = await embedStandaloneText(
-      pipeline,
-      formatEmbeddingSemanticText(testCase.negative, 'query', semanticStyle)
-    );
-    const simPos = cosineSimilarity(anchor, positive);
-    const simNeg = cosineSimilarity(anchor, negative);
-    const margin = simPos - simNeg;
-    const passed = Number.isFinite(margin) && margin > config.pairMargin;
-    if (passed) pairPassed++;
-    pairs.push({
-      id: testCase.id,
-      passed,
-      simPos: Number.isFinite(simPos) ? Number(simPos.toFixed(6)) : null,
-      simNeg: Number.isFinite(simNeg) ? Number(simNeg.toFixed(6)) : null,
-      margin: Number.isFinite(margin) ? Number(margin.toFixed(6)) : null,
-    });
+  const previousKernelPath = getActiveKernelPath();
+  const previousKernelSource = getActiveKernelPathSource();
+  const previousKernelPathPolicy = getActiveKernelPathPolicy();
+  if (options.modelId) {
+    await resolveKernelPathForModel(options);
   }
-
-  const retrievalTop1Acc = retrieval.length > 0 ? retrievalPassed / retrieval.length : 0;
-  const pairAcc = pairs.length > 0 ? pairPassed / pairs.length : 0;
-  const passed = retrievalTop1Acc >= config.minRetrievalTop1Acc
-    && pairAcc >= config.minPairAcc;
-  const failedCaseIds = [
-    ...retrieval.filter((item) => !item.passed).map((item) => `retrieval:${item.id}`),
-    ...pairs.filter((item) => !item.passed).map((item) => `pair:${item.id}`),
-  ];
-
-  return {
-    passed,
-    style: semanticStyle,
-    retrievalTop1Acc,
-    pairAcc,
-    retrievalPassed,
-    retrievalTotal: retrieval.length,
-    pairPassed,
-    pairTotal: pairs.length,
-    minRetrievalTop1Acc: Number(config.minRetrievalTop1Acc.toFixed(4)),
-    minPairAcc: Number(config.minPairAcc.toFixed(4)),
-    pairMarginThreshold: Number(config.pairMargin.toFixed(4)),
-    failedCaseIds,
-    retrieval,
-    pairs,
-    durationMs: Math.max(1, performance.now() - start),
-  };
-}
-
-// Matches pad/special tokens that indicate degenerate output: <pad>, <unused123>, <eos>,
-// <bos>, <s>, </s>, [PAD], [UNK], [SEP], [CLS], and bare angle-bracket tokens.
-const SPECIAL_TOKEN_RE = /^(<pad>|<unused\d*>|<eos>|<bos>|<s>|<\/s>|\[PAD\]|\[UNK\]|\[SEP\]|\[CLS\]|<[^>]{1,32}>)$/i;
-const PAD_DOMINANCE_THRESHOLD = 0.5;
-
-function isCoherentOutput(tokens, output) {
-  if (tokens.length === 0) return false;
-  const specialTokenCount = tokens.filter((t) => SPECIAL_TOKEN_RE.test(String(t).trim())).length;
-  if (specialTokenCount / tokens.length >= PAD_DOMINANCE_THRESHOLD) return false;
-  const cleanedOutput = String(output || '')
-    .replace(/<[^>\n]{1,80}>/g, ' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-  return cleanedOutput.length > 0;
-}
-
-async function runGeneration(pipeline, runtimeConfig, runOverrides = null) {
-  const tokens = [];
-  const tokenIds = [];
-  const promptInput = resolveGenerationPromptInput(runtimeConfig, runOverrides, pipeline);
-  const promptLabel = describePromptInput(promptInput);
-  const useChatTemplate = runOverrides?.useChatTemplate
-    ?? runtimeConfig?.inference?.chatTemplate?.enabled
-    ?? (isStructuredPromptInput(promptInput) ? true : undefined);
-  const maxTokens = Number.isFinite(runOverrides?.maxTokens)
-    ? Math.max(1, Math.floor(runOverrides.maxTokens))
-    : resolveMaxTokens(runtimeConfig);
-  const sampling = isPlainObject(runOverrides?.sampling)
-    ? runOverrides.sampling
-    : (runtimeConfig.inference?.sampling || {});
-  const debugProbes = runtimeConfig.shared?.debug?.probes || [];
-  const profile = runtimeConfig.shared?.debug?.profiler?.enabled === true;
-  const disableCommandBatching = Array.isArray(debugProbes) && debugProbes.length > 0;
-  const start = performance.now();
-
-  for await (const tokenText of pipeline.generate(promptInput, {
-    maxTokens,
-    temperature: sampling.temperature,
-    topP: sampling.topP,
-    topK: sampling.topK,
-    repetitionPenalty: sampling.repetitionPenalty,
-    greedyThreshold: sampling.greedyThreshold,
-    useChatTemplate,
-    profile,
-    disableCommandBatching,
-    onToken: (tokenId) => {
-      tokenIds.push(tokenId);
-    },
-  })) {
-    if (typeof tokenText === 'string') {
-      tokens.push(tokenText);
-    }
+  let results = [];
+  try {
+    results = await runAllKernelTests(testHarness);
+  } finally {
+    setActiveKernelPath(previousKernelPath, previousKernelSource, previousKernelPathPolicy);
   }
 
-  const durationMs = Math.max(1, performance.now() - start);
-  const tokensPerSec = (tokens.length / durationMs) * 1000;
-  const stats = typeof pipeline?.getStats === 'function'
-    ? (pipeline.getStats() || {})
-    : {};
-  const prefillMs = Number.isFinite(stats.prefillTimeMs) ? stats.prefillTimeMs : 0;
-  const ttftMs = Number.isFinite(stats.ttftMs) ? stats.ttftMs : prefillMs;
-  const decodeMs = Number.isFinite(stats.decodeTimeMs) ? stats.decodeTimeMs : 0;
-  const prefillTokens = Number.isFinite(stats.prefillTokens) ? stats.prefillTokens : 0;
-  const decodeTokens = Number.isFinite(stats.decodeTokens)
-    ? stats.decodeTokens
-    : Math.max(0, tokens.length - 1);
-  const decodeTokensPerSec = decodeMs > 0
-    ? (decodeTokens / decodeMs) * 1000
-    : 0;
-  const prefillTokensPerSec = prefillMs > 0
-    ? (prefillTokens / prefillMs) * 1000
-    : 0;
-  const prefillTokensPerSecTtft = ttftMs > 0
-    ? (prefillTokens / ttftMs) * 1000
-    : 0;
-  const gpu = {};
-  if (Number.isFinite(stats.gpuTimePrefillMs)) gpu.prefillMs = stats.gpuTimePrefillMs;
-  if (Number.isFinite(stats.gpuTimeDecodeMs)) gpu.decodeMs = stats.gpuTimeDecodeMs;
-  if (Number.isFinite(stats.decodeRecordMs)) gpu.decodeRecordMs = stats.decodeRecordMs;
-  if (Number.isFinite(stats.decodeSubmitWaitMs)) gpu.decodeSubmitWaitMs = stats.decodeSubmitWaitMs;
-  if (Number.isFinite(stats.decodeReadbackWaitMs)) gpu.decodeReadbackWaitMs = stats.decodeReadbackWaitMs;
-  const gpuPhase = Object.keys(gpu).length > 0 ? gpu : null;
-  const decodeProfileSteps = Array.isArray(stats.decodeProfileSteps)
-    ? stats.decodeProfileSteps
-    : null;
-
-  return {
-    prompt: promptLabel,
-    promptInput,
-    maxTokens,
-    tokens,
-    tokenIds,
-    output: tokens.join(''),
-    durationMs,
-    tokensPerSec,
-    phase: {
-      totalMs: Number.isFinite(stats.totalTimeMs) ? stats.totalTimeMs : durationMs,
-      ttftMs,
-      prefillMs,
-      decodeMs,
-      prefillTokens,
-      decodeTokens,
-      prefillTokensPerSec,
-      prefillTokensPerSecTtft,
-      decodeTokensPerSec,
-      gpu: gpuPhase,
-      decodeProfileSteps,
-    },
-  };
-}
-
-async function runEmbedding(pipeline, runtimeConfig, runOverrides = null) {
-  const prompt = typeof runOverrides?.prompt === 'string' && runOverrides.prompt.trim()
-    ? runOverrides.prompt.trim()
-    : resolvePrompt(runtimeConfig);
-  const start = performance.now();
-  const result = await pipeline.embed(prompt);
-  const durationMs = Math.max(1, performance.now() - start);
-  const tokenCount = Number.isFinite(result?.tokens?.length) ? result.tokens.length : 0;
-  const stats = summarizeEmbeddingValues(result?.embedding);
+  const summary = buildSuiteSummary('kernels', results, startTime);
   return {
-    prompt,
-    tokenCount,
-    durationMs,
-    ...stats,
+    ...summary,
+    deviceInfo: resolveDeviceInfo(),
   };
 }
 
@@ -1867,6 +364,7 @@ async function runInferenceSuite(options = {}) {
       modelLoadMs: safeModelLoadMs,
       gpu: run.phase.gpu,
       decodeProfileSteps: run.phase.decodeProfileSteps,
+      generationDiagnostics: run.tokenDiagnostics,
     };
   }
 
@@ -2280,6 +778,7 @@ async function runBenchSuite(options = {}) {
       totalRunMs: totalMsStats.median,
       decodeTokensPerSec: decodeTokensPerSecStats?.median,
       prefillTokensPerSec: prefillTokensPerSecStats?.median,
+      prefillTokensPerSecTtft: prefillTokensPerSecTtftStats?.median,
       cacheMode,
       loadMode,
     });
@@ -2323,261 +822,6 @@ async function runBenchSuite(options = {}) {
   };
 }
 
-async function runDiffusionSuite(options = {}) {
-  const startTime = performance.now();
-  const runtimeConfig = getRuntimeConfig();
-  const captureOutput = options.captureOutput === true;
-  const cacheMode = normalizeCacheMode(options.cacheMode);
-  const loadMode = normalizeLoadMode(options.loadMode, !options.modelUrl);
-  const benchConfig = runtimeConfig.shared?.benchmark?.run || {};
-  const warmupRuns = Math.max(0, Math.floor(benchConfig.warmupRuns ?? 0));
-  const timedRuns = Math.max(1, Math.floor(benchConfig.timedRuns ?? 1));
-
-  const diffusionConfig = runtimeConfig.inference?.diffusion;
-  if (!diffusionConfig) {
-    throw new Error('runtime.inference.diffusion must be set for diffusion harness runs.');
-  }
-  const scheduler = diffusionConfig.scheduler;
-  const latent = diffusionConfig.latent;
-  const prompt = resolvePrompt(runtimeConfig);
-  const negativePrompt = diffusionConfig.negativePrompt ?? '';
-
-  const width = Math.floor(latent?.width);
-  const height = Math.floor(latent?.height);
-  const steps = Math.floor(scheduler?.numSteps);
-  const guidanceScale = scheduler?.guidanceScale;
-
-  if (!Number.isFinite(width) || width <= 0) {
-    throw new Error('runtime.inference.diffusion.latent.width must be set for diffusion harness runs.');
-  }
-  if (!Number.isFinite(height) || height <= 0) {
-    throw new Error('runtime.inference.diffusion.latent.height must be set for diffusion harness runs.');
-  }
-  if (!Number.isFinite(steps) || steps <= 0) {
-    throw new Error('runtime.inference.diffusion.scheduler.numSteps must be set for diffusion harness runs.');
-  }
-  if (!Number.isFinite(guidanceScale) || guidanceScale <= 0) {
-    throw new Error('runtime.inference.diffusion.scheduler.guidanceScale must be set for diffusion harness runs.');
-  }
-
-  const harness = await initializeSuiteModel(options);
-  const totalMs = [];
-  const prefillMs = [];
-  const denoiseMs = [];
-  const vaeMs = [];
-  const prefillTokens = [];
-  const decodeTokens = [];
-  const gpuTotalMs = [];
-  const gpuPrefillMs = [];
-  const gpuDenoiseMs = [];
-  const gpuVaeMs = [];
-  let output = null;
-
-  for (let i = 0; i < warmupRuns + timedRuns; i++) {
-    harness.pipeline.reset?.();
-    const result = await harness.pipeline.generate({
-      prompt,
-      negativePrompt,
-      steps,
-      guidanceScale,
-      width,
-      height,
-    });
-    if (captureOutput && i === warmupRuns + timedRuns - 1) {
-      output = result;
-    }
-
-    if (i < warmupRuns) continue;
-
-    const stats = harness.pipeline.getStats?.() ?? {};
-    if (Number.isFinite(stats.totalTimeMs)) totalMs.push(stats.totalTimeMs);
-    if (Number.isFinite(stats.prefillTimeMs)) prefillMs.push(stats.prefillTimeMs);
-    if (Number.isFinite(stats.decodeTimeMs)) denoiseMs.push(stats.decodeTimeMs);
-    if (Number.isFinite(stats.vaeTimeMs)) vaeMs.push(stats.vaeTimeMs);
-    if (Number.isFinite(stats.prefillTokens)) prefillTokens.push(stats.prefillTokens);
-    if (Number.isFinite(stats.decodeTokens)) decodeTokens.push(stats.decodeTokens);
-
-    const gpu = stats.gpu ?? null;
-    if (gpu?.available) {
-      if (Number.isFinite(gpu.totalMs)) gpuTotalMs.push(gpu.totalMs);
-      if (Number.isFinite(gpu.prefillMs)) gpuPrefillMs.push(gpu.prefillMs);
-      if (Number.isFinite(gpu.denoiseMs)) gpuDenoiseMs.push(gpu.denoiseMs);
-      if (Number.isFinite(gpu.vaeMs)) gpuVaeMs.push(gpu.vaeMs);
-    }
-  }
-
-  const memoryStats = typeof harness.pipeline?.getMemoryStats === 'function'
-    ? harness.pipeline.getMemoryStats()
-    : null;
-
-  if (typeof harness.pipeline.unload === 'function' && !options.keepPipeline) {
-    await harness.pipeline.unload();
-  }
-
-  const results = [
-    {
-      name: 'diffusion',
-      passed: totalMs.length > 0,
-      duration: totalMs.reduce((sum, value) => sum + value, 0),
-      error: totalMs.length > 0 ? undefined : 'No diffusion runs completed',
-    },
-  ];
-
-  const summary = buildSuiteSummary('diffusion', results, startTime);
-  const cpuStats = {
-    totalMs: computeSampleStats(totalMs),
-    prefillMs: computeSampleStats(prefillMs),
-    denoiseMs: computeSampleStats(denoiseMs),
-    vaeMs: computeSampleStats(vaeMs),
-  };
-  const gpuStats = gpuTotalMs.length > 0
-    ? {
-      available: true,
-      totalMs: computeSampleStats(gpuTotalMs),
-      prefillMs: computeSampleStats(gpuPrefillMs),
-      denoiseMs: computeSampleStats(gpuDenoiseMs),
-      vaeMs: computeSampleStats(gpuVaeMs),
-    }
-    : { available: false };
-
-  const avgPrefillTokens = prefillTokens.length
-    ? Math.round(prefillTokens.reduce((a, b) => a + b, 0) / prefillTokens.length)
-    : 0;
-  const avgDecodeTokens = decodeTokens.length
-    ? Math.round(decodeTokens.reduce((a, b) => a + b, 0) / decodeTokens.length)
-    : 0;
-  const prefillMsMedian = safeStatsValue(cpuStats.prefillMs?.median);
-  const denoiseMsMedian = safeStatsValue(cpuStats.denoiseMs?.median);
-  const totalMsMedian = safeStatsValue(cpuStats.totalMs?.median);
-  const diffusionPerformanceArtifact = buildDiffusionPerformanceArtifact({
-    warmupRuns,
-    timedRuns,
-    width,
-    height,
-    steps,
-    guidanceScale,
-    avgPrefillTokens,
-    avgDecodeTokens,
-    cpuStats,
-    gpuStats,
-  });
-  const timing = buildCanonicalTiming({
-    modelLoadMs: 0,
-    firstTokenMs: null,
-    firstResponseMs: null,
-    prefillMs: prefillMsMedian,
-    decodeMs: denoiseMsMedian,
-    totalRunMs: totalMsMedian,
-    prefillTokensPerSec: diffusionPerformanceArtifact.throughput.prefillTokensPerSec,
-    decodeTokensPerSec: diffusionPerformanceArtifact.throughput.decodeTokensPerSec,
-    cacheMode,
-    loadMode,
-  });
-  const timingDiagnostics = buildTimingDiagnostics(timing, {
-    source: 'doppler',
-    prefillSemantics: 'internal_prefill_phase',
-  });
-  const metricsWithContracts = buildSuiteContractMetrics(
-    'diffusion',
-    {
-      warmupRuns,
-      timedRuns,
-      width,
-      height,
-      steps,
-      guidanceScale,
-      prompt,
-      avgPrefillTokens,
-      avgDecodeTokens,
-      latency: {
-        totalMs: cpuStats.totalMs,
-        prefillMs: cpuStats.prefillMs,
-        denoiseMs: cpuStats.denoiseMs,
-        vaeMs: cpuStats.vaeMs,
-      },
-      throughput: {
-        prefillTokensPerSec: diffusionPerformanceArtifact.throughput.prefillTokensPerSec,
-        decodeTokensPerSec: diffusionPerformanceArtifact.throughput.decodeTokensPerSec,
-        decodeStepsPerSec: diffusionPerformanceArtifact.throughput.decodeStepsPerSec,
-      },
-      cpu: cpuStats,
-      gpu: gpuStats,
-      performanceArtifact: diffusionPerformanceArtifact,
-    },
-    harness.manifest
-  );
-
-  return {
-    ...summary,
-    modelId: options.modelId || harness.manifest?.modelId || 'unknown',
-    cacheMode,
-    loadMode,
-    env: {
-      library: 'doppler',
-      runtime: 'browser',
-      device: 'webgpu',
-      browserUserAgent: typeof navigator !== 'undefined' ? (navigator.userAgent || null) : null,
-      browserPlatform: typeof navigator !== 'undefined' ? (navigator.platform || null) : null,
-      browserLanguage: typeof navigator !== 'undefined' ? (navigator.language || null) : null,
-      browserVendor: typeof navigator !== 'undefined' ? (navigator.vendor || null) : null,
-    },
-    timing,
-    timingDiagnostics,
-    output,
-    metrics: metricsWithContracts,
-    memoryStats,
-    deviceInfo: resolveDeviceInfo(),
-    pipeline: options.keepPipeline ? harness.pipeline : null,
-  };
-}
-
-async function runEnergySuite(options = {}) {
-  const startTime = performance.now();
-  const harness = await initializeSuiteModel(options);
-  if (harness.manifest?.modelType !== 'energy') {
-    throw new Error('Energy suite requires an energy model manifest.');
-  }
-
-  const result = await harness.pipeline.generate();
-  const stats = harness.pipeline.getStats?.() ?? {};
-
-  const memoryStats = typeof harness.pipeline?.getMemoryStats === 'function'
-    ? harness.pipeline.getMemoryStats()
-    : null;
-
-  if (typeof harness.pipeline.unload === 'function' && !options.keepPipeline) {
-    await harness.pipeline.unload();
-  }
-
-  const results = [
-    {
-      name: 'energy',
-      passed: Number.isFinite(result.energy ?? NaN),
-      duration: result.totalTimeMs ?? Math.max(0, performance.now() - startTime),
-      error: Number.isFinite(result.energy ?? NaN) ? undefined : 'Energy did not converge',
-    },
-  ];
-
-  const summary = buildSuiteSummary('energy', results, startTime);
-  return {
-    ...summary,
-    modelId: options.modelId || harness.manifest?.modelId || 'unknown',
-    metrics: {
-      steps: result.steps,
-      energy: result.energy ?? null,
-      dtype: result.dtype,
-      shape: result.shape,
-      totalTimeMs: result.totalTimeMs ?? null,
-      energyHistory: result.energyHistory ?? [],
-      stateStats: result.stateStats ?? null,
-      readbackCount: stats.readbackCount ?? null,
-    },
-    memoryStats,
-    deviceInfo: resolveDeviceInfo(),
-    pipeline: options.keepPipeline ? harness.pipeline : null,
-  };
-}
-
 async function dispatchBrowserSuite(suite, options) {
   if (suite === 'kernels') {
     return runKernelSuite(options);
@@ -2603,47 +847,16 @@ async function dispatchBrowserSuite(suite, options) {
   return null;
 }
 
-function collectTrainingArtifactsFromSuiteResult(suiteResult) {
-  const ulArtifacts = [];
-  const distillArtifacts = [];
-  const checkpointResumeTimeline = Array.isArray(suiteResult?.metrics?.checkpointResumeTimeline)
-    ? suiteResult.metrics.checkpointResumeTimeline
-      .filter((entry) => entry && typeof entry === 'object')
-    : [];
-  const addArtifact = (artifact, source = null) => {
-    if (!artifact || typeof artifact !== 'object' || typeof artifact.manifestPath !== 'string') {
-      return;
-    }
-    const stage = String(artifact.stage || '').trim();
-    const kind = String(artifact.kind || '').trim();
-    if (kind === 'distill' || stage === 'stage_a' || stage === 'stage_b') {
-      distillArtifacts.push(artifact);
-      return;
-    }
-    if (kind === 'ul' || stage === 'stage1_joint' || stage === 'stage2_base' || source === 'ul') {
-      ulArtifacts.push(artifact);
-      return;
-    }
-    ulArtifacts.push(artifact);
-  };
-
-  const metricUlArtifacts = Array.isArray(suiteResult?.metrics?.ulArtifacts)
-    ? suiteResult.metrics.ulArtifacts
-    : [];
-  for (const artifact of metricUlArtifacts) {
-    addArtifact(artifact, 'ul');
-  }
-  const metricDistillArtifacts = Array.isArray(suiteResult?.metrics?.distillArtifacts)
-    ? suiteResult.metrics.distillArtifacts
-    : [];
-  for (const artifact of metricDistillArtifacts) {
-    addArtifact(artifact, 'distill');
-  }
-  const resultEntries = Array.isArray(suiteResult?.results) ? suiteResult.results : [];
-  for (const entry of resultEntries) {
-    addArtifact(entry?.artifact, null);
-  }
-  return { ulArtifacts, distillArtifacts, checkpointResumeTimeline };
+function shouldCaptureDebugSnapshot(suite, runtimeConfig) {
+  const debug = runtimeConfig?.shared?.debug ?? {};
+  const logLevel = String(debug.logLevel?.defaultLogLevel ?? '').toLowerCase();
+  return suite === 'debug'
+    || debug.trace?.enabled === true
+    || debug.pipeline?.enabled === true
+    || (Array.isArray(debug.probes) && debug.probes.length > 0)
+    || debug.profiler?.enabled === true
+    || logLevel === 'debug'
+    || logLevel === 'verbose';
 }
 
 export async function runBrowserSuite(options = {}) {
@@ -2651,10 +864,15 @@ export async function runBrowserSuite(options = {}) {
     const suiteTimestamp = resolveReportTimestamp(options.timestamp, 'runBrowserSuite timestamp');
     const suiteContext = resolveSuiteContext(options);
     const suite = normalizeSuite(options.suite, suiteContext);
+    const captureDebugSnapshot = shouldCaptureDebugSnapshot(suite, getRuntimeConfig());
+    if (captureDebugSnapshot) {
+      clearLogHistory();
+    }
     const suiteResult = await dispatchBrowserSuite(suite, options);
     if (!suiteResult) {
       throw createUnsupportedSuiteError(suite, suiteContext);
     }
+    const debugSnapshot = captureDebugSnapshot ? getDebugSnapshot() : null;
 
     if (suite === 'bench' && suiteResult?.metrics?.workloadType === 'training') {
       const trainingReport = suiteResult?.metrics?.trainingMetricsReport;
@@ -2686,6 +904,7 @@ export async function runBrowserSuite(options = {}) {
       metrics: suiteResult.metrics ?? null,
       output: reportOutput,
       memory: suiteResult.memoryStats ?? null,
+      debugSnapshot,
       ...options.report,
     };
     if (ulArtifacts.length > 0 || distillArtifacts.length > 0 || checkpointResumeTimeline.length > 0) {
@@ -2707,76 +926,10 @@ export async function runBrowserSuite(options = {}) {
       report.timestamp = suiteTimestamp;
     }
     const reportInfo = await saveReport(modelId, report, { timestamp: report.timestamp });
-    return { ...suiteResult, report, reportInfo };
+    return { ...suiteResult, debugSnapshot, report, reportInfo };
   });
 }
 
-function normalizeManifest(manifest) {
-  if (!manifest || typeof manifest !== 'object') {
-    throw new Error('Harness manifest must be an object.');
-  }
-  const runs = Array.isArray(manifest.runs) ? manifest.runs : [];
-  if (!runs.length) {
-    throw new Error('Harness manifest must include at least one run.');
-  }
-  return {
-    defaults: manifest.defaults ?? {},
-    runs,
-    reportModelId: manifest.reportModelId ?? manifest.id ?? 'manifest',
-    report: manifest.report ?? null,
-  };
-}
-
-function mergeRunDefaults(defaults, run) {
-  return {
-    ...defaults,
-    ...run,
-    runtimePreset: run.runtimePreset ?? defaults.runtimePreset ?? null,
-    runtimeConfigUrl: run.runtimeConfigUrl ?? defaults.runtimeConfigUrl ?? null,
-    runtimeConfig: run.runtimeConfig ?? defaults.runtimeConfig ?? null,
-    suite: run.suite ?? defaults.suite ?? 'inference',
-  };
-}
-
-async function applyRuntimeForRun(run, options) {
-  if (run.runtimeConfig) {
-    const runtime = resolveRuntimeFromConfig(run.runtimeConfig);
-    if (!runtime) {
-      throw new Error('runtimeConfig is missing runtime fields');
-    }
-    setRuntimeConfig(runtime);
-    return;
-  }
-  if (run.runtimeConfigUrl) {
-    await applyRuntimeConfigFromUrl(run.runtimeConfigUrl, options);
-    return;
-  }
-  if (run.runtimePreset) {
-    await applyRuntimePreset(run.runtimePreset, options);
-  }
-}
-
-function summarizeManifestRuns(results) {
-  let passedRuns = 0;
-  let failedRuns = 0;
-  let durationMs = 0;
-  for (const result of results) {
-    const failures = (result.results || []).filter((entry) => !entry.passed && !entry.skipped);
-    if (failures.length > 0) {
-      failedRuns += 1;
-    } else {
-      passedRuns += 1;
-    }
-    durationMs += result.duration || 0;
-  }
-  return {
-    totalRuns: results.length,
-    passedRuns,
-    failedRuns,
-    durationMs,
-  };
-}
-
 export async function runBrowserManifest(manifest, options = {}) {
   const normalized = normalizeManifest(manifest);
   const results = [];