tagword-codeagent 1.1.6__py3-none-any.whl

codeagent/web/static/01i-model-stack.js

@@ -0,0 +1,291 @@
+/* Model stack: auto-select single presets + compose pill summary */
+
+function truncateStackLabel(text, maxLen) {
+  const s = String(text || '').trim();
+  if (s.length <= maxLen) return s;
+  return s.slice(0, maxLen - 1) + '…';
+}
+
+function presetShortLabel(p) {
+  if (!p) return '';
+  const model = (p.model_label || p.model || p.name || p.id || '').trim();
+  const prov = (p.provider_label || p.provider || '').trim();
+  if (model && prov) return model;
+  return model || prov || p.id || '';
+}
+
+function stripModelPath(name) {
+  const s = String(name || '').trim();
+  if (!s) return '';
+  const i = s.lastIndexOf('/');
+  return (i >= 0 && i < s.length - 1) ? s.slice(i + 1) : s;
+}
+
+function findChatPresetById(id) {
+  if (!id) return null;
+  return (window._llmPresetsCache || []).find(function(p) {
+    return p.id === id && (typeof inferPresetUseType !== 'function' || inferPresetUseType(p) === 'chat');
+  }) || null;
+}
+
+function presetComposeLabel(p, opts) {
+  if (!p) return '';
+  opts = opts || {};
+  let base = stripModelPath(presetShortLabel(p) || p.model || p.name || p.id || '');
+  if (!base) return '';
+  if (opts.isDefault) base += ' · 默认';
+  return base;
+}
+
+function presetOptionDetail(p) {
+  if (!p) return '';
+  const parts = [];
+  const name = (p.name || '').trim();
+  const model = stripModelPath(p.model_label || p.model || '');
+  const prov = (p.provider_label || p.provider || '').trim();
+  if (name && name !== model) parts.push(name);
+  if (model) parts.push(model);
+  if (prov) parts.push(prov);
+  const ut = (p.use_type_label || '').trim();
+  if (ut) parts.push(ut);
+  return parts.filter(Boolean).join(' · ') || String(p.id || '');
+}
+
+function getChatMainDisplayLabel(sel) {
+  if (!sel || sel.disabled) return '默认模型';
+  const v = sel.value;
+  if (!v || v === '__default__') {
+    const def = findChatPresetById(window._llmDefaultId || '');
+    if (def) return presetComposeLabel(def, { isDefault: true });
+    return '默认模型';
+  }
+  const preset = findChatPresetById(v);
+  if (preset) {
+    return presetComposeLabel(preset, { isDefault: preset.id === (window._llmDefaultId || '') });
+  }
+  return getSelectShortLabel(sel) || '默认模型';
+}
+
+function getSelectShortLabel(sel) {
+  if (!sel || sel.disabled) return '';
+  const v = sel.value;
+  if (!v || v === '__default__' || v === '__none__') return '';
+
+  const chatPreset = findChatPresetById(v);
+  if (chatPreset) return stripModelPath(presetShortLabel(chatPreset) || chatPreset.model || chatPreset.id);
+
+  const opt = sel.options[sel.selectedIndex];
+  if (!opt) return stripModelPath(v);
+  let t = (opt.textContent || '').trim().replace(/\s*（默认）\s*$/, '').replace(/\s*·\s*默认\s*$/, '');
+  const parts = t.split(/\s*·\s*/).map(function(p) { return stripModelPath(p.trim()); }).filter(Boolean);
+  if (!parts.length) return stripModelPath(v);
+
+  const skip = /^(对话|chat|识图|生图|音频|音乐|视频|多模态)$/i;
+  const modelish = parts.filter(function(p) { return p.includes('-') || p.includes('.'); });
+  if (modelish.length) return modelish[0];
+  const filtered = parts.filter(function(p) { return !skip.test(p); });
+  if (filtered.length) {
+    filtered.sort(function(a, b) { return a.length - b.length; });
+    return filtered[0];
+  }
+  return parts[parts.length - 1] || stripModelPath(v);
+}
+
+function composePillMaxLen() {
+  try {
+    return window.matchMedia('(max-width: 768px)').matches ? 12 : 20;
+  } catch (_) {
+    return 20;
+  }
+}
+
+function autoSelectSinglePreset(sel, getVal, setVal, presets) {
+  if (!sel || sel.disabled || !Array.isArray(presets) || presets.length !== 1) return;
+  const only = presets[0];
+  const pid = only && only.id;
+  if (!pid) return;
+  const cur = (typeof getVal === 'function' ? getVal() : '') || '';
+  if (cur && cur !== '__none__') return;
+  if (typeof setVal === 'function') setVal(pid);
+  sel.value = pid;
+}
+
+function autoSelectModelStackPresets() {
+  autoSelectSinglePreset(
+    document.getElementById('visionModelSelect'),
+    typeof getSelectedVisionModel === 'function' ? getSelectedVisionModel : null,
+    typeof setSelectedVisionModel === 'function' ? setSelectedVisionModel : null,
+    window._visionPresetsCache
+  );
+  autoSelectSinglePreset(
+    document.getElementById('imageGenModelSelect'),
+    typeof getSelectedImageGenModel === 'function' ? getSelectedImageGenModel : null,
+    typeof setSelectedImageGenModel === 'function' ? setSelectedImageGenModel : null,
+    window._imageGenPresetsCache
+  );
+  autoSelectSinglePreset(
+    document.getElementById('audioModelSelect'),
+    typeof getSelectedAudioModel === 'function' ? getSelectedAudioModel : null,
+    typeof setSelectedAudioModel === 'function' ? setSelectedAudioModel : null,
+    window._audioPresetsCache
+  );
+  autoSelectSinglePreset(
+    document.getElementById('musicModelSelect'),
+    typeof getSelectedMusicModel === 'function' ? getSelectedMusicModel : null,
+    typeof setSelectedMusicModel === 'function' ? setSelectedMusicModel : null,
+    window._musicPresetsCache
+  );
+  autoSelectSinglePreset(
+    document.getElementById('videoGenModelSelect'),
+    typeof getSelectedVideoGenModel === 'function' ? getSelectedVideoGenModel : null,
+    typeof setSelectedVideoGenModel === 'function' ? setSelectedVideoGenModel : null,
+    window._videoGenPresetsCache
+  );
+
+  const chatSel = document.getElementById('modelSelect');
+  if (chatSel && !chatSel.disabled) {
+    const chatPresets = (window._llmPresetsCache || []).filter(function(p) {
+      return typeof inferPresetUseType === 'function' && inferPresetUseType(p) === 'chat';
+    });
+    const cur = typeof getSelectedModel === 'function' ? getSelectedModel() : '';
+    if (!cur && chatPresets.length === 1 && chatPresets[0].id) {
+      chatSel.value = chatPresets[0].id;
+      if (typeof setSelectedModel === 'function') setSelectedModel(chatPresets[0].id);
+    }
+  }
+}
+
+function updateComposeStackMissingHint() {
+  const hint = document.getElementById('composeStackMissingHint');
+  if (!hint) return;
+  const checks = [
+    { sel: document.getElementById('visionModelSelect'), cache: window._visionPresetsCache },
+    { sel: document.getElementById('imageGenModelSelect'), cache: window._imageGenPresetsCache },
+    { sel: document.getElementById('audioModelSelect'), cache: window._audioPresetsCache },
+    { sel: document.getElementById('musicModelSelect'), cache: window._musicPresetsCache },
+    { sel: document.getElementById('videoGenModelSelect'), cache: window._videoGenPresetsCache },
+  ];
+  let anyMissing = false;
+  checks.forEach(function(c) {
+    if (Array.isArray(c.cache) && c.cache.length === 0) anyMissing = true;
+  });
+  hint.hidden = !anyMissing;
+}
+
+function updateComposeModelStackPill() {
+  const pill = document.getElementById('composeModelPillLabel');
+  const extra = document.getElementById('composeModelPillExtra');
+  const pin = document.getElementById('composeModelPillPin');
+  const trigger = document.getElementById('composeModelTrigger');
+  const chatSel = document.getElementById('modelSelect');
+  if (!pill || !chatSel) return;
+
+  const main = getChatMainDisplayLabel(chatSel);
+  const extras = [];
+
+  const visionLabel = getSelectShortLabel(document.getElementById('visionModelSelect'));
+  if (visionLabel) extras.push('识图 ' + visionLabel);
+
+  const imageLabel = getSelectShortLabel(document.getElementById('imageGenModelSelect'));
+  if (imageLabel) extras.push('生图 ' + imageLabel);
+
+  const audioLabel = getSelectShortLabel(document.getElementById('audioModelSelect'));
+  if (audioLabel) extras.push('音频 ' + audioLabel);
+
+  const musicLabel = getSelectShortLabel(document.getElementById('musicModelSelect'));
+  if (musicLabel) extras.push('音乐 ' + musicLabel);
+
+  const videoGenLabel = getSelectShortLabel(document.getElementById('videoGenModelSelect'));
+  if (videoGenLabel) extras.push('视频 ' + videoGenLabel);
+
+  const summary = [main].concat(extras).join(' · ');
+  pill.textContent = truncateStackLabel(main, composePillMaxLen());
+  pill.title = main;
+
+  if (extra) {
+    if (extras.length > 0) {
+      extra.textContent = '+' + extras.length;
+      extra.hidden = false;
+      extra.setAttribute('aria-hidden', 'false');
+      extra.title = extras.join('、');
+    } else {
+      extra.hidden = true;
+      extra.setAttribute('aria-hidden', 'true');
+      extra.textContent = '';
+    }
+  }
+
+  if (trigger) trigger.title = '模型栈：' + summary;
+
+  // Per-session override pin badge + "clear overrides" button visibility
+  let hasOverride = false;
+  if (window.ModelStackState) {
+    const slots = window.ModelStackState.listSessionOverrideSlots();
+    hasOverride = slots.length > 0;
+  }
+  if (pin) {
+    pin.hidden = !hasOverride;
+    pin.setAttribute('aria-hidden', hasOverride ? 'false' : 'true');
+    if (hasOverride) pin.title = '本会话已自定义模型（按 session 隔离）';
+  }
+  const clearBtn = document.getElementById('composeClearOverridesBtn');
+  if (clearBtn) clearBtn.hidden = !hasOverride;
+  const hint = document.getElementById('composeStackActionsHint');
+  if (hint) {
+    hint.textContent = hasOverride
+      ? '当前会话已自定义以下模型：切到别的会话不会受影响。'
+      : '当前会话未自定义：使用全局默认。';
+  }
+}
+
+function refreshComposeModelStackUi() {
+  autoSelectModelStackPresets();
+  updateComposeStackMissingHint();
+  if (typeof updateComposeModelPill === 'function') {
+    updateComposeModelPill();
+  } else {
+    updateComposeModelStackPill();
+  }
+}
+
+(function initModelStackUi() {
+  ['modelSelect', 'visionModelSelect', 'imageGenModelSelect', 'audioModelSelect', 'musicModelSelect', 'videoGenModelSelect'].forEach(function(id) {
+    const sel = document.getElementById(id);
+    if (!sel) return;
+    sel.addEventListener('change', function() {
+      updateComposeModelStackPill();
+      updateComposeStackMissingHint();
+    });
+  });
+
+  window.addEventListener('resize', function() {
+    if (typeof updateComposeModelStackPill === 'function') updateComposeModelStackPill();
+  });
+
+  document.addEventListener('DOMContentLoaded', function() {
+    refreshComposeModelStackUi();
+  });
+  if (document.readyState !== 'loading') {
+    setTimeout(refreshComposeModelStackUi, 0);
+  }
+
+  // Bind "clear all overrides" button (only meaningful when MS is available)
+  const clearBtn = document.getElementById('composeClearOverridesBtn');
+  if (clearBtn) {
+    clearBtn.addEventListener('click', async function() {
+      if (!window.ModelStackState) return;
+      const sid = window.ModelStackState.getModelStackScope();
+      if (!sid) return;
+      if (!confirm('清除当前会话的所有模型覆盖吗？将恢复为全局默认。')) return;
+      window.ModelStackState.clearAllSessionOverrides(sid);
+      // Persist (empty) to backend
+      try { await window.ModelStackState.persistToBackendNow(); } catch (_) {}
+      // Re-apply selectors
+      if (typeof window.refreshModelStackUi === 'function') {
+        window.refreshModelStackUi();
+      } else {
+        refreshComposeModelStackUi();
+      }
+    });
+  }
+})();

