@tracecode/harness 0.4.0

package/dist/core.cjs

@@ -0,0 +1,286 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/harness-core/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION: () => RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION,
+  adaptJavaScriptTraceExecutionResult: () => adaptJavaScriptTraceExecutionResult,
+  adaptPythonTraceExecutionResult: () => adaptPythonTraceExecutionResult,
+  adaptTraceExecutionResult: () => adaptTraceExecutionResult,
+  normalizeRuntimeTraceContract: () => normalizeRuntimeTraceContract,
+  stableStringifyRuntimeTraceContract: () => stableStringifyRuntimeTraceContract
+});
+module.exports = __toCommonJS(src_exports);
+
+// packages/harness-core/src/trace-contract.ts
+var RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION = "2026-03-07";
+var TRACE_EVENTS = /* @__PURE__ */ new Set([
+  "line",
+  "call",
+  "return",
+  "exception",
+  "timeout",
+  "stdout"
+]);
+var TRACE_ACCESS_KINDS = /* @__PURE__ */ new Set([
+  "indexed-read",
+  "indexed-write",
+  "cell-read",
+  "cell-write",
+  "mutating-call"
+]);
+function normalizeLineNumber(value, fallback = 1) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  const normalized = Math.floor(value);
+  return normalized > 0 ? normalized : fallback;
+}
+function normalizeOutputLineCount(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  const normalized = Math.floor(value);
+  return normalized >= 0 ? normalized : void 0;
+}
+function normalizeEvent(value) {
+  if (typeof value === "string" && TRACE_EVENTS.has(value)) {
+    return value;
+  }
+  return "line";
+}
+function normalizeAccessKind(value) {
+  if (typeof value === "string" && TRACE_ACCESS_KINDS.has(value)) {
+    return value;
+  }
+  return null;
+}
+function normalizeFunctionName(value) {
+  if (typeof value === "string" && value.length > 0) return value;
+  return "<module>";
+}
+function normalizeKind(value) {
+  if (value === "map" || value === "set" || value === "hashmap") {
+    return value;
+  }
+  return "hashmap";
+}
+function normalizeObjectKind(value) {
+  if (value === "hashmap" || value === "map" || value === "set" || value === "tree" || value === "linked-list" || value === "graph-adjacency") {
+    return value;
+  }
+  return null;
+}
+function normalizeScalar(value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "number") return Number.isFinite(value) ? value : String(value);
+  if (typeof value === "bigint") {
+    const asNumber = Number(value);
+    return Number.isSafeInteger(asNumber) ? asNumber : String(value);
+  }
+  if (typeof value === "function") return "<function>";
+  return null;
+}
+function normalizeUnknown(value, depth = 0, seen = /* @__PURE__ */ new WeakSet()) {
+  if (depth > 48) return "<max depth>";
+  const scalar = normalizeScalar(value);
+  if (scalar !== null || value === null || value === void 0) {
+    return scalar;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (item === void 0) return null;
+      return normalizeUnknown(item, depth + 1, seen);
+    });
+  }
+  if (typeof value === "object" && value) {
+    if (seen.has(value)) return "<cycle>";
+    seen.add(value);
+    const normalized = {};
+    for (const key of Object.keys(value).sort()) {
+      const child = value[key];
+      if (child === void 0) continue;
+      normalized[key] = normalizeUnknown(child, depth + 1, seen);
+    }
+    seen.delete(value);
+    return normalized;
+  }
+  return String(value);
+}
+function normalizeAccesses(accesses) {
+  if (!Array.isArray(accesses) || accesses.length === 0) {
+    return void 0;
+  }
+  const normalized = accesses.map((access) => {
+    const variable = typeof access?.variable === "string" && access.variable.length > 0 ? access.variable : "";
+    const kind = normalizeAccessKind(access?.kind);
+    if (!variable || !kind) {
+      return null;
+    }
+    const indices = Array.isArray(access?.indices) ? access.indices.map(
+      (index) => typeof index === "number" && Number.isFinite(index) ? Math.floor(index) : null
+    ).filter((index) => index !== null) : void 0;
+    const pathDepth = access?.pathDepth === 1 || access?.pathDepth === 2 ? access.pathDepth : void 0;
+    const method = typeof access?.method === "string" && access.method.length > 0 ? access.method : void 0;
+    const payload = {
+      variable,
+      kind
+    };
+    if (indices && indices.length > 0) {
+      payload.indices = indices;
+    }
+    if (pathDepth !== void 0) {
+      payload.pathDepth = pathDepth;
+    }
+    if (method) {
+      payload.method = method;
+    }
+    return payload;
+  }).filter((access) => access !== null);
+  return normalized.length > 0 ? normalized : void 0;
+}
+function normalizeRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  return normalizeUnknown(value);
+}
+function normalizeCallStackFrame(frame) {
+  return {
+    function: normalizeFunctionName(frame?.function),
+    line: normalizeLineNumber(frame?.line, 1),
+    args: normalizeRecord(frame?.args)
+  };
+}
+function normalizeVisualizationPayload(payload) {
+  const hashMaps = Array.isArray(payload?.hashMaps) ? payload.hashMaps.map((entry) => ({
+    name: typeof entry?.name === "string" ? entry.name : "",
+    kind: normalizeKind(entry?.kind),
+    entries: Array.isArray(entry?.entries) ? entry.entries.map((item) => ({
+      key: normalizeUnknown(item?.key),
+      value: normalizeUnknown(item?.value),
+      ...item?.highlight ? { highlight: true } : {}
+    })) : [],
+    ...entry?.highlightedKey !== void 0 ? { highlightedKey: normalizeUnknown(entry.highlightedKey) } : {},
+    ...entry?.deletedKey !== void 0 ? { deletedKey: normalizeUnknown(entry.deletedKey) } : {}
+  })).sort((a, b) => `${a.name}:${a.kind}`.localeCompare(`${b.name}:${b.kind}`)) : [];
+  const objectKinds = payload?.objectKinds && typeof payload.objectKinds === "object" ? Object.fromEntries(
+    Object.entries(payload.objectKinds).filter(([name]) => typeof name === "string" && name.length > 0).map(([name, kind]) => [name, normalizeObjectKind(kind)]).filter((entry) => entry[1] !== null).sort((a, b) => a[0].localeCompare(b[0]))
+  ) : void 0;
+  if (hashMaps.length === 0 && (!objectKinds || Object.keys(objectKinds).length === 0)) {
+    return void 0;
+  }
+  return {
+    ...hashMaps.length > 0 ? { hashMaps } : {},
+    ...objectKinds && Object.keys(objectKinds).length > 0 ? { objectKinds } : {}
+  };
+}
+function normalizeTraceStep(step) {
+  const normalizedStdoutCount = normalizeOutputLineCount(step?.stdoutLineCount);
+  const normalizedVisualization = normalizeVisualizationPayload(step?.visualization);
+  const normalizedAccesses = normalizeAccesses(step?.accesses);
+  return {
+    event: normalizeEvent(step?.event),
+    line: normalizeLineNumber(step?.line, 1),
+    function: normalizeFunctionName(step?.function),
+    variables: normalizeRecord(step?.variables),
+    ...Array.isArray(step?.callStack) && step.callStack.length > 0 ? { callStack: step.callStack.map(normalizeCallStackFrame) } : {},
+    ...normalizedAccesses ? { accesses: normalizedAccesses } : {},
+    ...step?.returnValue !== void 0 ? { returnValue: normalizeUnknown(step.returnValue) } : {},
+    ...normalizedStdoutCount !== void 0 ? { stdoutLineCount: normalizedStdoutCount } : {},
+    ...normalizedVisualization ? { visualization: normalizedVisualization } : {}
+  };
+}
+function normalizeRuntimeTraceContract(language, result) {
+  const normalizedTrace = Array.isArray(result.trace) ? result.trace.map(normalizeTraceStep) : [];
+  const lineEventCount = typeof result.lineEventCount === "number" && Number.isFinite(result.lineEventCount) ? Math.floor(result.lineEventCount) : normalizedTrace.filter((step) => step.event === "line").length;
+  const normalizedConsole = Array.isArray(result.consoleOutput) ? result.consoleOutput.map((line) => String(line)) : [];
+  return {
+    schemaVersion: RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION,
+    language,
+    success: Boolean(result.success),
+    ...Object.prototype.hasOwnProperty.call(result, "output") ? { output: normalizeUnknown(result.output) } : {},
+    ...typeof result.error === "string" && result.error.length > 0 ? { error: result.error } : {},
+    ...typeof result.errorLine === "number" && Number.isFinite(result.errorLine) ? { errorLine: Math.floor(result.errorLine) } : {},
+    consoleOutput: normalizedConsole,
+    trace: normalizedTrace,
+    ...result.traceLimitExceeded !== void 0 ? { traceLimitExceeded: Boolean(result.traceLimitExceeded) } : {},
+    ...typeof result.timeoutReason === "string" && result.timeoutReason.length > 0 ? { timeoutReason: result.timeoutReason } : {},
+    lineEventCount: Math.max(0, lineEventCount),
+    traceStepCount: normalizedTrace.length
+  };
+}
+function stableStringifyRuntimeTraceContract(value) {
+  return JSON.stringify(normalizeUnknown(value), null, 2);
+}
+
+// packages/harness-core/src/trace-adapters/shared.ts
+function denormalizeCallStackFrame(frame) {
+  return {
+    function: frame.function,
+    line: frame.line,
+    args: frame.args
+  };
+}
+function denormalizeTraceStep(step) {
+  return {
+    line: step.line,
+    event: step.event,
+    variables: step.variables,
+    function: step.function,
+    ...step.callStack ? { callStack: step.callStack.map(denormalizeCallStackFrame) } : {},
+    ...step.accesses ? { accesses: step.accesses } : {},
+    ...step.returnValue !== void 0 ? { returnValue: step.returnValue } : {},
+    ...step.stdoutLineCount !== void 0 ? { stdoutLineCount: step.stdoutLineCount } : {},
+    ...step.visualization ? { visualization: step.visualization } : {}
+  };
+}
+function adaptTraceExecutionResult(language, result) {
+  const normalized = normalizeRuntimeTraceContract(language, result);
+  const adaptedTrace = normalized.trace.map(denormalizeTraceStep);
+  return {
+    success: normalized.success,
+    ...Object.prototype.hasOwnProperty.call(normalized, "output") ? { output: normalized.output } : {},
+    ...normalized.error ? { error: normalized.error } : {},
+    ...normalized.errorLine !== void 0 ? { errorLine: normalized.errorLine } : {},
+    trace: adaptedTrace,
+    executionTimeMs: typeof result.executionTimeMs === "number" && Number.isFinite(result.executionTimeMs) ? result.executionTimeMs : 0,
+    consoleOutput: normalized.consoleOutput,
+    ...normalized.traceLimitExceeded !== void 0 ? { traceLimitExceeded: normalized.traceLimitExceeded } : {},
+    ...normalized.timeoutReason ? { timeoutReason: normalized.timeoutReason } : {},
+    lineEventCount: normalized.lineEventCount,
+    traceStepCount: adaptedTrace.length
+  };
+}
+
+// packages/harness-core/src/trace-adapters/python.ts
+function adaptPythonTraceExecutionResult(result) {
+  return adaptTraceExecutionResult("python", result);
+}
+
+// packages/harness-core/src/trace-adapters/javascript.ts
+function adaptJavaScriptTraceExecutionResult(language, result) {
+  return adaptTraceExecutionResult(language, result);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION,
+  adaptJavaScriptTraceExecutionResult,
+  adaptPythonTraceExecutionResult,
+  adaptTraceExecutionResult,
+  normalizeRuntimeTraceContract,
+  stableStringifyRuntimeTraceContract
+});
+//# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/harness-core/src/index.ts","../packages/harness-core/src/trace-contract.ts","../packages/harness-core/src/trace-adapters/shared.ts","../packages/harness-core/src/trace-adapters/python.ts","../packages/harness-core/src/trace-adapters/javascript.ts"],"sourcesContent":["export * from './runtime-types';\nexport * from './types';\nexport * from './trace-contract';\nexport * from './trace-adapters/shared';\nexport * from './trace-adapters/python';\nexport * from './trace-adapters/javascript';\n","import type { Language } from './runtime-types';\nimport type {\n  CallStackFrame,\n  ExecutionResult,\n  RawTraceStep,\n  RuntimeTraceAccessEvent,\n  RuntimeTraceAccessKind,\n  RuntimeObjectKind,\n  RuntimeVisualizationPayload,\n} from './types';\n\n/**\n * Runtime trace contract schema version.\n *\n * Bump this when payload shape/normalization semantics change in a way that\n * should invalidate golden fixtures.\n */\nexport const RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION = '2026-03-07';\n\nexport type RuntimeTraceContractEvent =\n  | 'line'\n  | 'call'\n  | 'return'\n  | 'exception'\n  | 'timeout'\n  | 'stdout';\n\nexport interface RuntimeTraceContractHashMapEntry {\n  key: unknown;\n  value: unknown;\n  highlight?: boolean;\n}\n\nexport interface RuntimeTraceContractHashMap {\n  name: string;\n  kind: 'hashmap' | 'map' | 'set';\n  entries: RuntimeTraceContractHashMapEntry[];\n  highlightedKey?: unknown;\n  deletedKey?: unknown;\n}\n\nexport interface RuntimeTraceContractVisualization {\n  hashMaps?: RuntimeTraceContractHashMap[];\n  objectKinds?: Partial<Record<string, RuntimeObjectKind>>;\n}\n\nexport interface RuntimeTraceContractCallStackFrame {\n  function: string;\n  line: number;\n  args: Record<string, unknown>;\n}\n\nexport interface RuntimeTraceContractStep {\n  event: RuntimeTraceContractEvent;\n  line: number;\n  function: string;\n  variables: Record<string, unknown>;\n  callStack?: RuntimeTraceContractCallStackFrame[];\n  accesses?: RuntimeTraceAccessEvent[];\n  returnValue?: unknown;\n  stdoutLineCount?: number;\n  visualization?: RuntimeTraceContractVisualization;\n}\n\nexport interface RuntimeTraceContractResult {\n  schemaVersion: typeof RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION;\n  language: Language;\n  success: boolean;\n  output?: unknown;\n  error?: string;\n  errorLine?: number;\n  consoleOutput: string[];\n  trace: RuntimeTraceContractStep[];\n  traceLimitExceeded?: boolean;\n  timeoutReason?: string;\n  lineEventCount: number;\n  traceStepCount: number;\n}\n\nconst TRACE_EVENTS: ReadonlySet<string> = new Set([\n  'line',\n  'call',\n  'return',\n  'exception',\n  'timeout',\n  'stdout',\n]);\n\nconst TRACE_ACCESS_KINDS: ReadonlySet<RuntimeTraceAccessKind> = new Set([\n  'indexed-read',\n  'indexed-write',\n  'cell-read',\n  'cell-write',\n  'mutating-call',\n]);\n\nfunction normalizeLineNumber(value: unknown, fallback = 1): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return fallback;\n  const normalized = Math.floor(value);\n  return normalized > 0 ? normalized : fallback;\n}\n\nfunction normalizeOutputLineCount(value: unknown): number | undefined {\n  if (typeof value !== 'number' || !Number.isFinite(value)) return undefined;\n  const normalized = Math.floor(value);\n  return normalized >= 0 ? normalized : undefined;\n}\n\nfunction normalizeEvent(value: unknown): RuntimeTraceContractEvent {\n  if (typeof value === 'string' && TRACE_EVENTS.has(value)) {\n    return value as RuntimeTraceContractEvent;\n  }\n  return 'line';\n}\n\nfunction normalizeAccessKind(value: unknown): RuntimeTraceAccessKind | null {\n  if (typeof value === 'string' && TRACE_ACCESS_KINDS.has(value as RuntimeTraceAccessKind)) {\n    return value as RuntimeTraceAccessKind;\n  }\n  return null;\n}\n\nfunction normalizeFunctionName(value: unknown): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  return '<module>';\n}\n\nfunction normalizeKind(value: unknown): 'hashmap' | 'map' | 'set' {\n  if (value === 'map' || value === 'set' || value === 'hashmap') {\n    return value;\n  }\n  return 'hashmap';\n}\n\nfunction normalizeObjectKind(value: unknown): RuntimeObjectKind | null {\n  if (\n    value === 'hashmap' ||\n    value === 'map' ||\n    value === 'set' ||\n    value === 'tree' ||\n    value === 'linked-list' ||\n    value === 'graph-adjacency'\n  ) {\n    return value;\n  }\n  return null;\n}\n\nfunction normalizeScalar(value: unknown): unknown {\n  if (value === null || value === undefined) return value;\n  if (typeof value === 'string' || typeof value === 'boolean') return value;\n  if (typeof value === 'number') return Number.isFinite(value) ? value : String(value);\n  if (typeof value === 'bigint') {\n    const asNumber = Number(value);\n    return Number.isSafeInteger(asNumber) ? asNumber : String(value);\n  }\n  if (typeof value === 'function') return '<function>';\n  return null;\n}\n\nfunction normalizeUnknown(value: unknown, depth = 0, seen = new WeakSet<object>()): unknown {\n  if (depth > 48) return '<max depth>';\n\n  const scalar = normalizeScalar(value);\n  if (scalar !== null || value === null || value === undefined) {\n    return scalar;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => {\n      if (item === undefined) return null;\n      return normalizeUnknown(item, depth + 1, seen);\n    });\n  }\n\n  if (typeof value === 'object' && value) {\n    if (seen.has(value)) return '<cycle>';\n    seen.add(value);\n\n    const normalized: Record<string, unknown> = {};\n    for (const key of Object.keys(value as Record<string, unknown>).sort()) {\n      const child = (value as Record<string, unknown>)[key];\n      if (child === undefined) continue;\n      normalized[key] = normalizeUnknown(child, depth + 1, seen);\n    }\n\n    seen.delete(value);\n    return normalized;\n  }\n\n  return String(value);\n}\n\nfunction normalizeAccesses(\n  accesses: RuntimeTraceAccessEvent[] | undefined\n): RuntimeTraceAccessEvent[] | undefined {\n  if (!Array.isArray(accesses) || accesses.length === 0) {\n    return undefined;\n  }\n\n  const normalized = accesses\n    .map((access) => {\n      const variable =\n        typeof access?.variable === 'string' && access.variable.length > 0 ? access.variable : '';\n      const kind = normalizeAccessKind(access?.kind);\n      if (!variable || !kind) {\n        return null;\n      }\n\n      const indices = Array.isArray(access?.indices)\n        ? access.indices\n            .map((index) =>\n              typeof index === 'number' && Number.isFinite(index) ? Math.floor(index) : null\n            )\n            .filter((index): index is number => index !== null)\n        : undefined;\n      const pathDepth =\n        access?.pathDepth === 1 || access?.pathDepth === 2 ? access.pathDepth : undefined;\n      const method =\n        typeof access?.method === 'string' && access.method.length > 0 ? access.method : undefined;\n\n      const payload: RuntimeTraceAccessEvent = {\n        variable,\n        kind,\n      };\n\n      if (indices && indices.length > 0) {\n        payload.indices = indices;\n      }\n      if (pathDepth !== undefined) {\n        payload.pathDepth = pathDepth;\n      }\n      if (method) {\n        payload.method = method;\n      }\n\n      return payload;\n    })\n    .filter((access): access is RuntimeTraceAccessEvent => access !== null);\n\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nfunction normalizeRecord(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return normalizeUnknown(value) as Record<string, unknown>;\n}\n\nfunction normalizeCallStackFrame(frame: CallStackFrame): RuntimeTraceContractCallStackFrame {\n  return {\n    function: normalizeFunctionName(frame?.function),\n    line: normalizeLineNumber(frame?.line, 1),\n    args: normalizeRecord(frame?.args),\n  };\n}\n\nfunction normalizeVisualizationPayload(\n  payload: RuntimeVisualizationPayload | undefined\n): RuntimeTraceContractVisualization | undefined {\n  const hashMaps = Array.isArray(payload?.hashMaps)\n    ? payload.hashMaps\n        .map((entry) => ({\n          name: typeof entry?.name === 'string' ? entry.name : '',\n          kind: normalizeKind(entry?.kind),\n          entries: Array.isArray(entry?.entries)\n            ? entry.entries.map((item) => ({\n                key: normalizeUnknown(item?.key),\n                value: normalizeUnknown(item?.value),\n                ...(item?.highlight ? { highlight: true } : {}),\n              }))\n            : [],\n          ...(entry?.highlightedKey !== undefined\n            ? { highlightedKey: normalizeUnknown(entry.highlightedKey) }\n            : {}),\n          ...(entry?.deletedKey !== undefined\n            ? { deletedKey: normalizeUnknown(entry.deletedKey) }\n            : {}),\n        }))\n        .sort((a, b) => `${a.name}:${a.kind}`.localeCompare(`${b.name}:${b.kind}`))\n    : [];\n\n  const objectKinds =\n    payload?.objectKinds && typeof payload.objectKinds === 'object'\n      ? Object.fromEntries(\n          Object.entries(payload.objectKinds)\n            .filter(([name]) => typeof name === 'string' && name.length > 0)\n            .map(([name, kind]) => [name, normalizeObjectKind(kind)])\n            .filter((entry): entry is [string, RuntimeObjectKind] => entry[1] !== null)\n            .sort((a, b) => a[0].localeCompare(b[0]))\n        )\n      : undefined;\n\n  if (hashMaps.length === 0 && (!objectKinds || Object.keys(objectKinds).length === 0)) {\n    return undefined;\n  }\n\n  return {\n    ...(hashMaps.length > 0 ? { hashMaps } : {}),\n    ...(objectKinds && Object.keys(objectKinds).length > 0 ? { objectKinds } : {}),\n  };\n}\n\nfunction normalizeTraceStep(step: RawTraceStep): RuntimeTraceContractStep {\n  const normalizedStdoutCount = normalizeOutputLineCount(step?.stdoutLineCount);\n  const normalizedVisualization = normalizeVisualizationPayload(step?.visualization);\n  const normalizedAccesses = normalizeAccesses(step?.accesses);\n\n  return {\n    event: normalizeEvent(step?.event),\n    line: normalizeLineNumber(step?.line, 1),\n    function: normalizeFunctionName(step?.function),\n    variables: normalizeRecord(step?.variables),\n    ...(Array.isArray(step?.callStack) && step.callStack.length > 0\n      ? { callStack: step.callStack.map(normalizeCallStackFrame) }\n      : {}),\n    ...(normalizedAccesses ? { accesses: normalizedAccesses } : {}),\n    ...(step?.returnValue !== undefined ? { returnValue: normalizeUnknown(step.returnValue) } : {}),\n    ...(normalizedStdoutCount !== undefined ? { stdoutLineCount: normalizedStdoutCount } : {}),\n    ...(normalizedVisualization ? { visualization: normalizedVisualization } : {}),\n  };\n}\n\nexport function normalizeRuntimeTraceContract(\n  language: Language,\n  result: ExecutionResult\n): RuntimeTraceContractResult {\n  const normalizedTrace = Array.isArray(result.trace) ? result.trace.map(normalizeTraceStep) : [];\n  const lineEventCount =\n    typeof result.lineEventCount === 'number' && Number.isFinite(result.lineEventCount)\n      ? Math.floor(result.lineEventCount)\n      : normalizedTrace.filter((step) => step.event === 'line').length;\n\n  const normalizedConsole = Array.isArray(result.consoleOutput)\n    ? result.consoleOutput.map((line) => String(line))\n    : [];\n\n  return {\n    schemaVersion: RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION,\n    language,\n    success: Boolean(result.success),\n    ...(Object.prototype.hasOwnProperty.call(result, 'output')\n      ? { output: normalizeUnknown(result.output) }\n      : {}),\n    ...(typeof result.error === 'string' && result.error.length > 0\n      ? { error: result.error }\n      : {}),\n    ...(typeof result.errorLine === 'number' && Number.isFinite(result.errorLine)\n      ? { errorLine: Math.floor(result.errorLine) }\n      : {}),\n    consoleOutput: normalizedConsole,\n    trace: normalizedTrace,\n    ...(result.traceLimitExceeded !== undefined\n      ? { traceLimitExceeded: Boolean(result.traceLimitExceeded) }\n      : {}),\n    ...(typeof result.timeoutReason === 'string' && result.timeoutReason.length > 0\n      ? { timeoutReason: result.timeoutReason }\n      : {}),\n    lineEventCount: Math.max(0, lineEventCount),\n    traceStepCount: normalizedTrace.length,\n  };\n}\n\nexport function stableStringifyRuntimeTraceContract(value: unknown): string {\n  return JSON.stringify(normalizeUnknown(value), null, 2);\n}\n","import type { Language } from '../runtime-types';\nimport {\n  normalizeRuntimeTraceContract,\n  type RuntimeTraceContractCallStackFrame,\n  type RuntimeTraceContractStep,\n} from '../trace-contract';\nimport type {\n  CallStackFrame,\n  ExecutionResult,\n  RawTraceStep,\n  RuntimeVisualizationPayload,\n} from '../types';\n\nfunction denormalizeCallStackFrame(frame: RuntimeTraceContractCallStackFrame): CallStackFrame {\n  return {\n    function: frame.function,\n    line: frame.line,\n    args: frame.args,\n  };\n}\n\nfunction denormalizeTraceStep(step: RuntimeTraceContractStep): RawTraceStep {\n  return {\n    line: step.line,\n    event: step.event,\n    variables: step.variables,\n    function: step.function,\n    ...(step.callStack ? { callStack: step.callStack.map(denormalizeCallStackFrame) } : {}),\n    ...(step.accesses ? { accesses: step.accesses } : {}),\n    ...(step.returnValue !== undefined ? { returnValue: step.returnValue } : {}),\n    ...(step.stdoutLineCount !== undefined ? { stdoutLineCount: step.stdoutLineCount } : {}),\n    ...(step.visualization ? { visualization: step.visualization as RuntimeVisualizationPayload } : {}),\n  };\n}\n\nexport function adaptTraceExecutionResult(\n  language: Language,\n  result: ExecutionResult\n): ExecutionResult {\n  const normalized = normalizeRuntimeTraceContract(language, result);\n  const adaptedTrace: RawTraceStep[] = normalized.trace.map(denormalizeTraceStep);\n\n  return {\n    success: normalized.success,\n    ...(Object.prototype.hasOwnProperty.call(normalized, 'output') ? { output: normalized.output } : {}),\n    ...(normalized.error ? { error: normalized.error } : {}),\n    ...(normalized.errorLine !== undefined ? { errorLine: normalized.errorLine } : {}),\n    trace: adaptedTrace,\n    executionTimeMs:\n      typeof result.executionTimeMs === 'number' && Number.isFinite(result.executionTimeMs)\n        ? result.executionTimeMs\n        : 0,\n    consoleOutput: normalized.consoleOutput,\n    ...(normalized.traceLimitExceeded !== undefined ? { traceLimitExceeded: normalized.traceLimitExceeded } : {}),\n    ...(normalized.timeoutReason\n      ? { timeoutReason: normalized.timeoutReason as ExecutionResult['timeoutReason'] }\n      : {}),\n    lineEventCount: normalized.lineEventCount,\n    traceStepCount: adaptedTrace.length,\n  };\n}\n","import type { ExecutionResult } from '../types';\nimport { adaptTraceExecutionResult } from './shared';\n\nexport function adaptPythonTraceExecutionResult(result: ExecutionResult): ExecutionResult {\n  return adaptTraceExecutionResult('python', result);\n}\n","import type { Language } from '../runtime-types';\nimport type { ExecutionResult } from '../types';\nimport { adaptTraceExecutionResult } from './shared';\n\nexport function adaptJavaScriptTraceExecutionResult(\n  language: Extract<Language, 'javascript' | 'typescript'>,\n  result: ExecutionResult\n): ExecutionResult {\n  return adaptTraceExecutionResult(language, result);\n}\n"],"mappings":"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","names":[]}

