@appaflytech/wappa-mcp 0.0.9 → 0.0.11

package/dist/index.js

@@ -1,283 +1,47 @@
 #!/usr/bin/env node
 /**
- * WAPPA Admin API MCP Server
+ * WAPPA Admin API MCP Server — stdio entry point
  *
- * Provides Claude Code with direct access to WAPPA (Web as Platform) Admin API.
- * Supports component CRUD, page management, widget operations, and more.
+ * Supports two auth modes controlled by environment variables:
+ *   1. Email/password  — WAP_EMAIL + WAP_PASSWORD (legacy, default)
+ *   2. API Key         — WAP_API_KEY (Organisation API Key, no sign-in needed)
  *
+ * Provides Claude Code / Cursor with direct access to WAPPA Admin API tools.
  */
-import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
 import { config as loadDotenv } from "dotenv";
-import { TokenManager } from "./auth.js";
-import { WapClient } from "./client.js";
-import { getComponentTools } from "./tools/components.js";
-import { getPageTools } from "./tools/pages.js";
-import { getWidgetTools } from "./tools/widgets.js";
-import { getGeneralTools } from "./tools/general.js";
-import { getSiteTools } from "./tools/sites.js";
-import { getEntityTools } from "./tools/entities.js";
-import { getDynamicEntityTools } from "./tools/dynamic-entities.js";
-import { getLayoutTools } from "./tools/layouts.js";
-import { getQueryTools } from "./tools/queries.js";
-import { getMenuTools } from "./tools/menus.js";
-import { getThemeTools } from "./tools/themes.js";
-import { getLanguageTools } from "./tools/languages.js";
-// ─── Configuration ─────────────────────────────────────────
+import { buildMcpServerForSession } from "./factory.js";
 // Load .env file when running locally (no-op if vars already set by MCP client)
 // quiet:true prevents dotenvx from writing to stdout (which breaks MCP stdio protocol)
 loadDotenv({ quiet: true, override: false });
 function getConfig() {
     const required = (key) => {
         const value = process.env[key];
-        if (!value) {
+        if (!value)
             throw new Error(`Missing required environment variable: ${key}`);
-        }
         return value;
     };
-    return {
-        adminApiUrl: required("WAP_ADMIN_API_URL"),
-        siteKey: process.env.WAP_SITE_KEY || process.env.WAP_SITE_ID || "", // key (slug) takes priority
-        email: required("WAP_EMAIL"),
-        password: required("WAP_PASSWORD"),
-        language: process.env.WAP_LANGUAGE || "en-us",
-    };
-}
-// ─── Server Setup ──────────────────────────────────────────
-async function main() {
-    const config = getConfig();
-    const tokenManager = new TokenManager({
-        adminApiUrl: config.adminApiUrl,
-        email: config.email,
-        password: config.password,
-    });
-    const client = new WapClient({
-        adminApiUrl: config.adminApiUrl,
-        siteKey: config.siteKey,
-        language: config.language,
-        tokenManager,
-    });
-    // Collect all tools
-    const componentTools = getComponentTools(client);
-    const pageTools = getPageTools(client);
-    const widgetTools = getWidgetTools(client);
-    const generalTools = getGeneralTools(client);
-    const siteTools = getSiteTools(client);
-    const entityTools = getEntityTools(client);
-    const dynamicEntityTools = getDynamicEntityTools(client);
-    const layoutTools = getLayoutTools(client);
-    const queryTools = getQueryTools(client);
-    const menuTools = getMenuTools(client);
-    const themeTools = getThemeTools(client);
-    const languageTools = getLanguageTools(client);
-    const allTools = {
-        ...componentTools,
-        ...pageTools,
-        ...widgetTools,
-        ...generalTools,
-        ...siteTools,
-        ...entityTools,
-        ...dynamicEntityTools,
-        ...layoutTools,
-        ...queryTools,
-        ...menuTools,
-        ...themeTools,
-        ...languageTools,
-    };
-    // Create MCP Server
-    const server = new McpServer({
-        name: "wappa-mcp",
-        version: "1.0.0",
-    });
-    // Register each tool with the MCP server
-    for (const [toolName, toolDef] of Object.entries(allTools)) {
-        const { description, inputSchema, handler } = toolDef;
-        // Convert JSON Schema properties to Zod schema
-        const zodShape = {};
-        const props = inputSchema.properties || {};
-        const required = inputSchema.required || [];
-        for (const [propName, propDef] of Object.entries(props)) {
-            let zodType;
-            switch (propDef.type) {
-                case "string":
-                    zodType = propDef.enum ? z.enum(propDef.enum) : z.string();
-                    break;
-                case "number":
-                    zodType = z.number();
-                    break;
-                case "boolean":
-                    zodType = z.boolean();
-                    break;
-                case "object":
-                    zodType = z.record(z.string(), z.unknown());
-                    break;
-                case "array":
-                    zodType = z.array(z.unknown());
-                    break;
-                default:
-                    zodType = z.unknown();
-            }
-            if (propDef.description) {
-                zodType = zodType.describe(propDef.description);
-            }
-            if (!required.includes(propName)) {
-                zodType = zodType.optional();
-            }
-            zodShape[propName] = zodType;
-        }
-        server.tool(`wappa_${toolName}`, description, zodShape, async (args) => {
-            try {
-                return await handler(args);
-            }
-            catch (error) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: ${error.message}`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        });
+    const adminApiUrl = required("WAP_ADMIN_API_URL").replace(/\/+$/, "");
+    const siteKey = process.env.WAP_SITE_KEY || process.env.WAP_SITE_ID || "";
+    const language = process.env.WAP_LANGUAGE || "en-us";
+    let auth;
+    if (process.env.WAP_API_KEY) {
+        auth = { kind: "apiKey", apiKey: process.env.WAP_API_KEY };
     }
-    // ─── Resources ─────────────────────────────────────────────
-    // Static: server config (credentials hariç)
-    server.resource("wappa-config", "wappa://config", {
-        description: "Aktif WAPPA sunucu yapılandırması (site ID, dil, API URL)",
-        mimeType: "application/json",
-    }, async (uri) => ({
-        contents: [
-            {
-                uri: uri.href,
-                mimeType: "application/json",
-                text: JSON.stringify({
-                    adminApiUrl: config.adminApiUrl,
-                    siteKey: config.siteKey,
-                    language: config.language,
-                }, null, 2),
-            },
-        ],
-    }));
-    // Dynamic: site listesi
-    server.resource("wappa-sites", "wappa://sites", {
-        description: "WAPPA'daki tüm site listesi (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getSites({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Dynamic: aktif sitenin sayfaları
-    server.resource("wappa-pages", "wappa://pages", {
-        description: "Aktif sitedeki tüm sayfalar (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getPages({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Dynamic: bileşenler
-    server.resource("wappa-components", "wappa://components", {
-        description: "Aktif sitedeki tüm bileşenler (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getComponents({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Dynamic: entityler
-    server.resource("wappa-entities", "wappa://entities", {
-        description: "Tanımlı tüm entity şemaları (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getEntities({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
+    else {
+        auth = {
+            kind: "emailPwd",
+            adminApiUrl,
+            email: required("WAP_EMAIL"),
+            password: required("WAP_PASSWORD"),
         };
-    });
-    // Dynamic: layoutlar
-    server.resource("wappa-layouts", "wappa://layouts", {
-        description: "Aktif sitedeki tüm layoutlar (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getLayouts({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Dynamic: sorgu şablonları
-    server.resource("wappa-queries", "wappa://queries", {
-        description: "Kayıtlı tüm query/sorgu şablonları (canlı veri)",
-        mimeType: "application/json",
-    }, async (uri) => {
-        const result = await client.getQueries({});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Dynamic Resource Template: belirli bir entity'nin kayıtları
-    server.resource("wappa-entity-records", new ResourceTemplate("wappa://entities/{entityId}/records", {
-        list: undefined,
-    }), {
-        description: "Belirli bir entity'nin tüm kayıtları. URI: wappa://entities/{entityId}/records",
-        mimeType: "application/json",
-    }, async (uri, { entityId }) => {
-        const result = await client.getDynamicEntities(entityId, {});
-        return {
-            contents: [
-                {
-                    uri: uri.href,
-                    mimeType: "application/json",
-                    text: JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    });
-    // Start the server
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    }
+    return { adminApiUrl, siteKey, language, auth };
+}
+async function main() {
+    const cfg = getConfig();
+    const { server } = buildMcpServerForSession(cfg);
+    await server.connect(new StdioServerTransport());
     console.error("WAPPA MCP Server running on stdio");
 }
 main().catch((error) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAoB,MAAM,cAAc,CAAC;AAE1E,gFAAgF;AAChF,uFAAuF;AACvF,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAE7C,SAAS,SAAS;IAChB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC;IAErD,IAAI,IAAiB,CAAC;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,IAAI,GAAG;YACL,IAAI,EAAE,UAAU;YAChB,WAAW;YACX,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC;YAC5B,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * WAPPA MCP HTTP Server
+ *
+ * Exposes the same MCP tools as the stdio entry point but over HTTP using
+ * the Streamable-HTTP transport (MCP spec §HTTP Transport).
+ *
+ * Admin UI and external clients can use this server by:
+ *   1. Sending POST /mcp with an initialize request + auth headers
+ *   2. Continuing the session with the returned Mcp-Session-Id header
+ *
+ * Auth headers (required on every request):
+ *   Authorization: Bearer <jwt>       — Admin UI passthrough
+ *   X-API-Key: <key>                  — Backend Organisation API Key
+ *   X-Wappa-Site-Key: <slug>          — target site slug
+ *   X-Wappa-Admin-Api: <url>          — backend Admin API base URL
+ *   X-Wappa-Language: <locale>        — optional, default "en-us"
+ *
+ * Environment variables:
+ *   PORT              — HTTP port (default 4100)
+ *   ALLOWED_ORIGINS   — comma-separated CORS origins (default "*")
+ *   RATE_LIMIT_RPM    — requests per minute per IP (default 120)
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/server.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * WAPPA MCP HTTP Server
+ *
+ * Exposes the same MCP tools as the stdio entry point but over HTTP using
+ * the Streamable-HTTP transport (MCP spec §HTTP Transport).
+ *
+ * Admin UI and external clients can use this server by:
+ *   1. Sending POST /mcp with an initialize request + auth headers
+ *   2. Continuing the session with the returned Mcp-Session-Id header
+ *
+ * Auth headers (required on every request):
+ *   Authorization: Bearer <jwt>       — Admin UI passthrough
+ *   X-API-Key: <key>                  — Backend Organisation API Key
+ *   X-Wappa-Site-Key: <slug>          — target site slug
+ *   X-Wappa-Admin-Api: <url>          — backend Admin API base URL
+ *   X-Wappa-Language: <locale>        — optional, default "en-us"
+ *
+ * Environment variables:
+ *   PORT              — HTTP port (default 4100)
+ *   ALLOWED_ORIGINS   — comma-separated CORS origins (default "*")
+ *   RATE_LIMIT_RPM    — requests per minute per IP (default 120)
+ */
+import express from "express";
+import helmet from "helmet";
+import cors from "cors";
+import rateLimit from "express-rate-limit";
+import { config as loadDotenv } from "dotenv";
+import { wappaAuthMiddleware } from "./http/auth.js";
+import { handleMcpPost, handleMcpGet, handleMcpDelete, } from "./http/transport.js";
+import { closeAllSessions } from "./http/session.js";
+loadDotenv({ quiet: true, override: false });
+const PORT = Number(process.env.PORT ?? 4100);
+const allowedOrigins = process.env.ALLOWED_ORIGINS
+    ? process.env.ALLOWED_ORIGINS.split(",").map((s) => s.trim())
+    : ["*"];
+const rateLimitRpm = Number(process.env.RATE_LIMIT_RPM ?? 120);
+// ─── App setup ──────────────────────────────────────────────
+const app = express();
+// Security headers
+app.use(helmet());
+// CORS
+app.use(cors({
+    origin: allowedOrigins.includes("*") ? "*" : allowedOrigins,
+    exposedHeaders: ["Mcp-Session-Id"],
+}));
+// Rate limiting
+app.use(rateLimit({
+    windowMs: 60_000,
+    max: rateLimitRpm,
+    standardHeaders: true,
+    legacyHeaders: false,
+}));
+// JSON body (2 MB limit)
+app.use(express.json({ limit: "2mb" }));
+// ─── Routes ─────────────────────────────────────────────────
+app.get("/health", (_req, res) => {
+    res.json({ status: "ok", transport: "streamable-http" });
+});
+// MCP endpoint — auth middleware applied only to /mcp
+app.post("/mcp", wappaAuthMiddleware, (req, res) => {
+    handleMcpPost(req, res).catch((err) => {
+        console.error("MCP POST error:", err);
+        if (!res.headersSent)
+            res.status(500).json({ error: "Internal server error" });
+    });
+});
+app.get("/mcp", wappaAuthMiddleware, (req, res) => {
+    handleMcpGet(req, res).catch((err) => {
+        console.error("MCP GET error:", err);
+        if (!res.headersSent)
+            res.status(500).json({ error: "Internal server error" });
+    });
+});
+app.delete("/mcp", wappaAuthMiddleware, (req, res) => {
+    handleMcpDelete(req, res).catch((err) => {
+        console.error("MCP DELETE error:", err);
+        if (!res.headersSent)
+            res.status(500).json({ error: "Internal server error" });
+    });
+});
+// ─── Start ──────────────────────────────────────────────────
+const httpServer = app.listen(PORT, () => {
+    console.log(`WAPPA MCP HTTP Server listening on port ${PORT}`);
+});
+// Graceful shutdown
+async function shutdown(signal) {
+    console.log(`Received ${signal} — shutting down gracefully`);
+    await closeAllSessions();
+    httpServer.close(() => process.exit(0));
+}
+process.on("SIGTERM", () => void shutdown("SIGTERM"));
+process.on("SIGINT", () => void shutdown("SIGINT"));
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/dynamic-entities.d.ts

@@ -161,18 +161,28 @@ export declare function getDynamicEntityTools(client: WapClient): {
                     type: string;
                     description: string;
                 };
+                historyId: {
+                    type: string;
+                    description: string;
+                };
                 status: {
                     type: string;
                     description: string;
                     enum: string[];
                 };
+                columns: {
+                    type: string;
+                    description: string;
+                };
             };
             required: string[];
         };
         handler: (args: {
             entityId: string;
             id: string;
+            historyId?: string;
             status: string;
+            columns?: unknown[];
         }) => Promise<{
             content: {
                 type: "text";

package/dist/tools/dynamic-entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-entities.d.ts","sourceRoot":"","sources":["../../src/tools/dynamic-entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AASzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgC3B;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB;;;;;;;;;;;;;;;;;;;;;;;wBA+BqB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwChC;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC;SACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmCqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC;SACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkCqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;SAChB;;;;;;;;;;;;;;;;;;;;;;;wBAyBqB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;wBAsBhC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BhC;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,gBAAgB,EAAE,MAAM,CAAC;YACzB,eAAe,CAAC,EAAE,OAAO,CAAC;SAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;;;;;;;EAmBN"}
+{"version":3,"file":"dynamic-entities.d.ts","sourceRoot":"","sources":["../../src/tools/dynamic-entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AASzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgC3B;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB;;;;;;;;;;;;;;;;;;;;;;;wBA+BqB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwChC;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC;SACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmCqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,CAAC;SACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4CqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;SACrB;;;;;;;;;;;;;;;;;;;;;;;wBA0GqB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;wBAsBhC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BhC;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,gBAAgB,EAAE,MAAM,CAAC;YACzB,eAAe,CAAC,EAAE,OAAO,CAAC;SAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BqB;YACpB,QAAQ,EAAE,MAAM,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;;;;;;;EAmBN"}

package/dist/tools/dynamic-entities.js

@@ -157,22 +157,97 @@ Her kolon: { key: "kolonAdı", value: "değer" } formatında.
         },
         // ─── Update Record Status ─────────────────────────────
         update_dynamic_entity_status: {
-            description: "Bir entity kaydının yayın durumunu değiştirir (yayınla/taslağa al).",
+            description: "Bir entity kaydının yayın durumunu değiştirir (yayınla/taslağa al). 'id' kayıt ID'si yeterli; gerekli historyId otomatik çözülür.",
             inputSchema: {
                 type: "object",
                 properties: {
                     entityId: { type: "string", description: "Entity şema ID (GUID)" },
                     id: { type: "string", description: "Kayıt ID" },
+                    historyId: {
+                        type: "string",
+                        description: "Opsiyonel version (history) ID. Verilmezse get_record ile otomatik çözülür.",
+                    },
                     status: {
                         type: "string",
                         description: "Yeni durum: Published | Draft | Deleted",
                         enum: ["Published", "Draft", "Deleted"],
                     },
+                    columns: {
+                        type: "array",
+                        description: "Opsiyonel: durum değişikliğiyle birlikte gönderilecek kolon değerleri",
+                    },
                 },
                 required: ["entityId", "id", "status"],
             },
             handler: async (args) => {
-                const result = await client.updateDynamicEntityStatus(args.entityId, args.id, args.status);
+                let targetId = args.historyId ?? args.id;
+                const shouldSendStatusOnly = !args.historyId && !args.columns && args.status !== "Published";
+                if (shouldSendStatusOnly) {
+                    const result = await client.updateDynamicEntityStatus(args.entityId, targetId, args.status);
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify(result, null, 2) },
+                        ],
+                    };
+                }
+                // For Published, the backend reads a version record (history) by id.
+                // For Draft, it operates on the live record id directly.
+                if (!args.historyId && args.status === "Published") {
+                    try {
+                        const versions = await client.getDynamicEntityVersions(args.entityId, args.id, { pageLength: "1", pageIndex: "0" });
+                        const list = versions?.data?.data ?? versions?.data ?? versions?.Data ?? [];
+                        const first = Array.isArray(list) ? list[0] : null;
+                        // Prefer the dedicated history pointer; some endpoints surface
+                        // a synthetic wrapper `id` that is NOT the history row's PK.
+                        const hid = first?.historyId ?? first?.HistoryId ?? first?.id ?? first?.Id;
+                        if (hid)
+                            targetId = hid;
+                    }
+                    catch {
+                        /* fall back to provided id */
+                    }
+                }
+                const body = { status: args.status };
+                // When the caller doesn't supply columns, harvest existing values
+                // so the backend's CreateVersion (Draft) / Create (Published) paths
+                // have a full payload — otherwise it throws KeyNotFound on
+                // localization lookups or "Column value cannot be null".
+                if (args.columns) {
+                    body.columns = mapColumnsForApi(args.columns);
+                }
+                else {
+                    let cols = [];
+                    // For Published, the live record was already removed by a previous
+                    // Draft transition — read columns from the most recent version
+                    // instead. For Draft, read from the live record.
+                    if (args.status === "Published") {
+                        try {
+                            const ver = await client.getDynamicEntityVersions(args.entityId, args.id, { pageLength: "1", pageIndex: "0" });
+                            const list = ver?.data?.data ?? ver?.data ?? ver?.Data ?? [];
+                            cols = list?.[0]?.columns ?? list?.[0]?.Columns ?? [];
+                        }
+                        catch {
+                            /* best-effort */
+                        }
+                    }
+                    else {
+                        try {
+                            const rec = await client.getDynamicEntity(args.entityId, args.id);
+                            const data = rec?.data ?? rec;
+                            cols = data?.columns ?? data?.Columns ?? [];
+                        }
+                        catch {
+                            /* best-effort */
+                        }
+                    }
+                    if (Array.isArray(cols) && cols.length > 0) {
+                        body.columns = cols.map((c) => ({
+                            name: c.name ?? c.Name ?? c.key,
+                            data: c.data ?? c.Data ?? { refs: [], value: c.value ?? null },
+                        }));
+                    }
+                }
+                const result = await client.updateDynamicEntityStatus(args.entityId, targetId, body);
                 return {
                     content: [
                         { type: "text", text: JSON.stringify(result, null, 2) },