The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
fix(desktop): scope subagent routes and move settings to Model
abundantbeing2c1bbb11b783
diff --git a/README.md b/README.mdindex 93bab974fd0..0412dd2203e 100644--- a/README.md+++ b/README.md@@ -25,7 +25,7 @@ Use any model you want — [Nous Portal](https://portal.nousresearch.com), OpenR<tr><td><b>Lives where you do</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity.</td></tr><tr><td><b>A closed learning loop</b></td><td>Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. <a href="https://github.com/plastic-labs/honcho">Honcho</a> dialectic user modeling. Compatible with the <a href="https://agentskills.io">agentskills.io</a> open standard.</td></tr><tr><td><b>Scheduled automations</b></td><td>Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended.</td></tr>-<tr><td><b>Delegates and parallelizes</b></td><td>Spawn isolated subagents for parallel workstreams. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.</td></tr>+<tr><td><b>Delegates and parallelizes</b></td><td>Spawn isolated subagents for parallel workstreams. In Desktop, choose their provider, model, and limits under Settings → Model → Subagents, then Apply the complete route. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.</td></tr><tr><td><b>Runs anywhere, not just your laptop</b></td><td>Seven terminal backends — local, Docker, SSH, Singularity, Modal, Daytona, and Vercel Sandbox. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster.</td></tr><tr><td><b>Research-ready</b></td><td>Batch trajectory generation, trajectory compression for training the next generation of tool-calling models.</td></tr></table>diff --git a/apps/desktop/src/app/settings/config-field.tsx b/apps/desktop/src/app/settings/config-field.tsxindex bd0fd20a669..d2b4d4a08fa 100644--- a/apps/desktop/src/app/settings/config-field.tsx+++ b/apps/desktop/src/app/settings/config-field.tsx@@ -3,6 +3,7 @@ import { type ReactNode, useEffect, useRef, useState } from 'react'import { Input } from '@/components/ui/input'import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'import { Textarea } from '@/components/ui/textarea'+import type { ProfileScope } from '@/hermes'import { useI18n } from '@/i18n'import { prettyName } from '@/lib/text'import { cn } from '@/lib/utils'@@ -10,7 +11,7 @@ import type { ConfigFieldSchema } from '@/types/hermes'import { ComboboxInput } from './combobox-input'import { CONTROL_TEXT, EMPTY_SELECT_VALUE, FIELD_DESCRIPTIONS, FIELD_LABELS, FREE_INPUT_KEYS } from './constants'-import { DelegationModelProviderField } from './delegation-model-provider-field'+import { DelegationModelProviderField, type DelegationModelProviderValue } from './delegation-model-provider-field'import { FallbackModelsField } from './fallback-models-field'import { fieldCopyForSchemaKey } from './field-copy'import { ListRow, ToggleRow } from './primitives'@@ -40,6 +41,8 @@ export function ConfigField({onChange,descriptionExtra,delegationProvider,+ delegationBaseUrl,+ scope,onDelegationChange}: {schemaKey: string@@ -50,7 +53,9 @@ export function ConfigField({onChange: (value: unknown) => voiddescriptionExtra?: ReactNodedelegationProvider?: string- onDelegationChange?: (model: string, provider: string) => void+ delegationBaseUrl?: string+ scope?: ProfileScope+ onDelegationChange?: (next: DelegationModelProviderValue) => void}) {const { t } = useI18n()const c = t.settings.config@@ -122,11 +127,11 @@ export function ConfigField({if (schemaKey === 'delegation.model') {return wideRow(<DelegationModelProviderField+ baseUrl={delegationBaseUrl}model={String(value ?? '')}- onChange={({ model: nextModel, provider: nextProvider }) => {- onDelegationChange?.(nextModel, nextProvider)- }}+ onChange={next => onDelegationChange?.(next)}provider={delegationProvider ?? ''}+ scope={scope}/>)}diff --git a/apps/desktop/src/app/settings/config-settings.tsx b/apps/desktop/src/app/settings/config-settings.tsxindex 328fe52a52b..58d44fbc890 100644--- a/apps/desktop/src/app/settings/config-settings.tsx+++ b/apps/desktop/src/app/settings/config-settings.tsx@@ -12,6 +12,7 @@ import { useI18n } from '@/i18n'import { triggerHaptic } from '@/lib/haptics'import { isSubmitEnter } from '@/lib/ime'import { confirm } from '@/store/confirm'+import { $activeConnectionId } from '@/store/connections'import {$dataUrlReadMaxMb,clampDataUrlReadMaxMb,@@ -70,12 +71,13 @@ export function ConfigSettings({// when the target profile changes — the same guarantee useOnProfileSwitch// provides for app-wide switches, without hand-clearing each piece.const scopeProfile = useStore($settingsRequestProfile)+ const connectionId = useStore($activeConnectionId)return (<ConfigSettingsInneractiveSectionId={activeSectionId}importInputRef={importInputRef}- key={scopeProfile ?? '__active__'}+ key={JSON.stringify([connectionId, scopeProfile ?? '__active__'])}onConfigSaved={onConfigSaved}onMainModelChanged={onMainModelChanged}scopeProfile={scopeProfile}@@ -384,7 +386,7 @@ function ConfigSettingsInner({const renderPage = (children: ReactNode) => (<SettingsContent><SettingsProfileScope className="mb-5" />- {activeSectionId === 'model' && (+ {activeSectionId === 'model' && subpage !== 'delegation' && (<div className={showModelSettings ? 'mb-6' : undefined}><ModelSettings onMainModelChanged={onMainModelChanged} scopeProfile={scopeProfile} subpage={subpage} /></div>@@ -443,7 +445,7 @@ function ConfigSettingsInner({const visibleFields = activeSectionId === 'voice' ? fields.filter(([key]) => voiceFieldVisible(key, config)) : fieldsconst filteredVisibleFields =- activeSectionId === 'advanced' && (subpage === undefined || subpage === 'delegation')+ activeSectionId === 'model' && (subpage === undefined || subpage === 'delegation')? visibleFields.filter(([key]) => key !== 'delegation.provider'): visibleFields@@ -509,7 +511,12 @@ function ConfigSettingsInner({{filteredVisibleFields.map(([key, field]) => (<div className="scroll-mt-6 rounded-lg" id={`setting-field-${key}`} key={key}><ConfigField- delegationProvider={key === 'delegation.model' ? String(getNested(config, 'delegation.provider') ?? '') : undefined}+ delegationBaseUrl={+ key === 'delegation.model' ? String(getNested(config, 'delegation.base_url') ?? '') : undefined+ }+ delegationProvider={+ key === 'delegation.model' ? String(getNested(config, 'delegation.provider') ?? '') : undefined+ }descriptionExtra={key === 'memory.provider' && isExternalMemoryProvider(getNested(config, key)) ? (<MemoryConnect profile={scopeProfile} provider={String(getNested(config, key))} />@@ -521,18 +528,23 @@ function ConfigSettingsInner({: enumOptionsFor(key, getNested(config, key), config)}onChange={value => updateConfig(setNested(config, key, value))}- onDelegationChange={(nextModel, nextProvider) => {- updateConfig(- setNested(- setNested(config, 'delegation.model', nextModel),- 'delegation.provider',- nextProvider- )+ onDelegationChange={({ model: nextModel, provider: nextProvider, resetDirectEndpoint }) => {+ let next = setNested(+ setNested(config, 'delegation.model', nextModel),+ 'delegation.provider',+ nextProvider)++ if (resetDirectEndpoint) {+ next = setNested(setNested(next, 'delegation.base_url', ''), 'delegation.api_key', '')+ }++ updateConfig(next)}}optionLabels={key === 'tts.elevenlabs.voice_id' ? elevenLabsVoiceLabels : undefined}schema={field}schemaKey={key}+ scope={writeScope ?? scopeProfile}value={getNested(config, key)}/>{key === 'memory.provider' && isExternalMemoryProvider(getNested(config, key)) ? (diff --git a/apps/desktop/src/app/settings/config-subpages.ts b/apps/desktop/src/app/settings/config-subpages.tsindex fe6f9d335c0..4f17c655954 100644--- a/apps/desktop/src/app/settings/config-subpages.ts+++ b/apps/desktop/src/app/settings/config-subpages.ts@@ -19,6 +19,7 @@ const CONFIG_SUBPAGE_DEFINITIONS: Record<string, ConfigSubpageDefinition[]> = {},{ id: 'fallbacks', labelKey: 'modelFallbacks', fields: ['fallback_providers'] },{ id: 'auxiliary', labelKey: 'modelAuxiliary', prefixes: ['auxiliary.'] },+ { id: 'delegation', labelKey: 'advancedDelegation', prefixes: ['delegation.'] },{ id: 'moa', labelKey: 'modelMoa', prefixes: ['moa.'] }],chat: [@@ -87,7 +88,6 @@ const CONFIG_SUBPAGE_DEFINITIONS: Record<string, ConfigSubpageDefinition[]> = {},{ id: 'tools', labelKey: 'advancedTools', fields: ['toolsets', 'agent.tool_use_enforcement'] },{ id: 'terminal', labelKey: 'advancedTerminal', prefixes: ['terminal.'] },- { id: 'delegation', labelKey: 'advancedDelegation', prefixes: ['delegation.'] },{ id: 'output', labelKey: 'advancedOutput', prefixes: ['tool_output.', 'checkpoints.'] }]}diff --git a/apps/desktop/src/app/settings/constants.ts b/apps/desktop/src/app/settings/constants.tsindex 5dd2c2f4a00..80bac5ba9ad 100644--- a/apps/desktop/src/app/settings/constants.ts+++ b/apps/desktop/src/app/settings/constants.ts@@ -712,7 +712,16 @@ export const SECTIONS: DesktopConfigSection[] = [id: 'model',label: 'Model',icon: Box,- keys: ['model_context_length', 'fallback_providers']+ keys: [+ 'model_context_length',+ 'fallback_providers',+ 'delegation.model',+ 'delegation.provider',+ 'delegation.max_iterations',+ 'delegation.max_concurrent_children',+ 'delegation.child_timeout_seconds',+ 'delegation.reasoning_effort'+ ]},{id: 'chat',@@ -855,12 +864,6 @@ export const SECTIONS: DesktopConfigSection[] = ['agent.api_max_retries','agent.service_tier','agent.tool_use_enforcement',- 'delegation.model',- 'delegation.provider',- 'delegation.max_iterations',- 'delegation.max_concurrent_children',- 'delegation.child_timeout_seconds',- 'delegation.reasoning_effort','updates.non_interactive_local_changes']}diff --git a/apps/desktop/src/app/settings/delegation-model-provider-field.test.tsx b/apps/desktop/src/app/settings/delegation-model-provider-field.test.tsxindex fc780404ef0..93f547df245 100644--- a/apps/desktop/src/app/settings/delegation-model-provider-field.test.tsx+++ b/apps/desktop/src/app/settings/delegation-model-provider-field.test.tsx@@ -11,13 +11,13 @@ beforeAll(() => {const getGlobalModelOptions = vi.fn()-vi.mock('@/hermes', () => ({- getGlobalModelOptions: () => getGlobalModelOptions()+vi.mock('@/hermes', async () => ({+ ...(await vi.importActual('@/api/client')),+ getGlobalModelOptions: (...args: unknown[]) => getGlobalModelOptions(...args)}))-const { DelegationModelProviderField, INHERIT_VALUE, MODEL_ONLY_VALUE } = await import(- './delegation-model-provider-field'-)+const { DelegationModelProviderField, INHERIT_VALUE, MODEL_ONLY_VALUE } =+ await import('./delegation-model-provider-field')beforeEach(() => {getGlobalModelOptions.mockResolvedValue({@@ -120,7 +120,9 @@ describe('DelegationModelProviderField', () => {const inheritOption = await screen.findByRole('option', { name: 'Inherit from main agent' })fireEvent.click(inheritOption)- expect(onChange).toHaveBeenCalledWith({ model: '', provider: '' })+ expect(onChange).not.toHaveBeenCalled()+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledWith({ model: '', provider: '', resetDirectEndpoint: true })})it('switching provider resets model and emits atomically', async () => {@@ -134,8 +136,9 @@ describe('DelegationModelProviderField', () => {const anthropicOption = await screen.findByRole('option', { name: 'Anthropic' })fireEvent.click(anthropicOption)- // Should switch provider to anthropic and clear model because gpt-5.1 is not an anthropic model- expect(onChange).toHaveBeenCalledWith({ model: '', provider: 'anthropic' })+ // An unfinished provider selection is not an intentional provider-only route.+ expect(onChange).not.toHaveBeenCalled()+ expect((screen.getByRole('button', { name: 'Apply' }) as HTMLButtonElement).disabled).toBe(true)})it('switching to Custom model preserves draft model with empty provider', async () => {@@ -152,6 +155,8 @@ describe('DelegationModelProviderField', () => {fireEvent.click(customModelOption)- expect(onChange).toHaveBeenCalledWith({ model: 'special-model', provider: '' })+ expect(onChange).not.toHaveBeenCalled()+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledWith({ model: 'special-model', provider: '', resetDirectEndpoint: true })})})diff --git a/apps/desktop/src/app/settings/delegation-model-provider-field.tsx b/apps/desktop/src/app/settings/delegation-model-provider-field.tsxindex a1ee7167909..01fc0b552a0 100644--- a/apps/desktop/src/app/settings/delegation-model-provider-field.tsx+++ b/apps/desktop/src/app/settings/delegation-model-provider-field.tsx@@ -1,192 +1,219 @@import type { ModelOptionProvider } from '@hermes/shared'import { useStore } from '@nanostores/react'import { useQuery } from '@tanstack/react-query'-import { useEffect, useMemo, useRef, useState } from 'react'+import { useMemo, useState } from 'react'+import { Button } from '@/components/ui/button'+import { Checkbox } from '@/components/ui/checkbox'+import { Input } from '@/components/ui/input'import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'-import { getGlobalModelOptions } from '@/hermes'+import { getGlobalModelOptions, type ProfileScope, profileScopeKey } from '@/hermes'import { useI18n } from '@/i18n'import { findCatalogProvider } from '@/lib/model-options'import { cn } from '@/lib/utils'-import { $customModels, withCustomModels } from '@/store/custom-models'+import { $customModels, customModelSlug, withCustomModels } from '@/store/custom-models'-import { CONTROL_TEXT, EMPTY_SELECT_VALUE } from './constants'+import { CONTROL_TEXT } from './constants'import { ModelSelect } from './model-select'export interface DelegationModelProviderValue {model: stringprovider: string+ /** Explicitly leave direct-endpoint routing. Other request settings stay intact. */+ resetDirectEndpoint: boolean}export const INHERIT_VALUE = '__inherit__'export const MODEL_ONLY_VALUE = '__model_only__'+const DIRECT_VALUE = '__direct__'+const CUSTOM_PROVIDER_VALUE = '__custom_provider__'+// Provider item values have a separate namespace from editor actions.+const providerItem = (provider: string) => `provider:${provider}`interface DelegationModelProviderFieldProps {model: stringprovider: string+ baseUrl?: string+ scope?: ProfileScopeonChange: (next: DelegationModelProviderValue) => void}-/**- * Guided picker for delegation.model + delegation.provider in Settings → Advanced.- *- * Replaces the two bare text fields with a paired provider and model picker- * sourced from `getGlobalModelOptions()` and `$customModels`, matching the- * Main Model and Fallback Models dropdown patterns.- *- * Special states:- * - "Inherit from main agent": writes provider="" and model=""- * - "Custom model (use parent credentials)": writes provider="" and model="<typed-model>"- * which is supported by the runtime resolver tools/delegate_tool.py.- * - Standard provider selection: writes provider="<slug>" and model="<model>"- */-export function DelegationModelProviderField({- model,- provider,- onChange-}: DelegationModelProviderFieldProps) {+/** A route draft belongs to the same immutable owner as the config that seeded it. */+export function DelegationModelProviderField(props: DelegationModelProviderFieldProps) {+ const identity = JSON.stringify([profileScopeKey(props.scope), props.model, props.provider, props.baseUrl ?? ''])++ return <DelegationRouteEditor key={identity} {...props} />+}++function DelegationRouteEditor({ model, provider, baseUrl = '', scope, onChange }: DelegationModelProviderFieldProps) {const { t } = useI18n()- const m = t.settings.modelconst c = t.settings.config+ // Match tools/delegate_tool_config.py: native SDK routes ignore a direct URL.+ const nativeSdk = ['bedrock', 'vertex', 'google', 'google-genai'].includes(provider.trim().toLowerCase())+ const hasDirectEndpoint = Boolean(baseUrl.trim()) && !nativeSdk++ const initialMode = hasDirectEndpoint+ ? DIRECT_VALUE+ : provider+ ? providerItem(provider)+ : model+ ? MODEL_ONLY_VALUE+ : INHERIT_VALUE++ const [mode, setMode] = useState(initialMode)+ const [draftModel, setDraftModel] = useState(model)+ const [draftProvider, setDraftProvider] = useState(provider)+ const [useParentModel, setUseParentModel] = useState(Boolean(provider && !model))const modelOptions = useQuery({- queryKey: ['model-options', 'global'],- queryFn: () => getGlobalModelOptions()+ queryKey: ['model-options', 'delegation', profileScopeKey(scope)],+ queryFn: () => getGlobalModelOptions(undefined, scope),+ retry: false})const customModels = useStore($customModels)+ // Custom ids enrich only providers actually returned for this owner. They+ // cannot introduce another profile's endpoints/provider rows.const providers = useMemo(- () => withCustomModels((modelOptions.data?.providers ?? []).filter(p => p.slug), customModels),+ () =>+ withCustomModels(+ (modelOptions.data?.providers ?? []).filter(p => p.slug),+ customModels+ ),[modelOptions.data?.providers, customModels])- // Determine current dropdown value- const derivePickerValue = (p: string, mdl: string): string => {- if (!p && !mdl) {- return INHERIT_VALUE- }-- if (!p && mdl) {- return MODEL_ONLY_VALUE- }-- return p+ const selectedProvider: ModelOptionProvider | undefined = findCatalogProvider(providers, draftProvider)++ const displayProviders =+ draftProvider && !providers.some(p => p.slug === draftProvider)+ ? [+ {+ name: selectedProvider?.name ?? draftProvider,+ slug: draftProvider,+ models: selectedProvider?.models ?? []+ },+ ...providers+ ]+ : providers++ const inherit = mode === INHERIT_VALUE+ const direct = mode === DIRECT_VALUE+ const modelOnly = mode === MODEL_ONLY_VALUE+ const manualProvider = mode === CUSTOM_PROVIDER_VALUE+ const nextProvider = inherit || modelOnly ? '' : draftProvider+ const nextModel = inherit || useParentModel ? '' : draftModel+ const resetDirectEndpoint = !direct && (hasDirectEndpoint || mode !== initialMode)+ const changed = nextProvider !== provider || nextModel !== model || (Boolean(baseUrl.trim()) && resetDirectEndpoint)+ const validProvider = inherit || modelOnly || direct || Boolean(selectedProvider || customModelSlug(nextProvider))+ const validModel = inherit || useParentModel || Boolean(customModelSlug(nextModel))+ const pending = mode !== initialMode || draftModel !== model || draftProvider !== provider || changed++ const reset = () => {+ setMode(initialMode)+ setDraftModel(model)+ setDraftProvider(provider)+ setUseParentModel(Boolean(provider && !model))}- const [pickerValue, setPickerValue] = useState<string>(() => derivePickerValue(provider, model))- const [draftModel, setDraftModel] = useState<string>(model)-- const lastCommittedRef = useRef<string>(JSON.stringify({ model, provider }))-- // Resync if external config changes (e.g. profile switch)- // eslint-disable-next-line no-restricted-syntax -- legitimate non-atom ref write (see FallbackModelsField)- useEffect(() => {- const pair = JSON.stringify({ model, provider })-- if (pair !== lastCommittedRef.current) {- lastCommittedRef.current = pair- setPickerValue(derivePickerValue(provider, model))- setDraftModel(model)- }- }, [model, provider])-- const commit = (nextModel: string, nextProvider: string) => {- const serialized = JSON.stringify({ model: nextModel, provider: nextProvider })-- if (serialized === lastCommittedRef.current) {- return- }-- lastCommittedRef.current = serialized- onChange({ model: nextModel, provider: nextProvider })- }+ const chooseProvider = (value: string) => {+ setMode(value)+ setUseParentModel(false)- const handleProviderChange = (selected: string) => {- setPickerValue(selected)-- if (selected === INHERIT_VALUE) {+ if (value === INHERIT_VALUE) {setDraftModel('')- commit('', '')- } else if (selected === MODEL_ONLY_VALUE) {- // Model-only override: provider is empty, model is preserved or empty draft- commit(draftModel, '')- } else {- // Provider changed to a concrete catalog provider.- // If the current model belongs to this new provider, keep it; otherwise reset model.- const provRow = findCatalogProvider(providers, selected)- const provModels = provRow?.models ?? []- const nextMdl = provModels.includes(draftModel) ? draftModel : ''- setDraftModel(nextMdl)- commit(nextMdl, selected)- }- }-- const handleModelChange = (nextModel: string) => {- setDraftModel(nextModel)-- if (pickerValue === INHERIT_VALUE) {- commit('', '')- } else if (pickerValue === MODEL_ONLY_VALUE) {- commit(nextModel, '')- } else {- commit(nextModel, pickerValue)+ } else if (value === CUSTOM_PROVIDER_VALUE) {+ setDraftProvider('')+ setDraftModel('')+ } else if (value.startsWith('provider:')) {+ const selected = value.slice('provider:'.length)+ setDraftProvider(selected)++ // Never reinterpret a model from the previous route as a completed switch.+ if (selected !== draftProvider) {+ setDraftModel('')+ }}}- const selectedProviderRow: ModelOptionProvider | undefined = useMemo(- () => (pickerValue !== INHERIT_VALUE && pickerValue !== MODEL_ONLY_VALUE ? findCatalogProvider(providers, pickerValue) : undefined),- [providers, pickerValue]- )-- const providerModels = selectedProviderRow?.models ?? []-- // If a persisted provider isn't in catalog, keep it visible in options- const displayProviders = useMemo(() => {- if (- pickerValue &&- pickerValue !== INHERIT_VALUE &&- pickerValue !== MODEL_ONLY_VALUE &&- !findCatalogProvider(providers, pickerValue)- ) {- return [{ name: pickerValue, slug: pickerValue, models: [] }, ...providers]- }-- return providers- }, [providers, pickerValue])-return (- <div className="flex flex-wrap items-center gap-2">- <Select onValueChange={handleProviderChange} value={pickerValue || EMPTY_SELECT_VALUE}>- <SelectTrigger aria-label={c.delegationProviderSelectLabel ?? 'Subagent Provider'} className={cn('min-w-48 flex-1', CONTROL_TEXT)}>- <SelectValue placeholder={m.provider} />- </SelectTrigger>- <SelectContent>- <SelectItem value={INHERIT_VALUE}>- {c.delegationInherit ?? 'Inherit from main agent'}- </SelectItem>- <SelectItem value={MODEL_ONLY_VALUE}>- {c.delegationModelOnly ?? 'Custom model (use parent credentials)'}- </SelectItem>- {displayProviders.map(p => (- <SelectItem key={p.slug} value={p.slug}>- {p.name}- </SelectItem>- ))}- </SelectContent>- </Select>-- {pickerValue !== INHERIT_VALUE && (- <ModelSelect- aria-label={c.delegationModelSelectLabel ?? 'Subagent Model'}- className="min-w-56 flex-1"- models={providerModels}- onValueChange={handleModelChange}- provider={selectedProviderRow}- providerSlug={pickerValue === MODEL_ONLY_VALUE ? '' : pickerValue}- value={draftModel}+ <div className="grid gap-3">+ <div className="flex flex-wrap items-center gap-2">+ <Select onValueChange={chooseProvider} value={mode}>+ <SelectTrigger aria-label={c.delegationProviderSelectLabel} className={cn('min-w-48 flex-1', CONTROL_TEXT)}>+ <SelectValue placeholder={t.settings.model.provider} />+ </SelectTrigger>+ <SelectContent>+ {hasDirectEndpoint && <SelectItem value={DIRECT_VALUE}>{c.delegationDirect}</SelectItem>}+ <SelectItem value={INHERIT_VALUE}>{c.delegationInherit}</SelectItem>+ <SelectItem value={MODEL_ONLY_VALUE}>{c.delegationModelOnly}</SelectItem>+ {displayProviders.map(p => (+ <SelectItem key={p.slug} value={providerItem(p.slug)}>+ {p.name}+ </SelectItem>+ ))}+ <SelectItem value={CUSTOM_PROVIDER_VALUE}>{c.delegationCustomProvider}</SelectItem>+ </SelectContent>+ </Select>+ {!inherit && !useParentModel && (+ <ModelSelect+ aria-label={c.delegationModelSelectLabel}+ className="min-w-56 flex-1"+ models={direct || modelOnly || manualProvider ? [] : (selectedProvider?.models ?? [])}+ onValueChange={setDraftModel}+ provider={direct || modelOnly || manualProvider ? undefined : selectedProvider}+ providerSlug={modelOnly || direct || manualProvider ? '' : draftProvider}+ value={draftModel}+ />+ )}+ </div>+ {manualProvider && (+ <Input+ aria-label={c.delegationCustomProviderLabel}+ onChange={event => setDraftProvider(event.target.value)}+ placeholder="custom:provider"+ value={draftProvider}/>)}+ {!inherit && !modelOnly && (+ <label className="flex items-center gap-2 text-xs text-muted-foreground">+ <Checkbox checked={useParentModel} onCheckedChange={checked => setUseParentModel(checked === true)} />+ {c.delegationParentModel}+ </label>+ )}+ {useParentModel && <p className="text-xs text-muted-foreground">{c.delegationParentModelWarning}</p>}+ {hasDirectEndpoint && (+ <p className="text-xs text-muted-foreground">{direct ? c.delegationDirectActive : c.delegationDirectClear}</p>+ )}+ {modelOptions.isError && (+ <div className="flex flex-wrap items-center gap-2" role="status">+ <p className="text-xs text-muted-foreground">{c.delegationCatalogFailed}</p>+ <Button+ disabled={modelOptions.isFetching}+ onClick={() => void modelOptions.refetch()}+ size="xs"+ variant="secondary"+ >+ {t.common.retry}+ </Button>+ </div>+ )}+ {pending && (+ <div className="flex items-center gap-2">+ <Button+ disabled={!changed || !validProvider || !validModel}+ onClick={() => onChange({ model: nextModel, provider: nextProvider, resetDirectEndpoint })}+ size="xs"+ >+ {t.common.apply}+ </Button>+ <Button onClick={reset} size="xs" variant="text">+ {t.common.cancel}+ </Button>+ <span className="text-xs text-muted-foreground">{c.delegationDraftHint}</span>+ </div>+ )}</div>)}diff --git a/apps/desktop/src/app/settings/delegation-route-regressions.test.tsx b/apps/desktop/src/app/settings/delegation-route-regressions.test.tsxnew file mode 100644index 00000000000..f6af9acd5a4--- /dev/null+++ b/apps/desktop/src/app/settings/delegation-route-regressions.test.tsx@@ -0,0 +1,185 @@+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'++import type { ProfileScope } from '@/hermes'++const getGlobalModelOptions = vi.fn()+vi.mock('@/hermes', async () => ({+ ...(await vi.importActual('@/api/client')),+ getGlobalModelOptions: (...args: unknown[]) => getGlobalModelOptions(...args)+}))+const { DelegationModelProviderField } = await import('./delegation-model-provider-field')++const catalog = {+ providers: [+ { name: 'Anthropic', slug: 'anthropic', models: ['claude-sonnet-4-6'] },+ { name: 'OpenAI', slug: 'openai', models: ['gpt-5.1'] },+ { name: 'Lab', slug: 'lab', aliases: ['custom:lab', 'Lab'], models: ['test-model'] }+ ]+}++beforeAll(() => {+ Element.prototype.scrollIntoView = vi.fn()+ Element.prototype.hasPointerCapture = vi.fn(() => false)+ Element.prototype.releasePointerCapture = vi.fn()+})+beforeEach(() => {+ getGlobalModelOptions.mockReset().mockResolvedValue(catalog)+})+afterEach(() => {+ cleanup()+ vi.clearAllMocks()+})++function mount(+ model = 'gpt-5.1',+ provider = 'openai',+ scope: ProfileScope = { connectionId: 'local', profile: 'B' },+ baseUrl = ''+) {+ const onChange = vi.fn()+ const client = new QueryClient({ defaultOptions: { queries: { retry: false, staleTime: 60_000 } } })++ const view = render(+ <QueryClientProvider client={client}>+ <DelegationModelProviderField+ baseUrl={baseUrl}+ model={model}+ onChange={onChange}+ provider={provider}+ scope={scope}+ />+ </QueryClientProvider>+ )++ return { onChange, client, view }+}++async function provider(name: string) {+ fireEvent.click(screen.getByLabelText('Subagent Provider'))+ fireEvent.click(await screen.findByRole('option', { name }))+}++async function model(name: string) {+ fireEvent.click(screen.getByLabelText('Subagent Model'))+ fireEvent.click(await screen.findByRole('option', { name }))+}++describe('delegation route regressions', () => {+ it('requests the exact config owner', async () => {+ const owner = { connectionId: 'remote-B', profile: 'B' }+ mount('gpt-5.1', 'openai', owner)+ await waitFor(() => expect(getGlobalModelOptions).toHaveBeenCalledWith(undefined, owner))+ })+ it('keeps an unfinished switch local beyond autosave, then applies one complete route', async () => {+ const { onChange } = mount()+ await provider('Anthropic')+ await new Promise(resolve => setTimeout(resolve, 650))+ expect(onChange).not.toHaveBeenCalled()+ expect((screen.getByRole('button', { name: 'Apply' }) as HTMLButtonElement).disabled).toBe(true)+ await model('claude-sonnet-4-6')+ expect(onChange).not.toHaveBeenCalled()+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledExactlyOnceWith({+ model: 'claude-sonnet-4-6',+ provider: 'anthropic',+ resetDirectEndpoint: true+ })+ })+ it('cancels a provider draft', async () => {+ const { onChange } = mount()+ await provider('Anthropic')+ fireEvent.click(screen.getByRole('button', { name: 'Cancel' }))+ expect(screen.getByLabelText('Subagent Provider').textContent).toBe('OpenAI')+ expect(screen.getByLabelText('Subagent Model').textContent).toBe('gpt-5.1')+ expect(onChange).not.toHaveBeenCalled()+ })+ it('requires an explicit parent-model choice for provider-only routing', async () => {+ const { onChange } = mount()+ await provider('Anthropic')+ fireEvent.click(screen.getByRole('checkbox', { name: 'Use parent model' }))+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledExactlyOnceWith({ model: '', provider: 'anthropic', resetDirectEndpoint: true })+ })+ it('represents direct endpoint precedence before explicitly replacing it', async () => {+ const { onChange } = mount('old-model', 'openai', undefined, 'https://endpoint.invalid/v1')+ expect(screen.getByLabelText('Subagent Provider').textContent).toBe('Direct endpoint override')+ await provider('Inherit from main agent')+ expect(screen.getByText(/Applying this route clears the direct endpoint/)).toBeTruthy()+ expect(onChange).not.toHaveBeenCalled()+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledExactlyOnceWith({ model: '', provider: '', resetDirectEndpoint: true })+ })+ it.each(['lab', 'custom:lab', 'Lab'])('shows alias %s without rewriting it', async alias => {+ const { onChange } = mount('test-model', alias)+ await waitFor(() => expect(screen.getByLabelText('Subagent Provider').textContent).toBe('Lab'))+ expect(onChange).not.toHaveBeenCalled()+ })+ it('allows manual editing on failure and preserves the draft on retry', async () => {+ getGlobalModelOptions.mockRejectedValueOnce(new Error('503'))+ const { onChange } = mount()+ await screen.findByText('Model catalog unavailable. Enter a provider and model manually, or retry.')+ await provider('Custom provider...')+ fireEvent.change(screen.getByLabelText('Custom subagent provider'), { target: { value: 'custom:other' } })+ await model('Custom model…')+ fireEvent.change(screen.getByLabelText('Subagent Model'), { target: { value: 'other-model' } })+ fireEvent.click(screen.getByRole('button', { name: 'Retry' }))+ await waitFor(() => expect(getGlobalModelOptions).toHaveBeenCalledTimes(2))+ expect((screen.getByLabelText('Custom subagent provider') as HTMLInputElement).value).toBe('custom:other')+ expect((screen.getByLabelText('Subagent Model') as HTMLInputElement).value).toBe('other-model')+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledExactlyOnceWith({+ model: 'other-model',+ provider: 'custom:other',+ resetDirectEndpoint: true+ })+ })+ it.each(['bedrock', 'vertex', 'google', 'google-genai'])(+ 'does not mislabel native SDK provider %s as a direct endpoint',+ async nativeProvider => {+ mount('native-model', nativeProvider, undefined, 'https://sdk-region.invalid')+ expect(screen.getByLabelText('Subagent Provider').textContent).toBe(nativeProvider)+ }+ )+ it('can edit a model while preserving a catalog display-name alias with spaces', async () => {+ getGlobalModelOptions.mockResolvedValue({+ providers: [{ name: 'Named Provider', slug: 'named', models: ['old', 'new'] }]+ })+ const { onChange } = mount('old', 'Named Provider')+ await model('new')+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ expect(onChange).toHaveBeenCalledExactlyOnceWith({+ model: 'new',+ provider: 'Named Provider',+ resetDirectEndpoint: false+ })+ })+ it('isolates connection catalogs and late responses', async () => {+ let resolveA!: (value: typeof catalog) => void+ getGlobalModelOptions.mockImplementation((_opts, owner) =>+ owner.connectionId === 'A'+ ? new Promise(resolve => {+ resolveA = resolve+ })+ : Promise.resolve({ providers: [{ name: 'Only B', slug: 'only-b', models: ['b'] }] })+ )+ const { client, view } = mount('', '', { connectionId: 'A', profile: 'same' })+ await waitFor(() => expect(getGlobalModelOptions).toHaveBeenCalledTimes(1))+ view.rerender(+ <QueryClientProvider client={client}>+ <DelegationModelProviderField+ model=""+ onChange={vi.fn()}+ provider=""+ scope={{ connectionId: 'B', profile: 'same' }}+ />+ </QueryClientProvider>+ )+ await waitFor(() => expect(getGlobalModelOptions).toHaveBeenCalledTimes(2))+ resolveA(catalog)+ await provider('Only B')+ fireEvent.click(screen.getByLabelText('Subagent Provider'))+ expect(screen.queryByRole('option', { name: 'Anthropic' })).toBeNull()+ })+})diff --git a/apps/desktop/src/app/settings/delegation-settings-integration.test.tsx b/apps/desktop/src/app/settings/delegation-settings-integration.test.tsxnew file mode 100644index 00000000000..47775634dbd--- /dev/null+++ b/apps/desktop/src/app/settings/delegation-settings-integration.test.tsx@@ -0,0 +1,262 @@+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'+import { atom } from 'nanostores'+import { createRef } from 'react'+import { MemoryRouter } from 'react-router'+import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest'++import { setApiRequestConnection, setApiRequestProfile } from '@/api/client'+import type { HermesApiRequest } from '@/global'+import { $activeConnectionId } from '@/store/connections'+import { $settingsRequestProfile } from '@/store/settings-scope'+import type { HermesConfigRecord } from '@/types/hermes'++import type { ConfigSettings as ConfigSettingsType } from './config-settings'++vi.mock('@/hermes', async () => ({+ ...(await vi.importActual('@/api/client')),+ ...(await vi.importActual('@/api/config')),+ ...(await vi.importActual('@/api/models')),+ getElevenLabsVoices: async () => ({ available: false }),+ getProfiles: async () => ({ profiles: [] })+}))+vi.mock('@/store/connections', () => ({ $activeConnectionId: atom<string | null>('connection-A') }))+vi.mock('@/store/settings-scope', () => ({+ $settingsRequestProfile: atom<string | undefined>('B'),+ $settingsScopeEditsNonDefault: atom(false),+ $settingsScopeOverride: atom<null | string>('B'),+ $settingsScopeProfile: atom('B')+}))+vi.mock('./profile-scope', () => ({ SettingsProfileScope: () => null }))+vi.mock('../hooks/use-on-profile-switch', () => ({ useOnProfileSwitch: () => {} }))+vi.mock('@/store/projects', () => ({+ repoDiscoveryPolicyFromConfig: () => ({ enabled: true, roots: [], exclude_paths: [] }),+ repoDiscoveryPolicySignature: (policy: unknown) => JSON.stringify(policy),+ scanAndRecordRepos: vi.fn().mockResolvedValue(undefined)+}))++const selectedProfile = $settingsRequestProfile as unknown as { set: (value: string) => void }+const activeConnection = $activeConnectionId as unknown as { set: (value: string) => void }+const requests: HermesApiRequest[] = []+const saves: HermesApiRequest[] = []+let config: HermesConfigRecord+let catalogError = false+let delayCatalog: ((request: HermesApiRequest) => Promise<unknown> | undefined) | undefined+let ConfigSettings: typeof ConfigSettingsType+beforeAll(async () => {+ Element.prototype.scrollIntoView = vi.fn()+ Element.prototype.hasPointerCapture = vi.fn(() => false)+ Element.prototype.releasePointerCapture = vi.fn()+ ;({ ConfigSettings } = await import('./config-settings'))+}, 60_000)+beforeEach(() => {+ requests.length = 0+ saves.length = 0+ selectedProfile.set('B')+ activeConnection.set('connection-A')+ setApiRequestConnection('connection-A')+ setApiRequestProfile('A')+ config = { delegation: { provider: 'openai', model: 'gpt-5.1', max_iterations: 50 } }+ catalogError = false+ delayCatalog = undefined+ window.hermesDesktop = {+ ...window.hermesDesktop,+ api: vi.fn(async (request: HermesApiRequest) => {+ requests.push(request)++ if (request.path === '/api/config/schema') {+ return { fields: {} }+ }++ if (request.path.startsWith('/api/model/options')) {+ if (catalogError) {+ throw new Error('503')+ }++ const delayed = delayCatalog?.(request)++ if (delayed) {+ return delayed+ }++ const owner = `${request.connectionId}-${request.profile}`++ return {+ providers: [+ { name: 'OpenAI', slug: 'openai', models: ['gpt-5.1'] },+ { name: 'Anthropic', slug: 'anthropic', models: ['claude-sonnet-4-6'] },+ { name: owner, slug: owner, models: ['fixture-model'] }+ ]+ }+ }++ if (request.path === '/api/config' && request.method === 'PUT') {+ saves.push(request)++ return { ok: true }+ }++ if (request.path === '/api/config') {+ return structuredClone(config)+ }++ return { ok: true }+ })+ } as typeof window.hermesDesktop+})+afterEach(() => {+ cleanup()+ vi.clearAllMocks()+})++function mount() {+ const client = new QueryClient({ defaultOptions: { queries: { retry: false, staleTime: 60_000 } } })+ render(+ <MemoryRouter>+ <QueryClientProvider client={client}>+ <ConfigSettings activeSectionId="model" importInputRef={createRef<HTMLInputElement>()} subpage="delegation" />+ </QueryClientProvider>+ </MemoryRouter>+ )+}++async function pick(label: string, name: string) {+ fireEvent.click(await screen.findByLabelText(label))+ fireEvent.click(await screen.findByRole('option', { name }))+}++async function debounce() {+ await act(async () => {+ await new Promise(resolve => setTimeout(resolve, 750))+ })+}++describe('real settings route and autosave integration', () => {+ it('active A/settings B reads and saves B, never autosaves an unfinished route', async () => {+ mount()+ await pick('Subagent Provider', 'Anthropic')+ await debounce()+ expect(saves).toEqual([])+ await pick('Subagent Model', 'claude-sonnet-4-6')+ await debounce()+ expect(saves).toEqual([])+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ await waitFor(() => expect(saves).toHaveLength(1))+ expect(saves[0]).toMatchObject({+ profile: 'B',+ connectionId: 'connection-A',+ body: { config: { delegation: { model: 'claude-sonnet-4-6', provider: 'anthropic' } } }+ })+ expect(requests.filter(r => r.path.startsWith('/api/model/options'))).toEqual([+ expect.objectContaining({ profile: 'B', connectionId: 'connection-A' })+ ])+ })+ it.each(['Inherit from main agent', 'Custom model (use parent credentials)', 'Anthropic'])(+ 'switches away from a direct endpoint via %s and preserves request settings',+ async choice => {+ config = {+ delegation: {+ model: 'old-model',+ provider: 'openai',+ base_url: 'https://endpoint.invalid/v1',+ api_key: 'fixture-only',+ api_mode: 'chat_completions',+ request_overrides: { temperature: 0.2 },+ max_iterations: 50+ }+ }+ mount()+ expect((await screen.findByLabelText('Subagent Provider')).textContent).toBe('Direct endpoint override')+ await pick('Subagent Provider', choice)++ if (choice === 'Anthropic') {+ await pick('Subagent Model', 'claude-sonnet-4-6')+ }++ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ await waitFor(() => expect(saves).toHaveLength(1))+ const route = (saves[0].body as { config: HermesConfigRecord }).config.delegation as Record<string, unknown>+ expect(route.base_url).toBe('')+ expect(route.api_key).toBe('')+ expect(route).not.toHaveProperty('request_overrides')+ expect(route).not.toHaveProperty('api_mode')+ expect(route.model ?? 'old-model').toBe(+ choice === 'Inherit from main agent' ? '' : choice === 'Anthropic' ? 'claude-sonnet-4-6' : 'old-model'+ )+ }+ )+ it('keeps scopes separate across B to C to B and equal names on two connections', async () => {+ mount()+ await pick('Subagent Provider', 'connection-A-B')+ await act(async () => selectedProfile.set('C'))+ await pick('Subagent Provider', 'connection-A-C')+ expect(screen.queryByRole('option', { name: 'connection-A-B' })).toBeNull()+ await act(async () => selectedProfile.set('B'))+ await pick('Subagent Provider', 'connection-A-B')+ await act(async () => {+ setApiRequestConnection('connection-B')+ activeConnection.set('connection-B')+ })+ await pick('Subagent Provider', 'connection-B-B')+ await pick('Subagent Model', 'fixture-model')+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ await waitFor(() => expect(saves).toHaveLength(1))+ expect(saves[0]).toMatchObject({ connectionId: 'connection-B', profile: 'B' })+ expect(requests.filter(r => r.path.startsWith('/api/model/options')).map(r => [r.connectionId, r.profile])).toEqual(+ [+ ['connection-A', 'B'],+ ['connection-A', 'C'],+ ['connection-B', 'B']+ ]+ )+ })+ it('saves a manual route after catalog failure and preserves it across retry', async () => {+ catalogError = true+ mount()+ await screen.findByText('Model catalog unavailable. Enter a provider and model manually, or retry.')+ await pick('Subagent Provider', 'Custom provider...')+ fireEvent.change(screen.getByLabelText('Custom subagent provider'), { target: { value: 'custom:lab' } })+ await pick('Subagent Model', 'Custom model…')+ fireEvent.change(screen.getByLabelText('Subagent Model'), { target: { value: 'lab-model' } })+ catalogError = false+ fireEvent.click(screen.getByRole('button', { name: 'Retry' }))+ await waitFor(() => expect(requests.filter(r => r.path.startsWith('/api/model/options'))).toHaveLength(2))+ expect((screen.getByLabelText('Custom subagent provider') as HTMLInputElement).value).toBe('custom:lab')+ expect((screen.getByLabelText('Subagent Model') as HTMLInputElement).value).toBe('lab-model')+ fireEvent.click(screen.getByRole('button', { name: 'Apply' }))+ await waitFor(() => expect(saves).toHaveLength(1))+ expect(saves[0]).toMatchObject({+ profile: 'B',+ connectionId: 'connection-A',+ body: { config: { delegation: { model: 'lab-model', provider: 'custom:lab' } } }+ })+ })+ it('ignores a late old-connection catalog after the settings owner changes', async () => {+ let resolveOld!: (value: unknown) => void+ delayCatalog = request =>+ request.connectionId === 'connection-A'+ ? new Promise(resolve => {+ resolveOld = resolve+ })+ : undefined+ mount()+ await waitFor(() => expect(requests.some(r => r.path.startsWith('/api/model/options'))).toBe(true))+ await act(async () => {+ setApiRequestConnection('connection-B')+ activeConnection.set('connection-B')+ })+ await pick('Subagent Provider', 'connection-B-B')+ await act(async () => resolveOld({ providers: [{ name: 'Old connection only', slug: 'old', models: ['old'] }] }))+ fireEvent.click(screen.getByLabelText('Subagent Provider'))+ expect(screen.queryByRole('option', { name: 'Old connection only' })).toBeNull()+ expect(screen.getByRole('option', { name: 'connection-B-B' })).toBeTruthy()+ expect(saves).toEqual([])+ })+ it('cancels a draft on unmount without sending it to autosave', async () => {+ mount()+ await pick('Subagent Provider', 'Anthropic')+ cleanup()+ await debounce()+ expect(saves).toEqual([])+ })+})diff --git a/apps/desktop/src/app/settings/moved-tabs.ts b/apps/desktop/src/app/settings/moved-tabs.tsindex f9536850a2d..dbb6747f427 100644--- a/apps/desktop/src/app/settings/moved-tabs.ts+++ b/apps/desktop/src/app/settings/moved-tabs.ts@@ -8,6 +8,17 @@ const MOVED_TO_CAPABILITIES: Record<string, { param: string; tab: string }> = {export function movedSettingsTabRedirect(search: string): null | string {const params = new URLSearchParams(search)++ if (+ params.get('tab') === 'config:advanced' &&+ (params.get('page') === 'delegation' || params.get('field')?.startsWith('delegation.'))+ ) {+ params.set('tab', 'config:model')+ params.set('page', 'delegation')++ return `/settings?${params}`+ }+const moved = MOVED_TO_CAPABILITIES[params.get('tab') ?? '']if (moved === undefined) {diff --git a/apps/desktop/src/app/settings/subagents-destination.test.ts b/apps/desktop/src/app/settings/subagents-destination.test.tsnew file mode 100644index 00000000000..2e75b1895db--- /dev/null+++ b/apps/desktop/src/app/settings/subagents-destination.test.ts@@ -0,0 +1,37 @@+import { describe, expect, it } from 'vitest'++import { CONFIG_SUBPAGES, configSubpageForField } from './config-subpages'+import { sectionFieldEntries } from './helpers'+import { movedSettingsTabRedirect } from './moved-tabs'++describe('Subagents settings destination', () => {+ it('moves every delegation field, including config-present fields, into Model only', () => {+ const config = {+ delegation: {+ model: 'm',+ provider: 'p',+ max_iterations: 9,+ base_url: 'https://example.invalid',+ request_overrides: { temperature: 0.2 }+ }+ }++ const entries = sectionFieldEntries({}, config)+ expect(entries.get('model')?.map(([key]) => key)).toEqual(+ expect.arrayContaining(['delegation.model', 'delegation.provider', 'delegation.max_iterations'])+ )+ expect(entries.get('advanced')?.filter(([key]) => key.startsWith('delegation.')) ?? []).toEqual([])+ expect(CONFIG_SUBPAGES.model.map(p => p.id)).toContain('delegation')+ expect(CONFIG_SUBPAGES.advanced.map(p => p.id)).not.toContain('delegation')+ expect(configSubpageForField('model', 'delegation.request_overrides.temperature')).toBe('delegation')+ })+ it('keeps old Advanced bookmarks and field links working without losing scope', () => {+ const result = movedSettingsTabRedirect('?tab=config%3Aadvanced&page=delegation&profile=B&field=delegation.model')+ expect(result).not.toBeNull()+ const params = new URLSearchParams(result!.split('?')[1])+ expect(params.get('tab')).toBe('config:model')+ expect(params.get('page')).toBe('delegation')+ expect(params.get('profile')).toBe('B')+ expect(params.get('field')).toBe('delegation.model')+ })+})diff --git a/apps/desktop/src/i18n/en.ts b/apps/desktop/src/i18n/en.tsindex 56bcb13ac6b..42e66ac3c4a 100644--- a/apps/desktop/src/i18n/en.ts+++ b/apps/desktop/src/i18n/en.ts@@ -1235,7 +1235,19 @@ export const en: Translations = {delegationInherit: 'Inherit from main agent',delegationModelOnly: 'Custom model (use parent credentials)',delegationProviderSelectLabel: 'Subagent Provider',- delegationModelSelectLabel: 'Subagent Model'+ delegationModelSelectLabel: 'Subagent Model',+ delegationDirect: 'Direct endpoint override',+ delegationCustomProvider: 'Custom provider...',+ delegationCustomProviderLabel: 'Custom subagent provider',+ delegationParentModel: 'Use parent model',+ delegationParentModelWarning:+ 'The chosen provider must support the parent model. A provider-only route can fail if the model is incompatible.',+ delegationDirectActive:+ 'A direct endpoint is active and takes precedence over the saved provider. Its endpoint and credentials are kept while this mode is selected.',+ delegationDirectClear:+ 'Applying this route clears the direct endpoint and its stored key. Other request settings are kept.',+ delegationCatalogFailed: 'Model catalog unavailable. Enter a provider and model manually, or retry.',+ delegationDraftHint: 'Changes stay local until applied.'},hudModifier: {title: 'Tap to summon HUD',diff --git a/apps/desktop/src/i18n/types.ts b/apps/desktop/src/i18n/types.tsindex 51618d11cc7..b44010428ed 100644--- a/apps/desktop/src/i18n/types.ts+++ b/apps/desktop/src/i18n/types.ts@@ -1017,6 +1017,15 @@ export interface Translations extends NoticeTranslations {delegationModelOnly: stringdelegationProviderSelectLabel: stringdelegationModelSelectLabel: string+ delegationDirect: string+ delegationCustomProvider: string+ delegationCustomProviderLabel: string+ delegationParentModel: string+ delegationParentModelWarning: string+ delegationDirectActive: string+ delegationDirectClear: string+ delegationCatalogFailed: string+ delegationDraftHint: string}hudModifier: {title: stringdiff --git a/apps/desktop/src/i18n/zh.ts b/apps/desktop/src/i18n/zh.tsindex 443d5cb296c..9d9132fcb68 100644--- a/apps/desktop/src/i18n/zh.ts+++ b/apps/desktop/src/i18n/zh.ts@@ -1289,7 +1289,16 @@ export const zhOverrides = {delegationInherit: '继承主智能体配置',delegationModelOnly: '自定义模型(沿用主智能体凭证)',delegationProviderSelectLabel: '子智能体提供商',- delegationModelSelectLabel: '子智能体模型'+ delegationModelSelectLabel: '子智能体模型',+ delegationDirect: '直接端点覆盖',+ delegationCustomProvider: '自定义提供商...',+ delegationCustomProviderLabel: '自定义子智能体提供商',+ delegationParentModel: '使用主智能体模型',+ delegationParentModelWarning: '所选提供商必须支持主智能体模型。模型不兼容时,仅覆盖提供商的路由可能失败。',+ delegationDirectActive: '直接端点已启用,优先于保存的提供商。选择此模式会保留其端点和凭证。',+ delegationDirectClear: '应用此路由会清除直接端点及其保存的密钥。其他请求设置保持不变。',+ delegationCatalogFailed: '模型目录不可用。请手动输入提供商和模型,或重试。',+ delegationDraftHint: '应用前,更改仅保留在本地。'},hudModifier: {title: '轻按唤出 HUD',diff --git a/website/docs/user-guide/desktop.md b/website/docs/user-guide/desktop.mdindex 811c68edd34..02a7b77c9fc 100644--- a/website/docs/user-guide/desktop.md+++ b/website/docs/user-guide/desktop.md@@ -109,6 +109,14 @@ The **microphone** is dictation; hover it and the other voice toggles fan out ab- **Favorite models.** Click the star on the left of a model row (or shift-click the row, the same gesture that pins a chat in the sidebar; Shift+Enter from the search box) to lift it into a **Favorites** section at the top of the picker. Starring never selects the model or closes the menu, so the same gesture undoes it. The section only appears once something is starred. Favorites show in the composer, in session tiles, and anywhere else a model is picked, because they are one stored preference. They persist per device, keep the order you starred them, and ignore the **Edit models** shortlist (a star IS an explicit "always show me this one"); a favorite for a provider that is not connected is kept and reappears when it reconnects. Searching is unaffected — a query lists every match in its provider's place.- **Mid-chat switches reset the prompt cache.** Switching the model inside a live chat means the next message re-reads the whole conversation at full input price (provider prompt caches are keyed to the model). Fine occasionally; on a long chat, a fresh chat on the new model is often cheaper than bouncing back and forth.+#### Subagent models and limits++Open **Settings → Model → Subagents** to choose a delegated agent's provider and model and adjust its turn limit, concurrency, timeout, and reasoning effort. The entire Subagents section lives alongside the main, auxiliary, and fallback model settings. The catalog and saved changes belong to the profile selected under **Applies to**.++Provider and model changes remain a local draft until you click **Apply**. **Cancel**, leaving the page, or changing the settings profile discards an unapplied route. A provider switch requires a model; select **Use parent model** explicitly for a provider-only override, and make sure that provider supports the parent's model.++**Inherit from main agent** uses the parent's model and credentials. **Custom model (use parent credentials)** overrides only the model. Existing direct endpoints are shown as **Direct endpoint override**. Applying a different route clears the superseded delegation endpoint and its stored key together, without removing other request settings. If the catalog is unavailable, use **Custom provider...** and **Custom model…** to enter a route manually, or click **Retry** without losing your draft.+### File browserExplore and preview the working directory without leaving the app — useful for following along as the agent reads, writes, and edits files. Set the initial project directory with `hermes desktop --cwd <path>` (or the `HERMES_DESKTOP_CWD` environment variable).