improve llms text experience (#575)

Author: Devon-White

.gitignore

@@ -23,6 +23,7 @@ specs/tsp-output
 .cursorignore
 temp
 .env
+.vscode
 
 npm-debug.log*
 yarn-debug.log*

website/config/pluginsConfig/docusaurus-plugin-llms-txt.ts

@@ -8,8 +8,7 @@
 */
 
 import { PluginConfig } from '@docusaurus/types';
-// @ts-ignore - ESM/CJS compatibility issue
-import type { PluginOptions } from '@signalwire/docusaurus-plugin-llms-txt/public';
+import type { Options as PluginOptions } from '@signalwire/docusaurus-plugin-llms-txt';
 export const llmsTxtPlugin: PluginConfig = [
   "@signalwire/docusaurus-plugin-llms-txt",
   {
@@ -46,6 +45,7 @@ export const llmsTxtPlugin: PluginConfig = [
         "/assets/**",
         "/404.html",
         "/media/**" ,
+        "/search",
         "/"
       ],
     },
@@ -68,17 +68,60 @@ export const llmsTxtPlugin: PluginConfig = [
           id: 'swml',
           name: 'SWML Documentation',
           description: 'The SignalWire Markup Language which allows developers to create communication applications with simple JSON & YAML documents.',
-          position: 1,
+          position: 0,
           routes: [
             {
               route: '/swml/**'
             }
           ]
         },
+        {
+          id: 'sdks',
+          name: 'SDKs',
+          description: 'SignalWire Software Development Kits for building real-time communication applications.',
+          position: 0,
+          routes: [
+            {
+              route: '/sdks/**'
+            }
+          ],
+          subsections: [
+            {
+              id: 'agents-sdk',
+              name: 'Agents SDK',
+              description: 'Build AI-powered voice and messaging applications with the SignalWire Agents SDK.',
+              routes: [
+                {
+                  route: '/sdks/agents-sdk/**'
+                }
+              ]
+            },
+            {
+              id: 'browser-sdk',
+              name: 'Browser SDK',
+              description: 'Build WebRTC-based applications with the SignalWire Browser SDK.',
+              routes: [
+                {
+                  route: '/sdks/browser-sdk/**'
+                }
+              ]
+            },
+            {
+              id: 'realtime-sdk',
+              name: 'Realtime SDK',
+              description: 'Build real-time communication applications from your backend with the SignalWire Realtime SDK.',
+              routes: [
+                {
+                  route: '/sdks/realtime-sdk/**'
+                }
+              ]
+            }
+          ]
+        },
         {
           id: 'api-ref',
           name: 'API OpenAPI Spec',
-          description: 'The OpenAPI Spec defiitions.',
+          description: 'The OpenAPI Spec definitions.',
           position: 1,
           routes: []
         },
@@ -88,11 +131,71 @@ export const llmsTxtPlugin: PluginConfig = [
     processing: {
 
       attachments: [
+        {
+          source: '../specs/swml/tsp-output/@typespec/json-schema/SWMLObject.json',
+          title: 'SWML JSON Schema',
+          description: "The JSON Schema definition for SWML (SignalWire Markup Language).",
+          sectionId: "swml"
+        },
+        {
+          source: '../specs/compatibility-api/_spec_.yaml',
+          title: 'Compatibility API Spec',
+          description: "The OpenAPI spec for the SignalWire Compatibility API.",
+          sectionId: "api-ref"
+        },
         {
           source: '../specs/signalwire-rest/calling-api/tsp-output/@typespec/openapi3/openapi.yaml',
           title: 'Calling API Spec',
           description: "The OpenAPI spec for the SignalWire Calling API.",
           sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/chat-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Chat API Spec',
+          description: "The OpenAPI spec for the SignalWire Chat API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/datasphere-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'DataSphere API Spec',
+          description: "The OpenAPI spec for the SignalWire DataSphere API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/fabric-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Fabric API Spec',
+          description: "The OpenAPI spec for the SignalWire Fabric API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/fax-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Fax API Spec',
+          description: "The OpenAPI spec for the SignalWire Fax API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/logs-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Logs API Spec',
+          description: "The OpenAPI spec for the SignalWire Logs API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/message-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Message API Spec',
+          description: "The OpenAPI spec for the SignalWire Message API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/pubsub-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'PubSub API Spec',
+          description: "The OpenAPI spec for the SignalWire PubSub API.",
+          sectionId: "api-ref"
+        },
+        {
+          source: '../specs/signalwire-rest/voice-api/tsp-output/@typespec/openapi3/openapi.yaml',
+          title: 'Voice API Spec',
+          description: "The OpenAPI spec for the SignalWire Voice API.",
+          sectionId: "api-ref",
         }
       ]
     },