1```mermaid
2sequenceDiagram
3 participant UI as ๐งฉ ChatSettings
4 participant settingsStore as ๐๏ธ settingsStore
5 participant serverStore as ๐๏ธ serverStore
6 participant ParamSvc as โ๏ธ ParameterSyncService
7 participant LS as ๐พ LocalStorage
8
9 Note over settingsStore: State:<br/>config: SettingsConfigType<br/>theme: string ("auto" | "light" | "dark")<br/>isInitialized: boolean<br/>userOverrides: Set<string>
10
11 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
12 Note over UI,LS: ๐ INITIALIZATION
13 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
14
15 Note over settingsStore: Auto-initialized in constructor (browser only)
16 settingsStore->>settingsStore: initialize()
17 activate settingsStore
18
19 settingsStore->>settingsStore: loadConfig()
20 settingsStore->>LS: get("llama-config")
21 LS-->>settingsStore: StoredConfig | null
22
23 alt config exists
24 settingsStore->>settingsStore: Merge with SETTING_CONFIG_DEFAULT
25 Note right of settingsStore: Fill missing keys with defaults
26 else no config
27 settingsStore->>settingsStore: config = SETTING_CONFIG_DEFAULT
28 end
29
30 settingsStore->>LS: get("llama-userOverrides")
31 LS-->>settingsStore: string[] | null
32 settingsStore->>settingsStore: userOverrides = new Set(data)
33
34 settingsStore->>settingsStore: loadTheme()
35 settingsStore->>LS: get("llama-theme")
36 LS-->>settingsStore: theme | "auto"
37
38 settingsStore->>settingsStore: isInitialized = true
39 deactivate settingsStore
40
41 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
42 Note over UI,LS: ๐ SYNC WITH SERVER DEFAULTS
43 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
44
45 Note over UI: Triggered from +layout.svelte when serverStore.props loaded
46 UI->>settingsStore: syncWithServerDefaults()
47 activate settingsStore
48
49 settingsStore->>serverStore: defaultParams
50 serverStore-->>settingsStore: {temperature, top_p, top_k, ...}
51
52 settingsStore->>ParamSvc: extractServerDefaults(defaultParams)
53 ParamSvc-->>settingsStore: Record<string, value>
54
55 settingsStore->>ParamSvc: mergeWithServerDefaults(config, serverDefaults)
56 Note right of ParamSvc: For each syncable parameter:<br/>- If NOT in userOverrides โ use server default<br/>- If in userOverrides โ keep user value
57 ParamSvc-->>settingsStore: mergedConfig
58
59 settingsStore->>settingsStore: config = mergedConfig
60 settingsStore->>settingsStore: saveConfig()
61 deactivate settingsStore
62
63 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
64 Note over UI,LS: โ๏ธ UPDATE CONFIG
65 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
66
67 UI->>settingsStore: updateConfig(key, value)
68 activate settingsStore
69 settingsStore->>settingsStore: config[key] = value
70 settingsStore->>settingsStore: userOverrides.add(key)
71 Note right of settingsStore: Mark as user-modified (won't be overwritten by server)
72 settingsStore->>settingsStore: saveConfig()
73 settingsStore->>LS: set("llama-config", config)
74 settingsStore->>LS: set("llama-userOverrides", [...userOverrides])
75 deactivate settingsStore
76
77 UI->>settingsStore: updateMultipleConfig({key1: val1, key2: val2})
78 activate settingsStore
79 Note right of settingsStore: Batch update, single save
80 settingsStore->>settingsStore: For each key: config[key] = value
81 settingsStore->>settingsStore: For each key: userOverrides.add(key)
82 settingsStore->>settingsStore: saveConfig()
83 deactivate settingsStore
84
85 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
86 Note over UI,LS: ๐ RESET
87 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
88
89 UI->>settingsStore: resetConfig()
90 activate settingsStore
91 settingsStore->>settingsStore: config = SETTING_CONFIG_DEFAULT
92 settingsStore->>settingsStore: userOverrides.clear()
93 settingsStore->>settingsStore: syncWithServerDefaults()
94 Note right of settingsStore: Apply server defaults for syncable params
95 settingsStore->>settingsStore: saveConfig()
96 deactivate settingsStore
97
98 UI->>settingsStore: resetParameterToServerDefault(key)
99 activate settingsStore
100 settingsStore->>settingsStore: userOverrides.delete(key)
101 settingsStore->>serverStore: defaultParams[key]
102 settingsStore->>settingsStore: config[key] = serverDefault
103 settingsStore->>settingsStore: saveConfig()
104 deactivate settingsStore
105
106 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
107 Note over UI,LS: ๐จ THEME
108 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
109
110 UI->>settingsStore: updateTheme(newTheme)
111 activate settingsStore
112 settingsStore->>settingsStore: theme = newTheme
113 settingsStore->>settingsStore: saveTheme()
114 settingsStore->>LS: set("llama-theme", theme)
115 deactivate settingsStore
116
117 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
118 Note over UI,LS: ๐ PARAMETER INFO
119 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
120
121 UI->>settingsStore: getParameterInfo(key)
122 settingsStore->>ParamSvc: getParameterInfo(key, config, serverDefaults, userOverrides)
123 ParamSvc-->>settingsStore: ParameterInfo
124 Note right of ParamSvc: {<br/> currentValue,<br/> serverDefault,<br/> isUserOverride: boolean,<br/> canSync: boolean,<br/> isDifferentFromServer: boolean<br/>}
125
126 UI->>settingsStore: getParameterDiff()
127 settingsStore->>ParamSvc: createParameterDiff(config, serverDefaults, userOverrides)
128 ParamSvc-->>settingsStore: ParameterDiff[]
129 Note right of ParamSvc: Array of parameters where user != server
130
131 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
132 Note over UI,LS: ๐ CONFIG CATEGORIES
133 %% โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
134
135 Note over settingsStore: Syncable with server (from /props):
136 rect rgb(240, 255, 240)
137 Note over settingsStore: temperature, top_p, top_k, min_p<br/>repeat_penalty, presence_penalty, frequency_penalty<br/>dynatemp_range, dynatemp_exponent<br/>typ_p, xtc_probability, xtc_threshold<br/>dry_multiplier, dry_base, dry_allowed_length, dry_penalty_last_n
138 end
139
140 Note over settingsStore: UI-only (not synced):
141 rect rgb(255, 240, 240)
142 Note over settingsStore: systemMessage, custom (JSON)<br/>showStatistics, enableContinueGeneration<br/>autoMicOnEmpty, disableAutoScroll<br/>apiKey, pdfAsImage, disableReasoningFormat
143 end
144```