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 { PATH_EXISTENCE_BATCH_MAX } from '../path-existence-batch'
import { FILE_READ_DIR_MAX_PAGE_ENTRIES } from '../file-dir-page'
import { z } from 'zod'
import { QUICK_OPEN_REMOTE_QUERY_MAX_CODE_UNITS } from '../quick-open-path-search'
import { RUNTIME_NAVIGATION_TARGETS } from '../runtime-navigation'
import { FileOpen, WorktreeSelector } from './files-target-params'
export const FilePathsExist = WorktreeSelector.extend({
relativePaths: z.array(z.string()).max(PATH_EXISTENCE_BATCH_MAX)
})
export const FilePathSearch = WorktreeSelector.extend({
allowLegacyIncludeIgnored: z.boolean().optional(),
includeIgnored: z.boolean().optional(),
followSymlinks: z.boolean().optional(),
query: z.string().max(QUICK_OPEN_REMOTE_QUERY_MAX_CODE_UNITS).default(''),
limit: z.number().int().positive().max(32).default(16),
excludePaths: z.array(z.string()).optional(),
mode: z.literal('quick-open').optional()
})
export const ChatImageRead = WorktreeSelector.extend({ path: z.string().min(1).max(4096) })
export const ResolveTerminalPath = WorktreeSelector.extend({
pathText: z
.unknown()
.transform((v) => (typeof v === 'string' ? v : ''))
.pipe(z.string().min(1, 'Missing path text')),
terminal: z
.unknown()
.transform((v) => (typeof v === 'string' && v.length > 0 ? v : null))
.nullable()
.optional(),
cwd: z
.unknown()
.transform((v) => (typeof v === 'string' && v.length > 0 ? v : null))
.nullable()
.optional(),
crossWorkspace: z
.unknown()
.transform((v) => v === true)
.optional(),
nativeChatContext: z
.object({
tabId: z.string().min(1),
sessionId: z.string().min(1)
})
.optional()
})
// Why: absent `navigation` (phones, older CLIs) keeps the original host switch; 'caller'/'clients' open without moving it.
const FileOpenTarget = FileOpen.extend({
navigation: z.enum(RUNTIME_NAVIGATION_TARGETS).optional()
})
export const FileOpenTab = FileOpenTarget.extend({
line: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
column: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional()
}).refine((params) => params.column === undefined || params.line !== undefined, {
message: 'column requires line',
path: ['column']
})
export const FileOpenDiff = FileOpenTarget.extend({
staged: z.boolean().optional()
})
export const DocPreviewFileRead = FileOpen.extend({
entryRelativePath: z.string().min(1),
implicitRootRelativePath: z.string().nullable(),
authorizedRootRelativePaths: z.array(z.string())
})
export const FileTreePath = WorktreeSelector.extend({
followSymlinks: z.boolean().optional(),
relativePath: z
.unknown()
.transform((v) => (typeof v === 'string' ? v : ''))
.pipe(z.string())
})
/** With `after` or `limit` the reply is a `DirEntryPage`; without both it stays the bare entry array. */
export const FileDirRead = FileTreePath.extend({
after: z.object({ name: z.string().min(1).max(4096), isDirectory: z.boolean() }).optional(),
limit: z.number().int().positive().max(FILE_READ_DIR_MAX_PAGE_ENTRIES).optional()
})
export const ServerDirectoryBrowse = z.object({
path: z
.unknown()
.transform((v) => (typeof v === 'string' ? v : ''))
.pipe(z.string())
})
const FileChunkRange = {
offset: z.number().int().nonnegative(),
length: z
.number()
.int()
.positive()
.max(512 * 1024)
}
export const FileReadChunk = FileOpen.extend(FileChunkRange)
export const DocPreviewFileReadChunk = DocPreviewFileRead.extend(FileChunkRange)
export const FileSearch = WorktreeSelector.extend({
query: z
.unknown()
.transform((v) => (typeof v === 'string' ? v : ''))
.pipe(z.string().min(1, 'Missing search query')),
caseSensitive: z.boolean().optional(),
wholeWord: z.boolean().optional(),
useRegex: z.boolean().optional(),
includePattern: z.string().optional(),
excludePattern: z.string().optional(),
maxResults: z.number().int().positive().optional()
})
// Optional maxResults aligns remote callers with desktop caps; older hosts strip it and retain their defaults.
export const FileListAll = WorktreeSelector.extend({
candidatePaths: z
.array(z.string().max(64 * 1024))
.max(100)
.optional(),
includeIgnored: z.boolean().optional(),
followSymlinks: z.boolean().optional(),
excludePaths: z.array(z.string()).optional(),
maxResults: z.number().int().positive().optional()
})
export const FileUnwatch = z.object({
subscriptionId: z
.unknown()
.transform((value) => (typeof value === 'string' && value.length > 0 ? value : ''))
.pipe(z.string().min(1, 'Missing subscriptionId'))
})