Fix docs SEO metadata and crawlability

apps/website/content/docs/agent/concepts/agent-architecture.mdx

@@ -609,7 +609,7 @@ export class DebugTimelineComponent {
 ```
 
 <Callout type="tip" title="Time-travel is branching">
-When you submit from a previous checkpoint, LangGraph creates a new branch from that point. The original timeline is preserved. The `branch()` signal tells you which branch is currently active. See the [Time Travel guide](/docs/guides/time-travel) for the full walkthrough.
+When you submit from a previous checkpoint, LangGraph creates a new branch from that point. The original timeline is preserved. The `branch()` signal tells you which branch is currently active. See the [Time Travel guide](/docs/agent/guides/time-travel) for the full walkthrough.
 </Callout>
 
 ## Choosing an Architecture
@@ -682,22 +682,22 @@ Begin with a single agent and tools. Add human-in-the-loop when you need approva
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Learn the graph, node, and edge primitives that agents are built on.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Stream token-by-token responses with multiple stream modes.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Build human-in-the-loop approval flows that pause and resume agents.
   </Card>
-  <Card title="Subgraphs" href="/docs/guides/subgraphs">
+  <Card title="Subgraphs" href="/docs/agent/guides/subgraphs">
     Compose multi-agent systems with orchestrators and specialist workers.
   </Card>
-  <Card title="Time Travel" href="/docs/guides/time-travel">
+  <Card title="Time Travel" href="/docs/agent/guides/time-travel">
     Debug agents by stepping through checkpoint history and branching.
   </Card>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     How Signals power the reactive model behind agent().
   </Card>
 </CardGroup>

apps/website/content/docs/agent/concepts/angular-signals.mdx

@@ -527,22 +527,22 @@ Signals use referential equality (`===`) by default. agent() creates new array r
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="State Management" href="/docs/concepts/state-management">
+  <Card title="State Management" href="/docs/agent/concepts/state-management">
     How LangGraph agent state flows into Angular Signals and how to structure complex state.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Configure stream modes, handle token-by-token rendering, and manage concurrent streams.
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Understand the Python agent patterns that produce the events Signals consume.
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Full reference for every Signal, method, and option on LangGraphAgent.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Build human-in-the-loop approval flows that pause and resume the agent.
   </Card>
-  <Card title="OnPush Guide" href="/docs/guides/change-detection">
+  <Card title="OnPush Guide" href="/docs/agent/concepts/angular-signals">
     Deep dive into change detection optimization for streaming applications.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/concepts/langgraph-basics.mdx

@@ -363,22 +363,22 @@ Both APIs produce the same output and work identically with agent(). Choose the
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Agent Architecture" href="/docs/concepts/agent-architecture">
+  <Card title="Agent Architecture" href="/docs/agent/concepts/agent-architecture">
     Deep dive into the planning, tool-calling, and execution lifecycle
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Stream token-by-token responses with multiple stream modes
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Build human-in-the-loop approval flows
   </Card>
-  <Card title="Subgraphs" href="/docs/guides/subgraphs">
+  <Card title="Subgraphs" href="/docs/agent/guides/subgraphs">
     Compose multi-agent systems with orchestrators
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Thread-based conversation persistence
   </Card>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     How Signals power agent's reactive model
   </Card>
 </CardGroup>

apps/website/content/docs/agent/concepts/state-management.mdx

@@ -361,7 +361,7 @@ const branch = agent.branch();               // Signal<string> — active branch
 const branchTree = agent.experimentalBranchTree();
 ```
 
-For full checkpoint and time-travel patterns, see the [Persistence guide](/docs/guides/persistence) and [Time Travel guide](/docs/guides/time-travel).
+For full checkpoint and time-travel patterns, see the [Persistence guide](/docs/agent/guides/persistence) and [Time Travel guide](/docs/agent/guides/time-travel).
 
 ## Custom State Fields
 
@@ -520,22 +520,22 @@ readonly reportTitle = computed(() => this.agent.value().report?.title ?? '');
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     How agent() uses Angular Signals for zero-subscription reactive rendering.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Configure stream modes — values, messages, events — for different use cases.
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Thread-based conversation persistence and checkpoint configuration.
   </Card>
-  <Card title="Time Travel" href="/docs/guides/time-travel">
+  <Card title="Time Travel" href="/docs/agent/guides/time-travel">
     Fork threads at any checkpoint and replay with different input.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Human-in-the-loop approval flows and how interrupt state surfaces in Angular.
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Nodes, edges, and the graph execution model behind the state machine.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/getting-started/installation.mdx

@@ -123,16 +123,16 @@ console.log(test.status()); // 'idle' - setup is correct
 ## Next steps
 
 <CardGroup cols={2}>
-  <Card title="Quick Start" href="/docs/getting-started/quickstart">
+  <Card title="Quick Start" href="/docs/agent/getting-started/quickstart">
     Build your first chat component in 5 minutes
   </Card>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     Understand how Signals power agent
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Graphs, nodes, edges, and state for Angular developers
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Complete agent() function reference
   </Card>
 </CardGroup>

apps/website/content/docs/agent/getting-started/introduction.mdx

@@ -307,31 +307,31 @@ Your Angular app is a stateless client. All agent state — threads, checkpoints
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Quick Start" href="/docs/getting-started/quickstart">
+  <Card title="Quick Start" href="/docs/agent/getting-started/quickstart">
     Detailed 5-minute walkthrough with a complete chat component
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Token-by-token updates, stream modes, and status tracking
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Thread persistence across sessions and reactive thread switching
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Human-in-the-loop approval and confirmation flows
   </Card>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Deterministic testing with MockAgentTransport
   </Card>
   <Card title="Lifecycle Signals" href="/docs/agent/guides/lifecycle">
     Subscribe to per-agent lifecycle signals via AGENT_LIFECYCLE
   </Card>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     Deep dive into how Signals power agent
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Graphs, nodes, edges, and state for Angular developers
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Complete agent() function reference
   </Card>
 </CardGroup>

apps/website/content/docs/agent/getting-started/quickstart.mdx

@@ -3,7 +3,7 @@
 Build a streaming chat component with agent() in 5 minutes.
 
 <Callout type="info" title="Prerequisites">
-Angular 20+ project with Node.js 18+. If you need setup help, see the [Installation](/docs/getting-started/installation) guide.
+Angular 20+ project with Node.js 18+. If you need setup help, see the [Installation](/docs/agent/getting-started/installation) guide.
 </Callout>
 
 <Steps>
@@ -129,22 +129,22 @@ Open `http://localhost:4200` and start chatting with your agent.
 ## Next steps
 
 <CardGroup cols={3}>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Learn about token-by-token updates and stream modes
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Keep conversations alive across page refreshes
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Add human-in-the-loop approval flows
   </Card>
-  <Card title="Angular Signals" href="/docs/concepts/angular-signals">
+  <Card title="Angular Signals" href="/docs/agent/concepts/angular-signals">
     Deep dive into how Signals power agent
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Graphs, nodes, edges, and state for Angular developers
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Complete agent() function reference
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/deployment.mdx

@@ -408,22 +408,22 @@ Confirm LangSmith traces are arriving and set up alerts for error rate spikes an
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Test agent interactions deterministically before deploying to production.
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Store thread IDs so users can resume conversations across sessions.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Tune streaming options like throttle and stream modes for production performance.
   </Card>
-  <Card title="LangGraph Basics" href="/docs/concepts/langgraph-basics">
+  <Card title="LangGraph Basics" href="/docs/agent/concepts/langgraph-basics">
     Understand the agent patterns your deployment will serve.
   </Card>
-  <Card title="API Reference" href="/docs/api/provide-angular">
+  <Card title="API Reference" href="/docs/agent/api/provide-agent">
     Full reference for provideAgent configuration options.
   </Card>
-  <Card title="Error Handling" href="/docs/guides/error-handling">
+  <Card title="Error Handling" href="/docs/agent/guides/deployment">
     Deep dive into error recovery patterns beyond basic error boundaries.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/interrupts.mdx

@@ -546,16 +546,16 @@ Because interrupts are checkpointed, the user can close their browser, come back
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Memory" href="/docs/guides/memory">
+  <Card title="Memory" href="/docs/agent/guides/memory">
     Give your agent short-term and long-term memory with the Store API.
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Configure checkpointers that keep interrupt state across deployments.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Stream token-by-token responses alongside interrupt events.
   </Card>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Script interrupt events deterministically with MockAgentTransport.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/memory.mdx

@@ -397,16 +397,16 @@ Use hierarchical namespaces like `("memories", user_id)` or `("project", project
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Configure checkpointers and thread storage for production deployments.
   </Card>
-  <Card title="Time Travel" href="/docs/guides/time-travel">
+  <Card title="Time Travel" href="/docs/agent/guides/time-travel">
     Replay and branch agent runs from any past checkpoint.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Pause for human input before the agent acts on its memory.
   </Card>
-  <Card title="State Management" href="/docs/concepts/state-management">
+  <Card title="State Management" href="/docs/agent/concepts/state-management">
     How agent state flows from LangGraph into Angular Signals.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/persistence.mdx

@@ -336,16 +336,16 @@ Setting the `threadId` signal (or calling `switchThread()`) loads the target thr
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Pause agent execution and wait for human approval before continuing.
   </Card>
-  <Card title="Memory" href="/docs/guides/memory">
+  <Card title="Memory" href="/docs/agent/guides/memory">
     Preserve long-term context across sessions with LangGraph's memory store.
   </Card>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Stream token-by-token responses and tool progress in real time.
   </Card>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Test thread persistence and switching deterministically with MockAgentTransport.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/streaming.mdx

@@ -240,16 +240,16 @@ Each call to `chat.submit()` opens a new SSE connection. Connections are automat
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Resume conversations across page reloads using thread IDs and checkpointers.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Pause agent execution mid-stream to collect human input before continuing.
   </Card>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Unit-test components that use agent with the built-in test harness.
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Full option reference for agent(), including all configuration keys.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/subgraphs.mdx

@@ -284,16 +284,16 @@ Use **subagents** when tasks are independent and can run in parallel, when each
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Understand how agent() surfaces tokens, status, and errors in real time.
   </Card>
-  <Card title="Time Travel" href="/docs/guides/time-travel">
+  <Card title="Time Travel" href="/docs/agent/guides/time-travel">
     Inspect earlier states and replay alternate execution paths with checkpoint history.
   </Card>
-  <Card title="Testing" href="/docs/guides/testing">
+  <Card title="Testing" href="/docs/agent/guides/testing">
     Write unit and integration tests for orchestrator graphs and subagent interactions.
   </Card>
-  <Card title="API Reference" href="/docs/api/angular">
+  <Card title="API Reference" href="/docs/agent/api/agent">
     Full reference for agent() options, signals, and subagent configuration.
   </Card>
 </CardGroup>

apps/website/content/docs/agent/guides/testing.mdx

@@ -515,16 +515,16 @@ Integration tests hit a real server and (potentially) a real LLM. Reserve them f
 ## What's Next
 
 <CardGroup cols={2}>
-  <Card title="Streaming" href="/docs/guides/streaming">
+  <Card title="Streaming" href="/docs/agent/guides/streaming">
     Understand the SSE event model your tests simulate.
   </Card>
-  <Card title="Interrupts" href="/docs/guides/interrupts">
+  <Card title="Interrupts" href="/docs/agent/guides/interrupts">
     Build human-in-the-loop approval flows tested with scripted interrupt events.
   </Card>
-  <Card title="Persistence" href="/docs/guides/persistence">
+  <Card title="Persistence" href="/docs/agent/guides/persistence">
     Thread persistence patterns that pair with thread-switching tests.
   </Card>
-  <Card title="API Reference" href="/docs/api/mock-stream-transport">
+  <Card title="API Reference" href="/docs/agent/api/mock-stream-transport">
     Full reference for MockAgentTransport options and methods.
   </Card>
 </CardGroup>