codeagent/web/static/01j-video-gen-model.js

@@ -0,0 +1,85 @@
+/* Video-gen LLM selector — per-session via ModelStackState */
+
+const VIDEO_GEN_MODEL_KEY = 'oa_video_gen_preset_id';  // legacy, kept for migration
+
+function getSelectedVideoGenModel() {
+  if (window.ModelStackState) return window.ModelStackState.getEffectiveModel('video_gen');
+  try { return localStorage.getItem(VIDEO_GEN_MODEL_KEY) || ''; } catch (_) { return ''; }
+}
+function setSelectedVideoGenModel(val) {
+  if (window.ModelStackState) {
+    if (val && val !== '__none__') {
+      window.ModelStackState.setSessionOverride('video_gen', val);
+      window.ModelStackState.schedulePersistToBackend();
+    } else {
+      window.ModelStackState.clearSessionOverride('video_gen');
+      window.ModelStackState.schedulePersistToBackend();
+    }
+    return;
+  }
+  try { localStorage.setItem(VIDEO_GEN_MODEL_KEY, String(val || '').trim()); } catch (_) {}
+}
+
+async function refreshVideoGenModelSelect() {
+  const sel = document.getElementById('videoGenModelSelect');
+  if (!sel) return;
+  try {
+    const r = await fetch('/api/ui/llm/presets');
+    if (!r.ok) return;
+    const j = await r.json();
+    const presets = (j.presets || []).filter(function(p) { return p.supports_video_gen === true; });
+    window._videoGenPresetsCache = presets;
+    const cur = getSelectedVideoGenModel();
+    sel.innerHTML = '';
+    if (!presets.length) {
+      sel.disabled = true;
+      const o = document.createElement('option');
+      o.value = '';
+      o.textContent = '未配置视频生成模型';
+      sel.appendChild(o);
+      return;
+    }
+    sel.disabled = false;
+    const ph = document.createElement('option');
+    ph.value = '';
+    ph.textContent = '— 视频生成 —';
+    sel.appendChild(ph);
+    presets.forEach(function(p) {
+      const o = document.createElement('option');
+      o.value = p.id || '';
+      const modelLabel = (p.model_label || p.model || p.id || '').trim();
+      o.textContent = (p.name || modelLabel) + ' · ' + modelLabel + ' (视频生成)';
+      sel.appendChild(o);
+    });
+    if (cur && presets.some(function(p) { return p.id === cur; })) {
+      sel.value = cur;
+    } else if (presets.length === 1) {
+      sel.value = presets[0].id;
+      setSelectedVideoGenModel(presets[0].id);
+    }
+  } catch (_) {}
+}
+
+(function bindVideoGenModelSelect() {
+  const sel = document.getElementById('videoGenModelSelect');
+  if (!sel) return;
+  sel.addEventListener('change', function() {
+    setSelectedVideoGenModel(sel.value);
+  });
+})();
+
+if (typeof refreshMusicModelSelect === 'function') {
+  const _origRefreshMusicForVideo = refreshMusicModelSelect;
+  refreshMusicModelSelect = async function() {
+    await _origRefreshMusicForVideo();
+    await refreshVideoGenModelSelect();
+  };
+} else if (typeof refreshAudioModelSelect === 'function') {
+  const _origRefreshAudioForVideo = refreshAudioModelSelect;
+  refreshAudioModelSelect = async function() {
+    await _origRefreshAudioForVideo();
+    await refreshVideoGenModelSelect();
+  };
+}
+
+refreshVideoGenModelSelect().catch(function() {});

