@swarmclawai/swarmclaw 0.7.2 → 0.7.4

package/src/components/shared/model-combobox.tsx

@@ -1,8 +1,9 @@
 'use client'
 
-import { useState, useRef, useEffect, useCallback } from 'react'
+import { useState, useRef, useEffect, useCallback, useEffectEvent } from 'react'
 import { api } from '@/lib/api-client'
 import { useAppStore } from '@/stores/use-app-store'
+import { fetchProviderModelDiscovery } from '@/lib/provider-model-discovery-client'
 
 interface ModelComboboxProps {
   providerId: string
@@ -10,6 +11,9 @@ interface ModelComboboxProps {
   onChange: (model: string) => void
   models: string[]
   defaultModels?: string[]
+  credentialId?: string | null
+  apiEndpoint?: string | null
+  supportsDiscovery?: boolean
   className?: string
 }
 
@@ -19,20 +23,31 @@ export function ModelCombobox({
   onChange,
   models,
   defaultModels = [],
+  credentialId,
+  apiEndpoint,
+  supportsDiscovery = true,
   className,
 }: ModelComboboxProps) {
   const [open, setOpen] = useState(false)
   const [query, setQuery] = useState('')
+  const [discoveredModels, setDiscoveredModels] = useState<string[]>([])
+  const [discoveryState, setDiscoveryState] = useState<'idle' | 'loading' | 'ready' | 'notice'>('idle')
+  const [discoveryMessage, setDiscoveryMessage] = useState('')
+  const [discoveryCached, setDiscoveryCached] = useState(false)
   const inputRef = useRef<HTMLInputElement>(null)
   const containerRef = useRef<HTMLDivElement>(null)
+  const lastDiscoveryKeyRef = useRef<string | null>(null)
   const loadProviders = useAppStore((s) => s.loadProviders)
 
-  const filtered = query
-    ? models.filter((m) => m.toLowerCase().includes(query.toLowerCase()))
-    : models
+  const availableModels = [...models, ...discoveredModels].filter((model, index, source) => source.indexOf(model) === index)
+  const trimmedQuery = query.trim()
+  const filtered = trimmedQuery
+    ? availableModels.filter((m) => m.toLowerCase().includes(trimmedQuery.toLowerCase()))
+    : availableModels
 
-  const isCustom = (m: string) => defaultModels.length > 0 && !defaultModels.includes(m)
-  const showAdd = query && !models.some((m) => m.toLowerCase() === query.toLowerCase())
+  const isCustom = (m: string) => models.includes(m) && defaultModels.length > 0 && !defaultModels.includes(m)
+  const showAdd = trimmedQuery && !availableModels.some((m) => m.toLowerCase() === trimmedQuery.toLowerCase())
+  const discoveryKey = `${providerId}::${credentialId || ''}::${apiEndpoint?.trim() || ''}`
 
   const persistModels = useCallback(async (next: string[]) => {
     await api('PUT', `/providers/${providerId}/models`, { models: next })
@@ -65,6 +80,43 @@ export function ModelCombobox({
     setOpen(false)
   }, [onChange])
 
+  const loadDiscoveredModels = useCallback(async (force = false) => {
+    if (!supportsDiscovery) return
+    if (!force && lastDiscoveryKeyRef.current === discoveryKey) return
+    setDiscoveryState('loading')
+    setDiscoveryMessage('')
+    try {
+      const result = await fetchProviderModelDiscovery({
+        providerId,
+        credentialId,
+        endpoint: apiEndpoint,
+        force,
+      })
+      lastDiscoveryKeyRef.current = discoveryKey
+      setDiscoveryCached(result.cached)
+      setDiscoveredModels(result.models)
+      setDiscoveryState(result.ok ? 'ready' : 'notice')
+      setDiscoveryMessage(result.message || '')
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Failed to load live models.'
+      setDiscoveryState('notice')
+      setDiscoveryMessage(message)
+    }
+  }, [apiEndpoint, credentialId, discoveryKey, providerId, supportsDiscovery])
+
+  const resetDiscoveryState = useEffectEvent(() => {
+    lastDiscoveryKeyRef.current = null
+    setDiscoveredModels([])
+    setDiscoveryState('idle')
+    setDiscoveryMessage('')
+    setDiscoveryCached(false)
+  })
+
+  const syncDiscoveryOnOpen = useEffectEvent(() => {
+    if (!open || !supportsDiscovery) return
+    void loadDiscoveredModels()
+  })
+
   useEffect(() => {
     const handler = (e: MouseEvent) => {
       if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
@@ -76,6 +128,14 @@ export function ModelCombobox({
     return () => document.removeEventListener('mousedown', handler)
   }, [])
 
+  useEffect(() => {
+    resetDiscoveryState()
+  }, [providerId, credentialId, apiEndpoint])
+
+  useEffect(() => {
+    syncDiscoveryOnOpen()
+  }, [open, supportsDiscovery, loadDiscoveredModels])
+
   return (
     <div ref={containerRef} className="relative">
       <div
@@ -105,6 +165,28 @@ export function ModelCombobox({
 
       {open && (
         <div className="absolute z-50 top-full left-0 right-0 mt-1 max-h-[240px] overflow-y-auto rounded-[12px] border border-white/[0.08] bg-surface-2 shadow-xl">
+          {supportsDiscovery && (
+            <div className="sticky top-0 z-[1] flex items-center justify-between gap-3 border-b border-white/[0.06] bg-surface-2/95 px-3 py-2 backdrop-blur">
+              <div className={`min-w-0 text-[11px] ${discoveryState === 'notice' ? 'text-text-3/80' : 'text-text-3/60'}`}>
+                {discoveryState === 'loading'
+                  ? 'Checking live model catalog...'
+                  : discoveryMessage || 'Type any model name or load the live catalog.'}
+                {discoveryCached && discoveryState === 'ready' ? ' Cached.' : ''}
+              </div>
+              <button
+                type="button"
+                onClick={(e) => {
+                  e.stopPropagation()
+                  void loadDiscoveredModels(true)
+                }}
+                disabled={discoveryState === 'loading'}
+                className="shrink-0 rounded-[7px] border border-white/[0.08] bg-white/[0.03] px-2 py-1 text-[10px] font-600 text-text-3/80 transition-colors hover:bg-white/[0.06] hover:text-text disabled:cursor-default disabled:opacity-60"
+              >
+                {discoveryState === 'loading' ? 'Loading...' : discoveredModels.length > 0 ? 'Refresh' : 'Fetch live'}
+              </button>
+            </div>
+          )}
+
           {filtered.map((m) => (
             <div
               key={m}
@@ -128,13 +210,13 @@ export function ModelCombobox({
 
           {showAdd && (
             <div
-              onClick={() => addModel(query.trim())}
+              onClick={() => addModel(trimmedQuery)}
               className="flex items-center gap-2 px-3 py-2 text-[14px] cursor-pointer transition-colors hover:bg-white/[0.04] text-accent-bright border-t border-white/[0.06]"
             >
               <svg className="w-3.5 h-3.5 shrink-0" viewBox="0 0 16 16" fill="none">
                 <path d="M8 3v10M3 8h10" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
               </svg>
-              <span className="truncate">Add &ldquo;{query.trim()}&rdquo;</span>
+              <span className="truncate">Add &ldquo;{trimmedQuery}&rdquo;</span>
             </div>
           )}
 

package/src/components/shared/settings/plugin-manager.tsx

@@ -129,8 +129,8 @@ export function PluginManager() {
 
   const { corePlugins, installedPlugins } = useMemo(() => {
     return {
-      corePlugins: plugins.filter(p => p.source === 'local'),
-      installedPlugins: plugins.filter(p => p.source !== 'local')
+      corePlugins: plugins.filter(p => p.isBuiltin),
+      installedPlugins: plugins.filter(p => !p.isBuiltin)
     }
   }, [plugins])
 
@@ -155,6 +155,22 @@ export function PluginManager() {
         </div>
         <div className="text-[11px] font-mono text-text-3/40 truncate">{p.filename}</div>
         {p.description && <div className="text-[12px] text-text-3/70 mt-1 line-clamp-1">{p.description}</div>}
+        {p.hasDependencyManifest && (
+          <div className="mt-1.5 flex items-center gap-2 text-[10px] font-700 uppercase tracking-[0.08em]">
+            <span className="px-1.5 py-0.5 rounded bg-white/[0.04] text-text-3/70">
+              {p.dependencyCount ?? 0} deps
+            </span>
+            <span className={`px-1.5 py-0.5 rounded ${
+              p.dependencyInstallStatus === 'installed'
+                ? 'bg-emerald-500/10 text-emerald-400'
+                : p.dependencyInstallStatus === 'error'
+                  ? 'bg-red-500/10 text-red-400'
+                  : 'bg-amber-500/10 text-amber-400'
+            }`}>
+              {p.dependencyInstallStatus || 'ready'}
+            </span>
+          </div>
+        )}
         {p.autoDisabled && (
           <div className="text-[11px] text-amber-400/90 mt-1.5 p-2 rounded-[8px] bg-amber-500/[0.03] border border-amber-500/10">
             {p.lastFailureStage ? `Error at ${p.lastFailureStage}:` : 'Last error:'} {p.lastFailureError}
@@ -163,7 +179,7 @@ export function PluginManager() {
       </div>
       
       <div className="flex items-center gap-2">
-        {p.source !== 'local' && (
+        {!p.isBuiltin && (
           <div className="flex items-center opacity-0 group-hover:opacity-100 transition-opacity">
             <button
               onClick={() => handleUpdateOne(p.filename)}
@@ -409,7 +425,7 @@ export function PluginManager() {
               </div>
             )}
             <p className="text-[11px] text-text-3/40 mt-6 leading-relaxed text-center italic">
-              SwarmClaw supports standalone CommonJS plugins and OpenClaw activate/deactivate formats.
+              SwarmClaw supports `.js` / `.mjs` plugins, native SwarmClaw hooks/tools, and OpenClaw activate/register formats.
             </p>
           </div>
         )}

package/src/components/shared/settings/section-capability-policy.tsx

@@ -1,8 +1,20 @@
 'use client'
 
+import type { ApprovalCategory } from '@/types'
 import type { SettingsSectionProps } from './types'
 
+const APPROVAL_CATEGORY_OPTIONS: Array<{ id: ApprovalCategory; label: string; description: string }> = [
+  { id: 'tool_access', label: 'Plugin Access', description: 'Auto-enable requested plugins for a chat.' },
+  { id: 'plugin_scaffold', label: 'Plugin Scaffold', description: 'Auto-create plugin files requested by agents.' },
+  { id: 'plugin_install', label: 'Plugin Install', description: 'Auto-install plugins from approved URLs.' },
+  { id: 'human_loop', label: 'Human Approval Requests', description: 'Auto-approve ask-human approval prompts.' },
+  { id: 'wallet_transfer', label: 'Wallet Transfers', description: 'Auto-approve wallet send requests. High risk.' },
+  { id: 'task_tool', label: 'Task Tool Calls', description: 'Reserved for task-level approval flows.' },
+]
+
 export function CapabilityPolicySection({ appSettings, patchSettings, inputClass }: SettingsSectionProps) {
+  const autoApproved = new Set(appSettings.approvalAutoApproveCategories || [])
+
   return (
     <div className="mb-10">
       <h3 className="font-display text-[12px] font-600 text-text-2 uppercase tracking-[0.08em] mb-2">
@@ -34,6 +46,24 @@ export function CapabilityPolicySection({ appSettings, patchSettings, inputClass
         </div>
 
         <div className="grid grid-cols-1 gap-4">
+          <div className="rounded-[12px] border border-white/[0.06] bg-bg px-4 py-4">
+            <div className="flex items-center justify-between gap-4">
+              <div>
+                <div className="text-[12px] font-600 text-text-2">Platform Approvals</div>
+                <p className="text-[11px] text-text-3/60 mt-1 leading-relaxed">
+                  Turn this off to auto-approve every approval request across the platform for maximum autonomy. Audit records are still kept.
+                </p>
+              </div>
+              <button
+                onClick={() => patchSettings({ approvalsEnabled: !(appSettings.approvalsEnabled ?? true) })}
+                className={`relative w-10 h-[22px] rounded-full transition-colors duration-200 cursor-pointer ${(appSettings.approvalsEnabled ?? true) ? 'bg-accent' : 'bg-white/[0.12]'}`}
+                aria-label="Toggle platform approvals"
+              >
+                <span className={`absolute top-[3px] left-[3px] w-4 h-4 rounded-full bg-white transition-transform duration-200 ${(appSettings.approvalsEnabled ?? true) ? 'translate-x-[18px]' : ''}`} />
+              </button>
+            </div>
+          </div>
+
           <div>
             <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Blocked Categories</label>
             <input
@@ -86,6 +116,81 @@ export function CapabilityPolicySection({ appSettings, patchSettings, inputClass
             />
             <p className="text-[11px] text-text-3/60 mt-2">Use this to re-allow specific tool families when running in strict mode.</p>
           </div>
+
+          <div>
+            <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Auto-Approve Workflow Requests</label>
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-2">
+              {APPROVAL_CATEGORY_OPTIONS.map((option) => {
+                const checked = autoApproved.has(option.id)
+                return (
+                  <label
+                    key={option.id}
+                    className={`rounded-[12px] border px-3 py-3 cursor-pointer transition-all ${
+                      checked
+                        ? 'border-accent-bright/30 bg-accent-soft/60'
+                        : 'border-white/[0.06] bg-bg hover:bg-surface-2'
+                    }`}
+                  >
+                    <div className="flex items-start gap-3">
+                      <input
+                        type="checkbox"
+                        checked={checked}
+                        onChange={(e) => {
+                          const next = new Set(appSettings.approvalAutoApproveCategories || [])
+                          if (e.target.checked) next.add(option.id)
+                          else next.delete(option.id)
+                          patchSettings({ approvalAutoApproveCategories: [...next] })
+                        }}
+                        className="mt-0.5"
+                      />
+                      <div>
+                        <div className="text-[12px] font-600 text-text-2">{option.label}</div>
+                        <p className="text-[11px] text-text-3/60 mt-1 leading-relaxed">{option.description}</p>
+                      </div>
+                    </div>
+                  </label>
+                )
+              })}
+            </div>
+            <p className="text-[11px] text-text-3/60 mt-2">
+              Auto-approved categories execute immediately instead of waiting in the Approvals queue. Leave high-risk categories off unless the user explicitly wants fully autonomous execution.
+            </p>
+          </div>
+
+          <div className="rounded-[12px] border border-white/[0.06] bg-bg px-4 py-4">
+            <div className="flex items-center justify-between gap-4">
+              <div>
+                <div className="text-[12px] font-600 text-text-2">Connector Approval Reminders</div>
+                <p className="text-[11px] text-text-3/60 mt-1 leading-relaxed">
+                  If an approval sits too long, let the agent send a one-time reminder over an active connector conversation it already has access to.
+                </p>
+              </div>
+              <button
+                onClick={() => patchSettings({ approvalConnectorNotifyEnabled: !(appSettings.approvalConnectorNotifyEnabled ?? true) })}
+                className={`relative w-10 h-[22px] rounded-full transition-colors duration-200 cursor-pointer ${(appSettings.approvalConnectorNotifyEnabled ?? true) ? 'bg-accent' : 'bg-white/[0.12]'}`}
+                aria-label="Toggle connector approval reminders"
+              >
+                <span className={`absolute top-[3px] left-[3px] w-4 h-4 rounded-full bg-white transition-transform duration-200 ${(appSettings.approvalConnectorNotifyEnabled ?? true) ? 'translate-x-[18px]' : ''}`} />
+              </button>
+            </div>
+            <div className="mt-4 max-w-[220px]">
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Reminder Delay (Sec)</label>
+              <input
+                type="number"
+                min={30}
+                max={86400}
+                value={appSettings.approvalConnectorNotifyDelaySec ?? 300}
+                onChange={(e) => {
+                  const next = Number.parseInt(e.target.value, 10)
+                  patchSettings({
+                    approvalConnectorNotifyDelaySec: Number.isFinite(next) ? Math.max(30, Math.min(86400, next)) : 300,
+                  })
+                }}
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+          </div>
         </div>
       </div>
     </div>

package/src/components/shared/settings/section-heartbeat.tsx

@@ -1,14 +1,24 @@
 'use client'
 
+import {
+  DEFAULT_HEARTBEAT_ACK_MAX_CHARS,
+  DEFAULT_HEARTBEAT_SHOW_ALERTS,
+  DEFAULT_HEARTBEAT_SHOW_OK,
+} from '@/lib/heartbeat-defaults'
 import { useState } from 'react'
 import { useAppStore } from '@/stores/use-app-store'
 import { api } from '@/lib/api-client'
+import type { SessionResetMode } from '@/types'
 import type { SettingsSectionProps } from './types'
 
 export function HeartbeatSection({ appSettings, patchSettings, inputClass }: SettingsSectionProps) {
   const loadSessions = useAppStore((s) => s.loadSessions)
   const [disablingHeartbeats, setDisablingHeartbeats] = useState(false)
   const [heartbeatBulkNotice, setHeartbeatBulkNotice] = useState('')
+  const parseResetMode = (value: string): SessionResetMode | null => {
+    if (value === 'idle' || value === 'daily') return value
+    return null
+  }
 
   const handleDisableAllHeartbeats = async () => {
     if (disablingHeartbeats) return
@@ -58,10 +68,10 @@ export function HeartbeatSection({ appSettings, patchSettings, inputClass }: Set
             <input
               type="number"
               min={0}
-              value={appSettings.heartbeatAckMaxChars ?? 300}
+              value={appSettings.heartbeatAckMaxChars ?? DEFAULT_HEARTBEAT_ACK_MAX_CHARS}
               onChange={(e) => {
                 const n = Number.parseInt(e.target.value, 10)
-                patchSettings({ heartbeatAckMaxChars: Number.isFinite(n) ? Math.max(0, n) : 300 })
+                patchSettings({ heartbeatAckMaxChars: Number.isFinite(n) ? Math.max(0, n) : DEFAULT_HEARTBEAT_ACK_MAX_CHARS })
               }}
               className={inputClass}
               style={{ fontFamily: 'inherit' }}
@@ -74,7 +84,7 @@ export function HeartbeatSection({ appSettings, patchSettings, inputClass }: Set
           <div>
             <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Show OK Messages</label>
             <button
-              onClick={() => patchSettings({ heartbeatShowOk: !(appSettings.heartbeatShowOk ?? false) })}
+              onClick={() => patchSettings({ heartbeatShowOk: !(appSettings.heartbeatShowOk ?? DEFAULT_HEARTBEAT_SHOW_OK) })}
               className={`px-3 py-2 rounded-[10px] border text-[12px] font-600 transition-colors cursor-pointer ${
                 appSettings.heartbeatShowOk
                   ? 'border-emerald-400/25 bg-emerald-500/10 text-emerald-300'
@@ -88,15 +98,15 @@ export function HeartbeatSection({ appSettings, patchSettings, inputClass }: Set
           <div>
             <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Show Alert Messages</label>
             <button
-              onClick={() => patchSettings({ heartbeatShowAlerts: !(appSettings.heartbeatShowAlerts ?? true) })}
+              onClick={() => patchSettings({ heartbeatShowAlerts: !(appSettings.heartbeatShowAlerts ?? DEFAULT_HEARTBEAT_SHOW_ALERTS) })}
               className={`px-3 py-2 rounded-[10px] border text-[12px] font-600 transition-colors cursor-pointer ${
-                (appSettings.heartbeatShowAlerts ?? true)
+                (appSettings.heartbeatShowAlerts ?? DEFAULT_HEARTBEAT_SHOW_ALERTS)
                   ? 'border-emerald-400/25 bg-emerald-500/10 text-emerald-300'
                   : 'border-white/[0.08] bg-white/[0.03] text-text-3'
               }`}
               style={{ fontFamily: 'inherit' }}
             >
-              {(appSettings.heartbeatShowAlerts ?? true) ? 'On' : 'Off'}
+              {(appSettings.heartbeatShowAlerts ?? DEFAULT_HEARTBEAT_SHOW_ALERTS) ? 'On' : 'Off'}
             </button>
           </div>
           <div>
@@ -112,6 +122,78 @@ export function HeartbeatSection({ appSettings, patchSettings, inputClass }: Set
           </div>
         </div>
 
+        <div className="border-t border-white/[0.06] pt-5 mt-5">
+          <h4 className="font-display text-[11px] font-600 text-text-2 uppercase tracking-[0.08em] mb-2">
+            Session Reset Defaults
+          </h4>
+          <p className="text-[11px] text-text-3/60 mb-4">
+            Freshness policy inherited by new sessions unless overridden on the agent or session itself.
+          </p>
+          <div className="grid grid-cols-1 md:grid-cols-2 gap-3 mb-3">
+            <div>
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Reset Mode</label>
+              <select
+                value={appSettings.sessionResetMode || ''}
+                onChange={(e) => patchSettings({ sessionResetMode: parseResetMode(e.target.value) })}
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              >
+                <option value="">Use built-in defaults</option>
+                <option value="idle">Idle</option>
+                <option value="daily">Daily</option>
+              </select>
+            </div>
+            <div>
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Idle Timeout (sec)</label>
+              <input
+                type="number"
+                min={0}
+                value={appSettings.sessionIdleTimeoutSec ?? ''}
+                onChange={(e) => patchSettings({ sessionIdleTimeoutSec: e.target.value ? Number.parseInt(e.target.value, 10) : null })}
+                placeholder="43200"
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+          </div>
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-3">
+            <div>
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Max Age (sec)</label>
+              <input
+                type="number"
+                min={0}
+                value={appSettings.sessionMaxAgeSec ?? ''}
+                onChange={(e) => patchSettings({ sessionMaxAgeSec: e.target.value ? Number.parseInt(e.target.value, 10) : null })}
+                placeholder="604800"
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+            <div>
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Daily Reset Time</label>
+              <input
+                type="text"
+                value={appSettings.sessionDailyResetAt || ''}
+                onChange={(e) => patchSettings({ sessionDailyResetAt: e.target.value || null })}
+                placeholder="04:00"
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+            <div>
+              <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Reset Timezone</label>
+              <input
+                type="text"
+                value={appSettings.sessionResetTimezone || ''}
+                onChange={(e) => patchSettings({ sessionResetTimezone: e.target.value || null })}
+                placeholder="UTC"
+                className={inputClass}
+                style={{ fontFamily: 'inherit' }}
+              />
+            </div>
+          </div>
+        </div>
+
         <div>
           <div className="flex items-center gap-2.5">
             <button

package/src/components/shared/settings/section-orchestrator.tsx

@@ -27,10 +27,10 @@ export function OrchestratorSection({ appSettings, patchSettings, inputClass }:
   return (
     <div className="mb-10">
       <h3 className="font-display text-[12px] font-600 text-text-2 uppercase tracking-[0.08em] mb-2">
-        Orchestrator Engine
+        Coordination Engine
       </h3>
       <p className="text-[12px] text-text-3 mb-5">
-        The LLM provider used by orchestrators for tool calling, agent generation, and task delegation.
+        The LLM provider used when agents coordinate delegation, tool calling, and automation-heavy runs.
       </p>
 
       <div className="p-6 rounded-[18px] bg-surface border border-white/[0.06]">
@@ -53,7 +53,7 @@ export function OrchestratorSection({ appSettings, patchSettings, inputClass }:
         </div>
         {lgProviders.length === 0 && (
           <p className="text-[12px] text-text-3/60 mb-5">
-            No orchestration-compatible providers available. Add an API provider in Providers.
+            No coordination-compatible providers available. Add an API provider in Providers.
           </p>
         )}
 
@@ -67,6 +67,9 @@ export function OrchestratorSection({ appSettings, patchSettings, inputClass }:
               onChange={(m) => patchSettings({ langGraphModel: m })}
               models={lgProviderInfo.models}
               defaultModels={lgProviderInfo.defaultModels}
+              credentialId={appSettings.langGraphCredentialId}
+              apiEndpoint={appSettings.langGraphEndpoint}
+              supportsDiscovery={lgProviderInfo.supportsModelDiscovery}
               className={`${inputClass} cursor-pointer`}
             />
           </div>

package/src/components/shared/settings/section-runtime-loop.tsx

@@ -24,7 +24,7 @@ export function RuntimeLoopSection({ appSettings, patchSettings, inputClass }: S
         Runtime & Loop Controls
       </h3>
       <p className="text-[12px] text-text-3 mb-5">
-        Choose bounded or ongoing agent loops and set safety guards for task execution.
+        Control how far agents can run on their own and set safety guards for delegation and tool execution.
       </p>
       <div className="p-6 rounded-[18px] bg-surface border border-white/[0.06]">
         <label className="flex items-center gap-1.5 font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-3">Loop Mode <HintTip text="Bounded = fixed max steps. Ongoing = runs until the task completes (with a safety cap)" /></label>
@@ -64,8 +64,8 @@ export function RuntimeLoopSection({ appSettings, patchSettings, inputClass }: S
                 style={{ fontFamily: 'inherit' }}
               />
             </div>
-            <div>
-              <label className="flex items-center gap-1.5 font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Orchestrator Steps <HintTip text="Maximum tool calls the orchestrator can make when coordinating multiple agents" /></label>
+          <div>
+            <label className="flex items-center gap-1.5 font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Coordination Steps <HintTip text="Maximum tool calls an agent can make while coordinating multiple delegated agents" /></label>
               <input
                 type="number"
                 min={1}
@@ -79,8 +79,8 @@ export function RuntimeLoopSection({ appSettings, patchSettings, inputClass }: S
                 style={{ fontFamily: 'inherit' }}
               />
             </div>
-            <div>
-              <label className="flex items-center gap-1.5 font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Legacy Turns <HintTip text="Max conversation turns for older orchestration mode — increase if agents get cut off mid-task" /></label>
+          <div>
+            <label className="flex items-center gap-1.5 font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Legacy Turns <HintTip text="Compatibility limit for older coordination flows that still rely on turn-based execution" /></label>
               <input
                 type="number"
                 min={1}

package/src/components/shared/settings/section-secrets.tsx

@@ -53,7 +53,7 @@ export function SecretsSection({ appSettings, inputClass }: SettingsSectionProps
     }
   }
 
-  const orchestrators = Object.values(agents).filter((p) => p.isOrchestrator)
+  const selectableAgents = Object.values(agents)
   const secretList = Object.entries(secrets).map(([rowId, secret]) => ({ ...secret, rowId }))
 
   return (
@@ -62,7 +62,7 @@ export function SecretsSection({ appSettings, inputClass }: SettingsSectionProps
         Service Credentials
       </h3>
       <p className="text-[12px] text-text-3 mb-5">
-        Credentials for external services (Gmail, APIs, etc.) that orchestrators can use during task execution.
+        Credentials for external services (Gmail, APIs, etc.) that agents can use during task execution.
       </p>
 
       {secretList.length > 0 && (
@@ -78,7 +78,7 @@ export function SecretsSection({ appSettings, inputClass }: SettingsSectionProps
                       ? 'bg-emerald-500/10 text-emerald-400'
                       : 'bg-amber-500/10 text-amber-400'
                   }`}>
-                    {secret.scope === 'global' ? 'All orchestrators' : `${secret.agentIds.length} orchestrator(s)`}
+                    {secret.scope === 'global' ? 'All eligible agents' : `${secret.agentIds.length} agent(s)`}
                   </span>
                 </div>
               </div>
@@ -106,14 +106,14 @@ export function SecretsSection({ appSettings, inputClass }: SettingsSectionProps
             <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Scope</label>
             <div className="flex p-1 rounded-[12px] bg-bg border border-white/[0.06]">
               {(['global', 'agent'] as const).map((s) => (
-                <button key={s} onClick={() => setSecretScope(s)} className={`flex-1 py-2.5 rounded-[10px] text-center cursor-pointer transition-all text-[13px] font-600 capitalize ${secretScope === s ? 'bg-accent-soft text-accent-bright' : 'bg-transparent text-text-3 hover:text-text-2'}`} style={{ fontFamily: 'inherit' }}>{s === 'global' ? 'All Orchestrators' : 'Specific'}</button>
+                <button key={s} onClick={() => setSecretScope(s)} className={`flex-1 py-2.5 rounded-[10px] text-center cursor-pointer transition-all text-[13px] font-600 capitalize ${secretScope === s ? 'bg-accent-soft text-accent-bright' : 'bg-transparent text-text-3 hover:text-text-2'}`} style={{ fontFamily: 'inherit' }}>{s === 'global' ? 'All Eligible Agents' : 'Specific Agents'}</button>
               ))}
             </div>
           </div>
 
-          {secretScope === 'agent' && orchestrators.length > 0 && (
+          {secretScope === 'agent' && selectableAgents.length > 0 && (
             <div className="flex flex-wrap gap-2">
-              {orchestrators.map((p) => (
+              {selectableAgents.map((p) => (
                 <button key={p.id} onClick={() => setSecretAgentIds((prev) => prev.includes(p.id) ? prev.filter((x) => x !== p.id) : [...prev, p.id])} className={`px-3 py-2 rounded-[10px] text-[12px] font-600 cursor-pointer transition-all border ${secretAgentIds.includes(p.id) ? 'bg-accent-soft border-accent-bright/25 text-accent-bright' : 'bg-bg border-white/[0.06] text-text-3 hover:text-text-2'}`} style={{ fontFamily: 'inherit' }}>{p.name}</button>
               ))}
             </div>

package/src/components/shared/settings/section-user-preferences.tsx

@@ -47,7 +47,7 @@ export function UserPreferencesSection({ appSettings, patchSettings, inputClass
       <div className="mt-6">
         <label className="text-[12px] font-600 text-text-2 block mb-1.5">Default Agent</label>
         <p className="text-[11px] text-text-3/60 mb-2">
-          The agent that opens automatically when you start the app or click Main Chat.
+          The agent that opens automatically when you start the app or use the default-agent shortcut.
         </p>
         <div className="flex flex-wrap gap-2">
           <button

package/src/components/shared/settings/section-voice.tsx

@@ -4,6 +4,7 @@ import type { SettingsSectionProps } from './types'
 
 export function VoiceSection({ appSettings, patchSettings, inputClass }: SettingsSectionProps) {
   const enabled = appSettings.elevenLabsEnabled ?? false
+  const hasApiKey = appSettings.elevenLabsApiKeyConfigured === true
 
   return (
     <div className="mb-10">
@@ -37,10 +38,13 @@ export function VoiceSection({ appSettings, patchSettings, inputClass }: Setting
                 type="password"
                 value={appSettings.elevenLabsApiKey || ''}
                 onChange={(e) => patchSettings({ elevenLabsApiKey: e.target.value || null })}
-                placeholder="sk_..."
+                placeholder={hasApiKey ? 'Stored securely. Enter a new key to replace it.' : 'sk_...'}
                 className={inputClass}
                 style={{ fontFamily: 'inherit' }}
               />
+              {hasApiKey && (
+                <p className="text-[11px] text-emerald-400/90 mt-1.5">Stored securely. Clear the field and save to remove it.</p>
+              )}
             </div>
             <div>
               <label className="block font-display text-[11px] font-600 text-text-3 uppercase tracking-[0.08em] mb-2">Default Voice ID</label>