@appaflytech/wappa-mcp 0.0.10 → 0.0.12

package/dist/tools/queries.d.ts

@@ -126,6 +126,10 @@ export declare function getQueryTools(client: WapClient): {
                     type: string;
                     description: string;
                 };
+                queryMaps: {
+                    type: string;
+                    description: string;
+                };
                 cache: {
                     type: string;
                     description: string;
@@ -195,6 +199,10 @@ export declare function getQueryTools(client: WapClient): {
                     type: string;
                     description: string;
                 };
+                queryMaps: {
+                    type: string;
+                    description: string;
+                };
                 cache: {
                     type: string;
                     description: string;
@@ -238,5 +246,271 @@ export declare function getQueryTools(client: WapClient): {
             }[];
         }>;
     };
+    get_query_map: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            id: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    get_query_related_models: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                id: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            id: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    preview_query: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                data: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            data: Record<string, unknown>;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    upsert_bulk_queries: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                queries: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            queries: unknown[];
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    ai_raw_query_generator: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            prompt: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    ai_raw_query_chat: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                messages: {
+                    type: string;
+                    description: string;
+                };
+                currentQuery: {
+                    type: string;
+                    description: string;
+                };
+                currentParameters: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            messages: Array<{
+                role: string;
+                content: string;
+            }>;
+            currentQuery?: string;
+            currentParameters?: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    run_query_v2: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                queryParams: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            name: string;
+            queryParams?: Record<string, string>;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    run_query_with_body: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                parameters: {
+                    type: string;
+                    description: string;
+                };
+                columns: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            name: string;
+            parameters?: Record<string, unknown> | null;
+            columns?: unknown[];
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    preview_query_v2: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                data: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            data: Record<string, unknown>;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    run_query_form: {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                files: {
+                    type: string;
+                    description: string;
+                };
+                columns: {
+                    type: string;
+                    description: string;
+                };
+                pairing: {
+                    type: string;
+                    description: string;
+                };
+                parameters: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: {
+            name: string;
+            files: Array<{
+                filename: string;
+                contentBase64?: string;
+                contentType?: string;
+                path?: string;
+            }>;
+            columns?: unknown[];
+            pairing?: Array<{
+                Column: string;
+                Filename: string;
+            }>;
+            parameters?: Record<string, unknown>;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
 };
 //# sourceMappingURL=queries.d.ts.map

package/dist/tools/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/tools/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsBnB;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;;;;;;;;;;;;;;;;;;;wBA6BqB;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;wBA6Bd;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiFqB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6DvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;wBA2DvB;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;EAUzC"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/tools/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsBnB;YACpB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB;;;;;;;;;;;;;;;;;;;wBA4BqB;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;wBA6Bd;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqFqB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+DvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;wBAsEvB;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;wBAqBd;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;wBAwBd;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;wBA4Bd;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE;;;;;;;;;;;;;;;;;;;wBA6BjC;YAAE,OAAO,EAAE,OAAO,EAAE,CAAA;SAAE;;;;;;;;;;;;;;;;;;;wBAyBtB;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuClB;YACpB,QAAQ,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACnD,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B;;;;;;;;;;;;;;;;;;;;;;;wBAiCqB;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoCqB;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;YAC5C,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;SACrB;;;;;;;;;;;;;;;;;;;wBAgCqB;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDjC;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,KAAK,CAAC;gBACX,QAAQ,EAAE,MAAM,CAAC;gBACjB,aAAa,CAAC,EAAE,MAAM,CAAC;gBACvB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,IAAI,CAAC,EAAE,MAAM,CAAC;aACf,CAAC,CAAC;YACH,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,EAAE,KAAK,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACtC;;;;;;;EA8CN"}

package/dist/tools/queries.js

