Authoritatively finds import candidates by reading top_level.txt from the installed package's .dist-info directory.

Gets import candidates, with special handling for bubbles vs main env.

Get the actual import name for a package by reading top_level.txt. Falls back to name transformations if not found. Examples

Generates a stable instance hash using the raw dist._path — no realpath/resolve. realpath follows uv symlinks into its cache, giving

Ultra-fast master version detection using direct file I/O. Returns: (version_string, install_spec)

Gets dependency paths with cache validation.

Gets omnipkg version directly from dist-info in a specific site-packages. Handles both regular and editable installs.

Extract minimum Python version from a SpecifierSet (e.g., '>=3.8' -> 'py3.8')

Given a CLI owner spec like ``jupyterlab==4.5.7`` and a broken dep name like ``attrs``, look up what version the owner's resolved_deps snapsh

Ask the interpreter for its full patch version string e.g. "3.11.15". Falls back to major.minor only if the subprocess fails.

Reads the ``resolved_deps`` JSON field from the KB instance record for *pkg_name*. Returns a {canonical_name: version_str} dict, or {} on an

(CORRECTED) Generates sensible default configuration paths based STRICTLY on the currently active virtual environment to ensure safet

Finds the virtual environment root with enhanced validation to prevent environment cross-contamination from stale shell variables.

Reads the WHEEL file to extract the full wheel tag (e.g. ``cp311-cp311-manylinux_2_17_x86_64``). This tag, combined with ``r

── English marker check: one stat() — ~2µs ────────────────────────────── * ~/.config/omnipkg/lang_marker_en exists → user is English → serve baked

Phase 0 heal: scan main site-packages AND bubble dirs for missing/broken METADATA files. Nuke broken dist-infos, reinstall via pip --

Enhanced conda environment healing that combines proactive scanning with reactive error-based healing. This function:

Batch pip install with automatic retry-without-all-failed-packages on error. Runs pip with stderr captured separately so we can actually parse it

Only care about .dist-info dirs at depth-1 — that's where name+version live.

(QUIET VERSION) Determines if a .dist-info directory is a "ghost" by using the standard library and ignoring unreliable cache files.

Return True if the event looks like an echo of our own FFI install, and clear the sentinel immediately so the NEXT event is not suppr

Case-insensitive relative_to for Windows path safety.

Determine if an import is safe (shouldn't be removed). Returns True if: - Module is in stdlib or common packages - M

Load config for THIS Python, create if doesn't exist. No more nested "environments" structure - FLAT data.

Resolve a short version string like '3.9' to its full managed-interpreter path via the omnipkg dispatcher registry. Falls back to None i

Interactive lock file manager — lets user mark and delete old lock files.

No-op context manager - used as a lock placeholder when no ABI lock is needed.

Helper to parse 'pkg==version' into (name, version)

Robustly isolate opt_einsum from torch/jax/cupy using stubs to prevent circular imports and partial initialization errors during TF load.

Sidecar file path: <lock_dir>/per_python/<lock_stem>/<ver>.sha

Write SHA sidecar after a successful sync.

Returns (installed, removed) from last callback intercept and clears it.

Print SUPPORTED_LANGUAGES as a compact multi-column table.

Print discovered lock files grouped by env with index numbers.

Print install strategy options with descriptions.

Given a distribution, scan its native extensions for a baked-in NPY_FEATURE_VERSION. Works for torch (libtorch_python.so), tensorflo

Query a cache client (Redis or SQLite) for active+bubble data.

Read the interpreter registry directly from disk — never relies on a subprocess that might return empty output in CI / temp-script contexts.

Legacy registration logic. Forwarding to simple registration for backward compatibility during migration.

Ask a *specific* managed Python interpreter what torch version it has. Returns 'torch==X.Y.Z+cuNNN' (ready to pass as a bubble spec), or None

Restore ALL cloaks (bubble + main-env) for pkg_name. Called from ABI conflict paths. Uses safe_uncloak for every move.

Interactive Python interpreter explorer — `8pkg info python` and `8pkg python info`.

Call handle_shim_execution() with controlled env and argv. Capture the os.execv call instead of letting it replace the process.

Saves the current environment state as 'last known good'. State source priority: 1. uv-ffi get_site_packages_cache() direct

Aggressively scrubs all omnipkg bubble paths from sys.path using resolved paths to avoid string mismatch issues.

Stub out jax during TensorFlow bubble initialization to prevent numpy version conflicts. TF 2.x's tensorflow/lite/python/util.py does:

Show summary message unless silent mode is on.

Test imports for a specific package in the bubble using the same logic as _verify_installation. This is adapted from your existing ro

Try Redis → SQLite KB for active + bubble data for one python version. Returns (active, bubbles) or (None, None) to signal filesystem fallbac

Update the machine-global lock registry with this export. - If this SHA is new: write canonical lock to states/, register it. - If SHA a

Waits until the daemon socket is actually accepting connections.

Writes data to the self-heal cache file.

Atomically regenerate profile.d/omnipkg_pythons.sh from the current registry. Must be called any time the registry changes.

Creates temporary backups of all protected files.

View or follow the daemon logs.

Handle 8pkg activate command

Handle 8pkg deactivate command

Write finished. Increment version, clear lock flag, release file lock.

PRIORITY ORDER: 1. CLI flag --python (explicit user intent — ALWAYS wins, including 8pkg39) 2. OMNIPKG_PYTHON_XY_PATH env var (set by ad

Signals the FS watcher that a long Omnipkg install has ENDED, providing the official changelog from the FFI.

Find the uv binary in a bubble's bin dir, handling Windows .exe extension. Returns the Path if found, raises FileNotFoundError otherwise.

Get cached version for a specific python_context. Returns None if not cached, version string if compatible, or raises NoCompatiblePyt

Checks the conda-forge 'County Fair' mapping for import_name -> pypi_name. Downloads, caches to disk, and loads into memory to maintain light

Connect to daemon and get PID-to-spec mapping.

Get current idle pool configuration.

Read the interpreter exe from the registry. Only call this AFTER the versioned shim has already run (adoption complete).

Finds which package owns a specific CLI command using the O(1) Knowledge Base index.

Get package metadata with smart caching Returns: { "metadata": {...}, # PyPI metadata from GitHub

Cross-platform process collection via psutil, fallback to ps on Unix.

Dynamically find the site-packages path

Get the current version number.

Return a command prefix for a versioned omnipkg shim. The shim handles auto-adopt + install — no registry pre-check needed. Priority:

Enhanced run command handler Usage: 8pkg run <command> [args...] Supports: - Python scripts: 8pkg run my_script.py --arg1 --arg2

Check if PyTorch 1.x native IPC is available.

Check if torch.multiprocessing share_memory_() IPC works on this system. This probes the actual round-trip (spawn a child, pass a te

Check if Universal CUDA IPC is available.

Reinstalls a package completely to fix ABI/compilation issues. This is more aggressive than bubbling and is used when packages have been compi