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 { FEATURE_WALL_EXIT_ACTIONS, FEATURE_WALL_TOUR_DEPTH_STEPS } from './feature-wall-tour-depth'
import { SETUP_SCRIPT_IMPORT_PROVIDERS } from './setup-script-import-providers'
import { WORKSPACE_SOURCE_VALUES, type WorkspaceSource } from './workspace-source'
import type { GlobalSettings } from './global-settings-types'
// Wire names use product names (claude-code for the claude CLI); tuiAgentToAgentKind maps unknowns to other.
export const AGENT_KIND_VALUES = [
'claude-code',
'claude-agent-teams',
'codebuddy',
'openclaude',
'codex',
'autohand',
'opencode',
'opencode2',
'mimo-code',
'pi',
'omp',
'prime-agent',
'qoder',
'qoder-cn',
'gemini',
'antigravity',
'aider',
'goose',
'amp',
'kilo',
'kiro',
'crush',
'aug',
'cline',
'codebuff',
'freebuff',
'command-code',
'continue',
'cursor',
'droid',
'kimi',
'mistral-vibe',
'qwen-code',
'rovo',
'hermes',
'openclaw',
'copilot',
'grok',
'devin',
'ante',
'jcode',
'trae',
'muse',
'dsh',
'zcode',
'other'
] as const
export const agentKindSchema = z.enum(AGENT_KIND_VALUES)
export type AgentKind = z.infer<typeof agentKindSchema>
// Only launch failures are observable; provider auth/rate-limit/network errors remain inside the CLI subprocess.
export const errorClassSchema = z.enum(['binary_not_found', 'paste_readiness_timeout', 'unknown'])
export type ErrorClass = z.infer<typeof errorClassSchema>
export const repoMethodSchema = z.enum(['folder_picker', 'clone_url', 'drag_drop'])
export type RepoMethod = z.infer<typeof repoMethodSchema>
// Historical setup-step choices (current flows skip that screen); kept for pre-rollout rows and compatibility.
export const addRepoSetupStepActionSchema = z.enum([
'open_primary',
'create_worktree',
'configure',
'skip',
'open_existing',
'back'
])
export const addRepoExistingWorkspaceSourceSchema = z.enum([
'local_folder_picker',
'runtime_server_path',
'ssh_remote_path',
'clone_url',
'create_project'
])
export type AddRepoExistingWorkspaceSource = z.infer<typeof addRepoExistingWorkspaceSourceSchema>
export const addRepoDefaultCheckoutHandoffSourceSchema = z.enum([
'local_folder_picker',
'runtime_server_path',
'ssh_remote_path',
'clone_url',
'create_project',
'onboarding_open_folder',
'onboarding_clone_url',
'project_added_compat'
])
export type AddRepoDefaultCheckoutHandoffSource = z.infer<
typeof addRepoDefaultCheckoutHandoffSourceSchema
>
export const addRepoDefaultCheckoutHandoffResultSchema = z.enum([
'opened_default_checkout',
'revealed_project'
])
export const addRepoDefaultCheckoutHandoffReasonSchema = z.enum([
'loaded_default_checkout',
'detected_default_checkout',
'no_authoritative_detection',
'no_default_checkout',
'show_detected_default_failed',
'show_detected_linked_failed',
'authoritative_refresh_failed',
'linked_external_refresh_failed',
'refreshed_default_missing'
])
export const setupScriptImportProviderSchema = z.enum(SETUP_SCRIPT_IMPORT_PROVIDERS)
// Keep workspace-create failures separate from agent launch failures so their enums can evolve independently.
export const workspaceCreateErrorClassSchema = z.enum([
'git_failed',
'path_collision',
'permission_denied',
'base_ref_missing',
'unknown'
])
export type WorkspaceCreateErrorClass = z.infer<typeof workspaceCreateErrorClassSchema>
export const workspaceSourceSchema = z.enum(WORKSPACE_SOURCE_VALUES)
export type { WorkspaceSource }
export const launchSourceSchema = z.enum([
'command_palette',
'sidebar',
'quick_command',
'tab_bar_quick_launch',
'task_page',
'new_workspace_composer',
'workspace_jump_palette',
'shortcut',
'onboarding',
'diff_notes_send',
'notes_send',
'conflict_resolution',
'source_control_recovery',
'terminal_context_menu',
'native_chat',
'explain_commit',
// Launches the host performs for a caller outside the desktop app.
'cli',
'mobile',
'orchestration',
'unknown'
])
export type LaunchSource = z.infer<typeof launchSourceSchema>
export const requestKindSchema = z.enum(['new', 'resume', 'followup'])
export type RequestKind = z.infer<typeof requestKindSchema>
export const featureWallTileIdSchema = z.enum([
'tile-01',
'tile-02',
'tile-03',
'tile-04',
'tile-05',
'tile-06',
'tile-07',
'tile-08',
'tile-09',
'tile-10',
'tile-11',
'tile-12'
])
export const featureWallOpenSourceSchema = z.enum(['help_menu', 'popup', 'onboarding', 'unknown'])
export type FeatureWallOpenSourceTelemetry = z.infer<typeof featureWallOpenSourceSchema>
export const featureWallWorkflowIdSchema = z.enum([
'tasks',
'workspaces',
'agents-orchestration',
'workbench',
'review'
])
export const featureWallTourDepthStepSchema = z.enum(FEATURE_WALL_TOUR_DEPTH_STEPS)
export const featureWallExitActionSchema = z.enum(FEATURE_WALL_EXIT_ACTIONS)
// Env/CI consent overrides emit no opt event; fresh installs have no first-launch surface and opt out through settings.
export const optInViaSchema = z.enum(['first_launch_banner', 'settings'])
export type OptInVia = z.infer<typeof optInViaSchema>
// Exclude build-time orca_channel and the opt-in toggle, which has dedicated events.
export type BooleanGlobalSettingsKey = {
// Legacy-compatible optional toggles become booleans after defaulting.
[Key in keyof GlobalSettings]-?: NonNullable<GlobalSettings[Key]> extends boolean ? Key : never
}[keyof GlobalSettings]
export const SETTINGS_CHANGED_WHITELIST = [
'editorAutoSave',
'openLinksInApp',
'openLinksInAppModifierInverts',
'openLinksInAppInBackground',
'terminalLinkActionPopoverEnabled',
'experimentalMobile',
'experimentalPet',
'experimentalNativeChat',
'experimentalBrowserExtensions',
'experimentalActivity',
'experimentalAgentDashboardPopout',
'experimentalTerminalAttention',
'experimentalAgentHibernation',
'experimentalEphemeralVms',
'experimentalConnectors',
'geminiCliOAuthEnabled'
] as const satisfies readonly BooleanGlobalSettingsKey[]
export const settingsChangedKeySchema = z.enum(SETTINGS_CHANGED_WHITELIST)
export type SettingsChangedKey = z.infer<typeof settingsChangedKeySchema>