better-dsh 0.3.0 → 0.3.1-a

package/lib/kernel-env-x_WkG6Fr.js

@@ -0,0 +1,76 @@
+import { existsSync } from "node:fs";
+import { delimiter, dirname, isAbsolute, join, resolve } from "node:path";
+import { execFile } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { promisify } from "node:util";
+
+//#region src/kernel-env.ts
+const exec = promisify(execFile);
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+function venvPython(dir) {
+	return join(dir, process.platform === "win32" ? "Scripts/python.exe" : "bin/python");
+}
+function activate(dir) {
+	const bin = dirname(venvPython(dir));
+	return {
+		...process.env,
+		VIRTUAL_ENV: dir,
+		PATH: [bin, process.env.PATH].filter(Boolean).join(delimiter)
+	};
+}
+function explicitPath(python, cwd) {
+	const expanded = python === "~" ? homedir() : python.startsWith("~/") ? join(homedir(), python.slice(2)) : python;
+	return isAbsolute(expanded) || /[/\\]/.test(expanded) ? resolve(cwd, expanded) : expanded;
+}
+async function probe(python, env, cwd) {
+	const { stdout } = await exec(python, ["-c", "import ast, asyncio, json, sys; assert sys.version_info >= (3, 9), \"Packaged dill checkpoints require Python >=3.9\"; print(json.dumps({\"python\": sys.executable, \"version\": sys.version.split()[0]}))"], {
+		timeout: 15e3,
+		cwd,
+		env: {
+			...env,
+			PYTHONDONTWRITEBYTECODE: "1"
+		}
+	});
+	const result = JSON.parse(stdout.trim());
+	if (!isAbsolute(result.python) || !result.version) throw new Error("Interpreter did not report an absolute executable and version");
+	return {
+		...result,
+		env
+	};
+}
+async function resolveKernelEnv(options = {}) {
+	const cwd = resolve(options.cwd ?? process.cwd());
+	if (options.python) {
+		const python = explicitPath(options.python, cwd);
+		const venv$1 = dirname(dirname(python));
+		const env = isAbsolute(python) && existsSync(join(venv$1, "pyvenv.cfg")) ? activate(venv$1) : { ...process.env };
+		try {
+			return await probe(python, env, cwd);
+		} catch (error) {
+			throw new Error(`Could not use configured Python ${JSON.stringify(options.python)}: ${error instanceof Error ? error.message : String(error)}. Configure python with a working Python >=3.9 interpreter.`);
+		}
+	}
+	const active = process.env.VIRTUAL_ENV || process.env.CONDA_PREFIX;
+	const project = [join(cwd, ".venv"), join(cwd, "venv")].find(existsSync);
+	const venv = active || project;
+	const candidates = [];
+	if (venv && existsSync(venvPython(venv))) candidates.push({
+		python: venvPython(venv),
+		env: activate(venv)
+	});
+	for (const python of ["python3", "python"]) candidates.push({
+		python,
+		env: { ...process.env }
+	});
+	const failures = [];
+	for (const candidate of candidates) try {
+		return await probe(candidate.python, candidate.env, cwd);
+	} catch (error) {
+		failures.push(`${candidate.python}: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	throw new Error(`No working Python interpreter found. Tried: ${failures.join("; ")}. Install Python >=3.9 on PATH (python3 or python), or configure python with an existing interpreter. Better does not install Python automatically.`);
+}
+
+//#endregion
+export { resolveKernelEnv as n, PACKAGE_ROOT as t };

package/lib/kernel-env.d.ts

@@ -1,80 +1,16 @@
 //#region src/kernel-env.d.ts
-/**
- * Kernel environment resolution and provisioning.
- *
- * The runtime OWNS the interpreter it spawns: it never trusts a bare
- * `python3` on the PATH, because that interpreter may lack `ipykernel`
- * (hard failure — the kernel cannot start) or `dill` (snapshot capability —
- * silently degrading to no snapshots). Instead it resolves one of two
- * environments:
- *
- * - **Explicit** — `config.python` names a real interpreter (a path, or any
- *   name other than the bare-`python3` sentinel the default/patch produce).
- *   It is probed, and a missing `ipykernel` is a loud error while a missing
- *   `dill` is a loud warning (snapshots disabled).
- * - **Managed** — no explicit interpreter: the runtime provisions a venv
- *   UNDER THE PACKAGE (`<packageRoot>/.venv-kernel`, or `config.kernelEnvDir`)
- *   with `ipykernel` + `dill`, installing it on first use when
- *   `config.kernelAutoInstall` is on. The venv lives beside the package, NOT
- *   in `/tmp` (the pre-v0.1.9 dangling-symlink failure mode), so it survives
- *   the host's tmp reaper and the process restart.
- *
- * Provisioning uses `uv` when available (fast, can fetch the pinned CPython
- * version), falling back to `python3 -m venv` + `ensurepip`. It is idempotent:
- * a complete venv is reused untouched; a partial one is repaired.
- * @module dashr/kernel-env
- */
-/** The installed package root (where `lib/` and `src/` live): the default home of the managed venv. */
 declare const PACKAGE_ROOT: string;
-/** The config value meaning "no explicit interpreter — auto-manage a venv". */
-declare const AUTO_PYTHON_SENTINEL = "python3";
-/** Preferred CPython version for a managed venv. */
-declare const DEFAULT_KERNEL_PYTHON_VERSION = "3.11";
-/** Pinned, tested `ipykernel` version (2026-09-02 tested value; upgrade = explicit change + regression). */
-declare const IPYKERNEL_VERSION = "7.3.0";
-/** Pinned, tested `dill` version. */
-declare const DILL_VERSION = "0.4.1";
 interface KernelEnv {
-  /** Absolute path to the interpreter to spawn (`-m ipykernel_launcher`). */
   python: string;
-  /** True when this runtime provisioned a venv (vs an explicit interpreter). */
-  managed: boolean;
-  /** The managed venv root, when {@link managed}. */
-  venvDir: string | undefined;
-  /** True when `dill` is importable — snapshot capability is available. */
-  dill: boolean;
-  /** True when `ipykernel` is importable (a hard requirement). */
-  ipykernel: boolean;
-  /** The interpreter's reported version, e.g. `3.11.15`. */
+  env: NodeJS.ProcessEnv;
   version: string;
 }
 interface ResolveKernelEnvOptions {
-  /** `config.python`; the bare sentinel (or absent) selects a managed venv. */
+  /** An explicit path or executable name bypasses automatic discovery. */
   python?: string;
-  /** Managed venv directory; defaults to `<packageRoot>/.venv-kernel`. */
-  venvDir?: string;
-  /** Preferred CPython version for the managed venv. */
-  pythonVersion?: string;
-  /** Provision the managed venv when missing/incomplete (default true). */
-  autoInstall?: boolean;
-  /** Logger callback (info on provisioning, warn on degraded snapshot). */
-  log?: (level: 'info' | 'warn', message: string) => void;
+  /** Session workspace, used for existing project environments and relative paths. */
+  cwd?: string;
 }
-/** Tool-cache env for uv: caches live NEXT TO the venv (plugin territory), so a read-only home can never block provisioning. */
-declare function uvToolEnv(venvDir: string): NodeJS.ProcessEnv;
-/** uv venv arguments (pure; unit-tested). */
-declare function uvVenvArgs(venvDir: string, pythonVersion: string): string[];
-/** python3 -m venv fallback arguments (pure; cache-free by construction). */
-declare function venvFallbackArgs(venvDir: string): string[];
-/** uv pip install arguments with pinned versions (pure; unit-tested). */
-declare function uvInstallArgs(python: string): string[];
-/** pip install arguments with pinned versions for the venv interpreter (pure). */
-declare function pipInstallArgs(): string[];
-/**
- * Resolve the kernel interpreter, provisioning a managed venv when no
- * explicit interpreter is configured. Throws when the resolved interpreter
- * cannot run `ipykernel`; a missing `dill` only disables snapshots (warned).
- */
 declare function resolveKernelEnv(options?: ResolveKernelEnvOptions): Promise<KernelEnv>;
 //#endregion
-export { AUTO_PYTHON_SENTINEL, DEFAULT_KERNEL_PYTHON_VERSION, DILL_VERSION, IPYKERNEL_VERSION, KernelEnv, PACKAGE_ROOT, ResolveKernelEnvOptions, pipInstallArgs, resolveKernelEnv, uvInstallArgs, uvToolEnv, uvVenvArgs, venvFallbackArgs };
+export { KernelEnv, PACKAGE_ROOT, ResolveKernelEnvOptions, resolveKernelEnv };

package/lib/kernel-env.js

@@ -1,3 +1,3 @@
-import { a as PACKAGE_ROOT, c as uvInstallArgs, d as venvFallbackArgs, i as IPYKERNEL_VERSION, l as uvToolEnv, n as DEFAULT_KERNEL_PYTHON_VERSION, o as pipInstallArgs, r as DILL_VERSION, s as resolveKernelEnv, t as AUTO_PYTHON_SENTINEL, u as uvVenvArgs } from "./kernel-env-D8UOWeji.js";
+import { n as resolveKernelEnv, t as PACKAGE_ROOT } from "./kernel-env-x_WkG6Fr.js";
 
-export { AUTO_PYTHON_SENTINEL, DEFAULT_KERNEL_PYTHON_VERSION, DILL_VERSION, IPYKERNEL_VERSION, PACKAGE_ROOT, pipInstallArgs, resolveKernelEnv, uvInstallArgs, uvToolEnv, uvVenvArgs, venvFallbackArgs };
+export { PACKAGE_ROOT, resolveKernelEnv };

package/lib/{lsp-server-registry-BXvUTBY7.js → lsp-server-registry-BcdkHROD.js}

@@ -1,3 +1,3 @@
-import { a as primaryServerForFile, c as serversForFile, i as installServer, n as findWorkspaceRoot, o as resolveCommandPath, r as installHintFor, s as serverByName, t as clearCommandProbeCache } from "./lsp-server-registry-CH9WNFFt.js";
+import { a as primaryServerForFile, c as serversForFile, i as installServer, n as findWorkspaceRoot, o as resolveCommandPath, r as installHintFor, s as serverByName, t as clearCommandProbeCache } from "./lsp-server-registry-D4VLs1Sm.js";
 
 export { clearCommandProbeCache, findWorkspaceRoot, installHintFor, installServer, primaryServerForFile, resolveCommandPath, serverByName, serversForFile };

package/lib/{lsp-server-registry-CH9WNFFt.js → lsp-server-registry-D4VLs1Sm.js}

@@ -1,5 +1,5 @@
-import * as path$1 from "node:path";
 import { accessSync, constants, existsSync, readdirSync } from "node:fs";
+import * as path$1 from "node:path";
 
 //#region src/devices/lsp/defaults.json
 var defaults_default = {

package/lib/{main-BQeFrBM1.js → main-taSMz1KX.js}

@@ -1,3 +1,3 @@
-import { _ as Browser, a as TimeoutError, b as ChromeReleaseChannel, c as computeSystemExecutablePath, d as InstalledBrowser, f as detectBrowserPlatform, g as resolveDefaultUserDataDir, h as resolveBuildId, i as Process, l as launch, m as getVersionComparator, n as uninstall, o as WEBDRIVER_BIDI_WEBSOCKET_ENDPOINT_REGEX, p as createProfile, r as CDP_WEBSOCKET_ENDPOINT_REGEX, s as computeExecutablePath, t as getInstalledBrowsers, u as Cache, v as BrowserPlatform, y as BrowserTag } from "./main-CupOhMp5.js";
+import { _ as Browser, a as TimeoutError, b as ChromeReleaseChannel, c as computeSystemExecutablePath, d as InstalledBrowser, f as detectBrowserPlatform, g as resolveDefaultUserDataDir, h as resolveBuildId, i as Process, l as launch, m as getVersionComparator, n as uninstall, o as WEBDRIVER_BIDI_WEBSOCKET_ENDPOINT_REGEX, p as createProfile, r as CDP_WEBSOCKET_ENDPOINT_REGEX, s as computeExecutablePath, t as getInstalledBrowsers, u as Cache, v as BrowserPlatform, y as BrowserTag } from "./main-uqGqYYnA.js";
 
 export { Browser, BrowserPlatform, BrowserTag, CDP_WEBSOCKET_ENDPOINT_REGEX, Cache, ChromeReleaseChannel, InstalledBrowser, Process, TimeoutError, WEBDRIVER_BIDI_WEBSOCKET_ENDPOINT_REGEX, computeExecutablePath, computeSystemExecutablePath, createProfile, detectBrowserPlatform, getInstalledBrowsers, getVersionComparator, launch, resolveBuildId, resolveDefaultUserDataDir, uninstall };

package/lib/{main-CupOhMp5.js → main-uqGqYYnA.js}

@@ -1,14 +1,16 @@
 import { createHash } from "node:crypto";
-import childProcess, { execFile, execSync, spawn, spawnSync } from "node:child_process";
-import { mkdir, readdir, unlink } from "node:fs/promises";
+import fs, { accessSync, constants, createReadStream, createWriteStream, existsSync, readFileSync } from "node:fs";
 import path from "node:path";
+import childProcess, { execFile, execSync, spawn, spawnSync } from "node:child_process";
+import * as http from "node:http";
+import readline from "node:readline";
 import { URL as URL$1, urlToHttpOptions } from "node:url";
-import fs, { accessSync, constants, existsSync, readFileSync } from "node:fs";
 import os from "node:os";
-import readline from "node:readline";
 import { debuglog, promisify } from "node:util";
+import { mkdir, readdir, symlink, unlink } from "node:fs/promises";
+import { pipeline } from "node:stream/promises";
+import { Writable } from "node:stream";
 import { EventEmitter } from "node:events";
-import * as http from "node:http";
 import * as https from "node:https";
 
 //#region node_modules/@puppeteer/browsers/lib/browser-data/types.js

package/lib/mobile/plugin.d.ts

@@ -1,5 +1,5 @@
 import { t as Schema } from "../index-DTDXUe6m.js";
-import { r as MobileConfig } from "../web-trust-Dej_RI2B.js";
+import { r as MobileConfig } from "../web-trust-C_Y6o8Z2.js";
 import { Context } from "@deepseek-ai/cordis";
 
 //#region src/mobile/plugin.d.ts

package/lib/omp-python/DILL-LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2004-2016 California Institute of Technology.
+Copyright (c) 2016-2026 The Uncertainty Quantification Foundation.
+All rights reserved.
+
+This software is available subject to the conditions and terms laid
+out below. By downloading and using this software you are agreeing
+to the following conditions.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+    - Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    - Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+    - Neither the names of the copyright holders nor the names of any of
+      the contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

package/lib/omp-python/OMP-LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+Copyright (c) 2025-2026 Can Bölük
+Copyright (c) 2026 Stencil Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.