pynect 0.0.0 → 0.2.1

package/dist/core/py-runtime.d.ts

@@ -0,0 +1,113 @@
+/**
+ * pynect - PyRuntime
+ * The central manager for the Python interpreter lifecycle.
+ * Creates, configures, and shuts down the embedded CPython instance.
+ */
+import type { NativeAddon } from '../types/addon';
+import type { PynectConfig, ResolvedPynectConfig } from '../types/config';
+import { PyModule } from './py-module';
+import { PyContext } from './py-context';
+import { type IsolatedCallOptions } from './isolated-worker';
+/**
+ * PyRuntime - manages the lifecycle of the embedded Python interpreter.
+ *
+ * @example
+ * ```typescript
+ * const runtime = await PyRuntime.create({
+ * project: { dependencies: ['pandas'] },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * });
+ *
+ * const pd = await runtime.import('pandas');
+ * const df = await pd.read_csv('data.csv');
+ * const result = await df.to_dict('records');
+ *
+ * await runtime.shutdown();
+ * ```
+ */
+export declare class PyRuntime {
+    private readonly _config;
+    private _pythonExecutable;
+    private readonly _pythonLibrary;
+    private readonly _addon;
+    private readonly _pluginManager;
+    private readonly _memoryMonitor;
+    private _isolatedWorker?;
+    private _running;
+    private constructor();
+    /**
+     * Create and initialize a PyRuntime instance.
+     */
+    static create(config?: PynectConfig): Promise<PyRuntime>;
+    private _initialize;
+    private _setupPythonEnvironment;
+    private _bootstrapPythonRuntime;
+    /**
+     * Import a Python module and return a PyProxy.
+     *
+     * @example
+     * ```typescript
+     * const pd = await runtime.import('pandas');
+     * const df = await pd.read_csv('data.csv');
+     * ```
+     */
+    import(moduleName: string): Promise<PyModule>;
+    /**
+     * Import multiple modules at once (concurrent).
+     */
+    importAll(moduleNames: string[]): Promise<Record<string, PyModule>>;
+    /**
+     * Call a JSON-compatible Python function in a killable child process.
+     * This is a process boundary, not an operating-system sandbox.
+     */
+    callIsolated<T = unknown>(moduleName: string, functionName: string, args?: unknown[], options?: IsolatedCallOptions): Promise<T>;
+    /**
+     * Evaluate a Python expression.
+     */
+    eval(expression: string): Promise<unknown>;
+    /**
+     * Execute Python statements.
+     */
+    exec(code: string): Promise<void>;
+    /**
+     * Run a Python script file.
+     */
+    runFile(filePath: string): Promise<unknown>;
+    /**
+     * Create an isolated Python execution context.
+     */
+    createContext(): Promise<PyContext>;
+    /**
+     * Install Python packages into the active environment.
+     */
+    installPackages(packages: string[]): Promise<void>;
+    /**
+     * Get current memory statistics.
+     */
+    getMemoryStats(): ReturnType<NativeAddon['getMemoryStats']>;
+    /**
+     * Trigger Python garbage collection.
+     */
+    collectGarbage(): Promise<void>;
+    /**
+     * Get the underlying native addon.
+     * Advanced use only.
+     */
+    getAddon(): NativeAddon;
+    isRunning(): boolean;
+    getConfig(): ResolvedPynectConfig;
+    /**
+     * Gracefully shut down the Python runtime.
+     * Releases all Python objects and finalizes the interpreter.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Synchronous shutdown (for process.on('exit') handler).
+     * Best-effort only - may not complete all cleanup.
+     */
+    shutdownSync(): void;
+    private _ensureRunning;
+    private _ensureUnsafeCodeAllowed;
+    private _parseBytes;
+}
+//# sourceMappingURL=py-runtime.d.ts.map

