@7n/tauri-components 0.7.0 → 0.9.0

package/src/docs/index.md

@@ -0,0 +1,54 @@
+---
+docgen:
+  source: npm/src/index.js
+  crc: 4c3b4830
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# index.js
+
+## Огляд
+
+Модуль керує життєвим циклом агента, охоплюючи етапи ініціалізації, виконання та завершення роботи. Він відповідає за налаштування конфігурації, реєстрацію обробників запитів та інструментів. Модуль ініціалізує сесії та забезпечує взаємодію агента з зовнішніми системами, такими як MCP та Omlx, використовуючи лише дані, які є read-only.
+
+## Поведінка
+
+1. Налаштовує конфігурацію агента.
+2. Припиняє активну сесію агента.
+3. Створює нову сесію агента.
+4. Реєструє обробник запитів на дозвіл агента.
+5. Реєструє обробник виклику інструменту агента.
+6. Відповідає на запит агента про дозвіл.
+7. Відповідає на виклик інструменту агента.
+8. Виконує один хід агента.
+9. Ініціює міст між агентом та MCP.
+10. Створює набір інструментів агента.
+11. Створює набір інструментів агента.
+12. Обробляє схвалення агента.
+13. Обробляє загальний запит агента.
+14. Обробляє відповідь агента.
+15. Створює диспетчер.
+16. Валідує вхідні дані.
+17. Створює конфігурацію чату з OpenAI.
+18. Запускає роботу агента.
+19. Перелічує моделі Omlx.
+20. Вирішує модель Omlx.
+21. Визначає базовий URL Omlx.
+22. Перевіряє, чи є URL Omlx прямим.
+23. Вирішує базовий URL Omlx з кешуванням.
+24. Перелічує доступні інструменти.
+25. Генерує схему JSON для інструменту.
+26. Отримує маніфест інструмента.
+27. Класифікує елементи.
+28. Визначає рівні акторів за замовчуванням.
+29. Створює обмежений маніфест.
+30. Отримує імена інструментів з обмеженням.
+31. Отримує конкретний інструмент.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Кешує результати в межах одного прогону.

package/src/index.js

@@ -3,6 +3,18 @@
 // consumers (CLI orchestrators, MCP wrappers); the Vue/Quasar layers live under
 // the ./vue and ./components subpaths.
 
+export {
+  acpConfig,
+  cancelAcpSession,
+  createAcpSession,
+  onAcpPermissionRequest,
+  onAcpToolCall,
+  respondAcpPermission,
+  respondAcpToolCall,
+  runAcpTurn,
+  startAcpMcpBridge,
+} from './core/acp-agent.js'
+export { createAcpAgentKit } from './core/acp-kit.js'
 export { createAgentKit } from './core/agent-kit.js'
 export { handleApprove, handleRequest, handleRespond } from './core/agent-handler.js'
 export { createDispatch, validateInput } from './core/dispatch.js'

package/src/testing/docs/index.md

@@ -0,0 +1,24 @@
+---
+docgen:
+  source: npm/src/testing/index.js
+  crc: 64006a18
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.96
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# index.js
+
+## Огляд
+
+Цей файл надає механізм для монтування компонентів Quasar. Він забезпечує можливість монтування компонентів Quasar у стандартному режимі та з додатковими конфігураціями, необхідними для проведення тестів.
+
+## Поведінка
+
+1. Дозволяє монтувати компоненти Quasar для тестування.
+2. Дозволяє монтувати компоненти Quasar з додатковими налаштуваннями для тестування.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/testing/docs/quasar.md

