@appaflytech/zeyrek-ai-mcp 0.0.7 → 0.0.9

package/dist/platform/domSummary.js

@@ -0,0 +1,144 @@
+/**
+ * NE GÖRÜNÜYOR — resimsiz.
+ *
+ * 2026-09-16 raporu: bir koşuda 58 PNG okundu ve bağlam maliyetinin %67'si buydu; tek bir tam
+ * sayfa karesi 800 bin karakter. Karelerin çoğunda aranan şey TEK bir olguydu — "kart göründü mü,
+ * tablo doldu mu, hata var mı". Bu modül o soruyu satır satır metinle cevaplar: "problem_card
+ * (card) · GİZLİ" 200 karakterdir.
+ *
+ * Katman saftır: tarayıcıdan gelen anlık görüntüyü doğrular ve biçimler. Toplama işi
+ * `screenshot.ts` `domSummaryScript`'te, sunum `pages.ts`'te.
+ */
+function text(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function parseNode(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const value = raw;
+    if (typeof value.elementId !== 'string' || value.elementId.length === 0)
+        return undefined;
+    const errors = Array.isArray(value.errors)
+        ? value.errors.filter((entry) => typeof entry === 'string')
+        : undefined;
+    return {
+        elementId: value.elementId,
+        ...(text(value.type) === undefined ? {} : { type: String(value.type) }),
+        visible: value.visible === true,
+        inViewport: value.inViewport === true,
+        ...(text(value.text) === undefined ? {} : { text: String(value.text) }),
+        ...(typeof value.rows === 'number' && Number.isFinite(value.rows) ? { rows: value.rows } : {}),
+        ...(text(value.activeTab) === undefined ? {} : { activeTab: String(value.activeTab) }),
+        ...(text(value.value) === undefined ? {} : { value: String(value.value) }),
+        ...(value.empty === true ? { empty: true } : {}),
+        ...(errors && errors.length > 0 ? { errors } : {})
+    };
+}
+/** Tarayıcıdan dönen değer gerçekten özet mi; `parseReadiness` ile aynı karar kalıbı. */
+export function parseDomSummary(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const value = raw;
+    if (!Array.isArray(value.nodes))
+        return undefined;
+    const messages = Array.isArray(value.messages)
+        ? value.messages
+            .map(entry => (entry && typeof entry === 'object' ? entry : undefined))
+            .filter((entry) => entry !== undefined)
+            .map(entry => ({ kind: String(entry.kind ?? 'message'), text: String(entry.text ?? '') }))
+            .filter(entry => entry.text.length > 0)
+        : [];
+    return {
+        nodes: value.nodes.map(parseNode).filter((node) => node !== undefined),
+        messages,
+        truncated: value.truncated === true,
+        typed: value.typed === true
+    };
+}
+export function summaryStats(summary) {
+    return {
+        nodes: summary.nodes.length,
+        hidden: summary.nodes.filter(node => !node.visible).length,
+        empty: summary.nodes.filter(node => node.empty === true).length,
+        errors: summary.nodes.reduce((total, node) => total + (node.errors?.length ?? 0), 0),
+        messages: summary.messages.length
+    };
+}
+/**
+ * Compact kip: düğüm başına TEK satır. Ajan bu satırı okuyup kareyi hiç açmadan karar verebilmeli,
+ * o yüzden sıra sabit ve alan adları kısa: kimlik (tip) · görünürlük · metin · sayımlar.
+ */
+export function summaryLines(summary) {
+    const stats = summaryStats(summary);
+    const head = `nodes ${stats.nodes} · hidden ${stats.hidden} · empty ${stats.empty} · errors ${stats.errors} · messages ${stats.messages}`;
+    const body = summary.nodes.map(node => {
+        const parts = [node.type === undefined ? node.elementId : `${node.elementId} (${node.type})`];
+        parts.push(node.visible ? (node.inViewport ? 'visible' : 'ekran dışı') : 'GİZLİ');
+        if (node.text !== undefined)
+            parts.push(`"${node.text}"`);
+        if (node.rows !== undefined)
+            parts.push(`rows=${node.rows}`);
+        if (node.activeTab !== undefined)
+            parts.push(`tab=${node.activeTab}`);
+        if (node.value !== undefined)
+            parts.push(`value=${node.value}`);
+        if (node.empty === true)
+            parts.push('BOŞ');
+        if (node.errors !== undefined)
+            parts.push(`errors=${node.errors.length}`);
+        return parts.join(' · ');
+    });
+    const tail = summary.messages.map(message => `! ${message.kind}: ${message.text}`);
+    return [head, ...body, ...tail];
+}
+const COMPARED = ['visible', 'inViewport', 'text', 'rows', 'activeTab', 'value', 'empty'];
+/**
+ * `errors` METİNLE karşılaştırılır, sayıyla değil: "Ad zorunludur" → "E-posta geçersiz"
+ * değişiminde sayı 1→1 kalıyor, fark boş çıkıyor ve yanıt "yapısal bir değişiklik yok" diyordu
+ * (B-9). Mesajın kendisi doğrulamanın konusu olabilir.
+ */
+function fieldValue(node, field) {
+    if (field === 'errors')
+        return node.errors === undefined ? undefined : node.errors.join(' · ');
+    return node[field];
+}
+/**
+ * "Önceki kareye göre ne değişti" — S-7. Fark PİKSEL değil DOM düzeyindedir: ajan aynı sayfayı
+ * yeniden koştururken 150 bin karakterlik kareyi tekrar okumak yerine bu listeyi okur.
+ */
+export function diffSummaries(previous, next) {
+    const before = new Map(previous.nodes.map(node => [node.elementId, node]));
+    const after = new Map(next.nodes.map(node => [node.elementId, node]));
+    const changed = [];
+    let unchanged = 0;
+    for (const [elementId, node] of after) {
+        const old = before.get(elementId);
+        if (old === undefined)
+            continue;
+        const fields = [...COMPARED, 'errors'].filter(field => fieldValue(old, field) !== fieldValue(node, field));
+        if (fields.length === 0) {
+            unchanged += 1;
+            continue;
+        }
+        for (const field of fields) {
+            changed.push({
+                elementId,
+                field,
+                ...(fieldValue(old, field) === undefined ? {} : { from: fieldValue(old, field) }),
+                ...(fieldValue(node, field) === undefined ? {} : { to: fieldValue(node, field) })
+            });
+        }
+    }
+    const previousMessages = previous.messages.map(message => message.text);
+    const nextMessages = next.messages.map(message => message.text);
+    return {
+        added: [...after.keys()].filter(elementId => !before.has(elementId)),
+        removed: [...before.keys()].filter(elementId => !after.has(elementId)),
+        changed,
+        messages: {
+            added: nextMessages.filter(text => !previousMessages.includes(text)),
+            removed: previousMessages.filter(text => !nextMessages.includes(text))
+        },
+        unchanged
+    };
+}

package/dist/platform/http.js

@@ -42,8 +42,16 @@ function appendQuery(url, query) {
         if (value === undefined || value === null || value === '')
             continue;
         if (Array.isArray(value)) {
-            for (const entry of value)
-                url.searchParams.append(key, String(entry));
+            if (value.some(entry => entry !== null && typeof entry === 'object')) {
+                url.searchParams.append(key, JSON.stringify(value));
+            }
+            else {
+                for (const entry of value)
+                    url.searchParams.append(key, String(entry));
+            }
+        }
+        else if (typeof value === 'object') {
+            url.searchParams.append(key, JSON.stringify(value));
         }
         else {
             url.searchParams.append(key, String(value));