@oar-sh/oar 0.9.22 → 0.9.24

package/server/public/app/settings-modal.js

@@ -37,8 +37,16 @@ import {
   updateSubagentRecordRetentionSetting as requestSubagentRecordRetentionSetting,
   loadFeatureFlagSettings,
   updateFeatureFlagSetting as requestFeatureFlagSetting,
+  loadModelRefreshSettings,
+  updateModelRefreshSettings as requestModelRefreshSettings,
   requestRelayRestart,
 } from './api-client.js';
+import {
+  formatModelRefreshIntervalLabel,
+  formatModelRefreshLastChecked,
+  nextModelRefreshExcluded,
+  normalizeModelRefreshSettings,
+} from './model-refresh-ui.mjs';
 import { DEFAULT_BACKGROUND_TASK_TIMEOUT_MINUTES } from './background-task-timeout-options.mjs';
 import {
   DEFAULT_CLAUDE_BACKGROUND_COMMAND_LIMIT_MINUTES,
@@ -77,6 +85,7 @@ export {
 } from './claude-api-settings-ui.js';
 import { openClaudeCloudSettingsSection } from './claude-cloud-settings-ui.js';
 import { refreshCliInstallSections } from './cli-install-ui.js';
+import { refreshAgentSdkRows } from './agent-sdk-ui.js';
 import { refreshUpdateSection } from './update-ui.js';
 import { refreshRemoteRelaysSection } from './remote-relays-settings.js';
 import { refreshAgentSessionsSection } from './agent-sessions-settings-ui.js';
@@ -399,6 +408,161 @@ export async function updateSubagentRecordRetentionSetting(value) {
   }
 }
 
