-
- )
- }
- // Settings-initiated download — show "Ready to install"
- return (
- - {translate('auto.components.UpdateCard.09a55c39b5', 'Installing...')} -
-
{showReassurance && (
@@ -638,7 +281,7 @@ export function UpdateCard() {
)}
)
}
-
-// ── Rich card content ────────────────────────────────────────────────
-
-function RichCardContent({
- release,
- releasesBehind,
- prefersReducedMotion,
- mediaFailed,
- mediaLoaded,
- onMediaError,
- onMediaLoad,
- onUpdate,
- onClose
-}: {
- release: NonNullable
- releasesBehind: number | null
- prefersReducedMotion: boolean
- mediaFailed: boolean
- mediaLoaded: boolean
- onMediaError: () => void
- onMediaLoad: () => void
- onUpdate: () => void
- onClose: () => void
-}) {
- const showMedia =
- release.mediaUrl &&
- !mediaFailed &&
- // Why: GIFs can't be reliably paused cross-browser, so hide them entirely under reduced-motion.
- !(prefersReducedMotion && isAnimatedGif(release.mediaUrl))
-
- return (
-
+ releasesBehind: number | null
+ prefersReducedMotion: boolean
+ mediaFailed: boolean
+ mediaLoaded: boolean
+ onMediaError: () => void
+ onMediaLoad: () => void
+ onUpdate: () => void
+ onClose: () => void
+}): React.JSX.Element {
+ const showMedia =
+ release.mediaUrl && !mediaFailed && !(prefersReducedMotion && isAnimatedGif(release.mediaUrl))
+ return (
+
+ value={value}
+ onChange={(next) => {
+ if (next !== value) {
+ onSetEnabled(next === 'enabled')
+ }
+ }}
+ ariaLabel={translate(
+ 'auto.components.settings.AgentsPane.1c9a9679ec',
+ '{{value0}} availability',
+ { value0: label }
+ )}
+ size="sm"
+ options={[
+ {
+ value: 'enabled',
+ label: translate('auto.components.settings.AgentsPane.d4d2a45d63', 'Enabled')
+ },
+ {
+ value: 'disabled',
+ label: translate('auto.components.settings.AgentsPane.8dc0192e48', 'Disabled')
+ }
+ ]}
+ />
+ )
+}
+
+export type AgentCatalogRowProps = {
+ agentId: TuiAgent
+ label: string
+ homepageUrl: string
+ defaultCmd: string
+ defaultArgs: string
+ defaultEnv: Record
+ isDetected: boolean
+ isEnabled: boolean
+ isDefault: boolean
+ cmdOverride: string | undefined
+ argsOverride: string
+ envOverride: Record
+ onSetDefault: () => void
+ onSetEnabled: (enabled: boolean) => void
+ onSaveOverride: (value: string) => void
+ onSaveArgs: (value: string) => void
+ onSaveEnv: (value: Record) => void
+ sessionSourceHome?: AgentSessionSourceHomeControl
+}
+
+export function AgentCatalogRow({
+ agentId,
+ label,
+ homepageUrl,
+ defaultCmd,
+ defaultArgs,
+ defaultEnv,
+ isDetected,
+ isEnabled,
+ isDefault,
+ cmdOverride,
+ argsOverride,
+ envOverride,
+ onSetDefault,
+ onSetEnabled,
+ onSaveOverride,
+ onSaveArgs,
+ onSaveEnv,
+ sessionSourceHome
+}: AgentCatalogRowProps): React.JSX.Element {
+ const envSummary = stringifyAgentDefaultEnvDraft(envOverride)
+ const defaultEnvSummary = stringifyAgentDefaultEnvDraft(defaultEnv)
+ const [cmdOpen, setCmdOpen] = useState(
+ Boolean(cmdOverride) || argsOverride !== defaultArgs || envSummary !== defaultEnvSummary
+ )
+
+ return (
+ | null
+ enabledDetectedAgents: AgentCatalogEntry[]
+ catalog: AgentCatalogEntry[]
+ description: string
+ onSetDefault: (agent: TuiAgent | 'blank' | null) => void
+}): React.JSX.Element {
+ const storedDefaultAgent =
+ defaultAgent !== null && defaultAgent !== 'blank'
+ ? catalog.find((agent) => agent.id === defaultAgent)
+ : undefined
+ const defaultAgentPills =
+ storedDefaultAgent && !enabledDetectedAgents.some((agent) => agent.id === storedDefaultAgent.id)
+ ? [...enabledDetectedAgents, storedDefaultAgent]
+ : enabledDetectedAgents
+
+ return (
+
+
+ )
+}
diff --git a/src/renderer/src/components/settings/AgentDetectionCatalog.tsx b/src/renderer/src/components/settings/AgentDetectionCatalog.tsx
new file mode 100644
index 00000000000..e00924d4d4f
--- /dev/null
+++ b/src/renderer/src/components/settings/AgentDetectionCatalog.tsx
@@ -0,0 +1,178 @@
+import { AlertTriangle, RefreshCw } from 'lucide-react'
+import type { AgentCatalogEntry } from '@/lib/agent-catalog'
+import { cn } from '@/lib/utils'
+import { translate } from '@/i18n/i18n'
+import { Button } from '../ui/button'
+import { AgentCatalogRow, type AgentCatalogRowProps } from './AgentCatalogRow'
+import { SettingsBadge, SettingsSubsectionHeader } from './SettingsFormControls'
+
+export function AgentDetectionCatalog({
+ detectedAgents,
+ undetectedAgents,
+ detectionPending,
+ detectionFailed,
+ isRefreshing,
+ activeServerEnvironmentId,
+ activeServerName,
+ onRefresh,
+ getRowProps
+}: {
+ detectedAgents: AgentCatalogEntry[]
+ undetectedAgents: AgentCatalogEntry[]
+ detectionPending: boolean
+ detectionFailed: boolean
+ isRefreshing: boolean
+ activeServerEnvironmentId: string | null
+ activeServerName: string | null
+ onRefresh: () => void
+ getRowProps: (agent: AgentCatalogEntry, isDetected: boolean) => AgentCatalogRowProps
+}): React.JSX.Element {
+ return (
+ <>
+ {detectedAgents.length === 0 && !detectionPending && !detectionFailed && (
+
+
+ {translate('auto.components.settings.AgentsPane.02e0143be5', 'Installed')}
+
+ {detectedAgents.length}{' '}
+ {translate('auto.components.settings.AgentsPane.ed3e110e61', 'detected')}
+
+ {activeServerName ? (
+
+ {translate('auto.components.settings.AgentsPane.03e1a5081a', 'on {{value0}}', {
+ value0: activeServerName
+ })}
+
+ ) : null}
+
+ }
+ action={
+
+ }
+ />
+
+ )}
+
+ {undetectedAgents.length > 0 && (
+
+
+ {translate(
+ 'auto.components.settings.AgentsPane.e8da2af684',
+ 'Available to install'
+ )}
+
+ {undetectedAgents.length}{' '}
+ {translate('auto.components.settings.AgentsPane.024bd95089', 'agents')}
+
+
+ }
+ />
+
+ )}
+
+ {detectionPending && !detectionFailed && (
+
+ envOverride: Record
+ onSaveEnv: (value: Record) => void
+}): React.JSX.Element {
+ const defaultEnvText = stringifyAgentDefaultEnvDraft(defaultEnv)
+ const draftSeed = stringifyAgentDefaultEnvDraft(envOverride)
+ const [envDraft, setEnvDraft] = useState(draftSeed)
+ const [envDraftTooLarge, setEnvDraftTooLarge] = useState(false)
+ const envDraftErrorId = useId()
+ const commitEnv = (): void => {
+ const parsedDraft = parseAgentDefaultEnvDraft(envDraft)
+ setEnvDraftTooLarge(parsedDraft.tooLarge)
+ if (!parsedDraft.tooLarge) {
+ onSaveEnv(parsedDraft.env)
+ }
+ }
+
+ return (
+
- isDetected: boolean
- isEnabled: boolean
- isDefault: boolean
- cmdOverride: string | undefined
- argsOverride: string
- envOverride: Record
- onSetDefault: () => void
- onSetEnabled: (enabled: boolean) => void
- onSaveOverride: (value: string) => void
- onSaveArgs: (value: string) => void
- onSaveEnv: (value: Record) => void
- /** Codex-only: current runtime scope label + persisted history-source override. */
- sessionSourceHome?: AgentSessionSourceHomeControl
-}
-
-type AgentCommandOverrideInputProps = {
- defaultCmd: string
- cmdOverride: string | undefined
- onSaveOverride: (value: string) => void
-}
-
-type AgentDefaultArgsInputProps = {
- defaultArgs: string
- argsOverride: string
- onSaveArgs: (value: string) => void
-}
-
-type AgentDefaultEnvInputProps = {
- defaultEnv: Record
- envOverride: Record
- onSaveEnv: (value: Record) => void
-}
-
-type AgentAvailability = 'enabled' | 'disabled'
-
-type AgentAvailabilityControlProps = {
- label: string
- isEnabled: boolean
- onSetEnabled: (enabled: boolean) => void
-}
-
-type AgentPermissionsSettingProps = {
- mode: AgentPermissionMode
- onChange: (mode: Exclude) => void
-}
-
-export function buildAgentAvailabilitySettingsUpdate(
- settings: Pick,
- id: TuiAgent,
- enabled: boolean
-): Pick & Partial> {
- const latestDisabled = normalizeDisabledTuiAgents(settings.disabledTuiAgents)
- const nextDisabled = enabled
- ? latestDisabled.filter((agent) => agent !== id)
- : latestDisabled.includes(id)
- ? latestDisabled
- : [...latestDisabled, id]
-
- return {
- disabledTuiAgents: nextDisabled,
- ...(settings.defaultTuiAgent === id && !enabled ? { defaultTuiAgent: null } : {})
- }
-}
-
-export function createAgentAvailabilityUpdateQueue(): (
- options: AgentAvailabilityUpdateQueueOptions
-) => Promise {
- let pendingUpdate: Promise = Promise.resolve()
-
- return ({ getSettings, fallbackSettings, updateSettings, agentId, enabled }) => {
- // Why: serialize full-array replacements so each write sees the store after
- // the previous IPC has reconciled, while preserving the user's requested state.
- pendingUpdate = pendingUpdate
- .catch(() => {})
- .then(() =>
- updateSettings(
- buildAgentAvailabilitySettingsUpdate(getSettings() ?? fallbackSettings, agentId, enabled)
- )
- )
- return pendingUpdate.then(() => undefined)
- }
-}
-
const enqueueAgentAvailabilityUpdate = createAgentAvailabilityUpdateQueue()
-export function AgentAvailabilityControl({
- label,
- isEnabled,
- onSetEnabled
-}: AgentAvailabilityControlProps): React.JSX.Element {
- const value: AgentAvailability = isEnabled ? 'enabled' : 'disabled'
-
- return (
-
- value={value}
- onChange={(next) => {
- if (next !== value) {
- onSetEnabled(next === 'enabled')
- }
- }}
- ariaLabel={translate(
- 'auto.components.settings.AgentsPane.1c9a9679ec',
- '{{value0}} availability',
- { value0: label }
- )}
- size="sm"
- options={[
- {
- value: 'enabled',
- label: translate('auto.components.settings.AgentsPane.d4d2a45d63', 'Enabled')
- },
- {
- value: 'disabled',
- label: translate('auto.components.settings.AgentsPane.8dc0192e48', 'Disabled')
- }
- ]}
- />
- )
-}
-
export function AgentPermissionsSetting({
mode,
onChange
-}: AgentPermissionsSettingProps): React.JSX.Element {
+}: {
+ mode: AgentPermissionMode
+ onChange: (mode: Exclude) => void
+}): React.JSX.Element {
const visibleMode: Exclude = mode === 'manual' ? 'manual' : 'yolo'
return (
@@ -275,419 +138,6 @@ export function AgentPermissionsSetting({
)
}
-function AgentCommandOverrideInput({
- defaultCmd,
- cmdOverride,
- onSaveOverride
-}: AgentCommandOverrideInputProps): React.JSX.Element {
- const draftSeed = cmdOverride ?? defaultCmd
- const [cmdDraft, setCmdDraft] = useState(draftSeed)
-
- const commitCmd = (): void => {
- const trimmed = cmdDraft.trim()
- if (!trimmed || trimmed === defaultCmd) {
- onSaveOverride('')
- setCmdDraft(defaultCmd)
- } else {
- onSaveOverride(trimmed)
- }
- }
-
- return (
- (
() =>
@@ -714,38 +160,32 @@ export function AgentsPane({
isRefreshing,
refresh: refreshTargetAgents
} = useDetectedAgents(agentDetectionTarget)
- const refreshLocalAgents = useAppStore((s) => s.refreshDetectedAgents)
- const activeServerName = useAppStore((s) =>
+ const refreshLocalAgents = useAppStore((state) => state.refreshDetectedAgents)
+ const activeServerName = useAppStore((state) =>
activeServerEnvironmentId
- ? (s.runtimeEnvironments.find((environment) => environment.id === activeServerEnvironmentId)
- ?.name ?? null)
+ ? (state.runtimeEnvironments.find(
+ (environment) => environment.id === activeServerEnvironmentId
+ )?.name ?? null)
: null
)
- // Why: refresh re-spawns the target host's login shell to re-capture PATH
- // (preflight:refreshAgents). This handles the "installed a new CLI, Orca
- // doesn't see it yet" case without a restart.
- const handleRefresh = (): void => {
- void refreshTargetAgents()
- }
const detectedIds = useMemo | null>(
() => (detectedList ? new Set(detectedList) : null),
[detectedList]
)
-
+ const catalog = getAgentCatalog()
const defaultAgent = settings.defaultTuiAgent
- const agentOwnership = getSettingOwnershipSummary('agentLaunchDefaults')
const cmdOverrides = settings.agentCmdOverrides ?? {}
const agentDefaultArgs = settings.agentDefaultArgs ?? {}
const agentDefaultEnv = settings.agentDefaultEnv ?? {}
- const agentPermissionMode = resolveAgentPermissionModeSummary({
- agentDefaultArgs,
- agentDefaultEnv
- })
const disabledAgents = normalizeDisabledTuiAgents(settings.disabledTuiAgents)
-
- const setDefault = (id: TuiAgent | 'blank' | null): void => {
- updateSettings({ defaultTuiAgent: id })
- }
+ const detectedAgents =
+ detectedIds === null ? [] : catalog.filter((agent) => detectedIds.has(agent.id))
+ const enabledDetectedAgents = detectedAgents.filter((agent) =>
+ isTuiAgentEnabled(agent.id, disabledAgents)
+ )
+ const undetectedAgents = catalog.filter(
+ (agent) => detectedIds !== null && !detectedIds.has(agent.id)
+ )
const setAgentEnabled = (id: TuiAgent, enabled: boolean): void => {
void enqueueAgentAvailabilityUpdate({
@@ -756,343 +196,92 @@ export function AgentsPane({
enabled
})
}
-
- const saveOverride = (id: TuiAgent, value: string): void => {
- const next = { ...cmdOverrides }
- if (value) {
- next[id] = value
- } else {
- delete next[id]
- }
- updateSettings({ agentCmdOverrides: next })
- }
-
- const saveAgentArgs = (id: TuiAgent, value: string): void => {
- updateSettings({
- agentDefaultArgs: {
- ...agentDefaultArgs,
- [id]: value
- }
- })
- }
-
- const saveAgentEnv = (id: TuiAgent, value: Record): void => {
- updateSettings({
- agentDefaultEnv: {
- ...agentDefaultEnv,
- [id]: value
- }
- })
- }
-
- const saveAgentPermissionMode = (mode: Exclude): void => {
- updateSettings(
- applyAgentPermissionMode({
- mode,
- agentDefaultArgs,
- agentDefaultEnv
- })
- )
- }
-
- // Why: null means detection is in flight, not "all agents are installed".
- // Showing the full catalog here makes the default-agent picker flash invalid
- // options while switching between Windows and WSL detection contexts.
- const detectedAgents =
- detectedIds === null ? [] : getAgentCatalog().filter((agent) => detectedIds.has(agent.id))
- const enabledDetectedAgents = detectedAgents.filter((agent) =>
- isTuiAgentEnabled(agent.id, disabledAgents)
- )
- const undetectedAgents = getAgentCatalog().filter(
- (a) => detectedIds !== null && !detectedIds.has(a.id)
- )
-
- // Why only `=== null`: the pill's own handler writes null, so lighting it up
- // for a *stored* agent that merely is not detected right now made the
- // already-checked pill destructive -- one click on it erased
- // `defaultTuiAgent` (#15256). Detection is a transient fact; the stored value
- // is not, and this control reports the stored value.
- const isAutoDefault = defaultAgent === null
- const isBlankDefault = defaultAgent === 'blank'
-
- // Why show an undetected default: when detection comes back empty there were
- // no agent pills at all, so the stored choice was invisible AND unrecoverable
- // -- nothing to click to put it back. Keeping it listed means a failed or
- // slow probe cannot quietly cost the user their setting.
- const storedDefaultAgent =
- defaultAgent !== null && defaultAgent !== 'blank'
- ? getAgentCatalog().find((agent) => agent.id === defaultAgent)
- : undefined
- const defaultAgentPills =
- storedDefaultAgent && !enabledDetectedAgents.some((agent) => agent.id === storedDefaultAgent.id)
- ? [...enabledDetectedAgents, storedDefaultAgent]
- : enabledDetectedAgents
+ const getRowProps = (
+ agent: (typeof catalog)[number],
+ isDetected: boolean
+ ): AgentCatalogRowProps => ({
+ agentId: agent.id,
+ label: agent.label,
+ homepageUrl: agent.homepageUrl,
+ defaultCmd: agent.cmd,
+ defaultArgs: getTuiAgentDefaultArgs(agent.id),
+ defaultEnv: getTuiAgentDefaultEnv(agent.id),
+ isDetected,
+ isEnabled: isTuiAgentEnabled(agent.id, disabledAgents),
+ isDefault: isDetected && defaultAgent === agent.id,
+ cmdOverride: isDetected ? cmdOverrides[agent.id] : undefined,
+ argsOverride: resolveTuiAgentLaunchArgs(agent.id, agentDefaultArgs),
+ envOverride: resolveTuiAgentLaunchEnv(agent.id, agentDefaultEnv),
+ onSetDefault: isDetected ? () => updateSettings({ defaultTuiAgent: agent.id }) : () => {},
+ onSetEnabled: (enabled) => setAgentEnabled(agent.id, enabled),
+ onSaveOverride: isDetected
+ ? (value) => {
+ const next = { ...cmdOverrides }
+ if (value) {
+ next[agent.id] = value
+ } else {
+ delete next[agent.id]
+ }
+ updateSettings({ agentCmdOverrides: next })
+ }
+ : () => {},
+ onSaveArgs: (value) =>
+ updateSettings({ agentDefaultArgs: { ...agentDefaultArgs, [agent.id]: value } }),
+ onSaveEnv: (value) =>
+ updateSettings({ agentDefaultEnv: { ...agentDefaultEnv, [agent.id]: value } }),
+ sessionSourceHome:
+ isDetected && agent.id === 'codex'
+ ? buildCodexSessionSourceHomeControl(settings, updateSettings)
+ : undefined
+ })
return (
@@ -1100,21 +289,14 @@ export function AgentStatusHooksSetting({
label={getAgentStatusHooksTitle()}
description={getAgentStatusHooksDescription()}
checked={enabled}
- onChange={() =>
- updateSettings({
- agentStatusHooksEnabled: !enabled
- })
- }
+ onChange={() => updateSettings({ agentStatusHooksEnabled: !enabled })}
ariaLabel={getAgentStatusHooksTitle()}
/>
)
}
-export function AgentGeneratedTabTitlesSetting({
- settings,
- updateSettings
-}: AgentsPaneProps): React.JSX.Element {
+export function AgentGeneratedTabTitlesSetting({ settings, updateSettings }: AgentsPaneProps) {
const enabled = settings.tabAutoGenerateTitle === true
return (
@@ -1122,11 +304,7 @@ export function AgentGeneratedTabTitlesSetting({
label={getAgentGeneratedTabTitlesTitle()}
description={getAgentGeneratedTabTitlesDescription()}
checked={enabled}
- onChange={() =>
- updateSettings({
- tabAutoGenerateTitle: !enabled
- })
- }
+ onChange={() => updateSettings({ tabAutoGenerateTitle: !enabled })}
ariaLabel={getAgentGeneratedTabTitlesTitle()}
/>
diff --git a/src/renderer/src/components/settings/RepositoryHookPolicySettings.tsx b/src/renderer/src/components/settings/RepositoryHookPolicySettings.tsx
new file mode 100644
index 00000000000..a6bedb5949c
--- /dev/null
+++ b/src/renderer/src/components/settings/RepositoryHookPolicySettings.tsx
@@ -0,0 +1,315 @@
+import { ChevronRight } from 'lucide-react'
+import type {
+ HookCommandSourcePolicy,
+ OrcaHooks,
+ SetupAgentStartupPolicy,
+ SetupRunPolicy
+} from '../../../../shared/orca-yaml-hook-types'
+import { translate } from '@/i18n/i18n'
+import { matchesSettingsSearch } from './settings-search'
+import { SettingsSwitch } from './SettingsFormControls'
+import { RepositoryHooksYamlStatus } from './RepositoryHooksYamlStatus'
+
+type PolicyOption = { policy: Policy; label: string; description: string }
+
+function SegmentedPolicyToggle({
+ options,
+ selected,
+ onSelect
+}: {
+ options: PolicyOption[]
+ selected: Policy
+ onSelect: (policy: Policy) => void
+}): React.JSX.Element {
+ return (
+ [] {
+ return [
+ {
+ policy: 'ask',
+ label: translate(
+ 'auto.components.settings.RepositoryHooksSection.e03d9a8f38',
+ 'Ask every time'
+ ),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.90b1f50137',
+ 'Prompt before running setup.'
+ )
+ },
+ {
+ policy: 'run-by-default',
+ label: translate(
+ 'auto.components.settings.RepositoryHooksSection.d3ef1ab247',
+ 'Run by default'
+ ),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.022ba10cf2',
+ 'Run setup automatically.'
+ )
+ },
+ {
+ policy: 'skip-by-default',
+ label: translate(
+ 'auto.components.settings.RepositoryHooksSection.15debc1fd9',
+ 'Skip by default'
+ ),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.99e3264a49',
+ 'Only run setup when chosen.'
+ )
+ }
+ ]
+}
+
+function getCommandSourcePolicyOptions(): PolicyOption[] {
+ return [
+ {
+ policy: 'shared-only',
+ label: translate(
+ 'auto.components.settings.RepositoryHooksSection.d88b6ff88f',
+ 'orca.yaml only'
+ ),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.29397e8bbc',
+ 'Run only committed repo commands; ignore local commands.'
+ )
+ },
+ {
+ policy: 'local-only',
+ label: translate('auto.components.settings.RepositoryHooksSection.83dc78202a', 'Local only'),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.0e8b2a520d',
+ 'Ignore orca.yaml; run only your local commands.'
+ )
+ },
+ {
+ policy: 'run-both',
+ label: translate('auto.components.settings.RepositoryHooksSection.8d6c56bff8', 'Run both'),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.8561b0665f',
+ 'orca.yaml first, then your local commands.'
+ )
+ }
+ ]
+}
+
+export function RepositorySetupPolicySetting({
+ setupRunPolicy,
+ setupAgentStartupPolicy,
+ onRunPolicyChange,
+ onStartupPolicyChange
+}: {
+ setupRunPolicy: SetupRunPolicy
+ setupAgentStartupPolicy: SetupAgentStartupPolicy
+ onRunPolicyChange: (policy: SetupRunPolicy) => void
+ onStartupPolicyChange: (policy: SetupAgentStartupPolicy) => void
+}): React.JSX.Element {
+ const options = getSetupRunPolicyOptions()
+ return (
+ (null)
+ useEffect(() => {
+ if (value === lastValueRef.current) {
+ return
+ }
+ lastValueRef.current = value
+ setSaveStatus('saving')
+ if (savedTimerRef.current !== null) {
+ window.clearTimeout(savedTimerRef.current)
+ }
+ savedTimerRef.current = window.setTimeout(() => {
+ setSaveStatus('saved')
+ savedTimerRef.current = window.setTimeout(() => {
+ setSaveStatus('idle')
+ savedTimerRef.current = null
+ }, 1500)
+ }, 250)
+ return () => {
+ if (savedTimerRef.current !== null) {
+ window.clearTimeout(savedTimerRef.current)
+ savedTimerRef.current = null
+ }
+ }
+ }, [value])
+
+ const showLocalEditor = showLocal || value.length > 0 || !hasShared
+ return (
+
-
- )
-}
-
-// ── Simple card content ──────────────────────────────────────────────
-
-function SimpleCardContent({
- version,
- releaseUrl,
- onUpdate,
- onClose
-}: {
- version: string
- releaseUrl?: string
- onUpdate: () => void
- onClose: () => void
-}) {
- return (
-
-
-
- {showMedia && (
- - {translate('auto.components.UpdateCard.f58b5c57a6', 'New:')} {release.title} -
- -
- {!mediaLoaded && (
- // Shimmer placeholder while image loads
-
- )}
- 
-
- )}
-
- - {release.description} - {releasesBehind !== null && releasesBehind > 1 && ( - <> - {' '} - - - )} -
- - - - -
-
- )
-}
-
-// ── Downloading content ──────────────────────────────────────────────
-
-function DownloadingContent({
- version,
- percent,
- changelog,
- prefersReducedMotion,
- mediaFailed,
- mediaLoaded,
- onMediaError,
- onMediaLoad,
- onCollapse,
- showReleaseNotes
-}: {
- version: string
- percent: number
- changelog: ChangelogData | null
- prefersReducedMotion: boolean
- mediaFailed: boolean
- mediaLoaded: boolean
- onMediaError: () => void
- onMediaLoad: () => void
- onCollapse: () => void
- showReleaseNotes: boolean
-}) {
- const release = changelog?.release
- const showMedia =
- release?.mediaUrl && !mediaFailed && !(prefersReducedMotion && isAnimatedGif(release.mediaUrl))
-
- return (
-
-
-
- - {translate('auto.components.UpdateCard.9abc59f814', 'Update Available')} -
- -- {translate('auto.components.UpdateCard.05ad78a6d1', 'Orca v{{value0}} is ready.', { - value0: version - })} -
- -- {translate('auto.components.UpdateCard.fdd4a364fa', "Sessions won't be interrupted.")} -
- - {releaseUrl && ( - - )} - - -
-
- )
-}
-
-// ── Ready to install content ─────────────────────────────────────────
-
-function ReadyToInstallContent({
- version,
- onRestart,
- onClose
-}: {
- version: string
- onRestart: () => void
- onClose: () => void
-}) {
- return (
-
- {release ? (
-
-
- {showMedia && release?.mediaUrl && (
- - {translate('auto.components.UpdateCard.f58b5c57a6', 'New:')} {release.title} -
- ) : ( -- {translate('auto.components.UpdateCard.558842597d', 'Downloading Update')} -
- )} - -
- {!mediaLoaded && (
-
- )}
-
-
- )}
-
- - {release - ? release.description - : translate('auto.components.UpdateCard.93794ea932', 'Orca v{{value0}} is downloading.', { - value0: version - })} -
- - {showReleaseNotes && ( - - )} - -
-
-
- - {translate('auto.components.UpdateCard.6e45bfa2e0', 'Downloading...')} {percent}% -
-
-
- )
-}
diff --git a/src/renderer/src/components/maintenance/update-card/UpdateAvailableCardContent.tsx b/src/renderer/src/components/maintenance/update-card/UpdateAvailableCardContent.tsx
new file mode 100644
index 00000000000..b18c18537d1
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/UpdateAvailableCardContent.tsx
@@ -0,0 +1,151 @@
+import { X } from 'lucide-react'
+import type { ChangelogData } from '../../../../../shared/update-status-types'
+import { Button } from '../../ui/button'
+import { translate } from '@/i18n/i18n'
+
+function isAnimatedGif(url: string | undefined): boolean {
+ return typeof url === 'string' && url.toLowerCase().endsWith('.gif')
+}
+
+export function UpdateAvailableRichContent({
+ release,
+ releasesBehind,
+ prefersReducedMotion,
+ mediaFailed,
+ mediaLoaded,
+ onMediaError,
+ onMediaLoad,
+ onUpdate,
+ onClose
+}: {
+ release: NonNullable
-
-
- - {translate('auto.components.UpdateCard.17412483da', 'Ready to Install')} -
- -- {translate( - 'auto.components.UpdateCard.6714206e5a', - "Orca v{{value0}} is downloaded. Restart when you're ready.", - { value0: version } - )} -
- - -
+
+ )
+}
+
+export function UpdateAvailableSimpleContent({
+ version,
+ releaseUrl,
+ onUpdate,
+ onClose
+}: {
+ version: string
+ releaseUrl?: string
+ onUpdate: () => void
+ onClose: () => void
+}): React.JSX.Element {
+ return (
+
+
+ {showMedia && (
+ + {translate('auto.components.UpdateCard.f58b5c57a6', 'New:')} {release.title} +
+ +
+ {!mediaLoaded && (
+
+ )}
+
+
+ )}
+ + {release.description} + {releasesBehind !== null && releasesBehind > 1 && ( + <> + {' '} + + + )} +
+ + +
+
+ )
+}
diff --git a/src/renderer/src/components/maintenance/update-card/UpdateCardStateContent.tsx b/src/renderer/src/components/maintenance/update-card/UpdateCardStateContent.tsx
new file mode 100644
index 00000000000..3a501f574af
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/UpdateCardStateContent.tsx
@@ -0,0 +1,141 @@
+import type {
+ ChangelogData,
+ LinuxPackageInstallRecovery,
+ UpdateStatus
+} from '../../../../../shared/update-status-types'
+import { getReleaseNotesUrlForVersion } from '../../../../../shared/release-channel'
+import { UpdateErrorCardContent, type UpdateErrorCardModel } from '../../UpdateErrorCardContent'
+import { LinuxPackageInstallRecoveryCard } from '../../LinuxPackageInstallRecoveryCard'
+import { translate } from '@/i18n/i18n'
+import { UpdateCheckFeedback } from './UpdateCheckFeedback'
+import {
+ UpdateAvailableRichContent,
+ UpdateAvailableSimpleContent
+} from './UpdateAvailableCardContent'
+import { UpdateDownloadingContent, UpdateReadyToInstallContent } from './UpdateDownloadCardContent'
+
+export function UpdateCardStateContent({
+ status,
+ changelog,
+ errorCard,
+ linuxPackageRecovery,
+ isLocalBuild,
+ cachedVersion,
+ hasStartedDownload,
+ prefersReducedMotion,
+ mediaFailed,
+ mediaLoaded,
+ onMediaError,
+ onMediaLoad,
+ onUpdate,
+ onInstallRetry,
+ onDismiss,
+ onCollapse
+}: {
+ status: UpdateStatus
+ changelog: ChangelogData | null
+ errorCard: UpdateErrorCardModel | null
+ linuxPackageRecovery: {
+ recovery: LinuxPackageInstallRecovery
+ diagnostic: string
+ } | null
+ isLocalBuild: boolean
+ cachedVersion: string | null
+ hasStartedDownload: boolean
+ prefersReducedMotion: boolean
+ mediaFailed: boolean
+ mediaLoaded: boolean
+ onMediaError: () => void
+ onMediaLoad: () => void
+ onUpdate: () => void
+ onInstallRetry: () => void
+ onDismiss: () => void
+ onCollapse: () => void
+}): React.JSX.Element | null {
+ if (status.state === 'checking') {
+ return (
+
+
+ + {translate('auto.components.UpdateCard.9abc59f814', 'Update Available')} +
+ ++ {translate('auto.components.UpdateCard.05ad78a6d1', 'Orca v{{value0}} is ready.', { + value0: version + })} +
++ {translate('auto.components.UpdateCard.fdd4a364fa', "Sessions won't be interrupted.")} +
+ {releaseUrl && ( + + )} + +
+
+ ) : (
+ + {translate('auto.components.UpdateCard.09a55c39b5', 'Installing...')} +
+
+
+ )
+}
diff --git a/src/renderer/src/components/maintenance/update-card/UpdateDownloadCardContent.tsx b/src/renderer/src/components/maintenance/update-card/UpdateDownloadCardContent.tsx
new file mode 100644
index 00000000000..99752661b39
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/UpdateDownloadCardContent.tsx
@@ -0,0 +1,147 @@
+import { Minus } from 'lucide-react'
+import type { ChangelogData } from '../../../../../shared/update-status-types'
+import { getReleaseNotesUrlForVersion } from '../../../../../shared/release-channel'
+import { Button } from '../../ui/button'
+import { Progress } from '../../ui/progress'
+import { translate } from '@/i18n/i18n'
+
+function isAnimatedGif(url: string | undefined): boolean {
+ return typeof url === 'string' && url.toLowerCase().endsWith('.gif')
+}
+
+export function UpdateDownloadingContent({
+ version,
+ percent,
+ changelog,
+ prefersReducedMotion,
+ mediaFailed,
+ mediaLoaded,
+ onMediaError,
+ onMediaLoad,
+ onCollapse,
+ showReleaseNotes
+}: {
+ version: string
+ percent: number
+ changelog: ChangelogData | null
+ prefersReducedMotion: boolean
+ mediaFailed: boolean
+ mediaLoaded: boolean
+ onMediaError: () => void
+ onMediaLoad: () => void
+ onCollapse: () => void
+ showReleaseNotes: boolean
+}): React.JSX.Element {
+ const release = changelog?.release
+ const showMedia =
+ release?.mediaUrl && !mediaFailed && !(prefersReducedMotion && isAnimatedGif(release.mediaUrl))
+ return (
+
+ {icon === 'spinner' &&
+
+
+ {onClose && (
+
+ )}
+ {text}
+ {action && ( + + )} +
+
+ )
+}
+
+export function UpdateReadyToInstallContent({
+ version,
+ onRestart,
+ onClose
+}: {
+ version: string
+ onRestart: () => void
+ onClose: () => void
+}): React.JSX.Element {
+ return (
+
+ {release ? (
+
+ {showMedia && release?.mediaUrl && (
+ + {translate('auto.components.UpdateCard.f58b5c57a6', 'New:')} {release.title} +
+ ) : ( ++ {translate('auto.components.UpdateCard.558842597d', 'Downloading Update')} +
+ )} + +
+ {!mediaLoaded && (
+
+ )}
+
+
+ )}
+ + {release + ? release.description + : translate('auto.components.UpdateCard.93794ea932', 'Orca v{{value0}} is downloading.', { + value0: version + })} +
+ {showReleaseNotes && ( + + )} +
+
+
+ + {translate('auto.components.UpdateCard.6e45bfa2e0', 'Downloading...')} {percent}% +
+
+
+ )
+}
diff --git a/src/renderer/src/components/maintenance/update-card/update-card-error-model.test.ts b/src/renderer/src/components/maintenance/update-card/update-card-error-model.test.ts
new file mode 100644
index 00000000000..66885476dd6
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/update-card-error-model.test.ts
@@ -0,0 +1,69 @@
+import { describe, expect, it, vi } from 'vitest'
+import type { UpdateStatus } from '../../../../../shared/update-status-types'
+import { buildUpdateCardErrorModel } from './update-card-error-model'
+
+function build(status: UpdateStatus, isLocalBuild = false) {
+ return buildUpdateCardErrorModel({
+ status,
+ isLocalBuild,
+ cachedVersion: '1.4.200',
+ installError: null,
+ compatibilityRelaunching: false,
+ compatibilitySetupError: null,
+ onChooseLocalBuild: vi.fn(),
+ onEnableHttp1Compatibility: vi.fn(),
+ onRetryDownload: vi.fn(),
+ onRecheck: vi.fn(),
+ onInstallRetry: vi.fn()
+ })
+}
+
+describe('update card error model precedence', () => {
+ it('keeps a local build failure out of platform download recovery', () => {
+ const model = build(
+ {
+ state: 'error',
+ source: 'local',
+ message: 'New version is not signed by the application owner'
+ },
+ true
+ )
+ expect(model?.title).toBe('Local Build Error')
+ expect(model?.primaryAction?.label).toBe('Choose Another Build')
+ expect(model?.releaseUrl).toBeUndefined()
+ })
+
+ it('routes publisher mismatch ahead of the generic retry model', () => {
+ const model = build({
+ state: 'error',
+ message: 'New version 1.4.200 is not signed by the application owner: publisherNames: Orca'
+ })
+ expect(model?.variant).toBe('security')
+ expect(model?.primaryAction).toBeUndefined()
+ expect(model?.manualLabel).toBe('Check official releases')
+ })
+
+ it('preserves the pending HTTP/1 compatibility recovery action', () => {
+ const onEnableHttp1Compatibility = vi.fn()
+ const model = buildUpdateCardErrorModel({
+ status: { state: 'error', message: 'net::ERR_HTTP2_PROTOCOL_ERROR' },
+ isLocalBuild: false,
+ cachedVersion: '1.4.200',
+ installError: null,
+ compatibilityRelaunching: true,
+ compatibilitySetupError: null,
+ onChooseLocalBuild: vi.fn(),
+ onEnableHttp1Compatibility,
+ onRetryDownload: vi.fn(),
+ onRecheck: vi.fn(),
+ onInstallRetry: vi.fn()
+ })
+ expect(model?.variant).toBe('http1Compatibility')
+ expect(model?.primaryAction).toMatchObject({
+ label: 'Enable & Restart',
+ pendingLabel: 'Restarting...',
+ isPending: true,
+ onClick: onEnableHttp1Compatibility
+ })
+ })
+})
diff --git a/src/renderer/src/components/maintenance/update-card/update-card-error-model.ts b/src/renderer/src/components/maintenance/update-card/update-card-error-model.ts
new file mode 100644
index 00000000000..37f34f30b6a
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/update-card-error-model.ts
@@ -0,0 +1,133 @@
+import type { UpdateStatus } from '../../../../../shared/update-status-types'
+import type { UpdateErrorCardModel } from '../../UpdateErrorCardContent'
+import {
+ isWindowsSignatureCheckUnavailableFailure,
+ isWindowsSignatureMismatchFailure
+} from '../../../../../shared/updater-windows-signature-check'
+import { getReleaseNotesUrlForVersion } from '../../../../../shared/release-channel'
+import { translate } from '@/i18n/i18n'
+import { isHttp2ProtocolError } from './update-card-visibility'
+
+export function buildUpdateCardErrorModel({
+ status,
+ isLocalBuild,
+ cachedVersion,
+ installError,
+ compatibilityRelaunching,
+ compatibilitySetupError,
+ onChooseLocalBuild,
+ onEnableHttp1Compatibility,
+ onRetryDownload,
+ onRecheck,
+ onInstallRetry
+}: {
+ status: UpdateStatus
+ isLocalBuild: boolean
+ cachedVersion: string | null
+ installError: string | null
+ compatibilityRelaunching: boolean
+ compatibilitySetupError: string | null
+ onChooseLocalBuild: () => void
+ onEnableHttp1Compatibility: () => void
+ onRetryDownload: () => void
+ onRecheck: () => void
+ onInstallRetry: () => void
+}): UpdateErrorCardModel | null {
+ if (status.state !== 'error') {
+ return installError
+ ? {
+ title: translate('auto.components.UpdateCard.4cf109845a', 'Update Error'),
+ summary: 'Could not restart to install the update.',
+ detail: installError,
+ releaseUrl: getReleaseNotesUrlForVersion(cachedVersion),
+ primaryAction: {
+ label: translate('auto.components.UpdateCard.2c2d3e03ca', 'Try Again'),
+ onClick: onInstallRetry
+ }
+ }
+ : null
+ }
+ if (isLocalBuild) {
+ return {
+ title: cachedVersion
+ ? translate('auto.components.UpdateCard.8cf17b10af', 'Local Build Error')
+ : translate('auto.components.UpdateCard.a4650b0dc4', 'Could Not Use Local Build'),
+ summary: cachedVersion
+ ? translate(
+ 'auto.components.UpdateCard.b1e390250d',
+ 'Could not complete the local build switch.'
+ )
+ : translate(
+ 'auto.components.UpdateCard.d29740d175',
+ 'The selected build could not be used.'
+ ),
+ detail: status.message,
+ primaryAction: {
+ label: translate('auto.components.UpdateCard.37d45c9ec1', 'Choose Another Build'),
+ onClick: onChooseLocalBuild
+ }
+ }
+ }
+ if (isHttp2ProtocolError(status.message)) {
+ return {
+ variant: 'http1Compatibility',
+ title: translate('auto.components.UpdateCard.1339b82cee', 'HTTP/2 Download Blocked'),
+ summary: 'Orca can retry through HTTP/1.1 compatibility mode.',
+ explainer: translate(
+ 'auto.components.UpdateCard.90559b14e3',
+ 'This turns on a process-wide Electron networking switch after restart. Use it for corporate VPNs or proxies that reject HTTP/2 update downloads.'
+ ),
+ detail: compatibilitySetupError ?? status.message,
+ releaseUrl: getReleaseNotesUrlForVersion(cachedVersion),
+ primaryAction: {
+ label: translate('auto.components.UpdateCard.933c6fdf5b', 'Enable & Restart'),
+ pendingLabel: 'Restarting...',
+ isPending: compatibilityRelaunching,
+ onClick: onEnableHttp1Compatibility
+ }
+ }
+ }
+ if (isWindowsSignatureMismatchFailure(status.message)) {
+ return {
+ variant: 'security',
+ title: translate('auto.components.UpdateCard.5b309b19f3', "Update Wasn't Installed"),
+ summary: translate(
+ 'auto.components.UpdateCard.092f09fc14',
+ "The installer's publisher doesn't match Orca, so we stopped the update. Don't install this download; check official releases for a corrected version."
+ ),
+ detail: status.message,
+ releaseUrl: getReleaseNotesUrlForVersion(null),
+ manualLabel: translate('auto.components.UpdateCard.c9ff9b9ec2', 'Check official releases')
+ }
+ }
+ if (isWindowsSignatureCheckUnavailableFailure(status.message)) {
+ return {
+ title: translate('auto.components.UpdateCard.e944c2de43', 'Update Verification Blocked'),
+ summary: translate(
+ 'auto.components.UpdateCard.a05992a26b',
+ "The signature check couldn't run — usually because antivirus software blocked it. Retry the download, or get the installer from our official releases."
+ ),
+ detail: status.message,
+ releaseUrl: getReleaseNotesUrlForVersion(cachedVersion),
+ primaryAction: {
+ label: translate('auto.components.UpdateCard.48565a32bc', 'Retry Download'),
+ onClick: onRetryDownload
+ }
+ }
+ }
+ return {
+ title: cachedVersion ? 'Update Error' : 'Update Check Failed',
+ summary: cachedVersion ? 'Could not complete the update.' : 'Could not check for updates.',
+ detail: status.message,
+ releaseUrl: getReleaseNotesUrlForVersion(cachedVersion),
+ primaryAction: cachedVersion
+ ? {
+ label: translate('auto.components.UpdateCard.48565a32bc', 'Retry Download'),
+ onClick: onRetryDownload
+ }
+ : {
+ label: translate('auto.components.UpdateCard.6b0085010d', 'Re-check'),
+ onClick: onRecheck
+ }
+ }
+}
diff --git a/src/renderer/src/components/maintenance/update-card/update-card-visibility.ts b/src/renderer/src/components/maintenance/update-card/update-card-visibility.ts
new file mode 100644
index 00000000000..038bf1542c6
--- /dev/null
+++ b/src/renderer/src/components/maintenance/update-card/update-card-visibility.ts
@@ -0,0 +1,79 @@
+import type { UpdateStatus } from '../../../../../shared/update-status-types'
+
+export function isUpdateCardVisible({
+ status,
+ dismissedVersion,
+ cachedVersion,
+ hasStartedDownload,
+ updateUserInitiatedCycle,
+ autoDismissed = false,
+ errorDismissed = false,
+ collapsed = false
+}: {
+ status: UpdateStatus
+ dismissedVersion: string | null
+ cachedVersion: string | null
+ hasStartedDownload: boolean
+ updateUserInitiatedCycle: boolean
+ autoDismissed?: boolean
+ errorDismissed?: boolean
+ collapsed?: boolean
+}): boolean {
+ const isUserInitiated = 'userInitiated' in status && Boolean(status.userInitiated)
+ const shouldShowDetailedErrorCard =
+ status.state === 'error' && (hasStartedDownload || cachedVersion !== null)
+
+ if (status.state === 'checking' && !isUserInitiated) {
+ return false
+ }
+ if (status.state === 'not-available' && (!isUserInitiated || autoDismissed)) {
+ return false
+ }
+ if (status.state === 'idle') {
+ return false
+ }
+ if (status.state === 'error' && !shouldShowDetailedErrorCard && !isUserInitiated) {
+ return false
+ }
+ if (status.state === 'error' && errorDismissed) {
+ return false
+ }
+
+ if (cachedVersion && dismissedVersion === cachedVersion && !updateUserInitiatedCycle) {
+ if (status.state !== 'downloading' && status.state !== 'error') {
+ return false
+ }
+ }
+ return !(
+ collapsed &&
+ (status.state === 'downloading' || status.state === 'downloaded' || status.state === 'error')
+ )
+}
+
+export function getUpdateCardAriaLabel(status: UpdateStatus): string {
+ switch (status.state) {
+ case 'idle':
+ return 'Update status'
+ case 'checking':
+ return 'Checking for updates'
+ case 'not-available':
+ return "You're on the latest version"
+ case 'available':
+ return 'Update available'
+ case 'downloading':
+ return 'Downloading update'
+ case 'downloaded':
+ return 'Update ready to install'
+ case 'error':
+ return 'Update error'
+ }
+}
+
+export function isHttp2ProtocolError(message: string): boolean {
+ const normalized = message.toLowerCase()
+ return (
+ normalized.includes('err_http2_protocol_error') ||
+ normalized.includes('http2_protocol_error') ||
+ (normalized.includes('http/2') && normalized.includes('protocol'))
+ )
+}
diff --git a/src/renderer/src/components/settings/AgentCatalogRow.tsx b/src/renderer/src/components/settings/AgentCatalogRow.tsx
new file mode 100644
index 00000000000..d9f6c926c39
--- /dev/null
+++ b/src/renderer/src/components/settings/AgentCatalogRow.tsx
@@ -0,0 +1,249 @@
+import { useState } from 'react'
+import { Check, ChevronDown, ExternalLink } from 'lucide-react'
+import type { TuiAgent } from '../../../../shared/tui-agent'
+import { AgentIcon } from '@/lib/agent-catalog'
+import { cn } from '@/lib/utils'
+import { translate } from '@/i18n/i18n'
+import { Button } from '../ui/button'
+import { SettingsBadge, SettingsSegmentedControl } from './SettingsFormControls'
+import type { AgentSessionSourceHomeControl } from './codex-session-source-home-control'
+import { AgentSessionSourceHomeInput } from './codex-session-source-home-control'
+import { stringifyAgentDefaultEnvDraft } from './agent-default-env-draft'
+import {
+ AgentCommandOverrideInput,
+ AgentDefaultArgsInput,
+ AgentDefaultEnvInput
+} from './AgentLaunchDefaultsEditor'
+
+type AgentAvailability = 'enabled' | 'disabled'
+
+export function AgentAvailabilityControl({
+ label,
+ isEnabled,
+ onSetEnabled
+}: {
+ label: string
+ isEnabled: boolean
+ onSetEnabled: (enabled: boolean) => void
+}): React.JSX.Element {
+ const value: AgentAvailability = isEnabled ? 'enabled' : 'disabled'
+ return (
+
+
+ + {translate('auto.components.UpdateCard.17412483da', 'Ready to Install')} +
+ ++ {translate( + 'auto.components.UpdateCard.6714206e5a', + "Orca v{{value0}} is downloaded. Restart when you're ready.", + { value0: version } + )} +
+ +
+
+ )
+}
diff --git a/src/renderer/src/components/settings/AgentDefaultSetting.tsx b/src/renderer/src/components/settings/AgentDefaultSetting.tsx
new file mode 100644
index 00000000000..4f70577bf8f
--- /dev/null
+++ b/src/renderer/src/components/settings/AgentDefaultSetting.tsx
@@ -0,0 +1,104 @@
+import { Check, Terminal } from 'lucide-react'
+import type { TuiAgent } from '../../../../shared/tui-agent'
+import type { AgentCatalogEntry } from '@/lib/agent-catalog'
+import { AgentIcon } from '@/lib/agent-catalog'
+import { cn } from '@/lib/utils'
+import { translate } from '@/i18n/i18n'
+import { SettingsSubsectionHeader } from './SettingsFormControls'
+
+function DefaultAgentPill({
+ active,
+ onClick,
+ children,
+ title
+}: {
+ active: boolean
+ onClick: () => void
+ children: React.ReactNode
+ title?: string
+}): React.JSX.Element {
+ return (
+
+ )
+}
+
+export function AgentDefaultSetting({
+ defaultAgent,
+ detectedIds,
+ enabledDetectedAgents,
+ catalog,
+ description,
+ onSetDefault
+}: {
+ defaultAgent: TuiAgent | 'blank' | null
+ detectedIds: Set
+
+
+ {isDetected && cmdOpen && (
+
+
+
+
+
+
+
+ {label}
+ {!isEnabled && (
+
+ {translate('auto.components.settings.AgentsPane.8dc0192e48', 'Disabled')}
+
+ )}
+
+
+ {cmdOverride ? (
+
+ {defaultCmd}
+ {cmdOverride}
+
+ ) : (
+ defaultCmd
+ )}
+ {argsOverride && {argsOverride}}
+ {envSummary && {envSummary}}
+
+
+
+ )}
+
+
+ {(defaultEnvSummary || envSummary) && (
+
+
+ )}
+ {sessionSourceHome && (
+
+
+ )}
+ + {translate( + 'auto.components.settings.AgentsPane.f9f127d664', + 'Override the binary path or name, and edit the default launch arguments or environment for this agent.' + )} +
+
+ onSetDefault(null)}>
+ {defaultAgent === null &&
+ onSetDefault('blank')}>
+
+ {defaultAgentPills.map((agent) => {
+ const isActive = defaultAgent === agent.id
+ const isUndetected = detectedIds !== null && !detectedIds.has(agent.id)
+ return (
+ onSetDefault(agent.id)}
+ title={
+ isUndetected
+ ? translate(
+ 'auto.components.settings.AgentsPane.storedDefaultUndetected',
+ 'Saved as your default, but not detected right now'
+ )
+ : undefined
+ }
+ >
+
+ )
+ })}
+
+
+
+ {translate(
+ 'auto.components.settings.AgentsPane.noAgentsDetected',
+ 'No agents detected. If one is installed, the probe may have timed out.'
+ )}
+
+
+ )}
+
+ {detectedAgents.length > 0 && (
+
+ {detectedAgents.map((agent) => (
+
+
+ {undetectedAgents.map((agent) => (
+
+
+ {translate(
+ 'auto.components.settings.AgentsPane.d83834f5e6',
+ 'Detecting installed agents…'
+ )}
+
+ )}
+
+ {detectionFailed && (
+
+
+
+ )}
+
+ )
+}
+
+function RefreshButton({
+ isRefreshing,
+ onRefresh
+}: {
+ isRefreshing: boolean
+ onRefresh: () => void
+}): React.JSX.Element {
+ return (
+
+ )
+}
diff --git a/src/renderer/src/components/settings/AgentLaunchDefaultsEditor.tsx b/src/renderer/src/components/settings/AgentLaunchDefaultsEditor.tsx
new file mode 100644
index 00000000000..d6e51da9f49
--- /dev/null
+++ b/src/renderer/src/components/settings/AgentLaunchDefaultsEditor.tsx
@@ -0,0 +1,216 @@
+import { useId, useState } from 'react'
+import { Button } from '../ui/button'
+import { Input } from '../ui/input'
+import { cn } from '@/lib/utils'
+import { translate } from '@/i18n/i18n'
+import { parseAgentDefaultEnvDraft, stringifyAgentDefaultEnvDraft } from './agent-default-env-draft'
+
+export function AgentCommandOverrideInput({
+ defaultCmd,
+ cmdOverride,
+ onSaveOverride
+}: {
+ defaultCmd: string
+ cmdOverride: string | undefined
+ onSaveOverride: (value: string) => void
+}): React.JSX.Element {
+ const draftSeed = cmdOverride ?? defaultCmd
+ const [cmdDraft, setCmdDraft] = useState(draftSeed)
+ const commitCmd = (): void => {
+ const trimmed = cmdDraft.trim()
+ if (!trimmed || trimmed === defaultCmd) {
+ onSaveOverride('')
+ setCmdDraft(defaultCmd)
+ } else {
+ onSaveOverride(trimmed)
+ }
+ }
+
+ return (
+
+
+ {translate('auto.components.settings.AgentsPane.2e45ca29b6', 'Command')}
+
+
+ )
+}
+
+export function AgentDefaultArgsInput({
+ defaultArgs,
+ argsOverride,
+ onSaveArgs
+}: {
+ defaultArgs: string
+ argsOverride: string
+ onSaveArgs: (value: string) => void
+}): React.JSX.Element {
+ const [argsDraft, setArgsDraft] = useState(argsOverride)
+ const commitArgs = (): void => onSaveArgs(argsDraft.trim())
+
+ return (
+
+ setCmdDraft(event.target.value)}
+ onBlur={commitCmd}
+ onKeyDown={(event) => {
+ if (event.key === 'Enter') {
+ commitCmd()
+ event.currentTarget.blur()
+ }
+ if (event.key === 'Escape') {
+ setCmdDraft(draftSeed)
+ event.currentTarget.blur()
+ }
+ }}
+ placeholder={defaultCmd}
+ spellCheck={false}
+ className="h-7 flex-1 font-mono text-xs"
+ />
+ {cmdOverride && (
+
+ )}
+
+
+
+ {translate('auto.components.settings.AgentsPane.cfb3f35775', 'Arguments')}
+
+
+ )
+}
+
+export function AgentDefaultEnvInput({
+ defaultEnv,
+ envOverride,
+ onSaveEnv
+}: {
+ defaultEnv: Record
+ setArgsDraft(event.target.value)}
+ onBlur={commitArgs}
+ onKeyDown={(event) => {
+ if (event.key === 'Enter') {
+ commitArgs()
+ event.currentTarget.blur()
+ }
+ if (event.key === 'Escape') {
+ setArgsDraft(argsOverride)
+ event.currentTarget.blur()
+ }
+ }}
+ placeholder={
+ defaultArgs ||
+ translate('auto.components.settings.AgentsPane.6f99bf5dd0', 'No default arguments')
+ }
+ spellCheck={false}
+ className="h-7 flex-1 font-mono text-xs"
+ />
+ {argsOverride !== defaultArgs && (
+
+ )}
+
+
+
+ {translate('auto.components.settings.AgentsPane.8fbe1f37c1', 'Environment')}
+
+
+ )
+}
diff --git a/src/renderer/src/components/settings/AgentsPane.tsx b/src/renderer/src/components/settings/AgentsPane.tsx
index 95abad76b35..59e139973ad 100644
--- a/src/renderer/src/components/settings/AgentsPane.tsx
+++ b/src/renderer/src/components/settings/AgentsPane.tsx
@@ -1,39 +1,20 @@
-/* eslint-disable max-lines -- Why: the Agents pane keeps catalog rows, default
- selection, per-agent controls, and runtime location together so settings
- reconciliation stays visible in one file. */
-import { useId, useMemo, useState } from 'react'
-import {
- AlertTriangle,
- Check,
- ChevronDown,
- ExternalLink,
- Info,
- RefreshCw,
- Terminal
-} from 'lucide-react'
+import { useMemo } from 'react'
+import { Info } from 'lucide-react'
import type { GlobalSettings } from '../../../../shared/global-settings-types'
import type { TuiAgent } from '../../../../shared/tui-agent'
-import { getAgentCatalog, AgentIcon } from '@/lib/agent-catalog'
+import { getAgentCatalog } from '@/lib/agent-catalog'
import { useDetectedAgents, type AgentDetectionTarget } from '@/hooks/useDetectedAgents'
import { useAppStore } from '@/store'
-import { Button } from '../ui/button'
-import { Input } from '../ui/input'
-import { cn } from '@/lib/utils'
import { AgentAwakeSetting } from './AgentAwakeSetting'
import { AgentCacheTimerSection } from './AgentCacheTimerSection'
import { AgentRuntimeSetting } from './AgentRuntimeSetting'
-import {
- AgentSessionSourceHomeInput,
- buildCodexSessionSourceHomeControl,
- type AgentSessionSourceHomeControl
-} from './codex-session-source-home-control'
+import { buildCodexSessionSourceHomeControl } from './codex-session-source-home-control'
import {
getAgentGeneratedTabTitlesDescription,
getAgentGeneratedTabTitlesTitle
} from './agent-generated-tab-title-copy'
import { getAgentStatusHooksDescription, getAgentStatusHooksTitle } from './agent-status-hooks-copy'
import {
- SettingsBadge,
SettingsSegmentedControl,
SettingsSubsectionHeader,
SettingsSwitchRow
@@ -56,10 +37,22 @@ import {
import { getSettingOwnershipSummary } from './setting-ownership'
import { translate } from '@/i18n/i18n'
import { Tooltip, TooltipContent, TooltipTrigger } from '../ui/tooltip'
-import { parseAgentDefaultEnvDraft, stringifyAgentDefaultEnvDraft } from './agent-default-env-draft'
import { isPairedWebClientWindow } from '@/lib/desktop-window-chrome'
+import { getAgentsPaneSearchEntries } from './agents-search'
+import {
+ buildAgentAvailabilitySettingsUpdate,
+ createAgentAvailabilityUpdateQueue
+} from './agent-availability-settings'
+import { AgentAvailabilityControl, type AgentCatalogRowProps } from './AgentCatalogRow'
+import { AgentDefaultSetting } from './AgentDefaultSetting'
+import { AgentDetectionCatalog } from './AgentDetectionCatalog'
-export { getAgentsPaneSearchEntries } from './agents-search'
+export {
+ buildAgentAvailabilitySettingsUpdate,
+ createAgentAvailabilityUpdateQueue,
+ getAgentsPaneSearchEntries,
+ AgentAvailabilityControl
+}
type AgentsPaneProps = {
settings: GlobalSettings
@@ -70,145 +63,15 @@ type AgentsPaneProps = {
wslCapabilitiesLoading?: boolean
}
-type AgentAvailabilityUpdateQueueOptions = {
- getSettings: () => GlobalSettings | null | undefined
- fallbackSettings: GlobalSettings
- updateSettings: AgentsPaneProps['updateSettings']
- agentId: TuiAgent
- enabled: boolean
-}
-
-type AgentRowProps = {
- agentId: TuiAgent
- label: string
- homepageUrl: string
- defaultCmd: string
- defaultArgs: string
- defaultEnv: Record
+ {
+ setEnvDraft(event.target.value)
+ if (envDraftTooLarge) {
+ setEnvDraftTooLarge(false)
+ }
+ }}
+ onBlur={commitEnv}
+ onKeyDown={(event) => {
+ if (event.key === 'Enter') {
+ commitEnv()
+ event.currentTarget.blur()
+ }
+ if (event.key === 'Escape') {
+ setEnvDraft(draftSeed)
+ setEnvDraftTooLarge(false)
+ event.currentTarget.blur()
+ }
+ }}
+ placeholder={
+ defaultEnvText ||
+ translate('auto.components.settings.AgentsPane.2d133152fa', 'No default environment')
+ }
+ spellCheck={false}
+ aria-invalid={envDraftTooLarge || undefined}
+ aria-describedby={envDraftTooLarge ? envDraftErrorId : undefined}
+ className={cn(
+ 'h-7 flex-1 font-mono text-xs',
+ envDraftTooLarge && 'border-destructive/50 bg-destructive/5'
+ )}
+ />
+ {draftSeed !== defaultEnvText && (
+
+ )}
+
+ {envDraftTooLarge && (
+ + {translate( + 'auto.components.settings.AgentsPane.3f1bdf3cb4', + 'Environment text is too large to parse safely.' + )} +
+ )} +
-
- {translate('auto.components.settings.AgentsPane.2e45ca29b6', 'Command')}
-
-
- )
-}
-
-function AgentDefaultArgsInput({
- defaultArgs,
- argsOverride,
- onSaveArgs
-}: AgentDefaultArgsInputProps): React.JSX.Element {
- const draftSeed = argsOverride
- const [argsDraft, setArgsDraft] = useState(draftSeed)
-
- const commitArgs = (): void => {
- onSaveArgs(argsDraft.trim())
- }
-
- return (
-
- setCmdDraft(e.target.value)}
- onBlur={commitCmd}
- onKeyDown={(e) => {
- if (e.key === 'Enter') {
- commitCmd()
- e.currentTarget.blur()
- }
- if (e.key === 'Escape') {
- setCmdDraft(draftSeed)
- e.currentTarget.blur()
- }
- }}
- placeholder={defaultCmd}
- spellCheck={false}
- className="h-7 flex-1 font-mono text-xs"
- />
- {cmdOverride && (
-
- )}
-
-
-
- {translate('auto.components.settings.AgentsPane.cfb3f35775', 'Arguments')}
-
-
- )
-}
-
-function AgentDefaultEnvInput({
- defaultEnv,
- envOverride,
- onSaveEnv
-}: AgentDefaultEnvInputProps): React.JSX.Element {
- const defaultEnvText = stringifyAgentDefaultEnvDraft(defaultEnv)
- const draftSeed = stringifyAgentDefaultEnvDraft(envOverride)
- const [envDraft, setEnvDraft] = useState(draftSeed)
- const [envDraftTooLarge, setEnvDraftTooLarge] = useState(false)
- const envDraftErrorId = useId()
-
- const commitEnv = (): void => {
- const parsedDraft = parseAgentDefaultEnvDraft(envDraft)
- setEnvDraftTooLarge(parsedDraft.tooLarge)
- if (parsedDraft.tooLarge) {
- return
- }
- onSaveEnv(parsedDraft.env)
- }
-
- return (
-
- setArgsDraft(e.target.value)}
- onBlur={commitArgs}
- onKeyDown={(e) => {
- if (e.key === 'Enter') {
- commitArgs()
- e.currentTarget.blur()
- }
- if (e.key === 'Escape') {
- setArgsDraft(draftSeed)
- e.currentTarget.blur()
- }
- }}
- placeholder={
- defaultArgs ||
- translate('auto.components.settings.AgentsPane.6f99bf5dd0', 'No default arguments')
- }
- spellCheck={false}
- className="h-7 flex-1 font-mono text-xs"
- />
- {argsOverride !== defaultArgs && (
-
- )}
-
-
-
- {translate('auto.components.settings.AgentsPane.8fbe1f37c1', 'Environment')}
-
-
- )
-}
-
-function AgentRow({
- agentId,
- label,
- homepageUrl,
- defaultCmd,
- defaultArgs,
- defaultEnv,
- isDetected,
- isEnabled,
- isDefault,
- cmdOverride,
- argsOverride,
- envOverride,
- onSetDefault,
- onSetEnabled,
- onSaveOverride,
- onSaveArgs,
- onSaveEnv,
- sessionSourceHome
-}: AgentRowProps): React.JSX.Element {
- const envSummary = stringifyAgentDefaultEnvDraft(envOverride)
- const defaultEnvSummary = stringifyAgentDefaultEnvDraft(defaultEnv)
- const [cmdOpen, setCmdOpen] = useState(
- Boolean(cmdOverride) || argsOverride !== defaultArgs || envSummary !== defaultEnvSummary
- )
-
- return (
-
- {
- setEnvDraft(e.target.value)
- if (envDraftTooLarge) {
- setEnvDraftTooLarge(false)
- }
- }}
- onBlur={commitEnv}
- onKeyDown={(e) => {
- if (e.key === 'Enter') {
- commitEnv()
- e.currentTarget.blur()
- }
- if (e.key === 'Escape') {
- setEnvDraft(draftSeed)
- setEnvDraftTooLarge(false)
- e.currentTarget.blur()
- }
- }}
- placeholder={
- defaultEnvText ||
- translate('auto.components.settings.AgentsPane.2d133152fa', 'No default environment')
- }
- spellCheck={false}
- aria-invalid={envDraftTooLarge || undefined}
- aria-describedby={envDraftTooLarge ? envDraftErrorId : undefined}
- className={cn(
- 'h-7 flex-1 font-mono text-xs',
- envDraftTooLarge && 'border-destructive/50 bg-destructive/5'
- )}
- />
- {draftSeed !== defaultEnvText && (
-
- )}
-
- {envDraftTooLarge && (
- - {translate( - 'auto.components.settings.AgentsPane.3f1bdf3cb4', - 'Environment text is too large to parse safely.' - )} -
- )} -
-
- )
-}
-
-type DefaultAgentPillProps = {
- active: boolean
- onClick: () => void
- children: React.ReactNode
- title?: string
-}
-
-function DefaultAgentPill({
- active,
- onClick,
- children,
- title
-}: DefaultAgentPillProps): React.JSX.Element {
- return (
-
- )
-}
-
export function AgentsPane({
settings,
updateSettings,
@@ -696,10 +146,6 @@ export function AgentsPane({
wslDistros,
wslCapabilitiesLoading
}: AgentsPaneProps): React.JSX.Element {
- // Why: the Active Server routes agent launches and provider checks through
- // that server, so this pane must list what THAT host can launch — detecting
- // on the client showed a Windows machine's agents while paired to a Linux
- // server (the enable/disable/default toggles below stay client settings).
const activeServerEnvironmentId = settings.activeRuntimeEnvironmentId?.trim() || null
const agentDetectionTarget = useMemo
-
-
- {isDetected && cmdOpen && (
-
-
-
-
-
-
-
-
- {label}
- {!isEnabled && (
-
- {translate('auto.components.settings.AgentsPane.8dc0192e48', 'Disabled')}
-
- )}
-
-
- {cmdOverride ? (
-
- {defaultCmd}
- {cmdOverride}
-
- ) : (
- defaultCmd
- )}
- {argsOverride && {argsOverride}}
- {envSummary && {envSummary}}
-
-
- {/* Why: key by the persisted seed so settings changes reset the draft during reconciliation, not in a follow-up effect commit. */}
-
- )}
-
-
- {(defaultEnvSummary || envSummary) && (
-
-
- )}
- {sessionSourceHome && (
-
-
- )}
- - {translate( - 'auto.components.settings.AgentsPane.f9f127d664', - 'Override the binary path or name, and edit the default launch arguments or environment for this agent.' - )} -
-
-
-
-
+ updateSettings({ defaultTuiAgent: agent })}
+ />
-
- {translate('auto.components.settings.AgentsPane.02e0143be5', 'Installed')}
-
- {detectedAgents.length}{' '}
- {translate('auto.components.settings.AgentsPane.ed3e110e61', 'detected')}
-
- {activeServerName ? (
-
- {translate('auto.components.settings.AgentsPane.03e1a5081a', 'on {{value0}}', {
- value0: activeServerName
- })}
-
- ) : null}
-
- }
- action={
-
- }
- />
-
-
- )}
-
- {undetectedAgents.length > 0 && (
-
-
- {translate(
- 'auto.components.settings.AgentsPane.e8da2af684',
- 'Available to install'
- )}
-
- {undetectedAgents.length}{' '}
- {translate('auto.components.settings.AgentsPane.024bd95089', 'agents')}
-
-
- }
- />
-
-
- )}
-
- {detectedIds === null && !detectionFailed && (
-
+ updateSettings(applyAgentPermissionMode({ mode, agentDefaultArgs, agentDefaultEnv }))
+ }
+ />
+ void refreshTargetAgents()}
+ getRowProps={getRowProps}
+ />
)
}
-export function AgentStatusHooksSetting({
- settings,
- updateSettings
-}: AgentsPaneProps): React.JSX.Element {
+export function AgentStatusHooksSetting({ settings, updateSettings }: AgentsPaneProps) {
const enabled = settings.agentStatusHooksEnabled !== false
return (
- setDefault(null)}>
- {isAutoDefault &&
-
- {/* Why: users who prefer to open a raw shell by default need a
- first-class "no agent" choice here — without it, the Auto pill
- is the closest option but silently launches the first detected
- agent, which is the opposite of what they want. */}
- setDefault('blank')}>
-
-
- {defaultAgentPills.map((agent) => {
- const isActive = defaultAgent === agent.id
- const isUndetected = detectedIds !== null && !detectedIds.has(agent.id)
- return (
- setDefault(agent.id)}
- title={
- isUndetected
- ? translate(
- 'auto.components.settings.AgentsPane.storedDefaultUndetected',
- 'Saved as your default, but not detected right now'
- )
- : undefined
- }
- >
-
- )
- })}
-
-
- {/* Why here and not only inside Installed: that section renders under
- `detectedAgents.length > 0`, so the only Refresh control vanished
- in precisely the state that needs a retry (#15256). */}
-
- {translate(
- 'auto.components.settings.AgentsPane.noAgentsDetected',
- 'No agents detected. If one is installed, the probe may have timed out.'
- )}
-
-
-
- )}
-
- {detectedAgents.length > 0 && (
-
- {detectedAgents.map((agent) => (
- setDefault(agent.id)}
- onSetEnabled={(enabled) => setAgentEnabled(agent.id, enabled)}
- onSaveOverride={(v) => saveOverride(agent.id, v)}
- onSaveArgs={(v) => saveAgentArgs(agent.id, v)}
- onSaveEnv={(v) => saveAgentEnv(agent.id, v)}
- sessionSourceHome={
- agent.id === 'codex'
- ? buildCodexSessionSourceHomeControl(settings, updateSettings)
- : undefined
- }
- />
- ))}
-
-
- {undetectedAgents.map((agent) => (
- {}}
- onSetEnabled={(enabled) => setAgentEnabled(agent.id, enabled)}
- onSaveOverride={() => {}}
- onSaveArgs={(v) => saveAgentArgs(agent.id, v)}
- onSaveEnv={(v) => saveAgentEnv(agent.id, v)}
- />
- ))}
-
-
- {translate(
- 'auto.components.settings.AgentsPane.d83834f5e6',
- 'Detecting installed agents…'
- )}
-
- )}
-
- {detectionFailed && (
-
-
-
- )}
+
+ {options.map(({ policy, label, description }) => (
+
+ ))}
+
+ )
+}
+
+function getSetupRunPolicyOptions(): PolicyOption
+
+ )
+}
+
+function getCommandSourceLabel(policy: HookCommandSourcePolicy): string {
+ if (policy === 'shared-only') {
+ return translate('auto.components.settings.RepositoryHooksSection.d88b6ff88f', 'orca.yaml only')
+ }
+ if (policy === 'local-only') {
+ return translate('auto.components.settings.RepositoryHooksSection.83dc78202a', 'Local only')
+ }
+ return translate('auto.components.settings.RepositoryHooksSection.8d6c56bff8', 'Run both')
+}
+
+export function RepositoryHookCommandSourceSetting({
+ searchQuery,
+ selectedPolicy,
+ yamlState,
+ yamlHooks,
+ copiedTemplate,
+ isAdvancedOpen,
+ onSelectPolicy,
+ onCopyTemplate,
+ onAdvancedOpenChange
+}: {
+ searchQuery: string
+ selectedPolicy: HookCommandSourcePolicy
+ yamlState: string
+ yamlHooks: OrcaHooks | null
+ copiedTemplate: boolean
+ isAdvancedOpen: boolean
+ onSelectPolicy: (policy: HookCommandSourcePolicy) => void
+ onCopyTemplate: () => void
+ onAdvancedOpenChange: (open: boolean) => void
+}): React.JSX.Element {
+ const advancedMatchesSearch =
+ searchQuery.trim() !== '' &&
+ matchesSettingsSearch(searchQuery, {
+ title: translate('auto.components.settings.RepositoryHooksSection.c9bc1bfd8f', 'Advanced'),
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.610d90fdbd',
+ 'Command source and orca.yaml details.'
+ ),
+ keywords: [
+ translate('auto.components.settings.RepositoryHooksSection.c5a55a2d2e', 'advanced'),
+ translate('auto.components.settings.RepositoryHooksSection.4611b78617', 'command source'),
+ translate('auto.components.settings.RepositoryHooksSection.39da2ae12f', 'orca.yaml'),
+ translate('auto.components.settings.RepositoryHooksSection.d2b3016c20', 'shared'),
+ translate('auto.components.settings.RepositoryHooksSection.2d03a514db', 'local'),
+ translate('auto.components.settings.RepositoryHooksSection.0518758f38', 'both'),
+ translate('auto.components.settings.RepositoryHooksSection.fac13f8c1e', 'authoritative')
+ ]
+ })
+ const options = getCommandSourcePolicyOptions()
+ return (
+
+
+
+
+ + {translate('auto.components.settings.RepositoryHooksSection.793dcee97d', 'When to run')} +
++ {translate( + 'auto.components.settings.RepositoryHooksSection.21fb607a87', + 'Default behavior when a new worktree is created.' + )} +
+
+
+ onStartupPolicyChange(
+ setupAgentStartupPolicy === 'wait-for-setup' ? 'start-immediately' : 'wait-for-setup'
+ )
+ }
+ ariaLabel={translate(
+ 'auto.components.settings.RepositoryHooksSection.waitForSetupBeforeAgent',
+ 'Wait for setup to complete before starting agent'
+ )}
+ />
+
+
+
+ + {translate( + 'auto.components.settings.RepositoryHooksSection.waitForSetupBeforeAgent', + 'Wait for setup to complete before starting agent' + )} +
++ {translate( + 'auto.components.settings.RepositoryHooksSection.waitForSetupBeforeAgentHelp', + 'Turn this on when setup installs dependencies, MCP servers, or config files the agent needs during startup.' + )} +
+ {
+ if (advancedMatchesSearch) {
+ event.currentTarget.open = true
+ } else {
+ onAdvancedOpenChange(event.currentTarget.open)
+ }
+ }}
+ >
+ {
+ if (advancedMatchesSearch) {
+ event.preventDefault()
+ }
+ }}
+ >
+
+
+ )
+}
diff --git a/src/renderer/src/components/settings/RepositoryHookScriptSetting.tsx b/src/renderer/src/components/settings/RepositoryHookScriptSetting.tsx
new file mode 100644
index 00000000000..c6457140ffa
--- /dev/null
+++ b/src/renderer/src/components/settings/RepositoryHookScriptSetting.tsx
@@ -0,0 +1,280 @@
+import { useEffect, useRef, useState } from 'react'
+import { AlertTriangle, Plus } from 'lucide-react'
+import { Button } from '../ui/button'
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '../ui/tooltip'
+import { translate } from '@/i18n/i18n'
+import { getRepositoryHookScriptTextareaRows } from '@/lib/script-textarea-rows'
+import type {
+ LocalCommandSourcePolicyNotice,
+ LocalHookField
+} from './repository-hook-settings-draft'
+
+function getEnvVars(): { name: string; description: string }[] {
+ return [
+ {
+ name: '$ORCA_ROOT_PATH',
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.30952c4aa4',
+ 'Path to the main repo checkout. Useful for copying shared files, like .env, into a worktree.'
+ )
+ },
+ {
+ name: '$ORCA_WORKTREE_PATH',
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.54c73d88d0',
+ 'Path to the worktree being created. Setup commands run from this directory.'
+ )
+ },
+ {
+ name: '$ORCA_WORKSPACE_NAME',
+ description: translate(
+ 'auto.components.settings.RepositoryHooksSection.0fa21e19ec',
+ 'Name of the workspace, usually based on the branch name.'
+ )
+ }
+ ]
+}
+
+function EnvVarChips(): React.JSX.Element {
+ const envVars = getEnvVars()
+ return (
+ {
+ if (advancedMatchesSearch) {
+ event.preventDefault()
+ }
+ }}
+ >
+
+
+ {translate('auto.components.settings.RepositoryHooksSection.c9bc1bfd8f', 'Advanced')}
+
+
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.bbbd6e0bc4',
+ 'Command source & orca.yaml'
+ )}
+
+
+
+ {getCommandSourceLabel(selectedPolicy)}
+
+
+ + {translate('auto.components.settings.RepositoryHooksSection.c9bc1bfd8f', 'Advanced')} +
+ + {translate( + 'auto.components.settings.RepositoryHooksSection.bbbd6e0bc4', + 'Command source & orca.yaml' + )} + +
+
+
+
+
+
+ + {translate( + 'auto.components.settings.RepositoryHooksSection.32fec28f5b', + 'Command Source' + )} +
+
+ {translate('auto.components.settings.RepositoryHooksSection.ac9038d2cc', 'When both')}{' '}
+
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.39da2ae12f',
+ 'orca.yaml'
+ )}
+ {' '}
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.3397879bee',
+ 'and local commands exist, choose which run.'
+ )}
+
+ {options.map(({ policy, label, description }) => (
+
+ ))}
+
+
+
+
+
+ )
+}
+
+function SaveIndicator({ status }: { status: 'idle' | 'saving' | 'saved' }) {
+ if (status === 'idle') {
+ return null
+ }
+ const isSaving = status === 'saving'
+ return (
+
+
+ {isSaving
+ ? translate('auto.components.settings.RepositoryHooksSection.81057d5f71', 'Saving...')
+ : translate('auto.components.settings.RepositoryHooksSection.2b6356e744', 'Saved')}
+
+ )
+}
+
+export function RepositoryHookScriptSetting({
+ field,
+ value,
+ hasShared,
+ sharedScript,
+ onChange,
+ onCommit,
+ sectionId
+}: {
+ field: LocalHookField
+ value: string
+ hasShared: boolean
+ sharedScript: string | undefined
+ onChange: (next: string) => void
+ onCommit: () => void
+ sectionId?: string
+}): React.JSX.Element {
+ const [showLocal, setShowLocal] = useState(value.length > 0)
+ const [saveStatus, setSaveStatus] = useState<'idle' | 'saving' | 'saved'>('idle')
+ const lastValueRef = useRef(value)
+ const savedTimerRef = useRef+ {translate( + 'auto.components.settings.RepositoryHooksSection.b2b06c7ce8', + 'Available environment variables (hover for details):' + )} +
+
+ {envVars.map(({ name, description }) => (
+
+
+
+
+ {description}
+
+
+ ))}
+
+
+ {name}
+
+
+
+
+ {field.label}
+{field.description}
+
+
+ ) : null}
+ {showLocalEditor ? (
+
+
+ {translate('auto.components.settings.RepositoryHooksSection.39da2ae12f', 'orca.yaml')}
+
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.f828e1de19',
+ '- shared with your team'
+ )}
+
+
+
+ {translate('auto.components.settings.RepositoryHooksSection.b113344b6a', 'Edit')}{' '}
+
+
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.39da2ae12f',
+ 'orca.yaml'
+ )}
+ {' '}
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.7e4427b4a2',
+ 'to change.'
+ )}
+
+
+ {sharedScript ?? ''}
+
+
+
+ {hasShared ? (
+
+ {translate('auto.components.settings.RepositoryHooksSection.2d03a514db', 'local')}
+
+ {translate(
+ 'auto.components.settings.RepositoryHooksSection.40a446ae16',
+ '- just for you, on this machine'
+ )}
+
+
+ ) : (
+
+ )}
+
+