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

package/dist/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sqlite.ts","../src/store/sqlite.ts","../src/store/sqlite-schema.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport type { TaskStore } from \"./types\";\nimport { createSqliteTaskStore } from \"./store/sqlite\";\n\nexport { BACKGROUND_MIGRATIONS_TABLE } from \"./store/migration-settings\";\nexport { backgroundTasks } from \"./store/sqlite-schema\";\n\n/** Миграции лежат в пакете рядом с `dist`: `drizzle/sqlite`. */\nconst MIGRATIONS_FOLDER = fileURLToPath(new URL(\"../drizzle/sqlite\", import.meta.url));\n\n/**\n * Задачи фона в файле SQLite; файл может быть общим с хранилищем чатов (`createSqliteChatStorage`).\n * Таблица приводится к последней миграции при открытии.\n */\nexport function sqliteTaskStore(filePath: string): TaskStore {\n  return createSqliteTaskStore(filePath, MIGRATIONS_FOLDER);\n}\n","import Database from \"better-sqlite3\";\nimport { and, asc, eq, inArray, isNull, lt, or, sql } from \"drizzle-orm\";\nimport { drizzle } from \"drizzle-orm/better-sqlite3\";\nimport { migrate } from \"drizzle-orm/better-sqlite3/migrator\";\nimport type { TaskCondition, TaskPatch, TaskRecord, TaskStore } from \"../types\";\nimport { BACKGROUND_MIGRATIONS_TABLE } from \"./migration-settings\";\nimport { backgroundTasks } from \"./sqlite-schema\";\nimport { meetsCondition, NOTICE_STATUSES, patchEntries, RUNNING_STATUSES, withoutEmptyFields } from \"./task-store\";\n\ntype Row = typeof backgroundTasks.$inferSelect;\n\nconst TIME_FIELDS = [\"leaseUntil\", \"createdAt\", \"startedAt\", \"finishedAt\", \"deliveredAt\"] as const;\nconst toMs = (iso: string | undefined | null) => (iso === undefined || iso === null ? null : Date.parse(iso));\nconst toIso = (ms: number | null) => (ms === null ? undefined : new Date(ms).toISOString());\n\nfunction toRecord(row: Row): TaskRecord {\n  return withoutEmptyFields({\n    ...row,\n    leaseUntil: toIso(row.leaseUntil),\n    createdAt: toIso(row.createdAt)!,\n    startedAt: toIso(row.startedAt),\n    finishedAt: toIso(row.finishedAt),\n    deliveredAt: toIso(row.deliveredAt),\n  } as TaskRecord);\n}\n\n/** Запись или правка как колонки таблицы: времена — миллисекунды. */\nfunction toColumns(patch: TaskPatch | TaskRecord): Record<string, unknown> {\n  const columns: Record<string, unknown> = {};\n  for (const [key, value] of patchEntries(patch)) {\n    columns[key] = (TIME_FIELDS as readonly string[]).includes(key) ? toMs(value as string | null) : value;\n  }\n  return columns;\n}\n\n/**\n * Хранилище задач в файле SQLite. Схема приводится к последней миграции при открытии; файл может быть общим\n * с хранилищем чатов. Две копии сервера на одном файле делят задачи через аренду.\n */\nexport function createSqliteTaskStore(filePath: string, migrationsFolder: string): TaskStore {\n  const sqlite = new Database(filePath);\n  sqlite.pragma(\"journal_mode = WAL\");\n  sqlite.pragma(\"busy_timeout = 5000\");\n  const db = drizzle(sqlite);\n  migrate(db, { migrationsFolder, migrationsTable: BACKGROUND_MIGRATIONS_TABLE });\n  const owned = (ownerId: string, taskId: string) => and(eq(backgroundTasks.id, taskId), eq(backgroundTasks.ownerId, ownerId));\n  const isRunning = inArray(backgroundTasks.status, [...RUNNING_STATUSES]);\n  /** Условие записи — в том же `update … where`: проверка и запись одним действием базы. */\n  const condition = (when: TaskCondition | undefined) =>\n    and(\n      when?.leaseOwner !== undefined ? eq(backgroundTasks.leaseOwner, when.leaseOwner) : undefined,\n      when?.statuses !== undefined ? inArray(backgroundTasks.status, [...when.statuses]) : undefined,\n      when?.pendingApprovalId !== undefined ? sql`json_extract(${backgroundTasks.progress}, '$.pendingApproval.approvalId') = ${when.pendingApprovalId}` : undefined,\n    );\n\n  async function get(ownerId: string, taskId: string): Promise<TaskRecord | null> {\n    const row = db.select().from(backgroundTasks).where(owned(ownerId, taskId)).get();\n    return row ? toRecord(row) : null;\n  }\n\n  return {\n    async create(task) {\n      db.insert(backgroundTasks).values(toColumns(task) as Row).run();\n    },\n    get,\n    async update(ownerId, taskId, patch, when) {\n      const columns = toColumns(patch);\n      if (Object.keys(columns).length === 0) {\n        const task = await get(ownerId, taskId);\n        return task && meetsCondition(task, when) ? task : null;\n      }\n      const row = db.update(backgroundTasks).set(columns).where(and(owned(ownerId, taskId), condition(when))).returning().get();\n      return row ? toRecord(row) : null;\n    },\n    async listForChat(ownerId, chatId) {\n      const rows = db\n        .select()\n        .from(backgroundTasks)\n        .where(and(eq(backgroundTasks.ownerId, ownerId), eq(backgroundTasks.chatId, chatId)))\n        .orderBy(asc(backgroundTasks.createdAt), asc(backgroundTasks.id))\n        .all();\n      return rows.map(toRecord);\n    },\n    async countActive(ownerId) {\n      const row = db\n        .select({ count: sql<number>`count(*)` })\n        .from(backgroundTasks)\n        .where(and(eq(backgroundTasks.ownerId, ownerId), isRunning))\n        .get();\n      return Number(row?.count ?? 0);\n    },\n    async claim(taskId, leaseOwner, leaseUntil, now) {\n      const nowMs = toMs(now)!;\n      // Одно условное обновление: из двух копий, пришедших одновременно, условие выполнится только у первой.\n      const row = db\n        .update(backgroundTasks)\n        .set({\n          leaseOwner,\n          leaseUntil: toMs(leaseUntil),\n          status: sql`case when ${isRunning} then 'running' else ${backgroundTasks.status} end`,\n          attempt: sql`case when ${isRunning} then ${backgroundTasks.attempt} + 1 else ${backgroundTasks.attempt} end`,\n          startedAt: sql`case when ${isRunning} then coalesce(${backgroundTasks.startedAt}, ${nowMs}) else ${backgroundTasks.startedAt} end`,\n        })\n        .where(\n          and(\n            eq(backgroundTasks.id, taskId),\n            isNull(backgroundTasks.deliveredAt),\n            or(eq(backgroundTasks.leaseOwner, leaseOwner), isNull(backgroundTasks.leaseUntil), lt(backgroundTasks.leaseUntil, nowMs)),\n          ),\n        )\n        .returning()\n        .get();\n      return row ? toRecord(row) : null;\n    },\n    async renewLease(taskId, leaseOwner, leaseUntil) {\n      const renewed = db\n        .update(backgroundTasks)\n        .set({ leaseUntil: toMs(leaseUntil) })\n        .where(and(eq(backgroundTasks.id, taskId), eq(backgroundTasks.leaseOwner, leaseOwner), isNull(backgroundTasks.deliveredAt)))\n        .run();\n      return renewed.changes > 0;\n    },\n    async listExpired(now) {\n      const rows = db\n        .select()\n        .from(backgroundTasks)\n        .where(and(isNull(backgroundTasks.deliveredAt), or(isNull(backgroundTasks.leaseUntil), lt(backgroundTasks.leaseUntil, toMs(now)!))))\n        .orderBy(asc(backgroundTasks.createdAt))\n        .all();\n      return rows.map(toRecord);\n    },\n    async listUndelivered(ownerId, chatId) {\n      const rows = db\n        .select()\n        .from(backgroundTasks)\n        .where(\n          and(\n            eq(backgroundTasks.ownerId, ownerId),\n            eq(backgroundTasks.chatId, chatId),\n            isNull(backgroundTasks.deliveredAt),\n            inArray(backgroundTasks.status, [...NOTICE_STATUSES]),\n          ),\n        )\n        .orderBy(asc(backgroundTasks.createdAt), asc(backgroundTasks.id))\n        .all();\n      return rows.map(toRecord);\n    },\n    async markDelivered(taskIds, deliveryKey, at) {\n      if (taskIds.length === 0) return;\n      db.update(backgroundTasks)\n        .set({ deliveredAt: toMs(at), leaseOwner: null, leaseUntil: null })\n        .where(\n          and(\n            inArray(backgroundTasks.id, [...taskIds]),\n            eq(backgroundTasks.deliveryKey, deliveryKey),\n            inArray(backgroundTasks.status, [...NOTICE_STATUSES]),\n          ),\n        )\n        .run();\n    },\n    async deleteForChat(ownerId, chatId) {\n      db.delete(backgroundTasks)\n        .where(and(eq(backgroundTasks.ownerId, ownerId), eq(backgroundTasks.chatId, chatId)))\n        .run();\n    },\n    async close() {\n      sqlite.close();\n    },\n  };\n}\n","import type { HelperProgress, TaskStatus } from \"@ykurilov/agent-chat-core\";\nimport type { ModelMessage } from \"ai\";\nimport { index, integer, sqliteTable, text } from \"drizzle-orm/sqlite-core\";\n\nexport const backgroundTasks = sqliteTable(\n  \"background_tasks\",\n  {\n    id: text(\"id\").primaryKey(),\n    ownerId: text(\"owner_id\").notNull(),\n    chatId: text(\"chat_id\").notNull(),\n    messageId: text(\"message_id\").notNull(),\n    toolCallId: text(\"tool_call_id\").notNull(),\n    channel: text(\"channel\", { enum: [\"web\", \"telegram\", \"vk\", \"max\"] }).notNull(),\n    kind: text(\"kind\", { enum: [\"tool\", \"helper\"] }).notNull(),\n    name: text(\"name\").notNull(),\n    input: text(\"input\", { mode: \"json\" }),\n    title: text(\"title\").notNull(),\n    status: text(\"status\").$type<TaskStatus>().notNull(),\n    /** Шаги помощника: с них задача продолжается после перезапуска. */\n    helperMessages: text(\"helper_messages\", { mode: \"json\" }).$type<ModelMessage[]>(),\n    progress: text(\"progress\", { mode: \"json\" }).$type<HelperProgress>(),\n    result: text(\"result\", { mode: \"json\" }),\n    error: text(\"error\"),\n    leaseOwner: text(\"lease_owner\"),\n    leaseUntil: integer(\"lease_until\"),\n    attempt: integer(\"attempt\").notNull().default(0),\n    createdAt: integer(\"created_at\").notNull(),\n    startedAt: integer(\"started_at\"),\n    finishedAt: integer(\"finished_at\"),\n    deliveredAt: integer(\"delivered_at\"),\n    /** Ключ служебного сообщения, с которым задачу начали доставлять. */\n    deliveryKey: text(\"delivery_key\"),\n  },\n  (table) => [\n    index(\"background_tasks_status_lease_idx\").on(table.status, table.leaseUntil),\n    index(\"background_tasks_owner_status_idx\").on(table.ownerId, table.status),\n    index(\"background_tasks_chat_delivered_idx\").on(table.chatId, table.deliveredAt),\n  ],\n);\n"],"mappings":"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","names":[]}

