@besales/mcp 0.47.1 → 1.0.0-beta.2

package/dist/tools/definitions/knowledge-chunking.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+/**
+ * Правила разбиения документа знаний: отгруженная форма `split_override` → правила сервера v2.
+ *
+ * ⛔ Форма поля — буква в букву как у отгруженного моста (иначе сравнение схем дало бы строки отставания). Потолок v2
+ * (кусок больше 2000 знаков сервер не принимает; у прежней системы потолка не было) проверяется ТОЛЬКО у поля, которое
+ * в выбранном режиме уходит на сервер: второе прежняя система в этом режиме не читала, и отказ по нему отверг бы вызов,
+ * который она принимала. Несовместимое сочетание — отказ схемы С ПУТЁМ поля, а не отказ сервера: прежняя система на
+ * перекрытии не меньше размера падала пятисоткой.
+ */
+export const KNOWLEDGE_CHUNK_SIZE_MAX = 2000;
+const KNOWLEDGE_CHUNK_SIZE_MIN = 100;
+/** Умолчания сервера — по ним считается действующее перекрытие, когда поле не передано. */
+const SERVER_DEFAULT_CHUNK_SIZE = 1000;
+const SERVER_DEFAULT_CHUNK_OVERLAP = 200;
+export const splitOverrideSchema = z.object({
+    split_mode: z.enum(['size', 'separator']),
+    separator: z.string().optional(),
+    chunk_size: z.number().int().min(KNOWLEDGE_CHUNK_SIZE_MIN).optional(),
+    chunk_overlap: z.number().int().min(0).optional(),
+    max_chunk_size: z.number().int().min(KNOWLEDGE_CHUNK_SIZE_MIN).optional(),
+});
+/**
+ * Перевод формы прежней системы:
+ * - `size` — рекурсивная нарезка по размеру (у прежней системы — рекурсивный разделитель; `separator` и
+ *   `max_chunk_size` в этом режиме она молча игнорировала — не переносятся, иначе правило «размер не больше потолка»
+ *   отвергло бы вызов, который она принимала);
+ * - `separator` — раздел по разделителю, раздел длиннее `max_chunk_size` (по умолчанию потолок) дорезается; `chunk_size`
+ *   в этом режиме прежняя система не читала. ⛔ Её баг (склейка разделов обратно до 100 000 знаков) не переносится:
+ *   раздел — граница куска.
+ */
+export function toV2Chunking(override) {
+    if (override.split_mode === 'size') {
+        return {
+            strategy: 'RECURSIVE',
+            ...(override.chunk_size === undefined ? {} : { chunkSize: override.chunk_size }),
+            ...(override.chunk_overlap === undefined ? {} : { chunkOverlap: override.chunk_overlap }),
+        };
+    }
+    const size = override.max_chunk_size ?? KNOWLEDGE_CHUNK_SIZE_MAX;
+    return {
+        strategy: 'SEPARATOR',
+        separator: override.separator,
+        chunkSize: size,
+        maxChunkSize: size,
+        ...(override.chunk_overlap === undefined ? {} : { chunkOverlap: override.chunk_overlap }),
+    };
+}
+/** Отказы сочетаний — с путём поля, до запроса. */
+export function refineSplitOverride(value, ctx, basePath = ['split_override']) {
+    if (value === undefined)
+        return;
+    if (value.split_mode === 'separator' && (value.separator === undefined || value.separator === '')) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: [...basePath, 'separator'],
+            message: 'split_mode=separator требует непустой separator',
+        });
+    }
+    // Поле размера, которое в этом режиме уходит на сервер: у size — chunk_size, у separator — max_chunk_size.
+    const sizeField = value.split_mode === 'size' ? 'chunk_size' : 'max_chunk_size';
+    const sentSize = value.split_mode === 'size' ? value.chunk_size : value.max_chunk_size;
+    if (sentSize !== undefined && sentSize > KNOWLEDGE_CHUNK_SIZE_MAX) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: [...basePath, sizeField],
+            message: `кусок не больше ${KNOWLEDGE_CHUNK_SIZE_MAX} знаков`,
+        });
+        return;
+    }
+    const size = value.split_mode === 'size'
+        ? (value.chunk_size ?? SERVER_DEFAULT_CHUNK_SIZE)
+        : (value.max_chunk_size ?? KNOWLEDGE_CHUNK_SIZE_MAX);
+    const overlap = value.chunk_overlap ?? SERVER_DEFAULT_CHUNK_OVERLAP;
+    if (overlap >= size) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: [...basePath, 'chunk_overlap'],
+            message: `перекрытие (${overlap}) должно быть меньше размера куска (${size}); без chunk_overlap действует ${SERVER_DEFAULT_CHUNK_OVERLAP}`,
+        });
+    }
+}
+//# sourceMappingURL=knowledge-chunking.js.map

