diff --git a/.gitignore b/.gitignore
index 663c0f2e..020d34e3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -91,5 +91,10 @@ deploy
 frontend-web/.offline-pack-build/
 frontend-web/.offline-extract-test/
 
+.codegraph
+codegraph.mdc
+
+docs/aidev-docs
+docs/backups
 # Frontend skills components must be tracked (excluded from the broad skills/ ignore above)
 !frontend-web/src/components/workspace/skills/
diff --git a/docs/superpowers/plans/2026-06-01-iframe-chat-page.md b/docs/superpowers/plans/2026-06-01-iframe-chat-page.md
new file mode 100644
index 00000000..0eec0d6a
--- /dev/null
+++ b/docs/superpowers/plans/2026-06-01-iframe-chat-page.md
@@ -0,0 +1,139 @@
+# Iframe Chat Page Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add a standalone `/page/workspace/chats_iframe/*` chat page that reuses the existing thread system and history, while showing only `你好` and no input box before the first user message.
+
+**Architecture:** Keep the existing workspace shell and chat runtime intact, then add a new route pair and a copied page component dedicated to the iframe path. The new page keeps the original chat behavior once a thread already has messages, but it owns its empty-state rendering and URL transition to `/page/workspace/chats_iframe/:thread_id`.
+
+**Tech Stack:** React, TypeScript, React Router, Next navigation shim, existing LangGraph thread hooks
+
+---
+
+### Task 1: Add the iframe chat routes
+
+**Files:**
+- Modify: `frontend-web/src/pages/WorkspaceRoutes.tsx`
+
+- [ ] **Step 1: Add `chats_iframe/new` and `chats_iframe/:thread_id` routes that render the new page inside the existing workspace layout and chat runtime**
+
+```tsx
+      <Route
+        path="chats_iframe/new"
+        element={
+          <WorkspaceLayout {...layoutProps}>
+            <ChatRuntime>
+              <IframeChatPage />
+            </ChatRuntime>
+          </WorkspaceLayout>
+        }
+      />
+      <Route
+        path="chats_iframe/:thread_id"
+        element={
+          <WorkspaceLayout {...layoutProps}>
+            <ChatRuntime>
+              <IframeChatPage />
+            </ChatRuntime>
+          </WorkspaceLayout>
+        }
+      />
+```
+
+- [ ] **Step 2: Ensure the new route imports compile cleanly**
+
+Run: `rg -n "IframeChatPage|chats_iframe" frontend-web/src/pages/WorkspaceRoutes.tsx`
+Expected: `WorkspaceRoutes.tsx` contains one import for `IframeChatPage` and both `chats_iframe` route entries.
+
+### Task 2: Add a standalone iframe chat page
+
+**Files:**
+- Create: `frontend-web/src/pages/IframeChatPage.tsx`
+- Reference: `frontend-web/src/pages/ChatPage.tsx`
+
+- [ ] **Step 1: Copy the current `ChatPage` implementation into `IframeChatPage` and preserve the existing chat runtime integration**
+
+```tsx
+export default function IframeChatPage() {
+  const routeBase = useRouteBase();
+  const router = useRouter();
+  const [showFollowups, setShowFollowups] = useState(false);
+  const [hasStartedConversation, setHasStartedConversation] = useState(false);
+  const { threadId, setThreadId, isNewThread, setIsNewThread, isMock } =
+    useThreadChat();
+  // keep the rest of the existing chat hooks and handlers aligned with ChatPage
+}
+```
+
+- [ ] **Step 2: Change the thread creation URL replacement to stay on the iframe route family**
+
+```tsx
+    onStart: (createdThreadId) => {
+      setThreadId(createdThreadId);
+      setIsNewThread(false);
+      history.replaceState(
+        null,
+        "",
+        `${window.location.pathname}${window.location.search}#${routeBase}/chats_iframe/${createdThreadId}`,
+      );
+    },
+```
+
+- [ ] **Step 3: Replace the default landing state with a simple `你好` view and do not render the input box while the iframe page is still a brand-new untouched chat**
+
+```tsx
+                {isLandingState && mounted ? (
+                  <div className="flex min-h-[240px] items-center justify-center">
+                    <div className="text-2xl font-medium">你好</div>
+                  </div>
+                ) : null}
+                {!isLandingState &&
+                  (mounted ? (
+                    <div className="w-full -translate-y-4">
+                      <InputBox
+                        className="w-full"
+                        isNewThread={false}
+                        threadId={threadId}
+                        autoFocus={false}
+                        status={thread.error ? "error" : thread.isLoading ? "streaming" : "ready"}
+                        context={settings.context}
+                        disabled={env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true" || isUploading}
+                        onContextChange={(context) => setSettings("context", context)}
+                        promptPrefix={promptPrefixProp}
+                        onFollowupsVisibilityChange={setShowFollowups}
+                        onSubmit={handleSubmit}
+                        onStop={handleStop}
+                      />
+                    </div>
+                  ) : (
+                    <div aria-hidden="true" className="bg-background/5 h-32 w-full -translate-y-4 rounded-3xl border" />
+                  ))}
+```
+
+- [ ] **Step 4: Keep message rendering, thread title, export, token usage, todos, artifact triggers, and all post-first-message behavior identical to the original page**
+
+Run: `rg -n "MessageList|ThreadTitle|ArtifactTrigger|TokenUsageIndicator|TodoList" frontend-web/src/pages/IframeChatPage.tsx`
+Expected: The new page still renders the same core chat primitives used by `ChatPage`.
+
+### Task 3: Verify the new page compiles
+
+**Files:**
+- Test: `frontend-web/src/pages/IframeChatPage.tsx`
+- Test: `frontend-web/src/pages/WorkspaceRoutes.tsx`
+
+- [ ] **Step 1: Run the frontend build**
+
+Run: `cmd /c npm run build`
+Expected: Build succeeds without TypeScript or bundling errors related to `IframeChatPage` or `chats_iframe`.
+
+- [ ] **Step 2: Spot-check the changed routes in the built source**
+
+Run: `rg -n "chats_iframe" frontend-web/src/pages`
+Expected: Matches appear in `WorkspaceRoutes.tsx` and `IframeChatPage.tsx`.
+
+- [ ] **Step 3: Commit after verification**
+
+```bash
+git add docs/superpowers/plans/2026-06-01-iframe-chat-page.md frontend-web/src/pages/WorkspaceRoutes.tsx frontend-web/src/pages/IframeChatPage.tsx
+git commit -m "feat: add iframe chat page routes"
+```
diff --git a/frontend-web/src/components/workspace/chats/chat-box.tsx b/frontend-web/src/components/workspace/chats/chat-box.tsx
index fe9a8262..282d2584 100644
--- a/frontend-web/src/components/workspace/chats/chat-box.tsx
+++ b/frontend-web/src/components/workspace/chats/chat-box.tsx
@@ -67,9 +67,14 @@ function logReferenceDebug(
   });
 }
 
-const ChatBox: React.FC<{ children: React.ReactNode; threadId: string }> = ({
+const ChatBox: React.FC<{
+  children: React.ReactNode;
+  threadId: string;
+  disableArtifacts?: boolean;
+}> = ({
   children,
   threadId,
+  disableArtifacts = false,
 }) => {
   const { thread } = useThread();
   const pathname = usePathname();
@@ -275,12 +280,16 @@ const ChatBox: React.FC<{ children: React.ReactNode; threadId: string }> = ({
     }
 
     // Update artifacts from the current thread
-    const nextArtifacts = thread.values.artifacts ?? [];
+    const nextArtifacts = disableArtifacts ? [] : (thread.values.artifacts ?? []);
     const hadArtifacts = artifactsCountRef.current > 0;
     const hasNewArtifact = nextArtifacts.length > artifactsCountRef.current;
     artifactsCountRef.current = nextArtifacts.length;
     setArtifacts(nextArtifacts);
-    if ((hasNewArtifact || (!hadArtifacts && nextArtifacts.length > 0)) && !selectedArtifact) {
+    if (
+      !disableArtifacts &&
+      (hasNewArtifact || (!hadArtifacts && nextArtifacts.length > 0)) &&
+      !selectedArtifact
+    ) {
       selectArtifact(nextArtifacts[nextArtifacts.length - 1]!);
       setArtifactsOpen(true);
       setSideTab("document");
@@ -295,6 +304,7 @@ const ChatBox: React.FC<{ children: React.ReactNode; threadId: string }> = ({
     // }
 
     if (
+      !disableArtifacts &&
       env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true" &&
       autoSelectFirstArtifact
     ) {
@@ -311,14 +321,18 @@ const ChatBox: React.FC<{ children: React.ReactNode; threadId: string }> = ({
     selectedArtifact,
     setArtifacts,
     thread.values.artifacts,
+    disableArtifacts,
   ]);
 
   const artifactPanelOpen = useMemo(() => {
+    if (disableArtifacts) {
+      return false;
+    }
     if (env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true") {
       return artifactsOpen && artifacts?.length > 0;
     }
     return artifactsOpen;
-  }, [artifactsOpen, artifacts]);
+  }, [artifactsOpen, artifacts, disableArtifacts]);
   const sidePanelOpen = artifactPanelOpen || (hasCitationReferences && referencesOpen);
   const showTabs = !!selectedArtifact && hasCitationReferences;
 
@@ -347,6 +361,10 @@ const ChatBox: React.FC<{ children: React.ReactNode; threadId: string }> = ({
     }
   }, [sidePanelOpen]);
 
+  if (disableArtifacts) {
+    return <>{children}</>;
+  }
+
   return (
     <ResizablePanelGroup
       id={`${resizableIdBase}-panels`}
diff --git a/frontend-web/src/components/workspace/messages/message-list-item.tsx b/frontend-web/src/components/workspace/messages/message-list-item.tsx
index f7d551ac..082b4607 100644
--- a/frontend-web/src/components/workspace/messages/message-list-item.tsx
+++ b/frontend-web/src/components/workspace/messages/message-list-item.tsx
@@ -1,5 +1,5 @@
-import type { Message } from "@langchain/langgraph-sdk";
-import { ClockIcon, FileIcon, Loader2Icon } from "lucide-react";
+import type { Message } from '@langchain/langgraph-sdk';
+import { ClockIcon, FileIcon, Loader2Icon } from 'lucide-react';
 import {
   memo,
   useCallback,
@@ -8,31 +8,31 @@ import {
   useState,
   type AnchorHTMLAttributes,
   type ImgHTMLAttributes,
-} from "react";
-import rehypeKatex from "rehype-katex";
+} from 'react';
+import rehypeKatex from 'rehype-katex';
 
-import { Loader } from "@/components/ai-elements/loader";
+import { Loader } from '@/components/ai-elements/loader';
 import {
   Message as AIElementMessage,
   MessageContent as AIElementMessageContent,
   MessageResponse as AIElementMessageResponse,
   MessageToolbar,
-} from "@/components/ai-elements/message";
+} from '@/components/ai-elements/message';
 import {
   Reasoning,
   ReasoningContent,
   ReasoningTrigger,
-} from "@/components/ai-elements/reasoning";
-import { Task, TaskTrigger } from "@/components/ai-elements/task";
-import { Badge } from "@/components/ui/badge";
+} from '@/components/ai-elements/reasoning';
+import { Task, TaskTrigger } from '@/components/ai-elements/task';
+import { Badge } from '@/components/ui/badge';
 import {
   UploadedFilePreviewDialog,
   useAuthedObjectUrl,
-} from "@/components/workspace/messages/uploaded-file-preview-dialog";
-import { resolveArtifactURL } from "@/core/artifacts/utils";
-import { useChatAskTimes } from "@/core/chat-timestamps";
-import { getBackendBaseURL } from "@/core/config";
-import { useI18n } from "@/core/i18n/hooks";
+} from '@/components/workspace/messages/uploaded-file-preview-dialog';
+import { resolveArtifactURL } from '@/core/artifacts/utils';
+import { useChatAskTimes } from '@/core/chat-timestamps';
+import { getBackendBaseURL } from '@/core/config';
+import { useI18n } from '@/core/i18n/hooks';
 import {
   extractContentFromMessage,
   extractReasoningContentFromMessage,
@@ -40,22 +40,63 @@ import {
   stripArtifactTag,
   stripUploadedFilesTag,
   type FileInMessage,
-} from "@/core/messages/utils";
-import { useRehypeSplitWordsIntoSpans } from "@/core/rehype";
+} from '@/core/messages/utils';
+import { useRehypeSplitWordsIntoSpans } from '@/core/rehype';
 import {
   applyInlineCitations,
   type RuntimeDisplaySource,
-} from "@/core/skill-display/runtime";
-import { humanMessagePlugins } from "@/core/streamdown";
-import { cn } from "@/lib/utils";
+} from '@/core/skill-display/runtime';
+import { humanMessagePlugins } from '@/core/streamdown';
+import { cn } from '@/lib/utils';
 
-import { CitationLink } from "../citations/citation-link";
-import { CopyButton } from "../copy-button";
-import { SkillDisplayBlock } from "../skill-display-block";
-import { ThreadContext } from "./context";
-import { DownloadWordButton } from "./download-word-button";
-import { MarkdownContent, type MarkdownContentProps } from "./markdown-content";
-import { MessageTokenUsage } from "./message-token-usage";
+import { CitationLink } from '../citations/citation-link';
+import { CopyButton } from '../copy-button';
+import { SkillDisplayBlock } from '../skill-display-block';
+import { ThreadContext } from './context';
+import { DownloadWordButton } from './download-word-button';
+import { MarkdownContent, type MarkdownContentProps } from './markdown-content';
+import { MessageTokenUsage } from './message-token-usage';
+
+type EmbeddedPageContext = {
+  title?: string;
+  url?: string;
+  content?: string;
+};
+
+function extractTagContent(source: string, tagName: string) {
+  const match = new RegExp(
+    `<${tagName}>\\s*([\\s\\S]*?)\\s*</${tagName}>`,
+    'i',
+  ).exec(source);
+  return match?.[1]?.trim() ?? '';
+}
+
+function parseEmbeddedPageContext(source: string): {
+  content: string;
+  pageContext: EmbeddedPageContext | null;
+} {
+  const match = /<page_context>\s*([\s\S]*?)\s*<\/page_context>/i.exec(source);
+  if (!match) {
+    return { content: source, pageContext: null };
+  }
+
+  const body = match[1] ?? '';
+  const pageContext = {
+    title: extractTagContent(body, 'title') || undefined,
+    url: extractTagContent(body, 'url') || undefined,
+    content: extractTagContent(body, 'content') || undefined,
+  };
+  const cleanedContent = source
+    .replace(match[0], '')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+
+  if (!pageContext.title && !pageContext.url && !pageContext.content) {
+    return { content: cleanedContent, pageContext: null };
+  }
+
+  return { content: cleanedContent, pageContext };
+}
 
 /**
  * Resolve an in-conversation file path to a fetchable URL.
@@ -69,7 +110,7 @@ function useArtifactResolver(threadId: string): (path: string) => string {
   return useCallback(
     (path: string) => {
       if (publicShareCode) {
-        const normalized = path.startsWith("/") ? path : `/${path}`;
+        const normalized = path.startsWith('/') ? path : `/${path}`;
         return `${getBackendBaseURL()}/api/public/shares/${encodeURIComponent(
           publicShareCode,
         )}/files${normalized}`;
@@ -82,6 +123,7 @@ function useArtifactResolver(threadId: string): (path: string) => string {
 
 export function MessageListItem({
   className,
+  fitRowToContent = false,
   message,
   isLoading,
   threadId,
@@ -90,6 +132,7 @@ export function MessageListItem({
   extraRehypePlugins,
 }: {
   className?: string;
+  fitRowToContent?: boolean;
   message: Message;
   isLoading?: boolean;
   threadId: string;
@@ -97,18 +140,23 @@ export function MessageListItem({
   displaySources?: RuntimeDisplaySource[];
   extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
 }) {
-  const isHuman = message.type === "human";
+  const isHuman = message.type === 'human';
   const messageMarkdown =
     extractContentFromMessage(message) ??
     extractReasoningContentFromMessage(message) ??
-    "";
+    '';
   return (
     <AIElementMessage
-      className={cn("group/conversation-message relative w-full", className)}
-      from={isHuman ? "user" : "assistant"}
+      className={cn(
+        'group/conversation-message relative',
+        fitRowToContent ? 'max-w-full w-fit' : 'w-full',
+        isHuman && fitRowToContent && 'ml-auto',
+        className,
+      )}
+      from={isHuman ? 'user' : 'assistant'}
     >
       <MessageContent
-        className={isHuman ? "w-fit" : "w-full"}
+        className={isHuman ? 'w-fit' : 'w-full'}
         message={message}
         isLoading={isLoading}
         threadId={threadId}
@@ -119,8 +167,8 @@ export function MessageListItem({
       {!isLoading && (
         <MessageToolbar
           className={cn(
-            isHuman ? "-bottom-9 justify-end" : "-bottom-8",
-            "absolute right-0 left-0 z-20 opacity-0 transition-opacity delay-200 duration-300 group-hover/conversation-message:opacity-100",
+            isHuman ? '-bottom-9 justify-end' : '-bottom-8',
+            'absolute right-0 left-0 z-20 opacity-0 transition-opacity delay-200 duration-300 group-hover/conversation-message:opacity-100',
           )}
         >
           <div className="flex gap-1">
@@ -145,7 +193,7 @@ function MessageImage({
   src,
   alt,
   threadId,
-  maxWidth = "90%",
+  maxWidth = '90%',
   ...props
 }: React.ImgHTMLAttributes<HTMLImageElement> & {
   threadId: string;
@@ -154,13 +202,13 @@ function MessageImage({
   const resolveArtifact = useArtifactResolver(threadId);
   if (!src) return null;
 
-  const imgClassName = cn("overflow-hidden rounded-lg", `max-w-[${maxWidth}]`);
+  const imgClassName = cn('overflow-hidden rounded-lg', `max-w-[${maxWidth}]`);
 
-  if (typeof src !== "string") {
+  if (typeof src !== 'string') {
     return <img className={imgClassName} src={src} alt={alt} {...props} />;
   }
 
-  const url = src.startsWith("/mnt/") ? resolveArtifact(src) : src;
+  const url = src.startsWith('/mnt/') ? resolveArtifact(src) : src;
 
   return (
     <a href={url} target="_blank" rel="noopener noreferrer">
@@ -188,11 +236,14 @@ function MessageContent_({
 }) {
   const baseRehypePlugins = useRehypeSplitWordsIntoSpans(isLoading);
   const rehypePlugins = useMemo(
-    () => (extraRehypePlugins?.length ? [...baseRehypePlugins, ...extraRehypePlugins] : baseRehypePlugins),
+    () =>
+      extraRehypePlugins?.length
+        ? [...baseRehypePlugins, ...extraRehypePlugins]
+        : baseRehypePlugins,
     [baseRehypePlugins, extraRehypePlugins],
   );
   const askTimes = useChatAskTimes();
-  const isHuman = message.type === "human";
+  const isHuman = message.type === 'human';
   const resolveArtifact = useArtifactResolver(threadId);
   const components = useMemo(
     () => ({
@@ -200,13 +251,16 @@ function MessageContent_({
         <MessageImage {...props} threadId={threadId} maxWidth="90%" />
       ),
       a: ({ href, ...props }: AnchorHTMLAttributes<HTMLAnchorElement>) => {
-        if (href?.startsWith("#reference-")) {
+        if (href?.startsWith('#reference-')) {
           return <CitationLink href={href} {...props} />;
         }
-        if (typeof props.children === "string" && /^citation:/i.test(props.children)) {
+        if (
+          typeof props.children === 'string' &&
+          /^citation:/i.test(props.children)
+        ) {
           return <CitationLink href={href} {...props} />;
         }
-        if (href?.startsWith("/mnt/")) {
+        if (href?.startsWith('/mnt/')) {
           const url = resolveArtifact(href);
           return (
             <a
@@ -234,7 +288,7 @@ function MessageContent_({
   const files = useMemo(() => {
     const files = message.additional_kwargs?.files;
     if (!Array.isArray(files) || files.length === 0) {
-      if (rawContent.includes("<uploaded_files>")) {
+      if (rawContent.includes('<uploaded_files>')) {
         // If the content contains the <uploaded_files> tag, we return the parsed files from the content for backward compatibility.
         return parseUploadedFiles(rawContent);
       }
@@ -245,10 +299,19 @@ function MessageContent_({
 
   const contentToDisplay = useMemo(() => {
     if (isHuman) {
-      return rawContent ? stripArtifactTag(stripUploadedFilesTag(rawContent)) : "";
+      return rawContent
+        ? stripArtifactTag(stripUploadedFilesTag(rawContent))
+        : '';
     }
-    return applyInlineCitations(rawContent ?? "", displaySources);
+    return applyInlineCitations(rawContent ?? '', displaySources);
   }, [rawContent, isHuman, displaySources]);
+  const parsedHumanContent = useMemo(
+    () =>
+      isHuman
+        ? parseEmbeddedPageContext(contentToDisplay)
+        : { content: contentToDisplay, pageContext: null },
+    [contentToDisplay, isHuman],
+  );
 
   const filesList =
     files && files.length > 0 ? (
@@ -256,7 +319,7 @@ function MessageContent_({
     ) : null;
 
   // Uploading state: mock AI message shown while files upload
-  if (message.additional_kwargs?.element === "task") {
+  if (message.additional_kwargs?.element === 'task') {
     return (
       <AIElementMessageContent className={className}>
         <Task defaultOpen={false}>
@@ -289,7 +352,7 @@ function MessageContent_({
   }
 
   if (isHuman) {
-    const messageResponse = contentToDisplay ? (
+    const messageResponse = parsedHumanContent.content ? (
       <AIElementMessageResponse
         remarkPlugins={humanMessagePlugins.remarkPlugins}
         rehypePlugins={humanMessagePlugins.rehypePlugins}
@@ -300,13 +363,23 @@ function MessageContent_({
       </AIElementMessageResponse>
     ) : null;
     return (
-      <div className={cn("ml-auto flex flex-col gap-2", className)}>
+      <div
+        className={cn(
+          'ml-auto flex max-w-full min-w-0 flex-col items-end gap-2',
+          className,
+        )}
+      >
         {filesList}
         {messageResponse && (
-          <AIElementMessageContent className="w-fit">
+          <AIElementMessageContent className="min-w-0 max-w-full w-fit">
             {messageResponse}
           </AIElementMessageContent>
         )}
+        {parsedHumanContent.pageContext ? (
+          <EmbeddedPageContextCard
+            pageContext={parsedHumanContent.pageContext}
+          />
+        ) : null}
         <MessageTimeStamp time={messageTime} align="right" />
       </div>
     );
@@ -321,7 +394,7 @@ function MessageContent_({
           displaySources={displaySources}
           isLoading={isLoading}
           renderSkillDisplayBlocks={false}
-          rehypePlugins={[...rehypePlugins, [rehypeKatex, { output: "html" }]]}
+          rehypePlugins={[...rehypePlugins, [rehypeKatex, { output: 'html' }]]}
           components={components}
         />
       </div>
@@ -337,6 +410,27 @@ function MessageContent_({
   );
 }
 
+function EmbeddedPageContextCard({
+  pageContext,
+}: {
+  pageContext: EmbeddedPageContext;
+}) {
+  const previewText = [pageContext.title, pageContext.url, pageContext.content]
+    .filter(Boolean)
+    .join(' | ');
+
+  return (
+    <div className="bg-muted/70 ml-auto flex w-fit min-w-0 max-w-[min(24rem,calc(100vw-2rem),100%)] flex-col gap-2 rounded-2xl border px-3 py-2 text-sm shadow-sm">
+      <div
+        className="text-muted-foreground line-clamp-2 min-w-0 [overflow-wrap:anywhere] break-words text-xs"
+        title={previewText}
+      >
+        {previewText}
+      </div>
+    </div>
+  );
+}
+
 /**
  * Format a wall-clock message time as ``YYYY-MM-DD HH:mm`` for display, plus a
  * full localized string for the hover title. Returns ``null`` when no/invalid
@@ -345,10 +439,10 @@ function MessageContent_({
 function formatAskedTime(
   clientTs: unknown,
 ): { label: string; full: string } | null {
-  if (typeof clientTs !== "string" || !clientTs) return null;
+  if (typeof clientTs !== 'string' || !clientTs) return null;
   const date = new Date(clientTs);
   if (Number.isNaN(date.getTime())) return null;
-  const pad = (n: number) => String(n).padStart(2, "0");
+  const pad = (n: number) => String(n).padStart(2, '0');
   const label =
     `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` +
     ` ${pad(date.getHours())}:${pad(date.getMinutes())}`;
@@ -361,17 +455,17 @@ function formatAskedTime(
  */
 function MessageTimeStamp({
   time,
-  align = "right",
+  align = 'right',
 }: {
   time: { label: string; full: string } | null;
-  align?: "left" | "right";
+  align?: 'left' | 'right';
 }) {
   if (!time) return null;
   return (
     <div
       className={cn(
-        "text-muted-foreground/60 flex items-center gap-1 text-[11px] leading-none tabular-nums",
-        align === "right" ? "justify-end pr-0.5" : "justify-start pl-0.5",
+        'text-muted-foreground/60 flex items-center gap-1 text-[11px] leading-none tabular-nums',
+        align === 'right' ? 'justify-end pr-0.5' : 'justify-start pl-0.5',
       )}
       title={time.full}
     >
@@ -385,39 +479,39 @@ function MessageTimeStamp({
  * Get file extension and check helpers
  */
 const getFileExt = (filename: string) =>
-  filename.split(".").pop()?.toLowerCase() ?? "";
+  filename.split('.').pop()?.toLowerCase() ?? '';
 
 const FILE_TYPE_MAP: Record<string, string> = {
-  json: "JSON",
-  csv: "CSV",
-  txt: "TXT",
-  md: "Markdown",
-  py: "Python",
-  js: "JavaScript",
-  ts: "TypeScript",
-  tsx: "TSX",
-  jsx: "JSX",
-  html: "HTML",
-  css: "CSS",
-  xml: "XML",
-  yaml: "YAML",
-  yml: "YAML",
-  pdf: "PDF",
-  png: "PNG",
-  jpg: "JPG",
-  jpeg: "JPEG",
-  gif: "GIF",
-  svg: "SVG",
-  zip: "ZIP",
-  tar: "TAR",
-  gz: "GZ",
+  json: 'JSON',
+  csv: 'CSV',
+  txt: 'TXT',
+  md: 'Markdown',
+  py: 'Python',
+  js: 'JavaScript',
+  ts: 'TypeScript',
+  tsx: 'TSX',
+  jsx: 'JSX',
+  html: 'HTML',
+  css: 'CSS',
+  xml: 'XML',
+  yaml: 'YAML',
+  yml: 'YAML',
+  pdf: 'PDF',
+  png: 'PNG',
+  jpg: 'JPG',
+  jpeg: 'JPEG',
+  gif: 'GIF',
+  svg: 'SVG',
+  zip: 'ZIP',
+  tar: 'TAR',
+  gz: 'GZ',
 };
 
-const IMAGE_EXTENSIONS = ["png", "jpg", "jpeg", "gif", "webp", "svg", "bmp"];
+const IMAGE_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp'];
 
 function getFileTypeLabel(filename: string): string {
   const ext = getFileExt(filename);
-  return FILE_TYPE_MAP[ext] ?? (ext.toUpperCase() || "FILE");
+  return FILE_TYPE_MAP[ext] ?? (ext.toUpperCase() || 'FILE');
 }
 
 function isImageFile(filename: string): boolean {
@@ -428,7 +522,7 @@ function isImageFile(filename: string): boolean {
  * Format bytes to human-readable size string
  */
 function formatBytes(bytes: number): string {
-  if (bytes === 0) return "—";
+  if (bytes === 0) return '0 B';
   const kb = bytes / 1024;
   if (kb < 1024) return `${kb.toFixed(1)} KB`;
   return `${(kb / 1024).toFixed(1)} MB`;
@@ -471,7 +565,7 @@ function RichFileCard({
   const { t } = useI18n();
   const resolveArtifact = useArtifactResolver(threadId);
   const [previewOpen, setPreviewOpen] = useState(false);
-  const isUploading = file.status === "uploading";
+  const isUploading = file.status === 'uploading';
   const isImage = isImageFile(file.filename);
   const fileUrl = file.path ? resolveArtifact(file.path) : null;
   // Thumbnails must be fetched with auth: the artifact route is gated and a
@@ -601,8 +695,8 @@ function AssistantDisplayContent({
   displaySources: RuntimeDisplaySource[];
   isLoading: boolean;
   renderSkillDisplayBlocks: boolean;
-  rehypePlugins: MarkdownContentProps["rehypePlugins"];
-  components: MarkdownContentProps["components"];
+  rehypePlugins: MarkdownContentProps['rehypePlugins'];
+  components: MarkdownContentProps['components'];
 }) {
   const { parts, placedKeys } = useMemo(
     () =>
@@ -618,14 +712,14 @@ function AssistantDisplayContent({
       return [];
     }
     return groupDisplaySources(displaySources).filter(
-      (group) => group.mode !== "citation" && !placedKeys.has(group.key),
+      (group) => group.mode !== 'citation' && !placedKeys.has(group.key),
     );
   }, [displaySources, placedKeys, renderSkillDisplayBlocks]);
 
   return (
     <>
       {parts.map((part, index) =>
-        part.type === "markdown" ? (
+        part.type === 'markdown' ? (
           <MarkdownContent
             key={`markdown-${index}`}
             content={part.content}
@@ -654,11 +748,11 @@ function AssistantDisplayContent({
 }
 
 type DisplayPart =
-  | { type: "markdown"; content: string }
+  | { type: 'markdown'; content: string }
   | {
-      type: "display";
+      type: 'display';
       key: string;
-      mode: RuntimeDisplaySource["mode"];
+      mode: RuntimeDisplaySource['mode'];
       sources: RuntimeDisplaySource[];
     };
 
@@ -675,16 +769,16 @@ function splitSkillDisplayPlaceholders(
     const start = match.index ?? 0;
     const before = content.slice(cursor, start);
     if (before.trim()) {
-      parts.push({ type: "markdown", content: before });
+      parts.push({ type: 'markdown', content: before });
     }
-    const attrs = parseDisplayAttrs(match[1] ?? "");
+    const attrs = parseDisplayAttrs(match[1] ?? '');
     const group = findDisplayGroup(displaySources, attrs.tool, attrs.mode);
     if (group) {
       placedKeys.add(group.key);
     }
     if (group && renderSkillDisplayBlocks) {
       parts.push({
-        type: "display",
+        type: 'display',
         key: group.key,
         mode: group.mode,
         sources: group.sources,
@@ -694,26 +788,29 @@ function splitSkillDisplayPlaceholders(
   }
   const rest = content.slice(cursor);
   if (rest.trim() || parts.length === 0) {
-    parts.push({ type: "markdown", content: rest });
+    parts.push({ type: 'markdown', content: rest });
   }
   return { parts, placedKeys };
 }
 
-function parseDisplayAttrs(raw: string): { tool?: string; mode?: RuntimeDisplaySource["mode"] } {
+function parseDisplayAttrs(raw: string): {
+  tool?: string;
+  mode?: RuntimeDisplaySource['mode'];
+} {
   const attrs: Record<string, string> = {};
   for (const match of raw.matchAll(/([a-zA-Z][\w-]*)="([^"]*)"/g)) {
     attrs[match[1]!] = match[2]!;
   }
   return {
     tool: attrs.tool || attrs.skill || attrs.name,
-    mode: attrs.mode as RuntimeDisplaySource["mode"] | undefined,
+    mode: attrs.mode as RuntimeDisplaySource['mode'] | undefined,
   };
 }
 
 function findDisplayGroup(
   sources: RuntimeDisplaySource[],
   tool?: string,
-  mode?: RuntimeDisplaySource["mode"],
+  mode?: RuntimeDisplaySource['mode'],
 ) {
   return groupDisplaySources(sources).find((group) => {
     if (mode && group.mode !== mode) {
@@ -734,20 +831,18 @@ function groupDisplaySources(sources: RuntimeDisplaySource[]) {
     {
       key: string;
       skillName: string;
-      mode: RuntimeDisplaySource["mode"];
+      mode: RuntimeDisplaySource['mode'];
       sources: RuntimeDisplaySource[];
     }
   >();
   for (const source of sources) {
     const key = `${source.skillName}:${source.mode}`;
-    const group =
-      groups.get(key) ??
-      {
-        key,
-        skillName: source.skillName,
-        mode: source.mode,
-        sources: [],
-      };
+    const group = groups.get(key) ?? {
+      key,
+      skillName: source.skillName,
+      mode: source.mode,
+      sources: [],
+    };
     group.sources.push(source);
     groups.set(key, group);
   }
@@ -755,5 +850,5 @@ function groupDisplaySources(sources: RuntimeDisplaySource[]) {
 }
 
 function normalizeName(name: string) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "");
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, '');
 }
diff --git a/frontend-web/src/components/workspace/messages/message-list.tsx b/frontend-web/src/components/workspace/messages/message-list.tsx
index 33463bf9..e1d8527b 100644
--- a/frontend-web/src/components/workspace/messages/message-list.tsx
+++ b/frontend-web/src/components/workspace/messages/message-list.tsx
@@ -50,22 +50,26 @@ import { SubtaskCard } from "./subtask-card";
 export const MESSAGE_LIST_DEFAULT_PADDING_BOTTOM = 160;
 export const MESSAGE_LIST_FOLLOWUPS_EXTRA_PADDING_BOTTOM = 80;
 
-export function MessageList({
-  className,
-  threadId,
-  thread,
-  paddingBottom = MESSAGE_LIST_DEFAULT_PADDING_BOTTOM,
-  tokenUsageEnabled = false,
+export function MessageList({
+  className,
+  contentClassName,
+  fitMessageRowsToContent = false,
+  threadId,
+  thread,
+  paddingBottom = MESSAGE_LIST_DEFAULT_PADDING_BOTTOM,
+  tokenUsageEnabled = false,
   extraRehypePlugins,
   onClarificationSubmit,
   onSetupAgentApprove,
   onSetupAgentReject,
-}: {
-  className?: string;
-  threadId: string;
-  thread: BaseStream<AgentThreadState>;
-  paddingBottom?: number;
-  tokenUsageEnabled?: boolean;
+}: {
+  className?: string;
+  contentClassName?: string;
+  fitMessageRowsToContent?: boolean;
+  threadId: string;
+  thread: BaseStream<AgentThreadState>;
+  paddingBottom?: number;
+  tokenUsageEnabled?: boolean;
   extraRehypePlugins?: ReturnType<typeof useRehypeSplitWordsIntoSpans>;
   onClarificationSubmit?: (answer: string) => void | Promise<void>;
   onSetupAgentApprove?: (payload: SetupAgentApprovalPayload) => void | Promise<void>;
@@ -213,12 +217,17 @@ export function MessageList({
   if (thread.isThreadLoading && messages.length === 0) {
     return <MessageListSkeleton />;
   }
-  return (
-    <Conversation
-      className={cn("flex size-full flex-col justify-center", className)}
-    >
-      <ConversationContent className="mx-auto w-full max-w-(--container-width-lg) gap-8 pt-12">
-        <MessageMetricsProvider messages={messages} isLoading={thread.isLoading}>
+  return (
+    <Conversation
+      className={cn("flex size-full flex-col justify-center", className)}
+    >
+      <ConversationContent
+        className={cn(
+          "mx-auto w-full max-w-(--container-width-lg) gap-8 pt-12",
+          contentClassName,
+        )}
+      >
+        <MessageMetricsProvider messages={messages} isLoading={thread.isLoading}>
         {groupMessages(messages, (group) => {
           if (group.type === "human" || group.type === "assistant") {
             return group.messages.map((msg) => {
@@ -233,11 +242,12 @@ export function MessageList({
                     })
                   : [];
               return (
-                <MessageListItem
-                  key={`${group.id}/${msg.id}`}
-                  message={msg}
-                  isLoading={thread.isLoading}
-                  threadId={threadId}
+                <MessageListItem
+                  key={`${group.id}/${msg.id}`}
+                  fitRowToContent={fitMessageRowsToContent}
+                  message={msg}
+                  isLoading={thread.isLoading}
+                  threadId={threadId}
                   tokenUsageEnabled={tokenUsageEnabled}
                   displaySources={displaySources}
                   extraRehypePlugins={extraRehypePlugins}
diff --git a/frontend-web/src/components/workspace/thread-title.tsx b/frontend-web/src/components/workspace/thread-title.tsx
index a5d86205..d001ca07 100644
--- a/frontend-web/src/components/workspace/thread-title.tsx
+++ b/frontend-web/src/components/workspace/thread-title.tsx
@@ -1,9 +1,10 @@
 import type { BaseStream } from "@langchain/langgraph-sdk";
-import { useEffect } from "react";
-
-import { useI18n } from "@/core/i18n/hooks";
-import type { AgentThreadState } from "@/core/threads";
-import { desensitize } from "@/lib/desensitize";
+import { useEffect } from "react";
+
+import { useI18n } from "@/core/i18n/hooks";
+import type { AgentThreadState } from "@/core/threads";
+import { sanitizeThreadTitleForDisplay } from "@/core/threads/utils";
+import { desensitize } from "@/lib/desensitize";
 
 import { useThreadChat } from "./chats";
 import { FlipDisplay } from "./flip-display";
@@ -16,16 +17,18 @@ export function ThreadTitle({
   threadId: string;
   thread: BaseStream<AgentThreadState>;
 }) {
-  const { t } = useI18n();
-  const { isNewThread } = useThreadChat();
-  useEffect(() => {
-    let _title = t.pages.untitled;
-
-    if (thread.values?.title) {
-      _title = thread.values.title;
-    } else if (isNewThread) {
-      _title = t.pages.newChat;
-    }
+  const { t } = useI18n();
+  const { isNewThread } = useThreadChat();
+  const displayTitle = sanitizeThreadTitleForDisplay(thread.values?.title);
+
+  useEffect(() => {
+    let _title = t.pages.untitled;
+
+    if (thread.values?.title) {
+      _title = displayTitle;
+    } else if (isNewThread) {
+      _title = t.pages.newChat;
+    }
     if (thread.isThreadLoading) {
       document.title = `Loading... - ${t.pages.appName}`;
     } else {
@@ -35,17 +38,18 @@ export function ThreadTitle({
     isNewThread,
     t.pages.newChat,
     t.pages.untitled,
-    t.pages.appName,
-    thread.isThreadLoading,
-    thread.values,
-  ]);
+    t.pages.appName,
+    thread.isThreadLoading,
+    thread.values,
+    displayTitle,
+  ]);
 
   if (!thread.values?.title) {
     return null;
   }
-  return (
-    <FlipDisplay uniqueKey={threadId}>
-      {desensitize(thread.values.title ?? "Untitled")}
-    </FlipDisplay>
-  );
-}
+  return (
+    <FlipDisplay uniqueKey={threadId}>
+      {desensitize(displayTitle)}
+    </FlipDisplay>
+  );
+}
diff --git a/frontend-web/src/core/api/api-client.ts b/frontend-web/src/core/api/api-client.ts
index 361ea289..b34bb689 100644
--- a/frontend-web/src/core/api/api-client.ts
+++ b/frontend-web/src/core/api/api-client.ts
@@ -2,26 +2,28 @@
 
 import { Client as LangGraphClient } from "@langchain/langgraph-sdk/client";
 
-import { getAuthorizationHeaderValue } from "../auth";
-import { getLangGraphBaseURL } from "../config";
-
-import { sanitizeRunStreamOptions } from "./stream-mode";
+import { getAuthorizationHeaderValue } from "../auth";
+import { getLangGraphBaseURL } from "../config";
+
+import { withCsrfHeaders } from "./csrf";
+import { sanitizeRunStreamOptions } from "./stream-mode";
 
 function createCompatibleClient(isMock?: boolean): LangGraphClient {
   const client = new LangGraphClient({
-    apiUrl: getLangGraphBaseURL(isMock),
-    onRequest(_url, init) {
-      const headers = new Headers(init.headers ?? {});
-      const authHeader = getAuthorizationHeaderValue();
-      if (authHeader && !headers.has("Authorization")) {
-        headers.set("Authorization", authHeader);
-      }
-      return {
-        ...init,
-        headers,
-      };
-    },
-  });
+    apiUrl: getLangGraphBaseURL(isMock),
+    onRequest(_url, init) {
+      const headers = withCsrfHeaders(init.headers);
+      const authHeader = getAuthorizationHeaderValue();
+      if (authHeader && !headers.has("Authorization")) {
+        headers.set("Authorization", authHeader);
+      }
+      return {
+        ...init,
+        credentials: init.credentials ?? "include",
+        headers,
+      };
+    },
+  });
 
   const originalRunStream = client.runs.stream.bind(client.runs);
   client.runs.stream = ((threadId, assistantId, payload) =>
diff --git a/frontend-web/src/core/api/canvas-client.ts b/frontend-web/src/core/api/canvas-client.ts
index 3c1c0f5c..36ea4bba 100644
--- a/frontend-web/src/core/api/canvas-client.ts
+++ b/frontend-web/src/core/api/canvas-client.ts
@@ -5,6 +5,7 @@ import { Client as LangGraphClient } from "@langchain/langgraph-sdk/client";
 import { getAuthorizationHeaderValue } from "../auth";
 import { getCanvasLangGraphBaseURL } from "../config";
 
+import { withCsrfHeaders } from "./csrf";
 import { sanitizeRunStreamOptions } from "./stream-mode";
 
 /**
@@ -19,12 +20,16 @@ function createCanvasClient(): LangGraphClient {
   const client = new LangGraphClient({
     apiUrl: getCanvasLangGraphBaseURL(),
     onRequest(_url, init) {
-      const headers = new Headers(init.headers ?? {});
+      const headers = withCsrfHeaders(init.headers);
       const authHeader = getAuthorizationHeaderValue();
       if (authHeader && !headers.has("Authorization")) {
         headers.set("Authorization", authHeader);
       }
-      return { ...init, headers };
+      return {
+        ...init,
+        credentials: init.credentials ?? "include",
+        headers,
+      };
     },
   });
 
diff --git a/frontend-web/src/core/api/csrf.ts b/frontend-web/src/core/api/csrf.ts
new file mode 100644
index 00000000..7680a225
--- /dev/null
+++ b/frontend-web/src/core/api/csrf.ts
@@ -0,0 +1,42 @@
+const CSRF_COOKIE_NAME = "csrf_token";
+const CSRF_HEADER_NAME = "X-CSRF-Token";
+
+function readCookie(name: string): string | undefined {
+  if (typeof document === "undefined") {
+    return undefined;
+  }
+
+  const cookies = document.cookie.split(";");
+  for (const cookie of cookies) {
+    const [rawName, ...rest] = cookie.trim().split("=");
+    if (rawName !== name) {
+      continue;
+    }
+    const rawValue = rest.join("=");
+    if (!rawValue) {
+      return undefined;
+    }
+    try {
+      return decodeURIComponent(rawValue);
+    } catch {
+      return rawValue;
+    }
+  }
+
+  return undefined;
+}
+
+export function getCsrfToken(): string | undefined {
+  const token = readCookie(CSRF_COOKIE_NAME)?.trim();
+  return token ? token : undefined;
+}
+
+export function withCsrfHeaders(headers?: HeadersInit): Headers {
+  const next = new Headers(headers ?? {});
+  const csrfToken = getCsrfToken();
+  if (csrfToken && !next.has(CSRF_HEADER_NAME)) {
+    next.set(CSRF_HEADER_NAME, csrfToken);
+  }
+  return next;
+}
+
diff --git a/frontend-web/src/core/api/fetch-client.ts b/frontend-web/src/core/api/fetch-client.ts
index 0c8e11ae..f3fe4c4e 100644
--- a/frontend-web/src/core/api/fetch-client.ts
+++ b/frontend-web/src/core/api/fetch-client.ts
@@ -1,18 +1,20 @@
-import { getAuthorizationHeaderValue } from "@/core/auth";
-
-function withAuthHeaders(headers?: HeadersInit): Headers {
-  const next = new Headers(headers ?? {});
-  const authHeader = getAuthorizationHeaderValue();
-  if (authHeader && !next.has("Authorization")) {
-    next.set("Authorization", authHeader);
-  }
-  return next;
+import { getAuthorizationHeaderValue } from "@/core/auth";
+import { withCsrfHeaders } from "./csrf";
+
+function withAuthHeaders(headers?: HeadersInit): Headers {
+  const next = withCsrfHeaders(headers);
+  const authHeader = getAuthorizationHeaderValue();
+  if (authHeader && !next.has("Authorization")) {
+    next.set("Authorization", authHeader);
+  }
+  return next;
 }
 
-export function apiFetch(input: RequestInfo | URL, init?: RequestInit) {
-  return fetch(input, {
-    ...init,
-    headers: withAuthHeaders(init?.headers),
-  });
-}
+export function apiFetch(input: RequestInfo | URL, init?: RequestInit) {
+  return fetch(input, {
+    ...init,
+    credentials: init?.credentials ?? "include",
+    headers: withAuthHeaders(init?.headers),
+  });
+}
 
diff --git a/frontend-web/src/core/threads/hooks.ts b/frontend-web/src/core/threads/hooks.ts
index 904a33d4..4ab0b2c2 100644
--- a/frontend-web/src/core/threads/hooks.ts
+++ b/frontend-web/src/core/threads/hooks.ts
@@ -350,9 +350,12 @@ export function useThreadStream({
         // agent thread URL — otherwise fall back to the global new chat.
         const hash = typeof window !== "undefined" ? window.location.hash : "";
         const agentMatch = hash.match(/#\/page\/workspace\/agents\/([^/]+)\//);
-        const target = agentMatch
-          ? `/page/workspace/agents/${agentMatch[1]}/chats/new`
-          : "/page/workspace/chats/new";
+        const iframeMatch = hash.match(/#\/page\/workspace\/chats_iframe\//);
+        const target = agentMatch
+          ? `/page/workspace/agents/${agentMatch[1]}/chats/new`
+          : iframeMatch
+            ? "/page/workspace/chats_iframe/new"
+            : "/page/workspace/chats/new";
         // First navigate to a safe URL so the post-reload page lands on a
         // valid route. Then full-reload so TanStack Query cache, context
         // providers and any other state captured under the previous user's
diff --git a/frontend-web/src/core/threads/utils.ts b/frontend-web/src/core/threads/utils.ts
index 8877eda3..cf25b7b7 100644
--- a/frontend-web/src/core/threads/utils.ts
+++ b/frontend-web/src/core/threads/utils.ts
@@ -65,3 +65,15 @@ export function textOfMessage(message: Message) {
 export function titleOfThread(thread: AgentThread) {
   return thread.values?.title ?? "Untitled";
 }
+
+export function sanitizeThreadTitleForDisplay(title: string | null | undefined) {
+  if (!title) return "Untitled";
+
+  const cleaned = title
+    .replace(/<\/?[^>\n]+>/g, " ")
+    .replace(/<[^>\n]*$/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+
+  return cleaned || "Untitled";
+}
diff --git a/frontend-web/src/pages/IframeChatPage.tsx b/frontend-web/src/pages/IframeChatPage.tsx
new file mode 100644
index 00000000..821b0ef5
--- /dev/null
+++ b/frontend-web/src/pages/IframeChatPage.tsx
@@ -0,0 +1,322 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+import { type PromptInputMessage } from "@/components/ai-elements/prompt-input";
+import { useArtifacts } from "@/components/workspace/artifacts";
+import {
+  ChatBox,
+  useSpecificChatMode,
+  useThreadChat,
+} from "@/components/workspace/chats";
+import { ExportTrigger } from "@/components/workspace/export-trigger";
+import {
+  MessageList,
+  MESSAGE_LIST_DEFAULT_PADDING_BOTTOM,
+  MESSAGE_LIST_FOLLOWUPS_EXTRA_PADDING_BOTTOM,
+} from "@/components/workspace/messages";
+import { ThreadContext } from "@/components/workspace/messages/context";
+import { ThreadTitle } from "@/components/workspace/thread-title";
+import { TodoList } from "@/components/workspace/todo-list";
+import { TokenUsageIndicator } from "@/components/workspace/token-usage-indicator";
+import { useI18n } from "@/core/i18n/hooks";
+import { useModels } from "@/core/models/hooks";
+import { useNotification } from "@/core/notification/hooks";
+import { useRouteBase } from "@/core/route-base";
+import { useThreadSettings } from "@/core/settings";
+import { usePromptPrefixSettings } from "@/core/system-settings/hooks";
+import { useThreadStream } from "@/core/threads/hooks";
+import { textOfMessage } from "@/core/threads/utils";
+import { env } from "@/env";
+import { cn } from "@/lib/utils";
+import {
+  type BrainyChatSubmitMessage,
+  parseBrainyChatSubmitMessage,
+} from "./iframe-chat-submit";
+
+type BrainyChatStatus = "started" | "finished";
+
+function postBrainyChatStatus(status: BrainyChatStatus, requestId: string) {
+  window.parent?.postMessage(
+    {
+      source: "brainy-iframe",
+      type: "brainy:chat-status",
+      payload: {
+        status,
+        requestId,
+      },
+    },
+    "*",
+  );
+}
+
+export default function IframeChatPage() {
+  const routeBase = useRouteBase();
+  const router = useRouter();
+  const { t } = useI18n();
+  const [showFollowups, setShowFollowups] = useState(false);
+  const [hasStartedConversation, setHasStartedConversation] = useState(false);
+  const { threadId, setThreadId, isNewThread, setIsNewThread, isMock } =
+    useThreadChat();
+  const [settings] = useThreadSettings(threadId);
+  const [mounted, setMounted] = useState(false);
+  const { tokenUsageEnabled } = useModels();
+  const { data: promptPrefixSettings } = usePromptPrefixSettings();
+  const [promptPrefixOn, setPromptPrefixOn] = useState(false);
+  const [selectedAgentId, setSelectedAgentId] = useState<string | null>(null);
+  const pendingRequestIdRef = useRef<string | null>(null);
+  const { selectedArtifact } = useArtifacts();
+  useSpecificChatMode();
+
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  useEffect(() => {
+    if (isNewThread) {
+      setHasStartedConversation(false);
+      setPromptPrefixOn(false);
+      setSelectedAgentId(null);
+    }
+  }, [isNewThread, threadId]);
+
+  const { showNotification } = useNotification();
+
+  const [thread, sendMessage, isUploading] = useThreadStream({
+    threadId: isNewThread ? undefined : threadId,
+    context: settings.context,
+    isMock,
+    onStart: (createdThreadId) => {
+      setThreadId(createdThreadId);
+      setIsNewThread(false);
+      history.replaceState(
+        null,
+        "",
+        `${window.location.pathname}${window.location.search}#${routeBase}/chats_iframe/${createdThreadId}`,
+      );
+
+      if (pendingRequestIdRef.current) {
+        postBrainyChatStatus("started", pendingRequestIdRef.current);
+      }
+    },
+    onFinish: (state) => {
+      if (pendingRequestIdRef.current) {
+        postBrainyChatStatus("finished", pendingRequestIdRef.current);
+        pendingRequestIdRef.current = null;
+      }
+
+      if (document.hidden || !document.hasFocus()) {
+        let body = "Conversation finished";
+        const lastMessage = state.messages.at(-1);
+        if (lastMessage) {
+          const textContent = textOfMessage(lastMessage);
+          if (textContent) {
+            body =
+              textContent.length > 200
+                ? `${textContent.substring(0, 200)}...`
+                : textContent;
+          }
+        }
+        showNotification(state.title, { body });
+      }
+    },
+  });
+
+  const writingArtifactPath = useMemo(() => {
+    const isMarkdown = (path: string | null | undefined) =>
+      !!path && /\.(md|markdown)(?:$|[?#])/i.test(path);
+    if (isMarkdown(selectedArtifact)) {
+      return selectedArtifact ?? undefined;
+    }
+    return [...(thread.values.artifacts ?? [])]
+      .reverse()
+      .find((path) => isMarkdown(path));
+  }, [selectedArtifact, thread.values.artifacts]);
+
+  const handleSubmit = useCallback(
+    (
+      message: PromptInputMessage,
+      externalContext?: Record<string, unknown>,
+    ) => {
+      if (
+        selectedAgentId &&
+        isNewThread &&
+        !hasStartedConversation &&
+        message.text &&
+        (!message.files || message.files.length === 0)
+      ) {
+        try {
+          sessionStorage.setItem(
+            "pendingAgentMessage",
+            JSON.stringify({ agentId: selectedAgentId, text: message.text }),
+          );
+        } catch {
+          // sessionStorage may be unavailable in private mode; fall through.
+        }
+        router.push(`/page/workspace/agents/${selectedAgentId}/chats/new`);
+        return;
+      }
+
+      const shouldApplyPrefix =
+        isNewThread &&
+        !hasStartedConversation &&
+        promptPrefixOn &&
+        promptPrefixSettings?.enabled === true;
+      setHasStartedConversation(true);
+      window.dispatchEvent(
+        new CustomEvent("workspace:sandbox-resume-autoscroll"),
+      );
+
+      const extraContext: Record<string, unknown> = {};
+      if (shouldApplyPrefix) {
+        extraContext.prompt_prefix_enabled = true;
+      }
+      if (settings.context.writing_mode && writingArtifactPath) {
+        extraContext.writing_artifact_path = writingArtifactPath;
+      }
+      if (externalContext) {
+        Object.assign(extraContext, externalContext);
+      }
+
+      void sendMessage(
+        threadId,
+        message,
+        Object.keys(extraContext).length > 0 ? extraContext : undefined,
+      );
+    },
+    [
+      hasStartedConversation,
+      isNewThread,
+      promptPrefixOn,
+      promptPrefixSettings,
+      router,
+      selectedAgentId,
+      sendMessage,
+      settings.context.writing_mode,
+      threadId,
+      writingArtifactPath,
+    ],
+  );
+
+  const handleClarificationSubmit = useCallback(
+    (answer: string) => {
+      setHasStartedConversation(true);
+      void sendMessage(threadId, { text: answer, files: [] });
+    },
+    [sendMessage, threadId],
+  );
+
+  useEffect(() => {
+    const handleMessage = (event: MessageEvent<BrainyChatSubmitMessage>) => {
+      const data = event.data;
+      if (data?.source !== "brainy-extension") return;
+      if (data?.type !== "brainy:chat-submit") return;
+
+      const { submitText, files, iframeContext } =
+        parseBrainyChatSubmitMessage(data);
+
+      console.log("收到插件消息", {
+        text: data.payload?.text,
+        prompt: data.payload?.prompt,
+        pageContext: data.payload?.pageContext,
+        screenshot: data.payload?.screenshot,
+        requestId: data.requestId,
+        filesCount: files.length,
+      });
+
+      if (!submitText && files.length === 0) return;
+
+      pendingRequestIdRef.current = data.requestId ?? null;
+
+      handleSubmit({ text: submitText, files }, iframeContext);
+    };
+
+    window.addEventListener("message", handleMessage);
+    return () => {
+      window.removeEventListener("message", handleMessage);
+    };
+  }, [handleSubmit]);
+
+  const messageListPaddingBottom = showFollowups
+    ? MESSAGE_LIST_DEFAULT_PADDING_BOTTOM +
+      MESSAGE_LIST_FOLLOWUPS_EXTRA_PADDING_BOTTOM
+    : undefined;
+  const isLandingState = isNewThread && !hasStartedConversation;
+
+  return (
+    <ThreadContext.Provider value={{ thread, isMock }}>
+      <ChatBox threadId={threadId} disableArtifacts>
+        <div className="relative flex size-full min-h-0 justify-between overflow-hidden">
+          <header
+            className={cn(
+              "absolute top-0 right-0 left-0 z-30 flex h-12 shrink-0 items-center border-b px-4",
+              isLandingState
+                ? "border-transparent bg-transparent"
+                : "bg-card/90 border-border/70 shadow-sm backdrop-blur-md",
+            )}
+          >
+            <div className="flex w-full items-center text-sm font-medium">
+              <ThreadTitle threadId={threadId} thread={thread} />
+            </div>
+            <div className="flex items-center gap-2">
+              <TokenUsageIndicator
+                enabled={tokenUsageEnabled}
+                messages={thread.messages}
+              />
+              <ExportTrigger threadId={threadId} />
+            </div>
+          </header>
+          <main className="flex min-h-0 max-w-full grow flex-col overflow-hidden">
+            <div className="flex size-full min-w-0">
+              {!isLandingState && (
+                <MessageList
+                  className={cn("size-full", "pt-10")}
+                  contentClassName="mx-0 max-w-full px-3 sm:px-4"
+                  threadId={threadId}
+                  thread={thread}
+                  paddingBottom={messageListPaddingBottom}
+                  tokenUsageEnabled={tokenUsageEnabled}
+                  onClarificationSubmit={handleClarificationSubmit}
+                />
+              )}
+            </div>
+            <div className="absolute right-0 bottom-0 left-0 z-30 flex justify-center px-4">
+              <div
+                className={cn(
+                  "relative w-full",
+                  isLandingState && "-translate-y-[calc(50vh-96px)]",
+                  isLandingState
+                    ? "max-w-(--container-width-md)"
+                    : "max-w-full",
+                )}
+              >
+                <div className="absolute -top-4 right-0 left-0 z-0">
+                  <div className="absolute right-0 bottom-0 left-0">
+                    <TodoList
+                      className="bg-background/5"
+                      todos={thread.values.todos ?? []}
+                      hidden={
+                        !thread.values.todos || thread.values.todos.length === 0
+                      }
+                    />
+                  </div>
+                </div>
+                {isLandingState && mounted && (
+                  <div className="mb-6 flex min-h-40 flex-col items-center justify-center">
+                    <div className="text-2xl font-medium">你好</div>
+                  </div>
+                )}
+                {env.NEXT_PUBLIC_STATIC_WEBSITE_ONLY === "true" && (
+                  <div className="text-muted-foreground/67 w-full translate-y-12 text-center text-xs">
+                    {t.common.notAvailableInDemoMode}
+                  </div>
+                )}
+              </div>
+            </div>
+          </main>
+        </div>
+      </ChatBox>
+    </ThreadContext.Provider>
+  );
+}
diff --git a/frontend-web/src/pages/LoginPage.tsx b/frontend-web/src/pages/LoginPage.tsx
index 9ae3984f..e197e5a1 100644
--- a/frontend-web/src/pages/LoginPage.tsx
+++ b/frontend-web/src/pages/LoginPage.tsx
@@ -1,29 +1,32 @@
-"use client";
+'use client';
 
-import { useParams, useRouter, useSearchParams } from "next/navigation";
-import { useEffect, useMemo, useState } from "react";
+import { useParams, useRouter, useSearchParams } from 'next/navigation';
+import { useEffect, useMemo, useState } from 'react';
 
-import { useTheme } from "@/contexts/ThemeContext";
-import { loginByToken, loginByUsername } from "@/core/auth/api";
-import { setStoredAuth } from "@/core/auth";
+import { useTheme } from '@/contexts/ThemeContext';
+import { loginByToken, loginByUsername } from '@/core/auth/api';
+import { setStoredAuth } from '@/core/auth';
 import {
   persistExternalLoginParams,
   resolveThemeFromQuery,
-} from "@/core/auth/external-login";
-import { isWujieEnv, useWujieProps } from "@/core/embed/wujie";
+} from '@/core/auth/external-login';
+import { isWujieEnv, useWujieProps } from '@/core/embed/wujie';
 import {
   GENERAL_QA_ROUTE,
   loginByYUserId,
   persistToolsToken,
-} from "@/core/auth/yuser-login";
+} from '@/core/auth/yuser-login';
 import {
   isSidebarEnabledFromSearch,
   persistSidebarEnabled,
-} from "@/core/page-layout/sidebar-enabled";
+} from '@/core/page-layout/sidebar-enabled';
 