codeagent/web/static/01k-model-stack-bootstrap.js

@@ -0,0 +1,66 @@
+/* ================================================================
+ * 01k-model-stack-bootstrap.js
+ *   Boot-time wiring for the per-session model stack.
+ *   Listens to the existing 'session-changed' CustomEvent
+ *   dispatched by 01c-session.js and:
+ *     1) migrates any legacy global keys (F7) on first session
+ *     2) restores backend overrides into session storage
+ *     3) refreshes the 6 selectors so the dropdown values match
+ * ================================================================ */
+
+(function bootstrapModelStack() {
+  if (!window.ModelStackState) return;  // 01k-state.js must load first
+
+  const MS = window.ModelStackState;
+  const SLOTS = MS.SLOTS;
+
+  // Re-apply all 6 selectors' current values from ModelStackState.
+  function applyEffectiveToSelectors() {
+    if (typeof refreshModelSelect === 'function')           refreshModelSelect();
+    if (typeof refreshVisionModelSelect === 'function')     refreshVisionModelSelect();
+    if (typeof refreshImageGenModelSelect === 'function')  refreshImageGenModelSelect();
+    if (typeof refreshAudioModelSelect === 'function')     refreshAudioModelSelect();
+    if (typeof refreshMusicModelSelect === 'function')     refreshMusicModelSelect();
+    if (typeof refreshVideoGenModelSelect === 'function')  refreshVideoGenModelSelect();
+  }
+
+  async function onSessionChanged(sid) {
+    try {
+      // F7: one-shot migration of legacy global keys → bind to current session
+      MS.migrateLegacyOnce();
+      // Restore any backend-persisted overrides for this session
+      await MS.restoreFromBackend(sid);
+      // Apply the effective (session → global → empty) values to dropdowns
+      applyEffectiveToSelectors();
+      // Refresh the pill/badge so 📌 shows up
+      if (typeof updateComposeModelPill === 'function') {
+        updateComposeModelPill();
+      } else if (typeof updateComposeModelStackPill === 'function') {
+        updateComposeModelStackPill();
+      }
+    } catch (e) {
+      try { console.warn('[model-stack] onSessionChanged failed', e); } catch (_) {}
+    }
+  }
+
+  // Listen for session changes (01c-session.js dispatches this).
+  window.addEventListener('session-changed', function(ev) {
+    const sid = ev && ev.detail && ev.detail.sessionId;
+    if (sid) onSessionChanged(sid);
+  });
+
+  // Also handle initial load (event already fired before this listener attached)
+  document.addEventListener('DOMContentLoaded', function() {
+    // Defer one tick so sessionId is assigned
+    setTimeout(function() {
+      const sid = MS.getModelStackScope();
+      if (sid) onSessionChanged(sid);
+    }, 0);
+  });
+
+  // Expose for manual triggers (e.g. after "clear all overrides")
+  window.refreshModelStackUi = function() {
+    applyEffectiveToSelectors();
+    if (typeof updateComposeModelPill === 'function') updateComposeModelPill();
+  };
+})();