package/dist/tools/definitions/knowledge-chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-chunking.js","sourceRoot":"","sources":["../../../src/tools/definitions/knowledge-chunking.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions/knowledge-space-search-fields.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const knowledgeSpaceCreateDescription = "\u0421\u043E\u0437\u0434\u0430\u0442\u044C \u0431\u0430\u0437\u0443 \u0437\u043D\u0430\u043D\u0438\u0439 \u0434\u043B\u044F \u0440\u0430\u0431\u043E\u0447\u0435\u0439 \u043E\u0431\u043B\u0430\u0441\u0442\u0438 \u0438\u043B\u0438 \u043E\u0442\u0434\u0435\u043B\u044C\u043D\u043E\u0433\u043E \u043A\u0430\u043D\u0430\u043B\u0430. \u0412\u043E\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0438\u0434\u0435\u043D\u0442\u0438\u0444\u0438\u043A\u0430\u0442\u043E\u0440 \u0434\u043B\u044F \u0434\u043E\u0431\u0430\u0432\u043B\u0435\u043D\u0438\u044F \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u043E\u0432. \u041D\u0430\u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u043F\u043E\u043C\u043E\u0433\u0430\u0435\u0442 \u0430\u0433\u0435\u043D\u0442\u0443 \u0432\u044B\u0431\u0440\u0430\u0442\u044C \u0431\u0430\u0437\u0443 \u043F\u043E \u0437\u0430\u043F\u0440\u043E\u0441\u0443; \u0441\u043B\u043E\u0432\u0430 \u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u044C\u043D\u043E\u0433\u043E \u043F\u043E\u0438\u0441\u043A\u0430 \u0434\u043E\u0431\u0430\u0432\u043B\u044F\u044E\u0442 \u0435\u0451 \u0432 \u043F\u043E\u0438\u0441\u043A \u043F\u0440\u0438 \u043E\u0442\u0432\u0435\u0442\u0435 \u0442\u043E\u043B\u044C\u043A\u043E \u0441\u0440\u0435\u0434\u0438 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B\u0445 \u0430\u043A\u0442\u0438\u0432\u043D\u044B\u0445 \u0431\u0430\u0437.";
+export declare const knowledgeSpacePatchDescription = "\u0418\u0437\u043C\u0435\u043D\u0438\u0442\u044C \u0438\u043C\u044F, \u0440\u0435\u0436\u0438\u043C \u043F\u043E\u0438\u0441\u043A\u0430, \u043D\u0430\u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 \u0438\u043B\u0438 \u0441\u043B\u043E\u0432\u0430 \u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u044C\u043D\u043E\u0433\u043E \u043F\u043E\u0438\u0441\u043A\u0430 \u0431\u0430\u0437\u044B \u0437\u043D\u0430\u043D\u0438\u0439. \u041E\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044E\u0449\u0438\u0435 \u043F\u043E\u043B\u044F \u0441\u043E\u0445\u0440\u0430\u043D\u044F\u044E\u0442 \u043F\u0440\u0435\u0436\u043D\u0438\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F. \u0421\u043B\u043E\u0432\u0430 \u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u044C\u043D\u043E\u0433\u043E \u043F\u043E\u0438\u0441\u043A\u0430 \u0434\u043E\u0431\u0430\u0432\u043B\u044F\u044E\u0442 \u0431\u0430\u0437\u0443 \u0432 \u043F\u043E\u0438\u0441\u043A \u043F\u0440\u0438 \u043E\u0442\u0432\u0435\u0442\u0435 \u0442\u043E\u043B\u044C\u043A\u043E \u0441\u0440\u0435\u0434\u0438 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B\u0445 \u0430\u043A\u0442\u0438\u0432\u043D\u044B\u0445 \u0431\u0430\u0437, \u0432\u043A\u043B\u044E\u0447\u0430\u044F \u0431\u0430\u0437\u044B \u043F\u043E \u0437\u0430\u043F\u0440\u043E\u0441\u0443.";
+/** Одинаковые ограничения и подсказки при создании и частичной правке базы. */
+export declare const knowledgeSpaceSearchFields: {
+    access_mode: z.ZodOptional<z.ZodEnum<{
+        AUTO_QUERY: "AUTO_QUERY";
+        TOOL_ONLY: "TOOL_ONLY";
+    }>>;
+    purpose: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    search_keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+};

