@appaflytech/zeyrek-ai-mcp 0.0.30 → 0.0.32

package/dist/tools/connectors.js

@@ -1,193 +0,0 @@
-import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { PlatformApiError } from '../platform/errors.js';
-import { handle } from '../platform/responses.js';
-import { assertProcessNotProduction } from './bpm.js';
-import { z } from 'zod';
-const credentialKinds = ['api-key', 'basic', 'bearer', 'oauth2-client', 'oauth2-auth-code', 'webhook'];
-const eventSourceKinds = ['http', 'rabbitmq', 'kafka', 'service-bus'];
-const mailSourceKinds = ['imap', 'graph'];
-const credentialFields = {
-    name: z.string().min(1).max(100).describe("kasa adı (tekil); düğümde credentialRef, kanal kimliklerinde sabit ad: notification-sms · notification-teams · notification-slack"),
-    connectorName: z.string().min(1).max(50).describe('connector_list adı; kaydedildikten sonra değişmez'),
-    kind: z.enum(credentialKinds),
-    baseUrl: z.string().max(500).optional().describe('instance/taban URL (Salesforce instance, Jira site, Camunda REST kökü)'),
-    tokenUrl: z.string().max(500).optional().describe('oauth2 belirteç ucu'),
-    clientId: z.string().max(200).optional(),
-    username: z.string().max(200).optional(),
-    scopes: z.array(z.string().max(200)).max(50).optional(),
-    apiKeyHeader: z.string().max(100).optional().describe("api-key başlığı; yoksa Authorization"),
-    clientSecret: z.string().max(4000).optional(),
-    password: z.string().max(4000).optional(),
-    apiKey: z.string().max(4000).optional().describe('webhook türünde webhook URL\'si buraya yazılır'),
-    refreshToken: z.string().max(4000).optional(),
-    accessToken: z.string().max(4000).optional()
-};
-function catalogOf(payload) {
-    const data = payload?.data ?? payload;
-    return Array.isArray(data) ? data : [];
-}
-export function registerConnectorTools(server, platform) {
-    const config = platform.config;
-    server.registerTool('connector_list', {
-        title: 'Bağlayıcı kataloğu',
-        description: "Kayıtlı bağlayıcıları listeler (GET bpm/connectors): ad, kategori (ai | process-engine | productivity | messaging | business-app | rpa), başlık, sürüm, desteklenen kimlik türleri ve işlem adları. category verilirse yalnız o kategori döner (süzme gateway'de). İşlem girdi/çıktı şemaları için connector_get. Süreçte kullanım: service düğümü connector { name, operation, credentialRef, input } ya da dış motor için externalEngine { engine: camunda8 | camunda7 | flowable, processKey, credentialRef, input }.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            category: z.enum(['ai', 'process-engine', 'productivity', 'messaging', 'business-app', 'rpa']).optional().describe('yalnız bu kategorideki bağlayıcılar')
-        },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, category }) => catalogOf(await platform.tenant('GET', project, '/bpm/connectors', { environment }))
-        .filter(connector => !category || connector.category === category)
-        .map(connector => ({
-        name: connector.name,
-        category: connector.category,
-        title: connector.title,
-        version: connector.version,
-        credentialKinds: connector.credentialKinds,
-        operations: (Array.isArray(connector.operations) ? connector.operations : []).map(operation => operation.name)
-    }))));
-    server.registerTool('connector_get', {
-        title: 'Bağlayıcıyı getir',
-        description: 'Bağlayıcının işlemlerini girdi ve çıktı şemalarıyla döner (katalogdan adla). Girdi doğrulaması zorunlu alanlar ve temel türlerle sınırlıdır; düğümde input değerleri Jint ifadesidir.',
-        inputSchema: { project: projectParam, environment: environmentParam, name: z.string().min(1).max(50) },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, name }) => {
-        const catalog = catalogOf(await platform.tenant('GET', project, '/bpm/connectors', { environment }));
-        const connector = catalog.find(candidate => candidate.name === name);
-        if (!connector)
-            throw new PlatformApiError(`connector_get: '${name}' diye bağlayıcı yok. Mevcutlar: ${catalog.map(candidate => String(candidate.name)).join(', ')}.`, 404);
-        return connector;
-    }));
-    server.registerTool('connector_credential_list', {
-        title: 'Kimlik kasasını listele',
-        description: "Kasa kayıtlarını listeler (GET bpm/connector-credentials): ad, bağlayıcı, tür, taban/belirteç URL'si, istemci kimliği, kapsamlar, secretFields (yalnız saklı sırların ADLARI) ve anahtar sürümü. Platform sırrı hiç döndürmez; gateway sır ya da belirteç adlı alanları ayrıca *** ile maskeler (BPM-017). Yetki process.manage.",
-        inputSchema: { project: projectParam, environment: environmentParam },
-        annotations: readOnly
-    }, handle(config, ({ project, environment }) => platform.tenant('GET', project, '/bpm/connector-credentials', { environment })));
-    server.registerTool('connector_credential_create', {
-        title: 'Kasaya kimlik yaz',
-        description: "Bağlayıcı kimliği oluşturur (POST bpm/connector-credentials). Sırlar (clientSecret, password, apiKey, refreshToken, accessToken) proje veri anahtarıyla şifrelenir; yanıtta ve gateway günlüğünde görünmez (BPM-017). Türler: basic · api-key (apiKeyHeader) · bearer · oauth2-client (tokenUrl, clientId, clientSecret, scopes) · oauth2-auth-code (refreshToken elle) · webhook (URL apiKey'de; teams-webhook, slack). Yazdıktan sonra connector_credential_update { operation: 'test' }.",
-        inputSchema: { project: projectParam, environment: environmentParam, ...credentialFields },
-        annotations: writes
-    }, handle(config, async ({ project, environment, ...credential }) => {
-        assertProcessNotProduction('connector_credential_create', environment, config);
-        return platform.tenant('POST', project, '/bpm/connector-credentials', { environment, body: credential });
-    }));
-    server.registerTool('connector_credential_update', {
-        title: 'Kasa kimliğini güncelle / test et / döndür',
-        description: "operation save (varsayılan; PUT bpm/connector-credentials/{id}, tam gövde — bütün sır alanları boşsa saklı sırlar korunur; TEK bir sır alanı bile gönderilirse saklı sırların tamamı gönderilenle değişir, o türün bütün sırlarını birlikte verin: oauth2-client clientSecret · oauth2-auth-code clientSecret + refreshToken · basic password · api-key/webhook apiKey · bearer accessToken) · test (POST …/{id}/test-connection; bağlayıcının bağlantı denemesi, hata 502 ConnectorFailed) · rotate (POST …/rotate; bütün sırları en yeni proje anahtar sürümüyle yeniden şifreler, id almaz, değişen sayısını döner; şifreleme anahtarı yapılandırılmamışsa kasa boş olsa bile ProtectionKeyUnavailable hatası döner — 0 başarı değildir).",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid.optional().describe('save ve test için zorunlu'),
-            operation: z.enum(['save', 'test', 'rotate']).optional(),
-            ...z.object(credentialFields).partial().shape
-        },
-        annotations: updates
-    }, handle(config, async ({ project, environment, id, operation, ...credential }) => {
-        assertProcessNotProduction('connector_credential_update', environment, config);
-        const resolvedOperation = operation ?? 'save';
-        if (resolvedOperation === 'rotate')
-            return platform.tenant('POST', project, '/bpm/connector-credentials/rotate', { environment });
-        if (!id)
-            throw new PlatformApiError(`connector_credential_update: operation '${resolvedOperation}' id ister (istek gönderilmedi).`, 400);
-        if (resolvedOperation === 'test')
-            return platform.tenant('POST', project, `/bpm/connector-credentials/${id}/test-connection`, { environment });
-        if (!credential.name || !credential.connectorName || !credential.kind)
-            throw new PlatformApiError("connector_credential_update: save tam gövde ister — name, connectorName, kind (connector_credential_list çıktısından) (istek gönderilmedi).", 400);
-        return platform.tenant('PUT', project, `/bpm/connector-credentials/${id}`, { environment, body: credential });
-    }));
-    server.registerTool('connector_credential_delete', {
-        title: 'Kasa kimliğini sil',
-        description: 'Kimliği siler (DELETE bpm/connector-credentials/{id}). Bir süreç düğümü kullanıyorsa 422 ReferencedByProcess, bir olay ya da e-posta kaynağı kullanıyorsa 400 RowHasExistingRelation döner; önce başvuruları değiştirin.',
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
-        annotations: destructive
-    }, handle(config, async ({ project, environment, id }) => {
-        assertProcessNotProduction('connector_credential_delete', environment, config);
-        return platform.tenant('DELETE', project, `/bpm/connector-credentials/${id}`, { environment });
-    }));
-    server.registerTool('process_event_source_list', {
-        title: 'Olay kaynaklarını listele',
-        description: 'Olay kaynaklarını listeler (GET bpm/event-sources): ad, tür, adres, mesaj adı, korelasyon anahtarı ifadesi, tampon süresi, etkinlik ve son olay zamanı.',
-        inputSchema: { project: projectParam, environment: environmentParam },
-        annotations: readOnly
-    }, handle(config, ({ project, environment }) => platform.tenant('GET', project, '/bpm/event-sources', { environment })));
-    server.registerTool('process_event_source_create', {
-        title: 'Olay kaynağı yaz',
-        description: "Dış olayı BPM mesajına çeviren kaynak oluşturur (POST bpm/event-sources) ya da id verilirse tam gövdeyle günceller (PUT …/{id}). Olay girişi process_trigger { kind: 'event-source', name, eventId, payload }: payload korelasyon anahtarı Jint ifadesiyle (ör. 'payload.siparisNo') mesaja dönüşür, aynı eventId ikinci kez işlenmez. kind http taşımadan bağımsızdır; kafka/service-bus tüketicisi henüz yok (NuGet), rabbitmq dinleyicisi borç.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid.optional().describe('verilirse güncelleme'),
-            name: z.string().min(1).max(100),
-            kind: z.enum(eventSourceKinds),
-            address: z.string().max(500).optional().describe('konu/kuyruk adresi'),
-            credentialRef: z.string().max(100).optional().describe('kasadaki kaydın adı (connector_credential_list); olmayan ad 404'),
-            messageName: z.string().min(1).max(100),
-            correlationKey: z.string().max(500).optional().describe("Jint ifadesi, ör. 'payload.siparisNo'"),
-            bufferSeconds: z.number().int().min(0).max(86400).optional(),
-            isActive: z.boolean().optional()
-        },
-        annotations: writes
-    }, handle(config, async ({ project, environment, id, ...source }) => {
-        assertProcessNotProduction('process_event_source_create', environment, config);
-        return id
-            ? platform.tenant('PUT', project, `/bpm/event-sources/${id}`, { environment, body: source })
-            : platform.tenant('POST', project, '/bpm/event-sources', { environment, body: source });
-    }));
-    server.registerTool('process_event_source_delete', {
-        title: 'Olay kaynağını sil',
-        description: 'Olay kaynağını siler (DELETE bpm/event-sources/{id}); o ada gelen olaylar 404 alır.',
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
-        annotations: destructive
-    }, handle(config, async ({ project, environment, id }) => {
-        assertProcessNotProduction('process_event_source_delete', environment, config);
-        return platform.tenant('DELETE', project, `/bpm/event-sources/${id}`, { environment });
-    }));
-    server.registerTool('process_mail_source_list', {
-        title: 'E-posta kaynaklarını listele',
-        description: 'E-posta kaynaklarını listeler (GET bpm/mail-sources): tür (imap | graph), sunucu, posta kutusu, klasör, kurallar, son UID ve son yoklama zamanı.',
-        inputSchema: { project: projectParam, environment: environmentParam },
-        annotations: readOnly
-    }, handle(config, ({ project, environment }) => platform.tenant('GET', project, '/bpm/mail-sources', { environment })));
-    server.registerTool('process_mail_source_create', {
-        title: 'E-posta kaynağı yaz',
-        description: "Gelen e-postayı kurallarla BPM mesajına çeviren kaynak oluşturur (POST bpm/mail-sources) ya da id verilirse günceller (PUT …/{id}). Kural { subjectPattern, fromPattern (regex), messageName, correlationKey (Jint; mail.subject, mail.from, match.groups) }; ekler files'a yazılır, aynı Message-ID ikinci kez işlenmez. credentialRef kasadaki bir kaydın adıdır (connector_credential_list): kayıtta kimliğe çözülür, olmayan ad 404 (connector-credential: <ad>) döner; kasa kaydının adı sonradan değişirse kaynak yeni adı gösterir. imap kimliği 'imap' bağlayıcısının kasa kaydıdır (basic), graph kimliği 'microsoft-graph' (oauth2-client). Zamanlanmış yoklama yok: process_trigger { kind: 'mail-source', sourceId }.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid.optional().describe('verilirse güncelleme'),
-            name: z.string().min(1).max(100),
-            kind: z.enum(mailSourceKinds),
-            host: z.string().max(200).optional(),
-            port: z.number().int().min(1).max(65535).optional(),
-            useSsl: z.boolean().optional(),
-            mailbox: z.string().max(200).optional(),
-            folder: z.string().max(200).optional(),
-            credentialRef: z.string().min(1).max(100).describe('kasadaki kaydın adı (connector_credential_list); olmayan ad 404'),
-            rules: z.array(z.object({
-                subjectPattern: z.string().max(500).optional(),
-                fromPattern: z.string().max(500).optional(),
-                messageName: z.string().min(1).max(100),
-                correlationKey: z.string().max(500).optional()
-            })).min(1).max(50),
-            isActive: z.boolean().optional()
-        },
-        annotations: writes
-    }, handle(config, async ({ project, environment, id, ...source }) => {
-        assertProcessNotProduction('process_mail_source_create', environment, config);
-        return id
-            ? platform.tenant('PUT', project, `/bpm/mail-sources/${id}`, { environment, body: source })
-            : platform.tenant('POST', project, '/bpm/mail-sources', { environment, body: source });
-    }));
-    server.registerTool('process_mail_source_delete', {
-        title: 'E-posta kaynağını sil',
-        description: 'E-posta kaynağını siler (DELETE bpm/mail-sources/{id}).',
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
-        annotations: destructive
-    }, handle(config, async ({ project, environment, id }) => {
-        assertProcessNotProduction('process_mail_source_delete', environment, config);
-        return platform.tenant('DELETE', project, `/bpm/mail-sources/${id}`, { environment });
-    }));
-}

