@besales/mcp 0.1.0

package/dist/schemas/mcp-tools.json

@@ -0,0 +1,1192 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "besales-mcp Tool Definitions",
+  "version": "1.1.0-draft",
+  "lastUpdated": "2026-05-12",
+  "description": "MCP tool schemas для besales-mcp npm package. Active v1.5 set содержит PromptHub/ICP/Sandbox/Knowledge external-execution operations и stateless Platform Setup Bridge direct tools. Setup Pipeline session tools сохранены как Phase 4+ future design, но не входят в active toolset.",
+  "executionModes": {
+    "summary": "Каждая active LLM-операция имеет 2 MCP tools: get_instructions + submit. Claude локально между tools выполняет LLM-вызовы своими моделями. Auto-detection через JWT scope mcp:* → external default.",
+    "tools_per_operation": {
+      "single_tool": "Для proxy operations без external mode: Claude вызывает один active tool, besales-api делает работу.",
+      "instructions_submit_pair": "Для external execution: 2 tools — get_instructions returns stages, после локального LLM-вызова submit отправляет результат. Active MCP toolset использует эту пару без дополнительного single-tool flow."
+    }
+  },
+  "tools": [
+    {
+      "name": "besales_icp_create",
+      "description": "Create new ICP profile в workspace. Active Phase 2 PromptHub/ICP operation; не зависит от Setup Pipeline.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "name"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Defaults to the workspace selected during `besales-mcp connect`."
+          },
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "from_dialogues",
+              "from_files",
+              "from_scratch",
+              "ai_generated"
+            ],
+            "default": "from_scratch"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_icp_import_dialogues",
+      "description": "Import dialogue samples from CRM (queued async). Poll status через import job / operation state endpoint; Setup Pipeline events не используются в active Phase 2 toolset.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "icp_id",
+          "crm_connection_id",
+          "gdpr_confirmed"
+        ],
+        "properties": {
+          "icp_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "crm_connection_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "outcome_filter": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "won",
+                "lost",
+                "in_progress"
+              ]
+            },
+            "default": [
+              "won",
+              "lost"
+            ]
+          },
+          "days_ago": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 730,
+            "default": 180
+          },
+          "anonymize": {
+            "type": "boolean",
+            "default": true
+          },
+          "gdpr_confirmed": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_icp_analysis_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION — получить 3-stage instructions для ICP segments + personas analysis. Claude локально: 1) segment_clustering, 2) classification, 3) persona_generation. После — submit через besales_icp_analysis_submit. Этот flow дешевле и качественнее чем internal proxy через prompt-services с gpt-4o-mini.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "icp_profile_id"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Defaults to the workspace selected during `besales-mcp connect`."
+          },
+          "icp_profile_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "business_context": {
+            "type": "object"
+          }
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "stages": {
+            "type": "array"
+          },
+          "expires_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_icp_analysis_submit",
+      "description": "Submit ICP analysis results после Claude локально выполнил 3 stages.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "operation_id",
+          "icp_profile_id",
+          "segments",
+          "personas"
+        ],
+        "properties": {
+          "workspace_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional override. Defaults to the workspace selected during `besales-mcp connect`."
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "icp_profile_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "segments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "name"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "format": "uuid",
+                  "description": "Stable segment id. Required when personas reference a newly created segment."
+                },
+                "name": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "demographics": {
+                  "type": "object"
+                },
+                "pains": {
+                  "type": "array",
+                  "items": {}
+                },
+                "motivations": {
+                  "type": "array",
+                  "items": {}
+                },
+                "language_style": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "personas": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "name",
+                "segment_id"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "segment_id": {
+                  "type": "string",
+                  "format": "uuid",
+                  "description": "Existing segment id or id of a segment in this submit payload."
+                },
+                "description": {
+                  "type": "string"
+                },
+                "pain_points": {
+                  "type": "array",
+                  "items": {}
+                },
+                "goals": {
+                  "type": "array",
+                  "items": {}
+                },
+                "objections": {
+                  "type": "object"
+                },
+                "messaging_hints": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_generate_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION — получить 4-stage instructions для prompt generation: 1) structure_builder, 2) industry_validator, 3) prompt_tester, 4) finalizer. Claude локально выполняет каждую stage с Sonnet/Opus используя returned system prompts + JSON schemas. После — submit через besales_prompt_generate_submit.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "icp_profile_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "business_context": {
+            "type": "object"
+          },
+          "style_hints": {
+            "type": "object",
+            "properties": {
+              "formality": {
+                "type": "string",
+                "enum": [
+                  "formal",
+                  "casual",
+                  "friendly"
+                ]
+              },
+              "verbosity": {
+                "type": "string",
+                "enum": [
+                  "concise",
+                  "balanced",
+                  "detailed"
+                ]
+              },
+              "language": {
+                "type": "string",
+                "default": "ru"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_generate_submit",
+      "description": "Submit готовый prompt после Claude выполнил 4 stages. Создаёт новую prompt version.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "operation_id",
+          "stages",
+          "final_content"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "stages": {
+            "type": "array",
+            "minItems": 4,
+            "items": {
+              "type": "object",
+              "required": [
+                "name",
+                "output"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "enum": [
+                    "structure_builder",
+                    "industry_validator",
+                    "prompt_tester",
+                    "finalizer"
+                  ]
+                },
+                "output": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "final_content": {
+            "type": "string"
+          },
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "total_tokens": {
+                "type": "integer"
+              },
+              "models": {
+                "type": "object"
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_iterate_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION — 2-stage instructions для iteration: 1) iteration_analysis (analyze user feedback), 2) iteration_recommendation (propose changes).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "base_version_id",
+          "feedback"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "base_version_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "feedback": {
+            "type": "object",
+            "properties": {
+              "general_comments": {
+                "type": "string"
+              },
+              "selections": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_iterate_submit",
+      "description": "Submit готовый iteration result.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "operation_id",
+          "stages",
+          "proposed_changes",
+          "preview_content"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "stages": {
+            "type": "array",
+            "minItems": 2,
+            "items": {
+              "type": "object",
+              "required": [
+                "name",
+                "output"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "enum": [
+                    "iteration_analysis",
+                    "iteration_recommendation"
+                  ]
+                },
+                "output": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "proposed_changes": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "preview_content": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_analyze_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION — 4-stage instructions для static analysis: 1) grammar, 2) industry, 3) structure, 4) aggregation. Returns system prompts + JSON schemas; Claude выполняет, submits aggregated issues.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "version_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "version_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "modes": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "grammar",
+                "structure",
+                "industry",
+                "contradictions",
+                "completeness"
+              ]
+            },
+            "default": [
+              "grammar",
+              "structure",
+              "contradictions"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_analyze_submit",
+      "description": "Submit готовый analysis result.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "operation_id",
+          "stages",
+          "aggregated_issues"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "stages": {
+            "type": "array",
+            "minItems": 4,
+            "items": {
+              "type": "object",
+              "required": [
+                "name",
+                "output"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "enum": [
+                    "grammar",
+                    "industry",
+                    "structure",
+                    "aggregation"
+                  ]
+                },
+                "output": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "aggregated_issues": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_prompt_finalize",
+      "description": "Approve prompt version → AgentPromptSyncService creates new agent_version → runtime starts using new prompt.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "draft_version_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "draft_version_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "changelog_note": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_run_start",
+      "description": "Start sandbox run для agent (full multi-persona × multi-scenario testing). Queued async.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "scenario_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          "options": {
+            "type": "object",
+            "properties": {
+              "check_routing": {
+                "type": "boolean",
+                "default": false
+              },
+              "check_pipeline_transitions": {
+                "type": "boolean",
+                "default": false
+              },
+              "check_agent_actions": {
+                "type": "boolean",
+                "default": false
+              },
+              "run_rag_golden_tests": {
+                "type": "boolean",
+                "default": false
+              },
+              "turns_per_scenario": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 50,
+                "default": 10
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_findings_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION (NEW v3.1) — получить instructions для analysis sandbox results. Claude локально получает sandbox report + ICP/ТЗ контекст из чата → выдаёт structured findings (категория / severity / suggestion). Это ключевой fix для кейса с irrelevant findings от gpt-4o-mini.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "run_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "run_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_sandbox_findings_submit",
+      "description": "Submit Claude-generated sandbox findings. Findings сохраняются как SandboxRunFeedback с status=SUBMITTED (improvement-lab consumes).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "run_id",
+          "operation_id",
+          "findings"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "run_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "findings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "category",
+                "severity",
+                "message"
+              ],
+              "properties": {
+                "scenario_id": {
+                  "type": "string",
+                  "format": "uuid"
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "hallucination",
+                    "wrong_action",
+                    "missed_trigger",
+                    "wrong_pipeline_transition",
+                    "rag_miss",
+                    "bad_tone",
+                    "other"
+                  ]
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "low",
+                    "medium",
+                    "critical"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "suggestion": {
+                  "type": "string"
+                },
+                "turn_index": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_simulation_findings_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION (NEW v3.1) — после simulation (или sandbox-text-only) получить raw dialogues для analysis. Claude добавляет ICP/ТЗ context в анализ — получаются relevant findings, которые internal gpt-4o-mini часто не видит (например, character-level inconsistency).",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "simulation_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "simulation_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_simulation_findings_submit",
+      "description": "Submit Claude-generated simulation findings.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "simulation_id",
+          "operation_id",
+          "findings"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "simulation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "findings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "category",
+                "severity",
+                "message"
+              ],
+              "properties": {
+                "dialogue_id": {
+                  "type": "string",
+                  "format": "uuid"
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "hallucination",
+                    "wrong_action",
+                    "bad_tone",
+                    "missed_context",
+                    "contradiction",
+                    "off_topic",
+                    "other"
+                  ]
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "low",
+                    "medium",
+                    "critical"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "suggestion": {
+                  "type": "string"
+                },
+                "reference_message_index": {
+                  "type": "integer"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_qa_generation_get_instructions",
+      "description": "⭐ EXTERNAL EXECUTION (NEW v3.1) — получить instructions для bulk Q&A pairs generation для knowledge base. Claude генерирует 30+ Q&A pairs из company context + ICP и возвращает structured список. Active PromptHub/Knowledge operation, не Setup Pipeline step.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "namespace_context": {
+            "type": "string"
+          },
+          "company_context": {
+            "type": "string"
+          },
+          "icp_profile_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "target_count": {
+            "type": "integer",
+            "minimum": 5,
+            "maximum": 100,
+            "default": 30
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_qa_generation_submit",
+      "description": "Submit Claude-generated Q&A pairs → создаются entries в knowledge_sources.",
+      "inputSchema": {
+        "type": "object",
+        "required": [
+          "agent_id",
+          "operation_id",
+          "qa_pairs"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "operation_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "knowledge_space_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "qa_pairs": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "question",
+                "answer"
+              ],
+              "properties": {
+                "question": {
+                  "type": "string"
+                },
+                "answer": {
+                  "type": "string"
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_context_get",
+      "description": "Get sanitized platform setup context first when user gives platformId. Returns platform, agents, router, triggers, behavior, follow-up, pipeline settings and readiness flags; never returns channel credentials or secrets.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_agent_list",
+      "description": "List agents attached to an existing platform. Use after context when the user wants to inspect or choose an agent before targeted setup mutations.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_agent_create",
+      "description": "Create a REGULAR AgentChat inside an existing platform. Does not set production prompt content; use PromptHub tools for prompt generation/finalize.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "name", "model_lane"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "description": { "type": ["string", "null"] },
+          "model_lane": { "type": "string", "enum": ["CHEAP", "STANDARD", "DEEP"] },
+          "default_icp_profile_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    },
+    {
+      "name": "besales_agent_update",
+      "description": "Patch safe AgentChat metadata for an existing platform agent. Direct baseSystemPrompt edits are rejected; use PromptHub flow for prompt changes.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "agent_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "agent_id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "description": { "type": ["string", "null"] },
+          "model_lane": { "type": "string", "enum": ["CHEAP", "STANDARD", "DEEP"] },
+          "default_icp_profile_id": { "type": ["string", "null"], "format": "uuid" },
+          "use_global_history": { "type": "boolean" },
+          "adapt_to_user_language": { "type": "boolean" }
+        }
+      }
+    },
+    {
+      "name": "besales_agent_tools_update",
+      "description": "Patch tool bindings for one agent without deleting omitted tools. Use to enable, disable, reprioritize or add existing workspace/platform tools.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "agent_id", "tools"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "agent_id": { "type": "string", "format": "uuid" },
+          "tools": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["tool_id"],
+              "properties": {
+                "tool_id": { "type": "string" },
+                "priority": { "type": "integer", "minimum": 1, "maximum": 100 },
+                "is_enabled": { "type": "boolean" },
+                "agent_specific_conditions": { "type": ["object", "null"] }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "besales_router_update",
+      "description": "Patch router metadata/additionalPrompt only. Routing rules are separate. Direct routing or skip-LLM changes require explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "model": { "type": "string" },
+          "temperature": { "type": "number", "minimum": 0, "maximum": 2 },
+          "max_tokens": { "type": ["integer", "null"], "minimum": 1 },
+          "additional_prompt": { "type": ["string", "null"] },
+          "adapt_to_user_language": { "type": "boolean" },
+          "skip_llm_routing": { "type": "boolean" },
+          "direct_routing_agent_id": { "type": ["string", "null"], "format": "uuid" },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_routing_rule_upsert",
+      "description": "Create or patch one router routing rule. Does not bulk replace the router. Direct agent routing requires explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "routing_strategy", "custom_router_prompt"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "routing_rule_id": { "type": "string", "format": "uuid" },
+          "routing_strategy": { "type": "string", "enum": ["LEAD_STATUS", "CUSTOM_VARIABLE"] },
+          "deal_mode": { "type": ["string", "null"] },
+          "custom_variable_id": { "type": ["string", "null"], "format": "uuid" },
+          "variable_value": { "type": ["string", "null"] },
+          "custom_router_prompt": { "type": "string" },
+          "is_enabled": { "type": "boolean" },
+          "priority": { "type": "integer", "minimum": 0 },
+          "skip_llm": { "type": "boolean" },
+          "direct_agent_id": { "type": ["string", "null"], "format": "uuid" },
+          "lead_statuses": { "type": "array", "items": { "type": "object" } },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_trigger_upsert",
+      "description": "Create trigger or patch trigger metadata for an agent. Existing actions are not bulk-replaced; webhook, operator, silent AI, CRM, calendar, outbound and follow-up actions require explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "agent_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "agent_id": { "type": "string", "format": "uuid" },
+          "trigger_id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "condition": { "type": "string" },
+          "is_enabled": { "type": "boolean" },
+          "priority": { "type": "integer", "minimum": 1, "maximum": 100 },
+          "stop_propagation": { "type": "boolean" },
+          "scope": { "type": "string", "enum": ["ON_USER_MESSAGE"] },
+          "metadata": { "type": "object" },
+          "actions": { "type": "array", "items": { "type": "object" } },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_behavior_update",
+      "description": "Patch allowlisted AgentBehavior fields for a platform. Operator/CRM-affecting behavior changes require explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "updates"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "updates": { "type": "object" },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_followup_sequence_upsert",
+      "description": "Create or patch a follow-up sequence definition only. Runtime executions and scheduled messages are read-only; enabling requires explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "name", "type", "trigger", "config"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "sequence_id": { "type": "string", "format": "uuid" },
+          "name": { "type": "string" },
+          "description": { "type": ["string", "null"] },
+          "type": { "type": "string", "enum": ["MEETING_REMINDER", "INACTIVE_USER_REACTIVATION", "LOST_CLIENTS"] },
+          "enabled": { "type": "boolean" },
+          "trigger": { "type": "string", "enum": ["USER_INACTIVITY", "DEAL_CLOSED", "BIRTHDAY_DATE", "MEETING_TIME", "CUSTOM_SCHEDULE", "LOST_CLIENTS"] },
+          "config": { "type": "object" },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_pipeline_settings_update",
+      "description": "Patch allowlisted platform PipelineSettings. CRM stage movement or lead/contact creation fields require explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "updates"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "updates": { "type": "object" },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_platform_settings_update",
+      "description": "Patch allowlisted platform settings only. Token/API key/secret fields are blocked; CRM-writing settings require explicit_confirmation.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "settings"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "settings": { "type": "object" },
+          "explicit_confirmation": { "type": "boolean" },
+          "confirmation_reason": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "besales_audit_revert",
+      "description": "Revert a reversible audit log created by Platform Setup Bridge for the same workspace/platform. CREATE reverts use disable/archive semantics where supported.",
+      "inputSchema": {
+        "type": "object",
+        "required": ["platform_id", "audit_log_id"],
+        "properties": {
+          "platform_id": { "type": "string", "format": "uuid" },
+          "audit_log_id": { "type": "string", "format": "uuid" }
+        }
+      }
+    }
+  ],
+  "resources": [
+    {
+      "uri": "besales://concepts/icp",
+      "name": "ICP Concept Reference",
+      "description": "Что такое ICP, segments / personas / scenarios.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/triggers",
+      "name": "Actions & Triggers Reference",
+      "description": "agent_actions, step types, condition language.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/sandbox",
+      "name": "Sandbox Reference",
+      "description": "Что такое sandbox, какие сценарии тестирует.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/handoff",
+      "name": "Multi-agent Routing & Handoffs",
+      "description": "Routing rules vs handoff rules, memory transfer.",
+      "mimeType": "text/markdown"
+    },
+    {
+      "uri": "besales://concepts/external-execution",
+      "name": "External Execution Pattern (NEW v3.1)",
+      "description": "Как работает 2-step pattern instructions/submit для LLM операций. Когда использовать external vs internal mode.",
+      "mimeType": "text/markdown"
+    }
+  ],
+  "summary": {
+    "total_tools": 31,
+    "tools_by_category": {
+      "icp_external_execution": 2,
+      "prompt_generation_external": 2,
+      "prompt_iteration_external": 2,
+      "prompt_analysis_external": 2,
+      "prompt_finalize": 1,
+      "sandbox_run_start": 1,
+      "sandbox_findings_external": 2,
+      "simulation_findings_external": 2,
+      "qa_generation_external": 2,
+      "platform_setup_bridge": 13
+    },
+    "external_execution_pairs": [
+      "besales_icp_analysis_get_instructions / submit",
+      "besales_prompt_generate_get_instructions / submit",
+      "besales_prompt_iterate_get_instructions / submit",
+      "besales_prompt_analyze_get_instructions / submit",
+      "besales_sandbox_findings_get_instructions / submit",
+      "besales_simulation_findings_get_instructions / submit",
+      "besales_qa_generation_get_instructions / submit"
+    ],
+    "newly_added_in_v3_1": [
+      "besales_sandbox_findings_get_instructions",
+      "besales_sandbox_findings_submit",
+      "besales_simulation_findings_get_instructions",
+      "besales_simulation_findings_submit",
+      "besales_qa_generation_get_instructions",
+      "besales_qa_generation_submit"
+    ],
+    "newly_added_in_p3_x_platform_setup_bridge": [
+      "besales_platform_context_get",
+      "besales_agent_list",
+      "besales_agent_create",
+      "besales_agent_update",
+      "besales_agent_tools_update",
+      "besales_router_update",
+      "besales_routing_rule_upsert",
+      "besales_trigger_upsert",
+      "besales_behavior_update",
+      "besales_followup_sequence_upsert",
+      "besales_pipeline_settings_update",
+      "besales_platform_settings_update",
+      "besales_audit_revert"
+    ],
+    "deferred_phase4_setup_tools": [
+      "besales_business_context_save",
+      "besales_channel_setup_save",
+      "besales_crm_setup_save",
+      "besales_finalize_agent",
+      "besales_get_step_guidance",
+      "besales_setup_events_poll",
+      "besales_setup_session_advance",
+      "besales_setup_session_create",
+      "besales_setup_session_get",
+      "besales_setup_step_submit_output"
+    ]
+  }
+}