@@ -0,0 +1,28 @@
+---
+docgen:
+  source: npm/src/testing/quasar.js
+  crc: 154223d8
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# quasar.js
+
+## Огляд
+
+Модуль надає механізми для ініціалізації компонентів Vue у застосунок. Доступні два способи: пряме монтування компонента з використанням компонентів Quasar через `mountQuasar`, або монтування компонента, який автоматично інкапсулюється у стандартну структуру макету Quasar за допомогою `mountWithQuasar`. Модуль не виконує операцій запису у файлову систему чи базу даних.
+
+## Поведінка
+
+mountQuasar монтує компонент Vue з зареєстрованими компонентами Quasar, не обгортаючи його у макет.
+mountWithQuasar монтує компонент Vue, обгорнувши його у структуру QLayout > QPageContainer.
+
+## Публічний API
+
+mountQuasar — Монтує компонент з зареєстрованим Quasar без обгортки макета.
+mountWithQuasar — Монтує компонент рівня сторінки, обгорнутий у QLayout > QPageContainer.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/vue/docs/index.md

@@ -0,0 +1,28 @@
+---
+docgen:
+  source: npm/src/vue/index.js
+  crc: ac7a549c
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# index.js
+
+## Огляд
+
+Цей файл є центральною точкою взаємодії системи. Він забезпечує механізми для комунікації з агентом ACP, загальним агентом та протоколом OMLX. Він створює сховище журналу, використовуючи механізми Tauri, та надає об'єкт для транспортування даних.
+
+## Поведінка
+
+1. Надає хук для взаємодії з агентом ACP.
+2. Надає хук для взаємодії з агентом.
+3. Надає хук для роботи з протоколом OMLX.
+4. Надає хук для роботи з оновленнями.
+5. Створює сховище журналу, що використовує механізми Tauri.
+6. Надає об'єкт для транспортування даних.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/vue/docs/journal-store-tauri.md

@@ -0,0 +1,27 @@
+---
+docgen:
+  source: npm/src/vue/journal-store-tauri.js
+  crc: 6356740d
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.99
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# journal-store-tauri.js
+
+## Огляд
+
+Цей модуль керує доступом до механізму журналу. Він дозволяє створювати сховище журналу та отримувати повний список існуючих записів.
+
+## Поведінка
+
+1. Викликати `createTauriJournalStore` для ініціалізації сховища журналу, яке маршрутизує операції з файловою системою через команди `tauri-plugin-agent`.
+2. Використовувати отримане сховище для створення нового запису журналу, викликаючи команду `plugin:agent|journal_create`.
+3. Використовувати отримане сховище для завантаження запису журналу за його ідентифікатором, викликаючи команду `plugin:agent|journal_load`.
+4. Використовувати отримане сховище для оновлення запису журналу за його ідентифікатором, застосовуючи патч, викликаючи команду `plugin:agent|journal_update`.
+5. Використовувати отримане сховище для отримання списку всіх записів журналу, викликаючи команду `plugin:agent|journal_list`.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/vue/docs/transports.md

@@ -0,0 +1,25 @@
+---
+docgen:
+  source: npm/src/vue/transports.js
+  crc: cbde1782
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# transports.js
+
+## Огляд
+
+Модуль ініціює виклики зовнішніх інструментів через Tauri. Він передає визначені команди та необхідні їм аргументи, а потім повертає отриманий результат виконання.
+
+## Поведінка
+
+1. Викликає команду Tauri, використовуючи визначення інструменту.
+2. Передає вхідні дані інструменту як аргументи відповідній команді.
+3. Повертає результат виконання команди.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/vue/docs/use-acp-agent.md

