Skip to content

armgit / orca

Public Imported from GitHub
0

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.

8.8 KB
Raw Blame
import { agentPermissionHostPlatform, permissionEnvNameMatches } from './agent-permission-env'
import {
  agentEnvironmentMutationUpdates,
  choiceUpdate,
  legacyEnvUpdates
} from './agent-launch-environment-updates'
import type {
  AgentLaunchSettingsMutation,
  AgentLaunchSettingsSource
} from './agent-launch-settings'
import {
  composeAgentLaunchProfile,
  normalizeTuiAgentArgsRecord,
  resolveTuiAgentLaunchArgs,
  resolveTuiAgentLaunchEnv
} from './tui-agent-launch-defaults'
import {
  agentPermissionArgs,
  agentPermissionChoices,
  agentPermissionEnv,
  applyAgentPermissionOverrides,
  applyAllAgentsPermission,
  hasTypedAgentPermission,
  PERMISSION_CHOICE_AGENTS,
  resolveAgentPermission,
  type AgentPermissionChoice
} from './tui-agent-permission-choice'
import { liftAgentPermissionArgs } from './tui-agent-permission-lift'
import { isTuiAgent } from './tui-agent-config'
import type { TuiAgent } from './tui-agent'

// Agent launch settings writes against the stored permission, including the shapes older clients
// send, which treat the permission flag as part of the Arguments text.

export function permissionUpdates(
  settings: AgentLaunchSettingsSource,
  mutation: Extract<AgentLaunchSettingsMutation, { type: 'permission' }>
): AgentLaunchSettingsSource {
  const { agent, choice } = mutation
  if (agent) {
    if (choice !== 'default' && !agentPermissionChoices(agent).includes(choice)) {
      throw new Error('This agent does not offer that permission')
    }
    return applyAgentPermissionOverrides(settings, [agent], choice)
  }
  if (choice === 'default') {
    throw new Error('Choose a permission for all agents')
  }
  if (mutation.withoutAuto) {
    const agents = PERMISSION_CHOICE_AGENTS.filter(
      (candidate) => !agentPermissionChoices(candidate).includes('auto')
    )
    return applyAgentPermissionOverrides(settings, agents, choice)
  }
  return applyAllAgentsPermission(settings, choice)
}

/** An older client's Auto/Yolo/Manual switch, as the choice it means. Manual passed no flag. */
export function legacyPermissionsUpdates(
  settings: AgentLaunchSettingsSource,
  mutation: Extract<AgentLaunchSettingsMutation, { type: 'permissions' }>
): AgentLaunchSettingsSource {
  const choice: AgentPermissionChoice =
    mutation.mode === 'yolo' ? 'full-access' : mutation.mode === 'auto' ? 'auto' : 'own'
  if (mutation.agent) {
    return applyAgentPermissionOverrides(settings, [mutation.agent], choice)
  }
  if (mutation.exceptAuto) {
    return permissionUpdates(settings, { type: 'permission', choice, withoutAuto: true })
  }
  return applyAllAgentsPermission(settings, choice)
}

/**
 * Arguments text from a client that sees the flag as part of it. Unchanged text changes nothing;
 * otherwise Orca's flag in it becomes the choice, and text without one means the agent's own.
 */
export function legacyArgumentsUpdates(
  settings: AgentLaunchSettingsSource,
  agent: TuiAgent,
  value: string
): AgentLaunchSettingsSource {
  if (value.trim() === resolveTuiAgentLaunchArgs(agent, settings).trim()) {
    return {}
  }
  const lifted = liftAgentPermissionArgs(agent, value)
  return {
    agentDefaultArgs: normalizeTuiAgentArgsRecord({
      ...settings.agentDefaultArgs,
      [agent]: lifted.args
    }),
    ...(lifted.choice
      ? choiceUpdate(settings, agent, lifted.choice)
      : agentPermissionArgs(agent, resolveAgentPermission(agent, settings).choice) &&
          resolveTuiAgentLaunchArgs(agent, settings).trim() !==
            (settings.agentDefaultArgs?.[agent]?.trim() ?? '')
        ? choiceUpdate(settings, agent, 'own')
        : {})
  }
}

/**
 * Typed-store updates for a client that writes whole Arguments or env records (an older paired
 * client's settings update): each changed agent is read as `legacyArgumentsUpdates` does.
 */
