@tracecode/harness 0.16.4 → 0.16.6

package/dist/judge.d.cts

@@ -873,6 +873,8 @@ interface BrowserJudgePythonOptions {
 interface BrowserJudgeJavaOptions {
     readonly workerIdleTimeoutMs?: number;
     readonly compileCacheLimit?: number;
+    /** Same-origin trusted Java compiler endpoint. */
+    readonly externalCompilerUrl?: string;
     /** Immutable TraceJVM asset tree used by the Java worker. */
     readonly runtimeAssetBaseUrl?: string;
 }
@@ -945,6 +947,10 @@ interface BrowserJudgeHost {
     isLanguageSupported(language: Language): boolean;
     preflightLanguage(language: Language): Promise<BrowserRuntimeReadiness>;
     preflight(): Promise<BrowserRuntimeEnvironmentReport>;
+    prewarmLanguage(language: Language): Promise<{
+        success: boolean;
+        loadTimeMs: number;
+    }>;
     warmLanguage(language: Language): Promise<{
         success: boolean;
         loadTimeMs: number;

package/dist/judge.d.ts

@@ -873,6 +873,8 @@ interface BrowserJudgePythonOptions {
 interface BrowserJudgeJavaOptions {
     readonly workerIdleTimeoutMs?: number;
     readonly compileCacheLimit?: number;
+    /** Same-origin trusted Java compiler endpoint. */
+    readonly externalCompilerUrl?: string;
     /** Immutable TraceJVM asset tree used by the Java worker. */
     readonly runtimeAssetBaseUrl?: string;
 }
@@ -945,6 +947,10 @@ interface BrowserJudgeHost {
     isLanguageSupported(language: Language): boolean;
     preflightLanguage(language: Language): Promise<BrowserRuntimeReadiness>;
     preflight(): Promise<BrowserRuntimeEnvironmentReport>;
+    prewarmLanguage(language: Language): Promise<{
+        success: boolean;
+        loadTimeMs: number;
+    }>;
     warmLanguage(language: Language): Promise<{
         success: boolean;
         loadTimeMs: number;

package/dist/judge.js

@@ -1,8 +1,8 @@
 var define = undefined;
 import {
   createCppBrowserRuntimeProvider
-} from "./chunk-RCOPAMVR.js";
-import "./chunk-AAKNIYV6.js";
+} from "./chunk-J2KGF5PU.js";
+import "./chunk-46XZQOHV.js";
 import {
   normalizeTraceJVMRuntimeAssetBaseUrl,
   preflightBuiltInTraceJVMRuntimeAssets,
@@ -10,20 +10,20 @@ import {
 } from "./chunk-FYDQ4ZKL.js";
 import {
   CSharpWorkerClient
-} from "./chunk-6LE4KEMZ.js";
+} from "./chunk-4PN5YD6J.js";
 import {
   PYTHON_RUNTIME_IMAGE_PROTOCOL_VERSION,
   createBrowserProjectWorkspace,
   createBrowserRuntimeAssetPreflight,
   createBrowserRuntimeEnvironment,
   makeTraceKernelHost
-} from "./chunk-5RT5IT4I.js";
+} from "./chunk-B2EM2SZ2.js";
 import {
   resolveBuiltInTraceCCRuntimeManifest
 } from "./chunk-EJE2EJDI.js";
 import {
   PythonWorkerClient
-} from "./chunk-M7SNEZDR.js";
+} from "./chunk-EPBHRROK.js";
 import {
   RUNTIME_TRACE_SCHEMA_VERSION,
   createEmptyRuntimeTrace,
@@ -32,7 +32,7 @@ import {
   liftCodeOutcome,
   liftTraceOutcome,
   runtimeWorkspaceActorPreset
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import {
   TraceKernelControlledRuntime,
   TraceKernelSharedSyscallServer,
@@ -55,6 +55,8 @@ import {
   batchCodeResultToExecuteResult,
   closeKernelHttpSyncServers,
   createBrowserExecutionWorkerHost,
+  createPromotableBrowserBackgroundTask,
+  createWorkerProtocolToken,
   executeRuntimeRequest,
   getLanguageRuntimeProfile,
   handleHostArtifactCacheRequest,
@@ -67,7 +69,7 @@ import {
   logRuntimeDiagnostic,
   restoreTransferredTraceEvents,
   traceEventTransferRequest
-} from "./chunk-DTLDQQHA.js";
+} from "./chunk-5KH5ABPQ.js";
 import {
   TaggedError,
   _void,
@@ -795,6 +797,8 @@ var BrowserRuntimeHostImplementation = class {
   environment;
   supportedLanguages;
   #preparedProviders = /* @__PURE__ */ new Map();
+  #providerInitializers = /* @__PURE__ */ new Map();
+  #warmEntries = /* @__PURE__ */ new Map();
   #leases = [];
   #leaseByLanguage = /* @__PURE__ */ new Map();
   #readinessByLanguage = /* @__PURE__ */ new Map();
@@ -836,16 +840,25 @@ var BrowserRuntimeHostImplementation = class {
             language,
             preparedProvider
           );
+          const safeProvider = safePreparedProvider(
+            language,
+            preparedProvider,
+            () => this.#assertActive(),
+            () => this.#ensureLanguageReady(language)
+          );
+          this.#providerInitializers.set(
+            language,
+            () => safeProvider.init()
+          );
           this.#preparedProviders.set(
             language,
-            withPreparedProgramReuse(
-              safePreparedProvider(
-                language,
-                preparedProvider,
-                () => this.#assertActive(),
-                () => this.#ensureLanguageReady(language)
-              )
-            )
+            withPreparedProgramReuse({
+              init: () => this.#promoteLanguageWarm(language),
+              prepareProgram: async (call) => {
+                await this.#promoteLanguageWarm(language);
+                return safeProvider.prepareProgram(call);
+              }
+            })
           );
           this.#leaseByLanguage.set(language, lease);
         }
@@ -892,6 +905,41 @@ var BrowserRuntimeHostImplementation = class {
       throw new Error("Browser runtime host has been disposed.");
     }
   }
+  #warmEntry(language) {
+    const existing = this.#warmEntries.get(language);
+    if (existing) return existing;
+    const initialize = this.#providerInitializers.get(language);
+    if (!initialize) {
+      throw new Error(
+        `Prepared runtime for language "${language}" is not registered.`
+      );
+    }
+    let warmResult;
+    const task = createPromotableBrowserBackgroundTask(async () => {
+      warmResult = await initialize();
+    });
+    const result = task.wait().then(() => {
+      if (!warmResult) {
+        throw new Error(
+          `Browser runtime for ${JSON.stringify(language)} completed warmup without a result.`
+        );
+      }
+      return warmResult;
+    });
+    const entry = { task, result };
+    this.#warmEntries.set(language, entry);
+    void result.catch(() => {
+      if (this.#warmEntries.get(language) === entry) {
+        this.#warmEntries.delete(language);
+      }
+    });
+    return entry;
+  }
+  async #promoteLanguageWarm(language) {
+    const entry = this.#warmEntry(language);
+    await entry.task.promote();
+    return entry.result;
+  }
   isLanguageSupported(language) {
     return this.supportedLanguages.includes(language);
   }
@@ -959,6 +1007,17 @@ var BrowserRuntimeHostImplementation = class {
       runtimes: Object.freeze(runtimes)
     });
   }