@@ -0,0 +1,29 @@
+---
+docgen:
+  source: npm/src/vue/use-acp-agent.js
+  crc: 227f9b8b
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.97
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# use-acp-agent.js
+
+## Огляд
+
+Модуль ініціалізує шлюз агента та налаштовує доменне мостове з'єднання MCP, якщо каталог доступний. Він звертається до мережі для відправки запитів до агента. Публічна функція `useAcpAgent` використовується для передачі намірів агенту, що дозволяє оновлювати рівень моделі. Після цього модуль надає відповідь та схвалює запит. Цей модуль є Read-only і не виконує записів у файлову систему чи бази даних.
+
+## Поведінка
+
+1. Викликати `useAcpAgent` для ініціалізації шлюзу агента в додатку.
+2. Викликати `loadEnv` для зчитування за замовчуванням агента на машині та запуску доменного мостового з'єднання MCP, якщо каталог доступний.
+3. Викликати `request` для надсилання запиту з наміром.
+4. При виклику `request`, якщо в опціях вказано `modelTier`, оновити поточний рівень моделі.
+5. Викликати `request` для надсилання запиту з наміром, використовуючи поточний рівень моделі за замовчуванням, якщо він не був перевизначений.
+6. Викликати `respond` для надання відповіді на запит, використовуючи ідентифікатор запиту та повідомлення.
+7. Викликати `approve` для схвалення запиту, використовуючи ідентифікатор запиту та стан схвалення.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/src/vue/docs/use-agent.md

@@ -0,0 +1,29 @@
+---
+docgen:
+  source: npm/src/vue/use-agent.js
+  crc: 84427f61
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# use-agent.js
+
+## Огляд
+
+Модуль ініціалізує шлюз агента, надаючи йому інструменти, системний промпт та конфігурацію. Він дозволяє ініціювати запити до агента через `useAgent`, отримувати відповіді, затверджувати дії та переглядати доступні моделі. Звернення до мережі здійснюється через цей модуль.
+
+## Поведінка
+
+1. Викликати `useAgent` для ініціалізації шлюзу агента.
+2. Надати `useAgent` каталог інструментів, системний промпт, опціональне заземлення, рівні акторів, ідентичність актора, конфігурацію omlx та транспорт для інструментів.
+3. Отримати з `useAgent` посилання на базовий URL, модель, ключ API та функції для роботи з omlx.
+4. Отримати з `useAgent` посилання на журнал.
+5. Викликати `request` з отриманого шлюзу, передаючи намір та ідентичність актора, щоб ініціювати запит агента.
+6. Викликати `respond` з отриманого шлюзу, передаючи ідентифікатор запиту та повідомлення, щоб надати відповідь агенту.
+7. Викликати `approve` з отриманого шлюзу, передаючи ідентифікатор запиту та результат схвалення, щоб затвердити дію агента.
+8. Викликати `listModels` з отриманого шлюзу, щоб отримати список доступних моделей omlx.
+
+## Гарантії поведінки
+
+- (специфічних машинно-виведених гарантій немає)

package/src/vue/docs/use-omlx.md

@@ -0,0 +1,30 @@
+---
+docgen:
+  source: npm/src/vue/use-omlx.js
+  crc: d1e34b0a
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# use-omlx.js
+
+## Огляд
+
+Модуль відповідає за ініціалізацію та кешування конфігурації для взаємодії з OMLX. Він завантажує налаштування з `settings.json` та середовища виконання, використовуючи http://127.0.0.1:8000/v1 як резервний URL. Публічна функція useOmlx звертається до мережі, виконує кешування у межах прогону. При виникненні помилок вона перехоплює їх (fail-safe), не кидаючи винятків назовні, а повертаючи порожнє значення замість винятку.
+
+## Поведінка
+
+1. Ініціалізує конфігурацію OMLX, використовуючи значення з локального сховища. Якщо значення відсутнє, використовує наданий за замовчуванням URL, який може бути `http://127.0.0.1:8000/v1`.
+2. Завантажує глобальні налаштування OMLX з середовища виконання через Rust.
+3. Якщо завантаження успішне, застосовує API ключ до внутрішнього стану.
+4. Якщо локальне сховище відсутнє, застосовує URL та модель з глобальних налаштувань.
+5. Якщо URL відповідає локальному замовленню, виконується перенаправлення через проксі myllm, що є тимчасовим перевизначенням.
+6. Зберігає поточні значення URL та моделі у локальне сховище.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
+- Кешує результати в межах одного прогону.

package/src/vue/docs/use-updater.md