package/dist/core/py-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-runtime.d.ts","sourceRoot":"","sources":["../../src/core/py-runtime.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAsB7E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;IAgBP;;OAEG;WACU,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;YAoJpD,WAAW;YA2DX,uBAAuB;YAMvB,uBAAuB;IAkCrC;;;;;;;;OAQG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2CnD;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAOzE;;;OAGG;IACG,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAO,EAAO,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC;IAUb;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4ChD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvC;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BjD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IAQzC;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD;;OAEG;IACH,cAAc,IAAI,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAK3D;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;;OAGG;IACH,QAAQ,IAAI,WAAW;IAOvB,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,oBAAoB;IAMjC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B;;;OAGG;IACH,YAAY,IAAI,IAAI;IAYpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,WAAW;CAUpB"}

package/dist/core/py-runtime.js

@@ -0,0 +1,528 @@
+"use strict";
+/**
+ * pynect - PyRuntime
+ * The central manager for the Python interpreter lifecycle.
+ * Creates, configures, and shuts down the embedded CPython instance.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PyRuntime = void 0;
+const path_1 = __importDefault(require("path"));
+const project_1 = require("../config/project");
+const config_1 = require("../types/config");
+const py_proxy_1 = require("./py-proxy");
+const py_module_1 = require("./py-module");
+const py_context_1 = require("./py-context");
+const isolated_worker_1 = require("./isolated-worker");
+const plugin_manager_1 = require("../plugins/plugin-manager");
+const package_installer_1 = require("../env/package-installer");
+const pyfig_adapter_1 = require("../env/pyfig-adapter");
+const project_environment_1 = require("../env/project-environment");
+const native_addon_loader_1 = require("../native/native-addon-loader");
+const memory_monitor_1 = require("../utils/memory-monitor");
+const logger_1 = require("../utils/logger");
+const error_translator_1 = require("../utils/error-translator");
+const logger = new logger_1.Logger('PyRuntime');
+/**
+ * PyRuntime - manages the lifecycle of the embedded Python interpreter.
+ *
+ * @example
+ * ```typescript
+ * const runtime = await PyRuntime.create({
+ * project: { dependencies: ['pandas'] },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * });
+ *
+ * const pd = await runtime.import('pandas');
+ * const df = await pd.read_csv('data.csv');
+ * const result = await df.to_dict('records');
+ *
+ * await runtime.shutdown();
+ * ```
+ */
+class PyRuntime {
+    _config;
+    _pythonExecutable;
+    _pythonLibrary;
+    _addon;
+    _pluginManager;
+    _memoryMonitor;
+    _isolatedWorker;
+    _running = false;
+    constructor(config, addon, pythonLibrary) {
+        this._config = config;
+        this._pythonExecutable = config.pythonExecutable;
+        this._pythonLibrary = pythonLibrary;
+        this._addon = addon;
+        this._pluginManager = new plugin_manager_1.PluginManager();
+        this._memoryMonitor = new memory_monitor_1.MemoryMonitor({
+            gcThreshold: this._parseBytes(config.gcThreshold),
+        });
+        this._memoryMonitor.attach(addon);
+    }
+    /**
+     * Create and initialize a PyRuntime instance.
+     */
+    static async create(config = {}) {
+        const projectOverrides = {
+            ...config,
+            projectRoot: config.projectRoot,
+            python: config.python ?? config.pythonPath,
+            requiresPython: config.requiresPython,
+            managedPython: config.managedPython,
+            uvVersion: config.uvVersion,
+            installPython: config.installPython ?? config.autoInstallPython,
+            installUv: config.installUv ?? config.autoInstallUv,
+            createVirtualEnvironment: config.createVirtualEnvironment ?? config.autoCreateVirtualEnvironment,
+            autoSync: config.autoSync,
+            lockfile: config.lockfile,
+            generatedDirectory: config.generatedDirectory,
+            env: config.env,
+        };
+        const project = (0, project_1.resolveProjectConfig)(projectOverrides);
+        const plan = (0, project_environment_1.createProjectPlan)(projectOverrides);
+        let environmentState;
+        if ((0, project_environment_1.requiresProjectSync)(plan)) {
+            if (project.autoSync === 'if-missing') {
+                try {
+                    environmentState = (0, project_environment_1.validateProjectEnvironment)(plan);
+                }
+                catch {
+                    environmentState = (await (0, project_environment_1.syncProject)(projectOverrides)).state;
+                }
+            }
+            else {
+                environmentState = (0, project_environment_1.validateProjectEnvironment)(plan);
+            }
+        }
+        if (config.virtualenv?.autoInstall && (config.virtualenv.packages?.length ?? 0) > 0) {
+            throw new Error('virtualenv.autoInstall is no longer supported. Declare Python dependencies in the ' +
+                'root package.json pynect.project.dependencies field and run "pynect sync".');
+        }
+        // Resolve Python before loading the native addon. On Windows the addon
+        // depends on the selected Python DLL, so its directory must already be on
+        // PATH when Node loads the .node file.
+        const { python: selected } = await (0, pyfig_adapter_1.ensurePynectPython)({
+            autoInstallPython: project.installPython,
+            autoInstallUv: project.installUv,
+            autoCreateVirtualEnvironment: project.createVirtualEnvironment,
+            managedPython: project.managedPython,
+            uvVersion: project.uvVersion,
+            pythonRange: plan.pythonRange,
+            pythonPath: project.python,
+            projectRoot: project.projectRoot,
+            env: project.env,
+        });
+        if (environmentState) {
+            const selectedAbi = `${selected.implementation}-${selected.version}-` +
+                `${selected.architecture}-${selected.pointerBits}`;
+            if (!pathsEqual(environmentState.pythonExecutable, selected.executable) ||
+                environmentState.pythonAbi !== selectedAbi) {
+                throw new Error('Pynect environment Python changed since the last sync. Run "pynect sync" before ' +
+                    'starting the application.');
+            }
+        }
+        const selectedProjectRoot = project.projectRoot;
+        if (config.virtualenv?.path) {
+            const configuredVenv = path_1.default.resolve(config.virtualenv.path);
+            if (!selected.virtualEnvironment || !pathsEqual(configuredVenv, selected.virtualEnvironment)) {
+                throw new Error(`virtualenv.path must resolve to the Pyfig-selected environment at ${selected.virtualEnvironment}.`);
+            }
+        }
+        const preparedConfig = {
+            ...config,
+            python: selected.executable,
+            requiresPython: plan.pythonRange,
+            projectRoot: selectedProjectRoot,
+            installPython: project.installPython,
+            installUv: project.installUv,
+            createVirtualEnvironment: project.createVirtualEnvironment,
+            managedPython: project.managedPython,
+            uvVersion: project.uvVersion,
+            autoSync: project.autoSync,
+            lockfile: project.lockfile,
+            generatedDirectory: project.generatedDirectory,
+            env: project.env,
+            dispatcher: {
+                ...config.dispatcher,
+                include: [
+                    ...(config.dispatcher?.include ?? []),
+                    ...(0, project_environment_1.moduleDispatcherIncludes)(plan),
+                ],
+            },
+        };
+        if (process.platform === 'win32') {
+            const requiredDirectories = [
+                selected.basePrefix,
+                selected.embedding.libraryDirectory,
+                path_1.default.dirname(selected.executable),
+            ];
+            const entries = (process.env['PATH'] ?? '').split(path_1.default.delimiter);
+            for (const directory of requiredDirectories.reverse()) {
+                if (!entries.some((entry) => entry.toLowerCase() === directory.toLowerCase())) {
+                    process.env['PATH'] = `${directory}${path_1.default.delimiter}${process.env['PATH'] ?? ''}`;
+                }
+            }
+        }
+        const resolved = (0, config_1.resolveConfig)(preparedConfig);
+        // Set log level
+        logger_1.Logger.setGlobalLevel(resolved.logLevel);
+        logger.info('Creating PyRuntime...');
+        // Load the native addon
+        let addon;
+        try {
+            addon = (0, native_addon_loader_1.loadOrBuildNativeAddon)({
+                projectRoot: selectedProjectRoot,
+                pythonExecutable: selected.executable,
+                pythonLibrary: selected.embedding.libraryPath,
+                pythonVersion: selected.version,
+            });
+            logger.debug('Native addon loaded');
+        }
+        catch (err) {
+            logger.error('Failed to load the Pynect native addon.', err);
+            throw new Error('Pynect native addon could not be loaded or built by the active JavaScript runtime.\n' +
+                `Original error: ${err.message}`);
+        }
+        const runtime = new PyRuntime(resolved, addon, selected.embedding.libraryPath);
+        try {
+            await runtime._initialize();
+            return runtime;
+        }
+        catch (error) {
+            if (addon.isInitialized()) {
+                await addon.finalizePython().catch(() => undefined);
+            }
+            throw error;
+        }
+    }
+    // Initialization
+    async _initialize() {
+        const startTime = performance.now();
+        // 1. Detect/setup Python environment
+        const pythonExecutable = await this._setupPythonEnvironment();
+        this._pythonExecutable = pythonExecutable;
+        if (this._config.isolation.enabled) {
+            const packagedPython = path_1.default.join(__dirname, '..', '..', 'python');
+            this._isolatedWorker = new isolated_worker_1.IsolatedWorker({
+                pythonExecutable,
+                projectRoot: this._config.projectRoot,
+                scriptPath: path_1.default.join(packagedPython, 'isolated_worker.py'),
+                cwd: this._config.isolation.cwd,
+                timeout: this._config.isolation.timeout,
+                env: this._config.env,
+                pythonPath: [packagedPython, ...this._config.pythonPathExtra],
+                dispatcher: this._config.dispatcher,
+                includeTracebacks: this._config.includeTracebacks,
+            });
+        }
+        // 2. Initialize Python interpreter via C++ addon
+        logger.debug(`Initializing Python interpreter: ${pythonExecutable}`);
+        await this._addon.initializePython({
+            pythonHome: this._config.pythonHome || '',
+            pythonExecutable,
+            pythonLibrary: this._pythonLibrary,
+            threadPoolSize: this._config.threadPoolSize,
+            maxQueueSize: this._config.maxQueueSize,
+            gilReleaseInterval: this._config.gil.releaseInterval,
+            callTimeout: this._config.callTimeout,
+            pythonPathExtra: [
+                path_1.default.join(__dirname, '..', '..', 'python'),
+                ...this._config.pythonPathExtra,
+            ],
+            env: this._config.env,
+            enableProfiling: this._config.profilingEnabled,
+            includeTracebacks: this._config.includeTracebacks,
+        });
+        logger.debug('Python interpreter initialized');
+        // 3. Bootstrap Python runtime helpers
+        await this._bootstrapPythonRuntime();
+        // 4. Register built-in plugins
+        await this._pluginManager.registerBuiltins();
+        // 5. Start memory monitoring
+        this._memoryMonitor.startMonitoring(10000);
+        this._running = true;
+        const elapsed = (performance.now() - startTime).toFixed(0);
+        logger.success(`PyRuntime ready in ${elapsed}ms (Python: ${pythonExecutable})`);
+    }
+    async _setupPythonEnvironment() {
+        const pythonExecutable = this._config.pythonExecutable;
+        logger.info(`Using repository virtualenv: ${path_1.default.dirname(path_1.default.dirname(pythonExecutable))}`);
+        return pythonExecutable;
+    }
+    async _bootstrapPythonRuntime() {
+        try {
+            const dispatcherConfig = Buffer.from(JSON.stringify(this._config.dispatcher), 'utf8').toString('base64');
+            // Initialize pynect Python runtime helpers
+            const bootstrapCode = `
+# Initialize optional upstream helpers. The packaged Python directory is
+# already inserted into sys.path by the native initialization options.
+try:
+    import pynect_runtime
+    pynect_runtime.initialize()
+except ImportError:
+    pass  # Runtime helpers not available, basic operation only
+
+import base64 as _pynect_base64
+import json as _pynect_json
+import pynect_dispatcher
+pynect_dispatcher.configure(
+    _pynect_json.loads(_pynect_base64.b64decode('${dispatcherConfig}'))
+)
+`;
+            await this._addon.runPythonCode(bootstrapCode);
+            logger.debug('Python runtime helpers bootstrapped');
+        }
+        catch (err) {
+            logger.error('Failed to bootstrap the Python dispatcher', err);
+            throw err;
+        }
+    }
+    // Module Import
+    /**
+     * Import a Python module and return a PyProxy.
+     *
+     * @example
+     * ```typescript
+     * const pd = await runtime.import('pandas');
+     * const df = await pd.read_csv('data.csv');
+     * ```
+     */
+    async import(moduleName) {
+        this._ensureRunning();
+        logger.debug(`Importing Python module: ${moduleName}`);
+        const result = await this._addon.importModule(moduleName);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, error_translator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error(`Failed to import Python module '${moduleName}'`);
+        }
+        if (!result.objectId) {
+            throw new Error(`Module '${moduleName}' imported but no object ID returned`);
+        }
+        // Run plugin hooks
+        await this._pluginManager.onModuleImported(moduleName, result.objectId);
+        // Create PyModule
+        const module = py_module_1.PyModule.fromRef(result.objectId, moduleName, this._addon, this._config.callTimeout, this._config.executionTimeout);
+        logger.debug(`Module '${moduleName}' imported (id=${result.objectId})`);
+        return module;
+    }
+    /**
+     * Import multiple modules at once (concurrent).
+     */
+    async importAll(moduleNames) {
+        const modules = await Promise.all(moduleNames.map(async (name) => [name, await this.import(name)]));
+        return Object.fromEntries(modules);
+    }
+    /**
+     * Call a JSON-compatible Python function in a killable child process.
+     * This is a process boundary, not an operating-system sandbox.
+     */
+    async callIsolated(moduleName, functionName, args = [], options = {}) {
+        this._ensureRunning();
+        if (!this._isolatedWorker) {
+            throw new Error('Isolated calls are disabled; initialize with isolation.enabled: true.');
+        }
+        return this._isolatedWorker.call(moduleName, functionName, args, options);
+    }
+    // Code Execution
+    /**
+     * Evaluate a Python expression.
+     */
+    async eval(expression) {
+        this._ensureRunning();
+        this._ensureUnsafeCodeAllowed('eval');
+        const result = await this._addon.evalPython(expression);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, error_translator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error('Python eval failed');
+        }
+        if (result.isObject && result.objectId) {
+            return py_proxy_1.PyProxy._createFromObjectId(result.objectId, [], this._addon, this._config.callTimeout, this._config.executionTimeout);
+        }
+        if (result.resultJson !== undefined) {
+            try {
+                return JSON.parse(result.resultJson);
+            }
+            catch {
+                return result.resultJson;
+            }
+        }
+        return null;
+    }
+    /**
+     * Execute Python statements.
+     */
+    async exec(code) {
+        this._ensureRunning();
+        this._ensureUnsafeCodeAllowed('exec');
+        const result = await this._addon.runPythonCode(code);
+        if (!result.success && result.error) {
+            throw (0, error_translator_1.translatePythonError)({
+                type: result.error.type,
+                message: result.error.message,
+                traceback: result.error.traceback || '',
+            });
+        }
+    }
+    /**
+     * Run a Python script file.
+     */
+    async runFile(filePath) {
+        this._ensureRunning();
+        this._ensureUnsafeCodeAllowed('runFile');
+        const result = await this._addon.runPythonFile(filePath);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, error_translator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error('Failed to run Python file');
+        }
+        return null;
+    }
+    // Context Management
+    /**
+     * Create an isolated Python execution context.
+     */
+    async createContext() {
+        this._ensureRunning();
+        this._ensureUnsafeCodeAllowed('createContext');
+        return py_context_1.PyContext.create(this._addon);
+    }
+    // Package Management
+    /**
+     * Install Python packages into the active environment.
+     */
+    async installPackages(packages) {
+        this._ensureRunning();
+        if (!this._config.allowPackageInstall) {
+            throw new Error('Runtime package installation is disabled; set allowPackageInstall: true.');
+        }
+        const installer = new package_installer_1.PackageInstaller({
+            pythonExecutable: this._pythonExecutable,
+            cwd: this._config.projectRoot,
+        });
+        await installer.install(packages);
+    }
+    // Memory Management
+    /**
+     * Get current memory statistics.
+     */
+    getMemoryStats() {
+        this._ensureRunning();
+        return this._addon.getMemoryStats();
+    }
+    /**
+     * Trigger Python garbage collection.
+     */
+    async collectGarbage() {
+        this._ensureRunning();
+        await this._addon.collectGarbage();
+    }
+    // Direct Addon Access
+    /**
+     * Get the underlying native addon.
+     * Advanced use only.
+     */
+    getAddon() {
+        this._ensureUnsafeCodeAllowed('getAddon');
+        return this._addon;
+    }
+    // State
+    isRunning() {
+        return this._running;
+    }
+    getConfig() {
+        return { ...this._config };
+    }
+    // Shutdown
+    /**
+     * Gracefully shut down the Python runtime.
+     * Releases all Python objects and finalizes the interpreter.
+     */
+    async shutdown() {
+        if (!this._running) {
+            return;
+        }
+        logger.info('Shutting down PyRuntime...');
+        // Stop memory monitoring
+        this._memoryMonitor.stopMonitoring();
+        await this._isolatedWorker?.close();
+        this._isolatedWorker = undefined;
+        // Finalize Python interpreter
+        try {
+            await this._addon.runPythonCode('import pynect_dispatcher as _d; _d.shutdown()');
+            await this._addon.finalizePython();
+            this._running = false;
+            logger.success('PyRuntime shut down');
+        }
+        catch (err) {
+            logger.error('Error during Python finalization', err);
+            throw err;
+        }
+    }
+    /**
+     * Synchronous shutdown (for process.on('exit') handler).
+     * Best-effort only - may not complete all cleanup.
+     */
+    shutdownSync() {
+        if (!this._running) {
+            return;
+        }
+        this._running = false;
+        this._memoryMonitor.stopMonitoring();
+        this._isolatedWorker?.closeSync();
+        this._isolatedWorker = undefined;
+        // Cannot await here - best effort
+        logger.debug('Synchronous shutdown initiated');
+    }
+    // Private Helpers
+    _ensureRunning() {
+        if (!this._running) {
+            throw new error_translator_1.PynectShutdownError('PyRuntime has been shut down. Create a new runtime with PyRuntime.create().');
+        }
+    }
+    _ensureUnsafeCodeAllowed(operation) {
+        if (!this._config.allowUnsafeCode) {
+            throw new Error(`${operation} is disabled by default; set allowUnsafeCode: true for trusted local code.`);
+        }
+    }
+    _parseBytes(str) {
+        const match = str.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)?$/i);
+        if (!match) {
+            return 1_073_741_824;
+        }
+        const value = parseFloat(match[1]);
+        const unit = (match[2] ?? 'B').toUpperCase();
+        const units = {
+            B: 1, KB: 1024, MB: 1024 ** 2, GB: 1024 ** 3, TB: 1024 ** 4,
+        };
+        return Math.floor(value * (units[unit] ?? 1));
+    }
+}
+exports.PyRuntime = PyRuntime;
+function pathsEqual(left, right) {
+    const normalize = (value) => {
+        const resolved = path_1.default.resolve(value);
+        return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+    };
+    return normalize(left) === normalize(right);
+}
+//# sourceMappingURL=py-runtime.js.map

