AIT-578: Scaffold new AI Transport docs IA

src/data/nav/aitransport.ts

@@ -13,182 +13,213 @@ export default {
       link: '/docs/ai-transport',
       index: true,
     },
+    {
+      name: 'Why AI Transport',
+      link: '/docs/ai-transport/why-ai-transport',
+    },
+    {
+      name: 'How it works',
+      pages: [
+        {
+          name: 'Overview',
+          link: '/docs/ai-transport/how-it-works',
+          index: true,
+        },
+        {
+          name: 'Sessions',
+          link: '/docs/ai-transport/how-it-works/sessions',
+        },
+        {
+          name: 'Transport',
+          link: '/docs/ai-transport/how-it-works/transport',
+        },
+        {
+          name: 'Turns',
+          link: '/docs/ai-transport/how-it-works/turns',
+        },
+      ],
+    },
+    {
+      name: 'Authentication',
+      link: '/docs/ai-transport/authentication',
+    },
     {
       name: 'Getting started',
       pages: [
         {
           name: 'Anthropic',
           link: '/docs/ai-transport/getting-started/anthropic',
         },
-        {
-          name: 'OpenAI',
-          link: '/docs/ai-transport/getting-started/openai',
-        },
         {
           name: 'Vercel AI SDK',
           link: '/docs/ai-transport/getting-started/vercel-ai-sdk',
         },
         {
-          name: 'LangGraph',
-          link: '/docs/ai-transport/getting-started/langgraph',
+          name: 'Custom integration',
+          link: '/docs/ai-transport/getting-started/custom',
         },
       ],
     },
     {
-      name: 'Token streaming',
+      name: 'Framework guides',
       pages: [
         {
-          name: 'Overview',
-          link: '/docs/ai-transport/token-streaming',
-          index: true,
-        },
-        {
-          name: 'Message per response',
-          link: '/docs/ai-transport/token-streaming/message-per-response',
+          name: 'Anthropic',
+          link: '/docs/ai-transport/framework-guides/anthropic',
         },
         {
-          name: 'Message per token',
-          link: '/docs/ai-transport/token-streaming/message-per-token',
+          name: 'Vercel AI SDK',
+          link: '/docs/ai-transport/framework-guides/vercel-ai-sdk',
         },
         {
-          name: 'Token streaming limits',
-          link: '/docs/ai-transport/token-streaming/token-rate-limits',
+          name: 'Custom integration',
+          link: '/docs/ai-transport/framework-guides/custom',
         },
       ],
     },
     {
-      name: 'Sessions & Identity',
+      name: 'Features',
       pages: [
         {
-          name: 'Overview',
-          link: '/docs/ai-transport/sessions-identity',
+          name: 'Token streaming',
+          link: '/docs/ai-transport/features/token-streaming',
+        },
+        {
+          name: 'Reconnection and recovery',
+          link: '/docs/ai-transport/features/reconnection-and-recovery',
+        },
+        {
+          name: 'Tool calls',
+          link: '/docs/ai-transport/features/tool-calls',
+        },
+        {
+          name: 'Human-in-the-loop',
+          link: '/docs/ai-transport/features/human-in-the-loop',
+        },
+        {
+          name: 'Chain of thought',
+          link: '/docs/ai-transport/features/chain-of-thought',
+        },
+        {
+          name: 'Citations',
+          link: '/docs/ai-transport/features/citations',
         },
         {
-          name: 'Identifying users and agents',
-          link: '/docs/ai-transport/sessions-identity/identifying-users-and-agents',
+          name: 'Cancel',
+          link: '/docs/ai-transport/features/cancel',
         },
         {
-          name: 'Online status',
-          link: '/docs/ai-transport/sessions-identity/online-status',
+          name: 'Steer mid-stream',
+          link: '/docs/ai-transport/features/steer-mid-stream',
+        },
+        {
+          name: 'History and replay',
+          link: '/docs/ai-transport/features/history-and-replay',
+        },
+        {
+          name: 'Agent presence and health',
+          link: '/docs/ai-transport/features/agent-presence-and-health',
         },
         {
           name: 'Push notifications',
-          link: '/docs/ai-transport/sessions-identity/push-notifications',
+          link: '/docs/ai-transport/features/push-notifications',
+        },
+        {
+          name: 'Multi-device sessions',
+          link: '/docs/ai-transport/features/multi-device-sessions',
         },
         {
-          name: 'Resuming sessions',
-          link: '/docs/ai-transport/sessions-identity/resuming-sessions',
+          name: 'Multi-user sessions',
+          link: '/docs/ai-transport/features/multi-user-sessions',
         },
       ],
     },
     {
-      name: 'Messaging',
+      name: 'Use cases and demos',
       pages: [
         {
-          name: 'Accepting user input',
-          link: '/docs/ai-transport/messaging/accepting-user-input',
+          name: 'Support chat',
+          link: '/docs/ai-transport/use-cases/support-chat',
         },
+      ],
+    },
+    {
+      name: 'Examples',
+      link: '/docs/ai-transport/examples',
+    },
+    {
+      name: 'Going to production',
+      pages: [
         {
-          name: 'Tool calls',
-          link: '/docs/ai-transport/messaging/tool-calls',
+          name: 'Pricing and cost control',
+          link: '/docs/ai-transport/going-to-production/pricing-and-cost-control',
         },
         {
-          name: 'Human-in-the-loop',
-          link: '/docs/ai-transport/messaging/human-in-the-loop',
+          name: 'Limits',
+          link: '/docs/ai-transport/going-to-production/limits',
         },
         {
-          name: 'Chain of thought',
-          link: '/docs/ai-transport/messaging/chain-of-thought',
+          name: 'Compliance',
+          link: '/docs/ai-transport/going-to-production/compliance',
         },
         {
-          name: 'Citations',
-          link: '/docs/ai-transport/messaging/citations',
+          name: 'Production checklist',
+          link: '/docs/ai-transport/going-to-production/production-checklist',
         },
         {
-          name: 'Completion and cancellation',
-          link: '/docs/ai-transport/messaging/completion-and-cancellation',
+          name: 'Monitoring and observability',
+          link: '/docs/ai-transport/going-to-production/monitoring-and-observability',
         },
       ],
     },
     {
-      name: 'Guides',
-      expand: true,
+      name: 'API reference',
       pages: [
         {
-          name: 'Anthropic',
-          pages: [
-            {
-              name: 'Message per response',
-              link: '/docs/ai-transport/guides/anthropic/anthropic-message-per-response',
-            },
-            {
-              name: 'Message per token',
-              link: '/docs/ai-transport/guides/anthropic/anthropic-message-per-token',
-            },
-            {
-              name: 'Human-in-the-loop',
-              link: '/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop',
-            },
-            {
-              name: 'Citations',
-              link: '/docs/ai-transport/guides/anthropic/anthropic-citations',
-            },
-          ],
-        },
-        {
-          name: 'OpenAI',
-          pages: [
-            {
-              name: 'Message per response',
-              link: '/docs/ai-transport/guides/openai/openai-message-per-response',
-            },
-            {
-              name: 'Message per token',
-              link: '/docs/ai-transport/guides/openai/openai-message-per-token',
-            },
-            {
-              name: 'Human-in-the-loop',
-              link: '/docs/ai-transport/guides/openai/openai-human-in-the-loop',
-            },
-            {
-              name: 'Citations',
-              link: '/docs/ai-transport/guides/openai/openai-citations',
-            },
-          ],
-        },
-        {
-          name: 'LangGraph',
-          pages: [
-            {
-              name: 'Message per response',
-              link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-response',
-            },
-            {
-              name: 'Message per token',
-              link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-token',
-            },
-            {
-              name: 'Human-in-the-loop',
-              link: '/docs/ai-transport/guides/langgraph/langgraph-human-in-the-loop',
-            },
-          ],
+          name: 'Client transport API',
+          link: '/docs/ai-transport/api-reference/client-transport-api',
         },
         {
-          name: 'Vercel AI SDK',
-          pages: [
-            {
-              name: 'Message per response',
-              link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response',
-            },
-            {
-              name: 'Message per token',
-              link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token',
-            },
-            {
-              name: 'Human-in-the-loop',
-              link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-human-in-the-loop',
-            },
-          ],
+          name: 'Server transport API',
+          link: '/docs/ai-transport/api-reference/server-transport-api',
+        },
+        {
+          name: 'React hooks',
+          link: '/docs/ai-transport/api-reference/react-hooks',
+        },
+        {
+          name: 'Codec API',
+          link: '/docs/ai-transport/api-reference/codec-api',
+        },
+        {
+          name: 'Error codes',
+          link: '/docs/ai-transport/api-reference/error-codes',
+        },
+      ],
+    },
+    {
+      name: 'Internals',
+      pages: [
+        {
+          name: 'Overview',
+          link: '/docs/ai-transport/internals',
+          index: true,
+        },
+        {
+          name: 'Codec architecture',
+          link: '/docs/ai-transport/internals/codec-architecture',
+        },
+        {
+          name: 'Wire protocol',
+          link: '/docs/ai-transport/internals/wire-protocol',
+        },
+        {
+          name: 'Transport patterns',
+          link: '/docs/ai-transport/internals/transport-patterns',
+        },
+        {
+          name: 'Event mapping',
+          link: '/docs/ai-transport/internals/event-mapping',
         },
       ],
     },

