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 { agentChatPermissionModes } from './agent-chat-permission-support'
import type { AgentChatPermissionMode } from './agent-chat-permission-mode'
import { isTuiAgent, TUI_AGENT_CONFIG } from './tui-agent-config'
import {
AUTO_TUI_AGENT_ARGS,
YOLO_TUI_AGENT_ARGS,
YOLO_TUI_AGENT_ENV
} from './tui-agent-permissions'
import type { TuiAgent } from './tui-agent'
/** Persisted values must remain stable; own adds no permission flag and uses the agent’s config, while other choices share chat modes. */
export type AgentPermissionChoice = 'own' | AgentChatPermissionMode
export const AGENT_PERMISSION_CHOICES = [
'own',
'ask',
'accept-edits',
'auto',
'full-access'
] as const satisfies readonly AgentPermissionChoice[]
export type AgentPermissionGlobalSettings = {
/** Every agent's permission in terminals and new chats, unless it has its own below. Absent on
* profiles saved before permissions were stored apart from Arguments. */
agentPermissionDefault?: AgentPermissionChoice
/** Agents given their own permission instead of the all-agents one. */
agentPermissionOverrides?: Partial<Record<TuiAgent, AgentPermissionChoice>>
}
export function isAgentPermissionChoice(value: unknown): value is AgentPermissionChoice {
return AGENT_PERMISSION_CHOICES.some((choice) => choice === value)
}
// CLI-verified Ask recipes state every chat Ask constraint (Codex approvals/sandbox/reviewer), preventing agent config from widening it.
const ASK_TUI_AGENT_ARGS: Partial<Record<TuiAgent, string>> = {
claude: '--permission-mode default',
'claude-agent-teams': '--permission-mode default',
grok: '--permission-mode default',
codex: '-a on-request -s read-only -c approvals_reviewer=user'
}
const ACCEPT_EDITS_TUI_AGENT_ARGS: Partial<Record<TuiAgent, string>> = {
claude: '--permission-mode acceptEdits',
'claude-agent-teams': '--permission-mode acceptEdits'
}
const ARGS_BY_CHOICE: Record<AgentChatPermissionMode, Partial<Record<TuiAgent, string>>> = {
ask: ASK_TUI_AGENT_ARGS,
'accept-edits': ACCEPT_EDITS_TUI_AGENT_ARGS,
auto: AUTO_TUI_AGENT_ARGS,
'full-access': YOLO_TUI_AGENT_ARGS
}
/** The flag text Orca adds for this choice; empty for `own` or a choice the agent lacks. */
export function agentPermissionArgs(agent: TuiAgent, choice: AgentPermissionChoice): string {
return choice === 'own' ? '' : (ARGS_BY_CHOICE[choice][agent] ?? '')
}
/** The environment Orca adds for this choice (Goose's bypass is an env var). */
export function agentPermissionEnv(
agent: TuiAgent,
choice: AgentPermissionChoice
): Record<string, string> {
return choice === 'full-access' ? { ...YOLO_TUI_AGENT_ENV[agent] } : {}
}
export function readLaunchPermissionChoice(
values: Readonly<Record<string, unknown>> | null | undefined
): AgentPermissionChoice | undefined {
const choice = values?.permissionMode ?? values?.mode
return isAgentPermissionChoice(choice) ? choice : undefined
}
export function agentPermissionHasTerminalChoice(
agent: TuiAgent,
choice: AgentPermissionChoice
): boolean {
if (choice === 'own') {
return AGENT_PERMISSION_CHOICES.some(
(mode) => mode !== 'own' && agentPermissionHasTerminalChoice(agent, mode)
)
}
return (
agentPermissionArgs(agent, choice) !== '' ||
Object.keys(agentPermissionEnv(agent, choice)).length > 0
)
}
function supportsChoice(agent: TuiAgent, choice: AgentPermissionChoice): boolean {
return (
choice === 'own' ||
agentPermissionHasTerminalChoice(agent, choice) ||
agentChatPermissionModes(agent)?.modes.includes(choice) === true
)
}
/** Modes supported by at least one of this agent's terminal or chat surfaces. */
export function agentPermissionChoices(agent: TuiAgent): readonly AgentPermissionChoice[] {
return AGENT_PERMISSION_CHOICES.filter((choice) => supportsChoice(agent, choice))
}
/** Agents with at least one terminal or chat mode beyond `own`, in catalog order. */
export const PERMISSION_CHOICE_AGENTS: readonly TuiAgent[] = Object.keys(TUI_AGENT_CONFIG).filter(
(agent): agent is TuiAgent => isTuiAgent(agent) && agentPermissionChoices(agent).length > 1
)
export type AgentPermissionSettings = AgentPermissionGlobalSettings
/** Settings that store the permission as a choice rather than as flag text in Arguments. */
export function hasTypedAgentPermission(settings: AgentPermissionSettings | null | undefined) {
return isAgentPermissionChoice(settings?.agentPermissionDefault)
}
/** Read stored intent; each consuming surface enforces its supported modes. */
export function resolveAgentPermission(
agent: TuiAgent,
settings: AgentPermissionSettings | null | undefined
): { choice: AgentPermissionChoice; source: 'agent' | 'all' } {
const override = settings?.agentPermissionOverrides?.[agent]
if (isAgentPermissionChoice(override)) {
return { choice: override, source: 'agent' }
}
const fallback = settings?.agentPermissionDefault
const choice = isAgentPermissionChoice(fallback) ? fallback : 'own'
return { choice, source: 'all' }
}
export function normalizeAgentPermissionOverrides(
value: unknown
): NonNullable<AgentPermissionGlobalSettings['agentPermissionOverrides']> {
if (!value || typeof value !== 'object') {
return {}
}
return Object.fromEntries(
Object.entries(value).filter(
([agent, choice]) => isTuiAgent(agent) && isAgentPermissionChoice(choice)
)
)
}
/** Global writes own the default; explicit agent choices keep their scope. */
export function applyAllAgentsPermission(
settings: AgentPermissionSettings,
choice: AgentPermissionChoice
): Required<AgentPermissionSettings> {
const overrides = { ...settings.agentPermissionOverrides }
if (choice === 'auto') {
for (const agent of PERMISSION_CHOICE_AGENTS) {
const previous = resolveAgentPermission(agent, settings).choice
if (overrides[agent] === undefined && previous !== 'auto' && !supportsChoice(agent, 'auto')) {
overrides[agent] = previous
}
}
}
return { agentPermissionDefault: choice, agentPermissionOverrides: overrides }
}
/** Sets agents' own choices; `'default'` makes them follow the all-agents choice again. */
export function applyAgentPermissionOverrides(
settings: AgentPermissionSettings,
agents: readonly TuiAgent[],
choice: AgentPermissionChoice | 'default'
): Pick<AgentPermissionGlobalSettings, 'agentPermissionOverrides'> {
const overrides = { ...settings.agentPermissionOverrides }
for (const agent of agents) {
if (choice === 'default') {
delete overrides[agent]
} else {
overrides[agent] = choice
}
}
return { agentPermissionOverrides: overrides }
}
/** Drop unknown global choices before saving or they would look like legacy text and erase stored agent permissions. */
export function sanitizeAgentPermissionUpdates(
target: AgentPermissionGlobalSettings,
updates: AgentPermissionGlobalSettings
): void {
if (
'agentPermissionDefault' in updates &&
!isAgentPermissionChoice(updates.agentPermissionDefault)
) {
delete target.agentPermissionDefault
}
if ('agentPermissionOverrides' in updates) {
target.agentPermissionOverrides = normalizeAgentPermissionOverrides(
updates.agentPermissionOverrides
)
}
}