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 { cellColToStringIndex, getLineText } from './cell-geometry'
import { viewportToCell } from './viewport-cell'
import type {
TerminalDocumentLine,
TerminalDocumentScope,
TerminalInitialOscLink,
TerminalOscLinkService
} from './document-scope'
import type { ParsedFileLinkLocation } from '../../../../src/shared/file-link-location'
import { classifyTerminalOscLinkTarget } from '../../../../src/shared/terminal-osc-link-target'
export type TerminalOscLinkTarget =
| { kind: 'url'; url: string }
| { kind: 'file'; fileTap: ParsedFileLinkLocation }
// OSC 8 labels may hide the URL; probe guarded xterm internals and fall through when unavailable.
export function oscLinkService(scope: TerminalDocumentScope): TerminalOscLinkService | null {
try {
const core = scope.term && scope.term._core
if (!core) {
return null
}
return (
core._oscLinkService || (core._inputHandler && core._inputHandler._oscLinkService) || null
)
} catch {
return null
}
}
export function oscLinkAtViewportPoint(
scope: TerminalDocumentScope,
clientX: number,
clientY: number
) {
try {
const cell = viewportToCell(scope, clientX, clientY)
if (!cell) {
return null
}
const line = scope.term!.buffer.active.getLine(cell.row)
if (!line) {
return null
}
const urlId = oscLinkIdAtCell(line, cell.col)
if (!urlId) {
return initialOscLinkAtCell(scope, cell.row, cell.col)
}
const svc = oscLinkService(scope)
if (!svc || !svc.getLinkData) {
return initialOscLinkAtCell(scope, cell.row, cell.col)
}
const data = svc.getLinkData(urlId)
const uri = data && data.uri
return terminalOscLinkTarget(uri)
} catch {
return null
}
}
export function initialOscLinkAtCell(scope: TerminalDocumentScope, row: number, col: number) {
for (let i = 0; i < scope.initialOscLinks.length; i++) {
const link = scope.initialOscLinks[i]
if (!link || typeof link.uri !== 'string') {
continue
}
if (link.row < scope.initialOscLinkRowOffset) {
continue
}
const shiftedRow = link.row - scope.initialOscLinkRowOffset
if (
shiftedRow === row &&
col >= link.startCol &&
col < link.endCol &&
initialOscLinkTextStillMatches(scope, link, shiftedRow)
) {
return terminalOscLinkTarget(link.uri)
}
}
return null
}
export function terminalOscLinkTarget(uri: unknown): TerminalOscLinkTarget | null {
if (typeof uri !== 'string') {
return null
}
// The phone can't tell the host's platform; the host's resolver decides Windows and UNC paths.
const target = classifyTerminalOscLinkTarget(uri, { windowsPathsFirst: true, allowUncHost: true })
if (target?.kind === 'url') {
return target
}
const fileTap =
target?.kind === 'file-url'
? { pathText: target.target.filePath, line: target.target.line, column: target.target.column }
: target?.kind === 'path'
? { pathText: target.link.pathText, line: target.link.line, column: target.link.column }
: null
return fileTap ? { kind: 'file', fileTap } : null
}
export function captureInitialOscLinkTexts(scope: TerminalDocumentScope) {
if (!Array.isArray(scope.initialOscLinks)) {
return
}
for (let i = 0; i < scope.initialOscLinks.length; i++) {
const link = scope.initialOscLinks[i]
if (!link || typeof link.text === 'string') {
continue
}
link.text = initialOscLinkTextAtRow(scope, link, link.row)
}
}
export function initialOscLinkTextStillMatches(
scope: TerminalDocumentScope,
link: TerminalInitialOscLink,
row: number
) {
if (typeof link.text !== 'string') {
return false
}
return link.text.length > 0 && initialOscLinkTextAtRow(scope, link, row) === link.text
}
export function initialOscLinkTextAtRow(
scope: TerminalDocumentScope,
link: TerminalInitialOscLink,
row: number
) {
try {
const lineText = getLineText(scope, row)
const start = cellColToStringIndex(scope, row, link.startCol)
const end = cellColToStringIndex(scope, row, link.endCol)
return lineText.slice(start, end)
} catch {
return ''
}
}
export function oscLinkIdAtCell(line: TerminalDocumentLine, col: number) {
try {
const bufCell = line.getCell!(col)
return bufCell && bufCell.extended && bufCell.extended.urlId ? bufCell.extended.urlId : 0
} catch {
return 0
}
}