@besales/mcp 0.45.0 → 0.47.0

package/dist/tools/definitions/agent-design.d.ts

@@ -28,6 +28,9 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     operation_id: string;
     icp_profile_id: string;
     segments: {
+        language_style: {
+            [x: string]: unknown;
+        } | undefined;
         name: string;
         id?: string | undefined;
         description?: string | undefined;
@@ -36,22 +39,19 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
         } | undefined;
         pains?: unknown[] | undefined;
         motivations?: unknown[] | undefined;
-        language_style?: {
-            [x: string]: unknown;
-        } | undefined;
     }[];
     personas: {
+        segment_id: string | undefined;
+        pain_points: unknown[] | undefined;
+        messaging_hints: {
+            [x: string]: unknown;
+        } | undefined;
         name: string;
-        segment_id: string;
         description?: string | undefined;
-        pain_points?: unknown[] | undefined;
         goals?: unknown[] | undefined;
         objections?: {
             [x: string]: unknown;
         } | undefined;
-        messaging_hints?: {
-            [x: string]: unknown;
-        } | undefined;
     }[];
     workspace_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
@@ -75,6 +75,7 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
         message_direction?: "INBOUND" | "OUTBOUND" | undefined;
     } | undefined;
 }> | import("./shared.js").ToolDefinition<{
+    final_content: string | undefined;
     agent_id: string;
     operation_id: string;
     stages: {
@@ -83,7 +84,6 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             [x: string]: unknown;
         };
     }[];
-    final_content: string;
     metadata?: {
         total_tokens?: number | undefined;
         models?: Record<string, string> | undefined;
@@ -93,6 +93,9 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     version_id: string;
     modes: ("grammar" | "industry" | "structure" | "completeness" | "contradictions")[];
 }> | import("./shared.js").ToolDefinition<{
+    aggregated_issues: {
+        [x: string]: unknown;
+    }[] | undefined;
     agent_id: string;
     operation_id: string;
     stages: {
@@ -101,15 +104,13 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             [x: string]: unknown;
         };
     }[];
-    aggregated_issues: {
-        [x: string]: unknown;
-    }[];
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     draft_version_id: string;
     changelog_note?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
