tracy 2.12.0

Author: dg

tracy/cs/extensions.texy

@@ -104,6 +104,29 @@ Pokud má být výchozí stav sbalený, doplňte oběma elementům třídu `trac
 Counter použijte statický, aby se nevytvářely duplicitní ID na jedné stránce.
 
 
+Podpora AI agentů .{data-version:2.12}
+--------------------------------------
+
+Když prohlížeč ovládá AI agent, Tracy pošle markdown shrnutí Tracy Baru do JS konzole. Vlastní panely mohou nabídnout svůj markdown přidáním metody `getAgentInfo(): ?string` do třídy implementující `IBarPanel`:
+
+```php
+class DatabasePanel implements Tracy\IBarPanel
+{
+	public function getTab(): string { /* ... */ }
+	public function getPanel(): string { /* ... */ }
+
+	public function getAgentInfo(): ?string
+	{
+		return "## Database\n\n- Dotazy: {$this->count}\n- Celkový čas: {$this->time} ms\n";
+	}
+}
+```
+
+Vrácený markdown se zařadí do markdown shrnutí baru. Pokud metoda chybí nebo vrátí `null`, panel se ve shrnutí vynechá.
+
+Více v [integraci Tracy s AI agenty |guide#Podpora AI agentů].
+
+
 Rozšíření pro Bluescreen
 ========================
 

tracy/cs/guide.texy

@@ -182,6 +182,21 @@ Pokud používáte celý Nette Framework, lze toto a další nastavit v [konfigu
 Aby vám však nezaplavila e-mailovou schránku, pošle vždy **pouze jednu zprávu** a vytvoří soubor `email-sent`. Vývojář po přijetí e-mailové notifikace zkontroluje log, opraví aplikaci a smaže monitorovací soubor, čímž se opět aktivuje odesílání e-mailů.
 
 
+Podpora AI agentů .{data-version:2.12}
+======================================
+
+Když vaši aplikaci ovládá AI agent přes prohlížeč (Chrome DevTools MCP, Playwright, Puppeteer), Tracy jej detekuje podle JavaScriptové vlastnosti `navigator.webdriver` a posílá markdown verzi hlavních diagnostických výstupů do konzole prohlížeče vedle standardního UI:
+
+- **BlueScreen** – výjimka, stack trace a hodnoty proměnných se pošlou do `console.error()` vedle červené obrazovky, a to pro synchronní vykreslování i AJAXové chyby.
+- **Tracy Bar** – markdown shrnutí hlavních panelů (SQL, Errors, Dumps) se pošle do `console.log()`.
+- **`Debugger::dump()`** – plain text varianta vedle běžného HTML výpisu, aby dumpy nezůstaly pohřbené ve stránce.
+- **Produkční 500 stránka** – `console.error()` agentovi sdělí, že došlo k chybě a že její detaily jsou zalogované na serveru.
+
+Detekce nastaví cookie `tracy-webdriver=1`; pokud chcete markdown výstup vidět z normálního prohlížeče, cookie si nastavte ručně v DevTools. Aktivace agenta neovlivňuje `.md` sourozence, kteří se zapisují vedle každého `log/exception-*.html` bez podmínek – ti jsou vstupem pro dávkové zpracování produkčních logů.
+
+Vlastní panely Tracy Baru mohou nabídnout svůj markdown výstup implementací [`getAgentInfo()` |extensions#Podpora AI agentů]. Pro uživatele Claude Code obsahuje [Nette plugin |https://ai.nette.org/en/claude-code] skill `tracy-debugging`, který agentovi vysvětluje, jak číst Tracy výstup z `list_console_messages()`.
+
+
 Otevírání v editoru
 ===================
 

tracy/en/extensions.texy

@@ -104,6 +104,29 @@ If the default state is collapsed, add the class `tracy-collapsed` to both eleme
 Use a static counter to prevent duplicate IDs on one page.
 
 
+AI Agent Support .{data-version:2.12}
+-------------------------------------
+
+When an AI agent drives the browser, Tracy sends a markdown summary of the Tracy Bar to the JS console. Custom panels can supply their own markdown by adding a `getAgentInfo(): ?string` method to their `IBarPanel` implementation:
+
+```php
+class DatabasePanel implements Tracy\IBarPanel
+{
+	public function getTab(): string { /* ... */ }
+	public function getPanel(): string { /* ... */ }
+
+	public function getAgentInfo(): ?string
+	{
+		return "## Database\n\n- Queries: {$this->count}\n- Total time: {$this->time} ms\n";
+	}
+}
+```
+
+The returned markdown is included in the bar's markdown summary. When the method is missing or returns `null`, the panel is omitted from the summary.
+
+See [Tracy's AI agent integration |guide#AI Agent Support] for the full picture.
+
+
 Bluescreen Extensions
 =====================
 

tracy/en/guide.texy

@@ -182,6 +182,21 @@ If you use the entire Nette Framework, you can set this and others in the [confi
 To protect your e-mail box from being flooded, Tracy sends **only one message** and creates a file `email-sent`. When a developer receives the e-mail notification, they check the log, correct the application, and delete the `email-sent` monitoring file. This reactivates the e-mail sending.
 
 
+AI Agent Support .{data-version:2.12}
+=====================================
+
+When an AI agent drives your application through a browser (Chrome DevTools MCP, Playwright, Puppeteer), Tracy detects it via the JavaScript `navigator.webdriver` property and sends a markdown version of the key diagnostics into the browser console alongside the standard UI:
+
+- **BlueScreen** – exception, stack trace and variable values sent to `console.error()` next to the red screen, for both synchronous rendering and AJAX errors.
+- **Tracy Bar** – markdown summary of the main panels (SQL, Errors, Dumps) sent to `console.log()`.
+- **`Debugger::dump()`** – a plain text variant alongside the regular HTML output, so dumps don't get buried in the page.
+- **Production 500 page** – `console.error()` informs the agent that an error has occurred and that details have been logged on the server.
+
+Detection sets the cookie `tracy-webdriver=1`; you can set it manually in DevTools to enable the markdown output from a regular browser. Agent activation does not affect the `.md` siblings written next to every `log/exception-*.html` – those are produced unconditionally and form the basis for batch processing of production logs.
+
+Custom Tracy Bar panels can supply their own markdown by implementing [`getAgentInfo()` |extensions#AI Agent Support]. For Claude Code users, the [Nette plugin |https://ai.nette.org/en/claude-code] includes the `tracy-debugging` skill that teaches the agent how to read Tracy's output from `list_console_messages()`.
+
+
 Opening Files in the Editor
 ===========================