@tracecode/harness 0.6.5 → 0.7.0-beta7

package/dist/cpp.cjs

@@ -0,0 +1,1063 @@
+"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-cpp/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  CppWorkerClient: () => CppWorkerClient,
+  createCppRuntimeClient: () => createCppRuntimeClient
+});
+module.exports = __toCommonJS(src_exports);
+
+// packages/harness-browser/src/runtime-capability-guards.ts
+function isScriptRequest(functionName) {
+  if (functionName == null) return true;
+  return functionName.trim().length === 0;
+}
+function executionStyleLabel(executionStyle) {
+  if (executionStyle === "solution-method") return "solution-method";
+  if (executionStyle === "ops-class") return "ops-class";
+  return "function";
+}
+function isExecutionStyleSupported(profile, executionStyle) {
+  const styles = profile.capabilities.execution.styles;
+  if (executionStyle === "solution-method") return styles.solutionMethod;
+  if (executionStyle === "ops-class") return styles.opsClass;
+  return styles.function;
+}
+function describeRequest(request) {
+  if (request === "trace") return "tracing";
+  if (request === "interview") return "interview execution";
+  return "execution";
+}
+function assertRuntimeRequestSupported(profile, options) {
+  if (options.request === "trace" && !profile.capabilities.tracing.supported) {
+    throw new Error(`Runtime "${profile.language}" does not support tracing.`);
+  }
+  if (options.request === "interview" && !profile.capabilities.execution.styles.interviewMode) {
+    throw new Error(`Runtime "${profile.language}" does not support interview execution.`);
+  }
+  if (!isExecutionStyleSupported(profile, options.executionStyle)) {
+    throw new Error(
+      `Runtime "${profile.language}" does not support execution style "${executionStyleLabel(options.executionStyle)}".`
+    );
+  }
+  if (isScriptRequest(options.functionName) && !profile.capabilities.execution.styles.script) {
+    throw new Error(`Runtime "${profile.language}" does not support script mode ${describeRequest(options.request)}.`);
+  }
+}
+
+// packages/harness-browser/src/runtime-profiles.ts
+var PYTHON_RUNTIME_PROFILE = {
+  language: "python",
+  maturity: "stable",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: true
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: true,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: true,
+        maxSingleLineHits: true,
+        maxStoredEvents: true,
+        minimalTrace: true
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: false,
+      runtimeErrors: true,
+      mappedErrorLines: true,
+      stackTraces: false
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: true,
+      cycleReferences: true
+    }
+  }
+};
+var JAVASCRIPT_RUNTIME_PROFILE = {
+  language: "javascript",
+  maturity: "stable",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: false
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: false,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: true,
+        maxSingleLineHits: true,
+        maxStoredEvents: true,
+        minimalTrace: true
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: false,
+      runtimeErrors: true,
+      mappedErrorLines: false,
+      stackTraces: false
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: true,
+      cycleReferences: true
+    }
+  }
+};
+var TYPESCRIPT_RUNTIME_PROFILE = {
+  language: "typescript",
+  maturity: "stable",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: false
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: false,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: true,
+        maxSingleLineHits: true,
+        maxStoredEvents: true,
+        minimalTrace: true
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: true,
+      runtimeErrors: true,
+      mappedErrorLines: true,
+      stackTraces: false
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: true,
+      cycleReferences: true
+    }
+  }
+};
+var JAVA_RUNTIME_PROFILE = {
+  language: "java",
+  maturity: "experimental",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: true
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: false,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: false,
+        maxSingleLineHits: false,
+        maxStoredEvents: true,
+        minimalTrace: false
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: true,
+      runtimeErrors: true,
+      mappedErrorLines: false,
+      stackTraces: true
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: false,
+      cycleReferences: true
+    }
+  },
+  notes: [
+    "Java currently supports the browser-local Java 17 lane for function, solution-method, ops-class, and script-style execution.",
+    "Interview-mode Java reuses the same browser-local execution path and remains experimental.",
+    'Script-style Java uses an empty function name with executionStyle="function" and reads the top-level result variable.'
+  ]
+};
+var CSHARP_RUNTIME_PROFILE = {
+  language: "csharp",
+  maturity: "experimental",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: true
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: true,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: true,
+        maxSingleLineHits: true,
+        maxStoredEvents: true,
+        minimalTrace: true
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: true,
+      runtimeErrors: true,
+      mappedErrorLines: true,
+      stackTraces: false
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: true,
+      cycleReferences: true
+    }
+  },
+  notes: [
+    "C# support is browser-local and experimental.",
+    "C# supports named function-style requests where the browser-local host can bind the named method.",
+    'Script-style C# uses an empty function name with executionStyle="function" and reads the top-level result variable.',
+    "Interview-mode C# uses the same browser-local worker execution path with interview timeout normalization.",
+    "The first C# slice supports public class Solution methods.",
+    "ListNode and TreeNode inputs are hydrated from level-order arrays or object-shaped JSON.",
+    "Dictionary, HashSet, List, and array return values serialize through the browser-local worker.",
+    "Tracing currently supports line, call, return, stdout, and simple local variable write events.",
+    "Structural visualization is added after execution and diagnostics are proven."
+  ]
+};
+var CPP_RUNTIME_PROFILE = {
+  language: "cpp",
+  maturity: "experimental",
+  capabilities: {
+    execution: {
+      styles: {
+        function: true,
+        solutionMethod: true,
+        opsClass: true,
+        script: true,
+        interviewMode: true
+      },
+      timeouts: {
+        clientTimeouts: true,
+        runtimeTimeouts: true
+      }
+    },
+    tracing: {
+      supported: true,
+      events: {
+        line: true,
+        call: true,
+        return: true,
+        exception: true,
+        stdout: true,
+        timeout: true
+      },
+      controls: {
+        maxTraceSteps: true,
+        maxLineEvents: true,
+        maxSingleLineHits: true,
+        maxStoredEvents: true,
+        minimalTrace: true
+      },
+      fidelity: {
+        preciseLineMapping: true,
+        stableFunctionNames: true,
+        callStack: true
+      }
+    },
+    diagnostics: {
+      compileErrors: true,
+      runtimeErrors: true,
+      mappedErrorLines: true,
+      stackTraces: false
+    },
+    structures: {
+      treeNodeRefs: true,
+      listNodeRefs: true,
+      mapSerialization: true,
+      setSerialization: true,
+      graphSerialization: true,
+      cycleReferences: true
+    }
+  },
+  notes: [
+    "C++ uses a focused browser-local Clang/LLD/WASI compiler lane with TraceCode-owned execution glue.",
+    "The runtime intentionally does not depend on a generic multi-language container/runtime SDK.",
+    'Script-style C++ uses an empty function name with executionStyle="function"; the snippet must assign a serializable result variable.',
+    "Interview-mode C++ reuses the tracing compiler path with a trace budget and returns a non-trace execution result."
+  ]
+};
+var LANGUAGE_RUNTIME_PROFILES = {
+  python: PYTHON_RUNTIME_PROFILE,
+  javascript: JAVASCRIPT_RUNTIME_PROFILE,
+  typescript: TYPESCRIPT_RUNTIME_PROFILE,
+  java: JAVA_RUNTIME_PROFILE,
+  csharp: CSHARP_RUNTIME_PROFILE,
+  cpp: CPP_RUNTIME_PROFILE
+};
+var SUPPORTED_LANGUAGES = Object.freeze(
+  Object.keys(LANGUAGE_RUNTIME_PROFILES)
+);
+function getLanguageRuntimeProfile(language) {
+  const profile = LANGUAGE_RUNTIME_PROFILES[language];
+  if (!profile) {
+    throw new Error(`Runtime profile for language "${language}" is not implemented yet.`);
+  }
+  return profile;
+}
+
+// packages/harness-browser/src/cpp-runtime-client.ts
+var CppRuntimeClient = class {
+  constructor(workerClient) {
+    this.workerClient = workerClient;
+  }
+  async init() {
+    return this.workerClient.init();
+  }
+  async executeWithTracing(code, functionName, inputs, options, executionStyle = "solution-method") {
+    assertRuntimeRequestSupported(getLanguageRuntimeProfile("cpp"), {
+      request: "trace",
+      executionStyle,
+      functionName
+    });
+    return this.workerClient.executeWithTracing(
+      code,
+      functionName ?? "",
+      inputs,
+      options,
+      executionStyle
+    );
+  }
+  async executeCode(code, functionName, inputs, executionStyle = "solution-method") {
+    assertRuntimeRequestSupported(getLanguageRuntimeProfile("cpp"), {
+      request: "execute",
+      executionStyle,
+      functionName
+    });
+    return this.workerClient.executeCode(
+      code,
+      functionName,
+      inputs,
+      executionStyle
+    );
+  }
+  async executeCodeInterviewMode(code, functionName, inputs, executionStyle = "solution-method") {
+    assertRuntimeRequestSupported(getLanguageRuntimeProfile("cpp"), {
+      request: "interview",
+      executionStyle,
+      functionName
+    });
+    return this.workerClient.executeCodeInterviewMode(
+      code,
+      functionName,
+      inputs,
+      executionStyle
+    );
+  }
+};
+function createCppRuntimeClient(workerClient) {
+  return new CppRuntimeClient(workerClient);
+}
+
+// packages/harness-core/src/runtime-trace.ts
+var RUNTIME_TRACE_SCHEMA_VERSION = "runtime-trace-2026-04-28";
+function createEmptyRuntimeTrace(language, options = {}) {
+  return {
+    schemaVersion: RUNTIME_TRACE_SCHEMA_VERSION,
+    language,
+    runId: options.runId ?? `${language}:run`,
+    events: [],
+    lineEventCount: 0,
+    traceStepCount: 0
+  };
+}
+
+// packages/harness-browser/src/runtime-diagnostics.ts
+var CONSOLE_METHOD_BY_LEVEL = {
+  debug: "debug",
+  info: "info",
+  warn: "warn",
+  error: "error"
+};
+function runtimeDiagnosticEvent(params) {
+  return {
+    schema: "tracecode.runtime-diagnostic.v1",
+    source: "harness",
+    ...params
+  };
+}
+function logRuntimeDiagnostic(level, params, options = {}) {
+  if (options.enabled === false && level !== "error") {
+    return;
+  }
+  const method = CONSOLE_METHOD_BY_LEVEL[level] ?? "info";
+  console[method]("[TraceRuntime]", runtimeDiagnosticEvent(params));
+}
+
+// packages/harness-browser/src/cpp-worker-client.ts
+var CppClientTimeoutError = class extends Error {
+  constructor(message, stage, timeoutMs) {
+    super(message);
+    this.stage = stage;
+    this.timeoutMs = timeoutMs;
+    this.name = "CppClientTimeoutError";
+  }
+};
+var INIT_TIMEOUT_MS = 12e4;
+var EXECUTION_TIMEOUT_MS = 6e4;
+var TRACING_TIMEOUT_MS = 6e4;
+var INTERVIEW_MODE_TIMEOUT_MS = 3e4;
+var MESSAGE_TIMEOUT_MS = 3e4;
+var WORKER_READY_TIMEOUT_MS = 1e4;
+var CPP_DEFAULT_FILE = "solution.cpp";
+var CppWorkerClient = class {
+  constructor(options) {
+    this.options = options;
+    this.debug = options.debug ?? process.env.NODE_ENV === "development";
+    this.initTimeoutMs = options.initTimeoutMs ?? INIT_TIMEOUT_MS;
+    this.executionTimeoutMs = options.executionTimeoutMs ?? EXECUTION_TIMEOUT_MS;
+    this.tracingTimeoutMs = options.tracingTimeoutMs ?? TRACING_TIMEOUT_MS;
+    this.interviewTimeoutMs = options.interviewTimeoutMs ?? INTERVIEW_MODE_TIMEOUT_MS;
+    this.compilerFrameUrl = options.compilerFrameUrl;
+  }
+  worker = null;
+  pendingMessages = /* @__PURE__ */ new Map();
+  messageId = 0;
+  initPromise = null;
+  warmupPromise = null;
+  workerReadyPromise = null;
+  workerReadyResolve = null;
+  workerReadyReject = null;
+  debug;
+  initTimeoutMs;
+  executionTimeoutMs;
+  tracingTimeoutMs;
+  interviewTimeoutMs;
+  compilerFrameUrl;
+  activeCompilerFrames = /* @__PURE__ */ new Set();
+  compilerFrame = null;
+  compilerFrameReadyPromise = null;
+  compilerFrameReadyResolve = null;
+  compilerFrameReadyReject = null;
+  compilerFrameTargetOrigin = "";
+  compilerFrameRequestId = 0;
+  compilerFrameMessageHandler = null;
+  pendingCompilerFrameRequests = /* @__PURE__ */ new Map();
+  isSupported() {
+    return typeof Worker !== "undefined";
+  }
+  getWorker() {
+    if (this.worker) return this.worker;
+    if (!this.isSupported()) {
+      throw new Error("Web Workers are not supported in this environment");
+    }
+    this.workerReadyPromise = new Promise((resolve, reject) => {
+      this.workerReadyResolve = resolve;
+      this.workerReadyReject = (error) => reject(error);
+    });
+    const workerUrl = this.debug && !this.options.workerUrl.includes("?") ? `${this.options.workerUrl}?dev=${Date.now()}` : this.options.workerUrl;
+    this.worker = new Worker(workerUrl, { type: "module" });
+    this.worker.onmessage = (event) => {
+      const { id, type, payload } = event.data;
+      if (type === "worker-ready") {
+        this.workerReadyResolve?.();
+        this.workerReadyResolve = null;
+        this.workerReadyReject = null;
+        logRuntimeDiagnostic("info", {
+          component: "CppWorkerClient",
+          runtime: "cpp",
+          phase: "worker-ready",
+          message: "C++ worker is ready."
+        }, { enabled: this.debug });
+        return;
+      }
+      if (type === "idle-timeout") {
+        logRuntimeDiagnostic("info", {
+          component: "CppWorkerClient",
+          runtime: "cpp",
+          phase: "idle-timeout",
+          message: "C++ worker closed after idle timeout."
+        }, { enabled: this.debug });
+        this.terminateAndReset(new Error("C++ worker closed after idle timeout"));
+        return;
+      }
+      if (type === "compile-request") {
+        this.handleCompileRequest(event.data).catch((error) => {
+          if (!event.data.requestId) return;
+          this.worker?.postMessage({
+            type: "compile-response",
+            requestId: event.data.requestId,
+            payload: { success: false, error: error instanceof Error ? error.message : String(error) }
+          });
+        });
+        return;
+      }
+      if (!id) return;
+      const pending = this.pendingMessages.get(id);
+      if (!pending) return;
+      this.pendingMessages.delete(id);
+      if (pending.timeoutId) globalThis.clearTimeout(pending.timeoutId);
+      if (type === "error") {
+        pending.reject(new Error(payload.error));
+        return;
+      }
+      pending.resolve(payload);
+    };
+    this.worker.onerror = (error) => {
+      logRuntimeDiagnostic("error", {
+        component: "CppWorkerClient",
+        runtime: "cpp",
+        phase: "worker-error",
+        message: "C++ worker emitted an error event.",
+        detail: {
+          message: error.message,
+          filename: error.filename,
+          lineno: error.lineno,
+          colno: error.colno
+        }
+      });
+      const workerError = new Error(error.message || "C++ worker error");
+      this.workerReadyReject?.(workerError);
+      this.workerReadyResolve = null;
+      this.workerReadyReject = null;
+      this.terminateAndReset(workerError);
+    };
+    return this.worker;
+  }
+  async waitForWorkerReady() {
+    const readyPromise = this.workerReadyPromise;
+    if (!readyPromise) return;
+    await new Promise((resolve, reject) => {
+      let settled = false;
+      const timeoutId = globalThis.setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        const timeoutError = new Error(
+          `C++ worker failed to initialize in time (${Math.round(WORKER_READY_TIMEOUT_MS / 1e3)}s)`
+        );
+        logRuntimeDiagnostic("warn", {
+          component: "CppWorkerClient",
+          runtime: "cpp",
+          phase: "worker-ready-timeout",
+          message: "C++ worker did not send worker-ready before the timeout.",
+          detail: { timeoutMs: WORKER_READY_TIMEOUT_MS }
+        }, { enabled: this.debug });
+        this.terminateAndReset(timeoutError);
+        reject(timeoutError);
+      }, WORKER_READY_TIMEOUT_MS);
+      readyPromise.then(() => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        resolve();
+      }).catch((error) => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        reject(error instanceof Error ? error : new Error(String(error)));
+      });
+    });
+  }
+  async sendMessage(type, payload, timeoutMs = MESSAGE_TIMEOUT_MS) {
+    const worker = this.getWorker();
+    await this.waitForWorkerReady();
+    const id = String(++this.messageId);
+    return new Promise((resolve, reject) => {
+      this.pendingMessages.set(id, {
+        resolve,
+        reject
+      });
+      const timeoutId = globalThis.setTimeout(() => {
+        const pending2 = this.pendingMessages.get(id);
+        if (!pending2) return;
+        this.pendingMessages.delete(id);
+        logRuntimeDiagnostic("warn", {
+          component: "CppWorkerClient",
+          runtime: "cpp",
+          phase: "worker-request-timeout",
+          message: "C++ worker request timed out.",
+          detail: { id, type, timeoutMs }
+        }, { enabled: this.debug });
+        pending2.reject(new Error(`Worker request timed out: ${type}`));
+      }, timeoutMs);
+      const pending = this.pendingMessages.get(id);
+      if (pending) pending.timeoutId = timeoutId;
+      worker.postMessage({ id, type, payload });
+    });
+  }
+  async executeWithTimeout(executor, timeoutMs, stage) {
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const timeoutId = globalThis.setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        const timeoutLabel = stage === "trace" ? "tracing" : stage === "interview" ? "interview execution" : "compile/run";
+        const timeoutError = new CppClientTimeoutError(
+          `C++ ${timeoutLabel} timed out after ${Math.round(timeoutMs / 1e3)} seconds.`,
+          stage,
+          timeoutMs
+        );
+        logRuntimeDiagnostic("warn", {
+          component: "CppWorkerClient",
+          runtime: "cpp",
+          phase: "execution-timeout",
+          message: "C++ execution timed out; terminating worker.",
+          detail: { timeoutMs, stage }
+        }, { enabled: this.debug });
+        this.terminateAndReset(timeoutError);
+        reject(timeoutError);
+      }, timeoutMs);
+      executor().then((result) => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        resolve(result);
+      }).catch((error) => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        reject(error);
+      });
+    });
+  }
+  isClientTimeout(error) {
+    return error instanceof CppClientTimeoutError || error instanceof Error && error.message.includes("C++") && error.message.includes("timed out");
+  }
+  timeoutCodeResult(error) {
+    const timeoutError = error instanceof CppClientTimeoutError ? error : null;
+    return {
+      success: false,
+      output: null,
+      error: error instanceof Error ? error.message : String(error),
+      consoleOutput: [],
+      timeoutReason: "client-timeout",
+      diagnosticStage: timeoutError?.stage === "interview" ? "interview" : "runtime",
+      timings: { totalMs: timeoutError?.timeoutMs ?? this.executionTimeoutMs }
+    };
+  }
+  timeoutTraceResult(error) {
+    const timeoutError = error instanceof CppClientTimeoutError ? error : null;
+    const trace = createEmptyRuntimeTrace("cpp", { runId: "cpp:run", file: CPP_DEFAULT_FILE });
+    trace.events = [
+      {
+        kind: "timeout",
+        runId: "cpp:run",
+        file: CPP_DEFAULT_FILE,
+        message: error instanceof Error ? error.message : String(error)
+      }
+    ];
+    trace.traceStepCount = 1;
+    return {
+      success: false,
+      output: null,
+      error: error instanceof Error ? error.message : String(error),
+      trace,
+      executionTimeMs: timeoutError?.timeoutMs ?? this.tracingTimeoutMs,
+      consoleOutput: [],
+      traceLimitExceeded: true,
+      timeoutReason: "client-timeout",
+      lineEventCount: 0,
+      traceStepCount: 1,
+      timings: { totalMs: timeoutError?.timeoutMs ?? this.tracingTimeoutMs }
+    };
+  }
+  terminateAndReset(reason = new Error("Worker was terminated")) {
+    this.workerReadyReject?.(reason);
+    if (this.worker) {
+      this.worker.terminate();
+      this.worker = null;
+    }
+    this.initPromise = null;
+    this.warmupPromise = null;
+    this.workerReadyPromise = null;
+    this.workerReadyResolve = null;
+    this.workerReadyReject = null;
+    for (const [, pending] of this.pendingMessages) {
+      if (pending.timeoutId) globalThis.clearTimeout(pending.timeoutId);
+      pending.reject(reason);
+    }
+    this.pendingMessages.clear();
+    this.clearCompilerFrames();
+  }
+  shouldRetryInit(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes("timed out") || message.includes("Worker request timed out") || message.includes("worker error") || message.includes("Failed to fetch") || message.includes("was terminated") || message.includes("closed after idle timeout");
+  }
+  sendInitMessage() {
+    return this.sendMessage(
+      "init",
+      {
+        assets: {
+          clangWasmUrl: this.options.clangWasmUrl,
+          lldWasmUrl: this.options.lldWasmUrl,
+          sysrootUrl: this.options.sysrootUrl,
+          runtimeHeaderUrl: this.options.runtimeHeaderUrl,
+          compilerBundleUrl: this.options.compilerBundleUrl,
+          compilerFrameEnabled: Boolean(this.compilerFrameUrl && typeof document !== "undefined"),
+          compilerFrameUrl: this.compilerFrameUrl,
+          compilerWorkerUrl: this.options.compilerWorkerUrl
+        },
+        ...this.workerOptionsPayload()
+      },
+      this.initTimeoutMs
+    );
+  }
+  async init() {
+    if (this.initPromise) return this.initPromise;
+    this.initPromise = (async () => {
+      try {
+        return await this.sendInitMessage();
+      } catch (error) {
+        if (!this.shouldRetryInit(error)) throw error;
+        this.terminateAndReset(error instanceof Error ? error : new Error(String(error)));
+        return this.sendInitMessage();
+      }
+    })();
+    try {
+      return await this.initPromise;
+    } catch (error) {
+      this.initPromise = null;
+      throw error;
+    }
+  }
+  workerOptionsPayload() {
+    return this.options.workerIdleTimeoutMs === void 0 ? {} : { idleTimeoutMs: this.options.workerIdleTimeoutMs };
+  }
+  async warmup() {
+    if (this.warmupPromise) return this.warmupPromise;
+    this.warmupPromise = (async () => {
+      try {
+        await this.init();
+        return await this.sendMessage("warmup", this.workerOptionsPayload(), this.initTimeoutMs);
+      } catch (error) {
+        this.warmupPromise = null;
+        throw error;
+      }
+    })();
+    return this.warmupPromise;
+  }
+  clearCompilerFrames(reason = new Error("C++ compiler frame was closed")) {
+    this.compilerFrameReadyReject?.(reason);
+    this.compilerFrameReadyPromise = null;
+    this.compilerFrameReadyResolve = null;
+    this.compilerFrameReadyReject = null;
+    if (this.compilerFrameMessageHandler) {
+      globalThis.removeEventListener("message", this.compilerFrameMessageHandler);
+      this.compilerFrameMessageHandler = null;
+    }
+    for (const [, pending] of this.pendingCompilerFrameRequests) {
+      globalThis.clearTimeout(pending.timeoutId);
+      pending.resolve({ success: false, error: reason.message });
+    }
+    this.pendingCompilerFrameRequests.clear();
+    this.compilerFrame = null;
+    this.compilerFrameTargetOrigin = "";
+    for (const frame of this.activeCompilerFrames) {
+      frame.remove();
+    }
+    this.activeCompilerFrames.clear();
+  }
+  async handleCompileRequest(message) {
+    if (!message.requestId) return;
+    const worker = this.worker;
+    if (!worker) return;
+    const result = await this.compileInFrame(message.payload);
+    const transfer = result?.programBuffer instanceof ArrayBuffer ? [result.programBuffer] : [];
+    worker.postMessage(
+      {
+        type: "compile-response",
+        requestId: message.requestId,
+        payload: result
+      },
+      transfer
+    );
+  }
+  ensureCompilerFrame() {
+    if (!this.compilerFrameUrl || typeof document === "undefined") {
+      return Promise.reject(new Error("C++ compiler frame is not available."));
+    }
+    if (this.compilerFrame && this.compilerFrameReadyPromise) return this.compilerFrameReadyPromise;
+    const frameUrl = new URL(this.compilerFrameUrl, globalThis.location?.href);
+    this.compilerFrameTargetOrigin = frameUrl.origin;
+    const iframe = document.createElement("iframe");
+    iframe.src = frameUrl.href;
+    iframe.style.display = "none";
+    iframe.setAttribute("aria-hidden", "true");
+    this.compilerFrame = iframe;
+    this.activeCompilerFrames.add(iframe);
+    this.compilerFrameReadyPromise = new Promise((resolve, reject) => {
+      let settled = false;
+      let timeoutId;
+      const finishReady = () => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        this.compilerFrameReadyResolve = null;
+        this.compilerFrameReadyReject = null;
+        resolve();
+      };
+      const onMessage = (event) => {
+        if (event.source !== iframe.contentWindow) return;
+        if (event.origin !== this.compilerFrameTargetOrigin) return;
+        if (event.data?.type === "frame-ready") {
+          finishReady();
+          return;
+        }
+        const requestId = event.data?.id;
+        if (!requestId) return;
+        const pending = this.pendingCompilerFrameRequests.get(requestId);
+        if (!pending) return;
+        this.pendingCompilerFrameRequests.delete(requestId);
+        globalThis.clearTimeout(pending.timeoutId);
+        const response = event.data;
+        pending.resolve(response.payload ?? { success: false, error: "C++ compiler frame returned an empty response." });
+      };
+      this.compilerFrameMessageHandler = onMessage;
+      timeoutId = globalThis.setTimeout(() => {
+        const error = new Error("C++ compiler frame request timed out.");
+        this.clearCompilerFrames(error);
+        reject(error);
+      }, this.initTimeoutMs);
+      this.compilerFrameReadyResolve = finishReady;
+      this.compilerFrameReadyReject = (error) => {
+        if (settled) return;
+        settled = true;
+        globalThis.clearTimeout(timeoutId);
+        reject(error);
+      };
+      globalThis.addEventListener("message", onMessage);
+      document.body.appendChild(iframe);
+    });
+    return this.compilerFrameReadyPromise;
+  }
+  async compileInFrame(payload) {
+    try {
+      await this.ensureCompilerFrame();
+    } catch (error) {
+      return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    const iframe = this.compilerFrame;
+    const frameWindow = iframe?.contentWindow;
+    if (!frameWindow) {
+      return { success: false, error: "C++ compiler frame is not available." };
+    }
+    return new Promise((resolve) => {
+      const requestId = `compile-${++this.compilerFrameRequestId}`;
+      const timeoutId = globalThis.setTimeout(() => {
+        this.pendingCompilerFrameRequests.delete(requestId);
+        resolve({ success: false, error: "C++ compiler frame request timed out." });
+      }, this.initTimeoutMs);
+      this.pendingCompilerFrameRequests.set(requestId, { resolve, timeoutId });
+      frameWindow.postMessage(
+        {
+          id: requestId,
+          type: "compile",
+          payload
+        },
+        this.compilerFrameTargetOrigin
+      );
+    });
+  }
+  async executeCode(code, functionName, inputs, executionStyle) {
+    await this.init();
+    try {
+      return await this.executeWithTimeout(
+        () => this.sendMessage(
+          "compile-run",
+          { code, functionName, inputs, executionStyle },
+          this.executionTimeoutMs + 5e3
+        ),
+        this.executionTimeoutMs,
+        "compile-run"
+      );
+    } catch (error) {
+      if (this.isClientTimeout(error)) return this.timeoutCodeResult(error);
+      throw error;
+    }
+  }
+  async executeWithTracing(code, functionName, inputs, options, executionStyle) {
+    await this.init();
+    try {
+      return await this.executeWithTimeout(
+        () => this.sendMessage(
+          "execute-with-tracing",
+          { code, functionName, inputs, options, executionStyle },
+          this.tracingTimeoutMs + 5e3
+        ),
+        this.tracingTimeoutMs,
+        "trace"
+      );
+    } catch (error) {
+      if (this.isClientTimeout(error)) return this.timeoutTraceResult(error);
+      throw error;
+    }
+  }
+  async executeCodeInterviewMode(code, functionName, inputs, executionStyle) {
+    await this.init();
+    try {
+      return await this.executeWithTimeout(
+        () => this.sendMessage(
+          "execute-code-interview",
+          { code, functionName, inputs, executionStyle },
+          this.interviewTimeoutMs + 5e3
+        ),
+        this.interviewTimeoutMs,
+        "interview"
+      );
+    } catch {
+      return {
+        success: false,
+        output: null,
+        error: "Time Limit Exceeded",
+        timeoutReason: "client-timeout",
+        diagnosticStage: "interview",
+        consoleOutput: [],
+        timings: { totalMs: this.interviewTimeoutMs }
+      };
+    }
+  }
+  terminate() {
+    this.terminateAndReset();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CppWorkerClient,
+  createCppRuntimeClient
+});
+//# sourceMappingURL=cpp.cjs.map