Emergency cloak restoration - always cleanup since this is an error path.

Applies a patch to numpy.issubdtype to prevent infinite recursion when used with certain versions of TensorFlow.

Lightweight timing printer; no-op unless UV_FFI_PROFILE=1.

Quick test to see if a syslib combination fixes an error.

Orchestrator for the Dependency Time Machine logic, run as an automatic fallback. Attempts to reconstruct the exact dependency enviro

Runs `pip uninstall` with LIVE, STREAMING output.

Main script execution logic with robust interactive handling.

Common function to run a script and automatically heal any failures. Can inject the original script's directory into PYTHONPATH for local imp

Scan for ALL cloaked versions, now recognizing loader-specific suffixes. Returns list of (cloaked_path, original_name, timestamp, loa

Accumulate the delta and debounce rapid bursts. Two-tier debounce: • dist-info events: fire after 5ms — they carry name+ve

Return a minimal dict containing ONLY the fields that contribute to the content SHA. Everything else is dropped entirely — not replaced with

Push a single idle-count change to the daemon. Returns True on success.

Sets a flag indicating that a new interpreter needs its knowledge base built. This is a stateful, safe way to trigger a one-time setu

Signal that filesystem mutations are complete. Daemon can now release the lock and serve other requests.

Return True if spec contains a package that can't be version-switched.

Return the venv-aware Python executable path on macOS/Linux. Problem: when the daemon is forked, macOS resolves the venv symlink at the

Resolve the venv root using the same priority chain as dispatcher.c. Raises RuntimeError if nothing can be found.

Get daemon status.

Convert a module name to its likely PyPI package name. Handles common cases where module names differ from package names.

Create (or recreate) the shared-memory block. Called by watcher.

O(1) lookup — returns (None, None) instantly for normal packages.

Retrieves the currently installed version of a package from the Knowledge Base.

Find and load libcudart.so from various locations.

Get the numpy version constraint for a specific package version. Args: package_name: Name of the package (e.g., 'pandas') ver

Get a summary report of healing operations.

Installs/upgrades a package. Escalates to force_reinstall if needed, then aborts to prevent loops.

Main application entry point with pre-flight version check.

Patch Flask code to use an available port with optional interactive mode. Args: code: Python source code containing Flask app

Append one JSONL record. Thread-safe, non-blocking.

Helper to run a command and capture output with Windows compatibility.

Prepares the environment, skipping setup if packages already exist.

Start the web bridge in background.

Stop the web bridge safely across platforms.

Wait for Flask app to be ready to accept connections.

Activate a bubble with MANDATORY module cleanup. CRITICAL: NEVER skip module purging, even in nested contexts!

Auto-detect site-packages path that's compatible with current Python version.

Create a backup of a corrupted file before removal. Args: file_path: Path to the corrupted file backup_base_

Cloak multiple packages with PROCESS-WIDE SAFETY and global tracking.

Pre-build lowercase pkg->ecosystem map once. Makes detect_index_url O(1).

Checks for a flag file indicating a new interpreter needs its KB built. If the currently running Python matches a version in the flag

importlib.metadata-based check (current slow method)

Return every bin/ directory that should receive the C dispatcher binary: 1. The native bin/ (next to sys.executable) — always included

Create versioned entry-point symlinks / shims so that commands like 8pkg39, omnipkg39, 8pkg311, omnipkg311 work immediately after ado

Creates versioned entry points for ALL omnipkg commands: Unix → $VENV/bin/8pkgXY (symlink → 8pkg) → $VEN

Fallback: The old, slow disk-based method.

Detect host system properties for realization context. All fields are informational only — most are NOT included in content_sha. Exceptio

Detects critical dependency paths. 🛡️ AUTO-HEALING: If a critical dep is missing but a cloak exists, it will RESTORE (Un-Cloa

Updates the config file to disable Redis and record why. Does not raise exceptions - gracefully handles any failures.

Eagerly create versioned shims for Python 3.7–3.15 in bin_dir. On Unix: symlinks (8pkg39 -> 8pkg, omnipkg311 -> omnipkg, etc.) On Window

Ensure omnipkg's version-compatible dependencies remain accessible when bubble is active.

Ensures omnipkg is installed in an interpreter. Idempotent.

CRITICAL FIX: Evict worker without blocking on shutdown.

Torch MP Queue IPC — fallback for Turing + CUDA 13 + driver 610 where cudaIpcOpenMemHandle (rc=1) is broken but torch.multiprocessing

Resolves a complex package specifier (e.g., 'numpy>=1.20,<1.22') to the latest compliant version by querying all available versions f

Find already-created bubbles that are in the same verification group. This allows keras to find tensorflow, tensorboard to find tens

Find the main shared library file.

Helper to find which package a file belongs to, now supporting .egg-info.

Discovers all available Python interpreters on the system. Returns a dict mapping (major, minor) version tuples to executable paths.

Return the list of omnipkg bubble paths currently at the front of sys.path. CRITICAL: this function must NEVER trigger an import (no `from x impo

Get socket family and address for connecting to daemon. Works on both Windows (TCP) and Unix (domain socket). Returns:

Gets the omnipkg version, prioritizing pyproject.toml in developer mode. CRITICAL FIX: Detects if we're in a staging/temporary environment d

Creates a short, stable hash from the venv path to uniquely identify it.

Returns the path to the self-heal cache file.