+    candidate_prompt?: string | undefined;
     scenario_ids?: string[] | undefined;
     options?: {
         mode: "single_agent" | "workflow";
@@ -123,6 +124,19 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
             max_turns?: number | undefined;
         } | undefined;
     } | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    agent_id: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}> | import("./shared.js").ToolDefinition<{
+    run_id: string;
+    reviewed_issues: {
+        scenario_id?: string | undefined;
+        turn_index?: number | undefined;
+        category?: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | undefined;
+        description?: string | undefined;
+    }[];
+    general_comments?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
     run_id: string;
@@ -131,12 +145,17 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     run_id: string;
     operation_id: string;
     findings: {
-        category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "wrong_routing" | "missed_trigger" | "wrong_pipeline_transition" | "rag_miss";
-        severity: "low" | "medium" | "critical";
-        message: string;
+        category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | "wrong_routing" | "rag_miss";
+        severity: "critical" | "low" | "medium";
         scenario_id?: string | undefined;
+        scenarioId?: string | undefined;
+        description?: string | undefined;
+        message?: string | undefined;
+        evidence?: string | undefined;
+        recommendation?: string | undefined;
         suggestion?: string | undefined;
         turn_index?: number | undefined;
+        turnIndex?: number | undefined;
     }[];
 }> | import("./shared.js").ToolDefinition<{
     agent_id: string;
@@ -146,11 +165,13 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     operation_id: string;
     findings: {
         category: "other" | "hallucination" | "wrong_action" | "bad_tone" | "missed_context" | "contradiction" | "off_topic";
-        severity: "low" | "medium" | "critical";
+        severity: "critical" | "low" | "medium";
         message: string;
         dialogue_id?: string | undefined;
+        dialogueId?: string | undefined;
         suggestion?: string | undefined;
         reference_message_index?: number | undefined;
+        referenceMessageIndex?: number | undefined;
     }[];
     simulation_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
@@ -160,14 +181,14 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
     company_context?: string | undefined;
     icp_profile_id?: string | undefined;
 }> | import("./shared.js").ToolDefinition<{
-    agent_id: string;
-    operation_id: string;
+    knowledge_space_id: string | undefined;
     qa_pairs: {
         question: string;
         answer: string;
         tags?: string[] | undefined;
-    }[];
-    knowledge_space_id?: string | undefined;
+    }[] | undefined;
+    agent_id: string;
+    operation_id: string;
 }> | import("./shared.js").ToolDefinition<{
     icp_profile_id: string;
     count: number;
@@ -184,6 +205,14 @@ export declare const agentDesignTools: (import("./shared.js").ToolDefinition<{
         situations: {
             role: "client" | "agent";
             text: string;
+            expect?: {
+                triggers?: string[] | undefined;
+                noTriggers?: string[] | undefined;
+                tools?: string[] | undefined;
+                noTools?: string[] | undefined;
+                answerContains?: string[] | undefined;
+                answerNotContains?: string[] | undefined;
+            } | undefined;
         }[];
         description?: string | undefined;
     }[];

package/dist/tools/definitions/agent-design.js

@@ -1,8 +1,34 @@
 import { z } from 'zod';
 import { analysisModeSchema, anyObjectSchema, buildListQuery, compactMetadata, compactObject, defineTool, generatedScenarioSchema, icpAnalysisPersonaSchema, icpAnalysisSegmentSchema, optionalAnyObjectSchema, outcomeSchema, promptAnalysisStageOutputSchema, promptGenerationStageOutputSchema, sandboxFindingSchema, simulationFindingSchema, uuidSchema, withInstructions, } from './shared.js';
+const SANDBOX_TERMINAL_STATUSES = new Set(['COMPLETED', 'FAILED', 'CANCELLED']);
+function enhanceSandboxStatus(response) {
+    if (!response || typeof response !== 'object' || Array.isArray(response)) {
+        return response;
+    }
+    const status = response.status;
+    if (typeof status !== 'string') {
+        return response;
+    }
+    if (!SANDBOX_TERMINAL_STATUSES.has(status)) {
+        return withInstructions(response, [
+            `Прогон ещё не завершён (${status}). Подожди 10–30 секунд и снова вызови besales_sandbox_run_get с тем же run_id.`,
+            'Не запускай второй прогон вместо проверки статуса.',
+        ]);
+    }
+    if (status === 'COMPLETED') {
+        return withInstructions(response, [
+            'Прогон завершён. passRate показывает живучесть ответов, а не качество.',
+            'Проверь checksRate и qualityRate отдельно. Если qualityRate ещё null, вызови besales_sandbox_findings_get_instructions, затем besales_sandbox_findings_submit.',
+        ]);
+    }
+    return withInstructions(response, [
+        `Прогон завершён со статусом ${status}. Не запускай findings и не выдавай готовность агента за доказанную.`,
+    ]);
+}
 export const agentDesignTools = [
     defineTool({
         name: 'besales_icp_create',
+        sideEffect: 'write',
         requiredFields: ['name'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -24,6 +50,9 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_import_dialogues',
+        // Имя проверки из имени операции не выводится: суффиксы не парные.
+        verifyWithToolName: 'besales_icp_import_status',
+        sideEffect: 'spend',
         requiredFields: ['icp_id'],
         schema: z
             .object({
@@ -121,6 +150,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_import_status',
+        sideEffect: 'none',
         requiredFields: ['run_id'],
         schema: z.object({
             run_id: uuidSchema,
@@ -132,6 +162,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_analysis_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['icp_profile_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -155,6 +186,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_analysis_submit',
+        sideEffect: 'write',
         requiredFields: ['operation_id', 'icp_profile_id', 'segments', 'personas'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -193,6 +225,9 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_list',
+        // Постраничная выдача уже работает: конверт подменил бы исправный механизм тихой потерей.
+        resultPolicy: { neverTruncate: true },
+        sideEffect: 'none',
         requiredFields: [],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -207,6 +242,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_get',
+        sideEffect: 'none',
         requiredFields: ['icp_id'],
         schema: z.object({
             icp_id: uuidSchema,
@@ -218,6 +254,10 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_scenarios_list',
+        // Замерено 119 КБ голым массивом, ручек сужения нет. Обрезка молча срезала бы часть
+        // сценариев, а добрать отрезанное нечем — поэтому отказ, а не половина набора.
+        resultPolicy: { neverTruncate: true },
+        sideEffect: 'none',
         requiredFields: ['icp_id'],
         schema: z.object({
             icp_id: uuidSchema,
@@ -229,6 +269,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_icp_sample_messages',
+        sideEffect: 'none',
         requiredFields: ['sample_id'],
         schema: z.object({
             sample_id: uuidSchema,
@@ -240,6 +281,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_prompt_generate_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -282,19 +324,30 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_prompt_generate_submit',
-        requiredFields: ['agent_id', 'operation_id', 'stages', 'final_content'],
-        schema: z.object({
+        sideEffect: 'write',
+        requiredFields: ['agent_id', 'operation_id', 'stages'],
+        schema: z
+            .object({
             agent_id: uuidSchema,
             operation_id: uuidSchema,
             stages: z.array(promptGenerationStageOutputSchema).min(4),
-            final_content: z.string(),
+            final_content: z.string().optional(),
+            finalContent: z.string().optional(),
             metadata: z
                 .object({
                 total_tokens: z.number().int().optional(),
                 models: z.record(z.string(), z.string()).optional(),
             })
                 .optional(),
-        }),
+        })
+            .refine((input) => input.final_content !== undefined || input.finalContent !== undefined, {
+            message: 'finalContent is required',
+            path: ['finalContent'],
+        })
+            .transform(({ final_content, finalContent, ...input }) => ({
+            ...input,
+            final_content: final_content ?? finalContent,
+        })),
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/prompt/generate/${input.operation_id}/submit`,
             body: compactObject({
@@ -307,6 +360,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_prompt_analyze_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'version_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -328,13 +382,21 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_prompt_analyze_submit',
-        requiredFields: ['agent_id', 'operation_id', 'stages', 'aggregated_issues'],
-        schema: z.object({
+        sideEffect: 'write',
+        requiredFields: ['agent_id', 'operation_id', 'stages'],
+        schema: z
+            .object({
             agent_id: uuidSchema,
             operation_id: uuidSchema,
             stages: z.array(promptAnalysisStageOutputSchema).min(4),
-            aggregated_issues: z.array(anyObjectSchema),
-        }),
+            aggregated_issues: z.array(anyObjectSchema).optional(),
+            aggregatedIssues: z.array(anyObjectSchema).optional(),
+        })
+            .refine((input) => input.aggregated_issues !== undefined || input.aggregatedIssues !== undefined, { message: 'aggregatedIssues is required', path: ['aggregatedIssues'] })
+            .transform(({ aggregated_issues, aggregatedIssues, ...input }) => ({
+            ...input,
+            aggregated_issues: aggregated_issues ?? aggregatedIssues,
+        })),
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/prompt/analyze/${input.operation_id}/submit`,
             body: {
@@ -346,6 +408,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_prompt_finalize',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'draft_version_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -365,9 +428,11 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_sandbox_run_start',
+        sideEffect: 'spend',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
+            candidate_prompt: z.string().min(10).max(100_000).optional(),
             scenario_ids: z.array(uuidSchema).optional(),
             options: z
                 .object({
@@ -389,6 +454,7 @@ export const agentDesignTools = [
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/sandbox-runs`,
             body: compactObject({
+                candidatePrompt: input.candidate_prompt,
                 scenarioIds: input.scenario_ids,
                 options: input.options
                     ? {
@@ -406,9 +472,83 @@ export const agentDesignTools = [
                     : undefined,
             }),
         }),
+        verifyWithToolName: 'besales_sandbox_run_get',
+        enhanceResponse: (response, input) => withInstructions(response, [
+            'Сохрани id прогона как run_id. Проверяй только этот прогон через besales_sandbox_run_get.',
+            input.candidate_prompt
+                ? 'Проверяется неактивированный candidate_prompt. Он не меняет работающего агента; активировать результат можно только отдельным prompt commit/finalize после проверки актуальности hash.'
+                : 'Проверяется активный промпт агента. testedConfiguration в detail фиксирует его hash/version на момент постановки.',
+            'Первую проверку делай через 10–30 секунд; повторяй, пока status не станет COMPLETED, FAILED или CANCELLED.',
+        ]),
+    }),
+    defineTool({
+        name: 'besales_sandbox_run_list',
+        resultPolicy: { neverTruncate: true },
+        sideEffect: 'none',
+        requiredFields: ['agent_id'],
+        schema: z.object({
+            agent_id: uuidSchema,
+            limit: z.number().int().min(1).max(100).optional(),
+            cursor: z.string().optional(),
+        }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/agents/${input.agent_id}/sandbox-runs${buildListQuery({ limit: input.limit, cursor: input.cursor })}`,
+        }),
+    }),
+    defineTool({
+        name: 'besales_sandbox_run_get',
+        sideEffect: 'none',
+        requiredFields: ['run_id'],
+        schema: z.object({ run_id: uuidSchema }),
+        createRequest: (input) => ({
+            method: 'GET',
+            path: `/sandbox-runs/${input.run_id}`,
+        }),
+        enhanceResponse: enhanceSandboxStatus,
+    }),
+    defineTool({
+        name: 'besales_sandbox_run_cancel',
+        sideEffect: 'write',
+        requiredFields: ['run_id'],
+        schema: z.object({ run_id: uuidSchema }),
+        createRequest: (input) => ({
+            path: `/sandbox-runs/${input.run_id}/cancel`,
+        }),
+        enhanceResponse: enhanceSandboxStatus,
+    }),
+    defineTool({
+        name: 'besales_sandbox_run_feedback',
+        sideEffect: 'write',
+        requiredFields: ['run_id', 'reviewed_issues'],
+        schema: z.object({
+            run_id: uuidSchema,
+            reviewed_issues: z.array(z.object({
+                scenario_id: uuidSchema.optional(),
+                turn_index: z.number().int().min(0).optional(),
+                category: z
+                    .enum(['hallucination', 'wrong_action', 'bad_tone', 'missed_context', 'other'])
+                    .optional(),
+                description: z.string().optional(),
+            })),
+            general_comments: z.string().optional(),
+        }),
+        createRequest: (input) => ({
+            path: `/sandbox-runs/${input.run_id}/feedback`,
+            body: compactObject({
+                reviewedIssues: input.reviewed_issues.map((issue) => compactObject({
+                    scenarioId: issue.scenario_id,
+                    turnIndex: issue.turn_index,
+                    category: issue.category,
+                    description: issue.description,
+                })),
+                generalComments: input.general_comments,
+            }),
+        }),
     }),
     defineTool({
         name: 'besales_sandbox_findings_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'run_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -427,6 +567,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_sandbox_findings_submit',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'run_id', 'operation_id', 'findings'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -438,12 +579,13 @@ export const agentDesignTools = [
             path: `/agents/${input.agent_id}/sandbox/runs/${input.run_id}/findings/${input.operation_id}/submit`,
             body: {
                 findings: input.findings.map((finding) => compactObject({
-                    scenarioId: finding.scenario_id,
+                    scenarioId: finding.scenarioId ?? finding.scenario_id,
                     category: finding.category,
                     severity: finding.severity,
-                    message: finding.message,
-                    suggestion: finding.suggestion,
-                    turnIndex: finding.turn_index,
+                    description: finding.description ?? finding.message,
+                    evidence: finding.evidence,
+                    recommendation: finding.recommendation ?? finding.suggestion,
+                    turnIndex: finding.turnIndex ?? finding.turn_index,
                 })),
             },
         }),
@@ -451,6 +593,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_simulation_findings_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'simulation_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -470,6 +613,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_simulation_findings_submit',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'operation_id', 'findings'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -483,12 +627,12 @@ export const agentDesignTools = [
             path: `/agents/${input.agent_id}/prompt/simulate-findings/${input.operation_id}/submit`,
             body: {
                 findings: input.findings.map((finding) => compactObject({
-                    dialogueId: finding.dialogue_id,
+                    dialogueId: finding.dialogueId ?? finding.dialogue_id,
                     category: finding.category,
                     severity: finding.severity,
                     message: finding.message,
                     suggestion: finding.suggestion,
-                    referenceMessageIndex: finding.reference_message_index,
+                    referenceMessageIndex: finding.referenceMessageIndex ?? finding.reference_message_index,
                 })),
             },
         }),
@@ -496,6 +640,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_qa_generation_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -521,17 +666,38 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_qa_generation_submit',
-        requiredFields: ['agent_id', 'operation_id', 'qa_pairs'],
-        schema: z.object({
+        sideEffect: 'write',
+        requiredFields: ['agent_id', 'operation_id'],
+        schema: z
+            .object({
             agent_id: uuidSchema,
             operation_id: uuidSchema,
             knowledge_space_id: uuidSchema.optional(),
-            qa_pairs: z.array(z.object({
+            knowledgeSpaceId: uuidSchema.optional(),
+            qa_pairs: z
+                .array(z.object({
                 question: z.string(),
                 answer: z.string(),
                 tags: z.array(z.string()).optional(),
-            })),
-        }),
+            }))
+                .optional(),
+            qaPairs: z
+                .array(z.object({
+                question: z.string(),
+                answer: z.string(),
+                tags: z.array(z.string()).optional(),
+            }))
+                .optional(),
+        })
+            .refine((input) => input.qa_pairs !== undefined || input.qaPairs !== undefined, {
+            message: 'qaPairs is required',
+            path: ['qaPairs'],
+        })
+            .transform(({ knowledge_space_id, knowledgeSpaceId, qa_pairs, qaPairs, ...input }) => ({
+            ...input,
+            knowledge_space_id: knowledge_space_id ?? knowledgeSpaceId,
+            qa_pairs: qa_pairs ?? qaPairs,
+        })),
         createRequest: (input) => ({
             path: `/agents/${input.agent_id}/knowledge/qa-generation/${input.operation_id}/submit`,
             body: compactObject({
@@ -543,6 +709,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_test_scenario_generate_get_instructions',
+        sideEffect: 'write',
         requiredFields: ['icp_profile_id'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -571,6 +738,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_test_scenario_generate_submit',
+        sideEffect: 'write',
         requiredFields: ['operation_id', 'icp_profile_id', 'scenarios'],
         defaultWorkspaceId: true,
         schema: z.object({
@@ -588,9 +756,12 @@ export const agentDesignTools = [
                     name: scenario.name,
                     description: scenario.description,
                     segmentIds: scenario.segment_ids,
+                    // ⚠️ `expect` перечислен ЯВНО: реплики пересобираются по списку полей, и забытый
+                    // ключ не ломает ни сборку, ни схему — ожидания просто не доехали бы до backend.
                     situations: scenario.situations.map((situation) => ({
                         role: situation.role,
                         text: situation.text,
+                        expect: situation.expect,
                     })),
                 })),
             },
@@ -599,6 +770,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_dialog_script_get',
+        sideEffect: 'none',
         requiredFields: ['agent_id'],
         schema: z.object({
             agent_id: uuidSchema,
@@ -610,6 +782,7 @@ export const agentDesignTools = [
     }),
     defineTool({
         name: 'besales_dialog_script_update',
+        sideEffect: 'write',
         requiredFields: ['agent_id', 'graph'],
         schema: z.object({
             agent_id: uuidSchema,