@@ -0,0 +1,31 @@
+---
+docgen:
+  source: npm/src/vue/use-updater.js
+  crc: c988fd96
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.95
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+# use-updater.js
+
+## Огляд
+
+Модуль забезпечує перевірку наявності новіших версій застосунку та ініціює процес оновлення. Публічна функція `useUpdater` виконує цю логіку, забезпечуючи перехоплення помилок (fail-safe) та запобігаючи виняткам назовні. Логіка роботи залежить від конфігураційних файлів: tauri.conf.json та default.json.
+
+## Поведінка
+
+1. При виклику `useUpdater` у середовищі розробки (dev builds) функціонал оновлення не виконується.
+2. При монтуванні компонента, через `FIRST_CHECK_DELAY_MS` часу, викликається перевірка на наявність оновлення.
+3. Після першої перевірки, функція `useUpdater` запускає періодичну перевірку на наявність оновлення кожні `CHECK_INTERVAL_MS` часу.
+4. При виклику перевірки на оновлення, якщо виявлено доступну новішу версію, відображається діалогове вікно з пропозицією встановити оновлення.
+5. Якщо користувач підтверджує встановлення, запускається процес завантаження та встановлення оновлення. Під час завантаження відображається прогрес.
+6. Після успішного встановлення оновлення, відображається діалогове вікно з пропозицією негайного перезапуску.
+7. Якщо користувач підтверджує перезапуск, виконується перезапуск застосунку.
+8. У разі будь-якої помилки під час перевірки або встановлення, користувач не отримує винятків, а замість цього відображається відповідне повідомлення або логується помилка.
+9. При демонтуванні компонента, періодичні таймери перериваються.
+
+## Гарантії поведінки
+
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).

package/src/vue/index.js

@@ -3,7 +3,9 @@
 // Requires the host app to provide vue + @tauri-apps/* (peer deps) and the
 // tauri-plugin-agent backend commands.
 
+export { useAcpAgent } from './use-acp-agent.js'
 export { useAgent } from './use-agent.js'
 export { useOmlx } from './use-omlx.js'
+export { useUpdater } from './use-updater.js'
 export { createTauriJournalStore } from './journal-store-tauri.js'
 export { tauriTransport } from './transports.js'

package/src/vue/use-acp-agent.js

