docs(falcon-ai): add Imagine feature page

src/lib/navigation.ts

@@ -321,6 +321,7 @@ export const tabNavigation: NavTab[] = [
             title: 'Features',
             items: [
               { title: 'Using Falcon AI', href: '/docs/falcon-ai/features/chat' },
+              { title: 'Imagine', href: '/docs/falcon-ai/features/imagine' },
               { title: 'Skill Builder', href: '/docs/falcon-ai/features/skills' },
               { title: 'MCP Connectors', href: '/docs/falcon-ai/features/mcp-connectors' },
             ]

src/pages/docs/falcon-ai/features/imagine.mdx

@@ -0,0 +1,131 @@
+---
+title: "Imagine"
+description: "AI-powered trace visualization builder. Chat with Falcon AI to turn any trace into an interactive dashboard, then save the view to replay on every future trace."
+---
+
+## About
+
+Imagine is a custom dashboard builder for traces. You describe what you want to see in plain English, Falcon AI assembles the widgets against the current trace, and the resulting dashboard can be saved as a template that applies to any future trace.
+
+A dashboard is a layout of widgets: charts, tables, metric cards, span trees, markdown summaries. Building one by hand means writing custom code or running queries one at a time. Imagine replaces that with chat, then makes the result reusable so the same trace investigation can run on every trace your team opens later.
+
+---
+
+## Opening Imagine
+
+Open any trace from the Tracing dashboard, then click the **Imagine** tab in the trace detail drawer. The toolbar shows **Save View** for persisting dashboards and a **Falcon** toggle that hides or shows the chat panel.
+
+![Open the Imagine tab](/screenshot/product/falcon/10.png)
+
+On a fresh trace, suggested prompt chips appear on the empty canvas: *"Show me where the latency is"*, *"Visualize token usage by span"*, *"Show the agent execution flow"*, *"What's the cost breakdown?"*, *"Compare the LLM calls"*, *"Summarize this trace"*. Click a chip to send it to the chat panel, or type your own request.
+
+---
+
+## Building widgets with chat
+
+Type a request in the Falcon chat panel and Imagine renders widgets in response. Each widget is placed on a 12-column CSS grid, so multiple widgets can sit side by side or stack across rows.
+
+> "Show p95 latency per span as a bar chart, then render the agent execution flow."
+
+> "Group LLM calls by model, put total token usage on top, and the cost breakdown on the right."
+
+Falcon AI runs in **imagine** mode for these conversations, with tracing and visualization tools loaded automatically. Tool calls and responses stream into the chat panel; widgets appear on the canvas as they are emitted.
+
+---
+
+## Widget types
+
+Imagine ships with 17 widget types. Falcon AI picks them based on your request, and you can also ask for a specific type by name.
+
+| Category | Widgets |
+|----------|---------|
+| **Charts** | Line, bar, area, pie, donut, radar |
+| **Tables** | Data table, key-value list |
+| **Metrics** | Metric card, heatmap |
+| **Trace structure** | Span tree, timeline, agent graph |
+| **Data inspection** | JSON tree, code block |
+| **Annotations** | Markdown, screenshot |
+
+Each widget either binds directly to live trace data or captures the output of a Falcon analysis. Live-data widgets re-render against any trace without a new LLM call. Analysis-backed widgets re-run on demand (see [Dynamic analysis](#dynamic-analysis)).
+
+---
+
+## Saving views
+
+A canvas built for one trace becomes more valuable when it can replay on any trace. Save it as a view to make it reusable.
+
+<Steps>
+  <Step title="Build the dashboard">
+    Use the chat panel to assemble the widgets you want.
+
+    ![Build a dashboard](/screenshot/product/falcon/11.png)
+  </Step>
+
+  <Step title="Save the view">
+    Click **Save View** in the Imagine toolbar. A small popover appears with a suggested name pre-filled from your conversation. Edit the name if needed and confirm.
+
+    ![Save view popover](/screenshot/product/falcon/12.png)
+  </Step>
+
+  <Step title="Reopen on any trace">
+    The saved view appears as a tab next to the default Imagine tab. Open any trace, click the saved view's tab, and the same widgets render against that trace's data.
+  </Step>
+</Steps>
+
+Saved views are scoped to the project. Anyone in the project with access to the trace can open the view.
+
+<Note>
+  The **Save View** button is disabled until at least one widget is on the canvas.
+</Note>
+
+---
+
+## Dynamic analysis
+
+Charts, tables, and metric widgets bind to trace data through field paths, so they update on a new trace without any LLM call. Narrative widgets like markdown summaries cannot do this; they need fresh analysis each time. Imagine handles them with **dynamic analysis**.
+
+When you open a saved view on a new trace:
+
+- Widgets with live bindings render immediately.
+- Widgets marked for dynamic analysis show a skeleton loader and the message *"Falcon is analyzing this trace..."* while the analysis runs.
+- Each completed widget is cached against the trace ID, so reopening the view on the same trace skips the LLM call.
+
+![Dynamic analysis skeleton loader on markdown widgets](/screenshot/product/falcon/13.png)
+
+A **Rerun** button appears in each dynamic widget's title bar once analysis completes. Click it to discard the cached result and run the analysis again.
+
+---
+
+## Reliability
+
+Dynamic analysis runs through a Temporal workflow with built-in retries, so transient failures from the model provider do not surface in the UI.
+
+| Step | Timeout | Retry policy |
+|------|---------|--------------|
+| Fetch trace data | 30 s | Up to 2 attempts |
+| LLM analysis | 90 s | Up to 5 attempts with exponential backoff (5 s to 30 s) |
+| Save result | 10 s | Default |
+
+If the LLM step exhausts its retries, the widget records a failure state in the database. Click **Rerun** to try again once the model provider recovers.
+
+---
+
+## Rate limits
+
+The chat panel shares Falcon AI's rate limit of 10 messages per 60 seconds per user. Dynamic analysis re-runs do not count against this limit; they go through a dedicated single-shot endpoint with a 45-second timeout.
+
+---
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Using Falcon AI" icon="message-circle" href="/docs/falcon-ai/features/chat">
+    Open the chat, ask questions, upload files, and follow responses.
+  </Card>
+  <Card title="Skills" icon="zap" href="/docs/falcon-ai/features/skills">
+    Use built-in workflows or create custom slash commands.
+  </Card>
+  <Card title="MCP Connectors" icon="plug" href="/docs/falcon-ai/features/mcp-connectors">
+    Connect external tools like Linear, Slack, and GitHub.
+  </Card>
+</CardGroup>