package/dist/core.d.cts

@@ -0,0 +1,69 @@
+import { L as Language } from './runtime-types-Dvgn07z9.cjs';
+export { a as LanguageRuntimeProfile, R as RuntimeCapabilities, b as RuntimeClient, c as RuntimeExecutionStyle, d as RuntimeMaturity, T as TraceExecutionOptions } from './runtime-types-Dvgn07z9.cjs';
+import { g as RuntimeTraceAccessEvent, f as RuntimeObjectKind, E as ExecutionResult } from './types-Bzr1Ohcf.cjs';
+export { C as CallStackFrame, a as CodeExecutionResult, b as ExecutionStatus, P as ProcessedStep, c as PyodideState, R as RawTraceStep, d as RuntimeHashMapEntry, e as RuntimeHashMapVisualization, h as RuntimeTraceAccessKind, i as RuntimeVisualizationPayload, T as TestResult } from './types-Bzr1Ohcf.cjs';
+
+/**
+ * Runtime trace contract schema version.
+ *
+ * Bump this when payload shape/normalization semantics change in a way that
+ * should invalidate golden fixtures.
+ */
+declare const RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION = "2026-03-07";
+type RuntimeTraceContractEvent = 'line' | 'call' | 'return' | 'exception' | 'timeout' | 'stdout';
+interface RuntimeTraceContractHashMapEntry {
+    key: unknown;
+    value: unknown;
+    highlight?: boolean;
+}
+interface RuntimeTraceContractHashMap {
+    name: string;
+    kind: 'hashmap' | 'map' | 'set';
+    entries: RuntimeTraceContractHashMapEntry[];
+    highlightedKey?: unknown;
+    deletedKey?: unknown;
+}
+interface RuntimeTraceContractVisualization {
+    hashMaps?: RuntimeTraceContractHashMap[];
+    objectKinds?: Partial<Record<string, RuntimeObjectKind>>;
+}
+interface RuntimeTraceContractCallStackFrame {
+    function: string;
+    line: number;
+    args: Record<string, unknown>;
+}
+interface RuntimeTraceContractStep {
+    event: RuntimeTraceContractEvent;
+    line: number;
+    function: string;
+    variables: Record<string, unknown>;
+    callStack?: RuntimeTraceContractCallStackFrame[];
+    accesses?: RuntimeTraceAccessEvent[];
+    returnValue?: unknown;
+    stdoutLineCount?: number;
+    visualization?: RuntimeTraceContractVisualization;
+}
+interface RuntimeTraceContractResult {
+    schemaVersion: typeof RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION;
+    language: Language;
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    errorLine?: number;
+    consoleOutput: string[];
+    trace: RuntimeTraceContractStep[];
+    traceLimitExceeded?: boolean;
+    timeoutReason?: string;
+    lineEventCount: number;
+    traceStepCount: number;
+}
+declare function normalizeRuntimeTraceContract(language: Language, result: ExecutionResult): RuntimeTraceContractResult;
+declare function stableStringifyRuntimeTraceContract(value: unknown): string;
+
+declare function adaptTraceExecutionResult(language: Language, result: ExecutionResult): ExecutionResult;
+
+declare function adaptPythonTraceExecutionResult(result: ExecutionResult): ExecutionResult;
+
+declare function adaptJavaScriptTraceExecutionResult(language: Extract<Language, 'javascript' | 'typescript'>, result: ExecutionResult): ExecutionResult;
+
+export { ExecutionResult, Language, RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION, RuntimeObjectKind, RuntimeTraceAccessEvent, type RuntimeTraceContractCallStackFrame, type RuntimeTraceContractEvent, type RuntimeTraceContractHashMap, type RuntimeTraceContractHashMapEntry, type RuntimeTraceContractResult, type RuntimeTraceContractStep, type RuntimeTraceContractVisualization, adaptJavaScriptTraceExecutionResult, adaptPythonTraceExecutionResult, adaptTraceExecutionResult, normalizeRuntimeTraceContract, stableStringifyRuntimeTraceContract };

