@appaflytech/zeyrek-ai-mcp 0.0.22 → 0.0.24

package/dist/platform/bodyFile.js

@@ -0,0 +1,103 @@
+import { open, realpath } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { extname, resolve, sep } from 'node:path';
+import { z } from 'zod';
+import { PlatformApiError } from './errors.js';
+/**
+ * g-08 (`plans/mobil-plantcare-acigi`): tanım yazan araçlar gövdeyi dosyadan alabilir. Koşuda en
+ * büyük bağlam tasarrufu, ajanın kendi yazdığı "dosyadan MCP'ye" betiğinden geldi; o iş buraya
+ * taşındı. Her aracın TEK gövde argümanı vardır ve dosyanın JSON'u o argümanın değeri olur. Dosya
+ * SDK doğrulamasından ÖNCE okunur (`strictArguments.ts`), yani satır içi gövdeyle aynı şema ve aynı
+ * yol — dosyadan gelen gövde hiçbir kontrolü atlamaz.
+ */
+export const BODY_FILE_ARGUMENTS = {
+    page_create: 'schema',
+    page_update: 'schema',
+    page_schema_patch: 'ops',
+    flow_create: 'steps',
+    flow_update: 'steps',
+    flow_patch: 'operations',
+    microservice_create: 'definition',
+    microservice_update: 'definition',
+    microservice_patch: 'operations',
+    workflow_create: 'definition',
+    workflow_update: 'definition',
+    workflow_patch: 'operations'
+};
+/** `ops`/`operations` eşanlamlıdır (`microOps`); ikisinden biri satır içinde varsa gövde verilmiştir. */
+const synonyms = { ops: ['ops', 'operations'], operations: ['ops', 'operations'] };
+const maxBodyFileBytes = 5 * 1024 * 1024;
+export function bodyFileParam(argument) {
+    return z.string().min(1).optional().describe(`'${argument}' yerine okunacak yerel .json dosyası (en çok 5 MB): gövde ajan bağlamından geçmez, gateway dosyayı okuyup '${argument}' olarak aynı doğrulamadan geçirir. '${argument}' ile birlikte verilemez. Yol gateway sürecinin çalışma dizininin ya da MCP_INPUT_DIR'in altında olmalı (sembolik bağ çözülür). Yanıtın bodyFile alanı hangi dosyanın okunduğunu söyler.`);
+}
+export async function loadBodyFile(tool, args, config) {
+    const argument = BODY_FILE_ARGUMENTS[tool];
+    if (!argument || !args || typeof args !== 'object' || Array.isArray(args))
+        return { args };
+    const { bodyFile, ...rest } = args;
+    if (bodyFile === undefined)
+        return { args };
+    if (typeof bodyFile !== 'string' || bodyFile.length === 0)
+        return { args };
+    const inline = (synonyms[argument] ?? [argument]).filter(name => rest[name] !== undefined);
+    if (inline.length > 0) {
+        throw new PlatformApiError(`${tool}: bodyFile ile '${inline.join("', '")}' birlikte verilemez — gövde ya dosyadan ya satır içinden gelir. Birini kaldırın. İstek gönderilmedi.`, 400);
+    }
+    const absolute = resolve(bodyFile);
+    if (extname(absolute).toLowerCase() !== '.json') {
+        throw new PlatformApiError(`${tool}: bodyFile yalnız .json okur — verilen: ${absolute}. İstek gönderilmedi.`, 400);
+    }
+    let real;
+    try {
+        real = await realpath(absolute);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile okunamadı — ${absolute} (${error instanceof Error ? error.message : String(error)}). Yol gateway sürecinin çalıştığı makineye göre çözülür.`, 400);
+    }
+    if (extname(real).toLowerCase() !== '.json') {
+        throw new PlatformApiError(`${tool}: bodyFile'ın hedefi .json değil — ${real} (${absolute} bağının hedefi). İstek gönderilmedi.`, 400);
+    }
+    const roots = await Promise.all([process.cwd(), config.inputDirectory]
+        .filter((root) => typeof root === 'string' && root.length > 0)
+        .map(root => realpath(resolve(root)).catch(() => undefined)));
+    const allowed = roots.some(root => root !== undefined && (real === root || real.startsWith(`${root}${sep}`)));
+    if (!allowed) {
+        throw new PlatformApiError(`${tool}: bodyFile izinli dizinlerin dışında — ${real}${real !== absolute ? ` (${absolute} bağının hedefi)` : ''}. Gateway yalnız çalışma dizininin (${process.cwd()}) ve .env'deki MCP_INPUT_DIR'in (${config.inputDirectory ?? 'tanımsız'}) altındaki dosyaları okur. İstek gönderilmedi.`, 400);
+    }
+    // Denetim ve okuma AYNI tutamaçtan: yol denetimden sonra değişse de okunan, denetlenen dosyadır.
+    // O_NOFOLLOW son bileşenin sonradan bağa çevrilmesini, O_NONBLOCK `.json` adlı FIFO'nun çağrıyı
+    // bekletmesini önler; boyut dosyanın büyüklüğüne değil okunan bayta bakar.
+    let handle;
+    try {
+        handle = await open(real, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile açılamadı — ${real} (${error instanceof Error ? error.message : String(error)}). İstek gönderilmedi.`, 400);
+    }
+    let bytes;
+    let text;
+    try {
+        const info = await handle.stat();
+        if (!info.isFile()) {
+            throw new PlatformApiError(`${tool}: bodyFile düzenli dosya değil — ${real}. İstek gönderilmedi.`, 400);
+        }
+        const buffer = Buffer.alloc(maxBodyFileBytes + 1);
+        const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+        bytes = bytesRead;
+        if (bytes > maxBodyFileBytes) {
+            throw new PlatformApiError(`${tool}: bodyFile 5 MB sınırını aşıyor. Tanımı parçalara bölün — sayfa için page_schema_patch'e birden çok batch, akış için flow_patch. İstek gönderilmedi.`, 400);
+        }
+        text = buffer.subarray(0, bytes).toString('utf8');
+    }
+    finally {
+        await handle.close();
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch (error) {
+        throw new PlatformApiError(`${tool}: bodyFile JSON değil — ${real} (${error instanceof Error ? error.message : String(error)}). İstek gönderilmedi.`, 400);
+    }
+    return { args: { ...rest, [argument]: value }, note: `${bodyFile} → ${argument} (${bytes} B)` };
+}

package/dist/platform/capture/capture.js

@@ -4,6 +4,7 @@ import { INTERNAL_ROLE_SEPARATOR, knownInternalRoles } from '../../knowledge/com
 import { logStep } from '../../observability/trace.js';
 import { actionScript, activeTabScript, rootElementId, runtimePropsScript } from './actions.js';
 import { domSummaryScript } from './summary.js';
+import { createPageConsoleLog, describePageFailure, parseRenderErrors, renderErrorsScript } from './console-log.js';
 import { decideReadiness, describeUnready, parseReadiness, readinessScript, runtimePath } from './readiness.js';
 /**
  * Ziyaretçinin tema tercihinin yaşadığı localStorage anahtarı — `theme-toggle` bunu yazar,
@@ -17,6 +18,12 @@ const VIEWER_MODE_STORAGE_KEY = 'zeyrek-viewer-theme-mode';
  * büyüterek alınır: Studio runtime'ı kendi kaydırma kabını `100vh` üzerine kuruyor ve viewport
  * ötesi yakalama o kabı bir kez daha çiziyordu — aynı sayfa karede iki kez görünüyordu (09-04
  * Y-23). Tek karede çekilen görüntüde o birleştirme adımı hiç yok.
+ *
+ * İç kaydırıcı için gereken viewport `innerHeight + (scrollHeight − clientHeight)`'tir, kabın
+ * `scrollHeight`'i DEĞİL: kap viewport'la birlikte büyür ama üstündeki/altındaki sabit parçalar
+ * (mobil host'ta app bar + tab bar, ZM-23 f-06) büyümez. Yalnız `scrollHeight` itilince viewport
+ * içerik boyuna çıkıyor, kap hâlâ o parçalar kadar kısa kalıyor ve uzun mobil sayfanın altı
+ * karenin dışında kalıyordu. Kap viewport kadar yüksekse iki formül aynı sonucu verir.
  */
 export const contentHeightScript = [
     '(function () {',
@@ -27,7 +34,7 @@ export const contentHeightScript = [
     '  var nodes = document.querySelectorAll("*");',
     '  for (var index = 0; index < nodes.length && index < 4000; index += 1) {',
     '    var node = nodes[index];',
-    '    if (node.clientHeight >= viewportHeight * 0.6 && node.scrollHeight > node.clientHeight + 1) heights.push(node.scrollHeight);',
+    '    if (node.clientHeight >= viewportHeight * 0.6 && node.scrollHeight > node.clientHeight + 1) heights.push(viewportHeight + node.scrollHeight - node.clientHeight);',
     '  }',
     '  return { contentHeight: Math.max.apply(null, heights), viewportHeight: viewportHeight };',
     '})()'
@@ -91,6 +98,10 @@ export const layoutReportScript = [
     '  };',
     '})'
 ].join('\n');
+/** Mobil çizicinin hata sınırı işaretleri; betik düşerse boş (çekimi düşürmez). */
+async function readRenderErrors(page) {
+    return page.evaluate(renderErrorsScript).then(parseRenderErrors).catch(() => []);
+}
 /**
  * F-09 — sayfa akışı yalnız tarayıcıda koşar, bu yüzden bir setter iteratee'sinin
  * patlamasının gateway'e ulaşan HİÇBİR yolu yoktu: akış 200 dönüyor, hedef prop
@@ -264,7 +275,7 @@ export class StudioScreenshotter {
      * işaretlenir ve kare yine çekilir, çünkü bozuk/boş sayfayı görmek de bir doğrulamadır. Veri
      * yanıtından sonra fontlar + kısa yerleşme beklemesi Svelte hydrate'ine alan bırakır.
      */
-    async runActions(page, request) {
+    async runActions(page, request, consoleLog) {
         if (!request.actions || request.actions.length === 0)
             return undefined;
         const outcomes = [];
@@ -306,7 +317,8 @@ export class StudioScreenshotter {
                 completedBefore: activityBefore?.completed ?? Number.POSITIVE_INFINITY
             });
             if (readiness.state === 'not-ready' && request.captureUnready !== true) {
-                throw new PlatformApiError(`Etkileşim adımı ${index} (${action.action}${action.target === undefined ? '' : ` '${action.target}'`}) sonrasında sayfa ${readiness.waitedMs} ms içinde durulmadı, kare ALINMADI — ${describeUnready(readiness)}. Bekleme bütçesi ${apiResponseTimeoutMs + request.delayMs} ms; akış gerçekten uzun sürüyorsa delayMs ile büyütün. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
+                const failure = consoleLog ? describePageFailure(consoleLog, await readRenderErrors(page)) : '';
+                throw new PlatformApiError(`Etkileşim adımı ${index} (${action.action}${action.target === undefined ? '' : ` '${action.target}'`}) sonrasında sayfa ${readiness.waitedMs} ms içinde durulmadı, kare ALINMADI — ${describeUnready(readiness)}.${failure} Bekleme bütçesi ${apiResponseTimeoutMs + request.delayMs} ms; akış gerçekten uzun sürüyorsa delayMs ile büyütün. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
             }
             const after = await page.evaluate("performance.getEntriesByType('resource').length").catch(() => undefined);
             const requests = typeof after === 'number' && typeof before.requests === 'number' ? Math.max(after - before.requests, 0) : 0;
@@ -459,6 +471,11 @@ export class StudioScreenshotter {
                 await context.addInitScript(`try { localStorage.setItem(${JSON.stringify(VIEWER_MODE_STORAGE_KEY)}, ${JSON.stringify(request.colorScheme)}) } catch (error) { /* localStorage kapalıysa proje varsayılanı çizilir */ }`);
             }
             const page = await context.newPage();
+            // Konsol ve istisna dinleyicileri navigasyondan ÖNCE takılır: modül yüklenirken patlayan
+            // bileşenin hatası ilk karede düşer ve sonradan takılan dinleyici onu kaçırırdı (g-06).
+            const consoleLog = createPageConsoleLog();
+            page.on?.('console', message => consoleLog.onConsole(message));
+            page.on?.('pageerror', error => consoleLog.onPageError(error));
             // Soğuk Vite derlemesinde sayfanın kendi veri isteği 15 sn'yi aşabiliyor; delayMs bu
             // bütçeyi de uzatır (09-02 E-2). Yanıt hazırlık döngüsünü BLOKLAMAZ: runtime dışına
             // yönlendirilen sayfa bu isteği hiç atmaz ve eskiden 15 sn boşa bekleniyordu.
@@ -499,7 +516,8 @@ export class StudioScreenshotter {
             const apiStatus = await Promise.race([observedApiStatus, Promise.resolve(undefined)]);
             const apiNote = apiStatus === undefined ? 'sayfanın veri isteği gözlenmedi' : `veri isteği HTTP ${apiStatus}`;
             if (readiness.state === 'not-ready' && request.captureUnready !== true) {
-                throw new PlatformApiError(`Sayfa ${readiness.waitedMs} ms içinde yüklenmedi, kare ALINMADI — ${describeUnready(readiness, apiNote)}. Bekleme bütçesi ${readyBudgetMs} ms; sayfa yalnız yavaşsa delayMs ile büyütün. Sayfa gerçekten bozuksa page_runtime_get ile şemayı, STUDIO_BASE_URL ve slug'ları doğrulayın. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
+                const failure = describePageFailure(consoleLog, await readRenderErrors(page));
+                throw new PlatformApiError(`Sayfa ${readiness.waitedMs} ms içinde yüklenmedi, kare ALINMADI — ${describeUnready(readiness, apiNote)}.${failure} Bekleme bütçesi ${readyBudgetMs} ms; sayfa yalnız yavaşsa delayMs ile büyütün. Sayfa gerçekten bozuksa page_runtime_get ile şemayı, STUDIO_BASE_URL ve slug'ları doğrulayın. Yüklenmemiş hâli yine de görmek için captureUnready: true verin (kare pageState: 'not-ready' ile döner).`, 504);
             }
             await page.evaluate('document.fonts.ready.then(() => true)').catch(() => undefined);
             const flowsSettled = readiness.state === 'ready' || readiness.state === 'ready-no-flows'
@@ -507,7 +525,7 @@ export class StudioScreenshotter {
                 : readiness.state === 'not-ready' ? false : undefined;
             const finalHref = readiness.snapshot?.href;
             const finalUrl = finalHref !== undefined && runtimePath(finalHref) !== runtimePath(request.url) ? finalHref : undefined;
-            const actions = await this.runActions(page, request);
+            const actions = await this.runActions(page, request, consoleLog);
             // Ölçüm EYLEMLERDEN SONRA: eylem sekme değiştirir, filtre uygular, panel açar — içerik
             // boyu o zaman kesinleşir. Eskiden ölçüm eylemlerden önceydi ve ikinci sekmede 40 satırlık
             // tablo açan bir çekim viewport boyunda kalıyordu; `contentHeight` ilk sekmenin boyuydu
@@ -548,6 +566,9 @@ export class StudioScreenshotter {
             const runtimeErrors = await page.evaluate(flowRuntimeErrorsScript)
                 .then(value => Array.isArray(value) ? value : [])
                 .catch(() => []);
+            const renderErrors = await readRenderErrors(page);
+            const consoleErrors = consoleLog.consoleErrors();
+            const pageErrors = consoleLog.pageErrors();
             // Özet kareden ÖNCE ve büyütmeden SONRA: ikisi de aynı yerleşmiş sayfayı anlatsın.
             const summaryRaw = request.summary === false
                 ? undefined
@@ -590,6 +611,9 @@ export class StudioScreenshotter {
                 ...(layout === undefined ? {} : { layout }),
                 ...(actions === undefined ? {} : { actions }),
                 ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),
+                ...(consoleErrors.length > 0 ? { consoleErrors } : {}),
+                ...(pageErrors.length > 0 ? { pageErrors } : {}),
+                ...(renderErrors.length > 0 ? { renderErrors } : {}),
                 ...(flowsSettled === undefined ? {} : { flowsSettled }),
                 ...(navigationRetried ? { navigationRetried: true } : {})
             };

package/dist/platform/capture/console-log.js

@@ -0,0 +1,80 @@
+import { maskSecretText } from '../secrets.js';
+const bufferLimit = 20;
+const reportLimit = 5;
+const textLimit = 300;
+const stackLines = 5;
+const clip = (text) => (text.length > textLimit ? `${text.slice(0, textLimit - 1)}…` : text);
+/**
+ * Çekim boyunca tarayıcı konsolunun hata/uyarı satırları ve yakalanmamış istisnalar. Koşuda sayfa
+ * çizilmediğinde `page_screenshot` yalnız "runtime hiç render olmadı" diyordu; nedeni bulmak için
+ * ajan kendi Playwright betiğini yazıp Studio paketinin sıkıştırılmış kaynağını okudu
+ * (plans/mobil-plantcare-acigi g-06). Aynı metin tekrarlanırsa sayaç artar, satır eklenmez; metin
+ * kırpılır ve kimlik parçaları maskelenir.
+ */
+export function createPageConsoleLog() {
+    const consoleRecords = [];
+    const pageErrorRecords = [];
+    return {
+        onConsole(message) {
+            const type = message.type();
+            const level = type === 'error' ? 'error' : type === 'warning' ? 'warning' : undefined;
+            if (!level)
+                return;
+            const text = clip(maskSecretText(message.text()));
+            const existing = consoleRecords.find(record => record.level === level && record.text === text);
+            if (existing)
+                existing.count += 1;
+            else if (consoleRecords.length < bufferLimit)
+                consoleRecords.push({ level, text, count: 1 });
+        },
+        onPageError(error) {
+            if (pageErrorRecords.length >= bufferLimit)
+                return;
+            const message = clip(maskSecretText(error instanceof Error ? `${error.name}: ${error.message}` : String(error)));
+            const stack = error instanceof Error && error.stack
+                ? maskSecretText(error.stack.split('\n').slice(1, stackLines + 1).map(line => line.trim()).join('\n'))
+                : undefined;
+            if (!pageErrorRecords.some(record => record.message === message))
+                pageErrorRecords.push({ message, ...(stack ? { stack } : {}) });
+        },
+        /** Önce hatalar, sonra uyarılar; en çok beş kayıt. */
+        consoleErrors() {
+            return [...consoleRecords.filter(record => record.level === 'error'), ...consoleRecords.filter(record => record.level === 'warning')].slice(0, reportLimit);
+        },
+        pageErrors() {
+            return pageErrorRecords.slice(0, reportLimit);
+        }
+    };
+}
+const failureLimit = 3;
+/**
+ * Çizilemeyen sayfanın hata metnine eklenen nedenler: çöken düğümler, yakalanmamış istisnalar, konsol
+ * hataları — bu sırayla, her birinden en çok üç; uyarılar eklenmez. Hiçbiri yoksa boş. Yalnız ilk neden
+ * yazılırken sayfa istisnası React'in bileşeni adlandıran konsol satırını gizliyordu.
+ */
+export function describePageFailure(log, renderErrors) {
+    const crashed = renderErrors.slice(0, failureLimit).map(record => `${record.elementId ?? '?'} — ${record.message}`);
+    const thrown = log.pageErrors().slice(0, failureLimit).map(record => `${record.message}${record.stack ? ` (${record.stack.split('\n')[0]})` : ''}`);
+    const logged = log.consoleErrors().filter(record => record.level === 'error').slice(0, failureLimit).map(record => record.text);
+    return [
+        crashed.length ? ` Çöken düğüm: ${crashed.join('; ')}.` : '',
+        thrown.length ? ` Sayfa istisnası: ${thrown.join('; ')}.` : '',
+        logged.length ? ` Konsol hatası: ${logged.join('; ')}.` : ''
+    ].join('');
+}
+/**
+ * Mobil çizicinin hata sınırlarının bıraktığı işaretler (`data-ng-render-error`). Düğümün dış sınırı
+ * (kancaları çöken düğüm) yer tutucuyu kendi kabuğunun dışında çizer ve kimliği işaretin üstünde taşır
+ * (`data-ng-render-error-id`); taşımıyorsa en yakın kabuk düğümdür.
+ */
+export const renderErrorsScript = "Array.from(document.querySelectorAll('[data-ng-render-error]')).slice(0, 20).map(function (el) { var own = el.getAttribute('data-ng-render-error-id'); var owner = own ? null : el.closest('[data-element-id]'); return { elementId: own || (owner ? owner.getAttribute('data-element-id') : undefined), message: el.getAttribute('data-ng-render-error') || '' }; })";
+export function parseRenderErrors(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter((entry) => entry !== null && typeof entry === 'object')
+        .map(entry => ({
+        ...(typeof entry.elementId === 'string' ? { elementId: entry.elementId } : {}),
+        message: clip(maskSecretText(typeof entry.message === 'string' ? entry.message : ''))
+    }));
+}

package/dist/platform/capture/index.js

@@ -8,3 +8,4 @@ export * from './actions.js';
 export * from './summary.js';
 export * from './readiness.js';
 export * from './capture.js';
+export * from './console-log.js';

package/dist/platform/diagnostics.js

@@ -5,8 +5,9 @@ const MAX_NOTES = 8;
 const MAX_NOTE_CHARS = 240;
 const MAX_DROPS = 5;
 export const diagnosticsParam = z.enum(['compact', 'full']).optional().describe("Yanıttaki gatewayNormalized / silentlyDropped listelerinin boyu. compact (varsayılan): aynı not tekilleşir, uzun not kısalır (en fazla 8); aynı yolun düşmeleri tek satırda sayıyla toplanır (en fazla 5 grup); droppedCount her zaman tam sayıdır. full: listelerin tamamı.");
-export function runWithDiagnostics(mode, run) {
-    return activeMode.run(mode, run);
+/** `adjustable`: tool `diagnostics` parametresini alıyor mu — kısaltma notu yalnız alan tool'a onu önerir (g-08). */
+export function runWithDiagnostics(mode, run, adjustable = true) {
+    return activeMode.run({ mode, adjustable }, run);
 }
 /**
  * Tanılama listeleri her yazma çağrısında yanıta girer ve aynı gerekçe cümlesi çağrı başına tekrar
@@ -18,7 +19,7 @@ export function runWithDiagnostics(mode, run) {
  * listeyi görür; kısaltma yalnız `diagnostics` parametresini taşıyan yazma tool'larında devreye girer.
  */
 export function compactDiagnostics(payload) {
-    if (activeMode.getStore() !== 'compact')
+    if (activeMode.getStore()?.mode !== 'compact')
         return payload;
     if (!payload || typeof payload !== 'object' || Array.isArray(payload))
         return payload;
@@ -58,7 +59,12 @@ export function compactDiagnostics(payload) {
     }
     if (hidden.length === 0)
         return result;
-    return { ...result, diagnosticsNote: "Kısaltıldı; yazmayı tekrarlamayın. Tam liste: sonraki çağrıda diagnostics:'full'." };
+    return {
+        ...result,
+        diagnosticsNote: activeMode.getStore()?.adjustable === false
+            ? 'Kısaltıldı; tam liste gateway günlüğünde (bu tool diagnostics parametresi almaz).'
+            : "Kısaltıldı; yazmayı tekrarlamayın. Tam liste: sonraki çağrıda diagnostics:'full'."
+    };
 }
 /**
  * Aynı yolun farklı öğelerindeki düşmeler (`selectFields[fieldId=a].path`, `selectFields[fieldId=b].path`, …)

package/dist/platform/http.js

@@ -6,6 +6,20 @@ import { randomUUID } from 'node:crypto';
 import { request } from 'undici';
 export const requestAuthStorage = new AsyncLocalStorage();
 const hiddenResponseHeaders = new Set(['set-cookie', 'authorization', 'proxy-authorization']);
+/**
+ * g-08: yürütme yanıtının varsayılan başlıkları — işin okuduğu olanlar. `total-count` sayfalı tablo
+ * akışlarının sözleşmesidir (İK koşusu M-8), `location` yönlendirmenin, `x-request-id`/`traceparent`
+ * platform günlüğünde aynı isteği bulmanın anahtarıdır. Cloudflare ve sunucu başlıkları (`cf-ray`,
+ * `server`, `alt-svc`, `date` …) ajan bağlamında yer kaplıyordu ve hiçbir karar onlara bakmıyordu.
+ */
+const essentialResponseHeaders = new Set(['content-type', 'content-length', 'content-disposition', 'location', 'total-count', 'x-request-id', 'traceparent']);
+export function headersForMode(headers, mode) {
+    if (mode === 'none')
+        return undefined;
+    if (mode === 'all')
+        return headers;
+    return Object.fromEntries(Object.entries(headers).filter(([name]) => essentialResponseHeaders.has(name)));
+}
 /**
  * Sayfalı tablo akışları `Total-Count` header'ına bağlı ama execute ailesi yalnız gövdeyi
  * döndürüyordu; sözleşme hiçbir tool'dan doğrulanamıyordu (İK koşusu M-8). Gizli header'lar
@@ -153,13 +167,15 @@ export class Platform {
             body = JSON.stringify(options.body);
         }
         const startedAt = Date.now();
-        logStep('istek →', `${method} ${url.href} · ${api} api${options.environment ? ` · env=${options.environment}` : ''}${options.anonymous ? ' · ANONİM (Authorization header YOK)' : ''}${isRetry ? ' · 401 sonrası tekrar' : ''}`, logsDetail() && (options.multipart || options.form || options.body !== undefined)
-            ? [`gövde: ${renderJson(options.multipart
-                    ? describeMultipart(options.multipart)
-                    : options.form
-                        ? Object.fromEntries(options.form)
-                        : options.body)}`]
-            : []);
+        logStep('istek →', `${method} ${url.href} · ${api} api${options.environment ? ` · env=${options.environment}` : ''}${options.anonymous ? ' · ANONİM (Authorization header YOK)' : ''}${isRetry ? ' · 401 sonrası tekrar' : ''}`, options.hideRequestBody === true
+            ? ['gövde: (gizli — kimlik bilgisi taşıyor, günlüğe yazılmaz)']
+            : logsDetail() && (options.multipart || options.form || options.body !== undefined)
+                ? [`gövde: ${renderJson(options.multipart
+                        ? describeMultipart(options.multipart)
+                        : options.form
+                            ? Object.fromEntries(options.form)
+                            : options.body)}`]
+                : []);
         let statusCode;
         let payload;
         let responseBytes = 0;

package/dist/platform/responses.js

@@ -1,4 +1,6 @@
 import { compactDiagnostics } from './diagnostics.js';
+import { argumentNotes } from './argumentAliases.js';
+import { tokenTtlMinutes } from './tokenVault.js';
 import { logError, logStep } from '../observability/trace.js';
 import { PlatformApiError, describeErrorBody } from './errors.js';
 import { PolicyBlockError } from '../knowledge/policy.js';
@@ -162,8 +164,10 @@ export function toolResult(payload, config, expectFailure) {
         ...(runtimeErrors.length > 0 ? { runtimeErrors } : {}),
         ...(runtimeErrors.length > 0 && expectFailure === true ? { expectedFailure: true } : {}),
         ...(masked.length > 0 ? { gatewayMasked: masked } : {}),
-        ...(Object.keys(tokenRefs).length > 0 ? { tokenRefs, tokenRefNote: "Maskelenen JWT'ler gateway içinde tutuldu; bu referansları page_screenshot / page_runtime_get 'asUser' alanına verebilirsiniz (15 dk geçerli). Jetonun kendisi yanıta ve günlüğe hiç girmez." } : {}),
-        ...(truncated ? { truncated: true, truncationNote: 'Liste, yanıt boyutu sınırı nedeniyle kırpıldı; sayfalama ya da daha dar filtre kullanın.' } : {})
+        ...(Object.keys(tokenRefs).length > 0 ? { tokenRefs, tokenRefNote: `Maskelenen JWT'ler gateway içinde tutuldu; bu referansları page_screenshot / page_runtime_get 'asUser' alanına verebilirsiniz (${tokenTtlMinutes()} dk geçerli). Jetonun kendisi yanıta ve günlüğe hiç girmez.` } : {}),
+        ...(truncated ? { truncated: true, truncationNote: 'Liste, yanıt boyutu sınırı nedeniyle kırpıldı; sayfalama ya da daha dar filtre kullanın.' } : {}),
+        ...(argumentNotes().aliasesApplied.length > 0 ? { aliasesApplied: argumentNotes().aliasesApplied } : {}),
+        ...(argumentNotes().bodyFile ? { bodyFile: argumentNotes().bodyFile } : {})
     };
     return {
         content: [{ type: 'text', text: JSON.stringify(enriched) }],

package/dist/platform/schemaReadMemory.js

@@ -0,0 +1,60 @@
+/**
+ * Sayfa okumalarının belleği. İki soru cevaplar:
+ *
+ * - "Bu sayfa sürümü kırpık okundu mu" (ZM-28, PAGE-038): `page_schema_get(mode:'full',
+ *   allowTruncated:true)` sığmayan şemayı kırparak döndüğünde anahtar işaretlenir; aynı sürümü
+ *   `baseVersion` olarak veren `page_schema_patch` uyarı taşır — plan, düşen düğümleri görmeden
+ *   yapılmış olabilir.
+ * - "Bu gateway sayfanın hangi sürümünü en son gördü" (PAGE-039, `plans/mobil-plantcare-acigi`
+ *   g-05): `page_get`, `page_schema_get`, `page_schema_patch`'in `newVersion`'ı ve `page_update`'in
+ *   kendi yazdığı sürüm hatırlanır; `page_update` `baseVersion` verilmediğinde onu gönderir. Hiç
+ *   okunmamış sayfaya sürümsüz tam gövde yazılmaz.
+ *
+ * SÜREÇ İÇİNDEDİR ve yalnız anahtar/sürüm tutar (gövde yok); `CaptureMemory` ile aynı halka:
+ * yeniden yazılan anahtar sona gider, en eskisi düşer.
+ */
+export function schemaReadKey(project, environment, pageId, version) {
+    return `${project}/${environment}/${pageId}@${version}`;
+}
+export function pageReadKey(project, environment, pageId) {
+    return `${project}/${environment}/${pageId}`;
+}
+export class SchemaReadMemory {
+    limit;
+    truncated = new Set();
+    versions = new Map();
+    constructor(limit = 200) {
+        this.limit = limit;
+    }
+    rememberVersion(key, version) {
+        this.versions.delete(key);
+        this.versions.set(key, version);
+        while (this.versions.size > this.limit) {
+            const oldest = this.versions.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.versions.delete(oldest);
+        }
+    }
+    lastVersion(key) {
+        return this.versions.get(key);
+    }
+    markTruncated(key) {
+        this.truncated.delete(key);
+        this.truncated.add(key);
+        while (this.truncated.size > this.limit) {
+            const oldest = this.truncated.values().next().value;
+            if (oldest === undefined)
+                break;
+            this.truncated.delete(oldest);
+        }
+    }
+    wasTruncated(key) {
+        return this.truncated.has(key);
+    }
+}
+/**
+ * SÜREÇ düzeyinde tek bellek: HTTP taşıması her POST için yeni bir gateway sunucusu kurduğundan
+ * (`sharedCaptureMemory` notu) okuma ile yazma ayrı `registerPageTools` çağrılarında koşar.
+ */
+export const sharedSchemaReadMemory = new SchemaReadMemory();

package/dist/platform/secrets.js

@@ -38,3 +38,12 @@ export function maskSecrets(payload) {
     const tokenRefs = {};
     return { payload: walk(payload, '', masked, tokenRefs, 0), masked, tokenRefs };
 }
+/**
+ * Serbest METİNDEKİ kimlik parçaları (konsol satırı, hata yığını): JWT biçimli dize ve `Bearer …`.
+ * `maskSecrets` anahtar adına bakar; tarayıcı konsolu anahtarsız düz metin taşır (g-06).
+ */
+export function maskSecretText(text) {
+    return text
+        .replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, `Bearer ${maskedValue}`)
+        .replace(/\b[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b/g, maskedValue);
+}

package/dist/platform/strictArguments.js

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { diagnosticsParam, runWithDiagnostics } from './diagnostics.js';
+import { applyArgumentAliases, closestArgument, runWithArgumentNotes } from './argumentAliases.js';
+import { BODY_FILE_ARGUMENTS, bodyFileParam, loadBodyFile } from './bodyFile.js';
+import { PlatformApiError } from './errors.js';
+import { logError } from '../observability/trace.js';
+/** Doğrulanmış argümanlara takılan çeviri notları (`ArgumentNotes`); JSON'a ve platform isteğine girmez. */
+const ARGUMENT_NOTES = Symbol('argumentNotes');
 /**
  * `writes`/`updates` açıklamalı ama KAYIT yazmayan tool'lar: çalıştırma, önizleme, dışa aktarma, indirme,
  * bağlantı testi. Yanıtlarında yazma tanılaması (silentlyDropped) yoktur; parametre yalnız tool listesini
@@ -25,25 +31,75 @@ function isRawShape(value) {
  * olmayan bir sorgu kusuruna yönlendirdi. Tek tek tool'lara alan eklemek sınıfı kapatmaz; sessizlik
  * burada, SDK'ya şema verilmeden önce kaldırılır.
  */
-export function rejectUnknownArguments(server) {
+export function rejectUnknownArguments(server, platform) {
     const registerTool = server.registerTool.bind(server);
+    // Zorunlu gövde argümanı `bodyFile` açıkken şemada isteğe bağlı yayınlanır (yoksa şemaya uyan istemci
+    // gövdeyi satır içinde yollamak zorunda kalır ve `bodyFile` "birlikte verilemez" ile reddedilirdi);
+    // zorunluluk dosya okunduktan sonra burada denetlenir.
+    const requiredBodies = new Map();
+    // g-07/g-08: `bodyFile` ve takma ad tablosu SDK'nın strict doğrulamasından ÖNCE koşmalı — sonra
+    // koşsa yanlış ad zaten reddedilmiş, dosyadan gelen gövde doğrulanmamış olur. SDK doğrulamayı
+    // `validateToolInput` içinde yapar; çeviri orada uygulanır ve notlar doğrulanmış argümanlara
+    // sembol anahtarla takılır.
+    if (platform) {
+        const validator = server;
+        const validate = validator.validateToolInput.bind(server);
+        validator.validateToolInput = async (tool, args, name) => {
+            try {
+                const loaded = await loadBodyFile(name, args, platform.config);
+                const requiredBody = requiredBodies.get(name);
+                if (requiredBody && loaded.args?.[requiredBody] === undefined) {
+                    throw new PlatformApiError(`${name}: '${requiredBody}' zorunlu — satır içinde ya da bodyFile ile (.json dosyası) verin. İstek gönderilmedi.`, 400);
+                }
+                const { args: aliased, applied } = await applyArgumentAliases(name, loaded.args, { platform, shape: tool.inputSchema?.shape ?? {} });
+                const parsed = await validate(tool, aliased, name);
+                const notes = { aliasesApplied: applied, ...(loaded.note ? { bodyFile: loaded.note } : {}) };
+                return (applied.length > 0 || loaded.note) && parsed && typeof parsed === 'object' ? Object.assign(parsed, { [ARGUMENT_NOTES]: notes }) : parsed;
+            }
+            catch (error) {
+                // Doğrulamadan önceki çeviri (dosya, takma ad) `handle`'ın dışında koşar: hata burada günlüğe yazılır.
+                if (error instanceof PlatformApiError)
+                    logError(error);
+                throw error;
+            }
+        };
+    }
     server.registerTool = ((name, config, callback) => {
         if (!isRawShape(config.inputSchema))
             return registerTool(name, config, callback);
-        // Yazma tool'ları tanılama kipini alır; parametre handler'a ULAŞMAZ (gövdeyi `...rest` ile
-        // platforma geçiren tool'larda sızardı), yalnız toolResult'ın okuduğu bağlama konur.
-        const writesDiagnostics = config.annotations?.readOnlyHint === false && config.annotations.destructiveHint !== true && !NON_WRITING_TOOLS.has(name);
-        const shape = writesDiagnostics ? { ...config.inputSchema, diagnostics: diagnosticsParam } : config.inputSchema;
-        const run = writesDiagnostics
-            ? ((args, extra) => {
-                const { diagnostics, ...rest } = args ?? {};
-                return runWithDiagnostics(diagnostics === 'full' ? 'full' : 'compact', () => callback(rest, extra));
-            })
-            : callback;
+        // Tanılama notları her tool'da compact döner (g-08: okuma ve çalıştırma yanıtında da 8 not +
+        // "N not daha"). `diagnostics` parametresi yalnız kayıt yazan tool'lara, microservice_execute'a ve
+        // *_preview'a açılır — ötekilerde tool listesini büyütmesin diye varsayılan kullanılır. Parametre
+        // handler'a ULAŞMAZ (gövdeyi `...rest` ile platforma geçiren tool'larda sızardı), yalnız
+        // toolResult'ın okuduğu bağlama konur.
+        const writesRecords = config.annotations?.readOnlyHint === false && config.annotations.destructiveHint !== true && !NON_WRITING_TOOLS.has(name);
+        const exposesDiagnostics = writesRecords || name === 'microservice_execute' || name.endsWith('_preview');
+        const bodyArgument = BODY_FILE_ARGUMENTS[name];
+        const bodySchema = bodyArgument ? config.inputSchema[bodyArgument] : undefined;
+        if (bodyArgument && bodySchema && !bodySchema.isOptional())
+            requiredBodies.set(name, bodyArgument);
+        const shape = {
+            ...config.inputSchema,
+            ...(bodyArgument && bodySchema ? { [bodyArgument]: bodySchema.optional(), bodyFile: bodyFileParam(bodyArgument) } : {}),
+            ...(exposesDiagnostics ? { diagnostics: diagnosticsParam } : {})
+        };
+        const invoke = (args, extra) => {
+            const { diagnostics, ...rest } = exposesDiagnostics ? args ?? {} : { ...args, diagnostics: undefined };
+            return runWithDiagnostics(diagnostics === 'full' ? 'full' : 'compact', () => callback(exposesDiagnostics ? rest : args, extra), exposesDiagnostics);
+        };
+        const run = (args, extra) => {
+            const { [ARGUMENT_NOTES]: notes, ...rest } = args ?? {};
+            return runWithArgumentNotes(notes ?? { aliasesApplied: [] }, () => invoke(rest, extra));
+        };
         const accepted = Object.keys(shape).join(', ');
+        const suggestions = (keys) => keys
+            .map(key => ({ key, near: closestArgument(key, Object.keys(shape)) }))
+            .filter(entry => entry.near !== undefined)
+            .map(entry => ` '${entry.key}' → '${entry.near}' mi demek istediniz?`)
+            .join('');
         const inputSchema = z.object(shape, {
             errorMap: (issue, context) => issue.code === 'unrecognized_keys'
-                ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.` }
+                ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.${suggestions(issue.keys)}` }
                 : { message: context.defaultError }
         }).strict();
         return registerTool(name, { ...config, inputSchema }, run);