@appaflytech/zeyrek-ai-mcp 0.0.5 → 0.0.7

package/dist/tools/functions.js

@@ -0,0 +1,331 @@
+import { FUNCTIONS_NAMESPACE, callPrefix, functionSignature, sourceOf } from '../knowledge/functionGuards.js';
+import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
+import { evaluatePolicy, enforcePolicy, attachFindings } from '../knowledge/policy.js';
+import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
+import { functionOutline } from '../knowledge/outlines.js';
+import { writeDiff, withWriteDiff } from '../platform/writeDiff.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { policyRules } from '../knowledge/rules.js';
+import { z } from 'zod';
+/**
+ * Fonksiyonlar — backend aggregate'i `GlobalFunction` (`/global-functions` ucu, tek tablo), ajan
+ * sözlüğü `function_*`. Ayrım `source` bayrağıdır: `workflow` sunucuda (Jint) çıplak adla,
+ * `studio` tarayıcıda `Functions.<ad>(…)` ile çağrılır; kod ve parametre biçimi ikisinde aynıdır.
+ */
+const sourceParam = z.enum(['workflow', 'studio']).describe("Nerede çalışır: 'workflow' → SUNUCU (workflow/middleware/automation ifadeleri, Jint), tenant geneli, çıplak adla çağrılır (toplamHesapla(1, 2)), applicationId/scope/pageId VERİLMEZ, isAsync olamaz. 'studio' → TARAYICI ({{ }} bağlaması, UI flow code/function adımı), uygulamaya ait, Functions.toplamHesapla(1, 2) ile çağrılır, applicationId + scope zorunlu. Kaynak sonradan DEĞİŞMEZ");
+const scopeParam = z.enum(['application', 'page']).describe("Yalnız source:'studio'. application: uygulamanın her sayfasında görünür. page: yalnız o sayfanın tarayıcı bağlamında, pageId zorunlu (K2). Ad uygulama içinde kapsamlar arası benzersizdir (K3)");
+const nameParam = z.string().min(1).describe("Fonksiyon adı; studio'da Functions.<ad>(…), workflow'da <ad>(…) ile çağrılır. JS tanımlayıcısı olmalı, ayrılmış sözcük olamaz; studio'da 'Functions', workflow'da motor global adları (system, input, Now…) yasaktır (FN-001, istek gitmeden). Aynı ad iki kaynakta yan yana yaşayabilir (ayrı ad alanları); aynı kaynak içinde tekrarı platform 422 ile reddeder");
+const bodyParam = z.string().min(1).max(65536).describe("Fonksiyon GÖVDESİ, iki kaynakta aynı biçim: düz JavaScript deyimleri, 'return' içerebilir — 'function' sarmalı ya da arrow YAZILMAZ ('return fiyat * adet'). Gövde çağrıldığı yerin bağlamını kapanış olarak görür: tarayıcıda Page/state/Steps/komponent adları, sunucuda input/adım çıktıları/system.* (K7). Parametre adları gövdede doğrudan kullanılır. Platform kaydetmeden önce SÖZDİZİMİNİ denetler (422 GlobalFunctionBodyInvalid, ayrıştırıcı mesajıyla). En çok 64 KB");
+const parameterParam = z.object({
+    name: z.string().min(1).describe('Parametre adı — JS tanımlayıcısı, fonksiyon içinde benzersiz; gövdede bu adla okunur'),
+    type: z.enum(['text', 'number', 'boolean', 'date', 'object', 'array', 'any']).optional()
+        .describe("Yalnız Studio imzası ve autocomplete için; çalışma zamanı tipi DENETLEMEZ. Varsayılan 'any'"),
+    required: z.boolean().optional()
+        .describe("true: çağrıda undefined kalırsa fonksiyon '<ad>: \"<param>\" is required' ile fırlatır (defaultValue uygulandıktan SONRA denetlenir)"),
+    defaultValue: z.unknown().optional().describe('Çağrıda undefined kalan parametreye uygulanır'),
+    description: z.string().optional().describe('Studio autocomplete infobox satırı')
+});
+const parametersParam = z.array(parameterParam).optional().describe("Bildirimli parametre listesi, SIRALI: çağrı konumsaldır, f(a, b) bildirim sırasına eşlenir (K5). UI flow 'function' adımı parametreleri bu listeden ada göre eşler. Parametresiz fonksiyonda boş bırakın");
+const isAsyncParam = z.boolean().optional().describe("Yalnız source:'studio': true → tarayıcıda 'async function', gövdede await serbest; {{ }} inline bağlamada dönüş Promise'dir ('[object Promise]'), yalnız UI flow 'function'/'code' adımından çağırın. source:'workflow' ile true → FN-004 block (motor senkron, platform 422)");
+const descriptionParam = z.string().optional().describe('Ne işe yaradığı; Studio fonksiyon kartında ve autocomplete infobox başlığında görünür');
+const policyOverrideParam = z.boolean().optional().describe('true: politika block bulgularını warn\'a indirir (bilinçli istisna; yanıtta işaretlenir)');
+const FUNCTIONS_PATH = '/global-functions';
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function unwrapData(payload) {
+    const record = isRecord(payload) ? payload : {};
+    return isRecord(record.data) ? record.data : record;
+}
+function listData(payload) {
+    const record = isRecord(payload) ? payload : {};
+    const list = Array.isArray(record.data) ? record.data : Array.isArray(payload) ? payload : [];
+    return list.filter(isRecord);
+}
+function parameterNames(record) {
+    return (Array.isArray(record.parameters) ? record.parameters : [])
+        .filter(isRecord)
+        .map(parameter => String(parameter.name ?? ''));
+}
+/**
+ * Çağrı biçimini değiştiren fark: ad ya da parametre AD/SIRA listesi. Tip, varsayılan, `required`
+ * ve gövde imzayı değiştirmez — çağrı konumsaldır (K5), `function` adımı ada göre eşler.
+ */
+export function describeSignatureChange(current, next) {
+    const currentName = String(current.name ?? '');
+    const nextName = String(next.name ?? currentName);
+    const currentParameters = parameterNames(current);
+    const nextParameters = parameterNames(next);
+    const parametersChanged = currentParameters.length !== nextParameters.length || currentParameters.some((name, index) => name !== nextParameters[index]);
+    return {
+        name: currentName === nextName ? null : [currentName, nextName],
+        parameters: parametersChanged ? [currentParameters, nextParameters] : null
+    };
+}
+function signatureWarning(name, source, change, dependents) {
+    const callers = [dependents.flows.length ? `flows: ${dependents.flows.join(', ')}` : '', dependents.workflows.length ? `workflows: ${dependents.workflows.join(', ')}` : ''].filter(Boolean).join('; ');
+    const what = [
+        change.name ? `ad '${change.name[0]}' → '${change.name[1]}'` : '',
+        change.parameters ? `parametreler [${change.parameters[0].join(', ')}] → [${change.parameters[1].join(', ')}]` : ''
+    ].filter(Boolean).join(', ');
+    const effect = source === 'workflow'
+        ? `çıplak çağrı ${name}(…) konumsaldır, argümanlar yeni bildirim sırasına eşlenir`
+        : `${FUNCTIONS_NAMESPACE}.${name}(…) çağrıları konumsaldır ve 'function' adımları parametreyi ADA göre eşler — eski ad/sıra ile yazılmış çağrılar yanlış değer alır`;
+    return `İmza değişti (${what}) ve fonksiyonu ${dependents.total} kayıt kullanıyor (${callers}): ${effect}. Güncelleme yapıldı; çağıran ifadeleri gözden geçirin — dependency_graph(module:'global-function').`;
+}
+/**
+ * `GET global-functions/{id}/dependencies` KOVALI grafiği döner (`{ flows, workflows }`); düz dizi
+ * şekli de düzleştirilir — yapısal (`args.functionId`) ve metinsel (`Functions.<ad>(` / çıplak `<ad>(`)
+ * bağımlılıklar aynı listede gelir. Etiket Studio rozetleriyle aynıdır: komponent olayı `Sahip › Komponent · olay`,
+ * sayfa/layout olayı `Sahip · olay`, bağı olmayan akış `Sahip › akış adı` (sahip sayfa/layout/widget; eski yanıtta
+ * sahipsiz); automation düğümü `ad (automation)`.
+ */
+export function summarizeDependents(payload) {
+    const data = (() => {
+        const record = isRecord(payload) ? payload : undefined;
+        const inner = record?.data;
+        return inner === undefined ? payload : inner;
+    })();
+    const text = (value) => (typeof value === 'string' && value !== '' ? value : undefined);
+    const names = (list) => (Array.isArray(list) ? list : [])
+        .filter(isRecord)
+        .map(entry => {
+        const name = String(entry.name ?? entry.slug ?? entry.id ?? '?');
+        const host = text(entry.hostName);
+        const component = text(entry.componentName);
+        const event = text(entry.eventTitle) ?? text(entry.eventName);
+        const label = component
+            ? [host, [component, event].filter(Boolean).join(' · ')].filter(Boolean).join(' › ')
+            : event
+                ? [host, event].filter(Boolean).join(' · ')
+                : [host, name].filter(Boolean).join(' › ');
+        return String(entry.module ?? '').toLowerCase() === 'automation' ? `${label} (automation)` : label;
+    });
+    if (Array.isArray(data)) {
+        const entries = data.filter(isRecord);
+        const moduleOf = (entry) => String(entry.module ?? entry.type ?? entry.kind ?? '').toLowerCase();
+        const isWorkflow = (entry) => moduleOf(entry).includes('workflow') || moduleOf(entry) === 'automation';
+        const workflows = names(entries.filter(isWorkflow));
+        const flows = names(entries.filter(entry => !isWorkflow(entry)));
+        return { flows, workflows, total: flows.length + workflows.length };
+    }
+    const record = isRecord(data) ? data : {};
+    const flows = names(record.flows);
+    const workflows = names(record.workflows);
+    return { flows, workflows, total: flows.length + workflows.length };
+}
+function usageHint(name, source, scope) {
+    if (source === 'workflow') {
+        return `Çağrı: workflow/middleware/automation ifadesinde çıplak adla — code adımı 'return ${name}(…)', condition '${name}(row.a) > 1'. Tenant genelidir, her uygulamanın her workflow'unda görünür; tarayıcıda ({{ }}, UI flow) YOKTUR. workflow_preview ile doğrulayın. Rehber: platform_guide('functions').`;
+    }
+    const visibility = scope === 'application' ? 'uygulamanın her sayfasında' : 'yalnız kendi sayfasında (K2)';
+    return `Çağrı: {{ Functions.${name}(…) }} prop bağlaması · UI flow adımı { type:'function', args:{ functionId:'<id>', functionName:'${name}', parameters:[{ name, value:{ type, ref } }] } } → Steps.<adımAdı>.data · ${visibility}; SUNUCUDA yoktur (WF-030). Sayfa paketi Pages.Updated ile tazelenir; /view yolu birkaç saniye eski gövdeyi gösterebilir (B-11). Rehber: platform_guide('functions').`;
+}
+export function registerFunctionTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('function_list', {
+        title: 'Fonksiyonları listele',
+        description: "Fonksiyonları imzalarıyla listeler; iki kaynak tek listede (source: 'workflow' sunucu, 'studio' tarayıcı). Süzgeçler birleşir: source · applicationId (studio kayıtları) · scope · pageId (yalnız o sayfanın sayfa kapsamlıları). Gövde listede YOKTUR (bodyLines sayılır) — function_get ile okuyun. Bir ifadeye Functions.x(…) ya da çıplak x(…) yazmadan önce adı, id'yi ve parametre SIRASINI buradan alın — platform_guide('functions').",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            source: sourceParam.optional().describe("Süzgeç: 'workflow' yalnız sunucu fonksiyonları, 'studio' yalnız tarayıcı fonksiyonları"),
+            applicationId: guid.optional().describe("Süzgeç: bu uygulamanın studio fonksiyonları (uygulama kapsamlılar + tüm sayfaların sayfa kapsamlıları)"),
+            pageId: guid.optional().describe('Süzgeç: yalnız bu sayfanın sayfa kapsamlı fonksiyonları (applicationId ile birlikte)'),
+            scope: scopeParam.optional().describe("Süzgeç: 'application' yalnız uygulama kapsamlılar, 'page' yalnız sayfa kapsamlılar")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, source, applicationId, pageId, scope }) => {
+        const query = Object.fromEntries(Object.entries({ source, applicationId, pageId, scope }).filter(([, value]) => value !== undefined));
+        const payload = await platform.tenant('GET', project, FUNCTIONS_PATH, { environment, ...(Object.keys(query).length > 0 ? { query } : {}) });
+        const functions = listData(payload)
+            .filter(entry => source === undefined || sourceOf(entry) === source)
+            .filter(entry => scope === undefined || entry.scope === scope)
+            .map(functionOutline);
+        return {
+            ...(source ? { source } : {}),
+            ...(applicationId ? { applicationId } : {}),
+            ...(pageId ? { pageId } : {}),
+            ...(scope ? { scope } : {}),
+            count: functions.length,
+            functions,
+            note: functions.length === 0
+                ? "Bu süzgeçle hiç fonksiyon yok; ifadeye yazmadan önce function_create ile tanımlayın (sunucu için source:'workflow', tarayıcı için source:'studio')."
+                : "Çağrı konumsaldır: signature'daki sıra bağlayıcıdır (workflow: çıplak ad, studio: Functions.<ad>). Gövde için function_get; nerede kullanıldığı için dependency_graph(module:'global-function')."
+        };
+    }));
+    server.registerTool('function_get', {
+        title: 'Fonksiyonu getir',
+        description: 'Tek fonksiyonun tam gövdesini (source, ad, kapsam, sayfa, parametreler, isAsync, body) getirir; function_update için şablon budur.',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, id }) => {
+        const payload = await platform.tenant('GET', project, `${FUNCTIONS_PATH}/${id}`, { environment });
+        const record = unwrapData(payload);
+        return isRecord(payload)
+            ? { ...payload, signature: functionSignature(record), hint: usageHint(String(record.name ?? '?'), sourceOf(record), String(record.scope ?? 'application')) }
+            : payload;
+    }));
+    server.registerTool('function_create', {
+        title: 'Fonksiyon tanımla',
+        description: "Parametreli bir JavaScript fonksiyonu kaydeder; kod biçimi iki kaynakta aynıdır, fark nerede çalıştığıdır. source:'workflow' → SUNUCU: tenant geneli, workflow/middleware/automation ifadelerinde çıplak adla (toplamHesapla(10, 3)); applicationId/scope/pageId verilmez, isAsync olamaz. source:'studio' → TARAYICI: uygulamaya ait, {{ Functions.toplamHesapla(10, 3) }} bağlaması ve UI flow 'code'/'function' adımı; applicationId + scope zorunlu. Sunucu ifadesinde Functions.<ad>( yazılamaz (WF-030), tarayıcıda çıplak workflow adı yoktur. Ne zaman: aynı ifade 3+ yerde kopyalanıyorsa ya da parametreli bir hesap gerekiyorsa. Ad/parametre/kaynak kuralları istek gitmeden denetlenir (FN-001…FN-005). İlk kullanımdan önce platform_guide('functions').",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            source: sourceParam,
+            applicationId: guid.optional().describe("source:'studio' için zorunlu — fonksiyonun ait olduğu uygulama; source:'workflow' için verilmez"),
+            scope: scopeParam.optional(),
+            pageId: guid.optional().describe("scope:'page' için zorunlu — fonksiyonun ait olduğu sayfa; scope:'application' ve source:'workflow' için verilmez"),
+            name: nameParam,
+            description: descriptionParam,
+            isAsync: isAsyncParam,
+            parameters: parametersParam,
+            body: bodyParam,
+            policyOverride: policyOverrideParam
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, source, applicationId, scope, pageId, name, description, isAsync, parameters, body, policyOverride }) => {
+        const command = {
+            source,
+            ...(applicationId ? { applicationId } : {}),
+            ...(scope ? { scope } : {}),
+            ...(pageId ? { pageId } : {}),
+            name,
+            description: description ?? null,
+            isAsync: isAsync === true,
+            parameters: parameters ?? [],
+            body
+        };
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'function', command, { operation: 'create' }, policyOverride));
+        const drift = unmappedMembers('CreateGlobalFunctionCommand', command);
+        const payload = await platform.tenant('POST', project, FUNCTIONS_PATH, { environment, body: command });
+        const saved = unwrapData(payload);
+        const response = {
+            ...(isRecord(payload) ? payload : { data: payload }),
+            signature: functionSignature(saved.name ? saved : command),
+            hint: usageHint(name, source, scope ?? 'application')
+        };
+        return attachFindings(withUnmappedMembers(withWriteDiff(response, writeDiff(command, saved)), drift), findings);
+    }));
+    server.registerTool('function_update', {
+        title: 'Fonksiyonu güncelle',
+        description: "Fonksiyonu günceller. Platform ucu TAM gövde ister (PUT); gateway mevcut kaydı okuyup vermediğiniz alanları oradan doldurur — yalnız değişen alanı gönderebilirsiniz (ayrı patch aracı yoktur). source, applicationId, scope ve pageId DEĞİŞMEZ. Yanıt 'dependents' (kullanan flow/workflow adları) ve 'signatureChange' (ad ya da parametre ad/sırası değiştiyse eski→yeni) taşır; ikisi birden doluysa 'warnings' çağıranların etkileneceğini söyler — güncelleme yine YAPILIR (K12), silme ise engellenir. ADI değiştirmek: platform çağıranları aynı işlemde yeni ada TAŞIR ve yanıt 'renamedReferences' ile kaç kaydın yazıldığını söyler — source:'studio' → Functions.<eskiAd> başvuruları (akış adımları, 'function' adımının functionName'i, code bağlamaları, diğer fonksiyon gövdeleri); source:'workflow' → <eskiAd>(…) çağrıları (workflow ifadeleri, otomasyon koşulları, workflow fonksiyonu gövdeleri). Workflow kaynağında eski ad yeni adın yazılamadığı bir yerde kalırsa — çağrı dışı kullanım (değişken gibi) ya da ham sorgu ifadesi (isExpression:true rawQuery) — platform 400 ile REDDEDER (CantRenameUsedGlobalFunction) ve hiçbir şey yazmaz; düz SQL (isExpression:false) kullanım sayılmaz, yazılmaz. Fonksiyonun kendi gövdesindeki çağrılar (özyineleme) da yeni adı alır. Düz metin (static) prop'lar değişmez.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            name: nameParam.optional(),
+            description: descriptionParam,
+            isAsync: isAsyncParam,
+            parameters: parametersParam,
+            body: bodyParam.optional(),
+            policyOverride: policyOverrideParam
+        },
+        annotations: updates
+    }, handle(config, async ({ project, environment, id, name, description, isAsync, parameters, body, policyOverride }) => {
+        const current = unwrapData(await platform.tenant('GET', project, `${FUNCTIONS_PATH}/${id}`, { environment }));
+        if (!current.id)
+            throw new PlatformApiError(`'${id}' id'li fonksiyon bulunamadı; function_list ile doğrulayın.`, 404);
+        const source = sourceOf(current);
+        const command = {
+            id,
+            name: name ?? current.name,
+            description: description === undefined ? (current.description ?? null) : description,
+            isAsync: isAsync ?? current.isAsync === true,
+            parameters: parameters ?? (Array.isArray(current.parameters) ? current.parameters : []),
+            body: body ?? current.body
+        };
+        // Kurallar kaynağı ve kapsamı görsün (FN-001/003/004 kaynağa bağlı); PUT gövdesine girmez.
+        const definition = { ...command, source, applicationId: current.applicationId ?? null, scope: current.scope ?? null, pageId: current.pageId ?? null };
+        const findings = enforcePolicy(evaluatePolicy(config, policyRules, 'function', definition, { operation: 'update' }, policyOverride));
+        const drift = unmappedMembers('UpdateGlobalFunctionCommand', command);
+        const payload = await platform.tenant('PUT', project, `${FUNCTIONS_PATH}/${id}`, { environment, body: command });
+        // Platform yanıtı `{ function, dependents, signatureChanged }` zarfıdır (Faz 4); eski şekil çıplak kayıttır.
+        const envelope = unwrapData(payload);
+        const saved = isRecord(envelope.function) ? envelope.function : envelope;
+        // Platform 2026-09-11'den beri adı çağıranlara yazar ve kaç kayıt yazdığını söyler; alan yoksa eski platformdur.
+        const renamedReferences = typeof envelope.renamedReferences === 'number' ? envelope.renamedReferences : undefined;
+        const renamed = name !== undefined && name !== current.name;
+        const signatureChange = describeSignatureChange(current, command);
+        let dependents;
+        if (isRecord(envelope.dependents)) {
+            dependents = summarizeDependents(envelope.dependents);
+        }
+        else {
+            try {
+                dependents = summarizeDependents(await platform.tenant('GET', project, `${FUNCTIONS_PATH}/${id}/dependencies`, { environment }));
+            }
+            catch {
+                dependents = undefined;
+            }
+        }
+        const signatureChanged = signatureChange.name !== null || signatureChange.parameters !== null;
+        // Ad çağıranlara yazıldıysa yalnız parametre değişimi çağıranı kırar; eski platformda ad da kırar.
+        const callersBreak = renamedReferences === undefined ? signatureChanged : signatureChange.parameters !== null;
+        const warningChange = renamedReferences === undefined ? signatureChange : { ...signatureChange, name: null };
+        const response = {
+            data: saved,
+            signature: functionSignature(saved.name ? saved : definition),
+            signatureChange,
+            dependents: dependents ?? { flows: [], workflows: [], total: 0 },
+            ...(dependents === undefined ? { dependentsNote: 'Bağımlılık ucu okunamadı; çağıran akış olup olmadığı bilinmiyor.' } : {}),
+            ...(renamedReferences !== undefined ? { renamedReferences } : {}),
+            ...(dependents !== undefined && dependents.total > 0 && callersBreak
+                ? { warnings: [signatureWarning(String(saved.name ?? command.name), source, warningChange, dependents)] }
+                : {}),
+            ...(renamed
+                ? {
+                    renameNote: renamedReferences !== undefined
+                        ? source === 'workflow'
+                            ? `Ad '${String(current.name)}' → '${name}': platform ${renamedReferences} kayıttaki ${String(current.name)}(…) çağrısını yeni ada taşıdı (workflow ifadeleri, otomasyon koşulları, workflow fonksiyonu gövdeleri). Çağrı dışı bir kullanım ya da ham sorgu ifadesi kalsaydı platform 400 CantRenameUsedGlobalFunction ile reddederdi.`
+                            : `Ad '${String(current.name)}' → '${name}': platform ${renamedReferences} kayıttaki ${FUNCTIONS_NAMESPACE}.${String(current.name)} başvurusunu yeni ada taşıdı (akış adımları, 'function' adımının functionName'i, code bağlamaları, diğer fonksiyon gövdeleri). Düz metin prop'lar değişmez.`
+                        : source === 'workflow'
+                            ? `Ad '${String(current.name)}' → '${name}': platform kullanan workflow olmadığı için kabul etti; ifadelerde ${String(current.name)}(…) yazan başka bir yer varsa artık '${String(current.name)} is not defined' verir. Çağıranlar: dependency_graph(module:'global-function', id:'${id}').`
+                            : `Ad '${String(current.name)}' → '${name}': ifadelerdeki ${FUNCTIONS_NAMESPACE}.${String(current.name)}(…) çağrıları artık 'is not a function' verir; 'function' adımları id ile çözülür ama functionName eski kaldı. Çağıranlar: dependency_graph(module:'global-function', id:'${id}').`
+                }
+                : {})
+        };
+        return attachFindings(withUnmappedMembers(withWriteDiff(response, writeDiff(command, saved)), drift), findings);
+    }));
+    server.registerTool('function_delete', {
+        title: 'Fonksiyonu sil',
+        description: "Fonksiyonu siler. Gateway önce bağımlılık grafiğini okur; kullanan flow/workflow varsa istek GÖNDERİLMEZ ve liste döner (409). source:'studio' → platform silmeyi engellemez (K12), bilinçli silme için acknowledgeDependents: true verin (çağıranlar 'Functions.<ad> is not a function' ile düşer). source:'workflow' → kullanan workflow varsa platform 400 ile REDDEDER (CantDeleteUsedGlobalFunction); acknowledgeDependents bunu geçemez, önce çağıran ifadeleri düzeltin. Bağımlılık ucu okunamazsa silme yine denenir ve yanıt bunu söyler.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            acknowledgeDependents: z.boolean().optional().describe("true: studio fonksiyonunu kullanan akış olsa da sil (çağıranlar kırılır). Varsayılan false — bağımlı varsa istek gönderilmez. workflow kaynağında platformun 400'ünü geçemez")
+        },
+        annotations: destructive
+    }, handle(config, async ({ project, environment, id, acknowledgeDependents }) => {
+        const current = unwrapData(await platform.tenant('GET', project, `${FUNCTIONS_PATH}/${id}`, { environment }));
+        if (!current.id)
+            throw new PlatformApiError(`'${id}' id'li fonksiyon bulunamadı; function_list ile doğrulayın.`, 404);
+        const source = sourceOf(current);
+        const prefix = callPrefix(source);
+        let dependents;
+        try {
+            dependents = summarizeDependents(await platform.tenant('GET', project, `${FUNCTIONS_PATH}/${id}/dependencies`, { environment }));
+        }
+        catch {
+            dependents = undefined;
+        }
+        if (dependents !== undefined && dependents.total > 0 && (acknowledgeDependents !== true || source === 'workflow')) {
+            throw new PlatformApiError(`Fonksiyonu ${dependents.total} kayıt kullanıyor (istek GÖNDERİLMEDİ) — flows: ${dependents.flows.join(', ') || '-'}; workflows: ${dependents.workflows.join(', ') || '-'}. `
+                + (source === 'workflow'
+                    ? `source:'workflow' fonksiyonu kullanılırken silinemez: platform 400 CantDeleteUsedGlobalFunction döner, acknowledgeDependents bunu geçemez. Önce çağıran ifadelerdeki ${String(current.name)}(…) çağrılarını kaldırın.`
+                    : `Silinirse bu akışlar '${prefix}${String(current.name)} is not a function' ile düşer. Önce çağıranları güncelleyin ya da bilinçli silme için acknowledgeDependents: true verin.`), 409);
+        }
+        await platform.tenant('DELETE', project, `${FUNCTIONS_PATH}/${id}`, { environment });
+        return {
+            deleted: id,
+            source,
+            dependents: dependents ?? { flows: [], workflows: [], total: 0 },
+            ...(dependents === undefined ? { dependentsNote: 'Bağımlılık ucu okunamadı; çağıran akış olup olmadığı bilinmiyor.' } : {}),
+            ...(dependents !== undefined && dependents.total > 0
+                ? { note: `${dependents.total} çağıran kırıldı (acknowledgeDependents): ${[...dependents.flows, ...dependents.workflows].join(', ')} — ifadeleri düzeltin ya da fonksiyonu aynı adla yeniden tanımlayın.` }
+                : {})
+        };
+    }));
+}