export function legacyLaunchTextUpdates(
  settings: AgentLaunchSettingsSource,
  updates: Pick<AgentLaunchSettingsSource, 'agentDefaultArgs' | 'agentDefaultEnv'>,
  platform: NodeJS.Platform | undefined = agentPermissionHostPlatform()
): AgentLaunchSettingsSource {
  if (!hasTypedAgentPermission(settings)) {
    return updates
  }
  const published = composeAgentLaunchProfile(settings, platform)
  const args: Partial<Record<TuiAgent, string>> = {}
  const envs: Partial<Record<TuiAgent, Record<string, string>>> = {}
  let overrides = settings.agentPermissionOverrides
  if (updates.agentDefaultArgs !== undefined) {
    for (const agent of new Set([
      ...Object.keys(published.agentDefaultArgs),
      ...Object.keys(updates.agentDefaultArgs)
    ])) {
      if (!isTuiAgent(agent)) {
        continue
      }
      const change = legacyArgumentsUpdates(settings, agent, updates.agentDefaultArgs[agent] ?? '')
      if (Object.hasOwn(updates.agentDefaultArgs, agent)) {
        args[agent] = change.agentDefaultArgs?.[agent] ?? settings.agentDefaultArgs?.[agent] ?? ''
      }
      if (change.agentPermissionOverrides?.[agent]) {
        overrides = { ...overrides, [agent]: change.agentPermissionOverrides[agent] }
      }
    }
  }
  if (updates.agentDefaultEnv !== undefined) {
    for (const agent of new Set([
      ...Object.keys(published.agentDefaultEnv),
      ...Object.keys(updates.agentDefaultEnv)
    ])) {
      if (!isTuiAgent(agent)) {
        continue
      }
      const change = legacyEnvUpdates(
        settings,
        agent,
        updates.agentDefaultEnv[agent] ?? {},
        platform
      )
      if (Object.hasOwn(updates.agentDefaultEnv, agent)) {
        envs[agent] = change.agentDefaultEnv?.[agent] ?? settings.agentDefaultEnv?.[agent] ?? {}
      }
      if (change.agentPermissionOverrides?.[agent]) {
        overrides = { ...overrides, [agent]: change.agentPermissionOverrides[agent] }
      }
    }
  }
  return {
    ...(updates.agentDefaultArgs !== undefined ? { agentDefaultArgs: args } : {}),
    ...(updates.agentDefaultEnv !== undefined ? { agentDefaultEnv: envs } : {}),
    agentPermissionOverrides: overrides
  }
}

export function wholeAgentEnvironmentUpdates(
  settings: AgentLaunchSettingsSource,
  agent: TuiAgent,
  requested: Record<string, string>,
  platform: NodeJS.Platform
): AgentLaunchSettingsSource {
  const carrierNames = hasTypedAgentPermission(settings)
    ? Object.keys(agentPermissionEnv(agent, 'full-access'))
    : []
  const isCarrier = (name: string) =>
    carrierNames.some((carrier) => permissionEnvNameMatches(name, carrier, platform))
  const ordinary = new Map<string, string>()
  const groups = new Map<string, Set<string>>()
  const identity = (name: string) => (platform === 'win32' ? name.toLowerCase() : name)
  const carrierEntries: [string, string][] = []
  const previous = resolveTuiAgentLaunchEnv(agent, settings, platform, (name, value) => {
    if (isCarrier(name)) {
      carrierEntries.push([name, value])
      return true
    }
    ordinary.set(name, value)
    const key = identity(name)
    groups.set(key, (groups.get(key) ?? new Set<string>()).add(name))
    return true
  })
  const carrier: AgentLaunchSettingsSource = {
    agentPermissionDefault: settings.agentPermissionDefault,
    agentPermissionOverrides: settings.agentPermissionOverrides?.[agent]
      ? { [agent]: settings.agentPermissionOverrides[agent] }
      : {},
    agentDefaultEnv: { [agent]: Object.fromEntries(carrierEntries) }
  }
  let changed = false
  const change = (name: string, present: boolean): void => {
    changed = true
    if (isCarrier(name)) {
      const mutation: AgentLaunchSettingsMutation = present
        ? { type: 'environment-set', agent, name, value: requested[name] }
        : { type: 'environment-remove', agent, name }
      Object.assign(carrier, agentEnvironmentMutationUpdates(carrier, mutation, platform))
      return
    }
    const key = identity(name)
    const group = groups.get(key) ?? new Set<string>()
    for (const spelling of group) {
      ordinary.delete(spelling)
    }
    if (present) {
      ordinary.set(name, requested[name])
      if (group.size !== 1 || !group.has(name)) {
        groups.set(key, new Set<string>().add(name))
      }
    } else {
      groups.delete(key)
    }
  }
  for (const name in previous) {
    if (Object.hasOwn(previous, name) && previous[name] !== requested[name]) {
      change(name, Object.hasOwn(requested, name))
    }
  }
  for (const name in requested) {
    if (Object.hasOwn(requested, name) && !Object.hasOwn(previous, name)) {
      change(name, true)
    }
  }
  if (!changed) {
    return {}
  }
  Object.entries(carrier.agentDefaultEnv?.[agent] ?? {})
    .sort(([a], [b]) => a.localeCompare(b))
    .forEach(([name, value]) => ordinary.set(name, value))
  const override = carrier.agentPermissionOverrides?.[agent]
  return {
    agentDefaultEnv: { ...settings.agentDefaultEnv, [agent]: Object.fromEntries(ordinary) },
    ...(override !== settings.agentPermissionOverrides?.[agent]
      ? applyAgentPermissionOverrides(settings, [agent], override ?? 'default')
      : {})
  }
}