@wavexzore/sandbox 0.1.0

package/README.md

@@ -0,0 +1,153 @@
+# @wavexzore/sandbox
+
+基于本地 Docker 的 OpenCode 编码沙箱插件。
+
+## 功能概述
+
+- 通过 `@opencode-ai/plugin` 注册 OpenCode 插件钩子
+- 用 Docker 后端实现替换 14 个核心工具：`bash`、`bash-stop`、`bash-output`、`bash-status`、`read`、`write`、`edit`、`multiedit`、`apply_patch`、`glob`、`grep`、`ls`、`lsp`、`get-preview-url`
+- 通过 `dockerode` 为每个 OpenCode 会话创建独立的 Docker 容器
+- 将宿主机工作目录 bind mount 到容器内
+- 在容器内执行 Shell 命令，在宿主机保留 LSP 诊断能力
+- OpenCode 会话删除时自动清理容器
+
+## 架构概览
+
+```text
+插件层               custom-tools · session-events · system-transform
+                           │
+工具层               14 个沙箱工具 (bash/read/write/edit/patch/glob/grep/ls/lsp/...)
+                           │
+核心层               session-manager ──► docker-sandbox (Sandbox 接口)
+                     shell/ · write/ · read/ · edit/ · lsp/
+                     path-map (宿主机↔容器) · project-data-storage
+                           │
+基础设施层           dockerode · tar-stream · diff · vscode-jsonrpc
+                     Docker Engine ──► bind mount (宿主机 worktree ↔ 容器 /repo)
+```
+
+关键设计要点：
+
+- **写入管线**：权限检查 → BOM 处理 → 文件上传 → 格式化 → LSP 诊断，完整链路一条龙
+- **先读后写守卫**：文件必须先被读取后才能写入（由 `readRegistry` 强制执行）
+- **9 策略编辑回退**：精确匹配 → 行首匹配 → 块锚点 → 空白忽略 → 缩进忽略 → 转义处理等
+- **LSP 懒加载**：语言服务器仅在首次访问文件时启动
+- **双轨 Git**：容器端通过 `docker exec` 执行 git 命令，宿主机端通过 `child_process` 执行
+
+## 安装
+
+在 `$HOME` 目录下运行安装命令（默认 user scope）：
+
+```bash
+npx @wavexzore/sandbox install
+```
+
+安装器会自动完成：将插件写入 OpenCode 全局配置、创建版本化存储目录、生成 bin shim 并设置 PATH。
+
+其他命令：
+
+```bash
+npx @wavexzore/sandbox install --dry-run --json   # 预览安装内容
+npx @wavexzore/sandbox doctor --json               # 诊断安装状态
+npx @wavexzore/sandbox uninstall                   # 卸载
+```
+
+## 运行要求
+
+- 本地运行的 Docker 守护进程
+- 沙箱镜像，默认为 `opencode-sandbox:latest`
+- Node.js（安装器/helper 需要）
+
+### 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `SANDBOX_IMAGE` | `opencode-sandbox:latest` | 沙箱容器使用的 Docker 镜像 |
+| `DOCKER_SOCKET` | `/var/run/docker.sock` | Docker 守护进程 socket 路径 |
+
+### 项目级配置（`.opencode/sandbox.json`）
+
+```json
+{
+  "image": "opencode-sandbox:latest",
+  "shell": {
+    "defaultTimeoutMs": 120000,
+    "maxOutputBytes": 200000,
+    "maxOutputLines": 2000,
+    "allowWorkdirOutsideProject": false
+  },
+  "lsp": {
+    "enabled": true
+  }
+}
+```
+
+## 沙箱镜像
+
+```bash
+docker build -t opencode-sandbox:latest -f packages/sandbox/Dockerfile packages/sandbox
+```
+
+默认容器项目路径为 `/home/sandbox/project`。
+
+## 宿主机 LSP
+
+工作目录通过 bind mount 挂载，因此映射文件在宿主机和容器中均可访问。插件在宿主机上运行 LSP 服务器，提供诊断和代码导航：
+
+- TypeScript/JavaScript：`typescript-language-server`
+- Go：`gopls`
+- Python：`python-lsp-server`
+
+这些是用于编辑中项目的工具，不是产品运行时模块。
+
+## 工具参考
+
+| 工具 | 说明 | 执行位置 |
+|------|------|----------|
+| `bash` | 执行 Shell 命令（前台/后台模式） | 容器 |
+| `bash-stop` | 停止后台命令 | 容器 |
+| `bash-output` | 读取后台命令输出 | 容器 |
+| `bash-status` | 查询后台命令状态 | 容器 |
+| `read` | 读取文件或目录（含二进制检测） | 容器 |
+| `write` | 覆写文件（diff + 格式化 + 诊断） | 容器 |
+| `edit` | 文本替换编辑（9 策略回退匹配） | 容器 |
+| `multiedit` | 对单个文件原子应用多个编辑 | 容器 |
+| `patch` | 应用统一补丁（add/delete/update/move） | 容器 |
+| `glob` | 按 glob 模式搜索文件 | 容器 |
+| `grep` | 按文本模式搜索文件内容 | 容器 |
+| `ls` | 列出目录内容 | 容器 |
+| `lsp` | 语言服务操作（hover/定义/引用/诊断等 14 种操作） | 宿主机 |
+| `get-preview-url` | 获取沙箱端口的预览 URL | 容器 |
+
+## 包目录结构
+
+```text
+src/
+├── index.ts                # 包入口（re-export）
+└── sandbox/
+    ├── index.ts            # 插件入口 (sandboxPlugin)
+    ├── tools.ts            # 工具工厂注册中心
+    ├── cli/                # CLI: install/uninstall/doctor/setup-path/help
+    ├── core/               # 核心层
+    │   ├── docker-sandbox.ts      # Sandbox 接口实现
+    │   ├── session-manager.ts     # 会话生命周期管理
+    │   ├── shell/                 # Shell 执行子系统
+    │   ├── write/                 # 写入管线子系统
+    │   ├── read/                  # 读取子系统
+    │   ├── edit/                  # 编辑子系统（9 策略回退）
+    │   └── lsp/                   # LSP 客户端池 + 诊断
+    ├── tools/              # 14 个工具实现
+    ├── git/                # 双轨 Git（容器 + 宿主机）
+    └── plugins/            # OpenCode 钩子（工具、事件、系统提示）
+dist/                       # 生成的 ESM（npm pack 目标）
+```
+
+## 开发
+
+```bash
+npm --workspace @wavexzore/sandbox run typecheck
+npm --workspace @wavexzore/sandbox run lint
+npm --workspace @wavexzore/sandbox test
+npm --workspace @wavexzore/sandbox run build
+npm --workspace @wavexzore/sandbox run verify
+```

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Main entry point for the OpenCode Sandbox plugin.
+ * Re-exports the default plugin from sandbox.
+ */
+export { default } from './sandbox/index.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Main entry point for the OpenCode Sandbox plugin.
+ * Re-exports the default plugin from sandbox.
+ */
+export { default } from './sandbox/index.js';

