@agifyai/leadify-mcp 8.6.4 → 8.6.5

package/dist/client.d.ts

@@ -8,5 +8,11 @@ export declare class LeadifyClient {
     put(path: string, body: unknown): Promise<unknown>;
     patch(path: string, body: unknown): Promise<unknown>;
     delete(path: string, body?: unknown): Promise<unknown>;
+    /**
+     * Invoke an authenticated oRPC procedure. The API-key facade exposes most
+     * everyday operations as REST, while hash-pinned schema migrations remain
+     * intentionally available only through the admin oRPC boundary.
+     */
+    rpc(path: string, input: unknown): Promise<unknown>;
 }
 export declare function getClient(): LeadifyClient;

package/dist/client.js

@@ -57,6 +57,19 @@ export class LeadifyClient {
         const url = new URL(path, this.baseUrl);
         return this.request("DELETE", url, body);
     }
+    /**
+     * Invoke an authenticated oRPC procedure. The API-key facade exposes most
+     * everyday operations as REST, while hash-pinned schema migrations remain
+     * intentionally available only through the admin oRPC boundary.
+     */
+    async rpc(path, input) {
+        const url = new URL(`/rpc/${path.replace(/^\/+/, "")}`, this.baseUrl);
+        const data = await this.request("POST", url, { json: input });
+        if (data && typeof data === "object" && "json" in data) {
+            return data.json;
+        }
+        return data;
+    }
 }
 let _client = null;
 export function getClient() {

package/dist/tools/schema.d.ts

@@ -1,5 +1,5 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type LeadifyClient } from "../client.js";
-type SchemaClient = Pick<LeadifyClient, "get" | "post">;
+type SchemaClient = Pick<LeadifyClient, "get" | "post" | "rpc">;
 export declare function registerSchemaTools(server: McpServer, client?: SchemaClient): void;
 export {};

package/dist/tools/schema.js

@@ -78,6 +78,42 @@ export function registerSchemaTools(server, client) {
             return handleToolError(error);
         }
     });
+    // ── schema_migration_preview / apply_schema_migration ─────────────────
+    server.tool("schema_migration_preview", "Preview the exact hash-pinned schema migration required to make a lead group READY. " +
+        "This is read-only. Review the returned expectedSchemaHash, planHash, impacted leads and " +
+        "conversion actions before calling apply_schema_migration.", {
+        lead_group_id: z.string().describe("ID of the lead group to inspect."),
+    }, async ({ lead_group_id }) => {
+        try {
+            const data = await (client ?? getClient()).rpc("leadGroups/schemaMigrationPreview", { leadGroupId: lead_group_id });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
+    server.tool("apply_schema_migration", "Apply a destructive schema migration only after schema_migration_preview has been read and " +
+        "the exact expected_schema_hash and expected_plan_hash have been supplied. This API performs " +
+        "its own optimistic hash checks. Use only for the reviewed lead group; reread its leads and " +
+        "schema readiness afterwards.", {
+        lead_group_id: z.string().describe("ID of the reviewed lead group."),
+        expected_schema_hash: z.string().regex(/^[a-f0-9]{64}$/).describe("expectedSchemaHash from the fresh preview."),
+        expected_plan_hash: z.string().regex(/^[a-f0-9]{64}$/).describe("planHash from the same fresh preview."),
+        confirmation: z.literal("apply_destructive_schema_migration").describe("Exact acknowledgement required by the server."),
+    }, async ({ lead_group_id, expected_schema_hash, expected_plan_hash, confirmation }) => {
+        try {
+            const data = await (client ?? getClient()).rpc("leadGroups/applySchemaMigration", {
+                leadGroupId: lead_group_id,
+                expectedSchemaHash: expected_schema_hash,
+                expectedPlanHash: expected_plan_hash,
+                confirmation,
+            });
+            return toolResult(data);
+        }
+        catch (error) {
+            return handleToolError(error);
+        }
+    });
     // ── delete_columns ─────────────────────────────────────────────────────
     server.tool("delete_columns", "Remove one or more columns (fields) from a lead group's schema and all lead data " +
         "stored in those fields. This action is irreversible — field definitions and values " +

package/package.json

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