+  prewarmLanguage(language) {
+    this.#assertActive();
+    if (!this.supportedLanguages.includes(language)) {
+      return Promise.reject(
+        new Error(
+          `Runtime for language "${language}" is not selected in this browser environment.`
+        )
+      );
+    }
+    return this.#warmEntry(language).result;
+  }
   warmLanguage(language) {
     this.#assertActive();
     if (!this.supportedLanguages.includes(language)) {
@@ -968,16 +1027,20 @@ var BrowserRuntimeHostImplementation = class {
         )
       );
     }
-    return this.#preparedProviders.get(language).init();
+    return this.#promoteLanguageWarm(language);
   }
   disposeLanguage(language) {
     if (this.#disposed || !this.supportedLanguages.includes(language)) return;
+    this.#warmEntries.get(language)?.task.cancel();
+    this.#warmEntries.delete(language);
     this.#preparedProviders.get(language)?.flushPreparedProgramCache();
     this.#leaseByLanguage.get(language)?.disposeLanguage(language);
   }
   dispose() {
     if (this.#disposed) return;
     this.#disposed = true;
+    for (const entry of this.#warmEntries.values()) entry.task.cancel();
+    this.#warmEntries.clear();
     this.#readinessByLanguage.clear();
     for (const provider of this.#preparedProviders.values()) {
       provider.flushPreparedProgramCache();
@@ -1844,8 +1907,114 @@ function createPythonRuntimeImageFactory(options) {
   let disposed = false;
   let imagePromise = null;
   let activeBuildController = null;
+  let activeBootstrapWorker = null;
+  let activeBootstrapCancellation = null;
+  const buildInWorker = () => new Promise((resolve, reject) => {
+    if (!options.workerUrl) {
+      reject(new Error("Python runtime-image bootstrap requires a worker URL."));
+      return;
+    }
+    const workerFormat = options.workerFormat ?? "classic";
+    let workerUrl = appendWorkerUrlQueryParameter(
+      options.workerUrl,
+      "tracecodePythonRole",
+      "runtime-image"
+    );
+    if (workerFormat === "module") {
+      workerUrl = appendWorkerUrlQueryParameter(
+        workerUrl,
+        "tracecodePythonWorkerFormat",
+        "module"
+      );
+    }
+    const worker = options.workerFactory ? options.workerFactory(
+      workerUrl,
+      workerFormat === "module" ? { type: "module" } : void 0
+    ) : new Worker(
+      workerUrl,
+      workerFormat === "module" ? { type: "module" } : void 0
+    );
+    activeBootstrapWorker = worker;
+    const id = "python-runtime-image";
+    const protocolToken = createWorkerProtocolToken();
+    let requested = false;
+    let settled = false;
+    const finish = (operation) => {
+      if (settled) return;
+      settled = true;
+      globalThis.clearTimeout(timeoutId);
+      worker.terminate();
+      if (activeBootstrapWorker === worker) activeBootstrapWorker = null;
+      activeBootstrapCancellation = null;
+      operation();
+    };
+    const timeoutId = globalThis.setTimeout(() => {
+      finish(() => reject(
+        new Error(
+          `Python runtime image acquisition timed out after ${timeoutMs}ms.`
+        )
+      ));
+    }, timeoutMs);
+    activeBootstrapCancellation = () => {
+      finish(() => reject(
+        new Error("Python runtime image factory was disposed while loading.")
+      ));
+    };
+    worker.onerror = (event) => {
+      finish(() => reject(
+        new Error(
+          event.message || "Python runtime-image bootstrap Worker crashed."
+        )
+      ));
+    };
+    worker.onmessage = (event) => {
+      const message = event.data;
+      if (message?.type === "worker-ready" && !requested) {
+        requested = true;
+        worker.postMessage({
+          id,
+          type: "build-runtime-image",
+          protocolToken,
+          payload: {
+            source: "tracecode-python-runtime-image-v1",
+            descriptor: options.descriptor
+          }
+        });
+        return;
+      }
+      if (message?.id !== id || message.protocolToken !== protocolToken) {
+        return;
+      }
+      if (message.type === "error") {
+        finish(() => reject(
+          new Error(
+            message.payload?.error || "Python runtime-image bootstrap failed."
+          )
+        ));
+        return;
+      }
+      if (message.type !== "runtime-image-result") return;
+      const image = message.payload?.runtimeImage;
+      if (image?.protocolVersion !== PYTHON_RUNTIME_IMAGE_PROTOCOL_VERSION || !(image.compiledModule instanceof WebAssembly.Module) || !(image.snapshot instanceof Uint8Array) || image.snapshot.byteLength === 0 || typeof image.pythonHashSeed !== "string" || image.pythonHashSeed.length === 0) {
+        finish(() => reject(
+          new Error("Python runtime-image bootstrap returned an invalid image.")
+        ));
+        return;
+      }
+      finish(() => resolve(Object.freeze(image)));
+    };
+  });
   const build = async () => {
     if (disposed) throw new Error("Python runtime image factory is disposed.");
+    if (options.workerUrl) {
+      const image = await buildInWorker();
+      if (disposed) {
+        throw new Error(
+          "Python runtime image factory was disposed while loading."
+        );
+      }
+      return image;
+    }
     const controller = new AbortController();
     activeBuildController = controller;
     let timeoutId;
@@ -1963,6 +2132,10 @@ function createPythonRuntimeImageFactory(options) {
       disposed = true;
       activeBuildController?.abort();
       activeBuildController = null;
+      activeBootstrapCancellation?.();
+      activeBootstrapCancellation = null;
+      activeBootstrapWorker?.terminate();
+      activeBootstrapWorker = null;
       imagePromise = null;
     }
   });
@@ -2089,9 +2262,15 @@ function createPythonBrowserRuntimeProvider(options = {}) {
         );
       }
       const createRuntimeImageFactory = () => createPythonRuntimeImageFactory({
-        descriptor: runtimeImageDescriptor
+        descriptor: runtimeImageDescriptor,
+        workerUrl: context.assets.pythonWorker,
+        ...workerFactory ? { workerFactory } : {},
+        ...pythonManifest?.workerFormat ? { workerFormat: pythonManifest.workerFormat } : {}
       });
       let runtimeImageFactory = createRuntimeImageFactory();
+      const runtimeImageWorkerPreflight = context.preflight("python", [
+        "worker"
+      ]);
       const workerOptions = () => ({
         workerUrl: context.assets.pythonWorker,
         ...workerFactory ? { workerFactory } : {},
@@ -2132,6 +2311,7 @@ function createPythonBrowserRuntimeProvider(options = {}) {
       const lease = {
         preparedProviders,
         preflightLanguage: async () => {
+          await runtimeImageWorkerPreflight();
           await runtimeImageFactory.acquire();
         },
         disposeLanguage: () => {
@@ -4414,6 +4594,7 @@ function createJavaBrowserRuntimeProvider(options = {}) {
         debug: context.debug,
         workerIdleTimeoutMs: options.workerIdleTimeoutMs,
         compileCacheLimit: options.compileCacheLimit,
+        externalCompilerUrl: options.externalCompilerUrl,
         assetPreflight: context.preflight("java", ["worker"])
       };
       const preparedProvider = createJavaBrowserPreparedExecutionProvider(workerOptions);
@@ -4437,9 +4618,9 @@ var CSharpRuntimeClient = class {
   get preparedCompiler() {
     return this.preparedAuthority?.compiler ?? this.workerClient;
   }
-  async withPreparedRunner(execute) {
+  async withPreparedRunner(tier, execute) {
     if (!this.preparedAuthority) return execute(this.workerClient);
-    const runner = this.preparedAuthority.createRunner();
+    const runner = this.preparedAuthority.createRunner(tier);
     try {
       return await execute(runner);
     } finally {
@@ -4447,7 +4628,7 @@ var CSharpRuntimeClient = class {
       this.preparedAuthority.releaseRunner(runner);
     }
   }
-  async withFreshPreparedRunners(inputBatch, execute, signal) {
+  async withFreshPreparedRunners(tier, inputBatch, execute, signal) {
     const concurrency = Math.min(
       inputBatch.length,
       this.preparedAuthority?.batchConcurrency ?? 1
@@ -4469,6 +4650,7 @@ var CSharpRuntimeClient = class {
           const inputs = inputBatch[index];
           try {
             results[index] = await this.withPreparedRunner(
+              tier,
               (runner) => execute(runner, inputs, index)
             );
           } catch (reason) {
@@ -4572,6 +4754,17 @@ var CSharpRuntimeClient = class {
         timings: result.timings
       };
     }
+    const preparedRunnerTier = result.preparedRunnerTier;
+    const preparedRunnerReason = result.preparedRunnerReason;
+    if (preparedRunnerTier !== "algorithm-fast" && preparedRunnerTier !== "compatibility" || typeof preparedRunnerReason !== "string" || !preparedRunnerReason || preparedRunnerTier === "algorithm-fast" && !result.traceClrWireContract) {
+      return {
+        kind: "failed",
+        error: "C# preparation completed without a valid runner-tier descriptor.",
+        diagnosticStage: "compile",
+        consoleOutput: result.consoleOutput ?? [],
+        timings: result.timings
+      };
+    }
     let artifact = Object.freeze({
       mode: call.mode,
       code: call.code,
@@ -4580,7 +4773,24 @@ var CSharpRuntimeClient = class {
       ...call.traceOptions ? { traceOptions: Object.freeze({ ...call.traceOptions }) } : {},
       compiledArtifactKey: result.compiledArtifactKey,
       compiledArtifactBase64: result.compiledArtifactBase64,
-      compiledArtifactSha256: result.compiledArtifactSha256
+      compiledArtifactSha256: result.compiledArtifactSha256,
+      preparedRunnerTier,
+      preparedRunnerReason,
+      ...result.traceClrWireContract ? {
+        traceClrWireContract: Object.freeze({
+          parameters: Object.freeze(
+            result.traceClrWireContract.parameters.map(
+              (parameter) => Object.freeze({
+                name: parameter.name,
+                type: Object.freeze({ ...parameter.type })
+              })
+            )
+          ),
+          returnType: Object.freeze({
+            ...result.traceClrWireContract.returnType
+          })
+        })
+      } : {}
     });
     let disposed = false;
     let disposePromise;
@@ -4650,6 +4860,7 @@ var CSharpRuntimeClient = class {
       executeIsolated: (preparedCall) => executeOwned(
         preparedCall,
         (preparedArtifact, forwardedCall) => this.withPreparedRunner(
+          preparedArtifact.preparedRunnerTier,
           (runner) => runner.executePreparedTrace(
             preparedArtifact,
             forwardedCall
@@ -4667,6 +4878,7 @@ var CSharpRuntimeClient = class {
         return executeOwned(
           preparedCall,
           (preparedArtifact, forwardedCall) => this.withFreshPreparedRunners(
+            preparedArtifact.preparedRunnerTier,
             forwardedCall.inputBatch,
             (runner, inputs, index) => runner.executePreparedTrace(
               preparedArtifact,
@@ -4690,12 +4902,14 @@ var CSharpRuntimeClient = class {
       executeIsolated: (preparedCall) => executeOwned(
         preparedCall,
         (preparedArtifact, forwardedCall) => this.withPreparedRunner(
+          preparedArtifact.preparedRunnerTier,
           (runner) => runner.executePreparedCode(preparedArtifact, forwardedCall)
         )
       ),
       executeBatchIsolated: (preparedCall) => executeOwned(
         preparedCall,
         (preparedArtifact, forwardedCall) => this.withFreshPreparedRunners(
+          preparedArtifact.preparedRunnerTier,
           forwardedCall.inputBatch,
           (runner, inputs) => runner.executePreparedCode(preparedArtifact, {
             inputs,
@@ -4934,7 +5148,6 @@ function createCSharpBrowserRuntimeProvider(options = {}) {
         standbyWarmup = warmup;
         return warmup;
       };
-      void ensureStandbyRunner().catch(() => void 0);
       const preparedAuthority = preparedAuthorityEnabled ? {
         compiler,
         batchConcurrency: preparedBatchConcurrency,
@@ -4949,7 +5162,7 @@ function createCSharpBrowserRuntimeProvider(options = {}) {
             loadTimeMs: performance.now() - startedAt
           };
         },
-        createRunner() {
+        createRunner(_tier) {
           if (disposed) {
             throw new Error("C# browser runtime provider has been disposed.");
           }
@@ -9644,6 +9857,7 @@ function createBrowserJudgeHostFromRuntimeHost(host, options = {}) {
     isLanguageSupported: host.isLanguageSupported.bind(host),
     preflightLanguage: host.preflightLanguage.bind(host),
     preflight: host.preflight.bind(host),
+    prewarmLanguage: host.prewarmLanguage.bind(host),
     warmLanguage: host.warmLanguage.bind(host),
     disposeLanguage: host.disposeLanguage.bind(host),
     createJudge: (judgeOptions) => createBrowserRuntimeJudge({

package/dist/{project-browser-3S2FWEAP.js → project-browser-HFNQEALT.js}

@@ -2,7 +2,7 @@ var define = undefined;
 import {
   runRuntimeProjectWorkerBridge,
   withRuntimeProjectCommandRunnerCapabilities
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import "./chunk-756Z7C6D.js";
 
 // packages/runtime-cpp/src/project-browser.ts
@@ -32,4 +32,4 @@ function createBrowserCppProjectRunner(workerClient, options = {}) {
 export {
   createBrowserCppProjectRunner
 };
-//# sourceMappingURL=project-browser-3S2FWEAP.js.map
+//# sourceMappingURL=project-browser-HFNQEALT.js.map

package/dist/{project-browser-QN7YOJQQ.js → project-browser-L3A2G2MA.js}

@@ -53,7 +53,7 @@ import {
   runtimeKernelWriteFsErrorMessage,
   runtimeKernelWriteTarget,
   runtimeProjectInfrastructureFailure
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import {
   decodeTraceKernelWatchEvent
 } from "./chunk-LTRAP6OY.js";
@@ -10865,4 +10865,4 @@ export {
   createBrowserTypeScriptProjectRunner,
   runBrowserJavaScriptProjectRequest
 };
-//# sourceMappingURL=project-browser-QN7YOJQQ.js.map
+//# sourceMappingURL=project-browser-L3A2G2MA.js.map

package/dist/{project-browser-S4KLCZV7.js → project-browser-OVE7V464.js}

@@ -2,7 +2,7 @@ var define = undefined;
 import {
   runRuntimeProjectWorkerBridge,
   withRuntimeProjectCommandRunnerCapabilities
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import "./chunk-756Z7C6D.js";
 
 // packages/runtime-python/src/project-browser.ts
@@ -35,4 +35,4 @@ function createBrowserPythonProjectRunner(workerClient, options = {}) {
 export {
   createBrowserPythonProjectRunner
 };
-//# sourceMappingURL=project-browser-S4KLCZV7.js.map
+//# sourceMappingURL=project-browser-OVE7V464.js.map

package/dist/{project-browser-WDUWUGLZ.js → project-browser-P2H222D7.js}

@@ -3,7 +3,7 @@ import {
   createRuntimeProjectIoBridge,
   runRuntimeProjectWorkerBridge,
   withRuntimeProjectCommandRunnerCapabilities
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import "./chunk-756Z7C6D.js";
 
 // packages/runtime-java/src/project-browser.ts
@@ -77,4 +77,4 @@ function createBrowserJavaProjectRunner(workerClient, options = {}) {
 export {
   createBrowserJavaProjectRunner
 };
-//# sourceMappingURL=project-browser-WDUWUGLZ.js.map
+//# sourceMappingURL=project-browser-P2H222D7.js.map

package/dist/{project-browser-HCQCXAYC.js → project-browser-WCSIJY6I.js}

@@ -3,7 +3,7 @@ import {
   createRuntimeProjectIoBridge,
   runRuntimeProjectWorkerBridge,
   withRuntimeProjectCommandRunnerCapabilities
-} from "./chunk-Y72C46GE.js";
+} from "./chunk-GXTDL2ML.js";
 import "./chunk-756Z7C6D.js";
 
 // packages/runtime-csharp/src/project-browser.ts
@@ -79,4 +79,4 @@ function createBrowserCSharpProjectRunner(workerClient, options = {}) {
 export {
   createBrowserCSharpProjectRunner
 };
-//# sourceMappingURL=project-browser-HCQCXAYC.js.map
+//# sourceMappingURL=project-browser-WCSIJY6I.js.map

package/dist/{python-worker-client-EX6Q2W4L.js → python-worker-client-UCOMTSMU.js}

@@ -2,13 +2,13 @@ var define = undefined;
 import {
   PythonWorkerClient,
   isWorkerSupported
-} from "./chunk-M7SNEZDR.js";
-import "./chunk-Y72C46GE.js";
-import "./chunk-DTLDQQHA.js";
+} from "./chunk-EPBHRROK.js";
+import "./chunk-GXTDL2ML.js";
+import "./chunk-5KH5ABPQ.js";
 import "./chunk-C2RUZCIL.js";
 import "./chunk-756Z7C6D.js";
 export {
   PythonWorkerClient,
   isWorkerSupported
 };
-//# sourceMappingURL=python-worker-client-EX6Q2W4L.js.map
+//# sourceMappingURL=python-worker-client-UCOMTSMU.js.map