package/dist/types/background-tasks.d.ts

@@ -0,0 +1,18 @@
+import type { BackgroundTasks } from "@ykurilov/agent-chat-core";
+import type { BackgroundToolDefinition, TaskStore } from "./types.js";
+export interface BackgroundTasksOptions {
+    /** `memoryTaskStore()`, `sqliteTaskStore(path)`, `postgresTaskStore(pool)`. */
+    store: TaskStore;
+    tools?: Record<string, BackgroundToolDefinition>;
+    /** Сколько задач человека идёт одновременно; по умолчанию 3. */
+    maxRunningPerUser?: number;
+    /** Предел времени задачи; по умолчанию 30 минут. */
+    timeoutMs?: number;
+    /** Аренда задачи; по умолчанию 30 с, продление раз в треть аренды. */
+    leaseMs?: number;
+}
+/**
+ * Фоновые задачи для службы чата: агент запускает долгую работу, разговор идёт дальше, итог приходит служебным
+ * сообщением. Задачи переживают перезапуск сервера; несколько копий сервера на одной базе делят их по аренде.
+ */
+export declare function createBackgroundTasks(options: BackgroundTasksOptions): BackgroundTasks;

package/dist/types/background-tool.d.ts

@@ -0,0 +1,16 @@
+import type { AgentToolsModel } from "@ykurilov/agent-chat-core";
+import type { Tool } from "ai";
+import type { NewTask, RunControl, TaskOutcome, TaskRunner } from "./task-runner.js";
+import type { BackgroundToolDefinition, TaskRecord } from "./types.js";
+/** Фоновый инструмент: агент запускает его, ход идёт дальше, итог придёт служебным сообщением. */
+export declare function backgroundTool<Input, Output>(definition: BackgroundToolDefinition<Input, Output>): BackgroundToolDefinition;
+/** Поля хода для записи задачи; без номера ответа и канала (вызов вне хода) — пустой номер и веб. */
+export declare function turnFields(model: AgentToolsModel): Pick<NewTask, "ownerId" | "chatId" | "messageId" | "channel">;
+export declare const TOO_MANY_TASKS: (max: number) => string;
+/** Инструмент хода для фонового инструмента: запись задачи и ответ «запущена» сразу, без ожидания итога. */
+export declare function backgroundToolForTurn(name: string, definition: BackgroundToolDefinition, model: AgentToolsModel, service: {
+    runner(): TaskRunner;
+    maxRunningPerUser: number;
+}): Tool;
+/** Работа фонового инструмента в бегунке: итог — `done`, ошибка — `failed`. */
+export declare function runBackgroundTool(definition: BackgroundToolDefinition, record: TaskRecord, control: RunControl): Promise<TaskOutcome>;

