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 { randomUUID } from 'node:crypto'
import {
chmodSync,
existsSync,
lstatSync,
mkdirSync,
readlinkSync,
realpathSync,
statSync,
unlinkSync,
writeFileSync
} from 'node:fs'
import { basename, dirname, join, resolve } from 'node:path'
import { renameFileWithWindowsRetry } from './windows-retry-file-operations'
function isEnoentError(error: unknown): boolean {
return error instanceof Error && 'code' in error && error.code === 'ENOENT'
}
// Why: atomic rename on a dotfiles symlink replaces the link itself; resolving canonical target updates the real repo file.
export function resolveCanonicalPluginWritePath(pluginPath: string): string {
try {
const stat = lstatSync(pluginPath)
if (!stat.isSymbolicLink()) {
return pluginPath
}
} catch (error) {
if (isEnoentError(error)) {
return pluginPath
}
throw error
}
// Resolve existing symlinks via realpath; follow dangling readlink chains so atomic writes create the intended target without replacing the link.
try {
return realpathSync.native(pluginPath)
} catch (error) {
if (!isEnoentError(error)) {
throw error
}
}
const visited = new Set<string>([pluginPath])
let current = pluginPath
for (let depth = 0; depth < 40; depth++) {
try {
const link = readlinkSync(current)
current = resolve(dirname(current), link)
if (visited.has(current)) {
throw new Error(`Symbolic link loop detected resolving "${pluginPath}"`)
}
visited.add(current)
const nextStat = lstatSync(current)
if (!nextStat.isSymbolicLink()) {
return current
}
} catch (error) {
if (isEnoentError(error)) {
return current
}
throw error
}
}
throw new Error(`Too many levels of symbolic links resolving "${pluginPath}"`)
}
// Sibling-temp rename prevents reloads from seeing partial or missing plugin files.
function writeAtomicFile(targetPath: string, content: string): void {
const dir = dirname(targetPath)
mkdirSync(dir, { recursive: true })
let existingMode: number | undefined
try {
existingMode = statSync(targetPath).mode & 0o777
} catch {}
const tmpPath = join(dir, `.${basename(targetPath)}.${process.pid}.${randomUUID()}.tmp`)
try {
writeFileSync(tmpPath, content, { encoding: 'utf8', mode: existingMode })
if (existingMode !== undefined) {
chmodSync(tmpPath, existingMode)
}
renameFileWithWindowsRetry(tmpPath, targetPath)
} finally {
if (existsSync(tmpPath)) {
try {
unlinkSync(tmpPath)
} catch {}
}
}
}
// Atomically replace the canonical target, preserving dotfile symlinks.
export function writeCanonicalOpenCodePluginAtomically(pluginPath: string, source: string): void {
const targetPath = resolveCanonicalPluginWritePath(pluginPath)
writeAtomicFile(targetPath, source)
}
// Replace overlay links themselves; never follow them into user configuration.
export function writeOverlayOpenCodePluginAtomically(pluginPath: string, source: string): void {
writeAtomicFile(pluginPath, source)
}