@@ -0,0 +1,109 @@
+import { computed, ref } from 'vue'
+import { acpConfig, startAcpMcpBridge } from '../core/acp-agent.js'
+import { createAcpAgentKit } from '../core/acp-kit.js'
+import { createTauriJournalStore } from './journal-store-tauri.js'
+import { tauriTransport } from './transports.js'
+
+// In-app ACP agent gateway — the ACP-flavored sibling of `useAgent()` (which
+// stays on the old omlx/runAgent path). Binds an app's catalog to
+// createAcpAgentKit and resolves two independent defaults per SPEC/plan:
+//
+// - which AGENT (codex/claude/cursor/pi) — per-machine, from `ACP_DEFAULT_AGENT`
+//   (via `acp_config()`), since different developers have different CLIs
+//   installed; the human can still override `agentKind.value` in the UI.
+// - which MODEL — the app-owned MIN/AVG/MAX abstraction: each entry in
+//   `agents[kind].tiers` is a concrete preset (e.g. `codex.tiers.MAX` = the
+//   "ChatGPT 5.6 Sol" args/env). A caller can request a tier per call
+//   (`request(intent, { modelTier: 'MAX' })`); otherwise `defaultTier` applies.
+//
+// The domain MCP bridge is started once (`loadEnv()`) and its URL is reused
+// for every spawned session, mirroring how `useOmlx().loadEnv()` resolves the
+// omlx base URL once and reuses it.
+
+const DEFAULT_TIER = 'AVG'
+
+/**
+ * @param {object} config gateway config
+ * @param {object[]} config.catalog app tool catalog (required — passed to the domain MCP bridge)
+ * @param {Record<string, {command: string, args?: string[], env?: Record<string,string>, tiers: Record<string, {label: string, args?: string[], env?: Record<string,string>}>}>} config.agents per-agent-kind spawn presets, keyed by 'codex'|'claude'|'cursor'|'pi'
+ * @param {string} [config.defaultTier] fallback modelTier when a request doesn't specify one (default 'AVG')
+ * @param {string} config.cwd session working directory (absolute path)
+ * @param {Record<string, number>} [config.actorTiers] max executable tier rank per actor kind
+ * @param {(tool: object, input: object) => unknown} [config.transport] tool transport (default Tauri invoke)
+ * @returns {object} in-app ACP agent gateway
+ */
+export function useAcpAgent({ catalog, agents = {}, defaultTier = DEFAULT_TIER, cwd, actorTiers, transport = tauriTransport } = {}) {
+  const defaultAgentKind = ref(null)
+  const agentKind = ref(null)
+  const modelTier = ref(defaultTier)
+  const mcpBridgeUrl = ref(null)
+  const journal = createTauriJournalStore()
+  const kit = createAcpAgentKit({ catalog, journal, transport, actorTiers })
+
+  /**
+   * Read the per-machine default agent (`ACP_DEFAULT_AGENT`) and start the
+   * domain MCP bridge. Call once before the first `request()` — mirrors
+   * `useOmlx().loadEnv()`. No-op-safe outside Tauri (tests / web): falls back
+   * to the first configured agent and leaves the MCP bridge unset.
+   * @returns {Promise<void>} resolves once defaults are resolved
+   */
+  async function loadEnv() {
+    const configuredKinds = Object.keys(agents)
+    try {
+      const cfg = await acpConfig()
+      defaultAgentKind.value = cfg.defaultAgentKind && agents[cfg.defaultAgentKind] ? cfg.defaultAgentKind : (configuredKinds[0] ?? null)
+    }
+    catch {
+      defaultAgentKind.value = configuredKinds[0] ?? null
+    }
+    if (!agentKind.value) agentKind.value = defaultAgentKind.value
+
+    if (catalog?.length) {
+      try {
+        mcpBridgeUrl.value = await startAcpMcpBridge(catalog)
+      }
+      catch {
+        mcpBridgeUrl.value = null
+      }
+    }
+  }
+
+  /**
+   * Build `createAcpSession` args for the currently selected agent + tier.
+   * @returns {object} spawn args
+   */
+  function resolveSpawnArgs() {
+    const preset = agents[agentKind.value]
+    if (!preset) throw new Error(`useAcpAgent: no preset configured for agent "${agentKind.value}"`)
+    const tier = preset.tiers?.[modelTier.value]
+    return {
+      agentKind: agentKind.value,
+      command: preset.command,
+      args: [...(preset.args ?? []), ...(tier?.args ?? [])],
+      env: { ...preset.env, ...tier?.env },
+      cwd,
+      mcpBridgeUrl: mcpBridgeUrl.value ?? undefined,
+    }
+  }
+
+  return {
+    agentKind,
+    modelTier,
+    defaultAgentKind,
+    availableAgentKinds: computed(() => Object.keys(agents)),
+    availableTiers: computed(() => Object.entries(agents[agentKind.value]?.tiers ?? {}).map(([id, t]) => ({ id, label: t.label ?? id }))),
+    loadEnv,
+    journal,
+    /**
+     * @param {string} intent user prompt
+     * @param {{modelTier?: string}} [opts] per-call overrides
+     * @returns {Promise<object>} structured result envelope
+     */
+    request: (intent, opts = {}) => {
+      if (opts.modelTier) modelTier.value = opts.modelTier
+      return kit.request({ intent, agent: resolveSpawnArgs() })
+    },
+    respond: (requestId, message) => kit.respond({ requestId, message }),
+    approve: (requestId, approve) => kit.approve({ requestId, approve }),
+  }
+}

package/src/vue/use-updater.js