package/dist/tools/globalFunctions.js

@@ -0,0 +1,63 @@
+import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const identifier = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const nameParam = z.string().min(1).regex(identifier, 'Geçerli bir JavaScript tanımlayıcısı olmalı')
+    .describe("Motorun bağlayacağı ad; ifadelerde bu adla çağrılır (sum(1, 2)). Sistem fonksiyonlarının adları (Now, UtcNow, GenerateGuid, crypto…) rezervedir ve reddedilir");
+const functionParam = z.string().min(1)
+    .describe("Klasik ya da arrow JavaScript FONKSİYON İFADESİ: '(left, right) => left + right' ya da 'function (a) { return a * 2 }'. Deyim değil ifade olmalı — 'return a + b' gibi bir gövde tek başına reddedilir. Platform kaydetmeden önce gerçek bir Jint motorunda çalıştırıp sonucun çağrılabilir olduğunu doğrular; SÖZDİZİMİ ve çağrılabilirlik denetlenir, gövdenin içindeki serbest değişkenler DENETLENMEZ");
+const descriptionParam = z.string().min(1)
+    .describe('Fonksiyonun ne işe yaradığı; Studio kod editöründe autocomplete infobox başlığı olarak görünür. Zorunludur');
+const schemaParam = z.array(z.object({
+    name: z.string().min(1).regex(identifier, 'Geçerli bir JavaScript tanımlayıcısı olmalı')
+        .describe('Parametre adı; fonksiyon içinde benzersiz olmalı'),
+    description: z.string().min(1).describe('Parametrenin ne olduğu; infobox\'ta parametre satırı olarak görünür. Zorunludur')
+})).describe('Parametre şeması, SIRALI. Yalnız dokümantasyon ve autocomplete imzası için kullanılır — motor çağrıyı bu şemaya göre DOĞRULAMAZ, eksik argüman undefined gelir. Parametresiz fonksiyonda boş dizi verin');
+export function registerGlobalFunctionTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('global_function_list', {
+        title: 'Global fonksiyonları listele',
+        description: "Tenant kapsamındaki global JavaScript fonksiyonlarını listeler. Bunlar her workflow/automation/middleware koşumunda ve Studio preview'ında motora bağlanır; ifadelerde çıplak adla çağrılırlar.",
+        inputSchema: { project: projectParam, environment: environmentParam },
+        annotations: readOnly
+    }, handle(config, ({ project, environment }) => platform.tenant('GET', project, '/global-functions', { environment })));
+    server.registerTool('global_function_get', {
+        title: 'Global fonksiyonu getir',
+        description: 'Tek bir global fonksiyonun adını, gövdesini, açıklamasını ve parametre şemasını getirir.',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/global-functions/${id}`, { environment })));
+    server.registerTool('global_function_create', {
+        title: 'Global fonksiyon tanımla',
+        description: "Yeni global fonksiyon kaydeder. Ad tenant içinde BENZERSİZDİR. Fonksiyon açıklaması ve HER parametre açıklaması zorunludur — Studio bunları autocomplete infobox'ında gösterir. Gövde bağlamdan bağımsız olmalı: içinde 'input' ya da bir adım adı gibi SERBEST DEĞİŞKEN kullanırsanız kayıt geçer ama fonksiyon o değişkenin tanımlı olmadığı her akışta 'X is not defined' ile patlar; dinamik veriyi parametre olarak geçirin.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            name: nameParam,
+            function: functionParam,
+            description: descriptionParam,
+            schema: schemaParam
+        },
+        annotations: writes
+    }, handle(config, ({ project, environment, name, function: body, description, schema }) => platform.tenant('POST', project, '/global-functions', { environment, body: { name, function: body, description, schema } })));
+    server.registerTool('global_function_update', {
+        title: 'Global fonksiyonu güncelle',
+        description: "Global fonksiyonun tamamını değiştirir (PUT — dört alanı da gönderin). ADI DEĞİŞTİRMEK, fonksiyonu çağıran bir workflow varsa 400 ile reddedilir (CantRenameUsedGlobalFunctionException); gövde/açıklama/şema değişikliği serbesttir. Adı gerçekten değiştirmeniz gerekiyorsa önce çağıran akışlardaki ifadeleri güncelleyin.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            name: nameParam,
+            function: functionParam,
+            description: descriptionParam,
+            schema: schemaParam
+        },
+        annotations: updates
+    }, handle(config, ({ project, environment, id, name, function: body, description, schema }) => platform.tenant('PUT', project, `/global-functions/${id}`, { environment, body: { name, function: body, description, schema } })));
+    server.registerTool('global_function_delete', {
+        title: 'Global fonksiyonu sil',
+        description: "Global fonksiyonu siler. Fonksiyonu çağıran bir workflow varsa 400 ile reddedilir (CantDeleteUsedGlobalFunctionException) ve mesaj çağıran akışların adlarını sayar. Eşleşme tam tanımlayıcı sınırıyla aranır: 'checksum' ya da 'mySum' içeren bir ifade 'sum' çağrısı sayılmaz.",
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
+        annotations: destructive
+    }, handle(config, ({ project, environment, id }) => platform.tenant('DELETE', project, `/global-functions/${id}`, { environment })));
+}

package/dist/tools/importSchemas.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+export const importModes = ['create', 'append', 'upsert', 'update'];
+export const importErrorPolicies = ['skip-rows', 'all-or-nothing'];
+export const importEmptyCellPolicies = ['keep', 'clear'];
+export const importUnmatchedPolicies = ['error', 'create', 'blank'];
+export const importRowActions = ['skip', 'blank', 'apply-suggestion'];
+const newTable = z.object({
+    name: z.string().min(1),
+    slug: z.string().min(1)
+});
+const relationChoice = z.object({
+    targetEntityId: z.string().uuid().optional().describe('Mevcut hedef tablo; yeni tablo kurulacaksa `newTable` verin'),
+    newTable: newTable.optional().describe('İlişki hedefi olarak kurulacak yeni tablo'),
+    matchField: z.string().min(1).optional().describe("Hedefte eşleşme alanı; display ya da benzersiz olmalı, değilse 422 (bu fazda değer yalnız id olarak kabul edilir)"),
+    unmatched: z.enum(importUnmatchedPolicies).default('error').describe("Eşleşmeyen değer: 'error' satırı hatalı sayar, 'create' hedefte yeni kayıt açar, 'blank' alanı boş bırakır"),
+    delimiter: z.string().min(1).optional().describe('Çoklu değer ayracı (Multi Relation)'),
+    parentColumnIndex: z.number().int().min(0).optional().describe('Hiyerarşide üst sütunun indeksi (İl → İlçe)'),
+    parentTable: newTable.optional(),
+    many: z.boolean().optional()
+});
+const fieldChoice = z.object({
+    slug: z.string().min(1),
+    name: z.string().min(1),
+    commonType: z.string().min(1).describe("Platform commonType: text | number | float | bool | date | time | datetime | guid"),
+    dbType: z.string().min(1).describe('PostgreSQL tipi: VARCHAR | TEXT | INT8 | FLOAT4 | BOOL | DATE | TIME | TIMESTAMP | UUID'),
+    nullable: z.boolean().default(true),
+    unique: z.boolean().default(false),
+    display: z.boolean().default(false)
+});
+const columnChoice = z.object({
+    index: z.number().int().min(0).describe('Dosyadaki 0 tabanlı sütun sırası (analiz yanıtındaki `index`)'),
+    include: z.boolean().default(true),
+    field: fieldChoice.optional().describe("Açılacak alan; mevcut tabloda zaten varsa `existingFieldSlug` verilir, yoksa `field` alanı tabloya ekler"),
+    existingFieldSlug: z.string().min(1).optional().describe('Mevcut tablodaki hedef alanın slug\'ı'),
+    relation: relationChoice.nullish().describe('İlişki kuralı; mevcut tabloda zaten ilişki olan bir alana yazıyorsanız boş bırakabilirsiniz, backend hedefi alanın kendisinden çözer'),
+    language: z.string().min(1).optional().describe("Çok dilli alanın dil kodu; başlık 'Ad (tr)' biçimindeyse analiz bunu önerir")
+});
+const tableChoice = z.object({
+    sheetKey: z.string().min(1).describe('Analiz yanıtındaki `sheets[].key`'),
+    mode: z.enum(importModes).describe("'create' yeni tablo kurar, 'append' ekler, 'upsert' anahtara göre ekle+güncelle, 'update' yalnız günceller"),
+    target: z.object({
+        entityId: z.string().uuid().optional().describe("create dışındaki modlarda zorunlu"),
+        name: z.string().min(1).optional().describe('create modunda zorunlu'),
+        slug: z.string().min(1).optional().describe('create modunda zorunlu')
+    }),
+    keyField: z.string().min(1).optional().describe("upsert/update'te zorunlu; benzersiz bir alan, 'code' ya da 'id'"),
+    emptyCellPolicy: z.enum(importEmptyCellPolicies).default('keep').describe("'keep' boş hücreyi yok sayar (mevcut değer silinmez), 'clear' alanı boşaltır"),
+    columns: z.array(columnChoice).min(1)
+});
+export const importChoicesShape = {
+    fileId: z.string().uuid().describe('import_analyze ile analiz edilmiş dosya'),
+    locale: z.enum(['tr-TR', 'en-US']).optional().describe('Analizde kullanılan profilin AYNISI verilmelidir; farklı profil farklı satır üretir'),
+    headerRow: z.number().int().min(0).optional().describe("Analizde verilen başlık satırının AYNISI (CSV/XLSX); JSON'da yok sayılır, başlık her zaman 1. satırdaki anahtarlardır"),
+    csv: z.object({ delimiter: z.string().min(1).optional(), encoding: z.string().min(1).optional() }).optional(),
+    errorPolicy: z.enum(importErrorPolicies).default('skip-rows').describe("'skip-rows' hatalı satırı atlar ve kalanını yazar, 'all-or-nothing' bir hata varsa hiçbir şey yazmaz"),
+    tables: z.array(tableChoice).min(1)
+};
+export const importChoicesSchema = z.object(importChoicesShape);
+export function validateChoices(choices) {
+    const problems = [];
+    for (const table of choices.tables) {
+        if (table.mode === 'create' && (!table.target.name || !table.target.slug)) {
+            problems.push(`'${table.sheetKey}': mode 'create' için target.name ve target.slug zorunlu.`);
+        }
+        if (table.mode !== 'create' && !table.target.entityId) {
+            problems.push(`'${table.sheetKey}': mode '${table.mode}' için target.entityId zorunlu.`);
+        }
+        if ((table.mode === 'upsert' || table.mode === 'update') && !table.keyField) {
+            problems.push(`'${table.sheetKey}': mode '${table.mode}' için keyField zorunlu — benzersiz bir alan, 'code' ya da 'id'.`);
+        }
+        if (table.mode === 'create' && table.columns.some(column => column.include !== false && !column.field && !column.relation)) {
+            problems.push(`'${table.sheetKey}': mode 'create' içeren her sütun ya 'field' ya 'relation' taşımalı (dahil edilmeyen sütuna include: false verin).`);
+        }
+        if (table.mode !== 'create' && table.columns.some(column => column.include !== false && !column.existingFieldSlug && !column.relation && !column.field)) {
+            problems.push(`'${table.sheetKey}': mevcut tabloya yazarken her sütun 'existingFieldSlug', 'field' ya da 'relation' taşımalı — 'field' tabloda olmayan sütun için yeni alan açar.`);
+        }
+    }
+    return problems;
+}