@besales/mcp 0.46.0 → 0.47.1

package/dist/types/api-contract.gen.d.ts

@@ -3,6 +3,23 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
+    "/api/v2/agents/{agentId}/readiness": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Доказательная готовность выбранного агента и текущей версии конфигурации */
+        get: operations["AgentReadinessController_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/auth/login": {
         parameters: {
             query?: never;
@@ -235,8 +252,8 @@ export interface paths {
                     /** @description PKCE S256 challenge — SHA256(code_verifier) base64url-encoded */
                     code_challenge: string;
                     code_challenge_method: "S256";
-                    /** @description Requested scopes: base `mcp:*` plus any subset of the optional scopes, in the canonical order `mcp:platform-setup`, `mcp:funnel-test`, `read:campaigns`, `launch:campaigns`. `mcp:*` enables PromptHub/ICP/Sandbox/Knowledge tools; `mcp:platform-setup` enables Platform Setup Bridge mutations; `mcp:funnel-test` permits frozen-plan funnel tests that can send real messages; `read:campaigns` covers cold-welcome preview and broadcast reads; `launch:campaigns` covers cold-welcome/broadcast launches. `besales-mcp connect` always requests the widest string. INVARIANT: a new scope is APPENDED to the optional list — never swapped in for an existing one, or every reconnect silently narrows live keys. */
-                    scope: "mcp:*" | "mcp:* mcp:platform-setup" | "mcp:* mcp:funnel-test" | "mcp:* mcp:platform-setup mcp:funnel-test" | "mcp:* read:campaigns" | "mcp:* mcp:platform-setup read:campaigns" | "mcp:* mcp:funnel-test read:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns" | "mcp:* launch:campaigns" | "mcp:* mcp:platform-setup launch:campaigns" | "mcp:* mcp:funnel-test launch:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test launch:campaigns" | "mcp:* read:campaigns launch:campaigns" | "mcp:* mcp:platform-setup read:campaigns launch:campaigns" | "mcp:* mcp:funnel-test read:campaigns launch:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns launch:campaigns";
+                    /** @description Requested scopes: base `mcp:*` plus any subset of the optional scopes, in the canonical order `mcp:platform-setup`, `mcp:funnel-test`, `read:campaigns`, `launch:campaigns`, `read:contacts`, `write:operators`. `mcp:*` enables PromptHub/ICP/Sandbox/Knowledge tools; `mcp:platform-setup` enables Platform Setup Bridge mutations; `mcp:funnel-test` permits frozen-plan funnel tests that can send real messages; `read:campaigns` covers cold-welcome preview and broadcast reads; `launch:campaigns` covers cold-welcome/broadcast launches; `read:contacts` covers contact search, cards and safe diagnostics; `write:operators` permits a CAS-protected local workspace-operator assignment without sending messages. `besales-mcp connect` always requests the widest string. INVARIANT: a new scope is APPENDED to the optional list — never swapped in for an existing one, or every reconnect silently narrows live keys. */
+                    scope: "mcp:*" | "mcp:* mcp:platform-setup" | "mcp:* mcp:funnel-test" | "mcp:* mcp:platform-setup mcp:funnel-test" | "mcp:* read:campaigns" | "mcp:* mcp:platform-setup read:campaigns" | "mcp:* mcp:funnel-test read:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns" | "mcp:* launch:campaigns" | "mcp:* mcp:platform-setup launch:campaigns" | "mcp:* mcp:funnel-test launch:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test launch:campaigns" | "mcp:* read:campaigns launch:campaigns" | "mcp:* mcp:platform-setup read:campaigns launch:campaigns" | "mcp:* mcp:funnel-test read:campaigns launch:campaigns" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns launch:campaigns" | "mcp:* read:contacts" | "mcp:* mcp:platform-setup read:contacts" | "mcp:* mcp:funnel-test read:contacts" | "mcp:* mcp:platform-setup mcp:funnel-test read:contacts" | "mcp:* read:campaigns read:contacts" | "mcp:* mcp:platform-setup read:campaigns read:contacts" | "mcp:* mcp:funnel-test read:campaigns read:contacts" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns read:contacts" | "mcp:* launch:campaigns read:contacts" | "mcp:* mcp:platform-setup launch:campaigns read:contacts" | "mcp:* mcp:funnel-test launch:campaigns read:contacts" | "mcp:* mcp:platform-setup mcp:funnel-test launch:campaigns read:contacts" | "mcp:* read:campaigns launch:campaigns read:contacts" | "mcp:* mcp:platform-setup read:campaigns launch:campaigns read:contacts" | "mcp:* mcp:funnel-test read:campaigns launch:campaigns read:contacts" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns launch:campaigns read:contacts" | "mcp:* write:operators" | "mcp:* mcp:platform-setup write:operators" | "mcp:* mcp:funnel-test write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test write:operators" | "mcp:* read:campaigns write:operators" | "mcp:* mcp:platform-setup read:campaigns write:operators" | "mcp:* mcp:funnel-test read:campaigns write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns write:operators" | "mcp:* launch:campaigns write:operators" | "mcp:* mcp:platform-setup launch:campaigns write:operators" | "mcp:* mcp:funnel-test launch:campaigns write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test launch:campaigns write:operators" | "mcp:* read:campaigns launch:campaigns write:operators" | "mcp:* mcp:platform-setup read:campaigns launch:campaigns write:operators" | "mcp:* mcp:funnel-test read:campaigns launch:campaigns write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns launch:campaigns write:operators" | "mcp:* read:contacts write:operators" | "mcp:* mcp:platform-setup read:contacts write:operators" | "mcp:* mcp:funnel-test read:contacts write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test read:contacts write:operators" | "mcp:* read:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup read:campaigns read:contacts write:operators" | "mcp:* mcp:funnel-test read:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns read:contacts write:operators" | "mcp:* launch:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup launch:campaigns read:contacts write:operators" | "mcp:* mcp:funnel-test launch:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test launch:campaigns read:contacts write:operators" | "mcp:* read:campaigns launch:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup read:campaigns launch:campaigns read:contacts write:operators" | "mcp:* mcp:funnel-test read:campaigns launch:campaigns read:contacts write:operators" | "mcp:* mcp:platform-setup mcp:funnel-test read:campaigns launch:campaigns read:contacts write:operators";
                 };
                 header?: never;
                 path?: never;
@@ -450,6 +467,10 @@ export interface paths {
                             api_key: string;
                             /** Format: uuid */
                             workspace_id: string;
+                            /** @description Workspace name captured at token exchange for local human-readable selection */
+                            workspace_name: string;
+                            /** @description Masked account email (for example, o***@example.com); never contains the raw email */
+                            account_label: string | null;
                             /**
                              * Format: date-time
                              * @description API key expiration (90 days from now)
@@ -477,6 +498,59 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/auth/mcp-context": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read safe labels for the current MCP connection
+         * @description Lightweight alternative to workspace overview for local workspace selection.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Current workspace and masked account label */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** Format: uuid */
+                            workspace_id: string;
+                            workspace_name: string;
+                            account_label: string | null;
+                            /** @description Effective scopes of this exact MCP key */
+                            scopes: string[];
+                        };
+                    };
+                };
+                /** @description MCP key is missing, revoked, or belongs to another workspace */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/auth/mcp-connections": {
         parameters: {
             query?: never;
@@ -890,6 +964,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/navigation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Выбрать один следующий шаг по намерению и живому overview
+         * @description Read-only навигатор. Учитывает тип бота, уже выбранные объекты и текущее состояние
+         *     workspace. Возвращает конкретный MCP tool, аргументы, необходимый ввод человека и способ
+         *     проверки; сам мутацию не выполняет и readiness не подменяет.
+         */
+        post: operations["navigateWorkspaceTask"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/setup-sessions": {
         parameters: {
             query?: never;
@@ -5422,7 +5518,10 @@ export interface paths {
         /** Sanitized setup context with readiness flags */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Секции снимка через запятую; agent_summaries исключает полный промпт. */
+                    sections?: string;
+                };
                 header?: never;
                 path: {
                     platformId: components["parameters"]["PlatformIdPath"];
@@ -5449,6 +5548,49 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/platforms/{platformId}/setup/trigger-action-catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Current trigger action schemas, examples and dependencies
+         * @description Каталог строится из боевого `CreateTriggerActionDto` и `TRIGGER_ACTION_CONFIG`.
+         *     `actionType` позволяет запросить один тип без загрузки всех схем.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    actionType?: string;
+                };
+                header?: never;
+                path: {
+                    platformId: components["parameters"]["PlatformIdPath"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TriggerActionCatalogResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/platforms/{platformId}/agents": {
         parameters: {
             query?: never;
@@ -5459,7 +5601,14 @@ export interface paths {
         /** List agents attached to existing platform */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Размер страницы; без него список отдаётся целиком. */
+                    limit?: number;
+                    /** @description Курсор из предыдущего ответа. */
+                    cursor?: string;
+                    /** @description Поиск без учёта регистра по name или displayName. */
+                    q?: string;
+                };
                 header?: never;
                 path: {
                     platformId: components["parameters"]["PlatformIdPath"];
@@ -6340,6 +6489,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/getcourse-cold-welcome/touch-history/{gcUserId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * What we have already sent this person, and by what right
+         * @description Three sources with DIFFERENT keys, joined into one answer. `touches` is the touch journal: a RIGHT taken BEFORE transport, so a row exists even for an attempt that never sent (UNKNOWN, stuck CLAIMED). `sends` is the recipient registry: written AFTER delivery and best-effort, so its absence does NOT prove non-delivery. `firstWelcomeAt` is the earliest mark across the person cards. Do not add `touches` and `sends` together — they answer different questions.
+         */
+        get: operations["getContactTouchHistory"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/getcourse-cold-welcome/preview": {
         parameters: {
             query?: never;
@@ -6537,6 +6706,49 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/getcourse-anchor-refresh/{correlationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Статус фонового перечитывания календарных якорей
+         * @description Retained 24 часа. STALLED означает, что фоновый процесс больше не владеет lock; часть дат могла быть переписана, поэтому перед повтором нужен аудит по correlationId. Отмены нет: уже выполненные частичные перезаписи необратимы. Scope `read:campaigns`.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    workspaceId: components["parameters"]["WorkspaceIdPath"];
+                    correlationId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Состояние и terminal result/error */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["GetCourseAnchorRefreshStatusResponse"];
+                    };
+                };
+                404: components["responses"]["NotFound"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/getcourse-cold-welcome/batch": {
         parameters: {
             query?: never;
@@ -7788,6 +8000,13 @@ export interface paths {
                         "application/json": components["schemas"]["PlatformSetupMutationResult"];
                     };
                 };
+                /** @description Название триггера уже занято у этого агента */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         delete?: never;
@@ -7862,6 +8081,13 @@ export interface paths {
                         "application/json": components["schemas"]["PlatformSetupMutationResult"];
                     };
                 };
+                /** @description Название триггера уже занято у этого агента */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
             };
         };
         trace?: never;
@@ -8774,8 +9000,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Создать External API канал (provisioning)
-         * @description Возвращает apiKey + webhookSecret ОДИН раз. Scope `mcp:platform-setup` (или UI JWT).
+         * Создать External API канал и выдать browser-handoff ссылку
+         * @description Секреты не проходят через API/MCP-ответ. Scope `mcp:platform-setup` (или UI JWT).
          */
         post: {
             parameters: {
@@ -8792,13 +9018,13 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Канал создан (ключ и секрет показываются один раз) */
+                /** @description Канал создан; credentials покажет вошедшему человеку одноразовая страница */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ProvisionedExternalApiChannel"];
+                        "application/json": components["schemas"]["ExternalApiChannelCreated"];
                     };
                 };
             };
@@ -8818,7 +9044,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Перевыпустить bsl-ключ канала (старый отзывается) */
+        /** Выдать browser-handoff ссылку на перевыпуск bsl-ключа */
         post: {
             parameters: {
                 query?: never;
@@ -8831,15 +9057,13 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Новый ключ (показывается один раз) */
+                /** @description Ротация произойдёт только при открытии одноразовой страницы */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            apiKey: string;
-                        };
+                        "application/json": components["schemas"]["IssuedCredentialReveal"];
                     };
                 };
             };
@@ -8859,7 +9083,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Перевыпустить webhook-secret канала */
+        /** Выдать browser-handoff ссылку на замену webhook-secret */
         post: {
             parameters: {
                 query?: never;
@@ -8872,15 +9096,13 @@ export interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description Новый секрет (показывается один раз) */
+                /** @description Замена произойдёт только при открытии одноразовой страницы */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": {
-                            webhookSecret: string;
-                        };
+                        "application/json": components["schemas"]["IssuedCredentialReveal"];
                     };
                 };
             };
@@ -9158,6 +9380,81 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/contacts/{contactId}/diagnostics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Диагностика причин молчания, operator workflow, действий и доставки
+         * @description MCP-only read: возвращает метаданные и сохранённые evidence без тел сообщений, аргументов/результатов инструментов и raw error text. Отсутствующий production RAG trace помечается unknown, а не нулём.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    messageId?: string;
+                };
+                header?: never;
+                path: {
+                    contactId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            contact: {
+                                [key: string]: unknown;
+                            };
+                            platform: {
+                                [key: string]: unknown;
+                            } | null;
+                            message: {
+                                [key: string]: unknown;
+                            } | null;
+                            agent: {
+                                [key: string]: unknown;
+                            } | null;
+                            operatorEvents: {
+                                [key: string]: unknown;
+                            }[];
+                            triggerExecutions: {
+                                [key: string]: unknown;
+                            }[];
+                            toolExecutions: {
+                                [key: string]: unknown;
+                            }[];
+                            evidence: {
+                                [key: string]: unknown;
+                            };
+                            limitations: string[];
+                        };
+                    };
+                };
+                /** @description Контакт или выбранное сообщение не найдено в workspace */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/contacts/import": {
         parameters: {
             query?: never;
@@ -9246,21 +9543,63 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v2/contacts/export": {
+    "/api/v2/workspaces/{workspaceId}/getcourse-contact-imports/{jobId}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** Export contacts by filter */
-        post: {
+        /**
+         * Статус импорта GetCourse-контактов или одиночной cold-welcome отправки
+         * @description Возвращает только ImportJob типа GETCOURSE_CONTACTS в указанном workspace. PARTIAL и FAILED выводятся из terminal counters. Scope `launch:campaigns`, потому что этот же ключ запускает обе операции и `mcp:*` намеренно не включает массовое чтение контактов.
+         */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    workspaceId: components["parameters"]["WorkspaceIdPath"];
+                    jobId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["GetCourseContactImportStatusResponse"];
+                    };
+                };
+                404: components["responses"]["NotFound"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/contacts/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Export contacts by filter */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: {
@@ -12402,6 +12741,71 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/workbooks/{workbookId}/sheets/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Постранично прочитать диапазон листа без записи в знания
+         * @description Inspect возвращает только sample. Этот endpoint читает поздние строки и колонки,
+         *     возвращает явные признаки продолжения и fingerprint страницы. Для Google Sheets
+         *     точные total могут быть неизвестны и тогда возвращаются null.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    sheetTitle?: string;
+                    sheetGid?: number;
+                    sheetIndex?: number;
+                    rowOffset?: number;
+                    rowLimit?: number;
+                    columnOffset?: number;
+                    columnLimit?: number;
+                };
+                header?: never;
+                path: {
+                    workspaceId: components["parameters"]["WorkspaceIdPath"];
+                    workbookId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["WorkbookSheetPage"];
+                    };
+                };
+                /** @description Селектор листа неоднозначен или не подходит типу книги */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description SourceWorkbook */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/workbooks/{workbookId}/extract-amocrm-leads": {
         parameters: {
             query?: never;
@@ -12782,7 +13186,7 @@ export interface paths {
         put?: never;
         /**
          * Переиндексация knowledge space (re-embed Qa + KnowledgeChunk → Pinecone)
-         * @description Идемпотентная фоновая пересборка векторов из Postgres — восстанавливает поиск после рассинхрона Postgres↔Pinecone (v1.5 Increment 15). Возвращает job_id сразу; итог фоновой BullMQ-задачи `knowledge-namespace-reindex` — в логах воркера.
+         * @description Идемпотентная фоновая пересборка векторов из Postgres — восстанавливает поиск после рассинхрона Postgres↔Pinecone (v1.5 Increment 15). Возвращает job_id сразу; итог фоновой BullMQ-задачи доступен через status endpoint в течение 24 часов.
          */
         post: {
             parameters: {
@@ -12816,6 +13220,44 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/knowledge-spaces/{knowledgeSpaceId}/reindex/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Статус фоновой переиндексации knowledge space */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    workspaceId: components["parameters"]["WorkspaceIdPath"];
+                    knowledgeSpaceId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AsyncJobStatusResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/knowledge-spaces/{knowledgeSpaceId}/channel-links": {
         parameters: {
             query?: never;
@@ -13800,6 +14242,45 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/knowledge-spaces/{knowledgeSpaceId}/tables/{tableId}/reindex/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Статус фоновой переиндексации knowledge table */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    workspaceId: components["parameters"]["WorkspaceIdPath"];
+                    knowledgeSpaceId: string;
+                    tableId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AsyncJobStatusResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/variables": {
         parameters: {
             query?: never;
@@ -19352,6 +19833,91 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v2/workspaces/{workspaceId}/analytics/inbound/{report}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Агрегаты органических входящих диалогов */
+        get: operations["getInboundAnalytics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/analytics/funnel/{report}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Мета, сводка или недельные когорты воронки площадки */
+        get: operations["getFunnelAnalytics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/analytics/costs/{report}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Фактический AI usage ledger и его разрезы */
+        get: operations["getAiCosts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/custom-reports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Список сохранённых кастомных отчётов */
+        get: operations["listCustomReports"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/custom-reports/{reportId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Определение сохранённого кастомного отчёта */
+        get: operations["getCustomReport"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v2/workspaces/{workspaceId}/custom-reports/{reportId}/report": {
         parameters: {
             query?: never;
@@ -19372,7 +19938,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v2/workspaces/{workspaceId}/custom-reports/{reportId}/drilldown": {
+    "/api/v2/workspaces/{workspaceId}/operational-overview": {
         parameters: {
             query?: never;
             header?: never;
@@ -19380,10 +19946,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Контакты и сделки за числом сохранённой таблицы
-         * @description Возвращает конкретные исполнения, контакты или сделки за числовой ячейкой источников «Обзор», «Фоллоу-апы» и «Перс воронка». Сервер перечитывает определение отчёта и проверяет updatedAt; сводная передаёт полный путь строки. Snapshot и fingerprint обязательны только для personalized-источника. Для процентной колонки раскрывается фактический числитель.
+         * Эксплуатационная сводка воркспейса
+         * @description Возвращает состояние follow-up цепочек, расписаний и последних задач, безопасные метаданные ошибок действий и предупреждения с drill-down. Очередь операторов включается только когда effective scopes текущего вызова содержат read:conversations; иначе ответ явно сообщает missingScope.
          */
-        get: operations["getCustomReportDrilldown"];
+        get: operations["getWorkspaceOperationalOverview"];
         put?: never;
         post?: never;
         delete?: never;
@@ -19392,30 +19958,105 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-}
-export type webhooks = Record<string, never>;
-export interface components {
-    schemas: {
-        TriggerContactClaim: {
-            /** Format: uuid */
-            triggerId: string;
-            triggerName: string;
-            /** Format: uuid */
-            agentId: string;
-            agentName: string | null;
-            /** @enum {string} */
-            status: "IN_PROGRESS" | "COMPLETED";
-            /** Format: date-time */
-            claimedAt: string;
-            /** @description false у status=IN_PROGRESS — право держит владелец */
-            canReset: boolean;
-            /** @enum {string|null} */
-            blockedReason: "RUNNING" | null;
-            triggerIsEnabled: boolean;
-            /** @description Осталась ли включённой настройка «сработать один раз». Право переживает её выключение: тогда строка висит, но триггер срабатывает как обычный. */
-            stillOneTime: boolean;
-        };
-        TriggerContactClaimsPage: {
+    "/api/v2/workspaces/{workspaceId}/workspace-operators": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Системные операторы Besales для фильтра и назначения */
+        get: operations["listWorkspaceOperatorsForWorkflow"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/operator-queue": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Пагинированная очередь живых операторов */
+        get: operations["listWorkspaceOperatorQueue"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/chats/{contactId}/operator-assignment": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Текущее назначение оператора и CAS-версия */
+        get: operations["getWorkspaceOperatorAssignment"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Назначить, переназначить или снять системного оператора
+         * @description CAS-операция меняет только локальное назначение Besales. Она не меняет CRM operator, operatorStatus и не отправляет сообщение.
+         */
+        patch: operations["updateWorkspaceOperatorAssignment"];
+        trace?: never;
+    };
+    "/api/v2/workspaces/{workspaceId}/custom-reports/{reportId}/drilldown": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Контакты и сделки за числом сохранённой таблицы
+         * @description Возвращает конкретные исполнения, контакты или сделки за числовой ячейкой источников «Обзор», «Фоллоу-апы» и «Перс воронка». Сервер перечитывает определение отчёта и проверяет updatedAt; сводная передаёт полный путь строки. Snapshot и fingerprint обязательны только для personalized-источника. Для процентной колонки раскрывается фактический числитель.
+         */
+        get: operations["getCustomReportDrilldown"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        TriggerContactClaim: {
+            /** Format: uuid */
+            triggerId: string;
+            triggerName: string;
+            /** Format: uuid */
+            agentId: string;
+            agentName: string | null;
+            /** @enum {string} */
+            status: "IN_PROGRESS" | "COMPLETED";
+            /** Format: date-time */
+            claimedAt: string;
+            /** @description false у status=IN_PROGRESS — право держит владелец */
+            canReset: boolean;
+            /** @enum {string|null} */
+            blockedReason: "RUNNING" | null;
+            triggerIsEnabled: boolean;
+            /** @description Осталась ли включённой настройка «сработать один раз». Право переживает её выключение: тогда строка висит, но триггер срабатывает как обычный. */
+            stillOneTime: boolean;
+        };
+        TriggerContactClaimsPage: {
             claims: components["schemas"]["TriggerContactClaim"][];
             truncated: boolean;
         };
@@ -19469,6 +20110,125 @@ export interface components {
             dayOffset?: number;
             atTime?: string;
         };
+        /** @description Pass-through ответа канонической UI-витрины. Конкретная форма зависит от report и сохраняется без пересчёта адаптером; nullable и unknown-поля имеют доменный смысл. */
+        AnalyticsAggregateResponse: {
+            [key: string]: unknown;
+        };
+        OperationalOverviewWarning: {
+            /** @enum {string} */
+            severity: "info" | "warning" | "critical";
+            code: string;
+            sourceType: string;
+            sourceId: string;
+            /** Format: date-time */
+            occurredAt: string | null;
+            reason: string;
+            drilldown: {
+                type: string;
+                id: string;
+            };
+        };
+        OperationalOverviewResponse: {
+            /** Format: date-time */
+            generatedAt: string;
+            summary: {
+                [key: string]: number;
+            };
+            followUp: {
+                [key: string]: unknown;
+            };
+            schedules: {
+                [key: string]: unknown;
+            }[];
+            jobs: {
+                [key: string]: unknown;
+            }[];
+            actionErrors: {
+                [key: string]: unknown;
+            }[];
+            operatorQueue: {
+                [key: string]: unknown;
+            };
+            warnings: components["schemas"]["OperationalOverviewWarning"][];
+        };
+        WorkspaceOperatorOption: {
+            /** Format: uuid */
+            id: string;
+            displayName: string | null;
+            assignable: boolean;
+            /** @enum {string} */
+            operatorType: "WORKSPACE";
+        };
+        WorkspaceOperatorIdentity: {
+            /** Format: uuid */
+            id: string;
+            displayName: string | null;
+        };
+        OperatorWorkflowEvidence: {
+            /** Format: uuid */
+            id: string;
+            /** @enum {string} */
+            eventType: "OPERATOR_TAKEOVER" | "FINISH_RESOLVED";
+            /** Format: date-time */
+            occurredAt: string;
+        };
+        WorkspaceOperatorAssignmentState: {
+            /** Format: uuid */
+            contactId: string;
+            /** @enum {string|null} */
+            status: "WAITING_OPERATOR" | "IN_PROGRESS" | "WAITING_CUSTOMER" | "RESOLVED" | null;
+            /** Format: date-time */
+            statusUpdatedAt: string | null;
+            /** Format: uuid */
+            workspaceOperatorId: string | null;
+            /** Format: date-time */
+            assignedAt: string | null;
+            operatorDisplayName: string | null;
+            workflowEvidence: components["schemas"]["OperatorWorkflowEvidence"] | null;
+        };
+        OperatorQueueResponse: {
+            data: {
+                [key: string]: unknown;
+            }[];
+            page: number;
+            limit: number;
+            total: number;
+            hasMore: boolean;
+        };
+        UpdateWorkspaceOperatorAssignment: {
+            /** Format: uuid */
+            workspaceOperatorId: string | null;
+            /** Format: uuid */
+            expectedWorkspaceOperatorId: string | null;
+            /** Format: date-time */
+            expectedAssignedOperatorAt: string | null;
+        };
+        WorkspaceOperatorAssignmentResult: {
+            changed: boolean;
+            assignedOperator: components["schemas"]["WorkspaceOperatorIdentity"] | null;
+            /** Format: date-time */
+            assignedOperatorAt: string | null;
+        };
+        CustomReportDefinition: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+            sourceKey: string;
+            section: string;
+            view: string;
+            filters: {
+                [key: string]: unknown;
+            };
+            dimensionValues: string[];
+            rowDimensions: string[];
+            metricKeys: string[];
+            /** Format: date-time */
+            archivedAt?: string | null;
+            /** Format: date-time */
+            createdAt?: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
         CustomReportDataResponse: {
             metricKeys: string[];
             dimensionValues: string[];
@@ -19751,6 +20511,10 @@ export interface components {
             createdAfter?: string;
             contacts?: components["schemas"]["GetCourseColdWelcomeContact"][];
             channels?: components["schemas"]["GetCourseTransport"][];
+            /** @description Метка сегмента запуска. Ею считается правило «этим сегментом человеку уже уходило»: без неё прогноз правил (policyForecast) по этому правилу структурно пуст, и ноль читается как «проверили, никого». Аудиторию метка не отбирает. */
+            segment?: string;
+            /** @description Разовый текст запуска — им считается правило «тот же текст не дважды» (журнал касаний ключуется отпечатком шаблона). Для запуска с сохранённой рассылкой не нужен: текст берётся из неё тем же резолвером, что на старте, включая посегментные тексты. */
+            message?: string;
             /** @deprecated */
             channelsMode?: components["schemas"]["ColdWelcomeChannelsMode"];
         };
@@ -19761,6 +20525,23 @@ export interface components {
          */
         ColdWelcomeChannelsMode: "RESTRICT" | "ADD";
         GetCourseColdWelcomePreviewResponse: {
+            /** @description ПРОГНОЗ ПРАВИЛ ОТПРАВКИ на момент запроса, а не обещание. Блокирует одна точка — пересчёт правил постранично вплотную к транспорту, и между предпросмотром и отправкой человек успевает зарегистрироваться на эфир или получить это же касание другим запуском. Причины ВЗАИМНО ИСКЛЮЧАЮТ друг друга (сервер возвращает первую сработавшую), поэтому сумма — это ЛЮДИ, а не срабатывания. Считается по МЕТКЕ и ТЕКСТУ запроса: без segment (и без message у запуска разовым текстом) соответствующие правила дают нули. */
+            policyForecast?: {
+                blockedBy: {
+                    /** @description Этим сегментом человеку уже уходило НАШЕЙ отправкой. Периметр строго наш (волна школы тем же ярлыком отправкой здесь не считается — иначе запрет накрыл бы 37 % отправок; замер прода 10.09.2026). */
+                    alreadySentSegment: number;
+                    /** @description Уже получал «Первое сообщение» — оно одноразово НА ЧЕЛОВЕКА. */
+                    alreadyGreeted: number;
+                    /** @description Идёт эпизод регистрации: приветствие ДОЛЖНЫ и не отдали либо подготовлен повторный вход на новый эфир. Считается ПО ЧЕЛОВЕКУ, без скоупа площадки. */
+                    activeEpisode: number;
+                    /** @description Тихий период: человека трогали (нашей отправкой либо шагом календарной цепочки) внутри окна. Окно резолвится настройками — перекрытие рассылки, затем площадка, затем воркспейс, затем 0. По умолчанию 0, то есть правило выключено, пока оператор его не выставит; рекомендация — 7 суток. Волна школы касанием НЕ считается. Расписания судятся своим cooldownDays. */
+                    cooldown: number;
+                };
+                /** @description Тот же ТЕКСТ уже занят в журнале касаний под ДРУГИМ ярлыком. Отдельно от blockedBy: это не правило владельца, а атомарное право — «тот же текст не дважды» держится строкой журнала, а не читающей проверкой. */
+                touchClaimed: number;
+                /** @description ИНФОРМАЦИЯ, а не запрет: этим же ярлыком человека рассылал ВНЕШНИЙ механизм — волна школы своими процессами либо шаблон Wazzup. Наш догон в мессенджерах уйдёт как обычно: так работает штатный процесс. В отсев это число НЕ входит. */
+                externalWaveTouched: number;
+            };
             /** @description Выбранные каналы, которых НЕТ в allowlist площадки: они не уедут ни в каком режиме. Чинится галочкой в настройках площадки, поэтому возвращаются ИМЕНАМИ, а не числом. */
             channelsNotAllowedByPlatform?: components["schemas"]["GetCourseTransport"][];
             /** @description Сколько ещё МОЖЕТ получить первое сообщение. */
@@ -19809,6 +20590,28 @@ export interface components {
             alreadyRunning: boolean;
             refreshableVariables: string[];
         };
+        GetCourseAnchorRefreshStatusResponse: {
+            correlationId: string;
+            /** Format: uuid */
+            platformId: string;
+            /** @enum {string} */
+            status: "RUNNING" | "COMPLETED" | "FAILED" | "STALLED";
+            result: {
+                correlationId: string;
+                contactsScanned: number;
+                outcomes: {
+                    [key: string]: number;
+                };
+                changedByVariable: {
+                    [key: string]: number;
+                };
+            } | null;
+            error: string | null;
+            /** Format: date-time */
+            startedAt: string;
+            /** Format: date-time */
+            finishedAt: string | null;
+        };
         /** @description Ровно один источник текста (message ЛИБО mailingVariantId) и ровно одна аудитория (createdAfter ЛИБО contacts). */
         GetCourseColdWelcomeLaunchRequest: {
             /**
@@ -20181,6 +20984,32 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        TriggerActionCatalogItem: {
+            actionType: string;
+            title: string;
+            configInputKey: string | null;
+            responseRelation: string | null;
+            configRequired: boolean;
+            /** @enum {string} */
+            requiredScope: "mcp:platform-setup";
+            requiredRelations: string[];
+            effect: string;
+            verification: string;
+            actionSchema: {
+                [key: string]: unknown;
+            };
+            minimalExample: {
+                [key: string]: unknown;
+            };
+        };
+        TriggerActionCatalogResponse: {
+            /** @enum {string} */
+            source: "CreateTriggerActionDto+TRIGGER_ACTION_CONFIG";
+            /** @enum {boolean} */
+            complete: true;
+            total: number;
+            items: components["schemas"]["TriggerActionCatalogItem"][];
+        };
         ConfirmableSetupMutation: {
             explicitConfirmation?: boolean;
             confirmationReason?: string;
@@ -20399,7 +21228,9 @@ export interface components {
             updatedAt?: string;
         };
         TriggerUpsertRequest: components["schemas"]["ConfirmableSetupMutation"] & {
+            /** @description Название, уникальное в рамках агента. Потолок общий с формой интерфейса — канон AGENT_TRIGGER_NAME_MAX_LENGTH (ai-aniomaly/src/core/application/tools/constants/agent-trigger.constants.ts). */
             name?: string;
+            /** @description Условие срабатывания; уходит в системный промпт агента целиком. Потолок общий с формой интерфейса — канон AGENT_TRIGGER_CONDITION_MAX_LENGTH (ai-aniomaly/src/core/application/tools/constants/agent-trigger.constants.ts). */
             condition?: string;
             isEnabled?: boolean;
             priority?: number;
@@ -20864,6 +21695,10 @@ export interface components {
                 guardActiveSeries?: components["schemas"]["OutboundGuardMode"];
                 guardActiveApplication?: components["schemas"]["OutboundGuardMode"];
                 guardPaid?: components["schemas"]["OutboundGuardMode"];
+                /** @description Quiet period in days after ANY touch OF OURS (a send or a calendar-chain follow-up step). Counted PER PERSON across the workspace; a school wave does NOT count as a touch (measured: the wide perimeter would have blocked 15.3% of our sends). null = not configured, effective value 0 (rule disabled); the owner recommends 7. Schedules are NOT judged by this number — they have their own cooldownDays. */
+                quietDays?: number | null;
+                /** @description How many days the school's "no linked messengers" answer stays trusted. While it is fresh, the contact import neither creates a card nor asks the school again, and schedule selection does not feed that person. null = not configured, effective value 7; 0 = ask the school every time. */
+                reachabilityTtlDays?: number | null;
                 /** @description Transport → exact deal custom field NAME (read API returns no field ids). Clear with {}. */
                 deliveryFieldMap?: {
                     [key: string]: string;
@@ -21049,6 +21884,50 @@ export interface components {
                 suggestedNextPhase: "1" | "2" | "3" | "4" | "5" | "6" | null;
             };
         };
+        WorkspaceNavigationRequest: {
+            /** @enum {string} */
+            intent: "CREATE_BOT" | "IMPROVE_AGENT" | "DIAGNOSE_CONTACT" | "AUDIT_DIALOGUES" | "CAMPAIGN_REPORT" | "CONNECT_CRM" | "CONNECT_DATASOURCE" | "CONFIGURE_FOLLOWUP" | "CONTINUE_TASK" | "FREEFORM";
+            /** @enum {string} */
+            botType?: "FAQ" | "SALES" | "BOOKING" | "OUTBOUND" | "SUPPORT" | "UNKNOWN";
+            /** Format: uuid */
+            platformId?: string;
+            /** Format: uuid */
+            agentId?: string;
+            /** Format: uuid */
+            contactId?: string;
+            /** Format: uuid */
+            taskId?: string;
+            question?: string;
+        };
+        WorkspaceNavigationResponse: {
+            objective: string;
+            intent: components["schemas"]["WorkspaceNavigationRequest"]["intent"];
+            /** @enum {string|null} */
+            botType: "FAQ" | "SALES" | "BOOKING" | "OUTBOUND" | "SUPPORT" | "UNKNOWN" | null;
+            selectedObjects: {
+                type: string;
+                id: string;
+                label: string | null;
+            }[];
+            completed: string[];
+            missing: string[];
+            requiredUserInput: {
+                field: string;
+                reason: string;
+                options?: string[];
+            }[];
+            next: {
+                tool: string;
+                arguments: {
+                    [key: string]: unknown;
+                };
+                reason: string;
+                verifyWith: string;
+            } | null;
+            finishCondition: string;
+            /** @enum {string} */
+            evidenceSource: "live_workspace_overview";
+        };
         CreateSetupSessionRequest: {
             /** Format: uuid */
             workspaceId: string;
@@ -21447,6 +22326,8 @@ export interface components {
             writtenAt?: string;
         };
         StartSandboxRunRequest: {
+            /** @description Неактивированный системный промпт для изолированной проверки. Допустим только при options.mode=single_agent, действует лишь внутри sandbox run и не меняет production AgentChat или PromptVersion. */
+            candidatePrompt?: string;
             /** @description Test scenarios to run (default — all linked to agent's ICP) */
             scenarioIds?: string[];
             options?: {
@@ -22247,15 +23128,21 @@ export interface components {
             callbackUrl?: string;
             sourceChannel?: string;
         };
-        ProvisionedExternalApiChannel: {
+        IssuedCredentialReveal: {
+            /** @description Одноразовая ссылка для вошедшего человека */
+            revealUrl: string;
+            /** Format: date-time */
+            revealExpiresAt: string;
+        };
+        ExternalApiChannelCreated: {
             /** Format: uuid */
             channelId: string;
-            /** @description Bearer-ключ партнёра для входящих (показывается ОДИН раз) */
-            apiKey: string;
-            /** @description Секрет HMAC-подписи колбэков (показывается ОДИН раз) */
-            webhookSecret: string;
             /** @description Путь приёма входящих: /api/v2/channels/{channelId}/messages */
             ingestPath: string;
+            /** @description Одноразовая ссылка для вошедшего человека */
+            revealUrl: string;
+            /** Format: date-time */
+            revealExpiresAt: string;
         };
         /** @enum {string} */
         CallDirection: "Inbound" | "Outbound";
@@ -23690,6 +24577,23 @@ export interface components {
             checkerEnabled?: boolean;
             errorReasons?: string[];
         };
+        GetCourseContactImportStatusResponse: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            workspaceId: string;
+            /** @enum {string} */
+            status: "RUNNING" | "COMPLETED" | "PARTIAL" | "FAILED";
+            totalRows: number;
+            processedRows: number;
+            successCount: number;
+            failedCount: number;
+            errorReasons: string[];
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            completedAt: string | null;
+        };
         ContactExportRequest: {
             /** Format: uuid */
             workspaceId?: string;
@@ -23935,6 +24839,8 @@ export interface components {
             defaultPlatformId: string | null;
             defaultChannels: string[];
             defaultDealFields: Record<string, never> | null;
+            /** @description Quiet-period override for this mailing, in days. 0 means "this text may be sent inside the quiet period" — that IS the permission. null means the mailing does not override; the platform setting applies, then the workspace one, then 0. */
+            quietDaysOverride: number | null;
         };
         CreateBroadcastMailingVariantRequest: {
             name: string;
@@ -23951,6 +24857,8 @@ export interface components {
             defaultPlatformId?: string | null;
             defaultChannels?: string[];
             defaultDealFields?: Record<string, never> | null;
+            /** @description Quiet-period override for this mailing, in days. 0 means "this text may be sent inside the quiet period" — that IS the permission. null means the mailing does not override; the platform setting applies, then the workspace one, then 0. */
+            quietDaysOverride?: number | null;
         };
         UpdateBroadcastMailingVariantRequest: {
             name?: string;
@@ -23968,6 +24876,8 @@ export interface components {
             defaultPlatformId?: string | null;
             defaultChannels?: string[];
             defaultDealFields?: Record<string, never> | null;
+            /** @description Quiet-period override for this mailing, in days. 0 means "this text may be sent inside the quiet period" — that IS the permission. null means the mailing does not override; the platform setting applies, then the workspace one, then 0. */
+            quietDaysOverride?: number | null;
         };
         WorkspaceLinkDomain: {
             /**
@@ -24268,7 +25178,9 @@ export interface components {
             indirect: number;
             indirectAmount: number;
             notSent: {
-                total: number;
+                /** @description Всего не отправлено по этой волне. null — «не выяснено», а НЕ ноль: активен фильтр по измерению (воронка/сегмент/продукт), а снимок волны его не несёт — волна охватила несколько воронок. Отсев принадлежит ВОЛНЕ, у отсеянного своей воронки нет (он отсеян до отправки), поэтому какой воронке достался этот отсев — неизвестно. Ноль означал бы «никого не отсеяли», а полное число волны — цифру, за которой откроется пустой список. */
+                total: number | null;
+                /** @description Пусто, когда total = null. */
                 byReason: {
                     [key: string]: number;
                 };
@@ -24300,6 +25212,8 @@ export interface components {
             total: number;
             failedDelivery: number;
             byDayProduct: components["schemas"]["BroadcastSkipDayProduct"][];
+            /** @description Отсев волн, который выбранный фильтр по измерению не относит ни к одному своему значению: волна охватила несколько воронок/сегментов/продуктов, и снимок оставил ось пустой. Отсев принадлежит ВОЛНЕ — у отсеянного контакта своей воронки нет, он отсеян до отправки и строки реестра не имеет. Показывать обязательно: у Ксаматы за август 2026 таких 7157 из 9674, то есть разрез по воронкам покрывает лишь четверть отсева. 0 — фильтра по измерению нет либо распределено всё. */
+            unattributed: number;
         };
         BroadcastRecipientItem: {
             /** Format: uuid */
@@ -25276,13 +26190,14 @@ export interface components {
         SandboxFinding: {
             /** Format: uuid */
             scenarioId?: string | null;
+            turnIndex?: number;
             /** @enum {string} */
-            category: "hallucination" | "wrong_action" | "wrong_routing" | "missed_trigger" | "wrong_pipeline_transition" | "rag_miss" | "bad_tone" | "other";
+            category: "hallucination" | "wrong_action" | "wrong_routing" | "missed_context" | "rag_miss" | "bad_tone" | "off_topic" | "contradiction" | "other";
             /** @enum {string} */
             severity: "low" | "medium" | "critical";
-            message: string;
-            suggestion?: string;
-            turnIndex?: number;
+            description: string;
+            evidence?: string;
+            recommendation?: string;
         };
         /** @enum {string} */
         SourceWorkbookKind: "XLSX_UPLOAD" | "GOOGLE_SHEETS";
@@ -25337,11 +26252,22 @@ export interface components {
             /** @description Для Google Sheets — числовой gid */
             sheetGid?: number;
             sheetIndex: number;
-            rowCount: number;
-            columnCount: number;
+            rowCount: number | null;
+            columnCount: number | null;
+            dimensionsKnown: boolean;
+            /** @description Источник содержит строки за доступной parser-границей. */
+            rowsTruncated?: boolean;
+            /** @description Граница полного обхода Google grid; может включать пустые строки. */
+            scanUpperBoundRowCount?: number;
+            /** @description Граница полного обхода Google grid; может включать пустые колонки. */
+            scanUpperBoundColumnCount?: number;
             sampleRows: components["schemas"]["SheetCellMetadata"][][];
             hyperlinkStats: components["schemas"]["ColumnLinkStats"][];
             truncated: boolean;
+            readError?: {
+                code: string;
+                message: string;
+            };
         };
         InspectWorkbookResponse: {
             workbook: components["schemas"]["SourceWorkbook"];
@@ -25349,6 +26275,35 @@ export interface components {
             totalSampleCells: number;
             globallyTruncated: boolean;
         };
+        WorkbookSheetPage: {
+            /** Format: uuid */
+            workbookId: string;
+            sourceIdentity: string;
+            sheetTitle: string;
+            sheetGid?: number;
+            sheetIndex: number;
+            rowOffset: number;
+            rowLimit: number;
+            returnedRowCount: number;
+            columnOffset: number;
+            columnLimit: number;
+            returnedColumnCount: number;
+            totalRowCount: number | null;
+            totalColumnCount: number | null;
+            dimensionsKnown: boolean;
+            /** @description Часть источника лежит за доступной scan-границей; полный вывод делать нельзя. */
+            sourceTruncated?: boolean;
+            /** @description Граница, до которой надо пройти rowOffset для полного обхода. */
+            scanUpperBoundRowCount: number;
+            /** @description Граница, до которой надо пройти columnOffset для полного обхода. */
+            scanUpperBoundColumnCount: number;
+            rows: components["schemas"]["SheetCellMetadata"][][];
+            hasMoreRows: boolean;
+            hasMoreColumns: boolean;
+            nextRowOffset: number | null;
+            nextColumnOffset: number | null;
+            pageFingerprint: string;
+        };
         WorkbookInspectError: {
             /** @enum {string} */
             error: "google_sheets_not_shared";
@@ -25794,8 +26749,9 @@ export interface components {
             limit?: number;
         };
         KnowledgeTableReindexResponse: {
+            job_id: string;
             /**
-             * @description QUEUED — reindex поставлен в фоновую очередь (для крупных источников вроде каталога 1С); опрашивай GET .../tables/:id → last_success_at для подтверждения завершения. INDEXED/SKIPPED — legacy синхронный результат.
+             * @description QUEUED — reindex поставлен в фоновую очередь (для крупных источников вроде каталога 1С); опрашивай GET .../tables/:id/reindex/status для подтверждения завершения. INDEXED/SKIPPED — legacy синхронный результат.
              * @enum {string}
              */
             status: "QUEUED" | "INDEXED" | "SKIPPED";
@@ -25803,6 +26759,20 @@ export interface components {
             /** Format: date-time */
             indexed_at: string;
         };
+        AsyncJobStatusResponse: {
+            job_id: string;
+            /** @enum {string} */
+            status: "QUEUED" | "RUNNING" | "COMPLETED" | "FAILED" | "EXPIRED";
+            progress: unknown;
+            result: unknown;
+            error: string | null;
+            /** Format: date-time */
+            queued_at: string | null;
+            /** Format: date-time */
+            started_at: string | null;
+            /** Format: date-time */
+            finished_at: string | null;
+        };
         /** @enum {string} */
         VariableType: "TEXT" | "NUMBER" | "FLOAT" | "BOOLEAN";
         VariableResponse: {
@@ -26437,20 +27407,65 @@ export interface components {
 }
 export type $defs = Record<string, never>;
 export interface operations {
-    startIcpAudioImportRun: {
+    AgentReadinessController_get: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["StartIcpAudioImportRequest"];
+            path: {
+                agentId: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
-            /** @description Run accepted, items scheduled */
+            /** @description NOT_PROVEN с отдельными gates; configurationCurrent null до фиксации полной версии зависимых настроек, promptAndAgentCurrent проверяет только промпт и запись агента */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    navigateWorkspaceTask: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WorkspaceNavigationRequest"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceNavigationResponse"];
+                };
+            };
+        };
+    };
+    startIcpAudioImportRun: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["StartIcpAudioImportRequest"];
+            };
+        };
+        responses: {
+            /** @description Run accepted, items scheduled */
             202: {
                 headers: {
                     [name: string]: unknown;
@@ -26588,6 +27603,62 @@ export interface operations {
             };
         };
     };
+    getContactTouchHistory: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                /** @description GetCourse school-side person id (getcourse_user_id). */
+                gcUserId: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        getcourseUserId: number;
+                        /** Format: date-time */
+                        firstWelcomeAt: string | null;
+                        /** @description More journal rows exist than fit in this response. */
+                        truncated: boolean;
+                        touches: {
+                            /** @description Touch name = the right key. Four kinds: a segment label, `text:<template fingerprint>`, `registration:<deal>`, and `legacy:welcome` (a right restored by backfill for the period before the journal existed). */
+                            touchKey: string;
+                            /** @enum {string} */
+                            kind: "FIRST" | "REPEAT" | "REGISTRATION";
+                            /** @enum {string} */
+                            status: "CLAIMED" | "SENT" | "UNKNOWN" | "RELEASED";
+                            /** Format: date-time */
+                            claimedAt: string;
+                            /** Format: date-time */
+                            sentAt: string | null;
+                            /** @description Empty for rows written before 2026-09-09 — the column did not exist yet. */
+                            mailingName: string | null;
+                            /** Format: uuid */
+                            platformId: string | null;
+                            lastError: string | null;
+                        }[];
+                        sends: {
+                            segment: string | null;
+                            /** @enum {string} */
+                            mode: "cold_welcome" | "registration_welcome" | "scheduled";
+                            /** Format: date-time */
+                            receivedAt: string;
+                            /** Format: uuid */
+                            platformId: string | null;
+                        }[];
+                    };
+                };
+            };
+        };
+    };
     listWorkspaceDataSources: {
         parameters: {
             query?: never;
@@ -26665,6 +27736,159 @@ export interface operations {
             };
         };
     };
+    getInboundAnalytics: {
+        parameters: {
+            query?: {
+                platformId?: string;
+                channels?: string[];
+                mode?: "all" | "days" | "range";
+                days?: number;
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                report: "summary" | "topics" | "speed" | "money" | "cycle" | "quality";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Канонический ответ выбранной входящей витрины; null не заменяется нулём. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsAggregateResponse"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getFunnelAnalytics: {
+        parameters: {
+            query: {
+                platformId: string;
+                from?: string;
+                to?: string;
+                view?: "cohort" | "period";
+                managerId?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                report: "meta" | "summary" | "cohorts";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Канонический ответ воронки с неизменным view и зерном. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsAggregateResponse"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getAiCosts: {
+        parameters: {
+            query?: {
+                mode?: "all" | "days" | "range";
+                days?: number;
+                from?: string;
+                to?: string;
+                scope?: "production" | "with_tests";
+                groupBy?: "customer" | "platform" | "tag" | "operation" | "provider";
+                page?: number;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                report: "summary" | "tasks" | "breakdown";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ledger с отдельным числом priced и unpriced usage events. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnalyticsAggregateResponse"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    listCustomReports: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Неархивированные определения отчётов. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        items: components["schemas"]["CustomReportDefinition"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getCustomReport: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                reportId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Определение и версия отчёта. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomReportDefinition"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     getCustomReportData: {
         parameters: {
             query: {
@@ -26696,6 +27920,141 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    getWorkspaceOperationalOverview: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Текущее состояние и приоритетные предупреждения. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperationalOverviewResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    listWorkspaceOperatorsForWorkflow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Только workspace operators; CRM operators в ответ не входят. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceOperatorOption"][];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    listWorkspaceOperatorQueue: {
+        parameters: {
+            query?: {
+                status?: "WAITING_OPERATOR" | "IN_PROGRESS" | "WAITING_CUSTOMER" | "RESOLVED";
+                workspaceOperatorId?: string;
+                contactId?: string;
+                page?: number;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Текущее состояние и последнее связанное доказательство workflow. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OperatorQueueResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getWorkspaceOperatorAssignment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                contactId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Назначение, статус и доказательство workflow. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceOperatorAssignmentState"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    updateWorkspaceOperatorAssignment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceIdPath"];
+                contactId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWorkspaceOperatorAssignment"];
+            };
+        };
+        responses: {
+            /** @description Фактически сохранённое назначение. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceOperatorAssignmentResult"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
     getCustomReportDrilldown: {
         parameters: {
             query: {