package/dist/sandbox/cli/install.d.ts

@@ -0,0 +1,5 @@
+import { type WavexzoreSandboxDoctorOptions, type WavexzoreSandboxDoctorResult, type WavexzoreSandboxInstallOptions, type WavexzoreSandboxInstallResult, type WavexzoreSandboxPathOptions, type WavexzoreSandboxPathResult, type WavexzoreSandboxUninstallOptions, type WavexzoreSandboxUninstallResult } from './types.js';
+export declare function installWavexzoreSandbox(rootInput?: string, options?: WavexzoreSandboxInstallOptions): WavexzoreSandboxInstallResult;
+export declare function uninstallWavexzoreSandbox(rootInput?: string, options?: WavexzoreSandboxUninstallOptions): WavexzoreSandboxUninstallResult;
+export declare function doctorWavexzoreSandbox(options?: WavexzoreSandboxDoctorOptions): Promise<WavexzoreSandboxDoctorResult>;
+export declare function setupWavexzoreSandboxPathCommand(options?: WavexzoreSandboxPathOptions): WavexzoreSandboxPathResult;

package/dist/sandbox/cli/install.js

@@ -0,0 +1,335 @@
+import { existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { pathToFileURL } from 'url';
+import { installOpenCodeConfig, normalizePluginEntries, readOpenCodeConfig, uninstallOpenCodeConfig, } from './opencode-config.js';
+import { isDirectoryOnPath, pathHintForPlatform, resolveOpenCodeConfigPath, resolveWavexzoreSandboxBinDir, resolveWavexzoreSandboxHomeDir, resolveWavexzoreSandboxStoreDir, runtimePlatform, } from './path.js';
+import { prepareCurrentPackageVersion, readWavexzoreSandboxManifest, removeEmptyDirectory, removePathIfExists, removeWavexzoreSandboxPath, resolveWavexzoreSandboxLoaderDir, resolveWavexzoreSandboxManifestPath, setupWavexzoreSandboxPath, nextManifest, pathToPluginFileSpec, resolveOpenCodeHelperPath, resolveWavexzoreSandboxBinShimPaths, resolveWavexzoreSandboxVersionDir, uninstallWavexzoreSandboxBinShims, writeLocalLoader, writeManifest, writeWavexzoreSandboxBinShims, } from './local-store.js';
+import { WAVEXZORE_SANDBOX_CLI, } from './types.js';
+function resolvedRoot(root) {
+    return resolve(root ?? '.');
+}
+function resolvedScope(scope) {
+    return scope ?? 'user';
+}
+function uniqueStrings(items) {
+    return Array.from(new Set(items));
+}
+export function installWavexzoreSandbox(rootInput = '.', options = {}) {
+    const root = resolvedRoot(options.root ?? rootInput);
+    const scope = resolvedScope(options.scope);
+    const platform = runtimePlatform(options.platform);
+    const homeDir = resolveWavexzoreSandboxHomeDir({
+        root,
+        scope,
+        homeDir: options.homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const storeDir = resolveWavexzoreSandboxStoreDir({
+        root,
+        scope,
+        homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const binDir = resolveWavexzoreSandboxBinDir({
+        root,
+        scope,
+        homeDir,
+        storeDir,
+        binDir: options.binDir,
+        env: options.env,
+        platform,
+    });
+    const loaderDir = resolveWavexzoreSandboxLoaderDir(storeDir);
+    const pluginEntry = pathToPluginFileSpec(loaderDir);
+    const cliPath = resolveOpenCodeHelperPath(binDir, platform);
+    const configPath = resolveOpenCodeConfigPath({
+        root,
+        scope,
+        configDir: options.configDir,
+        configPath: options.configPath,
+        env: options.env,
+        platform,
+    });
+    const manifestPath = resolveWavexzoreSandboxManifestPath(storeDir);
+    const currentManifest = existsSync(manifestPath) ? readWavexzoreSandboxManifest(storeDir) : undefined;
+    const prepared = prepareCurrentPackageVersion({
+        storeDir,
+        packageRoot: options.packageRoot,
+        dryRun: options.dryRun,
+        env: options.env,
+    });
+    const loaderStatus = writeLocalLoader(loaderDir, options.dryRun);
+    const manifest = nextManifest({
+        current: currentManifest,
+        activeVersion: prepared.version,
+        configPath,
+        pluginSpec: pluginEntry,
+        cliPath,
+        channel: options.channel,
+    });
+    const manifestStatus = writeManifest(manifestPath, manifest, options.dryRun);
+    const config = installOpenCodeConfig({ configPath, pluginEntry, dryRun: options.dryRun });
+    const installBin = options.installBin !== false;
+    const bin = writeWavexzoreSandboxBinShims({
+        binDir,
+        storeDir,
+        dryRun: options.dryRun,
+        enabled: installBin,
+        platform: options.platform,
+    });
+    const path = !installBin
+        ? { pathStatus: 'skipped', pathHint: pathHintForPlatform(binDir, platform), pathConfigPath: undefined }
+        : options.setupPath
+            ? setupWavexzoreSandboxPath({
+                root,
+                scope,
+                homeDir,
+                storeDir,
+                binDir,
+                dryRun: options.dryRun,
+                envPath: options.envPath,
+                pathConfigPath: options.pathConfigPath,
+                platform,
+                shell: options.shell,
+                env: options.env,
+            })
+            : {
+                pathStatus: isDirectoryOnPath(binDir, options.envPath, platform)
+                    ? 'present'
+                    : 'missing',
+                pathHint: pathHintForPlatform(binDir, platform),
+                pathConfigPath: undefined,
+            };
+    return {
+        root,
+        dryRun: options.dryRun === true,
+        scope,
+        homeDir,
+        storeDir,
+        binDir,
+        cliPath,
+        binStatus: bin.binStatus,
+        pathStatus: path.pathStatus,
+        pathConfigPath: path.pathConfigPath,
+        pathHint: path.pathHint,
+        manifestPath,
+        manifestStatus,
+        loaderDir,
+        loaderStatus,
+        activeVersion: prepared.version,
+        versionPath: prepared.versionPath,
+        versionStatus: prepared.versionStatus,
+        configPath,
+        configStatus: config.configStatus,
+        pluginStatus: config.pluginStatus,
+        removedPluginEntries: uniqueStrings(config.removedPluginEntries),
+        pluginEntry,
+    };
+}
+export function uninstallWavexzoreSandbox(rootInput = '.', options = {}) {
+    const root = resolvedRoot(options.root ?? rootInput);
+    const scope = resolvedScope(options.scope);
+    const platform = runtimePlatform(options.platform);
+    const homeDir = resolveWavexzoreSandboxHomeDir({
+        root,
+        scope,
+        homeDir: options.homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const storeDir = resolveWavexzoreSandboxStoreDir({
+        root,
+        scope,
+        homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const binDir = resolveWavexzoreSandboxBinDir({
+        root,
+        scope,
+        homeDir,
+        storeDir,
+        binDir: options.binDir,
+        env: options.env,
+        platform,
+    });
+    const loaderDir = resolveWavexzoreSandboxLoaderDir(storeDir);
+    const pluginEntry = pathToPluginFileSpec(loaderDir);
+    const configPath = resolveOpenCodeConfigPath({
+        root,
+        scope,
+        configDir: options.configDir,
+        configPath: options.configPath,
+        env: options.env,
+        platform,
+    });
+    const manifestPath = resolveWavexzoreSandboxManifestPath(storeDir);
+    const config = uninstallOpenCodeConfig({
+        configPath,
+        pluginEntry,
+        dryRun: options.dryRun,
+        keepConfig: options.keepConfig,
+    });
+    const storeStatus = options.keepStore ? 'kept' : removePathIfExists(storeDir, options.dryRun);
+    const bin = uninstallWavexzoreSandboxBinShims({ binDir, dryRun: options.dryRun, keepBin: options.keepBin });
+    const path = options.removePath
+        ? removeWavexzoreSandboxPath({
+            root,
+            scope,
+            homeDir,
+            storeDir,
+            binDir,
+            dryRun: options.dryRun,
+            envPath: options.envPath,
+            pathConfigPath: options.pathConfigPath,
+            platform: options.platform,
+            shell: options.shell,
+            env: options.env,
+        })
+        : {
+            pathStatus: 'kept',
+            pathConfigPath: undefined,
+            pathHint: pathHintForPlatform(binDir, platform),
+            homeDir,
+            binDir,
+        };
+    if (!options.keepBin)
+        removeEmptyDirectory(binDir, options.dryRun);
+    if (!options.keepStore && !options.keepBin)
+        removeEmptyDirectory(homeDir, options.dryRun);
+    return {
+        root,
+        dryRun: options.dryRun === true,
+        scope,
+        homeDir,
+        storeDir,
+        binDir,
+        binStatus: bin.binStatus,
+        pathStatus: path.pathStatus,
+        pathConfigPath: path.pathConfigPath,
+        storeStatus,
+        manifestPath,
+        configPath,
+        configStatus: config.configStatus,
+        pluginEntry,
+        removedPluginEntries: uniqueStrings(config.removedPluginEntries),
+    };
+}
+function check(name, status, message, path) {
+    return { name, status, message, path };
+}
+async function canImport(path) {
+    try {
+        await import(pathToFileURL(path).href);
+        return { ok: true, message: 'import succeeded' };
+    }
+    catch (error) {
+        return { ok: false, message: error instanceof Error ? error.message : String(error) };
+    }
+}
+function configContainsPlugin(configPath, pluginEntry) {
+    if (!existsSync(configPath))
+        return false;
+    const config = readOpenCodeConfig(configPath);
+    return normalizePluginEntries(config.plugin).some((item) => {
+        if (typeof item === 'string')
+            return item === pluginEntry;
+        if (Array.isArray(item) && item[0] === pluginEntry)
+            return true;
+        if (item && typeof item === 'object' && item.name === pluginEntry)
+            return true;
+        return false;
+    });
+}
+export async function doctorWavexzoreSandbox(options = {}) {
+    const root = resolvedRoot(options.root ?? options.projectRoot ?? '.');
+    const scope = resolvedScope(options.scope);
+    const platform = runtimePlatform(options.platform);
+    const homeDir = resolveWavexzoreSandboxHomeDir({
+        root,
+        scope,
+        homeDir: options.homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const storeDir = resolveWavexzoreSandboxStoreDir({
+        root,
+        scope,
+        homeDir,
+        storeDir: options.storeDir,
+        env: options.env,
+        platform,
+    });
+    const binDir = resolveWavexzoreSandboxBinDir({
+        root,
+        scope,
+        homeDir,
+        storeDir,
+        binDir: options.binDir,
+        env: options.env,
+        platform,
+    });
+    const configPath = resolveOpenCodeConfigPath({
+        root,
+        scope,
+        configDir: options.configDir,
+        configPath: options.configPath,
+        env: options.env,
+        platform,
+    });
+    const loaderDir = resolveWavexzoreSandboxLoaderDir(storeDir);
+    const pluginEntry = pathToPluginFileSpec(loaderDir);
+    const cliPath = resolveOpenCodeHelperPath(binDir, platform);
+    const manifestPath = resolveWavexzoreSandboxManifestPath(storeDir);
+    const checks = [];
+    checks.push(check('config', existsSync(configPath) ? 'passed' : 'failed', existsSync(configPath) ? 'OpenCode config exists' : 'OpenCode config is missing', configPath));
+    checks.push(check('config-plugin', configContainsPlugin(configPath, pluginEntry) ? 'passed' : 'failed', configContainsPlugin(configPath, pluginEntry)
+        ? 'OpenCode config references the local loader'
+        : 'OpenCode config does not reference the local loader', configPath));
+    checks.push(check('loader', existsSync(join(loaderDir, 'index.mjs')) ? 'passed' : 'failed', existsSync(join(loaderDir, 'index.mjs')) ? 'local loader exists' : 'local loader is missing', loaderDir));
+    let activeVersion;
+    try {
+        const manifest = readWavexzoreSandboxManifest(storeDir);
+        activeVersion = manifest?.activeVersion;
+        checks.push(check('manifest', manifest ? 'passed' : 'failed', manifest ? `active version ${manifest.activeVersion}` : 'manifest is missing', manifestPath));
+    }
+    catch (error) {
+        checks.push(check('manifest', 'failed', error instanceof Error ? error.message : String(error), manifestPath));
+    }
+    if (activeVersion) {
+        const pluginJs = join(resolveWavexzoreSandboxVersionDir(storeDir, activeVersion), 'dist', 'index.js');
+        const cliJs = join(resolveWavexzoreSandboxVersionDir(storeDir, activeVersion), 'dist', 'sandbox', 'cli', `${WAVEXZORE_SANDBOX_CLI}.js`);
+        checks.push(check('plugin-entry', existsSync(pluginJs) ? 'passed' : 'failed', existsSync(pluginJs) ? 'plugin entry exists' : 'plugin entry is missing', pluginJs));
+        checks.push(check('cli-entry', existsSync(cliJs) ? 'passed' : 'failed', existsSync(cliJs) ? 'CLI entry exists' : 'CLI entry is missing', cliJs));
+        if (existsSync(join(loaderDir, 'index.mjs'))) {
+            const imported = await canImport(join(loaderDir, 'index.mjs'));
+            checks.push(check('loader-import', imported.ok ? 'passed' : 'failed', imported.message, join(loaderDir, 'index.mjs')));
+        }
+    }
+    const shims = resolveWavexzoreSandboxBinShimPaths(binDir);
+    checks.push(check('bin', existsSync(shims.js) && existsSync(shims.unix) ? 'passed' : 'failed', existsSync(shims.js) && existsSync(shims.unix) ? 'bin shims exist' : 'bin shims are missing', binDir));
+    checks.push(check('opencode-helper', existsSync(cliPath) ? 'passed' : 'failed', existsSync(cliPath) ? `OpenCode helper exists at ${cliPath}` : `OpenCode helper is missing at ${cliPath}`, cliPath));
+    return {
+        status: checks.every((item) => item.status === 'passed') ? 'passed' : 'failed',
+        homeDir,
+        storeDir,
+        binDir,
+        cliPath,
+        configPath,
+        pluginEntry,
+        activeVersion,
+        checks,
+    };
+}
+export function setupWavexzoreSandboxPathCommand(options = {}) {
+    const root = resolvedRoot(options.root ?? '.');
+    const scope = resolvedScope(options.scope);
+    return setupWavexzoreSandboxPath({ ...options, root, scope });
+}

package/dist/sandbox/cli/local-store.d.ts

@@ -0,0 +1,87 @@
+import { type BinStatus, type InstallStatus, type RuntimeEnv, type WavexzoreSandboxManifest, type WavexzoreSandboxPathResult, type StoreScope, type UninstallStatus } from './types.js';
+export declare function nowIso(now?: number): string;
+export declare function writeFileAtomic(path: string, contents: string, dryRun?: boolean): void;
+export declare function writeJsonAtomic(path: string, value: unknown, dryRun?: boolean): void;
+export declare function statusForText(path: string, desired: string): InstallStatus;
+export declare function assertSafeVersion(version: string): void;
+export declare function resolveWavexzoreSandboxManifestPath(storeDir: string): string;
+export declare function resolveWavexzoreSandboxLoaderDir(storeDir: string): string;
+export declare function resolveWavexzoreSandboxVersionDir(storeDir: string, version: string): string;
+export declare function pathToPluginFileSpec(loaderDir: string): string;
+export declare function resolveWavexzoreSandboxBinShimPaths(binDir: string): {
+    js: string;
+    unix: string;
+    cmd: string;
+};
+export declare function resolveOpenCodeHelperPath(binDir: string, platform?: string): string;
+export declare function resolveCurrentPackageRoot(explicit?: string, env?: RuntimeEnv): string;
+export declare function readCurrentPackageVersion(packageRoot?: string): string;
+export declare function prepareCurrentPackageVersion(args: {
+    storeDir: string;
+    packageRoot?: string;
+    dryRun?: boolean;
+    env?: RuntimeEnv;
+}): {
+    version: string;
+    versionPath: string;
+    versionStatus: InstallStatus;
+};
+export declare function writeLocalLoader(loaderDir: string, dryRun?: boolean): InstallStatus;
+export declare function readWavexzoreSandboxManifest(storeDir: string): WavexzoreSandboxManifest | undefined;
+export declare function nextManifest(args: {
+    current?: WavexzoreSandboxManifest;
+    activeVersion: string;
+    configPath: string;
+    pluginSpec: string;
+    cliPath: string;
+    channel?: string;
+    now?: number;
+}): WavexzoreSandboxManifest;
+export declare function writeManifest(manifestPath: string, manifest: WavexzoreSandboxManifest, dryRun?: boolean): InstallStatus;
+export declare function writeWavexzoreSandboxBinShims(args: {
+    binDir: string;
+    storeDir: string;
+    dryRun?: boolean;
+    enabled?: boolean;
+    platform?: string;
+}): {
+    binDir: string;
+    binStatus: BinStatus;
+};
+export declare function uninstallWavexzoreSandboxBinShims(args: {
+    binDir: string;
+    dryRun?: boolean;
+    keepBin?: boolean;
+}): {
+    binDir: string;
+    binStatus: UninstallStatus;
+};
+export declare function removePathIfExists(path: string, dryRun?: boolean): UninstallStatus;
+export declare function removeEmptyDirectory(path: string, dryRun?: boolean): void;
+export declare function setupWavexzoreSandboxPath(options?: {
+    root?: string;
+    scope?: StoreScope;
+    homeDir?: string;
+    storeDir?: string;
+    binDir?: string;
+    dryRun?: boolean;
+    envPath?: string;
+    pathConfigPath?: string;
+    platform?: string;
+    shell?: string;
+    env?: RuntimeEnv;
+}): WavexzoreSandboxPathResult;
+export declare function removeWavexzoreSandboxPath(options?: {
+    root?: string;
+    scope?: StoreScope;
+    homeDir?: string;
+    storeDir?: string;
+    binDir?: string;
+    dryRun?: boolean;
+    envPath?: string;
+    pathConfigPath?: string;
+    platform?: string;
+    shell?: string;
+    env?: RuntimeEnv;
+}): WavexzoreSandboxPathResult;
+export declare function relativeWithin(root: string, target: string): string;