@@ -0,0 +1,116 @@
+import { onMounted, onUnmounted } from 'vue'
+import { relaunch } from '@tauri-apps/plugin-process'
+import { check } from '@tauri-apps/plugin-updater'
+import { useQuasar } from 'quasar'
+
+// Checks for an app update on mount and hourly thereafter, prompting via a
+// Quasar dialog; after install, offers an immediate relaunch. Requires the
+// host app's tauri.conf.json to configure plugins.updater (pubkey + endpoint)
+// and capabilities/default.json to grant "updater:default" — without the
+// capability, check() fails with a silent permission-denied that only surfaces
+// via console.error (no dialog, no visible error).
+//
+// No-op in dev builds: tauri.conf.json's version is the CI-injected release
+// version, not what's running locally, so the updater would always think dev
+// code is stale.
+
+const FIRST_CHECK_DELAY_MS = 3000
+const CHECK_INTERVAL_MS = 60 * 60 * 1000
+
+/**
+ * @returns {void}
+ */
+export function useUpdater() {
+  if (import.meta.env.DEV) return
+
+  const $q = useQuasar()
+  let timer = null
+  // A dialog is showing or an install already ran — don't stack background checks.
+  let busy = false
+
+  /**
+   * Asks the configured update endpoint for a newer version and, if found,
+   * walks the user through the install flow.
+   * @returns {Promise<void>}
+   */
+  async function checkForUpdates() {
+    if (busy) return
+    try {
+      const update = await check()
+      if (!update) return
+
+      busy = true
+      $q.dialog({
+        title: 'Доступне оновлення',
+        message: `Версія ${update.version} готова. Встановити зараз?`,
+        cancel: { label: 'Пізніше', flat: true },
+        ok: { label: 'Встановити', color: 'primary' },
+        persistent: true,
+      })
+        .onOk(() => installAndRelaunch(update))
+        .onCancel(() => {
+          busy = false
+        })
+    }
+    catch (error) {
+      // No network, or the updater isn't configured/permitted — don't bother
+      // the user, but leave a trace for diagnosis.
+      console.error('[updater] check failed:', error)
+    }
+  }
+
+  /**
+   * Downloads and installs the update with progress, then offers a relaunch.
+   * @param {import('@tauri-apps/plugin-updater').Update} update the update found by check()
+   * @returns {Promise<void>}
+   */
+  async function installAndRelaunch(update) {
+    let downloaded = 0
+    let total = 0
+    const dismiss = $q.notify({ group: false, timeout: 0, spinner: true, message: 'Завантаження оновлення…' })
+    try {
+      await update.downloadAndInstall(event => {
+        switch (event.event) {
+          case 'Started': {
+            total = event.data.contentLength ?? 0
+            break
+          }
+          case 'Progress': {
+            downloaded += event.data.chunkLength
+            if (total) dismiss({ message: `Завантаження… ${Math.round((downloaded / total) * 100)}%` })
+            break
+          }
+          case 'Finished': {
+            dismiss()
+            break
+          }
+          // No default
+        }
+      })
+      // busy stays true: the update is already on disk, a repeat check would
+      // only offer to install the same thing again.
+      $q.dialog({
+        title: 'Оновлення встановлено',
+        message: `Перезапустити зараз, щоб перейти на версію ${update.version}?`,
+        cancel: { label: 'Пізніше', flat: true },
+        ok: { label: 'Перезапустити', color: 'primary' },
+        persistent: true,
+      }).onOk(() => relaunch())
+    }
+    catch (error) {
+      dismiss()
+      busy = false
+      console.error('[updater] install failed:', error)
+      $q.notify({ message: `Помилка оновлення: ${error}`, color: 'negative', timeout: 5000 })
+    }
+  }
+
+  onMounted(() => {
+    setTimeout(checkForUpdates, FIRST_CHECK_DELAY_MS)
+    timer = setInterval(checkForUpdates, CHECK_INTERVAL_MS)
+  })
+
+  onUnmounted(() => {
+    if (timer) clearInterval(timer)
+  })
+}