diff --git a/packages/plugin/src/remote-directory-browser.ts b/packages/plugin/src/remote-directory-browser.ts new file mode 100644 index 0000000..3dc779e --- /dev/null +++ b/packages/plugin/src/remote-directory-browser.ts @@ -0,0 +1,72 @@ +import { mkdir, readdir, stat } from 'node:fs/promises' +import { homedir, platform } from 'node:os' +import { basename, dirname, isAbsolute, parse, resolve } from 'node:path' +import { RpcError } from './safe-error.js' + +interface DirectoryEntry { name: string; path: string; hidden: boolean } +export interface DirectoryListing { + path: string + home: string + crumbs: DirectoryEntry[] + entries: DirectoryEntry[] + truncated: boolean +} + +const MAX_ENTRIES = 500 + +/** + * Native Harness `workspace/create` realpath's the folder and fails with ENOENT + * when parent directories are missing. Create them on the Host before forwarding. + * Only absolute, non-root paths are accepted. + */ +export async function ensureHostWorkspaceDirectory(path: string | undefined): Promise { + if (typeof path !== 'string' || path.trim() === '' || path.includes('\0') || !isAbsolute(path) + || resolve(path) === parse(path).root) { + throw new RpcError('INVALID_MESSAGE', 'Workspace path must be an absolute, non-root directory path.') + } + // Preserve the exact path forwarded to Harness, including whitespace and + // symlink/.. traversal semantics; resolve() here could create a different folder. + await mkdir(path, { recursive: true }) +} + +/** Read-only fallback used only over an authenticated Host channel when Harness has a native-only picker. */ +export async function listRemoteDirectory(path?: string, signal?: AbortSignal): Promise { + signal?.throwIfAborted() + const home = resolve(homedir()) + const target = path === undefined || path.trim() === '' ? home : resolve(path) + if (!isAbsolute(target)) throw new Error('The remote directory path must be absolute.') + const rows = await readdir(target, { withFileTypes: true }) + const directories: DirectoryEntry[] = [] + for (const row of rows) { + signal?.throwIfAborted() + const child = resolve(target, row.name) + let directory = row.isDirectory() + if (!directory && row.isSymbolicLink()) directory = await stat(child).then(value => value.isDirectory()).catch(() => false) + if (!directory) continue + directories.push({ name: row.name, path: child, hidden: platform() !== 'win32' && row.name.startsWith('.') }) + } + directories.sort((left, right) => left.name.localeCompare(right.name, undefined, { sensitivity: 'base' })) + return { + path: target, + home, + crumbs: crumbs(target), + entries: directories.slice(0, MAX_ENTRIES), + truncated: directories.length > MAX_ENTRIES, + } +} + +function crumbs(path: string): DirectoryEntry[] { + const root = parse(path).root + const result: DirectoryEntry[] = [{ name: root, path: root, hidden: false }] + const segments: string[] = [] + let current = path + while (current !== root) { + segments.unshift(basename(current)) + current = dirname(current) + } + for (const segment of segments) { + current = resolve(current, segment) + result.push({ name: segment, path: current, hidden: false }) + } + return result +}