package/dist/types/helper-task.d.ts

@@ -0,0 +1,17 @@
+import type { AgentHelper, AgentToolsModel, BackgroundPort } from "@ykurilov/agent-chat-core";
+import type { Tool } from "ai";
+import type { RunControl, TaskOutcome, TaskRunner } from "./task-runner.js";
+import type { TaskRecord } from "./types.js";
+export declare const HELPER_TOOL_PREFIX = "helper_";
+/** Фоновые помощники из настроек службы: ядро отдаёт их в порте. */
+export declare function backgroundHelpers(port: BackgroundPort | undefined): Record<string, AgentHelper>;
+/** `helper_<имя>` фонового помощника: создаёт задачу и сразу отвечает «работает в фоне». */
+export declare function helperToolForTurn(name: string, helper: AgentHelper, model: AgentToolsModel, service: {
+    runner(): TaskRunner;
+    maxRunningPerUser: number;
+}): Tool;
+/**
+ * Работа фонового помощника в бегунке: цикл ядра (`port.runHelper`) с сохранёнными шагами. После каждого шага шаги и ход
+ * пишутся в задачу: после перезапуска цикл продолжит с них, траты за старые шаги не повторятся.
+ */
+export declare function runHelperTask(port: BackgroundPort, helper: AgentHelper, record: TaskRecord, control: RunControl): Promise<TaskOutcome>;

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export type { BackgroundRunContext, BackgroundToolDefinition, TaskPatch, TaskRecord, TaskStore } from "./types.js";
+export { backgroundTool } from "./background-tool.js";
+export { createBackgroundTasks } from "./background-tasks.js";
+export type { BackgroundTasksOptions } from "./background-tasks.js";
+export { memoryTaskStore } from "./store/memory.js";

