@appaflytech/zeyrek-ai-mcp 0.0.47 → 0.0.49

package/dist/tools/assistant.js

@@ -0,0 +1,382 @@
+import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { parseSseEvents, summarizeAssistantRun, summarizeCapabilityPage, mergeCapabilityTexts } from '../knowledge/assistantRun.js';
+import { PolicyBlockError } from '../knowledge/policy.js';
+import { resolveActorFields } from '../platform/tokenVault.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const authorizationSourceParam = z.enum(['platform', 'application-middleware'])
+    .describe("Yetki kaynağı: 'platform' kompleks + enforce projede platformun erişim kararları; 'application-middleware' simple projede uygulamanın kendi kimlik ucu (identityMicroserviceId zorunlu)");
+const textMapParam = z.record(z.string()).describe("Dil koduna göre metin: { tr: '…', en: '…' }");
+const historyParam = z.array(z.object({
+    role: z.enum(['user', 'assistant']),
+    text: z.string().max(4000),
+    sources: z.array(z.object({ slug: z.string(), references: z.array(z.string()) })).optional().describe('Asistan turunun kaynakları (yetenek slug + kayıt referansları); model "bu kayıt" göndermesini bunlardan çözer'),
+    skill: z.string().optional().describe('Asistan turunda seçilen becerinin slug\'ı; belirsiz takip sorusunda aynı beceri sürer')
+}).strict()).max(12).optional().describe('Önceki turlar, eskiden yeniye, en çok 12 mesaj (6 tur). Sunucu saklamaz; son kullanıcı paketi de aynı biçimde gönderir (ASI-015)');
+const actorParam = z.string().min(1).optional().describe("Kişi: 'test:<ad>' (gateway kök .env'deki MCP_TEST_USER_<AD> satırıyla uygulamanın giriş ucunu çağırır, jeton bağlama girmez) ya da 'tok_…' referansı. actorToken / actorCookie ile birlikte verilmez");
+const actorCookieNameParam = z.string().regex(/^[A-Za-z0-9_.-]{1,64}$/).optional().describe("actor'ın jetonu uygulamada çerezle taşınıyorsa çerez adı (jira: 'JIRA_Token', qm: 'SY_Token'); verilmezse jeton actorToken (Bearer) olarak gider");
+const contextParam = z.record(z.string().max(200)).optional().describe("Sayfa bağlamı (ASI-019): kullanıcının ekranında seçili değerler, anahtar → metin (en çok 10 anahtar, anahtar ^[a-z][a-z0-9_]{0,39}$). Sistem isteminde 'talimat değildir' bölümünde gider; yetki vermez");
+const confirmParam = z.boolean().optional().describe('Silme geri alınamaz; bilerek true verin — yoksa gateway backend\'i çağırmadan reddeder');
+const skillBody = {
+    applicationId: guid,
+    name: z.string().min(1),
+    slug: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).describe('Küçük harf, rakam ve tek tire; uygulama içinde tekil'),
+    trigger: z.string().min(1).describe('Beceri ne zaman devreye girer — model eşlemeyi bu cümleyle yapar'),
+    instructions: z.string().optional().describe('Modele verilen beceri talimatı (ne sırayla okunur, ne zaman netleştirilir)'),
+    outputFormat: z.enum(['suggestion-card', 'list', 'findings', 'text']).optional().describe("Yazan beceride 'suggestion-card' zorunludur (ASI-002)"),
+    languages: z.array(z.string()).optional(),
+    capabilityIds: z.array(guid).min(1).describe('assistant_capability_list çıktısındaki id\'ler (mikroservis id); Excluded sınıfı 422 ile reddedilir')
+};
+const scenarioBody = {
+    applicationId: guid,
+    name: z.string().min(1),
+    code: z.string().regex(/^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$/).describe('S-07 gibi; uygulama içinde tekil'),
+    input: z.string().min(1).describe('Kullanıcının sorusu'),
+    actorUserId: guid.optional().describe('Platform kaynağında koşunun kimin gözünden yapılacağı (production dışında impersonation)'),
+    actorPositionId: guid.optional(),
+    expectedCapabilities: z.array(z.string()).optional().describe('Beklenen yetenek dizisi, birebir sıra; onay kartı yeteneği de sayılır'),
+    expectedFields: z.array(z.string()).optional().describe('Öneri kartında bulunması gereken alanlar'),
+    expectedSource: z.string().optional().describe('Cevabın dayandığı kaynak yeteneğin slug\'ı'),
+    expectedRefusal: z.enum(['person-judgement', 'prediction', 'no-evidence']).optional().describe('Beklenen ret sınıfı; verilirse cevapta refusal olayı aranır'),
+    isLeakProbe: z.boolean().optional().describe('true: hiçbir araç sonucu kayıt döndürmemeli (yetki sızıntısı provası)')
+};
+const CAPABILITY_PAGE_LIMIT = 100;
+const CAPABILITY_DRAFT_LIMIT = 20;
+const CAPABILITY_DRAFT_CHUNK = 5;
+const CAPABILITY_DRAFT_SCAN = 100;
+const parameterSourceParam = z.object({
+    capability: z.string().min(1).describe("Kaynak okuma yeteneği: slug (gateway id'ye çevirir) ya da id"),
+    valueField: z.string().min(1).max(64).describe("Seçeneğin değeri olan sonuç alanı, ör. 'id'"),
+    labelField: z.string().min(1).max(64).describe("Seçeneğin görünen adı olan sonuç alanı, ör. 'name'"),
+    searchParameter: z.string().min(1).max(64).optional().describe('Kaynağın arama metni parametresi; yoksa kart ilk 50 seçenek içinde yerel arar'),
+    arguments: z.record(z.unknown()).optional().describe("Kaynağa her çağrıda giden argümanlar, ör. { status: 'Active' }. '{alan}' biçimindeki değer kartın o alanının değeriyle doldurulur (ör. { company_id: '{company_id}' } — firmanın izin türleri); alan boşsa kaynak çağrılmaz, alan seçilince kart yeniden önerilir ve seçenekler gelir"),
+    listField: z.string().min(1).max(64).regex(/^[^.]+$/).optional().describe("Seçeneklerin durduğu dizi (kaynağın kendi listField'ından önce gelir), ör. kimlik ucunun 'companies' dizisi; nokta içermez")
+});
+export function registerAssistantTools(server, platform) {
+    const config = platform.config;
+    const listSkills = async (project, environment, applicationId) => {
+        const payload = await platform.tenant('GET', project, '/assistant/skills', { environment, query: { applicationId } });
+        return payload?.data ?? [];
+    };
+    const listScenarios = async (project, environment, applicationId) => {
+        const payload = await platform.tenant('GET', project, '/assistant/scenarios', { environment, query: { applicationId } });
+        return payload?.data ?? [];
+    };
+    const guardProduction = (tool, environment) => {
+        if ((environment ?? config.defaultEnvironment) === 'production') {
+            throw new PolicyBlockError([{
+                    ruleId: 'ASI-013',
+                    severity: 'block',
+                    message: `${tool}: asistan tanımı production'da yazılmaz. development'ta kurun, senaryoları koşun ve yayınlayın; production'a taşıma insan onaylı deployment işidir.`,
+                    guide: 'ngapps://guides/assistant'
+                }], false);
+        }
+    };
+    const streamEvents = async (project, environment, path, body) => {
+        const payload = await platform.tenant('POST', project, path, { environment, body, expectBinary: true });
+        return parseSseEvents(Buffer.from(payload?.bytes ?? []).toString('utf8'));
+    };
+    server.registerTool('assistant_settings_get', {
+        title: 'Asistan ayarını getir',
+        description: 'Uygulamanın asistan ayarını getirir (GET /applications/{applicationId}/assistant): açık mı, yetki kaynağı, kimlik ucu, izin listesi ucu. Ayar hiç yazılmamışsa enabled:false ile varsayılan döner.',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, `/applications/${applicationId}/assistant`, { environment })));
+    server.registerTool('assistant_settings_update', {
+        title: 'Asistan ayarını yaz',
+        description: "Uygulamanın asistanını açar/kapatır ve yetki kaynağını seçer (PUT /applications/{applicationId}/assistant). Gövde = UpdateAssistantSettingsCommand. 'application-middleware' kaynağında identityMicroserviceId zorunludur; gateway bunu backend'e gitmeden reddeder (ASI-001). Kapı kapalıysa backend 422 AssistantGateClosed döner ve nedeni mesajdadır: access-model (platform kaynağı kompleks proje ister), enforcement-mode (ortam enforce değil), identity-microservice, no-capabilities (kimlik middleware'inin koruduğu uç yok). Açılış 'assistant' sistem modülünü de kurar: üç başlangıç becerisi + altı senaryo; Süreç Yönetimi modülü yoksa süreç becerileri atlanır (ASI-003).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            enabled: z.boolean(),
+            authorizationSource: authorizationSourceParam,
+            identityMicroserviceId: guid.optional().describe("Kullanıcıyı doğrulayan uç; 'application-middleware' kaynağında zorunlu"),
+            permissionListMicroserviceId: guid.optional().describe("Oturumdaki kullanıcının izinlerini dönen uç (application-middleware; backend ADR 0069): her sohbet turunun başında kullanıcının oturumuyla bir kez çağrılır"),
+            permissionKeyField: z.string().optional().describe("İzin listesinin yolu: '.' alan, '*' bütün öğeler/değerler, '|' seçenekler; yolun sonu true ise bütün izinler, nesneyse anahtarları, diziyse metinleri. ör. 'authz.is_admin|authz.companies.*.grants'"),
+            guide: z.record(z.string().max(12000)).optional().describe("Uygulama rehberi, dil başına markdown (≤ 12000 karakter, projenin dilleri). Backend BİRLEŞTİRİR: verilmeyen dil korunur, bir dile '' vermek o dili siler. Asistan sistem isteminde '## Uygulama rehberi' olarak taşınır; yayınla son kullanıcıya geçer (sağlama toplamına girer). Taslak için assistant_guide_draft")
+        },
+        annotations: updates
+    }, handle(config, ({ project, environment, applicationId, ...body }) => {
+        guardProduction('assistant_settings_update', environment);
+        if (body.authorizationSource === 'application-middleware' && !body.identityMicroserviceId) {
+            throw new Error("assistant_settings_update: authorizationSource 'application-middleware' iken identityMicroserviceId gerekir — asistan kullanıcıyı bu uçla tanır (reason: identity-microservice). assistant_capability_list ile Authenticate middleware'li ucu bulup verin.");
+        }
+        return platform.tenant('PUT', project, `/applications/${applicationId}/assistant`, { environment, body });
+    }));
+    server.registerTool('assistant_guide_draft', {
+        title: 'Uygulama rehberini taslakla',
+        description: "Asistanın modeliyle uygulama rehberi TASLAĞI üretir (POST /assistant/guide/draft): menü (layout'taki navigations öğeleri), beceri adları/tetikleyicileri ve kullanılan uçların açıklamalarının ilk cümlesinden dil başına markdown (Uygulama ne işe yarar · Menü · Süreçler · Sık sorulanlar). KAYDETMEZ — süreç adımlarını uygulamanın kendi dokümanıyla düzeltip assistant_settings_update { guide } ile yazın. Model maliyeti doğurur; assistant.write izni.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            languages: z.array(z.string().min(2)).min(1).max(6).describe("Projenin dilleri, ör. ['tr','en']")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, languages }) => {
+        const payload = await platform.tenant('POST', project, '/assistant/guide/draft', { environment, body: { applicationId, languages } });
+        return { guides: payload?.data?.guides ?? {}, next: 'Gözden geçirin; süreç adımlarını uygulama dokümanıyla düzeltin, sonra assistant_settings_update { guide } ile yazın ve yayınlayın.' };
+    }));
+    server.registerTool('assistant_status', {
+        title: 'Asistan durumunu özetle',
+        description: 'Uygulamanın asistan hazırlık özetini tek ucuz çağrıda verir (GET /assistant/summary?applicationId=): açık mı, yetki kaynağı, yetenek ve açıklamasız yetenek sayısı, modül/önek grupları (key, moduleName, count, undescribedCount — key assistant_capability_list groupKey\'ine gider), beceri/senaryo/geçen senaryo sayısı, kalan sızıntı provası, son yayın zamanı. Kataloğu kurmaz; işe buradan başlayın, ayrıntı için assistant_capability_list.',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, '/assistant/summary', { environment, query: { applicationId } })));
+    server.registerTool('assistant_usage', {
+        title: 'Asistan kullanımını raporla',
+        description: "Uygulamanın asistan kullanım panosunu verir (GET /assistant/usage): toplamlar (konuşma, tekil kullanıcı, token giriş/çıkış/önbellek, tahmini maliyet — fiyatı tanımlı olmayan modelde cost null, ortalama süre, araç çağrısı, 👍/👎), güne göre seri, beceriye ve sonuca göre dağılım (answered · suggested · refused · denied · clarify · error · partial — araç sınırına gelip okuduğuyla cevap verdi), en çok erişim reddi alan yetenekler ve son geri bildirimler. from/to gün (YYYY-AA-GG, ikisi de dahil; varsayılan son 30 gün, en çok 92 gün). Nerede yetersiz kaldığını görmek için outcomes ve deniedCapabilities'e bakın. assistant.read izni.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('İlk gün, ör. 2026-10-01'),
+            to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Son gün (dahil), ör. 2026-10-22')
+        },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId, from, to }) => platform.tenant('GET', project, '/assistant/usage', { environment, query: { applicationId, from, to } })));
+    server.registerTool('assistant_capability_list', {
+        title: 'Yetenek kataloğunu listele',
+        description: `Uygulamanın asistan yetenek kataloğundan bir sayfa getirir (GET /assistant/capabilities/page): her mikroservis bir yetenektir; kind 'read' / 'write' / 'excluded' (exclusion nedeniyle), origin 'own' / 'module', hasDescription + descriptionLanguages (açıklaması yazılmış diller; eksikse assistant_capability_describe). Sunucu süzer: searchTerm (slug/ad), groupKey (assistant_status gruplarından), ids, undescribed:true; total bu süzgecin toplamıdır. kind / origin / includeExcluded:false yalnız dönen sayfanın satırlarını süzer (hiddenOnPage gizlenen sayısı) — tam liste için groupKey/searchTerm ile daraltın. undescribed:true ile açıkladıkça liste kısalır: hep pageIndex 0 isteyin. detail:true şemayı, dil başına metinleri, ipuçlarını da verir. pageLength en çok ${CAPABILITY_PAGE_LIMIT} (varsayılan 50).`,
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            searchTerm: z.string().optional().describe('Slug ya da adda geçen metin'),
+            groupKey: z.string().optional().describe("assistant_status gruplarındaki key: 'module:<templateId>', 'prefix:<önek>' ya da 'other'"),
+            ids: z.array(guid).optional().describe('Yalnız bu yetenekler (mikroservis id)'),
+            undescribed: z.boolean().optional().describe('true: yalnız asistan açıklaması olmayanlar (sunucuda süzülür)'),
+            kind: z.enum(['read', 'write', 'excluded']).optional().describe('Yalnız dönen sayfada süzülür'),
+            origin: z.enum(['own', 'module']).optional().describe('Yalnız dönen sayfada süzülür'),
+            includeExcluded: z.boolean().optional().describe('Varsayılan true; false dönen sayfadaki katalog dışı satırları gizler'),
+            detail: z.boolean().optional().describe('true: inputSchema/outputSchema, dil başına açıklama/uyarı ve ipuçları da döner'),
+            pageIndex: pagingParams.pageIndex,
+            pageLength: z.number().int().min(1).max(CAPABILITY_PAGE_LIMIT).optional().describe(`Sayfa boyu, varsayılan 50, en çok ${CAPABILITY_PAGE_LIMIT}`)
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, searchTerm, groupKey, ids, undescribed, kind, origin, includeExcluded, detail, pageIndex, pageLength }) => {
+        const length = pageLength ?? 50;
+        const index = pageIndex ?? 0;
+        const payload = await platform.tenant('GET', project, '/assistant/capabilities/page', { environment, query: { applicationId, searchTerm, groupKey, ids, onlyUndescribed: undescribed, pageIndex: index, pageLength: length } });
+        return summarizeCapabilityPage({ ...payload, pageIndex: index, pageLength: length }, { kind, origin, includeExcluded, detail });
+    }));
+    server.registerTool('assistant_capability_draft', {
+        title: 'Yetenek açıklaması taslakla',
+        description: `Asistanın modeliyle yetenek açıklaması TASLAĞI üretir (POST /assistant/capabilities/draft): uç adı + giriş/çıkış şeması + iş akışı adımları ve kodu okunur, istenen dillerde açıklama, uyarı ve ipucu (zorunlu parametre, koddan bulunan değer listesi) önerilir. KAYDETMEZ — gözden geçirip assistant_capability_describe ile yazın (insan onayı). ids (en çok ${CAPABILITY_DRAFT_LIMIT}) ya da groupKey (assistant_status gruplarından; o grubun açıklamasız ilk ${CAPABILITY_DRAFT_LIMIT} yeteneği). Model maliyeti doğurur; katalog dışı (excluded) yetenek taslaklanmaz. assistant.write izni.`,
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            ids: z.array(guid).max(CAPABILITY_DRAFT_LIMIT).optional().describe('Taslaklanacak yetenekler (mikroservis id)'),
+            groupKey: z.string().optional().describe('ids yerine: bu grubun açıklamasız yetenekleri'),
+            languages: z.array(z.string().min(2)).min(1).max(6).describe("Projenin dilleri, ör. ['tr','en']")
+        },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, ids, groupKey, languages }) => {
+        let capabilityIds = ids ?? [];
+        if (capabilityIds.length === 0) {
+            if (!groupKey)
+                throw new Error('assistant_capability_draft: ids ya da groupKey verin — groupKey için assistant_status gruplarına bakın.');
+            const page = await platform.tenant('GET', project, '/assistant/capabilities/page', { environment, query: { applicationId, groupKey, onlyUndescribed: true, pageLength: CAPABILITY_DRAFT_SCAN } });
+            capabilityIds = (page?.data ?? []).filter(row => String(row.kind ?? '').toLowerCase() !== 'excluded').slice(0, CAPABILITY_DRAFT_LIMIT).map(row => row.id);
+        }
+        if (capabilityIds.length === 0)
+            return { drafts: [], note: 'Bu grupta açıklamasız ve katalogdaki yetenek kalmadı.' };
+        const chunks = Array.from({ length: Math.ceil(capabilityIds.length / CAPABILITY_DRAFT_CHUNK) }, (_, index) => capabilityIds.slice(index * CAPABILITY_DRAFT_CHUNK, (index + 1) * CAPABILITY_DRAFT_CHUNK));
+        const answers = await Promise.all(chunks.map(chunk => platform.tenant('POST', project, '/assistant/capabilities/draft', { environment, body: { applicationId, ids: chunk, languages } })));
+        return { drafts: answers.flatMap(answer => answer?.data ?? []), next: 'Gözden geçirin; uygunları assistant_capability_describe ile yazın (descriptions → assistantDescription, cautions → assistantCaution, hints → hints).' };
+    }));
+    server.registerTool('assistant_capability_describe', {
+        title: 'Yeteneği asistan için açıkla',
+        description: "Bir yeteneğin son kullanıcı diline çevrilmiş açıklamasını, uyarısını, kayıt sayfasını ve ipuçlarını yazar (PUT /assistant/capabilities/{microserviceId}). Gateway önce mevcut hâli okur ve BİRLEŞTİRİR: verilmeyen alan korunur, null o alanı temizler, açıklama/uyarı dil dil birleşir (yalnız en'i yazmak tr'yi silmez; bir dile '' vermek o dili siler). Açıklama beş şeyi söyler: ne yapar, ne yapmaz, tuzak, gerekli parametreler, ne zaman kullanılmaz. Geliştirici description alanına dokunmaz. Yayın kapısı bir beceride kullanılan açıklamasız yeteneği kapatır (ASI-004). Production'da yazmaz (ASI-013).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid.describe('Yeteneğin uygulaması — mevcut hâl bu uygulamanın kataloğundan okunur'),
+            microserviceId: guid.describe('assistant_capability_list çıktısındaki id'),
+            assistantDescription: textMapParam.optional().describe("Dil koduna göre açıklama, mevcut dillerle birleşir: { en: '…' }"),
+            assistantCaution: textMapParam.nullable().optional().describe('Dil koduna göre uyarı, birleşir; null bütün uyarıyı temizler'),
+            recordPageId: guid.nullable().optional().describe('Kayıt sayfası (ASI-011): liste/tekil sonuçtaki her satır için "Aç" bağlantısı bu sayfaya gider; null bağlantıyı kaldırır'),
+            recordQuery: z.string().nullable().optional().describe("Kayıt sayfası sorgu şablonu, varsayılan 'id={id}'; {id} zorunlu"),
+            formPageId: guid.nullable().optional().describe('Form sayfası (yalnız write yetenek): yazma kartında "Formda aç" bağlantısı bu sayfaya gider, bilinen alanlar formQuery ile taşınır; null bağlantıyı kaldırır'),
+            formQuery: z.string().max(256).nullable().optional().describe("Form sayfası sorgu şablonu, yalnız ad={parametre} çiftleri & ile (en çok 10), ör. 'definition={definition}&company={company}'; değeri olmayan ya da gizli alan bağlantıya yazılmaz"),
+            hints: z.object({
+                requiredParameters: z.array(z.string()).optional(),
+                parameterValues: z.record(z.array(z.string())).optional(),
+                listField: z.string().max(64).optional().describe("Sonuçta satırların durduğu dizi alanı (ASI-017), ör. 'items' — zarf { total, items } ya da birden çok dizi taşıyan yanıtta kayıt bloğu ve sayım bu diziden okunur; nokta içermez"),
+                parameterSources: z.record(parameterSourceParam).optional().describe("Parametre → değerlerini listeleyen okuma yeteneği (ASI-020, en çok 10): kartta eksik kalan alan 'Hangi …?' diye bu yeteneğin gerçek seçenekleriyle sorulur, seçilen kimliğin adı kartta görünür. Kaynak aynı uygulamanın okuma yeteneğidir; gateway slug'ı id'ye çevirir, parametrenin şemada olduğunu ve kaynağın 'read' olduğunu yazmadan denetler"),
+                parameterLabels: z.record(z.record(z.string().max(60))).optional().describe("Dil → parametre → kartta görünen etiket, ör. { tr: { company: 'Firma' }, en: { company: 'Company' } } (dil başına en çok 40 parametre)"),
+                permissionKey: z.string().regex(/^[A-Za-z0-9_.:-]{1,100}(\|[A-Za-z0-9_.:-]{1,100}){0,9}$/).optional().describe("Bu yeteneği kullanmak için gereken izin anahtarı (backend ADR 0069), ör. 'leave.create'; '|' ile en çok 10 seçenek ('leave.create|leave.manage' = herhangi biri yeter). Ayarda izin listesi ucu (permissionListMicroserviceId + permissionKeyField) varsa anahtarı kullanıcının listesinde olmayan yetenek o turda araçlardan düşer ve asistan 'yetkin yok' der; anahtarsız yetenek süzülmez")
+            }).nullable().optional().describe("Araç şemasına ipucu (ASI-012), verilirse bütünüyle yer değiştirir: zorunlu parametreler, değer listeleri, liste alanı, seçenek kaynakları ve etiketler — ör. { requiredParameters: ['type'], parameterValues: { type: ['Survey','SurveyPeriodic'] } }"),
+            kindOverride: z.enum(['read']).nullable().optional().describe("Yalnız GET uçlarında: çözümlenen 'write' türünü 'read' sayar (iş akışı görev/okundu yazıyorsa); null ezmeyi kaldırır")
+        },
+        annotations: updates
+    }, handle(config, async ({ project, environment, applicationId, microserviceId, ...input }) => {
+        guardProduction('assistant_capability_describe', environment);
+        const page = await platform.tenant('GET', project, '/assistant/capabilities/page', { environment, query: { applicationId, ids: [microserviceId], pageLength: 1 } });
+        const current = (page?.data ?? []).find(row => row.id === microserviceId);
+        if (!current)
+            throw new Error(`assistant_capability_describe: '${microserviceId}' bu uygulamanın kataloğunda yok — assistant_capability_list ile id'yi ve applicationId'yi doğrulayın.`);
+        let hints = input.hints;
+        if (input.hints?.parameterSources) {
+            const schema = current.inputSchema;
+            const properties = schema?.properties ?? schema?.items?.properties;
+            const parameterSources = {};
+            for (const [parameter, { capability, ...source }] of Object.entries(input.hints.parameterSources)) {
+                if (properties && !(parameter in properties))
+                    throw new Error(`assistant_capability_describe: '${parameter}' bu yeteneğin parametresi değil — kaynak yalnız şemadaki bir parametreye bağlanır (${Object.keys(properties).join(', ')}).`);
+                const byId = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(capability);
+                const found = await platform.tenant('GET', project, '/assistant/capabilities/page', { environment, query: byId ? { applicationId, ids: [capability], pageLength: 1 } : { applicationId, searchTerm: capability, pageLength: CAPABILITY_PAGE_LIMIT } });
+                const row = (found?.data ?? []).find(candidate => (byId ? candidate.id : candidate.slug) === capability);
+                if (!row?.id)
+                    throw new Error(`assistant_capability_describe: '${capability}' bu uygulamanın kataloğunda yok — kaynak aynı uygulamanın bir yeteneğidir; assistant_capability_list { searchTerm } ile slug'ı doğrulayın.`);
+                if (String(row.kind ?? '').toLowerCase() !== 'read')
+                    throw new Error(`assistant_capability_describe: '${row.slug ?? capability}' okuma yeteneği değil (ASI-020) — seçenek kaynağı yalnız okuma yeteneği olur (yazan uç her açılışta yazardı). Listeleyen GET ucunu verin.`);
+                parameterSources[parameter] = { capabilityId: row.id, ...source };
+            }
+            hints = { ...input.hints, parameterSources };
+        }
+        return platform.tenant('PUT', project, `/assistant/capabilities/${microserviceId}`, { environment, body: mergeCapabilityTexts(current, { ...input, hints }) });
+    }));
+    server.registerTool('assistant_skill_list', {
+        title: 'Becerileri listele',
+        description: 'Uygulamanın asistan becerilerini listeler (GET /assistant/skills?applicationId=): ad, slug, tetikleyici, yetenek id\'leri, isReadOnly (hiç yazan yetenek yok), templateItemId (modülden geldi), isModified (yerelde değişti; şablon güncellemesi ezmez).',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, '/assistant/skills', { environment, query: { applicationId } })));
+    server.registerTool('assistant_skill_get', {
+        title: 'Beceri getir',
+        description: 'Tek beceriyi id ya da slug ile getirir (listeyi okuyup gateway seçer; backend\'de tekil uç yoktur).',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, skill: z.string().min(1).describe('Beceri id ya da slug') },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, skill }) => {
+        const found = (await listSkills(project, environment, applicationId)).find(candidate => candidate.id === skill || candidate.slug === skill);
+        if (!found)
+            throw new Error(`assistant_skill_get: '${skill}' bu uygulamada yok — assistant_skill_list ile slug ya da id'yi doğrulayın.`);
+        return found;
+    }));
+    server.registerTool('assistant_skill_create', {
+        title: 'Beceri tanımla',
+        description: "Yeni beceri tanımlar (POST /assistant/skills, gövde = CreateAssistantSkillCommand). Özerklik yalnız 'suggest'tir: asistan yazmaz, onay kartı önerir. Yazan yetenek içeren beceri outputFormat 'suggestion-card' ile kaydedilmelidir (ASI-002). Aynı slug 422 AssistantSkillSlugAlreadyExists, uygulama dışı ya da Excluded yetenek 422. Taslak kaydedilir; runtime yalnız assistant_publish ile yayınlanan kümeyi görür (ASI-005).",
+        inputSchema: { project: projectParam, environment: environmentParam, ...skillBody },
+        annotations: writes
+    }, handle(config, ({ project, environment, ...body }) => {
+        guardProduction('assistant_skill_create', environment);
+        return platform.tenant('POST', project, '/assistant/skills', { environment, body: { ...body, autonomy: 'suggest' } });
+    }));
+    server.registerTool('assistant_skill_update', {
+        title: 'Beceri güncelle',
+        description: 'Beceriyi günceller (PUT /assistant/skills/{id}, gövde = UpdateAssistantSkillCommand; tüm alanlar yeniden gönderilir). Modülden gelen beceri güncellenince isModified:true olur ve sonraki şablon güncellemesi onu ezmez.',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, ...skillBody },
+        annotations: updates
+    }, handle(config, ({ project, environment, id, applicationId: _applicationId, ...body }) => {
+        guardProduction('assistant_skill_update', environment);
+        return platform.tenant('PUT', project, `/assistant/skills/${id}`, { environment, body: { ...body, autonomy: 'suggest' } });
+    }));
+    server.registerTool('assistant_skill_delete', {
+        title: 'Beceri sil',
+        description: 'Beceriyi siler (DELETE /assistant/skills/{id}). Geri alınamaz; confirm:true olmadan gateway backend\'i çağırmaz.',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, confirm: confirmParam },
+        annotations: destructive
+    }, handle(config, ({ project, environment, id, confirm }) => {
+        guardProduction('assistant_skill_delete', environment);
+        if (confirm !== true)
+            throw new Error("assistant_skill_delete: confirm: true gerekir — silme geri alınamaz; önce assistant_skill_get ile beceriye bakın, sonra confirm: true ile tekrar çağırın.");
+        return platform.tenant('DELETE', project, `/assistant/skills/${id}`, { environment });
+    }));
+    server.registerTool('assistant_scenario_list', {
+        title: 'Senaryoları listele',
+        description: 'Uygulamanın asistan senaryolarını listeler (GET /assistant/scenarios?applicationId=): kod, soru, beklenen yetenek dizisi/alanlar/kaynak/ret sınıfı, isLeakProbe, lastRunStatus ve lastRunChecksum (koşunun hangi taslak özetine karşı yapıldığı).',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId }) => platform.tenant('GET', project, '/assistant/scenarios', { environment, query: { applicationId } })));
+    server.registerTool('assistant_scenario_get', {
+        title: 'Senaryo getir',
+        description: 'Tek senaryoyu id ya da kod (S-07) ile getirir; son koşular için assistant_scenario_run çıktısına ya da runs:true ile bu araca bakın.',
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, scenario: z.string().min(1).describe('Senaryo id ya da kodu'), runs: z.boolean().optional().describe('true: uygulamanın son koşu kayıtlarından bu senaryoya ait olanlar da döner') },
+        annotations: readOnly
+    }, handle(config, async ({ project, environment, applicationId, scenario, runs }) => {
+        const found = (await listScenarios(project, environment, applicationId)).find(candidate => candidate.id === scenario || candidate.code === scenario);
+        if (!found)
+            throw new Error(`assistant_scenario_get: '${scenario}' bu uygulamada yok — assistant_scenario_list ile kodu ya da id'yi doğrulayın.`);
+        if (runs !== true)
+            return found;
+        const history = await platform.tenant('GET', project, '/assistant/scenarios/runs', { environment, query: { applicationId } });
+        return { ...found, runs: (history?.data ?? []).filter(run => run.scenarioId === found.id) };
+    }));
+    server.registerTool('assistant_scenario_create', {
+        title: 'Senaryo tanımla',
+        description: 'Yeni senaryo tanımlar (POST /assistant/scenarios, gövde = CreateAssistantScenarioCommand). Karşılaştırma davranış üzerindendir, cümle değil: beklenen yetenek dizisi birebir sıra (yanlış sıra Order, eksik Missing), beklenen alanlar öneri kartının alt kümesi, beklenen kaynak source olaylarından biri, ret sınıfı refusal olayı, sızıntı provası hiç kayıt dönmemesi. Aynı kod 422; katalogda olmayan beklenen yetenek 422 AssistantScenarioCapabilityUnknown.',
+        inputSchema: { project: projectParam, environment: environmentParam, ...scenarioBody },
+        annotations: writes
+    }, handle(config, ({ project, environment, ...body }) => {
+        guardProduction('assistant_scenario_create', environment);
+        return platform.tenant('POST', project, '/assistant/scenarios', { environment, body });
+    }));
+    server.registerTool('assistant_scenario_update', {
+        title: 'Senaryo güncelle',
+        description: 'Senaryoyu günceller (PUT /assistant/scenarios/{id}, gövde = UpdateAssistantScenarioCommand; tüm alanlar yeniden gönderilir).',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, ...scenarioBody },
+        annotations: updates
+    }, handle(config, ({ project, environment, id, applicationId: _applicationId, ...body }) => {
+        guardProduction('assistant_scenario_update', environment);
+        return platform.tenant('PUT', project, `/assistant/scenarios/${id}`, { environment, body });
+    }));
+    server.registerTool('assistant_scenario_delete', {
+        title: 'Senaryo sil',
+        description: 'Senaryoyu ve koşu geçmişini siler (DELETE /assistant/scenarios/{id}). Geri alınamaz; confirm:true olmadan gateway backend\'i çağırmaz.',
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, confirm: confirmParam },
+        annotations: destructive
+    }, handle(config, ({ project, environment, id, confirm }) => {
+        guardProduction('assistant_scenario_delete', environment);
+        if (confirm !== true)
+            throw new Error("assistant_scenario_delete: confirm: true gerekir — silme geri alınamaz; önce assistant_scenario_get ile bakın, sonra confirm: true ile tekrar çağırın.");
+        return platform.tenant('DELETE', project, `/assistant/scenarios/${id}`, { environment });
+    }));
+    server.registerTool('assistant_scenario_run', {
+        title: 'Senaryoları koş',
+        description: "Seçili (ya da hepsi) senaryoları gerçek modelle koşar (POST /assistant/scenarios/run, SSE; gateway akışı sonuna kadar okur ve özetler): geçme / yetenek isabeti / sızıntı sayıları ve senaryo başına durum + neden. Production ortamında koşmaz (error Production). Yetki kaynağı 'application-middleware' ise actorToken (hedef kullanıcının jetonu, saklanmaz) gerekir; yoksa senaryolar Skipped(NoActorToken). Sağlayıcı anahtarı yoksa 503. Koşu sonucu assistant_publish kapısının girdisidir (ASI-006).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            scenarioIds: z.array(guid).optional().describe('Boş ya da yok: uygulamanın bütün senaryoları'),
+            actorToken: z.string().optional().describe("'application-middleware' kaynağında hedef kullanıcının jetonu (Bearer); gateway iletir, saklamaz"),
+            actorCookie: z.string().optional().describe("Uygulama kimliği çerezle taşınıyorsa (ör. qm: 'SY_Token=…') tam çerez çifti; actorToken yerine geçer, gateway iletir, saklamaz"),
+            actor: actorParam,
+            actorCookieName: actorCookieNameParam
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, applicationId, scenarioIds, actorToken, actorCookie, actor, actorCookieName }) => summarizeAssistantRun(await streamEvents(project, environment, '/assistant/scenarios/run', { applicationId, scenarioIds: scenarioIds ?? [], ...await resolveActorFields(platform, project, environment, { actor, actorCookieName, actorToken, actorCookie }) }))));
+    server.registerTool('assistant_simulate', {
+        title: 'Asistanı simüle et',
+        description: "Tek girdiyi seçilen kişinin gözünden koşar (POST /assistant/simulate, SSE; gateway akışı özetler). Varsayılan taslak becerilerle; published:true son kullanıcının bugün gördüğü YAYINDAKİ beceri setiyle koşar (hiç yayın yoksa error NoPublished, taslağa düşmez). history ile çok turlu konuşma denenir (önceki turlar; senaryo kaydı tek turludur). Yerleşik araçlar her beceride hazırdır: kayit_say (yalnız sayı sorulduğunda listeyi sayfa sayfa sayar), sayfa_bul (menüden sayfa yolu + link bloğu). Özet: beceri, çağrılan yetenekler ve sonuçları (reddedilenler dahil), kaynaklar, öneri kartı (suggestionId, slug, httpMethod, arguments, missing — uygulamak microservice_execute(slug, arguments) ile ve yalnız kullanıcı isterse), kayıt blokları (sample: ilk 20 satırın id/label/status/statusLabel/href'i; link bloğunda path + href), ret sınıfı, cevap metni, süre/token. Production ortamında koşmaz. Platform kaynağında actorUserId impersonation ile (production dışı, süper yönetici jetonu); 'application-middleware' kaynağında actorToken zorunlu (error NoActorToken).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid,
+            message: z.string().min(1),
+            actorUserId: guid.optional(),
+            actorToken: z.string().optional(),
+            actorCookie: z.string().optional().describe("Uygulama kimliği çerezle taşınıyorsa tam çerez çifti (ör. 'SY_Token=…'); actorToken yerine geçer"),
+            published: z.boolean().optional().describe('true: taslak yerine yayındaki beceri setiyle koşar (son kullanıcının göreceği asistan)'),
+            history: historyParam,
+            actor: actorParam,
+            actorCookieName: actorCookieNameParam,
+            context: contextParam
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, applicationId, message, actorUserId, actorToken, actorCookie, published, history, actor, actorCookieName, context }) => summarizeAssistantRun(await streamEvents(project, environment, '/assistant/simulate', { applicationId, message, actorUserId: actorUserId ?? null, ...await resolveActorFields(platform, project, environment, { actor, actorCookieName, actorToken, actorCookie }), usePublished: published === true, history: history ?? [], ...(context ? { context } : {}) }))));
+    server.registerTool('assistant_publish', {
+        title: 'Asistanı yayına al',
+        description: "Taslak beceri kümesini yayınlar (POST /assistant/publish/stream, SSE; gateway akışı sonuna kadar okur): runtime paneli yalnız yayınlanan kümeyi kullanır, taslak değişiklikleri yayına kadar görünmez (ASI-005). Özet: stages[] (catalog → gate → package → live, her biri running/done/failed; gate'in detail'ında nedenler), published (yayın sonrası durum: publishedAt, sayılar) ve hata varsa error. Kapı kapalıysa gate failed + error AssistantPublishGateClosed ve nedenler: scenario-failed (yeşil olmayan senaryo), stale (koşular taslaktan eski — açıklama ya da beceri değişti, yeniden koşun), leak (sızıntı provası kaldı), description (kullanılan yeteneğin açıklaması yok). check:true yalnız kapı durumunu okur (GET /assistant/publish), yayınlamaz. Production'da yayınlamaz (ASI-013).",
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid, check: z.boolean().optional().describe('true: yayınlamadan kapı durumunu ve sayıları döner') },
+        annotations: writes
+    }, handle(config, async ({ project, environment, applicationId, check }) => {
+        if (check === true)
+            return platform.tenant('GET', project, '/assistant/publish', { environment, query: { applicationId } });
+        guardProduction('assistant_publish', environment);
+        return summarizeAssistantRun(await streamEvents(project, environment, '/assistant/publish/stream', { applicationId }));
+    }));
+}