package/dist/tools/decisions.js

@@ -1,206 +0,0 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, microOps } from './common.js';
-import { applyPolicyMode, attachFindings, PolicyBlockError } from '../knowledge/policy.js';
-import { assertInline, writeLocalFile } from './bpmGovernance.js';
-import { assertProcessNotProduction, dataOf } from './bpm.js';
-import { unmappedMembers, withUnmappedMembers } from '../knowledge/schemaGuard.js';
-import { resolvePatchOperations } from '../knowledge/outlines.js';
-import { decisionFindings } from '../knowledge/decision.js';
-import { withNormalization } from '../knowledge/normalize.js';
-import { PlatformApiError } from '../platform/errors.js';
-import { handle } from '../platform/responses.js';
-import { readFile } from 'node:fs/promises';
-import fastJsonPatch from 'fast-json-patch';
-import { resolve } from 'node:path';
-import { z } from 'zod';
-const maxInlineXmlBytes = 256_000;
-const maxDmnBytes = 5_000_000;
-const decisionParam = z.record(z.unknown())
-    .describe("Karar modeli: { slug, name, kind: table | literal, hitPolicy: unique | any | first | priority | collect | rule-order | output-order, aggregation?, inputs[{ id, label, expression, typeRef, allowedValues }], outputs[{ id, name, typeRef, allowedValues, defaultOutputEntry }], rules[{ id, description, inputEntries[], outputEntries[] }], requires[], inputData[], literalExpression?, typeRef? }. Hücreler FEEL; '-' joker. Ayrıntı platform_guide('decision').");
-const policyOverrideParam = z.boolean().optional()
-    .describe("true: politika block bulgularını warn'a indirir (bilinçli istisna; yanıtta işaretlenir)");
-const patchOperationsParam = z.array(z.record(z.unknown())).min(1)
-    .describe("RFC 6902 JSON Patch işlemleri, yollar karar modeline göre. Kural ve sütun hedeflerken İNDEKS YERİNE SEÇİCİ: { op: 'replace', path: '/rules[id=buyuk]/outputEntries/0', value: '3' }; yeni kural '/rules/-'.");
-function lintDecision(config, decision, policyOverride) {
-    if (config.policyMode === 'off')
-        return [];
-    const findings = applyPolicyMode(config, decisionFindings(decision), policyOverride === true);
-    const blocking = findings.filter(finding => finding.severity === 'block');
-    if (blocking.length > 0)
-        throw new PolicyBlockError(blocking);
-    return findings;
-}
-export function registerDecisionTools(server, platform) {
-    const config = platform.config;
-    server.registerTool('decision_list', {
-        title: 'Kararları listele',
-        description: "DMN karar tablolarını ve literal kararları listeler (GET bpm/decisions): slug, ad, kind, hitPolicy, aktif ve taslak sürüm numarası. Süreçte 'decision' düğümü decisionSlug ile başvurur.",
-        inputSchema: { project: projectParam, environment: environmentParam, searchTerm: z.string().max(200).optional(), applicationId: guid.optional(), ...pagingParams },
-        annotations: readOnly
-    }, handle(config, ({ project, environment, ...query }) => platform.tenant('GET', project, '/bpm/decisions', { environment, query })));
-    server.registerTool('decision_get', {
-        title: 'Kararı getir',
-        description: "Kararı getirir (GET bpm/decisions/{id}): decision güncel model (taslak varsa taslak), activeDecision yayındaki model, versions[] (draft → active → retiring → retired). Değerlendirme için decision_preview.",
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
-        annotations: readOnly
-    }, handle(config, ({ project, environment, id }) => platform.tenant('GET', project, `/bpm/decisions/${id}`, { environment })));
-    server.registerTool('decision_create', {
-        title: 'Karar oluştur',
-        description: "Yeni karar yazar (POST bpm/decisions; taslak sürüm). İlk kullanımdan önce platform_guide('decision') okuyun. Gateway yazmadan önce denetler: DMN-001 (unique tabloda aynı girdiyi eşleyen iki kural, block) ve DMN-002 (FEEL alt kümesinde olmayan işlev, warn — backend yine de yazımı 422 ile reddeder). Yayın decision_publish; süreçte kullanım 'decision' düğümü { decisionSlug, input, output }.",
-        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid.optional(), decision: decisionParam, policyOverride: policyOverrideParam },
-        annotations: writes
-    }, handle(config, async ({ project, environment, applicationId, decision, policyOverride }) => {
-        assertProcessNotProduction('decision_create', environment, config);
-        const findings = lintDecision(config, decision, policyOverride);
-        const saved = await platform.tenant('POST', project, '/bpm/decisions', { environment, body: { applicationId, decision } });
-        return withUnmappedMembers(attachFindings(dataOf(saved), findings), unmappedMembers('CreateDecisionCommand', { applicationId, decision }));
-    }));
-    server.registerTool('decision_update', {
-        title: 'Kararı güncelle',
-        description: "Kararın taslağını tam modelle yazar (PUT bpm/decisions/{id}; taslak yoksa açılır) ya da retireVersion ile aktif/emekliye ayrılan sürümü emekliye ayırır (POST …/versions/{n}/retire). İkisinden biri. Backend sürüm denetimi yapmaz: aynı kararı iki ajan yazıyorsa son yazan kazanır; hedefli değişiklik için decision_patch. Yayından sonra slug değişmez. DMN-001/002 denetimi decision_create ile aynı.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            decision: decisionParam.optional(),
-            retireVersion: z.number().int().min(1).optional().describe('emekliye ayrılacak sürüm numarası (decision yerine)'),
-            policyOverride: policyOverrideParam
-        },
-        annotations: updates
-    }, handle(config, async ({ project, environment, id, decision, retireVersion, policyOverride }) => {
-        assertProcessNotProduction('decision_update', environment, config);
-        if (Boolean(decision) === (retireVersion !== undefined))
-            throw new PlatformApiError("decision_update: 'decision' ya da 'retireVersion' — yalnız biri (istek gönderilmedi).", 400);
-        if (retireVersion !== undefined)
-            return dataOf(await platform.tenant('POST', project, `/bpm/decisions/${id}/versions/${retireVersion}/retire`, { environment }));
-        const findings = lintDecision(config, decision, policyOverride);
-        return withUnmappedMembers(attachFindings(dataOf(await platform.tenant('PUT', project, `/bpm/decisions/${id}`, { environment, body: { decision } })), findings), unmappedMembers('UpdateDecisionCommand', { decision }));
-    }));
-    server.registerTool('decision_patch', {
-        title: 'Karara patch uygula',
-        description: "Tam modeli bağlama almadan hedefli değişiklik: gateway güncel modeli okur (GET), seçicileri (/rules[id=x], /inputs[id=x]) çözer, yamayı yerelde uygular, DMN-001/002 denetiminden geçirir ve tam modeli taslağa yazar (PUT). Backend sürüm denetimi yok: okuma ile yazma arasında başka yazan olursa değişikliği ezilir. Yanıt { patchTargets, decision }.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            operations: patchOperationsParam.optional(),
-            ops: patchOperationsParam.optional().describe("'operations' ile aynı alan (eşanlamlı)"),
-            policyOverride: policyOverrideParam
-        },
-        annotations: updates
-    }, handle(config, async ({ project, environment, id, operations: givenOperations, ops, policyOverride }) => {
-        assertProcessNotProduction('decision_patch', environment, config);
-        const operations = microOps('decision_patch', ops, givenOperations);
-        const current = dataOf(await platform.tenant('GET', project, `/bpm/decisions/${id}`, { environment }));
-        const model = structuredClone((current.decision ?? {}));
-        const resolved = resolvePatchOperations(model, operations, 'decision_get');
-        let patched;
-        try {
-            patched = fastJsonPatch.applyPatch(model, resolved.operations, true, false).newDocument;
-        }
-        catch (error) {
-            throw new PlatformApiError(`decision_patch: yama uygulanamadı — ${error instanceof Error ? error.message : String(error)} (istek gönderilmedi). Yolları decision_get çıktısına göre kurun.`, 400);
-        }
-        const findings = lintDecision(config, patched, policyOverride);
-        const saved = dataOf(await platform.tenant('PUT', project, `/bpm/decisions/${id}`, { environment, body: { decision: patched } }));
-        return withNormalization(attachFindings({ patchTargets: resolved.targets, decision: saved.decision ?? patched }, findings), resolved.notes);
-    }));
-    server.registerTool('decision_delete', {
-        title: 'Kararı sil',
-        description: "Kararı ve bütün sürümlerini siler (DELETE bpm/decisions/{id}). Bir süreç tanımı decisionSlug ile başvuruyorsa 422 ReferencedByProcess, başka karar requires ile başvuruyorsa 422 DecisionInvalid.",
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid },
-        annotations: destructive
-    }, handle(config, async ({ project, environment, id }) => {
-        assertProcessNotProduction('decision_delete', environment, config);
-        return platform.tenant('DELETE', project, `/bpm/decisions/${id}`, { environment });
-    }));
-    server.registerTool('decision_clone', {
-        title: 'Kararı klonla',
-        description: 'Kararın güncel modelinden yeni slug ile taslak kopya oluşturur (GET + POST bpm/decisions). variable verilmemişse slug\'dan türetildiği için üst kararlar yeni adı görür; requires başvuruları kopyalanır.',
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid, slug: z.string().min(1).max(100) },
-        annotations: writes
-    }, handle(config, async ({ project, environment, id, slug }) => {
-        assertProcessNotProduction('decision_clone', environment, config);
-        const current = dataOf(await platform.tenant('GET', project, `/bpm/decisions/${id}`, { environment }));
-        const decision = { ...structuredClone((current.decision ?? {})), slug };
-        return dataOf(await platform.tenant('POST', project, '/bpm/decisions', { environment, body: { applicationId: current.applicationId ?? undefined, decision } }));
-    }));
-    server.registerTool('decision_preview', {
-        title: 'Kararı değerlendir (kuru)',
-        description: "Kararı verilen girdilerle YAN ETKİSİZ değerlendirir (POST bpm/decisions/{id}/evaluate; transaction açmaz, defter yazmaz — tablo tasarımını denemenin yolu, platform_guide('decision') §Deneme): version verilmezse taslak (yoksa aktif). DRD'deki alt kararlar (requires) önce değerlendirilir. Yanıt { value, outputs, matchedRules, decisions[] (her karar için inputs, value, matchedRules) }. unique'te birden çok kural eşleşirse 422 DecisionHitPolicyViolated (eşleşen kural kimlikleriyle); hiçbiri eşleşmezse defaultOutputEntry ya da null.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            inputs: z.record(z.unknown()).describe("girdi adları → değerler, ör. { tutar: 180000, kategori: 'makine' }; tarih '2026-09-17', süre 'P3D'"),
-            version: z.number().int().min(1).optional()
-        },
-        annotations: readOnly
-    }, handle(config, ({ project, environment, id, inputs, version }) => platform.tenant('POST', project, `/bpm/decisions/${id}/evaluate`, { environment, query: { version }, body: { inputs } })));
-    server.registerTool('decision_publish', {
-        title: 'Kararı yayınla',
-        description: "Taslağı aktif sürüm yapar (POST bpm/decisions/{id}/publish); önceki aktif sürüm retiring olur. requires içindeki her kararın aktif sürümü olmalı (422 DecisionUnknown) ve döngü olmamalı (422 DecisionInvalid). Gateway yayından önce taslağı DMN-001/002 ile denetler. production hedefi durur (BPM-001).",
-        inputSchema: { project: projectParam, environment: environmentParam, id: guid, policyOverride: policyOverrideParam },
-        annotations: writes
-    }, handle(config, async ({ project, environment, id, policyOverride }) => {
-        assertProcessNotProduction('decision_publish', environment, config);
-        const current = dataOf(await platform.tenant('GET', project, `/bpm/decisions/${id}`, { environment }));
-        const findings = lintDecision(config, (current.decision ?? {}), policyOverride);
-        return attachFindings(dataOf(await platform.tenant('POST', project, `/bpm/decisions/${id}/publish`, { environment })), findings);
-    }));
-    server.registerTool('decision_dmn_get', {
-        title: 'Kararı DMN 1.3 XML olarak dışa aktar',
-        description: "Kararı ve requires ile bağlı alt kararlarını DMN 1.3 XML'e çevirir (GET bpm/decisions/{id}/dmn; zeyrek: uzantısı kaynak ve kategori bilgisini taşır). version verilmezse taslak (yoksa aktif). Yanıt { decisionId, versionNumber, state, sizeBytes, xml }; 256 KB üstü için outPath verin.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            id: guid,
-            version: z.number().int().min(1).optional(),
-            outPath: z.string().min(1).optional().describe('verilirse XML bu yerel yola yazılır ve yanıt yalnız özet döner')
-        },
-        annotations: readOnly
-    }, handle(config, async ({ project, environment, id, version, outPath }) => {
-        const response = await platform.tenantWithHeaders('GET', project, `/bpm/decisions/${id}/dmn`, { environment, query: { version }, expectBinary: true });
-        const payload = response.body;
-        const xml = payload.bytes.toString('utf8').replace(/^\uFEFF/, '');
-        const summary = {
-            decisionId: id,
-            versionNumber: Number(response.headers['x-decision-version']) || null,
-            state: response.headers['x-decision-version-state'] ?? null,
-            sizeBytes: payload.bytes.byteLength
-        };
-        if (outPath)
-            return { ...summary, path: await writeLocalFile('decision_dmn_get', outPath, xml) };
-        const inline = { ...summary, xml };
-        assertInline('decision_dmn_get', config, inline);
-        return inline;
-    }));
-    server.registerTool('decision_dmn_update', {
-        title: 'DMN 1.3 XML içe aktar',
-        description: "DMN 1.3 XML'deki kararları içe aktarır (POST bpm/decisions/import-dmn): slug'ı (decision id) mevcut karar taslağına yazılır, yoksa yeni karar oluşur; DRD bilgi gereksinimleri requires olur. xml (≤ 256 KB) ya da filePath (≤ 5 MB) — biri. Camunda/Trisotech tablolarında desteklenmeyen FEEL işlevi değerlendirmede 422 ExpressionInvalid döner; içe aktardıktan sonra decision_preview ile deneyin. DTD/dış varlık içeren XML 400.",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            applicationId: guid.optional(),
-            xml: z.string().min(1).max(maxInlineXmlBytes).optional(),
-            filePath: z.string().min(1).optional().describe('yerel .dmn dosyası')
-        },
-        annotations: updates
-    }, handle(config, async ({ project, environment, applicationId, xml, filePath }) => {
-        assertProcessNotProduction('decision_dmn_update', environment, config);
-        if (Boolean(xml) === Boolean(filePath))
-            throw new PlatformApiError("decision_dmn_update: 'xml' ya da 'filePath' — yalnız biri (istek gönderilmedi).", 400);
-        let content = xml ?? '';
-        if (filePath) {
-            try {
-                content = await readFile(resolve(filePath), 'utf8');
-            }
-            catch (error) {
-                throw new PlatformApiError(`decision_dmn_update: dosya okunamadı — ${resolve(filePath)} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür (istek gönderilmedi).`, 400);
-            }
-        }
-        content = content.replace(/^/, '');
-        if (Buffer.byteLength(content, 'utf8') > maxDmnBytes)
-            throw new PlatformApiError(`decision_dmn_update: XML en çok ${maxDmnBytes} B (istek gönderilmedi).`, 413);
-        return platform.tenant('POST', project, '/bpm/decisions/import-dmn', { environment, body: { applicationId, xml: content } });
-    }));
-}