src/pages/docs/ai-transport/api-reference/client-transport-api.mdx

@@ -0,0 +1,6 @@
+---
+title: "Client transport API"
+meta_description: "API reference for the AI Transport client SDK, including connection management, message handling, and event subscriptions."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/api-reference/codec-api.mdx

@@ -0,0 +1,6 @@
+---
+title: "Codec API"
+meta_description: "API reference for AI Transport codecs, including message encoding, decoding, and custom codec implementation."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/api-reference/error-codes.mdx

@@ -0,0 +1,6 @@
+---
+title: "Error codes"
+meta_description: "Reference for AI Transport error codes, including descriptions, causes, and recommended resolution steps."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/api-reference/react-hooks.mdx

@@ -0,0 +1,6 @@
+---
+title: "React hooks"
+meta_description: "API reference for AI Transport React hooks, including useTransport, useSession, and useStream."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/api-reference/server-transport-api.mdx

@@ -0,0 +1,6 @@
+---
+title: "Server transport API"
+meta_description: "API reference for the AI Transport server SDK, including stream management, tool call handling, and session lifecycle."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/authentication.mdx

@@ -0,0 +1,8 @@
+---
+title: "Authentication"
+meta_description: "Configure authentication for AI Transport, including token-based auth, identifying users and agents, and securing sessions."
+redirect_from:
+  - /docs/ai-transport/sessions-identity/identifying-users-and-agents
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/examples/index.mdx

@@ -0,0 +1,6 @@
+---
+title: "Examples"
+meta_description: "Browse AI Transport code examples and sample applications for common integration patterns."
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/features/agent-presence-and-health.mdx

@@ -0,0 +1,8 @@
+---
+title: "Agent presence and health"
+meta_description: "Monitor AI agent online status and health using AI Transport's presence features."
+redirect_from:
+  - /docs/ai-transport/sessions-identity/online-status
+---
+
+This page is a stub. Content to be written separately.

src/pages/docs/ai-transport/features/cancel.mdx

@@ -0,0 +1,8 @@
+---
+title: "Cancel"
+meta_description: "Cancel in-progress AI agent responses using AI Transport, enabling users to stop generation mid-stream."
+redirect_from:
+  - /docs/ai-transport/messaging/completion-and-cancellation
+---
+
+This page is a stub. Content to be written separately.