@agifyai/leadify-mcp 3.5.0 → 3.6.0

package/dist/server.js

@@ -16,7 +16,7 @@ import { registerPipelineTools } from "./tools/pipeline.js";
 export function createServer() {
     const server = new McpServer({
         name: "leadify",
-        version: "3.5.0",
+        version: "3.6.0",
     });
     registerAuthTools(server);
     registerOrganizationTools(server);

package/dist/tools/fine_tuning.js

@@ -4,6 +4,17 @@ import { toolResult, handleToolError } from "../types.js";
 // Dedicated tool for the Fine Tuning page (separate from OutreachSettings).
 // Both concepts live in the DB (FineTuning + OutreachSettings) and the API
 // keeps them strictly separated: this endpoint NEVER touches OutreachSettings.
+//
+// Two write tools coexist by design, with NON-OVERLAPPING contracts:
+//   - append_fine_tuning  → ALWAYS appends, never replaces. Contractual guarantee
+//                            for the iterative build-up pattern (skill operator
+//                            accumulates rules and examples as the user iterates).
+//   - set_fine_tuning     → WHOLESALE replace of ONE section. Use when you need
+//                            to wipe + rewrite a section cleanly (e.g. after a big
+//                            refactor, or to clear a section by passing empty
+//                            content).
+// The split exists so neither caller is ever confused about which behavior
+// they triggered.
 export function registerFineTuningTools(server) {
     // ── get_fine_tuning ───────────────────────────────────────────────────
     server.tool("get_fine_tuning", "Get the fine tuning configuration for a specific lead group. Returns exactly " +
@@ -30,4 +41,44 @@ export function registerFineTuningTools(server) {
             return handleToolError(error);
         }
     });
+    // ── set_fine_tuning ───────────────────────────────────────────────────
+    // WHOLESALE replace of one Fine Tuning section. Distinct from
+    // append_fine_tuning (which is append-only, contractual). Both tools
+    // coexist intentionally — pick the right one for the intent.
+    server.tool("set_fine_tuning", "WHOLESALE replace ONE section of the fine tuning configuration for a lead group. " +
+        "The target section is fully overwritten with the new content. " +
+        "This is the destructive counterpart of append_fine_tuning: use it when you need " +
+        "to wipe and rewrite a section cleanly (big refactor, schema change, full clear). " +
+        "SIBLING SECTIONS ARE NOT TOUCHED. Only the named section is replaced; the other 3 " +
+        "Markdown sections, supportedLanguages, and fallbackLanguage stay intact. " +
+        "To clear a section, pass content=\"\". " +
+        "DO NOT use this for incremental edits — use append_fine_tuning instead so the " +
+        "iterative build-up pattern is preserved (no accidental wipe of accumulated rules " +
+        "or examples). " +
+        "The 4 replaceable sections are: nonNegotiableRules, pitfalls, structure, examples. " +
+        "Languages (supportedLanguages, fallbackLanguage) are managed separately via the " +
+        "Fine Tuning UI or by a dedicated languages tool — this endpoint does not touch them.", {
+        lead_group_id: z
+            .string()
+            .describe("ID of the lead group whose fine tuning section to overwrite."),
+        section: z
+            .enum(["nonNegotiableRules", "pitfalls", "structure", "examples"])
+            .describe("Which Fine Tuning section to replace. One of: " +
+            "nonNegotiableRules | pitfalls | structure | examples."),
+        content: z
+            .string()
+            .describe("New content for the section (Markdown). The section is replaced WHOLESALE — " +
+            "any previous content is lost. Pass an empty string to clear the section."),
+    }, async ({ lead_group_id, section, content }) => {
+        try {
+            const data = await getClient().put(`/api/lead-group/${encodeURIComponent(lead_group_id)}/fine-tuning`, { section, content });
+            return toolResult({
+                ...(data && typeof data === "object" ? data : {}),
+                _note: `Wholesale replace of section '${section}' for lead group ${lead_group_id}.`,
+            });
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agifyai/leadify-mcp",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "MCP server for Leadify lead management API",
   "type": "module",
   "main": "dist/index.js",