package/dist/core/py-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-runtime.js","sourceRoot":"","sources":["../../src/core/py-runtime.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,gDAAwB;AACxB,+CAAyD;AAEzD,4CAAgD;AAGhD,yCAAqC;AACrC,2CAAuC;AACvC,6CAAyC;AACzC,uDAA6E;AAC7E,8DAA0D;AAC1D,gEAA4D;AAC5D,wDAA0D;AAC1D,oEAOoC;AACpC,uEAAuE;AACvE,4DAAwD;AACxD,4CAAyC;AACzC,gEAGmC;AAEnC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,WAAW,CAAC,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,SAAS;IACH,OAAO,CAAuB;IACvC,iBAAiB,CAAS;IACjB,cAAc,CAAS;IACvB,MAAM,CAAc;IACpB,cAAc,CAAgB;IAC9B,cAAc,CAAgB;IACvC,eAAe,CAAkB;IACjC,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACE,MAA4B,EAC5B,KAAkB,EAClB,aAAqB;QAErB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,IAAI,8BAAa,EAAE,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,8BAAa,CAAC;YACtC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAuB,EAAE;QAC3C,MAAM,gBAAgB,GAAG;YACvB,GAAG,MAAM;YACT,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU;YAC1C,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,iBAAiB;YAC/D,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,aAAa;YACnD,wBAAwB,EACtB,MAAM,CAAC,wBAAwB,IAAI,MAAM,CAAC,4BAA4B;YACxE,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;QACF,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,gBAAgB,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAA,uCAAiB,EAAC,gBAAgB,CAAC,CAAC;QACjD,IAAI,gBAAoD,CAAC;QACzD,IAAI,IAAA,yCAAmB,EAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,gBAAgB,GAAG,IAAA,gDAA0B,EAAC,IAAI,CAAC,CAAC;gBACtD,CAAC;gBAAC,MAAM,CAAC;oBACP,gBAAgB,GAAG,CAAC,MAAM,IAAA,iCAAW,EAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,gBAAgB,GAAG,IAAA,gDAA0B,EAAC,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CACb,oFAAoF;gBACpF,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,0EAA0E;QAC1E,uCAAuC;QACvC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,kCAAkB,EAAC;YACpD,iBAAiB,EAAE,OAAO,CAAC,aAAa;YACxC,aAAa,EAAE,OAAO,CAAC,SAAS;YAChC,4BAA4B,EAAE,OAAO,CAAC,wBAAwB;YAC9D,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,EAAE,OAAO,CAAC,GAA6B;SAC3C,CAAC,CAAC;QACH,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,OAAO,GAAG;gBACnE,GAAG,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,UAAU,CAAC;gBACrE,gBAAgB,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,kFAAkF;oBAClF,2BAA2B,CAC5B,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;QAChD,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC7F,MAAM,IAAI,KAAK,CACb,qEAAqE,QAAQ,CAAC,kBAAkB,GAAG,CACpG,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,cAAc,GAAiB;YACnC,GAAG,MAAM;YACT,MAAM,EAAE,QAAQ,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI,CAAC,WAAW;YAChC,WAAW,EAAE,mBAAmB;YAChC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;YAC1D,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,GAAG,EAAE,OAAO,CAAC,GAA6B;YAC1C,UAAU,EAAE;gBACV,GAAG,MAAM,CAAC,UAAU;gBACpB,OAAO,EAAE;oBACP,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;oBACrC,GAAG,IAAA,8CAAwB,EAAC,IAAI,CAAC;iBAClC;aACF;SACF,CAAC;QACF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,mBAAmB,GAAG;gBAC1B,QAAQ,CAAC,UAAU;gBACnB,QAAQ,CAAC,SAAS,CAAC,gBAAgB;gBACnC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;aAClC,CAAC;YACF,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,cAAI,CAAC,SAAS,CAAC,CAAC;YAClE,KAAK,MAAM,SAAS,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,CAAC;gBACtD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC9E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,SAAS,GAAG,cAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,sBAAa,EAAC,cAAc,CAAC,CAAC;QAE/C,gBAAgB;QAChB,eAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEzC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAErC,wBAAwB;QACxB,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,IAAA,4CAAsB,EAAC;gBAC7B,WAAW,EAAE,mBAAmB;gBAChC,gBAAgB,EAAE,QAAQ,CAAC,UAAU;gBACrC,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW;gBAC7C,aAAa,EAAE,QAAQ,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CACb,sFAAsF;gBACtF,mBAAoB,GAAa,CAAC,OAAO,EAAE,CAC5C,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/E,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;gBAC1B,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,iBAAiB;IAET,KAAK,CAAC,WAAW;QACvB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,qCAAqC;QACrC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC9D,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAE1C,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClE,IAAI,CAAC,eAAe,GAAG,IAAI,gCAAc,CAAC;gBACxC,gBAAgB;gBAChB,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;gBACrC,UAAU,EAAE,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC;gBAC3D,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;gBACvC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;gBACrB,UAAU,EAAE,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;gBAC7D,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;gBACnC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB;aAClD,CAAC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,CAAC,KAAK,CAAC,oCAAoC,gBAAgB,EAAE,CAAC,CAAC;QAErE,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACjC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE;YACzC,gBAAgB;YAChB,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC3C,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACvC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe;YACpD,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;YACrC,eAAe,EAAE;gBACf,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;gBAC1C,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe;aAChC;YACD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACrB,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB;YAC9C,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB;SAClD,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAE/C,sCAAsC;QACtC,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAErC,+BAA+B;QAC/B,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAE7C,6BAA6B;QAC7B,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,sBAAsB,OAAO,eAAe,gBAAgB,GAAG,CAAC,CAAC;IAClF,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,gCAAgC,cAAI,CAAC,OAAO,CAAC,cAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EACvC,MAAM,CACP,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,2CAA2C;YAC3C,MAAM,aAAa,GAAG;;;;;;;;;;;;;mDAauB,gBAAgB;;CAElE,CAAC;YAEI,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,gBAAgB;IAEhB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,MAAM,CAAC,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAKvD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAA,uCAAoB,EAAC;oBACzB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;oBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;oBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,GAAG,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,sCAAsC,CAAC,CAAC;QAC/E,CAAC;QAED,mBAAmB;QACnB,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,QAAkB,CAAC,CAAC;QAElF,kBAAkB;QAClB,MAAM,MAAM,GAAG,oBAAQ,CAAC,OAAO,CAC7B,MAAM,CAAC,QAAsB,EAC7B,UAAU,EACV,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,CAAC,WAAW,EACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAC9B,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,WAAW,UAAU,kBAAkB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,WAAqB;QACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,WAAW,CAAC,GAAG,CAAC,KAAK,EAAC,IAAI,EAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAU,CAAC,CACxE,CAAC;QACF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,YAAoB,EACpB,OAAkB,EAAE,EACpB,UAA+B,EAAE;QAEjC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAI,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,iBAAiB;IAEjB;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAMrD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAA,uCAAoB,EAAC;oBACzB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;oBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;oBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,OAAO,kBAAO,CAAC,mBAAmB,CAChC,MAAM,CAAC,QAAsB,EAC7B,EAAE,EACF,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,CAAC,WAAW,EACxB,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAC9B,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,MAAM,CAAC,UAAU,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAGlD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,IAAA,uCAAoB,EAAC;gBACzB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;gBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;gBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE;aACxC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAMtD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,IAAA,uCAAoB,EAAC;oBACzB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;oBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;oBAC7B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IAErB;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,sBAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,qBAAqB;IAErB;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAkB;QACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,oCAAgB,CAAC;YACrC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SAC9B,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpC,CAAC;IAED,oBAAoB;IAEpB;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAED,sBAAsB;IAEtB;;;OAGG;IACH,QAAQ;QACN,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ;IAER,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,WAAW;IAEX;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAA,OAAO;QAAA,CAAC;QAE7B,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC1C,yBAAyB;QACzB,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;QAErC,MAAM,IAAI,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QAEjC,8BAA8B;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAC7B,+CAA+C,CAChD,CAAC;YACF,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACtD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAA,OAAO;QAAA,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,EAAE,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,kCAAkC;QAClC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjD,CAAC;IAED,kBAAkB;IAEV,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,sCAAmB,CAC3B,6EAA6E,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,wBAAwB,CAAC,SAAiB;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,4EAA4E,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAW;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;YAAA,OAAO,aAAa,CAAC;QAAA,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,KAAK,GAA2B;YACpC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC;SAC5D,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;CACF;AAnlBD,8BAmlBC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa;IAC7C,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;QAC1C,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,CAAC,CAAC;IACF,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/env/executables.d.ts

@@ -0,0 +1,3 @@
+export declare function isPythonModuleName(value: string): boolean;
+export declare function assertPythonPackageSpec(spec: string): void;
+//# sourceMappingURL=executables.d.ts.map

package/dist/env/executables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executables.d.ts","sourceRoot":"","sources":["../../src/env/executables.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1D"}