@@ -34,8 +34,7 @@ export function getQueryTools(client) {
                     params.type = args.type;
                 if (args.pageIndex !== undefined)
                     params.pageIndex = String(args.pageIndex);
-                if (args.pageLength !== undefined)
-                    params.pageLength = String(args.pageLength);
+                params.pageLength = String(args.pageLength ?? 200);
                 const result = await client.getQueries(params);
                 return {
                     content: [
@@ -132,6 +131,10 @@ export function getQueryTools(client) {
                         type: "array",
                         description: "Query parametre tanımları: [{ name, type, defaultValue }]",
                     },
+                    queryMaps: {
+                        type: "array",
+                        description: "Mevcut query sonuç kolonlarının alias ve type eşleştirmeleri. Örn: [{ name: 'Image', type: 'image', alias: 'img', path: 'img', isMultiple: false }]"
+                    },
                     cache: {
                         type: "object",
                         description: "Önbellekleme: { enabled: bool, durationSeconds: number }",
@@ -164,6 +167,7 @@ export function getQueryTools(client) {
                     // tolerates empty lists better than nulls
                     httpMethod: "get",
                     parameters: [],
+                    queryMaps: [],
                     rawQueryMap: [],
                     ...incoming,
                     type,
@@ -206,6 +210,7 @@ export function getQueryTools(client) {
                         description: 'Yanıt biçimi (non-raw): { type: "single" | "multiple" }',
                     },
                     parameters: { type: "array", description: "Parametre tanımları" },
+                    queryMaps: { type: "array", description: "Query kolon eşleştirmeleri" },
                     cache: { type: "object", description: "Önbellekleme ayarları" },
                     transformTemplate: {
                         type: "string",
@@ -229,21 +234,30 @@ export function getQueryTools(client) {
                 catch {
                     /* fall through with empty base */
                 }
-                const data = {
-                    name: current.name ?? current.Name,
-                    title: current.title ?? current.Title,
-                    type: current.type ?? current.Type,
-                    rawQuery: current.rawQuery ?? current.RawQuery,
-                    schema: current.schema ?? current.Schema,
-                    response: current.response ?? current.Response,
-                    parameters: current.parameters ?? current.Parameters ?? [],
-                    rawQueryMap: current.rawQueryMap ?? current.RawQueryMap ?? [],
-                    cache: current.cache ?? current.Cache,
-                    transformTemplate: current.transformTemplate ?? current.TransformTemplate,
-                    httpMethod: current.httpMethod ?? current.HttpMethod ?? "get",
-                    categoryId: current.categoryId ?? current.CategoryId,
-                    ...patch,
-                };
+                const hasCurrent = current &&
+                    typeof current === "object" &&
+                    Object.keys(current).length > 0;
+                const data = hasCurrent
+                    ? {
+                        name: current.name ?? current.Name,
+                        title: current.title ?? current.Title,
+                        type: current.type ?? current.Type,
+                        rawQuery: current.rawQuery ?? current.RawQuery,
+                        schema: current.schema ?? current.Schema,
+                        response: current.response ?? current.Response,
+                        parameters: current.parameters ?? current.Parameters,
+                        rawQueryMap: current.rawQueryMap ?? current.RawQueryMap,
+                        cache: current.cache ?? current.Cache,
+                        transformTemplate: current.transformTemplate ?? current.TransformTemplate,
+                        httpMethod: current.httpMethod ?? current.HttpMethod,
+                        categoryId: current.categoryId ?? current.CategoryId,
+                        ...patch,
+                    }
+                    : { ...patch };
+                for (const key of Object.keys(data)) {
+                    if (data[key] === undefined)
+                        delete data[key];
+                }
                 // Apply the same raw-query defaults used by create_query so the
                 // backend's QueryAggregate constructor doesn't blow up on nulls.
                 if (data.type === "raw") {
@@ -283,6 +297,294 @@ export function getQueryTools(client) {
                 };
             },
         },
+        // ─── Get Query Map ────────────────────────────────────
+        get_query_map: {
+            description: "Bir query'nin response (sonuç) kolon haritasını getirir. Her kolonun name/path/alias/type bilgisini içerir. Widget/component alanlarını query sonucuna bağlarken kullanılır.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string", description: "Query ID (GUID)" },
+                },
+                required: ["id"],
+            },
+            handler: async (args) => {
+                const result = await client.request("GET", `/{site}/Queries/${args.id}/query-map`);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Get Query Related Models ─────────────────────────
+        get_query_related_models: {
+            description: "Bir query'nin ilişkili olduğu modelleri getirir: bu query'yi kullanan entity'ler, layout'lar ve sayfalar. Query silmeden önce bağımlılıkları görmek için kullanılır.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string", description: "Query ID (GUID)" },
+                },
+                required: ["id"],
+            },
+            handler: async (args) => {
+                const result = await client.request("GET", `/{site}/Queries/${args.id}/related-models`);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Preview Query ────────────────────────────────────
+        preview_query: {
+            description: `Bir query tanımını KAYDETMEDEN çalıştırıp önizler. Henüz oluşturulmamış/güncellenmemiş bir query payload'ını test etmek için kullanılır.
+'data': Tam query gövdesi (create_query ile aynı alanlar): { name, title, type, rawQuery?, schema?, response?, parameters?, cache?, transformTemplate?, isCustomTransformTemplate?, version? }.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    data: {
+                        type: "object",
+                        description: "Önizlenecek tam query gövdesi: { name, title, type, rawQuery?, schema?, response?, parameters?, cache?, transformTemplate?, isCustomTransformTemplate?, version? }",
+                    },
+                },
+                required: ["data"],
+            },
+            handler: async (args) => {
+                const result = await client.request("POST", "/{site}/Queries/preview", args.data);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Upsert Bulk Queries ──────────────────────────────
+        upsert_bulk_queries: {
+            description: "Birden fazla query'yi tek istekte toplu olarak ekler/günceller (upsert). 'queries': query gövdelerinden oluşan dizi (her biri create_query ile aynı alanları içerir).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    queries: {
+                        type: "array",
+                        description: "Eklenecek/güncellenecek query gövdeleri dizisi. Her eleman: { name, title, type, rawQuery?, schema?, response?, parameters?, cache?, ... }",
+                    },
+                },
+                required: ["queries"],
+            },
+            handler: async (args) => {
+                const result = await client.upsertBulkQueries(args.queries);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── AI Raw SQL Generator ─────────────────────────────
+        ai_raw_query_generator: {
+            description: "AI ile doğal dil prompt'undan ham (raw) SQL sorgusu üretir. Üretilen sorgu, parametreler ve süre bilgilerini döndürür. Sıfırdan SQL yazmak için kullanılır.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    prompt: {
+                        type: "string",
+                        description: 'Doğal dil açıklaması (örn: "Son 30 günde oluşturulan aktif kullanıcıları listele")',
+                    },
+                },
+                required: ["prompt"],
+            },
+            handler: async (args) => {
+                const result = await client.request("POST", "/{site}/Queries/ai-raw-generator", { prompt: args.prompt });
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── AI Raw SQL Chat ──────────────────────────────────
+        ai_raw_query_chat: {
+            description: `AI ile sohbet ederek mevcut ham (raw) SQL sorgusunu iyileştirir/değiştirir. Konuşma geçmişi ve mevcut sorgu bağlamıyla yeni sorgu önerir.
+'messages': Sohbet geçmişi [{ role: "user" | "assistant", content }].
+'currentQuery': Üzerinde çalışılan mevcut SQL sorgusu.
+'currentParameters': Mevcut sorgu parametreleri (string).`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    messages: {
+                        type: "array",
+                        description: 'Sohbet mesajları dizisi: [{ role: "user" | "assistant", content: string }]',
+                    },
+                    currentQuery: {
+                        type: "string",
+                        description: "Üzerinde çalışılan mevcut SQL sorgusu",
+                    },
+                    currentParameters: {
+                        type: "string",
+                        description: "Mevcut sorgu parametreleri (string olarak)",
+                    },
+                },
+                required: ["messages"],
+            },
+            handler: async (args) => {
+                const result = await client.request("POST", "/{site}/Queries/ai-raw-chat", {
+                    messages: args.messages,
+                    currentQuery: args.currentQuery ?? "",
+                    currentParameters: args.currentParameters ?? "",
+                });
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Run Query (v2) ───────────────────────────────────
+        run_query_v2: {
+            description: "Kayıtlı bir query'yi v2 motoruyla çalıştırır (GET {name}/run-v2). 'queryParams' ile sorgu parametreleri geçirilir. Standart çalıştırma için wappa_run_query kullanın; v2 yalnızca yeni sorgu motoru gerekiyorsa.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Çalıştırılacak query adı" },
+                    queryParams: {
+                        type: "object",
+                        description: "Sorgu parametreleri (key-value)",
+                    },
+                },
+                required: ["name"],
+            },
+            handler: async (args) => {
+                const result = await client.request("GET", `/{site}/Queries/${args.name}/run-v2`, undefined, args.queryParams);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Run Query with Body ──────────────────────────────
+        run_query_with_body: {
+            description: `Kayıtlı bir query'yi gövde (body) ile çalıştırır (POST {name}/run). Parametreleri ve kolon eşleştirmelerini gövdede gönderir — dosya OLMADAN dinamik kayıt oluşturma/çalıştırma için. Dosya gerekiyorsa wappa_run_query_form kullanın.
+'parameters': Sorgu parametreleri objesi (key-value).
+'columns': Dinamik entity kolon değerleri dizisi (örn: [{ name, data: { value, refs } }]).`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Çalıştırılacak query adı" },
+                    parameters: {
+                        type: "object",
+                        description: "Sorgu parametreleri (key-value). Yoksa null gönderilir.",
+                    },
+                    columns: {
+                        type: "array",
+                        description: "Dinamik kolon değerleri: [{ name, data: { value, refs, columns? } }]",
+                    },
+                },
+                required: ["name"],
+            },
+            handler: async (args) => {
+                const result = await client.request("POST", `/{site}/Queries/${args.name}/run`, {
+                    parameters: args.parameters ?? null,
+                    columns: args.columns ?? [],
+                });
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Preview Query (v2) ───────────────────────────────
+        preview_query_v2: {
+            description: "Bir query tanımını v2 motoruyla kaydetmeden önizler/çalıştırır (POST preview-v2). Tam query gövdesini 'data' objesinde alır. Standart önizleme için wappa_preview_query kullanın.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    data: {
+                        type: "object",
+                        description: "Önizlenecek query tanımı (PreviewQueryRequest gövdesi: source, expressions, parameters vb.)",
+                    },
+                },
+                required: ["data"],
+            },
+            handler: async (args) => {
+                const result = await client.request("POST", "/{site}/Queries/preview-v2", args.data);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
+        // ─── Run Query (form / file upload) ───────────────────
+        run_query_form: {
+            description: `Kayıtlı bir query'yi DOSYA YÜKLEYEREK çalıştırır (POST {name}/run-form, multipart/form-data). Dosya ekli dinamik kayıt oluşturmak için kullanılır (örn: resimli form gönderimi — 'dert' uygulamasındaki gibi).
+Form alanları backend'e 'dert' istemcisiyle birebir aynı formatta gönderilir: dosyalar 'files' parçası olarak; 'columns' ve 'pairing' JSON string olarak.
+'files': Yüklenecek dosyalar — her biri { filename, contentBase64, contentType? } VEYA { filename, path } (yerel dosya yolu okunur). Birden fazla dosya verilebilir.
+'columns': Dinamik kolon değerleri dizisi (örn: [{ name: "resim", data: { refs: [], value: "" } }]).
+'pairing': Dosya↔kolon eşleştirmesi: [{ Column: "resim", Filename: "<dosya adı>" }].
+'parameters': (Opsiyonel) sorgu parametreleri objesi.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: 'Çalıştırılacak query adı (örn: "create-app-dertlistesi")',
+                    },
+                    files: {
+                        type: "array",
+                        description: "Yüklenecek dosyalar: [{ filename, contentBase64, contentType? }] veya [{ filename, path }]",
+                    },
+                    columns: {
+                        type: "array",
+                        description: "Dinamik kolon değerleri: [{ name, data: { value, refs } }] (JSON string olarak gönderilir)",
+                    },
+                    pairing: {
+                        type: "array",
+                        description: 'Dosya↔kolon eşleştirmesi: [{ Column: "resim", Filename: "foto.jpg" }] (JSON string olarak gönderilir)',
+                    },
+                    parameters: {
+                        type: "object",
+                        description: "Opsiyonel sorgu parametreleri (key-value)",
+                    },
+                },
+                required: ["name", "files"],
+            },
+            handler: async (args) => {
+                // Resolve any local file paths to base64 (so the client only deals with base64).
+                const { readFile } = await import("node:fs/promises");
+                const files = [];
+                for (const f of args.files ?? []) {
+                    let contentBase64 = f.contentBase64;
+                    if (!contentBase64 && f.path) {
+                        const buf = await readFile(f.path);
+                        contentBase64 = buf.toString("base64");
+                    }
+                    if (!contentBase64) {
+                        throw new Error(`Dosya '${f.filename}' için contentBase64 veya path verilmedi`);
+                    }
+                    files.push({
+                        filename: f.filename,
+                        contentBase64,
+                        contentType: f.contentType,
+                    });
+                }
+                // Mirror the dert client form field shape exactly.
+                const fields = {};
+                if (args.columns !== undefined)
+                    fields.columns = args.columns;
+                if (args.pairing !== undefined)
+                    fields.pairing = args.pairing;
+                if (args.parameters !== undefined)
+                    fields.parameters = args.parameters;
+                const result = await client.requestMultipart("POST", `/{site}/Queries/${args.name}/run-form`, fields, files);
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify(result, null, 2) },
+                    ],
+                };
+            },
+        },
     };
 }
 //# sourceMappingURL=queries.js.map