diff --git a/packages/plugin/src/local-mention-upload.ts b/packages/plugin/src/local-mention-upload.ts new file mode 100644 index 0000000..1615590 --- /dev/null +++ b/packages/plugin/src/local-mention-upload.ts @@ -0,0 +1,74 @@ +import { lstat, readFile } from 'node:fs/promises' +import { posix, win32 } from 'node:path' +import type { RemoteTypertGatewayTarget } from './typert-gateway-contract.js' + +const MAX_MENTION_BYTES = 192 * 1024 * 1024 +const LOCAL_MENTION = /(^|\s)@(?:"([^"\r\n]+)"|([^\s]+))/gu + +/** Stage client-local absolute @file mentions before the prompt crosses to a different Host. */ +export async function uploadLocalMentions( + payload: unknown, + remote: RemoteTypertGatewayTarget, + signal: AbortSignal, + platform = process.platform, + fileIO: Pick = { lstat, readFile }, +): Promise { + if (!isMentionRecord(payload) || !isMentionRecord(payload.args) || !isMentionRecord(payload.args.request)) return payload + const request = payload.args.request + if (typeof request.sessionId !== 'string' || !Array.isArray(request.content)) return payload + const content: unknown[] = [] + let uploaded = 0 + let seen = 0 + let staged = 0 + for (const block of request.content) { + if (!isMentionRecord(block) || block.type !== 'text' || typeof block.text !== 'string') { content.push(block); continue } + const matches = [...block.text.matchAll(LOCAL_MENTION)].filter(match => + (platform === 'win32' ? win32 : posix).isAbsolute(match[2] ?? match[3]!)) + if (matches.length === 0) { content.push(block); continue } + let cursor = 0 + for (const match of matches) { + signal.throwIfAborted() + const start = match.index! + (match[1]?.length ?? 0) + if (start > cursor) content.push({ ...block, text: block.text.slice(cursor, start) }) + const path = match[2] ?? match[3]! + // A path may exist on both machines. The selected remote workspace owns + // its file-reference candidates, so its exact match takes precedence. + const candidates = await remote.dispatch('fileReferences/list', { args: { + agentId: request.sessionId, query: path, + } }, signal) + if (candidates.ok && Array.isArray(candidates.value) && candidates.value.some(candidate => + isMentionRecord(candidate) && candidate.kind === 'file' && candidate.path === path)) continue + if (++seen > 4) throw new Error('Remote supports at most four absolute local file mentions per message.') + let file: Awaited> + try { file = await fileIO.lstat(path) } + catch (error) { + if (isMissingFile(error)) continue + throw error + } + if (!file.isFile() || file.isSymbolicLink() || uploaded + file.size > MAX_MENTION_BYTES) { + throw new Error('The selected local file is unavailable or exceeds the Remote transfer limit.') + } + uploaded += file.size + const data = (await fileIO.readFile(path, { signal })).toString('base64') + const result = await remote.dispatch('fileUploads/upload', { args: { + agentId: request.sessionId, request: { data, name: (platform === 'win32' ? win32 : posix).basename(path) }, + } }, signal) + if (!result.ok) throw new Error(result.error.message) + const value = result.value as { receiptId?: unknown } | undefined + if (typeof value?.receiptId !== 'string' || value.receiptId.length === 0) throw new Error('The Remote Host did not return a file receipt.') + content.push({ type: 'file', receiptId: value.receiptId }) + staged++ + cursor = match.index! + match[0].length + } + if (cursor < block.text.length) content.push({ ...block, text: block.text.slice(cursor) }) + } + return staged === 0 ? payload : { ...payload, args: { ...payload.args, request: { ...request, content } } } +} + +function isMentionRecord(value: unknown): value is Record { + return typeof value === 'object' && value !== null && !Array.isArray(value) +} + +function isMissingFile(error: unknown): boolean { + return isMentionRecord(error) && (error.code === 'ENOENT' || error.code === 'ENOTDIR') +}