codeagent/web/static/01k-model-stack-state.js

@@ -0,0 +1,209 @@
+/* ================================================================
+ * 01k-model-stack-state.js
+ *   Per-session + global-default model selection state.
+ *
+ *   Three-level precedence (highest → lowest):
+ *     1. session override  — oa_ms_over::session::<sid>::<slot>
+ *     2. global default    — oa_ms_global::<slot>
+ *     3. system default    — empty string (handled by server)
+ *
+ *   Also keeps the legacy keys in sync for one-shot migration (F7).
+ * ================================================================ */
+
+(function initModelStackState() {
+  // Slot definitions: the 6 model types. Order is fixed.
+  const SLOTS = ['llm', 'vision', 'image_gen', 'audio', 'music', 'video_gen'];
+
+  // Legacy single-key names (pre per-session). Read on init to seed
+  // session override once, then ignored.
+  const LEGACY_KEYS = {
+    llm:        'oa_llm_preset_id',
+    vision:     'oa_vision_preset_id',
+    image_gen:  'oa_image_gen_preset_id',
+    audio:      'oa_audio_preset_id',
+    music:      'oa_music_preset_id',
+    video_gen:  'oa_video_gen_preset_id',
+  };
+
+  function safeGet(k) {
+    try { return localStorage.getItem(k) || ''; } catch (_) { return ''; }
+  }
+  function safeSet(k, v) {
+    try { localStorage.setItem(k, String(v == null ? '' : v).trim()); } catch (_) {}
+  }
+  function safeDel(k) {
+    try { localStorage.removeItem(k); } catch (_) {}
+  }
+
+  // ---- Current session scope (driven by 01c-session.js) ----
+  function getModelStackScope() {
+    // sessionId is a `let` in 01c-session.js. Reading `typeof sessionId` in
+    // TDZ would throw, so wrap in try. After TDZ, `typeof` returns 'undefined'
+    // cleanly. We fall back to window.sessionId (which bootstrap module may set).
+    try {
+      if (typeof sessionId !== 'undefined' && sessionId) return String(sessionId);
+    } catch (_) {}
+    try {
+      if (window.sessionId) return String(window.sessionId);
+    } catch (_) {}
+    return '';
+  }
+
+  // ---- Session-level override ----
+  function sessionKey(sid, slot) {
+    return 'oa_ms_over::session::' + (sid || 'default') + '::' + slot;
+  }
+  function getSessionOverride(slot, sid) {
+    if (!SLOTS.includes(slot)) return '';
+    return safeGet(sessionKey(sid || getModelStackScope(), slot));
+  }
+  function setSessionOverride(slot, val, sid) {
+    if (!SLOTS.includes(slot)) return;
+    safeSet(sessionKey(sid || getModelStackScope(), slot), val);
+  }
+  function clearSessionOverride(slot, sid) {
+    if (!SLOTS.includes(slot)) return;
+    safeDel(sessionKey(sid || getModelStackScope(), slot));
+  }
+  function clearAllSessionOverrides(sid) {
+    const k = sid || getModelStackScope();
+    SLOTS.forEach(function(s) { safeDel(sessionKey(k, s)); });
+  }
+  function listSessionOverrideSlots(sid) {
+    const k = sid || getModelStackScope();
+    return SLOTS.filter(function(s) { return !!safeGet(sessionKey(k, s)); });
+  }
+
+  // ---- Global default ----
+  function getGlobalDefault(slot) {
+    if (!SLOTS.includes(slot)) return '';
+    return safeGet('oa_ms_global::' + slot);
+  }
+  function setGlobalDefault(slot, val) {
+    if (!SLOTS.includes(slot)) return;
+    safeSet('oa_ms_global::' + slot, val);
+  }
+  function getAllGlobalDefaults() {
+    const out = {};
+    SLOTS.forEach(function(s) { out[s] = getGlobalDefault(s); });
+    return out;
+  }
+  function setAllGlobalDefaults(obj) {
+    SLOTS.forEach(function(s) {
+      if (obj && Object.prototype.hasOwnProperty.call(obj, s)) {
+        setGlobalDefault(s, obj[s]);
+      }
+    });
+  }
+
+  // ---- Three-level precedence resolver ----
+  function getEffectiveModel(slot, sid) {
+    if (!SLOTS.includes(slot)) return '';
+    const s = sid || getModelStackScope();
+    const a = getSessionOverride(slot, s);
+    if (a) return a;
+    const b = getGlobalDefault(slot);
+    if (b) return b;
+    return '';
+  }
+  function getEffectiveModelStack(sid) {
+    const out = {};
+    SLOTS.forEach(function(s) { out[s] = getEffectiveModel(s, sid); });
+    return out;
+  }
+
+  // ---- One-shot migration from legacy global keys ----
+  // Binds legacy localStorage values to the currently active session,
+  // then clears them. Idempotent (uses a guard flag).
+  function migrateLegacyOnce() {
+    const flag = 'oa_ms_legacy_migrated_v1';
+    if (safeGet(flag)) return false;
+    const sid = getModelStackScope();
+    if (!sid) return false; // No session yet — wait until one is active.
+    let migrated = 0;
+    SLOTS.forEach(function(s) {
+      const legacy = safeGet(LEGACY_KEYS[s]);
+      if (legacy) {
+        if (!getSessionOverride(s, sid)) {
+          setSessionOverride(s, legacy, sid);
+          migrated++;
+        }
+        safeDel(LEGACY_KEYS[s]);
+      }
+    });
+    safeSet(flag, '1');
+    if (migrated > 0) {
+      try { console.info('[model-stack] migrated', migrated, 'legacy keys to session', sid); } catch (_) {}
+    }
+    return true;
+  }
+
+  // ---- Persist overrides to backend (best-effort, debounced) ----
+  let _persistTimer = null;
+  function schedulePersistToBackend() {
+    if (_persistTimer) clearTimeout(_persistTimer);
+    _persistTimer = setTimeout(persistToBackendNow, 500);
+  }
+  async function persistToBackendNow() {
+    _persistTimer = null;
+    const sid = getModelStackScope();
+    if (!sid) return;
+    const aid = (typeof agentId !== 'undefined' && agentId) ? agentId : 'default';
+    const overrides = {};
+    SLOTS.forEach(function(s) {
+      const v = getSessionOverride(s, sid);
+      if (v) overrides[s] = v;
+    });
+    try {
+      await fetch('/api/ui/session/model-stack', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ session_id: sid, agent_id: aid, overrides: overrides }),
+      });
+    } catch (_) {}
+  }
+
+  // ---- Restore overrides from backend on session switch ----
+  async function restoreFromBackend(sid, aid) {
+    const s = sid || getModelStackScope();
+    if (!s) return;
+    const a = aid || (typeof agentId !== 'undefined' ? agentId : 'default') || 'default';
+    try {
+      const r = await fetch('/api/ui/session/model-stack?session_id=' + encodeURIComponent(s) + '&agent_id=' + encodeURIComponent(a));
+      if (!r.ok) return;
+      const j = await r.json();
+      const ov = (j && j.overrides) || {};
+      // Clear existing session overrides for this sid, then apply backend ones.
+      clearAllSessionOverrides(s);
+      SLOTS.forEach(function(slot) {
+        // Backend keys are llm_id, vision_llm_id, etc. → slot = strip _id
+        const k = slot + '_id';
+        if (typeof ov[k] === 'string' && ov[k]) {
+          setSessionOverride(slot, ov[k], s);
+        }
+      });
+    } catch (_) {}
+  }
+
+  // ---- Expose ----
+  window.ModelStackState = {
+    SLOTS: SLOTS,
+    LEGACY_KEYS: LEGACY_KEYS,
+    getModelStackScope: getModelStackScope,
+    getSessionOverride: getSessionOverride,
+    setSessionOverride: setSessionOverride,
+    clearSessionOverride: clearSessionOverride,
+    clearAllSessionOverrides: clearAllSessionOverrides,
+    listSessionOverrideSlots: listSessionOverrideSlots,
+    getGlobalDefault: getGlobalDefault,
+    setGlobalDefault: setGlobalDefault,
+    getAllGlobalDefaults: getAllGlobalDefaults,
+    setAllGlobalDefaults: setAllGlobalDefaults,
+    getEffectiveModel: getEffectiveModel,
+    getEffectiveModelStack: getEffectiveModelStack,
+    migrateLegacyOnce: migrateLegacyOnce,
+    schedulePersistToBackend: schedulePersistToBackend,
+    persistToBackendNow: persistToBackendNow,
+    restoreFromBackend: restoreFromBackend,
+  };
+})();