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 { z } from 'zod'
import type { AgentType } from './agent-status-types'
import type { ProjectExecutionRuntimeResolution } from './project-execution-runtime'
export type SkillProvider = 'codex' | 'claude' | 'agent-skills'
export type SkillSourceKind = 'home' | 'repo' | 'bundled' | 'plugin'
export type DiscoveredSkill = {
id: string
name: string
description: string | null
providers: SkillProvider[]
sourceKind: SkillSourceKind
sourceLabel: string
rootPath: string
/** Retain co-owning roots during canonical-path dedup or symlinked skills lose agents. */
rootPaths?: string[]
directoryPath: string
skillFilePath: string
installed: boolean
updatedAt: number | null
}
export type SkillDiscoverySource = {
id: string
label: string
path: string
sourceKind: SkillSourceKind
providers: SkillProvider[]
/** Agent that owns this root; null is the explicit shared-skills scope. */
owner: AgentType | null
exists: boolean
/** Unavailable means unanswered, so skills are unknown rather than absent. */
skippedReason?: 'missing' | 'remote-repo' | 'unavailable'
}
export type SkillDiscoveryResult = {
skills: DiscoveredSkill[]
sources: SkillDiscoverySource[]
scannedAt: number
}
export type SkillDiscoveryTarget = {
runtime?: 'host' | 'wsl'
wslDistro?: string | null
/** Workspace path whose local .agents/.claude skill roots should be scanned. */
cwd?: string | null
/** Let the owning runtime resolve projectRuntime when a remote client cannot supply it. */
worktreeId?: string | null
projectRuntime?: ProjectExecutionRuntimeResolution
/** Bypass shared scans after known disk changes; old hosts ignore this and scan normally. */
refresh?: boolean
/** Optional inventory filter for callers that only need known installed skills. */
names?: string[]
sourceKinds?: SkillSourceKind[]
}
const ResolvedProjectRuntimeSchema = z.object({
status: z.literal('resolved'),
runtime: z.discriminatedUnion('kind', [
z.object({
kind: z.literal('local-host'),
hostPlatform: z.string(),
projectId: z.string(),
reason: z.literal('non-windows'),
cacheKey: z.string()
}),
z.object({
kind: z.literal('windows-host'),
hostPlatform: z.literal('win32'),
projectId: z.string(),
reason: z.enum(['project-override', 'global-default', 'migration-fallback']),
cacheKey: z.string()
}),
z.object({
kind: z.literal('wsl'),
hostPlatform: z.literal('wsl'),
projectId: z.string(),
distro: z.string(),
reason: z.enum(['project-override', 'global-default']),
cacheKey: z.string()
})
])
})
const RepairProjectRuntimeSchema = z.object({
status: z.literal('repair-required'),
repair: z.object({
projectId: z.string(),
preferredRuntime: z.object({ kind: z.literal('wsl'), distro: z.string().nullable() }),
reason: z.enum(['wsl-unavailable', 'wsl-distro-required', 'wsl-distro-missing']),
source: z.enum(['project-override', 'global-default']),
cacheKey: z.string()
})
})
/** Both desktop IPC and runtime RPC parse the complete discovery target here. */
export const SkillDiscoveryTargetSchema: z.ZodType<SkillDiscoveryTarget> = z.object({
runtime: z.enum(['host', 'wsl']).optional(),
wslDistro: z.string().nullable().optional(),
cwd: z.string().nullable().optional(),
worktreeId: z.string().nullable().optional(),
projectRuntime: z
.discriminatedUnion('status', [ResolvedProjectRuntimeSchema, RepairProjectRuntimeSchema])
.optional(),
refresh: z.boolean().optional(),
names: z.array(z.string().trim().min(1).max(200)).max(100).optional(),
sourceKinds: z
.array(z.enum(['home', 'repo', 'bundled', 'plugin']))
.max(4)
.optional()
})
export type SkillFrontmatterSummary = {
name: string | null
description: string | null
}