Skip to content

Commit e87be35

Browse files
mschristensenclaude
mschristensen
and
claude
committed
Restructure AI Transport information architecture
Replace the old section structure (token-streaming, sessions-identity, messaging, provider-specific guides) with a new IA organized around how-it-works, features, framework-guides, api-reference, and internals. Update the nav to reflect the new structure, rewrite the overview page with durable-session-layer positioning, and simplify getting-started pages. Reorder getting-started to lead with Vercel AI SDK. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 6fca126 commit e87be35

35 files changed

Lines changed: 586 additions & 18793 deletions

‎src/data/nav/aitransport.ts‎

Lines changed: 126 additions & 108 deletions
Original file line numberDiff line numberDiff line change
@@ -9,24 +9,50 @@ export default {
99
},
1010
content: [
1111
{
12-
name: 'About AI Transport',
12+
name: 'Overview',
1313
link: '/docs/ai-transport',
1414
index: true,
1515
},
16+
{
17+
name: 'Why AI Transport',
18+
link: '/docs/ai-transport/why-ai-transport',
19+
},
20+
{
21+
name: 'How it works',
22+
pages: [
23+
{
24+
name: 'Overview',
25+
link: '/docs/ai-transport/how-it-works',
26+
index: true,
27+
},
28+
{
29+
name: 'Sessions and turns',
30+
link: '/docs/ai-transport/how-it-works/sessions-and-turns',
31+
},
32+
{
33+
name: 'Transport',
34+
link: '/docs/ai-transport/how-it-works/transport',
35+
},
36+
{
37+
name: 'Authentication',
38+
link: '/docs/ai-transport/how-it-works/authentication',
39+
},
40+
],
41+
},
1642
{
1743
name: 'Getting started',
1844
pages: [
1945
{
20-
name: 'Anthropic',
21-
link: '/docs/ai-transport/getting-started/anthropic',
46+
name: 'Vercel AI SDK',
47+
link: '/docs/ai-transport/getting-started/vercel-ai-sdk',
2248
},
2349
{
2450
name: 'OpenAI',
2551
link: '/docs/ai-transport/getting-started/openai',
2652
},
2753
{
28-
name: 'Vercel AI SDK',
29-
link: '/docs/ai-transport/getting-started/vercel-ai-sdk',
54+
name: 'Anthropic',
55+
link: '/docs/ai-transport/getting-started/anthropic',
3056
},
3157
{
3258
name: 'LangGraph',
@@ -35,160 +61,152 @@ export default {
3561
],
3662
},
3763
{
38-
name: 'Token streaming',
64+
name: 'Framework guides',
3965
pages: [
4066
{
41-
name: 'Overview',
42-
link: '/docs/ai-transport/token-streaming',
43-
index: true,
67+
name: 'Vercel AI SDK',
68+
link: '/docs/ai-transport/framework-guides/vercel-ai-sdk',
4469
},
4570
{
46-
name: 'Message per response',
47-
link: '/docs/ai-transport/token-streaming/message-per-response',
71+
name: 'OpenAI',
72+
link: '/docs/ai-transport/framework-guides/openai',
4873
},
4974
{
50-
name: 'Message per token',
51-
link: '/docs/ai-transport/token-streaming/message-per-token',
75+
name: 'Anthropic',
76+
link: '/docs/ai-transport/framework-guides/anthropic',
5277
},
5378
{
54-
name: 'Token streaming limits',
55-
link: '/docs/ai-transport/token-streaming/token-rate-limits',
79+
name: 'LangGraph',
80+
link: '/docs/ai-transport/framework-guides/langgraph',
5681
},
5782
],
5883
},
5984
{
60-
name: 'Sessions & Identity',
85+
name: 'Features',
6186
pages: [
6287
{
63-
name: 'Overview',
64-
link: '/docs/ai-transport/sessions-identity',
88+
name: 'Token streaming',
89+
link: '/docs/ai-transport/features/token-streaming',
90+
},
91+
{
92+
name: 'Cancellation',
93+
link: '/docs/ai-transport/features/cancellation',
94+
},
95+
{
96+
name: 'Reconnection and recovery',
97+
link: '/docs/ai-transport/features/reconnection-and-recovery',
6598
},
6699
{
67-
name: 'Identifying users and agents',
68-
link: '/docs/ai-transport/sessions-identity/identifying-users-and-agents',
100+
name: 'Multi-device sessions',
101+
link: '/docs/ai-transport/features/multi-device',
69102
},
70103
{
71-
name: 'Online status',
72-
link: '/docs/ai-transport/sessions-identity/online-status',
104+
name: 'History and replay',
105+
link: '/docs/ai-transport/features/history',
106+
},
107+
{
108+
name: 'Conversation branching',
109+
link: '/docs/ai-transport/features/branching',
110+
},
111+
{
112+
name: 'Interruption and barge-in',
113+
link: '/docs/ai-transport/features/interruption',
114+
},
115+
{
116+
name: 'Concurrent turns',
117+
link: '/docs/ai-transport/features/concurrent-turns',
118+
},
119+
{
120+
name: 'Edit and regenerate',
121+
link: '/docs/ai-transport/features/edit-and-regenerate',
122+
},
123+
{
124+
name: 'Tool calling',
125+
link: '/docs/ai-transport/features/tool-calling',
126+
},
127+
{
128+
name: 'Human-in-the-loop',
129+
link: '/docs/ai-transport/features/human-in-the-loop',
130+
},
131+
{
132+
name: 'Optimistic updates',
133+
link: '/docs/ai-transport/features/optimistic-updates',
134+
},
135+
{
136+
name: 'Agent presence',
137+
link: '/docs/ai-transport/features/agent-presence',
73138
},
74139
{
75140
name: 'Push notifications',
76-
link: '/docs/ai-transport/sessions-identity/push-notifications',
141+
link: '/docs/ai-transport/features/push-notifications',
77142
},
78143
{
79-
name: 'Resuming sessions',
80-
link: '/docs/ai-transport/sessions-identity/resuming-sessions',
144+
name: 'Chain of thought',
145+
link: '/docs/ai-transport/features/chain-of-thought',
146+
},
147+
{
148+
name: 'Double texting',
149+
link: '/docs/ai-transport/features/double-texting',
81150
},
82151
],
83152
},
84153
{
85-
name: 'Messaging',
154+
name: 'API reference',
86155
pages: [
87156
{
88-
name: 'Accepting user input',
89-
link: '/docs/ai-transport/messaging/accepting-user-input',
157+
name: 'Overview',
158+
link: '/docs/ai-transport/api-reference',
159+
index: true,
90160
},
91161
{
92-
name: 'Tool calls',
93-
link: '/docs/ai-transport/messaging/tool-calls',
162+
name: 'Client transport',
163+
link: '/docs/ai-transport/api-reference/client-transport',
94164
},
95165
{
96-
name: 'Human-in-the-loop',
97-
link: '/docs/ai-transport/messaging/human-in-the-loop',
166+
name: 'Server transport',
167+
link: '/docs/ai-transport/api-reference/server-transport',
98168
},
99169
{
100-
name: 'Chain of thought',
101-
link: '/docs/ai-transport/messaging/chain-of-thought',
170+
name: 'React hooks',
171+
link: '/docs/ai-transport/api-reference/react-hooks',
172+
},
173+
{
174+
name: 'Vercel integration',
175+
link: '/docs/ai-transport/api-reference/vercel',
102176
},
103177
{
104-
name: 'Citations',
105-
link: '/docs/ai-transport/messaging/citations',
178+
name: 'Codec',
179+
link: '/docs/ai-transport/api-reference/codec',
106180
},
107181
{
108-
name: 'Completion and cancellation',
109-
link: '/docs/ai-transport/messaging/completion-and-cancellation',
182+
name: 'Error codes',
183+
link: '/docs/ai-transport/api-reference/error-codes',
110184
},
111185
],
112186
},
113187
{
114-
name: 'Guides',
115-
expand: true,
188+
name: 'Internals',
116189
pages: [
117190
{
118-
name: 'Anthropic',
119-
pages: [
120-
{
121-
name: 'Message per response',
122-
link: '/docs/ai-transport/guides/anthropic/anthropic-message-per-response',
123-
},
124-
{
125-
name: 'Message per token',
126-
link: '/docs/ai-transport/guides/anthropic/anthropic-message-per-token',
127-
},
128-
{
129-
name: 'Human-in-the-loop',
130-
link: '/docs/ai-transport/guides/anthropic/anthropic-human-in-the-loop',
131-
},
132-
{
133-
name: 'Citations',
134-
link: '/docs/ai-transport/guides/anthropic/anthropic-citations',
135-
},
136-
],
191+
name: 'Overview',
192+
link: '/docs/ai-transport/internals',
193+
index: true,
137194
},
138195
{
139-
name: 'OpenAI',
140-
pages: [
141-
{
142-
name: 'Message per response',
143-
link: '/docs/ai-transport/guides/openai/openai-message-per-response',
144-
},
145-
{
146-
name: 'Message per token',
147-
link: '/docs/ai-transport/guides/openai/openai-message-per-token',
148-
},
149-
{
150-
name: 'Human-in-the-loop',
151-
link: '/docs/ai-transport/guides/openai/openai-human-in-the-loop',
152-
},
153-
{
154-
name: 'Citations',
155-
link: '/docs/ai-transport/guides/openai/openai-citations',
156-
},
157-
],
196+
name: 'Wire protocol',
197+
link: '/docs/ai-transport/internals/wire-protocol',
158198
},
159199
{
160-
name: 'LangGraph',
161-
pages: [
162-
{
163-
name: 'Message per response',
164-
link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-response',
165-
},
166-
{
167-
name: 'Message per token',
168-
link: '/docs/ai-transport/guides/langgraph/langgraph-message-per-token',
169-
},
170-
{
171-
name: 'Human-in-the-loop',
172-
link: '/docs/ai-transport/guides/langgraph/langgraph-human-in-the-loop',
173-
},
174-
],
200+
name: 'Codec architecture',
201+
link: '/docs/ai-transport/internals/codec-architecture',
175202
},
176203
{
177-
name: 'Vercel AI SDK',
178-
pages: [
179-
{
180-
name: 'Message per response',
181-
link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-response',
182-
},
183-
{
184-
name: 'Message per token',
185-
link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-message-per-token',
186-
},
187-
{
188-
name: 'Human-in-the-loop',
189-
link: '/docs/ai-transport/guides/vercel-ai-sdk/vercel-human-in-the-loop',
190-
},
191-
],
204+
name: 'Conversation tree',
205+
link: '/docs/ai-transport/internals/conversation-tree',
206+
},
207+
{
208+
name: 'Transport patterns',
209+
link: '/docs/ai-transport/internals/transport-patterns',
192210
},
193211
],
194212
},

0 commit comments

Comments
 (0)