Instructions to use botezx/flagtldr with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Grok
How to use botezx/flagtldr with Grok:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
Download scripts/e2e/summary043.mjs from botezx/flagtldr: direct link, hf CLI and curl.
- Browser
- Download file 15.1 kB
-
https://huggingface.co/botezx/flagtldr/resolve/main/scripts/e2e/summary043.mjs
- Command line
-
hf download hf://botezx/flagtldr/scripts/e2e/summary043.mjs
-
curl -L -o summary043.mjs https://huggingface.co/botezx/flagtldr/resolve/main/scripts/e2e/summary043.mjs
15.1 kB
| // v0.4.3 e2e – hybrid default, bug-2 regression (unrelated timeline neighbours), TEZA / INFORMACJA paths, top-N toggle. | |
| // 1) a stored 0.4.2 default replySource "grok" is migrated to HYBRID: verified replies + link + the same rules; | |
| // header "Dostarczono N odpowiedzi (z M znanych) · Grok doczytuje wątek wg tych samych zasad"; badge "Teza" | |
| // 2) botex-human's bug: /home timeline (stale branch TweetDetail in the cache + unrelated posts), click @przyklad_autor | |
| // -> 0 unrelated replies and 0 false context in the prompt (GraphQL and DOM-only) | |
| // 3) own status page with X's "Discover more" heading + unrelated posts below (DOM-only) -> only the subtree | |
| // 4) INFORMACJA path (mock flag path=info): badge, summary block, facts, blue reply cards; forced path setting | |
| // 6) botex-human's real double insert (17:48): a late copy (newlines removed + newlines as spaces) lands AFTER the insert | |
| // settle -> caught by the final pre-send check: cleared + re-inserted once -> ONE copy sent; on every insertion -> abort | |
| // 5) top-N toggle (summaryTopArgs) + screenshots docs/screenshots/0.4.3-*.png (light + dark, both paths) | |
| // node summary043.mjs <chrome> | |
| import puppeteer from "puppeteer-core"; | |
| import fs from "node:fs"; | |
| import path from "node:path"; | |
| import { fileURLToPath } from "node:url"; | |
| import { setTimeout as sleep } from "node:timers/promises"; | |
| const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../.."); | |
| const EXT = process.env.EXT_DIR || path.join(ROOT, "extension"); | |
| const SHOTS = path.join(ROOT, "docs", "screenshots"); | |
| const CHROME = process.env.CHROME || process.argv[2]; | |
| const log = (...a) => console.log("[summary043-e2e]", ...a); | |
| const assert = (c, m) => { if (!c) throw new Error("ASSERT: " + m); }; | |
| const UNRELATED = ["kawa_memy", "ogrodnik_pt", "node_newsy", "serwis_info", "pytania_mat", "odpisujacy", "watek_start"]; | |
| const browser = await puppeteer.launch({ | |
| executablePath: CHROME, headless: true, | |
| args: [`--disable-extensions-except=${EXT}`, `--load-extension=${EXT}`, | |
| "--host-resolver-rules=MAP x.com 127.0.0.1:8443", "--ignore-certificate-errors", "--no-sandbox", "--window-size=1280,900", "--lang=pl"], | |
| defaultViewport: { width: 1280, height: 900 }, | |
| }); | |
| try { | |
| const sw = await browser.waitForTarget((t) => t.type() === "service_worker" && t.url().endsWith("service-worker.js"), { timeout: 15000 }); | |
| const extId = new URL(sw.url()).host; | |
| const opt = await browser.newPage(); | |
| await opt.goto(`chrome-extension://${extId}/src/options/options.html`); | |
| await opt.waitForFunction(() => document.getElementById("systemPrompt").value.length > 0); | |
| const set = (o) => opt.evaluate(async (oo) => { const { settings } = await chrome.storage.local.get("settings"); await chrome.storage.local.set({ settings: { ...settings, ...oo } }); }, o); | |
| // a 0.4.2 options page saved its default "grok" (no 0.4.3 flag) -> migrated to hybrid | |
| await set({ provider: "grok-auto", grokContext: "iframe", geoEnabled: false, replySource: "grok" }); | |
| const s0 = await opt.evaluate(() => chrome.runtime.sendMessage({ type: "getSettings" })); | |
| assert(s0.replySource === "hybrid" && s0.summaryTopArgs === 3 && s0.summaryPath === "auto", "defaults/migration: " + JSON.stringify([s0.replySource, s0.summaryTopArgs, s0.summaryPath])); | |
| await opt.reload(); await opt.waitForFunction(() => document.getElementById("systemPrompt").value.length > 0); | |
| const o = await opt.evaluate(() => ({ src: document.getElementById("replySource").value, opts: [...document.querySelectorAll("#replySource option")].map((x) => x.textContent), | |
| top: document.getElementById("summaryTopArgs").value, path: document.getElementById("summaryPath").value, rules: document.getElementById("replyRulesDefault").textContent })); | |
| log("options:", JSON.stringify(o)); | |
| assert(o.src === "hybrid" && o.opts.length === 3 && /hybrydowo \(domyślnie\)/.test(o.opts[0]) && o.top === "3" && o.path === "auto", "options page"); | |
| assert(/najwyżej 150 odpowiedzi/.test(o.rules), "options: generated rules"); | |
| const x = await browser.newPage(); | |
| const errors = []; x.on("pageerror", (e) => errors.push(String(e))); | |
| const mock = (p) => x.evaluate((u) => fetch(u).then((r) => r.text()), p); | |
| const sent = async () => JSON.parse(await mock("/__mock/grok-stats")); | |
| async function summarizePost(url, id, flags = "") { | |
| await x.goto(url, { waitUntil: "networkidle0" }); | |
| await x.evaluate((f) => { localStorage.setItem("mockGrokFlags", f); }, flags); | |
| await mock("/__mock/grok-stats?reset"); | |
| await x.waitForFunction((i) => [...document.querySelectorAll("article")].some((a) => a.querySelector(`a[href$="/status/${i}"]`) && a.querySelector(".xa-summary-btn")), { timeout: 15000 }, id); | |
| await x.evaluate((i) => [...document.querySelectorAll("article")].find((a) => a.querySelector(`a[href$="/status/${i}"]`)).querySelector(".xa-summary-btn").click(), id); | |
| await x.waitForFunction(() => document.querySelector(".xa-result-host")?.shadowRoot.querySelector(".body[data-render]"), { timeout: 60000 }); | |
| await sleep(1500); | |
| const r = await x.evaluate(() => { const r = document.querySelector(".xa-result-host").shadowRoot, b = r.querySelector(".xs-path"); | |
| const col = (k) => [...r.querySelectorAll(`.xs-col.${k} .xs-card`)].map((c) => ({ hidden: c.hidden, t: c.innerText })); | |
| return { meta: r.querySelector(".meta").textContent, text: r.querySelector(".card").innerText, render: r.querySelector(".body").dataset.render, | |
| badge: b && !b.hidden ? b.textContent : null, pro: col("pro"), con: col("con"), info: col("info"), | |
| toggles: [...r.querySelectorAll(".xs-toggle")].map((t) => t.textContent), summary: r.querySelector(".xs-summary")?.innerText || null, | |
| facts: r.querySelectorAll(".xs-facts li").length, questions: r.querySelectorAll(".xs-questions li").length }; }); | |
| const g = await sent(); | |
| return { ...r, sent: g.count, prompt: g.prompts[0] || "" }; | |
| } | |
| // 1) hybrid default on the branch page, post A (301) | |
| const a = await summarizePost("https://x.com/teza_autor/status/300?conv=branch", "301"); | |
| log("hybrid meta:", a.meta, "| badge", a.badge, "| ZA", a.pro.length, "PRZECIW", a.con.length); | |
| fs.writeFileSync("/tmp/xa-043-hybrid-prompt.txt", a.prompt); | |
| assert(a.sent === 1, "one message"); | |
| assert(/^Dostarczono 3 odpowiedzi \(z \d+ znanych\) · Grok doczytuje wątek wg tych samych zasad/.test(a.meta), "hybrid header: " + a.meta); | |
| assert(a.prompt.includes("TEZA (wpis wybrany):\nhttps://x.com/sceptyk/status/301\n@sceptyk"), "prompt: link + focal"); | |
| assert(/ZASADY WYBORU ODPOWIEDZI/.test(a.prompt) && /DOCZYTAJ WĄTEK:/.test(a.prompt) && /Kolejność: od najczęściej polubionych \(malejąco\), najwyżej 150 odpowiedzi/.test(a.prompt), "prompt: rules + read-the-thread"); | |
| assert(/ODPOWIEDZI DOSTARCZONE PRZEZ ROZSZERZENIE \(3 z \d+ znanych na X\):/.test(a.prompt) && /https:\/\/x\.com\/\w+\/status\/30[2-5]/.test(a.prompt), "prompt: supplied replies with links"); | |
| for (const t of ["Gałąź B", "Odp. B1"]) assert(!a.prompt.includes(t), "no sibling branch in the prompt: " + t); | |
| assert(a.badge === "Teza" && a.render === "sections", "badge Teza"); | |
| // 2) botex-human's bug: the home timeline | |
| for (const ng of ["", "&nograph=1"]) { | |
| const t = await summarizePost(`https://x.com/home?conv=timeline${ng}`, "510"); | |
| const leaked = UNRELATED.filter((h) => t.prompt.includes("@" + h)); | |
| log(`timeline${ng}: meta "${t.meta}" leaked:`, leaked.join(",") || "none"); | |
| assert(t.sent === 1 && leaked.length === 0, "unrelated handles in the prompt: " + leaked.join(",")); | |
| assert(!/KONTEKST NADRZĘDNY|WPIS NADRZĘDNY/.test(t.prompt), "no false parent context"); | |
| assert(/^Dostarczono 0 odpowiedzi/.test(t.meta), "0 supplied: " + t.meta); | |
| assert(t.prompt.includes("https://x.com/przyklad_autor/status/510"), "the link lets Grok read the real replies"); | |
| } | |
| // 2b) botex-human's 2nd reported case (17:48), invented accounts: focal @autorka_wpisu 2113570000000000001 on the home timeline, @kanal_tech (Starlink) | |
| // right above it, unrelated posts below – 0 false replies, 0 false context | |
| const FOCAL2 = ["badacz_ml", "gadzety_en", "ciekawski_1", "jesien_krk", "rysownik_pl", "pytajacy_2", "live_inwest", "kanal_tech"]; | |
| for (const ng of ["", "&nograph=1"]) { | |
| const k = await summarizePost(`https://x.com/home?conv=timeline&tl=focal2${ng}`, "2113570000000000001"); | |
| const leaked = FOCAL2.filter((h) => k.prompt.includes("@" + h)); | |
| log(`focal2${ng}: meta "${k.meta}" leaked:`, leaked.join(",") || "none"); | |
| assert(k.sent === 1 && leaked.length === 0, "focal2: unrelated handles in the prompt: " + leaked.join(",")); | |
| assert(!/KONTEKST NADRZĘDNY|WPIS NADRZĘDNY|Starlink/.test(k.prompt), "focal2: no false parent context"); | |
| assert(/^Dostarczono 0 odpowiedzi/.test(k.meta), "focal2: 0 supplied: " + k.meta); | |
| assert(k.prompt.includes("https://x.com/autorka_wpisu/status/2113570000000000001"), "focal2: link to the focal"); | |
| } | |
| // 3) own status page, DOM only, with "Odkryj więcej" + unrelated posts below the conversation | |
| const d = await summarizePost("https://x.com/sceptyk/status/301?conv=branch&nograph=1&layout=x", "301"); | |
| const dLeak = UNRELATED.concat(["przyklad_autor"]).filter((h) => d.prompt.includes("@" + h)); | |
| log("own page DOM-only meta:", d.meta, "leaked:", dLeak.join(",") || "none"); | |
| assert(dLeak.length === 0, "layout=x: nothing below the heading"); | |
| assert(!/KONTEKST NADRZĘDNY/.test(d.prompt), "no DOM context"); | |
| assert(/^Dostarczono 3 odpowiedzi/.test(d.meta) && ["Odp. A1:", "Odp. A1a:", "Odp. A2:"].every((t) => d.prompt.includes(t)) && !d.prompt.includes("Odp. B1"), "own page DOM-only: A's subtree supplied"); | |
| // 4) INFORMACJA path chosen by "Grok" (mock flag) + forced path | |
| const i = await summarizePost("https://x.com/teza_autor/status/300?conv=branch", "300", "path=info"); | |
| log("info: badge", i.badge, "| summary", JSON.stringify(i.summary), "| facts", i.facts, "| cards", i.info.length, "| toggles", JSON.stringify(i.toggles)); | |
| assert(i.badge === "Informacja" && i.summary && /^streszczenie/i.test(i.summary) && i.info.length >= 1 && i.pro.length === 0, "INFORMACJA panel"); | |
| await set({ summaryPath: "informacja" }); | |
| const f = await summarizePost("https://x.com/teza_autor/status/300?conv=branch", "301"); | |
| log("forced:", f.badge, JSON.stringify(f.prompt.slice(-160))); | |
| assert(/\n\nWYMUSZONY TRYB: odpowiedz ścieżką INFORMACJA – pierwsza linia: ## TRYB: INFORMACJA\.$/.test(f.prompt) && f.badge === "Informacja", "forced path informacja"); | |
| await set({ summaryPath: "teza" }); | |
| const f2 = await summarizePost("https://x.com/teza_autor/status/300?conv=branch", "300", "path=info"); | |
| assert(/WYMUSZONY TRYB: odpowiedz ścieżką TEZA/.test(f2.prompt) && f2.badge === "Teza", "forced path teza beats the post type"); | |
| await set({ summaryPath: "auto" }); | |
| // 5) top-N toggle on the whole conversation (post 300) + screenshots | |
| const shoot = async (name) => { const host = await x.$(".xa-result-host"); await host.screenshot({ path: path.join(SHOTS, name) }); }; | |
| for (const theme of ["light", "dark"]) { | |
| const dk = theme === "dark" ? "&theme=dark" : ""; | |
| await set({ summaryTopArgs: 2 }); | |
| const t = await summarizePost(`https://x.com/teza_autor/status/300?conv=branch${dk}`, "300"); | |
| const cols = [["pro", t.pro], ["con", t.con]]; | |
| log(theme, "teza: ZA", t.pro.map((c) => c.hidden ? "h" : "v").join(""), "PRZECIW", t.con.map((c) => c.hidden ? "h" : "v").join(""), "toggles", JSON.stringify(t.toggles)); | |
| for (const [, cs] of cols) assert(cs.filter((c) => !c.hidden).length === Math.min(2, cs.length), "top 2 visible"); | |
| assert(t.toggles.length === cols.filter(([, cs]) => cs.length > 2).length && t.toggles.every((s) => /^Pokaż wszystkie \(\d+\)$/.test(s)), "toggle per long section"); | |
| await shoot(`0.4.3-teza-top-${theme}.png`); | |
| if (t.toggles.length) { | |
| await x.evaluate(() => document.querySelector(".xa-result-host").shadowRoot.querySelector(".xs-toggle").click()); | |
| const after = await x.evaluate(() => { const r = document.querySelector(".xa-result-host").shadowRoot, b = r.querySelector(".xs-toggle"); return { label: b.textContent, hidden: b.closest(".xs-col").querySelectorAll(".xs-card[hidden]").length }; }); | |
| assert(after.label === "Zwiń" && after.hidden === 0, "expanded: " + JSON.stringify(after)); | |
| await shoot(`0.4.3-teza-all-${theme}.png`); | |
| } | |
| await set({ summaryTopArgs: 3 }); | |
| const inf = await summarizePost(`https://x.com/teza_autor/status/300?conv=branch${dk}`, "300", "path=info"); | |
| assert(inf.badge === "Informacja", "info badge " + theme); | |
| await shoot(`0.4.3-informacja-${theme}.png`); | |
| } | |
| log("screenshots 0.4.3-teza-top/all-{light,dark}.png, 0.4.3-informacja-{light,dark}.png"); | |
| // 6) late double insert (pre-send guard) | |
| await set({ diagEnabled: true }); | |
| const sw$ = (m) => opt.evaluate((mm) => chrome.runtime.sendMessage(mm), m); | |
| const nows = (t) => String(t || "").replace(/\s+/g, ""); | |
| const copiesOf = (t) => nows(t).split(nows("ZASADY WYBORU ODPOWIEDZI")).length - 1; | |
| await summarizePost("https://x.com/teza_autor/status/300?conv=branch", "301", "duplate"); | |
| const gl = await sent(), runL = (await sw$({ type: "getDiagReport" })).runs.at(-1), insL = runL?.grokPage?.insert || {}; | |
| log("duplate: sent", gl.count, "copies", copiesOf(gl.prompts[0]), "insert", JSON.stringify({ c: insL.preSendCheck, r: insL.preSendReinserted, w: insL.preSendWaitMs })); | |
| assert(gl.count === 1 && copiesOf(gl.prompts[0]) === 1, "late double never sent"); | |
| assert(insL.preSendReinserted === true && insL.preSendCheck === "ok" && insL.preSendWaitMs >= 500, "diag: pre-send guard re-inserted once"); | |
| // every insertion doubles late -> abort with an error, nothing sent | |
| await x.goto("https://x.com/teza_autor/status/300?conv=branch", { waitUntil: "networkidle0" }); | |
| await x.evaluate(() => localStorage.setItem("mockGrokFlags", "dupalways")); | |
| await mock("/__mock/grok-stats?reset"); | |
| await x.waitForFunction(() => [...document.querySelectorAll("article")].some((a) => a.querySelector('a[href$="/status/301"]') && a.querySelector(".xa-summary-btn")), { timeout: 15000 }); | |
| await x.evaluate(() => [...document.querySelectorAll("article")].find((a) => a.querySelector('a[href$="/status/301"]')).querySelector(".xa-summary-btn").click()); | |
| await x.waitForFunction(() => /podwójnie/.test(document.querySelector(".xa-result-host")?.shadowRoot.innerHTML || ""), { timeout: 60000 }); | |
| await sleep(2500); | |
| const ga = await sent(); | |
| const errTxt = await x.evaluate(() => document.querySelector(".xa-result-host").shadowRoot.querySelector(".card")?.innerText || ""); | |
| log("dupalways: sent", ga.count, "| error:", errTxt.replace(/\s+/g, " ").slice(0, 160)); | |
| assert(ga.count === 0, "dupalways: nothing sent"); | |
| await x.evaluate(() => localStorage.setItem("mockGrokFlags", "")); | |
| for (const p of await browser.pages()) if (/\/i\/grok/.test(p.url())) await p.close().catch(() => {}); | |
| assert(errors.length === 0, "page errors: " + errors.join("; ")); | |
| log("OK"); | |
| } finally { await browser.close(); } | |