@deepseek-ai/dsh-native-command 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -9,8 +9,8 @@
   en: 5ebca99c0488e1c8
   zh: 24b2f8f341ff648d
 /deepseek-ai-dsh-native-command/summary:
-  en: 18e2f1f3798079dd
-  zh: 6f5579374e208624
+  en: 8369dd3eb2af0781
+  zh: fa9dfd927cc8aaad
 /deepseek-ai-dsh-native-command/table-of-contents:
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
@@ -18,8 +18,8 @@
   en: aba695cba233905f
   zh: c6359da30eb8e372
 /deepseek-ai-dsh-native-command/use-this-package/running-a-command:
-  en: 3a499bda33e33102
-  zh: d01abbf863810607
+  en: 6dbc6c9bf6db34be
+  zh: 9ab16a86ca5abcc2
 /deepseek-ai-dsh-native-command/use-this-package/injecting-the-command-boundary:
   en: 987bed629737b59d
   zh: 258e30f813b0edcb
@@ -33,8 +33,8 @@
   en: a19bb4cb9f6de785
   zh: cc930d8facf1ca07
 /deepseek-ai-dsh-native-command/understand-the-implementation/what-execfile-gives-the-runner:
-  en: b16da99b2ed73bfd
-  zh: 5e806c31a6296366
+  en: ce6180ce8209db94
+  zh: 30000a1a073110e8
 /deepseek-ai-dsh-native-command/further-exploration:
   en: a3af562edb6e0385
   zh: e26e2c311c07d1c5

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-native-command` runs host executables without a shell and opens Host filesystem paths through the desktop. The command runner captures utf8 output, propagates cancellation, and hides transient Windows consoles. The path opener supports default-application and text-editor intents, browser-renderable documents, WSL translation, and desktop availability checks. It is a library, not a plugin: no `ctx`, no state, no events.
+`dsh-native-command` runs host executables without a shell and opens Host filesystem paths through the desktop. The command runner captures utf8 output, propagates cancellation, and requires explicit Windows startup visibility. The path opener supports default-application and text-editor intents, browser-renderable documents, WSL translation, and desktop availability checks. It is a library, not a plugin: no `ctx`, no state, no events.
 
 ## Table of Contents
 
@@ -34,10 +34,10 @@ import { runNativeCommand } from '@deepseek-ai/dsh-native-command'
 
 declare const script: string
 declare const signal: AbortSignal
-const { stdout, stderr } = await runNativeCommand('osascript', ['-e', script], signal)
+const { stdout, stderr } = await runNativeCommand('osascript', ['-e', script], signal, 'hidden')
 ```
 
-On exit 0 the call resolves with captured stdout and stderr. On any failure it rejects with the exit `code` and both captured streams attached, so a caller can tell a missing tool (`ENOENT`), a cancellation (`ABORT_ERR`), and a real command failure apart without re-running the command.
+On exit 0 the call resolves with captured stdout and stderr. On any failure it rejects with the exit `code` and both captured streams attached, so a caller can tell a missing tool (`ENOENT`), a cancellation (`ABORT_ERR`), and a real command failure apart without re-running the command. The required fourth argument, `window: 'hidden' | 'visible'`, controls Windows startup visibility and has no effect on other platforms. Background commands pass `'hidden'`; GUI launchers pass `'visible'`. The path opener selects `'visible'` for Explorer, including WSL handoffs and file selection, because hiding Explorer also hides its folder window.
 
 ### Injecting the command boundary
 
@@ -72,7 +72,7 @@ The command runner is a thin wrapper over Node's `execFile`. The path opener sel
 
 ### What execFile gives the runner
 
-`execFile` spawns the executable directly with an argv array — no shell string, no shell interpretation of the arguments. The `signal` option terminates the child when the caller's abort fires; `windowsHide` suppresses the transient console window on Windows. On a non-zero exit or spawn error, the callback attaches `code`, `stdout`, and `stderr` to the rejected error and keeps the original error as `cause`.
+`execFile` spawns the executable directly with an argv array — no shell string, no shell interpretation of the arguments. The `signal` option terminates the child when the caller's abort fires; the runner maps `window` to Node's `windowsHide` option. On a non-zero exit or spawn error, the callback attaches `code`, `stdout`, and `stderr` to the rejected error and keeps the original error as `cause`.
 
 </details>
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-library"
 
 ## 概述
 