-const DEFAULT_USERNAME = "guest";
+const DEFAULT_USERNAME = 'guest';
+const IFRAME_LOGIN_SOURCE = 'iframe';
+const DEFAULT_REDIRECT_PATH = '/page/workspace/chats/new';
+const IFRAME_REDIRECT_PATH = '/page/workspace/chats_iframe/new';
 
-type LoginStatus = "loading" | "success" | "error";
+type LoginStatus = 'loading' | 'success' | 'error';
 
 export default function LoginPage() {
   const { username } = useParams<{ username?: string }>();
@@ -34,25 +37,35 @@ export default function LoginPage() {
     () => isSidebarEnabledFromSearch(searchParams.toString()),
     [searchParams],
   );
+  const redirectPath = useMemo(
+    () =>
+      searchParams.get('from') === IFRAME_LOGIN_SOURCE
+        ? IFRAME_REDIRECT_PATH
+        : DEFAULT_REDIRECT_PATH,
+    [searchParams],
+  );
   const resolvedUsername = useMemo(() => {
     const raw = username?.trim();
     return raw && raw.length > 0 ? raw : DEFAULT_USERNAME;
   }, [username]);
   // 外部跳转参数：theme 直接调 setTheme；ticket/userId/env 持久化到 localStorage
-  const yUserId = searchParams.get("yUserId")?.trim() ?? "";
-  const toolToken = searchParams.get("token")?.trim() ?? "";
+  const yUserId = searchParams.get('yUserId')?.trim() ?? '';
+  const toolToken = searchParams.get('token')?.trim() ?? '';
   // 用户名直登口令门:开启后端开关时,口令从 ?password= 透传
-  const gatePassword = searchParams.get("password") ?? "";
+  const gatePassword = searchParams.get('password') ?? '';
   // token 换登录:?authToken= 传上游 token(与 tools_token 的 ?token= 区分开)
-  const authToken = searchParams.get("authToken")?.trim() ?? "";
-  const externalParams = useMemo(() => ({
-    theme: searchParams.get("theme") ?? "",
-    ticket: searchParams.get("ticket") ?? "",
-    userId: searchParams.get("userId") ?? "",
-    env: searchParams.get("env") ?? "",
-  }), [searchParams]);
-  const [status, setStatus] = useState<LoginStatus>("loading");
-  const [errorMessage, setErrorMessage] = useState<string>("");
+  const authToken = searchParams.get('authToken')?.trim() ?? '';
+  const externalParams = useMemo(
+    () => ({
+      theme: searchParams.get('theme') ?? '',
+      ticket: searchParams.get('ticket') ?? '',
+      userId: searchParams.get('userId') ?? '',
+      env: searchParams.get('env') ?? '',
+    }),
+    [searchParams],
+  );
+  const [status, setStatus] = useState<LoginStatus>('loading');
+  const [errorMessage, setErrorMessage] = useState<string>('');
 
   // 无界(wujie)父级通过 $wujie.props 注入的参数(ticket / userId / theme / env)。
   // hook 内部已把 ticket/userId/env 持久化到 localStorage(复用 external-login 存储)。
@@ -61,7 +74,7 @@ export default function LoginPage() {
   // 调试:把无界注入的 props 打印出来(仅在无界子应用环境下,避免独立访问时刷日志)。
   useEffect(() => {
     if (!isWujieEnv()) return;
-    console.log("[wujie] sub-app props:", wujieProps);
+    console.log('[wujie] sub-app props:', wujieProps);
   }, [wujieProps]);
 
   // 主题切换:无界 props.theme 优先,其次 URL query theme。两者取值约定一致
@@ -85,8 +98,8 @@ export default function LoginPage() {
     let cancelled = false;
 
     async function runLogin() {
-      setStatus("loading");
-      setErrorMessage("");
+      setStatus('loading');
+      setErrorMessage('');
       try {
         let auth;
         if (authToken) {
@@ -106,15 +119,15 @@ export default function LoginPage() {
         }
         setStoredAuth(auth);
         persistSidebarEnabled(sidebarEnabled);
-        setStatus("success");
-        router.replace(yUserId ? GENERAL_QA_ROUTE : "/page/workspace/chats/new");
+        setStatus('success');
+        router.replace(yUserId ? GENERAL_QA_ROUTE : redirectPath);
       } catch (error) {
         if (cancelled) {
           return;
         }
-        setStatus("error");
+        setStatus('error');
         setErrorMessage(
-          error instanceof Error ? error.message : "Login request failed.",
+          error instanceof Error ? error.message : 'Login request failed.',
         );
       }
     }
@@ -123,19 +136,26 @@ export default function LoginPage() {
     return () => {
       cancelled = true;
     };
-  }, [resolvedUsername, router, sidebarEnabled, yUserId, toolToken, authToken, gatePassword]);
+  }, [
+    resolvedUsername,
+    router,
+    sidebarEnabled,
+    yUserId,
+    toolToken,
+    authToken,
+    gatePassword,
+  ]);
 
   return (
     <div className="flex min-h-screen items-center justify-center bg-background px-6">
       <div className="w-full max-w-lg rounded-xl border bg-card p-6 shadow-sm">
         <h1 className="text-xl font-semibold">正在进入智能体模式</h1>
-        {status === "error" && (
+        {status === 'error' && (
           <p className="mt-4 text-sm text-red-600">
-            登录失败：{errorMessage || "未知错误"}
+            登录失败：{errorMessage || '未知错误'}
           </p>
         )}
       </div>
     </div>
   );
 }
-
diff --git a/frontend-web/src/pages/WorkspaceRoutes.tsx b/frontend-web/src/pages/WorkspaceRoutes.tsx
index d2c565b1..6d085c9a 100644
--- a/frontend-web/src/pages/WorkspaceRoutes.tsx
+++ b/frontend-web/src/pages/WorkspaceRoutes.tsx
@@ -1,45 +1,55 @@
-import type { CSSProperties, ReactNode } from "react";
-import { Navigate, Route, Routes } from "react-router-dom";
+import type { CSSProperties, ReactNode } from 'react';
+import { Navigate, Route, Routes } from 'react-router-dom';
 
-import { getStoredAuth } from "@/core/auth";
+import { getStoredAuth } from '@/core/auth';
 
-import { SidebarInset, SidebarProvider } from "@/components/ui/sidebar";
-import { PromptInputProvider } from "@/components/ai-elements/prompt-input";
-import { WorkspaceSidebar } from "@/components/workspace/workspace-sidebar";
-import { CommandPalette } from "@/components/workspace/command-palette";
-import { Toaster } from "sonner";
-import { SubtasksProvider } from "@/core/tasks/context";
-import { ArtifactsProvider } from "@/components/workspace/artifacts";
+import { SidebarInset, SidebarProvider } from '@/components/ui/sidebar';
+import { PromptInputProvider } from '@/components/ai-elements/prompt-input';
+import { WorkspaceSidebar } from '@/components/workspace/workspace-sidebar';
+import { CommandPalette } from '@/components/workspace/command-palette';
+import { Toaster } from 'sonner';
+import { SubtasksProvider } from '@/core/tasks/context';
+import { ArtifactsProvider } from '@/components/workspace/artifacts';
 
-import { RouteBaseProvider } from "@/core/route-base";
+import { RouteBaseProvider } from '@/core/route-base';
 
-import ChatsPage from "./ChatsPage";
-import ChatPage from "./ChatPage";
-import AgentsPage from "./AgentsPage";
-import AgentChatPage from "./AgentChatPage";
-import NewAgentPage from "./NewAgentPage";
-import AdminAgentsPage from "./AdminAgentsPage";
-import AdminScheduledTasksPage from "./AdminScheduledTasksPage";
-import AdminSkillsPage from "./AdminSkillsPage";
-import ScheduledTaskRunDetailPage from "./ScheduledTaskRunDetailPage";
-import ScheduledTasksPage from "./ScheduledTasksPage";
-import LlmMetricsPage from "./LlmMetricsPage";
-import MemoryPage from "./MemoryPage";
-import PromptPrefixSettingsPage from "./PromptPrefixSettingsPage";
-import PrivateSquareSettingsPage from "./PrivateSquareSettingsPage";
-import SkillEvolutionPage from "./SkillEvolutionPage";
-import SkillsPage from "./SkillsPage";
-import UsersPage from "./UsersPage";
-import AdminUserActivityPage from "./AdminUserActivityPage";
-import AdminMemoryPage from "./AdminMemoryPage";
-import AdminUserHubPage from "./AdminUserHubPage";
-import TagsPage from "./TagsPage";
-import RecommendedQuestionsPage from "./RecommendedQuestionsPage";
-import AIWritingPage from "@/open-canvas/pages/AIWritingPage";
-import StudioNotebooksPage from "./StudioNotebooksPage";
-import StudioNotebookDetailPage from "./StudioNotebookDetailPage";
-import RoundtablePlanningPage from "@/roundtable-planning/pages/RoundtablePlanningPage";
-import "@/roundtable-planning/styles/roundtable-planning.css";
+import ChatsPage from './ChatsPage';
+import ChatPage from './ChatPage';
+import IframeChatPage from './IframeChatPage';
+import AgentsPage from './AgentsPage';
+import AgentChatPage from './AgentChatPage';
+import NewAgentPage from './NewAgentPage';
+import AdminAgentsPage from './AdminAgentsPage';
+import AdminScheduledTasksPage from './AdminScheduledTasksPage';
+import AdminSkillsPage from './AdminSkillsPage';
+import ScheduledTaskRunDetailPage from './ScheduledTaskRunDetailPage';
+import ScheduledTasksPage from './ScheduledTasksPage';
+import LlmMetricsPage from './LlmMetricsPage';
+import MemoryPage from './MemoryPage';
+import PromptPrefixSettingsPage from './PromptPrefixSettingsPage';
+import PrivateSquareSettingsPage from './PrivateSquareSettingsPage';
+import SkillEvolutionPage from './SkillEvolutionPage';
+import SkillsPage from './SkillsPage';
+import UsersPage from './UsersPage';
+import AdminUserActivityPage from './AdminUserActivityPage';
+import AdminMemoryPage from './AdminMemoryPage';
+import AdminUserHubPage from './AdminUserHubPage';
+import TagsPage from './TagsPage';
+import RecommendedQuestionsPage from './RecommendedQuestionsPage';
+import AIWritingPage from '@/open-canvas/pages/AIWritingPage';
+import StudioNotebooksPage from './StudioNotebooksPage';
+import StudioNotebookDetailPage from './StudioNotebookDetailPage';
+import RoundtablePlanningPage from '@/roundtable-planning/pages/RoundtablePlanningPage';
+import '@/roundtable-planning/styles/roundtable-planning.css';
+import { cn } from '@/lib/utils';
+
+function isInIframe(): boolean {
+  try {
+    return window.self !== window.top;
+  } catch {
+    return true;
+  }
+}
 
 export function WorkspaceLayout({
   children,
@@ -47,6 +57,8 @@ export function WorkspaceLayout({
   pageSidebarHidden = false,
   headerHidden = false,
   compactWorkspaceSidebar = false,
+  wrapperOverflowHidden = false,
+  insetOverflowHidden = false,
   pageSidebarDark = false,
 }: {
   children: ReactNode;
@@ -54,20 +66,24 @@ export function WorkspaceLayout({
   pageSidebarHidden?: boolean;
   headerHidden?: boolean;
   compactWorkspaceSidebar?: boolean;
+  wrapperOverflowHidden?: boolean;
+  insetOverflowHidden?: boolean;
   pageSidebarDark?: boolean;
 }) {
   const pageSidebarWidth = pageSidebarHidden
-    ? "0rem"
+    ? '0rem'
     : pageSidebarDark
-      // dark page sidebar:
-      //   展开: 视觉右边界 108px（外框 98 + 内层 translateX 10）+ 10px gap = 118px
-      //   收起: sidebar 主体完全消失（连同其占据的宽度），workspace 内容铺到屏幕左边；
-      //         左下角浮动按钮是 fixed，叠在主内容上不影响 layout
-      // 与 PageRoutes.tsx 的 main pl-[118px] / pl-0 保持一致
-      ? (pageSidebarCollapsed ? "0rem" : "118px")
+      ? // dark page sidebar:
+        //   展开: 视觉右边界 108px（外框 98 + 内层 translateX 10）+ 10px gap = 118px
+        //   收起: sidebar 主体完全消失（连同其占据的宽度），workspace 内容铺到屏幕左边；
+        //         左下角浮动按钮是 fixed，叠在主内容上不影响 layout
+        // 与 PageRoutes.tsx 的 main pl-[118px] / pl-0 保持一致
+        pageSidebarCollapsed
+        ? '0rem'
+        : '118px'
       : pageSidebarCollapsed
-        ? "4rem"
-        : "16rem";
+        ? '4rem'
+        : '16rem';
 
   return (
     <SidebarProvider
@@ -81,22 +97,26 @@ export function WorkspaceLayout({
       // 故这里 left/top 归零即与原 fixed 视觉位置逐像素一致；高度则跟随容器而非视口。
       // 作用域仅限本 SidebarProvider 实例(不动全局 ui/sidebar 原语)，不影响 artifacts 等其它侧栏。
       className={[
-        "relative h-full w-full overflow-x-hidden",
-        "[&_[data-slot=sidebar-container]]:absolute",
-        "[&_[data-slot=sidebar-container]]:left-0",
-        "[&_[data-slot=sidebar-container]]:top-0",
-      ].join(" ")}
+        'relative h-full w-full overflow-x-hidden',
+        '[&_[data-slot=sidebar-container]]:absolute',
+        '[&_[data-slot=sidebar-container]]:left-0',
+        '[&_[data-slot=sidebar-container]]:top-0',
+      ].join(' ')}
       style={
         {
-          "--page-sidebar-width": pageSidebarWidth,
-          "--header-height": headerHidden ? "0rem" : "4rem",
+          '--page-sidebar-width': pageSidebarWidth,
+          '--header-height': headerHidden ? '0rem' : '4rem',
         } as CSSProperties
       }
       data-page-sidebar-collapsed={pageSidebarCollapsed}
       defaultOpen
     >
       <WorkspaceSidebar compactChrome={compactWorkspaceSidebar} />
-      <SidebarInset className="min-w-0">{children}</SidebarInset>
+      <SidebarInset
+        className={cn('min-w-0', insetOverflowHidden && 'overflow-hidden')}
+      >
+        {children}
+      </SidebarInset>
       <CommandPalette />
       <Toaster position="top-center" />
     </SidebarProvider>
@@ -113,6 +133,30 @@ export function ChatRuntime({ children }: { children: ReactNode }) {
   );
 }
 
+function NewChatEntryRoute({
+  layoutProps,
+}: {
+  layoutProps: {
+    pageSidebarCollapsed: boolean;
+    pageSidebarHidden: boolean;
+    headerHidden: boolean;
+    compactWorkspaceSidebar: boolean;
+    pageSidebarDark: boolean;
+  };
+}) {
+  if (isInIframe()) {
+    return <Navigate to="/page/workspace/chats_iframe/new" replace />;
+  }
+
+  return (
+    <WorkspaceLayout {...layoutProps}>
+      <ChatRuntime>
+        <ChatPage />
+      </ChatRuntime>
+    </WorkspaceLayout>
+  );
+}
+
 export default function WorkspaceRoutes({
   pageSidebarCollapsed = false,
   pageSidebarHidden = false,
@@ -136,263 +180,293 @@ export default function WorkspaceRoutes({
 
   return (
     <RouteBaseProvider value="/page/workspace">
-    <Routes>
-      <Route index element={<Navigate to="chats/new" replace />} />
-      <Route
-        path="chats"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ChatsPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="chats/:thread_id"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ChatRuntime>
-              <ChatPage />
-            </ChatRuntime>
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="agents"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <AgentsPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="agents/new"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <NewAgentPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="agents/:agent_id/chats"
-        element={<Navigate to="/page/workspace/agents" replace />}
-      />
-      <Route
-        path="agents/:agent_id/chats/:thread_id"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ChatRuntime>
-              <AgentChatPage />
-            </ChatRuntime>
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="skills"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <SkillsPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="skills/evolution"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <SkillEvolutionPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="memory"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <MemoryPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="ai-writing"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <AIWritingPage hideAdvancedFields />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="studio/notebooks"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <StudioNotebooksPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="studio/notebooks/:notebookId"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ChatRuntime>
-              <StudioNotebookDetailPage />
-            </ChatRuntime>
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="roundtable"
-        element={<Navigate to="/page/workspace/roundtable/planning" replace />}
-      />
-      <Route
-        path="roundtable/planning"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ChatRuntime>
-              <RoundtablePlanningPage />
-            </ChatRuntime>
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="scheduled"
-        element={<Navigate to="/page/workspace/scheduled/tasks" replace />}
-      />
-      <Route
-        path="scheduled/tasks"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ScheduledTasksPage />
-          </WorkspaceLayout>
-        }
-      />
-      <Route
-        path="scheduled/runs/:run_id"
-        element={
-          <WorkspaceLayout {...layoutProps}>
-            <ScheduledTaskRunDetailPage />
-          </WorkspaceLayout>
-        }
-      />
-      {/* Unified admin user hub */}
-      <Route
-        path="admin"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
-            <WorkspaceLayout {...layoutProps} pageSidebarHidden>
-              <AdminUserHubPage />
-            </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      {/* Legacy redirects */}
-      <Route
-        path="admin/users"
-        element={<Navigate to="/page/workspace/admin" replace />}
-      />
-      <Route
-        path="admin/user-activity"
-        element={<Navigate to="/page/workspace/admin" replace />}
-      />
-      <Route
-        path="admin/memory"
-        element={<Navigate to="/page/workspace/admin" replace />}
-      />
-      <Route
-        path="admin/scheduled-tasks"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+      <Routes>
+        <Route index element={<Navigate to="chats/new" replace />} />
+        <Route
+          path="chats"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <AdminScheduledTasksPage />
+              <ChatsPage />
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="admin/agents"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="chats/new"
+          element={<NewChatEntryRoute layoutProps={layoutProps} />}
+        />
+        <Route
+          path="chats/:thread_id"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <AdminAgentsPage />
+              <ChatRuntime>
+                <ChatPage />
+              </ChatRuntime>
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="admin/skills"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="chats_iframe/new"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <AdminSkillsPage />
+              <ChatRuntime>
+                <IframeChatPage />
+              </ChatRuntime>
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="admin/tags"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="chats_iframe/:thread_id"
+          element={
+            <WorkspaceLayout
+              {...layoutProps}
+              wrapperOverflowHidden
+              insetOverflowHidden
+            >
+              <ChatRuntime>
+                <IframeChatPage />
+              </ChatRuntime>
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="agents"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <TagsPage />
+              <AgentsPage />
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="settings/recommended-questions"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="agents/new"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <RecommendedQuestionsPage />
+              <NewAgentPage />
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="settings/prompt-prefix"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="agents/:agent_id/chats"
+          element={<Navigate to="/page/workspace/agents" replace />}
+        />
+        <Route
+          path="agents/:agent_id/chats/:thread_id"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <PromptPrefixSettingsPage />
+              <ChatRuntime>
+                <AgentChatPage />
+              </ChatRuntime>
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="settings/private-square"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="skills"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <PrivateSquareSettingsPage />
+              <SkillsPage />
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-      <Route
-        path="settings/llm-metrics"
-        element={
-          getStoredAuth()?.system_role === "admin" ? (
+          }
+        />
+        <Route
+          path="skills/evolution"
+          element={
             <WorkspaceLayout {...layoutProps}>
-              <LlmMetricsPage />
+              <SkillEvolutionPage />
             </WorkspaceLayout>
-          ) : (
-            <Navigate to="/page/workspace/chats/new" replace />
-          )
-        }
-      />
-    </Routes>
+          }
+        />
+        <Route
+          path="memory"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <MemoryPage />
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="ai-writing"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <AIWritingPage hideAdvancedFields />
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="studio/notebooks"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <StudioNotebooksPage />
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="studio/notebooks/:notebookId"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <ChatRuntime>
+                <StudioNotebookDetailPage />
+              </ChatRuntime>
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="roundtable"
+          element={
+            <Navigate to="/page/workspace/roundtable/planning" replace />
+          }
+        />
+        <Route
+          path="roundtable/planning"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <ChatRuntime>
+                <RoundtablePlanningPage />
+              </ChatRuntime>
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="scheduled"
+          element={<Navigate to="/page/workspace/scheduled/tasks" replace />}
+        />
+        <Route
+          path="scheduled/tasks"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <ScheduledTasksPage />
+            </WorkspaceLayout>
+          }
+        />
+        <Route
+          path="scheduled/runs/:run_id"
+          element={
+            <WorkspaceLayout {...layoutProps}>
+              <ScheduledTaskRunDetailPage />
+            </WorkspaceLayout>
+          }
+        />
+        {/* Unified admin user hub */}
+        <Route
+          path="admin"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps} pageSidebarHidden>
+                <AdminUserHubPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        {/* Legacy redirects */}
+        <Route
+          path="admin/users"
+          element={<Navigate to="/page/workspace/admin" replace />}
+        />
+        <Route
+          path="admin/user-activity"
+          element={<Navigate to="/page/workspace/admin" replace />}
+        />
+        <Route
+          path="admin/memory"
+          element={<Navigate to="/page/workspace/admin" replace />}
+        />
+        <Route
+          path="admin/scheduled-tasks"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <AdminScheduledTasksPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="admin/agents"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <AdminAgentsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="admin/skills"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <AdminSkillsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="admin/tags"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <TagsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="settings/recommended-questions"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <RecommendedQuestionsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="settings/prompt-prefix"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <PromptPrefixSettingsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="settings/private-square"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <PrivateSquareSettingsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+        <Route
+          path="settings/llm-metrics"
+          element={
+            getStoredAuth()?.system_role === 'admin' ? (
+              <WorkspaceLayout {...layoutProps}>
+                <LlmMetricsPage />
+              </WorkspaceLayout>
+            ) : (
+              <Navigate to="/page/workspace/chats/new" replace />
+            )
+          }
+        />
+      </Routes>
     </RouteBaseProvider>
   );
 }
diff --git a/frontend-web/src/pages/iframe-chat-submit.test.ts b/frontend-web/src/pages/iframe-chat-submit.test.ts
new file mode 100644
index 00000000..690570fd
--- /dev/null
+++ b/frontend-web/src/pages/iframe-chat-submit.test.ts
@@ -0,0 +1,71 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseBrainyChatSubmitMessage } from "./iframe-chat-submit";
+
+test("parses iframe text, page context, and screenshot into a prompt message", () => {
+  const result = parseBrainyChatSubmitMessage({
+    source: "brainy-extension",
+    type: "brainy:chat-submit",
+    requestId: "iframe-123",
+    payload: {
+      text: "提取并翻译",
+      prompt: "提取图片中的文字并翻译成简体中文",
+      pageContext: {
+        title: "UN News",
+        content: "Banning children from social media is not the answer.",
+        url: "https://news.un.org/example",
+      },
+      screenshot: {
+        dataUrl: "data:image/png;base64,aGVsbG8=",
+        fileName: "capture.png",
+        images: [
+          {
+            filename: "capture.png",
+            url: "C:\\Users\\Rocky\\AppData\\Local\\Temp\\capture.png",
+            size: 0,
+          },
+        ],
+      },
+    },
+  });
+
+  assert.equal(result.submitText, [
+    "提取并翻译",
+    "<extension_prompt>\n提取图片中的文字并翻译成简体中文\n</extension_prompt>",
+    "<page_context>\n<title>\nUN News\n</title>\n\n<url>\nhttps://news.un.org/example\n</url>\n\n<content>\nBanning children from social media is not the answer.\n</content>\n</page_context>",
+  ].join("\n\n"));
+  assert.deepEqual(result.iframeContext, { brainy_request_id: "iframe-123" });
+  assert.equal(result.files.length, 1);
+  assert.equal(result.files[0]?.type, "file");
+  assert.equal(result.files[0]?.filename, "capture.png");
+  assert.equal(result.files[0]?.mediaType, "image/png");
+  assert.ok(result.files[0]?.file instanceof File);
+  assert.equal(result.files[0]?.file?.name, "capture.png");
+  assert.equal(result.files[0]?.file?.type, "image/png");
+  assert.equal(result.files[0]?.url, "data:image/png;base64,aGVsbG8=");
+});
+
+test("keeps screenshot-only iframe submissions in the conversation flow", () => {
+  const result = parseBrainyChatSubmitMessage({
+    source: "brainy-extension",
+    type: "brainy:chat-submit",
+    payload: {
+      screenshot: {
+        dataUrl: "data:image/jpeg;base64,aGVsbG8=",
+        images: [
+          {
+            filename: "shot.jpg",
+            url: "C:\\Users\\Rocky\\AppData\\Local\\Temp\\shot.jpg",
+            size: 0,
+          },
+        ],
+      },
+    },
+  });
+
+  assert.equal(result.submitText, "");
+  assert.equal(result.files.length, 1);
+  assert.equal(result.files[0]?.filename, "shot.jpg");
+  assert.equal(result.files[0]?.mediaType, "image/jpeg");
+});
diff --git a/frontend-web/src/pages/iframe-chat-submit.ts b/frontend-web/src/pages/iframe-chat-submit.ts
new file mode 100644
index 00000000..c7583900
--- /dev/null
+++ b/frontend-web/src/pages/iframe-chat-submit.ts
@@ -0,0 +1,247 @@
+type BrainyPageContext = {
+  title?: string;
+  content?: string;
+  url?: string;
+};
+
+type BrainyScreenshotPath = {
+  image_url?: string;
+};
+
+type BrainyScreenshotImage = {
+  filename?: string;
+  url?: string;
+  size?: number;
+};
+
+type BrainyScreenshot = {
+  dataUrl?: string;
+  fileName?: string;
+  filePath?: BrainyScreenshotPath[];
+  images?: BrainyScreenshotImage[];
+};
+
+export type BrainyChatSubmitMessage = {
+  source?: string;
+  type?: string;
+  payload?: {
+    text?: string;
+    prompt?: string;
+    pageContext?: BrainyPageContext;
+    screenshot?: BrainyScreenshot;
+  };
+  requestId?: string;
+};
+
+export type IframePromptInputFilePart = {
+  type: "file";
+  url: string;
+  mediaType: string;
+  filename: string;
+  file?: File;
+};
+
+export type ParsedBrainyChatSubmitMessage = {
+  submitText: string;
+  files: IframePromptInputFilePart[];
+  iframeContext?: Record<string, unknown>;
+};
+
+function trimToUndefined(value: string | undefined): string | undefined {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : undefined;
+}
+
+function fileNameFromPath(path: string | undefined): string | undefined {
+  if (!path) return undefined;
+  const parts = path.split(/[\\/]/).filter(Boolean);
+  return parts.at(-1);
+}
+
+function isLikelyLocalPath(path: string): boolean {
+  return /^[a-zA-Z]:[\\/]/.test(path) || path.startsWith("\\\\");
+}
+
+function mimeTypeFromFilename(filename: string | undefined): string | undefined {
+  const lower = filename?.toLowerCase() ?? "";
+  if (lower.endsWith(".png")) return "image/png";
+  if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
+  if (lower.endsWith(".webp")) return "image/webp";
+  if (lower.endsWith(".gif")) return "image/gif";
+  return undefined;
+}
+
+function parseDataUrlMeta(dataUrl: string): { mimeType: string; payload: string } | null {
+  const match = /^data:([^;,]+)?(?:;base64)?,(.*)$/i.exec(dataUrl);
+  if (!match) return null;
+  return {
+    mimeType: match[1] || "application/octet-stream",
+    payload: match[2] || "",
+  };
+}
+
+function decodeBase64(base64: string): Uint8Array {
+  if (typeof Buffer !== "undefined") {
+    return Uint8Array.from(Buffer.from(base64, "base64"));
+  }
+
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+
+function fileFromDataUrl(
+  dataUrl: string,
+  filename: string,
+  mediaType: string,
+): File | undefined {
+  const meta = parseDataUrlMeta(dataUrl);
+  if (!meta) return undefined;
+
+  const bytes = decodeBase64(meta.payload);
+  const arrayBuffer = bytes.buffer.slice(
+    bytes.byteOffset,
+    bytes.byteOffset + bytes.byteLength,
+  );
+
+  return new File([arrayBuffer], filename, {
+    type: mediaType || meta.mimeType,
+  });
+}
+
+function normalizePageContext(
+  pageContext: BrainyPageContext | undefined,
+): BrainyPageContext | undefined {
+  if (!pageContext) return undefined;
+
+  const normalized = {
+    title: trimToUndefined(pageContext.title),
+    content: trimToUndefined(pageContext.content),
+    url: trimToUndefined(pageContext.url),
+  };
+
+  return normalized.title || normalized.content || normalized.url
+    ? normalized
+    : undefined;
+}
+
+export function buildIframeMessageText({
+  text,
+  prompt,
+  pageContext,
+}: {
+  text?: string;
+  prompt?: string;
+  pageContext?: BrainyPageContext;
+}) {
+  const primaryText = trimToUndefined(text) || trimToUndefined(prompt) || "";
+  const sections: string[] = [];
+
+  if (primaryText) {
+    sections.push(primaryText);
+  }
+
+  const normalizedPrompt = trimToUndefined(prompt);
+  if (normalizedPrompt && normalizedPrompt !== primaryText) {
+    sections.push(
+      `<extension_prompt>\n${normalizedPrompt}\n</extension_prompt>`,
+    );
+  }
+
+  const normalizedPageContext = normalizePageContext(pageContext);
+  if (normalizedPageContext) {
+    const pageContextParts = [
+      normalizedPageContext.title
+        ? `<title>\n${normalizedPageContext.title}\n</title>`
+        : null,
+      normalizedPageContext.url
+        ? `<url>\n${normalizedPageContext.url}\n</url>`
+        : null,
+      normalizedPageContext.content
+        ? `<content>\n${normalizedPageContext.content}\n</content>`
+        : null,
+    ].filter(Boolean);
+
+    if (pageContextParts.length > 0) {
+      sections.push(
+        `<page_context>\n${pageContextParts.join("\n\n")}\n</page_context>`,
+      );
+    }
+  }
+
+  return sections.join("\n\n");
+}
+
+function buildScreenshotFileParts(
+  screenshot: BrainyScreenshot | undefined,
+): IframePromptInputFilePart[] {
+  if (!screenshot) return [];
+
+  const fallbackPath =
+    screenshot.filePath?.map((item) => item.image_url).find(Boolean) ??
+    screenshot.images?.map((item) => item.url).find(Boolean);
+  const fallbackFilename =
+    trimToUndefined(screenshot.fileName) ??
+    screenshot.images?.map((item) => trimToUndefined(item.filename)).find(Boolean) ??
+    fileNameFromPath(fallbackPath) ??
+    "screenshot.png";
+
+  const dataUrl = trimToUndefined(screenshot.dataUrl);
+  if (dataUrl) {
+    const parsed = parseDataUrlMeta(dataUrl);
+    const mediaType =
+      parsed?.mimeType || mimeTypeFromFilename(fallbackFilename) || "image/png";
+    const file = fileFromDataUrl(dataUrl, fallbackFilename, mediaType);
+
+    return [
+      {
+        type: "file",
+        url: dataUrl,
+        mediaType,
+        filename: fallbackFilename,
+        ...(file ? { file } : {}),
+      },
+    ];
+  }
+
+  const remoteImage = screenshot.images?.find((item) => {
+    const url = trimToUndefined(item.url);
+    return !!url && !isLikelyLocalPath(url);
+  });
+
+  if (remoteImage?.url && remoteImage.filename) {
+    return [
+      {
+        type: "file",
+        url: remoteImage.url,
+        mediaType:
+          mimeTypeFromFilename(remoteImage.filename) || "application/octet-stream",
+        filename: remoteImage.filename,
+      },
+    ];
+  }
+
+  return [];
+}
+
+export function parseBrainyChatSubmitMessage(
+  data: BrainyChatSubmitMessage,
+): ParsedBrainyChatSubmitMessage {
+  const text = trimToUndefined(data.payload?.text);
+  const prompt = trimToUndefined(data.payload?.prompt);
+  const pageContext = normalizePageContext(data.payload?.pageContext);
+  const submitText = buildIframeMessageText({ text, prompt, pageContext });
+  const files = buildScreenshotFileParts(data.payload?.screenshot);
+  const requestId = trimToUndefined(data.requestId);
+
+  return {
+    submitText,
+    files,
+    ...(requestId
+      ? { iframeContext: { brainy_request_id: requestId } }
+      : {}),
+  };
+}