Ensure a specific version of a system library is available.

Ensures the script is running on a specific Python version. If not, it finds the target interpreter and relaunches the script using os.execve

* ensure_uv_ffi_for_python — install uv_ffi into a non-main interpreter * (e.g. cpython-3.9.23) if it is missing, then notify the daemon worker * to

Run *code* inside an isolated worker that has *spec* installed. Worker is created on first call and reused on subsequent calls.

Executes validated commands with streaming output (generator function). Yields output line-by-line in real-time.

Enhanced to properly handle Python stdin mode and ensure healing works correctly.

Execute a CLI command with automatic conflict resolution

Snapshot the current omnipkg environment to a TOML lock file. Default location: <venv_root>/.omnipkg/omnipkg.lock Override with output_p

Extract version string from Python path for error messages.

Detects the actual main env rich version, then ensures bubbles exist.

Finds an available port starting from start_port.

Find a known working system library combination for a package.

A standalone function to manually trigger a check and restore. This is useful for scripts or manual repair. It creates its own backups an

Guide the user through resolving the Chrome Local Network Access permission.

Gets the ACTUAL site-packages directory for the currently running Python interpreter. This is more reliable than calculating it from

Get cache statistics.

Get cache statistics

Find which package provides this CLI command

Load config using ConfigManager

Scans a bubble folder and returns the absolute truth of what is installed. Returns: { 'canonical-name': 'version' }

Fetch the live idle-worker config from the daemon. Returns a dict keyed by display version string (e.g. "3.11") whose values are (target

Get base path from config with fallbacks

Returns detailed performance statistics for CI/logging purposes.

Read version directly from disk — no import cache.

(UPGRADED) Audits, reconciles conflicting requirements, and attempts to fix dependency conflicts by installing a single, consistent s

Quick function to heal a code string. Args: code: Python code to heal verbose: Print detailed healing messages aggre

Heal a file in-place. Returns: True if file was modified, False otherwise

Analyze a runtime error and suggest system library versions that might fix it. This is the core of the "runtime healer" functionality

Creates ISOLATED bubbles for the requested specs and re-runs the script. CRITICAL FIX: Healing plan specs have ABSOLUTE PRIORITY. Script

Check if worker is responsive. For ABI packages, probes a real import to catch 'cannot load module more than once per process' before reuse.

Prints a summary of the bubble's directory structure for verification.

(V10 - COMPLETE FIX) Builds a bubble and verifies using smart group-aware testing. FIX: Now properly creates manifest and re

Returns True if cache entry is older than max_age_seconds. PERF: Check file cache timestamp first (pure in-memory, ~0µs). Only hit Re

Returns True if the sentinel was touched after cache_built_at, meaning some process mutated the FS since the cache was populated.

Check if command is an installed Python CLI tool

Checks if a package is 'Ghosted' (metadata exists so pip thinks it's installed, but the actual module cannot be imported). NOTE: We deli

Check if running on Windows.

Omnipkg Unified Dispatcher.

Test 1: Load TensorFlow 2.13.0 from a bubble. ── API: omnipkgLoader (legacy loader) ─────────────────────────────────── from omnipkg.l

Test 2: Switch pure-Python packages between contexts. Pure Python packages (no .so/.pyd files) CAN be swapped by the legacy loader becau

Test 3: Nested loaders — outer context + inner context. Contexts stack correctly. The inner loader activates its bubble on top of the o

Test 4: The C-extension limitation — honest, explained, not a crash. This test intentionally tries to switch TF versions mid-process. Th

Return the sentinel's mtime, or 0.0 if it doesn't exist.

Uses omnipkg to cleanly uninstall numpy and scipy.

Use omnipkg to install baseline versions.

Overhead dissection: perf stat + strace (external tools, may need perms) + in-worker cProfile (always works). If perf_log_path is set, w

Test 5: Run TF 2.13.0 + TF 2.12.0 via daemon, twice. First run = cold (workers spin up). Second run = hot (workers already warm, spec alr

Intelligently removes old bubbled versions of a package.

Reads current state without locking (dirty read).

Called by the UV worker AFTER a successful FFI install so the watcher knows the next FS event for this install was OURS, not an exter

Unlock: CAS(Odd -> Odd + 1). Makes it Even (Free).

Deletes ALL omnipkg data for the CURRENT environment from Redis, and then triggers a full rebuild.

Compares the current env to the last snapshot and restores it.

Execute a uv command via the Rust FFI layer. Args: cmd: Shell-style uv argument string, WITHOUT the leading "uv". Examp

Main entry point for the stress test.

The entry point for the background process.