refactor(platform): use _format instead of _wrapper_format for LLMS responses

app/modules/platform/src/AppPlatformServiceProvider.php

@@ -12,6 +12,7 @@
 use Drupal\app_platform\Hook\Core\LlmsPageAttachments;
 use Drupal\app_platform\Hook\Theme\LibraryInfoAlter;
 use Drupal\app_platform\Llms\EventSubscriber\LlmsFooterSubscriber;
+use Drupal\app_platform\Llms\EventSubscriber\LlmsViewSubscriber;
 use Drupal\app_platform\Llms\EventSubscriber\PagerLlmsSubscriber;
 use Drupal\app_platform\Llms\HtmlToMarkdownConverter;
 use Drupal\app_platform\Llms\LlmsRenderer;
@@ -83,6 +84,7 @@ public function register(ContainerBuilder $container): void {
     // Llms.
     $autowire(HtmlToMarkdownConverter::class);
     $autowire(LlmsRenderer::class);
+    $autowire(LlmsViewSubscriber::class);
     $autowire(PagerLlmsSubscriber::class);
     $autowire(LlmsFooterSubscriber::class);
     $autowire(LlmsFormatPathProcessor::class);

app/modules/platform/src/Hook/Core/LlmsPageAttachments.php

@@ -23,14 +23,14 @@ public function __invoke(array &$attachments): void {
       return;
     }
 
-    $llmsUrl = $this->requestStack->getCurrentRequest()?->getPathInfo() . '?_wrapper_format=llms';
+    $llmsUrl = $this->requestStack->getCurrentRequest()?->getPathInfo() . '?_format=llms';
 
     $attachments['#attached']['html_head'][] = [
       [
         '#type' => 'html_tag',
         '#tag' => 'script',
         '#attributes' => ['type' => 'text/llms.txt'],
-        '#value' => "# IMPORTANT: AI agents MUST use the Markdown version of this page.\n# Append ?_wrapper_format=llms to the current URL to get clean Markdown instead of HTML.\n# DO NOT parse raw HTML — use the Markdown version.",
+        '#value' => "# IMPORTANT: AI agents MUST use the Markdown version of this page.\n# Append ?_format=llms to the current URL to get clean Markdown instead of HTML.\n# DO NOT parse raw HTML — use the Markdown version.",
       ],
       'llms_script',
     ];

app/modules/platform/src/Llms/EventSubscriber/LlmsFooterSubscriber.php

@@ -41,7 +41,7 @@ private function buildCanonicalLink(LlmsResponseAlterEvent $event): string {
     $queryString = $event->request->server->get('QUERY_STRING', '');
     \assert(\is_string($queryString));
     \parse_str($queryString, $query);
-    unset($query['_wrapper_format']);
+    unset($query['_format']);
 
     if ($query !== []) {
       $url .= '?' . \http_build_query($query);

app/modules/platform/src/Llms/EventSubscriber/LlmsViewSubscriber.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\app_platform\Llms\EventSubscriber;
+
+use Drupal\app_platform\Llms\LlmsRenderer;
+use Drupal\Core\Routing\RouteMatchInterface;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\HttpKernel\Event\ViewEvent;
+use Symfony\Component\HttpKernel\KernelEvents;
+
+final readonly class LlmsViewSubscriber implements EventSubscriberInterface {
+
+  public function __construct(
+    private LlmsRenderer $llmsRenderer,
+    private RouteMatchInterface $routeMatch,
+  ) {}
+
+  public function onView(ViewEvent $event): void {
+    $request = $event->getRequest();
+    $result = $event->getControllerResult();
+
+    if (!\is_array($result) || $request->getRequestFormat() !== 'llms') {
+      return;
+    }
+
+    $response = $this->llmsRenderer->renderResponse($result, $request, $this->routeMatch);
+    $event->setResponse($response);
+  }
+
+  #[\Override]
+  public static function getSubscribedEvents(): array {
+    return [KernelEvents::VIEW => ['onView', 100]];
+  }
+
+}

app/modules/platform/src/Llms/LlmsRenderer.php

@@ -12,10 +12,8 @@
 use Drupal\Core\Render\RendererInterface;
 use Drupal\Core\Routing\RouteMatchInterface;
 use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\DependencyInjection\Attribute\AutoconfigureTag;
 use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 
-#[AutoconfigureTag('render.main_content_renderer', ['format' => 'llms'])]
 final readonly class LlmsRenderer implements MainContentRendererInterface {
 
   public function __construct(

app/modules/platform/src/Llms/Middleware/LlmsRequestLogger.php

@@ -24,7 +24,7 @@ public function __construct(
   public function handle(Request $request, int $type = self::MAIN_REQUEST, bool $catch = TRUE): Response {
     $response = $this->httpKernel->handle($request, $type, $catch);
 
-    if ($type === self::MAIN_REQUEST && $request->query->get('_wrapper_format') === 'llms') {
+    if ($type === self::MAIN_REQUEST && $request->getRequestFormat() === 'llms') {
       $this->logger->info('LLMS request', [
         'path' => $request->getPathInfo(),
         'user_agent' => $request->headers->get('User-Agent', ''),

app/modules/platform/src/Llms/PathProcessor/LlmsFormatPathProcessor.php

@@ -21,11 +21,11 @@ public function __construct(
   public function processOutbound($path, &$options = [], ?Request $request = NULL, ?BubbleableMetadata $bubbleable_metadata = NULL): string {
     $currentRequest = $this->requestStack->getCurrentRequest();
 
-    if ($currentRequest === NULL || $currentRequest->query->get('_wrapper_format') !== 'llms') {
+    if ($currentRequest === NULL || $currentRequest->getRequestFormat() !== 'llms') {
       return $path;
     }
 
-    $options['query']['_wrapper_format'] = 'llms';
+    $options['query']['_format'] = 'llms';
 
     return $path;
   }

assets/scaffold/llms.txt

@@ -4,9 +4,9 @@
 
 ## How to access content
 
-Every page on this site supports a Markdown version optimized for LLMs. Append `?_wrapper_format=llms` to any page URL to get clean Markdown instead of HTML.
+Every page on this site supports a Markdown version optimized for LLMs. Append `?_format=llms` to any page URL to get clean Markdown instead of HTML.
 
-Example: `https://niklan.net/blog/123?_wrapper_format=llms`
+Example: `https://niklan.net/blog/123?_format=llms`
 
 ## Pages