@besales/mcp 0.1.0 → 0.11.1

package/dist/tools/definitions/knowledge.js

@@ -0,0 +1,782 @@
+import { z } from 'zod';
+import { buildKnowledgeSpaceListQuery, buildListQuery, compactObject, defineTool, knowledgeTableSourceSchema, uuidSchema, withInstructions, } from './shared.js';
+export const knowledgeTools = [
+    // v1.5 — workbook ingestion (xlsx + Google Sheets → ICP/prompt/knowledge)
+    defineTool({
+        name: 'besales_workbook_inspect',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            stored_file_id: uuidSchema.optional(),
+            google_sheets_url: z.string().url().optional(),
+            sample_rows_per_sheet: z.number().int().min(1).max(50).optional(),
+            max_cells_total: z.number().int().min(50).max(5000).optional(),
+        })
+            .superRefine((value, ctx) => {
+            if (!value.stored_file_id && !value.google_sheets_url) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'Один из stored_file_id или google_sheets_url обязателен',
+                });
+            }
+            if (value.stored_file_id && value.google_sheets_url) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'Передайте stored_file_id ИЛИ google_sheets_url, не оба',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/workbooks/inspect`,
+            body: compactObject({
+                storedFileId: input.stored_file_id,
+                googleSheetsUrl: input.google_sheets_url,
+                sampleRowsPerSheet: input.sample_rows_per_sheet,
+                maxCellsTotal: input.max_cells_total,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Возвращена структура всех вкладок + per-column hyperlink статистика.',
+            'Пройди по содержимому ВСЕХ вкладок — не делай вывод «этого нет в файле», пока не проверил каждую.',
+            'Если контент на языке, отличном от языка диалога с пользователем — ПЕРЕД внедрением (RAG/промпт/ICP) дай пользователю краткое саммари на его языке: что нашёл и что внедряешь; по цифрам/процентам/условиям дождись подтверждения.',
+            'Классифицируй каждую вкладку по таксономии из `besales://concepts/workbook-classification`.',
+            'Для compact knowledge (≤8k chars) — сделай локальную LLM-выжимку и положи через `besales_agent_facts_set`.',
+            'Для bulk knowledge (>8k) — `besales_workbook_to_knowledge_document`.',
+            'Для диалог-индексов с amoCRM-ссылками — извлеки lead_ids regex-ом и вызывай `besales_icp_import_dialogues mode=audio audio_source_type=amocrm_leads`.',
+            'Если Google Sheets 403 (`google_sheets_not_shared`) — покажи юзеру `serviceAccountEmail` из response и попроси расшарить таблицу.',
+            'После классификации зафиксируй решения через PATCH /workbooks/:id/classification.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_workbook_extract_amocrm_leads',
+        requiredFields: ['workbook_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            workbook_id: uuidSchema,
+            sheet_title: z.string().optional(),
+            sheet_gid: z.number().int().optional(),
+            sheet_index: z.number().int().min(0).optional(),
+            include_contacts: z.boolean().optional(),
+        })
+            .superRefine((value, ctx) => {
+            if (value.sheet_title === undefined &&
+                value.sheet_gid === undefined &&
+                value.sheet_index === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'Один из sheet_title / sheet_gid / sheet_index обязателен',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/workbooks/${input.workbook_id}/extract-amocrm-leads`,
+            body: compactObject({
+                sheetTitle: input.sheet_title,
+                sheetGid: input.sheet_gid,
+                sheetIndex: input.sheet_index,
+                includeContacts: input.include_contacts,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Возвращены все amoCRM lead-ID из ВСЕЙ вкладки (без sample-лимита inspect).',
+            'Используй leads[].id для `besales_icp_import_dialogues mode=audio audio_source_type=amocrm_leads`.',
+            'Если truncated=true — вкладка длиннее 10000 строк (hard cap); часть строк не прочитана.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_workbook_to_knowledge_document',
+        requiredFields: ['workbook_id'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            workbook_id: uuidSchema,
+            sheet_title: z.string().optional(),
+            sheet_gid: z.number().int().optional(),
+            sheet_index: z.number().int().min(0).optional(),
+            namespace: z.string().optional(),
+            split_override: z
+                .object({
+                split_mode: z.enum(['size', 'separator']),
+                separator: z.string().optional(),
+                chunk_size: z.number().int().min(100).optional(),
+                chunk_overlap: z.number().int().min(0).optional(),
+                max_chunk_size: z.number().int().min(100).optional(),
+            })
+                .optional(),
+            replace_existing: z.boolean().optional(),
+        })
+            .superRefine((value, ctx) => {
+            if (value.sheet_title === undefined &&
+                value.sheet_gid === undefined &&
+                value.sheet_index === undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'Один из sheet_title / sheet_gid / sheet_index обязателен',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/workbooks/${input.workbook_id}/knowledge-document`,
+            body: compactObject({
+                sheetTitle: input.sheet_title,
+                sheetGid: input.sheet_gid,
+                sheetIndex: input.sheet_index,
+                namespace: input.namespace,
+                splitOverride: input.split_override
+                    ? compactObject({
+                        splitMode: input.split_override.split_mode,
+                        separator: input.split_override.separator,
+                        chunkSize: input.split_override.chunk_size,
+                        chunkOverlap: input.split_override.chunk_overlap,
+                        maxChunkSize: input.split_override.max_chunk_size,
+                    })
+                    : undefined,
+                replaceExisting: input.replace_existing,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'KnowledgeDocument создан. Привяжи namespace к агенту через `AgentChat.knowledgeNamespaces` если не привязан (см. besales_agent_update).',
+            'response.splitDecision.reason — почему сервер выбрал такой режим чанкинга (heuristic либо override).',
+            'При повторном вызове для того же листа — старый AI_INGESTED документ заменяется (idempotency).',
+        ]),
+    }),
+    // v1.5 — Knowledge Spaces (Increment 1): создание/управление namespaces для агентов
+    defineTool({
+        name: 'besales_knowledge_space_create',
+        requiredFields: ['name', 'scope_type'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            name: z.string().min(1).max(100),
+            scope_type: z.enum(['WORKSPACE', 'CHANNEL']),
+            channel_id: uuidSchema.optional(),
+            access_mode: z.enum(['AUTO_QUERY', 'TOOL_ONLY']).optional(),
+        })
+            .superRefine((value, ctx) => {
+            if (value.scope_type === 'CHANNEL' && !value.channel_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'channel_id обязателен для scope_type=CHANNEL',
+                });
+            }
+            if (value.scope_type === 'WORKSPACE' && value.channel_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'channel_id запрещён для scope_type=WORKSPACE',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces`,
+            body: compactObject({
+                name: input.name,
+                scope_type: input.scope_type,
+                channel_id: input.channel_id,
+                access_mode: input.access_mode,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Knowledge space создан. id — UUID для последующих ingestion-операций.',
+            'WORKSPACE scope доступен всем каналам через besales_knowledge_space_channel_link_upsert.',
+            'CHANNEL scope привязан к channel_id жёстко (изолирован).',
+            'Дальше: загрузи документ через besales_knowledge_document_upload или Q&A (Increment 2).',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_space_list',
+        requiredFields: [],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            scope_type: z.enum(['WORKSPACE', 'CHANNEL']).optional(),
+            channel_id: uuidSchema.optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces${buildKnowledgeSpaceListQuery(input.scope_type, input.channel_id)}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_space_get',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_space_patch',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            name: z.string().min(1).max(100).optional(),
+            access_mode: z.enum(['AUTO_QUERY', 'TOOL_ONLY']).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}`,
+            body: compactObject({
+                name: input.name,
+                access_mode: input.access_mode,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_space_channel_link_upsert',
+        requiredFields: ['knowledge_space_id', 'channel_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            channel_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/channel-links`,
+            body: { channel_id: input.channel_id },
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_space_channel_link_remove',
+        requiredFields: ['knowledge_space_id', 'channel_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            channel_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/channel-links/${input.channel_id}`,
+        }),
+    }),
+    // v1.5 — Knowledge Documents (Increment 1): загрузка/удаление документов в space
+    defineTool({
+        name: 'besales_knowledge_document_upload',
+        requiredFields: ['knowledge_space_id', 'source_kind'],
+        defaultWorkspaceId: true,
+        schema: z
+            .object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            source_kind: z.enum(['STORED_FILE', 'TEXT']),
+            stored_file_id: uuidSchema.optional(),
+            content: z.string().optional(),
+            filename: z.string().optional(),
+            split_override: z
+                .object({
+                split_mode: z.enum(['size', 'separator']),
+                separator: z.string().optional(),
+                chunk_size: z.number().int().min(100).optional(),
+                chunk_overlap: z.number().int().min(0).optional(),
+                max_chunk_size: z.number().int().min(100).optional(),
+            })
+                .optional(),
+        })
+            .superRefine((value, ctx) => {
+            if (value.source_kind === 'STORED_FILE' && !value.stored_file_id) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'stored_file_id обязателен для source_kind=STORED_FILE',
+                });
+            }
+            if (value.source_kind === 'TEXT' && (!value.content || !value.filename)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: 'content и filename обязательны для source_kind=TEXT',
+                });
+            }
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/documents`,
+            body: compactObject({
+                source_kind: input.source_kind,
+                stored_file_id: input.stored_file_id,
+                content: input.content,
+                filename: input.filename,
+                split_override: input.split_override
+                    ? compactObject({
+                        split_mode: input.split_override.split_mode,
+                        separator: input.split_override.separator,
+                        chunk_size: input.split_override.chunk_size,
+                        chunk_overlap: input.split_override.chunk_overlap,
+                        max_chunk_size: input.split_override.max_chunk_size,
+                    })
+                    : undefined,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Document uploaded. Processing is async — статус движется PENDING → COMPLETED либо FAILED.',
+            'Опрашивай статус через besales_knowledge_document_get пока status=COMPLETED.',
+            'Для TEXT source_kind при повторном вызове с тем же filename — старый документ заменяется (document_replaced=true).',
+            'Binary файлы (PDF/DOCX) — загрузи сначала через POST /api/v2/files отдельно, затем передай stored_file_id сюда.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_document_list',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            status: z
+                .enum([
+                'LOADED',
+                'SPLIT',
+                'EMBEDDINGS_GENERATED',
+                'VECTOR_DB_UPLOADED',
+                'COMPLETED',
+                'FAILED',
+                'TEXT_EXTRACTED',
+                'CHUNKS_SAVED',
+            ])
+                .optional(),
+            page: z.number().int().min(1).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/documents${buildListQuery({ status: input.status, page: input.page, limit: input.limit })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_document_get',
+        requiredFields: ['knowledge_space_id', 'document_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            document_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/documents/${input.document_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_document_delete',
+        requiredFields: ['knowledge_space_id', 'document_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            document_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/documents/${input.document_id}`,
+            body: { explicit_confirmation: input.explicit_confirmation },
+        }),
+    }),
+    // ----- v1.5 Increment 2: Q&A CRUD (7 tools) -----
+    defineTool({
+        name: 'besales_knowledge_qa_create',
+        requiredFields: ['knowledge_space_id', 'question'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            question: z.string().min(1),
+            answer: z.string().optional(),
+            answer_chunks: z
+                .array(z.object({
+                text: z.string().optional(),
+                stored_file_id: uuidSchema.optional(),
+                buttons: z
+                    .array(z.object({ name: z.string().min(1), url: z.string().min(1) }))
+                    .optional(),
+            }))
+                .max(20)
+                .optional(),
+            alias: z.string().optional(),
+            mode: z.enum(['SIMPLE', 'STRICT', 'ONCE_STRICT']).optional(),
+            call_operator: z.boolean().optional(),
+            chunk_delay_seconds: z.number().int().min(1).optional(),
+            is_call_qa_only: z.boolean().optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs`,
+            body: compactObject({
+                question: input.question,
+                answer: input.answer,
+                answer_chunks: input.answer_chunks,
+                alias: input.alias,
+                mode: input.mode,
+                call_operator: input.call_operator,
+                chunk_delay_seconds: input.chunk_delay_seconds,
+                is_call_qa_only: input.is_call_qa_only,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Q&A создана. Embedding для вопроса генерируется sync — статус COMPLETED в большинстве случаев сразу.',
+            'mode=SIMPLE с одним чанком → используется с RAG; STRICT — только QA-промпт без RAG; ONCE_STRICT — первый раз STRICT, далее как контекст.',
+            'is_call_qa_only=true → QA не векторизуется, доступна только через call_qa tool.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_list',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            mode: z.enum(['SIMPLE', 'STRICT', 'ONCE_STRICT']).optional(),
+            page: z.number().int().min(1).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs${buildListQuery({ mode: input.mode, page: input.page, limit: input.limit })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_get',
+        requiredFields: ['knowledge_space_id', 'qa_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            qa_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs/${input.qa_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_patch',
+        requiredFields: ['knowledge_space_id', 'qa_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            qa_id: uuidSchema,
+            question: z.string().min(1).optional(),
+            answer: z.string().optional(),
+            answer_chunks: z
+                .array(z.object({
+                text: z.string().optional(),
+                stored_file_id: uuidSchema.optional(),
+                buttons: z
+                    .array(z.object({ name: z.string().min(1), url: z.string().min(1) }))
+                    .optional(),
+            }))
+                .max(20)
+                .optional(),
+            alias: z.string().optional(),
+            mode: z.enum(['SIMPLE', 'STRICT', 'ONCE_STRICT']).optional(),
+            call_operator: z.boolean().optional(),
+            chunk_delay_seconds: z.number().int().min(1).optional(),
+            is_call_qa_only: z.boolean().optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs/${input.qa_id}`,
+            body: compactObject({
+                question: input.question,
+                answer: input.answer,
+                answer_chunks: input.answer_chunks,
+                alias: input.alias,
+                mode: input.mode,
+                call_operator: input.call_operator,
+                chunk_delay_seconds: input.chunk_delay_seconds,
+                is_call_qa_only: input.is_call_qa_only,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_delete',
+        requiredFields: ['knowledge_space_id', 'qa_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            qa_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs/${input.qa_id}`,
+            body: { explicit_confirmation: input.explicit_confirmation },
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_search',
+        requiredFields: ['knowledge_space_id', 'query'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            query: z.string().min(1),
+            top_k: z.number().int().min(1).max(50).optional(),
+            min_score: z.number().optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/qa-pairs/search`,
+            body: compactObject({
+                query: input.query,
+                top_k: input.top_k,
+                min_score: input.min_score,
+            }),
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_qa_move',
+        requiredFields: ['source_space_id', 'qa_id', 'target_space_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            source_space_id: uuidSchema,
+            qa_id: uuidSchema,
+            target_space_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.source_space_id}/qa-pairs/${input.qa_id}/move`,
+            body: {
+                target_space_id: input.target_space_id,
+                explicit_confirmation: input.explicit_confirmation,
+            },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Move = delete + recreate в новом knowledge space. Возвращается новый ID — обнови ссылки в caller-коде.',
+            'Pinecone vectors переиндексируются: старый embedding удаляется из source namespace, новый создаётся в target.',
+            'Alias НЕ переносится (unique-per-workspace constraint).',
+        ]),
+    }),
+    // ----- v1.5 Increment 2: Websites (4 tools) -----
+    defineTool({
+        name: 'besales_knowledge_website_add',
+        requiredFields: ['knowledge_space_id', 'url'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            url: z.string().url(),
+            display_name: z.string().optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/websites`,
+            body: compactObject({
+                url: input.url,
+                display_name: input.display_name,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'SYNC operation — может занять несколько секунд для краулинга + chunking + Pinecone upsert.',
+            'Idempotency: повторный POST с тем же URL вернёт existing site, replaced=true. FAILED перезапускается автоматически.',
+            'Status: PENDING → CRAWLING → PROCESSING → COMPLETED | FAILED.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_website_list',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            status: z.enum(['PENDING', 'CRAWLING', 'PROCESSING', 'COMPLETED', 'FAILED']).optional(),
+            page: z.number().int().min(1).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/websites${buildListQuery({ status: input.status, page: input.page, limit: input.limit })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_website_get',
+        requiredFields: ['knowledge_space_id', 'website_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            website_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/websites/${input.website_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_website_delete',
+        requiredFields: ['knowledge_space_id', 'website_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            website_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/websites/${input.website_id}`,
+            body: { explicit_confirmation: input.explicit_confirmation },
+        }),
+    }),
+    // ============================================================
+    // v1.5 Increment 3 Group A.5 — Knowledge tables (6 tools)
+    // ============================================================
+    defineTool({
+        name: 'besales_knowledge_table_link',
+        requiredFields: ['knowledge_space_id', 'source', 'display_name'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            source: knowledgeTableSourceSchema,
+            display_name: z.string(),
+            header_row_index: z.number().int().min(1).optional(),
+            cache_ttl_seconds: z.number().int().min(1).optional(),
+            use_vector_index: z.boolean().optional(),
+            vector_top_k: z.number().int().min(1).optional(),
+            vector_embed_max_chars: z.number().int().min(1).optional(),
+            access: z.enum(['PUBLIC', 'PRIVATE']).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables`,
+            body: compactObject({
+                source: {
+                    kind: input.source.kind,
+                    spreadsheet_url: input.source.spreadsheet_url,
+                    table_schema: input.source.table_schema,
+                },
+                display_name: input.display_name,
+                header_row_index: input.header_row_index,
+                cache_ttl_seconds: input.cache_ttl_seconds,
+                use_vector_index: input.use_vector_index,
+                vector_top_k: input.vector_top_k,
+                vector_embed_max_chars: input.vector_embed_max_chars,
+                access: input.access,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Knowledge table связана. Если URL уже существовал, replaced=true (idempotency by namespace+url).',
+            'Для индексации в Pinecone установи use_vector_index=true и вызови besales_knowledge_table_reindex.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_table_list',
+        requiredFields: ['knowledge_space_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            is_active: z.boolean().optional(),
+            page: z.number().int().min(1).optional(),
+            limit: z.number().int().min(1).max(100).optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables${buildListQuery({ is_active: input.is_active, page: input.page, limit: input.limit })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_table_get',
+        requiredFields: ['knowledge_space_id', 'table_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            table_id: uuidSchema,
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables/${input.table_id}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_table_patch',
+        requiredFields: ['knowledge_space_id', 'table_id'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            table_id: uuidSchema,
+            // source присутствует только для validation (URL иммутабельный).
+            source: knowledgeTableSourceSchema.optional(),
+            display_name: z.string().optional(),
+            header_row_index: z.number().int().min(1).optional(),
+            cache_ttl_seconds: z.number().int().min(1).optional(),
+            use_vector_index: z.boolean().optional(),
+            vector_top_k: z.number().int().min(1).optional(),
+            vector_embed_max_chars: z.number().int().min(1).optional(),
+            access: z.enum(['PUBLIC', 'PRIVATE']).optional(),
+            is_active: z.boolean().optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'PATCH',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables/${input.table_id}`,
+            body: compactObject({
+                source: input.source
+                    ? {
+                        kind: input.source.kind,
+                        spreadsheet_url: input.source.spreadsheet_url,
+                        table_schema: input.source.table_schema,
+                    }
+                    : undefined,
+                display_name: input.display_name,
+                header_row_index: input.header_row_index,
+                cache_ttl_seconds: input.cache_ttl_seconds,
+                use_vector_index: input.use_vector_index,
+                vector_top_k: input.vector_top_k,
+                vector_embed_max_chars: input.vector_embed_max_chars,
+                access: input.access,
+                is_active: input.is_active,
+            }),
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'source.url иммутабельный — для смены URL используй delete + create.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_knowledge_table_delete',
+        requiredFields: ['knowledge_space_id', 'table_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            table_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            method: 'DELETE',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables/${input.table_id}`,
+            body: { explicit_confirmation: input.explicit_confirmation },
+        }),
+    }),
+    defineTool({
+        name: 'besales_knowledge_table_reindex',
+        requiredFields: ['knowledge_space_id', 'table_id', 'explicit_confirmation'],
+        defaultWorkspaceId: true,
+        schema: z.object({
+            workspace_id: uuidSchema.optional(),
+            knowledge_space_id: uuidSchema,
+            table_id: uuidSchema,
+            explicit_confirmation: z.boolean(),
+        }),
+        createRequest: (input) => ({
+            method: 'POST',
+            path: `/workspaces/${input.workspace_id}/knowledge-spaces/${input.knowledge_space_id}/tables/${input.table_id}/reindex`,
+            body: { explicit_confirmation: input.explicit_confirmation },
+        }),
+        enhanceResponse: (response) => withInstructions(response, [
+            'Triggers full re-index в Pinecone (delete vectors + re-fetch CSV + re-embed + upsert). Может занять время для больших таблиц.',
+        ]),
+    }),
+];
+//# sourceMappingURL=knowledge.js.map