package/dist/tools/mobile.js

@@ -1,221 +0,0 @@
-import { z } from 'zod';
-import { environmentParam, guid, projectParam, writes } from './common.js';
-import { fetchHost, pageUpdateBody, unwrap } from './screens.js';
-import { fetchCatalogSlugs } from './components.js';
-import { mobileTabsWarnings } from './applications.js';
-import { PlatformApiError } from '../platform/errors.js';
-import { handle } from '../platform/responses.js';
-import { PAGE_CONTAINER_ELEMENT_ID, ensurePageContainer } from '../knowledge/normalize.js';
-import { mobileProfile, shellLessPageSkeleton } from '../knowledge/platform/mobile.js';
-import { MAX_MOBILE_TABS } from '../knowledge/platform/mobileTabs.js';
-import { forgetApplication } from '../knowledge/platform/resolve.js';
-import { readKnowledgeFile } from '../resources/knowledge.js';
-/** Ana sayfa: açıkça verilen, yoksa ilk sekme, yoksa ilk sayfa. */
-function homepageSlug(input) {
-    return input.homepage ?? input.tabs?.[0]?.pageSlug ?? input.pages[0].pageSlug;
-}
-export function mobileAppInputErrors(input) {
-    const errors = [];
-    const slugs = input.pages.map(page => page.pageSlug);
-    const repeated = slugs.filter((slug, index) => slugs.indexOf(slug) !== index);
-    if (input.pages.length === 0)
-        errors.push('pages en az bir sayfa ister');
-    if (repeated.length > 0)
-        errors.push(`pages içinde tekrar eden slug var: ${[...new Set(repeated)].join(', ')}`);
-    if (input.tabs !== undefined) {
-        const tabSlugs = input.tabs.map(tab => tab.pageSlug);
-        if (input.tabs.length === 0)
-            errors.push("tabs verildiyse en az bir öğe taşır; sekme istemiyorsan alanı hiç gönderme (yığın)");
-        if (input.tabs.length > MAX_MOBILE_TABS)
-            errors.push(`tabs en fazla ${MAX_MOBILE_TABS} öğe taşır (${input.tabs.length} verildi) — fazlası yığına açılan sayfa olarak kalmalı`);
-        for (const slug of tabSlugs.filter(slug => !slugs.includes(slug)))
-            errors.push(`tabs '${slug}' pages içinde yok — sekme yalnız kurulan bir sayfayı gösterebilir`);
-        if (tabSlugs.some((slug, index) => tabSlugs.indexOf(slug) !== index))
-            errors.push('tabs içinde tekrar eden sayfa var');
-    }
-    if (input.homepage !== undefined && !slugs.includes(input.homepage))
-        errors.push(`homepage '${input.homepage}' pages içinde yok`);
-    return errors;
-}
-export function buildMobileAppPlan(input) {
-    const home = homepageSlug(input);
-    const others = input.pages.filter(page => page.pageSlug !== home);
-    return [
-        { step: 'application_create', tool: 'application_create', summary: "type:'mobile' uygulama; backend ana sayfayı kendisi açar" },
-        { step: 'layout_create', tool: 'layout_create', summary: `kabuk: app-bar + slot${input.drawer ? ' + drawer widget (app-bar.menuTarget)' : ''}` },
-        ...others.map((page, index) => ({ step: `page_create#${index + 1}`, tool: 'page_create', summary: `'${page.pageSlug}' (${page.pageName}), layoutId ile` })),
-        { step: 'page_update#homepage', tool: 'page_update', summary: `backend'in ana sayfası → '${home}' (ad, slug, layoutId)` },
-        ...(input.tabs ? [{ step: 'application_update', tool: 'application_update', summary: `properties.mobile.tabs: ${input.tabs.map(tab => tab.pageSlug).join(' · ')}` }] : [])
-    ];
-}
-/** Kabuk ağacı örnek dosyasından okunur — örnek ile aracın kurduğu layout tek kaynaktır. */
-function shellViews(input) {
-    const example = JSON.parse(readKnowledgeFile('examples', input.drawer ? 'mobile-app-shell-drawer.json' : 'mobile-app-shell-stack.json'));
-    const views = structuredClone(example.layoutCreate.views);
-    // app-bar kabukta üst güvenli alanın içindedir (mizanpaj S1); ağaçta derinlikten bağımsız aranır.
-    const findAppBar = (nodes) => nodes.find(node => node.type === 'app-bar') ?? nodes.map(node => findAppBar(node.children ?? [])).find(Boolean);
-    const appBar = findAppBar(views);
-    if (appBar && input.title)
-        appBar.props.title = { type: 'static', ref: null, data: input.title };
-    return views;
-}
-const SHELL_TYPES = ['app-bar', 'slot'];
-/** Boş sayfanın şeması: kabuklu sayfada kök şablonu, kabuksuzda iskeletiyle (üst pay + kenar boşluğu). */
-function mobilePageSchema(shell) {
-    const schema = ensurePageContainer([], mobileProfile.layout.rootContainer).schema;
-    if (!shell && schema[0])
-        shellLessPageSkeleton(schema[0]);
-    return schema;
-}
-export function registerMobileTools(server, platform) {
-    const config = platform.config;
-    server.registerTool('mobile_app_create', {
-        title: 'Mobil uygulamayı kabuğuyla kur',
-        description: "Mobil uygulamayı (type:'mobile'), kabuk layout'unu (app-bar + slot; drawer:true ise çekmece widget'ı), sayfalarını ve isteğe bağlı sekme ayarını (properties.mobile.tabs) TEK çağrıda kurar. Sıra: application_create → layout_create → page_create (sayfalar layoutId ile doğar) → backend'in açtığı ana sayfa seçilen ana sayfaya dönüştürülür (yetim sayfa kalmaz) → application_update (yalnız tabs verildiyse). tabs yoksa gezinme yığındır. dryRun:true planı döner, hiçbir şey yazmaz. Platformda işlem yoktur: hata olursa yanıt completed (kurulanlar), failed (düşen adım) ve remaining (kalanlar) taşır — kalanları tekil araçlarla tamamlayın. Kabuk bileşenleri (app-bar, slot) mobil katalogda yoksa layout atlanır ve uyarı döner. Rehber: platform_guide('mobile').",
-        inputSchema: {
-            project: projectParam,
-            environment: environmentParam,
-            projectId: guid,
-            slug: z.string().min(1),
-            name: z.string().min(1),
-            color: z.string().optional(),
-            pages: z.array(z.object({ pageSlug: z.string().min(1), pageName: z.string().min(1) })).min(1),
-            tabs: z.array(z.object({ pageSlug: z.string().min(1), label: z.string().optional(), icon: z.string().optional() })).optional()
-                .describe(`1-${MAX_MOBILE_TABS} sekme; her pageSlug pages içinden. Verilmezse sekme çubuğu yok (yığın). label 't:<anahtar>' ile yazılırsa çeviri sözlüğünden çözülür (platform_guide('mobile') §Çok dil).`),
-            drawer: z.boolean().optional().describe("true: layout'a drawer widget'ı + app-bar.menuTarget (çekmece)"),
-            title: z.string().optional().describe('app-bar başlığı (bütün sayfalar için sabit metin). Boşsa çubuk başlıksız çizilir — sayfa adına düşen bir yedek YOKTUR; sayfaya göre değişen başlık için title\'ı bir değişkene bağlayın ya da başlığı sayfanın içine text olarak koyun'),
-            homepage: z.string().optional().describe('Ana sayfanın pageSlug\'ı; varsayılan ilk sekme, sekme yoksa ilk sayfa'),
-            dryRun: z.boolean().optional()
-        },
-        annotations: writes
-    }, handle(config, async ({ project, environment, projectId, slug, name, color, pages, tabs, drawer, title, homepage, dryRun }) => {
-        const input = { pages, ...(tabs ? { tabs } : {}), ...(drawer ? { drawer } : {}), ...(homepage ? { homepage } : {}), ...(title ? { title } : {}) };
-        const errors = mobileAppInputErrors(input);
-        if (errors.length > 0)
-            throw new PlatformApiError(`mobile_app_create: ${errors.join(' · ')}. Hiçbir şey yazılmadı.`, 400);
-        const plan = buildMobileAppPlan(input);
-        if (dryRun)
-            return { dryRun: true, plan };
-        const completed = [];
-        const skipped = new Set();
-        const warnings = [];
-        const home = homepageSlug(input);
-        const pageIds = new Map();
-        let applicationId;
-        let homepageId;
-        let layoutId;
-        let current = 'application_create';
-        try {
-            const created = unwrap(await platform.org('POST', `/applications/${projectId}`, {
-                environment,
-                body: { slug, name, type: 'mobile', ...(color ? { color } : {}) }
-            }));
-            applicationId = String(created.id ?? '');
-            homepageId = typeof created.homepageId === 'string'
-                ? created.homepageId
-                : String(created.homepage?.id ?? '');
-            forgetApplication(platform);
-            if (!applicationId || !homepageId)
-                throw new PlatformApiError('application_create yanıtı uygulama ya da ana sayfa kimliği taşımıyor — application_get ile kontrol edin.');
-            completed.push({ step: 'application_create', id: applicationId });
-            current = 'layout_create';
-            const catalog = await fetchCatalogSlugs(platform, project, environment, applicationId);
-            const missing = SHELL_TYPES.filter(type => !catalog.has(type));
-            if (missing.length > 0) {
-                skipped.add('layout_create');
-                warnings.push(`MOB-003 (uyarı) — kabuk bileşenleri mobil katalogda yok (${missing.join(', ')}): layout KURULMADI, sayfalar layout'suz açıldı. Katalog yazıldıktan sonra kabuğu ngapps://examples/mobile-app-shell-${input.drawer ? 'drawer' : input.tabs ? 'tab' : 'stack'} ile layout_create + page_update(layoutId) olarak kurun.`);
-            }
-            else {
-                const layout = unwrap(await platform.tenant('POST', project, `/layouts/${applicationId}`, {
-                    environment,
-                    body: { name: `${name} kabuğu`, views: shellViews(input), events: [], parameters: null }
-                }));
-                layoutId = String(layout.id ?? '');
-                completed.push({ step: 'layout_create', id: layoutId });
-            }
-            const others = pages.filter(page => page.pageSlug !== home);
-            for (const [index, page] of others.entries()) {
-                current = `page_create#${index + 1}`;
-                const saved = unwrap(await platform.tenant('POST', project, `/pages/${applicationId}`, {
-                    environment,
-                    body: {
-                        name: page.pageName,
-                        slug: page.pageSlug,
-                        browserTitle: '',
-                        browserTitleKey: '',
-                        layoutId: layoutId ?? null,
-                        roleIds: [],
-                        middlewareIds: [],
-                        events: [],
-                        schema: mobilePageSchema(layoutId !== undefined)
-                    }
-                }));
-                pageIds.set(page.pageSlug, String(saved.id ?? ''));
-                completed.push({ step: current, id: String(saved.id ?? '') });
-            }
-            current = 'page_update#homepage';
-            const homePage = pages.find(page => page.pageSlug === home);
-            const existing = await fetchHost(platform, 'page', project, environment, applicationId, homepageId);
-            // Backend'in açtığı ana sayfanın kökü sözleşme dışıdır (`size: grow`, S-16). Sayfa henüz boşsa kök
-            // öteki sayfalarla aynı şablonla yeniden yazılır; içerik varsa dokunulmaz.
-            const homeSchema = existing.schema;
-            const blankHome = Array.isArray(homeSchema) && homeSchema.length === 1 && homeSchema[0]?.elementId === PAGE_CONTAINER_ELEMENT_ID && (homeSchema[0].children ?? []).length === 0;
-            await platform.tenant('PUT', project, `/pages/${applicationId}/${homepageId}`, {
-                environment,
-                body: pageUpdateBody(existing, {
-                    name: homePage.pageName,
-                    slug: homePage.pageSlug,
-                    layoutId: layoutId ?? null,
-                    ...(blankHome ? { schema: mobilePageSchema(layoutId !== undefined) } : {})
-                })
-            });
-            pageIds.set(home, homepageId);
-            completed.push({ step: current, id: homepageId });
-            if (tabs) {
-                current = 'application_update';
-                const properties = {
-                    mobile: {
-                        tabs: {
-                            enabled: true,
-                            style: 'default',
-                            showLabels: true,
-                            items: tabs.map(tab => ({ page: pageIds.get(tab.pageSlug), ...(tab.label ? { label: tab.label } : {}), ...(tab.icon ? { icon: tab.icon } : {}) }))
-                        }
-                    }
-                };
-                warnings.push(...await mobileTabsWarnings(platform, applicationId, platform.resolveProject(project), homepageId, properties));
-                await platform.org('PUT', `/applications/${applicationId}`, {
-                    environment,
-                    body: { slug, name, homepageId, ...(color ? { color } : {}), properties }
-                });
-                forgetApplication(platform, applicationId);
-                completed.push({ step: current });
-            }
-        }
-        catch (error) {
-            if (completed.length === 0)
-                throw error;
-            const done = new Set(completed.map(entry => entry.step));
-            return {
-                applicationId,
-                ...(layoutId ? { layoutId } : {}),
-                completed,
-                failed: { step: current, error: error instanceof Error ? error.message : String(error) },
-                remaining: plan.map(step => step.step).filter(step => !done.has(step) && !skipped.has(step) && step !== current),
-                ...(warnings.length > 0 ? { warnings } : {}),
-                note: 'Kurulum yarıda kaldı: completed kurulanları, remaining eksik adımları söyler. Kalanları tekil araçlarla tamamlayın (page_create, page_update, application_update) — mobile_app_create aynı slug ile tekrar çağrılırsa uygulamayı ikinci kez açmaya çalışır.'
-            };
-        }
-        return {
-            applicationId,
-            homepageId,
-            ...(layoutId ? { layoutId } : {}),
-            applicationType: 'mobile',
-            pages: pages.map(page => ({ slug: page.pageSlug, name: page.pageName, id: pageIds.get(page.pageSlug), ...(page.pageSlug === home ? { homepage: true } : {}) })),
-            ...(tabs ? { tabs: tabs.map(tab => tab.pageSlug) } : {}),
-            completed,
-            ...(warnings.length > 0 ? { warnings } : {}),
-            next: "Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). platform_guide('mobile')."
-        };
-    }));
-}