@7n/tauri-components 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -0,0 +1,81 @@
+# Changelog
+
+## [0.10.1] - 2026-07-16
+
+### Changed
+
+- chore(lint): дозаповнено cspell-словник, авто-fix markdownlint у docs/
+
+## [0.10.0] - 2026-07-16
+
+### Added
+
+- core/acp-agent-presets.js — CODEX_ACP_AGENT_PRESET: спільний для всіх застосунків-споживачів пресет запуску codex через ACP (npx @agentclientprotocol/codex-acp — гола назва "codex-acp" не опублікована), MIN/AVG/MAX тіри за схемою назв релізів codex (gpt-5.6-luna/terra/sol) через CODEX_CONFIG. Експортовано з npm/src/index.js.
+
+## [0.9.0] - 2026-07-15
+
+### Added
+
+- core/acp-agent.js — ACP-сесії (spawn/prompt/cancel), стрім session/update у форму runAgent(), перший крок міграції з прямих omlx-викликів на Agent Client Protocol
+- core/acp-kit.js — ACP-версія createAgentKit: класифікація/dispatch домен-каталогу через MCP tools/call (acp://mcp-tool-call), дзеркалення нативних ACP permission-request у той самий pendingApproval-контракт, що і approve()/AuditDialog вже розуміють. Одна активна сесія за раз.
+- vue/use-acp-agent.js — Vue-composабл useAcpAgent(): резолвинг дефолтного агента через ACP_DEFAULT_AGENT (per-машина), MIN/AVG/MAX модель-тіри на пресет (per-агент), запуск domain MCP-моста при loadEnv(). Паралельний до useAgent(), старий шлях не чіпали.
+
+## [0.8.0] - 2026-07-05
+
+### Added
+
+- useUpdater() у @7n/tauri-components/vue — спільна перевірка/встановлення оновлень через tauri-plugin-updater з Quasar-діалогом, винесена з mlmail/myshare/myllm/task (усі чотири мали ідентичну копію).
+
+## [0.7.0] - 2026-07-02
+
+### Added
+
+- Фолбек на myllm-проксі: loadEnv() у useOmlx пробує `:8088/health` (timeout 400ms, кеш 12с) і, коли проксі живий, веде трафік через нього замість прямого `:8000` — runtime-only override, localStorage і кастомні baseUrl не чіпаються. Нові core-експорти: resolveOmlxBaseUrl / resolveOmlxBaseUrlCached / isDirectOmlxUrl / DIRECT_OMLX_BASE_URL / PROXY_OMLX_BASE_URL.
+
+## [0.6.0] - 2026-06-22
+
+### Changed
+
+- Додано пропс promptHint до AgentDialog.vue
+
+## [0.5.0] - 2026-06-19
+
+### Added
+
+- testing subpath (mountQuasar/mountWithQuasar vitest helpers); omlx model listing (listOmlxModels/resolveModel) + a model dropdown in AgentDialog populated from the server
+
+## [0.4.1] - 2026-06-19
+
+### Fixed
+
+- useOmlx no longer crashes when localStorage is unavailable (component tests / SSR) — guarded reads/writes
+
+## [0.4.0] - 2026-06-19
+
+### Added
+
+- createDispatch preserves a backend error.kind on the io envelope; useAgent accepts a transport override (route some tools to JS/OPFS handlers)
+
+## [0.3.0] - 2026-06-16
+
+### Changed
+
+- Винесено логіку відображення статусу в StatePill компонент
+
+## [0.2.0] - 2026-06-16
+
+### Changed
+
+- journal/omlx commands now invoked as plugin:agent|* — apps must register tauri-plugin-agent and grant agent:default
+
+## [0.1.1] - 2026-06-16
+
+### Fixed
+
+- npm provenance: add repository metadata so publish passes sigstore validation
+
+## [0.1.0] - 2026-06-16
+
+### Added
+
+- LLM agent engine (createAgentKit, scoped tool surface) + Vue/Quasar UI (AgentDialog, AuditDialog) for Tauri apps

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/tauri-components",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "type": "module",
   "description": "Shared LLM agent engine + Vue/Quasar UI for Tauri apps (chat, journal, trust-tier approval).",
   "license": "MIT",
@@ -25,6 +25,7 @@
   "files": [
     "src",
     "types",
+    "CHANGELOG.md",
     "!**/*.test.*",
     "!**/*.spec.*",
     "!**/__tests__/**",

package/src/components/AgentDialog.vue

@@ -17,6 +17,7 @@
       <q-select
         v-model="model"
         :options="models"
+        @filter="(_, update) => update()"
         :loading="modelsLoading"
         use-input
         fill-input
@@ -27,7 +28,6 @@
         outlined
         label="model"
         hint="завантажені моделі omlx; можна вписати свою"
-        @filter="(_, update) => update()"
       />
       <q-input v-model="apiKey" dense outlined label="API key" type="password" />
       <q-separator class="q-my-sm" />

package/src/components/docs/AgentDialog.md

@@ -10,6 +10,7 @@ docgen:
 Компонент відображає діалогове вікно для взаємодії з локальною мовною моделлю (LLM) через агент. Він дозволяє користувачеві вводити запити, налаштовувати конфігурацію агента та бачити історію чату.
 
 ## Поведінка
+
 1. **При відкритті діалогу (`onShow`):**
     * Очищається поле введення та історія чату.
     * Ініціалізується конфігурація агента, завантажуючи налаштування з глобальних даних.
@@ -29,6 +30,7 @@ docgen:
     * Якщо операція була успішною, компонент може повідомити зовнішній контекст про завершення роботи агента.
 
 ## Гарантії поведінки
+
 * Діалогове вікно відображає історію чату у порядку чергування: повідомлення користувача, а потім відповідь агента.
 * Під час обробки запиту (відправлення або отримання відповіді) інтерфейс блокується, і відображається індикатор "думає...".
 * При відсутності введення або активній обробці запиту, кнопка відправки вимкнена.

package/src/components/docs/AuditDialog.md

@@ -10,6 +10,7 @@ docgen:
 Компонент відображає журнал аудиту, наданий зовнішнім агентом. Він дозволяє переглядати записи, розширювати їх для детального огляду та взаємодіяти з ними (наприклад, відповідати або затверджувати).
 
 ## Поведінка
+
 1. При ініціалізації компонента, якщо не вказано інше, журнал аудиту не завантажується.
 2. При натисканні кнопки "Оновити" у заголовку, компонент ініціює завантаження списку записів журналу.
 3. Під час завантаження, відображається індикатор завантаження.
@@ -22,6 +23,7 @@ docgen:
 10. При зміні властивості `modelValue` зовнішнім компонентом, компонент оновлює свій стан відображення.
 
 ## Гарантії поведінки
+
 * Компонент завжди відображає актуальний стан журналу після успішного виклику `refresh`.
 * Під час виконання операцій (відповідь, затвердження) компонент блокує взаємодію з відповідним записом, щоб уникнути подвійних викликів.
 * У разі помилки при завантаженні або взаємодії з агентом, користувачеві відображається сповіщення.

package/src/components/docs/BaseDialog.md

@@ -10,6 +10,7 @@ docgen:
 Компонент надає універсальну структуру для діалогових вікон у застосунку. Він інкапсулює типовий макет діалогу, включаючи заголовок, тіло та кнопки дій.
 
 ## Поведінка
+
 1. Відображає діалогове вікно, кероване станом `modelValue`.
 2. Відображає заголовок, що складається з іконки (за наявності), назви (`title`) та кнопки закриття.
 3. Дозволяє вставити контент у тіло діалогу через основний слот.
@@ -17,6 +18,7 @@ docgen:
 5. При зміні стану `modelValue` зовнішнім компонентом, компонент емітує подію `update:modelValue` з новим значенням.
 
 ## Гарантії поведінки
+
 * Діалогове вікно завжди має визначену назву (`title`).
 * Ширина діалогового вікна за замовчуванням становить 520 пікселів, але може бути перевизначена.
 * Компонент коректно передає всі додаткові атрибути, отримані від батьківського елемента, до базового елемента діалогу.

package/src/components/docs/DialogActions.md

@@ -10,6 +10,7 @@ docgen:
 Компонент надає стандартний нижній колонтитул для діалогових вікон, що містить кнопку скасування та основну кнопку дії. Він забезпечує канонічний патерн "скасувати + відправити" для діалогів.
 
 ## Поведінка
+
 1. Відображає кнопку "Скасувати", яка закриває діалогове вікно при натисканні.
 2. Відображає основну кнопку дії, яка виконує наступне:
     * При натисканні викликає подію `submit`.
@@ -19,6 +20,7 @@ docgen:
     * Може відображати іконку, визначену властивістю `icon`.
 
 ## Гарантії поведінки
+
 * Кнопка "Скасувати" завжди присутня і закриває діалог.
 * Основна кнопка дії завжди присутня і вимагає надання мітки.
 * Компонент коректно реагує на стани `disable` та `loading` для керування поведінкою кнопки дії.

package/src/components/docs/RequestView.md

@@ -10,6 +10,7 @@ docgen:
 Компонент відображає детальний вигляд результату виконання запиту. Він візуалізує статус, резюме, помилки та список виконаних дій.
 
 ## Поведінка
+
 1. Відображає статус результату за допомогою компонента `StatePill`.
 2. Якщо у результаті є резюме, відображає його як текстовий блок.
 3. Якщо у результаті є питання, відображає його як текстовий блок.
@@ -19,6 +20,7 @@ docgen:
 7. Для кожної дії відображає назву інструменту та його вхідні дані.
 
 ## Гарантії поведінки
+
 * Компонент завжди відображає статус результату, оскільки властивість `result` є обов'язковою.
 * Текстові блоки (резюме, питання, помилка) відображаються лише за наявності відповідного поля у `result`.
 * Список дій відображається лише за наявності елементів у масиві `actions` у `result`.

package/src/components/docs/StatePill.md

@@ -10,11 +10,13 @@ docgen:
 Компонент відображає візуальний маркер стану (pill). Він використовується для індикації статусу в різних частинах застосунку.
 
 ## Поведінка
+
 1. Компонент отримує текстовий статус.
 2. Компонент визначає відповідний колір на основі отриманого статусу.
 3. Компонент відображає текстовий статус.
 4. Компонент відображає візуальний маркер (крапку) кольору, визначеного для цього статусу.
 
 ## Гарантії поведінки
+
 * Відображення завжди містить текстовий статус.
 * Колір візуального маркера та фону компонента коректно відображається відповідно до наданого статусу.

package/src/core/acp-agent-presets.js

@@ -0,0 +1,25 @@
+// Canonical `agents.<kind>` entries for useAcpAgent()/createAcpAgentKit()
+// consumers — codex's MIN/AVG/MAX tiers follow this org's internal
+// release-name scheme (gpt-5.6-luna/terra/sol), defined once here so
+// consuming apps don't each redefine the same CODEX_CONFIG env per tier.
+// Spawn command verified against the real published adapter package (the
+// bare "codex-acp" name is not itself published) — see
+// https://www.npmjs.com/package/@agentclientprotocol/codex-acp.
+
+/**
+ * @param {string} model codex model id (e.g. 'gpt-5.6-terra')
+ * @returns {{CODEX_CONFIG: string}} env var merged into the codex-acp session config
+ */
+function codexModelEnv(model) {
+  return { CODEX_CONFIG: JSON.stringify({ model }) }
+}
+
+export const CODEX_ACP_AGENT_PRESET = {
+  command: 'npx',
+  args: ['-y', '@agentclientprotocol/codex-acp'],
+  tiers: {
+    MIN: { label: 'GPT-5.6 Luna', env: codexModelEnv('gpt-5.6-luna') },
+    AVG: { label: 'GPT-5.6 Terra', env: codexModelEnv('gpt-5.6-terra') },
+    MAX: { label: 'GPT-5.6 Sol', env: codexModelEnv('gpt-5.6-sol') },
+  },
+}

package/src/core/docs/acp-agent-presets.md

@@ -0,0 +1,23 @@
+---
+docgen:
+  source: npm/src/core/acp-agent-presets.js
+  crc: dc79fc55
+---
+
+# acp-agent-presets.js
+
+## Огляд
+
+Модуль надає готовий, спільний для всіх застосунків-споживачів пресет запуску codex-агента через ACP (`CODEX_ACP_AGENT_PRESET`) — для `useAcpAgent()`/`createAcpAgentKit()`, щоб кожен застосунок не визначав команду спавну й тіри моделі codex окремо. Read-only, лише статичні дані — жодних мережевих викликів чи запису.
+
+## Поведінка
+
+`CODEX_ACP_AGENT_PRESET` задає команду спавну справжнього опублікованого адаптера `@agentclientprotocol/codex-acp` (не існуючої як пакет голої назви `codex-acp`) через `npx`, і три тіри моделі — `MIN`/`AVG`/`MAX` — за внутрішньою схемою назв релізів codex (`gpt-5.6-luna`/`gpt-5.6-terra`/`gpt-5.6-sol`). Кожен тір передає обрану модель через змінну середовища `CODEX_CONFIG` (JSON, що codex-acp зливає в конфіг сесії) — діє лише на одну спавнену сесію, нічого не зберігається постійно.
+
+## Публічний API
+
+CODEX_ACP_AGENT_PRESET — готовий об'єкт `{command, args, tiers}` для передачі в `useAcpAgent({agents: {codex: CODEX_ACP_AGENT_PRESET}})`.
+
+## Гарантії поведінки
+
+- Read-only: лише статичні дані, жодних операцій запису чи мережевих викликів.

package/src/core/docs/acp-agent.md

@@ -12,7 +12,7 @@ docgen:
 
 ## Огляд
 
-Модуль керує життєвим циклом сесій агента ACP. Він дозволяє ініціалізувати сесії за допомогою `createAcpSession`, виконувати ходи промпта через `runAcpTurn` та скасовувати сесії за допомогою `cancelAcpSession`. Модуль встановлює мережевий зв'язок через http://127.0.0.1:54321/ та ініціалізує MCP-міст за допомогою `startAcpMcpBridge`. Він реєструє інструменти та обробляє запити на виклики інструментів через `onAcpToolCall` та відповіді на них через `respondAcpToolCall`. Модуль також обробляє запити на дозволи через `onAcpPermissionRequest` та надає відповіді за допомогою `respondAcpPermission`. Модуль надає конфігурацію типу агента за допомогою `acpConfig`. Усі помилки перехоплюються (fail-safe), і винятки не викидаються назовні.
+Модуль керує життєвим циклом сесій агента ACP. Він дозволяє ініціалізувати сесії за допомогою `createAcpSession`, виконувати ходи промпта через `runAcpTurn` та скасовувати сесії за допомогою `cancelAcpSession`. Модуль встановлює мережевий зв'язок через <http://127.0.0.1:54321/> та ініціалізує MCP-міст за допомогою `startAcpMcpBridge`. Він реєструє інструменти та обробляє запити на виклики інструментів через `onAcpToolCall` та відповіді на них через `respondAcpToolCall`. Модуль також обробляє запити на дозволи через `onAcpPermissionRequest` та надає відповіді за допомогою `respondAcpPermission`. Модуль надає конфігурацію типу агента за допомогою `acpConfig`. Усі помилки перехоплюються (fail-safe), і винятки не викидаються назовні.
 
 ## Поведінка
 
@@ -23,7 +23,7 @@ onAcpToolCall підписується на події виклику інстр
 respondAcpToolCall вирішує очікуваний виклик інструменту, надаючи результат агенту.
 onAcpPermissionRequest підписується на запити дозволу від агента, наприклад, на доступ до файлової системи.
 respondAcpPermission вирішує очікуваний запит дозволу, обираючи один із запропонованих варіантів.
-startAcpMcpBridge реєструє каталог інструментів цього застосунку в доменному MCP-міст та запускає його, повертаючи URL, наприклад, http://127.0.0.1:54321/.
+startAcpMcpBridge реєструє каталог інструментів цього застосунку в доменному MCP-міст та запускає його, повертаючи URL, наприклад, <http://127.0.0.1:54321/>.
 acpConfig зчитує за замовчуванням тип агента для машини.
 
 ## Публічний API
@@ -36,7 +36,7 @@ respondAcpToolCall — Надає відповідь на очікуваний
 onAcpPermissionRequest — Підписується на запит дозволу від агента (наприклад, на виконання команд або редагування файлів).
 respondAcpPermission — Приймає рішення щодо запиту дозволу, ініційованого агентом.
 startAcpMcpBridge — Реєструє каталог інструментів цього застосунку в доменному MCP-міст і запускає його.
-acpConfig — Зчитує за замовчуванням тип агента для цієї машини з змінної середовища. Доступні дані можна переглянути за адресою http://127.0.0.1:54321/.
+acpConfig — Зчитує за замовчуванням тип агента для цієї машини з змінної середовища. Доступні дані можна переглянути за адресою <http://127.0.0.1:54321/>.
 
 ## Гарантії поведінки
 

package/src/core/docs/llm.md

@@ -12,12 +12,12 @@ docgen:
 
 ## Огляд
 
-Модуль дозволяє ініціювати сеанс чату з мовною моделлю через мережевий ендпоінт http://127.0.0.1:10240/v1. Функціонал реалізується через публічні функції `runAgent` та `createOpenAiChat`. Код виконує виклик API та керує циклом виклику інструментів у контексті агента, доки модель не надасть фінальну відповідь або не буде перевищено ліміт кроків. Робота залежить від конфігурації, описаної у `response.json`.
+Модуль дозволяє ініціювати сеанс чату з мовною моделлю через мережевий ендпоінт <http://127.0.0.1:10240/v1>. Функціонал реалізується через публічні функції `runAgent` та `createOpenAiChat`. Код виконує виклик API та керує циклом виклику інструментів у контексті агента, доки модель не надасть фінальну відповідь або не буде перевищено ліміт кроків. Робота залежить від конфігурації, описаної у `response.json`.
 
 ## Поведінка
 
 runAgent виконує цикл виклику інструментів, поки модель не надасть відповідь без виклику інструменту, або доки не буде досягнуто максимальної кількості кроків.
-createOpenAiChat створює функцію, яка викликає мережевий ендпоінт OpenAI-сумісного API (наприклад, http://127.0.0.1:10240/v1) для отримання відповіді моделі.
+createOpenAiChat створює функцію, яка викликає мережевий ендпоінт OpenAI-сумісного API (наприклад, <http://127.0.0.1:10240/v1>) для отримання відповіді моделі.
 
 ## Публічний API
 

package/src/core/docs/resolve-omlx-base-url.md

@@ -12,23 +12,23 @@ docgen:
 
 ## Огляд
 
-Модуль визначає та надає базові URL для взаємодії з серверами omlx. Він експортує константи: DIRECT_OMLX_BASE_URL="http://127.0.0.1:8000/v1" для прямого доступу та PROXY_OMLX_BASE_URL="http://127.0.0.1:8088/v1" для проксі-доступу. Модуль звертається до мережі для визначення робочого URL, перевіряючи доступність проксі-сервера. Вибір URL кешується у межах прогону. При помилках мережевого доступу модуль перехоплює їх (fail-safe) і повертає порожнє значення замість кидання винятків. Модуль є лише для читання (не виконує операцій з ФС/БД).
+Модуль визначає та надає базові URL для взаємодії з серверами omlx. Він експортує константи: DIRECT_OMLX_BASE_URL="<http://127.0.0.1:8000/v1>" для прямого доступу та PROXY_OMLX_BASE_URL="<http://127.0.0.1:8088/v1>" для проксі-доступу. Модуль звертається до мережі для визначення робочого URL, перевіряючи доступність проксі-сервера. Вибір URL кешується у межах прогону. При помилках мережевого доступу модуль перехоплює їх (fail-safe) і повертає порожнє значення замість кидання винятків. Модуль є лише для читання (не виконує операцій з ФС/БД).
 
 ## Поведінка
 
-DIRECT_OMLX_BASE_URL: Надає базовий URL для прямого доступу до сервера omlx, який є http://127.0.0.1:8000/v1.
-PROXY_OMLX_BASE_URL: Надає базовий URL для доступу через проксі-сервер omlx, який є http://127.0.0.1:8088/v1.
-isDirectOmlxUrl: Перевіряє, чи вказаний URL є стандартним локальним сервером omlx (http://127.0.0.1:8000 або localhost:8000).
+DIRECT_OMLX_BASE_URL: Надає базовий URL для прямого доступу до сервера omlx, який є <http://127.0.0.1:8000/v1>.
+PROXY_OMLX_BASE_URL: Надає базовий URL для доступу через проксі-сервер omlx, який є <http://127.0.0.1:8088/v1>.
+isDirectOmlxUrl: Перевіряє, чи вказаний URL є стандартним локальним сервером omlx (<http://127.0.0.1:8000> або localhost:8000).
 resolveOmlxBaseUrl: Визначає ефективний базовий URL omlx, перевіряючи доступність проксі-сервера через зондування `/health`; у разі успіху повертає URL проксі, інакше — прямий URL.
 resolveOmlxBaseUrlCached: Визначає ефективний базовий URL omlx, використовуючи кешування для уникнення повторних зондувань протягом заданого часу життя (TTL).
 __resetOmlxBaseUrlCache: Очищає кеш результатів зондування базового URL omlx.
 
 ## Публічний API
 
-DIRECT_OMLX_BASE_URL — Базовий URL для прямого доступу до локального OMLX сервера, що вказує на http://127.0.0.1:8000/v1.
-PROXY_OMLX_BASE_URL — Базовий URL для проксі-доступу до OMLX сервера, що вказує на http://127.0.0.1:8088/v1.
+DIRECT_OMLX_BASE_URL — Базовий URL для прямого доступу до локального OMLX сервера, що вказує на <http://127.0.0.1:8000/v1>.
+PROXY_OMLX_BASE_URL — Базовий URL для проксі-доступу до OMLX сервера, що вказує на <http://127.0.0.1:8088/v1>.
 isDirectOmlxUrl — Визначає, чи є URL основним локальним сервером OMLX, який не повинен бути перенаправлений через проксі.
-resolveOmlxBaseUrl — Перевіряє доступність проксі-сервера шляхом виконання GET-запиту до http://127.0.0.1:8088/v1; якщо відповідь успішна, використовується проксі, інакше — прямий URL.
+resolveOmlxBaseUrl — Перевіряє доступність проксі-сервера шляхом виконання GET-запиту до <http://127.0.0.1:8088/v1>; якщо відповідь успішна, використовується проксі, інакше — прямий URL.
 resolveOmlxBaseUrlCached — Виконує перевірку доступності проксі-сервера з кешуванням, щоб уникнути повторних перевірок при кожному виклику LLM.
 __resetOmlxBaseUrlCache — Очищає всі збережені результати перевірки доступності базового URL OMLX.
 

package/src/docs/index.md

@@ -1,11 +1,7 @@
 ---
 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
+  crc: 60cbbdaf
 ---
 
 # index.js
@@ -47,6 +43,7 @@ docgen:
 29. Створює обмежений маніфест.
 30. Отримує імена інструментів з обмеженням.
 31. Отримує конкретний інструмент.
+32. Надає спільний пресет запуску codex-агента через ACP з тірами MIN/AVG/MAX.
 
 ## Гарантії поведінки
 

package/src/index.js

@@ -14,6 +14,7 @@ export {
   runAcpTurn,
   startAcpMcpBridge,
 } from './core/acp-agent.js'
+export { CODEX_ACP_AGENT_PRESET } from './core/acp-agent-presets.js'
 export { createAcpAgentKit } from './core/acp-kit.js'
 export { createAgentKit } from './core/agent-kit.js'
 export { handleApprove, handleRequest, handleRespond } from './core/agent-handler.js'

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

@@ -12,7 +12,7 @@ docgen:
 
 ## Огляд
 
-Модуль відповідає за ініціалізацію та кешування конфігурації для взаємодії з OMLX. Він завантажує налаштування з `settings.json` та середовища виконання, використовуючи http://127.0.0.1:8000/v1 як резервний URL. Публічна функція useOmlx звертається до мережі, виконує кешування у межах прогону. При виникненні помилок вона перехоплює їх (fail-safe), не кидаючи винятків назовні, а повертаючи порожнє значення замість винятку.
+Модуль відповідає за ініціалізацію та кешування конфігурації для взаємодії з OMLX. Він завантажує налаштування з `settings.json` та середовища виконання, використовуючи <http://127.0.0.1:8000/v1> як резервний URL. Публічна функція useOmlx звертається до мережі, виконує кешування у межах прогону. При виникненні помилок вона перехоплює їх (fail-safe), не кидаючи винятків назовні, а повертаючи порожнє значення замість винятку.
 
 ## Поведінка