package/dist/core.d.ts

@@ -0,0 +1,69 @@
+import { L as Language } from './runtime-types-C7d1LFbx.js';
+export { a as LanguageRuntimeProfile, R as RuntimeCapabilities, b as RuntimeClient, c as RuntimeExecutionStyle, d as RuntimeMaturity, T as TraceExecutionOptions } from './runtime-types-C7d1LFbx.js';
+import { g as RuntimeTraceAccessEvent, f as RuntimeObjectKind, E as ExecutionResult } from './types-Bzr1Ohcf.js';
+export { C as CallStackFrame, a as CodeExecutionResult, b as ExecutionStatus, P as ProcessedStep, c as PyodideState, R as RawTraceStep, d as RuntimeHashMapEntry, e as RuntimeHashMapVisualization, h as RuntimeTraceAccessKind, i as RuntimeVisualizationPayload, T as TestResult } from './types-Bzr1Ohcf.js';
+
+/**
+ * Runtime trace contract schema version.
+ *
+ * Bump this when payload shape/normalization semantics change in a way that
+ * should invalidate golden fixtures.
+ */
+declare const RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION = "2026-03-07";
+type RuntimeTraceContractEvent = 'line' | 'call' | 'return' | 'exception' | 'timeout' | 'stdout';
+interface RuntimeTraceContractHashMapEntry {
+    key: unknown;
+    value: unknown;
+    highlight?: boolean;
+}
+interface RuntimeTraceContractHashMap {
+    name: string;
+    kind: 'hashmap' | 'map' | 'set';
+    entries: RuntimeTraceContractHashMapEntry[];
+    highlightedKey?: unknown;
+    deletedKey?: unknown;
+}
+interface RuntimeTraceContractVisualization {
+    hashMaps?: RuntimeTraceContractHashMap[];
+    objectKinds?: Partial<Record<string, RuntimeObjectKind>>;
+}
+interface RuntimeTraceContractCallStackFrame {
+    function: string;
+    line: number;
+    args: Record<string, unknown>;
+}
+interface RuntimeTraceContractStep {
+    event: RuntimeTraceContractEvent;
+    line: number;
+    function: string;
+    variables: Record<string, unknown>;
+    callStack?: RuntimeTraceContractCallStackFrame[];
+    accesses?: RuntimeTraceAccessEvent[];
+    returnValue?: unknown;
+    stdoutLineCount?: number;
+    visualization?: RuntimeTraceContractVisualization;
+}
+interface RuntimeTraceContractResult {
+    schemaVersion: typeof RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION;
+    language: Language;
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    errorLine?: number;
+    consoleOutput: string[];
+    trace: RuntimeTraceContractStep[];
+    traceLimitExceeded?: boolean;
+    timeoutReason?: string;
+    lineEventCount: number;
+    traceStepCount: number;
+}
+declare function normalizeRuntimeTraceContract(language: Language, result: ExecutionResult): RuntimeTraceContractResult;
+declare function stableStringifyRuntimeTraceContract(value: unknown): string;
+
+declare function adaptTraceExecutionResult(language: Language, result: ExecutionResult): ExecutionResult;
+
+declare function adaptPythonTraceExecutionResult(result: ExecutionResult): ExecutionResult;
+
+declare function adaptJavaScriptTraceExecutionResult(language: Extract<Language, 'javascript' | 'typescript'>, result: ExecutionResult): ExecutionResult;
+
+export { ExecutionResult, Language, RUNTIME_TRACE_CONTRACT_SCHEMA_VERSION, RuntimeObjectKind, RuntimeTraceAccessEvent, type RuntimeTraceContractCallStackFrame, type RuntimeTraceContractEvent, type RuntimeTraceContractHashMap, type RuntimeTraceContractHashMapEntry, type RuntimeTraceContractResult, type RuntimeTraceContractStep, type RuntimeTraceContractVisualization, adaptJavaScriptTraceExecutionResult, adaptPythonTraceExecutionResult, adaptTraceExecutionResult, normalizeRuntimeTraceContract, stableStringifyRuntimeTraceContract };