Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { describe, expect, it } from 'vitest'
import { detectTerminalFileUriLinks } from './terminal-file-uri-link'
describe('detectTerminalFileUriLinks', () => {
it('decodes a localhost-less file URI to an absolute path', () => {
const line = 'Report: file:///Users/dev/orca/report.html'
const [link] = detectTerminalFileUriLinks(line)
expect(link).toMatchObject({
pathText: '/Users/dev/orca/report.html',
line: null,
column: null
})
expect(line.slice(link.startIndex, link.endIndex)).toBe('file:///Users/dev/orca/report.html')
expect(link.displayText).toBe('file:///Users/dev/orca/report.html')
})
it('percent-decodes spaces in the path', () => {
const [link] = detectTerminalFileUriLinks('open file:///Users/dev/My%20Reports/out.html now')
expect(link.pathText).toBe('/Users/dev/My Reports/out.html')
})
it('keeps standard unescaped parentheses and apostrophes inside the path', () => {
const uri = "file:///tmp/Brennan's%20Report%20(final)"
const [link] = detectTerminalFileUriLinks(`open (${uri})`)
expect(link.pathText).toBe("/tmp/Brennan's Report (final)")
expect(link.displayText).toBe(uri)
})
it('carries a :line:col suffix', () => {
const [link] = detectTerminalFileUriLinks('file:///Users/dev/app.ts:12:3')
expect(link).toMatchObject({ pathText: '/Users/dev/app.ts', line: 12, column: 3 })
})
it('carries an #Lline anchor', () => {
const [link] = detectTerminalFileUriLinks('file:///Users/dev/app.ts#L42')
expect(link).toMatchObject({ pathText: '/Users/dev/app.ts', line: 42, column: null })
})
it('strips the WHATWG leading slash before a Windows drive path', () => {
const [link] = detectTerminalFileUriLinks('file:///C:/Users/dev/report.html')
expect(link.pathText).toBe('C:/Users/dev/report.html')
})
it('trims trailing sentence punctuation but keeps the extension', () => {
const [link] = detectTerminalFileUriLinks('see file:///tmp/out.html.')
expect(link.displayText).toBe('file:///tmp/out.html')
expect(link.pathText).toBe('/tmp/out.html')
})
it('rejects remote hosts (existence probing handles the path otherwise)', () => {
expect(detectTerminalFileUriLinks('file://build-server/var/log/out.txt')).toEqual([])
})
it('ignores non-file schemes and malformed escapes', () => {
expect(detectTerminalFileUriLinks('https://example.com/x.html')).toEqual([])
expect(detectTerminalFileUriLinks('file:///tmp/%E0%A4%A.txt')).toEqual([])
})
it('finds multiple file URIs on one line', () => {
const links = detectTerminalFileUriLinks('a file:///tmp/a.txt b file:///tmp/b.txt')
expect(links.map((link) => link.pathText)).toEqual(['/tmp/a.txt', '/tmp/b.txt'])
})
it('does not expose oversized terminal tokens to filesystem probing', () => {
expect(detectTerminalFileUriLinks(`file:///tmp/${'a'.repeat(10_000)}`)).toEqual([])
})
})