+// "Check for new models" (Settings › General › Models): a relay setting, on
+// every 24 h by default, with one checkbox per enabled provider to leave it
+// out (server/services/model-refresh-scheduler.mjs). Starts at the relay's
+// defaults until its answer loads.
+let modelRefreshSettings = normalizeModelRefreshSettings(null);
+let modelRefreshUpdateInFlight = false;
+// The provider list waits for the relay's answer: "Loading…" until one
+// arrived, the reason while the last read failed.
+let modelRefreshProvidersLoaded = false;
+let modelRefreshLoadError = '';
+
+function syncModelRefreshIntervalOptions(select) {
+  const { intervalChoices, intervalHours } = modelRefreshSettings;
+  // A stored value outside today's choices still shows as itself.
+  const choices = intervalChoices.includes(intervalHours)
+    ? intervalChoices
+    : [...intervalChoices, intervalHours].sort((a, b) => a - b);
+  const current = Array.from(select.options).map((option) => option.value).join(',');
+  if (current === choices.join(',')) return;
+  select.replaceChildren(...choices.map((hours) => {
+    const option = document.createElement('option');
+    option.value = String(hours);
+    option.textContent = formatModelRefreshIntervalLabel(hours);
+    return option;
+  }));
+}
+
+function renderModelRefreshProviderRows(list) {
+  const excluded = new Set(modelRefreshSettings.excluded);
+  const disabled = modelRefreshUpdateInFlight || !modelRefreshSettings.auto;
+  const now = Date.now();
+  const status = (text, className) => {
+    const line = document.createElement('div');
+    line.className = className;
+    line.textContent = text;
+    return line;
+  };
+  let statusLine = null;
+  if (modelRefreshLoadError) {
+    statusLine = status(`Could not load the providers: ${modelRefreshLoadError}`, 'settings-help model-refresh-providers-error');
+  } else if (!modelRefreshProvidersLoaded) {
+    statusLine = status('Loading…', 'settings-help model-refresh-providers-loading');
+  } else if (!modelRefreshSettings.providers.length) {
+    statusLine = status('No provider is switched on.', 'settings-help');
+  }
+  // After a failed read, the providers of an earlier answer stay below it.
+  const providers = modelRefreshProvidersLoaded ? modelRefreshSettings.providers : [];
+  list.replaceChildren(...(statusLine ? [statusLine] : []), ...providers.map((provider) => {
+    const inputId = `model-refresh-provider-${provider.id.toLowerCase().replace(/[^a-z0-9-]/g, '-')}`;
+    const row = document.createElement('div');
+    row.className = 'settings-row model-refresh-provider-row';
+    const label = document.createElement('label');
+    label.htmlFor = inputId;
+    const name = document.createElement('span');
+    name.textContent = `Check ${provider.label}`;
+    const last = document.createElement('span');
+    last.className = 'model-refresh-provider-last';
+    // An enabled provider without its key or CLI is not checked until it is.
+    last.textContent = provider.setUp ? formatModelRefreshLastChecked(provider.last, now) : 'Not set up';
+    label.append(name, last);
+    const input = document.createElement('input');
+    input.id = inputId;
+    input.type = 'checkbox';
+    input.dataset.modelRefreshProvider = provider.id;
+    input.setAttribute('aria-label', `Check ${provider.label} for new models`);
+    input.checked = !excluded.has(provider.id);
+    input.disabled = disabled;
+    input.addEventListener('change', () => {
+      void updateModelRefreshProviderSetting(provider.id, input.checked);
+    });
+    row.append(label, input);
+    return row;
+  }));
+}
+
+function syncModelRefreshSection() {
+  const toggle = document.getElementById('model-refresh-auto-toggle');
+  if (toggle instanceof HTMLInputElement) {
+    toggle.checked = modelRefreshSettings.auto;
+    toggle.disabled = modelRefreshUpdateInFlight;
+  }
+  const select = document.getElementById('model-refresh-interval-select');
+  if (select && select.tagName === 'SELECT') {
+    syncModelRefreshIntervalOptions(select);
+    select.value = String(modelRefreshSettings.intervalHours);
+    // Nothing to time while the check is off.
+    select.disabled = modelRefreshUpdateInFlight || !modelRefreshSettings.auto;
+  }
+  const list = document.getElementById('model-refresh-providers');
+  if (list) renderModelRefreshProviderRows(list);
+}
+
+export async function refreshModelRefreshSettings() {
+  // A new read: "Loading…" again until it answers, or the earlier list.
+  modelRefreshLoadError = '';
+  syncModelRefreshSection();
+  try {
+    const result = await loadModelRefreshSettings();
+    if (!result || typeof result !== 'object') throw new Error('The relay did not answer.');
+    modelRefreshSettings = normalizeModelRefreshSettings(result);
+    modelRefreshProvidersLoaded = true;
+    modelRefreshLoadError = '';
+  } catch (error) {
+    // Keep the last known value; the setting is not critical.
+    modelRefreshLoadError = String(error?.message || '').trim() || 'The relay did not answer.';
+  } finally {
+    syncModelRefreshSection();
+  }
+}
+
+async function saveModelRefreshSettings(patch, describe) {
+  if (modelRefreshUpdateInFlight) {
+    syncModelRefreshSection();
+    return;
+  }
+  modelRefreshUpdateInFlight = true;
+  syncModelRefreshSection();
+  try {
+    const result = await requestModelRefreshSettings(patch);
+    if (!result) throw new Error('Failed to update the check for new models.');
+    modelRefreshSettings = normalizeModelRefreshSettings(result);
+    modelRefreshProvidersLoaded = true;
+    modelRefreshLoadError = '';
+    showTransientRelayNotice(describe(modelRefreshSettings));
+  } catch (error) {
+    alert(error?.message || 'Failed to update the check for new models.');
+  } finally {
+    modelRefreshUpdateInFlight = false;
+    syncModelRefreshSection();
+  }
+}
+
+export function updateModelRefreshAutoSetting(checked) {
+  return saveModelRefreshSettings({ auto: checked === true }, (settings) => (settings.auto
+    ? `The relay checks for new models ${formatModelRefreshIntervalLabel(settings.intervalHours).toLowerCase()}.`
+    : 'The relay no longer checks for new models by itself.'));
+}
+
+export function updateModelRefreshIntervalSetting(value) {
+  return saveModelRefreshSettings({ intervalHours: Math.round(Number(value)) }, (settings) => (
+    `The relay checks for new models ${formatModelRefreshIntervalLabel(settings.intervalHours).toLowerCase()}.`
+  ));
+}
+
+export function updateModelRefreshProviderSetting(providerId, checked) {
+  const id = String(providerId || '').trim();
+  const label = modelRefreshSettings.providers.find((provider) => provider.id === id)?.label || id;
+  return saveModelRefreshSettings(
+    { excluded: nextModelRefreshExcluded(modelRefreshSettings.excluded, id, checked === true) },
+    (settings) => (settings.excluded.includes(id)
+      ? `${label} is no longer checked for new models.`
+      : `${label} is checked for new models.`),
+  );
+}
+
 export async function updateBackgroundTaskTimeoutSetting(value) {
   if (backgroundTaskTimeoutUpdateInFlight) {
     syncBackgroundTaskTimeoutSlider();
@@ -1966,6 +2130,8 @@ export function openSettingsModal(tab, providerTab) {
   // in the meantime should show up the moment the panel opens. Sockets keep it
   // current from here on.
   void refreshCliInstallSections({ force: true });
+  // The agent SDK rows: a read of the store's state, nothing spawned.
+  void refreshAgentSdkRows();
   grokSettingsInputsDirty = false;
   ensureGrokSettingsInputTracking();
   void syncGrokSettingsInputs();
@@ -1989,6 +2155,7 @@ export function openSettingsModal(tab, providerTab) {
   void refreshRestartResumeSetting();
   syncSubagentRecordRetentionSelect();
   void refreshSubagentRecordRetentionSetting();
+  void refreshModelRefreshSettings();
   void refreshRelayRestartMaxWaitSetting();
   void refreshPushSettingsSection();
   void refreshPreviewsSection();

package/server/public/app/socket-handlers.js

@@ -31,7 +31,9 @@ import {
   refreshSummaryModal,
   summaryModalState,
   IS_SHARED_VIEW,
+  showTransientRelayNotice,
 } from './store.js';
+import { newModelsToastFor } from './model-refresh-ui.mjs';
 import { scheduleContextUsageRefresh } from './api-client.js';
 import { capFinishedActivityEntries, capLiveActivityEntries, normalizeTurnSeq } from './activity-replay-state.mjs';
 import { liveActivityCap } from './live-activity-cap.mjs';
@@ -66,6 +68,7 @@ import { applyClaudeCloudSettingsState, refreshClaudeCloudSettingsState } from '
 import { applyClaudeCloudSessionEvent } from './claude-cloud-conversation-ui.js';
 import { updateProviderReadinessInputs } from './provider-readiness.mjs';
 import { applyCliInstallState } from './cli-install-ui.js';
+import { applyAgentSdkState } from './agent-sdk-ui.js';
 import { renderUpdateSection } from './update-ui.js';
 import { applyHostSuspendState, applyRelayShutdownState } from './host-suspend-ui.js';
 import { applyClaudeUsageLimit, applyConversationBilling, applyUsageLimitPause } from './usage-limit-ui.js';
@@ -150,6 +153,7 @@ let deps = null;
  * @property {(force?: boolean) => (void | Promise<void>)} refreshModelCatalog
  * @property {(payload?: object) => void} updateModelCatalogState
  * @property {() => (void | Promise<void>)} reconcileOpenModelVariantModal
+ * @property {(tab?: string) => (void | Promise<void>)} [openSelectModelsModal]
  * @property {(payload?: object) => void} applyConversationWorkspaceRootUpdate
  * @property {(conversationId: string, title: string, updatedAt?: string | number | null) => void} applyConversationTitleUpdate
  * @property {() => void} syncChatTitleControls
@@ -414,6 +418,18 @@ export async function connectSocket(overrideDeps) {
   socket.on('models_updated', (payload) => {
     updateModelCatalogState(payload || {});
     void reconcileOpenModelVariantModal();
+    // A refresh that found models never seen before: one toast per event, on
+    // the clients connected now (the others get the menu dot and the tags).
+    const toast = newModelsToastFor(payload, { sharedView: IS_SHARED_VIEW });
+    if (toast) {
+      const { tab } = toast;
+      showTransientRelayNotice(toast.text, 10000, {
+        actionLabel: 'Show',
+        onAction: () => {
+          void Promise.resolve(deps?.openSelectModelsModal?.(tab)).catch(() => {});
+        },
+      });
+    }
   });
   // Each settings event also feeds provider readiness (provider-readiness.mjs),
   // so a Settings save changes the empty screen without a reload.
@@ -457,6 +473,11 @@ export async function connectSocket(overrideDeps) {
   socket.on('cli_install_state', (payload) => {
     applyCliInstallState(payload || null);
   });
+  // Agent SDK installs, the same whole-buffer contract. It also feeds
+  // provider readiness (agent-sdk-ui.js passes the snapshot on).
+  socket.on('agent_sdk_state', (payload) => {
+    applyAgentSdkState(payload || null);
+  });
   // Self-update transitions AND npm log chunks; same whole-buffer contract as
   // cli_install_state, so a client connecting mid-update renders the full log.
   socket.on('update_state', (payload) => {

package/server/public/index.html

@@ -1673,6 +1673,15 @@
     background: transparent;
     border-color: transparent;
   }
+  /* Select Models: new models found that the modal has not shown yet. */
+  .chat-menu-new-dot {
+    width: calc(8px * var(--ui-scale));
+    height: calc(8px * var(--ui-scale));
+    border-radius: 50%;
+    background: var(--accent);
+    flex-shrink: 0;
+  }
+  .chat-menu-new-dot[hidden] { display: none; }
   .chat-actions-menu-meta {
     display: inline-flex;
     align-items: center;
@@ -1954,6 +1963,17 @@
   .settings-auth-row { gap: calc(5px * var(--ui-scale)); align-items: center; width: 100%; margin-top: calc(4px * var(--ui-scale)); }
   .settings-auth-row-wrap { flex-wrap: wrap; row-gap: calc(4px * var(--ui-scale)); }
   .settings-radio-stack { display: flex; flex-direction: column; gap: calc(4px * var(--ui-scale)); }
+  /* Models: one "Check <provider>" row per provider, its last check under
+     the name in the help text's colour. */
+  #settings-modal .settings-row.model-refresh-provider-row:has(> input[type="checkbox"]) > label {
+    flex-direction: column; align-items: flex-start; justify-content: center;
+  }
+  .model-refresh-provider-last {
+    color: var(--muted);
+    font-size: var(--fs-meta-sm);
+    font-weight: normal;
+    overflow-wrap: anywhere;
+  }
   /* These rows are laid out as flex and hidden from script via `.hidden = true`.
      Their `display: flex` lives HERE rather than in a style="" attribute on
      purpose: an inline declaration outranks every selector-based rule (short of
@@ -5933,6 +5953,42 @@
     border-color: var(--warn, #f7c873);
     color: var(--warn, #f7c873);
   }
+  .model-reasoning-chip-new {
+    border-color: var(--accent);
+    color: var(--accent);
+  }
+  /* "Turn new models on automatically" at the top of a provider tab. */
+  .model-auto-enable-row {
+    display: flex;
+    align-items: center;
+    gap: calc(5px * var(--ui-scale));
+    padding: calc(4px * var(--ui-scale)) calc(7px * var(--ui-scale));
+    border: 1px solid var(--border);
+    border-radius: calc(10px * var(--ui-scale));
+    background: var(--bg3);
+    font-size: 0.84rem;
+    min-height: calc(30px * var(--ui-scale));
+    cursor: pointer;
+  }
+  .model-auto-enable-toggle {
+    width: calc(18px * var(--ui-scale));
+    height: calc(18px * var(--ui-scale));
+    flex-shrink: 0;
+    accent-color: var(--accent);
+  }
+  .model-auto-enable-copy {
+    display: flex;
+    flex-direction: column;
+    gap: calc(2px * var(--ui-scale));
+    min-width: 0;
+  }
+  .model-auto-enable-title {
+    font-weight: 600;
+  }
+  .model-auto-enable-help {
+    color: var(--muted);
+    font-size: 0.78rem;
+  }
   .model-variant-list {
     display: flex;
     flex-direction: column;
@@ -7907,7 +7963,8 @@
       min-height: calc(32px * var(--ui-scale));
       padding: calc(5px * var(--ui-scale)) calc(4px * var(--ui-scale));
     }
-    .model-variant-checkbox {
+    .model-variant-checkbox,
+    .model-auto-enable-toggle {
       width: calc(22px * var(--ui-scale));
       height: calc(22px * var(--ui-scale));
     }
@@ -8226,7 +8283,7 @@
             <button id="chat-menu-group" class="chat-actions-menu-item" type="button" role="menuitem">🧩 Session group…</button>
             <button id="chat-menu-refresh-history" class="chat-actions-menu-item" type="button" role="menuitem" hidden disabled aria-hidden="true" tabindex="-1" style="display:none">🔄️ Refresh history</button>
             <button id="chat-menu-inspect-tmux" class="chat-actions-menu-item" type="button" role="menuitem">🖥️ Inspect tmux console</button>
-            <button id="chat-menu-select-models" class="chat-actions-menu-item" type="button" role="menuitem">🤗 Select Models</button>
+            <button id="chat-menu-select-models" class="chat-actions-menu-item" type="button" role="menuitem">🤗 Select Models<span id="chat-menu-select-models-dot" class="chat-menu-new-dot" aria-hidden="true" hidden></span></button>
             <button id="chat-menu-change-cwd" class="chat-actions-menu-item" type="button" role="menuitem">🗂️ Change CWD</button>
             <button id="chat-menu-git-changes" class="chat-actions-menu-item" type="button" role="menuitem">🌿 Git changes</button>
             <button id="chat-menu-open-cloud-session" class="chat-actions-menu-item" type="button" role="menuitem" hidden>☁️ Open on claude.ai</button>
@@ -8663,6 +8720,31 @@
           </div>
           <div class="settings-help settings-gap-xs">A sub-agent's record keeps every tool call's full input and the first 4 KB of each result. After this many days the relay removes them from finished agents, once a day; the thoughts, the reply, notes and the one-line summary of each call stay. Always keeps everything. A setting of this relay.</div>
         </section>
+        <section class="settings-section" id="settings-section-models" aria-labelledby="settings-section-models-title">
+          <h3 class="settings-section-title" id="settings-section-models-title">Models</h3>
+          <div class="settings-row settings-gap">
+            <label for="model-refresh-auto-toggle">Check for new models</label>
+            <input
+              id="model-refresh-auto-toggle"
+              type="checkbox"
+              onchange="updateModelRefreshAutoSetting(this.checked)"
+              aria-label="Check for new models"
+              checked
+            >
+          </div>
+          <div class="settings-row settings-gap">
+            <label for="model-refresh-interval-select">How often</label>
+            <select id="model-refresh-interval-select" onchange="updateModelRefreshIntervalSetting(this.value)" aria-label="How often to check for new models">
+              <option value="6">Every 6 h</option>
+              <option value="12">Every 12 h</option>
+              <option value="24" selected>Every 24 h</option>
+              <option value="72">Every 3 days</option>
+              <option value="168">Every 7 days</option>
+            </select>
+          </div>
+          <div id="model-refresh-providers" class="settings-gap" role="group" aria-label="Providers checked for new models"></div>
+          <div class="settings-help settings-gap-xs">The relay asks each switched-on provider for its model list this often. A provider whose list was refreshed in the meantime (Refresh in Select Models, a settings save, a sign-in) waits a full interval again, and a failed check is tried again after an hour at the earliest. Whether a new model starts on is set per provider in Select Models. A setting of this relay.</div>
+        </section>
         <section class="settings-section" id="settings-section-relay" aria-labelledby="settings-section-relay-title">
           <h3 class="settings-section-title" id="settings-section-relay-title">This relay</h3>
           <div class="settings-row settings-row-column settings-gap">
@@ -8734,6 +8816,9 @@
               <code id="windows-autostart-manual-command" style="display: block; margin-top: calc(4px * var(--ui-scale)); user-select: all;"></code>
             </div>
           </div>
+          <!-- The Windows helper (koffi) the relay's lock check reads process start
+               times with; agent-sdk-ui.js draws the row, on a Windows relay only. -->
+          <div id="agent-sdk-koffi-row" class="settings-gap" data-agent-sdk="koffi" hidden></div>
         </section>
         <section class="settings-section" id="settings-section-updates" aria-labelledby="settings-section-updates-title">
           <h3 class="settings-section-title" id="settings-section-updates-title">Updates</h3>
@@ -8980,6 +9065,8 @@
               <pre id="cli-claude-log"></pre>
             </details>
           </div>
+          <!-- Agent SDK row; agent-sdk-ui.js draws it. -->
+          <div id="agent-sdk-claude-row" data-agent-sdk="claude" style="margin-bottom: calc(6px * var(--ui-scale));"></div>
           <!-- Claude account auth UI (Relogin / Logout); claude-auth-ui.js drives the state. -->
           <div id="claude-auth-section">
             <div class="settings-row" style="margin-bottom: 0;">
@@ -9069,6 +9156,8 @@
           data-settings-provider-panel="claude-api"
           hidden
         >
+          <!-- Claude API chats run on the Claude Agent SDK; agent-sdk-ui.js draws the row. -->
+          <div id="agent-sdk-claude-api-row" data-agent-sdk="claude"></div>
           <div class="settings-row settings-row-column settings-gap">
             <label for="claude-api-key-input">Claude API</label>
             <div class="settings-row settings-row-full settings-row-lead">
@@ -9274,6 +9363,8 @@
           data-settings-provider-panel="cursor"
           hidden
         >
+          <!-- Agent SDK row; agent-sdk-ui.js draws it. -->
+          <div id="agent-sdk-cursor-row" data-agent-sdk="cursor"></div>
           <div class="settings-row settings-row-column settings-gap">
             <label for="cursor-api-key-input">Cursor SDK</label>
             <div class="settings-row settings-row-full settings-row-lead">
@@ -9367,6 +9458,8 @@
           data-settings-provider-panel="deepseek"
           hidden
         >
+          <!-- DeepSeek chats run on the Claude Agent SDK; agent-sdk-ui.js draws the row. -->
+          <div id="agent-sdk-deepseek-row" data-agent-sdk="claude"></div>
           <div class="settings-row settings-row-column settings-gap">
             <label for="deepseek-api-key-input">DeepSeek</label>
             <div class="settings-row settings-row-full settings-row-lead">

package/server/routes/agent-sdk-routes.mjs

@@ -0,0 +1,73 @@
+'use strict';
+
+// The agent SDKs the relay installs on demand (agent-sdk-store.mjs): their
+// status, and Install / Reinstall / Cancel from Settings. A request body only
+// ever carries an SDK id, looked up through the store's frozen table; an
+// unknown id is a 400 before anything runs. The store itself refuses a spawn
+// while COPILOT_WEB_RELAY_DISABLE_CLI_SPAWN is set (503), and that answer is
+// passed through as it is.
+
+const UNKNOWN_SDK_ERROR = 'Unknown agent SDK';
+
+export function registerAgentSdkRoutes(app, { auth, io = null, agentSdkStore = null } = {}) {
+  const store = agentSdkStore;
+
+  // Every transition and log flush (four a second at most, the store
+  // coalesces them) goes to every client, as cli_install_state does.
+  if (store && io && typeof store.subscribe === 'function') {
+    store.subscribe((snapshot) => {
+      io.emit('agent_sdk_state', snapshot);
+    });
+  }
+
+  const unavailable = (res) => res.status(503).json({ error: 'Agent SDKs are unavailable on this relay' });
+
+  // A string the store knows, or null. Only a string: String(['claude'])
+  // would otherwise read as a valid id.
+  const knownId = (raw) => (typeof raw === 'string' && store.status(raw) ? raw : null);
+
+  app.get('/api/agent-sdks/status', auth, (_req, res) => {
+    if (!store) return unavailable(res);
+    return res.json(store.snapshot());
+  });
+
+  app.post('/api/agent-sdks/install', auth, (req, res) => {
+    if (!store) return unavailable(res);
+    const sdk = knownId(req.body?.sdk);
+    if (!sdk) return res.status(400).json({ error: UNKNOWN_SDK_ERROR, ...store.snapshot() });
+    let result;
+    try {
+      result = store.install(sdk, { force: req.body?.reinstall === true });
+    } catch (error) {
+      return res.status(500).json({ error: `The install could not start: ${String(error?.message || error)}`, ...store.snapshot() });
+    }
+    if (!result?.ok) {
+      return res.status(Number(result?.statusCode) || 400).json({
+        error: result?.error || 'Failed to start the agent SDK install',
+        ...store.snapshot(),
+      });
+    }
+    // The rows ride along so the caller renders without a second round trip;
+    // the install itself finishes over the socket.
+    return res.json({
+      ok: true,
+      reused: result.reused === true,
+      ready: result.ready === true,
+      ...store.snapshot(),
+    });
+  });
+
+  app.post('/api/agent-sdks/install/cancel', auth, (req, res) => {
+    if (!store) return unavailable(res);
+    const sdk = knownId(req.body?.sdk);
+    if (!sdk) return res.status(400).json({ error: UNKNOWN_SDK_ERROR, ...store.snapshot() });
+    const result = store.cancel(sdk);
+    if (!result?.ok) {
+      return res.status(Number(result?.statusCode) || 400).json({
+        error: result?.error || 'Failed to cancel the agent SDK install',
+        ...store.snapshot(),
+      });
+    }
+    return res.json({ ok: true, ...store.snapshot() });
+  });
+}