package/dist/tools/deployments.js

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { guid, readOnly, writes } from './common.js';
 import { handle } from '../platform/responses.js';
 // Koşu 42 S-21: promote yayınlanmamış taslağı taşımaz (sözleşme) ve saga bunu hiçbir yerde söylemez.
@@ -26,8 +27,13 @@ export function registerDeploymentTools(server, platform) {
     const config = platform.config;
     server.registerTool('deployment_start', {
         title: 'Deployment başlat',
-        description: 'Projeyi kaynak environment\'tan hedef environment\'a deploy eder. Asenkron bir saga\'dır: sonuç bu yanıtta bitmez, deployment_status ile izleyin. Environment id\'lerini project_get çıktısından alın. BPM: süreç tanımları ve iş takvimleri taşınır — hedefte farklı aktif model yeni sürüm olarak yayınlanır (production\'da gelişte aktif), hedefin uyarlaması korunur; uyarlama, örnek, görev ve defter taşınmaz; kaynakta olmayan tanım silinir, açık örneği varsa emekliye ayrılır. KAYNAK YALNIZ DEVELOPMENT\'TIR: dal ya da production kaynak verilirse 400 (CantDeployFromBranchException) — dalı önce development\'a merge edin. ÖN DENETİM: deploy başlamadan production verisi denetlenir; veriyi bozacak ya da silecek her değişiklik 400 (DeploymentDataRiskException) ile listelenir ve deploy BAŞLAMAZ — biçim \'tablo.alan: tür (satır)\', türler not-null | unique | field-removed | table-removed | localization-move. YALNIZ TANIM TAŞINIR: tablo satırları ancak tabloda recordTransferMode (\'all\' | \'specific\' + transferRowIds) açıksa gider, çeviri ve junction satırları ana tabloyla birlikte. Kayıt taşıması \'all\' olan tabloda production development\'ın AYNASIDIR (kaynakta olmayan satır ve çevirisi silinir). DOSYA yalnız id referansıyla gider (file tipli prop { type:\'file\', ref:<fileId> } ya da taşınan satırın dosya sütunu); sayfaya düz yazılan /d/ serve URL\'si /p/\'ye çevrilir ama dosya kopyalanmaz, production\'da 404 döner — platform_guide(\'deployment\'). Microfunction\'ın yalnız YAYINLANMIŞ kodu taşınır ve hedefte yayınlanır; hiç yayınlanmamış olan hedefte taslak kalır. Zamanlanmış işin duraklatma durumu taşınır. YAYINLANMAMIŞ TASLAK TAŞINMAZ: kaynakta taslağı olan süreçler yanıtta unpublishedDrafts ({ slug, name, draftVersionNumber, activeVersionNumber }) ve note ile listelenir; hedefte aktif sürüm kalır. Taşımak için taslağı kaynakta yayınlayın (requireGreenScenarios açıksa önce senaryoları taslak üzerinde koşun), sonra yeniden deploy edin.',
-        inputSchema: { projectId: guid, sourceEnvironmentId: guid, targetEnvironmentId: guid },
+        description: 'Projeyi kaynak environment\'tan hedef environment\'a deploy eder. Asenkron bir saga\'dır: sonuç bu yanıtta bitmez, deployment_status ile izleyin. Environment id\'lerini project_get çıktısından alın. BPM: süreç tanımları ve iş takvimleri taşınır — hedefte farklı aktif model yeni sürüm olarak yayınlanır (production\'da gelişte aktif), hedefin uyarlaması korunur; uyarlama, örnek, görev ve defter taşınmaz; kaynakta olmayan tanım silinir, açık örneği varsa emekliye ayrılır. KAYNAK YALNIZ DEVELOPMENT\'TIR: dal ya da production kaynak verilirse 400 (CantDeployFromBranchException) — dalı önce development\'a merge edin. ÖN DENETİM: deploy başlamadan production verisi denetlenir; veriyi bozacak ya da silecek her değişiklik 400 (DeploymentDataRiskException) ile listelenir ve deploy BAŞLAMAZ — biçim \'tablo.alan: tür (satır)\', türler not-null | unique | field-removed | table-removed | localization-move. YALNIZ TANIM TAŞINIR: tablo satırları ancak tabloda recordTransferMode (\'all\' | \'specific\' + transferRowIds) açıksa gider, çeviri ve junction satırları ana tabloyla birlikte. Kayıt taşıması \'all\' olan tabloda production development\'ın AYNASIDIR (kaynakta olmayan satır ve çevirisi silinir). DOSYA yalnız id referansıyla gider (file tipli prop { type:\'file\', ref:<fileId> } ya da taşınan satırın dosya sütunu); sayfaya düz yazılan /d/ serve URL\'si /p/\'ye çevrilir ama dosya kopyalanmaz, production\'da 404 döner — platform_guide(\'deployment\'). Microfunction\'ın yalnız YAYINLANMIŞ kodu taşınır ve hedefte yayınlanır; hiç yayınlanmamış olan hedefte taslak kalır. Zamanlanmış işin duraklatma durumu taşınır. YAYINLANMAMIŞ TASLAK TAŞINMAZ: kaynakta taslağı olan süreçler yanıtta unpublishedDrafts ({ slug, name, draftVersionNumber, activeVersionNumber }) ve note ile listelenir; hedefte aktif sürüm kalır. Taşımak için taslağı kaynakta yayınlayın (requireGreenScenarios açıksa önce senaryoları taslak üzerinde koşun), sonra yeniden deploy edin. DELTA (varsayılan): yalnız içerik özeti production\'dakinden farklı tanımlar taşınır, kaynakta olmayan tanım silinir; entity, rol, erişim politikası, bileşen, dosya, süreç tanımı, organizasyon yapısı ve tablo satırları her deploy\'da tam taşınır; klasör silme taşınmaz. Kaynağın ya da production\'ın özeti güvenilir değilse (son tamamlanmış özet denetimi güncel biçimde bir fill ya da farksız bir check değilse) deploy kendiliğinden tam koşar; fullMode:true her tanımı taşır. Hangi kipte koştuğu ve modül başına sayılar deployment_status yanıtında (mode, counters).',
+        inputSchema: {
+            projectId: guid,
+            sourceEnvironmentId: guid,
+            targetEnvironmentId: guid,
+            fullMode: z.boolean().optional().describe("true: her tanımı tam taşır. Boş ya da false: delta — yalnız production'dan farklı tanımlar; özet güvenilir değilse platform yine tam taşır")
+        },
         annotations: writes
     }, handle(config, async ({ projectId, ...body }) => {
         const unpublishedDrafts = await readUnpublishedDrafts(platform, projectId, body.sourceEnvironmentId).catch(() => undefined);
@@ -45,7 +51,7 @@ export function registerDeploymentTools(server, platform) {
     }));
     server.registerTool('deployment_status', {
         title: 'Deployment durumu',
-        description: "Projenin son deployment durumunu döner. 'projectId' ZORUNLUDUR (project_list/project_get'ten alın) — verilmezse çağrı MCP şema katmanında reddedilir, platforma hiç gitmez. Hiç deployment yapılmamış projede yanıt BOŞ gelir; o durumda tool 'hiç deployment kaydı yok' bilgisini açıkça döner, yani boş yanıtı 'tool çalışmadı' diye okumayın. Durum satırı modül başına ayrılmaz: süreç tanımları ve iş takvimleri sayfa ve workflow'lardan sonra aynı saga adımında aktarılır; hedefte çalışamayan (eksik workflow/entity/rol) tanım aktarımı DefinitionInvalid ile düşürür. type 'error' ise 'error' alanı düşüş nedenini taşır (DefinitionInvalid'de bulgular 'yol: mesaj | …' olarak eklenir); aktarım atomiktir, hedef değişmemiştir.",
+        description: "Projenin son deployment durumunu döner. 'projectId' ZORUNLUDUR (project_list/project_get'ten alın) — verilmezse çağrı MCP şema katmanında reddedilir, platforma hiç gitmez. Hiç deployment yapılmamış projede yanıt BOŞ gelir; o durumda tool 'hiç deployment kaydı yok' bilgisini açıkça döner, yani boş yanıtı 'tool çalışmadı' diye okumayın. Durum satırı modül başına ayrılmaz: süreç tanımları ve iş takvimleri sayfa ve workflow'lardan sonra aynı saga adımında aktarılır; hedefte çalışamayan (eksik workflow/entity/rol) tanım aktarımı DefinitionInvalid ile düşürür. type 'error' ise 'error' alanı düşüş nedenini taşır (DefinitionInvalid'de bulgular 'yol: mesaj | …' olarak eklenir); aktarım atomiktir, hedef değişmemiştir. type 'completed-with-mismatch': deploy tamamlandı, kayıtlar production'a yazıldı, ama ardından koşan özet denetimi production'da fark buldu; sonraki deploy otomatik tam (full) koşar. Yanıt mode (full | delta: deploy'un gerçekte koştuğu kip) ve counters (delta'da modül başına added/updated/deleted) taşır.",
         inputSchema: { projectId: guid },
         annotations: readOnly
     }, handle(config, async ({ projectId }) => {

package/dist/tools/microservices.js

@@ -455,7 +455,7 @@ export function registerMicroserviceTools(server, platform) {
         const requestHeaders = { ...runIdentity(anonymous, member, cookies, headers), ...eye, ...languageHeader(language, notes) };
         const bound = bindCallParameters(method, parameters, query, body, notes);
         assertFilterOperators('microservice_execute', bound);
-        const raw = await platform.tenantRaw(method, project, executePath('m', application, microservice, routeParams), { environment, query: bound.query, body: bound.body, headers: requestHeaders, anonymous, mirrorAuthorizationCookie: true });
+        const raw = await platform.tenantRaw(method, project, executePath('m', application, microservice, routeParams), { environment, query: bound.query, body: bound.body, headers: requestHeaders, anonymous, mirrorAuthorizationCookie: true, noNetworkRetry: true });
         return withNormalization({ ...raw, headers: headersForMode(raw.headers, includeHeaders ?? 'essential') }, notes);
     }));
     server.registerTool('microservice_debug', {

package/dist/tools/mobile.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { environmentParam, guid, pagingParams, projectParam, readOnly, writes } from './common.js';
+import { environmentParam, guid, pagingParams, projectParam, readOnly, writes, templateSubscriptionLock } from './common.js';
 import { fetchHost, pageUpdateBody, unwrap } from './screens.js';
 import { fetchCatalogSlugs } from './components.js';
 import { mobileTabsWarnings } from './applications.js';
@@ -144,7 +144,7 @@ export function registerMobileTools(server, platform) {
     }, handle(config, ({ project, environment, applicationId, id, ...query }) => platform.tenant('GET', project, id ? `/push/notifications/${applicationId}/${id}` : `/push/notifications/${applicationId}`, { environment, query })));
     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').",
+        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'). " + templateSubscriptionLock,
         inputSchema: {
             project: projectParam,
             environment: environmentParam,

package/dist/tools/projects.js

@@ -1,4 +1,4 @@
-import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive } from './common.js';
+import { guid, projectParam, environmentParam, pagingParams, readOnly, writes, updates, destructive, templateSubscriptionLock } from './common.js';
 import { normalizeLanguageCode, normalizeLanguageCodes } from '../knowledge/languageCodes.js';
 import { projectCoverageGaps } from '../knowledge/coverage.js';
 import { withNormalization } from '../knowledge/normalize.js';
@@ -266,7 +266,7 @@ export function registerProjectTools(server, platform) {
     }));
     server.registerTool('project_update', {
         title: 'Proje güncelle',
-        description: "Proje adını, slug'ını, temasını ve dil ayarlarını günceller. languages/defaultLanguage verilmezse mevcut değerlerine dokunulmaz. SLUG: vermezseniz gateway projeyi okuyup MEVCUT slug'ı gövdeye kendisi koyar ve bunu gatewayNormalized ile bildirir — platform slug'ı ADDAN yeniden üretiyor ve slug runtime rotasının parçası olduğu için (/{projectSlug}/{application}/{page}) tek çağrı bütün sayfa URL'lerini ve DEFAULT_PROJECT çözümlemesini kırıyordu (ölçüldü 2026-09-05). Slug'ı gerçekten değiştirmek istiyorsanız açıkça yazın; yanıt o zaman rotanın da değiştiğini söyler. LoaderImage bu tool'da desteklenmez.",
+        description: "Proje adını, slug'ını, temasını ve dil ayarlarını günceller. languages/defaultLanguage verilmezse mevcut değerlerine dokunulmaz. SLUG: vermezseniz gateway projeyi okuyup MEVCUT slug'ı gövdeye kendisi koyar ve bunu gatewayNormalized ile bildirir — platform slug'ı ADDAN yeniden üretiyor ve slug runtime rotasının parçası olduğu için (/{projectSlug}/{application}/{page}) tek çağrı bütün sayfa URL'lerini ve DEFAULT_PROJECT çözümlemesini kırıyordu (ölçüldü 2026-09-05). Slug'ı gerçekten değiştirmek istiyorsanız açıkça yazın; yanıt o zaman rotanın da değiştiğini söyler. LoaderImage bu tool'da desteklenmez. " + templateSubscriptionLock,
         inputSchema: {
             id: guid,
             name: z.string().min(1).optional().describe('Verilmezse mevcut ad korunur — yalnız dil ayarını değiştirmek için adı tekrar göndermeniz gerekmez'),

package/dist/tools/templates.js

@@ -104,7 +104,7 @@ export function registerTemplateTools(server, platform) {
     }));
     server.registerTool('template_check_updates', {
         title: 'Şablon güncellemesi var mı',
-        description: 'Şablondan kurulmuş projenin kaynak şablonunda yeni sürüm var mı kontrol eder.',
+        description: 'Şablondan kurulmuş projenin kaynak şablonunda yeni sürüm var mı kontrol eder. Yeni sürüm varsa added / changed / removed, güncellemenin kuracağı eklenen, değişen ve silinen kalem sayısıdır; null ise kurulu sürümün manifesti yok ve güncelleme bütün kalemleri yeniden kurar. Üçü 0 olan sürümde, abonenin şablondan kurulu kayıtları yerindeyse güncelleme kurucu koşturmadan yalnız sürümü ilerletir; eksik kayıt varsa onu yeniden kurar.',
         inputSchema: { projectId: guid },
         annotations: readOnly
     }, handle(config, ({ projectId }) => platform.org('GET', `/projects/${projectId}/templates/check-for-updates`)));

package/dist/tools/themes.js

@@ -1,4 +1,4 @@
-import { guid, projectParam, readOnly, updates } from './common.js';
+import { guid, projectParam, readOnly, updates, templateSubscriptionLock } from './common.js';
 import { diffCssVars, mergeRadiusScale, mergeSpacingScale, mergeTypeScale, resolveTheme } from '../knowledge/themeResolve.js';
 import { diffThemePaths, mergeTheme, normalizeTheme, readProjectTheme, summarizeTheme, themeInput, unsetThemePaths } from '../knowledge/themeSchema.js';
 import { componentPresetTypeWarnings, themeInputWarnings, unsetWarnings } from '../knowledge/themeRules.js';
@@ -144,7 +144,7 @@ export function registerThemeTools(server, platform) {
     }));
     server.registerTool('theme_update', {
         title: 'Proje temasını güncelle',
-        description: "Temayı KISMİ günceller: kaydı okur, verdiğiniz alanları derin birleştirir, normalize eder, lint'ten geçirir ve yazar — bir rengi değiştirmek preset'leri ve bileşen preset'lerini düşürmez. Yanıt hangi yolların değiştiğini (changed) ve hangi CSS değişkeninin hangi değerden hangi değere gittiğini (cssVarsChanged) söyler; dryRun ile yazmadan aynı yanıtı alırsınız. DİKKAT: tema PROJE kaydıdır — değişiklik BÜTÜN ortamların runtime'ına iner (production dâhil) ve Studio tema paneli açık ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer.",
+        description: "Temayı KISMİ günceller: kaydı okur, verdiğiniz alanları derin birleştirir, normalize eder, lint'ten geçirir ve yazar — bir rengi değiştirmek preset'leri ve bileşen preset'lerini düşürmez. Yanıt hangi yolların değiştiğini (changed) ve hangi CSS değişkeninin hangi değerden hangi değere gittiğini (cssVarsChanged) söyler; dryRun ile yazmadan aynı yanıtı alırsınız. DİKKAT: tema PROJE kaydıdır — değişiklik BÜTÜN ortamların runtime'ına iner (production dâhil) ve Studio tema paneli açık ve kaydedilmemişse panelin sonraki Save'i bu yazmayı ezer. " + templateSubscriptionLock,
         inputSchema: {
             project: projectParam,
             theme: themeInput.optional().describe("Yazılacak alanlar — KISMİ. Nesneler derin birleşir, dizi/ilkel değer yerine geçer. Tanınmayan anahtar (ör. 'pallete') istek gitmeden reddedilir: platform temayı doğrulamayan bir jsonb blob'u olarak saklar ve yazım hatası kayıtta sessizce yaşardı"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.47",
+  "version": "0.0.49",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",