-`dsh-native-command` 无需 shell 即可运行 Host 可执行文件，并通过桌面打开 Host 文件系统路径。命令运行器捕获 utf8 输出、传播取消，并隐藏 Windows 瞬时控制台。路径打开器支持默认应用与文本编辑器意图、浏览器可渲染文档、WSL 转换与桌面可用性检查。它是库而非插件：没有 `ctx`、无状态、不发事件。
+`dsh-native-command` 无需 shell 即可运行 Host 可执行文件，并通过桌面打开 Host 文件系统路径。命令运行器捕获 utf8 输出、传播取消，并要求显式指定 Windows 启动时的窗口可见性。路径打开器支持默认应用与文本编辑器意图、浏览器可渲染文档、WSL 转换与桌面可用性检查。它是库而非插件：没有 `ctx`、无状态、不发事件。
 
 ## 目录
 
@@ -34,10 +34,10 @@ import { runNativeCommand } from '@deepseek-ai/dsh-native-command'
 
 declare const script: string
 declare const signal: AbortSignal
-const { stdout, stderr } = await runNativeCommand('osascript', ['-e', script], signal)
+const { stdout, stderr } = await runNativeCommand('osascript', ['-e', script], signal, 'hidden')
 ```
 
-退出码为 0 时，调用解析为捕获到的 stdout 与 stderr。任何失败都会以错误拒绝，错误附带退出 `code` 与两路已捕获输出，因此调用方无需重跑命令即可区分工具缺失（`ENOENT`）、取消（`ABORT_ERR`）与真实的命令失败。
+退出码为 0 时，调用解析为捕获到的 stdout 与 stderr。任何失败都会以错误拒绝，错误附带退出 `code` 与两路已捕获输出，因此调用方无需重跑命令即可区分工具缺失（`ENOENT`）、取消（`ABORT_ERR`）与真实的命令失败。必填的第四个参数 `window: 'hidden' | 'visible'` 控制 Windows 启动时的窗口可见性，在其他平台不生效。后台命令传入 `'hidden'`，GUI 启动程序传入 `'visible'`。路径打开器为 Explorer 选择 `'visible'`，包括 WSL 转交和文件选中操作，因为隐藏 Explorer 也会隐藏它的文件夹窗口。
 
 ### 注入命令边界
 
@@ -72,7 +72,7 @@ const { stdout, stderr } = await runNativeCommand('osascript', ['-e', script], s
 
 ### execFile 给了运行器什么
 
-`execFile` 以 argv 数组直接 spawn 可执行文件——没有 shell 字符串，参数不经 shell 解释。`signal` 选项在调用方中止触发时终止子进程；`windowsHide` 在 Windows 上抑制瞬时控制台窗口。遇到非零退出或 spawn 错误时，回调把 `code`、`stdout`、`stderr` 挂到被拒绝的错误上，并保留原始错误作为 `cause`。
+`execFile` 以 argv 数组直接 spawn 可执行文件——没有 shell 字符串，参数不经 shell 解释。`signal` 选项在调用方中止触发时终止子进程；`window` 由运行器映射为 Node 的 `windowsHide` 选项。遇到非零退出或 spawn 错误时，回调把 `code`、`stdout`、`stderr` 挂到被拒绝的错误上，并保留原始错误作为 `cause`。
 
 </details>
 

package/lib/index.js

@@ -9,17 +9,19 @@ import { mkdtemp, readFile, readdir, rm, stat, writeFile } from "node:fs/promise
 * @module @deepseek-ai/dsh-native-command/runner
 */
 /**
-* Run a host command with utf8 stdio, abort propagation, and Windows hide.
+* Run a host command with utf8 stdio, abort propagation, and explicit GUI visibility.
 * @param command - executable path or PATH name.
 * @param args - argv (never a shell string).
 * @param signal - caller/connection lifetime; abort terminates the child.
+* @param window - Windows startup visibility: `hidden` for background commands,
+* `visible` for GUI launchers. Ignored on other platforms.
 * @returns captured stdout/stderr on exit 0.
 */
-const runNativeCommand = (command, args, signal) => new Promise((resolve, reject) => {
+const runNativeCommand = (command, args, signal, window) => new Promise((resolve, reject) => {
 	execFile(command, [...args], {
 		encoding: "utf8",
 		signal,
-		windowsHide: true
+		windowsHide: window === "hidden"
 	}, (error, stdout, stderr) => {
 		if (error !== null) {
 			reject(Object.assign(new Error(error.message, { cause: error }), {
@@ -77,7 +79,7 @@ async function openInBrowser(path, signal, platform, run, env) {
 	if (platform === "darwin") {
 		let bundle;
 		try {
-			const { stdout } = await run("defaults", ["read", "com.apple.LaunchServices/com.apple.launchservices.secure"], signal);
+			const { stdout } = await run("defaults", ["read", "com.apple.LaunchServices/com.apple.launchservices.secure"], signal, "hidden");
 			bundle = macBundleForHttps(stdout);
 		} catch {
 			return false;
@@ -87,13 +89,13 @@ async function openInBrowser(path, signal, platform, run, env) {
 			"-b",
 			bundle,
 			path
-		], signal);
+		], signal, "hidden");
 		return true;
 	}
 	if (platform === "linux") {
 		const browser = env.BROWSER;
 		if (browser === void 0 || browser === "") return false;
-		await run(browser, [path], signal);
+		await run(browser, [path], signal, "hidden");
 		return true;
 	}
 	return false;
@@ -140,7 +142,7 @@ function explorerTarget(windowsPath) {
 */
 async function runExplorer(args, signal, run) {
 	try {
-		await run("explorer.exe", args, signal);
+		await run("explorer.exe", args, signal, "visible");
 	} catch (error) {
 		signal.throwIfAborted();
 		if (!(error instanceof Error) || !("code" in error) || error.code !== 1) throw error;
@@ -158,7 +160,7 @@ async function openWindowsPath(path, signal, run) {
 }
 /** Translate a WSL path before handing it to the Windows desktop. */
 async function openWslPath(path, signal, run) {
-	const translated = await run("wslpath", ["-w", path], signal);
+	const translated = await run("wslpath", ["-w", path], signal, "hidden");
 	signal.throwIfAborted();
 	const windowsPath = translated.stdout.replace(/[\r\n]+$/, "");
 	if (windowsPath === "") throw new Error("wslpath returned no Windows path");
@@ -172,7 +174,7 @@ async function openNativePathWithIntent(path, signal, intent, internals = {}) {
 	const wsl = platform === "linux" && isWsl(internals);
 	if (!wsl && intent === "default" && BROWSER_DOCUMENTS.has(extname(path).toLowerCase()) && await openInBrowser(path, signal, platform, run, env)) return;
 	if (platform === "darwin") {
-		await run("open", intent === "text-editor" ? ["-t", path] : [path], signal);
+		await run("open", intent === "text-editor" ? ["-t", path] : [path], signal, "hidden");
 		return;
 	}
 	if (platform === "win32") {
@@ -184,7 +186,7 @@ async function openNativePathWithIntent(path, signal, intent, internals = {}) {
 			await openWslPath(path, signal, run);
 			return;
 		}
-		await run("xdg-open", [path], signal);
+		await run("xdg-open", [path], signal, "hidden");
 		return;
 	}
 	throw new Error(`native path opener is unsupported on ${platform}`);
@@ -264,13 +266,13 @@ async function revealNativePath(path, signal, internals = {}) {
 		platform
 	});
 	if (manager === "finder") {
-		await run("open", ["-R", path], signal);
+		await run("open", ["-R", path], signal, "hidden");
 		return;
 	}
 	if (manager === "explorer") {
 		let windowsPath = path;
 		if (platform === "linux") {
-			const translated = await run("wslpath", ["-w", path], signal);
+			const translated = await run("wslpath", ["-w", path], signal, "hidden");
 			signal.throwIfAborted();
 			windowsPath = translated.stdout.replace(/[\r\n]+$/, "");
 			if (windowsPath === "") throw new Error("wslpath returned no Windows path");
@@ -279,7 +281,7 @@ async function revealNativePath(path, signal, internals = {}) {
 		return;
 	}
 	if (manager === "directory") {
-		await run("xdg-open", [dirname(path)], signal);
+		await run("xdg-open", [dirname(path)], signal, "hidden");
 		return;
 	}
 	throw new Error(`native file manager is unsupported on ${platform}`);
@@ -394,7 +396,7 @@ async function linuxFileApplications(path, signal, run, env) {
 		"-a",
 		"standard::content-type",
 		path
-	], signal);
+	], signal, "hidden");
 	const mime = /standard::content-type:\s*(\S+)/.exec(info.stdout)?.[1];
 	if (mime === void 0) throw new Error("GIO did not identify the file content type");
 	const result = await run("env", [
@@ -402,7 +404,7 @@ async function linuxFileApplications(path, signal, run, env) {
 		"gio",
 		"mime",
 		mime
-	], signal);
+	], signal, "hidden");
 	const preferred = /^Default application.*:\s*(.+\.desktop)\s*$/m.exec(result.stdout)?.[1];
 	const ids = [...new Set([...preferred === void 0 ? [] : [preferred], ...result.stdout.split(/\r?\n/).filter((line) => /^\s+.*\.desktop\s*$/.test(line)).map((line) => line.trim())])];
 	const directories = desktopDataDirectories(env.HOME ?? homedir(), env);
@@ -693,7 +695,7 @@ ${application === null ? "ConvertTo-Json -InputObject @([DshFileAssociations]::L
 			"Bypass",
 			"-File",
 			scriptPath
-		], signal)).stdout;
+		], signal, "hidden")).stdout;
 	} finally {
 		await rm(directory, {
 			recursive: true,
@@ -794,7 +796,7 @@ async function queryFileApplications(path, signal, internals, display) {
 			MAC_APPLICATIONS,
 			target.path,
 			display ? "icons" : "handlers"
-		], signal);
+		], signal, "hidden");
 		const applications = parseMacApplications(JSON.parse(stdout));
 		return display ? dedupeMacApplications(applications) : applications;
 	}
@@ -898,19 +900,19 @@ async function openNativeFileApplication(path, application, signal, internals =
 		"launch",
 		application,
 		path
-	], signal);
+	], signal, "hidden");
 	else await run("open", [
 		"-a",
 		application,
 		path
-	], signal);
+	], signal, "hidden");
 }
 /** Resolve the desktop that owns the file, including Windows applications reached from WSL. */
 async function desktopTarget(path, signal, internals) {
 	signal.throwIfAborted();
 	const platform = internals.platform ?? process.platform;
 	if (platform === "linux" && nativeFileManager(internals) === "explorer") {
-		const translated = await (internals.run ?? runNativeCommand)("wslpath", ["-w", path], signal);
+		const translated = await (internals.run ?? runNativeCommand)("wslpath", ["-w", path], signal, "hidden");
 		signal.throwIfAborted();
 		const windowsPath = translated.stdout.replace(/[\r\n]+$/, "");
 		if (windowsPath === "") throw new Error("wslpath returned no Windows path");

package/lib/types/file-applications-linux.js

@@ -36,11 +36,11 @@ async function desktopFile(root, id, directory = root) {
  * @returns registered applications with the desktop's default marked.
  */
 export async function linuxFileApplications(path, signal, run, env) {
-    const info = await run('gio', ['info', '-a', 'standard::content-type', path], signal);
+    const info = await run('gio', ['info', '-a', 'standard::content-type', path], signal, 'hidden');
     const mime = /standard::content-type:\s*(\S+)/.exec(info.stdout)?.[1];
     if (mime === undefined)
         throw new Error('GIO did not identify the file content type');
-    const result = await run('env', ['LC_ALL=C', 'gio', 'mime', mime], signal);
+    const result = await run('env', ['LC_ALL=C', 'gio', 'mime', mime], signal, 'hidden');
     const preferred = /^Default application.*:\s*(.+\.desktop)\s*$/m.exec(result.stdout)?.[1];
     const ids = [...new Set([...(preferred === undefined ? [] : [preferred]), ...result.stdout.split(/\r?\n/)
                 .filter(line => /^\s+.*\.desktop\s*$/.test(line)).map(line => line.trim())])];

package/lib/types/file-applications-windows.js

@@ -263,7 +263,7 @@ ${application === null ? 'ConvertTo-Json -InputObject @([DshFileAssociations]::L
         await writeFile(scriptPath, `\uFEFF${script}`, 'utf8');
         const result = await run('powershell.exe', [
             '-NoProfile', '-NonInteractive', '-STA', '-ExecutionPolicy', 'Bypass', '-File', scriptPath,
-        ], signal);
+        ], signal, 'hidden');
         return result.stdout;
     }
     finally {

package/lib/types/file-applications.js

@@ -64,7 +64,7 @@ async function queryFileApplications(path, signal, internals, display) {
     if (target.platform === 'linux')
         return linuxFileApplications(path, signal, run, internals.env ?? process.env);
     if (target.platform === 'darwin') {
-        const { stdout } = await run('osascript', ['-l', 'JavaScript', '-e', MAC_APPLICATIONS, target.path, display ? 'icons' : 'handlers'], signal);
+        const { stdout } = await run('osascript', ['-l', 'JavaScript', '-e', MAC_APPLICATIONS, target.path, display ? 'icons' : 'handlers'], signal, 'hidden');
         const applications = parseMacApplications(JSON.parse(stdout));
         return display ? dedupeMacApplications(applications) : applications;
     }
@@ -170,16 +170,16 @@ export async function openNativeFileApplication(path, application, signal, inter
     if (!apps.some(app => app.id === application))
         throw new Error('Application is not registered for this file');
     if (target.platform === 'linux')
-        await run('gio', ['launch', application, path], signal);
+        await run('gio', ['launch', application, path], signal, 'hidden');
     else
-        await run('open', ['-a', application, path], signal);
+        await run('open', ['-a', application, path], signal, 'hidden');
 }
 /** Resolve the desktop that owns the file, including Windows applications reached from WSL. */
 async function desktopTarget(path, signal, internals) {
     signal.throwIfAborted();
     const platform = internals.platform ?? process.platform;
     if (platform === 'linux' && nativeFileManager(internals) === 'explorer') {
-        const translated = await (internals.run ?? runNativeCommand)('wslpath', ['-w', path], signal);
+        const translated = await (internals.run ?? runNativeCommand)('wslpath', ['-w', path], signal, 'hidden');
         signal.throwIfAborted();
         const windowsPath = translated.stdout.replace(/[\r\n]+$/, '');
         if (windowsPath === '')

package/lib/types/path-opener.js

@@ -38,7 +38,7 @@ async function openInBrowser(path, signal, platform, run, env) {
     if (platform === 'darwin') {
         let bundle;
         try {
-            const { stdout } = await run('defaults', ['read', 'com.apple.LaunchServices/com.apple.launchservices.secure'], signal);
+            const { stdout } = await run('defaults', ['read', 'com.apple.LaunchServices/com.apple.launchservices.secure'], signal, 'hidden');
             bundle = macBundleForHttps(stdout);
         }
         catch {
@@ -48,7 +48,7 @@ async function openInBrowser(path, signal, platform, run, env) {
         }
         if (bundle === undefined)
             return false;
-        await run('open', ['-b', bundle, path], signal);
+        await run('open', ['-b', bundle, path], signal, 'hidden');
         return true;
     }
     if (platform === 'linux') {
@@ -57,7 +57,7 @@ async function openInBrowser(path, signal, platform, run, env) {
         const browser = env.BROWSER;
         if (browser === undefined || browser === '')
             return false;
-        await run(browser, [path], signal);
+        await run(browser, [path], signal, 'hidden');
         return true;
     }
     // Windows names no browser without reading the UserChoice registry, and its
@@ -112,7 +112,8 @@ function explorerTarget(windowsPath) {
  */
 async function runExplorer(args, signal, run) {
     try {
-        await run('explorer.exe', args, signal);
+        // SW_HIDE also hides Explorer's folder window, not just console windows.
+        await run('explorer.exe', args, signal, 'visible');
     }
     catch (error) {
         signal.throwIfAborted();
@@ -133,7 +134,7 @@ async function openWindowsPath(path, signal, run) {
 }
 /** Translate a WSL path before handing it to the Windows desktop. */
 async function openWslPath(path, signal, run) {
-    const translated = await run('wslpath', ['-w', path], signal);
+    const translated = await run('wslpath', ['-w', path], signal, 'hidden');
     signal.throwIfAborted();
     const windowsPath = translated.stdout.replace(/[\r\n]+$/, '');
     if (windowsPath === '')
@@ -150,7 +151,7 @@ async function openNativePathWithIntent(path, signal, intent, internals = {}) {
         && await openInBrowser(path, signal, platform, run, env))
         return;
     if (platform === 'darwin') {
-        await run('open', intent === 'text-editor' ? ['-t', path] : [path], signal);
+        await run('open', intent === 'text-editor' ? ['-t', path] : [path], signal, 'hidden');
         return;
     }
     if (platform === 'win32') {
@@ -162,7 +163,7 @@ async function openNativePathWithIntent(path, signal, intent, internals = {}) {
             await openWslPath(path, signal, run);
             return;
         }
-        await run('xdg-open', [path], signal);
+        await run('xdg-open', [path], signal, 'hidden');
         return;
     }
     throw new Error(`native path opener is unsupported on ${platform}`);
@@ -243,13 +244,13 @@ export async function revealNativePath(path, signal, internals = {}) {
     const run = internals.run ?? runNativeCommand;
     const manager = nativeFileManager({ ...internals, platform });
     if (manager === 'finder') {
-        await run('open', ['-R', path], signal);
+        await run('open', ['-R', path], signal, 'hidden');
         return;
     }
     if (manager === 'explorer') {
         let windowsPath = path;
         if (platform === 'linux') {
-            const translated = await run('wslpath', ['-w', path], signal);
+            const translated = await run('wslpath', ['-w', path], signal, 'hidden');
             signal.throwIfAborted();
             windowsPath = translated.stdout.replace(/[\r\n]+$/, '');
             if (windowsPath === '')
@@ -259,7 +260,7 @@ export async function revealNativePath(path, signal, internals = {}) {
         return;
     }
     if (manager === 'directory') {
-        await run('xdg-open', [dirname(path)], signal);
+        await run('xdg-open', [dirname(path)], signal, 'hidden');
         return;
     }
     throw new Error(`native file manager is unsupported on ${platform}`);

package/lib/types/runner.d.ts

@@ -3,15 +3,17 @@
  * @module @deepseek-ai/dsh-native-command/runner
  */
 /** Testable command boundary; native implementations never invoke a shell. */
-export type NativeCommandRunner = (command: string, args: readonly string[], signal: AbortSignal) => Promise<{
+export type NativeCommandRunner = (command: string, args: readonly string[], signal: AbortSignal, window: 'hidden' | 'visible') => Promise<{
     stdout: string;
     stderr: string;
 }>;
 /**
- * Run a host command with utf8 stdio, abort propagation, and Windows hide.
+ * Run a host command with utf8 stdio, abort propagation, and explicit GUI visibility.
  * @param command - executable path or PATH name.
  * @param args - argv (never a shell string).
  * @param signal - caller/connection lifetime; abort terminates the child.
+ * @param window - Windows startup visibility: `hidden` for background commands,
+ * `visible` for GUI launchers. Ignored on other platforms.
  * @returns captured stdout/stderr on exit 0.
  */
 export declare const runNativeCommand: NativeCommandRunner;

package/lib/types/runner.js

@@ -4,14 +4,16 @@
  */
 import { execFile } from 'node:child_process';
 /**
- * Run a host command with utf8 stdio, abort propagation, and Windows hide.
+ * Run a host command with utf8 stdio, abort propagation, and explicit GUI visibility.
  * @param command - executable path or PATH name.
  * @param args - argv (never a shell string).
  * @param signal - caller/connection lifetime; abort terminates the child.
+ * @param window - Windows startup visibility: `hidden` for background commands,
+ * `visible` for GUI launchers. Ignored on other platforms.
  * @returns captured stdout/stderr on exit 0.
  */
-export const runNativeCommand = (command, args, signal) => new Promise((resolve, reject) => {
-    execFile(command, [...args], { encoding: 'utf8', signal, windowsHide: true }, (error, stdout, stderr) => {
+export const runNativeCommand = (command, args, signal, window) => new Promise((resolve, reject) => {
+    execFile(command, [...args], { encoding: 'utf8', signal, windowsHide: window === 'hidden' }, (error, stdout, stderr) => {
         if (error !== null) {
             const failure = Object.assign(new Error(error.message, { cause: error }), {
                 code: error.code,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-native-command",
   "description": "Host-native command and path-opening utilities with shell-free execution, cancellation, desktop detection, and WSL handoff",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },