diff --git a/packages/plugin/src/remote-file-download.ts b/packages/plugin/src/remote-file-download.ts new file mode 100644 index 0000000..fd324a2 --- /dev/null +++ b/packages/plugin/src/remote-file-download.ts @@ -0,0 +1,59 @@ +import { mkdir, mkdtemp, open, rm } from 'node:fs/promises' +import { homedir } from 'node:os' +import { join } from 'node:path' +import { z } from 'zod' +import type { RemoteTypertGateway } from './remote-typert-gateway.js' + +const MAX_BYTES = 50 * 1024 * 1024 +const CHUNK_BYTES = 256 * 1024 +const identity = z.object({ absolutePath: z.string().min(1), version: z.string().min(1), bytes: z.number().int().min(0).max(MAX_BYTES) }) +const chunkSchema = identity.extend({ offset: z.number().int().min(0), data: z.instanceof(Uint8Array), eof: z.boolean() }) + +/** Uses only the official scoped file carrier; never returns file bytes to model context. */ +export async function downloadRemoteFile(gateway: RemoteTypertGateway, sessionId: string, path: string, + signal: AbortSignal, assertCurrent: () => void, downloads = join(homedir(), 'Downloads')) { + const call = async (method: string, extra = {}) => { + signal.throwIfAborted() + const result = await gateway.invoke({ namespace: 'workspaceFiles', method, + args: { workspaceFileScopeId: sessionId, path, ...extra }, signal }) + signal.throwIfAborted() + assertCurrent() + return result + } + const before = identity.parse(await call('stat')) + await mkdir(downloads, { recursive: true }) + const directory = await mkdtemp(join(downloads, 'dsh-remote-')) + // Remote names are labels, never local path authority (including Windows names). + const name = (path.split(/[\\/]/).at(-1) ?? '').replace(/[^\p{L}\p{N}._-]/gu, '_').slice(0, 120) + const localPath = join(directory, !name || name === '.' || name === '..' ? 'download' : name) + try { + const file = await open(localPath, 'wx', 0o600) + try { + let offset = 0 + for (;;) { + const length = Math.min(CHUNK_BYTES, Math.max(1, before.bytes - offset)) + const chunk = chunkSchema.parse(await call('readBytes', { range: { offset, length } })) + if (chunk.absolutePath !== before.absolutePath || chunk.version !== before.version || chunk.bytes !== before.bytes + || chunk.offset !== offset || chunk.data.length > length || offset + chunk.data.length > before.bytes + || (chunk.eof ? offset + chunk.data.length !== before.bytes : chunk.data.length === 0)) { + throw new Error('REMOTE_FILE_CHANGED_OR_INVALID_CHUNK') + } + await file.writeFile(chunk.data) + offset += chunk.data.length + if (chunk.eof) break + } + const after = identity.parse(await call('stat')) + if (after.absolutePath !== before.absolutePath || after.version !== before.version || after.bytes !== before.bytes) { + throw new Error('REMOTE_FILE_CHANGED') + } + signal.throwIfAborted() + assertCurrent() + } finally { await file.close() } + signal.throwIfAborted() + assertCurrent() + return { localPath, bytes: before.bytes, status: 'downloaded' as const } + } catch (error) { + await rm(directory, { recursive: true, force: true }) + throw error + } +}