Bar: added support for AI agents

Author: dg

src/Tracy/Bar/Bar.php

@@ -104,6 +104,11 @@ public function render(DeferredContent $defer): void
 				require __DIR__ . '/dist/loader.phtml';
 			}
 		}
+
+		if (Helpers::isAgent() && Helpers::isHtmlMode() && !Helpers::isRedirect()) {
+			$nonceAttr = ($nonce = Helpers::getNonce()) ? ' nonce="' . Helpers::escapeHtml($nonce) . '"' : '';
+			echo '<script' . $nonceAttr . '>console.log(' . json_encode($this->renderAgent()) . ');</script>';
+		}
 	}
 
 
@@ -160,4 +165,22 @@ private function renderPanels(string $suffix = ''): array
 		restore_error_handler();
 		return $panels;
 	}
+
+
+	/**
+	 * Captures debug bar as plain text (markdown) for AI agents.
+	 */
+	public function renderAgent(): string
+	{
+		$time = number_format((microtime(true) - Debugger::$time) * 1000, 1);
+		$memory = number_format(memory_get_peak_usage() / 1_000_000, 2);
+		$parts = ["Tracy Bar | $time ms | $memory MB"];
+		foreach ($this->panels as $panel) {
+			if (method_exists($panel, 'getAgentInfo') && ($text = $panel->getAgentInfo()) !== null) {
+				$parts[] = $text;
+			}
+		}
+
+		return implode("\n\n", $parts) . "\n";
+	}
 }

src/Tracy/Bar/DefaultBarPanel.php

@@ -42,4 +42,15 @@ public function getPanel(): string
 			}
 		});
 	}
+
+
+	public function getAgentInfo(): ?string
+	{
+		return is_file(__DIR__ . "/dist/{$this->id}.agent.phtml")
+			? Helpers::capture(function () {
+				$data = $this->data;
+				require __DIR__ . "/dist/{$this->id}.agent.phtml";
+			})
+			: null;
+	}
 }

src/Tracy/Bar/IBarPanel.php

@@ -10,6 +10,7 @@
 
 /**
  * Tracy Bar panel providing a tab label and optional panel content.
+ * @method ?string getAgentInfo() Returns markdown summary for AI agents.
  */
 interface IBarPanel
 {

src/Tracy/Bar/dist/warnings.agent.phtml

@@ -0,0 +1,10 @@
+<?php declare(strict_types=1); ?>
+<?php /** @var array<string, int|null> $data */ ?>
+<?php if (!$data) { return; } ?>
+## Warnings
+
+<?php foreach ($data as $item => $count): ?>
+<?php [$file, $line, $message] = explode('|', $item, 3) ?>
+- <?= $message . ' in ' . $file . ':' . $line . ($count > 1 ? " (×" . $count . ')' : '') ?>
+
+<?php endforeach ?>

src/Tracy/Bar/panels/warnings.agent.latte

@@ -0,0 +1,8 @@
+{varType array<string, int|null> $data}
+{exitIf !$data}
+## Warnings
+
+{foreach $data as $item => $count}
+	{do [$file, $line, $message] = explode('|', $item, 3)}
+	- {=$message . ' in ' . $file . ':' . $line . ($count > 1 ? " (×" . $count . ')' : '')}
+{/foreach}

tests/Tracy/Bar.renderAgent().phpt

@@ -0,0 +1,51 @@
+<?php
+
+/**
+ * Test: Tracy\Bar::renderAgent()
+ */
+
+declare(strict_types=1);
+
+use Tester\Assert;
+use Tracy\Debugger;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test('info line with time and memory', function () {
+	Debugger::$productionMode = false;
+	Debugger::$time = microtime(true) - 0.05; // simulate 50 ms
+	$bar = Debugger::getBar();
+	Assert::match(
+		"Tracy Bar | %a% ms | %a% MB\n",
+		$bar->renderAgent(),
+	);
+});
+
+
+test('warnings rendering', function () {
+	$bar = new Tracy\Bar;
+	$panel = new Tracy\DefaultBarPanel('warnings');
+	$panel->data = [
+		'/app/foo.php|10|Notice: Undefined variable $x' => 3,
+		'/app/bar.php|25|Deprecated: implode()' => 1,
+	];
+	$bar->addPanel($panel, 'Tracy:warnings');
+
+	Assert::match(
+		"Tracy Bar | %a% ms | %a% MB\n\n## Warnings\n\n- Notice: Undefined variable \$x in /app/foo.php:10 (\u{00d7}3)\n- Deprecated: implode() in /app/bar.php:25\n\n",
+		$bar->renderAgent(),
+	);
+});
+
+
+test('no warnings section when empty', function () {
+	$bar = new Tracy\Bar;
+	$panel = new Tracy\DefaultBarPanel('warnings');
+	$bar->addPanel($panel, 'Tracy:warnings');
+
+	Assert::match(
+		"Tracy Bar | %a% ms | %a% MB\n",
+		$bar->renderAgent(),
+	);
+});