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 {
createMarkdownDocumentListingBudget,
retainMarkdownDocument
} from './markdown-document-listing-limits'
import { isWindowsAbsolutePathLike } from './cross-platform-path'
import { normalizeRelativePath } from './text-search-paths'
import { basename as pathBasename, extname, isAbsolute, posix, relative, resolve } from 'node:path'
import type { FileDocument, MarkdownDocument } from './filesystem-entry-types'
export function isMarkdownDocumentName(name: string): boolean {
return isMarkdownExtension(extname(name))
}
function isMarkdownExtension(extension: string): boolean {
const normalized = extension.toLowerCase()
return normalized === '.md' || normalized === '.mdx' || normalized === '.markdown'
}
function basenameFromRelativePath(relativePath: string): string {
return relativePath.slice(relativePath.lastIndexOf('/') + 1)
}
function isSafeRelativePath(relativePath: string): boolean {
return !relativePath.split('/').includes('..')
}
function rootRelativePath(rootPath: string, filePath: string): string | null {
const resolvedRoot = resolve(rootPath)
const resolvedFile = resolve(filePath)
const relativePath = relative(resolvedRoot, resolvedFile)
if (
!isSafeRelativePath(normalizeRelativePath(relativePath, rootPath)) ||
isAbsolute(relativePath)
) {
return null
}
return normalizeRelativePath(relativePath, rootPath)
}
export function fileDocumentFromFilePath(
rootPath: string,
filePath: string,
options: { outsideRootRelativePath?: 'basename' | 'relative' } = {}
): FileDocument {
const basename = pathBasename(filePath)
const extension = extname(basename)
const relativePath =
rootRelativePath(rootPath, filePath) ??
(options.outsideRootRelativePath === 'basename'
? basename
: normalizeRelativePath(relative(rootPath, filePath), rootPath))
return {
filePath,
relativePath,
basename,
name: extension ? basename.slice(0, -extension.length) : basename
}
}
export const markdownDocumentFromFilePath = fileDocumentFromFilePath
export function markdownDocumentFromRelativePath(
rootPath: string,
relativePath: string
): MarkdownDocument | null {
const normalizedRelativePath = normalizeRelativePath(relativePath, rootPath)
// Reject escaping SSH paths before constructing synthetic renderer absolute paths.
if (!isSafeRelativePath(normalizedRelativePath)) {
return null
}
const basename = basenameFromRelativePath(normalizedRelativePath)
// Remote separators are already normalized; a POSIX backslash stays part of the name.
const extension = posix.extname(basename)
if (!isMarkdownExtension(extension)) {
return null
}
const normalizedRoot = rootPath.replace(
isWindowsAbsolutePathLike(rootPath) ? /[\\/]+$/ : /\/+$/,
''
)
return {
filePath: `${normalizedRoot}/${normalizedRelativePath}`,
relativePath: normalizedRelativePath,
basename,
name: extension ? basename.slice(0, -extension.length) : basename
}
}
export function markdownDocumentsFromRelativePaths(
rootPath: string,
relativePaths: string[]
): MarkdownDocument[] {
const budget = createMarkdownDocumentListingBudget()
const documents: MarkdownDocument[] = []
for (const path of relativePaths) {
const document = markdownDocumentFromRelativePath(rootPath, path)
if (document) {
retainMarkdownDocument(budget, document)
documents.push(document)
}
}
return documents.sort((a, b) => a.relativePath.localeCompare(b.relativePath))
}