package/dist/tools/definitions/knowledge-space-search-fields.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+const PURPOSE_MAX_LENGTH = 300;
+const KEYWORDS_MAX_COUNT = 30;
+const KEYWORD_MAX_LENGTH = 60;
+export const knowledgeSpaceCreateDescription = 'Создать базу знаний для рабочей области или отдельного канала. Возвращает идентификатор для добавления источников. Назначение помогает агенту выбрать базу по запросу; слова обязательного поиска добавляют её в поиск при ответе только среди доступных активных баз.';
+export const knowledgeSpacePatchDescription = 'Изменить имя, режим поиска, назначение или слова обязательного поиска базы знаний. Отсутствующие поля сохраняют прежние значения. Слова обязательного поиска добавляют базу в поиск при ответе только среди доступных активных баз, включая базы по запросу.';
+/** Одинаковые ограничения и подсказки при создании и частичной правке базы. */
+export const knowledgeSpaceSearchFields = {
+    access_mode: z
+        .enum(['AUTO_QUERY', 'TOOL_ONLY'])
+        .optional()
+        .describe('Включать базу в автоматический поиск или открывать по запросу агента. В обоих режимах слова обязательного поиска добавляют доступную активную базу в поиск при ответе при совпадении с вопросом.'),
+    purpose: z
+        .string()
+        .refine((value) => Array.from(value).length <= PURPOSE_MAX_LENGTH)
+        .meta({ maxLength: PURPOSE_MAX_LENGTH })
+        .nullable()
+        .optional()
+        .describe('Назначение базы для агента; помогает выбрать базу по запросу. Пустое значение стирает назначение.'),
+    search_keywords: z
+        .array(z
+        .string()
+        .refine((value) => Array.from(value.trim()).length >= 1 &&
+        Array.from(value.trim()).length <= KEYWORD_MAX_LENGTH)
+        .meta({ minLength: 1, maxLength: KEYWORD_MAX_LENGTH }))
+        .max(KEYWORDS_MAX_COUNT)
+        .optional()
+        .describe('Слова и фразы обязательного поиска: совпадение с началом слова в вопросе добавляет базу в поиск при ответе, даже если она открывается по запросу. Работают только внутри доступных активных баз. Пустой список стирает слова.'),
+};
+//# sourceMappingURL=knowledge-space-search-fields.js.map

package/dist/tools/definitions/knowledge-space-search-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-space-search-fields.js","sourceRoot":"","sources":["../../../src/tools/definitions/knowledge-space-search-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,MAAM,CAAC,MAAM,+BAA+B,GAC1C,wQAAwQ,CAAC;AAC3Q,MAAM,CAAC,MAAM,8BAA8B,GACzC,8PAA8P,CAAC;AAEjQ,+EAA+E;AAC/E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;SACjC,QAAQ,EAAE;SACV,QAAQ,CACP,kMAAkM,CACnM;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,kBAAkB,CAAC;SACjE,IAAI,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,mGAAmG,CACpG;IACH,eAAe,EAAE,CAAC;SACf,KAAK,CACJ,CAAC;SACE,MAAM,EAAE;SACR,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,kBAAkB,CACxD;SACA,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CACzD;SACA,GAAG,CAAC,kBAAkB,CAAC;SACvB,QAAQ,EAAE;SACV,QAAQ,CACP,+NAA+N,CAChO;CACJ,CAAC"}

package/dist/tools/definitions/knowledge.d.ts

@@ -38,6 +38,7 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     sheet_title?: string | undefined;
     sheet_gid?: number | undefined;
     sheet_index?: number | undefined;
+    knowledge_space_id?: string | undefined;
     namespace?: string | undefined;
     split_override?: {
         split_mode: "size" | "separator";
@@ -47,12 +48,15 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
         max_chunk_size?: number | undefined;
     } | undefined;
     replace_existing?: boolean | undefined;
+    target_knowledge_source_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     name: string;
     scope_type: "WORKSPACE" | "CHANNEL";
+    access_mode?: "AUTO_QUERY" | "TOOL_ONLY" | undefined;
+    purpose?: string | null | undefined;
+    search_keywords?: string[] | undefined;
     workspace_id?: string | undefined;
     channel_id?: string | undefined;