package/dist/types/keyed-lock.d.ts

@@ -0,0 +1,3 @@
+/** Очередь по ключу: дела с одним ключом идут по одному, с разными — сразу. Ошибка одного дела следующим не мешает. */
+export type KeyedLock = <T>(key: string, work: () => Promise<T>) => Promise<T>;
+export declare function createKeyedLock(): KeyedLock;

package/dist/types/labels.d.ts

@@ -0,0 +1,10 @@
+/** Понятные фразы инструментов фоновых задач для простого вида чата (`stepPhrases` у `AgentChat`). Без импортов: файл безопасно подключать в браузерной сборке. */
+export declare const backgroundStepPhrases: Record<string, {
+    running: string;
+    done: string;
+}>;
+/** Те же фразы по-английски. */
+export declare const englishBackgroundStepPhrases: Record<string, {
+    running: string;
+    done: string;
+}>;

package/dist/types/postgres.d.ts

@@ -0,0 +1,9 @@
+import type { Pool } from "pg";
+import type { TaskStore } from "./types.js";
+export { BACKGROUND_MIGRATIONS_TABLE, BACKGROUND_MIGRATION_LOCK_KEY } from "./store/migration-settings.js";
+export { backgroundTasks } from "./store/postgres-schema.js";
+/**
+ * Задачи фона в PostgreSQL на пуле приложения (схема `agent_chat`, та же база, что у хранилища чатов).
+ * Таблица приводится к последней миграции при первом обращении. Пул закрывает приложение.
+ */
+export declare function postgresTaskStore(pool: Pool): TaskStore;

