@ykurilov/agent-chat-background 0.0.0-stage → 0.56.0

package/CHANGELOG.md

@@ -0,0 +1,376 @@
+# @ykurilov/agent-chat-background
+
+## 0.56.0
+
+### Patch Changes
+
+- Updated dependencies [24c313e]
+  - @ykurilov/agent-chat-core@0.56.0
+
+## 0.55.0
+
+### Patch Changes
+
+- Updated dependencies [51f7b38]
+- Updated dependencies [cdc7dd7]
+  - @ykurilov/agent-chat-core@0.55.0
+
+## 0.54.0
+
+### Patch Changes
+
+- Updated dependencies [fa90219]
+  - @ykurilov/agent-chat-core@0.54.0
+
+## 0.53.0
+
+### Patch Changes
+
+- Updated dependencies [b6a7786]
+  - @ykurilov/agent-chat-core@0.53.0
+
+## 0.52.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.52.0
+
+## 0.51.0
+
+### Patch Changes
+
+- b199ebe: Две копии сервера на медленной базе больше не выполняют одну фоновую задачу дважды.
+  
+  - Подбор брошенных задач идёт в копии по одному: обход по таймеру, начатый посреди `recover()`, раньше брал ту же
+    задачу второй раз (свою аренду копия берёт снова) и запускал её дважды.
+  - Аренда задачи считается от её взятия, а не от начала обхода: задача, взятая в конце долгого обхода, уже не приходит
+    с истёкшей арендой, которую тут же перехватывает другая копия.
+  - Продление аренд идёт отдельно от доставки и подбора и не ждёт их: долгий подбор больше не даёт аренде идущей задачи
+    истечь.
+  
+  Как обновить: поднять версию. Настроек и миграций нет.
+- Updated dependencies [41b1726]
+  - @ykurilov/agent-chat-core@0.51.0
+
+## 0.50.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.50.0
+
+## 0.49.0
+
+### Patch Changes
+
+- Updated dependencies [084cef7]
+  - @ykurilov/agent-chat-core@0.49.0
+
+## 0.48.0
+
+### Patch Changes
+
+- Updated dependencies [fa10d5a]
+  - @ykurilov/agent-chat-core@0.48.0
+
+## 0.47.0
+
+### Patch Changes
+
+- Updated dependencies [5a59c33]
+  - @ykurilov/agent-chat-core@0.47.0
+
+## 0.46.2
+
+### Patch Changes
+
+- Updated dependencies [3d0d2f2]
+  - @ykurilov/agent-chat-core@0.46.2
+
+## 0.46.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.46.1
+
+## 0.46.0
+
+### Patch Changes
+
+- Updated dependencies [56d7528]
+- Updated dependencies [a1933fd]
+- Updated dependencies [52cc67d]
+  - @ykurilov/agent-chat-core@0.46.0
+
+## 0.45.0
+
+### Minor Changes
+
+- eb74c58: Простой вид работы агента: свойство экрана `workView="simple"` — пока ход идёт, одна живая строка с текущим шагом
+  («Рисую календарь…»); после хода шаги свёрнуты в «Сделано N шагов» со списком понятных фраз, без кода и «Думал N сек».
+  По умолчанию `workView="detailed"` — всё как раньше. Фразы задаёт приложение (`stepPhrases`: имя инструмента →
+  `{ running, done, failed? }` или функция от вызова); встроенные пакеты дают свои во входе `./labels`
+  (`webToolStepPhrases`, `memoryStepPhrases`, `historySearchStepPhrases`, `backgroundStepPhrases`, и английские).
+  Договор скина 23: необязательный `ChatSkin.WorkSteps`; скин 22 работает без правок. Подробно — docs/work-view.md.
+  
+  ### Как обновить приложение
+  
+  Ничего не требуется. Чтобы включить простой вид:
+  
+  ```tsx
+  import { webToolStepPhrases } from "@ykurilov/agent-chat-web-tools/labels";
+  
+  <ChatWorkspace
+    workView="simple"
+    stepPhrases={{
+      ...webToolStepPhrases,
+      write_file: ({ input }) => ((input as { path?: string } | undefined)?.path ? { running: "Пишу файл", done: "Написал файл" } : undefined),
+      check_app: { running: "Проверяю приложение", done: "Проверил приложение" },
+    }}
+    …
+  />;
+  ```
+  
+  Свой скин может нарисовать простой вид сам — `WorkSteps` по docs/work-view.md (`WorkStepsView`: `live` с фразой или
+  `done` со `steps`, `count`, `open`). Без него шаги рисуются строкой `ToolCallRow`: «Сделано N шагов» в `title`, входа нет,
+  а список понятных фраз приходит в `output` строкой — скин покажет его как обычный результат вызова.
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.45.0
+
+## 0.44.0
+
+### Minor Changes
+
+- 6a2b5d9: Живые демонстрации: блок ```html-demo в ответе запускается в изолированной рамке (`sandbox="allow-scripts"`, строгий CSP,
+  наружу только высота). `agent.liveDemos` на сервере — одна постоянная строка инструкции; `liveDemos` у `AgentChat`,
+  `ChatWorkspace` и `AgentPanel`. Договор скина v22: необязательные `AgentText.renderDemo` и `ChatSkin.demoColors`, Тандем
+  умеет. Мессенджеры вместо блока пишут `liveDemoOnSite`, если у службы чата `liveDemos` (новое необязательное поле `ChatService.liveDemos`).
+  Код живёт в рамке внутри рамки: уйти на чужой адрес он не может, WebRTC убран. Выключатель: в чате с чужим текстом (веб-инструменты, файл человека, инструмент с `metadata: { externalContent: true }`)
+  демонстрации не запускаются — признак `ChatHistory.externalContent` и кусок потока `data-external-content`. Вложенные рамки
+  и `<link rel=preconnect>` в документе демонстрации запрещены. Всё необязательное, ломающих изменений нет. Как обновить
+  приложение — в CHANGES.md, раздел 0.44.0.
+
+### Patch Changes
+
+- Updated dependencies [6a2b5d9]
+  - @ykurilov/agent-chat-core@0.44.0
+
+## 0.43.0
+
+### Patch Changes
+
+- Updated dependencies [763f4c5]
+  - @ykurilov/agent-chat-core@0.43.0
+
+## 0.42.0
+
+### Patch Changes
+
+- Updated dependencies [a385276]
+  - @ykurilov/agent-chat-core@0.42.0
+
+## 0.41.0
+
+### Patch Changes
+
+- Updated dependencies [9472fcb]
+  - @ykurilov/agent-chat-core@0.41.0
+
+## 0.40.0
+
+### Patch Changes
+
+- Updated dependencies [0e7aab3]
+  - @ykurilov/agent-chat-core@0.40.0
+
+## 0.39.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.39.1
+
+## 0.39.0
+
+### Patch Changes
+
+- Updated dependencies [3b90429]
+  - @ykurilov/agent-chat-core@0.39.0
+
+## 0.38.0
+
+### Patch Changes
+
+- Updated dependencies [1cae504]
+- Updated dependencies [4065a4a]
+  - @ykurilov/agent-chat-core@0.38.0
+
+## 0.37.0
+
+### Patch Changes
+
+- Updated dependencies [7f49d12]
+- Updated dependencies [ea78982]
+  - @ykurilov/agent-chat-core@0.37.0
+
+## 0.36.0
+
+### Patch Changes
+
+- Updated dependencies [3487fb4]
+- Updated dependencies [8c43b86]
+- Updated dependencies [6f42418]
+- Updated dependencies [5f13c74]
+  - @ykurilov/agent-chat-core@0.36.0
+
+## 0.35.0
+
+### Patch Changes
+
+- Updated dependencies [2382026]
+  - @ykurilov/agent-chat-core@0.35.0
+
+## 0.34.0
+
+### Patch Changes
+
+- Updated dependencies [d039ce4]
+  - @ykurilov/agent-chat-core@0.34.0
+
+## 0.33.0
+
+### Patch Changes
+
+- Updated dependencies [4a72339]
+  - @ykurilov/agent-chat-core@0.33.0
+
+## 0.32.0
+
+### Patch Changes
+
+- Updated dependencies [71c32b7]
+- Updated dependencies [cae13bf]
+- Updated dependencies [a94bda9]
+- Updated dependencies [4e44492]
+- Updated dependencies [ac9b7d3]
+- Updated dependencies [27f4b1e]
+  - @ykurilov/agent-chat-core@0.32.0
+
+## 0.31.2
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.31.2
+
+## 0.31.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.31.1
+
+## 0.31.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.31.0
+
+## 0.30.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.30.0
+
+## 0.29.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.29.0
+
+## 0.28.0
+
+### Patch Changes
+
+- Updated dependencies [11c3c97]
+- Updated dependencies [d63ccaa]
+- Updated dependencies [6a2f903]
+- Updated dependencies [189cba9]
+  - @ykurilov/agent-chat-core@0.28.0
+
+## 0.27.0
+
+### Patch Changes
+
+- Updated dependencies [d8341b2]
+- Updated dependencies [5e4ed28]
+- Updated dependencies [e0bb519]
+  - @ykurilov/agent-chat-core@0.27.0
+
+## 0.26.2
+
+### Patch Changes
+
+- Updated dependencies [f24858a]
+  - @ykurilov/agent-chat-core@0.26.2
+
+## 0.26.1
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.26.1
+
+## 0.26.0
+
+### Patch Changes
+
+- Updated dependencies [eb43e47]
+  - @ykurilov/agent-chat-core@0.26.0
+
+## 0.25.0
+
+### Patch Changes
+
+- Updated dependencies [99d426e]
+- Updated dependencies [d8201f6]
+  - @ykurilov/agent-chat-core@0.25.0
+
+## 0.24.0
+
+### Patch Changes
+
+- Updated dependencies [9b895cd]
+  - @ykurilov/agent-chat-core@0.24.0
+
+## 0.23.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.23.0
+
+## 0.22.0
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.22.0
+
+## 0.21.0
+
+### Patch Changes
+
+- Updated dependencies [7c3bcc4]
+  - @ykurilov/agent-chat-core@0.21.0
+
+## 0.20.0
+
+### Minor Changes
+
+- fd16b01: Два новых пакета.
+  
+  - `@ykurilov/agent-chat-background` — фоновые задачи: инструмент или помощник работает в фоне, итог приходит в чат служебным сообщением, задачи переживают перезапуск сервера. Хранилища: память, SQLite, PostgreSQL. README пакета и `docs/background.md`.
+  - `@ykurilov/agent-chat-messengers` — чат приложения в Telegram, VK и MAX: привязка аккаунтов, вебхук или опрос, группы, файлы, голос, голосовые ответы, карточки задач, доставка «хотя бы раз». README пакета и `docs/messengers.md`. Для вида панели подключения — `MessengersSkin` v1.
+  
+  Что сделать в приложении: ставить нужно только если нужны фон или мессенджеры; подключение — по README пакетов.
+
+### Patch Changes
+
+- Updated dependencies [fd16b01]
+  - @ykurilov/agent-chat-core@0.20.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yury Kurilov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# @ykurilov/agent-chat-background
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Фоновые задачи для агента. Долгая работа не держит разговор: агент запускает задачу, человек пишет дальше, а когда
+задача закончилась, в чат приходит служебное сообщение «Задача готова» с итогом. Задачи переживают перезапуск
+сервера.
+
+Задачей бывает:
+
+- **фоновый инструмент** — ваша функция, которая работает долго (отчёт, выгрузка, обход сайтов);
+- **фоновый помощник** — помощник ядра (`helpers`) с `background: true`: его работа идёт в фоне, шаги сохраняются.
+
+Без этого пакета ничего не меняется: помощники работают внутри хода, фона нет.
+
+## Подключить
+
+```ts
+import { backgroundTool, createBackgroundTasks } from "@ykurilov/agent-chat-background";
+import { sqliteTaskStore } from "@ykurilov/agent-chat-background/sqlite";
+import { z } from "zod";
+
+const background = createBackgroundTasks({
+  store: sqliteTaskStore("./data/chat.db"), // тот же файл, что у чатов, или свой
+  tools: {
+    build_report: backgroundTool({
+      description: "Собрать большой отчёт по продажам. Занимает несколько минут.",
+      inputSchema: z.object({ month: z.string() }),
+      title: (input) => `Отчёт за ${input.month}`,
+      run: async (input, { signal, reportProgress }) => {
+        reportProgress("Читаю продажи");
+        return await buildReport(input.month, signal); // signal сработает, если задачу отменили
+      },
+    }),
+  },
+});
+
+const server = createChatServer({ …, background });
+// или createChatHandler({ …, background }) — тогда появляются адреса {base}/:chatId/tasks
+```
+
+Помощник уходит в фон одной строкой в его описании:
+
+```ts
+agent: {
+  helpers: {
+    researcher: { description: "…", instructions: "…", model, tools: searchTools, background: true },
+  },
+},
+```
+
+`background: true` без подключённого `background` — ошибка при запуске, а не тихий отказ.
+
+## Настройки `createBackgroundTasks`
+
+| Настройка | Что | По умолчанию |
+|---|---|---|
+| `store` | Где лежат задачи: `memoryTaskStore()`, `sqliteTaskStore(путь)`, `postgresTaskStore(pool)` | обязательна |
+| `tools` | Фоновые инструменты, имя → `backgroundTool({…})` | нет |
+| `maxRunningPerUser` | Сколько задач человека идёт одновременно (ждущие подтверждения не считаются) | 3 |
+| `timeoutMs` | Предел времени задачи; у инструмента можно свой `timeoutMs` | 30 минут |
+| `leaseMs` | Аренда задачи копией сервера; продлевается раз в треть, минимум 3000 мс | 30 секунд |
+
+Агент получает инструменты `check_tasks` (посмотреть задачи чата) и `cancel_task`, а в инструкцию — короткое правило, когда запускать
+фон. Когда задач уже `maxRunningPerUser`, запуск отвечает «слишком много задач»: агент видит это и ждёт или
+отменяет лишнее.
+
+## Хранилища
+
+```ts
+import { memoryTaskStore } from "@ykurilov/agent-chat-background";            // тесты, живёт до перезапуска
+import { sqliteTaskStore } from "@ykurilov/agent-chat-background/sqlite";     // файл
+import { postgresTaskStore } from "@ykurilov/agent-chat-background/postgres"; // pg.Pool
+```
+
+Миграции лежат в `drizzle/` и применяются при создании хранилища. Таблицы SQLite можно держать в файле чатов.
+
+## Что бывает с задачей
+
+`queued` → `running` → `done` / `failed` / `canceled` / `timed_out` / `interrupted`; на паузе — `awaiting_approval`.
+
+- **Отмена.** Кнопка «Отменить» в карточке (вкладка или мессенджер) или `cancel_task` агента. Работа получает
+  `signal` и должна его уважать.
+- **Подтверждение.** Фоновый инструмент с `needsApproval: true` спрашивает до запуска. Фоновый помощник спрашивает,
+  когда один из его инструментов просит подтверждения: задача встаёт на паузу и место не занимает. Ответ приходит
+  кнопками на вкладке или в мессенджере.
+- **Перезапуск сервера.** Копия, которая взяла задачу, продлевает аренду. Копия упала — аренда истекает, и другая
+  копия (или та же после старта) подбирает задачу. Фоновый помощник продолжает с сохранённых шагов: уже сделанные
+  вызовы инструментов не повторяются. Фоновый инструмент по умолчанию получает `interrupted` («прервана»);
+  `rerunAfterRestart: true` запускает его заново, поэтому такая работа должна быть безопасной для повтора.
+  Больше трёх запусков одной задачи не бывает: дальше она получает `interrupted`.
+- **Итог.** Служебное сообщение попадает в чат хотя бы один раз и будит агента; тот отвечает человеку по итогу.
+
+Живая проверка: [`tests/live/helpers-background.live.test.ts`](tests/live/helpers-background.live.test.ts) (платная,
+запускается отдельно: `pnpm exec vitest run --project live <файл>`).

package/dist/chunk-4RA3JT6K.js

@@ -0,0 +1,9 @@
+// src/store/migration-settings.ts
+var BACKGROUND_MIGRATIONS_TABLE = "__background_migrations";
+var BACKGROUND_MIGRATION_LOCK_KEY = 7311900444;
+
+export {
+  BACKGROUND_MIGRATIONS_TABLE,
+  BACKGROUND_MIGRATION_LOCK_KEY
+};
+//# sourceMappingURL=chunk-4RA3JT6K.js.map

package/dist/chunk-4RA3JT6K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store/migration-settings.ts"],"sourcesContent":["/** Своя таблица учёта: хранилище чатов и песочница живут в той же базе и ведут свои. */\nexport const BACKGROUND_MIGRATIONS_TABLE = \"__background_migrations\";\n\n/** Постоянное число для блокировки базы миграциями фона; не совпадает с ключами ядра (…443 — песочница) и мессенджеров (…445). */\nexport const BACKGROUND_MIGRATION_LOCK_KEY = 7_311_900_444;\n"],"mappings":";AACO,IAAM,8BAA8B;AAGpC,IAAM,gCAAgC;","names":[]}

package/dist/chunk-4XFSUFM6.js

@@ -0,0 +1,53 @@
+// src/store/task-store.ts
+var RUNNING_STATUSES = ["queued", "running"];
+var FINISHED_STATUSES = ["done", "failed", "canceled", "interrupted", "timed_out"];
+var NOTICE_STATUSES = [...FINISHED_STATUSES, "awaiting_approval"];
+var isRunningStatus = (status) => RUNNING_STATUSES.includes(status);
+var isFinishedStatus = (status) => FINISHED_STATUSES.includes(status);
+var OPTIONAL_FIELDS = [
+  "input",
+  "helperMessages",
+  "progress",
+  "result",
+  "error",
+  "leaseOwner",
+  "leaseUntil",
+  "startedAt",
+  "finishedAt",
+  "deliveredAt",
+  "deliveryKey"
+];
+function meetsCondition(task, when) {
+  if (when?.leaseOwner !== void 0 && task.leaseOwner !== when.leaseOwner) return false;
+  if (when?.statuses !== void 0 && !when.statuses.includes(task.status)) return false;
+  if (when?.pendingApprovalId !== void 0 && task.progress?.pendingApproval?.approvalId !== when.pendingApprovalId) return false;
+  return true;
+}
+function withoutEmptyFields(record) {
+  const clean = { ...record };
+  for (const field of OPTIONAL_FIELDS) {
+    if (clean[field] === null || clean[field] === void 0) delete clean[field];
+  }
+  return clean;
+}
+function patchEntries(patch) {
+  return Object.entries(patch).map(([key, value]) => [key, value ?? null]);
+}
+function withoutNul(value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value === "string") return value.replaceAll("\0", "");
+  if (typeof value !== "object") return value;
+  return JSON.parse(JSON.stringify(value, (_key, item) => typeof item === "string" ? item.replaceAll("\0", "") : item));
+}
+
+export {
+  RUNNING_STATUSES,
+  NOTICE_STATUSES,
+  isRunningStatus,
+  isFinishedStatus,
+  meetsCondition,
+  withoutEmptyFields,
+  patchEntries,
+  withoutNul
+};
+//# sourceMappingURL=chunk-4XFSUFM6.js.map

package/dist/chunk-4XFSUFM6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store/task-store.ts"],"sourcesContent":["import type { TaskStatus } from \"@ykurilov/agent-chat-core\";\nimport type { TaskCondition, TaskPatch, TaskRecord } from \"../types\";\n\n/**\n * Жизнь задачи в хранилище.\n * - `queued`/`running` — идёт; аренда у копии сервера, которая её ведёт.\n * - `awaiting_approval` и законченные — ждут доставки служебного сообщения; аренда у копии, которая доставляет.\n * - `delivered_at` стоит — чату всё сообщено, аренды нет, задача никому не нужна до следующего события.\n * Поэтому «задаче нужна копия сервера» — ровно `delivered_at IS NULL`.\n */\nexport const RUNNING_STATUSES = [\"queued\", \"running\"] as const satisfies readonly TaskStatus[];\nexport const FINISHED_STATUSES = [\"done\", \"failed\", \"canceled\", \"interrupted\", \"timed_out\"] as const satisfies readonly TaskStatus[];\n/** О чём чат получает служебное сообщение. */\nexport const NOTICE_STATUSES = [...FINISHED_STATUSES, \"awaiting_approval\"] as const satisfies readonly TaskStatus[];\n\nexport const isRunningStatus = (status: TaskStatus): boolean => (RUNNING_STATUSES as readonly TaskStatus[]).includes(status);\nexport const isFinishedStatus = (status: TaskStatus): boolean => (FINISHED_STATUSES as readonly TaskStatus[]).includes(status);\n\n/** Поля записи, которые хранилище может не хранить: `null` из базы и `undefined` из правки значат «нет». */\nconst OPTIONAL_FIELDS = [\n  \"input\",\n  \"helperMessages\",\n  \"progress\",\n  \"result\",\n  \"error\",\n  \"leaseOwner\",\n  \"leaseUntil\",\n  \"startedAt\",\n  \"finishedAt\",\n  \"deliveredAt\",\n  \"deliveryKey\",\n] as const satisfies readonly (keyof TaskRecord)[];\n\n/** Выполнено ли условие записи для задачи. */\nexport function meetsCondition(task: TaskRecord, when: TaskCondition | undefined): boolean {\n  if (when?.leaseOwner !== undefined && task.leaseOwner !== when.leaseOwner) return false;\n  if (when?.statuses !== undefined && !when.statuses.includes(task.status)) return false;\n  if (when?.pendingApprovalId !== undefined && task.progress?.pendingApproval?.approvalId !== when.pendingApprovalId) return false;\n  return true;\n}\n\n/** Убирает пустые необязательные поля: запись из любого хранилища выглядит одинаково. */\nexport function withoutEmptyFields(record: TaskRecord): TaskRecord {\n  const clean = { ...record } as Record<string, unknown>;\n  for (const field of OPTIONAL_FIELDS) {\n    if (clean[field] === null || clean[field] === undefined) delete clean[field];\n  }\n  return clean as unknown as TaskRecord;\n}\n\n/** Правка (или вся запись) как пары «поле — значение»: переданный `undefined` стирает поле (`null` в базе). */\nexport function patchEntries(patch: TaskPatch | TaskRecord): Array<[string, unknown]> {\n  return Object.entries(patch).map(([key, value]) => [key, value ?? null]);\n}\n\n/** PostgreSQL не хранит символ NUL ни в тексте, ни в jsonb: убираем его до записи. */\nexport function withoutNul<T>(value: T): T {\n  if (value === null || value === undefined) return value;\n  if (typeof value === \"string\") return value.replaceAll(\"\\u0000\", \"\") as T;\n  if (typeof value !== \"object\") return value;\n  return JSON.parse(JSON.stringify(value, (_key, item: unknown) => (typeof item === \"string\" ? item.replaceAll(\"\\u0000\", \"\") : item))) as T;\n}\n"],"mappings":";AAUO,IAAM,mBAAmB,CAAC,UAAU,SAAS;AAC7C,IAAM,oBAAoB,CAAC,QAAQ,UAAU,YAAY,eAAe,WAAW;AAEnF,IAAM,kBAAkB,CAAC,GAAG,mBAAmB,mBAAmB;AAElE,IAAM,kBAAkB,CAAC,WAAiC,iBAA2C,SAAS,MAAM;AACpH,IAAM,mBAAmB,CAAC,WAAiC,kBAA4C,SAAS,MAAM;AAG7H,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,eAAe,MAAkB,MAA0C;AACzF,MAAI,MAAM,eAAe,UAAa,KAAK,eAAe,KAAK,WAAY,QAAO;AAClF,MAAI,MAAM,aAAa,UAAa,CAAC,KAAK,SAAS,SAAS,KAAK,MAAM,EAAG,QAAO;AACjF,MAAI,MAAM,sBAAsB,UAAa,KAAK,UAAU,iBAAiB,eAAe,KAAK,kBAAmB,QAAO;AAC3H,SAAO;AACT;AAGO,SAAS,mBAAmB,QAAgC;AACjE,QAAM,QAAQ,EAAE,GAAG,OAAO;AAC1B,aAAW,SAAS,iBAAiB;AACnC,QAAI,MAAM,KAAK,MAAM,QAAQ,MAAM,KAAK,MAAM,OAAW,QAAO,MAAM,KAAK;AAAA,EAC7E;AACA,SAAO;AACT;AAGO,SAAS,aAAa,OAAyD;AACpF,SAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,SAAS,IAAI,CAAC;AACzE;AAGO,SAAS,WAAc,OAAa;AACzC,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO,MAAM,WAAW,MAAU,EAAE;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,SAAO,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC,MAAM,SAAmB,OAAO,SAAS,WAAW,KAAK,WAAW,MAAU,EAAE,IAAI,IAAK,CAAC;AACrI;","names":[]}