-    access_mode?: "AUTO_QUERY" | "TOOL_ONLY" | undefined;
 }> | import("./shared.js").ToolDefinition<{
     workspace_id?: string | undefined;
     scope_type?: "WORKSPACE" | "CHANNEL" | undefined;
@@ -62,9 +66,11 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     workspace_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
+    access_mode?: "AUTO_QUERY" | "TOOL_ONLY" | undefined;
+    purpose?: string | null | undefined;
+    search_keywords?: string[] | undefined;
     workspace_id?: string | undefined;
     name?: string | undefined;
-    access_mode?: "AUTO_QUERY" | "TOOL_ONLY" | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
     channel_id: string;
@@ -85,9 +91,10 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     } | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
-    workspace_id?: string | undefined;
-    status?: "FAILED" | "COMPLETED" | "LOADED" | "SPLIT" | "EMBEDDINGS_GENERATED" | "VECTOR_DB_UPLOADED" | "TEXT_EXTRACTED" | "CHUNKS_SAVED" | undefined;
     page?: number | undefined;
+    workspace_id?: string | undefined;
+    status?: "COMPLETED" | "FAILED" | "LOADED" | "SPLIT" | "EMBEDDINGS_GENERATED" | "VECTOR_DB_UPLOADED" | "TEXT_EXTRACTED" | "CHUNKS_SAVED" | undefined;
+    cursor?: string | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
@@ -112,15 +119,16 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
         }[] | undefined;
     }[] | undefined;
     alias?: string | undefined;
-    mode?: "SIMPLE" | "STRICT" | "ONCE_STRICT" | undefined;
+    mode?: "SIMPLE" | "ONCE_STRICT" | "STRICT" | undefined;
     call_operator?: boolean | undefined;
     chunk_delay_seconds?: number | undefined;
     is_call_qa_only?: boolean | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
-    workspace_id?: string | undefined;
-    mode?: "SIMPLE" | "STRICT" | "ONCE_STRICT" | undefined;
     page?: number | undefined;
+    workspace_id?: string | undefined;
+    mode?: "SIMPLE" | "ONCE_STRICT" | "STRICT" | undefined;
+    cursor?: string | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
@@ -134,14 +142,14 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     answer?: string | undefined;
     answer_chunks?: {
         text?: string | undefined;
-        stored_file_id?: string | undefined;
+        stored_file_id?: string | null | undefined;
         buttons?: {
             name: string;
             url: string;
         }[] | undefined;
     }[] | undefined;
     alias?: string | undefined;
-    mode?: "SIMPLE" | "STRICT" | "ONCE_STRICT" | undefined;
+    mode?: "SIMPLE" | "ONCE_STRICT" | "STRICT" | undefined;
     call_operator?: boolean | undefined;
     chunk_delay_seconds?: number | undefined;
     is_call_qa_only?: boolean | undefined;
@@ -169,9 +177,10 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     display_name?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
-    workspace_id?: string | undefined;
-    status?: "PENDING" | "FAILED" | "PROCESSING" | "COMPLETED" | "CRAWLING" | undefined;
     page?: number | undefined;
+    workspace_id?: string | undefined;
+    status?: "COMPLETED" | "FAILED" | "PENDING" | "PROCESSING" | "CRAWLING" | undefined;
+    cursor?: string | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
@@ -198,12 +207,13 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     use_vector_index?: boolean | undefined;
     vector_top_k?: number | undefined;
     vector_embed_max_chars?: number | undefined;
-    access?: "PUBLIC" | "PRIVATE" | undefined;
+    access?: "PRIVATE" | "PUBLIC" | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
+    page?: number | undefined;
     workspace_id?: string | undefined;
     is_active?: boolean | undefined;
-    page?: number | undefined;
+    cursor?: string | undefined;
     limit?: number | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;
@@ -226,7 +236,7 @@ export declare const knowledgeTools: (import("./shared.js").ToolDefinition<{
     use_vector_index?: boolean | undefined;
     vector_top_k?: number | undefined;
     vector_embed_max_chars?: number | undefined;
-    access?: "PUBLIC" | "PRIVATE" | undefined;
+    access?: "PRIVATE" | "PUBLIC" | undefined;
     is_active?: boolean | undefined;
 }> | import("./shared.js").ToolDefinition<{
     knowledge_space_id: string;