Module v8_host 

V8 runtime host — manages a shared embedded V8 runtime with session multiplexing.

Structs

V8RuntimeHost

Manages an embedded V8 runtime with session multiplexing.

V8SessionFrameReceiver

Direct view of the V8 runtime’s one bounded per-session output lane. Mapping the typed in-process event to the legacy binary frame is allocation-local and no longer requires a relay queue or an OS thread per session.

V8SessionHandle

A handle to a single V8 session within the shared runtime. Provides methods for sending frames specific to this session.

Functions

ensure_runtime_initialized

Pre-build the per-sidecar snapshot for an agent-SDK userland_code bundle into the process-wide cache, so the FIRST session that uses it is already warm. Uses the shared embedded runtime directly (no per-call host lifecycle). Blocks until built; idempotent (cache hit returns immediately); no-op for empty input. Eagerly initialize the process-wide embedded V8 runtime (and its process-lifetime platform owner) before accepting VM work. Calling this at sidecar startup keeps initialization failures on the entrypoint, although correctness no longer depends on the first caller itself being a long-lived thread.

pre_warm_agent_snapshot