virtual-machine 0.0.36 → 0.1.0

package/build/index.d.ts

@@ -85,6 +85,12 @@ declare class WasmVm {
    * Called from JavaScript when the native WebTransport addon receives a packet.
    */
   inject_network_packet(packet: Uint8Array): boolean;
+  /**
+   * Signal that workers can start executing.
+   * Called by the main thread after hart 0 has finished initializing
+   * kernel data structures.
+   */
+  allow_workers_to_start(): void;
   /**
    * Extract a network packet sent by the guest.
    * Returns the packet data or null if no packet is pending.
@@ -155,6 +161,11 @@ declare class WasmVm {
    * JS-WASM boundary crossings.
    */
   step_n(count: number): number;
+  /**
+   * Get the entry PC address for workers.
+   * This is the address where secondary harts should start executing.
+   */
+  entry_pc(): bigint;
   /**
    * Get the halt code if the VM has halted.
    * Code 0x5555 typically means successful shutdown (PASS).
@@ -185,6 +196,11 @@ declare class WorkerState {
    * the event loop to yield between batches. This prevents the worker
    * from blocking indefinitely and allows it to respond to messages.
    *
+   * Performance optimization: We reduce atomic operations by:
+   * - Only checking halt signals every HALT_CHECK_INTERVAL instructions
+   * - Only checking interrupts every INTERRUPT_CHECK_INTERVAL instructions
+   * - Doing a full interrupt check at the end of each batch
+   *
    * Returns a WorkerStepResult indicating whether to continue, halt, etc.
    */
   step_batch(batch_size: number): WorkerStepResult;
@@ -247,8 +263,10 @@ interface InitOutput {
   readonly memory: WebAssembly.Memory;
   readonly __wbg_wasmvm_free: (a: number, b: number) => void;
   readonly __wbg_workerstate_free: (a: number, b: number) => void;
+  readonly wasmvm_allow_workers_to_start: (a: number) => void;
   readonly wasmvm_connect_webtransport: (a: number, b: number, c: number, d: number, e: number) => [number, number];
   readonly wasmvm_disconnect_network: (a: number) => void;
+  readonly wasmvm_entry_pc: (a: number) => bigint;
   readonly wasmvm_external_network_rx_pending: (a: number) => number;
   readonly wasmvm_external_network_tx_pending: (a: number) => number;
   readonly wasmvm_extract_all_network_packets: (a: number) => any;
@@ -282,12 +300,12 @@ interface InitOutput {
   readonly workerstate_new: (a: number, b: any, c: bigint) => number;
   readonly workerstate_step_batch: (a: number, b: number) => number;
   readonly workerstate_step_count: (a: number) => bigint;
+  readonly wasm_bindgen__convert__closures_____invoke__h8a077b496ee6a629: (a: number, b: number) => void;
+  readonly wasm_bindgen__closure__destroy__h54a2706e25dd10b8: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h38b3d5c42439bcf4: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__he860240c5b649134: (a: number, b: number, c: any) => void;
   readonly wasm_bindgen__convert__closures_____invoke__h39d3e89751b07765: (a: number, b: number, c: any) => void;
   readonly wasm_bindgen__closure__destroy__hf225e18fc5ab9bc1: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h2d5a3433881a07dc: (a: number, b: number) => void;
-  readonly wasm_bindgen__closure__destroy__h4a8089319832ef98: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__hd016cca7bbf341cd: (a: number, b: number) => void;
-  readonly wasm_bindgen__convert__closures_____invoke__h07c9b936df37d4f2: (a: number, b: number, c: any) => void;
   readonly __wbindgen_malloc: (a: number, b: number) => number;
   readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
   readonly __wbindgen_exn_store: (a: number) => void;
@@ -400,6 +418,10 @@ interface VmOptions {
  * If SharedArrayBuffer is available (requires COOP/COEP headers), the VM
  * will run in true parallel mode with Web Workers for secondary harts.
  *
+ * NOTE: In WASM, multi-hart mode is significantly slower due to
+ * SharedArrayBuffer/Atomics overhead (see tasks/improvements.md).
+ * Default is 1 hart unless explicitly specified.
+ *
  * @param kernelData - ELF kernel binary
  * @param options - VM configuration options
  * @returns WasmVm instance