package/dist/types/sqlite.d.ts

@@ -0,0 +1,8 @@
+import type { TaskStore } from "./types.js";
+export { BACKGROUND_MIGRATIONS_TABLE } from "./store/migration-settings.js";
+export { backgroundTasks } from "./store/sqlite-schema.js";
+/**
+ * Задачи фона в файле SQLite; файл может быть общим с хранилищем чатов (`createSqliteChatStorage`).
+ * Таблица приводится к последней миграции при открытии.
+ */
+export declare function sqliteTaskStore(filePath: string): TaskStore;

package/dist/types/store/memory.d.ts

@@ -0,0 +1,3 @@
+import type { TaskStore } from "../types.js";
+/** Задачи в памяти процесса: для разработки и тестов. Перезапуск их теряет, две копии сервера их не делят. */
+export declare function memoryTaskStore(): TaskStore;

package/dist/types/store/migration-settings.d.ts

@@ -0,0 +1,4 @@
+/** Своя таблица учёта: хранилище чатов и песочница живут в той же базе и ведут свои. */
+export declare const BACKGROUND_MIGRATIONS_TABLE = "__background_migrations";
+/** Постоянное число для блокировки базы миграциями фона; не совпадает с ключами ядра (…443 — песочница) и мессенджеров (…445). */
+export declare const BACKGROUND_MIGRATION_LOCK_KEY = 7311900444;

package/dist/types/store/postgres-schema.d.ts

@@ -0,0 +1,406 @@
+import type { HelperProgress, TaskStatus } from "@ykurilov/agent-chat-core";
+import type { ModelMessage } from "ai";
+export declare const backgroundTasks: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "background_tasks";
+    schema: "agent_chat";
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        ownerId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "owner_id";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        chatId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "chat_id";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        messageId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "message_id";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        toolCallId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tool_call_id";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        channel: import("drizzle-orm/pg-core").PgColumn<{
+            name: "channel";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: "max" | "telegram" | "vk" | "web";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["web", "telegram", "vk", "max"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: "helper" | "tool";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["tool", "helper"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        input: import("drizzle-orm/pg-core").PgColumn<{
+            name: "input";
+            tableName: "background_tasks";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: TaskStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: TaskStatus;
+        }>;
+        helperMessages: import("drizzle-orm/pg-core").PgColumn<{
+            name: "helper_messages";
+            tableName: "background_tasks";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: ModelMessage[];
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: ModelMessage[];
+        }>;
+        progress: import("drizzle-orm/pg-core").PgColumn<{
+            name: "progress";
+            tableName: "background_tasks";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: HelperProgress;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: HelperProgress;
+        }>;
+        result: import("drizzle-orm/pg-core").PgColumn<{
+            name: "result";
+            tableName: "background_tasks";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        error: import("drizzle-orm/pg-core").PgColumn<{
+            name: "error";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        leaseOwner: import("drizzle-orm/pg-core").PgColumn<{
+            name: "lease_owner";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        leaseUntil: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "background_tasks";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attempt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "attempt";
+            tableName: "background_tasks";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "background_tasks";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "background_tasks";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        finishedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "background_tasks";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deliveredAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "background_tasks";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deliveryKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "delivery_key";
+            tableName: "background_tasks";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'pg';
+}>;

package/dist/types/store/postgres.d.ts

@@ -0,0 +1,12 @@
+import type { Pool } from "pg";
+import type { TaskStore } from "../types.js";
+/**
+ * Приводит таблицу задач к последней миграции. Идёт на одном соединении под блокировкой базы:
+ * если несколько серверов стартуют сразу, второй ждёт первого и видит применённые миграции.
+ */
+export declare function migrateBackgroundTasksToLatest(pool: Pool, migrationsFolder: string): Promise<void>;
+/**
+ * Хранилище задач в PostgreSQL (схема `agent_chat`) на пуле приложения. Миграция идёт при первом обращении,
+ * каждая операция её дожидается. Закрытие пул не закрывает: он принадлежит приложению.
+ */
+export declare function createPostgresTaskStore(pool: Pool, migrationsFolder: string): TaskStore;